diff options
Diffstat (limited to 'po-docs/libguestfs-docs.pot')
-rw-r--r-- | po-docs/libguestfs-docs.pot | 7203 |
1 files changed, 3731 insertions, 3472 deletions
diff --git a/po-docs/libguestfs-docs.pot b/po-docs/libguestfs-docs.pot index 0f7cd860..294296bb 100644 --- a/po-docs/libguestfs-docs.pot +++ b/po-docs/libguestfs-docs.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: libguestfs 1.16.26\n" +"Project-Id-Version: libguestfs 1.16.27\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2012-06-28 10:27+0200\n" +"POT-Creation-Date: 2012-07-07 13:58+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -49,7 +49,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:13 ../cat/virt-cat.pod:19 ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19 ../clone/virt-sysprep.pod:13 ../df/virt-df.pod:21 ../edit/virt-edit.pod:27 ../erlang/examples/guestfs-erlang.pod:16 ../examples/guestfs-examples.pod:19 ../examples/guestfs-recipes.pod:18 ../examples/guestfs-testing.pod:7 ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19 ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21 ../fish/virt-tar-out.pod:15 ../format/virt-format.pod:11 ../fuse/guestmount.pod:20 ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15 ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:18 ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:31 ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15 ../sparsify/virt-sparsify.pod:11 ../src/guestfs.pod:23 ../test-tool/libguestfs-test-tool.pod:11 ../tools/virt-list-filesystems.pl:45 ../tools/virt-list-partitions.pl:45 ../tools/virt-make-fs.pl:47 ../tools/virt-tar.pl:77 ../tools/virt-win-reg.pl:63 +#: ../align/virt-alignment-scan.pod:13 ../cat/virt-cat.pod:19 ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19 ../clone/virt-sysprep.pod:13 ../df/virt-df.pod:21 ../edit/virt-edit.pod:27 ../erlang/examples/guestfs-erlang.pod:16 ../examples/guestfs-examples.pod:19 ../examples/guestfs-recipes.pod:18 ../examples/guestfs-testing.pod:7 ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19 ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21 ../fish/virt-tar-out.pod:15 ../format/virt-format.pod:11 ../fuse/guestmount.pod:20 ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15 ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:18 ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:31 ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15 ../sparsify/virt-sparsify.pod:11 ../src/guestfs.pod:24 ../test-tool/libguestfs-test-tool.pod:11 ../tools/virt-list-filesystems.pl:45 ../tools/virt-list-partitions.pl:45 ../tools/virt-make-fs.pl:47 ../tools/virt-tar.pl:77 ../tools/virt-win-reg.pl:63 msgid "DESCRIPTION" msgstr "" @@ -309,7 +309,7 @@ msgid "" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:132 ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337 ../clone/virt-sysprep.pod:104 ../df/virt-df.pod:110 ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242 ../fish/guestfish.pod:673 ../format/virt-format.pod:96 ../inspector/virt-inspector.pod:350 ../rescue/virt-rescue.pod:161 ../src/guestfs.pod:2866 +#: ../align/virt-alignment-scan.pod:132 ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337 ../clone/virt-sysprep.pod:104 ../df/virt-df.pod:110 ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242 ../fish/guestfish.pod:673 ../format/virt-format.pod:96 ../inspector/virt-inspector.pod:350 ../rescue/virt-rescue.pod:161 ../src/guestfs.pod:2889 msgid "For example:" msgstr "" @@ -673,12 +673,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:311 ../cat/virt-cat.pod:231 ../cat/virt-filesystems.pod:373 ../cat/virt-ls.pod:483 ../clone/virt-sysprep.pod:475 ../df/virt-df.pod:241 ../edit/virt-edit.pod:356 ../inspector/virt-inspector.pod:366 ../rescue/virt-rescue.pod:303 ../resize/virt-resize.pod:690 ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:573 ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:744 +#: ../align/virt-alignment-scan.pod:311 ../cat/virt-cat.pod:231 ../cat/virt-filesystems.pod:373 ../cat/virt-ls.pod:483 ../clone/virt-sysprep.pod:475 ../df/virt-df.pod:241 ../edit/virt-edit.pod:356 ../inspector/virt-inspector.pod:366 ../rescue/virt-rescue.pod:303 ../resize/virt-resize.pod:690 ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:572 ../tools/virt-tar.pl:287 ../tools/virt-win-reg.pl:744 msgid "SHELL QUOTING" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:313 ../cat/virt-cat.pod:233 ../cat/virt-filesystems.pod:375 ../cat/virt-ls.pod:485 ../clone/virt-sysprep.pod:477 ../df/virt-df.pod:243 ../edit/virt-edit.pod:358 ../inspector/virt-inspector.pod:368 ../rescue/virt-rescue.pod:305 ../resize/virt-resize.pod:692 ../tools/virt-list-filesystems.pl:192 ../tools/virt-list-partitions.pl:262 ../tools/virt-make-fs.pl:575 ../tools/virt-tar.pl:291 ../tools/virt-win-reg.pl:752 +#: ../align/virt-alignment-scan.pod:313 ../cat/virt-cat.pod:233 ../cat/virt-filesystems.pod:375 ../cat/virt-ls.pod:485 ../clone/virt-sysprep.pod:477 ../df/virt-df.pod:243 ../edit/virt-edit.pod:358 ../inspector/virt-inspector.pod:368 ../rescue/virt-rescue.pod:305 ../resize/virt-resize.pod:692 ../tools/virt-list-filesystems.pl:192 ../tools/virt-list-partitions.pl:262 ../tools/virt-make-fs.pl:574 ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:752 msgid "" "Libvirt guest names can contain arbitrary characters, some of which have " "meaning to the shell such as C<#> and space. You may need to quote or " @@ -697,7 +697,7 @@ msgid "This program returns:" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:324 ../align/virt-alignment-scan.pod:330 ../align/virt-alignment-scan.pod:336 ../align/virt-alignment-scan.pod:343 ../cat/virt-cat.pod:177 ../cat/virt-cat.pod:182 ../cat/virt-cat.pod:187 ../cat/virt-cat.pod:198 ../cat/virt-cat.pod:202 ../clone/virt-sysprep.pod:283 ../clone/virt-sysprep.pod:287 ../clone/virt-sysprep.pod:291 ../clone/virt-sysprep.pod:295 ../clone/virt-sysprep.pod:310 ../clone/virt-sysprep.pod:314 ../clone/virt-sysprep.pod:318 ../clone/virt-sysprep.pod:322 ../clone/virt-sysprep.pod:326 ../clone/virt-sysprep.pod:362 ../clone/virt-sysprep.pod:384 ../clone/virt-sysprep.pod:388 ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266 ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276 ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291 ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102 ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132 ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227 ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235 ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243 ../examples/guestfs-testing.pod:110 ../examples/guestfs-testing.pod:114 ../examples/guestfs-testing.pod:118 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:441 ../fish/guestfish-actions.pod:449 ../fish/guestfish-actions.pod:456 ../fish/guestfish-actions.pod:463 ../fish/guestfish-actions.pod:1321 ../fish/guestfish-actions.pod:1325 ../fish/guestfish-actions.pod:1329 ../fish/guestfish-actions.pod:1333 ../fish/guestfish-actions.pod:1341 ../fish/guestfish-actions.pod:1345 ../fish/guestfish-actions.pod:1349 ../fish/guestfish-actions.pod:1359 ../fish/guestfish-actions.pod:1363 ../fish/guestfish-actions.pod:1367 ../fish/guestfish-actions.pod:1457 ../fish/guestfish-actions.pod:1461 ../fish/guestfish-actions.pod:1466 ../fish/guestfish-actions.pod:1471 ../fish/guestfish-actions.pod:1513 ../fish/guestfish-actions.pod:1517 ../fish/guestfish-actions.pod:1522 ../fish/guestfish-actions.pod:1778 ../fish/guestfish-actions.pod:1785 ../fish/guestfish-actions.pod:1792 ../fish/guestfish-actions.pod:2193 ../fish/guestfish-actions.pod:2199 ../fish/guestfish-actions.pod:2207 ../fish/guestfish-actions.pod:2214 ../fish/guestfish-actions.pod:2221 ../fish/guestfish.pod:445 ../fish/guestfish.pod:449 ../fish/guestfish.pod:453 ../fish/guestfish.pod:457 ../inspector/virt-inspector.pod:514 ../inspector/virt-inspector.pod:518 ../resize/virt-resize.pod:365 ../resize/virt-resize.pod:369 ../resize/virt-resize.pod:378 ../resize/virt-resize.pod:384 ../sparsify/virt-sparsify.pod:32 ../sparsify/virt-sparsify.pod:39 ../sparsify/virt-sparsify.pod:43 ../sparsify/virt-sparsify.pod:49 ../sparsify/virt-sparsify.pod:54 ../sparsify/virt-sparsify.pod:59 ../sparsify/virt-sparsify.pod:65 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:29 ../src/guestfs-actions.pod:641 ../src/guestfs-actions.pod:649 ../src/guestfs-actions.pod:656 ../src/guestfs-actions.pod:663 ../src/guestfs-actions.pod:2183 ../src/guestfs-actions.pod:2187 ../src/guestfs-actions.pod:2191 ../src/guestfs-actions.pod:2195 ../src/guestfs-actions.pod:2203 ../src/guestfs-actions.pod:2207 ../src/guestfs-actions.pod:2211 ../src/guestfs-actions.pod:2221 ../src/guestfs-actions.pod:2225 ../src/guestfs-actions.pod:2229 ../src/guestfs-actions.pod:2367 ../src/guestfs-actions.pod:2371 ../src/guestfs-actions.pod:2376 ../src/guestfs-actions.pod:2381 ../src/guestfs-actions.pod:2442 ../src/guestfs-actions.pod:2446 ../src/guestfs-actions.pod:2451 ../src/guestfs-actions.pod:2866 ../src/guestfs-actions.pod:2873 ../src/guestfs-actions.pod:2880 ../src/guestfs-actions.pod:3423 ../src/guestfs-actions.pod:3429 ../src/guestfs-actions.pod:3437 ../src/guestfs-actions.pod:3444 ../src/guestfs-actions.pod:3451 ../src/guestfs.pod:384 ../src/guestfs.pod:389 ../src/guestfs.pod:394 ../src/guestfs.pod:398 ../src/guestfs.pod:403 ../src/guestfs.pod:407 ../src/guestfs.pod:412 ../src/guestfs.pod:417 ../src/guestfs.pod:1097 ../src/guestfs.pod:1101 ../src/guestfs.pod:1105 ../src/guestfs.pod:1110 ../src/guestfs.pod:1118 ../src/guestfs.pod:1137 ../src/guestfs.pod:1145 ../src/guestfs.pod:1167 ../src/guestfs.pod:1171 ../src/guestfs.pod:1175 ../src/guestfs.pod:1179 ../src/guestfs.pod:1183 ../src/guestfs.pod:1187 ../src/guestfs.pod:1677 ../src/guestfs.pod:1682 ../src/guestfs.pod:1686 ../src/guestfs.pod:1788 ../src/guestfs.pod:1793 ../src/guestfs.pod:1797 ../src/guestfs.pod:1807 ../src/guestfs.pod:2096 ../src/guestfs.pod:2101 ../src/guestfs.pod:2107 ../src/guestfs.pod:2115 ../src/guestfs.pod:2633 ../src/guestfs.pod:2639 ../src/guestfs.pod:2644 ../src/guestfs.pod:2650 ../src/guestfs.pod:3042 ../src/guestfs.pod:3047 ../src/guestfs.pod:3051 ../src/guestfs.pod:3055 ../src/guestfs.pod:3059 ../src/guestfs.pod:3073 ../src/guestfs.pod:3078 ../src/guestfs.pod:3312 ../src/guestfs.pod:3316 ../src/guestfs.pod:3320 ../src/guestfs.pod:3324 ../tools/virt-win-reg.pl:197 ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208 ../tools/virt-win-reg.pl:721 ../tools/virt-win-reg.pl:727 ../tools/virt-win-reg.pl:733 +#: ../align/virt-alignment-scan.pod:324 ../align/virt-alignment-scan.pod:330 ../align/virt-alignment-scan.pod:336 ../align/virt-alignment-scan.pod:343 ../cat/virt-cat.pod:177 ../cat/virt-cat.pod:182 ../cat/virt-cat.pod:187 ../cat/virt-cat.pod:198 ../cat/virt-cat.pod:202 ../clone/virt-sysprep.pod:283 ../clone/virt-sysprep.pod:287 ../clone/virt-sysprep.pod:291 ../clone/virt-sysprep.pod:295 ../clone/virt-sysprep.pod:310 ../clone/virt-sysprep.pod:314 ../clone/virt-sysprep.pod:318 ../clone/virt-sysprep.pod:322 ../clone/virt-sysprep.pod:326 ../clone/virt-sysprep.pod:362 ../clone/virt-sysprep.pod:384 ../clone/virt-sysprep.pod:388 ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266 ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276 ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291 ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102 ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132 ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227 ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235 ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243 ../examples/guestfs-testing.pod:110 ../examples/guestfs-testing.pod:114 ../examples/guestfs-testing.pod:118 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:441 ../fish/guestfish-actions.pod:449 ../fish/guestfish-actions.pod:456 ../fish/guestfish-actions.pod:463 ../fish/guestfish-actions.pod:1333 ../fish/guestfish-actions.pod:1337 ../fish/guestfish-actions.pod:1341 ../fish/guestfish-actions.pod:1345 ../fish/guestfish-actions.pod:1353 ../fish/guestfish-actions.pod:1357 ../fish/guestfish-actions.pod:1361 ../fish/guestfish-actions.pod:1371 ../fish/guestfish-actions.pod:1375 ../fish/guestfish-actions.pod:1379 ../fish/guestfish-actions.pod:1469 ../fish/guestfish-actions.pod:1473 ../fish/guestfish-actions.pod:1478 ../fish/guestfish-actions.pod:1483 ../fish/guestfish-actions.pod:1525 ../fish/guestfish-actions.pod:1529 ../fish/guestfish-actions.pod:1534 ../fish/guestfish-actions.pod:1790 ../fish/guestfish-actions.pod:1797 ../fish/guestfish-actions.pod:1804 ../fish/guestfish-actions.pod:2205 ../fish/guestfish-actions.pod:2211 ../fish/guestfish-actions.pod:2219 ../fish/guestfish-actions.pod:2226 ../fish/guestfish-actions.pod:2233 ../fish/guestfish.pod:445 ../fish/guestfish.pod:449 ../fish/guestfish.pod:453 ../fish/guestfish.pod:457 ../inspector/virt-inspector.pod:514 ../inspector/virt-inspector.pod:518 ../resize/virt-resize.pod:365 ../resize/virt-resize.pod:369 ../resize/virt-resize.pod:378 ../resize/virt-resize.pod:384 ../sparsify/virt-sparsify.pod:32 ../sparsify/virt-sparsify.pod:39 ../sparsify/virt-sparsify.pod:43 ../sparsify/virt-sparsify.pod:49 ../sparsify/virt-sparsify.pod:54 ../sparsify/virt-sparsify.pod:59 ../sparsify/virt-sparsify.pod:65 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:29 ../src/guestfs-actions.pod:641 ../src/guestfs-actions.pod:649 ../src/guestfs-actions.pod:656 ../src/guestfs-actions.pod:663 ../src/guestfs-actions.pod:2199 ../src/guestfs-actions.pod:2203 ../src/guestfs-actions.pod:2207 ../src/guestfs-actions.pod:2211 ../src/guestfs-actions.pod:2219 ../src/guestfs-actions.pod:2223 ../src/guestfs-actions.pod:2227 ../src/guestfs-actions.pod:2237 ../src/guestfs-actions.pod:2241 ../src/guestfs-actions.pod:2245 ../src/guestfs-actions.pod:2383 ../src/guestfs-actions.pod:2387 ../src/guestfs-actions.pod:2392 ../src/guestfs-actions.pod:2397 ../src/guestfs-actions.pod:2458 ../src/guestfs-actions.pod:2462 ../src/guestfs-actions.pod:2467 ../src/guestfs-actions.pod:2882 ../src/guestfs-actions.pod:2889 ../src/guestfs-actions.pod:2896 ../src/guestfs-actions.pod:3439 ../src/guestfs-actions.pod:3445 ../src/guestfs-actions.pod:3453 ../src/guestfs-actions.pod:3460 ../src/guestfs-actions.pod:3467 ../src/guestfs.pod:382 ../src/guestfs.pod:387 ../src/guestfs.pod:392 ../src/guestfs.pod:396 ../src/guestfs.pod:401 ../src/guestfs.pod:405 ../src/guestfs.pod:410 ../src/guestfs.pod:415 ../src/guestfs.pod:1095 ../src/guestfs.pod:1099 ../src/guestfs.pod:1103 ../src/guestfs.pod:1108 ../src/guestfs.pod:1116 ../src/guestfs.pod:1135 ../src/guestfs.pod:1143 ../src/guestfs.pod:1165 ../src/guestfs.pod:1169 ../src/guestfs.pod:1173 ../src/guestfs.pod:1177 ../src/guestfs.pod:1181 ../src/guestfs.pod:1185 ../src/guestfs.pod:1700 ../src/guestfs.pod:1705 ../src/guestfs.pod:1709 ../src/guestfs.pod:1811 ../src/guestfs.pod:1816 ../src/guestfs.pod:1820 ../src/guestfs.pod:1830 ../src/guestfs.pod:2119 ../src/guestfs.pod:2124 ../src/guestfs.pod:2130 ../src/guestfs.pod:2138 ../src/guestfs.pod:2656 ../src/guestfs.pod:2662 ../src/guestfs.pod:2667 ../src/guestfs.pod:2673 ../src/guestfs.pod:3065 ../src/guestfs.pod:3070 ../src/guestfs.pod:3074 ../src/guestfs.pod:3078 ../src/guestfs.pod:3082 ../src/guestfs.pod:3096 ../src/guestfs.pod:3101 ../src/guestfs.pod:3335 ../src/guestfs.pod:3339 ../src/guestfs.pod:3343 ../src/guestfs.pod:3347 ../tools/virt-win-reg.pl:197 ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208 ../tools/virt-win-reg.pl:721 ../tools/virt-win-reg.pl:727 ../tools/virt-win-reg.pl:733 msgid "*" msgstr "" @@ -711,8 +711,8 @@ msgstr "" msgid "successful exit, all partitions are aligned E<ge> 64K for best performance" msgstr "" -#. type: textblock -#: ../align/virt-alignment-scan.pod:332 +#. type: =item +#: ../align/virt-alignment-scan.pod:332 ../src/guestfs.pod:1357 msgid "1" msgstr "" @@ -721,8 +721,8 @@ msgstr "" msgid "an error scanning the disk image or guest" msgstr "" -#. type: textblock -#: ../align/virt-alignment-scan.pod:338 +#. type: =item +#: ../align/virt-alignment-scan.pod:338 ../src/guestfs.pod:1361 msgid "2" msgstr "" @@ -733,8 +733,8 @@ msgid "" "in poor performance on high end network storage" msgstr "" -#. type: textblock -#: ../align/virt-alignment-scan.pod:345 +#. type: =item +#: ../align/virt-alignment-scan.pod:345 ../src/guestfs.pod:1365 msgid "3" msgstr "" @@ -746,7 +746,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:352 ../cat/virt-cat.pod:243 ../cat/virt-filesystems.pod:385 ../cat/virt-ls.pod:495 ../clone/virt-sysprep.pod:486 ../df/virt-df.pod:253 ../edit/virt-edit.pod:368 ../erlang/examples/guestfs-erlang.pod:97 ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384 ../examples/guestfs-testing.pod:291 ../fish/guestfish.pod:1268 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../format/virt-format.pod:177 ../fuse/guestmount.pod:317 ../inspector/virt-inspector.pod:501 ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39 ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:325 ../resize/virt-resize.pod:702 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:284 ../src/guestfs.pod:3250 ../test-tool/libguestfs-test-tool.pod:106 ../tools/virt-list-filesystems.pl:197 ../tools/virt-list-partitions.pl:267 ../tools/virt-make-fs.pl:580 ../tools/virt-tar.pl:296 ../tools/virt-win-reg.pl:757 +#: ../align/virt-alignment-scan.pod:352 ../cat/virt-cat.pod:243 ../cat/virt-filesystems.pod:385 ../cat/virt-ls.pod:495 ../clone/virt-sysprep.pod:486 ../df/virt-df.pod:253 ../edit/virt-edit.pod:368 ../erlang/examples/guestfs-erlang.pod:97 ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384 ../examples/guestfs-testing.pod:291 ../fish/guestfish.pod:1268 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../format/virt-format.pod:177 ../fuse/guestmount.pod:317 ../inspector/virt-inspector.pod:501 ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39 ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:325 ../resize/virt-resize.pod:702 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:284 ../src/guestfs.pod:3273 ../test-tool/libguestfs-test-tool.pod:106 ../tools/virt-list-filesystems.pl:197 ../tools/virt-list-partitions.pl:267 ../tools/virt-make-fs.pl:579 ../tools/virt-tar.pl:294 ../tools/virt-win-reg.pl:757 msgid "SEE ALSO" msgstr "" @@ -758,17 +758,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:361 ../cat/virt-cat.pod:252 ../cat/virt-filesystems.pod:396 ../cat/virt-ls.pod:507 ../clone/virt-sysprep.pod:501 ../df/virt-df.pod:261 ../edit/virt-edit.pod:382 ../format/virt-format.pod:187 ../rescue/virt-rescue.pod:334 ../resize/virt-resize.pod:725 ../sparsify/virt-sparsify.pod:297 ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:606 ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:783 +#: ../align/virt-alignment-scan.pod:361 ../cat/virt-cat.pod:252 ../cat/virt-filesystems.pod:396 ../cat/virt-ls.pod:507 ../clone/virt-sysprep.pod:501 ../df/virt-df.pod:261 ../edit/virt-edit.pod:382 ../format/virt-format.pod:187 ../rescue/virt-rescue.pod:334 ../resize/virt-resize.pod:725 ../sparsify/virt-sparsify.pod:297 ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:605 ../tools/virt-tar.pl:309 ../tools/virt-win-reg.pl:783 msgid "AUTHOR" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:363 ../cat/virt-cat.pod:254 ../cat/virt-filesystems.pod:398 ../cat/virt-ls.pod:509 ../clone/virt-sysprep.pod:503 ../df/virt-df.pod:263 ../edit/virt-edit.pod:384 ../format/virt-format.pod:189 ../inspector/virt-inspector.pod:516 ../rescue/virt-rescue.pod:336 ../resize/virt-resize.pod:727 ../sparsify/virt-sparsify.pod:299 ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281 ../tools/virt-make-fs.pl:608 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:785 +#: ../align/virt-alignment-scan.pod:363 ../cat/virt-cat.pod:254 ../cat/virt-filesystems.pod:398 ../cat/virt-ls.pod:509 ../clone/virt-sysprep.pod:503 ../df/virt-df.pod:263 ../edit/virt-edit.pod:384 ../format/virt-format.pod:189 ../inspector/virt-inspector.pod:516 ../rescue/virt-rescue.pod:336 ../resize/virt-resize.pod:727 ../sparsify/virt-sparsify.pod:299 ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281 ../tools/virt-make-fs.pl:607 ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:785 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:365 ../cat/virt-cat.pod:256 ../cat/virt-filesystems.pod:400 ../cat/virt-ls.pod:511 ../clone/virt-sysprep.pod:505 ../df/virt-df.pod:265 ../edit/virt-edit.pod:386 ../erlang/examples/guestfs-erlang.pod:114 ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401 ../examples/guestfs-testing.pod:302 ../fish/guestfish.pod:1300 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../format/virt-format.pod:191 ../fuse/guestmount.pod:332 ../inspector/virt-inspector.pod:524 ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56 ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:338 ../resize/virt-resize.pod:729 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:301 ../src/guestfs.pod:3335 ../test-tool/libguestfs-test-tool.pod:116 ../tools/virt-list-filesystems.pl:214 ../tools/virt-list-partitions.pl:283 ../tools/virt-make-fs.pl:610 ../tools/virt-tar.pl:315 ../tools/virt-win-reg.pl:787 +#: ../align/virt-alignment-scan.pod:365 ../cat/virt-cat.pod:256 ../cat/virt-filesystems.pod:400 ../cat/virt-ls.pod:511 ../clone/virt-sysprep.pod:505 ../df/virt-df.pod:265 ../edit/virt-edit.pod:386 ../erlang/examples/guestfs-erlang.pod:114 ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401 ../examples/guestfs-testing.pod:302 ../fish/guestfish.pod:1300 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../format/virt-format.pod:191 ../fuse/guestmount.pod:332 ../inspector/virt-inspector.pod:524 ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56 ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:338 ../resize/virt-resize.pod:729 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:301 ../src/guestfs.pod:3358 ../test-tool/libguestfs-test-tool.pod:116 ../tools/virt-list-filesystems.pl:214 ../tools/virt-list-partitions.pl:283 ../tools/virt-make-fs.pl:609 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:787 msgid "COPYRIGHT" msgstr "" @@ -778,7 +778,7 @@ msgid "Copyright (C) 2011 Red Hat Inc." msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:369 ../cat/virt-cat.pod:260 ../cat/virt-filesystems.pod:404 ../cat/virt-ls.pod:515 ../clone/virt-sysprep.pod:509 ../df/virt-df.pod:269 ../edit/virt-edit.pod:390 ../fish/guestfish.pod:1305 ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60 ../format/virt-format.pod:195 ../fuse/guestmount.pod:337 ../inspector/virt-inspector.pod:528 ../rescue/virt-rescue.pod:342 ../resize/virt-resize.pod:733 ../sparsify/virt-sparsify.pod:305 ../test-tool/libguestfs-test-tool.pod:121 ../tools/virt-list-filesystems.pl:218 ../tools/virt-list-partitions.pl:287 ../tools/virt-make-fs.pl:614 ../tools/virt-tar.pl:319 ../tools/virt-win-reg.pl:791 +#: ../align/virt-alignment-scan.pod:369 ../cat/virt-cat.pod:260 ../cat/virt-filesystems.pod:404 ../cat/virt-ls.pod:515 ../clone/virt-sysprep.pod:509 ../df/virt-df.pod:269 ../edit/virt-edit.pod:390 ../fish/guestfish.pod:1305 ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60 ../format/virt-format.pod:195 ../fuse/guestmount.pod:337 ../inspector/virt-inspector.pod:528 ../rescue/virt-rescue.pod:342 ../resize/virt-resize.pod:733 ../sparsify/virt-sparsify.pod:305 ../test-tool/libguestfs-test-tool.pod:121 ../tools/virt-list-filesystems.pl:218 ../tools/virt-list-partitions.pl:287 ../tools/virt-make-fs.pl:613 ../tools/virt-tar.pl:317 ../tools/virt-win-reg.pl:791 msgid "" "This program is free software; you can redistribute it and/or modify it " "under the terms of the GNU General Public License as published by the Free " @@ -787,7 +787,7 @@ msgid "" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:374 ../cat/virt-cat.pod:265 ../cat/virt-filesystems.pod:409 ../cat/virt-ls.pod:520 ../clone/virt-sysprep.pod:514 ../df/virt-df.pod:274 ../edit/virt-edit.pod:395 ../fish/guestfish.pod:1310 ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65 ../format/virt-format.pod:200 ../fuse/guestmount.pod:342 ../inspector/virt-inspector.pod:533 ../rescue/virt-rescue.pod:347 ../resize/virt-resize.pod:738 ../sparsify/virt-sparsify.pod:310 ../test-tool/libguestfs-test-tool.pod:126 ../tools/virt-list-filesystems.pl:223 ../tools/virt-list-partitions.pl:292 ../tools/virt-make-fs.pl:619 ../tools/virt-tar.pl:324 ../tools/virt-win-reg.pl:796 +#: ../align/virt-alignment-scan.pod:374 ../cat/virt-cat.pod:265 ../cat/virt-filesystems.pod:409 ../cat/virt-ls.pod:520 ../clone/virt-sysprep.pod:514 ../df/virt-df.pod:274 ../edit/virt-edit.pod:395 ../fish/guestfish.pod:1310 ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65 ../format/virt-format.pod:200 ../fuse/guestmount.pod:342 ../inspector/virt-inspector.pod:533 ../rescue/virt-rescue.pod:347 ../resize/virt-resize.pod:738 ../sparsify/virt-sparsify.pod:310 ../test-tool/libguestfs-test-tool.pod:126 ../tools/virt-list-filesystems.pl:223 ../tools/virt-list-partitions.pl:292 ../tools/virt-make-fs.pl:618 ../tools/virt-tar.pl:322 ../tools/virt-win-reg.pl:796 msgid "" "This program is distributed in the hope that it will be useful, but WITHOUT " "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or " @@ -796,7 +796,7 @@ msgid "" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:379 ../cat/virt-cat.pod:270 ../cat/virt-filesystems.pod:414 ../cat/virt-ls.pod:525 ../clone/virt-sysprep.pod:519 ../df/virt-df.pod:279 ../edit/virt-edit.pod:400 ../fish/guestfish.pod:1315 ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70 ../format/virt-format.pod:205 ../fuse/guestmount.pod:347 ../inspector/virt-inspector.pod:538 ../rescue/virt-rescue.pod:352 ../resize/virt-resize.pod:743 ../sparsify/virt-sparsify.pod:315 ../test-tool/libguestfs-test-tool.pod:131 ../tools/virt-list-filesystems.pl:228 ../tools/virt-list-partitions.pl:297 ../tools/virt-make-fs.pl:624 ../tools/virt-tar.pl:329 ../tools/virt-win-reg.pl:801 +#: ../align/virt-alignment-scan.pod:379 ../cat/virt-cat.pod:270 ../cat/virt-filesystems.pod:414 ../cat/virt-ls.pod:525 ../clone/virt-sysprep.pod:519 ../df/virt-df.pod:279 ../edit/virt-edit.pod:400 ../fish/guestfish.pod:1315 ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70 ../format/virt-format.pod:205 ../fuse/guestmount.pod:347 ../inspector/virt-inspector.pod:538 ../rescue/virt-rescue.pod:352 ../resize/virt-resize.pod:743 ../sparsify/virt-sparsify.pod:315 ../test-tool/libguestfs-test-tool.pod:131 ../tools/virt-list-filesystems.pl:228 ../tools/virt-list-partitions.pl:297 ../tools/virt-make-fs.pl:623 ../tools/virt-tar.pl:327 ../tools/virt-win-reg.pl:801 msgid "" "You should have received a copy of the GNU General Public License along with " "this program; if not, write to the Free Software Foundation, Inc., 51 " @@ -1169,7 +1169,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:258 ../inspector/virt-inspector.pod:526 ../resize/virt-resize.pod:731 ../tools/virt-make-fs.pl:612 +#: ../cat/virt-cat.pod:258 ../inspector/virt-inspector.pod:526 ../resize/virt-resize.pod:731 ../tools/virt-make-fs.pl:611 msgid "Copyright (C) 2010-2012 Red Hat Inc." msgstr "" @@ -2230,7 +2230,7 @@ msgid "" msgstr "" #. type: =head2 -#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4546 +#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4578 msgid "path" msgstr "" @@ -3273,7 +3273,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../clone/virt-sysprep.pod:429 ../src/guestfs.pod:1152 +#: ../clone/virt-sysprep.pod:429 ../src/guestfs.pod:1150 msgid "SECURITY" msgstr "" @@ -4178,7 +4178,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../edit/virt-edit.pod:343 ../fish/guestfish.pod:1119 ../rescue/virt-rescue.pod:298 ../sparsify/virt-sparsify.pod:257 ../src/guestfs.pod:3189 ../test-tool/libguestfs-test-tool.pod:101 +#: ../edit/virt-edit.pod:343 ../fish/guestfish.pod:1119 ../rescue/virt-rescue.pod:298 ../sparsify/virt-sparsify.pod:257 ../src/guestfs.pod:3212 ../test-tool/libguestfs-test-tool.pod:101 msgid "ENVIRONMENT VARIABLES" msgstr "" @@ -4421,12 +4421,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../erlang/examples/guestfs-erlang.pod:110 ../examples/guestfs-examples.pod:45 ../examples/guestfs-recipes.pod:397 ../examples/guestfs-testing.pod:298 ../fish/guestfish.pod:1296 ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:510 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52 ../python/examples/guestfs-python.pod:54 ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3331 ../test-tool/libguestfs-test-tool.pod:112 +#: ../erlang/examples/guestfs-erlang.pod:110 ../examples/guestfs-examples.pod:45 ../examples/guestfs-recipes.pod:397 ../examples/guestfs-testing.pod:298 ../fish/guestfish.pod:1296 ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:510 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52 ../python/examples/guestfs-python.pod:54 ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3354 ../test-tool/libguestfs-test-tool.pod:112 msgid "AUTHORS" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:112 ../examples/guestfs-examples.pod:47 ../examples/guestfs-recipes.pod:399 ../examples/guestfs-testing.pod:300 ../fish/guestfish.pod:1298 ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:330 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:54 ../python/examples/guestfs-python.pod:56 ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3333 ../test-tool/libguestfs-test-tool.pod:114 +#: ../erlang/examples/guestfs-erlang.pod:112 ../examples/guestfs-examples.pod:47 ../examples/guestfs-recipes.pod:399 ../examples/guestfs-testing.pod:300 ../fish/guestfish.pod:1298 ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:330 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:54 ../python/examples/guestfs-python.pod:56 ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3356 ../test-tool/libguestfs-test-tool.pod:114 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)" msgstr "" @@ -4443,7 +4443,7 @@ msgid "" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:121 ../examples/guestfs-examples.pod:56 ../examples/guestfs-recipes.pod:408 ../examples/guestfs-testing.pod:306 ../java/examples/guestfs-java.pod:69 ../ocaml/examples/guestfs-ocaml.pod:102 ../perl/examples/guestfs-perl.pod:63 ../python/examples/guestfs-python.pod:65 ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3340 +#: ../erlang/examples/guestfs-erlang.pod:121 ../examples/guestfs-examples.pod:56 ../examples/guestfs-recipes.pod:408 ../examples/guestfs-testing.pod:306 ../java/examples/guestfs-java.pod:69 ../ocaml/examples/guestfs-ocaml.pod:102 ../perl/examples/guestfs-perl.pod:63 ../python/examples/guestfs-python.pod:65 ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3363 msgid "" "This library is free software; you can redistribute it and/or modify it " "under the terms of the GNU Lesser General Public License as published by the " @@ -4452,7 +4452,7 @@ msgid "" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:126 ../examples/guestfs-examples.pod:61 ../examples/guestfs-recipes.pod:413 ../examples/guestfs-testing.pod:311 ../java/examples/guestfs-java.pod:74 ../ocaml/examples/guestfs-ocaml.pod:107 ../perl/examples/guestfs-perl.pod:68 ../python/examples/guestfs-python.pod:70 ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3345 +#: ../erlang/examples/guestfs-erlang.pod:126 ../examples/guestfs-examples.pod:61 ../examples/guestfs-recipes.pod:413 ../examples/guestfs-testing.pod:311 ../java/examples/guestfs-java.pod:74 ../ocaml/examples/guestfs-ocaml.pod:107 ../perl/examples/guestfs-perl.pod:68 ../python/examples/guestfs-python.pod:70 ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3368 msgid "" "This library is distributed in the hope that it will be useful, but WITHOUT " "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or " @@ -4461,7 +4461,7 @@ msgid "" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:131 ../examples/guestfs-examples.pod:66 ../examples/guestfs-recipes.pod:418 ../examples/guestfs-testing.pod:316 ../java/examples/guestfs-java.pod:79 ../ocaml/examples/guestfs-ocaml.pod:112 ../perl/examples/guestfs-perl.pod:73 ../python/examples/guestfs-python.pod:75 ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3350 +#: ../erlang/examples/guestfs-erlang.pod:131 ../examples/guestfs-examples.pod:66 ../examples/guestfs-recipes.pod:418 ../examples/guestfs-testing.pod:316 ../java/examples/guestfs-java.pod:79 ../ocaml/examples/guestfs-ocaml.pod:112 ../perl/examples/guestfs-perl.pod:73 ../python/examples/guestfs-python.pod:75 ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3373 msgid "" "You should have received a copy of the GNU Lesser General Public License " "along with this library; if not, write to the Free Software Foundation, " @@ -4492,7 +4492,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-examples.pod:15 ../src/guestfs.pod:19 +#: ../examples/guestfs-examples.pod:15 ../src/guestfs.pod:20 #, no-wrap msgid "" " cc prog.c -o prog -lguestfs\n" @@ -4796,7 +4796,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1509 ../fish/guestfish-actions.pod:1774 ../fish/guestfish-actions.pod:2189 ../src/guestfs-actions.pod:18 ../src/guestfs-actions.pod:2438 ../src/guestfs-actions.pod:2862 ../src/guestfs-actions.pod:3419 ../src/guestfs.pod:1673 ../tools/virt-win-reg.pl:717 +#: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1521 ../fish/guestfish-actions.pod:1786 ../fish/guestfish-actions.pod:2201 ../src/guestfs-actions.pod:18 ../src/guestfs-actions.pod:2454 ../src/guestfs-actions.pod:2878 ../src/guestfs-actions.pod:3435 ../src/guestfs.pod:1696 ../tools/virt-win-reg.pl:717 msgid "Notes:" msgstr "" @@ -5449,7 +5449,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-testing.pod:54 ../examples/guestfs-testing.pod:161 ../examples/guestfs-testing.pod:174 ../examples/guestfs-testing.pod:234 ../src/guestfs.pod:2781 +#: ../examples/guestfs-testing.pod:54 ../examples/guestfs-testing.pod:161 ../examples/guestfs-testing.pod:174 ../examples/guestfs-testing.pod:234 ../src/guestfs.pod:2804 msgid "or:" msgstr "" @@ -5623,7 +5623,7 @@ msgid "Try importing virt-df CSV output into a spreadsheet or database." msgstr "" #. type: textblock -#: ../examples/guestfs-testing.pod:131 ../src/guestfs.pod:3063 +#: ../examples/guestfs-testing.pod:131 ../src/guestfs.pod:3086 msgid "Run:" msgstr "" @@ -6082,7 +6082,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:217 ../fish/guestfish-actions.pod:231 ../fish/guestfish-actions.pod:972 ../fish/guestfish-actions.pod:1007 ../fish/guestfish-actions.pod:1208 ../fish/guestfish-actions.pod:1568 ../fish/guestfish-actions.pod:1582 ../fish/guestfish-actions.pod:3450 ../fish/guestfish-actions.pod:3761 ../fish/guestfish-actions.pod:3809 ../fish/guestfish-actions.pod:4729 ../fish/guestfish-actions.pod:4749 ../fish/guestfish-actions.pod:4768 ../fish/guestfish-actions.pod:4806 ../fish/guestfish-actions.pod:5534 ../fish/guestfish-actions.pod:5637 ../src/guestfs-actions.pod:10 ../src/guestfs-actions.pod:305 ../src/guestfs-actions.pod:326 ../src/guestfs-actions.pod:1621 ../src/guestfs-actions.pod:1678 ../src/guestfs-actions.pod:2024 ../src/guestfs-actions.pod:2523 ../src/guestfs-actions.pod:2544 ../src/guestfs-actions.pod:5351 ../src/guestfs-actions.pod:5873 ../src/guestfs-actions.pod:5973 ../src/guestfs-actions.pod:7271 ../src/guestfs-actions.pod:7312 ../src/guestfs-actions.pod:7343 ../src/guestfs-actions.pod:7403 ../src/guestfs-actions.pod:8457 ../src/guestfs-actions.pod:8566 ../src/guestfs-actions.pod:8746 +#: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:217 ../fish/guestfish-actions.pod:231 ../fish/guestfish-actions.pod:972 ../fish/guestfish-actions.pod:1007 ../fish/guestfish-actions.pod:1220 ../fish/guestfish-actions.pod:1580 ../fish/guestfish-actions.pod:1594 ../fish/guestfish-actions.pod:2761 ../fish/guestfish-actions.pod:3471 ../fish/guestfish-actions.pod:3793 ../fish/guestfish-actions.pod:3841 ../fish/guestfish-actions.pod:4761 ../fish/guestfish-actions.pod:4781 ../fish/guestfish-actions.pod:4800 ../fish/guestfish-actions.pod:4838 ../fish/guestfish-actions.pod:5586 ../fish/guestfish-actions.pod:5689 ../src/guestfs-actions.pod:10 ../src/guestfs-actions.pod:305 ../src/guestfs-actions.pod:326 ../src/guestfs-actions.pod:1621 ../src/guestfs-actions.pod:1678 ../src/guestfs-actions.pod:2040 ../src/guestfs-actions.pod:2539 ../src/guestfs-actions.pod:2560 ../src/guestfs-actions.pod:4211 ../src/guestfs-actions.pod:5376 ../src/guestfs-actions.pod:5912 ../src/guestfs-actions.pod:6012 ../src/guestfs-actions.pod:7310 ../src/guestfs-actions.pod:7351 ../src/guestfs-actions.pod:7382 ../src/guestfs-actions.pod:7442 ../src/guestfs-actions.pod:8519 ../src/guestfs-actions.pod:8628 ../src/guestfs-actions.pod:8808 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 " @@ -6246,7 +6246,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:125 ../fish/guestfish-actions.pod:194 ../fish/guestfish-actions.pod:655 ../fish/guestfish-actions.pod:866 ../fish/guestfish-actions.pod:887 ../fish/guestfish-actions.pod:925 ../fish/guestfish-actions.pod:934 ../fish/guestfish-actions.pod:943 ../fish/guestfish-actions.pod:957 ../fish/guestfish-actions.pod:1131 ../fish/guestfish-actions.pod:2228 ../fish/guestfish-actions.pod:3276 ../fish/guestfish-actions.pod:3499 ../fish/guestfish-actions.pod:3662 ../fish/guestfish-actions.pod:3797 ../fish/guestfish-actions.pod:5170 +#: ../fish/guestfish-actions.pod:125 ../fish/guestfish-actions.pod:194 ../fish/guestfish-actions.pod:655 ../fish/guestfish-actions.pod:866 ../fish/guestfish-actions.pod:887 ../fish/guestfish-actions.pod:925 ../fish/guestfish-actions.pod:934 ../fish/guestfish-actions.pod:943 ../fish/guestfish-actions.pod:957 ../fish/guestfish-actions.pod:1143 ../fish/guestfish-actions.pod:2240 ../fish/guestfish-actions.pod:3297 ../fish/guestfish-actions.pod:3520 ../fish/guestfish-actions.pod:3683 ../fish/guestfish-actions.pod:3829 ../fish/guestfish-actions.pod:5222 msgid "" "This command has one or more optional arguments. See L</OPTIONAL " "ARGUMENTS>." @@ -6325,7 +6325,7 @@ msgid "This call checks that C<filename> exists." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:161 ../fish/guestfish-actions.pod:3461 ../src/guestfs-actions.pod:221 ../src/guestfs-actions.pod:5388 +#: ../fish/guestfish-actions.pod:161 ../fish/guestfish-actions.pod:3482 ../src/guestfs-actions.pod:221 ../src/guestfs-actions.pod:5413 msgid "The optional arguments are:" msgstr "" @@ -6343,7 +6343,7 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:171 ../src/guestfs-actions.pod:231 ../src/guestfs.pod:2946 +#: ../fish/guestfish-actions.pod:171 ../src/guestfs-actions.pod:231 ../src/guestfs.pod:2969 msgid "C<format>" msgstr "" @@ -6376,7 +6376,7 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:187 ../fish/guestfish-actions.pod:3304 ../src/guestfs-actions.pod:247 ../src/guestfs-actions.pod:5105 +#: ../fish/guestfish-actions.pod:187 ../fish/guestfish-actions.pod:3325 ../src/guestfs-actions.pod:247 ../src/guestfs-actions.pod:5130 msgid "C<name>" msgstr "" @@ -7020,7 +7020,7 @@ msgid "This command uploads base64-encoded data from C<base64file> to C<filename msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:491 ../fish/guestfish-actions.pod:500 ../fish/guestfish-actions.pod:780 ../fish/guestfish-actions.pod:864 ../fish/guestfish-actions.pod:885 ../fish/guestfish-actions.pod:1056 ../fish/guestfish-actions.pod:1075 ../fish/guestfish-actions.pod:1477 ../fish/guestfish-actions.pod:5026 ../fish/guestfish-actions.pod:5038 ../fish/guestfish-actions.pod:5049 ../fish/guestfish-actions.pod:5060 ../fish/guestfish-actions.pod:5191 ../fish/guestfish-actions.pod:5200 ../fish/guestfish-actions.pod:5254 ../fish/guestfish-actions.pod:5277 +#: ../fish/guestfish-actions.pod:491 ../fish/guestfish-actions.pod:500 ../fish/guestfish-actions.pod:780 ../fish/guestfish-actions.pod:864 ../fish/guestfish-actions.pod:885 ../fish/guestfish-actions.pod:1068 ../fish/guestfish-actions.pod:1087 ../fish/guestfish-actions.pod:1489 ../fish/guestfish-actions.pod:5078 ../fish/guestfish-actions.pod:5090 ../fish/guestfish-actions.pod:5101 ../fish/guestfish-actions.pod:5112 ../fish/guestfish-actions.pod:5243 ../fish/guestfish-actions.pod:5252 ../fish/guestfish-actions.pod:5306 ../fish/guestfish-actions.pod:5329 msgid "Use C<-> instead of a filename to read/write from stdin/stdout." msgstr "" @@ -7357,12 +7357,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:642 ../fish/guestfish-actions.pod:3225 ../fish/guestfish-actions.pod:3772 ../fish/guestfish-actions.pod:5100 ../src/guestfs-actions.pod:944 ../src/guestfs-actions.pod:4998 ../src/guestfs-actions.pod:5912 ../src/guestfs-actions.pod:7890 +#: ../fish/guestfish-actions.pod:642 ../fish/guestfish-actions.pod:3246 ../fish/guestfish-actions.pod:3804 ../fish/guestfish-actions.pod:5152 ../src/guestfs-actions.pod:944 ../src/guestfs-actions.pod:5023 ../src/guestfs-actions.pod:5951 ../src/guestfs-actions.pod:7952 msgid "The optional parameters are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:646 ../fish/guestfish-actions.pod:3776 ../src/guestfs-actions.pod:948 ../src/guestfs-actions.pod:5916 +#: ../fish/guestfish-actions.pod:646 ../fish/guestfish-actions.pod:3808 ../src/guestfs-actions.pod:948 ../src/guestfs-actions.pod:5955 msgid "C<size>" msgstr "" @@ -7463,7 +7463,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:697 ../fish/guestfish-actions.pod:4203 ../src/guestfs-actions.pod:1032 ../src/guestfs-actions.pod:6572 +#: ../fish/guestfish-actions.pod:697 ../fish/guestfish-actions.pod:4235 ../src/guestfs-actions.pod:1032 ../src/guestfs-actions.pod:6611 msgid "Return the contents of the file named C<path>." msgstr "" @@ -7477,7 +7477,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:704 ../fish/guestfish-actions.pod:839 ../fish/guestfish-actions.pod:851 ../fish/guestfish-actions.pod:1162 ../fish/guestfish-actions.pod:1172 ../fish/guestfish-actions.pod:1239 ../fish/guestfish-actions.pod:1249 ../fish/guestfish-actions.pod:1441 ../fish/guestfish-actions.pod:1754 ../fish/guestfish-actions.pod:1764 ../fish/guestfish-actions.pod:1814 ../fish/guestfish-actions.pod:1829 ../fish/guestfish-actions.pod:1839 ../fish/guestfish-actions.pod:1858 ../fish/guestfish-actions.pod:4073 ../fish/guestfish-actions.pod:4088 ../fish/guestfish-actions.pod:4164 ../fish/guestfish-actions.pod:4181 ../fish/guestfish-actions.pod:4196 ../fish/guestfish-actions.pod:4867 ../fish/guestfish-actions.pod:4913 ../fish/guestfish-actions.pod:4998 ../fish/guestfish-actions.pod:5013 ../fish/guestfish-actions.pod:5498 ../fish/guestfish-actions.pod:5510 ../fish/guestfish-actions.pod:5528 ../fish/guestfish-actions.pod:5545 ../fish/guestfish-actions.pod:5555 ../fish/guestfish-actions.pod:5609 ../fish/guestfish-actions.pod:5619 ../fish/guestfish-actions.pod:5648 ../fish/guestfish-actions.pod:5658 ../src/guestfs-actions.pod:1042 ../src/guestfs-actions.pod:1221 ../src/guestfs-actions.pod:1241 ../src/guestfs-actions.pod:1959 ../src/guestfs-actions.pod:1978 ../src/guestfs-actions.pod:2081 ../src/guestfs-actions.pod:2100 ../src/guestfs-actions.pod:2346 ../src/guestfs-actions.pod:2828 ../src/guestfs-actions.pod:2847 ../src/guestfs-actions.pod:2912 ../src/guestfs-actions.pod:2936 ../src/guestfs-actions.pod:2953 ../src/guestfs-actions.pod:2982 ../src/guestfs-actions.pod:6354 ../src/guestfs-actions.pod:6380 ../src/guestfs-actions.pod:6511 ../src/guestfs-actions.pod:6537 ../src/guestfs-actions.pod:6561 ../src/guestfs-actions.pod:7518 ../src/guestfs-actions.pod:7573 ../src/guestfs-actions.pod:7719 ../src/guestfs-actions.pod:7743 ../src/guestfs-actions.pod:8530 ../src/guestfs-actions.pod:8550 ../src/guestfs-actions.pod:8583 ../src/guestfs-actions.pod:8602 ../src/guestfs-actions.pod:8621 ../src/guestfs-actions.pod:8712 ../src/guestfs-actions.pod:8731 ../src/guestfs-actions.pod:8777 ../src/guestfs-actions.pod:8796 +#: ../fish/guestfish-actions.pod:704 ../fish/guestfish-actions.pod:839 ../fish/guestfish-actions.pod:851 ../fish/guestfish-actions.pod:1174 ../fish/guestfish-actions.pod:1184 ../fish/guestfish-actions.pod:1251 ../fish/guestfish-actions.pod:1261 ../fish/guestfish-actions.pod:1453 ../fish/guestfish-actions.pod:1766 ../fish/guestfish-actions.pod:1776 ../fish/guestfish-actions.pod:1826 ../fish/guestfish-actions.pod:1841 ../fish/guestfish-actions.pod:1851 ../fish/guestfish-actions.pod:1870 ../fish/guestfish-actions.pod:4105 ../fish/guestfish-actions.pod:4120 ../fish/guestfish-actions.pod:4196 ../fish/guestfish-actions.pod:4213 ../fish/guestfish-actions.pod:4228 ../fish/guestfish-actions.pod:4919 ../fish/guestfish-actions.pod:4965 ../fish/guestfish-actions.pod:5050 ../fish/guestfish-actions.pod:5065 ../fish/guestfish-actions.pod:5550 ../fish/guestfish-actions.pod:5562 ../fish/guestfish-actions.pod:5580 ../fish/guestfish-actions.pod:5597 ../fish/guestfish-actions.pod:5607 ../fish/guestfish-actions.pod:5661 ../fish/guestfish-actions.pod:5671 ../fish/guestfish-actions.pod:5700 ../fish/guestfish-actions.pod:5710 ../src/guestfs-actions.pod:1042 ../src/guestfs-actions.pod:1221 ../src/guestfs-actions.pod:1241 ../src/guestfs-actions.pod:1975 ../src/guestfs-actions.pod:1994 ../src/guestfs-actions.pod:2097 ../src/guestfs-actions.pod:2116 ../src/guestfs-actions.pod:2362 ../src/guestfs-actions.pod:2844 ../src/guestfs-actions.pod:2863 ../src/guestfs-actions.pod:2928 ../src/guestfs-actions.pod:2952 ../src/guestfs-actions.pod:2969 ../src/guestfs-actions.pod:2998 ../src/guestfs-actions.pod:6393 ../src/guestfs-actions.pod:6419 ../src/guestfs-actions.pod:6550 ../src/guestfs-actions.pod:6576 ../src/guestfs-actions.pod:6600 ../src/guestfs-actions.pod:7580 ../src/guestfs-actions.pod:7635 ../src/guestfs-actions.pod:7781 ../src/guestfs-actions.pod:7805 ../src/guestfs-actions.pod:8592 ../src/guestfs-actions.pod:8612 ../src/guestfs-actions.pod:8645 ../src/guestfs-actions.pod:8664 ../src/guestfs-actions.pod:8683 ../src/guestfs-actions.pod:8774 ../src/guestfs-actions.pod:8793 ../src/guestfs-actions.pod:8839 ../src/guestfs-actions.pod:8858 msgid "" "Because of the message protocol, there is a transfer limit of somewhere " "between 2MB and 4MB. See L<guestfs(3)/PROTOCOL LIMITS>." @@ -7675,7 +7675,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:793 ../fish/guestfish-actions.pod:3425 ../fish/guestfish-actions.pod:3564 ../fish/guestfish-actions.pod:3574 ../fish/guestfish-actions.pod:3584 ../src/guestfs-actions.pod:1158 ../src/guestfs-actions.pod:5319 ../src/guestfs-actions.pod:5528 ../src/guestfs-actions.pod:5547 ../src/guestfs-actions.pod:5566 +#: ../fish/guestfish-actions.pod:793 ../fish/guestfish-actions.pod:3446 ../fish/guestfish-actions.pod:3585 ../fish/guestfish-actions.pod:3595 ../fish/guestfish-actions.pod:3605 ../src/guestfs-actions.pod:1158 ../src/guestfs-actions.pod:5344 ../src/guestfs-actions.pod:5553 ../src/guestfs-actions.pod:5572 ../src/guestfs-actions.pod:5591 msgid "The mode actually set is affected by the umask." msgstr "" @@ -7698,7 +7698,7 @@ msgid "Change the file owner to C<owner> and group to C<group>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:801 ../fish/guestfish-actions.pod:2764 ../src/guestfs-actions.pod:1174 ../src/guestfs-actions.pod:4230 +#: ../fish/guestfish-actions.pod:801 ../fish/guestfish-actions.pod:2785 ../src/guestfs-actions.pod:1174 ../src/guestfs-actions.pod:4255 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 " @@ -8084,24 +8084,56 @@ msgstr "" #. type: =head2 #: ../fish/guestfish-actions.pod:1011 -msgid "df" +msgid "device-index" msgstr "" #. type: verbatim #: ../fish/guestfish-actions.pod:1013 #, no-wrap msgid "" +" device-index device\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1015 ../src/guestfs-actions.pod:1702 +msgid "" +"This function takes a device name (eg. \"/dev/sdb\") and returns the index " +"of the device in the list of devices." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1018 +msgid "" +"Index numbers start from 0. The named device must exist, for example as a " +"string returned from L</list-devices>." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1021 +msgid "See also L</list-devices>, L</part-to-dev>." +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:1023 +msgid "df" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:1025 +#, no-wrap +msgid "" " df\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1015 ../src/guestfs-actions.pod:1701 +#: ../fish/guestfish-actions.pod:1027 ../src/guestfs-actions.pod:1717 msgid "This command runs the C<df> command to report disk space used." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1017 ../fish/guestfish-actions.pod:1028 +#: ../fish/guestfish-actions.pod:1029 ../fish/guestfish-actions.pod:1040 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 " @@ -8109,12 +8141,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1021 +#: ../fish/guestfish-actions.pod:1033 msgid "df-h" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1023 +#: ../fish/guestfish-actions.pod:1035 #, no-wrap msgid "" " df-h\n" @@ -8122,19 +8154,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1025 ../src/guestfs-actions.pod:1717 +#: ../fish/guestfish-actions.pod:1037 ../src/guestfs-actions.pod:1733 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:1032 +#: ../fish/guestfish-actions.pod:1044 msgid "dmesg" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1034 +#: ../fish/guestfish-actions.pod:1046 #, no-wrap msgid "" " dmesg\n" @@ -8142,14 +8174,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1036 ../src/guestfs-actions.pod:1734 +#: ../fish/guestfish-actions.pod:1048 ../src/guestfs-actions.pod:1750 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:1040 +#: ../fish/guestfish-actions.pod:1052 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> " @@ -8157,12 +8189,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1045 +#: ../fish/guestfish-actions.pod:1057 msgid "download" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1047 +#: ../fish/guestfish-actions.pod:1059 #, no-wrap msgid "" " download remotefilename (filename|-)\n" @@ -8170,29 +8202,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1049 ../fish/guestfish-actions.pod:1062 ../src/guestfs-actions.pod:1755 ../src/guestfs-actions.pod:1780 +#: ../fish/guestfish-actions.pod:1061 ../fish/guestfish-actions.pod:1074 ../src/guestfs-actions.pod:1771 ../src/guestfs-actions.pod:1796 msgid "" "Download file C<remotefilename> and save it as C<filename> on the local " "machine." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1052 ../fish/guestfish-actions.pod:5250 ../src/guestfs-actions.pod:1758 ../src/guestfs-actions.pod:8100 +#: ../fish/guestfish-actions.pod:1064 ../fish/guestfish-actions.pod:5302 ../src/guestfs-actions.pod:1774 ../src/guestfs-actions.pod:8162 msgid "C<filename> can also be a named pipe." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1054 +#: ../fish/guestfish-actions.pod:1066 msgid "See also L</upload>, L</cat>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1058 +#: ../fish/guestfish-actions.pod:1070 msgid "download-offset" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1060 +#: ../fish/guestfish-actions.pod:1072 #, no-wrap msgid "" " download-offset remotefilename (filename|-) offset size\n" @@ -8200,14 +8232,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1065 ../src/guestfs-actions.pod:1783 +#: ../fish/guestfish-actions.pod:1077 ../src/guestfs-actions.pod:1799 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:1068 +#: ../fish/guestfish-actions.pod:1080 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 " @@ -8215,17 +8247,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1073 +#: ../fish/guestfish-actions.pod:1085 msgid "See also L</download>, L</pread>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1077 +#: ../fish/guestfish-actions.pod:1089 msgid "drop-caches" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1079 +#: ../fish/guestfish-actions.pod:1091 #, no-wrap msgid "" " drop-caches whattodrop\n" @@ -8233,7 +8265,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1081 ../src/guestfs-actions.pod:1808 +#: ../fish/guestfish-actions.pod:1093 ../src/guestfs-actions.pod:1824 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 " @@ -8241,24 +8273,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1086 ../src/guestfs-actions.pod:1813 +#: ../fish/guestfish-actions.pod:1098 ../src/guestfs-actions.pod:1829 msgid "Setting C<whattodrop> to 3 should drop everything." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1088 ../src/guestfs-actions.pod:1815 +#: ../fish/guestfish-actions.pod:1100 ../src/guestfs-actions.pod:1831 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:1091 +#: ../fish/guestfish-actions.pod:1103 msgid "du" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1093 +#: ../fish/guestfish-actions.pod:1105 #, no-wrap msgid "" " du path\n" @@ -8266,14 +8298,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1095 ../src/guestfs-actions.pod:1828 +#: ../fish/guestfish-actions.pod:1107 ../src/guestfs-actions.pod:1844 msgid "" "This command runs the C<du -s> command to estimate file space usage for " "C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1098 ../src/guestfs-actions.pod:1831 +#: ../fish/guestfish-actions.pod:1110 ../src/guestfs-actions.pod:1847 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 " @@ -8281,17 +8313,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1102 ../src/guestfs-actions.pod:1835 +#: ../fish/guestfish-actions.pod:1114 ../src/guestfs-actions.pod:1851 msgid "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1105 +#: ../fish/guestfish-actions.pod:1117 msgid "e2fsck" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1107 +#: ../fish/guestfish-actions.pod:1119 #, no-wrap msgid "" " e2fsck device [correct:true|false] [forceall:true|false]\n" @@ -8299,19 +8331,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1109 ../src/guestfs-actions.pod:1862 +#: ../fish/guestfish-actions.pod:1121 ../src/guestfs-actions.pod:1878 msgid "" "This runs the ext2/ext3 filesystem checker on C<device>. It can take the " "following optional arguments:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1114 ../src/guestfs-actions.pod:1867 +#: ../fish/guestfish-actions.pod:1126 ../src/guestfs-actions.pod:1883 msgid "C<correct>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1116 ../src/guestfs-actions.pod:1869 +#: ../fish/guestfish-actions.pod:1128 ../src/guestfs-actions.pod:1885 msgid "" "Automatically repair the file system. This option will cause e2fsck to " "automatically fix any filesystem problems that can be safely fixed without " @@ -8319,34 +8351,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1120 ../src/guestfs-actions.pod:1873 +#: ../fish/guestfish-actions.pod:1132 ../src/guestfs-actions.pod:1889 msgid "This option may not be specified at the same time as the C<forceall> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1122 ../src/guestfs-actions.pod:1875 +#: ../fish/guestfish-actions.pod:1134 ../src/guestfs-actions.pod:1891 msgid "C<forceall>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1124 ../src/guestfs-actions.pod:1877 +#: ../fish/guestfish-actions.pod:1136 ../src/guestfs-actions.pod:1893 msgid "" "Assume an answer of 'yes' to all questions; allows e2fsck to be used " "non-interactively." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1127 ../src/guestfs-actions.pod:1880 +#: ../fish/guestfish-actions.pod:1139 ../src/guestfs-actions.pod:1896 msgid "This option may not be specified at the same time as the C<correct> option." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1133 +#: ../fish/guestfish-actions.pod:1145 msgid "e2fsck-f" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1135 +#: ../fish/guestfish-actions.pod:1147 #, no-wrap msgid "" " e2fsck-f device\n" @@ -8354,7 +8386,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1137 ../src/guestfs-actions.pod:1916 +#: ../fish/guestfish-actions.pod:1149 ../src/guestfs-actions.pod:1932 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 " @@ -8362,19 +8394,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1141 +#: ../fish/guestfish-actions.pod:1153 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:1144 +#: ../fish/guestfish-actions.pod:1156 msgid "echo-daemon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1146 +#: ../fish/guestfish-actions.pod:1158 #, no-wrap msgid "" " echo-daemon 'words ...'\n" @@ -8382,29 +8414,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1148 ../src/guestfs-actions.pod:1933 +#: ../fish/guestfish-actions.pod:1160 ../src/guestfs-actions.pod:1949 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:1151 ../src/guestfs-actions.pod:1936 +#: ../fish/guestfish-actions.pod:1163 ../src/guestfs-actions.pod:1952 msgid "You can use this command to test the connection through to the daemon." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1153 +#: ../fish/guestfish-actions.pod:1165 msgid "See also L</ping-daemon>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1155 +#: ../fish/guestfish-actions.pod:1167 msgid "egrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1157 +#: ../fish/guestfish-actions.pod:1169 #, no-wrap msgid "" " egrep regex path\n" @@ -8412,17 +8444,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1159 ../src/guestfs-actions.pod:1952 +#: ../fish/guestfish-actions.pod:1171 ../src/guestfs-actions.pod:1968 msgid "This calls the external C<egrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1165 +#: ../fish/guestfish-actions.pod:1177 msgid "egrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1167 +#: ../fish/guestfish-actions.pod:1179 #, no-wrap msgid "" " egrepi regex path\n" @@ -8430,17 +8462,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1169 ../src/guestfs-actions.pod:1971 +#: ../fish/guestfish-actions.pod:1181 ../src/guestfs-actions.pod:1987 msgid "This calls the external C<egrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1175 +#: ../fish/guestfish-actions.pod:1187 msgid "equal" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1177 +#: ../fish/guestfish-actions.pod:1189 #, no-wrap msgid "" " equal file1 file2\n" @@ -8448,24 +8480,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1179 ../src/guestfs-actions.pod:1990 +#: ../fish/guestfish-actions.pod:1191 ../src/guestfs-actions.pod:2006 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:1182 ../src/guestfs-actions.pod:1993 +#: ../fish/guestfish-actions.pod:1194 ../src/guestfs-actions.pod:2009 msgid "The external L<cmp(1)> program is used for the comparison." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1184 +#: ../fish/guestfish-actions.pod:1196 msgid "exists" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1186 +#: ../fish/guestfish-actions.pod:1198 #, no-wrap msgid "" " exists path\n" @@ -8473,24 +8505,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1188 ../src/guestfs-actions.pod:2005 +#: ../fish/guestfish-actions.pod:1200 ../src/guestfs-actions.pod:2021 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:1191 +#: ../fish/guestfish-actions.pod:1203 msgid "See also L</is-file>, L</is-dir>, L</stat>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1193 +#: ../fish/guestfish-actions.pod:1205 msgid "fallocate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1195 +#: ../fish/guestfish-actions.pod:1207 #, no-wrap msgid "" " fallocate path len\n" @@ -8498,33 +8530,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1197 ../fish/guestfish-actions.pod:1216 ../src/guestfs-actions.pod:2028 ../src/guestfs-actions.pod:2047 +#: ../fish/guestfish-actions.pod:1209 ../fish/guestfish-actions.pod:1228 ../src/guestfs-actions.pod:2044 ../src/guestfs-actions.pod:2063 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:1201 ../src/guestfs-actions.pod:2032 +#: ../fish/guestfish-actions.pod:1213 ../src/guestfs-actions.pod:2048 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:1205 +#: ../fish/guestfish-actions.pod:1217 msgid "" "I<This function is deprecated.> In new code, use the L</fallocate64> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1212 +#: ../fish/guestfish-actions.pod:1224 msgid "fallocate64" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1214 +#: ../fish/guestfish-actions.pod:1226 #, no-wrap msgid "" " fallocate64 path len\n" @@ -8532,14 +8564,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1220 +#: ../fish/guestfish-actions.pod:1232 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:1223 +#: ../fish/guestfish-actions.pod:1235 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 " @@ -8547,19 +8579,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1228 ../src/guestfs-actions.pod:2059 +#: ../fish/guestfish-actions.pod:1240 ../src/guestfs-actions.pod:2075 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:1232 +#: ../fish/guestfish-actions.pod:1244 msgid "fgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1234 +#: ../fish/guestfish-actions.pod:1246 #, no-wrap msgid "" " fgrep pattern path\n" @@ -8567,17 +8599,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1236 ../src/guestfs-actions.pod:2074 +#: ../fish/guestfish-actions.pod:1248 ../src/guestfs-actions.pod:2090 msgid "This calls the external C<fgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1242 +#: ../fish/guestfish-actions.pod:1254 msgid "fgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1244 +#: ../fish/guestfish-actions.pod:1256 #, no-wrap msgid "" " fgrepi pattern path\n" @@ -8585,17 +8617,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1246 ../src/guestfs-actions.pod:2093 +#: ../fish/guestfish-actions.pod:1258 ../src/guestfs-actions.pod:2109 msgid "This calls the external C<fgrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1252 +#: ../fish/guestfish-actions.pod:1264 msgid "file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1254 +#: ../fish/guestfish-actions.pod:1266 #, no-wrap msgid "" " file path\n" @@ -8603,28 +8635,28 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1256 ../src/guestfs-actions.pod:2111 +#: ../fish/guestfish-actions.pod:1268 ../src/guestfs-actions.pod:2127 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:1259 ../src/guestfs-actions.pod:2114 +#: ../fish/guestfish-actions.pod:1271 ../src/guestfs-actions.pod:2130 msgid "" "This call will also transparently look inside various types of compressed " "file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1262 ../src/guestfs-actions.pod:2117 +#: ../fish/guestfish-actions.pod:1274 ../src/guestfs-actions.pod:2133 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:1266 ../src/guestfs-actions.pod:2121 +#: ../fish/guestfish-actions.pod:1278 ../src/guestfs-actions.pod:2137 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 " @@ -8632,19 +8664,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1270 +#: ../fish/guestfish-actions.pod:1282 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:1273 +#: ../fish/guestfish-actions.pod:1285 msgid "file-architecture" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1275 +#: ../fish/guestfish-actions.pod:1287 #, no-wrap msgid "" " file-architecture filename\n" @@ -8652,166 +8684,166 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1277 ../src/guestfs-actions.pod:2139 +#: ../fish/guestfish-actions.pod:1289 ../src/guestfs-actions.pod:2155 msgid "" "This detects the architecture of the binary C<filename>, and returns it if " "known." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1280 ../src/guestfs-actions.pod:2142 +#: ../fish/guestfish-actions.pod:1292 ../src/guestfs-actions.pod:2158 msgid "Currently defined architectures are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1284 ../src/guestfs-actions.pod:2146 +#: ../fish/guestfish-actions.pod:1296 ../src/guestfs-actions.pod:2162 msgid "\"i386\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1286 ../src/guestfs-actions.pod:2148 +#: ../fish/guestfish-actions.pod:1298 ../src/guestfs-actions.pod:2164 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:1289 ../src/guestfs-actions.pod:2151 +#: ../fish/guestfish-actions.pod:1301 ../src/guestfs-actions.pod:2167 msgid "\"x86_64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1291 ../src/guestfs-actions.pod:2153 +#: ../fish/guestfish-actions.pod:1303 ../src/guestfs-actions.pod:2169 msgid "64 bit x86-64." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1293 ../src/guestfs-actions.pod:2155 +#: ../fish/guestfish-actions.pod:1305 ../src/guestfs-actions.pod:2171 msgid "\"sparc\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1295 ../src/guestfs-actions.pod:2157 +#: ../fish/guestfish-actions.pod:1307 ../src/guestfs-actions.pod:2173 msgid "32 bit SPARC." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1297 ../src/guestfs-actions.pod:2159 +#: ../fish/guestfish-actions.pod:1309 ../src/guestfs-actions.pod:2175 msgid "\"sparc64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1299 ../src/guestfs-actions.pod:2161 +#: ../fish/guestfish-actions.pod:1311 ../src/guestfs-actions.pod:2177 msgid "64 bit SPARC V9 and above." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1301 ../src/guestfs-actions.pod:2163 +#: ../fish/guestfish-actions.pod:1313 ../src/guestfs-actions.pod:2179 msgid "\"ia64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1303 ../src/guestfs-actions.pod:2165 +#: ../fish/guestfish-actions.pod:1315 ../src/guestfs-actions.pod:2181 msgid "Intel Itanium." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1305 ../src/guestfs-actions.pod:2167 +#: ../fish/guestfish-actions.pod:1317 ../src/guestfs-actions.pod:2183 msgid "\"ppc\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1307 ../src/guestfs-actions.pod:2169 +#: ../fish/guestfish-actions.pod:1319 ../src/guestfs-actions.pod:2185 msgid "32 bit Power PC." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1309 ../src/guestfs-actions.pod:2171 +#: ../fish/guestfish-actions.pod:1321 ../src/guestfs-actions.pod:2187 msgid "\"ppc64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1311 ../src/guestfs-actions.pod:2173 +#: ../fish/guestfish-actions.pod:1323 ../src/guestfs-actions.pod:2189 msgid "64 bit Power PC." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1315 ../src/guestfs-actions.pod:2177 +#: ../fish/guestfish-actions.pod:1327 ../src/guestfs-actions.pod:2193 msgid "Libguestfs may return other architecture strings in future." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1317 ../src/guestfs-actions.pod:2179 +#: ../fish/guestfish-actions.pod:1329 ../src/guestfs-actions.pod:2195 msgid "The function works on at least the following types of files:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1323 ../src/guestfs-actions.pod:2185 +#: ../fish/guestfish-actions.pod:1335 ../src/guestfs-actions.pod:2201 msgid "many types of Un*x and Linux binary" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1327 ../src/guestfs-actions.pod:2189 +#: ../fish/guestfish-actions.pod:1339 ../src/guestfs-actions.pod:2205 msgid "many types of Un*x and Linux shared library" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1331 ../src/guestfs-actions.pod:2193 +#: ../fish/guestfish-actions.pod:1343 ../src/guestfs-actions.pod:2209 msgid "Windows Win32 and Win64 binaries" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1335 ../src/guestfs-actions.pod:2197 +#: ../fish/guestfish-actions.pod:1347 ../src/guestfs-actions.pod:2213 msgid "Windows Win32 and Win64 DLLs" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1337 ../src/guestfs-actions.pod:2199 +#: ../fish/guestfish-actions.pod:1349 ../src/guestfs-actions.pod:2215 msgid "Win32 binaries and DLLs return C<i386>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1339 ../src/guestfs-actions.pod:2201 +#: ../fish/guestfish-actions.pod:1351 ../src/guestfs-actions.pod:2217 msgid "Win64 binaries and DLLs return C<x86_64>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1343 ../src/guestfs-actions.pod:2205 +#: ../fish/guestfish-actions.pod:1355 ../src/guestfs-actions.pod:2221 msgid "Linux kernel modules" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1347 ../src/guestfs-actions.pod:2209 +#: ../fish/guestfish-actions.pod:1359 ../src/guestfs-actions.pod:2225 msgid "Linux new-style initrd images" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1351 ../src/guestfs-actions.pod:2213 +#: ../fish/guestfish-actions.pod:1363 ../src/guestfs-actions.pod:2229 msgid "some non-x86 Linux vmlinuz kernels" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1355 ../src/guestfs-actions.pod:2217 +#: ../fish/guestfish-actions.pod:1367 ../src/guestfs-actions.pod:2233 msgid "What it can't do currently:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1361 ../src/guestfs-actions.pod:2223 +#: ../fish/guestfish-actions.pod:1373 ../src/guestfs-actions.pod:2239 msgid "static libraries (libfoo.a)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1365 ../src/guestfs-actions.pod:2227 +#: ../fish/guestfish-actions.pod:1377 ../src/guestfs-actions.pod:2243 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1369 ../src/guestfs-actions.pod:2231 +#: ../fish/guestfish-actions.pod:1381 ../src/guestfs-actions.pod:2247 msgid "x86 Linux vmlinuz kernels" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1371 ../src/guestfs-actions.pod:2233 +#: ../fish/guestfish-actions.pod:1383 ../src/guestfs-actions.pod:2249 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 " @@ -8820,12 +8852,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1378 +#: ../fish/guestfish-actions.pod:1390 msgid "filesize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1380 +#: ../fish/guestfish-actions.pod:1392 #, no-wrap msgid "" " filesize file\n" @@ -8833,12 +8865,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1382 ../src/guestfs-actions.pod:2251 +#: ../fish/guestfish-actions.pod:1394 ../src/guestfs-actions.pod:2267 msgid "This command returns the size of C<file> in bytes." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1384 +#: ../fish/guestfish-actions.pod:1396 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 " @@ -8846,12 +8878,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1388 +#: ../fish/guestfish-actions.pod:1400 msgid "fill" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1390 +#: ../fish/guestfish-actions.pod:1402 #, no-wrap msgid "" " fill c len path\n" @@ -8859,7 +8891,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1392 ../src/guestfs-actions.pod:2269 +#: ../fish/guestfish-actions.pod:1404 ../src/guestfs-actions.pod:2285 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 " @@ -8867,7 +8899,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1396 +#: ../fish/guestfish-actions.pod:1408 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 " @@ -8875,12 +8907,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1401 +#: ../fish/guestfish-actions.pod:1413 msgid "fill-pattern" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1403 +#: ../fish/guestfish-actions.pod:1415 #, no-wrap msgid "" " fill-pattern pattern len path\n" @@ -8888,7 +8920,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1405 +#: ../fish/guestfish-actions.pod:1417 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 " @@ -8897,12 +8929,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1410 +#: ../fish/guestfish-actions.pod:1422 msgid "find" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1412 +#: ../fish/guestfish-actions.pod:1424 #, no-wrap msgid "" " find directory\n" @@ -8910,7 +8942,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1414 ../src/guestfs-actions.pod:2315 +#: ../fish/guestfish-actions.pod:1426 ../src/guestfs-actions.pod:2331 msgid "" "This command lists out all files and directories, recursively, starting at " "C<directory>. It is essentially equivalent to running the shell command " @@ -8919,14 +8951,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1419 ../src/guestfs-actions.pod:2320 +#: ../fish/guestfish-actions.pod:1431 ../src/guestfs-actions.pod:2336 msgid "" "This returns a list of strings I<without any prefix>. Thus if the directory " "structure was:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1422 ../src/guestfs-actions.pod:2323 +#: ../fish/guestfish-actions.pod:1434 ../src/guestfs-actions.pod:2339 #, no-wrap msgid "" " /tmp/a\n" @@ -8936,12 +8968,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1426 +#: ../fish/guestfish-actions.pod:1438 msgid "then the returned list from L</find> C</tmp> would be 4 elements:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1429 ../src/guestfs-actions.pod:2330 +#: ../fish/guestfish-actions.pod:1441 ../src/guestfs-actions.pod:2346 #, no-wrap msgid "" " a\n" @@ -8952,27 +8984,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1434 ../src/guestfs-actions.pod:2335 +#: ../fish/guestfish-actions.pod:1446 ../src/guestfs-actions.pod:2351 msgid "If C<directory> is not a directory, then this command returns an error." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1437 ../src/guestfs-actions.pod:2338 +#: ../fish/guestfish-actions.pod:1449 ../src/guestfs-actions.pod:2354 msgid "The returned list is sorted." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1439 +#: ../fish/guestfish-actions.pod:1451 msgid "See also L</find0>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1444 +#: ../fish/guestfish-actions.pod:1456 msgid "find0" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1446 +#: ../fish/guestfish-actions.pod:1458 #, no-wrap msgid "" " find0 directory (files|-)\n" @@ -8980,7 +9012,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1448 ../src/guestfs-actions.pod:2358 +#: ../fish/guestfish-actions.pod:1460 ../src/guestfs-actions.pod:2374 msgid "" "This command lists out all files and directories, recursively, starting at " "C<directory>, placing the resulting list in the external file called " @@ -8988,39 +9020,39 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1452 +#: ../fish/guestfish-actions.pod:1464 msgid "This command works the same way as L</find> with the following exceptions:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1459 ../src/guestfs-actions.pod:2369 +#: ../fish/guestfish-actions.pod:1471 ../src/guestfs-actions.pod:2385 msgid "The resulting list is written to an external file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1463 ../src/guestfs-actions.pod:2373 +#: ../fish/guestfish-actions.pod:1475 ../src/guestfs-actions.pod:2389 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:1468 ../src/guestfs-actions.pod:2378 +#: ../fish/guestfish-actions.pod:1480 ../src/guestfs-actions.pod:2394 msgid "This command is not limited in the number of names that it can return." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1473 ../src/guestfs-actions.pod:2383 +#: ../fish/guestfish-actions.pod:1485 ../src/guestfs-actions.pod:2399 msgid "The result list is not sorted." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1479 +#: ../fish/guestfish-actions.pod:1491 msgid "findfs-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1481 +#: ../fish/guestfish-actions.pod:1493 #, no-wrap msgid "" " findfs-label label\n" @@ -9028,24 +9060,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1483 ../src/guestfs-actions.pod:2397 +#: ../fish/guestfish-actions.pod:1495 ../src/guestfs-actions.pod:2413 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:1487 +#: ../fish/guestfish-actions.pod:1499 msgid "To find the label of a filesystem, use L</vfs-label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1489 +#: ../fish/guestfish-actions.pod:1501 msgid "findfs-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1491 +#: ../fish/guestfish-actions.pod:1503 #, no-wrap msgid "" " findfs-uuid uuid\n" @@ -9053,24 +9085,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1493 ../src/guestfs-actions.pod:2414 +#: ../fish/guestfish-actions.pod:1505 ../src/guestfs-actions.pod:2430 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:1497 +#: ../fish/guestfish-actions.pod:1509 msgid "To find the UUID of a filesystem, use L</vfs-uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1499 +#: ../fish/guestfish-actions.pod:1511 msgid "fsck" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1501 +#: ../fish/guestfish-actions.pod:1513 #, no-wrap msgid "" " fsck fstype device\n" @@ -9078,48 +9110,48 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1503 ../src/guestfs-actions.pod:2432 +#: ../fish/guestfish-actions.pod:1515 ../src/guestfs-actions.pod:2448 msgid "" "This runs the filesystem checker (fsck) on C<device> which should have " "filesystem type C<fstype>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1506 ../src/guestfs-actions.pod:2435 +#: ../fish/guestfish-actions.pod:1518 ../src/guestfs-actions.pod:2451 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:1515 ../src/guestfs-actions.pod:2444 +#: ../fish/guestfish-actions.pod:1527 ../src/guestfs-actions.pod:2460 msgid "Multiple status codes can be summed together." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1519 ../src/guestfs-actions.pod:2448 +#: ../fish/guestfish-actions.pod:1531 ../src/guestfs-actions.pod:2464 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:1524 ../src/guestfs-actions.pod:2453 +#: ../fish/guestfish-actions.pod:1536 ../src/guestfs-actions.pod:2469 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1529 ../src/guestfs-actions.pod:2458 +#: ../fish/guestfish-actions.pod:1541 ../src/guestfs-actions.pod:2474 msgid "This command is entirely equivalent to running C<fsck -a -t fstype device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1531 +#: ../fish/guestfish-actions.pod:1543 msgid "get-append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1533 +#: ../fish/guestfish-actions.pod:1545 #, no-wrap msgid "" " get-append\n" @@ -9127,24 +9159,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1535 ../src/guestfs-actions.pod:2469 +#: ../fish/guestfish-actions.pod:1547 ../src/guestfs-actions.pod:2485 msgid "" "Return the additional kernel options which are added to the guest kernel " "command line." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1538 ../src/guestfs-actions.pod:2472 +#: ../fish/guestfish-actions.pod:1550 ../src/guestfs-actions.pod:2488 msgid "If C<NULL> then no options are added." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1540 +#: ../fish/guestfish-actions.pod:1552 msgid "get-attach-method" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1542 +#: ../fish/guestfish-actions.pod:1554 #, no-wrap msgid "" " get-attach-method\n" @@ -9152,17 +9184,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1544 +#: ../fish/guestfish-actions.pod:1556 msgid "Return the current attach method. See L</set-attach-method>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1546 +#: ../fish/guestfish-actions.pod:1558 msgid "get-autosync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1548 +#: ../fish/guestfish-actions.pod:1560 #, no-wrap msgid "" " get-autosync\n" @@ -9170,17 +9202,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1550 ../src/guestfs-actions.pod:2497 +#: ../fish/guestfish-actions.pod:1562 ../src/guestfs-actions.pod:2513 msgid "Get the autosync flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1552 +#: ../fish/guestfish-actions.pod:1564 msgid "get-direct" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1554 +#: ../fish/guestfish-actions.pod:1566 #, no-wrap msgid "" " get-direct\n" @@ -9188,17 +9220,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1556 ../src/guestfs-actions.pod:2508 +#: ../fish/guestfish-actions.pod:1568 ../src/guestfs-actions.pod:2524 msgid "Return the direct appliance mode flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1558 +#: ../fish/guestfish-actions.pod:1570 msgid "get-e2label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1560 +#: ../fish/guestfish-actions.pod:1572 #, no-wrap msgid "" " get-e2label device\n" @@ -9206,24 +9238,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1562 ../src/guestfs-actions.pod:2527 +#: ../fish/guestfish-actions.pod:1574 ../src/guestfs-actions.pod:2543 msgid "This returns the ext2/3/4 filesystem label of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1565 +#: ../fish/guestfish-actions.pod:1577 msgid "" "I<This function is deprecated.> In new code, use the L</vfs_label> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1572 +#: ../fish/guestfish-actions.pod:1584 msgid "get-e2uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1574 +#: ../fish/guestfish-actions.pod:1586 #, no-wrap msgid "" " get-e2uuid device\n" @@ -9231,24 +9263,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1576 ../src/guestfs-actions.pod:2548 +#: ../fish/guestfish-actions.pod:1588 ../src/guestfs-actions.pod:2564 msgid "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1579 +#: ../fish/guestfish-actions.pod:1591 msgid "" "I<This function is deprecated.> In new code, use the L</vfs_uuid> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1586 +#: ../fish/guestfish-actions.pod:1598 msgid "get-memsize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1588 +#: ../fish/guestfish-actions.pod:1600 #, no-wrap msgid "" " get-memsize\n" @@ -9256,12 +9288,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1590 ../src/guestfs-actions.pod:2561 +#: ../fish/guestfish-actions.pod:1602 ../src/guestfs-actions.pod:2577 msgid "This gets the memory size in megabytes allocated to the qemu subprocess." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1593 +#: ../fish/guestfish-actions.pod:1605 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 " @@ -9269,17 +9301,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1597 ../fish/guestfish-actions.pod:1654 ../fish/guestfish-actions.pod:4526 ../fish/guestfish-actions.pod:4630 ../src/guestfs-actions.pod:2568 ../src/guestfs-actions.pod:2660 ../src/guestfs-actions.pod:7030 ../src/guestfs-actions.pod:7158 +#: ../fish/guestfish-actions.pod:1609 ../fish/guestfish-actions.pod:1666 ../fish/guestfish-actions.pod:4558 ../fish/guestfish-actions.pod:4662 ../src/guestfs-actions.pod:2584 ../src/guestfs-actions.pod:2676 ../src/guestfs-actions.pod:7069 ../src/guestfs-actions.pod:7197 msgid "For more information on the architecture of libguestfs, see L<guestfs(3)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1600 +#: ../fish/guestfish-actions.pod:1612 msgid "get-network" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1602 +#: ../fish/guestfish-actions.pod:1614 #, no-wrap msgid "" " get-network\n" @@ -9287,17 +9319,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1604 ../src/guestfs-actions.pod:2580 +#: ../fish/guestfish-actions.pod:1616 ../src/guestfs-actions.pod:2596 msgid "This returns the enable network flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1606 +#: ../fish/guestfish-actions.pod:1618 msgid "get-path" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1608 +#: ../fish/guestfish-actions.pod:1620 #, no-wrap msgid "" " get-path\n" @@ -9305,24 +9337,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1610 ../src/guestfs-actions.pod:2591 +#: ../fish/guestfish-actions.pod:1622 ../src/guestfs-actions.pod:2607 msgid "Return the current search path." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1612 ../src/guestfs-actions.pod:2593 +#: ../fish/guestfish-actions.pod:1624 ../src/guestfs-actions.pod:2609 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:1615 +#: ../fish/guestfish-actions.pod:1627 msgid "get-pgroup" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1617 +#: ../fish/guestfish-actions.pod:1629 #, no-wrap msgid "" " get-pgroup\n" @@ -9330,22 +9362,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1619 ../src/guestfs-actions.pod:2606 +#: ../fish/guestfish-actions.pod:1631 ../src/guestfs-actions.pod:2622 msgid "This returns the process group flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1621 +#: ../fish/guestfish-actions.pod:1633 msgid "get-pid" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1623 +#: ../fish/guestfish-actions.pod:1635 msgid "pid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1625 +#: ../fish/guestfish-actions.pod:1637 #, no-wrap msgid "" " get-pid\n" @@ -9353,24 +9385,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1627 ../src/guestfs-actions.pod:2617 +#: ../fish/guestfish-actions.pod:1639 ../src/guestfs-actions.pod:2633 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:1630 ../src/guestfs-actions.pod:2620 +#: ../fish/guestfish-actions.pod:1642 ../src/guestfs-actions.pod:2636 msgid "This is an internal call used for debugging and testing." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1632 +#: ../fish/guestfish-actions.pod:1644 msgid "get-qemu" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1634 +#: ../fish/guestfish-actions.pod:1646 #, no-wrap msgid "" " get-qemu\n" @@ -9378,24 +9410,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1636 ../src/guestfs-actions.pod:2631 +#: ../fish/guestfish-actions.pod:1648 ../src/guestfs-actions.pod:2647 msgid "Return the current qemu binary." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1638 ../src/guestfs-actions.pod:2633 +#: ../fish/guestfish-actions.pod:1650 ../src/guestfs-actions.pod:2649 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:1641 +#: ../fish/guestfish-actions.pod:1653 msgid "get-recovery-proc" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1643 +#: ../fish/guestfish-actions.pod:1655 #, no-wrap msgid "" " get-recovery-proc\n" @@ -9403,17 +9435,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1645 ../src/guestfs-actions.pod:2646 +#: ../fish/guestfish-actions.pod:1657 ../src/guestfs-actions.pod:2662 msgid "Return the recovery process enabled flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1647 +#: ../fish/guestfish-actions.pod:1659 msgid "get-selinux" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1649 +#: ../fish/guestfish-actions.pod:1661 #, no-wrap msgid "" " get-selinux\n" @@ -9421,19 +9453,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1651 +#: ../fish/guestfish-actions.pod:1663 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:1657 +#: ../fish/guestfish-actions.pod:1669 msgid "get-smp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1659 +#: ../fish/guestfish-actions.pod:1671 #, no-wrap msgid "" " get-smp\n" @@ -9441,17 +9473,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1661 ../src/guestfs-actions.pod:2672 +#: ../fish/guestfish-actions.pod:1673 ../src/guestfs-actions.pod:2688 msgid "This returns the number of virtual CPUs assigned to the appliance." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1663 +#: ../fish/guestfish-actions.pod:1675 msgid "get-state" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1665 +#: ../fish/guestfish-actions.pod:1677 #, no-wrap msgid "" " get-state\n" @@ -9459,24 +9491,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1667 ../src/guestfs-actions.pod:2683 +#: ../fish/guestfish-actions.pod:1679 ../src/guestfs-actions.pod:2699 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:1670 ../fish/guestfish-actions.pod:2631 ../fish/guestfish-actions.pod:2649 ../fish/guestfish-actions.pod:2687 ../fish/guestfish-actions.pod:2703 ../src/guestfs-actions.pod:2686 ../src/guestfs-actions.pod:4007 ../src/guestfs-actions.pod:4036 ../src/guestfs-actions.pod:4097 ../src/guestfs-actions.pod:4124 +#: ../fish/guestfish-actions.pod:1682 ../fish/guestfish-actions.pod:2643 ../fish/guestfish-actions.pod:2661 ../fish/guestfish-actions.pod:2699 ../fish/guestfish-actions.pod:2715 ../src/guestfs-actions.pod:2702 ../src/guestfs-actions.pod:4023 ../src/guestfs-actions.pod:4052 ../src/guestfs-actions.pod:4113 ../src/guestfs-actions.pod:4140 msgid "For more information on states, see L<guestfs(3)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1672 +#: ../fish/guestfish-actions.pod:1684 msgid "get-trace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1674 +#: ../fish/guestfish-actions.pod:1686 #, no-wrap msgid "" " get-trace\n" @@ -9484,17 +9516,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1676 ../src/guestfs-actions.pod:2697 +#: ../fish/guestfish-actions.pod:1688 ../src/guestfs-actions.pod:2713 msgid "Return the command trace flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1678 +#: ../fish/guestfish-actions.pod:1690 msgid "get-umask" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1680 +#: ../fish/guestfish-actions.pod:1692 #, no-wrap msgid "" " get-umask\n" @@ -9502,19 +9534,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1682 +#: ../fish/guestfish-actions.pod:1694 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:1685 +#: ../fish/guestfish-actions.pod:1697 msgid "get-verbose" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1687 +#: ../fish/guestfish-actions.pod:1699 #, no-wrap msgid "" " get-verbose\n" @@ -9522,17 +9554,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1689 ../src/guestfs-actions.pod:2720 +#: ../fish/guestfish-actions.pod:1701 ../src/guestfs-actions.pod:2736 msgid "This returns the verbose messages flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1691 +#: ../fish/guestfish-actions.pod:1703 msgid "getcon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1693 +#: ../fish/guestfish-actions.pod:1705 #, no-wrap msgid "" " getcon\n" @@ -9540,22 +9572,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1695 ../src/guestfs-actions.pod:2731 +#: ../fish/guestfish-actions.pod:1707 ../src/guestfs-actions.pod:2747 msgid "This gets the SELinux security context of the daemon." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1697 +#: ../fish/guestfish-actions.pod:1709 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1700 +#: ../fish/guestfish-actions.pod:1712 msgid "getxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1702 +#: ../fish/guestfish-actions.pod:1714 #, no-wrap msgid "" " getxattr path name\n" @@ -9563,7 +9595,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1704 +#: ../fish/guestfish-actions.pod:1716 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 " @@ -9571,7 +9603,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1708 ../fish/guestfish-actions.pod:2776 +#: ../fish/guestfish-actions.pod:1720 ../fish/guestfish-actions.pod:2797 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 " @@ -9581,24 +9613,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1715 ../fish/guestfish-actions.pod:2783 ../src/guestfs-actions.pod:2760 ../src/guestfs-actions.pod:4257 +#: ../fish/guestfish-actions.pod:1727 ../fish/guestfish-actions.pod:2804 ../src/guestfs-actions.pod:2776 ../src/guestfs-actions.pod:4282 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:1718 +#: ../fish/guestfish-actions.pod:1730 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1720 +#: ../fish/guestfish-actions.pod:1732 msgid "getxattrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1722 +#: ../fish/guestfish-actions.pod:1734 #, no-wrap msgid "" " getxattrs path\n" @@ -9606,29 +9638,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1724 ../src/guestfs-actions.pod:2777 +#: ../fish/guestfish-actions.pod:1736 ../src/guestfs-actions.pod:2793 msgid "This call lists the extended attributes of the file or directory C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1727 ../src/guestfs-actions.pod:2780 +#: ../fish/guestfish-actions.pod:1739 ../src/guestfs-actions.pod:2796 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:1730 +#: ../fish/guestfish-actions.pod:1742 msgid "See also: L</lgetxattrs>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1732 +#: ../fish/guestfish-actions.pod:1744 msgid "glob-expand" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1734 +#: ../fish/guestfish-actions.pod:1746 #, no-wrap msgid "" " glob-expand pattern\n" @@ -9636,31 +9668,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1736 ../src/guestfs-actions.pod:2797 +#: ../fish/guestfish-actions.pod:1748 ../src/guestfs-actions.pod:2813 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:1740 ../src/guestfs-actions.pod:2801 +#: ../fish/guestfish-actions.pod:1752 ../src/guestfs-actions.pod:2817 msgid "If no paths match, then this returns an empty list (note: not an error)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1743 ../src/guestfs-actions.pod:2804 +#: ../fish/guestfish-actions.pod:1755 ../src/guestfs-actions.pod:2820 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:1747 +#: ../fish/guestfish-actions.pod:1759 msgid "grep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1749 +#: ../fish/guestfish-actions.pod:1761 #, no-wrap msgid "" " grep regex path\n" @@ -9668,17 +9700,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1751 ../src/guestfs-actions.pod:2821 +#: ../fish/guestfish-actions.pod:1763 ../src/guestfs-actions.pod:2837 msgid "This calls the external C<grep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1757 +#: ../fish/guestfish-actions.pod:1769 msgid "grepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1759 +#: ../fish/guestfish-actions.pod:1771 #, no-wrap msgid "" " grepi regex path\n" @@ -9686,17 +9718,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1761 ../src/guestfs-actions.pod:2840 +#: ../fish/guestfish-actions.pod:1773 ../src/guestfs-actions.pod:2856 msgid "This calls the external C<grep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1767 +#: ../fish/guestfish-actions.pod:1779 msgid "grub-install" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1769 +#: ../fish/guestfish-actions.pod:1781 #, no-wrap msgid "" " grub-install root device\n" @@ -9704,14 +9736,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1771 ../src/guestfs-actions.pod:2859 +#: ../fish/guestfish-actions.pod:1783 ../src/guestfs-actions.pod:2875 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:1780 ../src/guestfs-actions.pod:2868 +#: ../fish/guestfish-actions.pod:1792 ../src/guestfs-actions.pod:2884 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 " @@ -9719,7 +9751,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1787 ../src/guestfs-actions.pod:2875 +#: ../fish/guestfish-actions.pod:1799 ../src/guestfs-actions.pod:2891 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. " @@ -9727,7 +9759,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1794 ../src/guestfs-actions.pod:2882 +#: ../fish/guestfish-actions.pod:1806 ../src/guestfs-actions.pod:2898 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 " @@ -9737,7 +9769,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1801 ../src/guestfs-actions.pod:2889 +#: ../fish/guestfish-actions.pod:1813 ../src/guestfs-actions.pod:2905 #, no-wrap msgid "" " (hd0) /dev/vda\n" @@ -9745,17 +9777,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1803 ../src/guestfs-actions.pod:2891 +#: ../fish/guestfish-actions.pod:1815 ../src/guestfs-actions.pod:2907 msgid "replacing C</dev/vda> with the name of the installation device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1807 +#: ../fish/guestfish-actions.pod:1819 msgid "head" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1809 +#: ../fish/guestfish-actions.pod:1821 #, no-wrap msgid "" " head path\n" @@ -9763,19 +9795,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1811 ../src/guestfs-actions.pod:2905 +#: ../fish/guestfish-actions.pod:1823 ../src/guestfs-actions.pod:2921 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:1817 +#: ../fish/guestfish-actions.pod:1829 msgid "head-n" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1819 +#: ../fish/guestfish-actions.pod:1831 #, no-wrap msgid "" " head-n nrlines path\n" @@ -9783,31 +9815,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1821 ../src/guestfs-actions.pod:2924 +#: ../fish/guestfish-actions.pod:1833 ../src/guestfs-actions.pod:2940 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:1824 ../src/guestfs-actions.pod:2927 +#: ../fish/guestfish-actions.pod:1836 ../src/guestfs-actions.pod:2943 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:1827 ../fish/guestfish-actions.pod:5011 ../src/guestfs-actions.pod:2930 ../src/guestfs-actions.pod:7737 +#: ../fish/guestfish-actions.pod:1839 ../fish/guestfish-actions.pod:5063 ../src/guestfs-actions.pod:2946 ../src/guestfs-actions.pod:7799 msgid "If the parameter C<nrlines> is zero, this returns an empty list." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1832 +#: ../fish/guestfish-actions.pod:1844 msgid "hexdump" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1834 +#: ../fish/guestfish-actions.pod:1846 #, no-wrap msgid "" " hexdump path\n" @@ -9815,19 +9847,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1836 ../src/guestfs-actions.pod:2947 +#: ../fish/guestfish-actions.pod:1848 ../src/guestfs-actions.pod:2963 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:1842 +#: ../fish/guestfish-actions.pod:1854 msgid "initrd-cat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1844 +#: ../fish/guestfish-actions.pod:1856 #, no-wrap msgid "" " initrd-cat initrdpath filename\n" @@ -9835,7 +9867,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1846 ../src/guestfs-actions.pod:2966 +#: ../fish/guestfish-actions.pod:1858 ../src/guestfs-actions.pod:2982 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</> " @@ -9843,7 +9875,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1850 ../src/guestfs-actions.pod:2970 +#: ../fish/guestfish-actions.pod:1862 ../src/guestfs-actions.pod:2986 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 " @@ -9851,7 +9883,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1854 ../src/guestfs-actions.pod:2974 +#: ../fish/guestfish-actions.pod:1866 ../src/guestfs-actions.pod:2990 #, no-wrap msgid "" " initrd-cat /boot/initrd-<version>.img init\n" @@ -9859,17 +9891,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1856 +#: ../fish/guestfish-actions.pod:1868 msgid "See also L</initrd-list>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1861 +#: ../fish/guestfish-actions.pod:1873 msgid "initrd-list" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1863 +#: ../fish/guestfish-actions.pod:1875 #, no-wrap msgid "" " initrd-list path\n" @@ -9877,12 +9909,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1865 ../src/guestfs-actions.pod:2993 +#: ../fish/guestfish-actions.pod:1877 ../src/guestfs-actions.pod:3009 msgid "This command lists out files contained in an initrd." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1867 ../src/guestfs-actions.pod:2995 +#: ../fish/guestfish-actions.pod:1879 ../src/guestfs-actions.pod:3011 msgid "" "The files are listed without any initial C</> character. The files are " "listed in the order they appear (not necessarily alphabetical). Directory " @@ -9890,7 +9922,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1871 ../src/guestfs-actions.pod:2999 +#: ../fish/guestfish-actions.pod:1883 ../src/guestfs-actions.pod:3015 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 " @@ -9898,12 +9930,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1875 +#: ../fish/guestfish-actions.pod:1887 msgid "inotify-add-watch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1877 +#: ../fish/guestfish-actions.pod:1889 #, no-wrap msgid "" " inotify-add-watch path mask\n" @@ -9911,31 +9943,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1879 ../src/guestfs-actions.pod:3016 +#: ../fish/guestfish-actions.pod:1891 ../src/guestfs-actions.pod:3032 msgid "Watch C<path> for the events listed in C<mask>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1881 ../src/guestfs-actions.pod:3018 +#: ../fish/guestfish-actions.pod:1893 ../src/guestfs-actions.pod:3034 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:1885 ../src/guestfs-actions.pod:3022 +#: ../fish/guestfish-actions.pod:1897 ../src/guestfs-actions.pod:3038 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:1889 +#: ../fish/guestfish-actions.pod:1901 msgid "inotify-close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1891 +#: ../fish/guestfish-actions.pod:1903 #, no-wrap msgid "" " inotify-close\n" @@ -9943,7 +9975,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1893 ../src/guestfs-actions.pod:3035 +#: ../fish/guestfish-actions.pod:1905 ../src/guestfs-actions.pod:3051 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 " @@ -9951,12 +9983,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1897 +#: ../fish/guestfish-actions.pod:1909 msgid "inotify-files" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1899 +#: ../fish/guestfish-actions.pod:1911 #, no-wrap msgid "" " inotify-files\n" @@ -9964,7 +9996,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1901 +#: ../fish/guestfish-actions.pod:1913 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 " @@ -9972,12 +10004,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1905 +#: ../fish/guestfish-actions.pod:1917 msgid "inotify-init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1907 +#: ../fish/guestfish-actions.pod:1919 #, no-wrap msgid "" " inotify-init maxevents\n" @@ -9985,14 +10017,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1909 ../src/guestfs-actions.pod:3064 +#: ../fish/guestfish-actions.pod:1921 ../src/guestfs-actions.pod:3080 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:1913 +#: ../fish/guestfish-actions.pod:1925 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>, " @@ -10003,14 +10035,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1923 +#: ../fish/guestfish-actions.pod:1935 msgid "" "Before any events are generated, you have to add some watches to the " "internal watch list. See: L</inotify-add-watch> and L</inotify-rm-watch>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1927 +#: ../fish/guestfish-actions.pod:1939 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>). " @@ -10019,14 +10051,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1934 +#: ../fish/guestfish-actions.pod:1946 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:1938 ../src/guestfs-actions.pod:3093 +#: ../fish/guestfish-actions.pod:1950 ../src/guestfs-actions.pod:3109 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 " @@ -10034,12 +10066,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1943 +#: ../fish/guestfish-actions.pod:1955 msgid "inotify-read" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1945 +#: ../fish/guestfish-actions.pod:1957 #, no-wrap msgid "" " inotify-read\n" @@ -10047,19 +10079,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1947 ../src/guestfs-actions.pod:3107 +#: ../fish/guestfish-actions.pod:1959 ../src/guestfs-actions.pod:3123 msgid "" "Return the complete queue of events that have happened since the previous " "read call." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1950 ../src/guestfs-actions.pod:3110 +#: ../fish/guestfish-actions.pod:1962 ../src/guestfs-actions.pod:3126 msgid "If no events have happened, this returns an empty list." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1952 ../src/guestfs-actions.pod:3112 +#: ../fish/guestfish-actions.pod:1964 ../src/guestfs-actions.pod:3128 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 " @@ -10068,12 +10100,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1958 +#: ../fish/guestfish-actions.pod:1970 msgid "inotify-rm-watch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1960 +#: ../fish/guestfish-actions.pod:1972 #, no-wrap msgid "" " inotify-rm-watch wd\n" @@ -10081,17 +10113,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1962 +#: ../fish/guestfish-actions.pod:1974 msgid "Remove a previously defined inotify watch. See L</inotify-add-watch>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1965 +#: ../fish/guestfish-actions.pod:1977 msgid "inspect-get-arch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1967 +#: ../fish/guestfish-actions.pod:1979 #, no-wrap msgid "" " inspect-get-arch root\n" @@ -10099,31 +10131,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1969 +#: ../fish/guestfish-actions.pod:1981 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:1973 ../src/guestfs-actions.pod:3147 +#: ../fish/guestfish-actions.pod:1985 ../src/guestfs-actions.pod:3163 msgid "" "If the architecture could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1976 ../fish/guestfish-actions.pod:2071 ../fish/guestfish-actions.pod:2150 ../fish/guestfish-actions.pod:2162 ../fish/guestfish-actions.pod:2246 ../fish/guestfish-actions.pod:2308 ../fish/guestfish-actions.pod:2329 ../fish/guestfish-actions.pod:2343 ../fish/guestfish-actions.pod:2383 ../fish/guestfish-actions.pod:2423 ../fish/guestfish-actions.pod:2436 ../fish/guestfish-actions.pod:2449 ../fish/guestfish-actions.pod:2459 ../fish/guestfish-actions.pod:2469 ../fish/guestfish-actions.pod:2481 ../fish/guestfish-actions.pod:2577 ../fish/guestfish-actions.pod:2611 ../src/guestfs-actions.pod:3150 ../src/guestfs-actions.pod:3252 ../src/guestfs-actions.pod:3356 ../src/guestfs-actions.pod:3375 ../src/guestfs-actions.pod:3506 ../src/guestfs-actions.pod:3590 ../src/guestfs-actions.pod:3618 ../src/guestfs-actions.pod:3639 ../src/guestfs-actions.pod:3692 ../src/guestfs-actions.pod:3740 ../src/guestfs-actions.pod:3760 ../src/guestfs-actions.pod:3780 ../src/guestfs-actions.pod:3797 ../src/guestfs-actions.pod:3813 ../src/guestfs-actions.pod:3831 ../src/guestfs-actions.pod:3933 ../src/guestfs-actions.pod:3974 +#: ../fish/guestfish-actions.pod:1988 ../fish/guestfish-actions.pod:2083 ../fish/guestfish-actions.pod:2162 ../fish/guestfish-actions.pod:2174 ../fish/guestfish-actions.pod:2258 ../fish/guestfish-actions.pod:2320 ../fish/guestfish-actions.pod:2341 ../fish/guestfish-actions.pod:2355 ../fish/guestfish-actions.pod:2395 ../fish/guestfish-actions.pod:2435 ../fish/guestfish-actions.pod:2448 ../fish/guestfish-actions.pod:2461 ../fish/guestfish-actions.pod:2471 ../fish/guestfish-actions.pod:2481 ../fish/guestfish-actions.pod:2493 ../fish/guestfish-actions.pod:2589 ../fish/guestfish-actions.pod:2623 ../src/guestfs-actions.pod:3166 ../src/guestfs-actions.pod:3268 ../src/guestfs-actions.pod:3372 ../src/guestfs-actions.pod:3391 ../src/guestfs-actions.pod:3522 ../src/guestfs-actions.pod:3606 ../src/guestfs-actions.pod:3634 ../src/guestfs-actions.pod:3655 ../src/guestfs-actions.pod:3708 ../src/guestfs-actions.pod:3756 ../src/guestfs-actions.pod:3776 ../src/guestfs-actions.pod:3796 ../src/guestfs-actions.pod:3813 ../src/guestfs-actions.pod:3829 ../src/guestfs-actions.pod:3847 ../src/guestfs-actions.pod:3949 ../src/guestfs-actions.pod:3990 msgid "Please read L<guestfs(3)/INSPECTION> for more details." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1978 +#: ../fish/guestfish-actions.pod:1990 msgid "inspect-get-distro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1980 +#: ../fish/guestfish-actions.pod:1992 #, no-wrap msgid "" " inspect-get-distro root\n" @@ -10131,221 +10163,221 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1982 ../src/guestfs-actions.pod:3163 +#: ../fish/guestfish-actions.pod:1994 ../src/guestfs-actions.pod:3179 msgid "This returns the distro (distribution) of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1985 ../src/guestfs-actions.pod:3166 +#: ../fish/guestfish-actions.pod:1997 ../src/guestfs-actions.pod:3182 msgid "Currently defined distros are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1989 ../src/guestfs-actions.pod:3170 +#: ../fish/guestfish-actions.pod:2001 ../src/guestfs-actions.pod:3186 msgid "\"archlinux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1991 ../src/guestfs-actions.pod:3172 +#: ../fish/guestfish-actions.pod:2003 ../src/guestfs-actions.pod:3188 msgid "Arch Linux." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1993 ../src/guestfs-actions.pod:3174 +#: ../fish/guestfish-actions.pod:2005 ../src/guestfs-actions.pod:3190 msgid "\"centos\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1995 ../src/guestfs-actions.pod:3176 +#: ../fish/guestfish-actions.pod:2007 ../src/guestfs-actions.pod:3192 msgid "CentOS." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1997 ../src/guestfs-actions.pod:3178 +#: ../fish/guestfish-actions.pod:2009 ../src/guestfs-actions.pod:3194 msgid "\"debian\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1999 ../src/guestfs-actions.pod:3180 +#: ../fish/guestfish-actions.pod:2011 ../src/guestfs-actions.pod:3196 msgid "Debian." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2001 ../src/guestfs-actions.pod:3182 +#: ../fish/guestfish-actions.pod:2013 ../src/guestfs-actions.pod:3198 msgid "\"fedora\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2003 ../src/guestfs-actions.pod:3184 +#: ../fish/guestfish-actions.pod:2015 ../src/guestfs-actions.pod:3200 msgid "Fedora." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2005 ../src/guestfs-actions.pod:3186 +#: ../fish/guestfish-actions.pod:2017 ../src/guestfs-actions.pod:3202 msgid "\"gentoo\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2007 ../src/guestfs-actions.pod:3188 +#: ../fish/guestfish-actions.pod:2019 ../src/guestfs-actions.pod:3204 msgid "Gentoo." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2009 ../src/guestfs-actions.pod:3190 +#: ../fish/guestfish-actions.pod:2021 ../src/guestfs-actions.pod:3206 msgid "\"linuxmint\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2011 ../src/guestfs-actions.pod:3192 +#: ../fish/guestfish-actions.pod:2023 ../src/guestfs-actions.pod:3208 msgid "Linux Mint." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2013 ../src/guestfs-actions.pod:3194 +#: ../fish/guestfish-actions.pod:2025 ../src/guestfs-actions.pod:3210 msgid "\"mageia\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2015 ../src/guestfs-actions.pod:3196 +#: ../fish/guestfish-actions.pod:2027 ../src/guestfs-actions.pod:3212 msgid "Mageia." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2017 ../src/guestfs-actions.pod:3198 +#: ../fish/guestfish-actions.pod:2029 ../src/guestfs-actions.pod:3214 msgid "\"mandriva\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2019 ../src/guestfs-actions.pod:3200 +#: ../fish/guestfish-actions.pod:2031 ../src/guestfs-actions.pod:3216 msgid "Mandriva." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2021 ../src/guestfs-actions.pod:3202 +#: ../fish/guestfish-actions.pod:2033 ../src/guestfs-actions.pod:3218 msgid "\"meego\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2023 ../src/guestfs-actions.pod:3204 +#: ../fish/guestfish-actions.pod:2035 ../src/guestfs-actions.pod:3220 msgid "MeeGo." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2025 ../src/guestfs-actions.pod:3206 +#: ../fish/guestfish-actions.pod:2037 ../src/guestfs-actions.pod:3222 msgid "\"opensuse\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2027 ../src/guestfs-actions.pod:3208 +#: ../fish/guestfish-actions.pod:2039 ../src/guestfs-actions.pod:3224 msgid "OpenSUSE." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2029 ../src/guestfs-actions.pod:3210 +#: ../fish/guestfish-actions.pod:2041 ../src/guestfs-actions.pod:3226 msgid "\"pardus\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2031 ../src/guestfs-actions.pod:3212 +#: ../fish/guestfish-actions.pod:2043 ../src/guestfs-actions.pod:3228 msgid "Pardus." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2033 ../src/guestfs-actions.pod:3214 +#: ../fish/guestfish-actions.pod:2045 ../src/guestfs-actions.pod:3230 msgid "\"redhat-based\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2035 ../src/guestfs-actions.pod:3216 +#: ../fish/guestfish-actions.pod:2047 ../src/guestfs-actions.pod:3232 msgid "Some Red Hat-derived distro." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2037 ../src/guestfs-actions.pod:3218 +#: ../fish/guestfish-actions.pod:2049 ../src/guestfs-actions.pod:3234 msgid "\"rhel\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2039 ../src/guestfs-actions.pod:3220 +#: ../fish/guestfish-actions.pod:2051 ../src/guestfs-actions.pod:3236 msgid "Red Hat Enterprise Linux." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2041 ../src/guestfs-actions.pod:3222 +#: ../fish/guestfish-actions.pod:2053 ../src/guestfs-actions.pod:3238 msgid "\"scientificlinux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2043 ../src/guestfs-actions.pod:3224 +#: ../fish/guestfish-actions.pod:2055 ../src/guestfs-actions.pod:3240 msgid "Scientific Linux." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2045 ../src/guestfs-actions.pod:3226 +#: ../fish/guestfish-actions.pod:2057 ../src/guestfs-actions.pod:3242 msgid "\"slackware\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2047 ../src/guestfs-actions.pod:3228 +#: ../fish/guestfish-actions.pod:2059 ../src/guestfs-actions.pod:3244 msgid "Slackware." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2049 ../src/guestfs-actions.pod:3230 +#: ../fish/guestfish-actions.pod:2061 ../src/guestfs-actions.pod:3246 msgid "\"ttylinux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2051 ../src/guestfs-actions.pod:3232 +#: ../fish/guestfish-actions.pod:2063 ../src/guestfs-actions.pod:3248 msgid "ttylinux." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2053 ../src/guestfs-actions.pod:3234 +#: ../fish/guestfish-actions.pod:2065 ../src/guestfs-actions.pod:3250 msgid "\"ubuntu\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2055 ../src/guestfs-actions.pod:3236 +#: ../fish/guestfish-actions.pod:2067 ../src/guestfs-actions.pod:3252 msgid "Ubuntu." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2057 ../fish/guestfish-actions.pod:2141 ../fish/guestfish-actions.pod:2414 ../src/guestfs-actions.pod:3238 ../src/guestfs-actions.pod:3347 ../src/guestfs-actions.pod:3731 +#: ../fish/guestfish-actions.pod:2069 ../fish/guestfish-actions.pod:2153 ../fish/guestfish-actions.pod:2426 ../src/guestfs-actions.pod:3254 ../src/guestfs-actions.pod:3363 ../src/guestfs-actions.pod:3747 msgid "\"unknown\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2059 ../src/guestfs-actions.pod:3240 +#: ../fish/guestfish-actions.pod:2071 ../src/guestfs-actions.pod:3256 msgid "The distro could not be determined." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2061 ../fish/guestfish-actions.pod:2398 ../src/guestfs-actions.pod:3242 ../src/guestfs-actions.pod:3715 +#: ../fish/guestfish-actions.pod:2073 ../fish/guestfish-actions.pod:2410 ../src/guestfs-actions.pod:3258 ../src/guestfs-actions.pod:3731 msgid "\"windows\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2063 ../src/guestfs-actions.pod:3244 +#: ../fish/guestfish-actions.pod:2075 ../src/guestfs-actions.pod:3260 msgid "" "Windows does not have distributions. This string is returned if the OS type " "is Windows." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2068 ../fish/guestfish-actions.pod:2147 ../fish/guestfish-actions.pod:2420 ../src/guestfs-actions.pod:3249 ../src/guestfs-actions.pod:3353 ../src/guestfs-actions.pod:3737 +#: ../fish/guestfish-actions.pod:2080 ../fish/guestfish-actions.pod:2159 ../fish/guestfish-actions.pod:2432 ../src/guestfs-actions.pod:3265 ../src/guestfs-actions.pod:3369 ../src/guestfs-actions.pod:3753 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:2073 +#: ../fish/guestfish-actions.pod:2085 msgid "inspect-get-drive-mappings" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2075 +#: ../fish/guestfish-actions.pod:2087 #, no-wrap msgid "" " inspect-get-drive-mappings root\n" @@ -10353,7 +10385,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2077 ../src/guestfs-actions.pod:3265 +#: ../fish/guestfish-actions.pod:2089 ../src/guestfs-actions.pod:3281 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 " @@ -10362,7 +10394,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2083 ../src/guestfs-actions.pod:3271 +#: ../fish/guestfish-actions.pod:2095 ../src/guestfs-actions.pod:3287 #, no-wrap msgid "" " C => /dev/vda2\n" @@ -10372,7 +10404,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2087 ../src/guestfs-actions.pod:3275 +#: ../fish/guestfish-actions.pod:2099 ../src/guestfs-actions.pod:3291 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 " @@ -10380,7 +10412,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2091 ../src/guestfs-actions.pod:3279 +#: ../fish/guestfish-actions.pod:2103 ../src/guestfs-actions.pod:3295 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 " @@ -10389,33 +10421,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2096 ../src/guestfs-actions.pod:3284 +#: ../fish/guestfish-actions.pod:2108 ../src/guestfs-actions.pod:3300 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:2099 ../src/guestfs-actions.pod:3287 +#: ../fish/guestfish-actions.pod:2111 ../src/guestfs-actions.pod:3303 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:2102 +#: ../fish/guestfish-actions.pod:2114 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:2106 +#: ../fish/guestfish-actions.pod:2118 msgid "inspect-get-filesystems" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2108 +#: ../fish/guestfish-actions.pod:2120 #, no-wrap msgid "" " inspect-get-filesystems root\n" @@ -10423,7 +10455,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2110 ../src/guestfs-actions.pod:3308 +#: ../fish/guestfish-actions.pod:2122 ../src/guestfs-actions.pod:3324 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 " @@ -10431,26 +10463,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2115 ../src/guestfs-actions.pod:3313 +#: ../fish/guestfish-actions.pod:2127 ../src/guestfs-actions.pod:3329 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:2118 +#: ../fish/guestfish-actions.pod:2130 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-mountpoints>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2121 +#: ../fish/guestfish-actions.pod:2133 msgid "inspect-get-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2123 +#: ../fish/guestfish-actions.pod:2135 #, no-wrap msgid "" " inspect-get-format root\n" @@ -10458,51 +10490,51 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2125 ../src/guestfs-actions.pod:3331 +#: ../fish/guestfish-actions.pod:2137 ../src/guestfs-actions.pod:3347 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:2128 ../src/guestfs-actions.pod:3334 +#: ../fish/guestfish-actions.pod:2140 ../src/guestfs-actions.pod:3350 msgid "Currently defined formats are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2132 ../src/guestfs-actions.pod:3338 +#: ../fish/guestfish-actions.pod:2144 ../src/guestfs-actions.pod:3354 msgid "\"installed\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2134 ../src/guestfs-actions.pod:3340 +#: ../fish/guestfish-actions.pod:2146 ../src/guestfs-actions.pod:3356 msgid "This is an installed operating system." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2136 ../src/guestfs-actions.pod:3342 +#: ../fish/guestfish-actions.pod:2148 ../src/guestfs-actions.pod:3358 msgid "\"installer\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2138 ../src/guestfs-actions.pod:3344 +#: ../fish/guestfish-actions.pod:2150 ../src/guestfs-actions.pod:3360 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:2143 ../src/guestfs-actions.pod:3349 +#: ../fish/guestfish-actions.pod:2155 ../src/guestfs-actions.pod:3365 msgid "The format of this disk image is not known." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2152 +#: ../fish/guestfish-actions.pod:2164 msgid "inspect-get-hostname" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2154 +#: ../fish/guestfish-actions.pod:2166 #, no-wrap msgid "" " inspect-get-hostname root\n" @@ -10510,26 +10542,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2156 ../src/guestfs-actions.pod:3369 +#: ../fish/guestfish-actions.pod:2168 ../src/guestfs-actions.pod:3385 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:2159 ../src/guestfs-actions.pod:3372 +#: ../fish/guestfish-actions.pod:2171 ../src/guestfs-actions.pod:3388 msgid "" "If the hostname could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2164 +#: ../fish/guestfish-actions.pod:2176 msgid "inspect-get-icon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2166 +#: ../fish/guestfish-actions.pod:2178 #, no-wrap msgid "" " inspect-get-icon root [favicon:true|false] [highquality:true|false]\n" @@ -10537,7 +10569,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2168 ../src/guestfs-actions.pod:3398 +#: ../fish/guestfish-actions.pod:2180 ../src/guestfs-actions.pod:3414 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 " @@ -10545,14 +10577,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2172 ../src/guestfs-actions.pod:3402 +#: ../fish/guestfish-actions.pod:2184 ../src/guestfs-actions.pod:3418 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:2175 ../src/guestfs-actions.pod:3405 +#: ../fish/guestfish-actions.pod:2187 ../src/guestfs-actions.pod:3421 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 " @@ -10561,14 +10593,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2181 ../src/guestfs-actions.pod:3411 +#: ../fish/guestfish-actions.pod:2193 ../src/guestfs-actions.pod:3427 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:2184 ../src/guestfs-actions.pod:3414 +#: ../fish/guestfish-actions.pod:2196 ../src/guestfs-actions.pod:3430 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 " @@ -10577,7 +10609,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2195 ../src/guestfs-actions.pod:3425 +#: ../fish/guestfish-actions.pod:2207 ../src/guestfs-actions.pod:3441 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 " @@ -10585,7 +10617,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2201 ../src/guestfs-actions.pod:3431 +#: ../fish/guestfish-actions.pod:2213 ../src/guestfs-actions.pod:3447 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. " @@ -10594,7 +10626,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2209 ../src/guestfs-actions.pod:3439 +#: ../fish/guestfish-actions.pod:2221 ../src/guestfs-actions.pod:3455 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 " @@ -10602,7 +10634,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2216 ../src/guestfs-actions.pod:3446 +#: ../fish/guestfish-actions.pod:2228 ../src/guestfs-actions.pod:3462 msgid "" "Extracting icons from Windows guests requires the external C<wrestool> " "program from the C<icoutils> package, and several programs (C<bmptopnm>, " @@ -10611,19 +10643,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2223 ../src/guestfs-actions.pod:3453 +#: ../fish/guestfish-actions.pod:2235 ../src/guestfs-actions.pod:3469 msgid "" "Operating system icons are usually trademarks. Seek legal advice before " "using trademarks in applications." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2230 +#: ../fish/guestfish-actions.pod:2242 msgid "inspect-get-major-version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2232 +#: ../fish/guestfish-actions.pod:2244 #, no-wrap msgid "" " inspect-get-major-version root\n" @@ -10631,12 +10663,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2234 ../src/guestfs-actions.pod:3494 +#: ../fish/guestfish-actions.pod:2246 ../src/guestfs-actions.pod:3510 msgid "This returns the major version number of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2237 ../src/guestfs-actions.pod:3497 +#: ../fish/guestfish-actions.pod:2249 ../src/guestfs-actions.pod:3513 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 " @@ -10646,17 +10678,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2244 ../fish/guestfish-actions.pod:2255 ../src/guestfs-actions.pod:3504 ../src/guestfs-actions.pod:3521 +#: ../fish/guestfish-actions.pod:2256 ../fish/guestfish-actions.pod:2267 ../src/guestfs-actions.pod:3520 ../src/guestfs-actions.pod:3537 msgid "If the version could not be determined, then C<0> is returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2248 +#: ../fish/guestfish-actions.pod:2260 msgid "inspect-get-minor-version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2250 +#: ../fish/guestfish-actions.pod:2262 #, no-wrap msgid "" " inspect-get-minor-version root\n" @@ -10664,24 +10696,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2252 ../src/guestfs-actions.pod:3518 +#: ../fish/guestfish-actions.pod:2264 ../src/guestfs-actions.pod:3534 msgid "This returns the minor version number of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2257 +#: ../fish/guestfish-actions.pod:2269 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-major-version>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2260 +#: ../fish/guestfish-actions.pod:2272 msgid "inspect-get-mountpoints" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2262 +#: ../fish/guestfish-actions.pod:2274 #, no-wrap msgid "" " inspect-get-mountpoints root\n" @@ -10689,7 +10721,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2264 ../src/guestfs-actions.pod:3536 +#: ../fish/guestfish-actions.pod:2276 ../src/guestfs-actions.pod:3552 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 " @@ -10700,7 +10732,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2273 ../src/guestfs-actions.pod:3545 +#: ../fish/guestfish-actions.pod:2285 ../src/guestfs-actions.pod:3561 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 " @@ -10708,12 +10740,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2278 ../src/guestfs-actions.pod:3550 +#: ../fish/guestfish-actions.pod:2290 ../src/guestfs-actions.pod:3566 msgid "Non-mounted devices such as swap devices are I<not> returned in this list." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2281 +#: ../fish/guestfish-actions.pod:2293 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 " @@ -10722,19 +10754,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2287 +#: ../fish/guestfish-actions.pod:2299 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2290 +#: ../fish/guestfish-actions.pod:2302 msgid "inspect-get-package-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2292 +#: ../fish/guestfish-actions.pod:2304 #, no-wrap msgid "" " inspect-get-package-format root\n" @@ -10742,7 +10774,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2294 +#: ../fish/guestfish-actions.pod:2306 msgid "" "This function and L</inspect-get-package-management> return the package " "format and package management tool used by the inspected operating system. " @@ -10751,7 +10783,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2300 ../src/guestfs-actions.pod:3582 +#: ../fish/guestfish-actions.pod:2312 ../src/guestfs-actions.pod:3598 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 " @@ -10759,19 +10791,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2304 ../src/guestfs-actions.pod:3586 +#: ../fish/guestfish-actions.pod:2316 ../src/guestfs-actions.pod:3602 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:2310 +#: ../fish/guestfish-actions.pod:2322 msgid "inspect-get-package-management" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2312 +#: ../fish/guestfish-actions.pod:2324 #, no-wrap msgid "" " inspect-get-package-management root\n" @@ -10779,7 +10811,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2314 +#: ../fish/guestfish-actions.pod:2326 msgid "" "L</inspect-get-package-format> and this function return the package format " "and package management tool used by the inspected operating system. For " @@ -10788,7 +10820,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2320 ../src/guestfs-actions.pod:3609 +#: ../fish/guestfish-actions.pod:2332 ../src/guestfs-actions.pod:3625 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 " @@ -10796,7 +10828,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2324 ../src/guestfs-actions.pod:3613 +#: ../fish/guestfish-actions.pod:2336 ../src/guestfs-actions.pod:3629 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 " @@ -10804,12 +10836,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2331 +#: ../fish/guestfish-actions.pod:2343 msgid "inspect-get-product-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2333 +#: ../fish/guestfish-actions.pod:2345 #, no-wrap msgid "" " inspect-get-product-name root\n" @@ -10817,7 +10849,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2335 ../src/guestfs-actions.pod:3631 +#: ../fish/guestfish-actions.pod:2347 ../src/guestfs-actions.pod:3647 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 " @@ -10825,19 +10857,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2340 ../src/guestfs-actions.pod:3636 +#: ../fish/guestfish-actions.pod:2352 ../src/guestfs-actions.pod:3652 msgid "" "If the product name could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2345 +#: ../fish/guestfish-actions.pod:2357 msgid "inspect-get-product-variant" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2347 +#: ../fish/guestfish-actions.pod:2359 #, no-wrap msgid "" " inspect-get-product-variant root\n" @@ -10845,12 +10877,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2349 ../src/guestfs-actions.pod:3652 +#: ../fish/guestfish-actions.pod:2361 ../src/guestfs-actions.pod:3668 msgid "This returns the product variant of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2352 ../src/guestfs-actions.pod:3655 +#: ../fish/guestfish-actions.pod:2364 ../src/guestfs-actions.pod:3671 msgid "" "For Windows guests, this returns the contents of the Registry key " "C<HKLM\\Software\\Microsoft\\Windows NT\\CurrentVersion> C<InstallationType> " @@ -10862,7 +10894,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2361 ../src/guestfs-actions.pod:3664 +#: ../fish/guestfish-actions.pod:2373 ../src/guestfs-actions.pod:3680 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 " @@ -10870,26 +10902,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2365 ../src/guestfs-actions.pod:3668 +#: ../fish/guestfish-actions.pod:2377 ../src/guestfs-actions.pod:3684 msgid "" "If the product variant could not be determined, then the string C<unknown> " "is returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2368 +#: ../fish/guestfish-actions.pod:2380 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:2372 +#: ../fish/guestfish-actions.pod:2384 msgid "inspect-get-roots" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2374 +#: ../fish/guestfish-actions.pod:2386 #, no-wrap msgid "" " inspect-get-roots\n" @@ -10897,7 +10929,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2376 +#: ../fish/guestfish-actions.pod:2388 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 " @@ -10905,19 +10937,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2380 +#: ../fish/guestfish-actions.pod:2392 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:2385 +#: ../fish/guestfish-actions.pod:2397 msgid "inspect-get-type" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2387 +#: ../fish/guestfish-actions.pod:2399 #, no-wrap msgid "" " inspect-get-type root\n" @@ -10925,69 +10957,69 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2389 ../src/guestfs-actions.pod:3706 +#: ../fish/guestfish-actions.pod:2401 ../src/guestfs-actions.pod:3722 msgid "" "This returns the type of the inspected operating system. Currently defined " "types are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2394 ../src/guestfs-actions.pod:3711 +#: ../fish/guestfish-actions.pod:2406 ../src/guestfs-actions.pod:3727 msgid "\"linux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2396 ../src/guestfs-actions.pod:3713 +#: ../fish/guestfish-actions.pod:2408 ../src/guestfs-actions.pod:3729 msgid "Any Linux-based operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2400 ../src/guestfs-actions.pod:3717 +#: ../fish/guestfish-actions.pod:2412 ../src/guestfs-actions.pod:3733 msgid "Any Microsoft Windows operating system." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2402 ../src/guestfs-actions.pod:3719 +#: ../fish/guestfish-actions.pod:2414 ../src/guestfs-actions.pod:3735 msgid "\"freebsd\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2404 ../src/guestfs-actions.pod:3721 +#: ../fish/guestfish-actions.pod:2416 ../src/guestfs-actions.pod:3737 msgid "FreeBSD." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2406 ../src/guestfs-actions.pod:3723 +#: ../fish/guestfish-actions.pod:2418 ../src/guestfs-actions.pod:3739 msgid "\"netbsd\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2408 ../src/guestfs-actions.pod:3725 +#: ../fish/guestfish-actions.pod:2420 ../src/guestfs-actions.pod:3741 msgid "NetBSD." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2410 ../src/guestfs-actions.pod:3727 +#: ../fish/guestfish-actions.pod:2422 ../src/guestfs-actions.pod:3743 msgid "\"hurd\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2412 ../src/guestfs-actions.pod:3729 +#: ../fish/guestfish-actions.pod:2424 ../src/guestfs-actions.pod:3745 msgid "GNU/Hurd." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2416 ../src/guestfs-actions.pod:3733 +#: ../fish/guestfish-actions.pod:2428 ../src/guestfs-actions.pod:3749 msgid "The operating system type could not be determined." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2425 +#: ../fish/guestfish-actions.pod:2437 msgid "inspect-get-windows-current-control-set" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2427 +#: ../fish/guestfish-actions.pod:2439 #, no-wrap msgid "" " inspect-get-windows-current-control-set root\n" @@ -10995,26 +11027,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2429 ../src/guestfs-actions.pod:3753 +#: ../fish/guestfish-actions.pod:2441 ../src/guestfs-actions.pod:3769 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:2432 ../src/guestfs-actions.pod:3756 +#: ../fish/guestfish-actions.pod:2444 ../src/guestfs-actions.pod:3772 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:2438 +#: ../fish/guestfish-actions.pod:2450 msgid "inspect-get-windows-systemroot" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2440 +#: ../fish/guestfish-actions.pod:2452 #, no-wrap msgid "" " inspect-get-windows-systemroot root\n" @@ -11022,14 +11054,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2442 ../src/guestfs-actions.pod:3773 +#: ../fish/guestfish-actions.pod:2454 ../src/guestfs-actions.pod:3789 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:2445 ../src/guestfs-actions.pod:3776 +#: ../fish/guestfish-actions.pod:2457 ../src/guestfs-actions.pod:3792 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 " @@ -11037,12 +11069,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2451 +#: ../fish/guestfish-actions.pod:2463 msgid "inspect-is-live" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2453 +#: ../fish/guestfish-actions.pod:2465 #, no-wrap msgid "" " inspect-is-live root\n" @@ -11050,19 +11082,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2455 +#: ../fish/guestfish-actions.pod:2467 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:2461 +#: ../fish/guestfish-actions.pod:2473 msgid "inspect-is-multipart" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2463 +#: ../fish/guestfish-actions.pod:2475 #, no-wrap msgid "" " inspect-is-multipart root\n" @@ -11070,19 +11102,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2465 +#: ../fish/guestfish-actions.pod:2477 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:2471 +#: ../fish/guestfish-actions.pod:2483 msgid "inspect-is-netinst" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2473 +#: ../fish/guestfish-actions.pod:2485 #, no-wrap msgid "" " inspect-is-netinst root\n" @@ -11090,7 +11122,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2475 +#: ../fish/guestfish-actions.pod:2487 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 " @@ -11099,12 +11131,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2483 +#: ../fish/guestfish-actions.pod:2495 msgid "inspect-list-applications" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2485 +#: ../fish/guestfish-actions.pod:2497 #, no-wrap msgid "" " inspect-list-applications root\n" @@ -11112,12 +11144,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2487 ../src/guestfs-actions.pod:3843 +#: ../fish/guestfish-actions.pod:2499 ../src/guestfs-actions.pod:3859 msgid "Return the list of applications installed in the operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2489 +#: ../fish/guestfish-actions.pod:2501 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>, " @@ -11129,91 +11161,91 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2499 ../src/guestfs-actions.pod:3855 +#: ../fish/guestfish-actions.pod:2511 ../src/guestfs-actions.pod:3871 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:2502 ../src/guestfs-actions.pod:3858 +#: ../fish/guestfish-actions.pod:2514 ../src/guestfs-actions.pod:3874 msgid "The application structure contains the following fields:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2506 ../src/guestfs-actions.pod:3862 +#: ../fish/guestfish-actions.pod:2518 ../src/guestfs-actions.pod:3878 msgid "C<app_name>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2508 ../src/guestfs-actions.pod:3864 +#: ../fish/guestfish-actions.pod:2520 ../src/guestfs-actions.pod:3880 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:2511 ../src/guestfs-actions.pod:3867 +#: ../fish/guestfish-actions.pod:2523 ../src/guestfs-actions.pod:3883 msgid "C<app_display_name>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2513 ../src/guestfs-actions.pod:3869 +#: ../fish/guestfish-actions.pod:2525 ../src/guestfs-actions.pod:3885 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:2516 ../src/guestfs-actions.pod:3872 +#: ../fish/guestfish-actions.pod:2528 ../src/guestfs-actions.pod:3888 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:2519 ../src/guestfs-actions.pod:3875 +#: ../fish/guestfish-actions.pod:2531 ../src/guestfs-actions.pod:3891 msgid "C<app_epoch>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2521 ../src/guestfs-actions.pod:3877 +#: ../fish/guestfish-actions.pod:2533 ../src/guestfs-actions.pod:3893 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:2524 ../src/guestfs-actions.pod:3880 +#: ../fish/guestfish-actions.pod:2536 ../src/guestfs-actions.pod:3896 msgid "C<app_version>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2526 ../src/guestfs-actions.pod:3882 +#: ../fish/guestfish-actions.pod:2538 ../src/guestfs-actions.pod:3898 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:2529 ../src/guestfs-actions.pod:3885 +#: ../fish/guestfish-actions.pod:2541 ../src/guestfs-actions.pod:3901 msgid "C<app_release>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2531 ../src/guestfs-actions.pod:3887 +#: ../fish/guestfish-actions.pod:2543 ../src/guestfs-actions.pod:3903 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:2535 ../src/guestfs-actions.pod:3891 +#: ../fish/guestfish-actions.pod:2547 ../src/guestfs-actions.pod:3907 msgid "C<app_install_path>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2537 ../src/guestfs-actions.pod:3893 +#: ../fish/guestfish-actions.pod:2549 ../src/guestfs-actions.pod:3909 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 " @@ -11221,89 +11253,89 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2542 ../src/guestfs-actions.pod:3898 +#: ../fish/guestfish-actions.pod:2554 ../src/guestfs-actions.pod:3914 msgid "If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2544 ../src/guestfs-actions.pod:3900 +#: ../fish/guestfish-actions.pod:2556 ../src/guestfs-actions.pod:3916 msgid "C<app_trans_path>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2546 ../src/guestfs-actions.pod:3902 +#: ../fish/guestfish-actions.pod:2558 ../src/guestfs-actions.pod:3918 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:2549 ../src/guestfs-actions.pod:3905 +#: ../fish/guestfish-actions.pod:2561 ../src/guestfs-actions.pod:3921 msgid "C<app_publisher>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2551 ../src/guestfs-actions.pod:3907 +#: ../fish/guestfish-actions.pod:2563 ../src/guestfs-actions.pod:3923 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:2555 ../src/guestfs-actions.pod:3911 +#: ../fish/guestfish-actions.pod:2567 ../src/guestfs-actions.pod:3927 msgid "C<app_url>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2557 ../src/guestfs-actions.pod:3913 +#: ../fish/guestfish-actions.pod:2569 ../src/guestfs-actions.pod:3929 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:2560 ../src/guestfs-actions.pod:3916 +#: ../fish/guestfish-actions.pod:2572 ../src/guestfs-actions.pod:3932 msgid "C<app_source_package>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2562 ../src/guestfs-actions.pod:3918 +#: ../fish/guestfish-actions.pod:2574 ../src/guestfs-actions.pod:3934 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:2565 ../src/guestfs-actions.pod:3921 +#: ../fish/guestfish-actions.pod:2577 ../src/guestfs-actions.pod:3937 msgid "C<app_summary>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2567 ../src/guestfs-actions.pod:3923 +#: ../fish/guestfish-actions.pod:2579 ../src/guestfs-actions.pod:3939 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:2570 ../src/guestfs-actions.pod:3926 +#: ../fish/guestfish-actions.pod:2582 ../src/guestfs-actions.pod:3942 msgid "C<app_description>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2572 ../src/guestfs-actions.pod:3928 +#: ../fish/guestfish-actions.pod:2584 ../src/guestfs-actions.pod:3944 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:2579 +#: ../fish/guestfish-actions.pod:2591 msgid "inspect-os" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2581 +#: ../fish/guestfish-actions.pod:2593 #, no-wrap msgid "" " inspect-os\n" @@ -11311,7 +11343,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2583 ../src/guestfs-actions.pod:3946 +#: ../fish/guestfish-actions.pod:2595 ../src/guestfs-actions.pod:3962 msgid "" "This function uses other libguestfs functions and certain heuristics to " "inspect the disk(s) (usually disks belonging to a virtual machine), looking " @@ -11319,12 +11351,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2587 ../src/guestfs-actions.pod:3950 +#: ../fish/guestfish-actions.pod:2599 ../src/guestfs-actions.pod:3966 msgid "The list returned is empty if no operating systems were found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2589 ../src/guestfs-actions.pod:3952 +#: ../fish/guestfish-actions.pod:2601 ../src/guestfs-actions.pod:3968 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. " @@ -11334,7 +11366,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2596 +#: ../fish/guestfish-actions.pod:2608 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, " @@ -11342,7 +11374,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2601 +#: ../fish/guestfish-actions.pod:2613 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 " @@ -11351,24 +11383,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2607 ../src/guestfs-actions.pod:3970 +#: ../fish/guestfish-actions.pod:2619 ../src/guestfs-actions.pod:3986 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:2613 ../fish/guestfish-actions.pod:2811 ../fish/guestfish-actions.pod:2876 +#: ../fish/guestfish-actions.pod:2625 ../fish/guestfish-actions.pod:2832 ../fish/guestfish-actions.pod:2897 msgid "See also L</list-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2615 +#: ../fish/guestfish-actions.pod:2627 msgid "is-blockdev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2617 +#: ../fish/guestfish-actions.pod:2629 #, no-wrap msgid "" " is-blockdev path\n" @@ -11376,24 +11408,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2619 ../src/guestfs-actions.pod:3990 +#: ../fish/guestfish-actions.pod:2631 ../src/guestfs-actions.pod:4006 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:2622 ../fish/guestfish-actions.pod:2640 ../fish/guestfish-actions.pod:2659 ../fish/guestfish-actions.pod:2668 ../fish/guestfish-actions.pod:2678 ../fish/guestfish-actions.pod:2712 ../fish/guestfish-actions.pod:2721 +#: ../fish/guestfish-actions.pod:2634 ../fish/guestfish-actions.pod:2652 ../fish/guestfish-actions.pod:2671 ../fish/guestfish-actions.pod:2680 ../fish/guestfish-actions.pod:2690 ../fish/guestfish-actions.pod:2724 ../fish/guestfish-actions.pod:2733 msgid "See also L</stat>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2624 +#: ../fish/guestfish-actions.pod:2636 msgid "is-busy" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2626 +#: ../fish/guestfish-actions.pod:2638 #, no-wrap msgid "" " is-busy\n" @@ -11401,19 +11433,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2628 ../src/guestfs-actions.pod:4004 +#: ../fish/guestfish-actions.pod:2640 ../src/guestfs-actions.pod:4020 msgid "" "This returns true iff this handle is busy processing a command (in the " "C<BUSY> state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2633 +#: ../fish/guestfish-actions.pod:2645 msgid "is-chardev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2635 +#: ../fish/guestfish-actions.pod:2647 #, no-wrap msgid "" " is-chardev path\n" @@ -11421,19 +11453,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2637 ../src/guestfs-actions.pod:4019 +#: ../fish/guestfish-actions.pod:2649 ../src/guestfs-actions.pod:4035 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:2642 +#: ../fish/guestfish-actions.pod:2654 msgid "is-config" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2644 +#: ../fish/guestfish-actions.pod:2656 #, no-wrap msgid "" " is-config\n" @@ -11441,19 +11473,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2646 ../src/guestfs-actions.pod:4033 +#: ../fish/guestfish-actions.pod:2658 ../src/guestfs-actions.pod:4049 msgid "" "This returns true iff this handle is being configured (in the C<CONFIG> " "state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2651 +#: ../fish/guestfish-actions.pod:2663 msgid "is-dir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2653 +#: ../fish/guestfish-actions.pod:2665 #, no-wrap msgid "" " is-dir path\n" @@ -11461,19 +11493,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2655 ../src/guestfs-actions.pod:4048 +#: ../fish/guestfish-actions.pod:2667 ../src/guestfs-actions.pod:4064 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:2661 +#: ../fish/guestfish-actions.pod:2673 msgid "is-fifo" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2663 +#: ../fish/guestfish-actions.pod:2675 #, no-wrap msgid "" " is-fifo path\n" @@ -11481,19 +11513,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2665 ../src/guestfs-actions.pod:4064 +#: ../fish/guestfish-actions.pod:2677 ../src/guestfs-actions.pod:4080 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:2670 +#: ../fish/guestfish-actions.pod:2682 msgid "is-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2672 +#: ../fish/guestfish-actions.pod:2684 #, no-wrap msgid "" " is-file path\n" @@ -11501,7 +11533,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2674 ../src/guestfs-actions.pod:4079 +#: ../fish/guestfish-actions.pod:2686 ../src/guestfs-actions.pod:4095 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 " @@ -11509,12 +11541,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2680 +#: ../fish/guestfish-actions.pod:2692 msgid "is-launching" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2682 +#: ../fish/guestfish-actions.pod:2694 #, no-wrap msgid "" " is-launching\n" @@ -11522,19 +11554,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2684 ../src/guestfs-actions.pod:4094 +#: ../fish/guestfish-actions.pod:2696 ../src/guestfs-actions.pod:4110 msgid "" "This returns true iff this handle is launching the subprocess (in the " "C<LAUNCHING> state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2689 +#: ../fish/guestfish-actions.pod:2701 msgid "is-lv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2691 +#: ../fish/guestfish-actions.pod:2703 #, no-wrap msgid "" " is-lv device\n" @@ -11542,19 +11574,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2693 ../src/guestfs-actions.pod:4109 +#: ../fish/guestfish-actions.pod:2705 ../src/guestfs-actions.pod:4125 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:2696 +#: ../fish/guestfish-actions.pod:2708 msgid "is-ready" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2698 +#: ../fish/guestfish-actions.pod:2710 #, no-wrap msgid "" " is-ready\n" @@ -11562,19 +11594,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2700 ../src/guestfs-actions.pod:4121 +#: ../fish/guestfish-actions.pod:2712 ../src/guestfs-actions.pod:4137 msgid "" "This returns true iff this handle is ready to accept commands (in the " "C<READY> state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2705 +#: ../fish/guestfish-actions.pod:2717 msgid "is-socket" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2707 +#: ../fish/guestfish-actions.pod:2719 #, no-wrap msgid "" " is-socket path\n" @@ -11582,19 +11614,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2709 ../src/guestfs-actions.pod:4136 +#: ../fish/guestfish-actions.pod:2721 ../src/guestfs-actions.pod:4152 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:2714 +#: ../fish/guestfish-actions.pod:2726 msgid "is-symlink" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2716 +#: ../fish/guestfish-actions.pod:2728 #, no-wrap msgid "" " is-symlink path\n" @@ -11602,19 +11634,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2718 ../src/guestfs-actions.pod:4151 +#: ../fish/guestfish-actions.pod:2730 ../src/guestfs-actions.pod:4167 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:2723 +#: ../fish/guestfish-actions.pod:2735 msgid "is-zero" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2725 +#: ../fish/guestfish-actions.pod:2737 #, no-wrap msgid "" " is-zero path\n" @@ -11622,19 +11654,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2727 ../src/guestfs-actions.pod:4166 +#: ../fish/guestfish-actions.pod:2739 ../src/guestfs-actions.pod:4182 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:2730 +#: ../fish/guestfish-actions.pod:2742 msgid "is-zero-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2732 +#: ../fish/guestfish-actions.pod:2744 #, no-wrap msgid "" " is-zero-device device\n" @@ -11642,22 +11674,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2734 ../src/guestfs-actions.pod:4179 +#: ../fish/guestfish-actions.pod:2746 ../src/guestfs-actions.pod:4195 msgid "This returns true iff the device exists and contains all zero bytes." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2736 ../src/guestfs-actions.pod:4181 +#: ../fish/guestfish-actions.pod:2748 ../src/guestfs-actions.pod:4197 msgid "Note that for large devices this can take a long time to run." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2738 +#: ../fish/guestfish-actions.pod:2750 msgid "kill-subprocess" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2740 +#: ../fish/guestfish-actions.pod:2752 #, no-wrap msgid "" " kill-subprocess\n" @@ -11665,22 +11697,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2742 ../src/guestfs-actions.pod:4192 -msgid "This kills the qemu subprocess. You should never need to call this." +#: ../fish/guestfish-actions.pod:2754 ../src/guestfs-actions.pod:4215 +msgid "This kills the qemu subprocess." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:2756 +msgid "Do not call this. See: L</shutdown> instead." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:2758 +msgid "" +"I<This function is deprecated.> In new code, use the L</shutdown> call " +"instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2744 +#: ../fish/guestfish-actions.pod:2765 msgid "launch" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2746 +#: ../fish/guestfish-actions.pod:2767 msgid "run" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2748 +#: ../fish/guestfish-actions.pod:2769 #, no-wrap msgid "" " launch\n" @@ -11688,26 +11732,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2750 ../src/guestfs-actions.pod:4203 +#: ../fish/guestfish-actions.pod:2771 ../src/guestfs-actions.pod:4228 msgid "" "Internally libguestfs is implemented by running a virtual machine using " "L<qemu(1)>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2753 ../src/guestfs-actions.pod:4206 +#: ../fish/guestfish-actions.pod:2774 ../src/guestfs-actions.pod:4231 msgid "" "You should call this after configuring the handle (eg. adding drives) but " "before performing any actions." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2756 +#: ../fish/guestfish-actions.pod:2777 msgid "lchown" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2758 +#: ../fish/guestfish-actions.pod:2779 #, no-wrap msgid "" " lchown owner group path\n" @@ -11715,7 +11759,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2760 +#: ../fish/guestfish-actions.pod:2781 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 " @@ -11723,12 +11767,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2768 +#: ../fish/guestfish-actions.pod:2789 msgid "lgetxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2770 +#: ../fish/guestfish-actions.pod:2791 #, no-wrap msgid "" " lgetxattr path name\n" @@ -11736,24 +11780,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2772 ../src/guestfs-actions.pod:4246 +#: ../fish/guestfish-actions.pod:2793 ../src/guestfs-actions.pod:4271 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:2786 +#: ../fish/guestfish-actions.pod:2807 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2788 +#: ../fish/guestfish-actions.pod:2809 msgid "lgetxattrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2790 +#: ../fish/guestfish-actions.pod:2811 #, no-wrap msgid "" " lgetxattrs path\n" @@ -11761,19 +11805,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2792 +#: ../fish/guestfish-actions.pod:2813 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:2796 +#: ../fish/guestfish-actions.pod:2817 msgid "list-9p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2798 +#: ../fish/guestfish-actions.pod:2819 #, no-wrap msgid "" " list-9p\n" @@ -11781,19 +11825,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2800 ../src/guestfs-actions.pod:4289 +#: ../fish/guestfish-actions.pod:2821 ../src/guestfs-actions.pod:4314 msgid "" "List all 9p filesystems attached to the guest. A list of mount tags is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2803 +#: ../fish/guestfish-actions.pod:2824 msgid "list-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2805 +#: ../fish/guestfish-actions.pod:2826 #, no-wrap msgid "" " list-devices\n" @@ -11801,22 +11845,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2807 ../src/guestfs-actions.pod:4303 +#: ../fish/guestfish-actions.pod:2828 ../src/guestfs-actions.pod:4328 msgid "List all the block devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2809 ../src/guestfs-actions.pod:4305 +#: ../fish/guestfish-actions.pod:2830 ../src/guestfs-actions.pod:4330 msgid "The full block device names are returned, eg. C</dev/sda>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2813 +#: ../fish/guestfish-actions.pod:2834 msgid "list-dm-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2815 +#: ../fish/guestfish-actions.pod:2836 #, no-wrap msgid "" " list-dm-devices\n" @@ -11824,31 +11868,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2817 ../src/guestfs-actions.pod:4320 +#: ../fish/guestfish-actions.pod:2838 ../src/guestfs-actions.pod:4345 msgid "List all device mapper devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2819 +#: ../fish/guestfish-actions.pod:2840 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:2822 +#: ../fish/guestfish-actions.pod:2843 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:2826 +#: ../fish/guestfish-actions.pod:2847 msgid "list-filesystems" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2828 +#: ../fish/guestfish-actions.pod:2849 #, no-wrap msgid "" " list-filesystems\n" @@ -11856,7 +11900,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2830 ../src/guestfs-actions.pod:4340 +#: ../fish/guestfish-actions.pod:2851 ../src/guestfs-actions.pod:4365 msgid "" "This inspection command looks for filesystems on partitions, block devices " "and logical volumes, returning a list of devices containing filesystems and " @@ -11864,14 +11908,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2834 ../src/guestfs-actions.pod:4344 +#: ../fish/guestfish-actions.pod:2855 ../src/guestfs-actions.pod:4369 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:2838 ../src/guestfs-actions.pod:4348 +#: ../fish/guestfish-actions.pod:2859 ../src/guestfs-actions.pod:4373 #, no-wrap msgid "" " \"/dev/sda1\" => \"ntfs\"\n" @@ -11882,14 +11926,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2843 ../src/guestfs-actions.pod:4353 +#: ../fish/guestfish-actions.pod:2864 ../src/guestfs-actions.pod:4378 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:2847 +#: ../fish/guestfish-actions.pod:2868 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 " @@ -11897,7 +11941,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2851 +#: ../fish/guestfish-actions.pod:2872 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 " @@ -11907,12 +11951,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2859 +#: ../fish/guestfish-actions.pod:2880 msgid "list-md-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2861 +#: ../fish/guestfish-actions.pod:2882 #, no-wrap msgid "" " list-md-devices\n" @@ -11920,17 +11964,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2863 ../src/guestfs-actions.pod:4382 +#: ../fish/guestfish-actions.pod:2884 ../src/guestfs-actions.pod:4407 msgid "List all Linux md devices." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2865 +#: ../fish/guestfish-actions.pod:2886 msgid "list-partitions" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2867 +#: ../fish/guestfish-actions.pod:2888 #, no-wrap msgid "" " list-partitions\n" @@ -11938,29 +11982,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2869 ../src/guestfs-actions.pod:4395 +#: ../fish/guestfish-actions.pod:2890 ../src/guestfs-actions.pod:4420 msgid "List all the partitions detected on all block devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2871 ../src/guestfs-actions.pod:4397 +#: ../fish/guestfish-actions.pod:2892 ../src/guestfs-actions.pod:4422 msgid "The full partition device names are returned, eg. C</dev/sda1>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2873 +#: ../fish/guestfish-actions.pod:2894 msgid "" "This does not return logical volumes. For that you will need to call " "L</lvs>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2878 +#: ../fish/guestfish-actions.pod:2899 msgid "ll" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2880 +#: ../fish/guestfish-actions.pod:2901 #, no-wrap msgid "" " ll directory\n" @@ -11968,26 +12012,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2882 ../src/guestfs-actions.pod:4416 +#: ../fish/guestfish-actions.pod:2903 ../src/guestfs-actions.pod:4441 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:2885 ../src/guestfs-actions.pod:4419 +#: ../fish/guestfish-actions.pod:2906 ../src/guestfs-actions.pod:4444 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:2888 +#: ../fish/guestfish-actions.pod:2909 msgid "ln" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2890 +#: ../fish/guestfish-actions.pod:2911 #, no-wrap msgid "" " ln target linkname\n" @@ -11995,17 +12039,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2892 ../src/guestfs-actions.pod:4434 +#: ../fish/guestfish-actions.pod:2913 ../src/guestfs-actions.pod:4459 msgid "This command creates a hard link using the C<ln> command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2894 +#: ../fish/guestfish-actions.pod:2915 msgid "ln-f" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2896 +#: ../fish/guestfish-actions.pod:2917 #, no-wrap msgid "" " ln-f target linkname\n" @@ -12013,19 +12057,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2898 ../src/guestfs-actions.pod:4447 +#: ../fish/guestfish-actions.pod:2919 ../src/guestfs-actions.pod:4472 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:2901 +#: ../fish/guestfish-actions.pod:2922 msgid "ln-s" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2903 +#: ../fish/guestfish-actions.pod:2924 #, no-wrap msgid "" " ln-s target linkname\n" @@ -12033,17 +12077,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2905 ../src/guestfs-actions.pod:4461 +#: ../fish/guestfish-actions.pod:2926 ../src/guestfs-actions.pod:4486 msgid "This command creates a symbolic link using the C<ln -s> command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2907 +#: ../fish/guestfish-actions.pod:2928 msgid "ln-sf" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2909 +#: ../fish/guestfish-actions.pod:2930 #, no-wrap msgid "" " ln-sf target linkname\n" @@ -12051,19 +12095,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2911 ../src/guestfs-actions.pod:4474 +#: ../fish/guestfish-actions.pod:2932 ../src/guestfs-actions.pod:4499 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:2914 +#: ../fish/guestfish-actions.pod:2935 msgid "lremovexattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2916 +#: ../fish/guestfish-actions.pod:2937 #, no-wrap msgid "" " lremovexattr xattr path\n" @@ -12071,19 +12115,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2918 +#: ../fish/guestfish-actions.pod:2939 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:2922 +#: ../fish/guestfish-actions.pod:2943 msgid "ls" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2924 +#: ../fish/guestfish-actions.pod:2945 #, no-wrap msgid "" " ls directory\n" @@ -12091,7 +12135,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2926 ../src/guestfs-actions.pod:4502 +#: ../fish/guestfish-actions.pod:2947 ../src/guestfs-actions.pod:4527 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 " @@ -12099,19 +12143,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2930 +#: ../fish/guestfish-actions.pod:2951 msgid "" "This command is mostly useful for interactive sessions. Programs should " "probably use L</readdir> instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2933 +#: ../fish/guestfish-actions.pod:2954 msgid "lsetxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2935 +#: ../fish/guestfish-actions.pod:2956 #, no-wrap msgid "" " lsetxattr xattr val vallen path\n" @@ -12119,19 +12163,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2937 +#: ../fish/guestfish-actions.pod:2958 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:2941 +#: ../fish/guestfish-actions.pod:2962 msgid "lstat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2943 +#: ../fish/guestfish-actions.pod:2964 #, no-wrap msgid "" " lstat path\n" @@ -12139,29 +12183,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2945 ../fish/guestfish-actions.pod:4846 ../src/guestfs-actions.pod:4538 ../src/guestfs-actions.pod:7477 +#: ../fish/guestfish-actions.pod:2966 ../fish/guestfish-actions.pod:4898 ../src/guestfs-actions.pod:4563 ../src/guestfs-actions.pod:7539 msgid "Returns file information for the given C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2947 +#: ../fish/guestfish-actions.pod:2968 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:2951 ../src/guestfs-actions.pod:4544 +#: ../fish/guestfish-actions.pod:2972 ../src/guestfs-actions.pod:4569 msgid "This is the same as the C<lstat(2)> system call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2953 +#: ../fish/guestfish-actions.pod:2974 msgid "lstatlist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2955 +#: ../fish/guestfish-actions.pod:2976 #, no-wrap msgid "" " lstatlist path 'names ...'\n" @@ -12169,7 +12213,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2957 +#: ../fish/guestfish-actions.pod:2978 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 " @@ -12177,7 +12221,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2961 ../src/guestfs-actions.pod:4563 +#: ../fish/guestfish-actions.pod:2982 ../src/guestfs-actions.pod:4588 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, " @@ -12185,7 +12229,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2966 +#: ../fish/guestfish-actions.pod:2987 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 " @@ -12196,12 +12240,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2974 +#: ../fish/guestfish-actions.pod:2995 msgid "luks-add-key" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2976 +#: ../fish/guestfish-actions.pod:2997 #, no-wrap msgid "" " luks-add-key device keyslot\n" @@ -12209,7 +12253,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2978 ../src/guestfs-actions.pod:4591 +#: ../fish/guestfish-actions.pod:2999 ../src/guestfs-actions.pod:4616 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 " @@ -12217,26 +12261,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2983 +#: ../fish/guestfish-actions.pod:3004 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:2987 ../fish/guestfish-actions.pod:3009 ../fish/guestfish-actions.pod:3019 ../fish/guestfish-actions.pod:3030 ../fish/guestfish-actions.pod:3056 ../fish/guestfish-actions.pod:3066 +#: ../fish/guestfish-actions.pod:3008 ../fish/guestfish-actions.pod:3030 ../fish/guestfish-actions.pod:3040 ../fish/guestfish-actions.pod:3051 ../fish/guestfish-actions.pod:3077 ../fish/guestfish-actions.pod:3087 msgid "" "This command has one or more key or passphrase parameters. Guestfish will " "prompt for these separately." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2990 +#: ../fish/guestfish-actions.pod:3011 msgid "luks-close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2992 +#: ../fish/guestfish-actions.pod:3013 #, no-wrap msgid "" " luks-close device\n" @@ -12244,7 +12288,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2994 +#: ../fish/guestfish-actions.pod:3015 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 " @@ -12253,12 +12297,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3000 +#: ../fish/guestfish-actions.pod:3021 msgid "luks-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3002 +#: ../fish/guestfish-actions.pod:3023 #, no-wrap msgid "" " luks-format device keyslot\n" @@ -12266,7 +12310,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3004 ../src/guestfs-actions.pod:4632 +#: ../fish/guestfish-actions.pod:3025 ../src/guestfs-actions.pod:4657 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 " @@ -12274,12 +12318,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3012 +#: ../fish/guestfish-actions.pod:3033 msgid "luks-format-cipher" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3014 +#: ../fish/guestfish-actions.pod:3035 #, no-wrap msgid "" " luks-format-cipher device keyslot cipher\n" @@ -12287,19 +12331,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3016 +#: ../fish/guestfish-actions.pod:3037 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:3022 +#: ../fish/guestfish-actions.pod:3043 msgid "luks-kill-slot" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3024 +#: ../fish/guestfish-actions.pod:3045 #, no-wrap msgid "" " luks-kill-slot device keyslot\n" @@ -12307,19 +12351,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3026 ../src/guestfs-actions.pod:4673 +#: ../fish/guestfish-actions.pod:3047 ../src/guestfs-actions.pod:4698 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:3033 +#: ../fish/guestfish-actions.pod:3054 msgid "luks-open" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3035 +#: ../fish/guestfish-actions.pod:3056 #, no-wrap msgid "" " luks-open device mapname\n" @@ -12327,26 +12371,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3037 ../src/guestfs-actions.pod:4693 +#: ../fish/guestfish-actions.pod:3058 ../src/guestfs-actions.pod:4718 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:3040 ../src/guestfs-actions.pod:4696 +#: ../fish/guestfish-actions.pod:3061 ../src/guestfs-actions.pod:4721 msgid "C<device> is the encrypted block device or partition." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3042 ../src/guestfs-actions.pod:4698 +#: ../fish/guestfish-actions.pod:3063 ../src/guestfs-actions.pod:4723 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:3045 ../src/guestfs-actions.pod:4701 +#: ../fish/guestfish-actions.pod:3066 ../src/guestfs-actions.pod:4726 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 " @@ -12354,24 +12398,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3049 +#: ../fish/guestfish-actions.pod:3070 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:3053 +#: ../fish/guestfish-actions.pod:3074 msgid "Use L</list-dm-devices> to list all device mapper devices." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3059 +#: ../fish/guestfish-actions.pod:3080 msgid "luks-open-ro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3061 +#: ../fish/guestfish-actions.pod:3082 #, no-wrap msgid "" " luks-open-ro device mapname\n" @@ -12379,19 +12423,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3063 +#: ../fish/guestfish-actions.pod:3084 msgid "" "This is the same as L</luks-open> except that a read-only mapping is " "created." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3069 +#: ../fish/guestfish-actions.pod:3090 msgid "lvcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3071 +#: ../fish/guestfish-actions.pod:3092 #, no-wrap msgid "" " lvcreate logvol volgroup mbytes\n" @@ -12399,19 +12443,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3073 ../src/guestfs-actions.pod:4747 +#: ../fish/guestfish-actions.pod:3094 ../src/guestfs-actions.pod:4772 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:3076 +#: ../fish/guestfish-actions.pod:3097 msgid "lvm-canonical-lv-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3078 +#: ../fish/guestfish-actions.pod:3099 #, no-wrap msgid "" " lvm-canonical-lv-name lvname\n" @@ -12419,7 +12463,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3080 ../src/guestfs-actions.pod:4760 +#: ../fish/guestfish-actions.pod:3101 ../src/guestfs-actions.pod:4785 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 " @@ -12427,24 +12471,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3084 ../src/guestfs-actions.pod:4764 +#: ../fish/guestfish-actions.pod:3105 ../src/guestfs-actions.pod:4789 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:3087 +#: ../fish/guestfish-actions.pod:3108 msgid "See also L</is-lv>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3089 +#: ../fish/guestfish-actions.pod:3110 msgid "lvm-clear-filter" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3091 +#: ../fish/guestfish-actions.pod:3112 #, no-wrap msgid "" " lvm-clear-filter\n" @@ -12452,24 +12496,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3093 +#: ../fish/guestfish-actions.pod:3114 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:3096 ../fish/guestfish-actions.pod:3124 ../src/guestfs-actions.pod:4782 ../src/guestfs-actions.pod:4821 +#: ../fish/guestfish-actions.pod:3117 ../fish/guestfish-actions.pod:3145 ../src/guestfs-actions.pod:4807 ../src/guestfs-actions.pod:4846 msgid "This command also clears the LVM cache and performs a volume group scan." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3099 +#: ../fish/guestfish-actions.pod:3120 msgid "lvm-remove-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3101 +#: ../fish/guestfish-actions.pod:3122 #, no-wrap msgid "" " lvm-remove-all\n" @@ -12477,19 +12521,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3103 ../src/guestfs-actions.pod:4794 +#: ../fish/guestfish-actions.pod:3124 ../src/guestfs-actions.pod:4819 msgid "" "This command removes all LVM logical volumes, volume groups and physical " "volumes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3106 +#: ../fish/guestfish-actions.pod:3127 msgid "lvm-set-filter" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3108 +#: ../fish/guestfish-actions.pod:3129 #, no-wrap msgid "" " lvm-set-filter 'devices ...'\n" @@ -12497,7 +12541,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3110 ../src/guestfs-actions.pod:4807 +#: ../fish/guestfish-actions.pod:3131 ../src/guestfs-actions.pod:4832 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 " @@ -12505,7 +12549,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3114 ../src/guestfs-actions.pod:4811 +#: ../fish/guestfish-actions.pod:3135 ../src/guestfs-actions.pod:4836 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 " @@ -12517,24 +12561,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3127 ../src/guestfs-actions.pod:4824 +#: ../fish/guestfish-actions.pod:3148 ../src/guestfs-actions.pod:4849 msgid "You can filter whole block devices or individual partitions." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3129 ../src/guestfs-actions.pod:4826 +#: ../fish/guestfish-actions.pod:3150 ../src/guestfs-actions.pod:4851 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:3133 +#: ../fish/guestfish-actions.pod:3154 msgid "lvremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3135 +#: ../fish/guestfish-actions.pod:3156 #, no-wrap msgid "" " lvremove device\n" @@ -12542,26 +12586,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3137 ../src/guestfs-actions.pod:4840 +#: ../fish/guestfish-actions.pod:3158 ../src/guestfs-actions.pod:4865 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:3140 ../src/guestfs-actions.pod:4843 +#: ../fish/guestfish-actions.pod:3161 ../src/guestfs-actions.pod:4868 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:3143 +#: ../fish/guestfish-actions.pod:3164 msgid "lvrename" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3145 +#: ../fish/guestfish-actions.pod:3166 #, no-wrap msgid "" " lvrename logvol newlogvol\n" @@ -12569,17 +12613,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3147 ../src/guestfs-actions.pod:4857 +#: ../fish/guestfish-actions.pod:3168 ../src/guestfs-actions.pod:4882 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3149 +#: ../fish/guestfish-actions.pod:3170 msgid "lvresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3151 +#: ../fish/guestfish-actions.pod:3172 #, no-wrap msgid "" " lvresize device mbytes\n" @@ -12587,19 +12631,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3153 ../src/guestfs-actions.pod:4870 +#: ../fish/guestfish-actions.pod:3174 ../src/guestfs-actions.pod:4895 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:3157 +#: ../fish/guestfish-actions.pod:3178 msgid "lvresize-free" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3159 +#: ../fish/guestfish-actions.pod:3180 #, no-wrap msgid "" " lvresize-free lv percent\n" @@ -12607,7 +12651,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3161 ../src/guestfs-actions.pod:4885 +#: ../fish/guestfish-actions.pod:3182 ../src/guestfs-actions.pod:4910 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 " @@ -12616,12 +12660,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3167 +#: ../fish/guestfish-actions.pod:3188 msgid "lvs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3169 +#: ../fish/guestfish-actions.pod:3190 #, no-wrap msgid "" " lvs\n" @@ -12629,31 +12673,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3171 ../src/guestfs-actions.pod:4900 +#: ../fish/guestfish-actions.pod:3192 ../src/guestfs-actions.pod:4925 msgid "" "List all the logical volumes detected. This is the equivalent of the " "L<lvs(8)> command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3174 ../src/guestfs-actions.pod:4903 +#: ../fish/guestfish-actions.pod:3195 ../src/guestfs-actions.pod:4928 msgid "" "This returns a list of the logical volume device names " "(eg. C</dev/VolGroup00/LogVol00>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3177 +#: ../fish/guestfish-actions.pod:3198 msgid "See also L</lvs-full>, L</list-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3179 +#: ../fish/guestfish-actions.pod:3200 msgid "lvs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3181 +#: ../fish/guestfish-actions.pod:3202 #, no-wrap msgid "" " lvs-full\n" @@ -12661,19 +12705,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3183 ../src/guestfs-actions.pod:4919 +#: ../fish/guestfish-actions.pod:3204 ../src/guestfs-actions.pod:4944 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:3186 +#: ../fish/guestfish-actions.pod:3207 msgid "lvuuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3188 +#: ../fish/guestfish-actions.pod:3209 #, no-wrap msgid "" " lvuuid device\n" @@ -12681,17 +12725,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3190 ../src/guestfs-actions.pod:4934 +#: ../fish/guestfish-actions.pod:3211 ../src/guestfs-actions.pod:4959 msgid "This command returns the UUID of the LVM LV C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3192 +#: ../fish/guestfish-actions.pod:3213 msgid "lxattrlist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3194 +#: ../fish/guestfish-actions.pod:3215 #, no-wrap msgid "" " lxattrlist path 'names ...'\n" @@ -12699,7 +12743,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3196 ../src/guestfs-actions.pod:4948 +#: ../fish/guestfish-actions.pod:3217 ../src/guestfs-actions.pod:4973 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 " @@ -12707,7 +12751,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3200 ../src/guestfs-actions.pod:4952 +#: ../fish/guestfish-actions.pod:3221 ../src/guestfs-actions.pod:4977 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>. " @@ -12720,7 +12764,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3210 +#: ../fish/guestfish-actions.pod:3231 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 " @@ -12731,12 +12775,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3218 +#: ../fish/guestfish-actions.pod:3239 msgid "md-create" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3220 +#: ../fish/guestfish-actions.pod:3241 #, no-wrap msgid "" " md-create name 'devices ...' [missingbitmap:N] [nrdevices:N] [spare:N] " @@ -12745,19 +12789,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3222 ../src/guestfs-actions.pod:4995 +#: ../fish/guestfish-actions.pod:3243 ../src/guestfs-actions.pod:5020 msgid "" "Create a Linux md (RAID) device named C<name> on the devices in the list " "C<devices>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3229 ../src/guestfs-actions.pod:5002 +#: ../fish/guestfish-actions.pod:3250 ../src/guestfs-actions.pod:5027 msgid "C<missingbitmap>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3231 ../src/guestfs-actions.pod:5004 +#: ../fish/guestfish-actions.pod:3252 ../src/guestfs-actions.pod:5029 msgid "" "A bitmap of missing devices. If a bit is set it means that a missing device " "is added to the array. The least significant bit corresponds to the first " @@ -12765,85 +12809,85 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3235 ../src/guestfs-actions.pod:5008 +#: ../fish/guestfish-actions.pod:3256 ../src/guestfs-actions.pod:5033 msgid "As examples:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3237 ../src/guestfs-actions.pod:5010 +#: ../fish/guestfish-actions.pod:3258 ../src/guestfs-actions.pod:5035 msgid "" "If C<devices = [\"/dev/sda\"]> and C<missingbitmap = 0x1> then the resulting " "array would be C<[E<lt>missingE<gt>, \"/dev/sda\"]>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3240 ../src/guestfs-actions.pod:5013 +#: ../fish/guestfish-actions.pod:3261 ../src/guestfs-actions.pod:5038 msgid "" "If C<devices = [\"/dev/sda\"]> and C<missingbitmap = 0x2> then the resulting " "array would be C<[\"/dev/sda\", E<lt>missingE<gt>]>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3243 ../src/guestfs-actions.pod:5016 +#: ../fish/guestfish-actions.pod:3264 ../src/guestfs-actions.pod:5041 msgid "This defaults to C<0> (no missing devices)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3245 ../src/guestfs-actions.pod:5018 +#: ../fish/guestfish-actions.pod:3266 ../src/guestfs-actions.pod:5043 msgid "" "The length of C<devices> + the number of bits set in C<missingbitmap> must " "equal C<nrdevices> + C<spare>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3248 ../src/guestfs-actions.pod:5021 +#: ../fish/guestfish-actions.pod:3269 ../src/guestfs-actions.pod:5046 msgid "C<nrdevices>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3250 ../src/guestfs-actions.pod:5023 +#: ../fish/guestfish-actions.pod:3271 ../src/guestfs-actions.pod:5048 msgid "The number of active RAID devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3252 ../src/guestfs-actions.pod:5025 +#: ../fish/guestfish-actions.pod:3273 ../src/guestfs-actions.pod:5050 msgid "" "If not set, this defaults to the length of C<devices> plus the number of " "bits set in C<missingbitmap>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3255 ../src/guestfs-actions.pod:5028 +#: ../fish/guestfish-actions.pod:3276 ../src/guestfs-actions.pod:5053 msgid "C<spare>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3257 ../src/guestfs-actions.pod:5030 +#: ../fish/guestfish-actions.pod:3278 ../src/guestfs-actions.pod:5055 msgid "The number of spare devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3259 ../src/guestfs-actions.pod:5032 +#: ../fish/guestfish-actions.pod:3280 ../src/guestfs-actions.pod:5057 msgid "If not set, this defaults to C<0>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3261 ../src/guestfs-actions.pod:5034 +#: ../fish/guestfish-actions.pod:3282 ../src/guestfs-actions.pod:5059 msgid "C<chunk>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3263 ../src/guestfs-actions.pod:5036 +#: ../fish/guestfish-actions.pod:3284 ../src/guestfs-actions.pod:5061 msgid "The chunk size in bytes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3265 ../fish/guestfish-actions.pod:3288 ../src/guestfs-actions.pod:5038 ../src/guestfs-actions.pod:5089 +#: ../fish/guestfish-actions.pod:3286 ../fish/guestfish-actions.pod:3309 ../src/guestfs-actions.pod:5063 ../src/guestfs-actions.pod:5114 msgid "C<level>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3267 ../src/guestfs-actions.pod:5040 +#: ../fish/guestfish-actions.pod:3288 ../src/guestfs-actions.pod:5065 msgid "" "The RAID level, which can be one of: I<linear>, I<raid0>, I<0>, I<stripe>, " "I<raid1>, I<1>, I<mirror>, I<raid4>, I<4>, I<raid5>, I<5>, I<raid6>, I<6>, " @@ -12852,17 +12896,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3272 ../src/guestfs-actions.pod:5045 +#: ../fish/guestfish-actions.pod:3293 ../src/guestfs-actions.pod:5070 msgid "If not set, this defaults to C<raid1>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3278 +#: ../fish/guestfish-actions.pod:3299 msgid "md-detail" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3280 +#: ../fish/guestfish-actions.pod:3301 #, no-wrap msgid "" " md-detail md\n" @@ -12870,7 +12914,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3282 ../src/guestfs-actions.pod:5083 +#: ../fish/guestfish-actions.pod:3303 ../src/guestfs-actions.pod:5108 msgid "" "This command exposes the output of 'mdadm -DY E<lt>mdE<gt>'. The following " "fields are usually present in the returned hash. Other fields may also be " @@ -12878,52 +12922,52 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3290 ../src/guestfs-actions.pod:5091 +#: ../fish/guestfish-actions.pod:3311 ../src/guestfs-actions.pod:5116 msgid "The raid level of the MD device." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3292 ../src/guestfs-actions.pod:5093 +#: ../fish/guestfish-actions.pod:3313 ../src/guestfs-actions.pod:5118 msgid "C<devices>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3294 ../src/guestfs-actions.pod:5095 +#: ../fish/guestfish-actions.pod:3315 ../src/guestfs-actions.pod:5120 msgid "The number of underlying devices in the MD device." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3296 ../src/guestfs-actions.pod:5097 +#: ../fish/guestfish-actions.pod:3317 ../src/guestfs-actions.pod:5122 msgid "C<metadata>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3298 ../src/guestfs-actions.pod:5099 +#: ../fish/guestfish-actions.pod:3319 ../src/guestfs-actions.pod:5124 msgid "The metadata version used." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3300 ../src/guestfs-actions.pod:5101 +#: ../fish/guestfish-actions.pod:3321 ../src/guestfs-actions.pod:5126 msgid "C<uuid>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3302 ../src/guestfs-actions.pod:5103 +#: ../fish/guestfish-actions.pod:3323 ../src/guestfs-actions.pod:5128 msgid "The UUID of the MD device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3306 ../src/guestfs-actions.pod:5107 +#: ../fish/guestfish-actions.pod:3327 ../src/guestfs-actions.pod:5132 msgid "The name of the MD device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3310 +#: ../fish/guestfish-actions.pod:3331 msgid "md-stop" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3312 +#: ../fish/guestfish-actions.pod:3333 #, no-wrap msgid "" " md-stop md\n" @@ -12931,19 +12975,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3314 ../src/guestfs-actions.pod:5125 +#: ../fish/guestfish-actions.pod:3335 ../src/guestfs-actions.pod:5150 msgid "" "This command deactivates the MD array named C<md>. The device is stopped, " "but it is not destroyed or zeroed." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3317 +#: ../fish/guestfish-actions.pod:3338 msgid "mkdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3319 +#: ../fish/guestfish-actions.pod:3340 #, no-wrap msgid "" " mkdir path\n" @@ -12951,17 +12995,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3321 ../src/guestfs-actions.pod:5138 +#: ../fish/guestfish-actions.pod:3342 ../src/guestfs-actions.pod:5163 msgid "Create a directory named C<path>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3323 +#: ../fish/guestfish-actions.pod:3344 msgid "mkdir-mode" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3325 +#: ../fish/guestfish-actions.pod:3346 #, no-wrap msgid "" " mkdir-mode path mode\n" @@ -12969,14 +13013,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3327 ../src/guestfs-actions.pod:5151 +#: ../fish/guestfish-actions.pod:3348 ../src/guestfs-actions.pod:5176 msgid "" "This command creates a directory, setting the initial permissions of the " "directory to C<mode>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3330 ../src/guestfs-actions.pod:5154 +#: ../fish/guestfish-actions.pod:3351 ../src/guestfs-actions.pod:5179 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 " @@ -12984,17 +13028,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3334 +#: ../fish/guestfish-actions.pod:3355 msgid "See also L</mkdir>, L</umask>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3336 +#: ../fish/guestfish-actions.pod:3357 msgid "mkdir-p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3338 +#: ../fish/guestfish-actions.pod:3359 #, no-wrap msgid "" " mkdir-p path\n" @@ -13002,19 +13046,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3340 ../src/guestfs-actions.pod:5170 +#: ../fish/guestfish-actions.pod:3361 ../src/guestfs-actions.pod:5195 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:3343 +#: ../fish/guestfish-actions.pod:3364 msgid "mkdtemp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3345 +#: ../fish/guestfish-actions.pod:3366 #, no-wrap msgid "" " mkdtemp tmpl\n" @@ -13022,7 +13066,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3347 ../src/guestfs-actions.pod:5183 +#: ../fish/guestfish-actions.pod:3368 ../src/guestfs-actions.pod:5208 msgid "" "This command creates a temporary directory. The C<tmpl> parameter should be " "a full pathname for the temporary directory name with the final six " @@ -13030,41 +13074,41 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3352 ../src/guestfs-actions.pod:5188 +#: ../fish/guestfish-actions.pod:3373 ../src/guestfs-actions.pod:5213 msgid "" "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one " "being suitable for Windows filesystems." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3355 ../src/guestfs-actions.pod:5191 +#: ../fish/guestfish-actions.pod:3376 ../src/guestfs-actions.pod:5216 msgid "The name of the temporary directory that was created is returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3358 ../src/guestfs-actions.pod:5194 +#: ../fish/guestfish-actions.pod:3379 ../src/guestfs-actions.pod:5219 msgid "The temporary directory is created with mode 0700 and is owned by root." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3361 ../src/guestfs-actions.pod:5197 +#: ../fish/guestfish-actions.pod:3382 ../src/guestfs-actions.pod:5222 msgid "" "The caller is responsible for deleting the temporary directory and its " "contents after use." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3364 ../src/guestfs-actions.pod:5200 +#: ../fish/guestfish-actions.pod:3385 ../src/guestfs-actions.pod:5225 msgid "See also: L<mkdtemp(3)>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3366 +#: ../fish/guestfish-actions.pod:3387 msgid "mke2fs-J" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3368 +#: ../fish/guestfish-actions.pod:3389 #, no-wrap msgid "" " mke2fs-J fstype blocksize device journal\n" @@ -13072,14 +13116,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3370 ../src/guestfs-actions.pod:5216 +#: ../fish/guestfish-actions.pod:3391 ../src/guestfs-actions.pod:5241 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:3374 ../src/guestfs-actions.pod:5220 +#: ../fish/guestfish-actions.pod:3395 ../src/guestfs-actions.pod:5245 #, no-wrap msgid "" " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n" @@ -13087,17 +13131,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3376 +#: ../fish/guestfish-actions.pod:3397 msgid "See also L</mke2journal>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3378 +#: ../fish/guestfish-actions.pod:3399 msgid "mke2fs-JL" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3380 +#: ../fish/guestfish-actions.pod:3401 #, no-wrap msgid "" " mke2fs-JL fstype blocksize device label\n" @@ -13105,24 +13149,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3382 ../src/guestfs-actions.pod:5237 +#: ../fish/guestfish-actions.pod:3403 ../src/guestfs-actions.pod:5262 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:3385 +#: ../fish/guestfish-actions.pod:3406 msgid "See also L</mke2journal-L>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3387 +#: ../fish/guestfish-actions.pod:3408 msgid "mke2fs-JU" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3389 +#: ../fish/guestfish-actions.pod:3410 #, no-wrap msgid "" " mke2fs-JU fstype blocksize device uuid\n" @@ -13130,24 +13174,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3391 ../src/guestfs-actions.pod:5255 +#: ../fish/guestfish-actions.pod:3412 ../src/guestfs-actions.pod:5280 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:3394 +#: ../fish/guestfish-actions.pod:3415 msgid "See also L</mke2journal-U>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3396 +#: ../fish/guestfish-actions.pod:3417 msgid "mke2journal" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3398 +#: ../fish/guestfish-actions.pod:3419 #, no-wrap msgid "" " mke2journal blocksize device\n" @@ -13155,14 +13199,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3400 ../src/guestfs-actions.pod:5271 +#: ../fish/guestfish-actions.pod:3421 ../src/guestfs-actions.pod:5296 msgid "" "This creates an ext2 external journal on C<device>. It is equivalent to the " "command:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3403 ../src/guestfs-actions.pod:5274 +#: ../fish/guestfish-actions.pod:3424 ../src/guestfs-actions.pod:5299 #, no-wrap msgid "" " mke2fs -O journal_dev -b blocksize device\n" @@ -13170,12 +13214,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3405 +#: ../fish/guestfish-actions.pod:3426 msgid "mke2journal-L" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3407 +#: ../fish/guestfish-actions.pod:3428 #, no-wrap msgid "" " mke2journal-L blocksize label device\n" @@ -13183,17 +13227,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3409 ../src/guestfs-actions.pod:5288 +#: ../fish/guestfish-actions.pod:3430 ../src/guestfs-actions.pod:5313 msgid "This creates an ext2 external journal on C<device> with label C<label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3411 +#: ../fish/guestfish-actions.pod:3432 msgid "mke2journal-U" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3413 +#: ../fish/guestfish-actions.pod:3434 #, no-wrap msgid "" " mke2journal-U blocksize uuid device\n" @@ -13201,17 +13245,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3415 ../src/guestfs-actions.pod:5302 +#: ../fish/guestfish-actions.pod:3436 ../src/guestfs-actions.pod:5327 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3417 +#: ../fish/guestfish-actions.pod:3438 msgid "mkfifo" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3419 +#: ../fish/guestfish-actions.pod:3440 #, no-wrap msgid "" " mkfifo mode path\n" @@ -13219,19 +13263,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3421 +#: ../fish/guestfish-actions.pod:3442 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:3427 +#: ../fish/guestfish-actions.pod:3448 msgid "mkfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3429 +#: ../fish/guestfish-actions.pod:3450 #, no-wrap msgid "" " mkfs fstype device\n" @@ -13239,19 +13283,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3431 ../src/guestfs-actions.pod:5332 +#: ../fish/guestfish-actions.pod:3452 ../src/guestfs-actions.pod:5357 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:3435 +#: ../fish/guestfish-actions.pod:3456 msgid "mkfs-b" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3437 +#: ../fish/guestfish-actions.pod:3458 #, no-wrap msgid "" " mkfs-b fstype blocksize device\n" @@ -13259,7 +13303,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3439 +#: ../fish/guestfish-actions.pod:3460 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 " @@ -13267,26 +13311,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3444 ../fish/guestfish-actions.pod:3471 ../src/guestfs-actions.pod:5360 ../src/guestfs-actions.pod:5398 +#: ../fish/guestfish-actions.pod:3465 ../fish/guestfish-actions.pod:3492 ../src/guestfs-actions.pod:5385 ../src/guestfs-actions.pod:5423 msgid "" "For VFAT and NTFS the C<blocksize> parameter is treated as the requested " "cluster size." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3447 +#: ../fish/guestfish-actions.pod:3468 msgid "" "I<This function is deprecated.> In new code, use the L</mkfs_opts> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3454 +#: ../fish/guestfish-actions.pod:3475 msgid "mkfs-opts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3456 +#: ../fish/guestfish-actions.pod:3477 #, no-wrap msgid "" " mkfs-opts fstype device [blocksize:N] [features:..] [inode:N] " @@ -13295,19 +13339,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3458 ../src/guestfs-actions.pod:5385 +#: ../fish/guestfish-actions.pod:3479 ../src/guestfs-actions.pod:5410 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:3465 ../src/guestfs-actions.pod:5392 +#: ../fish/guestfish-actions.pod:3486 ../src/guestfs-actions.pod:5417 msgid "C<blocksize>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3467 ../src/guestfs-actions.pod:5394 +#: ../fish/guestfish-actions.pod:3488 ../src/guestfs-actions.pod:5419 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 " @@ -13315,65 +13359,65 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3474 ../src/guestfs-actions.pod:5401 +#: ../fish/guestfish-actions.pod:3495 ../src/guestfs-actions.pod:5426 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3476 ../src/guestfs-actions.pod:5403 +#: ../fish/guestfish-actions.pod:3497 ../src/guestfs-actions.pod:5428 msgid "C<features>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3478 ../src/guestfs-actions.pod:5405 +#: ../fish/guestfish-actions.pod:3499 ../src/guestfs-actions.pod:5430 msgid "This passes the I<-O> parameter to the external mkfs program." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3480 ../src/guestfs-actions.pod:5407 +#: ../fish/guestfish-actions.pod:3501 ../src/guestfs-actions.pod:5432 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:3484 ../src/guestfs-actions.pod:5411 +#: ../fish/guestfish-actions.pod:3505 ../src/guestfs-actions.pod:5436 msgid "" "You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem " "type." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3487 ../src/guestfs-actions.pod:5414 +#: ../fish/guestfish-actions.pod:3508 ../src/guestfs-actions.pod:5439 msgid "C<inode>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3489 ../src/guestfs-actions.pod:5416 +#: ../fish/guestfish-actions.pod:3510 ../src/guestfs-actions.pod:5441 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:3492 ../src/guestfs-actions.pod:5419 +#: ../fish/guestfish-actions.pod:3513 ../src/guestfs-actions.pod:5444 msgid "C<sectorsize>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3494 ../src/guestfs-actions.pod:5421 +#: ../fish/guestfish-actions.pod:3515 ../src/guestfs-actions.pod:5446 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:3501 +#: ../fish/guestfish-actions.pod:3522 msgid "mkmountpoint" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3503 +#: ../fish/guestfish-actions.pod:3524 #, no-wrap msgid "" " mkmountpoint exemptpath\n" @@ -13381,14 +13425,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3505 +#: ../fish/guestfish-actions.pod:3526 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:3509 ../src/guestfs-actions.pod:5464 +#: ../fish/guestfish-actions.pod:3530 ../src/guestfs-actions.pod:5489 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 " @@ -13396,7 +13440,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3513 ../src/guestfs-actions.pod:5468 +#: ../fish/guestfish-actions.pod:3534 ../src/guestfs-actions.pod:5493 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 " @@ -13404,7 +13448,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3518 ../src/guestfs-actions.pod:5473 +#: ../fish/guestfish-actions.pod:3539 ../src/guestfs-actions.pod:5498 #, no-wrap msgid "" " add-ro Fedora-11-i686-Live.iso\n" @@ -13419,12 +13463,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3527 ../src/guestfs-actions.pod:5482 +#: ../fish/guestfish-actions.pod:3548 ../src/guestfs-actions.pod:5507 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3529 +#: ../fish/guestfish-actions.pod:3550 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 " @@ -13432,7 +13476,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3533 +#: ../fish/guestfish-actions.pod:3554 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 " @@ -13440,12 +13484,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3538 ../src/guestfs-actions.pod:5493 +#: ../fish/guestfish-actions.pod:3559 ../src/guestfs-actions.pod:5518 msgid "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3540 +#: ../fish/guestfish-actions.pod:3561 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 " @@ -13453,12 +13497,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3544 +#: ../fish/guestfish-actions.pod:3565 msgid "mknod" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3546 +#: ../fish/guestfish-actions.pod:3567 #, no-wrap msgid "" " mknod mode devmajor devminor path\n" @@ -13466,14 +13510,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3548 ../src/guestfs-actions.pod:5512 +#: ../fish/guestfish-actions.pod:3569 ../src/guestfs-actions.pod:5537 msgid "" "This call creates block or character special devices, or named pipes " "(FIFOs)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3551 ../src/guestfs-actions.pod:5515 +#: ../fish/guestfish-actions.pod:3572 ../src/guestfs-actions.pod:5540 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 " @@ -13481,7 +13525,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3556 +#: ../fish/guestfish-actions.pod:3577 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 " @@ -13492,12 +13536,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3566 +#: ../fish/guestfish-actions.pod:3587 msgid "mknod-b" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3568 +#: ../fish/guestfish-actions.pod:3589 #, no-wrap msgid "" " mknod-b mode devmajor devminor path\n" @@ -13505,7 +13549,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3570 +#: ../fish/guestfish-actions.pod:3591 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 " @@ -13513,12 +13557,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3576 +#: ../fish/guestfish-actions.pod:3597 msgid "mknod-c" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3578 +#: ../fish/guestfish-actions.pod:3599 #, no-wrap msgid "" " mknod-c mode devmajor devminor path\n" @@ -13526,7 +13570,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3580 +#: ../fish/guestfish-actions.pod:3601 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 " @@ -13534,12 +13578,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3586 +#: ../fish/guestfish-actions.pod:3607 msgid "mkswap" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3588 +#: ../fish/guestfish-actions.pod:3609 #, no-wrap msgid "" " mkswap device\n" @@ -13547,17 +13591,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3590 ../src/guestfs-actions.pod:5578 +#: ../fish/guestfish-actions.pod:3611 ../src/guestfs-actions.pod:5603 msgid "Create a swap partition on C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3592 +#: ../fish/guestfish-actions.pod:3613 msgid "mkswap-L" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3594 +#: ../fish/guestfish-actions.pod:3615 #, no-wrap msgid "" " mkswap-L label device\n" @@ -13565,12 +13609,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3596 ../src/guestfs-actions.pod:5591 +#: ../fish/guestfish-actions.pod:3617 ../src/guestfs-actions.pod:5616 msgid "Create a swap partition on C<device> with label C<label>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3598 ../src/guestfs-actions.pod:5593 +#: ../fish/guestfish-actions.pod:3619 ../src/guestfs-actions.pod:5618 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 " @@ -13578,12 +13622,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3602 +#: ../fish/guestfish-actions.pod:3623 msgid "mkswap-U" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3604 +#: ../fish/guestfish-actions.pod:3625 #, no-wrap msgid "" " mkswap-U uuid device\n" @@ -13591,17 +13635,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3606 ../src/guestfs-actions.pod:5608 +#: ../fish/guestfish-actions.pod:3627 ../src/guestfs-actions.pod:5633 msgid "Create a swap partition on C<device> with UUID C<uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3608 +#: ../fish/guestfish-actions.pod:3629 msgid "mkswap-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3610 +#: ../fish/guestfish-actions.pod:3631 #, no-wrap msgid "" " mkswap-file path\n" @@ -13609,24 +13653,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3612 ../src/guestfs-actions.pod:5620 +#: ../fish/guestfish-actions.pod:3633 ../src/guestfs-actions.pod:5645 msgid "Create a swap file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3614 +#: ../fish/guestfish-actions.pod:3635 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:3617 +#: ../fish/guestfish-actions.pod:3638 msgid "modprobe" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3619 +#: ../fish/guestfish-actions.pod:3640 #, no-wrap msgid "" " modprobe modulename\n" @@ -13634,24 +13678,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3621 ../src/guestfs-actions.pod:5635 +#: ../fish/guestfish-actions.pod:3642 ../src/guestfs-actions.pod:5660 msgid "This loads a kernel module in the appliance." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3623 ../src/guestfs-actions.pod:5637 +#: ../fish/guestfish-actions.pod:3644 ../src/guestfs-actions.pod:5662 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:3626 +#: ../fish/guestfish-actions.pod:3647 msgid "mount" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3628 +#: ../fish/guestfish-actions.pod:3649 #, no-wrap msgid "" " mount device mountpoint\n" @@ -13659,7 +13703,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3630 ../src/guestfs-actions.pod:5651 +#: ../fish/guestfish-actions.pod:3651 ../src/guestfs-actions.pod:5676 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 " @@ -13668,7 +13712,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3636 ../src/guestfs-actions.pod:5657 +#: ../fish/guestfish-actions.pod:3657 ../src/guestfs-actions.pod:5682 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 " @@ -13676,14 +13720,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3641 ../src/guestfs-actions.pod:5662 +#: ../fish/guestfish-actions.pod:3662 ../src/guestfs-actions.pod:5687 msgid "" "The mounted filesystem is writable, if we have sufficient permissions on the " "underlying device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3644 +#: ../fish/guestfish-actions.pod:3665 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 " @@ -13693,12 +13737,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3651 +#: ../fish/guestfish-actions.pod:3672 msgid "mount-9p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3653 +#: ../fish/guestfish-actions.pod:3674 #, no-wrap msgid "" " mount-9p mounttag mountpoint [options:..]\n" @@ -13706,14 +13750,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3655 ../src/guestfs-actions.pod:5691 +#: ../fish/guestfish-actions.pod:3676 ../src/guestfs-actions.pod:5716 msgid "" "Mount the virtio-9p filesystem with the tag C<mounttag> on the directory " "C<mountpoint>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3658 ../src/guestfs-actions.pod:5694 +#: ../fish/guestfish-actions.pod:3679 ../src/guestfs-actions.pod:5719 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> " @@ -13721,12 +13765,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3664 +#: ../fish/guestfish-actions.pod:3685 msgid "mount-loop" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3666 +#: ../fish/guestfish-actions.pod:3687 #, no-wrap msgid "" " mount-loop file mountpoint\n" @@ -13734,7 +13778,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3668 ../src/guestfs-actions.pod:5733 +#: ../fish/guestfish-actions.pod:3689 ../src/guestfs-actions.pod:5758 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 " @@ -13742,12 +13786,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3672 +#: ../fish/guestfish-actions.pod:3693 msgid "mount-options" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3674 +#: ../fish/guestfish-actions.pod:3695 #, no-wrap msgid "" " mount-options options device mountpoint\n" @@ -13755,26 +13799,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3676 +#: ../fish/guestfish-actions.pod:3697 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:3680 ../src/guestfs-actions.pod:5753 +#: ../fish/guestfish-actions.pod:3701 ../src/guestfs-actions.pod:5778 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:3684 +#: ../fish/guestfish-actions.pod:3705 msgid "mount-ro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3686 +#: ../fish/guestfish-actions.pod:3707 #, no-wrap msgid "" " mount-ro device mountpoint\n" @@ -13782,19 +13826,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3688 +#: ../fish/guestfish-actions.pod:3709 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:3691 +#: ../fish/guestfish-actions.pod:3712 msgid "mount-vfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3693 +#: ../fish/guestfish-actions.pod:3714 #, no-wrap msgid "" " mount-vfs options vfstype device mountpoint\n" @@ -13802,19 +13846,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3695 +#: ../fish/guestfish-actions.pod:3716 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:3699 +#: ../fish/guestfish-actions.pod:3720 msgid "mountpoints" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3701 +#: ../fish/guestfish-actions.pod:3722 #, no-wrap msgid "" " mountpoints\n" @@ -13822,7 +13866,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3703 +#: ../fish/guestfish-actions.pod:3724 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 " @@ -13830,12 +13874,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3707 +#: ../fish/guestfish-actions.pod:3728 msgid "mounts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3709 +#: ../fish/guestfish-actions.pod:3730 #, no-wrap msgid "" " mounts\n" @@ -13843,29 +13887,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3711 ../src/guestfs-actions.pod:5814 +#: ../fish/guestfish-actions.pod:3732 ../src/guestfs-actions.pod:5839 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:3714 ../src/guestfs-actions.pod:5817 +#: ../fish/guestfish-actions.pod:3735 ../src/guestfs-actions.pod:5842 msgid "Some internal mounts are not shown." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3716 +#: ../fish/guestfish-actions.pod:3737 msgid "See also: L</mountpoints>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3718 +#: ../fish/guestfish-actions.pod:3739 msgid "mv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3720 +#: ../fish/guestfish-actions.pod:3741 #, no-wrap msgid "" " mv src dest\n" @@ -13873,19 +13917,47 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3722 ../src/guestfs-actions.pod:5834 +#: ../fish/guestfish-actions.pod:3743 ../src/guestfs-actions.pod:5859 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:3725 +#: ../fish/guestfish-actions.pod:3746 +msgid "nr-devices" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:3748 +#, no-wrap +msgid "" +" nr-devices\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3750 +msgid "" +"This returns the number of whole block devices that were added. This is the " +"same as the number of devices that would be returned if you called " +"L</list-devices>." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3754 +msgid "" +"To find out the maximum number of devices that could be added, call " +"L</max-disks>." +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:3757 msgid "ntfs-3g-probe" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3727 +#: ../fish/guestfish-actions.pod:3759 #, no-wrap msgid "" " ntfs-3g-probe true|false device\n" @@ -13893,7 +13965,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3729 ../src/guestfs-actions.pod:5848 +#: ../fish/guestfish-actions.pod:3761 ../src/guestfs-actions.pod:5887 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 " @@ -13901,7 +13973,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3733 ../src/guestfs-actions.pod:5852 +#: ../fish/guestfish-actions.pod:3765 ../src/guestfs-actions.pod:5891 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 " @@ -13909,19 +13981,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3737 ../src/guestfs-actions.pod:5856 +#: ../fish/guestfish-actions.pod:3769 ../src/guestfs-actions.pod:5895 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:3741 +#: ../fish/guestfish-actions.pod:3773 msgid "ntfsresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3743 +#: ../fish/guestfish-actions.pod:3775 #, no-wrap msgid "" " ntfsresize device\n" @@ -13929,14 +14001,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3745 ../fish/guestfish-actions.pod:3769 ../src/guestfs-actions.pod:5877 ../src/guestfs-actions.pod:5909 +#: ../fish/guestfish-actions.pod:3777 ../fish/guestfish-actions.pod:3801 ../src/guestfs-actions.pod:5916 ../src/guestfs-actions.pod:5948 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:3748 ../src/guestfs-actions.pod:5880 +#: ../fish/guestfish-actions.pod:3780 ../src/guestfs-actions.pod:5919 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 " @@ -13947,24 +14019,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3756 ../fish/guestfish-actions.pod:3795 ../src/guestfs-actions.pod:5888 ../src/guestfs-actions.pod:5935 +#: ../fish/guestfish-actions.pod:3788 ../fish/guestfish-actions.pod:3827 ../src/guestfs-actions.pod:5927 ../src/guestfs-actions.pod:5974 msgid "See also L<ntfsresize(8)>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3758 ../fish/guestfish-actions.pod:3806 +#: ../fish/guestfish-actions.pod:3790 ../fish/guestfish-actions.pod:3838 msgid "" "I<This function is deprecated.> In new code, use the L</ntfsresize_opts> " "call instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3765 +#: ../fish/guestfish-actions.pod:3797 msgid "ntfsresize-opts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3767 +#: ../fish/guestfish-actions.pod:3799 #, no-wrap msgid "" " ntfsresize-opts device [size:N] [force:true|false]\n" @@ -13972,26 +14044,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3778 ../src/guestfs-actions.pod:5918 +#: ../fish/guestfish-actions.pod:3810 ../src/guestfs-actions.pod:5957 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:3781 ../fish/guestfish-actions.pod:5104 ../src/guestfs-actions.pod:5921 ../src/guestfs-actions.pod:7894 +#: ../fish/guestfish-actions.pod:3813 ../fish/guestfish-actions.pod:5156 ../src/guestfs-actions.pod:5960 ../src/guestfs-actions.pod:7956 msgid "C<force>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3783 ../src/guestfs-actions.pod:5923 +#: ../fish/guestfish-actions.pod:3815 ../src/guestfs-actions.pod:5962 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:3786 +#: ../fish/guestfish-actions.pod:3818 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 " @@ -14001,12 +14073,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3799 +#: ../fish/guestfish-actions.pod:3831 msgid "ntfsresize-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3801 +#: ../fish/guestfish-actions.pod:3833 #, no-wrap msgid "" " ntfsresize-size device size\n" @@ -14014,19 +14086,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3803 +#: ../fish/guestfish-actions.pod:3835 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:3813 +#: ../fish/guestfish-actions.pod:3845 msgid "part-add" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3815 +#: ../fish/guestfish-actions.pod:3847 #, no-wrap msgid "" " part-add device prlogex startsect endsect\n" @@ -14034,14 +14106,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3817 +#: ../fish/guestfish-actions.pod:3849 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:3820 ../src/guestfs-actions.pod:5996 +#: ../fish/guestfish-actions.pod:3852 ../src/guestfs-actions.pod:6035 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 " @@ -14049,7 +14121,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3825 ../src/guestfs-actions.pod:6001 +#: ../fish/guestfish-actions.pod:3857 ../src/guestfs-actions.pod:6040 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 " @@ -14057,19 +14129,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3829 +#: ../fish/guestfish-actions.pod:3861 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:3832 +#: ../fish/guestfish-actions.pod:3864 msgid "part-del" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3834 +#: ../fish/guestfish-actions.pod:3866 #, no-wrap msgid "" " part-del device partnum\n" @@ -14077,24 +14149,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3836 ../src/guestfs-actions.pod:6019 +#: ../fish/guestfish-actions.pod:3868 ../src/guestfs-actions.pod:6058 msgid "This command deletes the partition numbered C<partnum> on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3838 ../src/guestfs-actions.pod:6021 +#: ../fish/guestfish-actions.pod:3870 ../src/guestfs-actions.pod:6060 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:3842 +#: ../fish/guestfish-actions.pod:3874 msgid "part-disk" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3844 +#: ../fish/guestfish-actions.pod:3876 #, no-wrap msgid "" " part-disk device parttype\n" @@ -14102,26 +14174,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3846 +#: ../fish/guestfish-actions.pod:3878 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:3850 +#: ../fish/guestfish-actions.pod:3882 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:3853 +#: ../fish/guestfish-actions.pod:3885 msgid "part-get-bootable" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3855 +#: ../fish/guestfish-actions.pod:3887 #, no-wrap msgid "" " part-get-bootable device partnum\n" @@ -14129,24 +14201,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3857 ../src/guestfs-actions.pod:6054 +#: ../fish/guestfish-actions.pod:3889 ../src/guestfs-actions.pod:6093 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:3860 +#: ../fish/guestfish-actions.pod:3892 msgid "See also L</part-set-bootable>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3862 +#: ../fish/guestfish-actions.pod:3894 msgid "part-get-mbr-id" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3864 +#: ../fish/guestfish-actions.pod:3896 #, no-wrap msgid "" " part-get-mbr-id device partnum\n" @@ -14154,14 +14226,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3866 ../src/guestfs-actions.pod:6070 +#: ../fish/guestfish-actions.pod:3898 ../src/guestfs-actions.pod:6109 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:3869 ../fish/guestfish-actions.pod:4013 +#: ../fish/guestfish-actions.pod:3901 ../fish/guestfish-actions.pod:4045 msgid "" "Note that only MBR (old DOS-style) partitions have type bytes. You will get " "undefined results for other partition table types (see " @@ -14169,12 +14241,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3873 +#: ../fish/guestfish-actions.pod:3905 msgid "part-get-parttype" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3875 +#: ../fish/guestfish-actions.pod:3907 #, no-wrap msgid "" " part-get-parttype device\n" @@ -14182,14 +14254,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3877 ../src/guestfs-actions.pod:6087 +#: ../fish/guestfish-actions.pod:3909 ../src/guestfs-actions.pod:6126 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:3880 +#: ../fish/guestfish-actions.pod:3912 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 " @@ -14197,12 +14269,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3885 +#: ../fish/guestfish-actions.pod:3917 msgid "part-init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3887 +#: ../fish/guestfish-actions.pod:3919 #, no-wrap msgid "" " part-init device parttype\n" @@ -14210,7 +14282,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3889 ../src/guestfs-actions.pod:6107 +#: ../fish/guestfish-actions.pod:3921 ../src/guestfs-actions.pod:6146 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> " @@ -14218,34 +14290,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3893 +#: ../fish/guestfish-actions.pod:3925 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:3896 ../src/guestfs-actions.pod:6114 +#: ../fish/guestfish-actions.pod:3928 ../src/guestfs-actions.pod:6153 msgid "Possible values for C<parttype> are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3900 ../src/guestfs-actions.pod:6118 +#: ../fish/guestfish-actions.pod:3932 ../src/guestfs-actions.pod:6157 msgid "B<efi>" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3902 ../src/guestfs-actions.pod:6120 +#: ../fish/guestfish-actions.pod:3934 ../src/guestfs-actions.pod:6159 msgid "B<gpt>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3904 ../src/guestfs-actions.pod:6122 +#: ../fish/guestfish-actions.pod:3936 ../src/guestfs-actions.pod:6161 msgid "Intel EFI / GPT partition table." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3906 ../src/guestfs-actions.pod:6124 +#: ../fish/guestfish-actions.pod:3938 ../src/guestfs-actions.pod:6163 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 " @@ -14253,17 +14325,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3910 ../src/guestfs-actions.pod:6128 +#: ../fish/guestfish-actions.pod:3942 ../src/guestfs-actions.pod:6167 msgid "B<mbr>" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3912 ../src/guestfs-actions.pod:6130 +#: ../fish/guestfish-actions.pod:3944 ../src/guestfs-actions.pod:6169 msgid "B<msdos>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3914 ../src/guestfs-actions.pod:6132 +#: ../fish/guestfish-actions.pod:3946 ../src/guestfs-actions.pod:6171 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 " @@ -14271,102 +14343,102 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3921 ../src/guestfs-actions.pod:6139 +#: ../fish/guestfish-actions.pod:3953 ../src/guestfs-actions.pod:6178 msgid "Other partition table types that may work but are not supported include:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3926 ../src/guestfs-actions.pod:6144 +#: ../fish/guestfish-actions.pod:3958 ../src/guestfs-actions.pod:6183 msgid "B<aix>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3928 ../src/guestfs-actions.pod:6146 +#: ../fish/guestfish-actions.pod:3960 ../src/guestfs-actions.pod:6185 msgid "AIX disk labels." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3930 ../src/guestfs-actions.pod:6148 +#: ../fish/guestfish-actions.pod:3962 ../src/guestfs-actions.pod:6187 msgid "B<amiga>" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3932 ../src/guestfs-actions.pod:6150 +#: ../fish/guestfish-actions.pod:3964 ../src/guestfs-actions.pod:6189 msgid "B<rdb>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3934 ../src/guestfs-actions.pod:6152 +#: ../fish/guestfish-actions.pod:3966 ../src/guestfs-actions.pod:6191 msgid "Amiga \"Rigid Disk Block\" format." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3936 ../src/guestfs-actions.pod:6154 +#: ../fish/guestfish-actions.pod:3968 ../src/guestfs-actions.pod:6193 msgid "B<bsd>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3938 ../src/guestfs-actions.pod:6156 +#: ../fish/guestfish-actions.pod:3970 ../src/guestfs-actions.pod:6195 msgid "BSD disk labels." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3940 ../src/guestfs-actions.pod:6158 +#: ../fish/guestfish-actions.pod:3972 ../src/guestfs-actions.pod:6197 msgid "B<dasd>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3942 ../src/guestfs-actions.pod:6160 +#: ../fish/guestfish-actions.pod:3974 ../src/guestfs-actions.pod:6199 msgid "DASD, used on IBM mainframes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3944 ../src/guestfs-actions.pod:6162 +#: ../fish/guestfish-actions.pod:3976 ../src/guestfs-actions.pod:6201 msgid "B<dvh>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3946 ../src/guestfs-actions.pod:6164 +#: ../fish/guestfish-actions.pod:3978 ../src/guestfs-actions.pod:6203 msgid "MIPS/SGI volumes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3948 ../src/guestfs-actions.pod:6166 +#: ../fish/guestfish-actions.pod:3980 ../src/guestfs-actions.pod:6205 msgid "B<mac>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3950 ../src/guestfs-actions.pod:6168 +#: ../fish/guestfish-actions.pod:3982 ../src/guestfs-actions.pod:6207 msgid "Old Mac partition format. Modern Macs use C<gpt>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3952 ../src/guestfs-actions.pod:6170 +#: ../fish/guestfish-actions.pod:3984 ../src/guestfs-actions.pod:6209 msgid "B<pc98>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3954 ../src/guestfs-actions.pod:6172 +#: ../fish/guestfish-actions.pod:3986 ../src/guestfs-actions.pod:6211 msgid "NEC PC-98 format, common in Japan apparently." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3956 ../src/guestfs-actions.pod:6174 +#: ../fish/guestfish-actions.pod:3988 ../src/guestfs-actions.pod:6213 msgid "B<sun>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3958 ../src/guestfs-actions.pod:6176 +#: ../fish/guestfish-actions.pod:3990 ../src/guestfs-actions.pod:6215 msgid "Sun disk labels." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3962 +#: ../fish/guestfish-actions.pod:3994 msgid "part-list" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3964 +#: ../fish/guestfish-actions.pod:3996 #, no-wrap msgid "" " part-list device\n" @@ -14374,66 +14446,66 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3966 ../src/guestfs-actions.pod:6190 +#: ../fish/guestfish-actions.pod:3998 ../src/guestfs-actions.pod:6229 msgid "" "This command parses the partition table on C<device> and returns the list of " "partitions found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3969 ../src/guestfs-actions.pod:6193 +#: ../fish/guestfish-actions.pod:4001 ../src/guestfs-actions.pod:6232 msgid "The fields in the returned structure are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3973 ../src/guestfs-actions.pod:6197 +#: ../fish/guestfish-actions.pod:4005 ../src/guestfs-actions.pod:6236 msgid "B<part_num>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3975 ../src/guestfs-actions.pod:6199 +#: ../fish/guestfish-actions.pod:4007 ../src/guestfs-actions.pod:6238 msgid "Partition number, counting from 1." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3977 ../src/guestfs-actions.pod:6201 +#: ../fish/guestfish-actions.pod:4009 ../src/guestfs-actions.pod:6240 msgid "B<part_start>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3979 +#: ../fish/guestfish-actions.pod:4011 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:3982 ../src/guestfs-actions.pod:6206 +#: ../fish/guestfish-actions.pod:4014 ../src/guestfs-actions.pod:6245 msgid "B<part_end>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3984 ../src/guestfs-actions.pod:6208 +#: ../fish/guestfish-actions.pod:4016 ../src/guestfs-actions.pod:6247 msgid "End of the partition in bytes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3986 ../src/guestfs-actions.pod:6210 +#: ../fish/guestfish-actions.pod:4018 ../src/guestfs-actions.pod:6249 msgid "B<part_size>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3988 ../src/guestfs-actions.pod:6212 +#: ../fish/guestfish-actions.pod:4020 ../src/guestfs-actions.pod:6251 msgid "Size of the partition in bytes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3992 +#: ../fish/guestfish-actions.pod:4024 msgid "part-set-bootable" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3994 +#: ../fish/guestfish-actions.pod:4026 #, no-wrap msgid "" " part-set-bootable device partnum true|false\n" @@ -14441,14 +14513,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3996 ../src/guestfs-actions.pod:6230 +#: ../fish/guestfish-actions.pod:4028 ../src/guestfs-actions.pod:6269 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:3999 ../src/guestfs-actions.pod:6233 +#: ../fish/guestfish-actions.pod:4031 ../src/guestfs-actions.pod:6272 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 " @@ -14456,12 +14528,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4003 +#: ../fish/guestfish-actions.pod:4035 msgid "part-set-mbr-id" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4005 +#: ../fish/guestfish-actions.pod:4037 #, no-wrap msgid "" " part-set-mbr-id device partnum idbyte\n" @@ -14469,7 +14541,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4007 ../src/guestfs-actions.pod:6249 +#: ../fish/guestfish-actions.pod:4039 ../src/guestfs-actions.pod:6288 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 " @@ -14478,12 +14550,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4017 +#: ../fish/guestfish-actions.pod:4049 msgid "part-set-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4019 +#: ../fish/guestfish-actions.pod:4051 #, no-wrap msgid "" " part-set-name device partnum name\n" @@ -14491,26 +14563,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4021 ../src/guestfs-actions.pod:6271 +#: ../fish/guestfish-actions.pod:4053 ../src/guestfs-actions.pod:6310 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:4024 ../src/guestfs-actions.pod:6274 +#: ../fish/guestfish-actions.pod:4056 ../src/guestfs-actions.pod:6313 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:4027 +#: ../fish/guestfish-actions.pod:4059 msgid "part-to-dev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4029 +#: ../fish/guestfish-actions.pod:4061 #, no-wrap msgid "" " part-to-dev partition\n" @@ -14518,31 +14590,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4031 ../src/guestfs-actions.pod:6287 +#: ../fish/guestfish-actions.pod:4063 ../src/guestfs-actions.pod:6326 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:4035 ../fish/guestfish-actions.pod:4047 +#: ../fish/guestfish-actions.pod:4067 ../fish/guestfish-actions.pod:4079 msgid "" "The named partition must exist, for example as a string returned from " "L</list-partitions>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4038 -msgid "See also L</part-to-partnum>." +#: ../fish/guestfish-actions.pod:4070 +msgid "See also L</part-to-partnum>, L</device-index>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4040 +#: ../fish/guestfish-actions.pod:4072 msgid "part-to-partnum" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4042 +#: ../fish/guestfish-actions.pod:4074 #, no-wrap msgid "" " part-to-partnum partition\n" @@ -14550,24 +14622,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4044 ../src/guestfs-actions.pod:6307 +#: ../fish/guestfish-actions.pod:4076 ../src/guestfs-actions.pod:6346 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:4050 +#: ../fish/guestfish-actions.pod:4082 msgid "See also L</part-to-dev>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4052 +#: ../fish/guestfish-actions.pod:4084 msgid "ping-daemon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4054 +#: ../fish/guestfish-actions.pod:4086 #, no-wrap msgid "" " ping-daemon\n" @@ -14575,7 +14647,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4056 ../src/guestfs-actions.pod:6324 +#: ../fish/guestfish-actions.pod:4088 ../src/guestfs-actions.pod:6363 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 " @@ -14584,12 +14656,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4061 +#: ../fish/guestfish-actions.pod:4093 msgid "pread" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4063 +#: ../fish/guestfish-actions.pod:4095 #, no-wrap msgid "" " pread path count offset\n" @@ -14597,31 +14669,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4065 ../src/guestfs-actions.pod:6342 +#: ../fish/guestfish-actions.pod:4097 ../src/guestfs-actions.pod:6381 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:4068 ../fish/guestfish-actions.pod:4083 ../src/guestfs-actions.pod:6345 ../src/guestfs-actions.pod:6371 +#: ../fish/guestfish-actions.pod:4100 ../fish/guestfish-actions.pod:4115 ../src/guestfs-actions.pod:6384 ../src/guestfs-actions.pod:6410 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:4071 +#: ../fish/guestfish-actions.pod:4103 msgid "See also L</pwrite>, L</pread-device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4076 +#: ../fish/guestfish-actions.pod:4108 msgid "pread-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4078 +#: ../fish/guestfish-actions.pod:4110 #, no-wrap msgid "" " pread-device device count offset\n" @@ -14629,24 +14701,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4080 ../src/guestfs-actions.pod:6368 +#: ../fish/guestfish-actions.pod:4112 ../src/guestfs-actions.pod:6407 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:4086 +#: ../fish/guestfish-actions.pod:4118 msgid "See also L</pread>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4091 +#: ../fish/guestfish-actions.pod:4123 msgid "pvcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4093 +#: ../fish/guestfish-actions.pod:4125 #, no-wrap msgid "" " pvcreate device\n" @@ -14654,19 +14726,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4095 ../src/guestfs-actions.pod:6391 +#: ../fish/guestfish-actions.pod:4127 ../src/guestfs-actions.pod:6430 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:4099 +#: ../fish/guestfish-actions.pod:4131 msgid "pvremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4101 +#: ../fish/guestfish-actions.pod:4133 #, no-wrap msgid "" " pvremove device\n" @@ -14674,14 +14746,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4103 ../src/guestfs-actions.pod:6405 +#: ../fish/guestfish-actions.pod:4135 ../src/guestfs-actions.pod:6444 msgid "" "This wipes a physical volume C<device> so that LVM will no longer recognise " "it." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4106 ../src/guestfs-actions.pod:6408 +#: ../fish/guestfish-actions.pod:4138 ../src/guestfs-actions.pod:6447 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 " @@ -14689,12 +14761,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4110 +#: ../fish/guestfish-actions.pod:4142 msgid "pvresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4112 +#: ../fish/guestfish-actions.pod:4144 #, no-wrap msgid "" " pvresize device\n" @@ -14702,19 +14774,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4114 ../src/guestfs-actions.pod:6422 +#: ../fish/guestfish-actions.pod:4146 ../src/guestfs-actions.pod:6461 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:4117 +#: ../fish/guestfish-actions.pod:4149 msgid "pvresize-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4119 +#: ../fish/guestfish-actions.pod:4151 #, no-wrap msgid "" " pvresize-size device size\n" @@ -14722,19 +14794,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4121 +#: ../fish/guestfish-actions.pod:4153 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:4124 +#: ../fish/guestfish-actions.pod:4156 msgid "pvs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4126 +#: ../fish/guestfish-actions.pod:4158 #, no-wrap msgid "" " pvs\n" @@ -14742,31 +14814,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4128 ../src/guestfs-actions.pod:6448 +#: ../fish/guestfish-actions.pod:4160 ../src/guestfs-actions.pod:6487 msgid "" "List all the physical volumes detected. This is the equivalent of the " "L<pvs(8)> command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4131 ../src/guestfs-actions.pod:6451 +#: ../fish/guestfish-actions.pod:4163 ../src/guestfs-actions.pod:6490 msgid "" "This returns a list of just the device names that contain PVs " "(eg. C</dev/sda2>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4134 +#: ../fish/guestfish-actions.pod:4166 msgid "See also L</pvs-full>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4136 +#: ../fish/guestfish-actions.pod:4168 msgid "pvs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4138 +#: ../fish/guestfish-actions.pod:4170 #, no-wrap msgid "" " pvs-full\n" @@ -14774,19 +14846,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4140 ../src/guestfs-actions.pod:6467 +#: ../fish/guestfish-actions.pod:4172 ../src/guestfs-actions.pod:6506 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:4143 +#: ../fish/guestfish-actions.pod:4175 msgid "pvuuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4145 +#: ../fish/guestfish-actions.pod:4177 #, no-wrap msgid "" " pvuuid device\n" @@ -14794,17 +14866,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4147 ../src/guestfs-actions.pod:6482 +#: ../fish/guestfish-actions.pod:4179 ../src/guestfs-actions.pod:6521 msgid "This command returns the UUID of the LVM PV C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4149 +#: ../fish/guestfish-actions.pod:4181 msgid "pwrite" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4151 +#: ../fish/guestfish-actions.pod:4183 #, no-wrap msgid "" " pwrite path content offset\n" @@ -14812,14 +14884,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4153 ../src/guestfs-actions.pod:6498 +#: ../fish/guestfish-actions.pod:4185 ../src/guestfs-actions.pod:6537 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:4156 ../src/guestfs-actions.pod:6501 +#: ../fish/guestfish-actions.pod:4188 ../src/guestfs-actions.pod:6540 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 " @@ -14829,17 +14901,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4162 +#: ../fish/guestfish-actions.pod:4194 msgid "See also L</pread>, L</pwrite-device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4167 +#: ../fish/guestfish-actions.pod:4199 msgid "pwrite-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4169 +#: ../fish/guestfish-actions.pod:4201 #, no-wrap msgid "" " pwrite-device device content offset\n" @@ -14847,14 +14919,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4171 ../src/guestfs-actions.pod:6525 +#: ../fish/guestfish-actions.pod:4203 ../src/guestfs-actions.pod:6564 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:4174 ../src/guestfs-actions.pod:6528 +#: ../fish/guestfish-actions.pod:4206 ../src/guestfs-actions.pod:6567 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 " @@ -14862,17 +14934,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4179 +#: ../fish/guestfish-actions.pod:4211 msgid "See also L</pwrite>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4184 +#: ../fish/guestfish-actions.pod:4216 msgid "read-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4186 +#: ../fish/guestfish-actions.pod:4218 #, no-wrap msgid "" " read-file path\n" @@ -14880,12 +14952,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4188 ../src/guestfs-actions.pod:6549 +#: ../fish/guestfish-actions.pod:4220 ../src/guestfs-actions.pod:6588 msgid "This calls returns the contents of the file C<path> as a buffer." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4191 +#: ../fish/guestfish-actions.pod:4223 msgid "" "Unlike L</cat>, this function can correctly handle files that contain " "embedded ASCII NUL characters. However unlike L</download>, this function " @@ -14893,12 +14965,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4199 +#: ../fish/guestfish-actions.pod:4231 msgid "read-lines" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4201 +#: ../fish/guestfish-actions.pod:4233 #, no-wrap msgid "" " read-lines path\n" @@ -14906,14 +14978,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4205 ../src/guestfs-actions.pod:6574 +#: ../fish/guestfish-actions.pod:4237 ../src/guestfs-actions.pod:6613 msgid "" "The file contents are returned as a list of lines. Trailing C<LF> and " "C<CRLF> character sequences are I<not> returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4208 +#: ../fish/guestfish-actions.pod:4240 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of line). For " @@ -14922,12 +14994,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4213 +#: ../fish/guestfish-actions.pod:4245 msgid "readdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4215 +#: ../fish/guestfish-actions.pod:4247 #, no-wrap msgid "" " readdir dir\n" @@ -14935,12 +15007,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4217 ../src/guestfs-actions.pod:6594 +#: ../fish/guestfish-actions.pod:4249 ../src/guestfs-actions.pod:6633 msgid "This returns the list of directory entries in directory C<dir>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4219 ../src/guestfs-actions.pod:6596 +#: ../fish/guestfish-actions.pod:4251 ../src/guestfs-actions.pod:6635 msgid "" "All entries in the directory are returned, including C<.> and C<..>. The " "entries are I<not> sorted, but returned in the same order as the underlying " @@ -14948,104 +15020,104 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4223 ../src/guestfs-actions.pod:6600 +#: ../fish/guestfish-actions.pod:4255 ../src/guestfs-actions.pod:6639 msgid "" "Also this call returns basic file type information about each file. The " "C<ftyp> field will contain one of the following characters:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4228 ../src/guestfs-actions.pod:6605 +#: ../fish/guestfish-actions.pod:4260 ../src/guestfs-actions.pod:6644 msgid "'b'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4230 ../src/guestfs-actions.pod:6607 +#: ../fish/guestfish-actions.pod:4262 ../src/guestfs-actions.pod:6646 msgid "Block special" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4232 ../src/guestfs-actions.pod:6609 +#: ../fish/guestfish-actions.pod:4264 ../src/guestfs-actions.pod:6648 msgid "'c'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4234 ../src/guestfs-actions.pod:6611 +#: ../fish/guestfish-actions.pod:4266 ../src/guestfs-actions.pod:6650 msgid "Char special" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4236 ../src/guestfs-actions.pod:6613 +#: ../fish/guestfish-actions.pod:4268 ../src/guestfs-actions.pod:6652 msgid "'d'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4238 ../src/guestfs-actions.pod:6615 +#: ../fish/guestfish-actions.pod:4270 ../src/guestfs-actions.pod:6654 msgid "Directory" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4240 ../src/guestfs-actions.pod:6617 +#: ../fish/guestfish-actions.pod:4272 ../src/guestfs-actions.pod:6656 msgid "'f'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4242 ../src/guestfs-actions.pod:6619 +#: ../fish/guestfish-actions.pod:4274 ../src/guestfs-actions.pod:6658 msgid "FIFO (named pipe)" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4244 ../src/guestfs-actions.pod:6621 +#: ../fish/guestfish-actions.pod:4276 ../src/guestfs-actions.pod:6660 msgid "'l'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4246 ../src/guestfs-actions.pod:6623 +#: ../fish/guestfish-actions.pod:4278 ../src/guestfs-actions.pod:6662 msgid "Symbolic link" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4248 ../src/guestfs-actions.pod:6625 +#: ../fish/guestfish-actions.pod:4280 ../src/guestfs-actions.pod:6664 msgid "'r'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4250 ../src/guestfs-actions.pod:6627 +#: ../fish/guestfish-actions.pod:4282 ../src/guestfs-actions.pod:6666 msgid "Regular file" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4252 ../src/guestfs-actions.pod:6629 +#: ../fish/guestfish-actions.pod:4284 ../src/guestfs-actions.pod:6668 msgid "'s'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4254 ../src/guestfs-actions.pod:6631 +#: ../fish/guestfish-actions.pod:4286 ../src/guestfs-actions.pod:6670 msgid "Socket" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4256 ../src/guestfs-actions.pod:6633 +#: ../fish/guestfish-actions.pod:4288 ../src/guestfs-actions.pod:6672 msgid "'u'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4258 ../src/guestfs-actions.pod:6635 +#: ../fish/guestfish-actions.pod:4290 ../src/guestfs-actions.pod:6674 msgid "Unknown file type" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4260 ../src/guestfs-actions.pod:6637 +#: ../fish/guestfish-actions.pod:4292 ../src/guestfs-actions.pod:6676 msgid "'?'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4262 ../src/guestfs-actions.pod:6639 +#: ../fish/guestfish-actions.pod:4294 ../src/guestfs-actions.pod:6678 msgid "The L<readdir(3)> call returned a C<d_type> field with an unexpected value" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4267 +#: ../fish/guestfish-actions.pod:4299 msgid "" "This function is primarily intended for use by programs. To get a simple " "list of names, use L</ls>. To get a printable directory for human " @@ -15053,12 +15125,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4271 +#: ../fish/guestfish-actions.pod:4303 msgid "readlink" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4273 +#: ../fish/guestfish-actions.pod:4305 #, no-wrap msgid "" " readlink path\n" @@ -15066,17 +15138,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4275 ../src/guestfs-actions.pod:6660 +#: ../fish/guestfish-actions.pod:4307 ../src/guestfs-actions.pod:6699 msgid "This command reads the target of a symbolic link." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4277 +#: ../fish/guestfish-actions.pod:4309 msgid "readlinklist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4279 +#: ../fish/guestfish-actions.pod:4311 #, no-wrap msgid "" " readlinklist path 'names ...'\n" @@ -15084,7 +15156,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4281 ../src/guestfs-actions.pod:6674 +#: ../fish/guestfish-actions.pod:4313 ../src/guestfs-actions.pod:6713 msgid "" "This call allows you to do a C<readlink> operation on multiple files, where " "all files are in the directory C<path>. C<names> is the list of files from " @@ -15092,14 +15164,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4285 ../src/guestfs-actions.pod:6678 +#: ../fish/guestfish-actions.pod:4317 ../src/guestfs-actions.pod:6717 msgid "" "On return you get a list of strings, with a one-to-one correspondence to the " "C<names> list. Each string is the value of the symbolic link." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4289 ../src/guestfs-actions.pod:6682 +#: ../fish/guestfish-actions.pod:4321 ../src/guestfs-actions.pod:6721 msgid "" "If the C<readlink(2)> operation fails on any name, then the corresponding " "result string is the empty string C<\"\">. However the whole operation is " @@ -15109,7 +15181,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4296 ../src/guestfs-actions.pod:6689 +#: ../fish/guestfish-actions.pod:4328 ../src/guestfs-actions.pod:6728 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. Very long directory listings " @@ -15118,12 +15190,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4303 +#: ../fish/guestfish-actions.pod:4335 msgid "realpath" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4305 +#: ../fish/guestfish-actions.pod:4337 #, no-wrap msgid "" " realpath path\n" @@ -15131,19 +15203,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4307 ../src/guestfs-actions.pod:6708 +#: ../fish/guestfish-actions.pod:4339 ../src/guestfs-actions.pod:6747 msgid "" "Return the canonicalized absolute pathname of C<path>. The returned path " "has no C<.>, C<..> or symbolic link path elements." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4310 +#: ../fish/guestfish-actions.pod:4342 msgid "removexattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4312 +#: ../fish/guestfish-actions.pod:4344 #, no-wrap msgid "" " removexattr xattr path\n" @@ -15151,22 +15223,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4314 ../src/guestfs-actions.pod:6723 +#: ../fish/guestfish-actions.pod:4346 ../src/guestfs-actions.pod:6762 msgid "This call removes the extended attribute named C<xattr> of the file C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4317 +#: ../fish/guestfish-actions.pod:4349 msgid "See also: L</lremovexattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4319 +#: ../fish/guestfish-actions.pod:4351 msgid "resize2fs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4321 +#: ../fish/guestfish-actions.pod:4353 #, no-wrap msgid "" " resize2fs device\n" @@ -15174,14 +15246,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4323 ../src/guestfs-actions.pod:6738 +#: ../fish/guestfish-actions.pod:4355 ../src/guestfs-actions.pod:6777 msgid "" "This resizes an ext2, ext3 or ext4 filesystem to match the size of the " "underlying device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4326 +#: ../fish/guestfish-actions.pod:4358 msgid "" "I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> " "before calling this command. For unknown reasons C<resize2fs> sometimes " @@ -15190,12 +15262,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4332 +#: ../fish/guestfish-actions.pod:4364 msgid "resize2fs-M" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4334 +#: ../fish/guestfish-actions.pod:4366 #, no-wrap msgid "" " resize2fs-M device\n" @@ -15203,7 +15275,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4336 +#: ../fish/guestfish-actions.pod:4368 msgid "" "This command is the same as L</resize2fs>, but the filesystem is resized to " "its minimum size. This works like the I<-M> option to the C<resize2fs> " @@ -15211,7 +15283,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4340 +#: ../fish/guestfish-actions.pod:4372 msgid "" "To get the resulting size of the filesystem you should call L</tune2fs-l> " "and read the C<Block size> and C<Block count> values. These two numbers, " @@ -15220,12 +15292,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4345 +#: ../fish/guestfish-actions.pod:4377 msgid "resize2fs-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4347 +#: ../fish/guestfish-actions.pod:4379 #, no-wrap msgid "" " resize2fs-size device size\n" @@ -15233,19 +15305,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4349 +#: ../fish/guestfish-actions.pod:4381 msgid "" "This command is the same as L</resize2fs> except that it allows you to " "specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4352 +#: ../fish/guestfish-actions.pod:4384 msgid "rm" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4354 +#: ../fish/guestfish-actions.pod:4386 #, no-wrap msgid "" " rm path\n" @@ -15253,17 +15325,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4356 ../src/guestfs-actions.pod:6790 +#: ../fish/guestfish-actions.pod:4388 ../src/guestfs-actions.pod:6829 msgid "Remove the single file C<path>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4358 +#: ../fish/guestfish-actions.pod:4390 msgid "rm-rf" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4360 +#: ../fish/guestfish-actions.pod:4392 #, no-wrap msgid "" " rm-rf path\n" @@ -15271,19 +15343,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4362 ../src/guestfs-actions.pod:6802 +#: ../fish/guestfish-actions.pod:4394 ../src/guestfs-actions.pod:6841 msgid "" "Remove the file or directory C<path>, recursively removing the contents if " "its a directory. This is like the C<rm -rf> shell command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4366 +#: ../fish/guestfish-actions.pod:4398 msgid "rmdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4368 +#: ../fish/guestfish-actions.pod:4400 #, no-wrap msgid "" " rmdir path\n" @@ -15291,17 +15363,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4370 ../src/guestfs-actions.pod:6816 +#: ../fish/guestfish-actions.pod:4402 ../src/guestfs-actions.pod:6855 msgid "Remove the single directory C<path>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4372 +#: ../fish/guestfish-actions.pod:4404 msgid "rmmountpoint" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4374 +#: ../fish/guestfish-actions.pod:4406 #, no-wrap msgid "" " rmmountpoint exemptpath\n" @@ -15309,19 +15381,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4376 +#: ../fish/guestfish-actions.pod:4408 msgid "" "This calls removes a mountpoint that was previously created with " "L</mkmountpoint>. See L</mkmountpoint> for full details." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4380 +#: ../fish/guestfish-actions.pod:4412 msgid "scrub-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4382 +#: ../fish/guestfish-actions.pod:4414 #, no-wrap msgid "" " scrub-device device\n" @@ -15329,26 +15401,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4384 ../src/guestfs-actions.pod:6842 +#: ../fish/guestfish-actions.pod:4416 ../src/guestfs-actions.pod:6881 msgid "" "This command writes patterns over C<device> to make data retrieval more " "difficult." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4387 ../fish/guestfish-actions.pod:4399 ../fish/guestfish-actions.pod:4412 ../src/guestfs-actions.pod:6845 ../src/guestfs-actions.pod:6863 ../src/guestfs-actions.pod:6882 +#: ../fish/guestfish-actions.pod:4419 ../fish/guestfish-actions.pod:4431 ../fish/guestfish-actions.pod:4444 ../src/guestfs-actions.pod:6884 ../src/guestfs-actions.pod:6902 ../src/guestfs-actions.pod:6921 msgid "" "It is an interface to the L<scrub(1)> program. See that manual page for " "more details." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4390 +#: ../fish/guestfish-actions.pod:4422 msgid "scrub-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4392 +#: ../fish/guestfish-actions.pod:4424 #, no-wrap msgid "" " scrub-file file\n" @@ -15356,24 +15428,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4394 ../src/guestfs-actions.pod:6858 +#: ../fish/guestfish-actions.pod:4426 ../src/guestfs-actions.pod:6897 msgid "" "This command writes patterns over a file to make data retrieval more " "difficult." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4397 ../src/guestfs-actions.pod:6861 +#: ../fish/guestfish-actions.pod:4429 ../src/guestfs-actions.pod:6900 msgid "The file is I<removed> after scrubbing." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4402 +#: ../fish/guestfish-actions.pod:4434 msgid "scrub-freespace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4404 +#: ../fish/guestfish-actions.pod:4436 #, no-wrap msgid "" " scrub-freespace dir\n" @@ -15381,7 +15453,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4406 +#: ../fish/guestfish-actions.pod:4438 msgid "" "This command creates the directory C<dir> and then fills it with files until " "the filesystem is full, and scrubs the files as for L</scrub-file>, and " @@ -15390,17 +15462,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4415 +#: ../fish/guestfish-actions.pod:4447 msgid "set-append" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4417 +#: ../fish/guestfish-actions.pod:4449 msgid "append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4419 +#: ../fish/guestfish-actions.pod:4451 #, no-wrap msgid "" " set-append append\n" @@ -15408,38 +15480,38 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4421 ../src/guestfs-actions.pod:6895 +#: ../fish/guestfish-actions.pod:4453 ../src/guestfs-actions.pod:6934 msgid "" "This function is used to add additional options to the guest kernel command " "line." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4424 ../src/guestfs-actions.pod:6898 +#: ../fish/guestfish-actions.pod:4456 ../src/guestfs-actions.pod:6937 msgid "" "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> " "environment variable." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4427 ../src/guestfs-actions.pod:6901 +#: ../fish/guestfish-actions.pod:4459 ../src/guestfs-actions.pod:6940 msgid "" "Setting C<append> to C<NULL> means I<no> additional options are passed " "(libguestfs always adds a few of its own)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4430 +#: ../fish/guestfish-actions.pod:4462 msgid "set-attach-method" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4432 +#: ../fish/guestfish-actions.pod:4464 msgid "attach-method" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4434 +#: ../fish/guestfish-actions.pod:4466 #, no-wrap msgid "" " set-attach-method attachmethod\n" @@ -15447,36 +15519,36 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4436 ../src/guestfs-actions.pod:6914 +#: ../fish/guestfish-actions.pod:4468 ../src/guestfs-actions.pod:6953 msgid "" "Set the method that libguestfs uses to connect to the back end guestfsd " "daemon. Possible methods are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4441 ../src/guestfs-actions.pod:6919 ../src/guestfs.pod:2905 +#: ../fish/guestfish-actions.pod:4473 ../src/guestfs-actions.pod:6958 ../src/guestfs.pod:2928 msgid "C<appliance>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4443 ../src/guestfs-actions.pod:6921 +#: ../fish/guestfish-actions.pod:4475 ../src/guestfs-actions.pod:6960 msgid "" "Launch an appliance and connect to it. This is the ordinary method and the " "default." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4446 ../src/guestfs-actions.pod:6924 +#: ../fish/guestfish-actions.pod:4478 ../src/guestfs-actions.pod:6963 msgid "C<unix:I<path>>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4448 ../src/guestfs-actions.pod:6926 +#: ../fish/guestfish-actions.pod:4480 ../src/guestfs-actions.pod:6965 msgid "Connect to the Unix domain socket I<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4450 ../src/guestfs-actions.pod:6928 +#: ../fish/guestfish-actions.pod:4482 ../src/guestfs-actions.pod:6967 msgid "" "This method lets you connect to an existing daemon or (using virtio-serial) " "to a live guest. For more information, see L<guestfs(3)/ATTACHING TO " @@ -15484,17 +15556,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4456 +#: ../fish/guestfish-actions.pod:4488 msgid "set-autosync" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4458 +#: ../fish/guestfish-actions.pod:4490 msgid "autosync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4460 +#: ../fish/guestfish-actions.pod:4492 #, no-wrap msgid "" " set-autosync true|false\n" @@ -15502,7 +15574,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4462 ../src/guestfs-actions.pod:6944 +#: ../fish/guestfish-actions.pod:4494 ../src/guestfs-actions.pod:6983 msgid "" "If C<autosync> is true, this enables autosync. Libguestfs will make a best " "effort attempt to make filesystems consistent and synchronized when the " @@ -15510,24 +15582,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4467 ../src/guestfs-actions.pod:6949 +#: ../fish/guestfish-actions.pod:4499 ../src/guestfs-actions.pod:6988 msgid "" "This is enabled by default (since libguestfs 1.5.24, previously it was " "disabled by default)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4470 +#: ../fish/guestfish-actions.pod:4502 msgid "set-direct" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4472 +#: ../fish/guestfish-actions.pod:4504 msgid "direct" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4474 +#: ../fish/guestfish-actions.pod:4506 #, no-wrap msgid "" " set-direct true|false\n" @@ -15535,36 +15607,36 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4476 ../src/guestfs-actions.pod:6962 +#: ../fish/guestfish-actions.pod:4508 ../src/guestfs-actions.pod:7001 msgid "" "If the direct appliance mode flag is enabled, then stdin and stdout are " "passed directly through to the appliance once it is launched." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4480 +#: ../fish/guestfish-actions.pod:4512 msgid "" "One consequence of this is that log messages aren't caught by the library " "and handled by L</set-log-message-callback>, but go straight to stdout." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4484 ../src/guestfs-actions.pod:6970 +#: ../fish/guestfish-actions.pod:4516 ../src/guestfs-actions.pod:7009 msgid "You probably don't want to use this unless you know what you are doing." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4487 ../src/guestfs-actions.pod:6973 +#: ../fish/guestfish-actions.pod:4519 ../src/guestfs-actions.pod:7012 msgid "The default is disabled." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4489 +#: ../fish/guestfish-actions.pod:4521 msgid "set-e2label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4491 +#: ../fish/guestfish-actions.pod:4523 #, no-wrap msgid "" " set-e2label device label\n" @@ -15572,26 +15644,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4493 ../src/guestfs-actions.pod:6986 +#: ../fish/guestfish-actions.pod:4525 ../src/guestfs-actions.pod:7025 msgid "" "This sets the ext2/3/4 filesystem label of the filesystem on C<device> to " "C<label>. Filesystem labels are limited to 16 characters." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4497 +#: ../fish/guestfish-actions.pod:4529 msgid "" "You can use either L</tune2fs-l> or L</get-e2label> to return the existing " "label on a filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4500 +#: ../fish/guestfish-actions.pod:4532 msgid "set-e2uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4502 +#: ../fish/guestfish-actions.pod:4534 #, no-wrap msgid "" " set-e2uuid device uuid\n" @@ -15599,7 +15671,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4504 ../src/guestfs-actions.pod:7004 +#: ../fish/guestfish-actions.pod:4536 ../src/guestfs-actions.pod:7043 msgid "" "This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to " "C<uuid>. The format of the UUID and alternatives such as C<clear>, " @@ -15607,24 +15679,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4509 +#: ../fish/guestfish-actions.pod:4541 msgid "" "You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing " "UUID of a filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4512 +#: ../fish/guestfish-actions.pod:4544 msgid "set-memsize" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4514 +#: ../fish/guestfish-actions.pod:4546 msgid "memsize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4516 +#: ../fish/guestfish-actions.pod:4548 #, no-wrap msgid "" " set-memsize memsize\n" @@ -15632,31 +15704,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4518 +#: ../fish/guestfish-actions.pod:4550 msgid "" "This sets the memory size in megabytes allocated to the qemu subprocess. " "This only has any effect if called before L</launch>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4522 ../src/guestfs-actions.pod:7026 +#: ../fish/guestfish-actions.pod:4554 ../src/guestfs-actions.pod:7065 msgid "" "You can also change this by setting the environment variable " "C<LIBGUESTFS_MEMSIZE> before the handle is created." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4529 +#: ../fish/guestfish-actions.pod:4561 msgid "set-network" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4531 +#: ../fish/guestfish-actions.pod:4563 msgid "network" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4533 +#: ../fish/guestfish-actions.pod:4565 #, no-wrap msgid "" " set-network true|false\n" @@ -15664,31 +15736,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4535 ../src/guestfs-actions.pod:7043 +#: ../fish/guestfish-actions.pod:4567 ../src/guestfs-actions.pod:7082 msgid "" "If C<network> is true, then the network is enabled in the libguestfs " "appliance. The default is false." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4538 ../src/guestfs-actions.pod:7046 +#: ../fish/guestfish-actions.pod:4570 ../src/guestfs-actions.pod:7085 msgid "" "This affects whether commands are able to access the network (see " "L<guestfs(3)/RUNNING COMMANDS>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4541 +#: ../fish/guestfish-actions.pod:4573 msgid "You must call this before calling L</launch>, otherwise it has no effect." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4544 +#: ../fish/guestfish-actions.pod:4576 msgid "set-path" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4548 +#: ../fish/guestfish-actions.pod:4580 #, no-wrap msgid "" " set-path searchpath\n" @@ -15696,34 +15768,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4550 ../src/guestfs-actions.pod:7062 +#: ../fish/guestfish-actions.pod:4582 ../src/guestfs-actions.pod:7101 msgid "Set the path that libguestfs searches for kernel and initrd.img." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4552 ../src/guestfs-actions.pod:7064 +#: ../fish/guestfish-actions.pod:4584 ../src/guestfs-actions.pod:7103 msgid "" "The default is C<$libdir/guestfs> unless overridden by setting " "C<LIBGUESTFS_PATH> environment variable." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4555 ../src/guestfs-actions.pod:7067 +#: ../fish/guestfish-actions.pod:4587 ../src/guestfs-actions.pod:7106 msgid "Setting C<path> to C<NULL> restores the default path." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4557 +#: ../fish/guestfish-actions.pod:4589 msgid "set-pgroup" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4559 +#: ../fish/guestfish-actions.pod:4591 msgid "pgroup" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4561 +#: ../fish/guestfish-actions.pod:4593 #, no-wrap msgid "" " set-pgroup true|false\n" @@ -15731,21 +15803,21 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4563 ../src/guestfs-actions.pod:7079 +#: ../fish/guestfish-actions.pod:4595 ../src/guestfs-actions.pod:7118 msgid "" "If C<pgroup> is true, child processes are placed into their own process " "group." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4566 ../src/guestfs-actions.pod:7082 +#: ../fish/guestfish-actions.pod:4598 ../src/guestfs-actions.pod:7121 msgid "" "The practical upshot of this is that signals like C<SIGINT> (from users " "pressing C<^C>) won't be received by the child process." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4569 +#: ../fish/guestfish-actions.pod:4601 msgid "" "The default for this flag is false, because usually you want C<^C> to kill " "the subprocess. Guestfish sets this flag to true when used interactively, " @@ -15754,17 +15826,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4574 +#: ../fish/guestfish-actions.pod:4606 msgid "set-qemu" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4576 +#: ../fish/guestfish-actions.pod:4608 msgid "qemu" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4578 +#: ../fish/guestfish-actions.pod:4610 #, no-wrap msgid "" " set-qemu qemu\n" @@ -15772,29 +15844,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4580 ../src/guestfs-actions.pod:7100 +#: ../fish/guestfish-actions.pod:4612 ../src/guestfs-actions.pod:7139 msgid "Set the qemu binary that we will use." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4582 ../src/guestfs-actions.pod:7102 +#: ../fish/guestfish-actions.pod:4614 ../src/guestfs-actions.pod:7141 msgid "The default is chosen when the library was compiled by the configure script." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4585 ../src/guestfs-actions.pod:7105 +#: ../fish/guestfish-actions.pod:4617 ../src/guestfs-actions.pod:7144 msgid "" "You can also override this by setting the C<LIBGUESTFS_QEMU> environment " "variable." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4588 ../src/guestfs-actions.pod:7108 +#: ../fish/guestfish-actions.pod:4620 ../src/guestfs-actions.pod:7147 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4590 ../src/guestfs-actions.pod:7110 +#: ../fish/guestfish-actions.pod:4622 ../src/guestfs-actions.pod:7149 msgid "" "Note that you should call this function as early as possible after creating " "the handle. This is because some pre-launch operations depend on testing " @@ -15805,17 +15877,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4598 +#: ../fish/guestfish-actions.pod:4630 msgid "set-recovery-proc" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4600 +#: ../fish/guestfish-actions.pod:4632 msgid "recovery-proc" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4602 +#: ../fish/guestfish-actions.pod:4634 #, no-wrap msgid "" " set-recovery-proc true|false\n" @@ -15823,7 +15895,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4604 +#: ../fish/guestfish-actions.pod:4636 msgid "" "If this is called with the parameter C<false> then L</launch> does not " "create a recovery process. The purpose of the recovery process is to stop " @@ -15831,14 +15903,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4609 +#: ../fish/guestfish-actions.pod:4641 msgid "" "This only has any effect if called before L</launch>, and the default is " "true." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4612 ../src/guestfs-actions.pod:7136 +#: ../fish/guestfish-actions.pod:4644 ../src/guestfs-actions.pod:7175 msgid "" "About the only time when you would want to disable this is if the main " "process will fork itself into the background (\"daemonize\" itself). In " @@ -15847,17 +15919,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4618 +#: ../fish/guestfish-actions.pod:4650 msgid "set-selinux" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4620 +#: ../fish/guestfish-actions.pod:4652 msgid "selinux" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4622 +#: ../fish/guestfish-actions.pod:4654 #, no-wrap msgid "" " set-selinux true|false\n" @@ -15865,31 +15937,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4624 ../src/guestfs-actions.pod:7152 +#: ../fish/guestfish-actions.pod:4656 ../src/guestfs-actions.pod:7191 msgid "" "This sets the selinux flag that is passed to the appliance at boot time. " "The default is C<selinux=0> (disabled)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4627 ../src/guestfs-actions.pod:7155 +#: ../fish/guestfish-actions.pod:4659 ../src/guestfs-actions.pod:7194 msgid "" "Note that if SELinux is enabled, it is always in Permissive mode " "(C<enforcing=0>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4633 +#: ../fish/guestfish-actions.pod:4665 msgid "set-smp" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4635 +#: ../fish/guestfish-actions.pod:4667 msgid "smp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4637 +#: ../fish/guestfish-actions.pod:4669 #, no-wrap msgid "" " set-smp smp\n" @@ -15897,7 +15969,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4639 ../src/guestfs-actions.pod:7171 +#: ../fish/guestfish-actions.pod:4671 ../src/guestfs-actions.pod:7210 msgid "" "Change the number of virtual CPUs assigned to the appliance. The default is " "C<1>. Increasing this may improve performance, though often it has no " @@ -15905,22 +15977,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4643 +#: ../fish/guestfish-actions.pod:4675 msgid "This function must be called before L</launch>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4645 +#: ../fish/guestfish-actions.pod:4677 msgid "set-trace" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4647 +#: ../fish/guestfish-actions.pod:4679 msgid "trace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4649 +#: ../fish/guestfish-actions.pod:4681 #, no-wrap msgid "" " set-trace true|false\n" @@ -15928,45 +16000,45 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4651 ../src/guestfs-actions.pod:7187 +#: ../fish/guestfish-actions.pod:4683 ../src/guestfs-actions.pod:7226 msgid "" "If the command trace flag is set to 1, then libguestfs calls, parameters and " "return values are traced." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4654 ../src/guestfs-actions.pod:7190 +#: ../fish/guestfish-actions.pod:4686 ../src/guestfs-actions.pod:7229 msgid "" "If you want to trace C API calls into libguestfs (and other libraries) then " "possibly a better way is to use the external ltrace(1) command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4658 ../src/guestfs-actions.pod:7194 +#: ../fish/guestfish-actions.pod:4690 ../src/guestfs-actions.pod:7233 msgid "" "Command traces are disabled unless the environment variable " "C<LIBGUESTFS_TRACE> is defined and set to C<1>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4661 +#: ../fish/guestfish-actions.pod:4693 msgid "" "Trace messages are normally sent to C<stderr>, unless you register a " "callback to send them somewhere else (see L</set-event-callback>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4665 +#: ../fish/guestfish-actions.pod:4697 msgid "set-verbose" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4667 +#: ../fish/guestfish-actions.pod:4699 msgid "verbose" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4669 +#: ../fish/guestfish-actions.pod:4701 #, no-wrap msgid "" " set-verbose true|false\n" @@ -15974,31 +16046,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4671 ../src/guestfs-actions.pod:7211 +#: ../fish/guestfish-actions.pod:4703 ../src/guestfs-actions.pod:7250 msgid "If C<verbose> is true, this turns on verbose messages." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4673 ../src/guestfs-actions.pod:7213 +#: ../fish/guestfish-actions.pod:4705 ../src/guestfs-actions.pod:7252 msgid "" "Verbose messages are disabled unless the environment variable " "C<LIBGUESTFS_DEBUG> is defined and set to C<1>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4676 +#: ../fish/guestfish-actions.pod:4708 msgid "" "Verbose messages are normally sent to C<stderr>, unless you register a " "callback to send them somewhere else (see L</set-event-callback>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4680 +#: ../fish/guestfish-actions.pod:4712 msgid "setcon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4682 +#: ../fish/guestfish-actions.pod:4714 #, no-wrap msgid "" " setcon context\n" @@ -16006,24 +16078,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4684 ../src/guestfs-actions.pod:7230 +#: ../fish/guestfish-actions.pod:4716 ../src/guestfs-actions.pod:7269 msgid "" "This sets the SELinux security context of the daemon to the string " "C<context>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4687 ../src/guestfs-actions.pod:7233 +#: ../fish/guestfish-actions.pod:4719 ../src/guestfs-actions.pod:7272 msgid "See the documentation about SELINUX in L<guestfs(3)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4689 +#: ../fish/guestfish-actions.pod:4721 msgid "setxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4691 +#: ../fish/guestfish-actions.pod:4723 #, no-wrap msgid "" " setxattr xattr val vallen path\n" @@ -16031,24 +16103,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4693 ../src/guestfs-actions.pod:7248 +#: ../fish/guestfish-actions.pod:4725 ../src/guestfs-actions.pod:7287 msgid "" "This call sets the extended attribute named C<xattr> of the file C<path> to " "the value C<val> (of length C<vallen>). The value is arbitrary 8 bit data." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4697 +#: ../fish/guestfish-actions.pod:4729 msgid "See also: L</lsetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4699 +#: ../fish/guestfish-actions.pod:4731 msgid "sfdisk" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4701 +#: ../fish/guestfish-actions.pod:4733 #, no-wrap msgid "" " sfdisk device cyls heads sectors 'lines ...'\n" @@ -16056,19 +16128,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4703 ../src/guestfs-actions.pod:7275 +#: ../fish/guestfish-actions.pod:4735 ../src/guestfs-actions.pod:7314 msgid "" "This is a direct interface to the L<sfdisk(8)> program for creating " "partitions on block devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4706 ../src/guestfs-actions.pod:7278 +#: ../fish/guestfish-actions.pod:4738 ../src/guestfs-actions.pod:7317 msgid "C<device> should be a block device, for example C</dev/sda>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4708 ../src/guestfs-actions.pod:7280 +#: ../fish/guestfish-actions.pod:4740 ../src/guestfs-actions.pod:7319 msgid "" "C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and " "sectors on the device, which are passed directly to sfdisk as the I<-C>, " @@ -16079,14 +16151,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4716 ../src/guestfs-actions.pod:7288 +#: ../fish/guestfish-actions.pod:4748 ../src/guestfs-actions.pod:7327 msgid "" "C<lines> is a list of lines that we feed to C<sfdisk>. For more information " "refer to the L<sfdisk(8)> manpage." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4719 ../src/guestfs-actions.pod:7291 +#: ../fish/guestfish-actions.pod:4751 ../src/guestfs-actions.pod:7330 msgid "" "To create a single partition occupying the whole disk, you would pass " "C<lines> as a single element list, when the single element being the string " @@ -16094,24 +16166,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4723 +#: ../fish/guestfish-actions.pod:4755 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4726 ../fish/guestfish-actions.pod:4746 ../fish/guestfish-actions.pod:4765 +#: ../fish/guestfish-actions.pod:4758 ../fish/guestfish-actions.pod:4778 ../fish/guestfish-actions.pod:4797 msgid "" "I<This function is deprecated.> In new code, use the L</part_add> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4733 +#: ../fish/guestfish-actions.pod:4765 msgid "sfdiskM" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4735 +#: ../fish/guestfish-actions.pod:4767 #, no-wrap msgid "" " sfdiskM device 'lines ...'\n" @@ -16119,7 +16191,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4737 +#: ../fish/guestfish-actions.pod:4769 msgid "" "This is a simplified interface to the L</sfdisk> command, where partition " "sizes are specified in megabytes only (rounded to the nearest cylinder) and " @@ -16128,17 +16200,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4743 +#: ../fish/guestfish-actions.pod:4775 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4753 +#: ../fish/guestfish-actions.pod:4785 msgid "sfdisk-N" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4755 +#: ../fish/guestfish-actions.pod:4787 #, no-wrap msgid "" " sfdisk-N device partnum cyls heads sectors line\n" @@ -16146,31 +16218,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4757 ../src/guestfs-actions.pod:7347 +#: ../fish/guestfish-actions.pod:4789 ../src/guestfs-actions.pod:7386 msgid "" "This runs L<sfdisk(8)> option to modify just the single partition C<n> " "(note: C<n> counts from 1)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4760 +#: ../fish/guestfish-actions.pod:4792 msgid "" "For other parameters, see L</sfdisk>. You should usually pass C<0> for the " "cyls/heads/sectors parameters." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4763 +#: ../fish/guestfish-actions.pod:4795 msgid "See also: L</part-add>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4772 +#: ../fish/guestfish-actions.pod:4804 msgid "sfdisk-disk-geometry" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4774 +#: ../fish/guestfish-actions.pod:4806 #, no-wrap msgid "" " sfdisk-disk-geometry device\n" @@ -16178,7 +16250,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4776 +#: ../fish/guestfish-actions.pod:4808 msgid "" "This displays the disk geometry of C<device> read from the partition table. " "Especially in the case where the underlying block device has been resized, " @@ -16187,17 +16259,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4781 ../fish/guestfish-actions.pod:4790 ../src/guestfs-actions.pod:7370 ../src/guestfs-actions.pod:7386 +#: ../fish/guestfish-actions.pod:4813 ../fish/guestfish-actions.pod:4822 ../src/guestfs-actions.pod:7409 ../src/guestfs-actions.pod:7425 msgid "The result is in human-readable format, and not designed to be parsed." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4784 +#: ../fish/guestfish-actions.pod:4816 msgid "sfdisk-kernel-geometry" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4786 +#: ../fish/guestfish-actions.pod:4818 #, no-wrap msgid "" " sfdisk-kernel-geometry device\n" @@ -16205,17 +16277,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4788 ../src/guestfs-actions.pod:7384 +#: ../fish/guestfish-actions.pod:4820 ../src/guestfs-actions.pod:7423 msgid "This displays the kernel's idea of the geometry of C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4793 +#: ../fish/guestfish-actions.pod:4825 msgid "sfdisk-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4795 +#: ../fish/guestfish-actions.pod:4827 #, no-wrap msgid "" " sfdisk-l device\n" @@ -16223,31 +16295,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4797 ../src/guestfs-actions.pod:7407 +#: ../fish/guestfish-actions.pod:4829 ../src/guestfs-actions.pod:7446 msgid "" "This displays the partition table on C<device>, in the human-readable output " "of the L<sfdisk(8)> command. It is not intended to be parsed." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4801 +#: ../fish/guestfish-actions.pod:4833 msgid "See also: L</part-list>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4803 +#: ../fish/guestfish-actions.pod:4835 msgid "" "I<This function is deprecated.> In new code, use the L</part_list> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4810 +#: ../fish/guestfish-actions.pod:4842 msgid "sh" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4812 +#: ../fish/guestfish-actions.pod:4844 #, no-wrap msgid "" " sh command\n" @@ -16255,19 +16327,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4814 ../src/guestfs-actions.pod:7424 +#: ../fish/guestfish-actions.pod:4846 ../src/guestfs-actions.pod:7463 msgid "" "This call runs a command from the guest filesystem via the guest's " "C</bin/sh>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4817 +#: ../fish/guestfish-actions.pod:4849 msgid "This is like L</command>, but passes the command to:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4819 ../src/guestfs-actions.pod:7429 +#: ../fish/guestfish-actions.pod:4851 ../src/guestfs-actions.pod:7468 #, no-wrap msgid "" " /bin/sh -c \"command\"\n" @@ -16275,24 +16347,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4821 ../src/guestfs-actions.pod:7431 +#: ../fish/guestfish-actions.pod:4853 ../src/guestfs-actions.pod:7470 msgid "" "Depending on the guest's shell, this usually results in wildcards being " "expanded, shell expressions being interpolated and so on." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4825 +#: ../fish/guestfish-actions.pod:4857 msgid "All the provisos about L</command> apply to this call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4827 +#: ../fish/guestfish-actions.pod:4859 msgid "sh-lines" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4829 +#: ../fish/guestfish-actions.pod:4861 #, no-wrap msgid "" " sh-lines command\n" @@ -16300,22 +16372,70 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4831 +#: ../fish/guestfish-actions.pod:4863 msgid "This is the same as L</sh>, but splits the result into a list of lines." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4834 +#: ../fish/guestfish-actions.pod:4866 msgid "See also: L</command-lines>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4836 +#: ../fish/guestfish-actions.pod:4868 +msgid "shutdown" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:4870 +#, no-wrap +msgid "" +" shutdown\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:4872 +msgid "" +"This is the opposite of L</launch>. It performs an orderly shutdown of the " +"backend process(es). If the autosync flag is set (which is the default) " +"then the disk image is synchronized." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:4876 ../src/guestfs-actions.pod:7507 +msgid "" +"If the subprocess exits with an error then this function will return an " +"error, which should I<not> be ignored (it may indicate that the disk image " +"could not be written out properly)." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:4880 ../src/guestfs-actions.pod:7511 +msgid "It is safe to call this multiple times. Extra calls are ignored." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:4882 +msgid "" +"This call does I<not> close or free up the handle. You still need to call " +"L</close> afterwards." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:4885 +msgid "" +"L</close> will call this if you don't do it explicitly, but note that any " +"errors are ignored in that case." +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:4888 msgid "sleep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4838 +#: ../fish/guestfish-actions.pod:4890 #, no-wrap msgid "" " sleep secs\n" @@ -16323,17 +16443,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4840 ../src/guestfs-actions.pod:7465 +#: ../fish/guestfish-actions.pod:4892 ../src/guestfs-actions.pod:7527 msgid "Sleep for C<secs> seconds." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4842 +#: ../fish/guestfish-actions.pod:4894 msgid "stat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4844 +#: ../fish/guestfish-actions.pod:4896 #, no-wrap msgid "" " stat path\n" @@ -16341,17 +16461,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4848 ../src/guestfs-actions.pod:7479 +#: ../fish/guestfish-actions.pod:4900 ../src/guestfs-actions.pod:7541 msgid "This is the same as the C<stat(2)> system call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4850 +#: ../fish/guestfish-actions.pod:4902 msgid "statvfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4852 +#: ../fish/guestfish-actions.pod:4904 #, no-wrap msgid "" " statvfs path\n" @@ -16359,7 +16479,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4854 ../src/guestfs-actions.pod:7493 +#: ../fish/guestfish-actions.pod:4906 ../src/guestfs-actions.pod:7555 msgid "" "Returns file system statistics for any mounted file system. C<path> should " "be a file or directory in the mounted file system (typically it is the mount " @@ -16367,17 +16487,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4858 ../src/guestfs-actions.pod:7497 +#: ../fish/guestfish-actions.pod:4910 ../src/guestfs-actions.pod:7559 msgid "This is the same as the C<statvfs(2)> system call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4860 +#: ../fish/guestfish-actions.pod:4912 msgid "strings" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4862 +#: ../fish/guestfish-actions.pod:4914 #, no-wrap msgid "" " strings path\n" @@ -16385,19 +16505,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4864 ../src/guestfs-actions.pod:7511 +#: ../fish/guestfish-actions.pod:4916 ../src/guestfs-actions.pod:7573 msgid "" "This runs the L<strings(1)> command on a file and returns the list of " "printable strings found." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4870 +#: ../fish/guestfish-actions.pod:4922 msgid "strings-e" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4872 +#: ../fish/guestfish-actions.pod:4924 #, no-wrap msgid "" " strings-e encoding path\n" @@ -16405,93 +16525,93 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4874 +#: ../fish/guestfish-actions.pod:4926 msgid "" "This is like the L</strings> command, but allows you to specify the encoding " "of strings that are looked for in the source file C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4878 ../src/guestfs-actions.pod:7534 +#: ../fish/guestfish-actions.pod:4930 ../src/guestfs-actions.pod:7596 msgid "Allowed encodings are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4882 ../src/guestfs-actions.pod:7538 +#: ../fish/guestfish-actions.pod:4934 ../src/guestfs-actions.pod:7600 msgid "s" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4884 +#: ../fish/guestfish-actions.pod:4936 msgid "" "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of " "ISO-8859-X (this is what L</strings> uses)." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4887 ../src/guestfs-actions.pod:7543 +#: ../fish/guestfish-actions.pod:4939 ../src/guestfs-actions.pod:7605 msgid "S" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4889 ../src/guestfs-actions.pod:7545 +#: ../fish/guestfish-actions.pod:4941 ../src/guestfs-actions.pod:7607 msgid "Single 8-bit-byte characters." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4891 ../src/guestfs-actions.pod:7547 +#: ../fish/guestfish-actions.pod:4943 ../src/guestfs-actions.pod:7609 msgid "b" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4893 ../src/guestfs-actions.pod:7549 +#: ../fish/guestfish-actions.pod:4945 ../src/guestfs-actions.pod:7611 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4896 ../src/guestfs-actions.pod:7552 +#: ../fish/guestfish-actions.pod:4948 ../src/guestfs-actions.pod:7614 msgid "l (lower case letter L)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4898 ../src/guestfs-actions.pod:7554 +#: ../fish/guestfish-actions.pod:4950 ../src/guestfs-actions.pod:7616 msgid "" "16-bit little endian such as UTF-16LE and UCS-2LE. This is useful for " "examining binaries in Windows guests." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4901 ../src/guestfs-actions.pod:7557 +#: ../fish/guestfish-actions.pod:4953 ../src/guestfs-actions.pod:7619 msgid "B" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4903 ../src/guestfs-actions.pod:7559 +#: ../fish/guestfish-actions.pod:4955 ../src/guestfs-actions.pod:7621 msgid "32-bit big endian such as UCS-4BE." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4905 ../src/guestfs-actions.pod:7561 +#: ../fish/guestfish-actions.pod:4957 ../src/guestfs-actions.pod:7623 msgid "L" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4907 ../src/guestfs-actions.pod:7563 +#: ../fish/guestfish-actions.pod:4959 ../src/guestfs-actions.pod:7625 msgid "32-bit little endian such as UCS-4LE." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4911 ../src/guestfs-actions.pod:7567 +#: ../fish/guestfish-actions.pod:4963 ../src/guestfs-actions.pod:7629 msgid "The returned strings are transcoded to UTF-8." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4916 +#: ../fish/guestfish-actions.pod:4968 msgid "swapoff-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4918 +#: ../fish/guestfish-actions.pod:4970 #, no-wrap msgid "" " swapoff-device device\n" @@ -16499,19 +16619,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4920 +#: ../fish/guestfish-actions.pod:4972 msgid "" "This command disables the libguestfs appliance swap device or partition " "named C<device>. See L</swapon-device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4924 +#: ../fish/guestfish-actions.pod:4976 msgid "swapoff-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4926 +#: ../fish/guestfish-actions.pod:4978 #, no-wrap msgid "" " swapoff-file file\n" @@ -16519,17 +16639,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4928 ../src/guestfs-actions.pod:7598 +#: ../fish/guestfish-actions.pod:4980 ../src/guestfs-actions.pod:7660 msgid "This command disables the libguestfs appliance swap on file." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4930 +#: ../fish/guestfish-actions.pod:4982 msgid "swapoff-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4932 +#: ../fish/guestfish-actions.pod:4984 #, no-wrap msgid "" " swapoff-label label\n" @@ -16537,19 +16657,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4934 ../src/guestfs-actions.pod:7610 +#: ../fish/guestfish-actions.pod:4986 ../src/guestfs-actions.pod:7672 msgid "" "This command disables the libguestfs appliance swap on labeled swap " "partition." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4937 +#: ../fish/guestfish-actions.pod:4989 msgid "swapoff-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4939 +#: ../fish/guestfish-actions.pod:4991 #, no-wrap msgid "" " swapoff-uuid uuid\n" @@ -16557,19 +16677,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4941 ../src/guestfs-actions.pod:7623 +#: ../fish/guestfish-actions.pod:4993 ../src/guestfs-actions.pod:7685 msgid "" "This command disables the libguestfs appliance swap partition with the given " "UUID." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4944 +#: ../fish/guestfish-actions.pod:4996 msgid "swapon-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4946 +#: ../fish/guestfish-actions.pod:4998 #, no-wrap msgid "" " swapon-device device\n" @@ -16577,7 +16697,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4948 +#: ../fish/guestfish-actions.pod:5000 msgid "" "This command enables the libguestfs appliance to use the swap device or " "partition named C<device>. The increased memory is made available for all " @@ -16585,7 +16705,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4953 ../src/guestfs-actions.pod:7641 +#: ../fish/guestfish-actions.pod:5005 ../src/guestfs-actions.pod:7703 msgid "" "Note that you should not swap to existing guest swap partitions unless you " "know what you are doing. They may contain hibernation information, or other " @@ -16595,12 +16715,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4960 +#: ../fish/guestfish-actions.pod:5012 msgid "swapon-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4962 +#: ../fish/guestfish-actions.pod:5014 #, no-wrap msgid "" " swapon-file file\n" @@ -16608,17 +16728,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4964 +#: ../fish/guestfish-actions.pod:5016 msgid "This command enables swap to a file. See L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4967 +#: ../fish/guestfish-actions.pod:5019 msgid "swapon-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4969 +#: ../fish/guestfish-actions.pod:5021 #, no-wrap msgid "" " swapon-label label\n" @@ -16626,19 +16746,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4971 +#: ../fish/guestfish-actions.pod:5023 msgid "" "This command enables swap to a labeled swap partition. See " "L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4974 +#: ../fish/guestfish-actions.pod:5026 msgid "swapon-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4976 +#: ../fish/guestfish-actions.pod:5028 #, no-wrap msgid "" " swapon-uuid uuid\n" @@ -16646,19 +16766,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4978 +#: ../fish/guestfish-actions.pod:5030 msgid "" "This command enables swap to a swap partition with the given UUID. See " "L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4981 +#: ../fish/guestfish-actions.pod:5033 msgid "sync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4983 +#: ../fish/guestfish-actions.pod:5035 #, no-wrap msgid "" " sync\n" @@ -16666,26 +16786,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4985 ../src/guestfs-actions.pod:7696 +#: ../fish/guestfish-actions.pod:5037 ../src/guestfs-actions.pod:7758 msgid "" "This syncs the disk, so that any writes are flushed through to the " "underlying disk image." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4988 ../src/guestfs-actions.pod:7699 +#: ../fish/guestfish-actions.pod:5040 ../src/guestfs-actions.pod:7761 msgid "" "You should always call this if you have modified a disk image, before " "closing the handle." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4991 +#: ../fish/guestfish-actions.pod:5043 msgid "tail" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4993 +#: ../fish/guestfish-actions.pod:5045 #, no-wrap msgid "" " tail path\n" @@ -16693,17 +16813,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4995 ../src/guestfs-actions.pod:7712 +#: ../fish/guestfish-actions.pod:5047 ../src/guestfs-actions.pod:7774 msgid "This command returns up to the last 10 lines of a file as a list of strings." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5001 +#: ../fish/guestfish-actions.pod:5053 msgid "tail-n" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5003 +#: ../fish/guestfish-actions.pod:5055 #, no-wrap msgid "" " tail-n nrlines path\n" @@ -16711,26 +16831,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5005 ../src/guestfs-actions.pod:7731 +#: ../fish/guestfish-actions.pod:5057 ../src/guestfs-actions.pod:7793 msgid "" "If the parameter C<nrlines> is a positive number, this returns the last " "C<nrlines> lines of the file C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5008 ../src/guestfs-actions.pod:7734 +#: ../fish/guestfish-actions.pod:5060 ../src/guestfs-actions.pod:7796 msgid "" "If the parameter C<nrlines> is a negative number, this returns lines from " "the file C<path>, starting with the C<-nrlines>th line." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5016 +#: ../fish/guestfish-actions.pod:5068 msgid "tar-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5018 +#: ../fish/guestfish-actions.pod:5070 #, no-wrap msgid "" " tar-in (tarfile|-) directory\n" @@ -16738,24 +16858,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5020 ../src/guestfs-actions.pod:7755 +#: ../fish/guestfish-actions.pod:5072 ../src/guestfs-actions.pod:7817 msgid "" "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> " "tar file) into C<directory>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5023 +#: ../fish/guestfish-actions.pod:5075 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5028 +#: ../fish/guestfish-actions.pod:5080 msgid "tar-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5030 +#: ../fish/guestfish-actions.pod:5082 #, no-wrap msgid "" " tar-out directory (tarfile|-)\n" @@ -16763,24 +16883,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5032 ../src/guestfs-actions.pod:7772 +#: ../fish/guestfish-actions.pod:5084 ../src/guestfs-actions.pod:7834 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarfile>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5035 +#: ../fish/guestfish-actions.pod:5087 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5040 +#: ../fish/guestfish-actions.pod:5092 msgid "tgz-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5042 +#: ../fish/guestfish-actions.pod:5094 #, no-wrap msgid "" " tgz-in (tarball|-) directory\n" @@ -16788,24 +16908,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5044 ../src/guestfs-actions.pod:7789 +#: ../fish/guestfish-actions.pod:5096 ../src/guestfs-actions.pod:7851 msgid "" "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> " "tar file) into C<directory>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5047 +#: ../fish/guestfish-actions.pod:5099 msgid "To upload an uncompressed tarball, use L</tar-in>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5051 +#: ../fish/guestfish-actions.pod:5103 msgid "tgz-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5053 +#: ../fish/guestfish-actions.pod:5105 #, no-wrap msgid "" " tgz-out directory (tarball|-)\n" @@ -16813,24 +16933,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5055 ../src/guestfs-actions.pod:7805 +#: ../fish/guestfish-actions.pod:5107 ../src/guestfs-actions.pod:7867 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarball>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5058 +#: ../fish/guestfish-actions.pod:5110 msgid "To download an uncompressed tarball, use L</tar-out>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5062 +#: ../fish/guestfish-actions.pod:5114 msgid "touch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5064 +#: ../fish/guestfish-actions.pod:5116 #, no-wrap msgid "" " touch path\n" @@ -16838,7 +16958,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5066 ../src/guestfs-actions.pod:7820 +#: ../fish/guestfish-actions.pod:5118 ../src/guestfs-actions.pod:7882 msgid "" "Touch acts like the L<touch(1)> command. It can be used to update the " "timestamps on a file, or, if the file does not exist, to create a new " @@ -16846,19 +16966,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5070 ../src/guestfs-actions.pod:7824 +#: ../fish/guestfish-actions.pod:5122 ../src/guestfs-actions.pod:7886 msgid "" "This command only works on regular files, and will fail on other file types " "such as directories, symbolic links, block special etc." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5073 +#: ../fish/guestfish-actions.pod:5125 msgid "truncate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5075 +#: ../fish/guestfish-actions.pod:5127 #, no-wrap msgid "" " truncate path\n" @@ -16866,19 +16986,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5077 ../src/guestfs-actions.pod:7837 +#: ../fish/guestfish-actions.pod:5129 ../src/guestfs-actions.pod:7899 msgid "" "This command truncates C<path> to a zero-length file. The file must exist " "already." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5080 +#: ../fish/guestfish-actions.pod:5132 msgid "truncate-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5082 +#: ../fish/guestfish-actions.pod:5134 #, no-wrap msgid "" " truncate-size path size\n" @@ -16886,14 +17006,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5084 ../src/guestfs-actions.pod:7851 +#: ../fish/guestfish-actions.pod:5136 ../src/guestfs-actions.pod:7913 msgid "" "This command truncates C<path> to size C<size> bytes. The file must exist " "already." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5087 +#: ../fish/guestfish-actions.pod:5139 msgid "" "If the current file size is less than C<size> then the file is extended to " "the required size with zero bytes. This creates a sparse file (ie. disk " @@ -16902,12 +17022,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5093 +#: ../fish/guestfish-actions.pod:5145 msgid "tune2fs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5095 +#: ../fish/guestfish-actions.pod:5147 #, no-wrap msgid "" " tune2fs device [force:true|false] [maxmountcount:N] [mountcount:N] " @@ -16918,26 +17038,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5097 ../src/guestfs-actions.pod:7887 +#: ../fish/guestfish-actions.pod:5149 ../src/guestfs-actions.pod:7949 msgid "" "This call allows you to adjust various filesystem parameters of an " "ext2/ext3/ext4 filesystem called C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5106 ../src/guestfs-actions.pod:7896 +#: ../fish/guestfish-actions.pod:5158 ../src/guestfs-actions.pod:7958 msgid "" "Force tune2fs to complete the operation even in the face of errors. This is " "the same as the tune2fs C<-f> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5109 ../src/guestfs-actions.pod:7899 +#: ../fish/guestfish-actions.pod:5161 ../src/guestfs-actions.pod:7961 msgid "C<maxmountcount>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5111 ../src/guestfs-actions.pod:7901 +#: ../fish/guestfish-actions.pod:5163 ../src/guestfs-actions.pod:7963 msgid "" "Set the number of mounts after which the filesystem is checked by " "L<e2fsck(8)>. If this is C<0> then the number of mounts is disregarded. " @@ -16945,24 +17065,24 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5115 ../src/guestfs-actions.pod:7905 +#: ../fish/guestfish-actions.pod:5167 ../src/guestfs-actions.pod:7967 msgid "C<mountcount>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5117 ../src/guestfs-actions.pod:7907 +#: ../fish/guestfish-actions.pod:5169 ../src/guestfs-actions.pod:7969 msgid "" "Set the number of times the filesystem has been mounted. This is the same " "as the tune2fs C<-C> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5120 ../src/guestfs-actions.pod:7910 +#: ../fish/guestfish-actions.pod:5172 ../src/guestfs-actions.pod:7972 msgid "C<errorbehavior>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5122 ../src/guestfs-actions.pod:7912 +#: ../fish/guestfish-actions.pod:5174 ../src/guestfs-actions.pod:7974 msgid "" "Change the behavior of the kernel code when errors are detected. Possible " "values currently are: C<continue>, C<remount-ro>, C<panic>. In practice " @@ -16971,77 +17091,77 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5127 ../src/guestfs-actions.pod:7917 +#: ../fish/guestfish-actions.pod:5179 ../src/guestfs-actions.pod:7979 msgid "This is the same as the tune2fs C<-e> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5129 ../src/guestfs-actions.pod:7919 +#: ../fish/guestfish-actions.pod:5181 ../src/guestfs-actions.pod:7981 msgid "C<group>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5131 ../src/guestfs-actions.pod:7921 +#: ../fish/guestfish-actions.pod:5183 ../src/guestfs-actions.pod:7983 msgid "" "Set the group which can use reserved filesystem blocks. This is the same as " "the tune2fs C<-g> option except that it can only be specified as a number." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5135 ../src/guestfs-actions.pod:7925 +#: ../fish/guestfish-actions.pod:5187 ../src/guestfs-actions.pod:7987 msgid "C<intervalbetweenchecks>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5137 ../src/guestfs-actions.pod:7927 +#: ../fish/guestfish-actions.pod:5189 ../src/guestfs-actions.pod:7989 msgid "" "Adjust the maximal time between two filesystem checks (in seconds). If the " "option is passed as C<0> then time-dependent checking is disabled." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5141 ../src/guestfs-actions.pod:7931 +#: ../fish/guestfish-actions.pod:5193 ../src/guestfs-actions.pod:7993 msgid "This is the same as the tune2fs C<-i> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5143 ../src/guestfs-actions.pod:7933 +#: ../fish/guestfish-actions.pod:5195 ../src/guestfs-actions.pod:7995 msgid "C<reservedblockspercentage>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5145 ../src/guestfs-actions.pod:7935 +#: ../fish/guestfish-actions.pod:5197 ../src/guestfs-actions.pod:7997 msgid "" "Set the percentage of the filesystem which may only be allocated by " "privileged processes. This is the same as the tune2fs C<-m> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5149 ../src/guestfs-actions.pod:7939 +#: ../fish/guestfish-actions.pod:5201 ../src/guestfs-actions.pod:8001 msgid "C<lastmounteddirectory>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5151 ../src/guestfs-actions.pod:7941 +#: ../fish/guestfish-actions.pod:5203 ../src/guestfs-actions.pod:8003 msgid "" "Set the last mounted directory. This is the same as the tune2fs C<-M> " "option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5154 ../src/guestfs-actions.pod:7944 +#: ../fish/guestfish-actions.pod:5206 ../src/guestfs-actions.pod:8006 msgid "" "C<reservedblockscount> Set the number of reserved filesystem blocks. This " "is the same as the tune2fs C<-r> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5158 ../src/guestfs-actions.pod:7948 +#: ../fish/guestfish-actions.pod:5210 ../src/guestfs-actions.pod:8010 msgid "C<user>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5160 ../src/guestfs-actions.pod:7950 +#: ../fish/guestfish-actions.pod:5212 ../src/guestfs-actions.pod:8012 msgid "" "Set the user who can use the reserved filesystem blocks. This is the same " "as the tune2fs C<-u> option except that it can only be specified as a " @@ -17049,19 +17169,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5166 +#: ../fish/guestfish-actions.pod:5218 msgid "" "To get the current values of filesystem parameters, see L</tune2fs-l>. For " "precise details of how tune2fs works, see the L<tune2fs(8)> man page." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5172 +#: ../fish/guestfish-actions.pod:5224 msgid "tune2fs-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5174 +#: ../fish/guestfish-actions.pod:5226 #, no-wrap msgid "" " tune2fs-l device\n" @@ -17069,14 +17189,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5176 ../src/guestfs-actions.pod:7992 +#: ../fish/guestfish-actions.pod:5228 ../src/guestfs-actions.pod:8054 msgid "" "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on " "C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5179 ../src/guestfs-actions.pod:7995 +#: ../fish/guestfish-actions.pod:5231 ../src/guestfs-actions.pod:8057 msgid "" "It is the same as running C<tune2fs -l device>. See L<tune2fs(8)> manpage " "for more details. The list of fields returned isn't clearly defined, and " @@ -17085,12 +17205,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5184 +#: ../fish/guestfish-actions.pod:5236 msgid "txz-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5186 +#: ../fish/guestfish-actions.pod:5238 #, no-wrap msgid "" " txz-in (tarball|-) directory\n" @@ -17098,19 +17218,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5188 ../src/guestfs-actions.pod:8015 +#: ../fish/guestfish-actions.pod:5240 ../src/guestfs-actions.pod:8077 msgid "" "This command uploads and unpacks local file C<tarball> (an I<xz compressed> " "tar file) into C<directory>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5193 +#: ../fish/guestfish-actions.pod:5245 msgid "txz-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5195 +#: ../fish/guestfish-actions.pod:5247 #, no-wrap msgid "" " txz-out directory (tarball|-)\n" @@ -17118,19 +17238,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5197 ../src/guestfs-actions.pod:8029 +#: ../fish/guestfish-actions.pod:5249 ../src/guestfs-actions.pod:8091 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarball> (as an xz compressed tar archive)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5202 +#: ../fish/guestfish-actions.pod:5254 msgid "umask" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5204 +#: ../fish/guestfish-actions.pod:5256 #, no-wrap msgid "" " umask mask\n" @@ -17138,14 +17258,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5206 ../src/guestfs-actions.pod:8042 +#: ../fish/guestfish-actions.pod:5258 ../src/guestfs-actions.pod:8104 msgid "" "This function sets the mask used for creating new files and device nodes to " "C<mask & 0777>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5209 ../src/guestfs-actions.pod:8045 +#: ../fish/guestfish-actions.pod:5261 ../src/guestfs-actions.pod:8107 msgid "" "Typical umask values would be C<022> which creates new files with " "permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates " @@ -17153,7 +17273,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5214 ../src/guestfs-actions.pod:8050 +#: ../fish/guestfish-actions.pod:5266 ../src/guestfs-actions.pod:8112 msgid "" "The default umask is C<022>. This is important because it means that " "directories and device nodes will be created with C<0644> or C<0755> mode " @@ -17161,27 +17281,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5218 +#: ../fish/guestfish-actions.pod:5270 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5221 ../src/guestfs-actions.pod:8057 +#: ../fish/guestfish-actions.pod:5273 ../src/guestfs-actions.pod:8119 msgid "This call returns the previous umask." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5223 +#: ../fish/guestfish-actions.pod:5275 msgid "umount" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5225 +#: ../fish/guestfish-actions.pod:5277 msgid "unmount" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5227 +#: ../fish/guestfish-actions.pod:5279 #, no-wrap msgid "" " umount pathordevice\n" @@ -17189,24 +17309,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5229 ../src/guestfs-actions.pod:8069 +#: ../fish/guestfish-actions.pod:5281 ../src/guestfs-actions.pod:8131 msgid "" "This unmounts the given filesystem. The filesystem may be specified either " "by its mountpoint (path) or the device which contains the filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5233 +#: ../fish/guestfish-actions.pod:5285 msgid "umount-all" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5235 +#: ../fish/guestfish-actions.pod:5287 msgid "unmount-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5237 +#: ../fish/guestfish-actions.pod:5289 #, no-wrap msgid "" " umount-all\n" @@ -17214,22 +17334,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5239 ../src/guestfs-actions.pod:8082 +#: ../fish/guestfish-actions.pod:5291 ../src/guestfs-actions.pod:8144 msgid "This unmounts all mounted filesystems." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5241 ../src/guestfs-actions.pod:8084 +#: ../fish/guestfish-actions.pod:5293 ../src/guestfs-actions.pod:8146 msgid "Some internal mounts are not unmounted by this call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5243 +#: ../fish/guestfish-actions.pod:5295 msgid "upload" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5245 +#: ../fish/guestfish-actions.pod:5297 #, no-wrap msgid "" " upload (filename|-) remotefilename\n" @@ -17237,22 +17357,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5247 ../fish/guestfish-actions.pod:5260 ../src/guestfs-actions.pod:8097 ../src/guestfs-actions.pod:8121 +#: ../fish/guestfish-actions.pod:5299 ../fish/guestfish-actions.pod:5312 ../src/guestfs-actions.pod:8159 ../src/guestfs-actions.pod:8183 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5252 +#: ../fish/guestfish-actions.pod:5304 msgid "See also L</download>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5256 +#: ../fish/guestfish-actions.pod:5308 msgid "upload-offset" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5258 +#: ../fish/guestfish-actions.pod:5310 #, no-wrap msgid "" " upload-offset (filename|-) remotefilename offset\n" @@ -17260,7 +17380,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5263 ../src/guestfs-actions.pod:8124 +#: ../fish/guestfish-actions.pod:5315 ../src/guestfs-actions.pod:8186 msgid "" "C<remotefilename> is overwritten starting at the byte C<offset> specified. " "The intention is to overwrite parts of existing files or devices, although " @@ -17270,7 +17390,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5270 +#: ../fish/guestfish-actions.pod:5322 msgid "" "Note that there is no limit on the amount of data that can be uploaded with " "this call, unlike with L</pwrite>, and this call always writes the full " @@ -17278,17 +17398,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5275 +#: ../fish/guestfish-actions.pod:5327 msgid "See also L</upload>, L</pwrite>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5279 +#: ../fish/guestfish-actions.pod:5331 msgid "utimens" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5281 +#: ../fish/guestfish-actions.pod:5333 #, no-wrap msgid "" " utimens path atsecs atnsecs mtsecs mtnsecs\n" @@ -17296,26 +17416,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5283 ../src/guestfs-actions.pod:8157 +#: ../fish/guestfish-actions.pod:5335 ../src/guestfs-actions.pod:8219 msgid "This command sets the timestamps of a file with nanosecond precision." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5286 ../src/guestfs-actions.pod:8160 +#: ../fish/guestfish-actions.pod:5338 ../src/guestfs-actions.pod:8222 msgid "" "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds " "from the epoch." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5289 ../src/guestfs-actions.pod:8163 +#: ../fish/guestfish-actions.pod:5341 ../src/guestfs-actions.pod:8225 msgid "" "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and " "nanoseconds from the epoch." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5292 ../src/guestfs-actions.pod:8166 +#: ../fish/guestfish-actions.pod:5344 ../src/guestfs-actions.pod:8228 msgid "" "If the C<*nsecs> field contains the special value C<-1> then the " "corresponding timestamp is set to the current time. (The C<*secs> field is " @@ -17323,7 +17443,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5296 ../src/guestfs-actions.pod:8170 +#: ../fish/guestfish-actions.pod:5348 ../src/guestfs-actions.pod:8232 msgid "" "If the C<*nsecs> field contains the special value C<-2> then the " "corresponding timestamp is left unchanged. (The C<*secs> field is ignored " @@ -17331,12 +17451,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5300 +#: ../fish/guestfish-actions.pod:5352 msgid "version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5302 +#: ../fish/guestfish-actions.pod:5354 #, no-wrap msgid "" " version\n" @@ -17344,12 +17464,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5304 ../src/guestfs-actions.pod:8183 +#: ../fish/guestfish-actions.pod:5356 ../src/guestfs-actions.pod:8245 msgid "Return the libguestfs version number that the program is linked against." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5307 ../src/guestfs-actions.pod:8186 +#: ../fish/guestfish-actions.pod:5359 ../src/guestfs-actions.pod:8248 msgid "" "Note that because of dynamic linking this is not necessarily the version of " "libguestfs that you compiled against. You can compile the program, and then " @@ -17358,7 +17478,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5312 ../src/guestfs-actions.pod:8191 +#: ../fish/guestfish-actions.pod:5364 ../src/guestfs-actions.pod:8253 msgid "" "This call was added in version C<1.0.58>. In previous versions of " "libguestfs there was no way to get the version number. From C code you can " @@ -17367,7 +17487,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5318 ../src/guestfs-actions.pod:8197 +#: ../fish/guestfish-actions.pod:5370 ../src/guestfs-actions.pod:8259 msgid "" "The call returns a structure with four elements. The first three (C<major>, " "C<minor> and C<release>) are numbers and correspond to the usual version " @@ -17376,17 +17496,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5324 ../src/guestfs-actions.pod:8203 +#: ../fish/guestfish-actions.pod:5376 ../src/guestfs-actions.pod:8265 msgid "To construct the original version string: C<$major.$minor.$release$extra>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5327 ../src/guestfs-actions.pod:8206 +#: ../fish/guestfish-actions.pod:5379 ../src/guestfs-actions.pod:8268 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5329 +#: ../fish/guestfish-actions.pod:5381 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " @@ -17395,12 +17515,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5335 +#: ../fish/guestfish-actions.pod:5387 msgid "vfs-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5337 +#: ../fish/guestfish-actions.pod:5389 #, no-wrap msgid "" " vfs-label device\n" @@ -17408,27 +17528,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5339 ../src/guestfs-actions.pod:8226 +#: ../fish/guestfish-actions.pod:5391 ../src/guestfs-actions.pod:8288 msgid "This returns the filesystem label of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5342 ../src/guestfs-actions.pod:8229 +#: ../fish/guestfish-actions.pod:5394 ../src/guestfs-actions.pod:8291 msgid "If the filesystem is unlabeled, this returns the empty string." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5344 +#: ../fish/guestfish-actions.pod:5396 msgid "To find a filesystem from the label, use L</findfs-label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5346 +#: ../fish/guestfish-actions.pod:5398 msgid "vfs-type" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5348 +#: ../fish/guestfish-actions.pod:5400 #, no-wrap msgid "" " vfs-type device\n" @@ -17436,14 +17556,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5350 ../src/guestfs-actions.pod:8244 +#: ../fish/guestfish-actions.pod:5402 ../src/guestfs-actions.pod:8306 msgid "" "This command gets the filesystem type corresponding to the filesystem on " "C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5353 ../src/guestfs-actions.pod:8247 +#: ../fish/guestfish-actions.pod:5405 ../src/guestfs-actions.pod:8309 msgid "" "For most filesystems, the result is the name of the Linux VFS module which " "would be used to mount this filesystem if you mounted it without specifying " @@ -17451,12 +17571,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5358 +#: ../fish/guestfish-actions.pod:5410 msgid "vfs-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5360 +#: ../fish/guestfish-actions.pod:5412 #, no-wrap msgid "" " vfs-uuid device\n" @@ -17464,27 +17584,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5362 ../src/guestfs-actions.pod:8263 +#: ../fish/guestfish-actions.pod:5414 ../src/guestfs-actions.pod:8325 msgid "This returns the filesystem UUID of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5365 ../src/guestfs-actions.pod:8266 +#: ../fish/guestfish-actions.pod:5417 ../src/guestfs-actions.pod:8328 msgid "If the filesystem does not have a UUID, this returns the empty string." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5367 +#: ../fish/guestfish-actions.pod:5419 msgid "To find a filesystem from the UUID, use L</findfs-uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5369 +#: ../fish/guestfish-actions.pod:5421 msgid "vg-activate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5371 +#: ../fish/guestfish-actions.pod:5423 #, no-wrap msgid "" " vg-activate true|false 'volgroups ...'\n" @@ -17492,31 +17612,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5373 ../src/guestfs-actions.pod:8282 +#: ../fish/guestfish-actions.pod:5425 ../src/guestfs-actions.pod:8344 msgid "" "This command activates or (if C<activate> is false) deactivates all logical " "volumes in the listed volume groups C<volgroups>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5376 ../src/guestfs-actions.pod:8285 +#: ../fish/guestfish-actions.pod:5428 ../src/guestfs-actions.pod:8347 msgid "This command is the same as running C<vgchange -a y|n volgroups...>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5378 ../src/guestfs-actions.pod:8287 +#: ../fish/guestfish-actions.pod:5430 ../src/guestfs-actions.pod:8349 msgid "" "Note that if C<volgroups> is an empty list then B<all> volume groups are " "activated or deactivated." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5381 +#: ../fish/guestfish-actions.pod:5433 msgid "vg-activate-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5383 +#: ../fish/guestfish-actions.pod:5435 #, no-wrap msgid "" " vg-activate-all true|false\n" @@ -17524,24 +17644,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5385 ../src/guestfs-actions.pod:8300 +#: ../fish/guestfish-actions.pod:5437 ../src/guestfs-actions.pod:8362 msgid "" "This command activates or (if C<activate> is false) deactivates all logical " "volumes in all volume groups." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5388 ../src/guestfs-actions.pod:8303 +#: ../fish/guestfish-actions.pod:5440 ../src/guestfs-actions.pod:8365 msgid "This command is the same as running C<vgchange -a y|n>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5390 +#: ../fish/guestfish-actions.pod:5442 msgid "vgcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5392 +#: ../fish/guestfish-actions.pod:5444 #, no-wrap msgid "" " vgcreate volgroup 'physvols ...'\n" @@ -17549,19 +17669,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5394 ../src/guestfs-actions.pod:8316 +#: ../fish/guestfish-actions.pod:5446 ../src/guestfs-actions.pod:8378 msgid "" "This creates an LVM volume group called C<volgroup> from the non-empty list " "of physical volumes C<physvols>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5397 +#: ../fish/guestfish-actions.pod:5449 msgid "vglvuuids" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5399 +#: ../fish/guestfish-actions.pod:5451 #, no-wrap msgid "" " vglvuuids vgname\n" @@ -17569,31 +17689,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5401 ../src/guestfs-actions.pod:8329 +#: ../fish/guestfish-actions.pod:5453 ../src/guestfs-actions.pod:8391 msgid "" "Given a VG called C<vgname>, this returns the UUIDs of all the logical " "volumes created in this volume group." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5404 +#: ../fish/guestfish-actions.pod:5456 msgid "" "You can use this along with L</lvs> and L</lvuuid> calls to associate " "logical volumes and volume groups." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5407 +#: ../fish/guestfish-actions.pod:5459 msgid "See also L</vgpvuuids>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5409 +#: ../fish/guestfish-actions.pod:5461 msgid "vgpvuuids" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5411 +#: ../fish/guestfish-actions.pod:5463 #, no-wrap msgid "" " vgpvuuids vgname\n" @@ -17601,31 +17721,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5413 ../src/guestfs-actions.pod:8349 +#: ../fish/guestfish-actions.pod:5465 ../src/guestfs-actions.pod:8411 msgid "" "Given a VG called C<vgname>, this returns the UUIDs of all the physical " "volumes that this volume group resides on." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5416 +#: ../fish/guestfish-actions.pod:5468 msgid "" "You can use this along with L</pvs> and L</pvuuid> calls to associate " "physical volumes and volume groups." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5419 +#: ../fish/guestfish-actions.pod:5471 msgid "See also L</vglvuuids>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5421 +#: ../fish/guestfish-actions.pod:5473 msgid "vgremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5423 +#: ../fish/guestfish-actions.pod:5475 #, no-wrap msgid "" " vgremove vgname\n" @@ -17633,22 +17753,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5425 ../src/guestfs-actions.pod:8369 +#: ../fish/guestfish-actions.pod:5477 ../src/guestfs-actions.pod:8431 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5427 ../src/guestfs-actions.pod:8371 +#: ../fish/guestfish-actions.pod:5479 ../src/guestfs-actions.pod:8433 msgid "This also forcibly removes all logical volumes in the volume group (if any)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5430 +#: ../fish/guestfish-actions.pod:5482 msgid "vgrename" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5432 +#: ../fish/guestfish-actions.pod:5484 #, no-wrap msgid "" " vgrename volgroup newvolgroup\n" @@ -17656,17 +17776,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5434 ../src/guestfs-actions.pod:8385 +#: ../fish/guestfish-actions.pod:5486 ../src/guestfs-actions.pod:8447 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5436 +#: ../fish/guestfish-actions.pod:5488 msgid "vgs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5438 +#: ../fish/guestfish-actions.pod:5490 #, no-wrap msgid "" " vgs\n" @@ -17674,31 +17794,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5440 ../src/guestfs-actions.pod:8396 +#: ../fish/guestfish-actions.pod:5492 ../src/guestfs-actions.pod:8458 msgid "" "List all the volumes groups detected. This is the equivalent of the " "L<vgs(8)> command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5443 ../src/guestfs-actions.pod:8399 +#: ../fish/guestfish-actions.pod:5495 ../src/guestfs-actions.pod:8461 msgid "" "This returns a list of just the volume group names that were detected " "(eg. C<VolGroup00>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5446 +#: ../fish/guestfish-actions.pod:5498 msgid "See also L</vgs-full>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5448 +#: ../fish/guestfish-actions.pod:5500 msgid "vgs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5450 +#: ../fish/guestfish-actions.pod:5502 #, no-wrap msgid "" " vgs-full\n" @@ -17706,19 +17826,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5452 ../src/guestfs-actions.pod:8415 +#: ../fish/guestfish-actions.pod:5504 ../src/guestfs-actions.pod:8477 msgid "" "List all the volumes groups detected. This is the equivalent of the " "L<vgs(8)> command. The \"full\" version includes all fields." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5455 +#: ../fish/guestfish-actions.pod:5507 msgid "vgscan" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5457 +#: ../fish/guestfish-actions.pod:5509 #, no-wrap msgid "" " vgscan\n" @@ -17726,19 +17846,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5459 ../src/guestfs-actions.pod:8429 +#: ../fish/guestfish-actions.pod:5511 ../src/guestfs-actions.pod:8491 msgid "" "This rescans all block devices and rebuilds the list of LVM physical " "volumes, volume groups and logical volumes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5462 +#: ../fish/guestfish-actions.pod:5514 msgid "vguuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5464 +#: ../fish/guestfish-actions.pod:5516 #, no-wrap msgid "" " vguuid vgname\n" @@ -17746,17 +17866,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5466 ../src/guestfs-actions.pod:8442 +#: ../fish/guestfish-actions.pod:5518 ../src/guestfs-actions.pod:8504 msgid "This command returns the UUID of the LVM VG named C<vgname>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5468 +#: ../fish/guestfish-actions.pod:5520 msgid "wc-c" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5470 +#: ../fish/guestfish-actions.pod:5522 #, no-wrap msgid "" " wc-c path\n" @@ -17764,19 +17884,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5472 ../src/guestfs-actions.pod:8482 +#: ../fish/guestfish-actions.pod:5524 ../src/guestfs-actions.pod:8544 msgid "" "This command counts the characters in a file, using the C<wc -c> external " "command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5475 +#: ../fish/guestfish-actions.pod:5527 msgid "wc-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5477 +#: ../fish/guestfish-actions.pod:5529 #, no-wrap msgid "" " wc-l path\n" @@ -17784,19 +17904,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5479 ../src/guestfs-actions.pod:8495 +#: ../fish/guestfish-actions.pod:5531 ../src/guestfs-actions.pod:8557 msgid "" "This command counts the lines in a file, using the C<wc -l> external " "command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5482 +#: ../fish/guestfish-actions.pod:5534 msgid "wc-w" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5484 +#: ../fish/guestfish-actions.pod:5536 #, no-wrap msgid "" " wc-w path\n" @@ -17804,19 +17924,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5486 ../src/guestfs-actions.pod:8508 +#: ../fish/guestfish-actions.pod:5538 ../src/guestfs-actions.pod:8570 msgid "" "This command counts the words in a file, using the C<wc -w> external " "command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5489 +#: ../fish/guestfish-actions.pod:5541 msgid "write" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5491 +#: ../fish/guestfish-actions.pod:5543 #, no-wrap msgid "" " write path content\n" @@ -17824,24 +17944,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5493 ../src/guestfs-actions.pod:8523 +#: ../fish/guestfish-actions.pod:5545 ../src/guestfs-actions.pod:8585 msgid "" "This call creates a file called C<path>. The content of the file is the " "string C<content> (which can contain any 8 bit data)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5496 +#: ../fish/guestfish-actions.pod:5548 msgid "See also L</write-append>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5501 +#: ../fish/guestfish-actions.pod:5553 msgid "write-append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5503 +#: ../fish/guestfish-actions.pod:5555 #, no-wrap msgid "" " write-append path content\n" @@ -17849,24 +17969,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5505 ../src/guestfs-actions.pod:8543 +#: ../fish/guestfish-actions.pod:5557 ../src/guestfs-actions.pod:8605 msgid "" "This call appends C<content> to the end of file C<path>. If C<path> does " "not exist, then a new file is created." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5508 +#: ../fish/guestfish-actions.pod:5560 msgid "See also L</write>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5513 +#: ../fish/guestfish-actions.pod:5565 msgid "write-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5515 +#: ../fish/guestfish-actions.pod:5567 #, no-wrap msgid "" " write-file path content size\n" @@ -17874,38 +17994,38 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5517 ../src/guestfs-actions.pod:8570 +#: ../fish/guestfish-actions.pod:5569 ../src/guestfs-actions.pod:8632 msgid "" "This call creates a file called C<path>. The contents of the file is the " "string C<content> (which can contain any 8 bit data), with length C<size>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5521 ../src/guestfs-actions.pod:8574 +#: ../fish/guestfish-actions.pod:5573 ../src/guestfs-actions.pod:8636 msgid "" "As a special case, if C<size> is C<0> then the length is calculated using " "C<strlen> (so in this case the content cannot contain embedded ASCII NULs)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5525 ../src/guestfs-actions.pod:8578 +#: ../fish/guestfish-actions.pod:5577 ../src/guestfs-actions.pod:8640 msgid "" "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does " "I<not> work, even if the length is specified." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5531 +#: ../fish/guestfish-actions.pod:5583 msgid "I<This function is deprecated.> In new code, use the L</write> call instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5538 +#: ../fish/guestfish-actions.pod:5590 msgid "zegrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5540 +#: ../fish/guestfish-actions.pod:5592 #, no-wrap msgid "" " zegrep regex path\n" @@ -17913,17 +18033,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5542 ../src/guestfs-actions.pod:8595 +#: ../fish/guestfish-actions.pod:5594 ../src/guestfs-actions.pod:8657 msgid "This calls the external C<zegrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5548 +#: ../fish/guestfish-actions.pod:5600 msgid "zegrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5550 +#: ../fish/guestfish-actions.pod:5602 #, no-wrap msgid "" " zegrepi regex path\n" @@ -17931,17 +18051,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5552 ../src/guestfs-actions.pod:8614 +#: ../fish/guestfish-actions.pod:5604 ../src/guestfs-actions.pod:8676 msgid "This calls the external C<zegrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5558 +#: ../fish/guestfish-actions.pod:5610 msgid "zero" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5560 +#: ../fish/guestfish-actions.pod:5612 #, no-wrap msgid "" " zero device\n" @@ -17949,12 +18069,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5562 ../src/guestfs-actions.pod:8632 +#: ../fish/guestfish-actions.pod:5614 ../src/guestfs-actions.pod:8694 msgid "This command writes zeroes over the first few blocks of C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5564 ../src/guestfs-actions.pod:8634 +#: ../fish/guestfish-actions.pod:5616 ../src/guestfs-actions.pod:8696 msgid "" "How many blocks are zeroed isn't specified (but it's I<not> enough to " "securely wipe the device). It should be sufficient to remove any partition " @@ -17962,7 +18082,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5568 ../fish/guestfish-actions.pod:5583 ../src/guestfs-actions.pod:8638 ../src/guestfs-actions.pod:8664 +#: ../fish/guestfish-actions.pod:5620 ../fish/guestfish-actions.pod:5635 ../src/guestfs-actions.pod:8700 ../src/guestfs-actions.pod:8726 msgid "" "If blocks are already zero, then this command avoids writing zeroes. This " "prevents the underlying device from becoming non-sparse or growing " @@ -17970,17 +18090,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5572 +#: ../fish/guestfish-actions.pod:5624 msgid "See also: L</zero-device>, L</scrub-device>, L</is-zero-device>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5575 +#: ../fish/guestfish-actions.pod:5627 msgid "zero-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5577 +#: ../fish/guestfish-actions.pod:5629 #, no-wrap msgid "" " zero-device device\n" @@ -17988,19 +18108,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5579 +#: ../fish/guestfish-actions.pod:5631 msgid "" "This command writes zeroes over the entire C<device>. Compare with L</zero> " "which just zeroes the first few blocks of a device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5587 +#: ../fish/guestfish-actions.pod:5639 msgid "zerofree" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5589 +#: ../fish/guestfish-actions.pod:5641 #, no-wrap msgid "" " zerofree device\n" @@ -18008,7 +18128,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5591 ../src/guestfs-actions.pod:8683 +#: ../fish/guestfish-actions.pod:5643 ../src/guestfs-actions.pod:8745 msgid "" "This runs the I<zerofree> program on C<device>. This program claims to zero " "unused inodes and disk blocks on an ext2/3 filesystem, thus making it " @@ -18016,24 +18136,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5596 ../src/guestfs-actions.pod:8688 +#: ../fish/guestfish-actions.pod:5648 ../src/guestfs-actions.pod:8750 msgid "You should B<not> run this program if the filesystem is mounted." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5599 ../src/guestfs-actions.pod:8691 +#: ../fish/guestfish-actions.pod:5651 ../src/guestfs-actions.pod:8753 msgid "" "It is possible that using this program can damage the filesystem or data on " "the filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5602 +#: ../fish/guestfish-actions.pod:5654 msgid "zfgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5604 +#: ../fish/guestfish-actions.pod:5656 #, no-wrap msgid "" " zfgrep pattern path\n" @@ -18041,17 +18161,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5606 ../src/guestfs-actions.pod:8705 +#: ../fish/guestfish-actions.pod:5658 ../src/guestfs-actions.pod:8767 msgid "This calls the external C<zfgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5612 +#: ../fish/guestfish-actions.pod:5664 msgid "zfgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5614 +#: ../fish/guestfish-actions.pod:5666 #, no-wrap msgid "" " zfgrepi pattern path\n" @@ -18059,17 +18179,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5616 ../src/guestfs-actions.pod:8724 +#: ../fish/guestfish-actions.pod:5668 ../src/guestfs-actions.pod:8786 msgid "This calls the external C<zfgrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5622 +#: ../fish/guestfish-actions.pod:5674 msgid "zfile" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5624 +#: ../fish/guestfish-actions.pod:5676 #, no-wrap msgid "" " zfile meth path\n" @@ -18077,32 +18197,32 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5626 ../src/guestfs-actions.pod:8750 +#: ../fish/guestfish-actions.pod:5678 ../src/guestfs-actions.pod:8812 msgid "This command runs C<file> after first decompressing C<path> using C<method>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5629 ../src/guestfs-actions.pod:8753 +#: ../fish/guestfish-actions.pod:5681 ../src/guestfs-actions.pod:8815 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5631 +#: ../fish/guestfish-actions.pod:5683 msgid "Since 1.0.63, use L</file> instead which can now process compressed files." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5634 +#: ../fish/guestfish-actions.pod:5686 msgid "I<This function is deprecated.> In new code, use the L</file> call instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5641 +#: ../fish/guestfish-actions.pod:5693 msgid "zgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5643 +#: ../fish/guestfish-actions.pod:5695 #, no-wrap msgid "" " zgrep regex path\n" @@ -18110,17 +18230,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5645 ../src/guestfs-actions.pod:8770 +#: ../fish/guestfish-actions.pod:5697 ../src/guestfs-actions.pod:8832 msgid "This calls the external C<zgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5651 +#: ../fish/guestfish-actions.pod:5703 msgid "zgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5653 +#: ../fish/guestfish-actions.pod:5705 #, no-wrap msgid "" " zgrepi regex path\n" @@ -18128,7 +18248,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5655 ../src/guestfs-actions.pod:8789 +#: ../fish/guestfish-actions.pod:5707 ../src/guestfs-actions.pod:8851 msgid "This calls the external C<zgrep -i> program and returns the matching lines." msgstr "" @@ -19107,7 +19227,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:135 ../src/guestfs.pod:2231 +#: ../fish/guestfish.pod:135 ../src/guestfs.pod:2254 #, no-wrap msgid "" " guestfish -N fs\n" @@ -20574,7 +20694,7 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:825 ../src/guestfs.pod:515 +#: ../fish/guestfish.pod:825 ../src/guestfs.pod:513 msgid "ENCRYPTED DISKS" msgstr "" @@ -20938,7 +21058,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:982 ../src/guestfs.pod:968 +#: ../fish/guestfish.pod:982 ../src/guestfs.pod:966 #, no-wrap msgid "" " #!/bin/bash -\n" @@ -21224,7 +21344,7 @@ msgid "COMMANDS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1112 ../src/guestfs.pod:1508 +#: ../fish/guestfish.pod:1112 ../src/guestfs.pod:1531 msgid "@ACTIONS@" msgstr "" @@ -21248,17 +21368,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1128 ../src/guestfs.pod:3193 +#: ../fish/guestfish.pod:1128 ../src/guestfs.pod:3216 msgid "FEBOOTSTRAP_KERNEL" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1130 ../src/guestfs.pod:3195 +#: ../fish/guestfish.pod:1130 ../src/guestfs.pod:3218 msgid "FEBOOTSTRAP_MODULES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1132 ../src/guestfs.pod:3197 +#: ../fish/guestfish.pod:1132 ../src/guestfs.pod:3220 msgid "" "These two environment variables allow the kernel that libguestfs uses in the " "appliance to be selected. If C<$FEBOOTSTRAP_KERNEL> is not set, then the " @@ -21316,17 +21436,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1160 ../src/guestfs.pod:3203 +#: ../fish/guestfish.pod:1160 ../src/guestfs.pod:3226 msgid "LIBGUESTFS_APPEND" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1162 ../src/guestfs.pod:3205 +#: ../fish/guestfish.pod:1162 ../src/guestfs.pod:3228 msgid "Pass additional options to the guest kernel." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1164 ../src/guestfs.pod:3207 +#: ../fish/guestfish.pod:1164 ../src/guestfs.pod:3230 msgid "LIBGUESTFS_DEBUG" msgstr "" @@ -21338,17 +21458,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1169 ../src/guestfs.pod:3212 +#: ../fish/guestfish.pod:1169 ../src/guestfs.pod:3235 msgid "LIBGUESTFS_MEMSIZE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1171 ../src/guestfs.pod:3214 +#: ../fish/guestfish.pod:1171 ../src/guestfs.pod:3237 msgid "Set the memory allocated to the qemu process, in megabytes. For example:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1174 ../src/guestfs.pod:3217 +#: ../fish/guestfish.pod:1174 ../src/guestfs.pod:3240 #, no-wrap msgid "" " LIBGUESTFS_MEMSIZE=700\n" @@ -21356,7 +21476,7 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1176 ../src/guestfs.pod:3219 +#: ../fish/guestfish.pod:1176 ../src/guestfs.pod:3242 msgid "LIBGUESTFS_PATH" msgstr "" @@ -21368,19 +21488,19 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1181 ../src/guestfs.pod:3224 +#: ../fish/guestfish.pod:1181 ../src/guestfs.pod:3247 msgid "LIBGUESTFS_QEMU" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1183 ../src/guestfs.pod:3226 +#: ../fish/guestfish.pod:1183 ../src/guestfs.pod:3249 msgid "" "Set the default qemu binary that libguestfs uses. If not set, then the qemu " "which was found at compile time by the configure script is used." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1187 ../src/guestfs.pod:3232 +#: ../fish/guestfish.pod:1187 ../src/guestfs.pod:3255 msgid "LIBGUESTFS_TRACE" msgstr "" @@ -21402,19 +21522,19 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1196 ../sparsify/virt-sparsify.pod:261 ../src/guestfs.pod:3237 +#: ../fish/guestfish.pod:1196 ../sparsify/virt-sparsify.pod:261 ../src/guestfs.pod:3260 msgid "TMPDIR" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1198 ../src/guestfs.pod:3239 +#: ../fish/guestfish.pod:1198 ../src/guestfs.pod:3262 msgid "" "Location of temporary directory, defaults to C</tmp> except for the cached " "supermin appliance which defaults to C</var/tmp>." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1201 ../src/guestfs.pod:3242 +#: ../fish/guestfish.pod:1201 ../src/guestfs.pod:3265 msgid "" "If libguestfs was compiled to use the supermin appliance then the real " "appliance is cached in this directory, shared between all handles belonging " @@ -21559,7 +21679,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1302 ../fuse/guestmount.pod:334 ../src/guestfs.pod:3337 ../test-tool/libguestfs-test-tool.pod:118 +#: ../fish/guestfish.pod:1302 ../fuse/guestmount.pod:334 ../src/guestfs.pod:3360 ../test-tool/libguestfs-test-tool.pod:118 msgid "Copyright (C) 2009-2012 Red Hat Inc. L<http://libguestfs.org/>" msgstr "" @@ -24171,7 +24291,7 @@ msgid "" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:31 ../resize/virt-resize.pod:603 ../sparsify/virt-sparsify.pod:228 ../src/guestfs.pod:465 ../src/guestfs.pod:1290 ../src/guestfs.pod:1429 ../src/guestfs.pod:2678 +#: ../resize/virt-resize.pod:31 ../resize/virt-resize.pod:603 ../sparsify/virt-sparsify.pod:228 ../src/guestfs.pod:463 ../src/guestfs.pod:1288 ../src/guestfs.pod:1452 ../src/guestfs.pod:2701 msgid "1." msgstr "" @@ -24209,7 +24329,7 @@ msgid "" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:44 ../resize/virt-resize.pod:610 ../sparsify/virt-sparsify.pod:235 ../src/guestfs.pod:471 ../src/guestfs.pod:1294 ../src/guestfs.pod:1433 ../src/guestfs.pod:2703 +#: ../resize/virt-resize.pod:44 ../resize/virt-resize.pod:610 ../sparsify/virt-sparsify.pod:235 ../src/guestfs.pod:469 ../src/guestfs.pod:1292 ../src/guestfs.pod:1456 ../src/guestfs.pod:2726 msgid "2." msgstr "" @@ -24230,7 +24350,7 @@ msgid "" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:52 ../resize/virt-resize.pod:616 ../sparsify/virt-sparsify.pod:241 ../src/guestfs.pod:482 ../src/guestfs.pod:1439 +#: ../resize/virt-resize.pod:52 ../resize/virt-resize.pod:616 ../sparsify/virt-sparsify.pod:241 ../src/guestfs.pod:480 ../src/guestfs.pod:1462 msgid "3." msgstr "" @@ -25962,12 +26082,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:37 ../src/guestfs-actions.pod:187 ../src/guestfs-actions.pod:254 ../src/guestfs-actions.pod:291 ../src/guestfs-actions.pod:312 ../src/guestfs-actions.pod:333 ../src/guestfs-actions.pod:346 ../src/guestfs-actions.pod:360 ../src/guestfs-actions.pod:480 ../src/guestfs-actions.pod:500 ../src/guestfs-actions.pod:514 ../src/guestfs-actions.pod:559 ../src/guestfs-actions.pod:587 ../src/guestfs-actions.pod:605 ../src/guestfs-actions.pod:672 ../src/guestfs-actions.pod:705 ../src/guestfs-actions.pod:719 ../src/guestfs-actions.pod:775 ../src/guestfs-actions.pod:874 ../src/guestfs-actions.pod:892 ../src/guestfs-actions.pod:906 ../src/guestfs-actions.pod:920 ../src/guestfs-actions.pod:957 ../src/guestfs-actions.pod:1140 ../src/guestfs-actions.pod:1160 ../src/guestfs-actions.pod:1178 ../src/guestfs-actions.pod:1268 ../src/guestfs-actions.pod:1327 ../src/guestfs-actions.pod:1373 ../src/guestfs-actions.pod:1413 ../src/guestfs-actions.pod:1466 ../src/guestfs-actions.pod:1519 ../src/guestfs-actions.pod:1577 ../src/guestfs-actions.pod:1631 ../src/guestfs-actions.pod:1650 ../src/guestfs-actions.pod:1664 ../src/guestfs-actions.pod:1692 ../src/guestfs-actions.pod:1762 ../src/guestfs-actions.pod:1793 ../src/guestfs-actions.pod:1818 ../src/guestfs-actions.pod:1884 ../src/guestfs-actions.pod:1923 ../src/guestfs-actions.pod:2036 ../src/guestfs-actions.pod:2063 ../src/guestfs-actions.pod:2278 ../src/guestfs-actions.pod:2300 ../src/guestfs-actions.pod:2387 ../src/guestfs-actions.pod:2895 ../src/guestfs-actions.pod:3039 ../src/guestfs-actions.pod:3098 ../src/guestfs-actions.pod:3133 ../src/guestfs-actions.pod:4194 ../src/guestfs-actions.pod:4209 ../src/guestfs-actions.pod:4234 ../src/guestfs-actions.pod:4436 ../src/guestfs-actions.pod:4450 ../src/guestfs-actions.pod:4463 ../src/guestfs-actions.pod:4477 ../src/guestfs-actions.pod:4492 ../src/guestfs-actions.pod:4528 ../src/guestfs-actions.pod:4600 ../src/guestfs-actions.pod:4620 ../src/guestfs-actions.pod:4637 ../src/guestfs-actions.pod:4657 ../src/guestfs-actions.pod:4677 ../src/guestfs-actions.pod:4712 ../src/guestfs-actions.pod:4731 ../src/guestfs-actions.pod:4750 ../src/guestfs-actions.pod:4785 ../src/guestfs-actions.pod:4797 ../src/guestfs-actions.pod:4830 ../src/guestfs-actions.pod:4846 ../src/guestfs-actions.pod:4859 ../src/guestfs-actions.pod:4874 ../src/guestfs-actions.pod:4891 ../src/guestfs-actions.pod:5049 ../src/guestfs-actions.pod:5128 ../src/guestfs-actions.pod:5140 ../src/guestfs-actions.pod:5160 ../src/guestfs-actions.pod:5173 ../src/guestfs-actions.pod:5224 ../src/guestfs-actions.pod:5242 ../src/guestfs-actions.pod:5260 ../src/guestfs-actions.pod:5276 ../src/guestfs-actions.pod:5290 ../src/guestfs-actions.pod:5304 ../src/guestfs-actions.pod:5321 ../src/guestfs-actions.pod:5336 ../src/guestfs-actions.pod:5363 ../src/guestfs-actions.pod:5426 ../src/guestfs-actions.pod:5499 ../src/guestfs-actions.pod:5530 ../src/guestfs-actions.pod:5549 ../src/guestfs-actions.pod:5568 ../src/guestfs-actions.pod:5580 ../src/guestfs-actions.pod:5597 ../src/guestfs-actions.pod:5610 ../src/guestfs-actions.pod:5625 ../src/guestfs-actions.pod:5640 ../src/guestfs-actions.pod:5672 ../src/guestfs-actions.pod:5698 ../src/guestfs-actions.pod:5737 ../src/guestfs-actions.pod:5757 ../src/guestfs-actions.pod:5771 ../src/guestfs-actions.pod:5788 ../src/guestfs-actions.pod:5837 ../src/guestfs-actions.pod:5890 ../src/guestfs-actions.pod:5937 ../src/guestfs-actions.pod:5980 ../src/guestfs-actions.pod:6008 ../src/guestfs-actions.pod:6025 ../src/guestfs-actions.pod:6043 ../src/guestfs-actions.pod:6180 ../src/guestfs-actions.pod:6237 ../src/guestfs-actions.pod:6259 ../src/guestfs-actions.pod:6277 ../src/guestfs-actions.pod:6329 ../src/guestfs-actions.pod:6395 ../src/guestfs-actions.pod:6412 ../src/guestfs-actions.pod:6425 ../src/guestfs-actions.pod:6439 ../src/guestfs-actions.pod:6728 ../src/guestfs-actions.pod:6747 ../src/guestfs-actions.pod:6766 ../src/guestfs-actions.pod:6780 ../src/guestfs-actions.pod:6792 ../src/guestfs-actions.pod:6806 ../src/guestfs-actions.pod:6818 ../src/guestfs-actions.pod:6832 ../src/guestfs-actions.pod:6848 ../src/guestfs-actions.pod:6866 ../src/guestfs-actions.pod:6885 ../src/guestfs-actions.pod:6904 ../src/guestfs-actions.pod:6934 ../src/guestfs-actions.pod:6952 ../src/guestfs-actions.pod:6975 ../src/guestfs-actions.pod:6993 ../src/guestfs-actions.pod:7012 ../src/guestfs-actions.pod:7033 ../src/guestfs-actions.pod:7052 ../src/guestfs-actions.pod:7069 ../src/guestfs-actions.pod:7090 ../src/guestfs-actions.pod:7118 ../src/guestfs-actions.pod:7142 ../src/guestfs-actions.pod:7161 ../src/guestfs-actions.pod:7177 ../src/guestfs-actions.pod:7201 ../src/guestfs-actions.pod:7220 ../src/guestfs-actions.pod:7235 ../src/guestfs-actions.pod:7254 ../src/guestfs-actions.pod:7298 ../src/guestfs-actions.pod:7325 ../src/guestfs-actions.pod:7355 ../src/guestfs-actions.pod:7467 ../src/guestfs-actions.pod:7588 ../src/guestfs-actions.pod:7600 ../src/guestfs-actions.pod:7613 ../src/guestfs-actions.pod:7626 ../src/guestfs-actions.pod:7648 ../src/guestfs-actions.pod:7661 ../src/guestfs-actions.pod:7674 ../src/guestfs-actions.pod:7687 ../src/guestfs-actions.pod:7702 ../src/guestfs-actions.pod:7761 ../src/guestfs-actions.pod:7778 ../src/guestfs-actions.pod:7794 ../src/guestfs-actions.pod:7810 ../src/guestfs-actions.pod:7827 ../src/guestfs-actions.pod:7840 ../src/guestfs-actions.pod:7860 ../src/guestfs-actions.pod:7960 ../src/guestfs-actions.pod:8018 ../src/guestfs-actions.pod:8032 ../src/guestfs-actions.pod:8073 ../src/guestfs-actions.pod:8086 ../src/guestfs-actions.pod:8104 ../src/guestfs-actions.pod:8138 ../src/guestfs-actions.pod:8174 ../src/guestfs-actions.pod:8290 ../src/guestfs-actions.pod:8305 ../src/guestfs-actions.pod:8319 ../src/guestfs-actions.pod:8374 ../src/guestfs-actions.pod:8387 ../src/guestfs-actions.pod:8432 ../src/guestfs-actions.pod:8472 ../src/guestfs-actions.pod:8528 ../src/guestfs-actions.pod:8548 ../src/guestfs-actions.pod:8581 ../src/guestfs-actions.pod:8645 ../src/guestfs-actions.pod:8668 ../src/guestfs-actions.pod:8694 +#: ../src/guestfs-actions.pod:37 ../src/guestfs-actions.pod:187 ../src/guestfs-actions.pod:254 ../src/guestfs-actions.pod:291 ../src/guestfs-actions.pod:312 ../src/guestfs-actions.pod:333 ../src/guestfs-actions.pod:346 ../src/guestfs-actions.pod:360 ../src/guestfs-actions.pod:480 ../src/guestfs-actions.pod:500 ../src/guestfs-actions.pod:514 ../src/guestfs-actions.pod:559 ../src/guestfs-actions.pod:587 ../src/guestfs-actions.pod:605 ../src/guestfs-actions.pod:672 ../src/guestfs-actions.pod:705 ../src/guestfs-actions.pod:719 ../src/guestfs-actions.pod:775 ../src/guestfs-actions.pod:874 ../src/guestfs-actions.pod:892 ../src/guestfs-actions.pod:906 ../src/guestfs-actions.pod:920 ../src/guestfs-actions.pod:957 ../src/guestfs-actions.pod:1140 ../src/guestfs-actions.pod:1160 ../src/guestfs-actions.pod:1178 ../src/guestfs-actions.pod:1268 ../src/guestfs-actions.pod:1327 ../src/guestfs-actions.pod:1373 ../src/guestfs-actions.pod:1413 ../src/guestfs-actions.pod:1466 ../src/guestfs-actions.pod:1519 ../src/guestfs-actions.pod:1577 ../src/guestfs-actions.pod:1631 ../src/guestfs-actions.pod:1650 ../src/guestfs-actions.pod:1664 ../src/guestfs-actions.pod:1692 ../src/guestfs-actions.pod:1778 ../src/guestfs-actions.pod:1809 ../src/guestfs-actions.pod:1834 ../src/guestfs-actions.pod:1900 ../src/guestfs-actions.pod:1939 ../src/guestfs-actions.pod:2052 ../src/guestfs-actions.pod:2079 ../src/guestfs-actions.pod:2294 ../src/guestfs-actions.pod:2316 ../src/guestfs-actions.pod:2403 ../src/guestfs-actions.pod:2911 ../src/guestfs-actions.pod:3055 ../src/guestfs-actions.pod:3114 ../src/guestfs-actions.pod:3149 ../src/guestfs-actions.pod:4219 ../src/guestfs-actions.pod:4234 ../src/guestfs-actions.pod:4259 ../src/guestfs-actions.pod:4461 ../src/guestfs-actions.pod:4475 ../src/guestfs-actions.pod:4488 ../src/guestfs-actions.pod:4502 ../src/guestfs-actions.pod:4517 ../src/guestfs-actions.pod:4553 ../src/guestfs-actions.pod:4625 ../src/guestfs-actions.pod:4645 ../src/guestfs-actions.pod:4662 ../src/guestfs-actions.pod:4682 ../src/guestfs-actions.pod:4702 ../src/guestfs-actions.pod:4737 ../src/guestfs-actions.pod:4756 ../src/guestfs-actions.pod:4775 ../src/guestfs-actions.pod:4810 ../src/guestfs-actions.pod:4822 ../src/guestfs-actions.pod:4855 ../src/guestfs-actions.pod:4871 ../src/guestfs-actions.pod:4884 ../src/guestfs-actions.pod:4899 ../src/guestfs-actions.pod:4916 ../src/guestfs-actions.pod:5074 ../src/guestfs-actions.pod:5153 ../src/guestfs-actions.pod:5165 ../src/guestfs-actions.pod:5185 ../src/guestfs-actions.pod:5198 ../src/guestfs-actions.pod:5249 ../src/guestfs-actions.pod:5267 ../src/guestfs-actions.pod:5285 ../src/guestfs-actions.pod:5301 ../src/guestfs-actions.pod:5315 ../src/guestfs-actions.pod:5329 ../src/guestfs-actions.pod:5346 ../src/guestfs-actions.pod:5361 ../src/guestfs-actions.pod:5388 ../src/guestfs-actions.pod:5451 ../src/guestfs-actions.pod:5524 ../src/guestfs-actions.pod:5555 ../src/guestfs-actions.pod:5574 ../src/guestfs-actions.pod:5593 ../src/guestfs-actions.pod:5605 ../src/guestfs-actions.pod:5622 ../src/guestfs-actions.pod:5635 ../src/guestfs-actions.pod:5650 ../src/guestfs-actions.pod:5665 ../src/guestfs-actions.pod:5697 ../src/guestfs-actions.pod:5723 ../src/guestfs-actions.pod:5762 ../src/guestfs-actions.pod:5782 ../src/guestfs-actions.pod:5796 ../src/guestfs-actions.pod:5813 ../src/guestfs-actions.pod:5862 ../src/guestfs-actions.pod:5929 ../src/guestfs-actions.pod:5976 ../src/guestfs-actions.pod:6019 ../src/guestfs-actions.pod:6047 ../src/guestfs-actions.pod:6064 ../src/guestfs-actions.pod:6082 ../src/guestfs-actions.pod:6219 ../src/guestfs-actions.pod:6276 ../src/guestfs-actions.pod:6298 ../src/guestfs-actions.pod:6316 ../src/guestfs-actions.pod:6368 ../src/guestfs-actions.pod:6434 ../src/guestfs-actions.pod:6451 ../src/guestfs-actions.pod:6464 ../src/guestfs-actions.pod:6478 ../src/guestfs-actions.pod:6767 ../src/guestfs-actions.pod:6786 ../src/guestfs-actions.pod:6805 ../src/guestfs-actions.pod:6819 ../src/guestfs-actions.pod:6831 ../src/guestfs-actions.pod:6845 ../src/guestfs-actions.pod:6857 ../src/guestfs-actions.pod:6871 ../src/guestfs-actions.pod:6887 ../src/guestfs-actions.pod:6905 ../src/guestfs-actions.pod:6924 ../src/guestfs-actions.pod:6943 ../src/guestfs-actions.pod:6973 ../src/guestfs-actions.pod:6991 ../src/guestfs-actions.pod:7014 ../src/guestfs-actions.pod:7032 ../src/guestfs-actions.pod:7051 ../src/guestfs-actions.pod:7072 ../src/guestfs-actions.pod:7091 ../src/guestfs-actions.pod:7108 ../src/guestfs-actions.pod:7129 ../src/guestfs-actions.pod:7157 ../src/guestfs-actions.pod:7181 ../src/guestfs-actions.pod:7200 ../src/guestfs-actions.pod:7216 ../src/guestfs-actions.pod:7240 ../src/guestfs-actions.pod:7259 ../src/guestfs-actions.pod:7274 ../src/guestfs-actions.pod:7293 ../src/guestfs-actions.pod:7337 ../src/guestfs-actions.pod:7364 ../src/guestfs-actions.pod:7394 ../src/guestfs-actions.pod:7519 ../src/guestfs-actions.pod:7529 ../src/guestfs-actions.pod:7650 ../src/guestfs-actions.pod:7662 ../src/guestfs-actions.pod:7675 ../src/guestfs-actions.pod:7688 ../src/guestfs-actions.pod:7710 ../src/guestfs-actions.pod:7723 ../src/guestfs-actions.pod:7736 ../src/guestfs-actions.pod:7749 ../src/guestfs-actions.pod:7764 ../src/guestfs-actions.pod:7823 ../src/guestfs-actions.pod:7840 ../src/guestfs-actions.pod:7856 ../src/guestfs-actions.pod:7872 ../src/guestfs-actions.pod:7889 ../src/guestfs-actions.pod:7902 ../src/guestfs-actions.pod:7922 ../src/guestfs-actions.pod:8022 ../src/guestfs-actions.pod:8080 ../src/guestfs-actions.pod:8094 ../src/guestfs-actions.pod:8135 ../src/guestfs-actions.pod:8148 ../src/guestfs-actions.pod:8166 ../src/guestfs-actions.pod:8200 ../src/guestfs-actions.pod:8236 ../src/guestfs-actions.pod:8352 ../src/guestfs-actions.pod:8367 ../src/guestfs-actions.pod:8381 ../src/guestfs-actions.pod:8436 ../src/guestfs-actions.pod:8449 ../src/guestfs-actions.pod:8494 ../src/guestfs-actions.pod:8534 ../src/guestfs-actions.pod:8590 ../src/guestfs-actions.pod:8610 ../src/guestfs-actions.pod:8643 ../src/guestfs-actions.pod:8707 ../src/guestfs-actions.pod:8730 ../src/guestfs-actions.pod:8756 msgid "This function returns 0 on success or -1 on error." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:189 ../src/guestfs-actions.pod:1375 ../src/guestfs-actions.pod:2501 ../src/guestfs-actions.pod:2599 ../src/guestfs-actions.pod:2724 ../src/guestfs-actions.pod:4196 ../src/guestfs-actions.pod:4216 ../src/guestfs-actions.pod:5674 ../src/guestfs-actions.pod:6954 ../src/guestfs-actions.pod:7071 ../src/guestfs-actions.pod:7222 ../src/guestfs-actions.pod:7704 ../src/guestfs-actions.pod:7829 ../src/guestfs-actions.pod:8474 +#: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:189 ../src/guestfs-actions.pod:1375 ../src/guestfs-actions.pod:2517 ../src/guestfs-actions.pod:2615 ../src/guestfs-actions.pod:2740 ../src/guestfs-actions.pod:4221 ../src/guestfs-actions.pod:4241 ../src/guestfs-actions.pod:5699 ../src/guestfs-actions.pod:6993 ../src/guestfs-actions.pod:7110 ../src/guestfs-actions.pod:7261 ../src/guestfs-actions.pod:7766 ../src/guestfs-actions.pod:7891 ../src/guestfs-actions.pod:8536 msgid "(Added in 0.3)" msgstr "" @@ -25988,7 +26108,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:198 ../src/guestfs-actions.pod:931 ../src/guestfs-actions.pod:1255 ../src/guestfs-actions.pod:1307 ../src/guestfs-actions.pod:1385 ../src/guestfs-actions.pod:1454 ../src/guestfs-actions.pod:1507 ../src/guestfs-actions.pod:1560 ../src/guestfs-actions.pod:1854 ../src/guestfs-actions.pod:3390 ../src/guestfs-actions.pod:4984 ../src/guestfs-actions.pod:5375 ../src/guestfs-actions.pod:5684 ../src/guestfs-actions.pod:5901 ../src/guestfs-actions.pod:7871 +#: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:198 ../src/guestfs-actions.pod:931 ../src/guestfs-actions.pod:1255 ../src/guestfs-actions.pod:1307 ../src/guestfs-actions.pod:1385 ../src/guestfs-actions.pod:1454 ../src/guestfs-actions.pod:1507 ../src/guestfs-actions.pod:1560 ../src/guestfs-actions.pod:1870 ../src/guestfs-actions.pod:3406 ../src/guestfs-actions.pod:5009 ../src/guestfs-actions.pod:5400 ../src/guestfs-actions.pod:5709 ../src/guestfs-actions.pod:5940 ../src/guestfs-actions.pod:7933 msgid "" "You may supply a list of optional arguments to this call. Use zero or more " "of the following pairs of parameters, and terminate the list with C<-1> on " @@ -26025,7 +26145,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:144 ../src/guestfs-actions.pod:403 ../src/guestfs-actions.pod:573 ../src/guestfs-actions.pod:792 ../src/guestfs-actions.pod:823 ../src/guestfs-actions.pod:841 ../src/guestfs-actions.pod:860 ../src/guestfs-actions.pod:1838 ../src/guestfs-actions.pod:2257 ../src/guestfs-actions.pod:2460 ../src/guestfs-actions.pod:2571 ../src/guestfs-actions.pod:2622 ../src/guestfs-actions.pod:2674 ../src/guestfs-actions.pod:2688 ../src/guestfs-actions.pod:2711 ../src/guestfs-actions.pod:3026 ../src/guestfs-actions.pod:3508 ../src/guestfs-actions.pod:3526 ../src/guestfs-actions.pod:5860 ../src/guestfs-actions.pod:6077 ../src/guestfs-actions.pod:6315 ../src/guestfs-actions.pod:6509 ../src/guestfs-actions.pod:6535 ../src/guestfs-actions.pod:8059 ../src/guestfs-actions.pod:8485 ../src/guestfs-actions.pod:8498 ../src/guestfs-actions.pod:8511 +#: ../src/guestfs-actions.pod:144 ../src/guestfs-actions.pod:403 ../src/guestfs-actions.pod:573 ../src/guestfs-actions.pod:792 ../src/guestfs-actions.pod:823 ../src/guestfs-actions.pod:841 ../src/guestfs-actions.pod:860 ../src/guestfs-actions.pod:1710 ../src/guestfs-actions.pod:1854 ../src/guestfs-actions.pod:2273 ../src/guestfs-actions.pod:2476 ../src/guestfs-actions.pod:2587 ../src/guestfs-actions.pod:2638 ../src/guestfs-actions.pod:2690 ../src/guestfs-actions.pod:2704 ../src/guestfs-actions.pod:2727 ../src/guestfs-actions.pod:3042 ../src/guestfs-actions.pod:3524 ../src/guestfs-actions.pod:3542 ../src/guestfs-actions.pod:5878 ../src/guestfs-actions.pod:5899 ../src/guestfs-actions.pod:6116 ../src/guestfs-actions.pod:6354 ../src/guestfs-actions.pod:6548 ../src/guestfs-actions.pod:6574 ../src/guestfs-actions.pod:8121 ../src/guestfs-actions.pod:8547 ../src/guestfs-actions.pod:8560 ../src/guestfs-actions.pod:8573 msgid "On error this function returns -1." msgstr "" @@ -26056,7 +26176,7 @@ msgid "This is the \"va_list variant\" of L</guestfs_add_domain>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:157 ../src/guestfs-actions.pod:168 ../src/guestfs-actions.pod:267 ../src/guestfs-actions.pod:278 ../src/guestfs-actions.pod:970 ../src/guestfs-actions.pod:981 ../src/guestfs-actions.pod:1283 ../src/guestfs-actions.pod:1296 ../src/guestfs-actions.pod:1342 ../src/guestfs-actions.pod:1355 ../src/guestfs-actions.pod:1432 ../src/guestfs-actions.pod:1444 ../src/guestfs-actions.pod:1485 ../src/guestfs-actions.pod:1497 ../src/guestfs-actions.pod:1538 ../src/guestfs-actions.pod:1550 ../src/guestfs-actions.pod:1596 ../src/guestfs-actions.pod:1608 ../src/guestfs-actions.pod:1897 ../src/guestfs-actions.pod:1908 ../src/guestfs-actions.pod:3474 ../src/guestfs-actions.pod:3486 ../src/guestfs-actions.pod:5063 ../src/guestfs-actions.pod:5075 ../src/guestfs-actions.pod:5440 ../src/guestfs-actions.pod:5452 ../src/guestfs-actions.pod:5712 ../src/guestfs-actions.pod:5724 ../src/guestfs-actions.pod:5950 ../src/guestfs-actions.pod:5961 ../src/guestfs-actions.pod:7973 ../src/guestfs-actions.pod:7984 +#: ../src/guestfs-actions.pod:157 ../src/guestfs-actions.pod:168 ../src/guestfs-actions.pod:267 ../src/guestfs-actions.pod:278 ../src/guestfs-actions.pod:970 ../src/guestfs-actions.pod:981 ../src/guestfs-actions.pod:1283 ../src/guestfs-actions.pod:1296 ../src/guestfs-actions.pod:1342 ../src/guestfs-actions.pod:1355 ../src/guestfs-actions.pod:1432 ../src/guestfs-actions.pod:1444 ../src/guestfs-actions.pod:1485 ../src/guestfs-actions.pod:1497 ../src/guestfs-actions.pod:1538 ../src/guestfs-actions.pod:1550 ../src/guestfs-actions.pod:1596 ../src/guestfs-actions.pod:1608 ../src/guestfs-actions.pod:1913 ../src/guestfs-actions.pod:1924 ../src/guestfs-actions.pod:3490 ../src/guestfs-actions.pod:3502 ../src/guestfs-actions.pod:5088 ../src/guestfs-actions.pod:5100 ../src/guestfs-actions.pod:5465 ../src/guestfs-actions.pod:5477 ../src/guestfs-actions.pod:5737 ../src/guestfs-actions.pod:5749 ../src/guestfs-actions.pod:5989 ../src/guestfs-actions.pod:6000 ../src/guestfs-actions.pod:8035 ../src/guestfs-actions.pod:8046 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>." msgstr "" @@ -26256,7 +26376,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:314 ../src/guestfs-actions.pod:335 ../src/guestfs-actions.pod:2985 +#: ../src/guestfs-actions.pod:314 ../src/guestfs-actions.pod:335 ../src/guestfs-actions.pod:3001 msgid "(Added in 1.0.84)" msgstr "" @@ -26299,7 +26419,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:348 ../src/guestfs-actions.pod:2713 +#: ../src/guestfs-actions.pod:348 ../src/guestfs-actions.pod:2729 msgid "(Added in 1.3.4)" msgstr "" @@ -26326,7 +26446,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:362 ../src/guestfs-actions.pod:387 ../src/guestfs-actions.pod:405 ../src/guestfs-actions.pod:419 ../src/guestfs-actions.pod:482 ../src/guestfs-actions.pod:502 ../src/guestfs-actions.pod:516 ../src/guestfs-actions.pod:547 ../src/guestfs-actions.pod:561 ../src/guestfs-actions.pod:575 ../src/guestfs-actions.pod:589 ../src/guestfs-actions.pod:607 ../src/guestfs-actions.pod:6586 +#: ../src/guestfs-actions.pod:362 ../src/guestfs-actions.pod:387 ../src/guestfs-actions.pod:405 ../src/guestfs-actions.pod:419 ../src/guestfs-actions.pod:482 ../src/guestfs-actions.pod:502 ../src/guestfs-actions.pod:516 ../src/guestfs-actions.pod:547 ../src/guestfs-actions.pod:561 ../src/guestfs-actions.pod:575 ../src/guestfs-actions.pod:589 ../src/guestfs-actions.pod:607 ../src/guestfs-actions.pod:6625 msgid "(Added in 0.7)" msgstr "" @@ -26394,7 +26514,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:416 ../src/guestfs-actions.pod:1021 ../src/guestfs-actions.pod:1039 ../src/guestfs-actions.pod:1099 ../src/guestfs-actions.pod:1115 ../src/guestfs-actions.pod:1218 ../src/guestfs-actions.pod:1707 ../src/guestfs-actions.pod:1724 ../src/guestfs-actions.pod:1743 ../src/guestfs-actions.pod:1940 ../src/guestfs-actions.pod:2128 ../src/guestfs-actions.pod:2240 ../src/guestfs-actions.pod:2403 ../src/guestfs-actions.pod:2420 ../src/guestfs-actions.pod:2487 ../src/guestfs-actions.pod:2530 ../src/guestfs-actions.pod:2551 ../src/guestfs-actions.pod:2736 ../src/guestfs-actions.pod:2950 ../src/guestfs-actions.pod:3152 ../src/guestfs-actions.pod:3254 ../src/guestfs-actions.pod:3358 ../src/guestfs-actions.pod:3377 ../src/guestfs-actions.pod:3592 ../src/guestfs-actions.pod:3620 ../src/guestfs-actions.pod:3641 ../src/guestfs-actions.pod:3675 ../src/guestfs-actions.pod:3742 ../src/guestfs-actions.pod:3762 ../src/guestfs-actions.pod:3782 ../src/guestfs-actions.pod:4422 ../src/guestfs-actions.pod:4769 ../src/guestfs-actions.pod:4936 ../src/guestfs-actions.pod:5202 ../src/guestfs-actions.pod:6095 ../src/guestfs-actions.pod:6296 ../src/guestfs-actions.pod:6484 ../src/guestfs-actions.pod:6662 ../src/guestfs-actions.pod:6711 ../src/guestfs-actions.pod:7373 ../src/guestfs-actions.pod:7389 ../src/guestfs-actions.pod:7413 ../src/guestfs-actions.pod:7437 ../src/guestfs-actions.pod:8233 ../src/guestfs-actions.pod:8252 ../src/guestfs-actions.pod:8270 ../src/guestfs-actions.pod:8444 ../src/guestfs-actions.pod:8758 +#: ../src/guestfs-actions.pod:416 ../src/guestfs-actions.pod:1021 ../src/guestfs-actions.pod:1039 ../src/guestfs-actions.pod:1099 ../src/guestfs-actions.pod:1115 ../src/guestfs-actions.pod:1218 ../src/guestfs-actions.pod:1723 ../src/guestfs-actions.pod:1740 ../src/guestfs-actions.pod:1759 ../src/guestfs-actions.pod:1956 ../src/guestfs-actions.pod:2144 ../src/guestfs-actions.pod:2256 ../src/guestfs-actions.pod:2419 ../src/guestfs-actions.pod:2436 ../src/guestfs-actions.pod:2503 ../src/guestfs-actions.pod:2546 ../src/guestfs-actions.pod:2567 ../src/guestfs-actions.pod:2752 ../src/guestfs-actions.pod:2966 ../src/guestfs-actions.pod:3168 ../src/guestfs-actions.pod:3270 ../src/guestfs-actions.pod:3374 ../src/guestfs-actions.pod:3393 ../src/guestfs-actions.pod:3608 ../src/guestfs-actions.pod:3636 ../src/guestfs-actions.pod:3657 ../src/guestfs-actions.pod:3691 ../src/guestfs-actions.pod:3758 ../src/guestfs-actions.pod:3778 ../src/guestfs-actions.pod:3798 ../src/guestfs-actions.pod:4447 ../src/guestfs-actions.pod:4794 ../src/guestfs-actions.pod:4961 ../src/guestfs-actions.pod:5227 ../src/guestfs-actions.pod:6134 ../src/guestfs-actions.pod:6335 ../src/guestfs-actions.pod:6523 ../src/guestfs-actions.pod:6701 ../src/guestfs-actions.pod:6750 ../src/guestfs-actions.pod:7412 ../src/guestfs-actions.pod:7428 ../src/guestfs-actions.pod:7452 ../src/guestfs-actions.pod:7476 ../src/guestfs-actions.pod:8295 ../src/guestfs-actions.pod:8314 ../src/guestfs-actions.pod:8332 ../src/guestfs-actions.pod:8506 ../src/guestfs-actions.pod:8820 msgid "" "This function returns a string, or NULL on error. I<The caller must free " "the returned string after use>." @@ -26494,7 +26614,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:527 ../src/guestfs-actions.pod:543 ../src/guestfs-actions.pod:689 ../src/guestfs-actions.pod:1237 ../src/guestfs-actions.pod:1955 ../src/guestfs-actions.pod:1974 ../src/guestfs-actions.pod:2077 ../src/guestfs-actions.pod:2096 ../src/guestfs-actions.pod:2342 ../src/guestfs-actions.pod:2808 ../src/guestfs-actions.pod:2824 ../src/guestfs-actions.pod:2843 ../src/guestfs-actions.pod:2908 ../src/guestfs-actions.pod:2932 ../src/guestfs-actions.pod:3003 ../src/guestfs-actions.pod:3052 ../src/guestfs-actions.pod:3319 ../src/guestfs-actions.pod:3694 ../src/guestfs-actions.pod:3978 ../src/guestfs-actions.pod:4292 ../src/guestfs-actions.pod:4309 ../src/guestfs-actions.pod:4329 ../src/guestfs-actions.pod:4384 ../src/guestfs-actions.pod:4404 ../src/guestfs-actions.pod:4509 ../src/guestfs-actions.pod:4908 ../src/guestfs-actions.pod:5821 ../src/guestfs-actions.pod:6456 ../src/guestfs-actions.pod:6582 ../src/guestfs-actions.pod:6696 ../src/guestfs-actions.pod:7453 ../src/guestfs-actions.pod:7514 ../src/guestfs-actions.pod:7569 ../src/guestfs-actions.pod:7715 ../src/guestfs-actions.pod:7739 ../src/guestfs-actions.pod:8337 ../src/guestfs-actions.pod:8357 ../src/guestfs-actions.pod:8404 ../src/guestfs-actions.pod:8598 ../src/guestfs-actions.pod:8617 ../src/guestfs-actions.pod:8708 ../src/guestfs-actions.pod:8727 ../src/guestfs-actions.pod:8773 ../src/guestfs-actions.pod:8792 +#: ../src/guestfs-actions.pod:527 ../src/guestfs-actions.pod:543 ../src/guestfs-actions.pod:689 ../src/guestfs-actions.pod:1237 ../src/guestfs-actions.pod:1971 ../src/guestfs-actions.pod:1990 ../src/guestfs-actions.pod:2093 ../src/guestfs-actions.pod:2112 ../src/guestfs-actions.pod:2358 ../src/guestfs-actions.pod:2824 ../src/guestfs-actions.pod:2840 ../src/guestfs-actions.pod:2859 ../src/guestfs-actions.pod:2924 ../src/guestfs-actions.pod:2948 ../src/guestfs-actions.pod:3019 ../src/guestfs-actions.pod:3068 ../src/guestfs-actions.pod:3335 ../src/guestfs-actions.pod:3710 ../src/guestfs-actions.pod:3994 ../src/guestfs-actions.pod:4317 ../src/guestfs-actions.pod:4334 ../src/guestfs-actions.pod:4354 ../src/guestfs-actions.pod:4409 ../src/guestfs-actions.pod:4429 ../src/guestfs-actions.pod:4534 ../src/guestfs-actions.pod:4933 ../src/guestfs-actions.pod:5846 ../src/guestfs-actions.pod:6495 ../src/guestfs-actions.pod:6621 ../src/guestfs-actions.pod:6735 ../src/guestfs-actions.pod:7492 ../src/guestfs-actions.pod:7576 ../src/guestfs-actions.pod:7631 ../src/guestfs-actions.pod:7777 ../src/guestfs-actions.pod:7801 ../src/guestfs-actions.pod:8399 ../src/guestfs-actions.pod:8419 ../src/guestfs-actions.pod:8466 ../src/guestfs-actions.pod:8660 ../src/guestfs-actions.pod:8679 ../src/guestfs-actions.pod:8770 ../src/guestfs-actions.pod:8789 ../src/guestfs-actions.pod:8835 ../src/guestfs-actions.pod:8854 msgid "" "This function returns a NULL-terminated array of strings (like " "L<environ(3)>), or NULL if there was an error. I<The caller must free the " @@ -26502,7 +26622,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:531 ../src/guestfs-actions.pod:1162 ../src/guestfs-actions.pod:1180 ../src/guestfs-actions.pod:2012 ../src/guestfs-actions.pod:4056 ../src/guestfs-actions.pod:4087 ../src/guestfs-actions.pod:4752 ../src/guestfs-actions.pod:4799 ../src/guestfs-actions.pod:5142 ../src/guestfs-actions.pod:5175 ../src/guestfs-actions.pod:5338 ../src/guestfs-actions.pod:5825 ../src/guestfs-actions.pod:6397 ../src/guestfs-actions.pod:6794 ../src/guestfs-actions.pod:6808 ../src/guestfs-actions.pod:6820 ../src/guestfs-actions.pod:7300 ../src/guestfs-actions.pod:8075 ../src/guestfs-actions.pod:8088 ../src/guestfs-actions.pod:8321 ../src/guestfs-actions.pod:8586 +#: ../src/guestfs-actions.pod:531 ../src/guestfs-actions.pod:1162 ../src/guestfs-actions.pod:1180 ../src/guestfs-actions.pod:2028 ../src/guestfs-actions.pod:4072 ../src/guestfs-actions.pod:4103 ../src/guestfs-actions.pod:4777 ../src/guestfs-actions.pod:4824 ../src/guestfs-actions.pod:5167 ../src/guestfs-actions.pod:5200 ../src/guestfs-actions.pod:5363 ../src/guestfs-actions.pod:5850 ../src/guestfs-actions.pod:6436 ../src/guestfs-actions.pod:6833 ../src/guestfs-actions.pod:6847 ../src/guestfs-actions.pod:6859 ../src/guestfs-actions.pod:7339 ../src/guestfs-actions.pod:8137 ../src/guestfs-actions.pod:8150 ../src/guestfs-actions.pod:8383 ../src/guestfs-actions.pod:8648 msgid "(Added in 0.8)" msgstr "" @@ -26724,7 +26844,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:756 ../src/guestfs-actions.pod:3294 ../src/guestfs-actions.pod:3562 ../src/guestfs-actions.pod:4369 ../src/guestfs-actions.pod:5111 ../src/guestfs-actions.pod:5801 ../src/guestfs-actions.pod:8000 +#: ../src/guestfs-actions.pod:756 ../src/guestfs-actions.pod:3310 ../src/guestfs-actions.pod:3578 ../src/guestfs-actions.pod:4394 ../src/guestfs-actions.pod:5136 ../src/guestfs-actions.pod:5826 ../src/guestfs-actions.pod:8062 msgid "" "This function returns a NULL-terminated array of strings, or NULL if there " "was an error. The array of strings will always have length C<2n+1>, where " @@ -26788,7 +26908,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:807 ../src/guestfs-actions.pod:1995 ../src/guestfs-actions.pod:2010 ../src/guestfs-actions.pod:2499 ../src/guestfs-actions.pod:2510 ../src/guestfs-actions.pod:2582 ../src/guestfs-actions.pod:2608 ../src/guestfs-actions.pod:2648 ../src/guestfs-actions.pod:2663 ../src/guestfs-actions.pod:2699 ../src/guestfs-actions.pod:2722 ../src/guestfs-actions.pod:3799 ../src/guestfs-actions.pod:3815 ../src/guestfs-actions.pod:3833 ../src/guestfs-actions.pod:3995 ../src/guestfs-actions.pod:4009 ../src/guestfs-actions.pod:4024 ../src/guestfs-actions.pod:4038 ../src/guestfs-actions.pod:4054 ../src/guestfs-actions.pod:4069 ../src/guestfs-actions.pod:4085 ../src/guestfs-actions.pod:4099 ../src/guestfs-actions.pod:4112 ../src/guestfs-actions.pod:4126 ../src/guestfs-actions.pod:4141 ../src/guestfs-actions.pod:4156 ../src/guestfs-actions.pod:4169 ../src/guestfs-actions.pod:4183 ../src/guestfs-actions.pod:6059 +#: ../src/guestfs-actions.pod:807 ../src/guestfs-actions.pod:2011 ../src/guestfs-actions.pod:2026 ../src/guestfs-actions.pod:2515 ../src/guestfs-actions.pod:2526 ../src/guestfs-actions.pod:2598 ../src/guestfs-actions.pod:2624 ../src/guestfs-actions.pod:2664 ../src/guestfs-actions.pod:2679 ../src/guestfs-actions.pod:2715 ../src/guestfs-actions.pod:2738 ../src/guestfs-actions.pod:3815 ../src/guestfs-actions.pod:3831 ../src/guestfs-actions.pod:3849 ../src/guestfs-actions.pod:4011 ../src/guestfs-actions.pod:4025 ../src/guestfs-actions.pod:4040 ../src/guestfs-actions.pod:4054 ../src/guestfs-actions.pod:4070 ../src/guestfs-actions.pod:4085 ../src/guestfs-actions.pod:4101 ../src/guestfs-actions.pod:4115 ../src/guestfs-actions.pod:4128 ../src/guestfs-actions.pod:4142 ../src/guestfs-actions.pod:4157 ../src/guestfs-actions.pod:4172 ../src/guestfs-actions.pod:4185 ../src/guestfs-actions.pod:4199 ../src/guestfs-actions.pod:6098 msgid "This function returns a C truth value on success or -1 on error." msgstr "" @@ -27018,7 +27138,7 @@ msgid "See also C<guestfs_realpath>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1024 ../src/guestfs-actions.pod:8255 +#: ../src/guestfs-actions.pod:1024 ../src/guestfs-actions.pod:8317 msgid "(Added in 1.0.75)" msgstr "" @@ -27047,7 +27167,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1045 ../src/guestfs-actions.pod:4313 ../src/guestfs-actions.pod:4408 ../src/guestfs-actions.pod:4425 ../src/guestfs-actions.pod:4513 ../src/guestfs-actions.pod:4912 ../src/guestfs-actions.pod:4926 ../src/guestfs-actions.pod:6460 ../src/guestfs-actions.pod:6474 ../src/guestfs-actions.pod:8408 ../src/guestfs-actions.pod:8422 +#: ../src/guestfs-actions.pod:1045 ../src/guestfs-actions.pod:4338 ../src/guestfs-actions.pod:4433 ../src/guestfs-actions.pod:4450 ../src/guestfs-actions.pod:4538 ../src/guestfs-actions.pod:4937 ../src/guestfs-actions.pod:4951 ../src/guestfs-actions.pod:6499 ../src/guestfs-actions.pod:6513 ../src/guestfs-actions.pod:8470 ../src/guestfs-actions.pod:8484 msgid "(Added in 0.4)" msgstr "" @@ -27078,7 +27198,7 @@ msgid "To get the checksums for many files, use C<guestfs_checksums_out>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1102 ../src/guestfs-actions.pod:1769 ../src/guestfs-actions.pod:2690 ../src/guestfs-actions.pod:4011 ../src/guestfs-actions.pod:4040 ../src/guestfs-actions.pod:4101 ../src/guestfs-actions.pod:4128 ../src/guestfs-actions.pod:8111 +#: ../src/guestfs-actions.pod:1102 ../src/guestfs-actions.pod:1785 ../src/guestfs-actions.pod:2706 ../src/guestfs-actions.pod:4027 ../src/guestfs-actions.pod:4056 ../src/guestfs-actions.pod:4117 ../src/guestfs-actions.pod:4144 ../src/guestfs-actions.pod:8173 msgid "(Added in 1.0.2)" msgstr "" @@ -27107,7 +27227,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1118 ../src/guestfs-actions.pod:5892 ../src/guestfs-actions.pod:6027 ../src/guestfs-actions.pod:6061 ../src/guestfs-actions.pod:6079 ../src/guestfs-actions.pod:6261 ../src/guestfs-actions.pod:8020 ../src/guestfs-actions.pod:8034 ../src/guestfs-actions.pod:8434 +#: ../src/guestfs-actions.pod:1118 ../src/guestfs-actions.pod:5931 ../src/guestfs-actions.pod:6066 ../src/guestfs-actions.pod:6100 ../src/guestfs-actions.pod:6118 ../src/guestfs-actions.pod:6300 ../src/guestfs-actions.pod:8082 ../src/guestfs-actions.pod:8096 ../src/guestfs-actions.pod:8496 msgid "(Added in 1.3.2)" msgstr "" @@ -27192,7 +27312,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1224 ../src/guestfs-actions.pod:1244 ../src/guestfs-actions.pod:2131 +#: ../src/guestfs-actions.pod:1224 ../src/guestfs-actions.pod:1244 ../src/guestfs-actions.pod:2147 msgid "(Added in 0.9.1)" msgstr "" @@ -27257,7 +27377,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1270 ../src/guestfs-actions.pod:1329 ../src/guestfs-actions.pod:2676 ../src/guestfs-actions.pod:7179 +#: ../src/guestfs-actions.pod:1270 ../src/guestfs-actions.pod:1329 ../src/guestfs-actions.pod:2692 ../src/guestfs-actions.pod:7218 msgid "(Added in 1.13.15)" msgstr "" @@ -27434,7 +27554,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1415 ../src/guestfs-actions.pod:1468 ../src/guestfs-actions.pod:1521 ../src/guestfs-actions.pod:1579 ../src/guestfs-actions.pod:1633 ../src/guestfs-actions.pod:1764 ../src/guestfs-actions.pod:1795 ../src/guestfs-actions.pod:1840 ../src/guestfs-actions.pod:2280 ../src/guestfs-actions.pod:2302 ../src/guestfs-actions.pod:4211 ../src/guestfs-actions.pod:8106 ../src/guestfs-actions.pod:8140 ../src/guestfs-actions.pod:8647 ../src/guestfs-actions.pod:8670 +#: ../src/guestfs-actions.pod:1415 ../src/guestfs-actions.pod:1468 ../src/guestfs-actions.pod:1521 ../src/guestfs-actions.pod:1579 ../src/guestfs-actions.pod:1633 ../src/guestfs-actions.pod:1780 ../src/guestfs-actions.pod:1811 ../src/guestfs-actions.pod:1856 ../src/guestfs-actions.pod:2296 ../src/guestfs-actions.pod:2318 ../src/guestfs-actions.pod:4236 ../src/guestfs-actions.pod:8168 ../src/guestfs-actions.pod:8202 ../src/guestfs-actions.pod:8709 ../src/guestfs-actions.pod:8732 msgid "" "This long-running command can generate progress notification messages so " "that the caller can display a progress bar or indicator. To receive these " @@ -27443,7 +27563,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1420 ../src/guestfs-actions.pod:1473 ../src/guestfs-actions.pod:1526 ../src/guestfs-actions.pod:1584 ../src/guestfs-actions.pod:6317 +#: ../src/guestfs-actions.pod:1420 ../src/guestfs-actions.pod:1473 ../src/guestfs-actions.pod:1526 ../src/guestfs-actions.pod:1584 ../src/guestfs-actions.pod:6356 msgid "(Added in 1.13.25)" msgstr "" @@ -27746,7 +27866,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1638 ../src/guestfs-actions.pod:4939 ../src/guestfs-actions.pod:6487 ../src/guestfs-actions.pod:8341 ../src/guestfs-actions.pod:8361 ../src/guestfs-actions.pod:8447 +#: ../src/guestfs-actions.pod:1638 ../src/guestfs-actions.pod:4964 ../src/guestfs-actions.pod:6526 ../src/guestfs-actions.pod:8403 ../src/guestfs-actions.pod:8423 ../src/guestfs-actions.pod:8509 msgid "(Added in 1.0.87)" msgstr "" @@ -27767,7 +27887,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1652 ../src/guestfs-actions.pod:1666 ../src/guestfs-actions.pod:1746 ../src/guestfs-actions.pod:1820 ../src/guestfs-actions.pod:1997 ../src/guestfs-actions.pod:5839 ../src/guestfs-actions.pod:6331 +#: ../src/guestfs-actions.pod:1652 ../src/guestfs-actions.pod:1666 ../src/guestfs-actions.pod:1762 ../src/guestfs-actions.pod:1836 ../src/guestfs-actions.pod:2013 ../src/guestfs-actions.pod:5864 ../src/guestfs-actions.pod:6370 msgid "(Added in 1.0.18)" msgstr "" @@ -27813,20 +27933,47 @@ msgstr "" #. type: =head2 #: ../src/guestfs-actions.pod:1696 -msgid "guestfs_df" +msgid "guestfs_device_index" msgstr "" #. type: verbatim #: ../src/guestfs-actions.pod:1698 #, no-wrap msgid "" +" int\n" +" guestfs_device_index (guestfs_h *g,\n" +" const char *device);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:1705 +msgid "" +"Index numbers start from 0. The named device must exist, for example as a " +"string returned from C<guestfs_list_devices>." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:1708 +msgid "See also C<guestfs_list_devices>, C<guestfs_part_to_dev>." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:1712 +msgid "guestfs_df" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1714 +#, no-wrap +msgid "" " char *\n" " guestfs_df (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1703 ../src/guestfs-actions.pod:1720 +#: ../src/guestfs-actions.pod:1719 ../src/guestfs-actions.pod:1736 msgid "" "This command is mostly useful for interactive sessions. It is I<not> " "intended that you try to parse the output string. Use C<guestfs_statvfs> " @@ -27834,17 +27981,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1710 ../src/guestfs-actions.pod:1727 ../src/guestfs-actions.pod:1845 ../src/guestfs-actions.pod:2915 ../src/guestfs-actions.pod:2939 ../src/guestfs-actions.pod:3007 ../src/guestfs-actions.pod:5205 ../src/guestfs-actions.pod:5739 ../src/guestfs-actions.pod:7722 ../src/guestfs-actions.pod:7746 ../src/guestfs-actions.pod:8487 ../src/guestfs-actions.pod:8500 ../src/guestfs-actions.pod:8513 +#: ../src/guestfs-actions.pod:1726 ../src/guestfs-actions.pod:1743 ../src/guestfs-actions.pod:1861 ../src/guestfs-actions.pod:2931 ../src/guestfs-actions.pod:2955 ../src/guestfs-actions.pod:3023 ../src/guestfs-actions.pod:5230 ../src/guestfs-actions.pod:5764 ../src/guestfs-actions.pod:7784 ../src/guestfs-actions.pod:7808 ../src/guestfs-actions.pod:8549 ../src/guestfs-actions.pod:8562 ../src/guestfs-actions.pod:8575 msgid "(Added in 1.0.54)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1712 +#: ../src/guestfs-actions.pod:1728 msgid "guestfs_df_h" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1714 +#: ../src/guestfs-actions.pod:1730 #, no-wrap msgid "" " char *\n" @@ -27853,12 +28000,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1729 +#: ../src/guestfs-actions.pod:1745 msgid "guestfs_dmesg" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1731 +#: ../src/guestfs-actions.pod:1747 #, no-wrap msgid "" " char *\n" @@ -27867,7 +28014,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1738 +#: ../src/guestfs-actions.pod:1754 msgid "" "Another way to get the same information is to enable verbose messages with " "C<guestfs_set_verbose> or by setting the environment variable " @@ -27875,12 +28022,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1748 +#: ../src/guestfs-actions.pod:1764 msgid "guestfs_download" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1750 +#: ../src/guestfs-actions.pod:1766 #, no-wrap msgid "" " int\n" @@ -27891,17 +28038,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1760 +#: ../src/guestfs-actions.pod:1776 msgid "See also C<guestfs_upload>, C<guestfs_cat>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1771 +#: ../src/guestfs-actions.pod:1787 msgid "guestfs_download_offset" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1773 +#: ../src/guestfs-actions.pod:1789 #, no-wrap msgid "" " int\n" @@ -27914,7 +28061,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1786 +#: ../src/guestfs-actions.pod:1802 msgid "" "Note that there is no limit on the amount of data that can be downloaded " "with this call, unlike with C<guestfs_pread>, and this call always reads the " @@ -27922,22 +28069,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1791 +#: ../src/guestfs-actions.pod:1807 msgid "See also C<guestfs_download>, C<guestfs_pread>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1800 ../src/guestfs-actions.pod:8145 +#: ../src/guestfs-actions.pod:1816 ../src/guestfs-actions.pod:8207 msgid "(Added in 1.5.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1802 +#: ../src/guestfs-actions.pod:1818 msgid "guestfs_drop_caches" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1804 +#: ../src/guestfs-actions.pod:1820 #, no-wrap msgid "" " int\n" @@ -27947,12 +28094,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1822 +#: ../src/guestfs-actions.pod:1838 msgid "guestfs_du" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1824 +#: ../src/guestfs-actions.pod:1840 #, no-wrap msgid "" " int64_t\n" @@ -27962,12 +28109,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1847 +#: ../src/guestfs-actions.pod:1863 msgid "guestfs_e2fsck" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1849 +#: ../src/guestfs-actions.pod:1865 #, no-wrap msgid "" " int\n" @@ -27978,7 +28125,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1859 +#: ../src/guestfs-actions.pod:1875 #, no-wrap msgid "" " GUESTFS_E2FSCK_CORRECT, int correct,\n" @@ -27987,17 +28134,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1886 +#: ../src/guestfs-actions.pod:1902 msgid "(Added in 1.15.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1888 +#: ../src/guestfs-actions.pod:1904 msgid "guestfs_e2fsck_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1890 +#: ../src/guestfs-actions.pod:1906 #, no-wrap msgid "" " int\n" @@ -28008,17 +28155,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1895 +#: ../src/guestfs-actions.pod:1911 msgid "This is the \"va_list variant\" of L</guestfs_e2fsck>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1899 +#: ../src/guestfs-actions.pod:1915 msgid "guestfs_e2fsck_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1901 +#: ../src/guestfs-actions.pod:1917 #, no-wrap msgid "" " int\n" @@ -28029,17 +28176,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1906 +#: ../src/guestfs-actions.pod:1922 msgid "This is the \"argv variant\" of L</guestfs_e2fsck>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1910 +#: ../src/guestfs-actions.pod:1926 msgid "guestfs_e2fsck_f" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1912 +#: ../src/guestfs-actions.pod:1928 #, no-wrap msgid "" " int\n" @@ -28049,24 +28196,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1920 +#: ../src/guestfs-actions.pod:1936 msgid "" "This command is only needed because of C<guestfs_resize2fs> (q.v.). " "Normally you should use C<guestfs_fsck>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1925 +#: ../src/guestfs-actions.pod:1941 msgid "(Added in 1.0.29)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1927 +#: ../src/guestfs-actions.pod:1943 msgid "guestfs_echo_daemon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1929 +#: ../src/guestfs-actions.pod:1945 #, no-wrap msgid "" " char *\n" @@ -28076,22 +28223,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1938 +#: ../src/guestfs-actions.pod:1954 msgid "See also C<guestfs_ping_daemon>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1943 ../src/guestfs-actions.pod:2701 ../src/guestfs-actions.pod:7203 +#: ../src/guestfs-actions.pod:1959 ../src/guestfs-actions.pod:2717 ../src/guestfs-actions.pod:7242 msgid "(Added in 1.0.69)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1945 +#: ../src/guestfs-actions.pod:1961 msgid "guestfs_egrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1947 +#: ../src/guestfs-actions.pod:1963 #, no-wrap msgid "" " char **\n" @@ -28102,17 +28249,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1962 ../src/guestfs-actions.pod:1981 ../src/guestfs-actions.pod:2038 ../src/guestfs-actions.pod:2084 ../src/guestfs-actions.pod:2103 ../src/guestfs-actions.pod:2831 ../src/guestfs-actions.pod:2850 ../src/guestfs-actions.pod:3028 ../src/guestfs-actions.pod:3041 ../src/guestfs-actions.pod:3056 ../src/guestfs-actions.pod:3100 ../src/guestfs-actions.pod:3122 ../src/guestfs-actions.pod:3135 ../src/guestfs-actions.pod:4438 ../src/guestfs-actions.pod:4452 ../src/guestfs-actions.pod:4465 ../src/guestfs-actions.pod:4479 ../src/guestfs-actions.pod:5627 ../src/guestfs-actions.pod:6665 ../src/guestfs-actions.pod:6714 ../src/guestfs-actions.pod:7590 ../src/guestfs-actions.pod:7602 ../src/guestfs-actions.pod:7615 ../src/guestfs-actions.pod:7628 ../src/guestfs-actions.pod:7650 ../src/guestfs-actions.pod:7663 ../src/guestfs-actions.pod:7676 ../src/guestfs-actions.pod:7689 ../src/guestfs-actions.pod:8605 ../src/guestfs-actions.pod:8624 ../src/guestfs-actions.pod:8715 ../src/guestfs-actions.pod:8734 ../src/guestfs-actions.pod:8780 ../src/guestfs-actions.pod:8799 +#: ../src/guestfs-actions.pod:1978 ../src/guestfs-actions.pod:1997 ../src/guestfs-actions.pod:2054 ../src/guestfs-actions.pod:2100 ../src/guestfs-actions.pod:2119 ../src/guestfs-actions.pod:2847 ../src/guestfs-actions.pod:2866 ../src/guestfs-actions.pod:3044 ../src/guestfs-actions.pod:3057 ../src/guestfs-actions.pod:3072 ../src/guestfs-actions.pod:3116 ../src/guestfs-actions.pod:3138 ../src/guestfs-actions.pod:3151 ../src/guestfs-actions.pod:4463 ../src/guestfs-actions.pod:4477 ../src/guestfs-actions.pod:4490 ../src/guestfs-actions.pod:4504 ../src/guestfs-actions.pod:5652 ../src/guestfs-actions.pod:6704 ../src/guestfs-actions.pod:6753 ../src/guestfs-actions.pod:7652 ../src/guestfs-actions.pod:7664 ../src/guestfs-actions.pod:7677 ../src/guestfs-actions.pod:7690 ../src/guestfs-actions.pod:7712 ../src/guestfs-actions.pod:7725 ../src/guestfs-actions.pod:7738 ../src/guestfs-actions.pod:7751 ../src/guestfs-actions.pod:8667 ../src/guestfs-actions.pod:8686 ../src/guestfs-actions.pod:8777 ../src/guestfs-actions.pod:8796 ../src/guestfs-actions.pod:8842 ../src/guestfs-actions.pod:8861 msgid "(Added in 1.0.66)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1964 +#: ../src/guestfs-actions.pod:1980 msgid "guestfs_egrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1966 +#: ../src/guestfs-actions.pod:1982 #, no-wrap msgid "" " char **\n" @@ -28123,12 +28270,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1983 +#: ../src/guestfs-actions.pod:1999 msgid "guestfs_equal" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1985 +#: ../src/guestfs-actions.pod:2001 #, no-wrap msgid "" " int\n" @@ -28139,12 +28286,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1999 +#: ../src/guestfs-actions.pod:2015 msgid "guestfs_exists" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2001 +#: ../src/guestfs-actions.pod:2017 #, no-wrap msgid "" " int\n" @@ -28154,17 +28301,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2008 +#: ../src/guestfs-actions.pod:2024 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2014 +#: ../src/guestfs-actions.pod:2030 msgid "guestfs_fallocate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2016 +#: ../src/guestfs-actions.pod:2032 #, no-wrap msgid "" " int\n" @@ -28175,19 +28322,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2021 +#: ../src/guestfs-actions.pod:2037 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_fallocate64> " "call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2040 +#: ../src/guestfs-actions.pod:2056 msgid "guestfs_fallocate64" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2042 +#: ../src/guestfs-actions.pod:2058 #, no-wrap msgid "" " int\n" @@ -28198,14 +28345,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2051 +#: ../src/guestfs-actions.pod:2067 msgid "" "Note that this call allocates disk blocks for the file. To create a sparse " "file use C<guestfs_truncate_size> instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2054 +#: ../src/guestfs-actions.pod:2070 msgid "" "The deprecated call C<guestfs_fallocate> does the same, but owing to an " "oversight it only allowed 30 bit lengths to be specified, effectively " @@ -28213,17 +28360,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2065 +#: ../src/guestfs-actions.pod:2081 msgid "(Added in 1.3.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2067 +#: ../src/guestfs-actions.pod:2083 msgid "guestfs_fgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2069 +#: ../src/guestfs-actions.pod:2085 #, no-wrap msgid "" " char **\n" @@ -28234,12 +28381,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2086 +#: ../src/guestfs-actions.pod:2102 msgid "guestfs_fgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2088 +#: ../src/guestfs-actions.pod:2104 #, no-wrap msgid "" " char **\n" @@ -28250,12 +28397,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2105 +#: ../src/guestfs-actions.pod:2121 msgid "guestfs_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2107 +#: ../src/guestfs-actions.pod:2123 #, no-wrap msgid "" " char *\n" @@ -28265,19 +28412,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2125 +#: ../src/guestfs-actions.pod:2141 msgid "" "See also: L<file(1)>, C<guestfs_vfs_type>, C<guestfs_lstat>, " "C<guestfs_is_file>, C<guestfs_is_blockdev> (etc), C<guestfs_is_zero>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2133 +#: ../src/guestfs-actions.pod:2149 msgid "guestfs_file_architecture" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2135 +#: ../src/guestfs-actions.pod:2151 #, no-wrap msgid "" " char *\n" @@ -28287,17 +28434,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2243 ../src/guestfs-actions.pod:2406 ../src/guestfs-actions.pod:2423 ../src/guestfs-actions.pod:3155 ../src/guestfs-actions.pod:3257 ../src/guestfs-actions.pod:3323 ../src/guestfs-actions.pod:3510 ../src/guestfs-actions.pod:3528 ../src/guestfs-actions.pod:3568 ../src/guestfs-actions.pod:3644 ../src/guestfs-actions.pod:3745 ../src/guestfs-actions.pod:3982 ../src/guestfs-actions.pod:4114 +#: ../src/guestfs-actions.pod:2259 ../src/guestfs-actions.pod:2422 ../src/guestfs-actions.pod:2439 ../src/guestfs-actions.pod:3171 ../src/guestfs-actions.pod:3273 ../src/guestfs-actions.pod:3339 ../src/guestfs-actions.pod:3526 ../src/guestfs-actions.pod:3544 ../src/guestfs-actions.pod:3584 ../src/guestfs-actions.pod:3660 ../src/guestfs-actions.pod:3761 ../src/guestfs-actions.pod:3998 ../src/guestfs-actions.pod:4130 msgid "(Added in 1.5.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2245 +#: ../src/guestfs-actions.pod:2261 msgid "guestfs_filesize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2247 +#: ../src/guestfs-actions.pod:2263 #, no-wrap msgid "" " int64_t\n" @@ -28307,7 +28454,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2253 +#: ../src/guestfs-actions.pod:2269 msgid "" "To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, " "C<guestfs_is_dir>, C<guestfs_is_file> etc. To get the size of block " @@ -28315,17 +28462,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2259 +#: ../src/guestfs-actions.pod:2275 msgid "(Added in 1.0.82)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2261 +#: ../src/guestfs-actions.pod:2277 msgid "guestfs_fill" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2263 +#: ../src/guestfs-actions.pod:2279 #, no-wrap msgid "" " int\n" @@ -28337,7 +28484,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2273 +#: ../src/guestfs-actions.pod:2289 msgid "" "To fill a file with zero bytes (sparsely), it is much more efficient to use " "C<guestfs_truncate_size>. To create a file with a pattern of repeating " @@ -28345,17 +28492,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2285 +#: ../src/guestfs-actions.pod:2301 msgid "(Added in 1.0.79)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2287 +#: ../src/guestfs-actions.pod:2303 msgid "guestfs_fill_pattern" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2289 +#: ../src/guestfs-actions.pod:2305 #, no-wrap msgid "" " int\n" @@ -28367,7 +28514,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2295 +#: ../src/guestfs-actions.pod:2311 msgid "" "This function is like C<guestfs_fill> except that it creates a new file of " "length C<len> containing the repeating pattern of bytes in C<pattern>. The " @@ -28376,17 +28523,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2307 +#: ../src/guestfs-actions.pod:2323 msgid "(Added in 1.3.12)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2309 +#: ../src/guestfs-actions.pod:2325 msgid "guestfs_find" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2311 +#: ../src/guestfs-actions.pod:2327 #, no-wrap msgid "" " char **\n" @@ -28396,27 +28543,27 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2327 +#: ../src/guestfs-actions.pod:2343 msgid "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2340 +#: ../src/guestfs-actions.pod:2356 msgid "See also C<guestfs_find0>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2349 ../src/guestfs-actions.pod:4876 ../src/guestfs-actions.pod:6749 +#: ../src/guestfs-actions.pod:2365 ../src/guestfs-actions.pod:4901 ../src/guestfs-actions.pod:6788 msgid "(Added in 1.0.27)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2351 +#: ../src/guestfs-actions.pod:2367 msgid "guestfs_find0" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2353 +#: ../src/guestfs-actions.pod:2369 #, no-wrap msgid "" " int\n" @@ -28427,24 +28574,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2362 +#: ../src/guestfs-actions.pod:2378 msgid "" "This command works the same way as C<guestfs_find> with the following " "exceptions:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2389 +#: ../src/guestfs-actions.pod:2405 msgid "(Added in 1.0.74)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2391 +#: ../src/guestfs-actions.pod:2407 msgid "guestfs_findfs_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2393 +#: ../src/guestfs-actions.pod:2409 #, no-wrap msgid "" " char *\n" @@ -28454,17 +28601,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2401 +#: ../src/guestfs-actions.pod:2417 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2408 +#: ../src/guestfs-actions.pod:2424 msgid "guestfs_findfs_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2410 +#: ../src/guestfs-actions.pod:2426 #, no-wrap msgid "" " char *\n" @@ -28474,17 +28621,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2418 +#: ../src/guestfs-actions.pod:2434 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2425 +#: ../src/guestfs-actions.pod:2441 msgid "guestfs_fsck" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2427 +#: ../src/guestfs-actions.pod:2443 #, no-wrap msgid "" " int\n" @@ -28495,17 +28642,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2462 ../src/guestfs-actions.pod:8652 +#: ../src/guestfs-actions.pod:2478 ../src/guestfs-actions.pod:8714 msgid "(Added in 1.0.16)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2464 +#: ../src/guestfs-actions.pod:2480 msgid "guestfs_get_append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2466 +#: ../src/guestfs-actions.pod:2482 #, no-wrap msgid "" " const char *\n" @@ -28514,7 +28661,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2474 +#: ../src/guestfs-actions.pod:2490 msgid "" "This function returns a string which may be NULL. There is no way to return " "an error from this function. The string is owned by the guest handle and " @@ -28522,17 +28669,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2478 ../src/guestfs-actions.pod:6427 ../src/guestfs-actions.pod:6906 ../src/guestfs-actions.pod:7357 ../src/guestfs-actions.pod:7376 ../src/guestfs-actions.pod:7392 ../src/guestfs-actions.pod:7416 ../src/guestfs-actions.pod:8292 ../src/guestfs-actions.pod:8307 ../src/guestfs-actions.pod:8696 +#: ../src/guestfs-actions.pod:2494 ../src/guestfs-actions.pod:6466 ../src/guestfs-actions.pod:6945 ../src/guestfs-actions.pod:7396 ../src/guestfs-actions.pod:7415 ../src/guestfs-actions.pod:7431 ../src/guestfs-actions.pod:7455 ../src/guestfs-actions.pod:8354 ../src/guestfs-actions.pod:8369 ../src/guestfs-actions.pod:8758 msgid "(Added in 1.0.26)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2480 +#: ../src/guestfs-actions.pod:2496 msgid "guestfs_get_attach_method" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2482 +#: ../src/guestfs-actions.pod:2498 #, no-wrap msgid "" " char *\n" @@ -28541,22 +28688,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2485 +#: ../src/guestfs-actions.pod:2501 msgid "Return the current attach method. See C<guestfs_set_attach_method>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2490 ../src/guestfs-actions.pod:6936 +#: ../src/guestfs-actions.pod:2506 ../src/guestfs-actions.pod:6975 msgid "(Added in 1.9.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2492 +#: ../src/guestfs-actions.pod:2508 msgid "guestfs_get_autosync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2494 +#: ../src/guestfs-actions.pod:2510 #, no-wrap msgid "" " int\n" @@ -28565,12 +28712,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2503 +#: ../src/guestfs-actions.pod:2519 msgid "guestfs_get_direct" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2505 +#: ../src/guestfs-actions.pod:2521 #, no-wrap msgid "" " int\n" @@ -28579,17 +28726,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2512 ../src/guestfs-actions.pod:6977 +#: ../src/guestfs-actions.pod:2528 ../src/guestfs-actions.pod:7016 msgid "(Added in 1.0.72)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2514 +#: ../src/guestfs-actions.pod:2530 msgid "guestfs_get_e2label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2516 +#: ../src/guestfs-actions.pod:2532 #, no-wrap msgid "" " char *\n" @@ -28599,24 +28746,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2520 +#: ../src/guestfs-actions.pod:2536 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_vfs_label> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2533 ../src/guestfs-actions.pod:2554 ../src/guestfs-actions.pod:6995 ../src/guestfs-actions.pod:7014 +#: ../src/guestfs-actions.pod:2549 ../src/guestfs-actions.pod:2570 ../src/guestfs-actions.pod:7034 ../src/guestfs-actions.pod:7053 msgid "(Added in 1.0.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2535 +#: ../src/guestfs-actions.pod:2551 msgid "guestfs_get_e2uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2537 +#: ../src/guestfs-actions.pod:2553 #, no-wrap msgid "" " char *\n" @@ -28626,19 +28773,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2541 +#: ../src/guestfs-actions.pod:2557 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_vfs_uuid> " "call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2556 +#: ../src/guestfs-actions.pod:2572 msgid "guestfs_get_memsize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2558 +#: ../src/guestfs-actions.pod:2574 #, no-wrap msgid "" " int\n" @@ -28647,7 +28794,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2564 +#: ../src/guestfs-actions.pod:2580 msgid "" "If C<guestfs_set_memsize> was not called on this handle, and if " "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default " @@ -28655,17 +28802,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2573 ../src/guestfs-actions.pod:5323 ../src/guestfs-actions.pod:5532 ../src/guestfs-actions.pod:5551 ../src/guestfs-actions.pod:5570 ../src/guestfs-actions.pod:5582 ../src/guestfs-actions.pod:5599 ../src/guestfs-actions.pod:5612 ../src/guestfs-actions.pod:6652 ../src/guestfs-actions.pod:7035 ../src/guestfs-actions.pod:7327 ../src/guestfs-actions.pod:8061 +#: ../src/guestfs-actions.pod:2589 ../src/guestfs-actions.pod:5348 ../src/guestfs-actions.pod:5557 ../src/guestfs-actions.pod:5576 ../src/guestfs-actions.pod:5595 ../src/guestfs-actions.pod:5607 ../src/guestfs-actions.pod:5624 ../src/guestfs-actions.pod:5637 ../src/guestfs-actions.pod:6691 ../src/guestfs-actions.pod:7074 ../src/guestfs-actions.pod:7366 ../src/guestfs-actions.pod:8123 msgid "(Added in 1.0.55)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2575 +#: ../src/guestfs-actions.pod:2591 msgid "guestfs_get_network" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2577 +#: ../src/guestfs-actions.pod:2593 #, no-wrap msgid "" " int\n" @@ -28674,17 +28821,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2584 ../src/guestfs-actions.pod:7054 +#: ../src/guestfs-actions.pod:2600 ../src/guestfs-actions.pod:7093 msgid "(Added in 1.5.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2586 +#: ../src/guestfs-actions.pod:2602 msgid "guestfs_get_path" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2588 +#: ../src/guestfs-actions.pod:2604 #, no-wrap msgid "" " const char *\n" @@ -28693,19 +28840,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2596 ../src/guestfs-actions.pod:2636 +#: ../src/guestfs-actions.pod:2612 ../src/guestfs-actions.pod:2652 msgid "" "This function returns a string, or NULL on error. The string is owned by " "the guest handle and must I<not> be freed." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2601 +#: ../src/guestfs-actions.pod:2617 msgid "guestfs_get_pgroup" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2603 +#: ../src/guestfs-actions.pod:2619 #, no-wrap msgid "" " int\n" @@ -28714,17 +28861,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2610 ../src/guestfs-actions.pod:7092 ../src/guestfs-actions.pod:8553 +#: ../src/guestfs-actions.pod:2626 ../src/guestfs-actions.pod:7131 ../src/guestfs-actions.pod:8615 msgid "(Added in 1.11.18)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2612 +#: ../src/guestfs-actions.pod:2628 msgid "guestfs_get_pid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2614 +#: ../src/guestfs-actions.pod:2630 #, no-wrap msgid "" " int\n" @@ -28733,17 +28880,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2624 +#: ../src/guestfs-actions.pod:2640 msgid "(Added in 1.0.56)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2626 +#: ../src/guestfs-actions.pod:2642 msgid "guestfs_get_qemu" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2628 +#: ../src/guestfs-actions.pod:2644 #, no-wrap msgid "" " const char *\n" @@ -28752,17 +28899,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2639 ../src/guestfs-actions.pod:7120 +#: ../src/guestfs-actions.pod:2655 ../src/guestfs-actions.pod:7159 msgid "(Added in 1.0.6)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2641 +#: ../src/guestfs-actions.pod:2657 msgid "guestfs_get_recovery_proc" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2643 +#: ../src/guestfs-actions.pod:2659 #, no-wrap msgid "" " int\n" @@ -28771,17 +28918,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2650 ../src/guestfs-actions.pod:4236 ../src/guestfs-actions.pod:4580 ../src/guestfs-actions.pod:4974 ../src/guestfs-actions.pod:5162 ../src/guestfs-actions.pod:6357 ../src/guestfs-actions.pod:6700 ../src/guestfs-actions.pod:7144 ../src/guestfs-actions.pod:7842 ../src/guestfs-actions.pod:7862 ../src/guestfs-actions.pod:8176 +#: ../src/guestfs-actions.pod:2666 ../src/guestfs-actions.pod:4261 ../src/guestfs-actions.pod:4605 ../src/guestfs-actions.pod:4999 ../src/guestfs-actions.pod:5187 ../src/guestfs-actions.pod:6396 ../src/guestfs-actions.pod:6739 ../src/guestfs-actions.pod:7183 ../src/guestfs-actions.pod:7904 ../src/guestfs-actions.pod:7924 ../src/guestfs-actions.pod:8238 msgid "(Added in 1.0.77)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2652 +#: ../src/guestfs-actions.pod:2668 msgid "guestfs_get_selinux" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2654 +#: ../src/guestfs-actions.pod:2670 #, no-wrap msgid "" " int\n" @@ -28790,24 +28937,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2657 +#: ../src/guestfs-actions.pod:2673 msgid "" "This returns the current setting of the selinux flag which is passed to the " "appliance at boot time. See C<guestfs_set_selinux>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2665 ../src/guestfs-actions.pod:2739 ../src/guestfs-actions.pod:7163 ../src/guestfs-actions.pod:7237 +#: ../src/guestfs-actions.pod:2681 ../src/guestfs-actions.pod:2755 ../src/guestfs-actions.pod:7202 ../src/guestfs-actions.pod:7276 msgid "(Added in 1.0.67)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2667 +#: ../src/guestfs-actions.pod:2683 msgid "guestfs_get_smp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2669 +#: ../src/guestfs-actions.pod:2685 #, no-wrap msgid "" " int\n" @@ -28816,12 +28963,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2678 +#: ../src/guestfs-actions.pod:2694 msgid "guestfs_get_state" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2680 +#: ../src/guestfs-actions.pod:2696 #, no-wrap msgid "" " int\n" @@ -28830,12 +28977,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2692 +#: ../src/guestfs-actions.pod:2708 msgid "guestfs_get_trace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2694 +#: ../src/guestfs-actions.pod:2710 #, no-wrap msgid "" " int\n" @@ -28844,12 +28991,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2703 +#: ../src/guestfs-actions.pod:2719 msgid "guestfs_get_umask" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2705 +#: ../src/guestfs-actions.pod:2721 #, no-wrap msgid "" " int\n" @@ -28858,19 +29005,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2708 +#: ../src/guestfs-actions.pod:2724 msgid "" "Return the current umask. By default the umask is C<022> unless it has been " "set by calling C<guestfs_umask>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2715 +#: ../src/guestfs-actions.pod:2731 msgid "guestfs_get_verbose" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2717 +#: ../src/guestfs-actions.pod:2733 #, no-wrap msgid "" " int\n" @@ -28879,12 +29026,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2726 +#: ../src/guestfs-actions.pod:2742 msgid "guestfs_getcon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2728 +#: ../src/guestfs-actions.pod:2744 #, no-wrap msgid "" " char *\n" @@ -28893,17 +29040,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2733 +#: ../src/guestfs-actions.pod:2749 msgid "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2741 +#: ../src/guestfs-actions.pod:2757 msgid "guestfs_getxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2743 +#: ../src/guestfs-actions.pod:2759 #, no-wrap msgid "" " char *\n" @@ -28915,7 +29062,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2749 +#: ../src/guestfs-actions.pod:2765 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 " @@ -28923,7 +29070,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2753 ../src/guestfs-actions.pod:4250 +#: ../src/guestfs-actions.pod:2769 ../src/guestfs-actions.pod:4275 msgid "" "Normally it is better to get all extended attributes from a file in one go " "by calling C<guestfs_getxattrs>. However some Linux filesystem " @@ -28933,12 +29080,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2763 +#: ../src/guestfs-actions.pod:2779 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2765 ../src/guestfs-actions.pod:2978 ../src/guestfs-actions.pod:3458 ../src/guestfs-actions.pod:4262 ../src/guestfs-actions.pod:6350 ../src/guestfs-actions.pod:6376 ../src/guestfs-actions.pod:6557 +#: ../src/guestfs-actions.pod:2781 ../src/guestfs-actions.pod:2994 ../src/guestfs-actions.pod:3474 ../src/guestfs-actions.pod:4287 ../src/guestfs-actions.pod:6389 ../src/guestfs-actions.pod:6415 ../src/guestfs-actions.pod:6596 msgid "" "This function returns a buffer, or NULL on error. The size of the returned " "buffer is written to C<*size_r>. I<The caller must free the returned buffer " @@ -28946,17 +29093,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2769 ../src/guestfs-actions.pod:4266 +#: ../src/guestfs-actions.pod:2785 ../src/guestfs-actions.pod:4291 msgid "(Added in 1.7.24)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2771 +#: ../src/guestfs-actions.pod:2787 msgid "guestfs_getxattrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2773 +#: ../src/guestfs-actions.pod:2789 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -28966,29 +29113,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2783 +#: ../src/guestfs-actions.pod:2799 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2785 ../src/guestfs-actions.pod:4278 ../src/guestfs-actions.pod:4970 +#: ../src/guestfs-actions.pod:2801 ../src/guestfs-actions.pod:4303 ../src/guestfs-actions.pod:4995 msgid "" "This function returns a C<struct guestfs_xattr_list *>, or NULL if there was " "an error. I<The caller must call C<guestfs_free_xattr_list> after use>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2789 ../src/guestfs-actions.pod:4282 ../src/guestfs-actions.pod:4494 ../src/guestfs-actions.pod:4530 ../src/guestfs-actions.pod:6730 ../src/guestfs-actions.pod:7256 ../src/guestfs-actions.pod:8761 +#: ../src/guestfs-actions.pod:2805 ../src/guestfs-actions.pod:4307 ../src/guestfs-actions.pod:4519 ../src/guestfs-actions.pod:4555 ../src/guestfs-actions.pod:6769 ../src/guestfs-actions.pod:7295 ../src/guestfs-actions.pod:8823 msgid "(Added in 1.0.59)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2791 +#: ../src/guestfs-actions.pod:2807 msgid "guestfs_glob_expand" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2793 +#: ../src/guestfs-actions.pod:2809 #, no-wrap msgid "" " char **\n" @@ -28998,17 +29145,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2812 ../src/guestfs-actions.pod:7440 ../src/guestfs-actions.pod:7457 +#: ../src/guestfs-actions.pod:2828 ../src/guestfs-actions.pod:7479 ../src/guestfs-actions.pod:7496 msgid "(Added in 1.0.50)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2814 +#: ../src/guestfs-actions.pod:2830 msgid "guestfs_grep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2816 +#: ../src/guestfs-actions.pod:2832 #, no-wrap msgid "" " char **\n" @@ -29019,12 +29166,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2833 +#: ../src/guestfs-actions.pod:2849 msgid "guestfs_grepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2835 +#: ../src/guestfs-actions.pod:2851 #, no-wrap msgid "" " char **\n" @@ -29035,12 +29182,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2852 +#: ../src/guestfs-actions.pod:2868 msgid "guestfs_grub_install" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2854 +#: ../src/guestfs-actions.pod:2870 #, no-wrap msgid "" " int\n" @@ -29051,17 +29198,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2897 +#: ../src/guestfs-actions.pod:2913 msgid "(Added in 1.0.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2899 +#: ../src/guestfs-actions.pod:2915 msgid "guestfs_head" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2901 +#: ../src/guestfs-actions.pod:2917 #, no-wrap msgid "" " char **\n" @@ -29071,12 +29218,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2917 +#: ../src/guestfs-actions.pod:2933 msgid "guestfs_head_n" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2919 +#: ../src/guestfs-actions.pod:2935 #, no-wrap msgid "" " char **\n" @@ -29087,12 +29234,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2941 +#: ../src/guestfs-actions.pod:2957 msgid "guestfs_hexdump" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2943 +#: ../src/guestfs-actions.pod:2959 #, no-wrap msgid "" " char *\n" @@ -29102,17 +29249,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2956 ../src/guestfs-actions.pod:7521 ../src/guestfs-actions.pod:7576 +#: ../src/guestfs-actions.pod:2972 ../src/guestfs-actions.pod:7583 ../src/guestfs-actions.pod:7638 msgid "(Added in 1.0.22)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2958 +#: ../src/guestfs-actions.pod:2974 msgid "guestfs_initrd_cat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2960 +#: ../src/guestfs-actions.pod:2976 #, no-wrap msgid "" " char *\n" @@ -29124,17 +29271,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2976 +#: ../src/guestfs-actions.pod:2992 msgid "See also C<guestfs_initrd_list>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2987 +#: ../src/guestfs-actions.pod:3003 msgid "guestfs_initrd_list" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2989 +#: ../src/guestfs-actions.pod:3005 #, no-wrap msgid "" " char **\n" @@ -29144,12 +29291,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3009 +#: ../src/guestfs-actions.pod:3025 msgid "guestfs_inotify_add_watch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3011 +#: ../src/guestfs-actions.pod:3027 #, no-wrap msgid "" " int64_t\n" @@ -29160,12 +29307,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3030 +#: ../src/guestfs-actions.pod:3046 msgid "guestfs_inotify_close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3032 +#: ../src/guestfs-actions.pod:3048 #, no-wrap msgid "" " int\n" @@ -29174,12 +29321,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3043 +#: ../src/guestfs-actions.pod:3059 msgid "guestfs_inotify_files" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3045 +#: ../src/guestfs-actions.pod:3061 #, no-wrap msgid "" " char **\n" @@ -29188,7 +29335,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3048 +#: ../src/guestfs-actions.pod:3064 msgid "" "This function is a helpful wrapper around C<guestfs_inotify_read> which just " "returns a list of pathnames of objects that were touched. The returned " @@ -29196,12 +29343,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3058 +#: ../src/guestfs-actions.pod:3074 msgid "guestfs_inotify_init" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3060 +#: ../src/guestfs-actions.pod:3076 #, no-wrap msgid "" " int\n" @@ -29211,7 +29358,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3068 +#: ../src/guestfs-actions.pod:3084 msgid "" "C<maxevents> is the maximum number of events which will be queued up between " "calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>. If this is " @@ -29223,7 +29370,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3078 +#: ../src/guestfs-actions.pod:3094 msgid "" "Before any events are generated, you have to add some watches to the " "internal watch list. See: C<guestfs_inotify_add_watch> and " @@ -29231,7 +29378,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3082 +#: ../src/guestfs-actions.pod:3098 msgid "" "Queued up events should be read periodically by calling " "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful " @@ -29240,19 +29387,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3089 +#: ../src/guestfs-actions.pod:3105 msgid "" "The handle should be closed after use by calling C<guestfs_inotify_close>. " "This also removes any watches automatically." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3102 +#: ../src/guestfs-actions.pod:3118 msgid "guestfs_inotify_read" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3104 +#: ../src/guestfs-actions.pod:3120 #, no-wrap msgid "" " struct guestfs_inotify_event_list *\n" @@ -29261,7 +29408,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3118 +#: ../src/guestfs-actions.pod:3134 msgid "" "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if " "there was an error. I<The caller must call " @@ -29269,12 +29416,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3124 +#: ../src/guestfs-actions.pod:3140 msgid "guestfs_inotify_rm_watch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3126 +#: ../src/guestfs-actions.pod:3142 #, no-wrap msgid "" " int\n" @@ -29284,19 +29431,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3130 +#: ../src/guestfs-actions.pod:3146 msgid "" "Remove a previously defined inotify watch. See " "C<guestfs_inotify_add_watch>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3137 +#: ../src/guestfs-actions.pod:3153 msgid "guestfs_inspect_get_arch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3139 +#: ../src/guestfs-actions.pod:3155 #, no-wrap msgid "" " char *\n" @@ -29306,19 +29453,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3143 +#: ../src/guestfs-actions.pod:3159 msgid "" "This returns the architecture of the inspected operating system. The " "possible return values are listed under C<guestfs_file_architecture>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3157 +#: ../src/guestfs-actions.pod:3173 msgid "guestfs_inspect_get_distro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3159 +#: ../src/guestfs-actions.pod:3175 #, no-wrap msgid "" " char *\n" @@ -29328,12 +29475,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3259 +#: ../src/guestfs-actions.pod:3275 msgid "guestfs_inspect_get_drive_mappings" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3261 +#: ../src/guestfs-actions.pod:3277 #, no-wrap msgid "" " char **\n" @@ -29343,24 +29490,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3290 +#: ../src/guestfs-actions.pod:3306 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_mountpoints>, C<guestfs_inspect_get_filesystems>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3300 ../src/guestfs-actions.pod:3765 +#: ../src/guestfs-actions.pod:3316 ../src/guestfs-actions.pod:3781 msgid "(Added in 1.9.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3302 +#: ../src/guestfs-actions.pod:3318 msgid "guestfs_inspect_get_filesystems" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3304 +#: ../src/guestfs-actions.pod:3320 #, no-wrap msgid "" " char **\n" @@ -29370,19 +29517,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3316 +#: ../src/guestfs-actions.pod:3332 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_mountpoints>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3325 +#: ../src/guestfs-actions.pod:3341 msgid "guestfs_inspect_get_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3327 +#: ../src/guestfs-actions.pod:3343 #, no-wrap msgid "" " char *\n" @@ -29392,17 +29539,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3361 ../src/guestfs-actions.pod:3801 ../src/guestfs-actions.pod:3817 ../src/guestfs-actions.pod:3835 ../src/guestfs-actions.pod:6768 +#: ../src/guestfs-actions.pod:3377 ../src/guestfs-actions.pod:3817 ../src/guestfs-actions.pod:3833 ../src/guestfs-actions.pod:3851 ../src/guestfs-actions.pod:6807 msgid "(Added in 1.9.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3363 +#: ../src/guestfs-actions.pod:3379 msgid "guestfs_inspect_get_hostname" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3365 +#: ../src/guestfs-actions.pod:3381 #, no-wrap msgid "" " char *\n" @@ -29412,17 +29559,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3380 +#: ../src/guestfs-actions.pod:3396 msgid "(Added in 1.7.9)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3382 +#: ../src/guestfs-actions.pod:3398 msgid "guestfs_inspect_get_icon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3384 +#: ../src/guestfs-actions.pod:3400 #, no-wrap msgid "" " char *\n" @@ -29434,7 +29581,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3395 +#: ../src/guestfs-actions.pod:3411 #, no-wrap msgid "" " GUESTFS_INSPECT_GET_ICON_FAVICON, int favicon,\n" @@ -29443,17 +29590,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3462 ../src/guestfs-actions.pod:4296 ../src/guestfs-actions.pod:5700 +#: ../src/guestfs-actions.pod:3478 ../src/guestfs-actions.pod:4321 ../src/guestfs-actions.pod:5725 msgid "(Added in 1.11.12)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3464 +#: ../src/guestfs-actions.pod:3480 msgid "guestfs_inspect_get_icon_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3466 +#: ../src/guestfs-actions.pod:3482 #, no-wrap msgid "" " char *\n" @@ -29465,17 +29612,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3472 +#: ../src/guestfs-actions.pod:3488 msgid "This is the \"va_list variant\" of L</guestfs_inspect_get_icon>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3476 +#: ../src/guestfs-actions.pod:3492 msgid "guestfs_inspect_get_icon_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3478 +#: ../src/guestfs-actions.pod:3494 #, no-wrap msgid "" " char *\n" @@ -29488,17 +29635,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3484 +#: ../src/guestfs-actions.pod:3500 msgid "This is the \"argv variant\" of L</guestfs_inspect_get_icon>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3488 +#: ../src/guestfs-actions.pod:3504 msgid "guestfs_inspect_get_major_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3490 +#: ../src/guestfs-actions.pod:3506 #, no-wrap msgid "" " int\n" @@ -29508,12 +29655,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3512 +#: ../src/guestfs-actions.pod:3528 msgid "guestfs_inspect_get_minor_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3514 +#: ../src/guestfs-actions.pod:3530 #, no-wrap msgid "" " int\n" @@ -29523,19 +29670,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3523 +#: ../src/guestfs-actions.pod:3539 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_major_version>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3530 +#: ../src/guestfs-actions.pod:3546 msgid "guestfs_inspect_get_mountpoints" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3532 +#: ../src/guestfs-actions.pod:3548 #, no-wrap msgid "" " char **\n" @@ -29545,7 +29692,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3553 +#: ../src/guestfs-actions.pod:3569 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 " @@ -29554,19 +29701,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3559 +#: ../src/guestfs-actions.pod:3575 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3570 +#: ../src/guestfs-actions.pod:3586 msgid "guestfs_inspect_get_package_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3572 +#: ../src/guestfs-actions.pod:3588 #, no-wrap msgid "" " char *\n" @@ -29576,7 +29723,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3576 +#: ../src/guestfs-actions.pod:3592 msgid "" "This function and C<guestfs_inspect_get_package_management> return the " "package format and package management tool used by the inspected operating " @@ -29585,17 +29732,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3595 ../src/guestfs-actions.pod:3623 +#: ../src/guestfs-actions.pod:3611 ../src/guestfs-actions.pod:3639 msgid "(Added in 1.7.5)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3597 +#: ../src/guestfs-actions.pod:3613 msgid "guestfs_inspect_get_package_management" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3599 +#: ../src/guestfs-actions.pod:3615 #, no-wrap msgid "" " char *\n" @@ -29605,7 +29752,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3603 +#: ../src/guestfs-actions.pod:3619 msgid "" "C<guestfs_inspect_get_package_format> and this function return the package " "format and package management tool used by the inspected operating system. " @@ -29614,12 +29761,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3625 +#: ../src/guestfs-actions.pod:3641 msgid "guestfs_inspect_get_product_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3627 +#: ../src/guestfs-actions.pod:3643 #, no-wrap msgid "" " char *\n" @@ -29629,12 +29776,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3646 +#: ../src/guestfs-actions.pod:3662 msgid "guestfs_inspect_get_product_variant" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3648 +#: ../src/guestfs-actions.pod:3664 #, no-wrap msgid "" " char *\n" @@ -29644,24 +29791,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3671 +#: ../src/guestfs-actions.pod:3687 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_product_name>, C<guestfs_inspect_get_major_version>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3678 +#: ../src/guestfs-actions.pod:3694 msgid "(Added in 1.9.13)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3680 +#: ../src/guestfs-actions.pod:3696 msgid "guestfs_inspect_get_roots" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3682 +#: ../src/guestfs-actions.pod:3698 #, no-wrap msgid "" " char **\n" @@ -29670,7 +29817,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3685 +#: ../src/guestfs-actions.pod:3701 msgid "" "This function is a convenient way to get the list of root devices, as " "returned from a previous call to C<guestfs_inspect_os>, but without redoing " @@ -29678,24 +29825,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3689 +#: ../src/guestfs-actions.pod:3705 msgid "" "This returns an empty list if either no root devices were found or the " "caller has not called C<guestfs_inspect_os>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3698 +#: ../src/guestfs-actions.pod:3714 msgid "(Added in 1.7.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3700 +#: ../src/guestfs-actions.pod:3716 msgid "guestfs_inspect_get_type" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3702 +#: ../src/guestfs-actions.pod:3718 #, no-wrap msgid "" " char *\n" @@ -29705,12 +29852,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3747 +#: ../src/guestfs-actions.pod:3763 msgid "guestfs_inspect_get_windows_current_control_set" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3749 +#: ../src/guestfs-actions.pod:3765 #, no-wrap msgid "" " char *\n" @@ -29720,12 +29867,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3767 +#: ../src/guestfs-actions.pod:3783 msgid "guestfs_inspect_get_windows_systemroot" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3769 +#: ../src/guestfs-actions.pod:3785 #, no-wrap msgid "" " char *\n" @@ -29735,17 +29882,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3785 +#: ../src/guestfs-actions.pod:3801 msgid "(Added in 1.5.25)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3787 +#: ../src/guestfs-actions.pod:3803 msgid "guestfs_inspect_is_live" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3789 +#: ../src/guestfs-actions.pod:3805 #, no-wrap msgid "" " int\n" @@ -29755,19 +29902,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3793 +#: ../src/guestfs-actions.pod:3809 msgid "" "If C<guestfs_inspect_get_format> returns C<installer> (this is an install " "disk), then this returns true if a live image was detected on the disk." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3803 +#: ../src/guestfs-actions.pod:3819 msgid "guestfs_inspect_is_multipart" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3805 +#: ../src/guestfs-actions.pod:3821 #, no-wrap msgid "" " int\n" @@ -29777,19 +29924,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3809 +#: ../src/guestfs-actions.pod:3825 msgid "" "If C<guestfs_inspect_get_format> returns C<installer> (this is an install " "disk), then this returns true if the disk is part of a set." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3819 +#: ../src/guestfs-actions.pod:3835 msgid "guestfs_inspect_is_netinst" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3821 +#: ../src/guestfs-actions.pod:3837 #, no-wrap msgid "" " int\n" @@ -29799,7 +29946,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3825 +#: ../src/guestfs-actions.pod:3841 msgid "" "If C<guestfs_inspect_get_format> returns C<installer> (this is an install " "disk), then this returns true if the disk is a network installer, ie. not a " @@ -29808,12 +29955,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3837 +#: ../src/guestfs-actions.pod:3853 msgid "guestfs_inspect_list_applications" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3839 +#: ../src/guestfs-actions.pod:3855 #, no-wrap msgid "" " struct guestfs_application_list *\n" @@ -29823,7 +29970,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3845 +#: ../src/guestfs-actions.pod:3861 msgid "" "I<Note:> This call works differently from other parts of the inspection " "API. You have to call C<guestfs_inspect_os>, then " @@ -29836,7 +29983,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3935 +#: ../src/guestfs-actions.pod:3951 msgid "" "This function returns a C<struct guestfs_application_list *>, or NULL if " "there was an error. I<The caller must call C<guestfs_free_application_list> " @@ -29844,17 +29991,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3939 +#: ../src/guestfs-actions.pod:3955 msgid "(Added in 1.7.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3941 +#: ../src/guestfs-actions.pod:3957 msgid "guestfs_inspect_os" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3943 +#: ../src/guestfs-actions.pod:3959 #, no-wrap msgid "" " char **\n" @@ -29863,7 +30010,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3959 +#: ../src/guestfs-actions.pod:3975 msgid "" "You can pass the root string(s) returned to other C<guestfs_inspect_get_*> " "functions in order to query further information about each operating system, " @@ -29871,7 +30018,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3964 +#: ../src/guestfs-actions.pod:3980 msgid "" "This function uses other libguestfs features such as C<guestfs_mount_ro> and " "C<guestfs_umount_all> in order to mount and unmount filesystems and look at " @@ -29880,17 +30027,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3976 ../src/guestfs-actions.pod:4307 ../src/guestfs-actions.pod:4402 +#: ../src/guestfs-actions.pod:3992 ../src/guestfs-actions.pod:4332 ../src/guestfs-actions.pod:4427 msgid "See also C<guestfs_list_filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3984 +#: ../src/guestfs-actions.pod:4000 msgid "guestfs_is_blockdev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3986 +#: ../src/guestfs-actions.pod:4002 #, no-wrap msgid "" " int\n" @@ -29900,22 +30047,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3993 ../src/guestfs-actions.pod:4022 ../src/guestfs-actions.pod:4052 ../src/guestfs-actions.pod:4067 ../src/guestfs-actions.pod:4083 ../src/guestfs-actions.pod:4139 ../src/guestfs-actions.pod:4154 +#: ../src/guestfs-actions.pod:4009 ../src/guestfs-actions.pod:4038 ../src/guestfs-actions.pod:4068 ../src/guestfs-actions.pod:4083 ../src/guestfs-actions.pod:4099 ../src/guestfs-actions.pod:4155 ../src/guestfs-actions.pod:4170 msgid "See also C<guestfs_stat>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3997 ../src/guestfs-actions.pod:4026 ../src/guestfs-actions.pod:4071 ../src/guestfs-actions.pod:4143 ../src/guestfs-actions.pod:4158 +#: ../src/guestfs-actions.pod:4013 ../src/guestfs-actions.pod:4042 ../src/guestfs-actions.pod:4087 ../src/guestfs-actions.pod:4159 ../src/guestfs-actions.pod:4174 msgid "(Added in 1.5.10)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3999 +#: ../src/guestfs-actions.pod:4015 msgid "guestfs_is_busy" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4001 +#: ../src/guestfs-actions.pod:4017 #, no-wrap msgid "" " int\n" @@ -29924,12 +30071,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4013 +#: ../src/guestfs-actions.pod:4029 msgid "guestfs_is_chardev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4015 +#: ../src/guestfs-actions.pod:4031 #, no-wrap msgid "" " int\n" @@ -29939,12 +30086,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4028 +#: ../src/guestfs-actions.pod:4044 msgid "guestfs_is_config" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4030 +#: ../src/guestfs-actions.pod:4046 #, no-wrap msgid "" " int\n" @@ -29953,12 +30100,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4042 +#: ../src/guestfs-actions.pod:4058 msgid "guestfs_is_dir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4044 +#: ../src/guestfs-actions.pod:4060 #, no-wrap msgid "" " int\n" @@ -29968,12 +30115,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4058 +#: ../src/guestfs-actions.pod:4074 msgid "guestfs_is_fifo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4060 +#: ../src/guestfs-actions.pod:4076 #, no-wrap msgid "" " int\n" @@ -29983,12 +30130,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4073 +#: ../src/guestfs-actions.pod:4089 msgid "guestfs_is_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4075 +#: ../src/guestfs-actions.pod:4091 #, no-wrap msgid "" " int\n" @@ -29998,12 +30145,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4089 +#: ../src/guestfs-actions.pod:4105 msgid "guestfs_is_launching" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4091 +#: ../src/guestfs-actions.pod:4107 #, no-wrap msgid "" " int\n" @@ -30012,12 +30159,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4103 +#: ../src/guestfs-actions.pod:4119 msgid "guestfs_is_lv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4105 +#: ../src/guestfs-actions.pod:4121 #, no-wrap msgid "" " int\n" @@ -30027,12 +30174,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4116 +#: ../src/guestfs-actions.pod:4132 msgid "guestfs_is_ready" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4118 +#: ../src/guestfs-actions.pod:4134 #, no-wrap msgid "" " int\n" @@ -30041,12 +30188,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4130 +#: ../src/guestfs-actions.pod:4146 msgid "guestfs_is_socket" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4132 +#: ../src/guestfs-actions.pod:4148 #, no-wrap msgid "" " int\n" @@ -30056,12 +30203,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4145 +#: ../src/guestfs-actions.pod:4161 msgid "guestfs_is_symlink" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4147 +#: ../src/guestfs-actions.pod:4163 #, no-wrap msgid "" " int\n" @@ -30071,12 +30218,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4160 +#: ../src/guestfs-actions.pod:4176 msgid "guestfs_is_zero" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4162 +#: ../src/guestfs-actions.pod:4178 #, no-wrap msgid "" " int\n" @@ -30086,17 +30233,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4171 ../src/guestfs-actions.pod:4185 +#: ../src/guestfs-actions.pod:4187 ../src/guestfs-actions.pod:4201 msgid "(Added in 1.11.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4173 +#: ../src/guestfs-actions.pod:4189 msgid "guestfs_is_zero_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4175 +#: ../src/guestfs-actions.pod:4191 #, no-wrap msgid "" " int\n" @@ -30106,12 +30253,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4187 +#: ../src/guestfs-actions.pod:4203 msgid "guestfs_kill_subprocess" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4189 +#: ../src/guestfs-actions.pod:4205 #, no-wrap msgid "" " int\n" @@ -30119,13 +30266,25 @@ msgid "" "\n" msgstr "" +#. type: textblock +#: ../src/guestfs-actions.pod:4208 +msgid "" +"I<This function is deprecated.> In new code, use the L</guestfs_shutdown> " +"call instead." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:4217 +msgid "Do not call this. See: C<guestfs_shutdown> instead." +msgstr "" + #. type: =head2 -#: ../src/guestfs-actions.pod:4198 +#: ../src/guestfs-actions.pod:4223 msgid "guestfs_launch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4200 +#: ../src/guestfs-actions.pod:4225 #, no-wrap msgid "" " int\n" @@ -30134,12 +30293,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4218 +#: ../src/guestfs-actions.pod:4243 msgid "guestfs_lchown" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4220 +#: ../src/guestfs-actions.pod:4245 #, no-wrap msgid "" " int\n" @@ -30151,7 +30310,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4226 +#: ../src/guestfs-actions.pod:4251 msgid "" "Change the file owner to C<owner> and group to C<group>. This is like " "C<guestfs_chown> but if C<path> is a symlink then the link itself is " @@ -30159,12 +30318,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4238 +#: ../src/guestfs-actions.pod:4263 msgid "guestfs_lgetxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4240 +#: ../src/guestfs-actions.pod:4265 #, no-wrap msgid "" " char *\n" @@ -30176,17 +30335,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4260 +#: ../src/guestfs-actions.pod:4285 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4268 +#: ../src/guestfs-actions.pod:4293 msgid "guestfs_lgetxattrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4270 +#: ../src/guestfs-actions.pod:4295 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -30196,19 +30355,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4274 +#: ../src/guestfs-actions.pod:4299 msgid "" "This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, " "then it returns the extended attributes of the link itself." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4284 +#: ../src/guestfs-actions.pod:4309 msgid "guestfs_list_9p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4286 +#: ../src/guestfs-actions.pod:4311 #, no-wrap msgid "" " char **\n" @@ -30217,12 +30376,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4298 +#: ../src/guestfs-actions.pod:4323 msgid "guestfs_list_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4300 +#: ../src/guestfs-actions.pod:4325 #, no-wrap msgid "" " char **\n" @@ -30231,12 +30390,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4315 +#: ../src/guestfs-actions.pod:4340 msgid "guestfs_list_dm_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4317 +#: ../src/guestfs-actions.pod:4342 #, no-wrap msgid "" " char **\n" @@ -30245,14 +30404,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4322 +#: ../src/guestfs-actions.pod:4347 msgid "" "The returned list contains C</dev/mapper/*> devices, eg. ones created by a " "previous call to C<guestfs_luks_open>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4325 +#: ../src/guestfs-actions.pod:4350 msgid "" "Device mapper devices which correspond to logical volumes are I<not> " "returned in this list. Call C<guestfs_lvs> if you want to list logical " @@ -30260,17 +30419,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4333 ../src/guestfs-actions.pod:5939 +#: ../src/guestfs-actions.pod:4358 ../src/guestfs-actions.pod:5978 msgid "(Added in 1.11.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4335 +#: ../src/guestfs-actions.pod:4360 msgid "guestfs_list_filesystems" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4337 +#: ../src/guestfs-actions.pod:4362 #, no-wrap msgid "" " char **\n" @@ -30279,7 +30438,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4357 +#: ../src/guestfs-actions.pod:4382 msgid "" "This command runs other libguestfs commands, which might include " "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this " @@ -30287,7 +30446,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4361 +#: ../src/guestfs-actions.pod:4386 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 " @@ -30298,17 +30457,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4375 ../src/guestfs-actions.pod:6299 +#: ../src/guestfs-actions.pod:4400 ../src/guestfs-actions.pod:6338 msgid "(Added in 1.5.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4377 +#: ../src/guestfs-actions.pod:4402 msgid "guestfs_list_md_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4379 +#: ../src/guestfs-actions.pod:4404 #, no-wrap msgid "" " char **\n" @@ -30317,17 +30476,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4388 ../src/guestfs-actions.pod:7962 +#: ../src/guestfs-actions.pod:4413 ../src/guestfs-actions.pod:8024 msgid "(Added in 1.15.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4390 +#: ../src/guestfs-actions.pod:4415 msgid "guestfs_list_partitions" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4392 +#: ../src/guestfs-actions.pod:4417 #, no-wrap msgid "" " char **\n" @@ -30336,19 +30495,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4399 +#: ../src/guestfs-actions.pod:4424 msgid "" "This does not return logical volumes. For that you will need to call " "C<guestfs_lvs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4410 +#: ../src/guestfs-actions.pod:4435 msgid "guestfs_ll" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4412 +#: ../src/guestfs-actions.pod:4437 #, no-wrap msgid "" " char *\n" @@ -30358,12 +30517,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4427 +#: ../src/guestfs-actions.pod:4452 msgid "guestfs_ln" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4429 +#: ../src/guestfs-actions.pod:4454 #, no-wrap msgid "" " int\n" @@ -30374,12 +30533,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4440 +#: ../src/guestfs-actions.pod:4465 msgid "guestfs_ln_f" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4442 +#: ../src/guestfs-actions.pod:4467 #, no-wrap msgid "" " int\n" @@ -30390,12 +30549,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4454 +#: ../src/guestfs-actions.pod:4479 msgid "guestfs_ln_s" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4456 +#: ../src/guestfs-actions.pod:4481 #, no-wrap msgid "" " int\n" @@ -30406,12 +30565,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4467 +#: ../src/guestfs-actions.pod:4492 msgid "guestfs_ln_sf" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4469 +#: ../src/guestfs-actions.pod:4494 #, no-wrap msgid "" " int\n" @@ -30422,12 +30581,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4481 +#: ../src/guestfs-actions.pod:4506 msgid "guestfs_lremovexattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4483 +#: ../src/guestfs-actions.pod:4508 #, no-wrap msgid "" " int\n" @@ -30438,19 +30597,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4488 +#: ../src/guestfs-actions.pod:4513 msgid "" "This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic " "link, then it removes an extended attribute of the link itself." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4496 +#: ../src/guestfs-actions.pod:4521 msgid "guestfs_ls" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4498 +#: ../src/guestfs-actions.pod:4523 #, no-wrap msgid "" " char **\n" @@ -30460,19 +30619,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4506 +#: ../src/guestfs-actions.pod:4531 msgid "" "This command is mostly useful for interactive sessions. Programs should " "probably use C<guestfs_readdir> instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4515 +#: ../src/guestfs-actions.pod:4540 msgid "guestfs_lsetxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4517 +#: ../src/guestfs-actions.pod:4542 #, no-wrap msgid "" " int\n" @@ -30485,19 +30644,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4524 +#: ../src/guestfs-actions.pod:4549 msgid "" "This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, " "then it sets an extended attribute of the link itself." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4532 +#: ../src/guestfs-actions.pod:4557 msgid "guestfs_lstat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4534 +#: ../src/guestfs-actions.pod:4559 #, no-wrap msgid "" " struct guestfs_stat *\n" @@ -30507,31 +30666,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4540 +#: ../src/guestfs-actions.pod:4565 msgid "" "This is the same as C<guestfs_stat> except that if C<path> is a symbolic " "link, then the link is stat-ed, not the file it refers to." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4546 ../src/guestfs-actions.pod:7481 +#: ../src/guestfs-actions.pod:4571 ../src/guestfs-actions.pod:7543 msgid "" "This function returns a C<struct guestfs_stat *>, or NULL if there was an " "error. I<The caller must call C<guestfs_free_stat> after use>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4550 ../src/guestfs-actions.pod:7485 ../src/guestfs-actions.pod:7503 ../src/guestfs-actions.pod:8006 +#: ../src/guestfs-actions.pod:4575 ../src/guestfs-actions.pod:7547 ../src/guestfs-actions.pod:7565 ../src/guestfs-actions.pod:8068 msgid "(Added in 0.9.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4552 +#: ../src/guestfs-actions.pod:4577 msgid "guestfs_lstatlist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4554 +#: ../src/guestfs-actions.pod:4579 #, no-wrap msgid "" " struct guestfs_stat_list *\n" @@ -30542,7 +30701,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4559 +#: ../src/guestfs-actions.pod:4584 msgid "" "This call allows you to perform the C<guestfs_lstat> operation on multiple " "files, where all files are in the directory C<path>. C<names> is the list " @@ -30550,7 +30709,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4568 +#: ../src/guestfs-actions.pod:4593 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. See also C<guestfs_lxattrlist> " @@ -30561,19 +30720,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4576 +#: ../src/guestfs-actions.pod:4601 msgid "" "This function returns a C<struct guestfs_stat_list *>, or NULL if there was " "an error. I<The caller must call C<guestfs_free_stat_list> after use>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4582 +#: ../src/guestfs-actions.pod:4607 msgid "guestfs_luks_add_key" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4584 +#: ../src/guestfs-actions.pod:4609 #, no-wrap msgid "" " int\n" @@ -30586,14 +30745,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4596 +#: ../src/guestfs-actions.pod:4621 msgid "" "Note that if C<keyslot> already contains a key, then this command will " "fail. You have to use C<guestfs_luks_kill_slot> first to remove that key." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4602 ../src/guestfs-actions.pod:4639 ../src/guestfs-actions.pod:4659 ../src/guestfs-actions.pod:4679 ../src/guestfs-actions.pod:4714 ../src/guestfs-actions.pod:4733 +#: ../src/guestfs-actions.pod:4627 ../src/guestfs-actions.pod:4664 ../src/guestfs-actions.pod:4684 ../src/guestfs-actions.pod:4704 ../src/guestfs-actions.pod:4739 ../src/guestfs-actions.pod:4758 msgid "" "This function takes a key or passphrase parameter which could contain " "sensitive material. Read the section L</KEYS AND PASSPHRASES> for more " @@ -30601,17 +30760,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4606 ../src/guestfs-actions.pod:4643 ../src/guestfs-actions.pod:4663 ../src/guestfs-actions.pod:4683 +#: ../src/guestfs-actions.pod:4631 ../src/guestfs-actions.pod:4668 ../src/guestfs-actions.pod:4688 ../src/guestfs-actions.pod:4708 msgid "(Added in 1.5.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4608 +#: ../src/guestfs-actions.pod:4633 msgid "guestfs_luks_close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4610 +#: ../src/guestfs-actions.pod:4635 #, no-wrap msgid "" " int\n" @@ -30621,7 +30780,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4614 +#: ../src/guestfs-actions.pod:4639 msgid "" "This closes a LUKS device that was created earlier by C<guestfs_luks_open> " "or C<guestfs_luks_open_ro>. The C<device> parameter must be the name of the " @@ -30630,17 +30789,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4622 ../src/guestfs-actions.pod:4718 ../src/guestfs-actions.pod:4737 ../src/guestfs-actions.pod:4787 ../src/guestfs-actions.pod:4832 +#: ../src/guestfs-actions.pod:4647 ../src/guestfs-actions.pod:4743 ../src/guestfs-actions.pod:4762 ../src/guestfs-actions.pod:4812 ../src/guestfs-actions.pod:4857 msgid "(Added in 1.5.1)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4624 +#: ../src/guestfs-actions.pod:4649 msgid "guestfs_luks_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4626 +#: ../src/guestfs-actions.pod:4651 #, no-wrap msgid "" " int\n" @@ -30652,12 +30811,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4645 +#: ../src/guestfs-actions.pod:4670 msgid "guestfs_luks_format_cipher" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4647 +#: ../src/guestfs-actions.pod:4672 #, no-wrap msgid "" " int\n" @@ -30670,19 +30829,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4654 +#: ../src/guestfs-actions.pod:4679 msgid "" "This command is the same as C<guestfs_luks_format> but it also allows you to " "set the C<cipher> used." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4665 +#: ../src/guestfs-actions.pod:4690 msgid "guestfs_luks_kill_slot" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4667 +#: ../src/guestfs-actions.pod:4692 #, no-wrap msgid "" " int\n" @@ -30694,12 +30853,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4685 +#: ../src/guestfs-actions.pod:4710 msgid "guestfs_luks_open" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4687 +#: ../src/guestfs-actions.pod:4712 #, no-wrap msgid "" " int\n" @@ -30711,7 +30870,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4705 +#: ../src/guestfs-actions.pod:4730 msgid "" "If this block device contains LVM volume groups, then calling " "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them " @@ -30719,17 +30878,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4709 +#: ../src/guestfs-actions.pod:4734 msgid "Use C<guestfs_list_dm_devices> to list all device mapper devices." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4720 +#: ../src/guestfs-actions.pod:4745 msgid "guestfs_luks_open_ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4722 +#: ../src/guestfs-actions.pod:4747 #, no-wrap msgid "" " int\n" @@ -30741,19 +30900,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4728 +#: ../src/guestfs-actions.pod:4753 msgid "" "This is the same as C<guestfs_luks_open> except that a read-only mapping is " "created." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4739 +#: ../src/guestfs-actions.pod:4764 msgid "guestfs_lvcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4741 +#: ../src/guestfs-actions.pod:4766 #, no-wrap msgid "" " int\n" @@ -30765,12 +30924,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4754 +#: ../src/guestfs-actions.pod:4779 msgid "guestfs_lvm_canonical_lv_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4756 +#: ../src/guestfs-actions.pod:4781 #, no-wrap msgid "" " char *\n" @@ -30780,22 +30939,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4767 +#: ../src/guestfs-actions.pod:4792 msgid "See also C<guestfs_is_lv>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4772 +#: ../src/guestfs-actions.pod:4797 msgid "(Added in 1.5.24)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4774 +#: ../src/guestfs-actions.pod:4799 msgid "guestfs_lvm_clear_filter" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4776 +#: ../src/guestfs-actions.pod:4801 #, no-wrap msgid "" " int\n" @@ -30804,19 +30963,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4779 +#: ../src/guestfs-actions.pod:4804 msgid "" "This undoes the effect of C<guestfs_lvm_set_filter>. LVM will be able to " "see every block device." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4789 +#: ../src/guestfs-actions.pod:4814 msgid "guestfs_lvm_remove_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4791 +#: ../src/guestfs-actions.pod:4816 #, no-wrap msgid "" " int\n" @@ -30825,12 +30984,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4801 +#: ../src/guestfs-actions.pod:4826 msgid "guestfs_lvm_set_filter" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4803 +#: ../src/guestfs-actions.pod:4828 #, no-wrap msgid "" " int\n" @@ -30840,12 +30999,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4834 +#: ../src/guestfs-actions.pod:4859 msgid "guestfs_lvremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4836 +#: ../src/guestfs-actions.pod:4861 #, no-wrap msgid "" " int\n" @@ -30855,17 +31014,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4848 ../src/guestfs-actions.pod:6414 ../src/guestfs-actions.pod:8376 +#: ../src/guestfs-actions.pod:4873 ../src/guestfs-actions.pod:6453 ../src/guestfs-actions.pod:8438 msgid "(Added in 1.0.13)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4850 +#: ../src/guestfs-actions.pod:4875 msgid "guestfs_lvrename" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4852 +#: ../src/guestfs-actions.pod:4877 #, no-wrap msgid "" " int\n" @@ -30876,17 +31035,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4861 ../src/guestfs-actions.pod:8389 +#: ../src/guestfs-actions.pod:4886 ../src/guestfs-actions.pod:8451 msgid "(Added in 1.0.83)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4863 +#: ../src/guestfs-actions.pod:4888 msgid "guestfs_lvresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4865 +#: ../src/guestfs-actions.pod:4890 #, no-wrap msgid "" " int\n" @@ -30897,12 +31056,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4878 +#: ../src/guestfs-actions.pod:4903 msgid "guestfs_lvresize_free" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4880 +#: ../src/guestfs-actions.pod:4905 #, no-wrap msgid "" " int\n" @@ -30913,17 +31072,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4893 +#: ../src/guestfs-actions.pod:4918 msgid "(Added in 1.3.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4895 +#: ../src/guestfs-actions.pod:4920 msgid "guestfs_lvs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4897 +#: ../src/guestfs-actions.pod:4922 #, no-wrap msgid "" " char **\n" @@ -30932,17 +31091,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4906 +#: ../src/guestfs-actions.pod:4931 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4914 +#: ../src/guestfs-actions.pod:4939 msgid "guestfs_lvs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4916 +#: ../src/guestfs-actions.pod:4941 #, no-wrap msgid "" " struct guestfs_lvm_lv_list *\n" @@ -30951,7 +31110,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4922 +#: ../src/guestfs-actions.pod:4947 msgid "" "This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there " "was an error. I<The caller must call C<guestfs_free_lvm_lv_list> after " @@ -30959,12 +31118,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4928 +#: ../src/guestfs-actions.pod:4953 msgid "guestfs_lvuuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4930 +#: ../src/guestfs-actions.pod:4955 #, no-wrap msgid "" " char *\n" @@ -30974,12 +31133,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4941 +#: ../src/guestfs-actions.pod:4966 msgid "guestfs_lxattrlist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4943 +#: ../src/guestfs-actions.pod:4968 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -30990,7 +31149,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4962 +#: ../src/guestfs-actions.pod:4987 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. See also C<guestfs_lstatlist> for " @@ -31001,12 +31160,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4976 +#: ../src/guestfs-actions.pod:5001 msgid "guestfs_md_create" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4978 +#: ../src/guestfs-actions.pod:5003 #, no-wrap msgid "" " int\n" @@ -31018,7 +31177,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4989 +#: ../src/guestfs-actions.pod:5014 #, no-wrap msgid "" " GUESTFS_MD_CREATE_MISSINGBITMAP, int64_t missingbitmap,\n" @@ -31030,17 +31189,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5051 ../src/guestfs-actions.pod:5117 ../src/guestfs-actions.pod:5130 +#: ../src/guestfs-actions.pod:5076 ../src/guestfs-actions.pod:5142 ../src/guestfs-actions.pod:5155 msgid "(Added in 1.15.6)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5053 +#: ../src/guestfs-actions.pod:5078 msgid "guestfs_md_create_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5055 +#: ../src/guestfs-actions.pod:5080 #, no-wrap msgid "" " int\n" @@ -31052,17 +31211,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5061 +#: ../src/guestfs-actions.pod:5086 msgid "This is the \"va_list variant\" of L</guestfs_md_create>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5065 +#: ../src/guestfs-actions.pod:5090 msgid "guestfs_md_create_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5067 +#: ../src/guestfs-actions.pod:5092 #, no-wrap msgid "" " int\n" @@ -31074,17 +31233,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5073 +#: ../src/guestfs-actions.pod:5098 msgid "This is the \"argv variant\" of L</guestfs_md_create>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5077 +#: ../src/guestfs-actions.pod:5102 msgid "guestfs_md_detail" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5079 +#: ../src/guestfs-actions.pod:5104 #, no-wrap msgid "" " char **\n" @@ -31094,12 +31253,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5119 +#: ../src/guestfs-actions.pod:5144 msgid "guestfs_md_stop" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5121 +#: ../src/guestfs-actions.pod:5146 #, no-wrap msgid "" " int\n" @@ -31109,12 +31268,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5132 +#: ../src/guestfs-actions.pod:5157 msgid "guestfs_mkdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5134 +#: ../src/guestfs-actions.pod:5159 #, no-wrap msgid "" " int\n" @@ -31124,12 +31283,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5144 +#: ../src/guestfs-actions.pod:5169 msgid "guestfs_mkdir_mode" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5146 +#: ../src/guestfs-actions.pod:5171 #, no-wrap msgid "" " int\n" @@ -31140,17 +31299,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5158 +#: ../src/guestfs-actions.pod:5183 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5164 +#: ../src/guestfs-actions.pod:5189 msgid "guestfs_mkdir_p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5166 +#: ../src/guestfs-actions.pod:5191 #, no-wrap msgid "" " int\n" @@ -31160,12 +31319,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5177 +#: ../src/guestfs-actions.pod:5202 msgid "guestfs_mkdtemp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5179 +#: ../src/guestfs-actions.pod:5204 #, no-wrap msgid "" " char *\n" @@ -31175,12 +31334,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5207 +#: ../src/guestfs-actions.pod:5232 msgid "guestfs_mke2fs_J" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5209 +#: ../src/guestfs-actions.pod:5234 #, no-wrap msgid "" " int\n" @@ -31193,22 +31352,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5222 +#: ../src/guestfs-actions.pod:5247 msgid "See also C<guestfs_mke2journal>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5226 ../src/guestfs-actions.pod:5244 ../src/guestfs-actions.pod:5262 ../src/guestfs-actions.pod:5278 ../src/guestfs-actions.pod:5292 ../src/guestfs-actions.pod:5306 ../src/guestfs-actions.pod:5365 ../src/guestfs-actions.pod:5642 +#: ../src/guestfs-actions.pod:5251 ../src/guestfs-actions.pod:5269 ../src/guestfs-actions.pod:5287 ../src/guestfs-actions.pod:5303 ../src/guestfs-actions.pod:5317 ../src/guestfs-actions.pod:5331 ../src/guestfs-actions.pod:5390 ../src/guestfs-actions.pod:5667 msgid "(Added in 1.0.68)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5228 +#: ../src/guestfs-actions.pod:5253 msgid "guestfs_mke2fs_JL" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5230 +#: ../src/guestfs-actions.pod:5255 #, no-wrap msgid "" " int\n" @@ -31221,17 +31380,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5240 +#: ../src/guestfs-actions.pod:5265 msgid "See also C<guestfs_mke2journal_L>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5246 +#: ../src/guestfs-actions.pod:5271 msgid "guestfs_mke2fs_JU" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5248 +#: ../src/guestfs-actions.pod:5273 #, no-wrap msgid "" " int\n" @@ -31244,17 +31403,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5258 +#: ../src/guestfs-actions.pod:5283 msgid "See also C<guestfs_mke2journal_U>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5264 +#: ../src/guestfs-actions.pod:5289 msgid "guestfs_mke2journal" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5266 +#: ../src/guestfs-actions.pod:5291 #, no-wrap msgid "" " int\n" @@ -31265,12 +31424,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5280 +#: ../src/guestfs-actions.pod:5305 msgid "guestfs_mke2journal_L" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5282 +#: ../src/guestfs-actions.pod:5307 #, no-wrap msgid "" " int\n" @@ -31282,12 +31441,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5294 +#: ../src/guestfs-actions.pod:5319 msgid "guestfs_mke2journal_U" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5296 +#: ../src/guestfs-actions.pod:5321 #, no-wrap msgid "" " int\n" @@ -31299,12 +31458,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5308 +#: ../src/guestfs-actions.pod:5333 msgid "guestfs_mkfifo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5310 +#: ../src/guestfs-actions.pod:5335 #, no-wrap msgid "" " int\n" @@ -31315,19 +31474,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5315 +#: ../src/guestfs-actions.pod:5340 msgid "" "This call creates a FIFO (named pipe) called C<path> with mode C<mode>. It " "is just a convenient wrapper around C<guestfs_mknod>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5325 +#: ../src/guestfs-actions.pod:5350 msgid "guestfs_mkfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5327 +#: ../src/guestfs-actions.pod:5352 #, no-wrap msgid "" " int\n" @@ -31338,12 +31497,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5340 +#: ../src/guestfs-actions.pod:5365 msgid "guestfs_mkfs_b" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5342 +#: ../src/guestfs-actions.pod:5367 #, no-wrap msgid "" " int\n" @@ -31355,14 +31514,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5348 +#: ../src/guestfs-actions.pod:5373 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_mkfs_opts> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5355 +#: ../src/guestfs-actions.pod:5380 msgid "" "This call is similar to C<guestfs_mkfs>, but it allows you to control the " "block size of the resulting filesystem. Supported block sizes depend on the " @@ -31370,12 +31529,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5367 +#: ../src/guestfs-actions.pod:5392 msgid "guestfs_mkfs_opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5369 +#: ../src/guestfs-actions.pod:5394 #, no-wrap msgid "" " int\n" @@ -31387,7 +31546,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5380 +#: ../src/guestfs-actions.pod:5405 #, no-wrap msgid "" " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n" @@ -31398,17 +31557,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5428 +#: ../src/guestfs-actions.pod:5453 msgid "(Added in 1.7.19)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5430 +#: ../src/guestfs-actions.pod:5455 msgid "guestfs_mkfs_opts_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5432 +#: ../src/guestfs-actions.pod:5457 #, no-wrap msgid "" " int\n" @@ -31420,17 +31579,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5438 +#: ../src/guestfs-actions.pod:5463 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5442 +#: ../src/guestfs-actions.pod:5467 msgid "guestfs_mkfs_opts_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5444 +#: ../src/guestfs-actions.pod:5469 #, no-wrap msgid "" " int\n" @@ -31442,17 +31601,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5450 +#: ../src/guestfs-actions.pod:5475 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5454 +#: ../src/guestfs-actions.pod:5479 msgid "guestfs_mkmountpoint" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5456 +#: ../src/guestfs-actions.pod:5481 #, no-wrap msgid "" " int\n" @@ -31462,7 +31621,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5460 +#: ../src/guestfs-actions.pod:5485 msgid "" "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls " "that can be used to create extra mountpoints before mounting the first " @@ -31470,7 +31629,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5484 +#: ../src/guestfs-actions.pod:5509 msgid "" "C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>. You " "may get unexpected errors if you try to mix these calls. It is safest to " @@ -31478,7 +31637,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5488 +#: ../src/guestfs-actions.pod:5513 msgid "" "C<guestfs_umount_all> unmounts filesystems by sorting the paths longest " "first, so for this to work for manual mountpoints, you must ensure that the " @@ -31487,7 +31646,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5495 +#: ../src/guestfs-actions.pod:5520 msgid "" "Autosync [see C<guestfs_set_autosync>, this is set by default on handles] " "can cause C<guestfs_umount_all> to be called when the handle is closed which " @@ -31495,17 +31654,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5501 ../src/guestfs-actions.pod:5807 ../src/guestfs-actions.pod:6834 +#: ../src/guestfs-actions.pod:5526 ../src/guestfs-actions.pod:5832 ../src/guestfs-actions.pod:6873 msgid "(Added in 1.0.62)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5503 +#: ../src/guestfs-actions.pod:5528 msgid "guestfs_mknod" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5505 +#: ../src/guestfs-actions.pod:5530 #, no-wrap msgid "" " int\n" @@ -31518,7 +31677,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5520 +#: ../src/guestfs-actions.pod:5545 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 " @@ -31529,12 +31688,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5534 +#: ../src/guestfs-actions.pod:5559 msgid "guestfs_mknod_b" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5536 +#: ../src/guestfs-actions.pod:5561 #, no-wrap msgid "" " int\n" @@ -31547,7 +31706,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5543 +#: ../src/guestfs-actions.pod:5568 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 " @@ -31555,12 +31714,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5553 +#: ../src/guestfs-actions.pod:5578 msgid "guestfs_mknod_c" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5555 +#: ../src/guestfs-actions.pod:5580 #, no-wrap msgid "" " int\n" @@ -31573,7 +31732,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5562 +#: ../src/guestfs-actions.pod:5587 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 " @@ -31581,12 +31740,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5572 +#: ../src/guestfs-actions.pod:5597 msgid "guestfs_mkswap" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5574 +#: ../src/guestfs-actions.pod:5599 #, no-wrap msgid "" " int\n" @@ -31596,12 +31755,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5584 +#: ../src/guestfs-actions.pod:5609 msgid "guestfs_mkswap_L" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5586 +#: ../src/guestfs-actions.pod:5611 #, no-wrap msgid "" " int\n" @@ -31612,12 +31771,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5601 +#: ../src/guestfs-actions.pod:5626 msgid "guestfs_mkswap_U" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5603 +#: ../src/guestfs-actions.pod:5628 #, no-wrap msgid "" " int\n" @@ -31628,12 +31787,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5614 +#: ../src/guestfs-actions.pod:5639 msgid "guestfs_mkswap_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5616 +#: ../src/guestfs-actions.pod:5641 #, no-wrap msgid "" " int\n" @@ -31643,19 +31802,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5622 +#: ../src/guestfs-actions.pod:5647 msgid "" "This command just writes a swap file signature to an existing file. To " "create the file itself, use something like C<guestfs_fallocate>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5629 +#: ../src/guestfs-actions.pod:5654 msgid "guestfs_modprobe" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5631 +#: ../src/guestfs-actions.pod:5656 #, no-wrap msgid "" " int\n" @@ -31665,12 +31824,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5644 +#: ../src/guestfs-actions.pod:5669 msgid "guestfs_mount" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5646 +#: ../src/guestfs-actions.pod:5671 #, no-wrap msgid "" " int\n" @@ -31681,7 +31840,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5665 +#: ../src/guestfs-actions.pod:5690 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 " @@ -31691,12 +31850,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5676 +#: ../src/guestfs-actions.pod:5701 msgid "guestfs_mount_9p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5678 +#: ../src/guestfs-actions.pod:5703 #, no-wrap msgid "" " int\n" @@ -31708,7 +31867,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5689 +#: ../src/guestfs-actions.pod:5714 #, no-wrap msgid "" " GUESTFS_MOUNT_9P_OPTIONS, const char *options,\n" @@ -31716,12 +31875,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5702 +#: ../src/guestfs-actions.pod:5727 msgid "guestfs_mount_9p_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5704 +#: ../src/guestfs-actions.pod:5729 #, no-wrap msgid "" " int\n" @@ -31733,17 +31892,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5710 +#: ../src/guestfs-actions.pod:5735 msgid "This is the \"va_list variant\" of L</guestfs_mount_9p>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5714 +#: ../src/guestfs-actions.pod:5739 msgid "guestfs_mount_9p_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5716 +#: ../src/guestfs-actions.pod:5741 #, no-wrap msgid "" " int\n" @@ -31755,17 +31914,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5722 +#: ../src/guestfs-actions.pod:5747 msgid "This is the \"argv variant\" of L</guestfs_mount_9p>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5726 +#: ../src/guestfs-actions.pod:5751 msgid "guestfs_mount_loop" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5728 +#: ../src/guestfs-actions.pod:5753 #, no-wrap msgid "" " int\n" @@ -31776,12 +31935,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5741 +#: ../src/guestfs-actions.pod:5766 msgid "guestfs_mount_options" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5743 +#: ../src/guestfs-actions.pod:5768 #, no-wrap msgid "" " int\n" @@ -31793,24 +31952,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5749 +#: ../src/guestfs-actions.pod:5774 msgid "" "This is the same as the C<guestfs_mount> command, but it allows you to set " "the mount options as for the L<mount(8)> I<-o> flag." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5759 ../src/guestfs-actions.pod:5773 ../src/guestfs-actions.pod:5790 +#: ../src/guestfs-actions.pod:5784 ../src/guestfs-actions.pod:5798 ../src/guestfs-actions.pod:5815 msgid "(Added in 1.0.10)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5761 +#: ../src/guestfs-actions.pod:5786 msgid "guestfs_mount_ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5763 +#: ../src/guestfs-actions.pod:5788 #, no-wrap msgid "" " int\n" @@ -31821,19 +31980,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5768 +#: ../src/guestfs-actions.pod:5793 msgid "" "This is the same as the C<guestfs_mount> command, but it mounts the " "filesystem with the read-only (I<-o ro>) flag." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5775 +#: ../src/guestfs-actions.pod:5800 msgid "guestfs_mount_vfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5777 +#: ../src/guestfs-actions.pod:5802 #, no-wrap msgid "" " int\n" @@ -31846,7 +32005,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5784 +#: ../src/guestfs-actions.pod:5809 msgid "" "This is the same as the C<guestfs_mount> command, but it allows you to set " "both the mount options and the vfstype as for the L<mount(8)> I<-o> and " @@ -31854,12 +32013,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5792 +#: ../src/guestfs-actions.pod:5817 msgid "guestfs_mountpoints" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5794 +#: ../src/guestfs-actions.pod:5819 #, no-wrap msgid "" " char **\n" @@ -31868,7 +32027,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5797 +#: ../src/guestfs-actions.pod:5822 msgid "" "This call is similar to C<guestfs_mounts>. That call returns a list of " "devices. This one returns a hash table (map) of device name to directory " @@ -31876,12 +32035,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5809 +#: ../src/guestfs-actions.pod:5834 msgid "guestfs_mounts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5811 +#: ../src/guestfs-actions.pod:5836 #, no-wrap msgid "" " char **\n" @@ -31890,17 +32049,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5819 +#: ../src/guestfs-actions.pod:5844 msgid "See also: C<guestfs_mountpoints>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5827 +#: ../src/guestfs-actions.pod:5852 msgid "guestfs_mv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5829 +#: ../src/guestfs-actions.pod:5854 #, no-wrap msgid "" " int\n" @@ -31911,12 +32070,41 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5841 +#: ../src/guestfs-actions.pod:5866 +msgid "guestfs_nr_devices" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:5868 +#, no-wrap +msgid "" +" int\n" +" guestfs_nr_devices (guestfs_h *g);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:5871 +msgid "" +"This returns the number of whole block devices that were added. This is the " +"same as the number of devices that would be returned if you called " +"C<guestfs_list_devices>." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:5875 +msgid "" +"To find out the maximum number of devices that could be added, call " +"C<guestfs_max_disks>." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:5880 msgid "guestfs_ntfs_3g_probe" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5843 +#: ../src/guestfs-actions.pod:5882 #, no-wrap msgid "" " int\n" @@ -31927,17 +32115,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5862 +#: ../src/guestfs-actions.pod:5901 msgid "(Added in 1.0.43)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5864 +#: ../src/guestfs-actions.pod:5903 msgid "guestfs_ntfsresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5866 +#: ../src/guestfs-actions.pod:5905 #, no-wrap msgid "" " int\n" @@ -31947,19 +32135,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5870 ../src/guestfs-actions.pod:5970 +#: ../src/guestfs-actions.pod:5909 ../src/guestfs-actions.pod:6009 msgid "" "I<This function is deprecated.> In new code, use the " "L</guestfs_ntfsresize_opts> call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5894 +#: ../src/guestfs-actions.pod:5933 msgid "guestfs_ntfsresize_opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5896 +#: ../src/guestfs-actions.pod:5935 #, no-wrap msgid "" " int\n" @@ -31970,7 +32158,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5906 +#: ../src/guestfs-actions.pod:5945 #, no-wrap msgid "" " GUESTFS_NTFSRESIZE_OPTS_SIZE, int64_t size,\n" @@ -31979,7 +32167,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5926 +#: ../src/guestfs-actions.pod:5965 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 " @@ -31990,12 +32178,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5941 +#: ../src/guestfs-actions.pod:5980 msgid "guestfs_ntfsresize_opts_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5943 +#: ../src/guestfs-actions.pod:5982 #, no-wrap msgid "" " int\n" @@ -32006,17 +32194,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5948 +#: ../src/guestfs-actions.pod:5987 msgid "This is the \"va_list variant\" of L</guestfs_ntfsresize_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5952 +#: ../src/guestfs-actions.pod:5991 msgid "guestfs_ntfsresize_opts_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5954 +#: ../src/guestfs-actions.pod:5993 #, no-wrap msgid "" " int\n" @@ -32028,17 +32216,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5959 +#: ../src/guestfs-actions.pod:5998 msgid "This is the \"argv variant\" of L</guestfs_ntfsresize_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5963 +#: ../src/guestfs-actions.pod:6002 msgid "guestfs_ntfsresize_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5965 +#: ../src/guestfs-actions.pod:6004 #, no-wrap msgid "" " int\n" @@ -32049,24 +32237,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5977 +#: ../src/guestfs-actions.pod:6016 msgid "" "This command is the same as C<guestfs_ntfsresize> except that it allows you " "to specify the new size (in bytes) explicitly." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5982 ../src/guestfs-actions.pod:6441 ../src/guestfs-actions.pod:6514 ../src/guestfs-actions.pod:6782 ../src/guestfs-actions.pod:8533 +#: ../src/guestfs-actions.pod:6021 ../src/guestfs-actions.pod:6480 ../src/guestfs-actions.pod:6553 ../src/guestfs-actions.pod:6821 ../src/guestfs-actions.pod:8595 msgid "(Added in 1.3.14)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5984 +#: ../src/guestfs-actions.pod:6023 msgid "guestfs_part_add" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5986 +#: ../src/guestfs-actions.pod:6025 #, no-wrap msgid "" " int\n" @@ -32079,31 +32267,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5993 +#: ../src/guestfs-actions.pod:6032 msgid "" "This command adds a partition to C<device>. If there is no partition table " "on the device, call C<guestfs_part_init> first." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6005 +#: ../src/guestfs-actions.pod:6044 msgid "" "Creating a partition which covers the whole disk is not so easy. Use " "C<guestfs_part_disk> to do that." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6010 ../src/guestfs-actions.pod:6045 ../src/guestfs-actions.pod:6098 ../src/guestfs-actions.pod:6182 ../src/guestfs-actions.pod:6220 ../src/guestfs-actions.pod:6239 ../src/guestfs-actions.pod:6279 +#: ../src/guestfs-actions.pod:6049 ../src/guestfs-actions.pod:6084 ../src/guestfs-actions.pod:6137 ../src/guestfs-actions.pod:6221 ../src/guestfs-actions.pod:6259 ../src/guestfs-actions.pod:6278 ../src/guestfs-actions.pod:6318 msgid "(Added in 1.0.78)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6012 +#: ../src/guestfs-actions.pod:6051 msgid "guestfs_part_del" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6014 +#: ../src/guestfs-actions.pod:6053 #, no-wrap msgid "" " int\n" @@ -32114,12 +32302,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6029 +#: ../src/guestfs-actions.pod:6068 msgid "guestfs_part_disk" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6031 +#: ../src/guestfs-actions.pod:6070 #, no-wrap msgid "" " int\n" @@ -32130,7 +32318,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6036 +#: ../src/guestfs-actions.pod:6075 msgid "" "This command is simply a combination of C<guestfs_part_init> followed by " "C<guestfs_part_add> to create a single primary partition covering the whole " @@ -32138,19 +32326,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6040 +#: ../src/guestfs-actions.pod:6079 msgid "" "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other " "possible values are described in C<guestfs_part_init>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6047 +#: ../src/guestfs-actions.pod:6086 msgid "guestfs_part_get_bootable" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6049 +#: ../src/guestfs-actions.pod:6088 #, no-wrap msgid "" " int\n" @@ -32161,17 +32349,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6057 +#: ../src/guestfs-actions.pod:6096 msgid "See also C<guestfs_part_set_bootable>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6063 +#: ../src/guestfs-actions.pod:6102 msgid "guestfs_part_get_mbr_id" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6065 +#: ../src/guestfs-actions.pod:6104 #, no-wrap msgid "" " int\n" @@ -32182,7 +32370,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6073 ../src/guestfs-actions.pod:6255 +#: ../src/guestfs-actions.pod:6112 ../src/guestfs-actions.pod:6294 msgid "" "Note that only MBR (old DOS-style) partitions have type bytes. You will get " "undefined results for other partition table types (see " @@ -32190,12 +32378,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6081 +#: ../src/guestfs-actions.pod:6120 msgid "guestfs_part_get_parttype" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6083 +#: ../src/guestfs-actions.pod:6122 #, no-wrap msgid "" " char *\n" @@ -32205,7 +32393,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6090 +#: ../src/guestfs-actions.pod:6129 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 " @@ -32213,12 +32401,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6100 +#: ../src/guestfs-actions.pod:6139 msgid "guestfs_part_init" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6102 +#: ../src/guestfs-actions.pod:6141 #, no-wrap msgid "" " int\n" @@ -32229,19 +32417,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6111 +#: ../src/guestfs-actions.pod:6150 msgid "" "Initially there are no partitions. Following this, you should call " "C<guestfs_part_add> for each partition required." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6184 +#: ../src/guestfs-actions.pod:6223 msgid "guestfs_part_list" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6186 +#: ../src/guestfs-actions.pod:6225 #, no-wrap msgid "" " struct guestfs_partition_list *\n" @@ -32251,14 +32439,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6203 +#: ../src/guestfs-actions.pod:6242 msgid "" "Start of the partition I<in bytes>. To get sectors you have to divide by " "the device's sector size, see C<guestfs_blockdev_getss>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6216 +#: ../src/guestfs-actions.pod:6255 msgid "" "This function returns a C<struct guestfs_partition_list *>, or NULL if there " "was an error. I<The caller must call C<guestfs_free_partition_list> after " @@ -32266,12 +32454,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6222 +#: ../src/guestfs-actions.pod:6261 msgid "guestfs_part_set_bootable" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6224 +#: ../src/guestfs-actions.pod:6263 #, no-wrap msgid "" " int\n" @@ -32283,12 +32471,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6241 +#: ../src/guestfs-actions.pod:6280 msgid "guestfs_part_set_mbr_id" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6243 +#: ../src/guestfs-actions.pod:6282 #, no-wrap msgid "" " int\n" @@ -32300,12 +32488,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6263 +#: ../src/guestfs-actions.pod:6302 msgid "guestfs_part_set_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6265 +#: ../src/guestfs-actions.pod:6304 #, no-wrap msgid "" " int\n" @@ -32317,12 +32505,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6281 +#: ../src/guestfs-actions.pod:6320 msgid "guestfs_part_to_dev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6283 +#: ../src/guestfs-actions.pod:6322 #, no-wrap msgid "" " char *\n" @@ -32332,24 +32520,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6291 ../src/guestfs-actions.pod:6310 +#: ../src/guestfs-actions.pod:6330 ../src/guestfs-actions.pod:6349 msgid "" "The named partition must exist, for example as a string returned from " "C<guestfs_list_partitions>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6294 -msgid "See also C<guestfs_part_to_partnum>." +#: ../src/guestfs-actions.pod:6333 +msgid "See also C<guestfs_part_to_partnum>, C<guestfs_device_index>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6301 +#: ../src/guestfs-actions.pod:6340 msgid "guestfs_part_to_partnum" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6303 +#: ../src/guestfs-actions.pod:6342 #, no-wrap msgid "" " int\n" @@ -32359,17 +32547,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6313 +#: ../src/guestfs-actions.pod:6352 msgid "See also C<guestfs_part_to_dev>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6319 +#: ../src/guestfs-actions.pod:6358 msgid "guestfs_ping_daemon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6321 +#: ../src/guestfs-actions.pod:6360 #, no-wrap msgid "" " int\n" @@ -32378,12 +32566,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6333 +#: ../src/guestfs-actions.pod:6372 msgid "guestfs_pread" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6335 +#: ../src/guestfs-actions.pod:6374 #, no-wrap msgid "" " char *\n" @@ -32396,17 +32584,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6348 +#: ../src/guestfs-actions.pod:6387 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6359 +#: ../src/guestfs-actions.pod:6398 msgid "guestfs_pread_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6361 +#: ../src/guestfs-actions.pod:6400 #, no-wrap msgid "" " char *\n" @@ -32419,22 +32607,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6374 +#: ../src/guestfs-actions.pod:6413 msgid "See also C<guestfs_pread>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6383 +#: ../src/guestfs-actions.pod:6422 msgid "(Added in 1.5.21)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6385 +#: ../src/guestfs-actions.pod:6424 msgid "guestfs_pvcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6387 +#: ../src/guestfs-actions.pod:6426 #, no-wrap msgid "" " int\n" @@ -32444,12 +32632,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6399 +#: ../src/guestfs-actions.pod:6438 msgid "guestfs_pvremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6401 +#: ../src/guestfs-actions.pod:6440 #, no-wrap msgid "" " int\n" @@ -32459,12 +32647,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6416 +#: ../src/guestfs-actions.pod:6455 msgid "guestfs_pvresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6418 +#: ../src/guestfs-actions.pod:6457 #, no-wrap msgid "" " int\n" @@ -32474,12 +32662,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6429 +#: ../src/guestfs-actions.pod:6468 msgid "guestfs_pvresize_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6431 +#: ../src/guestfs-actions.pod:6470 #, no-wrap msgid "" " int\n" @@ -32490,19 +32678,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6436 +#: ../src/guestfs-actions.pod:6475 msgid "" "This command is the same as C<guestfs_pvresize> except that it allows you to " "specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6443 +#: ../src/guestfs-actions.pod:6482 msgid "guestfs_pvs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6445 +#: ../src/guestfs-actions.pod:6484 #, no-wrap msgid "" " char **\n" @@ -32511,17 +32699,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6454 +#: ../src/guestfs-actions.pod:6493 msgid "See also C<guestfs_pvs_full>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6462 +#: ../src/guestfs-actions.pod:6501 msgid "guestfs_pvs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6464 +#: ../src/guestfs-actions.pod:6503 #, no-wrap msgid "" " struct guestfs_lvm_pv_list *\n" @@ -32530,7 +32718,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6470 +#: ../src/guestfs-actions.pod:6509 msgid "" "This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there " "was an error. I<The caller must call C<guestfs_free_lvm_pv_list> after " @@ -32538,12 +32726,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6476 +#: ../src/guestfs-actions.pod:6515 msgid "guestfs_pvuuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6478 +#: ../src/guestfs-actions.pod:6517 #, no-wrap msgid "" " char *\n" @@ -32553,12 +32741,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6489 +#: ../src/guestfs-actions.pod:6528 msgid "guestfs_pwrite" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6491 +#: ../src/guestfs-actions.pod:6530 #, no-wrap msgid "" " int\n" @@ -32571,17 +32759,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6507 +#: ../src/guestfs-actions.pod:6546 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6516 +#: ../src/guestfs-actions.pod:6555 msgid "guestfs_pwrite_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6518 +#: ../src/guestfs-actions.pod:6557 #, no-wrap msgid "" " int\n" @@ -32594,22 +32782,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6533 +#: ../src/guestfs-actions.pod:6572 msgid "See also C<guestfs_pwrite>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6540 +#: ../src/guestfs-actions.pod:6579 msgid "(Added in 1.5.20)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6542 +#: ../src/guestfs-actions.pod:6581 msgid "guestfs_read_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6544 +#: ../src/guestfs-actions.pod:6583 #, no-wrap msgid "" " char *\n" @@ -32620,7 +32808,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6552 +#: ../src/guestfs-actions.pod:6591 msgid "" "Unlike C<guestfs_cat>, this function can correctly handle files that contain " "embedded ASCII NUL characters. However unlike C<guestfs_download>, this " @@ -32628,17 +32816,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6564 +#: ../src/guestfs-actions.pod:6603 msgid "(Added in 1.0.63)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6566 +#: ../src/guestfs-actions.pod:6605 msgid "guestfs_read_lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6568 +#: ../src/guestfs-actions.pod:6607 #, no-wrap msgid "" " char **\n" @@ -32648,7 +32836,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6577 +#: ../src/guestfs-actions.pod:6616 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of line). For " @@ -32657,12 +32845,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6588 +#: ../src/guestfs-actions.pod:6627 msgid "guestfs_readdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6590 +#: ../src/guestfs-actions.pod:6629 #, no-wrap msgid "" " struct guestfs_dirent_list *\n" @@ -32672,7 +32860,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6644 +#: ../src/guestfs-actions.pod:6683 msgid "" "This function is primarily intended for use by programs. To get a simple " "list of names, use C<guestfs_ls>. To get a printable directory for human " @@ -32680,7 +32868,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6648 +#: ../src/guestfs-actions.pod:6687 msgid "" "This function returns a C<struct guestfs_dirent_list *>, or NULL if there " "was an error. I<The caller must call C<guestfs_free_dirent_list> after " @@ -32688,12 +32876,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6654 +#: ../src/guestfs-actions.pod:6693 msgid "guestfs_readlink" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6656 +#: ../src/guestfs-actions.pod:6695 #, no-wrap msgid "" " char *\n" @@ -32703,12 +32891,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6667 +#: ../src/guestfs-actions.pod:6706 msgid "guestfs_readlinklist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6669 +#: ../src/guestfs-actions.pod:6708 #, no-wrap msgid "" " char **\n" @@ -32719,12 +32907,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6702 +#: ../src/guestfs-actions.pod:6741 msgid "guestfs_realpath" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6704 +#: ../src/guestfs-actions.pod:6743 #, no-wrap msgid "" " char *\n" @@ -32734,12 +32922,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6716 +#: ../src/guestfs-actions.pod:6755 msgid "guestfs_removexattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6718 +#: ../src/guestfs-actions.pod:6757 #, no-wrap msgid "" " int\n" @@ -32750,17 +32938,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6726 +#: ../src/guestfs-actions.pod:6765 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6732 +#: ../src/guestfs-actions.pod:6771 msgid "guestfs_resize2fs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6734 +#: ../src/guestfs-actions.pod:6773 #, no-wrap msgid "" " int\n" @@ -32770,7 +32958,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6741 +#: ../src/guestfs-actions.pod:6780 msgid "" "I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the " "C<device> before calling this command. For unknown reasons C<resize2fs> " @@ -32779,12 +32967,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6751 +#: ../src/guestfs-actions.pod:6790 msgid "guestfs_resize2fs_M" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6753 +#: ../src/guestfs-actions.pod:6792 #, no-wrap msgid "" " int\n" @@ -32794,7 +32982,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6757 +#: ../src/guestfs-actions.pod:6796 msgid "" "This command is the same as C<guestfs_resize2fs>, but the filesystem is " "resized to its minimum size. This works like the I<-M> option to the " @@ -32802,7 +32990,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6761 +#: ../src/guestfs-actions.pod:6800 msgid "" "To get the resulting size of the filesystem you should call " "C<guestfs_tune2fs_l> and read the C<Block size> and C<Block count> values. " @@ -32811,12 +32999,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6770 +#: ../src/guestfs-actions.pod:6809 msgid "guestfs_resize2fs_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6772 +#: ../src/guestfs-actions.pod:6811 #, no-wrap msgid "" " int\n" @@ -32827,19 +33015,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6777 +#: ../src/guestfs-actions.pod:6816 msgid "" "This command is the same as C<guestfs_resize2fs> except that it allows you " "to specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6784 +#: ../src/guestfs-actions.pod:6823 msgid "guestfs_rm" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6786 +#: ../src/guestfs-actions.pod:6825 #, no-wrap msgid "" " int\n" @@ -32849,12 +33037,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6796 +#: ../src/guestfs-actions.pod:6835 msgid "guestfs_rm_rf" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6798 +#: ../src/guestfs-actions.pod:6837 #, no-wrap msgid "" " int\n" @@ -32864,12 +33052,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6810 +#: ../src/guestfs-actions.pod:6849 msgid "guestfs_rmdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6812 +#: ../src/guestfs-actions.pod:6851 #, no-wrap msgid "" " int\n" @@ -32879,12 +33067,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6822 +#: ../src/guestfs-actions.pod:6861 msgid "guestfs_rmmountpoint" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6824 +#: ../src/guestfs-actions.pod:6863 #, no-wrap msgid "" " int\n" @@ -32894,19 +33082,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6828 +#: ../src/guestfs-actions.pod:6867 msgid "" "This calls removes a mountpoint that was previously created with " "C<guestfs_mkmountpoint>. See C<guestfs_mkmountpoint> for full details." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6836 +#: ../src/guestfs-actions.pod:6875 msgid "guestfs_scrub_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6838 +#: ../src/guestfs-actions.pod:6877 #, no-wrap msgid "" " int\n" @@ -32916,17 +33104,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6850 ../src/guestfs-actions.pod:6868 ../src/guestfs-actions.pod:6887 +#: ../src/guestfs-actions.pod:6889 ../src/guestfs-actions.pod:6907 ../src/guestfs-actions.pod:6926 msgid "(Added in 1.0.52)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6852 +#: ../src/guestfs-actions.pod:6891 msgid "guestfs_scrub_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6854 +#: ../src/guestfs-actions.pod:6893 #, no-wrap msgid "" " int\n" @@ -32936,12 +33124,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6870 +#: ../src/guestfs-actions.pod:6909 msgid "guestfs_scrub_freespace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6872 +#: ../src/guestfs-actions.pod:6911 #, no-wrap msgid "" " int\n" @@ -32951,7 +33139,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6876 +#: ../src/guestfs-actions.pod:6915 msgid "" "This command creates the directory C<dir> and then fills it with files until " "the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, " @@ -32960,12 +33148,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6889 +#: ../src/guestfs-actions.pod:6928 msgid "guestfs_set_append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6891 +#: ../src/guestfs-actions.pod:6930 #, no-wrap msgid "" " int\n" @@ -32975,12 +33163,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6908 +#: ../src/guestfs-actions.pod:6947 msgid "guestfs_set_attach_method" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6910 +#: ../src/guestfs-actions.pod:6949 #, no-wrap msgid "" " int\n" @@ -32990,12 +33178,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6938 +#: ../src/guestfs-actions.pod:6977 msgid "guestfs_set_autosync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6940 +#: ../src/guestfs-actions.pod:6979 #, no-wrap msgid "" " int\n" @@ -33005,12 +33193,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6956 +#: ../src/guestfs-actions.pod:6995 msgid "guestfs_set_direct" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6958 +#: ../src/guestfs-actions.pod:6997 #, no-wrap msgid "" " int\n" @@ -33020,7 +33208,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6966 +#: ../src/guestfs-actions.pod:7005 msgid "" "One consequence of this is that log messages aren't caught by the library " "and handled by C<guestfs_set_log_message_callback>, but go straight to " @@ -33028,12 +33216,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6979 +#: ../src/guestfs-actions.pod:7018 msgid "guestfs_set_e2label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6981 +#: ../src/guestfs-actions.pod:7020 #, no-wrap msgid "" " int\n" @@ -33044,19 +33232,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6990 +#: ../src/guestfs-actions.pod:7029 msgid "" "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return " "the existing label on a filesystem." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6997 +#: ../src/guestfs-actions.pod:7036 msgid "guestfs_set_e2uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6999 +#: ../src/guestfs-actions.pod:7038 #, no-wrap msgid "" " int\n" @@ -33067,19 +33255,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7009 +#: ../src/guestfs-actions.pod:7048 msgid "" "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return " "the existing UUID of a filesystem." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7016 +#: ../src/guestfs-actions.pod:7055 msgid "guestfs_set_memsize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7018 +#: ../src/guestfs-actions.pod:7057 #, no-wrap msgid "" " int\n" @@ -33089,19 +33277,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7022 +#: ../src/guestfs-actions.pod:7061 msgid "" "This sets the memory size in megabytes allocated to the qemu subprocess. " "This only has any effect if called before C<guestfs_launch>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7037 +#: ../src/guestfs-actions.pod:7076 msgid "guestfs_set_network" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7039 +#: ../src/guestfs-actions.pod:7078 #, no-wrap msgid "" " int\n" @@ -33111,19 +33299,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7049 +#: ../src/guestfs-actions.pod:7088 msgid "" "You must call this before calling C<guestfs_launch>, otherwise it has no " "effect." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7056 +#: ../src/guestfs-actions.pod:7095 msgid "guestfs_set_path" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7058 +#: ../src/guestfs-actions.pod:7097 #, no-wrap msgid "" " int\n" @@ -33133,12 +33321,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7073 +#: ../src/guestfs-actions.pod:7112 msgid "guestfs_set_pgroup" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7075 +#: ../src/guestfs-actions.pod:7114 #, no-wrap msgid "" " int\n" @@ -33148,7 +33336,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7085 +#: ../src/guestfs-actions.pod:7124 msgid "" "The default for this flag is false, because usually you want C<^C> to kill " "the subprocess. Guestfish sets this flag to true when used interactively, " @@ -33157,12 +33345,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7094 +#: ../src/guestfs-actions.pod:7133 msgid "guestfs_set_qemu" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7096 +#: ../src/guestfs-actions.pod:7135 #, no-wrap msgid "" " int\n" @@ -33172,12 +33360,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7122 +#: ../src/guestfs-actions.pod:7161 msgid "guestfs_set_recovery_proc" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7124 +#: ../src/guestfs-actions.pod:7163 #, no-wrap msgid "" " int\n" @@ -33187,7 +33375,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7128 +#: ../src/guestfs-actions.pod:7167 msgid "" "If this is called with the parameter C<false> then C<guestfs_launch> does " "not create a recovery process. The purpose of the recovery process is to " @@ -33196,19 +33384,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7133 +#: ../src/guestfs-actions.pod:7172 msgid "" "This only has any effect if called before C<guestfs_launch>, and the default " "is true." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7146 +#: ../src/guestfs-actions.pod:7185 msgid "guestfs_set_selinux" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7148 +#: ../src/guestfs-actions.pod:7187 #, no-wrap msgid "" " int\n" @@ -33218,12 +33406,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7165 +#: ../src/guestfs-actions.pod:7204 msgid "guestfs_set_smp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7167 +#: ../src/guestfs-actions.pod:7206 #, no-wrap msgid "" " int\n" @@ -33233,17 +33421,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7175 +#: ../src/guestfs-actions.pod:7214 msgid "This function must be called before C<guestfs_launch>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7181 +#: ../src/guestfs-actions.pod:7220 msgid "guestfs_set_trace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7183 +#: ../src/guestfs-actions.pod:7222 #, no-wrap msgid "" " int\n" @@ -33253,19 +33441,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7197 +#: ../src/guestfs-actions.pod:7236 msgid "" "Trace messages are normally sent to C<stderr>, unless you register a " "callback to send them somewhere else (see C<guestfs_set_event_callback>)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7205 +#: ../src/guestfs-actions.pod:7244 msgid "guestfs_set_verbose" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7207 +#: ../src/guestfs-actions.pod:7246 #, no-wrap msgid "" " int\n" @@ -33275,19 +33463,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7216 +#: ../src/guestfs-actions.pod:7255 msgid "" "Verbose messages are normally sent to C<stderr>, unless you register a " "callback to send them somewhere else (see C<guestfs_set_event_callback>)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7224 +#: ../src/guestfs-actions.pod:7263 msgid "guestfs_setcon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7226 +#: ../src/guestfs-actions.pod:7265 #, no-wrap msgid "" " int\n" @@ -33297,12 +33485,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7239 +#: ../src/guestfs-actions.pod:7278 msgid "guestfs_setxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7241 +#: ../src/guestfs-actions.pod:7280 #, no-wrap msgid "" " int\n" @@ -33315,17 +33503,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7252 +#: ../src/guestfs-actions.pod:7291 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7258 +#: ../src/guestfs-actions.pod:7297 msgid "guestfs_sfdisk" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7260 +#: ../src/guestfs-actions.pod:7299 #, no-wrap msgid "" " int\n" @@ -33339,24 +33527,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7268 ../src/guestfs-actions.pod:7309 ../src/guestfs-actions.pod:7340 +#: ../src/guestfs-actions.pod:7307 ../src/guestfs-actions.pod:7348 ../src/guestfs-actions.pod:7379 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_part_add> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7295 +#: ../src/guestfs-actions.pod:7334 msgid "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7302 +#: ../src/guestfs-actions.pod:7341 msgid "guestfs_sfdiskM" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7304 +#: ../src/guestfs-actions.pod:7343 #, no-wrap msgid "" " int\n" @@ -33367,7 +33555,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7316 +#: ../src/guestfs-actions.pod:7355 msgid "" "This is a simplified interface to the C<guestfs_sfdisk> command, where " "partition sizes are specified in megabytes only (rounded to the nearest " @@ -33376,19 +33564,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7322 +#: ../src/guestfs-actions.pod:7361 msgid "" "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and " "C<guestfs_part_disk>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7329 +#: ../src/guestfs-actions.pod:7368 msgid "guestfs_sfdisk_N" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7331 +#: ../src/guestfs-actions.pod:7370 #, no-wrap msgid "" " int\n" @@ -33403,24 +33591,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7350 +#: ../src/guestfs-actions.pod:7389 msgid "" "For other parameters, see C<guestfs_sfdisk>. You should usually pass C<0> " "for the cyls/heads/sectors parameters." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7353 +#: ../src/guestfs-actions.pod:7392 msgid "See also: C<guestfs_part_add>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7359 +#: ../src/guestfs-actions.pod:7398 msgid "guestfs_sfdisk_disk_geometry" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7361 +#: ../src/guestfs-actions.pod:7400 #, no-wrap msgid "" " char *\n" @@ -33430,7 +33618,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7365 +#: ../src/guestfs-actions.pod:7404 msgid "" "This displays the disk geometry of C<device> read from the partition table. " "Especially in the case where the underlying block device has been resized, " @@ -33439,12 +33627,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7378 +#: ../src/guestfs-actions.pod:7417 msgid "guestfs_sfdisk_kernel_geometry" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7380 +#: ../src/guestfs-actions.pod:7419 #, no-wrap msgid "" " char *\n" @@ -33454,12 +33642,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7394 +#: ../src/guestfs-actions.pod:7433 msgid "guestfs_sfdisk_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7396 +#: ../src/guestfs-actions.pod:7435 #, no-wrap msgid "" " char *\n" @@ -33469,24 +33657,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7400 +#: ../src/guestfs-actions.pod:7439 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_part_list> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7411 +#: ../src/guestfs-actions.pod:7450 msgid "See also: C<guestfs_part_list>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7418 +#: ../src/guestfs-actions.pod:7457 msgid "guestfs_sh" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7420 +#: ../src/guestfs-actions.pod:7459 #, no-wrap msgid "" " char *\n" @@ -33496,22 +33684,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7427 +#: ../src/guestfs-actions.pod:7466 msgid "This is like C<guestfs_command>, but passes the command to:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7435 +#: ../src/guestfs-actions.pod:7474 msgid "All the provisos about C<guestfs_command> apply to this call." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7442 +#: ../src/guestfs-actions.pod:7481 msgid "guestfs_sh_lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7444 +#: ../src/guestfs-actions.pod:7483 #, no-wrap msgid "" " char **\n" @@ -33521,24 +33709,60 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7448 +#: ../src/guestfs-actions.pod:7487 msgid "" "This is the same as C<guestfs_sh>, but splits the result into a list of " "lines." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7451 +#: ../src/guestfs-actions.pod:7490 msgid "See also: C<guestfs_command_lines>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7459 +#: ../src/guestfs-actions.pod:7498 +msgid "guestfs_shutdown" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:7500 +#, no-wrap +msgid "" +" int\n" +" guestfs_shutdown (guestfs_h *g);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:7503 +msgid "" +"This is the opposite of C<guestfs_launch>. It performs an orderly shutdown " +"of the backend process(es). If the autosync flag is set (which is the " +"default) then the disk image is synchronized." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:7513 +msgid "" +"This call does I<not> close or free up the handle. You still need to call " +"C<guestfs_close> afterwards." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:7516 +msgid "" +"C<guestfs_close> will call this if you don't do it explicitly, but note that " +"any errors are ignored in that case." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:7521 msgid "guestfs_sleep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7461 +#: ../src/guestfs-actions.pod:7523 #, no-wrap msgid "" " int\n" @@ -33548,17 +33772,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7469 +#: ../src/guestfs-actions.pod:7531 msgid "(Added in 1.0.41)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7471 ../src/guestfs-structs.pod:109 +#: ../src/guestfs-actions.pod:7533 ../src/guestfs-structs.pod:109 msgid "guestfs_stat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7473 +#: ../src/guestfs-actions.pod:7535 #, no-wrap msgid "" " struct guestfs_stat *\n" @@ -33568,12 +33792,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7487 ../src/guestfs-structs.pod:135 +#: ../src/guestfs-actions.pod:7549 ../src/guestfs-structs.pod:135 msgid "guestfs_statvfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7489 +#: ../src/guestfs-actions.pod:7551 #, no-wrap msgid "" " struct guestfs_statvfs *\n" @@ -33583,19 +33807,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7499 +#: ../src/guestfs-actions.pod:7561 msgid "" "This function returns a C<struct guestfs_statvfs *>, or NULL if there was an " "error. I<The caller must call C<guestfs_free_statvfs> after use>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7505 +#: ../src/guestfs-actions.pod:7567 msgid "guestfs_strings" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7507 +#: ../src/guestfs-actions.pod:7569 #, no-wrap msgid "" " char **\n" @@ -33605,12 +33829,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7523 +#: ../src/guestfs-actions.pod:7585 msgid "guestfs_strings_e" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7525 +#: ../src/guestfs-actions.pod:7587 #, no-wrap msgid "" " char **\n" @@ -33621,26 +33845,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7530 +#: ../src/guestfs-actions.pod:7592 msgid "" "This is like the C<guestfs_strings> command, but allows you to specify the " "encoding of strings that are looked for in the source file C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7540 +#: ../src/guestfs-actions.pod:7602 msgid "" "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of " "ISO-8859-X (this is what C<guestfs_strings> uses)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7578 +#: ../src/guestfs-actions.pod:7640 msgid "guestfs_swapoff_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7580 +#: ../src/guestfs-actions.pod:7642 #, no-wrap msgid "" " int\n" @@ -33650,19 +33874,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7584 +#: ../src/guestfs-actions.pod:7646 msgid "" "This command disables the libguestfs appliance swap device or partition " "named C<device>. See C<guestfs_swapon_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7592 +#: ../src/guestfs-actions.pod:7654 msgid "guestfs_swapoff_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7594 +#: ../src/guestfs-actions.pod:7656 #, no-wrap msgid "" " int\n" @@ -33672,12 +33896,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7604 +#: ../src/guestfs-actions.pod:7666 msgid "guestfs_swapoff_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7606 +#: ../src/guestfs-actions.pod:7668 #, no-wrap msgid "" " int\n" @@ -33687,12 +33911,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7617 +#: ../src/guestfs-actions.pod:7679 msgid "guestfs_swapoff_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7619 +#: ../src/guestfs-actions.pod:7681 #, no-wrap msgid "" " int\n" @@ -33702,12 +33926,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7630 +#: ../src/guestfs-actions.pod:7692 msgid "guestfs_swapon_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7632 +#: ../src/guestfs-actions.pod:7694 #, no-wrap msgid "" " int\n" @@ -33717,7 +33941,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7636 +#: ../src/guestfs-actions.pod:7698 msgid "" "This command enables the libguestfs appliance to use the swap device or " "partition named C<device>. The increased memory is made available for all " @@ -33725,12 +33949,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7652 +#: ../src/guestfs-actions.pod:7714 msgid "guestfs_swapon_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7654 +#: ../src/guestfs-actions.pod:7716 #, no-wrap msgid "" " int\n" @@ -33740,19 +33964,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7658 +#: ../src/guestfs-actions.pod:7720 msgid "" "This command enables swap to a file. See C<guestfs_swapon_device> for other " "notes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7665 +#: ../src/guestfs-actions.pod:7727 msgid "guestfs_swapon_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7667 +#: ../src/guestfs-actions.pod:7729 #, no-wrap msgid "" " int\n" @@ -33762,19 +33986,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7671 +#: ../src/guestfs-actions.pod:7733 msgid "" "This command enables swap to a labeled swap partition. See " "C<guestfs_swapon_device> for other notes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7678 +#: ../src/guestfs-actions.pod:7740 msgid "guestfs_swapon_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7680 +#: ../src/guestfs-actions.pod:7742 #, no-wrap msgid "" " int\n" @@ -33784,19 +34008,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7684 +#: ../src/guestfs-actions.pod:7746 msgid "" "This command enables swap to a swap partition with the given UUID. See " "C<guestfs_swapon_device> for other notes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7691 +#: ../src/guestfs-actions.pod:7753 msgid "guestfs_sync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7693 +#: ../src/guestfs-actions.pod:7755 #, no-wrap msgid "" " int\n" @@ -33805,12 +34029,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7706 +#: ../src/guestfs-actions.pod:7768 msgid "guestfs_tail" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7708 +#: ../src/guestfs-actions.pod:7770 #, no-wrap msgid "" " char **\n" @@ -33820,12 +34044,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7724 +#: ../src/guestfs-actions.pod:7786 msgid "guestfs_tail_n" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7726 +#: ../src/guestfs-actions.pod:7788 #, no-wrap msgid "" " char **\n" @@ -33836,12 +34060,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7748 +#: ../src/guestfs-actions.pod:7810 msgid "guestfs_tar_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7750 +#: ../src/guestfs-actions.pod:7812 #, no-wrap msgid "" " int\n" @@ -33852,22 +34076,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7758 +#: ../src/guestfs-actions.pod:7820 msgid "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7763 ../src/guestfs-actions.pod:7780 ../src/guestfs-actions.pod:7796 ../src/guestfs-actions.pod:7812 +#: ../src/guestfs-actions.pod:7825 ../src/guestfs-actions.pod:7842 ../src/guestfs-actions.pod:7858 ../src/guestfs-actions.pod:7874 msgid "(Added in 1.0.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7765 +#: ../src/guestfs-actions.pod:7827 msgid "guestfs_tar_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7767 +#: ../src/guestfs-actions.pod:7829 #, no-wrap msgid "" " int\n" @@ -33878,19 +34102,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7775 +#: ../src/guestfs-actions.pod:7837 msgid "" "To download a compressed tarball, use C<guestfs_tgz_out> or " "C<guestfs_txz_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7782 +#: ../src/guestfs-actions.pod:7844 msgid "guestfs_tgz_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7784 +#: ../src/guestfs-actions.pod:7846 #, no-wrap msgid "" " int\n" @@ -33901,17 +34125,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7792 +#: ../src/guestfs-actions.pod:7854 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7798 +#: ../src/guestfs-actions.pod:7860 msgid "guestfs_tgz_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7800 +#: ../src/guestfs-actions.pod:7862 #, no-wrap msgid "" " int\n" @@ -33922,17 +34146,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7808 +#: ../src/guestfs-actions.pod:7870 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7814 +#: ../src/guestfs-actions.pod:7876 msgid "guestfs_touch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7816 +#: ../src/guestfs-actions.pod:7878 #, no-wrap msgid "" " int\n" @@ -33942,12 +34166,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7831 +#: ../src/guestfs-actions.pod:7893 msgid "guestfs_truncate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7833 +#: ../src/guestfs-actions.pod:7895 #, no-wrap msgid "" " int\n" @@ -33957,12 +34181,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7844 +#: ../src/guestfs-actions.pod:7906 msgid "guestfs_truncate_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7846 +#: ../src/guestfs-actions.pod:7908 #, no-wrap msgid "" " int\n" @@ -33973,7 +34197,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7854 +#: ../src/guestfs-actions.pod:7916 msgid "" "If the current file size is less than C<size> then the file is extended to " "the required size with zero bytes. This creates a sparse file (ie. disk " @@ -33982,12 +34206,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7864 +#: ../src/guestfs-actions.pod:7926 msgid "guestfs_tune2fs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7866 +#: ../src/guestfs-actions.pod:7928 #, no-wrap msgid "" " int\n" @@ -33998,7 +34222,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7876 +#: ../src/guestfs-actions.pod:7938 #, no-wrap msgid "" " GUESTFS_TUNE2FS_FORCE, int force,\n" @@ -34015,7 +34239,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7956 +#: ../src/guestfs-actions.pod:8018 msgid "" "To get the current values of filesystem parameters, see " "C<guestfs_tune2fs_l>. For precise details of how tune2fs works, see the " @@ -34023,12 +34247,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7964 +#: ../src/guestfs-actions.pod:8026 msgid "guestfs_tune2fs_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7966 +#: ../src/guestfs-actions.pod:8028 #, no-wrap msgid "" " int\n" @@ -34039,17 +34263,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7971 +#: ../src/guestfs-actions.pod:8033 msgid "This is the \"va_list variant\" of L</guestfs_tune2fs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7975 +#: ../src/guestfs-actions.pod:8037 msgid "guestfs_tune2fs_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7977 +#: ../src/guestfs-actions.pod:8039 #, no-wrap msgid "" " int\n" @@ -34060,17 +34284,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7982 +#: ../src/guestfs-actions.pod:8044 msgid "This is the \"argv variant\" of L</guestfs_tune2fs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7986 +#: ../src/guestfs-actions.pod:8048 msgid "guestfs_tune2fs_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7988 +#: ../src/guestfs-actions.pod:8050 #, no-wrap msgid "" " char **\n" @@ -34080,12 +34304,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8008 +#: ../src/guestfs-actions.pod:8070 msgid "guestfs_txz_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8010 +#: ../src/guestfs-actions.pod:8072 #, no-wrap msgid "" " int\n" @@ -34096,12 +34320,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8022 +#: ../src/guestfs-actions.pod:8084 msgid "guestfs_txz_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8024 +#: ../src/guestfs-actions.pod:8086 #, no-wrap msgid "" " int\n" @@ -34112,12 +34336,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8036 +#: ../src/guestfs-actions.pod:8098 msgid "guestfs_umask" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8038 +#: ../src/guestfs-actions.pod:8100 #, no-wrap msgid "" " int\n" @@ -34127,19 +34351,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8054 +#: ../src/guestfs-actions.pod:8116 msgid "" "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, " "C<guestfs_mkdir>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8063 +#: ../src/guestfs-actions.pod:8125 msgid "guestfs_umount" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8065 +#: ../src/guestfs-actions.pod:8127 #, no-wrap msgid "" " int\n" @@ -34149,12 +34373,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8077 +#: ../src/guestfs-actions.pod:8139 msgid "guestfs_umount_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8079 +#: ../src/guestfs-actions.pod:8141 #, no-wrap msgid "" " int\n" @@ -34163,12 +34387,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8090 +#: ../src/guestfs-actions.pod:8152 msgid "guestfs_upload" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8092 +#: ../src/guestfs-actions.pod:8154 #, no-wrap msgid "" " int\n" @@ -34179,17 +34403,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8102 +#: ../src/guestfs-actions.pod:8164 msgid "See also C<guestfs_download>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8113 +#: ../src/guestfs-actions.pod:8175 msgid "guestfs_upload_offset" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8115 +#: ../src/guestfs-actions.pod:8177 #, no-wrap msgid "" " int\n" @@ -34201,7 +34425,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8131 +#: ../src/guestfs-actions.pod:8193 msgid "" "Note that there is no limit on the amount of data that can be uploaded with " "this call, unlike with C<guestfs_pwrite>, and this call always writes the " @@ -34209,17 +34433,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8136 +#: ../src/guestfs-actions.pod:8198 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8147 +#: ../src/guestfs-actions.pod:8209 msgid "guestfs_utimens" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8149 +#: ../src/guestfs-actions.pod:8211 #, no-wrap msgid "" " int\n" @@ -34233,12 +34457,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8178 ../src/guestfs-structs.pod:175 +#: ../src/guestfs-actions.pod:8240 ../src/guestfs-structs.pod:175 msgid "guestfs_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8180 +#: ../src/guestfs-actions.pod:8242 #, no-wrap msgid "" " struct guestfs_version *\n" @@ -34247,7 +34471,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8208 +#: ../src/guestfs-actions.pod:8270 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " @@ -34256,24 +34480,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8214 +#: ../src/guestfs-actions.pod:8276 msgid "" "This function returns a C<struct guestfs_version *>, or NULL if there was an " "error. I<The caller must call C<guestfs_free_version> after use>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8218 +#: ../src/guestfs-actions.pod:8280 msgid "(Added in 1.0.58)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8220 +#: ../src/guestfs-actions.pod:8282 msgid "guestfs_vfs_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8222 +#: ../src/guestfs-actions.pod:8284 #, no-wrap msgid "" " char *\n" @@ -34283,22 +34507,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8231 +#: ../src/guestfs-actions.pod:8293 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8236 ../src/guestfs-actions.pod:8273 +#: ../src/guestfs-actions.pod:8298 ../src/guestfs-actions.pod:8335 msgid "(Added in 1.3.18)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8238 +#: ../src/guestfs-actions.pod:8300 msgid "guestfs_vfs_type" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8240 +#: ../src/guestfs-actions.pod:8302 #, no-wrap msgid "" " char *\n" @@ -34308,12 +34532,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8257 +#: ../src/guestfs-actions.pod:8319 msgid "guestfs_vfs_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8259 +#: ../src/guestfs-actions.pod:8321 #, no-wrap msgid "" " char *\n" @@ -34323,17 +34547,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8268 +#: ../src/guestfs-actions.pod:8330 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8275 +#: ../src/guestfs-actions.pod:8337 msgid "guestfs_vg_activate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8277 +#: ../src/guestfs-actions.pod:8339 #, no-wrap msgid "" " int\n" @@ -34344,12 +34568,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8294 +#: ../src/guestfs-actions.pod:8356 msgid "guestfs_vg_activate_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8296 +#: ../src/guestfs-actions.pod:8358 #, no-wrap msgid "" " int\n" @@ -34359,12 +34583,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8309 +#: ../src/guestfs-actions.pod:8371 msgid "guestfs_vgcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8311 +#: ../src/guestfs-actions.pod:8373 #, no-wrap msgid "" " int\n" @@ -34375,12 +34599,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8323 +#: ../src/guestfs-actions.pod:8385 msgid "guestfs_vglvuuids" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8325 +#: ../src/guestfs-actions.pod:8387 #, no-wrap msgid "" " char **\n" @@ -34390,24 +34614,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8332 +#: ../src/guestfs-actions.pod:8394 msgid "" "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to " "associate logical volumes and volume groups." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8335 +#: ../src/guestfs-actions.pod:8397 msgid "See also C<guestfs_vgpvuuids>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8343 +#: ../src/guestfs-actions.pod:8405 msgid "guestfs_vgpvuuids" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8345 +#: ../src/guestfs-actions.pod:8407 #, no-wrap msgid "" " char **\n" @@ -34417,24 +34641,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8352 +#: ../src/guestfs-actions.pod:8414 msgid "" "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to " "associate physical volumes and volume groups." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8355 +#: ../src/guestfs-actions.pod:8417 msgid "See also C<guestfs_vglvuuids>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8363 +#: ../src/guestfs-actions.pod:8425 msgid "guestfs_vgremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8365 +#: ../src/guestfs-actions.pod:8427 #, no-wrap msgid "" " int\n" @@ -34444,12 +34668,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8378 +#: ../src/guestfs-actions.pod:8440 msgid "guestfs_vgrename" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8380 +#: ../src/guestfs-actions.pod:8442 #, no-wrap msgid "" " int\n" @@ -34460,12 +34684,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8391 +#: ../src/guestfs-actions.pod:8453 msgid "guestfs_vgs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8393 +#: ../src/guestfs-actions.pod:8455 #, no-wrap msgid "" " char **\n" @@ -34474,17 +34698,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8402 +#: ../src/guestfs-actions.pod:8464 msgid "See also C<guestfs_vgs_full>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8410 +#: ../src/guestfs-actions.pod:8472 msgid "guestfs_vgs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8412 +#: ../src/guestfs-actions.pod:8474 #, no-wrap msgid "" " struct guestfs_lvm_vg_list *\n" @@ -34493,7 +34717,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8418 +#: ../src/guestfs-actions.pod:8480 msgid "" "This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there " "was an error. I<The caller must call C<guestfs_free_lvm_vg_list> after " @@ -34501,12 +34725,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8424 +#: ../src/guestfs-actions.pod:8486 msgid "guestfs_vgscan" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8426 +#: ../src/guestfs-actions.pod:8488 #, no-wrap msgid "" " int\n" @@ -34515,12 +34739,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8436 +#: ../src/guestfs-actions.pod:8498 msgid "guestfs_vguuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8438 +#: ../src/guestfs-actions.pod:8500 #, no-wrap msgid "" " char *\n" @@ -34530,12 +34754,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8449 +#: ../src/guestfs-actions.pod:8511 msgid "guestfs_wait_ready" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8451 +#: ../src/guestfs-actions.pod:8513 #, no-wrap msgid "" " int\n" @@ -34544,19 +34768,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8454 +#: ../src/guestfs-actions.pod:8516 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_launch> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8461 +#: ../src/guestfs-actions.pod:8523 msgid "This function is a no op." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8463 +#: ../src/guestfs-actions.pod:8525 msgid "" "In versions of the API E<lt> 1.0.71 you had to call this function just after " "calling C<guestfs_launch> to wait for the launch to complete. However this " @@ -34564,19 +34788,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8468 +#: ../src/guestfs-actions.pod:8530 msgid "" "If you see any calls to this function in code then you can just remove them, " "unless you want to retain compatibility with older versions of the API." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8476 +#: ../src/guestfs-actions.pod:8538 msgid "guestfs_wc_c" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8478 +#: ../src/guestfs-actions.pod:8540 #, no-wrap msgid "" " int\n" @@ -34586,12 +34810,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8489 +#: ../src/guestfs-actions.pod:8551 msgid "guestfs_wc_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8491 +#: ../src/guestfs-actions.pod:8553 #, no-wrap msgid "" " int\n" @@ -34601,12 +34825,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8502 +#: ../src/guestfs-actions.pod:8564 msgid "guestfs_wc_w" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8504 +#: ../src/guestfs-actions.pod:8566 #, no-wrap msgid "" " int\n" @@ -34616,12 +34840,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8515 +#: ../src/guestfs-actions.pod:8577 msgid "guestfs_write" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8517 +#: ../src/guestfs-actions.pod:8579 #, no-wrap msgid "" " int\n" @@ -34633,17 +34857,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8526 +#: ../src/guestfs-actions.pod:8588 msgid "See also C<guestfs_write_append>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8535 +#: ../src/guestfs-actions.pod:8597 msgid "guestfs_write_append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8537 +#: ../src/guestfs-actions.pod:8599 #, no-wrap msgid "" " int\n" @@ -34655,17 +34879,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8546 +#: ../src/guestfs-actions.pod:8608 msgid "See also C<guestfs_write>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8555 +#: ../src/guestfs-actions.pod:8617 msgid "guestfs_write_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8557 +#: ../src/guestfs-actions.pod:8619 #, no-wrap msgid "" " int\n" @@ -34677,19 +34901,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8563 +#: ../src/guestfs-actions.pod:8625 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_write> call " "instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8588 +#: ../src/guestfs-actions.pod:8650 msgid "guestfs_zegrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8590 +#: ../src/guestfs-actions.pod:8652 #, no-wrap msgid "" " char **\n" @@ -34700,12 +34924,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8607 +#: ../src/guestfs-actions.pod:8669 msgid "guestfs_zegrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8609 +#: ../src/guestfs-actions.pod:8671 #, no-wrap msgid "" " char **\n" @@ -34716,12 +34940,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8626 +#: ../src/guestfs-actions.pod:8688 msgid "guestfs_zero" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8628 +#: ../src/guestfs-actions.pod:8690 #, no-wrap msgid "" " int\n" @@ -34731,19 +34955,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8642 +#: ../src/guestfs-actions.pod:8704 msgid "" "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>, " "C<guestfs_is_zero_device>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8654 +#: ../src/guestfs-actions.pod:8716 msgid "guestfs_zero_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8656 +#: ../src/guestfs-actions.pod:8718 #, no-wrap msgid "" " int\n" @@ -34753,24 +34977,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8660 +#: ../src/guestfs-actions.pod:8722 msgid "" "This command writes zeroes over the entire C<device>. Compare with " "C<guestfs_zero> which just zeroes the first few blocks of a device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8675 +#: ../src/guestfs-actions.pod:8737 msgid "(Added in 1.3.1)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8677 +#: ../src/guestfs-actions.pod:8739 msgid "guestfs_zerofree" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8679 +#: ../src/guestfs-actions.pod:8741 #, no-wrap msgid "" " int\n" @@ -34780,12 +35004,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8698 +#: ../src/guestfs-actions.pod:8760 msgid "guestfs_zfgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8700 +#: ../src/guestfs-actions.pod:8762 #, no-wrap msgid "" " char **\n" @@ -34796,12 +35020,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8717 +#: ../src/guestfs-actions.pod:8779 msgid "guestfs_zfgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8719 +#: ../src/guestfs-actions.pod:8781 #, no-wrap msgid "" " char **\n" @@ -34812,12 +35036,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8736 +#: ../src/guestfs-actions.pod:8798 msgid "guestfs_zfile" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8738 +#: ../src/guestfs-actions.pod:8800 #, no-wrap msgid "" " char *\n" @@ -34828,26 +35052,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8743 +#: ../src/guestfs-actions.pod:8805 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_file> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8755 +#: ../src/guestfs-actions.pod:8817 msgid "" "Since 1.0.63, use C<guestfs_file> instead which can now process compressed " "files." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8763 +#: ../src/guestfs-actions.pod:8825 msgid "guestfs_zgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8765 +#: ../src/guestfs-actions.pod:8827 #, no-wrap msgid "" " char **\n" @@ -34858,12 +35082,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8782 +#: ../src/guestfs-actions.pod:8844 msgid "guestfs_zgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8784 +#: ../src/guestfs-actions.pod:8846 #, no-wrap msgid "" " char **\n" @@ -35610,33 +35834,34 @@ msgid "" " guestfs_mount (g, \"/dev/sda1\", \"/\");\n" " guestfs_touch (g, \"/hello\");\n" " guestfs_umount (g, \"/\");\n" +" guestfs_shutdown (g);\n" " guestfs_close (g);\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:25 +#: ../src/guestfs.pod:26 msgid "" "Libguestfs is a library for accessing and modifying disk images and virtual " "machines. This manual page documents the C API." msgstr "" #. type: textblock -#: ../src/guestfs.pod:28 +#: ../src/guestfs.pod:29 msgid "" "If you are looking for an introduction to libguestfs, see the web site: " "L<http://libguestfs.org/>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:31 +#: ../src/guestfs.pod:32 msgid "" "Each virt tool has its own man page (for a full list, go to L</SEE ALSO> at " "the end of this file)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:34 +#: ../src/guestfs.pod:35 msgid "" "For examples of using the API from C, see L<guestfs-examples(3)>. For " "examples in other languages, see L</USING LIBGUESTFS WITH OTHER PROGRAMMING " @@ -35644,12 +35869,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:38 +#: ../src/guestfs.pod:39 msgid "API OVERVIEW" msgstr "" #. type: textblock -#: ../src/guestfs.pod:40 +#: ../src/guestfs.pod:41 msgid "" "This section provides a gentler overview of the libguestfs API. We also try " "to group API calls together, where that may not be obvious from reading " @@ -35657,12 +35882,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:45 +#: ../src/guestfs.pod:46 msgid "HANDLES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:47 +#: ../src/guestfs.pod:48 msgid "" "Before you can use libguestfs calls, you have to create a handle. Then you " "must add at least one disk image to the handle, followed by launching the " @@ -35672,12 +35897,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:54 +#: ../src/guestfs.pod:55 msgid "The general structure of all libguestfs-using programs looks like this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:57 +#: ../src/guestfs.pod:58 #, no-wrap msgid "" " guestfs_h *g = guestfs_create ();\n" @@ -35685,7 +35910,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:59 +#: ../src/guestfs.pod:60 #, no-wrap msgid "" " /* Call guestfs_add_drive additional times if there are\n" @@ -35696,7 +35921,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:64 +#: ../src/guestfs.pod:65 #, no-wrap msgid "" " /* Most manipulation calls won't work until you've launched\n" @@ -35708,7 +35933,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:70 +#: ../src/guestfs.pod:71 #, no-wrap msgid "" " /* Now you can examine what partitions, LVs etc are available.\n" @@ -35719,7 +35944,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:75 +#: ../src/guestfs.pod:76 #, no-wrap msgid "" " /* To access a filesystem in the image, you must mount it.\n" @@ -35729,7 +35954,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:79 +#: ../src/guestfs.pod:80 #, no-wrap msgid "" " /* Now you can perform filesystem actions on the guest\n" @@ -35740,28 +35965,25 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:84 +#: ../src/guestfs.pod:85 #, no-wrap msgid "" -" /* This is only needed for libguestfs < 1.5.24. Since then\n" -" * it is done automatically when you close the handle. See\n" -" * discussion of autosync in this page.\n" -" */\n" -" guestfs_sync (g);\n" +" /* Synchronize the disk. This is the opposite of guestfs_launch. */\n" +" guestfs_shutdown (g);\n" " \n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:90 +#: ../src/guestfs.pod:88 #, no-wrap msgid "" -" /* Close the handle 'g'. */\n" +" /* Close and free the handle 'g'. */\n" " guestfs_close (g);\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:93 +#: ../src/guestfs.pod:91 msgid "" "The code above doesn't include any error checking. In real code you should " "check return values carefully for errors. In general all functions that " @@ -35773,12 +35995,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:102 +#: ../src/guestfs.pod:100 msgid "DISK IMAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:104 +#: ../src/guestfs.pod:102 msgid "" "The image filename (C<\"guest.img\"> in the example above) could be a disk " "image from a virtual machine, a L<dd(1)> copy of a physical hard disk, an " @@ -35788,7 +36010,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:110 +#: ../src/guestfs.pod:108 msgid "" "The call you should use in modern code for adding drives is " "L</guestfs_add_drive_opts>. To add a disk image, allowing writes, and " @@ -35796,7 +36018,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:114 +#: ../src/guestfs.pod:112 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -35806,12 +36028,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:118 +#: ../src/guestfs.pod:116 msgid "You can add a disk read-only using:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:120 +#: ../src/guestfs.pod:118 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -35822,14 +36044,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:125 +#: ../src/guestfs.pod:123 msgid "" "or by calling the older function L</guestfs_add_drive_ro>. In either case " "libguestfs won't modify the file." msgstr "" #. type: textblock -#: ../src/guestfs.pod:128 +#: ../src/guestfs.pod:126 msgid "" "Be extremely cautious if the disk image is in use, eg. if it is being used " "by a virtual machine. Adding it read-write will almost certainly cause disk " @@ -35837,7 +36059,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:132 +#: ../src/guestfs.pod:130 msgid "" "You must add at least one disk image, and you may add multiple disk images. " "In the API, the disk images are usually referred to as C</dev/sda> (for the " @@ -35845,7 +36067,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:137 +#: ../src/guestfs.pod:135 msgid "" "Once L</guestfs_launch> has been called you cannot add any more images. You " "can call L</guestfs_list_devices> to get a list of the device names, in the " @@ -35853,12 +36075,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:142 +#: ../src/guestfs.pod:140 msgid "MOUNTING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:144 +#: ../src/guestfs.pod:142 msgid "" "Before you can read or write files, create directories and so on in a disk " "image that contains filesystems, you have to mount those filesystems using " @@ -35868,7 +36090,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:151 +#: ../src/guestfs.pod:149 #, no-wrap msgid "" " guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n" @@ -35876,7 +36098,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:153 +#: ../src/guestfs.pod:151 msgid "" "where C</dev/sda1> means literally the first partition (C<1>) of the first " "disk image that we added (C</dev/sda>). If the disk contains Linux LVM2 " @@ -35886,7 +36108,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:159 +#: ../src/guestfs.pod:157 msgid "" "If you are given a disk image and you don't know what it contains then you " "have to find out. Libguestfs can do that too: use " @@ -35897,7 +36119,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:167 +#: ../src/guestfs.pod:165 msgid "" "Libguestfs also has a set of APIs for inspection of unknown disk images (see " "L</INSPECTION> below). But you might find it easier to look at higher level " @@ -35905,19 +36127,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:172 +#: ../src/guestfs.pod:170 msgid "" "To mount a filesystem read-only, use L</guestfs_mount_ro>. There are " "several other variations of the C<guestfs_mount_*> call." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:175 +#: ../src/guestfs.pod:173 msgid "FILESYSTEM ACCESS AND MODIFICATION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:177 +#: ../src/guestfs.pod:175 msgid "" "The majority of the libguestfs API consists of fairly low-level calls for " "accessing and modifying the files, directories, symlinks etc on mounted " @@ -35927,21 +36149,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:183 +#: ../src/guestfs.pod:181 msgid "" "Specify filenames as full paths, starting with C<\"/\"> and including the " "mount point." msgstr "" #. type: textblock -#: ../src/guestfs.pod:186 +#: ../src/guestfs.pod:184 msgid "" "For example, if you mounted a filesystem at C<\"/\"> and you want to read " "the file called C<\"etc/passwd\"> then you could do:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:189 +#: ../src/guestfs.pod:187 #, no-wrap msgid "" " char *data = guestfs_cat (g, \"/etc/passwd\");\n" @@ -35949,7 +36171,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:191 +#: ../src/guestfs.pod:189 msgid "" "This would return C<data> as a newly allocated buffer containing the full " "content of that file (with some conditions: see also L</DOWNLOADING> below), " @@ -35957,14 +36179,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:195 +#: ../src/guestfs.pod:193 msgid "" "As another example, to create a top-level directory on that filesystem " "called C<\"var\"> you would do:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:198 +#: ../src/guestfs.pod:196 #, no-wrap msgid "" " guestfs_mkdir (g, \"/var\");\n" @@ -35972,12 +36194,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:200 +#: ../src/guestfs.pod:198 msgid "To create a symlink you could do:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:202 +#: ../src/guestfs.pod:200 #, no-wrap msgid "" " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n" @@ -35986,14 +36208,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:205 +#: ../src/guestfs.pod:203 msgid "" "Libguestfs will reject attempts to use relative paths and there is no " "concept of a current working directory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:208 +#: ../src/guestfs.pod:206 msgid "" "Libguestfs can return errors in many situations: for example if the " "filesystem isn't writable, or if a file or directory that you requested " @@ -36003,33 +36225,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:214 +#: ../src/guestfs.pod:212 msgid "" "File writes are affected by the per-handle umask, set by calling " "L</guestfs_umask> and defaulting to 022. See L</UMASK>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:217 +#: ../src/guestfs.pod:215 msgid "PARTITIONING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:219 +#: ../src/guestfs.pod:217 msgid "" "Libguestfs contains API calls to read, create and modify partition tables on " "disk images." msgstr "" #. type: textblock -#: ../src/guestfs.pod:222 +#: ../src/guestfs.pod:220 msgid "" "In the common case where you want to create a single partition covering the " "whole disk, you should use the L</guestfs_part_disk> call:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:226 +#: ../src/guestfs.pod:224 #, no-wrap msgid "" " const char *parttype = \"mbr\";\n" @@ -36040,19 +36262,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:231 +#: ../src/guestfs.pod:229 msgid "" "Obviously this effectively wipes anything that was on that disk image " "before." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:234 +#: ../src/guestfs.pod:232 msgid "LVM2" msgstr "" #. type: textblock -#: ../src/guestfs.pod:236 +#: ../src/guestfs.pod:234 msgid "" "Libguestfs provides access to a large part of the LVM2 API, such as " "L</guestfs_lvcreate> and L</guestfs_vgremove>. It won't make much sense " @@ -36061,19 +36283,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:241 +#: ../src/guestfs.pod:239 msgid "" "This author strongly recommends reading the LVM HOWTO, online at " "L<http://tldp.org/HOWTO/LVM-HOWTO/>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:244 +#: ../src/guestfs.pod:242 msgid "DOWNLOADING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:246 +#: ../src/guestfs.pod:244 msgid "" "Use L</guestfs_cat> to download small, text only files. This call is " "limited to files which are less than 2 MB and which cannot contain any ASCII " @@ -36081,7 +36303,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:250 +#: ../src/guestfs.pod:248 msgid "" "L</guestfs_read_file> can be used to read files which contain arbitrary 8 " "bit data, since it returns a (pointer, size) pair. However it is still " @@ -36089,31 +36311,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:254 +#: ../src/guestfs.pod:252 msgid "" "L</guestfs_download> can be used to download any file, with no limits on " "content or size (even files larger than 4 GB)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:257 +#: ../src/guestfs.pod:255 msgid "To download multiple files, see L</guestfs_tar_out> and L</guestfs_tgz_out>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:260 +#: ../src/guestfs.pod:258 msgid "UPLOADING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:262 +#: ../src/guestfs.pod:260 msgid "" "It's often the case that you want to write a file or files to the disk " "image." msgstr "" #. type: textblock -#: ../src/guestfs.pod:265 +#: ../src/guestfs.pod:263 msgid "" "To write a small file with fixed content, use L</guestfs_write>. To create " "a file of all zeroes, use L</guestfs_truncate_size> (sparse) or " @@ -36123,19 +36345,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:271 +#: ../src/guestfs.pod:269 msgid "" "To upload a single file, use L</guestfs_upload>. This call has no limits on " "file content or size (even files larger than 4 GB)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:274 +#: ../src/guestfs.pod:272 msgid "To upload multiple files, see L</guestfs_tar_in> and L</guestfs_tgz_in>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:276 +#: ../src/guestfs.pod:274 msgid "" "However the fastest way to upload I<large numbers of arbitrary files> is to " "turn them into a squashfs or CD ISO (see L<mksquashfs(8)> and " @@ -36149,12 +36371,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:287 +#: ../src/guestfs.pod:285 msgid "COPYING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:289 +#: ../src/guestfs.pod:287 msgid "" "There are various different commands for copying between files and devices " "and in and out of the guest filesystem. These are summarised in the table " @@ -36162,51 +36384,51 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:295 +#: ../src/guestfs.pod:293 msgid "B<file> to B<file>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:297 +#: ../src/guestfs.pod:295 msgid "" "Use L</guestfs_cp> to copy a single file, or L</guestfs_cp_a> to copy " "directories recursively." msgstr "" #. type: textblock -#: ../src/guestfs.pod:300 +#: ../src/guestfs.pod:298 msgid "To copy part of a file (offset and size) use L</guestfs_copy_file_to_file>." msgstr "" #. type: =item -#: ../src/guestfs.pod:303 +#: ../src/guestfs.pod:301 msgid "B<file> to B<device>" msgstr "" #. type: =item -#: ../src/guestfs.pod:305 +#: ../src/guestfs.pod:303 msgid "B<device> to B<file>" msgstr "" #. type: =item -#: ../src/guestfs.pod:307 +#: ../src/guestfs.pod:305 msgid "B<device> to B<device>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:309 +#: ../src/guestfs.pod:307 msgid "" "Use L</guestfs_copy_file_to_device>, L</guestfs_copy_device_to_file>, or " "L</guestfs_copy_device_to_device>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:312 +#: ../src/guestfs.pod:310 msgid "Example: duplicate the contents of an LV:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:314 +#: ../src/guestfs.pod:312 #, no-wrap msgid "" " guestfs_copy_device_to_device (g,\n" @@ -36217,7 +36439,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:319 +#: ../src/guestfs.pod:317 msgid "" "The destination (C</dev/VG/Copy>) must be at least as large as the source " "(C</dev/VG/Original>). To copy less than the whole source device, use the " @@ -36225,7 +36447,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:323 +#: ../src/guestfs.pod:321 #, no-wrap msgid "" " guestfs_copy_device_to_device (g,\n" @@ -36236,32 +36458,32 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:328 +#: ../src/guestfs.pod:326 msgid "B<file on the host> to B<file or device>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:330 +#: ../src/guestfs.pod:328 msgid "Use L</guestfs_upload>. See L</UPLOADING> above." msgstr "" #. type: =item -#: ../src/guestfs.pod:332 +#: ../src/guestfs.pod:330 msgid "B<file or device> to B<file on the host>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:334 +#: ../src/guestfs.pod:332 msgid "Use L</guestfs_download>. See L</DOWNLOADING> above." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:338 +#: ../src/guestfs.pod:336 msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:340 +#: ../src/guestfs.pod:338 msgid "" "Calls like L</guestfs_upload>, L</guestfs_download>, L</guestfs_tar_in>, " "L</guestfs_tar_out> etc appear to only take filenames as arguments, so it " @@ -36272,12 +36494,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:348 +#: ../src/guestfs.pod:346 msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:351 +#: ../src/guestfs.pod:349 #, no-wrap msgid "" " guestfs_download (g, filename, \"/dev/stdout\");\n" @@ -36285,12 +36507,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:353 +#: ../src/guestfs.pod:351 msgid "and you can write tar output to a file descriptor C<fd> by doing:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:355 +#: ../src/guestfs.pod:353 #, no-wrap msgid "" " char devfd[64];\n" @@ -36300,26 +36522,26 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:359 +#: ../src/guestfs.pod:357 msgid "LISTING FILES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:361 +#: ../src/guestfs.pod:359 msgid "" "L</guestfs_ll> is just designed for humans to read (mainly when using the " "L<guestfish(1)>-equivalent command C<ll>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:364 +#: ../src/guestfs.pod:362 msgid "" "L</guestfs_ls> is a quick way to get a list of files in a directory from " "programs, as a flat list of strings." msgstr "" #. type: textblock -#: ../src/guestfs.pod:367 +#: ../src/guestfs.pod:365 msgid "" "L</guestfs_readdir> is a programmatic way to get a list of files in a " "directory, plus additional information about each one. It is more " @@ -36327,19 +36549,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:371 +#: ../src/guestfs.pod:369 msgid "" "L</guestfs_find> and L</guestfs_find0> can be used to recursively list " "files." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:374 +#: ../src/guestfs.pod:372 msgid "RUNNING COMMANDS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:376 +#: ../src/guestfs.pod:374 msgid "" "Although libguestfs is primarily an API for manipulating files inside guest " "images, we also provide some limited facilities for running commands inside " @@ -36347,55 +36569,55 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:380 +#: ../src/guestfs.pod:378 msgid "There are many limitations to this:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:386 +#: ../src/guestfs.pod:384 msgid "" "The kernel version that the command runs under will be different from what " "it expects." msgstr "" #. type: textblock -#: ../src/guestfs.pod:391 +#: ../src/guestfs.pod:389 msgid "" "If the command needs to communicate with daemons, then most likely they " "won't be running." msgstr "" #. type: textblock -#: ../src/guestfs.pod:396 +#: ../src/guestfs.pod:394 msgid "The command will be running in limited memory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:400 +#: ../src/guestfs.pod:398 msgid "" "The network may not be available unless you enable it (see " "L</guestfs_set_network>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:405 +#: ../src/guestfs.pod:403 msgid "Only supports Linux guests (not Windows, BSD, etc)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:409 +#: ../src/guestfs.pod:407 msgid "Architecture limitations (eg. won't work for a PPC guest on an X86 host)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:414 +#: ../src/guestfs.pod:412 msgid "" "For SELinux guests, you may need to enable SELinux and load policy first. " "See L</SELINUX> in this manpage." msgstr "" #. type: textblock -#: ../src/guestfs.pod:419 +#: ../src/guestfs.pod:417 msgid "" "I<Security:> It is not safe to run commands from untrusted, possibly " "malicious guests. These commands may attempt to exploit your program by " @@ -36407,7 +36629,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:428 +#: ../src/guestfs.pod:426 msgid "" "A secure alternative is to use libguestfs to install a \"firstboot\" script " "(a script which runs when the guest next boots normally), and to have this " @@ -36417,26 +36639,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:436 +#: ../src/guestfs.pod:434 msgid "" "The two main API calls to run commands are L</guestfs_command> and " "L</guestfs_sh> (there are also variations)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:439 +#: ../src/guestfs.pod:437 msgid "" "The difference is that L</guestfs_sh> runs commands using the shell, so any " "shell globs, redirections, etc will work." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:442 +#: ../src/guestfs.pod:440 msgid "CONFIGURATION FILES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:444 +#: ../src/guestfs.pod:442 msgid "" "To read and write configuration files in Linux guest filesystems, we " "strongly recommend using Augeas. For example, Augeas understands how to " @@ -36445,7 +36667,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:449 +#: ../src/guestfs.pod:447 msgid "" "The main Augeas calls are bound through the C<guestfs_aug_*> APIs. We don't " "document Augeas itself here because there is excellent documentation on the " @@ -36453,7 +36675,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:453 +#: ../src/guestfs.pod:451 msgid "" "If you don't want to use Augeas (you fool!) then try calling " "L</guestfs_read_lines> to get the file as a list of lines which you can " @@ -36461,24 +36683,24 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:457 +#: ../src/guestfs.pod:455 msgid "SELINUX" msgstr "" #. type: textblock -#: ../src/guestfs.pod:459 +#: ../src/guestfs.pod:457 msgid "" "We support SELinux guests. To ensure that labeling happens correctly in " "SELinux guests, you need to enable SELinux and load the guest's policy:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:467 +#: ../src/guestfs.pod:465 msgid "Before launching, do:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:469 +#: ../src/guestfs.pod:467 #, no-wrap msgid "" " guestfs_set_selinux (g, 1);\n" @@ -36486,14 +36708,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:473 +#: ../src/guestfs.pod:471 msgid "" "After mounting the guest's filesystem(s), load the policy. This is best " "done by running the L<load_policy(8)> command in the guest itself:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:477 +#: ../src/guestfs.pod:475 #, no-wrap msgid "" " guestfs_sh (g, \"/usr/sbin/load_policy\");\n" @@ -36501,21 +36723,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:479 +#: ../src/guestfs.pod:477 msgid "" "(Older versions of C<load_policy> require you to specify the name of the " "policy file)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:484 +#: ../src/guestfs.pod:482 msgid "" "Optionally, set the security context for the API. The correct security " "context to use can only be known by inspecting the guest. As an example:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:488 +#: ../src/guestfs.pod:486 #, no-wrap msgid "" " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n" @@ -36523,24 +36745,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:492 +#: ../src/guestfs.pod:490 msgid "This will work for running commands and editing existing files." msgstr "" #. type: textblock -#: ../src/guestfs.pod:494 +#: ../src/guestfs.pod:492 msgid "" "When new files are created, you may need to label them explicitly, for " "example by running the external command C<restorecon pathname>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:498 +#: ../src/guestfs.pod:496 msgid "UMASK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:500 +#: ../src/guestfs.pod:498 msgid "" "Certain calls are affected by the current file mode creation mask (the " "\"umask\"). In particular ones which create files or directories, such as " @@ -36550,14 +36772,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:506 +#: ../src/guestfs.pod:504 msgid "" "The default umask is C<022>, so files are created with modes such as C<0644> " "and directories with C<0755>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:509 +#: ../src/guestfs.pod:507 msgid "" "There are two ways to avoid being affected by umask. Either set umask to 0 " "(call C<guestfs_umask (g, 0)> early after launching). Or call " @@ -36565,12 +36787,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:513 +#: ../src/guestfs.pod:511 msgid "For more information about umask, see L<umask(2)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:517 +#: ../src/guestfs.pod:515 msgid "" "Libguestfs allows you to access Linux guests which have been encrypted using " "whole disk encryption that conforms to the Linux Unified Key Setup (LUKS) " @@ -36579,21 +36801,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:523 +#: ../src/guestfs.pod:521 msgid "" "Use L</guestfs_vfs_type> to identify LUKS-encrypted block devices (it " "returns the string C<crypto_LUKS>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:526 +#: ../src/guestfs.pod:524 msgid "" "Then open these devices by calling L</guestfs_luks_open>. Obviously you " "will require the passphrase!" msgstr "" #. type: textblock -#: ../src/guestfs.pod:529 +#: ../src/guestfs.pod:527 msgid "" "Opening a LUKS device creates a new device mapper device called " "C</dev/mapper/mapname> (where C<mapname> is the string you supply to " @@ -36602,7 +36824,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:535 +#: ../src/guestfs.pod:533 msgid "" "LVM volume groups on the device can be made visible by calling " "L</guestfs_vgscan> followed by L</guestfs_vg_activate_all>. The logical " @@ -36610,7 +36832,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:539 +#: ../src/guestfs.pod:537 msgid "" "Use the reverse process to close a LUKS device. Unmount any logical volumes " "on it, deactivate the volume groups by caling C<guestfs_vg_activate (g, 0, " @@ -36620,12 +36842,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:546 +#: ../src/guestfs.pod:544 msgid "INSPECTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:548 +#: ../src/guestfs.pod:546 msgid "" "Libguestfs has APIs for inspecting an unknown disk image to find out if it " "contains operating systems, an install CD or a live CD. (These APIs used to " @@ -36635,14 +36857,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:555 +#: ../src/guestfs.pod:553 msgid "" "Add all disks belonging to the unknown virtual machine and call " "L</guestfs_launch> in the usual way." msgstr "" #. type: textblock -#: ../src/guestfs.pod:558 +#: ../src/guestfs.pod:556 msgid "" "Then call L</guestfs_inspect_os>. This function uses other libguestfs calls " "and certain heuristics, and returns a list of operating systems that were " @@ -36655,7 +36877,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:567 +#: ../src/guestfs.pod:565 msgid "" "For each root, you can then call various C<guestfs_inspect_get_*> functions " "to get additional details about that operating system. For example, call " @@ -36664,7 +36886,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:573 +#: ../src/guestfs.pod:571 msgid "" "Un*x-like and Linux-based operating systems usually consist of several " "filesystems which are mounted at boot time (for example, a separate boot " @@ -36675,7 +36897,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:580 +#: ../src/guestfs.pod:578 #, no-wrap msgid "" " /boot => /dev/sda1\n" @@ -36685,14 +36907,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:584 +#: ../src/guestfs.pod:582 msgid "" "The caller can then make calls to L</guestfs_mount_options> to mount the " "filesystems as suggested." msgstr "" #. type: textblock -#: ../src/guestfs.pod:587 +#: ../src/guestfs.pod:585 msgid "" "Be careful to mount filesystems in the right order (eg. C</> before " "C</usr>). Sorting the keys of the hash by length, shortest first, should " @@ -36700,7 +36922,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:591 +#: ../src/guestfs.pod:589 msgid "" "Inspection currently only works for some common operating systems. " "Contributors are welcome to send patches for other operating systems that we " @@ -36708,7 +36930,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:595 +#: ../src/guestfs.pod:593 msgid "" "Encrypted disks must be opened before inspection. See L</ENCRYPTED DISKS> " "for more details. The L</guestfs_inspect_os> function just ignores any " @@ -36716,7 +36938,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:599 +#: ../src/guestfs.pod:597 msgid "" "A note on the implementation: The call L</guestfs_inspect_os> performs " "inspection and caches the results in the guest handle. Subsequent calls to " @@ -36729,19 +36951,19 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:608 +#: ../src/guestfs.pod:606 msgid "INSPECTING INSTALL DISKS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:610 +#: ../src/guestfs.pod:608 msgid "" "Libguestfs (since 1.9.4) can detect some install disks, install CDs, live " "CDs and more." msgstr "" #. type: textblock -#: ../src/guestfs.pod:613 +#: ../src/guestfs.pod:611 msgid "" "Call L</guestfs_inspect_get_format> to return the format of the operating " "system, which currently can be C<installed> (a regular operating system) or " @@ -36749,7 +36971,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:617 +#: ../src/guestfs.pod:615 msgid "" "Further information is available about the operating system that can be " "installed using the regular inspection APIs like " @@ -36758,7 +36980,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:622 +#: ../src/guestfs.pod:620 msgid "" "Some additional information specific to installer disks is also available " "from the L</guestfs_inspect_is_live>, L</guestfs_inspect_is_netinst> and " @@ -36766,24 +36988,24 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:627 +#: ../src/guestfs.pod:625 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:629 +#: ../src/guestfs.pod:627 msgid "" "Libguestfs can mount NTFS partitions. It does this using the " "L<http://www.ntfs-3g.org/> driver." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:632 +#: ../src/guestfs.pod:630 msgid "DRIVE LETTERS AND PATHS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:634 +#: ../src/guestfs.pod:632 msgid "" "DOS and Windows still use drive letters, and the filesystems are always " "treated as case insensitive by Windows itself, and therefore you might find " @@ -36793,14 +37015,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:640 +#: ../src/guestfs.pod:638 msgid "" "Drive letter mappings can be found using inspection (see L</INSPECTION> and " "L</guestfs_inspect_get_drive_mappings>)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:643 +#: ../src/guestfs.pod:641 msgid "" "Dealing with separator characters (backslash vs forward slash) is outside " "the scope of libguestfs, but usually a simple character replacement will " @@ -36808,19 +37030,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:647 +#: ../src/guestfs.pod:645 msgid "" "To resolve the case insensitivity of paths, call " "L</guestfs_case_sensitive_path>." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:650 +#: ../src/guestfs.pod:648 msgid "ACCESSING THE WINDOWS REGISTRY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:652 +#: ../src/guestfs.pod:650 msgid "" "Libguestfs also provides some help for decoding Windows Registry \"hive\" " "files, through the library C<hivex> which is part of the libguestfs project " @@ -36831,12 +37053,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:660 +#: ../src/guestfs.pod:658 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:662 +#: ../src/guestfs.pod:660 msgid "" "Ntfs-3g tries to rewrite \"Junction Points\" and NTFS \"symbolic links\" to " "provide something which looks like a Linux symlink. The way it tries to do " @@ -36844,12 +37066,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:666 +#: ../src/guestfs.pod:664 msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-symbolic-links/>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:668 +#: ../src/guestfs.pod:666 msgid "" "The essential problem is that ntfs-3g simply does not have enough " "information to do a correct job. NTFS links can contain drive letters and " @@ -36859,7 +37081,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:675 +#: ../src/guestfs.pod:673 msgid "" "Instead if you encounter a symbolic link on an ntfs-3g filesystem, use " "L</guestfs_lgetxattr> to read the C<system.ntfs_reparse_data> extended " @@ -36868,36 +37090,36 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:680 +#: ../src/guestfs.pod:678 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:682 +#: ../src/guestfs.pod:680 msgid "" "There are other useful extended attributes that can be read from ntfs-3g " "filesystems (using L</guestfs_getxattr>). See:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:685 +#: ../src/guestfs.pod:683 msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:687 +#: ../src/guestfs.pod:685 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:689 +#: ../src/guestfs.pod:687 msgid "" "Although we don't want to discourage you from using the C API, we will " "mention here that the same API is also available in other languages." msgstr "" #. type: textblock -#: ../src/guestfs.pod:692 +#: ../src/guestfs.pod:690 msgid "" "The API is broadly identical in all supported languages. This means that " "the C call C<guestfs_add_drive_ro(g,file)> is C<$g-E<gt>add_drive_ro($file)> " @@ -36907,14 +37129,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:698 +#: ../src/guestfs.pod:696 msgid "" "Error messages are automatically transformed into exceptions if the language " "supports it." msgstr "" #. type: textblock -#: ../src/guestfs.pod:701 +#: ../src/guestfs.pod:699 msgid "" "We don't try to \"object orientify\" parts of the API in OO languages, " "although contributors are welcome to write higher level APIs above what we " @@ -36922,58 +37144,58 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:707 +#: ../src/guestfs.pod:705 msgid "B<C++>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:709 +#: ../src/guestfs.pod:707 msgid "" "You can use the I<guestfs.h> header file from C++ programs. The C++ API is " "identical to the C API. C++ classes and exceptions are not used." msgstr "" #. type: =item -#: ../src/guestfs.pod:713 +#: ../src/guestfs.pod:711 msgid "B<C#>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:715 +#: ../src/guestfs.pod:713 msgid "" "The C# bindings are highly experimental. Please read the warnings at the " "top of C<csharp/Libguestfs.cs>." msgstr "" #. type: =item -#: ../src/guestfs.pod:718 +#: ../src/guestfs.pod:716 msgid "B<Erlang>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:720 +#: ../src/guestfs.pod:718 msgid "See L<guestfs-erlang(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:722 +#: ../src/guestfs.pod:720 msgid "B<GObject>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:724 +#: ../src/guestfs.pod:722 msgid "" "Experimental GObject bindings (with GObject Introspection support) are " "available. See the C<gobject> directory in the source." msgstr "" #. type: =item -#: ../src/guestfs.pod:727 +#: ../src/guestfs.pod:725 msgid "B<Haskell>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:729 +#: ../src/guestfs.pod:727 msgid "" "This is the only language binding that is working but incomplete. Only " "calls which return simple integers have been bound in Haskell, and we are " @@ -36981,96 +37203,96 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:733 +#: ../src/guestfs.pod:731 msgid "B<Java>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:735 +#: ../src/guestfs.pod:733 msgid "" "Full documentation is contained in the Javadoc which is distributed with " "libguestfs. For examples, see L<guestfs-java(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:738 +#: ../src/guestfs.pod:736 msgid "B<OCaml>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:740 +#: ../src/guestfs.pod:738 msgid "See L<guestfs-ocaml(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:742 +#: ../src/guestfs.pod:740 msgid "B<Perl>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:744 +#: ../src/guestfs.pod:742 msgid "See L<guestfs-perl(3)> and L<Sys::Guestfs(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:746 +#: ../src/guestfs.pod:744 msgid "B<PHP>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:748 +#: ../src/guestfs.pod:746 msgid "" "For documentation see C<README-PHP> supplied with libguestfs sources or in " "the php-libguestfs package for your distribution." msgstr "" #. type: textblock -#: ../src/guestfs.pod:751 +#: ../src/guestfs.pod:749 msgid "The PHP binding only works correctly on 64 bit machines." msgstr "" #. type: =item -#: ../src/guestfs.pod:753 +#: ../src/guestfs.pod:751 msgid "B<Python>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:755 +#: ../src/guestfs.pod:753 msgid "See L<guestfs-python(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:757 +#: ../src/guestfs.pod:755 msgid "B<Ruby>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:759 +#: ../src/guestfs.pod:757 msgid "See L<guestfs-ruby(3)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:761 +#: ../src/guestfs.pod:759 msgid "For JRuby, use the Java bindings." msgstr "" #. type: =item -#: ../src/guestfs.pod:763 +#: ../src/guestfs.pod:761 msgid "B<shell scripts>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:765 +#: ../src/guestfs.pod:763 msgid "See L<guestfish(1)>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:769 +#: ../src/guestfs.pod:767 msgid "LIBGUESTFS GOTCHAS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:771 +#: ../src/guestfs.pod:769 msgid "" "L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a " "system [...] that works in the way it is documented but is counterintuitive " @@ -37078,7 +37300,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:775 +#: ../src/guestfs.pod:773 msgid "" "Since we developed libguestfs and the associated tools, there are several " "things we would have designed differently, but are now stuck with for " @@ -37087,19 +37309,19 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:783 +#: ../src/guestfs.pod:781 msgid "Autosync / forgetting to sync." msgstr "" #. type: textblock -#: ../src/guestfs.pod:785 +#: ../src/guestfs.pod:783 msgid "" "I<Update:> Autosync is enabled by default for all API users starting from " "libguestfs 1.5.24. This section only applies to older versions." msgstr "" #. type: textblock -#: ../src/guestfs.pod:788 +#: ../src/guestfs.pod:786 msgid "" "When modifying a filesystem from C or another language, you B<must> unmount " "all filesystems and call L</guestfs_sync> explicitly before you close the " @@ -37107,7 +37329,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:792 +#: ../src/guestfs.pod:790 #, no-wrap msgid "" " guestfs_set_autosync (g, 1);\n" @@ -37115,7 +37337,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:794 +#: ../src/guestfs.pod:792 msgid "" "to have the unmount/sync done automatically for you when the handle 'g' is " "closed. (This feature is called \"autosync\", L</guestfs_set_autosync> " @@ -37123,7 +37345,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:798 +#: ../src/guestfs.pod:796 msgid "" "If you forget to do this, then it is entirely possible that your changes " "won't be written out, or will be partially written, or (very rarely) that " @@ -37131,7 +37353,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:802 +#: ../src/guestfs.pod:800 msgid "" "Note that in L<guestfish(3)> autosync is the default. So quick and dirty " "guestfish scripts that forget to sync will work just fine, which can make " @@ -37139,19 +37361,19 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:806 +#: ../src/guestfs.pod:804 msgid "Mount option C<-o sync> should not be the default." msgstr "" #. type: textblock -#: ../src/guestfs.pod:808 +#: ../src/guestfs.pod:806 msgid "" "I<Update:> L</guestfs_mount> no longer adds any options starting from " "libguestfs 1.13.16. This section only applies to older versions." msgstr "" #. type: textblock -#: ../src/guestfs.pod:811 +#: ../src/guestfs.pod:809 msgid "" "If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly. " "However C<-o sync> does not add any reliability benefit, but does have a " @@ -37159,31 +37381,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:815 +#: ../src/guestfs.pod:813 msgid "" "The work around is to use L</guestfs_mount_options> and set the mount " "options that you actually want to use." msgstr "" #. type: =item -#: ../src/guestfs.pod:818 +#: ../src/guestfs.pod:816 msgid "Read-only should be the default." msgstr "" #. type: textblock -#: ../src/guestfs.pod:820 +#: ../src/guestfs.pod:818 msgid "" "In L<guestfish(3)>, I<--ro> should be the default, and you should have to " "specify I<--rw> if you want to make changes to the image." msgstr "" #. type: textblock -#: ../src/guestfs.pod:823 +#: ../src/guestfs.pod:821 msgid "This would reduce the potential to corrupt live VM images." msgstr "" #. type: textblock -#: ../src/guestfs.pod:825 +#: ../src/guestfs.pod:823 msgid "" "Note that many filesystems change the disk when you just mount and unmount, " "even if you didn't perform any writes. You need to use " @@ -37191,12 +37413,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:829 +#: ../src/guestfs.pod:827 msgid "guestfish command line is hard to use." msgstr "" #. type: textblock -#: ../src/guestfs.pod:831 +#: ../src/guestfs.pod:829 msgid "" "C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for " "examination). It tries to run a guestfish command C<disk.img> which doesn't " @@ -37206,12 +37428,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:838 +#: ../src/guestfs.pod:836 msgid "guestfish megabyte modifiers don't work right on all commands" msgstr "" #. type: textblock -#: ../src/guestfs.pod:840 +#: ../src/guestfs.pod:838 msgid "" "In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for " "other modifiers). What guestfish actually does is to multiply the number " @@ -37221,12 +37443,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:847 +#: ../src/guestfs.pod:845 msgid "The most common is L</guestfs_lvcreate>. The guestfish command:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:849 +#: ../src/guestfs.pod:847 #, no-wrap msgid "" " lvcreate LV VG 100M\n" @@ -37234,7 +37456,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:851 +#: ../src/guestfs.pod:849 msgid "" "does not do what you might expect. Instead because L</guestfs_lvcreate> is " "already expecting megabytes, this tries to create a 100 I<terabyte> (100 " @@ -37243,19 +37465,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:856 +#: ../src/guestfs.pod:854 msgid "" "This could be fixed in the generator by specially marking parameters and " "return values which take bytes or other units." msgstr "" #. type: =item -#: ../src/guestfs.pod:859 +#: ../src/guestfs.pod:857 msgid "Ambiguity between devices and paths" msgstr "" #. type: textblock -#: ../src/guestfs.pod:861 +#: ../src/guestfs.pod:859 msgid "" "There is a subtle ambiguity in the API between a device name " "(eg. C</dev/sdb2>) and a similar pathname. A file might just happen to be " @@ -37263,7 +37485,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:866 +#: ../src/guestfs.pod:864 msgid "" "In the current API we usually resolve this ambiguity by having two separate " "calls, for example L</guestfs_checksum> and L</guestfs_checksum_device>. " @@ -37272,7 +37494,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:872 +#: ../src/guestfs.pod:870 msgid "" "To avoid both the ambiguity and the need to duplicate some calls, we could " "make paths/devices into structured names. One way to do this would be to " @@ -37282,7 +37504,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:878 +#: ../src/guestfs.pod:876 #, no-wrap msgid "" " type path = Path of string | Device of int | Partition of int * int\n" @@ -37290,12 +37512,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:880 +#: ../src/guestfs.pod:878 msgid "which would allow you to pass arguments like:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:882 +#: ../src/guestfs.pod:880 #, no-wrap msgid "" " Path \"/foo/bar\"\n" @@ -37306,26 +37528,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:887 +#: ../src/guestfs.pod:885 msgid "" "As you can see there are still problems to resolve even with this " "representation. Also consider how it might work in guestfish." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:892 +#: ../src/guestfs.pod:890 msgid "KEYS AND PASSPHRASES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:894 +#: ../src/guestfs.pod:892 msgid "" "Certain libguestfs calls take a parameter that contains sensitive key " "material, passed in as a C string." msgstr "" #. type: textblock -#: ../src/guestfs.pod:897 +#: ../src/guestfs.pod:895 msgid "" "In the future we would hope to change the libguestfs implementation so that " "keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in " @@ -37334,7 +37556,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:902 +#: ../src/guestfs.pod:900 msgid "" "Therefore you should be aware that any key parameter you pass to libguestfs " "might end up being written out to the swap partition. If this is a concern, " @@ -37342,19 +37564,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:907 +#: ../src/guestfs.pod:905 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:909 +#: ../src/guestfs.pod:907 msgid "" "All high-level libguestfs actions are synchronous. If you want to use " "libguestfs asynchronously then you must create a thread." msgstr "" #. type: textblock -#: ../src/guestfs.pod:912 +#: ../src/guestfs.pod:910 msgid "" "Only use the handle from a single thread. Either use the handle exclusively " "from one thread, or provide your own mutex so that two threads cannot issue " @@ -37362,33 +37584,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:916 +#: ../src/guestfs.pod:914 msgid "" "See the graphical program guestfs-browser for one possible architecture for " "multithreaded programs using libvirt and libguestfs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:919 +#: ../src/guestfs.pod:917 msgid "PATH" msgstr "" #. type: textblock -#: ../src/guestfs.pod:921 +#: ../src/guestfs.pod:919 msgid "" "Libguestfs needs a supermin appliance, which it finds by looking along an " "internal path." msgstr "" #. type: textblock -#: ../src/guestfs.pod:924 +#: ../src/guestfs.pod:922 msgid "" "By default it looks for these in the directory C<$libdir/guestfs> " "(eg. C</usr/local/lib/guestfs> or C</usr/lib64/guestfs>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:927 +#: ../src/guestfs.pod:925 msgid "" "Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> " "to change the directories that libguestfs will search in. The value is a " @@ -37399,12 +37621,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:934 +#: ../src/guestfs.pod:932 msgid "QEMU WRAPPERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:936 +#: ../src/guestfs.pod:934 msgid "" "If you want to compile your own qemu, run qemu from a non-standard location, " "or pass extra arguments to qemu, then you can write a shell-script wrapper " @@ -37412,7 +37634,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:940 +#: ../src/guestfs.pod:938 msgid "" "There is one important rule to remember: you I<must C<exec qemu>> as the " "last command in the shell script (so that qemu replaces the shell and " @@ -37421,14 +37643,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:945 +#: ../src/guestfs.pod:943 msgid "" "Here is an example of a wrapper, where I have built my own copy of qemu from " "source:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:948 +#: ../src/guestfs.pod:946 #, no-wrap msgid "" " #!/bin/sh -\n" @@ -37439,7 +37661,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:952 +#: ../src/guestfs.pod:950 msgid "" "Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and " "then use it by setting the LIBGUESTFS_QEMU environment variable. For " @@ -37447,7 +37669,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:956 +#: ../src/guestfs.pod:954 #, no-wrap msgid "" " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n" @@ -37455,14 +37677,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:958 +#: ../src/guestfs.pod:956 msgid "" "Note that libguestfs also calls qemu with the -help and -version options in " "order to determine features." msgstr "" #. type: textblock -#: ../src/guestfs.pod:961 +#: ../src/guestfs.pod:959 msgid "" "Wrappers can also be used to edit the options passed to qemu. In the " "following example, the C<-machine ...> option (C<-machine> and the following " @@ -37472,7 +37694,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:970 +#: ../src/guestfs.pod:968 #, no-wrap msgid "" " i=0\n" @@ -37490,7 +37712,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:982 +#: ../src/guestfs.pod:980 #, no-wrap msgid "" " exec qemu-kvm -machine pc,accel=tcg \"${args[@]}\"\n" @@ -37498,19 +37720,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:984 +#: ../src/guestfs.pod:982 msgid "ATTACHING TO RUNNING DAEMONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:986 +#: ../src/guestfs.pod:984 msgid "" "I<Note (1):> This is B<highly experimental> and has a tendency to eat " "babies. Use with caution." msgstr "" #. type: textblock -#: ../src/guestfs.pod:989 +#: ../src/guestfs.pod:987 msgid "" "I<Note (2):> This section explains how to attach to a running daemon from a " "low level perspective. For most users, simply using virt tools such as " @@ -37518,12 +37740,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:993 +#: ../src/guestfs.pod:991 msgid "Using guestfs_set_attach_method" msgstr "" #. type: textblock -#: ../src/guestfs.pod:995 +#: ../src/guestfs.pod:993 msgid "" "By calling L</guestfs_set_attach_method> you can change how the library " "connects to the C<guestfsd> daemon in L</guestfs_launch> (read " @@ -37531,14 +37753,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:999 +#: ../src/guestfs.pod:997 msgid "" "The normal attach method is C<appliance>, where a small appliance is created " "containing the daemon, and then the library connects to this." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1002 +#: ../src/guestfs.pod:1000 msgid "" "Setting attach method to C<unix:I<path>> (where I<path> is the path of a " "Unix domain socket) causes L</guestfs_launch> to connect to an existing " @@ -37546,7 +37768,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1006 +#: ../src/guestfs.pod:1004 msgid "" "The normal use for this is to connect to a running virtual machine that " "contains a C<guestfsd> daemon, and send commands so you can read and write " @@ -37554,12 +37776,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1010 +#: ../src/guestfs.pod:1008 msgid "Using guestfs_add_domain with live flag" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1012 +#: ../src/guestfs.pod:1010 msgid "" "L</guestfs_add_domain> provides some help for getting the correct attach " "method. If you pass the C<live> option to this function, then (if the " @@ -37568,7 +37790,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1018 +#: ../src/guestfs.pod:1016 #, no-wrap msgid "" " <domain>\n" @@ -37586,14 +37808,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1030 +#: ../src/guestfs.pod:1028 msgid "" "L</guestfs_add_domain> extracts C</path/to/socket> and sets the attach " "method to C<unix:/path/to/socket>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1033 +#: ../src/guestfs.pod:1031 msgid "" "Some of the libguestfs tools (including guestfish) support a I<--live> " "option which is passed through to L</guestfs_add_domain> thus allowing you " @@ -37601,19 +37823,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1037 +#: ../src/guestfs.pod:1035 msgid "" "The virtual machine needs to have been set up beforehand so that it has the " "virtio-serial channel and so that guestfsd is running inside it." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1041 +#: ../src/guestfs.pod:1039 msgid "ABI GUARANTEE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1043 +#: ../src/guestfs.pod:1041 msgid "" "We guarantee the libguestfs ABI (binary interface), for public, high-level " "actions as outlined in this section. Although we will deprecate some " @@ -37623,12 +37845,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1049 +#: ../src/guestfs.pod:1047 msgid "BLOCK DEVICE NAMING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1051 +#: ../src/guestfs.pod:1049 msgid "" "In the kernel there is now quite a profusion of schemata for naming block " "devices (in this context, by I<block device> I mean a physical or virtual " @@ -37643,7 +37865,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1063 +#: ../src/guestfs.pod:1061 msgid "" "As discussed above, libguestfs uses a qemu appliance running an embedded " "Linux kernel to access block devices. We can run a variety of appliances " @@ -37651,7 +37873,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1067 +#: ../src/guestfs.pod:1065 msgid "" "This causes a problem for libguestfs because many API calls use device or " "partition names. Working scripts and the recipe (example) scripts that we " @@ -37659,7 +37881,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1072 +#: ../src/guestfs.pod:1070 msgid "" "Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>. " "Internally C</dev/sd*> names are translated, if necessary, to other names as " @@ -37668,7 +37890,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1078 +#: ../src/guestfs.pod:1076 msgid "" "Note that this I<only> applies to parameters. The L</guestfs_list_devices>, " "L</guestfs_list_partitions> and similar calls return the true names of the " @@ -37676,12 +37898,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1083 +#: ../src/guestfs.pod:1081 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1085 +#: ../src/guestfs.pod:1083 msgid "" "Usually this translation is transparent. However in some (very rare) cases " "you may need to know the exact algorithm. Such cases include where you use " @@ -37691,7 +37913,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1091 +#: ../src/guestfs.pod:1089 msgid "" "The algorithm is applied only to I<parameters> which are known to be either " "device or partition names. Return values from functions such as " @@ -37699,54 +37921,54 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1099 +#: ../src/guestfs.pod:1097 msgid "Is the string a parameter which is a device or partition name?" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1103 +#: ../src/guestfs.pod:1101 msgid "Does the string begin with C</dev/sd>?" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1107 +#: ../src/guestfs.pod:1105 msgid "" "Does the named device exist? If so, we use that device. However if I<not> " "then we continue with this algorithm." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1112 +#: ../src/guestfs.pod:1110 msgid "Replace initial C</dev/sd> string with C</dev/hd>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1114 +#: ../src/guestfs.pod:1112 msgid "For example, change C</dev/sda2> to C</dev/hda2>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1116 +#: ../src/guestfs.pod:1114 msgid "If that named device exists, use it. If not, continue." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1120 +#: ../src/guestfs.pod:1118 msgid "Replace initial C</dev/sd> string with C</dev/vd>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1122 +#: ../src/guestfs.pod:1120 msgid "If that named device exists, use it. If not, return an error." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1126 +#: ../src/guestfs.pod:1124 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1128 +#: ../src/guestfs.pod:1126 msgid "" "Although the standard naming scheme and automatic translation is useful for " "simple programs and guestfish scripts, for larger programs it is best not to " @@ -37754,45 +37976,45 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1132 +#: ../src/guestfs.pod:1130 msgid "" "Where possible for maximum future portability programs using libguestfs " "should use these future-proof techniques:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1139 +#: ../src/guestfs.pod:1137 msgid "" "Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual " "device names, and then use those names directly." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1142 +#: ../src/guestfs.pod:1140 msgid "Since those device names exist by definition, they will never be translated." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1147 +#: ../src/guestfs.pod:1145 msgid "" "Use higher level ways to identify filesystems, such as LVM names, UUIDs and " "filesystem labels." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1154 +#: ../src/guestfs.pod:1152 msgid "" "This section discusses security implications of using libguestfs, " "particularly with untrusted or malicious guests or disk images." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1157 +#: ../src/guestfs.pod:1155 msgid "GENERAL SECURITY CONSIDERATIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1159 +#: ../src/guestfs.pod:1157 msgid "" "Be careful with any files or data that you download from a guest (by " "\"download\" we mean not just the L</guestfs_download> command but any " @@ -37802,42 +38024,42 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1169 +#: ../src/guestfs.pod:1167 msgid "the data (file etc) not being present" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1173 +#: ../src/guestfs.pod:1171 msgid "being present but empty" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1177 +#: ../src/guestfs.pod:1175 msgid "being much larger than normal" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1181 +#: ../src/guestfs.pod:1179 msgid "containing arbitrary 8 bit data" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1185 +#: ../src/guestfs.pod:1183 msgid "being in an unexpected character encoding" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1189 +#: ../src/guestfs.pod:1187 msgid "containing homoglyphs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1193 +#: ../src/guestfs.pod:1191 msgid "SECURITY OF MOUNTING FILESYSTEMS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1195 +#: ../src/guestfs.pod:1193 msgid "" "When you mount a filesystem under Linux, mistakes in the kernel filesystem " "(VFS) module can sometimes be escalated into exploits by deliberately " @@ -37853,7 +38075,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1208 +#: ../src/guestfs.pod:1206 msgid "" "That explains why you should never mount a filesystem from an untrusted " "guest on your host kernel. How about libguestfs? We run a Linux kernel " @@ -37867,19 +38089,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1219 +#: ../src/guestfs.pod:1217 msgid "" "In any case callers can reduce the attack surface by forcing the filesystem " "type when mounting (use L</guestfs_mount_vfs>)." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1222 +#: ../src/guestfs.pod:1220 msgid "PROTOCOL SECURITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1224 +#: ../src/guestfs.pod:1222 msgid "" "The protocol is designed to be secure, being based on RFC 4506 (XDR) with a " "defined upper message size. However a program that uses libguestfs must " @@ -37889,12 +38111,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1230 +#: ../src/guestfs.pod:1228 msgid "INSPECTION SECURITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1232 +#: ../src/guestfs.pod:1230 msgid "" "Parts of the inspection API (see L</INSPECTION>) return untrusted strings " "directly from the guest, and these could contain any 8 bit data. Callers " @@ -37903,7 +38125,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1238 +#: ../src/guestfs.pod:1236 msgid "" "Guest configuration may be altered in unusual ways by the administrator of " "the virtual machine, and may not reflect reality (particularly for untrusted " @@ -37914,7 +38136,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1246 +#: ../src/guestfs.pod:1244 msgid "" "The inspection API parses guest configuration using two external libraries: " "Augeas (Linux configuration) and hivex (Windows Registry). Both are " @@ -37924,12 +38146,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1252 +#: ../src/guestfs.pod:1250 msgid "RUNNING UNTRUSTED GUEST COMMANDS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1254 +#: ../src/guestfs.pod:1252 msgid "" "Be very cautious about running commands from the guest. By running a " "command in the guest, you are giving CPU time to a binary that you do not " @@ -37939,24 +38161,24 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1260 +#: ../src/guestfs.pod:1258 msgid "CVE-2010-3851" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1262 +#: ../src/guestfs.pod:1260 msgid "https://bugzilla.redhat.com/642934" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1264 +#: ../src/guestfs.pod:1262 msgid "" "This security bug concerns the automatic disk format detection that qemu " "does on disk images." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1267 +#: ../src/guestfs.pod:1265 msgid "" "A raw disk image is just the raw bytes, there is no header. Other disk " "images like qcow2 contain a special header. Qemu deals with this by looking " @@ -37965,7 +38187,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1272 +#: ../src/guestfs.pod:1270 msgid "" "This allows a guest which has been given a raw disk image to write some " "other header. At next boot (or when the disk image is accessed by " @@ -37974,7 +38196,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1277 +#: ../src/guestfs.pod:1275 msgid "" "This in itself would not be a problem, but qcow2 offers many features, one " "of which is to allow a disk image to refer to another image (called the " @@ -37986,24 +38208,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1285 +#: ../src/guestfs.pod:1283 msgid "In libguestfs this is rather hard to exploit except under two circumstances:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1292 +#: ../src/guestfs.pod:1290 msgid "You have enabled the network or have opened the disk in write mode." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1296 +#: ../src/guestfs.pod:1294 msgid "" "You are also running untrusted code from the guest (see L</RUNNING " "COMMANDS>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1301 +#: ../src/guestfs.pod:1299 msgid "" "The way to avoid this is to specify the expected disk format when adding " "disks (the optional C<format> option to L</guestfs_add_drive_opts>). You " @@ -38012,31 +38234,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1306 +#: ../src/guestfs.pod:1304 msgid "" "For disks added from libvirt using calls like L</guestfs_add_domain>, the " "format is fetched from libvirt and passed through." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1309 +#: ../src/guestfs.pod:1307 msgid "" "For libguestfs tools, use the I<--format> command line parameter as " "appropriate." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1312 +#: ../src/guestfs.pod:1310 msgid "CONNECTION MANAGEMENT" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1314 +#: ../src/guestfs.pod:1312 msgid "guestfs_h *" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1316 +#: ../src/guestfs.pod:1314 msgid "" "C<guestfs_h> is the opaque type representing a connection handle. Create a " "handle by calling L</guestfs_create>. Call L</guestfs_close> to free the " @@ -38044,19 +38266,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1320 +#: ../src/guestfs.pod:1318 msgid "" "For information on using multiple handles and threads, see the section " "L</MULTIPLE HANDLES AND MULTIPLE THREADS> above." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1323 +#: ../src/guestfs.pod:1321 msgid "guestfs_create" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1325 +#: ../src/guestfs.pod:1323 #, no-wrap msgid "" " guestfs_h *guestfs_create (void);\n" @@ -38064,19 +38286,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1327 +#: ../src/guestfs.pod:1325 msgid "Create a connection handle." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1329 +#: ../src/guestfs.pod:1327 msgid "" "On success this returns a non-NULL pointer to a handle. On error it returns " "NULL." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1332 +#: ../src/guestfs.pod:1330 msgid "" "You have to \"configure\" the handle after creating it. This includes " "calling L</guestfs_add_drive_opts> (or one of the equivalent calls) on the " @@ -38084,24 +38306,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1336 +#: ../src/guestfs.pod:1334 msgid "After configuring the handle, you have to call L</guestfs_launch>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1338 +#: ../src/guestfs.pod:1336 msgid "" "You may also want to configure error handling for the handle. See the " "L</ERROR HANDLING> section below." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1341 +#: ../src/guestfs.pod:1339 msgid "guestfs_close" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1343 +#: ../src/guestfs.pod:1341 #, no-wrap msgid "" " void guestfs_close (guestfs_h *g);\n" @@ -38109,37 +38331,74 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1345 -msgid "This closes the connection handle and frees up all resources used." +#: ../src/guestfs.pod:1343 +msgid "" +"This closes the connection handle and frees up all resources used. If a " +"close callback was set on the handle, then it is called." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1347 +#: ../src/guestfs.pod:1346 +msgid "The correct way to close the handle is:" +msgstr "" + +#. type: verbatim +#: ../src/guestfs.pod:1348 +#, no-wrap msgid "" -"If autosync was set on the handle and the handle was launched, then this " -"implicitly calls various functions to unmount filesystems and sync the " -"disk. See L</guestfs_set_autosync> for more details." +" if (guestfs_shutdown (g) == -1) {\n" +" /* handle write errors here */\n" +" }\n" +" guestfs_close (g);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1353 +msgid "L</guestfs_shutdown> is only needed if B<all> of the following are true:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1351 -msgid "If a close callback was set on the handle, then it is called." +#: ../src/guestfs.pod:1359 +msgid "one or more disks were added in read-write mode, I<and>" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1363 +msgid "guestfs_launch was called, I<and>" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1367 +msgid "you made some changes, I<and>" +msgstr "" + +#. type: =item +#: ../src/guestfs.pod:1369 +msgid "4" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1371 +msgid "" +"you have a way to handle write errors (eg. by exiting with an error code or " +"reporting something to the user)." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1353 +#: ../src/guestfs.pod:1376 msgid "ERROR HANDLING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1355 +#: ../src/guestfs.pod:1378 msgid "" "API functions can return errors. For example, almost all functions that " "return C<int> will return C<-1> to indicate an error." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1358 +#: ../src/guestfs.pod:1381 msgid "" "Additional information is available for errors: an error message string and " "optionally an error number (errno) if the thing that failed was a system " @@ -38147,7 +38406,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1362 +#: ../src/guestfs.pod:1385 msgid "" "You can get at the additional information about the last error on the handle " "by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting " @@ -38155,7 +38414,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1367 +#: ../src/guestfs.pod:1390 msgid "" "When the handle is created, a default error handler is installed which " "prints the error message string to C<stderr>. For small short-running " @@ -38163,7 +38422,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1371 +#: ../src/guestfs.pod:1394 #, no-wrap msgid "" " if (guestfs_launch (g) == -1)\n" @@ -38172,21 +38431,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1374 +#: ../src/guestfs.pod:1397 msgid "" "since the default error handler will ensure that an error message has been " "printed to C<stderr> before the program exits." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1377 +#: ../src/guestfs.pod:1400 msgid "" "For other programs the caller will almost certainly want to install an " "alternate error handler or do error handling in-line like this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1380 +#: ../src/guestfs.pod:1403 #, no-wrap msgid "" " /* This disables the default behaviour of printing errors\n" @@ -38196,7 +38455,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1384 +#: ../src/guestfs.pod:1407 #, no-wrap msgid "" " if (guestfs_launch (g) == -1) {\n" @@ -38213,7 +38472,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1395 +#: ../src/guestfs.pod:1418 msgid "" "Out of memory errors are handled differently. The default action is to call " "L<abort(3)>. If this is undesirable, then you can set a handler using " @@ -38221,7 +38480,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1399 +#: ../src/guestfs.pod:1422 msgid "" "L</guestfs_create> returns C<NULL> if the handle cannot be created, and " "because there is no handle if this happens there is no way to get additional " @@ -38231,12 +38490,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1405 +#: ../src/guestfs.pod:1428 msgid "guestfs_last_error" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1407 +#: ../src/guestfs.pod:1430 #, no-wrap msgid "" " const char *guestfs_last_error (guestfs_h *g);\n" @@ -38244,26 +38503,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1409 +#: ../src/guestfs.pod:1432 msgid "" "This returns the last error message that happened on C<g>. If there has not " "been an error since the handle was created, then this returns C<NULL>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1413 +#: ../src/guestfs.pod:1436 msgid "" "The lifetime of the returned string is until the next error occurs, or " "L</guestfs_close> is called." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1416 +#: ../src/guestfs.pod:1439 msgid "guestfs_last_errno" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1418 +#: ../src/guestfs.pod:1441 #, no-wrap msgid "" " int guestfs_last_errno (guestfs_h *g);\n" @@ -38271,27 +38530,27 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1420 +#: ../src/guestfs.pod:1443 msgid "This returns the last error number (errno) that happened on C<g>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1422 +#: ../src/guestfs.pod:1445 msgid "If successful, an errno integer not equal to zero is returned." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1424 +#: ../src/guestfs.pod:1447 msgid "If no error, this returns 0. This call can return 0 in three situations:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1431 +#: ../src/guestfs.pod:1454 msgid "There has not been any error on the handle." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1435 +#: ../src/guestfs.pod:1458 msgid "" "There has been an error but the errno was meaningless. This corresponds to " "the case where the error did not come from a failed system call, but for " @@ -38299,14 +38558,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1441 +#: ../src/guestfs.pod:1464 msgid "" "There was an error from a failed system call, but for some reason the errno " "was not captured and returned. This usually indicates a bug in libguestfs." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1447 +#: ../src/guestfs.pod:1470 msgid "" "Libguestfs tries to convert the errno from inside the applicance into a " "corresponding errno for the caller (not entirely trivial: the appliance " @@ -38317,12 +38576,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1455 +#: ../src/guestfs.pod:1478 msgid "guestfs_set_error_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1457 +#: ../src/guestfs.pod:1480 #, no-wrap msgid "" " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n" @@ -38335,7 +38594,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1464 +#: ../src/guestfs.pod:1487 msgid "" "The callback C<cb> will be called if there is an error. The parameters " "passed to the callback are an opaque data pointer and the error message " @@ -38343,14 +38602,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1468 +#: ../src/guestfs.pod:1491 msgid "" "C<errno> is not passed to the callback. To get that the callback must call " "L</guestfs_last_errno>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1471 +#: ../src/guestfs.pod:1494 msgid "" "Note that the message string C<msg> is freed as soon as the callback " "function returns, so if you want to stash it somewhere you must make your " @@ -38358,22 +38617,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1475 +#: ../src/guestfs.pod:1498 msgid "The default handler prints messages on C<stderr>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1477 +#: ../src/guestfs.pod:1500 msgid "If you set C<cb> to C<NULL> then I<no> handler is called." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1479 +#: ../src/guestfs.pod:1502 msgid "guestfs_get_error_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1481 +#: ../src/guestfs.pod:1504 #, no-wrap msgid "" " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n" @@ -38382,17 +38641,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1484 +#: ../src/guestfs.pod:1507 msgid "Returns the current error handler callback." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1486 +#: ../src/guestfs.pod:1509 msgid "guestfs_set_out_of_memory_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1488 +#: ../src/guestfs.pod:1511 #, no-wrap msgid "" " typedef void (*guestfs_abort_cb) (void);\n" @@ -38402,29 +38661,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1492 +#: ../src/guestfs.pod:1515 msgid "" "The callback C<cb> will be called if there is an out of memory situation. " "I<Note this callback must not return>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1495 +#: ../src/guestfs.pod:1518 msgid "The default is to call L<abort(3)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1497 +#: ../src/guestfs.pod:1520 msgid "You cannot set C<cb> to C<NULL>. You can't ignore out of memory situations." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1500 +#: ../src/guestfs.pod:1523 msgid "guestfs_get_out_of_memory_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1502 +#: ../src/guestfs.pod:1525 #, no-wrap msgid "" " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n" @@ -38432,37 +38691,37 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1504 +#: ../src/guestfs.pod:1527 msgid "This returns the current out of memory handler." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1506 +#: ../src/guestfs.pod:1529 msgid "API CALLS" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1510 +#: ../src/guestfs.pod:1533 msgid "STRUCTURES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1512 +#: ../src/guestfs.pod:1535 msgid "@STRUCTS@" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1514 +#: ../src/guestfs.pod:1537 msgid "AVAILABILITY" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1516 +#: ../src/guestfs.pod:1539 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1518 +#: ../src/guestfs.pod:1541 msgid "" "Using L</guestfs_available> you can test availability of the following " "groups of functions. This test queries the appliance to see if the " @@ -38470,17 +38729,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1523 +#: ../src/guestfs.pod:1546 msgid "@AVAILABILITY@" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1525 +#: ../src/guestfs.pod:1548 msgid "GUESTFISH supported COMMAND" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1527 +#: ../src/guestfs.pod:1550 msgid "" "In L<guestfish(3)> there is a handy interactive command C<supported> which " "prints out the available groups and whether they are supported by this build " @@ -38488,19 +38747,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1532 +#: ../src/guestfs.pod:1555 msgid "SINGLE CALLS AT COMPILE TIME" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1534 +#: ../src/guestfs.pod:1557 msgid "" "Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API " "function, such as:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1537 +#: ../src/guestfs.pod:1560 #, no-wrap msgid "" " #define LIBGUESTFS_HAVE_DD 1\n" @@ -38508,12 +38767,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1539 +#: ../src/guestfs.pod:1562 msgid "if L</guestfs_dd> is available." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1541 +#: ../src/guestfs.pod:1564 msgid "" "Before version 1.5.8, if you needed to test whether a single libguestfs " "function is available at compile time, we recommended using build tools such " @@ -38521,7 +38780,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1546 +#: ../src/guestfs.pod:1569 #, no-wrap msgid "" " AC_CHECK_LIB([guestfs],[guestfs_create])\n" @@ -38530,19 +38789,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1549 +#: ../src/guestfs.pod:1572 msgid "" "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined " "in your program." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1552 +#: ../src/guestfs.pod:1575 msgid "SINGLE CALLS AT RUN TIME" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1554 +#: ../src/guestfs.pod:1577 msgid "" "Testing at compile time doesn't guarantee that a function really exists in " "the library. The reason is that you might be dynamically linked against a " @@ -38552,7 +38811,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1561 +#: ../src/guestfs.pod:1584 msgid "" "You can use L<dlopen(3)> to test if a function is available at run time, as " "in this example program (note that you still need the compile time check as " @@ -38560,7 +38819,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1565 +#: ../src/guestfs.pod:1588 #, no-wrap msgid "" " #include <stdio.h>\n" @@ -38572,7 +38831,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1571 +#: ../src/guestfs.pod:1594 #, no-wrap msgid "" " main ()\n" @@ -38584,7 +38843,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1577 +#: ../src/guestfs.pod:1600 #, no-wrap msgid "" " /* Test if the function guestfs_dd is really available. */\n" @@ -38599,7 +38858,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1586 +#: ../src/guestfs.pod:1609 #, no-wrap msgid "" " if (!has_function)\n" @@ -38618,7 +38877,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1599 +#: ../src/guestfs.pod:1622 msgid "" "You may think the above is an awful lot of hassle, and it is. There are " "other ways outside of the C linking system to ensure that this kind of " @@ -38626,7 +38885,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1604 +#: ../src/guestfs.pod:1627 #, no-wrap msgid "" " Requires: libguestfs >= 1.0.80\n" @@ -38634,12 +38893,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1606 +#: ../src/guestfs.pod:1629 msgid "CALLS WITH OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1608 +#: ../src/guestfs.pod:1631 msgid "" "A recent feature of the API is the introduction of calls which take optional " "arguments. In C these are declared 3 ways. The main way is as a call which " @@ -38647,7 +38906,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1613 +#: ../src/guestfs.pod:1636 #, no-wrap msgid "" " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n" @@ -38655,14 +38914,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1615 +#: ../src/guestfs.pod:1638 msgid "" "Call this with a list of optional arguments, terminated by C<-1>. So to " "call with no optional arguments specified:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1618 +#: ../src/guestfs.pod:1641 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename, -1);\n" @@ -38670,12 +38929,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1620 +#: ../src/guestfs.pod:1643 msgid "With a single optional argument:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1622 +#: ../src/guestfs.pod:1645 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -38685,12 +38944,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1626 +#: ../src/guestfs.pod:1649 msgid "With two:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1628 +#: ../src/guestfs.pod:1651 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -38701,19 +38960,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1633 +#: ../src/guestfs.pod:1656 msgid "" "and so forth. Don't forget the terminating C<-1> otherwise Bad Things will " "happen!" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1636 +#: ../src/guestfs.pod:1659 msgid "USING va_list FOR OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1638 +#: ../src/guestfs.pod:1661 msgid "" "The second variant has the same name with the suffix C<_va>, which works the " "same way but takes a C<va_list>. See the C manual for details. For the " @@ -38721,7 +38980,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1642 +#: ../src/guestfs.pod:1665 #, no-wrap msgid "" " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n" @@ -38730,12 +38989,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1645 +#: ../src/guestfs.pod:1668 msgid "CONSTRUCTING OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1647 +#: ../src/guestfs.pod:1670 msgid "" "The third variant is useful where you need to construct these calls. You " "pass in a structure where you fill in the optional fields. The structure " @@ -38745,7 +39004,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1653 +#: ../src/guestfs.pod:1676 #, no-wrap msgid "" " struct guestfs_add_drive_opts_argv {\n" @@ -38760,12 +39019,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1662 +#: ../src/guestfs.pod:1685 msgid "You could call it like this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1664 +#: ../src/guestfs.pod:1687 #, no-wrap msgid "" " struct guestfs_add_drive_opts_argv optargs = {\n" @@ -38778,7 +39037,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1671 +#: ../src/guestfs.pod:1694 #, no-wrap msgid "" " guestfs_add_drive_opts_argv (g, filename, &optargs);\n" @@ -38786,29 +39045,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1679 +#: ../src/guestfs.pod:1702 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1684 +#: ../src/guestfs.pod:1707 msgid "You do not need to fill in all fields of the structure." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1688 +#: ../src/guestfs.pod:1711 msgid "" "There must be a one-to-one correspondence between fields of the structure " "that are filled in, and bits set in the bitmask." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1693 +#: ../src/guestfs.pod:1716 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1695 +#: ../src/guestfs.pod:1718 msgid "" "In other languages, optional arguments are expressed in the way that is " "natural for that language. We refer you to the language-specific " @@ -38816,17 +39075,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1699 +#: ../src/guestfs.pod:1722 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1701 +#: ../src/guestfs.pod:1724 msgid "SETTING CALLBACKS TO HANDLE EVENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1703 +#: ../src/guestfs.pod:1726 msgid "" "B<Note:> This section documents the generic event mechanism introduced in " "libguestfs 1.10, which you should use in new code if possible. The old " @@ -38838,7 +39097,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1712 +#: ../src/guestfs.pod:1735 msgid "" "Handles generate events when certain things happen, such as log messages " "being generated, progress messages during long-running operations, or the " @@ -38850,7 +39109,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1720 +#: ../src/guestfs.pod:1743 msgid "" "In the current implementation, events are only generated synchronously: that " "means that events (and hence callbacks) can only happen while you are in the " @@ -38859,31 +39118,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1725 +#: ../src/guestfs.pod:1748 msgid "" "Events may contain a payload, usually nothing (void), an array of 64 bit " "unsigned integers, or a message buffer. Payloads are discussed later on." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1729 +#: ../src/guestfs.pod:1752 msgid "CLASSES OF EVENTS" msgstr "" #. type: =item -#: ../src/guestfs.pod:1733 +#: ../src/guestfs.pod:1756 msgid "GUESTFS_EVENT_CLOSE (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1736 +#: ../src/guestfs.pod:1759 msgid "" "The callback function will be called while the handle is being closed " "(synchronously from L</guestfs_close>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1739 +#: ../src/guestfs.pod:1762 msgid "" "Note that libguestfs installs an L<atexit(3)> handler to try to clean up " "handles that are open when the program exits. This means that this callback " @@ -38894,19 +39153,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1746 +#: ../src/guestfs.pod:1769 msgid "" "If no callback is registered: the handle is closed without any callback " "being invoked." msgstr "" #. type: =item -#: ../src/guestfs.pod:1749 +#: ../src/guestfs.pod:1772 msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1752 +#: ../src/guestfs.pod:1775 msgid "" "The callback function will be called when the child process quits, either " "asynchronously or if killed by L</guestfs_kill_subprocess>. (This " @@ -38914,17 +39173,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1756 ../src/guestfs.pod:1765 ../src/guestfs.pod:1882 +#: ../src/guestfs.pod:1779 ../src/guestfs.pod:1788 ../src/guestfs.pod:1905 msgid "If no callback is registered: the event is ignored." msgstr "" #. type: =item -#: ../src/guestfs.pod:1758 +#: ../src/guestfs.pod:1781 msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1761 +#: ../src/guestfs.pod:1784 msgid "" "The callback function will be called when the child process becomes ready " "first time after it has been launched. (This corresponds to a transition " @@ -38932,12 +39191,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:1767 +#: ../src/guestfs.pod:1790 msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1770 +#: ../src/guestfs.pod:1793 msgid "" "Some long-running operations can generate progress messages. If this " "callback is registered, then it will be called each time a progress message " @@ -38947,14 +39206,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1776 +#: ../src/guestfs.pod:1799 msgid "" "The callback receives in the payload four unsigned 64 bit numbers which are " "(in order): C<proc_nr>, C<serial>, C<position>, C<total>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1779 +#: ../src/guestfs.pod:1802 msgid "" "The units of C<total> are not defined, although for some operations C<total> " "may relate in some way to the amount of data to be transferred (eg. in bytes " @@ -38963,24 +39222,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1784 +#: ../src/guestfs.pod:1807 msgid "The only defined and stable parts of the API are:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1790 +#: ../src/guestfs.pod:1813 msgid "" "The callback can display to the user some type of progress bar or indicator " "which shows the ratio of C<position>:C<total>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1795 +#: ../src/guestfs.pod:1818 msgid "0 E<lt>= C<position> E<lt>= C<total>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1799 +#: ../src/guestfs.pod:1822 msgid "" "If any progress notification is sent during a call, then a final progress " "notification is always sent when C<position> = C<total> (I<unless> the call " @@ -38988,7 +39247,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1803 +#: ../src/guestfs.pod:1826 msgid "" "This is to simplify caller code, so callers can easily set the progress " "indicator to \"100%\" at the end of the operation, without requiring special " @@ -38996,7 +39255,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1809 +#: ../src/guestfs.pod:1832 msgid "" "For some calls we are unable to estimate the progress of the call, but we " "can still generate progress messages to indicate activity. This is known as " @@ -39005,7 +39264,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1814 +#: ../src/guestfs.pod:1837 msgid "" "For these calls, zero or more progress messages are generated with " "C<position = 0> and C<total = 1>, followed by a final message with " @@ -39013,14 +39272,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1818 +#: ../src/guestfs.pod:1841 msgid "" "As noted above, if the call fails with an error then the final message may " "not be generated." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1823 +#: ../src/guestfs.pod:1846 msgid "" "The callback also receives the procedure number (C<proc_nr>) and serial " "number (C<serial>) of the call. These are only useful for debugging " @@ -39029,31 +39288,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1829 +#: ../src/guestfs.pod:1852 msgid "If no callback is registered: progress messages are discarded." msgstr "" #. type: =item -#: ../src/guestfs.pod:1831 +#: ../src/guestfs.pod:1854 msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1834 +#: ../src/guestfs.pod:1857 msgid "" "The callback function is called whenever a log message is generated by qemu, " "the appliance kernel, guestfsd (daemon), or utility programs." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1837 +#: ../src/guestfs.pod:1860 msgid "" "If the verbose flag (L</guestfs_set_verbose>) is set before launch " "(L</guestfs_launch>) then additional debug messages are generated." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1840 ../src/guestfs.pod:1854 +#: ../src/guestfs.pod:1863 ../src/guestfs.pod:1877 msgid "" "If no callback is registered: the messages are discarded unless the verbose " "flag is set in which case they are sent to stderr. You can override the " @@ -39061,62 +39320,62 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:1845 +#: ../src/guestfs.pod:1868 msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1848 +#: ../src/guestfs.pod:1871 msgid "" "The callback function is called whenever a log message is generated by the " "library part of libguestfs." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1851 +#: ../src/guestfs.pod:1874 msgid "" "If the verbose flag (L</guestfs_set_verbose>) is set then additional debug " "messages are generated." msgstr "" #. type: =item -#: ../src/guestfs.pod:1859 +#: ../src/guestfs.pod:1882 msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1862 +#: ../src/guestfs.pod:1885 msgid "" "The callback function is called whenever a trace message is generated. This " "only applies if the trace flag (L</guestfs_set_trace>) is set." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1865 +#: ../src/guestfs.pod:1888 msgid "" "If no callback is registered: the messages are sent to stderr. You can " "override the printing of trace messages to stderr by setting up a callback." msgstr "" #. type: =item -#: ../src/guestfs.pod:1869 +#: ../src/guestfs.pod:1892 msgid "GUESTFS_EVENT_ENTER (payload type: function name)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1872 +#: ../src/guestfs.pod:1895 msgid "The callback function is called whenever a libguestfs function is entered." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1875 +#: ../src/guestfs.pod:1898 msgid "" "The payload is a string which contains the name of the function that we are " "entering (not including C<guestfs_> prefix)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1878 +#: ../src/guestfs.pod:1901 msgid "" "Note that libguestfs functions can call themselves, so you may see many " "events from a single call. A few libguestfs functions do not generate this " @@ -39124,12 +39383,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1886 +#: ../src/guestfs.pod:1909 msgid "guestfs_set_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1888 +#: ../src/guestfs.pod:1911 #, no-wrap msgid "" " int guestfs_set_event_callback (guestfs_h *g,\n" @@ -39141,14 +39400,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1894 +#: ../src/guestfs.pod:1917 msgid "" "This function registers a callback (C<cb>) for all event classes in the " "C<event_bitmask>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1897 +#: ../src/guestfs.pod:1920 msgid "" "For example, to register for all log message events, you could call this " "function with the bitmask C<GUESTFS_EVENT_APPLIANCE|GUESTFS_EVENT_LIBRARY>. " @@ -39157,40 +39416,40 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1903 +#: ../src/guestfs.pod:1926 msgid "C<flags> should always be passed as 0." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1905 +#: ../src/guestfs.pod:1928 msgid "" "C<opaque> is an opaque pointer which is passed to the callback. You can use " "it for any purpose." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1908 +#: ../src/guestfs.pod:1931 msgid "" "The return value is the event handle (an integer) which you can use to " "delete the callback (see below)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1911 +#: ../src/guestfs.pod:1934 msgid "" "If there is an error, this function returns C<-1>, and sets the error in the " "handle in the usual way (see L</guestfs_last_error> etc.)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1914 +#: ../src/guestfs.pod:1937 msgid "" "Callbacks remain in effect until they are deleted, or until the handle is " "closed." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1917 +#: ../src/guestfs.pod:1940 msgid "" "In the case where multiple callbacks are registered for a particular event " "class, all of the callbacks are called. The order in which multiple " @@ -39198,12 +39457,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1921 +#: ../src/guestfs.pod:1944 msgid "guestfs_delete_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1923 +#: ../src/guestfs.pod:1946 #, no-wrap msgid "" " void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n" @@ -39211,7 +39470,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1925 +#: ../src/guestfs.pod:1948 msgid "" "Delete a callback that was previously registered. C<event_handle> should be " "the integer that was returned by a previous call to " @@ -39219,12 +39478,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1929 +#: ../src/guestfs.pod:1952 msgid "guestfs_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1931 +#: ../src/guestfs.pod:1954 #, no-wrap msgid "" " typedef void (*guestfs_event_callback) (\n" @@ -39239,12 +39498,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1940 +#: ../src/guestfs.pod:1963 msgid "This is the type of the event callback function that you have to provide." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1943 +#: ../src/guestfs.pod:1966 msgid "" "The basic parameters are: the handle (C<g>), the opaque user pointer " "(C<opaque>), the event class (eg. C<GUESTFS_EVENT_PROGRESS>), the event " @@ -39252,7 +39511,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1947 +#: ../src/guestfs.pod:1970 msgid "" "The remaining parameters contain the event payload (if any). Each event may " "contain a payload, which usually relates to the event class, but for future " @@ -39261,7 +39520,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1952 +#: ../src/guestfs.pod:1975 msgid "" "C<buf> and C<buf_len> contain a message buffer (if C<buf_len == 0>, then " "there is no message buffer). Note that this message buffer can contain " @@ -39269,19 +39528,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1956 +#: ../src/guestfs.pod:1979 msgid "" "C<array> and C<array_len> is an array of 64 bit unsigned integers. At the " "moment this is only used for progress messages." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1959 +#: ../src/guestfs.pod:1982 msgid "EXAMPLE: CAPTURING LOG MESSAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1961 +#: ../src/guestfs.pod:1984 msgid "" "One motivation for the generic event API was to allow GUI programs to " "capture debug and other messages. In libguestfs E<le> 1.8 these were sent " @@ -39289,7 +39548,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1965 +#: ../src/guestfs.pod:1988 msgid "" "Events associated with log messages are: C<GUESTFS_EVENT_LIBRARY>, " "C<GUESTFS_EVENT_APPLIANCE> and C<GUESTFS_EVENT_TRACE>. (Note that error " @@ -39297,14 +39556,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1970 +#: ../src/guestfs.pod:1993 msgid "" "Programs have to set up a callback to capture the classes of events of " "interest:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1973 +#: ../src/guestfs.pod:1996 #, no-wrap msgid "" " int eh =\n" @@ -39320,14 +39579,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1983 +#: ../src/guestfs.pod:2006 msgid "" "The callback can then direct messages to the appropriate place. In this " "example, messages are directed to syslog:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1986 +#: ../src/guestfs.pod:2009 #, no-wrap msgid "" " static void\n" @@ -39348,12 +39607,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2001 +#: ../src/guestfs.pod:2024 msgid "CANCELLING LONG TRANSFERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2003 +#: ../src/guestfs.pod:2026 msgid "" "Some operations can be cancelled by the caller while they are in progress. " "Currently only operations that involve uploading or downloading data can be " @@ -39362,12 +39621,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2008 +#: ../src/guestfs.pod:2031 msgid "guestfs_user_cancel" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2010 +#: ../src/guestfs.pod:2033 #, no-wrap msgid "" " void guestfs_user_cancel (guestfs_h *g);\n" @@ -39375,12 +39634,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2012 +#: ../src/guestfs.pod:2035 msgid "C<guestfs_user_cancel> cancels the current upload or download operation." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2015 +#: ../src/guestfs.pod:2038 msgid "" "Unlike most other libguestfs calls, this function is signal safe and thread " "safe. You can call it from a signal handler or from another thread, without " @@ -39388,7 +39647,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2019 +#: ../src/guestfs.pod:2042 msgid "" "The transfer that was in progress (if there is one) will stop shortly " "afterwards, and will return an error. The errno (see " @@ -39397,7 +39656,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2025 +#: ../src/guestfs.pod:2048 msgid "" "No cleanup is performed: for example, if a file was being uploaded then " "after cancellation there may be a partially uploaded file. It is the " @@ -39405,12 +39664,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2029 +#: ../src/guestfs.pod:2052 msgid "There are two common places that you might call C<guestfs_user_cancel>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2031 +#: ../src/guestfs.pod:2054 msgid "" "In an interactive text-based program, you might call it from a C<SIGINT> " "signal handler so that pressing C<^C> cancels the current operation. (You " @@ -39419,19 +39678,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2036 +#: ../src/guestfs.pod:2059 msgid "" "In a graphical program, when the main thread is displaying a progress bar " "with a cancel button, wire up the cancel button to call this function." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2040 +#: ../src/guestfs.pod:2063 msgid "PRIVATE DATA AREA" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2042 +#: ../src/guestfs.pod:2065 msgid "" "You can attach named pieces of private data to the libguestfs handle, fetch " "them by name, and walk over them, for the lifetime of the handle. This is " @@ -39439,12 +39698,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2047 +#: ../src/guestfs.pod:2070 msgid "To attach a named piece of data, use the following call:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2049 +#: ../src/guestfs.pod:2072 #, no-wrap msgid "" " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n" @@ -39452,7 +39711,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2051 +#: ../src/guestfs.pod:2074 msgid "" "C<key> is the name to associate with this data, and C<data> is an arbitrary " "pointer (which can be C<NULL>). Any previous item with the same key is " @@ -39460,7 +39719,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2055 +#: ../src/guestfs.pod:2078 msgid "" "You can use any C<key> you want, but your key should I<not> start with an " "underscore character. Keys beginning with an underscore character are " @@ -39470,12 +39729,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2061 +#: ../src/guestfs.pod:2084 msgid "To retrieve the pointer, use:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2063 +#: ../src/guestfs.pod:2086 #, no-wrap msgid "" " void *guestfs_get_private (guestfs_h *g, const char *key);\n" @@ -39483,7 +39742,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2065 +#: ../src/guestfs.pod:2088 msgid "" "This function returns C<NULL> if either no data is found associated with " "C<key>, or if the user previously set the C<key>'s C<data> pointer to " @@ -39491,7 +39750,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2069 +#: ../src/guestfs.pod:2092 msgid "" "Libguestfs does not try to look at or interpret the C<data> pointer in any " "way. As far as libguestfs is concerned, it need not be a valid pointer at " @@ -39502,12 +39761,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2076 +#: ../src/guestfs.pod:2099 msgid "To walk over all entries, use these two functions:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2078 +#: ../src/guestfs.pod:2101 #, no-wrap msgid "" " void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n" @@ -39515,7 +39774,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2080 +#: ../src/guestfs.pod:2103 #, no-wrap msgid "" " void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n" @@ -39523,7 +39782,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2082 +#: ../src/guestfs.pod:2105 msgid "" "C<guestfs_first_private> returns the first key, pointer pair (\"first\" does " "not have any particular meaning -- keys are not returned in any defined " @@ -39533,7 +39792,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2088 +#: ../src/guestfs.pod:2111 msgid "" "C<guestfs_next_private> returns the next key, pointer pair. The return " "value of this function is also C<NULL> is there are no further entries to " @@ -39541,17 +39800,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2092 +#: ../src/guestfs.pod:2115 msgid "Notes about walking over entries:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2098 +#: ../src/guestfs.pod:2121 msgid "You must not call C<guestfs_set_private> while walking over the entries." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2103 +#: ../src/guestfs.pod:2126 msgid "" "The handle maintains an internal iterator which is reset when you call " "C<guestfs_first_private>. This internal iterator is invalidated when you " @@ -39559,12 +39818,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2109 +#: ../src/guestfs.pod:2132 msgid "If you have set the data pointer associated with a key to C<NULL>, ie:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2111 +#: ../src/guestfs.pod:2134 #, no-wrap msgid "" " guestfs_set_private (g, key, NULL);\n" @@ -39572,26 +39831,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2113 +#: ../src/guestfs.pod:2136 msgid "then that C<key> is not returned when walking." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2117 +#: ../src/guestfs.pod:2140 msgid "" "C<*key_rtn> is only valid until the next call to C<guestfs_first_private>, " "C<guestfs_next_private> or C<guestfs_set_private>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2123 +#: ../src/guestfs.pod:2146 msgid "" "The following example code shows how to print all keys and data pointers " "that are associated with the handle C<g>:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2126 +#: ../src/guestfs.pod:2149 #, no-wrap msgid "" " const char *key;\n" @@ -39605,14 +39864,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2134 +#: ../src/guestfs.pod:2157 msgid "" "More commonly you are only interested in keys that begin with an " "application-specific prefix C<foo_>. Modify the loop like so:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2137 +#: ../src/guestfs.pod:2160 #, no-wrap msgid "" " const char *key;\n" @@ -39627,7 +39886,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2146 +#: ../src/guestfs.pod:2169 msgid "" "If you need to modify keys while walking, then you have to jump back to the " "beginning of the loop. For example, to delete all keys prefixed with " @@ -39635,7 +39894,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2150 +#: ../src/guestfs.pod:2173 #, no-wrap msgid "" " const char *key;\n" @@ -39657,7 +39916,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2166 +#: ../src/guestfs.pod:2189 msgid "" "Note that the above loop is guaranteed to terminate because the keys are " "being deleted, but other manipulations of keys within the loop might not " @@ -39666,12 +39925,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2171 +#: ../src/guestfs.pod:2194 msgid "SYSTEMTAP" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2173 +#: ../src/guestfs.pod:2196 msgid "" "The libguestfs C library can be probed using systemtap or DTrace. This is " "true of any library, not just libguestfs. However libguestfs also contains " @@ -39679,12 +39938,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2177 +#: ../src/guestfs.pod:2200 msgid "You can list all the static markers by doing:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2179 +#: ../src/guestfs.pod:2202 #, no-wrap msgid "" " stap -l 'process(\"/usr/lib*/libguestfs.so.0\")\n" @@ -39693,26 +39952,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2182 +#: ../src/guestfs.pod:2205 msgid "" "B<Note:> These static markers are I<not> part of the stable API and may " "change in future versions." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2185 +#: ../src/guestfs.pod:2208 msgid "SYSTEMTAP SCRIPT EXAMPLE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2187 +#: ../src/guestfs.pod:2210 msgid "" "This script contains examples of displaying both the static markers and some " "ordinary C entry points:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2190 +#: ../src/guestfs.pod:2213 #, no-wrap msgid "" " global last;\n" @@ -39720,7 +39979,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2192 +#: ../src/guestfs.pod:2215 #, no-wrap msgid "" " function display_time () {\n" @@ -39733,7 +39992,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2199 +#: ../src/guestfs.pod:2222 #, no-wrap msgid "" " printf (\"%d (+%d):\", now, delta);\n" @@ -39742,7 +40001,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2202 +#: ../src/guestfs.pod:2225 #, no-wrap msgid "" " probe begin {\n" @@ -39753,7 +40012,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2207 +#: ../src/guestfs.pod:2230 #, no-wrap msgid "" " /* Display all calls to static markers. */\n" @@ -39766,7 +40025,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2214 +#: ../src/guestfs.pod:2237 #, no-wrap msgid "" " /* Display all calls to guestfs_mkfs* functions. */\n" @@ -39779,7 +40038,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2221 +#: ../src/guestfs.pod:2244 msgid "" "The script above can be saved to C<test.stap> and run using the L<stap(1)> " "program. Note that you either have to be root, or you have to add yourself " @@ -39788,7 +40047,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2226 +#: ../src/guestfs.pod:2249 #, no-wrap msgid "" " # stap /tmp/test.stap\n" @@ -39797,17 +40056,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2229 +#: ../src/guestfs.pod:2252 msgid "In another terminal, run a guestfish command such as this:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2233 +#: ../src/guestfs.pod:2256 msgid "In the first terminal, stap trace output similar to this is shown:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2235 +#: ../src/guestfs.pod:2258 #, no-wrap msgid "" " 1318248056692655 (+0):\tlaunch_start\n" @@ -39821,24 +40080,24 @@ msgid "" msgstr "" #. type: =end -#: ../src/guestfs.pod:2242 ../src/guestfs.pod:2247 +#: ../src/guestfs.pod:2265 ../src/guestfs.pod:2270 msgid "html" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2244 +#: ../src/guestfs.pod:2267 msgid "" "<!-- old anchor for the next section --> <a " "name=\"state_machine_and_low_level_event_api\"/>" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2249 +#: ../src/guestfs.pod:2272 msgid "ARCHITECTURE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2251 +#: ../src/guestfs.pod:2274 msgid "" "Internally, libguestfs is implemented by running an appliance (a special " "type of small virtual machine) using L<qemu(1)>. Qemu runs as a child " @@ -39846,7 +40105,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2255 +#: ../src/guestfs.pod:2278 #, no-wrap msgid "" " ___________________\n" @@ -39872,14 +40131,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2275 +#: ../src/guestfs.pod:2298 msgid "" "The library, linked to the main program, creates the child process and hence " "the appliance in the L</guestfs_launch> function." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2278 +#: ../src/guestfs.pod:2301 msgid "" "Inside the appliance is a Linux kernel and a complete stack of userspace " "tools (such as LVM and ext2 programs) and a small controlling daemon called " @@ -39891,7 +40150,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2287 +#: ../src/guestfs.pod:2310 msgid "" "A common misunderstanding is that the appliance \"is\" the virtual machine. " "Although the disk image you are attached to might also be used by some " @@ -39902,17 +40161,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2294 +#: ../src/guestfs.pod:2317 msgid "STATE MACHINE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2296 +#: ../src/guestfs.pod:2319 msgid "libguestfs uses a state machine to model the child process:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2298 +#: ../src/guestfs.pod:2321 #, no-wrap msgid "" " |\n" @@ -39940,7 +40199,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2320 +#: ../src/guestfs.pod:2343 msgid "" "The normal transitions are (1) CONFIG (when the handle is created, but there " "is no child process), (2) LAUNCHING (when the child process is booting up), " @@ -39949,7 +40208,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2325 +#: ../src/guestfs.pod:2348 msgid "" "The guest may be killed by L</guestfs_kill_subprocess>, or may die " "asynchronously at any time (eg. due to some internal error), and that causes " @@ -39957,14 +40216,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2329 +#: ../src/guestfs.pod:2352 msgid "" "Configuration commands for qemu such as L</guestfs_add_drive> can only be " "issued when in the CONFIG state." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2332 +#: ../src/guestfs.pod:2355 msgid "" "The API offers one call that goes from CONFIG through LAUNCHING to READY. " "L</guestfs_launch> blocks until the child process is READY to accept " @@ -39973,7 +40232,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2338 +#: ../src/guestfs.pod:2361 msgid "" "API actions such as L</guestfs_mount> can only be issued when in the READY " "state. These API calls block waiting for the command to be carried out " @@ -39983,7 +40242,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2344 +#: ../src/guestfs.pod:2367 msgid "" "Finally, the child process sends asynchronous messages back to the main " "program, such as kernel log messages. You can register a callback to " @@ -39991,17 +40250,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2348 +#: ../src/guestfs.pod:2371 msgid "INTERNALS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2350 +#: ../src/guestfs.pod:2373 msgid "APPLIANCE BOOT PROCESS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2352 +#: ../src/guestfs.pod:2375 msgid "" "This process has evolved and continues to evolve. The description here " "corresponds only to the current version of libguestfs and is provided for " @@ -40009,55 +40268,55 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2356 +#: ../src/guestfs.pod:2379 msgid "" "In order to follow the stages involved below, enable libguestfs debugging " "(set the environment variable C<LIBGUESTFS_DEBUG=1>)." msgstr "" #. type: =item -#: ../src/guestfs.pod:2361 +#: ../src/guestfs.pod:2384 msgid "Create the appliance" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2363 +#: ../src/guestfs.pod:2386 msgid "" "C<febootstrap-supermin-helper> is invoked to create the kernel, a small " "initrd and the appliance." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2366 +#: ../src/guestfs.pod:2389 msgid "" "The appliance is cached in C</var/tmp/.guestfs-E<lt>UIDE<gt>> (or in another " "directory if C<TMPDIR> is set)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2369 +#: ../src/guestfs.pod:2392 msgid "" "For a complete description of how the appliance is created and cached, read " "the L<febootstrap(8)> and L<febootstrap-supermin-helper(8)> man pages." msgstr "" #. type: =item -#: ../src/guestfs.pod:2373 +#: ../src/guestfs.pod:2396 msgid "Start qemu and boot the kernel" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2375 +#: ../src/guestfs.pod:2398 msgid "qemu is invoked to boot the kernel." msgstr "" #. type: =item -#: ../src/guestfs.pod:2377 +#: ../src/guestfs.pod:2400 msgid "Run the initrd" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2379 +#: ../src/guestfs.pod:2402 msgid "" "C<febootstrap-supermin-helper> builds a small initrd. The initrd is not the " "appliance. The purpose of the initrd is to load enough kernel modules in " @@ -40065,21 +40324,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2383 +#: ../src/guestfs.pod:2406 msgid "" "The initrd is a cpio archive called " "C</var/tmp/.guestfs-E<lt>UIDE<gt>/initrd>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2386 +#: ../src/guestfs.pod:2409 msgid "" "When the initrd has started you will see messages showing that kernel " "modules are being loaded, similar to this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2389 +#: ../src/guestfs.pod:2412 #, no-wrap msgid "" " febootstrap: ext2 mini initrd starting up\n" @@ -40090,12 +40349,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2394 +#: ../src/guestfs.pod:2417 msgid "Find and mount the appliance device" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2396 +#: ../src/guestfs.pod:2419 msgid "" "The appliance is a sparse file containing an ext2 filesystem which contains " "a familiar (although reduced in size) Linux operating system. It would " @@ -40103,33 +40362,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2400 +#: ../src/guestfs.pod:2423 msgid "" "The regular disks being inspected by libguestfs are the first devices " "exposed by qemu (eg. as C</dev/vda>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2403 +#: ../src/guestfs.pod:2426 msgid "" "The last disk added to qemu is the appliance itself (eg. C</dev/vdb> if " "there was only one regular disk)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2406 +#: ../src/guestfs.pod:2429 msgid "" "Thus the final job of the initrd is to locate the appliance disk, mount it, " "and switch root into the appliance, and run C</init> from the appliance." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2410 +#: ../src/guestfs.pod:2433 msgid "If this works successfully you will see messages such as:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2412 +#: ../src/guestfs.pod:2435 #, no-wrap msgid "" " febootstrap: picked /sys/block/vdb/dev as root device\n" @@ -40141,19 +40400,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2418 +#: ../src/guestfs.pod:2441 msgid "" "Note that C<Starting /init script ...> indicates that the appliance's init " "script is now running." msgstr "" #. type: =item -#: ../src/guestfs.pod:2421 +#: ../src/guestfs.pod:2444 msgid "Initialize the appliance" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2423 +#: ../src/guestfs.pod:2446 msgid "" "The appliance itself now initializes itself. This involves starting certain " "processes like C<udev>, possibly printing some debug information, and " @@ -40161,19 +40420,19 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2427 +#: ../src/guestfs.pod:2450 msgid "The daemon" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2429 +#: ../src/guestfs.pod:2452 msgid "" "Finally the daemon (C<guestfsd>) runs inside the appliance. If it runs you " "should see:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2432 +#: ../src/guestfs.pod:2455 #, no-wrap msgid "" " verbose daemon enabled\n" @@ -40181,14 +40440,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2434 +#: ../src/guestfs.pod:2457 msgid "" "The daemon expects to see a named virtio-serial port exposed by qemu and " "connected on the other end to the library." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2437 +#: ../src/guestfs.pod:2460 msgid "" "The daemon connects to this port (and hence to the library) and sends a four " "byte message C<GUESTFS_LAUNCH_FLAG>, which initiates the communication " @@ -40196,19 +40455,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2443 +#: ../src/guestfs.pod:2466 msgid "COMMUNICATION PROTOCOL" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2445 +#: ../src/guestfs.pod:2468 msgid "" "Don't rely on using this protocol directly. This section documents how it " "currently works, but it may change at any time." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2448 +#: ../src/guestfs.pod:2471 msgid "" "The protocol used to talk between the library and the daemon running inside " "the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC " @@ -40216,14 +40475,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2452 +#: ../src/guestfs.pod:2475 msgid "" "The detailed format of structures is in C<src/guestfs_protocol.x> (note: " "this file is automatically generated)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2455 +#: ../src/guestfs.pod:2478 msgid "" "There are two broad cases, ordinary functions that don't have any C<FileIn> " "and C<FileOut> parameters, which are handled with very simple request/reply " @@ -40233,17 +40492,17 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2462 +#: ../src/guestfs.pod:2485 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2464 +#: ../src/guestfs.pod:2487 msgid "For ordinary functions, the request message is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2466 +#: ../src/guestfs.pod:2489 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -40254,7 +40513,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2471 +#: ../src/guestfs.pod:2494 msgid "" "The total length field allows the daemon to allocate a fixed size buffer " "into which it slurps the rest of the message. As a result, the total length " @@ -40263,21 +40522,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2477 +#: ../src/guestfs.pod:2500 msgid "" "Note also that many functions don't take any arguments, in which case the " "C<guestfs_I<foo>_args> is completely omitted." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2480 +#: ../src/guestfs.pod:2503 msgid "" "The header contains the procedure number (C<guestfs_proc>) which is how the " "receiver knows what type of args structure to expect, or none at all." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2484 +#: ../src/guestfs.pod:2507 msgid "" "For functions that take optional arguments, the optional arguments are " "encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary " @@ -40289,12 +40548,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2492 +#: ../src/guestfs.pod:2515 msgid "The reply message for ordinary functions is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2494 +#: ../src/guestfs.pod:2517 #, no-wrap msgid "" " total length (header + ret,\n" @@ -40305,26 +40564,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2499 +#: ../src/guestfs.pod:2522 msgid "" "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for " "functions that return no formal return values." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2502 +#: ../src/guestfs.pod:2525 msgid "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2505 +#: ../src/guestfs.pod:2528 msgid "" "In the case of an error, a flag is set in the header, and the reply message " "is slightly changed:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2508 +#: ../src/guestfs.pod:2531 #, no-wrap msgid "" " total length (header + error,\n" @@ -40335,19 +40594,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2513 +#: ../src/guestfs.pod:2536 msgid "" "The C<guestfs_message_error> structure contains the error message as a " "string." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2516 +#: ../src/guestfs.pod:2539 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2518 +#: ../src/guestfs.pod:2541 msgid "" "A C<FileIn> parameter indicates that we transfer a file I<into> the guest. " "The normal request message is sent (see above). However this is followed by " @@ -40355,7 +40614,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2522 +#: ../src/guestfs.pod:2545 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -40369,12 +40628,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2530 +#: ../src/guestfs.pod:2553 msgid "The \"sequence of chunks\" is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2532 +#: ../src/guestfs.pod:2555 #, no-wrap msgid "" " length of chunk (not including length word itself)\n" @@ -40388,7 +40647,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2540 +#: ../src/guestfs.pod:2563 msgid "" "The final chunk has the C<data_len> field set to zero. Additionally a flag " "is set in the final chunk to indicate either successful completion or early " @@ -40396,7 +40655,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2544 +#: ../src/guestfs.pod:2567 msgid "" "At time of writing there are no functions that have more than one FileIn " "parameter. However this is (theoretically) supported, by sending the " @@ -40405,7 +40664,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2549 +#: ../src/guestfs.pod:2572 msgid "" "Both the library (sender) I<and> the daemon (receiver) may cancel the " "transfer. The library does this by sending a chunk with a special flag set " @@ -40414,7 +40673,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2555 +#: ../src/guestfs.pod:2578 msgid "" "The daemon may also cancel. It does this by writing a special word " "C<GUESTFS_CANCEL_FLAG> to the socket. The library listens for this during " @@ -40426,7 +40685,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2564 +#: ../src/guestfs.pod:2587 msgid "" "This protocol allows the transfer of arbitrary sized files (no 32 bit " "limit), and also files where the size is not known in advance (eg. from " @@ -40436,19 +40695,19 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2570 +#: ../src/guestfs.pod:2593 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2572 +#: ../src/guestfs.pod:2595 msgid "" "The protocol for FileOut parameters is exactly the same as for FileIn " "parameters, but with the roles of daemon and library reversed." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2575 +#: ../src/guestfs.pod:2598 #, no-wrap msgid "" " total length (header + ret,\n" @@ -40462,12 +40721,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2583 +#: ../src/guestfs.pod:2606 msgid "INITIAL MESSAGE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2585 +#: ../src/guestfs.pod:2608 msgid "" "When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) " "which indicates that the guest and daemon is alive. This is what " @@ -40475,12 +40734,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2589 +#: ../src/guestfs.pod:2612 msgid "PROGRESS NOTIFICATION MESSAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2591 +#: ../src/guestfs.pod:2614 msgid "" "The daemon may send progress notification messages at any time. These are " "distinguished by the normal length word being replaced by " @@ -40488,7 +40747,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2595 +#: ../src/guestfs.pod:2618 msgid "" "The library turns them into progress callbacks (see " "L</GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards " @@ -40496,7 +40755,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2599 +#: ../src/guestfs.pod:2622 msgid "" "The daemon self-limits the frequency of progress messages it sends (see " "C<daemon/proto.c:notify_progress>). Not all calls generate progress " @@ -40504,12 +40763,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2603 +#: ../src/guestfs.pod:2626 msgid "LIBGUESTFS VERSION NUMBERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2605 +#: ../src/guestfs.pod:2628 msgid "" "Since April 2010, libguestfs has started to make separate development and " "stable releases, along with corresponding branches in our git repository. " @@ -40517,7 +40776,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2610 +#: ../src/guestfs.pod:2633 #, no-wrap msgid "" " even numbers for stable: 1.2.x, 1.4.x, ...\n" @@ -40534,12 +40793,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2621 +#: ../src/guestfs.pod:2644 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2623 +#: ../src/guestfs.pod:2646 msgid "" "As time passes we cherry pick fixes from the development branch and backport " "those into the stable branch, the effect being that the stable branch should " @@ -40549,26 +40808,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2629 +#: ../src/guestfs.pod:2652 msgid "Our criteria for backporting changes are:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2635 +#: ../src/guestfs.pod:2658 msgid "" "Documentation changes which don't affect any code are backported unless the " "documentation refers to a future feature which is not in stable." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2641 +#: ../src/guestfs.pod:2664 msgid "" "Bug fixes which are not controversial, fix obvious problems, and have been " "well tested are backported." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2646 +#: ../src/guestfs.pod:2669 msgid "" "Simple rearrangements of code which shouldn't affect how it works get " "backported. This is so that the code in the two branches doesn't get too " @@ -40576,7 +40835,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2652 +#: ../src/guestfs.pod:2675 msgid "" "We I<don't> backport new features, new APIs, new tools etc, except in one " "exceptional case: the new feature is required in order to implement an " @@ -40584,7 +40843,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2658 +#: ../src/guestfs.pod:2681 msgid "" "A new stable branch starts when we think the new features in development are " "substantial and compelling enough over the current stable branch to warrant " @@ -40595,17 +40854,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2666 +#: ../src/guestfs.pod:2689 msgid "EXTENDING LIBGUESTFS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2668 +#: ../src/guestfs.pod:2691 msgid "ADDING A NEW API ACTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2670 +#: ../src/guestfs.pod:2693 msgid "" "Large amounts of boilerplate code in libguestfs (RPC, bindings, " "documentation) are generated, and this makes it easy to extend the " @@ -40613,19 +40872,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2674 +#: ../src/guestfs.pod:2697 msgid "To add a new API action there are two changes:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2680 +#: ../src/guestfs.pod:2703 msgid "" "You need to add a description of the call (name, parameters, return type, " "tests, documentation) to C<generator/generator_actions.ml>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2683 +#: ../src/guestfs.pod:2706 msgid "" "There are two sorts of API action, depending on whether the call goes " "through to the daemon in the appliance, or is serviced entirely by the " @@ -40636,7 +40895,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2691 +#: ../src/guestfs.pod:2714 msgid "" "Most new actions are of the first type, and get added to the " "C<daemon_functions> list. Each function has a unique procedure number used " @@ -40646,7 +40905,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2697 +#: ../src/guestfs.pod:2720 msgid "" "For library-only actions of the second type, add to the " "C<non_daemon_functions> list. Since these functions are serviced by the " @@ -40656,36 +40915,36 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2705 +#: ../src/guestfs.pod:2728 msgid "Implement the action (in C):" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2707 +#: ../src/guestfs.pod:2730 msgid "" "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the " "C<daemon/> directory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2710 +#: ../src/guestfs.pod:2733 msgid "" "For library actions, implement the function C<guestfs__E<lt>nameE<gt>> " "(note: double underscore) in the C<src/> directory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2713 +#: ../src/guestfs.pod:2736 msgid "In either case, use another function as an example of what to do." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2717 +#: ../src/guestfs.pod:2740 msgid "After making these changes, use C<make> to compile." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2719 +#: ../src/guestfs.pod:2742 msgid "" "Note that you don't need to implement the RPC, language bindings, manual " "pages or anything else. It's all automatically generated from the OCaml " @@ -40693,12 +40952,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2723 +#: ../src/guestfs.pod:2746 msgid "ADDING TESTS FOR AN API ACTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2725 +#: ../src/guestfs.pod:2748 msgid "" "You can supply zero or as many tests as you want per API call. The tests " "can either be added as part of the API description " @@ -40708,61 +40967,61 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2732 +#: ../src/guestfs.pod:2755 msgid "" "The following describes the test environment used when you add an API test " "in C<generator_actions.ml>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2735 +#: ../src/guestfs.pod:2758 msgid "The test environment has 4 block devices:" msgstr "" #. type: =item -#: ../src/guestfs.pod:2739 +#: ../src/guestfs.pod:2762 msgid "C</dev/sda> 500MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2741 +#: ../src/guestfs.pod:2764 msgid "General block device for testing." msgstr "" #. type: =item -#: ../src/guestfs.pod:2743 +#: ../src/guestfs.pod:2766 msgid "C</dev/sdb> 50MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2745 +#: ../src/guestfs.pod:2768 msgid "" "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write " "operations." msgstr "" #. type: =item -#: ../src/guestfs.pod:2748 +#: ../src/guestfs.pod:2771 msgid "C</dev/sdc> 10MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2750 +#: ../src/guestfs.pod:2773 msgid "Used in a few tests where two block devices are needed." msgstr "" #. type: =item -#: ../src/guestfs.pod:2752 +#: ../src/guestfs.pod:2775 msgid "C</dev/sdd>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2754 +#: ../src/guestfs.pod:2777 msgid "ISO with fixed content (see C<images/test.iso>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2758 +#: ../src/guestfs.pod:2781 msgid "" "To be able to run the tests in a reasonable amount of time, the libguestfs " "appliance and block devices are reused between tests. So don't try testing " @@ -40770,7 +41029,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2762 +#: ../src/guestfs.pod:2785 msgid "" "Each test starts with an initial scenario, selected using one of the " "C<Init*> expressions, described in C<generator/generator_types.ml>. These " @@ -40780,7 +41039,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2768 +#: ../src/guestfs.pod:2791 msgid "" "You can add a prerequisite clause to any individual test. This is a " "run-time check, which, if it fails, causes the test to be skipped. Useful " @@ -40790,14 +41049,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2774 +#: ../src/guestfs.pod:2797 msgid "" "In addition, packagers can skip individual tests by setting environment " "variables before running C<make check>." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2777 +#: ../src/guestfs.pod:2800 #, no-wrap msgid "" " SKIP_TEST_<CMD>_<NUM>=1\n" @@ -40805,12 +41064,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2779 +#: ../src/guestfs.pod:2802 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2783 +#: ../src/guestfs.pod:2806 #, no-wrap msgid "" " SKIP_TEST_<CMD>=1\n" @@ -40818,17 +41077,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2785 +#: ../src/guestfs.pod:2808 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2787 +#: ../src/guestfs.pod:2810 msgid "Packagers can run only certain tests by setting for example:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2789 +#: ../src/guestfs.pod:2812 #, no-wrap msgid "" " TEST_ONLY=\"vfs_type zerofree\"\n" @@ -40836,29 +41095,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2791 +#: ../src/guestfs.pod:2814 msgid "" "See C<tests/c-api/tests.c> for more details of how these environment " "variables work." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2794 +#: ../src/guestfs.pod:2817 msgid "DEBUGGING NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2796 +#: ../src/guestfs.pod:2819 msgid "Test new actions work before submitting them." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2798 +#: ../src/guestfs.pod:2821 msgid "You can use guestfish to try out new commands." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2800 +#: ../src/guestfs.pod:2823 msgid "" "Debugging the daemon is a problem because it runs inside a minimal " "environment. However you can fprintf messages in the daemon to stderr, and " @@ -40866,12 +41125,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2804 +#: ../src/guestfs.pod:2827 msgid "FORMATTING CODE AND OTHER CONVENTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2806 +#: ../src/guestfs.pod:2829 msgid "" "Our C source code generally adheres to some basic code-formatting " "conventions. The existing code base is not totally consistent on this " @@ -40881,14 +41140,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2812 +#: ../src/guestfs.pod:2835 msgid "" "If you use Emacs, add the following to one of one of your start-up files " "(e.g., ~/.emacs), to help ensure that you get indentation right:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2815 +#: ../src/guestfs.pod:2838 #, no-wrap msgid "" " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n" @@ -40904,7 +41163,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2825 +#: ../src/guestfs.pod:2848 #, no-wrap msgid "" " ;;; When editing C sources in libguestfs, use this style.\n" @@ -40922,12 +41181,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2837 +#: ../src/guestfs.pod:2860 msgid "Enable warnings when compiling (and fix any problems this finds):" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2840 +#: ../src/guestfs.pod:2863 #, no-wrap msgid "" " ./configure --enable-gcc-warnings\n" @@ -40935,12 +41194,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2842 +#: ../src/guestfs.pod:2865 msgid "Useful targets are:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2844 +#: ../src/guestfs.pod:2867 #, no-wrap msgid "" " make syntax-check # checks the syntax of the C code\n" @@ -40949,43 +41208,43 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2847 +#: ../src/guestfs.pod:2870 msgid "DAEMON CUSTOM PRINTF FORMATTERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2849 +#: ../src/guestfs.pod:2872 msgid "" "In the daemon code we have created custom printf formatters C<%Q> and C<%R>, " "which are used to do shell quoting." msgstr "" #. type: =item -#: ../src/guestfs.pod:2854 +#: ../src/guestfs.pod:2877 msgid "%Q" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2856 +#: ../src/guestfs.pod:2879 msgid "" "Simple shell quoted string. Any spaces or other shell characters are " "escaped for you." msgstr "" #. type: =item -#: ../src/guestfs.pod:2859 +#: ../src/guestfs.pod:2882 msgid "%R" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2861 +#: ../src/guestfs.pod:2884 msgid "" "Same as C<%Q> except the string is treated as a path which is prefixed by " "the sysroot." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2868 +#: ../src/guestfs.pod:2891 #, no-wrap msgid "" " asprintf (&cmd, \"cat %R\", path);\n" @@ -40993,12 +41252,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2870 +#: ../src/guestfs.pod:2893 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2872 +#: ../src/guestfs.pod:2895 msgid "" "I<Note:> Do I<not> use these when you are passing parameters to the " "C<command{,r,v,rv}()> functions. These parameters do NOT need to be quoted " @@ -41007,12 +41266,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2878 +#: ../src/guestfs.pod:2901 msgid "SUBMITTING YOUR NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2880 +#: ../src/guestfs.pod:2903 msgid "" "Submit patches to the mailing list: " "L<http://www.redhat.com/mailman/listinfo/libguestfs> and CC to " @@ -41020,17 +41279,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2884 +#: ../src/guestfs.pod:2907 msgid "INTERNATIONALIZATION (I18N) SUPPORT" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2886 +#: ../src/guestfs.pod:2909 msgid "We support i18n (gettext anyhow) in the library." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2888 +#: ../src/guestfs.pod:2911 msgid "" "However many messages come from the daemon, and we don't translate those at " "the moment. One reason is that the appliance generally has all locale files " @@ -41039,115 +41298,115 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2894 +#: ../src/guestfs.pod:2917 msgid "" "Debugging messages are never translated, since they are intended for the " "programmers." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2897 +#: ../src/guestfs.pod:2920 msgid "SOURCE CODE SUBDIRECTORIES" msgstr "" #. type: =item -#: ../src/guestfs.pod:2901 +#: ../src/guestfs.pod:2924 msgid "C<align>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2903 +#: ../src/guestfs.pod:2926 msgid "L<virt-alignment-scan(1)> command and documentation." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2907 +#: ../src/guestfs.pod:2930 msgid "The libguestfs appliance, build scripts and so on." msgstr "" #. type: =item -#: ../src/guestfs.pod:2909 +#: ../src/guestfs.pod:2932 msgid "C<cat>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2911 +#: ../src/guestfs.pod:2934 msgid "" "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and " "documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2914 +#: ../src/guestfs.pod:2937 msgid "C<clone>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2916 +#: ../src/guestfs.pod:2939 msgid "" "Tools for cloning virtual machines. Currently contains L<virt-sysprep(1)> " "command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2919 +#: ../src/guestfs.pod:2942 msgid "C<contrib>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2921 +#: ../src/guestfs.pod:2944 msgid "Outside contributions, experimental parts." msgstr "" #. type: =item -#: ../src/guestfs.pod:2923 +#: ../src/guestfs.pod:2946 msgid "C<daemon>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2925 +#: ../src/guestfs.pod:2948 msgid "" "The daemon that runs inside the libguestfs appliance and carries out " "actions." msgstr "" #. type: =item -#: ../src/guestfs.pod:2928 +#: ../src/guestfs.pod:2951 msgid "C<df>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2930 +#: ../src/guestfs.pod:2953 msgid "L<virt-df(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2932 +#: ../src/guestfs.pod:2955 msgid "C<edit>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2934 +#: ../src/guestfs.pod:2957 msgid "L<virt-edit(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2936 +#: ../src/guestfs.pod:2959 msgid "C<examples>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2938 +#: ../src/guestfs.pod:2961 msgid "C API example code." msgstr "" #. type: =item -#: ../src/guestfs.pod:2940 +#: ../src/guestfs.pod:2963 msgid "C<fish>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2942 +#: ../src/guestfs.pod:2965 msgid "" "L<guestfish(1)>, the command-line shell, and various shell scripts built on " "top such as L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, " @@ -41155,79 +41414,79 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2948 +#: ../src/guestfs.pod:2971 msgid "L<virt-format(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2950 +#: ../src/guestfs.pod:2973 msgid "C<fuse>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2952 +#: ../src/guestfs.pod:2975 msgid "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:2954 +#: ../src/guestfs.pod:2977 msgid "C<generator>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2956 +#: ../src/guestfs.pod:2979 msgid "" "The crucially important generator, used to automatically generate large " "amounts of boilerplate C code for things like RPC and bindings." msgstr "" #. type: =item -#: ../src/guestfs.pod:2959 +#: ../src/guestfs.pod:2982 msgid "C<inspector>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2961 +#: ../src/guestfs.pod:2984 msgid "L<virt-inspector(1)>, the virtual machine image inspector." msgstr "" #. type: =item -#: ../src/guestfs.pod:2963 +#: ../src/guestfs.pod:2986 msgid "C<logo>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2965 +#: ../src/guestfs.pod:2988 msgid "Logo used on the website. The fish is called Arthur by the way." msgstr "" #. type: =item -#: ../src/guestfs.pod:2967 +#: ../src/guestfs.pod:2990 msgid "C<m4>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2969 +#: ../src/guestfs.pod:2992 msgid "M4 macros used by autoconf." msgstr "" #. type: =item -#: ../src/guestfs.pod:2971 +#: ../src/guestfs.pod:2994 msgid "C<po>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2973 +#: ../src/guestfs.pod:2996 msgid "Translations of simple gettext strings." msgstr "" #. type: =item -#: ../src/guestfs.pod:2975 +#: ../src/guestfs.pod:2998 msgid "C<po-docs>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2977 +#: ../src/guestfs.pod:3000 msgid "" "The build infrastructure and PO files for translations of manpages and POD " "files. Eventually this will be combined with the C<po> directory, but that " @@ -41235,139 +41494,139 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2981 +#: ../src/guestfs.pod:3004 msgid "C<rescue>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2983 +#: ../src/guestfs.pod:3006 msgid "L<virt-rescue(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2985 +#: ../src/guestfs.pod:3008 msgid "C<resize>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2987 +#: ../src/guestfs.pod:3010 msgid "L<virt-resize(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2989 +#: ../src/guestfs.pod:3012 msgid "C<sparsify>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2991 +#: ../src/guestfs.pod:3014 msgid "L<virt-sparsify(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2993 +#: ../src/guestfs.pod:3016 msgid "C<src>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2995 +#: ../src/guestfs.pod:3018 msgid "Source code to the C library." msgstr "" #. type: =item -#: ../src/guestfs.pod:2997 +#: ../src/guestfs.pod:3020 msgid "C<test-tool>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2999 +#: ../src/guestfs.pod:3022 msgid "" "Test tool for end users to test if their qemu/kernel combination will work " "with libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:3002 +#: ../src/guestfs.pod:3025 msgid "C<tests>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3004 +#: ../src/guestfs.pod:3027 msgid "Tests." msgstr "" #. type: =item -#: ../src/guestfs.pod:3006 +#: ../src/guestfs.pod:3029 msgid "C<tools>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3008 +#: ../src/guestfs.pod:3031 msgid "Command line tools written in Perl (L<virt-win-reg(1)> and many others)." msgstr "" #. type: =item -#: ../src/guestfs.pod:3010 +#: ../src/guestfs.pod:3033 msgid "C<csharp>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3012 +#: ../src/guestfs.pod:3035 msgid "C<erlang>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3014 +#: ../src/guestfs.pod:3037 msgid "C<gobject>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3016 +#: ../src/guestfs.pod:3039 msgid "C<haskell>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3018 +#: ../src/guestfs.pod:3041 msgid "C<java>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3020 +#: ../src/guestfs.pod:3043 msgid "C<ocaml>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3022 +#: ../src/guestfs.pod:3045 msgid "C<php>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3024 +#: ../src/guestfs.pod:3047 msgid "C<perl>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3026 +#: ../src/guestfs.pod:3049 msgid "C<python>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3028 +#: ../src/guestfs.pod:3051 msgid "C<ruby>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3030 +#: ../src/guestfs.pod:3053 msgid "Language bindings." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3034 +#: ../src/guestfs.pod:3057 msgid "MAKING A STABLE RELEASE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3036 +#: ../src/guestfs.pod:3059 msgid "" "When we make a stable release, there are several steps documented here. See " "L</LIBGUESTFS VERSION NUMBERS> for general information about the stable " @@ -41375,32 +41634,32 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3044 +#: ../src/guestfs.pod:3067 msgid "Check C<make && make check> works on at least Fedora, Debian and Ubuntu." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3049 +#: ../src/guestfs.pod:3072 msgid "Finalize RELEASE-NOTES." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3053 +#: ../src/guestfs.pod:3076 msgid "Update ROADMAP." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3057 +#: ../src/guestfs.pod:3080 msgid "Run C<src/api-support/update-from-tarballs.sh>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3061 +#: ../src/guestfs.pod:3084 msgid "Push and pull from Transifex." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3065 +#: ../src/guestfs.pod:3088 #, no-wrap msgid "" " tx push -s\n" @@ -41408,12 +41667,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3067 +#: ../src/guestfs.pod:3090 msgid "to push the latest POT files to Transifex. Then run:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3069 +#: ../src/guestfs.pod:3092 #, no-wrap msgid "" " ./tx-pull.sh\n" @@ -41421,24 +41680,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3071 +#: ../src/guestfs.pod:3094 msgid "which is a wrapper to pull the latest translated C<*.po> files." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3075 +#: ../src/guestfs.pod:3098 msgid "" "Create new stable and development directories under " "L<http://libguestfs.org/download>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3080 +#: ../src/guestfs.pod:3103 msgid "Create the branch in git:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3082 +#: ../src/guestfs.pod:3105 #, no-wrap msgid "" " git tag -a 1.XX.0 -m \"Version 1.XX.0 (stable)\"\n" @@ -41449,17 +41708,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:3089 +#: ../src/guestfs.pod:3112 msgid "LIMITS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3091 +#: ../src/guestfs.pod:3114 msgid "PROTOCOL LIMITS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3093 +#: ../src/guestfs.pod:3116 msgid "" "Internally libguestfs uses a message-based protocol to pass API calls and " "their responses to and from a small \"appliance\" (see L</INTERNALS> for " @@ -41470,7 +41729,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3101 +#: ../src/guestfs.pod:3124 msgid "" "A simple call such as L</guestfs_cat> returns its result (the file data) in " "a simple string. Because this string is at some point internally encoded as " @@ -41479,7 +41738,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3107 +#: ../src/guestfs.pod:3130 msgid "" "In order to transfer large files into and out of the guest filesystem, you " "need to use particular calls that support this. The sections L</UPLOADING> " @@ -41487,24 +41746,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3111 +#: ../src/guestfs.pod:3134 msgid "" "You might also consider mounting the disk image using our FUSE filesystem " "support (L<guestmount(1)>)." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3114 +#: ../src/guestfs.pod:3137 msgid "MAXIMUM NUMBER OF DISKS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3116 +#: ../src/guestfs.pod:3139 msgid "When using virtio disks (the default) the current limit is B<25> disks." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3119 +#: ../src/guestfs.pod:3142 msgid "" "Virtio itself consumes 1 virtual PCI slot per disk, and PCI is limited to 31 " "slots. However febootstrap only understands disks with names C</dev/vda> " @@ -41513,14 +41772,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3124 +#: ../src/guestfs.pod:3147 msgid "" "We are working to substantially raise this limit in future versions but it " "requires complex changes to qemu." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3127 +#: ../src/guestfs.pod:3150 msgid "" "In future versions of libguestfs it should also be possible to \"hot plug\" " "disks (add and remove disks after calling L</guestfs_launch>). This also " @@ -41528,41 +41787,41 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3131 +#: ../src/guestfs.pod:3154 msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3133 +#: ../src/guestfs.pod:3156 msgid "Virtio limits the maximum number of partitions per disk to B<15>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3135 +#: ../src/guestfs.pod:3158 msgid "" "This is because it reserves 4 bits for the minor device number (thus " "C</dev/vda>, and C</dev/vda1> through C</dev/vda15>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3138 +#: ../src/guestfs.pod:3161 msgid "" "If you attach a disk with more than 15 partitions, the extra partitions are " "ignored by libguestfs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3141 +#: ../src/guestfs.pod:3164 msgid "MAXIMUM SIZE OF A DISK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3143 +#: ../src/guestfs.pod:3166 msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3145 +#: ../src/guestfs.pod:3168 msgid "" "We have tested block devices up to 1 exabyte (2**60 or " "1,152,921,504,606,846,976 bytes) using sparse files backed by an XFS host " @@ -41570,7 +41829,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3149 +#: ../src/guestfs.pod:3172 msgid "" "Although libguestfs probably does not impose any limit, the underlying host " "storage will. If you store disk images on a host ext4 filesystem, then the " @@ -41580,19 +41839,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3155 +#: ../src/guestfs.pod:3178 msgid "" "For the hugest disk image files, we recommend using XFS on the host for " "storage." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3158 +#: ../src/guestfs.pod:3181 msgid "MAXIMUM SIZE OF A PARTITION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3160 +#: ../src/guestfs.pod:3183 msgid "" "The MBR (ie. classic MS-DOS) partitioning scheme uses 32 bit sector " "numbers. Assuming a 512 byte sector size, this means that MBR cannot " @@ -41600,7 +41859,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3164 +#: ../src/guestfs.pod:3187 msgid "" "It is recommended that you use GPT partitions on disks which are larger than " "this size. GPT uses 64 bit sector numbers and so can address partitions " @@ -41608,12 +41867,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3169 +#: ../src/guestfs.pod:3192 msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3171 +#: ../src/guestfs.pod:3194 msgid "" "This depends on the filesystem type. libguestfs itself does not impose any " "known limit. Consult Wikipedia or the filesystem documentation to find out " @@ -41621,12 +41880,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3175 +#: ../src/guestfs.pod:3198 msgid "MAXIMUM UPLOAD AND DOWNLOAD" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3177 +#: ../src/guestfs.pod:3200 msgid "" "The API functions L</guestfs_upload>, L</guestfs_download>, " "L</guestfs_tar_in>, L</guestfs_tar_out> and the like allow unlimited sized " @@ -41634,12 +41893,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3181 +#: ../src/guestfs.pod:3204 msgid "INSPECTION LIMITS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3183 +#: ../src/guestfs.pod:3206 msgid "" "The inspection code has several arbitrary limits on things like the size of " "Windows Registry hive it will read, and the length of product name. These " @@ -41649,33 +41908,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3209 +#: ../src/guestfs.pod:3232 msgid "" "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages. This has the same " "effect as calling C<guestfs_set_verbose (g, 1)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3221 +#: ../src/guestfs.pod:3244 msgid "" "Set the path that libguestfs uses to search for a supermin appliance. See " "the discussion of paths in section L</PATH> above." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3230 +#: ../src/guestfs.pod:3253 msgid "See also L</QEMU WRAPPERS> above." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3234 +#: ../src/guestfs.pod:3257 msgid "" "Set C<LIBGUESTFS_TRACE=1> to enable command traces. This has the same " "effect as calling C<guestfs_set_trace (g, 1)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3252 +#: ../src/guestfs.pod:3275 msgid "" "L<guestfs-examples(3)>, L<guestfs-erlang(3)>, L<guestfs-java(3)>, " "L<guestfs-ocaml(3)>, L<guestfs-perl(3)>, L<guestfs-python(3)>, " @@ -41692,59 +41951,59 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3291 +#: ../src/guestfs.pod:3314 msgid "" "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, " "L<lvm(8)>, L<disktype(1)>." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:3298 ../tools/virt-make-fs.pl:595 ../tools/virt-win-reg.pl:772 +#: ../src/guestfs.pod:3321 ../tools/virt-make-fs.pl:594 ../tools/virt-win-reg.pl:772 msgid "BUGS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3300 +#: ../src/guestfs.pod:3323 msgid "To get a list of bugs against libguestfs use this link:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3302 +#: ../src/guestfs.pod:3325 msgid "L<https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3304 +#: ../src/guestfs.pod:3327 msgid "To report a new bug against libguestfs use this link:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3306 +#: ../src/guestfs.pod:3329 msgid "L<https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3308 +#: ../src/guestfs.pod:3331 msgid "When reporting a bug, please check:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3314 +#: ../src/guestfs.pod:3337 msgid "That the bug hasn't been reported already." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3318 +#: ../src/guestfs.pod:3341 msgid "That you are testing a recent version." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3322 +#: ../src/guestfs.pod:3345 msgid "Describe the bug accurately, and give a way to reproduce it." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3326 +#: ../src/guestfs.pod:3349 msgid "" "Run libguestfs-test-tool and paste the B<complete, unedited> output into the " "bug report." @@ -42024,7 +42283,7 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-list-filesystems.pl:216 ../tools/virt-tar.pl:317 +#: ../tools/virt-list-filesystems.pl:216 ../tools/virt-tar.pl:315 msgid "Copyright (C) 2009 Red Hat Inc." msgstr "" @@ -42510,7 +42769,7 @@ msgid "For MBR, virt-make-fs sets the partition type byte automatically." msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:582 +#: ../tools/virt-make-fs.pl:581 msgid "" "L<guestfish(1)>, L<virt-format(1)>, L<virt-resize(1)>, L<virt-tar-in(1)>, " "L<mkisofs(1)>, L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, " @@ -42519,14 +42778,14 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:597 ../tools/virt-win-reg.pl:774 +#: ../tools/virt-make-fs.pl:596 ../tools/virt-win-reg.pl:774 msgid "" "When reporting bugs, please enable debugging and capture the I<complete> " "output:" msgstr "" #. type: verbatim -#: ../tools/virt-make-fs.pl:600 +#: ../tools/virt-make-fs.pl:599 #, no-wrap msgid "" " export LIBGUESTFS_DEBUG=1\n" @@ -42535,7 +42794,7 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:603 +#: ../tools/virt-make-fs.pl:602 msgid "" "Attach /tmp/virt-make-fs.log to a new bug report at " "L<https://bugzilla.redhat.com/>" @@ -42743,7 +43002,7 @@ msgid "Specify that the input or output tarball is gzip-compressed." msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:298 +#: ../tools/virt-tar.pl:296 msgid "" "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, " "L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, " |