X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=po-docs%2Flibguestfs-docs.pot;h=9e70a9aec93582bb7437fda2b146f3e8baa82da1;hp=ad8f5a4c1debbcadcc807648abf009d17a0bce66;hb=54ea124b160eda705c96dfc664b4056848887856;hpb=0b7de697a4273dbcce175085aef45ef62e964fcc diff --git a/po-docs/libguestfs-docs.pot b/po-docs/libguestfs-docs.pot index ad8f5a4..9e70a9a 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.12.0\n" +"Project-Id-Version: libguestfs 1.13.3\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2011-07-20 17:31+0200\n" +"POT-Creation-Date: 2011-08-07 23:15+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -248,17 +248,17 @@ msgid "" msgstr "" #. type: =item -#: ../cat/virt-cat.pod:91 ../cat/virt-filesystems.pod:141 ../cat/virt-ls.pod:307 ../df/virt-df.pod:88 ../edit/virt-edit.pod:105 ../inspector/virt-inspector.pod:85 ../rescue/virt-rescue.pod:117 +#: ../cat/virt-cat.pod:91 ../cat/virt-filesystems.pod:141 ../cat/virt-ls.pod:307 ../df/virt-df.pod:94 ../edit/virt-edit.pod:105 ../inspector/virt-inspector.pod:85 ../rescue/virt-rescue.pod:117 msgid "B<-d> guest" msgstr "" #. type: =item -#: ../cat/virt-cat.pod:93 ../cat/virt-filesystems.pod:143 ../cat/virt-ls.pod:309 ../df/virt-df.pod:90 ../edit/virt-edit.pod:107 ../inspector/virt-inspector.pod:87 ../rescue/virt-rescue.pod:119 +#: ../cat/virt-cat.pod:93 ../cat/virt-filesystems.pod:143 ../cat/virt-ls.pod:309 ../df/virt-df.pod:96 ../edit/virt-edit.pod:107 ../inspector/virt-inspector.pod:87 ../rescue/virt-rescue.pod:119 msgid "B<--domain> guest" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:95 ../cat/virt-filesystems.pod:145 ../cat/virt-ls.pod:311 ../df/virt-df.pod:92 ../edit/virt-edit.pod:109 ../inspector/virt-inspector.pod:89 ../rescue/virt-rescue.pod:121 +#: ../cat/virt-cat.pod:95 ../cat/virt-filesystems.pod:145 ../cat/virt-ls.pod:311 ../df/virt-df.pod:98 ../edit/virt-edit.pod:109 ../inspector/virt-inspector.pod:89 ../rescue/virt-rescue.pod:121 msgid "" "Add all the disks from the named libvirt guest. Domain UUIDs can be used " "instead of names." @@ -279,17 +279,17 @@ msgid "" msgstr "" #. type: =item -#: ../cat/virt-cat.pod:105 ../cat/virt-filesystems.pod:170 ../cat/virt-ls.pod:328 ../df/virt-df.pod:95 ../fish/guestfish.pod:233 ../fuse/guestmount.pod:133 ../inspector/virt-inspector.pod:99 ../rescue/virt-rescue.pod:124 +#: ../cat/virt-cat.pod:105 ../cat/virt-filesystems.pod:170 ../cat/virt-ls.pod:328 ../df/virt-df.pod:101 ../fish/guestfish.pod:233 ../fuse/guestmount.pod:133 ../inspector/virt-inspector.pod:99 ../rescue/virt-rescue.pod:124 msgid "B<--format=raw|qcow2|..>" msgstr "" #. type: =item -#: ../cat/virt-cat.pod:107 ../cat/virt-filesystems.pod:172 ../cat/virt-ls.pod:330 ../df/virt-df.pod:97 ../edit/virt-edit.pod:134 ../fish/guestfish.pod:235 ../fuse/guestmount.pod:135 ../inspector/virt-inspector.pod:101 ../rescue/virt-rescue.pod:126 +#: ../cat/virt-cat.pod:107 ../cat/virt-filesystems.pod:172 ../cat/virt-ls.pod:330 ../df/virt-df.pod:103 ../edit/virt-edit.pod:134 ../fish/guestfish.pod:235 ../fuse/guestmount.pod:135 ../inspector/virt-inspector.pod:101 ../rescue/virt-rescue.pod:126 msgid "B<--format>" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:109 ../cat/virt-filesystems.pod:174 ../cat/virt-ls.pod:332 ../df/virt-df.pod:99 ../edit/virt-edit.pod:136 ../fish/guestfish.pod:237 ../fuse/guestmount.pod:137 ../rescue/virt-rescue.pod:128 +#: ../cat/virt-cat.pod:109 ../cat/virt-filesystems.pod:174 ../cat/virt-ls.pod:332 ../df/virt-df.pod:105 ../edit/virt-edit.pod:136 ../fish/guestfish.pod:237 ../fuse/guestmount.pod:137 ../rescue/virt-rescue.pod:128 msgid "" "The default for the I<-a> option is to auto-detect the format of the disk " "image. Using this forces the disk format for I<-a> options which follow on " @@ -298,7 +298,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337 ../df/virt-df.pod:104 ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242 ../fish/guestfish.pod:673 ../inspector/virt-inspector.pod:335 ../rescue/virt-rescue.pod:133 ../src/guestfs.pod:2652 +#: ../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:673 ../inspector/virt-inspector.pod:335 ../rescue/virt-rescue.pod:133 ../src/guestfs.pod:2653 msgid "For example:" msgstr "" @@ -311,7 +311,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:118 ../cat/virt-filesystems.pod:183 ../cat/virt-ls.pod:341 ../df/virt-df.pod:108 ../edit/virt-edit.pod:145 ../fish/guestfish.pod:246 ../rescue/virt-rescue.pod:137 +#: ../cat/virt-cat.pod:118 ../cat/virt-filesystems.pod:183 ../cat/virt-ls.pod:341 ../df/virt-df.pod:114 ../edit/virt-edit.pod:145 ../fish/guestfish.pod:246 ../rescue/virt-rescue.pod:137 msgid "forces raw format (no auto-detection) for C." msgstr "" @@ -324,14 +324,14 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:122 ../cat/virt-filesystems.pod:187 ../cat/virt-ls.pod:345 ../df/virt-df.pod:112 ../edit/virt-edit.pod:149 ../fish/guestfish.pod:250 ../rescue/virt-rescue.pod:141 +#: ../cat/virt-cat.pod:122 ../cat/virt-filesystems.pod:187 ../cat/virt-ls.pod:345 ../df/virt-df.pod:118 ../edit/virt-edit.pod:149 ../fish/guestfish.pod:250 ../rescue/virt-rescue.pod:141 msgid "" "forces raw format (no auto-detection) for C and reverts to " "auto-detection for C." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:125 ../cat/virt-filesystems.pod:190 ../cat/virt-ls.pod:348 ../df/virt-df.pod:115 ../edit/virt-edit.pod:152 ../rescue/virt-rescue.pod:144 +#: ../cat/virt-cat.pod:125 ../cat/virt-filesystems.pod:190 ../cat/virt-ls.pod:348 ../df/virt-df.pod:121 ../edit/virt-edit.pod:152 ../rescue/virt-rescue.pod:144 msgid "" "If you have untrusted raw-format guest disk images, you should use this " "option to specify the disk format. This avoids a possible security problem " @@ -351,42 +351,42 @@ msgid "" msgstr "" #. type: =item -#: ../cat/virt-cat.pod:134 ../cat/virt-filesystems.pod:261 ../cat/virt-ls.pod:425 ../df/virt-df.pod:167 ../edit/virt-edit.pod:161 ../fish/guestfish.pod:390 ../fuse/guestmount.pod:257 ../inspector/virt-inspector.pod:119 ../rescue/virt-rescue.pod:178 +#: ../cat/virt-cat.pod:134 ../cat/virt-filesystems.pod:261 ../cat/virt-ls.pod:425 ../df/virt-df.pod:173 ../edit/virt-edit.pod:161 ../fish/guestfish.pod:390 ../fuse/guestmount.pod:257 ../inspector/virt-inspector.pod:119 ../rescue/virt-rescue.pod:178 msgid "B<-v>" msgstr "" #. type: =item -#: ../cat/virt-cat.pod:136 ../cat/virt-filesystems.pod:263 ../cat/virt-ls.pod:427 ../df/virt-df.pod:169 ../edit/virt-edit.pod:163 ../fish/guestfish.pod:392 ../fuse/guestmount.pod:259 ../inspector/virt-inspector.pod:121 ../rescue/virt-rescue.pod:180 +#: ../cat/virt-cat.pod:136 ../cat/virt-filesystems.pod:263 ../cat/virt-ls.pod:427 ../df/virt-df.pod:175 ../edit/virt-edit.pod:163 ../fish/guestfish.pod:392 ../fuse/guestmount.pod:259 ../inspector/virt-inspector.pod:121 ../rescue/virt-rescue.pod:180 msgid "B<--verbose>" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:138 ../cat/virt-filesystems.pod:265 ../cat/virt-ls.pod:429 ../df/virt-df.pod:171 ../edit/virt-edit.pod:165 ../inspector/virt-inspector.pod:123 ../rescue/virt-rescue.pod:182 +#: ../cat/virt-cat.pod:138 ../cat/virt-filesystems.pod:265 ../cat/virt-ls.pod:429 ../df/virt-df.pod:177 ../edit/virt-edit.pod:165 ../inspector/virt-inspector.pod:123 ../rescue/virt-rescue.pod:182 msgid "Enable verbose messages for debugging." msgstr "" #. type: =item -#: ../cat/virt-cat.pod:140 ../cat/virt-filesystems.pod:267 ../cat/virt-ls.pod:431 ../df/virt-df.pod:173 ../edit/virt-edit.pod:167 ../fish/guestfish.pod:397 ../fuse/guestmount.pod:263 ../inspector/virt-inspector.pod:125 ../rescue/virt-rescue.pod:184 ../resize/virt-resize.pod:478 +#: ../cat/virt-cat.pod:140 ../cat/virt-filesystems.pod:267 ../cat/virt-ls.pod:431 ../df/virt-df.pod:179 ../edit/virt-edit.pod:167 ../fish/guestfish.pod:397 ../fuse/guestmount.pod:263 ../inspector/virt-inspector.pod:125 ../rescue/virt-rescue.pod:184 ../resize/virt-resize.pod:478 msgid "B<-V>" msgstr "" #. type: =item -#: ../cat/virt-cat.pod:142 ../cat/virt-filesystems.pod:269 ../cat/virt-ls.pod:433 ../df/virt-df.pod:175 ../edit/virt-edit.pod:169 ../fish/guestfish.pod:399 ../fuse/guestmount.pod:265 ../inspector/virt-inspector.pod:127 ../rescue/virt-rescue.pod:186 ../resize/virt-resize.pod:480 ../tools/virt-list-filesystems.pl:69 ../tools/virt-list-partitions.pl:70 ../tools/virt-make-fs.pl:169 ../tools/virt-tar.pl:119 ../tools/virt-win-reg.pl:112 +#: ../cat/virt-cat.pod:142 ../cat/virt-filesystems.pod:269 ../cat/virt-ls.pod:433 ../df/virt-df.pod:181 ../edit/virt-edit.pod:169 ../fish/guestfish.pod:399 ../fuse/guestmount.pod:265 ../inspector/virt-inspector.pod:127 ../rescue/virt-rescue.pod:186 ../resize/virt-resize.pod:480 ../tools/virt-list-filesystems.pl:69 ../tools/virt-list-partitions.pl:70 ../tools/virt-make-fs.pl:169 ../tools/virt-tar.pl:119 ../tools/virt-win-reg.pl:112 msgid "B<--version>" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:144 ../cat/virt-filesystems.pod:271 ../cat/virt-ls.pod:435 ../df/virt-df.pod:177 ../edit/virt-edit.pod:171 ../inspector/virt-inspector.pod:129 ../rescue/virt-rescue.pod:188 ../resize/virt-resize.pod:482 ../tools/virt-list-filesystems.pl:71 ../tools/virt-list-partitions.pl:72 ../tools/virt-make-fs.pl:171 ../tools/virt-tar.pl:121 ../tools/virt-win-reg.pl:114 +#: ../cat/virt-cat.pod:144 ../cat/virt-filesystems.pod:271 ../cat/virt-ls.pod:435 ../df/virt-df.pod:183 ../edit/virt-edit.pod:171 ../inspector/virt-inspector.pod:129 ../rescue/virt-rescue.pod:188 ../resize/virt-resize.pod:482 ../tools/virt-list-filesystems.pl:71 ../tools/virt-list-partitions.pl:72 ../tools/virt-make-fs.pl:171 ../tools/virt-tar.pl:121 ../tools/virt-win-reg.pl:114 msgid "Display version number and exit." msgstr "" #. type: =item -#: ../cat/virt-cat.pod:146 ../cat/virt-filesystems.pod:281 ../cat/virt-ls.pod:437 ../df/virt-df.pod:179 ../edit/virt-edit.pod:173 ../fish/guestfish.pod:412 ../fuse/guestmount.pod:278 ../inspector/virt-inspector.pod:131 ../rescue/virt-rescue.pod:199 ../tools/virt-tar.pl:158 +#: ../cat/virt-cat.pod:146 ../cat/virt-filesystems.pod:281 ../cat/virt-ls.pod:437 ../df/virt-df.pod:185 ../edit/virt-edit.pod:173 ../fish/guestfish.pod:412 ../fuse/guestmount.pod:278 ../inspector/virt-inspector.pod:131 ../rescue/virt-rescue.pod:199 ../tools/virt-tar.pl:158 msgid "B<-x>" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:148 ../cat/virt-filesystems.pod:283 ../cat/virt-ls.pod:439 ../df/virt-df.pod:181 ../edit/virt-edit.pod:175 ../inspector/virt-inspector.pod:133 ../rescue/virt-rescue.pod:201 +#: ../cat/virt-cat.pod:148 ../cat/virt-filesystems.pod:283 ../cat/virt-ls.pod:439 ../df/virt-df.pod:187 ../edit/virt-edit.pod:175 ../inspector/virt-inspector.pod:133 ../rescue/virt-rescue.pod:201 msgid "Enable tracing of libguestfs API calls." msgstr "" @@ -490,12 +490,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:192 ../cat/virt-filesystems.pod:365 ../cat/virt-ls.pod:483 ../df/virt-df.pod:209 ../edit/virt-edit.pod:342 ../inspector/virt-inspector.pod:349 ../rescue/virt-rescue.pod:262 ../resize/virt-resize.pod:543 ../tools/virt-list-filesystems.pl:188 ../tools/virt-list-partitions.pl:258 ../tools/virt-make-fs.pl:532 ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:733 +#: ../cat/virt-cat.pod:192 ../cat/virt-filesystems.pod:365 ../cat/virt-ls.pod:483 ../df/virt-df.pod:215 ../edit/virt-edit.pod:342 ../inspector/virt-inspector.pod:349 ../rescue/virt-rescue.pod:262 ../resize/virt-resize.pod:543 ../tools/virt-list-filesystems.pl:188 ../tools/virt-list-partitions.pl:258 ../tools/virt-make-fs.pl:532 ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:733 msgid "SHELL QUOTING" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:194 ../cat/virt-filesystems.pod:367 ../cat/virt-ls.pod:485 ../df/virt-df.pod:211 ../edit/virt-edit.pod:344 ../inspector/virt-inspector.pod:351 ../rescue/virt-rescue.pod:264 ../resize/virt-resize.pod:545 ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:534 ../tools/virt-tar.pl:291 ../tools/virt-win-reg.pl:741 +#: ../cat/virt-cat.pod:194 ../cat/virt-filesystems.pod:367 ../cat/virt-ls.pod:485 ../df/virt-df.pod:217 ../edit/virt-edit.pod:344 ../inspector/virt-inspector.pod:351 ../rescue/virt-rescue.pod:264 ../resize/virt-resize.pod:545 ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:534 ../tools/virt-tar.pl:291 ../tools/virt-win-reg.pl:741 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 " @@ -504,7 +504,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:199 ../cat/virt-filesystems.pod:372 ../cat/virt-ls.pod:490 ../df/virt-df.pod:216 ../edit/virt-edit.pod:349 ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384 ../fish/guestfish.pod:1214 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:303 ../inspector/virt-inspector.pod:372 ../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:284 ../resize/virt-resize.pod:550 ../ruby/examples/guestfs-ruby.pod:36 ../src/guestfs.pod:3016 ../test-tool/libguestfs-test-tool.pod:87 ../tools/virt-list-filesystems.pl:195 ../tools/virt-list-partitions.pl:265 ../tools/virt-make-fs.pl:539 ../tools/virt-tar.pl:296 ../tools/virt-win-reg.pl:746 +#: ../cat/virt-cat.pod:199 ../cat/virt-filesystems.pod:372 ../cat/virt-ls.pod:490 ../df/virt-df.pod:222 ../edit/virt-edit.pod:349 ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384 ../fish/guestfish.pod:1224 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:303 ../inspector/virt-inspector.pod:372 ../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:284 ../resize/virt-resize.pod:550 ../ruby/examples/guestfs-ruby.pod:36 ../src/guestfs.pod:3027 ../test-tool/libguestfs-test-tool.pod:87 ../tools/virt-list-filesystems.pl:195 ../tools/virt-list-partitions.pl:265 ../tools/virt-make-fs.pl:539 ../tools/virt-tar.pl:296 ../tools/virt-win-reg.pl:746 msgid "SEE ALSO" msgstr "" @@ -516,17 +516,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:208 ../cat/virt-filesystems.pod:383 ../cat/virt-ls.pod:502 ../df/virt-df.pod:224 ../edit/virt-edit.pod:363 ../rescue/virt-rescue.pod:292 ../resize/virt-resize.pod:571 ../tools/virt-list-filesystems.pl:208 ../tools/virt-list-partitions.pl:277 ../tools/virt-make-fs.pl:564 ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:772 +#: ../cat/virt-cat.pod:208 ../cat/virt-filesystems.pod:383 ../cat/virt-ls.pod:502 ../df/virt-df.pod:230 ../edit/virt-edit.pod:363 ../rescue/virt-rescue.pod:292 ../resize/virt-resize.pod:571 ../tools/virt-list-filesystems.pl:208 ../tools/virt-list-partitions.pl:277 ../tools/virt-make-fs.pl:564 ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:772 msgid "AUTHOR" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:210 ../cat/virt-filesystems.pod:385 ../cat/virt-ls.pod:504 ../df/virt-df.pod:226 ../edit/virt-edit.pod:365 ../inspector/virt-inspector.pod:386 ../rescue/virt-rescue.pod:294 ../resize/virt-resize.pod:573 ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:566 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:774 +#: ../cat/virt-cat.pod:210 ../cat/virt-filesystems.pod:385 ../cat/virt-ls.pod:504 ../df/virt-df.pod:232 ../edit/virt-edit.pod:365 ../inspector/virt-inspector.pod:386 ../rescue/virt-rescue.pod:294 ../resize/virt-resize.pod:573 ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:566 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:774 msgid "Richard W.M. Jones L" msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:212 ../cat/virt-filesystems.pod:387 ../cat/virt-ls.pod:506 ../df/virt-df.pod:228 ../edit/virt-edit.pod:367 ../examples/guestfs-examples.pod:48 ../examples/guestfs-recipes.pod:400 ../fish/guestfish.pod:1242 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:318 ../inspector/virt-inspector.pod:394 ../java/examples/guestfs-java.pod:61 ../ocaml/examples/guestfs-ocaml.pod:94 ../perl/examples/guestfs-perl.pod:55 ../python/examples/guestfs-python.pod:57 ../rescue/virt-rescue.pod:296 ../resize/virt-resize.pod:575 ../ruby/examples/guestfs-ruby.pod:51 ../src/guestfs.pod:3091 ../test-tool/libguestfs-test-tool.pod:97 ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281 ../tools/virt-make-fs.pl:568 ../tools/virt-tar.pl:315 ../tools/virt-win-reg.pl:776 +#: ../cat/virt-cat.pod:212 ../cat/virt-filesystems.pod:387 ../cat/virt-ls.pod:506 ../df/virt-df.pod:234 ../edit/virt-edit.pod:367 ../examples/guestfs-examples.pod:48 ../examples/guestfs-recipes.pod:400 ../fish/guestfish.pod:1253 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:318 ../inspector/virt-inspector.pod:394 ../java/examples/guestfs-java.pod:61 ../ocaml/examples/guestfs-ocaml.pod:94 ../perl/examples/guestfs-perl.pod:55 ../python/examples/guestfs-python.pod:57 ../rescue/virt-rescue.pod:296 ../resize/virt-resize.pod:575 ../ruby/examples/guestfs-ruby.pod:51 ../src/guestfs.pod:3103 ../test-tool/libguestfs-test-tool.pod:97 ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281 ../tools/virt-make-fs.pl:568 ../tools/virt-tar.pl:315 ../tools/virt-win-reg.pl:776 msgid "COPYRIGHT" msgstr "" @@ -536,7 +536,7 @@ msgid "Copyright (C) 2010-2011 Red Hat Inc." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:216 ../cat/virt-filesystems.pod:391 ../cat/virt-ls.pod:510 ../df/virt-df.pod:232 ../edit/virt-edit.pod:371 ../fish/guestfish.pod:1247 ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60 ../fuse/guestmount.pod:323 ../inspector/virt-inspector.pod:398 ../rescue/virt-rescue.pod:300 ../resize/virt-resize.pod:579 ../test-tool/libguestfs-test-tool.pod:102 ../tools/virt-list-filesystems.pl:216 ../tools/virt-list-partitions.pl:285 ../tools/virt-make-fs.pl:572 ../tools/virt-tar.pl:319 ../tools/virt-win-reg.pl:780 +#: ../cat/virt-cat.pod:216 ../cat/virt-filesystems.pod:391 ../cat/virt-ls.pod:510 ../df/virt-df.pod:238 ../edit/virt-edit.pod:371 ../fish/guestfish.pod:1258 ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60 ../fuse/guestmount.pod:323 ../inspector/virt-inspector.pod:398 ../rescue/virt-rescue.pod:300 ../resize/virt-resize.pod:579 ../test-tool/libguestfs-test-tool.pod:102 ../tools/virt-list-filesystems.pl:216 ../tools/virt-list-partitions.pl:285 ../tools/virt-make-fs.pl:572 ../tools/virt-tar.pl:319 ../tools/virt-win-reg.pl:780 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 " @@ -545,7 +545,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:221 ../cat/virt-filesystems.pod:396 ../cat/virt-ls.pod:515 ../df/virt-df.pod:237 ../edit/virt-edit.pod:376 ../fish/guestfish.pod:1252 ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65 ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:403 ../rescue/virt-rescue.pod:305 ../resize/virt-resize.pod:584 ../test-tool/libguestfs-test-tool.pod:107 ../tools/virt-list-filesystems.pl:221 ../tools/virt-list-partitions.pl:290 ../tools/virt-make-fs.pl:577 ../tools/virt-tar.pl:324 ../tools/virt-win-reg.pl:785 +#: ../cat/virt-cat.pod:221 ../cat/virt-filesystems.pod:396 ../cat/virt-ls.pod:515 ../df/virt-df.pod:243 ../edit/virt-edit.pod:376 ../fish/guestfish.pod:1263 ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65 ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:403 ../rescue/virt-rescue.pod:305 ../resize/virt-resize.pod:584 ../test-tool/libguestfs-test-tool.pod:107 ../tools/virt-list-filesystems.pl:221 ../tools/virt-list-partitions.pl:290 ../tools/virt-make-fs.pl:577 ../tools/virt-tar.pl:324 ../tools/virt-win-reg.pl:785 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 " @@ -554,7 +554,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:226 ../cat/virt-filesystems.pod:401 ../cat/virt-ls.pod:520 ../df/virt-df.pod:242 ../edit/virt-edit.pod:381 ../fish/guestfish.pod:1257 ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70 ../fuse/guestmount.pod:333 ../inspector/virt-inspector.pod:408 ../rescue/virt-rescue.pod:310 ../resize/virt-resize.pod:589 ../test-tool/libguestfs-test-tool.pod:112 ../tools/virt-list-filesystems.pl:226 ../tools/virt-list-partitions.pl:295 ../tools/virt-make-fs.pl:582 ../tools/virt-tar.pl:329 ../tools/virt-win-reg.pl:790 +#: ../cat/virt-cat.pod:226 ../cat/virt-filesystems.pod:401 ../cat/virt-ls.pod:520 ../df/virt-df.pod:248 ../edit/virt-edit.pod:381 ../fish/guestfish.pod:1268 ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70 ../fuse/guestmount.pod:333 ../inspector/virt-inspector.pod:408 ../rescue/virt-rescue.pod:310 ../resize/virt-resize.pod:589 ../test-tool/libguestfs-test-tool.pod:112 ../tools/virt-list-filesystems.pl:226 ../tools/virt-list-partitions.pl:295 ../tools/virt-make-fs.pl:582 ../tools/virt-tar.pl:329 ../tools/virt-win-reg.pl:790 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., 675 Mass " @@ -772,12 +772,12 @@ msgid "Display block devices." msgstr "" #. type: =item -#: ../cat/virt-filesystems.pod:135 ../cat/virt-ls.pod:301 +#: ../cat/virt-filesystems.pod:135 ../cat/virt-ls.pod:301 ../df/virt-df.pod:88 msgid "B<--csv>" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:137 ../cat/virt-ls.pod:303 +#: ../cat/virt-filesystems.pod:137 ../cat/virt-ls.pod:303 ../df/virt-df.pod:90 msgid "" "Write out the results in CSV format (comma-separated values). This format " "can be imported easily into databases and spreadsheets, but read L" msgstr "" #. type: =item -#: ../cat/virt-filesystems.pod:196 ../cat/virt-ls.pod:354 ../df/virt-df.pod:121 ../tools/virt-list-partitions.pl:111 +#: ../cat/virt-filesystems.pod:196 ../cat/virt-ls.pod:354 ../df/virt-df.pod:127 ../tools/virt-list-partitions.pl:111 msgid "B<--human-readable>" msgstr "" @@ -978,7 +978,7 @@ msgid "Display LVM physical volumes." msgstr "" #. type: =item -#: ../cat/virt-filesystems.pod:255 ../df/virt-df.pod:157 +#: ../cat/virt-filesystems.pod:255 ../df/virt-df.pod:163 msgid "B<--uuid>" msgstr "" @@ -1127,26 +1127,26 @@ msgid "The UUID is only displayed if the I<--uuid> option is given." msgstr "" #. type: =head1 -#: ../cat/virt-filesystems.pod:341 ../cat/virt-ls.pod:459 ../df/virt-df.pod:185 +#: ../cat/virt-filesystems.pod:341 ../cat/virt-ls.pod:459 ../df/virt-df.pod:191 msgid "NOTE ABOUT CSV FORMAT" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:343 ../cat/virt-ls.pod:461 ../df/virt-df.pod:187 +#: ../cat/virt-filesystems.pod:343 ../cat/virt-ls.pod:461 ../df/virt-df.pod:193 msgid "" "Comma-separated values (CSV) is a deceptive format. It I like it " "should be easy to parse, but it is definitely not easy to parse." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:346 ../cat/virt-ls.pod:464 ../df/virt-df.pod:190 +#: ../cat/virt-filesystems.pod:346 ../cat/virt-ls.pod:464 ../df/virt-df.pod:196 msgid "" "Myth: Just split fields at commas. Reality: This does I work " "reliably. This example has two columns:" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:467 ../df/virt-df.pod:193 +#: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:467 ../df/virt-df.pod:199 #, no-wrap msgid "" " \"foo,bar\",baz\n" @@ -1154,14 +1154,14 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:469 ../df/virt-df.pod:195 +#: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:469 ../df/virt-df.pod:201 msgid "" "Myth: Read the file one line at a time. Reality: This does I work " "reliably. This example has one row:" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:472 ../df/virt-df.pod:198 +#: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:472 ../df/virt-df.pod:204 #, no-wrap msgid "" " \"foo\n" @@ -1170,21 +1170,21 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:475 ../df/virt-df.pod:201 +#: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:475 ../df/virt-df.pod:207 msgid "" "For shell scripts, use C (L also " "packaged in major Linux distributions)." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:360 ../cat/virt-ls.pod:478 ../df/virt-df.pod:204 +#: ../cat/virt-filesystems.pod:360 ../cat/virt-ls.pod:478 ../df/virt-df.pod:210 msgid "" "For other languages, use a CSV processing library (eg. C for Perl " "or Python's built-in csv library)." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:363 ../cat/virt-ls.pod:481 ../df/virt-df.pod:207 +#: ../cat/virt-filesystems.pod:363 ../cat/virt-ls.pod:481 ../df/virt-df.pod:213 msgid "Most spreadsheets and databases can import CSV directly." msgstr "" @@ -1948,7 +1948,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-ls.pod:508 ../df/virt-df.pod:230 ../edit/virt-edit.pod:369 ../rescue/virt-rescue.pod:298 +#: ../cat/virt-ls.pod:508 ../df/virt-df.pod:236 ../edit/virt-edit.pod:369 ../rescue/virt-rescue.pod:298 msgid "Copyright (C) 2009-2011 Red Hat Inc." msgstr "" @@ -2066,7 +2066,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../df/virt-df.pod:106 +#: ../df/virt-df.pod:112 #, no-wrap msgid "" " virt-df --format=raw -a disk.img\n" @@ -2074,7 +2074,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../df/virt-df.pod:110 +#: ../df/virt-df.pod:116 #, no-wrap msgid "" " virt-df --format=raw -a disk.img --format -a another.img\n" @@ -2082,54 +2082,54 @@ msgid "" msgstr "" #. type: textblock -#: ../df/virt-df.pod:123 +#: ../df/virt-df.pod:129 msgid "Print sizes in human-readable format." msgstr "" #. type: textblock -#: ../df/virt-df.pod:125 +#: ../df/virt-df.pod:131 msgid "You are not allowed to use I<-h> and I<--csv> at the same time." msgstr "" #. type: =item -#: ../df/virt-df.pod:127 ../fish/guestfish.pod:258 ../fuse/guestmount.pod:155 +#: ../df/virt-df.pod:133 ../fish/guestfish.pod:258 ../fuse/guestmount.pod:155 msgid "B<-i>" msgstr "" #. type: =item -#: ../df/virt-df.pod:129 +#: ../df/virt-df.pod:135 msgid "B<--inodes>" msgstr "" #. type: textblock -#: ../df/virt-df.pod:131 +#: ../df/virt-df.pod:137 msgid "Print inodes instead of blocks." msgstr "" #. type: =item -#: ../df/virt-df.pod:133 +#: ../df/virt-df.pod:139 msgid "B<--one-per-guest>" msgstr "" #. type: textblock -#: ../df/virt-df.pod:135 +#: ../df/virt-df.pod:141 msgid "" "Run one libguestfs appliance per guest. Normally C will add the " "disks from several guests to a single libguestfs appliance." msgstr "" #. type: textblock -#: ../df/virt-df.pod:138 +#: ../df/virt-df.pod:144 msgid "You might use this option in the following circumstances:" msgstr "" #. type: =item -#: ../df/virt-df.pod:142 ../df/virt-df.pod:148 ../edit/virt-edit.pod:266 ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276 ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291 ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102 ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132 ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227 ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235 ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:385 ../fish/guestfish-actions.pod:393 ../fish/guestfish-actions.pod:400 ../fish/guestfish-actions.pod:407 ../fish/guestfish-actions.pod:1099 ../fish/guestfish-actions.pod:1103 ../fish/guestfish-actions.pod:1107 ../fish/guestfish-actions.pod:1111 ../fish/guestfish-actions.pod:1119 ../fish/guestfish-actions.pod:1123 ../fish/guestfish-actions.pod:1127 ../fish/guestfish-actions.pod:1137 ../fish/guestfish-actions.pod:1141 ../fish/guestfish-actions.pod:1145 ../fish/guestfish-actions.pod:1235 ../fish/guestfish-actions.pod:1239 ../fish/guestfish-actions.pod:1244 ../fish/guestfish-actions.pod:1249 ../fish/guestfish-actions.pod:1291 ../fish/guestfish-actions.pod:1295 ../fish/guestfish-actions.pod:1300 ../fish/guestfish-actions.pod:1933 ../fish/guestfish-actions.pod:1939 ../fish/guestfish-actions.pod:1947 ../fish/guestfish-actions.pod:1954 ../fish/guestfish-actions.pod:1961 ../fish/guestfish.pod:445 ../fish/guestfish.pod:449 ../fish/guestfish.pod:453 ../fish/guestfish.pod:457 ../inspector/virt-inspector.pod:384 ../inspector/virt-inspector.pod:388 ../resize/virt-resize.pod:282 ../resize/virt-resize.pod:286 ../resize/virt-resize.pod:295 ../resize/virt-resize.pod:301 ../src/guestfs-actions.pod:15 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:583 ../src/guestfs-actions.pod:591 ../src/guestfs-actions.pod:598 ../src/guestfs-actions.pod:605 ../src/guestfs-actions.pod:1662 ../src/guestfs-actions.pod:1666 ../src/guestfs-actions.pod:1670 ../src/guestfs-actions.pod:1674 ../src/guestfs-actions.pod:1682 ../src/guestfs-actions.pod:1686 ../src/guestfs-actions.pod:1690 ../src/guestfs-actions.pod:1700 ../src/guestfs-actions.pod:1704 ../src/guestfs-actions.pod:1708 ../src/guestfs-actions.pod:1846 ../src/guestfs-actions.pod:1850 ../src/guestfs-actions.pod:1855 ../src/guestfs-actions.pod:1860 ../src/guestfs-actions.pod:1921 ../src/guestfs-actions.pod:1925 ../src/guestfs-actions.pod:1930 ../src/guestfs-actions.pod:2859 ../src/guestfs-actions.pod:2865 ../src/guestfs-actions.pod:2873 ../src/guestfs-actions.pod:2880 ../src/guestfs-actions.pod:2887 ../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:1064 ../src/guestfs.pod:1068 ../src/guestfs.pod:1072 ../src/guestfs.pod:1077 ../src/guestfs.pod:1085 ../src/guestfs.pod:1104 ../src/guestfs.pod:1112 ../src/guestfs.pod:1134 ../src/guestfs.pod:1138 ../src/guestfs.pod:1142 ../src/guestfs.pod:1146 ../src/guestfs.pod:1150 ../src/guestfs.pod:1154 ../src/guestfs.pod:1643 ../src/guestfs.pod:1648 ../src/guestfs.pod:1652 ../src/guestfs.pod:1754 ../src/guestfs.pod:1759 ../src/guestfs.pod:1763 ../src/guestfs.pod:1773 ../src/guestfs.pod:2047 ../src/guestfs.pod:2052 ../src/guestfs.pod:2058 ../src/guestfs.pod:2066 ../src/guestfs.pod:2420 ../src/guestfs.pod:2426 ../src/guestfs.pod:2431 ../src/guestfs.pod:2437 ../src/guestfs.pod:2818 ../src/guestfs.pod:2823 ../src/guestfs.pod:2827 ../src/guestfs.pod:2831 ../src/guestfs.pod:2835 ../src/guestfs.pod:2849 ../src/guestfs.pod:2854 ../src/guestfs.pod:3068 ../src/guestfs.pod:3072 ../src/guestfs.pod:3076 ../src/guestfs.pod:3080 ../tools/virt-win-reg.pl:197 ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208 ../tools/virt-win-reg.pl:710 ../tools/virt-win-reg.pl:716 ../tools/virt-win-reg.pl:722 +#: ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266 ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276 ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291 ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102 ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132 ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227 ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235 ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:385 ../fish/guestfish-actions.pod:393 ../fish/guestfish-actions.pod:400 ../fish/guestfish-actions.pod:407 ../fish/guestfish-actions.pod:1099 ../fish/guestfish-actions.pod:1103 ../fish/guestfish-actions.pod:1107 ../fish/guestfish-actions.pod:1111 ../fish/guestfish-actions.pod:1119 ../fish/guestfish-actions.pod:1123 ../fish/guestfish-actions.pod:1127 ../fish/guestfish-actions.pod:1137 ../fish/guestfish-actions.pod:1141 ../fish/guestfish-actions.pod:1145 ../fish/guestfish-actions.pod:1235 ../fish/guestfish-actions.pod:1239 ../fish/guestfish-actions.pod:1244 ../fish/guestfish-actions.pod:1249 ../fish/guestfish-actions.pod:1291 ../fish/guestfish-actions.pod:1295 ../fish/guestfish-actions.pod:1300 ../fish/guestfish-actions.pod:1933 ../fish/guestfish-actions.pod:1939 ../fish/guestfish-actions.pod:1947 ../fish/guestfish-actions.pod:1954 ../fish/guestfish-actions.pod:1961 ../fish/guestfish.pod:445 ../fish/guestfish.pod:449 ../fish/guestfish.pod:453 ../fish/guestfish.pod:457 ../inspector/virt-inspector.pod:384 ../inspector/virt-inspector.pod:388 ../resize/virt-resize.pod:282 ../resize/virt-resize.pod:286 ../resize/virt-resize.pod:295 ../resize/virt-resize.pod:301 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:29 ../src/guestfs-actions.pod:583 ../src/guestfs-actions.pod:591 ../src/guestfs-actions.pod:598 ../src/guestfs-actions.pod:605 ../src/guestfs-actions.pod:1662 ../src/guestfs-actions.pod:1666 ../src/guestfs-actions.pod:1670 ../src/guestfs-actions.pod:1674 ../src/guestfs-actions.pod:1682 ../src/guestfs-actions.pod:1686 ../src/guestfs-actions.pod:1690 ../src/guestfs-actions.pod:1700 ../src/guestfs-actions.pod:1704 ../src/guestfs-actions.pod:1708 ../src/guestfs-actions.pod:1846 ../src/guestfs-actions.pod:1850 ../src/guestfs-actions.pod:1855 ../src/guestfs-actions.pod:1860 ../src/guestfs-actions.pod:1921 ../src/guestfs-actions.pod:1925 ../src/guestfs-actions.pod:1930 ../src/guestfs-actions.pod:2859 ../src/guestfs-actions.pod:2865 ../src/guestfs-actions.pod:2873 ../src/guestfs-actions.pod:2880 ../src/guestfs-actions.pod:2887 ../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:1064 ../src/guestfs.pod:1068 ../src/guestfs.pod:1072 ../src/guestfs.pod:1077 ../src/guestfs.pod:1085 ../src/guestfs.pod:1104 ../src/guestfs.pod:1112 ../src/guestfs.pod:1134 ../src/guestfs.pod:1138 ../src/guestfs.pod:1142 ../src/guestfs.pod:1146 ../src/guestfs.pod:1150 ../src/guestfs.pod:1154 ../src/guestfs.pod:1644 ../src/guestfs.pod:1649 ../src/guestfs.pod:1653 ../src/guestfs.pod:1755 ../src/guestfs.pod:1760 ../src/guestfs.pod:1764 ../src/guestfs.pod:1774 ../src/guestfs.pod:2048 ../src/guestfs.pod:2053 ../src/guestfs.pod:2059 ../src/guestfs.pod:2067 ../src/guestfs.pod:2421 ../src/guestfs.pod:2427 ../src/guestfs.pod:2432 ../src/guestfs.pod:2438 ../src/guestfs.pod:2819 ../src/guestfs.pod:2824 ../src/guestfs.pod:2828 ../src/guestfs.pod:2832 ../src/guestfs.pod:2836 ../src/guestfs.pod:2850 ../src/guestfs.pod:2855 ../src/guestfs.pod:3080 ../src/guestfs.pod:3084 ../src/guestfs.pod:3088 ../src/guestfs.pod:3092 ../tools/virt-win-reg.pl:197 ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208 ../tools/virt-win-reg.pl:710 ../tools/virt-win-reg.pl:716 ../tools/virt-win-reg.pl:722 msgid "*" msgstr "" #. type: textblock -#: ../df/virt-df.pod:144 +#: ../df/virt-df.pod:150 msgid "" "If you think an untrusted guest might actively try to exploit the libguestfs " "appliance kernel, then this prevents one guest from interfering with the " @@ -2137,7 +2137,7 @@ msgid "" msgstr "" #. type: textblock -#: ../df/virt-df.pod:150 +#: ../df/virt-df.pod:156 msgid "" "If the kernel has a bug which stops it from accessing a filesystem in one " "guest (see for example RHBZ#635373) then this allows libguestfs to continue " @@ -2145,7 +2145,7 @@ msgid "" msgstr "" #. type: textblock -#: ../df/virt-df.pod:159 +#: ../df/virt-df.pod:165 msgid "" "Print UUIDs instead of names. This is useful for following a guest even " "when the guest is migrated or renamed, or when two guests happen to have the " @@ -2153,7 +2153,7 @@ msgid "" msgstr "" #. type: textblock -#: ../df/virt-df.pod:163 +#: ../df/virt-df.pod:169 msgid "" "Note that only domains that we fetch from libvirt come with UUIDs. For disk " "images, we still print the disk image name even when this option is " @@ -2161,7 +2161,7 @@ msgid "" msgstr "" #. type: textblock -#: ../df/virt-df.pod:218 +#: ../df/virt-df.pod:224 msgid "" "L, L, L, L, " "L." @@ -2711,7 +2711,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../edit/virt-edit.pod:329 ../fish/guestfish.pod:1075 ../rescue/virt-rescue.pod:257 ../src/guestfs.pod:2965 ../test-tool/libguestfs-test-tool.pod:82 +#: ../edit/virt-edit.pod:329 ../fish/guestfish.pod:1075 ../rescue/virt-rescue.pod:257 ../src/guestfs.pod:2966 ../test-tool/libguestfs-test-tool.pod:82 msgid "ENVIRONMENT VARIABLES" msgstr "" @@ -2810,12 +2810,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-examples.pod:44 ../examples/guestfs-recipes.pod:396 ../fish/guestfish.pod:1238 ../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:314 ../inspector/virt-inspector.pod:380 ../java/examples/guestfs-java.pod:57 ../ocaml/examples/guestfs-ocaml.pod:90 ../perl/examples/guestfs-perl.pod:51 ../python/examples/guestfs-python.pod:53 ../ruby/examples/guestfs-ruby.pod:47 ../src/guestfs.pod:3087 ../test-tool/libguestfs-test-tool.pod:93 +#: ../examples/guestfs-examples.pod:44 ../examples/guestfs-recipes.pod:396 ../fish/guestfish.pod:1249 ../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:314 ../inspector/virt-inspector.pod:380 ../java/examples/guestfs-java.pod:57 ../ocaml/examples/guestfs-ocaml.pod:90 ../perl/examples/guestfs-perl.pod:51 ../python/examples/guestfs-python.pod:53 ../ruby/examples/guestfs-ruby.pod:47 ../src/guestfs.pod:3099 ../test-tool/libguestfs-test-tool.pod:93 msgid "AUTHORS" msgstr "" #. type: textblock -#: ../examples/guestfs-examples.pod:46 ../examples/guestfs-recipes.pod:398 ../fish/guestfish.pod:1240 ../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:316 ../java/examples/guestfs-java.pod:59 ../ocaml/examples/guestfs-ocaml.pod:92 ../perl/examples/guestfs-perl.pod:53 ../python/examples/guestfs-python.pod:55 ../ruby/examples/guestfs-ruby.pod:49 ../src/guestfs.pod:3089 ../test-tool/libguestfs-test-tool.pod:95 +#: ../examples/guestfs-examples.pod:46 ../examples/guestfs-recipes.pod:398 ../fish/guestfish.pod:1251 ../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:316 ../java/examples/guestfs-java.pod:59 ../ocaml/examples/guestfs-ocaml.pod:92 ../perl/examples/guestfs-perl.pod:53 ../python/examples/guestfs-python.pod:55 ../ruby/examples/guestfs-ruby.pod:49 ../src/guestfs.pod:3101 ../test-tool/libguestfs-test-tool.pod:95 msgid "Richard W.M. Jones (C)" msgstr "" @@ -2832,7 +2832,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-examples.pod:55 ../examples/guestfs-recipes.pod:407 ../java/examples/guestfs-java.pod:68 ../ocaml/examples/guestfs-ocaml.pod:101 ../perl/examples/guestfs-perl.pod:62 ../python/examples/guestfs-python.pod:64 ../ruby/examples/guestfs-ruby.pod:58 ../src/guestfs.pod:3096 +#: ../examples/guestfs-examples.pod:55 ../examples/guestfs-recipes.pod:407 ../java/examples/guestfs-java.pod:68 ../ocaml/examples/guestfs-ocaml.pod:101 ../perl/examples/guestfs-perl.pod:62 ../python/examples/guestfs-python.pod:64 ../ruby/examples/guestfs-ruby.pod:58 ../src/guestfs.pod:3108 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 " @@ -2841,7 +2841,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-examples.pod:60 ../examples/guestfs-recipes.pod:412 ../java/examples/guestfs-java.pod:73 ../ocaml/examples/guestfs-ocaml.pod:106 ../perl/examples/guestfs-perl.pod:67 ../python/examples/guestfs-python.pod:69 ../ruby/examples/guestfs-ruby.pod:63 ../src/guestfs.pod:3101 +#: ../examples/guestfs-examples.pod:60 ../examples/guestfs-recipes.pod:412 ../java/examples/guestfs-java.pod:73 ../ocaml/examples/guestfs-ocaml.pod:106 ../perl/examples/guestfs-perl.pod:67 ../python/examples/guestfs-python.pod:69 ../ruby/examples/guestfs-ruby.pod:63 ../src/guestfs.pod:3113 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 " @@ -2850,7 +2850,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-examples.pod:65 ../examples/guestfs-recipes.pod:417 ../java/examples/guestfs-java.pod:78 ../ocaml/examples/guestfs-ocaml.pod:111 ../perl/examples/guestfs-perl.pod:72 ../python/examples/guestfs-python.pod:74 ../ruby/examples/guestfs-ruby.pod:68 ../src/guestfs.pod:3106 +#: ../examples/guestfs-examples.pod:65 ../examples/guestfs-recipes.pod:417 ../java/examples/guestfs-java.pod:78 ../ocaml/examples/guestfs-ocaml.pod:111 ../perl/examples/guestfs-perl.pod:72 ../python/examples/guestfs-python.pod:74 ../ruby/examples/guestfs-ruby.pod:68 ../src/guestfs.pod:3118 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, " @@ -3131,7 +3131,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1287 ../fish/guestfish-actions.pod:1929 ../src/guestfs-actions.pod:11 ../src/guestfs-actions.pod:1917 ../src/guestfs-actions.pod:2855 ../src/guestfs.pod:1639 ../tools/virt-win-reg.pl:706 +#: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1287 ../fish/guestfish-actions.pod:1929 ../src/guestfs-actions.pod:18 ../src/guestfs-actions.pod:1917 ../src/guestfs-actions.pod:2855 ../src/guestfs.pod:1640 ../tools/virt-win-reg.pl:706 msgid "Notes:" msgstr "" @@ -3682,12 +3682,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5 ../src/guestfs-actions.pod:7 +#: ../fish/guestfish-actions.pod:5 ../src/guestfs-actions.pod:14 msgid "This function adds a virtual CD-ROM disk image to the guest." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:7 ../src/guestfs-actions.pod:9 +#: ../fish/guestfish-actions.pod:7 ../src/guestfs-actions.pod:16 msgid "This is equivalent to the qemu parameter I<-cdrom filename>." msgstr "" @@ -3709,14 +3709,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:163 ../fish/guestfish-actions.pod:177 ../src/guestfs-actions.pod:32 ../src/guestfs-actions.pod:254 ../src/guestfs-actions.pod:275 +#: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:163 ../fish/guestfish-actions.pod:177 msgid "" -"This function is deprecated. In new code, use the C call " +"I In new code, use the L call " "instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:166 ../fish/guestfish-actions.pod:180 ../fish/guestfish-actions.pod:986 ../fish/guestfish-actions.pod:1346 ../fish/guestfish-actions.pod:1360 ../fish/guestfish-actions.pod:3085 ../fish/guestfish-actions.pod:3292 ../fish/guestfish-actions.pod:3406 ../fish/guestfish-actions.pod:3454 ../fish/guestfish-actions.pod:4355 ../fish/guestfish-actions.pod:4378 ../fish/guestfish-actions.pod:4400 ../fish/guestfish-actions.pod:4438 ../fish/guestfish-actions.pod:5087 ../fish/guestfish-actions.pod:5185 ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:257 ../src/guestfs-actions.pod:278 ../src/guestfs-actions.pod:1513 ../src/guestfs-actions.pod:2008 ../src/guestfs-actions.pod:2029 ../src/guestfs-actions.pod:4628 ../src/guestfs-actions.pod:4947 ../src/guestfs-actions.pod:5165 ../src/guestfs-actions.pod:5255 ../src/guestfs-actions.pod:6544 ../src/guestfs-actions.pod:6574 ../src/guestfs-actions.pod:6607 ../src/guestfs-actions.pod:6666 ../src/guestfs-actions.pod:7602 ../src/guestfs-actions.pod:7714 ../src/guestfs-actions.pod:7884 +#: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:166 ../fish/guestfish-actions.pod:180 ../fish/guestfish-actions.pod:986 ../fish/guestfish-actions.pod:1346 ../fish/guestfish-actions.pod:1360 ../fish/guestfish-actions.pod:3085 ../fish/guestfish-actions.pod:3292 ../fish/guestfish-actions.pod:3406 ../fish/guestfish-actions.pod:3454 ../fish/guestfish-actions.pod:4355 ../fish/guestfish-actions.pod:4378 ../fish/guestfish-actions.pod:4400 ../fish/guestfish-actions.pod:4438 ../fish/guestfish-actions.pod:5087 ../fish/guestfish-actions.pod:5185 ../src/guestfs-actions.pod:10 ../src/guestfs-actions.pod:252 ../src/guestfs-actions.pod:273 ../src/guestfs-actions.pod:1503 ../src/guestfs-actions.pod:2002 ../src/guestfs-actions.pod:2023 ../src/guestfs-actions.pod:4618 ../src/guestfs-actions.pod:4921 ../src/guestfs-actions.pod:5150 ../src/guestfs-actions.pod:5250 ../src/guestfs-actions.pod:6516 ../src/guestfs-actions.pod:6560 ../src/guestfs-actions.pod:6594 ../src/guestfs-actions.pod:6657 ../src/guestfs-actions.pod:7589 ../src/guestfs-actions.pod:7698 ../src/guestfs-actions.pod:7873 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 " @@ -4948,7 +4948,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:617 ../fish/guestfish-actions.pod:752 ../fish/guestfish-actions.pod:764 ../fish/guestfish-actions.pod:940 ../fish/guestfish-actions.pod:950 ../fish/guestfish-actions.pod:1017 ../fish/guestfish-actions.pod:1027 ../fish/guestfish-actions.pod:1219 ../fish/guestfish-actions.pod:1526 ../fish/guestfish-actions.pod:1536 ../fish/guestfish-actions.pod:1564 ../fish/guestfish-actions.pod:1579 ../fish/guestfish-actions.pod:1589 ../fish/guestfish-actions.pod:1608 ../fish/guestfish-actions.pod:3707 ../fish/guestfish-actions.pod:3722 ../fish/guestfish-actions.pod:3798 ../fish/guestfish-actions.pod:3815 ../fish/guestfish-actions.pod:3830 ../fish/guestfish-actions.pod:4499 ../fish/guestfish-actions.pod:4545 ../fish/guestfish-actions.pod:4630 ../fish/guestfish-actions.pod:4645 ../fish/guestfish-actions.pod:5051 ../fish/guestfish-actions.pod:5063 ../fish/guestfish-actions.pod:5081 ../fish/guestfish-actions.pod:5098 ../fish/guestfish-actions.pod:5108 ../fish/guestfish-actions.pod:5157 ../fish/guestfish-actions.pod:5167 ../fish/guestfish-actions.pod:5196 ../fish/guestfish-actions.pod:5206 ../src/guestfs-actions.pod:943 ../src/guestfs-actions.pod:1122 ../src/guestfs-actions.pod:1142 ../src/guestfs-actions.pod:1438 ../src/guestfs-actions.pod:1457 ../src/guestfs-actions.pod:1560 ../src/guestfs-actions.pod:1579 ../src/guestfs-actions.pod:1825 ../src/guestfs-actions.pod:2296 ../src/guestfs-actions.pod:2315 ../src/guestfs-actions.pod:2358 ../src/guestfs-actions.pod:2382 ../src/guestfs-actions.pod:2399 ../src/guestfs-actions.pod:2428 ../src/guestfs-actions.pod:5614 ../src/guestfs-actions.pod:5640 ../src/guestfs-actions.pod:5771 ../src/guestfs-actions.pod:5797 ../src/guestfs-actions.pod:5821 ../src/guestfs-actions.pod:6772 ../src/guestfs-actions.pod:6827 ../src/guestfs-actions.pod:6973 ../src/guestfs-actions.pod:6997 ../src/guestfs-actions.pod:7662 ../src/guestfs-actions.pod:7682 ../src/guestfs-actions.pod:7708 ../src/guestfs-actions.pod:7734 ../src/guestfs-actions.pod:7753 ../src/guestfs-actions.pod:7839 ../src/guestfs-actions.pod:7858 ../src/guestfs-actions.pod:7904 ../src/guestfs-actions.pod:7923 +#: ../fish/guestfish-actions.pod:617 ../fish/guestfish-actions.pod:752 ../fish/guestfish-actions.pod:764 ../fish/guestfish-actions.pod:940 ../fish/guestfish-actions.pod:950 ../fish/guestfish-actions.pod:1017 ../fish/guestfish-actions.pod:1027 ../fish/guestfish-actions.pod:1219 ../fish/guestfish-actions.pod:1526 ../fish/guestfish-actions.pod:1536 ../fish/guestfish-actions.pod:1564 ../fish/guestfish-actions.pod:1579 ../fish/guestfish-actions.pod:1589 ../fish/guestfish-actions.pod:1608 ../fish/guestfish-actions.pod:3707 ../fish/guestfish-actions.pod:3722 ../fish/guestfish-actions.pod:3798 ../fish/guestfish-actions.pod:3815 ../fish/guestfish-actions.pod:3830 ../fish/guestfish-actions.pod:4499 ../fish/guestfish-actions.pod:4545 ../fish/guestfish-actions.pod:4630 ../fish/guestfish-actions.pod:4645 ../fish/guestfish-actions.pod:5051 ../fish/guestfish-actions.pod:5063 ../fish/guestfish-actions.pod:5081 ../fish/guestfish-actions.pod:5098 ../fish/guestfish-actions.pod:5108 ../fish/guestfish-actions.pod:5157 ../fish/guestfish-actions.pod:5167 ../fish/guestfish-actions.pod:5196 ../fish/guestfish-actions.pod:5206 ../src/guestfs-actions.pod:943 ../src/guestfs-actions.pod:1122 ../src/guestfs-actions.pod:1142 ../src/guestfs-actions.pod:1438 ../src/guestfs-actions.pod:1457 ../src/guestfs-actions.pod:1560 ../src/guestfs-actions.pod:1579 ../src/guestfs-actions.pod:1825 ../src/guestfs-actions.pod:2296 ../src/guestfs-actions.pod:2315 ../src/guestfs-actions.pod:2358 ../src/guestfs-actions.pod:2382 ../src/guestfs-actions.pod:2399 ../src/guestfs-actions.pod:2428 ../src/guestfs-actions.pod:5614 ../src/guestfs-actions.pod:5640 ../src/guestfs-actions.pod:5771 ../src/guestfs-actions.pod:5797 ../src/guestfs-actions.pod:5821 ../src/guestfs-actions.pod:6772 ../src/guestfs-actions.pod:6827 ../src/guestfs-actions.pod:6973 ../src/guestfs-actions.pod:6997 ../src/guestfs-actions.pod:7662 ../src/guestfs-actions.pod:7682 ../src/guestfs-actions.pod:7715 ../src/guestfs-actions.pod:7734 ../src/guestfs-actions.pod:7753 ../src/guestfs-actions.pod:7839 ../src/guestfs-actions.pod:7858 ../src/guestfs-actions.pod:7904 ../src/guestfs-actions.pod:7923 msgid "" "Because of the message protocol, there is a transfer limit of somewhere " "between 2MB and 4MB. See L." @@ -5747,23 +5747,23 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:975 ../fish/guestfish-actions.pod:994 ../src/guestfs-actions.pod:1500 ../src/guestfs-actions.pod:1526 +#: ../fish/guestfish-actions.pod:975 ../fish/guestfish-actions.pod:994 ../src/guestfs-actions.pod:1507 ../src/guestfs-actions.pod:1526 msgid "" "This command preallocates a file (containing zero bytes) named C of " "size C bytes. If the file exists already, it is overwritten." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:979 ../src/guestfs-actions.pod:1504 +#: ../fish/guestfish-actions.pod:979 ../src/guestfs-actions.pod:1511 msgid "" "Do not confuse this with the guestfish-specific C command which " "allocates a file in the host and attaches it as a device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:983 ../src/guestfs-actions.pod:1510 +#: ../fish/guestfish-actions.pod:983 msgid "" -"This function is deprecated. In new code, use the C call " +"I In new code, use the L call " "instead." msgstr "" @@ -6455,14 +6455,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1340 ../src/guestfs-actions.pod:1999 +#: ../fish/guestfish-actions.pod:1340 ../src/guestfs-actions.pod:2006 msgid "This returns the ext2/3/4 filesystem label of the filesystem on C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1343 ../src/guestfs-actions.pod:2005 +#: ../fish/guestfish-actions.pod:1343 msgid "" -"This function is deprecated. In new code, use the C call " +"I In new code, use the L call " "instead." msgstr "" @@ -6480,13 +6480,15 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1354 ../src/guestfs-actions.pod:2020 +#: ../fish/guestfish-actions.pod:1354 ../src/guestfs-actions.pod:2027 msgid "This returns the ext2/3/4 filesystem UUID of the filesystem on C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1357 ../src/guestfs-actions.pod:2026 -msgid "This function is deprecated. In new code, use the C call instead." +#: ../fish/guestfish-actions.pod:1357 +msgid "" +"I In new code, use the L call " +"instead." msgstr "" #. type: =head2 @@ -9420,7 +9422,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2737 ../fish/guestfish-actions.pod:2750 ../fish/guestfish-actions.pod:2837 ../fish/guestfish-actions.pod:3498 ../fish/guestfish-actions.pod:4024 ../fish/guestfish-actions.pod:4349 ../fish/guestfish-actions.pod:4372 ../fish/guestfish-actions.pod:4394 ../fish/guestfish-actions.pod:5132 ../src/guestfs-actions.pod:4053 ../src/guestfs-actions.pod:4076 ../src/guestfs-actions.pod:4219 ../src/guestfs-actions.pod:5322 ../src/guestfs-actions.pod:6110 ../src/guestfs-actions.pod:6538 ../src/guestfs-actions.pod:6568 ../src/guestfs-actions.pod:6601 ../src/guestfs-actions.pod:7799 +#: ../fish/guestfish-actions.pod:2737 ../fish/guestfish-actions.pod:2750 ../fish/guestfish-actions.pod:2837 ../fish/guestfish-actions.pod:3498 ../fish/guestfish-actions.pod:4024 ../fish/guestfish-actions.pod:4349 ../fish/guestfish-actions.pod:4372 ../fish/guestfish-actions.pod:4394 ../fish/guestfish-actions.pod:5132 ../src/guestfs-actions.pod:4053 ../src/guestfs-actions.pod:4076 ../src/guestfs-actions.pod:4219 ../src/guestfs-actions.pod:5322 ../src/guestfs-actions.pod:6110 ../src/guestfs-actions.pod:6545 ../src/guestfs-actions.pod:6575 ../src/guestfs-actions.pod:6608 ../src/guestfs-actions.pod:7799 msgid "" "B." @@ -10213,16 +10215,16 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3079 ../fish/guestfish-actions.pod:3106 ../src/guestfs-actions.pod:4620 ../src/guestfs-actions.pod:4665 +#: ../fish/guestfish-actions.pod:3079 ../fish/guestfish-actions.pod:3106 ../src/guestfs-actions.pod:4627 ../src/guestfs-actions.pod:4665 msgid "" "For VFAT and NTFS the C parameter is treated as the requested " "cluster size." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3082 ../src/guestfs-actions.pod:4625 +#: ../fish/guestfish-actions.pod:3082 msgid "" -"This function is deprecated. In new code, use the C call " +"I In new code, use the L call " "instead." msgstr "" @@ -10605,7 +10607,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3265 ../src/guestfs-actions.pod:4918 +#: ../fish/guestfish-actions.pod:3265 ../src/guestfs-actions.pod:4925 msgid "" "Mount a guest disk at a position in the filesystem. Block devices are named " "C, C and so on, as they were added to the guest. If " @@ -10614,7 +10616,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3271 ../src/guestfs-actions.pod:4924 +#: ../fish/guestfish-actions.pod:3271 ../src/guestfs-actions.pod:4931 msgid "" "The rules are the same as for L: A filesystem must first be " "mounted on C before others can be mounted. Other filesystems can only be " @@ -10622,7 +10624,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3276 ../src/guestfs-actions.pod:4929 +#: ../fish/guestfish-actions.pod:3276 ../src/guestfs-actions.pod:4936 msgid "" "The mounted filesystem is writable, if we have sufficient permissions on the " "underlying device." @@ -10641,9 +10643,9 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3289 ../src/guestfs-actions.pod:4944 +#: ../fish/guestfish-actions.pod:3289 msgid "" -"This function is deprecated. In new code, use the C call " +"I In new code, use the L call " "instead." msgstr "" @@ -10884,14 +10886,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3390 ../fish/guestfish-actions.pod:3414 ../src/guestfs-actions.pod:5147 ../src/guestfs-actions.pod:5186 +#: ../fish/guestfish-actions.pod:3390 ../fish/guestfish-actions.pod:3414 ../src/guestfs-actions.pod:5154 ../src/guestfs-actions.pod:5186 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:3393 ../src/guestfs-actions.pod:5150 +#: ../fish/guestfish-actions.pod:3393 ../src/guestfs-actions.pod:5157 msgid "" "I After the resize operation, the filesystem is marked as requiring a " "consistency check (for safety). You have to boot into Windows to perform " @@ -10902,15 +10904,15 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3401 ../fish/guestfish-actions.pod:3440 ../src/guestfs-actions.pod:5158 ../src/guestfs-actions.pod:5212 +#: ../fish/guestfish-actions.pod:3401 ../fish/guestfish-actions.pod:3440 ../src/guestfs-actions.pod:5165 ../src/guestfs-actions.pod:5212 msgid "See also L." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3403 ../fish/guestfish-actions.pod:3451 ../src/guestfs-actions.pod:5162 ../src/guestfs-actions.pod:5252 +#: ../fish/guestfish-actions.pod:3403 ../fish/guestfish-actions.pod:3451 msgid "" -"This function is deprecated. In new code, use the C call " -"instead." +"I In new code, use the L " +"call instead." msgstr "" #. type: =head2 @@ -12379,7 +12381,7 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4078 ../src/guestfs-actions.pod:6182 ../src/guestfs.pod:2687 +#: ../fish/guestfish-actions.pod:4078 ../src/guestfs-actions.pod:6182 ../src/guestfs.pod:2688 msgid "C" msgstr "" @@ -12948,19 +12950,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4326 ../src/guestfs-actions.pod:6513 +#: ../fish/guestfish-actions.pod:4326 ../src/guestfs-actions.pod:6520 msgid "" "This is a direct interface to the L program for creating " "partitions on block devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4329 ../src/guestfs-actions.pod:6516 +#: ../fish/guestfish-actions.pod:4329 ../src/guestfs-actions.pod:6523 msgid "C should be a block device, for example C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4331 ../src/guestfs-actions.pod:6518 +#: ../fish/guestfish-actions.pod:4331 ../src/guestfs-actions.pod:6525 msgid "" "C, C and C are the number of cylinders, heads and " "sectors on the device, which are passed directly to sfdisk as the I<-C>, " @@ -12971,14 +12973,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4339 ../src/guestfs-actions.pod:6526 +#: ../fish/guestfish-actions.pod:4339 ../src/guestfs-actions.pod:6533 msgid "" "C is a list of lines that we feed to C. For more information " "refer to the L manpage." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4342 ../src/guestfs-actions.pod:6529 +#: ../fish/guestfish-actions.pod:4342 ../src/guestfs-actions.pod:6536 msgid "" "To create a single partition occupying the whole disk, you would pass " "C as a single element list, when the single element being the string " @@ -12991,8 +12993,10 @@ msgid "See also: L, L, L" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4352 ../fish/guestfish-actions.pod:4375 ../fish/guestfish-actions.pod:4397 ../src/guestfs-actions.pod:6541 ../src/guestfs-actions.pod:6571 ../src/guestfs-actions.pod:6604 -msgid "This function is deprecated. In new code, use the C call instead." +#: ../fish/guestfish-actions.pod:4352 ../fish/guestfish-actions.pod:4375 ../fish/guestfish-actions.pod:4397 +msgid "" +"I In new code, use the L call " +"instead." msgstr "" #. type: =head2 @@ -13036,7 +13040,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4386 ../src/guestfs-actions.pod:6591 +#: ../fish/guestfish-actions.pod:4386 ../src/guestfs-actions.pod:6598 msgid "" "This runs L option to modify just the single partition C " "(note: C counts from 1)." @@ -13113,7 +13117,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4429 ../src/guestfs-actions.pod:6654 +#: ../fish/guestfish-actions.pod:4429 ../src/guestfs-actions.pod:6661 msgid "" "This displays the partition table on C, in the human-readable output " "of the L command. It is not intended to be parsed." @@ -13125,9 +13129,9 @@ msgid "See also: L" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4435 ../src/guestfs-actions.pod:6663 +#: ../fish/guestfish-actions.pod:4435 msgid "" -"This function is deprecated. In new code, use the C call " +"I In new code, use the L call " "instead." msgstr "" @@ -14610,29 +14614,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5070 ../src/guestfs-actions.pod:7695 +#: ../fish/guestfish-actions.pod:5070 ../src/guestfs-actions.pod:7702 msgid "" "This call creates a file called C. The contents of the file is the " "string C (which can contain any 8 bit data), with length C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5074 ../src/guestfs-actions.pod:7699 +#: ../fish/guestfish-actions.pod:5074 ../src/guestfs-actions.pod:7706 msgid "" "As a special case, if C is C<0> then the length is calculated using " "C (so in this case the content cannot contain embedded ASCII NULs)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5078 ../src/guestfs-actions.pod:7703 +#: ../fish/guestfish-actions.pod:5078 ../src/guestfs-actions.pod:7710 msgid "" "I Owing to a bug, writing content containing ASCII NUL characters does " "I work, even if the length is specified." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5084 ../src/guestfs-actions.pod:7711 -msgid "This function is deprecated. In new code, use the C call instead." +#: ../fish/guestfish-actions.pod:5084 +msgid "I In new code, use the L call instead." msgstr "" #. type: =head2 @@ -14805,12 +14809,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5174 ../src/guestfs-actions.pod:7870 +#: ../fish/guestfish-actions.pod:5174 ../src/guestfs-actions.pod:7877 msgid "This command runs C after first decompressing C using C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5177 ../src/guestfs-actions.pod:7873 +#: ../fish/guestfish-actions.pod:5177 ../src/guestfs-actions.pod:7880 msgid "C must be one of C, C or C." msgstr "" @@ -14820,8 +14824,8 @@ msgid "Since 1.0.63, use L instead which can now process compressed files msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5182 ../src/guestfs-actions.pod:7881 -msgid "This function is deprecated. In new code, use the C call instead." +#: ../fish/guestfish-actions.pod:5182 +msgid "I In new code, use the L call instead." msgstr "" #. type: =head2 @@ -14886,12 +14890,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:182 +#: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:193 msgid "For more advanced image creation, see L utility." msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:184 +#: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:195 msgid "Size can be specified using standard suffixes, eg. C<1M>." msgstr "" @@ -15293,26 +15297,57 @@ msgstr "" #. type: =head2 #: ../fish/guestfish-commands.pod:169 -msgid "sparse" +msgid "setenv" msgstr "" #. type: verbatim #: ../fish/guestfish-commands.pod:171 #, no-wrap msgid "" -" sparse filename size\n" +" setenv VAR value\n" "\n" msgstr "" #. type: textblock #: ../fish/guestfish-commands.pod:173 +msgid "Set the environment variable C to the string C." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-commands.pod:175 +msgid "To print the value of an environment variable use a shell command such as:" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-commands.pod:178 +#, no-wrap +msgid "" +" !echo $VAR\n" +"\n" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-commands.pod:180 +msgid "sparse" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-commands.pod:182 +#, no-wrap +msgid "" +" sparse filename size\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-commands.pod:184 msgid "" "This creates an empty sparse file of the given size, and then adds so it can " "be further examined." msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:176 +#: ../fish/guestfish-commands.pod:187 msgid "" "In all respects it works the same as the L command, except that the " "image file is allocated sparsely, which means that disk blocks are not " @@ -15322,12 +15357,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-commands.pod:186 +#: ../fish/guestfish-commands.pod:197 msgid "supported" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:188 +#: ../fish/guestfish-commands.pod:199 #, no-wrap msgid "" " supported\n" @@ -15335,7 +15370,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:190 +#: ../fish/guestfish-commands.pod:201 msgid "" "This command returns a list of the optional groups known to the daemon, and " "indicates which ones are supported by this build of the libguestfs " @@ -15343,17 +15378,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:194 +#: ../fish/guestfish-commands.pod:205 msgid "See also L." msgstr "" #. type: =head2 -#: ../fish/guestfish-commands.pod:196 +#: ../fish/guestfish-commands.pod:207 msgid "time" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:198 +#: ../fish/guestfish-commands.pod:209 #, no-wrap msgid "" " time command args...\n" @@ -15361,12 +15396,30 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:200 +#: ../fish/guestfish-commands.pod:211 msgid "" "Run the command as usual, but print the elapsed time afterwards. This can " "be useful for benchmarking operations." msgstr "" +#. type: =head2 +#: ../fish/guestfish-commands.pod:214 +msgid "unsetenv" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-commands.pod:216 +#, no-wrap +msgid "" +" unsetenv VAR\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-commands.pod:218 +msgid "Remove C from the environment." +msgstr "" + #. type: textblock #: ../fish/guestfish.pod:5 msgid "guestfish - the libguestfs Filesystem Interactive SHell" @@ -17687,7 +17740,7 @@ msgid "COMMANDS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1068 ../src/guestfs.pod:1474 +#: ../fish/guestfish.pod:1068 ../src/guestfs.pod:1475 msgid "@ACTIONS@" msgstr "" @@ -17716,87 +17769,107 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1084 +#: ../fish/guestfish.pod:1084 ../src/guestfs.pod:2970 +msgid "FEBOOTSTRAP_KERNEL" +msgstr "" + +#. type: =item +#: ../fish/guestfish.pod:1086 ../src/guestfs.pod:2972 +msgid "FEBOOTSTRAP_MODULES" +msgstr "" + +#. type: textblock +#: ../fish/guestfish.pod:1088 ../src/guestfs.pod:2974 +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 " +"most recent host kernel is chosen. For more information about kernel " +"selection, see L. This feature is only " +"available in febootstrap E 3.8." +msgstr "" + +#. type: =item +#: ../fish/guestfish.pod:1094 msgid "GUESTFISH_DISPLAY_IMAGE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1086 +#: ../fish/guestfish.pod:1096 msgid "" "The C command uses C<$GUESTFISH_DISPLAY_IMAGE> to display images. " "If not set, it uses L." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1089 +#: ../fish/guestfish.pod:1099 msgid "GUESTFISH_PID" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1091 +#: ../fish/guestfish.pod:1101 msgid "" "Used with the I<--remote> option to specify the remote guestfish process to " "control. See section L." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1095 +#: ../fish/guestfish.pod:1105 msgid "HEXEDITOR" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1097 +#: ../fish/guestfish.pod:1107 msgid "" "The L command uses C<$HEXEDITOR> as the external hex editor. If " "not specified, the external L program is used." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1101 +#: ../fish/guestfish.pod:1111 msgid "HOME" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1103 +#: ../fish/guestfish.pod:1113 msgid "" "If compiled with GNU readline support, various files in the home directory " "can be used. See L." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1106 ../src/guestfs.pod:2969 +#: ../fish/guestfish.pod:1116 ../src/guestfs.pod:2980 msgid "LIBGUESTFS_APPEND" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1108 ../src/guestfs.pod:2971 +#: ../fish/guestfish.pod:1118 ../src/guestfs.pod:2982 msgid "Pass additional options to the guest kernel." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1110 ../src/guestfs.pod:2973 +#: ../fish/guestfish.pod:1120 ../src/guestfs.pod:2984 msgid "LIBGUESTFS_DEBUG" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1112 +#: ../fish/guestfish.pod:1122 msgid "" "Set C to enable verbose messages. This has the same " "effect as using the B<-v> option." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1115 ../src/guestfs.pod:2978 +#: ../fish/guestfish.pod:1125 ../src/guestfs.pod:2989 msgid "LIBGUESTFS_MEMSIZE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1117 ../src/guestfs.pod:2980 +#: ../fish/guestfish.pod:1127 ../src/guestfs.pod:2991 msgid "Set the memory allocated to the qemu process, in megabytes. For example:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1120 ../src/guestfs.pod:2983 +#: ../fish/guestfish.pod:1130 ../src/guestfs.pod:2994 #, no-wrap msgid "" " LIBGUESTFS_MEMSIZE=700\n" @@ -17804,65 +17877,65 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1122 ../src/guestfs.pod:2985 +#: ../fish/guestfish.pod:1132 ../src/guestfs.pod:2996 msgid "LIBGUESTFS_PATH" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1124 +#: ../fish/guestfish.pod:1134 msgid "" "Set the path that guestfish uses to search for kernel and initrd.img. See " "the discussion of paths in L." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1127 ../src/guestfs.pod:2990 +#: ../fish/guestfish.pod:1137 ../src/guestfs.pod:3001 msgid "LIBGUESTFS_QEMU" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1129 ../src/guestfs.pod:2992 +#: ../fish/guestfish.pod:1139 ../src/guestfs.pod:3003 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:1133 ../src/guestfs.pod:2998 +#: ../fish/guestfish.pod:1143 ../src/guestfs.pod:3009 msgid "LIBGUESTFS_TRACE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1135 +#: ../fish/guestfish.pod:1145 msgid "Set C to enable command traces." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1137 +#: ../fish/guestfish.pod:1147 msgid "PAGER" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1139 +#: ../fish/guestfish.pod:1149 msgid "" "The C command uses C<$PAGER> as the pager. If not set, it uses " "C." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1142 ../src/guestfs.pod:3003 +#: ../fish/guestfish.pod:1152 ../src/guestfs.pod:3014 msgid "TMPDIR" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1144 ../src/guestfs.pod:3005 +#: ../fish/guestfish.pod:1154 ../src/guestfs.pod:3016 msgid "" "Location of temporary directory, defaults to C except for the cached " "supermin appliance which defaults to C." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1147 ../src/guestfs.pod:3008 +#: ../fish/guestfish.pod:1157 ../src/guestfs.pod:3019 msgid "" "If libguestfs was compiled to use the supermin appliance then the real " "appliance is cached in this directory, shared between all handles belonging " @@ -17871,56 +17944,56 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:1155 ../fuse/guestmount.pod:288 ../rescue/virt-rescue.pod:269 +#: ../fish/guestfish.pod:1165 ../fuse/guestmount.pod:288 ../rescue/virt-rescue.pod:269 msgid "FILES" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1159 ../fuse/guestmount.pod:292 ../rescue/virt-rescue.pod:273 +#: ../fish/guestfish.pod:1169 ../fuse/guestmount.pod:292 ../rescue/virt-rescue.pod:273 msgid "$HOME/.libguestfs-tools.rc" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1161 ../fuse/guestmount.pod:294 ../rescue/virt-rescue.pod:275 +#: ../fish/guestfish.pod:1171 ../fuse/guestmount.pod:294 ../rescue/virt-rescue.pod:275 msgid "/etc/libguestfs-tools.conf" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1163 ../fuse/guestmount.pod:296 ../rescue/virt-rescue.pod:277 +#: ../fish/guestfish.pod:1173 ../fuse/guestmount.pod:296 ../rescue/virt-rescue.pod:277 msgid "" "This configuration file controls the default read-only or read-write mode " "(I<--ro> or I<--rw>)." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1166 +#: ../fish/guestfish.pod:1176 msgid "See L." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1168 +#: ../fish/guestfish.pod:1178 msgid "$HOME/.guestfish" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1170 +#: ../fish/guestfish.pod:1180 msgid "" "If compiled with GNU readline support, then the command history is saved in " "this file." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1173 +#: ../fish/guestfish.pod:1183 msgid "$HOME/.inputrc" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1175 +#: ../fish/guestfish.pod:1185 msgid "/etc/inputrc" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1177 +#: ../fish/guestfish.pod:1187 msgid "" "If compiled with GNU readline support, then these files can be used to " "configure readline. For further information, please see " @@ -17928,12 +18001,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1181 +#: ../fish/guestfish.pod:1191 msgid "To write rules which only apply to guestfish, use:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1183 +#: ../fish/guestfish.pod:1193 #, no-wrap msgid "" " $if guestfish\n" @@ -17943,26 +18016,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1187 +#: ../fish/guestfish.pod:1197 msgid "" "Variables that you can set in inputrc that change the behaviour of guestfish " "in useful ways include:" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1192 +#: ../fish/guestfish.pod:1202 msgid "completion-ignore-case (default: on)" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1194 +#: ../fish/guestfish.pod:1204 msgid "" "By default, guestfish will ignore case when tab-completing paths on the " "disk. Use:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1197 +#: ../fish/guestfish.pod:1207 #, no-wrap msgid "" " set completion-ignore-case off\n" @@ -17970,22 +18043,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1199 +#: ../fish/guestfish.pod:1209 msgid "to make guestfish case sensitive." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1203 +#: ../fish/guestfish.pod:1213 msgid "test1.img" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1205 +#: ../fish/guestfish.pod:1215 msgid "test2.img (etc)" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1207 +#: ../fish/guestfish.pod:1217 msgid "" "When using the I<-N> or I<--new> option, the prepared disk or filesystem " "will be created in the file C in the current directory. The " @@ -17994,18 +18067,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1216 +#: ../fish/guestfish.pod:1226 msgid "" "L, L, L, " "L, L, L, L, " "L, L, L, " "L, L, L, " "L, L, L, L, " -"L, L, L, L." +"L, L, L, L, " +"L." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1244 ../src/guestfs.pod:3093 ../test-tool/libguestfs-test-tool.pod:99 +#: ../fish/guestfish.pod:1255 ../src/guestfs.pod:3105 ../test-tool/libguestfs-test-tool.pod:99 msgid "Copyright (C) 2009-2011 Red Hat Inc. L" msgstr "" @@ -20011,7 +20085,7 @@ msgid "" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:31 ../src/guestfs.pod:469 ../src/guestfs.pod:1257 ../src/guestfs.pod:1395 ../src/guestfs.pod:2465 +#: ../resize/virt-resize.pod:31 ../src/guestfs.pod:469 ../src/guestfs.pod:1257 ../src/guestfs.pod:1396 ../src/guestfs.pod:2466 msgid "1." msgstr "" @@ -20049,7 +20123,7 @@ msgid "" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:44 ../src/guestfs.pod:475 ../src/guestfs.pod:1261 ../src/guestfs.pod:1399 ../src/guestfs.pod:2490 +#: ../resize/virt-resize.pod:44 ../src/guestfs.pod:475 ../src/guestfs.pod:1261 ../src/guestfs.pod:1400 ../src/guestfs.pod:2491 msgid "2." msgstr "" @@ -20070,7 +20144,7 @@ msgid "" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:52 ../src/guestfs.pod:486 ../src/guestfs.pod:1405 +#: ../resize/virt-resize.pod:52 ../src/guestfs.pod:486 ../src/guestfs.pod:1406 msgid "3." msgstr "" @@ -21119,7 +21193,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:17 +#: ../src/guestfs-actions.pod:7 ../src/guestfs-actions.pod:249 ../src/guestfs-actions.pod:270 +msgid "" +"I In new code, use the " +"L call instead." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:24 msgid "" "This call checks for the existence of C. This stops you from " "specifying other types of drive which are supported by qemu such as C " @@ -21128,7 +21209,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:24 +#: ../src/guestfs-actions.pod:31 msgid "" "If you just want to add an ISO file (often you use this as an efficient way " "to transfer large files into the guest), then you should probably use " @@ -21136,7 +21217,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:140 ../src/guestfs-actions.pod:201 ../src/guestfs-actions.pod:238 ../src/guestfs-actions.pod:252 ../src/guestfs-actions.pod:273 ../src/guestfs-actions.pod:293 ../src/guestfs-actions.pod:307 ../src/guestfs-actions.pod:422 ../src/guestfs-actions.pod:442 ../src/guestfs-actions.pod:456 ../src/guestfs-actions.pod:501 ../src/guestfs-actions.pod:529 ../src/guestfs-actions.pod:547 ../src/guestfs-actions.pod:614 ../src/guestfs-actions.pod:647 ../src/guestfs-actions.pod:661 ../src/guestfs-actions.pod:676 ../src/guestfs-actions.pod:775 ../src/guestfs-actions.pod:793 ../src/guestfs-actions.pod:807 ../src/guestfs-actions.pod:821 ../src/guestfs-actions.pod:858 ../src/guestfs-actions.pod:1041 ../src/guestfs-actions.pod:1061 ../src/guestfs-actions.pod:1079 ../src/guestfs-actions.pod:1163 ../src/guestfs-actions.pod:1181 ../src/guestfs-actions.pod:1200 ../src/guestfs-actions.pod:1214 ../src/guestfs-actions.pod:1234 ../src/guestfs-actions.pod:1304 ../src/guestfs-actions.pod:1335 ../src/guestfs-actions.pod:1360 ../src/guestfs-actions.pod:1402 ../src/guestfs-actions.pod:1508 ../src/guestfs-actions.pod:1542 ../src/guestfs-actions.pod:1757 ../src/guestfs-actions.pod:1779 ../src/guestfs-actions.pod:1866 ../src/guestfs-actions.pod:2341 ../src/guestfs-actions.pod:2485 ../src/guestfs-actions.pod:2546 ../src/guestfs-actions.pod:2581 ../src/guestfs-actions.pod:3621 ../src/guestfs-actions.pod:3636 ../src/guestfs-actions.pod:3661 ../src/guestfs-actions.pod:3850 ../src/guestfs-actions.pod:3864 ../src/guestfs-actions.pod:3877 ../src/guestfs-actions.pod:3891 ../src/guestfs-actions.pod:3906 ../src/guestfs-actions.pod:3942 ../src/guestfs-actions.pod:4014 ../src/guestfs-actions.pod:4034 ../src/guestfs-actions.pod:4051 ../src/guestfs-actions.pod:4074 ../src/guestfs-actions.pod:4097 ../src/guestfs-actions.pod:4132 ../src/guestfs-actions.pod:4151 ../src/guestfs-actions.pod:4170 ../src/guestfs-actions.pod:4205 ../src/guestfs-actions.pod:4217 ../src/guestfs-actions.pod:4253 ../src/guestfs-actions.pod:4269 ../src/guestfs-actions.pod:4282 ../src/guestfs-actions.pod:4297 ../src/guestfs-actions.pod:4314 ../src/guestfs-actions.pod:4407 ../src/guestfs-actions.pod:4427 ../src/guestfs-actions.pod:4440 ../src/guestfs-actions.pod:4491 ../src/guestfs-actions.pod:4509 ../src/guestfs-actions.pod:4527 ../src/guestfs-actions.pod:4543 ../src/guestfs-actions.pod:4557 ../src/guestfs-actions.pod:4571 ../src/guestfs-actions.pod:4588 ../src/guestfs-actions.pod:4603 ../src/guestfs-actions.pod:4623 ../src/guestfs-actions.pod:4693 ../src/guestfs-actions.pod:4766 ../src/guestfs-actions.pod:4797 ../src/guestfs-actions.pod:4816 ../src/guestfs-actions.pod:4835 ../src/guestfs-actions.pod:4847 ../src/guestfs-actions.pod:4864 ../src/guestfs-actions.pod:4877 ../src/guestfs-actions.pod:4892 ../src/guestfs-actions.pod:4907 ../src/guestfs-actions.pod:4942 ../src/guestfs-actions.pod:4975 ../src/guestfs-actions.pod:5014 ../src/guestfs-actions.pod:5034 ../src/guestfs-actions.pod:5048 ../src/guestfs-actions.pod:5065 ../src/guestfs-actions.pod:5114 ../src/guestfs-actions.pod:5160 ../src/guestfs-actions.pod:5214 ../src/guestfs-actions.pod:5250 ../src/guestfs-actions.pod:5285 ../src/guestfs-actions.pod:5302 ../src/guestfs-actions.pod:5320 ../src/guestfs-actions.pod:5460 ../src/guestfs-actions.pod:5517 ../src/guestfs-actions.pod:5539 ../src/guestfs-actions.pod:5557 ../src/guestfs-actions.pod:5589 ../src/guestfs-actions.pod:5655 ../src/guestfs-actions.pod:5672 ../src/guestfs-actions.pod:5685 ../src/guestfs-actions.pod:5699 ../src/guestfs-actions.pod:5988 ../src/guestfs-actions.pod:6007 ../src/guestfs-actions.pod:6026 ../src/guestfs-actions.pod:6040 ../src/guestfs-actions.pod:6052 ../src/guestfs-actions.pod:6066 ../src/guestfs-actions.pod:6078 ../src/guestfs-actions.pod:6092 ../src/guestfs-actions.pod:6108 ../src/guestfs-actions.pod:6129 ../src/guestfs-actions.pod:6148 ../src/guestfs-actions.pod:6167 ../src/guestfs-actions.pod:6197 ../src/guestfs-actions.pod:6215 ../src/guestfs-actions.pod:6238 ../src/guestfs-actions.pod:6256 ../src/guestfs-actions.pod:6275 ../src/guestfs-actions.pod:6296 ../src/guestfs-actions.pod:6315 ../src/guestfs-actions.pod:6332 ../src/guestfs-actions.pod:6351 ../src/guestfs-actions.pod:6379 ../src/guestfs-actions.pod:6403 ../src/guestfs-actions.pod:6422 ../src/guestfs-actions.pod:6446 ../src/guestfs-actions.pod:6465 ../src/guestfs-actions.pod:6480 ../src/guestfs-actions.pod:6499 ../src/guestfs-actions.pod:6536 ../src/guestfs-actions.pod:6566 ../src/guestfs-actions.pod:6599 ../src/guestfs-actions.pod:6721 ../src/guestfs-actions.pod:6842 ../src/guestfs-actions.pod:6854 ../src/guestfs-actions.pod:6867 ../src/guestfs-actions.pod:6880 ../src/guestfs-actions.pod:6902 ../src/guestfs-actions.pod:6915 ../src/guestfs-actions.pod:6928 ../src/guestfs-actions.pod:6941 ../src/guestfs-actions.pod:6956 ../src/guestfs-actions.pod:7015 ../src/guestfs-actions.pod:7032 ../src/guestfs-actions.pod:7048 ../src/guestfs-actions.pod:7064 ../src/guestfs-actions.pod:7081 ../src/guestfs-actions.pod:7094 ../src/guestfs-actions.pod:7114 ../src/guestfs-actions.pod:7150 ../src/guestfs-actions.pod:7164 ../src/guestfs-actions.pod:7205 ../src/guestfs-actions.pod:7218 ../src/guestfs-actions.pod:7236 ../src/guestfs-actions.pod:7270 ../src/guestfs-actions.pod:7306 ../src/guestfs-actions.pod:7422 ../src/guestfs-actions.pod:7437 ../src/guestfs-actions.pod:7451 ../src/guestfs-actions.pod:7506 ../src/guestfs-actions.pod:7519 ../src/guestfs-actions.pod:7564 ../src/guestfs-actions.pod:7597 ../src/guestfs-actions.pod:7660 ../src/guestfs-actions.pod:7680 ../src/guestfs-actions.pod:7706 ../src/guestfs-actions.pod:7773 ../src/guestfs-actions.pod:7792 ../src/guestfs-actions.pod:7821 +#: ../src/guestfs-actions.pod:37 ../src/guestfs-actions.pod:140 ../src/guestfs-actions.pod:201 ../src/guestfs-actions.pod:238 ../src/guestfs-actions.pod:259 ../src/guestfs-actions.pod:280 ../src/guestfs-actions.pod:293 ../src/guestfs-actions.pod:307 ../src/guestfs-actions.pod:422 ../src/guestfs-actions.pod:442 ../src/guestfs-actions.pod:456 ../src/guestfs-actions.pod:501 ../src/guestfs-actions.pod:529 ../src/guestfs-actions.pod:547 ../src/guestfs-actions.pod:614 ../src/guestfs-actions.pod:647 ../src/guestfs-actions.pod:661 ../src/guestfs-actions.pod:676 ../src/guestfs-actions.pod:775 ../src/guestfs-actions.pod:793 ../src/guestfs-actions.pod:807 ../src/guestfs-actions.pod:821 ../src/guestfs-actions.pod:858 ../src/guestfs-actions.pod:1041 ../src/guestfs-actions.pod:1061 ../src/guestfs-actions.pod:1079 ../src/guestfs-actions.pod:1163 ../src/guestfs-actions.pod:1181 ../src/guestfs-actions.pod:1200 ../src/guestfs-actions.pod:1214 ../src/guestfs-actions.pod:1234 ../src/guestfs-actions.pod:1304 ../src/guestfs-actions.pod:1335 ../src/guestfs-actions.pod:1360 ../src/guestfs-actions.pod:1402 ../src/guestfs-actions.pod:1515 ../src/guestfs-actions.pod:1542 ../src/guestfs-actions.pod:1757 ../src/guestfs-actions.pod:1779 ../src/guestfs-actions.pod:1866 ../src/guestfs-actions.pod:2341 ../src/guestfs-actions.pod:2485 ../src/guestfs-actions.pod:2546 ../src/guestfs-actions.pod:2581 ../src/guestfs-actions.pod:3621 ../src/guestfs-actions.pod:3636 ../src/guestfs-actions.pod:3661 ../src/guestfs-actions.pod:3850 ../src/guestfs-actions.pod:3864 ../src/guestfs-actions.pod:3877 ../src/guestfs-actions.pod:3891 ../src/guestfs-actions.pod:3906 ../src/guestfs-actions.pod:3942 ../src/guestfs-actions.pod:4014 ../src/guestfs-actions.pod:4034 ../src/guestfs-actions.pod:4051 ../src/guestfs-actions.pod:4074 ../src/guestfs-actions.pod:4097 ../src/guestfs-actions.pod:4132 ../src/guestfs-actions.pod:4151 ../src/guestfs-actions.pod:4170 ../src/guestfs-actions.pod:4205 ../src/guestfs-actions.pod:4217 ../src/guestfs-actions.pod:4253 ../src/guestfs-actions.pod:4269 ../src/guestfs-actions.pod:4282 ../src/guestfs-actions.pod:4297 ../src/guestfs-actions.pod:4314 ../src/guestfs-actions.pod:4407 ../src/guestfs-actions.pod:4427 ../src/guestfs-actions.pod:4440 ../src/guestfs-actions.pod:4491 ../src/guestfs-actions.pod:4509 ../src/guestfs-actions.pod:4527 ../src/guestfs-actions.pod:4543 ../src/guestfs-actions.pod:4557 ../src/guestfs-actions.pod:4571 ../src/guestfs-actions.pod:4588 ../src/guestfs-actions.pod:4603 ../src/guestfs-actions.pod:4630 ../src/guestfs-actions.pod:4693 ../src/guestfs-actions.pod:4766 ../src/guestfs-actions.pod:4797 ../src/guestfs-actions.pod:4816 ../src/guestfs-actions.pod:4835 ../src/guestfs-actions.pod:4847 ../src/guestfs-actions.pod:4864 ../src/guestfs-actions.pod:4877 ../src/guestfs-actions.pod:4892 ../src/guestfs-actions.pod:4907 ../src/guestfs-actions.pod:4949 ../src/guestfs-actions.pod:4975 ../src/guestfs-actions.pod:5014 ../src/guestfs-actions.pod:5034 ../src/guestfs-actions.pod:5048 ../src/guestfs-actions.pod:5065 ../src/guestfs-actions.pod:5114 ../src/guestfs-actions.pod:5167 ../src/guestfs-actions.pod:5214 ../src/guestfs-actions.pod:5257 ../src/guestfs-actions.pod:5285 ../src/guestfs-actions.pod:5302 ../src/guestfs-actions.pod:5320 ../src/guestfs-actions.pod:5460 ../src/guestfs-actions.pod:5517 ../src/guestfs-actions.pod:5539 ../src/guestfs-actions.pod:5557 ../src/guestfs-actions.pod:5589 ../src/guestfs-actions.pod:5655 ../src/guestfs-actions.pod:5672 ../src/guestfs-actions.pod:5685 ../src/guestfs-actions.pod:5699 ../src/guestfs-actions.pod:5988 ../src/guestfs-actions.pod:6007 ../src/guestfs-actions.pod:6026 ../src/guestfs-actions.pod:6040 ../src/guestfs-actions.pod:6052 ../src/guestfs-actions.pod:6066 ../src/guestfs-actions.pod:6078 ../src/guestfs-actions.pod:6092 ../src/guestfs-actions.pod:6108 ../src/guestfs-actions.pod:6129 ../src/guestfs-actions.pod:6148 ../src/guestfs-actions.pod:6167 ../src/guestfs-actions.pod:6197 ../src/guestfs-actions.pod:6215 ../src/guestfs-actions.pod:6238 ../src/guestfs-actions.pod:6256 ../src/guestfs-actions.pod:6275 ../src/guestfs-actions.pod:6296 ../src/guestfs-actions.pod:6315 ../src/guestfs-actions.pod:6332 ../src/guestfs-actions.pod:6351 ../src/guestfs-actions.pod:6379 ../src/guestfs-actions.pod:6403 ../src/guestfs-actions.pod:6422 ../src/guestfs-actions.pod:6446 ../src/guestfs-actions.pod:6465 ../src/guestfs-actions.pod:6480 ../src/guestfs-actions.pod:6499 ../src/guestfs-actions.pod:6543 ../src/guestfs-actions.pod:6573 ../src/guestfs-actions.pod:6606 ../src/guestfs-actions.pod:6721 ../src/guestfs-actions.pod:6842 ../src/guestfs-actions.pod:6854 ../src/guestfs-actions.pod:6867 ../src/guestfs-actions.pod:6880 ../src/guestfs-actions.pod:6902 ../src/guestfs-actions.pod:6915 ../src/guestfs-actions.pod:6928 ../src/guestfs-actions.pod:6941 ../src/guestfs-actions.pod:6956 ../src/guestfs-actions.pod:7015 ../src/guestfs-actions.pod:7032 ../src/guestfs-actions.pod:7048 ../src/guestfs-actions.pod:7064 ../src/guestfs-actions.pod:7081 ../src/guestfs-actions.pod:7094 ../src/guestfs-actions.pod:7114 ../src/guestfs-actions.pod:7150 ../src/guestfs-actions.pod:7164 ../src/guestfs-actions.pod:7205 ../src/guestfs-actions.pod:7218 ../src/guestfs-actions.pod:7236 ../src/guestfs-actions.pod:7270 ../src/guestfs-actions.pod:7306 ../src/guestfs-actions.pod:7422 ../src/guestfs-actions.pod:7437 ../src/guestfs-actions.pod:7451 ../src/guestfs-actions.pod:7506 ../src/guestfs-actions.pod:7519 ../src/guestfs-actions.pod:7564 ../src/guestfs-actions.pod:7604 ../src/guestfs-actions.pod:7660 ../src/guestfs-actions.pod:7680 ../src/guestfs-actions.pod:7713 ../src/guestfs-actions.pod:7773 ../src/guestfs-actions.pod:7792 ../src/guestfs-actions.pod:7821 msgid "This function returns 0 on success or -1 on error." msgstr "" @@ -21421,7 +21502,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:249 +#: ../src/guestfs-actions.pod:256 msgid "" "This is the same as C but it allows you to specify the " "QEMU interface emulation to use at run time." @@ -21449,7 +21530,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:270 +#: ../src/guestfs-actions.pod:277 msgid "" "This is the same as C but it allows you to specify the " "QEMU interface emulation to use at run time." @@ -21566,7 +21647,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:363 ../src/guestfs-actions.pod:922 ../src/guestfs-actions.pod:940 ../src/guestfs-actions.pod:1000 ../src/guestfs-actions.pod:1016 ../src/guestfs-actions.pod:1119 ../src/guestfs-actions.pod:1249 ../src/guestfs-actions.pod:1266 ../src/guestfs-actions.pod:1285 ../src/guestfs-actions.pod:1419 ../src/guestfs-actions.pod:1607 ../src/guestfs-actions.pod:1719 ../src/guestfs-actions.pod:1882 ../src/guestfs-actions.pod:1899 ../src/guestfs-actions.pod:1966 ../src/guestfs-actions.pod:2002 ../src/guestfs-actions.pod:2023 ../src/guestfs-actions.pod:2204 ../src/guestfs-actions.pod:2396 ../src/guestfs-actions.pod:2600 ../src/guestfs-actions.pod:2690 ../src/guestfs-actions.pod:2794 ../src/guestfs-actions.pod:2813 ../src/guestfs-actions.pod:3027 ../src/guestfs-actions.pod:3055 ../src/guestfs-actions.pod:3076 ../src/guestfs-actions.pod:3110 ../src/guestfs-actions.pod:3169 ../src/guestfs-actions.pod:3189 ../src/guestfs-actions.pod:3209 ../src/guestfs-actions.pod:3836 ../src/guestfs-actions.pod:4189 ../src/guestfs-actions.pod:4359 ../src/guestfs-actions.pod:4469 ../src/guestfs-actions.pod:5375 ../src/guestfs-actions.pod:5574 ../src/guestfs-actions.pod:5744 ../src/guestfs-actions.pod:5922 ../src/guestfs-actions.pod:5971 ../src/guestfs-actions.pod:6627 ../src/guestfs-actions.pod:6643 ../src/guestfs-actions.pod:6660 ../src/guestfs-actions.pod:6691 ../src/guestfs-actions.pod:7365 ../src/guestfs-actions.pod:7384 ../src/guestfs-actions.pod:7402 ../src/guestfs-actions.pod:7576 ../src/guestfs-actions.pod:7878 +#: ../src/guestfs-actions.pod:363 ../src/guestfs-actions.pod:922 ../src/guestfs-actions.pod:940 ../src/guestfs-actions.pod:1000 ../src/guestfs-actions.pod:1016 ../src/guestfs-actions.pod:1119 ../src/guestfs-actions.pod:1249 ../src/guestfs-actions.pod:1266 ../src/guestfs-actions.pod:1285 ../src/guestfs-actions.pod:1419 ../src/guestfs-actions.pod:1607 ../src/guestfs-actions.pod:1719 ../src/guestfs-actions.pod:1882 ../src/guestfs-actions.pod:1899 ../src/guestfs-actions.pod:1966 ../src/guestfs-actions.pod:2009 ../src/guestfs-actions.pod:2030 ../src/guestfs-actions.pod:2204 ../src/guestfs-actions.pod:2396 ../src/guestfs-actions.pod:2600 ../src/guestfs-actions.pod:2690 ../src/guestfs-actions.pod:2794 ../src/guestfs-actions.pod:2813 ../src/guestfs-actions.pod:3027 ../src/guestfs-actions.pod:3055 ../src/guestfs-actions.pod:3076 ../src/guestfs-actions.pod:3110 ../src/guestfs-actions.pod:3169 ../src/guestfs-actions.pod:3189 ../src/guestfs-actions.pod:3209 ../src/guestfs-actions.pod:3836 ../src/guestfs-actions.pod:4189 ../src/guestfs-actions.pod:4359 ../src/guestfs-actions.pod:4469 ../src/guestfs-actions.pod:5375 ../src/guestfs-actions.pod:5574 ../src/guestfs-actions.pod:5744 ../src/guestfs-actions.pod:5922 ../src/guestfs-actions.pod:5971 ../src/guestfs-actions.pod:6627 ../src/guestfs-actions.pod:6643 ../src/guestfs-actions.pod:6667 ../src/guestfs-actions.pod:6691 ../src/guestfs-actions.pod:7365 ../src/guestfs-actions.pod:7384 ../src/guestfs-actions.pod:7402 ../src/guestfs-actions.pod:7576 ../src/guestfs-actions.pod:7885 msgid "" "This function returns a string, or NULL on error. I." @@ -22756,6 +22837,13 @@ msgid "" "\n" msgstr "" +#. type: textblock +#: ../src/guestfs-actions.pod:1500 +msgid "" +"I In new code, use the L " +"call instead." +msgstr "" + #. type: =head2 #: ../src/guestfs-actions.pod:1519 msgid "guestfs_fallocate64" @@ -23174,6 +23262,13 @@ msgid "" msgstr "" #. type: textblock +#: ../src/guestfs-actions.pod:1999 +msgid "" +"I In new code, use the L " +"call instead." +msgstr "" + +#. type: textblock #: ../src/guestfs-actions.pod:2012 ../src/guestfs-actions.pod:2033 ../src/guestfs-actions.pod:6258 ../src/guestfs-actions.pod:6277 msgid "(Added in 1.0.15)" msgstr "" @@ -23193,6 +23288,13 @@ msgid "" "\n" msgstr "" +#. type: textblock +#: ../src/guestfs-actions.pod:2020 +msgid "" +"I In new code, use the L " +"call instead." +msgstr "" + #. type: =head2 #: ../src/guestfs-actions.pod:2035 msgid "guestfs_get_memsize" @@ -25786,6 +25888,13 @@ msgstr "" #. type: textblock #: ../src/guestfs-actions.pod:4615 msgid "" +"I In new code, use the L " +"call instead." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:4622 +msgid "" "This call is similar to C, but it allows you to control the " "block size of the resulting filesystem. Supported block sizes depend on the " "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only." @@ -26103,7 +26212,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4932 +#: ../src/guestfs-actions.pod:4918 +msgid "" +"I In new code, use the " +"L call instead." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:4939 msgid "" "B When you use this call, the filesystem options C " "and C are set implicitly. This was originally done because we " @@ -26370,6 +26486,13 @@ msgid "" "\n" msgstr "" +#. type: textblock +#: ../src/guestfs-actions.pod:5147 ../src/guestfs-actions.pod:5247 +msgid "" +"I In new code, use the " +"L call instead." +msgstr "" + #. type: =head2 #: ../src/guestfs-actions.pod:5171 msgid "guestfs_ntfsresize_opts" @@ -26466,7 +26589,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5247 +#: ../src/guestfs-actions.pod:5254 msgid "" "This command is the same as C except that it allows you " "to specify the new size (in bytes) explicitly." @@ -27702,7 +27825,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6533 +#: ../src/guestfs-actions.pod:6513 ../src/guestfs-actions.pod:6557 ../src/guestfs-actions.pod:6591 +msgid "" +"I In new code, use the L " +"call instead." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:6540 msgid "See also: C, C, C" msgstr "" @@ -27723,7 +27853,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6557 +#: ../src/guestfs-actions.pod:6564 msgid "" "This is a simplified interface to the C command, where " "partition sizes are specified in megabytes only (rounded to the nearest " @@ -27732,7 +27862,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6563 +#: ../src/guestfs-actions.pod:6570 msgid "" "See also: C, the L manpage and " "C" @@ -27759,14 +27889,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6594 +#: ../src/guestfs-actions.pod:6601 msgid "" "For other parameters, see C. You should usually pass C<0> " "for the cyls/heads/sectors parameters." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6597 +#: ../src/guestfs-actions.pod:6604 msgid "See also: C" msgstr "" @@ -27825,7 +27955,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6658 +#: ../src/guestfs-actions.pod:6654 +msgid "" +"I In new code, use the L " +"call instead." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:6665 msgid "See also: C" msgstr "" @@ -28811,11 +28948,18 @@ msgstr "" #. type: textblock #: ../src/guestfs-actions.pod:7586 +msgid "" +"I In new code, use the L call " +"instead." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:7593 msgid "This function is a no op." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7588 +#: ../src/guestfs-actions.pod:7595 msgid "" "In versions of the API E 1.0.71 you had to call this function just after " "calling C to wait for the launch to complete. However this " @@ -28823,17 +28967,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7593 +#: ../src/guestfs-actions.pod:7600 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: textblock -#: ../src/guestfs-actions.pod:7599 -msgid "This function is deprecated. In new code, use the C call instead." -msgstr "" - #. type: =head2 #: ../src/guestfs-actions.pod:7608 msgid "guestfs_wc_c" @@ -28940,6 +29079,13 @@ msgid "" "\n" msgstr "" +#. type: textblock +#: ../src/guestfs-actions.pod:7695 +msgid "" +"I In new code, use the L call " +"instead." +msgstr "" + #. type: =head2 #: ../src/guestfs-actions.pod:7720 msgid "guestfs_zegrep" @@ -29085,7 +29231,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7875 +#: ../src/guestfs-actions.pod:7870 +msgid "" +"I In new code, use the L call " +"instead." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:7882 msgid "" "Since 1.0.63, use C instead which can now process compressed " "files." @@ -32352,14 +32505,6 @@ msgstr "" #: ../src/guestfs.pod:1347 #, no-wrap msgid "" -" g = guestfs_create ();\n" -" \n" -msgstr "" - -#. type: verbatim -#: ../src/guestfs.pod:1349 -#, no-wrap -msgid "" " /* This disables the default behaviour of printing errors\n" " on stderr. */\n" " guestfs_set_error_handler (g, NULL, NULL);\n" @@ -32367,21 +32512,24 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1353 +#: ../src/guestfs.pod:1351 #, no-wrap msgid "" " if (guestfs_launch (g) == -1) {\n" " /* Examine the error message and print it etc. */\n" " char *msg = guestfs_last_error (g);\n" " int errnum = guestfs_last_errno (g);\n" -" fprintf (stderr, \"%s\\n\", msg);\n" +" fprintf (stderr, \"%s\", msg);\n" +" if (errnum != 0)\n" +" fprintf (stderr, \": %s\", strerror (errnum));\n" +" fprintf (stderr, \"\\n\");\n" " /* ... */\n" -" }\n" +" }\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1361 +#: ../src/guestfs.pod:1362 msgid "" "Out of memory errors are handled differently. The default action is to call " "L. If this is undesirable, then you can set a handler using " @@ -32389,7 +32537,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1365 +#: ../src/guestfs.pod:1366 msgid "" "L returns C if the handle cannot be created, and " "because there is no handle if this happens there is no way to get additional " @@ -32399,12 +32547,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1371 +#: ../src/guestfs.pod:1372 msgid "guestfs_last_error" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1373 +#: ../src/guestfs.pod:1374 #, no-wrap msgid "" " const char *guestfs_last_error (guestfs_h *g);\n" @@ -32412,26 +32560,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1375 +#: ../src/guestfs.pod:1376 msgid "" "This returns the last error message that happened on C. If there has not " "been an error since the handle was created, then this returns C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1379 +#: ../src/guestfs.pod:1380 msgid "" "The lifetime of the returned string is until the next error occurs, or " "L is called." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1382 +#: ../src/guestfs.pod:1383 msgid "guestfs_last_errno" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1384 +#: ../src/guestfs.pod:1385 #, no-wrap msgid "" " int guestfs_last_errno (guestfs_h *g);\n" @@ -32439,27 +32587,27 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1386 +#: ../src/guestfs.pod:1387 msgid "This returns the last error number (errno) that happened on C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1388 +#: ../src/guestfs.pod:1389 msgid "If successful, an errno integer not equal to zero is returned." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1390 +#: ../src/guestfs.pod:1391 msgid "If no error, this returns 0. This call can return 0 in three situations:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1397 +#: ../src/guestfs.pod:1398 msgid "There has not been any error on the handle." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1401 +#: ../src/guestfs.pod:1402 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 " @@ -32467,14 +32615,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1407 +#: ../src/guestfs.pod:1408 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:1413 +#: ../src/guestfs.pod:1414 msgid "" "Libguestfs tries to convert the errno from inside the applicance into a " "corresponding errno for the caller (not entirely trivial: the appliance " @@ -32485,12 +32633,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1421 +#: ../src/guestfs.pod:1422 msgid "guestfs_set_error_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1423 +#: ../src/guestfs.pod:1424 #, no-wrap msgid "" " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n" @@ -32503,7 +32651,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1430 +#: ../src/guestfs.pod:1431 msgid "" "The callback C will be called if there is an error. The parameters " "passed to the callback are an opaque data pointer and the error message " @@ -32511,14 +32659,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1434 +#: ../src/guestfs.pod:1435 msgid "" "C is not passed to the callback. To get that the callback must call " "L." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1437 +#: ../src/guestfs.pod:1438 msgid "" "Note that the message string C is freed as soon as the callback " "function returns, so if you want to stash it somewhere you must make your " @@ -32526,22 +32674,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1441 +#: ../src/guestfs.pod:1442 msgid "The default handler prints messages on C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1443 +#: ../src/guestfs.pod:1444 msgid "If you set C to C then I handler is called." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1445 +#: ../src/guestfs.pod:1446 msgid "guestfs_get_error_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1447 +#: ../src/guestfs.pod:1448 #, no-wrap msgid "" " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n" @@ -32550,49 +32698,49 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1450 +#: ../src/guestfs.pod:1451 msgid "Returns the current error handler callback." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1452 +#: ../src/guestfs.pod:1453 msgid "guestfs_set_out_of_memory_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1454 +#: ../src/guestfs.pod:1455 #, no-wrap msgid "" " typedef void (*guestfs_abort_cb) (void);\n" -" int guestfs_set_out_of_memory_handler (guestfs_h *g,\n" -" guestfs_abort_cb);\n" +" void guestfs_set_out_of_memory_handler (guestfs_h *g,\n" +" guestfs_abort_cb);\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1458 +#: ../src/guestfs.pod:1459 msgid "" "The callback C will be called if there is an out of memory situation. " "I." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1461 +#: ../src/guestfs.pod:1462 msgid "The default is to call L." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1463 +#: ../src/guestfs.pod:1464 msgid "You cannot set C to C. You can't ignore out of memory situations." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1466 +#: ../src/guestfs.pod:1467 msgid "guestfs_get_out_of_memory_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1468 +#: ../src/guestfs.pod:1469 #, no-wrap msgid "" " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n" @@ -32600,37 +32748,37 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1470 +#: ../src/guestfs.pod:1471 msgid "This returns the current out of memory handler." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1472 +#: ../src/guestfs.pod:1473 msgid "API CALLS" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1476 +#: ../src/guestfs.pod:1477 msgid "STRUCTURES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1478 +#: ../src/guestfs.pod:1479 msgid "@STRUCTS@" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1480 +#: ../src/guestfs.pod:1481 msgid "AVAILABILITY" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1482 +#: ../src/guestfs.pod:1483 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1484 +#: ../src/guestfs.pod:1485 msgid "" "Using L you can test availability of the following " "groups of functions. This test queries the appliance to see if the " @@ -32638,17 +32786,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1489 +#: ../src/guestfs.pod:1490 msgid "@AVAILABILITY@" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1491 +#: ../src/guestfs.pod:1492 msgid "GUESTFISH supported COMMAND" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1493 +#: ../src/guestfs.pod:1494 msgid "" "In L there is a handy interactive command C which " "prints out the available groups and whether they are supported by this build " @@ -32656,19 +32804,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1498 +#: ../src/guestfs.pod:1499 msgid "SINGLE CALLS AT COMPILE TIME" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1500 +#: ../src/guestfs.pod:1501 msgid "" "Since version 1.5.8, Cguestfs.hE> defines symbols for each C API " "function, such as:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1503 +#: ../src/guestfs.pod:1504 #, no-wrap msgid "" " #define LIBGUESTFS_HAVE_DD 1\n" @@ -32676,12 +32824,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1505 +#: ../src/guestfs.pod:1506 msgid "if L is available." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1507 +#: ../src/guestfs.pod:1508 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 " @@ -32689,7 +32837,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1512 +#: ../src/guestfs.pod:1513 #, no-wrap msgid "" " AC_CHECK_LIB([guestfs],[guestfs_create])\n" @@ -32698,19 +32846,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1515 +#: ../src/guestfs.pod:1516 msgid "" "which would result in C being either defined or not defined " "in your program." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1518 +#: ../src/guestfs.pod:1519 msgid "SINGLE CALLS AT RUN TIME" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1520 +#: ../src/guestfs.pod:1521 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 " @@ -32720,7 +32868,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1527 +#: ../src/guestfs.pod:1528 msgid "" "You can use L 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 " @@ -32728,7 +32876,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1531 +#: ../src/guestfs.pod:1532 #, no-wrap msgid "" " #include \n" @@ -32740,7 +32888,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1537 +#: ../src/guestfs.pod:1538 #, no-wrap msgid "" " main ()\n" @@ -32752,7 +32900,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1543 +#: ../src/guestfs.pod:1544 #, no-wrap msgid "" " /* Test if the function guestfs_dd is really available. */\n" @@ -32767,7 +32915,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1552 +#: ../src/guestfs.pod:1553 #, no-wrap msgid "" " if (!has_function)\n" @@ -32786,7 +32934,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1565 +#: ../src/guestfs.pod:1566 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 " @@ -32794,7 +32942,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1570 +#: ../src/guestfs.pod:1571 #, no-wrap msgid "" " Requires: libguestfs >= 1.0.80\n" @@ -32802,12 +32950,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1572 +#: ../src/guestfs.pod:1573 msgid "CALLS WITH OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1574 +#: ../src/guestfs.pod:1575 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 " @@ -32815,7 +32963,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1579 +#: ../src/guestfs.pod:1580 #, no-wrap msgid "" " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n" @@ -32823,14 +32971,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1581 +#: ../src/guestfs.pod:1582 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:1584 +#: ../src/guestfs.pod:1585 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename, -1);\n" @@ -32838,12 +32986,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1586 +#: ../src/guestfs.pod:1587 msgid "With a single optional argument:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1588 +#: ../src/guestfs.pod:1589 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -32853,12 +33001,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1592 +#: ../src/guestfs.pod:1593 msgid "With two:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1594 +#: ../src/guestfs.pod:1595 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -32869,19 +33017,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1599 +#: ../src/guestfs.pod:1600 msgid "" "and so forth. Don't forget the terminating C<-1> otherwise Bad Things will " "happen!" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1602 +#: ../src/guestfs.pod:1603 msgid "USING va_list FOR OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1604 +#: ../src/guestfs.pod:1605 msgid "" "The second variant has the same name with the suffix C<_va>, which works the " "same way but takes a C. See the C manual for details. For the " @@ -32889,7 +33037,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1608 +#: ../src/guestfs.pod:1609 #, no-wrap msgid "" " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n" @@ -32898,12 +33046,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1611 +#: ../src/guestfs.pod:1612 msgid "CONSTRUCTING OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1613 +#: ../src/guestfs.pod:1614 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 " @@ -32913,7 +33061,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1619 +#: ../src/guestfs.pod:1620 #, no-wrap msgid "" " struct guestfs_add_drive_opts_argv {\n" @@ -32928,12 +33076,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1628 +#: ../src/guestfs.pod:1629 msgid "You could call it like this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1630 +#: ../src/guestfs.pod:1631 #, no-wrap msgid "" " struct guestfs_add_drive_opts_argv optargs = {\n" @@ -32946,7 +33094,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1637 +#: ../src/guestfs.pod:1638 #, no-wrap msgid "" " guestfs_add_drive_opts_argv (g, filename, &optargs);\n" @@ -32954,29 +33102,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1645 +#: ../src/guestfs.pod:1646 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1650 +#: ../src/guestfs.pod:1651 msgid "You do not need to fill in all fields of the structure." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1654 +#: ../src/guestfs.pod:1655 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:1659 +#: ../src/guestfs.pod:1660 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1661 +#: ../src/guestfs.pod:1662 msgid "" "In other languages, optional arguments are expressed in the way that is " "natural for that language. We refer you to the language-specific " @@ -32984,17 +33132,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1665 +#: ../src/guestfs.pod:1666 msgid "For guestfish, see L." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1667 +#: ../src/guestfs.pod:1668 msgid "SETTING CALLBACKS TO HANDLE EVENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1669 +#: ../src/guestfs.pod:1670 msgid "" "B This section documents the generic event mechanism introduced in " "libguestfs 1.10, which you should use in new code if possible. The old " @@ -33006,7 +33154,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1678 +#: ../src/guestfs.pod:1679 msgid "" "Handles generate events when certain things happen, such as log messages " "being generated, progress messages during long-running operations, or the " @@ -33018,7 +33166,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1686 +#: ../src/guestfs.pod:1687 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 " @@ -33027,31 +33175,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1691 +#: ../src/guestfs.pod:1692 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:1695 +#: ../src/guestfs.pod:1696 msgid "CLASSES OF EVENTS" msgstr "" #. type: =item -#: ../src/guestfs.pod:1699 +#: ../src/guestfs.pod:1700 msgid "GUESTFS_EVENT_CLOSE (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1702 +#: ../src/guestfs.pod:1703 msgid "" "The callback function will be called while the handle is being closed " "(synchronously from L)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1705 +#: ../src/guestfs.pod:1706 msgid "" "Note that libguestfs installs an L handler to try to clean up " "handles that are open when the program exits. This means that this callback " @@ -33062,19 +33210,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1712 +#: ../src/guestfs.pod:1713 msgid "" "If no callback is registered: the handle is closed without any callback " "being invoked." msgstr "" #. type: =item -#: ../src/guestfs.pod:1715 +#: ../src/guestfs.pod:1716 msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1718 +#: ../src/guestfs.pod:1719 msgid "" "The callback function will be called when the child process quits, either " "asynchronously or if killed by L. (This " @@ -33082,17 +33230,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1722 ../src/guestfs.pod:1731 +#: ../src/guestfs.pod:1723 ../src/guestfs.pod:1732 msgid "If no callback is registered: the event is ignored." msgstr "" #. type: =item -#: ../src/guestfs.pod:1724 +#: ../src/guestfs.pod:1725 msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1727 +#: ../src/guestfs.pod:1728 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 " @@ -33100,12 +33248,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:1733 +#: ../src/guestfs.pod:1734 msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1736 +#: ../src/guestfs.pod:1737 msgid "" "Some long-running operations can generate progress messages. If this " "callback is registered, then it will be called each time a progress message " @@ -33115,14 +33263,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1742 +#: ../src/guestfs.pod:1743 msgid "" "The callback receives in the payload four unsigned 64 bit numbers which are " "(in order): C, C, C, C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1745 +#: ../src/guestfs.pod:1746 msgid "" "The units of C are not defined, although for some operations C " "may relate in some way to the amount of data to be transferred (eg. in bytes " @@ -33131,24 +33279,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1750 +#: ../src/guestfs.pod:1751 msgid "The only defined and stable parts of the API are:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1756 +#: ../src/guestfs.pod:1757 msgid "" "The callback can display to the user some type of progress bar or indicator " "which shows the ratio of C:C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1761 +#: ../src/guestfs.pod:1762 msgid "0 E= C E= C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1765 +#: ../src/guestfs.pod:1766 msgid "" "If any progress notification is sent during a call, then a final progress " "notification is always sent when C = C (I the call " @@ -33156,7 +33304,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1769 +#: ../src/guestfs.pod:1770 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 " @@ -33164,7 +33312,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1775 +#: ../src/guestfs.pod:1776 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 " @@ -33173,7 +33321,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1780 +#: ../src/guestfs.pod:1781 msgid "" "For these calls, zero or more progress messages are generated with " "C and C, followed by a final message with " @@ -33181,14 +33329,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1784 +#: ../src/guestfs.pod:1785 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:1789 +#: ../src/guestfs.pod:1790 msgid "" "The callback also receives the procedure number (C) and serial " "number (C) of the call. These are only useful for debugging " @@ -33197,31 +33345,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1795 +#: ../src/guestfs.pod:1796 msgid "If no callback is registered: progress messages are discarded." msgstr "" #. type: =item -#: ../src/guestfs.pod:1797 +#: ../src/guestfs.pod:1798 msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1800 +#: ../src/guestfs.pod:1801 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:1803 +#: ../src/guestfs.pod:1804 msgid "" "If the verbose flag (L) is set before launch " "(L) then additional debug messages are generated." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1806 ../src/guestfs.pod:1820 +#: ../src/guestfs.pod:1807 ../src/guestfs.pod:1821 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 " @@ -33229,50 +33377,50 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:1811 +#: ../src/guestfs.pod:1812 msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1814 +#: ../src/guestfs.pod:1815 msgid "" "The callback function is called whenever a log message is generated by the " "library part of libguestfs." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1817 +#: ../src/guestfs.pod:1818 msgid "" "If the verbose flag (L) is set then additional debug " "messages are generated." msgstr "" #. type: =item -#: ../src/guestfs.pod:1825 +#: ../src/guestfs.pod:1826 msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1828 +#: ../src/guestfs.pod:1829 msgid "" "The callback function is called whenever a trace message is generated. This " "only applies if the trace flag (L) is set." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1831 +#: ../src/guestfs.pod:1832 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: =head3 -#: ../src/guestfs.pod:1837 +#: ../src/guestfs.pod:1838 msgid "guestfs_set_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1839 +#: ../src/guestfs.pod:1840 #, no-wrap msgid "" " int guestfs_set_event_callback (guestfs_h *g,\n" @@ -33284,14 +33432,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1845 +#: ../src/guestfs.pod:1846 msgid "" "This function registers a callback (C) for all event classes in the " "C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1848 +#: ../src/guestfs.pod:1849 msgid "" "For example, to register for all log message events, you could call this " "function with the bitmask C. " @@ -33300,40 +33448,40 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1854 +#: ../src/guestfs.pod:1855 msgid "C should always be passed as 0." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1856 +#: ../src/guestfs.pod:1857 msgid "" "C is an opaque pointer which is passed to the callback. You can use " "it for any purpose." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1859 +#: ../src/guestfs.pod:1860 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:1862 +#: ../src/guestfs.pod:1863 msgid "" "If there is an error, this function returns C<-1>, and sets the error in the " "handle in the usual way (see L etc.)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1865 +#: ../src/guestfs.pod:1866 msgid "" "Callbacks remain in effect until they are deleted, or until the handle is " "closed." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1868 +#: ../src/guestfs.pod:1869 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 " @@ -33341,12 +33489,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1872 +#: ../src/guestfs.pod:1873 msgid "guestfs_delete_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1874 +#: ../src/guestfs.pod:1875 #, no-wrap msgid "" " void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n" @@ -33354,7 +33502,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1876 +#: ../src/guestfs.pod:1877 msgid "" "Delete a callback that was previously registered. C should be " "the integer that was returned by a previous call to " @@ -33362,12 +33510,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1880 +#: ../src/guestfs.pod:1881 msgid "guestfs_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1882 +#: ../src/guestfs.pod:1883 #, no-wrap msgid "" " typedef void (*guestfs_event_callback) (\n" @@ -33382,12 +33530,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1891 +#: ../src/guestfs.pod:1892 msgid "This is the type of the event callback function that you have to provide." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1894 +#: ../src/guestfs.pod:1895 msgid "" "The basic parameters are: the handle (C), the opaque user pointer " "(C), the event class (eg. C), the event " @@ -33395,7 +33543,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1898 +#: ../src/guestfs.pod:1899 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 " @@ -33404,7 +33552,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1903 +#: ../src/guestfs.pod:1904 msgid "" "C and C contain a message buffer (if C, then " "there is no message buffer). Note that this message buffer can contain " @@ -33412,19 +33560,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1907 +#: ../src/guestfs.pod:1908 msgid "" "C and C is an array of 64 bit unsigned integers. At the " "moment this is only used for progress messages." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1910 +#: ../src/guestfs.pod:1911 msgid "EXAMPLE: CAPTURING LOG MESSAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1912 +#: ../src/guestfs.pod:1913 msgid "" "One motivation for the generic event API was to allow GUI programs to " "capture debug and other messages. In libguestfs E 1.8 these were sent " @@ -33432,7 +33580,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1916 +#: ../src/guestfs.pod:1917 msgid "" "Events associated with log messages are: C, " "C and C. (Note that error " @@ -33440,14 +33588,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1921 +#: ../src/guestfs.pod:1922 msgid "" "Programs have to set up a callback to capture the classes of events of " "interest:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1924 +#: ../src/guestfs.pod:1925 #, no-wrap msgid "" " int eh =\n" @@ -33463,14 +33611,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1934 +#: ../src/guestfs.pod:1935 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:1937 +#: ../src/guestfs.pod:1938 #, no-wrap msgid "" " static void\n" @@ -33491,12 +33639,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1952 +#: ../src/guestfs.pod:1953 msgid "CANCELLING LONG TRANSFERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1954 +#: ../src/guestfs.pod:1955 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 " @@ -33505,12 +33653,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1959 +#: ../src/guestfs.pod:1960 msgid "guestfs_user_cancel" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1961 +#: ../src/guestfs.pod:1962 #, no-wrap msgid "" " void guestfs_user_cancel (guestfs_h *g);\n" @@ -33518,12 +33666,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1963 +#: ../src/guestfs.pod:1964 msgid "C cancels the current upload or download operation." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1966 +#: ../src/guestfs.pod:1967 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 " @@ -33531,7 +33679,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1970 +#: ../src/guestfs.pod:1971 msgid "" "The transfer that was in progress (if there is one) will stop shortly " "afterwards, and will return an error. The errno (see " @@ -33540,7 +33688,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1976 +#: ../src/guestfs.pod:1977 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 " @@ -33548,12 +33696,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1980 +#: ../src/guestfs.pod:1981 msgid "There are two common places that you might call C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1982 +#: ../src/guestfs.pod:1983 msgid "" "In an interactive text-based program, you might call it from a C " "signal handler so that pressing C<^C> cancels the current operation. (You " @@ -33562,19 +33710,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1987 +#: ../src/guestfs.pod:1988 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:1991 +#: ../src/guestfs.pod:1992 msgid "PRIVATE DATA AREA" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1993 +#: ../src/guestfs.pod:1994 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 " @@ -33582,12 +33730,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1998 +#: ../src/guestfs.pod:1999 msgid "To attach a named piece of data, use the following call:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2000 +#: ../src/guestfs.pod:2001 #, no-wrap msgid "" " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n" @@ -33595,7 +33743,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2002 +#: ../src/guestfs.pod:2003 msgid "" "C is the name to associate with this data, and C is an arbitrary " "pointer (which can be C). Any previous item with the same key is " @@ -33603,7 +33751,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2006 +#: ../src/guestfs.pod:2007 msgid "" "You can use any C you want, but your key should I start with an " "underscore character. Keys beginning with an underscore character are " @@ -33613,12 +33761,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2012 +#: ../src/guestfs.pod:2013 msgid "To retrieve the pointer, use:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2014 +#: ../src/guestfs.pod:2015 #, no-wrap msgid "" " void *guestfs_get_private (guestfs_h *g, const char *key);\n" @@ -33626,7 +33774,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2016 +#: ../src/guestfs.pod:2017 msgid "" "This function returns C if either no data is found associated with " "C, or if the user previously set the C's C pointer to " @@ -33634,7 +33782,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2020 +#: ../src/guestfs.pod:2021 msgid "" "Libguestfs does not try to look at or interpret the C pointer in any " "way. As far as libguestfs is concerned, it need not be a valid pointer at " @@ -33645,12 +33793,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2027 +#: ../src/guestfs.pod:2028 msgid "To walk over all entries, use these two functions:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2029 +#: ../src/guestfs.pod:2030 #, no-wrap msgid "" " void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n" @@ -33658,7 +33806,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2031 +#: ../src/guestfs.pod:2032 #, no-wrap msgid "" " void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n" @@ -33666,7 +33814,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2033 +#: ../src/guestfs.pod:2034 msgid "" "C returns the first key, pointer pair (\"first\" does " "not have any particular meaning -- keys are not returned in any defined " @@ -33676,7 +33824,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2039 +#: ../src/guestfs.pod:2040 msgid "" "C returns the next key, pointer pair. The return " "value of this function is also C is there are no further entries to " @@ -33684,17 +33832,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2043 +#: ../src/guestfs.pod:2044 msgid "Notes about walking over entries:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2049 +#: ../src/guestfs.pod:2050 msgid "You must not call C while walking over the entries." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2054 +#: ../src/guestfs.pod:2055 msgid "" "The handle maintains an internal iterator which is reset when you call " "C. This internal iterator is invalidated when you " @@ -33702,12 +33850,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2060 +#: ../src/guestfs.pod:2061 msgid "If you have set the data pointer associated with a key to C, ie:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2062 +#: ../src/guestfs.pod:2063 #, no-wrap msgid "" " guestfs_set_private (g, key, NULL);\n" @@ -33715,26 +33863,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2064 +#: ../src/guestfs.pod:2065 msgid "then that C is not returned when walking." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2068 +#: ../src/guestfs.pod:2069 msgid "" "C<*key_rtn> is only valid until the next call to C, " "C or C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2074 +#: ../src/guestfs.pod:2075 msgid "" "The following example code shows how to print all keys and data pointers " "that are associated with the handle C:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2077 +#: ../src/guestfs.pod:2078 #, no-wrap msgid "" " const char *key;\n" @@ -33748,14 +33896,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2085 +#: ../src/guestfs.pod:2086 msgid "" "More commonly you are only interested in keys that begin with an " "application-specific prefix C. Modify the loop like so:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2088 +#: ../src/guestfs.pod:2089 #, no-wrap msgid "" " const char *key;\n" @@ -33770,7 +33918,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2097 +#: ../src/guestfs.pod:2098 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 " @@ -33778,7 +33926,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2101 +#: ../src/guestfs.pod:2102 #, no-wrap msgid "" " const char *key;\n" @@ -33800,7 +33948,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2117 +#: ../src/guestfs.pod:2118 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 " @@ -33809,24 +33957,24 @@ msgid "" msgstr "" #. type: =end -#: ../src/guestfs.pod:2122 ../src/guestfs.pod:2127 +#: ../src/guestfs.pod:2123 ../src/guestfs.pod:2128 msgid "html" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2124 +#: ../src/guestfs.pod:2125 msgid "" " " msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2129 +#: ../src/guestfs.pod:2130 msgid "ARCHITECTURE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2131 +#: ../src/guestfs.pod:2132 msgid "" "Internally, libguestfs is implemented by running an appliance (a special " "type of small virtual machine) using L. Qemu runs as a child " @@ -33834,7 +33982,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2135 +#: ../src/guestfs.pod:2136 #, no-wrap msgid "" " ___________________\n" @@ -33860,14 +34008,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2155 +#: ../src/guestfs.pod:2156 msgid "" "The library, linked to the main program, creates the child process and hence " "the appliance in the L function." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2158 +#: ../src/guestfs.pod:2159 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 " @@ -33879,7 +34027,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2167 +#: ../src/guestfs.pod:2168 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 " @@ -33890,17 +34038,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2174 +#: ../src/guestfs.pod:2175 msgid "STATE MACHINE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2176 +#: ../src/guestfs.pod:2177 msgid "libguestfs uses a state machine to model the child process:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2178 +#: ../src/guestfs.pod:2179 #, no-wrap msgid "" " |\n" @@ -33928,7 +34076,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2200 +#: ../src/guestfs.pod:2201 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), " @@ -33937,7 +34085,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2205 +#: ../src/guestfs.pod:2206 msgid "" "The guest may be killed by L, or may die " "asynchronously at any time (eg. due to some internal error), and that causes " @@ -33945,14 +34093,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2209 +#: ../src/guestfs.pod:2210 msgid "" "Configuration commands for qemu such as L can only be " "issued when in the CONFIG state." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2212 +#: ../src/guestfs.pod:2213 msgid "" "The API offers one call that goes from CONFIG through LAUNCHING to READY. " "L blocks until the child process is READY to accept " @@ -33961,7 +34109,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2218 +#: ../src/guestfs.pod:2219 msgid "" "API actions such as L can only be issued when in the READY " "state. These API calls block waiting for the command to be carried out " @@ -33971,7 +34119,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2224 +#: ../src/guestfs.pod:2225 msgid "" "Finally, the child process sends asynchronous messages back to the main " "program, such as kernel log messages. You can register a callback to " @@ -33979,24 +34127,24 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2228 +#: ../src/guestfs.pod:2229 msgid "INTERNALS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2230 +#: ../src/guestfs.pod:2231 msgid "COMMUNICATION PROTOCOL" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2232 +#: ../src/guestfs.pod:2233 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:2235 +#: ../src/guestfs.pod:2236 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 " @@ -34004,14 +34152,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2239 +#: ../src/guestfs.pod:2240 msgid "" "The detailed format of structures is in C (note: " "this file is automatically generated)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2242 +#: ../src/guestfs.pod:2243 msgid "" "There are two broad cases, ordinary functions that don't have any C " "and C parameters, which are handled with very simple request/reply " @@ -34021,17 +34169,17 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2249 +#: ../src/guestfs.pod:2250 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2251 +#: ../src/guestfs.pod:2252 msgid "For ordinary functions, the request message is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2253 +#: ../src/guestfs.pod:2254 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -34042,7 +34190,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2258 +#: ../src/guestfs.pod:2259 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 " @@ -34051,21 +34199,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2264 +#: ../src/guestfs.pod:2265 msgid "" "Note also that many functions don't take any arguments, in which case the " "C_args> is completely omitted." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2267 +#: ../src/guestfs.pod:2268 msgid "" "The header contains the procedure number (C) which is how the " "receiver knows what type of args structure to expect, or none at all." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2271 +#: ../src/guestfs.pod:2272 msgid "" "For functions that take optional arguments, the optional arguments are " "encoded in the C_args> structure in the same way as ordinary " @@ -34077,12 +34225,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2279 +#: ../src/guestfs.pod:2280 msgid "The reply message for ordinary functions is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2281 +#: ../src/guestfs.pod:2282 #, no-wrap msgid "" " total length (header + ret,\n" @@ -34093,26 +34241,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2286 +#: ../src/guestfs.pod:2287 msgid "" "As above the C_ret> structure may be completely omitted for " "functions that return no formal return values." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2289 +#: ../src/guestfs.pod:2290 msgid "As above the total length of the reply is limited to C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2292 +#: ../src/guestfs.pod:2293 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:2295 +#: ../src/guestfs.pod:2296 #, no-wrap msgid "" " total length (header + error,\n" @@ -34123,19 +34271,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2300 +#: ../src/guestfs.pod:2301 msgid "" "The C structure contains the error message as a " "string." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2303 +#: ../src/guestfs.pod:2304 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2305 +#: ../src/guestfs.pod:2306 msgid "" "A C parameter indicates that we transfer a file I the guest. " "The normal request message is sent (see above). However this is followed by " @@ -34143,7 +34291,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2309 +#: ../src/guestfs.pod:2310 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -34157,12 +34305,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2317 +#: ../src/guestfs.pod:2318 msgid "The \"sequence of chunks\" is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2319 +#: ../src/guestfs.pod:2320 #, no-wrap msgid "" " length of chunk (not including length word itself)\n" @@ -34176,7 +34324,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2327 +#: ../src/guestfs.pod:2328 msgid "" "The final chunk has the C field set to zero. Additionally a flag " "is set in the final chunk to indicate either successful completion or early " @@ -34184,7 +34332,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2331 +#: ../src/guestfs.pod:2332 msgid "" "At time of writing there are no functions that have more than one FileIn " "parameter. However this is (theoretically) supported, by sending the " @@ -34193,7 +34341,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2336 +#: ../src/guestfs.pod:2337 msgid "" "Both the library (sender) I the daemon (receiver) may cancel the " "transfer. The library does this by sending a chunk with a special flag set " @@ -34202,7 +34350,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2342 +#: ../src/guestfs.pod:2343 msgid "" "The daemon may also cancel. It does this by writing a special word " "C to the socket. The library listens for this during " @@ -34214,7 +34362,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2351 +#: ../src/guestfs.pod:2352 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 " @@ -34224,19 +34372,19 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2357 +#: ../src/guestfs.pod:2358 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2359 +#: ../src/guestfs.pod:2360 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:2362 +#: ../src/guestfs.pod:2363 #, no-wrap msgid "" " total length (header + ret,\n" @@ -34250,12 +34398,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2370 +#: ../src/guestfs.pod:2371 msgid "INITIAL MESSAGE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2372 +#: ../src/guestfs.pod:2373 msgid "" "When the daemon launches it sends an initial word (C) " "which indicates that the guest and daemon is alive. This is what " @@ -34263,12 +34411,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2376 +#: ../src/guestfs.pod:2377 msgid "PROGRESS NOTIFICATION MESSAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2378 +#: ../src/guestfs.pod:2379 msgid "" "The daemon may send progress notification messages at any time. These are " "distinguished by the normal length word being replaced by " @@ -34276,7 +34424,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2382 +#: ../src/guestfs.pod:2383 msgid "" "The library turns them into progress callbacks (see " "L) if there is a callback registered, or discards " @@ -34284,7 +34432,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2386 +#: ../src/guestfs.pod:2387 msgid "" "The daemon self-limits the frequency of progress messages it sends (see " "C). Not all calls generate progress " @@ -34292,12 +34440,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2390 +#: ../src/guestfs.pod:2391 msgid "LIBGUESTFS VERSION NUMBERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2392 +#: ../src/guestfs.pod:2393 msgid "" "Since April 2010, libguestfs has started to make separate development and " "stable releases, along with corresponding branches in our git repository. " @@ -34305,7 +34453,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2397 +#: ../src/guestfs.pod:2398 #, no-wrap msgid "" " even numbers for stable: 1.2.x, 1.4.x, ...\n" @@ -34322,12 +34470,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2408 +#: ../src/guestfs.pod:2409 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2410 +#: ../src/guestfs.pod:2411 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 " @@ -34337,26 +34485,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2416 +#: ../src/guestfs.pod:2417 msgid "Our criteria for backporting changes are:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2422 +#: ../src/guestfs.pod:2423 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:2428 +#: ../src/guestfs.pod:2429 msgid "" "Bug fixes which are not controversial, fix obvious problems, and have been " "well tested are backported." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2433 +#: ../src/guestfs.pod:2434 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 " @@ -34364,7 +34512,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2439 +#: ../src/guestfs.pod:2440 msgid "" "We I backport new features, new APIs, new tools etc, except in one " "exceptional case: the new feature is required in order to implement an " @@ -34372,7 +34520,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2445 +#: ../src/guestfs.pod:2446 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 " @@ -34383,17 +34531,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2453 +#: ../src/guestfs.pod:2454 msgid "EXTENDING LIBGUESTFS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2455 +#: ../src/guestfs.pod:2456 msgid "ADDING A NEW API ACTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2457 +#: ../src/guestfs.pod:2458 msgid "" "Large amounts of boilerplate code in libguestfs (RPC, bindings, " "documentation) are generated, and this makes it easy to extend the " @@ -34401,19 +34549,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2461 +#: ../src/guestfs.pod:2462 msgid "To add a new API action there are two changes:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2467 +#: ../src/guestfs.pod:2468 msgid "" "You need to add a description of the call (name, parameters, return type, " "tests, documentation) to C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2470 +#: ../src/guestfs.pod:2471 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 " @@ -34424,7 +34572,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2478 +#: ../src/guestfs.pod:2479 msgid "" "Most new actions are of the first type, and get added to the " "C list. Each function has a unique procedure number used " @@ -34434,7 +34582,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2484 +#: ../src/guestfs.pod:2485 msgid "" "For library-only actions of the second type, add to the " "C list. Since these functions are serviced by the " @@ -34444,36 +34592,36 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2492 +#: ../src/guestfs.pod:2493 msgid "Implement the action (in C):" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2494 +#: ../src/guestfs.pod:2495 msgid "" "For daemon actions, implement the function CnameE> in the " "C directory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2497 +#: ../src/guestfs.pod:2498 msgid "" "For library actions, implement the function CnameE> " "(note: double underscore) in the C directory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2500 +#: ../src/guestfs.pod:2501 msgid "In either case, use another function as an example of what to do." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2504 +#: ../src/guestfs.pod:2505 msgid "After making these changes, use C to compile." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2506 +#: ../src/guestfs.pod:2507 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 " @@ -34481,12 +34629,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2510 +#: ../src/guestfs.pod:2511 msgid "ADDING TESTS FOR AN API ACTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2512 +#: ../src/guestfs.pod:2513 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 " @@ -34496,61 +34644,61 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2518 +#: ../src/guestfs.pod:2519 msgid "" "The following describes the test environment used when you add an API test " "in C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2521 +#: ../src/guestfs.pod:2522 msgid "The test environment has 4 block devices:" msgstr "" #. type: =item -#: ../src/guestfs.pod:2525 +#: ../src/guestfs.pod:2526 msgid "C 500MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2527 +#: ../src/guestfs.pod:2528 msgid "General block device for testing." msgstr "" #. type: =item -#: ../src/guestfs.pod:2529 +#: ../src/guestfs.pod:2530 msgid "C 50MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2531 +#: ../src/guestfs.pod:2532 msgid "" "C is an ext2 filesystem used for testing filesystem write " "operations." msgstr "" #. type: =item -#: ../src/guestfs.pod:2534 +#: ../src/guestfs.pod:2535 msgid "C 10MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2536 +#: ../src/guestfs.pod:2537 msgid "Used in a few tests where two block devices are needed." msgstr "" #. type: =item -#: ../src/guestfs.pod:2538 +#: ../src/guestfs.pod:2539 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2540 +#: ../src/guestfs.pod:2541 msgid "ISO with fixed content (see C)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2544 +#: ../src/guestfs.pod:2545 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 " @@ -34558,7 +34706,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2548 +#: ../src/guestfs.pod:2549 msgid "" "Each test starts with an initial scenario, selected using one of the " "C expressions, described in C. These " @@ -34568,7 +34716,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2554 +#: ../src/guestfs.pod:2555 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 " @@ -34578,14 +34726,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2560 +#: ../src/guestfs.pod:2561 msgid "" "In addition, packagers can skip individual tests by setting environment " "variables before running C." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2563 +#: ../src/guestfs.pod:2564 #, no-wrap msgid "" " SKIP_TEST__=1\n" @@ -34593,17 +34741,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2565 +#: ../src/guestfs.pod:2566 msgid "eg: C skips test #3 of L." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2567 +#: ../src/guestfs.pod:2568 msgid "or:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2569 +#: ../src/guestfs.pod:2570 #, no-wrap msgid "" " SKIP_TEST_=1\n" @@ -34611,17 +34759,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2571 +#: ../src/guestfs.pod:2572 msgid "eg: C skips all L tests." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2573 +#: ../src/guestfs.pod:2574 msgid "Packagers can run only certain tests by setting for example:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2575 +#: ../src/guestfs.pod:2576 #, no-wrap msgid "" " TEST_ONLY=\"vfs_type zerofree\"\n" @@ -34629,29 +34777,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2577 +#: ../src/guestfs.pod:2578 msgid "" "See C for more details of how these environment variables " "work." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2580 +#: ../src/guestfs.pod:2581 msgid "DEBUGGING NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2582 +#: ../src/guestfs.pod:2583 msgid "Test new actions work before submitting them." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2584 +#: ../src/guestfs.pod:2585 msgid "You can use guestfish to try out new commands." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2586 +#: ../src/guestfs.pod:2587 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 " @@ -34659,12 +34807,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2590 +#: ../src/guestfs.pod:2591 msgid "FORMATTING CODE AND OTHER CONVENTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2592 +#: ../src/guestfs.pod:2593 msgid "" "Our C source code generally adheres to some basic code-formatting " "conventions. The existing code base is not totally consistent on this " @@ -34674,14 +34822,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2598 +#: ../src/guestfs.pod:2599 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:2601 +#: ../src/guestfs.pod:2602 #, no-wrap msgid "" " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n" @@ -34697,7 +34845,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2611 +#: ../src/guestfs.pod:2612 #, no-wrap msgid "" " ;;; When editing C sources in libguestfs, use this style.\n" @@ -34715,12 +34863,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2623 +#: ../src/guestfs.pod:2624 msgid "Enable warnings when compiling (and fix any problems this finds):" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2626 +#: ../src/guestfs.pod:2627 #, no-wrap msgid "" " ./configure --enable-gcc-warnings\n" @@ -34728,12 +34876,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2628 +#: ../src/guestfs.pod:2629 msgid "Useful targets are:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2630 +#: ../src/guestfs.pod:2631 #, no-wrap msgid "" " make syntax-check # checks the syntax of the C code\n" @@ -34742,43 +34890,43 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2633 +#: ../src/guestfs.pod:2634 msgid "DAEMON CUSTOM PRINTF FORMATTERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2635 +#: ../src/guestfs.pod:2636 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:2640 +#: ../src/guestfs.pod:2641 msgid "%Q" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2642 +#: ../src/guestfs.pod:2643 msgid "" "Simple shell quoted string. Any spaces or other shell characters are " "escaped for you." msgstr "" #. type: =item -#: ../src/guestfs.pod:2645 +#: ../src/guestfs.pod:2646 msgid "%R" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2647 +#: ../src/guestfs.pod:2648 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:2654 +#: ../src/guestfs.pod:2655 #, no-wrap msgid "" " asprintf (&cmd, \"cat %R\", path);\n" @@ -34786,12 +34934,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2656 +#: ../src/guestfs.pod:2657 msgid "would produce C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2658 +#: ../src/guestfs.pod:2659 msgid "" "I Do I use these when you are passing parameters to the " "C functions. These parameters do NOT need to be quoted " @@ -34800,12 +34948,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2664 +#: ../src/guestfs.pod:2665 msgid "SUBMITTING YOUR NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2666 +#: ../src/guestfs.pod:2667 msgid "" "Submit patches to the mailing list: " "L and CC to " @@ -34813,17 +34961,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2670 +#: ../src/guestfs.pod:2671 msgid "INTERNATIONALIZATION (I18N) SUPPORT" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2672 +#: ../src/guestfs.pod:2673 msgid "We support i18n (gettext anyhow) in the library." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2674 +#: ../src/guestfs.pod:2675 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 " @@ -34832,115 +34980,115 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2680 +#: ../src/guestfs.pod:2681 msgid "" "Debugging messages are never translated, since they are intended for the " "programmers." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2683 +#: ../src/guestfs.pod:2684 msgid "SOURCE CODE SUBDIRECTORIES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2689 +#: ../src/guestfs.pod:2690 msgid "The libguestfs appliance, build scripts and so on." msgstr "" #. type: =item -#: ../src/guestfs.pod:2691 +#: ../src/guestfs.pod:2692 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2693 +#: ../src/guestfs.pod:2694 msgid "Automated tests of the C API." msgstr "" #. type: =item -#: ../src/guestfs.pod:2695 +#: ../src/guestfs.pod:2696 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2697 +#: ../src/guestfs.pod:2698 msgid "" "The L, L and L commands and " "documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2700 +#: ../src/guestfs.pod:2701 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2702 +#: ../src/guestfs.pod:2703 msgid "" "Safety and liveness tests of components that libguestfs depends upon (not of " "libguestfs itself). Mainly this is for qemu and the kernel." msgstr "" #. type: =item -#: ../src/guestfs.pod:2705 +#: ../src/guestfs.pod:2706 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2707 +#: ../src/guestfs.pod:2708 msgid "Outside contributions, experimental parts." msgstr "" #. type: =item -#: ../src/guestfs.pod:2709 +#: ../src/guestfs.pod:2710 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2711 +#: ../src/guestfs.pod:2712 msgid "" "The daemon that runs inside the libguestfs appliance and carries out " "actions." msgstr "" #. type: =item -#: ../src/guestfs.pod:2714 +#: ../src/guestfs.pod:2715 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2716 +#: ../src/guestfs.pod:2717 msgid "L command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2718 +#: ../src/guestfs.pod:2719 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2720 +#: ../src/guestfs.pod:2721 msgid "L command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2722 +#: ../src/guestfs.pod:2723 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2724 +#: ../src/guestfs.pod:2725 msgid "C API example code." msgstr "" #. type: =item -#: ../src/guestfs.pod:2726 +#: ../src/guestfs.pod:2727 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2728 +#: ../src/guestfs.pod:2729 msgid "" "L, the command-line shell, and various shell scripts built on " "top such as L, L, L, " @@ -34948,89 +35096,89 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2732 +#: ../src/guestfs.pod:2733 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2734 +#: ../src/guestfs.pod:2735 msgid "L, FUSE (userspace filesystem) built on top of libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:2736 +#: ../src/guestfs.pod:2737 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2738 +#: ../src/guestfs.pod:2739 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:2741 +#: ../src/guestfs.pod:2742 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2743 +#: ../src/guestfs.pod:2744 msgid "Files used by the test suite." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2745 +#: ../src/guestfs.pod:2746 msgid "Some \"phony\" guest images which we test against." msgstr "" #. type: =item -#: ../src/guestfs.pod:2747 +#: ../src/guestfs.pod:2748 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2749 +#: ../src/guestfs.pod:2750 msgid "L, the virtual machine image inspector." msgstr "" #. type: =item -#: ../src/guestfs.pod:2751 +#: ../src/guestfs.pod:2752 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2753 +#: ../src/guestfs.pod:2754 msgid "Logo used on the website. The fish is called Arthur by the way." msgstr "" #. type: =item -#: ../src/guestfs.pod:2755 +#: ../src/guestfs.pod:2756 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2757 +#: ../src/guestfs.pod:2758 msgid "M4 macros used by autoconf." msgstr "" #. type: =item -#: ../src/guestfs.pod:2759 +#: ../src/guestfs.pod:2760 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2761 +#: ../src/guestfs.pod:2762 msgid "Translations of simple gettext strings." msgstr "" #. type: =item -#: ../src/guestfs.pod:2763 +#: ../src/guestfs.pod:2764 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2765 +#: ../src/guestfs.pod:2766 msgid "" "The build infrastructure and PO files for translations of manpages and POD " "files. Eventually this will be combined with the C directory, but that " @@ -35038,109 +35186,109 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2769 +#: ../src/guestfs.pod:2770 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2771 +#: ../src/guestfs.pod:2772 msgid "Regression tests." msgstr "" #. type: =item -#: ../src/guestfs.pod:2773 +#: ../src/guestfs.pod:2774 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2775 +#: ../src/guestfs.pod:2776 msgid "L command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2777 +#: ../src/guestfs.pod:2778 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2779 +#: ../src/guestfs.pod:2780 msgid "Source code to the C library." msgstr "" #. type: =item -#: ../src/guestfs.pod:2781 +#: ../src/guestfs.pod:2782 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2783 +#: ../src/guestfs.pod:2784 msgid "Command line tools written in Perl (L and many others)." msgstr "" #. type: =item -#: ../src/guestfs.pod:2785 +#: ../src/guestfs.pod:2786 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2787 +#: ../src/guestfs.pod:2788 msgid "" "Test tool for end users to test if their qemu/kernel combination will work " "with libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:2790 +#: ../src/guestfs.pod:2791 msgid "C" msgstr "" #. type: =item -#: ../src/guestfs.pod:2792 +#: ../src/guestfs.pod:2793 msgid "C" msgstr "" #. type: =item -#: ../src/guestfs.pod:2794 +#: ../src/guestfs.pod:2795 msgid "C" msgstr "" #. type: =item -#: ../src/guestfs.pod:2796 +#: ../src/guestfs.pod:2797 msgid "C" msgstr "" #. type: =item -#: ../src/guestfs.pod:2798 +#: ../src/guestfs.pod:2799 msgid "C" msgstr "" #. type: =item -#: ../src/guestfs.pod:2800 +#: ../src/guestfs.pod:2801 msgid "C" msgstr "" #. type: =item -#: ../src/guestfs.pod:2802 +#: ../src/guestfs.pod:2803 msgid "C" msgstr "" #. type: =item -#: ../src/guestfs.pod:2804 +#: ../src/guestfs.pod:2805 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2806 +#: ../src/guestfs.pod:2807 msgid "Language bindings." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2810 +#: ../src/guestfs.pod:2811 msgid "MAKING A STABLE RELEASE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2812 +#: ../src/guestfs.pod:2813 msgid "" "When we make a stable release, there are several steps documented here. See " "L for general information about the stable " @@ -35148,37 +35296,37 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2820 +#: ../src/guestfs.pod:2821 msgid "Check C works on at least Fedora, Debian and Ubuntu." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2825 +#: ../src/guestfs.pod:2826 msgid "Finalize RELEASE-NOTES." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2829 +#: ../src/guestfs.pod:2830 msgid "Update ROADMAP." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2833 +#: ../src/guestfs.pod:2834 msgid "Run C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2837 +#: ../src/guestfs.pod:2838 msgid "Push and pull from Transifex." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2839 +#: ../src/guestfs.pod:2840 msgid "Run:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2841 +#: ../src/guestfs.pod:2842 #, no-wrap msgid "" " tx push -s\n" @@ -35186,12 +35334,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2843 +#: ../src/guestfs.pod:2844 msgid "to push the latest POT files to Transifex. Then run:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2845 +#: ../src/guestfs.pod:2846 #, no-wrap msgid "" " ./tx-pull.sh\n" @@ -35199,24 +35347,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2847 +#: ../src/guestfs.pod:2848 msgid "which is a wrapper to pull the latest translated C<*.po> files." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2851 +#: ../src/guestfs.pod:2852 msgid "" "Create new stable and development directories under " "L." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2856 +#: ../src/guestfs.pod:2857 msgid "Create the branch in git:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2858 +#: ../src/guestfs.pod:2859 #, no-wrap msgid "" " git tag -a 1.XX.0 -m \"Version 1.XX.0 (stable)\"\n" @@ -35227,17 +35375,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2865 +#: ../src/guestfs.pod:2866 msgid "LIMITS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2867 +#: ../src/guestfs.pod:2868 msgid "PROTOCOL LIMITS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2869 +#: ../src/guestfs.pod:2870 msgid "" "Internally libguestfs uses a message-based protocol to pass API calls and " "their responses to and from a small \"appliance\" (see L for " @@ -35248,7 +35396,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2877 +#: ../src/guestfs.pod:2878 msgid "" "A simple call such as L returns its result (the file data) in " "a simple string. Because this string is at some point internally encoded as " @@ -35257,7 +35405,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2883 +#: ../src/guestfs.pod:2884 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 " @@ -35265,24 +35413,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2887 +#: ../src/guestfs.pod:2888 msgid "" "You might also consider mounting the disk image using our FUSE filesystem " "support (L)." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2890 +#: ../src/guestfs.pod:2891 msgid "MAXIMUM NUMBER OF DISKS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2892 +#: ../src/guestfs.pod:2893 msgid "When using virtio disks (the default) the current limit is B<25> disks." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2895 +#: ../src/guestfs.pod:2896 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 " @@ -35291,14 +35439,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2900 +#: ../src/guestfs.pod:2901 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:2903 +#: ../src/guestfs.pod:2904 msgid "" "In future versions of libguestfs it should also be possible to \"hot plug\" " "disks (add and remove disks after calling L). This also " @@ -35306,41 +35454,41 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2907 +#: ../src/guestfs.pod:2908 msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2909 +#: ../src/guestfs.pod:2910 msgid "Virtio limits the maximum number of partitions per disk to B<15>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2911 +#: ../src/guestfs.pod:2912 msgid "" "This is because it reserves 4 bits for the minor device number (thus " "C, and C through C)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2914 +#: ../src/guestfs.pod:2915 msgid "" "If you attach a disk with more than 15 partitions, the extra partitions are " "ignored by libguestfs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2917 +#: ../src/guestfs.pod:2918 msgid "MAXIMUM SIZE OF A DISK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2919 +#: ../src/guestfs.pod:2920 msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2921 +#: ../src/guestfs.pod:2922 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 " @@ -35348,7 +35496,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2925 +#: ../src/guestfs.pod:2926 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 " @@ -35358,19 +35506,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2931 +#: ../src/guestfs.pod:2932 msgid "" "For the hugest disk image files, we recommend using XFS on the host for " "storage." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2934 +#: ../src/guestfs.pod:2935 msgid "MAXIMUM SIZE OF A PARTITION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2936 +#: ../src/guestfs.pod:2937 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 " @@ -35378,7 +35526,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2940 +#: ../src/guestfs.pod:2941 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 " @@ -35386,12 +35534,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2945 +#: ../src/guestfs.pod:2946 msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2947 +#: ../src/guestfs.pod:2948 msgid "" "This depends on the filesystem type. libguestfs itself does not impose any " "known limit. Consult Wikipedia or the filesystem documentation to find out " @@ -35399,12 +35547,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2951 +#: ../src/guestfs.pod:2952 msgid "MAXIMUM UPLOAD AND DOWNLOAD" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2953 +#: ../src/guestfs.pod:2954 msgid "" "The API functions L, L, " "L, L and the like allow unlimited sized " @@ -35412,12 +35560,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2957 +#: ../src/guestfs.pod:2958 msgid "INSPECTION LIMITS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2959 +#: ../src/guestfs.pod:2960 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 " @@ -35427,33 +35575,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2975 +#: ../src/guestfs.pod:2986 msgid "" "Set C to enable verbose messages. This has the same " "effect as calling C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2987 +#: ../src/guestfs.pod:2998 msgid "" "Set the path that libguestfs uses to search for a supermin appliance. See " "the discussion of paths in section L above." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2996 +#: ../src/guestfs.pod:3007 msgid "See also L above." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3000 +#: ../src/guestfs.pod:3011 msgid "" "Set C to enable command traces. This has the same " "effect as calling C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3018 +#: ../src/guestfs.pod:3029 msgid "" "L, L, L, " "L, L, L, " @@ -35462,64 +35610,64 @@ msgid "" "L, L, " "L, L, L, " "L, L, L, L, " -"L, L, L, L, " -"L." +"L, L, L, " +"L, L, L." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3047 +#: ../src/guestfs.pod:3059 msgid "" "Tools with a similar purpose: L, L, L, " "L, L." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:3054 ../tools/virt-make-fs.pl:553 ../tools/virt-win-reg.pl:761 +#: ../src/guestfs.pod:3066 ../tools/virt-make-fs.pl:553 ../tools/virt-win-reg.pl:761 msgid "BUGS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3056 +#: ../src/guestfs.pod:3068 msgid "To get a list of bugs against libguestfs use this link:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3058 +#: ../src/guestfs.pod:3070 msgid "L" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3060 +#: ../src/guestfs.pod:3072 msgid "To report a new bug against libguestfs use this link:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3062 +#: ../src/guestfs.pod:3074 msgid "L" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3064 +#: ../src/guestfs.pod:3076 msgid "When reporting a bug, please check:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3070 +#: ../src/guestfs.pod:3082 msgid "That the bug hasn't been reported already." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3074 +#: ../src/guestfs.pod:3086 msgid "That you are testing a recent version." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3078 +#: ../src/guestfs.pod:3090 msgid "Describe the bug accurately, and give a way to reproduce it." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3082 +#: ../src/guestfs.pod:3094 msgid "" "Run libguestfs-test-tool and paste the B output into the " "bug report."