diff options
Diffstat (limited to 'po-docs/libguestfs-docs.pot')
-rw-r--r-- | po-docs/libguestfs-docs.pot | 643 |
1 files changed, 360 insertions, 283 deletions
diff --git a/po-docs/libguestfs-docs.pot b/po-docs/libguestfs-docs.pot index edde059b..1b4531c9 100644 --- a/po-docs/libguestfs-docs.pot +++ b/po-docs/libguestfs-docs.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: libguestfs 1.19.54\n" +"Project-Id-Version: libguestfs 1.19.55\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2012-10-29 15:19+0000\n" +"POT-Creation-Date: 2012-10-30 14:32+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -343,7 +343,7 @@ msgid "" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:146 ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337 ../df/virt-df.pod:110 ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242 ../fish/guestfish.pod:689 ../format/virt-format.pod:96 ../inspector/virt-inspector.pod:350 ../rescue/virt-rescue.pod:164 ../src/guestfs.pod:3471 ../sysprep/virt-sysprep.pod:112 +#: ../align/virt-alignment-scan.pod:146 ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337 ../df/virt-df.pod:110 ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242 ../fish/guestfish.pod:689 ../format/virt-format.pod:96 ../inspector/virt-inspector.pod:350 ../rescue/virt-rescue.pod:164 ../src/guestfs.pod:3506 ../sysprep/virt-sysprep.pod:112 msgid "For example:" msgstr "" @@ -751,7 +751,7 @@ msgid "This program returns:" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:347 ../align/virt-alignment-scan.pod:353 ../align/virt-alignment-scan.pod:359 ../align/virt-alignment-scan.pod:366 ../appliance/libguestfs-make-fixed-appliance.pod:32 ../appliance/libguestfs-make-fixed-appliance.pod:53 ../cat/virt-cat.pod:177 ../cat/virt-cat.pod:182 ../cat/virt-cat.pod:187 ../cat/virt-cat.pod:198 ../cat/virt-cat.pod:202 ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266 ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276 ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291 ../examples/guestfs-faq.pod:149 ../examples/guestfs-faq.pod:155 ../examples/guestfs-faq.pod:194 ../examples/guestfs-faq.pod:200 ../examples/guestfs-performance.pod:107 ../examples/guestfs-performance.pod:113 ../examples/guestfs-performance.pod:118 ../examples/guestfs-performance.pod:253 ../examples/guestfs-performance.pod:258 ../examples/guestfs-performance.pod:263 ../examples/guestfs-recipes.pod:128 ../examples/guestfs-recipes.pod:132 ../examples/guestfs-recipes.pod:136 ../examples/guestfs-recipes.pod:162 ../examples/guestfs-recipes.pod:167 ../examples/guestfs-recipes.pod:257 ../examples/guestfs-recipes.pod:261 ../examples/guestfs-recipes.pod:265 ../examples/guestfs-recipes.pod:269 ../examples/guestfs-recipes.pod:273 ../examples/guestfs-testing.pod:124 ../examples/guestfs-testing.pod:128 ../examples/guestfs-testing.pod:132 ../fish/guestfish-actions.pod:432 ../fish/guestfish-actions.pod:440 ../fish/guestfish-actions.pod:447 ../fish/guestfish-actions.pod:454 ../fish/guestfish-actions.pod:1495 ../fish/guestfish-actions.pod:1499 ../fish/guestfish-actions.pod:1503 ../fish/guestfish-actions.pod:1507 ../fish/guestfish-actions.pod:1515 ../fish/guestfish-actions.pod:1519 ../fish/guestfish-actions.pod:1523 ../fish/guestfish-actions.pod:1533 ../fish/guestfish-actions.pod:1537 ../fish/guestfish-actions.pod:1541 ../fish/guestfish-actions.pod:1652 ../fish/guestfish-actions.pod:1656 ../fish/guestfish-actions.pod:1661 ../fish/guestfish-actions.pod:1703 ../fish/guestfish-actions.pod:1707 ../fish/guestfish-actions.pod:1712 ../fish/guestfish-actions.pod:2201 ../fish/guestfish-actions.pod:2208 ../fish/guestfish-actions.pod:2215 ../fish/guestfish-actions.pod:2793 ../fish/guestfish-actions.pod:2799 ../fish/guestfish-actions.pod:2807 ../fish/guestfish-actions.pod:2814 ../fish/guestfish-actions.pod:2821 ../fish/guestfish.pod:461 ../fish/guestfish.pod:465 ../fish/guestfish.pod:469 ../fish/guestfish.pod:473 ../guestfs-release-notes.pod:90 ../guestfs-release-notes.pod:94 ../guestfs-release-notes.pod:98 ../guestfs-release-notes.pod:102 ../guestfs-release-notes.pod:106 ../guestfs-release-notes.pod:110 ../guestfs-release-notes.pod:115 ../guestfs-release-notes.pod:119 ../guestfs-release-notes.pod:243 ../guestfs-release-notes.pod:247 ../guestfs-release-notes.pod:251 ../guestfs-release-notes.pod:255 ../guestfs-release-notes.pod:259 ../guestfs-release-notes.pod:263 ../guestfs-release-notes.pod:267 ../inspector/virt-inspector.pod:514 ../inspector/virt-inspector.pod:518 ../resize/virt-resize.pod:365 ../resize/virt-resize.pod:369 ../resize/virt-resize.pod:378 ../resize/virt-resize.pod:384 ../sparsify/virt-sparsify.pod:45 ../sparsify/virt-sparsify.pod:52 ../sparsify/virt-sparsify.pod:56 ../sparsify/virt-sparsify.pod:62 ../sparsify/virt-sparsify.pod:67 ../sparsify/virt-sparsify.pod:72 ../src/guestfs-actions.pod:638 ../src/guestfs-actions.pod:646 ../src/guestfs-actions.pod:653 ../src/guestfs-actions.pod:660 ../src/guestfs-actions.pod:2497 ../src/guestfs-actions.pod:2501 ../src/guestfs-actions.pod:2505 ../src/guestfs-actions.pod:2509 ../src/guestfs-actions.pod:2517 ../src/guestfs-actions.pod:2521 ../src/guestfs-actions.pod:2525 ../src/guestfs-actions.pod:2535 ../src/guestfs-actions.pod:2539 ../src/guestfs-actions.pod:2543 ../src/guestfs-actions.pod:2715 ../src/guestfs-actions.pod:2719 ../src/guestfs-actions.pod:2724 ../src/guestfs-actions.pod:2785 ../src/guestfs-actions.pod:2789 ../src/guestfs-actions.pod:2794 ../src/guestfs-actions.pod:3556 ../src/guestfs-actions.pod:3563 ../src/guestfs-actions.pod:3570 ../src/guestfs-actions.pod:4437 ../src/guestfs-actions.pod:4443 ../src/guestfs-actions.pod:4451 ../src/guestfs-actions.pod:4458 ../src/guestfs-actions.pod:4465 ../src/guestfs.pod:397 ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411 ../src/guestfs.pod:416 ../src/guestfs.pod:420 ../src/guestfs.pod:425 ../src/guestfs.pod:430 ../src/guestfs.pod:1264 ../src/guestfs.pod:1268 ../src/guestfs.pod:1272 ../src/guestfs.pod:1277 ../src/guestfs.pod:1285 ../src/guestfs.pod:1304 ../src/guestfs.pod:1312 ../src/guestfs.pod:1329 ../src/guestfs.pod:1334 ../src/guestfs.pod:1338 ../src/guestfs.pod:1480 ../src/guestfs.pod:1484 ../src/guestfs.pod:1488 ../src/guestfs.pod:1492 ../src/guestfs.pod:1496 ../src/guestfs.pod:1500 ../src/guestfs.pod:2108 ../src/guestfs.pod:2113 ../src/guestfs.pod:2117 ../src/guestfs.pod:2221 ../src/guestfs.pod:2226 ../src/guestfs.pod:2230 ../src/guestfs.pod:2240 ../src/guestfs.pod:2667 ../src/guestfs.pod:2672 ../src/guestfs.pod:2678 ../src/guestfs.pod:2686 ../src/guestfs.pod:3203 ../src/guestfs.pod:3209 ../src/guestfs.pod:3214 ../src/guestfs.pod:3220 ../src/guestfs.pod:3666 ../src/guestfs.pod:3671 ../src/guestfs.pod:3675 ../src/guestfs.pod:3679 ../src/guestfs.pod:3683 ../src/guestfs.pod:3697 ../src/guestfs.pod:3702 ../sysprep/virt-sysprep.pod:231 ../sysprep/virt-sysprep.pod:235 ../sysprep/virt-sysprep.pod:239 ../sysprep/virt-sysprep.pod:243 ../sysprep/virt-sysprep.pod:258 ../sysprep/virt-sysprep.pod:262 ../sysprep/virt-sysprep.pod:266 ../sysprep/virt-sysprep.pod:270 ../sysprep/virt-sysprep.pod:274 ../sysprep/virt-sysprep.pod:327 ../sysprep/virt-sysprep.pod:339 ../sysprep/virt-sysprep.pod:343 ../sysprep/virt-sysprep.pod:351 ../sysprep/virt-sysprep.pod:357 ../tools/virt-win-reg.pl:197 ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208 ../tools/virt-win-reg.pl:711 ../tools/virt-win-reg.pl:717 ../tools/virt-win-reg.pl:723 +#: ../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:149 ../examples/guestfs-faq.pod:155 ../examples/guestfs-faq.pod:194 ../examples/guestfs-faq.pod:200 ../examples/guestfs-performance.pod:107 ../examples/guestfs-performance.pod:113 ../examples/guestfs-performance.pod:118 ../examples/guestfs-performance.pod:253 ../examples/guestfs-performance.pod:258 ../examples/guestfs-performance.pod:263 ../examples/guestfs-recipes.pod:128 ../examples/guestfs-recipes.pod:132 ../examples/guestfs-recipes.pod:136 ../examples/guestfs-recipes.pod:162 ../examples/guestfs-recipes.pod:167 ../examples/guestfs-recipes.pod:257 ../examples/guestfs-recipes.pod:261 ../examples/guestfs-recipes.pod:265 ../examples/guestfs-recipes.pod:269 ../examples/guestfs-recipes.pod:273 ../examples/guestfs-testing.pod:124 ../examples/guestfs-testing.pod:128 ../examples/guestfs-testing.pod:132 ../fish/guestfish-actions.pod:432 ../fish/guestfish-actions.pod:440 ../fish/guestfish-actions.pod:447 ../fish/guestfish-actions.pod:454 ../fish/guestfish-actions.pod:1495 ../fish/guestfish-actions.pod:1499 ../fish/guestfish-actions.pod:1503 ../fish/guestfish-actions.pod:1507 ../fish/guestfish-actions.pod:1515 ../fish/guestfish-actions.pod:1519 ../fish/guestfish-actions.pod:1523 ../fish/guestfish-actions.pod:1533 ../fish/guestfish-actions.pod:1537 ../fish/guestfish-actions.pod:1541 ../fish/guestfish-actions.pod:1652 ../fish/guestfish-actions.pod:1656 ../fish/guestfish-actions.pod:1661 ../fish/guestfish-actions.pod:1703 ../fish/guestfish-actions.pod:1707 ../fish/guestfish-actions.pod:1712 ../fish/guestfish-actions.pod:2201 ../fish/guestfish-actions.pod:2208 ../fish/guestfish-actions.pod:2215 ../fish/guestfish-actions.pod:2793 ../fish/guestfish-actions.pod:2799 ../fish/guestfish-actions.pod:2807 ../fish/guestfish-actions.pod:2814 ../fish/guestfish-actions.pod:2821 ../fish/guestfish.pod:461 ../fish/guestfish.pod:465 ../fish/guestfish.pod:469 ../fish/guestfish.pod:473 ../guestfs-release-notes.pod:90 ../guestfs-release-notes.pod:94 ../guestfs-release-notes.pod:98 ../guestfs-release-notes.pod:102 ../guestfs-release-notes.pod:106 ../guestfs-release-notes.pod:110 ../guestfs-release-notes.pod:115 ../guestfs-release-notes.pod:119 ../guestfs-release-notes.pod:243 ../guestfs-release-notes.pod:247 ../guestfs-release-notes.pod:251 ../guestfs-release-notes.pod:255 ../guestfs-release-notes.pod:259 ../guestfs-release-notes.pod:263 ../guestfs-release-notes.pod:267 ../inspector/virt-inspector.pod:514 ../inspector/virt-inspector.pod:518 ../resize/virt-resize.pod:365 ../resize/virt-resize.pod:369 ../resize/virt-resize.pod:378 ../resize/virt-resize.pod:384 ../sparsify/virt-sparsify.pod:45 ../sparsify/virt-sparsify.pod:52 ../sparsify/virt-sparsify.pod:56 ../sparsify/virt-sparsify.pod:62 ../sparsify/virt-sparsify.pod:67 ../sparsify/virt-sparsify.pod:72 ../src/guestfs-actions.pod:638 ../src/guestfs-actions.pod:646 ../src/guestfs-actions.pod:653 ../src/guestfs-actions.pod:660 ../src/guestfs-actions.pod:2497 ../src/guestfs-actions.pod:2501 ../src/guestfs-actions.pod:2505 ../src/guestfs-actions.pod:2509 ../src/guestfs-actions.pod:2517 ../src/guestfs-actions.pod:2521 ../src/guestfs-actions.pod:2525 ../src/guestfs-actions.pod:2535 ../src/guestfs-actions.pod:2539 ../src/guestfs-actions.pod:2543 ../src/guestfs-actions.pod:2715 ../src/guestfs-actions.pod:2719 ../src/guestfs-actions.pod:2724 ../src/guestfs-actions.pod:2785 ../src/guestfs-actions.pod:2789 ../src/guestfs-actions.pod:2794 ../src/guestfs-actions.pod:3556 ../src/guestfs-actions.pod:3563 ../src/guestfs-actions.pod:3570 ../src/guestfs-actions.pod:4437 ../src/guestfs-actions.pod:4443 ../src/guestfs-actions.pod:4451 ../src/guestfs-actions.pod:4458 ../src/guestfs-actions.pod:4465 ../src/guestfs.pod:397 ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411 ../src/guestfs.pod:416 ../src/guestfs.pod:420 ../src/guestfs.pod:425 ../src/guestfs.pod:430 ../src/guestfs.pod:1264 ../src/guestfs.pod:1268 ../src/guestfs.pod:1272 ../src/guestfs.pod:1277 ../src/guestfs.pod:1285 ../src/guestfs.pod:1304 ../src/guestfs.pod:1312 ../src/guestfs.pod:1329 ../src/guestfs.pod:1334 ../src/guestfs.pod:1338 ../src/guestfs.pod:1480 ../src/guestfs.pod:1484 ../src/guestfs.pod:1488 ../src/guestfs.pod:1492 ../src/guestfs.pod:1496 ../src/guestfs.pod:1500 ../src/guestfs.pod:2108 ../src/guestfs.pod:2113 ../src/guestfs.pod:2117 ../src/guestfs.pod:2221 ../src/guestfs.pod:2226 ../src/guestfs.pod:2230 ../src/guestfs.pod:2240 ../src/guestfs.pod:2667 ../src/guestfs.pod:2672 ../src/guestfs.pod:2678 ../src/guestfs.pod:2686 ../src/guestfs.pod:3203 ../src/guestfs.pod:3209 ../src/guestfs.pod:3214 ../src/guestfs.pod:3220 ../src/guestfs.pod:3701 ../src/guestfs.pod:3706 ../src/guestfs.pod:3710 ../src/guestfs.pod:3714 ../src/guestfs.pod:3718 ../src/guestfs.pod:3732 ../src/guestfs.pod:3737 ../sysprep/virt-sysprep.pod:231 ../sysprep/virt-sysprep.pod:235 ../sysprep/virt-sysprep.pod:239 ../sysprep/virt-sysprep.pod:243 ../sysprep/virt-sysprep.pod:258 ../sysprep/virt-sysprep.pod:262 ../sysprep/virt-sysprep.pod:266 ../sysprep/virt-sysprep.pod:270 ../sysprep/virt-sysprep.pod:274 ../sysprep/virt-sysprep.pod:327 ../sysprep/virt-sysprep.pod:339 ../sysprep/virt-sysprep.pod:343 ../sysprep/virt-sysprep.pod:351 ../sysprep/virt-sysprep.pod:357 ../tools/virt-win-reg.pl:197 ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208 ../tools/virt-win-reg.pl:711 ../tools/virt-win-reg.pl:717 ../tools/virt-win-reg.pl:723 msgid "*" 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 ../daemon/guestfsd.pod:92 ../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:796 ../examples/guestfs-performance.pod:429 ../examples/guestfs-recipes.pod:473 ../examples/guestfs-testing.pod:305 ../fish/guestfish.pod:1358 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../format/virt-format.pod:177 ../fuse/guestmount.pod:398 ../guestfs-release-notes.pod:1802 ../inspector/virt-inspector.pod:501 ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:40 ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:340 ../resize/virt-resize.pod:702 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:299 ../src/guestfs.pod:3901 ../sysprep/virt-sysprep.pod:480 ../test-tool/libguestfs-test-tool.pod:106 ../tools/virt-list-filesystems.pl:197 ../tools/virt-list-partitions.pl:267 ../tools/virt-make-fs.pl:627 ../tools/virt-tar.pl:294 ../tools/virt-win-reg.pl:747 +#: ../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 ../daemon/guestfsd.pod:92 ../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:796 ../examples/guestfs-performance.pod:429 ../examples/guestfs-recipes.pod:473 ../examples/guestfs-testing.pod:305 ../fish/guestfish.pod:1358 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../format/virt-format.pod:177 ../fuse/guestmount.pod:398 ../guestfs-release-notes.pod:1802 ../inspector/virt-inspector.pod:501 ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:40 ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:340 ../resize/virt-resize.pod:702 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:299 ../src/guestfs.pod:3936 ../sysprep/virt-sysprep.pod:480 ../test-tool/libguestfs-test-tool.pod:106 ../tools/virt-list-filesystems.pl:197 ../tools/virt-list-partitions.pl:267 ../tools/virt-make-fs.pl:627 ../tools/virt-tar.pl:294 ../tools/virt-win-reg.pl:747 msgid "SEE ALSO" msgstr "" @@ -822,7 +822,7 @@ msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:388 ../appliance/libguestfs-make-fixed-appliance.pod:157 ../cat/virt-cat.pod:256 ../cat/virt-filesystems.pod:404 ../cat/virt-ls.pod:511 ../daemon/guestfsd.pod:101 ../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:806 ../examples/guestfs-performance.pod:446 ../examples/guestfs-recipes.pod:490 ../examples/guestfs-testing.pod:316 ../fish/guestfish.pod:1390 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../format/virt-format.pod:191 ../fuse/guestmount.pod:413 ../guestfs-release-notes.pod:1817 ../inspector/virt-inspector.pod:524 ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:57 ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:353 ../resize/virt-resize.pod:729 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:316 ../src/guestfs.pod:3957 ../sysprep/virt-sysprep.pod:501 ../test-tool/libguestfs-test-tool.pod:116 ../tools/virt-list-filesystems.pl:214 ../tools/virt-list-partitions.pl:283 ../tools/virt-make-fs.pl:646 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:766 +#: ../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 ../daemon/guestfsd.pod:101 ../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:806 ../examples/guestfs-performance.pod:446 ../examples/guestfs-recipes.pod:490 ../examples/guestfs-testing.pod:316 ../fish/guestfish.pod:1390 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../format/virt-format.pod:191 ../fuse/guestmount.pod:413 ../guestfs-release-notes.pod:1817 ../inspector/virt-inspector.pod:524 ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:57 ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:353 ../resize/virt-resize.pod:729 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:316 ../src/guestfs.pod:3992 ../sysprep/virt-sysprep.pod:501 ../test-tool/libguestfs-test-tool.pod:116 ../tools/virt-list-filesystems.pl:214 ../tools/virt-list-partitions.pl:283 ../tools/virt-make-fs.pl:646 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:766 msgid "COPYRIGHT" msgstr "" @@ -1078,7 +1078,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../appliance/libguestfs-make-fixed-appliance.pod:139 ../edit/virt-edit.pod:343 ../fish/guestfish.pod:1200 ../rescue/virt-rescue.pod:313 ../sparsify/virt-sparsify.pod:272 ../src/guestfs.pod:3835 ../test-tool/libguestfs-test-tool.pod:101 +#: ../appliance/libguestfs-make-fixed-appliance.pod:139 ../edit/virt-edit.pod:343 ../fish/guestfish.pod:1200 ../rescue/virt-rescue.pod:313 ../sparsify/virt-sparsify.pod:272 ../src/guestfs.pod:3870 ../test-tool/libguestfs-test-tool.pod:101 msgid "ENVIRONMENT VARIABLES" msgstr "" @@ -1097,17 +1097,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../appliance/libguestfs-make-fixed-appliance.pod:153 ../erlang/examples/guestfs-erlang.pod:110 ../examples/guestfs-examples.pod:45 ../examples/guestfs-faq.pod:802 ../examples/guestfs-performance.pod:442 ../examples/guestfs-recipes.pod:486 ../examples/guestfs-testing.pod:312 ../fish/guestfish.pod:1386 ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:409 ../inspector/virt-inspector.pod:510 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:53 ../python/examples/guestfs-python.pod:54 ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3953 ../sysprep/virt-sysprep.pod:495 ../test-tool/libguestfs-test-tool.pod:112 +#: ../appliance/libguestfs-make-fixed-appliance.pod:153 ../erlang/examples/guestfs-erlang.pod:110 ../examples/guestfs-examples.pod:45 ../examples/guestfs-faq.pod:802 ../examples/guestfs-performance.pod:442 ../examples/guestfs-recipes.pod:486 ../examples/guestfs-testing.pod:312 ../fish/guestfish.pod:1386 ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:409 ../inspector/virt-inspector.pod:510 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:53 ../python/examples/guestfs-python.pod:54 ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3988 ../sysprep/virt-sysprep.pod:495 ../test-tool/libguestfs-test-tool.pod:112 msgid "AUTHORS" msgstr "" #. type: textblock -#: ../appliance/libguestfs-make-fixed-appliance.pod:155 ../erlang/examples/guestfs-erlang.pod:112 ../examples/guestfs-examples.pod:47 ../examples/guestfs-faq.pod:804 ../examples/guestfs-performance.pod:444 ../examples/guestfs-recipes.pod:488 ../examples/guestfs-testing.pod:314 ../fish/guestfish.pod:1388 ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:411 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:55 ../python/examples/guestfs-python.pod:56 ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3955 ../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:804 ../examples/guestfs-performance.pod:444 ../examples/guestfs-recipes.pod:488 ../examples/guestfs-testing.pod:314 ../fish/guestfish.pod:1388 ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:411 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:55 ../python/examples/guestfs-python.pod:56 ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3990 ../test-tool/libguestfs-test-tool.pod:114 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)" msgstr "" #. type: textblock -#: ../appliance/libguestfs-make-fixed-appliance.pod:159 ../cat/virt-ls.pod:513 ../daemon/guestfsd.pod:103 ../df/virt-df.pod:267 ../edit/virt-edit.pod:388 ../examples/guestfs-recipes.pod:492 ../fish/guestfish.pod:1392 ../fuse/guestmount.pod:415 ../guestfs-release-notes.pod:1819 ../rescue/virt-rescue.pod:355 ../src/guestfs.pod:3959 ../test-tool/libguestfs-test-tool.pod:118 ../tools/virt-list-partitions.pl:285 +#: ../appliance/libguestfs-make-fixed-appliance.pod:159 ../cat/virt-ls.pod:513 ../daemon/guestfsd.pod:103 ../df/virt-df.pod:267 ../edit/virt-edit.pod:388 ../examples/guestfs-recipes.pod:492 ../fish/guestfish.pod:1392 ../fuse/guestmount.pod:415 ../guestfs-release-notes.pod:1819 ../rescue/virt-rescue.pod:355 ../src/guestfs.pod:3994 ../test-tool/libguestfs-test-tool.pod:118 ../tools/virt-list-partitions.pl:285 msgid "Copyright (C) 2009-2012 Red Hat Inc." msgstr "" @@ -6009,7 +6009,7 @@ msgid "" msgstr "" #. type: =item -#: ../examples/guestfs-performance.pod:162 ../examples/guestfs-performance.pod:211 ../examples/guestfs-recipes.pod:288 ../resize/virt-resize.pod:31 ../resize/virt-resize.pod:603 ../sparsify/virt-sparsify.pod:243 ../src/guestfs.pod:478 ../src/guestfs.pod:1349 ../src/guestfs.pod:1603 ../src/guestfs.pod:1850 ../src/guestfs.pod:3279 +#: ../examples/guestfs-performance.pod:162 ../examples/guestfs-performance.pod:211 ../examples/guestfs-recipes.pod:288 ../resize/virt-resize.pod:31 ../resize/virt-resize.pod:603 ../sparsify/virt-sparsify.pod:243 ../src/guestfs.pod:478 ../src/guestfs.pod:1349 ../src/guestfs.pod:1603 ../src/guestfs.pod:1850 ../src/guestfs.pod:3314 msgid "1." msgstr "" @@ -6021,7 +6021,7 @@ msgid "" msgstr "" #. type: =item -#: ../examples/guestfs-performance.pod:168 ../examples/guestfs-performance.pod:218 ../examples/guestfs-recipes.pod:294 ../resize/virt-resize.pod:44 ../resize/virt-resize.pod:610 ../sparsify/virt-sparsify.pod:250 ../src/guestfs.pod:484 ../src/guestfs.pod:1353 ../src/guestfs.pod:1607 ../src/guestfs.pod:1854 ../src/guestfs.pod:3304 +#: ../examples/guestfs-performance.pod:168 ../examples/guestfs-performance.pod:218 ../examples/guestfs-recipes.pod:294 ../resize/virt-resize.pod:44 ../resize/virt-resize.pod:610 ../sparsify/virt-sparsify.pod:250 ../src/guestfs.pod:484 ../src/guestfs.pod:1353 ../src/guestfs.pod:1607 ../src/guestfs.pod:1854 ../src/guestfs.pod:3339 msgid "2." msgstr "" @@ -7598,7 +7598,7 @@ msgid "Run libguestfs-test-tool" msgstr "" #. type: textblock -#: ../examples/guestfs-testing.pod:32 ../examples/guestfs-testing.pod:145 ../src/guestfs.pod:3687 +#: ../examples/guestfs-testing.pod:32 ../examples/guestfs-testing.pod:145 ../src/guestfs.pod:3722 msgid "Run:" msgstr "" @@ -7672,7 +7672,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-testing.pod:68 ../examples/guestfs-testing.pod:175 ../examples/guestfs-testing.pod:188 ../examples/guestfs-testing.pod:248 ../src/guestfs.pod:3381 +#: ../examples/guestfs-testing.pod:68 ../examples/guestfs-testing.pod:175 ../examples/guestfs-testing.pod:188 ../examples/guestfs-testing.pod:248 ../src/guestfs.pod:3416 msgid "or:" msgstr "" @@ -8543,7 +8543,7 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:152 ../src/guestfs-actions.pod:218 ../src/guestfs.pod:3550 +#: ../fish/guestfish-actions.pod:152 ../src/guestfs-actions.pod:218 ../src/guestfs.pod:3585 msgid "C<format>" msgstr "" @@ -19905,7 +19905,7 @@ msgid "Possible attach methods are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5518 ../src/guestfs-actions.pod:8927 ../src/guestfs.pod:3510 +#: ../fish/guestfish-actions.pod:5518 ../src/guestfs-actions.pod:8927 ../src/guestfs.pod:3545 msgid "C<appliance>" msgstr "" @@ -26541,17 +26541,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1209 ../src/guestfs.pod:3839 +#: ../fish/guestfish.pod:1209 ../src/guestfs.pod:3874 msgid "FEBOOTSTRAP_KERNEL" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1211 ../src/guestfs.pod:3841 +#: ../fish/guestfish.pod:1211 ../src/guestfs.pod:3876 msgid "FEBOOTSTRAP_MODULES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1213 ../src/guestfs.pod:3843 +#: ../fish/guestfish.pod:1213 ../src/guestfs.pod:3878 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 " @@ -26619,17 +26619,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1245 ../src/guestfs.pod:3849 +#: ../fish/guestfish.pod:1245 ../src/guestfs.pod:3884 msgid "LIBGUESTFS_APPEND" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1247 ../src/guestfs.pod:3851 +#: ../fish/guestfish.pod:1247 ../src/guestfs.pod:3886 msgid "Pass additional options to the guest kernel." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1249 ../src/guestfs.pod:3853 +#: ../fish/guestfish.pod:1249 ../src/guestfs.pod:3888 msgid "LIBGUESTFS_ATTACH_METHOD" msgstr "" @@ -26641,7 +26641,7 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1254 ../src/guestfs.pod:3858 +#: ../fish/guestfish.pod:1254 ../src/guestfs.pod:3893 msgid "LIBGUESTFS_DEBUG" msgstr "" @@ -26653,17 +26653,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1259 ../src/guestfs.pod:3863 +#: ../fish/guestfish.pod:1259 ../src/guestfs.pod:3898 msgid "LIBGUESTFS_MEMSIZE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1261 ../src/guestfs.pod:3865 +#: ../fish/guestfish.pod:1261 ../src/guestfs.pod:3900 msgid "Set the memory allocated to the qemu process, in megabytes. For example:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1264 ../src/guestfs.pod:3868 +#: ../fish/guestfish.pod:1264 ../src/guestfs.pod:3903 #, no-wrap msgid "" " LIBGUESTFS_MEMSIZE=700\n" @@ -26671,7 +26671,7 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1266 ../src/guestfs.pod:3870 +#: ../fish/guestfish.pod:1266 ../src/guestfs.pod:3905 msgid "LIBGUESTFS_PATH" msgstr "" @@ -26683,19 +26683,19 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1271 ../src/guestfs.pod:3875 +#: ../fish/guestfish.pod:1271 ../src/guestfs.pod:3910 msgid "LIBGUESTFS_QEMU" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1273 ../src/guestfs.pod:3877 +#: ../fish/guestfish.pod:1273 ../src/guestfs.pod:3912 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:1277 ../src/guestfs.pod:3883 +#: ../fish/guestfish.pod:1277 ../src/guestfs.pod:3918 msgid "LIBGUESTFS_TRACE" msgstr "" @@ -26717,19 +26717,19 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1286 ../sparsify/virt-sparsify.pod:276 ../src/guestfs.pod:3888 +#: ../fish/guestfish.pod:1286 ../sparsify/virt-sparsify.pod:276 ../src/guestfs.pod:3923 msgid "TMPDIR" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1288 ../src/guestfs.pod:3890 +#: ../fish/guestfish.pod:1288 ../src/guestfs.pod:3925 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:1291 ../src/guestfs.pod:3893 +#: ../fish/guestfish.pod:1291 ../src/guestfs.pod:3928 msgid "" "If libguestfs was compiled to use the supermin appliance then the real " "appliance is cached in this directory, shared between all handles belonging " @@ -54971,30 +54971,105 @@ msgstr "" #. type: =head2 #: ../src/guestfs.pod:3270 -msgid "ADDING A NEW API ACTION" +msgid "C<local*> FILES" msgstr "" #. type: textblock #: ../src/guestfs.pod:3272 msgid "" +"Files in the top source directory that begin with the prefix C<local*> are " +"ignored by git. These files can contain local configuration or scripts that " +"you need to build libguestfs." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:3276 +msgid "" +"By convention, I have a file called C<localconfigure> which is a simple " +"wrapper around C<autogen.sh> containing local configure customizations that " +"I need:" +msgstr "" + +#. type: verbatim +#: ../src/guestfs.pod:3280 +#, no-wrap +msgid "" +" . localenv\n" +" ./autogen.sh \\\n" +" --with-default-attach-method=libvirt \\\n" +" --enable-gcc-warnings \\\n" +" --enable-gtk-doc \\\n" +" -C \\\n" +" \"$@\"\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:3288 +msgid "So I can use this to build libguestfs:" +msgstr "" + +#. type: verbatim +#: ../src/guestfs.pod:3290 +#, no-wrap +msgid "" +" ./localconfigure && make\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:3292 +msgid "" +"If there is a file in the top build directory called C<localenv>, then it " +"will be sourced by C<make>. This file can contain any local environment " +"variables needed, eg. for skipping tests:" +msgstr "" + +#. type: verbatim +#: ../src/guestfs.pod:3296 +#, no-wrap +msgid "" +" # Use an alternate python binary.\n" +" export PYTHON=python3\n" +" # Skip this test, it is broken.\n" +" export SKIP_TEST_BTRFS_FSCK=1\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:3301 +msgid "" +"Note that C<localenv> is included by the top Makefile (so it's a Makefile " +"fragment). But if it is also sourced by your C<localconfigure> script then " +"it is used as a shell script." +msgstr "" + +#. type: =head2 +#: ../src/guestfs.pod:3305 +msgid "ADDING A NEW API ACTION" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:3307 +msgid "" "Because large amounts of boilerplate code in libguestfs are generated, this " "makes it easy to extend the libguestfs API." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3275 +#: ../src/guestfs.pod:3310 msgid "To add a new API action there are two changes:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3281 +#: ../src/guestfs.pod:3316 msgid "" "You need to add a description of the call (name, parameters, return type, " "tests, documentation) to C<generator/actions.ml>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3284 +#: ../src/guestfs.pod:3319 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 " @@ -55005,7 +55080,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3292 +#: ../src/guestfs.pod:3327 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 " @@ -55015,7 +55090,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3298 +#: ../src/guestfs.pod:3333 msgid "" "For library-only actions of the second type, add to the " "C<non_daemon_functions> list. Since these functions are serviced by the " @@ -55025,36 +55100,36 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3306 +#: ../src/guestfs.pod:3341 msgid "Implement the action (in C):" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3308 +#: ../src/guestfs.pod:3343 msgid "" "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the " "C<daemon/> directory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3311 +#: ../src/guestfs.pod:3346 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:3314 +#: ../src/guestfs.pod:3349 msgid "In either case, use another function as an example of what to do." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3318 +#: ../src/guestfs.pod:3353 msgid "After making these changes, use C<make> to compile." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3320 +#: ../src/guestfs.pod:3355 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 " @@ -55062,12 +55137,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3324 +#: ../src/guestfs.pod:3359 msgid "ADDING TESTS FOR AN API ACTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3326 +#: ../src/guestfs.pod:3361 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 " @@ -55077,61 +55152,61 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3332 +#: ../src/guestfs.pod:3367 msgid "" "The following describes the test environment used when you add an API test " "in C<actions.ml>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3335 +#: ../src/guestfs.pod:3370 msgid "The test environment has 4 block devices:" msgstr "" #. type: =item -#: ../src/guestfs.pod:3339 +#: ../src/guestfs.pod:3374 msgid "C</dev/sda> 500MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3341 +#: ../src/guestfs.pod:3376 msgid "General block device for testing." msgstr "" #. type: =item -#: ../src/guestfs.pod:3343 +#: ../src/guestfs.pod:3378 msgid "C</dev/sdb> 50MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3345 +#: ../src/guestfs.pod:3380 msgid "" "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write " "operations." msgstr "" #. type: =item -#: ../src/guestfs.pod:3348 +#: ../src/guestfs.pod:3383 msgid "C</dev/sdc> 10MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3350 +#: ../src/guestfs.pod:3385 msgid "Used in a few tests where two block devices are needed." msgstr "" #. type: =item -#: ../src/guestfs.pod:3352 +#: ../src/guestfs.pod:3387 msgid "C</dev/sdd>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3354 +#: ../src/guestfs.pod:3389 msgid "ISO with fixed content (see C<images/test.iso>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3358 +#: ../src/guestfs.pod:3393 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 " @@ -55139,7 +55214,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3362 +#: ../src/guestfs.pod:3397 msgid "" "Each test starts with an initial scenario, selected using one of the " "C<Init*> expressions, described in C<generator/types.ml>. These initialize " @@ -55149,7 +55224,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3368 +#: ../src/guestfs.pod:3403 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 " @@ -55159,14 +55234,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3374 +#: ../src/guestfs.pod:3409 msgid "" "In addition, packagers can skip individual tests by setting environment " "variables before running C<make check>." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3377 +#: ../src/guestfs.pod:3412 #, no-wrap msgid "" " SKIP_TEST_<CMD>_<NUM>=1\n" @@ -55174,12 +55249,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3379 +#: ../src/guestfs.pod:3414 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3383 +#: ../src/guestfs.pod:3418 #, no-wrap msgid "" " SKIP_TEST_<CMD>=1\n" @@ -55187,17 +55262,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3385 +#: ../src/guestfs.pod:3420 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3387 +#: ../src/guestfs.pod:3422 msgid "Packagers can run only certain tests by setting for example:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3389 +#: ../src/guestfs.pod:3424 #, no-wrap msgid "" " TEST_ONLY=\"vfs_type zerofree\"\n" @@ -55205,29 +55280,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3391 +#: ../src/guestfs.pod:3426 msgid "" "See C<tests/c-api/tests.c> for more details of how these environment " "variables work." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3394 +#: ../src/guestfs.pod:3429 msgid "DEBUGGING NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3396 +#: ../src/guestfs.pod:3431 msgid "Test new actions work before submitting them." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3398 +#: ../src/guestfs.pod:3433 msgid "You can use guestfish to try out new commands." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3400 +#: ../src/guestfs.pod:3435 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 " @@ -55235,12 +55310,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3404 +#: ../src/guestfs.pod:3439 msgid "FORMATTING CODE AND OTHER CONVENTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3406 +#: ../src/guestfs.pod:3441 msgid "" "Our C source code generally adheres to some basic code-formatting " "conventions. The existing code base is not totally consistent on this " @@ -55250,14 +55325,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3412 +#: ../src/guestfs.pod:3447 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:3415 +#: ../src/guestfs.pod:3450 #, no-wrap msgid "" " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n" @@ -55273,7 +55348,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3425 +#: ../src/guestfs.pod:3460 #, no-wrap msgid "" " ;;; When editing C sources in libguestfs, use this style.\n" @@ -55291,12 +55366,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3437 +#: ../src/guestfs.pod:3472 msgid "Enable warnings when compiling (and fix any problems this finds):" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3440 +#: ../src/guestfs.pod:3475 #, no-wrap msgid "" " ./configure --enable-gcc-warnings\n" @@ -55304,12 +55379,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3442 +#: ../src/guestfs.pod:3477 msgid "Useful targets are:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3444 +#: ../src/guestfs.pod:3479 #, no-wrap msgid "" " make syntax-check -j1 -k # checks for various syntax and\n" @@ -55318,7 +55393,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3447 +#: ../src/guestfs.pod:3482 #, no-wrap msgid "" " make check # runs the test suite\n" @@ -55326,7 +55401,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3449 +#: ../src/guestfs.pod:3484 #, no-wrap msgid "" " make extra-tests # in-depth testing using valgrind\n" @@ -55335,43 +55410,43 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3452 +#: ../src/guestfs.pod:3487 msgid "DAEMON CUSTOM PRINTF FORMATTERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3454 +#: ../src/guestfs.pod:3489 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:3459 +#: ../src/guestfs.pod:3494 msgid "%Q" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3461 +#: ../src/guestfs.pod:3496 msgid "" "Simple shell quoted string. Any spaces or other shell characters are " "escaped for you." msgstr "" #. type: =item -#: ../src/guestfs.pod:3464 +#: ../src/guestfs.pod:3499 msgid "%R" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3466 +#: ../src/guestfs.pod:3501 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:3473 +#: ../src/guestfs.pod:3508 #, no-wrap msgid "" " asprintf (&cmd, \"cat %R\", path);\n" @@ -55379,12 +55454,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3475 +#: ../src/guestfs.pod:3510 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3477 +#: ../src/guestfs.pod:3512 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 " @@ -55393,12 +55468,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3483 +#: ../src/guestfs.pod:3518 msgid "SUBMITTING YOUR NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3485 +#: ../src/guestfs.pod:3520 msgid "" "Submit patches to the mailing list: " "L<http://www.redhat.com/mailman/listinfo/libguestfs> and CC to " @@ -55406,17 +55481,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3489 +#: ../src/guestfs.pod:3524 msgid "INTERNATIONALIZATION (I18N) SUPPORT" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3491 +#: ../src/guestfs.pod:3526 msgid "We support i18n (gettext anyhow) in the library." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3493 +#: ../src/guestfs.pod:3528 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 " @@ -55425,113 +55500,113 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3499 +#: ../src/guestfs.pod:3534 msgid "" "Debugging messages are never translated, since they are intended for the " "programmers." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3502 +#: ../src/guestfs.pod:3537 msgid "SOURCE CODE SUBDIRECTORIES" msgstr "" #. type: =item -#: ../src/guestfs.pod:3506 +#: ../src/guestfs.pod:3541 msgid "C<align>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3508 +#: ../src/guestfs.pod:3543 msgid "L<virt-alignment-scan(1)> command and documentation." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3512 +#: ../src/guestfs.pod:3547 msgid "The libguestfs appliance, build scripts and so on." msgstr "" #. type: =item -#: ../src/guestfs.pod:3514 +#: ../src/guestfs.pod:3549 msgid "C<build-aux>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3516 +#: ../src/guestfs.pod:3551 msgid "Various build scripts used by autotools." msgstr "" #. type: =item -#: ../src/guestfs.pod:3518 +#: ../src/guestfs.pod:3553 msgid "C<cat>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3520 +#: ../src/guestfs.pod:3555 msgid "" "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and " "documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3523 +#: ../src/guestfs.pod:3558 msgid "C<contrib>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3525 +#: ../src/guestfs.pod:3560 msgid "Outside contributions, experimental parts." msgstr "" #. type: =item -#: ../src/guestfs.pod:3527 +#: ../src/guestfs.pod:3562 msgid "C<daemon>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3529 +#: ../src/guestfs.pod:3564 msgid "" "The daemon that runs inside the libguestfs appliance and carries out " "actions." msgstr "" #. type: =item -#: ../src/guestfs.pod:3532 +#: ../src/guestfs.pod:3567 msgid "C<df>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3534 +#: ../src/guestfs.pod:3569 msgid "L<virt-df(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3536 +#: ../src/guestfs.pod:3571 msgid "C<edit>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3538 +#: ../src/guestfs.pod:3573 msgid "L<virt-edit(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3540 +#: ../src/guestfs.pod:3575 msgid "C<examples>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3542 +#: ../src/guestfs.pod:3577 msgid "C API example code." msgstr "" #. type: =item -#: ../src/guestfs.pod:3544 +#: ../src/guestfs.pod:3579 msgid "C<fish>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3546 +#: ../src/guestfs.pod:3581 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)>, " @@ -55539,101 +55614,101 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3552 +#: ../src/guestfs.pod:3587 msgid "L<virt-format(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3554 +#: ../src/guestfs.pod:3589 msgid "C<fuse>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3556 +#: ../src/guestfs.pod:3591 msgid "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:3558 +#: ../src/guestfs.pod:3593 msgid "C<generator>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3560 +#: ../src/guestfs.pod:3595 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:3563 +#: ../src/guestfs.pod:3598 msgid "C<gnulib>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3565 +#: ../src/guestfs.pod:3600 msgid "" "Gnulib is used as a portability library. A copy of gnulib is included under " "here." msgstr "" #. type: =item -#: ../src/guestfs.pod:3568 +#: ../src/guestfs.pod:3603 msgid "C<html>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3570 +#: ../src/guestfs.pod:3605 msgid "Generated HTML manual pages." msgstr "" #. type: =item -#: ../src/guestfs.pod:3572 +#: ../src/guestfs.pod:3607 msgid "C<inspector>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3574 +#: ../src/guestfs.pod:3609 msgid "L<virt-inspector(1)>, the virtual machine image inspector." msgstr "" #. type: =item -#: ../src/guestfs.pod:3576 +#: ../src/guestfs.pod:3611 msgid "C<logo>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3578 +#: ../src/guestfs.pod:3613 msgid "Logo used on the website. The fish is called Arthur by the way." msgstr "" #. type: =item -#: ../src/guestfs.pod:3580 +#: ../src/guestfs.pod:3615 msgid "C<m4>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3582 +#: ../src/guestfs.pod:3617 msgid "M4 macros used by autoconf." msgstr "" #. type: =item -#: ../src/guestfs.pod:3584 +#: ../src/guestfs.pod:3619 msgid "C<po>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3586 +#: ../src/guestfs.pod:3621 msgid "Translations of simple gettext strings." msgstr "" #. type: =item -#: ../src/guestfs.pod:3588 +#: ../src/guestfs.pod:3623 msgid "C<po-docs>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3590 +#: ../src/guestfs.pod:3625 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 " @@ -55641,84 +55716,84 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:3594 +#: ../src/guestfs.pod:3629 msgid "C<rescue>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3596 +#: ../src/guestfs.pod:3631 msgid "L<virt-rescue(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3598 +#: ../src/guestfs.pod:3633 msgid "C<resize>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3600 +#: ../src/guestfs.pod:3635 msgid "L<virt-resize(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3602 +#: ../src/guestfs.pod:3637 msgid "C<sparsify>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3604 +#: ../src/guestfs.pod:3639 msgid "L<virt-sparsify(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3606 +#: ../src/guestfs.pod:3641 msgid "C<src>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3608 +#: ../src/guestfs.pod:3643 msgid "Source code to the C library." msgstr "" #. type: =item -#: ../src/guestfs.pod:3610 +#: ../src/guestfs.pod:3645 msgid "C<sysprep>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3612 +#: ../src/guestfs.pod:3647 msgid "L<virt-sysprep(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3614 +#: ../src/guestfs.pod:3649 msgid "C<tests>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3616 +#: ../src/guestfs.pod:3651 msgid "Tests." msgstr "" #. type: =item -#: ../src/guestfs.pod:3618 +#: ../src/guestfs.pod:3653 msgid "C<test-tool>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3620 +#: ../src/guestfs.pod:3655 msgid "" "Test tool for end users to test if their qemu/kernel combination will work " "with libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:3623 +#: ../src/guestfs.pod:3658 msgid "C<tmp>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3625 +#: ../src/guestfs.pod:3660 msgid "" "Used for temporary files when running the tests (instead of C</tmp> etc). " "The reason is so that you can run multiple parallel tests of libguestfs " @@ -55727,77 +55802,77 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:3630 +#: ../src/guestfs.pod:3665 msgid "C<tools>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3632 +#: ../src/guestfs.pod:3667 msgid "Command line tools written in Perl (L<virt-win-reg(1)> and many others)." msgstr "" #. type: =item -#: ../src/guestfs.pod:3634 +#: ../src/guestfs.pod:3669 msgid "C<csharp>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3636 +#: ../src/guestfs.pod:3671 msgid "C<erlang>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3638 +#: ../src/guestfs.pod:3673 msgid "C<gobject>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3640 +#: ../src/guestfs.pod:3675 msgid "C<haskell>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3642 +#: ../src/guestfs.pod:3677 msgid "C<java>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3644 +#: ../src/guestfs.pod:3679 msgid "C<ocaml>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3646 +#: ../src/guestfs.pod:3681 msgid "C<php>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3648 +#: ../src/guestfs.pod:3683 msgid "C<perl>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3650 +#: ../src/guestfs.pod:3685 msgid "C<python>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3652 +#: ../src/guestfs.pod:3687 msgid "C<ruby>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3654 +#: ../src/guestfs.pod:3689 msgid "Language bindings." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3658 +#: ../src/guestfs.pod:3693 msgid "MAKING A STABLE RELEASE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3660 +#: ../src/guestfs.pod:3695 msgid "" "When we make a stable release, there are several steps documented here. See " "L</LIBGUESTFS VERSION NUMBERS> for general information about the stable " @@ -55805,32 +55880,32 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3668 +#: ../src/guestfs.pod:3703 msgid "Check C<make && make check> works on at least Fedora, Debian and Ubuntu." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3673 +#: ../src/guestfs.pod:3708 msgid "Finalize C<guestfs-release-notes.pod>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3677 +#: ../src/guestfs.pod:3712 msgid "Update ROADMAP." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3681 +#: ../src/guestfs.pod:3716 msgid "Run C<src/api-support/update-from-tarballs.sh>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3685 +#: ../src/guestfs.pod:3720 msgid "Push and pull from Transifex." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3689 +#: ../src/guestfs.pod:3724 #, no-wrap msgid "" " tx push -s\n" @@ -55838,12 +55913,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3691 +#: ../src/guestfs.pod:3726 msgid "to push the latest POT files to Transifex. Then run:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3693 +#: ../src/guestfs.pod:3728 #, no-wrap msgid "" " ./tx-pull.sh\n" @@ -55851,24 +55926,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3695 +#: ../src/guestfs.pod:3730 msgid "which is a wrapper to pull the latest translated C<*.po> files." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3699 +#: ../src/guestfs.pod:3734 msgid "" "Create new stable and development directories under " "L<http://libguestfs.org/download>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3704 +#: ../src/guestfs.pod:3739 msgid "Create the branch in git:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3706 +#: ../src/guestfs.pod:3741 #, no-wrap msgid "" " git tag -a 1.XX.0 -m \"Version 1.XX.0 (stable)\"\n" @@ -55879,17 +55954,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:3713 +#: ../src/guestfs.pod:3748 msgid "LIMITS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3715 +#: ../src/guestfs.pod:3750 msgid "PROTOCOL LIMITS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3717 +#: ../src/guestfs.pod:3752 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 " @@ -55900,7 +55975,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3725 +#: ../src/guestfs.pod:3760 msgid "" "In libguestfs E<lt> 1.19.32, several calls had to encode either their entire " "argument list or their entire return value (or sometimes both) in a single " @@ -55916,7 +55991,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3738 +#: ../src/guestfs.pod:3773 msgid "" "L</guestfs_cat>, L</guestfs_find>, L</guestfs_read_file>, " "L</guestfs_read_lines>, L</guestfs_write>, L</guestfs_write_append>, " @@ -55925,19 +56000,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3743 +#: ../src/guestfs.pod:3778 msgid "" "See also L</UPLOADING> and L</DOWNLOADING> for further information about " "copying large amounts of data into or out of a filesystem." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3746 +#: ../src/guestfs.pod:3781 msgid "MAXIMUM NUMBER OF DISKS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3748 +#: ../src/guestfs.pod:3783 msgid "" "In libguestfs E<ge> 1.19.7, you can query the maximum number of disks that " "may be added by calling L</guestfs_max_disks>. In earlier versions of " @@ -55946,14 +56021,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3753 +#: ../src/guestfs.pod:3788 msgid "" "The rest of this section covers implementation details, which could change " "in future." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3756 +#: ../src/guestfs.pod:3791 msgid "" "When using virtio-scsi disks (the default if available in qemu) the current " "limit is B<255> disks. When using virtio-blk (the old default) the limit is " @@ -55962,26 +56037,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3761 +#: ../src/guestfs.pod:3796 msgid "" "Virtio-scsi as used by libguestfs is configured to use one target per disk, " "and 256 targets are available." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3764 +#: ../src/guestfs.pod:3799 msgid "" "Virtio-blk consumes 1 virtual PCI slot per disk, and PCI is limited to 31 " "slots, but some of these are used for other purposes." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3767 +#: ../src/guestfs.pod:3802 msgid "One virtual disk is used by libguestfs internally." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3769 +#: ../src/guestfs.pod:3804 msgid "" "Before libguestfs 1.19.7, disk names had to be a single character " "(eg. C</dev/sda> through C</dev/sdz>), and since one disk is reserved, that " @@ -55989,48 +56064,48 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3774 +#: ../src/guestfs.pod:3809 msgid "" "In libguestfs E<ge> 1.20 it is possible to hot plug disks. See " "L</HOTPLUGGING>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3777 +#: ../src/guestfs.pod:3812 msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3779 +#: ../src/guestfs.pod:3814 msgid "Virtio limits the maximum number of partitions per disk to B<15>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3781 +#: ../src/guestfs.pod:3816 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:3784 +#: ../src/guestfs.pod:3819 msgid "" "If you attach a disk with more than 15 partitions, the extra partitions are " "ignored by libguestfs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3787 +#: ../src/guestfs.pod:3822 msgid "MAXIMUM SIZE OF A DISK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3789 +#: ../src/guestfs.pod:3824 msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3791 +#: ../src/guestfs.pod:3826 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 " @@ -56038,7 +56113,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3795 +#: ../src/guestfs.pod:3830 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 " @@ -56048,19 +56123,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3801 +#: ../src/guestfs.pod:3836 msgid "" "For the hugest disk image files, we recommend using XFS on the host for " "storage." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3804 +#: ../src/guestfs.pod:3839 msgid "MAXIMUM SIZE OF A PARTITION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3806 +#: ../src/guestfs.pod:3841 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 " @@ -56068,7 +56143,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3810 +#: ../src/guestfs.pod:3845 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 " @@ -56076,12 +56151,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3815 +#: ../src/guestfs.pod:3850 msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3817 +#: ../src/guestfs.pod:3852 msgid "" "This depends on the filesystem type. libguestfs itself does not impose any " "known limit. Consult Wikipedia or the filesystem documentation to find out " @@ -56089,12 +56164,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3821 +#: ../src/guestfs.pod:3856 msgid "MAXIMUM UPLOAD AND DOWNLOAD" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3823 +#: ../src/guestfs.pod:3858 msgid "" "The API functions L</guestfs_upload>, L</guestfs_download>, " "L</guestfs_tar_in>, L</guestfs_tar_out> and the like allow unlimited sized " @@ -56102,12 +56177,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3827 +#: ../src/guestfs.pod:3862 msgid "INSPECTION LIMITS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3829 +#: ../src/guestfs.pod:3864 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 " @@ -56117,40 +56192,40 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3855 +#: ../src/guestfs.pod:3890 msgid "" "Choose the default way to create the appliance. See " "L</guestfs_set_attach_method>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3860 +#: ../src/guestfs.pod:3895 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:3872 +#: ../src/guestfs.pod:3907 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:3881 +#: ../src/guestfs.pod:3916 msgid "See also L</QEMU WRAPPERS> above." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3885 +#: ../src/guestfs.pod:3920 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:3903 +#: ../src/guestfs.pod:3938 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)>, " @@ -56169,7 +56244,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3946 +#: ../src/guestfs.pod:3981 msgid "" "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, " "L<lvm(8)>, L<disktype(1)>." @@ -56442,7 +56517,9 @@ msgid "" " /root/anaconda-ks.cfg\n" " /root/install.log\n" " /root/install.log.syslog\n" +" /var/cache/fontconfig/*\n" " /var/cache/gdm/*\n" +" /var/cache/man/*\n" " /var/lib/AccountService/users/*\n" " /var/lib/fprint/*\n" " /var/lib/logrotate.status\n" @@ -56483,34 +56560,34 @@ msgid "" msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:134 +#: ../sysprep/sysprep-operations.pod:136 msgid "B<lvm-uuids> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:137 +#: ../sysprep/sysprep-operations.pod:139 msgid "Change LVM2 PV and VG UUIDs." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:139 +#: ../sysprep/sysprep-operations.pod:141 msgid "" "On Linux guests that have LVM2 physical volumes (PVs) or volume groups " "(VGs), new random UUIDs are generated and assigned to those PVs and VGs." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:142 +#: ../sysprep/sysprep-operations.pod:144 msgid "B<machine-id> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:145 +#: ../sysprep/sysprep-operations.pod:147 msgid "Remove the local machine ID." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:147 +#: ../sysprep/sysprep-operations.pod:149 msgid "" "The machine ID is usually generated from a random source during system " "installation and stays constant for all subsequent boots. Optionally, for " @@ -56519,150 +56596,150 @@ msgid "" msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:152 +#: ../sysprep/sysprep-operations.pod:154 msgid "B<mail-spool> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:155 +#: ../sysprep/sysprep-operations.pod:157 msgid "Remove email from the local mail spool directory." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:157 +#: ../sysprep/sysprep-operations.pod:159 msgid "B<net-hostname> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:160 +#: ../sysprep/sysprep-operations.pod:162 msgid "Remove HOSTNAME in network interface configuration." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:162 ../sysprep/sysprep-operations.pod:170 +#: ../sysprep/sysprep-operations.pod:164 ../sysprep/sysprep-operations.pod:172 msgid "" "For Fedora and Red Hat Enterprise Linux, this is removed from C<ifcfg-*> " "files." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:165 +#: ../sysprep/sysprep-operations.pod:167 msgid "B<net-hwaddr> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:168 +#: ../sysprep/sysprep-operations.pod:170 msgid "Remove HWADDR (hard-coded MAC address) configuration." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:173 +#: ../sysprep/sysprep-operations.pod:175 msgid "B<pacct-log> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:176 +#: ../sysprep/sysprep-operations.pod:178 msgid "Remove the process accounting log files." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:178 +#: ../sysprep/sysprep-operations.pod:180 msgid "" "The system wide process accounting will store to the pacct log files if the " "process accounting is on." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:181 +#: ../sysprep/sysprep-operations.pod:183 msgid "B<package-manager-cache> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:184 +#: ../sysprep/sysprep-operations.pod:186 msgid "Remove package manager cache." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:186 +#: ../sysprep/sysprep-operations.pod:188 msgid "B<pam-data> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:189 +#: ../sysprep/sysprep-operations.pod:191 msgid "Remove the PAM data in the guest." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:191 +#: ../sysprep/sysprep-operations.pod:193 msgid "B<puppet-data-log> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:194 +#: ../sysprep/sysprep-operations.pod:196 msgid "Remove the data and log files of puppet." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:196 +#: ../sysprep/sysprep-operations.pod:198 msgid "B<random-seed> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:199 +#: ../sysprep/sysprep-operations.pod:201 msgid "Generate random seed for guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:201 +#: ../sysprep/sysprep-operations.pod:203 msgid "" "Write some random bytes from the host into the random seed file of the " "guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:204 +#: ../sysprep/sysprep-operations.pod:206 msgid "See L</RANDOM SEED> below." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:206 +#: ../sysprep/sysprep-operations.pod:208 msgid "B<rhn-systemid> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:209 +#: ../sysprep/sysprep-operations.pod:211 msgid "Remove the RHN system ID." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:211 +#: ../sysprep/sysprep-operations.pod:213 msgid "B<samba-db-log> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:214 +#: ../sysprep/sysprep-operations.pod:216 msgid "Remove the database and log files of Samba." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:216 +#: ../sysprep/sysprep-operations.pod:218 msgid "B<script> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:219 +#: ../sysprep/sysprep-operations.pod:221 msgid "Run arbitrary scripts against the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:221 +#: ../sysprep/sysprep-operations.pod:223 msgid "" "The C<script> module lets you run arbitrary shell scripts or programs " "against the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:224 +#: ../sysprep/sysprep-operations.pod:226 msgid "" "Note this feature requires FUSE support. You may have to enable this in " "your host, for example by adding the current user to the C<fuse> group, or " @@ -56670,14 +56747,14 @@ msgid "" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:228 +#: ../sysprep/sysprep-operations.pod:230 msgid "" "Use one or more I<--script> parameters to specify scripts or programs that " "will be run against the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:231 +#: ../sysprep/sysprep-operations.pod:233 msgid "" "The script or program is run with its current directory being the guest's " "root directory, so relative paths should be used. For example: C<rm " @@ -56687,14 +56764,14 @@ msgid "" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:237 +#: ../sysprep/sysprep-operations.pod:239 msgid "" "Normally a temporary mount point for the guest is used, but you can choose a " "specific one by using the I<--scriptdir> parameter." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:240 +#: ../sysprep/sysprep-operations.pod:242 msgid "" "B<Note:> This is different from I<--firstboot> scripts (which run in the " "context of the guest when it is booting first time). I<--script> scripts " @@ -56702,41 +56779,41 @@ msgid "" msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:244 +#: ../sysprep/sysprep-operations.pod:246 msgid "B<smolt-uuid> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:247 +#: ../sysprep/sysprep-operations.pod:249 msgid "Remove the Smolt hardware UUID." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:249 +#: ../sysprep/sysprep-operations.pod:251 msgid "B<ssh-hostkeys> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:252 +#: ../sysprep/sysprep-operations.pod:254 msgid "Remove the SSH host keys in the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:254 +#: ../sysprep/sysprep-operations.pod:256 msgid "" "The SSH host keys are regenerated (differently) next time the guest is " "booted." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:257 +#: ../sysprep/sysprep-operations.pod:259 msgid "" "If, after cloning, the guest gets the same IP address, ssh will give you a " "stark warning about the host key changing:" msgstr "" #. type: verbatim -#: ../sysprep/sysprep-operations.pod:260 +#: ../sysprep/sysprep-operations.pod:262 #, no-wrap msgid "" " @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n" @@ -56747,51 +56824,51 @@ msgid "" msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:265 +#: ../sysprep/sysprep-operations.pod:267 msgid "B<ssh-userdir> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:268 +#: ../sysprep/sysprep-operations.pod:270 msgid "Remove \".ssh\" directories in the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:270 +#: ../sysprep/sysprep-operations.pod:272 msgid "" "Remove the C<.ssh> directory of user \"root\" and any other users who have a " "C<.ssh> directory in their home directory." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:273 +#: ../sysprep/sysprep-operations.pod:275 msgid "B<sssd-db-log> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:276 +#: ../sysprep/sysprep-operations.pod:278 msgid "Remove the database and log files of sssd." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:278 +#: ../sysprep/sysprep-operations.pod:280 msgid "B<udev-persistent-net> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:281 +#: ../sysprep/sysprep-operations.pod:283 msgid "Remove udev persistent net rules." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:283 +#: ../sysprep/sysprep-operations.pod:285 msgid "" "Remove udev persistent net rules which map the guest's existing MAC address " "to a fixed ethernet device (eg. eth0)." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:286 +#: ../sysprep/sysprep-operations.pod:288 msgid "" "After a guest is cloned, the MAC address usually changes. Since the old MAC " "address occupies the old name (eg. eth0), this means the fresh MAC address " @@ -56800,34 +56877,34 @@ msgid "" msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:291 +#: ../sysprep/sysprep-operations.pod:293 msgid "B<user-account>" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:293 +#: ../sysprep/sysprep-operations.pod:295 msgid "Remove the user accounts in the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:295 +#: ../sysprep/sysprep-operations.pod:297 msgid "" "Remove all the user accounts and their home directories. The \"root\" " "account is not removed." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:298 +#: ../sysprep/sysprep-operations.pod:300 msgid "B<utmp> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:301 +#: ../sysprep/sysprep-operations.pod:303 msgid "Remove the utmp file." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:303 +#: ../sysprep/sysprep-operations.pod:305 msgid "" "This file records who is currently logged in on a machine. In modern Linux " "distros it is stored in a ramdisk and hence not part of the virtual " @@ -56835,17 +56912,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:307 +#: ../sysprep/sysprep-operations.pod:309 msgid "B<yum-uuid> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:310 +#: ../sysprep/sysprep-operations.pod:312 msgid "Remove the yum UUID." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:312 +#: ../sysprep/sysprep-operations.pod:314 msgid "" "Yum creates a fresh UUID the next time it runs when it notices that the " "original UUID has been erased." |