diff options
Diffstat (limited to 'po-docs/libguestfs-docs.pot')
| -rw-r--r-- | po-docs/libguestfs-docs.pot | 7230 |
1 files changed, 3660 insertions, 3570 deletions
diff --git a/po-docs/libguestfs-docs.pot b/po-docs/libguestfs-docs.pot index a4aba9d7..89bc1793 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.19.42\n" +"Project-Id-Version: libguestfs 1.19.43\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2012-09-17 23:05+0200\n" +"POT-Creation-Date: 2012-09-21 15:44+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" @@ -343,7 +343,7 @@ msgid "" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:146 ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337 ../df/virt-df.pod:110 ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242 ../fish/guestfish.pod:689 ../format/virt-format.pod:96 ../inspector/virt-inspector.pod:350 ../rescue/virt-rescue.pod:164 ../src/guestfs.pod:3156 ../sysprep/virt-sysprep.pod:112 +#: ../align/virt-alignment-scan.pod:146 ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337 ../df/virt-df.pod:110 ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242 ../fish/guestfish.pod:689 ../format/virt-format.pod:96 ../inspector/virt-inspector.pod:350 ../rescue/virt-rescue.pod:164 ../src/guestfs.pod:3160 ../sysprep/virt-sysprep.pod:112 msgid "For example:" msgstr "" @@ -751,7 +751,7 @@ msgid "This program returns:" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:347 ../align/virt-alignment-scan.pod:353 ../align/virt-alignment-scan.pod:359 ../align/virt-alignment-scan.pod:366 ../appliance/libguestfs-make-fixed-appliance.pod:32 ../appliance/libguestfs-make-fixed-appliance.pod:53 ../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 ../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-faq.pod:150 ../examples/guestfs-faq.pod:156 ../examples/guestfs-faq.pod:195 ../examples/guestfs-faq.pod:201 ../examples/guestfs-performance.pod:107 ../examples/guestfs-performance.pod:113 ../examples/guestfs-performance.pod:118 ../examples/guestfs-performance.pod:253 ../examples/guestfs-performance.pod:258 ../examples/guestfs-performance.pod:263 ../examples/guestfs-recipes.pod:126 ../examples/guestfs-recipes.pod:130 ../examples/guestfs-recipes.pod:134 ../examples/guestfs-recipes.pod:160 ../examples/guestfs-recipes.pod:165 ../examples/guestfs-recipes.pod:255 ../examples/guestfs-recipes.pod:259 ../examples/guestfs-recipes.pod:263 ../examples/guestfs-recipes.pod:267 ../examples/guestfs-recipes.pod:271 ../examples/guestfs-testing.pod:110 ../examples/guestfs-testing.pod:114 ../examples/guestfs-testing.pod:118 ../fish/guestfish-actions.pod:417 ../fish/guestfish-actions.pod:425 ../fish/guestfish-actions.pod:432 ../fish/guestfish-actions.pod:439 ../fish/guestfish-actions.pod:1480 ../fish/guestfish-actions.pod:1484 ../fish/guestfish-actions.pod:1488 ../fish/guestfish-actions.pod:1492 ../fish/guestfish-actions.pod:1500 ../fish/guestfish-actions.pod:1504 ../fish/guestfish-actions.pod:1508 ../fish/guestfish-actions.pod:1518 ../fish/guestfish-actions.pod:1522 ../fish/guestfish-actions.pod:1526 ../fish/guestfish-actions.pod:1637 ../fish/guestfish-actions.pod:1641 ../fish/guestfish-actions.pod:1646 ../fish/guestfish-actions.pod:1688 ../fish/guestfish-actions.pod:1692 ../fish/guestfish-actions.pod:1697 ../fish/guestfish-actions.pod:2143 ../fish/guestfish-actions.pod:2150 ../fish/guestfish-actions.pod:2157 ../fish/guestfish-actions.pod:2727 ../fish/guestfish-actions.pod:2733 ../fish/guestfish-actions.pod:2741 ../fish/guestfish-actions.pod:2748 ../fish/guestfish-actions.pod:2755 ../fish/guestfish.pod:461 ../fish/guestfish.pod:465 ../fish/guestfish.pod:469 ../fish/guestfish.pod:473 ../guestfs-release-notes.pod:82 ../guestfs-release-notes.pod:86 ../guestfs-release-notes.pod:90 ../guestfs-release-notes.pod:94 ../guestfs-release-notes.pod:98 ../guestfs-release-notes.pod:102 ../guestfs-release-notes.pod:107 ../guestfs-release-notes.pod:214 ../guestfs-release-notes.pod:218 ../guestfs-release-notes.pod:222 ../guestfs-release-notes.pod:226 ../guestfs-release-notes.pod:230 ../guestfs-release-notes.pod:234 ../guestfs-release-notes.pod:238 ../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:45 ../sparsify/virt-sparsify.pod:52 ../sparsify/virt-sparsify.pod:56 ../sparsify/virt-sparsify.pod:62 ../sparsify/virt-sparsify.pod:67 ../sparsify/virt-sparsify.pod:72 ../src/guestfs-actions.pod:622 ../src/guestfs-actions.pod:630 ../src/guestfs-actions.pod:637 ../src/guestfs-actions.pod:644 ../src/guestfs-actions.pod:2475 ../src/guestfs-actions.pod:2479 ../src/guestfs-actions.pod:2483 ../src/guestfs-actions.pod:2487 ../src/guestfs-actions.pod:2495 ../src/guestfs-actions.pod:2499 ../src/guestfs-actions.pod:2503 ../src/guestfs-actions.pod:2513 ../src/guestfs-actions.pod:2517 ../src/guestfs-actions.pod:2521 ../src/guestfs-actions.pod:2693 ../src/guestfs-actions.pod:2697 ../src/guestfs-actions.pod:2702 ../src/guestfs-actions.pod:2763 ../src/guestfs-actions.pod:2767 ../src/guestfs-actions.pod:2772 ../src/guestfs-actions.pod:3471 ../src/guestfs-actions.pod:3478 ../src/guestfs-actions.pod:3485 ../src/guestfs-actions.pod:4310 ../src/guestfs-actions.pod:4316 ../src/guestfs-actions.pod:4324 ../src/guestfs-actions.pod:4331 ../src/guestfs-actions.pod:4338 ../src/guestfs.pod:388 ../src/guestfs.pod:393 ../src/guestfs.pod:398 ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411 ../src/guestfs.pod:416 ../src/guestfs.pod:421 ../src/guestfs.pod:1202 ../src/guestfs.pod:1206 ../src/guestfs.pod:1210 ../src/guestfs.pod:1215 ../src/guestfs.pod:1223 ../src/guestfs.pod:1242 ../src/guestfs.pod:1250 ../src/guestfs.pod:1267 ../src/guestfs.pod:1272 ../src/guestfs.pod:1276 ../src/guestfs.pod:1418 ../src/guestfs.pod:1422 ../src/guestfs.pod:1426 ../src/guestfs.pod:1430 ../src/guestfs.pod:1434 ../src/guestfs.pod:1438 ../src/guestfs.pod:1964 ../src/guestfs.pod:1969 ../src/guestfs.pod:1973 ../src/guestfs.pod:2075 ../src/guestfs.pod:2080 ../src/guestfs.pod:2084 ../src/guestfs.pod:2094 ../src/guestfs.pod:2383 ../src/guestfs.pod:2388 ../src/guestfs.pod:2394 ../src/guestfs.pod:2402 ../src/guestfs.pod:2919 ../src/guestfs.pod:2925 ../src/guestfs.pod:2930 ../src/guestfs.pod:2936 ../src/guestfs.pod:3343 ../src/guestfs.pod:3348 ../src/guestfs.pod:3352 ../src/guestfs.pod:3356 ../src/guestfs.pod:3360 ../src/guestfs.pod:3374 ../src/guestfs.pod:3379 ../sysprep/virt-sysprep.pod:231 ../sysprep/virt-sysprep.pod:235 ../sysprep/virt-sysprep.pod:239 ../sysprep/virt-sysprep.pod:243 ../sysprep/virt-sysprep.pod:258 ../sysprep/virt-sysprep.pod:262 ../sysprep/virt-sysprep.pod:266 ../sysprep/virt-sysprep.pod:270 ../sysprep/virt-sysprep.pod:274 ../sysprep/virt-sysprep.pod:327 ../sysprep/virt-sysprep.pod:339 ../sysprep/virt-sysprep.pod:343 ../sysprep/virt-sysprep.pod:351 ../sysprep/virt-sysprep.pod:357 ../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:347 ../align/virt-alignment-scan.pod:353 ../align/virt-alignment-scan.pod:359 ../align/virt-alignment-scan.pod:366 ../appliance/libguestfs-make-fixed-appliance.pod:32 ../appliance/libguestfs-make-fixed-appliance.pod:53 ../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 ../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-faq.pod:150 ../examples/guestfs-faq.pod:156 ../examples/guestfs-faq.pod:195 ../examples/guestfs-faq.pod:201 ../examples/guestfs-performance.pod:107 ../examples/guestfs-performance.pod:113 ../examples/guestfs-performance.pod:118 ../examples/guestfs-performance.pod:253 ../examples/guestfs-performance.pod:258 ../examples/guestfs-performance.pod:263 ../examples/guestfs-recipes.pod:128 ../examples/guestfs-recipes.pod:132 ../examples/guestfs-recipes.pod:136 ../examples/guestfs-recipes.pod:162 ../examples/guestfs-recipes.pod:167 ../examples/guestfs-recipes.pod:257 ../examples/guestfs-recipes.pod:261 ../examples/guestfs-recipes.pod:265 ../examples/guestfs-recipes.pod:269 ../examples/guestfs-recipes.pod:273 ../examples/guestfs-testing.pod:110 ../examples/guestfs-testing.pod:114 ../examples/guestfs-testing.pod:118 ../fish/guestfish-actions.pod:417 ../fish/guestfish-actions.pod:425 ../fish/guestfish-actions.pod:432 ../fish/guestfish-actions.pod:439 ../fish/guestfish-actions.pod:1480 ../fish/guestfish-actions.pod:1484 ../fish/guestfish-actions.pod:1488 ../fish/guestfish-actions.pod:1492 ../fish/guestfish-actions.pod:1500 ../fish/guestfish-actions.pod:1504 ../fish/guestfish-actions.pod:1508 ../fish/guestfish-actions.pod:1518 ../fish/guestfish-actions.pod:1522 ../fish/guestfish-actions.pod:1526 ../fish/guestfish-actions.pod:1637 ../fish/guestfish-actions.pod:1641 ../fish/guestfish-actions.pod:1646 ../fish/guestfish-actions.pod:1688 ../fish/guestfish-actions.pod:1692 ../fish/guestfish-actions.pod:1697 ../fish/guestfish-actions.pod:2143 ../fish/guestfish-actions.pod:2150 ../fish/guestfish-actions.pod:2157 ../fish/guestfish-actions.pod:2735 ../fish/guestfish-actions.pod:2741 ../fish/guestfish-actions.pod:2749 ../fish/guestfish-actions.pod:2756 ../fish/guestfish-actions.pod:2763 ../fish/guestfish.pod:461 ../fish/guestfish.pod:465 ../fish/guestfish.pod:469 ../fish/guestfish.pod:473 ../guestfs-release-notes.pod:82 ../guestfs-release-notes.pod:86 ../guestfs-release-notes.pod:90 ../guestfs-release-notes.pod:94 ../guestfs-release-notes.pod:98 ../guestfs-release-notes.pod:102 ../guestfs-release-notes.pod:107 ../guestfs-release-notes.pod:214 ../guestfs-release-notes.pod:218 ../guestfs-release-notes.pod:222 ../guestfs-release-notes.pod:226 ../guestfs-release-notes.pod:230 ../guestfs-release-notes.pod:234 ../guestfs-release-notes.pod:238 ../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:45 ../sparsify/virt-sparsify.pod:52 ../sparsify/virt-sparsify.pod:56 ../sparsify/virt-sparsify.pod:62 ../sparsify/virt-sparsify.pod:67 ../sparsify/virt-sparsify.pod:72 ../src/guestfs-actions.pod:622 ../src/guestfs-actions.pod:630 ../src/guestfs-actions.pod:637 ../src/guestfs-actions.pod:644 ../src/guestfs-actions.pod:2475 ../src/guestfs-actions.pod:2479 ../src/guestfs-actions.pod:2483 ../src/guestfs-actions.pod:2487 ../src/guestfs-actions.pod:2495 ../src/guestfs-actions.pod:2499 ../src/guestfs-actions.pod:2503 ../src/guestfs-actions.pod:2513 ../src/guestfs-actions.pod:2517 ../src/guestfs-actions.pod:2521 ../src/guestfs-actions.pod:2693 ../src/guestfs-actions.pod:2697 ../src/guestfs-actions.pod:2702 ../src/guestfs-actions.pod:2763 ../src/guestfs-actions.pod:2767 ../src/guestfs-actions.pod:2772 ../src/guestfs-actions.pod:3471 ../src/guestfs-actions.pod:3478 ../src/guestfs-actions.pod:3485 ../src/guestfs-actions.pod:4318 ../src/guestfs-actions.pod:4324 ../src/guestfs-actions.pod:4332 ../src/guestfs-actions.pod:4339 ../src/guestfs-actions.pod:4346 ../src/guestfs.pod:392 ../src/guestfs.pod:397 ../src/guestfs.pod:402 ../src/guestfs.pod:406 ../src/guestfs.pod:411 ../src/guestfs.pod:415 ../src/guestfs.pod:420 ../src/guestfs.pod:425 ../src/guestfs.pod:1206 ../src/guestfs.pod:1210 ../src/guestfs.pod:1214 ../src/guestfs.pod:1219 ../src/guestfs.pod:1227 ../src/guestfs.pod:1246 ../src/guestfs.pod:1254 ../src/guestfs.pod:1271 ../src/guestfs.pod:1276 ../src/guestfs.pod:1280 ../src/guestfs.pod:1422 ../src/guestfs.pod:1426 ../src/guestfs.pod:1430 ../src/guestfs.pod:1434 ../src/guestfs.pod:1438 ../src/guestfs.pod:1442 ../src/guestfs.pod:1968 ../src/guestfs.pod:1973 ../src/guestfs.pod:1977 ../src/guestfs.pod:2079 ../src/guestfs.pod:2084 ../src/guestfs.pod:2088 ../src/guestfs.pod:2098 ../src/guestfs.pod:2387 ../src/guestfs.pod:2392 ../src/guestfs.pod:2398 ../src/guestfs.pod:2406 ../src/guestfs.pod:2923 ../src/guestfs.pod:2929 ../src/guestfs.pod:2934 ../src/guestfs.pod:2940 ../src/guestfs.pod:3347 ../src/guestfs.pod:3352 ../src/guestfs.pod:3356 ../src/guestfs.pod:3360 ../src/guestfs.pod:3364 ../src/guestfs.pod:3378 ../src/guestfs.pod:3383 ../sysprep/virt-sysprep.pod:231 ../sysprep/virt-sysprep.pod:235 ../sysprep/virt-sysprep.pod:239 ../sysprep/virt-sysprep.pod:243 ../sysprep/virt-sysprep.pod:258 ../sysprep/virt-sysprep.pod:262 ../sysprep/virt-sysprep.pod:266 ../sysprep/virt-sysprep.pod:270 ../sysprep/virt-sysprep.pod:274 ../sysprep/virt-sysprep.pod:327 ../sysprep/virt-sysprep.pod:339 ../sysprep/virt-sysprep.pod:343 ../sysprep/virt-sysprep.pod:351 ../sysprep/virt-sysprep.pod:357 ../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 "" @@ -766,7 +766,7 @@ msgid "successful exit, all partitions are aligned E<ge> 64K for best performanc msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:355 ../src/guestfs.pod:1611 +#: ../align/virt-alignment-scan.pod:355 ../src/guestfs.pod:1615 msgid "1" msgstr "" @@ -776,7 +776,7 @@ msgid "an error scanning the disk image or guest" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:361 ../src/guestfs.pod:1615 +#: ../align/virt-alignment-scan.pod:361 ../src/guestfs.pod:1619 msgid "2" msgstr "" @@ -788,7 +788,7 @@ msgid "" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:368 ../src/guestfs.pod:1619 +#: ../align/virt-alignment-scan.pod:368 ../src/guestfs.pod:1623 msgid "3" msgstr "" @@ -800,7 +800,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:375 ../appliance/libguestfs-make-fixed-appliance.pod:144 ../cat/virt-cat.pod:243 ../cat/virt-filesystems.pod:389 ../cat/virt-ls.pod:495 ../df/virt-df.pod:253 ../edit/virt-edit.pod:368 ../erlang/examples/guestfs-erlang.pod:97 ../examples/guestfs-examples.pod:33 ../examples/guestfs-faq.pod:723 ../examples/guestfs-performance.pod:429 ../examples/guestfs-recipes.pod:420 ../examples/guestfs-testing.pod:291 ../fish/guestfish.pod:1289 ../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:398 ../guestfs-release-notes.pod:1711 ../inspector/virt-inspector.pod:501 ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:40 ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:340 ../resize/virt-resize.pod:702 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:299 ../src/guestfs.pod:3579 ../sysprep/virt-sysprep.pod:480 ../test-tool/libguestfs-test-tool.pod:106 ../tools/virt-list-filesystems.pl:197 ../tools/virt-list-partitions.pl:267 ../tools/virt-make-fs.pl:627 ../tools/virt-tar.pl:294 ../tools/virt-win-reg.pl:757 +#: ../align/virt-alignment-scan.pod:375 ../appliance/libguestfs-make-fixed-appliance.pod:144 ../cat/virt-cat.pod:243 ../cat/virt-filesystems.pod:389 ../cat/virt-ls.pod:495 ../df/virt-df.pod:253 ../edit/virt-edit.pod:368 ../erlang/examples/guestfs-erlang.pod:97 ../examples/guestfs-examples.pod:33 ../examples/guestfs-faq.pod:723 ../examples/guestfs-performance.pod:429 ../examples/guestfs-recipes.pod:444 ../examples/guestfs-testing.pod:291 ../fish/guestfish.pod:1289 ../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:398 ../guestfs-release-notes.pod:1711 ../inspector/virt-inspector.pod:501 ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:40 ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:340 ../resize/virt-resize.pod:702 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:299 ../src/guestfs.pod:3583 ../sysprep/virt-sysprep.pod:480 ../test-tool/libguestfs-test-tool.pod:106 ../tools/virt-list-filesystems.pl:197 ../tools/virt-list-partitions.pl:267 ../tools/virt-make-fs.pl:627 ../tools/virt-tar.pl:294 ../tools/virt-win-reg.pl:757 msgid "SEE ALSO" msgstr "" @@ -822,7 +822,7 @@ msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:388 ../appliance/libguestfs-make-fixed-appliance.pod:157 ../cat/virt-cat.pod:256 ../cat/virt-filesystems.pod:404 ../cat/virt-ls.pod:511 ../df/virt-df.pod:265 ../edit/virt-edit.pod:386 ../erlang/examples/guestfs-erlang.pod:114 ../examples/guestfs-examples.pod:49 ../examples/guestfs-faq.pod:733 ../examples/guestfs-performance.pod:446 ../examples/guestfs-recipes.pod:437 ../examples/guestfs-testing.pod:302 ../fish/guestfish.pod:1321 ../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:413 ../guestfs-release-notes.pod:1726 ../inspector/virt-inspector.pod:524 ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:57 ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:353 ../resize/virt-resize.pod:729 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:316 ../src/guestfs.pod:3634 ../sysprep/virt-sysprep.pod:501 ../test-tool/libguestfs-test-tool.pod:116 ../tools/virt-list-filesystems.pl:214 ../tools/virt-list-partitions.pl:283 ../tools/virt-make-fs.pl:646 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:776 +#: ../align/virt-alignment-scan.pod:388 ../appliance/libguestfs-make-fixed-appliance.pod:157 ../cat/virt-cat.pod:256 ../cat/virt-filesystems.pod:404 ../cat/virt-ls.pod:511 ../df/virt-df.pod:265 ../edit/virt-edit.pod:386 ../erlang/examples/guestfs-erlang.pod:114 ../examples/guestfs-examples.pod:49 ../examples/guestfs-faq.pod:733 ../examples/guestfs-performance.pod:446 ../examples/guestfs-recipes.pod:461 ../examples/guestfs-testing.pod:302 ../fish/guestfish.pod:1321 ../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:413 ../guestfs-release-notes.pod:1726 ../inspector/virt-inspector.pod:524 ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:57 ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:353 ../resize/virt-resize.pod:729 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:316 ../src/guestfs.pod:3639 ../sysprep/virt-sysprep.pod:501 ../test-tool/libguestfs-test-tool.pod:116 ../tools/virt-list-filesystems.pl:214 ../tools/virt-list-partitions.pl:283 ../tools/virt-make-fs.pl:646 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:776 msgid "COPYRIGHT" msgstr "" @@ -1078,7 +1078,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../appliance/libguestfs-make-fixed-appliance.pod:139 ../edit/virt-edit.pod:343 ../fish/guestfish.pod:1135 ../rescue/virt-rescue.pod:313 ../sparsify/virt-sparsify.pod:272 ../src/guestfs.pod:3513 ../test-tool/libguestfs-test-tool.pod:101 +#: ../appliance/libguestfs-make-fixed-appliance.pod:139 ../edit/virt-edit.pod:343 ../fish/guestfish.pod:1135 ../rescue/virt-rescue.pod:313 ../sparsify/virt-sparsify.pod:272 ../src/guestfs.pod:3517 ../test-tool/libguestfs-test-tool.pod:101 msgid "ENVIRONMENT VARIABLES" msgstr "" @@ -1097,17 +1097,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../appliance/libguestfs-make-fixed-appliance.pod:153 ../erlang/examples/guestfs-erlang.pod:110 ../examples/guestfs-examples.pod:45 ../examples/guestfs-faq.pod:729 ../examples/guestfs-performance.pod:442 ../examples/guestfs-recipes.pod:433 ../examples/guestfs-testing.pod:298 ../fish/guestfish.pod:1317 ../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:409 ../inspector/virt-inspector.pod:510 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:53 ../python/examples/guestfs-python.pod:54 ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3630 ../sysprep/virt-sysprep.pod:495 ../test-tool/libguestfs-test-tool.pod:112 +#: ../appliance/libguestfs-make-fixed-appliance.pod:153 ../erlang/examples/guestfs-erlang.pod:110 ../examples/guestfs-examples.pod:45 ../examples/guestfs-faq.pod:729 ../examples/guestfs-performance.pod:442 ../examples/guestfs-recipes.pod:457 ../examples/guestfs-testing.pod:298 ../fish/guestfish.pod:1317 ../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:409 ../inspector/virt-inspector.pod:510 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:53 ../python/examples/guestfs-python.pod:54 ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3635 ../sysprep/virt-sysprep.pod:495 ../test-tool/libguestfs-test-tool.pod:112 msgid "AUTHORS" msgstr "" #. type: textblock -#: ../appliance/libguestfs-make-fixed-appliance.pod:155 ../erlang/examples/guestfs-erlang.pod:112 ../examples/guestfs-examples.pod:47 ../examples/guestfs-faq.pod:731 ../examples/guestfs-performance.pod:444 ../examples/guestfs-recipes.pod:435 ../examples/guestfs-testing.pod:300 ../fish/guestfish.pod:1319 ../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:411 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:55 ../python/examples/guestfs-python.pod:56 ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3632 ../test-tool/libguestfs-test-tool.pod:114 +#: ../appliance/libguestfs-make-fixed-appliance.pod:155 ../erlang/examples/guestfs-erlang.pod:112 ../examples/guestfs-examples.pod:47 ../examples/guestfs-faq.pod:731 ../examples/guestfs-performance.pod:444 ../examples/guestfs-recipes.pod:459 ../examples/guestfs-testing.pod:300 ../fish/guestfish.pod:1319 ../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:411 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:55 ../python/examples/guestfs-python.pod:56 ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3637 ../test-tool/libguestfs-test-tool.pod:114 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)" msgstr "" #. type: textblock -#: ../appliance/libguestfs-make-fixed-appliance.pod:159 ../cat/virt-ls.pod:513 ../df/virt-df.pod:267 ../edit/virt-edit.pod:388 ../examples/guestfs-recipes.pod:439 ../fish/guestfish.pod:1323 ../fuse/guestmount.pod:415 ../guestfs-release-notes.pod:1728 ../rescue/virt-rescue.pod:355 ../src/guestfs.pod:3636 ../test-tool/libguestfs-test-tool.pod:118 ../tools/virt-list-partitions.pl:285 +#: ../appliance/libguestfs-make-fixed-appliance.pod:159 ../cat/virt-ls.pod:513 ../df/virt-df.pod:267 ../edit/virt-edit.pod:388 ../examples/guestfs-recipes.pod:463 ../fish/guestfish.pod:1323 ../fuse/guestmount.pod:415 ../guestfs-release-notes.pod:1728 ../rescue/virt-rescue.pod:355 ../src/guestfs.pod:3641 ../test-tool/libguestfs-test-tool.pod:118 ../tools/virt-list-partitions.pl:285 msgid "Copyright (C) 2009-2012 Red Hat Inc." msgstr "" @@ -2539,7 +2539,7 @@ msgid "" msgstr "" #. type: =head2 -#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:5498 +#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:5506 msgid "path" msgstr "" @@ -4395,7 +4395,7 @@ msgid "DOWNLOADING, INSTALLING, COMPILING LIBGUESTFS" msgstr "" #. type: =end -#: ../examples/guestfs-faq.pod:218 ../examples/guestfs-faq.pod:223 ../examples/guestfs-faq.pod:448 ../examples/guestfs-faq.pod:453 ../examples/guestfs-faq.pod:574 ../examples/guestfs-faq.pod:579 ../guestfs-release-notes.pod:14 ../guestfs-release-notes.pod:21 ../src/guestfs.pod:2529 ../src/guestfs.pod:2534 +#: ../examples/guestfs-faq.pod:218 ../examples/guestfs-faq.pod:223 ../examples/guestfs-faq.pod:448 ../examples/guestfs-faq.pod:453 ../examples/guestfs-faq.pod:574 ../examples/guestfs-faq.pod:579 ../guestfs-release-notes.pod:14 ../guestfs-release-notes.pod:21 ../src/guestfs.pod:2533 ../src/guestfs.pod:2538 msgid "html" msgstr "" @@ -5740,7 +5740,7 @@ msgid "" msgstr "" #. type: =item -#: ../examples/guestfs-performance.pod:162 ../examples/guestfs-performance.pod:211 ../resize/virt-resize.pod:31 ../resize/virt-resize.pod:603 ../sparsify/virt-sparsify.pod:243 ../src/guestfs.pod:469 ../src/guestfs.pod:1287 ../src/guestfs.pod:1541 ../src/guestfs.pod:1706 ../src/guestfs.pod:2964 +#: ../examples/guestfs-performance.pod:162 ../examples/guestfs-performance.pod:211 ../resize/virt-resize.pod:31 ../resize/virt-resize.pod:603 ../sparsify/virt-sparsify.pod:243 ../src/guestfs.pod:473 ../src/guestfs.pod:1291 ../src/guestfs.pod:1545 ../src/guestfs.pod:1710 ../src/guestfs.pod:2968 msgid "1." msgstr "" @@ -5752,7 +5752,7 @@ msgid "" msgstr "" #. type: =item -#: ../examples/guestfs-performance.pod:168 ../examples/guestfs-performance.pod:218 ../resize/virt-resize.pod:44 ../resize/virt-resize.pod:610 ../sparsify/virt-sparsify.pod:250 ../src/guestfs.pod:475 ../src/guestfs.pod:1291 ../src/guestfs.pod:1545 ../src/guestfs.pod:1710 ../src/guestfs.pod:2989 +#: ../examples/guestfs-performance.pod:168 ../examples/guestfs-performance.pod:218 ../resize/virt-resize.pod:44 ../resize/virt-resize.pod:610 ../sparsify/virt-sparsify.pod:250 ../src/guestfs.pod:479 ../src/guestfs.pod:1295 ../src/guestfs.pod:1549 ../src/guestfs.pod:1714 ../src/guestfs.pod:2993 msgid "2." msgstr "" @@ -5767,7 +5767,7 @@ msgid "" msgstr "" #. type: =item -#: ../examples/guestfs-performance.pod:176 ../examples/guestfs-performance.pod:224 ../resize/virt-resize.pod:52 ../resize/virt-resize.pod:616 ../sparsify/virt-sparsify.pod:256 ../src/guestfs.pod:486 ../src/guestfs.pod:1295 ../src/guestfs.pod:1716 +#: ../examples/guestfs-performance.pod:176 ../examples/guestfs-performance.pod:224 ../resize/virt-resize.pod:52 ../resize/virt-resize.pod:616 ../sparsify/virt-sparsify.pod:256 ../src/guestfs.pod:490 ../src/guestfs.pod:1299 ../src/guestfs.pod:1720 msgid "3." msgstr "" @@ -6029,7 +6029,7 @@ msgid "Save the following script as C<time.stap>:" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:322 ../src/guestfs.pod:2477 +#: ../examples/guestfs-performance.pod:322 ../src/guestfs.pod:2481 #, no-wrap msgid "" " global last;\n" @@ -6037,7 +6037,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:324 ../src/guestfs.pod:2479 +#: ../examples/guestfs-performance.pod:324 ../src/guestfs.pod:2483 #, no-wrap msgid "" " function display_time () {\n" @@ -6050,7 +6050,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:331 ../src/guestfs.pod:2486 +#: ../examples/guestfs-performance.pod:331 ../src/guestfs.pod:2490 #, no-wrap msgid "" " printf (\"%d (+%d):\", now, delta);\n" @@ -6059,7 +6059,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:334 ../src/guestfs.pod:2489 +#: ../examples/guestfs-performance.pod:334 ../src/guestfs.pod:2493 #, no-wrap msgid "" " probe begin {\n" @@ -6070,7 +6070,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:339 ../src/guestfs.pod:2494 +#: ../examples/guestfs-performance.pod:339 ../src/guestfs.pod:2498 #, no-wrap msgid "" " /* Display all calls to static markers. */\n" @@ -6179,7 +6179,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:394 ../fish/guestfish.pod:998 ../src/guestfs.pod:1071 +#: ../examples/guestfs-performance.pod:394 ../fish/guestfish.pod:998 ../src/guestfs.pod:1075 #, no-wrap msgid "" " #!/bin/bash -\n" @@ -6554,38 +6554,43 @@ msgstr "" msgid "To list the filesystems in a disk image, use L<virt-filesystems(1)>." msgstr "" -#. type: =head1 +#. type: textblock #: ../examples/guestfs-recipes.pod:120 +msgid "See also L</Uploading raw filesystem content>." +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:122 msgid "Edit grub configuration in a VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:122 +#: ../examples/guestfs-recipes.pod:124 msgid "You can use this to:" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:128 +#: ../examples/guestfs-recipes.pod:130 msgid "Fix a virtual machine that does not boot." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:132 +#: ../examples/guestfs-recipes.pod:134 msgid "Change which kernel is used to boot the VM." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:136 +#: ../examples/guestfs-recipes.pod:138 msgid "Change kernel command line options." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:140 +#: ../examples/guestfs-recipes.pod:142 msgid "Use L<virt-edit(1)> to edit the grub configuration:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:142 +#: ../examples/guestfs-recipes.pod:144 #, no-wrap msgid "" " virt-edit -d BrokenGuest /boot/grub2/grub.cfg\n" @@ -6593,14 +6598,14 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:144 +#: ../examples/guestfs-recipes.pod:146 msgid "" "or for general tinkering inside an unbootable VM use L<virt-rescue(1)> like " "this:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:147 +#: ../examples/guestfs-recipes.pod:149 #, no-wrap msgid "" " virt-rescue -d BrokenGuest\n" @@ -6608,17 +6613,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:149 +#: ../examples/guestfs-recipes.pod:151 msgid "Export any directory from a VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:151 +#: ../examples/guestfs-recipes.pod:153 msgid "To export C</home> from a VM into a local directory use L<virt-copy-out(1)>:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:154 ../examples/guestfs-testing.pod:93 +#: ../examples/guestfs-recipes.pod:156 ../examples/guestfs-testing.pod:93 #, no-wrap msgid "" " virt-copy-out -d Guest /home .\n" @@ -6626,24 +6631,24 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:156 ../fish/guestfish-actions.pod:1684 ../fish/guestfish-actions.pod:2139 ../fish/guestfish-actions.pod:2723 ../src/guestfs-actions.pod:2759 ../src/guestfs-actions.pod:3467 ../src/guestfs-actions.pod:4306 ../src/guestfs.pod:1960 ../tools/virt-win-reg.pl:717 +#: ../examples/guestfs-recipes.pod:158 ../fish/guestfish-actions.pod:1684 ../fish/guestfish-actions.pod:2139 ../fish/guestfish-actions.pod:2731 ../src/guestfs-actions.pod:2759 ../src/guestfs-actions.pod:3467 ../src/guestfs-actions.pod:4314 ../src/guestfs.pod:1964 ../tools/virt-win-reg.pl:717 msgid "Notes:" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:162 +#: ../examples/guestfs-recipes.pod:164 msgid "" "The final dot of the command is not a printing error. It means we want to " "copy out to the current directory." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:167 +#: ../examples/guestfs-recipes.pod:169 msgid "This creates a directory called C<home> under the current directory." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:171 +#: ../examples/guestfs-recipes.pod:173 msgid "" "If the guest is a Windows guest then you can use drive letters and " "backslashes, but you must prefix the path with C<win:> and quote it to " @@ -6651,7 +6656,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:175 +#: ../examples/guestfs-recipes.pod:177 #, no-wrap msgid "" " virt-copy-out -d WinGuest 'win:c:\\windows\\system32\\config' .\n" @@ -6659,12 +6664,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:177 +#: ../examples/guestfs-recipes.pod:179 msgid "To get the output as a compressed tarball, do:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:179 +#: ../examples/guestfs-recipes.pod:181 #, no-wrap msgid "" " virt-tar-out -d Guest /home - | gzip --best > home.tar.gz\n" @@ -6672,7 +6677,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:181 +#: ../examples/guestfs-recipes.pod:183 msgid "" "Although it sounds tempting, this is usually not a reliable way to get a " "backup from a running guest. See the entry in the FAQ: " @@ -6680,19 +6685,19 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:185 +#: ../examples/guestfs-recipes.pod:187 msgid "Find out which user is using the most space" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:187 +#: ../examples/guestfs-recipes.pod:189 msgid "" "This simple script examines a Linux guest to find out which user is using " "the most space in their home directory:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:190 +#: ../examples/guestfs-recipes.pod:192 #, no-wrap msgid "" " #!/bin/sh -\n" @@ -6700,7 +6705,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:192 ../fish/guestfish.pod:1000 +#: ../examples/guestfs-recipes.pod:194 ../fish/guestfish.pod:1000 #, no-wrap msgid "" " set -e\n" @@ -6708,7 +6713,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:194 +#: ../examples/guestfs-recipes.pod:196 #, no-wrap msgid "" " vm=\"$1\"\n" @@ -6717,7 +6722,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:197 +#: ../examples/guestfs-recipes.pod:199 #, no-wrap msgid "" " eval $(guestfish --ro -d \"$vm\" -i --listen)\n" @@ -6725,7 +6730,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:199 +#: ../examples/guestfs-recipes.pod:201 #, no-wrap msgid "" " for d in $(guestfish --remote ls \"$dir\"); do\n" @@ -6737,7 +6742,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:205 ../fish/guestfish.pod:957 +#: ../examples/guestfs-recipes.pod:207 ../fish/guestfish.pod:957 #, no-wrap msgid "" " guestfish --remote exit\n" @@ -6745,41 +6750,41 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:207 +#: ../examples/guestfs-recipes.pod:209 msgid "Get DHCP address from a VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:209 +#: ../examples/guestfs-recipes.pod:211 msgid "" "The link below explains the many different possible techniques for getting " "the last assigned DHCP address of a virtual machine." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:212 +#: ../examples/guestfs-recipes.pod:214 msgid "L<https://rwmj.wordpress.com/2011/03/31/tip-code-for-getting-dhcp-address-from-a-virtual-machine-disk-image/#content>" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:214 +#: ../examples/guestfs-recipes.pod:216 msgid "" "In the libguestfs source examples directory you will find the latest version " "of the C<virt-dhcp-address.c> program." msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:217 +#: ../examples/guestfs-recipes.pod:219 msgid "Get the operating system product name string" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:219 +#: ../examples/guestfs-recipes.pod:221 msgid "Save the following script into a file called C<product-name.sh>:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:221 +#: ../examples/guestfs-recipes.pod:223 #, no-wrap msgid "" " #!/bin/sh -\n" @@ -6792,12 +6797,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:228 +#: ../examples/guestfs-recipes.pod:230 msgid "Make the script executable and run it on a named guest:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:230 +#: ../examples/guestfs-recipes.pod:232 #, no-wrap msgid "" " # product-name.sh RHEL60x64\n" @@ -6806,14 +6811,14 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:233 +#: ../examples/guestfs-recipes.pod:235 msgid "" "You can also use an XPath query on the L<virt-inspector(1)> XML using the " "C<xpath> command line tool or from your favourite programming language:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:237 +#: ../examples/guestfs-recipes.pod:239 #, no-wrap msgid "" " # virt-inspector RHEL60x64 > xml\n" @@ -6826,66 +6831,66 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:243 +#: ../examples/guestfs-recipes.pod:245 msgid "Get the default boot kernel for a Linux VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:245 +#: ../examples/guestfs-recipes.pod:247 msgid "" "The link below contains a program to print the default boot kernel for a " "Linux VM." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:248 +#: ../examples/guestfs-recipes.pod:250 msgid "L<https://rwmj.wordpress.com/2010/10/30/tip-use-augeas-to-get-the-default-boot-kernel-for-a-vm/#content>" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:250 +#: ../examples/guestfs-recipes.pod:252 msgid "" "It uses Augeas, and the technique is generally applicable for many different " "tasks, such as:" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:257 +#: ../examples/guestfs-recipes.pod:259 msgid "listing the user accounts in the guest" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:261 +#: ../examples/guestfs-recipes.pod:263 msgid "what repositories is it configured to use" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:265 +#: ../examples/guestfs-recipes.pod:267 msgid "what NTP servers does it connect to" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:269 +#: ../examples/guestfs-recipes.pod:271 msgid "what were the boot messages last time it booted" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:273 +#: ../examples/guestfs-recipes.pod:275 msgid "listing who was logged in recently" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:277 +#: ../examples/guestfs-recipes.pod:279 msgid "L<http://augeas.net/>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:279 +#: ../examples/guestfs-recipes.pod:281 msgid "Install RPMs in a guest" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:281 +#: ../examples/guestfs-recipes.pod:283 msgid "" "The link below contains a method to install RPMs in a guest. In fact the " "RPMs are just uploaded to the guest along with a \"firstboot\" script that " @@ -6894,29 +6899,29 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:287 +#: ../examples/guestfs-recipes.pod:289 msgid "L<https://rwmj.wordpress.com/2010/12/01/tip-install-rpms-in-a-guest/#content>" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:289 +#: ../examples/guestfs-recipes.pod:291 msgid "" "Since libguestfs 1.20, L<virt-sysprep(1)> has an option for installing " "firstboot scripts in Linux guests." msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:292 +#: ../examples/guestfs-recipes.pod:294 msgid "List applications installed in a VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:294 +#: ../examples/guestfs-recipes.pod:296 msgid "Save the following to a file C<list-apps.sh>:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:296 +#: ../examples/guestfs-recipes.pod:298 #, no-wrap msgid "" " #!/bin/sh -\n" @@ -6929,14 +6934,14 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:303 +#: ../examples/guestfs-recipes.pod:305 msgid "" "Make the file executable and then you can run it on any named virtual " "machine:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:306 +#: ../examples/guestfs-recipes.pod:308 #, no-wrap msgid "" " # list-apps.sh WinGuest\n" @@ -6972,7 +6977,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:336 +#: ../examples/guestfs-recipes.pod:338 msgid "" "If you want to run the script on disk images (instead of libvirt virtual " "machines), change C<-d \"$1\"> to C<-a \"$1\">. See also " @@ -6980,22 +6985,22 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:340 +#: ../examples/guestfs-recipes.pod:342 msgid "List files and directories in a VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:342 +#: ../examples/guestfs-recipes.pod:344 msgid "Use L<virt-ls(1)>." msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:344 +#: ../examples/guestfs-recipes.pod:346 msgid "List services in a Windows VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:346 +#: ../examples/guestfs-recipes.pod:348 msgid "" "The link below contains a script that can be used to list out the services " "from a Windows VM, and whether those services run at boot time or are loaded " @@ -7003,44 +7008,44 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:350 +#: ../examples/guestfs-recipes.pod:352 msgid "L<https://rwmj.wordpress.com/2010/12/10/tip-list-services-in-a-windows-guest/#content>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:352 +#: ../examples/guestfs-recipes.pod:354 msgid "Make a disk image sparse" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:354 +#: ../examples/guestfs-recipes.pod:356 msgid "Use L<virt-sparsify(1)>." msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:356 +#: ../examples/guestfs-recipes.pod:358 msgid "Monitor disk usage over time" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:358 +#: ../examples/guestfs-recipes.pod:360 msgid "" "You can use L<virt-df(1)> to monitor disk usage of your guests over time. " "The link below contains a guide." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:361 +#: ../examples/guestfs-recipes.pod:363 msgid "L<http://virt-tools.org/learning/advanced-virt-df/>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:363 +#: ../examples/guestfs-recipes.pod:365 msgid "Reading the Windows Event Log from Windows Vista (or later)" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:365 +#: ../examples/guestfs-recipes.pod:367 msgid "" "L<guestfish(1)> plus the tools described in the link below can be used to " "read out the Windows Event Log from any virtual machine running Windows " @@ -7048,24 +7053,24 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:369 +#: ../examples/guestfs-recipes.pod:371 msgid "L<https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-guestfish/#content>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:371 +#: ../examples/guestfs-recipes.pod:373 msgid "Remove root password (Linux)" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:373 +#: ../examples/guestfs-recipes.pod:375 msgid "" "Using the L<virt-edit(1)> I<-e> option you can do simple replacements on " "files. One use is to remove the root password from a Linux guest:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:376 +#: ../examples/guestfs-recipes.pod:378 #, no-wrap msgid "" " virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n" @@ -7073,12 +7078,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:378 +#: ../examples/guestfs-recipes.pod:380 msgid "Remove Administrator password (Windows)" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:380 +#: ../examples/guestfs-recipes.pod:382 msgid "" "The link below contains one technique for removing the Administrator " "password from a Windows VM, or to be more precise, it gives you a command " @@ -7086,17 +7091,17 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:385 +#: ../examples/guestfs-recipes.pod:387 msgid "L<https://mdbooth.wordpress.com/2010/10/18/resetting-a-windows-guests-administrator-password-with-guestfish/>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:387 +#: ../examples/guestfs-recipes.pod:389 msgid "Sysprepping a virtual machine (Windows)" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:389 +#: ../examples/guestfs-recipes.pod:391 msgid "" "It is possible to do a \"sysprep\" using libguestfs alone, although not " "straightforward. Currently there is code in the Aeolus Oz project which " @@ -7105,19 +7110,19 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:394 +#: ../examples/guestfs-recipes.pod:396 msgid "" "L<https://github.com/clalancette/oz> " "L<https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:397 +#: ../examples/guestfs-recipes.pod:399 msgid "Unpack a live CD" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:399 +#: ../examples/guestfs-recipes.pod:401 msgid "" "Linux live CDs often contain multiple layers of disk images wrapped like a " "Russian doll. You can use L<guestfish(1)> to look inside these multiple " @@ -7125,46 +7130,99 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:403 +#: ../examples/guestfs-recipes.pod:405 msgid "L<https://rwmj.wordpress.com/2009/07/15/unpack-the-russian-doll-of-a-f11-live-cd/#content>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:405 +#: ../examples/guestfs-recipes.pod:407 msgid "Uploading and downloading files" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:407 +#: ../examples/guestfs-recipes.pod:409 msgid "" "The link below contains general tips on uploading (copying in) and " "downloading (copying out) files from VMs." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:410 +#: ../examples/guestfs-recipes.pod:412 msgid "L<https://rwmj.wordpress.com/2010/12/02/tip-uploading-and-downloading/#content>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:412 +#: ../examples/guestfs-recipes.pod:414 +msgid "Uploading raw filesystem content" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:416 +msgid "" +"You can use L<guestfish(1)> to upload whole filesystems into a VM, even into " +"a filesystem which is encrypted or buried inside an LV or RAID device:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:420 +#, no-wrap +msgid "" +" guestfish --rw -a disk.img run : upload sda1.img /dev/sda1\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:422 +#, no-wrap +msgid "" +" guestfish --rw -d Guest run : upload lv.img /dev/vg_guest/lv_root\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:424 +msgid "" +"One common problem is that the filesystem isn't the right size for the " +"target. If it is too large, there's not much you can do with libguestfs - " +"you have to prepare the filesystem differently. But if the filesystem needs " +"to expand into the target, you can use guestfish to resize it to the right " +"size:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:430 +#, no-wrap +msgid "" +" guestfish --rw -d Guest run : \\\n" +" upload lv.img /dev/vg_guest/lv_root : \\\n" +" resize2fs /dev/vg_guest/lv_root\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:434 +msgid "(or use C<ntfsresize> if the filesystem is NTFS)." +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:436 msgid "Use libguestfs tools on VMware ESX guests" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:414 +#: ../examples/guestfs-recipes.pod:438 msgid "" "The link below explains how to use libguestfs, L<guestfish(1)> and the virt " "tools on any VMware ESX guests, by first sharing the VMware VMFS over sshfs." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:418 +#: ../examples/guestfs-recipes.pod:442 msgid "L<https://rwmj.wordpress.com/2011/05/10/tip-use-libguestfs-on-vmware-esx-guests/#content>" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:422 +#: ../examples/guestfs-recipes.pod:446 msgid "" "L<guestfs(3)>, L<guestfish(1)>, L<guestfs-examples(3)>, " "L<guestfs-erlang(3)>, L<guestfs-java(3)>, L<guestfs-ocaml(3)>, " @@ -7279,7 +7337,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:3066 +#: ../examples/guestfs-testing.pod:54 ../examples/guestfs-testing.pod:161 ../examples/guestfs-testing.pod:174 ../examples/guestfs-testing.pod:234 ../src/guestfs.pod:3070 msgid "or:" msgstr "" @@ -7453,7 +7511,7 @@ msgid "Try importing virt-df CSV output into a spreadsheet or database." msgstr "" #. type: textblock -#: ../examples/guestfs-testing.pod:131 ../src/guestfs.pod:3364 +#: ../examples/guestfs-testing.pod:131 ../src/guestfs.pod:3368 msgid "Run:" msgstr "" @@ -7897,7 +7955,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:193 ../fish/guestfish-actions.pod:207 ../fish/guestfish-actions.pod:1054 ../fish/guestfish-actions.pod:1089 ../fish/guestfish-actions.pod:1271 ../fish/guestfish-actions.pod:1299 ../fish/guestfish-actions.pod:1316 ../fish/guestfish-actions.pod:1353 ../fish/guestfish-actions.pod:1390 ../fish/guestfish-actions.pod:1407 ../fish/guestfish-actions.pod:1893 ../fish/guestfish-actions.pod:1907 ../fish/guestfish-actions.pod:2128 ../fish/guestfish-actions.pod:3303 ../fish/guestfish-actions.pod:4139 ../fish/guestfish-actions.pod:4268 ../fish/guestfish-actions.pod:4281 ../fish/guestfish-actions.pod:4576 ../fish/guestfish-actions.pod:5433 ../fish/guestfish-actions.pod:5681 ../fish/guestfish-actions.pod:5701 ../fish/guestfish-actions.pod:5720 ../fish/guestfish-actions.pod:5758 ../fish/guestfish-actions.pod:6055 ../fish/guestfish-actions.pod:6071 ../fish/guestfish-actions.pod:6209 ../fish/guestfish-actions.pod:6225 ../fish/guestfish-actions.pod:6613 ../fish/guestfish-actions.pod:6689 ../fish/guestfish-actions.pod:6706 ../fish/guestfish-actions.pod:6781 ../fish/guestfish-actions.pod:6798 ../fish/guestfish-actions.pod:6817 ../fish/guestfish-actions.pod:6834 ../fish/guestfish-actions.pod:6851 ../src/guestfs-actions.pod:10 ../src/guestfs-actions.pod:286 ../src/guestfs-actions.pod:307 ../src/guestfs-actions.pod:1817 ../src/guestfs-actions.pod:1874 ../src/guestfs-actions.pod:2179 ../src/guestfs-actions.pod:2219 ../src/guestfs-actions.pod:2245 ../src/guestfs-actions.pod:2302 ../src/guestfs-actions.pod:2355 ../src/guestfs-actions.pod:2381 ../src/guestfs-actions.pod:3043 ../src/guestfs-actions.pod:3064 ../src/guestfs-actions.pod:3441 ../src/guestfs-actions.pod:5113 ../src/guestfs-actions.pod:6482 ../src/guestfs-actions.pod:6738 ../src/guestfs-actions.pod:6762 ../src/guestfs-actions.pod:7351 ../src/guestfs-actions.pod:8703 ../src/guestfs-actions.pod:9014 ../src/guestfs-actions.pod:9055 ../src/guestfs-actions.pod:9086 ../src/guestfs-actions.pod:9146 ../src/guestfs-actions.pod:9677 ../src/guestfs-actions.pod:9698 ../src/guestfs-actions.pod:9913 ../src/guestfs-actions.pod:9934 ../src/guestfs-actions.pod:10509 ../src/guestfs-actions.pod:10631 ../src/guestfs-actions.pod:10850 ../src/guestfs-actions.pod:10876 ../src/guestfs-actions.pod:10999 ../src/guestfs-actions.pod:11025 ../src/guestfs-actions.pod:11051 ../src/guestfs-actions.pod:11078 ../src/guestfs-actions.pod:11104 +#: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:193 ../fish/guestfish-actions.pod:207 ../fish/guestfish-actions.pod:1054 ../fish/guestfish-actions.pod:1089 ../fish/guestfish-actions.pod:1271 ../fish/guestfish-actions.pod:1299 ../fish/guestfish-actions.pod:1316 ../fish/guestfish-actions.pod:1353 ../fish/guestfish-actions.pod:1390 ../fish/guestfish-actions.pod:1407 ../fish/guestfish-actions.pod:1893 ../fish/guestfish-actions.pod:1907 ../fish/guestfish-actions.pod:2128 ../fish/guestfish-actions.pod:3311 ../fish/guestfish-actions.pod:4147 ../fish/guestfish-actions.pod:4276 ../fish/guestfish-actions.pod:4289 ../fish/guestfish-actions.pod:4584 ../fish/guestfish-actions.pod:5441 ../fish/guestfish-actions.pod:5689 ../fish/guestfish-actions.pod:5709 ../fish/guestfish-actions.pod:5728 ../fish/guestfish-actions.pod:5766 ../fish/guestfish-actions.pod:6063 ../fish/guestfish-actions.pod:6079 ../fish/guestfish-actions.pod:6217 ../fish/guestfish-actions.pod:6233 ../fish/guestfish-actions.pod:6621 ../fish/guestfish-actions.pod:6697 ../fish/guestfish-actions.pod:6714 ../fish/guestfish-actions.pod:6789 ../fish/guestfish-actions.pod:6806 ../fish/guestfish-actions.pod:6825 ../fish/guestfish-actions.pod:6842 ../fish/guestfish-actions.pod:6859 ../src/guestfs-actions.pod:10 ../src/guestfs-actions.pod:286 ../src/guestfs-actions.pod:307 ../src/guestfs-actions.pod:1817 ../src/guestfs-actions.pod:1874 ../src/guestfs-actions.pod:2179 ../src/guestfs-actions.pod:2219 ../src/guestfs-actions.pod:2245 ../src/guestfs-actions.pod:2302 ../src/guestfs-actions.pod:2355 ../src/guestfs-actions.pod:2381 ../src/guestfs-actions.pod:3043 ../src/guestfs-actions.pod:3064 ../src/guestfs-actions.pod:3441 ../src/guestfs-actions.pod:5121 ../src/guestfs-actions.pod:6490 ../src/guestfs-actions.pod:6746 ../src/guestfs-actions.pod:6770 ../src/guestfs-actions.pod:7359 ../src/guestfs-actions.pod:8711 ../src/guestfs-actions.pod:9022 ../src/guestfs-actions.pod:9063 ../src/guestfs-actions.pod:9094 ../src/guestfs-actions.pod:9154 ../src/guestfs-actions.pod:9685 ../src/guestfs-actions.pod:9706 ../src/guestfs-actions.pod:9921 ../src/guestfs-actions.pod:9942 ../src/guestfs-actions.pod:10517 ../src/guestfs-actions.pod:10639 ../src/guestfs-actions.pod:10858 ../src/guestfs-actions.pod:10884 ../src/guestfs-actions.pod:11007 ../src/guestfs-actions.pod:11033 ../src/guestfs-actions.pod:11059 ../src/guestfs-actions.pod:11086 ../src/guestfs-actions.pod:11112 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 " @@ -8061,7 +8119,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:107 ../fish/guestfish-actions.pod:170 ../fish/guestfish-actions.pod:654 ../fish/guestfish-actions.pod:669 ../fish/guestfish-actions.pod:948 ../fish/guestfish-actions.pod:969 ../fish/guestfish-actions.pod:1007 ../fish/guestfish-actions.pod:1016 ../fish/guestfish-actions.pod:1025 ../fish/guestfish-actions.pod:1039 ../fish/guestfish-actions.pod:1258 ../fish/guestfish-actions.pod:1728 ../fish/guestfish-actions.pod:2110 ../fish/guestfish-actions.pod:2314 ../fish/guestfish-actions.pod:2762 ../fish/guestfish-actions.pod:3875 ../fish/guestfish-actions.pod:4122 ../fish/guestfish-actions.pod:4155 ../fish/guestfish-actions.pod:4253 ../fish/guestfish-actions.pod:4339 ../fish/guestfish-actions.pod:4369 ../fish/guestfish-actions.pod:4512 ../fish/guestfish-actions.pod:4528 ../fish/guestfish-actions.pod:4564 ../fish/guestfish-actions.pod:5193 ../fish/guestfish-actions.pod:5217 ../fish/guestfish-actions.pod:5241 ../fish/guestfish-actions.pod:5409 ../fish/guestfish-actions.pod:6005 ../fish/guestfish-actions.pod:6041 ../fish/guestfish-actions.pod:6183 ../fish/guestfish-actions.pod:6262 ../fish/guestfish-actions.pod:6283 ../fish/guestfish-actions.pod:6631 ../fish/guestfish-actions.pod:6643 ../fish/guestfish-actions.pod:6674 +#: ../fish/guestfish-actions.pod:107 ../fish/guestfish-actions.pod:170 ../fish/guestfish-actions.pod:654 ../fish/guestfish-actions.pod:669 ../fish/guestfish-actions.pod:948 ../fish/guestfish-actions.pod:969 ../fish/guestfish-actions.pod:1007 ../fish/guestfish-actions.pod:1016 ../fish/guestfish-actions.pod:1025 ../fish/guestfish-actions.pod:1039 ../fish/guestfish-actions.pod:1258 ../fish/guestfish-actions.pod:1728 ../fish/guestfish-actions.pod:2110 ../fish/guestfish-actions.pod:2314 ../fish/guestfish-actions.pod:2770 ../fish/guestfish-actions.pod:3883 ../fish/guestfish-actions.pod:4130 ../fish/guestfish-actions.pod:4163 ../fish/guestfish-actions.pod:4261 ../fish/guestfish-actions.pod:4347 ../fish/guestfish-actions.pod:4377 ../fish/guestfish-actions.pod:4520 ../fish/guestfish-actions.pod:4536 ../fish/guestfish-actions.pod:4572 ../fish/guestfish-actions.pod:5201 ../fish/guestfish-actions.pod:5225 ../fish/guestfish-actions.pod:5249 ../fish/guestfish-actions.pod:5417 ../fish/guestfish-actions.pod:6013 ../fish/guestfish-actions.pod:6049 ../fish/guestfish-actions.pod:6191 ../fish/guestfish-actions.pod:6270 ../fish/guestfish-actions.pod:6291 ../fish/guestfish-actions.pod:6639 ../fish/guestfish-actions.pod:6651 ../fish/guestfish-actions.pod:6682 msgid "" "This command has one or more optional arguments. See L</OPTIONAL " "ARGUMENTS>." @@ -8120,7 +8178,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:133 ../fish/guestfish-actions.pod:4084 ../fish/guestfish-actions.pod:5178 ../src/guestfs-actions.pod:198 ../src/guestfs-actions.pod:6405 ../src/guestfs-actions.pod:8272 +#: ../fish/guestfish-actions.pod:133 ../fish/guestfish-actions.pod:4092 ../fish/guestfish-actions.pod:5186 ../src/guestfs-actions.pod:198 ../src/guestfs-actions.pod:6413 ../src/guestfs-actions.pod:8280 msgid "The optional arguments are:" msgstr "" @@ -8138,7 +8196,7 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:143 ../src/guestfs-actions.pod:208 ../src/guestfs.pod:3231 +#: ../fish/guestfish-actions.pod:143 ../src/guestfs-actions.pod:208 ../src/guestfs.pod:3235 msgid "C<format>" msgstr "" @@ -8171,7 +8229,7 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:159 ../fish/guestfish-actions.pod:3903 ../src/guestfs-actions.pod:224 ../src/guestfs-actions.pod:6093 +#: ../fish/guestfish-actions.pod:159 ../fish/guestfish-actions.pod:3911 ../src/guestfs-actions.pod:224 ../src/guestfs-actions.pod:6101 msgid "C<name>" msgstr "" @@ -8828,7 +8886,7 @@ msgid "This command uploads base64-encoded data from C<base64file> to C<filename msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:469 ../fish/guestfish-actions.pod:478 ../fish/guestfish-actions.pod:862 ../fish/guestfish-actions.pod:946 ../fish/guestfish-actions.pod:967 ../fish/guestfish-actions.pod:1183 ../fish/guestfish-actions.pod:1202 ../fish/guestfish-actions.pod:1652 ../fish/guestfish-actions.pod:3514 ../fish/guestfish-actions.pod:4489 ../fish/guestfish-actions.pod:4510 ../fish/guestfish-actions.pod:6003 ../fish/guestfish-actions.pod:6039 ../fish/guestfish-actions.pod:6050 ../fish/guestfish-actions.pod:6066 ../fish/guestfish-actions.pod:6204 ../fish/guestfish-actions.pod:6220 ../fish/guestfish-actions.pod:6296 ../fish/guestfish-actions.pod:6319 +#: ../fish/guestfish-actions.pod:469 ../fish/guestfish-actions.pod:478 ../fish/guestfish-actions.pod:862 ../fish/guestfish-actions.pod:946 ../fish/guestfish-actions.pod:967 ../fish/guestfish-actions.pod:1183 ../fish/guestfish-actions.pod:1202 ../fish/guestfish-actions.pod:1652 ../fish/guestfish-actions.pod:3522 ../fish/guestfish-actions.pod:4497 ../fish/guestfish-actions.pod:4518 ../fish/guestfish-actions.pod:6011 ../fish/guestfish-actions.pod:6047 ../fish/guestfish-actions.pod:6058 ../fish/guestfish-actions.pod:6074 ../fish/guestfish-actions.pod:6212 ../fish/guestfish-actions.pod:6228 ../fish/guestfish-actions.pod:6304 ../fish/guestfish-actions.pod:6327 msgid "Use C<-> instead of a filename to read/write from stdin/stdout." msgstr "" @@ -9225,12 +9283,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:641 ../fish/guestfish-actions.pod:3824 ../fish/guestfish-actions.pod:4539 ../fish/guestfish-actions.pod:6113 ../src/guestfs-actions.pod:968 ../src/guestfs-actions.pod:5986 ../src/guestfs-actions.pod:7290 ../src/guestfs-actions.pod:9785 +#: ../fish/guestfish-actions.pod:641 ../fish/guestfish-actions.pod:3832 ../fish/guestfish-actions.pod:4547 ../fish/guestfish-actions.pod:6121 ../src/guestfs-actions.pod:968 ../src/guestfs-actions.pod:5994 ../src/guestfs-actions.pod:7298 ../src/guestfs-actions.pod:9793 msgid "The optional parameters are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:645 ../fish/guestfish-actions.pod:4543 ../src/guestfs-actions.pod:972 ../src/guestfs-actions.pod:7294 +#: ../fish/guestfish-actions.pod:645 ../fish/guestfish-actions.pod:4551 ../src/guestfs-actions.pod:972 ../src/guestfs-actions.pod:7302 msgid "C<size>" msgstr "" @@ -9547,7 +9605,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:782 ../fish/guestfish-actions.pod:4977 ../src/guestfs-actions.pod:1231 ../src/guestfs-actions.pod:7968 +#: ../fish/guestfish-actions.pod:782 ../fish/guestfish-actions.pod:4985 ../src/guestfs-actions.pod:1231 ../src/guestfs-actions.pod:7976 msgid "Return the contents of the file named C<path>." msgstr "" @@ -9751,7 +9809,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:875 ../fish/guestfish-actions.pod:4073 ../fish/guestfish-actions.pod:4220 ../fish/guestfish-actions.pod:4230 ../fish/guestfish-actions.pod:4240 ../src/guestfs-actions.pod:1354 ../src/guestfs-actions.pod:6364 ../src/guestfs-actions.pod:6627 ../src/guestfs-actions.pod:6646 ../src/guestfs-actions.pod:6665 +#: ../fish/guestfish-actions.pod:875 ../fish/guestfish-actions.pod:4081 ../fish/guestfish-actions.pod:4228 ../fish/guestfish-actions.pod:4238 ../fish/guestfish-actions.pod:4248 ../src/guestfs-actions.pod:1354 ../src/guestfs-actions.pod:6372 ../src/guestfs-actions.pod:6635 ../src/guestfs-actions.pod:6654 ../src/guestfs-actions.pod:6673 msgid "The mode actually set is affected by the umask." msgstr "" @@ -9774,7 +9832,7 @@ msgid "Change the file owner to C<owner> and group to C<group>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:883 ../fish/guestfish-actions.pod:3327 ../src/guestfs-actions.pod:1370 ../src/guestfs-actions.pod:5157 +#: ../fish/guestfish-actions.pod:883 ../fish/guestfish-actions.pod:3335 ../src/guestfs-actions.pod:1370 ../src/guestfs-actions.pod:5165 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 " @@ -9842,7 +9900,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:921 ../fish/guestfish-actions.pod:933 ../fish/guestfish-actions.pod:1293 ../fish/guestfish-actions.pod:1310 ../fish/guestfish-actions.pod:1384 ../fish/guestfish-actions.pod:1401 ../fish/guestfish-actions.pod:2112 ../fish/guestfish-actions.pod:2122 ../fish/guestfish-actions.pod:2179 ../fish/guestfish-actions.pod:2194 ../fish/guestfish-actions.pod:2204 ../fish/guestfish-actions.pod:2380 ../fish/guestfish-actions.pod:4840 ../fish/guestfish-actions.pod:4855 ../fish/guestfish-actions.pod:4943 ../fish/guestfish-actions.pod:4960 ../fish/guestfish-actions.pod:5045 ../fish/guestfish-actions.pod:5839 ../fish/guestfish-actions.pod:5885 ../fish/guestfish-actions.pod:5970 ../fish/guestfish-actions.pod:5985 ../fish/guestfish-actions.pod:6607 ../fish/guestfish-actions.pod:6683 ../fish/guestfish-actions.pod:6700 ../fish/guestfish-actions.pod:6775 ../fish/guestfish-actions.pod:6792 ../fish/guestfish-actions.pod:6828 ../fish/guestfish-actions.pod:6845 ../src/guestfs-actions.pod:1417 ../src/guestfs-actions.pod:1437 ../src/guestfs-actions.pod:2230 ../src/guestfs-actions.pod:2256 ../src/guestfs-actions.pod:2366 ../src/guestfs-actions.pod:2392 ../src/guestfs-actions.pod:3402 ../src/guestfs-actions.pod:3452 ../src/guestfs-actions.pod:3517 ../src/guestfs-actions.pod:3541 ../src/guestfs-actions.pod:3558 ../src/guestfs-actions.pod:3857 ../src/guestfs-actions.pod:7732 ../src/guestfs-actions.pod:7758 ../src/guestfs-actions.pod:7912 ../src/guestfs-actions.pod:7938 ../src/guestfs-actions.pod:8048 ../src/guestfs-actions.pod:9286 ../src/guestfs-actions.pod:9341 ../src/guestfs-actions.pod:9487 ../src/guestfs-actions.pod:9511 ../src/guestfs-actions.pod:10648 ../src/guestfs-actions.pod:10861 ../src/guestfs-actions.pod:10887 ../src/guestfs-actions.pod:11010 ../src/guestfs-actions.pod:11036 ../src/guestfs-actions.pod:11089 ../src/guestfs-actions.pod:11115 +#: ../fish/guestfish-actions.pod:921 ../fish/guestfish-actions.pod:933 ../fish/guestfish-actions.pod:1293 ../fish/guestfish-actions.pod:1310 ../fish/guestfish-actions.pod:1384 ../fish/guestfish-actions.pod:1401 ../fish/guestfish-actions.pod:2112 ../fish/guestfish-actions.pod:2122 ../fish/guestfish-actions.pod:2179 ../fish/guestfish-actions.pod:2194 ../fish/guestfish-actions.pod:2204 ../fish/guestfish-actions.pod:2380 ../fish/guestfish-actions.pod:4848 ../fish/guestfish-actions.pod:4863 ../fish/guestfish-actions.pod:4951 ../fish/guestfish-actions.pod:4968 ../fish/guestfish-actions.pod:5053 ../fish/guestfish-actions.pod:5847 ../fish/guestfish-actions.pod:5893 ../fish/guestfish-actions.pod:5978 ../fish/guestfish-actions.pod:5993 ../fish/guestfish-actions.pod:6615 ../fish/guestfish-actions.pod:6691 ../fish/guestfish-actions.pod:6708 ../fish/guestfish-actions.pod:6783 ../fish/guestfish-actions.pod:6800 ../fish/guestfish-actions.pod:6836 ../fish/guestfish-actions.pod:6853 ../src/guestfs-actions.pod:1417 ../src/guestfs-actions.pod:1437 ../src/guestfs-actions.pod:2230 ../src/guestfs-actions.pod:2256 ../src/guestfs-actions.pod:2366 ../src/guestfs-actions.pod:2392 ../src/guestfs-actions.pod:3402 ../src/guestfs-actions.pod:3452 ../src/guestfs-actions.pod:3517 ../src/guestfs-actions.pod:3541 ../src/guestfs-actions.pod:3558 ../src/guestfs-actions.pod:3857 ../src/guestfs-actions.pod:7740 ../src/guestfs-actions.pod:7766 ../src/guestfs-actions.pod:7920 ../src/guestfs-actions.pod:7946 ../src/guestfs-actions.pod:8056 ../src/guestfs-actions.pod:9294 ../src/guestfs-actions.pod:9349 ../src/guestfs-actions.pod:9495 ../src/guestfs-actions.pod:9519 ../src/guestfs-actions.pod:10656 ../src/guestfs-actions.pod:10869 ../src/guestfs-actions.pod:10895 ../src/guestfs-actions.pod:11018 ../src/guestfs-actions.pod:11044 ../src/guestfs-actions.pod:11097 ../src/guestfs-actions.pod:11123 msgid "" "Because of the message protocol, there is a transfer limit of somewhere " "between 2MB and 4MB. See L<guestfs(3)/PROTOCOL LIMITS>." @@ -10370,7 +10428,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1179 ../fish/guestfish-actions.pod:6292 ../src/guestfs-actions.pod:2018 ../src/guestfs-actions.pod:10095 +#: ../fish/guestfish-actions.pod:1179 ../fish/guestfish-actions.pod:6300 ../src/guestfs-actions.pod:2018 ../src/guestfs-actions.pod:10103 msgid "C<filename> can also be a named pipe." msgstr "" @@ -10610,7 +10668,7 @@ msgid "This calls the external C<egrep> program and returns the matching lines." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1296 ../fish/guestfish-actions.pod:1313 ../fish/guestfish-actions.pod:1387 ../fish/guestfish-actions.pod:1404 ../fish/guestfish-actions.pod:2125 ../fish/guestfish-actions.pod:6686 ../fish/guestfish-actions.pod:6703 ../fish/guestfish-actions.pod:6778 ../fish/guestfish-actions.pod:6795 ../fish/guestfish-actions.pod:6831 ../fish/guestfish-actions.pod:6848 +#: ../fish/guestfish-actions.pod:1296 ../fish/guestfish-actions.pod:1313 ../fish/guestfish-actions.pod:1387 ../fish/guestfish-actions.pod:1404 ../fish/guestfish-actions.pod:2125 ../fish/guestfish-actions.pod:6694 ../fish/guestfish-actions.pod:6711 ../fish/guestfish-actions.pod:6786 ../fish/guestfish-actions.pod:6803 ../fish/guestfish-actions.pod:6839 ../fish/guestfish-actions.pod:6856 msgid "I<This function is deprecated.> In new code, use the L</grep> call instead." msgstr "" @@ -11069,7 +11127,7 @@ msgid "You must call L</launch> before using this command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1557 ../src/guestfs-actions.pod:2565 ../src/guestfs.pod:1807 +#: ../fish/guestfish-actions.pod:1557 ../src/guestfs-actions.pod:2565 ../src/guestfs.pod:1811 msgid "" "This is mainly useful as a negative test. If this returns true, it doesn't " "mean that a particular filesystem can be mounted, since filesystems can fail " @@ -11513,7 +11571,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1769 ../fish/guestfish-actions.pod:5405 ../src/guestfs-actions.pod:2909 ../src/guestfs-actions.pod:8646 +#: ../fish/guestfish-actions.pod:1769 ../fish/guestfish-actions.pod:5413 ../src/guestfs-actions.pod:2909 ../src/guestfs-actions.pod:8654 msgid "" "These attributes are only present when the file is located on an ext2/3/4 " "filesystem. Using this call on other filesystem types will result in an " @@ -11546,7 +11604,7 @@ msgid "The file is append-only." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1786 ../fish/guestfish-actions.pod:5006 ../src/guestfs-actions.pod:2926 ../src/guestfs-actions.pod:8005 +#: ../fish/guestfish-actions.pod:1786 ../fish/guestfish-actions.pod:5014 ../src/guestfs-actions.pod:2926 ../src/guestfs-actions.pod:8013 msgid "'c'" msgstr "" @@ -11568,7 +11626,7 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1795 ../fish/guestfish-actions.pod:5010 ../src/guestfs-actions.pod:2935 ../src/guestfs-actions.pod:8009 +#: ../fish/guestfish-actions.pod:1795 ../fish/guestfish-actions.pod:5018 ../src/guestfs-actions.pod:2935 ../src/guestfs-actions.pod:8017 msgid "'d'" msgstr "" @@ -11642,7 +11700,7 @@ msgid "The file is data-journaled." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1825 ../fish/guestfish-actions.pod:5026 ../src/guestfs-actions.pod:2965 ../src/guestfs-actions.pod:8025 +#: ../fish/guestfish-actions.pod:1825 ../fish/guestfish-actions.pod:5034 ../src/guestfs-actions.pod:2965 ../src/guestfs-actions.pod:8033 msgid "'s'" msgstr "" @@ -11688,7 +11746,7 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1845 ../fish/guestfish-actions.pod:5030 ../src/guestfs-actions.pod:2985 ../src/guestfs-actions.pod:8029 +#: ../fish/guestfish-actions.pod:1845 ../fish/guestfish-actions.pod:5038 ../src/guestfs-actions.pod:2985 ../src/guestfs-actions.pod:8037 msgid "'u'" msgstr "" @@ -11848,7 +11906,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1922 ../fish/guestfish-actions.pod:1979 ../fish/guestfish-actions.pod:5478 ../fish/guestfish-actions.pod:5582 ../src/guestfs-actions.pod:3088 ../src/guestfs-actions.pod:3180 ../src/guestfs-actions.pod:8773 ../src/guestfs-actions.pod:8901 +#: ../fish/guestfish-actions.pod:1922 ../fish/guestfish-actions.pod:1979 ../fish/guestfish-actions.pod:5486 ../fish/guestfish-actions.pod:5590 ../src/guestfs-actions.pod:3088 ../src/guestfs-actions.pod:3180 ../src/guestfs-actions.pod:8781 ../src/guestfs-actions.pod:8909 msgid "For more information on the architecture of libguestfs, see L<guestfs(3)>." msgstr "" @@ -12045,7 +12103,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1995 ../fish/guestfish-actions.pod:3178 ../fish/guestfish-actions.pod:3216 ../fish/guestfish-actions.pod:3232 ../src/guestfs-actions.pod:3206 ../src/guestfs-actions.pod:4913 ../src/guestfs-actions.pod:4974 ../src/guestfs-actions.pod:5001 +#: ../fish/guestfish-actions.pod:1995 ../fish/guestfish-actions.pod:3186 ../fish/guestfish-actions.pod:3224 ../fish/guestfish-actions.pod:3240 ../src/guestfs-actions.pod:3206 ../src/guestfs-actions.pod:4921 ../src/guestfs-actions.pod:4982 ../src/guestfs-actions.pod:5009 msgid "For more information on states, see L<guestfs(3)>." msgstr "" @@ -12150,7 +12208,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2033 ../fish/guestfish-actions.pod:3339 +#: ../fish/guestfish-actions.pod:2033 ../fish/guestfish-actions.pod:3347 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 " @@ -12160,7 +12218,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2040 ../fish/guestfish-actions.pod:3346 ../src/guestfs-actions.pod:3280 ../src/guestfs-actions.pod:5184 +#: ../fish/guestfish-actions.pod:2040 ../fish/guestfish-actions.pod:3354 ../src/guestfs-actions.pod:3280 ../src/guestfs-actions.pod:5192 msgid "" "Extended attribute values are blobs of binary data. If there is no extended " "attribute named C<name>, this returns an error." @@ -12439,7 +12497,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2192 ../fish/guestfish-actions.pod:5983 ../src/guestfs-actions.pod:3535 ../src/guestfs-actions.pod:9505 +#: ../fish/guestfish-actions.pod:2192 ../fish/guestfish-actions.pod:5991 ../src/guestfs-actions.pod:3535 ../src/guestfs-actions.pod:9513 msgid "If the parameter C<nrlines> is zero, this returns an empty list." msgstr "" @@ -13102,7 +13160,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2498 ../fish/guestfish-actions.pod:2605 ../fish/guestfish-actions.pod:2684 ../fish/guestfish-actions.pod:2696 ../fish/guestfish-actions.pod:2780 ../fish/guestfish-actions.pod:2842 ../fish/guestfish-actions.pod:2863 ../fish/guestfish-actions.pod:2877 ../fish/guestfish-actions.pod:2917 ../fish/guestfish-actions.pod:2961 ../fish/guestfish-actions.pod:2974 ../fish/guestfish-actions.pod:2987 ../fish/guestfish-actions.pod:2997 ../fish/guestfish-actions.pod:3007 ../fish/guestfish-actions.pod:3019 ../fish/guestfish-actions.pod:3115 ../fish/guestfish-actions.pod:3149 ../src/guestfs-actions.pod:4025 ../src/guestfs-actions.pod:4139 ../src/guestfs-actions.pod:4243 ../src/guestfs-actions.pod:4262 ../src/guestfs-actions.pod:4393 ../src/guestfs-actions.pod:4477 ../src/guestfs-actions.pod:4505 ../src/guestfs-actions.pod:4526 ../src/guestfs-actions.pod:4579 ../src/guestfs-actions.pod:4631 ../src/guestfs-actions.pod:4651 ../src/guestfs-actions.pod:4671 ../src/guestfs-actions.pod:4688 ../src/guestfs-actions.pod:4704 ../src/guestfs-actions.pod:4722 ../src/guestfs-actions.pod:4824 ../src/guestfs-actions.pod:4865 +#: ../fish/guestfish-actions.pod:2498 ../fish/guestfish-actions.pod:2613 ../fish/guestfish-actions.pod:2692 ../fish/guestfish-actions.pod:2704 ../fish/guestfish-actions.pod:2788 ../fish/guestfish-actions.pod:2850 ../fish/guestfish-actions.pod:2871 ../fish/guestfish-actions.pod:2885 ../fish/guestfish-actions.pod:2925 ../fish/guestfish-actions.pod:2969 ../fish/guestfish-actions.pod:2982 ../fish/guestfish-actions.pod:2995 ../fish/guestfish-actions.pod:3005 ../fish/guestfish-actions.pod:3015 ../fish/guestfish-actions.pod:3027 ../fish/guestfish-actions.pod:3123 ../fish/guestfish-actions.pod:3157 ../src/guestfs-actions.pod:4025 ../src/guestfs-actions.pod:4147 ../src/guestfs-actions.pod:4251 ../src/guestfs-actions.pod:4270 ../src/guestfs-actions.pod:4401 ../src/guestfs-actions.pod:4485 ../src/guestfs-actions.pod:4513 ../src/guestfs-actions.pod:4534 ../src/guestfs-actions.pod:4587 ../src/guestfs-actions.pod:4639 ../src/guestfs-actions.pod:4659 ../src/guestfs-actions.pod:4679 ../src/guestfs-actions.pod:4696 ../src/guestfs-actions.pod:4712 ../src/guestfs-actions.pod:4730 ../src/guestfs-actions.pod:4832 ../src/guestfs-actions.pod:4873 msgid "Please read L<guestfs(3)/INSPECTION> for more details." msgstr "" @@ -13311,60 +13369,80 @@ msgstr "" #. type: =item #: ../fish/guestfish-actions.pod:2583 ../src/guestfs-actions.pod:4117 -msgid "\"ttylinux\"" +msgid "\"sles\"" msgstr "" #. type: textblock #: ../fish/guestfish-actions.pod:2585 ../src/guestfs-actions.pod:4119 -msgid "ttylinux." +msgid "SuSE Linux Enterprise Server or Desktop." msgstr "" #. type: =item #: ../fish/guestfish-actions.pod:2587 ../src/guestfs-actions.pod:4121 -msgid "\"ubuntu\"" +msgid "\"suse-based\"" msgstr "" #. type: textblock #: ../fish/guestfish-actions.pod:2589 ../src/guestfs-actions.pod:4123 +msgid "Some openSuSE-derived distro." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:2591 ../src/guestfs-actions.pod:4125 +msgid "\"ttylinux\"" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:2593 ../src/guestfs-actions.pod:4127 +msgid "ttylinux." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:2595 ../src/guestfs-actions.pod:4129 +msgid "\"ubuntu\"" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:2597 ../src/guestfs-actions.pod:4131 msgid "Ubuntu." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2591 ../fish/guestfish-actions.pod:2675 ../fish/guestfish-actions.pod:2952 ../src/guestfs-actions.pod:4125 ../src/guestfs-actions.pod:4234 ../src/guestfs-actions.pod:4622 +#: ../fish/guestfish-actions.pod:2599 ../fish/guestfish-actions.pod:2683 ../fish/guestfish-actions.pod:2960 ../src/guestfs-actions.pod:4133 ../src/guestfs-actions.pod:4242 ../src/guestfs-actions.pod:4630 msgid "\"unknown\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2593 ../src/guestfs-actions.pod:4127 +#: ../fish/guestfish-actions.pod:2601 ../src/guestfs-actions.pod:4135 msgid "The distro could not be determined." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2595 ../fish/guestfish-actions.pod:2932 ../src/guestfs-actions.pod:4129 ../src/guestfs-actions.pod:4602 +#: ../fish/guestfish-actions.pod:2603 ../fish/guestfish-actions.pod:2940 ../src/guestfs-actions.pod:4137 ../src/guestfs-actions.pod:4610 msgid "\"windows\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2597 ../src/guestfs-actions.pod:4131 +#: ../fish/guestfish-actions.pod:2605 ../src/guestfs-actions.pod:4139 msgid "" "Windows does not have distributions. This string is returned if the OS type " "is Windows." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2602 ../fish/guestfish-actions.pod:2681 ../fish/guestfish-actions.pod:2958 ../src/guestfs-actions.pod:4136 ../src/guestfs-actions.pod:4240 ../src/guestfs-actions.pod:4628 +#: ../fish/guestfish-actions.pod:2610 ../fish/guestfish-actions.pod:2689 ../fish/guestfish-actions.pod:2966 ../src/guestfs-actions.pod:4144 ../src/guestfs-actions.pod:4248 ../src/guestfs-actions.pod:4636 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:2607 +#: ../fish/guestfish-actions.pod:2615 msgid "inspect-get-drive-mappings" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2609 +#: ../fish/guestfish-actions.pod:2617 #, no-wrap msgid "" " inspect-get-drive-mappings root\n" @@ -13372,7 +13450,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2611 ../src/guestfs-actions.pod:4152 +#: ../fish/guestfish-actions.pod:2619 ../src/guestfs-actions.pod:4160 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 " @@ -13381,7 +13459,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2617 ../src/guestfs-actions.pod:4158 +#: ../fish/guestfish-actions.pod:2625 ../src/guestfs-actions.pod:4166 #, no-wrap msgid "" " C => /dev/vda2\n" @@ -13391,7 +13469,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2621 ../src/guestfs-actions.pod:4162 +#: ../fish/guestfish-actions.pod:2629 ../src/guestfs-actions.pod:4170 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 " @@ -13399,7 +13477,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2625 ../src/guestfs-actions.pod:4166 +#: ../fish/guestfish-actions.pod:2633 ../src/guestfs-actions.pod:4174 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 " @@ -13408,33 +13486,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2630 ../src/guestfs-actions.pod:4171 +#: ../fish/guestfish-actions.pod:2638 ../src/guestfs-actions.pod:4179 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:2633 ../src/guestfs-actions.pod:4174 +#: ../fish/guestfish-actions.pod:2641 ../src/guestfs-actions.pod:4182 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:2636 +#: ../fish/guestfish-actions.pod:2644 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:2640 +#: ../fish/guestfish-actions.pod:2648 msgid "inspect-get-filesystems" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2642 +#: ../fish/guestfish-actions.pod:2650 #, no-wrap msgid "" " inspect-get-filesystems root\n" @@ -13442,7 +13520,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2644 ../src/guestfs-actions.pod:4195 +#: ../fish/guestfish-actions.pod:2652 ../src/guestfs-actions.pod:4203 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 " @@ -13450,26 +13528,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2649 ../src/guestfs-actions.pod:4200 +#: ../fish/guestfish-actions.pod:2657 ../src/guestfs-actions.pod:4208 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:2652 +#: ../fish/guestfish-actions.pod:2660 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-mountpoints>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2655 +#: ../fish/guestfish-actions.pod:2663 msgid "inspect-get-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2657 +#: ../fish/guestfish-actions.pod:2665 #, no-wrap msgid "" " inspect-get-format root\n" @@ -13477,51 +13555,51 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2659 ../src/guestfs-actions.pod:4218 +#: ../fish/guestfish-actions.pod:2667 ../src/guestfs-actions.pod:4226 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:2662 ../src/guestfs-actions.pod:4221 +#: ../fish/guestfish-actions.pod:2670 ../src/guestfs-actions.pod:4229 msgid "Currently defined formats are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2666 ../src/guestfs-actions.pod:4225 +#: ../fish/guestfish-actions.pod:2674 ../src/guestfs-actions.pod:4233 msgid "\"installed\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2668 ../src/guestfs-actions.pod:4227 +#: ../fish/guestfish-actions.pod:2676 ../src/guestfs-actions.pod:4235 msgid "This is an installed operating system." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2670 ../src/guestfs-actions.pod:4229 +#: ../fish/guestfish-actions.pod:2678 ../src/guestfs-actions.pod:4237 msgid "\"installer\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2672 ../src/guestfs-actions.pod:4231 +#: ../fish/guestfish-actions.pod:2680 ../src/guestfs-actions.pod:4239 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:2677 ../src/guestfs-actions.pod:4236 +#: ../fish/guestfish-actions.pod:2685 ../src/guestfs-actions.pod:4244 msgid "The format of this disk image is not known." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2686 +#: ../fish/guestfish-actions.pod:2694 msgid "inspect-get-hostname" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2688 +#: ../fish/guestfish-actions.pod:2696 #, no-wrap msgid "" " inspect-get-hostname root\n" @@ -13529,26 +13607,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2690 ../src/guestfs-actions.pod:4256 +#: ../fish/guestfish-actions.pod:2698 ../src/guestfs-actions.pod:4264 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:2693 ../src/guestfs-actions.pod:4259 +#: ../fish/guestfish-actions.pod:2701 ../src/guestfs-actions.pod:4267 msgid "" "If the hostname could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2698 +#: ../fish/guestfish-actions.pod:2706 msgid "inspect-get-icon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2700 +#: ../fish/guestfish-actions.pod:2708 #, no-wrap msgid "" " inspect-get-icon root [favicon:true|false] [highquality:true|false]\n" @@ -13556,7 +13634,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2702 ../src/guestfs-actions.pod:4285 +#: ../fish/guestfish-actions.pod:2710 ../src/guestfs-actions.pod:4293 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 " @@ -13564,14 +13642,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2706 ../src/guestfs-actions.pod:4289 +#: ../fish/guestfish-actions.pod:2714 ../src/guestfs-actions.pod:4297 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:2709 ../src/guestfs-actions.pod:4292 +#: ../fish/guestfish-actions.pod:2717 ../src/guestfs-actions.pod:4300 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 " @@ -13580,14 +13658,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2715 ../src/guestfs-actions.pod:4298 +#: ../fish/guestfish-actions.pod:2723 ../src/guestfs-actions.pod:4306 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:2718 ../src/guestfs-actions.pod:4301 +#: ../fish/guestfish-actions.pod:2726 ../src/guestfs-actions.pod:4309 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 " @@ -13596,7 +13674,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2729 ../src/guestfs-actions.pod:4312 +#: ../fish/guestfish-actions.pod:2737 ../src/guestfs-actions.pod:4320 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 " @@ -13604,7 +13682,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2735 ../src/guestfs-actions.pod:4318 +#: ../fish/guestfish-actions.pod:2743 ../src/guestfs-actions.pod:4326 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. " @@ -13613,7 +13691,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2743 ../src/guestfs-actions.pod:4326 +#: ../fish/guestfish-actions.pod:2751 ../src/guestfs-actions.pod:4334 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 " @@ -13621,7 +13699,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2750 ../src/guestfs-actions.pod:4333 +#: ../fish/guestfish-actions.pod:2758 ../src/guestfs-actions.pod:4341 msgid "" "Extracting icons from Windows guests requires the external C<wrestool> " "program from the C<icoutils> package, and several programs (C<bmptopnm>, " @@ -13630,19 +13708,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2757 ../src/guestfs-actions.pod:4340 +#: ../fish/guestfish-actions.pod:2765 ../src/guestfs-actions.pod:4348 msgid "" "Operating system icons are usually trademarks. Seek legal advice before " "using trademarks in applications." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2764 +#: ../fish/guestfish-actions.pod:2772 msgid "inspect-get-major-version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2766 +#: ../fish/guestfish-actions.pod:2774 #, no-wrap msgid "" " inspect-get-major-version root\n" @@ -13650,12 +13728,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2768 ../src/guestfs-actions.pod:4381 +#: ../fish/guestfish-actions.pod:2776 ../src/guestfs-actions.pod:4389 msgid "This returns the major version number of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2771 ../src/guestfs-actions.pod:4384 +#: ../fish/guestfish-actions.pod:2779 ../src/guestfs-actions.pod:4392 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 " @@ -13665,17 +13743,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2778 ../fish/guestfish-actions.pod:2789 ../src/guestfs-actions.pod:4391 ../src/guestfs-actions.pod:4408 +#: ../fish/guestfish-actions.pod:2786 ../fish/guestfish-actions.pod:2797 ../src/guestfs-actions.pod:4399 ../src/guestfs-actions.pod:4416 msgid "If the version could not be determined, then C<0> is returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2782 +#: ../fish/guestfish-actions.pod:2790 msgid "inspect-get-minor-version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2784 +#: ../fish/guestfish-actions.pod:2792 #, no-wrap msgid "" " inspect-get-minor-version root\n" @@ -13683,24 +13761,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2786 ../src/guestfs-actions.pod:4405 +#: ../fish/guestfish-actions.pod:2794 ../src/guestfs-actions.pod:4413 msgid "This returns the minor version number of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2791 +#: ../fish/guestfish-actions.pod:2799 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-major-version>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2794 +#: ../fish/guestfish-actions.pod:2802 msgid "inspect-get-mountpoints" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2796 +#: ../fish/guestfish-actions.pod:2804 #, no-wrap msgid "" " inspect-get-mountpoints root\n" @@ -13708,7 +13786,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2798 ../src/guestfs-actions.pod:4423 +#: ../fish/guestfish-actions.pod:2806 ../src/guestfs-actions.pod:4431 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 " @@ -13719,7 +13797,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2807 ../src/guestfs-actions.pod:4432 +#: ../fish/guestfish-actions.pod:2815 ../src/guestfs-actions.pod:4440 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 " @@ -13727,12 +13805,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2812 ../src/guestfs-actions.pod:4437 +#: ../fish/guestfish-actions.pod:2820 ../src/guestfs-actions.pod:4445 msgid "Non-mounted devices such as swap devices are I<not> returned in this list." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2815 +#: ../fish/guestfish-actions.pod:2823 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 " @@ -13741,19 +13819,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2821 +#: ../fish/guestfish-actions.pod:2829 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2824 +#: ../fish/guestfish-actions.pod:2832 msgid "inspect-get-package-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2826 +#: ../fish/guestfish-actions.pod:2834 #, no-wrap msgid "" " inspect-get-package-format root\n" @@ -13761,7 +13839,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2828 +#: ../fish/guestfish-actions.pod:2836 msgid "" "This function and L</inspect-get-package-management> return the package " "format and package management tool used by the inspected operating system. " @@ -13770,7 +13848,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2834 ../src/guestfs-actions.pod:4469 +#: ../fish/guestfish-actions.pod:2842 ../src/guestfs-actions.pod:4477 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 " @@ -13778,19 +13856,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2838 ../src/guestfs-actions.pod:4473 +#: ../fish/guestfish-actions.pod:2846 ../src/guestfs-actions.pod:4481 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:2844 +#: ../fish/guestfish-actions.pod:2852 msgid "inspect-get-package-management" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2846 +#: ../fish/guestfish-actions.pod:2854 #, no-wrap msgid "" " inspect-get-package-management root\n" @@ -13798,7 +13876,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2848 +#: ../fish/guestfish-actions.pod:2856 msgid "" "L</inspect-get-package-format> and this function return the package format " "and package management tool used by the inspected operating system. For " @@ -13807,7 +13885,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2854 ../src/guestfs-actions.pod:4496 +#: ../fish/guestfish-actions.pod:2862 ../src/guestfs-actions.pod:4504 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 " @@ -13815,7 +13893,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2858 ../src/guestfs-actions.pod:4500 +#: ../fish/guestfish-actions.pod:2866 ../src/guestfs-actions.pod:4508 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 " @@ -13823,12 +13901,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2865 +#: ../fish/guestfish-actions.pod:2873 msgid "inspect-get-product-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2867 +#: ../fish/guestfish-actions.pod:2875 #, no-wrap msgid "" " inspect-get-product-name root\n" @@ -13836,7 +13914,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2869 ../src/guestfs-actions.pod:4518 +#: ../fish/guestfish-actions.pod:2877 ../src/guestfs-actions.pod:4526 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 " @@ -13844,19 +13922,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2874 ../src/guestfs-actions.pod:4523 +#: ../fish/guestfish-actions.pod:2882 ../src/guestfs-actions.pod:4531 msgid "" "If the product name could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2879 +#: ../fish/guestfish-actions.pod:2887 msgid "inspect-get-product-variant" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2881 +#: ../fish/guestfish-actions.pod:2889 #, no-wrap msgid "" " inspect-get-product-variant root\n" @@ -13864,12 +13942,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2883 ../src/guestfs-actions.pod:4539 +#: ../fish/guestfish-actions.pod:2891 ../src/guestfs-actions.pod:4547 msgid "This returns the product variant of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2886 ../src/guestfs-actions.pod:4542 +#: ../fish/guestfish-actions.pod:2894 ../src/guestfs-actions.pod:4550 msgid "" "For Windows guests, this returns the contents of the Registry key " "C<HKLM\\Software\\Microsoft\\Windows NT\\CurrentVersion> C<InstallationType> " @@ -13881,7 +13959,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2895 ../src/guestfs-actions.pod:4551 +#: ../fish/guestfish-actions.pod:2903 ../src/guestfs-actions.pod:4559 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 " @@ -13889,26 +13967,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2899 ../src/guestfs-actions.pod:4555 +#: ../fish/guestfish-actions.pod:2907 ../src/guestfs-actions.pod:4563 msgid "" "If the product variant could not be determined, then the string C<unknown> " "is returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2902 +#: ../fish/guestfish-actions.pod:2910 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:2906 +#: ../fish/guestfish-actions.pod:2914 msgid "inspect-get-roots" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2908 +#: ../fish/guestfish-actions.pod:2916 #, no-wrap msgid "" " inspect-get-roots\n" @@ -13916,7 +13994,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2910 +#: ../fish/guestfish-actions.pod:2918 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 " @@ -13924,19 +14002,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2914 +#: ../fish/guestfish-actions.pod:2922 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:2919 +#: ../fish/guestfish-actions.pod:2927 msgid "inspect-get-type" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2921 +#: ../fish/guestfish-actions.pod:2929 #, no-wrap msgid "" " inspect-get-type root\n" @@ -13944,79 +14022,79 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2923 ../src/guestfs-actions.pod:4593 +#: ../fish/guestfish-actions.pod:2931 ../src/guestfs-actions.pod:4601 msgid "" "This returns the type of the inspected operating system. Currently defined " "types are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2928 ../src/guestfs-actions.pod:4598 +#: ../fish/guestfish-actions.pod:2936 ../src/guestfs-actions.pod:4606 msgid "\"linux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2930 ../src/guestfs-actions.pod:4600 +#: ../fish/guestfish-actions.pod:2938 ../src/guestfs-actions.pod:4608 msgid "Any Linux-based operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2934 ../src/guestfs-actions.pod:4604 +#: ../fish/guestfish-actions.pod:2942 ../src/guestfs-actions.pod:4612 msgid "Any Microsoft Windows operating system." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2936 ../src/guestfs-actions.pod:4606 +#: ../fish/guestfish-actions.pod:2944 ../src/guestfs-actions.pod:4614 msgid "\"freebsd\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2938 ../src/guestfs-actions.pod:4608 +#: ../fish/guestfish-actions.pod:2946 ../src/guestfs-actions.pod:4616 msgid "FreeBSD." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2940 ../src/guestfs-actions.pod:4610 +#: ../fish/guestfish-actions.pod:2948 ../src/guestfs-actions.pod:4618 msgid "\"netbsd\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2942 ../src/guestfs-actions.pod:4612 +#: ../fish/guestfish-actions.pod:2950 ../src/guestfs-actions.pod:4620 msgid "NetBSD." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2944 ../src/guestfs-actions.pod:4614 +#: ../fish/guestfish-actions.pod:2952 ../src/guestfs-actions.pod:4622 msgid "\"hurd\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2946 ../src/guestfs-actions.pod:4616 +#: ../fish/guestfish-actions.pod:2954 ../src/guestfs-actions.pod:4624 msgid "GNU/Hurd." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2948 ../src/guestfs-actions.pod:4618 +#: ../fish/guestfish-actions.pod:2956 ../src/guestfs-actions.pod:4626 msgid "\"dos\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2950 ../src/guestfs-actions.pod:4620 +#: ../fish/guestfish-actions.pod:2958 ../src/guestfs-actions.pod:4628 msgid "MS-DOS, FreeDOS and others." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2954 ../src/guestfs-actions.pod:4624 +#: ../fish/guestfish-actions.pod:2962 ../src/guestfs-actions.pod:4632 msgid "The operating system type could not be determined." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2963 +#: ../fish/guestfish-actions.pod:2971 msgid "inspect-get-windows-current-control-set" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2965 +#: ../fish/guestfish-actions.pod:2973 #, no-wrap msgid "" " inspect-get-windows-current-control-set root\n" @@ -14024,26 +14102,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2967 ../src/guestfs-actions.pod:4644 +#: ../fish/guestfish-actions.pod:2975 ../src/guestfs-actions.pod:4652 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:2970 ../src/guestfs-actions.pod:4647 +#: ../fish/guestfish-actions.pod:2978 ../src/guestfs-actions.pod:4655 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:2976 +#: ../fish/guestfish-actions.pod:2984 msgid "inspect-get-windows-systemroot" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2978 +#: ../fish/guestfish-actions.pod:2986 #, no-wrap msgid "" " inspect-get-windows-systemroot root\n" @@ -14051,14 +14129,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2980 ../src/guestfs-actions.pod:4664 +#: ../fish/guestfish-actions.pod:2988 ../src/guestfs-actions.pod:4672 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:2983 ../src/guestfs-actions.pod:4667 +#: ../fish/guestfish-actions.pod:2991 ../src/guestfs-actions.pod:4675 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 " @@ -14066,12 +14144,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2989 +#: ../fish/guestfish-actions.pod:2997 msgid "inspect-is-live" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2991 +#: ../fish/guestfish-actions.pod:2999 #, no-wrap msgid "" " inspect-is-live root\n" @@ -14079,19 +14157,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2993 +#: ../fish/guestfish-actions.pod:3001 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:2999 +#: ../fish/guestfish-actions.pod:3007 msgid "inspect-is-multipart" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3001 +#: ../fish/guestfish-actions.pod:3009 #, no-wrap msgid "" " inspect-is-multipart root\n" @@ -14099,19 +14177,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3003 +#: ../fish/guestfish-actions.pod:3011 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:3009 +#: ../fish/guestfish-actions.pod:3017 msgid "inspect-is-netinst" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3011 +#: ../fish/guestfish-actions.pod:3019 #, no-wrap msgid "" " inspect-is-netinst root\n" @@ -14119,7 +14197,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3013 +#: ../fish/guestfish-actions.pod:3021 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 " @@ -14128,12 +14206,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3021 +#: ../fish/guestfish-actions.pod:3029 msgid "inspect-list-applications" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3023 +#: ../fish/guestfish-actions.pod:3031 #, no-wrap msgid "" " inspect-list-applications root\n" @@ -14141,12 +14219,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3025 ../src/guestfs-actions.pod:4734 +#: ../fish/guestfish-actions.pod:3033 ../src/guestfs-actions.pod:4742 msgid "Return the list of applications installed in the operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3027 +#: ../fish/guestfish-actions.pod:3035 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>, " @@ -14158,91 +14236,91 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3037 ../src/guestfs-actions.pod:4746 +#: ../fish/guestfish-actions.pod:3045 ../src/guestfs-actions.pod:4754 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:3040 ../src/guestfs-actions.pod:4749 +#: ../fish/guestfish-actions.pod:3048 ../src/guestfs-actions.pod:4757 msgid "The application structure contains the following fields:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3044 ../src/guestfs-actions.pod:4753 +#: ../fish/guestfish-actions.pod:3052 ../src/guestfs-actions.pod:4761 msgid "C<app_name>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3046 ../src/guestfs-actions.pod:4755 +#: ../fish/guestfish-actions.pod:3054 ../src/guestfs-actions.pod:4763 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:3049 ../src/guestfs-actions.pod:4758 +#: ../fish/guestfish-actions.pod:3057 ../src/guestfs-actions.pod:4766 msgid "C<app_display_name>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3051 ../src/guestfs-actions.pod:4760 +#: ../fish/guestfish-actions.pod:3059 ../src/guestfs-actions.pod:4768 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:3054 ../src/guestfs-actions.pod:4763 +#: ../fish/guestfish-actions.pod:3062 ../src/guestfs-actions.pod:4771 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:3057 ../src/guestfs-actions.pod:4766 +#: ../fish/guestfish-actions.pod:3065 ../src/guestfs-actions.pod:4774 msgid "C<app_epoch>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3059 ../src/guestfs-actions.pod:4768 +#: ../fish/guestfish-actions.pod:3067 ../src/guestfs-actions.pod:4776 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:3062 ../src/guestfs-actions.pod:4771 +#: ../fish/guestfish-actions.pod:3070 ../src/guestfs-actions.pod:4779 msgid "C<app_version>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3064 ../src/guestfs-actions.pod:4773 +#: ../fish/guestfish-actions.pod:3072 ../src/guestfs-actions.pod:4781 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:3067 ../src/guestfs-actions.pod:4776 +#: ../fish/guestfish-actions.pod:3075 ../src/guestfs-actions.pod:4784 msgid "C<app_release>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3069 ../src/guestfs-actions.pod:4778 +#: ../fish/guestfish-actions.pod:3077 ../src/guestfs-actions.pod:4786 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:3073 ../src/guestfs-actions.pod:4782 +#: ../fish/guestfish-actions.pod:3081 ../src/guestfs-actions.pod:4790 msgid "C<app_install_path>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3075 ../src/guestfs-actions.pod:4784 +#: ../fish/guestfish-actions.pod:3083 ../src/guestfs-actions.pod:4792 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 " @@ -14250,89 +14328,89 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3080 ../src/guestfs-actions.pod:4789 +#: ../fish/guestfish-actions.pod:3088 ../src/guestfs-actions.pod:4797 msgid "If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3082 ../src/guestfs-actions.pod:4791 +#: ../fish/guestfish-actions.pod:3090 ../src/guestfs-actions.pod:4799 msgid "C<app_trans_path>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3084 ../src/guestfs-actions.pod:4793 +#: ../fish/guestfish-actions.pod:3092 ../src/guestfs-actions.pod:4801 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:3087 ../src/guestfs-actions.pod:4796 +#: ../fish/guestfish-actions.pod:3095 ../src/guestfs-actions.pod:4804 msgid "C<app_publisher>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3089 ../src/guestfs-actions.pod:4798 +#: ../fish/guestfish-actions.pod:3097 ../src/guestfs-actions.pod:4806 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:3093 ../src/guestfs-actions.pod:4802 +#: ../fish/guestfish-actions.pod:3101 ../src/guestfs-actions.pod:4810 msgid "C<app_url>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3095 ../src/guestfs-actions.pod:4804 +#: ../fish/guestfish-actions.pod:3103 ../src/guestfs-actions.pod:4812 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:3098 ../src/guestfs-actions.pod:4807 +#: ../fish/guestfish-actions.pod:3106 ../src/guestfs-actions.pod:4815 msgid "C<app_source_package>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3100 ../src/guestfs-actions.pod:4809 +#: ../fish/guestfish-actions.pod:3108 ../src/guestfs-actions.pod:4817 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:3103 ../src/guestfs-actions.pod:4812 +#: ../fish/guestfish-actions.pod:3111 ../src/guestfs-actions.pod:4820 msgid "C<app_summary>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3105 ../src/guestfs-actions.pod:4814 +#: ../fish/guestfish-actions.pod:3113 ../src/guestfs-actions.pod:4822 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:3108 ../src/guestfs-actions.pod:4817 +#: ../fish/guestfish-actions.pod:3116 ../src/guestfs-actions.pod:4825 msgid "C<app_description>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3110 ../src/guestfs-actions.pod:4819 +#: ../fish/guestfish-actions.pod:3118 ../src/guestfs-actions.pod:4827 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:3117 +#: ../fish/guestfish-actions.pod:3125 msgid "inspect-os" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3119 +#: ../fish/guestfish-actions.pod:3127 #, no-wrap msgid "" " inspect-os\n" @@ -14340,7 +14418,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3121 ../src/guestfs-actions.pod:4837 +#: ../fish/guestfish-actions.pod:3129 ../src/guestfs-actions.pod:4845 msgid "" "This function uses other libguestfs functions and certain heuristics to " "inspect the disk(s) (usually disks belonging to a virtual machine), looking " @@ -14348,12 +14426,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3125 ../src/guestfs-actions.pod:4841 +#: ../fish/guestfish-actions.pod:3133 ../src/guestfs-actions.pod:4849 msgid "The list returned is empty if no operating systems were found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3127 ../src/guestfs-actions.pod:4843 +#: ../fish/guestfish-actions.pod:3135 ../src/guestfs-actions.pod:4851 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. " @@ -14363,7 +14441,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3134 +#: ../fish/guestfish-actions.pod:3142 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, " @@ -14371,7 +14449,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3139 +#: ../fish/guestfish-actions.pod:3147 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 " @@ -14380,24 +14458,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3145 ../src/guestfs-actions.pod:4861 +#: ../fish/guestfish-actions.pod:3153 ../src/guestfs-actions.pod:4869 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:3151 ../fish/guestfish-actions.pod:3374 ../fish/guestfish-actions.pod:3439 +#: ../fish/guestfish-actions.pod:3159 ../fish/guestfish-actions.pod:3382 ../fish/guestfish-actions.pod:3447 msgid "See also L</list-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3153 +#: ../fish/guestfish-actions.pod:3161 msgid "is-blockdev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3155 +#: ../fish/guestfish-actions.pod:3163 #, no-wrap msgid "" " is-blockdev path\n" @@ -14405,24 +14483,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3157 ../src/guestfs-actions.pod:4881 +#: ../fish/guestfish-actions.pod:3165 ../src/guestfs-actions.pod:4889 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:3160 ../fish/guestfish-actions.pod:3169 ../fish/guestfish-actions.pod:3188 ../fish/guestfish-actions.pod:3197 ../fish/guestfish-actions.pod:3207 ../fish/guestfish-actions.pod:3241 ../fish/guestfish-actions.pod:3250 +#: ../fish/guestfish-actions.pod:3168 ../fish/guestfish-actions.pod:3177 ../fish/guestfish-actions.pod:3196 ../fish/guestfish-actions.pod:3205 ../fish/guestfish-actions.pod:3215 ../fish/guestfish-actions.pod:3249 ../fish/guestfish-actions.pod:3258 msgid "See also L</stat>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3162 +#: ../fish/guestfish-actions.pod:3170 msgid "is-chardev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3164 +#: ../fish/guestfish-actions.pod:3172 #, no-wrap msgid "" " is-chardev path\n" @@ -14430,19 +14508,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3166 ../src/guestfs-actions.pod:4896 +#: ../fish/guestfish-actions.pod:3174 ../src/guestfs-actions.pod:4904 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:3171 +#: ../fish/guestfish-actions.pod:3179 msgid "is-config" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3173 +#: ../fish/guestfish-actions.pod:3181 #, no-wrap msgid "" " is-config\n" @@ -14450,19 +14528,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3175 ../src/guestfs-actions.pod:4910 +#: ../fish/guestfish-actions.pod:3183 ../src/guestfs-actions.pod:4918 msgid "" "This returns true iff this handle is being configured (in the C<CONFIG> " "state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3180 +#: ../fish/guestfish-actions.pod:3188 msgid "is-dir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3182 +#: ../fish/guestfish-actions.pod:3190 #, no-wrap msgid "" " is-dir path\n" @@ -14470,19 +14548,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3184 ../src/guestfs-actions.pod:4925 +#: ../fish/guestfish-actions.pod:3192 ../src/guestfs-actions.pod:4933 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:3190 +#: ../fish/guestfish-actions.pod:3198 msgid "is-fifo" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3192 +#: ../fish/guestfish-actions.pod:3200 #, no-wrap msgid "" " is-fifo path\n" @@ -14490,19 +14568,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3194 ../src/guestfs-actions.pod:4941 +#: ../fish/guestfish-actions.pod:3202 ../src/guestfs-actions.pod:4949 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:3199 +#: ../fish/guestfish-actions.pod:3207 msgid "is-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3201 +#: ../fish/guestfish-actions.pod:3209 #, no-wrap msgid "" " is-file path\n" @@ -14510,7 +14588,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3203 ../src/guestfs-actions.pod:4956 +#: ../fish/guestfish-actions.pod:3211 ../src/guestfs-actions.pod:4964 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 " @@ -14518,12 +14596,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3209 +#: ../fish/guestfish-actions.pod:3217 msgid "is-launching" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3211 +#: ../fish/guestfish-actions.pod:3219 #, no-wrap msgid "" " is-launching\n" @@ -14531,19 +14609,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3213 ../src/guestfs-actions.pod:4971 +#: ../fish/guestfish-actions.pod:3221 ../src/guestfs-actions.pod:4979 msgid "" "This returns true iff this handle is launching the subprocess (in the " "C<LAUNCHING> state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3218 +#: ../fish/guestfish-actions.pod:3226 msgid "is-lv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3220 +#: ../fish/guestfish-actions.pod:3228 #, no-wrap msgid "" " is-lv device\n" @@ -14551,19 +14629,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3222 ../src/guestfs-actions.pod:4986 +#: ../fish/guestfish-actions.pod:3230 ../src/guestfs-actions.pod:4994 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:3225 +#: ../fish/guestfish-actions.pod:3233 msgid "is-ready" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3227 +#: ../fish/guestfish-actions.pod:3235 #, no-wrap msgid "" " is-ready\n" @@ -14571,19 +14649,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3229 ../src/guestfs-actions.pod:4998 +#: ../fish/guestfish-actions.pod:3237 ../src/guestfs-actions.pod:5006 msgid "" "This returns true iff this handle is ready to accept commands (in the " "C<READY> state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3234 +#: ../fish/guestfish-actions.pod:3242 msgid "is-socket" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3236 +#: ../fish/guestfish-actions.pod:3244 #, no-wrap msgid "" " is-socket path\n" @@ -14591,19 +14669,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3238 ../src/guestfs-actions.pod:5013 +#: ../fish/guestfish-actions.pod:3246 ../src/guestfs-actions.pod:5021 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:3243 +#: ../fish/guestfish-actions.pod:3251 msgid "is-symlink" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3245 +#: ../fish/guestfish-actions.pod:3253 #, no-wrap msgid "" " is-symlink path\n" @@ -14611,19 +14689,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3247 ../src/guestfs-actions.pod:5028 +#: ../fish/guestfish-actions.pod:3255 ../src/guestfs-actions.pod:5036 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:3252 +#: ../fish/guestfish-actions.pod:3260 msgid "is-zero" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3254 +#: ../fish/guestfish-actions.pod:3262 #, no-wrap msgid "" " is-zero path\n" @@ -14631,19 +14709,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3256 ../src/guestfs-actions.pod:5043 +#: ../fish/guestfish-actions.pod:3264 ../src/guestfs-actions.pod:5051 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:3259 +#: ../fish/guestfish-actions.pod:3267 msgid "is-zero-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3261 +#: ../fish/guestfish-actions.pod:3269 #, no-wrap msgid "" " is-zero-device device\n" @@ -14651,22 +14729,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3263 ../src/guestfs-actions.pod:5056 +#: ../fish/guestfish-actions.pod:3271 ../src/guestfs-actions.pod:5064 msgid "This returns true iff the device exists and contains all zero bytes." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3265 ../src/guestfs-actions.pod:5058 +#: ../fish/guestfish-actions.pod:3273 ../src/guestfs-actions.pod:5066 msgid "Note that for large devices this can take a long time to run." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3267 +#: ../fish/guestfish-actions.pod:3275 msgid "isoinfo" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3269 +#: ../fish/guestfish-actions.pod:3277 #, no-wrap msgid "" " isoinfo isofile\n" @@ -14674,7 +14752,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3271 +#: ../fish/guestfish-actions.pod:3279 msgid "" "This is the same as L</isoinfo-device> except that it works for an ISO file " "located inside some other mounted filesystem. Note that in the common case " @@ -14683,12 +14761,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3277 +#: ../fish/guestfish-actions.pod:3285 msgid "isoinfo-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3279 +#: ../fish/guestfish-actions.pod:3287 #, no-wrap msgid "" " isoinfo-device device\n" @@ -14696,7 +14774,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3281 ../src/guestfs-actions.pod:5088 +#: ../fish/guestfish-actions.pod:3289 ../src/guestfs-actions.pod:5096 msgid "" "C<device> is an ISO device. This returns a struct of information read from " "the primary volume descriptor (the ISO equivalent of the superblock) of the " @@ -14704,7 +14782,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3285 ../src/guestfs-actions.pod:5092 +#: ../fish/guestfish-actions.pod:3293 ../src/guestfs-actions.pod:5100 msgid "" "Usually it is more efficient to use the L<isoinfo(1)> command with the I<-d> " "option on the host to analyze ISO files, instead of going through " @@ -14712,19 +14790,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3289 ../src/guestfs-actions.pod:5096 +#: ../fish/guestfish-actions.pod:3297 ../src/guestfs-actions.pod:5104 msgid "" "For information on the primary volume descriptor fields, see " "L<http://wiki.osdev.org/ISO_9660#The_Primary_Volume_Descriptor>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3292 +#: ../fish/guestfish-actions.pod:3300 msgid "kill-subprocess" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3294 +#: ../fish/guestfish-actions.pod:3302 #, no-wrap msgid "" " kill-subprocess\n" @@ -14732,34 +14810,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3296 ../src/guestfs-actions.pod:5117 +#: ../fish/guestfish-actions.pod:3304 ../src/guestfs-actions.pod:5125 msgid "This kills the qemu subprocess." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3298 +#: ../fish/guestfish-actions.pod:3306 msgid "Do not call this. See: L</shutdown> instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3300 +#: ../fish/guestfish-actions.pod:3308 msgid "" "I<This function is deprecated.> In new code, use the L</shutdown> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3307 +#: ../fish/guestfish-actions.pod:3315 msgid "launch" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3309 +#: ../fish/guestfish-actions.pod:3317 msgid "run" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3311 +#: ../fish/guestfish-actions.pod:3319 #, no-wrap msgid "" " launch\n" @@ -14767,26 +14845,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3313 ../src/guestfs-actions.pod:5130 +#: ../fish/guestfish-actions.pod:3321 ../src/guestfs-actions.pod:5138 msgid "" "Internally libguestfs is implemented by running a virtual machine using " "L<qemu(1)>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3316 ../src/guestfs-actions.pod:5133 +#: ../fish/guestfish-actions.pod:3324 ../src/guestfs-actions.pod:5141 msgid "" "You should call this after configuring the handle (eg. adding drives) but " "before performing any actions." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3319 +#: ../fish/guestfish-actions.pod:3327 msgid "lchown" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3321 +#: ../fish/guestfish-actions.pod:3329 #, no-wrap msgid "" " lchown owner group path\n" @@ -14794,7 +14872,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3323 +#: ../fish/guestfish-actions.pod:3331 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 " @@ -14802,12 +14880,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3331 +#: ../fish/guestfish-actions.pod:3339 msgid "lgetxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3333 +#: ../fish/guestfish-actions.pod:3341 #, no-wrap msgid "" " lgetxattr path name\n" @@ -14815,24 +14893,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3335 ../src/guestfs-actions.pod:5173 +#: ../fish/guestfish-actions.pod:3343 ../src/guestfs-actions.pod:5181 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:3349 +#: ../fish/guestfish-actions.pod:3357 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3351 +#: ../fish/guestfish-actions.pod:3359 msgid "lgetxattrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3353 +#: ../fish/guestfish-actions.pod:3361 #, no-wrap msgid "" " lgetxattrs path\n" @@ -14840,19 +14918,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3355 +#: ../fish/guestfish-actions.pod:3363 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:3359 +#: ../fish/guestfish-actions.pod:3367 msgid "list-9p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3361 +#: ../fish/guestfish-actions.pod:3369 #, no-wrap msgid "" " list-9p\n" @@ -14860,19 +14938,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3363 ../src/guestfs-actions.pod:5216 +#: ../fish/guestfish-actions.pod:3371 ../src/guestfs-actions.pod:5224 msgid "" "List all 9p filesystems attached to the guest. A list of mount tags is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3366 +#: ../fish/guestfish-actions.pod:3374 msgid "list-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3368 +#: ../fish/guestfish-actions.pod:3376 #, no-wrap msgid "" " list-devices\n" @@ -14880,22 +14958,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3370 ../src/guestfs-actions.pod:5230 +#: ../fish/guestfish-actions.pod:3378 ../src/guestfs-actions.pod:5238 msgid "List all the block devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3372 ../src/guestfs-actions.pod:5232 +#: ../fish/guestfish-actions.pod:3380 ../src/guestfs-actions.pod:5240 msgid "The full block device names are returned, eg. C</dev/sda>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3376 +#: ../fish/guestfish-actions.pod:3384 msgid "list-dm-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3378 +#: ../fish/guestfish-actions.pod:3386 #, no-wrap msgid "" " list-dm-devices\n" @@ -14903,31 +14981,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3380 ../src/guestfs-actions.pod:5247 +#: ../fish/guestfish-actions.pod:3388 ../src/guestfs-actions.pod:5255 msgid "List all device mapper devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3382 +#: ../fish/guestfish-actions.pod:3390 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:3385 +#: ../fish/guestfish-actions.pod:3393 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:3389 +#: ../fish/guestfish-actions.pod:3397 msgid "list-filesystems" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3391 +#: ../fish/guestfish-actions.pod:3399 #, no-wrap msgid "" " list-filesystems\n" @@ -14935,7 +15013,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3393 ../src/guestfs-actions.pod:5267 +#: ../fish/guestfish-actions.pod:3401 ../src/guestfs-actions.pod:5275 msgid "" "This inspection command looks for filesystems on partitions, block devices " "and logical volumes, returning a list of devices containing filesystems and " @@ -14943,14 +15021,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3397 ../src/guestfs-actions.pod:5271 +#: ../fish/guestfish-actions.pod:3405 ../src/guestfs-actions.pod:5279 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:3401 ../src/guestfs-actions.pod:5275 +#: ../fish/guestfish-actions.pod:3409 ../src/guestfs-actions.pod:5283 #, no-wrap msgid "" " \"/dev/sda1\" => \"ntfs\"\n" @@ -14961,14 +15039,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3406 ../src/guestfs-actions.pod:5280 +#: ../fish/guestfish-actions.pod:3414 ../src/guestfs-actions.pod:5288 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:3410 +#: ../fish/guestfish-actions.pod:3418 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 " @@ -14976,7 +15054,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3414 +#: ../fish/guestfish-actions.pod:3422 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 " @@ -14986,12 +15064,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3422 +#: ../fish/guestfish-actions.pod:3430 msgid "list-md-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3424 +#: ../fish/guestfish-actions.pod:3432 #, no-wrap msgid "" " list-md-devices\n" @@ -14999,17 +15077,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3426 ../src/guestfs-actions.pod:5309 +#: ../fish/guestfish-actions.pod:3434 ../src/guestfs-actions.pod:5317 msgid "List all Linux md devices." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3428 +#: ../fish/guestfish-actions.pod:3436 msgid "list-partitions" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3430 +#: ../fish/guestfish-actions.pod:3438 #, no-wrap msgid "" " list-partitions\n" @@ -15017,29 +15095,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3432 ../src/guestfs-actions.pod:5322 +#: ../fish/guestfish-actions.pod:3440 ../src/guestfs-actions.pod:5330 msgid "List all the partitions detected on all block devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3434 ../src/guestfs-actions.pod:5324 +#: ../fish/guestfish-actions.pod:3442 ../src/guestfs-actions.pod:5332 msgid "The full partition device names are returned, eg. C</dev/sda1>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3436 +#: ../fish/guestfish-actions.pod:3444 msgid "" "This does not return logical volumes. For that you will need to call " "L</lvs>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3441 +#: ../fish/guestfish-actions.pod:3449 msgid "ll" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3443 +#: ../fish/guestfish-actions.pod:3451 #, no-wrap msgid "" " ll directory\n" @@ -15047,26 +15125,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3445 ../src/guestfs-actions.pod:5343 +#: ../fish/guestfish-actions.pod:3453 ../src/guestfs-actions.pod:5351 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:3448 ../fish/guestfish-actions.pod:3457 ../src/guestfs-actions.pod:5346 ../src/guestfs-actions.pod:5362 +#: ../fish/guestfish-actions.pod:3456 ../fish/guestfish-actions.pod:3465 ../src/guestfs-actions.pod:5354 ../src/guestfs-actions.pod:5370 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:3451 +#: ../fish/guestfish-actions.pod:3459 msgid "llz" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3453 +#: ../fish/guestfish-actions.pod:3461 #, no-wrap msgid "" " llz directory\n" @@ -15074,17 +15152,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3455 ../src/guestfs-actions.pod:5360 +#: ../fish/guestfish-actions.pod:3463 ../src/guestfs-actions.pod:5368 msgid "List the files in C<directory> in the format of 'ls -laZ'." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3460 +#: ../fish/guestfish-actions.pod:3468 msgid "ln" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3462 +#: ../fish/guestfish-actions.pod:3470 #, no-wrap msgid "" " ln target linkname\n" @@ -15092,17 +15170,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3464 ../src/guestfs-actions.pod:5377 +#: ../fish/guestfish-actions.pod:3472 ../src/guestfs-actions.pod:5385 msgid "This command creates a hard link using the C<ln> command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3466 +#: ../fish/guestfish-actions.pod:3474 msgid "ln-f" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3468 +#: ../fish/guestfish-actions.pod:3476 #, no-wrap msgid "" " ln-f target linkname\n" @@ -15110,19 +15188,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3470 ../src/guestfs-actions.pod:5390 +#: ../fish/guestfish-actions.pod:3478 ../src/guestfs-actions.pod:5398 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:3473 +#: ../fish/guestfish-actions.pod:3481 msgid "ln-s" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3475 +#: ../fish/guestfish-actions.pod:3483 #, no-wrap msgid "" " ln-s target linkname\n" @@ -15130,17 +15208,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3477 ../src/guestfs-actions.pod:5404 +#: ../fish/guestfish-actions.pod:3485 ../src/guestfs-actions.pod:5412 msgid "This command creates a symbolic link using the C<ln -s> command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3479 +#: ../fish/guestfish-actions.pod:3487 msgid "ln-sf" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3481 +#: ../fish/guestfish-actions.pod:3489 #, no-wrap msgid "" " ln-sf target linkname\n" @@ -15148,19 +15226,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3483 ../src/guestfs-actions.pod:5417 +#: ../fish/guestfish-actions.pod:3491 ../src/guestfs-actions.pod:5425 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:3486 +#: ../fish/guestfish-actions.pod:3494 msgid "lremovexattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3488 +#: ../fish/guestfish-actions.pod:3496 #, no-wrap msgid "" " lremovexattr xattr path\n" @@ -15168,19 +15246,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3490 +#: ../fish/guestfish-actions.pod:3498 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:3494 +#: ../fish/guestfish-actions.pod:3502 msgid "ls" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3496 +#: ../fish/guestfish-actions.pod:3504 #, no-wrap msgid "" " ls directory\n" @@ -15188,7 +15266,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3498 ../src/guestfs-actions.pod:5445 +#: ../fish/guestfish-actions.pod:3506 ../src/guestfs-actions.pod:5453 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 " @@ -15196,12 +15274,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3502 +#: ../fish/guestfish-actions.pod:3510 msgid "ls0" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3504 +#: ../fish/guestfish-actions.pod:3512 #, no-wrap msgid "" " ls0 dir (filenames|-)\n" @@ -15209,7 +15287,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3506 ../src/guestfs-actions.pod:5462 +#: ../fish/guestfish-actions.pod:3514 ../src/guestfs-actions.pod:5470 msgid "" "This specialized command is used to get a listing of the filenames in the " "directory C<dir>. The list of filenames is written to the local file " @@ -15217,22 +15295,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3510 ../src/guestfs-actions.pod:5466 +#: ../fish/guestfish-actions.pod:3518 ../src/guestfs-actions.pod:5474 msgid "In the output file, the filenames are separated by C<\\0> characters." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3512 ../src/guestfs-actions.pod:5468 +#: ../fish/guestfish-actions.pod:3520 ../src/guestfs-actions.pod:5476 msgid "C<.> and C<..> are not returned. The filenames are not sorted." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3516 +#: ../fish/guestfish-actions.pod:3524 msgid "lsetxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3518 +#: ../fish/guestfish-actions.pod:3526 #, no-wrap msgid "" " lsetxattr xattr val vallen path\n" @@ -15240,19 +15318,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3520 +#: ../fish/guestfish-actions.pod:3528 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:3524 +#: ../fish/guestfish-actions.pod:3532 msgid "lstat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3526 +#: ../fish/guestfish-actions.pod:3534 #, no-wrap msgid "" " lstat path\n" @@ -15260,29 +15338,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3528 ../fish/guestfish-actions.pod:5818 ../src/guestfs-actions.pod:5497 ../src/guestfs-actions.pod:9245 +#: ../fish/guestfish-actions.pod:3536 ../fish/guestfish-actions.pod:5826 ../src/guestfs-actions.pod:5505 ../src/guestfs-actions.pod:9253 msgid "Returns file information for the given C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3530 +#: ../fish/guestfish-actions.pod:3538 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:3534 ../src/guestfs-actions.pod:5503 +#: ../fish/guestfish-actions.pod:3542 ../src/guestfs-actions.pod:5511 msgid "This is the same as the C<lstat(2)> system call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3536 +#: ../fish/guestfish-actions.pod:3544 msgid "lstatlist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3538 +#: ../fish/guestfish-actions.pod:3546 #, no-wrap msgid "" " lstatlist path 'names ...'\n" @@ -15290,7 +15368,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3540 +#: ../fish/guestfish-actions.pod:3548 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 " @@ -15298,7 +15376,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3544 ../src/guestfs-actions.pod:5522 +#: ../fish/guestfish-actions.pod:3552 ../src/guestfs-actions.pod:5530 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, " @@ -15306,7 +15384,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3549 +#: ../fish/guestfish-actions.pod:3557 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 " @@ -15314,12 +15392,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3554 +#: ../fish/guestfish-actions.pod:3562 msgid "luks-add-key" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3556 +#: ../fish/guestfish-actions.pod:3564 #, no-wrap msgid "" " luks-add-key device keyslot\n" @@ -15327,7 +15405,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3558 ../src/guestfs-actions.pod:5547 +#: ../fish/guestfish-actions.pod:3566 ../src/guestfs-actions.pod:5555 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 " @@ -15335,26 +15413,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3563 +#: ../fish/guestfish-actions.pod:3571 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:3567 ../fish/guestfish-actions.pod:3589 ../fish/guestfish-actions.pod:3599 ../fish/guestfish-actions.pod:3610 ../fish/guestfish-actions.pod:3636 ../fish/guestfish-actions.pod:3646 +#: ../fish/guestfish-actions.pod:3575 ../fish/guestfish-actions.pod:3597 ../fish/guestfish-actions.pod:3607 ../fish/guestfish-actions.pod:3618 ../fish/guestfish-actions.pod:3644 ../fish/guestfish-actions.pod:3654 msgid "" "This command has one or more key or passphrase parameters. Guestfish will " "prompt for these separately." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3570 +#: ../fish/guestfish-actions.pod:3578 msgid "luks-close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3572 +#: ../fish/guestfish-actions.pod:3580 #, no-wrap msgid "" " luks-close device\n" @@ -15362,7 +15440,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3574 +#: ../fish/guestfish-actions.pod:3582 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 " @@ -15371,12 +15449,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3580 +#: ../fish/guestfish-actions.pod:3588 msgid "luks-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3582 +#: ../fish/guestfish-actions.pod:3590 #, no-wrap msgid "" " luks-format device keyslot\n" @@ -15384,7 +15462,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3584 ../src/guestfs-actions.pod:5588 +#: ../fish/guestfish-actions.pod:3592 ../src/guestfs-actions.pod:5596 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 " @@ -15392,12 +15470,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3592 +#: ../fish/guestfish-actions.pod:3600 msgid "luks-format-cipher" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3594 +#: ../fish/guestfish-actions.pod:3602 #, no-wrap msgid "" " luks-format-cipher device keyslot cipher\n" @@ -15405,19 +15483,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3596 +#: ../fish/guestfish-actions.pod:3604 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:3602 +#: ../fish/guestfish-actions.pod:3610 msgid "luks-kill-slot" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3604 +#: ../fish/guestfish-actions.pod:3612 #, no-wrap msgid "" " luks-kill-slot device keyslot\n" @@ -15425,19 +15503,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3606 ../src/guestfs-actions.pod:5629 +#: ../fish/guestfish-actions.pod:3614 ../src/guestfs-actions.pod:5637 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:3613 +#: ../fish/guestfish-actions.pod:3621 msgid "luks-open" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3615 +#: ../fish/guestfish-actions.pod:3623 #, no-wrap msgid "" " luks-open device mapname\n" @@ -15445,26 +15523,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3617 ../src/guestfs-actions.pod:5649 +#: ../fish/guestfish-actions.pod:3625 ../src/guestfs-actions.pod:5657 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:3620 ../src/guestfs-actions.pod:5652 +#: ../fish/guestfish-actions.pod:3628 ../src/guestfs-actions.pod:5660 msgid "C<device> is the encrypted block device or partition." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3622 ../src/guestfs-actions.pod:5654 +#: ../fish/guestfish-actions.pod:3630 ../src/guestfs-actions.pod:5662 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:3625 ../src/guestfs-actions.pod:5657 +#: ../fish/guestfish-actions.pod:3633 ../src/guestfs-actions.pod:5665 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 " @@ -15472,24 +15550,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3629 +#: ../fish/guestfish-actions.pod:3637 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:3633 +#: ../fish/guestfish-actions.pod:3641 msgid "Use L</list-dm-devices> to list all device mapper devices." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3639 +#: ../fish/guestfish-actions.pod:3647 msgid "luks-open-ro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3641 +#: ../fish/guestfish-actions.pod:3649 #, no-wrap msgid "" " luks-open-ro device mapname\n" @@ -15497,19 +15575,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3643 +#: ../fish/guestfish-actions.pod:3651 msgid "" "This is the same as L</luks-open> except that a read-only mapping is " "created." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3649 +#: ../fish/guestfish-actions.pod:3657 msgid "lvcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3651 +#: ../fish/guestfish-actions.pod:3659 #, no-wrap msgid "" " lvcreate logvol volgroup mbytes\n" @@ -15517,19 +15595,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3653 ../src/guestfs-actions.pod:5703 +#: ../fish/guestfish-actions.pod:3661 ../src/guestfs-actions.pod:5711 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:3656 +#: ../fish/guestfish-actions.pod:3664 msgid "lvcreate-free" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3658 +#: ../fish/guestfish-actions.pod:3666 #, no-wrap msgid "" " lvcreate-free logvol volgroup percent\n" @@ -15537,7 +15615,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3660 ../src/guestfs-actions.pod:5718 +#: ../fish/guestfish-actions.pod:3668 ../src/guestfs-actions.pod:5726 msgid "" "Create an LVM logical volume called C</dev/volgroup/logvol>, using " "approximately C<percent> % of the free space remaining in the volume group. " @@ -15546,12 +15624,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3665 +#: ../fish/guestfish-actions.pod:3673 msgid "lvm-canonical-lv-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3667 +#: ../fish/guestfish-actions.pod:3675 #, no-wrap msgid "" " lvm-canonical-lv-name lvname\n" @@ -15559,7 +15637,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3669 ../src/guestfs-actions.pod:5733 +#: ../fish/guestfish-actions.pod:3677 ../src/guestfs-actions.pod:5741 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 " @@ -15567,24 +15645,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3673 ../src/guestfs-actions.pod:5737 +#: ../fish/guestfish-actions.pod:3681 ../src/guestfs-actions.pod:5745 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:3676 +#: ../fish/guestfish-actions.pod:3684 msgid "See also L</is-lv>, L</canonical-device-name>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3678 +#: ../fish/guestfish-actions.pod:3686 msgid "lvm-clear-filter" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3680 +#: ../fish/guestfish-actions.pod:3688 #, no-wrap msgid "" " lvm-clear-filter\n" @@ -15592,24 +15670,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3682 +#: ../fish/guestfish-actions.pod:3690 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:3685 ../fish/guestfish-actions.pod:3713 ../src/guestfs-actions.pod:5755 ../src/guestfs-actions.pod:5794 +#: ../fish/guestfish-actions.pod:3693 ../fish/guestfish-actions.pod:3721 ../src/guestfs-actions.pod:5763 ../src/guestfs-actions.pod:5802 msgid "This command also clears the LVM cache and performs a volume group scan." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3688 +#: ../fish/guestfish-actions.pod:3696 msgid "lvm-remove-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3690 +#: ../fish/guestfish-actions.pod:3698 #, no-wrap msgid "" " lvm-remove-all\n" @@ -15617,19 +15695,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3692 ../src/guestfs-actions.pod:5767 +#: ../fish/guestfish-actions.pod:3700 ../src/guestfs-actions.pod:5775 msgid "" "This command removes all LVM logical volumes, volume groups and physical " "volumes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3695 +#: ../fish/guestfish-actions.pod:3703 msgid "lvm-set-filter" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3697 +#: ../fish/guestfish-actions.pod:3705 #, no-wrap msgid "" " lvm-set-filter 'devices ...'\n" @@ -15637,7 +15715,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3699 ../src/guestfs-actions.pod:5780 +#: ../fish/guestfish-actions.pod:3707 ../src/guestfs-actions.pod:5788 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 " @@ -15645,7 +15723,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3703 ../src/guestfs-actions.pod:5784 +#: ../fish/guestfish-actions.pod:3711 ../src/guestfs-actions.pod:5792 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 " @@ -15657,24 +15735,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3716 ../src/guestfs-actions.pod:5797 +#: ../fish/guestfish-actions.pod:3724 ../src/guestfs-actions.pod:5805 msgid "You can filter whole block devices or individual partitions." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3718 ../src/guestfs-actions.pod:5799 +#: ../fish/guestfish-actions.pod:3726 ../src/guestfs-actions.pod:5807 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:3722 +#: ../fish/guestfish-actions.pod:3730 msgid "lvremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3724 +#: ../fish/guestfish-actions.pod:3732 #, no-wrap msgid "" " lvremove device\n" @@ -15682,26 +15760,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3726 ../src/guestfs-actions.pod:5813 +#: ../fish/guestfish-actions.pod:3734 ../src/guestfs-actions.pod:5821 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:3729 ../src/guestfs-actions.pod:5816 +#: ../fish/guestfish-actions.pod:3737 ../src/guestfs-actions.pod:5824 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:3732 +#: ../fish/guestfish-actions.pod:3740 msgid "lvrename" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3734 +#: ../fish/guestfish-actions.pod:3742 #, no-wrap msgid "" " lvrename logvol newlogvol\n" @@ -15709,17 +15787,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3736 ../src/guestfs-actions.pod:5830 +#: ../fish/guestfish-actions.pod:3744 ../src/guestfs-actions.pod:5838 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3738 +#: ../fish/guestfish-actions.pod:3746 msgid "lvresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3740 +#: ../fish/guestfish-actions.pod:3748 #, no-wrap msgid "" " lvresize device mbytes\n" @@ -15727,19 +15805,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3742 ../src/guestfs-actions.pod:5843 +#: ../fish/guestfish-actions.pod:3750 ../src/guestfs-actions.pod:5851 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:3746 +#: ../fish/guestfish-actions.pod:3754 msgid "lvresize-free" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3748 +#: ../fish/guestfish-actions.pod:3756 #, no-wrap msgid "" " lvresize-free lv percent\n" @@ -15747,7 +15825,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3750 ../src/guestfs-actions.pod:5858 +#: ../fish/guestfish-actions.pod:3758 ../src/guestfs-actions.pod:5866 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 " @@ -15756,12 +15834,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3756 +#: ../fish/guestfish-actions.pod:3764 msgid "lvs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3758 +#: ../fish/guestfish-actions.pod:3766 #, no-wrap msgid "" " lvs\n" @@ -15769,31 +15847,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3760 ../src/guestfs-actions.pod:5873 +#: ../fish/guestfish-actions.pod:3768 ../src/guestfs-actions.pod:5881 msgid "" "List all the logical volumes detected. This is the equivalent of the " "L<lvs(8)> command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3763 ../src/guestfs-actions.pod:5876 +#: ../fish/guestfish-actions.pod:3771 ../src/guestfs-actions.pod:5884 msgid "" "This returns a list of the logical volume device names " "(eg. C</dev/VolGroup00/LogVol00>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3766 +#: ../fish/guestfish-actions.pod:3774 msgid "See also L</lvs-full>, L</list-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3768 +#: ../fish/guestfish-actions.pod:3776 msgid "lvs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3770 +#: ../fish/guestfish-actions.pod:3778 #, no-wrap msgid "" " lvs-full\n" @@ -15801,19 +15879,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3772 ../src/guestfs-actions.pod:5892 +#: ../fish/guestfish-actions.pod:3780 ../src/guestfs-actions.pod:5900 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:3775 +#: ../fish/guestfish-actions.pod:3783 msgid "lvuuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3777 +#: ../fish/guestfish-actions.pod:3785 #, no-wrap msgid "" " lvuuid device\n" @@ -15821,17 +15899,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3779 ../src/guestfs-actions.pod:5907 +#: ../fish/guestfish-actions.pod:3787 ../src/guestfs-actions.pod:5915 msgid "This command returns the UUID of the LVM LV C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3781 +#: ../fish/guestfish-actions.pod:3789 msgid "lxattrlist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3783 +#: ../fish/guestfish-actions.pod:3791 #, no-wrap msgid "" " lxattrlist path 'names ...'\n" @@ -15839,7 +15917,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3785 ../src/guestfs-actions.pod:5921 +#: ../fish/guestfish-actions.pod:3793 ../src/guestfs-actions.pod:5929 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 " @@ -15847,7 +15925,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3789 ../src/guestfs-actions.pod:5925 +#: ../fish/guestfish-actions.pod:3797 ../src/guestfs-actions.pod:5933 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>. " @@ -15860,7 +15938,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3799 +#: ../fish/guestfish-actions.pod:3807 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 " @@ -15868,12 +15946,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3804 +#: ../fish/guestfish-actions.pod:3812 msgid "max-disks" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3806 +#: ../fish/guestfish-actions.pod:3814 #, no-wrap msgid "" " max-disks\n" @@ -15881,33 +15959,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3808 +#: ../fish/guestfish-actions.pod:3816 msgid "" "Return the maximum number of disks that may be added to a handle (eg. by " "L</add-drive-opts> and similar calls)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3811 ../src/guestfs-actions.pod:5954 +#: ../fish/guestfish-actions.pod:3819 ../src/guestfs-actions.pod:5962 msgid "" "This function was added in libguestfs 1.19.7. In previous versions of " "libguestfs the limit was 25." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3814 ../src/guestfs-actions.pod:5957 +#: ../fish/guestfish-actions.pod:3822 ../src/guestfs-actions.pod:5965 msgid "" "See L<guestfs(3)/MAXIMUM NUMBER OF DISKS> for additional information on this " "topic." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3817 +#: ../fish/guestfish-actions.pod:3825 msgid "md-create" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3819 +#: ../fish/guestfish-actions.pod:3827 #, no-wrap msgid "" " md-create name 'devices ...' [missingbitmap:N] [nrdevices:N] [spare:N] " @@ -15916,19 +15994,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3821 ../src/guestfs-actions.pod:5983 +#: ../fish/guestfish-actions.pod:3829 ../src/guestfs-actions.pod:5991 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:3828 ../src/guestfs-actions.pod:5990 +#: ../fish/guestfish-actions.pod:3836 ../src/guestfs-actions.pod:5998 msgid "C<missingbitmap>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3830 ../src/guestfs-actions.pod:5992 +#: ../fish/guestfish-actions.pod:3838 ../src/guestfs-actions.pod:6000 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 " @@ -15936,85 +16014,85 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3834 ../src/guestfs-actions.pod:5996 +#: ../fish/guestfish-actions.pod:3842 ../src/guestfs-actions.pod:6004 msgid "As examples:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3836 ../src/guestfs-actions.pod:5998 +#: ../fish/guestfish-actions.pod:3844 ../src/guestfs-actions.pod:6006 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:3839 ../src/guestfs-actions.pod:6001 +#: ../fish/guestfish-actions.pod:3847 ../src/guestfs-actions.pod:6009 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:3842 ../src/guestfs-actions.pod:6004 +#: ../fish/guestfish-actions.pod:3850 ../src/guestfs-actions.pod:6012 msgid "This defaults to C<0> (no missing devices)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3844 ../src/guestfs-actions.pod:6006 +#: ../fish/guestfish-actions.pod:3852 ../src/guestfs-actions.pod:6014 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:3847 ../src/guestfs-actions.pod:6009 +#: ../fish/guestfish-actions.pod:3855 ../src/guestfs-actions.pod:6017 msgid "C<nrdevices>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3849 ../src/guestfs-actions.pod:6011 +#: ../fish/guestfish-actions.pod:3857 ../src/guestfs-actions.pod:6019 msgid "The number of active RAID devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3851 ../src/guestfs-actions.pod:6013 +#: ../fish/guestfish-actions.pod:3859 ../src/guestfs-actions.pod:6021 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:3854 ../src/guestfs-actions.pod:6016 +#: ../fish/guestfish-actions.pod:3862 ../src/guestfs-actions.pod:6024 msgid "C<spare>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3856 ../src/guestfs-actions.pod:6018 +#: ../fish/guestfish-actions.pod:3864 ../src/guestfs-actions.pod:6026 msgid "The number of spare devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3858 ../src/guestfs-actions.pod:6020 +#: ../fish/guestfish-actions.pod:3866 ../src/guestfs-actions.pod:6028 msgid "If not set, this defaults to C<0>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3860 ../src/guestfs-actions.pod:6022 +#: ../fish/guestfish-actions.pod:3868 ../src/guestfs-actions.pod:6030 msgid "C<chunk>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3862 ../src/guestfs-actions.pod:6024 +#: ../fish/guestfish-actions.pod:3870 ../src/guestfs-actions.pod:6032 msgid "The chunk size in bytes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3864 ../fish/guestfish-actions.pod:3887 ../src/guestfs-actions.pod:6026 ../src/guestfs-actions.pod:6077 +#: ../fish/guestfish-actions.pod:3872 ../fish/guestfish-actions.pod:3895 ../src/guestfs-actions.pod:6034 ../src/guestfs-actions.pod:6085 msgid "C<level>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3866 ../src/guestfs-actions.pod:6028 +#: ../fish/guestfish-actions.pod:3874 ../src/guestfs-actions.pod:6036 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>, " @@ -16023,17 +16101,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3871 ../src/guestfs-actions.pod:6033 +#: ../fish/guestfish-actions.pod:3879 ../src/guestfs-actions.pod:6041 msgid "If not set, this defaults to C<raid1>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3877 +#: ../fish/guestfish-actions.pod:3885 msgid "md-detail" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3879 +#: ../fish/guestfish-actions.pod:3887 #, no-wrap msgid "" " md-detail md\n" @@ -16041,7 +16119,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3881 ../src/guestfs-actions.pod:6071 +#: ../fish/guestfish-actions.pod:3889 ../src/guestfs-actions.pod:6079 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 " @@ -16049,52 +16127,52 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3889 ../src/guestfs-actions.pod:6079 +#: ../fish/guestfish-actions.pod:3897 ../src/guestfs-actions.pod:6087 msgid "The raid level of the MD device." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3891 ../src/guestfs-actions.pod:6081 +#: ../fish/guestfish-actions.pod:3899 ../src/guestfs-actions.pod:6089 msgid "C<devices>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3893 ../src/guestfs-actions.pod:6083 +#: ../fish/guestfish-actions.pod:3901 ../src/guestfs-actions.pod:6091 msgid "The number of underlying devices in the MD device." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3895 ../src/guestfs-actions.pod:6085 +#: ../fish/guestfish-actions.pod:3903 ../src/guestfs-actions.pod:6093 msgid "C<metadata>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3897 ../src/guestfs-actions.pod:6087 +#: ../fish/guestfish-actions.pod:3905 ../src/guestfs-actions.pod:6095 msgid "The metadata version used." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3899 ../src/guestfs-actions.pod:6089 +#: ../fish/guestfish-actions.pod:3907 ../src/guestfs-actions.pod:6097 msgid "C<uuid>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3901 ../src/guestfs-actions.pod:6091 +#: ../fish/guestfish-actions.pod:3909 ../src/guestfs-actions.pod:6099 msgid "The UUID of the MD device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3905 ../src/guestfs-actions.pod:6095 +#: ../fish/guestfish-actions.pod:3913 ../src/guestfs-actions.pod:6103 msgid "The name of the MD device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3909 +#: ../fish/guestfish-actions.pod:3917 msgid "md-stat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3911 +#: ../fish/guestfish-actions.pod:3919 #, no-wrap msgid "" " md-stat md\n" @@ -16102,103 +16180,103 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3913 ../src/guestfs-actions.pod:6113 +#: ../fish/guestfish-actions.pod:3921 ../src/guestfs-actions.pod:6121 msgid "" "This call returns a list of the underlying devices which make up the single " "software RAID array device C<md>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3916 +#: ../fish/guestfish-actions.pod:3924 msgid "To get a list of software RAID devices, call L</list-md-devices>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3918 ../src/guestfs-actions.pod:6118 +#: ../fish/guestfish-actions.pod:3926 ../src/guestfs-actions.pod:6126 msgid "" "Each structure returned corresponds to one device along with additional " "status information:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3923 ../src/guestfs-actions.pod:6123 +#: ../fish/guestfish-actions.pod:3931 ../src/guestfs-actions.pod:6131 msgid "C<mdstat_device>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3925 ../src/guestfs-actions.pod:6125 +#: ../fish/guestfish-actions.pod:3933 ../src/guestfs-actions.pod:6133 msgid "The name of the underlying device." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3927 ../src/guestfs-actions.pod:6127 +#: ../fish/guestfish-actions.pod:3935 ../src/guestfs-actions.pod:6135 msgid "C<mdstat_index>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3929 ../src/guestfs-actions.pod:6129 +#: ../fish/guestfish-actions.pod:3937 ../src/guestfs-actions.pod:6137 msgid "The index of this device within the array." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3931 ../src/guestfs-actions.pod:6131 +#: ../fish/guestfish-actions.pod:3939 ../src/guestfs-actions.pod:6139 msgid "C<mdstat_flags>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3933 ../src/guestfs-actions.pod:6133 +#: ../fish/guestfish-actions.pod:3941 ../src/guestfs-actions.pod:6141 msgid "" "Flags associated with this device. This is a string containing (in no " "specific order) zero or more of the following flags:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3938 ../src/guestfs-actions.pod:6138 +#: ../fish/guestfish-actions.pod:3946 ../src/guestfs-actions.pod:6146 msgid "C<W>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3940 ../src/guestfs-actions.pod:6140 +#: ../fish/guestfish-actions.pod:3948 ../src/guestfs-actions.pod:6148 msgid "write-mostly" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3942 ../src/guestfs-actions.pod:6142 +#: ../fish/guestfish-actions.pod:3950 ../src/guestfs-actions.pod:6150 msgid "C<F>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3944 ../src/guestfs-actions.pod:6144 +#: ../fish/guestfish-actions.pod:3952 ../src/guestfs-actions.pod:6152 msgid "device is faulty" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3946 ../src/guestfs-actions.pod:6146 +#: ../fish/guestfish-actions.pod:3954 ../src/guestfs-actions.pod:6154 msgid "C<S>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3948 ../src/guestfs-actions.pod:6148 +#: ../fish/guestfish-actions.pod:3956 ../src/guestfs-actions.pod:6156 msgid "device is a RAID spare" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3950 ../src/guestfs-actions.pod:6150 +#: ../fish/guestfish-actions.pod:3958 ../src/guestfs-actions.pod:6158 msgid "C<R>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3952 ../src/guestfs-actions.pod:6152 +#: ../fish/guestfish-actions.pod:3960 ../src/guestfs-actions.pod:6160 msgid "replacement" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3958 +#: ../fish/guestfish-actions.pod:3966 msgid "md-stop" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3960 +#: ../fish/guestfish-actions.pod:3968 #, no-wrap msgid "" " md-stop md\n" @@ -16206,19 +16284,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3962 ../src/guestfs-actions.pod:6170 +#: ../fish/guestfish-actions.pod:3970 ../src/guestfs-actions.pod:6178 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:3965 +#: ../fish/guestfish-actions.pod:3973 msgid "mkdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3967 +#: ../fish/guestfish-actions.pod:3975 #, no-wrap msgid "" " mkdir path\n" @@ -16226,17 +16304,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3969 ../src/guestfs-actions.pod:6183 +#: ../fish/guestfish-actions.pod:3977 ../src/guestfs-actions.pod:6191 msgid "Create a directory named C<path>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3971 +#: ../fish/guestfish-actions.pod:3979 msgid "mkdir-mode" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3973 +#: ../fish/guestfish-actions.pod:3981 #, no-wrap msgid "" " mkdir-mode path mode\n" @@ -16244,14 +16322,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3975 ../src/guestfs-actions.pod:6196 +#: ../fish/guestfish-actions.pod:3983 ../src/guestfs-actions.pod:6204 msgid "" "This command creates a directory, setting the initial permissions of the " "directory to C<mode>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3978 ../src/guestfs-actions.pod:6199 +#: ../fish/guestfish-actions.pod:3986 ../src/guestfs-actions.pod:6207 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 " @@ -16259,17 +16337,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3982 +#: ../fish/guestfish-actions.pod:3990 msgid "See also L</mkdir>, L</umask>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3984 +#: ../fish/guestfish-actions.pod:3992 msgid "mkdir-p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3986 +#: ../fish/guestfish-actions.pod:3994 #, no-wrap msgid "" " mkdir-p path\n" @@ -16277,19 +16355,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3988 ../src/guestfs-actions.pod:6215 +#: ../fish/guestfish-actions.pod:3996 ../src/guestfs-actions.pod:6223 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:3991 +#: ../fish/guestfish-actions.pod:3999 msgid "mkdtemp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3993 +#: ../fish/guestfish-actions.pod:4001 #, no-wrap msgid "" " mkdtemp tmpl\n" @@ -16297,7 +16375,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3995 ../src/guestfs-actions.pod:6228 +#: ../fish/guestfish-actions.pod:4003 ../src/guestfs-actions.pod:6236 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 " @@ -16305,41 +16383,41 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4000 ../src/guestfs-actions.pod:6233 +#: ../fish/guestfish-actions.pod:4008 ../src/guestfs-actions.pod:6241 msgid "" "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one " "being suitable for Windows filesystems." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4003 ../src/guestfs-actions.pod:6236 +#: ../fish/guestfish-actions.pod:4011 ../src/guestfs-actions.pod:6244 msgid "The name of the temporary directory that was created is returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4006 ../src/guestfs-actions.pod:6239 +#: ../fish/guestfish-actions.pod:4014 ../src/guestfs-actions.pod:6247 msgid "The temporary directory is created with mode 0700 and is owned by root." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4009 ../src/guestfs-actions.pod:6242 +#: ../fish/guestfish-actions.pod:4017 ../src/guestfs-actions.pod:6250 msgid "" "The caller is responsible for deleting the temporary directory and its " "contents after use." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4012 ../src/guestfs-actions.pod:6245 +#: ../fish/guestfish-actions.pod:4020 ../src/guestfs-actions.pod:6253 msgid "See also: L<mkdtemp(3)>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4014 +#: ../fish/guestfish-actions.pod:4022 msgid "mke2fs-J" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4016 +#: ../fish/guestfish-actions.pod:4024 #, no-wrap msgid "" " mke2fs-J fstype blocksize device journal\n" @@ -16347,14 +16425,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4018 ../src/guestfs-actions.pod:6261 +#: ../fish/guestfish-actions.pod:4026 ../src/guestfs-actions.pod:6269 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:4022 ../src/guestfs-actions.pod:6265 +#: ../fish/guestfish-actions.pod:4030 ../src/guestfs-actions.pod:6273 #, no-wrap msgid "" " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n" @@ -16362,17 +16440,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4024 +#: ../fish/guestfish-actions.pod:4032 msgid "See also L</mke2journal>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4026 +#: ../fish/guestfish-actions.pod:4034 msgid "mke2fs-JL" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4028 +#: ../fish/guestfish-actions.pod:4036 #, no-wrap msgid "" " mke2fs-JL fstype blocksize device label\n" @@ -16380,24 +16458,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4030 ../src/guestfs-actions.pod:6282 +#: ../fish/guestfish-actions.pod:4038 ../src/guestfs-actions.pod:6290 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:4033 +#: ../fish/guestfish-actions.pod:4041 msgid "See also L</mke2journal-L>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4035 +#: ../fish/guestfish-actions.pod:4043 msgid "mke2fs-JU" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4037 +#: ../fish/guestfish-actions.pod:4045 #, no-wrap msgid "" " mke2fs-JU fstype blocksize device uuid\n" @@ -16405,24 +16483,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4039 ../src/guestfs-actions.pod:6300 +#: ../fish/guestfish-actions.pod:4047 ../src/guestfs-actions.pod:6308 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:4042 +#: ../fish/guestfish-actions.pod:4050 msgid "See also L</mke2journal-U>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4044 +#: ../fish/guestfish-actions.pod:4052 msgid "mke2journal" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4046 +#: ../fish/guestfish-actions.pod:4054 #, no-wrap msgid "" " mke2journal blocksize device\n" @@ -16430,14 +16508,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4048 ../src/guestfs-actions.pod:6316 +#: ../fish/guestfish-actions.pod:4056 ../src/guestfs-actions.pod:6324 msgid "" "This creates an ext2 external journal on C<device>. It is equivalent to the " "command:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4051 ../src/guestfs-actions.pod:6319 +#: ../fish/guestfish-actions.pod:4059 ../src/guestfs-actions.pod:6327 #, no-wrap msgid "" " mke2fs -O journal_dev -b blocksize device\n" @@ -16445,12 +16523,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4053 +#: ../fish/guestfish-actions.pod:4061 msgid "mke2journal-L" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4055 +#: ../fish/guestfish-actions.pod:4063 #, no-wrap msgid "" " mke2journal-L blocksize label device\n" @@ -16458,17 +16536,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4057 ../src/guestfs-actions.pod:6333 +#: ../fish/guestfish-actions.pod:4065 ../src/guestfs-actions.pod:6341 msgid "This creates an ext2 external journal on C<device> with label C<label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4059 +#: ../fish/guestfish-actions.pod:4067 msgid "mke2journal-U" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4061 +#: ../fish/guestfish-actions.pod:4069 #, no-wrap msgid "" " mke2journal-U blocksize uuid device\n" @@ -16476,17 +16554,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4063 ../src/guestfs-actions.pod:6347 +#: ../fish/guestfish-actions.pod:4071 ../src/guestfs-actions.pod:6355 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4065 +#: ../fish/guestfish-actions.pod:4073 msgid "mkfifo" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4067 +#: ../fish/guestfish-actions.pod:4075 #, no-wrap msgid "" " mkfifo mode path\n" @@ -16494,24 +16572,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4069 +#: ../fish/guestfish-actions.pod:4077 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:4075 +#: ../fish/guestfish-actions.pod:4083 msgid "mkfs" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4077 +#: ../fish/guestfish-actions.pod:4085 msgid "mkfs-opts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4079 +#: ../fish/guestfish-actions.pod:4087 #, no-wrap msgid "" " mkfs fstype device [blocksize:N] [features:..] [inode:N] [sectorsize:N]\n" @@ -16519,19 +16597,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4081 ../src/guestfs-actions.pod:6402 +#: ../fish/guestfish-actions.pod:4089 ../src/guestfs-actions.pod:6410 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:4088 ../src/guestfs-actions.pod:6409 +#: ../fish/guestfish-actions.pod:4096 ../src/guestfs-actions.pod:6417 msgid "C<blocksize>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4090 ../src/guestfs-actions.pod:6411 +#: ../fish/guestfish-actions.pod:4098 ../src/guestfs-actions.pod:6419 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 " @@ -16539,72 +16617,72 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4094 ../fish/guestfish-actions.pod:4133 ../src/guestfs-actions.pod:6415 ../src/guestfs-actions.pod:6491 +#: ../fish/guestfish-actions.pod:4102 ../fish/guestfish-actions.pod:4141 ../src/guestfs-actions.pod:6423 ../src/guestfs-actions.pod:6499 msgid "" "For VFAT and NTFS the C<blocksize> parameter is treated as the requested " "cluster size." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4097 ../src/guestfs-actions.pod:6418 +#: ../fish/guestfish-actions.pod:4105 ../src/guestfs-actions.pod:6426 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4099 ../src/guestfs-actions.pod:6420 +#: ../fish/guestfish-actions.pod:4107 ../src/guestfs-actions.pod:6428 msgid "C<features>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4101 ../src/guestfs-actions.pod:6422 +#: ../fish/guestfish-actions.pod:4109 ../src/guestfs-actions.pod:6430 msgid "This passes the I<-O> parameter to the external mkfs program." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4103 ../src/guestfs-actions.pod:6424 +#: ../fish/guestfish-actions.pod:4111 ../src/guestfs-actions.pod:6432 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:4107 ../src/guestfs-actions.pod:6428 +#: ../fish/guestfish-actions.pod:4115 ../src/guestfs-actions.pod:6436 msgid "" "You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem " "type." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4110 ../src/guestfs-actions.pod:6431 +#: ../fish/guestfish-actions.pod:4118 ../src/guestfs-actions.pod:6439 msgid "C<inode>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4112 ../src/guestfs-actions.pod:6433 +#: ../fish/guestfish-actions.pod:4120 ../src/guestfs-actions.pod:6441 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:4115 ../src/guestfs-actions.pod:6436 +#: ../fish/guestfish-actions.pod:4123 ../src/guestfs-actions.pod:6444 msgid "C<sectorsize>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4117 ../src/guestfs-actions.pod:6438 +#: ../fish/guestfish-actions.pod:4125 ../src/guestfs-actions.pod:6446 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:4124 +#: ../fish/guestfish-actions.pod:4132 msgid "mkfs-b" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4126 +#: ../fish/guestfish-actions.pod:4134 #, no-wrap msgid "" " mkfs-b fstype blocksize device\n" @@ -16612,7 +16690,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4128 +#: ../fish/guestfish-actions.pod:4136 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 " @@ -16620,17 +16698,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4136 +#: ../fish/guestfish-actions.pod:4144 msgid "I<This function is deprecated.> In new code, use the L</mkfs> call instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4143 +#: ../fish/guestfish-actions.pod:4151 msgid "mkfs-btrfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4145 +#: ../fish/guestfish-actions.pod:4153 #, no-wrap msgid "" " mkfs-btrfs 'devices ...' [allocstart:N] [bytecount:N] [datatype:..] " @@ -16639,31 +16717,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4147 ../src/guestfs-actions.pod:6519 +#: ../fish/guestfish-actions.pod:4155 ../src/guestfs-actions.pod:6527 msgid "" "Create a btrfs filesystem, allowing all configurables to be set. For more " "information on the optional arguments, see L<mkfs.btrfs(8)>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4150 ../src/guestfs-actions.pod:6522 +#: ../fish/guestfish-actions.pod:4158 ../src/guestfs-actions.pod:6530 msgid "" "Since btrfs filesystems can span multiple devices, this takes a non-empty " "list of devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4153 +#: ../fish/guestfish-actions.pod:4161 msgid "To create general filesystems, use L</mkfs>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4157 +#: ../fish/guestfish-actions.pod:4165 msgid "mkmountpoint" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4159 +#: ../fish/guestfish-actions.pod:4167 #, no-wrap msgid "" " mkmountpoint exemptpath\n" @@ -16671,14 +16749,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4161 +#: ../fish/guestfish-actions.pod:4169 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:4165 ../src/guestfs-actions.pod:6563 +#: ../fish/guestfish-actions.pod:4173 ../src/guestfs-actions.pod:6571 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 " @@ -16686,7 +16764,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4169 ../src/guestfs-actions.pod:6567 +#: ../fish/guestfish-actions.pod:4177 ../src/guestfs-actions.pod:6575 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 " @@ -16694,7 +16772,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4174 ../src/guestfs-actions.pod:6572 +#: ../fish/guestfish-actions.pod:4182 ../src/guestfs-actions.pod:6580 #, no-wrap msgid "" " add-ro Fedora-11-i686-Live.iso\n" @@ -16709,12 +16787,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4183 ../src/guestfs-actions.pod:6581 +#: ../fish/guestfish-actions.pod:4191 ../src/guestfs-actions.pod:6589 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4185 +#: ../fish/guestfish-actions.pod:4193 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 " @@ -16722,7 +16800,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4189 +#: ../fish/guestfish-actions.pod:4197 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 " @@ -16730,12 +16808,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4194 ../src/guestfs-actions.pod:6592 +#: ../fish/guestfish-actions.pod:4202 ../src/guestfs-actions.pod:6600 msgid "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4196 +#: ../fish/guestfish-actions.pod:4204 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 " @@ -16743,12 +16821,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4200 +#: ../fish/guestfish-actions.pod:4208 msgid "mknod" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4202 +#: ../fish/guestfish-actions.pod:4210 #, no-wrap msgid "" " mknod mode devmajor devminor path\n" @@ -16756,14 +16834,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4204 ../src/guestfs-actions.pod:6611 +#: ../fish/guestfish-actions.pod:4212 ../src/guestfs-actions.pod:6619 msgid "" "This call creates block or character special devices, or named pipes " "(FIFOs)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4207 ../src/guestfs-actions.pod:6614 +#: ../fish/guestfish-actions.pod:4215 ../src/guestfs-actions.pod:6622 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 " @@ -16771,7 +16849,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4212 +#: ../fish/guestfish-actions.pod:4220 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 " @@ -16782,12 +16860,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4222 +#: ../fish/guestfish-actions.pod:4230 msgid "mknod-b" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4224 +#: ../fish/guestfish-actions.pod:4232 #, no-wrap msgid "" " mknod-b mode devmajor devminor path\n" @@ -16795,7 +16873,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4226 +#: ../fish/guestfish-actions.pod:4234 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 " @@ -16803,12 +16881,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4232 +#: ../fish/guestfish-actions.pod:4240 msgid "mknod-c" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4234 +#: ../fish/guestfish-actions.pod:4242 #, no-wrap msgid "" " mknod-c mode devmajor devminor path\n" @@ -16816,7 +16894,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4236 +#: ../fish/guestfish-actions.pod:4244 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 " @@ -16824,17 +16902,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4242 +#: ../fish/guestfish-actions.pod:4250 msgid "mkswap" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4244 +#: ../fish/guestfish-actions.pod:4252 msgid "mkswap-opts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4246 +#: ../fish/guestfish-actions.pod:4254 #, no-wrap msgid "" " mkswap device [label:..] [uuid:..]\n" @@ -16842,24 +16920,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4248 ../src/guestfs-actions.pod:6699 +#: ../fish/guestfish-actions.pod:4256 ../src/guestfs-actions.pod:6707 msgid "Create a Linux swap partition on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4250 ../src/guestfs-actions.pod:6701 +#: ../fish/guestfish-actions.pod:4258 ../src/guestfs-actions.pod:6709 msgid "" "The option arguments C<label> and C<uuid> allow you to set the label and/or " "UUID of the new swap partition." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4255 +#: ../fish/guestfish-actions.pod:4263 msgid "mkswap-L" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4257 +#: ../fish/guestfish-actions.pod:4265 #, no-wrap msgid "" " mkswap-L label device\n" @@ -16867,12 +16945,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4259 ../src/guestfs-actions.pod:6742 +#: ../fish/guestfish-actions.pod:4267 ../src/guestfs-actions.pod:6750 msgid "Create a swap partition on C<device> with label C<label>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4261 ../src/guestfs-actions.pod:6744 +#: ../fish/guestfish-actions.pod:4269 ../src/guestfs-actions.pod:6752 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 " @@ -16880,19 +16958,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4265 ../fish/guestfish-actions.pod:4278 +#: ../fish/guestfish-actions.pod:4273 ../fish/guestfish-actions.pod:4286 msgid "" "I<This function is deprecated.> In new code, use the L</mkswap> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4272 +#: ../fish/guestfish-actions.pod:4280 msgid "mkswap-U" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4274 +#: ../fish/guestfish-actions.pod:4282 #, no-wrap msgid "" " mkswap-U uuid device\n" @@ -16900,17 +16978,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4276 ../src/guestfs-actions.pod:6766 +#: ../fish/guestfish-actions.pod:4284 ../src/guestfs-actions.pod:6774 msgid "Create a swap partition on C<device> with UUID C<uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4285 +#: ../fish/guestfish-actions.pod:4293 msgid "mkswap-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4287 +#: ../fish/guestfish-actions.pod:4295 #, no-wrap msgid "" " mkswap-file path\n" @@ -16918,24 +16996,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4289 ../src/guestfs-actions.pod:6778 +#: ../fish/guestfish-actions.pod:4297 ../src/guestfs-actions.pod:6786 msgid "Create a swap file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4291 +#: ../fish/guestfish-actions.pod:4299 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:4294 +#: ../fish/guestfish-actions.pod:4302 msgid "modprobe" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4296 +#: ../fish/guestfish-actions.pod:4304 #, no-wrap msgid "" " modprobe modulename\n" @@ -16943,24 +17021,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4298 ../src/guestfs-actions.pod:6793 +#: ../fish/guestfish-actions.pod:4306 ../src/guestfs-actions.pod:6801 msgid "This loads a kernel module in the appliance." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4300 ../src/guestfs-actions.pod:6795 +#: ../fish/guestfish-actions.pod:4308 ../src/guestfs-actions.pod:6803 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:4303 +#: ../fish/guestfish-actions.pod:4311 msgid "mount" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4305 +#: ../fish/guestfish-actions.pod:4313 #, no-wrap msgid "" " mount device mountpoint\n" @@ -16968,7 +17046,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4307 ../src/guestfs-actions.pod:6809 +#: ../fish/guestfish-actions.pod:4315 ../src/guestfs-actions.pod:6817 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 " @@ -16977,7 +17055,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4313 ../src/guestfs-actions.pod:6815 +#: ../fish/guestfish-actions.pod:4321 ../src/guestfs-actions.pod:6823 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 " @@ -16985,14 +17063,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4318 ../src/guestfs-actions.pod:6820 +#: ../fish/guestfish-actions.pod:4326 ../src/guestfs-actions.pod:6828 msgid "" "The mounted filesystem is writable, if we have sufficient permissions on the " "underlying device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4321 +#: ../fish/guestfish-actions.pod:4329 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 " @@ -17002,12 +17080,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4328 +#: ../fish/guestfish-actions.pod:4336 msgid "mount-9p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4330 +#: ../fish/guestfish-actions.pod:4338 #, no-wrap msgid "" " mount-9p mounttag mountpoint [options:..]\n" @@ -17015,14 +17093,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4332 ../src/guestfs-actions.pod:6849 +#: ../fish/guestfish-actions.pod:4340 ../src/guestfs-actions.pod:6857 msgid "" "Mount the virtio-9p filesystem with the tag C<mounttag> on the directory " "C<mountpoint>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4335 ../src/guestfs-actions.pod:6852 +#: ../fish/guestfish-actions.pod:4343 ../src/guestfs-actions.pod:6860 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> " @@ -17030,12 +17108,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4341 +#: ../fish/guestfish-actions.pod:4349 msgid "mount-local" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4343 +#: ../fish/guestfish-actions.pod:4351 #, no-wrap msgid "" " mount-local localmountpoint [readonly:true|false] [options:..] " @@ -17044,7 +17122,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4345 ../src/guestfs-actions.pod:6901 +#: ../fish/guestfish-actions.pod:4353 ../src/guestfs-actions.pod:6909 msgid "" "This call exports the libguestfs-accessible filesystem to a local mountpoint " "(directory) called C<localmountpoint>. Ordinary reads and writes to files " @@ -17052,35 +17130,35 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4350 ../src/guestfs-actions.pod:6906 +#: ../fish/guestfish-actions.pod:4358 ../src/guestfs-actions.pod:6914 msgid "" "If the optional C<readonly> flag is set to true, then writes to the " "filesystem return error C<EROFS>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4353 ../src/guestfs-actions.pod:6909 +#: ../fish/guestfish-actions.pod:4361 ../src/guestfs-actions.pod:6917 msgid "" "C<options> is a comma-separated list of mount options. See L<guestmount(1)> " "for some useful options." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4356 ../src/guestfs-actions.pod:6912 +#: ../fish/guestfish-actions.pod:4364 ../src/guestfs-actions.pod:6920 msgid "" "C<cachetimeout> sets the timeout (in seconds) for cached directory entries. " "The default is 60 seconds. See L<guestmount(1)> for further information." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4360 ../src/guestfs-actions.pod:6916 +#: ../fish/guestfish-actions.pod:4368 ../src/guestfs-actions.pod:6924 msgid "" "If C<debugcalls> is set to true, then additional debugging information is " "generated for every FUSE call." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4363 +#: ../fish/guestfish-actions.pod:4371 msgid "" "When L</mount-local> returns, the filesystem is ready, but is not processing " "requests (access to it will block). You have to call L</mount-local-run> to " @@ -17088,17 +17166,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4367 ../fish/guestfish-actions.pod:4391 ../fish/guestfish-actions.pod:6281 ../src/guestfs-actions.pod:6923 ../src/guestfs-actions.pod:6972 ../src/guestfs-actions.pod:10059 +#: ../fish/guestfish-actions.pod:4375 ../fish/guestfish-actions.pod:4399 ../fish/guestfish-actions.pod:6289 ../src/guestfs-actions.pod:6931 ../src/guestfs-actions.pod:6980 ../src/guestfs-actions.pod:10067 msgid "See L<guestfs(3)/MOUNT LOCAL> for full documentation." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4371 +#: ../fish/guestfish-actions.pod:4379 msgid "mount-local-run" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4373 +#: ../fish/guestfish-actions.pod:4381 #, no-wrap msgid "" " mount-local-run\n" @@ -17106,26 +17184,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4375 ../src/guestfs-actions.pod:6956 +#: ../fish/guestfish-actions.pod:4383 ../src/guestfs-actions.pod:6964 msgid "Run the main loop which translates kernel calls to libguestfs calls." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4378 +#: ../fish/guestfish-actions.pod:4386 msgid "" "This should only be called after L</mount-local> returns successfully. The " "call will not return until the filesystem is unmounted." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4382 +#: ../fish/guestfish-actions.pod:4390 msgid "" "B<Note> you must I<not> make concurrent libguestfs calls on the same handle " "from another thread, with the exception of L</umount-local>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4386 +#: ../fish/guestfish-actions.pod:4394 msgid "" "You may call this from a different thread than the one which called " "L</mount-local>, subject to the usual rules for threads and libguestfs (see " @@ -17133,12 +17211,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4393 +#: ../fish/guestfish-actions.pod:4401 msgid "mount-loop" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4395 +#: ../fish/guestfish-actions.pod:4403 #, no-wrap msgid "" " mount-loop file mountpoint\n" @@ -17146,7 +17224,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4397 ../src/guestfs-actions.pod:6985 +#: ../fish/guestfish-actions.pod:4405 ../src/guestfs-actions.pod:6993 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 " @@ -17154,12 +17232,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4401 +#: ../fish/guestfish-actions.pod:4409 msgid "mount-options" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4403 +#: ../fish/guestfish-actions.pod:4411 #, no-wrap msgid "" " mount-options options device mountpoint\n" @@ -17167,26 +17245,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4405 +#: ../fish/guestfish-actions.pod:4413 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:4409 ../src/guestfs-actions.pod:7005 +#: ../fish/guestfish-actions.pod:4417 ../src/guestfs-actions.pod:7013 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:4413 +#: ../fish/guestfish-actions.pod:4421 msgid "mount-ro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4415 +#: ../fish/guestfish-actions.pod:4423 #, no-wrap msgid "" " mount-ro device mountpoint\n" @@ -17194,19 +17272,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4417 +#: ../fish/guestfish-actions.pod:4425 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:4420 +#: ../fish/guestfish-actions.pod:4428 msgid "mount-vfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4422 +#: ../fish/guestfish-actions.pod:4430 #, no-wrap msgid "" " mount-vfs options vfstype device mountpoint\n" @@ -17214,19 +17292,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4424 +#: ../fish/guestfish-actions.pod:4432 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:4428 +#: ../fish/guestfish-actions.pod:4436 msgid "mountpoints" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4430 +#: ../fish/guestfish-actions.pod:4438 #, no-wrap msgid "" " mountpoints\n" @@ -17234,7 +17312,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4432 +#: ../fish/guestfish-actions.pod:4440 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 " @@ -17242,12 +17320,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4436 +#: ../fish/guestfish-actions.pod:4444 msgid "mounts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4438 +#: ../fish/guestfish-actions.pod:4446 #, no-wrap msgid "" " mounts\n" @@ -17255,29 +17333,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4440 ../src/guestfs-actions.pod:7066 +#: ../fish/guestfish-actions.pod:4448 ../src/guestfs-actions.pod:7074 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:4443 ../src/guestfs-actions.pod:7069 +#: ../fish/guestfish-actions.pod:4451 ../src/guestfs-actions.pod:7077 msgid "Some internal mounts are not shown." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4445 +#: ../fish/guestfish-actions.pod:4453 msgid "See also: L</mountpoints>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4447 +#: ../fish/guestfish-actions.pod:4455 msgid "mv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4449 +#: ../fish/guestfish-actions.pod:4457 #, no-wrap msgid "" " mv src dest\n" @@ -17285,19 +17363,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4451 ../src/guestfs-actions.pod:7086 +#: ../fish/guestfish-actions.pod:4459 ../src/guestfs-actions.pod:7094 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:4454 +#: ../fish/guestfish-actions.pod:4462 msgid "nr-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4456 +#: ../fish/guestfish-actions.pod:4464 #, no-wrap msgid "" " nr-devices\n" @@ -17305,7 +17383,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4458 +#: ../fish/guestfish-actions.pod:4466 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 " @@ -17313,19 +17391,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4462 +#: ../fish/guestfish-actions.pod:4470 msgid "" "To find out the maximum number of devices that could be added, call " "L</max-disks>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4465 +#: ../fish/guestfish-actions.pod:4473 msgid "ntfs-3g-probe" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4467 +#: ../fish/guestfish-actions.pod:4475 #, no-wrap msgid "" " ntfs-3g-probe true|false device\n" @@ -17333,7 +17411,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4469 ../src/guestfs-actions.pod:7116 +#: ../fish/guestfish-actions.pod:4477 ../src/guestfs-actions.pod:7124 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 " @@ -17341,7 +17419,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4473 ../src/guestfs-actions.pod:7120 +#: ../fish/guestfish-actions.pod:4481 ../src/guestfs-actions.pod:7128 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 " @@ -17349,19 +17427,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4477 ../src/guestfs-actions.pod:7124 +#: ../fish/guestfish-actions.pod:4485 ../src/guestfs-actions.pod:7132 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:4481 +#: ../fish/guestfish-actions.pod:4489 msgid "ntfsclone-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4483 +#: ../fish/guestfish-actions.pod:4491 #, no-wrap msgid "" " ntfsclone-in (backupfile|-) device\n" @@ -17369,19 +17447,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4485 +#: ../fish/guestfish-actions.pod:4493 msgid "" "Restore the C<backupfile> (from a previous call to L</ntfsclone-out>) to " "C<device>, overwriting any existing contents of this device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4491 +#: ../fish/guestfish-actions.pod:4499 msgid "ntfsclone-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4493 +#: ../fish/guestfish-actions.pod:4501 #, no-wrap msgid "" " ntfsclone-out device (backupfile|-) [metadataonly:true|false] " @@ -17391,7 +17469,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4495 ../src/guestfs-actions.pod:7166 +#: ../fish/guestfish-actions.pod:4503 ../src/guestfs-actions.pod:7174 msgid "" "Stream the NTFS filesystem C<device> to the local file C<backupfile>. The " "format used for the backup file is a special format used by the " @@ -17399,7 +17477,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4499 ../src/guestfs-actions.pod:7170 +#: ../fish/guestfish-actions.pod:4507 ../src/guestfs-actions.pod:7178 msgid "" "If the optional C<metadataonly> flag is true, then I<only> the metadata is " "saved, losing all the user data (this is useful for diagnosing some " @@ -17407,24 +17485,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4503 ../src/guestfs-actions.pod:7174 +#: ../fish/guestfish-actions.pod:4511 ../src/guestfs-actions.pod:7182 msgid "" "The optional C<rescue>, C<ignorefscheck>, C<preservetimestamps> and C<force> " "flags have precise meanings detailed in the L<ntfsclone(8)> man page." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4507 +#: ../fish/guestfish-actions.pod:4515 msgid "Use L</ntfsclone-in> to restore the file back to a libguestfs device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4514 +#: ../fish/guestfish-actions.pod:4522 msgid "ntfsfix" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4516 +#: ../fish/guestfish-actions.pod:4524 #, no-wrap msgid "" " ntfsfix device [clearbadsectors:true|false]\n" @@ -17432,7 +17510,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4518 ../src/guestfs-actions.pod:7223 +#: ../fish/guestfish-actions.pod:4526 ../src/guestfs-actions.pod:7231 msgid "" "This command repairs some fundamental NTFS inconsistencies, resets the NTFS " "journal file, and schedules an NTFS consistency check for the first boot " @@ -17440,31 +17518,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4522 ../src/guestfs-actions.pod:7227 +#: ../fish/guestfish-actions.pod:4530 ../src/guestfs-actions.pod:7235 msgid "" "This is I<not> an equivalent of Windows C<chkdsk>. It does I<not> scan the " "filesystem for inconsistencies." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4525 ../src/guestfs-actions.pod:7230 +#: ../fish/guestfish-actions.pod:4533 ../src/guestfs-actions.pod:7238 msgid "" "The optional C<clearbadsectors> flag clears the list of bad sectors. This " "is useful after cloning a disk with bad sectors to a new disk." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4530 +#: ../fish/guestfish-actions.pod:4538 msgid "ntfsresize" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4532 +#: ../fish/guestfish-actions.pod:4540 msgid "ntfsresize-opts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4534 +#: ../fish/guestfish-actions.pod:4542 #, no-wrap msgid "" " ntfsresize device [size:N] [force:true|false]\n" @@ -17472,33 +17550,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4536 ../src/guestfs-actions.pod:7287 +#: ../fish/guestfish-actions.pod:4544 ../src/guestfs-actions.pod:7295 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:4545 ../src/guestfs-actions.pod:7296 +#: ../fish/guestfish-actions.pod:4553 ../src/guestfs-actions.pod:7304 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:4548 ../fish/guestfish-actions.pod:6117 ../src/guestfs-actions.pod:7299 ../src/guestfs-actions.pod:9789 +#: ../fish/guestfish-actions.pod:4556 ../fish/guestfish-actions.pod:6125 ../src/guestfs-actions.pod:7307 ../src/guestfs-actions.pod:9797 msgid "C<force>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4550 ../src/guestfs-actions.pod:7301 +#: ../fish/guestfish-actions.pod:4558 ../src/guestfs-actions.pod:7309 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:4553 +#: ../fish/guestfish-actions.pod:4561 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 " @@ -17508,17 +17586,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4562 ../src/guestfs-actions.pod:7313 +#: ../fish/guestfish-actions.pod:4570 ../src/guestfs-actions.pod:7321 msgid "See also L<ntfsresize(8)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4566 +#: ../fish/guestfish-actions.pod:4574 msgid "ntfsresize-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4568 +#: ../fish/guestfish-actions.pod:4576 #, no-wrap msgid "" " ntfsresize-size device size\n" @@ -17526,26 +17604,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4570 +#: ../fish/guestfish-actions.pod:4578 msgid "" "This command is the same as L</ntfsresize> except that it allows you to " "specify the new size (in bytes) explicitly." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4573 +#: ../fish/guestfish-actions.pod:4581 msgid "" "I<This function is deprecated.> In new code, use the L</ntfsresize> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4580 +#: ../fish/guestfish-actions.pod:4588 msgid "part-add" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4582 +#: ../fish/guestfish-actions.pod:4590 #, no-wrap msgid "" " part-add device prlogex startsect endsect\n" @@ -17553,14 +17631,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4584 +#: ../fish/guestfish-actions.pod:4592 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:4587 ../src/guestfs-actions.pod:7374 +#: ../fish/guestfish-actions.pod:4595 ../src/guestfs-actions.pod:7382 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 " @@ -17568,7 +17646,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4592 ../src/guestfs-actions.pod:7379 +#: ../fish/guestfish-actions.pod:4600 ../src/guestfs-actions.pod:7387 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 " @@ -17576,19 +17654,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4596 +#: ../fish/guestfish-actions.pod:4604 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:4599 +#: ../fish/guestfish-actions.pod:4607 msgid "part-del" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4601 +#: ../fish/guestfish-actions.pod:4609 #, no-wrap msgid "" " part-del device partnum\n" @@ -17596,24 +17674,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4603 ../src/guestfs-actions.pod:7397 +#: ../fish/guestfish-actions.pod:4611 ../src/guestfs-actions.pod:7405 msgid "This command deletes the partition numbered C<partnum> on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4605 ../src/guestfs-actions.pod:7399 +#: ../fish/guestfish-actions.pod:4613 ../src/guestfs-actions.pod:7407 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:4609 +#: ../fish/guestfish-actions.pod:4617 msgid "part-disk" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4611 +#: ../fish/guestfish-actions.pod:4619 #, no-wrap msgid "" " part-disk device parttype\n" @@ -17621,26 +17699,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4613 +#: ../fish/guestfish-actions.pod:4621 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:4617 +#: ../fish/guestfish-actions.pod:4625 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:4620 +#: ../fish/guestfish-actions.pod:4628 msgid "part-get-bootable" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4622 +#: ../fish/guestfish-actions.pod:4630 #, no-wrap msgid "" " part-get-bootable device partnum\n" @@ -17648,24 +17726,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4624 ../src/guestfs-actions.pod:7432 +#: ../fish/guestfish-actions.pod:4632 ../src/guestfs-actions.pod:7440 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:4627 +#: ../fish/guestfish-actions.pod:4635 msgid "See also L</part-set-bootable>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4629 +#: ../fish/guestfish-actions.pod:4637 msgid "part-get-mbr-id" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4631 +#: ../fish/guestfish-actions.pod:4639 #, no-wrap msgid "" " part-get-mbr-id device partnum\n" @@ -17673,14 +17751,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4633 ../src/guestfs-actions.pod:7448 +#: ../fish/guestfish-actions.pod:4641 ../src/guestfs-actions.pod:7456 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:4636 ../fish/guestfish-actions.pod:4780 +#: ../fish/guestfish-actions.pod:4644 ../fish/guestfish-actions.pod:4788 msgid "" "Note that only MBR (old DOS-style) partitions have type bytes. You will get " "undefined results for other partition table types (see " @@ -17688,12 +17766,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4640 +#: ../fish/guestfish-actions.pod:4648 msgid "part-get-parttype" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4642 +#: ../fish/guestfish-actions.pod:4650 #, no-wrap msgid "" " part-get-parttype device\n" @@ -17701,14 +17779,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4644 ../src/guestfs-actions.pod:7465 +#: ../fish/guestfish-actions.pod:4652 ../src/guestfs-actions.pod:7473 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:4647 +#: ../fish/guestfish-actions.pod:4655 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 " @@ -17716,12 +17794,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4652 +#: ../fish/guestfish-actions.pod:4660 msgid "part-init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4654 +#: ../fish/guestfish-actions.pod:4662 #, no-wrap msgid "" " part-init device parttype\n" @@ -17729,7 +17807,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4656 ../src/guestfs-actions.pod:7485 +#: ../fish/guestfish-actions.pod:4664 ../src/guestfs-actions.pod:7493 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> " @@ -17737,34 +17815,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4660 +#: ../fish/guestfish-actions.pod:4668 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:4663 ../src/guestfs-actions.pod:7492 +#: ../fish/guestfish-actions.pod:4671 ../src/guestfs-actions.pod:7500 msgid "Possible values for C<parttype> are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4667 ../src/guestfs-actions.pod:7496 +#: ../fish/guestfish-actions.pod:4675 ../src/guestfs-actions.pod:7504 msgid "B<efi>" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4669 ../src/guestfs-actions.pod:7498 +#: ../fish/guestfish-actions.pod:4677 ../src/guestfs-actions.pod:7506 msgid "B<gpt>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4671 ../src/guestfs-actions.pod:7500 +#: ../fish/guestfish-actions.pod:4679 ../src/guestfs-actions.pod:7508 msgid "Intel EFI / GPT partition table." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4673 ../src/guestfs-actions.pod:7502 +#: ../fish/guestfish-actions.pod:4681 ../src/guestfs-actions.pod:7510 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 " @@ -17772,17 +17850,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4677 ../src/guestfs-actions.pod:7506 +#: ../fish/guestfish-actions.pod:4685 ../src/guestfs-actions.pod:7514 msgid "B<mbr>" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4679 ../src/guestfs-actions.pod:7508 +#: ../fish/guestfish-actions.pod:4687 ../src/guestfs-actions.pod:7516 msgid "B<msdos>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4681 ../src/guestfs-actions.pod:7510 +#: ../fish/guestfish-actions.pod:4689 ../src/guestfs-actions.pod:7518 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 " @@ -17790,102 +17868,102 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4688 ../src/guestfs-actions.pod:7517 +#: ../fish/guestfish-actions.pod:4696 ../src/guestfs-actions.pod:7525 msgid "Other partition table types that may work but are not supported include:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4693 ../src/guestfs-actions.pod:7522 +#: ../fish/guestfish-actions.pod:4701 ../src/guestfs-actions.pod:7530 msgid "B<aix>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4695 ../src/guestfs-actions.pod:7524 +#: ../fish/guestfish-actions.pod:4703 ../src/guestfs-actions.pod:7532 msgid "AIX disk labels." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4697 ../src/guestfs-actions.pod:7526 +#: ../fish/guestfish-actions.pod:4705 ../src/guestfs-actions.pod:7534 msgid "B<amiga>" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4699 ../src/guestfs-actions.pod:7528 +#: ../fish/guestfish-actions.pod:4707 ../src/guestfs-actions.pod:7536 msgid "B<rdb>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4701 ../src/guestfs-actions.pod:7530 +#: ../fish/guestfish-actions.pod:4709 ../src/guestfs-actions.pod:7538 msgid "Amiga \"Rigid Disk Block\" format." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4703 ../src/guestfs-actions.pod:7532 +#: ../fish/guestfish-actions.pod:4711 ../src/guestfs-actions.pod:7540 msgid "B<bsd>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4705 ../src/guestfs-actions.pod:7534 +#: ../fish/guestfish-actions.pod:4713 ../src/guestfs-actions.pod:7542 msgid "BSD disk labels." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4707 ../src/guestfs-actions.pod:7536 +#: ../fish/guestfish-actions.pod:4715 ../src/guestfs-actions.pod:7544 msgid "B<dasd>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4709 ../src/guestfs-actions.pod:7538 +#: ../fish/guestfish-actions.pod:4717 ../src/guestfs-actions.pod:7546 msgid "DASD, used on IBM mainframes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4711 ../src/guestfs-actions.pod:7540 +#: ../fish/guestfish-actions.pod:4719 ../src/guestfs-actions.pod:7548 msgid "B<dvh>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4713 ../src/guestfs-actions.pod:7542 +#: ../fish/guestfish-actions.pod:4721 ../src/guestfs-actions.pod:7550 msgid "MIPS/SGI volumes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4715 ../src/guestfs-actions.pod:7544 +#: ../fish/guestfish-actions.pod:4723 ../src/guestfs-actions.pod:7552 msgid "B<mac>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4717 ../src/guestfs-actions.pod:7546 +#: ../fish/guestfish-actions.pod:4725 ../src/guestfs-actions.pod:7554 msgid "Old Mac partition format. Modern Macs use C<gpt>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4719 ../src/guestfs-actions.pod:7548 +#: ../fish/guestfish-actions.pod:4727 ../src/guestfs-actions.pod:7556 msgid "B<pc98>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4721 ../src/guestfs-actions.pod:7550 +#: ../fish/guestfish-actions.pod:4729 ../src/guestfs-actions.pod:7558 msgid "NEC PC-98 format, common in Japan apparently." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4723 ../src/guestfs-actions.pod:7552 +#: ../fish/guestfish-actions.pod:4731 ../src/guestfs-actions.pod:7560 msgid "B<sun>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4725 ../src/guestfs-actions.pod:7554 +#: ../fish/guestfish-actions.pod:4733 ../src/guestfs-actions.pod:7562 msgid "Sun disk labels." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4729 +#: ../fish/guestfish-actions.pod:4737 msgid "part-list" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4731 +#: ../fish/guestfish-actions.pod:4739 #, no-wrap msgid "" " part-list device\n" @@ -17893,66 +17971,66 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4733 ../src/guestfs-actions.pod:7568 +#: ../fish/guestfish-actions.pod:4741 ../src/guestfs-actions.pod:7576 msgid "" "This command parses the partition table on C<device> and returns the list of " "partitions found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4736 ../src/guestfs-actions.pod:7571 +#: ../fish/guestfish-actions.pod:4744 ../src/guestfs-actions.pod:7579 msgid "The fields in the returned structure are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4740 ../src/guestfs-actions.pod:7575 +#: ../fish/guestfish-actions.pod:4748 ../src/guestfs-actions.pod:7583 msgid "B<part_num>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4742 ../src/guestfs-actions.pod:7577 +#: ../fish/guestfish-actions.pod:4750 ../src/guestfs-actions.pod:7585 msgid "Partition number, counting from 1." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4744 ../src/guestfs-actions.pod:7579 +#: ../fish/guestfish-actions.pod:4752 ../src/guestfs-actions.pod:7587 msgid "B<part_start>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4746 +#: ../fish/guestfish-actions.pod:4754 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:4749 ../src/guestfs-actions.pod:7584 +#: ../fish/guestfish-actions.pod:4757 ../src/guestfs-actions.pod:7592 msgid "B<part_end>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4751 ../src/guestfs-actions.pod:7586 +#: ../fish/guestfish-actions.pod:4759 ../src/guestfs-actions.pod:7594 msgid "End of the partition in bytes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4753 ../src/guestfs-actions.pod:7588 +#: ../fish/guestfish-actions.pod:4761 ../src/guestfs-actions.pod:7596 msgid "B<part_size>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4755 ../src/guestfs-actions.pod:7590 +#: ../fish/guestfish-actions.pod:4763 ../src/guestfs-actions.pod:7598 msgid "Size of the partition in bytes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4759 +#: ../fish/guestfish-actions.pod:4767 msgid "part-set-bootable" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4761 +#: ../fish/guestfish-actions.pod:4769 #, no-wrap msgid "" " part-set-bootable device partnum true|false\n" @@ -17960,14 +18038,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4763 ../src/guestfs-actions.pod:7608 +#: ../fish/guestfish-actions.pod:4771 ../src/guestfs-actions.pod:7616 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:4766 ../src/guestfs-actions.pod:7611 +#: ../fish/guestfish-actions.pod:4774 ../src/guestfs-actions.pod:7619 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 " @@ -17975,12 +18053,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4770 +#: ../fish/guestfish-actions.pod:4778 msgid "part-set-mbr-id" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4772 +#: ../fish/guestfish-actions.pod:4780 #, no-wrap msgid "" " part-set-mbr-id device partnum idbyte\n" @@ -17988,7 +18066,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4774 ../src/guestfs-actions.pod:7627 +#: ../fish/guestfish-actions.pod:4782 ../src/guestfs-actions.pod:7635 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 " @@ -17997,12 +18075,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4784 +#: ../fish/guestfish-actions.pod:4792 msgid "part-set-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4786 +#: ../fish/guestfish-actions.pod:4794 #, no-wrap msgid "" " part-set-name device partnum name\n" @@ -18010,26 +18088,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4788 ../src/guestfs-actions.pod:7649 +#: ../fish/guestfish-actions.pod:4796 ../src/guestfs-actions.pod:7657 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:4791 ../src/guestfs-actions.pod:7652 +#: ../fish/guestfish-actions.pod:4799 ../src/guestfs-actions.pod:7660 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:4794 +#: ../fish/guestfish-actions.pod:4802 msgid "part-to-dev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4796 +#: ../fish/guestfish-actions.pod:4804 #, no-wrap msgid "" " part-to-dev partition\n" @@ -18037,31 +18115,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4798 ../src/guestfs-actions.pod:7665 +#: ../fish/guestfish-actions.pod:4806 ../src/guestfs-actions.pod:7673 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:4802 ../fish/guestfish-actions.pod:4814 +#: ../fish/guestfish-actions.pod:4810 ../fish/guestfish-actions.pod:4822 msgid "" "The named partition must exist, for example as a string returned from " "L</list-partitions>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4805 +#: ../fish/guestfish-actions.pod:4813 msgid "See also L</part-to-partnum>, L</device-index>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4807 +#: ../fish/guestfish-actions.pod:4815 msgid "part-to-partnum" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4809 +#: ../fish/guestfish-actions.pod:4817 #, no-wrap msgid "" " part-to-partnum partition\n" @@ -18069,24 +18147,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4811 ../src/guestfs-actions.pod:7685 +#: ../fish/guestfish-actions.pod:4819 ../src/guestfs-actions.pod:7693 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:4817 +#: ../fish/guestfish-actions.pod:4825 msgid "See also L</part-to-dev>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4819 +#: ../fish/guestfish-actions.pod:4827 msgid "ping-daemon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4821 +#: ../fish/guestfish-actions.pod:4829 #, no-wrap msgid "" " ping-daemon\n" @@ -18094,7 +18172,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4823 ../src/guestfs-actions.pod:7702 +#: ../fish/guestfish-actions.pod:4831 ../src/guestfs-actions.pod:7710 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 " @@ -18103,12 +18181,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4828 +#: ../fish/guestfish-actions.pod:4836 msgid "pread" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4830 +#: ../fish/guestfish-actions.pod:4838 #, no-wrap msgid "" " pread path count offset\n" @@ -18116,31 +18194,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4832 ../src/guestfs-actions.pod:7720 +#: ../fish/guestfish-actions.pod:4840 ../src/guestfs-actions.pod:7728 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:4835 ../fish/guestfish-actions.pod:4850 ../src/guestfs-actions.pod:7723 ../src/guestfs-actions.pod:7749 +#: ../fish/guestfish-actions.pod:4843 ../fish/guestfish-actions.pod:4858 ../src/guestfs-actions.pod:7731 ../src/guestfs-actions.pod:7757 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:4838 +#: ../fish/guestfish-actions.pod:4846 msgid "See also L</pwrite>, L</pread-device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4843 +#: ../fish/guestfish-actions.pod:4851 msgid "pread-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4845 +#: ../fish/guestfish-actions.pod:4853 #, no-wrap msgid "" " pread-device device count offset\n" @@ -18148,24 +18226,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4847 ../src/guestfs-actions.pod:7746 +#: ../fish/guestfish-actions.pod:4855 ../src/guestfs-actions.pod:7754 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:4853 +#: ../fish/guestfish-actions.pod:4861 msgid "See also L</pread>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4858 +#: ../fish/guestfish-actions.pod:4866 msgid "pvchange-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4860 +#: ../fish/guestfish-actions.pod:4868 #, no-wrap msgid "" " pvchange-uuid device\n" @@ -18173,17 +18251,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4862 ../src/guestfs-actions.pod:7769 +#: ../fish/guestfish-actions.pod:4870 ../src/guestfs-actions.pod:7777 msgid "Generate a new random UUID for the physical volume C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4864 +#: ../fish/guestfish-actions.pod:4872 msgid "pvchange-uuid-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4866 +#: ../fish/guestfish-actions.pod:4874 #, no-wrap msgid "" " pvchange-uuid-all\n" @@ -18191,17 +18269,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4868 ../src/guestfs-actions.pod:7780 +#: ../fish/guestfish-actions.pod:4876 ../src/guestfs-actions.pod:7788 msgid "Generate new random UUIDs for all physical volumes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4870 +#: ../fish/guestfish-actions.pod:4878 msgid "pvcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4872 +#: ../fish/guestfish-actions.pod:4880 #, no-wrap msgid "" " pvcreate device\n" @@ -18209,19 +18287,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4874 ../src/guestfs-actions.pod:7792 +#: ../fish/guestfish-actions.pod:4882 ../src/guestfs-actions.pod:7800 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:4878 +#: ../fish/guestfish-actions.pod:4886 msgid "pvremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4880 +#: ../fish/guestfish-actions.pod:4888 #, no-wrap msgid "" " pvremove device\n" @@ -18229,14 +18307,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4882 ../src/guestfs-actions.pod:7806 +#: ../fish/guestfish-actions.pod:4890 ../src/guestfs-actions.pod:7814 msgid "" "This wipes a physical volume C<device> so that LVM will no longer recognise " "it." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4885 ../src/guestfs-actions.pod:7809 +#: ../fish/guestfish-actions.pod:4893 ../src/guestfs-actions.pod:7817 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 " @@ -18244,12 +18322,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4889 +#: ../fish/guestfish-actions.pod:4897 msgid "pvresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4891 +#: ../fish/guestfish-actions.pod:4899 #, no-wrap msgid "" " pvresize device\n" @@ -18257,19 +18335,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4893 ../src/guestfs-actions.pod:7823 +#: ../fish/guestfish-actions.pod:4901 ../src/guestfs-actions.pod:7831 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:4896 +#: ../fish/guestfish-actions.pod:4904 msgid "pvresize-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4898 +#: ../fish/guestfish-actions.pod:4906 #, no-wrap msgid "" " pvresize-size device size\n" @@ -18277,19 +18355,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4900 +#: ../fish/guestfish-actions.pod:4908 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:4903 +#: ../fish/guestfish-actions.pod:4911 msgid "pvs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4905 +#: ../fish/guestfish-actions.pod:4913 #, no-wrap msgid "" " pvs\n" @@ -18297,31 +18375,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4907 ../src/guestfs-actions.pod:7849 +#: ../fish/guestfish-actions.pod:4915 ../src/guestfs-actions.pod:7857 msgid "" "List all the physical volumes detected. This is the equivalent of the " "L<pvs(8)> command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4910 ../src/guestfs-actions.pod:7852 +#: ../fish/guestfish-actions.pod:4918 ../src/guestfs-actions.pod:7860 msgid "" "This returns a list of just the device names that contain PVs " "(eg. C</dev/sda2>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4913 +#: ../fish/guestfish-actions.pod:4921 msgid "See also L</pvs-full>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4915 +#: ../fish/guestfish-actions.pod:4923 msgid "pvs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4917 +#: ../fish/guestfish-actions.pod:4925 #, no-wrap msgid "" " pvs-full\n" @@ -18329,19 +18407,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4919 ../src/guestfs-actions.pod:7868 +#: ../fish/guestfish-actions.pod:4927 ../src/guestfs-actions.pod:7876 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:4922 +#: ../fish/guestfish-actions.pod:4930 msgid "pvuuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4924 +#: ../fish/guestfish-actions.pod:4932 #, no-wrap msgid "" " pvuuid device\n" @@ -18349,17 +18427,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4926 ../src/guestfs-actions.pod:7883 +#: ../fish/guestfish-actions.pod:4934 ../src/guestfs-actions.pod:7891 msgid "This command returns the UUID of the LVM PV C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4928 +#: ../fish/guestfish-actions.pod:4936 msgid "pwrite" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4930 +#: ../fish/guestfish-actions.pod:4938 #, no-wrap msgid "" " pwrite path content offset\n" @@ -18367,14 +18445,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4932 ../src/guestfs-actions.pod:7899 +#: ../fish/guestfish-actions.pod:4940 ../src/guestfs-actions.pod:7907 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:4935 ../src/guestfs-actions.pod:7902 +#: ../fish/guestfish-actions.pod:4943 ../src/guestfs-actions.pod:7910 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 " @@ -18384,17 +18462,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4941 +#: ../fish/guestfish-actions.pod:4949 msgid "See also L</pread>, L</pwrite-device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4946 +#: ../fish/guestfish-actions.pod:4954 msgid "pwrite-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4948 +#: ../fish/guestfish-actions.pod:4956 #, no-wrap msgid "" " pwrite-device device content offset\n" @@ -18402,14 +18480,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4950 ../src/guestfs-actions.pod:7926 +#: ../fish/guestfish-actions.pod:4958 ../src/guestfs-actions.pod:7934 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:4953 ../src/guestfs-actions.pod:7929 +#: ../fish/guestfish-actions.pod:4961 ../src/guestfs-actions.pod:7937 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 " @@ -18417,17 +18495,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4958 +#: ../fish/guestfish-actions.pod:4966 msgid "See also L</pwrite>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4963 +#: ../fish/guestfish-actions.pod:4971 msgid "read-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4965 +#: ../fish/guestfish-actions.pod:4973 #, no-wrap msgid "" " read-file path\n" @@ -18435,24 +18513,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4967 ../src/guestfs-actions.pod:7950 +#: ../fish/guestfish-actions.pod:4975 ../src/guestfs-actions.pod:7958 msgid "This calls returns the contents of the file C<path> as a buffer." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4970 +#: ../fish/guestfish-actions.pod:4978 msgid "" "Unlike L</cat>, this function can correctly handle files that contain " "embedded ASCII NUL characters." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4973 +#: ../fish/guestfish-actions.pod:4981 msgid "read-lines" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4975 +#: ../fish/guestfish-actions.pod:4983 #, no-wrap msgid "" " read-lines path\n" @@ -18460,14 +18538,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4979 ../src/guestfs-actions.pod:7970 +#: ../fish/guestfish-actions.pod:4987 ../src/guestfs-actions.pod:7978 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:4982 +#: ../fish/guestfish-actions.pod:4990 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of string). For " @@ -18476,12 +18554,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4987 +#: ../fish/guestfish-actions.pod:4995 msgid "readdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4989 +#: ../fish/guestfish-actions.pod:4997 #, no-wrap msgid "" " readdir dir\n" @@ -18489,12 +18567,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4991 ../src/guestfs-actions.pod:7990 +#: ../fish/guestfish-actions.pod:4999 ../src/guestfs-actions.pod:7998 msgid "This returns the list of directory entries in directory C<dir>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4993 ../src/guestfs-actions.pod:7992 +#: ../fish/guestfish-actions.pod:5001 ../src/guestfs-actions.pod:8000 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 " @@ -18502,84 +18580,84 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4997 ../src/guestfs-actions.pod:7996 +#: ../fish/guestfish-actions.pod:5005 ../src/guestfs-actions.pod:8004 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:5002 ../src/guestfs-actions.pod:8001 +#: ../fish/guestfish-actions.pod:5010 ../src/guestfs-actions.pod:8009 msgid "'b'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5004 ../src/guestfs-actions.pod:8003 +#: ../fish/guestfish-actions.pod:5012 ../src/guestfs-actions.pod:8011 msgid "Block special" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5008 ../src/guestfs-actions.pod:8007 +#: ../fish/guestfish-actions.pod:5016 ../src/guestfs-actions.pod:8015 msgid "Char special" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5012 ../src/guestfs-actions.pod:8011 +#: ../fish/guestfish-actions.pod:5020 ../src/guestfs-actions.pod:8019 msgid "Directory" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5014 ../src/guestfs-actions.pod:8013 +#: ../fish/guestfish-actions.pod:5022 ../src/guestfs-actions.pod:8021 msgid "'f'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5016 ../src/guestfs-actions.pod:8015 +#: ../fish/guestfish-actions.pod:5024 ../src/guestfs-actions.pod:8023 msgid "FIFO (named pipe)" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5018 ../src/guestfs-actions.pod:8017 +#: ../fish/guestfish-actions.pod:5026 ../src/guestfs-actions.pod:8025 msgid "'l'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5020 ../src/guestfs-actions.pod:8019 +#: ../fish/guestfish-actions.pod:5028 ../src/guestfs-actions.pod:8027 msgid "Symbolic link" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5022 ../src/guestfs-actions.pod:8021 +#: ../fish/guestfish-actions.pod:5030 ../src/guestfs-actions.pod:8029 msgid "'r'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5024 ../src/guestfs-actions.pod:8023 +#: ../fish/guestfish-actions.pod:5032 ../src/guestfs-actions.pod:8031 msgid "Regular file" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5028 ../src/guestfs-actions.pod:8027 +#: ../fish/guestfish-actions.pod:5036 ../src/guestfs-actions.pod:8035 msgid "Socket" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5032 ../src/guestfs-actions.pod:8031 +#: ../fish/guestfish-actions.pod:5040 ../src/guestfs-actions.pod:8039 msgid "Unknown file type" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5034 ../src/guestfs-actions.pod:8033 +#: ../fish/guestfish-actions.pod:5042 ../src/guestfs-actions.pod:8041 msgid "'?'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5036 ../src/guestfs-actions.pod:8035 +#: ../fish/guestfish-actions.pod:5044 ../src/guestfs-actions.pod:8043 msgid "The L<readdir(3)> call returned a C<d_type> field with an unexpected value" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5041 +#: ../fish/guestfish-actions.pod:5049 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 " @@ -18587,12 +18665,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5048 +#: ../fish/guestfish-actions.pod:5056 msgid "readlink" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5050 +#: ../fish/guestfish-actions.pod:5058 #, no-wrap msgid "" " readlink path\n" @@ -18600,17 +18678,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5052 ../src/guestfs-actions.pod:8059 +#: ../fish/guestfish-actions.pod:5060 ../src/guestfs-actions.pod:8067 msgid "This command reads the target of a symbolic link." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5054 +#: ../fish/guestfish-actions.pod:5062 msgid "readlinklist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5056 +#: ../fish/guestfish-actions.pod:5064 #, no-wrap msgid "" " readlinklist path 'names ...'\n" @@ -18618,7 +18696,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5058 ../src/guestfs-actions.pod:8073 +#: ../fish/guestfish-actions.pod:5066 ../src/guestfs-actions.pod:8081 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 " @@ -18626,14 +18704,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5062 ../src/guestfs-actions.pod:8077 +#: ../fish/guestfish-actions.pod:5070 ../src/guestfs-actions.pod:8085 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:5066 ../src/guestfs-actions.pod:8081 +#: ../fish/guestfish-actions.pod:5074 ../src/guestfs-actions.pod:8089 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 " @@ -18643,19 +18721,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5073 ../src/guestfs-actions.pod:8088 +#: ../fish/guestfish-actions.pod:5081 ../src/guestfs-actions.pod:8096 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5076 +#: ../fish/guestfish-actions.pod:5084 msgid "realpath" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5078 +#: ../fish/guestfish-actions.pod:5086 #, no-wrap msgid "" " realpath path\n" @@ -18663,19 +18741,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5080 ../src/guestfs-actions.pod:8103 +#: ../fish/guestfish-actions.pod:5088 ../src/guestfs-actions.pod:8111 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:5083 +#: ../fish/guestfish-actions.pod:5091 msgid "removexattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5085 +#: ../fish/guestfish-actions.pod:5093 #, no-wrap msgid "" " removexattr xattr path\n" @@ -18683,22 +18761,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5087 ../src/guestfs-actions.pod:8118 +#: ../fish/guestfish-actions.pod:5095 ../src/guestfs-actions.pod:8126 msgid "This call removes the extended attribute named C<xattr> of the file C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5090 +#: ../fish/guestfish-actions.pod:5098 msgid "See also: L</lremovexattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5092 +#: ../fish/guestfish-actions.pod:5100 msgid "resize2fs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5094 +#: ../fish/guestfish-actions.pod:5102 #, no-wrap msgid "" " resize2fs device\n" @@ -18706,24 +18784,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5096 ../src/guestfs-actions.pod:8133 +#: ../fish/guestfish-actions.pod:5104 ../src/guestfs-actions.pod:8141 msgid "" "This resizes an ext2, ext3 or ext4 filesystem to match the size of the " "underlying device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5099 ../fish/guestfish-actions.pod:5114 ../fish/guestfish-actions.pod:5123 ../src/guestfs-actions.pod:8136 ../src/guestfs-actions.pod:8157 ../src/guestfs-actions.pod:8173 +#: ../fish/guestfish-actions.pod:5107 ../fish/guestfish-actions.pod:5122 ../fish/guestfish-actions.pod:5131 ../src/guestfs-actions.pod:8144 ../src/guestfs-actions.pod:8165 ../src/guestfs-actions.pod:8181 msgid "See also L<guestfs(3)/RESIZE2FS ERRORS>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5101 +#: ../fish/guestfish-actions.pod:5109 msgid "resize2fs-M" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5103 +#: ../fish/guestfish-actions.pod:5111 #, no-wrap msgid "" " resize2fs-M device\n" @@ -18731,7 +18809,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5105 +#: ../fish/guestfish-actions.pod:5113 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> " @@ -18739,7 +18817,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5109 +#: ../fish/guestfish-actions.pod:5117 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, " @@ -18748,12 +18826,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5116 +#: ../fish/guestfish-actions.pod:5124 msgid "resize2fs-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5118 +#: ../fish/guestfish-actions.pod:5126 #, no-wrap msgid "" " resize2fs-size device size\n" @@ -18761,19 +18839,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5120 +#: ../fish/guestfish-actions.pod:5128 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:5125 +#: ../fish/guestfish-actions.pod:5133 msgid "rm" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5127 +#: ../fish/guestfish-actions.pod:5135 #, no-wrap msgid "" " rm path\n" @@ -18781,17 +18859,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5129 ../src/guestfs-actions.pod:8185 +#: ../fish/guestfish-actions.pod:5137 ../src/guestfs-actions.pod:8193 msgid "Remove the single file C<path>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5131 +#: ../fish/guestfish-actions.pod:5139 msgid "rm-f" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5133 +#: ../fish/guestfish-actions.pod:5141 #, no-wrap msgid "" " rm-f path\n" @@ -18799,31 +18877,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5135 ../src/guestfs-actions.pod:8197 +#: ../fish/guestfish-actions.pod:5143 ../src/guestfs-actions.pod:8205 msgid "Remove the file C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5137 ../src/guestfs-actions.pod:8199 +#: ../fish/guestfish-actions.pod:5145 ../src/guestfs-actions.pod:8207 msgid "" "If the file doesn't exist, that error is ignored. (Other errors, eg. I/O " "errors or bad paths, are not ignored)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5140 +#: ../fish/guestfish-actions.pod:5148 msgid "" "This call cannot remove directories. Use L</rmdir> to remove an empty " "directory, or L</rm-rf> to remove directories recursively." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5144 +#: ../fish/guestfish-actions.pod:5152 msgid "rm-rf" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5146 +#: ../fish/guestfish-actions.pod:5154 #, no-wrap msgid "" " rm-rf path\n" @@ -18831,19 +18909,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5148 ../src/guestfs-actions.pod:8214 +#: ../fish/guestfish-actions.pod:5156 ../src/guestfs-actions.pod:8222 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:5152 +#: ../fish/guestfish-actions.pod:5160 msgid "rmdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5154 +#: ../fish/guestfish-actions.pod:5162 #, no-wrap msgid "" " rmdir path\n" @@ -18851,17 +18929,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5156 ../src/guestfs-actions.pod:8228 +#: ../fish/guestfish-actions.pod:5164 ../src/guestfs-actions.pod:8236 msgid "Remove the single directory C<path>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5158 +#: ../fish/guestfish-actions.pod:5166 msgid "rmmountpoint" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5160 +#: ../fish/guestfish-actions.pod:5168 #, no-wrap msgid "" " rmmountpoint exemptpath\n" @@ -18869,19 +18947,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5162 +#: ../fish/guestfish-actions.pod:5170 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:5166 +#: ../fish/guestfish-actions.pod:5174 msgid "rsync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5168 +#: ../fish/guestfish-actions.pod:5176 #, no-wrap msgid "" " rsync src dest [archive:true|false] [deletedest:true|false]\n" @@ -18889,7 +18967,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5170 ../src/guestfs-actions.pod:8264 +#: ../fish/guestfish-actions.pod:5178 ../src/guestfs-actions.pod:8272 msgid "" "This call may be used to copy or synchronize two directories under the same " "libguestfs handle. This uses the L<rsync(1)> program which uses a fast " @@ -18897,41 +18975,41 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5175 ../src/guestfs-actions.pod:8269 +#: ../fish/guestfish-actions.pod:5183 ../src/guestfs-actions.pod:8277 msgid "" "C<src> and C<dest> are the source and destination directories. Files are " "copied from C<src> to C<dest>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5182 ../src/guestfs-actions.pod:8276 +#: ../fish/guestfish-actions.pod:5190 ../src/guestfs-actions.pod:8284 msgid "C<archive>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5184 ../src/guestfs-actions.pod:8278 +#: ../fish/guestfish-actions.pod:5192 ../src/guestfs-actions.pod:8286 msgid "" "Turns on archive mode. This is the same as passing the I<--archive> flag to " "C<rsync>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5187 ../src/guestfs-actions.pod:8281 +#: ../fish/guestfish-actions.pod:5195 ../src/guestfs-actions.pod:8289 msgid "C<deletedest>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5189 ../src/guestfs-actions.pod:8283 +#: ../fish/guestfish-actions.pod:5197 ../src/guestfs-actions.pod:8291 msgid "Delete files at the destination that do not exist at the source." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5195 +#: ../fish/guestfish-actions.pod:5203 msgid "rsync-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5197 +#: ../fish/guestfish-actions.pod:5205 #, no-wrap msgid "" " rsync-in remote dest [archive:true|false] [deletedest:true|false]\n" @@ -18939,7 +19017,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5199 ../src/guestfs-actions.pod:8331 +#: ../fish/guestfish-actions.pod:5207 ../src/guestfs-actions.pod:8339 msgid "" "This call may be used to copy or synchronize the filesystem on the host or " "on a remote computer with the filesystem within libguestfs. This uses the " @@ -18948,21 +19026,21 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5204 ../fish/guestfish-actions.pod:5228 +#: ../fish/guestfish-actions.pod:5212 ../fish/guestfish-actions.pod:5236 msgid "" "This call only works if the network is enabled. See L</set-network> or the " "I<--network> option to various tools like L<guestfish(1)>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5208 ../src/guestfs-actions.pod:8340 +#: ../fish/guestfish-actions.pod:5216 ../src/guestfs-actions.pod:8348 msgid "" "Files are copied from the remote server and directory specified by C<remote> " "to the destination directory C<dest>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5211 ../fish/guestfish-actions.pod:5235 ../src/guestfs-actions.pod:8343 ../src/guestfs-actions.pod:8405 +#: ../fish/guestfish-actions.pod:5219 ../fish/guestfish-actions.pod:5243 ../src/guestfs-actions.pod:8351 ../src/guestfs-actions.pod:8413 msgid "" "The format of the remote server string is defined by L<rsync(1)>. Note that " "there is no way to supply a password or passphrase so the target must be set " @@ -18970,17 +19048,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5215 ../fish/guestfish-actions.pod:5239 +#: ../fish/guestfish-actions.pod:5223 ../fish/guestfish-actions.pod:5247 msgid "The optional arguments are the same as those of L</rsync>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5219 +#: ../fish/guestfish-actions.pod:5227 msgid "rsync-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5221 +#: ../fish/guestfish-actions.pod:5229 #, no-wrap msgid "" " rsync-out src remote [archive:true|false] [deletedest:true|false]\n" @@ -18988,7 +19066,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5223 ../src/guestfs-actions.pod:8393 +#: ../fish/guestfish-actions.pod:5231 ../src/guestfs-actions.pod:8401 msgid "" "This call may be used to copy or synchronize the filesystem within " "libguestfs with a filesystem on the host or on a remote computer. This uses " @@ -18997,19 +19075,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5232 ../src/guestfs-actions.pod:8402 +#: ../fish/guestfish-actions.pod:5240 ../src/guestfs-actions.pod:8410 msgid "" "Files are copied from the source directory C<src> to the remote server and " "directory specified by C<remote>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5243 +#: ../fish/guestfish-actions.pod:5251 msgid "scrub-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5245 +#: ../fish/guestfish-actions.pod:5253 #, no-wrap msgid "" " scrub-device device\n" @@ -19017,26 +19095,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5247 ../src/guestfs-actions.pod:8445 +#: ../fish/guestfish-actions.pod:5255 ../src/guestfs-actions.pod:8453 msgid "" "This command writes patterns over C<device> to make data retrieval more " "difficult." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5250 ../fish/guestfish-actions.pod:5262 ../fish/guestfish-actions.pod:5275 ../src/guestfs-actions.pod:8448 ../src/guestfs-actions.pod:8466 ../src/guestfs-actions.pod:8485 +#: ../fish/guestfish-actions.pod:5258 ../fish/guestfish-actions.pod:5270 ../fish/guestfish-actions.pod:5283 ../src/guestfs-actions.pod:8456 ../src/guestfs-actions.pod:8474 ../src/guestfs-actions.pod:8493 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:5253 +#: ../fish/guestfish-actions.pod:5261 msgid "scrub-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5255 +#: ../fish/guestfish-actions.pod:5263 #, no-wrap msgid "" " scrub-file file\n" @@ -19044,24 +19122,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5257 ../src/guestfs-actions.pod:8461 +#: ../fish/guestfish-actions.pod:5265 ../src/guestfs-actions.pod:8469 msgid "" "This command writes patterns over a file to make data retrieval more " "difficult." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5260 ../src/guestfs-actions.pod:8464 +#: ../fish/guestfish-actions.pod:5268 ../src/guestfs-actions.pod:8472 msgid "The file is I<removed> after scrubbing." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5265 +#: ../fish/guestfish-actions.pod:5273 msgid "scrub-freespace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5267 +#: ../fish/guestfish-actions.pod:5275 #, no-wrap msgid "" " scrub-freespace dir\n" @@ -19069,7 +19147,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5269 +#: ../fish/guestfish-actions.pod:5277 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 " @@ -19078,17 +19156,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5278 +#: ../fish/guestfish-actions.pod:5286 msgid "set-append" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5280 +#: ../fish/guestfish-actions.pod:5288 msgid "append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5282 +#: ../fish/guestfish-actions.pod:5290 #, no-wrap msgid "" " set-append append\n" @@ -19096,38 +19174,38 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5284 ../src/guestfs-actions.pod:8498 +#: ../fish/guestfish-actions.pod:5292 ../src/guestfs-actions.pod:8506 msgid "" "This function is used to add additional options to the guest kernel command " "line." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5287 ../src/guestfs-actions.pod:8501 +#: ../fish/guestfish-actions.pod:5295 ../src/guestfs-actions.pod:8509 msgid "" "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> " "environment variable." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5290 ../src/guestfs-actions.pod:8504 +#: ../fish/guestfish-actions.pod:5298 ../src/guestfs-actions.pod:8512 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:5293 +#: ../fish/guestfish-actions.pod:5301 msgid "set-attach-method" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5295 +#: ../fish/guestfish-actions.pod:5303 msgid "attach-method" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5297 +#: ../fish/guestfish-actions.pod:5305 #, no-wrap msgid "" " set-attach-method attachmethod\n" @@ -19135,63 +19213,63 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5299 ../src/guestfs-actions.pod:8517 +#: ../fish/guestfish-actions.pod:5307 ../src/guestfs-actions.pod:8525 msgid "" "Set the method that libguestfs uses to connect to the back end guestfsd " "daemon." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5302 ../src/guestfs-actions.pod:8520 +#: ../fish/guestfish-actions.pod:5310 ../src/guestfs-actions.pod:8528 msgid "Possible attach methods are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5306 ../src/guestfs-actions.pod:8524 ../src/guestfs.pod:3195 +#: ../fish/guestfish-actions.pod:5314 ../src/guestfs-actions.pod:8532 ../src/guestfs.pod:3199 msgid "C<appliance>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5308 ../src/guestfs-actions.pod:8526 +#: ../fish/guestfish-actions.pod:5316 ../src/guestfs-actions.pod:8534 msgid "Launch an appliance and connect to it." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5310 ../src/guestfs-actions.pod:8528 +#: ../fish/guestfish-actions.pod:5318 ../src/guestfs-actions.pod:8536 msgid "" "This is the ordinary method and normally the default, but see the note " "below." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5313 ../src/guestfs-actions.pod:8531 +#: ../fish/guestfish-actions.pod:5321 ../src/guestfs-actions.pod:8539 msgid "C<libvirt>" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5315 ../src/guestfs-actions.pod:8533 +#: ../fish/guestfish-actions.pod:5323 ../src/guestfs-actions.pod:8541 msgid "C<libvirt:I<URI>>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5317 ../src/guestfs-actions.pod:8535 +#: ../fish/guestfish-actions.pod:5325 ../src/guestfs-actions.pod:8543 msgid "" "Use libvirt to launch the appliance. The optional I<URI> is the libvirt " "connection URI to use (see L<http://libvirt.org/uri.html>)." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5320 ../src/guestfs-actions.pod:8538 +#: ../fish/guestfish-actions.pod:5328 ../src/guestfs-actions.pod:8546 msgid "C<unix:I<path>>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5322 ../src/guestfs-actions.pod:8540 +#: ../fish/guestfish-actions.pod:5330 ../src/guestfs-actions.pod:8548 msgid "Connect to the Unix domain socket I<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5324 ../src/guestfs-actions.pod:8542 +#: ../fish/guestfish-actions.pod:5332 ../src/guestfs-actions.pod:8550 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 " @@ -19199,43 +19277,43 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5330 ../src/guestfs-actions.pod:8548 +#: ../fish/guestfish-actions.pod:5338 ../src/guestfs-actions.pod:8556 msgid "" "C<appliance> is usually the default attach method. However since libguestfs " "E<ge> 1.19.24 it has been possible to change the default in two ways:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5336 ../src/guestfs-actions.pod:8554 +#: ../fish/guestfish-actions.pod:5344 ../src/guestfs-actions.pod:8562 msgid "Setting LIBGUESTFS_ATTACH_METHOD" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5338 ../src/guestfs-actions.pod:8556 +#: ../fish/guestfish-actions.pod:5346 ../src/guestfs-actions.pod:8564 msgid "Users can set this environment variable to change the default." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5340 ../src/guestfs-actions.pod:8558 +#: ../fish/guestfish-actions.pod:5348 ../src/guestfs-actions.pod:8566 msgid "Configuring the default attach method when building libguestfs" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5342 ../src/guestfs-actions.pod:8560 +#: ../fish/guestfish-actions.pod:5350 ../src/guestfs-actions.pod:8568 msgid "" "Distributors can override the default when libguestfs is built (using " "C<./configure --with-default-attach-method=...>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5345 ../src/guestfs-actions.pod:8563 +#: ../fish/guestfish-actions.pod:5353 ../src/guestfs-actions.pod:8571 msgid "" "To find out if libguestfs was compiled with a different default attach " "method, do:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5348 ../src/guestfs-actions.pod:8566 +#: ../fish/guestfish-actions.pod:5356 ../src/guestfs-actions.pod:8574 #, no-wrap msgid "" " guestfish get-attach-method\n" @@ -19243,17 +19321,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5352 +#: ../fish/guestfish-actions.pod:5360 msgid "set-autosync" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5354 +#: ../fish/guestfish-actions.pod:5362 msgid "autosync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5356 +#: ../fish/guestfish-actions.pod:5364 #, no-wrap msgid "" " set-autosync true|false\n" @@ -19261,7 +19339,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5358 ../src/guestfs-actions.pod:8580 +#: ../fish/guestfish-actions.pod:5366 ../src/guestfs-actions.pod:8588 msgid "" "If C<autosync> is true, this enables autosync. Libguestfs will make a best " "effort attempt to make filesystems consistent and synchronized when the " @@ -19269,24 +19347,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5363 ../src/guestfs-actions.pod:8585 +#: ../fish/guestfish-actions.pod:5371 ../src/guestfs-actions.pod:8593 msgid "" "This is enabled by default (since libguestfs 1.5.24, previously it was " "disabled by default)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5366 +#: ../fish/guestfish-actions.pod:5374 msgid "set-direct" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5368 +#: ../fish/guestfish-actions.pod:5376 msgid "direct" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5370 +#: ../fish/guestfish-actions.pod:5378 #, no-wrap msgid "" " set-direct true|false\n" @@ -19294,36 +19372,36 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5372 ../src/guestfs-actions.pod:8598 +#: ../fish/guestfish-actions.pod:5380 ../src/guestfs-actions.pod:8606 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:5376 +#: ../fish/guestfish-actions.pod:5384 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:5380 ../src/guestfs-actions.pod:8606 +#: ../fish/guestfish-actions.pod:5388 ../src/guestfs-actions.pod:8614 msgid "You probably don't want to use this unless you know what you are doing." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5383 ../src/guestfs-actions.pod:8609 +#: ../fish/guestfish-actions.pod:5391 ../src/guestfs-actions.pod:8617 msgid "The default is disabled." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5385 +#: ../fish/guestfish-actions.pod:5393 msgid "set-e2attrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5387 +#: ../fish/guestfish-actions.pod:5395 #, no-wrap msgid "" " set-e2attrs file attrs [clear:true|false]\n" @@ -19331,14 +19409,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5389 ../src/guestfs-actions.pod:8630 +#: ../fish/guestfish-actions.pod:5397 ../src/guestfs-actions.pod:8638 msgid "" "This sets or clears the file attributes C<attrs> associated with the inode " "C<file>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5392 +#: ../fish/guestfish-actions.pod:5400 msgid "" "C<attrs> is a string of characters representing file attributes. See " "L</get-e2attrs> for a list of possible attributes. Not all attributes can " @@ -19346,31 +19424,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5396 ../src/guestfs-actions.pod:8637 +#: ../fish/guestfish-actions.pod:5404 ../src/guestfs-actions.pod:8645 msgid "" "If optional boolean C<clear> is not present or false, then the C<attrs> " "listed are set in the inode." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5399 ../src/guestfs-actions.pod:8640 +#: ../fish/guestfish-actions.pod:5407 ../src/guestfs-actions.pod:8648 msgid "If C<clear> is true, then the C<attrs> listed are cleared in the inode." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5402 ../src/guestfs-actions.pod:8643 +#: ../fish/guestfish-actions.pod:5410 ../src/guestfs-actions.pod:8651 msgid "" "In both cases, other attributes not present in the C<attrs> string are left " "unchanged." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5411 +#: ../fish/guestfish-actions.pod:5419 msgid "set-e2generation" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5413 +#: ../fish/guestfish-actions.pod:5421 #, no-wrap msgid "" " set-e2generation file generation\n" @@ -19378,22 +19456,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5415 ../src/guestfs-actions.pod:8685 +#: ../fish/guestfish-actions.pod:5423 ../src/guestfs-actions.pod:8693 msgid "This sets the ext2 file generation of a file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5417 +#: ../fish/guestfish-actions.pod:5425 msgid "See L</get-e2generation>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5419 +#: ../fish/guestfish-actions.pod:5427 msgid "set-e2label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5421 +#: ../fish/guestfish-actions.pod:5429 #, no-wrap msgid "" " set-e2label device label\n" @@ -19401,33 +19479,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5423 ../src/guestfs-actions.pod:8707 +#: ../fish/guestfish-actions.pod:5431 ../src/guestfs-actions.pod:8715 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:5427 +#: ../fish/guestfish-actions.pod:5435 msgid "" "You can use either L</tune2fs-l> or L</get-e2label> to return the existing " "label on a filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5430 +#: ../fish/guestfish-actions.pod:5438 msgid "" "I<This function is deprecated.> In new code, use the L</set-label> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5437 +#: ../fish/guestfish-actions.pod:5445 msgid "set-e2uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5439 +#: ../fish/guestfish-actions.pod:5447 #, no-wrap msgid "" " set-e2uuid device uuid\n" @@ -19435,7 +19513,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5441 ../src/guestfs-actions.pod:8725 +#: ../fish/guestfish-actions.pod:5449 ../src/guestfs-actions.pod:8733 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>, " @@ -19443,19 +19521,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5446 +#: ../fish/guestfish-actions.pod:5454 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:5449 +#: ../fish/guestfish-actions.pod:5457 msgid "set-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5451 +#: ../fish/guestfish-actions.pod:5459 #, no-wrap msgid "" " set-label device label\n" @@ -19463,44 +19541,44 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5453 ../src/guestfs-actions.pod:8744 +#: ../fish/guestfish-actions.pod:5461 ../src/guestfs-actions.pod:8752 msgid "Set the filesystem label on C<device> to C<label>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5455 ../src/guestfs-actions.pod:8746 +#: ../fish/guestfish-actions.pod:5463 ../src/guestfs-actions.pod:8754 msgid "" "Only some filesystem types support labels, and libguestfs supports setting " "labels on only a subset of these." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5458 ../src/guestfs-actions.pod:8749 +#: ../fish/guestfish-actions.pod:5466 ../src/guestfs-actions.pod:8757 msgid "On ext2/3/4 filesystems, labels are limited to 16 bytes." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5460 ../src/guestfs-actions.pod:8751 +#: ../fish/guestfish-actions.pod:5468 ../src/guestfs-actions.pod:8759 msgid "On NTFS filesystems, labels are limited to 128 unicode characters." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5462 +#: ../fish/guestfish-actions.pod:5470 msgid "To read the label on a filesystem, call L</vfs-label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5464 +#: ../fish/guestfish-actions.pod:5472 msgid "set-memsize" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5466 +#: ../fish/guestfish-actions.pod:5474 msgid "memsize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5468 +#: ../fish/guestfish-actions.pod:5476 #, no-wrap msgid "" " set-memsize memsize\n" @@ -19508,31 +19586,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5470 +#: ../fish/guestfish-actions.pod:5478 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:5474 ../src/guestfs-actions.pod:8769 +#: ../fish/guestfish-actions.pod:5482 ../src/guestfs-actions.pod:8777 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:5481 +#: ../fish/guestfish-actions.pod:5489 msgid "set-network" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5483 +#: ../fish/guestfish-actions.pod:5491 msgid "network" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5485 +#: ../fish/guestfish-actions.pod:5493 #, no-wrap msgid "" " set-network true|false\n" @@ -19540,31 +19618,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5487 ../src/guestfs-actions.pod:8786 +#: ../fish/guestfish-actions.pod:5495 ../src/guestfs-actions.pod:8794 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:5490 ../src/guestfs-actions.pod:8789 +#: ../fish/guestfish-actions.pod:5498 ../src/guestfs-actions.pod:8797 msgid "" "This affects whether commands are able to access the network (see " "L<guestfs(3)/RUNNING COMMANDS>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5493 +#: ../fish/guestfish-actions.pod:5501 msgid "You must call this before calling L</launch>, otherwise it has no effect." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5496 +#: ../fish/guestfish-actions.pod:5504 msgid "set-path" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5500 +#: ../fish/guestfish-actions.pod:5508 #, no-wrap msgid "" " set-path searchpath\n" @@ -19572,34 +19650,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5502 ../src/guestfs-actions.pod:8805 +#: ../fish/guestfish-actions.pod:5510 ../src/guestfs-actions.pod:8813 msgid "Set the path that libguestfs searches for kernel and initrd.img." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5504 ../src/guestfs-actions.pod:8807 +#: ../fish/guestfish-actions.pod:5512 ../src/guestfs-actions.pod:8815 msgid "" "The default is C<$libdir/guestfs> unless overridden by setting " "C<LIBGUESTFS_PATH> environment variable." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5507 ../src/guestfs-actions.pod:8810 +#: ../fish/guestfish-actions.pod:5515 ../src/guestfs-actions.pod:8818 msgid "Setting C<path> to C<NULL> restores the default path." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5509 +#: ../fish/guestfish-actions.pod:5517 msgid "set-pgroup" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5511 +#: ../fish/guestfish-actions.pod:5519 msgid "pgroup" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5513 +#: ../fish/guestfish-actions.pod:5521 #, no-wrap msgid "" " set-pgroup true|false\n" @@ -19607,21 +19685,21 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5515 ../src/guestfs-actions.pod:8822 +#: ../fish/guestfish-actions.pod:5523 ../src/guestfs-actions.pod:8830 msgid "" "If C<pgroup> is true, child processes are placed into their own process " "group." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5518 ../src/guestfs-actions.pod:8825 +#: ../fish/guestfish-actions.pod:5526 ../src/guestfs-actions.pod:8833 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:5521 +#: ../fish/guestfish-actions.pod:5529 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, " @@ -19630,17 +19708,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5526 +#: ../fish/guestfish-actions.pod:5534 msgid "set-qemu" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5528 +#: ../fish/guestfish-actions.pod:5536 msgid "qemu" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5530 +#: ../fish/guestfish-actions.pod:5538 #, no-wrap msgid "" " set-qemu qemu\n" @@ -19648,29 +19726,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5532 ../src/guestfs-actions.pod:8843 +#: ../fish/guestfish-actions.pod:5540 ../src/guestfs-actions.pod:8851 msgid "Set the qemu binary that we will use." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5534 ../src/guestfs-actions.pod:8845 +#: ../fish/guestfish-actions.pod:5542 ../src/guestfs-actions.pod:8853 msgid "The default is chosen when the library was compiled by the configure script." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5537 ../src/guestfs-actions.pod:8848 +#: ../fish/guestfish-actions.pod:5545 ../src/guestfs-actions.pod:8856 msgid "" "You can also override this by setting the C<LIBGUESTFS_QEMU> environment " "variable." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5540 ../src/guestfs-actions.pod:8851 +#: ../fish/guestfish-actions.pod:5548 ../src/guestfs-actions.pod:8859 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5542 ../src/guestfs-actions.pod:8853 +#: ../fish/guestfish-actions.pod:5550 ../src/guestfs-actions.pod:8861 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 " @@ -19681,17 +19759,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5550 +#: ../fish/guestfish-actions.pod:5558 msgid "set-recovery-proc" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5552 +#: ../fish/guestfish-actions.pod:5560 msgid "recovery-proc" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5554 +#: ../fish/guestfish-actions.pod:5562 #, no-wrap msgid "" " set-recovery-proc true|false\n" @@ -19699,7 +19777,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5556 +#: ../fish/guestfish-actions.pod:5564 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 " @@ -19707,14 +19785,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5561 +#: ../fish/guestfish-actions.pod:5569 msgid "" "This only has any effect if called before L</launch>, and the default is " "true." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5564 ../src/guestfs-actions.pod:8879 +#: ../fish/guestfish-actions.pod:5572 ../src/guestfs-actions.pod:8887 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 " @@ -19723,17 +19801,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5570 +#: ../fish/guestfish-actions.pod:5578 msgid "set-selinux" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5572 +#: ../fish/guestfish-actions.pod:5580 msgid "selinux" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5574 +#: ../fish/guestfish-actions.pod:5582 #, no-wrap msgid "" " set-selinux true|false\n" @@ -19741,31 +19819,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5576 ../src/guestfs-actions.pod:8895 +#: ../fish/guestfish-actions.pod:5584 ../src/guestfs-actions.pod:8903 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:5579 ../src/guestfs-actions.pod:8898 +#: ../fish/guestfish-actions.pod:5587 ../src/guestfs-actions.pod:8906 msgid "" "Note that if SELinux is enabled, it is always in Permissive mode " "(C<enforcing=0>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5585 +#: ../fish/guestfish-actions.pod:5593 msgid "set-smp" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5587 +#: ../fish/guestfish-actions.pod:5595 msgid "smp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5589 +#: ../fish/guestfish-actions.pod:5597 #, no-wrap msgid "" " set-smp smp\n" @@ -19773,7 +19851,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5591 ../src/guestfs-actions.pod:8914 +#: ../fish/guestfish-actions.pod:5599 ../src/guestfs-actions.pod:8922 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 " @@ -19781,22 +19859,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5595 +#: ../fish/guestfish-actions.pod:5603 msgid "This function must be called before L</launch>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5597 +#: ../fish/guestfish-actions.pod:5605 msgid "set-trace" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5599 +#: ../fish/guestfish-actions.pod:5607 msgid "trace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5601 +#: ../fish/guestfish-actions.pod:5609 #, no-wrap msgid "" " set-trace true|false\n" @@ -19804,45 +19882,45 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5603 ../src/guestfs-actions.pod:8930 +#: ../fish/guestfish-actions.pod:5611 ../src/guestfs-actions.pod:8938 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:5606 ../src/guestfs-actions.pod:8933 +#: ../fish/guestfish-actions.pod:5614 ../src/guestfs-actions.pod:8941 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:5610 ../src/guestfs-actions.pod:8937 +#: ../fish/guestfish-actions.pod:5618 ../src/guestfs-actions.pod:8945 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:5613 +#: ../fish/guestfish-actions.pod:5621 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:5617 +#: ../fish/guestfish-actions.pod:5625 msgid "set-verbose" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5619 +#: ../fish/guestfish-actions.pod:5627 msgid "verbose" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5621 +#: ../fish/guestfish-actions.pod:5629 #, no-wrap msgid "" " set-verbose true|false\n" @@ -19850,31 +19928,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5623 ../src/guestfs-actions.pod:8954 +#: ../fish/guestfish-actions.pod:5631 ../src/guestfs-actions.pod:8962 msgid "If C<verbose> is true, this turns on verbose messages." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5625 ../src/guestfs-actions.pod:8956 +#: ../fish/guestfish-actions.pod:5633 ../src/guestfs-actions.pod:8964 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:5628 +#: ../fish/guestfish-actions.pod:5636 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:5632 +#: ../fish/guestfish-actions.pod:5640 msgid "setcon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5634 +#: ../fish/guestfish-actions.pod:5642 #, no-wrap msgid "" " setcon context\n" @@ -19882,24 +19960,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5636 ../src/guestfs-actions.pod:8973 +#: ../fish/guestfish-actions.pod:5644 ../src/guestfs-actions.pod:8981 msgid "" "This sets the SELinux security context of the daemon to the string " "C<context>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5639 ../src/guestfs-actions.pod:8976 +#: ../fish/guestfish-actions.pod:5647 ../src/guestfs-actions.pod:8984 msgid "See the documentation about SELINUX in L<guestfs(3)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5641 +#: ../fish/guestfish-actions.pod:5649 msgid "setxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5643 +#: ../fish/guestfish-actions.pod:5651 #, no-wrap msgid "" " setxattr xattr val vallen path\n" @@ -19907,24 +19985,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5645 ../src/guestfs-actions.pod:8991 +#: ../fish/guestfish-actions.pod:5653 ../src/guestfs-actions.pod:8999 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:5649 +#: ../fish/guestfish-actions.pod:5657 msgid "See also: L</lsetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5651 +#: ../fish/guestfish-actions.pod:5659 msgid "sfdisk" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5653 +#: ../fish/guestfish-actions.pod:5661 #, no-wrap msgid "" " sfdisk device cyls heads sectors 'lines ...'\n" @@ -19932,19 +20010,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5655 ../src/guestfs-actions.pod:9018 +#: ../fish/guestfish-actions.pod:5663 ../src/guestfs-actions.pod:9026 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:5658 ../src/guestfs-actions.pod:9021 +#: ../fish/guestfish-actions.pod:5666 ../src/guestfs-actions.pod:9029 msgid "C<device> should be a block device, for example C</dev/sda>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5660 ../src/guestfs-actions.pod:9023 +#: ../fish/guestfish-actions.pod:5668 ../src/guestfs-actions.pod:9031 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>, " @@ -19955,14 +20033,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5668 ../src/guestfs-actions.pod:9031 +#: ../fish/guestfish-actions.pod:5676 ../src/guestfs-actions.pod:9039 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:5671 ../src/guestfs-actions.pod:9034 +#: ../fish/guestfish-actions.pod:5679 ../src/guestfs-actions.pod:9042 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 " @@ -19970,24 +20048,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5675 +#: ../fish/guestfish-actions.pod:5683 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5678 ../fish/guestfish-actions.pod:5698 ../fish/guestfish-actions.pod:5717 +#: ../fish/guestfish-actions.pod:5686 ../fish/guestfish-actions.pod:5706 ../fish/guestfish-actions.pod:5725 msgid "" "I<This function is deprecated.> In new code, use the L</part-add> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5685 +#: ../fish/guestfish-actions.pod:5693 msgid "sfdiskM" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5687 +#: ../fish/guestfish-actions.pod:5695 #, no-wrap msgid "" " sfdiskM device 'lines ...'\n" @@ -19995,7 +20073,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5689 +#: ../fish/guestfish-actions.pod:5697 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 " @@ -20004,17 +20082,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5695 +#: ../fish/guestfish-actions.pod:5703 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5705 +#: ../fish/guestfish-actions.pod:5713 msgid "sfdisk-N" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5707 +#: ../fish/guestfish-actions.pod:5715 #, no-wrap msgid "" " sfdisk-N device partnum cyls heads sectors line\n" @@ -20022,31 +20100,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5709 ../src/guestfs-actions.pod:9090 +#: ../fish/guestfish-actions.pod:5717 ../src/guestfs-actions.pod:9098 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:5712 +#: ../fish/guestfish-actions.pod:5720 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:5715 +#: ../fish/guestfish-actions.pod:5723 msgid "See also: L</part-add>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5724 +#: ../fish/guestfish-actions.pod:5732 msgid "sfdisk-disk-geometry" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5726 +#: ../fish/guestfish-actions.pod:5734 #, no-wrap msgid "" " sfdisk-disk-geometry device\n" @@ -20054,7 +20132,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5728 +#: ../fish/guestfish-actions.pod:5736 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, " @@ -20063,17 +20141,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5733 ../fish/guestfish-actions.pod:5742 ../src/guestfs-actions.pod:9113 ../src/guestfs-actions.pod:9129 +#: ../fish/guestfish-actions.pod:5741 ../fish/guestfish-actions.pod:5750 ../src/guestfs-actions.pod:9121 ../src/guestfs-actions.pod:9137 msgid "The result is in human-readable format, and not designed to be parsed." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5736 +#: ../fish/guestfish-actions.pod:5744 msgid "sfdisk-kernel-geometry" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5738 +#: ../fish/guestfish-actions.pod:5746 #, no-wrap msgid "" " sfdisk-kernel-geometry device\n" @@ -20081,17 +20159,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5740 ../src/guestfs-actions.pod:9127 +#: ../fish/guestfish-actions.pod:5748 ../src/guestfs-actions.pod:9135 msgid "This displays the kernel's idea of the geometry of C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5745 +#: ../fish/guestfish-actions.pod:5753 msgid "sfdisk-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5747 +#: ../fish/guestfish-actions.pod:5755 #, no-wrap msgid "" " sfdisk-l device\n" @@ -20099,31 +20177,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5749 ../src/guestfs-actions.pod:9150 +#: ../fish/guestfish-actions.pod:5757 ../src/guestfs-actions.pod:9158 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:5753 +#: ../fish/guestfish-actions.pod:5761 msgid "See also: L</part-list>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5755 +#: ../fish/guestfish-actions.pod:5763 msgid "" "I<This function is deprecated.> In new code, use the L</part-list> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5762 +#: ../fish/guestfish-actions.pod:5770 msgid "sh" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5764 +#: ../fish/guestfish-actions.pod:5772 #, no-wrap msgid "" " sh command\n" @@ -20131,19 +20209,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5766 ../src/guestfs-actions.pod:9167 +#: ../fish/guestfish-actions.pod:5774 ../src/guestfs-actions.pod:9175 msgid "" "This call runs a command from the guest filesystem via the guest's " "C</bin/sh>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5769 +#: ../fish/guestfish-actions.pod:5777 msgid "This is like L</command>, but passes the command to:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5771 ../src/guestfs-actions.pod:9172 +#: ../fish/guestfish-actions.pod:5779 ../src/guestfs-actions.pod:9180 #, no-wrap msgid "" " /bin/sh -c \"command\"\n" @@ -20151,24 +20229,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5773 ../src/guestfs-actions.pod:9174 +#: ../fish/guestfish-actions.pod:5781 ../src/guestfs-actions.pod:9182 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:5777 +#: ../fish/guestfish-actions.pod:5785 msgid "All the provisos about L</command> apply to this call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5779 +#: ../fish/guestfish-actions.pod:5787 msgid "sh-lines" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5781 +#: ../fish/guestfish-actions.pod:5789 #, no-wrap msgid "" " sh-lines command\n" @@ -20176,22 +20254,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5783 +#: ../fish/guestfish-actions.pod:5791 msgid "This is the same as L</sh>, but splits the result into a list of lines." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5786 +#: ../fish/guestfish-actions.pod:5794 msgid "See also: L</command-lines>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5788 +#: ../fish/guestfish-actions.pod:5796 msgid "shutdown" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5790 +#: ../fish/guestfish-actions.pod:5798 #, no-wrap msgid "" " shutdown\n" @@ -20199,7 +20277,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5792 +#: ../fish/guestfish-actions.pod:5800 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) " @@ -20207,7 +20285,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5796 ../src/guestfs-actions.pod:9211 +#: ../fish/guestfish-actions.pod:5804 ../src/guestfs-actions.pod:9219 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 " @@ -20215,31 +20293,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5800 ../src/guestfs-actions.pod:9215 +#: ../fish/guestfish-actions.pod:5808 ../src/guestfs-actions.pod:9223 msgid "It is safe to call this multiple times. Extra calls are ignored." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5802 +#: ../fish/guestfish-actions.pod:5810 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:5805 +#: ../fish/guestfish-actions.pod:5813 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:5808 +#: ../fish/guestfish-actions.pod:5816 msgid "sleep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5810 +#: ../fish/guestfish-actions.pod:5818 #, no-wrap msgid "" " sleep secs\n" @@ -20247,17 +20325,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5812 ../src/guestfs-actions.pod:9233 +#: ../fish/guestfish-actions.pod:5820 ../src/guestfs-actions.pod:9241 msgid "Sleep for C<secs> seconds." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5814 +#: ../fish/guestfish-actions.pod:5822 msgid "stat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5816 +#: ../fish/guestfish-actions.pod:5824 #, no-wrap msgid "" " stat path\n" @@ -20265,17 +20343,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5820 ../src/guestfs-actions.pod:9247 +#: ../fish/guestfish-actions.pod:5828 ../src/guestfs-actions.pod:9255 msgid "This is the same as the C<stat(2)> system call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5822 +#: ../fish/guestfish-actions.pod:5830 msgid "statvfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5824 +#: ../fish/guestfish-actions.pod:5832 #, no-wrap msgid "" " statvfs path\n" @@ -20283,7 +20361,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5826 ../src/guestfs-actions.pod:9261 +#: ../fish/guestfish-actions.pod:5834 ../src/guestfs-actions.pod:9269 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 " @@ -20291,17 +20369,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5830 ../src/guestfs-actions.pod:9265 +#: ../fish/guestfish-actions.pod:5838 ../src/guestfs-actions.pod:9273 msgid "This is the same as the C<statvfs(2)> system call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5832 +#: ../fish/guestfish-actions.pod:5840 msgid "strings" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5834 +#: ../fish/guestfish-actions.pod:5842 #, no-wrap msgid "" " strings path\n" @@ -20309,19 +20387,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5836 ../src/guestfs-actions.pod:9279 +#: ../fish/guestfish-actions.pod:5844 ../src/guestfs-actions.pod:9287 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:5842 +#: ../fish/guestfish-actions.pod:5850 msgid "strings-e" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5844 +#: ../fish/guestfish-actions.pod:5852 #, no-wrap msgid "" " strings-e encoding path\n" @@ -20329,93 +20407,93 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5846 +#: ../fish/guestfish-actions.pod:5854 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:5850 ../src/guestfs-actions.pod:9302 +#: ../fish/guestfish-actions.pod:5858 ../src/guestfs-actions.pod:9310 msgid "Allowed encodings are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5854 ../src/guestfs-actions.pod:9306 +#: ../fish/guestfish-actions.pod:5862 ../src/guestfs-actions.pod:9314 msgid "s" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5856 +#: ../fish/guestfish-actions.pod:5864 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:5859 ../src/guestfs-actions.pod:9311 +#: ../fish/guestfish-actions.pod:5867 ../src/guestfs-actions.pod:9319 msgid "S" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5861 ../src/guestfs-actions.pod:9313 +#: ../fish/guestfish-actions.pod:5869 ../src/guestfs-actions.pod:9321 msgid "Single 8-bit-byte characters." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5863 ../src/guestfs-actions.pod:9315 +#: ../fish/guestfish-actions.pod:5871 ../src/guestfs-actions.pod:9323 msgid "b" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5865 ../src/guestfs-actions.pod:9317 +#: ../fish/guestfish-actions.pod:5873 ../src/guestfs-actions.pod:9325 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5868 ../src/guestfs-actions.pod:9320 +#: ../fish/guestfish-actions.pod:5876 ../src/guestfs-actions.pod:9328 msgid "l (lower case letter L)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5870 ../src/guestfs-actions.pod:9322 +#: ../fish/guestfish-actions.pod:5878 ../src/guestfs-actions.pod:9330 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:5873 ../src/guestfs-actions.pod:9325 +#: ../fish/guestfish-actions.pod:5881 ../src/guestfs-actions.pod:9333 msgid "B" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5875 ../src/guestfs-actions.pod:9327 +#: ../fish/guestfish-actions.pod:5883 ../src/guestfs-actions.pod:9335 msgid "32-bit big endian such as UCS-4BE." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5877 ../src/guestfs-actions.pod:9329 +#: ../fish/guestfish-actions.pod:5885 ../src/guestfs-actions.pod:9337 msgid "L" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5879 ../src/guestfs-actions.pod:9331 +#: ../fish/guestfish-actions.pod:5887 ../src/guestfs-actions.pod:9339 msgid "32-bit little endian such as UCS-4LE." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5883 ../src/guestfs-actions.pod:9335 +#: ../fish/guestfish-actions.pod:5891 ../src/guestfs-actions.pod:9343 msgid "The returned strings are transcoded to UTF-8." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5888 +#: ../fish/guestfish-actions.pod:5896 msgid "swapoff-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5890 +#: ../fish/guestfish-actions.pod:5898 #, no-wrap msgid "" " swapoff-device device\n" @@ -20423,19 +20501,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5892 +#: ../fish/guestfish-actions.pod:5900 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:5896 +#: ../fish/guestfish-actions.pod:5904 msgid "swapoff-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5898 +#: ../fish/guestfish-actions.pod:5906 #, no-wrap msgid "" " swapoff-file file\n" @@ -20443,17 +20521,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5900 ../src/guestfs-actions.pod:9366 +#: ../fish/guestfish-actions.pod:5908 ../src/guestfs-actions.pod:9374 msgid "This command disables the libguestfs appliance swap on file." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5902 +#: ../fish/guestfish-actions.pod:5910 msgid "swapoff-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5904 +#: ../fish/guestfish-actions.pod:5912 #, no-wrap msgid "" " swapoff-label label\n" @@ -20461,19 +20539,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5906 ../src/guestfs-actions.pod:9378 +#: ../fish/guestfish-actions.pod:5914 ../src/guestfs-actions.pod:9386 msgid "" "This command disables the libguestfs appliance swap on labeled swap " "partition." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5909 +#: ../fish/guestfish-actions.pod:5917 msgid "swapoff-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5911 +#: ../fish/guestfish-actions.pod:5919 #, no-wrap msgid "" " swapoff-uuid uuid\n" @@ -20481,19 +20559,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5913 ../src/guestfs-actions.pod:9391 +#: ../fish/guestfish-actions.pod:5921 ../src/guestfs-actions.pod:9399 msgid "" "This command disables the libguestfs appliance swap partition with the given " "UUID." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5916 +#: ../fish/guestfish-actions.pod:5924 msgid "swapon-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5918 +#: ../fish/guestfish-actions.pod:5926 #, no-wrap msgid "" " swapon-device device\n" @@ -20501,7 +20579,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5920 +#: ../fish/guestfish-actions.pod:5928 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 " @@ -20509,7 +20587,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5925 ../src/guestfs-actions.pod:9409 +#: ../fish/guestfish-actions.pod:5933 ../src/guestfs-actions.pod:9417 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 " @@ -20519,12 +20597,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5932 +#: ../fish/guestfish-actions.pod:5940 msgid "swapon-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5934 +#: ../fish/guestfish-actions.pod:5942 #, no-wrap msgid "" " swapon-file file\n" @@ -20532,17 +20610,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5936 +#: ../fish/guestfish-actions.pod:5944 msgid "This command enables swap to a file. See L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5939 +#: ../fish/guestfish-actions.pod:5947 msgid "swapon-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5941 +#: ../fish/guestfish-actions.pod:5949 #, no-wrap msgid "" " swapon-label label\n" @@ -20550,19 +20628,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5943 +#: ../fish/guestfish-actions.pod:5951 msgid "" "This command enables swap to a labeled swap partition. See " "L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5946 +#: ../fish/guestfish-actions.pod:5954 msgid "swapon-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5948 +#: ../fish/guestfish-actions.pod:5956 #, no-wrap msgid "" " swapon-uuid uuid\n" @@ -20570,19 +20648,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5950 +#: ../fish/guestfish-actions.pod:5958 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:5953 +#: ../fish/guestfish-actions.pod:5961 msgid "sync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5955 +#: ../fish/guestfish-actions.pod:5963 #, no-wrap msgid "" " sync\n" @@ -20590,26 +20668,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5957 ../src/guestfs-actions.pod:9464 +#: ../fish/guestfish-actions.pod:5965 ../src/guestfs-actions.pod:9472 msgid "" "This syncs the disk, so that any writes are flushed through to the " "underlying disk image." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5960 ../src/guestfs-actions.pod:9467 +#: ../fish/guestfish-actions.pod:5968 ../src/guestfs-actions.pod:9475 msgid "" "You should always call this if you have modified a disk image, before " "closing the handle." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5963 +#: ../fish/guestfish-actions.pod:5971 msgid "tail" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5965 +#: ../fish/guestfish-actions.pod:5973 #, no-wrap msgid "" " tail path\n" @@ -20617,17 +20695,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5967 ../src/guestfs-actions.pod:9480 +#: ../fish/guestfish-actions.pod:5975 ../src/guestfs-actions.pod:9488 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:5973 +#: ../fish/guestfish-actions.pod:5981 msgid "tail-n" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5975 +#: ../fish/guestfish-actions.pod:5983 #, no-wrap msgid "" " tail-n nrlines path\n" @@ -20635,31 +20713,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5977 ../src/guestfs-actions.pod:9499 +#: ../fish/guestfish-actions.pod:5985 ../src/guestfs-actions.pod:9507 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:5980 ../src/guestfs-actions.pod:9502 +#: ../fish/guestfish-actions.pod:5988 ../src/guestfs-actions.pod:9510 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:5988 +#: ../fish/guestfish-actions.pod:5996 msgid "tar-in" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5990 +#: ../fish/guestfish-actions.pod:5998 msgid "tar-in-opts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5992 +#: ../fish/guestfish-actions.pod:6000 #, no-wrap msgid "" " tar-in (tarfile|-) directory [compress:..]\n" @@ -20667,12 +20745,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5994 ../src/guestfs-actions.pod:9545 +#: ../fish/guestfish-actions.pod:6002 ../src/guestfs-actions.pod:9553 msgid "This command uploads and unpacks local file C<tarfile> into C<directory>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5996 ../src/guestfs-actions.pod:9547 +#: ../fish/guestfish-actions.pod:6004 ../src/guestfs-actions.pod:9555 msgid "" "The optional C<compress> flag controls compression. If not given, then the " "input should be an uncompressed tar file. Otherwise one of the following " @@ -20682,17 +20760,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6007 +#: ../fish/guestfish-actions.pod:6015 msgid "tar-out" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6009 +#: ../fish/guestfish-actions.pod:6017 msgid "tar-out-opts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6011 +#: ../fish/guestfish-actions.pod:6019 #, no-wrap msgid "" " tar-out directory (tarfile|-) [compress:..] [numericowner:true|false] " @@ -20701,14 +20779,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6013 ../src/guestfs-actions.pod:9613 +#: ../fish/guestfish-actions.pod:6021 ../src/guestfs-actions.pod:9621 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarfile>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6016 ../src/guestfs-actions.pod:9616 +#: ../fish/guestfish-actions.pod:6024 ../src/guestfs-actions.pod:9624 msgid "" "The optional C<compress> flag controls compression. If not given, then the " "output will be an uncompressed tar file. Otherwise one of the following " @@ -20718,39 +20796,39 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6023 ../src/guestfs-actions.pod:9623 +#: ../fish/guestfish-actions.pod:6031 ../src/guestfs-actions.pod:9631 msgid "The other optional arguments are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:6027 ../src/guestfs-actions.pod:9627 +#: ../fish/guestfish-actions.pod:6035 ../src/guestfs-actions.pod:9635 msgid "C<excludes>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6029 ../src/guestfs-actions.pod:9629 +#: ../fish/guestfish-actions.pod:6037 ../src/guestfs-actions.pod:9637 msgid "A list of wildcards. Files are excluded if they match any of the wildcards." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:6032 ../src/guestfs-actions.pod:9632 +#: ../fish/guestfish-actions.pod:6040 ../src/guestfs-actions.pod:9640 msgid "C<numericowner>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6034 ../src/guestfs-actions.pod:9634 +#: ../fish/guestfish-actions.pod:6042 ../src/guestfs-actions.pod:9642 msgid "" "If set to true, the output tar file will contain UID/GID numbers instead of " "user/group names." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6043 +#: ../fish/guestfish-actions.pod:6051 msgid "tgz-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6045 +#: ../fish/guestfish-actions.pod:6053 #, no-wrap msgid "" " tgz-in (tarball|-) directory\n" @@ -20758,26 +20836,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6047 ../src/guestfs-actions.pod:9681 +#: ../fish/guestfish-actions.pod:6055 ../src/guestfs-actions.pod:9689 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:6052 ../fish/guestfish-actions.pod:6206 +#: ../fish/guestfish-actions.pod:6060 ../fish/guestfish-actions.pod:6214 msgid "" "I<This function is deprecated.> In new code, use the L</tar-in> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6059 +#: ../fish/guestfish-actions.pod:6067 msgid "tgz-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6061 +#: ../fish/guestfish-actions.pod:6069 #, no-wrap msgid "" " tgz-out directory (tarball|-)\n" @@ -20785,26 +20863,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6063 ../src/guestfs-actions.pod:9702 +#: ../fish/guestfish-actions.pod:6071 ../src/guestfs-actions.pod:9710 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarball>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6068 ../fish/guestfish-actions.pod:6222 +#: ../fish/guestfish-actions.pod:6076 ../fish/guestfish-actions.pod:6230 msgid "" "I<This function is deprecated.> In new code, use the L</tar-out> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6075 +#: ../fish/guestfish-actions.pod:6083 msgid "touch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6077 +#: ../fish/guestfish-actions.pod:6085 #, no-wrap msgid "" " touch path\n" @@ -20812,7 +20890,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6079 ../src/guestfs-actions.pod:9715 +#: ../fish/guestfish-actions.pod:6087 ../src/guestfs-actions.pod:9723 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 " @@ -20820,19 +20898,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6083 ../src/guestfs-actions.pod:9719 +#: ../fish/guestfish-actions.pod:6091 ../src/guestfs-actions.pod:9727 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:6086 +#: ../fish/guestfish-actions.pod:6094 msgid "truncate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6088 +#: ../fish/guestfish-actions.pod:6096 #, no-wrap msgid "" " truncate path\n" @@ -20840,19 +20918,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6090 ../src/guestfs-actions.pod:9732 +#: ../fish/guestfish-actions.pod:6098 ../src/guestfs-actions.pod:9740 msgid "" "This command truncates C<path> to a zero-length file. The file must exist " "already." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6093 +#: ../fish/guestfish-actions.pod:6101 msgid "truncate-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6095 +#: ../fish/guestfish-actions.pod:6103 #, no-wrap msgid "" " truncate-size path size\n" @@ -20860,14 +20938,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6097 ../src/guestfs-actions.pod:9746 +#: ../fish/guestfish-actions.pod:6105 ../src/guestfs-actions.pod:9754 msgid "" "This command truncates C<path> to size C<size> bytes. The file must exist " "already." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6100 +#: ../fish/guestfish-actions.pod:6108 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 " @@ -20876,12 +20954,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6106 +#: ../fish/guestfish-actions.pod:6114 msgid "tune2fs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6108 +#: ../fish/guestfish-actions.pod:6116 #, no-wrap msgid "" " tune2fs device [force:true|false] [maxmountcount:N] [mountcount:N] " @@ -20892,26 +20970,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6110 ../src/guestfs-actions.pod:9782 +#: ../fish/guestfish-actions.pod:6118 ../src/guestfs-actions.pod:9790 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:6119 ../src/guestfs-actions.pod:9791 +#: ../fish/guestfish-actions.pod:6127 ../src/guestfs-actions.pod:9799 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:6122 ../src/guestfs-actions.pod:9794 +#: ../fish/guestfish-actions.pod:6130 ../src/guestfs-actions.pod:9802 msgid "C<maxmountcount>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6124 ../src/guestfs-actions.pod:9796 +#: ../fish/guestfish-actions.pod:6132 ../src/guestfs-actions.pod:9804 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. " @@ -20919,24 +20997,24 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:6128 ../src/guestfs-actions.pod:9800 +#: ../fish/guestfish-actions.pod:6136 ../src/guestfs-actions.pod:9808 msgid "C<mountcount>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6130 ../src/guestfs-actions.pod:9802 +#: ../fish/guestfish-actions.pod:6138 ../src/guestfs-actions.pod:9810 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:6133 ../src/guestfs-actions.pod:9805 +#: ../fish/guestfish-actions.pod:6141 ../src/guestfs-actions.pod:9813 msgid "C<errorbehavior>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6135 ../src/guestfs-actions.pod:9807 +#: ../fish/guestfish-actions.pod:6143 ../src/guestfs-actions.pod:9815 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 " @@ -20945,77 +21023,77 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6140 ../src/guestfs-actions.pod:9812 +#: ../fish/guestfish-actions.pod:6148 ../src/guestfs-actions.pod:9820 msgid "This is the same as the tune2fs C<-e> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:6142 ../src/guestfs-actions.pod:9814 +#: ../fish/guestfish-actions.pod:6150 ../src/guestfs-actions.pod:9822 msgid "C<group>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6144 ../src/guestfs-actions.pod:9816 +#: ../fish/guestfish-actions.pod:6152 ../src/guestfs-actions.pod:9824 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:6148 ../src/guestfs-actions.pod:9820 +#: ../fish/guestfish-actions.pod:6156 ../src/guestfs-actions.pod:9828 msgid "C<intervalbetweenchecks>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6150 ../src/guestfs-actions.pod:9822 +#: ../fish/guestfish-actions.pod:6158 ../src/guestfs-actions.pod:9830 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:6154 ../src/guestfs-actions.pod:9826 +#: ../fish/guestfish-actions.pod:6162 ../src/guestfs-actions.pod:9834 msgid "This is the same as the tune2fs C<-i> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:6156 ../src/guestfs-actions.pod:9828 +#: ../fish/guestfish-actions.pod:6164 ../src/guestfs-actions.pod:9836 msgid "C<reservedblockspercentage>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6158 ../src/guestfs-actions.pod:9830 +#: ../fish/guestfish-actions.pod:6166 ../src/guestfs-actions.pod:9838 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:6162 ../src/guestfs-actions.pod:9834 +#: ../fish/guestfish-actions.pod:6170 ../src/guestfs-actions.pod:9842 msgid "C<lastmounteddirectory>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6164 ../src/guestfs-actions.pod:9836 +#: ../fish/guestfish-actions.pod:6172 ../src/guestfs-actions.pod:9844 msgid "" "Set the last mounted directory. This is the same as the tune2fs C<-M> " "option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:6167 ../src/guestfs-actions.pod:9839 +#: ../fish/guestfish-actions.pod:6175 ../src/guestfs-actions.pod:9847 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:6171 ../src/guestfs-actions.pod:9843 +#: ../fish/guestfish-actions.pod:6179 ../src/guestfs-actions.pod:9851 msgid "C<user>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6173 ../src/guestfs-actions.pod:9845 +#: ../fish/guestfish-actions.pod:6181 ../src/guestfs-actions.pod:9853 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 " @@ -21023,19 +21101,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6179 +#: ../fish/guestfish-actions.pod:6187 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:6185 +#: ../fish/guestfish-actions.pod:6193 msgid "tune2fs-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6187 +#: ../fish/guestfish-actions.pod:6195 #, no-wrap msgid "" " tune2fs-l device\n" @@ -21043,14 +21121,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6189 ../src/guestfs-actions.pod:9887 +#: ../fish/guestfish-actions.pod:6197 ../src/guestfs-actions.pod:9895 msgid "" "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on " "C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6192 ../src/guestfs-actions.pod:9890 +#: ../fish/guestfish-actions.pod:6200 ../src/guestfs-actions.pod:9898 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 " @@ -21059,12 +21137,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6197 +#: ../fish/guestfish-actions.pod:6205 msgid "txz-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6199 +#: ../fish/guestfish-actions.pod:6207 #, no-wrap msgid "" " txz-in (tarball|-) directory\n" @@ -21072,19 +21150,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6201 ../src/guestfs-actions.pod:9917 +#: ../fish/guestfish-actions.pod:6209 ../src/guestfs-actions.pod:9925 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:6213 +#: ../fish/guestfish-actions.pod:6221 msgid "txz-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6215 +#: ../fish/guestfish-actions.pod:6223 #, no-wrap msgid "" " txz-out directory (tarball|-)\n" @@ -21092,19 +21170,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6217 ../src/guestfs-actions.pod:9938 +#: ../fish/guestfish-actions.pod:6225 ../src/guestfs-actions.pod:9946 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:6229 +#: ../fish/guestfish-actions.pod:6237 msgid "umask" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6231 +#: ../fish/guestfish-actions.pod:6239 #, no-wrap msgid "" " umask mask\n" @@ -21112,14 +21190,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6233 ../src/guestfs-actions.pod:9951 +#: ../fish/guestfish-actions.pod:6241 ../src/guestfs-actions.pod:9959 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:6236 ../src/guestfs-actions.pod:9954 +#: ../fish/guestfish-actions.pod:6244 ../src/guestfs-actions.pod:9962 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 " @@ -21127,7 +21205,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6241 ../src/guestfs-actions.pod:9959 +#: ../fish/guestfish-actions.pod:6249 ../src/guestfs-actions.pod:9967 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 " @@ -21135,32 +21213,32 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6245 +#: ../fish/guestfish-actions.pod:6253 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6248 ../src/guestfs-actions.pod:9966 +#: ../fish/guestfish-actions.pod:6256 ../src/guestfs-actions.pod:9974 msgid "This call returns the previous umask." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6250 +#: ../fish/guestfish-actions.pod:6258 msgid "umount" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6252 +#: ../fish/guestfish-actions.pod:6260 msgid "unmount" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6254 +#: ../fish/guestfish-actions.pod:6262 msgid "umount-opts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6256 +#: ../fish/guestfish-actions.pod:6264 #, no-wrap msgid "" " umount pathordevice [force:true|false] [lazyunmount:true|false]\n" @@ -21168,24 +21246,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6258 ../src/guestfs-actions.pod:10000 +#: ../fish/guestfish-actions.pod:6266 ../src/guestfs-actions.pod:10008 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:6264 +#: ../fish/guestfish-actions.pod:6272 msgid "umount-all" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6266 +#: ../fish/guestfish-actions.pod:6274 msgid "unmount-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6268 +#: ../fish/guestfish-actions.pod:6276 #, no-wrap msgid "" " umount-all\n" @@ -21193,22 +21271,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6270 ../src/guestfs-actions.pod:10035 +#: ../fish/guestfish-actions.pod:6278 ../src/guestfs-actions.pod:10043 msgid "This unmounts all mounted filesystems." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6272 ../src/guestfs-actions.pod:10037 +#: ../fish/guestfish-actions.pod:6280 ../src/guestfs-actions.pod:10045 msgid "Some internal mounts are not unmounted by this call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6274 +#: ../fish/guestfish-actions.pod:6282 msgid "umount-local" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6276 +#: ../fish/guestfish-actions.pod:6284 #, no-wrap msgid "" " umount-local [retry:true|false]\n" @@ -21216,19 +21294,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6278 ../src/guestfs-actions.pod:10056 +#: ../fish/guestfish-actions.pod:6286 ../src/guestfs-actions.pod:10064 msgid "" "If libguestfs is exporting the filesystem on a local mountpoint, then this " "unmounts it." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6285 +#: ../fish/guestfish-actions.pod:6293 msgid "upload" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6287 +#: ../fish/guestfish-actions.pod:6295 #, no-wrap msgid "" " upload (filename|-) remotefilename\n" @@ -21236,22 +21314,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6289 ../fish/guestfish-actions.pod:6302 ../src/guestfs-actions.pod:10092 ../src/guestfs-actions.pod:10116 +#: ../fish/guestfish-actions.pod:6297 ../fish/guestfish-actions.pod:6310 ../src/guestfs-actions.pod:10100 ../src/guestfs-actions.pod:10124 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6294 +#: ../fish/guestfish-actions.pod:6302 msgid "See also L</download>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6298 +#: ../fish/guestfish-actions.pod:6306 msgid "upload-offset" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6300 +#: ../fish/guestfish-actions.pod:6308 #, no-wrap msgid "" " upload-offset (filename|-) remotefilename offset\n" @@ -21259,7 +21337,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6305 ../src/guestfs-actions.pod:10119 +#: ../fish/guestfish-actions.pod:6313 ../src/guestfs-actions.pod:10127 msgid "" "C<remotefilename> is overwritten starting at the byte C<offset> specified. " "The intention is to overwrite parts of existing files or devices, although " @@ -21269,7 +21347,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6312 +#: ../fish/guestfish-actions.pod:6320 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 " @@ -21277,17 +21355,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6317 +#: ../fish/guestfish-actions.pod:6325 msgid "See also L</upload>, L</pwrite>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6321 +#: ../fish/guestfish-actions.pod:6329 msgid "utimens" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6323 +#: ../fish/guestfish-actions.pod:6331 #, no-wrap msgid "" " utimens path atsecs atnsecs mtsecs mtnsecs\n" @@ -21295,26 +21373,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6325 ../src/guestfs-actions.pod:10152 +#: ../fish/guestfish-actions.pod:6333 ../src/guestfs-actions.pod:10160 msgid "This command sets the timestamps of a file with nanosecond precision." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6328 ../src/guestfs-actions.pod:10155 +#: ../fish/guestfish-actions.pod:6336 ../src/guestfs-actions.pod:10163 msgid "" "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds " "from the epoch." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6331 ../src/guestfs-actions.pod:10158 +#: ../fish/guestfish-actions.pod:6339 ../src/guestfs-actions.pod:10166 msgid "" "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and " "nanoseconds from the epoch." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6334 ../src/guestfs-actions.pod:10161 +#: ../fish/guestfish-actions.pod:6342 ../src/guestfs-actions.pod:10169 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 " @@ -21322,7 +21400,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6338 ../src/guestfs-actions.pod:10165 +#: ../fish/guestfish-actions.pod:6346 ../src/guestfs-actions.pod:10173 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 " @@ -21330,12 +21408,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6342 +#: ../fish/guestfish-actions.pod:6350 msgid "utsname" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6344 +#: ../fish/guestfish-actions.pod:6352 #, no-wrap msgid "" " utsname\n" @@ -21343,7 +21421,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6346 ../src/guestfs-actions.pod:10178 +#: ../fish/guestfish-actions.pod:6354 ../src/guestfs-actions.pod:10186 msgid "" "This returns the kernel version of the appliance, where this is available. " "This information is only useful for debugging. Nothing in the returned " @@ -21351,12 +21429,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6350 +#: ../fish/guestfish-actions.pod:6358 msgid "version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6352 +#: ../fish/guestfish-actions.pod:6360 #, no-wrap msgid "" " version\n" @@ -21364,12 +21442,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6354 ../src/guestfs-actions.pod:10193 +#: ../fish/guestfish-actions.pod:6362 ../src/guestfs-actions.pod:10201 msgid "Return the libguestfs version number that the program is linked against." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6357 ../src/guestfs-actions.pod:10196 +#: ../fish/guestfish-actions.pod:6365 ../src/guestfs-actions.pod:10204 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 " @@ -21378,7 +21456,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6362 ../src/guestfs-actions.pod:10201 +#: ../fish/guestfish-actions.pod:6370 ../src/guestfs-actions.pod:10209 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 " @@ -21387,7 +21465,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6368 ../src/guestfs-actions.pod:10207 +#: ../fish/guestfish-actions.pod:6376 ../src/guestfs-actions.pod:10215 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 " @@ -21396,17 +21474,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6374 ../src/guestfs-actions.pod:10213 +#: ../fish/guestfish-actions.pod:6382 ../src/guestfs-actions.pod:10221 msgid "To construct the original version string: C<$major.$minor.$release$extra>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6377 ../src/guestfs-actions.pod:10216 +#: ../fish/guestfish-actions.pod:6385 ../src/guestfs-actions.pod:10224 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6379 +#: ../fish/guestfish-actions.pod:6387 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " @@ -21415,12 +21493,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6385 +#: ../fish/guestfish-actions.pod:6393 msgid "vfs-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6387 +#: ../fish/guestfish-actions.pod:6395 #, no-wrap msgid "" " vfs-label device\n" @@ -21428,27 +21506,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6389 ../src/guestfs-actions.pod:10236 +#: ../fish/guestfish-actions.pod:6397 ../src/guestfs-actions.pod:10244 msgid "This returns the filesystem label of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6392 ../src/guestfs-actions.pod:10239 +#: ../fish/guestfish-actions.pod:6400 ../src/guestfs-actions.pod:10247 msgid "If the filesystem is unlabeled, this returns the empty string." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6394 +#: ../fish/guestfish-actions.pod:6402 msgid "To find a filesystem from the label, use L</findfs-label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6396 +#: ../fish/guestfish-actions.pod:6404 msgid "vfs-type" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6398 +#: ../fish/guestfish-actions.pod:6406 #, no-wrap msgid "" " vfs-type device\n" @@ -21456,14 +21534,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6400 ../src/guestfs-actions.pod:10254 +#: ../fish/guestfish-actions.pod:6408 ../src/guestfs-actions.pod:10262 msgid "" "This command gets the filesystem type corresponding to the filesystem on " "C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6403 ../src/guestfs-actions.pod:10257 +#: ../fish/guestfish-actions.pod:6411 ../src/guestfs-actions.pod:10265 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 " @@ -21471,12 +21549,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6408 +#: ../fish/guestfish-actions.pod:6416 msgid "vfs-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6410 +#: ../fish/guestfish-actions.pod:6418 #, no-wrap msgid "" " vfs-uuid device\n" @@ -21484,27 +21562,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6412 ../src/guestfs-actions.pod:10273 +#: ../fish/guestfish-actions.pod:6420 ../src/guestfs-actions.pod:10281 msgid "This returns the filesystem UUID of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6415 ../src/guestfs-actions.pod:10276 +#: ../fish/guestfish-actions.pod:6423 ../src/guestfs-actions.pod:10284 msgid "If the filesystem does not have a UUID, this returns the empty string." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6417 +#: ../fish/guestfish-actions.pod:6425 msgid "To find a filesystem from the UUID, use L</findfs-uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6419 +#: ../fish/guestfish-actions.pod:6427 msgid "vg-activate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6421 +#: ../fish/guestfish-actions.pod:6429 #, no-wrap msgid "" " vg-activate true|false 'volgroups ...'\n" @@ -21512,31 +21590,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6423 ../src/guestfs-actions.pod:10292 +#: ../fish/guestfish-actions.pod:6431 ../src/guestfs-actions.pod:10300 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:6426 ../src/guestfs-actions.pod:10295 +#: ../fish/guestfish-actions.pod:6434 ../src/guestfs-actions.pod:10303 msgid "This command is the same as running C<vgchange -a y|n volgroups...>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6428 ../src/guestfs-actions.pod:10297 +#: ../fish/guestfish-actions.pod:6436 ../src/guestfs-actions.pod:10305 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:6431 +#: ../fish/guestfish-actions.pod:6439 msgid "vg-activate-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6433 +#: ../fish/guestfish-actions.pod:6441 #, no-wrap msgid "" " vg-activate-all true|false\n" @@ -21544,24 +21622,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6435 ../src/guestfs-actions.pod:10310 +#: ../fish/guestfish-actions.pod:6443 ../src/guestfs-actions.pod:10318 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:6438 ../src/guestfs-actions.pod:10313 +#: ../fish/guestfish-actions.pod:6446 ../src/guestfs-actions.pod:10321 msgid "This command is the same as running C<vgchange -a y|n>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6440 +#: ../fish/guestfish-actions.pod:6448 msgid "vgchange-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6442 +#: ../fish/guestfish-actions.pod:6450 #, no-wrap msgid "" " vgchange-uuid vg\n" @@ -21569,17 +21647,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6444 ../src/guestfs-actions.pod:10325 +#: ../fish/guestfish-actions.pod:6452 ../src/guestfs-actions.pod:10333 msgid "Generate a new random UUID for the volume group C<vg>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6446 +#: ../fish/guestfish-actions.pod:6454 msgid "vgchange-uuid-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6448 +#: ../fish/guestfish-actions.pod:6456 #, no-wrap msgid "" " vgchange-uuid-all\n" @@ -21587,17 +21665,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6450 ../src/guestfs-actions.pod:10336 +#: ../fish/guestfish-actions.pod:6458 ../src/guestfs-actions.pod:10344 msgid "Generate new random UUIDs for all volume groups." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6452 +#: ../fish/guestfish-actions.pod:6460 msgid "vgcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6454 +#: ../fish/guestfish-actions.pod:6462 #, no-wrap msgid "" " vgcreate volgroup 'physvols ...'\n" @@ -21605,19 +21683,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6456 ../src/guestfs-actions.pod:10349 +#: ../fish/guestfish-actions.pod:6464 ../src/guestfs-actions.pod:10357 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:6459 +#: ../fish/guestfish-actions.pod:6467 msgid "vglvuuids" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6461 +#: ../fish/guestfish-actions.pod:6469 #, no-wrap msgid "" " vglvuuids vgname\n" @@ -21625,31 +21703,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6463 ../src/guestfs-actions.pod:10362 +#: ../fish/guestfish-actions.pod:6471 ../src/guestfs-actions.pod:10370 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:6466 +#: ../fish/guestfish-actions.pod:6474 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:6469 +#: ../fish/guestfish-actions.pod:6477 msgid "See also L</vgpvuuids>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6471 +#: ../fish/guestfish-actions.pod:6479 msgid "vgmeta" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6473 +#: ../fish/guestfish-actions.pod:6481 #, no-wrap msgid "" " vgmeta vgname\n" @@ -21657,26 +21735,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6475 ../src/guestfs-actions.pod:10383 +#: ../fish/guestfish-actions.pod:6483 ../src/guestfs-actions.pod:10391 msgid "" "C<vgname> is an LVM volume group. This command examines the volume group " "and returns its metadata." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6478 ../src/guestfs-actions.pod:10386 +#: ../fish/guestfish-actions.pod:6486 ../src/guestfs-actions.pod:10394 msgid "" "Note that the metadata is an internal structure used by LVM, subject to " "change at any time, and is provided for information only." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6481 +#: ../fish/guestfish-actions.pod:6489 msgid "vgpvuuids" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6483 +#: ../fish/guestfish-actions.pod:6491 #, no-wrap msgid "" " vgpvuuids vgname\n" @@ -21684,31 +21762,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6485 ../src/guestfs-actions.pod:10401 +#: ../fish/guestfish-actions.pod:6493 ../src/guestfs-actions.pod:10409 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:6488 +#: ../fish/guestfish-actions.pod:6496 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:6491 +#: ../fish/guestfish-actions.pod:6499 msgid "See also L</vglvuuids>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6493 +#: ../fish/guestfish-actions.pod:6501 msgid "vgremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6495 +#: ../fish/guestfish-actions.pod:6503 #, no-wrap msgid "" " vgremove vgname\n" @@ -21716,22 +21794,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6497 ../src/guestfs-actions.pod:10421 +#: ../fish/guestfish-actions.pod:6505 ../src/guestfs-actions.pod:10429 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6499 ../src/guestfs-actions.pod:10423 +#: ../fish/guestfish-actions.pod:6507 ../src/guestfs-actions.pod:10431 msgid "This also forcibly removes all logical volumes in the volume group (if any)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6502 +#: ../fish/guestfish-actions.pod:6510 msgid "vgrename" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6504 +#: ../fish/guestfish-actions.pod:6512 #, no-wrap msgid "" " vgrename volgroup newvolgroup\n" @@ -21739,17 +21817,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6506 ../src/guestfs-actions.pod:10437 +#: ../fish/guestfish-actions.pod:6514 ../src/guestfs-actions.pod:10445 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6508 +#: ../fish/guestfish-actions.pod:6516 msgid "vgs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6510 +#: ../fish/guestfish-actions.pod:6518 #, no-wrap msgid "" " vgs\n" @@ -21757,31 +21835,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6512 ../src/guestfs-actions.pod:10448 +#: ../fish/guestfish-actions.pod:6520 ../src/guestfs-actions.pod:10456 msgid "" "List all the volumes groups detected. This is the equivalent of the " "L<vgs(8)> command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6515 ../src/guestfs-actions.pod:10451 +#: ../fish/guestfish-actions.pod:6523 ../src/guestfs-actions.pod:10459 msgid "" "This returns a list of just the volume group names that were detected " "(eg. C<VolGroup00>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6518 +#: ../fish/guestfish-actions.pod:6526 msgid "See also L</vgs-full>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6520 +#: ../fish/guestfish-actions.pod:6528 msgid "vgs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6522 +#: ../fish/guestfish-actions.pod:6530 #, no-wrap msgid "" " vgs-full\n" @@ -21789,19 +21867,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6524 ../src/guestfs-actions.pod:10467 +#: ../fish/guestfish-actions.pod:6532 ../src/guestfs-actions.pod:10475 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:6527 +#: ../fish/guestfish-actions.pod:6535 msgid "vgscan" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6529 +#: ../fish/guestfish-actions.pod:6537 #, no-wrap msgid "" " vgscan\n" @@ -21809,19 +21887,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6531 ../src/guestfs-actions.pod:10481 +#: ../fish/guestfish-actions.pod:6539 ../src/guestfs-actions.pod:10489 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:6534 +#: ../fish/guestfish-actions.pod:6542 msgid "vguuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6536 +#: ../fish/guestfish-actions.pod:6544 #, no-wrap msgid "" " vguuid vgname\n" @@ -21829,17 +21907,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6538 ../src/guestfs-actions.pod:10494 +#: ../fish/guestfish-actions.pod:6546 ../src/guestfs-actions.pod:10502 msgid "This command returns the UUID of the LVM VG named C<vgname>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6540 +#: ../fish/guestfish-actions.pod:6548 msgid "wc-c" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6542 +#: ../fish/guestfish-actions.pod:6550 #, no-wrap msgid "" " wc-c path\n" @@ -21847,19 +21925,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6544 ../src/guestfs-actions.pod:10534 +#: ../fish/guestfish-actions.pod:6552 ../src/guestfs-actions.pod:10542 msgid "" "This command counts the characters in a file, using the C<wc -c> external " "command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6547 +#: ../fish/guestfish-actions.pod:6555 msgid "wc-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6549 +#: ../fish/guestfish-actions.pod:6557 #, no-wrap msgid "" " wc-l path\n" @@ -21867,19 +21945,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6551 ../src/guestfs-actions.pod:10547 +#: ../fish/guestfish-actions.pod:6559 ../src/guestfs-actions.pod:10555 msgid "" "This command counts the lines in a file, using the C<wc -l> external " "command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6554 +#: ../fish/guestfish-actions.pod:6562 msgid "wc-w" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6556 +#: ../fish/guestfish-actions.pod:6564 #, no-wrap msgid "" " wc-w path\n" @@ -21887,19 +21965,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6558 ../src/guestfs-actions.pod:10560 +#: ../fish/guestfish-actions.pod:6566 ../src/guestfs-actions.pod:10568 msgid "" "This command counts the words in a file, using the C<wc -w> external " "command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6561 +#: ../fish/guestfish-actions.pod:6569 msgid "wipefs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6563 +#: ../fish/guestfish-actions.pod:6571 #, no-wrap msgid "" " wipefs device\n" @@ -21907,31 +21985,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6565 ../src/guestfs-actions.pod:10573 +#: ../fish/guestfish-actions.pod:6573 ../src/guestfs-actions.pod:10581 msgid "" "This command erases filesystem or RAID signatures from the specified " "C<device> to make the filesystem invisible to libblkid." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6568 ../src/guestfs-actions.pod:10576 +#: ../fish/guestfish-actions.pod:6576 ../src/guestfs-actions.pod:10584 msgid "" "This does not erase the filesystem itself nor any other data from the " "C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6571 +#: ../fish/guestfish-actions.pod:6579 msgid "Compare with L</zero> which zeroes the first few blocks of a device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6574 +#: ../fish/guestfish-actions.pod:6582 msgid "write" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6576 +#: ../fish/guestfish-actions.pod:6584 #, no-wrap msgid "" " write path content\n" @@ -21939,24 +22017,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6578 ../src/guestfs-actions.pod:10594 +#: ../fish/guestfish-actions.pod:6586 ../src/guestfs-actions.pod:10602 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:6581 +#: ../fish/guestfish-actions.pod:6589 msgid "See also L</write-append>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6583 +#: ../fish/guestfish-actions.pod:6591 msgid "write-append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6585 +#: ../fish/guestfish-actions.pod:6593 #, no-wrap msgid "" " write-append path content\n" @@ -21964,24 +22042,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6587 ../src/guestfs-actions.pod:10611 +#: ../fish/guestfish-actions.pod:6595 ../src/guestfs-actions.pod:10619 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:6590 +#: ../fish/guestfish-actions.pod:6598 msgid "See also L</write>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6592 +#: ../fish/guestfish-actions.pod:6600 msgid "write-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6594 +#: ../fish/guestfish-actions.pod:6602 #, no-wrap msgid "" " write-file path content size\n" @@ -21989,38 +22067,38 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6596 ../src/guestfs-actions.pod:10635 +#: ../fish/guestfish-actions.pod:6604 ../src/guestfs-actions.pod:10643 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:6600 ../src/guestfs-actions.pod:10639 +#: ../fish/guestfish-actions.pod:6608 ../src/guestfs-actions.pod:10647 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:6604 ../src/guestfs-actions.pod:10643 +#: ../fish/guestfish-actions.pod:6612 ../src/guestfs-actions.pod:10651 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:6610 +#: ../fish/guestfish-actions.pod:6618 msgid "I<This function is deprecated.> In new code, use the L</write> call instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6617 +#: ../fish/guestfish-actions.pod:6625 msgid "xfs-admin" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6619 +#: ../fish/guestfish-actions.pod:6627 #, no-wrap msgid "" " xfs-admin device [extunwritten:true|false] [imgfile:true|false] " @@ -22030,31 +22108,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6621 ../src/guestfs-actions.pod:10673 +#: ../fish/guestfish-actions.pod:6629 ../src/guestfs-actions.pod:10681 msgid "Change the parameters of the XFS filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6623 ../src/guestfs-actions.pod:10675 +#: ../fish/guestfish-actions.pod:6631 ../src/guestfs-actions.pod:10683 msgid "" "Devices that are mounted cannot be modified. Administrators must unmount " "filesystems before this call can modify parameters." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6627 +#: ../fish/guestfish-actions.pod:6635 msgid "" "Some of the parameters of a mounted filesystem can be examined and modified " "using the L</xfs-info> and L</xfs-growfs> calls." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6633 +#: ../fish/guestfish-actions.pod:6641 msgid "xfs-growfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6635 +#: ../fish/guestfish-actions.pod:6643 #, no-wrap msgid "" " xfs-growfs path [datasec:true|false] [logsec:true|false] [rtsec:true|false] " @@ -22063,24 +22141,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6637 ../src/guestfs-actions.pod:10728 +#: ../fish/guestfish-actions.pod:6645 ../src/guestfs-actions.pod:10736 msgid "Grow the XFS filesystem mounted at C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6639 ../fish/guestfish-actions.pod:6652 ../src/guestfs-actions.pod:10730 ../src/guestfs-actions.pod:10769 +#: ../fish/guestfish-actions.pod:6647 ../fish/guestfish-actions.pod:6660 ../src/guestfs-actions.pod:10738 ../src/guestfs-actions.pod:10777 msgid "" "The returned struct contains geometry information. Missing fields are " "returned as C<-1> (for numeric fields) or empty string." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6645 +#: ../fish/guestfish-actions.pod:6653 msgid "xfs-info" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6647 +#: ../fish/guestfish-actions.pod:6655 #, no-wrap msgid "" " xfs-info pathordevice\n" @@ -22088,19 +22166,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6649 ../src/guestfs-actions.pod:10766 +#: ../fish/guestfish-actions.pod:6657 ../src/guestfs-actions.pod:10774 msgid "" "C<pathordevice> is a mounted XFS filesystem or a device containing an XFS " "filesystem. This command returns the geometry of the filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6656 +#: ../fish/guestfish-actions.pod:6664 msgid "xfs-repair" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6658 +#: ../fish/guestfish-actions.pod:6666 #, no-wrap msgid "" " xfs-repair device [forcelogzero:true|false] [nomodify:true|false] " @@ -22110,12 +22188,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6660 ../src/guestfs-actions.pod:10802 +#: ../fish/guestfish-actions.pod:6668 ../src/guestfs-actions.pod:10810 msgid "Repair corrupt or damaged XFS filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6662 ../src/guestfs-actions.pod:10804 +#: ../fish/guestfish-actions.pod:6670 ../src/guestfs-actions.pod:10812 msgid "" "The filesystem is specified using the C<device> argument which should be the " "device name of the disk partition or volume containing the filesystem. If " @@ -22125,26 +22203,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6668 ../src/guestfs-actions.pod:10810 +#: ../fish/guestfish-actions.pod:6676 ../src/guestfs-actions.pod:10818 msgid "" "Regardless, the filesystem to be repaired must be unmounted, otherwise, the " "resulting filesystem may be inconsistent or corrupt." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6671 ../src/guestfs-actions.pod:10813 +#: ../fish/guestfish-actions.pod:6679 ../src/guestfs-actions.pod:10821 msgid "" "The returned status indicates whether filesystem corruption was detected " "(returns C<1>) or was not detected (returns C<0>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6676 +#: ../fish/guestfish-actions.pod:6684 msgid "zegrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6678 +#: ../fish/guestfish-actions.pod:6686 #, no-wrap msgid "" " zegrep regex path\n" @@ -22152,17 +22230,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6680 ../src/guestfs-actions.pod:10854 +#: ../fish/guestfish-actions.pod:6688 ../src/guestfs-actions.pod:10862 msgid "This calls the external C<zegrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6693 +#: ../fish/guestfish-actions.pod:6701 msgid "zegrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6695 +#: ../fish/guestfish-actions.pod:6703 #, no-wrap msgid "" " zegrepi regex path\n" @@ -22170,17 +22248,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6697 ../src/guestfs-actions.pod:10880 +#: ../fish/guestfish-actions.pod:6705 ../src/guestfs-actions.pod:10888 msgid "This calls the external C<zegrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6710 +#: ../fish/guestfish-actions.pod:6718 msgid "zero" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6712 +#: ../fish/guestfish-actions.pod:6720 #, no-wrap msgid "" " zero device\n" @@ -22188,12 +22266,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6714 ../src/guestfs-actions.pod:10898 +#: ../fish/guestfish-actions.pod:6722 ../src/guestfs-actions.pod:10906 msgid "This command writes zeroes over the first few blocks of C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6716 ../src/guestfs-actions.pod:10900 +#: ../fish/guestfish-actions.pod:6724 ../src/guestfs-actions.pod:10908 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 " @@ -22201,7 +22279,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6720 ../fish/guestfish-actions.pod:6735 ../src/guestfs-actions.pod:10904 ../src/guestfs-actions.pod:10930 +#: ../fish/guestfish-actions.pod:6728 ../fish/guestfish-actions.pod:6743 ../src/guestfs-actions.pod:10912 ../src/guestfs-actions.pod:10938 msgid "" "If blocks are already zero, then this command avoids writing zeroes. This " "prevents the underlying device from becoming non-sparse or growing " @@ -22209,17 +22287,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6724 +#: ../fish/guestfish-actions.pod:6732 msgid "See also: L</zero-device>, L</scrub-device>, L</is-zero-device>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6727 +#: ../fish/guestfish-actions.pod:6735 msgid "zero-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6729 +#: ../fish/guestfish-actions.pod:6737 #, no-wrap msgid "" " zero-device device\n" @@ -22227,19 +22305,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6731 +#: ../fish/guestfish-actions.pod:6739 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:6739 +#: ../fish/guestfish-actions.pod:6747 msgid "zero-free-space" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6741 +#: ../fish/guestfish-actions.pod:6749 #, no-wrap msgid "" " zero-free-space directory\n" @@ -22247,33 +22325,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6743 ../src/guestfs-actions.pod:10949 +#: ../fish/guestfish-actions.pod:6751 ../src/guestfs-actions.pod:10957 msgid "" "Zero the free space in the filesystem mounted on C<directory>. The " "filesystem must be mounted read-write." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6746 ../src/guestfs-actions.pod:10952 +#: ../fish/guestfish-actions.pod:6754 ../src/guestfs-actions.pod:10960 msgid "" "The filesystem contents are not affected, but any free space in the " "filesystem is freed." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6749 +#: ../fish/guestfish-actions.pod:6757 msgid "" "Free space is not \"trimmed\". You may want to call L</fstrim> either as an " "alternative to this, or after calling this, depending on your requirements." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6753 +#: ../fish/guestfish-actions.pod:6761 msgid "zerofree" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6755 +#: ../fish/guestfish-actions.pod:6763 #, no-wrap msgid "" " zerofree device\n" @@ -22281,7 +22359,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6757 ../src/guestfs-actions.pod:10974 +#: ../fish/guestfish-actions.pod:6765 ../src/guestfs-actions.pod:10982 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 " @@ -22289,24 +22367,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6762 ../src/guestfs-actions.pod:10979 +#: ../fish/guestfish-actions.pod:6770 ../src/guestfs-actions.pod:10987 msgid "You should B<not> run this program if the filesystem is mounted." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6765 ../src/guestfs-actions.pod:10982 +#: ../fish/guestfish-actions.pod:6773 ../src/guestfs-actions.pod:10990 msgid "" "It is possible that using this program can damage the filesystem or data on " "the filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6768 +#: ../fish/guestfish-actions.pod:6776 msgid "zfgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6770 +#: ../fish/guestfish-actions.pod:6778 #, no-wrap msgid "" " zfgrep pattern path\n" @@ -22314,17 +22392,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6772 ../src/guestfs-actions.pod:11003 +#: ../fish/guestfish-actions.pod:6780 ../src/guestfs-actions.pod:11011 msgid "This calls the external C<zfgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6785 +#: ../fish/guestfish-actions.pod:6793 msgid "zfgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6787 +#: ../fish/guestfish-actions.pod:6795 #, no-wrap msgid "" " zfgrepi pattern path\n" @@ -22332,17 +22410,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6789 ../src/guestfs-actions.pod:11029 +#: ../fish/guestfish-actions.pod:6797 ../src/guestfs-actions.pod:11037 msgid "This calls the external C<zfgrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6802 +#: ../fish/guestfish-actions.pod:6810 msgid "zfile" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6804 +#: ../fish/guestfish-actions.pod:6812 #, no-wrap msgid "" " zfile meth path\n" @@ -22350,32 +22428,32 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6806 ../src/guestfs-actions.pod:11055 +#: ../fish/guestfish-actions.pod:6814 ../src/guestfs-actions.pod:11063 msgid "This command runs C<file> after first decompressing C<path> using C<method>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6809 ../src/guestfs-actions.pod:11058 +#: ../fish/guestfish-actions.pod:6817 ../src/guestfs-actions.pod:11066 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6811 +#: ../fish/guestfish-actions.pod:6819 msgid "Since 1.0.63, use L</file> instead which can now process compressed files." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6814 +#: ../fish/guestfish-actions.pod:6822 msgid "I<This function is deprecated.> In new code, use the L</file> call instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6821 +#: ../fish/guestfish-actions.pod:6829 msgid "zgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6823 +#: ../fish/guestfish-actions.pod:6831 #, no-wrap msgid "" " zgrep regex path\n" @@ -22383,17 +22461,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6825 ../src/guestfs-actions.pod:11082 +#: ../fish/guestfish-actions.pod:6833 ../src/guestfs-actions.pod:11090 msgid "This calls the external C<zgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6838 +#: ../fish/guestfish-actions.pod:6846 msgid "zgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6840 +#: ../fish/guestfish-actions.pod:6848 #, no-wrap msgid "" " zgrepi regex path\n" @@ -22401,7 +22479,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6842 ../src/guestfs-actions.pod:11108 +#: ../fish/guestfish-actions.pod:6850 ../src/guestfs-actions.pod:11116 msgid "This calls the external C<zgrep -i> program and returns the matching lines." msgstr "" @@ -23380,7 +23458,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:135 ../src/guestfs.pod:2518 +#: ../fish/guestfish.pod:135 ../src/guestfs.pod:2522 #, no-wrap msgid "" " guestfish -N fs\n" @@ -24887,7 +24965,7 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:841 ../src/guestfs.pod:519 +#: ../fish/guestfish.pod:841 ../src/guestfs.pod:523 msgid "ENCRYPTED DISKS" msgstr "" @@ -25529,7 +25607,7 @@ msgid "COMMANDS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1128 ../src/guestfs.pod:1785 +#: ../fish/guestfish.pod:1128 ../src/guestfs.pod:1789 msgid "@ACTIONS@" msgstr "" @@ -25553,17 +25631,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1144 ../src/guestfs.pod:3517 +#: ../fish/guestfish.pod:1144 ../src/guestfs.pod:3521 msgid "FEBOOTSTRAP_KERNEL" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1146 ../src/guestfs.pod:3519 +#: ../fish/guestfish.pod:1146 ../src/guestfs.pod:3523 msgid "FEBOOTSTRAP_MODULES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1148 ../src/guestfs.pod:3521 +#: ../fish/guestfish.pod:1148 ../src/guestfs.pod:3525 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 " @@ -25621,17 +25699,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1176 ../src/guestfs.pod:3527 +#: ../fish/guestfish.pod:1176 ../src/guestfs.pod:3531 msgid "LIBGUESTFS_APPEND" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1178 ../src/guestfs.pod:3529 +#: ../fish/guestfish.pod:1178 ../src/guestfs.pod:3533 msgid "Pass additional options to the guest kernel." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1180 ../src/guestfs.pod:3531 +#: ../fish/guestfish.pod:1180 ../src/guestfs.pod:3535 msgid "LIBGUESTFS_ATTACH_METHOD" msgstr "" @@ -25643,7 +25721,7 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1185 ../src/guestfs.pod:3536 +#: ../fish/guestfish.pod:1185 ../src/guestfs.pod:3540 msgid "LIBGUESTFS_DEBUG" msgstr "" @@ -25655,17 +25733,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1190 ../src/guestfs.pod:3541 +#: ../fish/guestfish.pod:1190 ../src/guestfs.pod:3545 msgid "LIBGUESTFS_MEMSIZE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1192 ../src/guestfs.pod:3543 +#: ../fish/guestfish.pod:1192 ../src/guestfs.pod:3547 msgid "Set the memory allocated to the qemu process, in megabytes. For example:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1195 ../src/guestfs.pod:3546 +#: ../fish/guestfish.pod:1195 ../src/guestfs.pod:3550 #, no-wrap msgid "" " LIBGUESTFS_MEMSIZE=700\n" @@ -25673,7 +25751,7 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1197 ../src/guestfs.pod:3548 +#: ../fish/guestfish.pod:1197 ../src/guestfs.pod:3552 msgid "LIBGUESTFS_PATH" msgstr "" @@ -25685,19 +25763,19 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1202 ../src/guestfs.pod:3553 +#: ../fish/guestfish.pod:1202 ../src/guestfs.pod:3557 msgid "LIBGUESTFS_QEMU" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1204 ../src/guestfs.pod:3555 +#: ../fish/guestfish.pod:1204 ../src/guestfs.pod:3559 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:1208 ../src/guestfs.pod:3561 +#: ../fish/guestfish.pod:1208 ../src/guestfs.pod:3565 msgid "LIBGUESTFS_TRACE" msgstr "" @@ -25719,19 +25797,19 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1217 ../sparsify/virt-sparsify.pod:276 ../src/guestfs.pod:3566 +#: ../fish/guestfish.pod:1217 ../sparsify/virt-sparsify.pod:276 ../src/guestfs.pod:3570 msgid "TMPDIR" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1219 ../src/guestfs.pod:3568 +#: ../fish/guestfish.pod:1219 ../src/guestfs.pod:3572 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:1222 ../src/guestfs.pod:3571 +#: ../fish/guestfish.pod:1222 ../src/guestfs.pod:3575 msgid "" "If libguestfs was compiled to use the supermin appliance then the real " "appliance is cached in this directory, shared between all handles belonging " @@ -34515,12 +34593,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:19 ../src/guestfs-actions.pod:235 ../src/guestfs-actions.pod:272 ../src/guestfs-actions.pod:293 ../src/guestfs-actions.pod:314 ../src/guestfs-actions.pod:327 ../src/guestfs-actions.pod:341 ../src/guestfs-actions.pod:461 ../src/guestfs-actions.pod:481 ../src/guestfs-actions.pod:495 ../src/guestfs-actions.pod:540 ../src/guestfs-actions.pod:568 ../src/guestfs-actions.pod:586 ../src/guestfs-actions.pod:655 ../src/guestfs-actions.pod:688 ../src/guestfs-actions.pod:702 ../src/guestfs-actions.pod:758 ../src/guestfs-actions.pod:857 ../src/guestfs-actions.pod:875 ../src/guestfs-actions.pod:889 ../src/guestfs-actions.pod:903 ../src/guestfs-actions.pod:917 ../src/guestfs-actions.pod:931 ../src/guestfs-actions.pod:944 ../src/guestfs-actions.pod:981 ../src/guestfs-actions.pod:1015 ../src/guestfs-actions.pod:1037 ../src/guestfs-actions.pod:1073 ../src/guestfs-actions.pod:1086 ../src/guestfs-actions.pod:1098 ../src/guestfs-actions.pod:1128 ../src/guestfs-actions.pod:1143 ../src/guestfs-actions.pod:1336 ../src/guestfs-actions.pod:1356 ../src/guestfs-actions.pod:1374 ../src/guestfs-actions.pod:1464 ../src/guestfs-actions.pod:1523 ../src/guestfs-actions.pod:1569 ../src/guestfs-actions.pod:1609 ../src/guestfs-actions.pod:1662 ../src/guestfs-actions.pod:1715 ../src/guestfs-actions.pod:1773 ../src/guestfs-actions.pod:1827 ../src/guestfs-actions.pod:1846 ../src/guestfs-actions.pod:1860 ../src/guestfs-actions.pod:1888 ../src/guestfs-actions.pod:2022 ../src/guestfs-actions.pod:2053 ../src/guestfs-actions.pod:2078 ../src/guestfs-actions.pod:2144 ../src/guestfs-actions.pod:2187 ../src/guestfs-actions.pod:2314 ../src/guestfs-actions.pod:2341 ../src/guestfs-actions.pod:2593 ../src/guestfs-actions.pod:2614 ../src/guestfs-actions.pod:2631 ../src/guestfs-actions.pod:2708 ../src/guestfs-actions.pod:2819 ../src/guestfs-actions.pod:3500 ../src/guestfs-actions.pod:3572 ../src/guestfs-actions.pod:3589 ../src/guestfs-actions.pod:3628 ../src/guestfs-actions.pod:3699 ../src/guestfs-actions.pod:3737 ../src/guestfs-actions.pod:3914 ../src/guestfs-actions.pod:3973 ../src/guestfs-actions.pod:4008 ../src/guestfs-actions.pod:5121 ../src/guestfs-actions.pod:5136 ../src/guestfs-actions.pod:5161 ../src/guestfs-actions.pod:5379 ../src/guestfs-actions.pod:5393 ../src/guestfs-actions.pod:5406 ../src/guestfs-actions.pod:5420 ../src/guestfs-actions.pod:5435 ../src/guestfs-actions.pod:5470 ../src/guestfs-actions.pod:5487 ../src/guestfs-actions.pod:5556 ../src/guestfs-actions.pod:5576 ../src/guestfs-actions.pod:5593 ../src/guestfs-actions.pod:5613 ../src/guestfs-actions.pod:5633 ../src/guestfs-actions.pod:5668 ../src/guestfs-actions.pod:5687 ../src/guestfs-actions.pod:5706 ../src/guestfs-actions.pod:5723 ../src/guestfs-actions.pod:5758 ../src/guestfs-actions.pod:5770 ../src/guestfs-actions.pod:5803 ../src/guestfs-actions.pod:5819 ../src/guestfs-actions.pod:5832 ../src/guestfs-actions.pod:5847 ../src/guestfs-actions.pod:5864 ../src/guestfs-actions.pod:6037 ../src/guestfs-actions.pod:6173 ../src/guestfs-actions.pod:6185 ../src/guestfs-actions.pod:6205 ../src/guestfs-actions.pod:6218 ../src/guestfs-actions.pod:6269 ../src/guestfs-actions.pod:6287 ../src/guestfs-actions.pod:6305 ../src/guestfs-actions.pod:6321 ../src/guestfs-actions.pod:6335 ../src/guestfs-actions.pod:6349 ../src/guestfs-actions.pod:6366 ../src/guestfs-actions.pod:6443 ../src/guestfs-actions.pod:6494 ../src/guestfs-actions.pod:6527 ../src/guestfs-actions.pod:6598 ../src/guestfs-actions.pod:6629 ../src/guestfs-actions.pod:6648 ../src/guestfs-actions.pod:6667 ../src/guestfs-actions.pod:6704 ../src/guestfs-actions.pod:6748 ../src/guestfs-actions.pod:6768 ../src/guestfs-actions.pod:6783 ../src/guestfs-actions.pod:6798 ../src/guestfs-actions.pod:6830 ../src/guestfs-actions.pod:6856 ../src/guestfs-actions.pod:6925 ../src/guestfs-actions.pod:6974 ../src/guestfs-actions.pod:6989 ../src/guestfs-actions.pod:7009 ../src/guestfs-actions.pod:7023 ../src/guestfs-actions.pod:7040 ../src/guestfs-actions.pod:7089 ../src/guestfs-actions.pod:7143 ../src/guestfs-actions.pod:7181 ../src/guestfs-actions.pod:7233 ../src/guestfs-actions.pod:7315 ../src/guestfs-actions.pod:7358 ../src/guestfs-actions.pod:7386 ../src/guestfs-actions.pod:7403 ../src/guestfs-actions.pod:7421 ../src/guestfs-actions.pod:7558 ../src/guestfs-actions.pod:7615 ../src/guestfs-actions.pod:7637 ../src/guestfs-actions.pod:7655 ../src/guestfs-actions.pod:7707 ../src/guestfs-actions.pod:7771 ../src/guestfs-actions.pod:7782 ../src/guestfs-actions.pod:7796 ../src/guestfs-actions.pod:7813 ../src/guestfs-actions.pod:7826 ../src/guestfs-actions.pod:7840 ../src/guestfs-actions.pod:8123 ../src/guestfs-actions.pod:8138 ../src/guestfs-actions.pod:8159 ../src/guestfs-actions.pod:8175 ../src/guestfs-actions.pod:8187 ../src/guestfs-actions.pod:8206 ../src/guestfs-actions.pod:8218 ../src/guestfs-actions.pod:8230 ../src/guestfs-actions.pod:8244 ../src/guestfs-actions.pod:8287 ../src/guestfs-actions.pod:8349 ../src/guestfs-actions.pod:8411 ../src/guestfs-actions.pod:8451 ../src/guestfs-actions.pod:8469 ../src/guestfs-actions.pod:8488 ../src/guestfs-actions.pod:8507 ../src/guestfs-actions.pod:8570 ../src/guestfs-actions.pod:8588 ../src/guestfs-actions.pod:8611 ../src/guestfs-actions.pod:8650 ../src/guestfs-actions.pod:8689 ../src/guestfs-actions.pod:8714 ../src/guestfs-actions.pod:8733 ../src/guestfs-actions.pod:8755 ../src/guestfs-actions.pod:8776 ../src/guestfs-actions.pod:8795 ../src/guestfs-actions.pod:8812 ../src/guestfs-actions.pod:8833 ../src/guestfs-actions.pod:8861 ../src/guestfs-actions.pod:8885 ../src/guestfs-actions.pod:8904 ../src/guestfs-actions.pod:8920 ../src/guestfs-actions.pod:8944 ../src/guestfs-actions.pod:8963 ../src/guestfs-actions.pod:8978 ../src/guestfs-actions.pod:8997 ../src/guestfs-actions.pod:9041 ../src/guestfs-actions.pod:9068 ../src/guestfs-actions.pod:9098 ../src/guestfs-actions.pod:9223 ../src/guestfs-actions.pod:9235 ../src/guestfs-actions.pod:9356 ../src/guestfs-actions.pod:9368 ../src/guestfs-actions.pod:9381 ../src/guestfs-actions.pod:9394 ../src/guestfs-actions.pod:9416 ../src/guestfs-actions.pod:9429 ../src/guestfs-actions.pod:9442 ../src/guestfs-actions.pod:9455 ../src/guestfs-actions.pod:9470 ../src/guestfs-actions.pod:9554 ../src/guestfs-actions.pod:9639 ../src/guestfs-actions.pod:9684 ../src/guestfs-actions.pod:9705 ../src/guestfs-actions.pod:9722 ../src/guestfs-actions.pod:9735 ../src/guestfs-actions.pod:9755 ../src/guestfs-actions.pod:9855 ../src/guestfs-actions.pod:9920 ../src/guestfs-actions.pod:9941 ../src/guestfs-actions.pod:10004 ../src/guestfs-actions.pod:10039 ../src/guestfs-actions.pod:10061 ../src/guestfs-actions.pod:10099 ../src/guestfs-actions.pod:10133 ../src/guestfs-actions.pod:10169 ../src/guestfs-actions.pod:10300 ../src/guestfs-actions.pod:10315 ../src/guestfs-actions.pod:10327 ../src/guestfs-actions.pod:10338 ../src/guestfs-actions.pod:10352 ../src/guestfs-actions.pod:10426 ../src/guestfs-actions.pod:10439 ../src/guestfs-actions.pod:10484 ../src/guestfs-actions.pod:10524 ../src/guestfs-actions.pod:10582 ../src/guestfs-actions.pod:10599 ../src/guestfs-actions.pod:10616 ../src/guestfs-actions.pod:10646 ../src/guestfs-actions.pod:10683 ../src/guestfs-actions.pod:10734 ../src/guestfs-actions.pod:10911 ../src/guestfs-actions.pod:10934 ../src/guestfs-actions.pod:10959 ../src/guestfs-actions.pod:10985 +#: ../src/guestfs-actions.pod:19 ../src/guestfs-actions.pod:235 ../src/guestfs-actions.pod:272 ../src/guestfs-actions.pod:293 ../src/guestfs-actions.pod:314 ../src/guestfs-actions.pod:327 ../src/guestfs-actions.pod:341 ../src/guestfs-actions.pod:461 ../src/guestfs-actions.pod:481 ../src/guestfs-actions.pod:495 ../src/guestfs-actions.pod:540 ../src/guestfs-actions.pod:568 ../src/guestfs-actions.pod:586 ../src/guestfs-actions.pod:655 ../src/guestfs-actions.pod:688 ../src/guestfs-actions.pod:702 ../src/guestfs-actions.pod:758 ../src/guestfs-actions.pod:857 ../src/guestfs-actions.pod:875 ../src/guestfs-actions.pod:889 ../src/guestfs-actions.pod:903 ../src/guestfs-actions.pod:917 ../src/guestfs-actions.pod:931 ../src/guestfs-actions.pod:944 ../src/guestfs-actions.pod:981 ../src/guestfs-actions.pod:1015 ../src/guestfs-actions.pod:1037 ../src/guestfs-actions.pod:1073 ../src/guestfs-actions.pod:1086 ../src/guestfs-actions.pod:1098 ../src/guestfs-actions.pod:1128 ../src/guestfs-actions.pod:1143 ../src/guestfs-actions.pod:1336 ../src/guestfs-actions.pod:1356 ../src/guestfs-actions.pod:1374 ../src/guestfs-actions.pod:1464 ../src/guestfs-actions.pod:1523 ../src/guestfs-actions.pod:1569 ../src/guestfs-actions.pod:1609 ../src/guestfs-actions.pod:1662 ../src/guestfs-actions.pod:1715 ../src/guestfs-actions.pod:1773 ../src/guestfs-actions.pod:1827 ../src/guestfs-actions.pod:1846 ../src/guestfs-actions.pod:1860 ../src/guestfs-actions.pod:1888 ../src/guestfs-actions.pod:2022 ../src/guestfs-actions.pod:2053 ../src/guestfs-actions.pod:2078 ../src/guestfs-actions.pod:2144 ../src/guestfs-actions.pod:2187 ../src/guestfs-actions.pod:2314 ../src/guestfs-actions.pod:2341 ../src/guestfs-actions.pod:2593 ../src/guestfs-actions.pod:2614 ../src/guestfs-actions.pod:2631 ../src/guestfs-actions.pod:2708 ../src/guestfs-actions.pod:2819 ../src/guestfs-actions.pod:3500 ../src/guestfs-actions.pod:3572 ../src/guestfs-actions.pod:3589 ../src/guestfs-actions.pod:3628 ../src/guestfs-actions.pod:3699 ../src/guestfs-actions.pod:3737 ../src/guestfs-actions.pod:3914 ../src/guestfs-actions.pod:3973 ../src/guestfs-actions.pod:4008 ../src/guestfs-actions.pod:5129 ../src/guestfs-actions.pod:5144 ../src/guestfs-actions.pod:5169 ../src/guestfs-actions.pod:5387 ../src/guestfs-actions.pod:5401 ../src/guestfs-actions.pod:5414 ../src/guestfs-actions.pod:5428 ../src/guestfs-actions.pod:5443 ../src/guestfs-actions.pod:5478 ../src/guestfs-actions.pod:5495 ../src/guestfs-actions.pod:5564 ../src/guestfs-actions.pod:5584 ../src/guestfs-actions.pod:5601 ../src/guestfs-actions.pod:5621 ../src/guestfs-actions.pod:5641 ../src/guestfs-actions.pod:5676 ../src/guestfs-actions.pod:5695 ../src/guestfs-actions.pod:5714 ../src/guestfs-actions.pod:5731 ../src/guestfs-actions.pod:5766 ../src/guestfs-actions.pod:5778 ../src/guestfs-actions.pod:5811 ../src/guestfs-actions.pod:5827 ../src/guestfs-actions.pod:5840 ../src/guestfs-actions.pod:5855 ../src/guestfs-actions.pod:5872 ../src/guestfs-actions.pod:6045 ../src/guestfs-actions.pod:6181 ../src/guestfs-actions.pod:6193 ../src/guestfs-actions.pod:6213 ../src/guestfs-actions.pod:6226 ../src/guestfs-actions.pod:6277 ../src/guestfs-actions.pod:6295 ../src/guestfs-actions.pod:6313 ../src/guestfs-actions.pod:6329 ../src/guestfs-actions.pod:6343 ../src/guestfs-actions.pod:6357 ../src/guestfs-actions.pod:6374 ../src/guestfs-actions.pod:6451 ../src/guestfs-actions.pod:6502 ../src/guestfs-actions.pod:6535 ../src/guestfs-actions.pod:6606 ../src/guestfs-actions.pod:6637 ../src/guestfs-actions.pod:6656 ../src/guestfs-actions.pod:6675 ../src/guestfs-actions.pod:6712 ../src/guestfs-actions.pod:6756 ../src/guestfs-actions.pod:6776 ../src/guestfs-actions.pod:6791 ../src/guestfs-actions.pod:6806 ../src/guestfs-actions.pod:6838 ../src/guestfs-actions.pod:6864 ../src/guestfs-actions.pod:6933 ../src/guestfs-actions.pod:6982 ../src/guestfs-actions.pod:6997 ../src/guestfs-actions.pod:7017 ../src/guestfs-actions.pod:7031 ../src/guestfs-actions.pod:7048 ../src/guestfs-actions.pod:7097 ../src/guestfs-actions.pod:7151 ../src/guestfs-actions.pod:7189 ../src/guestfs-actions.pod:7241 ../src/guestfs-actions.pod:7323 ../src/guestfs-actions.pod:7366 ../src/guestfs-actions.pod:7394 ../src/guestfs-actions.pod:7411 ../src/guestfs-actions.pod:7429 ../src/guestfs-actions.pod:7566 ../src/guestfs-actions.pod:7623 ../src/guestfs-actions.pod:7645 ../src/guestfs-actions.pod:7663 ../src/guestfs-actions.pod:7715 ../src/guestfs-actions.pod:7779 ../src/guestfs-actions.pod:7790 ../src/guestfs-actions.pod:7804 ../src/guestfs-actions.pod:7821 ../src/guestfs-actions.pod:7834 ../src/guestfs-actions.pod:7848 ../src/guestfs-actions.pod:8131 ../src/guestfs-actions.pod:8146 ../src/guestfs-actions.pod:8167 ../src/guestfs-actions.pod:8183 ../src/guestfs-actions.pod:8195 ../src/guestfs-actions.pod:8214 ../src/guestfs-actions.pod:8226 ../src/guestfs-actions.pod:8238 ../src/guestfs-actions.pod:8252 ../src/guestfs-actions.pod:8295 ../src/guestfs-actions.pod:8357 ../src/guestfs-actions.pod:8419 ../src/guestfs-actions.pod:8459 ../src/guestfs-actions.pod:8477 ../src/guestfs-actions.pod:8496 ../src/guestfs-actions.pod:8515 ../src/guestfs-actions.pod:8578 ../src/guestfs-actions.pod:8596 ../src/guestfs-actions.pod:8619 ../src/guestfs-actions.pod:8658 ../src/guestfs-actions.pod:8697 ../src/guestfs-actions.pod:8722 ../src/guestfs-actions.pod:8741 ../src/guestfs-actions.pod:8763 ../src/guestfs-actions.pod:8784 ../src/guestfs-actions.pod:8803 ../src/guestfs-actions.pod:8820 ../src/guestfs-actions.pod:8841 ../src/guestfs-actions.pod:8869 ../src/guestfs-actions.pod:8893 ../src/guestfs-actions.pod:8912 ../src/guestfs-actions.pod:8928 ../src/guestfs-actions.pod:8952 ../src/guestfs-actions.pod:8971 ../src/guestfs-actions.pod:8986 ../src/guestfs-actions.pod:9005 ../src/guestfs-actions.pod:9049 ../src/guestfs-actions.pod:9076 ../src/guestfs-actions.pod:9106 ../src/guestfs-actions.pod:9231 ../src/guestfs-actions.pod:9243 ../src/guestfs-actions.pod:9364 ../src/guestfs-actions.pod:9376 ../src/guestfs-actions.pod:9389 ../src/guestfs-actions.pod:9402 ../src/guestfs-actions.pod:9424 ../src/guestfs-actions.pod:9437 ../src/guestfs-actions.pod:9450 ../src/guestfs-actions.pod:9463 ../src/guestfs-actions.pod:9478 ../src/guestfs-actions.pod:9562 ../src/guestfs-actions.pod:9647 ../src/guestfs-actions.pod:9692 ../src/guestfs-actions.pod:9713 ../src/guestfs-actions.pod:9730 ../src/guestfs-actions.pod:9743 ../src/guestfs-actions.pod:9763 ../src/guestfs-actions.pod:9863 ../src/guestfs-actions.pod:9928 ../src/guestfs-actions.pod:9949 ../src/guestfs-actions.pod:10012 ../src/guestfs-actions.pod:10047 ../src/guestfs-actions.pod:10069 ../src/guestfs-actions.pod:10107 ../src/guestfs-actions.pod:10141 ../src/guestfs-actions.pod:10177 ../src/guestfs-actions.pod:10308 ../src/guestfs-actions.pod:10323 ../src/guestfs-actions.pod:10335 ../src/guestfs-actions.pod:10346 ../src/guestfs-actions.pod:10360 ../src/guestfs-actions.pod:10434 ../src/guestfs-actions.pod:10447 ../src/guestfs-actions.pod:10492 ../src/guestfs-actions.pod:10532 ../src/guestfs-actions.pod:10590 ../src/guestfs-actions.pod:10607 ../src/guestfs-actions.pod:10624 ../src/guestfs-actions.pod:10654 ../src/guestfs-actions.pod:10691 ../src/guestfs-actions.pod:10742 ../src/guestfs-actions.pod:10919 ../src/guestfs-actions.pod:10942 ../src/guestfs-actions.pod:10967 ../src/guestfs-actions.pod:10993 msgid "This function returns 0 on success or -1 on error." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:21 ../src/guestfs-actions.pod:162 ../src/guestfs-actions.pod:1571 ../src/guestfs-actions.pod:2882 ../src/guestfs-actions.pod:3119 ../src/guestfs-actions.pod:3244 ../src/guestfs-actions.pod:5123 ../src/guestfs-actions.pod:5143 ../src/guestfs-actions.pod:6832 ../src/guestfs-actions.pod:8590 ../src/guestfs-actions.pod:8814 ../src/guestfs-actions.pod:8965 ../src/guestfs-actions.pod:9472 ../src/guestfs-actions.pod:9724 ../src/guestfs-actions.pod:10526 +#: ../src/guestfs-actions.pod:21 ../src/guestfs-actions.pod:162 ../src/guestfs-actions.pod:1571 ../src/guestfs-actions.pod:2882 ../src/guestfs-actions.pod:3119 ../src/guestfs-actions.pod:3244 ../src/guestfs-actions.pod:5131 ../src/guestfs-actions.pod:5151 ../src/guestfs-actions.pod:6840 ../src/guestfs-actions.pod:8598 ../src/guestfs-actions.pod:8822 ../src/guestfs-actions.pod:8973 ../src/guestfs-actions.pod:9480 ../src/guestfs-actions.pod:9732 ../src/guestfs-actions.pod:10534 msgid "(Added in 0.3)" msgstr "" @@ -34541,7 +34619,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:172 ../src/guestfs-actions.pod:955 ../src/guestfs-actions.pod:1026 ../src/guestfs-actions.pod:1451 ../src/guestfs-actions.pod:1503 ../src/guestfs-actions.pod:1581 ../src/guestfs-actions.pod:1650 ../src/guestfs-actions.pod:1703 ../src/guestfs-actions.pod:1756 ../src/guestfs-actions.pod:2114 ../src/guestfs-actions.pod:2792 ../src/guestfs-actions.pod:3360 ../src/guestfs-actions.pod:3722 ../src/guestfs-actions.pod:4277 ../src/guestfs-actions.pod:5972 ../src/guestfs-actions.pod:6392 ../src/guestfs-actions.pod:6505 ../src/guestfs-actions.pod:6691 ../src/guestfs-actions.pod:6842 ../src/guestfs-actions.pod:6891 ../src/guestfs-actions.pod:7155 ../src/guestfs-actions.pod:7216 ../src/guestfs-actions.pod:7279 ../src/guestfs-actions.pod:8256 ../src/guestfs-actions.pod:8323 ../src/guestfs-actions.pod:8385 ../src/guestfs-actions.pod:8623 ../src/guestfs-actions.pod:9538 ../src/guestfs-actions.pod:9604 ../src/guestfs-actions.pod:9766 ../src/guestfs-actions.pod:9992 ../src/guestfs-actions.pod:10049 ../src/guestfs-actions.pod:10660 ../src/guestfs-actions.pod:10714 ../src/guestfs-actions.pod:10786 +#: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:172 ../src/guestfs-actions.pod:955 ../src/guestfs-actions.pod:1026 ../src/guestfs-actions.pod:1451 ../src/guestfs-actions.pod:1503 ../src/guestfs-actions.pod:1581 ../src/guestfs-actions.pod:1650 ../src/guestfs-actions.pod:1703 ../src/guestfs-actions.pod:1756 ../src/guestfs-actions.pod:2114 ../src/guestfs-actions.pod:2792 ../src/guestfs-actions.pod:3360 ../src/guestfs-actions.pod:3722 ../src/guestfs-actions.pod:4285 ../src/guestfs-actions.pod:5980 ../src/guestfs-actions.pod:6400 ../src/guestfs-actions.pod:6513 ../src/guestfs-actions.pod:6699 ../src/guestfs-actions.pod:6850 ../src/guestfs-actions.pod:6899 ../src/guestfs-actions.pod:7163 ../src/guestfs-actions.pod:7224 ../src/guestfs-actions.pod:7287 ../src/guestfs-actions.pod:8264 ../src/guestfs-actions.pod:8331 ../src/guestfs-actions.pod:8393 ../src/guestfs-actions.pod:8631 ../src/guestfs-actions.pod:9546 ../src/guestfs-actions.pod:9612 ../src/guestfs-actions.pod:9774 ../src/guestfs-actions.pod:10000 ../src/guestfs-actions.pod:10057 ../src/guestfs-actions.pod:10668 ../src/guestfs-actions.pod:10722 ../src/guestfs-actions.pod:10794 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 " @@ -34578,7 +34656,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:126 ../src/guestfs-actions.pod:384 ../src/guestfs-actions.pod:554 ../src/guestfs-actions.pod:775 ../src/guestfs-actions.pod:806 ../src/guestfs-actions.pod:824 ../src/guestfs-actions.pod:843 ../src/guestfs-actions.pod:1906 ../src/guestfs-actions.pod:1987 ../src/guestfs-actions.pod:2098 ../src/guestfs-actions.pod:2549 ../src/guestfs-actions.pod:2781 ../src/guestfs-actions.pod:3030 ../src/guestfs-actions.pod:3091 ../src/guestfs-actions.pod:3142 ../src/guestfs-actions.pod:3194 ../src/guestfs-actions.pod:3208 ../src/guestfs-actions.pod:3231 ../src/guestfs-actions.pod:3602 ../src/guestfs-actions.pod:3642 ../src/guestfs-actions.pod:3657 ../src/guestfs-actions.pod:3682 ../src/guestfs-actions.pod:3770 ../src/guestfs-actions.pod:3795 ../src/guestfs-actions.pod:3901 ../src/guestfs-actions.pod:4395 ../src/guestfs-actions.pod:4413 ../src/guestfs-actions.pod:5960 ../src/guestfs-actions.pod:7105 ../src/guestfs-actions.pod:7128 ../src/guestfs-actions.pod:7455 ../src/guestfs-actions.pod:7693 ../src/guestfs-actions.pod:7910 ../src/guestfs-actions.pod:7936 ../src/guestfs-actions.pod:9968 ../src/guestfs-actions.pod:10537 ../src/guestfs-actions.pod:10550 ../src/guestfs-actions.pod:10563 ../src/guestfs-actions.pod:10816 +#: ../src/guestfs-actions.pod:126 ../src/guestfs-actions.pod:384 ../src/guestfs-actions.pod:554 ../src/guestfs-actions.pod:775 ../src/guestfs-actions.pod:806 ../src/guestfs-actions.pod:824 ../src/guestfs-actions.pod:843 ../src/guestfs-actions.pod:1906 ../src/guestfs-actions.pod:1987 ../src/guestfs-actions.pod:2098 ../src/guestfs-actions.pod:2549 ../src/guestfs-actions.pod:2781 ../src/guestfs-actions.pod:3030 ../src/guestfs-actions.pod:3091 ../src/guestfs-actions.pod:3142 ../src/guestfs-actions.pod:3194 ../src/guestfs-actions.pod:3208 ../src/guestfs-actions.pod:3231 ../src/guestfs-actions.pod:3602 ../src/guestfs-actions.pod:3642 ../src/guestfs-actions.pod:3657 ../src/guestfs-actions.pod:3682 ../src/guestfs-actions.pod:3770 ../src/guestfs-actions.pod:3795 ../src/guestfs-actions.pod:3901 ../src/guestfs-actions.pod:4403 ../src/guestfs-actions.pod:4421 ../src/guestfs-actions.pod:5968 ../src/guestfs-actions.pod:7113 ../src/guestfs-actions.pod:7136 ../src/guestfs-actions.pod:7463 ../src/guestfs-actions.pod:7701 ../src/guestfs-actions.pod:7918 ../src/guestfs-actions.pod:7944 ../src/guestfs-actions.pod:9976 ../src/guestfs-actions.pod:10545 ../src/guestfs-actions.pod:10558 ../src/guestfs-actions.pod:10571 ../src/guestfs-actions.pod:10824 msgid "On error this function returns -1." msgstr "" @@ -34609,7 +34687,7 @@ msgid "This is the \"va_list variant\" of L</guestfs_add_domain>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:139 ../src/guestfs-actions.pod:150 ../src/guestfs-actions.pod:248 ../src/guestfs-actions.pod:259 ../src/guestfs-actions.pod:994 ../src/guestfs-actions.pod:1005 ../src/guestfs-actions.pod:1050 ../src/guestfs-actions.pod:1061 ../src/guestfs-actions.pod:1479 ../src/guestfs-actions.pod:1492 ../src/guestfs-actions.pod:1538 ../src/guestfs-actions.pod:1551 ../src/guestfs-actions.pod:1628 ../src/guestfs-actions.pod:1640 ../src/guestfs-actions.pod:1681 ../src/guestfs-actions.pod:1693 ../src/guestfs-actions.pod:1734 ../src/guestfs-actions.pod:1746 ../src/guestfs-actions.pod:1792 ../src/guestfs-actions.pod:1804 ../src/guestfs-actions.pod:2157 ../src/guestfs-actions.pod:2168 ../src/guestfs-actions.pod:2832 ../src/guestfs-actions.pod:2843 ../src/guestfs-actions.pod:3417 ../src/guestfs-actions.pod:3429 ../src/guestfs-actions.pod:3748 ../src/guestfs-actions.pod:3759 ../src/guestfs-actions.pod:4361 ../src/guestfs-actions.pod:4373 ../src/guestfs-actions.pod:6051 ../src/guestfs-actions.pod:6063 ../src/guestfs-actions.pod:6457 ../src/guestfs-actions.pod:6469 ../src/guestfs-actions.pod:6540 ../src/guestfs-actions.pod:6551 ../src/guestfs-actions.pod:6715 ../src/guestfs-actions.pod:6726 ../src/guestfs-actions.pod:6870 ../src/guestfs-actions.pod:6882 ../src/guestfs-actions.pod:6938 ../src/guestfs-actions.pod:6949 ../src/guestfs-actions.pod:7195 ../src/guestfs-actions.pod:7207 ../src/guestfs-actions.pod:7246 ../src/guestfs-actions.pod:7257 ../src/guestfs-actions.pod:7328 ../src/guestfs-actions.pod:7339 ../src/guestfs-actions.pod:8301 ../src/guestfs-actions.pod:8313 ../src/guestfs-actions.pod:8363 ../src/guestfs-actions.pod:8375 ../src/guestfs-actions.pod:8425 ../src/guestfs-actions.pod:8437 ../src/guestfs-actions.pod:8664 ../src/guestfs-actions.pod:8676 ../src/guestfs-actions.pod:9568 ../src/guestfs-actions.pod:9580 ../src/guestfs-actions.pod:9653 ../src/guestfs-actions.pod:9665 ../src/guestfs-actions.pod:9868 ../src/guestfs-actions.pod:9879 ../src/guestfs-actions.pod:10017 ../src/guestfs-actions.pod:10028 ../src/guestfs-actions.pod:10073 ../src/guestfs-actions.pod:10083 ../src/guestfs-actions.pod:10694 ../src/guestfs-actions.pod:10705 ../src/guestfs-actions.pod:10747 ../src/guestfs-actions.pod:10758 ../src/guestfs-actions.pod:10827 ../src/guestfs-actions.pod:10838 +#: ../src/guestfs-actions.pod:139 ../src/guestfs-actions.pod:150 ../src/guestfs-actions.pod:248 ../src/guestfs-actions.pod:259 ../src/guestfs-actions.pod:994 ../src/guestfs-actions.pod:1005 ../src/guestfs-actions.pod:1050 ../src/guestfs-actions.pod:1061 ../src/guestfs-actions.pod:1479 ../src/guestfs-actions.pod:1492 ../src/guestfs-actions.pod:1538 ../src/guestfs-actions.pod:1551 ../src/guestfs-actions.pod:1628 ../src/guestfs-actions.pod:1640 ../src/guestfs-actions.pod:1681 ../src/guestfs-actions.pod:1693 ../src/guestfs-actions.pod:1734 ../src/guestfs-actions.pod:1746 ../src/guestfs-actions.pod:1792 ../src/guestfs-actions.pod:1804 ../src/guestfs-actions.pod:2157 ../src/guestfs-actions.pod:2168 ../src/guestfs-actions.pod:2832 ../src/guestfs-actions.pod:2843 ../src/guestfs-actions.pod:3417 ../src/guestfs-actions.pod:3429 ../src/guestfs-actions.pod:3748 ../src/guestfs-actions.pod:3759 ../src/guestfs-actions.pod:4369 ../src/guestfs-actions.pod:4381 ../src/guestfs-actions.pod:6059 ../src/guestfs-actions.pod:6071 ../src/guestfs-actions.pod:6465 ../src/guestfs-actions.pod:6477 ../src/guestfs-actions.pod:6548 ../src/guestfs-actions.pod:6559 ../src/guestfs-actions.pod:6723 ../src/guestfs-actions.pod:6734 ../src/guestfs-actions.pod:6878 ../src/guestfs-actions.pod:6890 ../src/guestfs-actions.pod:6946 ../src/guestfs-actions.pod:6957 ../src/guestfs-actions.pod:7203 ../src/guestfs-actions.pod:7215 ../src/guestfs-actions.pod:7254 ../src/guestfs-actions.pod:7265 ../src/guestfs-actions.pod:7336 ../src/guestfs-actions.pod:7347 ../src/guestfs-actions.pod:8309 ../src/guestfs-actions.pod:8321 ../src/guestfs-actions.pod:8371 ../src/guestfs-actions.pod:8383 ../src/guestfs-actions.pod:8433 ../src/guestfs-actions.pod:8445 ../src/guestfs-actions.pod:8672 ../src/guestfs-actions.pod:8684 ../src/guestfs-actions.pod:9576 ../src/guestfs-actions.pod:9588 ../src/guestfs-actions.pod:9661 ../src/guestfs-actions.pod:9673 ../src/guestfs-actions.pod:9876 ../src/guestfs-actions.pod:9887 ../src/guestfs-actions.pod:10025 ../src/guestfs-actions.pod:10036 ../src/guestfs-actions.pod:10081 ../src/guestfs-actions.pod:10091 ../src/guestfs-actions.pod:10702 ../src/guestfs-actions.pod:10713 ../src/guestfs-actions.pod:10755 ../src/guestfs-actions.pod:10766 ../src/guestfs-actions.pod:10835 ../src/guestfs-actions.pod:10846 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>." msgstr "" @@ -34869,7 +34947,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:343 ../src/guestfs-actions.pod:368 ../src/guestfs-actions.pod:386 ../src/guestfs-actions.pod:400 ../src/guestfs-actions.pod:463 ../src/guestfs-actions.pod:483 ../src/guestfs-actions.pod:497 ../src/guestfs-actions.pod:528 ../src/guestfs-actions.pod:542 ../src/guestfs-actions.pod:556 ../src/guestfs-actions.pod:570 ../src/guestfs-actions.pod:588 ../src/guestfs-actions.pod:7982 +#: ../src/guestfs-actions.pod:343 ../src/guestfs-actions.pod:368 ../src/guestfs-actions.pod:386 ../src/guestfs-actions.pod:400 ../src/guestfs-actions.pod:463 ../src/guestfs-actions.pod:483 ../src/guestfs-actions.pod:497 ../src/guestfs-actions.pod:528 ../src/guestfs-actions.pod:542 ../src/guestfs-actions.pod:556 ../src/guestfs-actions.pod:570 ../src/guestfs-actions.pod:588 ../src/guestfs-actions.pod:7990 msgid "(Added in 0.7)" msgstr "" @@ -34937,7 +35015,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:397 ../src/guestfs-actions.pod:1177 ../src/guestfs-actions.pod:1220 ../src/guestfs-actions.pod:1238 ../src/guestfs-actions.pod:1295 ../src/guestfs-actions.pod:1311 ../src/guestfs-actions.pod:1414 ../src/guestfs-actions.pod:1921 ../src/guestfs-actions.pod:1938 ../src/guestfs-actions.pod:1958 ../src/guestfs-actions.pod:2003 ../src/guestfs-actions.pod:2204 ../src/guestfs-actions.pod:2420 ../src/guestfs-actions.pod:2532 ../src/guestfs-actions.pod:2724 ../src/guestfs-actions.pod:2741 ../src/guestfs-actions.pod:2868 ../src/guestfs-actions.pod:3009 ../src/guestfs-actions.pod:3050 ../src/guestfs-actions.pod:3071 ../src/guestfs-actions.pod:3256 ../src/guestfs-actions.pod:3555 ../src/guestfs-actions.pod:3669 ../src/guestfs-actions.pod:3782 ../src/guestfs-actions.pod:3813 ../src/guestfs-actions.pod:4027 ../src/guestfs-actions.pod:4141 ../src/guestfs-actions.pod:4245 ../src/guestfs-actions.pod:4264 ../src/guestfs-actions.pod:4479 ../src/guestfs-actions.pod:4507 ../src/guestfs-actions.pod:4528 ../src/guestfs-actions.pod:4562 ../src/guestfs-actions.pod:4633 ../src/guestfs-actions.pod:4653 ../src/guestfs-actions.pod:4673 ../src/guestfs-actions.pod:5349 ../src/guestfs-actions.pod:5365 ../src/guestfs-actions.pod:5742 ../src/guestfs-actions.pod:5909 ../src/guestfs-actions.pod:6247 ../src/guestfs-actions.pod:7473 ../src/guestfs-actions.pod:7674 ../src/guestfs-actions.pod:7885 ../src/guestfs-actions.pod:8061 ../src/guestfs-actions.pod:8106 ../src/guestfs-actions.pod:9116 ../src/guestfs-actions.pod:9132 ../src/guestfs-actions.pod:9156 ../src/guestfs-actions.pod:9180 ../src/guestfs-actions.pod:10243 ../src/guestfs-actions.pod:10262 ../src/guestfs-actions.pod:10280 ../src/guestfs-actions.pod:10496 ../src/guestfs-actions.pod:11063 +#: ../src/guestfs-actions.pod:397 ../src/guestfs-actions.pod:1177 ../src/guestfs-actions.pod:1220 ../src/guestfs-actions.pod:1238 ../src/guestfs-actions.pod:1295 ../src/guestfs-actions.pod:1311 ../src/guestfs-actions.pod:1414 ../src/guestfs-actions.pod:1921 ../src/guestfs-actions.pod:1938 ../src/guestfs-actions.pod:1958 ../src/guestfs-actions.pod:2003 ../src/guestfs-actions.pod:2204 ../src/guestfs-actions.pod:2420 ../src/guestfs-actions.pod:2532 ../src/guestfs-actions.pod:2724 ../src/guestfs-actions.pod:2741 ../src/guestfs-actions.pod:2868 ../src/guestfs-actions.pod:3009 ../src/guestfs-actions.pod:3050 ../src/guestfs-actions.pod:3071 ../src/guestfs-actions.pod:3256 ../src/guestfs-actions.pod:3555 ../src/guestfs-actions.pod:3669 ../src/guestfs-actions.pod:3782 ../src/guestfs-actions.pod:3813 ../src/guestfs-actions.pod:4027 ../src/guestfs-actions.pod:4149 ../src/guestfs-actions.pod:4253 ../src/guestfs-actions.pod:4272 ../src/guestfs-actions.pod:4487 ../src/guestfs-actions.pod:4515 ../src/guestfs-actions.pod:4536 ../src/guestfs-actions.pod:4570 ../src/guestfs-actions.pod:4641 ../src/guestfs-actions.pod:4661 ../src/guestfs-actions.pod:4681 ../src/guestfs-actions.pod:5357 ../src/guestfs-actions.pod:5373 ../src/guestfs-actions.pod:5750 ../src/guestfs-actions.pod:5917 ../src/guestfs-actions.pod:6255 ../src/guestfs-actions.pod:7481 ../src/guestfs-actions.pod:7682 ../src/guestfs-actions.pod:7893 ../src/guestfs-actions.pod:8069 ../src/guestfs-actions.pod:8114 ../src/guestfs-actions.pod:9124 ../src/guestfs-actions.pod:9140 ../src/guestfs-actions.pod:9164 ../src/guestfs-actions.pod:9188 ../src/guestfs-actions.pod:10251 ../src/guestfs-actions.pod:10270 ../src/guestfs-actions.pod:10288 ../src/guestfs-actions.pod:10504 ../src/guestfs-actions.pod:11071 msgid "" "This function returns a string, or NULL on error. I<The caller must free " "the returned string after use>." @@ -35037,7 +35115,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:508 ../src/guestfs-actions.pod:524 ../src/guestfs-actions.pod:672 ../src/guestfs-actions.pod:1433 ../src/guestfs-actions.pod:2226 ../src/guestfs-actions.pod:2252 ../src/guestfs-actions.pod:2362 ../src/guestfs-actions.pod:2388 ../src/guestfs-actions.pod:2671 ../src/guestfs-actions.pod:3332 ../src/guestfs-actions.pod:3398 ../src/guestfs-actions.pod:3448 ../src/guestfs-actions.pod:3513 ../src/guestfs-actions.pod:3537 ../src/guestfs-actions.pod:3878 ../src/guestfs-actions.pod:3927 ../src/guestfs-actions.pod:4206 ../src/guestfs-actions.pod:4581 ../src/guestfs-actions.pod:4869 ../src/guestfs-actions.pod:5219 ../src/guestfs-actions.pod:5236 ../src/guestfs-actions.pod:5256 ../src/guestfs-actions.pod:5311 ../src/guestfs-actions.pod:5331 ../src/guestfs-actions.pod:5449 ../src/guestfs-actions.pod:5881 ../src/guestfs-actions.pod:7073 ../src/guestfs-actions.pod:7857 ../src/guestfs-actions.pod:7978 ../src/guestfs-actions.pod:8091 ../src/guestfs-actions.pod:9196 ../src/guestfs-actions.pod:9282 ../src/guestfs-actions.pod:9337 ../src/guestfs-actions.pod:9483 ../src/guestfs-actions.pod:9507 ../src/guestfs-actions.pod:10370 ../src/guestfs-actions.pod:10409 ../src/guestfs-actions.pod:10456 ../src/guestfs-actions.pod:10857 ../src/guestfs-actions.pod:10883 ../src/guestfs-actions.pod:11006 ../src/guestfs-actions.pod:11032 ../src/guestfs-actions.pod:11085 ../src/guestfs-actions.pod:11111 +#: ../src/guestfs-actions.pod:508 ../src/guestfs-actions.pod:524 ../src/guestfs-actions.pod:672 ../src/guestfs-actions.pod:1433 ../src/guestfs-actions.pod:2226 ../src/guestfs-actions.pod:2252 ../src/guestfs-actions.pod:2362 ../src/guestfs-actions.pod:2388 ../src/guestfs-actions.pod:2671 ../src/guestfs-actions.pod:3332 ../src/guestfs-actions.pod:3398 ../src/guestfs-actions.pod:3448 ../src/guestfs-actions.pod:3513 ../src/guestfs-actions.pod:3537 ../src/guestfs-actions.pod:3878 ../src/guestfs-actions.pod:3927 ../src/guestfs-actions.pod:4214 ../src/guestfs-actions.pod:4589 ../src/guestfs-actions.pod:4877 ../src/guestfs-actions.pod:5227 ../src/guestfs-actions.pod:5244 ../src/guestfs-actions.pod:5264 ../src/guestfs-actions.pod:5319 ../src/guestfs-actions.pod:5339 ../src/guestfs-actions.pod:5457 ../src/guestfs-actions.pod:5889 ../src/guestfs-actions.pod:7081 ../src/guestfs-actions.pod:7865 ../src/guestfs-actions.pod:7986 ../src/guestfs-actions.pod:8099 ../src/guestfs-actions.pod:9204 ../src/guestfs-actions.pod:9290 ../src/guestfs-actions.pod:9345 ../src/guestfs-actions.pod:9491 ../src/guestfs-actions.pod:9515 ../src/guestfs-actions.pod:10378 ../src/guestfs-actions.pod:10417 ../src/guestfs-actions.pod:10464 ../src/guestfs-actions.pod:10865 ../src/guestfs-actions.pod:10891 ../src/guestfs-actions.pod:11014 ../src/guestfs-actions.pod:11040 ../src/guestfs-actions.pod:11093 ../src/guestfs-actions.pod:11119 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 " @@ -35045,7 +35123,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:512 ../src/guestfs-actions.pod:1358 ../src/guestfs-actions.pod:1376 ../src/guestfs-actions.pod:2290 ../src/guestfs-actions.pod:4933 ../src/guestfs-actions.pod:4964 ../src/guestfs-actions.pod:5708 ../src/guestfs-actions.pod:5772 ../src/guestfs-actions.pod:6187 ../src/guestfs-actions.pod:6220 ../src/guestfs-actions.pod:6381 ../src/guestfs-actions.pod:7077 ../src/guestfs-actions.pod:7798 ../src/guestfs-actions.pod:8189 ../src/guestfs-actions.pod:8220 ../src/guestfs-actions.pod:8232 ../src/guestfs-actions.pod:9043 ../src/guestfs-actions.pod:9982 ../src/guestfs-actions.pod:10041 ../src/guestfs-actions.pod:10354 ../src/guestfs-actions.pod:10651 +#: ../src/guestfs-actions.pod:512 ../src/guestfs-actions.pod:1358 ../src/guestfs-actions.pod:1376 ../src/guestfs-actions.pod:2290 ../src/guestfs-actions.pod:4941 ../src/guestfs-actions.pod:4972 ../src/guestfs-actions.pod:5716 ../src/guestfs-actions.pod:5780 ../src/guestfs-actions.pod:6195 ../src/guestfs-actions.pod:6228 ../src/guestfs-actions.pod:6389 ../src/guestfs-actions.pod:7085 ../src/guestfs-actions.pod:7806 ../src/guestfs-actions.pod:8197 ../src/guestfs-actions.pod:8228 ../src/guestfs-actions.pod:8240 ../src/guestfs-actions.pod:9051 ../src/guestfs-actions.pod:9990 ../src/guestfs-actions.pod:10049 ../src/guestfs-actions.pod:10362 ../src/guestfs-actions.pod:10659 msgid "(Added in 0.8)" msgstr "" @@ -35272,7 +35350,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:739 ../src/guestfs-actions.pod:4181 ../src/guestfs-actions.pod:4449 ../src/guestfs-actions.pod:5296 ../src/guestfs-actions.pod:6099 ../src/guestfs-actions.pod:7053 ../src/guestfs-actions.pod:9895 +#: ../src/guestfs-actions.pod:739 ../src/guestfs-actions.pod:4189 ../src/guestfs-actions.pod:4457 ../src/guestfs-actions.pod:5304 ../src/guestfs-actions.pod:6107 ../src/guestfs-actions.pod:7061 ../src/guestfs-actions.pod:9903 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 " @@ -35336,7 +35414,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:790 ../src/guestfs-actions.pod:1973 ../src/guestfs-actions.pod:2273 ../src/guestfs-actions.pod:2288 ../src/guestfs-actions.pod:2572 ../src/guestfs-actions.pod:2880 ../src/guestfs-actions.pod:2891 ../src/guestfs-actions.pod:3102 ../src/guestfs-actions.pod:3128 ../src/guestfs-actions.pod:3168 ../src/guestfs-actions.pod:3183 ../src/guestfs-actions.pod:3219 ../src/guestfs-actions.pod:3242 ../src/guestfs-actions.pod:4690 ../src/guestfs-actions.pod:4706 ../src/guestfs-actions.pod:4724 ../src/guestfs-actions.pod:4886 ../src/guestfs-actions.pod:4901 ../src/guestfs-actions.pod:4915 ../src/guestfs-actions.pod:4931 ../src/guestfs-actions.pod:4946 ../src/guestfs-actions.pod:4962 ../src/guestfs-actions.pod:4976 ../src/guestfs-actions.pod:4989 ../src/guestfs-actions.pod:5003 ../src/guestfs-actions.pod:5018 ../src/guestfs-actions.pod:5033 ../src/guestfs-actions.pod:5046 ../src/guestfs-actions.pod:5060 ../src/guestfs-actions.pod:7437 +#: ../src/guestfs-actions.pod:790 ../src/guestfs-actions.pod:1973 ../src/guestfs-actions.pod:2273 ../src/guestfs-actions.pod:2288 ../src/guestfs-actions.pod:2572 ../src/guestfs-actions.pod:2880 ../src/guestfs-actions.pod:2891 ../src/guestfs-actions.pod:3102 ../src/guestfs-actions.pod:3128 ../src/guestfs-actions.pod:3168 ../src/guestfs-actions.pod:3183 ../src/guestfs-actions.pod:3219 ../src/guestfs-actions.pod:3242 ../src/guestfs-actions.pod:4698 ../src/guestfs-actions.pod:4714 ../src/guestfs-actions.pod:4732 ../src/guestfs-actions.pod:4894 ../src/guestfs-actions.pod:4909 ../src/guestfs-actions.pod:4923 ../src/guestfs-actions.pod:4939 ../src/guestfs-actions.pod:4954 ../src/guestfs-actions.pod:4970 ../src/guestfs-actions.pod:4984 ../src/guestfs-actions.pod:4997 ../src/guestfs-actions.pod:5011 ../src/guestfs-actions.pod:5026 ../src/guestfs-actions.pod:5041 ../src/guestfs-actions.pod:5054 ../src/guestfs-actions.pod:5068 ../src/guestfs-actions.pod:7445 msgid "This function returns a C truth value on success or -1 on error." msgstr "" @@ -35805,7 +35883,7 @@ msgid "Converted to C</dev/VG/LV> form using C<guestfs_lvm_canonical_lvm_name>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1180 ../src/guestfs-actions.pod:1908 ../src/guestfs-actions.pod:5962 +#: ../src/guestfs-actions.pod:1180 ../src/guestfs-actions.pod:1908 ../src/guestfs-actions.pod:5970 msgid "(Added in 1.19.7)" msgstr "" @@ -35838,7 +35916,7 @@ msgid "See also C<guestfs_realpath>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1223 ../src/guestfs-actions.pod:10265 +#: ../src/guestfs-actions.pod:1223 ../src/guestfs-actions.pod:10273 msgid "(Added in 1.0.75)" msgstr "" @@ -35867,7 +35945,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1241 ../src/guestfs-actions.pod:5240 ../src/guestfs-actions.pod:5335 ../src/guestfs-actions.pod:5352 ../src/guestfs-actions.pod:5453 ../src/guestfs-actions.pod:5885 ../src/guestfs-actions.pod:5899 ../src/guestfs-actions.pod:7861 ../src/guestfs-actions.pod:7875 ../src/guestfs-actions.pod:10460 ../src/guestfs-actions.pod:10474 +#: ../src/guestfs-actions.pod:1241 ../src/guestfs-actions.pod:5248 ../src/guestfs-actions.pod:5343 ../src/guestfs-actions.pod:5360 ../src/guestfs-actions.pod:5461 ../src/guestfs-actions.pod:5893 ../src/guestfs-actions.pod:5907 ../src/guestfs-actions.pod:7869 ../src/guestfs-actions.pod:7883 ../src/guestfs-actions.pod:10468 ../src/guestfs-actions.pod:10482 msgid "(Added in 0.4)" msgstr "" @@ -35898,7 +35976,7 @@ msgid "To get the checksums for many files, use C<guestfs_checksums_out>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1298 ../src/guestfs-actions.pod:2029 ../src/guestfs-actions.pod:3210 ../src/guestfs-actions.pod:4917 ../src/guestfs-actions.pod:4978 ../src/guestfs-actions.pod:5005 ../src/guestfs-actions.pod:10106 +#: ../src/guestfs-actions.pod:1298 ../src/guestfs-actions.pod:2029 ../src/guestfs-actions.pod:3210 ../src/guestfs-actions.pod:4925 ../src/guestfs-actions.pod:4986 ../src/guestfs-actions.pod:5013 ../src/guestfs-actions.pod:10114 msgid "(Added in 1.0.2)" msgstr "" @@ -35927,7 +36005,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1314 ../src/guestfs-actions.pod:7269 ../src/guestfs-actions.pod:7405 ../src/guestfs-actions.pod:7439 ../src/guestfs-actions.pod:7457 ../src/guestfs-actions.pod:7639 ../src/guestfs-actions.pod:9922 ../src/guestfs-actions.pod:9943 ../src/guestfs-actions.pod:10486 +#: ../src/guestfs-actions.pod:1314 ../src/guestfs-actions.pod:7277 ../src/guestfs-actions.pod:7413 ../src/guestfs-actions.pod:7447 ../src/guestfs-actions.pod:7465 ../src/guestfs-actions.pod:7647 ../src/guestfs-actions.pod:9930 ../src/guestfs-actions.pod:9951 ../src/guestfs-actions.pod:10494 msgid "(Added in 1.3.2)" msgstr "" @@ -36077,7 +36155,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1466 ../src/guestfs-actions.pod:1525 ../src/guestfs-actions.pod:3196 ../src/guestfs-actions.pod:8922 +#: ../src/guestfs-actions.pod:1466 ../src/guestfs-actions.pod:1525 ../src/guestfs-actions.pod:3196 ../src/guestfs-actions.pod:8930 msgid "(Added in 1.13.15)" msgstr "" @@ -36254,7 +36332,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1611 ../src/guestfs-actions.pod:1664 ../src/guestfs-actions.pod:1717 ../src/guestfs-actions.pod:1775 ../src/guestfs-actions.pod:1829 ../src/guestfs-actions.pod:2024 ../src/guestfs-actions.pod:2055 ../src/guestfs-actions.pod:2100 ../src/guestfs-actions.pod:2595 ../src/guestfs-actions.pod:2633 ../src/guestfs-actions.pod:5138 ../src/guestfs-actions.pod:10101 ../src/guestfs-actions.pod:10135 ../src/guestfs-actions.pod:10913 ../src/guestfs-actions.pod:10936 ../src/guestfs-actions.pod:10961 +#: ../src/guestfs-actions.pod:1611 ../src/guestfs-actions.pod:1664 ../src/guestfs-actions.pod:1717 ../src/guestfs-actions.pod:1775 ../src/guestfs-actions.pod:1829 ../src/guestfs-actions.pod:2024 ../src/guestfs-actions.pod:2055 ../src/guestfs-actions.pod:2100 ../src/guestfs-actions.pod:2595 ../src/guestfs-actions.pod:2633 ../src/guestfs-actions.pod:5146 ../src/guestfs-actions.pod:10109 ../src/guestfs-actions.pod:10143 ../src/guestfs-actions.pod:10921 ../src/guestfs-actions.pod:10944 ../src/guestfs-actions.pod:10969 msgid "" "This long-running command can generate progress notification messages so " "that the caller can display a progress bar or indicator. To receive these " @@ -36263,7 +36341,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1616 ../src/guestfs-actions.pod:1669 ../src/guestfs-actions.pod:1722 ../src/guestfs-actions.pod:1780 ../src/guestfs-actions.pod:7695 +#: ../src/guestfs-actions.pod:1616 ../src/guestfs-actions.pod:1669 ../src/guestfs-actions.pod:1722 ../src/guestfs-actions.pod:1780 ../src/guestfs-actions.pod:7703 msgid "(Added in 1.13.25)" msgstr "" @@ -36566,7 +36644,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1834 ../src/guestfs-actions.pod:5912 ../src/guestfs-actions.pod:7888 ../src/guestfs-actions.pod:10374 ../src/guestfs-actions.pod:10413 ../src/guestfs-actions.pod:10499 +#: ../src/guestfs-actions.pod:1834 ../src/guestfs-actions.pod:5920 ../src/guestfs-actions.pod:7896 ../src/guestfs-actions.pod:10382 ../src/guestfs-actions.pod:10421 ../src/guestfs-actions.pod:10507 msgid "(Added in 1.0.87)" msgstr "" @@ -36587,7 +36665,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1848 ../src/guestfs-actions.pod:1862 ../src/guestfs-actions.pod:2006 ../src/guestfs-actions.pod:2080 ../src/guestfs-actions.pod:2275 ../src/guestfs-actions.pod:7091 ../src/guestfs-actions.pod:7709 +#: ../src/guestfs-actions.pod:1848 ../src/guestfs-actions.pod:1862 ../src/guestfs-actions.pod:2006 ../src/guestfs-actions.pod:2080 ../src/guestfs-actions.pod:2275 ../src/guestfs-actions.pod:7099 ../src/guestfs-actions.pod:7717 msgid "(Added in 1.0.18)" msgstr "" @@ -36681,7 +36759,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1924 ../src/guestfs-actions.pod:1941 ../src/guestfs-actions.pod:2105 ../src/guestfs-actions.pod:3520 ../src/guestfs-actions.pod:3544 ../src/guestfs-actions.pod:3882 ../src/guestfs-actions.pod:6250 ../src/guestfs-actions.pod:6991 ../src/guestfs-actions.pod:9490 ../src/guestfs-actions.pod:9514 ../src/guestfs-actions.pod:10539 ../src/guestfs-actions.pod:10552 ../src/guestfs-actions.pod:10565 +#: ../src/guestfs-actions.pod:1924 ../src/guestfs-actions.pod:1941 ../src/guestfs-actions.pod:2105 ../src/guestfs-actions.pod:3520 ../src/guestfs-actions.pod:3544 ../src/guestfs-actions.pod:3882 ../src/guestfs-actions.pod:6258 ../src/guestfs-actions.pod:6999 ../src/guestfs-actions.pod:9498 ../src/guestfs-actions.pod:9522 ../src/guestfs-actions.pod:10547 ../src/guestfs-actions.pod:10560 ../src/guestfs-actions.pod:10573 msgid "(Added in 1.0.54)" msgstr "" @@ -36819,7 +36897,7 @@ msgid "See also C<guestfs_download>, C<guestfs_pread>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2060 ../src/guestfs-actions.pod:10140 +#: ../src/guestfs-actions.pod:2060 ../src/guestfs-actions.pod:10148 msgid "(Added in 1.5.17)" msgstr "" @@ -36973,7 +37051,7 @@ msgid "See also C<guestfs_ping_daemon>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2207 ../src/guestfs-actions.pod:3221 ../src/guestfs-actions.pod:8946 +#: ../src/guestfs-actions.pod:2207 ../src/guestfs-actions.pod:3221 ../src/guestfs-actions.pod:8954 msgid "(Added in 1.0.69)" msgstr "" @@ -36994,14 +37072,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2216 ../src/guestfs-actions.pod:2242 ../src/guestfs-actions.pod:2352 ../src/guestfs-actions.pod:2378 ../src/guestfs-actions.pod:3438 ../src/guestfs-actions.pod:10847 ../src/guestfs-actions.pod:10873 ../src/guestfs-actions.pod:10996 ../src/guestfs-actions.pod:11022 ../src/guestfs-actions.pod:11075 ../src/guestfs-actions.pod:11101 +#: ../src/guestfs-actions.pod:2216 ../src/guestfs-actions.pod:2242 ../src/guestfs-actions.pod:2352 ../src/guestfs-actions.pod:2378 ../src/guestfs-actions.pod:3438 ../src/guestfs-actions.pod:10855 ../src/guestfs-actions.pod:10881 ../src/guestfs-actions.pod:11004 ../src/guestfs-actions.pod:11030 ../src/guestfs-actions.pod:11083 ../src/guestfs-actions.pod:11109 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_grep> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2233 ../src/guestfs-actions.pod:2259 ../src/guestfs-actions.pod:2316 ../src/guestfs-actions.pod:2369 ../src/guestfs-actions.pod:2395 ../src/guestfs-actions.pod:3349 ../src/guestfs-actions.pod:3455 ../src/guestfs-actions.pod:3903 ../src/guestfs-actions.pod:3916 ../src/guestfs-actions.pod:3931 ../src/guestfs-actions.pod:3975 ../src/guestfs-actions.pod:3997 ../src/guestfs-actions.pod:4010 ../src/guestfs-actions.pod:5381 ../src/guestfs-actions.pod:5395 ../src/guestfs-actions.pod:5408 ../src/guestfs-actions.pod:5422 ../src/guestfs-actions.pod:6785 ../src/guestfs-actions.pod:8064 ../src/guestfs-actions.pod:8109 ../src/guestfs-actions.pod:9358 ../src/guestfs-actions.pod:9370 ../src/guestfs-actions.pod:9383 ../src/guestfs-actions.pod:9396 ../src/guestfs-actions.pod:9418 ../src/guestfs-actions.pod:9431 ../src/guestfs-actions.pod:9444 ../src/guestfs-actions.pod:9457 ../src/guestfs-actions.pod:10864 ../src/guestfs-actions.pod:10890 ../src/guestfs-actions.pod:11013 ../src/guestfs-actions.pod:11039 ../src/guestfs-actions.pod:11092 ../src/guestfs-actions.pod:11118 +#: ../src/guestfs-actions.pod:2233 ../src/guestfs-actions.pod:2259 ../src/guestfs-actions.pod:2316 ../src/guestfs-actions.pod:2369 ../src/guestfs-actions.pod:2395 ../src/guestfs-actions.pod:3349 ../src/guestfs-actions.pod:3455 ../src/guestfs-actions.pod:3903 ../src/guestfs-actions.pod:3916 ../src/guestfs-actions.pod:3931 ../src/guestfs-actions.pod:3975 ../src/guestfs-actions.pod:3997 ../src/guestfs-actions.pod:4010 ../src/guestfs-actions.pod:5389 ../src/guestfs-actions.pod:5403 ../src/guestfs-actions.pod:5416 ../src/guestfs-actions.pod:5430 ../src/guestfs-actions.pod:6793 ../src/guestfs-actions.pod:8072 ../src/guestfs-actions.pod:8117 ../src/guestfs-actions.pod:9366 ../src/guestfs-actions.pod:9378 ../src/guestfs-actions.pod:9391 ../src/guestfs-actions.pod:9404 ../src/guestfs-actions.pod:9426 ../src/guestfs-actions.pod:9439 ../src/guestfs-actions.pod:9452 ../src/guestfs-actions.pod:9465 ../src/guestfs-actions.pod:10872 ../src/guestfs-actions.pod:10898 ../src/guestfs-actions.pod:11021 ../src/guestfs-actions.pod:11047 ../src/guestfs-actions.pod:11100 ../src/guestfs-actions.pod:11126 msgid "(Added in 1.0.66)" msgstr "" @@ -37186,7 +37264,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2535 ../src/guestfs-actions.pod:2727 ../src/guestfs-actions.pod:2744 ../src/guestfs-actions.pod:4030 ../src/guestfs-actions.pod:4144 ../src/guestfs-actions.pod:4210 ../src/guestfs-actions.pod:4397 ../src/guestfs-actions.pod:4415 ../src/guestfs-actions.pod:4455 ../src/guestfs-actions.pod:4531 ../src/guestfs-actions.pod:4636 ../src/guestfs-actions.pod:4873 ../src/guestfs-actions.pod:4991 +#: ../src/guestfs-actions.pod:2535 ../src/guestfs-actions.pod:2727 ../src/guestfs-actions.pod:2744 ../src/guestfs-actions.pod:4030 ../src/guestfs-actions.pod:4152 ../src/guestfs-actions.pod:4218 ../src/guestfs-actions.pod:4405 ../src/guestfs-actions.pod:4423 ../src/guestfs-actions.pod:4463 ../src/guestfs-actions.pod:4539 ../src/guestfs-actions.pod:4644 ../src/guestfs-actions.pod:4881 ../src/guestfs-actions.pod:4999 msgid "(Added in 1.5.3)" msgstr "" @@ -37295,7 +37373,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2616 ../src/guestfs-actions.pod:5472 +#: ../src/guestfs-actions.pod:2616 ../src/guestfs-actions.pod:5480 msgid "(Added in 1.19.32)" msgstr "" @@ -37351,7 +37429,7 @@ msgid "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2675 ../src/guestfs-actions.pod:5849 ../src/guestfs-actions.pod:8140 +#: ../src/guestfs-actions.pod:2675 ../src/guestfs-actions.pod:5857 ../src/guestfs-actions.pod:8148 msgid "(Added in 1.0.27)" msgstr "" @@ -37440,7 +37518,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2783 ../src/guestfs-actions.pod:10918 +#: ../src/guestfs-actions.pod:2783 ../src/guestfs-actions.pod:10926 msgid "(Added in 1.0.16)" msgstr "" @@ -37549,7 +37627,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2859 ../src/guestfs-actions.pod:7828 ../src/guestfs-actions.pod:8509 ../src/guestfs-actions.pod:9100 ../src/guestfs-actions.pod:9119 ../src/guestfs-actions.pod:9135 ../src/guestfs-actions.pod:9159 ../src/guestfs-actions.pod:10302 ../src/guestfs-actions.pod:10317 ../src/guestfs-actions.pod:10987 +#: ../src/guestfs-actions.pod:2859 ../src/guestfs-actions.pod:7836 ../src/guestfs-actions.pod:8517 ../src/guestfs-actions.pod:9108 ../src/guestfs-actions.pod:9127 ../src/guestfs-actions.pod:9143 ../src/guestfs-actions.pod:9167 ../src/guestfs-actions.pod:10310 ../src/guestfs-actions.pod:10325 ../src/guestfs-actions.pod:10995 msgid "(Added in 1.0.26)" msgstr "" @@ -37573,7 +37651,7 @@ msgid "Return the current attach method. See C<guestfs_set_attach_method>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2871 ../src/guestfs-actions.pod:8572 +#: ../src/guestfs-actions.pod:2871 ../src/guestfs-actions.pod:8580 msgid "(Added in 1.9.8)" msgstr "" @@ -37606,7 +37684,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2893 ../src/guestfs-actions.pod:8613 +#: ../src/guestfs-actions.pod:2893 ../src/guestfs-actions.pod:8621 msgid "(Added in 1.0.72)" msgstr "" @@ -37638,7 +37716,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3012 ../src/guestfs-actions.pod:3032 ../src/guestfs-actions.pod:8652 ../src/guestfs-actions.pod:8691 +#: ../src/guestfs-actions.pod:3012 ../src/guestfs-actions.pod:3032 ../src/guestfs-actions.pod:8660 ../src/guestfs-actions.pod:8699 msgid "(Added in 1.17.31)" msgstr "" @@ -37685,7 +37763,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3053 ../src/guestfs-actions.pod:3074 ../src/guestfs-actions.pod:8716 ../src/guestfs-actions.pod:8735 +#: ../src/guestfs-actions.pod:3053 ../src/guestfs-actions.pod:3074 ../src/guestfs-actions.pod:8724 ../src/guestfs-actions.pod:8743 msgid "(Added in 1.0.15)" msgstr "" @@ -37734,7 +37812,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3093 ../src/guestfs-actions.pod:6368 ../src/guestfs-actions.pod:6631 ../src/guestfs-actions.pod:6650 ../src/guestfs-actions.pod:6669 ../src/guestfs-actions.pod:6681 ../src/guestfs-actions.pod:6750 ../src/guestfs-actions.pod:6770 ../src/guestfs-actions.pod:8051 ../src/guestfs-actions.pod:8778 ../src/guestfs-actions.pod:9070 ../src/guestfs-actions.pod:9970 +#: ../src/guestfs-actions.pod:3093 ../src/guestfs-actions.pod:6376 ../src/guestfs-actions.pod:6639 ../src/guestfs-actions.pod:6658 ../src/guestfs-actions.pod:6677 ../src/guestfs-actions.pod:6689 ../src/guestfs-actions.pod:6758 ../src/guestfs-actions.pod:6778 ../src/guestfs-actions.pod:8059 ../src/guestfs-actions.pod:8786 ../src/guestfs-actions.pod:9078 ../src/guestfs-actions.pod:9978 msgid "(Added in 1.0.55)" msgstr "" @@ -37753,7 +37831,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3104 ../src/guestfs-actions.pod:8797 +#: ../src/guestfs-actions.pod:3104 ../src/guestfs-actions.pod:8805 msgid "(Added in 1.5.4)" msgstr "" @@ -37793,7 +37871,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3130 ../src/guestfs-actions.pod:8835 ../src/guestfs-actions.pod:10618 +#: ../src/guestfs-actions.pod:3130 ../src/guestfs-actions.pod:8843 ../src/guestfs-actions.pod:10626 msgid "(Added in 1.11.18)" msgstr "" @@ -37831,7 +37909,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3159 ../src/guestfs-actions.pod:8863 +#: ../src/guestfs-actions.pod:3159 ../src/guestfs-actions.pod:8871 msgid "(Added in 1.0.6)" msgstr "" @@ -37850,7 +37928,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3170 ../src/guestfs-actions.pod:5163 ../src/guestfs-actions.pod:5536 ../src/guestfs-actions.pod:5944 ../src/guestfs-actions.pod:6207 ../src/guestfs-actions.pod:7735 ../src/guestfs-actions.pod:8095 ../src/guestfs-actions.pod:8887 ../src/guestfs-actions.pod:9737 ../src/guestfs-actions.pod:9757 ../src/guestfs-actions.pod:10171 +#: ../src/guestfs-actions.pod:3170 ../src/guestfs-actions.pod:5171 ../src/guestfs-actions.pod:5544 ../src/guestfs-actions.pod:5952 ../src/guestfs-actions.pod:6215 ../src/guestfs-actions.pod:7743 ../src/guestfs-actions.pod:8103 ../src/guestfs-actions.pod:8895 ../src/guestfs-actions.pod:9745 ../src/guestfs-actions.pod:9765 ../src/guestfs-actions.pod:10179 msgid "(Added in 1.0.77)" msgstr "" @@ -37876,7 +37954,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3185 ../src/guestfs-actions.pod:3259 ../src/guestfs-actions.pod:8906 ../src/guestfs-actions.pod:8980 +#: ../src/guestfs-actions.pod:3185 ../src/guestfs-actions.pod:3259 ../src/guestfs-actions.pod:8914 ../src/guestfs-actions.pod:8988 msgid "(Added in 1.0.67)" msgstr "" @@ -38002,7 +38080,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3273 ../src/guestfs-actions.pod:5177 +#: ../src/guestfs-actions.pod:3273 ../src/guestfs-actions.pod:5185 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 " @@ -38017,7 +38095,7 @@ msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3285 ../src/guestfs-actions.pod:3829 ../src/guestfs-actions.pod:3853 ../src/guestfs-actions.pod:4345 ../src/guestfs-actions.pod:5189 ../src/guestfs-actions.pod:7728 ../src/guestfs-actions.pod:7754 ../src/guestfs-actions.pod:7956 ../src/guestfs-actions.pod:10389 +#: ../src/guestfs-actions.pod:3285 ../src/guestfs-actions.pod:3829 ../src/guestfs-actions.pod:3853 ../src/guestfs-actions.pod:4353 ../src/guestfs-actions.pod:5197 ../src/guestfs-actions.pod:7736 ../src/guestfs-actions.pod:7762 ../src/guestfs-actions.pod:7964 ../src/guestfs-actions.pod:10397 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 " @@ -38025,7 +38103,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3289 ../src/guestfs-actions.pod:5193 +#: ../src/guestfs-actions.pod:3289 ../src/guestfs-actions.pod:5201 msgid "(Added in 1.7.24)" msgstr "" @@ -38050,14 +38128,14 @@ msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3305 ../src/guestfs-actions.pod:5205 ../src/guestfs-actions.pod:5940 +#: ../src/guestfs-actions.pod:3305 ../src/guestfs-actions.pod:5213 ../src/guestfs-actions.pod:5948 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:3309 ../src/guestfs-actions.pod:5209 ../src/guestfs-actions.pod:5437 ../src/guestfs-actions.pod:5489 ../src/guestfs-actions.pod:8125 ../src/guestfs-actions.pod:8999 ../src/guestfs-actions.pod:11066 +#: ../src/guestfs-actions.pod:3309 ../src/guestfs-actions.pod:5217 ../src/guestfs-actions.pod:5445 ../src/guestfs-actions.pod:5497 ../src/guestfs-actions.pod:8133 ../src/guestfs-actions.pod:9007 ../src/guestfs-actions.pod:11074 msgid "(Added in 1.0.59)" msgstr "" @@ -38085,7 +38163,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3336 ../src/guestfs-actions.pod:9183 ../src/guestfs-actions.pod:9200 +#: ../src/guestfs-actions.pod:3336 ../src/guestfs-actions.pod:9191 ../src/guestfs-actions.pod:9208 msgid "(Added in 1.0.50)" msgstr "" @@ -38142,7 +38220,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3405 ../src/guestfs-actions.pod:10736 +#: ../src/guestfs-actions.pod:3405 ../src/guestfs-actions.pod:10744 msgid "(Added in 1.19.28)" msgstr "" @@ -38274,7 +38352,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3561 ../src/guestfs-actions.pod:9289 ../src/guestfs-actions.pod:9344 +#: ../src/guestfs-actions.pod:3561 ../src/guestfs-actions.pod:9297 ../src/guestfs-actions.pod:9352 msgid "(Added in 1.0.22)" msgstr "" @@ -38844,12 +38922,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4146 +#: ../src/guestfs-actions.pod:4154 msgid "guestfs_inspect_get_drive_mappings" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4148 +#: ../src/guestfs-actions.pod:4156 #, no-wrap msgid "" " char **\n" @@ -38859,24 +38937,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4177 +#: ../src/guestfs-actions.pod:4185 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:4187 ../src/guestfs-actions.pod:4656 +#: ../src/guestfs-actions.pod:4195 ../src/guestfs-actions.pod:4664 msgid "(Added in 1.9.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4189 +#: ../src/guestfs-actions.pod:4197 msgid "guestfs_inspect_get_filesystems" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4191 +#: ../src/guestfs-actions.pod:4199 #, no-wrap msgid "" " char **\n" @@ -38886,19 +38964,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4203 +#: ../src/guestfs-actions.pod:4211 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_mountpoints>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4212 +#: ../src/guestfs-actions.pod:4220 msgid "guestfs_inspect_get_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4214 +#: ../src/guestfs-actions.pod:4222 #, no-wrap msgid "" " char *\n" @@ -38908,17 +38986,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4248 ../src/guestfs-actions.pod:4692 ../src/guestfs-actions.pod:4708 ../src/guestfs-actions.pod:4726 ../src/guestfs-actions.pod:8161 +#: ../src/guestfs-actions.pod:4256 ../src/guestfs-actions.pod:4700 ../src/guestfs-actions.pod:4716 ../src/guestfs-actions.pod:4734 ../src/guestfs-actions.pod:8169 msgid "(Added in 1.9.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4250 +#: ../src/guestfs-actions.pod:4258 msgid "guestfs_inspect_get_hostname" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4252 +#: ../src/guestfs-actions.pod:4260 #, no-wrap msgid "" " char *\n" @@ -38928,17 +39006,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4267 +#: ../src/guestfs-actions.pod:4275 msgid "(Added in 1.7.9)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4269 +#: ../src/guestfs-actions.pod:4277 msgid "guestfs_inspect_get_icon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4271 +#: ../src/guestfs-actions.pod:4279 #, no-wrap msgid "" " char *\n" @@ -38950,7 +39028,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4282 +#: ../src/guestfs-actions.pod:4290 #, no-wrap msgid "" " GUESTFS_INSPECT_GET_ICON_FAVICON, int favicon,\n" @@ -38959,17 +39037,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4349 ../src/guestfs-actions.pod:5223 ../src/guestfs-actions.pod:6858 +#: ../src/guestfs-actions.pod:4357 ../src/guestfs-actions.pod:5231 ../src/guestfs-actions.pod:6866 msgid "(Added in 1.11.12)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4351 +#: ../src/guestfs-actions.pod:4359 msgid "guestfs_inspect_get_icon_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4353 +#: ../src/guestfs-actions.pod:4361 #, no-wrap msgid "" " char *\n" @@ -38981,17 +39059,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4359 +#: ../src/guestfs-actions.pod:4367 msgid "This is the \"va_list variant\" of L</guestfs_inspect_get_icon>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4363 +#: ../src/guestfs-actions.pod:4371 msgid "guestfs_inspect_get_icon_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4365 +#: ../src/guestfs-actions.pod:4373 #, no-wrap msgid "" " char *\n" @@ -39004,17 +39082,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4371 +#: ../src/guestfs-actions.pod:4379 msgid "This is the \"argv variant\" of L</guestfs_inspect_get_icon>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4375 +#: ../src/guestfs-actions.pod:4383 msgid "guestfs_inspect_get_major_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4377 +#: ../src/guestfs-actions.pod:4385 #, no-wrap msgid "" " int\n" @@ -39024,12 +39102,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4399 +#: ../src/guestfs-actions.pod:4407 msgid "guestfs_inspect_get_minor_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4401 +#: ../src/guestfs-actions.pod:4409 #, no-wrap msgid "" " int\n" @@ -39039,19 +39117,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4410 +#: ../src/guestfs-actions.pod:4418 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:4417 +#: ../src/guestfs-actions.pod:4425 msgid "guestfs_inspect_get_mountpoints" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4419 +#: ../src/guestfs-actions.pod:4427 #, no-wrap msgid "" " char **\n" @@ -39061,7 +39139,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4440 +#: ../src/guestfs-actions.pod:4448 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 " @@ -39070,19 +39148,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4446 +#: ../src/guestfs-actions.pod:4454 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4457 +#: ../src/guestfs-actions.pod:4465 msgid "guestfs_inspect_get_package_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4459 +#: ../src/guestfs-actions.pod:4467 #, no-wrap msgid "" " char *\n" @@ -39092,7 +39170,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4463 +#: ../src/guestfs-actions.pod:4471 msgid "" "This function and C<guestfs_inspect_get_package_management> return the " "package format and package management tool used by the inspected operating " @@ -39101,17 +39179,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4482 ../src/guestfs-actions.pod:4510 +#: ../src/guestfs-actions.pod:4490 ../src/guestfs-actions.pod:4518 msgid "(Added in 1.7.5)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4484 +#: ../src/guestfs-actions.pod:4492 msgid "guestfs_inspect_get_package_management" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4486 +#: ../src/guestfs-actions.pod:4494 #, no-wrap msgid "" " char *\n" @@ -39121,7 +39199,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4490 +#: ../src/guestfs-actions.pod:4498 msgid "" "C<guestfs_inspect_get_package_format> and this function return the package " "format and package management tool used by the inspected operating system. " @@ -39130,12 +39208,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4512 +#: ../src/guestfs-actions.pod:4520 msgid "guestfs_inspect_get_product_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4514 +#: ../src/guestfs-actions.pod:4522 #, no-wrap msgid "" " char *\n" @@ -39145,12 +39223,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4533 +#: ../src/guestfs-actions.pod:4541 msgid "guestfs_inspect_get_product_variant" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4535 +#: ../src/guestfs-actions.pod:4543 #, no-wrap msgid "" " char *\n" @@ -39160,24 +39238,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4558 +#: ../src/guestfs-actions.pod:4566 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:4565 +#: ../src/guestfs-actions.pod:4573 msgid "(Added in 1.9.13)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4567 +#: ../src/guestfs-actions.pod:4575 msgid "guestfs_inspect_get_roots" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4569 +#: ../src/guestfs-actions.pod:4577 #, no-wrap msgid "" " char **\n" @@ -39186,7 +39264,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4572 +#: ../src/guestfs-actions.pod:4580 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 " @@ -39194,24 +39272,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4576 +#: ../src/guestfs-actions.pod:4584 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:4585 +#: ../src/guestfs-actions.pod:4593 msgid "(Added in 1.7.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4587 +#: ../src/guestfs-actions.pod:4595 msgid "guestfs_inspect_get_type" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4589 +#: ../src/guestfs-actions.pod:4597 #, no-wrap msgid "" " char *\n" @@ -39221,12 +39299,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4638 +#: ../src/guestfs-actions.pod:4646 msgid "guestfs_inspect_get_windows_current_control_set" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4640 +#: ../src/guestfs-actions.pod:4648 #, no-wrap msgid "" " char *\n" @@ -39236,12 +39314,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4658 +#: ../src/guestfs-actions.pod:4666 msgid "guestfs_inspect_get_windows_systemroot" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4660 +#: ../src/guestfs-actions.pod:4668 #, no-wrap msgid "" " char *\n" @@ -39251,17 +39329,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4676 +#: ../src/guestfs-actions.pod:4684 msgid "(Added in 1.5.25)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4678 +#: ../src/guestfs-actions.pod:4686 msgid "guestfs_inspect_is_live" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4680 +#: ../src/guestfs-actions.pod:4688 #, no-wrap msgid "" " int\n" @@ -39271,19 +39349,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4684 +#: ../src/guestfs-actions.pod:4692 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:4694 +#: ../src/guestfs-actions.pod:4702 msgid "guestfs_inspect_is_multipart" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4696 +#: ../src/guestfs-actions.pod:4704 #, no-wrap msgid "" " int\n" @@ -39293,19 +39371,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4700 +#: ../src/guestfs-actions.pod:4708 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:4710 +#: ../src/guestfs-actions.pod:4718 msgid "guestfs_inspect_is_netinst" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4712 +#: ../src/guestfs-actions.pod:4720 #, no-wrap msgid "" " int\n" @@ -39315,7 +39393,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4716 +#: ../src/guestfs-actions.pod:4724 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 " @@ -39324,12 +39402,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4728 +#: ../src/guestfs-actions.pod:4736 msgid "guestfs_inspect_list_applications" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4730 +#: ../src/guestfs-actions.pod:4738 #, no-wrap msgid "" " struct guestfs_application_list *\n" @@ -39339,7 +39417,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4736 +#: ../src/guestfs-actions.pod:4744 msgid "" "I<Note:> This call works differently from other parts of the inspection " "API. You have to call C<guestfs_inspect_os>, then " @@ -39352,7 +39430,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4826 +#: ../src/guestfs-actions.pod:4834 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> " @@ -39360,17 +39438,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4830 +#: ../src/guestfs-actions.pod:4838 msgid "(Added in 1.7.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4832 +#: ../src/guestfs-actions.pod:4840 msgid "guestfs_inspect_os" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4834 +#: ../src/guestfs-actions.pod:4842 #, no-wrap msgid "" " char **\n" @@ -39379,7 +39457,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4850 +#: ../src/guestfs-actions.pod:4858 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, " @@ -39387,7 +39465,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4855 +#: ../src/guestfs-actions.pod:4863 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 " @@ -39396,17 +39474,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4867 ../src/guestfs-actions.pod:5234 ../src/guestfs-actions.pod:5329 +#: ../src/guestfs-actions.pod:4875 ../src/guestfs-actions.pod:5242 ../src/guestfs-actions.pod:5337 msgid "See also C<guestfs_list_filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4875 +#: ../src/guestfs-actions.pod:4883 msgid "guestfs_is_blockdev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4877 +#: ../src/guestfs-actions.pod:4885 #, no-wrap msgid "" " int\n" @@ -39416,22 +39494,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4884 ../src/guestfs-actions.pod:4899 ../src/guestfs-actions.pod:4929 ../src/guestfs-actions.pod:4944 ../src/guestfs-actions.pod:4960 ../src/guestfs-actions.pod:5016 ../src/guestfs-actions.pod:5031 +#: ../src/guestfs-actions.pod:4892 ../src/guestfs-actions.pod:4907 ../src/guestfs-actions.pod:4937 ../src/guestfs-actions.pod:4952 ../src/guestfs-actions.pod:4968 ../src/guestfs-actions.pod:5024 ../src/guestfs-actions.pod:5039 msgid "See also C<guestfs_stat>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4888 ../src/guestfs-actions.pod:4903 ../src/guestfs-actions.pod:4948 ../src/guestfs-actions.pod:5020 ../src/guestfs-actions.pod:5035 +#: ../src/guestfs-actions.pod:4896 ../src/guestfs-actions.pod:4911 ../src/guestfs-actions.pod:4956 ../src/guestfs-actions.pod:5028 ../src/guestfs-actions.pod:5043 msgid "(Added in 1.5.10)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4890 +#: ../src/guestfs-actions.pod:4898 msgid "guestfs_is_chardev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4892 +#: ../src/guestfs-actions.pod:4900 #, no-wrap msgid "" " int\n" @@ -39441,12 +39519,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4905 +#: ../src/guestfs-actions.pod:4913 msgid "guestfs_is_config" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4907 +#: ../src/guestfs-actions.pod:4915 #, no-wrap msgid "" " int\n" @@ -39455,12 +39533,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4919 +#: ../src/guestfs-actions.pod:4927 msgid "guestfs_is_dir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4921 +#: ../src/guestfs-actions.pod:4929 #, no-wrap msgid "" " int\n" @@ -39470,12 +39548,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4935 +#: ../src/guestfs-actions.pod:4943 msgid "guestfs_is_fifo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4937 +#: ../src/guestfs-actions.pod:4945 #, no-wrap msgid "" " int\n" @@ -39485,12 +39563,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4950 +#: ../src/guestfs-actions.pod:4958 msgid "guestfs_is_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4952 +#: ../src/guestfs-actions.pod:4960 #, no-wrap msgid "" " int\n" @@ -39500,12 +39578,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4966 +#: ../src/guestfs-actions.pod:4974 msgid "guestfs_is_launching" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4968 +#: ../src/guestfs-actions.pod:4976 #, no-wrap msgid "" " int\n" @@ -39514,12 +39592,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4980 +#: ../src/guestfs-actions.pod:4988 msgid "guestfs_is_lv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4982 +#: ../src/guestfs-actions.pod:4990 #, no-wrap msgid "" " int\n" @@ -39529,12 +39607,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4993 +#: ../src/guestfs-actions.pod:5001 msgid "guestfs_is_ready" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4995 +#: ../src/guestfs-actions.pod:5003 #, no-wrap msgid "" " int\n" @@ -39543,12 +39621,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5007 +#: ../src/guestfs-actions.pod:5015 msgid "guestfs_is_socket" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5009 +#: ../src/guestfs-actions.pod:5017 #, no-wrap msgid "" " int\n" @@ -39558,12 +39636,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5022 +#: ../src/guestfs-actions.pod:5030 msgid "guestfs_is_symlink" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5024 +#: ../src/guestfs-actions.pod:5032 #, no-wrap msgid "" " int\n" @@ -39573,12 +39651,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5037 +#: ../src/guestfs-actions.pod:5045 msgid "guestfs_is_zero" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5039 +#: ../src/guestfs-actions.pod:5047 #, no-wrap msgid "" " int\n" @@ -39588,17 +39666,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5048 ../src/guestfs-actions.pod:5062 +#: ../src/guestfs-actions.pod:5056 ../src/guestfs-actions.pod:5070 msgid "(Added in 1.11.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5050 +#: ../src/guestfs-actions.pod:5058 msgid "guestfs_is_zero_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5052 +#: ../src/guestfs-actions.pod:5060 #, no-wrap msgid "" " int\n" @@ -39608,12 +39686,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5064 ../src/guestfs-structs.pod:268 +#: ../src/guestfs-actions.pod:5072 ../src/guestfs-structs.pod:268 msgid "guestfs_isoinfo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5066 +#: ../src/guestfs-actions.pod:5074 #, no-wrap msgid "" " struct guestfs_isoinfo *\n" @@ -39623,7 +39701,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5070 +#: ../src/guestfs-actions.pod:5078 msgid "" "This is the same as C<guestfs_isoinfo_device> except that it works for an " "ISO file located inside some other mounted filesystem. Note that in the " @@ -39632,24 +39710,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5076 ../src/guestfs-actions.pod:5099 +#: ../src/guestfs-actions.pod:5084 ../src/guestfs-actions.pod:5107 msgid "" "This function returns a C<struct guestfs_isoinfo *>, or NULL if there was an " "error. I<The caller must call C<guestfs_free_isoinfo> after use>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5080 ../src/guestfs-actions.pod:5103 +#: ../src/guestfs-actions.pod:5088 ../src/guestfs-actions.pod:5111 msgid "(Added in 1.17.19)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5082 +#: ../src/guestfs-actions.pod:5090 msgid "guestfs_isoinfo_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5084 +#: ../src/guestfs-actions.pod:5092 #, no-wrap msgid "" " struct guestfs_isoinfo *\n" @@ -39659,12 +39737,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5105 +#: ../src/guestfs-actions.pod:5113 msgid "guestfs_kill_subprocess" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5107 +#: ../src/guestfs-actions.pod:5115 #, no-wrap msgid "" " int\n" @@ -39673,24 +39751,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5110 +#: ../src/guestfs-actions.pod:5118 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_shutdown> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5119 +#: ../src/guestfs-actions.pod:5127 msgid "Do not call this. See: C<guestfs_shutdown> instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5125 +#: ../src/guestfs-actions.pod:5133 msgid "guestfs_launch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5127 +#: ../src/guestfs-actions.pod:5135 #, no-wrap msgid "" " int\n" @@ -39699,12 +39777,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5145 +#: ../src/guestfs-actions.pod:5153 msgid "guestfs_lchown" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5147 +#: ../src/guestfs-actions.pod:5155 #, no-wrap msgid "" " int\n" @@ -39716,7 +39794,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5153 +#: ../src/guestfs-actions.pod:5161 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 " @@ -39724,12 +39802,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5165 +#: ../src/guestfs-actions.pod:5173 msgid "guestfs_lgetxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5167 +#: ../src/guestfs-actions.pod:5175 #, no-wrap msgid "" " char *\n" @@ -39741,17 +39819,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5187 +#: ../src/guestfs-actions.pod:5195 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5195 +#: ../src/guestfs-actions.pod:5203 msgid "guestfs_lgetxattrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5197 +#: ../src/guestfs-actions.pod:5205 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -39761,19 +39839,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5201 +#: ../src/guestfs-actions.pod:5209 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:5211 +#: ../src/guestfs-actions.pod:5219 msgid "guestfs_list_9p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5213 +#: ../src/guestfs-actions.pod:5221 #, no-wrap msgid "" " char **\n" @@ -39782,12 +39860,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5225 +#: ../src/guestfs-actions.pod:5233 msgid "guestfs_list_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5227 +#: ../src/guestfs-actions.pod:5235 #, no-wrap msgid "" " char **\n" @@ -39796,12 +39874,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5242 +#: ../src/guestfs-actions.pod:5250 msgid "guestfs_list_dm_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5244 +#: ../src/guestfs-actions.pod:5252 #, no-wrap msgid "" " char **\n" @@ -39810,14 +39888,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5249 +#: ../src/guestfs-actions.pod:5257 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:5252 +#: ../src/guestfs-actions.pod:5260 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 " @@ -39825,17 +39903,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5260 ../src/guestfs-actions.pod:7317 +#: ../src/guestfs-actions.pod:5268 ../src/guestfs-actions.pod:7325 msgid "(Added in 1.11.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5262 +#: ../src/guestfs-actions.pod:5270 msgid "guestfs_list_filesystems" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5264 +#: ../src/guestfs-actions.pod:5272 #, no-wrap msgid "" " char **\n" @@ -39844,7 +39922,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5284 +#: ../src/guestfs-actions.pod:5292 msgid "" "This command runs other libguestfs commands, which might include " "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this " @@ -39852,7 +39930,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5288 +#: ../src/guestfs-actions.pod:5296 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 " @@ -39863,17 +39941,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5302 ../src/guestfs-actions.pod:7677 +#: ../src/guestfs-actions.pod:5310 ../src/guestfs-actions.pod:7685 msgid "(Added in 1.5.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5304 +#: ../src/guestfs-actions.pod:5312 msgid "guestfs_list_md_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5306 +#: ../src/guestfs-actions.pod:5314 #, no-wrap msgid "" " char **\n" @@ -39882,17 +39960,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5315 ../src/guestfs-actions.pod:9857 +#: ../src/guestfs-actions.pod:5323 ../src/guestfs-actions.pod:9865 msgid "(Added in 1.15.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5317 +#: ../src/guestfs-actions.pod:5325 msgid "guestfs_list_partitions" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5319 +#: ../src/guestfs-actions.pod:5327 #, no-wrap msgid "" " char **\n" @@ -39901,19 +39979,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5326 +#: ../src/guestfs-actions.pod:5334 msgid "" "This does not return logical volumes. For that you will need to call " "C<guestfs_lvs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5337 +#: ../src/guestfs-actions.pod:5345 msgid "guestfs_ll" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5339 +#: ../src/guestfs-actions.pod:5347 #, no-wrap msgid "" " char *\n" @@ -39923,12 +40001,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5354 +#: ../src/guestfs-actions.pod:5362 msgid "guestfs_llz" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5356 +#: ../src/guestfs-actions.pod:5364 #, no-wrap msgid "" " char *\n" @@ -39938,17 +40016,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5368 ../src/guestfs-actions.pod:10584 +#: ../src/guestfs-actions.pod:5376 ../src/guestfs-actions.pod:10592 msgid "(Added in 1.17.6)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5370 +#: ../src/guestfs-actions.pod:5378 msgid "guestfs_ln" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5372 +#: ../src/guestfs-actions.pod:5380 #, no-wrap msgid "" " int\n" @@ -39959,12 +40037,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5383 +#: ../src/guestfs-actions.pod:5391 msgid "guestfs_ln_f" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5385 +#: ../src/guestfs-actions.pod:5393 #, no-wrap msgid "" " int\n" @@ -39975,12 +40053,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5397 +#: ../src/guestfs-actions.pod:5405 msgid "guestfs_ln_s" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5399 +#: ../src/guestfs-actions.pod:5407 #, no-wrap msgid "" " int\n" @@ -39991,12 +40069,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5410 +#: ../src/guestfs-actions.pod:5418 msgid "guestfs_ln_sf" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5412 +#: ../src/guestfs-actions.pod:5420 #, no-wrap msgid "" " int\n" @@ -40007,12 +40085,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5424 +#: ../src/guestfs-actions.pod:5432 msgid "guestfs_lremovexattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5426 +#: ../src/guestfs-actions.pod:5434 #, no-wrap msgid "" " int\n" @@ -40023,19 +40101,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5431 +#: ../src/guestfs-actions.pod:5439 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:5439 +#: ../src/guestfs-actions.pod:5447 msgid "guestfs_ls" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5441 +#: ../src/guestfs-actions.pod:5449 #, no-wrap msgid "" " char **\n" @@ -40045,12 +40123,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5455 +#: ../src/guestfs-actions.pod:5463 msgid "guestfs_ls0" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5457 +#: ../src/guestfs-actions.pod:5465 #, no-wrap msgid "" " int\n" @@ -40061,12 +40139,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5474 +#: ../src/guestfs-actions.pod:5482 msgid "guestfs_lsetxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5476 +#: ../src/guestfs-actions.pod:5484 #, no-wrap msgid "" " int\n" @@ -40079,19 +40157,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5483 +#: ../src/guestfs-actions.pod:5491 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:5491 +#: ../src/guestfs-actions.pod:5499 msgid "guestfs_lstat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5493 +#: ../src/guestfs-actions.pod:5501 #, no-wrap msgid "" " struct guestfs_stat *\n" @@ -40101,31 +40179,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5499 +#: ../src/guestfs-actions.pod:5507 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:5505 ../src/guestfs-actions.pod:9249 +#: ../src/guestfs-actions.pod:5513 ../src/guestfs-actions.pod:9257 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:5509 ../src/guestfs-actions.pod:9253 ../src/guestfs-actions.pod:9271 ../src/guestfs-actions.pod:9901 +#: ../src/guestfs-actions.pod:5517 ../src/guestfs-actions.pod:9261 ../src/guestfs-actions.pod:9279 ../src/guestfs-actions.pod:9909 msgid "(Added in 0.9.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5511 +#: ../src/guestfs-actions.pod:5519 msgid "guestfs_lstatlist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5513 +#: ../src/guestfs-actions.pod:5521 #, no-wrap msgid "" " struct guestfs_stat_list *\n" @@ -40136,7 +40214,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5518 +#: ../src/guestfs-actions.pod:5526 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 " @@ -40144,7 +40222,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5527 +#: ../src/guestfs-actions.pod:5535 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> " @@ -40152,19 +40230,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5532 +#: ../src/guestfs-actions.pod:5540 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:5538 +#: ../src/guestfs-actions.pod:5546 msgid "guestfs_luks_add_key" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5540 +#: ../src/guestfs-actions.pod:5548 #, no-wrap msgid "" " int\n" @@ -40177,14 +40255,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5552 +#: ../src/guestfs-actions.pod:5560 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:5558 ../src/guestfs-actions.pod:5595 ../src/guestfs-actions.pod:5615 ../src/guestfs-actions.pod:5635 ../src/guestfs-actions.pod:5670 ../src/guestfs-actions.pod:5689 +#: ../src/guestfs-actions.pod:5566 ../src/guestfs-actions.pod:5603 ../src/guestfs-actions.pod:5623 ../src/guestfs-actions.pod:5643 ../src/guestfs-actions.pod:5678 ../src/guestfs-actions.pod:5697 msgid "" "This function takes a key or passphrase parameter which could contain " "sensitive material. Read the section L</KEYS AND PASSPHRASES> for more " @@ -40192,17 +40270,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5562 ../src/guestfs-actions.pod:5599 ../src/guestfs-actions.pod:5619 ../src/guestfs-actions.pod:5639 +#: ../src/guestfs-actions.pod:5570 ../src/guestfs-actions.pod:5607 ../src/guestfs-actions.pod:5627 ../src/guestfs-actions.pod:5647 msgid "(Added in 1.5.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5564 +#: ../src/guestfs-actions.pod:5572 msgid "guestfs_luks_close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5566 +#: ../src/guestfs-actions.pod:5574 #, no-wrap msgid "" " int\n" @@ -40212,7 +40290,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5570 +#: ../src/guestfs-actions.pod:5578 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 " @@ -40221,17 +40299,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5578 ../src/guestfs-actions.pod:5674 ../src/guestfs-actions.pod:5693 ../src/guestfs-actions.pod:5760 ../src/guestfs-actions.pod:5805 +#: ../src/guestfs-actions.pod:5586 ../src/guestfs-actions.pod:5682 ../src/guestfs-actions.pod:5701 ../src/guestfs-actions.pod:5768 ../src/guestfs-actions.pod:5813 msgid "(Added in 1.5.1)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5580 +#: ../src/guestfs-actions.pod:5588 msgid "guestfs_luks_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5582 +#: ../src/guestfs-actions.pod:5590 #, no-wrap msgid "" " int\n" @@ -40243,12 +40321,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5601 +#: ../src/guestfs-actions.pod:5609 msgid "guestfs_luks_format_cipher" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5603 +#: ../src/guestfs-actions.pod:5611 #, no-wrap msgid "" " int\n" @@ -40261,19 +40339,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5610 +#: ../src/guestfs-actions.pod:5618 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:5621 +#: ../src/guestfs-actions.pod:5629 msgid "guestfs_luks_kill_slot" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5623 +#: ../src/guestfs-actions.pod:5631 #, no-wrap msgid "" " int\n" @@ -40285,12 +40363,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5641 +#: ../src/guestfs-actions.pod:5649 msgid "guestfs_luks_open" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5643 +#: ../src/guestfs-actions.pod:5651 #, no-wrap msgid "" " int\n" @@ -40302,7 +40380,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5661 +#: ../src/guestfs-actions.pod:5669 msgid "" "If this block device contains LVM volume groups, then calling " "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them " @@ -40310,17 +40388,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5665 +#: ../src/guestfs-actions.pod:5673 msgid "Use C<guestfs_list_dm_devices> to list all device mapper devices." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5676 +#: ../src/guestfs-actions.pod:5684 msgid "guestfs_luks_open_ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5678 +#: ../src/guestfs-actions.pod:5686 #, no-wrap msgid "" " int\n" @@ -40332,19 +40410,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5684 +#: ../src/guestfs-actions.pod:5692 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:5695 +#: ../src/guestfs-actions.pod:5703 msgid "guestfs_lvcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5697 +#: ../src/guestfs-actions.pod:5705 #, no-wrap msgid "" " int\n" @@ -40356,12 +40434,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5710 +#: ../src/guestfs-actions.pod:5718 msgid "guestfs_lvcreate_free" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5712 +#: ../src/guestfs-actions.pod:5720 #, no-wrap msgid "" " int\n" @@ -40373,17 +40451,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5725 ../src/guestfs-actions.pod:10966 +#: ../src/guestfs-actions.pod:5733 ../src/guestfs-actions.pod:10974 msgid "(Added in 1.17.18)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5727 +#: ../src/guestfs-actions.pod:5735 msgid "guestfs_lvm_canonical_lv_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5729 +#: ../src/guestfs-actions.pod:5737 #, no-wrap msgid "" " char *\n" @@ -40393,22 +40471,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5740 +#: ../src/guestfs-actions.pod:5748 msgid "See also C<guestfs_is_lv>, C<guestfs_canonical_device_name>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5745 +#: ../src/guestfs-actions.pod:5753 msgid "(Added in 1.5.24)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5747 +#: ../src/guestfs-actions.pod:5755 msgid "guestfs_lvm_clear_filter" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5749 +#: ../src/guestfs-actions.pod:5757 #, no-wrap msgid "" " int\n" @@ -40417,19 +40495,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5752 +#: ../src/guestfs-actions.pod:5760 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:5762 +#: ../src/guestfs-actions.pod:5770 msgid "guestfs_lvm_remove_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5764 +#: ../src/guestfs-actions.pod:5772 #, no-wrap msgid "" " int\n" @@ -40438,12 +40516,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5774 +#: ../src/guestfs-actions.pod:5782 msgid "guestfs_lvm_set_filter" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5776 +#: ../src/guestfs-actions.pod:5784 #, no-wrap msgid "" " int\n" @@ -40453,12 +40531,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5807 +#: ../src/guestfs-actions.pod:5815 msgid "guestfs_lvremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5809 +#: ../src/guestfs-actions.pod:5817 #, no-wrap msgid "" " int\n" @@ -40468,17 +40546,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5821 ../src/guestfs-actions.pod:7815 ../src/guestfs-actions.pod:10428 +#: ../src/guestfs-actions.pod:5829 ../src/guestfs-actions.pod:7823 ../src/guestfs-actions.pod:10436 msgid "(Added in 1.0.13)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5823 +#: ../src/guestfs-actions.pod:5831 msgid "guestfs_lvrename" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5825 +#: ../src/guestfs-actions.pod:5833 #, no-wrap msgid "" " int\n" @@ -40489,17 +40567,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5834 ../src/guestfs-actions.pod:10441 +#: ../src/guestfs-actions.pod:5842 ../src/guestfs-actions.pod:10449 msgid "(Added in 1.0.83)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5836 +#: ../src/guestfs-actions.pod:5844 msgid "guestfs_lvresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5838 +#: ../src/guestfs-actions.pod:5846 #, no-wrap msgid "" " int\n" @@ -40510,12 +40588,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5851 +#: ../src/guestfs-actions.pod:5859 msgid "guestfs_lvresize_free" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5853 +#: ../src/guestfs-actions.pod:5861 #, no-wrap msgid "" " int\n" @@ -40526,17 +40604,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5866 +#: ../src/guestfs-actions.pod:5874 msgid "(Added in 1.3.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5868 +#: ../src/guestfs-actions.pod:5876 msgid "guestfs_lvs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5870 +#: ../src/guestfs-actions.pod:5878 #, no-wrap msgid "" " char **\n" @@ -40545,17 +40623,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5879 +#: ../src/guestfs-actions.pod:5887 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5887 +#: ../src/guestfs-actions.pod:5895 msgid "guestfs_lvs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5889 +#: ../src/guestfs-actions.pod:5897 #, no-wrap msgid "" " struct guestfs_lvm_lv_list *\n" @@ -40564,7 +40642,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5895 +#: ../src/guestfs-actions.pod:5903 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 " @@ -40572,12 +40650,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5901 +#: ../src/guestfs-actions.pod:5909 msgid "guestfs_lvuuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5903 +#: ../src/guestfs-actions.pod:5911 #, no-wrap msgid "" " char *\n" @@ -40587,12 +40665,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5914 +#: ../src/guestfs-actions.pod:5922 msgid "guestfs_lxattrlist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5916 +#: ../src/guestfs-actions.pod:5924 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -40603,7 +40681,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5935 +#: ../src/guestfs-actions.pod:5943 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 " @@ -40611,12 +40689,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5946 +#: ../src/guestfs-actions.pod:5954 msgid "guestfs_max_disks" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5948 +#: ../src/guestfs-actions.pod:5956 #, no-wrap msgid "" " int\n" @@ -40625,19 +40703,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5951 +#: ../src/guestfs-actions.pod:5959 msgid "" "Return the maximum number of disks that may be added to a handle (eg. by " "C<guestfs_add_drive_opts> and similar calls)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5964 +#: ../src/guestfs-actions.pod:5972 msgid "guestfs_md_create" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5966 +#: ../src/guestfs-actions.pod:5974 #, no-wrap msgid "" " int\n" @@ -40649,7 +40727,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5977 +#: ../src/guestfs-actions.pod:5985 #, no-wrap msgid "" " GUESTFS_MD_CREATE_MISSINGBITMAP, int64_t missingbitmap,\n" @@ -40661,17 +40739,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6039 ../src/guestfs-actions.pod:6105 ../src/guestfs-actions.pod:6175 +#: ../src/guestfs-actions.pod:6047 ../src/guestfs-actions.pod:6113 ../src/guestfs-actions.pod:6183 msgid "(Added in 1.15.6)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6041 +#: ../src/guestfs-actions.pod:6049 msgid "guestfs_md_create_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6043 +#: ../src/guestfs-actions.pod:6051 #, no-wrap msgid "" " int\n" @@ -40683,17 +40761,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6049 +#: ../src/guestfs-actions.pod:6057 msgid "This is the \"va_list variant\" of L</guestfs_md_create>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6053 +#: ../src/guestfs-actions.pod:6061 msgid "guestfs_md_create_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6055 +#: ../src/guestfs-actions.pod:6063 #, no-wrap msgid "" " int\n" @@ -40705,17 +40783,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6061 +#: ../src/guestfs-actions.pod:6069 msgid "This is the \"argv variant\" of L</guestfs_md_create>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6065 +#: ../src/guestfs-actions.pod:6073 msgid "guestfs_md_detail" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6067 +#: ../src/guestfs-actions.pod:6075 #, no-wrap msgid "" " char **\n" @@ -40725,12 +40803,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6107 +#: ../src/guestfs-actions.pod:6115 msgid "guestfs_md_stat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6109 +#: ../src/guestfs-actions.pod:6117 #, no-wrap msgid "" " struct guestfs_mdstat_list *\n" @@ -40740,12 +40818,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6116 +#: ../src/guestfs-actions.pod:6124 msgid "To get a list of software RAID devices, call C<guestfs_list_md_devices>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6158 +#: ../src/guestfs-actions.pod:6166 msgid "" "This function returns a C<struct guestfs_mdstat_list *>, or NULL if there " "was an error. I<The caller must call C<guestfs_free_mdstat_list> after " @@ -40753,17 +40831,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6162 +#: ../src/guestfs-actions.pod:6170 msgid "(Added in 1.17.21)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6164 +#: ../src/guestfs-actions.pod:6172 msgid "guestfs_md_stop" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6166 +#: ../src/guestfs-actions.pod:6174 #, no-wrap msgid "" " int\n" @@ -40773,12 +40851,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6177 +#: ../src/guestfs-actions.pod:6185 msgid "guestfs_mkdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6179 +#: ../src/guestfs-actions.pod:6187 #, no-wrap msgid "" " int\n" @@ -40788,12 +40866,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6189 +#: ../src/guestfs-actions.pod:6197 msgid "guestfs_mkdir_mode" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6191 +#: ../src/guestfs-actions.pod:6199 #, no-wrap msgid "" " int\n" @@ -40804,17 +40882,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6203 +#: ../src/guestfs-actions.pod:6211 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6209 +#: ../src/guestfs-actions.pod:6217 msgid "guestfs_mkdir_p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6211 +#: ../src/guestfs-actions.pod:6219 #, no-wrap msgid "" " int\n" @@ -40824,12 +40902,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6222 +#: ../src/guestfs-actions.pod:6230 msgid "guestfs_mkdtemp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6224 +#: ../src/guestfs-actions.pod:6232 #, no-wrap msgid "" " char *\n" @@ -40839,12 +40917,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6252 +#: ../src/guestfs-actions.pod:6260 msgid "guestfs_mke2fs_J" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6254 +#: ../src/guestfs-actions.pod:6262 #, no-wrap msgid "" " int\n" @@ -40857,22 +40935,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6267 +#: ../src/guestfs-actions.pod:6275 msgid "See also C<guestfs_mke2journal>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6271 ../src/guestfs-actions.pod:6289 ../src/guestfs-actions.pod:6307 ../src/guestfs-actions.pod:6323 ../src/guestfs-actions.pod:6337 ../src/guestfs-actions.pod:6351 ../src/guestfs-actions.pod:6496 ../src/guestfs-actions.pod:6800 +#: ../src/guestfs-actions.pod:6279 ../src/guestfs-actions.pod:6297 ../src/guestfs-actions.pod:6315 ../src/guestfs-actions.pod:6331 ../src/guestfs-actions.pod:6345 ../src/guestfs-actions.pod:6359 ../src/guestfs-actions.pod:6504 ../src/guestfs-actions.pod:6808 msgid "(Added in 1.0.68)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6273 +#: ../src/guestfs-actions.pod:6281 msgid "guestfs_mke2fs_JL" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6275 +#: ../src/guestfs-actions.pod:6283 #, no-wrap msgid "" " int\n" @@ -40885,17 +40963,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6285 +#: ../src/guestfs-actions.pod:6293 msgid "See also C<guestfs_mke2journal_L>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6291 +#: ../src/guestfs-actions.pod:6299 msgid "guestfs_mke2fs_JU" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6293 +#: ../src/guestfs-actions.pod:6301 #, no-wrap msgid "" " int\n" @@ -40908,17 +40986,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6303 +#: ../src/guestfs-actions.pod:6311 msgid "See also C<guestfs_mke2journal_U>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6309 +#: ../src/guestfs-actions.pod:6317 msgid "guestfs_mke2journal" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6311 +#: ../src/guestfs-actions.pod:6319 #, no-wrap msgid "" " int\n" @@ -40929,12 +41007,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6325 +#: ../src/guestfs-actions.pod:6333 msgid "guestfs_mke2journal_L" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6327 +#: ../src/guestfs-actions.pod:6335 #, no-wrap msgid "" " int\n" @@ -40946,12 +41024,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6339 +#: ../src/guestfs-actions.pod:6347 msgid "guestfs_mke2journal_U" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6341 +#: ../src/guestfs-actions.pod:6349 #, no-wrap msgid "" " int\n" @@ -40963,12 +41041,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6353 +#: ../src/guestfs-actions.pod:6361 msgid "guestfs_mkfifo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6355 +#: ../src/guestfs-actions.pod:6363 #, no-wrap msgid "" " int\n" @@ -40979,19 +41057,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6360 +#: ../src/guestfs-actions.pod:6368 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:6370 +#: ../src/guestfs-actions.pod:6378 msgid "guestfs_mkfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6372 +#: ../src/guestfs-actions.pod:6380 #, no-wrap msgid "" " int\n" @@ -41002,7 +41080,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6377 +#: ../src/guestfs-actions.pod:6385 msgid "" "This function is provided for backwards compatibility with earlier versions " "of libguestfs. It simply calls L</guestfs_mkfs_opts> with no optional " @@ -41010,12 +41088,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6384 +#: ../src/guestfs-actions.pod:6392 msgid "guestfs_mkfs_opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6386 +#: ../src/guestfs-actions.pod:6394 #, no-wrap msgid "" " int\n" @@ -41027,7 +41105,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6397 +#: ../src/guestfs-actions.pod:6405 #, no-wrap msgid "" " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n" @@ -41038,17 +41116,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6445 +#: ../src/guestfs-actions.pod:6453 msgid "(Added in 1.7.19)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6447 +#: ../src/guestfs-actions.pod:6455 msgid "guestfs_mkfs_opts_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6449 +#: ../src/guestfs-actions.pod:6457 #, no-wrap msgid "" " int\n" @@ -41060,17 +41138,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6455 +#: ../src/guestfs-actions.pod:6463 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6459 +#: ../src/guestfs-actions.pod:6467 msgid "guestfs_mkfs_opts_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6461 +#: ../src/guestfs-actions.pod:6469 #, no-wrap msgid "" " int\n" @@ -41082,17 +41160,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6467 +#: ../src/guestfs-actions.pod:6475 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6471 +#: ../src/guestfs-actions.pod:6479 msgid "guestfs_mkfs_b" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6473 +#: ../src/guestfs-actions.pod:6481 #, no-wrap msgid "" " int\n" @@ -41104,14 +41182,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6479 +#: ../src/guestfs-actions.pod:6487 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_mkfs> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6486 +#: ../src/guestfs-actions.pod:6494 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 " @@ -41119,12 +41197,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6498 +#: ../src/guestfs-actions.pod:6506 msgid "guestfs_mkfs_btrfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6500 +#: ../src/guestfs-actions.pod:6508 #, no-wrap msgid "" " int\n" @@ -41135,7 +41213,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6510 +#: ../src/guestfs-actions.pod:6518 #, no-wrap msgid "" " GUESTFS_MKFS_BTRFS_ALLOCSTART, int64_t allocstart,\n" @@ -41150,22 +41228,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6525 +#: ../src/guestfs-actions.pod:6533 msgid "To create general filesystems, use C<guestfs_mkfs>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6529 +#: ../src/guestfs-actions.pod:6537 msgid "(Added in 1.17.25)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6531 +#: ../src/guestfs-actions.pod:6539 msgid "guestfs_mkfs_btrfs_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6533 +#: ../src/guestfs-actions.pod:6541 #, no-wrap msgid "" " int\n" @@ -41176,17 +41254,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6538 +#: ../src/guestfs-actions.pod:6546 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_btrfs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6542 +#: ../src/guestfs-actions.pod:6550 msgid "guestfs_mkfs_btrfs_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6544 +#: ../src/guestfs-actions.pod:6552 #, no-wrap msgid "" " int\n" @@ -41197,17 +41275,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6549 +#: ../src/guestfs-actions.pod:6557 msgid "This is the \"argv variant\" of L</guestfs_mkfs_btrfs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6553 +#: ../src/guestfs-actions.pod:6561 msgid "guestfs_mkmountpoint" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6555 +#: ../src/guestfs-actions.pod:6563 #, no-wrap msgid "" " int\n" @@ -41217,7 +41295,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6559 +#: ../src/guestfs-actions.pod:6567 msgid "" "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls " "that can be used to create extra mountpoints before mounting the first " @@ -41225,7 +41303,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6583 +#: ../src/guestfs-actions.pod:6591 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 " @@ -41233,7 +41311,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6587 +#: ../src/guestfs-actions.pod:6595 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 " @@ -41242,7 +41320,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6594 +#: ../src/guestfs-actions.pod:6602 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 " @@ -41250,17 +41328,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6600 ../src/guestfs-actions.pod:7059 ../src/guestfs-actions.pod:8246 +#: ../src/guestfs-actions.pod:6608 ../src/guestfs-actions.pod:7067 ../src/guestfs-actions.pod:8254 msgid "(Added in 1.0.62)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6602 +#: ../src/guestfs-actions.pod:6610 msgid "guestfs_mknod" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6604 +#: ../src/guestfs-actions.pod:6612 #, no-wrap msgid "" " int\n" @@ -41273,7 +41351,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6619 +#: ../src/guestfs-actions.pod:6627 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 " @@ -41284,12 +41362,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6633 +#: ../src/guestfs-actions.pod:6641 msgid "guestfs_mknod_b" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6635 +#: ../src/guestfs-actions.pod:6643 #, no-wrap msgid "" " int\n" @@ -41302,7 +41380,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6642 +#: ../src/guestfs-actions.pod:6650 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 " @@ -41310,12 +41388,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6652 +#: ../src/guestfs-actions.pod:6660 msgid "guestfs_mknod_c" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6654 +#: ../src/guestfs-actions.pod:6662 #, no-wrap msgid "" " int\n" @@ -41328,7 +41406,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6661 +#: ../src/guestfs-actions.pod:6669 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 " @@ -41336,12 +41414,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6671 +#: ../src/guestfs-actions.pod:6679 msgid "guestfs_mkswap" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6673 +#: ../src/guestfs-actions.pod:6681 #, no-wrap msgid "" " int\n" @@ -41351,7 +41429,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6677 +#: ../src/guestfs-actions.pod:6685 msgid "" "This function is provided for backwards compatibility with earlier versions " "of libguestfs. It simply calls L</guestfs_mkswap_opts> with no optional " @@ -41359,12 +41437,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6684 +#: ../src/guestfs-actions.pod:6692 msgid "guestfs_mkswap_opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6686 +#: ../src/guestfs-actions.pod:6694 #, no-wrap msgid "" " int\n" @@ -41375,7 +41453,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6696 +#: ../src/guestfs-actions.pod:6704 #, no-wrap msgid "" " GUESTFS_MKSWAP_OPTS_LABEL, const char *label,\n" @@ -41384,12 +41462,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6706 +#: ../src/guestfs-actions.pod:6714 msgid "guestfs_mkswap_opts_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6708 +#: ../src/guestfs-actions.pod:6716 #, no-wrap msgid "" " int\n" @@ -41400,17 +41478,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6713 +#: ../src/guestfs-actions.pod:6721 msgid "This is the \"va_list variant\" of L</guestfs_mkswap_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6717 +#: ../src/guestfs-actions.pod:6725 msgid "guestfs_mkswap_opts_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6719 +#: ../src/guestfs-actions.pod:6727 #, no-wrap msgid "" " int\n" @@ -41422,17 +41500,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6724 +#: ../src/guestfs-actions.pod:6732 msgid "This is the \"argv variant\" of L</guestfs_mkswap_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6728 +#: ../src/guestfs-actions.pod:6736 msgid "guestfs_mkswap_L" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6730 +#: ../src/guestfs-actions.pod:6738 #, no-wrap msgid "" " int\n" @@ -41443,19 +41521,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6735 ../src/guestfs-actions.pod:6759 +#: ../src/guestfs-actions.pod:6743 ../src/guestfs-actions.pod:6767 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_mkswap> call " "instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6752 +#: ../src/guestfs-actions.pod:6760 msgid "guestfs_mkswap_U" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6754 +#: ../src/guestfs-actions.pod:6762 #, no-wrap msgid "" " int\n" @@ -41466,12 +41544,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6772 +#: ../src/guestfs-actions.pod:6780 msgid "guestfs_mkswap_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6774 +#: ../src/guestfs-actions.pod:6782 #, no-wrap msgid "" " int\n" @@ -41481,19 +41559,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6780 +#: ../src/guestfs-actions.pod:6788 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:6787 +#: ../src/guestfs-actions.pod:6795 msgid "guestfs_modprobe" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6789 +#: ../src/guestfs-actions.pod:6797 #, no-wrap msgid "" " int\n" @@ -41503,12 +41581,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6802 +#: ../src/guestfs-actions.pod:6810 msgid "guestfs_mount" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6804 +#: ../src/guestfs-actions.pod:6812 #, no-wrap msgid "" " int\n" @@ -41519,7 +41597,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6823 +#: ../src/guestfs-actions.pod:6831 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 " @@ -41529,12 +41607,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6834 +#: ../src/guestfs-actions.pod:6842 msgid "guestfs_mount_9p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6836 +#: ../src/guestfs-actions.pod:6844 #, no-wrap msgid "" " int\n" @@ -41546,7 +41624,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6847 +#: ../src/guestfs-actions.pod:6855 #, no-wrap msgid "" " GUESTFS_MOUNT_9P_OPTIONS, const char *options,\n" @@ -41554,12 +41632,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6860 +#: ../src/guestfs-actions.pod:6868 msgid "guestfs_mount_9p_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6862 +#: ../src/guestfs-actions.pod:6870 #, no-wrap msgid "" " int\n" @@ -41571,17 +41649,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6868 +#: ../src/guestfs-actions.pod:6876 msgid "This is the \"va_list variant\" of L</guestfs_mount_9p>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6872 +#: ../src/guestfs-actions.pod:6880 msgid "guestfs_mount_9p_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6874 +#: ../src/guestfs-actions.pod:6882 #, no-wrap msgid "" " int\n" @@ -41593,17 +41671,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6880 +#: ../src/guestfs-actions.pod:6888 msgid "This is the \"argv variant\" of L</guestfs_mount_9p>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6884 +#: ../src/guestfs-actions.pod:6892 msgid "guestfs_mount_local" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6886 +#: ../src/guestfs-actions.pod:6894 #, no-wrap msgid "" " int\n" @@ -41614,7 +41692,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6896 +#: ../src/guestfs-actions.pod:6904 #, no-wrap msgid "" " GUESTFS_MOUNT_LOCAL_READONLY, int readonly,\n" @@ -41625,7 +41703,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6919 +#: ../src/guestfs-actions.pod:6927 msgid "" "When C<guestfs_mount_local> returns, the filesystem is ready, but is not " "processing requests (access to it will block). You have to call " @@ -41633,17 +41711,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6927 ../src/guestfs-actions.pod:6976 ../src/guestfs-actions.pod:10063 +#: ../src/guestfs-actions.pod:6935 ../src/guestfs-actions.pod:6984 ../src/guestfs-actions.pod:10071 msgid "(Added in 1.17.22)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6929 +#: ../src/guestfs-actions.pod:6937 msgid "guestfs_mount_local_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6931 +#: ../src/guestfs-actions.pod:6939 #, no-wrap msgid "" " int\n" @@ -41654,17 +41732,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6936 +#: ../src/guestfs-actions.pod:6944 msgid "This is the \"va_list variant\" of L</guestfs_mount_local>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6940 +#: ../src/guestfs-actions.pod:6948 msgid "guestfs_mount_local_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6942 +#: ../src/guestfs-actions.pod:6950 #, no-wrap msgid "" " int\n" @@ -41676,17 +41754,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6947 +#: ../src/guestfs-actions.pod:6955 msgid "This is the \"argv variant\" of L</guestfs_mount_local>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6951 +#: ../src/guestfs-actions.pod:6959 msgid "guestfs_mount_local_run" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6953 +#: ../src/guestfs-actions.pod:6961 #, no-wrap msgid "" " int\n" @@ -41695,21 +41773,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6959 +#: ../src/guestfs-actions.pod:6967 msgid "" "This should only be called after C<guestfs_mount_local> returns " "successfully. The call will not return until the filesystem is unmounted." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6963 +#: ../src/guestfs-actions.pod:6971 msgid "" "B<Note> you must I<not> make concurrent libguestfs calls on the same handle " "from another thread, with the exception of C<guestfs_umount_local>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6967 +#: ../src/guestfs-actions.pod:6975 msgid "" "You may call this from a different thread than the one which called " "C<guestfs_mount_local>, subject to the usual rules for threads and " @@ -41717,12 +41795,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6978 +#: ../src/guestfs-actions.pod:6986 msgid "guestfs_mount_loop" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6980 +#: ../src/guestfs-actions.pod:6988 #, no-wrap msgid "" " int\n" @@ -41733,12 +41811,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6993 +#: ../src/guestfs-actions.pod:7001 msgid "guestfs_mount_options" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6995 +#: ../src/guestfs-actions.pod:7003 #, no-wrap msgid "" " int\n" @@ -41750,24 +41828,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7001 +#: ../src/guestfs-actions.pod:7009 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:7011 ../src/guestfs-actions.pod:7025 ../src/guestfs-actions.pod:7042 +#: ../src/guestfs-actions.pod:7019 ../src/guestfs-actions.pod:7033 ../src/guestfs-actions.pod:7050 msgid "(Added in 1.0.10)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7013 +#: ../src/guestfs-actions.pod:7021 msgid "guestfs_mount_ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7015 +#: ../src/guestfs-actions.pod:7023 #, no-wrap msgid "" " int\n" @@ -41778,19 +41856,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7020 +#: ../src/guestfs-actions.pod:7028 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:7027 +#: ../src/guestfs-actions.pod:7035 msgid "guestfs_mount_vfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7029 +#: ../src/guestfs-actions.pod:7037 #, no-wrap msgid "" " int\n" @@ -41803,7 +41881,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7036 +#: ../src/guestfs-actions.pod:7044 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 " @@ -41811,12 +41889,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7044 +#: ../src/guestfs-actions.pod:7052 msgid "guestfs_mountpoints" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7046 +#: ../src/guestfs-actions.pod:7054 #, no-wrap msgid "" " char **\n" @@ -41825,7 +41903,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7049 +#: ../src/guestfs-actions.pod:7057 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 " @@ -41833,12 +41911,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7061 +#: ../src/guestfs-actions.pod:7069 msgid "guestfs_mounts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7063 +#: ../src/guestfs-actions.pod:7071 #, no-wrap msgid "" " char **\n" @@ -41847,17 +41925,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7071 +#: ../src/guestfs-actions.pod:7079 msgid "See also: C<guestfs_mountpoints>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7079 +#: ../src/guestfs-actions.pod:7087 msgid "guestfs_mv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7081 +#: ../src/guestfs-actions.pod:7089 #, no-wrap msgid "" " int\n" @@ -41868,12 +41946,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7093 +#: ../src/guestfs-actions.pod:7101 msgid "guestfs_nr_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7095 +#: ../src/guestfs-actions.pod:7103 #, no-wrap msgid "" " int\n" @@ -41882,7 +41960,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7098 +#: ../src/guestfs-actions.pod:7106 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 " @@ -41890,24 +41968,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7102 +#: ../src/guestfs-actions.pod:7110 msgid "" "To find out the maximum number of devices that could be added, call " "C<guestfs_max_disks>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7107 +#: ../src/guestfs-actions.pod:7115 msgid "(Added in 1.19.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7109 +#: ../src/guestfs-actions.pod:7117 msgid "guestfs_ntfs_3g_probe" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7111 +#: ../src/guestfs-actions.pod:7119 #, no-wrap msgid "" " int\n" @@ -41918,17 +41996,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7130 +#: ../src/guestfs-actions.pod:7138 msgid "(Added in 1.0.43)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7132 +#: ../src/guestfs-actions.pod:7140 msgid "guestfs_ntfsclone_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7134 +#: ../src/guestfs-actions.pod:7142 #, no-wrap msgid "" " int\n" @@ -41939,24 +42017,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7139 +#: ../src/guestfs-actions.pod:7147 msgid "" "Restore the C<backupfile> (from a previous call to C<guestfs_ntfsclone_out>) " "to C<device>, overwriting any existing contents of this device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7145 ../src/guestfs-actions.pod:7183 ../src/guestfs-actions.pod:7235 ../src/guestfs-actions.pod:8757 +#: ../src/guestfs-actions.pod:7153 ../src/guestfs-actions.pod:7191 ../src/guestfs-actions.pod:7243 ../src/guestfs-actions.pod:8765 msgid "(Added in 1.17.9)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7147 +#: ../src/guestfs-actions.pod:7155 msgid "guestfs_ntfsclone_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7149 +#: ../src/guestfs-actions.pod:7157 #, no-wrap msgid "" " int\n" @@ -41968,7 +42046,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7160 +#: ../src/guestfs-actions.pod:7168 #, no-wrap msgid "" " GUESTFS_NTFSCLONE_OUT_METADATAONLY, int metadataonly,\n" @@ -41980,17 +42058,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7178 +#: ../src/guestfs-actions.pod:7186 msgid "Use C<guestfs_ntfsclone_in> to restore the file back to a libguestfs device." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7185 +#: ../src/guestfs-actions.pod:7193 msgid "guestfs_ntfsclone_out_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7187 +#: ../src/guestfs-actions.pod:7195 #, no-wrap msgid "" " int\n" @@ -42002,17 +42080,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7193 +#: ../src/guestfs-actions.pod:7201 msgid "This is the \"va_list variant\" of L</guestfs_ntfsclone_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7197 +#: ../src/guestfs-actions.pod:7205 msgid "guestfs_ntfsclone_out_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7199 +#: ../src/guestfs-actions.pod:7207 #, no-wrap msgid "" " int\n" @@ -42025,17 +42103,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7205 +#: ../src/guestfs-actions.pod:7213 msgid "This is the \"argv variant\" of L</guestfs_ntfsclone_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7209 +#: ../src/guestfs-actions.pod:7217 msgid "guestfs_ntfsfix" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7211 +#: ../src/guestfs-actions.pod:7219 #, no-wrap msgid "" " int\n" @@ -42046,7 +42124,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7221 +#: ../src/guestfs-actions.pod:7229 #, no-wrap msgid "" " GUESTFS_NTFSFIX_CLEARBADSECTORS, int clearbadsectors,\n" @@ -42054,12 +42132,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7237 +#: ../src/guestfs-actions.pod:7245 msgid "guestfs_ntfsfix_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7239 +#: ../src/guestfs-actions.pod:7247 #, no-wrap msgid "" " int\n" @@ -42070,17 +42148,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7244 +#: ../src/guestfs-actions.pod:7252 msgid "This is the \"va_list variant\" of L</guestfs_ntfsfix>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7248 +#: ../src/guestfs-actions.pod:7256 msgid "guestfs_ntfsfix_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7250 +#: ../src/guestfs-actions.pod:7258 #, no-wrap msgid "" " int\n" @@ -42091,17 +42169,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7255 +#: ../src/guestfs-actions.pod:7263 msgid "This is the \"argv variant\" of L</guestfs_ntfsfix>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7259 +#: ../src/guestfs-actions.pod:7267 msgid "guestfs_ntfsresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7261 +#: ../src/guestfs-actions.pod:7269 #, no-wrap msgid "" " int\n" @@ -42111,7 +42189,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7265 +#: ../src/guestfs-actions.pod:7273 msgid "" "This function is provided for backwards compatibility with earlier versions " "of libguestfs. It simply calls L</guestfs_ntfsresize_opts> with no optional " @@ -42119,12 +42197,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7272 +#: ../src/guestfs-actions.pod:7280 msgid "guestfs_ntfsresize_opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7274 +#: ../src/guestfs-actions.pod:7282 #, no-wrap msgid "" " int\n" @@ -42135,7 +42213,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7284 +#: ../src/guestfs-actions.pod:7292 #, no-wrap msgid "" " GUESTFS_NTFSRESIZE_OPTS_SIZE, int64_t size,\n" @@ -42144,7 +42222,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7304 +#: ../src/guestfs-actions.pod:7312 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 " @@ -42154,12 +42232,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7319 +#: ../src/guestfs-actions.pod:7327 msgid "guestfs_ntfsresize_opts_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7321 +#: ../src/guestfs-actions.pod:7329 #, no-wrap msgid "" " int\n" @@ -42170,17 +42248,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7326 +#: ../src/guestfs-actions.pod:7334 msgid "This is the \"va_list variant\" of L</guestfs_ntfsresize_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7330 +#: ../src/guestfs-actions.pod:7338 msgid "guestfs_ntfsresize_opts_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7332 +#: ../src/guestfs-actions.pod:7340 #, no-wrap msgid "" " int\n" @@ -42192,17 +42270,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7337 +#: ../src/guestfs-actions.pod:7345 msgid "This is the \"argv variant\" of L</guestfs_ntfsresize_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7341 +#: ../src/guestfs-actions.pod:7349 msgid "guestfs_ntfsresize_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7343 +#: ../src/guestfs-actions.pod:7351 #, no-wrap msgid "" " int\n" @@ -42213,31 +42291,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7348 +#: ../src/guestfs-actions.pod:7356 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_ntfsresize> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7355 +#: ../src/guestfs-actions.pod:7363 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:7360 ../src/guestfs-actions.pod:7842 ../src/guestfs-actions.pod:7915 ../src/guestfs-actions.pod:8177 ../src/guestfs-actions.pod:10601 +#: ../src/guestfs-actions.pod:7368 ../src/guestfs-actions.pod:7850 ../src/guestfs-actions.pod:7923 ../src/guestfs-actions.pod:8185 ../src/guestfs-actions.pod:10609 msgid "(Added in 1.3.14)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7362 +#: ../src/guestfs-actions.pod:7370 msgid "guestfs_part_add" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7364 +#: ../src/guestfs-actions.pod:7372 #, no-wrap msgid "" " int\n" @@ -42250,31 +42328,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7371 +#: ../src/guestfs-actions.pod:7379 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:7383 +#: ../src/guestfs-actions.pod:7391 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:7388 ../src/guestfs-actions.pod:7423 ../src/guestfs-actions.pod:7476 ../src/guestfs-actions.pod:7560 ../src/guestfs-actions.pod:7598 ../src/guestfs-actions.pod:7617 ../src/guestfs-actions.pod:7657 +#: ../src/guestfs-actions.pod:7396 ../src/guestfs-actions.pod:7431 ../src/guestfs-actions.pod:7484 ../src/guestfs-actions.pod:7568 ../src/guestfs-actions.pod:7606 ../src/guestfs-actions.pod:7625 ../src/guestfs-actions.pod:7665 msgid "(Added in 1.0.78)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7390 +#: ../src/guestfs-actions.pod:7398 msgid "guestfs_part_del" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7392 +#: ../src/guestfs-actions.pod:7400 #, no-wrap msgid "" " int\n" @@ -42285,12 +42363,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7407 +#: ../src/guestfs-actions.pod:7415 msgid "guestfs_part_disk" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7409 +#: ../src/guestfs-actions.pod:7417 #, no-wrap msgid "" " int\n" @@ -42301,7 +42379,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7414 +#: ../src/guestfs-actions.pod:7422 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 " @@ -42309,19 +42387,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7418 +#: ../src/guestfs-actions.pod:7426 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:7425 +#: ../src/guestfs-actions.pod:7433 msgid "guestfs_part_get_bootable" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7427 +#: ../src/guestfs-actions.pod:7435 #, no-wrap msgid "" " int\n" @@ -42332,17 +42410,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7435 +#: ../src/guestfs-actions.pod:7443 msgid "See also C<guestfs_part_set_bootable>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7441 +#: ../src/guestfs-actions.pod:7449 msgid "guestfs_part_get_mbr_id" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7443 +#: ../src/guestfs-actions.pod:7451 #, no-wrap msgid "" " int\n" @@ -42353,7 +42431,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7451 ../src/guestfs-actions.pod:7633 +#: ../src/guestfs-actions.pod:7459 ../src/guestfs-actions.pod:7641 msgid "" "Note that only MBR (old DOS-style) partitions have type bytes. You will get " "undefined results for other partition table types (see " @@ -42361,12 +42439,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7459 +#: ../src/guestfs-actions.pod:7467 msgid "guestfs_part_get_parttype" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7461 +#: ../src/guestfs-actions.pod:7469 #, no-wrap msgid "" " char *\n" @@ -42376,7 +42454,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7468 +#: ../src/guestfs-actions.pod:7476 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 " @@ -42384,12 +42462,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7478 +#: ../src/guestfs-actions.pod:7486 msgid "guestfs_part_init" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7480 +#: ../src/guestfs-actions.pod:7488 #, no-wrap msgid "" " int\n" @@ -42400,19 +42478,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7489 +#: ../src/guestfs-actions.pod:7497 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:7562 +#: ../src/guestfs-actions.pod:7570 msgid "guestfs_part_list" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7564 +#: ../src/guestfs-actions.pod:7572 #, no-wrap msgid "" " struct guestfs_partition_list *\n" @@ -42422,14 +42500,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7581 +#: ../src/guestfs-actions.pod:7589 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:7594 +#: ../src/guestfs-actions.pod:7602 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 " @@ -42437,12 +42515,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7600 +#: ../src/guestfs-actions.pod:7608 msgid "guestfs_part_set_bootable" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7602 +#: ../src/guestfs-actions.pod:7610 #, no-wrap msgid "" " int\n" @@ -42454,12 +42532,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7619 +#: ../src/guestfs-actions.pod:7627 msgid "guestfs_part_set_mbr_id" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7621 +#: ../src/guestfs-actions.pod:7629 #, no-wrap msgid "" " int\n" @@ -42471,12 +42549,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7641 +#: ../src/guestfs-actions.pod:7649 msgid "guestfs_part_set_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7643 +#: ../src/guestfs-actions.pod:7651 #, no-wrap msgid "" " int\n" @@ -42488,12 +42566,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7659 +#: ../src/guestfs-actions.pod:7667 msgid "guestfs_part_to_dev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7661 +#: ../src/guestfs-actions.pod:7669 #, no-wrap msgid "" " char *\n" @@ -42503,24 +42581,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7669 ../src/guestfs-actions.pod:7688 +#: ../src/guestfs-actions.pod:7677 ../src/guestfs-actions.pod:7696 msgid "" "The named partition must exist, for example as a string returned from " "C<guestfs_list_partitions>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7672 +#: ../src/guestfs-actions.pod:7680 msgid "See also C<guestfs_part_to_partnum>, C<guestfs_device_index>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7679 +#: ../src/guestfs-actions.pod:7687 msgid "guestfs_part_to_partnum" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7681 +#: ../src/guestfs-actions.pod:7689 #, no-wrap msgid "" " int\n" @@ -42530,17 +42608,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7691 +#: ../src/guestfs-actions.pod:7699 msgid "See also C<guestfs_part_to_dev>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7697 +#: ../src/guestfs-actions.pod:7705 msgid "guestfs_ping_daemon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7699 +#: ../src/guestfs-actions.pod:7707 #, no-wrap msgid "" " int\n" @@ -42549,12 +42627,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7711 +#: ../src/guestfs-actions.pod:7719 msgid "guestfs_pread" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7713 +#: ../src/guestfs-actions.pod:7721 #, no-wrap msgid "" " char *\n" @@ -42567,17 +42645,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7726 +#: ../src/guestfs-actions.pod:7734 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7737 +#: ../src/guestfs-actions.pod:7745 msgid "guestfs_pread_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7739 +#: ../src/guestfs-actions.pod:7747 #, no-wrap msgid "" " char *\n" @@ -42590,22 +42668,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7752 +#: ../src/guestfs-actions.pod:7760 msgid "See also C<guestfs_pread>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7761 +#: ../src/guestfs-actions.pod:7769 msgid "(Added in 1.5.21)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7763 +#: ../src/guestfs-actions.pod:7771 msgid "guestfs_pvchange_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7765 +#: ../src/guestfs-actions.pod:7773 #, no-wrap msgid "" " int\n" @@ -42615,17 +42693,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7773 ../src/guestfs-actions.pod:7784 ../src/guestfs-actions.pod:10329 ../src/guestfs-actions.pod:10340 +#: ../src/guestfs-actions.pod:7781 ../src/guestfs-actions.pod:7792 ../src/guestfs-actions.pod:10337 ../src/guestfs-actions.pod:10348 msgid "(Added in 1.19.26)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7775 +#: ../src/guestfs-actions.pod:7783 msgid "guestfs_pvchange_uuid_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7777 +#: ../src/guestfs-actions.pod:7785 #, no-wrap msgid "" " int\n" @@ -42634,12 +42712,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7786 +#: ../src/guestfs-actions.pod:7794 msgid "guestfs_pvcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7788 +#: ../src/guestfs-actions.pod:7796 #, no-wrap msgid "" " int\n" @@ -42649,12 +42727,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7800 +#: ../src/guestfs-actions.pod:7808 msgid "guestfs_pvremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7802 +#: ../src/guestfs-actions.pod:7810 #, no-wrap msgid "" " int\n" @@ -42664,12 +42742,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7817 +#: ../src/guestfs-actions.pod:7825 msgid "guestfs_pvresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7819 +#: ../src/guestfs-actions.pod:7827 #, no-wrap msgid "" " int\n" @@ -42679,12 +42757,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7830 +#: ../src/guestfs-actions.pod:7838 msgid "guestfs_pvresize_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7832 +#: ../src/guestfs-actions.pod:7840 #, no-wrap msgid "" " int\n" @@ -42695,19 +42773,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7837 +#: ../src/guestfs-actions.pod:7845 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:7844 +#: ../src/guestfs-actions.pod:7852 msgid "guestfs_pvs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7846 +#: ../src/guestfs-actions.pod:7854 #, no-wrap msgid "" " char **\n" @@ -42716,17 +42794,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7855 +#: ../src/guestfs-actions.pod:7863 msgid "See also C<guestfs_pvs_full>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7863 +#: ../src/guestfs-actions.pod:7871 msgid "guestfs_pvs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7865 +#: ../src/guestfs-actions.pod:7873 #, no-wrap msgid "" " struct guestfs_lvm_pv_list *\n" @@ -42735,7 +42813,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7871 +#: ../src/guestfs-actions.pod:7879 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 " @@ -42743,12 +42821,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7877 +#: ../src/guestfs-actions.pod:7885 msgid "guestfs_pvuuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7879 +#: ../src/guestfs-actions.pod:7887 #, no-wrap msgid "" " char *\n" @@ -42758,12 +42836,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7890 +#: ../src/guestfs-actions.pod:7898 msgid "guestfs_pwrite" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7892 +#: ../src/guestfs-actions.pod:7900 #, no-wrap msgid "" " int\n" @@ -42776,17 +42854,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7908 +#: ../src/guestfs-actions.pod:7916 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7917 +#: ../src/guestfs-actions.pod:7925 msgid "guestfs_pwrite_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7919 +#: ../src/guestfs-actions.pod:7927 #, no-wrap msgid "" " int\n" @@ -42799,22 +42877,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7934 +#: ../src/guestfs-actions.pod:7942 msgid "See also C<guestfs_pwrite>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7941 +#: ../src/guestfs-actions.pod:7949 msgid "(Added in 1.5.20)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7943 +#: ../src/guestfs-actions.pod:7951 msgid "guestfs_read_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7945 +#: ../src/guestfs-actions.pod:7953 #, no-wrap msgid "" " char *\n" @@ -42825,24 +42903,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7953 +#: ../src/guestfs-actions.pod:7961 msgid "" "Unlike C<guestfs_cat>, this function can correctly handle files that contain " "embedded ASCII NUL characters." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7960 +#: ../src/guestfs-actions.pod:7968 msgid "(Added in 1.0.63)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7962 +#: ../src/guestfs-actions.pod:7970 msgid "guestfs_read_lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7964 +#: ../src/guestfs-actions.pod:7972 #, no-wrap msgid "" " char **\n" @@ -42852,7 +42930,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7973 +#: ../src/guestfs-actions.pod:7981 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of string). For " @@ -42861,12 +42939,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7984 +#: ../src/guestfs-actions.pod:7992 msgid "guestfs_readdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7986 +#: ../src/guestfs-actions.pod:7994 #, no-wrap msgid "" " struct guestfs_dirent_list *\n" @@ -42876,7 +42954,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8040 +#: ../src/guestfs-actions.pod:8048 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 " @@ -42884,7 +42962,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8044 +#: ../src/guestfs-actions.pod:8052 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 " @@ -42892,12 +42970,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8053 +#: ../src/guestfs-actions.pod:8061 msgid "guestfs_readlink" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8055 +#: ../src/guestfs-actions.pod:8063 #, no-wrap msgid "" " char *\n" @@ -42907,12 +42985,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8066 +#: ../src/guestfs-actions.pod:8074 msgid "guestfs_readlinklist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8068 +#: ../src/guestfs-actions.pod:8076 #, no-wrap msgid "" " char **\n" @@ -42923,12 +43001,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8097 +#: ../src/guestfs-actions.pod:8105 msgid "guestfs_realpath" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8099 +#: ../src/guestfs-actions.pod:8107 #, no-wrap msgid "" " char *\n" @@ -42938,12 +43016,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8111 +#: ../src/guestfs-actions.pod:8119 msgid "guestfs_removexattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8113 +#: ../src/guestfs-actions.pod:8121 #, no-wrap msgid "" " int\n" @@ -42954,17 +43032,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8121 +#: ../src/guestfs-actions.pod:8129 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8127 +#: ../src/guestfs-actions.pod:8135 msgid "guestfs_resize2fs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8129 +#: ../src/guestfs-actions.pod:8137 #, no-wrap msgid "" " int\n" @@ -42974,12 +43052,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8142 +#: ../src/guestfs-actions.pod:8150 msgid "guestfs_resize2fs_M" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8144 +#: ../src/guestfs-actions.pod:8152 #, no-wrap msgid "" " int\n" @@ -42989,7 +43067,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8148 +#: ../src/guestfs-actions.pod:8156 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 " @@ -42997,7 +43075,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8152 +#: ../src/guestfs-actions.pod:8160 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. " @@ -43006,12 +43084,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8163 +#: ../src/guestfs-actions.pod:8171 msgid "guestfs_resize2fs_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8165 +#: ../src/guestfs-actions.pod:8173 #, no-wrap msgid "" " int\n" @@ -43022,19 +43100,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8170 +#: ../src/guestfs-actions.pod:8178 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:8179 +#: ../src/guestfs-actions.pod:8187 msgid "guestfs_rm" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8181 +#: ../src/guestfs-actions.pod:8189 #, no-wrap msgid "" " int\n" @@ -43044,12 +43122,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8191 +#: ../src/guestfs-actions.pod:8199 msgid "guestfs_rm_f" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8193 +#: ../src/guestfs-actions.pod:8201 #, no-wrap msgid "" " int\n" @@ -43059,19 +43137,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8202 +#: ../src/guestfs-actions.pod:8210 msgid "" "This call cannot remove directories. Use C<guestfs_rmdir> to remove an " "empty directory, or C<guestfs_rm_rf> to remove directories recursively." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8208 +#: ../src/guestfs-actions.pod:8216 msgid "guestfs_rm_rf" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8210 +#: ../src/guestfs-actions.pod:8218 #, no-wrap msgid "" " int\n" @@ -43081,12 +43159,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8222 +#: ../src/guestfs-actions.pod:8230 msgid "guestfs_rmdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8224 +#: ../src/guestfs-actions.pod:8232 #, no-wrap msgid "" " int\n" @@ -43096,12 +43174,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8234 +#: ../src/guestfs-actions.pod:8242 msgid "guestfs_rmmountpoint" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8236 +#: ../src/guestfs-actions.pod:8244 #, no-wrap msgid "" " int\n" @@ -43111,19 +43189,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8240 +#: ../src/guestfs-actions.pod:8248 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:8248 +#: ../src/guestfs-actions.pod:8256 msgid "guestfs_rsync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8250 +#: ../src/guestfs-actions.pod:8258 #, no-wrap msgid "" " int\n" @@ -43135,7 +43213,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8261 +#: ../src/guestfs-actions.pod:8269 #, no-wrap msgid "" " GUESTFS_RSYNC_ARCHIVE, int archive,\n" @@ -43144,17 +43222,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8289 ../src/guestfs-actions.pod:8351 ../src/guestfs-actions.pod:8413 +#: ../src/guestfs-actions.pod:8297 ../src/guestfs-actions.pod:8359 ../src/guestfs-actions.pod:8421 msgid "(Added in 1.19.29)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8291 +#: ../src/guestfs-actions.pod:8299 msgid "guestfs_rsync_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8293 +#: ../src/guestfs-actions.pod:8301 #, no-wrap msgid "" " int\n" @@ -43166,17 +43244,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8299 +#: ../src/guestfs-actions.pod:8307 msgid "This is the \"va_list variant\" of L</guestfs_rsync>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8303 +#: ../src/guestfs-actions.pod:8311 msgid "guestfs_rsync_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8305 +#: ../src/guestfs-actions.pod:8313 #, no-wrap msgid "" " int\n" @@ -43188,17 +43266,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8311 +#: ../src/guestfs-actions.pod:8319 msgid "This is the \"argv variant\" of L</guestfs_rsync>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8315 +#: ../src/guestfs-actions.pod:8323 msgid "guestfs_rsync_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8317 +#: ../src/guestfs-actions.pod:8325 #, no-wrap msgid "" " int\n" @@ -43210,7 +43288,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8328 +#: ../src/guestfs-actions.pod:8336 #, no-wrap msgid "" " GUESTFS_RSYNC_IN_ARCHIVE, int archive,\n" @@ -43219,24 +43297,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8336 ../src/guestfs-actions.pod:8398 +#: ../src/guestfs-actions.pod:8344 ../src/guestfs-actions.pod:8406 msgid "" "This call only works if the network is enabled. See C<guestfs_set_network> " "or the I<--network> option to various tools like L<guestfish(1)>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8347 ../src/guestfs-actions.pod:8409 +#: ../src/guestfs-actions.pod:8355 ../src/guestfs-actions.pod:8417 msgid "The optional arguments are the same as those of C<guestfs_rsync>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8353 +#: ../src/guestfs-actions.pod:8361 msgid "guestfs_rsync_in_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8355 +#: ../src/guestfs-actions.pod:8363 #, no-wrap msgid "" " int\n" @@ -43248,17 +43326,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8361 +#: ../src/guestfs-actions.pod:8369 msgid "This is the \"va_list variant\" of L</guestfs_rsync_in>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8365 +#: ../src/guestfs-actions.pod:8373 msgid "guestfs_rsync_in_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8367 +#: ../src/guestfs-actions.pod:8375 #, no-wrap msgid "" " int\n" @@ -43270,17 +43348,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8373 +#: ../src/guestfs-actions.pod:8381 msgid "This is the \"argv variant\" of L</guestfs_rsync_in>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8377 +#: ../src/guestfs-actions.pod:8385 msgid "guestfs_rsync_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8379 +#: ../src/guestfs-actions.pod:8387 #, no-wrap msgid "" " int\n" @@ -43292,7 +43370,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8390 +#: ../src/guestfs-actions.pod:8398 #, no-wrap msgid "" " GUESTFS_RSYNC_OUT_ARCHIVE, int archive,\n" @@ -43301,12 +43379,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8415 +#: ../src/guestfs-actions.pod:8423 msgid "guestfs_rsync_out_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8417 +#: ../src/guestfs-actions.pod:8425 #, no-wrap msgid "" " int\n" @@ -43318,17 +43396,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8423 +#: ../src/guestfs-actions.pod:8431 msgid "This is the \"va_list variant\" of L</guestfs_rsync_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8427 +#: ../src/guestfs-actions.pod:8435 msgid "guestfs_rsync_out_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8429 +#: ../src/guestfs-actions.pod:8437 #, no-wrap msgid "" " int\n" @@ -43340,17 +43418,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8435 +#: ../src/guestfs-actions.pod:8443 msgid "This is the \"argv variant\" of L</guestfs_rsync_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8439 +#: ../src/guestfs-actions.pod:8447 msgid "guestfs_scrub_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8441 +#: ../src/guestfs-actions.pod:8449 #, no-wrap msgid "" " int\n" @@ -43360,17 +43438,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8453 ../src/guestfs-actions.pod:8471 ../src/guestfs-actions.pod:8490 +#: ../src/guestfs-actions.pod:8461 ../src/guestfs-actions.pod:8479 ../src/guestfs-actions.pod:8498 msgid "(Added in 1.0.52)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8455 +#: ../src/guestfs-actions.pod:8463 msgid "guestfs_scrub_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8457 +#: ../src/guestfs-actions.pod:8465 #, no-wrap msgid "" " int\n" @@ -43380,12 +43458,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8473 +#: ../src/guestfs-actions.pod:8481 msgid "guestfs_scrub_freespace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8475 +#: ../src/guestfs-actions.pod:8483 #, no-wrap msgid "" " int\n" @@ -43395,7 +43473,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8479 +#: ../src/guestfs-actions.pod:8487 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>, " @@ -43404,12 +43482,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8492 +#: ../src/guestfs-actions.pod:8500 msgid "guestfs_set_append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8494 +#: ../src/guestfs-actions.pod:8502 #, no-wrap msgid "" " int\n" @@ -43419,12 +43497,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8511 +#: ../src/guestfs-actions.pod:8519 msgid "guestfs_set_attach_method" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8513 +#: ../src/guestfs-actions.pod:8521 #, no-wrap msgid "" " int\n" @@ -43434,12 +43512,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8574 +#: ../src/guestfs-actions.pod:8582 msgid "guestfs_set_autosync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8576 +#: ../src/guestfs-actions.pod:8584 #, no-wrap msgid "" " int\n" @@ -43449,12 +43527,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8592 +#: ../src/guestfs-actions.pod:8600 msgid "guestfs_set_direct" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8594 +#: ../src/guestfs-actions.pod:8602 #, no-wrap msgid "" " int\n" @@ -43464,7 +43542,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8602 +#: ../src/guestfs-actions.pod:8610 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 " @@ -43472,12 +43550,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8615 +#: ../src/guestfs-actions.pod:8623 msgid "guestfs_set_e2attrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8617 +#: ../src/guestfs-actions.pod:8625 #, no-wrap msgid "" " int\n" @@ -43489,7 +43567,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8628 +#: ../src/guestfs-actions.pod:8636 #, no-wrap msgid "" " GUESTFS_SET_E2ATTRS_CLEAR, int clear,\n" @@ -43497,7 +43575,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8633 +#: ../src/guestfs-actions.pod:8641 msgid "" "C<attrs> is a string of characters representing file attributes. See " "C<guestfs_get_e2attrs> for a list of possible attributes. Not all " @@ -43505,12 +43583,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8654 +#: ../src/guestfs-actions.pod:8662 msgid "guestfs_set_e2attrs_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8656 +#: ../src/guestfs-actions.pod:8664 #, no-wrap msgid "" " int\n" @@ -43522,17 +43600,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8662 +#: ../src/guestfs-actions.pod:8670 msgid "This is the \"va_list variant\" of L</guestfs_set_e2attrs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8666 +#: ../src/guestfs-actions.pod:8674 msgid "guestfs_set_e2attrs_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8668 +#: ../src/guestfs-actions.pod:8676 #, no-wrap msgid "" " int\n" @@ -43545,17 +43623,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8674 +#: ../src/guestfs-actions.pod:8682 msgid "This is the \"argv variant\" of L</guestfs_set_e2attrs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8678 +#: ../src/guestfs-actions.pod:8686 msgid "guestfs_set_e2generation" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8680 +#: ../src/guestfs-actions.pod:8688 #, no-wrap msgid "" " int\n" @@ -43566,17 +43644,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8687 +#: ../src/guestfs-actions.pod:8695 msgid "See C<guestfs_get_e2generation>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8693 +#: ../src/guestfs-actions.pod:8701 msgid "guestfs_set_e2label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8695 +#: ../src/guestfs-actions.pod:8703 #, no-wrap msgid "" " int\n" @@ -43587,26 +43665,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8700 +#: ../src/guestfs-actions.pod:8708 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_set_label> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8711 +#: ../src/guestfs-actions.pod:8719 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:8718 +#: ../src/guestfs-actions.pod:8726 msgid "guestfs_set_e2uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8720 +#: ../src/guestfs-actions.pod:8728 #, no-wrap msgid "" " int\n" @@ -43617,19 +43695,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8730 +#: ../src/guestfs-actions.pod:8738 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:8737 +#: ../src/guestfs-actions.pod:8745 msgid "guestfs_set_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8739 +#: ../src/guestfs-actions.pod:8747 #, no-wrap msgid "" " int\n" @@ -43640,17 +43718,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8753 +#: ../src/guestfs-actions.pod:8761 msgid "To read the label on a filesystem, call C<guestfs_vfs_label>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8759 +#: ../src/guestfs-actions.pod:8767 msgid "guestfs_set_memsize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8761 +#: ../src/guestfs-actions.pod:8769 #, no-wrap msgid "" " int\n" @@ -43660,19 +43738,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8765 +#: ../src/guestfs-actions.pod:8773 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:8780 +#: ../src/guestfs-actions.pod:8788 msgid "guestfs_set_network" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8782 +#: ../src/guestfs-actions.pod:8790 #, no-wrap msgid "" " int\n" @@ -43682,19 +43760,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8792 +#: ../src/guestfs-actions.pod:8800 msgid "" "You must call this before calling C<guestfs_launch>, otherwise it has no " "effect." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8799 +#: ../src/guestfs-actions.pod:8807 msgid "guestfs_set_path" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8801 +#: ../src/guestfs-actions.pod:8809 #, no-wrap msgid "" " int\n" @@ -43704,12 +43782,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8816 +#: ../src/guestfs-actions.pod:8824 msgid "guestfs_set_pgroup" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8818 +#: ../src/guestfs-actions.pod:8826 #, no-wrap msgid "" " int\n" @@ -43719,7 +43797,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8828 +#: ../src/guestfs-actions.pod:8836 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, " @@ -43728,12 +43806,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8837 +#: ../src/guestfs-actions.pod:8845 msgid "guestfs_set_qemu" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8839 +#: ../src/guestfs-actions.pod:8847 #, no-wrap msgid "" " int\n" @@ -43743,12 +43821,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8865 +#: ../src/guestfs-actions.pod:8873 msgid "guestfs_set_recovery_proc" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8867 +#: ../src/guestfs-actions.pod:8875 #, no-wrap msgid "" " int\n" @@ -43758,7 +43836,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8871 +#: ../src/guestfs-actions.pod:8879 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 " @@ -43767,19 +43845,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8876 +#: ../src/guestfs-actions.pod:8884 msgid "" "This only has any effect if called before C<guestfs_launch>, and the default " "is true." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8889 +#: ../src/guestfs-actions.pod:8897 msgid "guestfs_set_selinux" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8891 +#: ../src/guestfs-actions.pod:8899 #, no-wrap msgid "" " int\n" @@ -43789,12 +43867,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8908 +#: ../src/guestfs-actions.pod:8916 msgid "guestfs_set_smp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8910 +#: ../src/guestfs-actions.pod:8918 #, no-wrap msgid "" " int\n" @@ -43804,17 +43882,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8918 +#: ../src/guestfs-actions.pod:8926 msgid "This function must be called before C<guestfs_launch>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8924 +#: ../src/guestfs-actions.pod:8932 msgid "guestfs_set_trace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8926 +#: ../src/guestfs-actions.pod:8934 #, no-wrap msgid "" " int\n" @@ -43824,19 +43902,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8940 +#: ../src/guestfs-actions.pod:8948 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:8948 +#: ../src/guestfs-actions.pod:8956 msgid "guestfs_set_verbose" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8950 +#: ../src/guestfs-actions.pod:8958 #, no-wrap msgid "" " int\n" @@ -43846,19 +43924,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8959 +#: ../src/guestfs-actions.pod:8967 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:8967 +#: ../src/guestfs-actions.pod:8975 msgid "guestfs_setcon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8969 +#: ../src/guestfs-actions.pod:8977 #, no-wrap msgid "" " int\n" @@ -43868,12 +43946,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8982 +#: ../src/guestfs-actions.pod:8990 msgid "guestfs_setxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8984 +#: ../src/guestfs-actions.pod:8992 #, no-wrap msgid "" " int\n" @@ -43886,17 +43964,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8995 +#: ../src/guestfs-actions.pod:9003 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9001 +#: ../src/guestfs-actions.pod:9009 msgid "guestfs_sfdisk" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9003 +#: ../src/guestfs-actions.pod:9011 #, no-wrap msgid "" " int\n" @@ -43910,24 +43988,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9011 ../src/guestfs-actions.pod:9052 ../src/guestfs-actions.pod:9083 +#: ../src/guestfs-actions.pod:9019 ../src/guestfs-actions.pod:9060 ../src/guestfs-actions.pod:9091 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_part_add> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9038 +#: ../src/guestfs-actions.pod:9046 msgid "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9045 +#: ../src/guestfs-actions.pod:9053 msgid "guestfs_sfdiskM" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9047 +#: ../src/guestfs-actions.pod:9055 #, no-wrap msgid "" " int\n" @@ -43938,7 +44016,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9059 +#: ../src/guestfs-actions.pod:9067 msgid "" "This is a simplified interface to the C<guestfs_sfdisk> command, where " "partition sizes are specified in megabytes only (rounded to the nearest " @@ -43947,19 +44025,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9065 +#: ../src/guestfs-actions.pod:9073 msgid "" "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and " "C<guestfs_part_disk>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9072 +#: ../src/guestfs-actions.pod:9080 msgid "guestfs_sfdisk_N" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9074 +#: ../src/guestfs-actions.pod:9082 #, no-wrap msgid "" " int\n" @@ -43974,24 +44052,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9093 +#: ../src/guestfs-actions.pod:9101 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:9096 +#: ../src/guestfs-actions.pod:9104 msgid "See also: C<guestfs_part_add>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9102 +#: ../src/guestfs-actions.pod:9110 msgid "guestfs_sfdisk_disk_geometry" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9104 +#: ../src/guestfs-actions.pod:9112 #, no-wrap msgid "" " char *\n" @@ -44001,7 +44079,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9108 +#: ../src/guestfs-actions.pod:9116 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, " @@ -44010,12 +44088,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9121 +#: ../src/guestfs-actions.pod:9129 msgid "guestfs_sfdisk_kernel_geometry" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9123 +#: ../src/guestfs-actions.pod:9131 #, no-wrap msgid "" " char *\n" @@ -44025,12 +44103,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9137 +#: ../src/guestfs-actions.pod:9145 msgid "guestfs_sfdisk_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9139 +#: ../src/guestfs-actions.pod:9147 #, no-wrap msgid "" " char *\n" @@ -44040,24 +44118,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9143 +#: ../src/guestfs-actions.pod:9151 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_part_list> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9154 +#: ../src/guestfs-actions.pod:9162 msgid "See also: C<guestfs_part_list>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9161 +#: ../src/guestfs-actions.pod:9169 msgid "guestfs_sh" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9163 +#: ../src/guestfs-actions.pod:9171 #, no-wrap msgid "" " char *\n" @@ -44067,22 +44145,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9170 +#: ../src/guestfs-actions.pod:9178 msgid "This is like C<guestfs_command>, but passes the command to:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9178 +#: ../src/guestfs-actions.pod:9186 msgid "All the provisos about C<guestfs_command> apply to this call." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9185 +#: ../src/guestfs-actions.pod:9193 msgid "guestfs_sh_lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9187 +#: ../src/guestfs-actions.pod:9195 #, no-wrap msgid "" " char **\n" @@ -44092,24 +44170,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9191 +#: ../src/guestfs-actions.pod:9199 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:9194 +#: ../src/guestfs-actions.pod:9202 msgid "See also: C<guestfs_command_lines>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9202 +#: ../src/guestfs-actions.pod:9210 msgid "guestfs_shutdown" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9204 +#: ../src/guestfs-actions.pod:9212 #, no-wrap msgid "" " int\n" @@ -44118,7 +44196,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9207 +#: ../src/guestfs-actions.pod:9215 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 " @@ -44126,31 +44204,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9217 +#: ../src/guestfs-actions.pod:9225 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:9220 +#: ../src/guestfs-actions.pod:9228 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: textblock -#: ../src/guestfs-actions.pod:9225 +#: ../src/guestfs-actions.pod:9233 msgid "(Added in 1.19.16)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9227 +#: ../src/guestfs-actions.pod:9235 msgid "guestfs_sleep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9229 +#: ../src/guestfs-actions.pod:9237 #, no-wrap msgid "" " int\n" @@ -44160,17 +44238,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9237 +#: ../src/guestfs-actions.pod:9245 msgid "(Added in 1.0.41)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9239 ../src/guestfs-structs.pod:109 +#: ../src/guestfs-actions.pod:9247 ../src/guestfs-structs.pod:109 msgid "guestfs_stat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9241 +#: ../src/guestfs-actions.pod:9249 #, no-wrap msgid "" " struct guestfs_stat *\n" @@ -44180,12 +44258,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9255 ../src/guestfs-structs.pod:135 +#: ../src/guestfs-actions.pod:9263 ../src/guestfs-structs.pod:135 msgid "guestfs_statvfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9257 +#: ../src/guestfs-actions.pod:9265 #, no-wrap msgid "" " struct guestfs_statvfs *\n" @@ -44195,19 +44273,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9267 +#: ../src/guestfs-actions.pod:9275 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:9273 +#: ../src/guestfs-actions.pod:9281 msgid "guestfs_strings" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9275 +#: ../src/guestfs-actions.pod:9283 #, no-wrap msgid "" " char **\n" @@ -44217,12 +44295,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9291 +#: ../src/guestfs-actions.pod:9299 msgid "guestfs_strings_e" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9293 +#: ../src/guestfs-actions.pod:9301 #, no-wrap msgid "" " char **\n" @@ -44233,26 +44311,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9298 +#: ../src/guestfs-actions.pod:9306 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:9308 +#: ../src/guestfs-actions.pod:9316 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:9346 +#: ../src/guestfs-actions.pod:9354 msgid "guestfs_swapoff_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9348 +#: ../src/guestfs-actions.pod:9356 #, no-wrap msgid "" " int\n" @@ -44262,19 +44340,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9352 +#: ../src/guestfs-actions.pod:9360 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:9360 +#: ../src/guestfs-actions.pod:9368 msgid "guestfs_swapoff_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9362 +#: ../src/guestfs-actions.pod:9370 #, no-wrap msgid "" " int\n" @@ -44284,12 +44362,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9372 +#: ../src/guestfs-actions.pod:9380 msgid "guestfs_swapoff_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9374 +#: ../src/guestfs-actions.pod:9382 #, no-wrap msgid "" " int\n" @@ -44299,12 +44377,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9385 +#: ../src/guestfs-actions.pod:9393 msgid "guestfs_swapoff_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9387 +#: ../src/guestfs-actions.pod:9395 #, no-wrap msgid "" " int\n" @@ -44314,12 +44392,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9398 +#: ../src/guestfs-actions.pod:9406 msgid "guestfs_swapon_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9400 +#: ../src/guestfs-actions.pod:9408 #, no-wrap msgid "" " int\n" @@ -44329,7 +44407,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9404 +#: ../src/guestfs-actions.pod:9412 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 " @@ -44337,12 +44415,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9420 +#: ../src/guestfs-actions.pod:9428 msgid "guestfs_swapon_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9422 +#: ../src/guestfs-actions.pod:9430 #, no-wrap msgid "" " int\n" @@ -44352,19 +44430,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9426 +#: ../src/guestfs-actions.pod:9434 msgid "" "This command enables swap to a file. See C<guestfs_swapon_device> for other " "notes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9433 +#: ../src/guestfs-actions.pod:9441 msgid "guestfs_swapon_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9435 +#: ../src/guestfs-actions.pod:9443 #, no-wrap msgid "" " int\n" @@ -44374,19 +44452,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9439 +#: ../src/guestfs-actions.pod:9447 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:9446 +#: ../src/guestfs-actions.pod:9454 msgid "guestfs_swapon_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9448 +#: ../src/guestfs-actions.pod:9456 #, no-wrap msgid "" " int\n" @@ -44396,19 +44474,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9452 +#: ../src/guestfs-actions.pod:9460 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:9459 +#: ../src/guestfs-actions.pod:9467 msgid "guestfs_sync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9461 +#: ../src/guestfs-actions.pod:9469 #, no-wrap msgid "" " int\n" @@ -44417,12 +44495,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9474 +#: ../src/guestfs-actions.pod:9482 msgid "guestfs_tail" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9476 +#: ../src/guestfs-actions.pod:9484 #, no-wrap msgid "" " char **\n" @@ -44432,12 +44510,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9492 +#: ../src/guestfs-actions.pod:9500 msgid "guestfs_tail_n" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9494 +#: ../src/guestfs-actions.pod:9502 #, no-wrap msgid "" " char **\n" @@ -44448,12 +44526,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9516 +#: ../src/guestfs-actions.pod:9524 msgid "guestfs_tar_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9518 +#: ../src/guestfs-actions.pod:9526 #, no-wrap msgid "" " int\n" @@ -44464,7 +44542,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9523 +#: ../src/guestfs-actions.pod:9531 msgid "" "This function is provided for backwards compatibility with earlier versions " "of libguestfs. It simply calls L</guestfs_tar_in_opts> with no optional " @@ -44472,17 +44550,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9527 ../src/guestfs-actions.pod:9593 ../src/guestfs-actions.pod:9686 ../src/guestfs-actions.pod:9707 +#: ../src/guestfs-actions.pod:9535 ../src/guestfs-actions.pod:9601 ../src/guestfs-actions.pod:9694 ../src/guestfs-actions.pod:9715 msgid "(Added in 1.0.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9530 +#: ../src/guestfs-actions.pod:9538 msgid "guestfs_tar_in_opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9532 +#: ../src/guestfs-actions.pod:9540 #, no-wrap msgid "" " int\n" @@ -44494,7 +44572,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9543 +#: ../src/guestfs-actions.pod:9551 #, no-wrap msgid "" " GUESTFS_TAR_IN_OPTS_COMPRESS, const char *compress,\n" @@ -44502,17 +44580,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9556 ../src/guestfs-actions.pod:9641 +#: ../src/guestfs-actions.pod:9564 ../src/guestfs-actions.pod:9649 msgid "(Added in 1.19.30)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9558 +#: ../src/guestfs-actions.pod:9566 msgid "guestfs_tar_in_opts_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9560 +#: ../src/guestfs-actions.pod:9568 #, no-wrap msgid "" " int\n" @@ -44524,17 +44602,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9566 +#: ../src/guestfs-actions.pod:9574 msgid "This is the \"va_list variant\" of L</guestfs_tar_in_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9570 +#: ../src/guestfs-actions.pod:9578 msgid "guestfs_tar_in_opts_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9572 +#: ../src/guestfs-actions.pod:9580 #, no-wrap msgid "" " int\n" @@ -44547,17 +44625,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9578 +#: ../src/guestfs-actions.pod:9586 msgid "This is the \"argv variant\" of L</guestfs_tar_in_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9582 +#: ../src/guestfs-actions.pod:9590 msgid "guestfs_tar_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9584 +#: ../src/guestfs-actions.pod:9592 #, no-wrap msgid "" " int\n" @@ -44568,7 +44646,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9589 +#: ../src/guestfs-actions.pod:9597 msgid "" "This function is provided for backwards compatibility with earlier versions " "of libguestfs. It simply calls L</guestfs_tar_out_opts> with no optional " @@ -44576,12 +44654,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9596 +#: ../src/guestfs-actions.pod:9604 msgid "guestfs_tar_out_opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9598 +#: ../src/guestfs-actions.pod:9606 #, no-wrap msgid "" " int\n" @@ -44593,7 +44671,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9609 +#: ../src/guestfs-actions.pod:9617 #, no-wrap msgid "" " GUESTFS_TAR_OUT_OPTS_COMPRESS, const char *compress,\n" @@ -44603,12 +44681,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9643 +#: ../src/guestfs-actions.pod:9651 msgid "guestfs_tar_out_opts_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9645 +#: ../src/guestfs-actions.pod:9653 #, no-wrap msgid "" " int\n" @@ -44620,17 +44698,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9651 +#: ../src/guestfs-actions.pod:9659 msgid "This is the \"va_list variant\" of L</guestfs_tar_out_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9655 +#: ../src/guestfs-actions.pod:9663 msgid "guestfs_tar_out_opts_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9657 +#: ../src/guestfs-actions.pod:9665 #, no-wrap msgid "" " int\n" @@ -44643,17 +44721,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9663 +#: ../src/guestfs-actions.pod:9671 msgid "This is the \"argv variant\" of L</guestfs_tar_out_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9667 +#: ../src/guestfs-actions.pod:9675 msgid "guestfs_tgz_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9669 +#: ../src/guestfs-actions.pod:9677 #, no-wrap msgid "" " int\n" @@ -44664,19 +44742,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9674 ../src/guestfs-actions.pod:9910 +#: ../src/guestfs-actions.pod:9682 ../src/guestfs-actions.pod:9918 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_tar_in> call " "instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9688 +#: ../src/guestfs-actions.pod:9696 msgid "guestfs_tgz_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9690 +#: ../src/guestfs-actions.pod:9698 #, no-wrap msgid "" " int\n" @@ -44687,19 +44765,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9695 ../src/guestfs-actions.pod:9931 +#: ../src/guestfs-actions.pod:9703 ../src/guestfs-actions.pod:9939 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_tar_out> " "call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9709 +#: ../src/guestfs-actions.pod:9717 msgid "guestfs_touch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9711 +#: ../src/guestfs-actions.pod:9719 #, no-wrap msgid "" " int\n" @@ -44709,12 +44787,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9726 +#: ../src/guestfs-actions.pod:9734 msgid "guestfs_truncate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9728 +#: ../src/guestfs-actions.pod:9736 #, no-wrap msgid "" " int\n" @@ -44724,12 +44802,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9739 +#: ../src/guestfs-actions.pod:9747 msgid "guestfs_truncate_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9741 +#: ../src/guestfs-actions.pod:9749 #, no-wrap msgid "" " int\n" @@ -44740,7 +44818,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9749 +#: ../src/guestfs-actions.pod:9757 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 " @@ -44749,12 +44827,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9759 +#: ../src/guestfs-actions.pod:9767 msgid "guestfs_tune2fs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9761 +#: ../src/guestfs-actions.pod:9769 #, no-wrap msgid "" " int\n" @@ -44765,7 +44843,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9771 +#: ../src/guestfs-actions.pod:9779 #, no-wrap msgid "" " GUESTFS_TUNE2FS_FORCE, int force,\n" @@ -44782,7 +44860,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9851 +#: ../src/guestfs-actions.pod:9859 msgid "" "To get the current values of filesystem parameters, see " "C<guestfs_tune2fs_l>. For precise details of how tune2fs works, see the " @@ -44790,12 +44868,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9859 +#: ../src/guestfs-actions.pod:9867 msgid "guestfs_tune2fs_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9861 +#: ../src/guestfs-actions.pod:9869 #, no-wrap msgid "" " int\n" @@ -44806,17 +44884,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9866 +#: ../src/guestfs-actions.pod:9874 msgid "This is the \"va_list variant\" of L</guestfs_tune2fs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9870 +#: ../src/guestfs-actions.pod:9878 msgid "guestfs_tune2fs_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9872 +#: ../src/guestfs-actions.pod:9880 #, no-wrap msgid "" " int\n" @@ -44827,17 +44905,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9877 +#: ../src/guestfs-actions.pod:9885 msgid "This is the \"argv variant\" of L</guestfs_tune2fs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9881 +#: ../src/guestfs-actions.pod:9889 msgid "guestfs_tune2fs_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9883 +#: ../src/guestfs-actions.pod:9891 #, no-wrap msgid "" " char **\n" @@ -44847,12 +44925,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9903 +#: ../src/guestfs-actions.pod:9911 msgid "guestfs_txz_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9905 +#: ../src/guestfs-actions.pod:9913 #, no-wrap msgid "" " int\n" @@ -44863,12 +44941,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9924 +#: ../src/guestfs-actions.pod:9932 msgid "guestfs_txz_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9926 +#: ../src/guestfs-actions.pod:9934 #, no-wrap msgid "" " int\n" @@ -44879,12 +44957,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9945 +#: ../src/guestfs-actions.pod:9953 msgid "guestfs_umask" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9947 +#: ../src/guestfs-actions.pod:9955 #, no-wrap msgid "" " int\n" @@ -44894,19 +44972,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9963 +#: ../src/guestfs-actions.pod:9971 msgid "" "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, " "C<guestfs_mkdir>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9972 +#: ../src/guestfs-actions.pod:9980 msgid "guestfs_umount" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9974 +#: ../src/guestfs-actions.pod:9982 #, no-wrap msgid "" " int\n" @@ -44916,7 +44994,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9978 +#: ../src/guestfs-actions.pod:9986 msgid "" "This function is provided for backwards compatibility with earlier versions " "of libguestfs. It simply calls L</guestfs_umount_opts> with no optional " @@ -44924,12 +45002,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9985 +#: ../src/guestfs-actions.pod:9993 msgid "guestfs_umount_opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9987 +#: ../src/guestfs-actions.pod:9995 #, no-wrap msgid "" " int\n" @@ -44940,7 +45018,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9997 +#: ../src/guestfs-actions.pod:10005 #, no-wrap msgid "" " GUESTFS_UMOUNT_OPTS_FORCE, int force,\n" @@ -44949,17 +45027,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10006 +#: ../src/guestfs-actions.pod:10014 msgid "(Added in 1.19.25)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10008 +#: ../src/guestfs-actions.pod:10016 msgid "guestfs_umount_opts_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10010 +#: ../src/guestfs-actions.pod:10018 #, no-wrap msgid "" " int\n" @@ -44970,17 +45048,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10015 +#: ../src/guestfs-actions.pod:10023 msgid "This is the \"va_list variant\" of L</guestfs_umount_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10019 +#: ../src/guestfs-actions.pod:10027 msgid "guestfs_umount_opts_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10021 +#: ../src/guestfs-actions.pod:10029 #, no-wrap msgid "" " int\n" @@ -44992,17 +45070,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10026 +#: ../src/guestfs-actions.pod:10034 msgid "This is the \"argv variant\" of L</guestfs_umount_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10030 +#: ../src/guestfs-actions.pod:10038 msgid "guestfs_umount_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10032 +#: ../src/guestfs-actions.pod:10040 #, no-wrap msgid "" " int\n" @@ -45011,12 +45089,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10043 +#: ../src/guestfs-actions.pod:10051 msgid "guestfs_umount_local" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10045 +#: ../src/guestfs-actions.pod:10053 #, no-wrap msgid "" " int\n" @@ -45026,7 +45104,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10054 +#: ../src/guestfs-actions.pod:10062 #, no-wrap msgid "" " GUESTFS_UMOUNT_LOCAL_RETRY, int retry,\n" @@ -45034,12 +45112,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10065 +#: ../src/guestfs-actions.pod:10073 msgid "guestfs_umount_local_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10067 +#: ../src/guestfs-actions.pod:10075 #, no-wrap msgid "" " int\n" @@ -45049,17 +45127,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10071 +#: ../src/guestfs-actions.pod:10079 msgid "This is the \"va_list variant\" of L</guestfs_umount_local>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10075 +#: ../src/guestfs-actions.pod:10083 msgid "guestfs_umount_local_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10077 +#: ../src/guestfs-actions.pod:10085 #, no-wrap msgid "" " int\n" @@ -45070,17 +45148,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10081 +#: ../src/guestfs-actions.pod:10089 msgid "This is the \"argv variant\" of L</guestfs_umount_local>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10085 +#: ../src/guestfs-actions.pod:10093 msgid "guestfs_upload" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10087 +#: ../src/guestfs-actions.pod:10095 #, no-wrap msgid "" " int\n" @@ -45091,17 +45169,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10097 +#: ../src/guestfs-actions.pod:10105 msgid "See also C<guestfs_download>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10108 +#: ../src/guestfs-actions.pod:10116 msgid "guestfs_upload_offset" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10110 +#: ../src/guestfs-actions.pod:10118 #, no-wrap msgid "" " int\n" @@ -45113,7 +45191,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10126 +#: ../src/guestfs-actions.pod:10134 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 " @@ -45121,17 +45199,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10131 +#: ../src/guestfs-actions.pod:10139 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10142 +#: ../src/guestfs-actions.pod:10150 msgid "guestfs_utimens" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10144 +#: ../src/guestfs-actions.pod:10152 #, no-wrap msgid "" " int\n" @@ -45145,12 +45223,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10173 ../src/guestfs-structs.pod:368 +#: ../src/guestfs-actions.pod:10181 ../src/guestfs-structs.pod:368 msgid "guestfs_utsname" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10175 +#: ../src/guestfs-actions.pod:10183 #, no-wrap msgid "" " struct guestfs_utsname *\n" @@ -45159,24 +45237,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10182 +#: ../src/guestfs-actions.pod:10190 msgid "" "This function returns a C<struct guestfs_utsname *>, or NULL if there was an " "error. I<The caller must call C<guestfs_free_utsname> after use>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10186 +#: ../src/guestfs-actions.pod:10194 msgid "(Added in 1.19.27)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10188 ../src/guestfs-structs.pod:175 +#: ../src/guestfs-actions.pod:10196 ../src/guestfs-structs.pod:175 msgid "guestfs_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10190 +#: ../src/guestfs-actions.pod:10198 #, no-wrap msgid "" " struct guestfs_version *\n" @@ -45185,7 +45263,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10218 +#: ../src/guestfs-actions.pod:10226 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " @@ -45194,24 +45272,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10224 +#: ../src/guestfs-actions.pod:10232 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:10228 +#: ../src/guestfs-actions.pod:10236 msgid "(Added in 1.0.58)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10230 +#: ../src/guestfs-actions.pod:10238 msgid "guestfs_vfs_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10232 +#: ../src/guestfs-actions.pod:10240 #, no-wrap msgid "" " char *\n" @@ -45221,22 +45299,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10241 +#: ../src/guestfs-actions.pod:10249 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10246 ../src/guestfs-actions.pod:10283 +#: ../src/guestfs-actions.pod:10254 ../src/guestfs-actions.pod:10291 msgid "(Added in 1.3.18)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10248 +#: ../src/guestfs-actions.pod:10256 msgid "guestfs_vfs_type" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10250 +#: ../src/guestfs-actions.pod:10258 #, no-wrap msgid "" " char *\n" @@ -45246,12 +45324,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10267 +#: ../src/guestfs-actions.pod:10275 msgid "guestfs_vfs_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10269 +#: ../src/guestfs-actions.pod:10277 #, no-wrap msgid "" " char *\n" @@ -45261,17 +45339,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10278 +#: ../src/guestfs-actions.pod:10286 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10285 +#: ../src/guestfs-actions.pod:10293 msgid "guestfs_vg_activate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10287 +#: ../src/guestfs-actions.pod:10295 #, no-wrap msgid "" " int\n" @@ -45282,12 +45360,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10304 +#: ../src/guestfs-actions.pod:10312 msgid "guestfs_vg_activate_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10306 +#: ../src/guestfs-actions.pod:10314 #, no-wrap msgid "" " int\n" @@ -45297,12 +45375,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10319 +#: ../src/guestfs-actions.pod:10327 msgid "guestfs_vgchange_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10321 +#: ../src/guestfs-actions.pod:10329 #, no-wrap msgid "" " int\n" @@ -45312,12 +45390,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10331 +#: ../src/guestfs-actions.pod:10339 msgid "guestfs_vgchange_uuid_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10333 +#: ../src/guestfs-actions.pod:10341 #, no-wrap msgid "" " int\n" @@ -45326,12 +45404,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10342 +#: ../src/guestfs-actions.pod:10350 msgid "guestfs_vgcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10344 +#: ../src/guestfs-actions.pod:10352 #, no-wrap msgid "" " int\n" @@ -45342,12 +45420,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10356 +#: ../src/guestfs-actions.pod:10364 msgid "guestfs_vglvuuids" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10358 +#: ../src/guestfs-actions.pod:10366 #, no-wrap msgid "" " char **\n" @@ -45357,24 +45435,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10365 +#: ../src/guestfs-actions.pod:10373 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:10368 +#: ../src/guestfs-actions.pod:10376 msgid "See also C<guestfs_vgpvuuids>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10376 +#: ../src/guestfs-actions.pod:10384 msgid "guestfs_vgmeta" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10378 +#: ../src/guestfs-actions.pod:10386 #, no-wrap msgid "" " char *\n" @@ -45385,17 +45463,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10393 +#: ../src/guestfs-actions.pod:10401 msgid "(Added in 1.17.20)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10395 +#: ../src/guestfs-actions.pod:10403 msgid "guestfs_vgpvuuids" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10397 +#: ../src/guestfs-actions.pod:10405 #, no-wrap msgid "" " char **\n" @@ -45405,24 +45483,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10404 +#: ../src/guestfs-actions.pod:10412 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:10407 +#: ../src/guestfs-actions.pod:10415 msgid "See also C<guestfs_vglvuuids>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10415 +#: ../src/guestfs-actions.pod:10423 msgid "guestfs_vgremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10417 +#: ../src/guestfs-actions.pod:10425 #, no-wrap msgid "" " int\n" @@ -45432,12 +45510,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10430 +#: ../src/guestfs-actions.pod:10438 msgid "guestfs_vgrename" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10432 +#: ../src/guestfs-actions.pod:10440 #, no-wrap msgid "" " int\n" @@ -45448,12 +45526,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10443 +#: ../src/guestfs-actions.pod:10451 msgid "guestfs_vgs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10445 +#: ../src/guestfs-actions.pod:10453 #, no-wrap msgid "" " char **\n" @@ -45462,17 +45540,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10454 +#: ../src/guestfs-actions.pod:10462 msgid "See also C<guestfs_vgs_full>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10462 +#: ../src/guestfs-actions.pod:10470 msgid "guestfs_vgs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10464 +#: ../src/guestfs-actions.pod:10472 #, no-wrap msgid "" " struct guestfs_lvm_vg_list *\n" @@ -45481,7 +45559,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10470 +#: ../src/guestfs-actions.pod:10478 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 " @@ -45489,12 +45567,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10476 +#: ../src/guestfs-actions.pod:10484 msgid "guestfs_vgscan" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10478 +#: ../src/guestfs-actions.pod:10486 #, no-wrap msgid "" " int\n" @@ -45503,12 +45581,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10488 +#: ../src/guestfs-actions.pod:10496 msgid "guestfs_vguuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10490 +#: ../src/guestfs-actions.pod:10498 #, no-wrap msgid "" " char *\n" @@ -45518,12 +45596,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10501 +#: ../src/guestfs-actions.pod:10509 msgid "guestfs_wait_ready" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10503 +#: ../src/guestfs-actions.pod:10511 #, no-wrap msgid "" " int\n" @@ -45532,19 +45610,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10506 +#: ../src/guestfs-actions.pod:10514 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_launch> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10513 +#: ../src/guestfs-actions.pod:10521 msgid "This function is a no op." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10515 +#: ../src/guestfs-actions.pod:10523 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 " @@ -45552,19 +45630,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10520 +#: ../src/guestfs-actions.pod:10528 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:10528 +#: ../src/guestfs-actions.pod:10536 msgid "guestfs_wc_c" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10530 +#: ../src/guestfs-actions.pod:10538 #, no-wrap msgid "" " int\n" @@ -45574,12 +45652,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10541 +#: ../src/guestfs-actions.pod:10549 msgid "guestfs_wc_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10543 +#: ../src/guestfs-actions.pod:10551 #, no-wrap msgid "" " int\n" @@ -45589,12 +45667,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10554 +#: ../src/guestfs-actions.pod:10562 msgid "guestfs_wc_w" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10556 +#: ../src/guestfs-actions.pod:10564 #, no-wrap msgid "" " int\n" @@ -45604,12 +45682,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10567 +#: ../src/guestfs-actions.pod:10575 msgid "guestfs_wipefs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10569 +#: ../src/guestfs-actions.pod:10577 #, no-wrap msgid "" " int\n" @@ -45619,17 +45697,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10579 +#: ../src/guestfs-actions.pod:10587 msgid "Compare with C<guestfs_zero> which zeroes the first few blocks of a device." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10586 +#: ../src/guestfs-actions.pod:10594 msgid "guestfs_write" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10588 +#: ../src/guestfs-actions.pod:10596 #, no-wrap msgid "" " int\n" @@ -45641,17 +45719,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10597 +#: ../src/guestfs-actions.pod:10605 msgid "See also C<guestfs_write_append>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10603 +#: ../src/guestfs-actions.pod:10611 msgid "guestfs_write_append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10605 +#: ../src/guestfs-actions.pod:10613 #, no-wrap msgid "" " int\n" @@ -45663,17 +45741,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10614 +#: ../src/guestfs-actions.pod:10622 msgid "See also C<guestfs_write>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10620 +#: ../src/guestfs-actions.pod:10628 msgid "guestfs_write_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10622 +#: ../src/guestfs-actions.pod:10630 #, no-wrap msgid "" " int\n" @@ -45685,19 +45763,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10628 +#: ../src/guestfs-actions.pod:10636 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_write> call " "instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10653 +#: ../src/guestfs-actions.pod:10661 msgid "guestfs_xfs_admin" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10655 +#: ../src/guestfs-actions.pod:10663 #, no-wrap msgid "" " int\n" @@ -45708,7 +45786,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10665 +#: ../src/guestfs-actions.pod:10673 #, no-wrap msgid "" " GUESTFS_XFS_ADMIN_EXTUNWRITTEN, int extunwritten,\n" @@ -45722,19 +45800,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10679 +#: ../src/guestfs-actions.pod:10687 msgid "" "Some of the parameters of a mounted filesystem can be examined and modified " "using the C<guestfs_xfs_info> and C<guestfs_xfs_growfs> calls." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10685 +#: ../src/guestfs-actions.pod:10693 msgid "guestfs_xfs_admin_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10687 +#: ../src/guestfs-actions.pod:10695 #, no-wrap msgid "" " int\n" @@ -45745,17 +45823,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10692 +#: ../src/guestfs-actions.pod:10700 msgid "This is the \"va_list variant\" of L</guestfs_xfs_admin>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10696 +#: ../src/guestfs-actions.pod:10704 msgid "guestfs_xfs_admin_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10698 +#: ../src/guestfs-actions.pod:10706 #, no-wrap msgid "" " int\n" @@ -45766,17 +45844,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10703 +#: ../src/guestfs-actions.pod:10711 msgid "This is the \"argv variant\" of L</guestfs_xfs_admin>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10707 +#: ../src/guestfs-actions.pod:10715 msgid "guestfs_xfs_growfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10709 +#: ../src/guestfs-actions.pod:10717 #, no-wrap msgid "" " int\n" @@ -45787,7 +45865,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10719 +#: ../src/guestfs-actions.pod:10727 #, no-wrap msgid "" " GUESTFS_XFS_GROWFS_DATASEC, int datasec,\n" @@ -45802,12 +45880,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10738 +#: ../src/guestfs-actions.pod:10746 msgid "guestfs_xfs_growfs_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10740 +#: ../src/guestfs-actions.pod:10748 #, no-wrap msgid "" " int\n" @@ -45818,17 +45896,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10745 +#: ../src/guestfs-actions.pod:10753 msgid "This is the \"va_list variant\" of L</guestfs_xfs_growfs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10749 +#: ../src/guestfs-actions.pod:10757 msgid "guestfs_xfs_growfs_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10751 +#: ../src/guestfs-actions.pod:10759 #, no-wrap msgid "" " int\n" @@ -45839,17 +45917,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10756 +#: ../src/guestfs-actions.pod:10764 msgid "This is the \"argv variant\" of L</guestfs_xfs_growfs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10760 +#: ../src/guestfs-actions.pod:10768 msgid "guestfs_xfs_info" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10762 +#: ../src/guestfs-actions.pod:10770 #, no-wrap msgid "" " struct guestfs_xfsinfo *\n" @@ -45859,24 +45937,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10773 +#: ../src/guestfs-actions.pod:10781 msgid "" "This function returns a C<struct guestfs_xfsinfo *>, or NULL if there was an " "error. I<The caller must call C<guestfs_free_xfsinfo> after use>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10777 +#: ../src/guestfs-actions.pod:10785 msgid "(Added in 1.19.21)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10779 +#: ../src/guestfs-actions.pod:10787 msgid "guestfs_xfs_repair" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10781 +#: ../src/guestfs-actions.pod:10789 #, no-wrap msgid "" " int\n" @@ -45887,7 +45965,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10791 +#: ../src/guestfs-actions.pod:10799 #, no-wrap msgid "" " GUESTFS_XFS_REPAIR_FORCELOGZERO, int forcelogzero,\n" @@ -45904,12 +45982,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10818 +#: ../src/guestfs-actions.pod:10826 msgid "guestfs_xfs_repair_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10820 +#: ../src/guestfs-actions.pod:10828 #, no-wrap msgid "" " int\n" @@ -45920,17 +45998,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10825 +#: ../src/guestfs-actions.pod:10833 msgid "This is the \"va_list variant\" of L</guestfs_xfs_repair>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10829 +#: ../src/guestfs-actions.pod:10837 msgid "guestfs_xfs_repair_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10831 +#: ../src/guestfs-actions.pod:10839 #, no-wrap msgid "" " int\n" @@ -45941,17 +46019,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10836 +#: ../src/guestfs-actions.pod:10844 msgid "This is the \"argv variant\" of L</guestfs_xfs_repair>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10840 +#: ../src/guestfs-actions.pod:10848 msgid "guestfs_zegrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10842 +#: ../src/guestfs-actions.pod:10850 #, no-wrap msgid "" " char **\n" @@ -45962,12 +46040,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10866 +#: ../src/guestfs-actions.pod:10874 msgid "guestfs_zegrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10868 +#: ../src/guestfs-actions.pod:10876 #, no-wrap msgid "" " char **\n" @@ -45978,12 +46056,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10892 +#: ../src/guestfs-actions.pod:10900 msgid "guestfs_zero" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10894 +#: ../src/guestfs-actions.pod:10902 #, no-wrap msgid "" " int\n" @@ -45993,19 +46071,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10908 +#: ../src/guestfs-actions.pod:10916 msgid "" "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>, " "C<guestfs_is_zero_device>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10920 +#: ../src/guestfs-actions.pod:10928 msgid "guestfs_zero_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10922 +#: ../src/guestfs-actions.pod:10930 #, no-wrap msgid "" " int\n" @@ -46015,24 +46093,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10926 +#: ../src/guestfs-actions.pod:10934 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:10941 +#: ../src/guestfs-actions.pod:10949 msgid "(Added in 1.3.1)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10943 +#: ../src/guestfs-actions.pod:10951 msgid "guestfs_zero_free_space" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10945 +#: ../src/guestfs-actions.pod:10953 #, no-wrap msgid "" " int\n" @@ -46042,7 +46120,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10955 +#: ../src/guestfs-actions.pod:10963 msgid "" "Free space is not \"trimmed\". You may want to call C<guestfs_fstrim> " "either as an alternative to this, or after calling this, depending on your " @@ -46050,12 +46128,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10968 +#: ../src/guestfs-actions.pod:10976 msgid "guestfs_zerofree" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10970 +#: ../src/guestfs-actions.pod:10978 #, no-wrap msgid "" " int\n" @@ -46065,12 +46143,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10989 +#: ../src/guestfs-actions.pod:10997 msgid "guestfs_zfgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10991 +#: ../src/guestfs-actions.pod:10999 #, no-wrap msgid "" " char **\n" @@ -46081,12 +46159,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:11015 +#: ../src/guestfs-actions.pod:11023 msgid "guestfs_zfgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:11017 +#: ../src/guestfs-actions.pod:11025 #, no-wrap msgid "" " char **\n" @@ -46097,12 +46175,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:11041 +#: ../src/guestfs-actions.pod:11049 msgid "guestfs_zfile" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:11043 +#: ../src/guestfs-actions.pod:11051 #, no-wrap msgid "" " char *\n" @@ -46113,26 +46191,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:11048 +#: ../src/guestfs-actions.pod:11056 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_file> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:11060 +#: ../src/guestfs-actions.pod:11068 msgid "" "Since 1.0.63, use C<guestfs_file> instead which can now process compressed " "files." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:11068 +#: ../src/guestfs-actions.pod:11076 msgid "guestfs_zgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:11070 +#: ../src/guestfs-actions.pod:11078 #, no-wrap msgid "" " char **\n" @@ -46143,12 +46221,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:11094 +#: ../src/guestfs-actions.pod:11102 msgid "guestfs_zgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:11096 +#: ../src/guestfs-actions.pod:11104 #, no-wrap msgid "" " char **\n" @@ -47290,13 +47368,21 @@ msgid "" "LANGUAGES> below." msgstr "" -#. type: =head1 +#. type: textblock #: ../src/guestfs.pod:41 +msgid "" +"If you are having performance problems, read L<guestfs-performance(1)>. To " +"help test libguestfs, read L<libguestfs-test-tool(1)> and " +"L<guestfs-testing(1)>." +msgstr "" + +#. type: =head1 +#: ../src/guestfs.pod:45 msgid "API OVERVIEW" msgstr "" #. type: textblock -#: ../src/guestfs.pod:43 +#: ../src/guestfs.pod:47 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 " @@ -47304,12 +47390,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:48 +#: ../src/guestfs.pod:52 msgid "HANDLES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:50 +#: ../src/guestfs.pod:54 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 " @@ -47319,12 +47405,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:57 +#: ../src/guestfs.pod:61 msgid "The general structure of all libguestfs-using programs looks like this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:60 +#: ../src/guestfs.pod:64 #, no-wrap msgid "" " guestfs_h *g = guestfs_create ();\n" @@ -47332,7 +47418,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:62 +#: ../src/guestfs.pod:66 #, no-wrap msgid "" " /* Call guestfs_add_drive additional times if there are\n" @@ -47343,7 +47429,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:67 +#: ../src/guestfs.pod:71 #, no-wrap msgid "" " /* Most manipulation calls won't work until you've launched\n" @@ -47355,7 +47441,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:73 +#: ../src/guestfs.pod:77 #, no-wrap msgid "" " /* Now you can examine what partitions, LVs etc are available.\n" @@ -47366,7 +47452,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:78 +#: ../src/guestfs.pod:82 #, no-wrap msgid "" " /* To access a filesystem in the image, you must mount it.\n" @@ -47376,7 +47462,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:82 +#: ../src/guestfs.pod:86 #, no-wrap msgid "" " /* Now you can perform filesystem actions on the guest\n" @@ -47387,7 +47473,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:87 +#: ../src/guestfs.pod:91 #, no-wrap msgid "" " /* Synchronize the disk. This is the opposite of guestfs_launch. */\n" @@ -47396,7 +47482,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:90 +#: ../src/guestfs.pod:94 #, no-wrap msgid "" " /* Close and free the handle 'g'. */\n" @@ -47405,7 +47491,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:93 +#: ../src/guestfs.pod:97 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 " @@ -47417,12 +47503,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:102 +#: ../src/guestfs.pod:106 msgid "DISK IMAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:104 +#: ../src/guestfs.pod:108 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 " @@ -47432,7 +47518,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:110 +#: ../src/guestfs.pod:114 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 " @@ -47440,7 +47526,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:114 +#: ../src/guestfs.pod:118 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -47450,12 +47536,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:118 +#: ../src/guestfs.pod:122 msgid "You can add a disk read-only using:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:120 +#: ../src/guestfs.pod:124 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -47466,14 +47552,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:125 +#: ../src/guestfs.pod:129 msgid "" "or by calling the older function L</guestfs_add_drive_ro>. In either case " "libguestfs won't modify the file. (See also L</DISK IMAGE FORMATS> below)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:129 +#: ../src/guestfs.pod:133 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 " @@ -47481,7 +47567,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:133 +#: ../src/guestfs.pod:137 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 " @@ -47489,7 +47575,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:138 +#: ../src/guestfs.pod:142 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 " @@ -47497,12 +47583,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:143 +#: ../src/guestfs.pod:147 msgid "MOUNTING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:145 +#: ../src/guestfs.pod:149 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 " @@ -47512,7 +47598,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:152 +#: ../src/guestfs.pod:156 #, no-wrap msgid "" " guestfs_mount (g, \"/dev/sda1\", \"/\");\n" @@ -47520,7 +47606,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:154 +#: ../src/guestfs.pod:158 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 " @@ -47530,7 +47616,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:160 +#: ../src/guestfs.pod:164 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 " @@ -47541,7 +47627,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:168 +#: ../src/guestfs.pod:172 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 " @@ -47549,19 +47635,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:173 +#: ../src/guestfs.pod:177 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:176 +#: ../src/guestfs.pod:180 msgid "FILESYSTEM ACCESS AND MODIFICATION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:178 +#: ../src/guestfs.pod:182 msgid "" "The majority of the libguestfs API consists of fairly low-level calls for " "accessing and modifying the files, directories, symlinks etc on mounted " @@ -47571,21 +47657,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:184 +#: ../src/guestfs.pod:188 msgid "" "Specify filenames as full paths, starting with C<\"/\"> and including the " "mount point." msgstr "" #. type: textblock -#: ../src/guestfs.pod:187 +#: ../src/guestfs.pod:191 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:190 +#: ../src/guestfs.pod:194 #, no-wrap msgid "" " char *data = guestfs_cat (g, \"/etc/passwd\");\n" @@ -47593,7 +47679,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:192 +#: ../src/guestfs.pod:196 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), " @@ -47601,14 +47687,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:196 +#: ../src/guestfs.pod:200 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:199 +#: ../src/guestfs.pod:203 #, no-wrap msgid "" " guestfs_mkdir (g, \"/var\");\n" @@ -47616,12 +47702,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:201 +#: ../src/guestfs.pod:205 msgid "To create a symlink you could do:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:203 +#: ../src/guestfs.pod:207 #, no-wrap msgid "" " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n" @@ -47630,14 +47716,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:206 +#: ../src/guestfs.pod:210 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:209 +#: ../src/guestfs.pod:213 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 " @@ -47647,40 +47733,40 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:215 +#: ../src/guestfs.pod:219 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: textblock -#: ../src/guestfs.pod:218 +#: ../src/guestfs.pod:222 msgid "" "Since libguestfs 1.18, it is possible to mount the libguestfs filesystem on " "a local directory, subject to some restrictions. See L</MOUNT LOCAL> below." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:222 +#: ../src/guestfs.pod:226 msgid "PARTITIONING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:224 +#: ../src/guestfs.pod:228 msgid "" "Libguestfs contains API calls to read, create and modify partition tables on " "disk images." msgstr "" #. type: textblock -#: ../src/guestfs.pod:227 +#: ../src/guestfs.pod:231 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:231 +#: ../src/guestfs.pod:235 #, no-wrap msgid "" " const char *parttype = \"mbr\";\n" @@ -47691,19 +47777,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:236 +#: ../src/guestfs.pod:240 msgid "" "Obviously this effectively wipes anything that was on that disk image " "before." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:239 +#: ../src/guestfs.pod:243 msgid "LVM2" msgstr "" #. type: textblock -#: ../src/guestfs.pod:241 +#: ../src/guestfs.pod:245 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 " @@ -47712,19 +47798,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:246 +#: ../src/guestfs.pod:250 msgid "" "This author strongly recommends reading the LVM HOWTO, online at " "L<http://tldp.org/HOWTO/LVM-HOWTO/>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:249 +#: ../src/guestfs.pod:253 msgid "DOWNLOADING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:251 +#: ../src/guestfs.pod:255 msgid "" "Use L</guestfs_cat> to download small, text only files. This call cannot " "handle files contain any ASCII NUL (C<\\0>) characters. However the API is " @@ -47732,38 +47818,38 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:255 +#: ../src/guestfs.pod:259 msgid "" "L</guestfs_read_file> can be used to read files which contain arbitrary 8 " "bit data, since it returns a (pointer, size) pair." msgstr "" #. type: textblock -#: ../src/guestfs.pod:258 +#: ../src/guestfs.pod:262 msgid "" "L</guestfs_download> can be used to download any file, with no limits on " "content or size." msgstr "" #. type: textblock -#: ../src/guestfs.pod:261 +#: ../src/guestfs.pod:265 msgid "To download multiple files, see L</guestfs_tar_out> and L</guestfs_tgz_out>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:264 +#: ../src/guestfs.pod:268 msgid "UPLOADING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:266 +#: ../src/guestfs.pod:270 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:269 +#: ../src/guestfs.pod:273 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 " @@ -47773,19 +47859,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:275 +#: ../src/guestfs.pod:279 msgid "" "To upload a single file, use L</guestfs_upload>. This call has no limits on " "file content or size." msgstr "" #. type: textblock -#: ../src/guestfs.pod:278 +#: ../src/guestfs.pod:282 msgid "To upload multiple files, see L</guestfs_tar_in> and L</guestfs_tgz_in>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:280 +#: ../src/guestfs.pod:284 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 " @@ -47799,12 +47885,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:291 +#: ../src/guestfs.pod:295 msgid "COPYING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:293 +#: ../src/guestfs.pod:297 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 " @@ -47812,51 +47898,51 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:299 +#: ../src/guestfs.pod:303 msgid "B<file> to B<file>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:301 +#: ../src/guestfs.pod:305 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:304 +#: ../src/guestfs.pod:308 msgid "To copy part of a file (offset and size) use L</guestfs_copy_file_to_file>." msgstr "" #. type: =item -#: ../src/guestfs.pod:307 +#: ../src/guestfs.pod:311 msgid "B<file> to B<device>" msgstr "" #. type: =item -#: ../src/guestfs.pod:309 +#: ../src/guestfs.pod:313 msgid "B<device> to B<file>" msgstr "" #. type: =item -#: ../src/guestfs.pod:311 +#: ../src/guestfs.pod:315 msgid "B<device> to B<device>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:313 +#: ../src/guestfs.pod:317 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:316 +#: ../src/guestfs.pod:320 msgid "Example: duplicate the contents of an LV:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:318 +#: ../src/guestfs.pod:322 #, no-wrap msgid "" " guestfs_copy_device_to_device (g,\n" @@ -47867,7 +47953,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:323 +#: ../src/guestfs.pod:327 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 " @@ -47875,7 +47961,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:327 +#: ../src/guestfs.pod:331 #, no-wrap msgid "" " guestfs_copy_device_to_device (g,\n" @@ -47886,32 +47972,32 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:332 +#: ../src/guestfs.pod:336 msgid "B<file on the host> to B<file or device>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:334 +#: ../src/guestfs.pod:338 msgid "Use L</guestfs_upload>. See L</UPLOADING> above." msgstr "" #. type: =item -#: ../src/guestfs.pod:336 +#: ../src/guestfs.pod:340 msgid "B<file or device> to B<file on the host>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:338 +#: ../src/guestfs.pod:342 msgid "Use L</guestfs_download>. See L</DOWNLOADING> above." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:342 +#: ../src/guestfs.pod:346 msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:344 +#: ../src/guestfs.pod:348 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 " @@ -47922,12 +48008,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:352 +#: ../src/guestfs.pod:356 msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:355 +#: ../src/guestfs.pod:359 #, no-wrap msgid "" " guestfs_download (g, filename, \"/dev/stdout\");\n" @@ -47935,12 +48021,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:357 +#: ../src/guestfs.pod:361 msgid "and you can write tar output to a file descriptor C<fd> by doing:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:359 +#: ../src/guestfs.pod:363 #, no-wrap msgid "" " char devfd[64];\n" @@ -47950,26 +48036,26 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:363 +#: ../src/guestfs.pod:367 msgid "LISTING FILES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:365 +#: ../src/guestfs.pod:369 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:368 +#: ../src/guestfs.pod:372 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:371 +#: ../src/guestfs.pod:375 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 " @@ -47977,19 +48063,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:375 +#: ../src/guestfs.pod:379 msgid "" "L</guestfs_find> and L</guestfs_find0> can be used to recursively list " "files." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:378 +#: ../src/guestfs.pod:382 msgid "RUNNING COMMANDS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:380 +#: ../src/guestfs.pod:384 msgid "" "Although libguestfs is primarily an API for manipulating files inside guest " "images, we also provide some limited facilities for running commands inside " @@ -47997,55 +48083,55 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:384 +#: ../src/guestfs.pod:388 msgid "There are many limitations to this:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:390 +#: ../src/guestfs.pod:394 msgid "" "The kernel version that the command runs under will be different from what " "it expects." msgstr "" #. type: textblock -#: ../src/guestfs.pod:395 +#: ../src/guestfs.pod:399 msgid "" "If the command needs to communicate with daemons, then most likely they " "won't be running." msgstr "" #. type: textblock -#: ../src/guestfs.pod:400 +#: ../src/guestfs.pod:404 msgid "The command will be running in limited memory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:404 +#: ../src/guestfs.pod:408 msgid "" "The network may not be available unless you enable it (see " "L</guestfs_set_network>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:409 +#: ../src/guestfs.pod:413 msgid "Only supports Linux guests (not Windows, BSD, etc)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:413 +#: ../src/guestfs.pod:417 msgid "Architecture limitations (eg. won't work for a PPC guest on an X86 host)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:418 +#: ../src/guestfs.pod:422 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:423 +#: ../src/guestfs.pod:427 msgid "" "I<Security:> It is not safe to run commands from untrusted, possibly " "malicious guests. These commands may attempt to exploit your program by " @@ -48057,7 +48143,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:432 +#: ../src/guestfs.pod:436 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 " @@ -48067,26 +48153,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:440 +#: ../src/guestfs.pod:444 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:443 +#: ../src/guestfs.pod:447 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:446 +#: ../src/guestfs.pod:450 msgid "CONFIGURATION FILES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:448 +#: ../src/guestfs.pod:452 msgid "" "To read and write configuration files in Linux guest filesystems, we " "strongly recommend using Augeas. For example, Augeas understands how to " @@ -48095,7 +48181,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:453 +#: ../src/guestfs.pod:457 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 " @@ -48103,7 +48189,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:457 +#: ../src/guestfs.pod:461 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 " @@ -48111,24 +48197,24 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:461 +#: ../src/guestfs.pod:465 msgid "SELINUX" msgstr "" #. type: textblock -#: ../src/guestfs.pod:463 +#: ../src/guestfs.pod:467 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:471 +#: ../src/guestfs.pod:475 msgid "Before launching, do:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:473 +#: ../src/guestfs.pod:477 #, no-wrap msgid "" " guestfs_set_selinux (g, 1);\n" @@ -48136,14 +48222,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:477 +#: ../src/guestfs.pod:481 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:481 +#: ../src/guestfs.pod:485 #, no-wrap msgid "" " guestfs_sh (g, \"/usr/sbin/load_policy\");\n" @@ -48151,21 +48237,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:483 +#: ../src/guestfs.pod:487 msgid "" "(Older versions of C<load_policy> require you to specify the name of the " "policy file)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:488 +#: ../src/guestfs.pod:492 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:492 +#: ../src/guestfs.pod:496 #, no-wrap msgid "" " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n" @@ -48173,24 +48259,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:496 +#: ../src/guestfs.pod:500 msgid "This will work for running commands and editing existing files." msgstr "" #. type: textblock -#: ../src/guestfs.pod:498 +#: ../src/guestfs.pod:502 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:502 +#: ../src/guestfs.pod:506 msgid "UMASK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:504 +#: ../src/guestfs.pod:508 msgid "" "Certain calls are affected by the current file mode creation mask (the " "\"umask\"). In particular ones which create files or directories, such as " @@ -48200,14 +48286,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:510 +#: ../src/guestfs.pod:514 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:513 +#: ../src/guestfs.pod:517 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 " @@ -48215,12 +48301,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:517 +#: ../src/guestfs.pod:521 msgid "For more information about umask, see L<umask(2)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:521 +#: ../src/guestfs.pod:525 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) " @@ -48229,21 +48315,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:527 +#: ../src/guestfs.pod:531 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:530 +#: ../src/guestfs.pod:534 msgid "" "Then open these devices by calling L</guestfs_luks_open>. Obviously you " "will require the passphrase!" msgstr "" #. type: textblock -#: ../src/guestfs.pod:533 +#: ../src/guestfs.pod:537 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 " @@ -48252,7 +48338,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:539 +#: ../src/guestfs.pod:543 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 " @@ -48260,7 +48346,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:543 +#: ../src/guestfs.pod:547 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, " @@ -48270,19 +48356,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:550 +#: ../src/guestfs.pod:554 msgid "MOUNT LOCAL" msgstr "" #. type: textblock -#: ../src/guestfs.pod:552 +#: ../src/guestfs.pod:556 msgid "" "In libguestfs E<ge> 1.18, it is possible to mount the libguestfs filesystem " "on a local directory and access it using ordinary POSIX calls and programs." msgstr "" #. type: textblock -#: ../src/guestfs.pod:556 +#: ../src/guestfs.pod:560 msgid "" "Availability of this is subject to a number of restrictions: it requires " "FUSE (the Filesystem in USErspace), and libfuse must also have been " @@ -48293,7 +48379,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:563 +#: ../src/guestfs.pod:567 msgid "" "The call to mount the libguestfs filesystem on a local directory is " "L</guestfs_mount_local> (q.v.) followed by L</guestfs_mount_local_run>. The " @@ -48306,7 +48392,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:573 +#: ../src/guestfs.pod:577 msgid "" "L</guestfs_mount_local> needs a certain amount of time to set up the " "mountpoint. The mountpoint is not ready to use until the call returns. At " @@ -48317,12 +48403,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:581 +#: ../src/guestfs.pod:585 msgid "MOUNT LOCAL COMPATIBILITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:583 +#: ../src/guestfs.pod:587 msgid "" "Since local mounting was only added in libguestfs 1.18, and may not be " "available even in these builds, you should consider writing code so that it " @@ -48331,7 +48417,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:588 +#: ../src/guestfs.pod:592 msgid "" "If libguestfs was compiled without support for L</guestfs_mount_local> then " "calling it will return an error with errno set to C<ENOTSUP> (see " @@ -48339,12 +48425,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:592 +#: ../src/guestfs.pod:596 msgid "MOUNT LOCAL PERFORMANCE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:594 +#: ../src/guestfs.pod:598 msgid "" "Libguestfs on top of FUSE performs quite poorly. For best performance do " "not use it. Use ordinary libguestfs filesystem calls, upload, download " @@ -48352,12 +48438,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:598 +#: ../src/guestfs.pod:602 msgid "INSPECTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:600 +#: ../src/guestfs.pod:604 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 " @@ -48367,14 +48453,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:607 +#: ../src/guestfs.pod:611 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:610 +#: ../src/guestfs.pod:614 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 " @@ -48387,7 +48473,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:619 +#: ../src/guestfs.pod:623 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 " @@ -48396,7 +48482,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:625 +#: ../src/guestfs.pod:629 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 " @@ -48407,7 +48493,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:632 +#: ../src/guestfs.pod:636 #, no-wrap msgid "" " /boot => /dev/sda1\n" @@ -48417,14 +48503,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:636 +#: ../src/guestfs.pod:640 msgid "" "The caller can then make calls to L</guestfs_mount> to mount the filesystems " "as suggested." msgstr "" #. type: textblock -#: ../src/guestfs.pod:639 +#: ../src/guestfs.pod:643 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 " @@ -48432,7 +48518,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:643 +#: ../src/guestfs.pod:647 msgid "" "Inspection currently only works for some common operating systems. " "Contributors are welcome to send patches for other operating systems that we " @@ -48440,7 +48526,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:647 +#: ../src/guestfs.pod:651 msgid "" "Encrypted disks must be opened before inspection. See L</ENCRYPTED DISKS> " "for more details. The L</guestfs_inspect_os> function just ignores any " @@ -48448,7 +48534,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:651 +#: ../src/guestfs.pod:655 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 " @@ -48461,19 +48547,19 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:660 +#: ../src/guestfs.pod:664 msgid "INSPECTING INSTALL DISKS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:662 +#: ../src/guestfs.pod:666 msgid "" "Libguestfs (since 1.9.4) can detect some install disks, install CDs, live " "CDs and more." msgstr "" #. type: textblock -#: ../src/guestfs.pod:665 +#: ../src/guestfs.pod:669 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 " @@ -48481,7 +48567,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:669 +#: ../src/guestfs.pod:673 msgid "" "Further information is available about the operating system that can be " "installed using the regular inspection APIs like " @@ -48490,7 +48576,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:674 +#: ../src/guestfs.pod:678 msgid "" "Some additional information specific to installer disks is also available " "from the L</guestfs_inspect_is_live>, L</guestfs_inspect_is_netinst> and " @@ -48498,24 +48584,24 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:679 +#: ../src/guestfs.pod:683 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:681 +#: ../src/guestfs.pod:685 msgid "" "Libguestfs can mount NTFS partitions. It does this using the " "L<http://www.ntfs-3g.org/> driver." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:684 +#: ../src/guestfs.pod:688 msgid "DRIVE LETTERS AND PATHS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:686 +#: ../src/guestfs.pod:690 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 " @@ -48525,14 +48611,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:692 +#: ../src/guestfs.pod:696 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:695 +#: ../src/guestfs.pod:699 msgid "" "Dealing with separator characters (backslash vs forward slash) is outside " "the scope of libguestfs, but usually a simple character replacement will " @@ -48540,33 +48626,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:699 +#: ../src/guestfs.pod:703 msgid "" "To resolve the case insensitivity of paths, call " "L</guestfs_case_sensitive_path>." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:702 +#: ../src/guestfs.pod:706 msgid "LONG FILENAMES ON NTFS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:704 +#: ../src/guestfs.pod:708 msgid "" "NTFS supports filenames up to 255 characters long. \"Character\" means a 2 " "byte UTF-16 codepoint which can encode the most common Unicode codepoints." msgstr "" #. type: textblock -#: ../src/guestfs.pod:708 +#: ../src/guestfs.pod:712 msgid "" "Most Linux filesystems support filenames up to 255 I<bytes>. This means you " "may get an error:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:711 +#: ../src/guestfs.pod:715 #, no-wrap msgid "" " File name too long\n" @@ -48574,14 +48660,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:713 +#: ../src/guestfs.pod:717 msgid "" "when you copy a file from NTFS to a Linux filesystem if the name, when " "reencoded as UTF-8, would exceed 255 bytes in length." msgstr "" #. type: textblock -#: ../src/guestfs.pod:716 +#: ../src/guestfs.pod:720 msgid "" "This will most often happen when using non-ASCII names that are longer than " "~127 characters (eg. Greek, Cyrillic) or longer than ~85 characters (Asian " @@ -48589,7 +48675,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:720 +#: ../src/guestfs.pod:724 msgid "" "A workaround is not to try to store such long filenames on Linux native " "filesystems. Since the L<tar(1)> format can store unlimited length " @@ -48597,19 +48683,19 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:724 +#: ../src/guestfs.pod:728 msgid "ACCESSING THE WINDOWS REGISTRY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:726 +#: ../src/guestfs.pod:730 msgid "" "Libguestfs also provides some help for decoding Windows Registry \"hive\" " "files, through a separate C library called L<hivex(3)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:729 +#: ../src/guestfs.pod:733 msgid "" "Before libguestfs 1.19.35 you had to download the hive file, operate on it " "locally using hivex, and upload it again. Since this version, we have " @@ -48619,17 +48705,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:735 +#: ../src/guestfs.pod:739 msgid "See also L<virt-win-reg(1)>." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:737 +#: ../src/guestfs.pod:741 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:739 +#: ../src/guestfs.pod:743 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 " @@ -48637,12 +48723,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:743 +#: ../src/guestfs.pod:747 msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-symbolic-links/>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:745 +#: ../src/guestfs.pod:749 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 " @@ -48652,7 +48738,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:752 +#: ../src/guestfs.pod:756 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 " @@ -48661,36 +48747,36 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:757 +#: ../src/guestfs.pod:761 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:759 +#: ../src/guestfs.pod:763 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:762 +#: ../src/guestfs.pod:766 msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:764 +#: ../src/guestfs.pod:768 msgid "RESIZE2FS ERRORS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:766 +#: ../src/guestfs.pod:770 msgid "" "The L</guestfs_resize2fs>, L</guestfs_resize2fs_size> and " "L</guestfs_resize2fs_M> calls are used to resize ext2/3/4 filesystems." msgstr "" #. type: textblock -#: ../src/guestfs.pod:769 +#: ../src/guestfs.pod:773 msgid "" "The underlying program (L<resize2fs(8)>) requires that the filesystem is " "clean and recently fsck'd before you can resize it. Also, if the resize " @@ -48699,7 +48785,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:774 +#: ../src/guestfs.pod:778 msgid "" "In libguestfs C<lt> 1.17.14, you usually had to call L</guestfs_e2fsck_f> " "before the resize. However, in C<ge> 1.17.14, L<e2fsck(8)> is called " @@ -48707,14 +48793,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:779 +#: ../src/guestfs.pod:783 msgid "" "The L<resize2fs(8)> program can still fail, in which case it prints an error " "message similar to:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:782 +#: ../src/guestfs.pod:786 #, no-wrap msgid "" " Please run 'e2fsck -fy <device>' to fix the filesystem\n" @@ -48723,7 +48809,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:785 +#: ../src/guestfs.pod:789 msgid "" "You can do this by calling L</guestfs_e2fsck> with the C<forceall> option. " "However in the context of disk images, it is usually better to avoid this " @@ -48732,19 +48818,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:790 +#: ../src/guestfs.pod:794 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:792 +#: ../src/guestfs.pod:796 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:795 +#: ../src/guestfs.pod:799 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)> " @@ -48754,14 +48840,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:801 +#: ../src/guestfs.pod:805 msgid "" "Error messages are automatically transformed into exceptions if the language " "supports it." msgstr "" #. type: textblock -#: ../src/guestfs.pod:804 +#: ../src/guestfs.pod:808 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 " @@ -48769,58 +48855,58 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:810 +#: ../src/guestfs.pod:814 msgid "B<C++>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:812 +#: ../src/guestfs.pod:816 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:816 +#: ../src/guestfs.pod:820 msgid "B<C#>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:818 +#: ../src/guestfs.pod:822 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:821 +#: ../src/guestfs.pod:825 msgid "B<Erlang>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:823 +#: ../src/guestfs.pod:827 msgid "See L<guestfs-erlang(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:825 +#: ../src/guestfs.pod:829 msgid "B<GObject>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:827 +#: ../src/guestfs.pod:831 msgid "" "Experimental GObject bindings (with GObject Introspection support) are " "available. See the C<gobject> directory in the source." msgstr "" #. type: =item -#: ../src/guestfs.pod:830 +#: ../src/guestfs.pod:834 msgid "B<Haskell>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:832 +#: ../src/guestfs.pod:836 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 " @@ -48828,96 +48914,96 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:836 +#: ../src/guestfs.pod:840 msgid "B<Java>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:838 +#: ../src/guestfs.pod:842 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:841 +#: ../src/guestfs.pod:845 msgid "B<OCaml>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:843 +#: ../src/guestfs.pod:847 msgid "See L<guestfs-ocaml(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:845 +#: ../src/guestfs.pod:849 msgid "B<Perl>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:847 +#: ../src/guestfs.pod:851 msgid "See L<guestfs-perl(3)> and L<Sys::Guestfs(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:849 +#: ../src/guestfs.pod:853 msgid "B<PHP>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:851 +#: ../src/guestfs.pod:855 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:854 +#: ../src/guestfs.pod:858 msgid "The PHP binding only works correctly on 64 bit machines." msgstr "" #. type: =item -#: ../src/guestfs.pod:856 +#: ../src/guestfs.pod:860 msgid "B<Python>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:858 +#: ../src/guestfs.pod:862 msgid "See L<guestfs-python(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:860 +#: ../src/guestfs.pod:864 msgid "B<Ruby>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:862 +#: ../src/guestfs.pod:866 msgid "See L<guestfs-ruby(3)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:864 +#: ../src/guestfs.pod:868 msgid "For JRuby, use the Java bindings." msgstr "" #. type: =item -#: ../src/guestfs.pod:866 +#: ../src/guestfs.pod:870 msgid "B<shell scripts>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:868 +#: ../src/guestfs.pod:872 msgid "See L<guestfish(1)>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:872 +#: ../src/guestfs.pod:876 msgid "LIBGUESTFS GOTCHAS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:874 +#: ../src/guestfs.pod:878 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 " @@ -48925,7 +49011,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:878 +#: ../src/guestfs.pod:882 msgid "" "Since we developed libguestfs and the associated tools, there are several " "things we would have designed differently, but are now stuck with for " @@ -48934,19 +49020,19 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:886 +#: ../src/guestfs.pod:890 msgid "Autosync / forgetting to sync." msgstr "" #. type: textblock -#: ../src/guestfs.pod:888 +#: ../src/guestfs.pod:892 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:891 +#: ../src/guestfs.pod:895 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 " @@ -48954,7 +49040,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:895 +#: ../src/guestfs.pod:899 #, no-wrap msgid "" " guestfs_set_autosync (g, 1);\n" @@ -48962,7 +49048,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:897 +#: ../src/guestfs.pod:901 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> " @@ -48970,7 +49056,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:901 +#: ../src/guestfs.pod:905 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 " @@ -48978,7 +49064,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:905 +#: ../src/guestfs.pod:909 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 " @@ -48986,19 +49072,19 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:909 +#: ../src/guestfs.pod:913 msgid "Mount option C<-o sync> should not be the default." msgstr "" #. type: textblock -#: ../src/guestfs.pod:911 +#: ../src/guestfs.pod:915 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:914 +#: ../src/guestfs.pod:918 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 " @@ -49006,31 +49092,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:918 +#: ../src/guestfs.pod:922 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:921 +#: ../src/guestfs.pod:925 msgid "Read-only should be the default." msgstr "" #. type: textblock -#: ../src/guestfs.pod:923 +#: ../src/guestfs.pod:927 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:926 +#: ../src/guestfs.pod:930 msgid "This would reduce the potential to corrupt live VM images." msgstr "" #. type: textblock -#: ../src/guestfs.pod:928 +#: ../src/guestfs.pod:932 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 " @@ -49038,12 +49124,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:932 +#: ../src/guestfs.pod:936 msgid "guestfish command line is hard to use." msgstr "" #. type: textblock -#: ../src/guestfs.pod:934 +#: ../src/guestfs.pod:938 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 " @@ -49053,12 +49139,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:941 +#: ../src/guestfs.pod:945 msgid "guestfish megabyte modifiers don't work right on all commands" msgstr "" #. type: textblock -#: ../src/guestfs.pod:943 +#: ../src/guestfs.pod:947 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 " @@ -49068,12 +49154,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:950 +#: ../src/guestfs.pod:954 msgid "The most common is L</guestfs_lvcreate>. The guestfish command:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:952 +#: ../src/guestfs.pod:956 #, no-wrap msgid "" " lvcreate LV VG 100M\n" @@ -49081,7 +49167,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:954 +#: ../src/guestfs.pod:958 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 " @@ -49090,19 +49176,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:959 +#: ../src/guestfs.pod:963 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:962 +#: ../src/guestfs.pod:966 msgid "Ambiguity between devices and paths" msgstr "" #. type: textblock -#: ../src/guestfs.pod:964 +#: ../src/guestfs.pod:968 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 " @@ -49110,7 +49196,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:969 +#: ../src/guestfs.pod:973 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>. " @@ -49119,7 +49205,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:975 +#: ../src/guestfs.pod:979 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 " @@ -49129,7 +49215,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:981 +#: ../src/guestfs.pod:985 #, no-wrap msgid "" " type path = Path of string | Device of int | Partition of int * int\n" @@ -49137,12 +49223,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:983 +#: ../src/guestfs.pod:987 msgid "which would allow you to pass arguments like:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:985 +#: ../src/guestfs.pod:989 #, no-wrap msgid "" " Path \"/foo/bar\"\n" @@ -49153,26 +49239,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:990 +#: ../src/guestfs.pod:994 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:995 +#: ../src/guestfs.pod:999 msgid "KEYS AND PASSPHRASES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:997 +#: ../src/guestfs.pod:1001 msgid "" "Certain libguestfs calls take a parameter that contains sensitive key " "material, passed in as a C string." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1000 +#: ../src/guestfs.pod:1004 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 " @@ -49181,7 +49267,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1005 +#: ../src/guestfs.pod:1009 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, " @@ -49189,19 +49275,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1010 +#: ../src/guestfs.pod:1014 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1012 +#: ../src/guestfs.pod:1016 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:1015 +#: ../src/guestfs.pod:1019 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 " @@ -49209,33 +49295,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1019 +#: ../src/guestfs.pod:1023 msgid "" "See the graphical program guestfs-browser for one possible architecture for " "multithreaded programs using libvirt and libguestfs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1022 +#: ../src/guestfs.pod:1026 msgid "PATH" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1024 +#: ../src/guestfs.pod:1028 msgid "" "Libguestfs needs a supermin appliance, which it finds by looking along an " "internal path." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1027 +#: ../src/guestfs.pod:1031 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:1030 +#: ../src/guestfs.pod:1034 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 " @@ -49246,12 +49332,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1037 +#: ../src/guestfs.pod:1041 msgid "QEMU WRAPPERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1039 +#: ../src/guestfs.pod:1043 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 " @@ -49259,7 +49345,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1043 +#: ../src/guestfs.pod:1047 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 " @@ -49268,14 +49354,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1048 +#: ../src/guestfs.pod:1052 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:1051 +#: ../src/guestfs.pod:1055 #, no-wrap msgid "" " #!/bin/sh -\n" @@ -49286,7 +49372,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1055 +#: ../src/guestfs.pod:1059 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 " @@ -49294,7 +49380,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1059 +#: ../src/guestfs.pod:1063 #, no-wrap msgid "" " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n" @@ -49302,14 +49388,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1061 +#: ../src/guestfs.pod:1065 msgid "" "Note that libguestfs also calls qemu with the -help and -version options in " "order to determine features." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1064 +#: ../src/guestfs.pod:1068 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 " @@ -49319,7 +49405,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1073 +#: ../src/guestfs.pod:1077 #, no-wrap msgid "" " i=0\n" @@ -49337,7 +49423,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1085 +#: ../src/guestfs.pod:1089 #, no-wrap msgid "" " exec qemu-kvm -machine pc,accel=tcg \"${args[@]}\"\n" @@ -49345,19 +49431,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1087 +#: ../src/guestfs.pod:1091 msgid "ATTACHING TO RUNNING DAEMONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1089 +#: ../src/guestfs.pod:1093 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:1092 +#: ../src/guestfs.pod:1096 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 " @@ -49365,12 +49451,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1096 +#: ../src/guestfs.pod:1100 msgid "Using guestfs_set_attach_method" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1098 +#: ../src/guestfs.pod:1102 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 " @@ -49378,7 +49464,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1102 +#: ../src/guestfs.pod:1106 msgid "" "The normal attach method is C<appliance>, where a small appliance is created " "containing the daemon, and then the library connects to this. C<libvirt> or " @@ -49386,7 +49472,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1107 +#: ../src/guestfs.pod:1111 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 " @@ -49394,7 +49480,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1111 +#: ../src/guestfs.pod:1115 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 " @@ -49402,12 +49488,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1115 +#: ../src/guestfs.pod:1119 msgid "Using guestfs_add_domain with live flag" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1117 +#: ../src/guestfs.pod:1121 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 " @@ -49416,7 +49502,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1123 +#: ../src/guestfs.pod:1127 #, no-wrap msgid "" " <domain>\n" @@ -49434,14 +49520,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1135 +#: ../src/guestfs.pod:1139 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:1138 +#: ../src/guestfs.pod:1142 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 " @@ -49449,19 +49535,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1142 +#: ../src/guestfs.pod:1146 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:1146 +#: ../src/guestfs.pod:1150 msgid "ABI GUARANTEE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1148 +#: ../src/guestfs.pod:1152 msgid "" "We guarantee the libguestfs ABI (binary interface), for public, high-level " "actions as outlined in this section. Although we will deprecate some " @@ -49471,12 +49557,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1154 +#: ../src/guestfs.pod:1158 msgid "BLOCK DEVICE NAMING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1156 +#: ../src/guestfs.pod:1160 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 " @@ -49491,7 +49577,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1168 +#: ../src/guestfs.pod:1172 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 " @@ -49499,7 +49585,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1172 +#: ../src/guestfs.pod:1176 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 " @@ -49507,7 +49593,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1177 +#: ../src/guestfs.pod:1181 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 " @@ -49516,7 +49602,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1183 +#: ../src/guestfs.pod:1187 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 " @@ -49525,12 +49611,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1188 +#: ../src/guestfs.pod:1192 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1190 +#: ../src/guestfs.pod:1194 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 " @@ -49540,7 +49626,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1196 +#: ../src/guestfs.pod:1200 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 " @@ -49548,54 +49634,54 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1204 +#: ../src/guestfs.pod:1208 msgid "Is the string a parameter which is a device or partition name?" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1208 +#: ../src/guestfs.pod:1212 msgid "Does the string begin with C</dev/sd>?" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1212 +#: ../src/guestfs.pod:1216 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:1217 +#: ../src/guestfs.pod:1221 msgid "Replace initial C</dev/sd> string with C</dev/hd>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1219 +#: ../src/guestfs.pod:1223 msgid "For example, change C</dev/sda2> to C</dev/hda2>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1221 +#: ../src/guestfs.pod:1225 msgid "If that named device exists, use it. If not, continue." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1225 +#: ../src/guestfs.pod:1229 msgid "Replace initial C</dev/sd> string with C</dev/vd>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1227 +#: ../src/guestfs.pod:1231 msgid "If that named device exists, use it. If not, return an error." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1231 +#: ../src/guestfs.pod:1235 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1233 +#: ../src/guestfs.pod:1237 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 " @@ -49603,38 +49689,38 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1237 +#: ../src/guestfs.pod:1241 msgid "" "Where possible for maximum future portability programs using libguestfs " "should use these future-proof techniques:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1244 +#: ../src/guestfs.pod:1248 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:1247 +#: ../src/guestfs.pod:1251 msgid "Since those device names exist by definition, they will never be translated." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1252 +#: ../src/guestfs.pod:1256 msgid "" "Use higher level ways to identify filesystems, such as LVM names, UUIDs and " "filesystem labels." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1257 +#: ../src/guestfs.pod:1261 msgid "NULL DISKS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1259 +#: ../src/guestfs.pod:1263 msgid "" "When adding a disk using, eg., L</guestfs_add_drive>, you can set the " "filename to C<\"/dev/null\">. This string is treated specially by " @@ -49642,46 +49728,46 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1263 +#: ../src/guestfs.pod:1267 msgid "A null disk has the following properties:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1269 +#: ../src/guestfs.pod:1273 msgid "" "A null disk will appear as a normal device, eg. in calls to " "L</guestfs_list_devices>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1274 +#: ../src/guestfs.pod:1278 msgid "You may add C<\"/dev/null\"> multiple times." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1278 +#: ../src/guestfs.pod:1282 msgid "" "You should not try to access a null disk in any way. For example, you " "shouldn't try to read it or mount it." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1283 +#: ../src/guestfs.pod:1287 msgid "Null disks are used for three main purposes:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1289 +#: ../src/guestfs.pod:1293 msgid "Performance testing of libguestfs (see L<guestfs-performance(1)>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1293 +#: ../src/guestfs.pod:1297 msgid "The internal test suite." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1297 +#: ../src/guestfs.pod:1301 msgid "" "If you want to use libguestfs APIs that don't refer to disks, since " "libguestfs requires that at least one disk is added, you should add a null " @@ -49689,12 +49775,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1301 +#: ../src/guestfs.pod:1305 msgid "For example, to test if a feature is available, use code like this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1303 +#: ../src/guestfs.pod:1307 #, no-wrap msgid "" " guestfs_h *g;\n" @@ -49703,7 +49789,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1306 +#: ../src/guestfs.pod:1310 #, no-wrap msgid "" " g = guestfs_create ();\n" @@ -49719,19 +49805,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1318 +#: ../src/guestfs.pod:1322 msgid "DISK IMAGE FORMATS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1320 +#: ../src/guestfs.pod:1324 msgid "" "Virtual disks come in a variety of formats. Some common formats are listed " "below." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1323 +#: ../src/guestfs.pod:1327 msgid "" "Note that libguestfs itself is not responsible for handling the disk format: " "this is done using L<qemu(1)>. If support for a particular format is " @@ -49739,24 +49825,24 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1327 +#: ../src/guestfs.pod:1331 msgid "COMMON VIRTUAL DISK IMAGE FORMATS" msgstr "" #. type: =item -#: ../src/guestfs.pod:1331 +#: ../src/guestfs.pod:1335 msgid "I<raw>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1333 +#: ../src/guestfs.pod:1337 msgid "" "Raw format is simply a dump of the sequential bytes of the virtual hard " "disk. There is no header, container, compression or processing of any sort." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1337 +#: ../src/guestfs.pod:1341 msgid "" "Since raw format requires no translation to read or write, it is both fast " "and very well supported by qemu and all other hypervisors. You can consider " @@ -49764,7 +49850,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1342 +#: ../src/guestfs.pod:1346 msgid "" "Raw format files are not compressed and so take up the full space of the " "original disk image even when they are empty. A variation (on Linux/Unix at " @@ -49775,12 +49861,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:1349 +#: ../src/guestfs.pod:1353 msgid "I<qcow2>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1351 +#: ../src/guestfs.pod:1355 msgid "" "Qcow2 is the native disk image format used by qemu. Internally it uses a " "two-level directory structure so that only blocks containing data are stored " @@ -49789,19 +49875,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1356 +#: ../src/guestfs.pod:1360 msgid "" "There are at least two distinct variants of this format, although qemu (and " "hence libguestfs) handles both transparently to the user." msgstr "" #. type: =item -#: ../src/guestfs.pod:1359 +#: ../src/guestfs.pod:1363 msgid "I<vmdk>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1361 +#: ../src/guestfs.pod:1365 msgid "" "VMDK is VMware's native disk image format. There are many variations. " "Modern qemu (hence libguestfs) supports most variations, but you should be " @@ -49810,7 +49896,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1366 +#: ../src/guestfs.pod:1370 msgid "" "Note that VMware ESX exposes files with the name C<guest-flat.vmdk>. These " "are not VMDK. They are raw format files which happen to have a C<.vmdk> " @@ -49818,53 +49904,53 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:1370 +#: ../src/guestfs.pod:1374 msgid "I<vdi>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1372 +#: ../src/guestfs.pod:1376 msgid "" "VDI is VirtualBox's native disk image format. Qemu (hence libguestfs) has " "generally good support for this." msgstr "" #. type: =item -#: ../src/guestfs.pod:1375 +#: ../src/guestfs.pod:1379 msgid "I<vpc>" msgstr "" #. type: =item -#: ../src/guestfs.pod:1377 +#: ../src/guestfs.pod:1381 msgid "I<vhd>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1379 +#: ../src/guestfs.pod:1383 msgid "" "VPC (old) and VHD (modern) are the native disk image format of Microsoft " "(and previously, Connectix) Virtual PC and Hyper-V." msgstr "" #. type: =item -#: ../src/guestfs.pod:1382 +#: ../src/guestfs.pod:1386 msgid "Obsolete formats" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1384 +#: ../src/guestfs.pod:1388 msgid "" "The following formats are obsolete and should not be used: I<qcow> (aka " "I<qcow1>), I<cow>, I<bochs>." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1389 +#: ../src/guestfs.pod:1393 msgid "DETECTING THE FORMAT OF A DISK IMAGE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1391 +#: ../src/guestfs.pod:1395 msgid "" "Firstly note there is a security issue with auto-detecting the format of a " "disk image. It may or may not apply in your use case. Read " @@ -49872,14 +49958,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1395 +#: ../src/guestfs.pod:1399 msgid "" "Libguestfs offers an API to get the format of a disk image " "(L</guestfs_disk_format>, and it is safest to use this." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1398 +#: ../src/guestfs.pod:1402 msgid "" "I<Don't> be tempted to try parsing the text / human-readable output of " "C<qemu-img> since it cannot be parsed reliably and securely. Also do not " @@ -49887,24 +49973,24 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1403 ../sysprep/virt-sysprep.pod:424 +#: ../src/guestfs.pod:1407 ../sysprep/virt-sysprep.pod:424 msgid "SECURITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1405 +#: ../src/guestfs.pod:1409 msgid "" "This section discusses security implications of using libguestfs, " "particularly with untrusted or malicious guests or disk images." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1408 +#: ../src/guestfs.pod:1412 msgid "GENERAL SECURITY CONSIDERATIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1410 +#: ../src/guestfs.pod:1414 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 " @@ -49914,42 +50000,42 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1420 +#: ../src/guestfs.pod:1424 msgid "the data (file etc) not being present" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1424 +#: ../src/guestfs.pod:1428 msgid "being present but empty" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1428 +#: ../src/guestfs.pod:1432 msgid "being much larger than normal" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1432 +#: ../src/guestfs.pod:1436 msgid "containing arbitrary 8 bit data" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1436 +#: ../src/guestfs.pod:1440 msgid "being in an unexpected character encoding" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1440 +#: ../src/guestfs.pod:1444 msgid "containing homoglyphs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1444 +#: ../src/guestfs.pod:1448 msgid "SECURITY OF MOUNTING FILESYSTEMS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1446 +#: ../src/guestfs.pod:1450 msgid "" "When you mount a filesystem under Linux, mistakes in the kernel filesystem " "(VFS) module can sometimes be escalated into exploits by deliberately " @@ -49965,7 +50051,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1459 +#: ../src/guestfs.pod:1463 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 " @@ -49979,19 +50065,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1470 +#: ../src/guestfs.pod:1474 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:1473 +#: ../src/guestfs.pod:1477 msgid "PROTOCOL SECURITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1475 +#: ../src/guestfs.pod:1479 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 " @@ -50001,12 +50087,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1481 +#: ../src/guestfs.pod:1485 msgid "INSPECTION SECURITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1483 +#: ../src/guestfs.pod:1487 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 " @@ -50015,7 +50101,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1489 +#: ../src/guestfs.pod:1493 msgid "" "Guest configuration may be altered in unusual ways by the administrator of " "the virtual machine, and may not reflect reality (particularly for untrusted " @@ -50026,7 +50112,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1497 +#: ../src/guestfs.pod:1501 msgid "" "The inspection API parses guest configuration using two external libraries: " "Augeas (Linux configuration) and hivex (Windows Registry). Both are " @@ -50036,12 +50122,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1503 +#: ../src/guestfs.pod:1507 msgid "RUNNING UNTRUSTED GUEST COMMANDS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1505 +#: ../src/guestfs.pod:1509 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 " @@ -50051,24 +50137,24 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1511 +#: ../src/guestfs.pod:1515 msgid "CVE-2010-3851" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1513 +#: ../src/guestfs.pod:1517 msgid "L<https://bugzilla.redhat.com/642934>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1515 +#: ../src/guestfs.pod:1519 msgid "" "This security bug concerns the automatic disk format detection that qemu " "does on disk images." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1518 +#: ../src/guestfs.pod:1522 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 " @@ -50077,7 +50163,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1523 +#: ../src/guestfs.pod:1527 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 " @@ -50086,7 +50172,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1528 +#: ../src/guestfs.pod:1532 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 " @@ -50098,24 +50184,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1536 +#: ../src/guestfs.pod:1540 msgid "In libguestfs this is rather hard to exploit except under two circumstances:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1543 +#: ../src/guestfs.pod:1547 msgid "You have enabled the network or have opened the disk in write mode." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1547 +#: ../src/guestfs.pod:1551 msgid "" "You are also running untrusted code from the guest (see L</RUNNING " "COMMANDS>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1552 +#: ../src/guestfs.pod:1556 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 " @@ -50124,31 +50210,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1558 +#: ../src/guestfs.pod:1562 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:1561 +#: ../src/guestfs.pod:1565 msgid "" "For libguestfs tools, use the I<--format> command line parameter as " "appropriate." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1564 +#: ../src/guestfs.pod:1568 msgid "CONNECTION MANAGEMENT" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1566 +#: ../src/guestfs.pod:1570 msgid "guestfs_h *" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1568 +#: ../src/guestfs.pod:1572 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 " @@ -50156,19 +50242,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1572 +#: ../src/guestfs.pod:1576 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:1575 +#: ../src/guestfs.pod:1579 msgid "guestfs_create" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1577 +#: ../src/guestfs.pod:1581 #, no-wrap msgid "" " guestfs_h *guestfs_create (void);\n" @@ -50176,19 +50262,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1579 +#: ../src/guestfs.pod:1583 msgid "Create a connection handle." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1581 +#: ../src/guestfs.pod:1585 msgid "" "On success this returns a non-NULL pointer to a handle. On error it returns " "NULL." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1584 +#: ../src/guestfs.pod:1588 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 " @@ -50196,24 +50282,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1588 +#: ../src/guestfs.pod:1592 msgid "After configuring the handle, you have to call L</guestfs_launch>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1590 +#: ../src/guestfs.pod:1594 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:1593 +#: ../src/guestfs.pod:1597 msgid "guestfs_close" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1595 +#: ../src/guestfs.pod:1599 #, no-wrap msgid "" " void guestfs_close (guestfs_h *g);\n" @@ -50221,19 +50307,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1597 +#: ../src/guestfs.pod:1601 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:1600 +#: ../src/guestfs.pod:1604 msgid "The correct way to close the handle is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1602 +#: ../src/guestfs.pod:1606 #, no-wrap msgid "" " if (guestfs_shutdown (g) == -1) {\n" @@ -50244,51 +50330,51 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1607 +#: ../src/guestfs.pod:1611 msgid "L</guestfs_shutdown> is only needed if B<all> of the following are true:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1613 +#: ../src/guestfs.pod:1617 msgid "one or more disks were added in read-write mode, I<and>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1617 +#: ../src/guestfs.pod:1621 msgid "guestfs_launch was called, I<and>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1621 +#: ../src/guestfs.pod:1625 msgid "you made some changes, I<and>" msgstr "" #. type: =item -#: ../src/guestfs.pod:1623 +#: ../src/guestfs.pod:1627 msgid "4" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1625 +#: ../src/guestfs.pod:1629 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:1630 +#: ../src/guestfs.pod:1634 msgid "ERROR HANDLING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1632 +#: ../src/guestfs.pod:1636 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:1635 +#: ../src/guestfs.pod:1639 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 " @@ -50296,7 +50382,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1639 +#: ../src/guestfs.pod:1643 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 " @@ -50304,7 +50390,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1644 +#: ../src/guestfs.pod:1648 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 " @@ -50312,7 +50398,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1648 +#: ../src/guestfs.pod:1652 #, no-wrap msgid "" " if (guestfs_launch (g) == -1)\n" @@ -50321,21 +50407,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1651 +#: ../src/guestfs.pod:1655 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:1654 +#: ../src/guestfs.pod:1658 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:1657 +#: ../src/guestfs.pod:1661 #, no-wrap msgid "" " /* This disables the default behaviour of printing errors\n" @@ -50345,7 +50431,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1661 +#: ../src/guestfs.pod:1665 #, no-wrap msgid "" " if (guestfs_launch (g) == -1) {\n" @@ -50362,7 +50448,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1672 +#: ../src/guestfs.pod:1676 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 " @@ -50370,7 +50456,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1676 +#: ../src/guestfs.pod:1680 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 " @@ -50380,12 +50466,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1682 +#: ../src/guestfs.pod:1686 msgid "guestfs_last_error" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1684 +#: ../src/guestfs.pod:1688 #, no-wrap msgid "" " const char *guestfs_last_error (guestfs_h *g);\n" @@ -50393,26 +50479,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1686 +#: ../src/guestfs.pod:1690 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:1690 +#: ../src/guestfs.pod:1694 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:1693 +#: ../src/guestfs.pod:1697 msgid "guestfs_last_errno" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1695 +#: ../src/guestfs.pod:1699 #, no-wrap msgid "" " int guestfs_last_errno (guestfs_h *g);\n" @@ -50420,27 +50506,27 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1697 +#: ../src/guestfs.pod:1701 msgid "This returns the last error number (errno) that happened on C<g>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1699 +#: ../src/guestfs.pod:1703 msgid "If successful, an errno integer not equal to zero is returned." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1701 +#: ../src/guestfs.pod:1705 msgid "If no error, this returns 0. This call can return 0 in three situations:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1708 +#: ../src/guestfs.pod:1712 msgid "There has not been any error on the handle." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1712 +#: ../src/guestfs.pod:1716 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 " @@ -50448,14 +50534,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1718 +#: ../src/guestfs.pod:1722 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:1724 +#: ../src/guestfs.pod:1728 msgid "" "Libguestfs tries to convert the errno from inside the applicance into a " "corresponding errno for the caller (not entirely trivial: the appliance " @@ -50466,12 +50552,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1732 +#: ../src/guestfs.pod:1736 msgid "guestfs_set_error_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1734 +#: ../src/guestfs.pod:1738 #, no-wrap msgid "" " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n" @@ -50484,7 +50570,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1741 +#: ../src/guestfs.pod:1745 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 " @@ -50492,14 +50578,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1745 +#: ../src/guestfs.pod:1749 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:1748 +#: ../src/guestfs.pod:1752 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 " @@ -50507,22 +50593,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1752 +#: ../src/guestfs.pod:1756 msgid "The default handler prints messages on C<stderr>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1754 +#: ../src/guestfs.pod:1758 msgid "If you set C<cb> to C<NULL> then I<no> handler is called." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1756 +#: ../src/guestfs.pod:1760 msgid "guestfs_get_error_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1758 +#: ../src/guestfs.pod:1762 #, no-wrap msgid "" " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n" @@ -50531,17 +50617,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1761 +#: ../src/guestfs.pod:1765 msgid "Returns the current error handler callback." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1763 +#: ../src/guestfs.pod:1767 msgid "guestfs_set_out_of_memory_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1765 +#: ../src/guestfs.pod:1769 #, no-wrap msgid "" " typedef void (*guestfs_abort_cb) (void);\n" @@ -50551,29 +50637,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1769 +#: ../src/guestfs.pod:1773 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:1772 +#: ../src/guestfs.pod:1776 msgid "The default is to call L<abort(3)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1774 +#: ../src/guestfs.pod:1778 msgid "You cannot set C<cb> to C<NULL>. You can't ignore out of memory situations." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1777 +#: ../src/guestfs.pod:1781 msgid "guestfs_get_out_of_memory_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1779 +#: ../src/guestfs.pod:1783 #, no-wrap msgid "" " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n" @@ -50581,37 +50667,37 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1781 +#: ../src/guestfs.pod:1785 msgid "This returns the current out of memory handler." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1783 +#: ../src/guestfs.pod:1787 msgid "API CALLS" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1787 +#: ../src/guestfs.pod:1791 msgid "STRUCTURES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1789 +#: ../src/guestfs.pod:1793 msgid "@STRUCTS@" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1791 +#: ../src/guestfs.pod:1795 msgid "AVAILABILITY" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1793 +#: ../src/guestfs.pod:1797 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1795 +#: ../src/guestfs.pod:1799 msgid "" "Using L</guestfs_available> you can test availability of the following " "groups of functions. This test queries the appliance to see if the " @@ -50619,29 +50705,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1800 +#: ../src/guestfs.pod:1804 msgid "@AVAILABILITY@" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1802 +#: ../src/guestfs.pod:1806 msgid "FILESYSTEM AVAILABLE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1804 +#: ../src/guestfs.pod:1808 msgid "" "The L</guestfs_filesystem_available> call tests whether a filesystem type is " "supported by the appliance kernel." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1812 +#: ../src/guestfs.pod:1816 msgid "GUESTFISH supported COMMAND" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1814 +#: ../src/guestfs.pod:1818 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 " @@ -50649,19 +50735,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1819 +#: ../src/guestfs.pod:1823 msgid "SINGLE CALLS AT COMPILE TIME" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1821 +#: ../src/guestfs.pod:1825 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:1824 +#: ../src/guestfs.pod:1828 #, no-wrap msgid "" " #define LIBGUESTFS_HAVE_DD 1\n" @@ -50669,12 +50755,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1826 +#: ../src/guestfs.pod:1830 msgid "if L</guestfs_dd> is available." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1828 +#: ../src/guestfs.pod:1832 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 " @@ -50682,7 +50768,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1833 +#: ../src/guestfs.pod:1837 #, no-wrap msgid "" " AC_CHECK_LIB([guestfs],[guestfs_create])\n" @@ -50691,19 +50777,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1836 +#: ../src/guestfs.pod:1840 msgid "" "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined " "in your program." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1839 +#: ../src/guestfs.pod:1843 msgid "SINGLE CALLS AT RUN TIME" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1841 +#: ../src/guestfs.pod:1845 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 " @@ -50713,7 +50799,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1848 +#: ../src/guestfs.pod:1852 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 " @@ -50721,7 +50807,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1852 +#: ../src/guestfs.pod:1856 #, no-wrap msgid "" " #include <stdio.h>\n" @@ -50733,7 +50819,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1858 +#: ../src/guestfs.pod:1862 #, no-wrap msgid "" " main ()\n" @@ -50745,7 +50831,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1864 +#: ../src/guestfs.pod:1868 #, no-wrap msgid "" " /* Test if the function guestfs_dd is really available. */\n" @@ -50760,7 +50846,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1873 +#: ../src/guestfs.pod:1877 #, no-wrap msgid "" " if (!has_function)\n" @@ -50779,7 +50865,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1886 +#: ../src/guestfs.pod:1890 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 " @@ -50787,7 +50873,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1891 +#: ../src/guestfs.pod:1895 #, no-wrap msgid "" " Requires: libguestfs >= 1.0.80\n" @@ -50795,12 +50881,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1893 +#: ../src/guestfs.pod:1897 msgid "CALLS WITH OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1895 +#: ../src/guestfs.pod:1899 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 " @@ -50808,7 +50894,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1900 +#: ../src/guestfs.pod:1904 #, no-wrap msgid "" " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n" @@ -50816,14 +50902,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1902 +#: ../src/guestfs.pod:1906 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:1905 +#: ../src/guestfs.pod:1909 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename, -1);\n" @@ -50831,12 +50917,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1907 +#: ../src/guestfs.pod:1911 msgid "With a single optional argument:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1909 +#: ../src/guestfs.pod:1913 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -50846,12 +50932,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1913 +#: ../src/guestfs.pod:1917 msgid "With two:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1915 +#: ../src/guestfs.pod:1919 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -50862,19 +50948,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1920 +#: ../src/guestfs.pod:1924 msgid "" "and so forth. Don't forget the terminating C<-1> otherwise Bad Things will " "happen!" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1923 +#: ../src/guestfs.pod:1927 msgid "USING va_list FOR OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1925 +#: ../src/guestfs.pod:1929 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 " @@ -50882,7 +50968,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1929 +#: ../src/guestfs.pod:1933 #, no-wrap msgid "" " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n" @@ -50891,12 +50977,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1932 +#: ../src/guestfs.pod:1936 msgid "CONSTRUCTING OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1934 +#: ../src/guestfs.pod:1938 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 " @@ -50906,7 +50992,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1940 +#: ../src/guestfs.pod:1944 #, no-wrap msgid "" " struct guestfs_add_drive_opts_argv {\n" @@ -50921,12 +51007,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1949 +#: ../src/guestfs.pod:1953 msgid "You could call it like this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1951 +#: ../src/guestfs.pod:1955 #, no-wrap msgid "" " struct guestfs_add_drive_opts_argv optargs = {\n" @@ -50939,7 +51025,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1958 +#: ../src/guestfs.pod:1962 #, no-wrap msgid "" " guestfs_add_drive_opts_argv (g, filename, &optargs);\n" @@ -50947,29 +51033,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1966 +#: ../src/guestfs.pod:1970 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1971 +#: ../src/guestfs.pod:1975 msgid "You do not need to fill in all fields of the structure." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1975 +#: ../src/guestfs.pod:1979 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:1980 +#: ../src/guestfs.pod:1984 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1982 +#: ../src/guestfs.pod:1986 msgid "" "In other languages, optional arguments are expressed in the way that is " "natural for that language. We refer you to the language-specific " @@ -50977,17 +51063,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1986 +#: ../src/guestfs.pod:1990 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1988 +#: ../src/guestfs.pod:1992 msgid "SETTING CALLBACKS TO HANDLE EVENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1990 +#: ../src/guestfs.pod:1994 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 " @@ -50999,7 +51085,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1999 +#: ../src/guestfs.pod:2003 msgid "" "Handles generate events when certain things happen, such as log messages " "being generated, progress messages during long-running operations, or the " @@ -51011,7 +51097,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2007 +#: ../src/guestfs.pod:2011 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 " @@ -51020,31 +51106,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2012 +#: ../src/guestfs.pod:2016 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:2016 +#: ../src/guestfs.pod:2020 msgid "CLASSES OF EVENTS" msgstr "" #. type: =item -#: ../src/guestfs.pod:2020 +#: ../src/guestfs.pod:2024 msgid "GUESTFS_EVENT_CLOSE (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2023 +#: ../src/guestfs.pod:2027 msgid "" "The callback function will be called while the handle is being closed " "(synchronously from L</guestfs_close>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2026 +#: ../src/guestfs.pod:2030 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 " @@ -51055,19 +51141,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2033 +#: ../src/guestfs.pod:2037 msgid "" "If no callback is registered: the handle is closed without any callback " "being invoked." msgstr "" #. type: =item -#: ../src/guestfs.pod:2036 +#: ../src/guestfs.pod:2040 msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2039 +#: ../src/guestfs.pod:2043 msgid "" "The callback function will be called when the child process quits, either " "asynchronously or if killed by L</guestfs_kill_subprocess>. (This " @@ -51075,17 +51161,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2043 ../src/guestfs.pod:2052 ../src/guestfs.pod:2169 +#: ../src/guestfs.pod:2047 ../src/guestfs.pod:2056 ../src/guestfs.pod:2173 msgid "If no callback is registered: the event is ignored." msgstr "" #. type: =item -#: ../src/guestfs.pod:2045 +#: ../src/guestfs.pod:2049 msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2048 +#: ../src/guestfs.pod:2052 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 " @@ -51093,12 +51179,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2054 +#: ../src/guestfs.pod:2058 msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2057 +#: ../src/guestfs.pod:2061 msgid "" "Some long-running operations can generate progress messages. If this " "callback is registered, then it will be called each time a progress message " @@ -51108,14 +51194,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2063 +#: ../src/guestfs.pod:2067 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:2066 +#: ../src/guestfs.pod:2070 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 " @@ -51124,24 +51210,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2071 +#: ../src/guestfs.pod:2075 msgid "The only defined and stable parts of the API are:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2077 +#: ../src/guestfs.pod:2081 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:2082 +#: ../src/guestfs.pod:2086 msgid "0 E<lt>= C<position> E<lt>= C<total>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2086 +#: ../src/guestfs.pod:2090 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 " @@ -51149,7 +51235,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2090 +#: ../src/guestfs.pod:2094 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 " @@ -51157,7 +51243,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2096 +#: ../src/guestfs.pod:2100 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 " @@ -51166,7 +51252,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2101 +#: ../src/guestfs.pod:2105 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 " @@ -51174,14 +51260,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2105 +#: ../src/guestfs.pod:2109 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:2110 +#: ../src/guestfs.pod:2114 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 " @@ -51190,31 +51276,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2116 +#: ../src/guestfs.pod:2120 msgid "If no callback is registered: progress messages are discarded." msgstr "" #. type: =item -#: ../src/guestfs.pod:2118 +#: ../src/guestfs.pod:2122 msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2121 +#: ../src/guestfs.pod:2125 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:2124 +#: ../src/guestfs.pod:2128 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:2127 ../src/guestfs.pod:2141 +#: ../src/guestfs.pod:2131 ../src/guestfs.pod:2145 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 " @@ -51222,62 +51308,62 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2132 +#: ../src/guestfs.pod:2136 msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2135 +#: ../src/guestfs.pod:2139 msgid "" "The callback function is called whenever a log message is generated by the " "library part of libguestfs." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2138 +#: ../src/guestfs.pod:2142 msgid "" "If the verbose flag (L</guestfs_set_verbose>) is set then additional debug " "messages are generated." msgstr "" #. type: =item -#: ../src/guestfs.pod:2146 +#: ../src/guestfs.pod:2150 msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2149 +#: ../src/guestfs.pod:2153 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:2152 +#: ../src/guestfs.pod:2156 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:2156 +#: ../src/guestfs.pod:2160 msgid "GUESTFS_EVENT_ENTER (payload type: function name)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2159 +#: ../src/guestfs.pod:2163 msgid "The callback function is called whenever a libguestfs function is entered." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2162 +#: ../src/guestfs.pod:2166 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:2165 +#: ../src/guestfs.pod:2169 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 " @@ -51285,12 +51371,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2173 +#: ../src/guestfs.pod:2177 msgid "guestfs_set_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2175 +#: ../src/guestfs.pod:2179 #, no-wrap msgid "" " int guestfs_set_event_callback (guestfs_h *g,\n" @@ -51302,14 +51388,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2181 +#: ../src/guestfs.pod:2185 msgid "" "This function registers a callback (C<cb>) for all event classes in the " "C<event_bitmask>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2184 +#: ../src/guestfs.pod:2188 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>. " @@ -51318,40 +51404,40 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2190 +#: ../src/guestfs.pod:2194 msgid "C<flags> should always be passed as 0." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2192 +#: ../src/guestfs.pod:2196 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:2195 +#: ../src/guestfs.pod:2199 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:2198 +#: ../src/guestfs.pod:2202 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:2201 +#: ../src/guestfs.pod:2205 msgid "" "Callbacks remain in effect until they are deleted, or until the handle is " "closed." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2204 +#: ../src/guestfs.pod:2208 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 " @@ -51359,12 +51445,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2208 +#: ../src/guestfs.pod:2212 msgid "guestfs_delete_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2210 +#: ../src/guestfs.pod:2214 #, no-wrap msgid "" " void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n" @@ -51372,7 +51458,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2212 +#: ../src/guestfs.pod:2216 msgid "" "Delete a callback that was previously registered. C<event_handle> should be " "the integer that was returned by a previous call to " @@ -51380,12 +51466,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2216 +#: ../src/guestfs.pod:2220 msgid "guestfs_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2218 +#: ../src/guestfs.pod:2222 #, no-wrap msgid "" " typedef void (*guestfs_event_callback) (\n" @@ -51400,12 +51486,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2227 +#: ../src/guestfs.pod:2231 msgid "This is the type of the event callback function that you have to provide." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2230 +#: ../src/guestfs.pod:2234 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 " @@ -51413,7 +51499,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2234 +#: ../src/guestfs.pod:2238 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 " @@ -51422,7 +51508,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2239 +#: ../src/guestfs.pod:2243 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 " @@ -51430,19 +51516,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2243 +#: ../src/guestfs.pod:2247 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:2246 +#: ../src/guestfs.pod:2250 msgid "EXAMPLE: CAPTURING LOG MESSAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2248 +#: ../src/guestfs.pod:2252 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 " @@ -51450,7 +51536,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2252 +#: ../src/guestfs.pod:2256 msgid "" "Events associated with log messages are: C<GUESTFS_EVENT_LIBRARY>, " "C<GUESTFS_EVENT_APPLIANCE> and C<GUESTFS_EVENT_TRACE>. (Note that error " @@ -51458,14 +51544,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2257 +#: ../src/guestfs.pod:2261 msgid "" "Programs have to set up a callback to capture the classes of events of " "interest:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2260 +#: ../src/guestfs.pod:2264 #, no-wrap msgid "" " int eh =\n" @@ -51481,14 +51567,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2270 +#: ../src/guestfs.pod:2274 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:2273 +#: ../src/guestfs.pod:2277 #, no-wrap msgid "" " static void\n" @@ -51509,12 +51595,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2288 +#: ../src/guestfs.pod:2292 msgid "CANCELLING LONG TRANSFERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2290 +#: ../src/guestfs.pod:2294 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 " @@ -51523,12 +51609,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2295 +#: ../src/guestfs.pod:2299 msgid "guestfs_user_cancel" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2297 +#: ../src/guestfs.pod:2301 #, no-wrap msgid "" " void guestfs_user_cancel (guestfs_h *g);\n" @@ -51536,12 +51622,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2299 +#: ../src/guestfs.pod:2303 msgid "C<guestfs_user_cancel> cancels the current upload or download operation." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2302 +#: ../src/guestfs.pod:2306 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 " @@ -51549,7 +51635,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2306 +#: ../src/guestfs.pod:2310 msgid "" "The transfer that was in progress (if there is one) will stop shortly " "afterwards, and will return an error. The errno (see " @@ -51558,7 +51644,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2312 +#: ../src/guestfs.pod:2316 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 " @@ -51566,12 +51652,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2316 +#: ../src/guestfs.pod:2320 msgid "There are two common places that you might call C<guestfs_user_cancel>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2318 +#: ../src/guestfs.pod:2322 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 " @@ -51580,19 +51666,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2323 +#: ../src/guestfs.pod:2327 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:2327 +#: ../src/guestfs.pod:2331 msgid "PRIVATE DATA AREA" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2329 +#: ../src/guestfs.pod:2333 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 " @@ -51600,12 +51686,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2334 +#: ../src/guestfs.pod:2338 msgid "To attach a named piece of data, use the following call:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2336 +#: ../src/guestfs.pod:2340 #, no-wrap msgid "" " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n" @@ -51613,7 +51699,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2338 +#: ../src/guestfs.pod:2342 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 " @@ -51621,7 +51707,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2342 +#: ../src/guestfs.pod:2346 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 " @@ -51631,12 +51717,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2348 +#: ../src/guestfs.pod:2352 msgid "To retrieve the pointer, use:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2350 +#: ../src/guestfs.pod:2354 #, no-wrap msgid "" " void *guestfs_get_private (guestfs_h *g, const char *key);\n" @@ -51644,7 +51730,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2352 +#: ../src/guestfs.pod:2356 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 " @@ -51652,7 +51738,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2356 +#: ../src/guestfs.pod:2360 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 " @@ -51663,12 +51749,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2363 +#: ../src/guestfs.pod:2367 msgid "To walk over all entries, use these two functions:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2365 +#: ../src/guestfs.pod:2369 #, no-wrap msgid "" " void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n" @@ -51676,7 +51762,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2367 +#: ../src/guestfs.pod:2371 #, no-wrap msgid "" " void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n" @@ -51684,7 +51770,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2369 +#: ../src/guestfs.pod:2373 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 " @@ -51694,7 +51780,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2375 +#: ../src/guestfs.pod:2379 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 " @@ -51702,17 +51788,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2379 +#: ../src/guestfs.pod:2383 msgid "Notes about walking over entries:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2385 +#: ../src/guestfs.pod:2389 msgid "You must not call C<guestfs_set_private> while walking over the entries." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2390 +#: ../src/guestfs.pod:2394 msgid "" "The handle maintains an internal iterator which is reset when you call " "C<guestfs_first_private>. This internal iterator is invalidated when you " @@ -51720,12 +51806,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2396 +#: ../src/guestfs.pod:2400 msgid "If you have set the data pointer associated with a key to C<NULL>, ie:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2398 +#: ../src/guestfs.pod:2402 #, no-wrap msgid "" " guestfs_set_private (g, key, NULL);\n" @@ -51733,26 +51819,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2400 +#: ../src/guestfs.pod:2404 msgid "then that C<key> is not returned when walking." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2404 +#: ../src/guestfs.pod:2408 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:2410 +#: ../src/guestfs.pod:2414 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:2413 +#: ../src/guestfs.pod:2417 #, no-wrap msgid "" " const char *key;\n" @@ -51766,14 +51852,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2421 +#: ../src/guestfs.pod:2425 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:2424 +#: ../src/guestfs.pod:2428 #, no-wrap msgid "" " const char *key;\n" @@ -51788,7 +51874,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2433 +#: ../src/guestfs.pod:2437 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 " @@ -51796,7 +51882,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2437 +#: ../src/guestfs.pod:2441 #, no-wrap msgid "" " const char *key;\n" @@ -51818,7 +51904,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2453 +#: ../src/guestfs.pod:2457 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 " @@ -51827,12 +51913,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2458 +#: ../src/guestfs.pod:2462 msgid "SYSTEMTAP" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2460 +#: ../src/guestfs.pod:2464 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 " @@ -51840,12 +51926,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2464 +#: ../src/guestfs.pod:2468 msgid "You can list all the static markers by doing:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2466 +#: ../src/guestfs.pod:2470 #, no-wrap msgid "" " stap -l 'process(\"/usr/lib*/libguestfs.so.0\")\n" @@ -51854,26 +51940,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2469 +#: ../src/guestfs.pod:2473 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:2472 +#: ../src/guestfs.pod:2476 msgid "SYSTEMTAP SCRIPT EXAMPLE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2474 +#: ../src/guestfs.pod:2478 msgid "" "This script contains examples of displaying both the static markers and some " "ordinary C entry points:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2501 +#: ../src/guestfs.pod:2505 #, no-wrap msgid "" " /* Display all calls to guestfs_mkfs* functions. */\n" @@ -51886,7 +51972,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2508 +#: ../src/guestfs.pod:2512 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 " @@ -51895,7 +51981,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2513 +#: ../src/guestfs.pod:2517 #, no-wrap msgid "" " # stap /tmp/test.stap\n" @@ -51904,17 +51990,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2516 +#: ../src/guestfs.pod:2520 msgid "In another terminal, run a guestfish command such as this:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2520 +#: ../src/guestfs.pod:2524 msgid "In the first terminal, stap trace output similar to this is shown:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2522 +#: ../src/guestfs.pod:2526 #, no-wrap msgid "" " 1318248056692655 (+0):\tlaunch_start\n" @@ -51928,19 +52014,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2531 +#: ../src/guestfs.pod:2535 msgid "" "<!-- old anchor for the next section --> <a " "name=\"state_machine_and_low_level_event_api\"/>" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2536 +#: ../src/guestfs.pod:2540 msgid "ARCHITECTURE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2538 +#: ../src/guestfs.pod:2542 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 " @@ -51948,7 +52034,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2542 +#: ../src/guestfs.pod:2546 #, no-wrap msgid "" " ___________________\n" @@ -51974,14 +52060,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2562 +#: ../src/guestfs.pod:2566 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:2565 +#: ../src/guestfs.pod:2569 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 " @@ -51993,7 +52079,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2574 +#: ../src/guestfs.pod:2578 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 " @@ -52004,17 +52090,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2581 +#: ../src/guestfs.pod:2585 msgid "STATE MACHINE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2583 +#: ../src/guestfs.pod:2587 msgid "libguestfs uses a state machine to model the child process:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2585 +#: ../src/guestfs.pod:2589 #, no-wrap msgid "" " |\n" @@ -52042,7 +52128,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2607 +#: ../src/guestfs.pod:2611 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), " @@ -52051,7 +52137,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2612 +#: ../src/guestfs.pod:2616 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 " @@ -52059,14 +52145,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2616 +#: ../src/guestfs.pod:2620 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:2619 +#: ../src/guestfs.pod:2623 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 " @@ -52075,7 +52161,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2625 +#: ../src/guestfs.pod:2629 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. " @@ -52084,7 +52170,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2630 +#: ../src/guestfs.pod:2634 msgid "" "Finally, the child process sends asynchronous messages back to the main " "program, such as kernel log messages. You can register a callback to " @@ -52092,17 +52178,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2634 +#: ../src/guestfs.pod:2638 msgid "INTERNALS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2636 +#: ../src/guestfs.pod:2640 msgid "APPLIANCE BOOT PROCESS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2638 +#: ../src/guestfs.pod:2642 msgid "" "This process has evolved and continues to evolve. The description here " "corresponds only to the current version of libguestfs and is provided for " @@ -52110,55 +52196,55 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2642 +#: ../src/guestfs.pod:2646 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:2647 +#: ../src/guestfs.pod:2651 msgid "Create the appliance" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2649 +#: ../src/guestfs.pod:2653 msgid "" "C<febootstrap-supermin-helper> is invoked to create the kernel, a small " "initrd and the appliance." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2652 +#: ../src/guestfs.pod:2656 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:2655 +#: ../src/guestfs.pod:2659 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:2659 +#: ../src/guestfs.pod:2663 msgid "Start qemu and boot the kernel" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2661 +#: ../src/guestfs.pod:2665 msgid "qemu is invoked to boot the kernel." msgstr "" #. type: =item -#: ../src/guestfs.pod:2663 +#: ../src/guestfs.pod:2667 msgid "Run the initrd" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2665 +#: ../src/guestfs.pod:2669 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 " @@ -52166,21 +52252,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2669 +#: ../src/guestfs.pod:2673 msgid "" "The initrd is a cpio archive called " "C</var/tmp/.guestfs-E<lt>UIDE<gt>/initrd>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2672 +#: ../src/guestfs.pod:2676 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:2675 +#: ../src/guestfs.pod:2679 #, no-wrap msgid "" " febootstrap: ext2 mini initrd starting up\n" @@ -52191,12 +52277,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2680 +#: ../src/guestfs.pod:2684 msgid "Find and mount the appliance device" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2682 +#: ../src/guestfs.pod:2686 msgid "" "The appliance is a sparse file containing an ext2 filesystem which contains " "a familiar (although reduced in size) Linux operating system. It would " @@ -52204,33 +52290,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2686 +#: ../src/guestfs.pod:2690 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:2689 +#: ../src/guestfs.pod:2693 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:2692 +#: ../src/guestfs.pod:2696 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:2696 +#: ../src/guestfs.pod:2700 msgid "If this works successfully you will see messages such as:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2698 +#: ../src/guestfs.pod:2702 #, no-wrap msgid "" " febootstrap: picked /sys/block/vdb/dev as root device\n" @@ -52242,19 +52328,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2704 +#: ../src/guestfs.pod:2708 msgid "" "Note that C<Starting /init script ...> indicates that the appliance's init " "script is now running." msgstr "" #. type: =item -#: ../src/guestfs.pod:2707 +#: ../src/guestfs.pod:2711 msgid "Initialize the appliance" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2709 +#: ../src/guestfs.pod:2713 msgid "" "The appliance itself now initializes itself. This involves starting certain " "processes like C<udev>, possibly printing some debug information, and " @@ -52262,19 +52348,19 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2713 +#: ../src/guestfs.pod:2717 msgid "The daemon" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2715 +#: ../src/guestfs.pod:2719 msgid "" "Finally the daemon (C<guestfsd>) runs inside the appliance. If it runs you " "should see:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2718 +#: ../src/guestfs.pod:2722 #, no-wrap msgid "" " verbose daemon enabled\n" @@ -52282,14 +52368,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2720 +#: ../src/guestfs.pod:2724 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:2723 +#: ../src/guestfs.pod:2727 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 " @@ -52297,19 +52383,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2729 +#: ../src/guestfs.pod:2733 msgid "COMMUNICATION PROTOCOL" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2731 +#: ../src/guestfs.pod:2735 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:2734 +#: ../src/guestfs.pod:2738 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 " @@ -52317,14 +52403,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2738 +#: ../src/guestfs.pod:2742 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:2741 +#: ../src/guestfs.pod:2745 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 " @@ -52334,17 +52420,17 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2748 +#: ../src/guestfs.pod:2752 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2750 +#: ../src/guestfs.pod:2754 msgid "For ordinary functions, the request message is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2752 +#: ../src/guestfs.pod:2756 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -52355,7 +52441,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2757 +#: ../src/guestfs.pod:2761 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 " @@ -52364,21 +52450,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2763 +#: ../src/guestfs.pod:2767 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:2766 +#: ../src/guestfs.pod:2770 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:2770 +#: ../src/guestfs.pod:2774 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 " @@ -52390,12 +52476,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2778 +#: ../src/guestfs.pod:2782 msgid "The reply message for ordinary functions is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2780 +#: ../src/guestfs.pod:2784 #, no-wrap msgid "" " total length (header + ret,\n" @@ -52406,26 +52492,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2785 +#: ../src/guestfs.pod:2789 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:2788 +#: ../src/guestfs.pod:2792 msgid "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2791 +#: ../src/guestfs.pod:2795 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:2794 +#: ../src/guestfs.pod:2798 #, no-wrap msgid "" " total length (header + error,\n" @@ -52436,19 +52522,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2799 +#: ../src/guestfs.pod:2803 msgid "" "The C<guestfs_message_error> structure contains the error message as a " "string." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2802 +#: ../src/guestfs.pod:2806 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2804 +#: ../src/guestfs.pod:2808 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 " @@ -52456,7 +52542,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2808 +#: ../src/guestfs.pod:2812 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -52470,12 +52556,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2816 +#: ../src/guestfs.pod:2820 msgid "The \"sequence of chunks\" is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2818 +#: ../src/guestfs.pod:2822 #, no-wrap msgid "" " length of chunk (not including length word itself)\n" @@ -52489,7 +52575,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2826 +#: ../src/guestfs.pod:2830 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 " @@ -52497,7 +52583,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2830 +#: ../src/guestfs.pod:2834 msgid "" "At time of writing there are no functions that have more than one FileIn " "parameter. However this is (theoretically) supported, by sending the " @@ -52506,7 +52592,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2835 +#: ../src/guestfs.pod:2839 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 " @@ -52515,7 +52601,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2841 +#: ../src/guestfs.pod:2845 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 " @@ -52527,7 +52613,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2850 +#: ../src/guestfs.pod:2854 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 " @@ -52537,19 +52623,19 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2856 +#: ../src/guestfs.pod:2860 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2858 +#: ../src/guestfs.pod:2862 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:2861 +#: ../src/guestfs.pod:2865 #, no-wrap msgid "" " total length (header + ret,\n" @@ -52563,12 +52649,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2869 +#: ../src/guestfs.pod:2873 msgid "INITIAL MESSAGE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2871 +#: ../src/guestfs.pod:2875 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 " @@ -52576,12 +52662,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2875 +#: ../src/guestfs.pod:2879 msgid "PROGRESS NOTIFICATION MESSAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2877 +#: ../src/guestfs.pod:2881 msgid "" "The daemon may send progress notification messages at any time. These are " "distinguished by the normal length word being replaced by " @@ -52589,7 +52675,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2881 +#: ../src/guestfs.pod:2885 msgid "" "The library turns them into progress callbacks (see " "L</GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards " @@ -52597,7 +52683,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2885 +#: ../src/guestfs.pod:2889 msgid "" "The daemon self-limits the frequency of progress messages it sends (see " "C<daemon/proto.c:notify_progress>). Not all calls generate progress " @@ -52605,12 +52691,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2889 +#: ../src/guestfs.pod:2893 msgid "LIBGUESTFS VERSION NUMBERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2891 +#: ../src/guestfs.pod:2895 msgid "" "Since April 2010, libguestfs has started to make separate development and " "stable releases, along with corresponding branches in our git repository. " @@ -52618,7 +52704,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2896 +#: ../src/guestfs.pod:2900 #, no-wrap msgid "" " even numbers for stable: 1.2.x, 1.4.x, ...\n" @@ -52635,12 +52721,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2907 +#: ../src/guestfs.pod:2911 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2909 +#: ../src/guestfs.pod:2913 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 " @@ -52650,26 +52736,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2915 +#: ../src/guestfs.pod:2919 msgid "Our criteria for backporting changes are:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2921 +#: ../src/guestfs.pod:2925 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:2927 +#: ../src/guestfs.pod:2931 msgid "" "Bug fixes which are not controversial, fix obvious problems, and have been " "well tested are backported." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2932 +#: ../src/guestfs.pod:2936 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 " @@ -52677,7 +52763,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2938 +#: ../src/guestfs.pod:2942 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 " @@ -52685,7 +52771,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2944 +#: ../src/guestfs.pod:2948 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 " @@ -52696,17 +52782,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2952 +#: ../src/guestfs.pod:2956 msgid "EXTENDING LIBGUESTFS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2954 +#: ../src/guestfs.pod:2958 msgid "ADDING A NEW API ACTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2956 +#: ../src/guestfs.pod:2960 msgid "" "Large amounts of boilerplate code in libguestfs (RPC, bindings, " "documentation) are generated, and this makes it easy to extend the " @@ -52714,19 +52800,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2960 +#: ../src/guestfs.pod:2964 msgid "To add a new API action there are two changes:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2966 +#: ../src/guestfs.pod:2970 msgid "" "You need to add a description of the call (name, parameters, return type, " "tests, documentation) to C<generator/actions.ml>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2969 +#: ../src/guestfs.pod:2973 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 " @@ -52737,7 +52823,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2977 +#: ../src/guestfs.pod:2981 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 " @@ -52747,7 +52833,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2983 +#: ../src/guestfs.pod:2987 msgid "" "For library-only actions of the second type, add to the " "C<non_daemon_functions> list. Since these functions are serviced by the " @@ -52757,36 +52843,36 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2991 +#: ../src/guestfs.pod:2995 msgid "Implement the action (in C):" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2993 +#: ../src/guestfs.pod:2997 msgid "" "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the " "C<daemon/> directory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2996 +#: ../src/guestfs.pod:3000 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:2999 +#: ../src/guestfs.pod:3003 msgid "In either case, use another function as an example of what to do." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3003 +#: ../src/guestfs.pod:3007 msgid "After making these changes, use C<make> to compile." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3005 +#: ../src/guestfs.pod:3009 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 " @@ -52794,12 +52880,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3009 +#: ../src/guestfs.pod:3013 msgid "ADDING TESTS FOR AN API ACTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3011 +#: ../src/guestfs.pod:3015 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 " @@ -52809,61 +52895,61 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3017 +#: ../src/guestfs.pod:3021 msgid "" "The following describes the test environment used when you add an API test " "in C<actions.ml>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3020 +#: ../src/guestfs.pod:3024 msgid "The test environment has 4 block devices:" msgstr "" #. type: =item -#: ../src/guestfs.pod:3024 +#: ../src/guestfs.pod:3028 msgid "C</dev/sda> 500MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3026 +#: ../src/guestfs.pod:3030 msgid "General block device for testing." msgstr "" #. type: =item -#: ../src/guestfs.pod:3028 +#: ../src/guestfs.pod:3032 msgid "C</dev/sdb> 50MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3030 +#: ../src/guestfs.pod:3034 msgid "" "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write " "operations." msgstr "" #. type: =item -#: ../src/guestfs.pod:3033 +#: ../src/guestfs.pod:3037 msgid "C</dev/sdc> 10MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3035 +#: ../src/guestfs.pod:3039 msgid "Used in a few tests where two block devices are needed." msgstr "" #. type: =item -#: ../src/guestfs.pod:3037 +#: ../src/guestfs.pod:3041 msgid "C</dev/sdd>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3039 +#: ../src/guestfs.pod:3043 msgid "ISO with fixed content (see C<images/test.iso>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3043 +#: ../src/guestfs.pod:3047 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 " @@ -52871,7 +52957,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3047 +#: ../src/guestfs.pod:3051 msgid "" "Each test starts with an initial scenario, selected using one of the " "C<Init*> expressions, described in C<generator/types.ml>. These initialize " @@ -52881,7 +52967,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3053 +#: ../src/guestfs.pod:3057 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 " @@ -52891,14 +52977,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3059 +#: ../src/guestfs.pod:3063 msgid "" "In addition, packagers can skip individual tests by setting environment " "variables before running C<make check>." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3062 +#: ../src/guestfs.pod:3066 #, no-wrap msgid "" " SKIP_TEST_<CMD>_<NUM>=1\n" @@ -52906,12 +52992,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3064 +#: ../src/guestfs.pod:3068 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3068 +#: ../src/guestfs.pod:3072 #, no-wrap msgid "" " SKIP_TEST_<CMD>=1\n" @@ -52919,17 +53005,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3070 +#: ../src/guestfs.pod:3074 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3072 +#: ../src/guestfs.pod:3076 msgid "Packagers can run only certain tests by setting for example:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3074 +#: ../src/guestfs.pod:3078 #, no-wrap msgid "" " TEST_ONLY=\"vfs_type zerofree\"\n" @@ -52937,29 +53023,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3076 +#: ../src/guestfs.pod:3080 msgid "" "See C<tests/c-api/tests.c> for more details of how these environment " "variables work." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3079 +#: ../src/guestfs.pod:3083 msgid "DEBUGGING NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3081 +#: ../src/guestfs.pod:3085 msgid "Test new actions work before submitting them." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3083 +#: ../src/guestfs.pod:3087 msgid "You can use guestfish to try out new commands." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3085 +#: ../src/guestfs.pod:3089 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 " @@ -52967,12 +53053,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3089 +#: ../src/guestfs.pod:3093 msgid "FORMATTING CODE AND OTHER CONVENTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3091 +#: ../src/guestfs.pod:3095 msgid "" "Our C source code generally adheres to some basic code-formatting " "conventions. The existing code base is not totally consistent on this " @@ -52982,14 +53068,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3097 +#: ../src/guestfs.pod:3101 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:3100 +#: ../src/guestfs.pod:3104 #, no-wrap msgid "" " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n" @@ -53005,7 +53091,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3110 +#: ../src/guestfs.pod:3114 #, no-wrap msgid "" " ;;; When editing C sources in libguestfs, use this style.\n" @@ -53023,12 +53109,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3122 +#: ../src/guestfs.pod:3126 msgid "Enable warnings when compiling (and fix any problems this finds):" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3125 +#: ../src/guestfs.pod:3129 #, no-wrap msgid "" " ./configure --enable-gcc-warnings\n" @@ -53036,12 +53122,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3127 +#: ../src/guestfs.pod:3131 msgid "Useful targets are:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3129 +#: ../src/guestfs.pod:3133 #, no-wrap msgid "" " make syntax-check -j1 -k # checks for various syntax and\n" @@ -53050,7 +53136,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3132 +#: ../src/guestfs.pod:3136 #, no-wrap msgid "" " make check # runs the test suite\n" @@ -53058,7 +53144,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3134 +#: ../src/guestfs.pod:3138 #, no-wrap msgid "" " make extra-tests # in-depth testing using valgrind\n" @@ -53067,43 +53153,43 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3137 +#: ../src/guestfs.pod:3141 msgid "DAEMON CUSTOM PRINTF FORMATTERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3139 +#: ../src/guestfs.pod:3143 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:3144 +#: ../src/guestfs.pod:3148 msgid "%Q" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3146 +#: ../src/guestfs.pod:3150 msgid "" "Simple shell quoted string. Any spaces or other shell characters are " "escaped for you." msgstr "" #. type: =item -#: ../src/guestfs.pod:3149 +#: ../src/guestfs.pod:3153 msgid "%R" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3151 +#: ../src/guestfs.pod:3155 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:3158 +#: ../src/guestfs.pod:3162 #, no-wrap msgid "" " asprintf (&cmd, \"cat %R\", path);\n" @@ -53111,12 +53197,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3160 +#: ../src/guestfs.pod:3164 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3162 +#: ../src/guestfs.pod:3166 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 " @@ -53125,12 +53211,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3168 +#: ../src/guestfs.pod:3172 msgid "SUBMITTING YOUR NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3170 +#: ../src/guestfs.pod:3174 msgid "" "Submit patches to the mailing list: " "L<http://www.redhat.com/mailman/listinfo/libguestfs> and CC to " @@ -53138,17 +53224,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3174 +#: ../src/guestfs.pod:3178 msgid "INTERNATIONALIZATION (I18N) SUPPORT" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3176 +#: ../src/guestfs.pod:3180 msgid "We support i18n (gettext anyhow) in the library." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3178 +#: ../src/guestfs.pod:3182 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 " @@ -53157,103 +53243,103 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3184 +#: ../src/guestfs.pod:3188 msgid "" "Debugging messages are never translated, since they are intended for the " "programmers." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3187 +#: ../src/guestfs.pod:3191 msgid "SOURCE CODE SUBDIRECTORIES" msgstr "" #. type: =item -#: ../src/guestfs.pod:3191 +#: ../src/guestfs.pod:3195 msgid "C<align>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3193 +#: ../src/guestfs.pod:3197 msgid "L<virt-alignment-scan(1)> command and documentation." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3197 +#: ../src/guestfs.pod:3201 msgid "The libguestfs appliance, build scripts and so on." msgstr "" #. type: =item -#: ../src/guestfs.pod:3199 +#: ../src/guestfs.pod:3203 msgid "C<cat>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3201 +#: ../src/guestfs.pod:3205 msgid "" "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and " "documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3204 +#: ../src/guestfs.pod:3208 msgid "C<contrib>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3206 +#: ../src/guestfs.pod:3210 msgid "Outside contributions, experimental parts." msgstr "" #. type: =item -#: ../src/guestfs.pod:3208 +#: ../src/guestfs.pod:3212 msgid "C<daemon>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3210 +#: ../src/guestfs.pod:3214 msgid "" "The daemon that runs inside the libguestfs appliance and carries out " "actions." msgstr "" #. type: =item -#: ../src/guestfs.pod:3213 +#: ../src/guestfs.pod:3217 msgid "C<df>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3215 +#: ../src/guestfs.pod:3219 msgid "L<virt-df(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3217 +#: ../src/guestfs.pod:3221 msgid "C<edit>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3219 +#: ../src/guestfs.pod:3223 msgid "L<virt-edit(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3221 +#: ../src/guestfs.pod:3225 msgid "C<examples>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3223 +#: ../src/guestfs.pod:3227 msgid "C API example code." msgstr "" #. type: =item -#: ../src/guestfs.pod:3225 +#: ../src/guestfs.pod:3229 msgid "C<fish>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3227 +#: ../src/guestfs.pod:3231 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)>, " @@ -53261,79 +53347,79 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3233 +#: ../src/guestfs.pod:3237 msgid "L<virt-format(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3235 +#: ../src/guestfs.pod:3239 msgid "C<fuse>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3237 +#: ../src/guestfs.pod:3241 msgid "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:3239 +#: ../src/guestfs.pod:3243 msgid "C<generator>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3241 +#: ../src/guestfs.pod:3245 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:3244 +#: ../src/guestfs.pod:3248 msgid "C<inspector>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3246 +#: ../src/guestfs.pod:3250 msgid "L<virt-inspector(1)>, the virtual machine image inspector." msgstr "" #. type: =item -#: ../src/guestfs.pod:3248 +#: ../src/guestfs.pod:3252 msgid "C<logo>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3250 +#: ../src/guestfs.pod:3254 msgid "Logo used on the website. The fish is called Arthur by the way." msgstr "" #. type: =item -#: ../src/guestfs.pod:3252 +#: ../src/guestfs.pod:3256 msgid "C<m4>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3254 +#: ../src/guestfs.pod:3258 msgid "M4 macros used by autoconf." msgstr "" #. type: =item -#: ../src/guestfs.pod:3256 +#: ../src/guestfs.pod:3260 msgid "C<po>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3258 +#: ../src/guestfs.pod:3262 msgid "Translations of simple gettext strings." msgstr "" #. type: =item -#: ../src/guestfs.pod:3260 +#: ../src/guestfs.pod:3264 msgid "C<po-docs>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3262 +#: ../src/guestfs.pod:3266 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 " @@ -53341,84 +53427,84 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:3266 +#: ../src/guestfs.pod:3270 msgid "C<rescue>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3268 +#: ../src/guestfs.pod:3272 msgid "L<virt-rescue(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3270 +#: ../src/guestfs.pod:3274 msgid "C<resize>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3272 +#: ../src/guestfs.pod:3276 msgid "L<virt-resize(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3274 +#: ../src/guestfs.pod:3278 msgid "C<sparsify>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3276 +#: ../src/guestfs.pod:3280 msgid "L<virt-sparsify(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3278 +#: ../src/guestfs.pod:3282 msgid "C<src>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3280 +#: ../src/guestfs.pod:3284 msgid "Source code to the C library." msgstr "" #. type: =item -#: ../src/guestfs.pod:3282 +#: ../src/guestfs.pod:3286 msgid "C<sysprep>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3284 +#: ../src/guestfs.pod:3288 msgid "L<virt-sysprep(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3286 +#: ../src/guestfs.pod:3290 msgid "C<test-tool>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3288 +#: ../src/guestfs.pod:3292 msgid "" "Test tool for end users to test if their qemu/kernel combination will work " "with libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:3291 +#: ../src/guestfs.pod:3295 msgid "C<tests>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3293 +#: ../src/guestfs.pod:3297 msgid "Tests." msgstr "" #. type: =item -#: ../src/guestfs.pod:3295 +#: ../src/guestfs.pod:3299 msgid "C<tmp>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3297 +#: ../src/guestfs.pod:3301 msgid "" "Used for temporary files when running the tests (instead of C</tmp> etc). " "The reason is so that you can run multiple parallel tests of libguestfs " @@ -53427,14 +53513,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3302 +#: ../src/guestfs.pod:3306 msgid "" "If you are using libvirt + sVirt with SELinux enforcing, then you have to " "label this directory:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3305 +#: ../src/guestfs.pod:3309 #, no-wrap msgid "" " chcon --reference=/tmp tmp\n" @@ -53442,77 +53528,77 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:3307 +#: ../src/guestfs.pod:3311 msgid "C<tools>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3309 +#: ../src/guestfs.pod:3313 msgid "Command line tools written in Perl (L<virt-win-reg(1)> and many others)." msgstr "" #. type: =item -#: ../src/guestfs.pod:3311 +#: ../src/guestfs.pod:3315 msgid "C<csharp>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3313 +#: ../src/guestfs.pod:3317 msgid "C<erlang>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3315 +#: ../src/guestfs.pod:3319 msgid "C<gobject>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3317 +#: ../src/guestfs.pod:3321 msgid "C<haskell>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3319 +#: ../src/guestfs.pod:3323 msgid "C<java>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3321 +#: ../src/guestfs.pod:3325 msgid "C<ocaml>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3323 +#: ../src/guestfs.pod:3327 msgid "C<php>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3325 +#: ../src/guestfs.pod:3329 msgid "C<perl>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3327 +#: ../src/guestfs.pod:3331 msgid "C<python>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3329 +#: ../src/guestfs.pod:3333 msgid "C<ruby>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3331 +#: ../src/guestfs.pod:3335 msgid "Language bindings." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3335 +#: ../src/guestfs.pod:3339 msgid "MAKING A STABLE RELEASE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3337 +#: ../src/guestfs.pod:3341 msgid "" "When we make a stable release, there are several steps documented here. See " "L</LIBGUESTFS VERSION NUMBERS> for general information about the stable " @@ -53520,32 +53606,32 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3345 +#: ../src/guestfs.pod:3349 msgid "Check C<make && make check> works on at least Fedora, Debian and Ubuntu." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3350 +#: ../src/guestfs.pod:3354 msgid "Finalize C<guestfs-release-notes.pod>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3354 +#: ../src/guestfs.pod:3358 msgid "Update ROADMAP." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3358 +#: ../src/guestfs.pod:3362 msgid "Run C<src/api-support/update-from-tarballs.sh>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3362 +#: ../src/guestfs.pod:3366 msgid "Push and pull from Transifex." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3366 +#: ../src/guestfs.pod:3370 #, no-wrap msgid "" " tx push -s\n" @@ -53553,12 +53639,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3368 +#: ../src/guestfs.pod:3372 msgid "to push the latest POT files to Transifex. Then run:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3370 +#: ../src/guestfs.pod:3374 #, no-wrap msgid "" " ./tx-pull.sh\n" @@ -53566,24 +53652,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3372 +#: ../src/guestfs.pod:3376 msgid "which is a wrapper to pull the latest translated C<*.po> files." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3376 +#: ../src/guestfs.pod:3380 msgid "" "Create new stable and development directories under " "L<http://libguestfs.org/download>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3381 +#: ../src/guestfs.pod:3385 msgid "Create the branch in git:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3383 +#: ../src/guestfs.pod:3387 #, no-wrap msgid "" " git tag -a 1.XX.0 -m \"Version 1.XX.0 (stable)\"\n" @@ -53594,17 +53680,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:3390 +#: ../src/guestfs.pod:3394 msgid "LIMITS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3392 +#: ../src/guestfs.pod:3396 msgid "PROTOCOL LIMITS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3394 +#: ../src/guestfs.pod:3398 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 " @@ -53615,7 +53701,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3402 +#: ../src/guestfs.pod:3406 msgid "" "In libguestfs E<lt> 1.19.32, several calls had to encode either their entire " "argument list or their entire return value (or sometimes both) in a single " @@ -53631,7 +53717,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3415 +#: ../src/guestfs.pod:3419 msgid "" "L</guestfs_cat>, L</guestfs_find>, L</guestfs_read_file>, " "L</guestfs_read_lines>, L</guestfs_write>, L</guestfs_write_append>, " @@ -53640,19 +53726,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3420 +#: ../src/guestfs.pod:3424 msgid "" "See also L</UPLOADING> and L</DOWNLOADING> for further information about " "copying large amounts of data into or out of a filesystem." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3423 +#: ../src/guestfs.pod:3427 msgid "MAXIMUM NUMBER OF DISKS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3425 +#: ../src/guestfs.pod:3429 msgid "" "In libguestfs E<ge> 1.19.7, you can query the maximum number of disks that " "may be added by calling L</guestfs_max_disks>. In earlier versions of " @@ -53661,14 +53747,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3430 +#: ../src/guestfs.pod:3434 msgid "" "The rest of this section covers implementation details, which could change " "in future." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3433 +#: ../src/guestfs.pod:3437 msgid "" "When using virtio-scsi disks (the default if available in qemu) the current " "limit is B<255> disks. When using virtio-blk (the old default) the limit is " @@ -53677,26 +53763,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3438 +#: ../src/guestfs.pod:3442 msgid "" "Virtio-scsi as used by libguestfs is configured to use one target per disk, " "and 256 targets are available." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3441 +#: ../src/guestfs.pod:3445 msgid "" "Virtio-blk consumes 1 virtual PCI slot per disk, and PCI is limited to 31 " "slots, but some of these are used for other purposes." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3444 +#: ../src/guestfs.pod:3448 msgid "One virtual disk is used by libguestfs internally." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3446 +#: ../src/guestfs.pod:3450 msgid "" "Before libguestfs 1.19.7, disk names had to be a single character " "(eg. C</dev/sda> through C</dev/sdz>), and since one disk is reserved, that " @@ -53704,7 +53790,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3451 +#: ../src/guestfs.pod:3455 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 " @@ -53712,41 +53798,41 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3455 +#: ../src/guestfs.pod:3459 msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3457 +#: ../src/guestfs.pod:3461 msgid "Virtio limits the maximum number of partitions per disk to B<15>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3459 +#: ../src/guestfs.pod:3463 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:3462 +#: ../src/guestfs.pod:3466 msgid "" "If you attach a disk with more than 15 partitions, the extra partitions are " "ignored by libguestfs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3465 +#: ../src/guestfs.pod:3469 msgid "MAXIMUM SIZE OF A DISK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3467 +#: ../src/guestfs.pod:3471 msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3469 +#: ../src/guestfs.pod:3473 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 " @@ -53754,7 +53840,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3473 +#: ../src/guestfs.pod:3477 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 " @@ -53764,19 +53850,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3479 +#: ../src/guestfs.pod:3483 msgid "" "For the hugest disk image files, we recommend using XFS on the host for " "storage." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3482 +#: ../src/guestfs.pod:3486 msgid "MAXIMUM SIZE OF A PARTITION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3484 +#: ../src/guestfs.pod:3488 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 " @@ -53784,7 +53870,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3488 +#: ../src/guestfs.pod:3492 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 " @@ -53792,12 +53878,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3493 +#: ../src/guestfs.pod:3497 msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3495 +#: ../src/guestfs.pod:3499 msgid "" "This depends on the filesystem type. libguestfs itself does not impose any " "known limit. Consult Wikipedia or the filesystem documentation to find out " @@ -53805,12 +53891,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3499 +#: ../src/guestfs.pod:3503 msgid "MAXIMUM UPLOAD AND DOWNLOAD" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3501 +#: ../src/guestfs.pod:3505 msgid "" "The API functions L</guestfs_upload>, L</guestfs_download>, " "L</guestfs_tar_in>, L</guestfs_tar_out> and the like allow unlimited sized " @@ -53818,12 +53904,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3505 +#: ../src/guestfs.pod:3509 msgid "INSPECTION LIMITS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3507 +#: ../src/guestfs.pod:3511 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 " @@ -53833,40 +53919,40 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3533 +#: ../src/guestfs.pod:3537 msgid "" "Choose the default way to create the appliance. See " "L</guestfs_set_attach_method>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3538 +#: ../src/guestfs.pod:3542 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:3550 +#: ../src/guestfs.pod:3554 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:3559 +#: ../src/guestfs.pod:3563 msgid "See also L</QEMU WRAPPERS> above." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3563 +#: ../src/guestfs.pod:3567 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:3581 +#: ../src/guestfs.pod:3585 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)>, " @@ -53878,14 +53964,14 @@ msgid "" "L<virt-rescue(1)>, L<virt-resize(1)>, L<virt-sparsify(1)>, " "L<virt-sysprep(1)>, L<virt-tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, " "L<virt-win-reg(1)>, L<guestfs-faq(1)>, L<guestfs-performance(1)>, " -"L<guestfs-testing(1)>, L<libguestfs-test-tool(1)>, " -"L<libguestfs-make-fixed-appliance(1)>, L<febootstrap(8)>, " -"L<febootstrap-supermin-helper(8)>, L<qemu(1)>, L<hivex(3)>, L<stap(1)>, " -"L<http://libguestfs.org/>." +"L<guestfs-release-notes(1)>, L<guestfs-testing(1)>, " +"L<libguestfs-test-tool(1)>, L<libguestfs-make-fixed-appliance(1)>, " +"L<febootstrap(8)>, L<febootstrap-supermin-helper(8)>, L<qemu(1)>, " +"L<hivex(3)>, L<stap(1)>, L<http://libguestfs.org/>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3623 +#: ../src/guestfs.pod:3628 msgid "" "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, " "L<lvm(8)>, L<disktype(1)>." @@ -54164,7 +54250,10 @@ msgid "" " /var/lib/logrotate.status\n" " /var/log/*.log*\n" " /var/log/BackupPC/LOG\n" +" /var/log/apache2/*_log\n" +" /var/log/apache2/*_log-*\n" " /var/log/audit/*\n" +" /var/log/audit/audit.log\n" " /var/log/btmp*\n" " /var/log/ceph/*.log\n" " /var/log/chrony/*.log\n" @@ -54183,6 +54272,7 @@ msgid "" " /var/log/mail/*\n" " /var/log/maillog*\n" " /var/log/messages*\n" +" /var/log/ntp\n" " /var/log/ppp/connect-errors\n" " /var/log/secure*\n" " /var/log/setroubleshoot/*.log\n" @@ -54195,34 +54285,34 @@ msgid "" msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:130 +#: ../sysprep/sysprep-operations.pod:134 msgid "B<lvm-uuids> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:133 +#: ../sysprep/sysprep-operations.pod:137 msgid "Change LVM2 PV and VG UUIDs." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:135 +#: ../sysprep/sysprep-operations.pod:139 msgid "" "On Linux guests that have LVM2 physical volumes (PVs) or volume groups " "(VGs), new random UUIDs are generated and assigned to those PVs and VGs." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:138 +#: ../sysprep/sysprep-operations.pod:142 msgid "B<machine-id> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:141 +#: ../sysprep/sysprep-operations.pod:145 msgid "Remove the local machine ID." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:143 +#: ../sysprep/sysprep-operations.pod:147 msgid "" "The machine ID is usually generated from a random source during system " "installation and stays constant for all subsequent boots. Optionally, for " @@ -54231,150 +54321,150 @@ msgid "" msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:148 +#: ../sysprep/sysprep-operations.pod:152 msgid "B<mail-spool> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:151 +#: ../sysprep/sysprep-operations.pod:155 msgid "Remove email from the local mail spool directory." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:153 +#: ../sysprep/sysprep-operations.pod:157 msgid "B<net-hostname> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:156 +#: ../sysprep/sysprep-operations.pod:160 msgid "Remove HOSTNAME in network interface configuration." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:158 ../sysprep/sysprep-operations.pod:166 +#: ../sysprep/sysprep-operations.pod:162 ../sysprep/sysprep-operations.pod:170 msgid "" "For Fedora and Red Hat Enterprise Linux, this is removed from C<ifcfg-*> " "files." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:161 +#: ../sysprep/sysprep-operations.pod:165 msgid "B<net-hwaddr> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:164 +#: ../sysprep/sysprep-operations.pod:168 msgid "Remove HWADDR (hard-coded MAC address) configuration." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:169 +#: ../sysprep/sysprep-operations.pod:173 msgid "B<pacct-log> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:172 +#: ../sysprep/sysprep-operations.pod:176 msgid "Remove the process accounting log files." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:174 +#: ../sysprep/sysprep-operations.pod:178 msgid "" "The system wide process accounting will store to the pacct log files if the " "process accounting is on." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:177 +#: ../sysprep/sysprep-operations.pod:181 msgid "B<package-manager-cache> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:180 +#: ../sysprep/sysprep-operations.pod:184 msgid "Remove package manager cache." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:182 +#: ../sysprep/sysprep-operations.pod:186 msgid "B<pam-data> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:185 +#: ../sysprep/sysprep-operations.pod:189 msgid "Remove the PAM data in the guest." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:187 +#: ../sysprep/sysprep-operations.pod:191 msgid "B<puppet-data-log> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:190 +#: ../sysprep/sysprep-operations.pod:194 msgid "Remove the data and log files of puppet." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:192 +#: ../sysprep/sysprep-operations.pod:196 msgid "B<random-seed> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:195 +#: ../sysprep/sysprep-operations.pod:199 msgid "Generate random seed for guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:197 +#: ../sysprep/sysprep-operations.pod:201 msgid "" "Write some random bytes from the host into the random seed file of the " "guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:200 +#: ../sysprep/sysprep-operations.pod:204 msgid "See L</RANDOM SEED> below." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:202 +#: ../sysprep/sysprep-operations.pod:206 msgid "B<rhn-systemid> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:205 +#: ../sysprep/sysprep-operations.pod:209 msgid "Remove the RHN system ID." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:207 +#: ../sysprep/sysprep-operations.pod:211 msgid "B<samba-db-log> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:210 +#: ../sysprep/sysprep-operations.pod:214 msgid "Remove the database and log files of Samba." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:212 +#: ../sysprep/sysprep-operations.pod:216 msgid "B<script> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:215 +#: ../sysprep/sysprep-operations.pod:219 msgid "Run arbitrary scripts against the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:217 +#: ../sysprep/sysprep-operations.pod:221 msgid "" "The C<script> module lets you run arbitrary shell scripts or programs " "against the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:220 +#: ../sysprep/sysprep-operations.pod:224 msgid "" "Note this feature requires FUSE support. You may have to enable this in " "your host, for example by adding the current user to the C<fuse> group, or " @@ -54382,14 +54472,14 @@ msgid "" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:224 +#: ../sysprep/sysprep-operations.pod:228 msgid "" "Use one or more I<--script> parameters to specify scripts or programs that " "will be run against the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:227 +#: ../sysprep/sysprep-operations.pod:231 msgid "" "The script or program is run with its current directory being the guest's " "root directory, so relative paths should be used. For example: C<rm " @@ -54399,14 +54489,14 @@ msgid "" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:233 +#: ../sysprep/sysprep-operations.pod:237 msgid "" "Normally a temporary mount point for the guest is used, but you can choose a " "specific one by using the I<--scriptdir> parameter." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:236 +#: ../sysprep/sysprep-operations.pod:240 msgid "" "B<Note:> This is different from I<--firstboot> scripts (which run in the " "context of the guest when it is booting first time). I<--script> scripts " @@ -54414,41 +54504,41 @@ msgid "" msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:240 +#: ../sysprep/sysprep-operations.pod:244 msgid "B<smolt-uuid> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:243 +#: ../sysprep/sysprep-operations.pod:247 msgid "Remove the Smolt hardware UUID." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:245 +#: ../sysprep/sysprep-operations.pod:249 msgid "B<ssh-hostkeys> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:248 +#: ../sysprep/sysprep-operations.pod:252 msgid "Remove the SSH host keys in the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:250 +#: ../sysprep/sysprep-operations.pod:254 msgid "" "The SSH host keys are regenerated (differently) next time the guest is " "booted." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:253 +#: ../sysprep/sysprep-operations.pod:257 msgid "" "If, after cloning, the guest gets the same IP address, ssh will give you a " "stark warning about the host key changing:" msgstr "" #. type: verbatim -#: ../sysprep/sysprep-operations.pod:256 +#: ../sysprep/sysprep-operations.pod:260 #, no-wrap msgid "" " @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n" @@ -54459,51 +54549,51 @@ msgid "" msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:261 +#: ../sysprep/sysprep-operations.pod:265 msgid "B<ssh-userdir> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:264 +#: ../sysprep/sysprep-operations.pod:268 msgid "Remove \".ssh\" directories in the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:266 +#: ../sysprep/sysprep-operations.pod:270 msgid "" "Remove the C<.ssh> directory of user \"root\" and any other users who have a " "C<.ssh> directory in their home directory." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:269 +#: ../sysprep/sysprep-operations.pod:273 msgid "B<sssd-db-log> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:272 +#: ../sysprep/sysprep-operations.pod:276 msgid "Remove the database and log files of sssd." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:274 +#: ../sysprep/sysprep-operations.pod:278 msgid "B<udev-persistent-net> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:277 +#: ../sysprep/sysprep-operations.pod:281 msgid "Remove udev persistent net rules." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:279 +#: ../sysprep/sysprep-operations.pod:283 msgid "" "Remove udev persistent net rules which map the guest's existing MAC address " "to a fixed ethernet device (eg. eth0)." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:282 +#: ../sysprep/sysprep-operations.pod:286 msgid "" "After a guest is cloned, the MAC address usually changes. Since the old MAC " "address occupies the old name (eg. eth0), this means the fresh MAC address " @@ -54512,34 +54602,34 @@ msgid "" msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:287 +#: ../sysprep/sysprep-operations.pod:291 msgid "B<user-account>" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:289 +#: ../sysprep/sysprep-operations.pod:293 msgid "Remove the user accounts in the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:291 +#: ../sysprep/sysprep-operations.pod:295 msgid "" "Remove all the user accounts and their home directories. The \"root\" " "account is not removed." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:294 +#: ../sysprep/sysprep-operations.pod:298 msgid "B<utmp> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:297 +#: ../sysprep/sysprep-operations.pod:301 msgid "Remove the utmp file." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:299 +#: ../sysprep/sysprep-operations.pod:303 msgid "" "This file records who is currently logged in on a machine. In modern Linux " "distros it is stored in a ramdisk and hence not part of the virtual " @@ -54547,17 +54637,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:303 +#: ../sysprep/sysprep-operations.pod:307 msgid "B<yum-uuid> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:306 +#: ../sysprep/sysprep-operations.pod:310 msgid "Remove the yum UUID." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:308 +#: ../sysprep/sysprep-operations.pod:312 msgid "" "Yum creates a fresh UUID the next time it runs when it notices that the " "original UUID has been erased." |