diff options
Diffstat (limited to 'po-docs/libguestfs-docs.pot')
| -rw-r--r-- | po-docs/libguestfs-docs.pot | 7767 |
1 files changed, 4013 insertions, 3754 deletions
diff --git a/po-docs/libguestfs-docs.pot b/po-docs/libguestfs-docs.pot index 27b6ba66..09ab7f1a 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.18.3\n" +"Project-Id-Version: libguestfs 1.18.4\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2012-06-28 10:28+0200\n" +"POT-Creation-Date: 2012-07-06 18:18+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" @@ -57,7 +57,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:15 ../appliance/libguestfs-make-fixed-appliance.pod:13 ../cat/virt-cat.pod:19 ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19 ../df/virt-df.pod:21 ../edit/virt-edit.pod:27 ../erlang/examples/guestfs-erlang.pod:16 ../examples/guestfs-examples.pod:19 ../examples/guestfs-performance.pod:7 ../examples/guestfs-recipes.pod:18 ../examples/guestfs-testing.pod:7 ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19 ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21 ../fish/virt-tar-out.pod:15 ../format/virt-format.pod:11 ../fuse/guestmount.pod:20 ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15 ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:18 ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:31 ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15 ../sparsify/virt-sparsify.pod:11 ../src/guestfs.pod:23 ../sysprep/virt-sysprep.pod:13 ../test-tool/libguestfs-test-tool.pod:11 ../tools/virt-list-filesystems.pl:45 ../tools/virt-list-partitions.pl:45 ../tools/virt-make-fs.pl:47 ../tools/virt-tar.pl:77 ../tools/virt-win-reg.pl:63 +#: ../align/virt-alignment-scan.pod:15 ../appliance/libguestfs-make-fixed-appliance.pod:13 ../cat/virt-cat.pod:19 ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19 ../df/virt-df.pod:21 ../edit/virt-edit.pod:27 ../erlang/examples/guestfs-erlang.pod:16 ../examples/guestfs-examples.pod:19 ../examples/guestfs-performance.pod:7 ../examples/guestfs-recipes.pod:18 ../examples/guestfs-testing.pod:7 ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19 ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21 ../fish/virt-tar-out.pod:15 ../format/virt-format.pod:11 ../fuse/guestmount.pod:20 ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15 ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:18 ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:31 ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15 ../sparsify/virt-sparsify.pod:11 ../src/guestfs.pod:24 ../sysprep/virt-sysprep.pod:13 ../test-tool/libguestfs-test-tool.pod:11 ../tools/virt-list-filesystems.pl:45 ../tools/virt-list-partitions.pl:45 ../tools/virt-make-fs.pl:47 ../tools/virt-tar.pl:77 ../tools/virt-win-reg.pl:63 msgid "DESCRIPTION" msgstr "" @@ -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:685 ../format/virt-format.pod:96 ../inspector/virt-inspector.pod:350 ../rescue/virt-rescue.pod:164 ../src/guestfs.pod:2945 ../sysprep/virt-sysprep.pod:111 +#: ../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:685 ../format/virt-format.pod:96 ../inspector/virt-inspector.pod:350 ../rescue/virt-rescue.pod:164 ../src/guestfs.pod:2968 ../sysprep/virt-sysprep.pod:111 msgid "For example:" msgstr "" @@ -727,12 +727,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:334 ../cat/virt-cat.pod:231 ../cat/virt-filesystems.pod:377 ../cat/virt-ls.pod:483 ../df/virt-df.pod:241 ../edit/virt-edit.pod:356 ../inspector/virt-inspector.pod:366 ../rescue/virt-rescue.pod:318 ../resize/virt-resize.pod:690 ../sysprep/virt-sysprep.pod:421 ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:584 ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:744 +#: ../align/virt-alignment-scan.pod:334 ../cat/virt-cat.pod:231 ../cat/virt-filesystems.pod:377 ../cat/virt-ls.pod:483 ../df/virt-df.pod:241 ../edit/virt-edit.pod:356 ../inspector/virt-inspector.pod:366 ../rescue/virt-rescue.pod:318 ../resize/virt-resize.pod:690 ../sysprep/virt-sysprep.pod:421 ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:583 ../tools/virt-tar.pl:287 ../tools/virt-win-reg.pl:744 msgid "SHELL QUOTING" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:336 ../cat/virt-cat.pod:233 ../cat/virt-filesystems.pod:379 ../cat/virt-ls.pod:485 ../df/virt-df.pod:243 ../edit/virt-edit.pod:358 ../inspector/virt-inspector.pod:368 ../rescue/virt-rescue.pod:320 ../resize/virt-resize.pod:692 ../sysprep/virt-sysprep.pod:423 ../tools/virt-list-filesystems.pl:192 ../tools/virt-list-partitions.pl:262 ../tools/virt-make-fs.pl:586 ../tools/virt-tar.pl:291 ../tools/virt-win-reg.pl:752 +#: ../align/virt-alignment-scan.pod:336 ../cat/virt-cat.pod:233 ../cat/virt-filesystems.pod:379 ../cat/virt-ls.pod:485 ../df/virt-df.pod:243 ../edit/virt-edit.pod:358 ../inspector/virt-inspector.pod:368 ../rescue/virt-rescue.pod:320 ../resize/virt-resize.pod:692 ../sysprep/virt-sysprep.pod:423 ../tools/virt-list-filesystems.pl:192 ../tools/virt-list-partitions.pl:262 ../tools/virt-make-fs.pl:585 ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:752 msgid "" "Libvirt guest names can contain arbitrary characters, some of which have " "meaning to the shell such as C<#> and space. You may need to quote or " @@ -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:151 ../examples/guestfs-faq.pod:157 ../examples/guestfs-faq.pod:196 ../examples/guestfs-faq.pod:202 ../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:98 ../examples/guestfs-recipes.pod:102 ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132 ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227 ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235 ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243 ../examples/guestfs-testing.pod:110 ../examples/guestfs-testing.pod:114 ../examples/guestfs-testing.pod:118 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:441 ../fish/guestfish-actions.pod:449 ../fish/guestfish-actions.pod:456 ../fish/guestfish-actions.pod:463 ../fish/guestfish-actions.pod:1404 ../fish/guestfish-actions.pod:1408 ../fish/guestfish-actions.pod:1412 ../fish/guestfish-actions.pod:1416 ../fish/guestfish-actions.pod:1424 ../fish/guestfish-actions.pod:1428 ../fish/guestfish-actions.pod:1432 ../fish/guestfish-actions.pod:1442 ../fish/guestfish-actions.pod:1446 ../fish/guestfish-actions.pod:1450 ../fish/guestfish-actions.pod:1540 ../fish/guestfish-actions.pod:1544 ../fish/guestfish-actions.pod:1549 ../fish/guestfish-actions.pod:1554 ../fish/guestfish-actions.pod:1596 ../fish/guestfish-actions.pod:1600 ../fish/guestfish-actions.pod:1605 ../fish/guestfish-actions.pod:1991 ../fish/guestfish-actions.pod:1998 ../fish/guestfish-actions.pod:2005 ../fish/guestfish-actions.pod:2418 ../fish/guestfish-actions.pod:2424 ../fish/guestfish-actions.pod:2432 ../fish/guestfish-actions.pod:2439 ../fish/guestfish-actions.pod:2446 ../fish/guestfish.pod:457 ../fish/guestfish.pod:461 ../fish/guestfish.pod:465 ../fish/guestfish.pod:469 ../inspector/virt-inspector.pod:514 ../inspector/virt-inspector.pod:518 ../resize/virt-resize.pod:365 ../resize/virt-resize.pod:369 ../resize/virt-resize.pod:378 ../resize/virt-resize.pod:384 ../sparsify/virt-sparsify.pod:32 ../sparsify/virt-sparsify.pod:39 ../sparsify/virt-sparsify.pod:43 ../sparsify/virt-sparsify.pod:49 ../sparsify/virt-sparsify.pod:54 ../sparsify/virt-sparsify.pod:59 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:29 ../src/guestfs-actions.pod:641 ../src/guestfs-actions.pod:649 ../src/guestfs-actions.pod:656 ../src/guestfs-actions.pod:663 ../src/guestfs-actions.pod:2368 ../src/guestfs-actions.pod:2372 ../src/guestfs-actions.pod:2376 ../src/guestfs-actions.pod:2380 ../src/guestfs-actions.pod:2388 ../src/guestfs-actions.pod:2392 ../src/guestfs-actions.pod:2396 ../src/guestfs-actions.pod:2406 ../src/guestfs-actions.pod:2410 ../src/guestfs-actions.pod:2414 ../src/guestfs-actions.pod:2552 ../src/guestfs-actions.pod:2556 ../src/guestfs-actions.pod:2561 ../src/guestfs-actions.pod:2566 ../src/guestfs-actions.pod:2627 ../src/guestfs-actions.pod:2631 ../src/guestfs-actions.pod:2636 ../src/guestfs-actions.pod:3194 ../src/guestfs-actions.pod:3201 ../src/guestfs-actions.pod:3208 ../src/guestfs-actions.pod:3763 ../src/guestfs-actions.pod:3769 ../src/guestfs-actions.pod:3777 ../src/guestfs-actions.pod:3784 ../src/guestfs-actions.pod:3791 ../src/guestfs.pod:390 ../src/guestfs.pod:395 ../src/guestfs.pod:400 ../src/guestfs.pod:404 ../src/guestfs.pod:409 ../src/guestfs.pod:413 ../src/guestfs.pod:418 ../src/guestfs.pod:423 ../src/guestfs.pod:1177 ../src/guestfs.pod:1181 ../src/guestfs.pod:1185 ../src/guestfs.pod:1190 ../src/guestfs.pod:1198 ../src/guestfs.pod:1217 ../src/guestfs.pod:1225 ../src/guestfs.pod:1247 ../src/guestfs.pod:1251 ../src/guestfs.pod:1255 ../src/guestfs.pod:1259 ../src/guestfs.pod:1263 ../src/guestfs.pod:1267 ../src/guestfs.pod:1757 ../src/guestfs.pod:1762 ../src/guestfs.pod:1766 ../src/guestfs.pod:1868 ../src/guestfs.pod:1873 ../src/guestfs.pod:1877 ../src/guestfs.pod:1887 ../src/guestfs.pod:2176 ../src/guestfs.pod:2181 ../src/guestfs.pod:2187 ../src/guestfs.pod:2195 ../src/guestfs.pod:2712 ../src/guestfs.pod:2718 ../src/guestfs.pod:2723 ../src/guestfs.pod:2729 ../src/guestfs.pod:3120 ../src/guestfs.pod:3125 ../src/guestfs.pod:3129 ../src/guestfs.pod:3133 ../src/guestfs.pod:3137 ../src/guestfs.pod:3151 ../src/guestfs.pod:3156 ../src/guestfs.pod:3393 ../src/guestfs.pod:3397 ../src/guestfs.pod:3401 ../src/guestfs.pod:3405 ../sysprep/virt-sysprep.pod:230 ../sysprep/virt-sysprep.pod:234 ../sysprep/virt-sysprep.pod:238 ../sysprep/virt-sysprep.pod:242 ../sysprep/virt-sysprep.pod:257 ../sysprep/virt-sysprep.pod:261 ../sysprep/virt-sysprep.pod:265 ../sysprep/virt-sysprep.pod:269 ../sysprep/virt-sysprep.pod:273 ../sysprep/virt-sysprep.pod:309 ../sysprep/virt-sysprep.pod:331 ../sysprep/virt-sysprep.pod:335 ../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:151 ../examples/guestfs-faq.pod:157 ../examples/guestfs-faq.pod:196 ../examples/guestfs-faq.pod:202 ../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:98 ../examples/guestfs-recipes.pod:102 ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132 ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227 ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235 ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243 ../examples/guestfs-testing.pod:110 ../examples/guestfs-testing.pod:114 ../examples/guestfs-testing.pod:118 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:441 ../fish/guestfish-actions.pod:449 ../fish/guestfish-actions.pod:456 ../fish/guestfish-actions.pod:463 ../fish/guestfish-actions.pod:1416 ../fish/guestfish-actions.pod:1420 ../fish/guestfish-actions.pod:1424 ../fish/guestfish-actions.pod:1428 ../fish/guestfish-actions.pod:1436 ../fish/guestfish-actions.pod:1440 ../fish/guestfish-actions.pod:1444 ../fish/guestfish-actions.pod:1454 ../fish/guestfish-actions.pod:1458 ../fish/guestfish-actions.pod:1462 ../fish/guestfish-actions.pod:1552 ../fish/guestfish-actions.pod:1556 ../fish/guestfish-actions.pod:1561 ../fish/guestfish-actions.pod:1566 ../fish/guestfish-actions.pod:1608 ../fish/guestfish-actions.pod:1612 ../fish/guestfish-actions.pod:1617 ../fish/guestfish-actions.pod:2003 ../fish/guestfish-actions.pod:2010 ../fish/guestfish-actions.pod:2017 ../fish/guestfish-actions.pod:2430 ../fish/guestfish-actions.pod:2436 ../fish/guestfish-actions.pod:2444 ../fish/guestfish-actions.pod:2451 ../fish/guestfish-actions.pod:2458 ../fish/guestfish.pod:457 ../fish/guestfish.pod:461 ../fish/guestfish.pod:465 ../fish/guestfish.pod:469 ../inspector/virt-inspector.pod:514 ../inspector/virt-inspector.pod:518 ../resize/virt-resize.pod:365 ../resize/virt-resize.pod:369 ../resize/virt-resize.pod:378 ../resize/virt-resize.pod:384 ../sparsify/virt-sparsify.pod:32 ../sparsify/virt-sparsify.pod:39 ../sparsify/virt-sparsify.pod:43 ../sparsify/virt-sparsify.pod:49 ../sparsify/virt-sparsify.pod:54 ../sparsify/virt-sparsify.pod:59 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:29 ../src/guestfs-actions.pod:641 ../src/guestfs-actions.pod:649 ../src/guestfs-actions.pod:656 ../src/guestfs-actions.pod:663 ../src/guestfs-actions.pod:2384 ../src/guestfs-actions.pod:2388 ../src/guestfs-actions.pod:2392 ../src/guestfs-actions.pod:2396 ../src/guestfs-actions.pod:2404 ../src/guestfs-actions.pod:2408 ../src/guestfs-actions.pod:2412 ../src/guestfs-actions.pod:2422 ../src/guestfs-actions.pod:2426 ../src/guestfs-actions.pod:2430 ../src/guestfs-actions.pod:2568 ../src/guestfs-actions.pod:2572 ../src/guestfs-actions.pod:2577 ../src/guestfs-actions.pod:2582 ../src/guestfs-actions.pod:2643 ../src/guestfs-actions.pod:2647 ../src/guestfs-actions.pod:2652 ../src/guestfs-actions.pod:3210 ../src/guestfs-actions.pod:3217 ../src/guestfs-actions.pod:3224 ../src/guestfs-actions.pod:3779 ../src/guestfs-actions.pod:3785 ../src/guestfs-actions.pod:3793 ../src/guestfs-actions.pod:3800 ../src/guestfs-actions.pod:3807 ../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:1175 ../src/guestfs.pod:1179 ../src/guestfs.pod:1183 ../src/guestfs.pod:1188 ../src/guestfs.pod:1196 ../src/guestfs.pod:1215 ../src/guestfs.pod:1223 ../src/guestfs.pod:1245 ../src/guestfs.pod:1249 ../src/guestfs.pod:1253 ../src/guestfs.pod:1257 ../src/guestfs.pod:1261 ../src/guestfs.pod:1265 ../src/guestfs.pod:1780 ../src/guestfs.pod:1785 ../src/guestfs.pod:1789 ../src/guestfs.pod:1891 ../src/guestfs.pod:1896 ../src/guestfs.pod:1900 ../src/guestfs.pod:1910 ../src/guestfs.pod:2199 ../src/guestfs.pod:2204 ../src/guestfs.pod:2210 ../src/guestfs.pod:2218 ../src/guestfs.pod:2735 ../src/guestfs.pod:2741 ../src/guestfs.pod:2746 ../src/guestfs.pod:2752 ../src/guestfs.pod:3143 ../src/guestfs.pod:3148 ../src/guestfs.pod:3152 ../src/guestfs.pod:3156 ../src/guestfs.pod:3160 ../src/guestfs.pod:3174 ../src/guestfs.pod:3179 ../src/guestfs.pod:3416 ../src/guestfs.pod:3420 ../src/guestfs.pod:3424 ../src/guestfs.pod:3428 ../sysprep/virt-sysprep.pod:230 ../sysprep/virt-sysprep.pod:234 ../sysprep/virt-sysprep.pod:238 ../sysprep/virt-sysprep.pod:242 ../sysprep/virt-sysprep.pod:257 ../sysprep/virt-sysprep.pod:261 ../sysprep/virt-sysprep.pod:265 ../sysprep/virt-sysprep.pod:269 ../sysprep/virt-sysprep.pod:273 ../sysprep/virt-sysprep.pod:309 ../sysprep/virt-sysprep.pod:331 ../sysprep/virt-sysprep.pod:335 ../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 "" @@ -765,8 +765,8 @@ msgstr "" msgid "successful exit, all partitions are aligned E<ge> 64K for best performance" msgstr "" -#. type: textblock -#: ../align/virt-alignment-scan.pod:355 +#. type: =item +#: ../align/virt-alignment-scan.pod:355 ../src/guestfs.pod:1437 msgid "1" msgstr "" @@ -775,8 +775,8 @@ msgstr "" msgid "an error scanning the disk image or guest" msgstr "" -#. type: textblock -#: ../align/virt-alignment-scan.pod:361 +#. type: =item +#: ../align/virt-alignment-scan.pod:361 ../src/guestfs.pod:1441 msgid "2" msgstr "" @@ -787,8 +787,8 @@ msgid "" "in poor performance on high end network storage" msgstr "" -#. type: textblock -#: ../align/virt-alignment-scan.pod:368 +#. type: =item +#: ../align/virt-alignment-scan.pod:368 ../src/guestfs.pod:1445 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:658 ../examples/guestfs-performance.pod:364 ../examples/guestfs-recipes.pod:384 ../examples/guestfs-testing.pod:291 ../fish/guestfish.pod:1280 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../format/virt-format.pod:177 ../fuse/guestmount.pod:317 ../inspector/virt-inspector.pod:501 ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39 ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:340 ../resize/virt-resize.pod:702 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:286 ../src/guestfs.pod:3328 ../sysprep/virt-sysprep.pod:432 ../test-tool/libguestfs-test-tool.pod:106 ../tools/virt-list-filesystems.pl:197 ../tools/virt-list-partitions.pl:267 ../tools/virt-make-fs.pl:591 ../tools/virt-tar.pl:296 ../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:658 ../examples/guestfs-performance.pod:364 ../examples/guestfs-recipes.pod:384 ../examples/guestfs-testing.pod:291 ../fish/guestfish.pod:1280 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../format/virt-format.pod:177 ../fuse/guestmount.pod:317 ../inspector/virt-inspector.pod:501 ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39 ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:340 ../resize/virt-resize.pod:702 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:286 ../src/guestfs.pod:3351 ../sysprep/virt-sysprep.pod:432 ../test-tool/libguestfs-test-tool.pod:106 ../tools/virt-list-filesystems.pl:197 ../tools/virt-list-partitions.pl:267 ../tools/virt-make-fs.pl:590 ../tools/virt-tar.pl:294 ../tools/virt-win-reg.pl:757 msgid "SEE ALSO" msgstr "" @@ -812,17 +812,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:384 ../cat/virt-cat.pod:252 ../cat/virt-filesystems.pod:400 ../cat/virt-ls.pod:507 ../df/virt-df.pod:261 ../edit/virt-edit.pod:382 ../format/virt-format.pod:187 ../rescue/virt-rescue.pod:349 ../resize/virt-resize.pod:725 ../sparsify/virt-sparsify.pod:299 ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:617 ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:783 +#: ../align/virt-alignment-scan.pod:384 ../cat/virt-cat.pod:252 ../cat/virt-filesystems.pod:400 ../cat/virt-ls.pod:507 ../df/virt-df.pod:261 ../edit/virt-edit.pod:382 ../format/virt-format.pod:187 ../rescue/virt-rescue.pod:349 ../resize/virt-resize.pod:725 ../sparsify/virt-sparsify.pod:299 ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:616 ../tools/virt-tar.pl:309 ../tools/virt-win-reg.pl:783 msgid "AUTHOR" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:386 ../cat/virt-cat.pod:254 ../cat/virt-filesystems.pod:402 ../cat/virt-ls.pod:509 ../df/virt-df.pod:263 ../edit/virt-edit.pod:384 ../format/virt-format.pod:189 ../inspector/virt-inspector.pod:516 ../rescue/virt-rescue.pod:351 ../resize/virt-resize.pod:727 ../sparsify/virt-sparsify.pod:301 ../sysprep/virt-sysprep.pod:449 ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281 ../tools/virt-make-fs.pl:619 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:785 +#: ../align/virt-alignment-scan.pod:386 ../cat/virt-cat.pod:254 ../cat/virt-filesystems.pod:402 ../cat/virt-ls.pod:509 ../df/virt-df.pod:263 ../edit/virt-edit.pod:384 ../format/virt-format.pod:189 ../inspector/virt-inspector.pod:516 ../rescue/virt-rescue.pod:351 ../resize/virt-resize.pod:727 ../sparsify/virt-sparsify.pod:301 ../sysprep/virt-sysprep.pod:449 ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281 ../tools/virt-make-fs.pl:618 ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:785 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod: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:668 ../examples/guestfs-performance.pod:379 ../examples/guestfs-recipes.pod:401 ../examples/guestfs-testing.pod:302 ../fish/guestfish.pod:1312 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../format/virt-format.pod:191 ../fuse/guestmount.pod:332 ../inspector/virt-inspector.pod:524 ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56 ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:353 ../resize/virt-resize.pod:729 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:303 ../src/guestfs.pod:3416 ../sysprep/virt-sysprep.pod:453 ../test-tool/libguestfs-test-tool.pod:116 ../tools/virt-list-filesystems.pl:214 ../tools/virt-list-partitions.pl:283 ../tools/virt-make-fs.pl:621 ../tools/virt-tar.pl:315 ../tools/virt-win-reg.pl:787 +#: ../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:668 ../examples/guestfs-performance.pod:379 ../examples/guestfs-recipes.pod:401 ../examples/guestfs-testing.pod:302 ../fish/guestfish.pod:1312 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../format/virt-format.pod:191 ../fuse/guestmount.pod:332 ../inspector/virt-inspector.pod:524 ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56 ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:353 ../resize/virt-resize.pod:729 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:303 ../src/guestfs.pod:3439 ../sysprep/virt-sysprep.pod:453 ../test-tool/libguestfs-test-tool.pod:116 ../tools/virt-list-filesystems.pl:214 ../tools/virt-list-partitions.pl:283 ../tools/virt-make-fs.pl:620 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:787 msgid "COPYRIGHT" msgstr "" @@ -832,7 +832,7 @@ msgid "Copyright (C) 2011 Red Hat Inc." msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:392 ../appliance/libguestfs-make-fixed-appliance.pod:162 ../cat/virt-cat.pod:260 ../cat/virt-filesystems.pod:408 ../cat/virt-ls.pod:515 ../df/virt-df.pod:269 ../edit/virt-edit.pod:390 ../fish/guestfish.pod:1317 ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60 ../format/virt-format.pod:195 ../fuse/guestmount.pod:337 ../inspector/virt-inspector.pod:528 ../rescue/virt-rescue.pod:357 ../resize/virt-resize.pod:733 ../sparsify/virt-sparsify.pod:307 ../sysprep/virt-sysprep.pod:459 ../test-tool/libguestfs-test-tool.pod:121 ../tools/virt-list-filesystems.pl:218 ../tools/virt-list-partitions.pl:287 ../tools/virt-make-fs.pl:625 ../tools/virt-tar.pl:319 ../tools/virt-win-reg.pl:791 +#: ../align/virt-alignment-scan.pod:392 ../appliance/libguestfs-make-fixed-appliance.pod:162 ../cat/virt-cat.pod:260 ../cat/virt-filesystems.pod:408 ../cat/virt-ls.pod:515 ../df/virt-df.pod:269 ../edit/virt-edit.pod:390 ../fish/guestfish.pod:1317 ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60 ../format/virt-format.pod:195 ../fuse/guestmount.pod:337 ../inspector/virt-inspector.pod:528 ../rescue/virt-rescue.pod:357 ../resize/virt-resize.pod:733 ../sparsify/virt-sparsify.pod:307 ../sysprep/virt-sysprep.pod:459 ../test-tool/libguestfs-test-tool.pod:121 ../tools/virt-list-filesystems.pl:218 ../tools/virt-list-partitions.pl:287 ../tools/virt-make-fs.pl:624 ../tools/virt-tar.pl:317 ../tools/virt-win-reg.pl:791 msgid "" "This program is free software; you can redistribute it and/or modify it " "under the terms of the GNU General Public License as published by the Free " @@ -841,7 +841,7 @@ msgid "" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:397 ../appliance/libguestfs-make-fixed-appliance.pod:167 ../cat/virt-cat.pod:265 ../cat/virt-filesystems.pod:413 ../cat/virt-ls.pod:520 ../df/virt-df.pod:274 ../edit/virt-edit.pod:395 ../fish/guestfish.pod:1322 ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65 ../format/virt-format.pod:200 ../fuse/guestmount.pod:342 ../inspector/virt-inspector.pod:533 ../rescue/virt-rescue.pod:362 ../resize/virt-resize.pod:738 ../sparsify/virt-sparsify.pod:312 ../sysprep/virt-sysprep.pod:464 ../test-tool/libguestfs-test-tool.pod:126 ../tools/virt-list-filesystems.pl:223 ../tools/virt-list-partitions.pl:292 ../tools/virt-make-fs.pl:630 ../tools/virt-tar.pl:324 ../tools/virt-win-reg.pl:796 +#: ../align/virt-alignment-scan.pod:397 ../appliance/libguestfs-make-fixed-appliance.pod:167 ../cat/virt-cat.pod:265 ../cat/virt-filesystems.pod:413 ../cat/virt-ls.pod:520 ../df/virt-df.pod:274 ../edit/virt-edit.pod:395 ../fish/guestfish.pod:1322 ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65 ../format/virt-format.pod:200 ../fuse/guestmount.pod:342 ../inspector/virt-inspector.pod:533 ../rescue/virt-rescue.pod:362 ../resize/virt-resize.pod:738 ../sparsify/virt-sparsify.pod:312 ../sysprep/virt-sysprep.pod:464 ../test-tool/libguestfs-test-tool.pod:126 ../tools/virt-list-filesystems.pl:223 ../tools/virt-list-partitions.pl:292 ../tools/virt-make-fs.pl:629 ../tools/virt-tar.pl:322 ../tools/virt-win-reg.pl:796 msgid "" "This program is distributed in the hope that it will be useful, but WITHOUT " "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or " @@ -850,7 +850,7 @@ msgid "" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:402 ../appliance/libguestfs-make-fixed-appliance.pod:172 ../cat/virt-cat.pod:270 ../cat/virt-filesystems.pod:418 ../cat/virt-ls.pod:525 ../df/virt-df.pod:279 ../edit/virt-edit.pod:400 ../fish/guestfish.pod:1327 ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70 ../format/virt-format.pod:205 ../fuse/guestmount.pod:347 ../inspector/virt-inspector.pod:538 ../rescue/virt-rescue.pod:367 ../resize/virt-resize.pod:743 ../sparsify/virt-sparsify.pod:317 ../sysprep/virt-sysprep.pod:469 ../test-tool/libguestfs-test-tool.pod:131 ../tools/virt-list-filesystems.pl:228 ../tools/virt-list-partitions.pl:297 ../tools/virt-make-fs.pl:635 ../tools/virt-tar.pl:329 ../tools/virt-win-reg.pl:801 +#: ../align/virt-alignment-scan.pod:402 ../appliance/libguestfs-make-fixed-appliance.pod:172 ../cat/virt-cat.pod:270 ../cat/virt-filesystems.pod:418 ../cat/virt-ls.pod:525 ../df/virt-df.pod:279 ../edit/virt-edit.pod:400 ../fish/guestfish.pod:1327 ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70 ../format/virt-format.pod:205 ../fuse/guestmount.pod:347 ../inspector/virt-inspector.pod:538 ../rescue/virt-rescue.pod:367 ../resize/virt-resize.pod:743 ../sparsify/virt-sparsify.pod:317 ../sysprep/virt-sysprep.pod:469 ../test-tool/libguestfs-test-tool.pod:131 ../tools/virt-list-filesystems.pl:228 ../tools/virt-list-partitions.pl:297 ../tools/virt-make-fs.pl:634 ../tools/virt-tar.pl:327 ../tools/virt-win-reg.pl:801 msgid "" "You should have received a copy of the GNU General Public License along with " "this program; if not, write to the Free Software Foundation, Inc., 51 " @@ -1104,7 +1104,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../appliance/libguestfs-make-fixed-appliance.pod:139 ../edit/virt-edit.pod:343 ../fish/guestfish.pod:1131 ../rescue/virt-rescue.pod:313 ../sparsify/virt-sparsify.pod:259 ../src/guestfs.pod:3267 ../test-tool/libguestfs-test-tool.pod:101 +#: ../appliance/libguestfs-make-fixed-appliance.pod:139 ../edit/virt-edit.pod:343 ../fish/guestfish.pod:1131 ../rescue/virt-rescue.pod:313 ../sparsify/virt-sparsify.pod:259 ../src/guestfs.pod:3290 ../test-tool/libguestfs-test-tool.pod:101 msgid "ENVIRONMENT VARIABLES" msgstr "" @@ -1123,17 +1123,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:664 ../examples/guestfs-performance.pod:375 ../examples/guestfs-recipes.pod:397 ../examples/guestfs-testing.pod:298 ../fish/guestfish.pod:1308 ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:510 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52 ../python/examples/guestfs-python.pod:54 ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3412 ../sysprep/virt-sysprep.pod:447 ../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:664 ../examples/guestfs-performance.pod:375 ../examples/guestfs-recipes.pod:397 ../examples/guestfs-testing.pod:298 ../fish/guestfish.pod:1308 ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:510 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52 ../python/examples/guestfs-python.pod:54 ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3435 ../sysprep/virt-sysprep.pod:447 ../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:666 ../examples/guestfs-performance.pod:377 ../examples/guestfs-recipes.pod:399 ../examples/guestfs-testing.pod:300 ../fish/guestfish.pod:1310 ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:330 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:54 ../python/examples/guestfs-python.pod:56 ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3414 ../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:666 ../examples/guestfs-performance.pod:377 ../examples/guestfs-recipes.pod:399 ../examples/guestfs-testing.pod:300 ../fish/guestfish.pod:1310 ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:330 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:54 ../python/examples/guestfs-python.pod:56 ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3437 ../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 ../fish/guestfish.pod:1314 ../fuse/guestmount.pod:334 ../src/guestfs.pod:3418 ../test-tool/libguestfs-test-tool.pod:118 +#: ../appliance/libguestfs-make-fixed-appliance.pod:159 ../fish/guestfish.pod:1314 ../fuse/guestmount.pod:334 ../src/guestfs.pod:3441 ../test-tool/libguestfs-test-tool.pod:118 msgid "Copyright (C) 2009-2012 Red Hat Inc. L<http://libguestfs.org/>" msgstr "" @@ -1503,7 +1503,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:258 ../inspector/virt-inspector.pod:526 ../resize/virt-resize.pod:731 ../tools/virt-make-fs.pl:623 +#: ../cat/virt-cat.pod:258 ../inspector/virt-inspector.pod:526 ../resize/virt-resize.pod:731 ../tools/virt-make-fs.pl:622 msgid "Copyright (C) 2010-2012 Red Hat Inc." msgstr "" @@ -2570,7 +2570,7 @@ msgid "" msgstr "" #. type: =head2 -#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:5029 +#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:5061 msgid "path" msgstr "" @@ -3957,7 +3957,7 @@ msgid "" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:121 ../examples/guestfs-examples.pod:56 ../examples/guestfs-faq.pod:672 ../examples/guestfs-performance.pod:383 ../examples/guestfs-recipes.pod:408 ../examples/guestfs-testing.pod:306 ../java/examples/guestfs-java.pod:69 ../ocaml/examples/guestfs-ocaml.pod:102 ../perl/examples/guestfs-perl.pod:63 ../python/examples/guestfs-python.pod:65 ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3421 +#: ../erlang/examples/guestfs-erlang.pod:121 ../examples/guestfs-examples.pod:56 ../examples/guestfs-faq.pod:672 ../examples/guestfs-performance.pod:383 ../examples/guestfs-recipes.pod:408 ../examples/guestfs-testing.pod:306 ../java/examples/guestfs-java.pod:69 ../ocaml/examples/guestfs-ocaml.pod:102 ../perl/examples/guestfs-perl.pod:63 ../python/examples/guestfs-python.pod:65 ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3444 msgid "" "This library is free software; you can redistribute it and/or modify it " "under the terms of the GNU Lesser General Public License as published by the " @@ -3966,7 +3966,7 @@ msgid "" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:126 ../examples/guestfs-examples.pod:61 ../examples/guestfs-faq.pod:677 ../examples/guestfs-performance.pod:388 ../examples/guestfs-recipes.pod:413 ../examples/guestfs-testing.pod:311 ../java/examples/guestfs-java.pod:74 ../ocaml/examples/guestfs-ocaml.pod:107 ../perl/examples/guestfs-perl.pod:68 ../python/examples/guestfs-python.pod:70 ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3426 +#: ../erlang/examples/guestfs-erlang.pod:126 ../examples/guestfs-examples.pod:61 ../examples/guestfs-faq.pod:677 ../examples/guestfs-performance.pod:388 ../examples/guestfs-recipes.pod:413 ../examples/guestfs-testing.pod:311 ../java/examples/guestfs-java.pod:74 ../ocaml/examples/guestfs-ocaml.pod:107 ../perl/examples/guestfs-perl.pod:68 ../python/examples/guestfs-python.pod:70 ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3449 msgid "" "This library is distributed in the hope that it will be useful, but WITHOUT " "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or " @@ -3975,7 +3975,7 @@ msgid "" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:131 ../examples/guestfs-examples.pod:66 ../examples/guestfs-faq.pod:682 ../examples/guestfs-performance.pod:393 ../examples/guestfs-recipes.pod:418 ../examples/guestfs-testing.pod:316 ../java/examples/guestfs-java.pod:79 ../ocaml/examples/guestfs-ocaml.pod:112 ../perl/examples/guestfs-perl.pod:73 ../python/examples/guestfs-python.pod:75 ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3431 +#: ../erlang/examples/guestfs-erlang.pod:131 ../examples/guestfs-examples.pod:66 ../examples/guestfs-faq.pod:682 ../examples/guestfs-performance.pod:393 ../examples/guestfs-recipes.pod:418 ../examples/guestfs-testing.pod:316 ../java/examples/guestfs-java.pod:79 ../ocaml/examples/guestfs-ocaml.pod:112 ../perl/examples/guestfs-perl.pod:73 ../python/examples/guestfs-python.pod:75 ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3454 msgid "" "You should have received a copy of the GNU Lesser General Public License " "along with this library; if not, write to the Free Software Foundation, " @@ -4006,7 +4006,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-examples.pod:15 ../src/guestfs.pod:19 +#: ../examples/guestfs-examples.pod:15 ../src/guestfs.pod:20 #, no-wrap msgid "" " cc prog.c -o prog -lguestfs\n" @@ -4473,7 +4473,7 @@ msgid "DOWNLOADING, INSTALLING, COMPILING LIBGUESTFS" msgstr "" #. type: =end -#: ../examples/guestfs-faq.pod:219 ../examples/guestfs-faq.pod:224 ../examples/guestfs-faq.pod:431 ../examples/guestfs-faq.pod:436 ../src/guestfs.pod:2322 ../src/guestfs.pod:2327 +#: ../examples/guestfs-faq.pod:219 ../examples/guestfs-faq.pod:224 ../examples/guestfs-faq.pod:431 ../examples/guestfs-faq.pod:436 ../src/guestfs.pod:2345 ../src/guestfs.pod:2350 msgid "html" msgstr "" @@ -5683,7 +5683,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:230 ../src/guestfs.pod:471 ../src/guestfs.pod:1370 ../src/guestfs.pod:1509 ../src/guestfs.pod:2757 +#: ../examples/guestfs-performance.pod:162 ../examples/guestfs-performance.pod:211 ../resize/virt-resize.pod:31 ../resize/virt-resize.pod:603 ../sparsify/virt-sparsify.pod:230 ../src/guestfs.pod:469 ../src/guestfs.pod:1368 ../src/guestfs.pod:1532 ../src/guestfs.pod:2780 msgid "1." msgstr "" @@ -5695,7 +5695,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:237 ../src/guestfs.pod:477 ../src/guestfs.pod:1374 ../src/guestfs.pod:1513 ../src/guestfs.pod:2782 +#: ../examples/guestfs-performance.pod:168 ../examples/guestfs-performance.pod:218 ../resize/virt-resize.pod:44 ../resize/virt-resize.pod:610 ../sparsify/virt-sparsify.pod:237 ../src/guestfs.pod:475 ../src/guestfs.pod:1372 ../src/guestfs.pod:1536 ../src/guestfs.pod:2805 msgid "2." msgstr "" @@ -5710,7 +5710,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:243 ../src/guestfs.pod:488 ../src/guestfs.pod:1519 +#: ../examples/guestfs-performance.pod:176 ../examples/guestfs-performance.pod:224 ../resize/virt-resize.pod:52 ../resize/virt-resize.pod:616 ../sparsify/virt-sparsify.pod:243 ../src/guestfs.pod:486 ../src/guestfs.pod:1542 msgid "3." msgstr "" @@ -5933,7 +5933,7 @@ msgid "Save the following script as C<time.stap>:" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:305 ../src/guestfs.pod:2270 +#: ../examples/guestfs-performance.pod:305 ../src/guestfs.pod:2293 #, no-wrap msgid "" " global last;\n" @@ -5941,7 +5941,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:307 ../src/guestfs.pod:2272 +#: ../examples/guestfs-performance.pod:307 ../src/guestfs.pod:2295 #, no-wrap msgid "" " function display_time () {\n" @@ -5954,7 +5954,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:314 ../src/guestfs.pod:2279 +#: ../examples/guestfs-performance.pod:314 ../src/guestfs.pod:2302 #, no-wrap msgid "" " printf (\"%d (+%d):\", now, delta);\n" @@ -5963,7 +5963,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:317 ../src/guestfs.pod:2282 +#: ../examples/guestfs-performance.pod:317 ../src/guestfs.pod:2305 #, no-wrap msgid "" " probe begin {\n" @@ -5974,7 +5974,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:322 ../src/guestfs.pod:2287 +#: ../examples/guestfs-performance.pod:322 ../src/guestfs.pod:2310 #, no-wrap msgid "" " /* Display all calls to static markers. */\n" @@ -6342,7 +6342,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1592 ../fish/guestfish-actions.pod:1987 ../fish/guestfish-actions.pod:2414 ../src/guestfs-actions.pod:18 ../src/guestfs-actions.pod:2623 ../src/guestfs-actions.pod:3190 ../src/guestfs-actions.pod:3759 ../src/guestfs.pod:1753 ../tools/virt-win-reg.pl:717 +#: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1604 ../fish/guestfish-actions.pod:1999 ../fish/guestfish-actions.pod:2426 ../src/guestfs-actions.pod:18 ../src/guestfs-actions.pod:2639 ../src/guestfs-actions.pod:3206 ../src/guestfs-actions.pod:3775 ../src/guestfs.pod:1776 ../tools/virt-win-reg.pl:717 msgid "Notes:" msgstr "" @@ -6982,7 +6982,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:2860 +#: ../examples/guestfs-testing.pod:54 ../examples/guestfs-testing.pod:161 ../examples/guestfs-testing.pod:174 ../examples/guestfs-testing.pod:234 ../src/guestfs.pod:2883 msgid "or:" msgstr "" @@ -7156,7 +7156,7 @@ msgid "Try importing virt-df CSV output into a spreadsheet or database." msgstr "" #. type: textblock -#: ../examples/guestfs-testing.pod:131 ../src/guestfs.pod:3141 +#: ../examples/guestfs-testing.pod:131 ../src/guestfs.pod:3164 msgid "Run:" msgstr "" @@ -7615,7 +7615,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:217 ../fish/guestfish-actions.pod:231 ../fish/guestfish-actions.pod:1051 ../fish/guestfish-actions.pod:1086 ../fish/guestfish-actions.pod:1223 ../fish/guestfish-actions.pod:1291 ../fish/guestfish-actions.pod:1777 ../fish/guestfish-actions.pod:1791 ../fish/guestfish-actions.pod:3762 ../fish/guestfish-actions.pod:4188 ../fish/guestfish-actions.pod:4236 ../fish/guestfish-actions.pod:4964 ../fish/guestfish-actions.pod:5212 ../fish/guestfish-actions.pod:5232 ../fish/guestfish-actions.pod:5251 ../fish/guestfish-actions.pod:5289 ../fish/guestfish-actions.pod:6051 ../fish/guestfish-actions.pod:6167 ../src/guestfs-actions.pod:10 ../src/guestfs-actions.pod:305 ../src/guestfs-actions.pod:326 ../src/guestfs-actions.pod:1802 ../src/guestfs-actions.pod:1859 ../src/guestfs-actions.pod:2100 ../src/guestfs-actions.pod:2209 ../src/guestfs-actions.pod:2847 ../src/guestfs-actions.pod:2868 ../src/guestfs-actions.pod:5812 ../src/guestfs-actions.pod:6610 ../src/guestfs-actions.pod:6710 ../src/guestfs-actions.pod:7804 ../src/guestfs-actions.pod:8115 ../src/guestfs-actions.pod:8156 ../src/guestfs-actions.pod:8187 ../src/guestfs-actions.pod:8247 ../src/guestfs-actions.pod:9362 ../src/guestfs-actions.pod:9490 ../src/guestfs-actions.pod:9694 +#: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:217 ../fish/guestfish-actions.pod:231 ../fish/guestfish-actions.pod:1051 ../fish/guestfish-actions.pod:1086 ../fish/guestfish-actions.pod:1235 ../fish/guestfish-actions.pod:1303 ../fish/guestfish-actions.pod:1789 ../fish/guestfish-actions.pod:1803 ../fish/guestfish-actions.pod:3006 ../fish/guestfish-actions.pod:3783 ../fish/guestfish-actions.pod:4220 ../fish/guestfish-actions.pod:4268 ../fish/guestfish-actions.pod:4996 ../fish/guestfish-actions.pod:5244 ../fish/guestfish-actions.pod:5264 ../fish/guestfish-actions.pod:5283 ../fish/guestfish-actions.pod:5321 ../fish/guestfish-actions.pod:6103 ../fish/guestfish-actions.pod:6219 ../src/guestfs-actions.pod:10 ../src/guestfs-actions.pod:305 ../src/guestfs-actions.pod:326 ../src/guestfs-actions.pod:1802 ../src/guestfs-actions.pod:1859 ../src/guestfs-actions.pod:2116 ../src/guestfs-actions.pod:2225 ../src/guestfs-actions.pod:2863 ../src/guestfs-actions.pod:2884 ../src/guestfs-actions.pod:4582 ../src/guestfs-actions.pod:5837 ../src/guestfs-actions.pod:6649 ../src/guestfs-actions.pod:6749 ../src/guestfs-actions.pod:7843 ../src/guestfs-actions.pod:8154 ../src/guestfs-actions.pod:8195 ../src/guestfs-actions.pod:8226 ../src/guestfs-actions.pod:8286 ../src/guestfs-actions.pod:9424 ../src/guestfs-actions.pod:9552 ../src/guestfs-actions.pod:9756 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 " @@ -7779,7 +7779,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:125 ../fish/guestfish-actions.pod:194 ../fish/guestfish-actions.pod:676 ../fish/guestfish-actions.pod:691 ../fish/guestfish-actions.pod:945 ../fish/guestfish-actions.pod:966 ../fish/guestfish-actions.pod:1004 ../fish/guestfish-actions.pod:1013 ../fish/guestfish-actions.pod:1022 ../fish/guestfish-actions.pod:1036 ../fish/guestfish-actions.pod:1210 ../fish/guestfish-actions.pod:2453 ../fish/guestfish-actions.pod:3539 ../fish/guestfish-actions.pod:3778 ../fish/guestfish-actions.pod:3825 ../fish/guestfish-actions.pod:3988 ../fish/guestfish-actions.pod:4018 ../fish/guestfish-actions.pod:4150 ../fish/guestfish-actions.pod:4166 ../fish/guestfish-actions.pod:4224 ../fish/guestfish-actions.pod:4940 ../fish/guestfish-actions.pod:5653 ../fish/guestfish-actions.pod:5735 +#: ../fish/guestfish-actions.pod:125 ../fish/guestfish-actions.pod:194 ../fish/guestfish-actions.pod:676 ../fish/guestfish-actions.pod:691 ../fish/guestfish-actions.pod:945 ../fish/guestfish-actions.pod:966 ../fish/guestfish-actions.pod:1004 ../fish/guestfish-actions.pod:1013 ../fish/guestfish-actions.pod:1022 ../fish/guestfish-actions.pod:1036 ../fish/guestfish-actions.pod:1222 ../fish/guestfish-actions.pod:2465 ../fish/guestfish-actions.pod:3560 ../fish/guestfish-actions.pod:3799 ../fish/guestfish-actions.pod:3846 ../fish/guestfish-actions.pod:4009 ../fish/guestfish-actions.pod:4039 ../fish/guestfish-actions.pod:4182 ../fish/guestfish-actions.pod:4198 ../fish/guestfish-actions.pod:4256 ../fish/guestfish-actions.pod:4972 ../fish/guestfish-actions.pod:5705 ../fish/guestfish-actions.pod:5787 msgid "" "This command has one or more optional arguments. See L</OPTIONAL " "ARGUMENTS>." @@ -7858,7 +7858,7 @@ msgid "This call checks that C<filename> exists." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:161 ../fish/guestfish-actions.pod:3787 ../src/guestfs-actions.pod:221 ../src/guestfs-actions.pod:5904 +#: ../fish/guestfish-actions.pod:161 ../fish/guestfish-actions.pod:3808 ../src/guestfs-actions.pod:221 ../src/guestfs-actions.pod:5929 msgid "The optional arguments are:" msgstr "" @@ -7876,7 +7876,7 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:171 ../src/guestfs-actions.pod:231 ../src/guestfs.pod:3020 +#: ../fish/guestfish-actions.pod:171 ../src/guestfs-actions.pod:231 ../src/guestfs.pod:3043 msgid "C<format>" msgstr "" @@ -7909,7 +7909,7 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:187 ../fish/guestfish-actions.pod:3567 ../src/guestfs-actions.pod:247 ../src/guestfs-actions.pod:5509 +#: ../fish/guestfish-actions.pod:187 ../fish/guestfish-actions.pod:3588 ../src/guestfs-actions.pod:247 ../src/guestfs-actions.pod:5534 msgid "C<name>" msgstr "" @@ -8553,7 +8553,7 @@ msgid "This command uploads base64-encoded data from C<base64file> to C<filename msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:491 ../fish/guestfish-actions.pod:500 ../fish/guestfish-actions.pod:859 ../fish/guestfish-actions.pod:943 ../fish/guestfish-actions.pod:964 ../fish/guestfish-actions.pod:1135 ../fish/guestfish-actions.pod:1154 ../fish/guestfish-actions.pod:1560 ../fish/guestfish-actions.pod:4127 ../fish/guestfish-actions.pod:4148 ../fish/guestfish-actions.pod:5509 ../fish/guestfish-actions.pod:5521 ../fish/guestfish-actions.pod:5532 ../fish/guestfish-actions.pod:5543 ../fish/guestfish-actions.pod:5674 ../fish/guestfish-actions.pod:5683 ../fish/guestfish-actions.pod:5748 ../fish/guestfish-actions.pod:5771 +#: ../fish/guestfish-actions.pod:491 ../fish/guestfish-actions.pod:500 ../fish/guestfish-actions.pod:859 ../fish/guestfish-actions.pod:943 ../fish/guestfish-actions.pod:964 ../fish/guestfish-actions.pod:1147 ../fish/guestfish-actions.pod:1166 ../fish/guestfish-actions.pod:1572 ../fish/guestfish-actions.pod:4159 ../fish/guestfish-actions.pod:4180 ../fish/guestfish-actions.pod:5561 ../fish/guestfish-actions.pod:5573 ../fish/guestfish-actions.pod:5584 ../fish/guestfish-actions.pod:5595 ../fish/guestfish-actions.pod:5726 ../fish/guestfish-actions.pod:5735 ../fish/guestfish-actions.pod:5800 ../fish/guestfish-actions.pod:5823 msgid "Use C<-> instead of a filename to read/write from stdin/stdout." msgstr "" @@ -8950,12 +8950,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:663 ../fish/guestfish-actions.pod:3488 ../fish/guestfish-actions.pod:4199 ../fish/guestfish-actions.pod:5583 ../src/guestfs-actions.pod:985 ../src/guestfs-actions.pod:5402 ../src/guestfs-actions.pod:6649 ../src/guestfs-actions.pod:8734 +#: ../fish/guestfish-actions.pod:663 ../fish/guestfish-actions.pod:3509 ../fish/guestfish-actions.pod:4231 ../fish/guestfish-actions.pod:5635 ../src/guestfs-actions.pod:985 ../src/guestfs-actions.pod:5427 ../src/guestfs-actions.pod:6688 ../src/guestfs-actions.pod:8796 msgid "The optional parameters are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:667 ../fish/guestfish-actions.pod:4203 ../src/guestfs-actions.pod:989 ../src/guestfs-actions.pod:6653 +#: ../fish/guestfish-actions.pod:667 ../fish/guestfish-actions.pod:4235 ../src/guestfs-actions.pod:989 ../src/guestfs-actions.pod:6692 msgid "C<size>" msgstr "" @@ -9213,7 +9213,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:776 ../fish/guestfish-actions.pod:4630 ../src/guestfs-actions.pod:1213 ../src/guestfs-actions.pod:7309 +#: ../fish/guestfish-actions.pod:776 ../fish/guestfish-actions.pod:4662 ../src/guestfs-actions.pod:1213 ../src/guestfs-actions.pod:7348 msgid "Return the contents of the file named C<path>." msgstr "" @@ -9227,7 +9227,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:783 ../fish/guestfish-actions.pod:918 ../fish/guestfish-actions.pod:930 ../fish/guestfish-actions.pod:1245 ../fish/guestfish-actions.pod:1255 ../fish/guestfish-actions.pod:1322 ../fish/guestfish-actions.pod:1332 ../fish/guestfish-actions.pod:1524 ../fish/guestfish-actions.pod:1967 ../fish/guestfish-actions.pod:1977 ../fish/guestfish-actions.pod:2027 ../fish/guestfish-actions.pod:2042 ../fish/guestfish-actions.pod:2052 ../fish/guestfish-actions.pod:2071 ../fish/guestfish-actions.pod:4500 ../fish/guestfish-actions.pod:4515 ../fish/guestfish-actions.pod:4591 ../fish/guestfish-actions.pod:4608 ../fish/guestfish-actions.pod:4623 ../fish/guestfish-actions.pod:5350 ../fish/guestfish-actions.pod:5396 ../fish/guestfish-actions.pod:5481 ../fish/guestfish-actions.pod:5496 ../fish/guestfish-actions.pod:6015 ../fish/guestfish-actions.pod:6027 ../fish/guestfish-actions.pod:6045 ../fish/guestfish-actions.pod:6062 ../fish/guestfish-actions.pod:6072 ../fish/guestfish-actions.pod:6139 ../fish/guestfish-actions.pod:6149 ../fish/guestfish-actions.pod:6178 ../fish/guestfish-actions.pod:6188 ../src/guestfs-actions.pod:1223 ../src/guestfs-actions.pod:1402 ../src/guestfs-actions.pod:1422 ../src/guestfs-actions.pod:2144 ../src/guestfs-actions.pod:2163 ../src/guestfs-actions.pod:2266 ../src/guestfs-actions.pod:2285 ../src/guestfs-actions.pod:2531 ../src/guestfs-actions.pod:3156 ../src/guestfs-actions.pod:3175 ../src/guestfs-actions.pod:3240 ../src/guestfs-actions.pod:3264 ../src/guestfs-actions.pod:3281 ../src/guestfs-actions.pod:3310 ../src/guestfs-actions.pod:7091 ../src/guestfs-actions.pod:7117 ../src/guestfs-actions.pod:7248 ../src/guestfs-actions.pod:7274 ../src/guestfs-actions.pod:7298 ../src/guestfs-actions.pod:8362 ../src/guestfs-actions.pod:8417 ../src/guestfs-actions.pod:8563 ../src/guestfs-actions.pod:8587 ../src/guestfs-actions.pod:9454 ../src/guestfs-actions.pod:9474 ../src/guestfs-actions.pod:9507 ../src/guestfs-actions.pod:9526 ../src/guestfs-actions.pod:9545 ../src/guestfs-actions.pod:9660 ../src/guestfs-actions.pod:9679 ../src/guestfs-actions.pod:9725 ../src/guestfs-actions.pod:9744 +#: ../fish/guestfish-actions.pod:783 ../fish/guestfish-actions.pod:918 ../fish/guestfish-actions.pod:930 ../fish/guestfish-actions.pod:1257 ../fish/guestfish-actions.pod:1267 ../fish/guestfish-actions.pod:1334 ../fish/guestfish-actions.pod:1344 ../fish/guestfish-actions.pod:1536 ../fish/guestfish-actions.pod:1979 ../fish/guestfish-actions.pod:1989 ../fish/guestfish-actions.pod:2039 ../fish/guestfish-actions.pod:2054 ../fish/guestfish-actions.pod:2064 ../fish/guestfish-actions.pod:2083 ../fish/guestfish-actions.pod:4532 ../fish/guestfish-actions.pod:4547 ../fish/guestfish-actions.pod:4623 ../fish/guestfish-actions.pod:4640 ../fish/guestfish-actions.pod:4655 ../fish/guestfish-actions.pod:5402 ../fish/guestfish-actions.pod:5448 ../fish/guestfish-actions.pod:5533 ../fish/guestfish-actions.pod:5548 ../fish/guestfish-actions.pod:6067 ../fish/guestfish-actions.pod:6079 ../fish/guestfish-actions.pod:6097 ../fish/guestfish-actions.pod:6114 ../fish/guestfish-actions.pod:6124 ../fish/guestfish-actions.pod:6191 ../fish/guestfish-actions.pod:6201 ../fish/guestfish-actions.pod:6230 ../fish/guestfish-actions.pod:6240 ../src/guestfs-actions.pod:1223 ../src/guestfs-actions.pod:1402 ../src/guestfs-actions.pod:1422 ../src/guestfs-actions.pod:2160 ../src/guestfs-actions.pod:2179 ../src/guestfs-actions.pod:2282 ../src/guestfs-actions.pod:2301 ../src/guestfs-actions.pod:2547 ../src/guestfs-actions.pod:3172 ../src/guestfs-actions.pod:3191 ../src/guestfs-actions.pod:3256 ../src/guestfs-actions.pod:3280 ../src/guestfs-actions.pod:3297 ../src/guestfs-actions.pod:3326 ../src/guestfs-actions.pod:7130 ../src/guestfs-actions.pod:7156 ../src/guestfs-actions.pod:7287 ../src/guestfs-actions.pod:7313 ../src/guestfs-actions.pod:7337 ../src/guestfs-actions.pod:8424 ../src/guestfs-actions.pod:8479 ../src/guestfs-actions.pod:8625 ../src/guestfs-actions.pod:8649 ../src/guestfs-actions.pod:9516 ../src/guestfs-actions.pod:9536 ../src/guestfs-actions.pod:9569 ../src/guestfs-actions.pod:9588 ../src/guestfs-actions.pod:9607 ../src/guestfs-actions.pod:9722 ../src/guestfs-actions.pod:9741 ../src/guestfs-actions.pod:9787 ../src/guestfs-actions.pod:9806 msgid "" "Because of the message protocol, there is a transfer limit of somewhere " "between 2MB and 4MB. See L<guestfs(3)/PROTOCOL LIMITS>." @@ -9425,7 +9425,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:872 ../fish/guestfish-actions.pod:3737 ../fish/guestfish-actions.pod:3890 ../fish/guestfish-actions.pod:3900 ../fish/guestfish-actions.pod:3910 ../src/guestfs-actions.pod:1339 ../src/guestfs-actions.pod:5780 ../src/guestfs-actions.pod:6044 ../src/guestfs-actions.pod:6063 ../src/guestfs-actions.pod:6082 +#: ../fish/guestfish-actions.pod:872 ../fish/guestfish-actions.pod:3758 ../fish/guestfish-actions.pod:3911 ../fish/guestfish-actions.pod:3921 ../fish/guestfish-actions.pod:3931 ../src/guestfs-actions.pod:1339 ../src/guestfs-actions.pod:5805 ../src/guestfs-actions.pod:6069 ../src/guestfs-actions.pod:6088 ../src/guestfs-actions.pod:6107 msgid "The mode actually set is affected by the umask." msgstr "" @@ -9448,7 +9448,7 @@ msgid "Change the file owner to C<owner> and group to C<group>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:880 ../fish/guestfish-actions.pod:3009 ../src/guestfs-actions.pod:1355 ../src/guestfs-actions.pod:4601 +#: ../fish/guestfish-actions.pod:880 ../fish/guestfish-actions.pod:3030 ../src/guestfs-actions.pod:1355 ../src/guestfs-actions.pod:4626 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 " @@ -9834,24 +9834,56 @@ msgstr "" #. type: =head2 #: ../fish/guestfish-actions.pod:1090 -msgid "df" +msgid "device-index" msgstr "" #. type: verbatim #: ../fish/guestfish-actions.pod:1092 #, no-wrap msgid "" +" device-index device\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1094 ../src/guestfs-actions.pod:1883 +msgid "" +"This function takes a device name (eg. \"/dev/sdb\") and returns the index " +"of the device in the list of devices." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1097 +msgid "" +"Index numbers start from 0. The named device must exist, for example as a " +"string returned from L</list-devices>." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1100 +msgid "See also L</list-devices>, L</part-to-dev>." +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:1102 +msgid "df" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:1104 +#, no-wrap +msgid "" " df\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1094 ../src/guestfs-actions.pod:1882 +#: ../fish/guestfish-actions.pod:1106 ../src/guestfs-actions.pod:1898 msgid "This command runs the C<df> command to report disk space used." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1096 ../fish/guestfish-actions.pod:1107 +#: ../fish/guestfish-actions.pod:1108 ../fish/guestfish-actions.pod:1119 msgid "" "This command is mostly useful for interactive sessions. It is I<not> " "intended that you try to parse the output string. Use L</statvfs> from " @@ -9859,12 +9891,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1100 +#: ../fish/guestfish-actions.pod:1112 msgid "df-h" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1102 +#: ../fish/guestfish-actions.pod:1114 #, no-wrap msgid "" " df-h\n" @@ -9872,19 +9904,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1104 ../src/guestfs-actions.pod:1898 +#: ../fish/guestfish-actions.pod:1116 ../src/guestfs-actions.pod:1914 msgid "" "This command runs the C<df -h> command to report disk space used in " "human-readable format." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1111 +#: ../fish/guestfish-actions.pod:1123 msgid "dmesg" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1113 +#: ../fish/guestfish-actions.pod:1125 #, no-wrap msgid "" " dmesg\n" @@ -9892,14 +9924,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1115 ../src/guestfs-actions.pod:1915 +#: ../fish/guestfish-actions.pod:1127 ../src/guestfs-actions.pod:1931 msgid "" "This returns the kernel messages (C<dmesg> output) from the guest kernel. " "This is sometimes useful for extended debugging of problems." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1119 +#: ../fish/guestfish-actions.pod:1131 msgid "" "Another way to get the same information is to enable verbose messages with " "L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> " @@ -9907,12 +9939,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1124 +#: ../fish/guestfish-actions.pod:1136 msgid "download" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1126 +#: ../fish/guestfish-actions.pod:1138 #, no-wrap msgid "" " download remotefilename (filename|-)\n" @@ -9920,29 +9952,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1128 ../fish/guestfish-actions.pod:1141 ../src/guestfs-actions.pod:1936 ../src/guestfs-actions.pod:1961 +#: ../fish/guestfish-actions.pod:1140 ../fish/guestfish-actions.pod:1153 ../src/guestfs-actions.pod:1952 ../src/guestfs-actions.pod:1977 msgid "" "Download file C<remotefilename> and save it as C<filename> on the local " "machine." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1131 ../fish/guestfish-actions.pod:5744 ../src/guestfs-actions.pod:1939 ../src/guestfs-actions.pod:8986 +#: ../fish/guestfish-actions.pod:1143 ../fish/guestfish-actions.pod:5796 ../src/guestfs-actions.pod:1955 ../src/guestfs-actions.pod:9048 msgid "C<filename> can also be a named pipe." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1133 +#: ../fish/guestfish-actions.pod:1145 msgid "See also L</upload>, L</cat>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1137 +#: ../fish/guestfish-actions.pod:1149 msgid "download-offset" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1139 +#: ../fish/guestfish-actions.pod:1151 #, no-wrap msgid "" " download-offset remotefilename (filename|-) offset size\n" @@ -9950,14 +9982,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1144 ../src/guestfs-actions.pod:1964 +#: ../fish/guestfish-actions.pod:1156 ../src/guestfs-actions.pod:1980 msgid "" "C<remotefilename> is read for C<size> bytes starting at C<offset> (this " "region must be within the file or device)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1147 +#: ../fish/guestfish-actions.pod:1159 msgid "" "Note that there is no limit on the amount of data that can be downloaded " "with this call, unlike with L</pread>, and this call always reads the full " @@ -9965,17 +9997,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1152 +#: ../fish/guestfish-actions.pod:1164 msgid "See also L</download>, L</pread>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1156 +#: ../fish/guestfish-actions.pod:1168 msgid "drop-caches" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1158 +#: ../fish/guestfish-actions.pod:1170 #, no-wrap msgid "" " drop-caches whattodrop\n" @@ -9983,7 +10015,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1160 ../src/guestfs-actions.pod:1989 +#: ../fish/guestfish-actions.pod:1172 ../src/guestfs-actions.pod:2005 msgid "" "This instructs the guest kernel to drop its page cache, and/or dentries and " "inode caches. The parameter C<whattodrop> tells the kernel what precisely " @@ -9991,24 +10023,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1165 ../src/guestfs-actions.pod:1994 +#: ../fish/guestfish-actions.pod:1177 ../src/guestfs-actions.pod:2010 msgid "Setting C<whattodrop> to 3 should drop everything." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1167 ../src/guestfs-actions.pod:1996 +#: ../fish/guestfish-actions.pod:1179 ../src/guestfs-actions.pod:2012 msgid "" "This automatically calls L<sync(2)> before the operation, so that the " "maximum guest memory is freed." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1170 +#: ../fish/guestfish-actions.pod:1182 msgid "du" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1172 +#: ../fish/guestfish-actions.pod:1184 #, no-wrap msgid "" " du path\n" @@ -10016,14 +10048,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1174 ../src/guestfs-actions.pod:2009 +#: ../fish/guestfish-actions.pod:1186 ../src/guestfs-actions.pod:2025 msgid "" "This command runs the C<du -s> command to estimate file space usage for " "C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1177 ../src/guestfs-actions.pod:2012 +#: ../fish/guestfish-actions.pod:1189 ../src/guestfs-actions.pod:2028 msgid "" "C<path> can be a file or a directory. If C<path> is a directory then the " "estimate includes the contents of the directory and all subdirectories " @@ -10031,17 +10063,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1181 ../src/guestfs-actions.pod:2016 +#: ../fish/guestfish-actions.pod:1193 ../src/guestfs-actions.pod:2032 msgid "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1184 +#: ../fish/guestfish-actions.pod:1196 msgid "e2fsck" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1186 +#: ../fish/guestfish-actions.pod:1198 #, no-wrap msgid "" " e2fsck device [correct:true|false] [forceall:true|false]\n" @@ -10049,19 +10081,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1188 ../src/guestfs-actions.pod:2043 +#: ../fish/guestfish-actions.pod:1200 ../src/guestfs-actions.pod:2059 msgid "" "This runs the ext2/ext3 filesystem checker on C<device>. It can take the " "following optional arguments:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1193 ../src/guestfs-actions.pod:2048 +#: ../fish/guestfish-actions.pod:1205 ../src/guestfs-actions.pod:2064 msgid "C<correct>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1195 ../src/guestfs-actions.pod:2050 +#: ../fish/guestfish-actions.pod:1207 ../src/guestfs-actions.pod:2066 msgid "" "Automatically repair the file system. This option will cause e2fsck to " "automatically fix any filesystem problems that can be safely fixed without " @@ -10069,34 +10101,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1199 ../src/guestfs-actions.pod:2054 +#: ../fish/guestfish-actions.pod:1211 ../src/guestfs-actions.pod:2070 msgid "This option may not be specified at the same time as the C<forceall> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1201 ../src/guestfs-actions.pod:2056 +#: ../fish/guestfish-actions.pod:1213 ../src/guestfs-actions.pod:2072 msgid "C<forceall>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1203 ../src/guestfs-actions.pod:2058 +#: ../fish/guestfish-actions.pod:1215 ../src/guestfs-actions.pod:2074 msgid "" "Assume an answer of 'yes' to all questions; allows e2fsck to be used " "non-interactively." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1206 ../src/guestfs-actions.pod:2061 +#: ../fish/guestfish-actions.pod:1218 ../src/guestfs-actions.pod:2077 msgid "This option may not be specified at the same time as the C<correct> option." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1212 +#: ../fish/guestfish-actions.pod:1224 msgid "e2fsck-f" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1214 +#: ../fish/guestfish-actions.pod:1226 #, no-wrap msgid "" " e2fsck-f device\n" @@ -10104,7 +10136,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1216 ../src/guestfs-actions.pod:2104 +#: ../fish/guestfish-actions.pod:1228 ../src/guestfs-actions.pod:2120 msgid "" "This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker " "on C<device>, noninteractively (I<-p>), even if the filesystem appears to be " @@ -10112,19 +10144,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1220 +#: ../fish/guestfish-actions.pod:1232 msgid "" "I<This function is deprecated.> In new code, use the L</e2fsck> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1227 +#: ../fish/guestfish-actions.pod:1239 msgid "echo-daemon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1229 +#: ../fish/guestfish-actions.pod:1241 #, no-wrap msgid "" " echo-daemon 'words ...'\n" @@ -10132,29 +10164,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1231 ../src/guestfs-actions.pod:2118 +#: ../fish/guestfish-actions.pod:1243 ../src/guestfs-actions.pod:2134 msgid "" "This command concatenates the list of C<words> passed with single spaces " "between them and returns the resulting string." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1234 ../src/guestfs-actions.pod:2121 +#: ../fish/guestfish-actions.pod:1246 ../src/guestfs-actions.pod:2137 msgid "You can use this command to test the connection through to the daemon." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1236 +#: ../fish/guestfish-actions.pod:1248 msgid "See also L</ping-daemon>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1238 +#: ../fish/guestfish-actions.pod:1250 msgid "egrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1240 +#: ../fish/guestfish-actions.pod:1252 #, no-wrap msgid "" " egrep regex path\n" @@ -10162,17 +10194,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1242 ../src/guestfs-actions.pod:2137 +#: ../fish/guestfish-actions.pod:1254 ../src/guestfs-actions.pod:2153 msgid "This calls the external C<egrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1248 +#: ../fish/guestfish-actions.pod:1260 msgid "egrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1250 +#: ../fish/guestfish-actions.pod:1262 #, no-wrap msgid "" " egrepi regex path\n" @@ -10180,17 +10212,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1252 ../src/guestfs-actions.pod:2156 +#: ../fish/guestfish-actions.pod:1264 ../src/guestfs-actions.pod:2172 msgid "This calls the external C<egrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1258 +#: ../fish/guestfish-actions.pod:1270 msgid "equal" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1260 +#: ../fish/guestfish-actions.pod:1272 #, no-wrap msgid "" " equal file1 file2\n" @@ -10198,24 +10230,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1262 ../src/guestfs-actions.pod:2175 +#: ../fish/guestfish-actions.pod:1274 ../src/guestfs-actions.pod:2191 msgid "" "This compares the two files C<file1> and C<file2> and returns true if their " "content is exactly equal, or false otherwise." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1265 ../src/guestfs-actions.pod:2178 +#: ../fish/guestfish-actions.pod:1277 ../src/guestfs-actions.pod:2194 msgid "The external L<cmp(1)> program is used for the comparison." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1267 +#: ../fish/guestfish-actions.pod:1279 msgid "exists" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1269 +#: ../fish/guestfish-actions.pod:1281 #, no-wrap msgid "" " exists path\n" @@ -10223,24 +10255,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1271 ../src/guestfs-actions.pod:2190 +#: ../fish/guestfish-actions.pod:1283 ../src/guestfs-actions.pod:2206 msgid "" "This returns C<true> if and only if there is a file, directory (or anything) " "with the given C<path> name." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1274 +#: ../fish/guestfish-actions.pod:1286 msgid "See also L</is-file>, L</is-dir>, L</stat>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1276 +#: ../fish/guestfish-actions.pod:1288 msgid "fallocate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1278 +#: ../fish/guestfish-actions.pod:1290 #, no-wrap msgid "" " fallocate path len\n" @@ -10248,33 +10280,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1280 ../fish/guestfish-actions.pod:1299 ../src/guestfs-actions.pod:2213 ../src/guestfs-actions.pod:2232 +#: ../fish/guestfish-actions.pod:1292 ../fish/guestfish-actions.pod:1311 ../src/guestfs-actions.pod:2229 ../src/guestfs-actions.pod:2248 msgid "" "This command preallocates a file (containing zero bytes) named C<path> of " "size C<len> bytes. If the file exists already, it is overwritten." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1284 ../src/guestfs-actions.pod:2217 +#: ../fish/guestfish-actions.pod:1296 ../src/guestfs-actions.pod:2233 msgid "" "Do not confuse this with the guestfish-specific C<alloc> command which " "allocates a file in the host and attaches it as a device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1288 +#: ../fish/guestfish-actions.pod:1300 msgid "" "I<This function is deprecated.> In new code, use the L</fallocate64> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1295 +#: ../fish/guestfish-actions.pod:1307 msgid "fallocate64" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1297 +#: ../fish/guestfish-actions.pod:1309 #, no-wrap msgid "" " fallocate64 path len\n" @@ -10282,14 +10314,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1303 +#: ../fish/guestfish-actions.pod:1315 msgid "" "Note that this call allocates disk blocks for the file. To create a sparse " "file use L</truncate-size> instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1306 +#: ../fish/guestfish-actions.pod:1318 msgid "" "The deprecated call L</fallocate> does the same, but owing to an oversight " "it only allowed 30 bit lengths to be specified, effectively limiting the " @@ -10297,19 +10329,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1311 ../src/guestfs-actions.pod:2244 +#: ../fish/guestfish-actions.pod:1323 ../src/guestfs-actions.pod:2260 msgid "" "Do not confuse this with the guestfish-specific C<alloc> and C<sparse> " "commands which create a file in the host and attach it as a device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1315 +#: ../fish/guestfish-actions.pod:1327 msgid "fgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1317 +#: ../fish/guestfish-actions.pod:1329 #, no-wrap msgid "" " fgrep pattern path\n" @@ -10317,17 +10349,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1319 ../src/guestfs-actions.pod:2259 +#: ../fish/guestfish-actions.pod:1331 ../src/guestfs-actions.pod:2275 msgid "This calls the external C<fgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1325 +#: ../fish/guestfish-actions.pod:1337 msgid "fgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1327 +#: ../fish/guestfish-actions.pod:1339 #, no-wrap msgid "" " fgrepi pattern path\n" @@ -10335,17 +10367,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1329 ../src/guestfs-actions.pod:2278 +#: ../fish/guestfish-actions.pod:1341 ../src/guestfs-actions.pod:2294 msgid "This calls the external C<fgrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1335 +#: ../fish/guestfish-actions.pod:1347 msgid "file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1337 +#: ../fish/guestfish-actions.pod:1349 #, no-wrap msgid "" " file path\n" @@ -10353,28 +10385,28 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1339 ../src/guestfs-actions.pod:2296 +#: ../fish/guestfish-actions.pod:1351 ../src/guestfs-actions.pod:2312 msgid "" "This call uses the standard L<file(1)> command to determine the type or " "contents of the file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1342 ../src/guestfs-actions.pod:2299 +#: ../fish/guestfish-actions.pod:1354 ../src/guestfs-actions.pod:2315 msgid "" "This call will also transparently look inside various types of compressed " "file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1345 ../src/guestfs-actions.pod:2302 +#: ../fish/guestfish-actions.pod:1357 ../src/guestfs-actions.pod:2318 msgid "" "The exact command which runs is C<file -zb path>. Note in particular that " "the filename is not prepended to the output (the I<-b> option)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1349 ../src/guestfs-actions.pod:2306 +#: ../fish/guestfish-actions.pod:1361 ../src/guestfs-actions.pod:2322 msgid "" "The output depends on the output of the underlying L<file(1)> command and it " "can change in future in ways beyond our control. In other words, the output " @@ -10382,19 +10414,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1353 +#: ../fish/guestfish-actions.pod:1365 msgid "" "See also: L<file(1)>, L</vfs-type>, L</lstat>, L</is-file>, L</is-blockdev> " "(etc), L</is-zero>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1356 +#: ../fish/guestfish-actions.pod:1368 msgid "file-architecture" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1358 +#: ../fish/guestfish-actions.pod:1370 #, no-wrap msgid "" " file-architecture filename\n" @@ -10402,166 +10434,166 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1360 ../src/guestfs-actions.pod:2324 +#: ../fish/guestfish-actions.pod:1372 ../src/guestfs-actions.pod:2340 msgid "" "This detects the architecture of the binary C<filename>, and returns it if " "known." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1363 ../src/guestfs-actions.pod:2327 +#: ../fish/guestfish-actions.pod:1375 ../src/guestfs-actions.pod:2343 msgid "Currently defined architectures are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1367 ../src/guestfs-actions.pod:2331 +#: ../fish/guestfish-actions.pod:1379 ../src/guestfs-actions.pod:2347 msgid "\"i386\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1369 ../src/guestfs-actions.pod:2333 +#: ../fish/guestfish-actions.pod:1381 ../src/guestfs-actions.pod:2349 msgid "" "This string is returned for all 32 bit i386, i486, i586, i686 binaries " "irrespective of the precise processor requirements of the binary." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1372 ../src/guestfs-actions.pod:2336 +#: ../fish/guestfish-actions.pod:1384 ../src/guestfs-actions.pod:2352 msgid "\"x86_64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1374 ../src/guestfs-actions.pod:2338 +#: ../fish/guestfish-actions.pod:1386 ../src/guestfs-actions.pod:2354 msgid "64 bit x86-64." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1376 ../src/guestfs-actions.pod:2340 +#: ../fish/guestfish-actions.pod:1388 ../src/guestfs-actions.pod:2356 msgid "\"sparc\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1378 ../src/guestfs-actions.pod:2342 +#: ../fish/guestfish-actions.pod:1390 ../src/guestfs-actions.pod:2358 msgid "32 bit SPARC." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1380 ../src/guestfs-actions.pod:2344 +#: ../fish/guestfish-actions.pod:1392 ../src/guestfs-actions.pod:2360 msgid "\"sparc64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1382 ../src/guestfs-actions.pod:2346 +#: ../fish/guestfish-actions.pod:1394 ../src/guestfs-actions.pod:2362 msgid "64 bit SPARC V9 and above." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1384 ../src/guestfs-actions.pod:2348 +#: ../fish/guestfish-actions.pod:1396 ../src/guestfs-actions.pod:2364 msgid "\"ia64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1386 ../src/guestfs-actions.pod:2350 +#: ../fish/guestfish-actions.pod:1398 ../src/guestfs-actions.pod:2366 msgid "Intel Itanium." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1388 ../src/guestfs-actions.pod:2352 +#: ../fish/guestfish-actions.pod:1400 ../src/guestfs-actions.pod:2368 msgid "\"ppc\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1390 ../src/guestfs-actions.pod:2354 +#: ../fish/guestfish-actions.pod:1402 ../src/guestfs-actions.pod:2370 msgid "32 bit Power PC." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1392 ../src/guestfs-actions.pod:2356 +#: ../fish/guestfish-actions.pod:1404 ../src/guestfs-actions.pod:2372 msgid "\"ppc64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1394 ../src/guestfs-actions.pod:2358 +#: ../fish/guestfish-actions.pod:1406 ../src/guestfs-actions.pod:2374 msgid "64 bit Power PC." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1398 ../src/guestfs-actions.pod:2362 +#: ../fish/guestfish-actions.pod:1410 ../src/guestfs-actions.pod:2378 msgid "Libguestfs may return other architecture strings in future." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1400 ../src/guestfs-actions.pod:2364 +#: ../fish/guestfish-actions.pod:1412 ../src/guestfs-actions.pod:2380 msgid "The function works on at least the following types of files:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1406 ../src/guestfs-actions.pod:2370 +#: ../fish/guestfish-actions.pod:1418 ../src/guestfs-actions.pod:2386 msgid "many types of Un*x and Linux binary" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1410 ../src/guestfs-actions.pod:2374 +#: ../fish/guestfish-actions.pod:1422 ../src/guestfs-actions.pod:2390 msgid "many types of Un*x and Linux shared library" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1414 ../src/guestfs-actions.pod:2378 +#: ../fish/guestfish-actions.pod:1426 ../src/guestfs-actions.pod:2394 msgid "Windows Win32 and Win64 binaries" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1418 ../src/guestfs-actions.pod:2382 +#: ../fish/guestfish-actions.pod:1430 ../src/guestfs-actions.pod:2398 msgid "Windows Win32 and Win64 DLLs" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1420 ../src/guestfs-actions.pod:2384 +#: ../fish/guestfish-actions.pod:1432 ../src/guestfs-actions.pod:2400 msgid "Win32 binaries and DLLs return C<i386>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1422 ../src/guestfs-actions.pod:2386 +#: ../fish/guestfish-actions.pod:1434 ../src/guestfs-actions.pod:2402 msgid "Win64 binaries and DLLs return C<x86_64>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1426 ../src/guestfs-actions.pod:2390 +#: ../fish/guestfish-actions.pod:1438 ../src/guestfs-actions.pod:2406 msgid "Linux kernel modules" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1430 ../src/guestfs-actions.pod:2394 +#: ../fish/guestfish-actions.pod:1442 ../src/guestfs-actions.pod:2410 msgid "Linux new-style initrd images" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1434 ../src/guestfs-actions.pod:2398 +#: ../fish/guestfish-actions.pod:1446 ../src/guestfs-actions.pod:2414 msgid "some non-x86 Linux vmlinuz kernels" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1438 ../src/guestfs-actions.pod:2402 +#: ../fish/guestfish-actions.pod:1450 ../src/guestfs-actions.pod:2418 msgid "What it can't do currently:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1444 ../src/guestfs-actions.pod:2408 +#: ../fish/guestfish-actions.pod:1456 ../src/guestfs-actions.pod:2424 msgid "static libraries (libfoo.a)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1448 ../src/guestfs-actions.pod:2412 +#: ../fish/guestfish-actions.pod:1460 ../src/guestfs-actions.pod:2428 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1452 ../src/guestfs-actions.pod:2416 +#: ../fish/guestfish-actions.pod:1464 ../src/guestfs-actions.pod:2432 msgid "x86 Linux vmlinuz kernels" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1454 ../src/guestfs-actions.pod:2418 +#: ../fish/guestfish-actions.pod:1466 ../src/guestfs-actions.pod:2434 msgid "" "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and " "compressed code, and are horribly hard to unpack. If you want to find the " @@ -10570,12 +10602,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1461 +#: ../fish/guestfish-actions.pod:1473 msgid "filesize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1463 +#: ../fish/guestfish-actions.pod:1475 #, no-wrap msgid "" " filesize file\n" @@ -10583,12 +10615,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1465 ../src/guestfs-actions.pod:2436 +#: ../fish/guestfish-actions.pod:1477 ../src/guestfs-actions.pod:2452 msgid "This command returns the size of C<file> in bytes." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1467 +#: ../fish/guestfish-actions.pod:1479 msgid "" "To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, " "L</is-file> etc. To get the size of block devices, use " @@ -10596,12 +10628,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1471 +#: ../fish/guestfish-actions.pod:1483 msgid "fill" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1473 +#: ../fish/guestfish-actions.pod:1485 #, no-wrap msgid "" " fill c len path\n" @@ -10609,7 +10641,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1475 ../src/guestfs-actions.pod:2454 +#: ../fish/guestfish-actions.pod:1487 ../src/guestfs-actions.pod:2470 msgid "" "This command creates a new file called C<path>. The initial content of the " "file is C<len> octets of C<c>, where C<c> must be a number in the range " @@ -10617,7 +10649,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1479 +#: ../fish/guestfish-actions.pod:1491 msgid "" "To fill a file with zero bytes (sparsely), it is much more efficient to use " "L</truncate-size>. To create a file with a pattern of repeating bytes use " @@ -10625,12 +10657,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1484 +#: ../fish/guestfish-actions.pod:1496 msgid "fill-pattern" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1486 +#: ../fish/guestfish-actions.pod:1498 #, no-wrap msgid "" " fill-pattern pattern len path\n" @@ -10638,7 +10670,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1488 +#: ../fish/guestfish-actions.pod:1500 msgid "" "This function is like L</fill> except that it creates a new file of length " "C<len> containing the repeating pattern of bytes in C<pattern>. The pattern " @@ -10647,12 +10679,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1493 +#: ../fish/guestfish-actions.pod:1505 msgid "find" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1495 +#: ../fish/guestfish-actions.pod:1507 #, no-wrap msgid "" " find directory\n" @@ -10660,7 +10692,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1497 ../src/guestfs-actions.pod:2500 +#: ../fish/guestfish-actions.pod:1509 ../src/guestfs-actions.pod:2516 msgid "" "This command lists out all files and directories, recursively, starting at " "C<directory>. It is essentially equivalent to running the shell command " @@ -10669,14 +10701,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1502 ../src/guestfs-actions.pod:2505 +#: ../fish/guestfish-actions.pod:1514 ../src/guestfs-actions.pod:2521 msgid "" "This returns a list of strings I<without any prefix>. Thus if the directory " "structure was:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1505 ../src/guestfs-actions.pod:2508 +#: ../fish/guestfish-actions.pod:1517 ../src/guestfs-actions.pod:2524 #, no-wrap msgid "" " /tmp/a\n" @@ -10686,12 +10718,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1509 +#: ../fish/guestfish-actions.pod:1521 msgid "then the returned list from L</find> C</tmp> would be 4 elements:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1512 ../src/guestfs-actions.pod:2515 +#: ../fish/guestfish-actions.pod:1524 ../src/guestfs-actions.pod:2531 #, no-wrap msgid "" " a\n" @@ -10702,27 +10734,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1517 ../src/guestfs-actions.pod:2520 +#: ../fish/guestfish-actions.pod:1529 ../src/guestfs-actions.pod:2536 msgid "If C<directory> is not a directory, then this command returns an error." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1520 ../src/guestfs-actions.pod:2523 +#: ../fish/guestfish-actions.pod:1532 ../src/guestfs-actions.pod:2539 msgid "The returned list is sorted." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1522 +#: ../fish/guestfish-actions.pod:1534 msgid "See also L</find0>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1527 +#: ../fish/guestfish-actions.pod:1539 msgid "find0" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1529 +#: ../fish/guestfish-actions.pod:1541 #, no-wrap msgid "" " find0 directory (files|-)\n" @@ -10730,7 +10762,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1531 ../src/guestfs-actions.pod:2543 +#: ../fish/guestfish-actions.pod:1543 ../src/guestfs-actions.pod:2559 msgid "" "This command lists out all files and directories, recursively, starting at " "C<directory>, placing the resulting list in the external file called " @@ -10738,39 +10770,39 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1535 +#: ../fish/guestfish-actions.pod:1547 msgid "This command works the same way as L</find> with the following exceptions:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1542 ../src/guestfs-actions.pod:2554 +#: ../fish/guestfish-actions.pod:1554 ../src/guestfs-actions.pod:2570 msgid "The resulting list is written to an external file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1546 ../src/guestfs-actions.pod:2558 +#: ../fish/guestfish-actions.pod:1558 ../src/guestfs-actions.pod:2574 msgid "" "Items (filenames) in the result are separated by C<\\0> characters. See " "L<find(1)> option I<-print0>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1551 ../src/guestfs-actions.pod:2563 +#: ../fish/guestfish-actions.pod:1563 ../src/guestfs-actions.pod:2579 msgid "This command is not limited in the number of names that it can return." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1556 ../src/guestfs-actions.pod:2568 +#: ../fish/guestfish-actions.pod:1568 ../src/guestfs-actions.pod:2584 msgid "The result list is not sorted." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1562 +#: ../fish/guestfish-actions.pod:1574 msgid "findfs-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1564 +#: ../fish/guestfish-actions.pod:1576 #, no-wrap msgid "" " findfs-label label\n" @@ -10778,24 +10810,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1566 ../src/guestfs-actions.pod:2582 +#: ../fish/guestfish-actions.pod:1578 ../src/guestfs-actions.pod:2598 msgid "" "This command searches the filesystems and returns the one which has the " "given label. An error is returned if no such filesystem can be found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1570 +#: ../fish/guestfish-actions.pod:1582 msgid "To find the label of a filesystem, use L</vfs-label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1572 +#: ../fish/guestfish-actions.pod:1584 msgid "findfs-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1574 +#: ../fish/guestfish-actions.pod:1586 #, no-wrap msgid "" " findfs-uuid uuid\n" @@ -10803,24 +10835,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1576 ../src/guestfs-actions.pod:2599 +#: ../fish/guestfish-actions.pod:1588 ../src/guestfs-actions.pod:2615 msgid "" "This command searches the filesystems and returns the one which has the " "given UUID. An error is returned if no such filesystem can be found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1580 +#: ../fish/guestfish-actions.pod:1592 msgid "To find the UUID of a filesystem, use L</vfs-uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1582 +#: ../fish/guestfish-actions.pod:1594 msgid "fsck" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1584 +#: ../fish/guestfish-actions.pod:1596 #, no-wrap msgid "" " fsck fstype device\n" @@ -10828,48 +10860,48 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1586 ../src/guestfs-actions.pod:2617 +#: ../fish/guestfish-actions.pod:1598 ../src/guestfs-actions.pod:2633 msgid "" "This runs the filesystem checker (fsck) on C<device> which should have " "filesystem type C<fstype>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1589 ../src/guestfs-actions.pod:2620 +#: ../fish/guestfish-actions.pod:1601 ../src/guestfs-actions.pod:2636 msgid "" "The returned integer is the status. See L<fsck(8)> for the list of status " "codes from C<fsck>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1598 ../src/guestfs-actions.pod:2629 +#: ../fish/guestfish-actions.pod:1610 ../src/guestfs-actions.pod:2645 msgid "Multiple status codes can be summed together." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1602 ../src/guestfs-actions.pod:2633 +#: ../fish/guestfish-actions.pod:1614 ../src/guestfs-actions.pod:2649 msgid "" "A non-zero return code can mean \"success\", for example if errors have been " "corrected on the filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1607 ../src/guestfs-actions.pod:2638 +#: ../fish/guestfish-actions.pod:1619 ../src/guestfs-actions.pod:2654 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1612 ../src/guestfs-actions.pod:2643 +#: ../fish/guestfish-actions.pod:1624 ../src/guestfs-actions.pod:2659 msgid "This command is entirely equivalent to running C<fsck -a -t fstype device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1614 +#: ../fish/guestfish-actions.pod:1626 msgid "get-append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1616 +#: ../fish/guestfish-actions.pod:1628 #, no-wrap msgid "" " get-append\n" @@ -10877,24 +10909,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1618 ../src/guestfs-actions.pod:2654 +#: ../fish/guestfish-actions.pod:1630 ../src/guestfs-actions.pod:2670 msgid "" "Return the additional kernel options which are added to the guest kernel " "command line." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1621 ../src/guestfs-actions.pod:2657 +#: ../fish/guestfish-actions.pod:1633 ../src/guestfs-actions.pod:2673 msgid "If C<NULL> then no options are added." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1623 +#: ../fish/guestfish-actions.pod:1635 msgid "get-attach-method" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1625 +#: ../fish/guestfish-actions.pod:1637 #, no-wrap msgid "" " get-attach-method\n" @@ -10902,17 +10934,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1627 +#: ../fish/guestfish-actions.pod:1639 msgid "Return the current attach method. See L</set-attach-method>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1629 +#: ../fish/guestfish-actions.pod:1641 msgid "get-autosync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1631 +#: ../fish/guestfish-actions.pod:1643 #, no-wrap msgid "" " get-autosync\n" @@ -10920,17 +10952,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1633 ../src/guestfs-actions.pod:2682 +#: ../fish/guestfish-actions.pod:1645 ../src/guestfs-actions.pod:2698 msgid "Get the autosync flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1635 +#: ../fish/guestfish-actions.pod:1647 msgid "get-direct" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1637 +#: ../fish/guestfish-actions.pod:1649 #, no-wrap msgid "" " get-direct\n" @@ -10938,17 +10970,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1639 ../src/guestfs-actions.pod:2693 +#: ../fish/guestfish-actions.pod:1651 ../src/guestfs-actions.pod:2709 msgid "Return the direct appliance mode flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1641 +#: ../fish/guestfish-actions.pod:1653 msgid "get-e2attrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1643 +#: ../fish/guestfish-actions.pod:1655 #, no-wrap msgid "" " get-e2attrs file\n" @@ -10956,12 +10988,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1645 ../src/guestfs-actions.pod:2705 +#: ../fish/guestfish-actions.pod:1657 ../src/guestfs-actions.pod:2721 msgid "This returns the file attributes associated with C<file>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1647 ../src/guestfs-actions.pod:2707 +#: ../fish/guestfish-actions.pod:1659 ../src/guestfs-actions.pod:2723 msgid "" "The attributes are a set of bits associated with each inode which affect the " "behaviour of the file. The attributes are returned as a string of letters " @@ -10970,7 +11002,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1653 ../fish/guestfish-actions.pod:4936 ../src/guestfs-actions.pod:2713 ../src/guestfs-actions.pod:7747 +#: ../fish/guestfish-actions.pod:1665 ../fish/guestfish-actions.pod:4968 ../src/guestfs-actions.pod:2729 ../src/guestfs-actions.pod:7786 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 " @@ -10978,153 +11010,153 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1657 ../src/guestfs-actions.pod:2717 +#: ../fish/guestfish-actions.pod:1669 ../src/guestfs-actions.pod:2733 msgid "The characters (file attributes) in the returned string are currently:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1662 ../src/guestfs-actions.pod:2722 +#: ../fish/guestfish-actions.pod:1674 ../src/guestfs-actions.pod:2738 msgid "'A'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1664 ../src/guestfs-actions.pod:2724 +#: ../fish/guestfish-actions.pod:1676 ../src/guestfs-actions.pod:2740 msgid "When the file is accessed, its atime is not modified." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1666 ../src/guestfs-actions.pod:2726 +#: ../fish/guestfish-actions.pod:1678 ../src/guestfs-actions.pod:2742 msgid "'a'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1668 ../src/guestfs-actions.pod:2728 +#: ../fish/guestfish-actions.pod:1680 ../src/guestfs-actions.pod:2744 msgid "The file is append-only." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1670 ../fish/guestfish-actions.pod:4659 ../src/guestfs-actions.pod:2730 ../src/guestfs-actions.pod:7346 +#: ../fish/guestfish-actions.pod:1682 ../fish/guestfish-actions.pod:4691 ../src/guestfs-actions.pod:2746 ../src/guestfs-actions.pod:7385 msgid "'c'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1672 ../src/guestfs-actions.pod:2732 +#: ../fish/guestfish-actions.pod:1684 ../src/guestfs-actions.pod:2748 msgid "The file is compressed on-disk." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1674 ../src/guestfs-actions.pod:2734 +#: ../fish/guestfish-actions.pod:1686 ../src/guestfs-actions.pod:2750 msgid "'D'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1676 ../src/guestfs-actions.pod:2736 +#: ../fish/guestfish-actions.pod:1688 ../src/guestfs-actions.pod:2752 msgid "" "(Directories only.) Changes to this directory are written synchronously to " "disk." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1679 ../fish/guestfish-actions.pod:4663 ../src/guestfs-actions.pod:2739 ../src/guestfs-actions.pod:7350 +#: ../fish/guestfish-actions.pod:1691 ../fish/guestfish-actions.pod:4695 ../src/guestfs-actions.pod:2755 ../src/guestfs-actions.pod:7389 msgid "'d'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1681 ../src/guestfs-actions.pod:2741 +#: ../fish/guestfish-actions.pod:1693 ../src/guestfs-actions.pod:2757 msgid "The file is not a candidate for backup (see L<dump(8)>)." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1683 ../src/guestfs-actions.pod:2743 +#: ../fish/guestfish-actions.pod:1695 ../src/guestfs-actions.pod:2759 msgid "'E'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1685 ../src/guestfs-actions.pod:2745 +#: ../fish/guestfish-actions.pod:1697 ../src/guestfs-actions.pod:2761 msgid "The file has compression errors." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1687 ../src/guestfs-actions.pod:2747 +#: ../fish/guestfish-actions.pod:1699 ../src/guestfs-actions.pod:2763 msgid "'e'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1689 ../src/guestfs-actions.pod:2749 +#: ../fish/guestfish-actions.pod:1701 ../src/guestfs-actions.pod:2765 msgid "The file is using extents." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1691 ../src/guestfs-actions.pod:2751 +#: ../fish/guestfish-actions.pod:1703 ../src/guestfs-actions.pod:2767 msgid "'h'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1693 ../src/guestfs-actions.pod:2753 +#: ../fish/guestfish-actions.pod:1705 ../src/guestfs-actions.pod:2769 msgid "" "The file is storing its blocks in units of the filesystem blocksize instead " "of sectors." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1696 ../src/guestfs-actions.pod:2756 +#: ../fish/guestfish-actions.pod:1708 ../src/guestfs-actions.pod:2772 msgid "'I'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1698 ../src/guestfs-actions.pod:2758 +#: ../fish/guestfish-actions.pod:1710 ../src/guestfs-actions.pod:2774 msgid "(Directories only.) The directory is using hashed trees." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1700 ../src/guestfs-actions.pod:2760 +#: ../fish/guestfish-actions.pod:1712 ../src/guestfs-actions.pod:2776 msgid "'i'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1702 ../src/guestfs-actions.pod:2762 +#: ../fish/guestfish-actions.pod:1714 ../src/guestfs-actions.pod:2778 msgid "" "The file is immutable. It cannot be modified, deleted or renamed. No link " "can be created to this file." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1705 ../src/guestfs-actions.pod:2765 +#: ../fish/guestfish-actions.pod:1717 ../src/guestfs-actions.pod:2781 msgid "'j'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1707 ../src/guestfs-actions.pod:2767 +#: ../fish/guestfish-actions.pod:1719 ../src/guestfs-actions.pod:2783 msgid "The file is data-journaled." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1709 ../fish/guestfish-actions.pod:4679 ../src/guestfs-actions.pod:2769 ../src/guestfs-actions.pod:7366 +#: ../fish/guestfish-actions.pod:1721 ../fish/guestfish-actions.pod:4711 ../src/guestfs-actions.pod:2785 ../src/guestfs-actions.pod:7405 msgid "'s'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1711 ../src/guestfs-actions.pod:2771 +#: ../fish/guestfish-actions.pod:1723 ../src/guestfs-actions.pod:2787 msgid "When the file is deleted, all its blocks will be zeroed." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1713 ../src/guestfs-actions.pod:2773 +#: ../fish/guestfish-actions.pod:1725 ../src/guestfs-actions.pod:2789 msgid "'S'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1715 ../src/guestfs-actions.pod:2775 +#: ../fish/guestfish-actions.pod:1727 ../src/guestfs-actions.pod:2791 msgid "Changes to this file are written synchronously to disk." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1717 ../src/guestfs-actions.pod:2777 +#: ../fish/guestfish-actions.pod:1729 ../src/guestfs-actions.pod:2793 msgid "'T'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1719 ../src/guestfs-actions.pod:2779 +#: ../fish/guestfish-actions.pod:1731 ../src/guestfs-actions.pod:2795 msgid "" "(Directories only.) This is a hint to the block allocator that " "subdirectories contained in this directory should be spread across blocks. " @@ -11133,51 +11165,51 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1724 ../src/guestfs-actions.pod:2784 +#: ../fish/guestfish-actions.pod:1736 ../src/guestfs-actions.pod:2800 msgid "'t'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1726 ../src/guestfs-actions.pod:2786 +#: ../fish/guestfish-actions.pod:1738 ../src/guestfs-actions.pod:2802 msgid "" "For a file, this disables tail-merging. (Not used by upstream " "implementations of ext2.)" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1729 ../fish/guestfish-actions.pod:4683 ../src/guestfs-actions.pod:2789 ../src/guestfs-actions.pod:7370 +#: ../fish/guestfish-actions.pod:1741 ../fish/guestfish-actions.pod:4715 ../src/guestfs-actions.pod:2805 ../src/guestfs-actions.pod:7409 msgid "'u'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1731 ../src/guestfs-actions.pod:2791 +#: ../fish/guestfish-actions.pod:1743 ../src/guestfs-actions.pod:2807 msgid "" "When the file is deleted, its blocks will be saved, allowing the file to be " "undeleted." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1734 ../src/guestfs-actions.pod:2794 +#: ../fish/guestfish-actions.pod:1746 ../src/guestfs-actions.pod:2810 msgid "'X'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1736 ../src/guestfs-actions.pod:2796 +#: ../fish/guestfish-actions.pod:1748 ../src/guestfs-actions.pod:2812 msgid "The raw contents of the compressed file may be accessed." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1738 ../src/guestfs-actions.pod:2798 +#: ../fish/guestfish-actions.pod:1750 ../src/guestfs-actions.pod:2814 msgid "'Z'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1740 ../src/guestfs-actions.pod:2800 +#: ../fish/guestfish-actions.pod:1752 ../src/guestfs-actions.pod:2816 msgid "The compressed file is dirty." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1744 ../src/guestfs-actions.pod:2804 +#: ../fish/guestfish-actions.pod:1756 ../src/guestfs-actions.pod:2820 msgid "" "More file attributes may be added to this list later. Not all file " "attributes may be set for all kinds of files. For detailed information, " @@ -11185,22 +11217,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1748 +#: ../fish/guestfish-actions.pod:1760 msgid "See also L</set-e2attrs>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1750 +#: ../fish/guestfish-actions.pod:1762 msgid "Don't confuse these attributes with extended attributes (see L</getxattr>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1753 +#: ../fish/guestfish-actions.pod:1765 msgid "get-e2generation" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1755 +#: ../fish/guestfish-actions.pod:1767 #, no-wrap msgid "" " get-e2generation file\n" @@ -11208,7 +11240,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1757 ../src/guestfs-actions.pod:2824 +#: ../fish/guestfish-actions.pod:1769 ../src/guestfs-actions.pod:2840 msgid "" "This returns the ext2 file generation of a file. The generation (which used " "to be called the \"version\") is a number associated with an inode. This is " @@ -11216,7 +11248,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1761 ../src/guestfs-actions.pod:2828 +#: ../fish/guestfish-actions.pod:1773 ../src/guestfs-actions.pod:2844 msgid "" "The generation is only present when the file is located on an ext2/3/4 " "filesystem. Using this call on other filesystem types will result in an " @@ -11224,17 +11256,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1765 +#: ../fish/guestfish-actions.pod:1777 msgid "See L</set-e2generation>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1767 +#: ../fish/guestfish-actions.pod:1779 msgid "get-e2label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1769 +#: ../fish/guestfish-actions.pod:1781 #, no-wrap msgid "" " get-e2label device\n" @@ -11242,24 +11274,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1771 ../src/guestfs-actions.pod:2851 +#: ../fish/guestfish-actions.pod:1783 ../src/guestfs-actions.pod:2867 msgid "This returns the ext2/3/4 filesystem label of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1774 +#: ../fish/guestfish-actions.pod:1786 msgid "" "I<This function is deprecated.> In new code, use the L</vfs_label> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1781 +#: ../fish/guestfish-actions.pod:1793 msgid "get-e2uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1783 +#: ../fish/guestfish-actions.pod:1795 #, no-wrap msgid "" " get-e2uuid device\n" @@ -11267,24 +11299,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1785 ../src/guestfs-actions.pod:2872 +#: ../fish/guestfish-actions.pod:1797 ../src/guestfs-actions.pod:2888 msgid "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1788 +#: ../fish/guestfish-actions.pod:1800 msgid "" "I<This function is deprecated.> In new code, use the L</vfs_uuid> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1795 +#: ../fish/guestfish-actions.pod:1807 msgid "get-memsize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1797 +#: ../fish/guestfish-actions.pod:1809 #, no-wrap msgid "" " get-memsize\n" @@ -11292,12 +11324,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1799 ../src/guestfs-actions.pod:2885 +#: ../fish/guestfish-actions.pod:1811 ../src/guestfs-actions.pod:2901 msgid "This gets the memory size in megabytes allocated to the qemu subprocess." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1802 +#: ../fish/guestfish-actions.pod:1814 msgid "" "If L</set-memsize> was not called on this handle, and if " "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default " @@ -11305,17 +11337,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1806 ../fish/guestfish-actions.pod:1863 ../fish/guestfish-actions.pod:5009 ../fish/guestfish-actions.pod:5113 ../src/guestfs-actions.pod:2892 ../src/guestfs-actions.pod:2984 ../src/guestfs-actions.pod:7874 ../src/guestfs-actions.pod:8002 +#: ../fish/guestfish-actions.pod:1818 ../fish/guestfish-actions.pod:1875 ../fish/guestfish-actions.pod:5041 ../fish/guestfish-actions.pod:5145 ../src/guestfs-actions.pod:2908 ../src/guestfs-actions.pod:3000 ../src/guestfs-actions.pod:7913 ../src/guestfs-actions.pod:8041 msgid "For more information on the architecture of libguestfs, see L<guestfs(3)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1809 +#: ../fish/guestfish-actions.pod:1821 msgid "get-network" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1811 +#: ../fish/guestfish-actions.pod:1823 #, no-wrap msgid "" " get-network\n" @@ -11323,17 +11355,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1813 ../src/guestfs-actions.pod:2904 +#: ../fish/guestfish-actions.pod:1825 ../src/guestfs-actions.pod:2920 msgid "This returns the enable network flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1815 +#: ../fish/guestfish-actions.pod:1827 msgid "get-path" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1817 +#: ../fish/guestfish-actions.pod:1829 #, no-wrap msgid "" " get-path\n" @@ -11341,24 +11373,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1819 ../src/guestfs-actions.pod:2915 +#: ../fish/guestfish-actions.pod:1831 ../src/guestfs-actions.pod:2931 msgid "Return the current search path." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1821 ../src/guestfs-actions.pod:2917 +#: ../fish/guestfish-actions.pod:1833 ../src/guestfs-actions.pod:2933 msgid "" "This is always non-NULL. If it wasn't set already, then this will return " "the default path." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1824 +#: ../fish/guestfish-actions.pod:1836 msgid "get-pgroup" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1826 +#: ../fish/guestfish-actions.pod:1838 #, no-wrap msgid "" " get-pgroup\n" @@ -11366,22 +11398,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1828 ../src/guestfs-actions.pod:2930 +#: ../fish/guestfish-actions.pod:1840 ../src/guestfs-actions.pod:2946 msgid "This returns the process group flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1830 +#: ../fish/guestfish-actions.pod:1842 msgid "get-pid" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1832 +#: ../fish/guestfish-actions.pod:1844 msgid "pid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1834 +#: ../fish/guestfish-actions.pod:1846 #, no-wrap msgid "" " get-pid\n" @@ -11389,24 +11421,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1836 ../src/guestfs-actions.pod:2941 +#: ../fish/guestfish-actions.pod:1848 ../src/guestfs-actions.pod:2957 msgid "" "Return the process ID of the qemu subprocess. If there is no qemu " "subprocess, then this will return an error." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1839 ../src/guestfs-actions.pod:2944 +#: ../fish/guestfish-actions.pod:1851 ../src/guestfs-actions.pod:2960 msgid "This is an internal call used for debugging and testing." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1841 +#: ../fish/guestfish-actions.pod:1853 msgid "get-qemu" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1843 +#: ../fish/guestfish-actions.pod:1855 #, no-wrap msgid "" " get-qemu\n" @@ -11414,24 +11446,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1845 ../src/guestfs-actions.pod:2955 +#: ../fish/guestfish-actions.pod:1857 ../src/guestfs-actions.pod:2971 msgid "Return the current qemu binary." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1847 ../src/guestfs-actions.pod:2957 +#: ../fish/guestfish-actions.pod:1859 ../src/guestfs-actions.pod:2973 msgid "" "This is always non-NULL. If it wasn't set already, then this will return " "the default qemu binary name." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1850 +#: ../fish/guestfish-actions.pod:1862 msgid "get-recovery-proc" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1852 +#: ../fish/guestfish-actions.pod:1864 #, no-wrap msgid "" " get-recovery-proc\n" @@ -11439,17 +11471,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1854 ../src/guestfs-actions.pod:2970 +#: ../fish/guestfish-actions.pod:1866 ../src/guestfs-actions.pod:2986 msgid "Return the recovery process enabled flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1856 +#: ../fish/guestfish-actions.pod:1868 msgid "get-selinux" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1858 +#: ../fish/guestfish-actions.pod:1870 #, no-wrap msgid "" " get-selinux\n" @@ -11457,19 +11489,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1860 +#: ../fish/guestfish-actions.pod:1872 msgid "" "This returns the current setting of the selinux flag which is passed to the " "appliance at boot time. See L</set-selinux>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1866 +#: ../fish/guestfish-actions.pod:1878 msgid "get-smp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1868 +#: ../fish/guestfish-actions.pod:1880 #, no-wrap msgid "" " get-smp\n" @@ -11477,17 +11509,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1870 ../src/guestfs-actions.pod:2996 +#: ../fish/guestfish-actions.pod:1882 ../src/guestfs-actions.pod:3012 msgid "This returns the number of virtual CPUs assigned to the appliance." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1872 +#: ../fish/guestfish-actions.pod:1884 msgid "get-state" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1874 +#: ../fish/guestfish-actions.pod:1886 #, no-wrap msgid "" " get-state\n" @@ -11495,24 +11527,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1876 ../src/guestfs-actions.pod:3007 +#: ../fish/guestfish-actions.pod:1888 ../src/guestfs-actions.pod:3023 msgid "" "This returns the current state as an opaque integer. This is only useful " "for printing debug and internal error messages." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1879 ../fish/guestfish-actions.pod:2869 ../fish/guestfish-actions.pod:2907 ../fish/guestfish-actions.pod:2923 ../src/guestfs-actions.pod:3010 ../src/guestfs-actions.pod:4366 ../src/guestfs-actions.pod:4427 ../src/guestfs-actions.pod:4454 +#: ../fish/guestfish-actions.pod:1891 ../fish/guestfish-actions.pod:2881 ../fish/guestfish-actions.pod:2919 ../fish/guestfish-actions.pod:2935 ../src/guestfs-actions.pod:3026 ../src/guestfs-actions.pod:4382 ../src/guestfs-actions.pod:4443 ../src/guestfs-actions.pod:4470 msgid "For more information on states, see L<guestfs(3)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1881 +#: ../fish/guestfish-actions.pod:1893 msgid "get-trace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1883 +#: ../fish/guestfish-actions.pod:1895 #, no-wrap msgid "" " get-trace\n" @@ -11520,17 +11552,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1885 ../src/guestfs-actions.pod:3021 +#: ../fish/guestfish-actions.pod:1897 ../src/guestfs-actions.pod:3037 msgid "Return the command trace flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1887 +#: ../fish/guestfish-actions.pod:1899 msgid "get-umask" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1889 +#: ../fish/guestfish-actions.pod:1901 #, no-wrap msgid "" " get-umask\n" @@ -11538,19 +11570,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1891 +#: ../fish/guestfish-actions.pod:1903 msgid "" "Return the current umask. By default the umask is C<022> unless it has been " "set by calling L</umask>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1894 +#: ../fish/guestfish-actions.pod:1906 msgid "get-verbose" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1896 +#: ../fish/guestfish-actions.pod:1908 #, no-wrap msgid "" " get-verbose\n" @@ -11558,17 +11590,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1898 ../src/guestfs-actions.pod:3044 +#: ../fish/guestfish-actions.pod:1910 ../src/guestfs-actions.pod:3060 msgid "This returns the verbose messages flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1900 +#: ../fish/guestfish-actions.pod:1912 msgid "getcon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1902 +#: ../fish/guestfish-actions.pod:1914 #, no-wrap msgid "" " getcon\n" @@ -11576,22 +11608,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1904 ../src/guestfs-actions.pod:3055 +#: ../fish/guestfish-actions.pod:1916 ../src/guestfs-actions.pod:3071 msgid "This gets the SELinux security context of the daemon." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1906 +#: ../fish/guestfish-actions.pod:1918 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1909 +#: ../fish/guestfish-actions.pod:1921 msgid "getxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1911 +#: ../fish/guestfish-actions.pod:1923 #, no-wrap msgid "" " getxattr path name\n" @@ -11599,7 +11631,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1913 +#: ../fish/guestfish-actions.pod:1925 msgid "" "Get a single extended attribute from file C<path> named C<name>. This call " "follows symlinks. If you want to lookup an extended attribute for the " @@ -11607,7 +11639,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1917 ../fish/guestfish-actions.pod:3021 +#: ../fish/guestfish-actions.pod:1929 ../fish/guestfish-actions.pod:3042 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 " @@ -11617,24 +11649,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1924 ../fish/guestfish-actions.pod:3028 ../src/guestfs-actions.pod:3084 ../src/guestfs-actions.pod:4628 +#: ../fish/guestfish-actions.pod:1936 ../fish/guestfish-actions.pod:3049 ../src/guestfs-actions.pod:3100 ../src/guestfs-actions.pod:4653 msgid "" "Extended attribute values are blobs of binary data. If there is no extended " "attribute named C<name>, this returns an error." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1927 +#: ../fish/guestfish-actions.pod:1939 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1929 +#: ../fish/guestfish-actions.pod:1941 msgid "getxattrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1931 +#: ../fish/guestfish-actions.pod:1943 #, no-wrap msgid "" " getxattrs path\n" @@ -11642,29 +11674,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1933 ../src/guestfs-actions.pod:3101 +#: ../fish/guestfish-actions.pod:1945 ../src/guestfs-actions.pod:3117 msgid "This call lists the extended attributes of the file or directory C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1936 ../src/guestfs-actions.pod:3104 +#: ../fish/guestfish-actions.pod:1948 ../src/guestfs-actions.pod:3120 msgid "" "At the system call level, this is a combination of the L<listxattr(2)> and " "L<getxattr(2)> calls." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1939 +#: ../fish/guestfish-actions.pod:1951 msgid "See also: L</lgetxattrs>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1941 +#: ../fish/guestfish-actions.pod:1953 msgid "glob-expand" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1943 +#: ../fish/guestfish-actions.pod:1955 #, no-wrap msgid "" " glob-expand pattern\n" @@ -11672,26 +11704,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1945 ../src/guestfs-actions.pod:3121 +#: ../fish/guestfish-actions.pod:1957 ../src/guestfs-actions.pod:3137 msgid "" "This command searches for all the pathnames matching C<pattern> according to " "the wildcard expansion rules used by the shell." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1949 ../src/guestfs-actions.pod:3125 +#: ../fish/guestfish-actions.pod:1961 ../src/guestfs-actions.pod:3141 msgid "If no paths match, then this returns an empty list (note: not an error)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1952 ../src/guestfs-actions.pod:3128 +#: ../fish/guestfish-actions.pod:1964 ../src/guestfs-actions.pod:3144 msgid "" "It is just a wrapper around the C L<glob(3)> function with flags " "C<GLOB_MARK|GLOB_BRACE>. See that manual page for more details." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1956 +#: ../fish/guestfish-actions.pod:1968 msgid "" "Notice that there is no equivalent command for expanding a device name " "(eg. C</dev/sd*>). Use L</list-devices>, L</list-partitions> etc functions " @@ -11699,12 +11731,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1960 +#: ../fish/guestfish-actions.pod:1972 msgid "grep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1962 +#: ../fish/guestfish-actions.pod:1974 #, no-wrap msgid "" " grep regex path\n" @@ -11712,17 +11744,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1964 ../src/guestfs-actions.pod:3149 +#: ../fish/guestfish-actions.pod:1976 ../src/guestfs-actions.pod:3165 msgid "This calls the external C<grep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1970 +#: ../fish/guestfish-actions.pod:1982 msgid "grepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1972 +#: ../fish/guestfish-actions.pod:1984 #, no-wrap msgid "" " grepi regex path\n" @@ -11730,17 +11762,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1974 ../src/guestfs-actions.pod:3168 +#: ../fish/guestfish-actions.pod:1986 ../src/guestfs-actions.pod:3184 msgid "This calls the external C<grep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1980 +#: ../fish/guestfish-actions.pod:1992 msgid "grub-install" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1982 +#: ../fish/guestfish-actions.pod:1994 #, no-wrap msgid "" " grub-install root device\n" @@ -11748,14 +11780,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1984 ../src/guestfs-actions.pod:3187 +#: ../fish/guestfish-actions.pod:1996 ../src/guestfs-actions.pod:3203 msgid "" "This command installs GRUB 1 (the Grand Unified Bootloader) on C<device>, " "with the root directory being C<root>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1993 ../src/guestfs-actions.pod:3196 +#: ../fish/guestfish-actions.pod:2005 ../src/guestfs-actions.pod:3212 msgid "" "There is currently no way in the API to install grub2, which is used by most " "modern Linux guests. It is possible to run the grub2 command from the " @@ -11763,7 +11795,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2000 ../src/guestfs-actions.pod:3203 +#: ../fish/guestfish-actions.pod:2012 ../src/guestfs-actions.pod:3219 msgid "" "This uses C<grub-install> from the host. Unfortunately grub is not always " "compatible with itself, so this only works in rather narrow circumstances. " @@ -11771,7 +11803,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2007 ../src/guestfs-actions.pod:3210 +#: ../fish/guestfish-actions.pod:2019 ../src/guestfs-actions.pod:3226 msgid "" "If grub-install reports the error \"No suitable drive was found in the " "generated device map.\" it may be that you need to create a " @@ -11781,7 +11813,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2014 ../src/guestfs-actions.pod:3217 +#: ../fish/guestfish-actions.pod:2026 ../src/guestfs-actions.pod:3233 #, no-wrap msgid "" " (hd0) /dev/vda\n" @@ -11789,17 +11821,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2016 ../src/guestfs-actions.pod:3219 +#: ../fish/guestfish-actions.pod:2028 ../src/guestfs-actions.pod:3235 msgid "replacing C</dev/vda> with the name of the installation device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2020 +#: ../fish/guestfish-actions.pod:2032 msgid "head" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2022 +#: ../fish/guestfish-actions.pod:2034 #, no-wrap msgid "" " head path\n" @@ -11807,19 +11839,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2024 ../src/guestfs-actions.pod:3233 +#: ../fish/guestfish-actions.pod:2036 ../src/guestfs-actions.pod:3249 msgid "" "This command returns up to the first 10 lines of a file as a list of " "strings." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2030 +#: ../fish/guestfish-actions.pod:2042 msgid "head-n" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2032 +#: ../fish/guestfish-actions.pod:2044 #, no-wrap msgid "" " head-n nrlines path\n" @@ -11827,31 +11859,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2034 ../src/guestfs-actions.pod:3252 +#: ../fish/guestfish-actions.pod:2046 ../src/guestfs-actions.pod:3268 msgid "" "If the parameter C<nrlines> is a positive number, this returns the first " "C<nrlines> lines of the file C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2037 ../src/guestfs-actions.pod:3255 +#: ../fish/guestfish-actions.pod:2049 ../src/guestfs-actions.pod:3271 msgid "" "If the parameter C<nrlines> is a negative number, this returns lines from " "the file C<path>, excluding the last C<nrlines> lines." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2040 ../fish/guestfish-actions.pod:5494 ../src/guestfs-actions.pod:3258 ../src/guestfs-actions.pod:8581 +#: ../fish/guestfish-actions.pod:2052 ../fish/guestfish-actions.pod:5546 ../src/guestfs-actions.pod:3274 ../src/guestfs-actions.pod:8643 msgid "If the parameter C<nrlines> is zero, this returns an empty list." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2045 +#: ../fish/guestfish-actions.pod:2057 msgid "hexdump" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2047 +#: ../fish/guestfish-actions.pod:2059 #, no-wrap msgid "" " hexdump path\n" @@ -11859,19 +11891,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2049 ../src/guestfs-actions.pod:3275 +#: ../fish/guestfish-actions.pod:2061 ../src/guestfs-actions.pod:3291 msgid "" "This runs C<hexdump -C> on the given C<path>. The result is the " "human-readable, canonical hex dump of the file." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2055 +#: ../fish/guestfish-actions.pod:2067 msgid "initrd-cat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2057 +#: ../fish/guestfish-actions.pod:2069 #, no-wrap msgid "" " initrd-cat initrdpath filename\n" @@ -11879,7 +11911,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2059 ../src/guestfs-actions.pod:3294 +#: ../fish/guestfish-actions.pod:2071 ../src/guestfs-actions.pod:3310 msgid "" "This command unpacks the file C<filename> from the initrd file called " "C<initrdpath>. The filename must be given I<without> the initial C</> " @@ -11887,7 +11919,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2063 ../src/guestfs-actions.pod:3298 +#: ../fish/guestfish-actions.pod:2075 ../src/guestfs-actions.pod:3314 msgid "" "For example, in guestfish you could use the following command to examine the " "boot script (usually called C</init>) contained in a Linux initrd or " @@ -11895,7 +11927,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2067 ../src/guestfs-actions.pod:3302 +#: ../fish/guestfish-actions.pod:2079 ../src/guestfs-actions.pod:3318 #, no-wrap msgid "" " initrd-cat /boot/initrd-<version>.img init\n" @@ -11903,17 +11935,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2069 +#: ../fish/guestfish-actions.pod:2081 msgid "See also L</initrd-list>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2074 +#: ../fish/guestfish-actions.pod:2086 msgid "initrd-list" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2076 +#: ../fish/guestfish-actions.pod:2088 #, no-wrap msgid "" " initrd-list path\n" @@ -11921,12 +11953,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2078 ../src/guestfs-actions.pod:3321 +#: ../fish/guestfish-actions.pod:2090 ../src/guestfs-actions.pod:3337 msgid "This command lists out files contained in an initrd." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2080 ../src/guestfs-actions.pod:3323 +#: ../fish/guestfish-actions.pod:2092 ../src/guestfs-actions.pod:3339 msgid "" "The files are listed without any initial C</> character. The files are " "listed in the order they appear (not necessarily alphabetical). Directory " @@ -11934,7 +11966,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2084 ../src/guestfs-actions.pod:3327 +#: ../fish/guestfish-actions.pod:2096 ../src/guestfs-actions.pod:3343 msgid "" "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as " "initrd. We I<only> support the newer initramfs format (compressed cpio " @@ -11942,12 +11974,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2088 +#: ../fish/guestfish-actions.pod:2100 msgid "inotify-add-watch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2090 +#: ../fish/guestfish-actions.pod:2102 #, no-wrap msgid "" " inotify-add-watch path mask\n" @@ -11955,31 +11987,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2092 ../src/guestfs-actions.pod:3344 +#: ../fish/guestfish-actions.pod:2104 ../src/guestfs-actions.pod:3360 msgid "Watch C<path> for the events listed in C<mask>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2094 ../src/guestfs-actions.pod:3346 +#: ../fish/guestfish-actions.pod:2106 ../src/guestfs-actions.pod:3362 msgid "" "Note that if C<path> is a directory then events within that directory are " "watched, but this does I<not> happen recursively (in subdirectories)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2098 ../src/guestfs-actions.pod:3350 +#: ../fish/guestfish-actions.pod:2110 ../src/guestfs-actions.pod:3366 msgid "" "Note for non-C or non-Linux callers: the inotify events are defined by the " "Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2102 +#: ../fish/guestfish-actions.pod:2114 msgid "inotify-close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2104 +#: ../fish/guestfish-actions.pod:2116 #, no-wrap msgid "" " inotify-close\n" @@ -11987,7 +12019,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2106 ../src/guestfs-actions.pod:3363 +#: ../fish/guestfish-actions.pod:2118 ../src/guestfs-actions.pod:3379 msgid "" "This closes the inotify handle which was previously opened by inotify_init. " "It removes all watches, throws away any pending events, and deallocates all " @@ -11995,12 +12027,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2110 +#: ../fish/guestfish-actions.pod:2122 msgid "inotify-files" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2112 +#: ../fish/guestfish-actions.pod:2124 #, no-wrap msgid "" " inotify-files\n" @@ -12008,7 +12040,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2114 +#: ../fish/guestfish-actions.pod:2126 msgid "" "This function is a helpful wrapper around L</inotify-read> which just " "returns a list of pathnames of objects that were touched. The returned " @@ -12016,12 +12048,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2118 +#: ../fish/guestfish-actions.pod:2130 msgid "inotify-init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2120 +#: ../fish/guestfish-actions.pod:2132 #, no-wrap msgid "" " inotify-init maxevents\n" @@ -12029,14 +12061,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2122 ../src/guestfs-actions.pod:3392 +#: ../fish/guestfish-actions.pod:2134 ../src/guestfs-actions.pod:3408 msgid "" "This command creates a new inotify handle. The inotify subsystem can be " "used to notify events which happen to objects in the guest filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2126 +#: ../fish/guestfish-actions.pod:2138 msgid "" "C<maxevents> is the maximum number of events which will be queued up between " "calls to L</inotify-read> or L</inotify-files>. If this is passed as C<0>, " @@ -12047,14 +12079,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2136 +#: ../fish/guestfish-actions.pod:2148 msgid "" "Before any events are generated, you have to add some watches to the " "internal watch list. See: L</inotify-add-watch> and L</inotify-rm-watch>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2140 +#: ../fish/guestfish-actions.pod:2152 msgid "" "Queued up events should be read periodically by calling L</inotify-read> (or " "L</inotify-files> which is just a helpful wrapper around L</inotify-read>). " @@ -12063,14 +12095,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2147 +#: ../fish/guestfish-actions.pod:2159 msgid "" "The handle should be closed after use by calling L</inotify-close>. This " "also removes any watches automatically." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2151 ../src/guestfs-actions.pod:3421 +#: ../fish/guestfish-actions.pod:2163 ../src/guestfs-actions.pod:3437 msgid "" "See also L<inotify(7)> for an overview of the inotify interface as exposed " "by the Linux kernel, which is roughly what we expose via libguestfs. Note " @@ -12078,12 +12110,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2156 +#: ../fish/guestfish-actions.pod:2168 msgid "inotify-read" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2158 +#: ../fish/guestfish-actions.pod:2170 #, no-wrap msgid "" " inotify-read\n" @@ -12091,19 +12123,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2160 ../src/guestfs-actions.pod:3435 +#: ../fish/guestfish-actions.pod:2172 ../src/guestfs-actions.pod:3451 msgid "" "Return the complete queue of events that have happened since the previous " "read call." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2163 ../src/guestfs-actions.pod:3438 +#: ../fish/guestfish-actions.pod:2175 ../src/guestfs-actions.pod:3454 msgid "If no events have happened, this returns an empty list." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2165 ../src/guestfs-actions.pod:3440 +#: ../fish/guestfish-actions.pod:2177 ../src/guestfs-actions.pod:3456 msgid "" "I<Note>: In order to make sure that all events have been read, you must call " "this function repeatedly until it returns an empty list. The reason is that " @@ -12112,12 +12144,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2171 +#: ../fish/guestfish-actions.pod:2183 msgid "inotify-rm-watch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2173 +#: ../fish/guestfish-actions.pod:2185 #, no-wrap msgid "" " inotify-rm-watch wd\n" @@ -12125,17 +12157,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2175 +#: ../fish/guestfish-actions.pod:2187 msgid "Remove a previously defined inotify watch. See L</inotify-add-watch>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2178 +#: ../fish/guestfish-actions.pod:2190 msgid "inspect-get-arch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2180 +#: ../fish/guestfish-actions.pod:2192 #, no-wrap msgid "" " inspect-get-arch root\n" @@ -12143,31 +12175,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2182 +#: ../fish/guestfish-actions.pod:2194 msgid "" "This returns the architecture of the inspected operating system. The " "possible return values are listed under L</file-architecture>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2186 ../src/guestfs-actions.pod:3475 +#: ../fish/guestfish-actions.pod:2198 ../src/guestfs-actions.pod:3491 msgid "" "If the architecture could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2189 ../fish/guestfish-actions.pod:2296 ../fish/guestfish-actions.pod:2375 ../fish/guestfish-actions.pod:2387 ../fish/guestfish-actions.pod:2471 ../fish/guestfish-actions.pod:2533 ../fish/guestfish-actions.pod:2554 ../fish/guestfish-actions.pod:2568 ../fish/guestfish-actions.pod:2608 ../fish/guestfish-actions.pod:2652 ../fish/guestfish-actions.pod:2665 ../fish/guestfish-actions.pod:2678 ../fish/guestfish-actions.pod:2688 ../fish/guestfish-actions.pod:2698 ../fish/guestfish-actions.pod:2710 ../fish/guestfish-actions.pod:2806 ../fish/guestfish-actions.pod:2840 ../src/guestfs-actions.pod:3478 ../src/guestfs-actions.pod:3592 ../src/guestfs-actions.pod:3696 ../src/guestfs-actions.pod:3715 ../src/guestfs-actions.pod:3846 ../src/guestfs-actions.pod:3930 ../src/guestfs-actions.pod:3958 ../src/guestfs-actions.pod:3979 ../src/guestfs-actions.pod:4032 ../src/guestfs-actions.pod:4084 ../src/guestfs-actions.pod:4104 ../src/guestfs-actions.pod:4124 ../src/guestfs-actions.pod:4141 ../src/guestfs-actions.pod:4157 ../src/guestfs-actions.pod:4175 ../src/guestfs-actions.pod:4277 ../src/guestfs-actions.pod:4318 +#: ../fish/guestfish-actions.pod:2201 ../fish/guestfish-actions.pod:2308 ../fish/guestfish-actions.pod:2387 ../fish/guestfish-actions.pod:2399 ../fish/guestfish-actions.pod:2483 ../fish/guestfish-actions.pod:2545 ../fish/guestfish-actions.pod:2566 ../fish/guestfish-actions.pod:2580 ../fish/guestfish-actions.pod:2620 ../fish/guestfish-actions.pod:2664 ../fish/guestfish-actions.pod:2677 ../fish/guestfish-actions.pod:2690 ../fish/guestfish-actions.pod:2700 ../fish/guestfish-actions.pod:2710 ../fish/guestfish-actions.pod:2722 ../fish/guestfish-actions.pod:2818 ../fish/guestfish-actions.pod:2852 ../src/guestfs-actions.pod:3494 ../src/guestfs-actions.pod:3608 ../src/guestfs-actions.pod:3712 ../src/guestfs-actions.pod:3731 ../src/guestfs-actions.pod:3862 ../src/guestfs-actions.pod:3946 ../src/guestfs-actions.pod:3974 ../src/guestfs-actions.pod:3995 ../src/guestfs-actions.pod:4048 ../src/guestfs-actions.pod:4100 ../src/guestfs-actions.pod:4120 ../src/guestfs-actions.pod:4140 ../src/guestfs-actions.pod:4157 ../src/guestfs-actions.pod:4173 ../src/guestfs-actions.pod:4191 ../src/guestfs-actions.pod:4293 ../src/guestfs-actions.pod:4334 msgid "Please read L<guestfs(3)/INSPECTION> for more details." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2191 +#: ../fish/guestfish-actions.pod:2203 msgid "inspect-get-distro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2193 +#: ../fish/guestfish-actions.pod:2205 #, no-wrap msgid "" " inspect-get-distro root\n" @@ -12175,251 +12207,251 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2195 ../src/guestfs-actions.pod:3491 +#: ../fish/guestfish-actions.pod:2207 ../src/guestfs-actions.pod:3507 msgid "This returns the distro (distribution) of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2198 ../src/guestfs-actions.pod:3494 +#: ../fish/guestfish-actions.pod:2210 ../src/guestfs-actions.pod:3510 msgid "Currently defined distros are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2202 ../src/guestfs-actions.pod:3498 +#: ../fish/guestfish-actions.pod:2214 ../src/guestfs-actions.pod:3514 msgid "\"archlinux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2204 ../src/guestfs-actions.pod:3500 +#: ../fish/guestfish-actions.pod:2216 ../src/guestfs-actions.pod:3516 msgid "Arch Linux." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2206 ../src/guestfs-actions.pod:3502 +#: ../fish/guestfish-actions.pod:2218 ../src/guestfs-actions.pod:3518 msgid "\"buildroot\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2208 ../src/guestfs-actions.pod:3504 +#: ../fish/guestfish-actions.pod:2220 ../src/guestfs-actions.pod:3520 msgid "Buildroot-derived distro, but not one we specifically recognize." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2210 ../src/guestfs-actions.pod:3506 +#: ../fish/guestfish-actions.pod:2222 ../src/guestfs-actions.pod:3522 msgid "\"centos\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2212 ../src/guestfs-actions.pod:3508 +#: ../fish/guestfish-actions.pod:2224 ../src/guestfs-actions.pod:3524 msgid "CentOS." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2214 ../src/guestfs-actions.pod:3510 +#: ../fish/guestfish-actions.pod:2226 ../src/guestfs-actions.pod:3526 msgid "\"cirros\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2216 ../src/guestfs-actions.pod:3512 +#: ../fish/guestfish-actions.pod:2228 ../src/guestfs-actions.pod:3528 msgid "Cirros." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2218 ../src/guestfs-actions.pod:3514 +#: ../fish/guestfish-actions.pod:2230 ../src/guestfs-actions.pod:3530 msgid "\"debian\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2220 ../src/guestfs-actions.pod:3516 +#: ../fish/guestfish-actions.pod:2232 ../src/guestfs-actions.pod:3532 msgid "Debian." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2222 ../src/guestfs-actions.pod:3518 +#: ../fish/guestfish-actions.pod:2234 ../src/guestfs-actions.pod:3534 msgid "\"fedora\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2224 ../src/guestfs-actions.pod:3520 +#: ../fish/guestfish-actions.pod:2236 ../src/guestfs-actions.pod:3536 msgid "Fedora." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2226 ../src/guestfs-actions.pod:3522 +#: ../fish/guestfish-actions.pod:2238 ../src/guestfs-actions.pod:3538 msgid "\"freedos\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2228 ../src/guestfs-actions.pod:3524 +#: ../fish/guestfish-actions.pod:2240 ../src/guestfs-actions.pod:3540 msgid "FreeDOS." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2230 ../src/guestfs-actions.pod:3526 +#: ../fish/guestfish-actions.pod:2242 ../src/guestfs-actions.pod:3542 msgid "\"gentoo\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2232 ../src/guestfs-actions.pod:3528 +#: ../fish/guestfish-actions.pod:2244 ../src/guestfs-actions.pod:3544 msgid "Gentoo." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2234 ../src/guestfs-actions.pod:3530 +#: ../fish/guestfish-actions.pod:2246 ../src/guestfs-actions.pod:3546 msgid "\"linuxmint\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2236 ../src/guestfs-actions.pod:3532 +#: ../fish/guestfish-actions.pod:2248 ../src/guestfs-actions.pod:3548 msgid "Linux Mint." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2238 ../src/guestfs-actions.pod:3534 +#: ../fish/guestfish-actions.pod:2250 ../src/guestfs-actions.pod:3550 msgid "\"mageia\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2240 ../src/guestfs-actions.pod:3536 +#: ../fish/guestfish-actions.pod:2252 ../src/guestfs-actions.pod:3552 msgid "Mageia." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2242 ../src/guestfs-actions.pod:3538 +#: ../fish/guestfish-actions.pod:2254 ../src/guestfs-actions.pod:3554 msgid "\"mandriva\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2244 ../src/guestfs-actions.pod:3540 +#: ../fish/guestfish-actions.pod:2256 ../src/guestfs-actions.pod:3556 msgid "Mandriva." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2246 ../src/guestfs-actions.pod:3542 +#: ../fish/guestfish-actions.pod:2258 ../src/guestfs-actions.pod:3558 msgid "\"meego\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2248 ../src/guestfs-actions.pod:3544 +#: ../fish/guestfish-actions.pod:2260 ../src/guestfs-actions.pod:3560 msgid "MeeGo." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2250 ../src/guestfs-actions.pod:3546 +#: ../fish/guestfish-actions.pod:2262 ../src/guestfs-actions.pod:3562 msgid "\"opensuse\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2252 ../src/guestfs-actions.pod:3548 +#: ../fish/guestfish-actions.pod:2264 ../src/guestfs-actions.pod:3564 msgid "OpenSUSE." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2254 ../src/guestfs-actions.pod:3550 +#: ../fish/guestfish-actions.pod:2266 ../src/guestfs-actions.pod:3566 msgid "\"pardus\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2256 ../src/guestfs-actions.pod:3552 +#: ../fish/guestfish-actions.pod:2268 ../src/guestfs-actions.pod:3568 msgid "Pardus." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2258 ../src/guestfs-actions.pod:3554 +#: ../fish/guestfish-actions.pod:2270 ../src/guestfs-actions.pod:3570 msgid "\"redhat-based\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2260 ../src/guestfs-actions.pod:3556 +#: ../fish/guestfish-actions.pod:2272 ../src/guestfs-actions.pod:3572 msgid "Some Red Hat-derived distro." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2262 ../src/guestfs-actions.pod:3558 +#: ../fish/guestfish-actions.pod:2274 ../src/guestfs-actions.pod:3574 msgid "\"rhel\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2264 ../src/guestfs-actions.pod:3560 +#: ../fish/guestfish-actions.pod:2276 ../src/guestfs-actions.pod:3576 msgid "Red Hat Enterprise Linux." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2266 ../src/guestfs-actions.pod:3562 +#: ../fish/guestfish-actions.pod:2278 ../src/guestfs-actions.pod:3578 msgid "\"scientificlinux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2268 ../src/guestfs-actions.pod:3564 +#: ../fish/guestfish-actions.pod:2280 ../src/guestfs-actions.pod:3580 msgid "Scientific Linux." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2270 ../src/guestfs-actions.pod:3566 +#: ../fish/guestfish-actions.pod:2282 ../src/guestfs-actions.pod:3582 msgid "\"slackware\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2272 ../src/guestfs-actions.pod:3568 +#: ../fish/guestfish-actions.pod:2284 ../src/guestfs-actions.pod:3584 msgid "Slackware." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2274 ../src/guestfs-actions.pod:3570 +#: ../fish/guestfish-actions.pod:2286 ../src/guestfs-actions.pod:3586 msgid "\"ttylinux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2276 ../src/guestfs-actions.pod:3572 +#: ../fish/guestfish-actions.pod:2288 ../src/guestfs-actions.pod:3588 msgid "ttylinux." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2278 ../src/guestfs-actions.pod:3574 +#: ../fish/guestfish-actions.pod:2290 ../src/guestfs-actions.pod:3590 msgid "\"ubuntu\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2280 ../src/guestfs-actions.pod:3576 +#: ../fish/guestfish-actions.pod:2292 ../src/guestfs-actions.pod:3592 msgid "Ubuntu." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2282 ../fish/guestfish-actions.pod:2366 ../fish/guestfish-actions.pod:2643 ../src/guestfs-actions.pod:3578 ../src/guestfs-actions.pod:3687 ../src/guestfs-actions.pod:4075 +#: ../fish/guestfish-actions.pod:2294 ../fish/guestfish-actions.pod:2378 ../fish/guestfish-actions.pod:2655 ../src/guestfs-actions.pod:3594 ../src/guestfs-actions.pod:3703 ../src/guestfs-actions.pod:4091 msgid "\"unknown\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2284 ../src/guestfs-actions.pod:3580 +#: ../fish/guestfish-actions.pod:2296 ../src/guestfs-actions.pod:3596 msgid "The distro could not be determined." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2286 ../fish/guestfish-actions.pod:2623 ../src/guestfs-actions.pod:3582 ../src/guestfs-actions.pod:4055 +#: ../fish/guestfish-actions.pod:2298 ../fish/guestfish-actions.pod:2635 ../src/guestfs-actions.pod:3598 ../src/guestfs-actions.pod:4071 msgid "\"windows\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2288 ../src/guestfs-actions.pod:3584 +#: ../fish/guestfish-actions.pod:2300 ../src/guestfs-actions.pod:3600 msgid "" "Windows does not have distributions. This string is returned if the OS type " "is Windows." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2293 ../fish/guestfish-actions.pod:2372 ../fish/guestfish-actions.pod:2649 ../src/guestfs-actions.pod:3589 ../src/guestfs-actions.pod:3693 ../src/guestfs-actions.pod:4081 +#: ../fish/guestfish-actions.pod:2305 ../fish/guestfish-actions.pod:2384 ../fish/guestfish-actions.pod:2661 ../src/guestfs-actions.pod:3605 ../src/guestfs-actions.pod:3709 ../src/guestfs-actions.pod:4097 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:2298 +#: ../fish/guestfish-actions.pod:2310 msgid "inspect-get-drive-mappings" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2300 +#: ../fish/guestfish-actions.pod:2312 #, no-wrap msgid "" " inspect-get-drive-mappings root\n" @@ -12427,7 +12459,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2302 ../src/guestfs-actions.pod:3605 +#: ../fish/guestfish-actions.pod:2314 ../src/guestfs-actions.pod:3621 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 " @@ -12436,7 +12468,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2308 ../src/guestfs-actions.pod:3611 +#: ../fish/guestfish-actions.pod:2320 ../src/guestfs-actions.pod:3627 #, no-wrap msgid "" " C => /dev/vda2\n" @@ -12446,7 +12478,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2312 ../src/guestfs-actions.pod:3615 +#: ../fish/guestfish-actions.pod:2324 ../src/guestfs-actions.pod:3631 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 " @@ -12454,7 +12486,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2316 ../src/guestfs-actions.pod:3619 +#: ../fish/guestfish-actions.pod:2328 ../src/guestfs-actions.pod:3635 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 " @@ -12463,33 +12495,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2321 ../src/guestfs-actions.pod:3624 +#: ../fish/guestfish-actions.pod:2333 ../src/guestfs-actions.pod:3640 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:2324 ../src/guestfs-actions.pod:3627 +#: ../fish/guestfish-actions.pod:2336 ../src/guestfs-actions.pod:3643 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:2327 +#: ../fish/guestfish-actions.pod:2339 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:2331 +#: ../fish/guestfish-actions.pod:2343 msgid "inspect-get-filesystems" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2333 +#: ../fish/guestfish-actions.pod:2345 #, no-wrap msgid "" " inspect-get-filesystems root\n" @@ -12497,7 +12529,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2335 ../src/guestfs-actions.pod:3648 +#: ../fish/guestfish-actions.pod:2347 ../src/guestfs-actions.pod:3664 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 " @@ -12505,26 +12537,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2340 ../src/guestfs-actions.pod:3653 +#: ../fish/guestfish-actions.pod:2352 ../src/guestfs-actions.pod:3669 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:2343 +#: ../fish/guestfish-actions.pod:2355 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-mountpoints>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2346 +#: ../fish/guestfish-actions.pod:2358 msgid "inspect-get-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2348 +#: ../fish/guestfish-actions.pod:2360 #, no-wrap msgid "" " inspect-get-format root\n" @@ -12532,51 +12564,51 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2350 ../src/guestfs-actions.pod:3671 +#: ../fish/guestfish-actions.pod:2362 ../src/guestfs-actions.pod:3687 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:2353 ../src/guestfs-actions.pod:3674 +#: ../fish/guestfish-actions.pod:2365 ../src/guestfs-actions.pod:3690 msgid "Currently defined formats are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2357 ../src/guestfs-actions.pod:3678 +#: ../fish/guestfish-actions.pod:2369 ../src/guestfs-actions.pod:3694 msgid "\"installed\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2359 ../src/guestfs-actions.pod:3680 +#: ../fish/guestfish-actions.pod:2371 ../src/guestfs-actions.pod:3696 msgid "This is an installed operating system." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2361 ../src/guestfs-actions.pod:3682 +#: ../fish/guestfish-actions.pod:2373 ../src/guestfs-actions.pod:3698 msgid "\"installer\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2363 ../src/guestfs-actions.pod:3684 +#: ../fish/guestfish-actions.pod:2375 ../src/guestfs-actions.pod:3700 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:2368 ../src/guestfs-actions.pod:3689 +#: ../fish/guestfish-actions.pod:2380 ../src/guestfs-actions.pod:3705 msgid "The format of this disk image is not known." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2377 +#: ../fish/guestfish-actions.pod:2389 msgid "inspect-get-hostname" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2379 +#: ../fish/guestfish-actions.pod:2391 #, no-wrap msgid "" " inspect-get-hostname root\n" @@ -12584,26 +12616,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2381 ../src/guestfs-actions.pod:3709 +#: ../fish/guestfish-actions.pod:2393 ../src/guestfs-actions.pod:3725 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:2384 ../src/guestfs-actions.pod:3712 +#: ../fish/guestfish-actions.pod:2396 ../src/guestfs-actions.pod:3728 msgid "" "If the hostname could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2389 +#: ../fish/guestfish-actions.pod:2401 msgid "inspect-get-icon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2391 +#: ../fish/guestfish-actions.pod:2403 #, no-wrap msgid "" " inspect-get-icon root [favicon:true|false] [highquality:true|false]\n" @@ -12611,7 +12643,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2393 ../src/guestfs-actions.pod:3738 +#: ../fish/guestfish-actions.pod:2405 ../src/guestfs-actions.pod:3754 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 " @@ -12619,14 +12651,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2397 ../src/guestfs-actions.pod:3742 +#: ../fish/guestfish-actions.pod:2409 ../src/guestfs-actions.pod:3758 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:2400 ../src/guestfs-actions.pod:3745 +#: ../fish/guestfish-actions.pod:2412 ../src/guestfs-actions.pod:3761 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 " @@ -12635,14 +12667,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2406 ../src/guestfs-actions.pod:3751 +#: ../fish/guestfish-actions.pod:2418 ../src/guestfs-actions.pod:3767 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:2409 ../src/guestfs-actions.pod:3754 +#: ../fish/guestfish-actions.pod:2421 ../src/guestfs-actions.pod:3770 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 " @@ -12651,7 +12683,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2420 ../src/guestfs-actions.pod:3765 +#: ../fish/guestfish-actions.pod:2432 ../src/guestfs-actions.pod:3781 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 " @@ -12659,7 +12691,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2426 ../src/guestfs-actions.pod:3771 +#: ../fish/guestfish-actions.pod:2438 ../src/guestfs-actions.pod:3787 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. " @@ -12668,7 +12700,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2434 ../src/guestfs-actions.pod:3779 +#: ../fish/guestfish-actions.pod:2446 ../src/guestfs-actions.pod:3795 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 " @@ -12676,7 +12708,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2441 ../src/guestfs-actions.pod:3786 +#: ../fish/guestfish-actions.pod:2453 ../src/guestfs-actions.pod:3802 msgid "" "Extracting icons from Windows guests requires the external C<wrestool> " "program from the C<icoutils> package, and several programs (C<bmptopnm>, " @@ -12685,19 +12717,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2448 ../src/guestfs-actions.pod:3793 +#: ../fish/guestfish-actions.pod:2460 ../src/guestfs-actions.pod:3809 msgid "" "Operating system icons are usually trademarks. Seek legal advice before " "using trademarks in applications." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2455 +#: ../fish/guestfish-actions.pod:2467 msgid "inspect-get-major-version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2457 +#: ../fish/guestfish-actions.pod:2469 #, no-wrap msgid "" " inspect-get-major-version root\n" @@ -12705,12 +12737,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2459 ../src/guestfs-actions.pod:3834 +#: ../fish/guestfish-actions.pod:2471 ../src/guestfs-actions.pod:3850 msgid "This returns the major version number of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2462 ../src/guestfs-actions.pod:3837 +#: ../fish/guestfish-actions.pod:2474 ../src/guestfs-actions.pod:3853 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 " @@ -12720,17 +12752,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2469 ../fish/guestfish-actions.pod:2480 ../src/guestfs-actions.pod:3844 ../src/guestfs-actions.pod:3861 +#: ../fish/guestfish-actions.pod:2481 ../fish/guestfish-actions.pod:2492 ../src/guestfs-actions.pod:3860 ../src/guestfs-actions.pod:3877 msgid "If the version could not be determined, then C<0> is returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2473 +#: ../fish/guestfish-actions.pod:2485 msgid "inspect-get-minor-version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2475 +#: ../fish/guestfish-actions.pod:2487 #, no-wrap msgid "" " inspect-get-minor-version root\n" @@ -12738,24 +12770,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2477 ../src/guestfs-actions.pod:3858 +#: ../fish/guestfish-actions.pod:2489 ../src/guestfs-actions.pod:3874 msgid "This returns the minor version number of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2482 +#: ../fish/guestfish-actions.pod:2494 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-major-version>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2485 +#: ../fish/guestfish-actions.pod:2497 msgid "inspect-get-mountpoints" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2487 +#: ../fish/guestfish-actions.pod:2499 #, no-wrap msgid "" " inspect-get-mountpoints root\n" @@ -12763,7 +12795,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2489 ../src/guestfs-actions.pod:3876 +#: ../fish/guestfish-actions.pod:2501 ../src/guestfs-actions.pod:3892 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 " @@ -12774,7 +12806,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2498 ../src/guestfs-actions.pod:3885 +#: ../fish/guestfish-actions.pod:2510 ../src/guestfs-actions.pod:3901 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 " @@ -12782,12 +12814,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2503 ../src/guestfs-actions.pod:3890 +#: ../fish/guestfish-actions.pod:2515 ../src/guestfs-actions.pod:3906 msgid "Non-mounted devices such as swap devices are I<not> returned in this list." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2506 +#: ../fish/guestfish-actions.pod:2518 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 " @@ -12796,19 +12828,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2512 +#: ../fish/guestfish-actions.pod:2524 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2515 +#: ../fish/guestfish-actions.pod:2527 msgid "inspect-get-package-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2517 +#: ../fish/guestfish-actions.pod:2529 #, no-wrap msgid "" " inspect-get-package-format root\n" @@ -12816,7 +12848,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2519 +#: ../fish/guestfish-actions.pod:2531 msgid "" "This function and L</inspect-get-package-management> return the package " "format and package management tool used by the inspected operating system. " @@ -12825,7 +12857,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2525 ../src/guestfs-actions.pod:3922 +#: ../fish/guestfish-actions.pod:2537 ../src/guestfs-actions.pod:3938 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 " @@ -12833,19 +12865,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2529 ../src/guestfs-actions.pod:3926 +#: ../fish/guestfish-actions.pod:2541 ../src/guestfs-actions.pod:3942 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:2535 +#: ../fish/guestfish-actions.pod:2547 msgid "inspect-get-package-management" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2537 +#: ../fish/guestfish-actions.pod:2549 #, no-wrap msgid "" " inspect-get-package-management root\n" @@ -12853,7 +12885,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2539 +#: ../fish/guestfish-actions.pod:2551 msgid "" "L</inspect-get-package-format> and this function return the package format " "and package management tool used by the inspected operating system. For " @@ -12862,7 +12894,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2545 ../src/guestfs-actions.pod:3949 +#: ../fish/guestfish-actions.pod:2557 ../src/guestfs-actions.pod:3965 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 " @@ -12870,7 +12902,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2549 ../src/guestfs-actions.pod:3953 +#: ../fish/guestfish-actions.pod:2561 ../src/guestfs-actions.pod:3969 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 " @@ -12878,12 +12910,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2556 +#: ../fish/guestfish-actions.pod:2568 msgid "inspect-get-product-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2558 +#: ../fish/guestfish-actions.pod:2570 #, no-wrap msgid "" " inspect-get-product-name root\n" @@ -12891,7 +12923,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2560 ../src/guestfs-actions.pod:3971 +#: ../fish/guestfish-actions.pod:2572 ../src/guestfs-actions.pod:3987 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 " @@ -12899,19 +12931,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2565 ../src/guestfs-actions.pod:3976 +#: ../fish/guestfish-actions.pod:2577 ../src/guestfs-actions.pod:3992 msgid "" "If the product name could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2570 +#: ../fish/guestfish-actions.pod:2582 msgid "inspect-get-product-variant" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2572 +#: ../fish/guestfish-actions.pod:2584 #, no-wrap msgid "" " inspect-get-product-variant root\n" @@ -12919,12 +12951,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2574 ../src/guestfs-actions.pod:3992 +#: ../fish/guestfish-actions.pod:2586 ../src/guestfs-actions.pod:4008 msgid "This returns the product variant of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2577 ../src/guestfs-actions.pod:3995 +#: ../fish/guestfish-actions.pod:2589 ../src/guestfs-actions.pod:4011 msgid "" "For Windows guests, this returns the contents of the Registry key " "C<HKLM\\Software\\Microsoft\\Windows NT\\CurrentVersion> C<InstallationType> " @@ -12936,7 +12968,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2586 ../src/guestfs-actions.pod:4004 +#: ../fish/guestfish-actions.pod:2598 ../src/guestfs-actions.pod:4020 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 " @@ -12944,26 +12976,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2590 ../src/guestfs-actions.pod:4008 +#: ../fish/guestfish-actions.pod:2602 ../src/guestfs-actions.pod:4024 msgid "" "If the product variant could not be determined, then the string C<unknown> " "is returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2593 +#: ../fish/guestfish-actions.pod:2605 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:2597 +#: ../fish/guestfish-actions.pod:2609 msgid "inspect-get-roots" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2599 +#: ../fish/guestfish-actions.pod:2611 #, no-wrap msgid "" " inspect-get-roots\n" @@ -12971,7 +13003,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2601 +#: ../fish/guestfish-actions.pod:2613 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 " @@ -12979,19 +13011,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2605 +#: ../fish/guestfish-actions.pod:2617 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:2610 +#: ../fish/guestfish-actions.pod:2622 msgid "inspect-get-type" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2612 +#: ../fish/guestfish-actions.pod:2624 #, no-wrap msgid "" " inspect-get-type root\n" @@ -12999,79 +13031,79 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2614 ../src/guestfs-actions.pod:4046 +#: ../fish/guestfish-actions.pod:2626 ../src/guestfs-actions.pod:4062 msgid "" "This returns the type of the inspected operating system. Currently defined " "types are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2619 ../src/guestfs-actions.pod:4051 +#: ../fish/guestfish-actions.pod:2631 ../src/guestfs-actions.pod:4067 msgid "\"linux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2621 ../src/guestfs-actions.pod:4053 +#: ../fish/guestfish-actions.pod:2633 ../src/guestfs-actions.pod:4069 msgid "Any Linux-based operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2625 ../src/guestfs-actions.pod:4057 +#: ../fish/guestfish-actions.pod:2637 ../src/guestfs-actions.pod:4073 msgid "Any Microsoft Windows operating system." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2627 ../src/guestfs-actions.pod:4059 +#: ../fish/guestfish-actions.pod:2639 ../src/guestfs-actions.pod:4075 msgid "\"freebsd\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2629 ../src/guestfs-actions.pod:4061 +#: ../fish/guestfish-actions.pod:2641 ../src/guestfs-actions.pod:4077 msgid "FreeBSD." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2631 ../src/guestfs-actions.pod:4063 +#: ../fish/guestfish-actions.pod:2643 ../src/guestfs-actions.pod:4079 msgid "\"netbsd\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2633 ../src/guestfs-actions.pod:4065 +#: ../fish/guestfish-actions.pod:2645 ../src/guestfs-actions.pod:4081 msgid "NetBSD." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2635 ../src/guestfs-actions.pod:4067 +#: ../fish/guestfish-actions.pod:2647 ../src/guestfs-actions.pod:4083 msgid "\"hurd\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2637 ../src/guestfs-actions.pod:4069 +#: ../fish/guestfish-actions.pod:2649 ../src/guestfs-actions.pod:4085 msgid "GNU/Hurd." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2639 ../src/guestfs-actions.pod:4071 +#: ../fish/guestfish-actions.pod:2651 ../src/guestfs-actions.pod:4087 msgid "\"dos\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2641 ../src/guestfs-actions.pod:4073 +#: ../fish/guestfish-actions.pod:2653 ../src/guestfs-actions.pod:4089 msgid "MS-DOS, FreeDOS and others." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2645 ../src/guestfs-actions.pod:4077 +#: ../fish/guestfish-actions.pod:2657 ../src/guestfs-actions.pod:4093 msgid "The operating system type could not be determined." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2654 +#: ../fish/guestfish-actions.pod:2666 msgid "inspect-get-windows-current-control-set" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2656 +#: ../fish/guestfish-actions.pod:2668 #, no-wrap msgid "" " inspect-get-windows-current-control-set root\n" @@ -13079,26 +13111,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2658 ../src/guestfs-actions.pod:4097 +#: ../fish/guestfish-actions.pod:2670 ../src/guestfs-actions.pod:4113 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:2661 ../src/guestfs-actions.pod:4100 +#: ../fish/guestfish-actions.pod:2673 ../src/guestfs-actions.pod:4116 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:2667 +#: ../fish/guestfish-actions.pod:2679 msgid "inspect-get-windows-systemroot" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2669 +#: ../fish/guestfish-actions.pod:2681 #, no-wrap msgid "" " inspect-get-windows-systemroot root\n" @@ -13106,14 +13138,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2671 ../src/guestfs-actions.pod:4117 +#: ../fish/guestfish-actions.pod:2683 ../src/guestfs-actions.pod:4133 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:2674 ../src/guestfs-actions.pod:4120 +#: ../fish/guestfish-actions.pod:2686 ../src/guestfs-actions.pod:4136 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 " @@ -13121,12 +13153,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2680 +#: ../fish/guestfish-actions.pod:2692 msgid "inspect-is-live" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2682 +#: ../fish/guestfish-actions.pod:2694 #, no-wrap msgid "" " inspect-is-live root\n" @@ -13134,19 +13166,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2684 +#: ../fish/guestfish-actions.pod:2696 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:2690 +#: ../fish/guestfish-actions.pod:2702 msgid "inspect-is-multipart" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2692 +#: ../fish/guestfish-actions.pod:2704 #, no-wrap msgid "" " inspect-is-multipart root\n" @@ -13154,19 +13186,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2694 +#: ../fish/guestfish-actions.pod:2706 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:2700 +#: ../fish/guestfish-actions.pod:2712 msgid "inspect-is-netinst" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2702 +#: ../fish/guestfish-actions.pod:2714 #, no-wrap msgid "" " inspect-is-netinst root\n" @@ -13174,7 +13206,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2704 +#: ../fish/guestfish-actions.pod:2716 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 " @@ -13183,12 +13215,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2712 +#: ../fish/guestfish-actions.pod:2724 msgid "inspect-list-applications" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2714 +#: ../fish/guestfish-actions.pod:2726 #, no-wrap msgid "" " inspect-list-applications root\n" @@ -13196,12 +13228,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2716 ../src/guestfs-actions.pod:4187 +#: ../fish/guestfish-actions.pod:2728 ../src/guestfs-actions.pod:4203 msgid "Return the list of applications installed in the operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2718 +#: ../fish/guestfish-actions.pod:2730 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>, " @@ -13213,91 +13245,91 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2728 ../src/guestfs-actions.pod:4199 +#: ../fish/guestfish-actions.pod:2740 ../src/guestfs-actions.pod:4215 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:2731 ../src/guestfs-actions.pod:4202 +#: ../fish/guestfish-actions.pod:2743 ../src/guestfs-actions.pod:4218 msgid "The application structure contains the following fields:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2735 ../src/guestfs-actions.pod:4206 +#: ../fish/guestfish-actions.pod:2747 ../src/guestfs-actions.pod:4222 msgid "C<app_name>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2737 ../src/guestfs-actions.pod:4208 +#: ../fish/guestfish-actions.pod:2749 ../src/guestfs-actions.pod:4224 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:2740 ../src/guestfs-actions.pod:4211 +#: ../fish/guestfish-actions.pod:2752 ../src/guestfs-actions.pod:4227 msgid "C<app_display_name>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2742 ../src/guestfs-actions.pod:4213 +#: ../fish/guestfish-actions.pod:2754 ../src/guestfs-actions.pod:4229 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:2745 ../src/guestfs-actions.pod:4216 +#: ../fish/guestfish-actions.pod:2757 ../src/guestfs-actions.pod:4232 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:2748 ../src/guestfs-actions.pod:4219 +#: ../fish/guestfish-actions.pod:2760 ../src/guestfs-actions.pod:4235 msgid "C<app_epoch>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2750 ../src/guestfs-actions.pod:4221 +#: ../fish/guestfish-actions.pod:2762 ../src/guestfs-actions.pod:4237 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:2753 ../src/guestfs-actions.pod:4224 +#: ../fish/guestfish-actions.pod:2765 ../src/guestfs-actions.pod:4240 msgid "C<app_version>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2755 ../src/guestfs-actions.pod:4226 +#: ../fish/guestfish-actions.pod:2767 ../src/guestfs-actions.pod:4242 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:2758 ../src/guestfs-actions.pod:4229 +#: ../fish/guestfish-actions.pod:2770 ../src/guestfs-actions.pod:4245 msgid "C<app_release>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2760 ../src/guestfs-actions.pod:4231 +#: ../fish/guestfish-actions.pod:2772 ../src/guestfs-actions.pod:4247 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:2764 ../src/guestfs-actions.pod:4235 +#: ../fish/guestfish-actions.pod:2776 ../src/guestfs-actions.pod:4251 msgid "C<app_install_path>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2766 ../src/guestfs-actions.pod:4237 +#: ../fish/guestfish-actions.pod:2778 ../src/guestfs-actions.pod:4253 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 " @@ -13305,89 +13337,89 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2771 ../src/guestfs-actions.pod:4242 +#: ../fish/guestfish-actions.pod:2783 ../src/guestfs-actions.pod:4258 msgid "If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2773 ../src/guestfs-actions.pod:4244 +#: ../fish/guestfish-actions.pod:2785 ../src/guestfs-actions.pod:4260 msgid "C<app_trans_path>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2775 ../src/guestfs-actions.pod:4246 +#: ../fish/guestfish-actions.pod:2787 ../src/guestfs-actions.pod:4262 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:2778 ../src/guestfs-actions.pod:4249 +#: ../fish/guestfish-actions.pod:2790 ../src/guestfs-actions.pod:4265 msgid "C<app_publisher>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2780 ../src/guestfs-actions.pod:4251 +#: ../fish/guestfish-actions.pod:2792 ../src/guestfs-actions.pod:4267 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:2784 ../src/guestfs-actions.pod:4255 +#: ../fish/guestfish-actions.pod:2796 ../src/guestfs-actions.pod:4271 msgid "C<app_url>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2786 ../src/guestfs-actions.pod:4257 +#: ../fish/guestfish-actions.pod:2798 ../src/guestfs-actions.pod:4273 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:2789 ../src/guestfs-actions.pod:4260 +#: ../fish/guestfish-actions.pod:2801 ../src/guestfs-actions.pod:4276 msgid "C<app_source_package>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2791 ../src/guestfs-actions.pod:4262 +#: ../fish/guestfish-actions.pod:2803 ../src/guestfs-actions.pod:4278 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:2794 ../src/guestfs-actions.pod:4265 +#: ../fish/guestfish-actions.pod:2806 ../src/guestfs-actions.pod:4281 msgid "C<app_summary>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2796 ../src/guestfs-actions.pod:4267 +#: ../fish/guestfish-actions.pod:2808 ../src/guestfs-actions.pod:4283 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:2799 ../src/guestfs-actions.pod:4270 +#: ../fish/guestfish-actions.pod:2811 ../src/guestfs-actions.pod:4286 msgid "C<app_description>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2801 ../src/guestfs-actions.pod:4272 +#: ../fish/guestfish-actions.pod:2813 ../src/guestfs-actions.pod:4288 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:2808 +#: ../fish/guestfish-actions.pod:2820 msgid "inspect-os" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2810 +#: ../fish/guestfish-actions.pod:2822 #, no-wrap msgid "" " inspect-os\n" @@ -13395,7 +13427,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2812 ../src/guestfs-actions.pod:4290 +#: ../fish/guestfish-actions.pod:2824 ../src/guestfs-actions.pod:4306 msgid "" "This function uses other libguestfs functions and certain heuristics to " "inspect the disk(s) (usually disks belonging to a virtual machine), looking " @@ -13403,12 +13435,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2816 ../src/guestfs-actions.pod:4294 +#: ../fish/guestfish-actions.pod:2828 ../src/guestfs-actions.pod:4310 msgid "The list returned is empty if no operating systems were found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2818 ../src/guestfs-actions.pod:4296 +#: ../fish/guestfish-actions.pod:2830 ../src/guestfs-actions.pod:4312 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. " @@ -13418,7 +13450,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2825 +#: ../fish/guestfish-actions.pod:2837 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, " @@ -13426,7 +13458,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2830 +#: ../fish/guestfish-actions.pod:2842 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 " @@ -13435,24 +13467,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2836 ../src/guestfs-actions.pod:4314 +#: ../fish/guestfish-actions.pod:2848 ../src/guestfs-actions.pod:4330 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:2842 ../fish/guestfish-actions.pod:3056 ../fish/guestfish-actions.pod:3121 +#: ../fish/guestfish-actions.pod:2854 ../fish/guestfish-actions.pod:3077 ../fish/guestfish-actions.pod:3142 msgid "See also L</list-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2844 +#: ../fish/guestfish-actions.pod:2856 msgid "is-blockdev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2846 +#: ../fish/guestfish-actions.pod:2858 #, no-wrap msgid "" " is-blockdev path\n" @@ -13460,24 +13492,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2848 ../src/guestfs-actions.pod:4334 +#: ../fish/guestfish-actions.pod:2860 ../src/guestfs-actions.pod:4350 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:2851 ../fish/guestfish-actions.pod:2860 ../fish/guestfish-actions.pod:2879 ../fish/guestfish-actions.pod:2888 ../fish/guestfish-actions.pod:2898 ../fish/guestfish-actions.pod:2932 ../fish/guestfish-actions.pod:2941 +#: ../fish/guestfish-actions.pod:2863 ../fish/guestfish-actions.pod:2872 ../fish/guestfish-actions.pod:2891 ../fish/guestfish-actions.pod:2900 ../fish/guestfish-actions.pod:2910 ../fish/guestfish-actions.pod:2944 ../fish/guestfish-actions.pod:2953 msgid "See also L</stat>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2853 +#: ../fish/guestfish-actions.pod:2865 msgid "is-chardev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2855 +#: ../fish/guestfish-actions.pod:2867 #, no-wrap msgid "" " is-chardev path\n" @@ -13485,19 +13517,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2857 ../src/guestfs-actions.pod:4349 +#: ../fish/guestfish-actions.pod:2869 ../src/guestfs-actions.pod:4365 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:2862 +#: ../fish/guestfish-actions.pod:2874 msgid "is-config" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2864 +#: ../fish/guestfish-actions.pod:2876 #, no-wrap msgid "" " is-config\n" @@ -13505,19 +13537,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2866 ../src/guestfs-actions.pod:4363 +#: ../fish/guestfish-actions.pod:2878 ../src/guestfs-actions.pod:4379 msgid "" "This returns true iff this handle is being configured (in the C<CONFIG> " "state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2871 +#: ../fish/guestfish-actions.pod:2883 msgid "is-dir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2873 +#: ../fish/guestfish-actions.pod:2885 #, no-wrap msgid "" " is-dir path\n" @@ -13525,19 +13557,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2875 ../src/guestfs-actions.pod:4378 +#: ../fish/guestfish-actions.pod:2887 ../src/guestfs-actions.pod:4394 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:2881 +#: ../fish/guestfish-actions.pod:2893 msgid "is-fifo" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2883 +#: ../fish/guestfish-actions.pod:2895 #, no-wrap msgid "" " is-fifo path\n" @@ -13545,19 +13577,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2885 ../src/guestfs-actions.pod:4394 +#: ../fish/guestfish-actions.pod:2897 ../src/guestfs-actions.pod:4410 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:2890 +#: ../fish/guestfish-actions.pod:2902 msgid "is-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2892 +#: ../fish/guestfish-actions.pod:2904 #, no-wrap msgid "" " is-file path\n" @@ -13565,7 +13597,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2894 ../src/guestfs-actions.pod:4409 +#: ../fish/guestfish-actions.pod:2906 ../src/guestfs-actions.pod:4425 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 " @@ -13573,12 +13605,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2900 +#: ../fish/guestfish-actions.pod:2912 msgid "is-launching" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2902 +#: ../fish/guestfish-actions.pod:2914 #, no-wrap msgid "" " is-launching\n" @@ -13586,19 +13618,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2904 ../src/guestfs-actions.pod:4424 +#: ../fish/guestfish-actions.pod:2916 ../src/guestfs-actions.pod:4440 msgid "" "This returns true iff this handle is launching the subprocess (in the " "C<LAUNCHING> state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2909 +#: ../fish/guestfish-actions.pod:2921 msgid "is-lv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2911 +#: ../fish/guestfish-actions.pod:2923 #, no-wrap msgid "" " is-lv device\n" @@ -13606,19 +13638,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2913 ../src/guestfs-actions.pod:4439 +#: ../fish/guestfish-actions.pod:2925 ../src/guestfs-actions.pod:4455 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:2916 +#: ../fish/guestfish-actions.pod:2928 msgid "is-ready" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2918 +#: ../fish/guestfish-actions.pod:2930 #, no-wrap msgid "" " is-ready\n" @@ -13626,19 +13658,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2920 ../src/guestfs-actions.pod:4451 +#: ../fish/guestfish-actions.pod:2932 ../src/guestfs-actions.pod:4467 msgid "" "This returns true iff this handle is ready to accept commands (in the " "C<READY> state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2925 +#: ../fish/guestfish-actions.pod:2937 msgid "is-socket" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2927 +#: ../fish/guestfish-actions.pod:2939 #, no-wrap msgid "" " is-socket path\n" @@ -13646,19 +13678,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2929 ../src/guestfs-actions.pod:4466 +#: ../fish/guestfish-actions.pod:2941 ../src/guestfs-actions.pod:4482 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:2934 +#: ../fish/guestfish-actions.pod:2946 msgid "is-symlink" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2936 +#: ../fish/guestfish-actions.pod:2948 #, no-wrap msgid "" " is-symlink path\n" @@ -13666,19 +13698,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2938 ../src/guestfs-actions.pod:4481 +#: ../fish/guestfish-actions.pod:2950 ../src/guestfs-actions.pod:4497 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:2943 +#: ../fish/guestfish-actions.pod:2955 msgid "is-zero" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2945 +#: ../fish/guestfish-actions.pod:2957 #, no-wrap msgid "" " is-zero path\n" @@ -13686,19 +13718,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2947 ../src/guestfs-actions.pod:4496 +#: ../fish/guestfish-actions.pod:2959 ../src/guestfs-actions.pod:4512 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:2950 +#: ../fish/guestfish-actions.pod:2962 msgid "is-zero-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2952 +#: ../fish/guestfish-actions.pod:2964 #, no-wrap msgid "" " is-zero-device device\n" @@ -13706,22 +13738,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2954 ../src/guestfs-actions.pod:4509 +#: ../fish/guestfish-actions.pod:2966 ../src/guestfs-actions.pod:4525 msgid "This returns true iff the device exists and contains all zero bytes." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2956 ../src/guestfs-actions.pod:4511 +#: ../fish/guestfish-actions.pod:2968 ../src/guestfs-actions.pod:4527 msgid "Note that for large devices this can take a long time to run." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2958 +#: ../fish/guestfish-actions.pod:2970 msgid "isoinfo" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2960 +#: ../fish/guestfish-actions.pod:2972 #, no-wrap msgid "" " isoinfo isofile\n" @@ -13729,7 +13761,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2962 +#: ../fish/guestfish-actions.pod:2974 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 " @@ -13738,12 +13770,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2968 +#: ../fish/guestfish-actions.pod:2980 msgid "isoinfo-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2970 +#: ../fish/guestfish-actions.pod:2982 #, no-wrap msgid "" " isoinfo-device device\n" @@ -13751,7 +13783,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2972 ../src/guestfs-actions.pod:4541 +#: ../fish/guestfish-actions.pod:2984 ../src/guestfs-actions.pod:4557 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 " @@ -13759,7 +13791,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2976 ../src/guestfs-actions.pod:4545 +#: ../fish/guestfish-actions.pod:2988 ../src/guestfs-actions.pod:4561 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 " @@ -13767,19 +13799,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2980 ../src/guestfs-actions.pod:4549 +#: ../fish/guestfish-actions.pod:2992 ../src/guestfs-actions.pod:4565 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:2983 +#: ../fish/guestfish-actions.pod:2995 msgid "kill-subprocess" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2985 +#: ../fish/guestfish-actions.pod:2997 #, no-wrap msgid "" " kill-subprocess\n" @@ -13787,22 +13819,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2987 ../src/guestfs-actions.pod:4563 -msgid "This kills the qemu subprocess. You should never need to call this." +#: ../fish/guestfish-actions.pod:2999 ../src/guestfs-actions.pod:4586 +msgid "This kills the qemu subprocess." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3001 +msgid "Do not call this. See: L</shutdown> instead." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3003 +msgid "" +"I<This function is deprecated.> In new code, use the L</shutdown> call " +"instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2989 +#: ../fish/guestfish-actions.pod:3010 msgid "launch" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2991 +#: ../fish/guestfish-actions.pod:3012 msgid "run" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2993 +#: ../fish/guestfish-actions.pod:3014 #, no-wrap msgid "" " launch\n" @@ -13810,26 +13854,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2995 ../src/guestfs-actions.pod:4574 +#: ../fish/guestfish-actions.pod:3016 ../src/guestfs-actions.pod:4599 msgid "" "Internally libguestfs is implemented by running a virtual machine using " "L<qemu(1)>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2998 ../src/guestfs-actions.pod:4577 +#: ../fish/guestfish-actions.pod:3019 ../src/guestfs-actions.pod:4602 msgid "" "You should call this after configuring the handle (eg. adding drives) but " "before performing any actions." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3001 +#: ../fish/guestfish-actions.pod:3022 msgid "lchown" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3003 +#: ../fish/guestfish-actions.pod:3024 #, no-wrap msgid "" " lchown owner group path\n" @@ -13837,7 +13881,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3005 +#: ../fish/guestfish-actions.pod:3026 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 " @@ -13845,12 +13889,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3013 +#: ../fish/guestfish-actions.pod:3034 msgid "lgetxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3015 +#: ../fish/guestfish-actions.pod:3036 #, no-wrap msgid "" " lgetxattr path name\n" @@ -13858,24 +13902,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3017 ../src/guestfs-actions.pod:4617 +#: ../fish/guestfish-actions.pod:3038 ../src/guestfs-actions.pod:4642 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:3031 +#: ../fish/guestfish-actions.pod:3052 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3033 +#: ../fish/guestfish-actions.pod:3054 msgid "lgetxattrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3035 +#: ../fish/guestfish-actions.pod:3056 #, no-wrap msgid "" " lgetxattrs path\n" @@ -13883,19 +13927,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3037 +#: ../fish/guestfish-actions.pod:3058 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:3041 +#: ../fish/guestfish-actions.pod:3062 msgid "list-9p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3043 +#: ../fish/guestfish-actions.pod:3064 #, no-wrap msgid "" " list-9p\n" @@ -13903,19 +13947,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3045 ../src/guestfs-actions.pod:4660 +#: ../fish/guestfish-actions.pod:3066 ../src/guestfs-actions.pod:4685 msgid "" "List all 9p filesystems attached to the guest. A list of mount tags is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3048 +#: ../fish/guestfish-actions.pod:3069 msgid "list-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3050 +#: ../fish/guestfish-actions.pod:3071 #, no-wrap msgid "" " list-devices\n" @@ -13923,22 +13967,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3052 ../src/guestfs-actions.pod:4674 +#: ../fish/guestfish-actions.pod:3073 ../src/guestfs-actions.pod:4699 msgid "List all the block devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3054 ../src/guestfs-actions.pod:4676 +#: ../fish/guestfish-actions.pod:3075 ../src/guestfs-actions.pod:4701 msgid "The full block device names are returned, eg. C</dev/sda>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3058 +#: ../fish/guestfish-actions.pod:3079 msgid "list-dm-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3060 +#: ../fish/guestfish-actions.pod:3081 #, no-wrap msgid "" " list-dm-devices\n" @@ -13946,31 +13990,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3062 ../src/guestfs-actions.pod:4691 +#: ../fish/guestfish-actions.pod:3083 ../src/guestfs-actions.pod:4716 msgid "List all device mapper devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3064 +#: ../fish/guestfish-actions.pod:3085 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:3067 +#: ../fish/guestfish-actions.pod:3088 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:3071 +#: ../fish/guestfish-actions.pod:3092 msgid "list-filesystems" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3073 +#: ../fish/guestfish-actions.pod:3094 #, no-wrap msgid "" " list-filesystems\n" @@ -13978,7 +14022,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3075 ../src/guestfs-actions.pod:4711 +#: ../fish/guestfish-actions.pod:3096 ../src/guestfs-actions.pod:4736 msgid "" "This inspection command looks for filesystems on partitions, block devices " "and logical volumes, returning a list of devices containing filesystems and " @@ -13986,14 +14030,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3079 ../src/guestfs-actions.pod:4715 +#: ../fish/guestfish-actions.pod:3100 ../src/guestfs-actions.pod:4740 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:3083 ../src/guestfs-actions.pod:4719 +#: ../fish/guestfish-actions.pod:3104 ../src/guestfs-actions.pod:4744 #, no-wrap msgid "" " \"/dev/sda1\" => \"ntfs\"\n" @@ -14004,14 +14048,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3088 ../src/guestfs-actions.pod:4724 +#: ../fish/guestfish-actions.pod:3109 ../src/guestfs-actions.pod:4749 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:3092 +#: ../fish/guestfish-actions.pod:3113 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 " @@ -14019,7 +14063,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3096 +#: ../fish/guestfish-actions.pod:3117 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 " @@ -14029,12 +14073,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3104 +#: ../fish/guestfish-actions.pod:3125 msgid "list-md-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3106 +#: ../fish/guestfish-actions.pod:3127 #, no-wrap msgid "" " list-md-devices\n" @@ -14042,17 +14086,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3108 ../src/guestfs-actions.pod:4753 +#: ../fish/guestfish-actions.pod:3129 ../src/guestfs-actions.pod:4778 msgid "List all Linux md devices." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3110 +#: ../fish/guestfish-actions.pod:3131 msgid "list-partitions" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3112 +#: ../fish/guestfish-actions.pod:3133 #, no-wrap msgid "" " list-partitions\n" @@ -14060,29 +14104,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3114 ../src/guestfs-actions.pod:4766 +#: ../fish/guestfish-actions.pod:3135 ../src/guestfs-actions.pod:4791 msgid "List all the partitions detected on all block devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3116 ../src/guestfs-actions.pod:4768 +#: ../fish/guestfish-actions.pod:3137 ../src/guestfs-actions.pod:4793 msgid "The full partition device names are returned, eg. C</dev/sda1>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3118 +#: ../fish/guestfish-actions.pod:3139 msgid "" "This does not return logical volumes. For that you will need to call " "L</lvs>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3123 +#: ../fish/guestfish-actions.pod:3144 msgid "ll" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3125 +#: ../fish/guestfish-actions.pod:3146 #, no-wrap msgid "" " ll directory\n" @@ -14090,26 +14134,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3127 ../src/guestfs-actions.pod:4787 +#: ../fish/guestfish-actions.pod:3148 ../src/guestfs-actions.pod:4812 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:3130 ../fish/guestfish-actions.pod:3139 ../src/guestfs-actions.pod:4790 ../src/guestfs-actions.pod:4806 +#: ../fish/guestfish-actions.pod:3151 ../fish/guestfish-actions.pod:3160 ../src/guestfs-actions.pod:4815 ../src/guestfs-actions.pod:4831 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:3133 +#: ../fish/guestfish-actions.pod:3154 msgid "llz" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3135 +#: ../fish/guestfish-actions.pod:3156 #, no-wrap msgid "" " llz directory\n" @@ -14117,17 +14161,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3137 ../src/guestfs-actions.pod:4804 +#: ../fish/guestfish-actions.pod:3158 ../src/guestfs-actions.pod:4829 msgid "List the files in C<directory> in the format of 'ls -laZ'." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3142 +#: ../fish/guestfish-actions.pod:3163 msgid "ln" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3144 +#: ../fish/guestfish-actions.pod:3165 #, no-wrap msgid "" " ln target linkname\n" @@ -14135,17 +14179,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3146 ../src/guestfs-actions.pod:4821 +#: ../fish/guestfish-actions.pod:3167 ../src/guestfs-actions.pod:4846 msgid "This command creates a hard link using the C<ln> command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3148 +#: ../fish/guestfish-actions.pod:3169 msgid "ln-f" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3150 +#: ../fish/guestfish-actions.pod:3171 #, no-wrap msgid "" " ln-f target linkname\n" @@ -14153,19 +14197,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3152 ../src/guestfs-actions.pod:4834 +#: ../fish/guestfish-actions.pod:3173 ../src/guestfs-actions.pod:4859 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:3155 +#: ../fish/guestfish-actions.pod:3176 msgid "ln-s" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3157 +#: ../fish/guestfish-actions.pod:3178 #, no-wrap msgid "" " ln-s target linkname\n" @@ -14173,17 +14217,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3159 ../src/guestfs-actions.pod:4848 +#: ../fish/guestfish-actions.pod:3180 ../src/guestfs-actions.pod:4873 msgid "This command creates a symbolic link using the C<ln -s> command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3161 +#: ../fish/guestfish-actions.pod:3182 msgid "ln-sf" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3163 +#: ../fish/guestfish-actions.pod:3184 #, no-wrap msgid "" " ln-sf target linkname\n" @@ -14191,19 +14235,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3165 ../src/guestfs-actions.pod:4861 +#: ../fish/guestfish-actions.pod:3186 ../src/guestfs-actions.pod:4886 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:3168 +#: ../fish/guestfish-actions.pod:3189 msgid "lremovexattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3170 +#: ../fish/guestfish-actions.pod:3191 #, no-wrap msgid "" " lremovexattr xattr path\n" @@ -14211,19 +14255,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3172 +#: ../fish/guestfish-actions.pod:3193 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:3176 +#: ../fish/guestfish-actions.pod:3197 msgid "ls" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3178 +#: ../fish/guestfish-actions.pod:3199 #, no-wrap msgid "" " ls directory\n" @@ -14231,7 +14275,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3180 ../src/guestfs-actions.pod:4889 +#: ../fish/guestfish-actions.pod:3201 ../src/guestfs-actions.pod:4914 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 " @@ -14239,19 +14283,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3184 +#: ../fish/guestfish-actions.pod:3205 msgid "" "This command is mostly useful for interactive sessions. Programs should " "probably use L</readdir> instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3187 +#: ../fish/guestfish-actions.pod:3208 msgid "lsetxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3189 +#: ../fish/guestfish-actions.pod:3210 #, no-wrap msgid "" " lsetxattr xattr val vallen path\n" @@ -14259,19 +14303,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3191 +#: ../fish/guestfish-actions.pod:3212 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:3195 +#: ../fish/guestfish-actions.pod:3216 msgid "lstat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3197 +#: ../fish/guestfish-actions.pod:3218 #, no-wrap msgid "" " lstat path\n" @@ -14279,29 +14323,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3199 ../fish/guestfish-actions.pod:5329 ../src/guestfs-actions.pod:4925 ../src/guestfs-actions.pod:8321 +#: ../fish/guestfish-actions.pod:3220 ../fish/guestfish-actions.pod:5381 ../src/guestfs-actions.pod:4950 ../src/guestfs-actions.pod:8383 msgid "Returns file information for the given C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3201 +#: ../fish/guestfish-actions.pod:3222 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:3205 ../src/guestfs-actions.pod:4931 +#: ../fish/guestfish-actions.pod:3226 ../src/guestfs-actions.pod:4956 msgid "This is the same as the C<lstat(2)> system call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3207 +#: ../fish/guestfish-actions.pod:3228 msgid "lstatlist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3209 +#: ../fish/guestfish-actions.pod:3230 #, no-wrap msgid "" " lstatlist path 'names ...'\n" @@ -14309,7 +14353,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3211 +#: ../fish/guestfish-actions.pod:3232 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 " @@ -14317,7 +14361,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3215 ../src/guestfs-actions.pod:4950 +#: ../fish/guestfish-actions.pod:3236 ../src/guestfs-actions.pod:4975 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, " @@ -14325,7 +14369,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3220 +#: ../fish/guestfish-actions.pod:3241 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 " @@ -14336,12 +14380,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3228 +#: ../fish/guestfish-actions.pod:3249 msgid "luks-add-key" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3230 +#: ../fish/guestfish-actions.pod:3251 #, no-wrap msgid "" " luks-add-key device keyslot\n" @@ -14349,7 +14393,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3232 ../src/guestfs-actions.pod:4978 +#: ../fish/guestfish-actions.pod:3253 ../src/guestfs-actions.pod:5003 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 " @@ -14357,26 +14401,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3237 +#: ../fish/guestfish-actions.pod:3258 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:3241 ../fish/guestfish-actions.pod:3263 ../fish/guestfish-actions.pod:3273 ../fish/guestfish-actions.pod:3284 ../fish/guestfish-actions.pod:3310 ../fish/guestfish-actions.pod:3320 +#: ../fish/guestfish-actions.pod:3262 ../fish/guestfish-actions.pod:3284 ../fish/guestfish-actions.pod:3294 ../fish/guestfish-actions.pod:3305 ../fish/guestfish-actions.pod:3331 ../fish/guestfish-actions.pod:3341 msgid "" "This command has one or more key or passphrase parameters. Guestfish will " "prompt for these separately." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3244 +#: ../fish/guestfish-actions.pod:3265 msgid "luks-close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3246 +#: ../fish/guestfish-actions.pod:3267 #, no-wrap msgid "" " luks-close device\n" @@ -14384,7 +14428,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3248 +#: ../fish/guestfish-actions.pod:3269 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 " @@ -14393,12 +14437,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3254 +#: ../fish/guestfish-actions.pod:3275 msgid "luks-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3256 +#: ../fish/guestfish-actions.pod:3277 #, no-wrap msgid "" " luks-format device keyslot\n" @@ -14406,7 +14450,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3258 ../src/guestfs-actions.pod:5019 +#: ../fish/guestfish-actions.pod:3279 ../src/guestfs-actions.pod:5044 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 " @@ -14414,12 +14458,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3266 +#: ../fish/guestfish-actions.pod:3287 msgid "luks-format-cipher" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3268 +#: ../fish/guestfish-actions.pod:3289 #, no-wrap msgid "" " luks-format-cipher device keyslot cipher\n" @@ -14427,19 +14471,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3270 +#: ../fish/guestfish-actions.pod:3291 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:3276 +#: ../fish/guestfish-actions.pod:3297 msgid "luks-kill-slot" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3278 +#: ../fish/guestfish-actions.pod:3299 #, no-wrap msgid "" " luks-kill-slot device keyslot\n" @@ -14447,19 +14491,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3280 ../src/guestfs-actions.pod:5060 +#: ../fish/guestfish-actions.pod:3301 ../src/guestfs-actions.pod:5085 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:3287 +#: ../fish/guestfish-actions.pod:3308 msgid "luks-open" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3289 +#: ../fish/guestfish-actions.pod:3310 #, no-wrap msgid "" " luks-open device mapname\n" @@ -14467,26 +14511,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3291 ../src/guestfs-actions.pod:5080 +#: ../fish/guestfish-actions.pod:3312 ../src/guestfs-actions.pod:5105 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:3294 ../src/guestfs-actions.pod:5083 +#: ../fish/guestfish-actions.pod:3315 ../src/guestfs-actions.pod:5108 msgid "C<device> is the encrypted block device or partition." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3296 ../src/guestfs-actions.pod:5085 +#: ../fish/guestfish-actions.pod:3317 ../src/guestfs-actions.pod:5110 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:3299 ../src/guestfs-actions.pod:5088 +#: ../fish/guestfish-actions.pod:3320 ../src/guestfs-actions.pod:5113 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 " @@ -14494,24 +14538,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3303 +#: ../fish/guestfish-actions.pod:3324 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:3307 +#: ../fish/guestfish-actions.pod:3328 msgid "Use L</list-dm-devices> to list all device mapper devices." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3313 +#: ../fish/guestfish-actions.pod:3334 msgid "luks-open-ro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3315 +#: ../fish/guestfish-actions.pod:3336 #, no-wrap msgid "" " luks-open-ro device mapname\n" @@ -14519,19 +14563,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3317 +#: ../fish/guestfish-actions.pod:3338 msgid "" "This is the same as L</luks-open> except that a read-only mapping is " "created." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3323 +#: ../fish/guestfish-actions.pod:3344 msgid "lvcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3325 +#: ../fish/guestfish-actions.pod:3346 #, no-wrap msgid "" " lvcreate logvol volgroup mbytes\n" @@ -14539,19 +14583,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3327 ../src/guestfs-actions.pod:5134 +#: ../fish/guestfish-actions.pod:3348 ../src/guestfs-actions.pod:5159 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:3330 +#: ../fish/guestfish-actions.pod:3351 msgid "lvcreate-free" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3332 +#: ../fish/guestfish-actions.pod:3353 #, no-wrap msgid "" " lvcreate-free logvol volgroup percent\n" @@ -14559,7 +14603,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3334 ../src/guestfs-actions.pod:5149 +#: ../fish/guestfish-actions.pod:3355 ../src/guestfs-actions.pod:5174 msgid "" "Create an LVM logical volume called C</dev/volgroup/logvol>, using " "approximately C<percent> % of the free space remaining in the volume group. " @@ -14568,12 +14612,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3339 +#: ../fish/guestfish-actions.pod:3360 msgid "lvm-canonical-lv-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3341 +#: ../fish/guestfish-actions.pod:3362 #, no-wrap msgid "" " lvm-canonical-lv-name lvname\n" @@ -14581,7 +14625,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3343 ../src/guestfs-actions.pod:5164 +#: ../fish/guestfish-actions.pod:3364 ../src/guestfs-actions.pod:5189 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 " @@ -14589,24 +14633,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3347 ../src/guestfs-actions.pod:5168 +#: ../fish/guestfish-actions.pod:3368 ../src/guestfs-actions.pod:5193 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:3350 +#: ../fish/guestfish-actions.pod:3371 msgid "See also L</is-lv>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3352 +#: ../fish/guestfish-actions.pod:3373 msgid "lvm-clear-filter" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3354 +#: ../fish/guestfish-actions.pod:3375 #, no-wrap msgid "" " lvm-clear-filter\n" @@ -14614,24 +14658,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3356 +#: ../fish/guestfish-actions.pod:3377 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:3359 ../fish/guestfish-actions.pod:3387 ../src/guestfs-actions.pod:5186 ../src/guestfs-actions.pod:5225 +#: ../fish/guestfish-actions.pod:3380 ../fish/guestfish-actions.pod:3408 ../src/guestfs-actions.pod:5211 ../src/guestfs-actions.pod:5250 msgid "This command also clears the LVM cache and performs a volume group scan." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3362 +#: ../fish/guestfish-actions.pod:3383 msgid "lvm-remove-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3364 +#: ../fish/guestfish-actions.pod:3385 #, no-wrap msgid "" " lvm-remove-all\n" @@ -14639,19 +14683,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3366 ../src/guestfs-actions.pod:5198 +#: ../fish/guestfish-actions.pod:3387 ../src/guestfs-actions.pod:5223 msgid "" "This command removes all LVM logical volumes, volume groups and physical " "volumes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3369 +#: ../fish/guestfish-actions.pod:3390 msgid "lvm-set-filter" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3371 +#: ../fish/guestfish-actions.pod:3392 #, no-wrap msgid "" " lvm-set-filter 'devices ...'\n" @@ -14659,7 +14703,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3373 ../src/guestfs-actions.pod:5211 +#: ../fish/guestfish-actions.pod:3394 ../src/guestfs-actions.pod:5236 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 " @@ -14667,7 +14711,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3377 ../src/guestfs-actions.pod:5215 +#: ../fish/guestfish-actions.pod:3398 ../src/guestfs-actions.pod:5240 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 " @@ -14679,24 +14723,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3390 ../src/guestfs-actions.pod:5228 +#: ../fish/guestfish-actions.pod:3411 ../src/guestfs-actions.pod:5253 msgid "You can filter whole block devices or individual partitions." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3392 ../src/guestfs-actions.pod:5230 +#: ../fish/guestfish-actions.pod:3413 ../src/guestfs-actions.pod:5255 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:3396 +#: ../fish/guestfish-actions.pod:3417 msgid "lvremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3398 +#: ../fish/guestfish-actions.pod:3419 #, no-wrap msgid "" " lvremove device\n" @@ -14704,26 +14748,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3400 ../src/guestfs-actions.pod:5244 +#: ../fish/guestfish-actions.pod:3421 ../src/guestfs-actions.pod:5269 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:3403 ../src/guestfs-actions.pod:5247 +#: ../fish/guestfish-actions.pod:3424 ../src/guestfs-actions.pod:5272 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:3406 +#: ../fish/guestfish-actions.pod:3427 msgid "lvrename" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3408 +#: ../fish/guestfish-actions.pod:3429 #, no-wrap msgid "" " lvrename logvol newlogvol\n" @@ -14731,17 +14775,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3410 ../src/guestfs-actions.pod:5261 +#: ../fish/guestfish-actions.pod:3431 ../src/guestfs-actions.pod:5286 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3412 +#: ../fish/guestfish-actions.pod:3433 msgid "lvresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3414 +#: ../fish/guestfish-actions.pod:3435 #, no-wrap msgid "" " lvresize device mbytes\n" @@ -14749,19 +14793,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3416 ../src/guestfs-actions.pod:5274 +#: ../fish/guestfish-actions.pod:3437 ../src/guestfs-actions.pod:5299 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:3420 +#: ../fish/guestfish-actions.pod:3441 msgid "lvresize-free" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3422 +#: ../fish/guestfish-actions.pod:3443 #, no-wrap msgid "" " lvresize-free lv percent\n" @@ -14769,7 +14813,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3424 ../src/guestfs-actions.pod:5289 +#: ../fish/guestfish-actions.pod:3445 ../src/guestfs-actions.pod:5314 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 " @@ -14778,12 +14822,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3430 +#: ../fish/guestfish-actions.pod:3451 msgid "lvs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3432 +#: ../fish/guestfish-actions.pod:3453 #, no-wrap msgid "" " lvs\n" @@ -14791,31 +14835,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3434 ../src/guestfs-actions.pod:5304 +#: ../fish/guestfish-actions.pod:3455 ../src/guestfs-actions.pod:5329 msgid "" "List all the logical volumes detected. This is the equivalent of the " "L<lvs(8)> command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3437 ../src/guestfs-actions.pod:5307 +#: ../fish/guestfish-actions.pod:3458 ../src/guestfs-actions.pod:5332 msgid "" "This returns a list of the logical volume device names " "(eg. C</dev/VolGroup00/LogVol00>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3440 +#: ../fish/guestfish-actions.pod:3461 msgid "See also L</lvs-full>, L</list-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3442 +#: ../fish/guestfish-actions.pod:3463 msgid "lvs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3444 +#: ../fish/guestfish-actions.pod:3465 #, no-wrap msgid "" " lvs-full\n" @@ -14823,19 +14867,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3446 ../src/guestfs-actions.pod:5323 +#: ../fish/guestfish-actions.pod:3467 ../src/guestfs-actions.pod:5348 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:3449 +#: ../fish/guestfish-actions.pod:3470 msgid "lvuuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3451 +#: ../fish/guestfish-actions.pod:3472 #, no-wrap msgid "" " lvuuid device\n" @@ -14843,17 +14887,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3453 ../src/guestfs-actions.pod:5338 +#: ../fish/guestfish-actions.pod:3474 ../src/guestfs-actions.pod:5363 msgid "This command returns the UUID of the LVM LV C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3455 +#: ../fish/guestfish-actions.pod:3476 msgid "lxattrlist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3457 +#: ../fish/guestfish-actions.pod:3478 #, no-wrap msgid "" " lxattrlist path 'names ...'\n" @@ -14861,7 +14905,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3459 ../src/guestfs-actions.pod:5352 +#: ../fish/guestfish-actions.pod:3480 ../src/guestfs-actions.pod:5377 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 " @@ -14869,7 +14913,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3463 ../src/guestfs-actions.pod:5356 +#: ../fish/guestfish-actions.pod:3484 ../src/guestfs-actions.pod:5381 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>. " @@ -14882,7 +14926,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3473 +#: ../fish/guestfish-actions.pod:3494 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 " @@ -14893,12 +14937,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3481 +#: ../fish/guestfish-actions.pod:3502 msgid "md-create" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3483 +#: ../fish/guestfish-actions.pod:3504 #, no-wrap msgid "" " md-create name 'devices ...' [missingbitmap:N] [nrdevices:N] [spare:N] " @@ -14907,19 +14951,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3485 ../src/guestfs-actions.pod:5399 +#: ../fish/guestfish-actions.pod:3506 ../src/guestfs-actions.pod:5424 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:3492 ../src/guestfs-actions.pod:5406 +#: ../fish/guestfish-actions.pod:3513 ../src/guestfs-actions.pod:5431 msgid "C<missingbitmap>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3494 ../src/guestfs-actions.pod:5408 +#: ../fish/guestfish-actions.pod:3515 ../src/guestfs-actions.pod:5433 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 " @@ -14927,85 +14971,85 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3498 ../src/guestfs-actions.pod:5412 +#: ../fish/guestfish-actions.pod:3519 ../src/guestfs-actions.pod:5437 msgid "As examples:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3500 ../src/guestfs-actions.pod:5414 +#: ../fish/guestfish-actions.pod:3521 ../src/guestfs-actions.pod:5439 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:3503 ../src/guestfs-actions.pod:5417 +#: ../fish/guestfish-actions.pod:3524 ../src/guestfs-actions.pod:5442 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:3506 ../src/guestfs-actions.pod:5420 +#: ../fish/guestfish-actions.pod:3527 ../src/guestfs-actions.pod:5445 msgid "This defaults to C<0> (no missing devices)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3508 ../src/guestfs-actions.pod:5422 +#: ../fish/guestfish-actions.pod:3529 ../src/guestfs-actions.pod:5447 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:3511 ../src/guestfs-actions.pod:5425 +#: ../fish/guestfish-actions.pod:3532 ../src/guestfs-actions.pod:5450 msgid "C<nrdevices>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3513 ../src/guestfs-actions.pod:5427 +#: ../fish/guestfish-actions.pod:3534 ../src/guestfs-actions.pod:5452 msgid "The number of active RAID devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3515 ../src/guestfs-actions.pod:5429 +#: ../fish/guestfish-actions.pod:3536 ../src/guestfs-actions.pod:5454 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:3518 ../src/guestfs-actions.pod:5432 +#: ../fish/guestfish-actions.pod:3539 ../src/guestfs-actions.pod:5457 msgid "C<spare>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3520 ../src/guestfs-actions.pod:5434 +#: ../fish/guestfish-actions.pod:3541 ../src/guestfs-actions.pod:5459 msgid "The number of spare devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3522 ../src/guestfs-actions.pod:5436 +#: ../fish/guestfish-actions.pod:3543 ../src/guestfs-actions.pod:5461 msgid "If not set, this defaults to C<0>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3524 ../src/guestfs-actions.pod:5438 +#: ../fish/guestfish-actions.pod:3545 ../src/guestfs-actions.pod:5463 msgid "C<chunk>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3526 ../src/guestfs-actions.pod:5440 +#: ../fish/guestfish-actions.pod:3547 ../src/guestfs-actions.pod:5465 msgid "The chunk size in bytes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3528 ../fish/guestfish-actions.pod:3551 ../src/guestfs-actions.pod:5442 ../src/guestfs-actions.pod:5493 +#: ../fish/guestfish-actions.pod:3549 ../fish/guestfish-actions.pod:3572 ../src/guestfs-actions.pod:5467 ../src/guestfs-actions.pod:5518 msgid "C<level>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3530 ../src/guestfs-actions.pod:5444 +#: ../fish/guestfish-actions.pod:3551 ../src/guestfs-actions.pod:5469 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>, " @@ -15014,17 +15058,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3535 ../src/guestfs-actions.pod:5449 +#: ../fish/guestfish-actions.pod:3556 ../src/guestfs-actions.pod:5474 msgid "If not set, this defaults to C<raid1>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3541 +#: ../fish/guestfish-actions.pod:3562 msgid "md-detail" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3543 +#: ../fish/guestfish-actions.pod:3564 #, no-wrap msgid "" " md-detail md\n" @@ -15032,7 +15076,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3545 ../src/guestfs-actions.pod:5487 +#: ../fish/guestfish-actions.pod:3566 ../src/guestfs-actions.pod:5512 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 " @@ -15040,52 +15084,52 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3553 ../src/guestfs-actions.pod:5495 +#: ../fish/guestfish-actions.pod:3574 ../src/guestfs-actions.pod:5520 msgid "The raid level of the MD device." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3555 ../src/guestfs-actions.pod:5497 +#: ../fish/guestfish-actions.pod:3576 ../src/guestfs-actions.pod:5522 msgid "C<devices>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3557 ../src/guestfs-actions.pod:5499 +#: ../fish/guestfish-actions.pod:3578 ../src/guestfs-actions.pod:5524 msgid "The number of underlying devices in the MD device." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3559 ../src/guestfs-actions.pod:5501 +#: ../fish/guestfish-actions.pod:3580 ../src/guestfs-actions.pod:5526 msgid "C<metadata>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3561 ../src/guestfs-actions.pod:5503 +#: ../fish/guestfish-actions.pod:3582 ../src/guestfs-actions.pod:5528 msgid "The metadata version used." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3563 ../src/guestfs-actions.pod:5505 +#: ../fish/guestfish-actions.pod:3584 ../src/guestfs-actions.pod:5530 msgid "C<uuid>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3565 ../src/guestfs-actions.pod:5507 +#: ../fish/guestfish-actions.pod:3586 ../src/guestfs-actions.pod:5532 msgid "The UUID of the MD device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3569 ../src/guestfs-actions.pod:5511 +#: ../fish/guestfish-actions.pod:3590 ../src/guestfs-actions.pod:5536 msgid "The name of the MD device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3573 +#: ../fish/guestfish-actions.pod:3594 msgid "md-stat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3575 +#: ../fish/guestfish-actions.pod:3596 #, no-wrap msgid "" " md-stat md\n" @@ -15093,103 +15137,103 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3577 ../src/guestfs-actions.pod:5529 +#: ../fish/guestfish-actions.pod:3598 ../src/guestfs-actions.pod:5554 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:3580 +#: ../fish/guestfish-actions.pod:3601 msgid "To get a list of software RAID devices, call L</list-md-devices>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3582 ../src/guestfs-actions.pod:5534 +#: ../fish/guestfish-actions.pod:3603 ../src/guestfs-actions.pod:5559 msgid "" "Each structure returned corresponds to one device along with additional " "status information:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3587 ../src/guestfs-actions.pod:5539 +#: ../fish/guestfish-actions.pod:3608 ../src/guestfs-actions.pod:5564 msgid "C<mdstat_device>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3589 ../src/guestfs-actions.pod:5541 +#: ../fish/guestfish-actions.pod:3610 ../src/guestfs-actions.pod:5566 msgid "The name of the underlying device." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3591 ../src/guestfs-actions.pod:5543 +#: ../fish/guestfish-actions.pod:3612 ../src/guestfs-actions.pod:5568 msgid "C<mdstat_index>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3593 ../src/guestfs-actions.pod:5545 +#: ../fish/guestfish-actions.pod:3614 ../src/guestfs-actions.pod:5570 msgid "The index of this device within the array." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3595 ../src/guestfs-actions.pod:5547 +#: ../fish/guestfish-actions.pod:3616 ../src/guestfs-actions.pod:5572 msgid "C<mdstat_flags>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3597 ../src/guestfs-actions.pod:5549 +#: ../fish/guestfish-actions.pod:3618 ../src/guestfs-actions.pod:5574 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:3602 ../src/guestfs-actions.pod:5554 +#: ../fish/guestfish-actions.pod:3623 ../src/guestfs-actions.pod:5579 msgid "C<W>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3604 ../src/guestfs-actions.pod:5556 +#: ../fish/guestfish-actions.pod:3625 ../src/guestfs-actions.pod:5581 msgid "write-mostly" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3606 ../src/guestfs-actions.pod:5558 +#: ../fish/guestfish-actions.pod:3627 ../src/guestfs-actions.pod:5583 msgid "C<F>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3608 ../src/guestfs-actions.pod:5560 +#: ../fish/guestfish-actions.pod:3629 ../src/guestfs-actions.pod:5585 msgid "device is faulty" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3610 ../src/guestfs-actions.pod:5562 +#: ../fish/guestfish-actions.pod:3631 ../src/guestfs-actions.pod:5587 msgid "C<S>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3612 ../src/guestfs-actions.pod:5564 +#: ../fish/guestfish-actions.pod:3633 ../src/guestfs-actions.pod:5589 msgid "device is a RAID spare" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3614 ../src/guestfs-actions.pod:5566 +#: ../fish/guestfish-actions.pod:3635 ../src/guestfs-actions.pod:5591 msgid "C<R>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3616 ../src/guestfs-actions.pod:5568 +#: ../fish/guestfish-actions.pod:3637 ../src/guestfs-actions.pod:5593 msgid "replacement" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3622 +#: ../fish/guestfish-actions.pod:3643 msgid "md-stop" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3624 +#: ../fish/guestfish-actions.pod:3645 #, no-wrap msgid "" " md-stop md\n" @@ -15197,19 +15241,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3626 ../src/guestfs-actions.pod:5586 +#: ../fish/guestfish-actions.pod:3647 ../src/guestfs-actions.pod:5611 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:3629 +#: ../fish/guestfish-actions.pod:3650 msgid "mkdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3631 +#: ../fish/guestfish-actions.pod:3652 #, no-wrap msgid "" " mkdir path\n" @@ -15217,17 +15261,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3633 ../src/guestfs-actions.pod:5599 +#: ../fish/guestfish-actions.pod:3654 ../src/guestfs-actions.pod:5624 msgid "Create a directory named C<path>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3635 +#: ../fish/guestfish-actions.pod:3656 msgid "mkdir-mode" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3637 +#: ../fish/guestfish-actions.pod:3658 #, no-wrap msgid "" " mkdir-mode path mode\n" @@ -15235,14 +15279,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3639 ../src/guestfs-actions.pod:5612 +#: ../fish/guestfish-actions.pod:3660 ../src/guestfs-actions.pod:5637 msgid "" "This command creates a directory, setting the initial permissions of the " "directory to C<mode>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3642 ../src/guestfs-actions.pod:5615 +#: ../fish/guestfish-actions.pod:3663 ../src/guestfs-actions.pod:5640 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 " @@ -15250,17 +15294,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3646 +#: ../fish/guestfish-actions.pod:3667 msgid "See also L</mkdir>, L</umask>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3648 +#: ../fish/guestfish-actions.pod:3669 msgid "mkdir-p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3650 +#: ../fish/guestfish-actions.pod:3671 #, no-wrap msgid "" " mkdir-p path\n" @@ -15268,19 +15312,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3652 ../src/guestfs-actions.pod:5631 +#: ../fish/guestfish-actions.pod:3673 ../src/guestfs-actions.pod:5656 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:3655 +#: ../fish/guestfish-actions.pod:3676 msgid "mkdtemp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3657 +#: ../fish/guestfish-actions.pod:3678 #, no-wrap msgid "" " mkdtemp tmpl\n" @@ -15288,7 +15332,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3659 ../src/guestfs-actions.pod:5644 +#: ../fish/guestfish-actions.pod:3680 ../src/guestfs-actions.pod:5669 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 " @@ -15296,41 +15340,41 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3664 ../src/guestfs-actions.pod:5649 +#: ../fish/guestfish-actions.pod:3685 ../src/guestfs-actions.pod:5674 msgid "" "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one " "being suitable for Windows filesystems." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3667 ../src/guestfs-actions.pod:5652 +#: ../fish/guestfish-actions.pod:3688 ../src/guestfs-actions.pod:5677 msgid "The name of the temporary directory that was created is returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3670 ../src/guestfs-actions.pod:5655 +#: ../fish/guestfish-actions.pod:3691 ../src/guestfs-actions.pod:5680 msgid "The temporary directory is created with mode 0700 and is owned by root." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3673 ../src/guestfs-actions.pod:5658 +#: ../fish/guestfish-actions.pod:3694 ../src/guestfs-actions.pod:5683 msgid "" "The caller is responsible for deleting the temporary directory and its " "contents after use." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3676 ../src/guestfs-actions.pod:5661 +#: ../fish/guestfish-actions.pod:3697 ../src/guestfs-actions.pod:5686 msgid "See also: L<mkdtemp(3)>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3678 +#: ../fish/guestfish-actions.pod:3699 msgid "mke2fs-J" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3680 +#: ../fish/guestfish-actions.pod:3701 #, no-wrap msgid "" " mke2fs-J fstype blocksize device journal\n" @@ -15338,14 +15382,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3682 ../src/guestfs-actions.pod:5677 +#: ../fish/guestfish-actions.pod:3703 ../src/guestfs-actions.pod:5702 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:3686 ../src/guestfs-actions.pod:5681 +#: ../fish/guestfish-actions.pod:3707 ../src/guestfs-actions.pod:5706 #, no-wrap msgid "" " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n" @@ -15353,17 +15397,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3688 +#: ../fish/guestfish-actions.pod:3709 msgid "See also L</mke2journal>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3690 +#: ../fish/guestfish-actions.pod:3711 msgid "mke2fs-JL" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3692 +#: ../fish/guestfish-actions.pod:3713 #, no-wrap msgid "" " mke2fs-JL fstype blocksize device label\n" @@ -15371,24 +15415,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3694 ../src/guestfs-actions.pod:5698 +#: ../fish/guestfish-actions.pod:3715 ../src/guestfs-actions.pod:5723 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:3697 +#: ../fish/guestfish-actions.pod:3718 msgid "See also L</mke2journal-L>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3699 +#: ../fish/guestfish-actions.pod:3720 msgid "mke2fs-JU" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3701 +#: ../fish/guestfish-actions.pod:3722 #, no-wrap msgid "" " mke2fs-JU fstype blocksize device uuid\n" @@ -15396,24 +15440,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3703 ../src/guestfs-actions.pod:5716 +#: ../fish/guestfish-actions.pod:3724 ../src/guestfs-actions.pod:5741 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:3706 +#: ../fish/guestfish-actions.pod:3727 msgid "See also L</mke2journal-U>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3708 +#: ../fish/guestfish-actions.pod:3729 msgid "mke2journal" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3710 +#: ../fish/guestfish-actions.pod:3731 #, no-wrap msgid "" " mke2journal blocksize device\n" @@ -15421,14 +15465,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3712 ../src/guestfs-actions.pod:5732 +#: ../fish/guestfish-actions.pod:3733 ../src/guestfs-actions.pod:5757 msgid "" "This creates an ext2 external journal on C<device>. It is equivalent to the " "command:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3715 ../src/guestfs-actions.pod:5735 +#: ../fish/guestfish-actions.pod:3736 ../src/guestfs-actions.pod:5760 #, no-wrap msgid "" " mke2fs -O journal_dev -b blocksize device\n" @@ -15436,12 +15480,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3717 +#: ../fish/guestfish-actions.pod:3738 msgid "mke2journal-L" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3719 +#: ../fish/guestfish-actions.pod:3740 #, no-wrap msgid "" " mke2journal-L blocksize label device\n" @@ -15449,17 +15493,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3721 ../src/guestfs-actions.pod:5749 +#: ../fish/guestfish-actions.pod:3742 ../src/guestfs-actions.pod:5774 msgid "This creates an ext2 external journal on C<device> with label C<label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3723 +#: ../fish/guestfish-actions.pod:3744 msgid "mke2journal-U" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3725 +#: ../fish/guestfish-actions.pod:3746 #, no-wrap msgid "" " mke2journal-U blocksize uuid device\n" @@ -15467,17 +15511,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3727 ../src/guestfs-actions.pod:5763 +#: ../fish/guestfish-actions.pod:3748 ../src/guestfs-actions.pod:5788 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3729 +#: ../fish/guestfish-actions.pod:3750 msgid "mkfifo" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3731 +#: ../fish/guestfish-actions.pod:3752 #, no-wrap msgid "" " mkfifo mode path\n" @@ -15485,19 +15529,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3733 +#: ../fish/guestfish-actions.pod:3754 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:3739 +#: ../fish/guestfish-actions.pod:3760 msgid "mkfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3741 +#: ../fish/guestfish-actions.pod:3762 #, no-wrap msgid "" " mkfs fstype device\n" @@ -15505,19 +15549,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3743 ../src/guestfs-actions.pod:5793 +#: ../fish/guestfish-actions.pod:3764 ../src/guestfs-actions.pod:5818 msgid "" "This creates a filesystem on C<device> (usually a partition or LVM logical " "volume). The filesystem type is C<fstype>, for example C<ext3>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3747 +#: ../fish/guestfish-actions.pod:3768 msgid "mkfs-b" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3749 +#: ../fish/guestfish-actions.pod:3770 #, no-wrap msgid "" " mkfs-b fstype blocksize device\n" @@ -15525,7 +15569,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3751 +#: ../fish/guestfish-actions.pod:3772 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 " @@ -15533,26 +15577,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3756 ../fish/guestfish-actions.pod:3797 ../src/guestfs-actions.pod:5821 ../src/guestfs-actions.pod:5914 +#: ../fish/guestfish-actions.pod:3777 ../fish/guestfish-actions.pod:3818 ../src/guestfs-actions.pod:5846 ../src/guestfs-actions.pod:5939 msgid "" "For VFAT and NTFS the C<blocksize> parameter is treated as the requested " "cluster size." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3759 +#: ../fish/guestfish-actions.pod:3780 msgid "" "I<This function is deprecated.> In new code, use the L</mkfs_opts> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3766 +#: ../fish/guestfish-actions.pod:3787 msgid "mkfs-btrfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3768 +#: ../fish/guestfish-actions.pod:3789 #, no-wrap msgid "" " mkfs-btrfs 'devices ...' [allocstart:N] [bytecount:N] [datatype:..] " @@ -15561,31 +15605,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3770 ../src/guestfs-actions.pod:5849 +#: ../fish/guestfish-actions.pod:3791 ../src/guestfs-actions.pod:5874 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:3773 ../src/guestfs-actions.pod:5852 +#: ../fish/guestfish-actions.pod:3794 ../src/guestfs-actions.pod:5877 msgid "" "Since btrfs filesystems can span multiple devices, this takes a non-empty " "list of devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3776 +#: ../fish/guestfish-actions.pod:3797 msgid "To create general filesystems, use L</mkfs-opts>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3780 +#: ../fish/guestfish-actions.pod:3801 msgid "mkfs-opts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3782 +#: ../fish/guestfish-actions.pod:3803 #, no-wrap msgid "" " mkfs-opts fstype device [blocksize:N] [features:..] [inode:N] " @@ -15594,19 +15638,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3784 ../src/guestfs-actions.pod:5901 +#: ../fish/guestfish-actions.pod:3805 ../src/guestfs-actions.pod:5926 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:3791 ../src/guestfs-actions.pod:5908 +#: ../fish/guestfish-actions.pod:3812 ../src/guestfs-actions.pod:5933 msgid "C<blocksize>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3793 ../src/guestfs-actions.pod:5910 +#: ../fish/guestfish-actions.pod:3814 ../src/guestfs-actions.pod:5935 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 " @@ -15614,65 +15658,65 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3800 ../src/guestfs-actions.pod:5917 +#: ../fish/guestfish-actions.pod:3821 ../src/guestfs-actions.pod:5942 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3802 ../src/guestfs-actions.pod:5919 +#: ../fish/guestfish-actions.pod:3823 ../src/guestfs-actions.pod:5944 msgid "C<features>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3804 ../src/guestfs-actions.pod:5921 +#: ../fish/guestfish-actions.pod:3825 ../src/guestfs-actions.pod:5946 msgid "This passes the I<-O> parameter to the external mkfs program." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3806 ../src/guestfs-actions.pod:5923 +#: ../fish/guestfish-actions.pod:3827 ../src/guestfs-actions.pod:5948 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:3810 ../src/guestfs-actions.pod:5927 +#: ../fish/guestfish-actions.pod:3831 ../src/guestfs-actions.pod:5952 msgid "" "You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem " "type." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3813 ../src/guestfs-actions.pod:5930 +#: ../fish/guestfish-actions.pod:3834 ../src/guestfs-actions.pod:5955 msgid "C<inode>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3815 ../src/guestfs-actions.pod:5932 +#: ../fish/guestfish-actions.pod:3836 ../src/guestfs-actions.pod:5957 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:3818 ../src/guestfs-actions.pod:5935 +#: ../fish/guestfish-actions.pod:3839 ../src/guestfs-actions.pod:5960 msgid "C<sectorsize>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3820 ../src/guestfs-actions.pod:5937 +#: ../fish/guestfish-actions.pod:3841 ../src/guestfs-actions.pod:5962 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:3827 +#: ../fish/guestfish-actions.pod:3848 msgid "mkmountpoint" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3829 +#: ../fish/guestfish-actions.pod:3850 #, no-wrap msgid "" " mkmountpoint exemptpath\n" @@ -15680,14 +15724,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3831 +#: ../fish/guestfish-actions.pod:3852 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:3835 ../src/guestfs-actions.pod:5980 +#: ../fish/guestfish-actions.pod:3856 ../src/guestfs-actions.pod:6005 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 " @@ -15695,7 +15739,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3839 ../src/guestfs-actions.pod:5984 +#: ../fish/guestfish-actions.pod:3860 ../src/guestfs-actions.pod:6009 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 " @@ -15703,7 +15747,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3844 ../src/guestfs-actions.pod:5989 +#: ../fish/guestfish-actions.pod:3865 ../src/guestfs-actions.pod:6014 #, no-wrap msgid "" " add-ro Fedora-11-i686-Live.iso\n" @@ -15718,12 +15762,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3853 ../src/guestfs-actions.pod:5998 +#: ../fish/guestfish-actions.pod:3874 ../src/guestfs-actions.pod:6023 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3855 +#: ../fish/guestfish-actions.pod:3876 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 " @@ -15731,7 +15775,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3859 +#: ../fish/guestfish-actions.pod:3880 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 " @@ -15739,12 +15783,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3864 ../src/guestfs-actions.pod:6009 +#: ../fish/guestfish-actions.pod:3885 ../src/guestfs-actions.pod:6034 msgid "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3866 +#: ../fish/guestfish-actions.pod:3887 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 " @@ -15752,12 +15796,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3870 +#: ../fish/guestfish-actions.pod:3891 msgid "mknod" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3872 +#: ../fish/guestfish-actions.pod:3893 #, no-wrap msgid "" " mknod mode devmajor devminor path\n" @@ -15765,14 +15809,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3874 ../src/guestfs-actions.pod:6028 +#: ../fish/guestfish-actions.pod:3895 ../src/guestfs-actions.pod:6053 msgid "" "This call creates block or character special devices, or named pipes " "(FIFOs)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3877 ../src/guestfs-actions.pod:6031 +#: ../fish/guestfish-actions.pod:3898 ../src/guestfs-actions.pod:6056 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 " @@ -15780,7 +15824,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3882 +#: ../fish/guestfish-actions.pod:3903 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 " @@ -15791,12 +15835,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3892 +#: ../fish/guestfish-actions.pod:3913 msgid "mknod-b" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3894 +#: ../fish/guestfish-actions.pod:3915 #, no-wrap msgid "" " mknod-b mode devmajor devminor path\n" @@ -15804,7 +15848,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3896 +#: ../fish/guestfish-actions.pod:3917 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 " @@ -15812,12 +15856,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3902 +#: ../fish/guestfish-actions.pod:3923 msgid "mknod-c" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3904 +#: ../fish/guestfish-actions.pod:3925 #, no-wrap msgid "" " mknod-c mode devmajor devminor path\n" @@ -15825,7 +15869,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3906 +#: ../fish/guestfish-actions.pod:3927 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 " @@ -15833,12 +15877,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3912 +#: ../fish/guestfish-actions.pod:3933 msgid "mkswap" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3914 +#: ../fish/guestfish-actions.pod:3935 #, no-wrap msgid "" " mkswap device\n" @@ -15846,17 +15890,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3916 ../src/guestfs-actions.pod:6094 +#: ../fish/guestfish-actions.pod:3937 ../src/guestfs-actions.pod:6119 msgid "Create a swap partition on C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3918 +#: ../fish/guestfish-actions.pod:3939 msgid "mkswap-L" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3920 +#: ../fish/guestfish-actions.pod:3941 #, no-wrap msgid "" " mkswap-L label device\n" @@ -15864,12 +15908,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3922 ../src/guestfs-actions.pod:6107 +#: ../fish/guestfish-actions.pod:3943 ../src/guestfs-actions.pod:6132 msgid "Create a swap partition on C<device> with label C<label>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3924 ../src/guestfs-actions.pod:6109 +#: ../fish/guestfish-actions.pod:3945 ../src/guestfs-actions.pod:6134 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 " @@ -15877,12 +15921,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3928 +#: ../fish/guestfish-actions.pod:3949 msgid "mkswap-U" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3930 +#: ../fish/guestfish-actions.pod:3951 #, no-wrap msgid "" " mkswap-U uuid device\n" @@ -15890,17 +15934,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3932 ../src/guestfs-actions.pod:6124 +#: ../fish/guestfish-actions.pod:3953 ../src/guestfs-actions.pod:6149 msgid "Create a swap partition on C<device> with UUID C<uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3934 +#: ../fish/guestfish-actions.pod:3955 msgid "mkswap-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3936 +#: ../fish/guestfish-actions.pod:3957 #, no-wrap msgid "" " mkswap-file path\n" @@ -15908,24 +15952,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3938 ../src/guestfs-actions.pod:6136 +#: ../fish/guestfish-actions.pod:3959 ../src/guestfs-actions.pod:6161 msgid "Create a swap file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3940 +#: ../fish/guestfish-actions.pod:3961 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:3943 +#: ../fish/guestfish-actions.pod:3964 msgid "modprobe" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3945 +#: ../fish/guestfish-actions.pod:3966 #, no-wrap msgid "" " modprobe modulename\n" @@ -15933,24 +15977,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3947 ../src/guestfs-actions.pod:6151 +#: ../fish/guestfish-actions.pod:3968 ../src/guestfs-actions.pod:6176 msgid "This loads a kernel module in the appliance." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3949 ../src/guestfs-actions.pod:6153 +#: ../fish/guestfish-actions.pod:3970 ../src/guestfs-actions.pod:6178 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:3952 +#: ../fish/guestfish-actions.pod:3973 msgid "mount" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3954 +#: ../fish/guestfish-actions.pod:3975 #, no-wrap msgid "" " mount device mountpoint\n" @@ -15958,7 +16002,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3956 ../src/guestfs-actions.pod:6167 +#: ../fish/guestfish-actions.pod:3977 ../src/guestfs-actions.pod:6192 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 " @@ -15967,7 +16011,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3962 ../src/guestfs-actions.pod:6173 +#: ../fish/guestfish-actions.pod:3983 ../src/guestfs-actions.pod:6198 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 " @@ -15975,14 +16019,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3967 ../src/guestfs-actions.pod:6178 +#: ../fish/guestfish-actions.pod:3988 ../src/guestfs-actions.pod:6203 msgid "" "The mounted filesystem is writable, if we have sufficient permissions on the " "underlying device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3970 +#: ../fish/guestfish-actions.pod:3991 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 " @@ -15992,12 +16036,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3977 +#: ../fish/guestfish-actions.pod:3998 msgid "mount-9p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3979 +#: ../fish/guestfish-actions.pod:4000 #, no-wrap msgid "" " mount-9p mounttag mountpoint [options:..]\n" @@ -16005,14 +16049,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3981 ../src/guestfs-actions.pod:6207 +#: ../fish/guestfish-actions.pod:4002 ../src/guestfs-actions.pod:6232 msgid "" "Mount the virtio-9p filesystem with the tag C<mounttag> on the directory " "C<mountpoint>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3984 ../src/guestfs-actions.pod:6210 +#: ../fish/guestfish-actions.pod:4005 ../src/guestfs-actions.pod:6235 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> " @@ -16020,12 +16064,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3990 +#: ../fish/guestfish-actions.pod:4011 msgid "mount-local" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3992 +#: ../fish/guestfish-actions.pod:4013 #, no-wrap msgid "" " mount-local localmountpoint [readonly:true|false] [options:..] " @@ -16034,7 +16078,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3994 ../src/guestfs-actions.pod:6259 +#: ../fish/guestfish-actions.pod:4015 ../src/guestfs-actions.pod:6284 msgid "" "This call exports the libguestfs-accessible filesystem to a local mountpoint " "(directory) called C<localmountpoint>. Ordinary reads and writes to files " @@ -16042,35 +16086,35 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3999 ../src/guestfs-actions.pod:6264 +#: ../fish/guestfish-actions.pod:4020 ../src/guestfs-actions.pod:6289 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:4002 ../src/guestfs-actions.pod:6267 +#: ../fish/guestfish-actions.pod:4023 ../src/guestfs-actions.pod:6292 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:4005 ../src/guestfs-actions.pod:6270 +#: ../fish/guestfish-actions.pod:4026 ../src/guestfs-actions.pod:6295 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:4009 ../src/guestfs-actions.pod:6274 +#: ../fish/guestfish-actions.pod:4030 ../src/guestfs-actions.pod:6299 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:4012 +#: ../fish/guestfish-actions.pod:4033 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 " @@ -16078,17 +16122,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4016 ../fish/guestfish-actions.pod:4040 ../fish/guestfish-actions.pod:5733 ../src/guestfs-actions.pod:6281 ../src/guestfs-actions.pod:6330 ../src/guestfs-actions.pod:8950 +#: ../fish/guestfish-actions.pod:4037 ../fish/guestfish-actions.pod:4061 ../fish/guestfish-actions.pod:5785 ../src/guestfs-actions.pod:6306 ../src/guestfs-actions.pod:6355 ../src/guestfs-actions.pod:9012 msgid "See L<guestfs(3)/MOUNT LOCAL> for full documentation." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4020 +#: ../fish/guestfish-actions.pod:4041 msgid "mount-local-run" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4022 +#: ../fish/guestfish-actions.pod:4043 #, no-wrap msgid "" " mount-local-run\n" @@ -16096,26 +16140,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4024 ../src/guestfs-actions.pod:6314 +#: ../fish/guestfish-actions.pod:4045 ../src/guestfs-actions.pod:6339 msgid "Run the main loop which translates kernel calls to libguestfs calls." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4027 +#: ../fish/guestfish-actions.pod:4048 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:4031 +#: ../fish/guestfish-actions.pod:4052 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:4035 +#: ../fish/guestfish-actions.pod:4056 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 " @@ -16123,12 +16167,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4042 +#: ../fish/guestfish-actions.pod:4063 msgid "mount-loop" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4044 +#: ../fish/guestfish-actions.pod:4065 #, no-wrap msgid "" " mount-loop file mountpoint\n" @@ -16136,7 +16180,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4046 ../src/guestfs-actions.pod:6343 +#: ../fish/guestfish-actions.pod:4067 ../src/guestfs-actions.pod:6368 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 " @@ -16144,12 +16188,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4050 +#: ../fish/guestfish-actions.pod:4071 msgid "mount-options" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4052 +#: ../fish/guestfish-actions.pod:4073 #, no-wrap msgid "" " mount-options options device mountpoint\n" @@ -16157,26 +16201,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4054 +#: ../fish/guestfish-actions.pod:4075 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:4058 ../src/guestfs-actions.pod:6363 +#: ../fish/guestfish-actions.pod:4079 ../src/guestfs-actions.pod:6388 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:4062 +#: ../fish/guestfish-actions.pod:4083 msgid "mount-ro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4064 +#: ../fish/guestfish-actions.pod:4085 #, no-wrap msgid "" " mount-ro device mountpoint\n" @@ -16184,19 +16228,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4066 +#: ../fish/guestfish-actions.pod:4087 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:4069 +#: ../fish/guestfish-actions.pod:4090 msgid "mount-vfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4071 +#: ../fish/guestfish-actions.pod:4092 #, no-wrap msgid "" " mount-vfs options vfstype device mountpoint\n" @@ -16204,19 +16248,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4073 +#: ../fish/guestfish-actions.pod:4094 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:4077 +#: ../fish/guestfish-actions.pod:4098 msgid "mountpoints" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4079 +#: ../fish/guestfish-actions.pod:4100 #, no-wrap msgid "" " mountpoints\n" @@ -16224,7 +16268,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4081 +#: ../fish/guestfish-actions.pod:4102 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 " @@ -16232,12 +16276,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4085 +#: ../fish/guestfish-actions.pod:4106 msgid "mounts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4087 +#: ../fish/guestfish-actions.pod:4108 #, no-wrap msgid "" " mounts\n" @@ -16245,29 +16289,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4089 ../src/guestfs-actions.pod:6424 +#: ../fish/guestfish-actions.pod:4110 ../src/guestfs-actions.pod:6449 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:4092 ../src/guestfs-actions.pod:6427 +#: ../fish/guestfish-actions.pod:4113 ../src/guestfs-actions.pod:6452 msgid "Some internal mounts are not shown." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4094 +#: ../fish/guestfish-actions.pod:4115 msgid "See also: L</mountpoints>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4096 +#: ../fish/guestfish-actions.pod:4117 msgid "mv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4098 +#: ../fish/guestfish-actions.pod:4119 #, no-wrap msgid "" " mv src dest\n" @@ -16275,19 +16319,47 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4100 ../src/guestfs-actions.pod:6444 +#: ../fish/guestfish-actions.pod:4121 ../src/guestfs-actions.pod:6469 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:4103 +#: ../fish/guestfish-actions.pod:4124 +msgid "nr-devices" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:4126 +#, no-wrap +msgid "" +" nr-devices\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:4128 +msgid "" +"This returns the number of whole block devices that were added. This is the " +"same as the number of devices that would be returned if you called " +"L</list-devices>." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:4132 +msgid "" +"To find out the maximum number of devices that could be added, call " +"L</max-disks>." +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:4135 msgid "ntfs-3g-probe" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4105 +#: ../fish/guestfish-actions.pod:4137 #, no-wrap msgid "" " ntfs-3g-probe true|false device\n" @@ -16295,7 +16367,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4107 ../src/guestfs-actions.pod:6458 +#: ../fish/guestfish-actions.pod:4139 ../src/guestfs-actions.pod:6497 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 " @@ -16303,7 +16375,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4111 ../src/guestfs-actions.pod:6462 +#: ../fish/guestfish-actions.pod:4143 ../src/guestfs-actions.pod:6501 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 " @@ -16311,19 +16383,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4115 ../src/guestfs-actions.pod:6466 +#: ../fish/guestfish-actions.pod:4147 ../src/guestfs-actions.pod:6505 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:4119 +#: ../fish/guestfish-actions.pod:4151 msgid "ntfsclone-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4121 +#: ../fish/guestfish-actions.pod:4153 #, no-wrap msgid "" " ntfsclone-in (backupfile|-) device\n" @@ -16331,19 +16403,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4123 +#: ../fish/guestfish-actions.pod:4155 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:4129 +#: ../fish/guestfish-actions.pod:4161 msgid "ntfsclone-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4131 +#: ../fish/guestfish-actions.pod:4163 #, no-wrap msgid "" " ntfsclone-out device (backupfile|-) [metadataonly:true|false] " @@ -16353,7 +16425,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4133 ../src/guestfs-actions.pod:6508 +#: ../fish/guestfish-actions.pod:4165 ../src/guestfs-actions.pod:6547 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 " @@ -16361,7 +16433,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4137 ../src/guestfs-actions.pod:6512 +#: ../fish/guestfish-actions.pod:4169 ../src/guestfs-actions.pod:6551 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 " @@ -16369,24 +16441,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4141 ../src/guestfs-actions.pod:6516 +#: ../fish/guestfish-actions.pod:4173 ../src/guestfs-actions.pod:6555 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:4145 +#: ../fish/guestfish-actions.pod:4177 msgid "Use L</ntfsclone-in> to restore the file back to a libguestfs device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4152 +#: ../fish/guestfish-actions.pod:4184 msgid "ntfsfix" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4154 +#: ../fish/guestfish-actions.pod:4186 #, no-wrap msgid "" " ntfsfix device [clearbadsectors:true|false]\n" @@ -16394,7 +16466,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4156 ../src/guestfs-actions.pod:6565 +#: ../fish/guestfish-actions.pod:4188 ../src/guestfs-actions.pod:6604 msgid "" "This command repairs some fundamental NTFS inconsistencies, resets the NTFS " "journal file, and schedules an NTFS consistency check for the first boot " @@ -16402,26 +16474,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4160 ../src/guestfs-actions.pod:6569 +#: ../fish/guestfish-actions.pod:4192 ../src/guestfs-actions.pod:6608 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:4163 ../src/guestfs-actions.pod:6572 +#: ../fish/guestfish-actions.pod:4195 ../src/guestfs-actions.pod:6611 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:4168 +#: ../fish/guestfish-actions.pod:4200 msgid "ntfsresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4170 +#: ../fish/guestfish-actions.pod:4202 #, no-wrap msgid "" " ntfsresize device\n" @@ -16429,14 +16501,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4172 ../fish/guestfish-actions.pod:4196 ../src/guestfs-actions.pod:6614 ../src/guestfs-actions.pod:6646 +#: ../fish/guestfish-actions.pod:4204 ../fish/guestfish-actions.pod:4228 ../src/guestfs-actions.pod:6653 ../src/guestfs-actions.pod:6685 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:4175 ../src/guestfs-actions.pod:6617 +#: ../fish/guestfish-actions.pod:4207 ../src/guestfs-actions.pod:6656 msgid "" "I<Note:> After the resize operation, the filesystem is marked as requiring a " "consistency check (for safety). You have to boot into Windows to perform " @@ -16447,24 +16519,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4183 ../fish/guestfish-actions.pod:4222 ../src/guestfs-actions.pod:6625 ../src/guestfs-actions.pod:6672 +#: ../fish/guestfish-actions.pod:4215 ../fish/guestfish-actions.pod:4254 ../src/guestfs-actions.pod:6664 ../src/guestfs-actions.pod:6711 msgid "See also L<ntfsresize(8)>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4185 ../fish/guestfish-actions.pod:4233 +#: ../fish/guestfish-actions.pod:4217 ../fish/guestfish-actions.pod:4265 msgid "" "I<This function is deprecated.> In new code, use the L</ntfsresize_opts> " "call instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4192 +#: ../fish/guestfish-actions.pod:4224 msgid "ntfsresize-opts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4194 +#: ../fish/guestfish-actions.pod:4226 #, no-wrap msgid "" " ntfsresize-opts device [size:N] [force:true|false]\n" @@ -16472,26 +16544,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4205 ../src/guestfs-actions.pod:6655 +#: ../fish/guestfish-actions.pod:4237 ../src/guestfs-actions.pod:6694 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:4208 ../fish/guestfish-actions.pod:5587 ../src/guestfs-actions.pod:6658 ../src/guestfs-actions.pod:8738 +#: ../fish/guestfish-actions.pod:4240 ../fish/guestfish-actions.pod:5639 ../src/guestfs-actions.pod:6697 ../src/guestfs-actions.pod:8800 msgid "C<force>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4210 ../src/guestfs-actions.pod:6660 +#: ../fish/guestfish-actions.pod:4242 ../src/guestfs-actions.pod:6699 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:4213 +#: ../fish/guestfish-actions.pod:4245 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 " @@ -16501,12 +16573,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4226 +#: ../fish/guestfish-actions.pod:4258 msgid "ntfsresize-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4228 +#: ../fish/guestfish-actions.pod:4260 #, no-wrap msgid "" " ntfsresize-size device size\n" @@ -16514,19 +16586,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4230 +#: ../fish/guestfish-actions.pod:4262 msgid "" "This command is the same as L</ntfsresize> except that it allows you to " "specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4240 +#: ../fish/guestfish-actions.pod:4272 msgid "part-add" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4242 +#: ../fish/guestfish-actions.pod:4274 #, no-wrap msgid "" " part-add device prlogex startsect endsect\n" @@ -16534,14 +16606,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4244 +#: ../fish/guestfish-actions.pod:4276 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:4247 ../src/guestfs-actions.pod:6733 +#: ../fish/guestfish-actions.pod:4279 ../src/guestfs-actions.pod:6772 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 " @@ -16549,7 +16621,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4252 ../src/guestfs-actions.pod:6738 +#: ../fish/guestfish-actions.pod:4284 ../src/guestfs-actions.pod:6777 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 " @@ -16557,19 +16629,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4256 +#: ../fish/guestfish-actions.pod:4288 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:4259 +#: ../fish/guestfish-actions.pod:4291 msgid "part-del" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4261 +#: ../fish/guestfish-actions.pod:4293 #, no-wrap msgid "" " part-del device partnum\n" @@ -16577,24 +16649,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4263 ../src/guestfs-actions.pod:6756 +#: ../fish/guestfish-actions.pod:4295 ../src/guestfs-actions.pod:6795 msgid "This command deletes the partition numbered C<partnum> on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4265 ../src/guestfs-actions.pod:6758 +#: ../fish/guestfish-actions.pod:4297 ../src/guestfs-actions.pod:6797 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:4269 +#: ../fish/guestfish-actions.pod:4301 msgid "part-disk" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4271 +#: ../fish/guestfish-actions.pod:4303 #, no-wrap msgid "" " part-disk device parttype\n" @@ -16602,26 +16674,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4273 +#: ../fish/guestfish-actions.pod:4305 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:4277 +#: ../fish/guestfish-actions.pod:4309 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:4280 +#: ../fish/guestfish-actions.pod:4312 msgid "part-get-bootable" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4282 +#: ../fish/guestfish-actions.pod:4314 #, no-wrap msgid "" " part-get-bootable device partnum\n" @@ -16629,24 +16701,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4284 ../src/guestfs-actions.pod:6791 +#: ../fish/guestfish-actions.pod:4316 ../src/guestfs-actions.pod:6830 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:4287 +#: ../fish/guestfish-actions.pod:4319 msgid "See also L</part-set-bootable>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4289 +#: ../fish/guestfish-actions.pod:4321 msgid "part-get-mbr-id" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4291 +#: ../fish/guestfish-actions.pod:4323 #, no-wrap msgid "" " part-get-mbr-id device partnum\n" @@ -16654,14 +16726,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4293 ../src/guestfs-actions.pod:6807 +#: ../fish/guestfish-actions.pod:4325 ../src/guestfs-actions.pod:6846 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:4296 ../fish/guestfish-actions.pod:4440 +#: ../fish/guestfish-actions.pod:4328 ../fish/guestfish-actions.pod:4472 msgid "" "Note that only MBR (old DOS-style) partitions have type bytes. You will get " "undefined results for other partition table types (see " @@ -16669,12 +16741,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4300 +#: ../fish/guestfish-actions.pod:4332 msgid "part-get-parttype" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4302 +#: ../fish/guestfish-actions.pod:4334 #, no-wrap msgid "" " part-get-parttype device\n" @@ -16682,14 +16754,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4304 ../src/guestfs-actions.pod:6824 +#: ../fish/guestfish-actions.pod:4336 ../src/guestfs-actions.pod:6863 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:4307 +#: ../fish/guestfish-actions.pod:4339 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 " @@ -16697,12 +16769,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4312 +#: ../fish/guestfish-actions.pod:4344 msgid "part-init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4314 +#: ../fish/guestfish-actions.pod:4346 #, no-wrap msgid "" " part-init device parttype\n" @@ -16710,7 +16782,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4316 ../src/guestfs-actions.pod:6844 +#: ../fish/guestfish-actions.pod:4348 ../src/guestfs-actions.pod:6883 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> " @@ -16718,34 +16790,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4320 +#: ../fish/guestfish-actions.pod:4352 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:4323 ../src/guestfs-actions.pod:6851 +#: ../fish/guestfish-actions.pod:4355 ../src/guestfs-actions.pod:6890 msgid "Possible values for C<parttype> are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4327 ../src/guestfs-actions.pod:6855 +#: ../fish/guestfish-actions.pod:4359 ../src/guestfs-actions.pod:6894 msgid "B<efi>" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4329 ../src/guestfs-actions.pod:6857 +#: ../fish/guestfish-actions.pod:4361 ../src/guestfs-actions.pod:6896 msgid "B<gpt>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4331 ../src/guestfs-actions.pod:6859 +#: ../fish/guestfish-actions.pod:4363 ../src/guestfs-actions.pod:6898 msgid "Intel EFI / GPT partition table." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4333 ../src/guestfs-actions.pod:6861 +#: ../fish/guestfish-actions.pod:4365 ../src/guestfs-actions.pod:6900 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 " @@ -16753,17 +16825,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4337 ../src/guestfs-actions.pod:6865 +#: ../fish/guestfish-actions.pod:4369 ../src/guestfs-actions.pod:6904 msgid "B<mbr>" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4339 ../src/guestfs-actions.pod:6867 +#: ../fish/guestfish-actions.pod:4371 ../src/guestfs-actions.pod:6906 msgid "B<msdos>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4341 ../src/guestfs-actions.pod:6869 +#: ../fish/guestfish-actions.pod:4373 ../src/guestfs-actions.pod:6908 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 " @@ -16771,102 +16843,102 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4348 ../src/guestfs-actions.pod:6876 +#: ../fish/guestfish-actions.pod:4380 ../src/guestfs-actions.pod:6915 msgid "Other partition table types that may work but are not supported include:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4353 ../src/guestfs-actions.pod:6881 +#: ../fish/guestfish-actions.pod:4385 ../src/guestfs-actions.pod:6920 msgid "B<aix>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4355 ../src/guestfs-actions.pod:6883 +#: ../fish/guestfish-actions.pod:4387 ../src/guestfs-actions.pod:6922 msgid "AIX disk labels." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4357 ../src/guestfs-actions.pod:6885 +#: ../fish/guestfish-actions.pod:4389 ../src/guestfs-actions.pod:6924 msgid "B<amiga>" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4359 ../src/guestfs-actions.pod:6887 +#: ../fish/guestfish-actions.pod:4391 ../src/guestfs-actions.pod:6926 msgid "B<rdb>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4361 ../src/guestfs-actions.pod:6889 +#: ../fish/guestfish-actions.pod:4393 ../src/guestfs-actions.pod:6928 msgid "Amiga \"Rigid Disk Block\" format." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4363 ../src/guestfs-actions.pod:6891 +#: ../fish/guestfish-actions.pod:4395 ../src/guestfs-actions.pod:6930 msgid "B<bsd>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4365 ../src/guestfs-actions.pod:6893 +#: ../fish/guestfish-actions.pod:4397 ../src/guestfs-actions.pod:6932 msgid "BSD disk labels." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4367 ../src/guestfs-actions.pod:6895 +#: ../fish/guestfish-actions.pod:4399 ../src/guestfs-actions.pod:6934 msgid "B<dasd>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4369 ../src/guestfs-actions.pod:6897 +#: ../fish/guestfish-actions.pod:4401 ../src/guestfs-actions.pod:6936 msgid "DASD, used on IBM mainframes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4371 ../src/guestfs-actions.pod:6899 +#: ../fish/guestfish-actions.pod:4403 ../src/guestfs-actions.pod:6938 msgid "B<dvh>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4373 ../src/guestfs-actions.pod:6901 +#: ../fish/guestfish-actions.pod:4405 ../src/guestfs-actions.pod:6940 msgid "MIPS/SGI volumes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4375 ../src/guestfs-actions.pod:6903 +#: ../fish/guestfish-actions.pod:4407 ../src/guestfs-actions.pod:6942 msgid "B<mac>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4377 ../src/guestfs-actions.pod:6905 +#: ../fish/guestfish-actions.pod:4409 ../src/guestfs-actions.pod:6944 msgid "Old Mac partition format. Modern Macs use C<gpt>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4379 ../src/guestfs-actions.pod:6907 +#: ../fish/guestfish-actions.pod:4411 ../src/guestfs-actions.pod:6946 msgid "B<pc98>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4381 ../src/guestfs-actions.pod:6909 +#: ../fish/guestfish-actions.pod:4413 ../src/guestfs-actions.pod:6948 msgid "NEC PC-98 format, common in Japan apparently." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4383 ../src/guestfs-actions.pod:6911 +#: ../fish/guestfish-actions.pod:4415 ../src/guestfs-actions.pod:6950 msgid "B<sun>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4385 ../src/guestfs-actions.pod:6913 +#: ../fish/guestfish-actions.pod:4417 ../src/guestfs-actions.pod:6952 msgid "Sun disk labels." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4389 +#: ../fish/guestfish-actions.pod:4421 msgid "part-list" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4391 +#: ../fish/guestfish-actions.pod:4423 #, no-wrap msgid "" " part-list device\n" @@ -16874,66 +16946,66 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4393 ../src/guestfs-actions.pod:6927 +#: ../fish/guestfish-actions.pod:4425 ../src/guestfs-actions.pod:6966 msgid "" "This command parses the partition table on C<device> and returns the list of " "partitions found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4396 ../src/guestfs-actions.pod:6930 +#: ../fish/guestfish-actions.pod:4428 ../src/guestfs-actions.pod:6969 msgid "The fields in the returned structure are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4400 ../src/guestfs-actions.pod:6934 +#: ../fish/guestfish-actions.pod:4432 ../src/guestfs-actions.pod:6973 msgid "B<part_num>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4402 ../src/guestfs-actions.pod:6936 +#: ../fish/guestfish-actions.pod:4434 ../src/guestfs-actions.pod:6975 msgid "Partition number, counting from 1." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4404 ../src/guestfs-actions.pod:6938 +#: ../fish/guestfish-actions.pod:4436 ../src/guestfs-actions.pod:6977 msgid "B<part_start>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4406 +#: ../fish/guestfish-actions.pod:4438 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:4409 ../src/guestfs-actions.pod:6943 +#: ../fish/guestfish-actions.pod:4441 ../src/guestfs-actions.pod:6982 msgid "B<part_end>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4411 ../src/guestfs-actions.pod:6945 +#: ../fish/guestfish-actions.pod:4443 ../src/guestfs-actions.pod:6984 msgid "End of the partition in bytes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4413 ../src/guestfs-actions.pod:6947 +#: ../fish/guestfish-actions.pod:4445 ../src/guestfs-actions.pod:6986 msgid "B<part_size>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4415 ../src/guestfs-actions.pod:6949 +#: ../fish/guestfish-actions.pod:4447 ../src/guestfs-actions.pod:6988 msgid "Size of the partition in bytes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4419 +#: ../fish/guestfish-actions.pod:4451 msgid "part-set-bootable" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4421 +#: ../fish/guestfish-actions.pod:4453 #, no-wrap msgid "" " part-set-bootable device partnum true|false\n" @@ -16941,14 +17013,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4423 ../src/guestfs-actions.pod:6967 +#: ../fish/guestfish-actions.pod:4455 ../src/guestfs-actions.pod:7006 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:4426 ../src/guestfs-actions.pod:6970 +#: ../fish/guestfish-actions.pod:4458 ../src/guestfs-actions.pod:7009 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 " @@ -16956,12 +17028,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4430 +#: ../fish/guestfish-actions.pod:4462 msgid "part-set-mbr-id" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4432 +#: ../fish/guestfish-actions.pod:4464 #, no-wrap msgid "" " part-set-mbr-id device partnum idbyte\n" @@ -16969,7 +17041,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4434 ../src/guestfs-actions.pod:6986 +#: ../fish/guestfish-actions.pod:4466 ../src/guestfs-actions.pod:7025 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 " @@ -16978,12 +17050,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4444 +#: ../fish/guestfish-actions.pod:4476 msgid "part-set-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4446 +#: ../fish/guestfish-actions.pod:4478 #, no-wrap msgid "" " part-set-name device partnum name\n" @@ -16991,26 +17063,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4448 ../src/guestfs-actions.pod:7008 +#: ../fish/guestfish-actions.pod:4480 ../src/guestfs-actions.pod:7047 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:4451 ../src/guestfs-actions.pod:7011 +#: ../fish/guestfish-actions.pod:4483 ../src/guestfs-actions.pod:7050 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:4454 +#: ../fish/guestfish-actions.pod:4486 msgid "part-to-dev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4456 +#: ../fish/guestfish-actions.pod:4488 #, no-wrap msgid "" " part-to-dev partition\n" @@ -17018,31 +17090,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4458 ../src/guestfs-actions.pod:7024 +#: ../fish/guestfish-actions.pod:4490 ../src/guestfs-actions.pod:7063 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:4462 ../fish/guestfish-actions.pod:4474 +#: ../fish/guestfish-actions.pod:4494 ../fish/guestfish-actions.pod:4506 msgid "" "The named partition must exist, for example as a string returned from " "L</list-partitions>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4465 -msgid "See also L</part-to-partnum>." +#: ../fish/guestfish-actions.pod:4497 +msgid "See also L</part-to-partnum>, L</device-index>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4467 +#: ../fish/guestfish-actions.pod:4499 msgid "part-to-partnum" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4469 +#: ../fish/guestfish-actions.pod:4501 #, no-wrap msgid "" " part-to-partnum partition\n" @@ -17050,24 +17122,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4471 ../src/guestfs-actions.pod:7044 +#: ../fish/guestfish-actions.pod:4503 ../src/guestfs-actions.pod:7083 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:4477 +#: ../fish/guestfish-actions.pod:4509 msgid "See also L</part-to-dev>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4479 +#: ../fish/guestfish-actions.pod:4511 msgid "ping-daemon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4481 +#: ../fish/guestfish-actions.pod:4513 #, no-wrap msgid "" " ping-daemon\n" @@ -17075,7 +17147,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4483 ../src/guestfs-actions.pod:7061 +#: ../fish/guestfish-actions.pod:4515 ../src/guestfs-actions.pod:7100 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 " @@ -17084,12 +17156,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4488 +#: ../fish/guestfish-actions.pod:4520 msgid "pread" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4490 +#: ../fish/guestfish-actions.pod:4522 #, no-wrap msgid "" " pread path count offset\n" @@ -17097,31 +17169,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4492 ../src/guestfs-actions.pod:7079 +#: ../fish/guestfish-actions.pod:4524 ../src/guestfs-actions.pod:7118 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:4495 ../fish/guestfish-actions.pod:4510 ../src/guestfs-actions.pod:7082 ../src/guestfs-actions.pod:7108 +#: ../fish/guestfish-actions.pod:4527 ../fish/guestfish-actions.pod:4542 ../src/guestfs-actions.pod:7121 ../src/guestfs-actions.pod:7147 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:4498 +#: ../fish/guestfish-actions.pod:4530 msgid "See also L</pwrite>, L</pread-device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4503 +#: ../fish/guestfish-actions.pod:4535 msgid "pread-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4505 +#: ../fish/guestfish-actions.pod:4537 #, no-wrap msgid "" " pread-device device count offset\n" @@ -17129,24 +17201,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4507 ../src/guestfs-actions.pod:7105 +#: ../fish/guestfish-actions.pod:4539 ../src/guestfs-actions.pod:7144 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:4513 +#: ../fish/guestfish-actions.pod:4545 msgid "See also L</pread>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4518 +#: ../fish/guestfish-actions.pod:4550 msgid "pvcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4520 +#: ../fish/guestfish-actions.pod:4552 #, no-wrap msgid "" " pvcreate device\n" @@ -17154,19 +17226,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4522 ../src/guestfs-actions.pod:7128 +#: ../fish/guestfish-actions.pod:4554 ../src/guestfs-actions.pod:7167 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:4526 +#: ../fish/guestfish-actions.pod:4558 msgid "pvremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4528 +#: ../fish/guestfish-actions.pod:4560 #, no-wrap msgid "" " pvremove device\n" @@ -17174,14 +17246,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4530 ../src/guestfs-actions.pod:7142 +#: ../fish/guestfish-actions.pod:4562 ../src/guestfs-actions.pod:7181 msgid "" "This wipes a physical volume C<device> so that LVM will no longer recognise " "it." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4533 ../src/guestfs-actions.pod:7145 +#: ../fish/guestfish-actions.pod:4565 ../src/guestfs-actions.pod:7184 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 " @@ -17189,12 +17261,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4537 +#: ../fish/guestfish-actions.pod:4569 msgid "pvresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4539 +#: ../fish/guestfish-actions.pod:4571 #, no-wrap msgid "" " pvresize device\n" @@ -17202,19 +17274,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4541 ../src/guestfs-actions.pod:7159 +#: ../fish/guestfish-actions.pod:4573 ../src/guestfs-actions.pod:7198 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:4544 +#: ../fish/guestfish-actions.pod:4576 msgid "pvresize-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4546 +#: ../fish/guestfish-actions.pod:4578 #, no-wrap msgid "" " pvresize-size device size\n" @@ -17222,19 +17294,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4548 +#: ../fish/guestfish-actions.pod:4580 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:4551 +#: ../fish/guestfish-actions.pod:4583 msgid "pvs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4553 +#: ../fish/guestfish-actions.pod:4585 #, no-wrap msgid "" " pvs\n" @@ -17242,31 +17314,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4555 ../src/guestfs-actions.pod:7185 +#: ../fish/guestfish-actions.pod:4587 ../src/guestfs-actions.pod:7224 msgid "" "List all the physical volumes detected. This is the equivalent of the " "L<pvs(8)> command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4558 ../src/guestfs-actions.pod:7188 +#: ../fish/guestfish-actions.pod:4590 ../src/guestfs-actions.pod:7227 msgid "" "This returns a list of just the device names that contain PVs " "(eg. C</dev/sda2>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4561 +#: ../fish/guestfish-actions.pod:4593 msgid "See also L</pvs-full>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4563 +#: ../fish/guestfish-actions.pod:4595 msgid "pvs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4565 +#: ../fish/guestfish-actions.pod:4597 #, no-wrap msgid "" " pvs-full\n" @@ -17274,19 +17346,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4567 ../src/guestfs-actions.pod:7204 +#: ../fish/guestfish-actions.pod:4599 ../src/guestfs-actions.pod:7243 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:4570 +#: ../fish/guestfish-actions.pod:4602 msgid "pvuuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4572 +#: ../fish/guestfish-actions.pod:4604 #, no-wrap msgid "" " pvuuid device\n" @@ -17294,17 +17366,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4574 ../src/guestfs-actions.pod:7219 +#: ../fish/guestfish-actions.pod:4606 ../src/guestfs-actions.pod:7258 msgid "This command returns the UUID of the LVM PV C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4576 +#: ../fish/guestfish-actions.pod:4608 msgid "pwrite" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4578 +#: ../fish/guestfish-actions.pod:4610 #, no-wrap msgid "" " pwrite path content offset\n" @@ -17312,14 +17384,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4580 ../src/guestfs-actions.pod:7235 +#: ../fish/guestfish-actions.pod:4612 ../src/guestfs-actions.pod:7274 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:4583 ../src/guestfs-actions.pod:7238 +#: ../fish/guestfish-actions.pod:4615 ../src/guestfs-actions.pod:7277 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 " @@ -17329,17 +17401,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4589 +#: ../fish/guestfish-actions.pod:4621 msgid "See also L</pread>, L</pwrite-device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4594 +#: ../fish/guestfish-actions.pod:4626 msgid "pwrite-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4596 +#: ../fish/guestfish-actions.pod:4628 #, no-wrap msgid "" " pwrite-device device content offset\n" @@ -17347,14 +17419,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4598 ../src/guestfs-actions.pod:7262 +#: ../fish/guestfish-actions.pod:4630 ../src/guestfs-actions.pod:7301 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:4601 ../src/guestfs-actions.pod:7265 +#: ../fish/guestfish-actions.pod:4633 ../src/guestfs-actions.pod:7304 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 " @@ -17362,17 +17434,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4606 +#: ../fish/guestfish-actions.pod:4638 msgid "See also L</pwrite>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4611 +#: ../fish/guestfish-actions.pod:4643 msgid "read-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4613 +#: ../fish/guestfish-actions.pod:4645 #, no-wrap msgid "" " read-file path\n" @@ -17380,12 +17452,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4615 ../src/guestfs-actions.pod:7286 +#: ../fish/guestfish-actions.pod:4647 ../src/guestfs-actions.pod:7325 msgid "This calls returns the contents of the file C<path> as a buffer." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4618 +#: ../fish/guestfish-actions.pod:4650 msgid "" "Unlike L</cat>, this function can correctly handle files that contain " "embedded ASCII NUL characters. However unlike L</download>, this function " @@ -17393,12 +17465,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4626 +#: ../fish/guestfish-actions.pod:4658 msgid "read-lines" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4628 +#: ../fish/guestfish-actions.pod:4660 #, no-wrap msgid "" " read-lines path\n" @@ -17406,14 +17478,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4632 ../src/guestfs-actions.pod:7311 +#: ../fish/guestfish-actions.pod:4664 ../src/guestfs-actions.pod:7350 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:4635 +#: ../fish/guestfish-actions.pod:4667 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of line). For " @@ -17422,12 +17494,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4640 +#: ../fish/guestfish-actions.pod:4672 msgid "readdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4642 +#: ../fish/guestfish-actions.pod:4674 #, no-wrap msgid "" " readdir dir\n" @@ -17435,12 +17507,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4644 ../src/guestfs-actions.pod:7331 +#: ../fish/guestfish-actions.pod:4676 ../src/guestfs-actions.pod:7370 msgid "This returns the list of directory entries in directory C<dir>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4646 ../src/guestfs-actions.pod:7333 +#: ../fish/guestfish-actions.pod:4678 ../src/guestfs-actions.pod:7372 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 " @@ -17448,84 +17520,84 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4650 ../src/guestfs-actions.pod:7337 +#: ../fish/guestfish-actions.pod:4682 ../src/guestfs-actions.pod:7376 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:4655 ../src/guestfs-actions.pod:7342 +#: ../fish/guestfish-actions.pod:4687 ../src/guestfs-actions.pod:7381 msgid "'b'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4657 ../src/guestfs-actions.pod:7344 +#: ../fish/guestfish-actions.pod:4689 ../src/guestfs-actions.pod:7383 msgid "Block special" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4661 ../src/guestfs-actions.pod:7348 +#: ../fish/guestfish-actions.pod:4693 ../src/guestfs-actions.pod:7387 msgid "Char special" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4665 ../src/guestfs-actions.pod:7352 +#: ../fish/guestfish-actions.pod:4697 ../src/guestfs-actions.pod:7391 msgid "Directory" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4667 ../src/guestfs-actions.pod:7354 +#: ../fish/guestfish-actions.pod:4699 ../src/guestfs-actions.pod:7393 msgid "'f'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4669 ../src/guestfs-actions.pod:7356 +#: ../fish/guestfish-actions.pod:4701 ../src/guestfs-actions.pod:7395 msgid "FIFO (named pipe)" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4671 ../src/guestfs-actions.pod:7358 +#: ../fish/guestfish-actions.pod:4703 ../src/guestfs-actions.pod:7397 msgid "'l'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4673 ../src/guestfs-actions.pod:7360 +#: ../fish/guestfish-actions.pod:4705 ../src/guestfs-actions.pod:7399 msgid "Symbolic link" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4675 ../src/guestfs-actions.pod:7362 +#: ../fish/guestfish-actions.pod:4707 ../src/guestfs-actions.pod:7401 msgid "'r'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4677 ../src/guestfs-actions.pod:7364 +#: ../fish/guestfish-actions.pod:4709 ../src/guestfs-actions.pod:7403 msgid "Regular file" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4681 ../src/guestfs-actions.pod:7368 +#: ../fish/guestfish-actions.pod:4713 ../src/guestfs-actions.pod:7407 msgid "Socket" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4685 ../src/guestfs-actions.pod:7372 +#: ../fish/guestfish-actions.pod:4717 ../src/guestfs-actions.pod:7411 msgid "Unknown file type" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4687 ../src/guestfs-actions.pod:7374 +#: ../fish/guestfish-actions.pod:4719 ../src/guestfs-actions.pod:7413 msgid "'?'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4689 ../src/guestfs-actions.pod:7376 +#: ../fish/guestfish-actions.pod:4721 ../src/guestfs-actions.pod:7415 msgid "The L<readdir(3)> call returned a C<d_type> field with an unexpected value" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4694 +#: ../fish/guestfish-actions.pod:4726 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 " @@ -17533,12 +17605,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4698 +#: ../fish/guestfish-actions.pod:4730 msgid "readlink" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4700 +#: ../fish/guestfish-actions.pod:4732 #, no-wrap msgid "" " readlink path\n" @@ -17546,17 +17618,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4702 ../src/guestfs-actions.pod:7397 +#: ../fish/guestfish-actions.pod:4734 ../src/guestfs-actions.pod:7436 msgid "This command reads the target of a symbolic link." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4704 +#: ../fish/guestfish-actions.pod:4736 msgid "readlinklist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4706 +#: ../fish/guestfish-actions.pod:4738 #, no-wrap msgid "" " readlinklist path 'names ...'\n" @@ -17564,7 +17636,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4708 ../src/guestfs-actions.pod:7411 +#: ../fish/guestfish-actions.pod:4740 ../src/guestfs-actions.pod:7450 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 " @@ -17572,14 +17644,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4712 ../src/guestfs-actions.pod:7415 +#: ../fish/guestfish-actions.pod:4744 ../src/guestfs-actions.pod:7454 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:4716 ../src/guestfs-actions.pod:7419 +#: ../fish/guestfish-actions.pod:4748 ../src/guestfs-actions.pod:7458 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 " @@ -17589,7 +17661,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4723 ../src/guestfs-actions.pod:7426 +#: ../fish/guestfish-actions.pod:4755 ../src/guestfs-actions.pod:7465 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. Very long directory listings " @@ -17598,12 +17670,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4730 +#: ../fish/guestfish-actions.pod:4762 msgid "realpath" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4732 +#: ../fish/guestfish-actions.pod:4764 #, no-wrap msgid "" " realpath path\n" @@ -17611,19 +17683,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4734 ../src/guestfs-actions.pod:7445 +#: ../fish/guestfish-actions.pod:4766 ../src/guestfs-actions.pod:7484 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:4737 +#: ../fish/guestfish-actions.pod:4769 msgid "removexattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4739 +#: ../fish/guestfish-actions.pod:4771 #, no-wrap msgid "" " removexattr xattr path\n" @@ -17631,22 +17703,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4741 ../src/guestfs-actions.pod:7460 +#: ../fish/guestfish-actions.pod:4773 ../src/guestfs-actions.pod:7499 msgid "This call removes the extended attribute named C<xattr> of the file C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4744 +#: ../fish/guestfish-actions.pod:4776 msgid "See also: L</lremovexattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4746 +#: ../fish/guestfish-actions.pod:4778 msgid "resize2fs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4748 +#: ../fish/guestfish-actions.pod:4780 #, no-wrap msgid "" " resize2fs device\n" @@ -17654,24 +17726,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4750 ../src/guestfs-actions.pod:7475 +#: ../fish/guestfish-actions.pod:4782 ../src/guestfs-actions.pod:7514 msgid "" "This resizes an ext2, ext3 or ext4 filesystem to match the size of the " "underlying device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4753 ../fish/guestfish-actions.pod:4768 ../fish/guestfish-actions.pod:4777 ../src/guestfs-actions.pod:7478 ../src/guestfs-actions.pod:7499 ../src/guestfs-actions.pod:7515 +#: ../fish/guestfish-actions.pod:4785 ../fish/guestfish-actions.pod:4800 ../fish/guestfish-actions.pod:4809 ../src/guestfs-actions.pod:7517 ../src/guestfs-actions.pod:7538 ../src/guestfs-actions.pod:7554 msgid "See also L<guestfs(3)/RESIZE2FS ERRORS>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4755 +#: ../fish/guestfish-actions.pod:4787 msgid "resize2fs-M" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4757 +#: ../fish/guestfish-actions.pod:4789 #, no-wrap msgid "" " resize2fs-M device\n" @@ -17679,7 +17751,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4759 +#: ../fish/guestfish-actions.pod:4791 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> " @@ -17687,7 +17759,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4763 +#: ../fish/guestfish-actions.pod:4795 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, " @@ -17696,12 +17768,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4770 +#: ../fish/guestfish-actions.pod:4802 msgid "resize2fs-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4772 +#: ../fish/guestfish-actions.pod:4804 #, no-wrap msgid "" " resize2fs-size device size\n" @@ -17709,19 +17781,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4774 +#: ../fish/guestfish-actions.pod:4806 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:4779 +#: ../fish/guestfish-actions.pod:4811 msgid "rm" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4781 +#: ../fish/guestfish-actions.pod:4813 #, no-wrap msgid "" " rm path\n" @@ -17729,17 +17801,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4783 ../src/guestfs-actions.pod:7527 +#: ../fish/guestfish-actions.pod:4815 ../src/guestfs-actions.pod:7566 msgid "Remove the single file C<path>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4785 +#: ../fish/guestfish-actions.pod:4817 msgid "rm-rf" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4787 +#: ../fish/guestfish-actions.pod:4819 #, no-wrap msgid "" " rm-rf path\n" @@ -17747,19 +17819,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4789 ../src/guestfs-actions.pod:7539 +#: ../fish/guestfish-actions.pod:4821 ../src/guestfs-actions.pod:7578 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:4793 +#: ../fish/guestfish-actions.pod:4825 msgid "rmdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4795 +#: ../fish/guestfish-actions.pod:4827 #, no-wrap msgid "" " rmdir path\n" @@ -17767,17 +17839,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4797 ../src/guestfs-actions.pod:7553 +#: ../fish/guestfish-actions.pod:4829 ../src/guestfs-actions.pod:7592 msgid "Remove the single directory C<path>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4799 +#: ../fish/guestfish-actions.pod:4831 msgid "rmmountpoint" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4801 +#: ../fish/guestfish-actions.pod:4833 #, no-wrap msgid "" " rmmountpoint exemptpath\n" @@ -17785,19 +17857,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4803 +#: ../fish/guestfish-actions.pod:4835 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:4807 +#: ../fish/guestfish-actions.pod:4839 msgid "scrub-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4809 +#: ../fish/guestfish-actions.pod:4841 #, no-wrap msgid "" " scrub-device device\n" @@ -17805,26 +17877,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4811 ../src/guestfs-actions.pod:7579 +#: ../fish/guestfish-actions.pod:4843 ../src/guestfs-actions.pod:7618 msgid "" "This command writes patterns over C<device> to make data retrieval more " "difficult." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4814 ../fish/guestfish-actions.pod:4826 ../fish/guestfish-actions.pod:4839 ../src/guestfs-actions.pod:7582 ../src/guestfs-actions.pod:7600 ../src/guestfs-actions.pod:7619 +#: ../fish/guestfish-actions.pod:4846 ../fish/guestfish-actions.pod:4858 ../fish/guestfish-actions.pod:4871 ../src/guestfs-actions.pod:7621 ../src/guestfs-actions.pod:7639 ../src/guestfs-actions.pod:7658 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:4817 +#: ../fish/guestfish-actions.pod:4849 msgid "scrub-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4819 +#: ../fish/guestfish-actions.pod:4851 #, no-wrap msgid "" " scrub-file file\n" @@ -17832,24 +17904,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4821 ../src/guestfs-actions.pod:7595 +#: ../fish/guestfish-actions.pod:4853 ../src/guestfs-actions.pod:7634 msgid "" "This command writes patterns over a file to make data retrieval more " "difficult." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4824 ../src/guestfs-actions.pod:7598 +#: ../fish/guestfish-actions.pod:4856 ../src/guestfs-actions.pod:7637 msgid "The file is I<removed> after scrubbing." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4829 +#: ../fish/guestfish-actions.pod:4861 msgid "scrub-freespace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4831 +#: ../fish/guestfish-actions.pod:4863 #, no-wrap msgid "" " scrub-freespace dir\n" @@ -17857,7 +17929,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4833 +#: ../fish/guestfish-actions.pod:4865 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 " @@ -17866,17 +17938,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4842 +#: ../fish/guestfish-actions.pod:4874 msgid "set-append" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4844 +#: ../fish/guestfish-actions.pod:4876 msgid "append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4846 +#: ../fish/guestfish-actions.pod:4878 #, no-wrap msgid "" " set-append append\n" @@ -17884,38 +17956,38 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4848 ../src/guestfs-actions.pod:7632 +#: ../fish/guestfish-actions.pod:4880 ../src/guestfs-actions.pod:7671 msgid "" "This function is used to add additional options to the guest kernel command " "line." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4851 ../src/guestfs-actions.pod:7635 +#: ../fish/guestfish-actions.pod:4883 ../src/guestfs-actions.pod:7674 msgid "" "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> " "environment variable." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4854 ../src/guestfs-actions.pod:7638 +#: ../fish/guestfish-actions.pod:4886 ../src/guestfs-actions.pod:7677 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:4857 +#: ../fish/guestfish-actions.pod:4889 msgid "set-attach-method" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4859 +#: ../fish/guestfish-actions.pod:4891 msgid "attach-method" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4861 +#: ../fish/guestfish-actions.pod:4893 #, no-wrap msgid "" " set-attach-method attachmethod\n" @@ -17923,36 +17995,36 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4863 ../src/guestfs-actions.pod:7651 +#: ../fish/guestfish-actions.pod:4895 ../src/guestfs-actions.pod:7690 msgid "" "Set the method that libguestfs uses to connect to the back end guestfsd " "daemon. Possible methods are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4868 ../src/guestfs-actions.pod:7656 ../src/guestfs.pod:2984 +#: ../fish/guestfish-actions.pod:4900 ../src/guestfs-actions.pod:7695 ../src/guestfs.pod:3007 msgid "C<appliance>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4870 ../src/guestfs-actions.pod:7658 +#: ../fish/guestfish-actions.pod:4902 ../src/guestfs-actions.pod:7697 msgid "" "Launch an appliance and connect to it. This is the ordinary method and the " "default." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4873 ../src/guestfs-actions.pod:7661 +#: ../fish/guestfish-actions.pod:4905 ../src/guestfs-actions.pod:7700 msgid "C<unix:I<path>>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4875 ../src/guestfs-actions.pod:7663 +#: ../fish/guestfish-actions.pod:4907 ../src/guestfs-actions.pod:7702 msgid "Connect to the Unix domain socket I<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4877 ../src/guestfs-actions.pod:7665 +#: ../fish/guestfish-actions.pod:4909 ../src/guestfs-actions.pod:7704 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 " @@ -17960,17 +18032,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4883 +#: ../fish/guestfish-actions.pod:4915 msgid "set-autosync" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4885 +#: ../fish/guestfish-actions.pod:4917 msgid "autosync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4887 +#: ../fish/guestfish-actions.pod:4919 #, no-wrap msgid "" " set-autosync true|false\n" @@ -17978,7 +18050,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4889 ../src/guestfs-actions.pod:7681 +#: ../fish/guestfish-actions.pod:4921 ../src/guestfs-actions.pod:7720 msgid "" "If C<autosync> is true, this enables autosync. Libguestfs will make a best " "effort attempt to make filesystems consistent and synchronized when the " @@ -17986,24 +18058,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4894 ../src/guestfs-actions.pod:7686 +#: ../fish/guestfish-actions.pod:4926 ../src/guestfs-actions.pod:7725 msgid "" "This is enabled by default (since libguestfs 1.5.24, previously it was " "disabled by default)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4897 +#: ../fish/guestfish-actions.pod:4929 msgid "set-direct" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4899 +#: ../fish/guestfish-actions.pod:4931 msgid "direct" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4901 +#: ../fish/guestfish-actions.pod:4933 #, no-wrap msgid "" " set-direct true|false\n" @@ -18011,36 +18083,36 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4903 ../src/guestfs-actions.pod:7699 +#: ../fish/guestfish-actions.pod:4935 ../src/guestfs-actions.pod:7738 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:4907 +#: ../fish/guestfish-actions.pod:4939 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:4911 ../src/guestfs-actions.pod:7707 +#: ../fish/guestfish-actions.pod:4943 ../src/guestfs-actions.pod:7746 msgid "You probably don't want to use this unless you know what you are doing." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4914 ../src/guestfs-actions.pod:7710 +#: ../fish/guestfish-actions.pod:4946 ../src/guestfs-actions.pod:7749 msgid "The default is disabled." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4916 +#: ../fish/guestfish-actions.pod:4948 msgid "set-e2attrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4918 +#: ../fish/guestfish-actions.pod:4950 #, no-wrap msgid "" " set-e2attrs file attrs [clear:true|false]\n" @@ -18048,14 +18120,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4920 ../src/guestfs-actions.pod:7731 +#: ../fish/guestfish-actions.pod:4952 ../src/guestfs-actions.pod:7770 msgid "" "This sets or clears the file attributes C<attrs> associated with the inode " "C<file>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4923 +#: ../fish/guestfish-actions.pod:4955 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 " @@ -18063,31 +18135,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4927 ../src/guestfs-actions.pod:7738 +#: ../fish/guestfish-actions.pod:4959 ../src/guestfs-actions.pod:7777 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:4930 ../src/guestfs-actions.pod:7741 +#: ../fish/guestfish-actions.pod:4962 ../src/guestfs-actions.pod:7780 msgid "If C<clear> is true, then the C<attrs> listed are cleared in the inode." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4933 ../src/guestfs-actions.pod:7744 +#: ../fish/guestfish-actions.pod:4965 ../src/guestfs-actions.pod:7783 msgid "" "In both cases, other attributes not present in the C<attrs> string are left " "unchanged." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4942 +#: ../fish/guestfish-actions.pod:4974 msgid "set-e2generation" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4944 +#: ../fish/guestfish-actions.pod:4976 #, no-wrap msgid "" " set-e2generation file generation\n" @@ -18095,22 +18167,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4946 ../src/guestfs-actions.pod:7786 +#: ../fish/guestfish-actions.pod:4978 ../src/guestfs-actions.pod:7825 msgid "This sets the ext2 file generation of a file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4948 +#: ../fish/guestfish-actions.pod:4980 msgid "See L</get-e2generation>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4950 +#: ../fish/guestfish-actions.pod:4982 msgid "set-e2label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4952 +#: ../fish/guestfish-actions.pod:4984 #, no-wrap msgid "" " set-e2label device label\n" @@ -18118,33 +18190,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4954 ../src/guestfs-actions.pod:7808 +#: ../fish/guestfish-actions.pod:4986 ../src/guestfs-actions.pod:7847 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:4958 +#: ../fish/guestfish-actions.pod:4990 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:4961 +#: ../fish/guestfish-actions.pod:4993 msgid "" "I<This function is deprecated.> In new code, use the L</set_label> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4968 +#: ../fish/guestfish-actions.pod:5000 msgid "set-e2uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4970 +#: ../fish/guestfish-actions.pod:5002 #, no-wrap msgid "" " set-e2uuid device uuid\n" @@ -18152,7 +18224,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4972 ../src/guestfs-actions.pod:7826 +#: ../fish/guestfish-actions.pod:5004 ../src/guestfs-actions.pod:7865 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>, " @@ -18160,19 +18232,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4977 +#: ../fish/guestfish-actions.pod:5009 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:4980 +#: ../fish/guestfish-actions.pod:5012 msgid "set-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4982 +#: ../fish/guestfish-actions.pod:5014 #, no-wrap msgid "" " set-label device label\n" @@ -18180,44 +18252,44 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4984 ../src/guestfs-actions.pod:7845 +#: ../fish/guestfish-actions.pod:5016 ../src/guestfs-actions.pod:7884 msgid "Set the filesystem label on C<device> to C<label>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4986 ../src/guestfs-actions.pod:7847 +#: ../fish/guestfish-actions.pod:5018 ../src/guestfs-actions.pod:7886 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:4989 ../src/guestfs-actions.pod:7850 +#: ../fish/guestfish-actions.pod:5021 ../src/guestfs-actions.pod:7889 msgid "On ext2/3/4 filesystems, labels are limited to 16 bytes." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4991 ../src/guestfs-actions.pod:7852 +#: ../fish/guestfish-actions.pod:5023 ../src/guestfs-actions.pod:7891 msgid "On NTFS filesystems, labels are limited to 128 unicode characters." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4993 +#: ../fish/guestfish-actions.pod:5025 msgid "To read the label on a filesystem, call L</vfs-label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4995 +#: ../fish/guestfish-actions.pod:5027 msgid "set-memsize" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4997 +#: ../fish/guestfish-actions.pod:5029 msgid "memsize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4999 +#: ../fish/guestfish-actions.pod:5031 #, no-wrap msgid "" " set-memsize memsize\n" @@ -18225,31 +18297,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5001 +#: ../fish/guestfish-actions.pod:5033 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:5005 ../src/guestfs-actions.pod:7870 +#: ../fish/guestfish-actions.pod:5037 ../src/guestfs-actions.pod:7909 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:5012 +#: ../fish/guestfish-actions.pod:5044 msgid "set-network" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5014 +#: ../fish/guestfish-actions.pod:5046 msgid "network" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5016 +#: ../fish/guestfish-actions.pod:5048 #, no-wrap msgid "" " set-network true|false\n" @@ -18257,31 +18329,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5018 ../src/guestfs-actions.pod:7887 +#: ../fish/guestfish-actions.pod:5050 ../src/guestfs-actions.pod:7926 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:5021 ../src/guestfs-actions.pod:7890 +#: ../fish/guestfish-actions.pod:5053 ../src/guestfs-actions.pod:7929 msgid "" "This affects whether commands are able to access the network (see " "L<guestfs(3)/RUNNING COMMANDS>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5024 +#: ../fish/guestfish-actions.pod:5056 msgid "You must call this before calling L</launch>, otherwise it has no effect." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5027 +#: ../fish/guestfish-actions.pod:5059 msgid "set-path" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5031 +#: ../fish/guestfish-actions.pod:5063 #, no-wrap msgid "" " set-path searchpath\n" @@ -18289,34 +18361,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5033 ../src/guestfs-actions.pod:7906 +#: ../fish/guestfish-actions.pod:5065 ../src/guestfs-actions.pod:7945 msgid "Set the path that libguestfs searches for kernel and initrd.img." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5035 ../src/guestfs-actions.pod:7908 +#: ../fish/guestfish-actions.pod:5067 ../src/guestfs-actions.pod:7947 msgid "" "The default is C<$libdir/guestfs> unless overridden by setting " "C<LIBGUESTFS_PATH> environment variable." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5038 ../src/guestfs-actions.pod:7911 +#: ../fish/guestfish-actions.pod:5070 ../src/guestfs-actions.pod:7950 msgid "Setting C<path> to C<NULL> restores the default path." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5040 +#: ../fish/guestfish-actions.pod:5072 msgid "set-pgroup" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5042 +#: ../fish/guestfish-actions.pod:5074 msgid "pgroup" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5044 +#: ../fish/guestfish-actions.pod:5076 #, no-wrap msgid "" " set-pgroup true|false\n" @@ -18324,21 +18396,21 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5046 ../src/guestfs-actions.pod:7923 +#: ../fish/guestfish-actions.pod:5078 ../src/guestfs-actions.pod:7962 msgid "" "If C<pgroup> is true, child processes are placed into their own process " "group." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5049 ../src/guestfs-actions.pod:7926 +#: ../fish/guestfish-actions.pod:5081 ../src/guestfs-actions.pod:7965 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:5052 +#: ../fish/guestfish-actions.pod:5084 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, " @@ -18347,17 +18419,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5057 +#: ../fish/guestfish-actions.pod:5089 msgid "set-qemu" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5059 +#: ../fish/guestfish-actions.pod:5091 msgid "qemu" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5061 +#: ../fish/guestfish-actions.pod:5093 #, no-wrap msgid "" " set-qemu qemu\n" @@ -18365,29 +18437,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5063 ../src/guestfs-actions.pod:7944 +#: ../fish/guestfish-actions.pod:5095 ../src/guestfs-actions.pod:7983 msgid "Set the qemu binary that we will use." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5065 ../src/guestfs-actions.pod:7946 +#: ../fish/guestfish-actions.pod:5097 ../src/guestfs-actions.pod:7985 msgid "The default is chosen when the library was compiled by the configure script." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5068 ../src/guestfs-actions.pod:7949 +#: ../fish/guestfish-actions.pod:5100 ../src/guestfs-actions.pod:7988 msgid "" "You can also override this by setting the C<LIBGUESTFS_QEMU> environment " "variable." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5071 ../src/guestfs-actions.pod:7952 +#: ../fish/guestfish-actions.pod:5103 ../src/guestfs-actions.pod:7991 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5073 ../src/guestfs-actions.pod:7954 +#: ../fish/guestfish-actions.pod:5105 ../src/guestfs-actions.pod:7993 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 " @@ -18398,17 +18470,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5081 +#: ../fish/guestfish-actions.pod:5113 msgid "set-recovery-proc" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5083 +#: ../fish/guestfish-actions.pod:5115 msgid "recovery-proc" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5085 +#: ../fish/guestfish-actions.pod:5117 #, no-wrap msgid "" " set-recovery-proc true|false\n" @@ -18416,7 +18488,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5087 +#: ../fish/guestfish-actions.pod:5119 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 " @@ -18424,14 +18496,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5092 +#: ../fish/guestfish-actions.pod:5124 msgid "" "This only has any effect if called before L</launch>, and the default is " "true." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5095 ../src/guestfs-actions.pod:7980 +#: ../fish/guestfish-actions.pod:5127 ../src/guestfs-actions.pod:8019 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 " @@ -18440,17 +18512,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5101 +#: ../fish/guestfish-actions.pod:5133 msgid "set-selinux" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5103 +#: ../fish/guestfish-actions.pod:5135 msgid "selinux" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5105 +#: ../fish/guestfish-actions.pod:5137 #, no-wrap msgid "" " set-selinux true|false\n" @@ -18458,31 +18530,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5107 ../src/guestfs-actions.pod:7996 +#: ../fish/guestfish-actions.pod:5139 ../src/guestfs-actions.pod:8035 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:5110 ../src/guestfs-actions.pod:7999 +#: ../fish/guestfish-actions.pod:5142 ../src/guestfs-actions.pod:8038 msgid "" "Note that if SELinux is enabled, it is always in Permissive mode " "(C<enforcing=0>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5116 +#: ../fish/guestfish-actions.pod:5148 msgid "set-smp" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5118 +#: ../fish/guestfish-actions.pod:5150 msgid "smp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5120 +#: ../fish/guestfish-actions.pod:5152 #, no-wrap msgid "" " set-smp smp\n" @@ -18490,7 +18562,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5122 ../src/guestfs-actions.pod:8015 +#: ../fish/guestfish-actions.pod:5154 ../src/guestfs-actions.pod:8054 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 " @@ -18498,22 +18570,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5126 +#: ../fish/guestfish-actions.pod:5158 msgid "This function must be called before L</launch>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5128 +#: ../fish/guestfish-actions.pod:5160 msgid "set-trace" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5130 +#: ../fish/guestfish-actions.pod:5162 msgid "trace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5132 +#: ../fish/guestfish-actions.pod:5164 #, no-wrap msgid "" " set-trace true|false\n" @@ -18521,45 +18593,45 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5134 ../src/guestfs-actions.pod:8031 +#: ../fish/guestfish-actions.pod:5166 ../src/guestfs-actions.pod:8070 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:5137 ../src/guestfs-actions.pod:8034 +#: ../fish/guestfish-actions.pod:5169 ../src/guestfs-actions.pod:8073 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:5141 ../src/guestfs-actions.pod:8038 +#: ../fish/guestfish-actions.pod:5173 ../src/guestfs-actions.pod:8077 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:5144 +#: ../fish/guestfish-actions.pod:5176 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:5148 +#: ../fish/guestfish-actions.pod:5180 msgid "set-verbose" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5150 +#: ../fish/guestfish-actions.pod:5182 msgid "verbose" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5152 +#: ../fish/guestfish-actions.pod:5184 #, no-wrap msgid "" " set-verbose true|false\n" @@ -18567,31 +18639,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5154 ../src/guestfs-actions.pod:8055 +#: ../fish/guestfish-actions.pod:5186 ../src/guestfs-actions.pod:8094 msgid "If C<verbose> is true, this turns on verbose messages." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5156 ../src/guestfs-actions.pod:8057 +#: ../fish/guestfish-actions.pod:5188 ../src/guestfs-actions.pod:8096 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:5159 +#: ../fish/guestfish-actions.pod:5191 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:5163 +#: ../fish/guestfish-actions.pod:5195 msgid "setcon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5165 +#: ../fish/guestfish-actions.pod:5197 #, no-wrap msgid "" " setcon context\n" @@ -18599,24 +18671,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5167 ../src/guestfs-actions.pod:8074 +#: ../fish/guestfish-actions.pod:5199 ../src/guestfs-actions.pod:8113 msgid "" "This sets the SELinux security context of the daemon to the string " "C<context>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5170 ../src/guestfs-actions.pod:8077 +#: ../fish/guestfish-actions.pod:5202 ../src/guestfs-actions.pod:8116 msgid "See the documentation about SELINUX in L<guestfs(3)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5172 +#: ../fish/guestfish-actions.pod:5204 msgid "setxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5174 +#: ../fish/guestfish-actions.pod:5206 #, no-wrap msgid "" " setxattr xattr val vallen path\n" @@ -18624,24 +18696,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5176 ../src/guestfs-actions.pod:8092 +#: ../fish/guestfish-actions.pod:5208 ../src/guestfs-actions.pod:8131 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:5180 +#: ../fish/guestfish-actions.pod:5212 msgid "See also: L</lsetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5182 +#: ../fish/guestfish-actions.pod:5214 msgid "sfdisk" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5184 +#: ../fish/guestfish-actions.pod:5216 #, no-wrap msgid "" " sfdisk device cyls heads sectors 'lines ...'\n" @@ -18649,19 +18721,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5186 ../src/guestfs-actions.pod:8119 +#: ../fish/guestfish-actions.pod:5218 ../src/guestfs-actions.pod:8158 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:5189 ../src/guestfs-actions.pod:8122 +#: ../fish/guestfish-actions.pod:5221 ../src/guestfs-actions.pod:8161 msgid "C<device> should be a block device, for example C</dev/sda>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5191 ../src/guestfs-actions.pod:8124 +#: ../fish/guestfish-actions.pod:5223 ../src/guestfs-actions.pod:8163 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>, " @@ -18672,14 +18744,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5199 ../src/guestfs-actions.pod:8132 +#: ../fish/guestfish-actions.pod:5231 ../src/guestfs-actions.pod:8171 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:5202 ../src/guestfs-actions.pod:8135 +#: ../fish/guestfish-actions.pod:5234 ../src/guestfs-actions.pod:8174 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 " @@ -18687,24 +18759,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5206 +#: ../fish/guestfish-actions.pod:5238 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5209 ../fish/guestfish-actions.pod:5229 ../fish/guestfish-actions.pod:5248 +#: ../fish/guestfish-actions.pod:5241 ../fish/guestfish-actions.pod:5261 ../fish/guestfish-actions.pod:5280 msgid "" "I<This function is deprecated.> In new code, use the L</part_add> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5216 +#: ../fish/guestfish-actions.pod:5248 msgid "sfdiskM" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5218 +#: ../fish/guestfish-actions.pod:5250 #, no-wrap msgid "" " sfdiskM device 'lines ...'\n" @@ -18712,7 +18784,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5220 +#: ../fish/guestfish-actions.pod:5252 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 " @@ -18721,17 +18793,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5226 +#: ../fish/guestfish-actions.pod:5258 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5236 +#: ../fish/guestfish-actions.pod:5268 msgid "sfdisk-N" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5238 +#: ../fish/guestfish-actions.pod:5270 #, no-wrap msgid "" " sfdisk-N device partnum cyls heads sectors line\n" @@ -18739,31 +18811,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5240 ../src/guestfs-actions.pod:8191 +#: ../fish/guestfish-actions.pod:5272 ../src/guestfs-actions.pod:8230 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:5243 +#: ../fish/guestfish-actions.pod:5275 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:5246 +#: ../fish/guestfish-actions.pod:5278 msgid "See also: L</part-add>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5255 +#: ../fish/guestfish-actions.pod:5287 msgid "sfdisk-disk-geometry" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5257 +#: ../fish/guestfish-actions.pod:5289 #, no-wrap msgid "" " sfdisk-disk-geometry device\n" @@ -18771,7 +18843,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5259 +#: ../fish/guestfish-actions.pod:5291 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, " @@ -18780,17 +18852,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5264 ../fish/guestfish-actions.pod:5273 ../src/guestfs-actions.pod:8214 ../src/guestfs-actions.pod:8230 +#: ../fish/guestfish-actions.pod:5296 ../fish/guestfish-actions.pod:5305 ../src/guestfs-actions.pod:8253 ../src/guestfs-actions.pod:8269 msgid "The result is in human-readable format, and not designed to be parsed." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5267 +#: ../fish/guestfish-actions.pod:5299 msgid "sfdisk-kernel-geometry" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5269 +#: ../fish/guestfish-actions.pod:5301 #, no-wrap msgid "" " sfdisk-kernel-geometry device\n" @@ -18798,17 +18870,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5271 ../src/guestfs-actions.pod:8228 +#: ../fish/guestfish-actions.pod:5303 ../src/guestfs-actions.pod:8267 msgid "This displays the kernel's idea of the geometry of C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5276 +#: ../fish/guestfish-actions.pod:5308 msgid "sfdisk-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5278 +#: ../fish/guestfish-actions.pod:5310 #, no-wrap msgid "" " sfdisk-l device\n" @@ -18816,31 +18888,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5280 ../src/guestfs-actions.pod:8251 +#: ../fish/guestfish-actions.pod:5312 ../src/guestfs-actions.pod:8290 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:5284 +#: ../fish/guestfish-actions.pod:5316 msgid "See also: L</part-list>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5286 +#: ../fish/guestfish-actions.pod:5318 msgid "" "I<This function is deprecated.> In new code, use the L</part_list> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5293 +#: ../fish/guestfish-actions.pod:5325 msgid "sh" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5295 +#: ../fish/guestfish-actions.pod:5327 #, no-wrap msgid "" " sh command\n" @@ -18848,19 +18920,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5297 ../src/guestfs-actions.pod:8268 +#: ../fish/guestfish-actions.pod:5329 ../src/guestfs-actions.pod:8307 msgid "" "This call runs a command from the guest filesystem via the guest's " "C</bin/sh>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5300 +#: ../fish/guestfish-actions.pod:5332 msgid "This is like L</command>, but passes the command to:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5302 ../src/guestfs-actions.pod:8273 +#: ../fish/guestfish-actions.pod:5334 ../src/guestfs-actions.pod:8312 #, no-wrap msgid "" " /bin/sh -c \"command\"\n" @@ -18868,24 +18940,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5304 ../src/guestfs-actions.pod:8275 +#: ../fish/guestfish-actions.pod:5336 ../src/guestfs-actions.pod:8314 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:5308 +#: ../fish/guestfish-actions.pod:5340 msgid "All the provisos about L</command> apply to this call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5310 +#: ../fish/guestfish-actions.pod:5342 msgid "sh-lines" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5312 +#: ../fish/guestfish-actions.pod:5344 #, no-wrap msgid "" " sh-lines command\n" @@ -18893,22 +18965,70 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5314 +#: ../fish/guestfish-actions.pod:5346 msgid "This is the same as L</sh>, but splits the result into a list of lines." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5317 +#: ../fish/guestfish-actions.pod:5349 msgid "See also: L</command-lines>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5319 +#: ../fish/guestfish-actions.pod:5351 +msgid "shutdown" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:5353 +#, no-wrap +msgid "" +" shutdown\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:5355 +msgid "" +"This is the opposite of L</launch>. It performs an orderly shutdown of the " +"backend process(es). If the autosync flag is set (which is the default) " +"then the disk image is synchronized." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:5359 ../src/guestfs-actions.pod:8351 +msgid "" +"If the subprocess exits with an error then this function will return an " +"error, which should I<not> be ignored (it may indicate that the disk image " +"could not be written out properly)." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:5363 ../src/guestfs-actions.pod:8355 +msgid "It is safe to call this multiple times. Extra calls are ignored." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:5365 +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:5368 +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:5371 msgid "sleep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5321 +#: ../fish/guestfish-actions.pod:5373 #, no-wrap msgid "" " sleep secs\n" @@ -18916,17 +19036,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5323 ../src/guestfs-actions.pod:8309 +#: ../fish/guestfish-actions.pod:5375 ../src/guestfs-actions.pod:8371 msgid "Sleep for C<secs> seconds." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5325 +#: ../fish/guestfish-actions.pod:5377 msgid "stat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5327 +#: ../fish/guestfish-actions.pod:5379 #, no-wrap msgid "" " stat path\n" @@ -18934,17 +19054,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5331 ../src/guestfs-actions.pod:8323 +#: ../fish/guestfish-actions.pod:5383 ../src/guestfs-actions.pod:8385 msgid "This is the same as the C<stat(2)> system call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5333 +#: ../fish/guestfish-actions.pod:5385 msgid "statvfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5335 +#: ../fish/guestfish-actions.pod:5387 #, no-wrap msgid "" " statvfs path\n" @@ -18952,7 +19072,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5337 ../src/guestfs-actions.pod:8337 +#: ../fish/guestfish-actions.pod:5389 ../src/guestfs-actions.pod:8399 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 " @@ -18960,17 +19080,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5341 ../src/guestfs-actions.pod:8341 +#: ../fish/guestfish-actions.pod:5393 ../src/guestfs-actions.pod:8403 msgid "This is the same as the C<statvfs(2)> system call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5343 +#: ../fish/guestfish-actions.pod:5395 msgid "strings" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5345 +#: ../fish/guestfish-actions.pod:5397 #, no-wrap msgid "" " strings path\n" @@ -18978,19 +19098,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5347 ../src/guestfs-actions.pod:8355 +#: ../fish/guestfish-actions.pod:5399 ../src/guestfs-actions.pod:8417 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:5353 +#: ../fish/guestfish-actions.pod:5405 msgid "strings-e" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5355 +#: ../fish/guestfish-actions.pod:5407 #, no-wrap msgid "" " strings-e encoding path\n" @@ -18998,93 +19118,93 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5357 +#: ../fish/guestfish-actions.pod:5409 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:5361 ../src/guestfs-actions.pod:8378 +#: ../fish/guestfish-actions.pod:5413 ../src/guestfs-actions.pod:8440 msgid "Allowed encodings are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5365 ../src/guestfs-actions.pod:8382 +#: ../fish/guestfish-actions.pod:5417 ../src/guestfs-actions.pod:8444 msgid "s" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5367 +#: ../fish/guestfish-actions.pod:5419 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:5370 ../src/guestfs-actions.pod:8387 +#: ../fish/guestfish-actions.pod:5422 ../src/guestfs-actions.pod:8449 msgid "S" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5372 ../src/guestfs-actions.pod:8389 +#: ../fish/guestfish-actions.pod:5424 ../src/guestfs-actions.pod:8451 msgid "Single 8-bit-byte characters." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5374 ../src/guestfs-actions.pod:8391 +#: ../fish/guestfish-actions.pod:5426 ../src/guestfs-actions.pod:8453 msgid "b" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5376 ../src/guestfs-actions.pod:8393 +#: ../fish/guestfish-actions.pod:5428 ../src/guestfs-actions.pod:8455 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5379 ../src/guestfs-actions.pod:8396 +#: ../fish/guestfish-actions.pod:5431 ../src/guestfs-actions.pod:8458 msgid "l (lower case letter L)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5381 ../src/guestfs-actions.pod:8398 +#: ../fish/guestfish-actions.pod:5433 ../src/guestfs-actions.pod:8460 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:5384 ../src/guestfs-actions.pod:8401 +#: ../fish/guestfish-actions.pod:5436 ../src/guestfs-actions.pod:8463 msgid "B" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5386 ../src/guestfs-actions.pod:8403 +#: ../fish/guestfish-actions.pod:5438 ../src/guestfs-actions.pod:8465 msgid "32-bit big endian such as UCS-4BE." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5388 ../src/guestfs-actions.pod:8405 +#: ../fish/guestfish-actions.pod:5440 ../src/guestfs-actions.pod:8467 msgid "L" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5390 ../src/guestfs-actions.pod:8407 +#: ../fish/guestfish-actions.pod:5442 ../src/guestfs-actions.pod:8469 msgid "32-bit little endian such as UCS-4LE." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5394 ../src/guestfs-actions.pod:8411 +#: ../fish/guestfish-actions.pod:5446 ../src/guestfs-actions.pod:8473 msgid "The returned strings are transcoded to UTF-8." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5399 +#: ../fish/guestfish-actions.pod:5451 msgid "swapoff-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5401 +#: ../fish/guestfish-actions.pod:5453 #, no-wrap msgid "" " swapoff-device device\n" @@ -19092,19 +19212,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5403 +#: ../fish/guestfish-actions.pod:5455 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:5407 +#: ../fish/guestfish-actions.pod:5459 msgid "swapoff-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5409 +#: ../fish/guestfish-actions.pod:5461 #, no-wrap msgid "" " swapoff-file file\n" @@ -19112,17 +19232,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5411 ../src/guestfs-actions.pod:8442 +#: ../fish/guestfish-actions.pod:5463 ../src/guestfs-actions.pod:8504 msgid "This command disables the libguestfs appliance swap on file." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5413 +#: ../fish/guestfish-actions.pod:5465 msgid "swapoff-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5415 +#: ../fish/guestfish-actions.pod:5467 #, no-wrap msgid "" " swapoff-label label\n" @@ -19130,19 +19250,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5417 ../src/guestfs-actions.pod:8454 +#: ../fish/guestfish-actions.pod:5469 ../src/guestfs-actions.pod:8516 msgid "" "This command disables the libguestfs appliance swap on labeled swap " "partition." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5420 +#: ../fish/guestfish-actions.pod:5472 msgid "swapoff-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5422 +#: ../fish/guestfish-actions.pod:5474 #, no-wrap msgid "" " swapoff-uuid uuid\n" @@ -19150,19 +19270,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5424 ../src/guestfs-actions.pod:8467 +#: ../fish/guestfish-actions.pod:5476 ../src/guestfs-actions.pod:8529 msgid "" "This command disables the libguestfs appliance swap partition with the given " "UUID." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5427 +#: ../fish/guestfish-actions.pod:5479 msgid "swapon-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5429 +#: ../fish/guestfish-actions.pod:5481 #, no-wrap msgid "" " swapon-device device\n" @@ -19170,7 +19290,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5431 +#: ../fish/guestfish-actions.pod:5483 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 " @@ -19178,7 +19298,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5436 ../src/guestfs-actions.pod:8485 +#: ../fish/guestfish-actions.pod:5488 ../src/guestfs-actions.pod:8547 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 " @@ -19188,12 +19308,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5443 +#: ../fish/guestfish-actions.pod:5495 msgid "swapon-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5445 +#: ../fish/guestfish-actions.pod:5497 #, no-wrap msgid "" " swapon-file file\n" @@ -19201,17 +19321,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5447 +#: ../fish/guestfish-actions.pod:5499 msgid "This command enables swap to a file. See L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5450 +#: ../fish/guestfish-actions.pod:5502 msgid "swapon-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5452 +#: ../fish/guestfish-actions.pod:5504 #, no-wrap msgid "" " swapon-label label\n" @@ -19219,19 +19339,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5454 +#: ../fish/guestfish-actions.pod:5506 msgid "" "This command enables swap to a labeled swap partition. See " "L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5457 +#: ../fish/guestfish-actions.pod:5509 msgid "swapon-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5459 +#: ../fish/guestfish-actions.pod:5511 #, no-wrap msgid "" " swapon-uuid uuid\n" @@ -19239,19 +19359,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5461 +#: ../fish/guestfish-actions.pod:5513 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:5464 +#: ../fish/guestfish-actions.pod:5516 msgid "sync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5466 +#: ../fish/guestfish-actions.pod:5518 #, no-wrap msgid "" " sync\n" @@ -19259,26 +19379,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5468 ../src/guestfs-actions.pod:8540 +#: ../fish/guestfish-actions.pod:5520 ../src/guestfs-actions.pod:8602 msgid "" "This syncs the disk, so that any writes are flushed through to the " "underlying disk image." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5471 ../src/guestfs-actions.pod:8543 +#: ../fish/guestfish-actions.pod:5523 ../src/guestfs-actions.pod:8605 msgid "" "You should always call this if you have modified a disk image, before " "closing the handle." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5474 +#: ../fish/guestfish-actions.pod:5526 msgid "tail" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5476 +#: ../fish/guestfish-actions.pod:5528 #, no-wrap msgid "" " tail path\n" @@ -19286,17 +19406,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5478 ../src/guestfs-actions.pod:8556 +#: ../fish/guestfish-actions.pod:5530 ../src/guestfs-actions.pod:8618 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:5484 +#: ../fish/guestfish-actions.pod:5536 msgid "tail-n" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5486 +#: ../fish/guestfish-actions.pod:5538 #, no-wrap msgid "" " tail-n nrlines path\n" @@ -19304,26 +19424,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5488 ../src/guestfs-actions.pod:8575 +#: ../fish/guestfish-actions.pod:5540 ../src/guestfs-actions.pod:8637 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:5491 ../src/guestfs-actions.pod:8578 +#: ../fish/guestfish-actions.pod:5543 ../src/guestfs-actions.pod:8640 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:5499 +#: ../fish/guestfish-actions.pod:5551 msgid "tar-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5501 +#: ../fish/guestfish-actions.pod:5553 #, no-wrap msgid "" " tar-in (tarfile|-) directory\n" @@ -19331,24 +19451,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5503 ../src/guestfs-actions.pod:8599 +#: ../fish/guestfish-actions.pod:5555 ../src/guestfs-actions.pod:8661 msgid "" "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> " "tar file) into C<directory>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5506 +#: ../fish/guestfish-actions.pod:5558 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5511 +#: ../fish/guestfish-actions.pod:5563 msgid "tar-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5513 +#: ../fish/guestfish-actions.pod:5565 #, no-wrap msgid "" " tar-out directory (tarfile|-)\n" @@ -19356,24 +19476,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5515 ../src/guestfs-actions.pod:8616 +#: ../fish/guestfish-actions.pod:5567 ../src/guestfs-actions.pod:8678 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarfile>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5518 +#: ../fish/guestfish-actions.pod:5570 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5523 +#: ../fish/guestfish-actions.pod:5575 msgid "tgz-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5525 +#: ../fish/guestfish-actions.pod:5577 #, no-wrap msgid "" " tgz-in (tarball|-) directory\n" @@ -19381,24 +19501,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5527 ../src/guestfs-actions.pod:8633 +#: ../fish/guestfish-actions.pod:5579 ../src/guestfs-actions.pod:8695 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:5530 +#: ../fish/guestfish-actions.pod:5582 msgid "To upload an uncompressed tarball, use L</tar-in>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5534 +#: ../fish/guestfish-actions.pod:5586 msgid "tgz-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5536 +#: ../fish/guestfish-actions.pod:5588 #, no-wrap msgid "" " tgz-out directory (tarball|-)\n" @@ -19406,24 +19526,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5538 ../src/guestfs-actions.pod:8649 +#: ../fish/guestfish-actions.pod:5590 ../src/guestfs-actions.pod:8711 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarball>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5541 +#: ../fish/guestfish-actions.pod:5593 msgid "To download an uncompressed tarball, use L</tar-out>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5545 +#: ../fish/guestfish-actions.pod:5597 msgid "touch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5547 +#: ../fish/guestfish-actions.pod:5599 #, no-wrap msgid "" " touch path\n" @@ -19431,7 +19551,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5549 ../src/guestfs-actions.pod:8664 +#: ../fish/guestfish-actions.pod:5601 ../src/guestfs-actions.pod:8726 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 " @@ -19439,19 +19559,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5553 ../src/guestfs-actions.pod:8668 +#: ../fish/guestfish-actions.pod:5605 ../src/guestfs-actions.pod:8730 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:5556 +#: ../fish/guestfish-actions.pod:5608 msgid "truncate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5558 +#: ../fish/guestfish-actions.pod:5610 #, no-wrap msgid "" " truncate path\n" @@ -19459,19 +19579,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5560 ../src/guestfs-actions.pod:8681 +#: ../fish/guestfish-actions.pod:5612 ../src/guestfs-actions.pod:8743 msgid "" "This command truncates C<path> to a zero-length file. The file must exist " "already." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5563 +#: ../fish/guestfish-actions.pod:5615 msgid "truncate-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5565 +#: ../fish/guestfish-actions.pod:5617 #, no-wrap msgid "" " truncate-size path size\n" @@ -19479,14 +19599,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5567 ../src/guestfs-actions.pod:8695 +#: ../fish/guestfish-actions.pod:5619 ../src/guestfs-actions.pod:8757 msgid "" "This command truncates C<path> to size C<size> bytes. The file must exist " "already." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5570 +#: ../fish/guestfish-actions.pod:5622 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 " @@ -19495,12 +19615,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5576 +#: ../fish/guestfish-actions.pod:5628 msgid "tune2fs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5578 +#: ../fish/guestfish-actions.pod:5630 #, no-wrap msgid "" " tune2fs device [force:true|false] [maxmountcount:N] [mountcount:N] " @@ -19511,26 +19631,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5580 ../src/guestfs-actions.pod:8731 +#: ../fish/guestfish-actions.pod:5632 ../src/guestfs-actions.pod:8793 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:5589 ../src/guestfs-actions.pod:8740 +#: ../fish/guestfish-actions.pod:5641 ../src/guestfs-actions.pod:8802 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:5592 ../src/guestfs-actions.pod:8743 +#: ../fish/guestfish-actions.pod:5644 ../src/guestfs-actions.pod:8805 msgid "C<maxmountcount>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5594 ../src/guestfs-actions.pod:8745 +#: ../fish/guestfish-actions.pod:5646 ../src/guestfs-actions.pod:8807 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. " @@ -19538,24 +19658,24 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5598 ../src/guestfs-actions.pod:8749 +#: ../fish/guestfish-actions.pod:5650 ../src/guestfs-actions.pod:8811 msgid "C<mountcount>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5600 ../src/guestfs-actions.pod:8751 +#: ../fish/guestfish-actions.pod:5652 ../src/guestfs-actions.pod:8813 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:5603 ../src/guestfs-actions.pod:8754 +#: ../fish/guestfish-actions.pod:5655 ../src/guestfs-actions.pod:8816 msgid "C<errorbehavior>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5605 ../src/guestfs-actions.pod:8756 +#: ../fish/guestfish-actions.pod:5657 ../src/guestfs-actions.pod:8818 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 " @@ -19564,77 +19684,77 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5610 ../src/guestfs-actions.pod:8761 +#: ../fish/guestfish-actions.pod:5662 ../src/guestfs-actions.pod:8823 msgid "This is the same as the tune2fs C<-e> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5612 ../src/guestfs-actions.pod:8763 +#: ../fish/guestfish-actions.pod:5664 ../src/guestfs-actions.pod:8825 msgid "C<group>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5614 ../src/guestfs-actions.pod:8765 +#: ../fish/guestfish-actions.pod:5666 ../src/guestfs-actions.pod:8827 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:5618 ../src/guestfs-actions.pod:8769 +#: ../fish/guestfish-actions.pod:5670 ../src/guestfs-actions.pod:8831 msgid "C<intervalbetweenchecks>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5620 ../src/guestfs-actions.pod:8771 +#: ../fish/guestfish-actions.pod:5672 ../src/guestfs-actions.pod:8833 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:5624 ../src/guestfs-actions.pod:8775 +#: ../fish/guestfish-actions.pod:5676 ../src/guestfs-actions.pod:8837 msgid "This is the same as the tune2fs C<-i> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5626 ../src/guestfs-actions.pod:8777 +#: ../fish/guestfish-actions.pod:5678 ../src/guestfs-actions.pod:8839 msgid "C<reservedblockspercentage>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5628 ../src/guestfs-actions.pod:8779 +#: ../fish/guestfish-actions.pod:5680 ../src/guestfs-actions.pod:8841 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:5632 ../src/guestfs-actions.pod:8783 +#: ../fish/guestfish-actions.pod:5684 ../src/guestfs-actions.pod:8845 msgid "C<lastmounteddirectory>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5634 ../src/guestfs-actions.pod:8785 +#: ../fish/guestfish-actions.pod:5686 ../src/guestfs-actions.pod:8847 msgid "" "Set the last mounted directory. This is the same as the tune2fs C<-M> " "option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5637 ../src/guestfs-actions.pod:8788 +#: ../fish/guestfish-actions.pod:5689 ../src/guestfs-actions.pod:8850 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:5641 ../src/guestfs-actions.pod:8792 +#: ../fish/guestfish-actions.pod:5693 ../src/guestfs-actions.pod:8854 msgid "C<user>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5643 ../src/guestfs-actions.pod:8794 +#: ../fish/guestfish-actions.pod:5695 ../src/guestfs-actions.pod:8856 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 " @@ -19642,19 +19762,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5649 +#: ../fish/guestfish-actions.pod:5701 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:5655 +#: ../fish/guestfish-actions.pod:5707 msgid "tune2fs-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5657 +#: ../fish/guestfish-actions.pod:5709 #, no-wrap msgid "" " tune2fs-l device\n" @@ -19662,14 +19782,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5659 ../src/guestfs-actions.pod:8836 +#: ../fish/guestfish-actions.pod:5711 ../src/guestfs-actions.pod:8898 msgid "" "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on " "C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5662 ../src/guestfs-actions.pod:8839 +#: ../fish/guestfish-actions.pod:5714 ../src/guestfs-actions.pod:8901 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 " @@ -19678,12 +19798,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5667 +#: ../fish/guestfish-actions.pod:5719 msgid "txz-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5669 +#: ../fish/guestfish-actions.pod:5721 #, no-wrap msgid "" " txz-in (tarball|-) directory\n" @@ -19691,19 +19811,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5671 ../src/guestfs-actions.pod:8859 +#: ../fish/guestfish-actions.pod:5723 ../src/guestfs-actions.pod:8921 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:5676 +#: ../fish/guestfish-actions.pod:5728 msgid "txz-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5678 +#: ../fish/guestfish-actions.pod:5730 #, no-wrap msgid "" " txz-out directory (tarball|-)\n" @@ -19711,19 +19831,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5680 ../src/guestfs-actions.pod:8873 +#: ../fish/guestfish-actions.pod:5732 ../src/guestfs-actions.pod:8935 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:5685 +#: ../fish/guestfish-actions.pod:5737 msgid "umask" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5687 +#: ../fish/guestfish-actions.pod:5739 #, no-wrap msgid "" " umask mask\n" @@ -19731,14 +19851,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5689 ../src/guestfs-actions.pod:8886 +#: ../fish/guestfish-actions.pod:5741 ../src/guestfs-actions.pod:8948 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:5692 ../src/guestfs-actions.pod:8889 +#: ../fish/guestfish-actions.pod:5744 ../src/guestfs-actions.pod:8951 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 " @@ -19746,7 +19866,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5697 ../src/guestfs-actions.pod:8894 +#: ../fish/guestfish-actions.pod:5749 ../src/guestfs-actions.pod:8956 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 " @@ -19754,27 +19874,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5701 +#: ../fish/guestfish-actions.pod:5753 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5704 ../src/guestfs-actions.pod:8901 +#: ../fish/guestfish-actions.pod:5756 ../src/guestfs-actions.pod:8963 msgid "This call returns the previous umask." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5706 +#: ../fish/guestfish-actions.pod:5758 msgid "umount" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5708 +#: ../fish/guestfish-actions.pod:5760 msgid "unmount" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5710 +#: ../fish/guestfish-actions.pod:5762 #, no-wrap msgid "" " umount pathordevice\n" @@ -19782,24 +19902,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5712 ../src/guestfs-actions.pod:8913 +#: ../fish/guestfish-actions.pod:5764 ../src/guestfs-actions.pod:8975 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:5716 +#: ../fish/guestfish-actions.pod:5768 msgid "umount-all" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5718 +#: ../fish/guestfish-actions.pod:5770 msgid "unmount-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5720 +#: ../fish/guestfish-actions.pod:5772 #, no-wrap msgid "" " umount-all\n" @@ -19807,22 +19927,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5722 ../src/guestfs-actions.pod:8926 +#: ../fish/guestfish-actions.pod:5774 ../src/guestfs-actions.pod:8988 msgid "This unmounts all mounted filesystems." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5724 ../src/guestfs-actions.pod:8928 +#: ../fish/guestfish-actions.pod:5776 ../src/guestfs-actions.pod:8990 msgid "Some internal mounts are not unmounted by this call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5726 +#: ../fish/guestfish-actions.pod:5778 msgid "umount-local" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5728 +#: ../fish/guestfish-actions.pod:5780 #, no-wrap msgid "" " umount-local [retry:true|false]\n" @@ -19830,19 +19950,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5730 ../src/guestfs-actions.pod:8947 +#: ../fish/guestfish-actions.pod:5782 ../src/guestfs-actions.pod:9009 msgid "" "If libguestfs is exporting the filesystem on a local mountpoint, then this " "unmounts it." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5737 +#: ../fish/guestfish-actions.pod:5789 msgid "upload" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5739 +#: ../fish/guestfish-actions.pod:5791 #, no-wrap msgid "" " upload (filename|-) remotefilename\n" @@ -19850,22 +19970,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5741 ../fish/guestfish-actions.pod:5754 ../src/guestfs-actions.pod:8983 ../src/guestfs-actions.pod:9007 +#: ../fish/guestfish-actions.pod:5793 ../fish/guestfish-actions.pod:5806 ../src/guestfs-actions.pod:9045 ../src/guestfs-actions.pod:9069 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5746 +#: ../fish/guestfish-actions.pod:5798 msgid "See also L</download>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5750 +#: ../fish/guestfish-actions.pod:5802 msgid "upload-offset" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5752 +#: ../fish/guestfish-actions.pod:5804 #, no-wrap msgid "" " upload-offset (filename|-) remotefilename offset\n" @@ -19873,7 +19993,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5757 ../src/guestfs-actions.pod:9010 +#: ../fish/guestfish-actions.pod:5809 ../src/guestfs-actions.pod:9072 msgid "" "C<remotefilename> is overwritten starting at the byte C<offset> specified. " "The intention is to overwrite parts of existing files or devices, although " @@ -19883,7 +20003,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5764 +#: ../fish/guestfish-actions.pod:5816 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 " @@ -19891,17 +20011,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5769 +#: ../fish/guestfish-actions.pod:5821 msgid "See also L</upload>, L</pwrite>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5773 +#: ../fish/guestfish-actions.pod:5825 msgid "utimens" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5775 +#: ../fish/guestfish-actions.pod:5827 #, no-wrap msgid "" " utimens path atsecs atnsecs mtsecs mtnsecs\n" @@ -19909,26 +20029,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5777 ../src/guestfs-actions.pod:9043 +#: ../fish/guestfish-actions.pod:5829 ../src/guestfs-actions.pod:9105 msgid "This command sets the timestamps of a file with nanosecond precision." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5780 ../src/guestfs-actions.pod:9046 +#: ../fish/guestfish-actions.pod:5832 ../src/guestfs-actions.pod:9108 msgid "" "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds " "from the epoch." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5783 ../src/guestfs-actions.pod:9049 +#: ../fish/guestfish-actions.pod:5835 ../src/guestfs-actions.pod:9111 msgid "" "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and " "nanoseconds from the epoch." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5786 ../src/guestfs-actions.pod:9052 +#: ../fish/guestfish-actions.pod:5838 ../src/guestfs-actions.pod:9114 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 " @@ -19936,7 +20056,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5790 ../src/guestfs-actions.pod:9056 +#: ../fish/guestfish-actions.pod:5842 ../src/guestfs-actions.pod:9118 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 " @@ -19944,12 +20064,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5794 +#: ../fish/guestfish-actions.pod:5846 msgid "version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5796 +#: ../fish/guestfish-actions.pod:5848 #, no-wrap msgid "" " version\n" @@ -19957,12 +20077,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5798 ../src/guestfs-actions.pod:9069 +#: ../fish/guestfish-actions.pod:5850 ../src/guestfs-actions.pod:9131 msgid "Return the libguestfs version number that the program is linked against." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5801 ../src/guestfs-actions.pod:9072 +#: ../fish/guestfish-actions.pod:5853 ../src/guestfs-actions.pod:9134 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 " @@ -19971,7 +20091,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5806 ../src/guestfs-actions.pod:9077 +#: ../fish/guestfish-actions.pod:5858 ../src/guestfs-actions.pod:9139 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 " @@ -19980,7 +20100,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5812 ../src/guestfs-actions.pod:9083 +#: ../fish/guestfish-actions.pod:5864 ../src/guestfs-actions.pod:9145 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 " @@ -19989,17 +20109,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5818 ../src/guestfs-actions.pod:9089 +#: ../fish/guestfish-actions.pod:5870 ../src/guestfs-actions.pod:9151 msgid "To construct the original version string: C<$major.$minor.$release$extra>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5821 ../src/guestfs-actions.pod:9092 +#: ../fish/guestfish-actions.pod:5873 ../src/guestfs-actions.pod:9154 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5823 +#: ../fish/guestfish-actions.pod:5875 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " @@ -20008,12 +20128,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5829 +#: ../fish/guestfish-actions.pod:5881 msgid "vfs-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5831 +#: ../fish/guestfish-actions.pod:5883 #, no-wrap msgid "" " vfs-label device\n" @@ -20021,27 +20141,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5833 ../src/guestfs-actions.pod:9112 +#: ../fish/guestfish-actions.pod:5885 ../src/guestfs-actions.pod:9174 msgid "This returns the filesystem label of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5836 ../src/guestfs-actions.pod:9115 +#: ../fish/guestfish-actions.pod:5888 ../src/guestfs-actions.pod:9177 msgid "If the filesystem is unlabeled, this returns the empty string." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5838 +#: ../fish/guestfish-actions.pod:5890 msgid "To find a filesystem from the label, use L</findfs-label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5840 +#: ../fish/guestfish-actions.pod:5892 msgid "vfs-type" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5842 +#: ../fish/guestfish-actions.pod:5894 #, no-wrap msgid "" " vfs-type device\n" @@ -20049,14 +20169,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5844 ../src/guestfs-actions.pod:9130 +#: ../fish/guestfish-actions.pod:5896 ../src/guestfs-actions.pod:9192 msgid "" "This command gets the filesystem type corresponding to the filesystem on " "C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5847 ../src/guestfs-actions.pod:9133 +#: ../fish/guestfish-actions.pod:5899 ../src/guestfs-actions.pod:9195 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 " @@ -20064,12 +20184,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5852 +#: ../fish/guestfish-actions.pod:5904 msgid "vfs-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5854 +#: ../fish/guestfish-actions.pod:5906 #, no-wrap msgid "" " vfs-uuid device\n" @@ -20077,27 +20197,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5856 ../src/guestfs-actions.pod:9149 +#: ../fish/guestfish-actions.pod:5908 ../src/guestfs-actions.pod:9211 msgid "This returns the filesystem UUID of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5859 ../src/guestfs-actions.pod:9152 +#: ../fish/guestfish-actions.pod:5911 ../src/guestfs-actions.pod:9214 msgid "If the filesystem does not have a UUID, this returns the empty string." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5861 +#: ../fish/guestfish-actions.pod:5913 msgid "To find a filesystem from the UUID, use L</findfs-uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5863 +#: ../fish/guestfish-actions.pod:5915 msgid "vg-activate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5865 +#: ../fish/guestfish-actions.pod:5917 #, no-wrap msgid "" " vg-activate true|false 'volgroups ...'\n" @@ -20105,31 +20225,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5867 ../src/guestfs-actions.pod:9168 +#: ../fish/guestfish-actions.pod:5919 ../src/guestfs-actions.pod:9230 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:5870 ../src/guestfs-actions.pod:9171 +#: ../fish/guestfish-actions.pod:5922 ../src/guestfs-actions.pod:9233 msgid "This command is the same as running C<vgchange -a y|n volgroups...>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5872 ../src/guestfs-actions.pod:9173 +#: ../fish/guestfish-actions.pod:5924 ../src/guestfs-actions.pod:9235 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:5875 +#: ../fish/guestfish-actions.pod:5927 msgid "vg-activate-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5877 +#: ../fish/guestfish-actions.pod:5929 #, no-wrap msgid "" " vg-activate-all true|false\n" @@ -20137,24 +20257,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5879 ../src/guestfs-actions.pod:9186 +#: ../fish/guestfish-actions.pod:5931 ../src/guestfs-actions.pod:9248 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:5882 ../src/guestfs-actions.pod:9189 +#: ../fish/guestfish-actions.pod:5934 ../src/guestfs-actions.pod:9251 msgid "This command is the same as running C<vgchange -a y|n>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5884 +#: ../fish/guestfish-actions.pod:5936 msgid "vgcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5886 +#: ../fish/guestfish-actions.pod:5938 #, no-wrap msgid "" " vgcreate volgroup 'physvols ...'\n" @@ -20162,19 +20282,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5888 ../src/guestfs-actions.pod:9202 +#: ../fish/guestfish-actions.pod:5940 ../src/guestfs-actions.pod:9264 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:5891 +#: ../fish/guestfish-actions.pod:5943 msgid "vglvuuids" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5893 +#: ../fish/guestfish-actions.pod:5945 #, no-wrap msgid "" " vglvuuids vgname\n" @@ -20182,31 +20302,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5895 ../src/guestfs-actions.pod:9215 +#: ../fish/guestfish-actions.pod:5947 ../src/guestfs-actions.pod:9277 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:5898 +#: ../fish/guestfish-actions.pod:5950 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:5901 +#: ../fish/guestfish-actions.pod:5953 msgid "See also L</vgpvuuids>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5903 +#: ../fish/guestfish-actions.pod:5955 msgid "vgmeta" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5905 +#: ../fish/guestfish-actions.pod:5957 #, no-wrap msgid "" " vgmeta vgname\n" @@ -20214,26 +20334,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5907 ../src/guestfs-actions.pod:9236 +#: ../fish/guestfish-actions.pod:5959 ../src/guestfs-actions.pod:9298 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:5910 ../src/guestfs-actions.pod:9239 +#: ../fish/guestfish-actions.pod:5962 ../src/guestfs-actions.pod:9301 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:5913 +#: ../fish/guestfish-actions.pod:5965 msgid "vgpvuuids" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5915 +#: ../fish/guestfish-actions.pod:5967 #, no-wrap msgid "" " vgpvuuids vgname\n" @@ -20241,31 +20361,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5917 ../src/guestfs-actions.pod:9254 +#: ../fish/guestfish-actions.pod:5969 ../src/guestfs-actions.pod:9316 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:5920 +#: ../fish/guestfish-actions.pod:5972 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:5923 +#: ../fish/guestfish-actions.pod:5975 msgid "See also L</vglvuuids>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5925 +#: ../fish/guestfish-actions.pod:5977 msgid "vgremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5927 +#: ../fish/guestfish-actions.pod:5979 #, no-wrap msgid "" " vgremove vgname\n" @@ -20273,22 +20393,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5929 ../src/guestfs-actions.pod:9274 +#: ../fish/guestfish-actions.pod:5981 ../src/guestfs-actions.pod:9336 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5931 ../src/guestfs-actions.pod:9276 +#: ../fish/guestfish-actions.pod:5983 ../src/guestfs-actions.pod:9338 msgid "This also forcibly removes all logical volumes in the volume group (if any)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5934 +#: ../fish/guestfish-actions.pod:5986 msgid "vgrename" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5936 +#: ../fish/guestfish-actions.pod:5988 #, no-wrap msgid "" " vgrename volgroup newvolgroup\n" @@ -20296,17 +20416,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5938 ../src/guestfs-actions.pod:9290 +#: ../fish/guestfish-actions.pod:5990 ../src/guestfs-actions.pod:9352 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5940 +#: ../fish/guestfish-actions.pod:5992 msgid "vgs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5942 +#: ../fish/guestfish-actions.pod:5994 #, no-wrap msgid "" " vgs\n" @@ -20314,31 +20434,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5944 ../src/guestfs-actions.pod:9301 +#: ../fish/guestfish-actions.pod:5996 ../src/guestfs-actions.pod:9363 msgid "" "List all the volumes groups detected. This is the equivalent of the " "L<vgs(8)> command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5947 ../src/guestfs-actions.pod:9304 +#: ../fish/guestfish-actions.pod:5999 ../src/guestfs-actions.pod:9366 msgid "" "This returns a list of just the volume group names that were detected " "(eg. C<VolGroup00>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5950 +#: ../fish/guestfish-actions.pod:6002 msgid "See also L</vgs-full>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5952 +#: ../fish/guestfish-actions.pod:6004 msgid "vgs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5954 +#: ../fish/guestfish-actions.pod:6006 #, no-wrap msgid "" " vgs-full\n" @@ -20346,19 +20466,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5956 ../src/guestfs-actions.pod:9320 +#: ../fish/guestfish-actions.pod:6008 ../src/guestfs-actions.pod:9382 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:5959 +#: ../fish/guestfish-actions.pod:6011 msgid "vgscan" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5961 +#: ../fish/guestfish-actions.pod:6013 #, no-wrap msgid "" " vgscan\n" @@ -20366,19 +20486,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5963 ../src/guestfs-actions.pod:9334 +#: ../fish/guestfish-actions.pod:6015 ../src/guestfs-actions.pod:9396 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:5966 +#: ../fish/guestfish-actions.pod:6018 msgid "vguuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5968 +#: ../fish/guestfish-actions.pod:6020 #, no-wrap msgid "" " vguuid vgname\n" @@ -20386,17 +20506,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5970 ../src/guestfs-actions.pod:9347 +#: ../fish/guestfish-actions.pod:6022 ../src/guestfs-actions.pod:9409 msgid "This command returns the UUID of the LVM VG named C<vgname>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5972 +#: ../fish/guestfish-actions.pod:6024 msgid "wc-c" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5974 +#: ../fish/guestfish-actions.pod:6026 #, no-wrap msgid "" " wc-c path\n" @@ -20404,19 +20524,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5976 ../src/guestfs-actions.pod:9387 +#: ../fish/guestfish-actions.pod:6028 ../src/guestfs-actions.pod:9449 msgid "" "This command counts the characters in a file, using the C<wc -c> external " "command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5979 +#: ../fish/guestfish-actions.pod:6031 msgid "wc-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5981 +#: ../fish/guestfish-actions.pod:6033 #, no-wrap msgid "" " wc-l path\n" @@ -20424,19 +20544,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5983 ../src/guestfs-actions.pod:9400 +#: ../fish/guestfish-actions.pod:6035 ../src/guestfs-actions.pod:9462 msgid "" "This command counts the lines in a file, using the C<wc -l> external " "command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5986 +#: ../fish/guestfish-actions.pod:6038 msgid "wc-w" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5988 +#: ../fish/guestfish-actions.pod:6040 #, no-wrap msgid "" " wc-w path\n" @@ -20444,19 +20564,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5990 ../src/guestfs-actions.pod:9413 +#: ../fish/guestfish-actions.pod:6042 ../src/guestfs-actions.pod:9475 msgid "" "This command counts the words in a file, using the C<wc -w> external " "command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5993 +#: ../fish/guestfish-actions.pod:6045 msgid "wipefs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5995 +#: ../fish/guestfish-actions.pod:6047 #, no-wrap msgid "" " wipefs device\n" @@ -20464,31 +20584,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5997 ../src/guestfs-actions.pod:9426 +#: ../fish/guestfish-actions.pod:6049 ../src/guestfs-actions.pod:9488 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:6000 ../src/guestfs-actions.pod:9429 +#: ../fish/guestfish-actions.pod:6052 ../src/guestfs-actions.pod:9491 msgid "" "This does not erase the filesystem itself nor any other data from the " "C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6003 +#: ../fish/guestfish-actions.pod:6055 msgid "Compare with L</zero> which zeroes the first few blocks of a device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6006 +#: ../fish/guestfish-actions.pod:6058 msgid "write" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6008 +#: ../fish/guestfish-actions.pod:6060 #, no-wrap msgid "" " write path content\n" @@ -20496,24 +20616,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6010 ../src/guestfs-actions.pod:9447 +#: ../fish/guestfish-actions.pod:6062 ../src/guestfs-actions.pod:9509 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:6013 +#: ../fish/guestfish-actions.pod:6065 msgid "See also L</write-append>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6018 +#: ../fish/guestfish-actions.pod:6070 msgid "write-append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6020 +#: ../fish/guestfish-actions.pod:6072 #, no-wrap msgid "" " write-append path content\n" @@ -20521,24 +20641,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6022 ../src/guestfs-actions.pod:9467 +#: ../fish/guestfish-actions.pod:6074 ../src/guestfs-actions.pod:9529 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:6025 +#: ../fish/guestfish-actions.pod:6077 msgid "See also L</write>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6030 +#: ../fish/guestfish-actions.pod:6082 msgid "write-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6032 +#: ../fish/guestfish-actions.pod:6084 #, no-wrap msgid "" " write-file path content size\n" @@ -20546,38 +20666,38 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6034 ../src/guestfs-actions.pod:9494 +#: ../fish/guestfish-actions.pod:6086 ../src/guestfs-actions.pod:9556 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:6038 ../src/guestfs-actions.pod:9498 +#: ../fish/guestfish-actions.pod:6090 ../src/guestfs-actions.pod:9560 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:6042 ../src/guestfs-actions.pod:9502 +#: ../fish/guestfish-actions.pod:6094 ../src/guestfs-actions.pod:9564 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:6048 +#: ../fish/guestfish-actions.pod:6100 msgid "I<This function is deprecated.> In new code, use the L</write> call instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6055 +#: ../fish/guestfish-actions.pod:6107 msgid "zegrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6057 +#: ../fish/guestfish-actions.pod:6109 #, no-wrap msgid "" " zegrep regex path\n" @@ -20585,17 +20705,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6059 ../src/guestfs-actions.pod:9519 +#: ../fish/guestfish-actions.pod:6111 ../src/guestfs-actions.pod:9581 msgid "This calls the external C<zegrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6065 +#: ../fish/guestfish-actions.pod:6117 msgid "zegrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6067 +#: ../fish/guestfish-actions.pod:6119 #, no-wrap msgid "" " zegrepi regex path\n" @@ -20603,17 +20723,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6069 ../src/guestfs-actions.pod:9538 +#: ../fish/guestfish-actions.pod:6121 ../src/guestfs-actions.pod:9600 msgid "This calls the external C<zegrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6075 +#: ../fish/guestfish-actions.pod:6127 msgid "zero" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6077 +#: ../fish/guestfish-actions.pod:6129 #, no-wrap msgid "" " zero device\n" @@ -20621,12 +20741,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6079 ../src/guestfs-actions.pod:9556 +#: ../fish/guestfish-actions.pod:6131 ../src/guestfs-actions.pod:9618 msgid "This command writes zeroes over the first few blocks of C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6081 ../src/guestfs-actions.pod:9558 +#: ../fish/guestfish-actions.pod:6133 ../src/guestfs-actions.pod:9620 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 " @@ -20634,7 +20754,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6085 ../fish/guestfish-actions.pod:6100 ../src/guestfs-actions.pod:9562 ../src/guestfs-actions.pod:9588 +#: ../fish/guestfish-actions.pod:6137 ../fish/guestfish-actions.pod:6152 ../src/guestfs-actions.pod:9624 ../src/guestfs-actions.pod:9650 msgid "" "If blocks are already zero, then this command avoids writing zeroes. This " "prevents the underlying device from becoming non-sparse or growing " @@ -20642,17 +20762,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6089 +#: ../fish/guestfish-actions.pod:6141 msgid "See also: L</zero-device>, L</scrub-device>, L</is-zero-device>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6092 +#: ../fish/guestfish-actions.pod:6144 msgid "zero-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6094 +#: ../fish/guestfish-actions.pod:6146 #, no-wrap msgid "" " zero-device device\n" @@ -20660,19 +20780,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6096 +#: ../fish/guestfish-actions.pod:6148 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:6104 +#: ../fish/guestfish-actions.pod:6156 msgid "zero-free-space" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6106 +#: ../fish/guestfish-actions.pod:6158 #, no-wrap msgid "" " zero-free-space directory\n" @@ -20680,33 +20800,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6108 ../src/guestfs-actions.pod:9607 +#: ../fish/guestfish-actions.pod:6160 ../src/guestfs-actions.pod:9669 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:6111 ../src/guestfs-actions.pod:9610 +#: ../fish/guestfish-actions.pod:6163 ../src/guestfs-actions.pod:9672 msgid "" "The filesystem contents are not affected, but any free space in the " "filesystem is freed." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6114 ../src/guestfs-actions.pod:9613 +#: ../fish/guestfish-actions.pod:6166 ../src/guestfs-actions.pod:9675 msgid "" "In future (but not currently) these zeroed blocks will be \"sparsified\" - " "that is, given back to the host." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6117 +#: ../fish/guestfish-actions.pod:6169 msgid "zerofree" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6119 +#: ../fish/guestfish-actions.pod:6171 #, no-wrap msgid "" " zerofree device\n" @@ -20714,7 +20834,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6121 ../src/guestfs-actions.pod:9631 +#: ../fish/guestfish-actions.pod:6173 ../src/guestfs-actions.pod:9693 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 " @@ -20722,24 +20842,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6126 ../src/guestfs-actions.pod:9636 +#: ../fish/guestfish-actions.pod:6178 ../src/guestfs-actions.pod:9698 msgid "You should B<not> run this program if the filesystem is mounted." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6129 ../src/guestfs-actions.pod:9639 +#: ../fish/guestfish-actions.pod:6181 ../src/guestfs-actions.pod:9701 msgid "" "It is possible that using this program can damage the filesystem or data on " "the filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6132 +#: ../fish/guestfish-actions.pod:6184 msgid "zfgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6134 +#: ../fish/guestfish-actions.pod:6186 #, no-wrap msgid "" " zfgrep pattern path\n" @@ -20747,17 +20867,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6136 ../src/guestfs-actions.pod:9653 +#: ../fish/guestfish-actions.pod:6188 ../src/guestfs-actions.pod:9715 msgid "This calls the external C<zfgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6142 +#: ../fish/guestfish-actions.pod:6194 msgid "zfgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6144 +#: ../fish/guestfish-actions.pod:6196 #, no-wrap msgid "" " zfgrepi pattern path\n" @@ -20765,17 +20885,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6146 ../src/guestfs-actions.pod:9672 +#: ../fish/guestfish-actions.pod:6198 ../src/guestfs-actions.pod:9734 msgid "This calls the external C<zfgrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6152 +#: ../fish/guestfish-actions.pod:6204 msgid "zfile" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6154 +#: ../fish/guestfish-actions.pod:6206 #, no-wrap msgid "" " zfile meth path\n" @@ -20783,32 +20903,32 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6156 ../src/guestfs-actions.pod:9698 +#: ../fish/guestfish-actions.pod:6208 ../src/guestfs-actions.pod:9760 msgid "This command runs C<file> after first decompressing C<path> using C<method>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6159 ../src/guestfs-actions.pod:9701 +#: ../fish/guestfish-actions.pod:6211 ../src/guestfs-actions.pod:9763 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6161 +#: ../fish/guestfish-actions.pod:6213 msgid "Since 1.0.63, use L</file> instead which can now process compressed files." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6164 +#: ../fish/guestfish-actions.pod:6216 msgid "I<This function is deprecated.> In new code, use the L</file> call instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6171 +#: ../fish/guestfish-actions.pod:6223 msgid "zgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6173 +#: ../fish/guestfish-actions.pod:6225 #, no-wrap msgid "" " zgrep regex path\n" @@ -20816,17 +20936,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6175 ../src/guestfs-actions.pod:9718 +#: ../fish/guestfish-actions.pod:6227 ../src/guestfs-actions.pod:9780 msgid "This calls the external C<zgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6181 +#: ../fish/guestfish-actions.pod:6233 msgid "zgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6183 +#: ../fish/guestfish-actions.pod:6235 #, no-wrap msgid "" " zgrepi regex path\n" @@ -20834,7 +20954,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6185 ../src/guestfs-actions.pod:9737 +#: ../fish/guestfish-actions.pod:6237 ../src/guestfs-actions.pod:9799 msgid "This calls the external C<zgrep -i> program and returns the matching lines." msgstr "" @@ -21813,7 +21933,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:135 ../src/guestfs.pod:2311 +#: ../fish/guestfish.pod:135 ../src/guestfs.pod:2334 #, no-wrap msgid "" " guestfish -N fs\n" @@ -23310,7 +23430,7 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:837 ../src/guestfs.pod:521 +#: ../fish/guestfish.pod:837 ../src/guestfs.pod:519 msgid "ENCRYPTED DISKS" msgstr "" @@ -23674,7 +23794,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:994 ../src/guestfs.pod:1048 +#: ../fish/guestfish.pod:994 ../src/guestfs.pod:1046 #, no-wrap msgid "" " #!/bin/bash -\n" @@ -23960,7 +24080,7 @@ msgid "COMMANDS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1124 ../src/guestfs.pod:1588 +#: ../fish/guestfish.pod:1124 ../src/guestfs.pod:1611 msgid "@ACTIONS@" msgstr "" @@ -23984,17 +24104,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1140 ../src/guestfs.pod:3271 +#: ../fish/guestfish.pod:1140 ../src/guestfs.pod:3294 msgid "FEBOOTSTRAP_KERNEL" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1142 ../src/guestfs.pod:3273 +#: ../fish/guestfish.pod:1142 ../src/guestfs.pod:3296 msgid "FEBOOTSTRAP_MODULES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1144 ../src/guestfs.pod:3275 +#: ../fish/guestfish.pod:1144 ../src/guestfs.pod:3298 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 " @@ -24052,17 +24172,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1172 ../src/guestfs.pod:3281 +#: ../fish/guestfish.pod:1172 ../src/guestfs.pod:3304 msgid "LIBGUESTFS_APPEND" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1174 ../src/guestfs.pod:3283 +#: ../fish/guestfish.pod:1174 ../src/guestfs.pod:3306 msgid "Pass additional options to the guest kernel." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1176 ../src/guestfs.pod:3285 +#: ../fish/guestfish.pod:1176 ../src/guestfs.pod:3308 msgid "LIBGUESTFS_DEBUG" msgstr "" @@ -24074,17 +24194,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1181 ../src/guestfs.pod:3290 +#: ../fish/guestfish.pod:1181 ../src/guestfs.pod:3313 msgid "LIBGUESTFS_MEMSIZE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1183 ../src/guestfs.pod:3292 +#: ../fish/guestfish.pod:1183 ../src/guestfs.pod:3315 msgid "Set the memory allocated to the qemu process, in megabytes. For example:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1186 ../src/guestfs.pod:3295 +#: ../fish/guestfish.pod:1186 ../src/guestfs.pod:3318 #, no-wrap msgid "" " LIBGUESTFS_MEMSIZE=700\n" @@ -24092,7 +24212,7 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1188 ../src/guestfs.pod:3297 +#: ../fish/guestfish.pod:1188 ../src/guestfs.pod:3320 msgid "LIBGUESTFS_PATH" msgstr "" @@ -24104,19 +24224,19 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1193 ../src/guestfs.pod:3302 +#: ../fish/guestfish.pod:1193 ../src/guestfs.pod:3325 msgid "LIBGUESTFS_QEMU" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1195 ../src/guestfs.pod:3304 +#: ../fish/guestfish.pod:1195 ../src/guestfs.pod:3327 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:1199 ../src/guestfs.pod:3310 +#: ../fish/guestfish.pod:1199 ../src/guestfs.pod:3333 msgid "LIBGUESTFS_TRACE" msgstr "" @@ -24138,19 +24258,19 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1208 ../sparsify/virt-sparsify.pod:263 ../src/guestfs.pod:3315 +#: ../fish/guestfish.pod:1208 ../sparsify/virt-sparsify.pod:263 ../src/guestfs.pod:3338 msgid "TMPDIR" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1210 ../src/guestfs.pod:3317 +#: ../fish/guestfish.pod:1210 ../src/guestfs.pod:3340 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:1213 ../src/guestfs.pod:3320 +#: ../fish/guestfish.pod:1213 ../src/guestfs.pod:3343 msgid "" "If libguestfs was compiled to use the supermin appliance then the real " "appliance is cached in this directory, shared between all handles belonging " @@ -28720,12 +28840,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:37 ../src/guestfs-actions.pod:187 ../src/guestfs-actions.pod:254 ../src/guestfs-actions.pod:291 ../src/guestfs-actions.pod:312 ../src/guestfs-actions.pod:333 ../src/guestfs-actions.pod:346 ../src/guestfs-actions.pod:360 ../src/guestfs-actions.pod:480 ../src/guestfs-actions.pod:500 ../src/guestfs-actions.pod:514 ../src/guestfs-actions.pod:559 ../src/guestfs-actions.pod:587 ../src/guestfs-actions.pod:605 ../src/guestfs-actions.pod:672 ../src/guestfs-actions.pod:705 ../src/guestfs-actions.pod:719 ../src/guestfs-actions.pod:775 ../src/guestfs-actions.pod:874 ../src/guestfs-actions.pod:892 ../src/guestfs-actions.pod:906 ../src/guestfs-actions.pod:920 ../src/guestfs-actions.pod:934 ../src/guestfs-actions.pod:948 ../src/guestfs-actions.pod:961 ../src/guestfs-actions.pod:998 ../src/guestfs-actions.pod:1032 ../src/guestfs-actions.pod:1054 ../src/guestfs-actions.pod:1090 ../src/guestfs-actions.pod:1103 ../src/guestfs-actions.pod:1115 ../src/guestfs-actions.pod:1145 ../src/guestfs-actions.pod:1160 ../src/guestfs-actions.pod:1321 ../src/guestfs-actions.pod:1341 ../src/guestfs-actions.pod:1359 ../src/guestfs-actions.pod:1449 ../src/guestfs-actions.pod:1508 ../src/guestfs-actions.pod:1554 ../src/guestfs-actions.pod:1594 ../src/guestfs-actions.pod:1647 ../src/guestfs-actions.pod:1700 ../src/guestfs-actions.pod:1758 ../src/guestfs-actions.pod:1812 ../src/guestfs-actions.pod:1831 ../src/guestfs-actions.pod:1845 ../src/guestfs-actions.pod:1873 ../src/guestfs-actions.pod:1943 ../src/guestfs-actions.pod:1974 ../src/guestfs-actions.pod:1999 ../src/guestfs-actions.pod:2065 ../src/guestfs-actions.pod:2108 ../src/guestfs-actions.pod:2221 ../src/guestfs-actions.pod:2248 ../src/guestfs-actions.pod:2463 ../src/guestfs-actions.pod:2485 ../src/guestfs-actions.pod:2572 ../src/guestfs-actions.pod:3223 ../src/guestfs-actions.pod:3367 ../src/guestfs-actions.pod:3426 ../src/guestfs-actions.pod:3461 ../src/guestfs-actions.pod:4565 ../src/guestfs-actions.pod:4580 ../src/guestfs-actions.pod:4605 ../src/guestfs-actions.pod:4823 ../src/guestfs-actions.pod:4837 ../src/guestfs-actions.pod:4850 ../src/guestfs-actions.pod:4864 ../src/guestfs-actions.pod:4879 ../src/guestfs-actions.pod:4915 ../src/guestfs-actions.pod:4987 ../src/guestfs-actions.pod:5007 ../src/guestfs-actions.pod:5024 ../src/guestfs-actions.pod:5044 ../src/guestfs-actions.pod:5064 ../src/guestfs-actions.pod:5099 ../src/guestfs-actions.pod:5118 ../src/guestfs-actions.pod:5137 ../src/guestfs-actions.pod:5154 ../src/guestfs-actions.pod:5189 ../src/guestfs-actions.pod:5201 ../src/guestfs-actions.pod:5234 ../src/guestfs-actions.pod:5250 ../src/guestfs-actions.pod:5263 ../src/guestfs-actions.pod:5278 ../src/guestfs-actions.pod:5295 ../src/guestfs-actions.pod:5453 ../src/guestfs-actions.pod:5589 ../src/guestfs-actions.pod:5601 ../src/guestfs-actions.pod:5621 ../src/guestfs-actions.pod:5634 ../src/guestfs-actions.pod:5685 ../src/guestfs-actions.pod:5703 ../src/guestfs-actions.pod:5721 ../src/guestfs-actions.pod:5737 ../src/guestfs-actions.pod:5751 ../src/guestfs-actions.pod:5765 ../src/guestfs-actions.pod:5782 ../src/guestfs-actions.pod:5797 ../src/guestfs-actions.pod:5824 ../src/guestfs-actions.pod:5857 ../src/guestfs-actions.pod:5942 ../src/guestfs-actions.pod:6015 ../src/guestfs-actions.pod:6046 ../src/guestfs-actions.pod:6065 ../src/guestfs-actions.pod:6084 ../src/guestfs-actions.pod:6096 ../src/guestfs-actions.pod:6113 ../src/guestfs-actions.pod:6126 ../src/guestfs-actions.pod:6141 ../src/guestfs-actions.pod:6156 ../src/guestfs-actions.pod:6188 ../src/guestfs-actions.pod:6214 ../src/guestfs-actions.pod:6283 ../src/guestfs-actions.pod:6332 ../src/guestfs-actions.pod:6347 ../src/guestfs-actions.pod:6367 ../src/guestfs-actions.pod:6381 ../src/guestfs-actions.pod:6398 ../src/guestfs-actions.pod:6447 ../src/guestfs-actions.pod:6485 ../src/guestfs-actions.pod:6523 ../src/guestfs-actions.pod:6575 ../src/guestfs-actions.pod:6627 ../src/guestfs-actions.pod:6674 ../src/guestfs-actions.pod:6717 ../src/guestfs-actions.pod:6745 ../src/guestfs-actions.pod:6762 ../src/guestfs-actions.pod:6780 ../src/guestfs-actions.pod:6917 ../src/guestfs-actions.pod:6974 ../src/guestfs-actions.pod:6996 ../src/guestfs-actions.pod:7014 ../src/guestfs-actions.pod:7066 ../src/guestfs-actions.pod:7132 ../src/guestfs-actions.pod:7149 ../src/guestfs-actions.pod:7162 ../src/guestfs-actions.pod:7176 ../src/guestfs-actions.pod:7465 ../src/guestfs-actions.pod:7480 ../src/guestfs-actions.pod:7501 ../src/guestfs-actions.pod:7517 ../src/guestfs-actions.pod:7529 ../src/guestfs-actions.pod:7543 ../src/guestfs-actions.pod:7555 ../src/guestfs-actions.pod:7569 ../src/guestfs-actions.pod:7585 ../src/guestfs-actions.pod:7603 ../src/guestfs-actions.pod:7622 ../src/guestfs-actions.pod:7641 ../src/guestfs-actions.pod:7671 ../src/guestfs-actions.pod:7689 ../src/guestfs-actions.pod:7712 ../src/guestfs-actions.pod:7751 ../src/guestfs-actions.pod:7790 ../src/guestfs-actions.pod:7815 ../src/guestfs-actions.pod:7834 ../src/guestfs-actions.pod:7856 ../src/guestfs-actions.pod:7877 ../src/guestfs-actions.pod:7896 ../src/guestfs-actions.pod:7913 ../src/guestfs-actions.pod:7934 ../src/guestfs-actions.pod:7962 ../src/guestfs-actions.pod:7986 ../src/guestfs-actions.pod:8005 ../src/guestfs-actions.pod:8021 ../src/guestfs-actions.pod:8045 ../src/guestfs-actions.pod:8064 ../src/guestfs-actions.pod:8079 ../src/guestfs-actions.pod:8098 ../src/guestfs-actions.pod:8142 ../src/guestfs-actions.pod:8169 ../src/guestfs-actions.pod:8199 ../src/guestfs-actions.pod:8311 ../src/guestfs-actions.pod:8432 ../src/guestfs-actions.pod:8444 ../src/guestfs-actions.pod:8457 ../src/guestfs-actions.pod:8470 ../src/guestfs-actions.pod:8492 ../src/guestfs-actions.pod:8505 ../src/guestfs-actions.pod:8518 ../src/guestfs-actions.pod:8531 ../src/guestfs-actions.pod:8546 ../src/guestfs-actions.pod:8605 ../src/guestfs-actions.pod:8622 ../src/guestfs-actions.pod:8638 ../src/guestfs-actions.pod:8654 ../src/guestfs-actions.pod:8671 ../src/guestfs-actions.pod:8684 ../src/guestfs-actions.pod:8704 ../src/guestfs-actions.pod:8804 ../src/guestfs-actions.pod:8862 ../src/guestfs-actions.pod:8876 ../src/guestfs-actions.pod:8917 ../src/guestfs-actions.pod:8930 ../src/guestfs-actions.pod:8952 ../src/guestfs-actions.pod:8990 ../src/guestfs-actions.pod:9024 ../src/guestfs-actions.pod:9060 ../src/guestfs-actions.pod:9176 ../src/guestfs-actions.pod:9191 ../src/guestfs-actions.pod:9205 ../src/guestfs-actions.pod:9279 ../src/guestfs-actions.pod:9292 ../src/guestfs-actions.pod:9337 ../src/guestfs-actions.pod:9377 ../src/guestfs-actions.pod:9435 ../src/guestfs-actions.pod:9452 ../src/guestfs-actions.pod:9472 ../src/guestfs-actions.pod:9505 ../src/guestfs-actions.pod:9569 ../src/guestfs-actions.pod:9592 ../src/guestfs-actions.pod:9616 ../src/guestfs-actions.pod:9642 +#: ../src/guestfs-actions.pod:37 ../src/guestfs-actions.pod:187 ../src/guestfs-actions.pod:254 ../src/guestfs-actions.pod:291 ../src/guestfs-actions.pod:312 ../src/guestfs-actions.pod:333 ../src/guestfs-actions.pod:346 ../src/guestfs-actions.pod:360 ../src/guestfs-actions.pod:480 ../src/guestfs-actions.pod:500 ../src/guestfs-actions.pod:514 ../src/guestfs-actions.pod:559 ../src/guestfs-actions.pod:587 ../src/guestfs-actions.pod:605 ../src/guestfs-actions.pod:672 ../src/guestfs-actions.pod:705 ../src/guestfs-actions.pod:719 ../src/guestfs-actions.pod:775 ../src/guestfs-actions.pod:874 ../src/guestfs-actions.pod:892 ../src/guestfs-actions.pod:906 ../src/guestfs-actions.pod:920 ../src/guestfs-actions.pod:934 ../src/guestfs-actions.pod:948 ../src/guestfs-actions.pod:961 ../src/guestfs-actions.pod:998 ../src/guestfs-actions.pod:1032 ../src/guestfs-actions.pod:1054 ../src/guestfs-actions.pod:1090 ../src/guestfs-actions.pod:1103 ../src/guestfs-actions.pod:1115 ../src/guestfs-actions.pod:1145 ../src/guestfs-actions.pod:1160 ../src/guestfs-actions.pod:1321 ../src/guestfs-actions.pod:1341 ../src/guestfs-actions.pod:1359 ../src/guestfs-actions.pod:1449 ../src/guestfs-actions.pod:1508 ../src/guestfs-actions.pod:1554 ../src/guestfs-actions.pod:1594 ../src/guestfs-actions.pod:1647 ../src/guestfs-actions.pod:1700 ../src/guestfs-actions.pod:1758 ../src/guestfs-actions.pod:1812 ../src/guestfs-actions.pod:1831 ../src/guestfs-actions.pod:1845 ../src/guestfs-actions.pod:1873 ../src/guestfs-actions.pod:1959 ../src/guestfs-actions.pod:1990 ../src/guestfs-actions.pod:2015 ../src/guestfs-actions.pod:2081 ../src/guestfs-actions.pod:2124 ../src/guestfs-actions.pod:2237 ../src/guestfs-actions.pod:2264 ../src/guestfs-actions.pod:2479 ../src/guestfs-actions.pod:2501 ../src/guestfs-actions.pod:2588 ../src/guestfs-actions.pod:3239 ../src/guestfs-actions.pod:3383 ../src/guestfs-actions.pod:3442 ../src/guestfs-actions.pod:3477 ../src/guestfs-actions.pod:4590 ../src/guestfs-actions.pod:4605 ../src/guestfs-actions.pod:4630 ../src/guestfs-actions.pod:4848 ../src/guestfs-actions.pod:4862 ../src/guestfs-actions.pod:4875 ../src/guestfs-actions.pod:4889 ../src/guestfs-actions.pod:4904 ../src/guestfs-actions.pod:4940 ../src/guestfs-actions.pod:5012 ../src/guestfs-actions.pod:5032 ../src/guestfs-actions.pod:5049 ../src/guestfs-actions.pod:5069 ../src/guestfs-actions.pod:5089 ../src/guestfs-actions.pod:5124 ../src/guestfs-actions.pod:5143 ../src/guestfs-actions.pod:5162 ../src/guestfs-actions.pod:5179 ../src/guestfs-actions.pod:5214 ../src/guestfs-actions.pod:5226 ../src/guestfs-actions.pod:5259 ../src/guestfs-actions.pod:5275 ../src/guestfs-actions.pod:5288 ../src/guestfs-actions.pod:5303 ../src/guestfs-actions.pod:5320 ../src/guestfs-actions.pod:5478 ../src/guestfs-actions.pod:5614 ../src/guestfs-actions.pod:5626 ../src/guestfs-actions.pod:5646 ../src/guestfs-actions.pod:5659 ../src/guestfs-actions.pod:5710 ../src/guestfs-actions.pod:5728 ../src/guestfs-actions.pod:5746 ../src/guestfs-actions.pod:5762 ../src/guestfs-actions.pod:5776 ../src/guestfs-actions.pod:5790 ../src/guestfs-actions.pod:5807 ../src/guestfs-actions.pod:5822 ../src/guestfs-actions.pod:5849 ../src/guestfs-actions.pod:5882 ../src/guestfs-actions.pod:5967 ../src/guestfs-actions.pod:6040 ../src/guestfs-actions.pod:6071 ../src/guestfs-actions.pod:6090 ../src/guestfs-actions.pod:6109 ../src/guestfs-actions.pod:6121 ../src/guestfs-actions.pod:6138 ../src/guestfs-actions.pod:6151 ../src/guestfs-actions.pod:6166 ../src/guestfs-actions.pod:6181 ../src/guestfs-actions.pod:6213 ../src/guestfs-actions.pod:6239 ../src/guestfs-actions.pod:6308 ../src/guestfs-actions.pod:6357 ../src/guestfs-actions.pod:6372 ../src/guestfs-actions.pod:6392 ../src/guestfs-actions.pod:6406 ../src/guestfs-actions.pod:6423 ../src/guestfs-actions.pod:6472 ../src/guestfs-actions.pod:6524 ../src/guestfs-actions.pod:6562 ../src/guestfs-actions.pod:6614 ../src/guestfs-actions.pod:6666 ../src/guestfs-actions.pod:6713 ../src/guestfs-actions.pod:6756 ../src/guestfs-actions.pod:6784 ../src/guestfs-actions.pod:6801 ../src/guestfs-actions.pod:6819 ../src/guestfs-actions.pod:6956 ../src/guestfs-actions.pod:7013 ../src/guestfs-actions.pod:7035 ../src/guestfs-actions.pod:7053 ../src/guestfs-actions.pod:7105 ../src/guestfs-actions.pod:7171 ../src/guestfs-actions.pod:7188 ../src/guestfs-actions.pod:7201 ../src/guestfs-actions.pod:7215 ../src/guestfs-actions.pod:7504 ../src/guestfs-actions.pod:7519 ../src/guestfs-actions.pod:7540 ../src/guestfs-actions.pod:7556 ../src/guestfs-actions.pod:7568 ../src/guestfs-actions.pod:7582 ../src/guestfs-actions.pod:7594 ../src/guestfs-actions.pod:7608 ../src/guestfs-actions.pod:7624 ../src/guestfs-actions.pod:7642 ../src/guestfs-actions.pod:7661 ../src/guestfs-actions.pod:7680 ../src/guestfs-actions.pod:7710 ../src/guestfs-actions.pod:7728 ../src/guestfs-actions.pod:7751 ../src/guestfs-actions.pod:7790 ../src/guestfs-actions.pod:7829 ../src/guestfs-actions.pod:7854 ../src/guestfs-actions.pod:7873 ../src/guestfs-actions.pod:7895 ../src/guestfs-actions.pod:7916 ../src/guestfs-actions.pod:7935 ../src/guestfs-actions.pod:7952 ../src/guestfs-actions.pod:7973 ../src/guestfs-actions.pod:8001 ../src/guestfs-actions.pod:8025 ../src/guestfs-actions.pod:8044 ../src/guestfs-actions.pod:8060 ../src/guestfs-actions.pod:8084 ../src/guestfs-actions.pod:8103 ../src/guestfs-actions.pod:8118 ../src/guestfs-actions.pod:8137 ../src/guestfs-actions.pod:8181 ../src/guestfs-actions.pod:8208 ../src/guestfs-actions.pod:8238 ../src/guestfs-actions.pod:8363 ../src/guestfs-actions.pod:8373 ../src/guestfs-actions.pod:8494 ../src/guestfs-actions.pod:8506 ../src/guestfs-actions.pod:8519 ../src/guestfs-actions.pod:8532 ../src/guestfs-actions.pod:8554 ../src/guestfs-actions.pod:8567 ../src/guestfs-actions.pod:8580 ../src/guestfs-actions.pod:8593 ../src/guestfs-actions.pod:8608 ../src/guestfs-actions.pod:8667 ../src/guestfs-actions.pod:8684 ../src/guestfs-actions.pod:8700 ../src/guestfs-actions.pod:8716 ../src/guestfs-actions.pod:8733 ../src/guestfs-actions.pod:8746 ../src/guestfs-actions.pod:8766 ../src/guestfs-actions.pod:8866 ../src/guestfs-actions.pod:8924 ../src/guestfs-actions.pod:8938 ../src/guestfs-actions.pod:8979 ../src/guestfs-actions.pod:8992 ../src/guestfs-actions.pod:9014 ../src/guestfs-actions.pod:9052 ../src/guestfs-actions.pod:9086 ../src/guestfs-actions.pod:9122 ../src/guestfs-actions.pod:9238 ../src/guestfs-actions.pod:9253 ../src/guestfs-actions.pod:9267 ../src/guestfs-actions.pod:9341 ../src/guestfs-actions.pod:9354 ../src/guestfs-actions.pod:9399 ../src/guestfs-actions.pod:9439 ../src/guestfs-actions.pod:9497 ../src/guestfs-actions.pod:9514 ../src/guestfs-actions.pod:9534 ../src/guestfs-actions.pod:9567 ../src/guestfs-actions.pod:9631 ../src/guestfs-actions.pod:9654 ../src/guestfs-actions.pod:9678 ../src/guestfs-actions.pod:9704 msgid "This function returns 0 on success or -1 on error." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:189 ../src/guestfs-actions.pod:1556 ../src/guestfs-actions.pod:2686 ../src/guestfs-actions.pod:2923 ../src/guestfs-actions.pod:3048 ../src/guestfs-actions.pod:4567 ../src/guestfs-actions.pod:4587 ../src/guestfs-actions.pod:6190 ../src/guestfs-actions.pod:7691 ../src/guestfs-actions.pod:7915 ../src/guestfs-actions.pod:8066 ../src/guestfs-actions.pod:8548 ../src/guestfs-actions.pod:8673 ../src/guestfs-actions.pod:9379 +#: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:189 ../src/guestfs-actions.pod:1556 ../src/guestfs-actions.pod:2702 ../src/guestfs-actions.pod:2939 ../src/guestfs-actions.pod:3064 ../src/guestfs-actions.pod:4592 ../src/guestfs-actions.pod:4612 ../src/guestfs-actions.pod:6215 ../src/guestfs-actions.pod:7730 ../src/guestfs-actions.pod:7954 ../src/guestfs-actions.pod:8105 ../src/guestfs-actions.pod:8610 ../src/guestfs-actions.pod:8735 ../src/guestfs-actions.pod:9441 msgid "(Added in 0.3)" msgstr "" @@ -28746,7 +28866,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:198 ../src/guestfs-actions.pod:972 ../src/guestfs-actions.pod:1043 ../src/guestfs-actions.pod:1436 ../src/guestfs-actions.pod:1488 ../src/guestfs-actions.pod:1566 ../src/guestfs-actions.pod:1635 ../src/guestfs-actions.pod:1688 ../src/guestfs-actions.pod:1741 ../src/guestfs-actions.pod:2035 ../src/guestfs-actions.pod:3730 ../src/guestfs-actions.pod:5388 ../src/guestfs-actions.pod:5835 ../src/guestfs-actions.pod:5891 ../src/guestfs-actions.pod:6200 ../src/guestfs-actions.pod:6249 ../src/guestfs-actions.pod:6497 ../src/guestfs-actions.pod:6558 ../src/guestfs-actions.pod:6638 ../src/guestfs-actions.pod:7724 ../src/guestfs-actions.pod:8715 ../src/guestfs-actions.pod:8940 +#: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:198 ../src/guestfs-actions.pod:972 ../src/guestfs-actions.pod:1043 ../src/guestfs-actions.pod:1436 ../src/guestfs-actions.pod:1488 ../src/guestfs-actions.pod:1566 ../src/guestfs-actions.pod:1635 ../src/guestfs-actions.pod:1688 ../src/guestfs-actions.pod:1741 ../src/guestfs-actions.pod:2051 ../src/guestfs-actions.pod:3746 ../src/guestfs-actions.pod:5413 ../src/guestfs-actions.pod:5860 ../src/guestfs-actions.pod:5916 ../src/guestfs-actions.pod:6225 ../src/guestfs-actions.pod:6274 ../src/guestfs-actions.pod:6536 ../src/guestfs-actions.pod:6597 ../src/guestfs-actions.pod:6677 ../src/guestfs-actions.pod:7763 ../src/guestfs-actions.pod:8777 ../src/guestfs-actions.pod:9002 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 " @@ -28783,7 +28903,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:144 ../src/guestfs-actions.pod:403 ../src/guestfs-actions.pod:573 ../src/guestfs-actions.pod:792 ../src/guestfs-actions.pod:823 ../src/guestfs-actions.pod:841 ../src/guestfs-actions.pod:860 ../src/guestfs-actions.pod:2019 ../src/guestfs-actions.pod:2442 ../src/guestfs-actions.pod:2645 ../src/guestfs-actions.pod:2834 ../src/guestfs-actions.pod:2895 ../src/guestfs-actions.pod:2946 ../src/guestfs-actions.pod:2998 ../src/guestfs-actions.pod:3012 ../src/guestfs-actions.pod:3035 ../src/guestfs-actions.pod:3354 ../src/guestfs-actions.pod:3848 ../src/guestfs-actions.pod:3866 ../src/guestfs-actions.pod:6470 ../src/guestfs-actions.pod:6814 ../src/guestfs-actions.pod:7052 ../src/guestfs-actions.pod:7246 ../src/guestfs-actions.pod:7272 ../src/guestfs-actions.pod:8903 ../src/guestfs-actions.pod:9390 ../src/guestfs-actions.pod:9403 ../src/guestfs-actions.pod:9416 +#: ../src/guestfs-actions.pod:144 ../src/guestfs-actions.pod:403 ../src/guestfs-actions.pod:573 ../src/guestfs-actions.pod:792 ../src/guestfs-actions.pod:823 ../src/guestfs-actions.pod:841 ../src/guestfs-actions.pod:860 ../src/guestfs-actions.pod:1891 ../src/guestfs-actions.pod:2035 ../src/guestfs-actions.pod:2458 ../src/guestfs-actions.pod:2661 ../src/guestfs-actions.pod:2850 ../src/guestfs-actions.pod:2911 ../src/guestfs-actions.pod:2962 ../src/guestfs-actions.pod:3014 ../src/guestfs-actions.pod:3028 ../src/guestfs-actions.pod:3051 ../src/guestfs-actions.pod:3370 ../src/guestfs-actions.pod:3864 ../src/guestfs-actions.pod:3882 ../src/guestfs-actions.pod:6488 ../src/guestfs-actions.pod:6509 ../src/guestfs-actions.pod:6853 ../src/guestfs-actions.pod:7091 ../src/guestfs-actions.pod:7285 ../src/guestfs-actions.pod:7311 ../src/guestfs-actions.pod:8965 ../src/guestfs-actions.pod:9452 ../src/guestfs-actions.pod:9465 ../src/guestfs-actions.pod:9478 msgid "On error this function returns -1." msgstr "" @@ -28814,7 +28934,7 @@ msgid "This is the \"va_list variant\" of L</guestfs_add_domain>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:157 ../src/guestfs-actions.pod:168 ../src/guestfs-actions.pod:267 ../src/guestfs-actions.pod:278 ../src/guestfs-actions.pod:1011 ../src/guestfs-actions.pod:1022 ../src/guestfs-actions.pod:1067 ../src/guestfs-actions.pod:1078 ../src/guestfs-actions.pod:1464 ../src/guestfs-actions.pod:1477 ../src/guestfs-actions.pod:1523 ../src/guestfs-actions.pod:1536 ../src/guestfs-actions.pod:1613 ../src/guestfs-actions.pod:1625 ../src/guestfs-actions.pod:1666 ../src/guestfs-actions.pod:1678 ../src/guestfs-actions.pod:1719 ../src/guestfs-actions.pod:1731 ../src/guestfs-actions.pod:1777 ../src/guestfs-actions.pod:1789 ../src/guestfs-actions.pod:2078 ../src/guestfs-actions.pod:2089 ../src/guestfs-actions.pod:3814 ../src/guestfs-actions.pod:3826 ../src/guestfs-actions.pod:5467 ../src/guestfs-actions.pod:5479 ../src/guestfs-actions.pod:5870 ../src/guestfs-actions.pod:5881 ../src/guestfs-actions.pod:5956 ../src/guestfs-actions.pod:5968 ../src/guestfs-actions.pod:6228 ../src/guestfs-actions.pod:6240 ../src/guestfs-actions.pod:6296 ../src/guestfs-actions.pod:6307 ../src/guestfs-actions.pod:6537 ../src/guestfs-actions.pod:6549 ../src/guestfs-actions.pod:6588 ../src/guestfs-actions.pod:6599 ../src/guestfs-actions.pod:6687 ../src/guestfs-actions.pod:6698 ../src/guestfs-actions.pod:7765 ../src/guestfs-actions.pod:7777 ../src/guestfs-actions.pod:8817 ../src/guestfs-actions.pod:8828 ../src/guestfs-actions.pod:8964 ../src/guestfs-actions.pod:8974 +#: ../src/guestfs-actions.pod:157 ../src/guestfs-actions.pod:168 ../src/guestfs-actions.pod:267 ../src/guestfs-actions.pod:278 ../src/guestfs-actions.pod:1011 ../src/guestfs-actions.pod:1022 ../src/guestfs-actions.pod:1067 ../src/guestfs-actions.pod:1078 ../src/guestfs-actions.pod:1464 ../src/guestfs-actions.pod:1477 ../src/guestfs-actions.pod:1523 ../src/guestfs-actions.pod:1536 ../src/guestfs-actions.pod:1613 ../src/guestfs-actions.pod:1625 ../src/guestfs-actions.pod:1666 ../src/guestfs-actions.pod:1678 ../src/guestfs-actions.pod:1719 ../src/guestfs-actions.pod:1731 ../src/guestfs-actions.pod:1777 ../src/guestfs-actions.pod:1789 ../src/guestfs-actions.pod:2094 ../src/guestfs-actions.pod:2105 ../src/guestfs-actions.pod:3830 ../src/guestfs-actions.pod:3842 ../src/guestfs-actions.pod:5492 ../src/guestfs-actions.pod:5504 ../src/guestfs-actions.pod:5895 ../src/guestfs-actions.pod:5906 ../src/guestfs-actions.pod:5981 ../src/guestfs-actions.pod:5993 ../src/guestfs-actions.pod:6253 ../src/guestfs-actions.pod:6265 ../src/guestfs-actions.pod:6321 ../src/guestfs-actions.pod:6332 ../src/guestfs-actions.pod:6576 ../src/guestfs-actions.pod:6588 ../src/guestfs-actions.pod:6627 ../src/guestfs-actions.pod:6638 ../src/guestfs-actions.pod:6726 ../src/guestfs-actions.pod:6737 ../src/guestfs-actions.pod:7804 ../src/guestfs-actions.pod:7816 ../src/guestfs-actions.pod:8879 ../src/guestfs-actions.pod:8890 ../src/guestfs-actions.pod:9026 ../src/guestfs-actions.pod:9036 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>." msgstr "" @@ -29014,7 +29134,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:314 ../src/guestfs-actions.pod:335 ../src/guestfs-actions.pod:3313 +#: ../src/guestfs-actions.pod:314 ../src/guestfs-actions.pod:335 ../src/guestfs-actions.pod:3329 msgid "(Added in 1.0.84)" msgstr "" @@ -29057,7 +29177,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:348 ../src/guestfs-actions.pod:3037 +#: ../src/guestfs-actions.pod:348 ../src/guestfs-actions.pod:3053 msgid "(Added in 1.3.4)" msgstr "" @@ -29084,7 +29204,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:362 ../src/guestfs-actions.pod:387 ../src/guestfs-actions.pod:405 ../src/guestfs-actions.pod:419 ../src/guestfs-actions.pod:482 ../src/guestfs-actions.pod:502 ../src/guestfs-actions.pod:516 ../src/guestfs-actions.pod:547 ../src/guestfs-actions.pod:561 ../src/guestfs-actions.pod:575 ../src/guestfs-actions.pod:589 ../src/guestfs-actions.pod:607 ../src/guestfs-actions.pod:7323 +#: ../src/guestfs-actions.pod:362 ../src/guestfs-actions.pod:387 ../src/guestfs-actions.pod:405 ../src/guestfs-actions.pod:419 ../src/guestfs-actions.pod:482 ../src/guestfs-actions.pod:502 ../src/guestfs-actions.pod:516 ../src/guestfs-actions.pod:547 ../src/guestfs-actions.pod:561 ../src/guestfs-actions.pod:575 ../src/guestfs-actions.pod:589 ../src/guestfs-actions.pod:607 ../src/guestfs-actions.pod:7362 msgid "(Added in 0.7)" msgstr "" @@ -29152,7 +29272,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:416 ../src/guestfs-actions.pod:1202 ../src/guestfs-actions.pod:1220 ../src/guestfs-actions.pod:1280 ../src/guestfs-actions.pod:1296 ../src/guestfs-actions.pod:1399 ../src/guestfs-actions.pod:1888 ../src/guestfs-actions.pod:1905 ../src/guestfs-actions.pod:1924 ../src/guestfs-actions.pod:2125 ../src/guestfs-actions.pod:2313 ../src/guestfs-actions.pod:2425 ../src/guestfs-actions.pod:2588 ../src/guestfs-actions.pod:2605 ../src/guestfs-actions.pod:2672 ../src/guestfs-actions.pod:2813 ../src/guestfs-actions.pod:2854 ../src/guestfs-actions.pod:2875 ../src/guestfs-actions.pod:3060 ../src/guestfs-actions.pod:3278 ../src/guestfs-actions.pod:3480 ../src/guestfs-actions.pod:3594 ../src/guestfs-actions.pod:3698 ../src/guestfs-actions.pod:3717 ../src/guestfs-actions.pod:3932 ../src/guestfs-actions.pod:3960 ../src/guestfs-actions.pod:3981 ../src/guestfs-actions.pod:4015 ../src/guestfs-actions.pod:4086 ../src/guestfs-actions.pod:4106 ../src/guestfs-actions.pod:4126 ../src/guestfs-actions.pod:4793 ../src/guestfs-actions.pod:4809 ../src/guestfs-actions.pod:5173 ../src/guestfs-actions.pod:5340 ../src/guestfs-actions.pod:5663 ../src/guestfs-actions.pod:6832 ../src/guestfs-actions.pod:7033 ../src/guestfs-actions.pod:7221 ../src/guestfs-actions.pod:7399 ../src/guestfs-actions.pod:7448 ../src/guestfs-actions.pod:8217 ../src/guestfs-actions.pod:8233 ../src/guestfs-actions.pod:8257 ../src/guestfs-actions.pod:8281 ../src/guestfs-actions.pod:9119 ../src/guestfs-actions.pod:9138 ../src/guestfs-actions.pod:9156 ../src/guestfs-actions.pod:9349 ../src/guestfs-actions.pod:9706 +#: ../src/guestfs-actions.pod:416 ../src/guestfs-actions.pod:1202 ../src/guestfs-actions.pod:1220 ../src/guestfs-actions.pod:1280 ../src/guestfs-actions.pod:1296 ../src/guestfs-actions.pod:1399 ../src/guestfs-actions.pod:1904 ../src/guestfs-actions.pod:1921 ../src/guestfs-actions.pod:1940 ../src/guestfs-actions.pod:2141 ../src/guestfs-actions.pod:2329 ../src/guestfs-actions.pod:2441 ../src/guestfs-actions.pod:2604 ../src/guestfs-actions.pod:2621 ../src/guestfs-actions.pod:2688 ../src/guestfs-actions.pod:2829 ../src/guestfs-actions.pod:2870 ../src/guestfs-actions.pod:2891 ../src/guestfs-actions.pod:3076 ../src/guestfs-actions.pod:3294 ../src/guestfs-actions.pod:3496 ../src/guestfs-actions.pod:3610 ../src/guestfs-actions.pod:3714 ../src/guestfs-actions.pod:3733 ../src/guestfs-actions.pod:3948 ../src/guestfs-actions.pod:3976 ../src/guestfs-actions.pod:3997 ../src/guestfs-actions.pod:4031 ../src/guestfs-actions.pod:4102 ../src/guestfs-actions.pod:4122 ../src/guestfs-actions.pod:4142 ../src/guestfs-actions.pod:4818 ../src/guestfs-actions.pod:4834 ../src/guestfs-actions.pod:5198 ../src/guestfs-actions.pod:5365 ../src/guestfs-actions.pod:5688 ../src/guestfs-actions.pod:6871 ../src/guestfs-actions.pod:7072 ../src/guestfs-actions.pod:7260 ../src/guestfs-actions.pod:7438 ../src/guestfs-actions.pod:7487 ../src/guestfs-actions.pod:8256 ../src/guestfs-actions.pod:8272 ../src/guestfs-actions.pod:8296 ../src/guestfs-actions.pod:8320 ../src/guestfs-actions.pod:9181 ../src/guestfs-actions.pod:9200 ../src/guestfs-actions.pod:9218 ../src/guestfs-actions.pod:9411 ../src/guestfs-actions.pod:9768 msgid "" "This function returns a string, or NULL on error. I<The caller must free " "the returned string after use>." @@ -29252,7 +29372,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:527 ../src/guestfs-actions.pod:543 ../src/guestfs-actions.pod:689 ../src/guestfs-actions.pod:1418 ../src/guestfs-actions.pod:2140 ../src/guestfs-actions.pod:2159 ../src/guestfs-actions.pod:2262 ../src/guestfs-actions.pod:2281 ../src/guestfs-actions.pod:2527 ../src/guestfs-actions.pod:3136 ../src/guestfs-actions.pod:3152 ../src/guestfs-actions.pod:3171 ../src/guestfs-actions.pod:3236 ../src/guestfs-actions.pod:3260 ../src/guestfs-actions.pod:3331 ../src/guestfs-actions.pod:3380 ../src/guestfs-actions.pod:3659 ../src/guestfs-actions.pod:4034 ../src/guestfs-actions.pod:4322 ../src/guestfs-actions.pod:4663 ../src/guestfs-actions.pod:4680 ../src/guestfs-actions.pod:4700 ../src/guestfs-actions.pod:4755 ../src/guestfs-actions.pod:4775 ../src/guestfs-actions.pod:4896 ../src/guestfs-actions.pod:5312 ../src/guestfs-actions.pod:6431 ../src/guestfs-actions.pod:7193 ../src/guestfs-actions.pod:7319 ../src/guestfs-actions.pod:7433 ../src/guestfs-actions.pod:8297 ../src/guestfs-actions.pod:8358 ../src/guestfs-actions.pod:8413 ../src/guestfs-actions.pod:8559 ../src/guestfs-actions.pod:8583 ../src/guestfs-actions.pod:9223 ../src/guestfs-actions.pod:9262 ../src/guestfs-actions.pod:9309 ../src/guestfs-actions.pod:9522 ../src/guestfs-actions.pod:9541 ../src/guestfs-actions.pod:9656 ../src/guestfs-actions.pod:9675 ../src/guestfs-actions.pod:9721 ../src/guestfs-actions.pod:9740 +#: ../src/guestfs-actions.pod:527 ../src/guestfs-actions.pod:543 ../src/guestfs-actions.pod:689 ../src/guestfs-actions.pod:1418 ../src/guestfs-actions.pod:2156 ../src/guestfs-actions.pod:2175 ../src/guestfs-actions.pod:2278 ../src/guestfs-actions.pod:2297 ../src/guestfs-actions.pod:2543 ../src/guestfs-actions.pod:3152 ../src/guestfs-actions.pod:3168 ../src/guestfs-actions.pod:3187 ../src/guestfs-actions.pod:3252 ../src/guestfs-actions.pod:3276 ../src/guestfs-actions.pod:3347 ../src/guestfs-actions.pod:3396 ../src/guestfs-actions.pod:3675 ../src/guestfs-actions.pod:4050 ../src/guestfs-actions.pod:4338 ../src/guestfs-actions.pod:4688 ../src/guestfs-actions.pod:4705 ../src/guestfs-actions.pod:4725 ../src/guestfs-actions.pod:4780 ../src/guestfs-actions.pod:4800 ../src/guestfs-actions.pod:4921 ../src/guestfs-actions.pod:5337 ../src/guestfs-actions.pod:6456 ../src/guestfs-actions.pod:7232 ../src/guestfs-actions.pod:7358 ../src/guestfs-actions.pod:7472 ../src/guestfs-actions.pod:8336 ../src/guestfs-actions.pod:8420 ../src/guestfs-actions.pod:8475 ../src/guestfs-actions.pod:8621 ../src/guestfs-actions.pod:8645 ../src/guestfs-actions.pod:9285 ../src/guestfs-actions.pod:9324 ../src/guestfs-actions.pod:9371 ../src/guestfs-actions.pod:9584 ../src/guestfs-actions.pod:9603 ../src/guestfs-actions.pod:9718 ../src/guestfs-actions.pod:9737 ../src/guestfs-actions.pod:9783 ../src/guestfs-actions.pod:9802 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 " @@ -29260,7 +29380,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:531 ../src/guestfs-actions.pod:1343 ../src/guestfs-actions.pod:1361 ../src/guestfs-actions.pod:2197 ../src/guestfs-actions.pod:4386 ../src/guestfs-actions.pod:4417 ../src/guestfs-actions.pod:5139 ../src/guestfs-actions.pod:5203 ../src/guestfs-actions.pod:5603 ../src/guestfs-actions.pod:5636 ../src/guestfs-actions.pod:5799 ../src/guestfs-actions.pod:6435 ../src/guestfs-actions.pod:7134 ../src/guestfs-actions.pod:7531 ../src/guestfs-actions.pod:7545 ../src/guestfs-actions.pod:7557 ../src/guestfs-actions.pod:8144 ../src/guestfs-actions.pod:8919 ../src/guestfs-actions.pod:8932 ../src/guestfs-actions.pod:9207 ../src/guestfs-actions.pod:9510 +#: ../src/guestfs-actions.pod:531 ../src/guestfs-actions.pod:1343 ../src/guestfs-actions.pod:1361 ../src/guestfs-actions.pod:2213 ../src/guestfs-actions.pod:4402 ../src/guestfs-actions.pod:4433 ../src/guestfs-actions.pod:5164 ../src/guestfs-actions.pod:5228 ../src/guestfs-actions.pod:5628 ../src/guestfs-actions.pod:5661 ../src/guestfs-actions.pod:5824 ../src/guestfs-actions.pod:6460 ../src/guestfs-actions.pod:7173 ../src/guestfs-actions.pod:7570 ../src/guestfs-actions.pod:7584 ../src/guestfs-actions.pod:7596 ../src/guestfs-actions.pod:8183 ../src/guestfs-actions.pod:8981 ../src/guestfs-actions.pod:8994 ../src/guestfs-actions.pod:9269 ../src/guestfs-actions.pod:9572 msgid "(Added in 0.8)" msgstr "" @@ -29482,7 +29602,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:756 ../src/guestfs-actions.pod:3634 ../src/guestfs-actions.pod:3902 ../src/guestfs-actions.pod:4740 ../src/guestfs-actions.pod:5515 ../src/guestfs-actions.pod:6411 ../src/guestfs-actions.pod:8844 +#: ../src/guestfs-actions.pod:756 ../src/guestfs-actions.pod:3650 ../src/guestfs-actions.pod:3918 ../src/guestfs-actions.pod:4765 ../src/guestfs-actions.pod:5540 ../src/guestfs-actions.pod:6436 ../src/guestfs-actions.pod:8906 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 " @@ -29546,7 +29666,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:807 ../src/guestfs-actions.pod:2180 ../src/guestfs-actions.pod:2195 ../src/guestfs-actions.pod:2684 ../src/guestfs-actions.pod:2695 ../src/guestfs-actions.pod:2906 ../src/guestfs-actions.pod:2932 ../src/guestfs-actions.pod:2972 ../src/guestfs-actions.pod:2987 ../src/guestfs-actions.pod:3023 ../src/guestfs-actions.pod:3046 ../src/guestfs-actions.pod:4143 ../src/guestfs-actions.pod:4159 ../src/guestfs-actions.pod:4177 ../src/guestfs-actions.pod:4339 ../src/guestfs-actions.pod:4354 ../src/guestfs-actions.pod:4368 ../src/guestfs-actions.pod:4384 ../src/guestfs-actions.pod:4399 ../src/guestfs-actions.pod:4415 ../src/guestfs-actions.pod:4429 ../src/guestfs-actions.pod:4442 ../src/guestfs-actions.pod:4456 ../src/guestfs-actions.pod:4471 ../src/guestfs-actions.pod:4486 ../src/guestfs-actions.pod:4499 ../src/guestfs-actions.pod:4513 ../src/guestfs-actions.pod:6796 +#: ../src/guestfs-actions.pod:807 ../src/guestfs-actions.pod:2196 ../src/guestfs-actions.pod:2211 ../src/guestfs-actions.pod:2700 ../src/guestfs-actions.pod:2711 ../src/guestfs-actions.pod:2922 ../src/guestfs-actions.pod:2948 ../src/guestfs-actions.pod:2988 ../src/guestfs-actions.pod:3003 ../src/guestfs-actions.pod:3039 ../src/guestfs-actions.pod:3062 ../src/guestfs-actions.pod:4159 ../src/guestfs-actions.pod:4175 ../src/guestfs-actions.pod:4193 ../src/guestfs-actions.pod:4355 ../src/guestfs-actions.pod:4370 ../src/guestfs-actions.pod:4384 ../src/guestfs-actions.pod:4400 ../src/guestfs-actions.pod:4415 ../src/guestfs-actions.pod:4431 ../src/guestfs-actions.pod:4445 ../src/guestfs-actions.pod:4458 ../src/guestfs-actions.pod:4472 ../src/guestfs-actions.pod:4487 ../src/guestfs-actions.pod:4502 ../src/guestfs-actions.pod:4515 ../src/guestfs-actions.pod:4529 ../src/guestfs-actions.pod:6835 msgid "This function returns a C truth value on success or -1 on error." msgstr "" @@ -30023,7 +30143,7 @@ msgid "See also C<guestfs_realpath>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1205 ../src/guestfs-actions.pod:9141 +#: ../src/guestfs-actions.pod:1205 ../src/guestfs-actions.pod:9203 msgid "(Added in 1.0.75)" msgstr "" @@ -30052,7 +30172,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1226 ../src/guestfs-actions.pod:4684 ../src/guestfs-actions.pod:4779 ../src/guestfs-actions.pod:4796 ../src/guestfs-actions.pod:4900 ../src/guestfs-actions.pod:5316 ../src/guestfs-actions.pod:5330 ../src/guestfs-actions.pod:7197 ../src/guestfs-actions.pod:7211 ../src/guestfs-actions.pod:9313 ../src/guestfs-actions.pod:9327 +#: ../src/guestfs-actions.pod:1226 ../src/guestfs-actions.pod:4709 ../src/guestfs-actions.pod:4804 ../src/guestfs-actions.pod:4821 ../src/guestfs-actions.pod:4925 ../src/guestfs-actions.pod:5341 ../src/guestfs-actions.pod:5355 ../src/guestfs-actions.pod:7236 ../src/guestfs-actions.pod:7250 ../src/guestfs-actions.pod:9375 ../src/guestfs-actions.pod:9389 msgid "(Added in 0.4)" msgstr "" @@ -30083,7 +30203,7 @@ msgid "To get the checksums for many files, use C<guestfs_checksums_out>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1283 ../src/guestfs-actions.pod:1950 ../src/guestfs-actions.pod:3014 ../src/guestfs-actions.pod:4370 ../src/guestfs-actions.pod:4431 ../src/guestfs-actions.pod:4458 ../src/guestfs-actions.pod:8997 +#: ../src/guestfs-actions.pod:1283 ../src/guestfs-actions.pod:1966 ../src/guestfs-actions.pod:3030 ../src/guestfs-actions.pod:4386 ../src/guestfs-actions.pod:4447 ../src/guestfs-actions.pod:4474 ../src/guestfs-actions.pod:9059 msgid "(Added in 1.0.2)" msgstr "" @@ -30112,7 +30232,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1299 ../src/guestfs-actions.pod:6629 ../src/guestfs-actions.pod:6764 ../src/guestfs-actions.pod:6798 ../src/guestfs-actions.pod:6816 ../src/guestfs-actions.pod:6998 ../src/guestfs-actions.pod:8864 ../src/guestfs-actions.pod:8878 ../src/guestfs-actions.pod:9339 +#: ../src/guestfs-actions.pod:1299 ../src/guestfs-actions.pod:6668 ../src/guestfs-actions.pod:6803 ../src/guestfs-actions.pod:6837 ../src/guestfs-actions.pod:6855 ../src/guestfs-actions.pod:7037 ../src/guestfs-actions.pod:8926 ../src/guestfs-actions.pod:8940 ../src/guestfs-actions.pod:9401 msgid "(Added in 1.3.2)" msgstr "" @@ -30197,7 +30317,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1405 ../src/guestfs-actions.pod:1425 ../src/guestfs-actions.pod:2316 +#: ../src/guestfs-actions.pod:1405 ../src/guestfs-actions.pod:1425 ../src/guestfs-actions.pod:2332 msgid "(Added in 0.9.1)" msgstr "" @@ -30262,7 +30382,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1451 ../src/guestfs-actions.pod:1510 ../src/guestfs-actions.pod:3000 ../src/guestfs-actions.pod:8023 +#: ../src/guestfs-actions.pod:1451 ../src/guestfs-actions.pod:1510 ../src/guestfs-actions.pod:3016 ../src/guestfs-actions.pod:8062 msgid "(Added in 1.13.15)" msgstr "" @@ -30439,7 +30559,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1596 ../src/guestfs-actions.pod:1649 ../src/guestfs-actions.pod:1702 ../src/guestfs-actions.pod:1760 ../src/guestfs-actions.pod:1814 ../src/guestfs-actions.pod:1945 ../src/guestfs-actions.pod:1976 ../src/guestfs-actions.pod:2021 ../src/guestfs-actions.pod:2465 ../src/guestfs-actions.pod:2487 ../src/guestfs-actions.pod:4582 ../src/guestfs-actions.pod:8992 ../src/guestfs-actions.pod:9026 ../src/guestfs-actions.pod:9571 ../src/guestfs-actions.pod:9594 ../src/guestfs-actions.pod:9618 +#: ../src/guestfs-actions.pod:1596 ../src/guestfs-actions.pod:1649 ../src/guestfs-actions.pod:1702 ../src/guestfs-actions.pod:1760 ../src/guestfs-actions.pod:1814 ../src/guestfs-actions.pod:1961 ../src/guestfs-actions.pod:1992 ../src/guestfs-actions.pod:2037 ../src/guestfs-actions.pod:2481 ../src/guestfs-actions.pod:2503 ../src/guestfs-actions.pod:4607 ../src/guestfs-actions.pod:9054 ../src/guestfs-actions.pod:9088 ../src/guestfs-actions.pod:9633 ../src/guestfs-actions.pod:9656 ../src/guestfs-actions.pod:9680 msgid "" "This long-running command can generate progress notification messages so " "that the caller can display a progress bar or indicator. To receive these " @@ -30448,7 +30568,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1601 ../src/guestfs-actions.pod:1654 ../src/guestfs-actions.pod:1707 ../src/guestfs-actions.pod:1765 ../src/guestfs-actions.pod:7054 +#: ../src/guestfs-actions.pod:1601 ../src/guestfs-actions.pod:1654 ../src/guestfs-actions.pod:1707 ../src/guestfs-actions.pod:1765 ../src/guestfs-actions.pod:7093 msgid "(Added in 1.13.25)" msgstr "" @@ -30751,7 +30871,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1819 ../src/guestfs-actions.pod:5343 ../src/guestfs-actions.pod:7224 ../src/guestfs-actions.pod:9227 ../src/guestfs-actions.pod:9266 ../src/guestfs-actions.pod:9352 +#: ../src/guestfs-actions.pod:1819 ../src/guestfs-actions.pod:5368 ../src/guestfs-actions.pod:7263 ../src/guestfs-actions.pod:9289 ../src/guestfs-actions.pod:9328 ../src/guestfs-actions.pod:9414 msgid "(Added in 1.0.87)" msgstr "" @@ -30772,7 +30892,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1833 ../src/guestfs-actions.pod:1847 ../src/guestfs-actions.pod:1927 ../src/guestfs-actions.pod:2001 ../src/guestfs-actions.pod:2182 ../src/guestfs-actions.pod:6449 ../src/guestfs-actions.pod:7068 +#: ../src/guestfs-actions.pod:1833 ../src/guestfs-actions.pod:1847 ../src/guestfs-actions.pod:1943 ../src/guestfs-actions.pod:2017 ../src/guestfs-actions.pod:2198 ../src/guestfs-actions.pod:6474 ../src/guestfs-actions.pod:7107 msgid "(Added in 1.0.18)" msgstr "" @@ -30818,20 +30938,47 @@ msgstr "" #. type: =head2 #: ../src/guestfs-actions.pod:1877 -msgid "guestfs_df" +msgid "guestfs_device_index" msgstr "" #. type: verbatim #: ../src/guestfs-actions.pod:1879 #, no-wrap msgid "" +" int\n" +" guestfs_device_index (guestfs_h *g,\n" +" const char *device);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:1886 +msgid "" +"Index numbers start from 0. The named device must exist, for example as a " +"string returned from C<guestfs_list_devices>." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:1889 +msgid "See also C<guestfs_list_devices>, C<guestfs_part_to_dev>." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:1893 +msgid "guestfs_df" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1895 +#, no-wrap +msgid "" " char *\n" " guestfs_df (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1884 ../src/guestfs-actions.pod:1901 +#: ../src/guestfs-actions.pod:1900 ../src/guestfs-actions.pod:1917 msgid "" "This command is mostly useful for interactive sessions. It is I<not> " "intended that you try to parse the output string. Use C<guestfs_statvfs> " @@ -30839,17 +30986,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1891 ../src/guestfs-actions.pod:1908 ../src/guestfs-actions.pod:2026 ../src/guestfs-actions.pod:3243 ../src/guestfs-actions.pod:3267 ../src/guestfs-actions.pod:3335 ../src/guestfs-actions.pod:5666 ../src/guestfs-actions.pod:6349 ../src/guestfs-actions.pod:8566 ../src/guestfs-actions.pod:8590 ../src/guestfs-actions.pod:9392 ../src/guestfs-actions.pod:9405 ../src/guestfs-actions.pod:9418 +#: ../src/guestfs-actions.pod:1907 ../src/guestfs-actions.pod:1924 ../src/guestfs-actions.pod:2042 ../src/guestfs-actions.pod:3259 ../src/guestfs-actions.pod:3283 ../src/guestfs-actions.pod:3351 ../src/guestfs-actions.pod:5691 ../src/guestfs-actions.pod:6374 ../src/guestfs-actions.pod:8628 ../src/guestfs-actions.pod:8652 ../src/guestfs-actions.pod:9454 ../src/guestfs-actions.pod:9467 ../src/guestfs-actions.pod:9480 msgid "(Added in 1.0.54)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1893 +#: ../src/guestfs-actions.pod:1909 msgid "guestfs_df_h" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1895 +#: ../src/guestfs-actions.pod:1911 #, no-wrap msgid "" " char *\n" @@ -30858,12 +31005,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1910 +#: ../src/guestfs-actions.pod:1926 msgid "guestfs_dmesg" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1912 +#: ../src/guestfs-actions.pod:1928 #, no-wrap msgid "" " char *\n" @@ -30872,7 +31019,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1919 +#: ../src/guestfs-actions.pod:1935 msgid "" "Another way to get the same information is to enable verbose messages with " "C<guestfs_set_verbose> or by setting the environment variable " @@ -30880,12 +31027,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1929 +#: ../src/guestfs-actions.pod:1945 msgid "guestfs_download" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1931 +#: ../src/guestfs-actions.pod:1947 #, no-wrap msgid "" " int\n" @@ -30896,17 +31043,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1941 +#: ../src/guestfs-actions.pod:1957 msgid "See also C<guestfs_upload>, C<guestfs_cat>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1952 +#: ../src/guestfs-actions.pod:1968 msgid "guestfs_download_offset" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1954 +#: ../src/guestfs-actions.pod:1970 #, no-wrap msgid "" " int\n" @@ -30919,7 +31066,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1967 +#: ../src/guestfs-actions.pod:1983 msgid "" "Note that there is no limit on the amount of data that can be downloaded " "with this call, unlike with C<guestfs_pread>, and this call always reads the " @@ -30927,22 +31074,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1972 +#: ../src/guestfs-actions.pod:1988 msgid "See also C<guestfs_download>, C<guestfs_pread>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1981 ../src/guestfs-actions.pod:9031 +#: ../src/guestfs-actions.pod:1997 ../src/guestfs-actions.pod:9093 msgid "(Added in 1.5.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1983 +#: ../src/guestfs-actions.pod:1999 msgid "guestfs_drop_caches" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1985 +#: ../src/guestfs-actions.pod:2001 #, no-wrap msgid "" " int\n" @@ -30952,12 +31099,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2003 +#: ../src/guestfs-actions.pod:2019 msgid "guestfs_du" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2005 +#: ../src/guestfs-actions.pod:2021 #, no-wrap msgid "" " int64_t\n" @@ -30967,12 +31114,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2028 +#: ../src/guestfs-actions.pod:2044 msgid "guestfs_e2fsck" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2030 +#: ../src/guestfs-actions.pod:2046 #, no-wrap msgid "" " int\n" @@ -30983,7 +31130,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2040 +#: ../src/guestfs-actions.pod:2056 #, no-wrap msgid "" " GUESTFS_E2FSCK_CORRECT, int correct,\n" @@ -30992,17 +31139,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2067 +#: ../src/guestfs-actions.pod:2083 msgid "(Added in 1.15.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2069 +#: ../src/guestfs-actions.pod:2085 msgid "guestfs_e2fsck_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2071 +#: ../src/guestfs-actions.pod:2087 #, no-wrap msgid "" " int\n" @@ -31013,17 +31160,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2076 +#: ../src/guestfs-actions.pod:2092 msgid "This is the \"va_list variant\" of L</guestfs_e2fsck>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2080 +#: ../src/guestfs-actions.pod:2096 msgid "guestfs_e2fsck_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2082 +#: ../src/guestfs-actions.pod:2098 #, no-wrap msgid "" " int\n" @@ -31034,17 +31181,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2087 +#: ../src/guestfs-actions.pod:2103 msgid "This is the \"argv variant\" of L</guestfs_e2fsck>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2091 +#: ../src/guestfs-actions.pod:2107 msgid "guestfs_e2fsck_f" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2093 +#: ../src/guestfs-actions.pod:2109 #, no-wrap msgid "" " int\n" @@ -31054,24 +31201,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2097 +#: ../src/guestfs-actions.pod:2113 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_e2fsck> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2110 +#: ../src/guestfs-actions.pod:2126 msgid "(Added in 1.0.29)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2112 +#: ../src/guestfs-actions.pod:2128 msgid "guestfs_echo_daemon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2114 +#: ../src/guestfs-actions.pod:2130 #, no-wrap msgid "" " char *\n" @@ -31081,22 +31228,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2123 +#: ../src/guestfs-actions.pod:2139 msgid "See also C<guestfs_ping_daemon>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2128 ../src/guestfs-actions.pod:3025 ../src/guestfs-actions.pod:8047 +#: ../src/guestfs-actions.pod:2144 ../src/guestfs-actions.pod:3041 ../src/guestfs-actions.pod:8086 msgid "(Added in 1.0.69)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2130 +#: ../src/guestfs-actions.pod:2146 msgid "guestfs_egrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2132 +#: ../src/guestfs-actions.pod:2148 #, no-wrap msgid "" " char **\n" @@ -31107,17 +31254,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2147 ../src/guestfs-actions.pod:2166 ../src/guestfs-actions.pod:2223 ../src/guestfs-actions.pod:2269 ../src/guestfs-actions.pod:2288 ../src/guestfs-actions.pod:3159 ../src/guestfs-actions.pod:3178 ../src/guestfs-actions.pod:3356 ../src/guestfs-actions.pod:3369 ../src/guestfs-actions.pod:3384 ../src/guestfs-actions.pod:3428 ../src/guestfs-actions.pod:3450 ../src/guestfs-actions.pod:3463 ../src/guestfs-actions.pod:4825 ../src/guestfs-actions.pod:4839 ../src/guestfs-actions.pod:4852 ../src/guestfs-actions.pod:4866 ../src/guestfs-actions.pod:6143 ../src/guestfs-actions.pod:7402 ../src/guestfs-actions.pod:7451 ../src/guestfs-actions.pod:8434 ../src/guestfs-actions.pod:8446 ../src/guestfs-actions.pod:8459 ../src/guestfs-actions.pod:8472 ../src/guestfs-actions.pod:8494 ../src/guestfs-actions.pod:8507 ../src/guestfs-actions.pod:8520 ../src/guestfs-actions.pod:8533 ../src/guestfs-actions.pod:9529 ../src/guestfs-actions.pod:9548 ../src/guestfs-actions.pod:9663 ../src/guestfs-actions.pod:9682 ../src/guestfs-actions.pod:9728 ../src/guestfs-actions.pod:9747 +#: ../src/guestfs-actions.pod:2163 ../src/guestfs-actions.pod:2182 ../src/guestfs-actions.pod:2239 ../src/guestfs-actions.pod:2285 ../src/guestfs-actions.pod:2304 ../src/guestfs-actions.pod:3175 ../src/guestfs-actions.pod:3194 ../src/guestfs-actions.pod:3372 ../src/guestfs-actions.pod:3385 ../src/guestfs-actions.pod:3400 ../src/guestfs-actions.pod:3444 ../src/guestfs-actions.pod:3466 ../src/guestfs-actions.pod:3479 ../src/guestfs-actions.pod:4850 ../src/guestfs-actions.pod:4864 ../src/guestfs-actions.pod:4877 ../src/guestfs-actions.pod:4891 ../src/guestfs-actions.pod:6168 ../src/guestfs-actions.pod:7441 ../src/guestfs-actions.pod:7490 ../src/guestfs-actions.pod:8496 ../src/guestfs-actions.pod:8508 ../src/guestfs-actions.pod:8521 ../src/guestfs-actions.pod:8534 ../src/guestfs-actions.pod:8556 ../src/guestfs-actions.pod:8569 ../src/guestfs-actions.pod:8582 ../src/guestfs-actions.pod:8595 ../src/guestfs-actions.pod:9591 ../src/guestfs-actions.pod:9610 ../src/guestfs-actions.pod:9725 ../src/guestfs-actions.pod:9744 ../src/guestfs-actions.pod:9790 ../src/guestfs-actions.pod:9809 msgid "(Added in 1.0.66)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2149 +#: ../src/guestfs-actions.pod:2165 msgid "guestfs_egrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2151 +#: ../src/guestfs-actions.pod:2167 #, no-wrap msgid "" " char **\n" @@ -31128,12 +31275,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2168 +#: ../src/guestfs-actions.pod:2184 msgid "guestfs_equal" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2170 +#: ../src/guestfs-actions.pod:2186 #, no-wrap msgid "" " int\n" @@ -31144,12 +31291,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2184 +#: ../src/guestfs-actions.pod:2200 msgid "guestfs_exists" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2186 +#: ../src/guestfs-actions.pod:2202 #, no-wrap msgid "" " int\n" @@ -31159,17 +31306,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2193 +#: ../src/guestfs-actions.pod:2209 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2199 +#: ../src/guestfs-actions.pod:2215 msgid "guestfs_fallocate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2201 +#: ../src/guestfs-actions.pod:2217 #, no-wrap msgid "" " int\n" @@ -31180,19 +31327,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2206 +#: ../src/guestfs-actions.pod:2222 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_fallocate64> " "call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2225 +#: ../src/guestfs-actions.pod:2241 msgid "guestfs_fallocate64" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2227 +#: ../src/guestfs-actions.pod:2243 #, no-wrap msgid "" " int\n" @@ -31203,14 +31350,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2236 +#: ../src/guestfs-actions.pod:2252 msgid "" "Note that this call allocates disk blocks for the file. To create a sparse " "file use C<guestfs_truncate_size> instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2239 +#: ../src/guestfs-actions.pod:2255 msgid "" "The deprecated call C<guestfs_fallocate> does the same, but owing to an " "oversight it only allowed 30 bit lengths to be specified, effectively " @@ -31218,17 +31365,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2250 +#: ../src/guestfs-actions.pod:2266 msgid "(Added in 1.3.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2252 +#: ../src/guestfs-actions.pod:2268 msgid "guestfs_fgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2254 +#: ../src/guestfs-actions.pod:2270 #, no-wrap msgid "" " char **\n" @@ -31239,12 +31386,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2271 +#: ../src/guestfs-actions.pod:2287 msgid "guestfs_fgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2273 +#: ../src/guestfs-actions.pod:2289 #, no-wrap msgid "" " char **\n" @@ -31255,12 +31402,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2290 +#: ../src/guestfs-actions.pod:2306 msgid "guestfs_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2292 +#: ../src/guestfs-actions.pod:2308 #, no-wrap msgid "" " char *\n" @@ -31270,19 +31417,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2310 +#: ../src/guestfs-actions.pod:2326 msgid "" "See also: L<file(1)>, C<guestfs_vfs_type>, C<guestfs_lstat>, " "C<guestfs_is_file>, C<guestfs_is_blockdev> (etc), C<guestfs_is_zero>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2318 +#: ../src/guestfs-actions.pod:2334 msgid "guestfs_file_architecture" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2320 +#: ../src/guestfs-actions.pod:2336 #, no-wrap msgid "" " char *\n" @@ -31292,17 +31439,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2428 ../src/guestfs-actions.pod:2591 ../src/guestfs-actions.pod:2608 ../src/guestfs-actions.pod:3483 ../src/guestfs-actions.pod:3597 ../src/guestfs-actions.pod:3663 ../src/guestfs-actions.pod:3850 ../src/guestfs-actions.pod:3868 ../src/guestfs-actions.pod:3908 ../src/guestfs-actions.pod:3984 ../src/guestfs-actions.pod:4089 ../src/guestfs-actions.pod:4326 ../src/guestfs-actions.pod:4444 +#: ../src/guestfs-actions.pod:2444 ../src/guestfs-actions.pod:2607 ../src/guestfs-actions.pod:2624 ../src/guestfs-actions.pod:3499 ../src/guestfs-actions.pod:3613 ../src/guestfs-actions.pod:3679 ../src/guestfs-actions.pod:3866 ../src/guestfs-actions.pod:3884 ../src/guestfs-actions.pod:3924 ../src/guestfs-actions.pod:4000 ../src/guestfs-actions.pod:4105 ../src/guestfs-actions.pod:4342 ../src/guestfs-actions.pod:4460 msgid "(Added in 1.5.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2430 +#: ../src/guestfs-actions.pod:2446 msgid "guestfs_filesize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2432 +#: ../src/guestfs-actions.pod:2448 #, no-wrap msgid "" " int64_t\n" @@ -31312,7 +31459,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2438 +#: ../src/guestfs-actions.pod:2454 msgid "" "To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, " "C<guestfs_is_dir>, C<guestfs_is_file> etc. To get the size of block " @@ -31320,17 +31467,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2444 +#: ../src/guestfs-actions.pod:2460 msgid "(Added in 1.0.82)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2446 +#: ../src/guestfs-actions.pod:2462 msgid "guestfs_fill" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2448 +#: ../src/guestfs-actions.pod:2464 #, no-wrap msgid "" " int\n" @@ -31342,7 +31489,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2458 +#: ../src/guestfs-actions.pod:2474 msgid "" "To fill a file with zero bytes (sparsely), it is much more efficient to use " "C<guestfs_truncate_size>. To create a file with a pattern of repeating " @@ -31350,17 +31497,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2470 +#: ../src/guestfs-actions.pod:2486 msgid "(Added in 1.0.79)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2472 +#: ../src/guestfs-actions.pod:2488 msgid "guestfs_fill_pattern" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2474 +#: ../src/guestfs-actions.pod:2490 #, no-wrap msgid "" " int\n" @@ -31372,7 +31519,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2480 +#: ../src/guestfs-actions.pod:2496 msgid "" "This function is like C<guestfs_fill> except that it creates a new file of " "length C<len> containing the repeating pattern of bytes in C<pattern>. The " @@ -31381,17 +31528,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2492 +#: ../src/guestfs-actions.pod:2508 msgid "(Added in 1.3.12)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2494 +#: ../src/guestfs-actions.pod:2510 msgid "guestfs_find" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2496 +#: ../src/guestfs-actions.pod:2512 #, no-wrap msgid "" " char **\n" @@ -31401,27 +31548,27 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2512 +#: ../src/guestfs-actions.pod:2528 msgid "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2525 +#: ../src/guestfs-actions.pod:2541 msgid "See also C<guestfs_find0>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2534 ../src/guestfs-actions.pod:5280 ../src/guestfs-actions.pod:7482 +#: ../src/guestfs-actions.pod:2550 ../src/guestfs-actions.pod:5305 ../src/guestfs-actions.pod:7521 msgid "(Added in 1.0.27)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2536 +#: ../src/guestfs-actions.pod:2552 msgid "guestfs_find0" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2538 +#: ../src/guestfs-actions.pod:2554 #, no-wrap msgid "" " int\n" @@ -31432,24 +31579,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2547 +#: ../src/guestfs-actions.pod:2563 msgid "" "This command works the same way as C<guestfs_find> with the following " "exceptions:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2574 +#: ../src/guestfs-actions.pod:2590 msgid "(Added in 1.0.74)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2576 +#: ../src/guestfs-actions.pod:2592 msgid "guestfs_findfs_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2578 +#: ../src/guestfs-actions.pod:2594 #, no-wrap msgid "" " char *\n" @@ -31459,17 +31606,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2586 +#: ../src/guestfs-actions.pod:2602 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2593 +#: ../src/guestfs-actions.pod:2609 msgid "guestfs_findfs_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2595 +#: ../src/guestfs-actions.pod:2611 #, no-wrap msgid "" " char *\n" @@ -31479,17 +31626,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2603 +#: ../src/guestfs-actions.pod:2619 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2610 +#: ../src/guestfs-actions.pod:2626 msgid "guestfs_fsck" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2612 +#: ../src/guestfs-actions.pod:2628 #, no-wrap msgid "" " int\n" @@ -31500,17 +31647,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2647 ../src/guestfs-actions.pod:9576 +#: ../src/guestfs-actions.pod:2663 ../src/guestfs-actions.pod:9638 msgid "(Added in 1.0.16)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2649 +#: ../src/guestfs-actions.pod:2665 msgid "guestfs_get_append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2651 +#: ../src/guestfs-actions.pod:2667 #, no-wrap msgid "" " const char *\n" @@ -31519,7 +31666,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2659 +#: ../src/guestfs-actions.pod:2675 msgid "" "This function returns a string which may be NULL. There is no way to return " "an error from this function. The string is owned by the guest handle and " @@ -31527,17 +31674,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2663 ../src/guestfs-actions.pod:7164 ../src/guestfs-actions.pod:7643 ../src/guestfs-actions.pod:8201 ../src/guestfs-actions.pod:8220 ../src/guestfs-actions.pod:8236 ../src/guestfs-actions.pod:8260 ../src/guestfs-actions.pod:9178 ../src/guestfs-actions.pod:9193 ../src/guestfs-actions.pod:9644 +#: ../src/guestfs-actions.pod:2679 ../src/guestfs-actions.pod:7203 ../src/guestfs-actions.pod:7682 ../src/guestfs-actions.pod:8240 ../src/guestfs-actions.pod:8259 ../src/guestfs-actions.pod:8275 ../src/guestfs-actions.pod:8299 ../src/guestfs-actions.pod:9240 ../src/guestfs-actions.pod:9255 ../src/guestfs-actions.pod:9706 msgid "(Added in 1.0.26)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2665 +#: ../src/guestfs-actions.pod:2681 msgid "guestfs_get_attach_method" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2667 +#: ../src/guestfs-actions.pod:2683 #, no-wrap msgid "" " char *\n" @@ -31546,22 +31693,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2670 +#: ../src/guestfs-actions.pod:2686 msgid "Return the current attach method. See C<guestfs_set_attach_method>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2675 ../src/guestfs-actions.pod:7673 +#: ../src/guestfs-actions.pod:2691 ../src/guestfs-actions.pod:7712 msgid "(Added in 1.9.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2677 +#: ../src/guestfs-actions.pod:2693 msgid "guestfs_get_autosync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2679 +#: ../src/guestfs-actions.pod:2695 #, no-wrap msgid "" " int\n" @@ -31570,12 +31717,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2688 +#: ../src/guestfs-actions.pod:2704 msgid "guestfs_get_direct" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2690 +#: ../src/guestfs-actions.pod:2706 #, no-wrap msgid "" " int\n" @@ -31584,17 +31731,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2697 ../src/guestfs-actions.pod:7714 +#: ../src/guestfs-actions.pod:2713 ../src/guestfs-actions.pod:7753 msgid "(Added in 1.0.72)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2699 +#: ../src/guestfs-actions.pod:2715 msgid "guestfs_get_e2attrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2701 +#: ../src/guestfs-actions.pod:2717 #, no-wrap msgid "" " char *\n" @@ -31604,29 +31751,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2808 +#: ../src/guestfs-actions.pod:2824 msgid "See also C<guestfs_set_e2attrs>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2810 +#: ../src/guestfs-actions.pod:2826 msgid "" "Don't confuse these attributes with extended attributes (see " "C<guestfs_getxattr>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2816 ../src/guestfs-actions.pod:2836 ../src/guestfs-actions.pod:7753 ../src/guestfs-actions.pod:7792 +#: ../src/guestfs-actions.pod:2832 ../src/guestfs-actions.pod:2852 ../src/guestfs-actions.pod:7792 ../src/guestfs-actions.pod:7831 msgid "(Added in 1.17.31)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2818 +#: ../src/guestfs-actions.pod:2834 msgid "guestfs_get_e2generation" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2820 +#: ../src/guestfs-actions.pod:2836 #, no-wrap msgid "" " int64_t\n" @@ -31636,17 +31783,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2832 +#: ../src/guestfs-actions.pod:2848 msgid "See C<guestfs_set_e2generation>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2838 +#: ../src/guestfs-actions.pod:2854 msgid "guestfs_get_e2label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2840 +#: ../src/guestfs-actions.pod:2856 #, no-wrap msgid "" " char *\n" @@ -31656,24 +31803,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2844 +#: ../src/guestfs-actions.pod:2860 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_vfs_label> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2857 ../src/guestfs-actions.pod:2878 ../src/guestfs-actions.pod:7817 ../src/guestfs-actions.pod:7836 +#: ../src/guestfs-actions.pod:2873 ../src/guestfs-actions.pod:2894 ../src/guestfs-actions.pod:7856 ../src/guestfs-actions.pod:7875 msgid "(Added in 1.0.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2859 +#: ../src/guestfs-actions.pod:2875 msgid "guestfs_get_e2uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2861 +#: ../src/guestfs-actions.pod:2877 #, no-wrap msgid "" " char *\n" @@ -31683,19 +31830,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2865 +#: ../src/guestfs-actions.pod:2881 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_vfs_uuid> " "call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2880 +#: ../src/guestfs-actions.pod:2896 msgid "guestfs_get_memsize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2882 +#: ../src/guestfs-actions.pod:2898 #, no-wrap msgid "" " int\n" @@ -31704,7 +31851,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2888 +#: ../src/guestfs-actions.pod:2904 msgid "" "If C<guestfs_set_memsize> was not called on this handle, and if " "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default " @@ -31712,17 +31859,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2897 ../src/guestfs-actions.pod:5784 ../src/guestfs-actions.pod:6048 ../src/guestfs-actions.pod:6067 ../src/guestfs-actions.pod:6086 ../src/guestfs-actions.pod:6098 ../src/guestfs-actions.pod:6115 ../src/guestfs-actions.pod:6128 ../src/guestfs-actions.pod:7389 ../src/guestfs-actions.pod:7879 ../src/guestfs-actions.pod:8171 ../src/guestfs-actions.pod:8905 +#: ../src/guestfs-actions.pod:2913 ../src/guestfs-actions.pod:5809 ../src/guestfs-actions.pod:6073 ../src/guestfs-actions.pod:6092 ../src/guestfs-actions.pod:6111 ../src/guestfs-actions.pod:6123 ../src/guestfs-actions.pod:6140 ../src/guestfs-actions.pod:6153 ../src/guestfs-actions.pod:7428 ../src/guestfs-actions.pod:7918 ../src/guestfs-actions.pod:8210 ../src/guestfs-actions.pod:8967 msgid "(Added in 1.0.55)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2899 +#: ../src/guestfs-actions.pod:2915 msgid "guestfs_get_network" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2901 +#: ../src/guestfs-actions.pod:2917 #, no-wrap msgid "" " int\n" @@ -31731,17 +31878,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2908 ../src/guestfs-actions.pod:7898 +#: ../src/guestfs-actions.pod:2924 ../src/guestfs-actions.pod:7937 msgid "(Added in 1.5.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2910 +#: ../src/guestfs-actions.pod:2926 msgid "guestfs_get_path" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2912 +#: ../src/guestfs-actions.pod:2928 #, no-wrap msgid "" " const char *\n" @@ -31750,19 +31897,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2920 ../src/guestfs-actions.pod:2960 +#: ../src/guestfs-actions.pod:2936 ../src/guestfs-actions.pod:2976 msgid "" "This function returns a string, or NULL on error. The string is owned by " "the guest handle and must I<not> be freed." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2925 +#: ../src/guestfs-actions.pod:2941 msgid "guestfs_get_pgroup" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2927 +#: ../src/guestfs-actions.pod:2943 #, no-wrap msgid "" " int\n" @@ -31771,17 +31918,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2934 ../src/guestfs-actions.pod:7936 ../src/guestfs-actions.pod:9477 +#: ../src/guestfs-actions.pod:2950 ../src/guestfs-actions.pod:7975 ../src/guestfs-actions.pod:9539 msgid "(Added in 1.11.18)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2936 +#: ../src/guestfs-actions.pod:2952 msgid "guestfs_get_pid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2938 +#: ../src/guestfs-actions.pod:2954 #, no-wrap msgid "" " int\n" @@ -31790,17 +31937,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2948 +#: ../src/guestfs-actions.pod:2964 msgid "(Added in 1.0.56)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2950 +#: ../src/guestfs-actions.pod:2966 msgid "guestfs_get_qemu" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2952 +#: ../src/guestfs-actions.pod:2968 #, no-wrap msgid "" " const char *\n" @@ -31809,17 +31956,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2963 ../src/guestfs-actions.pod:7964 +#: ../src/guestfs-actions.pod:2979 ../src/guestfs-actions.pod:8003 msgid "(Added in 1.0.6)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2965 +#: ../src/guestfs-actions.pod:2981 msgid "guestfs_get_recovery_proc" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2967 +#: ../src/guestfs-actions.pod:2983 #, no-wrap msgid "" " int\n" @@ -31828,17 +31975,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2974 ../src/guestfs-actions.pod:4607 ../src/guestfs-actions.pod:4967 ../src/guestfs-actions.pod:5378 ../src/guestfs-actions.pod:5623 ../src/guestfs-actions.pod:7094 ../src/guestfs-actions.pod:7437 ../src/guestfs-actions.pod:7988 ../src/guestfs-actions.pod:8686 ../src/guestfs-actions.pod:8706 ../src/guestfs-actions.pod:9062 +#: ../src/guestfs-actions.pod:2990 ../src/guestfs-actions.pod:4632 ../src/guestfs-actions.pod:4992 ../src/guestfs-actions.pod:5403 ../src/guestfs-actions.pod:5648 ../src/guestfs-actions.pod:7133 ../src/guestfs-actions.pod:7476 ../src/guestfs-actions.pod:8027 ../src/guestfs-actions.pod:8748 ../src/guestfs-actions.pod:8768 ../src/guestfs-actions.pod:9124 msgid "(Added in 1.0.77)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2976 +#: ../src/guestfs-actions.pod:2992 msgid "guestfs_get_selinux" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2978 +#: ../src/guestfs-actions.pod:2994 #, no-wrap msgid "" " int\n" @@ -31847,24 +31994,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2981 +#: ../src/guestfs-actions.pod:2997 msgid "" "This returns the current setting of the selinux flag which is passed to the " "appliance at boot time. See C<guestfs_set_selinux>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2989 ../src/guestfs-actions.pod:3063 ../src/guestfs-actions.pod:8007 ../src/guestfs-actions.pod:8081 +#: ../src/guestfs-actions.pod:3005 ../src/guestfs-actions.pod:3079 ../src/guestfs-actions.pod:8046 ../src/guestfs-actions.pod:8120 msgid "(Added in 1.0.67)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2991 +#: ../src/guestfs-actions.pod:3007 msgid "guestfs_get_smp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2993 +#: ../src/guestfs-actions.pod:3009 #, no-wrap msgid "" " int\n" @@ -31873,12 +32020,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3002 +#: ../src/guestfs-actions.pod:3018 msgid "guestfs_get_state" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3004 +#: ../src/guestfs-actions.pod:3020 #, no-wrap msgid "" " int\n" @@ -31887,12 +32034,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3016 +#: ../src/guestfs-actions.pod:3032 msgid "guestfs_get_trace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3018 +#: ../src/guestfs-actions.pod:3034 #, no-wrap msgid "" " int\n" @@ -31901,12 +32048,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3027 +#: ../src/guestfs-actions.pod:3043 msgid "guestfs_get_umask" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3029 +#: ../src/guestfs-actions.pod:3045 #, no-wrap msgid "" " int\n" @@ -31915,19 +32062,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3032 +#: ../src/guestfs-actions.pod:3048 msgid "" "Return the current umask. By default the umask is C<022> unless it has been " "set by calling C<guestfs_umask>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3039 +#: ../src/guestfs-actions.pod:3055 msgid "guestfs_get_verbose" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3041 +#: ../src/guestfs-actions.pod:3057 #, no-wrap msgid "" " int\n" @@ -31936,12 +32083,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3050 +#: ../src/guestfs-actions.pod:3066 msgid "guestfs_getcon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3052 +#: ../src/guestfs-actions.pod:3068 #, no-wrap msgid "" " char *\n" @@ -31950,17 +32097,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3057 +#: ../src/guestfs-actions.pod:3073 msgid "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3065 +#: ../src/guestfs-actions.pod:3081 msgid "guestfs_getxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3067 +#: ../src/guestfs-actions.pod:3083 #, no-wrap msgid "" " char *\n" @@ -31972,7 +32119,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3073 +#: ../src/guestfs-actions.pod:3089 msgid "" "Get a single extended attribute from file C<path> named C<name>. This call " "follows symlinks. If you want to lookup an extended attribute for the " @@ -31980,7 +32127,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3077 ../src/guestfs-actions.pod:4621 +#: ../src/guestfs-actions.pod:3093 ../src/guestfs-actions.pod:4646 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 " @@ -31990,12 +32137,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3087 +#: ../src/guestfs-actions.pod:3103 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3089 ../src/guestfs-actions.pod:3306 ../src/guestfs-actions.pod:3798 ../src/guestfs-actions.pod:4633 ../src/guestfs-actions.pod:7087 ../src/guestfs-actions.pod:7113 ../src/guestfs-actions.pod:7294 ../src/guestfs-actions.pod:9242 +#: ../src/guestfs-actions.pod:3105 ../src/guestfs-actions.pod:3322 ../src/guestfs-actions.pod:3814 ../src/guestfs-actions.pod:4658 ../src/guestfs-actions.pod:7126 ../src/guestfs-actions.pod:7152 ../src/guestfs-actions.pod:7333 ../src/guestfs-actions.pod:9304 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 " @@ -32003,17 +32150,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3093 ../src/guestfs-actions.pod:4637 +#: ../src/guestfs-actions.pod:3109 ../src/guestfs-actions.pod:4662 msgid "(Added in 1.7.24)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3095 +#: ../src/guestfs-actions.pod:3111 msgid "guestfs_getxattrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3097 +#: ../src/guestfs-actions.pod:3113 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -32023,29 +32170,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3107 +#: ../src/guestfs-actions.pod:3123 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3109 ../src/guestfs-actions.pod:4649 ../src/guestfs-actions.pod:5374 +#: ../src/guestfs-actions.pod:3125 ../src/guestfs-actions.pod:4674 ../src/guestfs-actions.pod:5399 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:3113 ../src/guestfs-actions.pod:4653 ../src/guestfs-actions.pod:4881 ../src/guestfs-actions.pod:4917 ../src/guestfs-actions.pod:7467 ../src/guestfs-actions.pod:8100 ../src/guestfs-actions.pod:9709 +#: ../src/guestfs-actions.pod:3129 ../src/guestfs-actions.pod:4678 ../src/guestfs-actions.pod:4906 ../src/guestfs-actions.pod:4942 ../src/guestfs-actions.pod:7506 ../src/guestfs-actions.pod:8139 ../src/guestfs-actions.pod:9771 msgid "(Added in 1.0.59)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3115 +#: ../src/guestfs-actions.pod:3131 msgid "guestfs_glob_expand" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3117 +#: ../src/guestfs-actions.pod:3133 #, no-wrap msgid "" " char **\n" @@ -32055,7 +32202,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3132 +#: ../src/guestfs-actions.pod:3148 msgid "" "Notice that there is no equivalent command for expanding a device name " "(eg. C</dev/sd*>). Use C<guestfs_list_devices>, C<guestfs_list_partitions> " @@ -32063,17 +32210,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3140 ../src/guestfs-actions.pod:8284 ../src/guestfs-actions.pod:8301 +#: ../src/guestfs-actions.pod:3156 ../src/guestfs-actions.pod:8323 ../src/guestfs-actions.pod:8340 msgid "(Added in 1.0.50)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3142 +#: ../src/guestfs-actions.pod:3158 msgid "guestfs_grep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3144 +#: ../src/guestfs-actions.pod:3160 #, no-wrap msgid "" " char **\n" @@ -32084,12 +32231,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3161 +#: ../src/guestfs-actions.pod:3177 msgid "guestfs_grepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3163 +#: ../src/guestfs-actions.pod:3179 #, no-wrap msgid "" " char **\n" @@ -32100,12 +32247,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3180 +#: ../src/guestfs-actions.pod:3196 msgid "guestfs_grub_install" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3182 +#: ../src/guestfs-actions.pod:3198 #, no-wrap msgid "" " int\n" @@ -32116,17 +32263,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3225 +#: ../src/guestfs-actions.pod:3241 msgid "(Added in 1.0.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3227 +#: ../src/guestfs-actions.pod:3243 msgid "guestfs_head" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3229 +#: ../src/guestfs-actions.pod:3245 #, no-wrap msgid "" " char **\n" @@ -32136,12 +32283,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3245 +#: ../src/guestfs-actions.pod:3261 msgid "guestfs_head_n" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3247 +#: ../src/guestfs-actions.pod:3263 #, no-wrap msgid "" " char **\n" @@ -32152,12 +32299,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3269 +#: ../src/guestfs-actions.pod:3285 msgid "guestfs_hexdump" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3271 +#: ../src/guestfs-actions.pod:3287 #, no-wrap msgid "" " char *\n" @@ -32167,17 +32314,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3284 ../src/guestfs-actions.pod:8365 ../src/guestfs-actions.pod:8420 +#: ../src/guestfs-actions.pod:3300 ../src/guestfs-actions.pod:8427 ../src/guestfs-actions.pod:8482 msgid "(Added in 1.0.22)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3286 +#: ../src/guestfs-actions.pod:3302 msgid "guestfs_initrd_cat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3288 +#: ../src/guestfs-actions.pod:3304 #, no-wrap msgid "" " char *\n" @@ -32189,17 +32336,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3304 +#: ../src/guestfs-actions.pod:3320 msgid "See also C<guestfs_initrd_list>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3315 +#: ../src/guestfs-actions.pod:3331 msgid "guestfs_initrd_list" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3317 +#: ../src/guestfs-actions.pod:3333 #, no-wrap msgid "" " char **\n" @@ -32209,12 +32356,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3337 +#: ../src/guestfs-actions.pod:3353 msgid "guestfs_inotify_add_watch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3339 +#: ../src/guestfs-actions.pod:3355 #, no-wrap msgid "" " int64_t\n" @@ -32225,12 +32372,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3358 +#: ../src/guestfs-actions.pod:3374 msgid "guestfs_inotify_close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3360 +#: ../src/guestfs-actions.pod:3376 #, no-wrap msgid "" " int\n" @@ -32239,12 +32386,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3371 +#: ../src/guestfs-actions.pod:3387 msgid "guestfs_inotify_files" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3373 +#: ../src/guestfs-actions.pod:3389 #, no-wrap msgid "" " char **\n" @@ -32253,7 +32400,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3376 +#: ../src/guestfs-actions.pod:3392 msgid "" "This function is a helpful wrapper around C<guestfs_inotify_read> which just " "returns a list of pathnames of objects that were touched. The returned " @@ -32261,12 +32408,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3386 +#: ../src/guestfs-actions.pod:3402 msgid "guestfs_inotify_init" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3388 +#: ../src/guestfs-actions.pod:3404 #, no-wrap msgid "" " int\n" @@ -32276,7 +32423,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3396 +#: ../src/guestfs-actions.pod:3412 msgid "" "C<maxevents> is the maximum number of events which will be queued up between " "calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>. If this is " @@ -32288,7 +32435,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3406 +#: ../src/guestfs-actions.pod:3422 msgid "" "Before any events are generated, you have to add some watches to the " "internal watch list. See: C<guestfs_inotify_add_watch> and " @@ -32296,7 +32443,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3410 +#: ../src/guestfs-actions.pod:3426 msgid "" "Queued up events should be read periodically by calling " "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful " @@ -32305,19 +32452,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3417 +#: ../src/guestfs-actions.pod:3433 msgid "" "The handle should be closed after use by calling C<guestfs_inotify_close>. " "This also removes any watches automatically." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3430 +#: ../src/guestfs-actions.pod:3446 msgid "guestfs_inotify_read" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3432 +#: ../src/guestfs-actions.pod:3448 #, no-wrap msgid "" " struct guestfs_inotify_event_list *\n" @@ -32326,7 +32473,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3446 +#: ../src/guestfs-actions.pod:3462 msgid "" "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if " "there was an error. I<The caller must call " @@ -32334,12 +32481,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3452 +#: ../src/guestfs-actions.pod:3468 msgid "guestfs_inotify_rm_watch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3454 +#: ../src/guestfs-actions.pod:3470 #, no-wrap msgid "" " int\n" @@ -32349,19 +32496,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3458 +#: ../src/guestfs-actions.pod:3474 msgid "" "Remove a previously defined inotify watch. See " "C<guestfs_inotify_add_watch>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3465 +#: ../src/guestfs-actions.pod:3481 msgid "guestfs_inspect_get_arch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3467 +#: ../src/guestfs-actions.pod:3483 #, no-wrap msgid "" " char *\n" @@ -32371,19 +32518,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3471 +#: ../src/guestfs-actions.pod:3487 msgid "" "This returns the architecture of the inspected operating system. The " "possible return values are listed under C<guestfs_file_architecture>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3485 +#: ../src/guestfs-actions.pod:3501 msgid "guestfs_inspect_get_distro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3487 +#: ../src/guestfs-actions.pod:3503 #, no-wrap msgid "" " char *\n" @@ -32393,12 +32540,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3599 +#: ../src/guestfs-actions.pod:3615 msgid "guestfs_inspect_get_drive_mappings" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3601 +#: ../src/guestfs-actions.pod:3617 #, no-wrap msgid "" " char **\n" @@ -32408,24 +32555,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3630 +#: ../src/guestfs-actions.pod:3646 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:3640 ../src/guestfs-actions.pod:4109 +#: ../src/guestfs-actions.pod:3656 ../src/guestfs-actions.pod:4125 msgid "(Added in 1.9.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3642 +#: ../src/guestfs-actions.pod:3658 msgid "guestfs_inspect_get_filesystems" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3644 +#: ../src/guestfs-actions.pod:3660 #, no-wrap msgid "" " char **\n" @@ -32435,19 +32582,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3656 +#: ../src/guestfs-actions.pod:3672 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_mountpoints>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3665 +#: ../src/guestfs-actions.pod:3681 msgid "guestfs_inspect_get_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3667 +#: ../src/guestfs-actions.pod:3683 #, no-wrap msgid "" " char *\n" @@ -32457,17 +32604,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3701 ../src/guestfs-actions.pod:4145 ../src/guestfs-actions.pod:4161 ../src/guestfs-actions.pod:4179 ../src/guestfs-actions.pod:7503 +#: ../src/guestfs-actions.pod:3717 ../src/guestfs-actions.pod:4161 ../src/guestfs-actions.pod:4177 ../src/guestfs-actions.pod:4195 ../src/guestfs-actions.pod:7542 msgid "(Added in 1.9.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3703 +#: ../src/guestfs-actions.pod:3719 msgid "guestfs_inspect_get_hostname" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3705 +#: ../src/guestfs-actions.pod:3721 #, no-wrap msgid "" " char *\n" @@ -32477,17 +32624,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3720 +#: ../src/guestfs-actions.pod:3736 msgid "(Added in 1.7.9)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3722 +#: ../src/guestfs-actions.pod:3738 msgid "guestfs_inspect_get_icon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3724 +#: ../src/guestfs-actions.pod:3740 #, no-wrap msgid "" " char *\n" @@ -32499,7 +32646,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3735 +#: ../src/guestfs-actions.pod:3751 #, no-wrap msgid "" " GUESTFS_INSPECT_GET_ICON_FAVICON, int favicon,\n" @@ -32508,17 +32655,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3802 ../src/guestfs-actions.pod:4667 ../src/guestfs-actions.pod:6216 +#: ../src/guestfs-actions.pod:3818 ../src/guestfs-actions.pod:4692 ../src/guestfs-actions.pod:6241 msgid "(Added in 1.11.12)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3804 +#: ../src/guestfs-actions.pod:3820 msgid "guestfs_inspect_get_icon_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3806 +#: ../src/guestfs-actions.pod:3822 #, no-wrap msgid "" " char *\n" @@ -32530,17 +32677,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3812 +#: ../src/guestfs-actions.pod:3828 msgid "This is the \"va_list variant\" of L</guestfs_inspect_get_icon>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3816 +#: ../src/guestfs-actions.pod:3832 msgid "guestfs_inspect_get_icon_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3818 +#: ../src/guestfs-actions.pod:3834 #, no-wrap msgid "" " char *\n" @@ -32553,17 +32700,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3824 +#: ../src/guestfs-actions.pod:3840 msgid "This is the \"argv variant\" of L</guestfs_inspect_get_icon>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3828 +#: ../src/guestfs-actions.pod:3844 msgid "guestfs_inspect_get_major_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3830 +#: ../src/guestfs-actions.pod:3846 #, no-wrap msgid "" " int\n" @@ -32573,12 +32720,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3852 +#: ../src/guestfs-actions.pod:3868 msgid "guestfs_inspect_get_minor_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3854 +#: ../src/guestfs-actions.pod:3870 #, no-wrap msgid "" " int\n" @@ -32588,19 +32735,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3863 +#: ../src/guestfs-actions.pod:3879 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:3870 +#: ../src/guestfs-actions.pod:3886 msgid "guestfs_inspect_get_mountpoints" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3872 +#: ../src/guestfs-actions.pod:3888 #, no-wrap msgid "" " char **\n" @@ -32610,7 +32757,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3893 +#: ../src/guestfs-actions.pod:3909 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 " @@ -32619,19 +32766,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3899 +#: ../src/guestfs-actions.pod:3915 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3910 +#: ../src/guestfs-actions.pod:3926 msgid "guestfs_inspect_get_package_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3912 +#: ../src/guestfs-actions.pod:3928 #, no-wrap msgid "" " char *\n" @@ -32641,7 +32788,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3916 +#: ../src/guestfs-actions.pod:3932 msgid "" "This function and C<guestfs_inspect_get_package_management> return the " "package format and package management tool used by the inspected operating " @@ -32650,17 +32797,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3935 ../src/guestfs-actions.pod:3963 +#: ../src/guestfs-actions.pod:3951 ../src/guestfs-actions.pod:3979 msgid "(Added in 1.7.5)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3937 +#: ../src/guestfs-actions.pod:3953 msgid "guestfs_inspect_get_package_management" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3939 +#: ../src/guestfs-actions.pod:3955 #, no-wrap msgid "" " char *\n" @@ -32670,7 +32817,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3943 +#: ../src/guestfs-actions.pod:3959 msgid "" "C<guestfs_inspect_get_package_format> and this function return the package " "format and package management tool used by the inspected operating system. " @@ -32679,12 +32826,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3965 +#: ../src/guestfs-actions.pod:3981 msgid "guestfs_inspect_get_product_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3967 +#: ../src/guestfs-actions.pod:3983 #, no-wrap msgid "" " char *\n" @@ -32694,12 +32841,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3986 +#: ../src/guestfs-actions.pod:4002 msgid "guestfs_inspect_get_product_variant" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3988 +#: ../src/guestfs-actions.pod:4004 #, no-wrap msgid "" " char *\n" @@ -32709,24 +32856,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4011 +#: ../src/guestfs-actions.pod:4027 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:4018 +#: ../src/guestfs-actions.pod:4034 msgid "(Added in 1.9.13)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4020 +#: ../src/guestfs-actions.pod:4036 msgid "guestfs_inspect_get_roots" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4022 +#: ../src/guestfs-actions.pod:4038 #, no-wrap msgid "" " char **\n" @@ -32735,7 +32882,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4025 +#: ../src/guestfs-actions.pod:4041 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 " @@ -32743,24 +32890,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4029 +#: ../src/guestfs-actions.pod:4045 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:4038 +#: ../src/guestfs-actions.pod:4054 msgid "(Added in 1.7.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4040 +#: ../src/guestfs-actions.pod:4056 msgid "guestfs_inspect_get_type" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4042 +#: ../src/guestfs-actions.pod:4058 #, no-wrap msgid "" " char *\n" @@ -32770,12 +32917,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4091 +#: ../src/guestfs-actions.pod:4107 msgid "guestfs_inspect_get_windows_current_control_set" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4093 +#: ../src/guestfs-actions.pod:4109 #, no-wrap msgid "" " char *\n" @@ -32785,12 +32932,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4111 +#: ../src/guestfs-actions.pod:4127 msgid "guestfs_inspect_get_windows_systemroot" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4113 +#: ../src/guestfs-actions.pod:4129 #, no-wrap msgid "" " char *\n" @@ -32800,17 +32947,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4129 +#: ../src/guestfs-actions.pod:4145 msgid "(Added in 1.5.25)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4131 +#: ../src/guestfs-actions.pod:4147 msgid "guestfs_inspect_is_live" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4133 +#: ../src/guestfs-actions.pod:4149 #, no-wrap msgid "" " int\n" @@ -32820,19 +32967,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4137 +#: ../src/guestfs-actions.pod:4153 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:4147 +#: ../src/guestfs-actions.pod:4163 msgid "guestfs_inspect_is_multipart" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4149 +#: ../src/guestfs-actions.pod:4165 #, no-wrap msgid "" " int\n" @@ -32842,19 +32989,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4153 +#: ../src/guestfs-actions.pod:4169 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:4163 +#: ../src/guestfs-actions.pod:4179 msgid "guestfs_inspect_is_netinst" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4165 +#: ../src/guestfs-actions.pod:4181 #, no-wrap msgid "" " int\n" @@ -32864,7 +33011,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4169 +#: ../src/guestfs-actions.pod:4185 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 " @@ -32873,12 +33020,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4181 +#: ../src/guestfs-actions.pod:4197 msgid "guestfs_inspect_list_applications" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4183 +#: ../src/guestfs-actions.pod:4199 #, no-wrap msgid "" " struct guestfs_application_list *\n" @@ -32888,7 +33035,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4189 +#: ../src/guestfs-actions.pod:4205 msgid "" "I<Note:> This call works differently from other parts of the inspection " "API. You have to call C<guestfs_inspect_os>, then " @@ -32901,7 +33048,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4279 +#: ../src/guestfs-actions.pod:4295 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> " @@ -32909,17 +33056,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4283 +#: ../src/guestfs-actions.pod:4299 msgid "(Added in 1.7.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4285 +#: ../src/guestfs-actions.pod:4301 msgid "guestfs_inspect_os" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4287 +#: ../src/guestfs-actions.pod:4303 #, no-wrap msgid "" " char **\n" @@ -32928,7 +33075,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4303 +#: ../src/guestfs-actions.pod:4319 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, " @@ -32936,7 +33083,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4308 +#: ../src/guestfs-actions.pod:4324 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 " @@ -32945,17 +33092,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4320 ../src/guestfs-actions.pod:4678 ../src/guestfs-actions.pod:4773 +#: ../src/guestfs-actions.pod:4336 ../src/guestfs-actions.pod:4703 ../src/guestfs-actions.pod:4798 msgid "See also C<guestfs_list_filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4328 +#: ../src/guestfs-actions.pod:4344 msgid "guestfs_is_blockdev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4330 +#: ../src/guestfs-actions.pod:4346 #, no-wrap msgid "" " int\n" @@ -32965,22 +33112,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4337 ../src/guestfs-actions.pod:4352 ../src/guestfs-actions.pod:4382 ../src/guestfs-actions.pod:4397 ../src/guestfs-actions.pod:4413 ../src/guestfs-actions.pod:4469 ../src/guestfs-actions.pod:4484 +#: ../src/guestfs-actions.pod:4353 ../src/guestfs-actions.pod:4368 ../src/guestfs-actions.pod:4398 ../src/guestfs-actions.pod:4413 ../src/guestfs-actions.pod:4429 ../src/guestfs-actions.pod:4485 ../src/guestfs-actions.pod:4500 msgid "See also C<guestfs_stat>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4341 ../src/guestfs-actions.pod:4356 ../src/guestfs-actions.pod:4401 ../src/guestfs-actions.pod:4473 ../src/guestfs-actions.pod:4488 +#: ../src/guestfs-actions.pod:4357 ../src/guestfs-actions.pod:4372 ../src/guestfs-actions.pod:4417 ../src/guestfs-actions.pod:4489 ../src/guestfs-actions.pod:4504 msgid "(Added in 1.5.10)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4343 +#: ../src/guestfs-actions.pod:4359 msgid "guestfs_is_chardev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4345 +#: ../src/guestfs-actions.pod:4361 #, no-wrap msgid "" " int\n" @@ -32990,12 +33137,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4358 +#: ../src/guestfs-actions.pod:4374 msgid "guestfs_is_config" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4360 +#: ../src/guestfs-actions.pod:4376 #, no-wrap msgid "" " int\n" @@ -33004,12 +33151,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4372 +#: ../src/guestfs-actions.pod:4388 msgid "guestfs_is_dir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4374 +#: ../src/guestfs-actions.pod:4390 #, no-wrap msgid "" " int\n" @@ -33019,12 +33166,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4388 +#: ../src/guestfs-actions.pod:4404 msgid "guestfs_is_fifo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4390 +#: ../src/guestfs-actions.pod:4406 #, no-wrap msgid "" " int\n" @@ -33034,12 +33181,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4403 +#: ../src/guestfs-actions.pod:4419 msgid "guestfs_is_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4405 +#: ../src/guestfs-actions.pod:4421 #, no-wrap msgid "" " int\n" @@ -33049,12 +33196,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4419 +#: ../src/guestfs-actions.pod:4435 msgid "guestfs_is_launching" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4421 +#: ../src/guestfs-actions.pod:4437 #, no-wrap msgid "" " int\n" @@ -33063,12 +33210,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4433 +#: ../src/guestfs-actions.pod:4449 msgid "guestfs_is_lv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4435 +#: ../src/guestfs-actions.pod:4451 #, no-wrap msgid "" " int\n" @@ -33078,12 +33225,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4446 +#: ../src/guestfs-actions.pod:4462 msgid "guestfs_is_ready" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4448 +#: ../src/guestfs-actions.pod:4464 #, no-wrap msgid "" " int\n" @@ -33092,12 +33239,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4460 +#: ../src/guestfs-actions.pod:4476 msgid "guestfs_is_socket" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4462 +#: ../src/guestfs-actions.pod:4478 #, no-wrap msgid "" " int\n" @@ -33107,12 +33254,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4475 +#: ../src/guestfs-actions.pod:4491 msgid "guestfs_is_symlink" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4477 +#: ../src/guestfs-actions.pod:4493 #, no-wrap msgid "" " int\n" @@ -33122,12 +33269,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4490 +#: ../src/guestfs-actions.pod:4506 msgid "guestfs_is_zero" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4492 +#: ../src/guestfs-actions.pod:4508 #, no-wrap msgid "" " int\n" @@ -33137,17 +33284,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4501 ../src/guestfs-actions.pod:4515 +#: ../src/guestfs-actions.pod:4517 ../src/guestfs-actions.pod:4531 msgid "(Added in 1.11.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4503 +#: ../src/guestfs-actions.pod:4519 msgid "guestfs_is_zero_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4505 +#: ../src/guestfs-actions.pod:4521 #, no-wrap msgid "" " int\n" @@ -33157,12 +33304,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4517 ../src/guestfs-structs.pod:268 +#: ../src/guestfs-actions.pod:4533 ../src/guestfs-structs.pod:268 msgid "guestfs_isoinfo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4519 +#: ../src/guestfs-actions.pod:4535 #, no-wrap msgid "" " struct guestfs_isoinfo *\n" @@ -33172,7 +33319,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4523 +#: ../src/guestfs-actions.pod:4539 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 " @@ -33181,24 +33328,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4529 ../src/guestfs-actions.pod:4552 +#: ../src/guestfs-actions.pod:4545 ../src/guestfs-actions.pod:4568 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:4533 ../src/guestfs-actions.pod:4556 +#: ../src/guestfs-actions.pod:4549 ../src/guestfs-actions.pod:4572 msgid "(Added in 1.17.19)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4535 +#: ../src/guestfs-actions.pod:4551 msgid "guestfs_isoinfo_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4537 +#: ../src/guestfs-actions.pod:4553 #, no-wrap msgid "" " struct guestfs_isoinfo *\n" @@ -33208,12 +33355,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4558 +#: ../src/guestfs-actions.pod:4574 msgid "guestfs_kill_subprocess" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4560 +#: ../src/guestfs-actions.pod:4576 #, no-wrap msgid "" " int\n" @@ -33221,13 +33368,25 @@ msgid "" "\n" msgstr "" +#. type: textblock +#: ../src/guestfs-actions.pod:4579 +msgid "" +"I<This function is deprecated.> In new code, use the L</guestfs_shutdown> " +"call instead." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:4588 +msgid "Do not call this. See: C<guestfs_shutdown> instead." +msgstr "" + #. type: =head2 -#: ../src/guestfs-actions.pod:4569 +#: ../src/guestfs-actions.pod:4594 msgid "guestfs_launch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4571 +#: ../src/guestfs-actions.pod:4596 #, no-wrap msgid "" " int\n" @@ -33236,12 +33395,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4589 +#: ../src/guestfs-actions.pod:4614 msgid "guestfs_lchown" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4591 +#: ../src/guestfs-actions.pod:4616 #, no-wrap msgid "" " int\n" @@ -33253,7 +33412,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4597 +#: ../src/guestfs-actions.pod:4622 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 " @@ -33261,12 +33420,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4609 +#: ../src/guestfs-actions.pod:4634 msgid "guestfs_lgetxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4611 +#: ../src/guestfs-actions.pod:4636 #, no-wrap msgid "" " char *\n" @@ -33278,17 +33437,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4631 +#: ../src/guestfs-actions.pod:4656 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4639 +#: ../src/guestfs-actions.pod:4664 msgid "guestfs_lgetxattrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4641 +#: ../src/guestfs-actions.pod:4666 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -33298,19 +33457,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4645 +#: ../src/guestfs-actions.pod:4670 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:4655 +#: ../src/guestfs-actions.pod:4680 msgid "guestfs_list_9p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4657 +#: ../src/guestfs-actions.pod:4682 #, no-wrap msgid "" " char **\n" @@ -33319,12 +33478,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4669 +#: ../src/guestfs-actions.pod:4694 msgid "guestfs_list_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4671 +#: ../src/guestfs-actions.pod:4696 #, no-wrap msgid "" " char **\n" @@ -33333,12 +33492,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4686 +#: ../src/guestfs-actions.pod:4711 msgid "guestfs_list_dm_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4688 +#: ../src/guestfs-actions.pod:4713 #, no-wrap msgid "" " char **\n" @@ -33347,14 +33506,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4693 +#: ../src/guestfs-actions.pod:4718 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:4696 +#: ../src/guestfs-actions.pod:4721 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 " @@ -33362,17 +33521,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4704 ../src/guestfs-actions.pod:6676 +#: ../src/guestfs-actions.pod:4729 ../src/guestfs-actions.pod:6715 msgid "(Added in 1.11.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4706 +#: ../src/guestfs-actions.pod:4731 msgid "guestfs_list_filesystems" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4708 +#: ../src/guestfs-actions.pod:4733 #, no-wrap msgid "" " char **\n" @@ -33381,7 +33540,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4728 +#: ../src/guestfs-actions.pod:4753 msgid "" "This command runs other libguestfs commands, which might include " "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this " @@ -33389,7 +33548,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4732 +#: ../src/guestfs-actions.pod:4757 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 " @@ -33400,17 +33559,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4746 ../src/guestfs-actions.pod:7036 +#: ../src/guestfs-actions.pod:4771 ../src/guestfs-actions.pod:7075 msgid "(Added in 1.5.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4748 +#: ../src/guestfs-actions.pod:4773 msgid "guestfs_list_md_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4750 +#: ../src/guestfs-actions.pod:4775 #, no-wrap msgid "" " char **\n" @@ -33419,17 +33578,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4759 ../src/guestfs-actions.pod:8806 +#: ../src/guestfs-actions.pod:4784 ../src/guestfs-actions.pod:8868 msgid "(Added in 1.15.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4761 +#: ../src/guestfs-actions.pod:4786 msgid "guestfs_list_partitions" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4763 +#: ../src/guestfs-actions.pod:4788 #, no-wrap msgid "" " char **\n" @@ -33438,19 +33597,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4770 +#: ../src/guestfs-actions.pod:4795 msgid "" "This does not return logical volumes. For that you will need to call " "C<guestfs_lvs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4781 +#: ../src/guestfs-actions.pod:4806 msgid "guestfs_ll" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4783 +#: ../src/guestfs-actions.pod:4808 #, no-wrap msgid "" " char *\n" @@ -33460,12 +33619,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4798 +#: ../src/guestfs-actions.pod:4823 msgid "guestfs_llz" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4800 +#: ../src/guestfs-actions.pod:4825 #, no-wrap msgid "" " char *\n" @@ -33475,17 +33634,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4812 ../src/guestfs-actions.pod:9437 +#: ../src/guestfs-actions.pod:4837 ../src/guestfs-actions.pod:9499 msgid "(Added in 1.17.6)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4814 +#: ../src/guestfs-actions.pod:4839 msgid "guestfs_ln" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4816 +#: ../src/guestfs-actions.pod:4841 #, no-wrap msgid "" " int\n" @@ -33496,12 +33655,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4827 +#: ../src/guestfs-actions.pod:4852 msgid "guestfs_ln_f" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4829 +#: ../src/guestfs-actions.pod:4854 #, no-wrap msgid "" " int\n" @@ -33512,12 +33671,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4841 +#: ../src/guestfs-actions.pod:4866 msgid "guestfs_ln_s" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4843 +#: ../src/guestfs-actions.pod:4868 #, no-wrap msgid "" " int\n" @@ -33528,12 +33687,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4854 +#: ../src/guestfs-actions.pod:4879 msgid "guestfs_ln_sf" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4856 +#: ../src/guestfs-actions.pod:4881 #, no-wrap msgid "" " int\n" @@ -33544,12 +33703,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4868 +#: ../src/guestfs-actions.pod:4893 msgid "guestfs_lremovexattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4870 +#: ../src/guestfs-actions.pod:4895 #, no-wrap msgid "" " int\n" @@ -33560,19 +33719,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4875 +#: ../src/guestfs-actions.pod:4900 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:4883 +#: ../src/guestfs-actions.pod:4908 msgid "guestfs_ls" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4885 +#: ../src/guestfs-actions.pod:4910 #, no-wrap msgid "" " char **\n" @@ -33582,19 +33741,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4893 +#: ../src/guestfs-actions.pod:4918 msgid "" "This command is mostly useful for interactive sessions. Programs should " "probably use C<guestfs_readdir> instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4902 +#: ../src/guestfs-actions.pod:4927 msgid "guestfs_lsetxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4904 +#: ../src/guestfs-actions.pod:4929 #, no-wrap msgid "" " int\n" @@ -33607,19 +33766,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4911 +#: ../src/guestfs-actions.pod:4936 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:4919 +#: ../src/guestfs-actions.pod:4944 msgid "guestfs_lstat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4921 +#: ../src/guestfs-actions.pod:4946 #, no-wrap msgid "" " struct guestfs_stat *\n" @@ -33629,31 +33788,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4927 +#: ../src/guestfs-actions.pod:4952 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:4933 ../src/guestfs-actions.pod:8325 +#: ../src/guestfs-actions.pod:4958 ../src/guestfs-actions.pod:8387 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:4937 ../src/guestfs-actions.pod:8329 ../src/guestfs-actions.pod:8347 ../src/guestfs-actions.pod:8850 +#: ../src/guestfs-actions.pod:4962 ../src/guestfs-actions.pod:8391 ../src/guestfs-actions.pod:8409 ../src/guestfs-actions.pod:8912 msgid "(Added in 0.9.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4939 +#: ../src/guestfs-actions.pod:4964 msgid "guestfs_lstatlist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4941 +#: ../src/guestfs-actions.pod:4966 #, no-wrap msgid "" " struct guestfs_stat_list *\n" @@ -33664,7 +33823,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4946 +#: ../src/guestfs-actions.pod:4971 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 " @@ -33672,7 +33831,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4955 +#: ../src/guestfs-actions.pod:4980 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> " @@ -33683,19 +33842,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4963 +#: ../src/guestfs-actions.pod:4988 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:4969 +#: ../src/guestfs-actions.pod:4994 msgid "guestfs_luks_add_key" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4971 +#: ../src/guestfs-actions.pod:4996 #, no-wrap msgid "" " int\n" @@ -33708,14 +33867,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4983 +#: ../src/guestfs-actions.pod:5008 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:4989 ../src/guestfs-actions.pod:5026 ../src/guestfs-actions.pod:5046 ../src/guestfs-actions.pod:5066 ../src/guestfs-actions.pod:5101 ../src/guestfs-actions.pod:5120 +#: ../src/guestfs-actions.pod:5014 ../src/guestfs-actions.pod:5051 ../src/guestfs-actions.pod:5071 ../src/guestfs-actions.pod:5091 ../src/guestfs-actions.pod:5126 ../src/guestfs-actions.pod:5145 msgid "" "This function takes a key or passphrase parameter which could contain " "sensitive material. Read the section L</KEYS AND PASSPHRASES> for more " @@ -33723,17 +33882,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4993 ../src/guestfs-actions.pod:5030 ../src/guestfs-actions.pod:5050 ../src/guestfs-actions.pod:5070 +#: ../src/guestfs-actions.pod:5018 ../src/guestfs-actions.pod:5055 ../src/guestfs-actions.pod:5075 ../src/guestfs-actions.pod:5095 msgid "(Added in 1.5.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4995 +#: ../src/guestfs-actions.pod:5020 msgid "guestfs_luks_close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4997 +#: ../src/guestfs-actions.pod:5022 #, no-wrap msgid "" " int\n" @@ -33743,7 +33902,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5001 +#: ../src/guestfs-actions.pod:5026 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 " @@ -33752,17 +33911,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5009 ../src/guestfs-actions.pod:5105 ../src/guestfs-actions.pod:5124 ../src/guestfs-actions.pod:5191 ../src/guestfs-actions.pod:5236 +#: ../src/guestfs-actions.pod:5034 ../src/guestfs-actions.pod:5130 ../src/guestfs-actions.pod:5149 ../src/guestfs-actions.pod:5216 ../src/guestfs-actions.pod:5261 msgid "(Added in 1.5.1)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5011 +#: ../src/guestfs-actions.pod:5036 msgid "guestfs_luks_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5013 +#: ../src/guestfs-actions.pod:5038 #, no-wrap msgid "" " int\n" @@ -33774,12 +33933,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5032 +#: ../src/guestfs-actions.pod:5057 msgid "guestfs_luks_format_cipher" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5034 +#: ../src/guestfs-actions.pod:5059 #, no-wrap msgid "" " int\n" @@ -33792,19 +33951,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5041 +#: ../src/guestfs-actions.pod:5066 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:5052 +#: ../src/guestfs-actions.pod:5077 msgid "guestfs_luks_kill_slot" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5054 +#: ../src/guestfs-actions.pod:5079 #, no-wrap msgid "" " int\n" @@ -33816,12 +33975,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5072 +#: ../src/guestfs-actions.pod:5097 msgid "guestfs_luks_open" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5074 +#: ../src/guestfs-actions.pod:5099 #, no-wrap msgid "" " int\n" @@ -33833,7 +33992,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5092 +#: ../src/guestfs-actions.pod:5117 msgid "" "If this block device contains LVM volume groups, then calling " "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them " @@ -33841,17 +34000,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5096 +#: ../src/guestfs-actions.pod:5121 msgid "Use C<guestfs_list_dm_devices> to list all device mapper devices." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5107 +#: ../src/guestfs-actions.pod:5132 msgid "guestfs_luks_open_ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5109 +#: ../src/guestfs-actions.pod:5134 #, no-wrap msgid "" " int\n" @@ -33863,19 +34022,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5115 +#: ../src/guestfs-actions.pod:5140 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:5126 +#: ../src/guestfs-actions.pod:5151 msgid "guestfs_lvcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5128 +#: ../src/guestfs-actions.pod:5153 #, no-wrap msgid "" " int\n" @@ -33887,12 +34046,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5141 +#: ../src/guestfs-actions.pod:5166 msgid "guestfs_lvcreate_free" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5143 +#: ../src/guestfs-actions.pod:5168 #, no-wrap msgid "" " int\n" @@ -33904,17 +34063,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5156 ../src/guestfs-actions.pod:9623 +#: ../src/guestfs-actions.pod:5181 ../src/guestfs-actions.pod:9685 msgid "(Added in 1.17.18)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5158 +#: ../src/guestfs-actions.pod:5183 msgid "guestfs_lvm_canonical_lv_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5160 +#: ../src/guestfs-actions.pod:5185 #, no-wrap msgid "" " char *\n" @@ -33924,22 +34083,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5171 +#: ../src/guestfs-actions.pod:5196 msgid "See also C<guestfs_is_lv>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5176 +#: ../src/guestfs-actions.pod:5201 msgid "(Added in 1.5.24)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5178 +#: ../src/guestfs-actions.pod:5203 msgid "guestfs_lvm_clear_filter" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5180 +#: ../src/guestfs-actions.pod:5205 #, no-wrap msgid "" " int\n" @@ -33948,19 +34107,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5183 +#: ../src/guestfs-actions.pod:5208 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:5193 +#: ../src/guestfs-actions.pod:5218 msgid "guestfs_lvm_remove_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5195 +#: ../src/guestfs-actions.pod:5220 #, no-wrap msgid "" " int\n" @@ -33969,12 +34128,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5205 +#: ../src/guestfs-actions.pod:5230 msgid "guestfs_lvm_set_filter" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5207 +#: ../src/guestfs-actions.pod:5232 #, no-wrap msgid "" " int\n" @@ -33984,12 +34143,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5238 +#: ../src/guestfs-actions.pod:5263 msgid "guestfs_lvremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5240 +#: ../src/guestfs-actions.pod:5265 #, no-wrap msgid "" " int\n" @@ -33999,17 +34158,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5252 ../src/guestfs-actions.pod:7151 ../src/guestfs-actions.pod:9281 +#: ../src/guestfs-actions.pod:5277 ../src/guestfs-actions.pod:7190 ../src/guestfs-actions.pod:9343 msgid "(Added in 1.0.13)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5254 +#: ../src/guestfs-actions.pod:5279 msgid "guestfs_lvrename" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5256 +#: ../src/guestfs-actions.pod:5281 #, no-wrap msgid "" " int\n" @@ -34020,17 +34179,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5265 ../src/guestfs-actions.pod:9294 +#: ../src/guestfs-actions.pod:5290 ../src/guestfs-actions.pod:9356 msgid "(Added in 1.0.83)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5267 +#: ../src/guestfs-actions.pod:5292 msgid "guestfs_lvresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5269 +#: ../src/guestfs-actions.pod:5294 #, no-wrap msgid "" " int\n" @@ -34041,12 +34200,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5282 +#: ../src/guestfs-actions.pod:5307 msgid "guestfs_lvresize_free" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5284 +#: ../src/guestfs-actions.pod:5309 #, no-wrap msgid "" " int\n" @@ -34057,17 +34216,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5297 +#: ../src/guestfs-actions.pod:5322 msgid "(Added in 1.3.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5299 +#: ../src/guestfs-actions.pod:5324 msgid "guestfs_lvs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5301 +#: ../src/guestfs-actions.pod:5326 #, no-wrap msgid "" " char **\n" @@ -34076,17 +34235,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5310 +#: ../src/guestfs-actions.pod:5335 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5318 +#: ../src/guestfs-actions.pod:5343 msgid "guestfs_lvs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5320 +#: ../src/guestfs-actions.pod:5345 #, no-wrap msgid "" " struct guestfs_lvm_lv_list *\n" @@ -34095,7 +34254,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5326 +#: ../src/guestfs-actions.pod:5351 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 " @@ -34103,12 +34262,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5332 +#: ../src/guestfs-actions.pod:5357 msgid "guestfs_lvuuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5334 +#: ../src/guestfs-actions.pod:5359 #, no-wrap msgid "" " char *\n" @@ -34118,12 +34277,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5345 +#: ../src/guestfs-actions.pod:5370 msgid "guestfs_lxattrlist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5347 +#: ../src/guestfs-actions.pod:5372 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -34134,7 +34293,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5366 +#: ../src/guestfs-actions.pod:5391 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 " @@ -34145,12 +34304,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5380 +#: ../src/guestfs-actions.pod:5405 msgid "guestfs_md_create" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5382 +#: ../src/guestfs-actions.pod:5407 #, no-wrap msgid "" " int\n" @@ -34162,7 +34321,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5393 +#: ../src/guestfs-actions.pod:5418 #, no-wrap msgid "" " GUESTFS_MD_CREATE_MISSINGBITMAP, int64_t missingbitmap,\n" @@ -34174,17 +34333,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5455 ../src/guestfs-actions.pod:5521 ../src/guestfs-actions.pod:5591 +#: ../src/guestfs-actions.pod:5480 ../src/guestfs-actions.pod:5546 ../src/guestfs-actions.pod:5616 msgid "(Added in 1.15.6)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5457 +#: ../src/guestfs-actions.pod:5482 msgid "guestfs_md_create_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5459 +#: ../src/guestfs-actions.pod:5484 #, no-wrap msgid "" " int\n" @@ -34196,17 +34355,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5465 +#: ../src/guestfs-actions.pod:5490 msgid "This is the \"va_list variant\" of L</guestfs_md_create>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5469 +#: ../src/guestfs-actions.pod:5494 msgid "guestfs_md_create_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5471 +#: ../src/guestfs-actions.pod:5496 #, no-wrap msgid "" " int\n" @@ -34218,17 +34377,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5477 +#: ../src/guestfs-actions.pod:5502 msgid "This is the \"argv variant\" of L</guestfs_md_create>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5481 +#: ../src/guestfs-actions.pod:5506 msgid "guestfs_md_detail" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5483 +#: ../src/guestfs-actions.pod:5508 #, no-wrap msgid "" " char **\n" @@ -34238,12 +34397,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5523 +#: ../src/guestfs-actions.pod:5548 msgid "guestfs_md_stat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5525 +#: ../src/guestfs-actions.pod:5550 #, no-wrap msgid "" " struct guestfs_mdstat_list *\n" @@ -34253,12 +34412,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5532 +#: ../src/guestfs-actions.pod:5557 msgid "To get a list of software RAID devices, call C<guestfs_list_md_devices>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5574 +#: ../src/guestfs-actions.pod:5599 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 " @@ -34266,17 +34425,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5578 +#: ../src/guestfs-actions.pod:5603 msgid "(Added in 1.17.21)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5580 +#: ../src/guestfs-actions.pod:5605 msgid "guestfs_md_stop" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5582 +#: ../src/guestfs-actions.pod:5607 #, no-wrap msgid "" " int\n" @@ -34286,12 +34445,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5593 +#: ../src/guestfs-actions.pod:5618 msgid "guestfs_mkdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5595 +#: ../src/guestfs-actions.pod:5620 #, no-wrap msgid "" " int\n" @@ -34301,12 +34460,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5605 +#: ../src/guestfs-actions.pod:5630 msgid "guestfs_mkdir_mode" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5607 +#: ../src/guestfs-actions.pod:5632 #, no-wrap msgid "" " int\n" @@ -34317,17 +34476,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5619 +#: ../src/guestfs-actions.pod:5644 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5625 +#: ../src/guestfs-actions.pod:5650 msgid "guestfs_mkdir_p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5627 +#: ../src/guestfs-actions.pod:5652 #, no-wrap msgid "" " int\n" @@ -34337,12 +34496,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5638 +#: ../src/guestfs-actions.pod:5663 msgid "guestfs_mkdtemp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5640 +#: ../src/guestfs-actions.pod:5665 #, no-wrap msgid "" " char *\n" @@ -34352,12 +34511,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5668 +#: ../src/guestfs-actions.pod:5693 msgid "guestfs_mke2fs_J" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5670 +#: ../src/guestfs-actions.pod:5695 #, no-wrap msgid "" " int\n" @@ -34370,22 +34529,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5683 +#: ../src/guestfs-actions.pod:5708 msgid "See also C<guestfs_mke2journal>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5687 ../src/guestfs-actions.pod:5705 ../src/guestfs-actions.pod:5723 ../src/guestfs-actions.pod:5739 ../src/guestfs-actions.pod:5753 ../src/guestfs-actions.pod:5767 ../src/guestfs-actions.pod:5826 ../src/guestfs-actions.pod:6158 +#: ../src/guestfs-actions.pod:5712 ../src/guestfs-actions.pod:5730 ../src/guestfs-actions.pod:5748 ../src/guestfs-actions.pod:5764 ../src/guestfs-actions.pod:5778 ../src/guestfs-actions.pod:5792 ../src/guestfs-actions.pod:5851 ../src/guestfs-actions.pod:6183 msgid "(Added in 1.0.68)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5689 +#: ../src/guestfs-actions.pod:5714 msgid "guestfs_mke2fs_JL" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5691 +#: ../src/guestfs-actions.pod:5716 #, no-wrap msgid "" " int\n" @@ -34398,17 +34557,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5701 +#: ../src/guestfs-actions.pod:5726 msgid "See also C<guestfs_mke2journal_L>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5707 +#: ../src/guestfs-actions.pod:5732 msgid "guestfs_mke2fs_JU" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5709 +#: ../src/guestfs-actions.pod:5734 #, no-wrap msgid "" " int\n" @@ -34421,17 +34580,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5719 +#: ../src/guestfs-actions.pod:5744 msgid "See also C<guestfs_mke2journal_U>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5725 +#: ../src/guestfs-actions.pod:5750 msgid "guestfs_mke2journal" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5727 +#: ../src/guestfs-actions.pod:5752 #, no-wrap msgid "" " int\n" @@ -34442,12 +34601,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5741 +#: ../src/guestfs-actions.pod:5766 msgid "guestfs_mke2journal_L" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5743 +#: ../src/guestfs-actions.pod:5768 #, no-wrap msgid "" " int\n" @@ -34459,12 +34618,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5755 +#: ../src/guestfs-actions.pod:5780 msgid "guestfs_mke2journal_U" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5757 +#: ../src/guestfs-actions.pod:5782 #, no-wrap msgid "" " int\n" @@ -34476,12 +34635,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5769 +#: ../src/guestfs-actions.pod:5794 msgid "guestfs_mkfifo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5771 +#: ../src/guestfs-actions.pod:5796 #, no-wrap msgid "" " int\n" @@ -34492,19 +34651,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5776 +#: ../src/guestfs-actions.pod:5801 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:5786 +#: ../src/guestfs-actions.pod:5811 msgid "guestfs_mkfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5788 +#: ../src/guestfs-actions.pod:5813 #, no-wrap msgid "" " int\n" @@ -34515,12 +34674,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5801 +#: ../src/guestfs-actions.pod:5826 msgid "guestfs_mkfs_b" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5803 +#: ../src/guestfs-actions.pod:5828 #, no-wrap msgid "" " int\n" @@ -34532,14 +34691,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5809 +#: ../src/guestfs-actions.pod:5834 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_mkfs_opts> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5816 +#: ../src/guestfs-actions.pod:5841 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 " @@ -34547,12 +34706,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5828 +#: ../src/guestfs-actions.pod:5853 msgid "guestfs_mkfs_btrfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5830 +#: ../src/guestfs-actions.pod:5855 #, no-wrap msgid "" " int\n" @@ -34563,7 +34722,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5840 +#: ../src/guestfs-actions.pod:5865 #, no-wrap msgid "" " GUESTFS_MKFS_BTRFS_ALLOCSTART, int64_t allocstart,\n" @@ -34578,22 +34737,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5855 +#: ../src/guestfs-actions.pod:5880 msgid "To create general filesystems, use C<guestfs_mkfs_opts>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5859 +#: ../src/guestfs-actions.pod:5884 msgid "(Added in 1.17.25)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5861 +#: ../src/guestfs-actions.pod:5886 msgid "guestfs_mkfs_btrfs_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5863 +#: ../src/guestfs-actions.pod:5888 #, no-wrap msgid "" " int\n" @@ -34604,17 +34763,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5868 +#: ../src/guestfs-actions.pod:5893 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_btrfs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5872 +#: ../src/guestfs-actions.pod:5897 msgid "guestfs_mkfs_btrfs_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5874 +#: ../src/guestfs-actions.pod:5899 #, no-wrap msgid "" " int\n" @@ -34625,17 +34784,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5879 +#: ../src/guestfs-actions.pod:5904 msgid "This is the \"argv variant\" of L</guestfs_mkfs_btrfs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5883 +#: ../src/guestfs-actions.pod:5908 msgid "guestfs_mkfs_opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5885 +#: ../src/guestfs-actions.pod:5910 #, no-wrap msgid "" " int\n" @@ -34647,7 +34806,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5896 +#: ../src/guestfs-actions.pod:5921 #, no-wrap msgid "" " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n" @@ -34658,17 +34817,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5944 +#: ../src/guestfs-actions.pod:5969 msgid "(Added in 1.7.19)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5946 +#: ../src/guestfs-actions.pod:5971 msgid "guestfs_mkfs_opts_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5948 +#: ../src/guestfs-actions.pod:5973 #, no-wrap msgid "" " int\n" @@ -34680,17 +34839,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5954 +#: ../src/guestfs-actions.pod:5979 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5958 +#: ../src/guestfs-actions.pod:5983 msgid "guestfs_mkfs_opts_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5960 +#: ../src/guestfs-actions.pod:5985 #, no-wrap msgid "" " int\n" @@ -34702,17 +34861,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5966 +#: ../src/guestfs-actions.pod:5991 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5970 +#: ../src/guestfs-actions.pod:5995 msgid "guestfs_mkmountpoint" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5972 +#: ../src/guestfs-actions.pod:5997 #, no-wrap msgid "" " int\n" @@ -34722,7 +34881,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5976 +#: ../src/guestfs-actions.pod:6001 msgid "" "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls " "that can be used to create extra mountpoints before mounting the first " @@ -34730,7 +34889,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6000 +#: ../src/guestfs-actions.pod:6025 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 " @@ -34738,7 +34897,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6004 +#: ../src/guestfs-actions.pod:6029 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 " @@ -34747,7 +34906,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6011 +#: ../src/guestfs-actions.pod:6036 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 " @@ -34755,17 +34914,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6017 ../src/guestfs-actions.pod:6417 ../src/guestfs-actions.pod:7571 +#: ../src/guestfs-actions.pod:6042 ../src/guestfs-actions.pod:6442 ../src/guestfs-actions.pod:7610 msgid "(Added in 1.0.62)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6019 +#: ../src/guestfs-actions.pod:6044 msgid "guestfs_mknod" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6021 +#: ../src/guestfs-actions.pod:6046 #, no-wrap msgid "" " int\n" @@ -34778,7 +34937,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6036 +#: ../src/guestfs-actions.pod:6061 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 " @@ -34789,12 +34948,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6050 +#: ../src/guestfs-actions.pod:6075 msgid "guestfs_mknod_b" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6052 +#: ../src/guestfs-actions.pod:6077 #, no-wrap msgid "" " int\n" @@ -34807,7 +34966,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6059 +#: ../src/guestfs-actions.pod:6084 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 " @@ -34815,12 +34974,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6069 +#: ../src/guestfs-actions.pod:6094 msgid "guestfs_mknod_c" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6071 +#: ../src/guestfs-actions.pod:6096 #, no-wrap msgid "" " int\n" @@ -34833,7 +34992,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6078 +#: ../src/guestfs-actions.pod:6103 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 " @@ -34841,12 +35000,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6088 +#: ../src/guestfs-actions.pod:6113 msgid "guestfs_mkswap" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6090 +#: ../src/guestfs-actions.pod:6115 #, no-wrap msgid "" " int\n" @@ -34856,12 +35015,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6100 +#: ../src/guestfs-actions.pod:6125 msgid "guestfs_mkswap_L" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6102 +#: ../src/guestfs-actions.pod:6127 #, no-wrap msgid "" " int\n" @@ -34872,12 +35031,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6117 +#: ../src/guestfs-actions.pod:6142 msgid "guestfs_mkswap_U" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6119 +#: ../src/guestfs-actions.pod:6144 #, no-wrap msgid "" " int\n" @@ -34888,12 +35047,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6130 +#: ../src/guestfs-actions.pod:6155 msgid "guestfs_mkswap_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6132 +#: ../src/guestfs-actions.pod:6157 #, no-wrap msgid "" " int\n" @@ -34903,19 +35062,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6138 +#: ../src/guestfs-actions.pod:6163 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:6145 +#: ../src/guestfs-actions.pod:6170 msgid "guestfs_modprobe" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6147 +#: ../src/guestfs-actions.pod:6172 #, no-wrap msgid "" " int\n" @@ -34925,12 +35084,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6160 +#: ../src/guestfs-actions.pod:6185 msgid "guestfs_mount" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6162 +#: ../src/guestfs-actions.pod:6187 #, no-wrap msgid "" " int\n" @@ -34941,7 +35100,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6181 +#: ../src/guestfs-actions.pod:6206 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 " @@ -34951,12 +35110,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6192 +#: ../src/guestfs-actions.pod:6217 msgid "guestfs_mount_9p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6194 +#: ../src/guestfs-actions.pod:6219 #, no-wrap msgid "" " int\n" @@ -34968,7 +35127,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6205 +#: ../src/guestfs-actions.pod:6230 #, no-wrap msgid "" " GUESTFS_MOUNT_9P_OPTIONS, const char *options,\n" @@ -34976,12 +35135,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6218 +#: ../src/guestfs-actions.pod:6243 msgid "guestfs_mount_9p_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6220 +#: ../src/guestfs-actions.pod:6245 #, no-wrap msgid "" " int\n" @@ -34993,17 +35152,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6226 +#: ../src/guestfs-actions.pod:6251 msgid "This is the \"va_list variant\" of L</guestfs_mount_9p>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6230 +#: ../src/guestfs-actions.pod:6255 msgid "guestfs_mount_9p_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6232 +#: ../src/guestfs-actions.pod:6257 #, no-wrap msgid "" " int\n" @@ -35015,17 +35174,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6238 +#: ../src/guestfs-actions.pod:6263 msgid "This is the \"argv variant\" of L</guestfs_mount_9p>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6242 +#: ../src/guestfs-actions.pod:6267 msgid "guestfs_mount_local" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6244 +#: ../src/guestfs-actions.pod:6269 #, no-wrap msgid "" " int\n" @@ -35036,7 +35195,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6254 +#: ../src/guestfs-actions.pod:6279 #, no-wrap msgid "" " GUESTFS_MOUNT_LOCAL_READONLY, int readonly,\n" @@ -35047,7 +35206,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6277 +#: ../src/guestfs-actions.pod:6302 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 " @@ -35055,17 +35214,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6285 ../src/guestfs-actions.pod:6334 ../src/guestfs-actions.pod:8954 +#: ../src/guestfs-actions.pod:6310 ../src/guestfs-actions.pod:6359 ../src/guestfs-actions.pod:9016 msgid "(Added in 1.17.22)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6287 +#: ../src/guestfs-actions.pod:6312 msgid "guestfs_mount_local_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6289 +#: ../src/guestfs-actions.pod:6314 #, no-wrap msgid "" " int\n" @@ -35076,17 +35235,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6294 +#: ../src/guestfs-actions.pod:6319 msgid "This is the \"va_list variant\" of L</guestfs_mount_local>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6298 +#: ../src/guestfs-actions.pod:6323 msgid "guestfs_mount_local_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6300 +#: ../src/guestfs-actions.pod:6325 #, no-wrap msgid "" " int\n" @@ -35098,17 +35257,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6305 +#: ../src/guestfs-actions.pod:6330 msgid "This is the \"argv variant\" of L</guestfs_mount_local>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6309 +#: ../src/guestfs-actions.pod:6334 msgid "guestfs_mount_local_run" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6311 +#: ../src/guestfs-actions.pod:6336 #, no-wrap msgid "" " int\n" @@ -35117,21 +35276,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6317 +#: ../src/guestfs-actions.pod:6342 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:6321 +#: ../src/guestfs-actions.pod:6346 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:6325 +#: ../src/guestfs-actions.pod:6350 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 " @@ -35139,12 +35298,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6336 +#: ../src/guestfs-actions.pod:6361 msgid "guestfs_mount_loop" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6338 +#: ../src/guestfs-actions.pod:6363 #, no-wrap msgid "" " int\n" @@ -35155,12 +35314,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6351 +#: ../src/guestfs-actions.pod:6376 msgid "guestfs_mount_options" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6353 +#: ../src/guestfs-actions.pod:6378 #, no-wrap msgid "" " int\n" @@ -35172,24 +35331,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6359 +#: ../src/guestfs-actions.pod:6384 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:6369 ../src/guestfs-actions.pod:6383 ../src/guestfs-actions.pod:6400 +#: ../src/guestfs-actions.pod:6394 ../src/guestfs-actions.pod:6408 ../src/guestfs-actions.pod:6425 msgid "(Added in 1.0.10)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6371 +#: ../src/guestfs-actions.pod:6396 msgid "guestfs_mount_ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6373 +#: ../src/guestfs-actions.pod:6398 #, no-wrap msgid "" " int\n" @@ -35200,19 +35359,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6378 +#: ../src/guestfs-actions.pod:6403 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:6385 +#: ../src/guestfs-actions.pod:6410 msgid "guestfs_mount_vfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6387 +#: ../src/guestfs-actions.pod:6412 #, no-wrap msgid "" " int\n" @@ -35225,7 +35384,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6394 +#: ../src/guestfs-actions.pod:6419 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 " @@ -35233,12 +35392,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6402 +#: ../src/guestfs-actions.pod:6427 msgid "guestfs_mountpoints" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6404 +#: ../src/guestfs-actions.pod:6429 #, no-wrap msgid "" " char **\n" @@ -35247,7 +35406,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6407 +#: ../src/guestfs-actions.pod:6432 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 " @@ -35255,12 +35414,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6419 +#: ../src/guestfs-actions.pod:6444 msgid "guestfs_mounts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6421 +#: ../src/guestfs-actions.pod:6446 #, no-wrap msgid "" " char **\n" @@ -35269,17 +35428,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6429 +#: ../src/guestfs-actions.pod:6454 msgid "See also: C<guestfs_mountpoints>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6437 +#: ../src/guestfs-actions.pod:6462 msgid "guestfs_mv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6439 +#: ../src/guestfs-actions.pod:6464 #, no-wrap msgid "" " int\n" @@ -35290,12 +35449,41 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6451 +#: ../src/guestfs-actions.pod:6476 +msgid "guestfs_nr_devices" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:6478 +#, no-wrap +msgid "" +" int\n" +" guestfs_nr_devices (guestfs_h *g);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:6481 +msgid "" +"This returns the number of whole block devices that were added. This is the " +"same as the number of devices that would be returned if you called " +"C<guestfs_list_devices>." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:6485 +msgid "" +"To find out the maximum number of devices that could be added, call " +"C<guestfs_max_disks>." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:6490 msgid "guestfs_ntfs_3g_probe" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6453 +#: ../src/guestfs-actions.pod:6492 #, no-wrap msgid "" " int\n" @@ -35306,17 +35494,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6472 +#: ../src/guestfs-actions.pod:6511 msgid "(Added in 1.0.43)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6474 +#: ../src/guestfs-actions.pod:6513 msgid "guestfs_ntfsclone_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6476 +#: ../src/guestfs-actions.pod:6515 #, no-wrap msgid "" " int\n" @@ -35327,24 +35515,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6481 +#: ../src/guestfs-actions.pod:6520 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:6487 ../src/guestfs-actions.pod:6525 ../src/guestfs-actions.pod:6577 ../src/guestfs-actions.pod:7858 +#: ../src/guestfs-actions.pod:6526 ../src/guestfs-actions.pod:6564 ../src/guestfs-actions.pod:6616 ../src/guestfs-actions.pod:7897 msgid "(Added in 1.17.9)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6489 +#: ../src/guestfs-actions.pod:6528 msgid "guestfs_ntfsclone_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6491 +#: ../src/guestfs-actions.pod:6530 #, no-wrap msgid "" " int\n" @@ -35356,7 +35544,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6502 +#: ../src/guestfs-actions.pod:6541 #, no-wrap msgid "" " GUESTFS_NTFSCLONE_OUT_METADATAONLY, int metadataonly,\n" @@ -35368,17 +35556,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6520 +#: ../src/guestfs-actions.pod:6559 msgid "Use C<guestfs_ntfsclone_in> to restore the file back to a libguestfs device." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6527 +#: ../src/guestfs-actions.pod:6566 msgid "guestfs_ntfsclone_out_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6529 +#: ../src/guestfs-actions.pod:6568 #, no-wrap msgid "" " int\n" @@ -35390,17 +35578,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6535 +#: ../src/guestfs-actions.pod:6574 msgid "This is the \"va_list variant\" of L</guestfs_ntfsclone_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6539 +#: ../src/guestfs-actions.pod:6578 msgid "guestfs_ntfsclone_out_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6541 +#: ../src/guestfs-actions.pod:6580 #, no-wrap msgid "" " int\n" @@ -35413,17 +35601,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6547 +#: ../src/guestfs-actions.pod:6586 msgid "This is the \"argv variant\" of L</guestfs_ntfsclone_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6551 +#: ../src/guestfs-actions.pod:6590 msgid "guestfs_ntfsfix" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6553 +#: ../src/guestfs-actions.pod:6592 #, no-wrap msgid "" " int\n" @@ -35434,7 +35622,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6563 +#: ../src/guestfs-actions.pod:6602 #, no-wrap msgid "" " GUESTFS_NTFSFIX_CLEARBADSECTORS, int clearbadsectors,\n" @@ -35442,12 +35630,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6579 +#: ../src/guestfs-actions.pod:6618 msgid "guestfs_ntfsfix_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6581 +#: ../src/guestfs-actions.pod:6620 #, no-wrap msgid "" " int\n" @@ -35458,17 +35646,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6586 +#: ../src/guestfs-actions.pod:6625 msgid "This is the \"va_list variant\" of L</guestfs_ntfsfix>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6590 +#: ../src/guestfs-actions.pod:6629 msgid "guestfs_ntfsfix_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6592 +#: ../src/guestfs-actions.pod:6631 #, no-wrap msgid "" " int\n" @@ -35479,17 +35667,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6597 +#: ../src/guestfs-actions.pod:6636 msgid "This is the \"argv variant\" of L</guestfs_ntfsfix>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6601 +#: ../src/guestfs-actions.pod:6640 msgid "guestfs_ntfsresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6603 +#: ../src/guestfs-actions.pod:6642 #, no-wrap msgid "" " int\n" @@ -35499,19 +35687,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6607 ../src/guestfs-actions.pod:6707 +#: ../src/guestfs-actions.pod:6646 ../src/guestfs-actions.pod:6746 msgid "" "I<This function is deprecated.> In new code, use the " "L</guestfs_ntfsresize_opts> call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6631 +#: ../src/guestfs-actions.pod:6670 msgid "guestfs_ntfsresize_opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6633 +#: ../src/guestfs-actions.pod:6672 #, no-wrap msgid "" " int\n" @@ -35522,7 +35710,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6643 +#: ../src/guestfs-actions.pod:6682 #, no-wrap msgid "" " GUESTFS_NTFSRESIZE_OPTS_SIZE, int64_t size,\n" @@ -35531,7 +35719,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6663 +#: ../src/guestfs-actions.pod:6702 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 " @@ -35542,12 +35730,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6678 +#: ../src/guestfs-actions.pod:6717 msgid "guestfs_ntfsresize_opts_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6680 +#: ../src/guestfs-actions.pod:6719 #, no-wrap msgid "" " int\n" @@ -35558,17 +35746,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6685 +#: ../src/guestfs-actions.pod:6724 msgid "This is the \"va_list variant\" of L</guestfs_ntfsresize_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6689 +#: ../src/guestfs-actions.pod:6728 msgid "guestfs_ntfsresize_opts_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6691 +#: ../src/guestfs-actions.pod:6730 #, no-wrap msgid "" " int\n" @@ -35580,17 +35768,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6696 +#: ../src/guestfs-actions.pod:6735 msgid "This is the \"argv variant\" of L</guestfs_ntfsresize_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6700 +#: ../src/guestfs-actions.pod:6739 msgid "guestfs_ntfsresize_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6702 +#: ../src/guestfs-actions.pod:6741 #, no-wrap msgid "" " int\n" @@ -35601,24 +35789,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6714 +#: ../src/guestfs-actions.pod:6753 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:6719 ../src/guestfs-actions.pod:7178 ../src/guestfs-actions.pod:7251 ../src/guestfs-actions.pod:7519 ../src/guestfs-actions.pod:9457 +#: ../src/guestfs-actions.pod:6758 ../src/guestfs-actions.pod:7217 ../src/guestfs-actions.pod:7290 ../src/guestfs-actions.pod:7558 ../src/guestfs-actions.pod:9519 msgid "(Added in 1.3.14)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6721 +#: ../src/guestfs-actions.pod:6760 msgid "guestfs_part_add" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6723 +#: ../src/guestfs-actions.pod:6762 #, no-wrap msgid "" " int\n" @@ -35631,31 +35819,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6730 +#: ../src/guestfs-actions.pod:6769 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:6742 +#: ../src/guestfs-actions.pod:6781 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:6747 ../src/guestfs-actions.pod:6782 ../src/guestfs-actions.pod:6835 ../src/guestfs-actions.pod:6919 ../src/guestfs-actions.pod:6957 ../src/guestfs-actions.pod:6976 ../src/guestfs-actions.pod:7016 +#: ../src/guestfs-actions.pod:6786 ../src/guestfs-actions.pod:6821 ../src/guestfs-actions.pod:6874 ../src/guestfs-actions.pod:6958 ../src/guestfs-actions.pod:6996 ../src/guestfs-actions.pod:7015 ../src/guestfs-actions.pod:7055 msgid "(Added in 1.0.78)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6749 +#: ../src/guestfs-actions.pod:6788 msgid "guestfs_part_del" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6751 +#: ../src/guestfs-actions.pod:6790 #, no-wrap msgid "" " int\n" @@ -35666,12 +35854,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6766 +#: ../src/guestfs-actions.pod:6805 msgid "guestfs_part_disk" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6768 +#: ../src/guestfs-actions.pod:6807 #, no-wrap msgid "" " int\n" @@ -35682,7 +35870,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6773 +#: ../src/guestfs-actions.pod:6812 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 " @@ -35690,19 +35878,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6777 +#: ../src/guestfs-actions.pod:6816 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:6784 +#: ../src/guestfs-actions.pod:6823 msgid "guestfs_part_get_bootable" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6786 +#: ../src/guestfs-actions.pod:6825 #, no-wrap msgid "" " int\n" @@ -35713,17 +35901,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6794 +#: ../src/guestfs-actions.pod:6833 msgid "See also C<guestfs_part_set_bootable>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6800 +#: ../src/guestfs-actions.pod:6839 msgid "guestfs_part_get_mbr_id" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6802 +#: ../src/guestfs-actions.pod:6841 #, no-wrap msgid "" " int\n" @@ -35734,7 +35922,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6810 ../src/guestfs-actions.pod:6992 +#: ../src/guestfs-actions.pod:6849 ../src/guestfs-actions.pod:7031 msgid "" "Note that only MBR (old DOS-style) partitions have type bytes. You will get " "undefined results for other partition table types (see " @@ -35742,12 +35930,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6818 +#: ../src/guestfs-actions.pod:6857 msgid "guestfs_part_get_parttype" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6820 +#: ../src/guestfs-actions.pod:6859 #, no-wrap msgid "" " char *\n" @@ -35757,7 +35945,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6827 +#: ../src/guestfs-actions.pod:6866 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 " @@ -35765,12 +35953,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6837 +#: ../src/guestfs-actions.pod:6876 msgid "guestfs_part_init" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6839 +#: ../src/guestfs-actions.pod:6878 #, no-wrap msgid "" " int\n" @@ -35781,19 +35969,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6848 +#: ../src/guestfs-actions.pod:6887 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:6921 +#: ../src/guestfs-actions.pod:6960 msgid "guestfs_part_list" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6923 +#: ../src/guestfs-actions.pod:6962 #, no-wrap msgid "" " struct guestfs_partition_list *\n" @@ -35803,14 +35991,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6940 +#: ../src/guestfs-actions.pod:6979 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:6953 +#: ../src/guestfs-actions.pod:6992 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 " @@ -35818,12 +36006,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6959 +#: ../src/guestfs-actions.pod:6998 msgid "guestfs_part_set_bootable" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6961 +#: ../src/guestfs-actions.pod:7000 #, no-wrap msgid "" " int\n" @@ -35835,12 +36023,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6978 +#: ../src/guestfs-actions.pod:7017 msgid "guestfs_part_set_mbr_id" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6980 +#: ../src/guestfs-actions.pod:7019 #, no-wrap msgid "" " int\n" @@ -35852,12 +36040,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7000 +#: ../src/guestfs-actions.pod:7039 msgid "guestfs_part_set_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7002 +#: ../src/guestfs-actions.pod:7041 #, no-wrap msgid "" " int\n" @@ -35869,12 +36057,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7018 +#: ../src/guestfs-actions.pod:7057 msgid "guestfs_part_to_dev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7020 +#: ../src/guestfs-actions.pod:7059 #, no-wrap msgid "" " char *\n" @@ -35884,24 +36072,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7028 ../src/guestfs-actions.pod:7047 +#: ../src/guestfs-actions.pod:7067 ../src/guestfs-actions.pod:7086 msgid "" "The named partition must exist, for example as a string returned from " "C<guestfs_list_partitions>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7031 -msgid "See also C<guestfs_part_to_partnum>." +#: ../src/guestfs-actions.pod:7070 +msgid "See also C<guestfs_part_to_partnum>, C<guestfs_device_index>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7038 +#: ../src/guestfs-actions.pod:7077 msgid "guestfs_part_to_partnum" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7040 +#: ../src/guestfs-actions.pod:7079 #, no-wrap msgid "" " int\n" @@ -35911,17 +36099,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7050 +#: ../src/guestfs-actions.pod:7089 msgid "See also C<guestfs_part_to_dev>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7056 +#: ../src/guestfs-actions.pod:7095 msgid "guestfs_ping_daemon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7058 +#: ../src/guestfs-actions.pod:7097 #, no-wrap msgid "" " int\n" @@ -35930,12 +36118,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7070 +#: ../src/guestfs-actions.pod:7109 msgid "guestfs_pread" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7072 +#: ../src/guestfs-actions.pod:7111 #, no-wrap msgid "" " char *\n" @@ -35948,17 +36136,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7085 +#: ../src/guestfs-actions.pod:7124 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7096 +#: ../src/guestfs-actions.pod:7135 msgid "guestfs_pread_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7098 +#: ../src/guestfs-actions.pod:7137 #, no-wrap msgid "" " char *\n" @@ -35971,22 +36159,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7111 +#: ../src/guestfs-actions.pod:7150 msgid "See also C<guestfs_pread>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7120 +#: ../src/guestfs-actions.pod:7159 msgid "(Added in 1.5.21)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7122 +#: ../src/guestfs-actions.pod:7161 msgid "guestfs_pvcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7124 +#: ../src/guestfs-actions.pod:7163 #, no-wrap msgid "" " int\n" @@ -35996,12 +36184,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7136 +#: ../src/guestfs-actions.pod:7175 msgid "guestfs_pvremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7138 +#: ../src/guestfs-actions.pod:7177 #, no-wrap msgid "" " int\n" @@ -36011,12 +36199,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7153 +#: ../src/guestfs-actions.pod:7192 msgid "guestfs_pvresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7155 +#: ../src/guestfs-actions.pod:7194 #, no-wrap msgid "" " int\n" @@ -36026,12 +36214,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7166 +#: ../src/guestfs-actions.pod:7205 msgid "guestfs_pvresize_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7168 +#: ../src/guestfs-actions.pod:7207 #, no-wrap msgid "" " int\n" @@ -36042,19 +36230,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7173 +#: ../src/guestfs-actions.pod:7212 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:7180 +#: ../src/guestfs-actions.pod:7219 msgid "guestfs_pvs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7182 +#: ../src/guestfs-actions.pod:7221 #, no-wrap msgid "" " char **\n" @@ -36063,17 +36251,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7191 +#: ../src/guestfs-actions.pod:7230 msgid "See also C<guestfs_pvs_full>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7199 +#: ../src/guestfs-actions.pod:7238 msgid "guestfs_pvs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7201 +#: ../src/guestfs-actions.pod:7240 #, no-wrap msgid "" " struct guestfs_lvm_pv_list *\n" @@ -36082,7 +36270,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7207 +#: ../src/guestfs-actions.pod:7246 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 " @@ -36090,12 +36278,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7213 +#: ../src/guestfs-actions.pod:7252 msgid "guestfs_pvuuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7215 +#: ../src/guestfs-actions.pod:7254 #, no-wrap msgid "" " char *\n" @@ -36105,12 +36293,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7226 +#: ../src/guestfs-actions.pod:7265 msgid "guestfs_pwrite" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7228 +#: ../src/guestfs-actions.pod:7267 #, no-wrap msgid "" " int\n" @@ -36123,17 +36311,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7244 +#: ../src/guestfs-actions.pod:7283 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7253 +#: ../src/guestfs-actions.pod:7292 msgid "guestfs_pwrite_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7255 +#: ../src/guestfs-actions.pod:7294 #, no-wrap msgid "" " int\n" @@ -36146,22 +36334,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7270 +#: ../src/guestfs-actions.pod:7309 msgid "See also C<guestfs_pwrite>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7277 +#: ../src/guestfs-actions.pod:7316 msgid "(Added in 1.5.20)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7279 +#: ../src/guestfs-actions.pod:7318 msgid "guestfs_read_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7281 +#: ../src/guestfs-actions.pod:7320 #, no-wrap msgid "" " char *\n" @@ -36172,7 +36360,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7289 +#: ../src/guestfs-actions.pod:7328 msgid "" "Unlike C<guestfs_cat>, this function can correctly handle files that contain " "embedded ASCII NUL characters. However unlike C<guestfs_download>, this " @@ -36180,17 +36368,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7301 +#: ../src/guestfs-actions.pod:7340 msgid "(Added in 1.0.63)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7303 +#: ../src/guestfs-actions.pod:7342 msgid "guestfs_read_lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7305 +#: ../src/guestfs-actions.pod:7344 #, no-wrap msgid "" " char **\n" @@ -36200,7 +36388,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7314 +#: ../src/guestfs-actions.pod:7353 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of line). For " @@ -36209,12 +36397,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7325 +#: ../src/guestfs-actions.pod:7364 msgid "guestfs_readdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7327 +#: ../src/guestfs-actions.pod:7366 #, no-wrap msgid "" " struct guestfs_dirent_list *\n" @@ -36224,7 +36412,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7381 +#: ../src/guestfs-actions.pod:7420 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 " @@ -36232,7 +36420,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7385 +#: ../src/guestfs-actions.pod:7424 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 " @@ -36240,12 +36428,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7391 +#: ../src/guestfs-actions.pod:7430 msgid "guestfs_readlink" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7393 +#: ../src/guestfs-actions.pod:7432 #, no-wrap msgid "" " char *\n" @@ -36255,12 +36443,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7404 +#: ../src/guestfs-actions.pod:7443 msgid "guestfs_readlinklist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7406 +#: ../src/guestfs-actions.pod:7445 #, no-wrap msgid "" " char **\n" @@ -36271,12 +36459,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7439 +#: ../src/guestfs-actions.pod:7478 msgid "guestfs_realpath" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7441 +#: ../src/guestfs-actions.pod:7480 #, no-wrap msgid "" " char *\n" @@ -36286,12 +36474,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7453 +#: ../src/guestfs-actions.pod:7492 msgid "guestfs_removexattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7455 +#: ../src/guestfs-actions.pod:7494 #, no-wrap msgid "" " int\n" @@ -36302,17 +36490,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7463 +#: ../src/guestfs-actions.pod:7502 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7469 +#: ../src/guestfs-actions.pod:7508 msgid "guestfs_resize2fs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7471 +#: ../src/guestfs-actions.pod:7510 #, no-wrap msgid "" " int\n" @@ -36322,12 +36510,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7484 +#: ../src/guestfs-actions.pod:7523 msgid "guestfs_resize2fs_M" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7486 +#: ../src/guestfs-actions.pod:7525 #, no-wrap msgid "" " int\n" @@ -36337,7 +36525,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7490 +#: ../src/guestfs-actions.pod:7529 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 " @@ -36345,7 +36533,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7494 +#: ../src/guestfs-actions.pod:7533 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. " @@ -36354,12 +36542,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7505 +#: ../src/guestfs-actions.pod:7544 msgid "guestfs_resize2fs_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7507 +#: ../src/guestfs-actions.pod:7546 #, no-wrap msgid "" " int\n" @@ -36370,19 +36558,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7512 +#: ../src/guestfs-actions.pod:7551 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:7521 +#: ../src/guestfs-actions.pod:7560 msgid "guestfs_rm" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7523 +#: ../src/guestfs-actions.pod:7562 #, no-wrap msgid "" " int\n" @@ -36392,12 +36580,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7533 +#: ../src/guestfs-actions.pod:7572 msgid "guestfs_rm_rf" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7535 +#: ../src/guestfs-actions.pod:7574 #, no-wrap msgid "" " int\n" @@ -36407,12 +36595,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7547 +#: ../src/guestfs-actions.pod:7586 msgid "guestfs_rmdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7549 +#: ../src/guestfs-actions.pod:7588 #, no-wrap msgid "" " int\n" @@ -36422,12 +36610,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7559 +#: ../src/guestfs-actions.pod:7598 msgid "guestfs_rmmountpoint" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7561 +#: ../src/guestfs-actions.pod:7600 #, no-wrap msgid "" " int\n" @@ -36437,19 +36625,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7565 +#: ../src/guestfs-actions.pod:7604 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:7573 +#: ../src/guestfs-actions.pod:7612 msgid "guestfs_scrub_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7575 +#: ../src/guestfs-actions.pod:7614 #, no-wrap msgid "" " int\n" @@ -36459,17 +36647,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7587 ../src/guestfs-actions.pod:7605 ../src/guestfs-actions.pod:7624 +#: ../src/guestfs-actions.pod:7626 ../src/guestfs-actions.pod:7644 ../src/guestfs-actions.pod:7663 msgid "(Added in 1.0.52)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7589 +#: ../src/guestfs-actions.pod:7628 msgid "guestfs_scrub_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7591 +#: ../src/guestfs-actions.pod:7630 #, no-wrap msgid "" " int\n" @@ -36479,12 +36667,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7607 +#: ../src/guestfs-actions.pod:7646 msgid "guestfs_scrub_freespace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7609 +#: ../src/guestfs-actions.pod:7648 #, no-wrap msgid "" " int\n" @@ -36494,7 +36682,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7613 +#: ../src/guestfs-actions.pod:7652 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>, " @@ -36503,12 +36691,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7626 +#: ../src/guestfs-actions.pod:7665 msgid "guestfs_set_append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7628 +#: ../src/guestfs-actions.pod:7667 #, no-wrap msgid "" " int\n" @@ -36518,12 +36706,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7645 +#: ../src/guestfs-actions.pod:7684 msgid "guestfs_set_attach_method" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7647 +#: ../src/guestfs-actions.pod:7686 #, no-wrap msgid "" " int\n" @@ -36533,12 +36721,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7675 +#: ../src/guestfs-actions.pod:7714 msgid "guestfs_set_autosync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7677 +#: ../src/guestfs-actions.pod:7716 #, no-wrap msgid "" " int\n" @@ -36548,12 +36736,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7693 +#: ../src/guestfs-actions.pod:7732 msgid "guestfs_set_direct" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7695 +#: ../src/guestfs-actions.pod:7734 #, no-wrap msgid "" " int\n" @@ -36563,7 +36751,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7703 +#: ../src/guestfs-actions.pod:7742 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 " @@ -36571,12 +36759,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7716 +#: ../src/guestfs-actions.pod:7755 msgid "guestfs_set_e2attrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7718 +#: ../src/guestfs-actions.pod:7757 #, no-wrap msgid "" " int\n" @@ -36588,7 +36776,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7729 +#: ../src/guestfs-actions.pod:7768 #, no-wrap msgid "" " GUESTFS_SET_E2ATTRS_CLEAR, int clear,\n" @@ -36596,7 +36784,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7734 +#: ../src/guestfs-actions.pod:7773 msgid "" "C<attrs> is a string of characters representing file attributes. See " "C<guestfs_get_e2attrs> for a list of possible attributes. Not all " @@ -36604,12 +36792,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7755 +#: ../src/guestfs-actions.pod:7794 msgid "guestfs_set_e2attrs_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7757 +#: ../src/guestfs-actions.pod:7796 #, no-wrap msgid "" " int\n" @@ -36621,17 +36809,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7763 +#: ../src/guestfs-actions.pod:7802 msgid "This is the \"va_list variant\" of L</guestfs_set_e2attrs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7767 +#: ../src/guestfs-actions.pod:7806 msgid "guestfs_set_e2attrs_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7769 +#: ../src/guestfs-actions.pod:7808 #, no-wrap msgid "" " int\n" @@ -36644,17 +36832,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7775 +#: ../src/guestfs-actions.pod:7814 msgid "This is the \"argv variant\" of L</guestfs_set_e2attrs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7779 +#: ../src/guestfs-actions.pod:7818 msgid "guestfs_set_e2generation" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7781 +#: ../src/guestfs-actions.pod:7820 #, no-wrap msgid "" " int\n" @@ -36665,17 +36853,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7788 +#: ../src/guestfs-actions.pod:7827 msgid "See C<guestfs_get_e2generation>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7794 +#: ../src/guestfs-actions.pod:7833 msgid "guestfs_set_e2label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7796 +#: ../src/guestfs-actions.pod:7835 #, no-wrap msgid "" " int\n" @@ -36686,26 +36874,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7801 +#: ../src/guestfs-actions.pod:7840 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_set_label> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7812 +#: ../src/guestfs-actions.pod:7851 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:7819 +#: ../src/guestfs-actions.pod:7858 msgid "guestfs_set_e2uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7821 +#: ../src/guestfs-actions.pod:7860 #, no-wrap msgid "" " int\n" @@ -36716,19 +36904,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7831 +#: ../src/guestfs-actions.pod:7870 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:7838 +#: ../src/guestfs-actions.pod:7877 msgid "guestfs_set_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7840 +#: ../src/guestfs-actions.pod:7879 #, no-wrap msgid "" " int\n" @@ -36739,17 +36927,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7854 +#: ../src/guestfs-actions.pod:7893 msgid "To read the label on a filesystem, call C<guestfs_vfs_label>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7860 +#: ../src/guestfs-actions.pod:7899 msgid "guestfs_set_memsize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7862 +#: ../src/guestfs-actions.pod:7901 #, no-wrap msgid "" " int\n" @@ -36759,19 +36947,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7866 +#: ../src/guestfs-actions.pod:7905 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:7881 +#: ../src/guestfs-actions.pod:7920 msgid "guestfs_set_network" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7883 +#: ../src/guestfs-actions.pod:7922 #, no-wrap msgid "" " int\n" @@ -36781,19 +36969,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7893 +#: ../src/guestfs-actions.pod:7932 msgid "" "You must call this before calling C<guestfs_launch>, otherwise it has no " "effect." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7900 +#: ../src/guestfs-actions.pod:7939 msgid "guestfs_set_path" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7902 +#: ../src/guestfs-actions.pod:7941 #, no-wrap msgid "" " int\n" @@ -36803,12 +36991,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7917 +#: ../src/guestfs-actions.pod:7956 msgid "guestfs_set_pgroup" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7919 +#: ../src/guestfs-actions.pod:7958 #, no-wrap msgid "" " int\n" @@ -36818,7 +37006,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7929 +#: ../src/guestfs-actions.pod:7968 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, " @@ -36827,12 +37015,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7938 +#: ../src/guestfs-actions.pod:7977 msgid "guestfs_set_qemu" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7940 +#: ../src/guestfs-actions.pod:7979 #, no-wrap msgid "" " int\n" @@ -36842,12 +37030,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7966 +#: ../src/guestfs-actions.pod:8005 msgid "guestfs_set_recovery_proc" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7968 +#: ../src/guestfs-actions.pod:8007 #, no-wrap msgid "" " int\n" @@ -36857,7 +37045,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7972 +#: ../src/guestfs-actions.pod:8011 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 " @@ -36866,19 +37054,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7977 +#: ../src/guestfs-actions.pod:8016 msgid "" "This only has any effect if called before C<guestfs_launch>, and the default " "is true." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7990 +#: ../src/guestfs-actions.pod:8029 msgid "guestfs_set_selinux" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7992 +#: ../src/guestfs-actions.pod:8031 #, no-wrap msgid "" " int\n" @@ -36888,12 +37076,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8009 +#: ../src/guestfs-actions.pod:8048 msgid "guestfs_set_smp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8011 +#: ../src/guestfs-actions.pod:8050 #, no-wrap msgid "" " int\n" @@ -36903,17 +37091,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8019 +#: ../src/guestfs-actions.pod:8058 msgid "This function must be called before C<guestfs_launch>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8025 +#: ../src/guestfs-actions.pod:8064 msgid "guestfs_set_trace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8027 +#: ../src/guestfs-actions.pod:8066 #, no-wrap msgid "" " int\n" @@ -36923,19 +37111,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8041 +#: ../src/guestfs-actions.pod:8080 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:8049 +#: ../src/guestfs-actions.pod:8088 msgid "guestfs_set_verbose" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8051 +#: ../src/guestfs-actions.pod:8090 #, no-wrap msgid "" " int\n" @@ -36945,19 +37133,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8060 +#: ../src/guestfs-actions.pod:8099 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:8068 +#: ../src/guestfs-actions.pod:8107 msgid "guestfs_setcon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8070 +#: ../src/guestfs-actions.pod:8109 #, no-wrap msgid "" " int\n" @@ -36967,12 +37155,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8083 +#: ../src/guestfs-actions.pod:8122 msgid "guestfs_setxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8085 +#: ../src/guestfs-actions.pod:8124 #, no-wrap msgid "" " int\n" @@ -36985,17 +37173,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8096 +#: ../src/guestfs-actions.pod:8135 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8102 +#: ../src/guestfs-actions.pod:8141 msgid "guestfs_sfdisk" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8104 +#: ../src/guestfs-actions.pod:8143 #, no-wrap msgid "" " int\n" @@ -37009,24 +37197,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8112 ../src/guestfs-actions.pod:8153 ../src/guestfs-actions.pod:8184 +#: ../src/guestfs-actions.pod:8151 ../src/guestfs-actions.pod:8192 ../src/guestfs-actions.pod:8223 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_part_add> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8139 +#: ../src/guestfs-actions.pod:8178 msgid "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8146 +#: ../src/guestfs-actions.pod:8185 msgid "guestfs_sfdiskM" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8148 +#: ../src/guestfs-actions.pod:8187 #, no-wrap msgid "" " int\n" @@ -37037,7 +37225,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8160 +#: ../src/guestfs-actions.pod:8199 msgid "" "This is a simplified interface to the C<guestfs_sfdisk> command, where " "partition sizes are specified in megabytes only (rounded to the nearest " @@ -37046,19 +37234,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8166 +#: ../src/guestfs-actions.pod:8205 msgid "" "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and " "C<guestfs_part_disk>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8173 +#: ../src/guestfs-actions.pod:8212 msgid "guestfs_sfdisk_N" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8175 +#: ../src/guestfs-actions.pod:8214 #, no-wrap msgid "" " int\n" @@ -37073,24 +37261,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8194 +#: ../src/guestfs-actions.pod:8233 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:8197 +#: ../src/guestfs-actions.pod:8236 msgid "See also: C<guestfs_part_add>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8203 +#: ../src/guestfs-actions.pod:8242 msgid "guestfs_sfdisk_disk_geometry" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8205 +#: ../src/guestfs-actions.pod:8244 #, no-wrap msgid "" " char *\n" @@ -37100,7 +37288,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8209 +#: ../src/guestfs-actions.pod:8248 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, " @@ -37109,12 +37297,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8222 +#: ../src/guestfs-actions.pod:8261 msgid "guestfs_sfdisk_kernel_geometry" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8224 +#: ../src/guestfs-actions.pod:8263 #, no-wrap msgid "" " char *\n" @@ -37124,12 +37312,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8238 +#: ../src/guestfs-actions.pod:8277 msgid "guestfs_sfdisk_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8240 +#: ../src/guestfs-actions.pod:8279 #, no-wrap msgid "" " char *\n" @@ -37139,24 +37327,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8244 +#: ../src/guestfs-actions.pod:8283 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_part_list> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8255 +#: ../src/guestfs-actions.pod:8294 msgid "See also: C<guestfs_part_list>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8262 +#: ../src/guestfs-actions.pod:8301 msgid "guestfs_sh" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8264 +#: ../src/guestfs-actions.pod:8303 #, no-wrap msgid "" " char *\n" @@ -37166,22 +37354,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8271 +#: ../src/guestfs-actions.pod:8310 msgid "This is like C<guestfs_command>, but passes the command to:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8279 +#: ../src/guestfs-actions.pod:8318 msgid "All the provisos about C<guestfs_command> apply to this call." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8286 +#: ../src/guestfs-actions.pod:8325 msgid "guestfs_sh_lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8288 +#: ../src/guestfs-actions.pod:8327 #, no-wrap msgid "" " char **\n" @@ -37191,24 +37379,60 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8292 +#: ../src/guestfs-actions.pod:8331 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:8295 +#: ../src/guestfs-actions.pod:8334 msgid "See also: C<guestfs_command_lines>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8303 +#: ../src/guestfs-actions.pod:8342 +msgid "guestfs_shutdown" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:8344 +#, no-wrap +msgid "" +" int\n" +" guestfs_shutdown (guestfs_h *g);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:8347 +msgid "" +"This is the opposite of C<guestfs_launch>. It performs an orderly shutdown " +"of the backend process(es). If the autosync flag is set (which is the " +"default) then the disk image is synchronized." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:8357 +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:8360 +msgid "" +"C<guestfs_close> will call this if you don't do it explicitly, but note that " +"any errors are ignored in that case." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:8365 msgid "guestfs_sleep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8305 +#: ../src/guestfs-actions.pod:8367 #, no-wrap msgid "" " int\n" @@ -37218,17 +37442,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8313 +#: ../src/guestfs-actions.pod:8375 msgid "(Added in 1.0.41)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8315 ../src/guestfs-structs.pod:109 +#: ../src/guestfs-actions.pod:8377 ../src/guestfs-structs.pod:109 msgid "guestfs_stat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8317 +#: ../src/guestfs-actions.pod:8379 #, no-wrap msgid "" " struct guestfs_stat *\n" @@ -37238,12 +37462,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8331 ../src/guestfs-structs.pod:135 +#: ../src/guestfs-actions.pod:8393 ../src/guestfs-structs.pod:135 msgid "guestfs_statvfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8333 +#: ../src/guestfs-actions.pod:8395 #, no-wrap msgid "" " struct guestfs_statvfs *\n" @@ -37253,19 +37477,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8343 +#: ../src/guestfs-actions.pod:8405 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:8349 +#: ../src/guestfs-actions.pod:8411 msgid "guestfs_strings" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8351 +#: ../src/guestfs-actions.pod:8413 #, no-wrap msgid "" " char **\n" @@ -37275,12 +37499,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8367 +#: ../src/guestfs-actions.pod:8429 msgid "guestfs_strings_e" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8369 +#: ../src/guestfs-actions.pod:8431 #, no-wrap msgid "" " char **\n" @@ -37291,26 +37515,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8374 +#: ../src/guestfs-actions.pod:8436 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:8384 +#: ../src/guestfs-actions.pod:8446 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:8422 +#: ../src/guestfs-actions.pod:8484 msgid "guestfs_swapoff_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8424 +#: ../src/guestfs-actions.pod:8486 #, no-wrap msgid "" " int\n" @@ -37320,19 +37544,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8428 +#: ../src/guestfs-actions.pod:8490 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:8436 +#: ../src/guestfs-actions.pod:8498 msgid "guestfs_swapoff_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8438 +#: ../src/guestfs-actions.pod:8500 #, no-wrap msgid "" " int\n" @@ -37342,12 +37566,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8448 +#: ../src/guestfs-actions.pod:8510 msgid "guestfs_swapoff_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8450 +#: ../src/guestfs-actions.pod:8512 #, no-wrap msgid "" " int\n" @@ -37357,12 +37581,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8461 +#: ../src/guestfs-actions.pod:8523 msgid "guestfs_swapoff_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8463 +#: ../src/guestfs-actions.pod:8525 #, no-wrap msgid "" " int\n" @@ -37372,12 +37596,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8474 +#: ../src/guestfs-actions.pod:8536 msgid "guestfs_swapon_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8476 +#: ../src/guestfs-actions.pod:8538 #, no-wrap msgid "" " int\n" @@ -37387,7 +37611,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8480 +#: ../src/guestfs-actions.pod:8542 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 " @@ -37395,12 +37619,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8496 +#: ../src/guestfs-actions.pod:8558 msgid "guestfs_swapon_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8498 +#: ../src/guestfs-actions.pod:8560 #, no-wrap msgid "" " int\n" @@ -37410,19 +37634,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8502 +#: ../src/guestfs-actions.pod:8564 msgid "" "This command enables swap to a file. See C<guestfs_swapon_device> for other " "notes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8509 +#: ../src/guestfs-actions.pod:8571 msgid "guestfs_swapon_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8511 +#: ../src/guestfs-actions.pod:8573 #, no-wrap msgid "" " int\n" @@ -37432,19 +37656,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8515 +#: ../src/guestfs-actions.pod:8577 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:8522 +#: ../src/guestfs-actions.pod:8584 msgid "guestfs_swapon_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8524 +#: ../src/guestfs-actions.pod:8586 #, no-wrap msgid "" " int\n" @@ -37454,19 +37678,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8528 +#: ../src/guestfs-actions.pod:8590 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:8535 +#: ../src/guestfs-actions.pod:8597 msgid "guestfs_sync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8537 +#: ../src/guestfs-actions.pod:8599 #, no-wrap msgid "" " int\n" @@ -37475,12 +37699,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8550 +#: ../src/guestfs-actions.pod:8612 msgid "guestfs_tail" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8552 +#: ../src/guestfs-actions.pod:8614 #, no-wrap msgid "" " char **\n" @@ -37490,12 +37714,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8568 +#: ../src/guestfs-actions.pod:8630 msgid "guestfs_tail_n" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8570 +#: ../src/guestfs-actions.pod:8632 #, no-wrap msgid "" " char **\n" @@ -37506,12 +37730,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8592 +#: ../src/guestfs-actions.pod:8654 msgid "guestfs_tar_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8594 +#: ../src/guestfs-actions.pod:8656 #, no-wrap msgid "" " int\n" @@ -37522,22 +37746,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8602 +#: ../src/guestfs-actions.pod:8664 msgid "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8607 ../src/guestfs-actions.pod:8624 ../src/guestfs-actions.pod:8640 ../src/guestfs-actions.pod:8656 +#: ../src/guestfs-actions.pod:8669 ../src/guestfs-actions.pod:8686 ../src/guestfs-actions.pod:8702 ../src/guestfs-actions.pod:8718 msgid "(Added in 1.0.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8609 +#: ../src/guestfs-actions.pod:8671 msgid "guestfs_tar_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8611 +#: ../src/guestfs-actions.pod:8673 #, no-wrap msgid "" " int\n" @@ -37548,19 +37772,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8619 +#: ../src/guestfs-actions.pod:8681 msgid "" "To download a compressed tarball, use C<guestfs_tgz_out> or " "C<guestfs_txz_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8626 +#: ../src/guestfs-actions.pod:8688 msgid "guestfs_tgz_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8628 +#: ../src/guestfs-actions.pod:8690 #, no-wrap msgid "" " int\n" @@ -37571,17 +37795,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8636 +#: ../src/guestfs-actions.pod:8698 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8642 +#: ../src/guestfs-actions.pod:8704 msgid "guestfs_tgz_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8644 +#: ../src/guestfs-actions.pod:8706 #, no-wrap msgid "" " int\n" @@ -37592,17 +37816,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8652 +#: ../src/guestfs-actions.pod:8714 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8658 +#: ../src/guestfs-actions.pod:8720 msgid "guestfs_touch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8660 +#: ../src/guestfs-actions.pod:8722 #, no-wrap msgid "" " int\n" @@ -37612,12 +37836,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8675 +#: ../src/guestfs-actions.pod:8737 msgid "guestfs_truncate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8677 +#: ../src/guestfs-actions.pod:8739 #, no-wrap msgid "" " int\n" @@ -37627,12 +37851,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8688 +#: ../src/guestfs-actions.pod:8750 msgid "guestfs_truncate_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8690 +#: ../src/guestfs-actions.pod:8752 #, no-wrap msgid "" " int\n" @@ -37643,7 +37867,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8698 +#: ../src/guestfs-actions.pod:8760 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 " @@ -37652,12 +37876,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8708 +#: ../src/guestfs-actions.pod:8770 msgid "guestfs_tune2fs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8710 +#: ../src/guestfs-actions.pod:8772 #, no-wrap msgid "" " int\n" @@ -37668,7 +37892,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8720 +#: ../src/guestfs-actions.pod:8782 #, no-wrap msgid "" " GUESTFS_TUNE2FS_FORCE, int force,\n" @@ -37685,7 +37909,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8800 +#: ../src/guestfs-actions.pod:8862 msgid "" "To get the current values of filesystem parameters, see " "C<guestfs_tune2fs_l>. For precise details of how tune2fs works, see the " @@ -37693,12 +37917,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8808 +#: ../src/guestfs-actions.pod:8870 msgid "guestfs_tune2fs_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8810 +#: ../src/guestfs-actions.pod:8872 #, no-wrap msgid "" " int\n" @@ -37709,17 +37933,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8815 +#: ../src/guestfs-actions.pod:8877 msgid "This is the \"va_list variant\" of L</guestfs_tune2fs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8819 +#: ../src/guestfs-actions.pod:8881 msgid "guestfs_tune2fs_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8821 +#: ../src/guestfs-actions.pod:8883 #, no-wrap msgid "" " int\n" @@ -37730,17 +37954,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8826 +#: ../src/guestfs-actions.pod:8888 msgid "This is the \"argv variant\" of L</guestfs_tune2fs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8830 +#: ../src/guestfs-actions.pod:8892 msgid "guestfs_tune2fs_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8832 +#: ../src/guestfs-actions.pod:8894 #, no-wrap msgid "" " char **\n" @@ -37750,12 +37974,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8852 +#: ../src/guestfs-actions.pod:8914 msgid "guestfs_txz_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8854 +#: ../src/guestfs-actions.pod:8916 #, no-wrap msgid "" " int\n" @@ -37766,12 +37990,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8866 +#: ../src/guestfs-actions.pod:8928 msgid "guestfs_txz_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8868 +#: ../src/guestfs-actions.pod:8930 #, no-wrap msgid "" " int\n" @@ -37782,12 +38006,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8880 +#: ../src/guestfs-actions.pod:8942 msgid "guestfs_umask" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8882 +#: ../src/guestfs-actions.pod:8944 #, no-wrap msgid "" " int\n" @@ -37797,19 +38021,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8898 +#: ../src/guestfs-actions.pod:8960 msgid "" "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, " "C<guestfs_mkdir>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8907 +#: ../src/guestfs-actions.pod:8969 msgid "guestfs_umount" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8909 +#: ../src/guestfs-actions.pod:8971 #, no-wrap msgid "" " int\n" @@ -37819,12 +38043,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8921 +#: ../src/guestfs-actions.pod:8983 msgid "guestfs_umount_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8923 +#: ../src/guestfs-actions.pod:8985 #, no-wrap msgid "" " int\n" @@ -37833,12 +38057,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8934 +#: ../src/guestfs-actions.pod:8996 msgid "guestfs_umount_local" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8936 +#: ../src/guestfs-actions.pod:8998 #, no-wrap msgid "" " int\n" @@ -37848,7 +38072,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8945 +#: ../src/guestfs-actions.pod:9007 #, no-wrap msgid "" " GUESTFS_UMOUNT_LOCAL_RETRY, int retry,\n" @@ -37856,12 +38080,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8956 +#: ../src/guestfs-actions.pod:9018 msgid "guestfs_umount_local_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8958 +#: ../src/guestfs-actions.pod:9020 #, no-wrap msgid "" " int\n" @@ -37871,17 +38095,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8962 +#: ../src/guestfs-actions.pod:9024 msgid "This is the \"va_list variant\" of L</guestfs_umount_local>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8966 +#: ../src/guestfs-actions.pod:9028 msgid "guestfs_umount_local_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8968 +#: ../src/guestfs-actions.pod:9030 #, no-wrap msgid "" " int\n" @@ -37892,17 +38116,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8972 +#: ../src/guestfs-actions.pod:9034 msgid "This is the \"argv variant\" of L</guestfs_umount_local>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8976 +#: ../src/guestfs-actions.pod:9038 msgid "guestfs_upload" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8978 +#: ../src/guestfs-actions.pod:9040 #, no-wrap msgid "" " int\n" @@ -37913,17 +38137,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8988 +#: ../src/guestfs-actions.pod:9050 msgid "See also C<guestfs_download>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8999 +#: ../src/guestfs-actions.pod:9061 msgid "guestfs_upload_offset" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9001 +#: ../src/guestfs-actions.pod:9063 #, no-wrap msgid "" " int\n" @@ -37935,7 +38159,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9017 +#: ../src/guestfs-actions.pod:9079 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 " @@ -37943,17 +38167,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9022 +#: ../src/guestfs-actions.pod:9084 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9033 +#: ../src/guestfs-actions.pod:9095 msgid "guestfs_utimens" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9035 +#: ../src/guestfs-actions.pod:9097 #, no-wrap msgid "" " int\n" @@ -37967,12 +38191,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9064 ../src/guestfs-structs.pod:175 +#: ../src/guestfs-actions.pod:9126 ../src/guestfs-structs.pod:175 msgid "guestfs_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9066 +#: ../src/guestfs-actions.pod:9128 #, no-wrap msgid "" " struct guestfs_version *\n" @@ -37981,7 +38205,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9094 +#: ../src/guestfs-actions.pod:9156 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " @@ -37990,24 +38214,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9100 +#: ../src/guestfs-actions.pod:9162 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:9104 +#: ../src/guestfs-actions.pod:9166 msgid "(Added in 1.0.58)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9106 +#: ../src/guestfs-actions.pod:9168 msgid "guestfs_vfs_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9108 +#: ../src/guestfs-actions.pod:9170 #, no-wrap msgid "" " char *\n" @@ -38017,22 +38241,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9117 +#: ../src/guestfs-actions.pod:9179 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9122 ../src/guestfs-actions.pod:9159 +#: ../src/guestfs-actions.pod:9184 ../src/guestfs-actions.pod:9221 msgid "(Added in 1.3.18)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9124 +#: ../src/guestfs-actions.pod:9186 msgid "guestfs_vfs_type" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9126 +#: ../src/guestfs-actions.pod:9188 #, no-wrap msgid "" " char *\n" @@ -38042,12 +38266,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9143 +#: ../src/guestfs-actions.pod:9205 msgid "guestfs_vfs_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9145 +#: ../src/guestfs-actions.pod:9207 #, no-wrap msgid "" " char *\n" @@ -38057,17 +38281,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9154 +#: ../src/guestfs-actions.pod:9216 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9161 +#: ../src/guestfs-actions.pod:9223 msgid "guestfs_vg_activate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9163 +#: ../src/guestfs-actions.pod:9225 #, no-wrap msgid "" " int\n" @@ -38078,12 +38302,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9180 +#: ../src/guestfs-actions.pod:9242 msgid "guestfs_vg_activate_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9182 +#: ../src/guestfs-actions.pod:9244 #, no-wrap msgid "" " int\n" @@ -38093,12 +38317,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9195 +#: ../src/guestfs-actions.pod:9257 msgid "guestfs_vgcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9197 +#: ../src/guestfs-actions.pod:9259 #, no-wrap msgid "" " int\n" @@ -38109,12 +38333,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9209 +#: ../src/guestfs-actions.pod:9271 msgid "guestfs_vglvuuids" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9211 +#: ../src/guestfs-actions.pod:9273 #, no-wrap msgid "" " char **\n" @@ -38124,24 +38348,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9218 +#: ../src/guestfs-actions.pod:9280 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:9221 +#: ../src/guestfs-actions.pod:9283 msgid "See also C<guestfs_vgpvuuids>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9229 +#: ../src/guestfs-actions.pod:9291 msgid "guestfs_vgmeta" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9231 +#: ../src/guestfs-actions.pod:9293 #, no-wrap msgid "" " char *\n" @@ -38152,17 +38376,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9246 +#: ../src/guestfs-actions.pod:9308 msgid "(Added in 1.17.20)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9248 +#: ../src/guestfs-actions.pod:9310 msgid "guestfs_vgpvuuids" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9250 +#: ../src/guestfs-actions.pod:9312 #, no-wrap msgid "" " char **\n" @@ -38172,24 +38396,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9257 +#: ../src/guestfs-actions.pod:9319 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:9260 +#: ../src/guestfs-actions.pod:9322 msgid "See also C<guestfs_vglvuuids>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9268 +#: ../src/guestfs-actions.pod:9330 msgid "guestfs_vgremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9270 +#: ../src/guestfs-actions.pod:9332 #, no-wrap msgid "" " int\n" @@ -38199,12 +38423,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9283 +#: ../src/guestfs-actions.pod:9345 msgid "guestfs_vgrename" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9285 +#: ../src/guestfs-actions.pod:9347 #, no-wrap msgid "" " int\n" @@ -38215,12 +38439,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9296 +#: ../src/guestfs-actions.pod:9358 msgid "guestfs_vgs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9298 +#: ../src/guestfs-actions.pod:9360 #, no-wrap msgid "" " char **\n" @@ -38229,17 +38453,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9307 +#: ../src/guestfs-actions.pod:9369 msgid "See also C<guestfs_vgs_full>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9315 +#: ../src/guestfs-actions.pod:9377 msgid "guestfs_vgs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9317 +#: ../src/guestfs-actions.pod:9379 #, no-wrap msgid "" " struct guestfs_lvm_vg_list *\n" @@ -38248,7 +38472,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9323 +#: ../src/guestfs-actions.pod:9385 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 " @@ -38256,12 +38480,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9329 +#: ../src/guestfs-actions.pod:9391 msgid "guestfs_vgscan" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9331 +#: ../src/guestfs-actions.pod:9393 #, no-wrap msgid "" " int\n" @@ -38270,12 +38494,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9341 +#: ../src/guestfs-actions.pod:9403 msgid "guestfs_vguuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9343 +#: ../src/guestfs-actions.pod:9405 #, no-wrap msgid "" " char *\n" @@ -38285,12 +38509,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9354 +#: ../src/guestfs-actions.pod:9416 msgid "guestfs_wait_ready" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9356 +#: ../src/guestfs-actions.pod:9418 #, no-wrap msgid "" " int\n" @@ -38299,19 +38523,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9359 +#: ../src/guestfs-actions.pod:9421 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_launch> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9366 +#: ../src/guestfs-actions.pod:9428 msgid "This function is a no op." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9368 +#: ../src/guestfs-actions.pod:9430 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 " @@ -38319,19 +38543,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9373 +#: ../src/guestfs-actions.pod:9435 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:9381 +#: ../src/guestfs-actions.pod:9443 msgid "guestfs_wc_c" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9383 +#: ../src/guestfs-actions.pod:9445 #, no-wrap msgid "" " int\n" @@ -38341,12 +38565,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9394 +#: ../src/guestfs-actions.pod:9456 msgid "guestfs_wc_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9396 +#: ../src/guestfs-actions.pod:9458 #, no-wrap msgid "" " int\n" @@ -38356,12 +38580,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9407 +#: ../src/guestfs-actions.pod:9469 msgid "guestfs_wc_w" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9409 +#: ../src/guestfs-actions.pod:9471 #, no-wrap msgid "" " int\n" @@ -38371,12 +38595,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9420 +#: ../src/guestfs-actions.pod:9482 msgid "guestfs_wipefs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9422 +#: ../src/guestfs-actions.pod:9484 #, no-wrap msgid "" " int\n" @@ -38386,17 +38610,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9432 +#: ../src/guestfs-actions.pod:9494 msgid "Compare with C<guestfs_zero> which zeroes the first few blocks of a device." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9439 +#: ../src/guestfs-actions.pod:9501 msgid "guestfs_write" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9441 +#: ../src/guestfs-actions.pod:9503 #, no-wrap msgid "" " int\n" @@ -38408,17 +38632,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9450 +#: ../src/guestfs-actions.pod:9512 msgid "See also C<guestfs_write_append>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9459 +#: ../src/guestfs-actions.pod:9521 msgid "guestfs_write_append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9461 +#: ../src/guestfs-actions.pod:9523 #, no-wrap msgid "" " int\n" @@ -38430,17 +38654,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9470 +#: ../src/guestfs-actions.pod:9532 msgid "See also C<guestfs_write>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9479 +#: ../src/guestfs-actions.pod:9541 msgid "guestfs_write_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9481 +#: ../src/guestfs-actions.pod:9543 #, no-wrap msgid "" " int\n" @@ -38452,19 +38676,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9487 +#: ../src/guestfs-actions.pod:9549 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_write> call " "instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9512 +#: ../src/guestfs-actions.pod:9574 msgid "guestfs_zegrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9514 +#: ../src/guestfs-actions.pod:9576 #, no-wrap msgid "" " char **\n" @@ -38475,12 +38699,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9531 +#: ../src/guestfs-actions.pod:9593 msgid "guestfs_zegrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9533 +#: ../src/guestfs-actions.pod:9595 #, no-wrap msgid "" " char **\n" @@ -38491,12 +38715,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9550 +#: ../src/guestfs-actions.pod:9612 msgid "guestfs_zero" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9552 +#: ../src/guestfs-actions.pod:9614 #, no-wrap msgid "" " int\n" @@ -38506,19 +38730,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9566 +#: ../src/guestfs-actions.pod:9628 msgid "" "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>, " "C<guestfs_is_zero_device>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9578 +#: ../src/guestfs-actions.pod:9640 msgid "guestfs_zero_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9580 +#: ../src/guestfs-actions.pod:9642 #, no-wrap msgid "" " int\n" @@ -38528,24 +38752,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9584 +#: ../src/guestfs-actions.pod:9646 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:9599 +#: ../src/guestfs-actions.pod:9661 msgid "(Added in 1.3.1)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9601 +#: ../src/guestfs-actions.pod:9663 msgid "guestfs_zero_free_space" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9603 +#: ../src/guestfs-actions.pod:9665 #, no-wrap msgid "" " int\n" @@ -38555,12 +38779,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9625 +#: ../src/guestfs-actions.pod:9687 msgid "guestfs_zerofree" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9627 +#: ../src/guestfs-actions.pod:9689 #, no-wrap msgid "" " int\n" @@ -38570,12 +38794,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9646 +#: ../src/guestfs-actions.pod:9708 msgid "guestfs_zfgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9648 +#: ../src/guestfs-actions.pod:9710 #, no-wrap msgid "" " char **\n" @@ -38586,12 +38810,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9665 +#: ../src/guestfs-actions.pod:9727 msgid "guestfs_zfgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9667 +#: ../src/guestfs-actions.pod:9729 #, no-wrap msgid "" " char **\n" @@ -38602,12 +38826,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9684 +#: ../src/guestfs-actions.pod:9746 msgid "guestfs_zfile" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9686 +#: ../src/guestfs-actions.pod:9748 #, no-wrap msgid "" " char *\n" @@ -38618,26 +38842,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9691 +#: ../src/guestfs-actions.pod:9753 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_file> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9703 +#: ../src/guestfs-actions.pod:9765 msgid "" "Since 1.0.63, use C<guestfs_file> instead which can now process compressed " "files." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9711 +#: ../src/guestfs-actions.pod:9773 msgid "guestfs_zgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9713 +#: ../src/guestfs-actions.pod:9775 #, no-wrap msgid "" " char **\n" @@ -38648,12 +38872,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9730 +#: ../src/guestfs-actions.pod:9792 msgid "guestfs_zgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9732 +#: ../src/guestfs-actions.pod:9794 #, no-wrap msgid "" " char **\n" @@ -39540,38 +39764,39 @@ msgid "" " guestfs_mount (g, \"/dev/sda1\", \"/\");\n" " guestfs_touch (g, \"/hello\");\n" " guestfs_umount (g, \"/\");\n" +" guestfs_shutdown (g);\n" " guestfs_close (g);\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:25 +#: ../src/guestfs.pod:26 msgid "" "Libguestfs is a library for accessing and modifying disk images and virtual " "machines. This manual page documents the C API." msgstr "" #. type: textblock -#: ../src/guestfs.pod:28 +#: ../src/guestfs.pod:29 msgid "" "If you are looking for an introduction to libguestfs, see the web site: " "L<http://libguestfs.org/>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:31 +#: ../src/guestfs.pod:32 msgid "" "Each virt tool has its own man page (for a full list, go to L</SEE ALSO> at " "the end of this file)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:34 +#: ../src/guestfs.pod:35 msgid "The libguestfs FAQ contains many useful answers: L<guestfs-faq(1)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:36 +#: ../src/guestfs.pod:37 msgid "" "For examples of using the API from C, see L<guestfs-examples(3)>. For " "examples in other languages, see L</USING LIBGUESTFS WITH OTHER PROGRAMMING " @@ -39579,12 +39804,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:40 +#: ../src/guestfs.pod:41 msgid "API OVERVIEW" msgstr "" #. type: textblock -#: ../src/guestfs.pod:42 +#: ../src/guestfs.pod:43 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 " @@ -39592,12 +39817,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:47 +#: ../src/guestfs.pod:48 msgid "HANDLES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:49 +#: ../src/guestfs.pod:50 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 " @@ -39607,12 +39832,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:56 +#: ../src/guestfs.pod:57 msgid "The general structure of all libguestfs-using programs looks like this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:59 +#: ../src/guestfs.pod:60 #, no-wrap msgid "" " guestfs_h *g = guestfs_create ();\n" @@ -39620,7 +39845,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:61 +#: ../src/guestfs.pod:62 #, no-wrap msgid "" " /* Call guestfs_add_drive additional times if there are\n" @@ -39631,7 +39856,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:66 +#: ../src/guestfs.pod:67 #, no-wrap msgid "" " /* Most manipulation calls won't work until you've launched\n" @@ -39643,7 +39868,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:72 +#: ../src/guestfs.pod:73 #, no-wrap msgid "" " /* Now you can examine what partitions, LVs etc are available.\n" @@ -39654,7 +39879,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:77 +#: ../src/guestfs.pod:78 #, no-wrap msgid "" " /* To access a filesystem in the image, you must mount it.\n" @@ -39664,7 +39889,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:81 +#: ../src/guestfs.pod:82 #, no-wrap msgid "" " /* Now you can perform filesystem actions on the guest\n" @@ -39675,28 +39900,25 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:86 +#: ../src/guestfs.pod:87 #, no-wrap msgid "" -" /* This is only needed for libguestfs < 1.5.24. Since then\n" -" * it is done automatically when you close the handle. See\n" -" * discussion of autosync in this page.\n" -" */\n" -" guestfs_sync (g);\n" +" /* Synchronize the disk. This is the opposite of guestfs_launch. */\n" +" guestfs_shutdown (g);\n" " \n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:92 +#: ../src/guestfs.pod:90 #, no-wrap msgid "" -" /* Close the handle 'g'. */\n" +" /* Close and free the handle 'g'. */\n" " guestfs_close (g);\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:95 +#: ../src/guestfs.pod:93 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 " @@ -39708,12 +39930,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:104 +#: ../src/guestfs.pod:102 msgid "DISK IMAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:106 +#: ../src/guestfs.pod:104 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 " @@ -39723,7 +39945,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:112 +#: ../src/guestfs.pod:110 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 " @@ -39731,7 +39953,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:116 +#: ../src/guestfs.pod:114 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -39741,12 +39963,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:120 +#: ../src/guestfs.pod:118 msgid "You can add a disk read-only using:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:122 +#: ../src/guestfs.pod:120 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -39757,14 +39979,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:127 +#: ../src/guestfs.pod:125 msgid "" "or by calling the older function L</guestfs_add_drive_ro>. In either case " "libguestfs won't modify the file." msgstr "" #. type: textblock -#: ../src/guestfs.pod:130 +#: ../src/guestfs.pod:128 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 " @@ -39772,7 +39994,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:134 +#: ../src/guestfs.pod:132 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 " @@ -39780,7 +40002,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:139 +#: ../src/guestfs.pod:137 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 " @@ -39788,12 +40010,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:144 +#: ../src/guestfs.pod:142 msgid "MOUNTING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:146 +#: ../src/guestfs.pod:144 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 " @@ -39803,7 +40025,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:153 +#: ../src/guestfs.pod:151 #, no-wrap msgid "" " guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n" @@ -39811,7 +40033,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:155 +#: ../src/guestfs.pod:153 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 " @@ -39821,7 +40043,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:161 +#: ../src/guestfs.pod:159 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 " @@ -39832,7 +40054,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:169 +#: ../src/guestfs.pod:167 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 " @@ -39840,19 +40062,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:174 +#: ../src/guestfs.pod:172 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:177 +#: ../src/guestfs.pod:175 msgid "FILESYSTEM ACCESS AND MODIFICATION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:179 +#: ../src/guestfs.pod:177 msgid "" "The majority of the libguestfs API consists of fairly low-level calls for " "accessing and modifying the files, directories, symlinks etc on mounted " @@ -39862,21 +40084,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:185 +#: ../src/guestfs.pod:183 msgid "" "Specify filenames as full paths, starting with C<\"/\"> and including the " "mount point." msgstr "" #. type: textblock -#: ../src/guestfs.pod:188 +#: ../src/guestfs.pod:186 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:191 +#: ../src/guestfs.pod:189 #, no-wrap msgid "" " char *data = guestfs_cat (g, \"/etc/passwd\");\n" @@ -39884,7 +40106,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:193 +#: ../src/guestfs.pod:191 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), " @@ -39892,14 +40114,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:197 +#: ../src/guestfs.pod:195 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:200 +#: ../src/guestfs.pod:198 #, no-wrap msgid "" " guestfs_mkdir (g, \"/var\");\n" @@ -39907,12 +40129,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:202 +#: ../src/guestfs.pod:200 msgid "To create a symlink you could do:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:204 +#: ../src/guestfs.pod:202 #, no-wrap msgid "" " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n" @@ -39921,14 +40143,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:207 +#: ../src/guestfs.pod:205 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:210 +#: ../src/guestfs.pod:208 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 " @@ -39938,40 +40160,40 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:216 +#: ../src/guestfs.pod:214 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:219 +#: ../src/guestfs.pod:217 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:223 +#: ../src/guestfs.pod:221 msgid "PARTITIONING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:225 +#: ../src/guestfs.pod:223 msgid "" "Libguestfs contains API calls to read, create and modify partition tables on " "disk images." msgstr "" #. type: textblock -#: ../src/guestfs.pod:228 +#: ../src/guestfs.pod:226 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:232 +#: ../src/guestfs.pod:230 #, no-wrap msgid "" " const char *parttype = \"mbr\";\n" @@ -39982,19 +40204,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:237 +#: ../src/guestfs.pod:235 msgid "" "Obviously this effectively wipes anything that was on that disk image " "before." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:240 +#: ../src/guestfs.pod:238 msgid "LVM2" msgstr "" #. type: textblock -#: ../src/guestfs.pod:242 +#: ../src/guestfs.pod:240 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 " @@ -40003,19 +40225,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:247 +#: ../src/guestfs.pod:245 msgid "" "This author strongly recommends reading the LVM HOWTO, online at " "L<http://tldp.org/HOWTO/LVM-HOWTO/>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:250 +#: ../src/guestfs.pod:248 msgid "DOWNLOADING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:252 +#: ../src/guestfs.pod:250 msgid "" "Use L</guestfs_cat> to download small, text only files. This call is " "limited to files which are less than 2 MB and which cannot contain any ASCII " @@ -40023,7 +40245,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:256 +#: ../src/guestfs.pod:254 msgid "" "L</guestfs_read_file> can be used to read files which contain arbitrary 8 " "bit data, since it returns a (pointer, size) pair. However it is still " @@ -40031,31 +40253,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:260 +#: ../src/guestfs.pod:258 msgid "" "L</guestfs_download> can be used to download any file, with no limits on " "content or size (even files larger than 4 GB)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:263 +#: ../src/guestfs.pod:261 msgid "To download multiple files, see L</guestfs_tar_out> and L</guestfs_tgz_out>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:266 +#: ../src/guestfs.pod:264 msgid "UPLOADING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:268 +#: ../src/guestfs.pod:266 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:271 +#: ../src/guestfs.pod:269 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 " @@ -40065,19 +40287,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:277 +#: ../src/guestfs.pod:275 msgid "" "To upload a single file, use L</guestfs_upload>. This call has no limits on " "file content or size (even files larger than 4 GB)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:280 +#: ../src/guestfs.pod:278 msgid "To upload multiple files, see L</guestfs_tar_in> and L</guestfs_tgz_in>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:282 +#: ../src/guestfs.pod:280 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 " @@ -40091,12 +40313,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:293 +#: ../src/guestfs.pod:291 msgid "COPYING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:295 +#: ../src/guestfs.pod:293 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 " @@ -40104,51 +40326,51 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:301 +#: ../src/guestfs.pod:299 msgid "B<file> to B<file>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:303 +#: ../src/guestfs.pod:301 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:306 +#: ../src/guestfs.pod:304 msgid "To copy part of a file (offset and size) use L</guestfs_copy_file_to_file>." msgstr "" #. type: =item -#: ../src/guestfs.pod:309 +#: ../src/guestfs.pod:307 msgid "B<file> to B<device>" msgstr "" #. type: =item -#: ../src/guestfs.pod:311 +#: ../src/guestfs.pod:309 msgid "B<device> to B<file>" msgstr "" #. type: =item -#: ../src/guestfs.pod:313 +#: ../src/guestfs.pod:311 msgid "B<device> to B<device>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:315 +#: ../src/guestfs.pod:313 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:318 +#: ../src/guestfs.pod:316 msgid "Example: duplicate the contents of an LV:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:320 +#: ../src/guestfs.pod:318 #, no-wrap msgid "" " guestfs_copy_device_to_device (g,\n" @@ -40159,7 +40381,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:325 +#: ../src/guestfs.pod:323 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 " @@ -40167,7 +40389,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:329 +#: ../src/guestfs.pod:327 #, no-wrap msgid "" " guestfs_copy_device_to_device (g,\n" @@ -40178,32 +40400,32 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:334 +#: ../src/guestfs.pod:332 msgid "B<file on the host> to B<file or device>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:336 +#: ../src/guestfs.pod:334 msgid "Use L</guestfs_upload>. See L</UPLOADING> above." msgstr "" #. type: =item -#: ../src/guestfs.pod:338 +#: ../src/guestfs.pod:336 msgid "B<file or device> to B<file on the host>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:340 +#: ../src/guestfs.pod:338 msgid "Use L</guestfs_download>. See L</DOWNLOADING> above." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:344 +#: ../src/guestfs.pod:342 msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:346 +#: ../src/guestfs.pod:344 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 " @@ -40214,12 +40436,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:354 +#: ../src/guestfs.pod:352 msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:357 +#: ../src/guestfs.pod:355 #, no-wrap msgid "" " guestfs_download (g, filename, \"/dev/stdout\");\n" @@ -40227,12 +40449,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:359 +#: ../src/guestfs.pod:357 msgid "and you can write tar output to a file descriptor C<fd> by doing:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:361 +#: ../src/guestfs.pod:359 #, no-wrap msgid "" " char devfd[64];\n" @@ -40242,26 +40464,26 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:365 +#: ../src/guestfs.pod:363 msgid "LISTING FILES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:367 +#: ../src/guestfs.pod:365 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:370 +#: ../src/guestfs.pod:368 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:373 +#: ../src/guestfs.pod:371 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 " @@ -40269,19 +40491,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:377 +#: ../src/guestfs.pod:375 msgid "" "L</guestfs_find> and L</guestfs_find0> can be used to recursively list " "files." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:380 +#: ../src/guestfs.pod:378 msgid "RUNNING COMMANDS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:382 +#: ../src/guestfs.pod:380 msgid "" "Although libguestfs is primarily an API for manipulating files inside guest " "images, we also provide some limited facilities for running commands inside " @@ -40289,55 +40511,55 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:386 +#: ../src/guestfs.pod:384 msgid "There are many limitations to this:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:392 +#: ../src/guestfs.pod:390 msgid "" "The kernel version that the command runs under will be different from what " "it expects." msgstr "" #. type: textblock -#: ../src/guestfs.pod:397 +#: ../src/guestfs.pod:395 msgid "" "If the command needs to communicate with daemons, then most likely they " "won't be running." msgstr "" #. type: textblock -#: ../src/guestfs.pod:402 +#: ../src/guestfs.pod:400 msgid "The command will be running in limited memory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:406 +#: ../src/guestfs.pod:404 msgid "" "The network may not be available unless you enable it (see " "L</guestfs_set_network>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:411 +#: ../src/guestfs.pod:409 msgid "Only supports Linux guests (not Windows, BSD, etc)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:415 +#: ../src/guestfs.pod:413 msgid "Architecture limitations (eg. won't work for a PPC guest on an X86 host)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:420 +#: ../src/guestfs.pod:418 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:425 +#: ../src/guestfs.pod:423 msgid "" "I<Security:> It is not safe to run commands from untrusted, possibly " "malicious guests. These commands may attempt to exploit your program by " @@ -40349,7 +40571,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:434 +#: ../src/guestfs.pod:432 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 " @@ -40359,26 +40581,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:442 +#: ../src/guestfs.pod:440 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:445 +#: ../src/guestfs.pod:443 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:448 +#: ../src/guestfs.pod:446 msgid "CONFIGURATION FILES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:450 +#: ../src/guestfs.pod:448 msgid "" "To read and write configuration files in Linux guest filesystems, we " "strongly recommend using Augeas. For example, Augeas understands how to " @@ -40387,7 +40609,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:455 +#: ../src/guestfs.pod:453 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 " @@ -40395,7 +40617,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:459 +#: ../src/guestfs.pod:457 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 " @@ -40403,24 +40625,24 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:463 +#: ../src/guestfs.pod:461 msgid "SELINUX" msgstr "" #. type: textblock -#: ../src/guestfs.pod:465 +#: ../src/guestfs.pod:463 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:473 +#: ../src/guestfs.pod:471 msgid "Before launching, do:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:475 +#: ../src/guestfs.pod:473 #, no-wrap msgid "" " guestfs_set_selinux (g, 1);\n" @@ -40428,14 +40650,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:479 +#: ../src/guestfs.pod:477 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:483 +#: ../src/guestfs.pod:481 #, no-wrap msgid "" " guestfs_sh (g, \"/usr/sbin/load_policy\");\n" @@ -40443,21 +40665,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:485 +#: ../src/guestfs.pod:483 msgid "" "(Older versions of C<load_policy> require you to specify the name of the " "policy file)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:490 +#: ../src/guestfs.pod:488 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:494 +#: ../src/guestfs.pod:492 #, no-wrap msgid "" " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n" @@ -40465,24 +40687,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:498 +#: ../src/guestfs.pod:496 msgid "This will work for running commands and editing existing files." msgstr "" #. type: textblock -#: ../src/guestfs.pod:500 +#: ../src/guestfs.pod:498 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:504 +#: ../src/guestfs.pod:502 msgid "UMASK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:506 +#: ../src/guestfs.pod:504 msgid "" "Certain calls are affected by the current file mode creation mask (the " "\"umask\"). In particular ones which create files or directories, such as " @@ -40492,14 +40714,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:512 +#: ../src/guestfs.pod:510 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:515 +#: ../src/guestfs.pod:513 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 " @@ -40507,12 +40729,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:519 +#: ../src/guestfs.pod:517 msgid "For more information about umask, see L<umask(2)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:523 +#: ../src/guestfs.pod:521 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) " @@ -40521,21 +40743,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:529 +#: ../src/guestfs.pod:527 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:532 +#: ../src/guestfs.pod:530 msgid "" "Then open these devices by calling L</guestfs_luks_open>. Obviously you " "will require the passphrase!" msgstr "" #. type: textblock -#: ../src/guestfs.pod:535 +#: ../src/guestfs.pod:533 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 " @@ -40544,7 +40766,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:541 +#: ../src/guestfs.pod:539 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 " @@ -40552,7 +40774,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:545 +#: ../src/guestfs.pod:543 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, " @@ -40562,19 +40784,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:552 +#: ../src/guestfs.pod:550 msgid "MOUNT LOCAL" msgstr "" #. type: textblock -#: ../src/guestfs.pod:554 +#: ../src/guestfs.pod:552 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:558 +#: ../src/guestfs.pod:556 msgid "" "Availability of this is subject to a number of restrictions: it requires " "FUSE (the Filesystem in USErspace), and libfuse must also have been " @@ -40585,7 +40807,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:565 +#: ../src/guestfs.pod:563 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 " @@ -40598,7 +40820,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:575 +#: ../src/guestfs.pod:573 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 " @@ -40609,12 +40831,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:583 +#: ../src/guestfs.pod:581 msgid "MOUNT LOCAL COMPATIBILITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:585 +#: ../src/guestfs.pod:583 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 " @@ -40623,7 +40845,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:590 +#: ../src/guestfs.pod:588 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 " @@ -40631,12 +40853,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:594 +#: ../src/guestfs.pod:592 msgid "MOUNT LOCAL PERFORMANCE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:596 +#: ../src/guestfs.pod:594 msgid "" "Libguestfs on top of FUSE performs quite poorly. For best performance do " "not use it. Use ordinary libguestfs filesystem calls, upload, download " @@ -40644,12 +40866,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:600 +#: ../src/guestfs.pod:598 msgid "INSPECTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:602 +#: ../src/guestfs.pod:600 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 " @@ -40659,14 +40881,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:609 +#: ../src/guestfs.pod:607 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:612 +#: ../src/guestfs.pod:610 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 " @@ -40679,7 +40901,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:621 +#: ../src/guestfs.pod:619 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 " @@ -40688,7 +40910,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:627 +#: ../src/guestfs.pod:625 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 " @@ -40699,7 +40921,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:634 +#: ../src/guestfs.pod:632 #, no-wrap msgid "" " /boot => /dev/sda1\n" @@ -40709,14 +40931,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:638 +#: ../src/guestfs.pod:636 msgid "" "The caller can then make calls to L</guestfs_mount_options> to mount the " "filesystems as suggested." msgstr "" #. type: textblock -#: ../src/guestfs.pod:641 +#: ../src/guestfs.pod:639 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 " @@ -40724,7 +40946,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:645 +#: ../src/guestfs.pod:643 msgid "" "Inspection currently only works for some common operating systems. " "Contributors are welcome to send patches for other operating systems that we " @@ -40732,7 +40954,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:649 +#: ../src/guestfs.pod:647 msgid "" "Encrypted disks must be opened before inspection. See L</ENCRYPTED DISKS> " "for more details. The L</guestfs_inspect_os> function just ignores any " @@ -40740,7 +40962,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:653 +#: ../src/guestfs.pod:651 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 " @@ -40753,19 +40975,19 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:662 +#: ../src/guestfs.pod:660 msgid "INSPECTING INSTALL DISKS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:664 +#: ../src/guestfs.pod:662 msgid "" "Libguestfs (since 1.9.4) can detect some install disks, install CDs, live " "CDs and more." msgstr "" #. type: textblock -#: ../src/guestfs.pod:667 +#: ../src/guestfs.pod:665 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 " @@ -40773,7 +40995,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:671 +#: ../src/guestfs.pod:669 msgid "" "Further information is available about the operating system that can be " "installed using the regular inspection APIs like " @@ -40782,7 +41004,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:676 +#: ../src/guestfs.pod:674 msgid "" "Some additional information specific to installer disks is also available " "from the L</guestfs_inspect_is_live>, L</guestfs_inspect_is_netinst> and " @@ -40790,24 +41012,24 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:681 +#: ../src/guestfs.pod:679 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:683 +#: ../src/guestfs.pod:681 msgid "" "Libguestfs can mount NTFS partitions. It does this using the " "L<http://www.ntfs-3g.org/> driver." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:686 +#: ../src/guestfs.pod:684 msgid "DRIVE LETTERS AND PATHS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:688 +#: ../src/guestfs.pod:686 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 " @@ -40817,14 +41039,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:694 +#: ../src/guestfs.pod:692 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:697 +#: ../src/guestfs.pod:695 msgid "" "Dealing with separator characters (backslash vs forward slash) is outside " "the scope of libguestfs, but usually a simple character replacement will " @@ -40832,19 +41054,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:701 +#: ../src/guestfs.pod:699 msgid "" "To resolve the case insensitivity of paths, call " "L</guestfs_case_sensitive_path>." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:704 +#: ../src/guestfs.pod:702 msgid "ACCESSING THE WINDOWS REGISTRY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:706 +#: ../src/guestfs.pod:704 msgid "" "Libguestfs also provides some help for decoding Windows Registry \"hive\" " "files, through the library C<hivex> which is part of the libguestfs project " @@ -40855,12 +41077,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:714 +#: ../src/guestfs.pod:712 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:716 +#: ../src/guestfs.pod:714 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 " @@ -40868,12 +41090,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:720 +#: ../src/guestfs.pod:718 msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-symbolic-links/>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:722 +#: ../src/guestfs.pod:720 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 " @@ -40883,7 +41105,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:729 +#: ../src/guestfs.pod:727 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 " @@ -40892,36 +41114,36 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:734 +#: ../src/guestfs.pod:732 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:736 +#: ../src/guestfs.pod:734 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:739 +#: ../src/guestfs.pod:737 msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:741 +#: ../src/guestfs.pod:739 msgid "RESIZE2FS ERRORS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:743 +#: ../src/guestfs.pod:741 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:746 +#: ../src/guestfs.pod:744 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 " @@ -40930,7 +41152,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:751 +#: ../src/guestfs.pod:749 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 " @@ -40938,14 +41160,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:756 +#: ../src/guestfs.pod:754 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:759 +#: ../src/guestfs.pod:757 #, no-wrap msgid "" " Please run 'e2fsck -fy <device>' to fix the filesystem\n" @@ -40954,7 +41176,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:762 +#: ../src/guestfs.pod:760 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 " @@ -40963,19 +41185,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:767 +#: ../src/guestfs.pod:765 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:769 +#: ../src/guestfs.pod:767 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:772 +#: ../src/guestfs.pod:770 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)> " @@ -40985,14 +41207,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:778 +#: ../src/guestfs.pod:776 msgid "" "Error messages are automatically transformed into exceptions if the language " "supports it." msgstr "" #. type: textblock -#: ../src/guestfs.pod:781 +#: ../src/guestfs.pod:779 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 " @@ -41000,58 +41222,58 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:787 +#: ../src/guestfs.pod:785 msgid "B<C++>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:789 +#: ../src/guestfs.pod:787 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:793 +#: ../src/guestfs.pod:791 msgid "B<C#>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:795 +#: ../src/guestfs.pod:793 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:798 +#: ../src/guestfs.pod:796 msgid "B<Erlang>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:800 +#: ../src/guestfs.pod:798 msgid "See L<guestfs-erlang(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:802 +#: ../src/guestfs.pod:800 msgid "B<GObject>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:804 +#: ../src/guestfs.pod:802 msgid "" "Experimental GObject bindings (with GObject Introspection support) are " "available. See the C<gobject> directory in the source." msgstr "" #. type: =item -#: ../src/guestfs.pod:807 +#: ../src/guestfs.pod:805 msgid "B<Haskell>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:809 +#: ../src/guestfs.pod:807 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 " @@ -41059,96 +41281,96 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:813 +#: ../src/guestfs.pod:811 msgid "B<Java>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:815 +#: ../src/guestfs.pod:813 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:818 +#: ../src/guestfs.pod:816 msgid "B<OCaml>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:820 +#: ../src/guestfs.pod:818 msgid "See L<guestfs-ocaml(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:822 +#: ../src/guestfs.pod:820 msgid "B<Perl>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:824 +#: ../src/guestfs.pod:822 msgid "See L<guestfs-perl(3)> and L<Sys::Guestfs(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:826 +#: ../src/guestfs.pod:824 msgid "B<PHP>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:828 +#: ../src/guestfs.pod:826 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:831 +#: ../src/guestfs.pod:829 msgid "The PHP binding only works correctly on 64 bit machines." msgstr "" #. type: =item -#: ../src/guestfs.pod:833 +#: ../src/guestfs.pod:831 msgid "B<Python>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:835 +#: ../src/guestfs.pod:833 msgid "See L<guestfs-python(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:837 +#: ../src/guestfs.pod:835 msgid "B<Ruby>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:839 +#: ../src/guestfs.pod:837 msgid "See L<guestfs-ruby(3)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:841 +#: ../src/guestfs.pod:839 msgid "For JRuby, use the Java bindings." msgstr "" #. type: =item -#: ../src/guestfs.pod:843 +#: ../src/guestfs.pod:841 msgid "B<shell scripts>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:845 +#: ../src/guestfs.pod:843 msgid "See L<guestfish(1)>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:849 +#: ../src/guestfs.pod:847 msgid "LIBGUESTFS GOTCHAS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:851 +#: ../src/guestfs.pod:849 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 " @@ -41156,7 +41378,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:855 +#: ../src/guestfs.pod:853 msgid "" "Since we developed libguestfs and the associated tools, there are several " "things we would have designed differently, but are now stuck with for " @@ -41165,19 +41387,19 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:863 +#: ../src/guestfs.pod:861 msgid "Autosync / forgetting to sync." msgstr "" #. type: textblock -#: ../src/guestfs.pod:865 +#: ../src/guestfs.pod:863 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:868 +#: ../src/guestfs.pod:866 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 " @@ -41185,7 +41407,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:872 +#: ../src/guestfs.pod:870 #, no-wrap msgid "" " guestfs_set_autosync (g, 1);\n" @@ -41193,7 +41415,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:874 +#: ../src/guestfs.pod:872 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> " @@ -41201,7 +41423,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:878 +#: ../src/guestfs.pod:876 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 " @@ -41209,7 +41431,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:882 +#: ../src/guestfs.pod:880 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 " @@ -41217,19 +41439,19 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:886 +#: ../src/guestfs.pod:884 msgid "Mount option C<-o sync> should not be the default." msgstr "" #. type: textblock -#: ../src/guestfs.pod:888 +#: ../src/guestfs.pod:886 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:891 +#: ../src/guestfs.pod:889 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 " @@ -41237,31 +41459,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:895 +#: ../src/guestfs.pod:893 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:898 +#: ../src/guestfs.pod:896 msgid "Read-only should be the default." msgstr "" #. type: textblock -#: ../src/guestfs.pod:900 +#: ../src/guestfs.pod:898 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:903 +#: ../src/guestfs.pod:901 msgid "This would reduce the potential to corrupt live VM images." msgstr "" #. type: textblock -#: ../src/guestfs.pod:905 +#: ../src/guestfs.pod:903 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 " @@ -41269,12 +41491,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:909 +#: ../src/guestfs.pod:907 msgid "guestfish command line is hard to use." msgstr "" #. type: textblock -#: ../src/guestfs.pod:911 +#: ../src/guestfs.pod:909 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 " @@ -41284,12 +41506,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:918 +#: ../src/guestfs.pod:916 msgid "guestfish megabyte modifiers don't work right on all commands" msgstr "" #. type: textblock -#: ../src/guestfs.pod:920 +#: ../src/guestfs.pod:918 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 " @@ -41299,12 +41521,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:927 +#: ../src/guestfs.pod:925 msgid "The most common is L</guestfs_lvcreate>. The guestfish command:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:929 +#: ../src/guestfs.pod:927 #, no-wrap msgid "" " lvcreate LV VG 100M\n" @@ -41312,7 +41534,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:931 +#: ../src/guestfs.pod:929 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 " @@ -41321,19 +41543,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:936 +#: ../src/guestfs.pod:934 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:939 +#: ../src/guestfs.pod:937 msgid "Ambiguity between devices and paths" msgstr "" #. type: textblock -#: ../src/guestfs.pod:941 +#: ../src/guestfs.pod:939 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 " @@ -41341,7 +41563,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:946 +#: ../src/guestfs.pod:944 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>. " @@ -41350,7 +41572,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:952 +#: ../src/guestfs.pod:950 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 " @@ -41360,7 +41582,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:958 +#: ../src/guestfs.pod:956 #, no-wrap msgid "" " type path = Path of string | Device of int | Partition of int * int\n" @@ -41368,12 +41590,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:960 +#: ../src/guestfs.pod:958 msgid "which would allow you to pass arguments like:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:962 +#: ../src/guestfs.pod:960 #, no-wrap msgid "" " Path \"/foo/bar\"\n" @@ -41384,26 +41606,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:967 +#: ../src/guestfs.pod:965 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:972 +#: ../src/guestfs.pod:970 msgid "KEYS AND PASSPHRASES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:974 +#: ../src/guestfs.pod:972 msgid "" "Certain libguestfs calls take a parameter that contains sensitive key " "material, passed in as a C string." msgstr "" #. type: textblock -#: ../src/guestfs.pod:977 +#: ../src/guestfs.pod:975 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 " @@ -41412,7 +41634,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:982 +#: ../src/guestfs.pod:980 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, " @@ -41420,19 +41642,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:987 +#: ../src/guestfs.pod:985 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:989 +#: ../src/guestfs.pod:987 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:992 +#: ../src/guestfs.pod:990 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 " @@ -41440,33 +41662,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:996 +#: ../src/guestfs.pod:994 msgid "" "See the graphical program guestfs-browser for one possible architecture for " "multithreaded programs using libvirt and libguestfs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:999 +#: ../src/guestfs.pod:997 msgid "PATH" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1001 +#: ../src/guestfs.pod:999 msgid "" "Libguestfs needs a supermin appliance, which it finds by looking along an " "internal path." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1004 +#: ../src/guestfs.pod:1002 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:1007 +#: ../src/guestfs.pod:1005 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 " @@ -41477,12 +41699,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1014 +#: ../src/guestfs.pod:1012 msgid "QEMU WRAPPERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1016 +#: ../src/guestfs.pod:1014 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 " @@ -41490,7 +41712,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1020 +#: ../src/guestfs.pod:1018 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 " @@ -41499,14 +41721,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1025 +#: ../src/guestfs.pod:1023 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:1028 +#: ../src/guestfs.pod:1026 #, no-wrap msgid "" " #!/bin/sh -\n" @@ -41517,7 +41739,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1032 +#: ../src/guestfs.pod:1030 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 " @@ -41525,7 +41747,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1036 +#: ../src/guestfs.pod:1034 #, no-wrap msgid "" " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n" @@ -41533,14 +41755,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1038 +#: ../src/guestfs.pod:1036 msgid "" "Note that libguestfs also calls qemu with the -help and -version options in " "order to determine features." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1041 +#: ../src/guestfs.pod:1039 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 " @@ -41550,7 +41772,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1050 +#: ../src/guestfs.pod:1048 #, no-wrap msgid "" " i=0\n" @@ -41568,7 +41790,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1062 +#: ../src/guestfs.pod:1060 #, no-wrap msgid "" " exec qemu-kvm -machine pc,accel=tcg \"${args[@]}\"\n" @@ -41576,19 +41798,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1064 +#: ../src/guestfs.pod:1062 msgid "ATTACHING TO RUNNING DAEMONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1066 +#: ../src/guestfs.pod:1064 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:1069 +#: ../src/guestfs.pod:1067 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 " @@ -41596,12 +41818,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1073 +#: ../src/guestfs.pod:1071 msgid "Using guestfs_set_attach_method" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1075 +#: ../src/guestfs.pod:1073 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 " @@ -41609,14 +41831,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1079 +#: ../src/guestfs.pod:1077 msgid "" "The normal attach method is C<appliance>, where a small appliance is created " "containing the daemon, and then the library connects to this." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1082 +#: ../src/guestfs.pod:1080 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 " @@ -41624,7 +41846,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1086 +#: ../src/guestfs.pod:1084 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 " @@ -41632,12 +41854,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1090 +#: ../src/guestfs.pod:1088 msgid "Using guestfs_add_domain with live flag" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1092 +#: ../src/guestfs.pod:1090 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 " @@ -41646,7 +41868,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1098 +#: ../src/guestfs.pod:1096 #, no-wrap msgid "" " <domain>\n" @@ -41664,14 +41886,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1110 +#: ../src/guestfs.pod:1108 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:1113 +#: ../src/guestfs.pod:1111 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 " @@ -41679,19 +41901,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1117 +#: ../src/guestfs.pod:1115 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:1121 +#: ../src/guestfs.pod:1119 msgid "ABI GUARANTEE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1123 +#: ../src/guestfs.pod:1121 msgid "" "We guarantee the libguestfs ABI (binary interface), for public, high-level " "actions as outlined in this section. Although we will deprecate some " @@ -41701,12 +41923,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1129 +#: ../src/guestfs.pod:1127 msgid "BLOCK DEVICE NAMING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1131 +#: ../src/guestfs.pod:1129 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 " @@ -41721,7 +41943,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1143 +#: ../src/guestfs.pod:1141 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 " @@ -41729,7 +41951,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1147 +#: ../src/guestfs.pod:1145 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 " @@ -41737,7 +41959,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1152 +#: ../src/guestfs.pod:1150 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 " @@ -41746,7 +41968,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1158 +#: ../src/guestfs.pod:1156 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 " @@ -41754,12 +41976,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1163 +#: ../src/guestfs.pod:1161 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1165 +#: ../src/guestfs.pod:1163 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 " @@ -41769,7 +41991,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1171 +#: ../src/guestfs.pod:1169 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 " @@ -41777,54 +41999,54 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1179 +#: ../src/guestfs.pod:1177 msgid "Is the string a parameter which is a device or partition name?" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1183 +#: ../src/guestfs.pod:1181 msgid "Does the string begin with C</dev/sd>?" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1187 +#: ../src/guestfs.pod:1185 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:1192 +#: ../src/guestfs.pod:1190 msgid "Replace initial C</dev/sd> string with C</dev/hd>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1194 +#: ../src/guestfs.pod:1192 msgid "For example, change C</dev/sda2> to C</dev/hda2>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1196 +#: ../src/guestfs.pod:1194 msgid "If that named device exists, use it. If not, continue." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1200 +#: ../src/guestfs.pod:1198 msgid "Replace initial C</dev/sd> string with C</dev/vd>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1202 +#: ../src/guestfs.pod:1200 msgid "If that named device exists, use it. If not, return an error." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1206 +#: ../src/guestfs.pod:1204 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1208 +#: ../src/guestfs.pod:1206 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 " @@ -41832,50 +42054,50 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1212 +#: ../src/guestfs.pod:1210 msgid "" "Where possible for maximum future portability programs using libguestfs " "should use these future-proof techniques:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1219 +#: ../src/guestfs.pod:1217 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:1222 +#: ../src/guestfs.pod:1220 msgid "Since those device names exist by definition, they will never be translated." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1227 +#: ../src/guestfs.pod:1225 msgid "" "Use higher level ways to identify filesystems, such as LVM names, UUIDs and " "filesystem labels." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1232 ../sysprep/virt-sysprep.pod:376 +#: ../src/guestfs.pod:1230 ../sysprep/virt-sysprep.pod:376 msgid "SECURITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1234 +#: ../src/guestfs.pod:1232 msgid "" "This section discusses security implications of using libguestfs, " "particularly with untrusted or malicious guests or disk images." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1237 +#: ../src/guestfs.pod:1235 msgid "GENERAL SECURITY CONSIDERATIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1239 +#: ../src/guestfs.pod:1237 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 " @@ -41885,42 +42107,42 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1249 +#: ../src/guestfs.pod:1247 msgid "the data (file etc) not being present" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1253 +#: ../src/guestfs.pod:1251 msgid "being present but empty" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1257 +#: ../src/guestfs.pod:1255 msgid "being much larger than normal" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1261 +#: ../src/guestfs.pod:1259 msgid "containing arbitrary 8 bit data" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1265 +#: ../src/guestfs.pod:1263 msgid "being in an unexpected character encoding" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1269 +#: ../src/guestfs.pod:1267 msgid "containing homoglyphs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1273 +#: ../src/guestfs.pod:1271 msgid "SECURITY OF MOUNTING FILESYSTEMS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1275 +#: ../src/guestfs.pod:1273 msgid "" "When you mount a filesystem under Linux, mistakes in the kernel filesystem " "(VFS) module can sometimes be escalated into exploits by deliberately " @@ -41936,7 +42158,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1288 +#: ../src/guestfs.pod:1286 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 " @@ -41950,19 +42172,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1299 +#: ../src/guestfs.pod:1297 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:1302 +#: ../src/guestfs.pod:1300 msgid "PROTOCOL SECURITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1304 +#: ../src/guestfs.pod:1302 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 " @@ -41972,12 +42194,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1310 +#: ../src/guestfs.pod:1308 msgid "INSPECTION SECURITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1312 +#: ../src/guestfs.pod:1310 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 " @@ -41986,7 +42208,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1318 +#: ../src/guestfs.pod:1316 msgid "" "Guest configuration may be altered in unusual ways by the administrator of " "the virtual machine, and may not reflect reality (particularly for untrusted " @@ -41997,7 +42219,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1326 +#: ../src/guestfs.pod:1324 msgid "" "The inspection API parses guest configuration using two external libraries: " "Augeas (Linux configuration) and hivex (Windows Registry). Both are " @@ -42007,12 +42229,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1332 +#: ../src/guestfs.pod:1330 msgid "RUNNING UNTRUSTED GUEST COMMANDS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1334 +#: ../src/guestfs.pod:1332 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 " @@ -42022,24 +42244,24 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1340 +#: ../src/guestfs.pod:1338 msgid "CVE-2010-3851" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1342 +#: ../src/guestfs.pod:1340 msgid "https://bugzilla.redhat.com/642934" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1344 +#: ../src/guestfs.pod:1342 msgid "" "This security bug concerns the automatic disk format detection that qemu " "does on disk images." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1347 +#: ../src/guestfs.pod:1345 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 " @@ -42048,7 +42270,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1352 +#: ../src/guestfs.pod:1350 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 " @@ -42057,7 +42279,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1357 +#: ../src/guestfs.pod:1355 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 " @@ -42069,24 +42291,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1365 +#: ../src/guestfs.pod:1363 msgid "In libguestfs this is rather hard to exploit except under two circumstances:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1372 +#: ../src/guestfs.pod:1370 msgid "You have enabled the network or have opened the disk in write mode." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1376 +#: ../src/guestfs.pod:1374 msgid "" "You are also running untrusted code from the guest (see L</RUNNING " "COMMANDS>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1381 +#: ../src/guestfs.pod:1379 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 " @@ -42095,31 +42317,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1386 +#: ../src/guestfs.pod:1384 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:1389 +#: ../src/guestfs.pod:1387 msgid "" "For libguestfs tools, use the I<--format> command line parameter as " "appropriate." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1392 +#: ../src/guestfs.pod:1390 msgid "CONNECTION MANAGEMENT" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1394 +#: ../src/guestfs.pod:1392 msgid "guestfs_h *" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1396 +#: ../src/guestfs.pod:1394 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 " @@ -42127,19 +42349,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1400 +#: ../src/guestfs.pod:1398 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:1403 +#: ../src/guestfs.pod:1401 msgid "guestfs_create" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1405 +#: ../src/guestfs.pod:1403 #, no-wrap msgid "" " guestfs_h *guestfs_create (void);\n" @@ -42147,19 +42369,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1407 +#: ../src/guestfs.pod:1405 msgid "Create a connection handle." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1409 +#: ../src/guestfs.pod:1407 msgid "" "On success this returns a non-NULL pointer to a handle. On error it returns " "NULL." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1412 +#: ../src/guestfs.pod:1410 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 " @@ -42167,24 +42389,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1416 +#: ../src/guestfs.pod:1414 msgid "After configuring the handle, you have to call L</guestfs_launch>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1418 +#: ../src/guestfs.pod:1416 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:1421 +#: ../src/guestfs.pod:1419 msgid "guestfs_close" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1423 +#: ../src/guestfs.pod:1421 #, no-wrap msgid "" " void guestfs_close (guestfs_h *g);\n" @@ -42192,37 +42414,74 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1425 -msgid "This closes the connection handle and frees up all resources used." +#: ../src/guestfs.pod:1423 +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:1427 +#: ../src/guestfs.pod:1426 +msgid "The correct way to close the handle is:" +msgstr "" + +#. type: verbatim +#: ../src/guestfs.pod:1428 +#, no-wrap msgid "" -"If autosync was set on the handle and the handle was launched, then this " -"implicitly calls various functions to unmount filesystems and sync the " -"disk. See L</guestfs_set_autosync> for more details." +" if (guestfs_shutdown (g) == -1) {\n" +" /* handle write errors here */\n" +" }\n" +" guestfs_close (g);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1433 +msgid "L</guestfs_shutdown> is only needed if B<all> of the following are true:" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1439 +msgid "one or more disks were added in read-write mode, I<and>" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1443 +msgid "guestfs_launch was called, I<and>" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1447 +msgid "you made some changes, I<and>" +msgstr "" + +#. type: =item +#: ../src/guestfs.pod:1449 +msgid "4" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1431 -msgid "If a close callback was set on the handle, then it is called." +#: ../src/guestfs.pod:1451 +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:1433 +#: ../src/guestfs.pod:1456 msgid "ERROR HANDLING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1435 +#: ../src/guestfs.pod:1458 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:1438 +#: ../src/guestfs.pod:1461 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 " @@ -42230,7 +42489,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1442 +#: ../src/guestfs.pod:1465 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 " @@ -42238,7 +42497,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1447 +#: ../src/guestfs.pod:1470 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 " @@ -42246,7 +42505,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1451 +#: ../src/guestfs.pod:1474 #, no-wrap msgid "" " if (guestfs_launch (g) == -1)\n" @@ -42255,21 +42514,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1454 +#: ../src/guestfs.pod:1477 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:1457 +#: ../src/guestfs.pod:1480 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:1460 +#: ../src/guestfs.pod:1483 #, no-wrap msgid "" " /* This disables the default behaviour of printing errors\n" @@ -42279,7 +42538,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1464 +#: ../src/guestfs.pod:1487 #, no-wrap msgid "" " if (guestfs_launch (g) == -1) {\n" @@ -42296,7 +42555,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1475 +#: ../src/guestfs.pod:1498 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 " @@ -42304,7 +42563,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1479 +#: ../src/guestfs.pod:1502 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 " @@ -42314,12 +42573,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1485 +#: ../src/guestfs.pod:1508 msgid "guestfs_last_error" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1487 +#: ../src/guestfs.pod:1510 #, no-wrap msgid "" " const char *guestfs_last_error (guestfs_h *g);\n" @@ -42327,26 +42586,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1489 +#: ../src/guestfs.pod:1512 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:1493 +#: ../src/guestfs.pod:1516 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:1496 +#: ../src/guestfs.pod:1519 msgid "guestfs_last_errno" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1498 +#: ../src/guestfs.pod:1521 #, no-wrap msgid "" " int guestfs_last_errno (guestfs_h *g);\n" @@ -42354,27 +42613,27 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1500 +#: ../src/guestfs.pod:1523 msgid "This returns the last error number (errno) that happened on C<g>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1502 +#: ../src/guestfs.pod:1525 msgid "If successful, an errno integer not equal to zero is returned." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1504 +#: ../src/guestfs.pod:1527 msgid "If no error, this returns 0. This call can return 0 in three situations:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1511 +#: ../src/guestfs.pod:1534 msgid "There has not been any error on the handle." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1515 +#: ../src/guestfs.pod:1538 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 " @@ -42382,14 +42641,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1521 +#: ../src/guestfs.pod:1544 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:1527 +#: ../src/guestfs.pod:1550 msgid "" "Libguestfs tries to convert the errno from inside the applicance into a " "corresponding errno for the caller (not entirely trivial: the appliance " @@ -42400,12 +42659,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1535 +#: ../src/guestfs.pod:1558 msgid "guestfs_set_error_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1537 +#: ../src/guestfs.pod:1560 #, no-wrap msgid "" " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n" @@ -42418,7 +42677,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1544 +#: ../src/guestfs.pod:1567 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 " @@ -42426,14 +42685,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1548 +#: ../src/guestfs.pod:1571 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:1551 +#: ../src/guestfs.pod:1574 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 " @@ -42441,22 +42700,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1555 +#: ../src/guestfs.pod:1578 msgid "The default handler prints messages on C<stderr>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1557 +#: ../src/guestfs.pod:1580 msgid "If you set C<cb> to C<NULL> then I<no> handler is called." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1559 +#: ../src/guestfs.pod:1582 msgid "guestfs_get_error_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1561 +#: ../src/guestfs.pod:1584 #, no-wrap msgid "" " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n" @@ -42465,17 +42724,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1564 +#: ../src/guestfs.pod:1587 msgid "Returns the current error handler callback." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1566 +#: ../src/guestfs.pod:1589 msgid "guestfs_set_out_of_memory_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1568 +#: ../src/guestfs.pod:1591 #, no-wrap msgid "" " typedef void (*guestfs_abort_cb) (void);\n" @@ -42485,29 +42744,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1572 +#: ../src/guestfs.pod:1595 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:1575 +#: ../src/guestfs.pod:1598 msgid "The default is to call L<abort(3)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1577 +#: ../src/guestfs.pod:1600 msgid "You cannot set C<cb> to C<NULL>. You can't ignore out of memory situations." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1580 +#: ../src/guestfs.pod:1603 msgid "guestfs_get_out_of_memory_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1582 +#: ../src/guestfs.pod:1605 #, no-wrap msgid "" " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n" @@ -42515,37 +42774,37 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1584 +#: ../src/guestfs.pod:1607 msgid "This returns the current out of memory handler." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1586 +#: ../src/guestfs.pod:1609 msgid "API CALLS" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1590 +#: ../src/guestfs.pod:1613 msgid "STRUCTURES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1592 +#: ../src/guestfs.pod:1615 msgid "@STRUCTS@" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1594 +#: ../src/guestfs.pod:1617 msgid "AVAILABILITY" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1596 +#: ../src/guestfs.pod:1619 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1598 +#: ../src/guestfs.pod:1621 msgid "" "Using L</guestfs_available> you can test availability of the following " "groups of functions. This test queries the appliance to see if the " @@ -42553,17 +42812,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1603 +#: ../src/guestfs.pod:1626 msgid "@AVAILABILITY@" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1605 +#: ../src/guestfs.pod:1628 msgid "GUESTFISH supported COMMAND" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1607 +#: ../src/guestfs.pod:1630 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 " @@ -42571,19 +42830,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1612 +#: ../src/guestfs.pod:1635 msgid "SINGLE CALLS AT COMPILE TIME" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1614 +#: ../src/guestfs.pod:1637 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:1617 +#: ../src/guestfs.pod:1640 #, no-wrap msgid "" " #define LIBGUESTFS_HAVE_DD 1\n" @@ -42591,12 +42850,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1619 +#: ../src/guestfs.pod:1642 msgid "if L</guestfs_dd> is available." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1621 +#: ../src/guestfs.pod:1644 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 " @@ -42604,7 +42863,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1626 +#: ../src/guestfs.pod:1649 #, no-wrap msgid "" " AC_CHECK_LIB([guestfs],[guestfs_create])\n" @@ -42613,19 +42872,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1629 +#: ../src/guestfs.pod:1652 msgid "" "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined " "in your program." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1632 +#: ../src/guestfs.pod:1655 msgid "SINGLE CALLS AT RUN TIME" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1634 +#: ../src/guestfs.pod:1657 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 " @@ -42635,7 +42894,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1641 +#: ../src/guestfs.pod:1664 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 " @@ -42643,7 +42902,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1645 +#: ../src/guestfs.pod:1668 #, no-wrap msgid "" " #include <stdio.h>\n" @@ -42655,7 +42914,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1651 +#: ../src/guestfs.pod:1674 #, no-wrap msgid "" " main ()\n" @@ -42667,7 +42926,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1657 +#: ../src/guestfs.pod:1680 #, no-wrap msgid "" " /* Test if the function guestfs_dd is really available. */\n" @@ -42682,7 +42941,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1666 +#: ../src/guestfs.pod:1689 #, no-wrap msgid "" " if (!has_function)\n" @@ -42701,7 +42960,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1679 +#: ../src/guestfs.pod:1702 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 " @@ -42709,7 +42968,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1684 +#: ../src/guestfs.pod:1707 #, no-wrap msgid "" " Requires: libguestfs >= 1.0.80\n" @@ -42717,12 +42976,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1686 +#: ../src/guestfs.pod:1709 msgid "CALLS WITH OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1688 +#: ../src/guestfs.pod:1711 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 " @@ -42730,7 +42989,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1693 +#: ../src/guestfs.pod:1716 #, no-wrap msgid "" " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n" @@ -42738,14 +42997,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1695 +#: ../src/guestfs.pod:1718 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:1698 +#: ../src/guestfs.pod:1721 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename, -1);\n" @@ -42753,12 +43012,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1700 +#: ../src/guestfs.pod:1723 msgid "With a single optional argument:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1702 +#: ../src/guestfs.pod:1725 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -42768,12 +43027,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1706 +#: ../src/guestfs.pod:1729 msgid "With two:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1708 +#: ../src/guestfs.pod:1731 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -42784,19 +43043,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1713 +#: ../src/guestfs.pod:1736 msgid "" "and so forth. Don't forget the terminating C<-1> otherwise Bad Things will " "happen!" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1716 +#: ../src/guestfs.pod:1739 msgid "USING va_list FOR OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1718 +#: ../src/guestfs.pod:1741 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 " @@ -42804,7 +43063,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1722 +#: ../src/guestfs.pod:1745 #, no-wrap msgid "" " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n" @@ -42813,12 +43072,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1725 +#: ../src/guestfs.pod:1748 msgid "CONSTRUCTING OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1727 +#: ../src/guestfs.pod:1750 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 " @@ -42828,7 +43087,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1733 +#: ../src/guestfs.pod:1756 #, no-wrap msgid "" " struct guestfs_add_drive_opts_argv {\n" @@ -42843,12 +43102,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1742 +#: ../src/guestfs.pod:1765 msgid "You could call it like this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1744 +#: ../src/guestfs.pod:1767 #, no-wrap msgid "" " struct guestfs_add_drive_opts_argv optargs = {\n" @@ -42861,7 +43120,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1751 +#: ../src/guestfs.pod:1774 #, no-wrap msgid "" " guestfs_add_drive_opts_argv (g, filename, &optargs);\n" @@ -42869,29 +43128,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1759 +#: ../src/guestfs.pod:1782 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1764 +#: ../src/guestfs.pod:1787 msgid "You do not need to fill in all fields of the structure." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1768 +#: ../src/guestfs.pod:1791 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:1773 +#: ../src/guestfs.pod:1796 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1775 +#: ../src/guestfs.pod:1798 msgid "" "In other languages, optional arguments are expressed in the way that is " "natural for that language. We refer you to the language-specific " @@ -42899,17 +43158,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1779 +#: ../src/guestfs.pod:1802 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1781 +#: ../src/guestfs.pod:1804 msgid "SETTING CALLBACKS TO HANDLE EVENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1783 +#: ../src/guestfs.pod:1806 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 " @@ -42921,7 +43180,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1792 +#: ../src/guestfs.pod:1815 msgid "" "Handles generate events when certain things happen, such as log messages " "being generated, progress messages during long-running operations, or the " @@ -42933,7 +43192,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1800 +#: ../src/guestfs.pod:1823 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 " @@ -42942,31 +43201,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1805 +#: ../src/guestfs.pod:1828 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:1809 +#: ../src/guestfs.pod:1832 msgid "CLASSES OF EVENTS" msgstr "" #. type: =item -#: ../src/guestfs.pod:1813 +#: ../src/guestfs.pod:1836 msgid "GUESTFS_EVENT_CLOSE (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1816 +#: ../src/guestfs.pod:1839 msgid "" "The callback function will be called while the handle is being closed " "(synchronously from L</guestfs_close>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1819 +#: ../src/guestfs.pod:1842 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 " @@ -42977,19 +43236,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1826 +#: ../src/guestfs.pod:1849 msgid "" "If no callback is registered: the handle is closed without any callback " "being invoked." msgstr "" #. type: =item -#: ../src/guestfs.pod:1829 +#: ../src/guestfs.pod:1852 msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1832 +#: ../src/guestfs.pod:1855 msgid "" "The callback function will be called when the child process quits, either " "asynchronously or if killed by L</guestfs_kill_subprocess>. (This " @@ -42997,17 +43256,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1836 ../src/guestfs.pod:1845 ../src/guestfs.pod:1962 +#: ../src/guestfs.pod:1859 ../src/guestfs.pod:1868 ../src/guestfs.pod:1985 msgid "If no callback is registered: the event is ignored." msgstr "" #. type: =item -#: ../src/guestfs.pod:1838 +#: ../src/guestfs.pod:1861 msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1841 +#: ../src/guestfs.pod:1864 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 " @@ -43015,12 +43274,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:1847 +#: ../src/guestfs.pod:1870 msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1850 +#: ../src/guestfs.pod:1873 msgid "" "Some long-running operations can generate progress messages. If this " "callback is registered, then it will be called each time a progress message " @@ -43030,14 +43289,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1856 +#: ../src/guestfs.pod:1879 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:1859 +#: ../src/guestfs.pod:1882 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 " @@ -43046,24 +43305,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1864 +#: ../src/guestfs.pod:1887 msgid "The only defined and stable parts of the API are:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1870 +#: ../src/guestfs.pod:1893 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:1875 +#: ../src/guestfs.pod:1898 msgid "0 E<lt>= C<position> E<lt>= C<total>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1879 +#: ../src/guestfs.pod:1902 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 " @@ -43071,7 +43330,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1883 +#: ../src/guestfs.pod:1906 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 " @@ -43079,7 +43338,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1889 +#: ../src/guestfs.pod:1912 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 " @@ -43088,7 +43347,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1894 +#: ../src/guestfs.pod:1917 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 " @@ -43096,14 +43355,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1898 +#: ../src/guestfs.pod:1921 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:1903 +#: ../src/guestfs.pod:1926 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 " @@ -43112,31 +43371,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1909 +#: ../src/guestfs.pod:1932 msgid "If no callback is registered: progress messages are discarded." msgstr "" #. type: =item -#: ../src/guestfs.pod:1911 +#: ../src/guestfs.pod:1934 msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1914 +#: ../src/guestfs.pod:1937 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:1917 +#: ../src/guestfs.pod:1940 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:1920 ../src/guestfs.pod:1934 +#: ../src/guestfs.pod:1943 ../src/guestfs.pod:1957 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 " @@ -43144,62 +43403,62 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:1925 +#: ../src/guestfs.pod:1948 msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1928 +#: ../src/guestfs.pod:1951 msgid "" "The callback function is called whenever a log message is generated by the " "library part of libguestfs." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1931 +#: ../src/guestfs.pod:1954 msgid "" "If the verbose flag (L</guestfs_set_verbose>) is set then additional debug " "messages are generated." msgstr "" #. type: =item -#: ../src/guestfs.pod:1939 +#: ../src/guestfs.pod:1962 msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1942 +#: ../src/guestfs.pod:1965 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:1945 +#: ../src/guestfs.pod:1968 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:1949 +#: ../src/guestfs.pod:1972 msgid "GUESTFS_EVENT_ENTER (payload type: function name)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1952 +#: ../src/guestfs.pod:1975 msgid "The callback function is called whenever a libguestfs function is entered." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1955 +#: ../src/guestfs.pod:1978 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:1958 +#: ../src/guestfs.pod:1981 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 " @@ -43207,12 +43466,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1966 +#: ../src/guestfs.pod:1989 msgid "guestfs_set_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1968 +#: ../src/guestfs.pod:1991 #, no-wrap msgid "" " int guestfs_set_event_callback (guestfs_h *g,\n" @@ -43224,14 +43483,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1974 +#: ../src/guestfs.pod:1997 msgid "" "This function registers a callback (C<cb>) for all event classes in the " "C<event_bitmask>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1977 +#: ../src/guestfs.pod:2000 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>. " @@ -43240,40 +43499,40 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1983 +#: ../src/guestfs.pod:2006 msgid "C<flags> should always be passed as 0." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1985 +#: ../src/guestfs.pod:2008 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:1988 +#: ../src/guestfs.pod:2011 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:1991 +#: ../src/guestfs.pod:2014 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:1994 +#: ../src/guestfs.pod:2017 msgid "" "Callbacks remain in effect until they are deleted, or until the handle is " "closed." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1997 +#: ../src/guestfs.pod:2020 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 " @@ -43281,12 +43540,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2001 +#: ../src/guestfs.pod:2024 msgid "guestfs_delete_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2003 +#: ../src/guestfs.pod:2026 #, no-wrap msgid "" " void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n" @@ -43294,7 +43553,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2005 +#: ../src/guestfs.pod:2028 msgid "" "Delete a callback that was previously registered. C<event_handle> should be " "the integer that was returned by a previous call to " @@ -43302,12 +43561,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2009 +#: ../src/guestfs.pod:2032 msgid "guestfs_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2011 +#: ../src/guestfs.pod:2034 #, no-wrap msgid "" " typedef void (*guestfs_event_callback) (\n" @@ -43322,12 +43581,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2020 +#: ../src/guestfs.pod:2043 msgid "This is the type of the event callback function that you have to provide." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2023 +#: ../src/guestfs.pod:2046 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 " @@ -43335,7 +43594,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2027 +#: ../src/guestfs.pod:2050 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 " @@ -43344,7 +43603,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2032 +#: ../src/guestfs.pod:2055 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 " @@ -43352,19 +43611,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2036 +#: ../src/guestfs.pod:2059 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:2039 +#: ../src/guestfs.pod:2062 msgid "EXAMPLE: CAPTURING LOG MESSAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2041 +#: ../src/guestfs.pod:2064 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 " @@ -43372,7 +43631,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2045 +#: ../src/guestfs.pod:2068 msgid "" "Events associated with log messages are: C<GUESTFS_EVENT_LIBRARY>, " "C<GUESTFS_EVENT_APPLIANCE> and C<GUESTFS_EVENT_TRACE>. (Note that error " @@ -43380,14 +43639,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2050 +#: ../src/guestfs.pod:2073 msgid "" "Programs have to set up a callback to capture the classes of events of " "interest:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2053 +#: ../src/guestfs.pod:2076 #, no-wrap msgid "" " int eh =\n" @@ -43403,14 +43662,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2063 +#: ../src/guestfs.pod:2086 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:2066 +#: ../src/guestfs.pod:2089 #, no-wrap msgid "" " static void\n" @@ -43431,12 +43690,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2081 +#: ../src/guestfs.pod:2104 msgid "CANCELLING LONG TRANSFERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2083 +#: ../src/guestfs.pod:2106 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 " @@ -43445,12 +43704,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2088 +#: ../src/guestfs.pod:2111 msgid "guestfs_user_cancel" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2090 +#: ../src/guestfs.pod:2113 #, no-wrap msgid "" " void guestfs_user_cancel (guestfs_h *g);\n" @@ -43458,12 +43717,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2092 +#: ../src/guestfs.pod:2115 msgid "C<guestfs_user_cancel> cancels the current upload or download operation." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2095 +#: ../src/guestfs.pod:2118 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 " @@ -43471,7 +43730,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2099 +#: ../src/guestfs.pod:2122 msgid "" "The transfer that was in progress (if there is one) will stop shortly " "afterwards, and will return an error. The errno (see " @@ -43480,7 +43739,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2105 +#: ../src/guestfs.pod:2128 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 " @@ -43488,12 +43747,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2109 +#: ../src/guestfs.pod:2132 msgid "There are two common places that you might call C<guestfs_user_cancel>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2111 +#: ../src/guestfs.pod:2134 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 " @@ -43502,19 +43761,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2116 +#: ../src/guestfs.pod:2139 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:2120 +#: ../src/guestfs.pod:2143 msgid "PRIVATE DATA AREA" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2122 +#: ../src/guestfs.pod:2145 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 " @@ -43522,12 +43781,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2127 +#: ../src/guestfs.pod:2150 msgid "To attach a named piece of data, use the following call:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2129 +#: ../src/guestfs.pod:2152 #, no-wrap msgid "" " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n" @@ -43535,7 +43794,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2131 +#: ../src/guestfs.pod:2154 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 " @@ -43543,7 +43802,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2135 +#: ../src/guestfs.pod:2158 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 " @@ -43553,12 +43812,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2141 +#: ../src/guestfs.pod:2164 msgid "To retrieve the pointer, use:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2143 +#: ../src/guestfs.pod:2166 #, no-wrap msgid "" " void *guestfs_get_private (guestfs_h *g, const char *key);\n" @@ -43566,7 +43825,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2145 +#: ../src/guestfs.pod:2168 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 " @@ -43574,7 +43833,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2149 +#: ../src/guestfs.pod:2172 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 " @@ -43585,12 +43844,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2156 +#: ../src/guestfs.pod:2179 msgid "To walk over all entries, use these two functions:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2158 +#: ../src/guestfs.pod:2181 #, no-wrap msgid "" " void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n" @@ -43598,7 +43857,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2160 +#: ../src/guestfs.pod:2183 #, no-wrap msgid "" " void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n" @@ -43606,7 +43865,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2162 +#: ../src/guestfs.pod:2185 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 " @@ -43616,7 +43875,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2168 +#: ../src/guestfs.pod:2191 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 " @@ -43624,17 +43883,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2172 +#: ../src/guestfs.pod:2195 msgid "Notes about walking over entries:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2178 +#: ../src/guestfs.pod:2201 msgid "You must not call C<guestfs_set_private> while walking over the entries." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2183 +#: ../src/guestfs.pod:2206 msgid "" "The handle maintains an internal iterator which is reset when you call " "C<guestfs_first_private>. This internal iterator is invalidated when you " @@ -43642,12 +43901,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2189 +#: ../src/guestfs.pod:2212 msgid "If you have set the data pointer associated with a key to C<NULL>, ie:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2191 +#: ../src/guestfs.pod:2214 #, no-wrap msgid "" " guestfs_set_private (g, key, NULL);\n" @@ -43655,26 +43914,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2193 +#: ../src/guestfs.pod:2216 msgid "then that C<key> is not returned when walking." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2197 +#: ../src/guestfs.pod:2220 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:2203 +#: ../src/guestfs.pod:2226 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:2206 +#: ../src/guestfs.pod:2229 #, no-wrap msgid "" " const char *key;\n" @@ -43688,14 +43947,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2214 +#: ../src/guestfs.pod:2237 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:2217 +#: ../src/guestfs.pod:2240 #, no-wrap msgid "" " const char *key;\n" @@ -43710,7 +43969,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2226 +#: ../src/guestfs.pod:2249 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 " @@ -43718,7 +43977,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2230 +#: ../src/guestfs.pod:2253 #, no-wrap msgid "" " const char *key;\n" @@ -43740,7 +43999,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2246 +#: ../src/guestfs.pod:2269 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 " @@ -43749,12 +44008,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2251 +#: ../src/guestfs.pod:2274 msgid "SYSTEMTAP" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2253 +#: ../src/guestfs.pod:2276 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 " @@ -43762,12 +44021,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2257 +#: ../src/guestfs.pod:2280 msgid "You can list all the static markers by doing:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2259 +#: ../src/guestfs.pod:2282 #, no-wrap msgid "" " stap -l 'process(\"/usr/lib*/libguestfs.so.0\")\n" @@ -43776,26 +44035,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2262 +#: ../src/guestfs.pod:2285 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:2265 +#: ../src/guestfs.pod:2288 msgid "SYSTEMTAP SCRIPT EXAMPLE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2267 +#: ../src/guestfs.pod:2290 msgid "" "This script contains examples of displaying both the static markers and some " "ordinary C entry points:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2294 +#: ../src/guestfs.pod:2317 #, no-wrap msgid "" " /* Display all calls to guestfs_mkfs* functions. */\n" @@ -43808,7 +44067,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2301 +#: ../src/guestfs.pod:2324 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 " @@ -43817,7 +44076,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2306 +#: ../src/guestfs.pod:2329 #, no-wrap msgid "" " # stap /tmp/test.stap\n" @@ -43826,17 +44085,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2309 +#: ../src/guestfs.pod:2332 msgid "In another terminal, run a guestfish command such as this:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2313 +#: ../src/guestfs.pod:2336 msgid "In the first terminal, stap trace output similar to this is shown:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2315 +#: ../src/guestfs.pod:2338 #, no-wrap msgid "" " 1318248056692655 (+0):\tlaunch_start\n" @@ -43850,19 +44109,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2324 +#: ../src/guestfs.pod:2347 msgid "" "<!-- old anchor for the next section --> <a " "name=\"state_machine_and_low_level_event_api\"/>" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2329 +#: ../src/guestfs.pod:2352 msgid "ARCHITECTURE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2331 +#: ../src/guestfs.pod:2354 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 " @@ -43870,7 +44129,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2335 +#: ../src/guestfs.pod:2358 #, no-wrap msgid "" " ___________________\n" @@ -43896,14 +44155,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2355 +#: ../src/guestfs.pod:2378 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:2358 +#: ../src/guestfs.pod:2381 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 " @@ -43915,7 +44174,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2367 +#: ../src/guestfs.pod:2390 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 " @@ -43926,17 +44185,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2374 +#: ../src/guestfs.pod:2397 msgid "STATE MACHINE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2376 +#: ../src/guestfs.pod:2399 msgid "libguestfs uses a state machine to model the child process:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2378 +#: ../src/guestfs.pod:2401 #, no-wrap msgid "" " |\n" @@ -43964,7 +44223,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2400 +#: ../src/guestfs.pod:2423 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), " @@ -43973,7 +44232,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2405 +#: ../src/guestfs.pod:2428 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 " @@ -43981,14 +44240,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2409 +#: ../src/guestfs.pod:2432 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:2412 +#: ../src/guestfs.pod:2435 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 " @@ -43997,7 +44256,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2418 +#: ../src/guestfs.pod:2441 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. " @@ -44006,7 +44265,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2423 +#: ../src/guestfs.pod:2446 msgid "" "Finally, the child process sends asynchronous messages back to the main " "program, such as kernel log messages. You can register a callback to " @@ -44014,17 +44273,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2427 +#: ../src/guestfs.pod:2450 msgid "INTERNALS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2429 +#: ../src/guestfs.pod:2452 msgid "APPLIANCE BOOT PROCESS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2431 +#: ../src/guestfs.pod:2454 msgid "" "This process has evolved and continues to evolve. The description here " "corresponds only to the current version of libguestfs and is provided for " @@ -44032,55 +44291,55 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2435 +#: ../src/guestfs.pod:2458 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:2440 +#: ../src/guestfs.pod:2463 msgid "Create the appliance" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2442 +#: ../src/guestfs.pod:2465 msgid "" "C<febootstrap-supermin-helper> is invoked to create the kernel, a small " "initrd and the appliance." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2445 +#: ../src/guestfs.pod:2468 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:2448 +#: ../src/guestfs.pod:2471 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:2452 +#: ../src/guestfs.pod:2475 msgid "Start qemu and boot the kernel" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2454 +#: ../src/guestfs.pod:2477 msgid "qemu is invoked to boot the kernel." msgstr "" #. type: =item -#: ../src/guestfs.pod:2456 +#: ../src/guestfs.pod:2479 msgid "Run the initrd" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2458 +#: ../src/guestfs.pod:2481 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 " @@ -44088,21 +44347,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2462 +#: ../src/guestfs.pod:2485 msgid "" "The initrd is a cpio archive called " "C</var/tmp/.guestfs-E<lt>UIDE<gt>/initrd>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2465 +#: ../src/guestfs.pod:2488 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:2468 +#: ../src/guestfs.pod:2491 #, no-wrap msgid "" " febootstrap: ext2 mini initrd starting up\n" @@ -44113,12 +44372,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2473 +#: ../src/guestfs.pod:2496 msgid "Find and mount the appliance device" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2475 +#: ../src/guestfs.pod:2498 msgid "" "The appliance is a sparse file containing an ext2 filesystem which contains " "a familiar (although reduced in size) Linux operating system. It would " @@ -44126,33 +44385,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2479 +#: ../src/guestfs.pod:2502 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:2482 +#: ../src/guestfs.pod:2505 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:2485 +#: ../src/guestfs.pod:2508 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:2489 +#: ../src/guestfs.pod:2512 msgid "If this works successfully you will see messages such as:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2491 +#: ../src/guestfs.pod:2514 #, no-wrap msgid "" " febootstrap: picked /sys/block/vdb/dev as root device\n" @@ -44164,19 +44423,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2497 +#: ../src/guestfs.pod:2520 msgid "" "Note that C<Starting /init script ...> indicates that the appliance's init " "script is now running." msgstr "" #. type: =item -#: ../src/guestfs.pod:2500 +#: ../src/guestfs.pod:2523 msgid "Initialize the appliance" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2502 +#: ../src/guestfs.pod:2525 msgid "" "The appliance itself now initializes itself. This involves starting certain " "processes like C<udev>, possibly printing some debug information, and " @@ -44184,19 +44443,19 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2506 +#: ../src/guestfs.pod:2529 msgid "The daemon" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2508 +#: ../src/guestfs.pod:2531 msgid "" "Finally the daemon (C<guestfsd>) runs inside the appliance. If it runs you " "should see:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2511 +#: ../src/guestfs.pod:2534 #, no-wrap msgid "" " verbose daemon enabled\n" @@ -44204,14 +44463,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2513 +#: ../src/guestfs.pod:2536 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:2516 +#: ../src/guestfs.pod:2539 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 " @@ -44219,19 +44478,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2522 +#: ../src/guestfs.pod:2545 msgid "COMMUNICATION PROTOCOL" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2524 +#: ../src/guestfs.pod:2547 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:2527 +#: ../src/guestfs.pod:2550 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 " @@ -44239,14 +44498,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2531 +#: ../src/guestfs.pod:2554 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:2534 +#: ../src/guestfs.pod:2557 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 " @@ -44256,17 +44515,17 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2541 +#: ../src/guestfs.pod:2564 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2543 +#: ../src/guestfs.pod:2566 msgid "For ordinary functions, the request message is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2545 +#: ../src/guestfs.pod:2568 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -44277,7 +44536,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2550 +#: ../src/guestfs.pod:2573 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 " @@ -44286,21 +44545,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2556 +#: ../src/guestfs.pod:2579 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:2559 +#: ../src/guestfs.pod:2582 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:2563 +#: ../src/guestfs.pod:2586 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 " @@ -44312,12 +44571,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2571 +#: ../src/guestfs.pod:2594 msgid "The reply message for ordinary functions is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2573 +#: ../src/guestfs.pod:2596 #, no-wrap msgid "" " total length (header + ret,\n" @@ -44328,26 +44587,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2578 +#: ../src/guestfs.pod:2601 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:2581 +#: ../src/guestfs.pod:2604 msgid "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2584 +#: ../src/guestfs.pod:2607 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:2587 +#: ../src/guestfs.pod:2610 #, no-wrap msgid "" " total length (header + error,\n" @@ -44358,19 +44617,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2592 +#: ../src/guestfs.pod:2615 msgid "" "The C<guestfs_message_error> structure contains the error message as a " "string." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2595 +#: ../src/guestfs.pod:2618 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2597 +#: ../src/guestfs.pod:2620 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 " @@ -44378,7 +44637,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2601 +#: ../src/guestfs.pod:2624 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -44392,12 +44651,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2609 +#: ../src/guestfs.pod:2632 msgid "The \"sequence of chunks\" is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2611 +#: ../src/guestfs.pod:2634 #, no-wrap msgid "" " length of chunk (not including length word itself)\n" @@ -44411,7 +44670,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2619 +#: ../src/guestfs.pod:2642 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 " @@ -44419,7 +44678,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2623 +#: ../src/guestfs.pod:2646 msgid "" "At time of writing there are no functions that have more than one FileIn " "parameter. However this is (theoretically) supported, by sending the " @@ -44428,7 +44687,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2628 +#: ../src/guestfs.pod:2651 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 " @@ -44437,7 +44696,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2634 +#: ../src/guestfs.pod:2657 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 " @@ -44449,7 +44708,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2643 +#: ../src/guestfs.pod:2666 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 " @@ -44459,19 +44718,19 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2649 +#: ../src/guestfs.pod:2672 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2651 +#: ../src/guestfs.pod:2674 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:2654 +#: ../src/guestfs.pod:2677 #, no-wrap msgid "" " total length (header + ret,\n" @@ -44485,12 +44744,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2662 +#: ../src/guestfs.pod:2685 msgid "INITIAL MESSAGE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2664 +#: ../src/guestfs.pod:2687 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 " @@ -44498,12 +44757,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2668 +#: ../src/guestfs.pod:2691 msgid "PROGRESS NOTIFICATION MESSAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2670 +#: ../src/guestfs.pod:2693 msgid "" "The daemon may send progress notification messages at any time. These are " "distinguished by the normal length word being replaced by " @@ -44511,7 +44770,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2674 +#: ../src/guestfs.pod:2697 msgid "" "The library turns them into progress callbacks (see " "L</GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards " @@ -44519,7 +44778,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2678 +#: ../src/guestfs.pod:2701 msgid "" "The daemon self-limits the frequency of progress messages it sends (see " "C<daemon/proto.c:notify_progress>). Not all calls generate progress " @@ -44527,12 +44786,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2682 +#: ../src/guestfs.pod:2705 msgid "LIBGUESTFS VERSION NUMBERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2684 +#: ../src/guestfs.pod:2707 msgid "" "Since April 2010, libguestfs has started to make separate development and " "stable releases, along with corresponding branches in our git repository. " @@ -44540,7 +44799,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2689 +#: ../src/guestfs.pod:2712 #, no-wrap msgid "" " even numbers for stable: 1.2.x, 1.4.x, ...\n" @@ -44557,12 +44816,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2700 +#: ../src/guestfs.pod:2723 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2702 +#: ../src/guestfs.pod:2725 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 " @@ -44572,26 +44831,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2708 +#: ../src/guestfs.pod:2731 msgid "Our criteria for backporting changes are:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2714 +#: ../src/guestfs.pod:2737 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:2720 +#: ../src/guestfs.pod:2743 msgid "" "Bug fixes which are not controversial, fix obvious problems, and have been " "well tested are backported." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2725 +#: ../src/guestfs.pod:2748 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 " @@ -44599,7 +44858,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2731 +#: ../src/guestfs.pod:2754 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 " @@ -44607,7 +44866,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2737 +#: ../src/guestfs.pod:2760 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 " @@ -44618,17 +44877,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2745 +#: ../src/guestfs.pod:2768 msgid "EXTENDING LIBGUESTFS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2747 +#: ../src/guestfs.pod:2770 msgid "ADDING A NEW API ACTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2749 +#: ../src/guestfs.pod:2772 msgid "" "Large amounts of boilerplate code in libguestfs (RPC, bindings, " "documentation) are generated, and this makes it easy to extend the " @@ -44636,19 +44895,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2753 +#: ../src/guestfs.pod:2776 msgid "To add a new API action there are two changes:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2759 +#: ../src/guestfs.pod:2782 msgid "" "You need to add a description of the call (name, parameters, return type, " "tests, documentation) to C<generator/generator_actions.ml>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2762 +#: ../src/guestfs.pod:2785 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 " @@ -44659,7 +44918,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2770 +#: ../src/guestfs.pod:2793 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 " @@ -44669,7 +44928,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2776 +#: ../src/guestfs.pod:2799 msgid "" "For library-only actions of the second type, add to the " "C<non_daemon_functions> list. Since these functions are serviced by the " @@ -44679,36 +44938,36 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2784 +#: ../src/guestfs.pod:2807 msgid "Implement the action (in C):" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2786 +#: ../src/guestfs.pod:2809 msgid "" "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the " "C<daemon/> directory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2789 +#: ../src/guestfs.pod:2812 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:2792 +#: ../src/guestfs.pod:2815 msgid "In either case, use another function as an example of what to do." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2796 +#: ../src/guestfs.pod:2819 msgid "After making these changes, use C<make> to compile." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2798 +#: ../src/guestfs.pod:2821 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 " @@ -44716,12 +44975,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2802 +#: ../src/guestfs.pod:2825 msgid "ADDING TESTS FOR AN API ACTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2804 +#: ../src/guestfs.pod:2827 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 " @@ -44731,61 +44990,61 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2811 +#: ../src/guestfs.pod:2834 msgid "" "The following describes the test environment used when you add an API test " "in C<generator_actions.ml>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2814 +#: ../src/guestfs.pod:2837 msgid "The test environment has 4 block devices:" msgstr "" #. type: =item -#: ../src/guestfs.pod:2818 +#: ../src/guestfs.pod:2841 msgid "C</dev/sda> 500MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2820 +#: ../src/guestfs.pod:2843 msgid "General block device for testing." msgstr "" #. type: =item -#: ../src/guestfs.pod:2822 +#: ../src/guestfs.pod:2845 msgid "C</dev/sdb> 50MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2824 +#: ../src/guestfs.pod:2847 msgid "" "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write " "operations." msgstr "" #. type: =item -#: ../src/guestfs.pod:2827 +#: ../src/guestfs.pod:2850 msgid "C</dev/sdc> 10MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2829 +#: ../src/guestfs.pod:2852 msgid "Used in a few tests where two block devices are needed." msgstr "" #. type: =item -#: ../src/guestfs.pod:2831 +#: ../src/guestfs.pod:2854 msgid "C</dev/sdd>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2833 +#: ../src/guestfs.pod:2856 msgid "ISO with fixed content (see C<images/test.iso>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2837 +#: ../src/guestfs.pod:2860 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 " @@ -44793,7 +45052,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2841 +#: ../src/guestfs.pod:2864 msgid "" "Each test starts with an initial scenario, selected using one of the " "C<Init*> expressions, described in C<generator/generator_types.ml>. These " @@ -44803,7 +45062,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2847 +#: ../src/guestfs.pod:2870 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 " @@ -44813,14 +45072,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2853 +#: ../src/guestfs.pod:2876 msgid "" "In addition, packagers can skip individual tests by setting environment " "variables before running C<make check>." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2856 +#: ../src/guestfs.pod:2879 #, no-wrap msgid "" " SKIP_TEST_<CMD>_<NUM>=1\n" @@ -44828,12 +45087,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2858 +#: ../src/guestfs.pod:2881 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2862 +#: ../src/guestfs.pod:2885 #, no-wrap msgid "" " SKIP_TEST_<CMD>=1\n" @@ -44841,17 +45100,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2864 +#: ../src/guestfs.pod:2887 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2866 +#: ../src/guestfs.pod:2889 msgid "Packagers can run only certain tests by setting for example:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2868 +#: ../src/guestfs.pod:2891 #, no-wrap msgid "" " TEST_ONLY=\"vfs_type zerofree\"\n" @@ -44859,29 +45118,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2870 +#: ../src/guestfs.pod:2893 msgid "" "See C<tests/c-api/tests.c> for more details of how these environment " "variables work." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2873 +#: ../src/guestfs.pod:2896 msgid "DEBUGGING NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2875 +#: ../src/guestfs.pod:2898 msgid "Test new actions work before submitting them." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2877 +#: ../src/guestfs.pod:2900 msgid "You can use guestfish to try out new commands." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2879 +#: ../src/guestfs.pod:2902 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 " @@ -44889,12 +45148,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2883 +#: ../src/guestfs.pod:2906 msgid "FORMATTING CODE AND OTHER CONVENTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2885 +#: ../src/guestfs.pod:2908 msgid "" "Our C source code generally adheres to some basic code-formatting " "conventions. The existing code base is not totally consistent on this " @@ -44904,14 +45163,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2891 +#: ../src/guestfs.pod:2914 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:2894 +#: ../src/guestfs.pod:2917 #, no-wrap msgid "" " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n" @@ -44927,7 +45186,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2904 +#: ../src/guestfs.pod:2927 #, no-wrap msgid "" " ;;; When editing C sources in libguestfs, use this style.\n" @@ -44945,12 +45204,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2916 +#: ../src/guestfs.pod:2939 msgid "Enable warnings when compiling (and fix any problems this finds):" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2919 +#: ../src/guestfs.pod:2942 #, no-wrap msgid "" " ./configure --enable-gcc-warnings\n" @@ -44958,12 +45217,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2921 +#: ../src/guestfs.pod:2944 msgid "Useful targets are:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2923 +#: ../src/guestfs.pod:2946 #, no-wrap msgid "" " make syntax-check # checks the syntax of the C code\n" @@ -44972,43 +45231,43 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2926 +#: ../src/guestfs.pod:2949 msgid "DAEMON CUSTOM PRINTF FORMATTERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2928 +#: ../src/guestfs.pod:2951 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:2933 +#: ../src/guestfs.pod:2956 msgid "%Q" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2935 +#: ../src/guestfs.pod:2958 msgid "" "Simple shell quoted string. Any spaces or other shell characters are " "escaped for you." msgstr "" #. type: =item -#: ../src/guestfs.pod:2938 +#: ../src/guestfs.pod:2961 msgid "%R" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2940 +#: ../src/guestfs.pod:2963 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:2947 +#: ../src/guestfs.pod:2970 #, no-wrap msgid "" " asprintf (&cmd, \"cat %R\", path);\n" @@ -45016,12 +45275,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2949 +#: ../src/guestfs.pod:2972 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2951 +#: ../src/guestfs.pod:2974 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 " @@ -45030,12 +45289,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2957 +#: ../src/guestfs.pod:2980 msgid "SUBMITTING YOUR NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2959 +#: ../src/guestfs.pod:2982 msgid "" "Submit patches to the mailing list: " "L<http://www.redhat.com/mailman/listinfo/libguestfs> and CC to " @@ -45043,17 +45302,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2963 +#: ../src/guestfs.pod:2986 msgid "INTERNATIONALIZATION (I18N) SUPPORT" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2965 +#: ../src/guestfs.pod:2988 msgid "We support i18n (gettext anyhow) in the library." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2967 +#: ../src/guestfs.pod:2990 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 " @@ -45062,103 +45321,103 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2973 +#: ../src/guestfs.pod:2996 msgid "" "Debugging messages are never translated, since they are intended for the " "programmers." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2976 +#: ../src/guestfs.pod:2999 msgid "SOURCE CODE SUBDIRECTORIES" msgstr "" #. type: =item -#: ../src/guestfs.pod:2980 +#: ../src/guestfs.pod:3003 msgid "C<align>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2982 +#: ../src/guestfs.pod:3005 msgid "L<virt-alignment-scan(1)> command and documentation." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2986 +#: ../src/guestfs.pod:3009 msgid "The libguestfs appliance, build scripts and so on." msgstr "" #. type: =item -#: ../src/guestfs.pod:2988 +#: ../src/guestfs.pod:3011 msgid "C<cat>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2990 +#: ../src/guestfs.pod:3013 msgid "" "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and " "documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2993 +#: ../src/guestfs.pod:3016 msgid "C<contrib>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2995 +#: ../src/guestfs.pod:3018 msgid "Outside contributions, experimental parts." msgstr "" #. type: =item -#: ../src/guestfs.pod:2997 +#: ../src/guestfs.pod:3020 msgid "C<daemon>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2999 +#: ../src/guestfs.pod:3022 msgid "" "The daemon that runs inside the libguestfs appliance and carries out " "actions." msgstr "" #. type: =item -#: ../src/guestfs.pod:3002 +#: ../src/guestfs.pod:3025 msgid "C<df>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3004 +#: ../src/guestfs.pod:3027 msgid "L<virt-df(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3006 +#: ../src/guestfs.pod:3029 msgid "C<edit>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3008 +#: ../src/guestfs.pod:3031 msgid "L<virt-edit(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3010 +#: ../src/guestfs.pod:3033 msgid "C<examples>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3012 +#: ../src/guestfs.pod:3035 msgid "C API example code." msgstr "" #. type: =item -#: ../src/guestfs.pod:3014 +#: ../src/guestfs.pod:3037 msgid "C<fish>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3016 +#: ../src/guestfs.pod:3039 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)>, " @@ -45166,79 +45425,79 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3022 +#: ../src/guestfs.pod:3045 msgid "L<virt-format(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3024 +#: ../src/guestfs.pod:3047 msgid "C<fuse>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3026 +#: ../src/guestfs.pod:3049 msgid "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:3028 +#: ../src/guestfs.pod:3051 msgid "C<generator>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3030 +#: ../src/guestfs.pod:3053 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:3033 +#: ../src/guestfs.pod:3056 msgid "C<inspector>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3035 +#: ../src/guestfs.pod:3058 msgid "L<virt-inspector(1)>, the virtual machine image inspector." msgstr "" #. type: =item -#: ../src/guestfs.pod:3037 +#: ../src/guestfs.pod:3060 msgid "C<logo>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3039 +#: ../src/guestfs.pod:3062 msgid "Logo used on the website. The fish is called Arthur by the way." msgstr "" #. type: =item -#: ../src/guestfs.pod:3041 +#: ../src/guestfs.pod:3064 msgid "C<m4>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3043 +#: ../src/guestfs.pod:3066 msgid "M4 macros used by autoconf." msgstr "" #. type: =item -#: ../src/guestfs.pod:3045 +#: ../src/guestfs.pod:3068 msgid "C<po>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3047 +#: ../src/guestfs.pod:3070 msgid "Translations of simple gettext strings." msgstr "" #. type: =item -#: ../src/guestfs.pod:3049 +#: ../src/guestfs.pod:3072 msgid "C<po-docs>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3051 +#: ../src/guestfs.pod:3074 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 " @@ -45246,149 +45505,149 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:3055 +#: ../src/guestfs.pod:3078 msgid "C<rescue>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3057 +#: ../src/guestfs.pod:3080 msgid "L<virt-rescue(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3059 +#: ../src/guestfs.pod:3082 msgid "C<resize>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3061 +#: ../src/guestfs.pod:3084 msgid "L<virt-resize(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3063 +#: ../src/guestfs.pod:3086 msgid "C<sparsify>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3065 +#: ../src/guestfs.pod:3088 msgid "L<virt-sparsify(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3067 +#: ../src/guestfs.pod:3090 msgid "C<src>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3069 +#: ../src/guestfs.pod:3092 msgid "Source code to the C library." msgstr "" #. type: =item -#: ../src/guestfs.pod:3071 +#: ../src/guestfs.pod:3094 msgid "C<sysprep>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3073 +#: ../src/guestfs.pod:3096 msgid "L<virt-sysprep(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3075 +#: ../src/guestfs.pod:3098 msgid "C<test-tool>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3077 +#: ../src/guestfs.pod:3100 msgid "" "Test tool for end users to test if their qemu/kernel combination will work " "with libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:3080 +#: ../src/guestfs.pod:3103 msgid "C<tests>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3082 +#: ../src/guestfs.pod:3105 msgid "Tests." msgstr "" #. type: =item -#: ../src/guestfs.pod:3084 +#: ../src/guestfs.pod:3107 msgid "C<tools>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3086 +#: ../src/guestfs.pod:3109 msgid "Command line tools written in Perl (L<virt-win-reg(1)> and many others)." msgstr "" #. type: =item -#: ../src/guestfs.pod:3088 +#: ../src/guestfs.pod:3111 msgid "C<csharp>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3090 +#: ../src/guestfs.pod:3113 msgid "C<erlang>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3092 +#: ../src/guestfs.pod:3115 msgid "C<gobject>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3094 +#: ../src/guestfs.pod:3117 msgid "C<haskell>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3096 +#: ../src/guestfs.pod:3119 msgid "C<java>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3098 +#: ../src/guestfs.pod:3121 msgid "C<ocaml>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3100 +#: ../src/guestfs.pod:3123 msgid "C<php>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3102 +#: ../src/guestfs.pod:3125 msgid "C<perl>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3104 +#: ../src/guestfs.pod:3127 msgid "C<python>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3106 +#: ../src/guestfs.pod:3129 msgid "C<ruby>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3108 +#: ../src/guestfs.pod:3131 msgid "Language bindings." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3112 +#: ../src/guestfs.pod:3135 msgid "MAKING A STABLE RELEASE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3114 +#: ../src/guestfs.pod:3137 msgid "" "When we make a stable release, there are several steps documented here. See " "L</LIBGUESTFS VERSION NUMBERS> for general information about the stable " @@ -45396,32 +45655,32 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3122 +#: ../src/guestfs.pod:3145 msgid "Check C<make && make check> works on at least Fedora, Debian and Ubuntu." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3127 +#: ../src/guestfs.pod:3150 msgid "Finalize RELEASE-NOTES." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3131 +#: ../src/guestfs.pod:3154 msgid "Update ROADMAP." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3135 +#: ../src/guestfs.pod:3158 msgid "Run C<src/api-support/update-from-tarballs.sh>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3139 +#: ../src/guestfs.pod:3162 msgid "Push and pull from Transifex." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3143 +#: ../src/guestfs.pod:3166 #, no-wrap msgid "" " tx push -s\n" @@ -45429,12 +45688,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3145 +#: ../src/guestfs.pod:3168 msgid "to push the latest POT files to Transifex. Then run:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3147 +#: ../src/guestfs.pod:3170 #, no-wrap msgid "" " ./tx-pull.sh\n" @@ -45442,24 +45701,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3149 +#: ../src/guestfs.pod:3172 msgid "which is a wrapper to pull the latest translated C<*.po> files." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3153 +#: ../src/guestfs.pod:3176 msgid "" "Create new stable and development directories under " "L<http://libguestfs.org/download>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3158 +#: ../src/guestfs.pod:3181 msgid "Create the branch in git:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3160 +#: ../src/guestfs.pod:3183 #, no-wrap msgid "" " git tag -a 1.XX.0 -m \"Version 1.XX.0 (stable)\"\n" @@ -45470,17 +45729,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:3167 +#: ../src/guestfs.pod:3190 msgid "LIMITS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3169 +#: ../src/guestfs.pod:3192 msgid "PROTOCOL LIMITS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3171 +#: ../src/guestfs.pod:3194 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 " @@ -45491,7 +45750,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3179 +#: ../src/guestfs.pod:3202 msgid "" "A simple call such as L</guestfs_cat> returns its result (the file data) in " "a simple string. Because this string is at some point internally encoded as " @@ -45500,7 +45759,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3185 +#: ../src/guestfs.pod:3208 msgid "" "In order to transfer large files into and out of the guest filesystem, you " "need to use particular calls that support this. The sections L</UPLOADING> " @@ -45508,24 +45767,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3189 +#: ../src/guestfs.pod:3212 msgid "" "You might also consider mounting the disk image using our FUSE filesystem " "support (L<guestmount(1)>)." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3192 +#: ../src/guestfs.pod:3215 msgid "MAXIMUM NUMBER OF DISKS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3194 +#: ../src/guestfs.pod:3217 msgid "When using virtio disks (the default) the current limit is B<25> disks." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3197 +#: ../src/guestfs.pod:3220 msgid "" "Virtio itself consumes 1 virtual PCI slot per disk, and PCI is limited to 31 " "slots. However febootstrap only understands disks with names C</dev/vda> " @@ -45534,14 +45793,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3202 +#: ../src/guestfs.pod:3225 msgid "" "We are working to substantially raise this limit in future versions but it " "requires complex changes to qemu." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3205 +#: ../src/guestfs.pod:3228 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 " @@ -45549,41 +45808,41 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3209 +#: ../src/guestfs.pod:3232 msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3211 +#: ../src/guestfs.pod:3234 msgid "Virtio limits the maximum number of partitions per disk to B<15>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3213 +#: ../src/guestfs.pod:3236 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:3216 +#: ../src/guestfs.pod:3239 msgid "" "If you attach a disk with more than 15 partitions, the extra partitions are " "ignored by libguestfs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3219 +#: ../src/guestfs.pod:3242 msgid "MAXIMUM SIZE OF A DISK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3221 +#: ../src/guestfs.pod:3244 msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3223 +#: ../src/guestfs.pod:3246 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 " @@ -45591,7 +45850,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3227 +#: ../src/guestfs.pod:3250 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 " @@ -45601,19 +45860,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3233 +#: ../src/guestfs.pod:3256 msgid "" "For the hugest disk image files, we recommend using XFS on the host for " "storage." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3236 +#: ../src/guestfs.pod:3259 msgid "MAXIMUM SIZE OF A PARTITION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3238 +#: ../src/guestfs.pod:3261 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 " @@ -45621,7 +45880,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3242 +#: ../src/guestfs.pod:3265 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 " @@ -45629,12 +45888,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3247 +#: ../src/guestfs.pod:3270 msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3249 +#: ../src/guestfs.pod:3272 msgid "" "This depends on the filesystem type. libguestfs itself does not impose any " "known limit. Consult Wikipedia or the filesystem documentation to find out " @@ -45642,12 +45901,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3253 +#: ../src/guestfs.pod:3276 msgid "MAXIMUM UPLOAD AND DOWNLOAD" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3255 +#: ../src/guestfs.pod:3278 msgid "" "The API functions L</guestfs_upload>, L</guestfs_download>, " "L</guestfs_tar_in>, L</guestfs_tar_out> and the like allow unlimited sized " @@ -45655,12 +45914,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3259 +#: ../src/guestfs.pod:3282 msgid "INSPECTION LIMITS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3261 +#: ../src/guestfs.pod:3284 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 " @@ -45670,33 +45929,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3287 +#: ../src/guestfs.pod:3310 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:3299 +#: ../src/guestfs.pod:3322 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:3308 +#: ../src/guestfs.pod:3331 msgid "See also L</QEMU WRAPPERS> above." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3312 +#: ../src/guestfs.pod:3335 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:3330 +#: ../src/guestfs.pod:3353 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)>, " @@ -45715,59 +45974,59 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3372 +#: ../src/guestfs.pod:3395 msgid "" "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, " "L<lvm(8)>, L<disktype(1)>." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:3379 ../tools/virt-make-fs.pl:606 ../tools/virt-win-reg.pl:772 +#: ../src/guestfs.pod:3402 ../tools/virt-make-fs.pl:605 ../tools/virt-win-reg.pl:772 msgid "BUGS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3381 +#: ../src/guestfs.pod:3404 msgid "To get a list of bugs against libguestfs use this link:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3383 +#: ../src/guestfs.pod:3406 msgid "L<https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3385 +#: ../src/guestfs.pod:3408 msgid "To report a new bug against libguestfs use this link:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3387 +#: ../src/guestfs.pod:3410 msgid "L<https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3389 +#: ../src/guestfs.pod:3412 msgid "When reporting a bug, please check:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3395 +#: ../src/guestfs.pod:3418 msgid "That the bug hasn't been reported already." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3399 +#: ../src/guestfs.pod:3422 msgid "That you are testing a recent version." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3403 +#: ../src/guestfs.pod:3426 msgid "Describe the bug accurately, and give a way to reproduce it." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3407 +#: ../src/guestfs.pod:3430 msgid "" "Run libguestfs-test-tool and paste the B<complete, unedited> output into the " "bug report." @@ -47246,7 +47505,7 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-list-filesystems.pl:216 ../tools/virt-tar.pl:317 +#: ../tools/virt-list-filesystems.pl:216 ../tools/virt-tar.pl:315 msgid "Copyright (C) 2009 Red Hat Inc." msgstr "" @@ -47732,7 +47991,7 @@ msgid "For MBR, virt-make-fs sets the partition type byte automatically." msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:593 +#: ../tools/virt-make-fs.pl:592 msgid "" "L<guestfish(1)>, L<virt-format(1)>, L<virt-resize(1)>, L<virt-tar-in(1)>, " "L<mkisofs(1)>, L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, " @@ -47741,14 +48000,14 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:608 ../tools/virt-win-reg.pl:774 +#: ../tools/virt-make-fs.pl:607 ../tools/virt-win-reg.pl:774 msgid "" "When reporting bugs, please enable debugging and capture the I<complete> " "output:" msgstr "" #. type: verbatim -#: ../tools/virt-make-fs.pl:611 +#: ../tools/virt-make-fs.pl:610 #, no-wrap msgid "" " export LIBGUESTFS_DEBUG=1\n" @@ -47757,7 +48016,7 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:614 +#: ../tools/virt-make-fs.pl:613 msgid "" "Attach /tmp/virt-make-fs.log to a new bug report at " "L<https://bugzilla.redhat.com/>" @@ -47965,7 +48224,7 @@ msgid "Specify that the input or output tarball is gzip-compressed." msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:298 +#: ../tools/virt-tar.pl:296 msgid "" "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, " "L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, " |