diff options
Diffstat (limited to 'po-docs/libguestfs-docs.pot')
| -rw-r--r-- | po-docs/libguestfs-docs.pot | 11618 |
1 files changed, 5330 insertions, 6288 deletions
diff --git a/po-docs/libguestfs-docs.pot b/po-docs/libguestfs-docs.pot index 183a617d..04e77719 100644 --- a/po-docs/libguestfs-docs.pot +++ b/po-docs/libguestfs-docs.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: libguestfs 1.19.28\n" +"Project-Id-Version: libguestfs 1.18.7\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2012-08-02 17:34+0200\n" +"POT-Creation-Date: 2012-08-30 23:39+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -246,17 +246,17 @@ msgid "If you just want the exit code with no output, use the I<-q> option." msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:103 ../appliance/libguestfs-make-fixed-appliance.pod:77 ../cat/virt-cat.pod:62 ../cat/virt-filesystems.pod:91 ../cat/virt-ls.pod:261 ../df/virt-df.pod:59 ../edit/virt-edit.pod:62 ../fish/guestfish.pod:148 ../fish/virt-copy-in.pod:45 ../fish/virt-copy-out.pod:34 ../fish/virt-tar-in.pod:42 ../fish/virt-tar-out.pod:36 ../format/virt-format.pod:59 ../fuse/guestmount.pod:169 ../inspector/virt-inspector.pod:54 ../rescue/virt-rescue.pod:115 ../resize/virt-resize.pod:262 ../sparsify/virt-sparsify.pod:94 ../sysprep/virt-sysprep.pod:39 ../test-tool/libguestfs-test-tool.pod:36 ../tools/virt-list-filesystems.pl:55 ../tools/virt-list-partitions.pl:56 ../tools/virt-make-fs.pl:156 ../tools/virt-tar.pl:103 ../tools/virt-win-reg.pl:96 +#: ../align/virt-alignment-scan.pod:103 ../appliance/libguestfs-make-fixed-appliance.pod:77 ../cat/virt-cat.pod:62 ../cat/virt-filesystems.pod:91 ../cat/virt-ls.pod:261 ../df/virt-df.pod:59 ../edit/virt-edit.pod:62 ../fish/guestfish.pod:148 ../fish/virt-copy-in.pod:45 ../fish/virt-copy-out.pod:34 ../fish/virt-tar-in.pod:42 ../fish/virt-tar-out.pod:36 ../format/virt-format.pod:59 ../fuse/guestmount.pod:169 ../inspector/virt-inspector.pod:54 ../rescue/virt-rescue.pod:115 ../resize/virt-resize.pod:262 ../sparsify/virt-sparsify.pod:107 ../sysprep/virt-sysprep.pod:39 ../test-tool/libguestfs-test-tool.pod:36 ../tools/virt-list-filesystems.pl:55 ../tools/virt-list-partitions.pl:56 ../tools/virt-make-fs.pl:151 ../tools/virt-tar.pl:103 ../tools/virt-win-reg.pl:96 msgid "OPTIONS" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:107 ../appliance/libguestfs-make-fixed-appliance.pod:81 ../cat/virt-cat.pod:66 ../cat/virt-filesystems.pod:95 ../cat/virt-ls.pod:265 ../df/virt-df.pod:63 ../edit/virt-edit.pod:66 ../fish/guestfish.pod:152 ../format/virt-format.pod:63 ../fuse/guestmount.pod:237 ../inspector/virt-inspector.pod:58 ../rescue/virt-rescue.pod:119 ../resize/virt-resize.pod:266 ../sparsify/virt-sparsify.pod:98 ../sysprep/virt-sysprep.pod:43 ../test-tool/libguestfs-test-tool.pod:40 ../tools/virt-list-filesystems.pl:63 ../tools/virt-list-partitions.pl:64 ../tools/virt-make-fs.pl:164 ../tools/virt-tar.pl:111 ../tools/virt-win-reg.pl:104 +#: ../align/virt-alignment-scan.pod:107 ../appliance/libguestfs-make-fixed-appliance.pod:81 ../cat/virt-cat.pod:66 ../cat/virt-filesystems.pod:95 ../cat/virt-ls.pod:265 ../df/virt-df.pod:63 ../edit/virt-edit.pod:66 ../fish/guestfish.pod:152 ../format/virt-format.pod:63 ../fuse/guestmount.pod:237 ../inspector/virt-inspector.pod:58 ../rescue/virt-rescue.pod:119 ../resize/virt-resize.pod:266 ../sparsify/virt-sparsify.pod:111 ../sysprep/virt-sysprep.pod:43 ../test-tool/libguestfs-test-tool.pod:40 ../tools/virt-list-filesystems.pl:63 ../tools/virt-list-partitions.pl:64 ../tools/virt-make-fs.pl:159 ../tools/virt-tar.pl:111 ../tools/virt-win-reg.pl:104 msgid "B<--help>" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:109 ../cat/virt-cat.pod:68 ../cat/virt-filesystems.pod:97 ../cat/virt-ls.pod:267 ../df/virt-df.pod:65 ../edit/virt-edit.pod:68 ../format/virt-format.pod:65 ../inspector/virt-inspector.pod:60 ../rescue/virt-rescue.pod:121 ../sysprep/virt-sysprep.pod:45 ../tools/virt-list-filesystems.pl:65 ../tools/virt-list-partitions.pl:66 ../tools/virt-make-fs.pl:166 ../tools/virt-tar.pl:113 ../tools/virt-win-reg.pl:106 +#: ../align/virt-alignment-scan.pod:109 ../cat/virt-cat.pod:68 ../cat/virt-filesystems.pod:97 ../cat/virt-ls.pod:267 ../df/virt-df.pod:65 ../edit/virt-edit.pod:68 ../format/virt-format.pod:65 ../inspector/virt-inspector.pod:60 ../rescue/virt-rescue.pod:121 ../sysprep/virt-sysprep.pod:45 ../tools/virt-list-filesystems.pl:65 ../tools/virt-list-partitions.pl:66 ../tools/virt-make-fs.pl:161 ../tools/virt-tar.pl:113 ../tools/virt-win-reg.pl:106 msgid "Display brief help." msgstr "" @@ -343,7 +343,7 @@ msgid "" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:146 ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337 ../df/virt-df.pod:110 ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242 ../fish/guestfish.pod:685 ../format/virt-format.pod:96 ../inspector/virt-inspector.pod:350 ../rescue/virt-rescue.pod:164 ../src/guestfs.pod:2980 ../sysprep/virt-sysprep.pod:111 +#: ../align/virt-alignment-scan.pod:146 ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337 ../df/virt-df.pod:110 ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242 ../fish/guestfish.pod:685 ../format/virt-format.pod:96 ../inspector/virt-inspector.pod:350 ../rescue/virt-rescue.pod:164 ../src/guestfs.pod:3051 ../sysprep/virt-sysprep.pod:111 msgid "For example:" msgstr "" @@ -384,12 +384,12 @@ msgid "" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:161 ../resize/virt-resize.pod:497 ../sparsify/virt-sparsify.pod:172 ../sysprep/virt-sysprep.pod:148 +#: ../align/virt-alignment-scan.pod:161 ../resize/virt-resize.pod:497 ../sparsify/virt-sparsify.pod:185 ../sysprep/virt-sysprep.pod:148 msgid "B<-q>" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:163 ../resize/virt-resize.pod:499 ../sparsify/virt-sparsify.pod:174 ../sysprep/virt-sysprep.pod:150 +#: ../align/virt-alignment-scan.pod:163 ../resize/virt-resize.pod:499 ../sparsify/virt-sparsify.pod:187 ../sysprep/virt-sysprep.pod:150 msgid "B<--quiet>" msgstr "" @@ -421,42 +421,42 @@ msgid "" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:177 ../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:402 ../format/virt-format.pod:145 ../fuse/guestmount.pod:347 ../inspector/virt-inspector.pod:118 ../rescue/virt-rescue.pod:234 ../sparsify/virt-sparsify.pod:178 ../sysprep/virt-sysprep.pod:166 +#: ../align/virt-alignment-scan.pod:177 ../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:402 ../format/virt-format.pod:145 ../fuse/guestmount.pod:347 ../inspector/virt-inspector.pod:118 ../rescue/virt-rescue.pod:234 ../sparsify/virt-sparsify.pod:191 ../sysprep/virt-sysprep.pod:166 msgid "B<-v>" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:179 ../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:404 ../format/virt-format.pod:147 ../fuse/guestmount.pod:349 ../inspector/virt-inspector.pod:120 ../rescue/virt-rescue.pod:236 ../sparsify/virt-sparsify.pod:180 ../sysprep/virt-sysprep.pod:168 +#: ../align/virt-alignment-scan.pod:179 ../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:404 ../format/virt-format.pod:147 ../fuse/guestmount.pod:349 ../inspector/virt-inspector.pod:120 ../rescue/virt-rescue.pod:236 ../sparsify/virt-sparsify.pod:193 ../sysprep/virt-sysprep.pod:168 msgid "B<--verbose>" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:181 ../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 ../format/virt-format.pod:149 ../inspector/virt-inspector.pod:122 ../rescue/virt-rescue.pod:238 ../sparsify/virt-sparsify.pod:182 ../sysprep/virt-sysprep.pod:170 +#: ../align/virt-alignment-scan.pod:181 ../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 ../format/virt-format.pod:149 ../inspector/virt-inspector.pod:122 ../rescue/virt-rescue.pod:238 ../sparsify/virt-sparsify.pod:195 ../sysprep/virt-sysprep.pod:170 msgid "Enable verbose messages for debugging." msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:183 ../appliance/libguestfs-make-fixed-appliance.pod:85 ../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:409 ../format/virt-format.pod:151 ../fuse/guestmount.pod:353 ../inspector/virt-inspector.pod:124 ../rescue/virt-rescue.pod:240 ../resize/virt-resize.pod:567 ../sparsify/virt-sparsify.pod:184 ../sysprep/virt-sysprep.pod:172 ../test-tool/libguestfs-test-tool.pod:61 +#: ../align/virt-alignment-scan.pod:183 ../appliance/libguestfs-make-fixed-appliance.pod:85 ../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:409 ../format/virt-format.pod:151 ../fuse/guestmount.pod:353 ../inspector/virt-inspector.pod:124 ../rescue/virt-rescue.pod:240 ../resize/virt-resize.pod:567 ../sparsify/virt-sparsify.pod:197 ../sysprep/virt-sysprep.pod:172 ../test-tool/libguestfs-test-tool.pod:61 msgid "B<-V>" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:185 ../appliance/libguestfs-make-fixed-appliance.pod:87 ../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:411 ../format/virt-format.pod:153 ../fuse/guestmount.pod:355 ../inspector/virt-inspector.pod:126 ../rescue/virt-rescue.pod:242 ../resize/virt-resize.pod:569 ../sparsify/virt-sparsify.pod:186 ../sysprep/virt-sysprep.pod:174 ../test-tool/libguestfs-test-tool.pod:63 ../tools/virt-list-filesystems.pl:71 ../tools/virt-list-partitions.pl:72 ../tools/virt-make-fs.pl:172 ../tools/virt-tar.pl:119 ../tools/virt-win-reg.pl:112 +#: ../align/virt-alignment-scan.pod:185 ../appliance/libguestfs-make-fixed-appliance.pod:87 ../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:411 ../format/virt-format.pod:153 ../fuse/guestmount.pod:355 ../inspector/virt-inspector.pod:126 ../rescue/virt-rescue.pod:242 ../resize/virt-resize.pod:569 ../sparsify/virt-sparsify.pod:199 ../sysprep/virt-sysprep.pod:174 ../test-tool/libguestfs-test-tool.pod:63 ../tools/virt-list-filesystems.pl:71 ../tools/virt-list-partitions.pl:72 ../tools/virt-make-fs.pl:167 ../tools/virt-tar.pl:119 ../tools/virt-win-reg.pl:112 msgid "B<--version>" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:187 ../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 ../format/virt-format.pod:155 ../inspector/virt-inspector.pod:128 ../rescue/virt-rescue.pod:244 ../resize/virt-resize.pod:571 ../sparsify/virt-sparsify.pod:188 ../sysprep/virt-sysprep.pod:176 ../tools/virt-list-filesystems.pl:73 ../tools/virt-list-partitions.pl:74 ../tools/virt-make-fs.pl:174 ../tools/virt-tar.pl:121 ../tools/virt-win-reg.pl:114 +#: ../align/virt-alignment-scan.pod:187 ../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 ../format/virt-format.pod:155 ../inspector/virt-inspector.pod:128 ../rescue/virt-rescue.pod:244 ../resize/virt-resize.pod:571 ../sparsify/virt-sparsify.pod:201 ../sysprep/virt-sysprep.pod:176 ../tools/virt-list-filesystems.pl:73 ../tools/virt-list-partitions.pl:74 ../tools/virt-make-fs.pl:169 ../tools/virt-tar.pl:121 ../tools/virt-win-reg.pl:114 msgid "Display version number and exit." msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:189 ../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:424 ../format/virt-format.pod:167 ../fuse/guestmount.pod:368 ../inspector/virt-inspector.pod:130 ../rescue/virt-rescue.pod:255 ../sparsify/virt-sparsify.pod:190 ../sysprep/virt-sysprep.pod:178 ../tools/virt-tar.pl:158 +#: ../align/virt-alignment-scan.pod:189 ../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:424 ../format/virt-format.pod:167 ../fuse/guestmount.pod:368 ../inspector/virt-inspector.pod:130 ../rescue/virt-rescue.pod:255 ../sparsify/virt-sparsify.pod:203 ../sysprep/virt-sysprep.pod:178 ../tools/virt-tar.pl:158 msgid "B<-x>" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:191 ../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 ../format/virt-format.pod:169 ../inspector/virt-inspector.pod:132 ../rescue/virt-rescue.pod:257 ../sparsify/virt-sparsify.pod:192 ../sysprep/virt-sysprep.pod:180 +#: ../align/virt-alignment-scan.pod:191 ../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 ../format/virt-format.pod:169 ../inspector/virt-inspector.pod:132 ../rescue/virt-rescue.pod:257 ../sparsify/virt-sparsify.pod:205 ../sysprep/virt-sysprep.pod:180 msgid "Enable tracing of libguestfs API calls." msgstr "" @@ -727,12 +727,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:334 ../cat/virt-cat.pod:231 ../cat/virt-filesystems.pod:377 ../cat/virt-ls.pod:483 ../df/virt-df.pod:241 ../edit/virt-edit.pod:356 ../inspector/virt-inspector.pod:366 ../rescue/virt-rescue.pod:318 ../resize/virt-resize.pod:690 ../sysprep/virt-sysprep.pod:431 ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:602 ../tools/virt-tar.pl:287 ../tools/virt-win-reg.pl:744 +#: ../align/virt-alignment-scan.pod:334 ../cat/virt-cat.pod:231 ../cat/virt-filesystems.pod:377 ../cat/virt-ls.pod:483 ../df/virt-df.pod:241 ../edit/virt-edit.pod:356 ../inspector/virt-inspector.pod:366 ../rescue/virt-rescue.pod:318 ../resize/virt-resize.pod:690 ../sysprep/virt-sysprep.pod:431 ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:583 ../tools/virt-tar.pl:287 ../tools/virt-win-reg.pl:744 msgid "SHELL QUOTING" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:336 ../cat/virt-cat.pod:233 ../cat/virt-filesystems.pod:379 ../cat/virt-ls.pod:485 ../df/virt-df.pod:243 ../edit/virt-edit.pod:358 ../inspector/virt-inspector.pod:368 ../rescue/virt-rescue.pod:320 ../resize/virt-resize.pod:692 ../sysprep/virt-sysprep.pod:433 ../tools/virt-list-filesystems.pl:192 ../tools/virt-list-partitions.pl:262 ../tools/virt-make-fs.pl:604 ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:752 +#: ../align/virt-alignment-scan.pod:336 ../cat/virt-cat.pod:233 ../cat/virt-filesystems.pod:379 ../cat/virt-ls.pod:485 ../df/virt-df.pod:243 ../edit/virt-edit.pod:358 ../inspector/virt-inspector.pod:368 ../rescue/virt-rescue.pod:320 ../resize/virt-resize.pod:692 ../sysprep/virt-sysprep.pod:433 ../tools/virt-list-filesystems.pl:192 ../tools/virt-list-partitions.pl:262 ../tools/virt-make-fs.pl:585 ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:752 msgid "" "Libvirt guest names can contain arbitrary characters, some of which have " "meaning to the shell such as C<#> and space. You may need to quote or " @@ -741,7 +741,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:341 ../appliance/libguestfs-make-fixed-appliance.pod:134 ../cat/virt-cat.pod:238 ../cat/virt-filesystems.pod:384 ../cat/virt-ls.pod:490 ../df/virt-df.pod:248 ../edit/virt-edit.pod:363 ../fish/guestfish.pod:1126 ../format/virt-format.pod:173 ../fuse/guestmount.pod:393 ../inspector/virt-inspector.pod:496 ../resize/virt-resize.pod:697 ../sparsify/virt-sparsify.pod:254 ../sysprep/virt-sysprep.pod:438 ../test-tool/libguestfs-test-tool.pod:96 +#: ../align/virt-alignment-scan.pod:341 ../appliance/libguestfs-make-fixed-appliance.pod:134 ../cat/virt-cat.pod:238 ../cat/virt-filesystems.pod:384 ../cat/virt-ls.pod:490 ../df/virt-df.pod:248 ../edit/virt-edit.pod:363 ../fish/guestfish.pod:1126 ../format/virt-format.pod:173 ../fuse/guestmount.pod:393 ../inspector/virt-inspector.pod:496 ../resize/virt-resize.pod:697 ../sparsify/virt-sparsify.pod:267 ../sysprep/virt-sysprep.pod:438 ../test-tool/libguestfs-test-tool.pod:96 msgid "EXIT STATUS" msgstr "" @@ -751,7 +751,7 @@ msgid "This program returns:" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:347 ../align/virt-alignment-scan.pod:353 ../align/virt-alignment-scan.pod:359 ../align/virt-alignment-scan.pod:366 ../appliance/libguestfs-make-fixed-appliance.pod:32 ../appliance/libguestfs-make-fixed-appliance.pod:53 ../cat/virt-cat.pod:177 ../cat/virt-cat.pod:182 ../cat/virt-cat.pod:187 ../cat/virt-cat.pod:198 ../cat/virt-cat.pod:202 ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266 ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276 ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291 ../examples/guestfs-faq.pod:151 ../examples/guestfs-faq.pod:157 ../examples/guestfs-faq.pod:196 ../examples/guestfs-faq.pod:202 ../examples/guestfs-performance.pod:107 ../examples/guestfs-performance.pod:113 ../examples/guestfs-performance.pod:118 ../examples/guestfs-performance.pod:253 ../examples/guestfs-performance.pod:258 ../examples/guestfs-performance.pod:263 ../examples/guestfs-recipes.pod:94 ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102 ../examples/guestfs-recipes.pod:128 ../examples/guestfs-recipes.pod:133 ../examples/guestfs-recipes.pod:223 ../examples/guestfs-recipes.pod:227 ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235 ../examples/guestfs-recipes.pod:239 ../examples/guestfs-testing.pod:110 ../examples/guestfs-testing.pod:114 ../examples/guestfs-testing.pod:118 ../fish/guestfish-actions.pod:414 ../fish/guestfish-actions.pod:422 ../fish/guestfish-actions.pod:429 ../fish/guestfish-actions.pod:436 ../fish/guestfish-actions.pod:1447 ../fish/guestfish-actions.pod:1451 ../fish/guestfish-actions.pod:1455 ../fish/guestfish-actions.pod:1459 ../fish/guestfish-actions.pod:1467 ../fish/guestfish-actions.pod:1471 ../fish/guestfish-actions.pod:1475 ../fish/guestfish-actions.pod:1485 ../fish/guestfish-actions.pod:1489 ../fish/guestfish-actions.pod:1493 ../fish/guestfish-actions.pod:1600 ../fish/guestfish-actions.pod:1604 ../fish/guestfish-actions.pod:1609 ../fish/guestfish-actions.pod:1614 ../fish/guestfish-actions.pod:1656 ../fish/guestfish-actions.pod:1660 ../fish/guestfish-actions.pod:1665 ../fish/guestfish-actions.pod:2111 ../fish/guestfish-actions.pod:2118 ../fish/guestfish-actions.pod:2125 ../fish/guestfish-actions.pod:2538 ../fish/guestfish-actions.pod:2544 ../fish/guestfish-actions.pod:2552 ../fish/guestfish-actions.pod:2559 ../fish/guestfish-actions.pod:2566 ../fish/guestfish.pod:457 ../fish/guestfish.pod:461 ../fish/guestfish.pod:465 ../fish/guestfish.pod:469 ../inspector/virt-inspector.pod:514 ../inspector/virt-inspector.pod:518 ../resize/virt-resize.pod:365 ../resize/virt-resize.pod:369 ../resize/virt-resize.pod:378 ../resize/virt-resize.pod:384 ../sparsify/virt-sparsify.pod:32 ../sparsify/virt-sparsify.pod:39 ../sparsify/virt-sparsify.pod:43 ../sparsify/virt-sparsify.pod:49 ../sparsify/virt-sparsify.pod:54 ../sparsify/virt-sparsify.pod:59 ../src/guestfs-actions.pod:619 ../src/guestfs-actions.pod:627 ../src/guestfs-actions.pod:634 ../src/guestfs-actions.pod:641 ../src/guestfs-actions.pod:2429 ../src/guestfs-actions.pod:2433 ../src/guestfs-actions.pod:2437 ../src/guestfs-actions.pod:2441 ../src/guestfs-actions.pod:2449 ../src/guestfs-actions.pod:2453 ../src/guestfs-actions.pod:2457 ../src/guestfs-actions.pod:2467 ../src/guestfs-actions.pod:2471 ../src/guestfs-actions.pod:2475 ../src/guestfs-actions.pod:2636 ../src/guestfs-actions.pod:2640 ../src/guestfs-actions.pod:2645 ../src/guestfs-actions.pod:2650 ../src/guestfs-actions.pod:2711 ../src/guestfs-actions.pod:2715 ../src/guestfs-actions.pod:2720 ../src/guestfs-actions.pod:3417 ../src/guestfs-actions.pod:3424 ../src/guestfs-actions.pod:3431 ../src/guestfs-actions.pod:3986 ../src/guestfs-actions.pod:3992 ../src/guestfs-actions.pod:4000 ../src/guestfs-actions.pod:4007 ../src/guestfs-actions.pod:4014 ../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:1177 ../src/guestfs.pod:1181 ../src/guestfs.pod:1185 ../src/guestfs.pod:1190 ../src/guestfs.pod:1198 ../src/guestfs.pod:1217 ../src/guestfs.pod:1225 ../src/guestfs.pod:1247 ../src/guestfs.pod:1251 ../src/guestfs.pod:1255 ../src/guestfs.pod:1259 ../src/guestfs.pod:1263 ../src/guestfs.pod:1267 ../src/guestfs.pod:1792 ../src/guestfs.pod:1797 ../src/guestfs.pod:1801 ../src/guestfs.pod:1903 ../src/guestfs.pod:1908 ../src/guestfs.pod:1912 ../src/guestfs.pod:1922 ../src/guestfs.pod:2211 ../src/guestfs.pod:2216 ../src/guestfs.pod:2222 ../src/guestfs.pod:2230 ../src/guestfs.pod:2747 ../src/guestfs.pod:2753 ../src/guestfs.pod:2758 ../src/guestfs.pod:2764 ../src/guestfs.pod:3155 ../src/guestfs.pod:3160 ../src/guestfs.pod:3164 ../src/guestfs.pod:3168 ../src/guestfs.pod:3172 ../src/guestfs.pod:3186 ../src/guestfs.pod:3191 ../src/guestfs.pod:3448 ../src/guestfs.pod:3452 ../src/guestfs.pod:3456 ../src/guestfs.pod:3460 ../sysprep/virt-sysprep.pod:230 ../sysprep/virt-sysprep.pod:234 ../sysprep/virt-sysprep.pod:238 ../sysprep/virt-sysprep.pod:242 ../sysprep/virt-sysprep.pod:257 ../sysprep/virt-sysprep.pod:261 ../sysprep/virt-sysprep.pod:265 ../sysprep/virt-sysprep.pod:269 ../sysprep/virt-sysprep.pod:273 ../sysprep/virt-sysprep.pod:315 ../sysprep/virt-sysprep.pod:327 ../sysprep/virt-sysprep.pod:331 ../sysprep/virt-sysprep.pod:339 ../sysprep/virt-sysprep.pod:345 ../tools/virt-win-reg.pl:197 ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208 ../tools/virt-win-reg.pl:721 ../tools/virt-win-reg.pl:727 ../tools/virt-win-reg.pl:733 +#: ../align/virt-alignment-scan.pod:347 ../align/virt-alignment-scan.pod:353 ../align/virt-alignment-scan.pod:359 ../align/virt-alignment-scan.pod:366 ../appliance/libguestfs-make-fixed-appliance.pod:32 ../appliance/libguestfs-make-fixed-appliance.pod:53 ../cat/virt-cat.pod:177 ../cat/virt-cat.pod:182 ../cat/virt-cat.pod:187 ../cat/virt-cat.pod:198 ../cat/virt-cat.pod:202 ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266 ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276 ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291 ../examples/guestfs-faq.pod:151 ../examples/guestfs-faq.pod:157 ../examples/guestfs-faq.pod:196 ../examples/guestfs-faq.pod:202 ../examples/guestfs-performance.pod:107 ../examples/guestfs-performance.pod:113 ../examples/guestfs-performance.pod:118 ../examples/guestfs-performance.pod:253 ../examples/guestfs-performance.pod:258 ../examples/guestfs-performance.pod:263 ../examples/guestfs-recipes.pod:100 ../examples/guestfs-recipes.pod:104 ../examples/guestfs-recipes.pod:108 ../examples/guestfs-recipes.pod:134 ../examples/guestfs-recipes.pod:139 ../examples/guestfs-recipes.pod:229 ../examples/guestfs-recipes.pod:233 ../examples/guestfs-recipes.pod:237 ../examples/guestfs-recipes.pod:241 ../examples/guestfs-recipes.pod:245 ../examples/guestfs-testing.pod:110 ../examples/guestfs-testing.pod:114 ../examples/guestfs-testing.pod:118 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:444 ../fish/guestfish-actions.pod:452 ../fish/guestfish-actions.pod:459 ../fish/guestfish-actions.pod:466 ../fish/guestfish-actions.pod:1419 ../fish/guestfish-actions.pod:1423 ../fish/guestfish-actions.pod:1427 ../fish/guestfish-actions.pod:1431 ../fish/guestfish-actions.pod:1439 ../fish/guestfish-actions.pod:1443 ../fish/guestfish-actions.pod:1447 ../fish/guestfish-actions.pod:1457 ../fish/guestfish-actions.pod:1461 ../fish/guestfish-actions.pod:1465 ../fish/guestfish-actions.pod:1555 ../fish/guestfish-actions.pod:1559 ../fish/guestfish-actions.pod:1564 ../fish/guestfish-actions.pod:1569 ../fish/guestfish-actions.pod:1611 ../fish/guestfish-actions.pod:1615 ../fish/guestfish-actions.pod:1620 ../fish/guestfish-actions.pod:2006 ../fish/guestfish-actions.pod:2013 ../fish/guestfish-actions.pod:2020 ../fish/guestfish-actions.pod:2433 ../fish/guestfish-actions.pod:2439 ../fish/guestfish-actions.pod:2447 ../fish/guestfish-actions.pod:2454 ../fish/guestfish-actions.pod:2461 ../fish/guestfish.pod:457 ../fish/guestfish.pod:461 ../fish/guestfish.pod:465 ../fish/guestfish.pod:469 ../inspector/virt-inspector.pod:514 ../inspector/virt-inspector.pod:518 ../resize/virt-resize.pod:365 ../resize/virt-resize.pod:369 ../resize/virt-resize.pod:378 ../resize/virt-resize.pod:384 ../sparsify/virt-sparsify.pod:45 ../sparsify/virt-sparsify.pod:52 ../sparsify/virt-sparsify.pod:56 ../sparsify/virt-sparsify.pod:62 ../sparsify/virt-sparsify.pod:67 ../sparsify/virt-sparsify.pod:72 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:29 ../src/guestfs-actions.pod:644 ../src/guestfs-actions.pod:652 ../src/guestfs-actions.pod:659 ../src/guestfs-actions.pod:666 ../src/guestfs-actions.pod:2387 ../src/guestfs-actions.pod:2391 ../src/guestfs-actions.pod:2395 ../src/guestfs-actions.pod:2399 ../src/guestfs-actions.pod:2407 ../src/guestfs-actions.pod:2411 ../src/guestfs-actions.pod:2415 ../src/guestfs-actions.pod:2425 ../src/guestfs-actions.pod:2429 ../src/guestfs-actions.pod:2433 ../src/guestfs-actions.pod:2571 ../src/guestfs-actions.pod:2575 ../src/guestfs-actions.pod:2580 ../src/guestfs-actions.pod:2585 ../src/guestfs-actions.pod:2646 ../src/guestfs-actions.pod:2650 ../src/guestfs-actions.pod:2655 ../src/guestfs-actions.pod:3213 ../src/guestfs-actions.pod:3220 ../src/guestfs-actions.pod:3227 ../src/guestfs-actions.pod:3782 ../src/guestfs-actions.pod:3788 ../src/guestfs-actions.pod:3796 ../src/guestfs-actions.pod:3803 ../src/guestfs-actions.pod:3810 ../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:1197 ../src/guestfs.pod:1201 ../src/guestfs.pod:1205 ../src/guestfs.pod:1210 ../src/guestfs.pod:1218 ../src/guestfs.pod:1237 ../src/guestfs.pod:1245 ../src/guestfs.pod:1262 ../src/guestfs.pod:1267 ../src/guestfs.pod:1271 ../src/guestfs.pod:1328 ../src/guestfs.pod:1332 ../src/guestfs.pod:1336 ../src/guestfs.pod:1340 ../src/guestfs.pod:1344 ../src/guestfs.pod:1348 ../src/guestfs.pod:1863 ../src/guestfs.pod:1868 ../src/guestfs.pod:1872 ../src/guestfs.pod:1974 ../src/guestfs.pod:1979 ../src/guestfs.pod:1983 ../src/guestfs.pod:1993 ../src/guestfs.pod:2282 ../src/guestfs.pod:2287 ../src/guestfs.pod:2293 ../src/guestfs.pod:2301 ../src/guestfs.pod:2818 ../src/guestfs.pod:2824 ../src/guestfs.pod:2829 ../src/guestfs.pod:2835 ../src/guestfs.pod:3226 ../src/guestfs.pod:3231 ../src/guestfs.pod:3235 ../src/guestfs.pod:3239 ../src/guestfs.pod:3243 ../src/guestfs.pod:3257 ../src/guestfs.pod:3262 ../sysprep/virt-sysprep.pod:230 ../sysprep/virt-sysprep.pod:234 ../sysprep/virt-sysprep.pod:238 ../sysprep/virt-sysprep.pod:242 ../sysprep/virt-sysprep.pod:257 ../sysprep/virt-sysprep.pod:261 ../sysprep/virt-sysprep.pod:265 ../sysprep/virt-sysprep.pod:269 ../sysprep/virt-sysprep.pod:273 ../sysprep/virt-sysprep.pod:315 ../sysprep/virt-sysprep.pod:327 ../sysprep/virt-sysprep.pod:331 ../sysprep/virt-sysprep.pod:339 ../sysprep/virt-sysprep.pod:345 ../tools/virt-win-reg.pl:197 ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208 ../tools/virt-win-reg.pl:721 ../tools/virt-win-reg.pl:727 ../tools/virt-win-reg.pl:733 msgid "*" msgstr "" @@ -766,7 +766,7 @@ msgid "successful exit, all partitions are aligned E<ge> 64K for best performanc msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:355 ../src/guestfs.pod:1439 +#: ../align/virt-alignment-scan.pod:355 ../src/guestfs.pod:1520 msgid "1" msgstr "" @@ -776,7 +776,7 @@ msgid "an error scanning the disk image or guest" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:361 ../src/guestfs.pod:1443 +#: ../align/virt-alignment-scan.pod:361 ../src/guestfs.pod:1524 msgid "2" msgstr "" @@ -788,7 +788,7 @@ msgid "" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:368 ../src/guestfs.pod:1447 +#: ../align/virt-alignment-scan.pod:368 ../src/guestfs.pod:1528 msgid "3" msgstr "" @@ -800,7 +800,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:375 ../appliance/libguestfs-make-fixed-appliance.pod:144 ../cat/virt-cat.pod:243 ../cat/virt-filesystems.pod:389 ../cat/virt-ls.pod:495 ../df/virt-df.pod:253 ../edit/virt-edit.pod:368 ../erlang/examples/guestfs-erlang.pod:97 ../examples/guestfs-examples.pod:33 ../examples/guestfs-faq.pod:658 ../examples/guestfs-performance.pod:364 ../examples/guestfs-recipes.pod:380 ../examples/guestfs-testing.pod:291 ../fish/guestfish.pod:1285 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../format/virt-format.pod:177 ../fuse/guestmount.pod:398 ../inspector/virt-inspector.pod:501 ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:40 ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:340 ../resize/virt-resize.pod:702 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:286 ../src/guestfs.pod:3383 ../sysprep/virt-sysprep.pod:442 ../test-tool/libguestfs-test-tool.pod:106 ../tools/virt-list-filesystems.pl:197 ../tools/virt-list-partitions.pl:267 ../tools/virt-make-fs.pl:609 ../tools/virt-tar.pl:294 ../tools/virt-win-reg.pl:757 +#: ../align/virt-alignment-scan.pod:375 ../appliance/libguestfs-make-fixed-appliance.pod:144 ../cat/virt-cat.pod:243 ../cat/virt-filesystems.pod:389 ../cat/virt-ls.pod:495 ../df/virt-df.pod:253 ../edit/virt-edit.pod:368 ../erlang/examples/guestfs-erlang.pod:97 ../examples/guestfs-examples.pod:33 ../examples/guestfs-faq.pod:683 ../examples/guestfs-performance.pod:429 ../examples/guestfs-recipes.pod:391 ../examples/guestfs-testing.pod:291 ../fish/guestfish.pod:1280 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../format/virt-format.pod:177 ../fuse/guestmount.pod:398 ../inspector/virt-inspector.pod:501 ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:40 ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:340 ../resize/virt-resize.pod:702 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:299 ../src/guestfs.pod:3434 ../sysprep/virt-sysprep.pod:442 ../test-tool/libguestfs-test-tool.pod:106 ../tools/virt-list-filesystems.pl:197 ../tools/virt-list-partitions.pl:267 ../tools/virt-make-fs.pl:590 ../tools/virt-tar.pl:294 ../tools/virt-win-reg.pl:757 msgid "SEE ALSO" msgstr "" @@ -812,52 +812,26 @@ msgid "" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:384 ../cat/virt-cat.pod:252 ../cat/virt-filesystems.pod:400 ../cat/virt-ls.pod:507 ../df/virt-df.pod:261 ../edit/virt-edit.pod:382 ../format/virt-format.pod:187 ../rescue/virt-rescue.pod:349 ../resize/virt-resize.pod:725 ../sparsify/virt-sparsify.pod:299 ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:635 ../tools/virt-tar.pl:309 ../tools/virt-win-reg.pl:783 +#: ../align/virt-alignment-scan.pod:384 ../cat/virt-cat.pod:252 ../cat/virt-filesystems.pod:400 ../cat/virt-ls.pod:507 ../df/virt-df.pod:261 ../edit/virt-edit.pod:382 ../format/virt-format.pod:187 ../rescue/virt-rescue.pod:349 ../resize/virt-resize.pod:725 ../sparsify/virt-sparsify.pod:312 ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:605 ../tools/virt-tar.pl:309 ../tools/virt-win-reg.pl:772 msgid "AUTHOR" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:386 ../cat/virt-cat.pod:254 ../cat/virt-filesystems.pod:402 ../cat/virt-ls.pod:509 ../df/virt-df.pod:263 ../edit/virt-edit.pod:384 ../format/virt-format.pod:189 ../inspector/virt-inspector.pod:516 ../rescue/virt-rescue.pod:351 ../resize/virt-resize.pod:727 ../sparsify/virt-sparsify.pod:301 ../sysprep/virt-sysprep.pod:459 ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281 ../tools/virt-make-fs.pl:637 ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:785 +#: ../align/virt-alignment-scan.pod:386 ../cat/virt-cat.pod:254 ../cat/virt-filesystems.pod:402 ../cat/virt-ls.pod:509 ../df/virt-df.pod:263 ../edit/virt-edit.pod:384 ../format/virt-format.pod:189 ../inspector/virt-inspector.pod:516 ../rescue/virt-rescue.pod:351 ../resize/virt-resize.pod:727 ../sparsify/virt-sparsify.pod:314 ../sysprep/virt-sysprep.pod:459 ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281 ../tools/virt-make-fs.pl:607 ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:774 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:388 ../appliance/libguestfs-make-fixed-appliance.pod:157 ../cat/virt-cat.pod:256 ../cat/virt-filesystems.pod:404 ../cat/virt-ls.pod:511 ../df/virt-df.pod:265 ../edit/virt-edit.pod:386 ../erlang/examples/guestfs-erlang.pod:114 ../examples/guestfs-examples.pod:49 ../examples/guestfs-faq.pod:668 ../examples/guestfs-performance.pod:379 ../examples/guestfs-recipes.pod:397 ../examples/guestfs-testing.pod:302 ../fish/guestfish.pod:1317 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../format/virt-format.pod:191 ../fuse/guestmount.pod:413 ../inspector/virt-inspector.pod:524 ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:57 ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:353 ../resize/virt-resize.pod:729 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:303 ../src/guestfs.pod:3471 ../sysprep/virt-sysprep.pod:463 ../test-tool/libguestfs-test-tool.pod:116 ../tools/virt-list-filesystems.pl:214 ../tools/virt-list-partitions.pl:283 ../tools/virt-make-fs.pl:639 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:787 +#: ../align/virt-alignment-scan.pod:388 ../appliance/libguestfs-make-fixed-appliance.pod:157 ../cat/virt-cat.pod:256 ../cat/virt-filesystems.pod:404 ../cat/virt-ls.pod:511 ../df/virt-df.pod:265 ../edit/virt-edit.pod:386 ../erlang/examples/guestfs-erlang.pod:114 ../examples/guestfs-examples.pod:49 ../examples/guestfs-faq.pod:693 ../examples/guestfs-performance.pod:446 ../examples/guestfs-recipes.pod:408 ../examples/guestfs-testing.pod:302 ../fish/guestfish.pod:1312 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../format/virt-format.pod:191 ../fuse/guestmount.pod:413 ../inspector/virt-inspector.pod:524 ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:57 ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:353 ../resize/virt-resize.pod:729 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:316 ../src/guestfs.pod:3489 ../sysprep/virt-sysprep.pod:463 ../test-tool/libguestfs-test-tool.pod:116 ../tools/virt-list-filesystems.pl:214 ../tools/virt-list-partitions.pl:283 ../tools/virt-make-fs.pl:609 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:776 msgid "COPYRIGHT" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:390 ../sparsify/virt-sparsify.pod:305 +#: ../align/virt-alignment-scan.pod:390 msgid "Copyright (C) 2011 Red Hat Inc." msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:392 ../appliance/libguestfs-make-fixed-appliance.pod:162 ../cat/virt-cat.pod:260 ../cat/virt-filesystems.pod:408 ../cat/virt-ls.pod:515 ../df/virt-df.pod:269 ../edit/virt-edit.pod:390 ../fish/guestfish.pod:1322 ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60 ../format/virt-format.pod:195 ../fuse/guestmount.pod:418 ../inspector/virt-inspector.pod:528 ../rescue/virt-rescue.pod:357 ../resize/virt-resize.pod:733 ../sparsify/virt-sparsify.pod:307 ../sysprep/virt-sysprep.pod:469 ../test-tool/libguestfs-test-tool.pod:121 ../tools/virt-list-filesystems.pl:218 ../tools/virt-list-partitions.pl:287 ../tools/virt-make-fs.pl:643 ../tools/virt-tar.pl:317 ../tools/virt-win-reg.pl:791 -msgid "" -"This program is free software; you can redistribute it and/or modify it " -"under the terms of the GNU General Public License as published by the Free " -"Software Foundation; either version 2 of the License, or (at your option) " -"any later version." -msgstr "" - -#. type: textblock -#: ../align/virt-alignment-scan.pod:397 ../appliance/libguestfs-make-fixed-appliance.pod:167 ../cat/virt-cat.pod:265 ../cat/virt-filesystems.pod:413 ../cat/virt-ls.pod:520 ../df/virt-df.pod:274 ../edit/virt-edit.pod:395 ../fish/guestfish.pod:1327 ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65 ../format/virt-format.pod:200 ../fuse/guestmount.pod:423 ../inspector/virt-inspector.pod:533 ../rescue/virt-rescue.pod:362 ../resize/virt-resize.pod:738 ../sparsify/virt-sparsify.pod:312 ../sysprep/virt-sysprep.pod:474 ../test-tool/libguestfs-test-tool.pod:126 ../tools/virt-list-filesystems.pl:223 ../tools/virt-list-partitions.pl:292 ../tools/virt-make-fs.pl:648 ../tools/virt-tar.pl:322 ../tools/virt-win-reg.pl:796 -msgid "" -"This program is distributed in the hope that it will be useful, but WITHOUT " -"ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or " -"FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for " -"more details." -msgstr "" - -#. type: textblock -#: ../align/virt-alignment-scan.pod:402 ../appliance/libguestfs-make-fixed-appliance.pod:172 ../cat/virt-cat.pod:270 ../cat/virt-filesystems.pod:418 ../cat/virt-ls.pod:525 ../df/virt-df.pod:279 ../edit/virt-edit.pod:400 ../fish/guestfish.pod:1332 ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70 ../format/virt-format.pod:205 ../fuse/guestmount.pod:428 ../inspector/virt-inspector.pod:538 ../rescue/virt-rescue.pod:367 ../resize/virt-resize.pod:743 ../sparsify/virt-sparsify.pod:317 ../sysprep/virt-sysprep.pod:479 ../test-tool/libguestfs-test-tool.pod:131 ../tools/virt-list-filesystems.pl:228 ../tools/virt-list-partitions.pl:297 ../tools/virt-make-fs.pl:653 ../tools/virt-tar.pl:327 ../tools/virt-win-reg.pl:801 -msgid "" -"You should have received a copy of the GNU General Public License along with " -"this program; if not, write to the Free Software Foundation, Inc., 51 " -"Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA." -msgstr "" - -#. type: textblock #: ../appliance/libguestfs-make-fixed-appliance.pod:5 msgid "libguestfs-make-fixed-appliance - Make a \"fixed appliance\" for libguestfs" msgstr "" @@ -1104,7 +1078,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../appliance/libguestfs-make-fixed-appliance.pod:139 ../edit/virt-edit.pod:343 ../fish/guestfish.pod:1131 ../rescue/virt-rescue.pod:313 ../sparsify/virt-sparsify.pod:259 ../src/guestfs.pod:3317 ../test-tool/libguestfs-test-tool.pod:101 +#: ../appliance/libguestfs-make-fixed-appliance.pod:139 ../edit/virt-edit.pod:343 ../fish/guestfish.pod:1131 ../rescue/virt-rescue.pod:313 ../sparsify/virt-sparsify.pod:272 ../src/guestfs.pod:3373 ../test-tool/libguestfs-test-tool.pod:101 msgid "ENVIRONMENT VARIABLES" msgstr "" @@ -1123,18 +1097,18 @@ msgid "" msgstr "" #. type: =head1 -#: ../appliance/libguestfs-make-fixed-appliance.pod:153 ../erlang/examples/guestfs-erlang.pod:110 ../examples/guestfs-examples.pod:45 ../examples/guestfs-faq.pod:664 ../examples/guestfs-performance.pod:375 ../examples/guestfs-recipes.pod:393 ../examples/guestfs-testing.pod:298 ../fish/guestfish.pod:1313 ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:409 ../inspector/virt-inspector.pod:510 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:53 ../python/examples/guestfs-python.pod:54 ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3467 ../sysprep/virt-sysprep.pod:457 ../test-tool/libguestfs-test-tool.pod:112 +#: ../appliance/libguestfs-make-fixed-appliance.pod:153 ../erlang/examples/guestfs-erlang.pod:110 ../examples/guestfs-examples.pod:45 ../examples/guestfs-faq.pod:689 ../examples/guestfs-performance.pod:442 ../examples/guestfs-recipes.pod:404 ../examples/guestfs-testing.pod:298 ../fish/guestfish.pod:1308 ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:409 ../inspector/virt-inspector.pod:510 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:53 ../python/examples/guestfs-python.pod:54 ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3485 ../sysprep/virt-sysprep.pod:457 ../test-tool/libguestfs-test-tool.pod:112 msgid "AUTHORS" msgstr "" #. type: textblock -#: ../appliance/libguestfs-make-fixed-appliance.pod:155 ../erlang/examples/guestfs-erlang.pod:112 ../examples/guestfs-examples.pod:47 ../examples/guestfs-faq.pod:666 ../examples/guestfs-performance.pod:377 ../examples/guestfs-recipes.pod:395 ../examples/guestfs-testing.pod:300 ../fish/guestfish.pod:1315 ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:411 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:55 ../python/examples/guestfs-python.pod:56 ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3469 ../test-tool/libguestfs-test-tool.pod:114 +#: ../appliance/libguestfs-make-fixed-appliance.pod:155 ../erlang/examples/guestfs-erlang.pod:112 ../examples/guestfs-examples.pod:47 ../examples/guestfs-faq.pod:691 ../examples/guestfs-performance.pod:444 ../examples/guestfs-recipes.pod:406 ../examples/guestfs-testing.pod:300 ../fish/guestfish.pod:1310 ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:411 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:55 ../python/examples/guestfs-python.pod:56 ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3487 ../test-tool/libguestfs-test-tool.pod:114 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)" msgstr "" #. type: textblock -#: ../appliance/libguestfs-make-fixed-appliance.pod:159 ../fish/guestfish.pod:1319 ../fuse/guestmount.pod:415 ../src/guestfs.pod:3473 ../test-tool/libguestfs-test-tool.pod:118 -msgid "Copyright (C) 2009-2012 Red Hat Inc. L<http://libguestfs.org/>" +#: ../appliance/libguestfs-make-fixed-appliance.pod:159 ../cat/virt-ls.pod:513 ../df/virt-df.pod:267 ../edit/virt-edit.pod:388 ../examples/guestfs-recipes.pod:410 ../fish/guestfish.pod:1314 ../fuse/guestmount.pod:415 ../rescue/virt-rescue.pod:355 ../src/guestfs.pod:3491 ../test-tool/libguestfs-test-tool.pod:118 ../tools/virt-list-partitions.pl:285 +msgid "Copyright (C) 2009-2012 Red Hat Inc." msgstr "" #. type: textblock @@ -1203,7 +1177,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:32 ../cat/virt-ls.pod:35 ../df/virt-df.pod:43 ../edit/virt-edit.pod:44 ../fish/guestfish.pod:41 ../fish/guestfish.pod:1063 ../fish/virt-copy-in.pod:29 ../fish/virt-copy-out.pod:21 ../fish/virt-tar-in.pod:30 ../fish/virt-tar-out.pod:24 ../fuse/guestmount.pod:39 ../resize/virt-resize.pod:27 ../sparsify/virt-sparsify.pod:70 ../tools/virt-tar.pl:50 +#: ../cat/virt-cat.pod:32 ../cat/virt-ls.pod:35 ../df/virt-df.pod:43 ../edit/virt-edit.pod:44 ../fish/guestfish.pod:41 ../fish/guestfish.pod:1063 ../fish/virt-copy-in.pod:29 ../fish/virt-copy-out.pod:21 ../fish/virt-tar-in.pod:30 ../fish/virt-tar-out.pod:24 ../fuse/guestmount.pod:39 ../resize/virt-resize.pod:27 ../sparsify/virt-sparsify.pod:83 ../tools/virt-tar.pl:50 msgid "EXAMPLES" msgstr "" @@ -1491,7 +1465,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:240 ../cat/virt-filesystems.pod:386 ../cat/virt-ls.pod:492 ../df/virt-df.pod:250 ../edit/virt-edit.pod:365 ../fuse/guestmount.pod:395 ../inspector/virt-inspector.pod:498 ../resize/virt-resize.pod:699 ../sparsify/virt-sparsify.pod:256 +#: ../cat/virt-cat.pod:240 ../cat/virt-filesystems.pod:386 ../cat/virt-ls.pod:492 ../df/virt-df.pod:250 ../edit/virt-edit.pod:365 ../fuse/guestmount.pod:395 ../inspector/virt-inspector.pod:498 ../resize/virt-resize.pod:699 ../sparsify/virt-sparsify.pod:269 msgid "This program returns 0 if successful, or non-zero if there was an error." msgstr "" @@ -1503,7 +1477,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:258 ../inspector/virt-inspector.pod:526 ../resize/virt-resize.pod:731 ../tools/virt-make-fs.pl:641 +#: ../cat/virt-cat.pod:258 ../cat/virt-filesystems.pod:406 ../examples/guestfs-examples.pod:51 ../inspector/virt-inspector.pod:526 ../ocaml/examples/guestfs-ocaml.pod:97 ../python/examples/guestfs-python.pod:60 ../resize/virt-resize.pod:731 ../ruby/examples/guestfs-ruby.pod:54 ../tools/virt-make-fs.pl:611 msgid "Copyright (C) 2010-2012 Red Hat Inc." msgstr "" @@ -2167,11 +2141,6 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:406 ../tools/virt-win-reg.pl:789 -msgid "Copyright (C) 2010 Red Hat Inc." -msgstr "" - -#. type: textblock #: ../cat/virt-ls.pod:5 msgid "virt-ls - List files in a virtual machine" msgstr "" @@ -2570,7 +2539,7 @@ msgid "" msgstr "" #. type: =head2 -#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:5199 +#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:5064 msgid "path" msgstr "" @@ -2918,11 +2887,6 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-ls.pod:513 ../df/virt-df.pod:267 ../edit/virt-edit.pod:388 ../rescue/virt-rescue.pod:355 ../tools/virt-list-partitions.pl:285 -msgid "Copyright (C) 2009-2012 Red Hat Inc." -msgstr "" - -#. type: textblock #: ../df/virt-df.pod:5 msgid "virt-df - Display free space on virtual filesystems" msgstr "" @@ -3945,41 +3909,8 @@ msgid "" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:116 ../examples/guestfs-testing.pod:304 ../java/examples/guestfs-java.pod:64 ../perl/examples/guestfs-perl.pod:59 -msgid "Copyright (C) 2011 Red Hat Inc. L<http://libguestfs.org/>" -msgstr "" - -#. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:118 ../examples/guestfs-examples.pod:53 ../examples/guestfs-recipes.pod:401 ../java/examples/guestfs-java.pod:66 ../ocaml/examples/guestfs-ocaml.pod:99 ../perl/examples/guestfs-perl.pod:61 ../python/examples/guestfs-python.pod:62 ../ruby/examples/guestfs-ruby.pod:56 -msgid "" -"The examples in this manual page may be freely copied, modified and " -"distributed without any restrictions." -msgstr "" - -#. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:121 ../examples/guestfs-examples.pod:56 ../examples/guestfs-faq.pod:672 ../examples/guestfs-performance.pod:383 ../examples/guestfs-recipes.pod:404 ../examples/guestfs-testing.pod:306 ../java/examples/guestfs-java.pod:69 ../ocaml/examples/guestfs-ocaml.pod:102 ../perl/examples/guestfs-perl.pod:64 ../python/examples/guestfs-python.pod:65 ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3476 -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 " -"Free Software Foundation; either version 2 of the License, or (at your " -"option) any later version." -msgstr "" - -#. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:126 ../examples/guestfs-examples.pod:61 ../examples/guestfs-faq.pod:677 ../examples/guestfs-performance.pod:388 ../examples/guestfs-recipes.pod:409 ../examples/guestfs-testing.pod:311 ../java/examples/guestfs-java.pod:74 ../ocaml/examples/guestfs-ocaml.pod:107 ../perl/examples/guestfs-perl.pod:69 ../python/examples/guestfs-python.pod:70 ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3481 -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 " -"FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License " -"for more details." -msgstr "" - -#. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:131 ../examples/guestfs-examples.pod:66 ../examples/guestfs-faq.pod:682 ../examples/guestfs-performance.pod:393 ../examples/guestfs-recipes.pod:414 ../examples/guestfs-testing.pod:316 ../java/examples/guestfs-java.pod:79 ../ocaml/examples/guestfs-ocaml.pod:112 ../perl/examples/guestfs-perl.pod:74 ../python/examples/guestfs-python.pod:75 ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3486 -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, " -"Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA" +#: ../erlang/examples/guestfs-erlang.pod:116 ../examples/guestfs-testing.pod:304 ../fish/virt-copy-in.pod:66 ../fish/virt-copy-out.pod:55 ../fish/virt-tar-in.pod:64 ../fish/virt-tar-out.pod:57 ../java/examples/guestfs-java.pod:64 ../perl/examples/guestfs-perl.pod:59 ../sparsify/virt-sparsify.pod:318 ../sysprep/virt-sysprep.pod:465 +msgid "Copyright (C) 2011-2012 Red Hat Inc." msgstr "" #. type: textblock @@ -4032,11 +3963,6 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-examples.pod:51 ../ocaml/examples/guestfs-ocaml.pod:97 ../python/examples/guestfs-python.pod:60 ../ruby/examples/guestfs-ruby.pod:54 -msgid "Copyright (C) 2010 Red Hat Inc. L<http://libguestfs.org/>" -msgstr "" - -#. type: textblock #: ../examples/guestfs-faq.pod:5 msgid "guestfs-faq - libguestfs Frequently Asked Questions (FAQ)" msgstr "" @@ -4274,7 +4200,7 @@ msgid "Please use the following link to enter a bug in Bugzilla:" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:122 ../src/guestfs.pod:3442 +#: ../examples/guestfs-faq.pod:122 msgid "L<https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools>" msgstr "" @@ -4469,7 +4395,7 @@ msgid "DOWNLOADING, INSTALLING, COMPILING LIBGUESTFS" msgstr "" #. type: =end -#: ../examples/guestfs-faq.pod:219 ../examples/guestfs-faq.pod:224 ../examples/guestfs-faq.pod:431 ../examples/guestfs-faq.pod:436 ../src/guestfs.pod:2357 ../src/guestfs.pod:2362 +#: ../examples/guestfs-faq.pod:219 ../examples/guestfs-faq.pod:224 ../examples/guestfs-faq.pod:449 ../examples/guestfs-faq.pod:454 ../examples/guestfs-faq.pod:573 ../examples/guestfs-faq.pod:578 ../src/guestfs.pod:2428 ../src/guestfs.pod:2433 msgid "html" msgstr "" @@ -4522,35 +4448,33 @@ msgstr "" #. type: =item #: ../examples/guestfs-faq.pod:244 -msgid "RHEL 6.3" +msgid "RHEL 6.4" msgstr "" #. type: textblock #: ../examples/guestfs-faq.pod:246 -msgid "" -"Preview packages are available here: " -"L<http://people.redhat.com/~rjones/libguestfs-RHEL-6.3-preview/>" +msgid "A preview repository will be announced at a later date." msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:249 +#: ../examples/guestfs-faq.pod:248 msgid "Debian Squeeze (6)" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:251 +#: ../examples/guestfs-faq.pod:250 msgid "" "Use Hilko Bengen's backport repository: " "L<http://people.debian.org/~bengen/libguestfs/>" msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:254 +#: ../examples/guestfs-faq.pod:253 msgid "Debian Wheezy and later (7+)" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:256 +#: ../examples/guestfs-faq.pod:255 msgid "" "Official Debian packages are available: " "L<http://packages.debian.org/search?keywords=libguestfs> (thanks Hilko " @@ -4558,12 +4482,12 @@ msgid "" msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:260 +#: ../examples/guestfs-faq.pod:259 msgid "Ubuntu" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:262 +#: ../examples/guestfs-faq.pod:261 msgid "" "We don't have an Ubuntu maintainer, and the packages supplied by Canonical " "(which are outside our control) are often broken. Try compiling from source " @@ -4571,7 +4495,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:266 +#: ../examples/guestfs-faq.pod:265 msgid "" "Canonical decided to change the permissions on the kernel so that it's not " "readable except by root. This is completely stupid, but they won't change " @@ -4580,7 +4504,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:272 ../examples/guestfs-faq.pod:298 +#: ../examples/guestfs-faq.pod:271 ../examples/guestfs-faq.pod:297 #, no-wrap msgid "" " sudo chmod 0644 /boot/vmlinuz*\n" @@ -4588,41 +4512,41 @@ msgid "" msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:274 +#: ../examples/guestfs-faq.pod:273 msgid "Ubuntu 10.04" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:276 +#: ../examples/guestfs-faq.pod:275 msgid "See: L<http://libguestfs.org/download/binaries/ubuntu1004-packages/>" msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:279 +#: ../examples/guestfs-faq.pod:278 msgid "Ubuntu 12.04" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:281 +#: ../examples/guestfs-faq.pod:280 msgid "" "libguestfs in this version of Ubuntu works, but you need to update " "febootstrap and seabios to the latest versions." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:284 +#: ../examples/guestfs-faq.pod:283 msgid "" "You need febootstrap E<ge> 3.14-2 from: " "L<http://packages.ubuntu.com/precise/febootstrap>" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:287 +#: ../examples/guestfs-faq.pod:286 msgid "After installing or updating febootstrap, rebuild the appliance:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:289 +#: ../examples/guestfs-faq.pod:288 #, no-wrap msgid "" " sudo update-guestfs-appliance\n" @@ -4630,7 +4554,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:291 +#: ../examples/guestfs-faq.pod:290 msgid "" "You need seabios E<ge> 0.6.2-0ubuntu2.1 or E<ge> 0.6.2-0ubuntu3 from: " "L<http://packages.ubuntu.com/precise-updates/seabios> or " @@ -4638,22 +4562,22 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:296 +#: ../examples/guestfs-faq.pod:295 msgid "Also you need to do (see above):" msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:300 +#: ../examples/guestfs-faq.pod:299 msgid "Gentoo" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:302 +#: ../examples/guestfs-faq.pod:301 msgid "Libguestfs was added to Gentoo in 2012-07. Do:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:304 +#: ../examples/guestfs-faq.pod:303 #, no-wrap msgid "" " emerge libguestfs\n" @@ -4661,32 +4585,32 @@ msgid "" msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:306 +#: ../examples/guestfs-faq.pod:305 msgid "Other Linux distro" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:308 +#: ../examples/guestfs-faq.pod:307 msgid "Compile from source (next section)." msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:310 +#: ../examples/guestfs-faq.pod:309 msgid "Other non-Linux distro" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:312 +#: ../examples/guestfs-faq.pod:311 msgid "You'll have to compile from source, and port it." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:316 +#: ../examples/guestfs-faq.pod:315 msgid "How can I compile and install libguestfs from source?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:318 +#: ../examples/guestfs-faq.pod:317 msgid "" "If your Linux distro has a working port of febootstrap (that is, Fedora, Red " "Hat Enterprise Linux >= 6.3, Debian, Ubuntu and ArchLinux) then you should " @@ -4696,33 +4620,33 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:324 +#: ../examples/guestfs-faq.pod:323 msgid "" "If you I<don't> have febootstrap, you will need to use the \"fixed appliance " "method\". See: L<http://libguestfs.org/download/binaries/appliance/>" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:328 +#: ../examples/guestfs-faq.pod:327 msgid "Patches to port febootstrap to more Linux distros are welcome." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:330 +#: ../examples/guestfs-faq.pod:329 msgid "" "Why do I get an error when I try to rebuild from the source RPMs supplied by " "Red Hat / Fedora?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:333 +#: ../examples/guestfs-faq.pod:332 msgid "" "Because of the complexity of building the libguestfs appliance, the source " "RPMs provided cannot be rebuilt directly using C<rpmbuild> or C<mock>." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:337 +#: ../examples/guestfs-faq.pod:336 msgid "" "If you use Koji (which is open source software and may be installed " "locally), then the SRPMs can be rebuilt in Koji. " @@ -4730,7 +4654,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:341 +#: ../examples/guestfs-faq.pod:340 msgid "" "If you don't have or want to use Koji, then you have to give libguestfs " "access to the network so it can download the RPMs for building the " @@ -4739,7 +4663,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:347 +#: ../examples/guestfs-faq.pod:346 #, no-wrap msgid "" " %libguestfs_buildnet 1\n" @@ -4747,12 +4671,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:349 +#: ../examples/guestfs-faq.pod:348 msgid "If you are using mock, do:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:351 +#: ../examples/guestfs-faq.pod:350 #, no-wrap msgid "" " mock -D '%libguestfs_buildnet 1' [etc]\n" @@ -4760,22 +4684,22 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:353 +#: ../examples/guestfs-faq.pod:352 msgid "Libguestfs has a really long list of dependencies!" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:355 +#: ../examples/guestfs-faq.pod:354 msgid "That's because it does a lot of things." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:357 +#: ../examples/guestfs-faq.pod:356 msgid "How can I speed up libguestfs builds?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:359 +#: ../examples/guestfs-faq.pod:358 msgid "" "By far the most important thing you can do is to install and properly " "configure Squid. Note that the default configuration that ships with Squid " @@ -4783,45 +4707,45 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:363 +#: ../examples/guestfs-faq.pod:362 msgid "" "A very good place to start with Squid configuration is here: " "L<https://fedoraproject.org/wiki/Extras/MockTricks#Using_Squid_to_Speed_Up_Mock_package_downloads>" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:366 +#: ../examples/guestfs-faq.pod:365 msgid "" "Make sure Squid is running, and that the environment variables " "C<$http_proxy> and C<$ftp_proxy> are pointing to it." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:369 +#: ../examples/guestfs-faq.pod:368 msgid "" "With Squid running and correctly configured, appliance builds should be " "reduced to a few minutes." msgstr "" #. type: =head1 -#: ../examples/guestfs-faq.pod:372 +#: ../examples/guestfs-faq.pod:371 msgid "SPEED, DISK SPACE USED BY LIBGUESTFS" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:374 +#: ../examples/guestfs-faq.pod:373 msgid "" "Note: Most of the information in this section has moved: " "L<guestfs-performance(1)>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:377 +#: ../examples/guestfs-faq.pod:376 msgid "Upload or write seem very slow." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:379 +#: ../examples/guestfs-faq.pod:378 msgid "" "In libguestfs E<lt> 1.13.16, the mount command (L<guestfs(3)/guestfs_mount>) " "enabled option C<-o sync> implicitly. This causes very poor write " @@ -4829,14 +4753,14 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:384 +#: ../examples/guestfs-faq.pod:383 msgid "" "For libguestfs E<lt> 1.13.16, replace mount with C<mount-options>, leaving " "the first parameter as an empty string." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:387 +#: ../examples/guestfs-faq.pod:386 msgid "" "You can also do this with more recent versions of libguestfs, but if you " "know that you are using libguestfs ≥ 1.13.16 then it's safe to use plain " @@ -4844,7 +4768,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:391 +#: ../examples/guestfs-faq.pod:390 msgid "" "If the underlying disk is not fully allocated (eg. sparse raw or qcow2) then " "writes can be slow because the host operating system has to do costly disk " @@ -4854,17 +4778,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:397 +#: ../examples/guestfs-faq.pod:396 msgid "Libguestfs uses too much disk space!" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:399 +#: ../examples/guestfs-faq.pod:398 msgid "libguestfs caches a large-ish appliance in:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:401 +#: ../examples/guestfs-faq.pod:400 #, no-wrap msgid "" " /var/tmp/.guestfs-<UID>\n" @@ -4872,36 +4796,82 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:403 +#: ../examples/guestfs-faq.pod:402 msgid "" "If the environment variable C<TMPDIR> is defined, then " "C<$TMPDIR/.guestfs-E<lt>UIDE<gt>> is used instead." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:406 +#: ../examples/guestfs-faq.pod:405 msgid "It is safe to delete this directory when you are not using libguestfs." msgstr "" +#. type: =head2 +#: ../examples/guestfs-faq.pod:407 +msgid "" +"virt-sparsify seems to make the image grow to the full size of the virtual " +"disk" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-faq.pod:410 +msgid "" +"If the input to L<virt-sparsify(1)> is raw, then the output will be raw " +"sparse. Make sure you are measuring the output with a tool which " +"understands sparseness such as C<du-sh>. It can make a huge difference:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-faq.pod:414 ../sparsify/virt-sparsify.pod:34 +#, no-wrap +msgid "" +" $ ls -lh test1.img\n" +" -rw-rw-r--. 1 rjones rjones 100M Aug 8 08:08 test1.img\n" +" $ du -sh test1.img\n" +" 3.6M\ttest1.img\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-faq.pod:419 ../sparsify/virt-sparsify.pod:39 +msgid "(Compare the apparent size B<100M> vs the actual size B<3.6M>)" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-faq.pod:421 +msgid "" +"If all this confuses you, use a non-sparse output by specifying the " +"I<--convert> option, eg:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-faq.pod:424 +#, no-wrap +msgid "" +" virt-sparsify --convert qcow2 disk.raw disk.qcow2\n" +"\n" +msgstr "" + #. type: =head1 -#: ../examples/guestfs-faq.pod:408 +#: ../examples/guestfs-faq.pod:426 msgid "USING LIBGUESTFS IN YOUR OWN PROGRAMS" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:410 +#: ../examples/guestfs-faq.pod:428 msgid "The API has hundreds of methods, where do I start?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:412 +#: ../examples/guestfs-faq.pod:430 msgid "" "We recommend you start by reading the API overview: L<guestfs(3)/API " "OVERVIEW>." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:415 +#: ../examples/guestfs-faq.pod:433 msgid "" "Although the API overview covers the C API, it is still worth reading even " "if you are going to use another programming language, because the API is the " @@ -4909,7 +4879,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:420 +#: ../examples/guestfs-faq.pod:438 #, no-wrap msgid "" " C guestfs_ln_sf (g, target, linkname);\n" @@ -4922,7 +4892,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:427 +#: ../examples/guestfs-faq.pod:445 msgid "" "Once you're familiar with the API overview, you should look at this list of " "starting points for other language bindings: L<guestfs(3)/USING LIBGUESTFS " @@ -4930,17 +4900,17 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:433 +#: ../examples/guestfs-faq.pod:451 msgid "<!-- old anchor for the next section --> <a name=\"debug\"/>" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:438 +#: ../examples/guestfs-faq.pod:456 msgid "Can I use libguestfs in my proprietary / closed source / commercial program?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:440 +#: ../examples/guestfs-faq.pod:458 msgid "" "In general, yes. However this is not legal advice. You should read the " "license that comes with libguestfs, and if you have specific questions about " @@ -4950,43 +4920,43 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-faq.pod:447 +#: ../examples/guestfs-faq.pod:465 msgid "DEBUGGING LIBGUESTFS" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:449 +#: ../examples/guestfs-faq.pod:467 msgid "" "How do I debug when using any libguestfs program or tool (eg. virt-v2v or " "virt-df)?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:452 +#: ../examples/guestfs-faq.pod:470 msgid "" "There are two C<LIBGUESTFS_*> environment variables you can set in order to " "get more information from libguestfs." msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:457 +#: ../examples/guestfs-faq.pod:475 msgid "C<LIBGUESTFS_TRACE>" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:459 +#: ../examples/guestfs-faq.pod:477 msgid "" "Set this to 1 and libguestfs will print out each command / API call in a " "format which is similar to guestfish commands." msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:462 +#: ../examples/guestfs-faq.pod:480 msgid "C<LIBGUESTFS_DEBUG>" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:464 +#: ../examples/guestfs-faq.pod:482 msgid "" "Set this to 1 in order to enable massive amounts of debug messages. If you " "think there is some problem inside the libguestfs appliance, then you should " @@ -4994,12 +4964,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:470 +#: ../examples/guestfs-faq.pod:488 msgid "To set these from the shell, do this before running the program:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:472 +#: ../examples/guestfs-faq.pod:490 #, no-wrap msgid "" " export LIBGUESTFS_TRACE=1\n" @@ -5008,12 +4978,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:475 +#: ../examples/guestfs-faq.pod:493 msgid "For csh/tcsh the equivalent commands would be:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:477 +#: ../examples/guestfs-faq.pod:495 #, no-wrap msgid "" " setenv LIBGUESTFS_TRACE 1\n" @@ -5022,17 +4992,17 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:480 +#: ../examples/guestfs-faq.pod:498 msgid "For further information, see: L<guestfs(3)/ENVIRONMENT VARIABLES>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:482 +#: ../examples/guestfs-faq.pod:500 msgid "How do I debug when using guestfish?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:484 +#: ../examples/guestfs-faq.pod:502 msgid "" "You can use the same environment variables above. Alternatively use the " "guestfish options -x (to trace commands) or -v (to get the full debug " @@ -5040,24 +5010,24 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:488 +#: ../examples/guestfs-faq.pod:506 msgid "For further information, see: L<guestfish(1)>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:490 +#: ../examples/guestfs-faq.pod:508 msgid "How do I debug when using the API?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:492 +#: ../examples/guestfs-faq.pod:510 msgid "" "Call L<guestfs(3)/guestfs_set_trace> to enable command traces, and/or " "L<guestfs(3)/guestfs_set_verbose> to enable debug messages." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:495 +#: ../examples/guestfs-faq.pod:513 msgid "" "For best results, call these functions as early as possible, just after " "creating the guestfs handle if you can, and definitely before calling " @@ -5065,36 +5035,36 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:499 +#: ../examples/guestfs-faq.pod:517 msgid "How do I capture debug output and put it into my logging system?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:501 +#: ../examples/guestfs-faq.pod:519 msgid "" "Use the event API. For examples, see: L<guestfs(3)/SETTING CALLBACKS TO " "HANDLE EVENTS>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:504 +#: ../examples/guestfs-faq.pod:522 msgid "Digging deeper into the appliance boot process." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:506 +#: ../examples/guestfs-faq.pod:524 msgid "" "Enable debugging and then read this documentation on the appliance boot " "process: L<guestfs(3)/INTERNALS>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:509 +#: ../examples/guestfs-faq.pod:527 msgid "libguestfs hangs or fails during run/launch." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:511 +#: ../examples/guestfs-faq.pod:529 msgid "" "Enable debugging and look at the full output. If you cannot work out what " "is going on, file a bug report, including the I<complete> output of " @@ -5102,17 +5072,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-faq.pod:515 +#: ../examples/guestfs-faq.pod:533 msgid "DESIGN/INTERNALS OF LIBGUESTFS" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:517 +#: ../examples/guestfs-faq.pod:535 msgid "Why don't you do everything through the FUSE / filesystem interface?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:520 +#: ../examples/guestfs-faq.pod:538 msgid "" "We offer a command called L<guestmount(1)> which lets you mount guest " "filesystems on the host. This is implemented as a FUSE module. Why don't " @@ -5121,7 +5091,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:525 +#: ../examples/guestfs-faq.pod:543 msgid "" "The reasons are twofold. Firstly, libguestfs offers API calls for doing " "things like creating and deleting partitions and logical volumes, which " @@ -5135,7 +5105,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:535 +#: ../examples/guestfs-faq.pod:553 msgid "" "The second reason is for efficiency. FUSE itself is reasonably efficient, " "but it does make lots of small, independent calls into the FUSE module. In " @@ -5148,17 +5118,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:545 +#: ../examples/guestfs-faq.pod:563 msgid "Why don't you do everything through GVFS?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:547 +#: ../examples/guestfs-faq.pod:565 msgid "The problems are similar to the problems with FUSE." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:549 +#: ../examples/guestfs-faq.pod:567 msgid "" "GVFS is a better abstraction than POSIX/FUSE. There is an FTP backend for " "GVFS, which is encouraging because FTP is conceptually similar to the " @@ -5167,13 +5137,18 @@ msgid "" "libguestfs." msgstr "" +#. type: textblock +#: ../examples/guestfs-faq.pod:575 +msgid "<!-- old anchor for the next section --> <a name=\"backup\"/>" +msgstr "" + #. type: =head2 -#: ../examples/guestfs-faq.pod:555 +#: ../examples/guestfs-faq.pod:580 msgid "Can I use C<guestfish --ro> as a way to backup my virtual machines?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:557 +#: ../examples/guestfs-faq.pod:582 msgid "" "Usually this is not a good idea. The question is answered in more detail in " "this mailing list posting: " @@ -5181,19 +5156,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:561 +#: ../examples/guestfs-faq.pod:586 msgid "What's the difference between guestfish and virt-rescue?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:563 +#: ../examples/guestfs-faq.pod:588 msgid "" "A lot of people are confused by the two superficially similar tools we " "provide:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:566 +#: ../examples/guestfs-faq.pod:591 #, no-wrap msgid "" " $ guestfish --ro -a guest.img\n" @@ -5203,7 +5178,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:570 +#: ../examples/guestfs-faq.pod:595 #, no-wrap msgid "" " $ virt-rescue --ro guest.img\n" @@ -5212,7 +5187,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:573 +#: ../examples/guestfs-faq.pod:598 msgid "" "And the related question which then arises is why you can't type in full " "shell commands with all the --options in guestfish (but you can in " @@ -5220,7 +5195,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:577 +#: ../examples/guestfs-faq.pod:602 msgid "" "L<guestfish(1)> is a program providing structured access to the " "L<guestfs(3)> API. It happens to be a nice interactive shell too, but its " @@ -5231,7 +5206,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:584 +#: ../examples/guestfs-faq.pod:609 msgid "" "L<virt-rescue(1)> is a free-for-all freeform way to boot the libguestfs " "appliance and make arbitrary changes to your VM. It's not structured, you " @@ -5240,7 +5215,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:589 +#: ../examples/guestfs-faq.pod:614 msgid "" "But, libguestfs also has a \"backdoor\" into the appliance allowing you to " "send arbitrary shell commands. It's not as flexible as virt-rescue, because " @@ -5248,7 +5223,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:594 +#: ../examples/guestfs-faq.pod:619 #, no-wrap msgid "" " ><fs> debug sh \"cmd arg1 arg2 ...\"\n" @@ -5256,7 +5231,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:596 +#: ../examples/guestfs-faq.pod:621 msgid "" "Note that you should B<not> rely on this. It could be removed or changed in " "future. If your program needs some operation, please add it to the " @@ -5264,7 +5239,7 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:600 +#: ../examples/guestfs-faq.pod:625 msgid "" "What's the deal with C<guestfish -i>? Why does virt-cat only work on a real " "VM image, but virt-df works on any disk image? What does \"no root device " @@ -5272,28 +5247,28 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:605 +#: ../examples/guestfs-faq.pod:630 msgid "" "These questions are all related at a fundamental level which may not be " "immediately obvious." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:608 +#: ../examples/guestfs-faq.pod:633 msgid "" "At the L<guestfs(3)> API level, a \"disk image\" is just a pile of " "partitions and filesystems." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:611 +#: ../examples/guestfs-faq.pod:636 msgid "" "In contrast, when the virtual machine boots, it mounts those filesystems " "into a consistent hierarchy such as:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:614 +#: ../examples/guestfs-faq.pod:639 #, no-wrap msgid "" " / (/dev/sda2)\n" @@ -5309,12 +5284,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:624 +#: ../examples/guestfs-faq.pod:649 msgid "(or drive letters on Windows)." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:626 +#: ../examples/guestfs-faq.pod:651 msgid "" "The API first of all sees the disk image at the \"pile of filesystems\" " "level. But it also has a way to inspect the disk image to see if it " @@ -5323,12 +5298,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:631 +#: ../examples/guestfs-faq.pod:656 msgid "Users expect some tools (like L<virt-cat(1)>) to work with VM paths:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:633 +#: ../examples/guestfs-faq.pod:658 #, no-wrap msgid "" " virt-cat fedora.img /var/log/messages\n" @@ -5336,7 +5311,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:635 +#: ../examples/guestfs-faq.pod:660 msgid "" "How does virt-cat know that C</var> is a separate partition? The trick is " "that virt-cat performs inspection on the disk image, and uses that to " @@ -5344,7 +5319,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:639 +#: ../examples/guestfs-faq.pod:664 msgid "" "Some tools (including L<virt-cat(1)>, L<virt-edit(1)>, L<virt-ls(1)>) use " "inspection to map VM paths. Other tools, such as L<virt-df(1)> and " @@ -5353,7 +5328,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:644 +#: ../examples/guestfs-faq.pod:669 msgid "" "L<guestfish(1)> is in an interesting middle ground. If you use the I<-a> " "and I<-m> command line options, then you have to tell guestfish exactly how " @@ -5361,14 +5336,14 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:649 +#: ../examples/guestfs-faq.pod:674 msgid "" "If you use the I<-i> option, libguestfs performs inspection and mounts the " "filesystems for you." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:652 +#: ../examples/guestfs-faq.pod:677 msgid "" "The error C<no root device found in this operating system image> is related " "to this. It means inspection was unable to locate an operating system " @@ -5378,13 +5353,13 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:660 +#: ../examples/guestfs-faq.pod:685 msgid "L<guestfish(1)>, L<guestfs(3)>, L<http://libguestfs.org/>." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:670 ../examples/guestfs-performance.pod:381 -msgid "Copyright (C) 2012 Red Hat Inc. L<http://libguestfs.org/>" +#: ../examples/guestfs-faq.pod:695 ../examples/guestfs-performance.pod:448 ../format/virt-format.pod:193 +msgid "Copyright (C) 2012 Red Hat Inc." msgstr "" #. type: textblock @@ -5679,7 +5654,7 @@ msgid "" msgstr "" #. type: =item -#: ../examples/guestfs-performance.pod:162 ../examples/guestfs-performance.pod:211 ../resize/virt-resize.pod:31 ../resize/virt-resize.pod:603 ../sparsify/virt-sparsify.pod:230 ../src/guestfs.pod:469 ../src/guestfs.pod:1370 ../src/guestfs.pod:1534 ../src/guestfs.pod:2792 +#: ../examples/guestfs-performance.pod:162 ../examples/guestfs-performance.pod:211 ../resize/virt-resize.pod:31 ../resize/virt-resize.pod:603 ../sparsify/virt-sparsify.pod:243 ../src/guestfs.pod:469 ../src/guestfs.pod:1282 ../src/guestfs.pod:1451 ../src/guestfs.pod:1615 ../src/guestfs.pod:2863 msgid "1." msgstr "" @@ -5691,7 +5666,7 @@ msgid "" msgstr "" #. type: =item -#: ../examples/guestfs-performance.pod:168 ../examples/guestfs-performance.pod:218 ../resize/virt-resize.pod:44 ../resize/virt-resize.pod:610 ../sparsify/virt-sparsify.pod:237 ../src/guestfs.pod:475 ../src/guestfs.pod:1374 ../src/guestfs.pod:1538 ../src/guestfs.pod:2817 +#: ../examples/guestfs-performance.pod:168 ../examples/guestfs-performance.pod:218 ../resize/virt-resize.pod:44 ../resize/virt-resize.pod:610 ../sparsify/virt-sparsify.pod:250 ../src/guestfs.pod:475 ../src/guestfs.pod:1286 ../src/guestfs.pod:1455 ../src/guestfs.pod:1619 ../src/guestfs.pod:2888 msgid "2." msgstr "" @@ -5706,7 +5681,7 @@ msgid "" msgstr "" #. type: =item -#: ../examples/guestfs-performance.pod:176 ../examples/guestfs-performance.pod:224 ../resize/virt-resize.pod:52 ../resize/virt-resize.pod:616 ../sparsify/virt-sparsify.pod:243 ../src/guestfs.pod:486 ../src/guestfs.pod:1544 +#: ../examples/guestfs-performance.pod:176 ../examples/guestfs-performance.pod:224 ../resize/virt-resize.pod:52 ../resize/virt-resize.pod:616 ../sparsify/virt-sparsify.pod:256 ../src/guestfs.pod:486 ../src/guestfs.pod:1290 ../src/guestfs.pod:1625 msgid "3." msgstr "" @@ -5913,23 +5888,62 @@ msgstr "" #. type: =head1 #: ../examples/guestfs-performance.pod:298 -msgid "DETAILED TIMINGS USING SYSTEMTAP" +msgid "DETAILED TIMINGS USING ANNOTATE" msgstr "" #. type: textblock #: ../examples/guestfs-performance.pod:300 msgid "" +"Use the L<annotate(1)>/L<annotate-output(1)> command to show detailed " +"timings:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-performance.pod:303 +#, no-wrap +msgid "" +" $ annotate-output +'%T.%N' guestfish -a /dev/null run -v\n" +" 22:17:53.215784625 I: Started guestfish -a /dev/null run -v\n" +" 22:17:53.240335409 E: libguestfs: [00000ms] febootstrap-supermin-helper " +"--verbose -f checksum '/usr/lib64/guestfs/supermin.d' x86_64\n" +" 22:17:53.266857866 E: supermin helper [00000ms] whitelist = (not " +"specified), host_cpu = x86_64, kernel = (null), initrd = (null), appliance = " +"(null)\n" +" 22:17:53.272704072 E: supermin helper [00000ms] inputs[0] = " +"/usr/lib64/guestfs/supermin.d\n" +" 22:17:53.276528651 E: checking modpath " +"/lib/modules/3.4.0-1.fc17.x86_64.debug is a directory\n" +" [etc]\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-performance.pod:311 +msgid "" +"The timestamps are C<hours:minutes:seconds.nanoseconds>. By comparing the " +"timestamps you can see exactly how long each operation in the boot sequence " +"takes." +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-performance.pod:315 +msgid "DETAILED TIMINGS USING SYSTEMTAP" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-performance.pod:317 +msgid "" "You can use SystemTap (L<stap(1)>) to get detailed timings from libguestfs " "programs." msgstr "" #. type: textblock -#: ../examples/guestfs-performance.pod:303 +#: ../examples/guestfs-performance.pod:320 msgid "Save the following script as C<time.stap>:" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:305 ../src/guestfs.pod:2305 +#: ../examples/guestfs-performance.pod:322 ../src/guestfs.pod:2376 #, no-wrap msgid "" " global last;\n" @@ -5937,7 +5951,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:307 ../src/guestfs.pod:2307 +#: ../examples/guestfs-performance.pod:324 ../src/guestfs.pod:2378 #, no-wrap msgid "" " function display_time () {\n" @@ -5950,7 +5964,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:314 ../src/guestfs.pod:2314 +#: ../examples/guestfs-performance.pod:331 ../src/guestfs.pod:2385 #, no-wrap msgid "" " printf (\"%d (+%d):\", now, delta);\n" @@ -5959,7 +5973,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:317 ../src/guestfs.pod:2317 +#: ../examples/guestfs-performance.pod:334 ../src/guestfs.pod:2388 #, no-wrap msgid "" " probe begin {\n" @@ -5970,7 +5984,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:322 ../src/guestfs.pod:2322 +#: ../examples/guestfs-performance.pod:339 ../src/guestfs.pod:2393 #, no-wrap msgid "" " /* Display all calls to static markers. */\n" @@ -5983,7 +5997,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:329 +#: ../examples/guestfs-performance.pod:346 #, no-wrap msgid "" " /* Display all calls to guestfs_* functions. */\n" @@ -5996,12 +6010,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-performance.pod:336 +#: ../examples/guestfs-performance.pod:353 msgid "Run it as root in one window:" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:338 +#: ../examples/guestfs-performance.pod:355 #, no-wrap msgid "" " # stap time.stap\n" @@ -6010,7 +6024,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-performance.pod:341 +#: ../examples/guestfs-performance.pod:358 msgid "" "It prints \"ready\" when SystemTap has loaded the program. Run your " "libguestfs program, guestfish or a virt tool in another window. For " @@ -6018,7 +6032,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:345 +#: ../examples/guestfs-performance.pod:362 #, no-wrap msgid "" " $ guestfish -a /dev/null run\n" @@ -6026,14 +6040,14 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-performance.pod:347 +#: ../examples/guestfs-performance.pod:364 msgid "" "In the stap window you will see a large amount of output, with the time " "taken for each step shown (microseconds in parenthesis). For example:" msgstr "" #. type: verbatim -#: ../examples/guestfs-performance.pod:351 +#: ../examples/guestfs-performance.pod:368 #, no-wrap msgid "" " xxxx (+0):\tguestfs_create \n" @@ -6049,18 +6063,117 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-performance.pod:361 +#: ../examples/guestfs-performance.pod:378 msgid "" "You will need to consult, and even modify, the source to libguestfs to fully " "understand the output." msgstr "" +#. type: =head1 +#: ../examples/guestfs-performance.pod:381 +msgid "DETAILED DEBUGGING USING GDB" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-performance.pod:383 +msgid "" +"You can attach to the appliance BIOS/kernel using gdb. If you know what " +"you're doing, this can be a useful way to diagnose boot regressions." +msgstr "" + #. type: textblock -#: ../examples/guestfs-performance.pod:366 +#: ../examples/guestfs-performance.pod:387 +msgid "" +"Firstly, you have to change qemu so it runs with the C<-S> and C<-s> " +"options. These options cause qemu to pause at boot and allow you to attach " +"a debugger. Read L<qemu(1)> for further information. Libguestfs invokes " +"qemu several times (to scan the help output and so on) and you only want the " +"final invocation of qemu to use these options, so use a qemu wrapper script " +"like this:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-performance.pod:394 ../fish/guestfish.pod:994 ../src/guestfs.pod:1068 +#, no-wrap +msgid "" +" #!/bin/bash -\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-performance.pod:396 +#, no-wrap +msgid "" +" # Set this to point to the real qemu binary.\n" +" qemu=/usr/bin/qemu-kvm\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-performance.pod:399 +#, no-wrap +msgid "" +" if [ \"$1\" != \"-global\" ]; then\n" +" # Scanning help output etc.\n" +" exec $qemu \"$@\"\n" +" else \n" +" # Really running qemu.\n" +" exec $qemu -S -s \"$@\"\n" +" fi\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-performance.pod:407 +msgid "" +"Now run guestfish or another libguestfs tool with the qemu wrapper (see " +"L<guestfs(3)/QEMU WRAPPERS> to understand what this is doing):" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-performance.pod:410 +#, no-wrap +msgid "" +" LIBGUESTFS_QEMU=/path/to/qemu-wrapper guestfish -a /dev/null -v run\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-performance.pod:412 +msgid "" +"This should pause just after qemu launches. In another window, attach to " +"qemu using gdb:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-performance.pod:415 +#, no-wrap +msgid "" +" $ gdb\n" +" (gdb) set architecture i8086\n" +" The target architecture is assumed to be i8086\n" +" (gdb) target remote :1234\n" +" Remote debugging using :1234\n" +" 0x0000fff0 in ?? ()\n" +" (gdb) cont\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-performance.pod:423 +msgid "" +"At this point you can use standard gdb techniques, eg. hitting C<^C> to " +"interrupt the boot and C<bt> get a stack trace, setting breakpoints, etc. " +"Note that when you are past the BIOS and into the Linux kernel, you'll want " +"to change the architecture back to 32 or 64 bit." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-performance.pod:431 msgid "" "L<febootstrap(8)>, L<febootstrap-supermin-helper(8)>, L<guestfish(1)>, " "L<guestfs(3)>, L<guestfs-examples(3)>, " -"L<libguestfs-make-fixed-appliance(1)>, L<stap(1)>, " +"L<libguestfs-make-fixed-appliance(1)>, L<stap(1)>, L<qemu(1)>, L<gdb(1)>, " "L<http://libguestfs.org/>." msgstr "" @@ -6095,23 +6208,16 @@ msgstr "" #. type: textblock #: ../examples/guestfs-recipes.pod:21 -msgid "" -"The link below contains a small program which can be used to audit a Linux " -"virtual machine to see what setuid and setgid files it contains." -msgstr "" - -#. type: textblock -#: ../examples/guestfs-recipes.pod:24 -msgid "L<https://rwmj.wordpress.com/2010/12/15/tip-audit-virtual-machine-for-setuid-files/#content>" +msgid "See: L<virt-ls(1)/EXAMPLES>." msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:26 +#: ../examples/guestfs-recipes.pod:23 msgid "Change the background image in a Windows XP VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:28 +#: ../examples/guestfs-recipes.pod:25 msgid "" "The links below explain how to use L<guestfish(1)> to change the background " "image for a user of a Windows XP VM. Unfortunately the technique appears to " @@ -6119,126 +6225,157 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:33 +#: ../examples/guestfs-recipes.pod:30 msgid "" "L<https://lists.fedoraproject.org/pipermail/virt/2011-May/002655.html> " "L<https://lists.fedoraproject.org/pipermail/virt/2011-May/002658.html>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:36 -msgid "Cloning a virtual machine (Linux)" +#: ../examples/guestfs-recipes.pod:33 +msgid "Cloning a virtual machine" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:38 +#: ../examples/guestfs-recipes.pod:35 msgid "" -"The guestfish technique described in the link below works well for most " -"Linux VMs. Depending on the Linux distro you may need to change the paths " -"slightly." +"Use a combination of tools like L<cp(1)>, L<dd(1)>, and virt tools like " +"L<virt-sysprep(1)>, L<virt-sparsify(1)> and L<virt-resize(1)>." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:42 -msgid "L<https://rwmj.wordpress.com/2010/09/24/tip-my-procedure-for-cloning-a-fedora-vm/#content>" +#: ../examples/guestfs-recipes.pod:39 +msgid "For more details, see: L<virt-sysprep(1)/COPYING AND CLONING>." +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:41 +msgid "Convert a CD-ROM / DVD / ISO to a tarball" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:44 +#: ../examples/guestfs-recipes.pod:43 +msgid "This converts input C<cd.iso> to output C<cd.tar.gz>:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:45 +#, no-wrap msgid "" -"Avoid L<virt-clone(1)>. Currently what to do about virt-clone is under " -"discussion." +" guestfish --ro -a cd.iso -m /dev/sda tgz-out / cd.tar.gz\n" +"\n" msgstr "" #. type: textblock #: ../examples/guestfs-recipes.pod:47 -msgid "L<https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html>" +msgid "To export just a subdirectory, eg. C</files>, do:" msgstr "" -#. type: =head1 +#. type: verbatim #: ../examples/guestfs-recipes.pod:49 -msgid "Cloning a virtual machine (Windows)" +#, no-wrap +msgid "" +" guestfish --ro -a cd.iso -m /dev/sda tgz-out /files cd.tar.gz\n" +"\n" msgstr "" -#. type: textblock +#. type: =head1 #: ../examples/guestfs-recipes.pod:51 +msgid "Create empty disk images" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:53 +msgid "The L<virt-format(1)> tool can do this directly." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:55 msgid "" -"It is possible to do a \"sysprep\" using libguestfs alone, although not " -"straightforward. Currently there is code in the Aeolus Oz project which " -"does this (using libguestfs). As part of our review of the virt-clone tool, " -"we may add sysprepping ability." +"Use L<virt-make-fs(1)> to create a disk image with content. This can also " +"create some standard disk images such as virtual floppy devices (VFDs)." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:56 +#: ../examples/guestfs-recipes.pod:59 msgid "" -"L<https://github.com/clalancette/oz> " -"L<https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html>" +"You can also use the L<guestfish(1)> I<-N> option to create empty disk " +"images. The useful guide below explains the options available." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:62 +msgid "L<https://rwmj.wordpress.com/2010/09/08/new-guestfish-n-options-in-1-5-9/#content>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:59 -msgid "Convert a CD-ROM / DVD / ISO to a tarball" +#: ../examples/guestfs-recipes.pod:64 +msgid "Delete a file (or other simple file operations)" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:61 -msgid "This converts input C<cd.iso> to output C<cd.tar.gz>:" +#: ../examples/guestfs-recipes.pod:66 +msgid "Use guestfish. To delete a file:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:63 +#: ../examples/guestfs-recipes.pod:68 #, no-wrap msgid "" -" guestfish --ro -a cd.iso -m /dev/sda tgz-out / cd.tar.gz\n" +" guestfish -a disk.img -i rm /file/to/delete\n" "\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:65 -msgid "To export just a subdirectory, eg. C</files>, do:" +#: ../examples/guestfs-recipes.pod:70 +msgid "To touch a file (bring it up to date or create it):" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:67 +#: ../examples/guestfs-recipes.pod:72 #, no-wrap msgid "" -" guestfish --ro -a cd.iso -m /dev/sda tgz-out /files cd.tar.gz\n" +" guestfish -a disk.img -i touch /file/to/touch\n" "\n" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:69 -msgid "Create empty disk images" +#. type: textblock +#: ../examples/guestfs-recipes.pod:74 +msgid "" +"To stat a file. Since this is a read-only operation, we can make it safer " +"by adding the I<--ro> flag." msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:71 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:77 +#, no-wrap msgid "" -"You can use the L<guestfish(1)> I<-N> option to create empty disk images. " -"The useful guide below explains the options available." +" guestfish --ro -a disk.img -i stat /file/to/stat\n" +"\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:74 -msgid "L<https://rwmj.wordpress.com/2010/09/08/new-guestfish-n-options-in-1-5-9/#content>" +#: ../examples/guestfs-recipes.pod:79 +msgid "" +"There are dozens of these commands. See L<guestfish(1)> or the output of " +"C<guestfish -h>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:76 +#: ../examples/guestfs-recipes.pod:82 msgid "Dump raw filesystem content from inside a disk image or VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:78 +#: ../examples/guestfs-recipes.pod:84 msgid "" "You can use the L<guestfish(1)> C<download> command to extract the raw " "filesystem content from any filesystem in a disk image or a VM (even one " -"which is encrypted or buried inside an LV):" +"which is encrypted or buried inside an LV or RAID device):" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:82 +#: ../examples/guestfs-recipes.pod:88 #, no-wrap msgid "" " guestfish --ro -a disk.img run : download /dev/sda1 sda1.img\n" @@ -6246,7 +6383,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:84 +#: ../examples/guestfs-recipes.pod:90 #, no-wrap msgid "" " guestfish --ro -d Guest run : download /dev/vg_guest/lv_root lv.img\n" @@ -6254,57 +6391,57 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:86 +#: ../examples/guestfs-recipes.pod:92 msgid "To list the filesystems in a disk image, use L<virt-filesystems(1)>." msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:88 +#: ../examples/guestfs-recipes.pod:94 msgid "Edit grub configuration in a VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:90 +#: ../examples/guestfs-recipes.pod:96 msgid "You can use this to:" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:96 +#: ../examples/guestfs-recipes.pod:102 msgid "Fix a virtual machine that does not boot." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:100 +#: ../examples/guestfs-recipes.pod:106 msgid "Change which kernel is used to boot the VM." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:104 +#: ../examples/guestfs-recipes.pod:110 msgid "Change kernel command line options." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:108 +#: ../examples/guestfs-recipes.pod:114 msgid "Use L<virt-edit(1)> to edit the grub configuration:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:110 +#: ../examples/guestfs-recipes.pod:116 #, no-wrap msgid "" -" virt-edit -d BrokenGuest /boot/grub/grub.conf\n" +" virt-edit -d BrokenGuest /boot/grub2/grub.cfg\n" "\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:112 +#: ../examples/guestfs-recipes.pod:118 msgid "" "or for general tinkering inside an unbootable VM use L<virt-rescue(1)> like " "this:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:115 +#: ../examples/guestfs-recipes.pod:121 #, no-wrap msgid "" " virt-rescue -d BrokenGuest\n" @@ -6312,17 +6449,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:117 +#: ../examples/guestfs-recipes.pod:123 msgid "Export any directory from a VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:119 +#: ../examples/guestfs-recipes.pod:125 msgid "To export C</home> from a VM into a local directory use L<virt-copy-out(1)>:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:122 ../examples/guestfs-testing.pod:93 +#: ../examples/guestfs-recipes.pod:128 ../examples/guestfs-testing.pod:93 #, no-wrap msgid "" " virt-copy-out -d Guest /home .\n" @@ -6330,24 +6467,24 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:124 ../fish/guestfish-actions.pod:1652 ../fish/guestfish-actions.pod:2107 ../fish/guestfish-actions.pod:2534 ../src/guestfs-actions.pod:2707 ../src/guestfs-actions.pod:3413 ../src/guestfs-actions.pod:3982 ../src/guestfs.pod:1788 ../tools/virt-win-reg.pl:717 +#: ../examples/guestfs-recipes.pod:130 ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1607 ../fish/guestfish-actions.pod:2002 ../fish/guestfish-actions.pod:2429 ../src/guestfs-actions.pod:18 ../src/guestfs-actions.pod:2642 ../src/guestfs-actions.pod:3209 ../src/guestfs-actions.pod:3778 ../src/guestfs.pod:1859 ../tools/virt-win-reg.pl:717 msgid "Notes:" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:130 +#: ../examples/guestfs-recipes.pod:136 msgid "" "The final dot of the command is not a printing error. It means we want to " "copy out to the current directory." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:135 +#: ../examples/guestfs-recipes.pod:141 msgid "This creates a directory called C<home> under the current directory." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:139 +#: ../examples/guestfs-recipes.pod:145 msgid "" "If the guest is a Windows guest then you can use drive letters and " "backslashes, but you must prefix the path with C<win:> and quote it to " @@ -6355,7 +6492,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:143 +#: ../examples/guestfs-recipes.pod:149 #, no-wrap msgid "" " virt-copy-out -d WinGuest 'win:c:\\windows\\system32\\config' .\n" @@ -6363,12 +6500,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:145 +#: ../examples/guestfs-recipes.pod:151 msgid "To get the output as a compressed tarball, do:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:147 +#: ../examples/guestfs-recipes.pod:153 #, no-wrap msgid "" " virt-tar-out -d Guest /home - | gzip --best > home.tar.gz\n" @@ -6376,7 +6513,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:149 +#: ../examples/guestfs-recipes.pod:155 msgid "" "Although it sounds tempting, this is usually not a reliable way to get a " "backup from a running guest. See the entry in the FAQ: " @@ -6384,19 +6521,19 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:153 +#: ../examples/guestfs-recipes.pod:159 msgid "Find out which user is using the most space" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:155 +#: ../examples/guestfs-recipes.pod:161 msgid "" "This simple script examines a Linux guest to find out which user is using " "the most space in their home directory:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:158 +#: ../examples/guestfs-recipes.pod:164 #, no-wrap msgid "" " #!/bin/sh -\n" @@ -6404,7 +6541,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:160 ../fish/guestfish.pod:996 +#: ../examples/guestfs-recipes.pod:166 ../fish/guestfish.pod:996 #, no-wrap msgid "" " set -e\n" @@ -6412,7 +6549,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:162 +#: ../examples/guestfs-recipes.pod:168 #, no-wrap msgid "" " vm=\"$1\"\n" @@ -6421,7 +6558,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:165 +#: ../examples/guestfs-recipes.pod:171 #, no-wrap msgid "" " eval $(guestfish --ro -d \"$vm\" -i --listen)\n" @@ -6429,7 +6566,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:167 +#: ../examples/guestfs-recipes.pod:173 #, no-wrap msgid "" " for d in $(guestfish --remote ls \"$dir\"); do\n" @@ -6441,7 +6578,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:173 ../fish/guestfish.pod:953 +#: ../examples/guestfs-recipes.pod:179 ../fish/guestfish.pod:953 #, no-wrap msgid "" " guestfish --remote exit\n" @@ -6449,41 +6586,41 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:175 +#: ../examples/guestfs-recipes.pod:181 msgid "Get DHCP address from a VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:177 +#: ../examples/guestfs-recipes.pod:183 msgid "" "The link below explains the many different possible techniques for getting " "the last assigned DHCP address of a virtual machine." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:180 +#: ../examples/guestfs-recipes.pod:186 msgid "L<https://rwmj.wordpress.com/2011/03/31/tip-code-for-getting-dhcp-address-from-a-virtual-machine-disk-image/#content>" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:182 +#: ../examples/guestfs-recipes.pod:188 msgid "" "In the libguestfs source examples directory you will find the latest version " "of the C<virt-dhcp-address.c> program." msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:185 +#: ../examples/guestfs-recipes.pod:191 msgid "Get the operating system product name string" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:187 +#: ../examples/guestfs-recipes.pod:193 msgid "Save the following script into a file called C<product-name.sh>:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:189 +#: ../examples/guestfs-recipes.pod:195 #, no-wrap msgid "" " #!/bin/sh -\n" @@ -6496,12 +6633,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:196 +#: ../examples/guestfs-recipes.pod:202 msgid "Make the script executable and run it on a named guest:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:198 +#: ../examples/guestfs-recipes.pod:204 #, no-wrap msgid "" " # product-name.sh RHEL60x64\n" @@ -6510,14 +6647,14 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:201 +#: ../examples/guestfs-recipes.pod:207 msgid "" "You can also use an XPath query on the L<virt-inspector(1)> XML using the " "C<xpath> command line tool or from your favourite programming language:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:205 +#: ../examples/guestfs-recipes.pod:211 #, no-wrap msgid "" " # virt-inspector RHEL60x64 > xml\n" @@ -6530,66 +6667,66 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:211 +#: ../examples/guestfs-recipes.pod:217 msgid "Get the default boot kernel for a Linux VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:213 +#: ../examples/guestfs-recipes.pod:219 msgid "" "The link below contains a program to print the default boot kernel for a " "Linux VM." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:216 +#: ../examples/guestfs-recipes.pod:222 msgid "L<https://rwmj.wordpress.com/2010/10/30/tip-use-augeas-to-get-the-default-boot-kernel-for-a-vm/#content>" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:218 +#: ../examples/guestfs-recipes.pod:224 msgid "" "It uses Augeas, and the technique is generally applicable for many different " "tasks, such as:" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:225 +#: ../examples/guestfs-recipes.pod:231 msgid "listing the user accounts in the guest" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:229 +#: ../examples/guestfs-recipes.pod:235 msgid "what repositories is it configured to use" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:233 +#: ../examples/guestfs-recipes.pod:239 msgid "what NTP servers does it connect to" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:237 +#: ../examples/guestfs-recipes.pod:243 msgid "what were the boot messages last time it booted" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:241 +#: ../examples/guestfs-recipes.pod:247 msgid "listing who was logged in recently" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:245 +#: ../examples/guestfs-recipes.pod:251 msgid "L<http://augeas.net/>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:247 +#: ../examples/guestfs-recipes.pod:253 msgid "Install RPMs in a guest" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:249 +#: ../examples/guestfs-recipes.pod:255 msgid "" "The link below contains a method to install RPMs in a guest. In fact the " "RPMs are just uploaded to the guest along with a \"firstboot\" script that " @@ -6598,22 +6735,22 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:255 +#: ../examples/guestfs-recipes.pod:261 msgid "L<https://rwmj.wordpress.com/2010/12/01/tip-install-rpms-in-a-guest/#content>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:257 +#: ../examples/guestfs-recipes.pod:263 msgid "List applications installed in a VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:259 +#: ../examples/guestfs-recipes.pod:265 msgid "Save the following to a file C<list-apps.sh>:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:261 +#: ../examples/guestfs-recipes.pod:267 #, no-wrap msgid "" " #!/bin/sh -\n" @@ -6626,14 +6763,14 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:268 +#: ../examples/guestfs-recipes.pod:274 msgid "" "Make the file executable and then you can run it on any named virtual " "machine:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:271 +#: ../examples/guestfs-recipes.pod:277 #, no-wrap msgid "" " # list-apps.sh WinGuest\n" @@ -6669,7 +6806,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:301 +#: ../examples/guestfs-recipes.pod:307 msgid "" "If you want to run the script on disk images (instead of libvirt virtual " "machines), change C<-d \"$1\"> to C<-a \"$1\">. See also " @@ -6677,30 +6814,22 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:305 +#: ../examples/guestfs-recipes.pod:311 msgid "List files and directories in a VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:307 -msgid "This involves using the L<guestfish(1)> C<find0> command like this:" -msgstr "" - -#. type: verbatim -#: ../examples/guestfs-recipes.pod:309 -#, no-wrap -msgid "" -" guestfish --ro -d Guest -i find0 / - | tr '\\0' '\\n' | sort\n" -"\n" +#: ../examples/guestfs-recipes.pod:313 +msgid "Use L<virt-ls(1)>." msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:311 +#: ../examples/guestfs-recipes.pod:315 msgid "List services in a Windows VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:313 +#: ../examples/guestfs-recipes.pod:317 msgid "" "The link below contains a script that can be used to list out the services " "from a Windows VM, and whether those services run at boot time or are loaded " @@ -6708,51 +6837,44 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:317 +#: ../examples/guestfs-recipes.pod:321 msgid "L<https://rwmj.wordpress.com/2010/12/10/tip-list-services-in-a-windows-guest/#content>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:319 +#: ../examples/guestfs-recipes.pod:323 msgid "Make a disk image sparse" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:321 -msgid "" -"The link below contains some guides for making a disk image sparse (or " -"reintroducing sparseness)." -msgstr "" - -#. type: textblock -#: ../examples/guestfs-recipes.pod:324 -msgid "L<https://rwmj.wordpress.com/2010/10/19/tip-making-a-disk-image-sparse/#content>" +#: ../examples/guestfs-recipes.pod:325 +msgid "Use L<virt-sparsify(1)>." msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:326 +#: ../examples/guestfs-recipes.pod:327 msgid "Monitor disk usage over time" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:328 +#: ../examples/guestfs-recipes.pod:329 msgid "" "You can use L<virt-df(1)> to monitor disk usage of your guests over time. " "The link below contains a guide." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:331 +#: ../examples/guestfs-recipes.pod:332 msgid "L<http://virt-tools.org/learning/advanced-virt-df/>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:333 +#: ../examples/guestfs-recipes.pod:334 msgid "Reading the Windows Event Log from Windows Vista (or later)" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:335 +#: ../examples/guestfs-recipes.pod:336 msgid "" "L<guestfish(1)> plus the tools described in the link below can be used to " "read out the Windows Event Log from any virtual machine running Windows " @@ -6760,24 +6882,24 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:339 +#: ../examples/guestfs-recipes.pod:340 msgid "L<https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-guestfish/#content>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:341 +#: ../examples/guestfs-recipes.pod:342 msgid "Remove root password (Linux)" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:343 +#: ../examples/guestfs-recipes.pod:344 msgid "" "Using the L<virt-edit(1)> I<-e> option you can do simple replacements on " "files. One use is to remove the root password from a Linux guest:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:346 +#: ../examples/guestfs-recipes.pod:347 #, no-wrap msgid "" " virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n" @@ -6785,12 +6907,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:348 +#: ../examples/guestfs-recipes.pod:349 msgid "Remove Administrator password (Windows)" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:350 +#: ../examples/guestfs-recipes.pod:351 msgid "" "The link below contains one technique for removing the Administrator " "password from a Windows VM, or to be more precise, it gives you a command " @@ -6798,17 +6920,38 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:355 +#: ../examples/guestfs-recipes.pod:356 msgid "L<https://mdbooth.wordpress.com/2010/10/18/resetting-a-windows-guests-administrator-password-with-guestfish/>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:357 +#: ../examples/guestfs-recipes.pod:358 +msgid "Sysprepping a virtual machine (Windows)" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:360 +msgid "" +"It is possible to do a \"sysprep\" using libguestfs alone, although not " +"straightforward. Currently there is code in the Aeolus Oz project which " +"does this (using libguestfs). It is likely we will add this to " +"L<virt-sysprep(1)> in future." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:365 +msgid "" +"L<https://github.com/clalancette/oz> " +"L<https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html>" +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:368 msgid "Unpack a live CD" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:359 +#: ../examples/guestfs-recipes.pod:370 msgid "" "Linux live CDs often contain multiple layers of disk images wrapped like a " "Russian doll. You can use L<guestfish(1)> to look inside these multiple " @@ -6816,46 +6959,46 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:363 +#: ../examples/guestfs-recipes.pod:374 msgid "L<https://rwmj.wordpress.com/2009/07/15/unpack-the-russian-doll-of-a-f11-live-cd/#content>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:365 +#: ../examples/guestfs-recipes.pod:376 msgid "Uploading and downloading files" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:367 +#: ../examples/guestfs-recipes.pod:378 msgid "" "The link below contains general tips on uploading (copying in) and " "downloading (copying out) files from VMs." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:370 +#: ../examples/guestfs-recipes.pod:381 msgid "L<https://rwmj.wordpress.com/2010/12/02/tip-uploading-and-downloading/#content>" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:372 +#: ../examples/guestfs-recipes.pod:383 msgid "Use libguestfs tools on VMware ESX guests" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:374 +#: ../examples/guestfs-recipes.pod:385 msgid "" "The link below explains how to use libguestfs, L<guestfish(1)> and the virt " "tools on any VMware ESX guests, by first sharing the VMware VMFS over sshfs." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:378 +#: ../examples/guestfs-recipes.pod:389 msgid "L<https://rwmj.wordpress.com/2011/05/10/tip-use-libguestfs-on-vmware-esx-guests/#content>" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:382 +#: ../examples/guestfs-recipes.pod:393 msgid "" "L<guestfs(3)>, L<guestfish(1)>, L<guestfs-examples(3)>, " "L<guestfs-erlang(3)>, L<guestfs-java(3)>, L<guestfs-ocaml(3)>, " @@ -6864,11 +7007,6 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:399 -msgid "Copyright (C) 2009-2012 Red Hat Inc. L<http://libguestfs.org/>" -msgstr "" - -#. type: textblock #: ../examples/guestfs-testing.pod:5 msgid "guestfs-testing - manual testing of libguestfs, you can help!" msgstr "" @@ -6975,7 +7113,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-testing.pod:54 ../examples/guestfs-testing.pod:161 ../examples/guestfs-testing.pod:174 ../examples/guestfs-testing.pod:234 ../src/guestfs.pod:2895 +#: ../examples/guestfs-testing.pod:54 ../examples/guestfs-testing.pod:161 ../examples/guestfs-testing.pod:174 ../examples/guestfs-testing.pod:234 ../src/guestfs.pod:2966 msgid "or:" msgstr "" @@ -7149,7 +7287,7 @@ msgid "Try importing virt-df CSV output into a spreadsheet or database." msgstr "" #. type: textblock -#: ../examples/guestfs-testing.pod:131 ../src/guestfs.pod:3176 +#: ../examples/guestfs-testing.pod:131 ../src/guestfs.pod:3247 msgid "Run:" msgstr "" @@ -7579,21 +7717,36 @@ msgid "This function adds a virtual CD-ROM disk image to the guest." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:7 +#: ../fish/guestfish-actions.pod:7 ../src/guestfs-actions.pod:16 +msgid "This is equivalent to the qemu parameter I<-cdrom filename>." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:15 msgid "" -"B<Do not use this function!> ISO files are just ordinary read-only disk " -"images. Use L</add-drive-ro> instead." +"This call checks for the existence of C<filename>. This stops you from " +"specifying other types of drive which are supported by qemu such as C<nbd:> " +"and C<http:> URLs. To specify those, use the general L</config> call " +"instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:10 ../fish/guestfish-actions.pod:187 ../fish/guestfish-actions.pod:201 +#: ../fish/guestfish-actions.pod:22 msgid "" -"I<This function is deprecated.> In new code, use the L</add_drive> call " +"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 " +"L</add-drive-ro> instead." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:217 ../fish/guestfish-actions.pod:231 +msgid "" +"I<This function is deprecated.> In new code, use the L</add_drive_opts> call " "instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:190 ../fish/guestfish-actions.pod:204 ../fish/guestfish-actions.pod:1054 ../fish/guestfish-actions.pod:1089 ../fish/guestfish-actions.pod:1238 ../fish/guestfish-actions.pod:1266 ../fish/guestfish-actions.pod:1283 ../fish/guestfish-actions.pod:1320 ../fish/guestfish-actions.pod:1357 ../fish/guestfish-actions.pod:1374 ../fish/guestfish-actions.pod:1861 ../fish/guestfish-actions.pod:1875 ../fish/guestfish-actions.pod:2096 ../fish/guestfish-actions.pod:3114 ../fish/guestfish-actions.pod:3945 ../fish/guestfish-actions.pod:4361 ../fish/guestfish-actions.pod:5134 ../fish/guestfish-actions.pod:5382 ../fish/guestfish-actions.pod:5402 ../fish/guestfish-actions.pod:5421 ../fish/guestfish-actions.pod:5459 ../fish/guestfish-actions.pod:6265 ../fish/guestfish-actions.pod:6305 ../fish/guestfish-actions.pod:6322 ../fish/guestfish-actions.pod:6397 ../fish/guestfish-actions.pod:6414 ../fish/guestfish-actions.pod:6433 ../fish/guestfish-actions.pod:6450 ../fish/guestfish-actions.pod:6467 ../src/guestfs-actions.pod:10 ../src/guestfs-actions.pod:283 ../src/guestfs-actions.pod:304 ../src/guestfs-actions.pod:1817 ../src/guestfs-actions.pod:1874 ../src/guestfs-actions.pod:2133 ../src/guestfs-actions.pod:2173 ../src/guestfs-actions.pod:2199 ../src/guestfs-actions.pod:2256 ../src/guestfs-actions.pod:2309 ../src/guestfs-actions.pod:2335 ../src/guestfs-actions.pod:2991 ../src/guestfs-actions.pod:3012 ../src/guestfs-actions.pod:3387 ../src/guestfs-actions.pod:4789 ../src/guestfs-actions.pod:6148 ../src/guestfs-actions.pod:6956 ../src/guestfs-actions.pod:8102 ../src/guestfs-actions.pod:8413 ../src/guestfs-actions.pod:8454 ../src/guestfs-actions.pod:8485 ../src/guestfs-actions.pod:8545 ../src/guestfs-actions.pod:9757 ../src/guestfs-actions.pod:9885 ../src/guestfs-actions.pod:9986 ../src/guestfs-actions.pod:10012 ../src/guestfs-actions.pod:10135 ../src/guestfs-actions.pod:10161 ../src/guestfs-actions.pod:10187 ../src/guestfs-actions.pod:10214 ../src/guestfs-actions.pod:10240 +#: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:220 ../fish/guestfish-actions.pod:234 ../fish/guestfish-actions.pod:1054 ../fish/guestfish-actions.pod:1089 ../fish/guestfish-actions.pod:1238 ../fish/guestfish-actions.pod:1306 ../fish/guestfish-actions.pod:1792 ../fish/guestfish-actions.pod:1806 ../fish/guestfish-actions.pod:3009 ../fish/guestfish-actions.pod:3786 ../fish/guestfish-actions.pod:4223 ../fish/guestfish-actions.pod:4271 ../fish/guestfish-actions.pod:4999 ../fish/guestfish-actions.pod:5247 ../fish/guestfish-actions.pod:5267 ../fish/guestfish-actions.pod:5286 ../fish/guestfish-actions.pod:5324 ../fish/guestfish-actions.pod:6106 ../fish/guestfish-actions.pod:6222 ../src/guestfs-actions.pod:10 ../src/guestfs-actions.pod:308 ../src/guestfs-actions.pod:329 ../src/guestfs-actions.pod:1805 ../src/guestfs-actions.pod:1862 ../src/guestfs-actions.pod:2119 ../src/guestfs-actions.pod:2228 ../src/guestfs-actions.pod:2866 ../src/guestfs-actions.pod:2887 ../src/guestfs-actions.pod:4585 ../src/guestfs-actions.pod:5840 ../src/guestfs-actions.pod:6652 ../src/guestfs-actions.pod:6752 ../src/guestfs-actions.pod:7846 ../src/guestfs-actions.pod:8157 ../src/guestfs-actions.pod:8198 ../src/guestfs-actions.pod:8229 ../src/guestfs-actions.pod:8289 ../src/guestfs-actions.pod:9427 ../src/guestfs-actions.pod:9555 ../src/guestfs-actions.pod:9759 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 " @@ -7601,17 +7754,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:17 +#: ../fish/guestfish-actions.pod:35 msgid "add-domain" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:19 +#: ../fish/guestfish-actions.pod:37 msgid "domain" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:21 +#: ../fish/guestfish-actions.pod:39 #, no-wrap msgid "" " add-domain dom [libvirturi:..] [readonly:true|false] [iface:..] " @@ -7620,7 +7773,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:23 +#: ../fish/guestfish-actions.pod:41 msgid "" "This function adds the disk(s) attached to the named libvirt domain C<dom>. " "It works by connecting to libvirt, requesting the domain and domain XML from " @@ -7628,14 +7781,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:28 ../src/guestfs-actions.pod:47 +#: ../fish/guestfish-actions.pod:46 ../src/guestfs-actions.pod:65 msgid "" "The number of disks added is returned. This operation is atomic: if an " "error is returned, then no disks are added." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:31 ../src/guestfs-actions.pod:50 +#: ../fish/guestfish-actions.pod:49 ../src/guestfs-actions.pod:68 msgid "" "This function does some minimal checks to make sure the libvirt domain is " "not running (unless C<readonly> is true). In a future version we will try " @@ -7643,7 +7796,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:35 ../src/guestfs-actions.pod:54 +#: ../fish/guestfish-actions.pod:53 ../src/guestfs-actions.pod:72 msgid "" "Disks must be accessible locally. This often means that adding disks from a " "remote libvirt connection (see L<http://libvirt.org/remote.html>) will fail " @@ -7651,7 +7804,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:40 ../src/guestfs-actions.pod:59 +#: ../fish/guestfish-actions.pod:58 ../src/guestfs-actions.pod:77 msgid "" "The optional C<libvirturi> parameter sets the libvirt URI (see " "L<http://libvirt.org/uri.html>). If this is not set then we connect to the " @@ -7660,7 +7813,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:46 ../src/guestfs-actions.pod:65 +#: ../fish/guestfish-actions.pod:64 ../src/guestfs-actions.pod:83 msgid "" "The optional C<live> flag controls whether this call will try to connect to " "a running virtual machine C<guestfsd> process if it sees a suitable " @@ -7670,7 +7823,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:53 ../src/guestfs-actions.pod:72 +#: ../fish/guestfish-actions.pod:71 ../src/guestfs-actions.pod:90 msgid "" "If the C<allowuuid> flag is true (default is false) then a UUID I<may> be " "passed instead of the domain name. The C<dom> string is treated as a UUID " @@ -7679,115 +7832,142 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:58 ../src/guestfs-actions.pod:77 +#: ../fish/guestfish-actions.pod:76 ../src/guestfs-actions.pod:95 msgid "" "The optional C<readonlydisk> parameter controls what we do for disks which " "are marked E<lt>readonly/E<gt> in the libvirt XML. Possible values are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:64 ../src/guestfs-actions.pod:83 +#: ../fish/guestfish-actions.pod:82 ../src/guestfs-actions.pod:101 msgid "readonlydisk = \"error\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:66 ../fish/guestfish-actions.pod:77 ../fish/guestfish-actions.pod:88 ../src/guestfs-actions.pod:85 ../src/guestfs-actions.pod:96 ../src/guestfs-actions.pod:107 +#: ../fish/guestfish-actions.pod:84 ../fish/guestfish-actions.pod:95 ../fish/guestfish-actions.pod:106 ../src/guestfs-actions.pod:103 ../src/guestfs-actions.pod:114 ../src/guestfs-actions.pod:125 msgid "If C<readonly> is false:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:68 ../src/guestfs-actions.pod:87 +#: ../fish/guestfish-actions.pod:86 ../src/guestfs-actions.pod:105 msgid "" "The whole call is aborted with an error if any disk with the " "E<lt>readonly/E<gt> flag is found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:71 ../fish/guestfish-actions.pod:82 ../fish/guestfish-actions.pod:92 ../src/guestfs-actions.pod:90 ../src/guestfs-actions.pod:101 ../src/guestfs-actions.pod:111 +#: ../fish/guestfish-actions.pod:89 ../fish/guestfish-actions.pod:100 ../fish/guestfish-actions.pod:110 ../src/guestfs-actions.pod:108 ../src/guestfs-actions.pod:119 ../src/guestfs-actions.pod:129 msgid "If C<readonly> is true:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:73 ../fish/guestfish-actions.pod:84 ../fish/guestfish-actions.pod:94 ../src/guestfs-actions.pod:92 ../src/guestfs-actions.pod:103 ../src/guestfs-actions.pod:113 +#: ../fish/guestfish-actions.pod:91 ../fish/guestfish-actions.pod:102 ../fish/guestfish-actions.pod:112 ../src/guestfs-actions.pod:110 ../src/guestfs-actions.pod:121 ../src/guestfs-actions.pod:131 msgid "Disks with the E<lt>readonly/E<gt> flag are added read-only." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:75 ../src/guestfs-actions.pod:94 +#: ../fish/guestfish-actions.pod:93 ../src/guestfs-actions.pod:112 msgid "readonlydisk = \"read\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:79 ../src/guestfs-actions.pod:98 +#: ../fish/guestfish-actions.pod:97 ../src/guestfs-actions.pod:116 msgid "" "Disks with the E<lt>readonly/E<gt> flag are added read-only. Other disks " "are added read/write." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:86 ../src/guestfs-actions.pod:105 +#: ../fish/guestfish-actions.pod:104 ../src/guestfs-actions.pod:123 msgid "readonlydisk = \"write\" (default)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:90 ../src/guestfs-actions.pod:109 +#: ../fish/guestfish-actions.pod:108 ../src/guestfs-actions.pod:127 msgid "Disks with the E<lt>readonly/E<gt> flag are added read/write." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:96 ../src/guestfs-actions.pod:115 +#: ../fish/guestfish-actions.pod:114 ../src/guestfs-actions.pod:133 msgid "readonlydisk = \"ignore\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:98 ../src/guestfs-actions.pod:117 +#: ../fish/guestfish-actions.pod:116 ../src/guestfs-actions.pod:135 msgid "If C<readonly> is true or false:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:100 ../src/guestfs-actions.pod:119 +#: ../fish/guestfish-actions.pod:118 ../src/guestfs-actions.pod:137 msgid "Disks with the E<lt>readonly/E<gt> flag are skipped." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:104 +#: ../fish/guestfish-actions.pod:122 msgid "" "The other optional parameters are passed directly through to " "L</add-drive-opts>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:107 ../fish/guestfish-actions.pod:167 ../fish/guestfish-actions.pod:651 ../fish/guestfish-actions.pod:666 ../fish/guestfish-actions.pod:948 ../fish/guestfish-actions.pod:969 ../fish/guestfish-actions.pod:1007 ../fish/guestfish-actions.pod:1016 ../fish/guestfish-actions.pod:1025 ../fish/guestfish-actions.pod:1039 ../fish/guestfish-actions.pod:1225 ../fish/guestfish-actions.pod:1696 ../fish/guestfish-actions.pod:2078 ../fish/guestfish-actions.pod:2573 ../fish/guestfish-actions.pod:3681 ../fish/guestfish-actions.pod:3928 ../fish/guestfish-actions.pod:3961 ../fish/guestfish-actions.pod:4124 ../fish/guestfish-actions.pod:4154 ../fish/guestfish-actions.pod:4297 ../fish/guestfish-actions.pod:4313 ../fish/guestfish-actions.pod:4349 ../fish/guestfish-actions.pod:5110 ../fish/guestfish-actions.pod:5843 ../fish/guestfish-actions.pod:5908 ../fish/guestfish-actions.pod:5929 ../fish/guestfish-actions.pod:6279 +#: ../fish/guestfish-actions.pod:125 ../fish/guestfish-actions.pod:197 ../fish/guestfish-actions.pod:679 ../fish/guestfish-actions.pod:694 ../fish/guestfish-actions.pod:948 ../fish/guestfish-actions.pod:969 ../fish/guestfish-actions.pod:1007 ../fish/guestfish-actions.pod:1016 ../fish/guestfish-actions.pod:1025 ../fish/guestfish-actions.pod:1039 ../fish/guestfish-actions.pod:1225 ../fish/guestfish-actions.pod:2468 ../fish/guestfish-actions.pod:3563 ../fish/guestfish-actions.pod:3802 ../fish/guestfish-actions.pod:3849 ../fish/guestfish-actions.pod:4012 ../fish/guestfish-actions.pod:4042 ../fish/guestfish-actions.pod:4185 ../fish/guestfish-actions.pod:4201 ../fish/guestfish-actions.pod:4259 ../fish/guestfish-actions.pod:4975 ../fish/guestfish-actions.pod:5708 ../fish/guestfish-actions.pod:5790 msgid "" "This command has one or more optional arguments. See L</OPTIONAL " "ARGUMENTS>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:109 +#: ../fish/guestfish-actions.pod:127 msgid "add-drive" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:111 -msgid "add" +#. type: verbatim +#: ../fish/guestfish-actions.pod:129 +#, no-wrap +msgid "" +" add-drive filename\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:131 +msgid "" +"This function is the equivalent of calling L</add-drive-opts> with no " +"optional parameters, so the disk is added writable, with the format being " +"detected automatically." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:135 +msgid "" +"Automatic detection of the format opens you up to a potential security hole " +"when dealing with untrusted raw-format images. See CVE-2010-3851 and " +"RHBZ#642934. Specifying the format closes this security hole. Therefore " +"you should think about replacing calls to this function with calls to " +"L</add-drive-opts>, and specifying the format." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:113 +#: ../fish/guestfish-actions.pod:142 msgid "add-drive-opts" msgstr "" +#. type: =head2 +#: ../fish/guestfish-actions.pod:144 +msgid "add" +msgstr "" + #. type: verbatim -#: ../fish/guestfish-actions.pod:115 +#: ../fish/guestfish-actions.pod:146 #, no-wrap msgid "" -" add-drive filename [readonly:true|false] [format:..] [iface:..] [name:..]\n" +" add-drive-opts filename [readonly:true|false] [format:..] [iface:..] " +"[name:..]\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:117 ../src/guestfs-actions.pod:182 +#: ../fish/guestfish-actions.pod:148 ../src/guestfs-actions.pod:208 msgid "" "This function adds a virtual machine disk image C<filename> to libguestfs. " "The first time you call this function, the disk appears as C</dev/sda>, the " @@ -7795,7 +7975,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:122 ../src/guestfs-actions.pod:187 +#: ../fish/guestfish-actions.pod:153 ../src/guestfs-actions.pod:213 msgid "" "You don't necessarily need to be root when using libguestfs. However you " "obviously do need sufficient permissions to access the filename for whatever " @@ -7804,22 +7984,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:128 ../src/guestfs-actions.pod:193 +#: ../fish/guestfish-actions.pod:159 ../src/guestfs-actions.pod:219 msgid "This call checks that C<filename> exists." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:130 ../fish/guestfish-actions.pod:3890 ../src/guestfs-actions.pod:195 ../src/guestfs-actions.pod:6071 +#: ../fish/guestfish-actions.pod:161 ../src/guestfs-actions.pod:221 +msgid "" +"C<filename> may be the special string C<\"/dev/null\">. See " +"L<guestfs(3)/NULL DISKS>." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:164 ../fish/guestfish-actions.pod:3811 ../src/guestfs-actions.pod:224 ../src/guestfs-actions.pod:5932 msgid "The optional arguments are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:134 ../src/guestfs-actions.pod:199 +#: ../fish/guestfish-actions.pod:168 ../src/guestfs-actions.pod:228 msgid "C<readonly>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:136 ../src/guestfs-actions.pod:201 +#: ../fish/guestfish-actions.pod:170 ../src/guestfs-actions.pod:230 msgid "" "If true then the image is treated as read-only. Writes are still allowed, " "but they are stored in a temporary snapshot overlay which is discarded at " @@ -7827,12 +8014,12 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:140 ../src/guestfs-actions.pod:205 ../src/guestfs.pod:3055 +#: ../fish/guestfish-actions.pod:174 ../src/guestfs-actions.pod:234 ../src/guestfs.pod:3126 msgid "C<format>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:142 +#: ../fish/guestfish-actions.pod:176 msgid "" "This forces the image format. If you omit this (or use L</add-drive> or " "L</add-drive-ro>) then the format is automatically detected. Possible " @@ -7840,7 +8027,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:146 ../src/guestfs-actions.pod:211 +#: ../fish/guestfish-actions.pod:180 ../src/guestfs-actions.pod:240 msgid "" "Automatic detection of the format opens you up to a potential security hole " "when dealing with untrusted raw-format images. See CVE-2010-3851 and " @@ -7848,49 +8035,41 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:151 ../src/guestfs-actions.pod:216 +#: ../fish/guestfish-actions.pod:185 ../src/guestfs-actions.pod:245 msgid "C<iface>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:153 +#: ../fish/guestfish-actions.pod:187 msgid "" "This rarely-used option lets you emulate the behaviour of the deprecated " "L</add-drive-with-if> call (q.v.)" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:156 ../fish/guestfish-actions.pod:3709 ../src/guestfs-actions.pod:221 ../src/guestfs-actions.pod:5759 +#: ../fish/guestfish-actions.pod:190 ../fish/guestfish-actions.pod:3591 ../src/guestfs-actions.pod:250 ../src/guestfs-actions.pod:5537 msgid "C<name>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:158 ../src/guestfs-actions.pod:223 +#: ../fish/guestfish-actions.pod:192 ../src/guestfs-actions.pod:252 msgid "" "The name the drive had in the original guest, e.g. /dev/sdb. This is used as " "a hint to the guest inspection process if it is available." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:163 ../src/guestfs-actions.pod:228 -msgid "" -"C<filename> can have the special value C</dev/null>, which means to add a " -"null (zero length) raw format device. You can add C</dev/null> multiple " -"times." -msgstr "" - #. type: =head2 -#: ../fish/guestfish-actions.pod:169 +#: ../fish/guestfish-actions.pod:199 msgid "add-drive-ro" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:171 +#: ../fish/guestfish-actions.pod:201 msgid "add-ro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:173 +#: ../fish/guestfish-actions.pod:203 #, no-wrap msgid "" " add-drive-ro filename\n" @@ -7898,7 +8077,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:175 +#: ../fish/guestfish-actions.pod:205 msgid "" "This function is the equivalent of calling L</add-drive-opts> with the " "optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk " @@ -7906,12 +8085,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:180 +#: ../fish/guestfish-actions.pod:210 msgid "add-drive-ro-with-if" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:182 +#: ../fish/guestfish-actions.pod:212 #, no-wrap msgid "" " add-drive-ro-with-if filename iface\n" @@ -7919,19 +8098,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:184 +#: ../fish/guestfish-actions.pod:214 msgid "" "This is the same as L</add-drive-ro> but it allows you to specify the QEMU " "interface emulation to use at run time." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:194 +#: ../fish/guestfish-actions.pod:224 msgid "add-drive-with-if" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:196 +#: ../fish/guestfish-actions.pod:226 #, no-wrap msgid "" " add-drive-with-if filename iface\n" @@ -7939,19 +8118,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:198 +#: ../fish/guestfish-actions.pod:228 msgid "" "This is the same as L</add-drive> but it allows you to specify the QEMU " "interface emulation to use at run time." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:208 +#: ../fish/guestfish-actions.pod:238 msgid "aug-clear" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:210 +#: ../fish/guestfish-actions.pod:240 #, no-wrap msgid "" " aug-clear augpath\n" @@ -7959,19 +8138,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:212 ../src/guestfs-actions.pod:321 +#: ../fish/guestfish-actions.pod:242 ../src/guestfs-actions.pod:346 msgid "" "Set the value associated with C<path> to C<NULL>. This is the same as the " "L<augtool(1)> C<clear> command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:215 +#: ../fish/guestfish-actions.pod:245 msgid "aug-close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:217 +#: ../fish/guestfish-actions.pod:247 #, no-wrap msgid "" " aug-close\n" @@ -7979,7 +8158,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:219 +#: ../fish/guestfish-actions.pod:249 msgid "" "Close the current Augeas handle and free up any resources used by it. After " "calling this, you have to call L</aug-init> again before you can use any " @@ -7987,12 +8166,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:224 +#: ../fish/guestfish-actions.pod:254 msgid "aug-defnode" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:226 +#: ../fish/guestfish-actions.pod:256 #, no-wrap msgid "" " aug-defnode name expr val\n" @@ -8000,12 +8179,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:228 ../src/guestfs-actions.pod:350 +#: ../fish/guestfish-actions.pod:258 ../src/guestfs-actions.pod:375 msgid "Defines a variable C<name> whose value is the result of evaluating C<expr>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:231 +#: ../fish/guestfish-actions.pod:261 msgid "" "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to " "calling L</aug-set> C<expr>, C<value>. C<name> will be the nodeset " @@ -8013,19 +8192,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:235 ../src/guestfs-actions.pod:357 +#: ../fish/guestfish-actions.pod:265 ../src/guestfs-actions.pod:382 msgid "" "On success this returns a pair containing the number of nodes in the " "nodeset, and a boolean flag if a node was created." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:239 +#: ../fish/guestfish-actions.pod:269 msgid "aug-defvar" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:241 +#: ../fish/guestfish-actions.pod:271 #, no-wrap msgid "" " aug-defvar name expr\n" @@ -8033,26 +8212,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:243 ../src/guestfs-actions.pod:374 +#: ../fish/guestfish-actions.pod:273 ../src/guestfs-actions.pod:399 msgid "" "Defines an Augeas variable C<name> whose value is the result of evaluating " "C<expr>. If C<expr> is NULL, then C<name> is undefined." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:247 ../src/guestfs-actions.pod:378 +#: ../fish/guestfish-actions.pod:277 ../src/guestfs-actions.pod:403 msgid "" "On success this returns the number of nodes in C<expr>, or C<0> if C<expr> " "evaluates to something which is not a nodeset." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:250 +#: ../fish/guestfish-actions.pod:280 msgid "aug-get" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:252 +#: ../fish/guestfish-actions.pod:282 #, no-wrap msgid "" " aug-get augpath\n" @@ -8060,19 +8239,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:254 ../src/guestfs-actions.pod:391 +#: ../fish/guestfish-actions.pod:284 ../src/guestfs-actions.pod:416 msgid "" "Look up the value associated with C<path>. If C<path> matches exactly one " "node, the C<value> is returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:257 +#: ../fish/guestfish-actions.pod:287 msgid "aug-init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:259 +#: ../fish/guestfish-actions.pod:289 #, no-wrap msgid "" " aug-init root flags\n" @@ -8080,7 +8259,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:261 ../src/guestfs-actions.pod:406 +#: ../fish/guestfish-actions.pod:291 ../src/guestfs-actions.pod:431 msgid "" "Create a new Augeas handle for editing configuration files. If there was " "any previous Augeas handle associated with this guestfs session, then it is " @@ -8088,56 +8267,56 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:265 +#: ../fish/guestfish-actions.pod:295 msgid "You must call this before using any other L</aug-*> commands." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:268 ../src/guestfs-actions.pod:413 +#: ../fish/guestfish-actions.pod:298 ../src/guestfs-actions.pod:438 msgid "C<root> is the filesystem root. C<root> must not be NULL, use C</> instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:271 ../src/guestfs-actions.pod:416 +#: ../fish/guestfish-actions.pod:301 ../src/guestfs-actions.pod:441 msgid "" "The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the " "logical I<or> of the following integers:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:277 ../src/guestfs-actions.pod:422 +#: ../fish/guestfish-actions.pod:307 ../src/guestfs-actions.pod:447 msgid "C<AUG_SAVE_BACKUP> = 1" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:279 ../src/guestfs-actions.pod:424 +#: ../fish/guestfish-actions.pod:309 ../src/guestfs-actions.pod:449 msgid "Keep the original file with a C<.augsave> extension." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:281 ../src/guestfs-actions.pod:426 +#: ../fish/guestfish-actions.pod:311 ../src/guestfs-actions.pod:451 msgid "C<AUG_SAVE_NEWFILE> = 2" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:283 ../src/guestfs-actions.pod:428 +#: ../fish/guestfish-actions.pod:313 ../src/guestfs-actions.pod:453 msgid "" "Save changes into a file with extension C<.augnew>, and do not overwrite " "original. Overrides C<AUG_SAVE_BACKUP>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:286 ../src/guestfs-actions.pod:431 +#: ../fish/guestfish-actions.pod:316 ../src/guestfs-actions.pod:456 msgid "C<AUG_TYPE_CHECK> = 4" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:288 ../src/guestfs-actions.pod:433 +#: ../fish/guestfish-actions.pod:318 ../src/guestfs-actions.pod:458 msgid "Typecheck lenses." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:290 +#: ../fish/guestfish-actions.pod:320 msgid "" "This option is only useful when debugging Augeas lenses. Use of this option " "may require additional memory for the libguestfs appliance. You may need to " @@ -8145,52 +8324,52 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:295 ../src/guestfs-actions.pod:440 +#: ../fish/guestfish-actions.pod:325 ../src/guestfs-actions.pod:465 msgid "C<AUG_NO_STDINC> = 8" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:297 ../src/guestfs-actions.pod:442 +#: ../fish/guestfish-actions.pod:327 ../src/guestfs-actions.pod:467 msgid "Do not use standard load path for modules." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:299 ../src/guestfs-actions.pod:444 +#: ../fish/guestfish-actions.pod:329 ../src/guestfs-actions.pod:469 msgid "C<AUG_SAVE_NOOP> = 16" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:301 ../src/guestfs-actions.pod:446 +#: ../fish/guestfish-actions.pod:331 ../src/guestfs-actions.pod:471 msgid "Make save a no-op, just record what would have been changed." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:303 ../src/guestfs-actions.pod:448 +#: ../fish/guestfish-actions.pod:333 ../src/guestfs-actions.pod:473 msgid "C<AUG_NO_LOAD> = 32" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:305 +#: ../fish/guestfish-actions.pod:335 msgid "Do not load the tree in L</aug-init>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:309 +#: ../fish/guestfish-actions.pod:339 msgid "To close the handle, you can call L</aug-close>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:311 ../src/guestfs-actions.pod:456 +#: ../fish/guestfish-actions.pod:341 ../src/guestfs-actions.pod:481 msgid "To find out more about Augeas, see L<http://augeas.net/>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:313 +#: ../fish/guestfish-actions.pod:343 msgid "aug-insert" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:315 +#: ../fish/guestfish-actions.pod:345 #, no-wrap msgid "" " aug-insert augpath label true|false\n" @@ -8198,26 +8377,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:317 ../src/guestfs-actions.pod:470 +#: ../fish/guestfish-actions.pod:347 ../src/guestfs-actions.pod:495 msgid "" "Create a new sibling C<label> for C<path>, inserting it into the tree before " "or after C<path> (depending on the boolean flag C<before>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:321 ../src/guestfs-actions.pod:474 +#: ../fish/guestfish-actions.pod:351 ../src/guestfs-actions.pod:499 msgid "" "C<path> must match exactly one existing node in the tree, and C<label> must " "be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:325 +#: ../fish/guestfish-actions.pod:355 msgid "aug-load" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:327 +#: ../fish/guestfish-actions.pod:357 #, no-wrap msgid "" " aug-load\n" @@ -8225,22 +8404,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:329 ../src/guestfs-actions.pod:487 +#: ../fish/guestfish-actions.pod:359 ../src/guestfs-actions.pod:512 msgid "Load files into the tree." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:331 ../src/guestfs-actions.pod:489 +#: ../fish/guestfish-actions.pod:361 ../src/guestfs-actions.pod:514 msgid "See C<aug_load> in the Augeas documentation for the full gory details." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:334 +#: ../fish/guestfish-actions.pod:364 msgid "aug-ls" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:336 +#: ../fish/guestfish-actions.pod:366 #, no-wrap msgid "" " aug-ls augpath\n" @@ -8248,19 +8427,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:338 +#: ../fish/guestfish-actions.pod:368 msgid "" "This is just a shortcut for listing L</aug-match> C<path/*> and sorting the " "resulting nodes into alphabetical order." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:341 +#: ../fish/guestfish-actions.pod:371 msgid "aug-match" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:343 +#: ../fish/guestfish-actions.pod:373 #, no-wrap msgid "" " aug-match augpath\n" @@ -8268,7 +8447,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:345 ../src/guestfs-actions.pod:517 +#: ../fish/guestfish-actions.pod:375 ../src/guestfs-actions.pod:542 msgid "" "Returns a list of paths which match the path expression C<path>. The " "returned paths are sufficiently qualified so that they match exactly one " @@ -8276,12 +8455,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:349 +#: ../fish/guestfish-actions.pod:379 msgid "aug-mv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:351 +#: ../fish/guestfish-actions.pod:381 #, no-wrap msgid "" " aug-mv src dest\n" @@ -8289,19 +8468,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:353 ../src/guestfs-actions.pod:534 +#: ../fish/guestfish-actions.pod:383 ../src/guestfs-actions.pod:559 msgid "" "Move the node C<src> to C<dest>. C<src> must match exactly one node. " "C<dest> is overwritten if it exists." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:356 +#: ../fish/guestfish-actions.pod:386 msgid "aug-rm" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:358 +#: ../fish/guestfish-actions.pod:388 #, no-wrap msgid "" " aug-rm augpath\n" @@ -8309,22 +8488,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:360 ../src/guestfs-actions.pod:547 +#: ../fish/guestfish-actions.pod:390 ../src/guestfs-actions.pod:572 msgid "Remove C<path> and all of its children." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:362 ../src/guestfs-actions.pod:549 +#: ../fish/guestfish-actions.pod:392 ../src/guestfs-actions.pod:574 msgid "On success this returns the number of entries which were removed." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:364 +#: ../fish/guestfish-actions.pod:394 msgid "aug-save" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:366 +#: ../fish/guestfish-actions.pod:396 #, no-wrap msgid "" " aug-save\n" @@ -8332,24 +8511,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:368 ../src/guestfs-actions.pod:560 +#: ../fish/guestfish-actions.pod:398 ../src/guestfs-actions.pod:585 msgid "This writes all pending changes to disk." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:370 +#: ../fish/guestfish-actions.pod:400 msgid "" "The flags which were passed to L</aug-init> affect exactly how files are " "saved." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:373 +#: ../fish/guestfish-actions.pod:403 msgid "aug-set" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:375 +#: ../fish/guestfish-actions.pod:405 #, no-wrap msgid "" " aug-set augpath val\n" @@ -8357,12 +8536,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:377 ../src/guestfs-actions.pod:576 +#: ../fish/guestfish-actions.pod:407 ../src/guestfs-actions.pod:601 msgid "Set the value associated with C<path> to C<val>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:379 +#: ../fish/guestfish-actions.pod:409 msgid "" "In the Augeas API, it is possible to clear a node by setting the value to " "NULL. Due to an oversight in the libguestfs API you cannot do that with " @@ -8370,12 +8549,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:384 +#: ../fish/guestfish-actions.pod:414 msgid "available" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:386 +#: ../fish/guestfish-actions.pod:416 #, no-wrap msgid "" " available 'groups ...'\n" @@ -8383,7 +8562,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:388 ../src/guestfs-actions.pod:593 +#: ../fish/guestfish-actions.pod:418 ../src/guestfs-actions.pod:618 msgid "" "This command is used to check the availability of some groups of " "functionality in the appliance, which not all builds of the libguestfs " @@ -8391,7 +8570,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:392 +#: ../fish/guestfish-actions.pod:422 msgid "" "The libguestfs groups, and the functions that those groups correspond to, " "are listed in L<guestfs(3)/AVAILABILITY>. You can also fetch this list at " @@ -8399,7 +8578,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:397 ../src/guestfs-actions.pod:602 +#: ../fish/guestfish-actions.pod:427 ../src/guestfs-actions.pod:627 msgid "" "The argument C<groups> is a list of group names, eg: C<[\"inotify\", " "\"augeas\"]> would check for the availability of the Linux inotify functions " @@ -8407,43 +8586,43 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:402 ../src/guestfs-actions.pod:607 +#: ../fish/guestfish-actions.pod:432 ../src/guestfs-actions.pod:632 msgid "The command returns no error if I<all> requested groups are available." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:404 ../src/guestfs-actions.pod:609 +#: ../fish/guestfish-actions.pod:434 ../src/guestfs-actions.pod:634 msgid "" "It fails with an error if one or more of the requested groups is unavailable " "in the appliance." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:407 ../src/guestfs-actions.pod:612 +#: ../fish/guestfish-actions.pod:437 ../src/guestfs-actions.pod:637 msgid "" "If an unknown group name is included in the list of groups then an error is " "always returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:410 ../src/guestfs-actions.pod:615 +#: ../fish/guestfish-actions.pod:440 ../src/guestfs-actions.pod:640 msgid "I<Notes:>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:416 +#: ../fish/guestfish-actions.pod:446 msgid "You must call L</launch> before calling this function." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:418 ../src/guestfs-actions.pod:623 +#: ../fish/guestfish-actions.pod:448 ../src/guestfs-actions.pod:648 msgid "" "The reason is because we don't know what groups are supported by the " "appliance/daemon until it is running and can be queried." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:424 ../src/guestfs-actions.pod:629 +#: ../fish/guestfish-actions.pod:454 ../src/guestfs-actions.pod:654 msgid "" "If a group of functions is available, this does not necessarily mean that " "they will work. You still have to check for errors when calling individual " @@ -8451,7 +8630,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:431 ../src/guestfs-actions.pod:636 +#: ../fish/guestfish-actions.pod:461 ../src/guestfs-actions.pod:661 msgid "" "It is usually the job of distro packagers to build complete functionality " "into the libguestfs appliance. Upstream libguestfs, if built from source " @@ -8459,25 +8638,20 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:438 +#: ../fish/guestfish-actions.pod:468 msgid "" "This call was added in version C<1.0.80>. In previous versions of " "libguestfs all you could do would be to speculatively execute a command to " "find out if the daemon implemented it. See also L</version>." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:445 -msgid "See also L</filesystem-available>." -msgstr "" - #. type: =head2 -#: ../fish/guestfish-actions.pod:447 +#: ../fish/guestfish-actions.pod:475 msgid "available-all-groups" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:449 +#: ../fish/guestfish-actions.pod:477 #, no-wrap msgid "" " available-all-groups\n" @@ -8485,7 +8659,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:451 +#: ../fish/guestfish-actions.pod:479 msgid "" "This command returns a list of all optional groups that this daemon knows " "about. Note this returns both supported and unsupported groups. To find " @@ -8494,17 +8668,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:457 +#: ../fish/guestfish-actions.pod:485 msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:459 +#: ../fish/guestfish-actions.pod:487 msgid "base64-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:461 +#: ../fish/guestfish-actions.pod:489 #, no-wrap msgid "" " base64-in (base64file|-) filename\n" @@ -8512,22 +8686,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:463 ../src/guestfs-actions.pod:682 +#: ../fish/guestfish-actions.pod:491 ../src/guestfs-actions.pod:705 msgid "This command uploads base64-encoded data from C<base64file> to C<filename>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:466 ../fish/guestfish-actions.pod:475 ../fish/guestfish-actions.pod:862 ../fish/guestfish-actions.pod:946 ../fish/guestfish-actions.pod:967 ../fish/guestfish-actions.pod:1150 ../fish/guestfish-actions.pod:1169 ../fish/guestfish-actions.pod:1620 ../fish/guestfish-actions.pod:4274 ../fish/guestfish-actions.pod:4295 ../fish/guestfish-actions.pod:5699 ../fish/guestfish-actions.pod:5711 ../fish/guestfish-actions.pod:5722 ../fish/guestfish-actions.pod:5733 ../fish/guestfish-actions.pod:5864 ../fish/guestfish-actions.pod:5873 ../fish/guestfish-actions.pod:5942 ../fish/guestfish-actions.pod:5965 +#: ../fish/guestfish-actions.pod:494 ../fish/guestfish-actions.pod:503 ../fish/guestfish-actions.pod:862 ../fish/guestfish-actions.pod:946 ../fish/guestfish-actions.pod:967 ../fish/guestfish-actions.pod:1150 ../fish/guestfish-actions.pod:1169 ../fish/guestfish-actions.pod:1575 ../fish/guestfish-actions.pod:4162 ../fish/guestfish-actions.pod:4183 ../fish/guestfish-actions.pod:5564 ../fish/guestfish-actions.pod:5576 ../fish/guestfish-actions.pod:5587 ../fish/guestfish-actions.pod:5598 ../fish/guestfish-actions.pod:5729 ../fish/guestfish-actions.pod:5738 ../fish/guestfish-actions.pod:5803 ../fish/guestfish-actions.pod:5826 msgid "Use C<-> instead of a filename to read/write from stdin/stdout." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:468 +#: ../fish/guestfish-actions.pod:496 msgid "base64-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:470 +#: ../fish/guestfish-actions.pod:498 #, no-wrap msgid "" " base64-out filename (base64file|-)\n" @@ -8535,19 +8709,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:472 ../src/guestfs-actions.pod:696 +#: ../fish/guestfish-actions.pod:500 ../src/guestfs-actions.pod:719 msgid "" "This command downloads the contents of C<filename>, writing it out to local " "file C<base64file> encoded as base64." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:477 +#: ../fish/guestfish-actions.pod:505 msgid "blkid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:479 +#: ../fish/guestfish-actions.pod:507 #, no-wrap msgid "" " blkid device\n" @@ -8555,7 +8729,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:481 ../src/guestfs-actions.pod:709 +#: ../fish/guestfish-actions.pod:509 ../src/guestfs-actions.pod:732 msgid "" "This command returns block device attributes for C<device>. The following " "fields are usually present in the returned hash. Other fields may also be " @@ -8563,62 +8737,62 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:486 ../src/guestfs-actions.pod:714 +#: ../fish/guestfish-actions.pod:514 ../src/guestfs-actions.pod:737 msgid "C<UUID>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:488 ../src/guestfs-actions.pod:716 +#: ../fish/guestfish-actions.pod:516 ../src/guestfs-actions.pod:739 msgid "The uuid of this device." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:490 ../src/guestfs-actions.pod:718 +#: ../fish/guestfish-actions.pod:518 ../src/guestfs-actions.pod:741 msgid "C<LABEL>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:492 ../src/guestfs-actions.pod:720 +#: ../fish/guestfish-actions.pod:520 ../src/guestfs-actions.pod:743 msgid "The label of this device." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:494 ../src/guestfs-actions.pod:722 +#: ../fish/guestfish-actions.pod:522 ../src/guestfs-actions.pod:745 msgid "C<VERSION>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:496 ../src/guestfs-actions.pod:724 +#: ../fish/guestfish-actions.pod:524 ../src/guestfs-actions.pod:747 msgid "The version of blkid command." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:498 ../src/guestfs-actions.pod:726 +#: ../fish/guestfish-actions.pod:526 ../src/guestfs-actions.pod:749 msgid "C<TYPE>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:500 ../src/guestfs-actions.pod:728 +#: ../fish/guestfish-actions.pod:528 ../src/guestfs-actions.pod:751 msgid "The filesystem type or RAID of this device." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:502 ../src/guestfs-actions.pod:730 +#: ../fish/guestfish-actions.pod:530 ../src/guestfs-actions.pod:753 msgid "C<USAGE>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:504 ../src/guestfs-actions.pod:732 +#: ../fish/guestfish-actions.pod:532 ../src/guestfs-actions.pod:755 msgid "The usage of this device, for example C<filesystem> or C<raid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:508 +#: ../fish/guestfish-actions.pod:536 msgid "blockdev-flushbufs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:510 +#: ../fish/guestfish-actions.pod:538 #, no-wrap msgid "" " blockdev-flushbufs device\n" @@ -8626,22 +8800,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:512 ../src/guestfs-actions.pod:750 +#: ../fish/guestfish-actions.pod:540 ../src/guestfs-actions.pod:773 msgid "This tells the kernel to flush internal buffers associated with C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:515 ../fish/guestfish-actions.pod:526 ../fish/guestfish-actions.pod:535 ../fish/guestfish-actions.pod:545 ../fish/guestfish-actions.pod:557 ../fish/guestfish-actions.pod:570 ../fish/guestfish-actions.pod:578 ../fish/guestfish-actions.pod:589 ../fish/guestfish-actions.pod:597 ../fish/guestfish-actions.pod:605 ../src/guestfs-actions.pod:753 ../src/guestfs-actions.pod:770 ../src/guestfs-actions.pod:785 ../src/guestfs-actions.pod:801 ../src/guestfs-actions.pod:819 ../src/guestfs-actions.pod:838 ../src/guestfs-actions.pod:852 ../src/guestfs-actions.pod:870 ../src/guestfs-actions.pod:884 ../src/guestfs-actions.pod:898 +#: ../fish/guestfish-actions.pod:543 ../fish/guestfish-actions.pod:554 ../fish/guestfish-actions.pod:563 ../fish/guestfish-actions.pod:573 ../fish/guestfish-actions.pod:585 ../fish/guestfish-actions.pod:598 ../fish/guestfish-actions.pod:606 ../fish/guestfish-actions.pod:617 ../fish/guestfish-actions.pod:625 ../fish/guestfish-actions.pod:633 ../src/guestfs-actions.pod:776 ../src/guestfs-actions.pod:793 ../src/guestfs-actions.pod:808 ../src/guestfs-actions.pod:824 ../src/guestfs-actions.pod:842 ../src/guestfs-actions.pod:861 ../src/guestfs-actions.pod:875 ../src/guestfs-actions.pod:893 ../src/guestfs-actions.pod:907 ../src/guestfs-actions.pod:921 msgid "This uses the L<blockdev(8)> command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:517 +#: ../fish/guestfish-actions.pod:545 msgid "blockdev-getbsz" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:519 +#: ../fish/guestfish-actions.pod:547 #, no-wrap msgid "" " blockdev-getbsz device\n" @@ -8649,24 +8823,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:521 ../src/guestfs-actions.pod:765 +#: ../fish/guestfish-actions.pod:549 ../src/guestfs-actions.pod:788 msgid "This returns the block size of a device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:523 ../fish/guestfish-actions.pod:586 ../src/guestfs-actions.pod:767 ../src/guestfs-actions.pod:867 +#: ../fish/guestfish-actions.pod:551 ../fish/guestfish-actions.pod:614 ../src/guestfs-actions.pod:790 ../src/guestfs-actions.pod:890 msgid "" "(Note this is different from both I<size in blocks> and I<filesystem block " "size>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:528 +#: ../fish/guestfish-actions.pod:556 msgid "blockdev-getro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:530 +#: ../fish/guestfish-actions.pod:558 #, no-wrap msgid "" " blockdev-getro device\n" @@ -8674,19 +8848,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:532 ../src/guestfs-actions.pod:782 +#: ../fish/guestfish-actions.pod:560 ../src/guestfs-actions.pod:805 msgid "" "Returns a boolean indicating if the block device is read-only (true if " "read-only, false if not)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:537 +#: ../fish/guestfish-actions.pod:565 msgid "blockdev-getsize64" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:539 +#: ../fish/guestfish-actions.pod:567 #, no-wrap msgid "" " blockdev-getsize64 device\n" @@ -8694,22 +8868,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:541 ../src/guestfs-actions.pod:797 +#: ../fish/guestfish-actions.pod:569 ../src/guestfs-actions.pod:820 msgid "This returns the size of the device in bytes." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:543 +#: ../fish/guestfish-actions.pod:571 msgid "See also L</blockdev-getsz>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:547 +#: ../fish/guestfish-actions.pod:575 msgid "blockdev-getss" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:549 +#: ../fish/guestfish-actions.pod:577 #, no-wrap msgid "" " blockdev-getss device\n" @@ -8717,24 +8891,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:551 ../src/guestfs-actions.pod:813 +#: ../fish/guestfish-actions.pod:579 ../src/guestfs-actions.pod:836 msgid "" "This returns the size of sectors on a block device. Usually 512, but can be " "larger for modern devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:554 +#: ../fish/guestfish-actions.pod:582 msgid "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:559 +#: ../fish/guestfish-actions.pod:587 msgid "blockdev-getsz" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:561 +#: ../fish/guestfish-actions.pod:589 #, no-wrap msgid "" " blockdev-getsz device\n" @@ -8742,26 +8916,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:563 ../src/guestfs-actions.pod:831 +#: ../fish/guestfish-actions.pod:591 ../src/guestfs-actions.pod:854 msgid "" "This returns the size of the device in units of 512-byte sectors (even if " "the sectorsize isn't 512 bytes ... weird)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:566 +#: ../fish/guestfish-actions.pod:594 msgid "" "See also L</blockdev-getss> for the real sector size of the device, and " "L</blockdev-getsize64> for the more useful I<size in bytes>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:572 +#: ../fish/guestfish-actions.pod:600 msgid "blockdev-rereadpt" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:574 +#: ../fish/guestfish-actions.pod:602 #, no-wrap msgid "" " blockdev-rereadpt device\n" @@ -8769,17 +8943,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:576 ../src/guestfs-actions.pod:850 +#: ../fish/guestfish-actions.pod:604 ../src/guestfs-actions.pod:873 msgid "Reread the partition table on C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:580 +#: ../fish/guestfish-actions.pod:608 msgid "blockdev-setbsz" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:582 +#: ../fish/guestfish-actions.pod:610 #, no-wrap msgid "" " blockdev-setbsz device blocksize\n" @@ -8787,17 +8961,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:584 ../src/guestfs-actions.pod:865 +#: ../fish/guestfish-actions.pod:612 ../src/guestfs-actions.pod:888 msgid "This sets the block size of a device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:591 +#: ../fish/guestfish-actions.pod:619 msgid "blockdev-setro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:593 +#: ../fish/guestfish-actions.pod:621 #, no-wrap msgid "" " blockdev-setro device\n" @@ -8805,17 +8979,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:595 ../src/guestfs-actions.pod:882 +#: ../fish/guestfish-actions.pod:623 ../src/guestfs-actions.pod:905 msgid "Sets the block device named C<device> to read-only." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:599 +#: ../fish/guestfish-actions.pod:627 msgid "blockdev-setrw" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:601 +#: ../fish/guestfish-actions.pod:629 #, no-wrap msgid "" " blockdev-setrw device\n" @@ -8823,17 +8997,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:603 ../src/guestfs-actions.pod:896 +#: ../fish/guestfish-actions.pod:631 ../src/guestfs-actions.pod:919 msgid "Sets the block device named C<device> to read-write." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:607 +#: ../fish/guestfish-actions.pod:635 msgid "btrfs-device-add" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:609 +#: ../fish/guestfish-actions.pod:637 #, no-wrap msgid "" " btrfs-device-add 'devices ...' fs\n" @@ -8841,19 +9015,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:611 ../src/guestfs-actions.pod:911 +#: ../fish/guestfish-actions.pod:639 ../src/guestfs-actions.pod:934 msgid "" "Add the list of device(s) in C<devices> to the btrfs filesystem mounted at " "C<fs>. If C<devices> is an empty list, this does nothing." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:614 +#: ../fish/guestfish-actions.pod:642 msgid "btrfs-device-delete" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:616 +#: ../fish/guestfish-actions.pod:644 #, no-wrap msgid "" " btrfs-device-delete 'devices ...' fs\n" @@ -8861,19 +9035,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:618 ../src/guestfs-actions.pod:925 +#: ../fish/guestfish-actions.pod:646 ../src/guestfs-actions.pod:948 msgid "" "Remove the C<devices> from the btrfs filesystem mounted at C<fs>. If " "C<devices> is an empty list, this does nothing." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:621 +#: ../fish/guestfish-actions.pod:649 msgid "btrfs-filesystem-balance" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:623 +#: ../fish/guestfish-actions.pod:651 #, no-wrap msgid "" " btrfs-filesystem-balance fs\n" @@ -8881,19 +9055,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:625 ../src/guestfs-actions.pod:938 +#: ../fish/guestfish-actions.pod:653 ../src/guestfs-actions.pod:961 msgid "" "Balance the chunks in the btrfs filesystem mounted at C<fs> across the " "underlying devices." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:628 +#: ../fish/guestfish-actions.pod:656 msgid "btrfs-filesystem-resize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:630 +#: ../fish/guestfish-actions.pod:658 #, no-wrap msgid "" " btrfs-filesystem-resize mountpoint [size:N]\n" @@ -8901,12 +9075,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:632 ../src/guestfs-actions.pod:959 +#: ../fish/guestfish-actions.pod:660 ../src/guestfs-actions.pod:982 msgid "This command resizes a btrfs filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:634 ../src/guestfs-actions.pod:961 +#: ../fish/guestfish-actions.pod:662 ../src/guestfs-actions.pod:984 msgid "" "Note that unlike other resize calls, the filesystem has to be mounted and " "the parameter is the mountpoint not the device (this is a requirement of " @@ -8914,34 +9088,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:638 ../fish/guestfish-actions.pod:3630 ../fish/guestfish-actions.pod:4324 ../fish/guestfish-actions.pod:5773 ../src/guestfs-actions.pod:965 ../src/guestfs-actions.pod:5652 ../src/guestfs-actions.pod:6895 ../src/guestfs-actions.pod:9055 +#: ../fish/guestfish-actions.pod:666 ../fish/guestfish-actions.pod:3512 ../fish/guestfish-actions.pod:4234 ../fish/guestfish-actions.pod:5638 ../src/guestfs-actions.pod:988 ../src/guestfs-actions.pod:5430 ../src/guestfs-actions.pod:6691 ../src/guestfs-actions.pod:8799 msgid "The optional parameters are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:642 ../fish/guestfish-actions.pod:4328 ../src/guestfs-actions.pod:969 ../src/guestfs-actions.pod:6899 +#: ../fish/guestfish-actions.pod:670 ../fish/guestfish-actions.pod:4238 ../src/guestfs-actions.pod:992 ../src/guestfs-actions.pod:6695 msgid "C<size>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:644 ../src/guestfs-actions.pod:971 +#: ../fish/guestfish-actions.pod:672 ../src/guestfs-actions.pod:994 msgid "" "The new size (in bytes) of the filesystem. If omitted, the filesystem is " "resized to the maximum size." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:649 ../src/guestfs-actions.pod:976 +#: ../fish/guestfish-actions.pod:677 ../src/guestfs-actions.pod:999 msgid "See also L<btrfs(8)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:653 +#: ../fish/guestfish-actions.pod:681 msgid "btrfs-filesystem-sync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:655 +#: ../fish/guestfish-actions.pod:683 #, no-wrap msgid "" " btrfs-filesystem-sync fs\n" @@ -8949,17 +9123,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:657 ../src/guestfs-actions.pod:1010 +#: ../fish/guestfish-actions.pod:685 ../src/guestfs-actions.pod:1033 msgid "Force sync on the btrfs filesystem mounted at C<fs>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:659 +#: ../fish/guestfish-actions.pod:687 msgid "btrfs-fsck" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:661 +#: ../fish/guestfish-actions.pod:689 #, no-wrap msgid "" " btrfs-fsck device [superblock:N] [repair:true|false]\n" @@ -8967,19 +9141,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:663 ../src/guestfs-actions.pod:1031 +#: ../fish/guestfish-actions.pod:691 ../src/guestfs-actions.pod:1054 msgid "" "Used to check a btrfs filesystem, C<device> is the device file where the " "filesystem is stored." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:668 +#: ../fish/guestfish-actions.pod:696 msgid "btrfs-set-seeding" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:670 +#: ../fish/guestfish-actions.pod:698 #, no-wrap msgid "" " btrfs-set-seeding device true|false\n" @@ -8987,19 +9161,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:672 ../src/guestfs-actions.pod:1067 +#: ../fish/guestfish-actions.pod:700 ../src/guestfs-actions.pod:1090 msgid "" "Enable or disable the seeding feature of a device that contains a btrfs " "filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:675 +#: ../fish/guestfish-actions.pod:703 msgid "btrfs-subvolume-create" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:677 +#: ../fish/guestfish-actions.pod:705 #, no-wrap msgid "" " btrfs-subvolume-create dest\n" @@ -9007,19 +9181,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:679 ../src/guestfs-actions.pod:1080 +#: ../fish/guestfish-actions.pod:707 ../src/guestfs-actions.pod:1103 msgid "" "Create a btrfs subvolume. The C<dest> argument is the destination directory " "and the name of the snapshot, in the form C</path/to/dest/name>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:682 +#: ../fish/guestfish-actions.pod:710 msgid "btrfs-subvolume-delete" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:684 +#: ../fish/guestfish-actions.pod:712 #, no-wrap msgid "" " btrfs-subvolume-delete subvolume\n" @@ -9027,17 +9201,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:686 ../src/guestfs-actions.pod:1093 +#: ../fish/guestfish-actions.pod:714 ../src/guestfs-actions.pod:1116 msgid "Delete the named btrfs subvolume." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:688 +#: ../fish/guestfish-actions.pod:716 msgid "btrfs-subvolume-list" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:690 +#: ../fish/guestfish-actions.pod:718 #, no-wrap msgid "" " btrfs-subvolume-list fs\n" @@ -9045,19 +9219,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:692 ../src/guestfs-actions.pod:1105 +#: ../fish/guestfish-actions.pod:720 ../src/guestfs-actions.pod:1128 msgid "" "List the btrfs snapshots and subvolumes of the btrfs filesystem which is " "mounted at C<fs>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:695 +#: ../fish/guestfish-actions.pod:723 msgid "btrfs-subvolume-set-default" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:697 +#: ../fish/guestfish-actions.pod:725 #, no-wrap msgid "" " btrfs-subvolume-set-default id fs\n" @@ -9065,19 +9239,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:699 +#: ../fish/guestfish-actions.pod:727 msgid "" "Set the subvolume of the btrfs filesystem C<fs> which will be mounted by " "default. See L</btrfs-subvolume-list> to get a list of subvolumes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:703 +#: ../fish/guestfish-actions.pod:731 msgid "btrfs-subvolume-snapshot" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:705 +#: ../fish/guestfish-actions.pod:733 #, no-wrap msgid "" " btrfs-subvolume-snapshot source dest\n" @@ -9085,7 +9259,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:707 ../src/guestfs-actions.pod:1136 +#: ../fish/guestfish-actions.pod:735 ../src/guestfs-actions.pod:1159 msgid "" "Create a writable snapshot of the btrfs subvolume C<source>. The C<dest> " "argument is the destination directory and the name of the snapshot, in the " @@ -9093,65 +9267,6 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:711 -msgid "canonical-device-name" -msgstr "" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:713 -#, no-wrap -msgid "" -" canonical-device-name device\n" -"\n" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:715 ../src/guestfs-actions.pod:1150 -msgid "" -"This utility function is useful when displaying device names to the user. " -"It takes a number of irregular device names and returns them in a consistent " -"format:" -msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:721 ../src/guestfs-actions.pod:1156 -msgid "C</dev/hdX>" -msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:723 ../src/guestfs-actions.pod:1158 -msgid "C</dev/vdX>" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:725 ../src/guestfs-actions.pod:1160 -msgid "" -"These are returned as C</dev/sdX>. Note this works for device names and " -"partition names. This is approximately the reverse of the algorithm " -"described in L<guestfs(3)/BLOCK DEVICE NAMING>." -msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:729 ../src/guestfs-actions.pod:1164 -msgid "C</dev/mapper/VG-LV>" -msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:731 ../src/guestfs-actions.pod:1166 -msgid "C</dev/dm-N>" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:733 -msgid "Converted to C</dev/VG/LV> form using L</lvm-canonical-lvm-name>." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:737 ../src/guestfs-actions.pod:1172 -msgid "Other strings are returned unmodified." -msgstr "" - -#. type: =head2 #: ../fish/guestfish-actions.pod:739 msgid "case-sensitive-path" msgstr "" @@ -9165,7 +9280,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:743 ../src/guestfs-actions.pod:1185 +#: ../fish/guestfish-actions.pod:743 ../src/guestfs-actions.pod:1173 msgid "" "This can be used to resolve case insensitive paths on a filesystem which is " "case sensitive. The use case is to resolve paths which you have read from " @@ -9173,7 +9288,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:748 ../src/guestfs-actions.pod:1190 +#: ../fish/guestfish-actions.pod:748 ../src/guestfs-actions.pod:1178 msgid "" "The command handles a peculiarity of the Linux ntfs-3g filesystem driver " "(and probably others), which is that although the underlying filesystem is " @@ -9182,7 +9297,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:753 ../src/guestfs-actions.pod:1195 +#: ../fish/guestfish-actions.pod:753 ../src/guestfs-actions.pod:1183 msgid "" "One consequence of this is that special directories such as C<c:\\windows> " "may appear as C</WINDOWS> or C</windows> (or other things) depending on the " @@ -9191,14 +9306,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:759 ../src/guestfs-actions.pod:1201 +#: ../fish/guestfish-actions.pod:759 ../src/guestfs-actions.pod:1189 msgid "" "Bug or feature? You decide: " "L<http://www.tuxera.com/community/ntfs-3g-faq/#posixfilenames1>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:762 ../src/guestfs-actions.pod:1204 +#: ../fish/guestfish-actions.pod:762 ../src/guestfs-actions.pod:1192 msgid "" "This function resolves the true case of each element in the path and returns " "the case-sensitive path." @@ -9213,7 +9328,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:770 ../src/guestfs-actions.pod:1212 +#: ../fish/guestfish-actions.pod:770 ../src/guestfs-actions.pod:1200 msgid "I<Note>: This function does not handle drive names, backslashes etc." msgstr "" @@ -9236,7 +9351,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:779 ../fish/guestfish-actions.pod:4767 ../src/guestfs-actions.pod:1228 ../src/guestfs-actions.pod:7574 +#: ../fish/guestfish-actions.pod:779 ../fish/guestfish-actions.pod:4665 ../src/guestfs-actions.pod:1216 ../src/guestfs-actions.pod:7351 msgid "Return the contents of the file named C<path>." msgstr "" @@ -9250,7 +9365,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:786 ../fish/guestfish-actions.pod:921 ../fish/guestfish-actions.pod:933 ../fish/guestfish-actions.pod:1260 ../fish/guestfish-actions.pod:1277 ../fish/guestfish-actions.pod:1351 ../fish/guestfish-actions.pod:1368 ../fish/guestfish-actions.pod:1584 ../fish/guestfish-actions.pod:2080 ../fish/guestfish-actions.pod:2090 ../fish/guestfish-actions.pod:2147 ../fish/guestfish-actions.pod:2162 ../fish/guestfish-actions.pod:2172 ../fish/guestfish-actions.pod:2191 ../fish/guestfish-actions.pod:4625 ../fish/guestfish-actions.pod:4640 ../fish/guestfish-actions.pod:4728 ../fish/guestfish-actions.pod:4745 ../fish/guestfish-actions.pod:4760 ../fish/guestfish-actions.pod:5540 ../fish/guestfish-actions.pod:5586 ../fish/guestfish-actions.pod:5671 ../fish/guestfish-actions.pod:5686 ../fish/guestfish-actions.pod:6229 ../fish/guestfish-actions.pod:6241 ../fish/guestfish-actions.pod:6259 ../fish/guestfish-actions.pod:6299 ../fish/guestfish-actions.pod:6316 ../fish/guestfish-actions.pod:6391 ../fish/guestfish-actions.pod:6408 ../fish/guestfish-actions.pod:6444 ../fish/guestfish-actions.pod:6461 ../src/guestfs-actions.pod:1238 ../src/guestfs-actions.pod:1417 ../src/guestfs-actions.pod:1437 ../src/guestfs-actions.pod:2184 ../src/guestfs-actions.pod:2210 ../src/guestfs-actions.pod:2320 ../src/guestfs-actions.pod:2346 ../src/guestfs-actions.pod:2615 ../src/guestfs-actions.pod:3350 ../src/guestfs-actions.pod:3398 ../src/guestfs-actions.pod:3463 ../src/guestfs-actions.pod:3487 ../src/guestfs-actions.pod:3504 ../src/guestfs-actions.pod:3533 ../src/guestfs-actions.pod:7337 ../src/guestfs-actions.pod:7363 ../src/guestfs-actions.pod:7513 ../src/guestfs-actions.pod:7539 ../src/guestfs-actions.pod:7563 ../src/guestfs-actions.pod:8683 ../src/guestfs-actions.pod:8738 ../src/guestfs-actions.pod:8884 ../src/guestfs-actions.pod:8908 ../src/guestfs-actions.pod:9849 ../src/guestfs-actions.pod:9869 ../src/guestfs-actions.pod:9902 ../src/guestfs-actions.pod:9997 ../src/guestfs-actions.pod:10023 ../src/guestfs-actions.pod:10146 ../src/guestfs-actions.pod:10172 ../src/guestfs-actions.pod:10225 ../src/guestfs-actions.pod:10251 +#: ../fish/guestfish-actions.pod:786 ../fish/guestfish-actions.pod:921 ../fish/guestfish-actions.pod:933 ../fish/guestfish-actions.pod:1260 ../fish/guestfish-actions.pod:1270 ../fish/guestfish-actions.pod:1337 ../fish/guestfish-actions.pod:1347 ../fish/guestfish-actions.pod:1539 ../fish/guestfish-actions.pod:1982 ../fish/guestfish-actions.pod:1992 ../fish/guestfish-actions.pod:2042 ../fish/guestfish-actions.pod:2057 ../fish/guestfish-actions.pod:2067 ../fish/guestfish-actions.pod:2086 ../fish/guestfish-actions.pod:4535 ../fish/guestfish-actions.pod:4550 ../fish/guestfish-actions.pod:4626 ../fish/guestfish-actions.pod:4643 ../fish/guestfish-actions.pod:4658 ../fish/guestfish-actions.pod:5405 ../fish/guestfish-actions.pod:5451 ../fish/guestfish-actions.pod:5536 ../fish/guestfish-actions.pod:5551 ../fish/guestfish-actions.pod:6070 ../fish/guestfish-actions.pod:6082 ../fish/guestfish-actions.pod:6100 ../fish/guestfish-actions.pod:6117 ../fish/guestfish-actions.pod:6127 ../fish/guestfish-actions.pod:6194 ../fish/guestfish-actions.pod:6204 ../fish/guestfish-actions.pod:6233 ../fish/guestfish-actions.pod:6243 ../src/guestfs-actions.pod:1226 ../src/guestfs-actions.pod:1405 ../src/guestfs-actions.pod:1425 ../src/guestfs-actions.pod:2163 ../src/guestfs-actions.pod:2182 ../src/guestfs-actions.pod:2285 ../src/guestfs-actions.pod:2304 ../src/guestfs-actions.pod:2550 ../src/guestfs-actions.pod:3175 ../src/guestfs-actions.pod:3194 ../src/guestfs-actions.pod:3259 ../src/guestfs-actions.pod:3283 ../src/guestfs-actions.pod:3300 ../src/guestfs-actions.pod:3329 ../src/guestfs-actions.pod:7133 ../src/guestfs-actions.pod:7159 ../src/guestfs-actions.pod:7290 ../src/guestfs-actions.pod:7316 ../src/guestfs-actions.pod:7340 ../src/guestfs-actions.pod:8427 ../src/guestfs-actions.pod:8482 ../src/guestfs-actions.pod:8628 ../src/guestfs-actions.pod:8652 ../src/guestfs-actions.pod:9519 ../src/guestfs-actions.pod:9539 ../src/guestfs-actions.pod:9572 ../src/guestfs-actions.pod:9591 ../src/guestfs-actions.pod:9610 ../src/guestfs-actions.pod:9725 ../src/guestfs-actions.pod:9744 ../src/guestfs-actions.pod:9790 ../src/guestfs-actions.pod:9809 msgid "" "Because of the message protocol, there is a transfer limit of somewhere " "between 2MB and 4MB. See L<guestfs(3)/PROTOCOL LIMITS>." @@ -9270,91 +9385,91 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:793 ../src/guestfs-actions.pod:1250 +#: ../fish/guestfish-actions.pod:793 ../src/guestfs-actions.pod:1238 msgid "This call computes the MD5, SHAx or CRC checksum of the file named C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:796 ../src/guestfs-actions.pod:1253 +#: ../fish/guestfish-actions.pod:796 ../src/guestfs-actions.pod:1241 msgid "" "The type of checksum to compute is given by the C<csumtype> parameter which " "must have one of the following values:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:801 ../src/guestfs-actions.pod:1258 +#: ../fish/guestfish-actions.pod:801 ../src/guestfs-actions.pod:1246 msgid "C<crc>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:803 ../src/guestfs-actions.pod:1260 +#: ../fish/guestfish-actions.pod:803 ../src/guestfs-actions.pod:1248 msgid "" "Compute the cyclic redundancy check (CRC) specified by POSIX for the " "C<cksum> command." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:806 ../src/guestfs-actions.pod:1263 +#: ../fish/guestfish-actions.pod:806 ../src/guestfs-actions.pod:1251 msgid "C<md5>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:808 ../src/guestfs-actions.pod:1265 +#: ../fish/guestfish-actions.pod:808 ../src/guestfs-actions.pod:1253 msgid "Compute the MD5 hash (using the C<md5sum> program)." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:810 ../src/guestfs-actions.pod:1267 +#: ../fish/guestfish-actions.pod:810 ../src/guestfs-actions.pod:1255 msgid "C<sha1>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:812 ../src/guestfs-actions.pod:1269 +#: ../fish/guestfish-actions.pod:812 ../src/guestfs-actions.pod:1257 msgid "Compute the SHA1 hash (using the C<sha1sum> program)." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:814 ../src/guestfs-actions.pod:1271 +#: ../fish/guestfish-actions.pod:814 ../src/guestfs-actions.pod:1259 msgid "C<sha224>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:816 ../src/guestfs-actions.pod:1273 +#: ../fish/guestfish-actions.pod:816 ../src/guestfs-actions.pod:1261 msgid "Compute the SHA224 hash (using the C<sha224sum> program)." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:818 ../src/guestfs-actions.pod:1275 +#: ../fish/guestfish-actions.pod:818 ../src/guestfs-actions.pod:1263 msgid "C<sha256>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:820 ../src/guestfs-actions.pod:1277 +#: ../fish/guestfish-actions.pod:820 ../src/guestfs-actions.pod:1265 msgid "Compute the SHA256 hash (using the C<sha256sum> program)." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:822 ../src/guestfs-actions.pod:1279 +#: ../fish/guestfish-actions.pod:822 ../src/guestfs-actions.pod:1267 msgid "C<sha384>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:824 ../src/guestfs-actions.pod:1281 +#: ../fish/guestfish-actions.pod:824 ../src/guestfs-actions.pod:1269 msgid "Compute the SHA384 hash (using the C<sha384sum> program)." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:826 ../src/guestfs-actions.pod:1283 +#: ../fish/guestfish-actions.pod:826 ../src/guestfs-actions.pod:1271 msgid "C<sha512>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:828 ../src/guestfs-actions.pod:1285 +#: ../fish/guestfish-actions.pod:828 ../src/guestfs-actions.pod:1273 msgid "Compute the SHA512 hash (using the C<sha512sum> program)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:832 ../src/guestfs-actions.pod:1289 +#: ../fish/guestfish-actions.pod:832 ../src/guestfs-actions.pod:1277 msgid "The checksum is returned as a printable string." msgstr "" @@ -9403,14 +9518,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:850 ../src/guestfs-actions.pod:1324 +#: ../fish/guestfish-actions.pod:850 ../src/guestfs-actions.pod:1312 msgid "" "This command computes the checksums of all regular files in C<directory> and " "then emits a list of those checksums to the local output file C<sumsfile>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:854 ../src/guestfs-actions.pod:1328 +#: ../fish/guestfish-actions.pod:854 ../src/guestfs-actions.pod:1316 msgid "" "This can be used for verifying the integrity of a virtual machine. However " "to be properly secure you should pay attention to the output of the checksum " @@ -9433,14 +9548,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:868 ../src/guestfs-actions.pod:1347 +#: ../fish/guestfish-actions.pod:868 ../src/guestfs-actions.pod:1335 msgid "" "Change the mode (permissions) of C<path> to C<mode>. Only numeric modes are " "supported." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:871 ../src/guestfs-actions.pod:1350 +#: ../fish/guestfish-actions.pod:871 ../src/guestfs-actions.pod:1338 msgid "" "I<Note>: When using this command from guestfish, C<mode> by default would be " "decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not " @@ -9448,7 +9563,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:875 ../fish/guestfish-actions.pod:3879 ../fish/guestfish-actions.pod:4026 ../fish/guestfish-actions.pod:4036 ../fish/guestfish-actions.pod:4046 ../src/guestfs-actions.pod:1354 ../src/guestfs-actions.pod:6030 ../src/guestfs-actions.pod:6293 ../src/guestfs-actions.pod:6312 ../src/guestfs-actions.pod:6331 +#: ../fish/guestfish-actions.pod:875 ../fish/guestfish-actions.pod:3761 ../fish/guestfish-actions.pod:3914 ../fish/guestfish-actions.pod:3924 ../fish/guestfish-actions.pod:3934 ../src/guestfs-actions.pod:1342 ../src/guestfs-actions.pod:5808 ../src/guestfs-actions.pod:6072 ../src/guestfs-actions.pod:6091 ../src/guestfs-actions.pod:6110 msgid "The mode actually set is affected by the umask." msgstr "" @@ -9466,12 +9581,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:881 ../src/guestfs-actions.pod:1368 +#: ../fish/guestfish-actions.pod:881 ../src/guestfs-actions.pod:1356 msgid "Change the file owner to C<owner> and group to C<group>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:883 ../fish/guestfish-actions.pod:3138 ../src/guestfs-actions.pod:1370 ../src/guestfs-actions.pod:4833 +#: ../fish/guestfish-actions.pod:883 ../fish/guestfish-actions.pod:3033 ../src/guestfs-actions.pod:1358 ../src/guestfs-actions.pod:4629 msgid "" "Only numeric uid and gid are supported. If you want to use names, you will " "need to locate and parse the password file yourself (Augeas support makes " @@ -9492,7 +9607,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:891 ../src/guestfs-actions.pod:1384 +#: ../fish/guestfish-actions.pod:891 ../src/guestfs-actions.pod:1372 msgid "" "This call runs a command from the guest filesystem. The filesystem must be " "mounted, and must contain a compatible operating system (ie. something " @@ -9509,12 +9624,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:903 ../src/guestfs-actions.pod:1396 +#: ../fish/guestfish-actions.pod:903 ../src/guestfs-actions.pod:1384 msgid "The return value is anything printed to I<stdout> by the command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:906 ../src/guestfs-actions.pod:1399 +#: ../fish/guestfish-actions.pod:906 ../src/guestfs-actions.pod:1387 msgid "" "If the command returns a non-zero exit status, then this function returns an " "error message. The error message string is the content of I<stderr> from " @@ -9522,7 +9637,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:910 ../src/guestfs-actions.pod:1403 +#: ../fish/guestfish-actions.pod:910 ../src/guestfs-actions.pod:1391 msgid "" "The C<$PATH> environment variable will contain at least C</usr/bin> and " "C</bin>. If you require a program from another location, you should provide " @@ -9530,7 +9645,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:915 ../src/guestfs-actions.pod:1408 +#: ../fish/guestfish-actions.pod:915 ../src/guestfs-actions.pod:1396 msgid "" "Shared libraries and data files required by the program must be available on " "filesystems which are mounted in the correct places. It is the caller's " @@ -9575,7 +9690,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:940 ../src/guestfs-actions.pod:1458 +#: ../fish/guestfish-actions.pod:940 ../src/guestfs-actions.pod:1446 msgid "" "This command compresses C<device> and writes it out to the local file " "C<zdevice>." @@ -9602,14 +9717,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:954 ../src/guestfs-actions.pod:1510 +#: ../fish/guestfish-actions.pod:954 ../src/guestfs-actions.pod:1498 msgid "" "This command compresses C<file> and writes it out to the local file " "C<zfile>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:957 ../src/guestfs-actions.pod:1513 +#: ../fish/guestfish-actions.pod:957 ../src/guestfs-actions.pod:1501 msgid "" "The compression program used is controlled by the C<ctype> parameter. " "Currently this includes: C<compress>, C<gzip>, C<bzip2>, C<xz> or C<lzop>. " @@ -9619,7 +9734,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:963 ../src/guestfs-actions.pod:1519 +#: ../fish/guestfish-actions.pod:963 ../src/guestfs-actions.pod:1507 msgid "" "The optional C<level> parameter controls compression level. The meaning and " "default for this parameter depends on the compression program being used." @@ -9639,7 +9754,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:975 ../src/guestfs-actions.pod:1560 +#: ../fish/guestfish-actions.pod:975 ../src/guestfs-actions.pod:1548 msgid "" "This can be used to add arbitrary qemu command line parameters of the form " "I<-param value>. Actually it's not quite arbitrary - we prevent you from " @@ -9647,13 +9762,13 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:980 ../src/guestfs-actions.pod:1565 -msgid "The first character of C<qemuparam> string must be a C<-> (dash)." +#: ../fish/guestfish-actions.pod:980 ../src/guestfs-actions.pod:1553 +msgid "The first character of C<param> string must be a C<-> (dash)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:982 ../src/guestfs-actions.pod:1567 -msgid "C<qemuvalue> can be NULL." +#: ../fish/guestfish-actions.pod:982 ../src/guestfs-actions.pod:1555 +msgid "C<value> can be NULL." msgstr "" #. type: =head2 @@ -9678,7 +9793,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:995 ../src/guestfs-actions.pod:1597 +#: ../fish/guestfish-actions.pod:995 ../src/guestfs-actions.pod:1585 msgid "" "Partial copies can be made since you can specify optionally the source " "offset, destination offset and size to copy. These values are all specified " @@ -9687,14 +9802,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1001 ../src/guestfs-actions.pod:1603 +#: ../fish/guestfish-actions.pod:1001 ../src/guestfs-actions.pod:1591 msgid "" "The source and destination may be the same object. However overlapping " "regions may not be copied correctly." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1004 ../src/guestfs-actions.pod:1606 +#: ../fish/guestfish-actions.pod:1004 ../src/guestfs-actions.pod:1594 msgid "" "If the destination is a file, it is created if required. If the destination " "file is not large enough, it is extended." @@ -9766,14 +9881,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1045 ../src/guestfs-actions.pod:1821 +#: ../fish/guestfish-actions.pod:1045 ../src/guestfs-actions.pod:1809 msgid "" "This command copies exactly C<size> bytes from one source device or file " "C<src> to another destination device or file C<dest>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1048 ../src/guestfs-actions.pod:1824 +#: ../fish/guestfish-actions.pod:1048 ../src/guestfs-actions.pod:1812 msgid "" "Note this will fail if the source is too short or if the destination is not " "large enough." @@ -9800,7 +9915,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1062 ../src/guestfs-actions.pod:1843 +#: ../fish/guestfish-actions.pod:1062 ../src/guestfs-actions.pod:1831 msgid "" "This copies a file from C<src> to C<dest> where C<dest> is either a " "destination filename or destination directory." @@ -9820,7 +9935,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1069 ../src/guestfs-actions.pod:1857 +#: ../fish/guestfish-actions.pod:1069 ../src/guestfs-actions.pod:1845 msgid "" "This copies a file or directory from C<src> to C<dest> recursively using the " "C<cp -a> command." @@ -9840,7 +9955,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1076 ../src/guestfs-actions.pod:1878 +#: ../fish/guestfish-actions.pod:1076 ../src/guestfs-actions.pod:1866 msgid "" "This command copies from one source device or file C<src> to another " "destination device or file C<dest>. Normally you would use this to copy to " @@ -9869,7 +9984,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1097 ../src/guestfs-actions.pod:1898 +#: ../fish/guestfish-actions.pod:1097 ../src/guestfs-actions.pod:1886 msgid "" "This function takes a device name (eg. \"/dev/sdb\") and returns the index " "of the device in the list of devices." @@ -9901,7 +10016,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1109 ../src/guestfs-actions.pod:1915 +#: ../fish/guestfish-actions.pod:1109 ../src/guestfs-actions.pod:1901 msgid "This command runs the C<df> command to report disk space used." msgstr "" @@ -9927,7 +10042,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1119 ../src/guestfs-actions.pod:1931 +#: ../fish/guestfish-actions.pod:1119 ../src/guestfs-actions.pod:1917 msgid "" "This command runs the C<df -h> command to report disk space used in " "human-readable format." @@ -9947,7 +10062,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1130 ../src/guestfs-actions.pod:1948 +#: ../fish/guestfish-actions.pod:1130 ../src/guestfs-actions.pod:1934 msgid "" "This returns the kernel messages (C<dmesg> output) from the guest kernel. " "This is sometimes useful for extended debugging of problems." @@ -9975,14 +10090,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1143 ../fish/guestfish-actions.pod:1156 ../src/guestfs-actions.pod:1969 ../src/guestfs-actions.pod:1994 +#: ../fish/guestfish-actions.pod:1143 ../fish/guestfish-actions.pod:1156 ../src/guestfs-actions.pod:1955 ../src/guestfs-actions.pod:1980 msgid "" "Download file C<remotefilename> and save it as C<filename> on the local " "machine." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1146 ../fish/guestfish-actions.pod:5938 ../src/guestfs-actions.pod:1972 ../src/guestfs-actions.pod:9349 +#: ../fish/guestfish-actions.pod:1146 ../fish/guestfish-actions.pod:5799 ../src/guestfs-actions.pod:1958 ../src/guestfs-actions.pod:9051 msgid "C<filename> can also be a named pipe." msgstr "" @@ -10005,7 +10120,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1159 ../src/guestfs-actions.pod:1997 +#: ../fish/guestfish-actions.pod:1159 ../src/guestfs-actions.pod:1983 msgid "" "C<remotefilename> is read for C<size> bytes starting at C<offset> (this " "region must be within the file or device)." @@ -10038,7 +10153,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1175 ../src/guestfs-actions.pod:2022 +#: ../fish/guestfish-actions.pod:1175 ../src/guestfs-actions.pod:2008 msgid "" "This instructs the guest kernel to drop its page cache, and/or dentries and " "inode caches. The parameter C<whattodrop> tells the kernel what precisely " @@ -10046,12 +10161,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1180 ../src/guestfs-actions.pod:2027 +#: ../fish/guestfish-actions.pod:1180 ../src/guestfs-actions.pod:2013 msgid "Setting C<whattodrop> to 3 should drop everything." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1182 ../src/guestfs-actions.pod:2029 +#: ../fish/guestfish-actions.pod:1182 ../src/guestfs-actions.pod:2015 msgid "" "This automatically calls L<sync(2)> before the operation, so that the " "maximum guest memory is freed." @@ -10071,14 +10186,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1189 ../src/guestfs-actions.pod:2042 +#: ../fish/guestfish-actions.pod:1189 ../src/guestfs-actions.pod:2028 msgid "" "This command runs the C<du -s> command to estimate file space usage for " "C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1192 ../src/guestfs-actions.pod:2045 +#: ../fish/guestfish-actions.pod:1192 ../src/guestfs-actions.pod:2031 msgid "" "C<path> can be a file or a directory. If C<path> is a directory then the " "estimate includes the contents of the directory and all subdirectories " @@ -10086,7 +10201,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1196 ../src/guestfs-actions.pod:2049 +#: ../fish/guestfish-actions.pod:1196 ../src/guestfs-actions.pod:2035 msgid "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)." msgstr "" @@ -10104,19 +10219,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1203 ../src/guestfs-actions.pod:2076 +#: ../fish/guestfish-actions.pod:1203 ../src/guestfs-actions.pod:2062 msgid "" "This runs the ext2/ext3 filesystem checker on C<device>. It can take the " "following optional arguments:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1208 ../src/guestfs-actions.pod:2081 +#: ../fish/guestfish-actions.pod:1208 ../src/guestfs-actions.pod:2067 msgid "C<correct>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1210 ../src/guestfs-actions.pod:2083 +#: ../fish/guestfish-actions.pod:1210 ../src/guestfs-actions.pod:2069 msgid "" "Automatically repair the file system. This option will cause e2fsck to " "automatically fix any filesystem problems that can be safely fixed without " @@ -10124,24 +10239,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1214 ../src/guestfs-actions.pod:2087 +#: ../fish/guestfish-actions.pod:1214 ../src/guestfs-actions.pod:2073 msgid "This option may not be specified at the same time as the C<forceall> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1216 ../src/guestfs-actions.pod:2089 +#: ../fish/guestfish-actions.pod:1216 ../src/guestfs-actions.pod:2075 msgid "C<forceall>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1218 ../src/guestfs-actions.pod:2091 +#: ../fish/guestfish-actions.pod:1218 ../src/guestfs-actions.pod:2077 msgid "" "Assume an answer of 'yes' to all questions; allows e2fsck to be used " "non-interactively." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1221 ../src/guestfs-actions.pod:2094 +#: ../fish/guestfish-actions.pod:1221 ../src/guestfs-actions.pod:2080 msgid "This option may not be specified at the same time as the C<correct> option." msgstr "" @@ -10159,7 +10274,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1231 ../src/guestfs-actions.pod:2137 +#: ../fish/guestfish-actions.pod:1231 ../src/guestfs-actions.pod:2123 msgid "" "This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker " "on C<device>, noninteractively (I<-p>), even if the filesystem appears to be " @@ -10187,14 +10302,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1246 ../src/guestfs-actions.pod:2151 +#: ../fish/guestfish-actions.pod:1246 ../src/guestfs-actions.pod:2137 msgid "" "This command concatenates the list of C<words> passed with single spaces " "between them and returns the resulting string." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1249 ../src/guestfs-actions.pod:2154 +#: ../fish/guestfish-actions.pod:1249 ../src/guestfs-actions.pod:2140 msgid "You can use this command to test the connection through to the daemon." msgstr "" @@ -10217,22 +10332,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1257 ../src/guestfs-actions.pod:2177 +#: ../fish/guestfish-actions.pod:1257 ../src/guestfs-actions.pod:2156 msgid "This calls the external C<egrep> program and returns the matching lines." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1263 ../fish/guestfish-actions.pod:1280 ../fish/guestfish-actions.pod:1354 ../fish/guestfish-actions.pod:1371 ../fish/guestfish-actions.pod:2093 ../fish/guestfish-actions.pod:6302 ../fish/guestfish-actions.pod:6319 ../fish/guestfish-actions.pod:6394 ../fish/guestfish-actions.pod:6411 ../fish/guestfish-actions.pod:6447 ../fish/guestfish-actions.pod:6464 -msgid "I<This function is deprecated.> In new code, use the L</grep> call instead." -msgstr "" - #. type: =head2 -#: ../fish/guestfish-actions.pod:1270 +#: ../fish/guestfish-actions.pod:1263 msgid "egrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1272 +#: ../fish/guestfish-actions.pod:1265 #, no-wrap msgid "" " egrepi regex path\n" @@ -10240,17 +10350,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1274 ../src/guestfs-actions.pod:2203 +#: ../fish/guestfish-actions.pod:1267 ../src/guestfs-actions.pod:2175 msgid "This calls the external C<egrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1287 +#: ../fish/guestfish-actions.pod:1273 msgid "equal" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1289 +#: ../fish/guestfish-actions.pod:1275 #, no-wrap msgid "" " equal file1 file2\n" @@ -10258,24 +10368,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1291 ../src/guestfs-actions.pod:2222 +#: ../fish/guestfish-actions.pod:1277 ../src/guestfs-actions.pod:2194 msgid "" "This compares the two files C<file1> and C<file2> and returns true if their " "content is exactly equal, or false otherwise." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1294 ../src/guestfs-actions.pod:2225 +#: ../fish/guestfish-actions.pod:1280 ../src/guestfs-actions.pod:2197 msgid "The external L<cmp(1)> program is used for the comparison." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1296 +#: ../fish/guestfish-actions.pod:1282 msgid "exists" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1298 +#: ../fish/guestfish-actions.pod:1284 #, no-wrap msgid "" " exists path\n" @@ -10283,24 +10393,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1300 ../src/guestfs-actions.pod:2237 +#: ../fish/guestfish-actions.pod:1286 ../src/guestfs-actions.pod:2209 msgid "" "This returns C<true> if and only if there is a file, directory (or anything) " "with the given C<path> name." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1303 +#: ../fish/guestfish-actions.pod:1289 msgid "See also L</is-file>, L</is-dir>, L</stat>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1305 +#: ../fish/guestfish-actions.pod:1291 msgid "fallocate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1307 +#: ../fish/guestfish-actions.pod:1293 #, no-wrap msgid "" " fallocate path len\n" @@ -10308,33 +10418,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1309 ../fish/guestfish-actions.pod:1328 ../src/guestfs-actions.pod:2260 ../src/guestfs-actions.pod:2279 +#: ../fish/guestfish-actions.pod:1295 ../fish/guestfish-actions.pod:1314 ../src/guestfs-actions.pod:2232 ../src/guestfs-actions.pod:2251 msgid "" "This command preallocates a file (containing zero bytes) named C<path> of " "size C<len> bytes. If the file exists already, it is overwritten." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1313 ../src/guestfs-actions.pod:2264 +#: ../fish/guestfish-actions.pod:1299 ../src/guestfs-actions.pod:2236 msgid "" "Do not confuse this with the guestfish-specific C<alloc> command which " "allocates a file in the host and attaches it as a device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1317 +#: ../fish/guestfish-actions.pod:1303 msgid "" "I<This function is deprecated.> In new code, use the L</fallocate64> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1324 +#: ../fish/guestfish-actions.pod:1310 msgid "fallocate64" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1326 +#: ../fish/guestfish-actions.pod:1312 #, no-wrap msgid "" " fallocate64 path len\n" @@ -10342,14 +10452,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1332 +#: ../fish/guestfish-actions.pod:1318 msgid "" "Note that this call allocates disk blocks for the file. To create a sparse " "file use L</truncate-size> instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1335 +#: ../fish/guestfish-actions.pod:1321 msgid "" "The deprecated call L</fallocate> does the same, but owing to an oversight " "it only allowed 30 bit lengths to be specified, effectively limiting the " @@ -10357,19 +10467,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1340 ../src/guestfs-actions.pod:2291 +#: ../fish/guestfish-actions.pod:1326 ../src/guestfs-actions.pod:2263 msgid "" "Do not confuse this with the guestfish-specific C<alloc> and C<sparse> " "commands which create a file in the host and attach it as a device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1344 +#: ../fish/guestfish-actions.pod:1330 msgid "fgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1346 +#: ../fish/guestfish-actions.pod:1332 #, no-wrap msgid "" " fgrep pattern path\n" @@ -10377,17 +10487,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1348 ../src/guestfs-actions.pod:2313 +#: ../fish/guestfish-actions.pod:1334 ../src/guestfs-actions.pod:2278 msgid "This calls the external C<fgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1361 +#: ../fish/guestfish-actions.pod:1340 msgid "fgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1363 +#: ../fish/guestfish-actions.pod:1342 #, no-wrap msgid "" " fgrepi pattern path\n" @@ -10395,17 +10505,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1365 ../src/guestfs-actions.pod:2339 +#: ../fish/guestfish-actions.pod:1344 ../src/guestfs-actions.pod:2297 msgid "This calls the external C<fgrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1378 +#: ../fish/guestfish-actions.pod:1350 msgid "file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1380 +#: ../fish/guestfish-actions.pod:1352 #, no-wrap msgid "" " file path\n" @@ -10413,28 +10523,28 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1382 ../src/guestfs-actions.pod:2357 +#: ../fish/guestfish-actions.pod:1354 ../src/guestfs-actions.pod:2315 msgid "" "This call uses the standard L<file(1)> command to determine the type or " "contents of the file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1385 ../src/guestfs-actions.pod:2360 +#: ../fish/guestfish-actions.pod:1357 ../src/guestfs-actions.pod:2318 msgid "" "This call will also transparently look inside various types of compressed " "file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1388 ../src/guestfs-actions.pod:2363 +#: ../fish/guestfish-actions.pod:1360 ../src/guestfs-actions.pod:2321 msgid "" "The exact command which runs is C<file -zb path>. Note in particular that " "the filename is not prepended to the output (the I<-b> option)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1392 ../src/guestfs-actions.pod:2367 +#: ../fish/guestfish-actions.pod:1364 ../src/guestfs-actions.pod:2325 msgid "" "The output depends on the output of the underlying L<file(1)> command and it " "can change in future in ways beyond our control. In other words, the output " @@ -10442,19 +10552,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1396 +#: ../fish/guestfish-actions.pod:1368 msgid "" "See also: L<file(1)>, L</vfs-type>, L</lstat>, L</is-file>, L</is-blockdev> " "(etc), L</is-zero>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1399 +#: ../fish/guestfish-actions.pod:1371 msgid "file-architecture" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1401 +#: ../fish/guestfish-actions.pod:1373 #, no-wrap msgid "" " file-architecture filename\n" @@ -10462,166 +10572,166 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1403 ../src/guestfs-actions.pod:2385 +#: ../fish/guestfish-actions.pod:1375 ../src/guestfs-actions.pod:2343 msgid "" "This detects the architecture of the binary C<filename>, and returns it if " "known." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1406 ../src/guestfs-actions.pod:2388 +#: ../fish/guestfish-actions.pod:1378 ../src/guestfs-actions.pod:2346 msgid "Currently defined architectures are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1410 ../src/guestfs-actions.pod:2392 +#: ../fish/guestfish-actions.pod:1382 ../src/guestfs-actions.pod:2350 msgid "\"i386\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1412 ../src/guestfs-actions.pod:2394 +#: ../fish/guestfish-actions.pod:1384 ../src/guestfs-actions.pod:2352 msgid "" "This string is returned for all 32 bit i386, i486, i586, i686 binaries " "irrespective of the precise processor requirements of the binary." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1415 ../src/guestfs-actions.pod:2397 +#: ../fish/guestfish-actions.pod:1387 ../src/guestfs-actions.pod:2355 msgid "\"x86_64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1417 ../src/guestfs-actions.pod:2399 +#: ../fish/guestfish-actions.pod:1389 ../src/guestfs-actions.pod:2357 msgid "64 bit x86-64." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1419 ../src/guestfs-actions.pod:2401 +#: ../fish/guestfish-actions.pod:1391 ../src/guestfs-actions.pod:2359 msgid "\"sparc\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1421 ../src/guestfs-actions.pod:2403 +#: ../fish/guestfish-actions.pod:1393 ../src/guestfs-actions.pod:2361 msgid "32 bit SPARC." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1423 ../src/guestfs-actions.pod:2405 +#: ../fish/guestfish-actions.pod:1395 ../src/guestfs-actions.pod:2363 msgid "\"sparc64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1425 ../src/guestfs-actions.pod:2407 +#: ../fish/guestfish-actions.pod:1397 ../src/guestfs-actions.pod:2365 msgid "64 bit SPARC V9 and above." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1427 ../src/guestfs-actions.pod:2409 +#: ../fish/guestfish-actions.pod:1399 ../src/guestfs-actions.pod:2367 msgid "\"ia64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1429 ../src/guestfs-actions.pod:2411 +#: ../fish/guestfish-actions.pod:1401 ../src/guestfs-actions.pod:2369 msgid "Intel Itanium." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1431 ../src/guestfs-actions.pod:2413 +#: ../fish/guestfish-actions.pod:1403 ../src/guestfs-actions.pod:2371 msgid "\"ppc\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1433 ../src/guestfs-actions.pod:2415 +#: ../fish/guestfish-actions.pod:1405 ../src/guestfs-actions.pod:2373 msgid "32 bit Power PC." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1435 ../src/guestfs-actions.pod:2417 +#: ../fish/guestfish-actions.pod:1407 ../src/guestfs-actions.pod:2375 msgid "\"ppc64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1437 ../src/guestfs-actions.pod:2419 +#: ../fish/guestfish-actions.pod:1409 ../src/guestfs-actions.pod:2377 msgid "64 bit Power PC." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1441 ../src/guestfs-actions.pod:2423 +#: ../fish/guestfish-actions.pod:1413 ../src/guestfs-actions.pod:2381 msgid "Libguestfs may return other architecture strings in future." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1443 ../src/guestfs-actions.pod:2425 +#: ../fish/guestfish-actions.pod:1415 ../src/guestfs-actions.pod:2383 msgid "The function works on at least the following types of files:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1449 ../src/guestfs-actions.pod:2431 +#: ../fish/guestfish-actions.pod:1421 ../src/guestfs-actions.pod:2389 msgid "many types of Un*x and Linux binary" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1453 ../src/guestfs-actions.pod:2435 +#: ../fish/guestfish-actions.pod:1425 ../src/guestfs-actions.pod:2393 msgid "many types of Un*x and Linux shared library" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1457 ../src/guestfs-actions.pod:2439 +#: ../fish/guestfish-actions.pod:1429 ../src/guestfs-actions.pod:2397 msgid "Windows Win32 and Win64 binaries" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1461 ../src/guestfs-actions.pod:2443 +#: ../fish/guestfish-actions.pod:1433 ../src/guestfs-actions.pod:2401 msgid "Windows Win32 and Win64 DLLs" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1463 ../src/guestfs-actions.pod:2445 +#: ../fish/guestfish-actions.pod:1435 ../src/guestfs-actions.pod:2403 msgid "Win32 binaries and DLLs return C<i386>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1465 ../src/guestfs-actions.pod:2447 +#: ../fish/guestfish-actions.pod:1437 ../src/guestfs-actions.pod:2405 msgid "Win64 binaries and DLLs return C<x86_64>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1469 ../src/guestfs-actions.pod:2451 +#: ../fish/guestfish-actions.pod:1441 ../src/guestfs-actions.pod:2409 msgid "Linux kernel modules" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1473 ../src/guestfs-actions.pod:2455 +#: ../fish/guestfish-actions.pod:1445 ../src/guestfs-actions.pod:2413 msgid "Linux new-style initrd images" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1477 ../src/guestfs-actions.pod:2459 +#: ../fish/guestfish-actions.pod:1449 ../src/guestfs-actions.pod:2417 msgid "some non-x86 Linux vmlinuz kernels" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1481 ../src/guestfs-actions.pod:2463 +#: ../fish/guestfish-actions.pod:1453 ../src/guestfs-actions.pod:2421 msgid "What it can't do currently:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1487 ../src/guestfs-actions.pod:2469 +#: ../fish/guestfish-actions.pod:1459 ../src/guestfs-actions.pod:2427 msgid "static libraries (libfoo.a)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1491 ../src/guestfs-actions.pod:2473 +#: ../fish/guestfish-actions.pod:1463 ../src/guestfs-actions.pod:2431 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1495 ../src/guestfs-actions.pod:2477 +#: ../fish/guestfish-actions.pod:1467 ../src/guestfs-actions.pod:2435 msgid "x86 Linux vmlinuz kernels" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1497 ../src/guestfs-actions.pod:2479 +#: ../fish/guestfish-actions.pod:1469 ../src/guestfs-actions.pod:2437 msgid "" "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and " "compressed code, and are horribly hard to unpack. If you want to find the " @@ -10630,12 +10740,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1504 +#: ../fish/guestfish-actions.pod:1476 msgid "filesize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1506 +#: ../fish/guestfish-actions.pod:1478 #, no-wrap msgid "" " filesize file\n" @@ -10643,12 +10753,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1508 ../src/guestfs-actions.pod:2497 +#: ../fish/guestfish-actions.pod:1480 ../src/guestfs-actions.pod:2455 msgid "This command returns the size of C<file> in bytes." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1510 +#: ../fish/guestfish-actions.pod:1482 msgid "" "To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, " "L</is-file> etc. To get the size of block devices, use " @@ -10656,51 +10766,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1514 -msgid "filesystem-available" -msgstr "" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:1516 -#, no-wrap -msgid "" -" filesystem-available filesystem\n" -"\n" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1518 ../src/guestfs-actions.pod:2513 -msgid "" -"Check whether libguestfs supports the named filesystem. The argument " -"C<filesystem> is a filesystem name, such as C<ext3>." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1522 -msgid "You must call L</launch> before using this command." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1524 ../src/guestfs-actions.pod:2519 ../src/guestfs.pod:1635 -msgid "" -"This is mainly useful as a negative test. If this returns true, it doesn't " -"mean that a particular filesystem can be mounted, since filesystems can fail " -"for other reasons such as it being a later version of the filesystem, or " -"having incompatible features." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1529 -msgid "See also L</available>, L<guestfs(3)/AVAILABILITY>." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:1531 +#: ../fish/guestfish-actions.pod:1486 msgid "fill" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1533 +#: ../fish/guestfish-actions.pod:1488 #, no-wrap msgid "" " fill c len path\n" @@ -10708,7 +10779,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1535 ../src/guestfs-actions.pod:2538 +#: ../fish/guestfish-actions.pod:1490 ../src/guestfs-actions.pod:2473 msgid "" "This command creates a new file called C<path>. The initial content of the " "file is C<len> octets of C<c>, where C<c> must be a number in the range " @@ -10716,7 +10787,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1539 +#: ../fish/guestfish-actions.pod:1494 msgid "" "To fill a file with zero bytes (sparsely), it is much more efficient to use " "L</truncate-size>. To create a file with a pattern of repeating bytes use " @@ -10724,12 +10795,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1544 +#: ../fish/guestfish-actions.pod:1499 msgid "fill-pattern" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1546 +#: ../fish/guestfish-actions.pod:1501 #, no-wrap msgid "" " fill-pattern pattern len path\n" @@ -10737,7 +10808,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1548 +#: ../fish/guestfish-actions.pod:1503 msgid "" "This function is like L</fill> except that it creates a new file of length " "C<len> containing the repeating pattern of bytes in C<pattern>. The pattern " @@ -10746,12 +10817,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1553 +#: ../fish/guestfish-actions.pod:1508 msgid "find" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1555 +#: ../fish/guestfish-actions.pod:1510 #, no-wrap msgid "" " find directory\n" @@ -10759,7 +10830,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1557 ../src/guestfs-actions.pod:2584 +#: ../fish/guestfish-actions.pod:1512 ../src/guestfs-actions.pod:2519 msgid "" "This command lists out all files and directories, recursively, starting at " "C<directory>. It is essentially equivalent to running the shell command " @@ -10768,14 +10839,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1562 ../src/guestfs-actions.pod:2589 +#: ../fish/guestfish-actions.pod:1517 ../src/guestfs-actions.pod:2524 msgid "" "This returns a list of strings I<without any prefix>. Thus if the directory " "structure was:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1565 ../src/guestfs-actions.pod:2592 +#: ../fish/guestfish-actions.pod:1520 ../src/guestfs-actions.pod:2527 #, no-wrap msgid "" " /tmp/a\n" @@ -10785,12 +10856,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1569 +#: ../fish/guestfish-actions.pod:1524 msgid "then the returned list from L</find> C</tmp> would be 4 elements:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1572 ../src/guestfs-actions.pod:2599 +#: ../fish/guestfish-actions.pod:1527 ../src/guestfs-actions.pod:2534 #, no-wrap msgid "" " a\n" @@ -10801,27 +10872,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1577 ../src/guestfs-actions.pod:2604 +#: ../fish/guestfish-actions.pod:1532 ../src/guestfs-actions.pod:2539 msgid "If C<directory> is not a directory, then this command returns an error." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1580 ../src/guestfs-actions.pod:2607 +#: ../fish/guestfish-actions.pod:1535 ../src/guestfs-actions.pod:2542 msgid "The returned list is sorted." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1582 +#: ../fish/guestfish-actions.pod:1537 msgid "See also L</find0>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1587 +#: ../fish/guestfish-actions.pod:1542 msgid "find0" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1589 +#: ../fish/guestfish-actions.pod:1544 #, no-wrap msgid "" " find0 directory (files|-)\n" @@ -10829,7 +10900,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1591 ../src/guestfs-actions.pod:2627 +#: ../fish/guestfish-actions.pod:1546 ../src/guestfs-actions.pod:2562 msgid "" "This command lists out all files and directories, recursively, starting at " "C<directory>, placing the resulting list in the external file called " @@ -10837,39 +10908,39 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1595 +#: ../fish/guestfish-actions.pod:1550 msgid "This command works the same way as L</find> with the following exceptions:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1602 ../src/guestfs-actions.pod:2638 +#: ../fish/guestfish-actions.pod:1557 ../src/guestfs-actions.pod:2573 msgid "The resulting list is written to an external file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1606 ../src/guestfs-actions.pod:2642 +#: ../fish/guestfish-actions.pod:1561 ../src/guestfs-actions.pod:2577 msgid "" "Items (filenames) in the result are separated by C<\\0> characters. See " "L<find(1)> option I<-print0>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1611 ../src/guestfs-actions.pod:2647 +#: ../fish/guestfish-actions.pod:1566 ../src/guestfs-actions.pod:2582 msgid "This command is not limited in the number of names that it can return." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1616 ../src/guestfs-actions.pod:2652 +#: ../fish/guestfish-actions.pod:1571 ../src/guestfs-actions.pod:2587 msgid "The result list is not sorted." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1622 +#: ../fish/guestfish-actions.pod:1577 msgid "findfs-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1624 +#: ../fish/guestfish-actions.pod:1579 #, no-wrap msgid "" " findfs-label label\n" @@ -10877,24 +10948,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1626 ../src/guestfs-actions.pod:2666 +#: ../fish/guestfish-actions.pod:1581 ../src/guestfs-actions.pod:2601 msgid "" "This command searches the filesystems and returns the one which has the " "given label. An error is returned if no such filesystem can be found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1630 +#: ../fish/guestfish-actions.pod:1585 msgid "To find the label of a filesystem, use L</vfs-label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1632 +#: ../fish/guestfish-actions.pod:1587 msgid "findfs-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1634 +#: ../fish/guestfish-actions.pod:1589 #, no-wrap msgid "" " findfs-uuid uuid\n" @@ -10902,24 +10973,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1636 ../src/guestfs-actions.pod:2683 +#: ../fish/guestfish-actions.pod:1591 ../src/guestfs-actions.pod:2618 msgid "" "This command searches the filesystems and returns the one which has the " "given UUID. An error is returned if no such filesystem can be found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1640 +#: ../fish/guestfish-actions.pod:1595 msgid "To find the UUID of a filesystem, use L</vfs-uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1642 +#: ../fish/guestfish-actions.pod:1597 msgid "fsck" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1644 +#: ../fish/guestfish-actions.pod:1599 #, no-wrap msgid "" " fsck fstype device\n" @@ -10927,93 +10998,48 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1646 ../src/guestfs-actions.pod:2701 +#: ../fish/guestfish-actions.pod:1601 ../src/guestfs-actions.pod:2636 msgid "" "This runs the filesystem checker (fsck) on C<device> which should have " "filesystem type C<fstype>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1649 ../src/guestfs-actions.pod:2704 +#: ../fish/guestfish-actions.pod:1604 ../src/guestfs-actions.pod:2639 msgid "" "The returned integer is the status. See L<fsck(8)> for the list of status " "codes from C<fsck>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1658 ../src/guestfs-actions.pod:2713 +#: ../fish/guestfish-actions.pod:1613 ../src/guestfs-actions.pod:2648 msgid "Multiple status codes can be summed together." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1662 ../src/guestfs-actions.pod:2717 +#: ../fish/guestfish-actions.pod:1617 ../src/guestfs-actions.pod:2652 msgid "" "A non-zero return code can mean \"success\", for example if errors have been " "corrected on the filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1667 ../src/guestfs-actions.pod:2722 +#: ../fish/guestfish-actions.pod:1622 ../src/guestfs-actions.pod:2657 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1672 ../src/guestfs-actions.pod:2727 +#: ../fish/guestfish-actions.pod:1627 ../src/guestfs-actions.pod:2662 msgid "This command is entirely equivalent to running C<fsck -a -t fstype device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1674 -msgid "fstrim" -msgstr "" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:1676 -#, no-wrap -msgid "" -" fstrim mountpoint [offset:N] [length:N] [minimumfreeextent:N]\n" -"\n" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1678 ../src/guestfs-actions.pod:2749 -msgid "" -"Trim the free space in the filesystem mounted on C<mountpoint>. The " -"filesystem must be mounted read-write." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1681 ../src/guestfs-actions.pod:2752 -msgid "" -"The filesystem contents are not affected, but any free space in the " -"filesystem is \"trimmed\", that is, given back to the host device, thus " -"making disk images more sparse, allowing unused space in qcow2 files to be " -"reused, etc." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1686 ../src/guestfs-actions.pod:2757 -msgid "" -"This operation requires support in libguestfs, the mounted filesystem, the " -"host filesystem, qemu and the host kernel. If this support isn't present it " -"may give an error or even appear to run but do nothing." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1691 -msgid "" -"See also L</zero-free-space>. That is a slightly different operation that " -"turns free space in the filesystem into zeroes. It is valid to call " -"L</fstrim> either instead of, or after calling L</zero-free-space>." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:1698 +#: ../fish/guestfish-actions.pod:1629 msgid "get-append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1700 +#: ../fish/guestfish-actions.pod:1631 #, no-wrap msgid "" " get-append\n" @@ -11021,24 +11047,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1702 ../src/guestfs-actions.pod:2798 +#: ../fish/guestfish-actions.pod:1633 ../src/guestfs-actions.pod:2673 msgid "" "Return the additional kernel options which are added to the guest kernel " "command line." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1705 ../src/guestfs-actions.pod:2801 +#: ../fish/guestfish-actions.pod:1636 ../src/guestfs-actions.pod:2676 msgid "If C<NULL> then no options are added." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1707 +#: ../fish/guestfish-actions.pod:1638 msgid "get-attach-method" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1709 +#: ../fish/guestfish-actions.pod:1640 #, no-wrap msgid "" " get-attach-method\n" @@ -11046,17 +11072,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1711 +#: ../fish/guestfish-actions.pod:1642 msgid "Return the current attach method. See L</set-attach-method>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1713 +#: ../fish/guestfish-actions.pod:1644 msgid "get-autosync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1715 +#: ../fish/guestfish-actions.pod:1646 #, no-wrap msgid "" " get-autosync\n" @@ -11064,17 +11090,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1717 ../src/guestfs-actions.pod:2826 +#: ../fish/guestfish-actions.pod:1648 ../src/guestfs-actions.pod:2701 msgid "Get the autosync flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1719 +#: ../fish/guestfish-actions.pod:1650 msgid "get-direct" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1721 +#: ../fish/guestfish-actions.pod:1652 #, no-wrap msgid "" " get-direct\n" @@ -11082,17 +11108,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1723 ../src/guestfs-actions.pod:2837 +#: ../fish/guestfish-actions.pod:1654 ../src/guestfs-actions.pod:2712 msgid "Return the direct appliance mode flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1725 +#: ../fish/guestfish-actions.pod:1656 msgid "get-e2attrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1727 +#: ../fish/guestfish-actions.pod:1658 #, no-wrap msgid "" " get-e2attrs file\n" @@ -11100,12 +11126,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1729 ../src/guestfs-actions.pod:2849 +#: ../fish/guestfish-actions.pod:1660 ../src/guestfs-actions.pod:2724 msgid "This returns the file attributes associated with C<file>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1731 ../src/guestfs-actions.pod:2851 +#: ../fish/guestfish-actions.pod:1662 ../src/guestfs-actions.pod:2726 msgid "" "The attributes are a set of bits associated with each inode which affect the " "behaviour of the file. The attributes are returned as a string of letters " @@ -11114,7 +11140,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1737 ../fish/guestfish-actions.pod:5106 ../src/guestfs-actions.pod:2857 ../src/guestfs-actions.pod:8045 +#: ../fish/guestfish-actions.pod:1668 ../fish/guestfish-actions.pod:4971 ../src/guestfs-actions.pod:2732 ../src/guestfs-actions.pod:7789 msgid "" "These attributes are only present when the file is located on an ext2/3/4 " "filesystem. Using this call on other filesystem types will result in an " @@ -11122,153 +11148,153 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1741 ../src/guestfs-actions.pod:2861 +#: ../fish/guestfish-actions.pod:1672 ../src/guestfs-actions.pod:2736 msgid "The characters (file attributes) in the returned string are currently:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1746 ../src/guestfs-actions.pod:2866 +#: ../fish/guestfish-actions.pod:1677 ../src/guestfs-actions.pod:2741 msgid "'A'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1748 ../src/guestfs-actions.pod:2868 +#: ../fish/guestfish-actions.pod:1679 ../src/guestfs-actions.pod:2743 msgid "When the file is accessed, its atime is not modified." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1750 ../src/guestfs-actions.pod:2870 +#: ../fish/guestfish-actions.pod:1681 ../src/guestfs-actions.pod:2745 msgid "'a'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1752 ../src/guestfs-actions.pod:2872 +#: ../fish/guestfish-actions.pod:1683 ../src/guestfs-actions.pod:2747 msgid "The file is append-only." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1754 ../fish/guestfish-actions.pod:4796 ../src/guestfs-actions.pod:2874 ../src/guestfs-actions.pod:7611 +#: ../fish/guestfish-actions.pod:1685 ../fish/guestfish-actions.pod:4694 ../src/guestfs-actions.pod:2749 ../src/guestfs-actions.pod:7388 msgid "'c'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1756 ../src/guestfs-actions.pod:2876 +#: ../fish/guestfish-actions.pod:1687 ../src/guestfs-actions.pod:2751 msgid "The file is compressed on-disk." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1758 ../src/guestfs-actions.pod:2878 +#: ../fish/guestfish-actions.pod:1689 ../src/guestfs-actions.pod:2753 msgid "'D'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1760 ../src/guestfs-actions.pod:2880 +#: ../fish/guestfish-actions.pod:1691 ../src/guestfs-actions.pod:2755 msgid "" "(Directories only.) Changes to this directory are written synchronously to " "disk." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1763 ../fish/guestfish-actions.pod:4800 ../src/guestfs-actions.pod:2883 ../src/guestfs-actions.pod:7615 +#: ../fish/guestfish-actions.pod:1694 ../fish/guestfish-actions.pod:4698 ../src/guestfs-actions.pod:2758 ../src/guestfs-actions.pod:7392 msgid "'d'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1765 ../src/guestfs-actions.pod:2885 +#: ../fish/guestfish-actions.pod:1696 ../src/guestfs-actions.pod:2760 msgid "The file is not a candidate for backup (see L<dump(8)>)." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1767 ../src/guestfs-actions.pod:2887 +#: ../fish/guestfish-actions.pod:1698 ../src/guestfs-actions.pod:2762 msgid "'E'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1769 ../src/guestfs-actions.pod:2889 +#: ../fish/guestfish-actions.pod:1700 ../src/guestfs-actions.pod:2764 msgid "The file has compression errors." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1771 ../src/guestfs-actions.pod:2891 +#: ../fish/guestfish-actions.pod:1702 ../src/guestfs-actions.pod:2766 msgid "'e'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1773 ../src/guestfs-actions.pod:2893 +#: ../fish/guestfish-actions.pod:1704 ../src/guestfs-actions.pod:2768 msgid "The file is using extents." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1775 ../src/guestfs-actions.pod:2895 +#: ../fish/guestfish-actions.pod:1706 ../src/guestfs-actions.pod:2770 msgid "'h'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1777 ../src/guestfs-actions.pod:2897 +#: ../fish/guestfish-actions.pod:1708 ../src/guestfs-actions.pod:2772 msgid "" "The file is storing its blocks in units of the filesystem blocksize instead " "of sectors." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1780 ../src/guestfs-actions.pod:2900 +#: ../fish/guestfish-actions.pod:1711 ../src/guestfs-actions.pod:2775 msgid "'I'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1782 ../src/guestfs-actions.pod:2902 +#: ../fish/guestfish-actions.pod:1713 ../src/guestfs-actions.pod:2777 msgid "(Directories only.) The directory is using hashed trees." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1784 ../src/guestfs-actions.pod:2904 +#: ../fish/guestfish-actions.pod:1715 ../src/guestfs-actions.pod:2779 msgid "'i'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1786 ../src/guestfs-actions.pod:2906 +#: ../fish/guestfish-actions.pod:1717 ../src/guestfs-actions.pod:2781 msgid "" "The file is immutable. It cannot be modified, deleted or renamed. No link " "can be created to this file." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1789 ../src/guestfs-actions.pod:2909 +#: ../fish/guestfish-actions.pod:1720 ../src/guestfs-actions.pod:2784 msgid "'j'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1791 ../src/guestfs-actions.pod:2911 +#: ../fish/guestfish-actions.pod:1722 ../src/guestfs-actions.pod:2786 msgid "The file is data-journaled." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1793 ../fish/guestfish-actions.pod:4816 ../src/guestfs-actions.pod:2913 ../src/guestfs-actions.pod:7631 +#: ../fish/guestfish-actions.pod:1724 ../fish/guestfish-actions.pod:4714 ../src/guestfs-actions.pod:2788 ../src/guestfs-actions.pod:7408 msgid "'s'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1795 ../src/guestfs-actions.pod:2915 +#: ../fish/guestfish-actions.pod:1726 ../src/guestfs-actions.pod:2790 msgid "When the file is deleted, all its blocks will be zeroed." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1797 ../src/guestfs-actions.pod:2917 +#: ../fish/guestfish-actions.pod:1728 ../src/guestfs-actions.pod:2792 msgid "'S'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1799 ../src/guestfs-actions.pod:2919 +#: ../fish/guestfish-actions.pod:1730 ../src/guestfs-actions.pod:2794 msgid "Changes to this file are written synchronously to disk." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1801 ../src/guestfs-actions.pod:2921 +#: ../fish/guestfish-actions.pod:1732 ../src/guestfs-actions.pod:2796 msgid "'T'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1803 ../src/guestfs-actions.pod:2923 +#: ../fish/guestfish-actions.pod:1734 ../src/guestfs-actions.pod:2798 msgid "" "(Directories only.) This is a hint to the block allocator that " "subdirectories contained in this directory should be spread across blocks. " @@ -11277,51 +11303,51 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1808 ../src/guestfs-actions.pod:2928 +#: ../fish/guestfish-actions.pod:1739 ../src/guestfs-actions.pod:2803 msgid "'t'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1810 ../src/guestfs-actions.pod:2930 +#: ../fish/guestfish-actions.pod:1741 ../src/guestfs-actions.pod:2805 msgid "" "For a file, this disables tail-merging. (Not used by upstream " "implementations of ext2.)" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1813 ../fish/guestfish-actions.pod:4820 ../src/guestfs-actions.pod:2933 ../src/guestfs-actions.pod:7635 +#: ../fish/guestfish-actions.pod:1744 ../fish/guestfish-actions.pod:4718 ../src/guestfs-actions.pod:2808 ../src/guestfs-actions.pod:7412 msgid "'u'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1815 ../src/guestfs-actions.pod:2935 +#: ../fish/guestfish-actions.pod:1746 ../src/guestfs-actions.pod:2810 msgid "" "When the file is deleted, its blocks will be saved, allowing the file to be " "undeleted." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1818 ../src/guestfs-actions.pod:2938 +#: ../fish/guestfish-actions.pod:1749 ../src/guestfs-actions.pod:2813 msgid "'X'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1820 ../src/guestfs-actions.pod:2940 +#: ../fish/guestfish-actions.pod:1751 ../src/guestfs-actions.pod:2815 msgid "The raw contents of the compressed file may be accessed." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1822 ../src/guestfs-actions.pod:2942 +#: ../fish/guestfish-actions.pod:1753 ../src/guestfs-actions.pod:2817 msgid "'Z'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1824 ../src/guestfs-actions.pod:2944 +#: ../fish/guestfish-actions.pod:1755 ../src/guestfs-actions.pod:2819 msgid "The compressed file is dirty." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1828 ../src/guestfs-actions.pod:2948 +#: ../fish/guestfish-actions.pod:1759 ../src/guestfs-actions.pod:2823 msgid "" "More file attributes may be added to this list later. Not all file " "attributes may be set for all kinds of files. For detailed information, " @@ -11329,22 +11355,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1832 +#: ../fish/guestfish-actions.pod:1763 msgid "See also L</set-e2attrs>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1834 +#: ../fish/guestfish-actions.pod:1765 msgid "Don't confuse these attributes with extended attributes (see L</getxattr>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1837 +#: ../fish/guestfish-actions.pod:1768 msgid "get-e2generation" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1839 +#: ../fish/guestfish-actions.pod:1770 #, no-wrap msgid "" " get-e2generation file\n" @@ -11352,7 +11378,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1841 ../src/guestfs-actions.pod:2968 +#: ../fish/guestfish-actions.pod:1772 ../src/guestfs-actions.pod:2843 msgid "" "This returns the ext2 file generation of a file. The generation (which used " "to be called the \"version\") is a number associated with an inode. This is " @@ -11360,7 +11386,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1845 ../src/guestfs-actions.pod:2972 +#: ../fish/guestfish-actions.pod:1776 ../src/guestfs-actions.pod:2847 msgid "" "The generation is only present when the file is located on an ext2/3/4 " "filesystem. Using this call on other filesystem types will result in an " @@ -11368,17 +11394,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1849 +#: ../fish/guestfish-actions.pod:1780 msgid "See L</set-e2generation>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1851 +#: ../fish/guestfish-actions.pod:1782 msgid "get-e2label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1853 +#: ../fish/guestfish-actions.pod:1784 #, no-wrap msgid "" " get-e2label device\n" @@ -11386,24 +11412,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1855 ../src/guestfs-actions.pod:2995 +#: ../fish/guestfish-actions.pod:1786 ../src/guestfs-actions.pod:2870 msgid "This returns the ext2/3/4 filesystem label of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1858 +#: ../fish/guestfish-actions.pod:1789 msgid "" "I<This function is deprecated.> In new code, use the L</vfs_label> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1865 +#: ../fish/guestfish-actions.pod:1796 msgid "get-e2uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1867 +#: ../fish/guestfish-actions.pod:1798 #, no-wrap msgid "" " get-e2uuid device\n" @@ -11411,24 +11437,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1869 ../src/guestfs-actions.pod:3016 +#: ../fish/guestfish-actions.pod:1800 ../src/guestfs-actions.pod:2891 msgid "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1872 +#: ../fish/guestfish-actions.pod:1803 msgid "" "I<This function is deprecated.> In new code, use the L</vfs_uuid> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1879 +#: ../fish/guestfish-actions.pod:1810 msgid "get-memsize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1881 +#: ../fish/guestfish-actions.pod:1812 #, no-wrap msgid "" " get-memsize\n" @@ -11436,12 +11462,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1883 ../src/guestfs-actions.pod:3029 +#: ../fish/guestfish-actions.pod:1814 ../src/guestfs-actions.pod:2904 msgid "This gets the memory size in megabytes allocated to the qemu subprocess." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1886 +#: ../fish/guestfish-actions.pod:1817 msgid "" "If L</set-memsize> was not called on this handle, and if " "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default " @@ -11449,17 +11475,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1890 ../fish/guestfish-actions.pod:1947 ../fish/guestfish-actions.pod:5179 ../fish/guestfish-actions.pod:5283 ../src/guestfs-actions.pod:3036 ../src/guestfs-actions.pod:3128 ../src/guestfs-actions.pod:8172 ../src/guestfs-actions.pod:8300 +#: ../fish/guestfish-actions.pod:1821 ../fish/guestfish-actions.pod:1878 ../fish/guestfish-actions.pod:5044 ../fish/guestfish-actions.pod:5148 ../src/guestfs-actions.pod:2911 ../src/guestfs-actions.pod:3003 ../src/guestfs-actions.pod:7916 ../src/guestfs-actions.pod:8044 msgid "For more information on the architecture of libguestfs, see L<guestfs(3)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1893 +#: ../fish/guestfish-actions.pod:1824 msgid "get-network" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1895 +#: ../fish/guestfish-actions.pod:1826 #, no-wrap msgid "" " get-network\n" @@ -11467,17 +11493,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1897 ../src/guestfs-actions.pod:3048 +#: ../fish/guestfish-actions.pod:1828 ../src/guestfs-actions.pod:2923 msgid "This returns the enable network flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1899 +#: ../fish/guestfish-actions.pod:1830 msgid "get-path" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1901 +#: ../fish/guestfish-actions.pod:1832 #, no-wrap msgid "" " get-path\n" @@ -11485,24 +11511,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1903 ../src/guestfs-actions.pod:3059 +#: ../fish/guestfish-actions.pod:1834 ../src/guestfs-actions.pod:2934 msgid "Return the current search path." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1905 ../src/guestfs-actions.pod:3061 +#: ../fish/guestfish-actions.pod:1836 ../src/guestfs-actions.pod:2936 msgid "" "This is always non-NULL. If it wasn't set already, then this will return " "the default path." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1908 +#: ../fish/guestfish-actions.pod:1839 msgid "get-pgroup" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1910 +#: ../fish/guestfish-actions.pod:1841 #, no-wrap msgid "" " get-pgroup\n" @@ -11510,22 +11536,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1912 ../src/guestfs-actions.pod:3074 +#: ../fish/guestfish-actions.pod:1843 ../src/guestfs-actions.pod:2949 msgid "This returns the process group flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1914 +#: ../fish/guestfish-actions.pod:1845 msgid "get-pid" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1916 +#: ../fish/guestfish-actions.pod:1847 msgid "pid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1918 +#: ../fish/guestfish-actions.pod:1849 #, no-wrap msgid "" " get-pid\n" @@ -11533,24 +11559,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1920 ../src/guestfs-actions.pod:3085 +#: ../fish/guestfish-actions.pod:1851 ../src/guestfs-actions.pod:2960 msgid "" "Return the process ID of the qemu subprocess. If there is no qemu " "subprocess, then this will return an error." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1923 ../src/guestfs-actions.pod:3088 +#: ../fish/guestfish-actions.pod:1854 ../src/guestfs-actions.pod:2963 msgid "This is an internal call used for debugging and testing." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1925 +#: ../fish/guestfish-actions.pod:1856 msgid "get-qemu" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1927 +#: ../fish/guestfish-actions.pod:1858 #, no-wrap msgid "" " get-qemu\n" @@ -11558,24 +11584,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1929 ../src/guestfs-actions.pod:3099 +#: ../fish/guestfish-actions.pod:1860 ../src/guestfs-actions.pod:2974 msgid "Return the current qemu binary." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1931 ../src/guestfs-actions.pod:3101 +#: ../fish/guestfish-actions.pod:1862 ../src/guestfs-actions.pod:2976 msgid "" "This is always non-NULL. If it wasn't set already, then this will return " "the default qemu binary name." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1934 +#: ../fish/guestfish-actions.pod:1865 msgid "get-recovery-proc" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1936 +#: ../fish/guestfish-actions.pod:1867 #, no-wrap msgid "" " get-recovery-proc\n" @@ -11583,17 +11609,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1938 ../src/guestfs-actions.pod:3114 +#: ../fish/guestfish-actions.pod:1869 ../src/guestfs-actions.pod:2989 msgid "Return the recovery process enabled flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1940 +#: ../fish/guestfish-actions.pod:1871 msgid "get-selinux" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1942 +#: ../fish/guestfish-actions.pod:1873 #, no-wrap msgid "" " get-selinux\n" @@ -11601,19 +11627,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1944 +#: ../fish/guestfish-actions.pod:1875 msgid "" "This returns the current setting of the selinux flag which is passed to the " "appliance at boot time. See L</set-selinux>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1950 +#: ../fish/guestfish-actions.pod:1881 msgid "get-smp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1952 +#: ../fish/guestfish-actions.pod:1883 #, no-wrap msgid "" " get-smp\n" @@ -11621,17 +11647,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1954 ../src/guestfs-actions.pod:3140 +#: ../fish/guestfish-actions.pod:1885 ../src/guestfs-actions.pod:3015 msgid "This returns the number of virtual CPUs assigned to the appliance." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1956 +#: ../fish/guestfish-actions.pod:1887 msgid "get-state" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1958 +#: ../fish/guestfish-actions.pod:1889 #, no-wrap msgid "" " get-state\n" @@ -11639,24 +11665,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1960 ../src/guestfs-actions.pod:3151 +#: ../fish/guestfish-actions.pod:1891 ../src/guestfs-actions.pod:3026 msgid "" "This returns the current state as an opaque integer. This is only useful " "for printing debug and internal error messages." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1963 ../fish/guestfish-actions.pod:2989 ../fish/guestfish-actions.pod:3027 ../fish/guestfish-actions.pod:3043 ../src/guestfs-actions.pod:3154 ../src/guestfs-actions.pod:4589 ../src/guestfs-actions.pod:4650 ../src/guestfs-actions.pod:4677 +#: ../fish/guestfish-actions.pod:1894 ../fish/guestfish-actions.pod:2884 ../fish/guestfish-actions.pod:2922 ../fish/guestfish-actions.pod:2938 ../src/guestfs-actions.pod:3029 ../src/guestfs-actions.pod:4385 ../src/guestfs-actions.pod:4446 ../src/guestfs-actions.pod:4473 msgid "For more information on states, see L<guestfs(3)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1965 +#: ../fish/guestfish-actions.pod:1896 msgid "get-trace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1967 +#: ../fish/guestfish-actions.pod:1898 #, no-wrap msgid "" " get-trace\n" @@ -11664,17 +11690,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1969 ../src/guestfs-actions.pod:3165 +#: ../fish/guestfish-actions.pod:1900 ../src/guestfs-actions.pod:3040 msgid "Return the command trace flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1971 +#: ../fish/guestfish-actions.pod:1902 msgid "get-umask" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1973 +#: ../fish/guestfish-actions.pod:1904 #, no-wrap msgid "" " get-umask\n" @@ -11682,19 +11708,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1975 +#: ../fish/guestfish-actions.pod:1906 msgid "" "Return the current umask. By default the umask is C<022> unless it has been " "set by calling L</umask>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1978 +#: ../fish/guestfish-actions.pod:1909 msgid "get-verbose" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1980 +#: ../fish/guestfish-actions.pod:1911 #, no-wrap msgid "" " get-verbose\n" @@ -11702,17 +11728,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1982 ../src/guestfs-actions.pod:3188 +#: ../fish/guestfish-actions.pod:1913 ../src/guestfs-actions.pod:3063 msgid "This returns the verbose messages flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1984 +#: ../fish/guestfish-actions.pod:1915 msgid "getcon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1986 +#: ../fish/guestfish-actions.pod:1917 #, no-wrap msgid "" " getcon\n" @@ -11720,22 +11746,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1988 ../src/guestfs-actions.pod:3199 +#: ../fish/guestfish-actions.pod:1919 ../src/guestfs-actions.pod:3074 msgid "This gets the SELinux security context of the daemon." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1990 +#: ../fish/guestfish-actions.pod:1921 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1993 +#: ../fish/guestfish-actions.pod:1924 msgid "getxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1995 +#: ../fish/guestfish-actions.pod:1926 #, no-wrap msgid "" " getxattr path name\n" @@ -11743,7 +11769,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1997 +#: ../fish/guestfish-actions.pod:1928 msgid "" "Get a single extended attribute from file C<path> named C<name>. This call " "follows symlinks. If you want to lookup an extended attribute for the " @@ -11751,7 +11777,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2001 ../fish/guestfish-actions.pod:3150 +#: ../fish/guestfish-actions.pod:1932 ../fish/guestfish-actions.pod:3045 msgid "" "Normally it is better to get all extended attributes from a file in one go " "by calling L</getxattrs>. However some Linux filesystem implementations are " @@ -11761,24 +11787,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2008 ../fish/guestfish-actions.pod:3157 ../src/guestfs-actions.pod:3228 ../src/guestfs-actions.pod:4860 +#: ../fish/guestfish-actions.pod:1939 ../fish/guestfish-actions.pod:3052 ../src/guestfs-actions.pod:3103 ../src/guestfs-actions.pod:4656 msgid "" "Extended attribute values are blobs of binary data. If there is no extended " "attribute named C<name>, this returns an error." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2011 +#: ../fish/guestfish-actions.pod:1942 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2013 +#: ../fish/guestfish-actions.pod:1944 msgid "getxattrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2015 +#: ../fish/guestfish-actions.pod:1946 #, no-wrap msgid "" " getxattrs path\n" @@ -11786,29 +11812,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2017 ../src/guestfs-actions.pod:3245 +#: ../fish/guestfish-actions.pod:1948 ../src/guestfs-actions.pod:3120 msgid "This call lists the extended attributes of the file or directory C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2020 ../src/guestfs-actions.pod:3248 +#: ../fish/guestfish-actions.pod:1951 ../src/guestfs-actions.pod:3123 msgid "" "At the system call level, this is a combination of the L<listxattr(2)> and " "L<getxattr(2)> calls." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2023 +#: ../fish/guestfish-actions.pod:1954 msgid "See also: L</lgetxattrs>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2025 +#: ../fish/guestfish-actions.pod:1956 msgid "glob-expand" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2027 +#: ../fish/guestfish-actions.pod:1958 #, no-wrap msgid "" " glob-expand pattern\n" @@ -11816,26 +11842,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2029 ../src/guestfs-actions.pod:3265 +#: ../fish/guestfish-actions.pod:1960 ../src/guestfs-actions.pod:3140 msgid "" "This command searches for all the pathnames matching C<pattern> according to " "the wildcard expansion rules used by the shell." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2033 ../src/guestfs-actions.pod:3269 +#: ../fish/guestfish-actions.pod:1964 ../src/guestfs-actions.pod:3144 msgid "If no paths match, then this returns an empty list (note: not an error)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2036 ../src/guestfs-actions.pod:3272 +#: ../fish/guestfish-actions.pod:1967 ../src/guestfs-actions.pod:3147 msgid "" "It is just a wrapper around the C L<glob(3)> function with flags " "C<GLOB_MARK|GLOB_BRACE>. See that manual page for more details." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2040 +#: ../fish/guestfish-actions.pod:1971 msgid "" "Notice that there is no equivalent command for expanding a device name " "(eg. C</dev/sd*>). Use L</list-devices>, L</list-partitions> etc functions " @@ -11843,85 +11869,30 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2044 +#: ../fish/guestfish-actions.pod:1975 msgid "grep" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2046 -msgid "grep-opts" -msgstr "" - #. type: verbatim -#: ../fish/guestfish-actions.pod:2048 +#: ../fish/guestfish-actions.pod:1977 #, no-wrap msgid "" -" grep regex path [extended:true|false] [fixed:true|false] " -"[insensitive:true|false] [compressed:true|false]\n" +" grep regex path\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2050 ../src/guestfs-actions.pod:3318 +#: ../fish/guestfish-actions.pod:1979 ../src/guestfs-actions.pod:3168 msgid "This calls the external C<grep> program and returns the matching lines." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2053 ../src/guestfs-actions.pod:3321 -msgid "The optional flags are:" -msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:2057 ../src/guestfs-actions.pod:3325 -msgid "C<extended>" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:2059 ../src/guestfs-actions.pod:3327 -msgid "Use extended regular expressions. This is the same as using the I<-E> flag." -msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:2062 ../src/guestfs-actions.pod:3330 -msgid "C<fixed>" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:2064 ../src/guestfs-actions.pod:3332 -msgid "" -"Match fixed (don't use regular expressions). This is the same as using the " -"I<-F> flag." -msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:2067 ../src/guestfs-actions.pod:3335 -msgid "C<insensitive>" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:2069 ../src/guestfs-actions.pod:3337 -msgid "Match case-insensitive. This is the same as using the I<-i> flag." -msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:2071 ../src/guestfs-actions.pod:3339 -msgid "C<compressed>" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:2073 ../src/guestfs-actions.pod:3341 -msgid "" -"Use C<zgrep> instead of C<grep>. This allows the input to be compress- or " -"gzip-compressed." -msgstr "" - #. type: =head2 -#: ../fish/guestfish-actions.pod:2083 +#: ../fish/guestfish-actions.pod:1985 msgid "grepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2085 +#: ../fish/guestfish-actions.pod:1987 #, no-wrap msgid "" " grepi regex path\n" @@ -11929,17 +11900,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2087 ../src/guestfs-actions.pod:3391 +#: ../fish/guestfish-actions.pod:1989 ../src/guestfs-actions.pod:3187 msgid "This calls the external C<grep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2100 +#: ../fish/guestfish-actions.pod:1995 msgid "grub-install" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2102 +#: ../fish/guestfish-actions.pod:1997 #, no-wrap msgid "" " grub-install root device\n" @@ -11947,14 +11918,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2104 ../src/guestfs-actions.pod:3410 +#: ../fish/guestfish-actions.pod:1999 ../src/guestfs-actions.pod:3206 msgid "" "This command installs GRUB 1 (the Grand Unified Bootloader) on C<device>, " "with the root directory being C<root>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2113 ../src/guestfs-actions.pod:3419 +#: ../fish/guestfish-actions.pod:2008 ../src/guestfs-actions.pod:3215 msgid "" "There is currently no way in the API to install grub2, which is used by most " "modern Linux guests. It is possible to run the grub2 command from the " @@ -11962,7 +11933,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2120 ../src/guestfs-actions.pod:3426 +#: ../fish/guestfish-actions.pod:2015 ../src/guestfs-actions.pod:3222 msgid "" "This uses C<grub-install> from the host. Unfortunately grub is not always " "compatible with itself, so this only works in rather narrow circumstances. " @@ -11970,7 +11941,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2127 ../src/guestfs-actions.pod:3433 +#: ../fish/guestfish-actions.pod:2022 ../src/guestfs-actions.pod:3229 msgid "" "If grub-install reports the error \"No suitable drive was found in the " "generated device map.\" it may be that you need to create a " @@ -11980,7 +11951,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2134 ../src/guestfs-actions.pod:3440 +#: ../fish/guestfish-actions.pod:2029 ../src/guestfs-actions.pod:3236 #, no-wrap msgid "" " (hd0) /dev/vda\n" @@ -11988,17 +11959,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2136 ../src/guestfs-actions.pod:3442 +#: ../fish/guestfish-actions.pod:2031 ../src/guestfs-actions.pod:3238 msgid "replacing C</dev/vda> with the name of the installation device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2140 +#: ../fish/guestfish-actions.pod:2035 msgid "head" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2142 +#: ../fish/guestfish-actions.pod:2037 #, no-wrap msgid "" " head path\n" @@ -12006,19 +11977,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2144 ../src/guestfs-actions.pod:3456 +#: ../fish/guestfish-actions.pod:2039 ../src/guestfs-actions.pod:3252 msgid "" "This command returns up to the first 10 lines of a file as a list of " "strings." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2150 +#: ../fish/guestfish-actions.pod:2045 msgid "head-n" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2152 +#: ../fish/guestfish-actions.pod:2047 #, no-wrap msgid "" " head-n nrlines path\n" @@ -12026,31 +11997,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2154 ../src/guestfs-actions.pod:3475 +#: ../fish/guestfish-actions.pod:2049 ../src/guestfs-actions.pod:3271 msgid "" "If the parameter C<nrlines> is a positive number, this returns the first " "C<nrlines> lines of the file C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2157 ../src/guestfs-actions.pod:3478 +#: ../fish/guestfish-actions.pod:2052 ../src/guestfs-actions.pod:3274 msgid "" "If the parameter C<nrlines> is a negative number, this returns lines from " "the file C<path>, excluding the last C<nrlines> lines." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2160 ../fish/guestfish-actions.pod:5684 ../src/guestfs-actions.pod:3481 ../src/guestfs-actions.pod:8902 +#: ../fish/guestfish-actions.pod:2055 ../fish/guestfish-actions.pod:5549 ../src/guestfs-actions.pod:3277 ../src/guestfs-actions.pod:8646 msgid "If the parameter C<nrlines> is zero, this returns an empty list." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2165 +#: ../fish/guestfish-actions.pod:2060 msgid "hexdump" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2167 +#: ../fish/guestfish-actions.pod:2062 #, no-wrap msgid "" " hexdump path\n" @@ -12058,19 +12029,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2169 ../src/guestfs-actions.pod:3498 +#: ../fish/guestfish-actions.pod:2064 ../src/guestfs-actions.pod:3294 msgid "" "This runs C<hexdump -C> on the given C<path>. The result is the " "human-readable, canonical hex dump of the file." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2175 +#: ../fish/guestfish-actions.pod:2070 msgid "initrd-cat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2177 +#: ../fish/guestfish-actions.pod:2072 #, no-wrap msgid "" " initrd-cat initrdpath filename\n" @@ -12078,7 +12049,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2179 ../src/guestfs-actions.pod:3517 +#: ../fish/guestfish-actions.pod:2074 ../src/guestfs-actions.pod:3313 msgid "" "This command unpacks the file C<filename> from the initrd file called " "C<initrdpath>. The filename must be given I<without> the initial C</> " @@ -12086,7 +12057,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2183 ../src/guestfs-actions.pod:3521 +#: ../fish/guestfish-actions.pod:2078 ../src/guestfs-actions.pod:3317 msgid "" "For example, in guestfish you could use the following command to examine the " "boot script (usually called C</init>) contained in a Linux initrd or " @@ -12094,7 +12065,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2187 ../src/guestfs-actions.pod:3525 +#: ../fish/guestfish-actions.pod:2082 ../src/guestfs-actions.pod:3321 #, no-wrap msgid "" " initrd-cat /boot/initrd-<version>.img init\n" @@ -12102,17 +12073,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2189 +#: ../fish/guestfish-actions.pod:2084 msgid "See also L</initrd-list>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2194 +#: ../fish/guestfish-actions.pod:2089 msgid "initrd-list" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2196 +#: ../fish/guestfish-actions.pod:2091 #, no-wrap msgid "" " initrd-list path\n" @@ -12120,12 +12091,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2198 ../src/guestfs-actions.pod:3544 +#: ../fish/guestfish-actions.pod:2093 ../src/guestfs-actions.pod:3340 msgid "This command lists out files contained in an initrd." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2200 ../src/guestfs-actions.pod:3546 +#: ../fish/guestfish-actions.pod:2095 ../src/guestfs-actions.pod:3342 msgid "" "The files are listed without any initial C</> character. The files are " "listed in the order they appear (not necessarily alphabetical). Directory " @@ -12133,7 +12104,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2204 ../src/guestfs-actions.pod:3550 +#: ../fish/guestfish-actions.pod:2099 ../src/guestfs-actions.pod:3346 msgid "" "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as " "initrd. We I<only> support the newer initramfs format (compressed cpio " @@ -12141,12 +12112,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2208 +#: ../fish/guestfish-actions.pod:2103 msgid "inotify-add-watch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2210 +#: ../fish/guestfish-actions.pod:2105 #, no-wrap msgid "" " inotify-add-watch path mask\n" @@ -12154,31 +12125,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2212 ../src/guestfs-actions.pod:3567 +#: ../fish/guestfish-actions.pod:2107 ../src/guestfs-actions.pod:3363 msgid "Watch C<path> for the events listed in C<mask>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2214 ../src/guestfs-actions.pod:3569 +#: ../fish/guestfish-actions.pod:2109 ../src/guestfs-actions.pod:3365 msgid "" "Note that if C<path> is a directory then events within that directory are " "watched, but this does I<not> happen recursively (in subdirectories)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2218 ../src/guestfs-actions.pod:3573 +#: ../fish/guestfish-actions.pod:2113 ../src/guestfs-actions.pod:3369 msgid "" "Note for non-C or non-Linux callers: the inotify events are defined by the " "Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2222 +#: ../fish/guestfish-actions.pod:2117 msgid "inotify-close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2224 +#: ../fish/guestfish-actions.pod:2119 #, no-wrap msgid "" " inotify-close\n" @@ -12186,7 +12157,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2226 ../src/guestfs-actions.pod:3586 +#: ../fish/guestfish-actions.pod:2121 ../src/guestfs-actions.pod:3382 msgid "" "This closes the inotify handle which was previously opened by inotify_init. " "It removes all watches, throws away any pending events, and deallocates all " @@ -12194,12 +12165,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2230 +#: ../fish/guestfish-actions.pod:2125 msgid "inotify-files" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2232 +#: ../fish/guestfish-actions.pod:2127 #, no-wrap msgid "" " inotify-files\n" @@ -12207,7 +12178,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2234 +#: ../fish/guestfish-actions.pod:2129 msgid "" "This function is a helpful wrapper around L</inotify-read> which just " "returns a list of pathnames of objects that were touched. The returned " @@ -12215,12 +12186,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2238 +#: ../fish/guestfish-actions.pod:2133 msgid "inotify-init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2240 +#: ../fish/guestfish-actions.pod:2135 #, no-wrap msgid "" " inotify-init maxevents\n" @@ -12228,14 +12199,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2242 ../src/guestfs-actions.pod:3615 +#: ../fish/guestfish-actions.pod:2137 ../src/guestfs-actions.pod:3411 msgid "" "This command creates a new inotify handle. The inotify subsystem can be " "used to notify events which happen to objects in the guest filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2246 +#: ../fish/guestfish-actions.pod:2141 msgid "" "C<maxevents> is the maximum number of events which will be queued up between " "calls to L</inotify-read> or L</inotify-files>. If this is passed as C<0>, " @@ -12246,14 +12217,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2256 +#: ../fish/guestfish-actions.pod:2151 msgid "" "Before any events are generated, you have to add some watches to the " "internal watch list. See: L</inotify-add-watch> and L</inotify-rm-watch>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2260 +#: ../fish/guestfish-actions.pod:2155 msgid "" "Queued up events should be read periodically by calling L</inotify-read> (or " "L</inotify-files> which is just a helpful wrapper around L</inotify-read>). " @@ -12262,14 +12233,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2267 +#: ../fish/guestfish-actions.pod:2162 msgid "" "The handle should be closed after use by calling L</inotify-close>. This " "also removes any watches automatically." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2271 ../src/guestfs-actions.pod:3644 +#: ../fish/guestfish-actions.pod:2166 ../src/guestfs-actions.pod:3440 msgid "" "See also L<inotify(7)> for an overview of the inotify interface as exposed " "by the Linux kernel, which is roughly what we expose via libguestfs. Note " @@ -12277,12 +12248,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2276 +#: ../fish/guestfish-actions.pod:2171 msgid "inotify-read" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2278 +#: ../fish/guestfish-actions.pod:2173 #, no-wrap msgid "" " inotify-read\n" @@ -12290,19 +12261,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2280 ../src/guestfs-actions.pod:3658 +#: ../fish/guestfish-actions.pod:2175 ../src/guestfs-actions.pod:3454 msgid "" "Return the complete queue of events that have happened since the previous " "read call." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2283 ../src/guestfs-actions.pod:3661 +#: ../fish/guestfish-actions.pod:2178 ../src/guestfs-actions.pod:3457 msgid "If no events have happened, this returns an empty list." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2285 ../src/guestfs-actions.pod:3663 +#: ../fish/guestfish-actions.pod:2180 ../src/guestfs-actions.pod:3459 msgid "" "I<Note>: In order to make sure that all events have been read, you must call " "this function repeatedly until it returns an empty list. The reason is that " @@ -12311,12 +12282,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2291 +#: ../fish/guestfish-actions.pod:2186 msgid "inotify-rm-watch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2293 +#: ../fish/guestfish-actions.pod:2188 #, no-wrap msgid "" " inotify-rm-watch wd\n" @@ -12324,17 +12295,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2295 +#: ../fish/guestfish-actions.pod:2190 msgid "Remove a previously defined inotify watch. See L</inotify-add-watch>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2298 +#: ../fish/guestfish-actions.pod:2193 msgid "inspect-get-arch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2300 +#: ../fish/guestfish-actions.pod:2195 #, no-wrap msgid "" " inspect-get-arch root\n" @@ -12342,31 +12313,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2302 +#: ../fish/guestfish-actions.pod:2197 msgid "" "This returns the architecture of the inspected operating system. The " "possible return values are listed under L</file-architecture>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2306 ../src/guestfs-actions.pod:3698 +#: ../fish/guestfish-actions.pod:2201 ../src/guestfs-actions.pod:3494 msgid "" "If the architecture could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2309 ../fish/guestfish-actions.pod:2416 ../fish/guestfish-actions.pod:2495 ../fish/guestfish-actions.pod:2507 ../fish/guestfish-actions.pod:2591 ../fish/guestfish-actions.pod:2653 ../fish/guestfish-actions.pod:2674 ../fish/guestfish-actions.pod:2688 ../fish/guestfish-actions.pod:2728 ../fish/guestfish-actions.pod:2772 ../fish/guestfish-actions.pod:2785 ../fish/guestfish-actions.pod:2798 ../fish/guestfish-actions.pod:2808 ../fish/guestfish-actions.pod:2818 ../fish/guestfish-actions.pod:2830 ../fish/guestfish-actions.pod:2926 ../fish/guestfish-actions.pod:2960 ../src/guestfs-actions.pod:3701 ../src/guestfs-actions.pod:3815 ../src/guestfs-actions.pod:3919 ../src/guestfs-actions.pod:3938 ../src/guestfs-actions.pod:4069 ../src/guestfs-actions.pod:4153 ../src/guestfs-actions.pod:4181 ../src/guestfs-actions.pod:4202 ../src/guestfs-actions.pod:4255 ../src/guestfs-actions.pod:4307 ../src/guestfs-actions.pod:4327 ../src/guestfs-actions.pod:4347 ../src/guestfs-actions.pod:4364 ../src/guestfs-actions.pod:4380 ../src/guestfs-actions.pod:4398 ../src/guestfs-actions.pod:4500 ../src/guestfs-actions.pod:4541 +#: ../fish/guestfish-actions.pod:2204 ../fish/guestfish-actions.pod:2311 ../fish/guestfish-actions.pod:2390 ../fish/guestfish-actions.pod:2402 ../fish/guestfish-actions.pod:2486 ../fish/guestfish-actions.pod:2548 ../fish/guestfish-actions.pod:2569 ../fish/guestfish-actions.pod:2583 ../fish/guestfish-actions.pod:2623 ../fish/guestfish-actions.pod:2667 ../fish/guestfish-actions.pod:2680 ../fish/guestfish-actions.pod:2693 ../fish/guestfish-actions.pod:2703 ../fish/guestfish-actions.pod:2713 ../fish/guestfish-actions.pod:2725 ../fish/guestfish-actions.pod:2821 ../fish/guestfish-actions.pod:2855 ../src/guestfs-actions.pod:3497 ../src/guestfs-actions.pod:3611 ../src/guestfs-actions.pod:3715 ../src/guestfs-actions.pod:3734 ../src/guestfs-actions.pod:3865 ../src/guestfs-actions.pod:3949 ../src/guestfs-actions.pod:3977 ../src/guestfs-actions.pod:3998 ../src/guestfs-actions.pod:4051 ../src/guestfs-actions.pod:4103 ../src/guestfs-actions.pod:4123 ../src/guestfs-actions.pod:4143 ../src/guestfs-actions.pod:4160 ../src/guestfs-actions.pod:4176 ../src/guestfs-actions.pod:4194 ../src/guestfs-actions.pod:4296 ../src/guestfs-actions.pod:4337 msgid "Please read L<guestfs(3)/INSPECTION> for more details." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2311 +#: ../fish/guestfish-actions.pod:2206 msgid "inspect-get-distro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2313 +#: ../fish/guestfish-actions.pod:2208 #, no-wrap msgid "" " inspect-get-distro root\n" @@ -12374,251 +12345,251 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2315 ../src/guestfs-actions.pod:3714 +#: ../fish/guestfish-actions.pod:2210 ../src/guestfs-actions.pod:3510 msgid "This returns the distro (distribution) of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2318 ../src/guestfs-actions.pod:3717 +#: ../fish/guestfish-actions.pod:2213 ../src/guestfs-actions.pod:3513 msgid "Currently defined distros are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2322 ../src/guestfs-actions.pod:3721 +#: ../fish/guestfish-actions.pod:2217 ../src/guestfs-actions.pod:3517 msgid "\"archlinux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2324 ../src/guestfs-actions.pod:3723 +#: ../fish/guestfish-actions.pod:2219 ../src/guestfs-actions.pod:3519 msgid "Arch Linux." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2326 ../src/guestfs-actions.pod:3725 +#: ../fish/guestfish-actions.pod:2221 ../src/guestfs-actions.pod:3521 msgid "\"buildroot\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2328 ../src/guestfs-actions.pod:3727 +#: ../fish/guestfish-actions.pod:2223 ../src/guestfs-actions.pod:3523 msgid "Buildroot-derived distro, but not one we specifically recognize." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2330 ../src/guestfs-actions.pod:3729 +#: ../fish/guestfish-actions.pod:2225 ../src/guestfs-actions.pod:3525 msgid "\"centos\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2332 ../src/guestfs-actions.pod:3731 +#: ../fish/guestfish-actions.pod:2227 ../src/guestfs-actions.pod:3527 msgid "CentOS." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2334 ../src/guestfs-actions.pod:3733 +#: ../fish/guestfish-actions.pod:2229 ../src/guestfs-actions.pod:3529 msgid "\"cirros\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2336 ../src/guestfs-actions.pod:3735 +#: ../fish/guestfish-actions.pod:2231 ../src/guestfs-actions.pod:3531 msgid "Cirros." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2338 ../src/guestfs-actions.pod:3737 +#: ../fish/guestfish-actions.pod:2233 ../src/guestfs-actions.pod:3533 msgid "\"debian\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2340 ../src/guestfs-actions.pod:3739 +#: ../fish/guestfish-actions.pod:2235 ../src/guestfs-actions.pod:3535 msgid "Debian." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2342 ../src/guestfs-actions.pod:3741 +#: ../fish/guestfish-actions.pod:2237 ../src/guestfs-actions.pod:3537 msgid "\"fedora\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2344 ../src/guestfs-actions.pod:3743 +#: ../fish/guestfish-actions.pod:2239 ../src/guestfs-actions.pod:3539 msgid "Fedora." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2346 ../src/guestfs-actions.pod:3745 +#: ../fish/guestfish-actions.pod:2241 ../src/guestfs-actions.pod:3541 msgid "\"freedos\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2348 ../src/guestfs-actions.pod:3747 +#: ../fish/guestfish-actions.pod:2243 ../src/guestfs-actions.pod:3543 msgid "FreeDOS." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2350 ../src/guestfs-actions.pod:3749 +#: ../fish/guestfish-actions.pod:2245 ../src/guestfs-actions.pod:3545 msgid "\"gentoo\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2352 ../src/guestfs-actions.pod:3751 +#: ../fish/guestfish-actions.pod:2247 ../src/guestfs-actions.pod:3547 msgid "Gentoo." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2354 ../src/guestfs-actions.pod:3753 +#: ../fish/guestfish-actions.pod:2249 ../src/guestfs-actions.pod:3549 msgid "\"linuxmint\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2356 ../src/guestfs-actions.pod:3755 +#: ../fish/guestfish-actions.pod:2251 ../src/guestfs-actions.pod:3551 msgid "Linux Mint." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2358 ../src/guestfs-actions.pod:3757 +#: ../fish/guestfish-actions.pod:2253 ../src/guestfs-actions.pod:3553 msgid "\"mageia\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2360 ../src/guestfs-actions.pod:3759 +#: ../fish/guestfish-actions.pod:2255 ../src/guestfs-actions.pod:3555 msgid "Mageia." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2362 ../src/guestfs-actions.pod:3761 +#: ../fish/guestfish-actions.pod:2257 ../src/guestfs-actions.pod:3557 msgid "\"mandriva\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2364 ../src/guestfs-actions.pod:3763 +#: ../fish/guestfish-actions.pod:2259 ../src/guestfs-actions.pod:3559 msgid "Mandriva." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2366 ../src/guestfs-actions.pod:3765 +#: ../fish/guestfish-actions.pod:2261 ../src/guestfs-actions.pod:3561 msgid "\"meego\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2368 ../src/guestfs-actions.pod:3767 +#: ../fish/guestfish-actions.pod:2263 ../src/guestfs-actions.pod:3563 msgid "MeeGo." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2370 ../src/guestfs-actions.pod:3769 +#: ../fish/guestfish-actions.pod:2265 ../src/guestfs-actions.pod:3565 msgid "\"opensuse\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2372 ../src/guestfs-actions.pod:3771 +#: ../fish/guestfish-actions.pod:2267 ../src/guestfs-actions.pod:3567 msgid "OpenSUSE." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2374 ../src/guestfs-actions.pod:3773 +#: ../fish/guestfish-actions.pod:2269 ../src/guestfs-actions.pod:3569 msgid "\"pardus\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2376 ../src/guestfs-actions.pod:3775 +#: ../fish/guestfish-actions.pod:2271 ../src/guestfs-actions.pod:3571 msgid "Pardus." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2378 ../src/guestfs-actions.pod:3777 +#: ../fish/guestfish-actions.pod:2273 ../src/guestfs-actions.pod:3573 msgid "\"redhat-based\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2380 ../src/guestfs-actions.pod:3779 +#: ../fish/guestfish-actions.pod:2275 ../src/guestfs-actions.pod:3575 msgid "Some Red Hat-derived distro." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2382 ../src/guestfs-actions.pod:3781 +#: ../fish/guestfish-actions.pod:2277 ../src/guestfs-actions.pod:3577 msgid "\"rhel\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2384 ../src/guestfs-actions.pod:3783 +#: ../fish/guestfish-actions.pod:2279 ../src/guestfs-actions.pod:3579 msgid "Red Hat Enterprise Linux." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2386 ../src/guestfs-actions.pod:3785 +#: ../fish/guestfish-actions.pod:2281 ../src/guestfs-actions.pod:3581 msgid "\"scientificlinux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2388 ../src/guestfs-actions.pod:3787 +#: ../fish/guestfish-actions.pod:2283 ../src/guestfs-actions.pod:3583 msgid "Scientific Linux." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2390 ../src/guestfs-actions.pod:3789 +#: ../fish/guestfish-actions.pod:2285 ../src/guestfs-actions.pod:3585 msgid "\"slackware\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2392 ../src/guestfs-actions.pod:3791 +#: ../fish/guestfish-actions.pod:2287 ../src/guestfs-actions.pod:3587 msgid "Slackware." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2394 ../src/guestfs-actions.pod:3793 +#: ../fish/guestfish-actions.pod:2289 ../src/guestfs-actions.pod:3589 msgid "\"ttylinux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2396 ../src/guestfs-actions.pod:3795 +#: ../fish/guestfish-actions.pod:2291 ../src/guestfs-actions.pod:3591 msgid "ttylinux." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2398 ../src/guestfs-actions.pod:3797 +#: ../fish/guestfish-actions.pod:2293 ../src/guestfs-actions.pod:3593 msgid "\"ubuntu\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2400 ../src/guestfs-actions.pod:3799 +#: ../fish/guestfish-actions.pod:2295 ../src/guestfs-actions.pod:3595 msgid "Ubuntu." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2402 ../fish/guestfish-actions.pod:2486 ../fish/guestfish-actions.pod:2763 ../src/guestfs-actions.pod:3801 ../src/guestfs-actions.pod:3910 ../src/guestfs-actions.pod:4298 +#: ../fish/guestfish-actions.pod:2297 ../fish/guestfish-actions.pod:2381 ../fish/guestfish-actions.pod:2658 ../src/guestfs-actions.pod:3597 ../src/guestfs-actions.pod:3706 ../src/guestfs-actions.pod:4094 msgid "\"unknown\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2404 ../src/guestfs-actions.pod:3803 +#: ../fish/guestfish-actions.pod:2299 ../src/guestfs-actions.pod:3599 msgid "The distro could not be determined." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2406 ../fish/guestfish-actions.pod:2743 ../src/guestfs-actions.pod:3805 ../src/guestfs-actions.pod:4278 +#: ../fish/guestfish-actions.pod:2301 ../fish/guestfish-actions.pod:2638 ../src/guestfs-actions.pod:3601 ../src/guestfs-actions.pod:4074 msgid "\"windows\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2408 ../src/guestfs-actions.pod:3807 +#: ../fish/guestfish-actions.pod:2303 ../src/guestfs-actions.pod:3603 msgid "" "Windows does not have distributions. This string is returned if the OS type " "is Windows." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2413 ../fish/guestfish-actions.pod:2492 ../fish/guestfish-actions.pod:2769 ../src/guestfs-actions.pod:3812 ../src/guestfs-actions.pod:3916 ../src/guestfs-actions.pod:4304 +#: ../fish/guestfish-actions.pod:2308 ../fish/guestfish-actions.pod:2387 ../fish/guestfish-actions.pod:2664 ../src/guestfs-actions.pod:3608 ../src/guestfs-actions.pod:3712 ../src/guestfs-actions.pod:4100 msgid "" "Future versions of libguestfs may return other strings here. The caller " "should be prepared to handle any string." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2418 +#: ../fish/guestfish-actions.pod:2313 msgid "inspect-get-drive-mappings" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2420 +#: ../fish/guestfish-actions.pod:2315 #, no-wrap msgid "" " inspect-get-drive-mappings root\n" @@ -12626,7 +12597,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2422 ../src/guestfs-actions.pod:3828 +#: ../fish/guestfish-actions.pod:2317 ../src/guestfs-actions.pod:3624 msgid "" "This call is useful for Windows which uses a primitive system of assigning " "drive letters (like \"C:\") to partitions. This inspection API examines the " @@ -12635,7 +12606,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2428 ../src/guestfs-actions.pod:3834 +#: ../fish/guestfish-actions.pod:2323 ../src/guestfs-actions.pod:3630 #, no-wrap msgid "" " C => /dev/vda2\n" @@ -12645,7 +12616,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2432 ../src/guestfs-actions.pod:3838 +#: ../fish/guestfish-actions.pod:2327 ../src/guestfs-actions.pod:3634 msgid "" "Note that keys are drive letters. For Windows, the key is case insensitive " "and just contains the drive letter, without the customary colon separator " @@ -12653,7 +12624,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2436 ../src/guestfs-actions.pod:3842 +#: ../fish/guestfish-actions.pod:2331 ../src/guestfs-actions.pod:3638 msgid "" "In future we may support other operating systems that also used drive " "letters, but the keys for those might not be case insensitive and might be " @@ -12662,33 +12633,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2441 ../src/guestfs-actions.pod:3847 +#: ../fish/guestfish-actions.pod:2336 ../src/guestfs-actions.pod:3643 msgid "" "For Windows guests, currently only hard drive mappings are returned. " "Removable disks (eg. DVD-ROMs) are ignored." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2444 ../src/guestfs-actions.pod:3850 +#: ../fish/guestfish-actions.pod:2339 ../src/guestfs-actions.pod:3646 msgid "" "For guests that do not use drive mappings, or if the drive mappings could " "not be determined, this returns an empty hash table." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2447 +#: ../fish/guestfish-actions.pod:2342 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-mountpoints>, L</inspect-get-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2451 +#: ../fish/guestfish-actions.pod:2346 msgid "inspect-get-filesystems" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2453 +#: ../fish/guestfish-actions.pod:2348 #, no-wrap msgid "" " inspect-get-filesystems root\n" @@ -12696,7 +12667,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2455 ../src/guestfs-actions.pod:3871 +#: ../fish/guestfish-actions.pod:2350 ../src/guestfs-actions.pod:3667 msgid "" "This returns a list of all the filesystems that we think are associated with " "this operating system. This includes the root filesystem, other ordinary " @@ -12704,26 +12675,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2460 ../src/guestfs-actions.pod:3876 +#: ../fish/guestfish-actions.pod:2355 ../src/guestfs-actions.pod:3672 msgid "" "In the case of a multi-boot virtual machine, it is possible for a filesystem " "to be shared between operating systems." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2463 +#: ../fish/guestfish-actions.pod:2358 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-mountpoints>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2466 +#: ../fish/guestfish-actions.pod:2361 msgid "inspect-get-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2468 +#: ../fish/guestfish-actions.pod:2363 #, no-wrap msgid "" " inspect-get-format root\n" @@ -12731,51 +12702,51 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2470 ../src/guestfs-actions.pod:3894 +#: ../fish/guestfish-actions.pod:2365 ../src/guestfs-actions.pod:3690 msgid "" "This returns the format of the inspected operating system. You can use it " "to detect install images, live CDs and similar." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2473 ../src/guestfs-actions.pod:3897 +#: ../fish/guestfish-actions.pod:2368 ../src/guestfs-actions.pod:3693 msgid "Currently defined formats are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2477 ../src/guestfs-actions.pod:3901 +#: ../fish/guestfish-actions.pod:2372 ../src/guestfs-actions.pod:3697 msgid "\"installed\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2479 ../src/guestfs-actions.pod:3903 +#: ../fish/guestfish-actions.pod:2374 ../src/guestfs-actions.pod:3699 msgid "This is an installed operating system." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2481 ../src/guestfs-actions.pod:3905 +#: ../fish/guestfish-actions.pod:2376 ../src/guestfs-actions.pod:3701 msgid "\"installer\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2483 ../src/guestfs-actions.pod:3907 +#: ../fish/guestfish-actions.pod:2378 ../src/guestfs-actions.pod:3703 msgid "" "The disk image being inspected is not an installed operating system, but a " "I<bootable> install disk, live CD, or similar." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2488 ../src/guestfs-actions.pod:3912 +#: ../fish/guestfish-actions.pod:2383 ../src/guestfs-actions.pod:3708 msgid "The format of this disk image is not known." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2497 +#: ../fish/guestfish-actions.pod:2392 msgid "inspect-get-hostname" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2499 +#: ../fish/guestfish-actions.pod:2394 #, no-wrap msgid "" " inspect-get-hostname root\n" @@ -12783,26 +12754,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2501 ../src/guestfs-actions.pod:3932 +#: ../fish/guestfish-actions.pod:2396 ../src/guestfs-actions.pod:3728 msgid "" "This function returns the hostname of the operating system as found by " "inspection of the guest's configuration files." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2504 ../src/guestfs-actions.pod:3935 +#: ../fish/guestfish-actions.pod:2399 ../src/guestfs-actions.pod:3731 msgid "" "If the hostname could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2509 +#: ../fish/guestfish-actions.pod:2404 msgid "inspect-get-icon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2511 +#: ../fish/guestfish-actions.pod:2406 #, no-wrap msgid "" " inspect-get-icon root [favicon:true|false] [highquality:true|false]\n" @@ -12810,7 +12781,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2513 ../src/guestfs-actions.pod:3961 +#: ../fish/guestfish-actions.pod:2408 ../src/guestfs-actions.pod:3757 msgid "" "This function returns an icon corresponding to the inspected operating " "system. The icon is returned as a buffer containing a PNG image (re-encoded " @@ -12818,14 +12789,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2517 ../src/guestfs-actions.pod:3965 +#: ../fish/guestfish-actions.pod:2412 ../src/guestfs-actions.pod:3761 msgid "" "If it was not possible to get an icon this function returns a zero-length " "(non-NULL) buffer. I<Callers must check for this case>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2520 ../src/guestfs-actions.pod:3968 +#: ../fish/guestfish-actions.pod:2415 ../src/guestfs-actions.pod:3764 msgid "" "Libguestfs will start by looking for a file called C</etc/favicon.png> or " "C<C:\\etc\\favicon.png> and if it has the correct format, the contents of " @@ -12834,14 +12805,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2526 ../src/guestfs-actions.pod:3974 +#: ../fish/guestfish-actions.pod:2421 ../src/guestfs-actions.pod:3770 msgid "" "If finding the favicon fails, then we look in other places in the guest for " "a suitable icon." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2529 ../src/guestfs-actions.pod:3977 +#: ../fish/guestfish-actions.pod:2424 ../src/guestfs-actions.pod:3773 msgid "" "If the optional C<highquality> boolean is true then only high quality icons " "are returned, which means only icons of high resolution with an alpha " @@ -12850,7 +12821,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2540 ../src/guestfs-actions.pod:3988 +#: ../fish/guestfish-actions.pod:2435 ../src/guestfs-actions.pod:3784 msgid "" "Unlike most other inspection API calls, the guest's disks must be mounted up " "before you call this, since it needs to read information from the guest " @@ -12858,7 +12829,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2546 ../src/guestfs-actions.pod:3994 +#: ../fish/guestfish-actions.pod:2441 ../src/guestfs-actions.pod:3790 msgid "" "B<Security:> The icon data comes from the untrusted guest, and should be " "treated with caution. PNG files have been known to contain exploits. " @@ -12867,7 +12838,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2554 ../src/guestfs-actions.pod:4002 +#: ../fish/guestfish-actions.pod:2449 ../src/guestfs-actions.pod:3798 msgid "" "The PNG image returned can be any size. It might not be square. Libguestfs " "tries to return the largest, highest quality icon available. The " @@ -12875,7 +12846,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2561 ../src/guestfs-actions.pod:4009 +#: ../fish/guestfish-actions.pod:2456 ../src/guestfs-actions.pod:3805 msgid "" "Extracting icons from Windows guests requires the external C<wrestool> " "program from the C<icoutils> package, and several programs (C<bmptopnm>, " @@ -12884,19 +12855,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2568 ../src/guestfs-actions.pod:4016 +#: ../fish/guestfish-actions.pod:2463 ../src/guestfs-actions.pod:3812 msgid "" "Operating system icons are usually trademarks. Seek legal advice before " "using trademarks in applications." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2575 +#: ../fish/guestfish-actions.pod:2470 msgid "inspect-get-major-version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2577 +#: ../fish/guestfish-actions.pod:2472 #, no-wrap msgid "" " inspect-get-major-version root\n" @@ -12904,12 +12875,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2579 ../src/guestfs-actions.pod:4057 +#: ../fish/guestfish-actions.pod:2474 ../src/guestfs-actions.pod:3853 msgid "This returns the major version number of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2582 ../src/guestfs-actions.pod:4060 +#: ../fish/guestfish-actions.pod:2477 ../src/guestfs-actions.pod:3856 msgid "" "Windows uses a consistent versioning scheme which is I<not> reflected in the " "popular public names used by the operating system. Notably the operating " @@ -12919,17 +12890,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2589 ../fish/guestfish-actions.pod:2600 ../src/guestfs-actions.pod:4067 ../src/guestfs-actions.pod:4084 +#: ../fish/guestfish-actions.pod:2484 ../fish/guestfish-actions.pod:2495 ../src/guestfs-actions.pod:3863 ../src/guestfs-actions.pod:3880 msgid "If the version could not be determined, then C<0> is returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2593 +#: ../fish/guestfish-actions.pod:2488 msgid "inspect-get-minor-version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2595 +#: ../fish/guestfish-actions.pod:2490 #, no-wrap msgid "" " inspect-get-minor-version root\n" @@ -12937,24 +12908,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2597 ../src/guestfs-actions.pod:4081 +#: ../fish/guestfish-actions.pod:2492 ../src/guestfs-actions.pod:3877 msgid "This returns the minor version number of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2602 +#: ../fish/guestfish-actions.pod:2497 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-major-version>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2605 +#: ../fish/guestfish-actions.pod:2500 msgid "inspect-get-mountpoints" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2607 +#: ../fish/guestfish-actions.pod:2502 #, no-wrap msgid "" " inspect-get-mountpoints root\n" @@ -12962,7 +12933,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2609 ../src/guestfs-actions.pod:4099 +#: ../fish/guestfish-actions.pod:2504 ../src/guestfs-actions.pod:3895 msgid "" "This returns a hash of where we think the filesystems associated with this " "operating system should be mounted. Callers should note that this is at " @@ -12973,7 +12944,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2618 ../src/guestfs-actions.pod:4108 +#: ../fish/guestfish-actions.pod:2513 ../src/guestfs-actions.pod:3904 msgid "" "Each element in the returned hashtable has a key which is the path of the " "mountpoint (eg. C</boot>) and a value which is the filesystem that would be " @@ -12981,12 +12952,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2623 ../src/guestfs-actions.pod:4113 +#: ../fish/guestfish-actions.pod:2518 ../src/guestfs-actions.pod:3909 msgid "Non-mounted devices such as swap devices are I<not> returned in this list." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2626 +#: ../fish/guestfish-actions.pod:2521 msgid "" "For operating systems like Windows which still use drive letters, this call " "will only return an entry for the first drive \"mounted on\" C</>. For " @@ -12995,19 +12966,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2632 +#: ../fish/guestfish-actions.pod:2527 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2635 +#: ../fish/guestfish-actions.pod:2530 msgid "inspect-get-package-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2637 +#: ../fish/guestfish-actions.pod:2532 #, no-wrap msgid "" " inspect-get-package-format root\n" @@ -13015,7 +12986,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2639 +#: ../fish/guestfish-actions.pod:2534 msgid "" "This function and L</inspect-get-package-management> return the package " "format and package management tool used by the inspected operating system. " @@ -13024,7 +12995,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2645 ../src/guestfs-actions.pod:4145 +#: ../fish/guestfish-actions.pod:2540 ../src/guestfs-actions.pod:3941 msgid "" "This returns the string C<unknown> if we could not determine the package " "format I<or> if the operating system does not have a real packaging system " @@ -13032,19 +13003,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2649 ../src/guestfs-actions.pod:4149 +#: ../fish/guestfish-actions.pod:2544 ../src/guestfs-actions.pod:3945 msgid "" "Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>, " "C<pkgsrc>. Future versions of libguestfs may return other strings." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2655 +#: ../fish/guestfish-actions.pod:2550 msgid "inspect-get-package-management" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2657 +#: ../fish/guestfish-actions.pod:2552 #, no-wrap msgid "" " inspect-get-package-management root\n" @@ -13052,7 +13023,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2659 +#: ../fish/guestfish-actions.pod:2554 msgid "" "L</inspect-get-package-format> and this function return the package format " "and package management tool used by the inspected operating system. For " @@ -13061,7 +13032,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2665 ../src/guestfs-actions.pod:4172 +#: ../fish/guestfish-actions.pod:2560 ../src/guestfs-actions.pod:3968 msgid "" "This returns the string C<unknown> if we could not determine the package " "management tool I<or> if the operating system does not have a real packaging " @@ -13069,7 +13040,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2669 ../src/guestfs-actions.pod:4176 +#: ../fish/guestfish-actions.pod:2564 ../src/guestfs-actions.pod:3972 msgid "" "Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian " "derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>, C<zypper>. Future " @@ -13077,12 +13048,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2676 +#: ../fish/guestfish-actions.pod:2571 msgid "inspect-get-product-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2678 +#: ../fish/guestfish-actions.pod:2573 #, no-wrap msgid "" " inspect-get-product-name root\n" @@ -13090,7 +13061,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2680 ../src/guestfs-actions.pod:4194 +#: ../fish/guestfish-actions.pod:2575 ../src/guestfs-actions.pod:3990 msgid "" "This returns the product name of the inspected operating system. The " "product name is generally some freeform string which can be displayed to the " @@ -13098,19 +13069,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2685 ../src/guestfs-actions.pod:4199 +#: ../fish/guestfish-actions.pod:2580 ../src/guestfs-actions.pod:3995 msgid "" "If the product name could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2690 +#: ../fish/guestfish-actions.pod:2585 msgid "inspect-get-product-variant" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2692 +#: ../fish/guestfish-actions.pod:2587 #, no-wrap msgid "" " inspect-get-product-variant root\n" @@ -13118,12 +13089,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2694 ../src/guestfs-actions.pod:4215 +#: ../fish/guestfish-actions.pod:2589 ../src/guestfs-actions.pod:4011 msgid "This returns the product variant of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2697 ../src/guestfs-actions.pod:4218 +#: ../fish/guestfish-actions.pod:2592 ../src/guestfs-actions.pod:4014 msgid "" "For Windows guests, this returns the contents of the Registry key " "C<HKLM\\Software\\Microsoft\\Windows NT\\CurrentVersion> C<InstallationType> " @@ -13135,7 +13106,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2706 ../src/guestfs-actions.pod:4227 +#: ../fish/guestfish-actions.pod:2601 ../src/guestfs-actions.pod:4023 msgid "" "For enterprise Linux guests, in future we intend this to return the product " "variant such as C<Desktop>, C<Server> and so on. But this is not " @@ -13143,26 +13114,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2710 ../src/guestfs-actions.pod:4231 +#: ../fish/guestfish-actions.pod:2605 ../src/guestfs-actions.pod:4027 msgid "" "If the product variant could not be determined, then the string C<unknown> " "is returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2713 +#: ../fish/guestfish-actions.pod:2608 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-product-name>, L</inspect-get-major-version>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2717 +#: ../fish/guestfish-actions.pod:2612 msgid "inspect-get-roots" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2719 +#: ../fish/guestfish-actions.pod:2614 #, no-wrap msgid "" " inspect-get-roots\n" @@ -13170,7 +13141,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2721 +#: ../fish/guestfish-actions.pod:2616 msgid "" "This function is a convenient way to get the list of root devices, as " "returned from a previous call to L</inspect-os>, but without redoing the " @@ -13178,19 +13149,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2725 +#: ../fish/guestfish-actions.pod:2620 msgid "" "This returns an empty list if either no root devices were found or the " "caller has not called L</inspect-os>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2730 +#: ../fish/guestfish-actions.pod:2625 msgid "inspect-get-type" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2732 +#: ../fish/guestfish-actions.pod:2627 #, no-wrap msgid "" " inspect-get-type root\n" @@ -13198,79 +13169,79 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2734 ../src/guestfs-actions.pod:4269 +#: ../fish/guestfish-actions.pod:2629 ../src/guestfs-actions.pod:4065 msgid "" "This returns the type of the inspected operating system. Currently defined " "types are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2739 ../src/guestfs-actions.pod:4274 +#: ../fish/guestfish-actions.pod:2634 ../src/guestfs-actions.pod:4070 msgid "\"linux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2741 ../src/guestfs-actions.pod:4276 +#: ../fish/guestfish-actions.pod:2636 ../src/guestfs-actions.pod:4072 msgid "Any Linux-based operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2745 ../src/guestfs-actions.pod:4280 +#: ../fish/guestfish-actions.pod:2640 ../src/guestfs-actions.pod:4076 msgid "Any Microsoft Windows operating system." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2747 ../src/guestfs-actions.pod:4282 +#: ../fish/guestfish-actions.pod:2642 ../src/guestfs-actions.pod:4078 msgid "\"freebsd\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2749 ../src/guestfs-actions.pod:4284 +#: ../fish/guestfish-actions.pod:2644 ../src/guestfs-actions.pod:4080 msgid "FreeBSD." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2751 ../src/guestfs-actions.pod:4286 +#: ../fish/guestfish-actions.pod:2646 ../src/guestfs-actions.pod:4082 msgid "\"netbsd\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2753 ../src/guestfs-actions.pod:4288 +#: ../fish/guestfish-actions.pod:2648 ../src/guestfs-actions.pod:4084 msgid "NetBSD." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2755 ../src/guestfs-actions.pod:4290 +#: ../fish/guestfish-actions.pod:2650 ../src/guestfs-actions.pod:4086 msgid "\"hurd\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2757 ../src/guestfs-actions.pod:4292 +#: ../fish/guestfish-actions.pod:2652 ../src/guestfs-actions.pod:4088 msgid "GNU/Hurd." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2759 ../src/guestfs-actions.pod:4294 +#: ../fish/guestfish-actions.pod:2654 ../src/guestfs-actions.pod:4090 msgid "\"dos\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2761 ../src/guestfs-actions.pod:4296 +#: ../fish/guestfish-actions.pod:2656 ../src/guestfs-actions.pod:4092 msgid "MS-DOS, FreeDOS and others." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2765 ../src/guestfs-actions.pod:4300 +#: ../fish/guestfish-actions.pod:2660 ../src/guestfs-actions.pod:4096 msgid "The operating system type could not be determined." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2774 +#: ../fish/guestfish-actions.pod:2669 msgid "inspect-get-windows-current-control-set" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2776 +#: ../fish/guestfish-actions.pod:2671 #, no-wrap msgid "" " inspect-get-windows-current-control-set root\n" @@ -13278,26 +13249,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2778 ../src/guestfs-actions.pod:4320 +#: ../fish/guestfish-actions.pod:2673 ../src/guestfs-actions.pod:4116 msgid "" "This returns the Windows CurrentControlSet of the inspected guest. The " "CurrentControlSet is a registry key name such as C<ControlSet001>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2781 ../src/guestfs-actions.pod:4323 +#: ../fish/guestfish-actions.pod:2676 ../src/guestfs-actions.pod:4119 msgid "" "This call assumes that the guest is Windows and that the Registry could be " "examined by inspection. If this is not the case then an error is returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2787 +#: ../fish/guestfish-actions.pod:2682 msgid "inspect-get-windows-systemroot" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2789 +#: ../fish/guestfish-actions.pod:2684 #, no-wrap msgid "" " inspect-get-windows-systemroot root\n" @@ -13305,14 +13276,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2791 ../src/guestfs-actions.pod:4340 +#: ../fish/guestfish-actions.pod:2686 ../src/guestfs-actions.pod:4136 msgid "" "This returns the Windows systemroot of the inspected guest. The systemroot " "is a directory path such as C</WINDOWS>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2794 ../src/guestfs-actions.pod:4343 +#: ../fish/guestfish-actions.pod:2689 ../src/guestfs-actions.pod:4139 msgid "" "This call assumes that the guest is Windows and that the systemroot could be " "determined by inspection. If this is not the case then an error is " @@ -13320,12 +13291,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2800 +#: ../fish/guestfish-actions.pod:2695 msgid "inspect-is-live" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2802 +#: ../fish/guestfish-actions.pod:2697 #, no-wrap msgid "" " inspect-is-live root\n" @@ -13333,19 +13304,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2804 +#: ../fish/guestfish-actions.pod:2699 msgid "" "If L</inspect-get-format> returns C<installer> (this is an install disk), " "then this returns true if a live image was detected on the disk." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2810 +#: ../fish/guestfish-actions.pod:2705 msgid "inspect-is-multipart" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2812 +#: ../fish/guestfish-actions.pod:2707 #, no-wrap msgid "" " inspect-is-multipart root\n" @@ -13353,19 +13324,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2814 +#: ../fish/guestfish-actions.pod:2709 msgid "" "If L</inspect-get-format> returns C<installer> (this is an install disk), " "then this returns true if the disk is part of a set." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2820 +#: ../fish/guestfish-actions.pod:2715 msgid "inspect-is-netinst" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2822 +#: ../fish/guestfish-actions.pod:2717 #, no-wrap msgid "" " inspect-is-netinst root\n" @@ -13373,7 +13344,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2824 +#: ../fish/guestfish-actions.pod:2719 msgid "" "If L</inspect-get-format> returns C<installer> (this is an install disk), " "then this returns true if the disk is a network installer, ie. not a " @@ -13382,12 +13353,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2832 +#: ../fish/guestfish-actions.pod:2727 msgid "inspect-list-applications" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2834 +#: ../fish/guestfish-actions.pod:2729 #, no-wrap msgid "" " inspect-list-applications root\n" @@ -13395,12 +13366,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2836 ../src/guestfs-actions.pod:4410 +#: ../fish/guestfish-actions.pod:2731 ../src/guestfs-actions.pod:4206 msgid "Return the list of applications installed in the operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2838 +#: ../fish/guestfish-actions.pod:2733 msgid "" "I<Note:> This call works differently from other parts of the inspection " "API. You have to call L</inspect-os>, then L</inspect-get-mountpoints>, " @@ -13412,91 +13383,91 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2848 ../src/guestfs-actions.pod:4422 +#: ../fish/guestfish-actions.pod:2743 ../src/guestfs-actions.pod:4218 msgid "" "This returns an empty list if the inspection code was not able to determine " "the list of applications." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2851 ../src/guestfs-actions.pod:4425 +#: ../fish/guestfish-actions.pod:2746 ../src/guestfs-actions.pod:4221 msgid "The application structure contains the following fields:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2855 ../src/guestfs-actions.pod:4429 +#: ../fish/guestfish-actions.pod:2750 ../src/guestfs-actions.pod:4225 msgid "C<app_name>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2857 ../src/guestfs-actions.pod:4431 +#: ../fish/guestfish-actions.pod:2752 ../src/guestfs-actions.pod:4227 msgid "" "The name of the application. For Red Hat-derived and Debian-derived Linux " "guests, this is the package name." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2860 ../src/guestfs-actions.pod:4434 +#: ../fish/guestfish-actions.pod:2755 ../src/guestfs-actions.pod:4230 msgid "C<app_display_name>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2862 ../src/guestfs-actions.pod:4436 +#: ../fish/guestfish-actions.pod:2757 ../src/guestfs-actions.pod:4232 msgid "" "The display name of the application, sometimes localized to the install " "language of the guest operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2865 ../src/guestfs-actions.pod:4439 +#: ../fish/guestfish-actions.pod:2760 ../src/guestfs-actions.pod:4235 msgid "" "If unavailable this is returned as an empty string C<\"\">. Callers needing " "to display something can use C<app_name> instead." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2868 ../src/guestfs-actions.pod:4442 +#: ../fish/guestfish-actions.pod:2763 ../src/guestfs-actions.pod:4238 msgid "C<app_epoch>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2870 ../src/guestfs-actions.pod:4444 +#: ../fish/guestfish-actions.pod:2765 ../src/guestfs-actions.pod:4240 msgid "" "For package managers which use epochs, this contains the epoch of the " "package (an integer). If unavailable, this is returned as C<0>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2873 ../src/guestfs-actions.pod:4447 +#: ../fish/guestfish-actions.pod:2768 ../src/guestfs-actions.pod:4243 msgid "C<app_version>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2875 ../src/guestfs-actions.pod:4449 +#: ../fish/guestfish-actions.pod:2770 ../src/guestfs-actions.pod:4245 msgid "" "The version string of the application or package. If unavailable this is " "returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2878 ../src/guestfs-actions.pod:4452 +#: ../fish/guestfish-actions.pod:2773 ../src/guestfs-actions.pod:4248 msgid "C<app_release>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2880 ../src/guestfs-actions.pod:4454 +#: ../fish/guestfish-actions.pod:2775 ../src/guestfs-actions.pod:4250 msgid "" "The release string of the application or package, for package managers that " "use this. If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2884 ../src/guestfs-actions.pod:4458 +#: ../fish/guestfish-actions.pod:2779 ../src/guestfs-actions.pod:4254 msgid "C<app_install_path>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2886 ../src/guestfs-actions.pod:4460 +#: ../fish/guestfish-actions.pod:2781 ../src/guestfs-actions.pod:4256 msgid "" "The installation path of the application (on operating systems such as " "Windows which use installation paths). This path is in the format used by " @@ -13504,89 +13475,89 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2891 ../src/guestfs-actions.pod:4465 +#: ../fish/guestfish-actions.pod:2786 ../src/guestfs-actions.pod:4261 msgid "If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2893 ../src/guestfs-actions.pod:4467 +#: ../fish/guestfish-actions.pod:2788 ../src/guestfs-actions.pod:4263 msgid "C<app_trans_path>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2895 ../src/guestfs-actions.pod:4469 +#: ../fish/guestfish-actions.pod:2790 ../src/guestfs-actions.pod:4265 msgid "" "The install path translated into a libguestfs path. If unavailable this is " "returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2898 ../src/guestfs-actions.pod:4472 +#: ../fish/guestfish-actions.pod:2793 ../src/guestfs-actions.pod:4268 msgid "C<app_publisher>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2900 ../src/guestfs-actions.pod:4474 +#: ../fish/guestfish-actions.pod:2795 ../src/guestfs-actions.pod:4270 msgid "" "The name of the publisher of the application, for package managers that use " "this. If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2904 ../src/guestfs-actions.pod:4478 +#: ../fish/guestfish-actions.pod:2799 ../src/guestfs-actions.pod:4274 msgid "C<app_url>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2906 ../src/guestfs-actions.pod:4480 +#: ../fish/guestfish-actions.pod:2801 ../src/guestfs-actions.pod:4276 msgid "" "The URL (eg. upstream URL) of the application. If unavailable this is " "returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2909 ../src/guestfs-actions.pod:4483 +#: ../fish/guestfish-actions.pod:2804 ../src/guestfs-actions.pod:4279 msgid "C<app_source_package>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2911 ../src/guestfs-actions.pod:4485 +#: ../fish/guestfish-actions.pod:2806 ../src/guestfs-actions.pod:4281 msgid "" "For packaging systems which support this, the name of the source package. " "If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2914 ../src/guestfs-actions.pod:4488 +#: ../fish/guestfish-actions.pod:2809 ../src/guestfs-actions.pod:4284 msgid "C<app_summary>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2916 ../src/guestfs-actions.pod:4490 +#: ../fish/guestfish-actions.pod:2811 ../src/guestfs-actions.pod:4286 msgid "" "A short (usually one line) description of the application or package. If " "unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2919 ../src/guestfs-actions.pod:4493 +#: ../fish/guestfish-actions.pod:2814 ../src/guestfs-actions.pod:4289 msgid "C<app_description>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2921 ../src/guestfs-actions.pod:4495 +#: ../fish/guestfish-actions.pod:2816 ../src/guestfs-actions.pod:4291 msgid "" "A longer description of the application or package. If unavailable this is " "returned as an empty string C<\"\">." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2928 +#: ../fish/guestfish-actions.pod:2823 msgid "inspect-os" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2930 +#: ../fish/guestfish-actions.pod:2825 #, no-wrap msgid "" " inspect-os\n" @@ -13594,7 +13565,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2932 ../src/guestfs-actions.pod:4513 +#: ../fish/guestfish-actions.pod:2827 ../src/guestfs-actions.pod:4309 msgid "" "This function uses other libguestfs functions and certain heuristics to " "inspect the disk(s) (usually disks belonging to a virtual machine), looking " @@ -13602,12 +13573,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2936 ../src/guestfs-actions.pod:4517 +#: ../fish/guestfish-actions.pod:2831 ../src/guestfs-actions.pod:4313 msgid "The list returned is empty if no operating systems were found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2938 ../src/guestfs-actions.pod:4519 +#: ../fish/guestfish-actions.pod:2833 ../src/guestfs-actions.pod:4315 msgid "" "If one operating system was found, then this returns a list with a single " "element, which is the name of the root filesystem of this operating system. " @@ -13617,7 +13588,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2945 +#: ../fish/guestfish-actions.pod:2840 msgid "" "You can pass the root string(s) returned to other L</inspect-get-*> " "functions in order to query further information about each operating system, " @@ -13625,7 +13596,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2950 +#: ../fish/guestfish-actions.pod:2845 msgid "" "This function uses other libguestfs features such as L</mount-ro> and " "L</umount-all> in order to mount and unmount filesystems and look at the " @@ -13634,24 +13605,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2956 ../src/guestfs-actions.pod:4537 +#: ../fish/guestfish-actions.pod:2851 ../src/guestfs-actions.pod:4333 msgid "" "This function cannot decrypt encrypted disks. The caller must do that first " "(supplying the necessary keys) if the disk is encrypted." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2962 ../fish/guestfish-actions.pod:3185 ../fish/guestfish-actions.pod:3250 +#: ../fish/guestfish-actions.pod:2857 ../fish/guestfish-actions.pod:3080 ../fish/guestfish-actions.pod:3145 msgid "See also L</list-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2964 +#: ../fish/guestfish-actions.pod:2859 msgid "is-blockdev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2966 +#: ../fish/guestfish-actions.pod:2861 #, no-wrap msgid "" " is-blockdev path\n" @@ -13659,24 +13630,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2968 ../src/guestfs-actions.pod:4557 +#: ../fish/guestfish-actions.pod:2863 ../src/guestfs-actions.pod:4353 msgid "" "This returns C<true> if and only if there is a block device with the given " "C<path> name." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2971 ../fish/guestfish-actions.pod:2980 ../fish/guestfish-actions.pod:2999 ../fish/guestfish-actions.pod:3008 ../fish/guestfish-actions.pod:3018 ../fish/guestfish-actions.pod:3052 ../fish/guestfish-actions.pod:3061 +#: ../fish/guestfish-actions.pod:2866 ../fish/guestfish-actions.pod:2875 ../fish/guestfish-actions.pod:2894 ../fish/guestfish-actions.pod:2903 ../fish/guestfish-actions.pod:2913 ../fish/guestfish-actions.pod:2947 ../fish/guestfish-actions.pod:2956 msgid "See also L</stat>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2973 +#: ../fish/guestfish-actions.pod:2868 msgid "is-chardev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2975 +#: ../fish/guestfish-actions.pod:2870 #, no-wrap msgid "" " is-chardev path\n" @@ -13684,19 +13655,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2977 ../src/guestfs-actions.pod:4572 +#: ../fish/guestfish-actions.pod:2872 ../src/guestfs-actions.pod:4368 msgid "" "This returns C<true> if and only if there is a character device with the " "given C<path> name." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2982 +#: ../fish/guestfish-actions.pod:2877 msgid "is-config" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2984 +#: ../fish/guestfish-actions.pod:2879 #, no-wrap msgid "" " is-config\n" @@ -13704,19 +13675,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2986 ../src/guestfs-actions.pod:4586 +#: ../fish/guestfish-actions.pod:2881 ../src/guestfs-actions.pod:4382 msgid "" "This returns true iff this handle is being configured (in the C<CONFIG> " "state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2991 +#: ../fish/guestfish-actions.pod:2886 msgid "is-dir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2993 +#: ../fish/guestfish-actions.pod:2888 #, no-wrap msgid "" " is-dir path\n" @@ -13724,19 +13695,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2995 ../src/guestfs-actions.pod:4601 +#: ../fish/guestfish-actions.pod:2890 ../src/guestfs-actions.pod:4397 msgid "" "This returns C<true> if and only if there is a directory with the given " "C<path> name. Note that it returns false for other objects like files." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3001 +#: ../fish/guestfish-actions.pod:2896 msgid "is-fifo" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3003 +#: ../fish/guestfish-actions.pod:2898 #, no-wrap msgid "" " is-fifo path\n" @@ -13744,19 +13715,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3005 ../src/guestfs-actions.pod:4617 +#: ../fish/guestfish-actions.pod:2900 ../src/guestfs-actions.pod:4413 msgid "" "This returns C<true> if and only if there is a FIFO (named pipe) with the " "given C<path> name." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3010 +#: ../fish/guestfish-actions.pod:2905 msgid "is-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3012 +#: ../fish/guestfish-actions.pod:2907 #, no-wrap msgid "" " is-file path\n" @@ -13764,7 +13735,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3014 ../src/guestfs-actions.pod:4632 +#: ../fish/guestfish-actions.pod:2909 ../src/guestfs-actions.pod:4428 msgid "" "This returns C<true> if and only if there is a regular file with the given " "C<path> name. Note that it returns false for other objects like " @@ -13772,12 +13743,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3020 +#: ../fish/guestfish-actions.pod:2915 msgid "is-launching" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3022 +#: ../fish/guestfish-actions.pod:2917 #, no-wrap msgid "" " is-launching\n" @@ -13785,19 +13756,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3024 ../src/guestfs-actions.pod:4647 +#: ../fish/guestfish-actions.pod:2919 ../src/guestfs-actions.pod:4443 msgid "" "This returns true iff this handle is launching the subprocess (in the " "C<LAUNCHING> state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3029 +#: ../fish/guestfish-actions.pod:2924 msgid "is-lv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3031 +#: ../fish/guestfish-actions.pod:2926 #, no-wrap msgid "" " is-lv device\n" @@ -13805,19 +13776,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3033 ../src/guestfs-actions.pod:4662 +#: ../fish/guestfish-actions.pod:2928 ../src/guestfs-actions.pod:4458 msgid "" "This command tests whether C<device> is a logical volume, and returns true " "iff this is the case." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3036 +#: ../fish/guestfish-actions.pod:2931 msgid "is-ready" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3038 +#: ../fish/guestfish-actions.pod:2933 #, no-wrap msgid "" " is-ready\n" @@ -13825,19 +13796,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3040 ../src/guestfs-actions.pod:4674 +#: ../fish/guestfish-actions.pod:2935 ../src/guestfs-actions.pod:4470 msgid "" "This returns true iff this handle is ready to accept commands (in the " "C<READY> state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3045 +#: ../fish/guestfish-actions.pod:2940 msgid "is-socket" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3047 +#: ../fish/guestfish-actions.pod:2942 #, no-wrap msgid "" " is-socket path\n" @@ -13845,19 +13816,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3049 ../src/guestfs-actions.pod:4689 +#: ../fish/guestfish-actions.pod:2944 ../src/guestfs-actions.pod:4485 msgid "" "This returns C<true> if and only if there is a Unix domain socket with the " "given C<path> name." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3054 +#: ../fish/guestfish-actions.pod:2949 msgid "is-symlink" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3056 +#: ../fish/guestfish-actions.pod:2951 #, no-wrap msgid "" " is-symlink path\n" @@ -13865,19 +13836,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3058 ../src/guestfs-actions.pod:4704 +#: ../fish/guestfish-actions.pod:2953 ../src/guestfs-actions.pod:4500 msgid "" "This returns C<true> if and only if there is a symbolic link with the given " "C<path> name." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3063 +#: ../fish/guestfish-actions.pod:2958 msgid "is-zero" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3065 +#: ../fish/guestfish-actions.pod:2960 #, no-wrap msgid "" " is-zero path\n" @@ -13885,19 +13856,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3067 ../src/guestfs-actions.pod:4719 +#: ../fish/guestfish-actions.pod:2962 ../src/guestfs-actions.pod:4515 msgid "" "This returns true iff the file exists and the file is empty or it contains " "all zero bytes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3070 +#: ../fish/guestfish-actions.pod:2965 msgid "is-zero-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3072 +#: ../fish/guestfish-actions.pod:2967 #, no-wrap msgid "" " is-zero-device device\n" @@ -13905,22 +13876,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3074 ../src/guestfs-actions.pod:4732 +#: ../fish/guestfish-actions.pod:2969 ../src/guestfs-actions.pod:4528 msgid "This returns true iff the device exists and contains all zero bytes." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3076 ../src/guestfs-actions.pod:4734 +#: ../fish/guestfish-actions.pod:2971 ../src/guestfs-actions.pod:4530 msgid "Note that for large devices this can take a long time to run." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3078 +#: ../fish/guestfish-actions.pod:2973 msgid "isoinfo" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3080 +#: ../fish/guestfish-actions.pod:2975 #, no-wrap msgid "" " isoinfo isofile\n" @@ -13928,7 +13899,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3082 +#: ../fish/guestfish-actions.pod:2977 msgid "" "This is the same as L</isoinfo-device> except that it works for an ISO file " "located inside some other mounted filesystem. Note that in the common case " @@ -13937,12 +13908,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3088 +#: ../fish/guestfish-actions.pod:2983 msgid "isoinfo-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3090 +#: ../fish/guestfish-actions.pod:2985 #, no-wrap msgid "" " isoinfo-device device\n" @@ -13950,7 +13921,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3092 ../src/guestfs-actions.pod:4764 +#: ../fish/guestfish-actions.pod:2987 ../src/guestfs-actions.pod:4560 msgid "" "C<device> is an ISO device. This returns a struct of information read from " "the primary volume descriptor (the ISO equivalent of the superblock) of the " @@ -13958,7 +13929,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3096 ../src/guestfs-actions.pod:4768 +#: ../fish/guestfish-actions.pod:2991 ../src/guestfs-actions.pod:4564 msgid "" "Usually it is more efficient to use the L<isoinfo(1)> command with the I<-d> " "option on the host to analyze ISO files, instead of going through " @@ -13966,19 +13937,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3100 ../src/guestfs-actions.pod:4772 +#: ../fish/guestfish-actions.pod:2995 ../src/guestfs-actions.pod:4568 msgid "" "For information on the primary volume descriptor fields, see " "L<http://wiki.osdev.org/ISO_9660#The_Primary_Volume_Descriptor>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3103 +#: ../fish/guestfish-actions.pod:2998 msgid "kill-subprocess" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3105 +#: ../fish/guestfish-actions.pod:3000 #, no-wrap msgid "" " kill-subprocess\n" @@ -13986,34 +13957,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3107 ../src/guestfs-actions.pod:4793 +#: ../fish/guestfish-actions.pod:3002 ../src/guestfs-actions.pod:4589 msgid "This kills the qemu subprocess." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3109 +#: ../fish/guestfish-actions.pod:3004 msgid "Do not call this. See: L</shutdown> instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3111 +#: ../fish/guestfish-actions.pod:3006 msgid "" "I<This function is deprecated.> In new code, use the L</shutdown> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3118 +#: ../fish/guestfish-actions.pod:3013 msgid "launch" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3120 +#: ../fish/guestfish-actions.pod:3015 msgid "run" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3122 +#: ../fish/guestfish-actions.pod:3017 #, no-wrap msgid "" " launch\n" @@ -14021,26 +13992,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3124 ../src/guestfs-actions.pod:4806 +#: ../fish/guestfish-actions.pod:3019 ../src/guestfs-actions.pod:4602 msgid "" "Internally libguestfs is implemented by running a virtual machine using " "L<qemu(1)>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3127 ../src/guestfs-actions.pod:4809 +#: ../fish/guestfish-actions.pod:3022 ../src/guestfs-actions.pod:4605 msgid "" "You should call this after configuring the handle (eg. adding drives) but " "before performing any actions." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3130 +#: ../fish/guestfish-actions.pod:3025 msgid "lchown" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3132 +#: ../fish/guestfish-actions.pod:3027 #, no-wrap msgid "" " lchown owner group path\n" @@ -14048,7 +14019,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3134 +#: ../fish/guestfish-actions.pod:3029 msgid "" "Change the file owner to C<owner> and group to C<group>. This is like " "L</chown> but if C<path> is a symlink then the link itself is changed, not " @@ -14056,12 +14027,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3142 +#: ../fish/guestfish-actions.pod:3037 msgid "lgetxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3144 +#: ../fish/guestfish-actions.pod:3039 #, no-wrap msgid "" " lgetxattr path name\n" @@ -14069,24 +14040,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3146 ../src/guestfs-actions.pod:4849 +#: ../fish/guestfish-actions.pod:3041 ../src/guestfs-actions.pod:4645 msgid "" "Get a single extended attribute from file C<path> named C<name>. If C<path> " "is a symlink, then this call returns an extended attribute from the symlink." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3160 +#: ../fish/guestfish-actions.pod:3055 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3162 +#: ../fish/guestfish-actions.pod:3057 msgid "lgetxattrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3164 +#: ../fish/guestfish-actions.pod:3059 #, no-wrap msgid "" " lgetxattrs path\n" @@ -14094,19 +14065,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3166 +#: ../fish/guestfish-actions.pod:3061 msgid "" "This is the same as L</getxattrs>, but if C<path> is a symbolic link, then " "it returns the extended attributes of the link itself." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3170 +#: ../fish/guestfish-actions.pod:3065 msgid "list-9p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3172 +#: ../fish/guestfish-actions.pod:3067 #, no-wrap msgid "" " list-9p\n" @@ -14114,19 +14085,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3174 ../src/guestfs-actions.pod:4892 +#: ../fish/guestfish-actions.pod:3069 ../src/guestfs-actions.pod:4688 msgid "" "List all 9p filesystems attached to the guest. A list of mount tags is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3177 +#: ../fish/guestfish-actions.pod:3072 msgid "list-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3179 +#: ../fish/guestfish-actions.pod:3074 #, no-wrap msgid "" " list-devices\n" @@ -14134,22 +14105,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3181 ../src/guestfs-actions.pod:4906 +#: ../fish/guestfish-actions.pod:3076 ../src/guestfs-actions.pod:4702 msgid "List all the block devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3183 ../src/guestfs-actions.pod:4908 +#: ../fish/guestfish-actions.pod:3078 ../src/guestfs-actions.pod:4704 msgid "The full block device names are returned, eg. C</dev/sda>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3187 +#: ../fish/guestfish-actions.pod:3082 msgid "list-dm-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3189 +#: ../fish/guestfish-actions.pod:3084 #, no-wrap msgid "" " list-dm-devices\n" @@ -14157,31 +14128,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3191 ../src/guestfs-actions.pod:4923 +#: ../fish/guestfish-actions.pod:3086 ../src/guestfs-actions.pod:4719 msgid "List all device mapper devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3193 +#: ../fish/guestfish-actions.pod:3088 msgid "" "The returned list contains C</dev/mapper/*> devices, eg. ones created by a " "previous call to L</luks-open>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3196 +#: ../fish/guestfish-actions.pod:3091 msgid "" "Device mapper devices which correspond to logical volumes are I<not> " "returned in this list. Call L</lvs> if you want to list logical volumes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3200 +#: ../fish/guestfish-actions.pod:3095 msgid "list-filesystems" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3202 +#: ../fish/guestfish-actions.pod:3097 #, no-wrap msgid "" " list-filesystems\n" @@ -14189,7 +14160,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3204 ../src/guestfs-actions.pod:4943 +#: ../fish/guestfish-actions.pod:3099 ../src/guestfs-actions.pod:4739 msgid "" "This inspection command looks for filesystems on partitions, block devices " "and logical volumes, returning a list of devices containing filesystems and " @@ -14197,14 +14168,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3208 ../src/guestfs-actions.pod:4947 +#: ../fish/guestfish-actions.pod:3103 ../src/guestfs-actions.pod:4743 msgid "" "The return value is a hash, where the keys are the devices containing " "filesystems, and the values are the filesystem types. For example:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3212 ../src/guestfs-actions.pod:4951 +#: ../fish/guestfish-actions.pod:3107 ../src/guestfs-actions.pod:4747 #, no-wrap msgid "" " \"/dev/sda1\" => \"ntfs\"\n" @@ -14215,14 +14186,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3217 ../src/guestfs-actions.pod:4956 +#: ../fish/guestfish-actions.pod:3112 ../src/guestfs-actions.pod:4752 msgid "" "The value can have the special value \"unknown\", meaning the content of the " "device is undetermined or empty. \"swap\" means a Linux swap partition." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3221 +#: ../fish/guestfish-actions.pod:3116 msgid "" "This command runs other libguestfs commands, which might include L</mount> " "and L</umount>, and therefore you should use this soon after launch and only " @@ -14230,7 +14201,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3225 +#: ../fish/guestfish-actions.pod:3120 msgid "" "Not all of the filesystems returned will be mountable. In particular, swap " "partitions are returned in the list. Also this command does not check that " @@ -14240,12 +14211,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3233 +#: ../fish/guestfish-actions.pod:3128 msgid "list-md-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3235 +#: ../fish/guestfish-actions.pod:3130 #, no-wrap msgid "" " list-md-devices\n" @@ -14253,17 +14224,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3237 ../src/guestfs-actions.pod:4985 +#: ../fish/guestfish-actions.pod:3132 ../src/guestfs-actions.pod:4781 msgid "List all Linux md devices." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3239 +#: ../fish/guestfish-actions.pod:3134 msgid "list-partitions" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3241 +#: ../fish/guestfish-actions.pod:3136 #, no-wrap msgid "" " list-partitions\n" @@ -14271,29 +14242,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3243 ../src/guestfs-actions.pod:4998 +#: ../fish/guestfish-actions.pod:3138 ../src/guestfs-actions.pod:4794 msgid "List all the partitions detected on all block devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3245 ../src/guestfs-actions.pod:5000 +#: ../fish/guestfish-actions.pod:3140 ../src/guestfs-actions.pod:4796 msgid "The full partition device names are returned, eg. C</dev/sda1>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3247 +#: ../fish/guestfish-actions.pod:3142 msgid "" "This does not return logical volumes. For that you will need to call " "L</lvs>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3252 +#: ../fish/guestfish-actions.pod:3147 msgid "ll" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3254 +#: ../fish/guestfish-actions.pod:3149 #, no-wrap msgid "" " ll directory\n" @@ -14301,26 +14272,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3256 ../src/guestfs-actions.pod:5019 +#: ../fish/guestfish-actions.pod:3151 ../src/guestfs-actions.pod:4815 msgid "" "List the files in C<directory> (relative to the root directory, there is no " "cwd) in the format of 'ls -la'." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3259 ../fish/guestfish-actions.pod:3268 ../src/guestfs-actions.pod:5022 ../src/guestfs-actions.pod:5038 +#: ../fish/guestfish-actions.pod:3154 ../fish/guestfish-actions.pod:3163 ../src/guestfs-actions.pod:4818 ../src/guestfs-actions.pod:4834 msgid "" "This command is mostly useful for interactive sessions. It is I<not> " "intended that you try to parse the output string." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3262 +#: ../fish/guestfish-actions.pod:3157 msgid "llz" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3264 +#: ../fish/guestfish-actions.pod:3159 #, no-wrap msgid "" " llz directory\n" @@ -14328,17 +14299,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3266 ../src/guestfs-actions.pod:5036 +#: ../fish/guestfish-actions.pod:3161 ../src/guestfs-actions.pod:4832 msgid "List the files in C<directory> in the format of 'ls -laZ'." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3271 +#: ../fish/guestfish-actions.pod:3166 msgid "ln" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3273 +#: ../fish/guestfish-actions.pod:3168 #, no-wrap msgid "" " ln target linkname\n" @@ -14346,17 +14317,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3275 ../src/guestfs-actions.pod:5053 +#: ../fish/guestfish-actions.pod:3170 ../src/guestfs-actions.pod:4849 msgid "This command creates a hard link using the C<ln> command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3277 +#: ../fish/guestfish-actions.pod:3172 msgid "ln-f" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3279 +#: ../fish/guestfish-actions.pod:3174 #, no-wrap msgid "" " ln-f target linkname\n" @@ -14364,19 +14335,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3281 ../src/guestfs-actions.pod:5066 +#: ../fish/guestfish-actions.pod:3176 ../src/guestfs-actions.pod:4862 msgid "" "This command creates a hard link using the C<ln -f> command. The I<-f> " "option removes the link (C<linkname>) if it exists already." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3284 +#: ../fish/guestfish-actions.pod:3179 msgid "ln-s" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3286 +#: ../fish/guestfish-actions.pod:3181 #, no-wrap msgid "" " ln-s target linkname\n" @@ -14384,17 +14355,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3288 ../src/guestfs-actions.pod:5080 +#: ../fish/guestfish-actions.pod:3183 ../src/guestfs-actions.pod:4876 msgid "This command creates a symbolic link using the C<ln -s> command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3290 +#: ../fish/guestfish-actions.pod:3185 msgid "ln-sf" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3292 +#: ../fish/guestfish-actions.pod:3187 #, no-wrap msgid "" " ln-sf target linkname\n" @@ -14402,19 +14373,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3294 ../src/guestfs-actions.pod:5093 +#: ../fish/guestfish-actions.pod:3189 ../src/guestfs-actions.pod:4889 msgid "" "This command creates a symbolic link using the C<ln -sf> command, The I<-f> " "option removes the link (C<linkname>) if it exists already." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3297 +#: ../fish/guestfish-actions.pod:3192 msgid "lremovexattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3299 +#: ../fish/guestfish-actions.pod:3194 #, no-wrap msgid "" " lremovexattr xattr path\n" @@ -14422,19 +14393,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3301 +#: ../fish/guestfish-actions.pod:3196 msgid "" "This is the same as L</removexattr>, but if C<path> is a symbolic link, then " "it removes an extended attribute of the link itself." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3305 +#: ../fish/guestfish-actions.pod:3200 msgid "ls" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3307 +#: ../fish/guestfish-actions.pod:3202 #, no-wrap msgid "" " ls directory\n" @@ -14442,7 +14413,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3309 ../src/guestfs-actions.pod:5121 +#: ../fish/guestfish-actions.pod:3204 ../src/guestfs-actions.pod:4917 msgid "" "List the files in C<directory> (relative to the root directory, there is no " "cwd). The '.' and '..' entries are not returned, but hidden files are " @@ -14450,19 +14421,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3313 +#: ../fish/guestfish-actions.pod:3208 msgid "" "This command is mostly useful for interactive sessions. Programs should " "probably use L</readdir> instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3316 +#: ../fish/guestfish-actions.pod:3211 msgid "lsetxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3318 +#: ../fish/guestfish-actions.pod:3213 #, no-wrap msgid "" " lsetxattr xattr val vallen path\n" @@ -14470,19 +14441,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3320 +#: ../fish/guestfish-actions.pod:3215 msgid "" "This is the same as L</setxattr>, but if C<path> is a symbolic link, then it " "sets an extended attribute of the link itself." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3324 +#: ../fish/guestfish-actions.pod:3219 msgid "lstat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3326 +#: ../fish/guestfish-actions.pod:3221 #, no-wrap msgid "" " lstat path\n" @@ -14490,29 +14461,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3328 ../fish/guestfish-actions.pod:5519 ../src/guestfs-actions.pod:5157 ../src/guestfs-actions.pod:8642 +#: ../fish/guestfish-actions.pod:3223 ../fish/guestfish-actions.pod:5384 ../src/guestfs-actions.pod:4953 ../src/guestfs-actions.pod:8386 msgid "Returns file information for the given C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3330 +#: ../fish/guestfish-actions.pod:3225 msgid "" "This is the same as L</stat> except that if C<path> is a symbolic link, then " "the link is stat-ed, not the file it refers to." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3334 ../src/guestfs-actions.pod:5163 +#: ../fish/guestfish-actions.pod:3229 ../src/guestfs-actions.pod:4959 msgid "This is the same as the C<lstat(2)> system call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3336 +#: ../fish/guestfish-actions.pod:3231 msgid "lstatlist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3338 +#: ../fish/guestfish-actions.pod:3233 #, no-wrap msgid "" " lstatlist path 'names ...'\n" @@ -14520,7 +14491,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3340 +#: ../fish/guestfish-actions.pod:3235 msgid "" "This call allows you to perform the L</lstat> operation on multiple files, " "where all files are in the directory C<path>. C<names> is the list of files " @@ -14528,7 +14499,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3344 ../src/guestfs-actions.pod:5182 +#: ../fish/guestfish-actions.pod:3239 ../src/guestfs-actions.pod:4978 msgid "" "On return you get a list of stat structs, with a one-to-one correspondence " "to the C<names> list. If any name did not exist or could not be lstat'd, " @@ -14536,7 +14507,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3349 +#: ../fish/guestfish-actions.pod:3244 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. See also L</lxattrlist> for a " @@ -14547,12 +14518,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3357 +#: ../fish/guestfish-actions.pod:3252 msgid "luks-add-key" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3359 +#: ../fish/guestfish-actions.pod:3254 #, no-wrap msgid "" " luks-add-key device keyslot\n" @@ -14560,7 +14531,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3361 ../src/guestfs-actions.pod:5210 +#: ../fish/guestfish-actions.pod:3256 ../src/guestfs-actions.pod:5006 msgid "" "This command adds a new key on LUKS device C<device>. C<key> is any " "existing key, and is used to access the device. C<newkey> is the new key to " @@ -14568,26 +14539,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3366 +#: ../fish/guestfish-actions.pod:3261 msgid "" "Note that if C<keyslot> already contains a key, then this command will " "fail. You have to use L</luks-kill-slot> first to remove that key." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3370 ../fish/guestfish-actions.pod:3392 ../fish/guestfish-actions.pod:3402 ../fish/guestfish-actions.pod:3413 ../fish/guestfish-actions.pod:3439 ../fish/guestfish-actions.pod:3449 +#: ../fish/guestfish-actions.pod:3265 ../fish/guestfish-actions.pod:3287 ../fish/guestfish-actions.pod:3297 ../fish/guestfish-actions.pod:3308 ../fish/guestfish-actions.pod:3334 ../fish/guestfish-actions.pod:3344 msgid "" "This command has one or more key or passphrase parameters. Guestfish will " "prompt for these separately." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3373 +#: ../fish/guestfish-actions.pod:3268 msgid "luks-close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3375 +#: ../fish/guestfish-actions.pod:3270 #, no-wrap msgid "" " luks-close device\n" @@ -14595,7 +14566,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3377 +#: ../fish/guestfish-actions.pod:3272 msgid "" "This closes a LUKS device that was created earlier by L</luks-open> or " "L</luks-open-ro>. The C<device> parameter must be the name of the LUKS " @@ -14604,12 +14575,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3383 +#: ../fish/guestfish-actions.pod:3278 msgid "luks-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3385 +#: ../fish/guestfish-actions.pod:3280 #, no-wrap msgid "" " luks-format device keyslot\n" @@ -14617,7 +14588,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3387 ../src/guestfs-actions.pod:5251 +#: ../fish/guestfish-actions.pod:3282 ../src/guestfs-actions.pod:5047 msgid "" "This command erases existing data on C<device> and formats the device as a " "LUKS encrypted device. C<key> is the initial key, which is added to key " @@ -14625,12 +14596,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3395 +#: ../fish/guestfish-actions.pod:3290 msgid "luks-format-cipher" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3397 +#: ../fish/guestfish-actions.pod:3292 #, no-wrap msgid "" " luks-format-cipher device keyslot cipher\n" @@ -14638,19 +14609,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3399 +#: ../fish/guestfish-actions.pod:3294 msgid "" "This command is the same as L</luks-format> but it also allows you to set " "the C<cipher> used." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3405 +#: ../fish/guestfish-actions.pod:3300 msgid "luks-kill-slot" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3407 +#: ../fish/guestfish-actions.pod:3302 #, no-wrap msgid "" " luks-kill-slot device keyslot\n" @@ -14658,19 +14629,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3409 ../src/guestfs-actions.pod:5292 +#: ../fish/guestfish-actions.pod:3304 ../src/guestfs-actions.pod:5088 msgid "" "This command deletes the key in key slot C<keyslot> from the encrypted LUKS " "device C<device>. C<key> must be one of the I<other> keys." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3416 +#: ../fish/guestfish-actions.pod:3311 msgid "luks-open" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3418 +#: ../fish/guestfish-actions.pod:3313 #, no-wrap msgid "" " luks-open device mapname\n" @@ -14678,26 +14649,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3420 ../src/guestfs-actions.pod:5312 +#: ../fish/guestfish-actions.pod:3315 ../src/guestfs-actions.pod:5108 msgid "" "This command opens a block device which has been encrypted according to the " "Linux Unified Key Setup (LUKS) standard." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3423 ../src/guestfs-actions.pod:5315 +#: ../fish/guestfish-actions.pod:3318 ../src/guestfs-actions.pod:5111 msgid "C<device> is the encrypted block device or partition." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3425 ../src/guestfs-actions.pod:5317 +#: ../fish/guestfish-actions.pod:3320 ../src/guestfs-actions.pod:5113 msgid "" "The caller must supply one of the keys associated with the LUKS block " "device, in the C<key> parameter." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3428 ../src/guestfs-actions.pod:5320 +#: ../fish/guestfish-actions.pod:3323 ../src/guestfs-actions.pod:5116 msgid "" "This creates a new block device called C</dev/mapper/mapname>. Reads and " "writes to this block device are decrypted from and encrypted to the " @@ -14705,24 +14676,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3432 +#: ../fish/guestfish-actions.pod:3327 msgid "" "If this block device contains LVM volume groups, then calling L</vgscan> " "followed by L</vg-activate-all> will make them visible." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3436 +#: ../fish/guestfish-actions.pod:3331 msgid "Use L</list-dm-devices> to list all device mapper devices." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3442 +#: ../fish/guestfish-actions.pod:3337 msgid "luks-open-ro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3444 +#: ../fish/guestfish-actions.pod:3339 #, no-wrap msgid "" " luks-open-ro device mapname\n" @@ -14730,19 +14701,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3446 +#: ../fish/guestfish-actions.pod:3341 msgid "" "This is the same as L</luks-open> except that a read-only mapping is " "created." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3452 +#: ../fish/guestfish-actions.pod:3347 msgid "lvcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3454 +#: ../fish/guestfish-actions.pod:3349 #, no-wrap msgid "" " lvcreate logvol volgroup mbytes\n" @@ -14750,19 +14721,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3456 ../src/guestfs-actions.pod:5366 +#: ../fish/guestfish-actions.pod:3351 ../src/guestfs-actions.pod:5162 msgid "" "This creates an LVM logical volume called C<logvol> on the volume group " "C<volgroup>, with C<size> megabytes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3459 +#: ../fish/guestfish-actions.pod:3354 msgid "lvcreate-free" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3461 +#: ../fish/guestfish-actions.pod:3356 #, no-wrap msgid "" " lvcreate-free logvol volgroup percent\n" @@ -14770,7 +14741,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3463 ../src/guestfs-actions.pod:5381 +#: ../fish/guestfish-actions.pod:3358 ../src/guestfs-actions.pod:5177 msgid "" "Create an LVM logical volume called C</dev/volgroup/logvol>, using " "approximately C<percent> % of the free space remaining in the volume group. " @@ -14779,12 +14750,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3468 +#: ../fish/guestfish-actions.pod:3363 msgid "lvm-canonical-lv-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3470 +#: ../fish/guestfish-actions.pod:3365 #, no-wrap msgid "" " lvm-canonical-lv-name lvname\n" @@ -14792,7 +14763,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3472 ../src/guestfs-actions.pod:5396 +#: ../fish/guestfish-actions.pod:3367 ../src/guestfs-actions.pod:5192 msgid "" "This converts alternative naming schemes for LVs that you might find to the " "canonical name. For example, C</dev/mapper/VG-LV> is converted to " @@ -14800,24 +14771,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3476 ../src/guestfs-actions.pod:5400 +#: ../fish/guestfish-actions.pod:3371 ../src/guestfs-actions.pod:5196 msgid "" "This command returns an error if the C<lvname> parameter does not refer to a " "logical volume." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3479 -msgid "See also L</is-lv>, L</canonical-device-name>." +#: ../fish/guestfish-actions.pod:3374 +msgid "See also L</is-lv>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3481 +#: ../fish/guestfish-actions.pod:3376 msgid "lvm-clear-filter" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3483 +#: ../fish/guestfish-actions.pod:3378 #, no-wrap msgid "" " lvm-clear-filter\n" @@ -14825,24 +14796,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3485 +#: ../fish/guestfish-actions.pod:3380 msgid "" "This undoes the effect of L</lvm-set-filter>. LVM will be able to see every " "block device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3488 ../fish/guestfish-actions.pod:3516 ../src/guestfs-actions.pod:5418 ../src/guestfs-actions.pod:5457 +#: ../fish/guestfish-actions.pod:3383 ../fish/guestfish-actions.pod:3411 ../src/guestfs-actions.pod:5214 ../src/guestfs-actions.pod:5253 msgid "This command also clears the LVM cache and performs a volume group scan." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3491 +#: ../fish/guestfish-actions.pod:3386 msgid "lvm-remove-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3493 +#: ../fish/guestfish-actions.pod:3388 #, no-wrap msgid "" " lvm-remove-all\n" @@ -14850,19 +14821,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3495 ../src/guestfs-actions.pod:5430 +#: ../fish/guestfish-actions.pod:3390 ../src/guestfs-actions.pod:5226 msgid "" "This command removes all LVM logical volumes, volume groups and physical " "volumes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3498 +#: ../fish/guestfish-actions.pod:3393 msgid "lvm-set-filter" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3500 +#: ../fish/guestfish-actions.pod:3395 #, no-wrap msgid "" " lvm-set-filter 'devices ...'\n" @@ -14870,7 +14841,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3502 ../src/guestfs-actions.pod:5443 +#: ../fish/guestfish-actions.pod:3397 ../src/guestfs-actions.pod:5239 msgid "" "This sets the LVM device filter so that LVM will only be able to \"see\" the " "block devices in the list C<devices>, and will ignore all other attached " @@ -14878,7 +14849,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3506 ../src/guestfs-actions.pod:5447 +#: ../fish/guestfish-actions.pod:3401 ../src/guestfs-actions.pod:5243 msgid "" "Where disk image(s) contain duplicate PVs or VGs, this command is useful to " "get LVM to ignore the duplicates, otherwise LVM can get confused. Note also " @@ -14890,24 +14861,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3519 ../src/guestfs-actions.pod:5460 +#: ../fish/guestfish-actions.pod:3414 ../src/guestfs-actions.pod:5256 msgid "You can filter whole block devices or individual partitions." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3521 ../src/guestfs-actions.pod:5462 +#: ../fish/guestfish-actions.pod:3416 ../src/guestfs-actions.pod:5258 msgid "" "You cannot use this if any VG is currently in use (eg. contains a mounted " "filesystem), even if you are not filtering out that VG." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3525 +#: ../fish/guestfish-actions.pod:3420 msgid "lvremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3527 +#: ../fish/guestfish-actions.pod:3422 #, no-wrap msgid "" " lvremove device\n" @@ -14915,26 +14886,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3529 ../src/guestfs-actions.pod:5476 +#: ../fish/guestfish-actions.pod:3424 ../src/guestfs-actions.pod:5272 msgid "" "Remove an LVM logical volume C<device>, where C<device> is the path to the " "LV, such as C</dev/VG/LV>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3532 ../src/guestfs-actions.pod:5479 +#: ../fish/guestfish-actions.pod:3427 ../src/guestfs-actions.pod:5275 msgid "" "You can also remove all LVs in a volume group by specifying the VG name, " "C</dev/VG>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3535 +#: ../fish/guestfish-actions.pod:3430 msgid "lvrename" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3537 +#: ../fish/guestfish-actions.pod:3432 #, no-wrap msgid "" " lvrename logvol newlogvol\n" @@ -14942,17 +14913,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3539 ../src/guestfs-actions.pod:5493 +#: ../fish/guestfish-actions.pod:3434 ../src/guestfs-actions.pod:5289 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3541 +#: ../fish/guestfish-actions.pod:3436 msgid "lvresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3543 +#: ../fish/guestfish-actions.pod:3438 #, no-wrap msgid "" " lvresize device mbytes\n" @@ -14960,19 +14931,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3545 ../src/guestfs-actions.pod:5506 +#: ../fish/guestfish-actions.pod:3440 ../src/guestfs-actions.pod:5302 msgid "" "This resizes (expands or shrinks) an existing LVM logical volume to " "C<mbytes>. When reducing, data in the reduced part is lost." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3549 +#: ../fish/guestfish-actions.pod:3444 msgid "lvresize-free" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3551 +#: ../fish/guestfish-actions.pod:3446 #, no-wrap msgid "" " lvresize-free lv percent\n" @@ -14980,7 +14951,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3553 ../src/guestfs-actions.pod:5521 +#: ../fish/guestfish-actions.pod:3448 ../src/guestfs-actions.pod:5317 msgid "" "This expands an existing logical volume C<lv> so that it fills C<pc>% of the " "remaining free space in the volume group. Commonly you would call this with " @@ -14989,12 +14960,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3559 +#: ../fish/guestfish-actions.pod:3454 msgid "lvs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3561 +#: ../fish/guestfish-actions.pod:3456 #, no-wrap msgid "" " lvs\n" @@ -15002,31 +14973,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3563 ../src/guestfs-actions.pod:5536 +#: ../fish/guestfish-actions.pod:3458 ../src/guestfs-actions.pod:5332 msgid "" "List all the logical volumes detected. This is the equivalent of the " "L<lvs(8)> command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3566 ../src/guestfs-actions.pod:5539 +#: ../fish/guestfish-actions.pod:3461 ../src/guestfs-actions.pod:5335 msgid "" "This returns a list of the logical volume device names " "(eg. C</dev/VolGroup00/LogVol00>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3569 +#: ../fish/guestfish-actions.pod:3464 msgid "See also L</lvs-full>, L</list-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3571 +#: ../fish/guestfish-actions.pod:3466 msgid "lvs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3573 +#: ../fish/guestfish-actions.pod:3468 #, no-wrap msgid "" " lvs-full\n" @@ -15034,19 +15005,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3575 ../src/guestfs-actions.pod:5555 +#: ../fish/guestfish-actions.pod:3470 ../src/guestfs-actions.pod:5351 msgid "" "List all the logical volumes detected. This is the equivalent of the " "L<lvs(8)> command. The \"full\" version includes all fields." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3578 +#: ../fish/guestfish-actions.pod:3473 msgid "lvuuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3580 +#: ../fish/guestfish-actions.pod:3475 #, no-wrap msgid "" " lvuuid device\n" @@ -15054,17 +15025,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3582 ../src/guestfs-actions.pod:5570 +#: ../fish/guestfish-actions.pod:3477 ../src/guestfs-actions.pod:5366 msgid "This command returns the UUID of the LVM LV C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3584 +#: ../fish/guestfish-actions.pod:3479 msgid "lxattrlist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3586 +#: ../fish/guestfish-actions.pod:3481 #, no-wrap msgid "" " lxattrlist path 'names ...'\n" @@ -15072,7 +15043,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3588 ../src/guestfs-actions.pod:5584 +#: ../fish/guestfish-actions.pod:3483 ../src/guestfs-actions.pod:5380 msgid "" "This call allows you to get the extended attributes of multiple files, where " "all files are in the directory C<path>. C<names> is the list of files from " @@ -15080,7 +15051,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3592 ../src/guestfs-actions.pod:5588 +#: ../fish/guestfish-actions.pod:3487 ../src/guestfs-actions.pod:5384 msgid "" "On return you get a flat list of xattr structs which must be interpreted " "sequentially. The first xattr struct always has a zero-length C<attrname>. " @@ -15093,7 +15064,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3602 +#: ../fish/guestfish-actions.pod:3497 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. See also L</lstatlist> for a " @@ -15104,46 +15075,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3610 -msgid "max-disks" -msgstr "" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:3612 -#, no-wrap -msgid "" -" max-disks\n" -"\n" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:3614 -msgid "" -"Return the maximum number of disks that may be added to a handle (eg. by " -"L</add-drive-opts> and similar calls)." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:3617 ../src/guestfs-actions.pod:5620 -msgid "" -"This function was added in libguestfs 1.19.7. In previous versions of " -"libguestfs the limit was 25." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:3620 ../src/guestfs-actions.pod:5623 -msgid "" -"See L<guestfs(3)/MAXIMUM NUMBER OF DISKS> for additional information on this " -"topic." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:3623 +#: ../fish/guestfish-actions.pod:3505 msgid "md-create" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3625 +#: ../fish/guestfish-actions.pod:3507 #, no-wrap msgid "" " md-create name 'devices ...' [missingbitmap:N] [nrdevices:N] [spare:N] " @@ -15152,19 +15089,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3627 ../src/guestfs-actions.pod:5649 +#: ../fish/guestfish-actions.pod:3509 ../src/guestfs-actions.pod:5427 msgid "" "Create a Linux md (RAID) device named C<name> on the devices in the list " "C<devices>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3634 ../src/guestfs-actions.pod:5656 +#: ../fish/guestfish-actions.pod:3516 ../src/guestfs-actions.pod:5434 msgid "C<missingbitmap>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3636 ../src/guestfs-actions.pod:5658 +#: ../fish/guestfish-actions.pod:3518 ../src/guestfs-actions.pod:5436 msgid "" "A bitmap of missing devices. If a bit is set it means that a missing device " "is added to the array. The least significant bit corresponds to the first " @@ -15172,85 +15109,85 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3640 ../src/guestfs-actions.pod:5662 +#: ../fish/guestfish-actions.pod:3522 ../src/guestfs-actions.pod:5440 msgid "As examples:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3642 ../src/guestfs-actions.pod:5664 +#: ../fish/guestfish-actions.pod:3524 ../src/guestfs-actions.pod:5442 msgid "" "If C<devices = [\"/dev/sda\"]> and C<missingbitmap = 0x1> then the resulting " "array would be C<[E<lt>missingE<gt>, \"/dev/sda\"]>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3645 ../src/guestfs-actions.pod:5667 +#: ../fish/guestfish-actions.pod:3527 ../src/guestfs-actions.pod:5445 msgid "" "If C<devices = [\"/dev/sda\"]> and C<missingbitmap = 0x2> then the resulting " "array would be C<[\"/dev/sda\", E<lt>missingE<gt>]>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3648 ../src/guestfs-actions.pod:5670 +#: ../fish/guestfish-actions.pod:3530 ../src/guestfs-actions.pod:5448 msgid "This defaults to C<0> (no missing devices)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3650 ../src/guestfs-actions.pod:5672 +#: ../fish/guestfish-actions.pod:3532 ../src/guestfs-actions.pod:5450 msgid "" "The length of C<devices> + the number of bits set in C<missingbitmap> must " "equal C<nrdevices> + C<spare>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3653 ../src/guestfs-actions.pod:5675 +#: ../fish/guestfish-actions.pod:3535 ../src/guestfs-actions.pod:5453 msgid "C<nrdevices>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3655 ../src/guestfs-actions.pod:5677 +#: ../fish/guestfish-actions.pod:3537 ../src/guestfs-actions.pod:5455 msgid "The number of active RAID devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3657 ../src/guestfs-actions.pod:5679 +#: ../fish/guestfish-actions.pod:3539 ../src/guestfs-actions.pod:5457 msgid "" "If not set, this defaults to the length of C<devices> plus the number of " "bits set in C<missingbitmap>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3660 ../src/guestfs-actions.pod:5682 +#: ../fish/guestfish-actions.pod:3542 ../src/guestfs-actions.pod:5460 msgid "C<spare>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3662 ../src/guestfs-actions.pod:5684 +#: ../fish/guestfish-actions.pod:3544 ../src/guestfs-actions.pod:5462 msgid "The number of spare devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3664 ../src/guestfs-actions.pod:5686 +#: ../fish/guestfish-actions.pod:3546 ../src/guestfs-actions.pod:5464 msgid "If not set, this defaults to C<0>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3666 ../src/guestfs-actions.pod:5688 +#: ../fish/guestfish-actions.pod:3548 ../src/guestfs-actions.pod:5466 msgid "C<chunk>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3668 ../src/guestfs-actions.pod:5690 +#: ../fish/guestfish-actions.pod:3550 ../src/guestfs-actions.pod:5468 msgid "The chunk size in bytes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3670 ../fish/guestfish-actions.pod:3693 ../src/guestfs-actions.pod:5692 ../src/guestfs-actions.pod:5743 +#: ../fish/guestfish-actions.pod:3552 ../fish/guestfish-actions.pod:3575 ../src/guestfs-actions.pod:5470 ../src/guestfs-actions.pod:5521 msgid "C<level>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3672 ../src/guestfs-actions.pod:5694 +#: ../fish/guestfish-actions.pod:3554 ../src/guestfs-actions.pod:5472 msgid "" "The RAID level, which can be one of: I<linear>, I<raid0>, I<0>, I<stripe>, " "I<raid1>, I<1>, I<mirror>, I<raid4>, I<4>, I<raid5>, I<5>, I<raid6>, I<6>, " @@ -15259,17 +15196,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3677 ../src/guestfs-actions.pod:5699 +#: ../fish/guestfish-actions.pod:3559 ../src/guestfs-actions.pod:5477 msgid "If not set, this defaults to C<raid1>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3683 +#: ../fish/guestfish-actions.pod:3565 msgid "md-detail" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3685 +#: ../fish/guestfish-actions.pod:3567 #, no-wrap msgid "" " md-detail md\n" @@ -15277,7 +15214,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3687 ../src/guestfs-actions.pod:5737 +#: ../fish/guestfish-actions.pod:3569 ../src/guestfs-actions.pod:5515 msgid "" "This command exposes the output of 'mdadm -DY E<lt>mdE<gt>'. The following " "fields are usually present in the returned hash. Other fields may also be " @@ -15285,52 +15222,52 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3695 ../src/guestfs-actions.pod:5745 +#: ../fish/guestfish-actions.pod:3577 ../src/guestfs-actions.pod:5523 msgid "The raid level of the MD device." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3697 ../src/guestfs-actions.pod:5747 +#: ../fish/guestfish-actions.pod:3579 ../src/guestfs-actions.pod:5525 msgid "C<devices>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3699 ../src/guestfs-actions.pod:5749 +#: ../fish/guestfish-actions.pod:3581 ../src/guestfs-actions.pod:5527 msgid "The number of underlying devices in the MD device." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3701 ../src/guestfs-actions.pod:5751 +#: ../fish/guestfish-actions.pod:3583 ../src/guestfs-actions.pod:5529 msgid "C<metadata>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3703 ../src/guestfs-actions.pod:5753 +#: ../fish/guestfish-actions.pod:3585 ../src/guestfs-actions.pod:5531 msgid "The metadata version used." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3705 ../src/guestfs-actions.pod:5755 +#: ../fish/guestfish-actions.pod:3587 ../src/guestfs-actions.pod:5533 msgid "C<uuid>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3707 ../src/guestfs-actions.pod:5757 +#: ../fish/guestfish-actions.pod:3589 ../src/guestfs-actions.pod:5535 msgid "The UUID of the MD device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3711 ../src/guestfs-actions.pod:5761 +#: ../fish/guestfish-actions.pod:3593 ../src/guestfs-actions.pod:5539 msgid "The name of the MD device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3715 +#: ../fish/guestfish-actions.pod:3597 msgid "md-stat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3717 +#: ../fish/guestfish-actions.pod:3599 #, no-wrap msgid "" " md-stat md\n" @@ -15338,103 +15275,103 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3719 ../src/guestfs-actions.pod:5779 +#: ../fish/guestfish-actions.pod:3601 ../src/guestfs-actions.pod:5557 msgid "" "This call returns a list of the underlying devices which make up the single " "software RAID array device C<md>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3722 +#: ../fish/guestfish-actions.pod:3604 msgid "To get a list of software RAID devices, call L</list-md-devices>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3724 ../src/guestfs-actions.pod:5784 +#: ../fish/guestfish-actions.pod:3606 ../src/guestfs-actions.pod:5562 msgid "" "Each structure returned corresponds to one device along with additional " "status information:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3729 ../src/guestfs-actions.pod:5789 +#: ../fish/guestfish-actions.pod:3611 ../src/guestfs-actions.pod:5567 msgid "C<mdstat_device>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3731 ../src/guestfs-actions.pod:5791 +#: ../fish/guestfish-actions.pod:3613 ../src/guestfs-actions.pod:5569 msgid "The name of the underlying device." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3733 ../src/guestfs-actions.pod:5793 +#: ../fish/guestfish-actions.pod:3615 ../src/guestfs-actions.pod:5571 msgid "C<mdstat_index>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3735 ../src/guestfs-actions.pod:5795 +#: ../fish/guestfish-actions.pod:3617 ../src/guestfs-actions.pod:5573 msgid "The index of this device within the array." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3737 ../src/guestfs-actions.pod:5797 +#: ../fish/guestfish-actions.pod:3619 ../src/guestfs-actions.pod:5575 msgid "C<mdstat_flags>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3739 ../src/guestfs-actions.pod:5799 +#: ../fish/guestfish-actions.pod:3621 ../src/guestfs-actions.pod:5577 msgid "" "Flags associated with this device. This is a string containing (in no " "specific order) zero or more of the following flags:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3744 ../src/guestfs-actions.pod:5804 +#: ../fish/guestfish-actions.pod:3626 ../src/guestfs-actions.pod:5582 msgid "C<W>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3746 ../src/guestfs-actions.pod:5806 +#: ../fish/guestfish-actions.pod:3628 ../src/guestfs-actions.pod:5584 msgid "write-mostly" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3748 ../src/guestfs-actions.pod:5808 +#: ../fish/guestfish-actions.pod:3630 ../src/guestfs-actions.pod:5586 msgid "C<F>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3750 ../src/guestfs-actions.pod:5810 +#: ../fish/guestfish-actions.pod:3632 ../src/guestfs-actions.pod:5588 msgid "device is faulty" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3752 ../src/guestfs-actions.pod:5812 +#: ../fish/guestfish-actions.pod:3634 ../src/guestfs-actions.pod:5590 msgid "C<S>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3754 ../src/guestfs-actions.pod:5814 +#: ../fish/guestfish-actions.pod:3636 ../src/guestfs-actions.pod:5592 msgid "device is a RAID spare" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3756 ../src/guestfs-actions.pod:5816 +#: ../fish/guestfish-actions.pod:3638 ../src/guestfs-actions.pod:5594 msgid "C<R>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3758 ../src/guestfs-actions.pod:5818 +#: ../fish/guestfish-actions.pod:3640 ../src/guestfs-actions.pod:5596 msgid "replacement" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3764 +#: ../fish/guestfish-actions.pod:3646 msgid "md-stop" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3766 +#: ../fish/guestfish-actions.pod:3648 #, no-wrap msgid "" " md-stop md\n" @@ -15442,19 +15379,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3768 ../src/guestfs-actions.pod:5836 +#: ../fish/guestfish-actions.pod:3650 ../src/guestfs-actions.pod:5614 msgid "" "This command deactivates the MD array named C<md>. The device is stopped, " "but it is not destroyed or zeroed." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3771 +#: ../fish/guestfish-actions.pod:3653 msgid "mkdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3773 +#: ../fish/guestfish-actions.pod:3655 #, no-wrap msgid "" " mkdir path\n" @@ -15462,17 +15399,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3775 ../src/guestfs-actions.pod:5849 +#: ../fish/guestfish-actions.pod:3657 ../src/guestfs-actions.pod:5627 msgid "Create a directory named C<path>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3777 +#: ../fish/guestfish-actions.pod:3659 msgid "mkdir-mode" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3779 +#: ../fish/guestfish-actions.pod:3661 #, no-wrap msgid "" " mkdir-mode path mode\n" @@ -15480,14 +15417,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3781 ../src/guestfs-actions.pod:5862 +#: ../fish/guestfish-actions.pod:3663 ../src/guestfs-actions.pod:5640 msgid "" "This command creates a directory, setting the initial permissions of the " "directory to C<mode>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3784 ../src/guestfs-actions.pod:5865 +#: ../fish/guestfish-actions.pod:3666 ../src/guestfs-actions.pod:5643 msgid "" "For common Linux filesystems, the actual mode which is set will be C<mode & " "~umask & 01777>. Non-native-Linux filesystems may interpret the mode in " @@ -15495,17 +15432,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3788 +#: ../fish/guestfish-actions.pod:3670 msgid "See also L</mkdir>, L</umask>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3790 +#: ../fish/guestfish-actions.pod:3672 msgid "mkdir-p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3792 +#: ../fish/guestfish-actions.pod:3674 #, no-wrap msgid "" " mkdir-p path\n" @@ -15513,19 +15450,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3794 ../src/guestfs-actions.pod:5881 +#: ../fish/guestfish-actions.pod:3676 ../src/guestfs-actions.pod:5659 msgid "" "Create a directory named C<path>, creating any parent directories as " "necessary. This is like the C<mkdir -p> shell command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3797 +#: ../fish/guestfish-actions.pod:3679 msgid "mkdtemp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3799 +#: ../fish/guestfish-actions.pod:3681 #, no-wrap msgid "" " mkdtemp tmpl\n" @@ -15533,7 +15470,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3801 ../src/guestfs-actions.pod:5894 +#: ../fish/guestfish-actions.pod:3683 ../src/guestfs-actions.pod:5672 msgid "" "This command creates a temporary directory. The C<tmpl> parameter should be " "a full pathname for the temporary directory name with the final six " @@ -15541,41 +15478,41 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3806 ../src/guestfs-actions.pod:5899 +#: ../fish/guestfish-actions.pod:3688 ../src/guestfs-actions.pod:5677 msgid "" "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one " "being suitable for Windows filesystems." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3809 ../src/guestfs-actions.pod:5902 +#: ../fish/guestfish-actions.pod:3691 ../src/guestfs-actions.pod:5680 msgid "The name of the temporary directory that was created is returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3812 ../src/guestfs-actions.pod:5905 +#: ../fish/guestfish-actions.pod:3694 ../src/guestfs-actions.pod:5683 msgid "The temporary directory is created with mode 0700 and is owned by root." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3815 ../src/guestfs-actions.pod:5908 +#: ../fish/guestfish-actions.pod:3697 ../src/guestfs-actions.pod:5686 msgid "" "The caller is responsible for deleting the temporary directory and its " "contents after use." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3818 ../src/guestfs-actions.pod:5911 +#: ../fish/guestfish-actions.pod:3700 ../src/guestfs-actions.pod:5689 msgid "See also: L<mkdtemp(3)>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3820 +#: ../fish/guestfish-actions.pod:3702 msgid "mke2fs-J" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3822 +#: ../fish/guestfish-actions.pod:3704 #, no-wrap msgid "" " mke2fs-J fstype blocksize device journal\n" @@ -15583,14 +15520,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3824 ../src/guestfs-actions.pod:5927 +#: ../fish/guestfish-actions.pod:3706 ../src/guestfs-actions.pod:5705 msgid "" "This creates an ext2/3/4 filesystem on C<device> with an external journal on " "C<journal>. It is equivalent to the command:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3828 ../src/guestfs-actions.pod:5931 +#: ../fish/guestfish-actions.pod:3710 ../src/guestfs-actions.pod:5709 #, no-wrap msgid "" " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n" @@ -15598,17 +15535,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3830 +#: ../fish/guestfish-actions.pod:3712 msgid "See also L</mke2journal>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3832 +#: ../fish/guestfish-actions.pod:3714 msgid "mke2fs-JL" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3834 +#: ../fish/guestfish-actions.pod:3716 #, no-wrap msgid "" " mke2fs-JL fstype blocksize device label\n" @@ -15616,24 +15553,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3836 ../src/guestfs-actions.pod:5948 +#: ../fish/guestfish-actions.pod:3718 ../src/guestfs-actions.pod:5726 msgid "" "This creates an ext2/3/4 filesystem on C<device> with an external journal on " "the journal labeled C<label>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3839 +#: ../fish/guestfish-actions.pod:3721 msgid "See also L</mke2journal-L>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3841 +#: ../fish/guestfish-actions.pod:3723 msgid "mke2fs-JU" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3843 +#: ../fish/guestfish-actions.pod:3725 #, no-wrap msgid "" " mke2fs-JU fstype blocksize device uuid\n" @@ -15641,24 +15578,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3845 ../src/guestfs-actions.pod:5966 +#: ../fish/guestfish-actions.pod:3727 ../src/guestfs-actions.pod:5744 msgid "" "This creates an ext2/3/4 filesystem on C<device> with an external journal on " "the journal with UUID C<uuid>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3848 +#: ../fish/guestfish-actions.pod:3730 msgid "See also L</mke2journal-U>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3850 +#: ../fish/guestfish-actions.pod:3732 msgid "mke2journal" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3852 +#: ../fish/guestfish-actions.pod:3734 #, no-wrap msgid "" " mke2journal blocksize device\n" @@ -15666,14 +15603,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3854 ../src/guestfs-actions.pod:5982 +#: ../fish/guestfish-actions.pod:3736 ../src/guestfs-actions.pod:5760 msgid "" "This creates an ext2 external journal on C<device>. It is equivalent to the " "command:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3857 ../src/guestfs-actions.pod:5985 +#: ../fish/guestfish-actions.pod:3739 ../src/guestfs-actions.pod:5763 #, no-wrap msgid "" " mke2fs -O journal_dev -b blocksize device\n" @@ -15681,12 +15618,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3859 +#: ../fish/guestfish-actions.pod:3741 msgid "mke2journal-L" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3861 +#: ../fish/guestfish-actions.pod:3743 #, no-wrap msgid "" " mke2journal-L blocksize label device\n" @@ -15694,17 +15631,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3863 ../src/guestfs-actions.pod:5999 +#: ../fish/guestfish-actions.pod:3745 ../src/guestfs-actions.pod:5777 msgid "This creates an ext2 external journal on C<device> with label C<label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3865 +#: ../fish/guestfish-actions.pod:3747 msgid "mke2journal-U" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3867 +#: ../fish/guestfish-actions.pod:3749 #, no-wrap msgid "" " mke2journal-U blocksize uuid device\n" @@ -15712,17 +15649,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3869 ../src/guestfs-actions.pod:6013 +#: ../fish/guestfish-actions.pod:3751 ../src/guestfs-actions.pod:5791 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3871 +#: ../fish/guestfish-actions.pod:3753 msgid "mkfifo" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3873 +#: ../fish/guestfish-actions.pod:3755 #, no-wrap msgid "" " mkfifo mode path\n" @@ -15730,176 +15667,194 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3875 +#: ../fish/guestfish-actions.pod:3757 msgid "" "This call creates a FIFO (named pipe) called C<path> with mode C<mode>. It " "is just a convenient wrapper around L</mknod>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3881 +#: ../fish/guestfish-actions.pod:3763 msgid "mkfs" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:3883 -msgid "mkfs-opts" -msgstr "" - #. type: verbatim -#: ../fish/guestfish-actions.pod:3885 +#: ../fish/guestfish-actions.pod:3765 #, no-wrap msgid "" -" mkfs fstype device [blocksize:N] [features:..] [inode:N] [sectorsize:N]\n" +" mkfs fstype device\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3887 ../src/guestfs-actions.pod:6068 +#: ../fish/guestfish-actions.pod:3767 ../src/guestfs-actions.pod:5821 msgid "" -"This function creates a filesystem on C<device>. The filesystem type is " -"C<fstype>, for example C<ext3>." +"This creates a filesystem on C<device> (usually a partition or LVM logical " +"volume). The filesystem type is C<fstype>, for example C<ext3>." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:3894 ../src/guestfs-actions.pod:6075 -msgid "C<blocksize>" +#. type: =head2 +#: ../fish/guestfish-actions.pod:3771 +msgid "mkfs-b" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:3773 +#, no-wrap +msgid "" +" mkfs-b fstype blocksize device\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3896 ../src/guestfs-actions.pod:6077 +#: ../fish/guestfish-actions.pod:3775 msgid "" -"The filesystem block size. Supported block sizes depend on the filesystem " -"type, but typically they are C<1024>, C<2048> or C<4096> for Linux ext2/3 " -"filesystems." +"This call is similar to L</mkfs>, but it allows you to control the block " +"size of the resulting filesystem. Supported block sizes depend on the " +"filesystem type, but typically they are C<1024>, C<2048> or C<4096> only." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3900 ../fish/guestfish-actions.pod:3939 ../src/guestfs-actions.pod:6081 ../src/guestfs-actions.pod:6157 +#: ../fish/guestfish-actions.pod:3780 ../fish/guestfish-actions.pod:3821 ../src/guestfs-actions.pod:5849 ../src/guestfs-actions.pod:5942 msgid "" "For VFAT and NTFS the C<blocksize> parameter is treated as the requested " "cluster size." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3903 ../src/guestfs-actions.pod:6084 -msgid "For UFS block sizes, please see L<mkfs.ufs(8)>." -msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:3905 ../src/guestfs-actions.pod:6086 -msgid "C<features>" +#: ../fish/guestfish-actions.pod:3783 +msgid "" +"I<This function is deprecated.> In new code, use the L</mkfs_opts> call " +"instead." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:3907 ../src/guestfs-actions.pod:6088 -msgid "This passes the I<-O> parameter to the external mkfs program." +#. type: =head2 +#: ../fish/guestfish-actions.pod:3790 +msgid "mkfs-btrfs" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:3909 ../src/guestfs-actions.pod:6090 +#. type: verbatim +#: ../fish/guestfish-actions.pod:3792 +#, no-wrap msgid "" -"For certain filesystem types, this allows extra filesystem features to be " -"selected. See L<mke2fs(8)> and L<mkfs.ufs(8)> for more details." +" mkfs-btrfs 'devices ...' [allocstart:N] [bytecount:N] [datatype:..] " +"[leafsize:N] [label:..] [metadata:..] [nodesize:N] [sectorsize:N]\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3913 ../src/guestfs-actions.pod:6094 +#: ../fish/guestfish-actions.pod:3794 ../src/guestfs-actions.pod:5877 msgid "" -"You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem " -"type." -msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:3916 ../src/guestfs-actions.pod:6097 -msgid "C<inode>" +"Create a btrfs filesystem, allowing all configurables to be set. For more " +"information on the optional arguments, see L<mkfs.btrfs(8)>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3918 ../src/guestfs-actions.pod:6099 +#: ../fish/guestfish-actions.pod:3797 ../src/guestfs-actions.pod:5880 msgid "" -"This passes the I<-I> parameter to the external L<mke2fs(8)> program which " -"sets the inode size (only for ext2/3/4 filesystems at present)." -msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:3921 ../src/guestfs-actions.pod:6102 -msgid "C<sectorsize>" +"Since btrfs filesystems can span multiple devices, this takes a non-empty " +"list of devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3923 ../src/guestfs-actions.pod:6104 -msgid "" -"This passes the I<-S> parameter to external L<mkfs.ufs(8)> program, which " -"sets sector size for ufs filesystem." +#: ../fish/guestfish-actions.pod:3800 +msgid "To create general filesystems, use L</mkfs-opts>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3930 -msgid "mkfs-b" +#: ../fish/guestfish-actions.pod:3804 +msgid "mkfs-opts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3932 +#: ../fish/guestfish-actions.pod:3806 #, no-wrap msgid "" -" mkfs-b fstype blocksize device\n" +" mkfs-opts fstype device [blocksize:N] [features:..] [inode:N] " +"[sectorsize:N]\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3934 +#: ../fish/guestfish-actions.pod:3808 ../src/guestfs-actions.pod:5929 msgid "" -"This call is similar to L</mkfs>, but it allows you to control the block " -"size of the resulting filesystem. Supported block sizes depend on the " -"filesystem type, but typically they are C<1024>, C<2048> or C<4096> only." +"This function creates a filesystem on C<device>. The filesystem type is " +"C<fstype>, for example C<ext3>." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:3815 ../src/guestfs-actions.pod:5936 +msgid "C<blocksize>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3942 -msgid "I<This function is deprecated.> In new code, use the L</mkfs> call instead." +#: ../fish/guestfish-actions.pod:3817 ../src/guestfs-actions.pod:5938 +msgid "" +"The filesystem block size. Supported block sizes depend on the filesystem " +"type, but typically they are C<1024>, C<2048> or C<4096> for Linux ext2/3 " +"filesystems." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:3949 -msgid "mkfs-btrfs" +#. type: textblock +#: ../fish/guestfish-actions.pod:3824 ../src/guestfs-actions.pod:5945 +msgid "For UFS block sizes, please see L<mkfs.ufs(8)>." msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:3951 -#, no-wrap +#. type: =item +#: ../fish/guestfish-actions.pod:3826 ../src/guestfs-actions.pod:5947 +msgid "C<features>" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3828 ../src/guestfs-actions.pod:5949 +msgid "This passes the I<-O> parameter to the external mkfs program." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3830 ../src/guestfs-actions.pod:5951 msgid "" -" mkfs-btrfs 'devices ...' [allocstart:N] [bytecount:N] [datatype:..] " -"[leafsize:N] [label:..] [metadata:..] [nodesize:N] [sectorsize:N]\n" -"\n" +"For certain filesystem types, this allows extra filesystem features to be " +"selected. See L<mke2fs(8)> and L<mkfs.ufs(8)> for more details." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3953 ../src/guestfs-actions.pod:6185 +#: ../fish/guestfish-actions.pod:3834 ../src/guestfs-actions.pod:5955 msgid "" -"Create a btrfs filesystem, allowing all configurables to be set. For more " -"information on the optional arguments, see L<mkfs.btrfs(8)>." +"You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem " +"type." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:3837 ../src/guestfs-actions.pod:5958 +msgid "C<inode>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3956 ../src/guestfs-actions.pod:6188 +#: ../fish/guestfish-actions.pod:3839 ../src/guestfs-actions.pod:5960 msgid "" -"Since btrfs filesystems can span multiple devices, this takes a non-empty " -"list of devices." +"This passes the I<-I> parameter to the external L<mke2fs(8)> program which " +"sets the inode size (only for ext2/3/4 filesystems at present)." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:3842 ../src/guestfs-actions.pod:5963 +msgid "C<sectorsize>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3959 -msgid "To create general filesystems, use L</mkfs>." +#: ../fish/guestfish-actions.pod:3844 ../src/guestfs-actions.pod:5965 +msgid "" +"This passes the I<-S> parameter to external L<mkfs.ufs(8)> program, which " +"sets sector size for ufs filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3963 +#: ../fish/guestfish-actions.pod:3851 msgid "mkmountpoint" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3965 +#: ../fish/guestfish-actions.pod:3853 #, no-wrap msgid "" " mkmountpoint exemptpath\n" @@ -15907,14 +15862,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3967 +#: ../fish/guestfish-actions.pod:3855 msgid "" "L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used " "to create extra mountpoints before mounting the first filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3971 ../src/guestfs-actions.pod:6229 +#: ../fish/guestfish-actions.pod:3859 ../src/guestfs-actions.pod:6008 msgid "" "These calls are I<only> necessary in some very limited circumstances, mainly " "the case where you want to mount a mix of unrelated and/or read-only " @@ -15922,7 +15877,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3975 ../src/guestfs-actions.pod:6233 +#: ../fish/guestfish-actions.pod:3863 ../src/guestfs-actions.pod:6012 msgid "" "For example, live CDs often contain a \"Russian doll\" nest of filesystems, " "an ISO outer layer, with a squashfs image inside, with an ext2/3 image " @@ -15930,7 +15885,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3980 ../src/guestfs-actions.pod:6238 +#: ../fish/guestfish-actions.pod:3868 ../src/guestfs-actions.pod:6017 #, no-wrap msgid "" " add-ro Fedora-11-i686-Live.iso\n" @@ -15945,12 +15900,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3989 ../src/guestfs-actions.pod:6247 +#: ../fish/guestfish-actions.pod:3877 ../src/guestfs-actions.pod:6026 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3991 +#: ../fish/guestfish-actions.pod:3879 msgid "" "L</mkmountpoint> is not compatible with L</umount-all>. You may get " "unexpected errors if you try to mix these calls. It is safest to manually " @@ -15958,7 +15913,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3995 +#: ../fish/guestfish-actions.pod:3883 msgid "" "L</umount-all> unmounts filesystems by sorting the paths longest first, so " "for this to work for manual mountpoints, you must ensure that the innermost " @@ -15966,12 +15921,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4000 ../src/guestfs-actions.pod:6258 +#: ../fish/guestfish-actions.pod:3888 ../src/guestfs-actions.pod:6037 msgid "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4002 +#: ../fish/guestfish-actions.pod:3890 msgid "" "Autosync [see L</set-autosync>, this is set by default on handles] can cause " "L</umount-all> to be called when the handle is closed which can also trigger " @@ -15979,12 +15934,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4006 +#: ../fish/guestfish-actions.pod:3894 msgid "mknod" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4008 +#: ../fish/guestfish-actions.pod:3896 #, no-wrap msgid "" " mknod mode devmajor devminor path\n" @@ -15992,14 +15947,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4010 ../src/guestfs-actions.pod:6277 +#: ../fish/guestfish-actions.pod:3898 ../src/guestfs-actions.pod:6056 msgid "" "This call creates block or character special devices, or named pipes " "(FIFOs)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4013 ../src/guestfs-actions.pod:6280 +#: ../fish/guestfish-actions.pod:3901 ../src/guestfs-actions.pod:6059 msgid "" "The C<mode> parameter should be the mode, using the standard constants. " "C<devmajor> and C<devminor> are the device major and minor numbers, only " @@ -16007,7 +15962,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4018 +#: ../fish/guestfish-actions.pod:3906 msgid "" "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with " "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a " @@ -16018,12 +15973,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4028 +#: ../fish/guestfish-actions.pod:3916 msgid "mknod-b" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4030 +#: ../fish/guestfish-actions.pod:3918 #, no-wrap msgid "" " mknod-b mode devmajor devminor path\n" @@ -16031,7 +15986,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4032 +#: ../fish/guestfish-actions.pod:3920 msgid "" "This call creates a block device node called C<path> with mode C<mode> and " "device major/minor C<devmajor> and C<devminor>. It is just a convenient " @@ -16039,12 +15994,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4038 +#: ../fish/guestfish-actions.pod:3926 msgid "mknod-c" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4040 +#: ../fish/guestfish-actions.pod:3928 #, no-wrap msgid "" " mknod-c mode devmajor devminor path\n" @@ -16052,7 +16007,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4042 +#: ../fish/guestfish-actions.pod:3930 msgid "" "This call creates a char device node called C<path> with mode C<mode> and " "device major/minor C<devmajor> and C<devminor>. It is just a convenient " @@ -16060,12 +16015,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4048 +#: ../fish/guestfish-actions.pod:3936 msgid "mkswap" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4050 +#: ../fish/guestfish-actions.pod:3938 #, no-wrap msgid "" " mkswap device\n" @@ -16073,17 +16028,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4052 ../src/guestfs-actions.pod:6343 +#: ../fish/guestfish-actions.pod:3940 ../src/guestfs-actions.pod:6122 msgid "Create a swap partition on C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4054 +#: ../fish/guestfish-actions.pod:3942 msgid "mkswap-L" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4056 +#: ../fish/guestfish-actions.pod:3944 #, no-wrap msgid "" " mkswap-L label device\n" @@ -16091,12 +16046,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4058 ../src/guestfs-actions.pod:6356 +#: ../fish/guestfish-actions.pod:3946 ../src/guestfs-actions.pod:6135 msgid "Create a swap partition on C<device> with label C<label>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4060 ../src/guestfs-actions.pod:6358 +#: ../fish/guestfish-actions.pod:3948 ../src/guestfs-actions.pod:6137 msgid "" "Note that you cannot attach a swap label to a block device " "(eg. C</dev/sda>), just to a partition. This appears to be a limitation of " @@ -16104,12 +16059,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4064 +#: ../fish/guestfish-actions.pod:3952 msgid "mkswap-U" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4066 +#: ../fish/guestfish-actions.pod:3954 #, no-wrap msgid "" " mkswap-U uuid device\n" @@ -16117,17 +16072,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4068 ../src/guestfs-actions.pod:6373 +#: ../fish/guestfish-actions.pod:3956 ../src/guestfs-actions.pod:6152 msgid "Create a swap partition on C<device> with UUID C<uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4070 +#: ../fish/guestfish-actions.pod:3958 msgid "mkswap-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4072 +#: ../fish/guestfish-actions.pod:3960 #, no-wrap msgid "" " mkswap-file path\n" @@ -16135,24 +16090,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4074 ../src/guestfs-actions.pod:6385 +#: ../fish/guestfish-actions.pod:3962 ../src/guestfs-actions.pod:6164 msgid "Create a swap file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4076 +#: ../fish/guestfish-actions.pod:3964 msgid "" "This command just writes a swap file signature to an existing file. To " "create the file itself, use something like L</fallocate>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4079 +#: ../fish/guestfish-actions.pod:3967 msgid "modprobe" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4081 +#: ../fish/guestfish-actions.pod:3969 #, no-wrap msgid "" " modprobe modulename\n" @@ -16160,24 +16115,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4083 ../src/guestfs-actions.pod:6400 +#: ../fish/guestfish-actions.pod:3971 ../src/guestfs-actions.pod:6179 msgid "This loads a kernel module in the appliance." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4085 ../src/guestfs-actions.pod:6402 +#: ../fish/guestfish-actions.pod:3973 ../src/guestfs-actions.pod:6181 msgid "" "The kernel module must have been whitelisted when libguestfs was built (see " "C<appliance/kmod.whitelist.in> in the source)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4088 +#: ../fish/guestfish-actions.pod:3976 msgid "mount" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4090 +#: ../fish/guestfish-actions.pod:3978 #, no-wrap msgid "" " mount device mountpoint\n" @@ -16185,7 +16140,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4092 ../src/guestfs-actions.pod:6416 +#: ../fish/guestfish-actions.pod:3980 ../src/guestfs-actions.pod:6195 msgid "" "Mount a guest disk at a position in the filesystem. Block devices are named " "C</dev/sda>, C</dev/sdb> and so on, as they were added to the guest. If " @@ -16194,7 +16149,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4098 ../src/guestfs-actions.pod:6422 +#: ../fish/guestfish-actions.pod:3986 ../src/guestfs-actions.pod:6201 msgid "" "The rules are the same as for L<mount(2)>: A filesystem must first be " "mounted on C</> before others can be mounted. Other filesystems can only be " @@ -16202,14 +16157,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4103 ../src/guestfs-actions.pod:6427 +#: ../fish/guestfish-actions.pod:3991 ../src/guestfs-actions.pod:6206 msgid "" "The mounted filesystem is writable, if we have sufficient permissions on the " "underlying device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4106 +#: ../fish/guestfish-actions.pod:3994 msgid "" "Before libguestfs 1.13.16, this call implicitly added the options C<sync> " "and C<noatime>. The C<sync> option greatly slowed writes and caused many " @@ -16219,12 +16174,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4113 +#: ../fish/guestfish-actions.pod:4001 msgid "mount-9p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4115 +#: ../fish/guestfish-actions.pod:4003 #, no-wrap msgid "" " mount-9p mounttag mountpoint [options:..]\n" @@ -16232,14 +16187,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4117 ../src/guestfs-actions.pod:6456 +#: ../fish/guestfish-actions.pod:4005 ../src/guestfs-actions.pod:6235 msgid "" "Mount the virtio-9p filesystem with the tag C<mounttag> on the directory " "C<mountpoint>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4120 ../src/guestfs-actions.pod:6459 +#: ../fish/guestfish-actions.pod:4008 ../src/guestfs-actions.pod:6238 msgid "" "If required, C<trans=virtio> will be automatically added to the options. " "Any other options required can be passed in the optional C<options> " @@ -16247,12 +16202,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4126 +#: ../fish/guestfish-actions.pod:4014 msgid "mount-local" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4128 +#: ../fish/guestfish-actions.pod:4016 #, no-wrap msgid "" " mount-local localmountpoint [readonly:true|false] [options:..] " @@ -16261,7 +16216,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4130 ../src/guestfs-actions.pod:6508 +#: ../fish/guestfish-actions.pod:4018 ../src/guestfs-actions.pod:6287 msgid "" "This call exports the libguestfs-accessible filesystem to a local mountpoint " "(directory) called C<localmountpoint>. Ordinary reads and writes to files " @@ -16269,35 +16224,35 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4135 ../src/guestfs-actions.pod:6513 +#: ../fish/guestfish-actions.pod:4023 ../src/guestfs-actions.pod:6292 msgid "" "If the optional C<readonly> flag is set to true, then writes to the " "filesystem return error C<EROFS>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4138 ../src/guestfs-actions.pod:6516 +#: ../fish/guestfish-actions.pod:4026 ../src/guestfs-actions.pod:6295 msgid "" "C<options> is a comma-separated list of mount options. See L<guestmount(1)> " "for some useful options." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4141 ../src/guestfs-actions.pod:6519 +#: ../fish/guestfish-actions.pod:4029 ../src/guestfs-actions.pod:6298 msgid "" "C<cachetimeout> sets the timeout (in seconds) for cached directory entries. " "The default is 60 seconds. See L<guestmount(1)> for further information." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4145 ../src/guestfs-actions.pod:6523 +#: ../fish/guestfish-actions.pod:4033 ../src/guestfs-actions.pod:6302 msgid "" "If C<debugcalls> is set to true, then additional debugging information is " "generated for every FUSE call." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4148 +#: ../fish/guestfish-actions.pod:4036 msgid "" "When L</mount-local> returns, the filesystem is ready, but is not processing " "requests (access to it will block). You have to call L</mount-local-run> to " @@ -16305,17 +16260,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4152 ../fish/guestfish-actions.pod:4176 ../fish/guestfish-actions.pod:5927 ../src/guestfs-actions.pod:6530 ../src/guestfs-actions.pod:6579 ../src/guestfs-actions.pod:9313 +#: ../fish/guestfish-actions.pod:4040 ../fish/guestfish-actions.pod:4064 ../fish/guestfish-actions.pod:5788 ../src/guestfs-actions.pod:6309 ../src/guestfs-actions.pod:6358 ../src/guestfs-actions.pod:9015 msgid "See L<guestfs(3)/MOUNT LOCAL> for full documentation." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4156 +#: ../fish/guestfish-actions.pod:4044 msgid "mount-local-run" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4158 +#: ../fish/guestfish-actions.pod:4046 #, no-wrap msgid "" " mount-local-run\n" @@ -16323,26 +16278,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4160 ../src/guestfs-actions.pod:6563 +#: ../fish/guestfish-actions.pod:4048 ../src/guestfs-actions.pod:6342 msgid "Run the main loop which translates kernel calls to libguestfs calls." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4163 +#: ../fish/guestfish-actions.pod:4051 msgid "" "This should only be called after L</mount-local> returns successfully. The " "call will not return until the filesystem is unmounted." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4167 +#: ../fish/guestfish-actions.pod:4055 msgid "" "B<Note> you must I<not> make concurrent libguestfs calls on the same handle " "from another thread, with the exception of L</umount-local>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4171 +#: ../fish/guestfish-actions.pod:4059 msgid "" "You may call this from a different thread than the one which called " "L</mount-local>, subject to the usual rules for threads and libguestfs (see " @@ -16350,12 +16305,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4178 +#: ../fish/guestfish-actions.pod:4066 msgid "mount-loop" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4180 +#: ../fish/guestfish-actions.pod:4068 #, no-wrap msgid "" " mount-loop file mountpoint\n" @@ -16363,7 +16318,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4182 ../src/guestfs-actions.pod:6592 +#: ../fish/guestfish-actions.pod:4070 ../src/guestfs-actions.pod:6371 msgid "" "This command lets you mount C<file> (a filesystem image in a file) on a " "mount point. It is entirely equivalent to the command C<mount -o loop file " @@ -16371,12 +16326,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4186 +#: ../fish/guestfish-actions.pod:4074 msgid "mount-options" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4188 +#: ../fish/guestfish-actions.pod:4076 #, no-wrap msgid "" " mount-options options device mountpoint\n" @@ -16384,26 +16339,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4190 +#: ../fish/guestfish-actions.pod:4078 msgid "" "This is the same as the L</mount> command, but it allows you to set the " "mount options as for the L<mount(8)> I<-o> flag." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4194 ../src/guestfs-actions.pod:6612 +#: ../fish/guestfish-actions.pod:4082 ../src/guestfs-actions.pod:6391 msgid "" "If the C<options> parameter is an empty string, then no options are passed " "(all options default to whatever the filesystem uses)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4198 +#: ../fish/guestfish-actions.pod:4086 msgid "mount-ro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4200 +#: ../fish/guestfish-actions.pod:4088 #, no-wrap msgid "" " mount-ro device mountpoint\n" @@ -16411,19 +16366,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4202 +#: ../fish/guestfish-actions.pod:4090 msgid "" "This is the same as the L</mount> command, but it mounts the filesystem with " "the read-only (I<-o ro>) flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4205 +#: ../fish/guestfish-actions.pod:4093 msgid "mount-vfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4207 +#: ../fish/guestfish-actions.pod:4095 #, no-wrap msgid "" " mount-vfs options vfstype device mountpoint\n" @@ -16431,19 +16386,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4209 +#: ../fish/guestfish-actions.pod:4097 msgid "" "This is the same as the L</mount> command, but it allows you to set both the " "mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4213 +#: ../fish/guestfish-actions.pod:4101 msgid "mountpoints" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4215 +#: ../fish/guestfish-actions.pod:4103 #, no-wrap msgid "" " mountpoints\n" @@ -16451,7 +16406,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4217 +#: ../fish/guestfish-actions.pod:4105 msgid "" "This call is similar to L</mounts>. That call returns a list of devices. " "This one returns a hash table (map) of device name to directory where the " @@ -16459,12 +16414,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4221 +#: ../fish/guestfish-actions.pod:4109 msgid "mounts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4223 +#: ../fish/guestfish-actions.pod:4111 #, no-wrap msgid "" " mounts\n" @@ -16472,29 +16427,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4225 ../src/guestfs-actions.pod:6673 +#: ../fish/guestfish-actions.pod:4113 ../src/guestfs-actions.pod:6452 msgid "" "This returns the list of currently mounted filesystems. It returns the list " "of devices (eg. C</dev/sda1>, C</dev/VG/LV>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4228 ../src/guestfs-actions.pod:6676 +#: ../fish/guestfish-actions.pod:4116 ../src/guestfs-actions.pod:6455 msgid "Some internal mounts are not shown." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4230 +#: ../fish/guestfish-actions.pod:4118 msgid "See also: L</mountpoints>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4232 +#: ../fish/guestfish-actions.pod:4120 msgid "mv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4234 +#: ../fish/guestfish-actions.pod:4122 #, no-wrap msgid "" " mv src dest\n" @@ -16502,19 +16457,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4236 ../src/guestfs-actions.pod:6693 +#: ../fish/guestfish-actions.pod:4124 ../src/guestfs-actions.pod:6472 msgid "" "This moves a file from C<src> to C<dest> where C<dest> is either a " "destination filename or destination directory." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4239 +#: ../fish/guestfish-actions.pod:4127 msgid "nr-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4241 +#: ../fish/guestfish-actions.pod:4129 #, no-wrap msgid "" " nr-devices\n" @@ -16522,7 +16477,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4243 +#: ../fish/guestfish-actions.pod:4131 msgid "" "This returns the number of whole block devices that were added. This is the " "same as the number of devices that would be returned if you called " @@ -16530,19 +16485,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4247 +#: ../fish/guestfish-actions.pod:4135 msgid "" "To find out the maximum number of devices that could be added, call " "L</max-disks>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4250 +#: ../fish/guestfish-actions.pod:4138 msgid "ntfs-3g-probe" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4252 +#: ../fish/guestfish-actions.pod:4140 #, no-wrap msgid "" " ntfs-3g-probe true|false device\n" @@ -16550,7 +16505,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4254 ../src/guestfs-actions.pod:6721 +#: ../fish/guestfish-actions.pod:4142 ../src/guestfs-actions.pod:6500 msgid "" "This command runs the L<ntfs-3g.probe(8)> command which probes an NTFS " "C<device> for mountability. (Not all NTFS volumes can be mounted " @@ -16558,7 +16513,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4258 ../src/guestfs-actions.pod:6725 +#: ../fish/guestfish-actions.pod:4146 ../src/guestfs-actions.pod:6504 msgid "" "C<rw> is a boolean flag. Set it to true if you want to test if the volume " "can be mounted read-write. Set it to false if you want to test if the " @@ -16566,19 +16521,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4262 ../src/guestfs-actions.pod:6729 +#: ../fish/guestfish-actions.pod:4150 ../src/guestfs-actions.pod:6508 msgid "" "The return value is an integer which C<0> if the operation would succeed, or " "some non-zero value documented in the L<ntfs-3g.probe(8)> manual page." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4266 +#: ../fish/guestfish-actions.pod:4154 msgid "ntfsclone-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4268 +#: ../fish/guestfish-actions.pod:4156 #, no-wrap msgid "" " ntfsclone-in (backupfile|-) device\n" @@ -16586,19 +16541,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4270 +#: ../fish/guestfish-actions.pod:4158 msgid "" "Restore the C<backupfile> (from a previous call to L</ntfsclone-out>) to " "C<device>, overwriting any existing contents of this device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4276 +#: ../fish/guestfish-actions.pod:4164 msgid "ntfsclone-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4278 +#: ../fish/guestfish-actions.pod:4166 #, no-wrap msgid "" " ntfsclone-out device (backupfile|-) [metadataonly:true|false] " @@ -16608,7 +16563,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4280 ../src/guestfs-actions.pod:6771 +#: ../fish/guestfish-actions.pod:4168 ../src/guestfs-actions.pod:6550 msgid "" "Stream the NTFS filesystem C<device> to the local file C<backupfile>. The " "format used for the backup file is a special format used by the " @@ -16616,7 +16571,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4284 ../src/guestfs-actions.pod:6775 +#: ../fish/guestfish-actions.pod:4172 ../src/guestfs-actions.pod:6554 msgid "" "If the optional C<metadataonly> flag is true, then I<only> the metadata is " "saved, losing all the user data (this is useful for diagnosing some " @@ -16624,24 +16579,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4288 ../src/guestfs-actions.pod:6779 +#: ../fish/guestfish-actions.pod:4176 ../src/guestfs-actions.pod:6558 msgid "" "The optional C<rescue>, C<ignorefscheck>, C<preservetimestamps> and C<force> " "flags have precise meanings detailed in the L<ntfsclone(8)> man page." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4292 +#: ../fish/guestfish-actions.pod:4180 msgid "Use L</ntfsclone-in> to restore the file back to a libguestfs device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4299 +#: ../fish/guestfish-actions.pod:4187 msgid "ntfsfix" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4301 +#: ../fish/guestfish-actions.pod:4189 #, no-wrap msgid "" " ntfsfix device [clearbadsectors:true|false]\n" @@ -16649,7 +16604,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4303 ../src/guestfs-actions.pod:6828 +#: ../fish/guestfish-actions.pod:4191 ../src/guestfs-actions.pod:6607 msgid "" "This command repairs some fundamental NTFS inconsistencies, resets the NTFS " "journal file, and schedules an NTFS consistency check for the first boot " @@ -16657,85 +16612,111 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4307 ../src/guestfs-actions.pod:6832 +#: ../fish/guestfish-actions.pod:4195 ../src/guestfs-actions.pod:6611 msgid "" "This is I<not> an equivalent of Windows C<chkdsk>. It does I<not> scan the " "filesystem for inconsistencies." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4310 ../src/guestfs-actions.pod:6835 +#: ../fish/guestfish-actions.pod:4198 ../src/guestfs-actions.pod:6614 msgid "" "The optional C<clearbadsectors> flag clears the list of bad sectors. This " "is useful after cloning a disk with bad sectors to a new disk." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4315 +#: ../fish/guestfish-actions.pod:4203 msgid "ntfsresize" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:4317 -msgid "ntfsresize-opts" -msgstr "" - #. type: verbatim -#: ../fish/guestfish-actions.pod:4319 +#: ../fish/guestfish-actions.pod:4205 #, no-wrap msgid "" -" ntfsresize device [size:N] [force:true|false]\n" +" ntfsresize device\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4321 ../src/guestfs-actions.pod:6892 +#: ../fish/guestfish-actions.pod:4207 ../fish/guestfish-actions.pod:4231 ../src/guestfs-actions.pod:6656 ../src/guestfs-actions.pod:6688 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:4330 ../src/guestfs-actions.pod:6901 +#: ../fish/guestfish-actions.pod:4210 ../src/guestfs-actions.pod:6659 +msgid "" +"I<Note:> After the resize operation, the filesystem is marked as requiring a " +"consistency check (for safety). You have to boot into Windows to perform " +"this check and clear this condition. Furthermore, ntfsresize refuses to " +"resize filesystems which have been marked in this way. So in effect it is " +"not possible to call ntfsresize multiple times on a single filesystem " +"without booting into Windows between each resize." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:4218 ../fish/guestfish-actions.pod:4257 ../src/guestfs-actions.pod:6667 ../src/guestfs-actions.pod:6714 +msgid "See also L<ntfsresize(8)>." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:4220 ../fish/guestfish-actions.pod:4268 +msgid "" +"I<This function is deprecated.> In new code, use the L</ntfsresize_opts> " +"call instead." +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:4227 +msgid "ntfsresize-opts" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:4229 +#, no-wrap +msgid "" +" ntfsresize-opts device [size:N] [force:true|false]\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:4240 ../src/guestfs-actions.pod:6697 msgid "" "The new size (in bytes) of the filesystem. If omitted, the filesystem is " "resized to fit the container (eg. partition)." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4333 ../fish/guestfish-actions.pod:5777 ../src/guestfs-actions.pod:6904 ../src/guestfs-actions.pod:9059 +#: ../fish/guestfish-actions.pod:4243 ../fish/guestfish-actions.pod:5642 ../src/guestfs-actions.pod:6700 ../src/guestfs-actions.pod:8803 msgid "C<force>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4335 ../src/guestfs-actions.pod:6906 +#: ../fish/guestfish-actions.pod:4245 ../src/guestfs-actions.pod:6702 msgid "" "If this option is true, then force the resize of the filesystem even if the " "filesystem is marked as requiring a consistency check." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4338 +#: ../fish/guestfish-actions.pod:4248 msgid "" "After the resize operation, the filesystem is always marked as requiring a " "consistency check (for safety). You have to boot into Windows to perform " "this check and clear this condition. If you I<don't> set the C<force> " -"option then it is not possible to call L</ntfsresize> multiple times on a " -"single filesystem without booting into Windows between each resize." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:4347 ../src/guestfs-actions.pod:6918 -msgid "See also L<ntfsresize(8)>." +"option then it is not possible to call L</ntfsresize-opts> multiple times on " +"a single filesystem without booting into Windows between each resize." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4351 +#: ../fish/guestfish-actions.pod:4261 msgid "ntfsresize-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4353 +#: ../fish/guestfish-actions.pod:4263 #, no-wrap msgid "" " ntfsresize-size device size\n" @@ -16743,26 +16724,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4355 +#: ../fish/guestfish-actions.pod:4265 msgid "" "This command is the same as L</ntfsresize> except that it allows you to " "specify the new size (in bytes) explicitly." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:4358 -msgid "" -"I<This function is deprecated.> In new code, use the L</ntfsresize> call " -"instead." -msgstr "" - #. type: =head2 -#: ../fish/guestfish-actions.pod:4365 +#: ../fish/guestfish-actions.pod:4275 msgid "part-add" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4367 +#: ../fish/guestfish-actions.pod:4277 #, no-wrap msgid "" " part-add device prlogex startsect endsect\n" @@ -16770,14 +16744,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4369 +#: ../fish/guestfish-actions.pod:4279 msgid "" "This command adds a partition to C<device>. If there is no partition table " "on the device, call L</part-init> first." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4372 ../src/guestfs-actions.pod:6979 +#: ../fish/guestfish-actions.pod:4282 ../src/guestfs-actions.pod:6775 msgid "" "The C<prlogex> parameter is the type of partition. Normally you should pass " "C<p> or C<primary> here, but MBR partition tables also support C<l> (or " @@ -16785,7 +16759,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4377 ../src/guestfs-actions.pod:6984 +#: ../fish/guestfish-actions.pod:4287 ../src/guestfs-actions.pod:6780 msgid "" "C<startsect> and C<endsect> are the start and end of the partition in " "I<sectors>. C<endsect> may be negative, which means it counts backwards " @@ -16793,19 +16767,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4381 +#: ../fish/guestfish-actions.pod:4291 msgid "" "Creating a partition which covers the whole disk is not so easy. Use " "L</part-disk> to do that." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4384 +#: ../fish/guestfish-actions.pod:4294 msgid "part-del" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4386 +#: ../fish/guestfish-actions.pod:4296 #, no-wrap msgid "" " part-del device partnum\n" @@ -16813,24 +16787,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4388 ../src/guestfs-actions.pod:7002 +#: ../fish/guestfish-actions.pod:4298 ../src/guestfs-actions.pod:6798 msgid "This command deletes the partition numbered C<partnum> on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4390 ../src/guestfs-actions.pod:7004 +#: ../fish/guestfish-actions.pod:4300 ../src/guestfs-actions.pod:6800 msgid "" "Note that in the case of MBR partitioning, deleting an extended partition " "also deletes any logical partitions it contains." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4394 +#: ../fish/guestfish-actions.pod:4304 msgid "part-disk" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4396 +#: ../fish/guestfish-actions.pod:4306 #, no-wrap msgid "" " part-disk device parttype\n" @@ -16838,26 +16812,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4398 +#: ../fish/guestfish-actions.pod:4308 msgid "" "This command is simply a combination of L</part-init> followed by " "L</part-add> to create a single primary partition covering the whole disk." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4402 +#: ../fish/guestfish-actions.pod:4312 msgid "" "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other " "possible values are described in L</part-init>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4405 +#: ../fish/guestfish-actions.pod:4315 msgid "part-get-bootable" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4407 +#: ../fish/guestfish-actions.pod:4317 #, no-wrap msgid "" " part-get-bootable device partnum\n" @@ -16865,24 +16839,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4409 ../src/guestfs-actions.pod:7037 +#: ../fish/guestfish-actions.pod:4319 ../src/guestfs-actions.pod:6833 msgid "" "This command returns true if the partition C<partnum> on C<device> has the " "bootable flag set." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4412 +#: ../fish/guestfish-actions.pod:4322 msgid "See also L</part-set-bootable>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4414 +#: ../fish/guestfish-actions.pod:4324 msgid "part-get-mbr-id" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4416 +#: ../fish/guestfish-actions.pod:4326 #, no-wrap msgid "" " part-get-mbr-id device partnum\n" @@ -16890,14 +16864,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4418 ../src/guestfs-actions.pod:7053 +#: ../fish/guestfish-actions.pod:4328 ../src/guestfs-actions.pod:6849 msgid "" "Returns the MBR type byte (also known as the ID byte) from the numbered " "partition C<partnum>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4421 ../fish/guestfish-actions.pod:4565 +#: ../fish/guestfish-actions.pod:4331 ../fish/guestfish-actions.pod:4475 msgid "" "Note that only MBR (old DOS-style) partitions have type bytes. You will get " "undefined results for other partition table types (see " @@ -16905,12 +16879,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4425 +#: ../fish/guestfish-actions.pod:4335 msgid "part-get-parttype" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4427 +#: ../fish/guestfish-actions.pod:4337 #, no-wrap msgid "" " part-get-parttype device\n" @@ -16918,14 +16892,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4429 ../src/guestfs-actions.pod:7070 +#: ../fish/guestfish-actions.pod:4339 ../src/guestfs-actions.pod:6866 msgid "" "This command examines the partition table on C<device> and returns the " "partition table type (format) being used." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4432 +#: ../fish/guestfish-actions.pod:4342 msgid "" "Common return values include: C<msdos> (a DOS/Windows style MBR partition " "table), C<gpt> (a GPT/EFI-style partition table). Other values are " @@ -16933,12 +16907,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4437 +#: ../fish/guestfish-actions.pod:4347 msgid "part-init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4439 +#: ../fish/guestfish-actions.pod:4349 #, no-wrap msgid "" " part-init device parttype\n" @@ -16946,7 +16920,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4441 ../src/guestfs-actions.pod:7090 +#: ../fish/guestfish-actions.pod:4351 ../src/guestfs-actions.pod:6886 msgid "" "This creates an empty partition table on C<device> of one of the partition " "types listed below. Usually C<parttype> should be either C<msdos> or C<gpt> " @@ -16954,34 +16928,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4445 +#: ../fish/guestfish-actions.pod:4355 msgid "" "Initially there are no partitions. Following this, you should call " "L</part-add> for each partition required." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4448 ../src/guestfs-actions.pod:7097 +#: ../fish/guestfish-actions.pod:4358 ../src/guestfs-actions.pod:6893 msgid "Possible values for C<parttype> are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4452 ../src/guestfs-actions.pod:7101 +#: ../fish/guestfish-actions.pod:4362 ../src/guestfs-actions.pod:6897 msgid "B<efi>" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4454 ../src/guestfs-actions.pod:7103 +#: ../fish/guestfish-actions.pod:4364 ../src/guestfs-actions.pod:6899 msgid "B<gpt>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4456 ../src/guestfs-actions.pod:7105 +#: ../fish/guestfish-actions.pod:4366 ../src/guestfs-actions.pod:6901 msgid "Intel EFI / GPT partition table." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4458 ../src/guestfs-actions.pod:7107 +#: ../fish/guestfish-actions.pod:4368 ../src/guestfs-actions.pod:6903 msgid "" "This is recommended for >= 2 TB partitions that will be accessed from Linux " "and Intel-based Mac OS X. It also has limited backwards compatibility with " @@ -16989,17 +16963,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4462 ../src/guestfs-actions.pod:7111 +#: ../fish/guestfish-actions.pod:4372 ../src/guestfs-actions.pod:6907 msgid "B<mbr>" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4464 ../src/guestfs-actions.pod:7113 +#: ../fish/guestfish-actions.pod:4374 ../src/guestfs-actions.pod:6909 msgid "B<msdos>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4466 ../src/guestfs-actions.pod:7115 +#: ../fish/guestfish-actions.pod:4376 ../src/guestfs-actions.pod:6911 msgid "" "The standard PC \"Master Boot Record\" (MBR) format used by MS-DOS and " "Windows. This partition type will B<only> work for device sizes up to 2 " @@ -17007,102 +16981,102 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4473 ../src/guestfs-actions.pod:7122 +#: ../fish/guestfish-actions.pod:4383 ../src/guestfs-actions.pod:6918 msgid "Other partition table types that may work but are not supported include:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4478 ../src/guestfs-actions.pod:7127 +#: ../fish/guestfish-actions.pod:4388 ../src/guestfs-actions.pod:6923 msgid "B<aix>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4480 ../src/guestfs-actions.pod:7129 +#: ../fish/guestfish-actions.pod:4390 ../src/guestfs-actions.pod:6925 msgid "AIX disk labels." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4482 ../src/guestfs-actions.pod:7131 +#: ../fish/guestfish-actions.pod:4392 ../src/guestfs-actions.pod:6927 msgid "B<amiga>" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4484 ../src/guestfs-actions.pod:7133 +#: ../fish/guestfish-actions.pod:4394 ../src/guestfs-actions.pod:6929 msgid "B<rdb>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4486 ../src/guestfs-actions.pod:7135 +#: ../fish/guestfish-actions.pod:4396 ../src/guestfs-actions.pod:6931 msgid "Amiga \"Rigid Disk Block\" format." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4488 ../src/guestfs-actions.pod:7137 +#: ../fish/guestfish-actions.pod:4398 ../src/guestfs-actions.pod:6933 msgid "B<bsd>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4490 ../src/guestfs-actions.pod:7139 +#: ../fish/guestfish-actions.pod:4400 ../src/guestfs-actions.pod:6935 msgid "BSD disk labels." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4492 ../src/guestfs-actions.pod:7141 +#: ../fish/guestfish-actions.pod:4402 ../src/guestfs-actions.pod:6937 msgid "B<dasd>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4494 ../src/guestfs-actions.pod:7143 +#: ../fish/guestfish-actions.pod:4404 ../src/guestfs-actions.pod:6939 msgid "DASD, used on IBM mainframes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4496 ../src/guestfs-actions.pod:7145 +#: ../fish/guestfish-actions.pod:4406 ../src/guestfs-actions.pod:6941 msgid "B<dvh>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4498 ../src/guestfs-actions.pod:7147 +#: ../fish/guestfish-actions.pod:4408 ../src/guestfs-actions.pod:6943 msgid "MIPS/SGI volumes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4500 ../src/guestfs-actions.pod:7149 +#: ../fish/guestfish-actions.pod:4410 ../src/guestfs-actions.pod:6945 msgid "B<mac>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4502 ../src/guestfs-actions.pod:7151 +#: ../fish/guestfish-actions.pod:4412 ../src/guestfs-actions.pod:6947 msgid "Old Mac partition format. Modern Macs use C<gpt>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4504 ../src/guestfs-actions.pod:7153 +#: ../fish/guestfish-actions.pod:4414 ../src/guestfs-actions.pod:6949 msgid "B<pc98>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4506 ../src/guestfs-actions.pod:7155 +#: ../fish/guestfish-actions.pod:4416 ../src/guestfs-actions.pod:6951 msgid "NEC PC-98 format, common in Japan apparently." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4508 ../src/guestfs-actions.pod:7157 +#: ../fish/guestfish-actions.pod:4418 ../src/guestfs-actions.pod:6953 msgid "B<sun>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4510 ../src/guestfs-actions.pod:7159 +#: ../fish/guestfish-actions.pod:4420 ../src/guestfs-actions.pod:6955 msgid "Sun disk labels." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4514 +#: ../fish/guestfish-actions.pod:4424 msgid "part-list" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4516 +#: ../fish/guestfish-actions.pod:4426 #, no-wrap msgid "" " part-list device\n" @@ -17110,66 +17084,66 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4518 ../src/guestfs-actions.pod:7173 +#: ../fish/guestfish-actions.pod:4428 ../src/guestfs-actions.pod:6969 msgid "" "This command parses the partition table on C<device> and returns the list of " "partitions found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4521 ../src/guestfs-actions.pod:7176 +#: ../fish/guestfish-actions.pod:4431 ../src/guestfs-actions.pod:6972 msgid "The fields in the returned structure are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4525 ../src/guestfs-actions.pod:7180 +#: ../fish/guestfish-actions.pod:4435 ../src/guestfs-actions.pod:6976 msgid "B<part_num>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4527 ../src/guestfs-actions.pod:7182 +#: ../fish/guestfish-actions.pod:4437 ../src/guestfs-actions.pod:6978 msgid "Partition number, counting from 1." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4529 ../src/guestfs-actions.pod:7184 +#: ../fish/guestfish-actions.pod:4439 ../src/guestfs-actions.pod:6980 msgid "B<part_start>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4531 +#: ../fish/guestfish-actions.pod:4441 msgid "" "Start of the partition I<in bytes>. To get sectors you have to divide by " "the device's sector size, see L</blockdev-getss>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4534 ../src/guestfs-actions.pod:7189 +#: ../fish/guestfish-actions.pod:4444 ../src/guestfs-actions.pod:6985 msgid "B<part_end>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4536 ../src/guestfs-actions.pod:7191 +#: ../fish/guestfish-actions.pod:4446 ../src/guestfs-actions.pod:6987 msgid "End of the partition in bytes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4538 ../src/guestfs-actions.pod:7193 +#: ../fish/guestfish-actions.pod:4448 ../src/guestfs-actions.pod:6989 msgid "B<part_size>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4540 ../src/guestfs-actions.pod:7195 +#: ../fish/guestfish-actions.pod:4450 ../src/guestfs-actions.pod:6991 msgid "Size of the partition in bytes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4544 +#: ../fish/guestfish-actions.pod:4454 msgid "part-set-bootable" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4546 +#: ../fish/guestfish-actions.pod:4456 #, no-wrap msgid "" " part-set-bootable device partnum true|false\n" @@ -17177,14 +17151,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4548 ../src/guestfs-actions.pod:7213 +#: ../fish/guestfish-actions.pod:4458 ../src/guestfs-actions.pod:7009 msgid "" "This sets the bootable flag on partition numbered C<partnum> on device " "C<device>. Note that partitions are numbered from 1." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4551 ../src/guestfs-actions.pod:7216 +#: ../fish/guestfish-actions.pod:4461 ../src/guestfs-actions.pod:7012 msgid "" "The bootable flag is used by some operating systems (notably Windows) to " "determine which partition to boot from. It is by no means universally " @@ -17192,12 +17166,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4555 +#: ../fish/guestfish-actions.pod:4465 msgid "part-set-mbr-id" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4557 +#: ../fish/guestfish-actions.pod:4467 #, no-wrap msgid "" " part-set-mbr-id device partnum idbyte\n" @@ -17205,7 +17179,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4559 ../src/guestfs-actions.pod:7232 +#: ../fish/guestfish-actions.pod:4469 ../src/guestfs-actions.pod:7028 msgid "" "Sets the MBR type byte (also known as the ID byte) of the numbered partition " "C<partnum> to C<idbyte>. Note that the type bytes quoted in most " @@ -17214,12 +17188,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4569 +#: ../fish/guestfish-actions.pod:4479 msgid "part-set-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4571 +#: ../fish/guestfish-actions.pod:4481 #, no-wrap msgid "" " part-set-name device partnum name\n" @@ -17227,26 +17201,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4573 ../src/guestfs-actions.pod:7254 +#: ../fish/guestfish-actions.pod:4483 ../src/guestfs-actions.pod:7050 msgid "" "This sets the partition name on partition numbered C<partnum> on device " "C<device>. Note that partitions are numbered from 1." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4576 ../src/guestfs-actions.pod:7257 +#: ../fish/guestfish-actions.pod:4486 ../src/guestfs-actions.pod:7053 msgid "" "The partition name can only be set on certain types of partition table. " "This works on C<gpt> but not on C<mbr> partitions." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4579 +#: ../fish/guestfish-actions.pod:4489 msgid "part-to-dev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4581 +#: ../fish/guestfish-actions.pod:4491 #, no-wrap msgid "" " part-to-dev partition\n" @@ -17254,31 +17228,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4583 ../src/guestfs-actions.pod:7270 +#: ../fish/guestfish-actions.pod:4493 ../src/guestfs-actions.pod:7066 msgid "" "This function takes a partition name (eg. \"/dev/sdb1\") and removes the " "partition number, returning the device name (eg. \"/dev/sdb\")." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4587 ../fish/guestfish-actions.pod:4599 +#: ../fish/guestfish-actions.pod:4497 ../fish/guestfish-actions.pod:4509 msgid "" "The named partition must exist, for example as a string returned from " "L</list-partitions>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4590 +#: ../fish/guestfish-actions.pod:4500 msgid "See also L</part-to-partnum>, L</device-index>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4592 +#: ../fish/guestfish-actions.pod:4502 msgid "part-to-partnum" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4594 +#: ../fish/guestfish-actions.pod:4504 #, no-wrap msgid "" " part-to-partnum partition\n" @@ -17286,24 +17260,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4596 ../src/guestfs-actions.pod:7290 +#: ../fish/guestfish-actions.pod:4506 ../src/guestfs-actions.pod:7086 msgid "" "This function takes a partition name (eg. \"/dev/sdb1\") and returns the " "partition number (eg. C<1>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4602 +#: ../fish/guestfish-actions.pod:4512 msgid "See also L</part-to-dev>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4604 +#: ../fish/guestfish-actions.pod:4514 msgid "ping-daemon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4606 +#: ../fish/guestfish-actions.pod:4516 #, no-wrap msgid "" " ping-daemon\n" @@ -17311,7 +17285,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4608 ../src/guestfs-actions.pod:7307 +#: ../fish/guestfish-actions.pod:4518 ../src/guestfs-actions.pod:7103 msgid "" "This is a test probe into the guestfs daemon running inside the qemu " "subprocess. Calling this function checks that the daemon responds to the " @@ -17320,12 +17294,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4613 +#: ../fish/guestfish-actions.pod:4523 msgid "pread" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4615 +#: ../fish/guestfish-actions.pod:4525 #, no-wrap msgid "" " pread path count offset\n" @@ -17333,31 +17307,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4617 ../src/guestfs-actions.pod:7325 +#: ../fish/guestfish-actions.pod:4527 ../src/guestfs-actions.pod:7121 msgid "" "This command lets you read part of a file. It reads C<count> bytes of the " "file, starting at C<offset>, from file C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4620 ../fish/guestfish-actions.pod:4635 ../src/guestfs-actions.pod:7328 ../src/guestfs-actions.pod:7354 +#: ../fish/guestfish-actions.pod:4530 ../fish/guestfish-actions.pod:4545 ../src/guestfs-actions.pod:7124 ../src/guestfs-actions.pod:7150 msgid "" "This may read fewer bytes than requested. For further details see the " "L<pread(2)> system call." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4623 +#: ../fish/guestfish-actions.pod:4533 msgid "See also L</pwrite>, L</pread-device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4628 +#: ../fish/guestfish-actions.pod:4538 msgid "pread-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4630 +#: ../fish/guestfish-actions.pod:4540 #, no-wrap msgid "" " pread-device device count offset\n" @@ -17365,60 +17339,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4632 ../src/guestfs-actions.pod:7351 +#: ../fish/guestfish-actions.pod:4542 ../src/guestfs-actions.pod:7147 msgid "" "This command lets you read part of a file. It reads C<count> bytes of " "C<device>, starting at C<offset>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4638 +#: ../fish/guestfish-actions.pod:4548 msgid "See also L</pread>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4643 -msgid "pvchange-uuid" -msgstr "" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:4645 -#, no-wrap -msgid "" -" pvchange-uuid device\n" -"\n" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:4647 ../src/guestfs-actions.pod:7374 -msgid "Generate a new random UUID for the physical volume C<device>." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:4649 -msgid "pvchange-uuid-all" -msgstr "" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:4651 -#, no-wrap -msgid "" -" pvchange-uuid-all\n" -"\n" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:4653 ../src/guestfs-actions.pod:7383 -msgid "Generate new random UUIDs for all physical volumes." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:4655 +#: ../fish/guestfish-actions.pod:4553 msgid "pvcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4657 +#: ../fish/guestfish-actions.pod:4555 #, no-wrap msgid "" " pvcreate device\n" @@ -17426,19 +17364,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4659 ../src/guestfs-actions.pod:7393 +#: ../fish/guestfish-actions.pod:4557 ../src/guestfs-actions.pod:7170 msgid "" "This creates an LVM physical volume on the named C<device>, where C<device> " "should usually be a partition name such as C</dev/sda1>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4663 +#: ../fish/guestfish-actions.pod:4561 msgid "pvremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4665 +#: ../fish/guestfish-actions.pod:4563 #, no-wrap msgid "" " pvremove device\n" @@ -17446,14 +17384,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4667 ../src/guestfs-actions.pod:7407 +#: ../fish/guestfish-actions.pod:4565 ../src/guestfs-actions.pod:7184 msgid "" "This wipes a physical volume C<device> so that LVM will no longer recognise " "it." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4670 ../src/guestfs-actions.pod:7410 +#: ../fish/guestfish-actions.pod:4568 ../src/guestfs-actions.pod:7187 msgid "" "The implementation uses the C<pvremove> command which refuses to wipe " "physical volumes that contain any volume groups, so you have to remove those " @@ -17461,12 +17399,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4674 +#: ../fish/guestfish-actions.pod:4572 msgid "pvresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4676 +#: ../fish/guestfish-actions.pod:4574 #, no-wrap msgid "" " pvresize device\n" @@ -17474,19 +17412,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4678 ../src/guestfs-actions.pod:7424 +#: ../fish/guestfish-actions.pod:4576 ../src/guestfs-actions.pod:7201 msgid "" "This resizes (expands or shrinks) an existing LVM physical volume to match " "the new size of the underlying device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4681 +#: ../fish/guestfish-actions.pod:4579 msgid "pvresize-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4683 +#: ../fish/guestfish-actions.pod:4581 #, no-wrap msgid "" " pvresize-size device size\n" @@ -17494,19 +17432,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4685 +#: ../fish/guestfish-actions.pod:4583 msgid "" "This command is the same as L</pvresize> except that it allows you to " "specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4688 +#: ../fish/guestfish-actions.pod:4586 msgid "pvs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4690 +#: ../fish/guestfish-actions.pod:4588 #, no-wrap msgid "" " pvs\n" @@ -17514,31 +17452,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4692 ../src/guestfs-actions.pod:7450 +#: ../fish/guestfish-actions.pod:4590 ../src/guestfs-actions.pod:7227 msgid "" "List all the physical volumes detected. This is the equivalent of the " "L<pvs(8)> command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4695 ../src/guestfs-actions.pod:7453 +#: ../fish/guestfish-actions.pod:4593 ../src/guestfs-actions.pod:7230 msgid "" "This returns a list of just the device names that contain PVs " "(eg. C</dev/sda2>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4698 +#: ../fish/guestfish-actions.pod:4596 msgid "See also L</pvs-full>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4700 +#: ../fish/guestfish-actions.pod:4598 msgid "pvs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4702 +#: ../fish/guestfish-actions.pod:4600 #, no-wrap msgid "" " pvs-full\n" @@ -17546,19 +17484,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4704 ../src/guestfs-actions.pod:7469 +#: ../fish/guestfish-actions.pod:4602 ../src/guestfs-actions.pod:7246 msgid "" "List all the physical volumes detected. This is the equivalent of the " "L<pvs(8)> command. The \"full\" version includes all fields." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4707 +#: ../fish/guestfish-actions.pod:4605 msgid "pvuuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4709 +#: ../fish/guestfish-actions.pod:4607 #, no-wrap msgid "" " pvuuid device\n" @@ -17566,17 +17504,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4711 ../src/guestfs-actions.pod:7484 +#: ../fish/guestfish-actions.pod:4609 ../src/guestfs-actions.pod:7261 msgid "This command returns the UUID of the LVM PV C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4713 +#: ../fish/guestfish-actions.pod:4611 msgid "pwrite" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4715 +#: ../fish/guestfish-actions.pod:4613 #, no-wrap msgid "" " pwrite path content offset\n" @@ -17584,14 +17522,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4717 ../src/guestfs-actions.pod:7500 +#: ../fish/guestfish-actions.pod:4615 ../src/guestfs-actions.pod:7277 msgid "" "This command writes to part of a file. It writes the data buffer C<content> " "to the file C<path> starting at offset C<offset>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4720 ../src/guestfs-actions.pod:7503 +#: ../fish/guestfish-actions.pod:4618 ../src/guestfs-actions.pod:7280 msgid "" "This command implements the L<pwrite(2)> system call, and like that system " "call it may not write the full data requested. The return value is the " @@ -17601,17 +17539,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4726 +#: ../fish/guestfish-actions.pod:4624 msgid "See also L</pread>, L</pwrite-device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4731 +#: ../fish/guestfish-actions.pod:4629 msgid "pwrite-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4733 +#: ../fish/guestfish-actions.pod:4631 #, no-wrap msgid "" " pwrite-device device content offset\n" @@ -17619,14 +17557,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4735 ../src/guestfs-actions.pod:7527 +#: ../fish/guestfish-actions.pod:4633 ../src/guestfs-actions.pod:7304 msgid "" "This command writes to part of a device. It writes the data buffer " "C<content> to C<device> starting at offset C<offset>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4738 ../src/guestfs-actions.pod:7530 +#: ../fish/guestfish-actions.pod:4636 ../src/guestfs-actions.pod:7307 msgid "" "This command implements the L<pwrite(2)> system call, and like that system " "call it may not write the full data requested (although short writes to disk " @@ -17634,17 +17572,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4743 +#: ../fish/guestfish-actions.pod:4641 msgid "See also L</pwrite>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4748 +#: ../fish/guestfish-actions.pod:4646 msgid "read-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4750 +#: ../fish/guestfish-actions.pod:4648 #, no-wrap msgid "" " read-file path\n" @@ -17652,12 +17590,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4752 ../src/guestfs-actions.pod:7551 +#: ../fish/guestfish-actions.pod:4650 ../src/guestfs-actions.pod:7328 msgid "This calls returns the contents of the file C<path> as a buffer." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4755 +#: ../fish/guestfish-actions.pod:4653 msgid "" "Unlike L</cat>, this function can correctly handle files that contain " "embedded ASCII NUL characters. However unlike L</download>, this function " @@ -17665,12 +17603,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4763 +#: ../fish/guestfish-actions.pod:4661 msgid "read-lines" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4765 +#: ../fish/guestfish-actions.pod:4663 #, no-wrap msgid "" " read-lines path\n" @@ -17678,14 +17616,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4769 ../src/guestfs-actions.pod:7576 +#: ../fish/guestfish-actions.pod:4667 ../src/guestfs-actions.pod:7353 msgid "" "The file contents are returned as a list of lines. Trailing C<LF> and " "C<CRLF> character sequences are I<not> returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4772 +#: ../fish/guestfish-actions.pod:4670 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of line). For " @@ -17694,12 +17632,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4777 +#: ../fish/guestfish-actions.pod:4675 msgid "readdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4779 +#: ../fish/guestfish-actions.pod:4677 #, no-wrap msgid "" " readdir dir\n" @@ -17707,12 +17645,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4781 ../src/guestfs-actions.pod:7596 +#: ../fish/guestfish-actions.pod:4679 ../src/guestfs-actions.pod:7373 msgid "This returns the list of directory entries in directory C<dir>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4783 ../src/guestfs-actions.pod:7598 +#: ../fish/guestfish-actions.pod:4681 ../src/guestfs-actions.pod:7375 msgid "" "All entries in the directory are returned, including C<.> and C<..>. The " "entries are I<not> sorted, but returned in the same order as the underlying " @@ -17720,84 +17658,84 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4787 ../src/guestfs-actions.pod:7602 +#: ../fish/guestfish-actions.pod:4685 ../src/guestfs-actions.pod:7379 msgid "" "Also this call returns basic file type information about each file. The " "C<ftyp> field will contain one of the following characters:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4792 ../src/guestfs-actions.pod:7607 +#: ../fish/guestfish-actions.pod:4690 ../src/guestfs-actions.pod:7384 msgid "'b'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4794 ../src/guestfs-actions.pod:7609 +#: ../fish/guestfish-actions.pod:4692 ../src/guestfs-actions.pod:7386 msgid "Block special" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4798 ../src/guestfs-actions.pod:7613 +#: ../fish/guestfish-actions.pod:4696 ../src/guestfs-actions.pod:7390 msgid "Char special" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4802 ../src/guestfs-actions.pod:7617 +#: ../fish/guestfish-actions.pod:4700 ../src/guestfs-actions.pod:7394 msgid "Directory" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4804 ../src/guestfs-actions.pod:7619 +#: ../fish/guestfish-actions.pod:4702 ../src/guestfs-actions.pod:7396 msgid "'f'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4806 ../src/guestfs-actions.pod:7621 +#: ../fish/guestfish-actions.pod:4704 ../src/guestfs-actions.pod:7398 msgid "FIFO (named pipe)" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4808 ../src/guestfs-actions.pod:7623 +#: ../fish/guestfish-actions.pod:4706 ../src/guestfs-actions.pod:7400 msgid "'l'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4810 ../src/guestfs-actions.pod:7625 +#: ../fish/guestfish-actions.pod:4708 ../src/guestfs-actions.pod:7402 msgid "Symbolic link" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4812 ../src/guestfs-actions.pod:7627 +#: ../fish/guestfish-actions.pod:4710 ../src/guestfs-actions.pod:7404 msgid "'r'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4814 ../src/guestfs-actions.pod:7629 +#: ../fish/guestfish-actions.pod:4712 ../src/guestfs-actions.pod:7406 msgid "Regular file" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4818 ../src/guestfs-actions.pod:7633 +#: ../fish/guestfish-actions.pod:4716 ../src/guestfs-actions.pod:7410 msgid "Socket" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4822 ../src/guestfs-actions.pod:7637 +#: ../fish/guestfish-actions.pod:4720 ../src/guestfs-actions.pod:7414 msgid "Unknown file type" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4824 ../src/guestfs-actions.pod:7639 +#: ../fish/guestfish-actions.pod:4722 ../src/guestfs-actions.pod:7416 msgid "'?'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4826 ../src/guestfs-actions.pod:7641 +#: ../fish/guestfish-actions.pod:4724 ../src/guestfs-actions.pod:7418 msgid "The L<readdir(3)> call returned a C<d_type> field with an unexpected value" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4831 +#: ../fish/guestfish-actions.pod:4729 msgid "" "This function is primarily intended for use by programs. To get a simple " "list of names, use L</ls>. To get a printable directory for human " @@ -17805,12 +17743,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4835 +#: ../fish/guestfish-actions.pod:4733 msgid "readlink" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4837 +#: ../fish/guestfish-actions.pod:4735 #, no-wrap msgid "" " readlink path\n" @@ -17818,17 +17756,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4839 ../src/guestfs-actions.pod:7662 +#: ../fish/guestfish-actions.pod:4737 ../src/guestfs-actions.pod:7439 msgid "This command reads the target of a symbolic link." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4841 +#: ../fish/guestfish-actions.pod:4739 msgid "readlinklist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4843 +#: ../fish/guestfish-actions.pod:4741 #, no-wrap msgid "" " readlinklist path 'names ...'\n" @@ -17836,7 +17774,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4845 ../src/guestfs-actions.pod:7676 +#: ../fish/guestfish-actions.pod:4743 ../src/guestfs-actions.pod:7453 msgid "" "This call allows you to do a C<readlink> operation on multiple files, where " "all files are in the directory C<path>. C<names> is the list of files from " @@ -17844,14 +17782,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4849 ../src/guestfs-actions.pod:7680 +#: ../fish/guestfish-actions.pod:4747 ../src/guestfs-actions.pod:7457 msgid "" "On return you get a list of strings, with a one-to-one correspondence to the " "C<names> list. Each string is the value of the symbolic link." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4853 ../src/guestfs-actions.pod:7684 +#: ../fish/guestfish-actions.pod:4751 ../src/guestfs-actions.pod:7461 msgid "" "If the C<readlink(2)> operation fails on any name, then the corresponding " "result string is the empty string C<\"\">. However the whole operation is " @@ -17861,7 +17799,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4860 ../src/guestfs-actions.pod:7691 +#: ../fish/guestfish-actions.pod:4758 ../src/guestfs-actions.pod:7468 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. Very long directory listings " @@ -17870,12 +17808,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4867 +#: ../fish/guestfish-actions.pod:4765 msgid "realpath" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4869 +#: ../fish/guestfish-actions.pod:4767 #, no-wrap msgid "" " realpath path\n" @@ -17883,19 +17821,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4871 ../src/guestfs-actions.pod:7710 +#: ../fish/guestfish-actions.pod:4769 ../src/guestfs-actions.pod:7487 msgid "" "Return the canonicalized absolute pathname of C<path>. The returned path " "has no C<.>, C<..> or symbolic link path elements." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4874 +#: ../fish/guestfish-actions.pod:4772 msgid "removexattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4876 +#: ../fish/guestfish-actions.pod:4774 #, no-wrap msgid "" " removexattr xattr path\n" @@ -17903,22 +17841,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4878 ../src/guestfs-actions.pod:7725 +#: ../fish/guestfish-actions.pod:4776 ../src/guestfs-actions.pod:7502 msgid "This call removes the extended attribute named C<xattr> of the file C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4881 +#: ../fish/guestfish-actions.pod:4779 msgid "See also: L</lremovexattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4883 +#: ../fish/guestfish-actions.pod:4781 msgid "resize2fs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4885 +#: ../fish/guestfish-actions.pod:4783 #, no-wrap msgid "" " resize2fs device\n" @@ -17926,24 +17864,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4887 ../src/guestfs-actions.pod:7740 +#: ../fish/guestfish-actions.pod:4785 ../src/guestfs-actions.pod:7517 msgid "" "This resizes an ext2, ext3 or ext4 filesystem to match the size of the " "underlying device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4890 ../fish/guestfish-actions.pod:4905 ../fish/guestfish-actions.pod:4914 ../src/guestfs-actions.pod:7743 ../src/guestfs-actions.pod:7764 ../src/guestfs-actions.pod:7780 +#: ../fish/guestfish-actions.pod:4788 ../fish/guestfish-actions.pod:4803 ../fish/guestfish-actions.pod:4812 ../src/guestfs-actions.pod:7520 ../src/guestfs-actions.pod:7541 ../src/guestfs-actions.pod:7557 msgid "See also L<guestfs(3)/RESIZE2FS ERRORS>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4892 +#: ../fish/guestfish-actions.pod:4790 msgid "resize2fs-M" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4894 +#: ../fish/guestfish-actions.pod:4792 #, no-wrap msgid "" " resize2fs-M device\n" @@ -17951,7 +17889,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4896 +#: ../fish/guestfish-actions.pod:4794 msgid "" "This command is the same as L</resize2fs>, but the filesystem is resized to " "its minimum size. This works like the I<-M> option to the C<resize2fs> " @@ -17959,7 +17897,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4900 +#: ../fish/guestfish-actions.pod:4798 msgid "" "To get the resulting size of the filesystem you should call L</tune2fs-l> " "and read the C<Block size> and C<Block count> values. These two numbers, " @@ -17968,12 +17906,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4907 +#: ../fish/guestfish-actions.pod:4805 msgid "resize2fs-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4909 +#: ../fish/guestfish-actions.pod:4807 #, no-wrap msgid "" " resize2fs-size device size\n" @@ -17981,19 +17919,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4911 +#: ../fish/guestfish-actions.pod:4809 msgid "" "This command is the same as L</resize2fs> except that it allows you to " "specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4916 +#: ../fish/guestfish-actions.pod:4814 msgid "rm" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4918 +#: ../fish/guestfish-actions.pod:4816 #, no-wrap msgid "" " rm path\n" @@ -18001,17 +17939,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4920 ../src/guestfs-actions.pod:7792 +#: ../fish/guestfish-actions.pod:4818 ../src/guestfs-actions.pod:7569 msgid "Remove the single file C<path>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4922 +#: ../fish/guestfish-actions.pod:4820 msgid "rm-rf" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4924 +#: ../fish/guestfish-actions.pod:4822 #, no-wrap msgid "" " rm-rf path\n" @@ -18019,19 +17957,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4926 ../src/guestfs-actions.pod:7804 +#: ../fish/guestfish-actions.pod:4824 ../src/guestfs-actions.pod:7581 msgid "" "Remove the file or directory C<path>, recursively removing the contents if " "its a directory. This is like the C<rm -rf> shell command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4930 +#: ../fish/guestfish-actions.pod:4828 msgid "rmdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4932 +#: ../fish/guestfish-actions.pod:4830 #, no-wrap msgid "" " rmdir path\n" @@ -18039,17 +17977,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4934 ../src/guestfs-actions.pod:7818 +#: ../fish/guestfish-actions.pod:4832 ../src/guestfs-actions.pod:7595 msgid "Remove the single directory C<path>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4936 +#: ../fish/guestfish-actions.pod:4834 msgid "rmmountpoint" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4938 +#: ../fish/guestfish-actions.pod:4836 #, no-wrap msgid "" " rmmountpoint exemptpath\n" @@ -18057,19 +17995,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4940 +#: ../fish/guestfish-actions.pod:4838 msgid "" "This calls removes a mountpoint that was previously created with " "L</mkmountpoint>. See L</mkmountpoint> for full details." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4944 +#: ../fish/guestfish-actions.pod:4842 msgid "scrub-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4946 +#: ../fish/guestfish-actions.pod:4844 #, no-wrap msgid "" " scrub-device device\n" @@ -18077,26 +18015,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4948 ../src/guestfs-actions.pod:7844 +#: ../fish/guestfish-actions.pod:4846 ../src/guestfs-actions.pod:7621 msgid "" "This command writes patterns over C<device> to make data retrieval more " "difficult." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4951 ../fish/guestfish-actions.pod:4963 ../fish/guestfish-actions.pod:4976 ../src/guestfs-actions.pod:7847 ../src/guestfs-actions.pod:7865 ../src/guestfs-actions.pod:7884 +#: ../fish/guestfish-actions.pod:4849 ../fish/guestfish-actions.pod:4861 ../fish/guestfish-actions.pod:4874 ../src/guestfs-actions.pod:7624 ../src/guestfs-actions.pod:7642 ../src/guestfs-actions.pod:7661 msgid "" "It is an interface to the L<scrub(1)> program. See that manual page for " "more details." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4954 +#: ../fish/guestfish-actions.pod:4852 msgid "scrub-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4956 +#: ../fish/guestfish-actions.pod:4854 #, no-wrap msgid "" " scrub-file file\n" @@ -18104,24 +18042,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4958 ../src/guestfs-actions.pod:7860 +#: ../fish/guestfish-actions.pod:4856 ../src/guestfs-actions.pod:7637 msgid "" "This command writes patterns over a file to make data retrieval more " "difficult." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4961 ../src/guestfs-actions.pod:7863 +#: ../fish/guestfish-actions.pod:4859 ../src/guestfs-actions.pod:7640 msgid "The file is I<removed> after scrubbing." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4966 +#: ../fish/guestfish-actions.pod:4864 msgid "scrub-freespace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4968 +#: ../fish/guestfish-actions.pod:4866 #, no-wrap msgid "" " scrub-freespace dir\n" @@ -18129,7 +18067,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4970 +#: ../fish/guestfish-actions.pod:4868 msgid "" "This command creates the directory C<dir> and then fills it with files until " "the filesystem is full, and scrubs the files as for L</scrub-file>, and " @@ -18138,17 +18076,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4979 +#: ../fish/guestfish-actions.pod:4877 msgid "set-append" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4981 +#: ../fish/guestfish-actions.pod:4879 msgid "append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4983 +#: ../fish/guestfish-actions.pod:4881 #, no-wrap msgid "" " set-append append\n" @@ -18156,38 +18094,38 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4985 ../src/guestfs-actions.pod:7897 +#: ../fish/guestfish-actions.pod:4883 ../src/guestfs-actions.pod:7674 msgid "" "This function is used to add additional options to the guest kernel command " "line." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4988 ../src/guestfs-actions.pod:7900 +#: ../fish/guestfish-actions.pod:4886 ../src/guestfs-actions.pod:7677 msgid "" "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> " "environment variable." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4991 ../src/guestfs-actions.pod:7903 +#: ../fish/guestfish-actions.pod:4889 ../src/guestfs-actions.pod:7680 msgid "" "Setting C<append> to C<NULL> means I<no> additional options are passed " "(libguestfs always adds a few of its own)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4994 +#: ../fish/guestfish-actions.pod:4892 msgid "set-attach-method" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4996 +#: ../fish/guestfish-actions.pod:4894 msgid "attach-method" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4998 +#: ../fish/guestfish-actions.pod:4896 #, no-wrap msgid "" " set-attach-method attachmethod\n" @@ -18195,125 +18133,54 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5000 ../src/guestfs-actions.pod:7916 +#: ../fish/guestfish-actions.pod:4898 ../src/guestfs-actions.pod:7693 msgid "" "Set the method that libguestfs uses to connect to the back end guestfsd " -"daemon." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:5003 ../src/guestfs-actions.pod:7919 -msgid "Possible attach methods are:" +"daemon. Possible methods are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5007 ../src/guestfs-actions.pod:7923 ../src/guestfs.pod:3019 +#: ../fish/guestfish-actions.pod:4903 ../src/guestfs-actions.pod:7698 ../src/guestfs.pod:3090 msgid "C<appliance>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5009 ../src/guestfs-actions.pod:7925 -msgid "Launch an appliance and connect to it." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:5011 ../src/guestfs-actions.pod:7927 +#: ../fish/guestfish-actions.pod:4905 ../src/guestfs-actions.pod:7700 msgid "" -"This is the ordinary method and normally the default, but see the note " -"below." +"Launch an appliance and connect to it. This is the ordinary method and the " +"default." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5014 ../src/guestfs-actions.pod:7930 -msgid "C<libvirt>" -msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:5016 ../src/guestfs-actions.pod:7932 -msgid "C<libvirt:I<URI>>" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:5018 ../src/guestfs-actions.pod:7934 -msgid "" -"Use libvirt to launch the appliance. The optional I<URI> is the libvirt " -"connection URI to use (see L<http://libvirt.org/uri.html>)." -msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:5021 ../src/guestfs-actions.pod:7937 +#: ../fish/guestfish-actions.pod:4908 ../src/guestfs-actions.pod:7703 msgid "C<unix:I<path>>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5023 ../src/guestfs-actions.pod:7939 +#: ../fish/guestfish-actions.pod:4910 ../src/guestfs-actions.pod:7705 msgid "Connect to the Unix domain socket I<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5025 ../src/guestfs-actions.pod:7941 +#: ../fish/guestfish-actions.pod:4912 ../src/guestfs-actions.pod:7707 msgid "" "This method lets you connect to an existing daemon or (using virtio-serial) " "to a live guest. For more information, see L<guestfs(3)/ATTACHING TO " "RUNNING DAEMONS>." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:5031 ../src/guestfs-actions.pod:7947 -msgid "" -"C<appliance> is usually the default attach method. However since libguestfs " -"E<ge> 1.19.24 it has been possible to change the default in two ways:" -msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:5037 ../src/guestfs-actions.pod:7953 -msgid "Setting LIBGUESTFS_ATTACH_METHOD" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:5039 ../src/guestfs-actions.pod:7955 -msgid "Users can set this environment variable to change the default." -msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:5041 ../src/guestfs-actions.pod:7957 -msgid "Configuring the default attach method when building libguestfs" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:5043 ../src/guestfs-actions.pod:7959 -msgid "" -"Distributors can override the default when libguestfs is built (using " -"C<./configure --with-default-attach-method=...>)." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:5046 ../src/guestfs-actions.pod:7962 -msgid "" -"To find out if libguestfs was compiled with a different default attach " -"method, do:" -msgstr "" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:5049 ../src/guestfs-actions.pod:7965 -#, no-wrap -msgid "" -" guestfish get-attach-method\n" -"\n" -msgstr "" - #. type: =head2 -#: ../fish/guestfish-actions.pod:5053 +#: ../fish/guestfish-actions.pod:4918 msgid "set-autosync" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5055 +#: ../fish/guestfish-actions.pod:4920 msgid "autosync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5057 +#: ../fish/guestfish-actions.pod:4922 #, no-wrap msgid "" " set-autosync true|false\n" @@ -18321,7 +18188,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5059 ../src/guestfs-actions.pod:7979 +#: ../fish/guestfish-actions.pod:4924 ../src/guestfs-actions.pod:7723 msgid "" "If C<autosync> is true, this enables autosync. Libguestfs will make a best " "effort attempt to make filesystems consistent and synchronized when the " @@ -18329,24 +18196,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5064 ../src/guestfs-actions.pod:7984 +#: ../fish/guestfish-actions.pod:4929 ../src/guestfs-actions.pod:7728 msgid "" "This is enabled by default (since libguestfs 1.5.24, previously it was " "disabled by default)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5067 +#: ../fish/guestfish-actions.pod:4932 msgid "set-direct" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5069 +#: ../fish/guestfish-actions.pod:4934 msgid "direct" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5071 +#: ../fish/guestfish-actions.pod:4936 #, no-wrap msgid "" " set-direct true|false\n" @@ -18354,36 +18221,36 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5073 ../src/guestfs-actions.pod:7997 +#: ../fish/guestfish-actions.pod:4938 ../src/guestfs-actions.pod:7741 msgid "" "If the direct appliance mode flag is enabled, then stdin and stdout are " "passed directly through to the appliance once it is launched." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5077 +#: ../fish/guestfish-actions.pod:4942 msgid "" "One consequence of this is that log messages aren't caught by the library " "and handled by L</set-log-message-callback>, but go straight to stdout." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5081 ../src/guestfs-actions.pod:8005 +#: ../fish/guestfish-actions.pod:4946 ../src/guestfs-actions.pod:7749 msgid "You probably don't want to use this unless you know what you are doing." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5084 ../src/guestfs-actions.pod:8008 +#: ../fish/guestfish-actions.pod:4949 ../src/guestfs-actions.pod:7752 msgid "The default is disabled." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5086 +#: ../fish/guestfish-actions.pod:4951 msgid "set-e2attrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5088 +#: ../fish/guestfish-actions.pod:4953 #, no-wrap msgid "" " set-e2attrs file attrs [clear:true|false]\n" @@ -18391,14 +18258,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5090 ../src/guestfs-actions.pod:8029 +#: ../fish/guestfish-actions.pod:4955 ../src/guestfs-actions.pod:7773 msgid "" "This sets or clears the file attributes C<attrs> associated with the inode " "C<file>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5093 +#: ../fish/guestfish-actions.pod:4958 msgid "" "C<attrs> is a string of characters representing file attributes. See " "L</get-e2attrs> for a list of possible attributes. Not all attributes can " @@ -18406,31 +18273,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5097 ../src/guestfs-actions.pod:8036 +#: ../fish/guestfish-actions.pod:4962 ../src/guestfs-actions.pod:7780 msgid "" "If optional boolean C<clear> is not present or false, then the C<attrs> " "listed are set in the inode." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5100 ../src/guestfs-actions.pod:8039 +#: ../fish/guestfish-actions.pod:4965 ../src/guestfs-actions.pod:7783 msgid "If C<clear> is true, then the C<attrs> listed are cleared in the inode." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5103 ../src/guestfs-actions.pod:8042 +#: ../fish/guestfish-actions.pod:4968 ../src/guestfs-actions.pod:7786 msgid "" "In both cases, other attributes not present in the C<attrs> string are left " "unchanged." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5112 +#: ../fish/guestfish-actions.pod:4977 msgid "set-e2generation" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5114 +#: ../fish/guestfish-actions.pod:4979 #, no-wrap msgid "" " set-e2generation file generation\n" @@ -18438,22 +18305,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5116 ../src/guestfs-actions.pod:8084 +#: ../fish/guestfish-actions.pod:4981 ../src/guestfs-actions.pod:7828 msgid "This sets the ext2 file generation of a file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5118 +#: ../fish/guestfish-actions.pod:4983 msgid "See L</get-e2generation>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5120 +#: ../fish/guestfish-actions.pod:4985 msgid "set-e2label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5122 +#: ../fish/guestfish-actions.pod:4987 #, no-wrap msgid "" " set-e2label device label\n" @@ -18461,33 +18328,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5124 ../src/guestfs-actions.pod:8106 +#: ../fish/guestfish-actions.pod:4989 ../src/guestfs-actions.pod:7850 msgid "" "This sets the ext2/3/4 filesystem label of the filesystem on C<device> to " "C<label>. Filesystem labels are limited to 16 characters." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5128 +#: ../fish/guestfish-actions.pod:4993 msgid "" "You can use either L</tune2fs-l> or L</get-e2label> to return the existing " "label on a filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5131 +#: ../fish/guestfish-actions.pod:4996 msgid "" "I<This function is deprecated.> In new code, use the L</set_label> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5138 +#: ../fish/guestfish-actions.pod:5003 msgid "set-e2uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5140 +#: ../fish/guestfish-actions.pod:5005 #, no-wrap msgid "" " set-e2uuid device uuid\n" @@ -18495,7 +18362,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5142 ../src/guestfs-actions.pod:8124 +#: ../fish/guestfish-actions.pod:5007 ../src/guestfs-actions.pod:7868 msgid "" "This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to " "C<uuid>. The format of the UUID and alternatives such as C<clear>, " @@ -18503,19 +18370,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5147 +#: ../fish/guestfish-actions.pod:5012 msgid "" "You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing " "UUID of a filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5150 +#: ../fish/guestfish-actions.pod:5015 msgid "set-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5152 +#: ../fish/guestfish-actions.pod:5017 #, no-wrap msgid "" " set-label device label\n" @@ -18523,44 +18390,44 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5154 ../src/guestfs-actions.pod:8143 +#: ../fish/guestfish-actions.pod:5019 ../src/guestfs-actions.pod:7887 msgid "Set the filesystem label on C<device> to C<label>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5156 ../src/guestfs-actions.pod:8145 +#: ../fish/guestfish-actions.pod:5021 ../src/guestfs-actions.pod:7889 msgid "" "Only some filesystem types support labels, and libguestfs supports setting " "labels on only a subset of these." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5159 ../src/guestfs-actions.pod:8148 +#: ../fish/guestfish-actions.pod:5024 ../src/guestfs-actions.pod:7892 msgid "On ext2/3/4 filesystems, labels are limited to 16 bytes." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5161 ../src/guestfs-actions.pod:8150 +#: ../fish/guestfish-actions.pod:5026 ../src/guestfs-actions.pod:7894 msgid "On NTFS filesystems, labels are limited to 128 unicode characters." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5163 +#: ../fish/guestfish-actions.pod:5028 msgid "To read the label on a filesystem, call L</vfs-label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5165 +#: ../fish/guestfish-actions.pod:5030 msgid "set-memsize" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5167 +#: ../fish/guestfish-actions.pod:5032 msgid "memsize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5169 +#: ../fish/guestfish-actions.pod:5034 #, no-wrap msgid "" " set-memsize memsize\n" @@ -18568,31 +18435,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5171 +#: ../fish/guestfish-actions.pod:5036 msgid "" "This sets the memory size in megabytes allocated to the qemu subprocess. " "This only has any effect if called before L</launch>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5175 ../src/guestfs-actions.pod:8168 +#: ../fish/guestfish-actions.pod:5040 ../src/guestfs-actions.pod:7912 msgid "" "You can also change this by setting the environment variable " "C<LIBGUESTFS_MEMSIZE> before the handle is created." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5182 +#: ../fish/guestfish-actions.pod:5047 msgid "set-network" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5184 +#: ../fish/guestfish-actions.pod:5049 msgid "network" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5186 +#: ../fish/guestfish-actions.pod:5051 #, no-wrap msgid "" " set-network true|false\n" @@ -18600,31 +18467,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5188 ../src/guestfs-actions.pod:8185 +#: ../fish/guestfish-actions.pod:5053 ../src/guestfs-actions.pod:7929 msgid "" "If C<network> is true, then the network is enabled in the libguestfs " "appliance. The default is false." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5191 ../src/guestfs-actions.pod:8188 +#: ../fish/guestfish-actions.pod:5056 ../src/guestfs-actions.pod:7932 msgid "" "This affects whether commands are able to access the network (see " "L<guestfs(3)/RUNNING COMMANDS>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5194 +#: ../fish/guestfish-actions.pod:5059 msgid "You must call this before calling L</launch>, otherwise it has no effect." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5197 +#: ../fish/guestfish-actions.pod:5062 msgid "set-path" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5201 +#: ../fish/guestfish-actions.pod:5066 #, no-wrap msgid "" " set-path searchpath\n" @@ -18632,34 +18499,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5203 ../src/guestfs-actions.pod:8204 +#: ../fish/guestfish-actions.pod:5068 ../src/guestfs-actions.pod:7948 msgid "Set the path that libguestfs searches for kernel and initrd.img." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5205 ../src/guestfs-actions.pod:8206 +#: ../fish/guestfish-actions.pod:5070 ../src/guestfs-actions.pod:7950 msgid "" "The default is C<$libdir/guestfs> unless overridden by setting " "C<LIBGUESTFS_PATH> environment variable." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5208 ../src/guestfs-actions.pod:8209 +#: ../fish/guestfish-actions.pod:5073 ../src/guestfs-actions.pod:7953 msgid "Setting C<path> to C<NULL> restores the default path." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5210 +#: ../fish/guestfish-actions.pod:5075 msgid "set-pgroup" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5212 +#: ../fish/guestfish-actions.pod:5077 msgid "pgroup" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5214 +#: ../fish/guestfish-actions.pod:5079 #, no-wrap msgid "" " set-pgroup true|false\n" @@ -18667,21 +18534,21 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5216 ../src/guestfs-actions.pod:8221 +#: ../fish/guestfish-actions.pod:5081 ../src/guestfs-actions.pod:7965 msgid "" "If C<pgroup> is true, child processes are placed into their own process " "group." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5219 ../src/guestfs-actions.pod:8224 +#: ../fish/guestfish-actions.pod:5084 ../src/guestfs-actions.pod:7968 msgid "" "The practical upshot of this is that signals like C<SIGINT> (from users " "pressing C<^C>) won't be received by the child process." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5222 +#: ../fish/guestfish-actions.pod:5087 msgid "" "The default for this flag is false, because usually you want C<^C> to kill " "the subprocess. Guestfish sets this flag to true when used interactively, " @@ -18690,17 +18557,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5227 +#: ../fish/guestfish-actions.pod:5092 msgid "set-qemu" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5229 +#: ../fish/guestfish-actions.pod:5094 msgid "qemu" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5231 +#: ../fish/guestfish-actions.pod:5096 #, no-wrap msgid "" " set-qemu qemu\n" @@ -18708,29 +18575,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5233 ../src/guestfs-actions.pod:8242 +#: ../fish/guestfish-actions.pod:5098 ../src/guestfs-actions.pod:7986 msgid "Set the qemu binary that we will use." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5235 ../src/guestfs-actions.pod:8244 +#: ../fish/guestfish-actions.pod:5100 ../src/guestfs-actions.pod:7988 msgid "The default is chosen when the library was compiled by the configure script." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5238 ../src/guestfs-actions.pod:8247 +#: ../fish/guestfish-actions.pod:5103 ../src/guestfs-actions.pod:7991 msgid "" "You can also override this by setting the C<LIBGUESTFS_QEMU> environment " "variable." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5241 ../src/guestfs-actions.pod:8250 +#: ../fish/guestfish-actions.pod:5106 ../src/guestfs-actions.pod:7994 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5243 ../src/guestfs-actions.pod:8252 +#: ../fish/guestfish-actions.pod:5108 ../src/guestfs-actions.pod:7996 msgid "" "Note that you should call this function as early as possible after creating " "the handle. This is because some pre-launch operations depend on testing " @@ -18741,17 +18608,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5251 +#: ../fish/guestfish-actions.pod:5116 msgid "set-recovery-proc" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5253 +#: ../fish/guestfish-actions.pod:5118 msgid "recovery-proc" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5255 +#: ../fish/guestfish-actions.pod:5120 #, no-wrap msgid "" " set-recovery-proc true|false\n" @@ -18759,7 +18626,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5257 +#: ../fish/guestfish-actions.pod:5122 msgid "" "If this is called with the parameter C<false> then L</launch> does not " "create a recovery process. The purpose of the recovery process is to stop " @@ -18767,14 +18634,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5262 +#: ../fish/guestfish-actions.pod:5127 msgid "" "This only has any effect if called before L</launch>, and the default is " "true." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5265 ../src/guestfs-actions.pod:8278 +#: ../fish/guestfish-actions.pod:5130 ../src/guestfs-actions.pod:8022 msgid "" "About the only time when you would want to disable this is if the main " "process will fork itself into the background (\"daemonize\" itself). In " @@ -18783,17 +18650,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5271 +#: ../fish/guestfish-actions.pod:5136 msgid "set-selinux" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5273 +#: ../fish/guestfish-actions.pod:5138 msgid "selinux" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5275 +#: ../fish/guestfish-actions.pod:5140 #, no-wrap msgid "" " set-selinux true|false\n" @@ -18801,31 +18668,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5277 ../src/guestfs-actions.pod:8294 +#: ../fish/guestfish-actions.pod:5142 ../src/guestfs-actions.pod:8038 msgid "" "This sets the selinux flag that is passed to the appliance at boot time. " "The default is C<selinux=0> (disabled)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5280 ../src/guestfs-actions.pod:8297 +#: ../fish/guestfish-actions.pod:5145 ../src/guestfs-actions.pod:8041 msgid "" "Note that if SELinux is enabled, it is always in Permissive mode " "(C<enforcing=0>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5286 +#: ../fish/guestfish-actions.pod:5151 msgid "set-smp" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5288 +#: ../fish/guestfish-actions.pod:5153 msgid "smp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5290 +#: ../fish/guestfish-actions.pod:5155 #, no-wrap msgid "" " set-smp smp\n" @@ -18833,7 +18700,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5292 ../src/guestfs-actions.pod:8313 +#: ../fish/guestfish-actions.pod:5157 ../src/guestfs-actions.pod:8057 msgid "" "Change the number of virtual CPUs assigned to the appliance. The default is " "C<1>. Increasing this may improve performance, though often it has no " @@ -18841,22 +18708,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5296 +#: ../fish/guestfish-actions.pod:5161 msgid "This function must be called before L</launch>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5298 +#: ../fish/guestfish-actions.pod:5163 msgid "set-trace" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5300 +#: ../fish/guestfish-actions.pod:5165 msgid "trace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5302 +#: ../fish/guestfish-actions.pod:5167 #, no-wrap msgid "" " set-trace true|false\n" @@ -18864,45 +18731,45 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5304 ../src/guestfs-actions.pod:8329 +#: ../fish/guestfish-actions.pod:5169 ../src/guestfs-actions.pod:8073 msgid "" "If the command trace flag is set to 1, then libguestfs calls, parameters and " "return values are traced." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5307 ../src/guestfs-actions.pod:8332 +#: ../fish/guestfish-actions.pod:5172 ../src/guestfs-actions.pod:8076 msgid "" "If you want to trace C API calls into libguestfs (and other libraries) then " "possibly a better way is to use the external ltrace(1) command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5311 ../src/guestfs-actions.pod:8336 +#: ../fish/guestfish-actions.pod:5176 ../src/guestfs-actions.pod:8080 msgid "" "Command traces are disabled unless the environment variable " "C<LIBGUESTFS_TRACE> is defined and set to C<1>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5314 +#: ../fish/guestfish-actions.pod:5179 msgid "" "Trace messages are normally sent to C<stderr>, unless you register a " "callback to send them somewhere else (see L</set-event-callback>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5318 +#: ../fish/guestfish-actions.pod:5183 msgid "set-verbose" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5320 +#: ../fish/guestfish-actions.pod:5185 msgid "verbose" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5322 +#: ../fish/guestfish-actions.pod:5187 #, no-wrap msgid "" " set-verbose true|false\n" @@ -18910,31 +18777,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5324 ../src/guestfs-actions.pod:8353 +#: ../fish/guestfish-actions.pod:5189 ../src/guestfs-actions.pod:8097 msgid "If C<verbose> is true, this turns on verbose messages." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5326 ../src/guestfs-actions.pod:8355 +#: ../fish/guestfish-actions.pod:5191 ../src/guestfs-actions.pod:8099 msgid "" "Verbose messages are disabled unless the environment variable " "C<LIBGUESTFS_DEBUG> is defined and set to C<1>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5329 +#: ../fish/guestfish-actions.pod:5194 msgid "" "Verbose messages are normally sent to C<stderr>, unless you register a " "callback to send them somewhere else (see L</set-event-callback>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5333 +#: ../fish/guestfish-actions.pod:5198 msgid "setcon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5335 +#: ../fish/guestfish-actions.pod:5200 #, no-wrap msgid "" " setcon context\n" @@ -18942,24 +18809,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5337 ../src/guestfs-actions.pod:8372 +#: ../fish/guestfish-actions.pod:5202 ../src/guestfs-actions.pod:8116 msgid "" "This sets the SELinux security context of the daemon to the string " "C<context>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5340 ../src/guestfs-actions.pod:8375 +#: ../fish/guestfish-actions.pod:5205 ../src/guestfs-actions.pod:8119 msgid "See the documentation about SELINUX in L<guestfs(3)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5342 +#: ../fish/guestfish-actions.pod:5207 msgid "setxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5344 +#: ../fish/guestfish-actions.pod:5209 #, no-wrap msgid "" " setxattr xattr val vallen path\n" @@ -18967,24 +18834,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5346 ../src/guestfs-actions.pod:8390 +#: ../fish/guestfish-actions.pod:5211 ../src/guestfs-actions.pod:8134 msgid "" "This call sets the extended attribute named C<xattr> of the file C<path> to " "the value C<val> (of length C<vallen>). The value is arbitrary 8 bit data." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5350 +#: ../fish/guestfish-actions.pod:5215 msgid "See also: L</lsetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5352 +#: ../fish/guestfish-actions.pod:5217 msgid "sfdisk" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5354 +#: ../fish/guestfish-actions.pod:5219 #, no-wrap msgid "" " sfdisk device cyls heads sectors 'lines ...'\n" @@ -18992,19 +18859,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5356 ../src/guestfs-actions.pod:8417 +#: ../fish/guestfish-actions.pod:5221 ../src/guestfs-actions.pod:8161 msgid "" "This is a direct interface to the L<sfdisk(8)> program for creating " "partitions on block devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5359 ../src/guestfs-actions.pod:8420 +#: ../fish/guestfish-actions.pod:5224 ../src/guestfs-actions.pod:8164 msgid "C<device> should be a block device, for example C</dev/sda>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5361 ../src/guestfs-actions.pod:8422 +#: ../fish/guestfish-actions.pod:5226 ../src/guestfs-actions.pod:8166 msgid "" "C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and " "sectors on the device, which are passed directly to sfdisk as the I<-C>, " @@ -19015,14 +18882,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5369 ../src/guestfs-actions.pod:8430 +#: ../fish/guestfish-actions.pod:5234 ../src/guestfs-actions.pod:8174 msgid "" "C<lines> is a list of lines that we feed to C<sfdisk>. For more information " "refer to the L<sfdisk(8)> manpage." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5372 ../src/guestfs-actions.pod:8433 +#: ../fish/guestfish-actions.pod:5237 ../src/guestfs-actions.pod:8177 msgid "" "To create a single partition occupying the whole disk, you would pass " "C<lines> as a single element list, when the single element being the string " @@ -19030,24 +18897,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5376 +#: ../fish/guestfish-actions.pod:5241 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5379 ../fish/guestfish-actions.pod:5399 ../fish/guestfish-actions.pod:5418 +#: ../fish/guestfish-actions.pod:5244 ../fish/guestfish-actions.pod:5264 ../fish/guestfish-actions.pod:5283 msgid "" "I<This function is deprecated.> In new code, use the L</part_add> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5386 +#: ../fish/guestfish-actions.pod:5251 msgid "sfdiskM" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5388 +#: ../fish/guestfish-actions.pod:5253 #, no-wrap msgid "" " sfdiskM device 'lines ...'\n" @@ -19055,7 +18922,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5390 +#: ../fish/guestfish-actions.pod:5255 msgid "" "This is a simplified interface to the L</sfdisk> command, where partition " "sizes are specified in megabytes only (rounded to the nearest cylinder) and " @@ -19064,17 +18931,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5396 +#: ../fish/guestfish-actions.pod:5261 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5406 +#: ../fish/guestfish-actions.pod:5271 msgid "sfdisk-N" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5408 +#: ../fish/guestfish-actions.pod:5273 #, no-wrap msgid "" " sfdisk-N device partnum cyls heads sectors line\n" @@ -19082,31 +18949,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5410 ../src/guestfs-actions.pod:8489 +#: ../fish/guestfish-actions.pod:5275 ../src/guestfs-actions.pod:8233 msgid "" "This runs L<sfdisk(8)> option to modify just the single partition C<n> " "(note: C<n> counts from 1)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5413 +#: ../fish/guestfish-actions.pod:5278 msgid "" "For other parameters, see L</sfdisk>. You should usually pass C<0> for the " "cyls/heads/sectors parameters." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5416 +#: ../fish/guestfish-actions.pod:5281 msgid "See also: L</part-add>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5425 +#: ../fish/guestfish-actions.pod:5290 msgid "sfdisk-disk-geometry" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5427 +#: ../fish/guestfish-actions.pod:5292 #, no-wrap msgid "" " sfdisk-disk-geometry device\n" @@ -19114,7 +18981,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5429 +#: ../fish/guestfish-actions.pod:5294 msgid "" "This displays the disk geometry of C<device> read from the partition table. " "Especially in the case where the underlying block device has been resized, " @@ -19123,17 +18990,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5434 ../fish/guestfish-actions.pod:5443 ../src/guestfs-actions.pod:8512 ../src/guestfs-actions.pod:8528 +#: ../fish/guestfish-actions.pod:5299 ../fish/guestfish-actions.pod:5308 ../src/guestfs-actions.pod:8256 ../src/guestfs-actions.pod:8272 msgid "The result is in human-readable format, and not designed to be parsed." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5437 +#: ../fish/guestfish-actions.pod:5302 msgid "sfdisk-kernel-geometry" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5439 +#: ../fish/guestfish-actions.pod:5304 #, no-wrap msgid "" " sfdisk-kernel-geometry device\n" @@ -19141,17 +19008,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5441 ../src/guestfs-actions.pod:8526 +#: ../fish/guestfish-actions.pod:5306 ../src/guestfs-actions.pod:8270 msgid "This displays the kernel's idea of the geometry of C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5446 +#: ../fish/guestfish-actions.pod:5311 msgid "sfdisk-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5448 +#: ../fish/guestfish-actions.pod:5313 #, no-wrap msgid "" " sfdisk-l device\n" @@ -19159,31 +19026,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5450 ../src/guestfs-actions.pod:8549 +#: ../fish/guestfish-actions.pod:5315 ../src/guestfs-actions.pod:8293 msgid "" "This displays the partition table on C<device>, in the human-readable output " "of the L<sfdisk(8)> command. It is not intended to be parsed." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5454 +#: ../fish/guestfish-actions.pod:5319 msgid "See also: L</part-list>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5456 +#: ../fish/guestfish-actions.pod:5321 msgid "" "I<This function is deprecated.> In new code, use the L</part_list> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5463 +#: ../fish/guestfish-actions.pod:5328 msgid "sh" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5465 +#: ../fish/guestfish-actions.pod:5330 #, no-wrap msgid "" " sh command\n" @@ -19191,19 +19058,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5467 ../src/guestfs-actions.pod:8566 +#: ../fish/guestfish-actions.pod:5332 ../src/guestfs-actions.pod:8310 msgid "" "This call runs a command from the guest filesystem via the guest's " "C</bin/sh>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5470 +#: ../fish/guestfish-actions.pod:5335 msgid "This is like L</command>, but passes the command to:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5472 ../src/guestfs-actions.pod:8571 +#: ../fish/guestfish-actions.pod:5337 ../src/guestfs-actions.pod:8315 #, no-wrap msgid "" " /bin/sh -c \"command\"\n" @@ -19211,24 +19078,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5474 ../src/guestfs-actions.pod:8573 +#: ../fish/guestfish-actions.pod:5339 ../src/guestfs-actions.pod:8317 msgid "" "Depending on the guest's shell, this usually results in wildcards being " "expanded, shell expressions being interpolated and so on." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5478 +#: ../fish/guestfish-actions.pod:5343 msgid "All the provisos about L</command> apply to this call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5480 +#: ../fish/guestfish-actions.pod:5345 msgid "sh-lines" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5482 +#: ../fish/guestfish-actions.pod:5347 #, no-wrap msgid "" " sh-lines command\n" @@ -19236,22 +19103,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5484 +#: ../fish/guestfish-actions.pod:5349 msgid "This is the same as L</sh>, but splits the result into a list of lines." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5487 +#: ../fish/guestfish-actions.pod:5352 msgid "See also: L</command-lines>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5489 +#: ../fish/guestfish-actions.pod:5354 msgid "shutdown" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5491 +#: ../fish/guestfish-actions.pod:5356 #, no-wrap msgid "" " shutdown\n" @@ -19259,7 +19126,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5493 +#: ../fish/guestfish-actions.pod:5358 msgid "" "This is the opposite of L</launch>. It performs an orderly shutdown of the " "backend process(es). If the autosync flag is set (which is the default) " @@ -19267,7 +19134,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5497 ../src/guestfs-actions.pod:8610 +#: ../fish/guestfish-actions.pod:5362 ../src/guestfs-actions.pod:8354 msgid "" "If the subprocess exits with an error then this function will return an " "error, which should I<not> be ignored (it may indicate that the disk image " @@ -19275,31 +19142,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5501 ../src/guestfs-actions.pod:8614 +#: ../fish/guestfish-actions.pod:5366 ../src/guestfs-actions.pod:8358 msgid "It is safe to call this multiple times. Extra calls are ignored." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5503 +#: ../fish/guestfish-actions.pod:5368 msgid "" "This call does I<not> close or free up the handle. You still need to call " "L</close> afterwards." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5506 +#: ../fish/guestfish-actions.pod:5371 msgid "" "L</close> will call this if you don't do it explicitly, but note that any " "errors are ignored in that case." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5509 +#: ../fish/guestfish-actions.pod:5374 msgid "sleep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5511 +#: ../fish/guestfish-actions.pod:5376 #, no-wrap msgid "" " sleep secs\n" @@ -19307,17 +19174,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5513 ../src/guestfs-actions.pod:8630 +#: ../fish/guestfish-actions.pod:5378 ../src/guestfs-actions.pod:8374 msgid "Sleep for C<secs> seconds." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5515 +#: ../fish/guestfish-actions.pod:5380 msgid "stat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5517 +#: ../fish/guestfish-actions.pod:5382 #, no-wrap msgid "" " stat path\n" @@ -19325,17 +19192,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5521 ../src/guestfs-actions.pod:8644 +#: ../fish/guestfish-actions.pod:5386 ../src/guestfs-actions.pod:8388 msgid "This is the same as the C<stat(2)> system call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5523 +#: ../fish/guestfish-actions.pod:5388 msgid "statvfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5525 +#: ../fish/guestfish-actions.pod:5390 #, no-wrap msgid "" " statvfs path\n" @@ -19343,7 +19210,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5527 ../src/guestfs-actions.pod:8658 +#: ../fish/guestfish-actions.pod:5392 ../src/guestfs-actions.pod:8402 msgid "" "Returns file system statistics for any mounted file system. C<path> should " "be a file or directory in the mounted file system (typically it is the mount " @@ -19351,17 +19218,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5531 ../src/guestfs-actions.pod:8662 +#: ../fish/guestfish-actions.pod:5396 ../src/guestfs-actions.pod:8406 msgid "This is the same as the C<statvfs(2)> system call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5533 +#: ../fish/guestfish-actions.pod:5398 msgid "strings" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5535 +#: ../fish/guestfish-actions.pod:5400 #, no-wrap msgid "" " strings path\n" @@ -19369,19 +19236,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5537 ../src/guestfs-actions.pod:8676 +#: ../fish/guestfish-actions.pod:5402 ../src/guestfs-actions.pod:8420 msgid "" "This runs the L<strings(1)> command on a file and returns the list of " "printable strings found." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5543 +#: ../fish/guestfish-actions.pod:5408 msgid "strings-e" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5545 +#: ../fish/guestfish-actions.pod:5410 #, no-wrap msgid "" " strings-e encoding path\n" @@ -19389,93 +19256,93 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5547 +#: ../fish/guestfish-actions.pod:5412 msgid "" "This is like the L</strings> command, but allows you to specify the encoding " "of strings that are looked for in the source file C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5551 ../src/guestfs-actions.pod:8699 +#: ../fish/guestfish-actions.pod:5416 ../src/guestfs-actions.pod:8443 msgid "Allowed encodings are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5555 ../src/guestfs-actions.pod:8703 +#: ../fish/guestfish-actions.pod:5420 ../src/guestfs-actions.pod:8447 msgid "s" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5557 +#: ../fish/guestfish-actions.pod:5422 msgid "" "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of " "ISO-8859-X (this is what L</strings> uses)." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5560 ../src/guestfs-actions.pod:8708 +#: ../fish/guestfish-actions.pod:5425 ../src/guestfs-actions.pod:8452 msgid "S" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5562 ../src/guestfs-actions.pod:8710 +#: ../fish/guestfish-actions.pod:5427 ../src/guestfs-actions.pod:8454 msgid "Single 8-bit-byte characters." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5564 ../src/guestfs-actions.pod:8712 +#: ../fish/guestfish-actions.pod:5429 ../src/guestfs-actions.pod:8456 msgid "b" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5566 ../src/guestfs-actions.pod:8714 +#: ../fish/guestfish-actions.pod:5431 ../src/guestfs-actions.pod:8458 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5569 ../src/guestfs-actions.pod:8717 +#: ../fish/guestfish-actions.pod:5434 ../src/guestfs-actions.pod:8461 msgid "l (lower case letter L)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5571 ../src/guestfs-actions.pod:8719 +#: ../fish/guestfish-actions.pod:5436 ../src/guestfs-actions.pod:8463 msgid "" "16-bit little endian such as UTF-16LE and UCS-2LE. This is useful for " "examining binaries in Windows guests." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5574 ../src/guestfs-actions.pod:8722 +#: ../fish/guestfish-actions.pod:5439 ../src/guestfs-actions.pod:8466 msgid "B" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5576 ../src/guestfs-actions.pod:8724 +#: ../fish/guestfish-actions.pod:5441 ../src/guestfs-actions.pod:8468 msgid "32-bit big endian such as UCS-4BE." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5578 ../src/guestfs-actions.pod:8726 +#: ../fish/guestfish-actions.pod:5443 ../src/guestfs-actions.pod:8470 msgid "L" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5580 ../src/guestfs-actions.pod:8728 +#: ../fish/guestfish-actions.pod:5445 ../src/guestfs-actions.pod:8472 msgid "32-bit little endian such as UCS-4LE." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5584 ../src/guestfs-actions.pod:8732 +#: ../fish/guestfish-actions.pod:5449 ../src/guestfs-actions.pod:8476 msgid "The returned strings are transcoded to UTF-8." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5589 +#: ../fish/guestfish-actions.pod:5454 msgid "swapoff-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5591 +#: ../fish/guestfish-actions.pod:5456 #, no-wrap msgid "" " swapoff-device device\n" @@ -19483,19 +19350,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5593 +#: ../fish/guestfish-actions.pod:5458 msgid "" "This command disables the libguestfs appliance swap device or partition " "named C<device>. See L</swapon-device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5597 +#: ../fish/guestfish-actions.pod:5462 msgid "swapoff-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5599 +#: ../fish/guestfish-actions.pod:5464 #, no-wrap msgid "" " swapoff-file file\n" @@ -19503,17 +19370,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5601 ../src/guestfs-actions.pod:8763 +#: ../fish/guestfish-actions.pod:5466 ../src/guestfs-actions.pod:8507 msgid "This command disables the libguestfs appliance swap on file." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5603 +#: ../fish/guestfish-actions.pod:5468 msgid "swapoff-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5605 +#: ../fish/guestfish-actions.pod:5470 #, no-wrap msgid "" " swapoff-label label\n" @@ -19521,19 +19388,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5607 ../src/guestfs-actions.pod:8775 +#: ../fish/guestfish-actions.pod:5472 ../src/guestfs-actions.pod:8519 msgid "" "This command disables the libguestfs appliance swap on labeled swap " "partition." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5610 +#: ../fish/guestfish-actions.pod:5475 msgid "swapoff-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5612 +#: ../fish/guestfish-actions.pod:5477 #, no-wrap msgid "" " swapoff-uuid uuid\n" @@ -19541,19 +19408,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5614 ../src/guestfs-actions.pod:8788 +#: ../fish/guestfish-actions.pod:5479 ../src/guestfs-actions.pod:8532 msgid "" "This command disables the libguestfs appliance swap partition with the given " "UUID." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5617 +#: ../fish/guestfish-actions.pod:5482 msgid "swapon-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5619 +#: ../fish/guestfish-actions.pod:5484 #, no-wrap msgid "" " swapon-device device\n" @@ -19561,7 +19428,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5621 +#: ../fish/guestfish-actions.pod:5486 msgid "" "This command enables the libguestfs appliance to use the swap device or " "partition named C<device>. The increased memory is made available for all " @@ -19569,7 +19436,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5626 ../src/guestfs-actions.pod:8806 +#: ../fish/guestfish-actions.pod:5491 ../src/guestfs-actions.pod:8550 msgid "" "Note that you should not swap to existing guest swap partitions unless you " "know what you are doing. They may contain hibernation information, or other " @@ -19579,12 +19446,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5633 +#: ../fish/guestfish-actions.pod:5498 msgid "swapon-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5635 +#: ../fish/guestfish-actions.pod:5500 #, no-wrap msgid "" " swapon-file file\n" @@ -19592,17 +19459,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5637 +#: ../fish/guestfish-actions.pod:5502 msgid "This command enables swap to a file. See L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5640 +#: ../fish/guestfish-actions.pod:5505 msgid "swapon-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5642 +#: ../fish/guestfish-actions.pod:5507 #, no-wrap msgid "" " swapon-label label\n" @@ -19610,19 +19477,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5644 +#: ../fish/guestfish-actions.pod:5509 msgid "" "This command enables swap to a labeled swap partition. See " "L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5647 +#: ../fish/guestfish-actions.pod:5512 msgid "swapon-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5649 +#: ../fish/guestfish-actions.pod:5514 #, no-wrap msgid "" " swapon-uuid uuid\n" @@ -19630,19 +19497,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5651 +#: ../fish/guestfish-actions.pod:5516 msgid "" "This command enables swap to a swap partition with the given UUID. See " "L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5654 +#: ../fish/guestfish-actions.pod:5519 msgid "sync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5656 +#: ../fish/guestfish-actions.pod:5521 #, no-wrap msgid "" " sync\n" @@ -19650,26 +19517,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5658 ../src/guestfs-actions.pod:8861 +#: ../fish/guestfish-actions.pod:5523 ../src/guestfs-actions.pod:8605 msgid "" "This syncs the disk, so that any writes are flushed through to the " "underlying disk image." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5661 ../src/guestfs-actions.pod:8864 +#: ../fish/guestfish-actions.pod:5526 ../src/guestfs-actions.pod:8608 msgid "" "You should always call this if you have modified a disk image, before " "closing the handle." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5664 +#: ../fish/guestfish-actions.pod:5529 msgid "tail" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5666 +#: ../fish/guestfish-actions.pod:5531 #, no-wrap msgid "" " tail path\n" @@ -19677,17 +19544,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5668 ../src/guestfs-actions.pod:8877 +#: ../fish/guestfish-actions.pod:5533 ../src/guestfs-actions.pod:8621 msgid "This command returns up to the last 10 lines of a file as a list of strings." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5674 +#: ../fish/guestfish-actions.pod:5539 msgid "tail-n" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5676 +#: ../fish/guestfish-actions.pod:5541 #, no-wrap msgid "" " tail-n nrlines path\n" @@ -19695,26 +19562,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5678 ../src/guestfs-actions.pod:8896 +#: ../fish/guestfish-actions.pod:5543 ../src/guestfs-actions.pod:8640 msgid "" "If the parameter C<nrlines> is a positive number, this returns the last " "C<nrlines> lines of the file C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5681 ../src/guestfs-actions.pod:8899 +#: ../fish/guestfish-actions.pod:5546 ../src/guestfs-actions.pod:8643 msgid "" "If the parameter C<nrlines> is a negative number, this returns lines from " "the file C<path>, starting with the C<-nrlines>th line." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5689 +#: ../fish/guestfish-actions.pod:5554 msgid "tar-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5691 +#: ../fish/guestfish-actions.pod:5556 #, no-wrap msgid "" " tar-in (tarfile|-) directory\n" @@ -19722,24 +19589,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5693 ../src/guestfs-actions.pod:8920 +#: ../fish/guestfish-actions.pod:5558 ../src/guestfs-actions.pod:8664 msgid "" "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> " "tar file) into C<directory>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5696 +#: ../fish/guestfish-actions.pod:5561 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5701 +#: ../fish/guestfish-actions.pod:5566 msgid "tar-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5703 +#: ../fish/guestfish-actions.pod:5568 #, no-wrap msgid "" " tar-out directory (tarfile|-)\n" @@ -19747,24 +19614,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5705 ../src/guestfs-actions.pod:8937 +#: ../fish/guestfish-actions.pod:5570 ../src/guestfs-actions.pod:8681 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarfile>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5708 +#: ../fish/guestfish-actions.pod:5573 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5713 +#: ../fish/guestfish-actions.pod:5578 msgid "tgz-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5715 +#: ../fish/guestfish-actions.pod:5580 #, no-wrap msgid "" " tgz-in (tarball|-) directory\n" @@ -19772,24 +19639,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5717 ../src/guestfs-actions.pod:8954 +#: ../fish/guestfish-actions.pod:5582 ../src/guestfs-actions.pod:8698 msgid "" "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> " "tar file) into C<directory>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5720 +#: ../fish/guestfish-actions.pod:5585 msgid "To upload an uncompressed tarball, use L</tar-in>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5724 +#: ../fish/guestfish-actions.pod:5589 msgid "tgz-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5726 +#: ../fish/guestfish-actions.pod:5591 #, no-wrap msgid "" " tgz-out directory (tarball|-)\n" @@ -19797,24 +19664,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5728 ../src/guestfs-actions.pod:8970 +#: ../fish/guestfish-actions.pod:5593 ../src/guestfs-actions.pod:8714 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarball>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5731 +#: ../fish/guestfish-actions.pod:5596 msgid "To download an uncompressed tarball, use L</tar-out>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5735 +#: ../fish/guestfish-actions.pod:5600 msgid "touch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5737 +#: ../fish/guestfish-actions.pod:5602 #, no-wrap msgid "" " touch path\n" @@ -19822,7 +19689,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5739 ../src/guestfs-actions.pod:8985 +#: ../fish/guestfish-actions.pod:5604 ../src/guestfs-actions.pod:8729 msgid "" "Touch acts like the L<touch(1)> command. It can be used to update the " "timestamps on a file, or, if the file does not exist, to create a new " @@ -19830,19 +19697,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5743 ../src/guestfs-actions.pod:8989 +#: ../fish/guestfish-actions.pod:5608 ../src/guestfs-actions.pod:8733 msgid "" "This command only works on regular files, and will fail on other file types " "such as directories, symbolic links, block special etc." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5746 +#: ../fish/guestfish-actions.pod:5611 msgid "truncate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5748 +#: ../fish/guestfish-actions.pod:5613 #, no-wrap msgid "" " truncate path\n" @@ -19850,19 +19717,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5750 ../src/guestfs-actions.pod:9002 +#: ../fish/guestfish-actions.pod:5615 ../src/guestfs-actions.pod:8746 msgid "" "This command truncates C<path> to a zero-length file. The file must exist " "already." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5753 +#: ../fish/guestfish-actions.pod:5618 msgid "truncate-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5755 +#: ../fish/guestfish-actions.pod:5620 #, no-wrap msgid "" " truncate-size path size\n" @@ -19870,14 +19737,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5757 ../src/guestfs-actions.pod:9016 +#: ../fish/guestfish-actions.pod:5622 ../src/guestfs-actions.pod:8760 msgid "" "This command truncates C<path> to size C<size> bytes. The file must exist " "already." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5760 +#: ../fish/guestfish-actions.pod:5625 msgid "" "If the current file size is less than C<size> then the file is extended to " "the required size with zero bytes. This creates a sparse file (ie. disk " @@ -19886,12 +19753,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5766 +#: ../fish/guestfish-actions.pod:5631 msgid "tune2fs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5768 +#: ../fish/guestfish-actions.pod:5633 #, no-wrap msgid "" " tune2fs device [force:true|false] [maxmountcount:N] [mountcount:N] " @@ -19902,26 +19769,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5770 ../src/guestfs-actions.pod:9052 +#: ../fish/guestfish-actions.pod:5635 ../src/guestfs-actions.pod:8796 msgid "" "This call allows you to adjust various filesystem parameters of an " "ext2/ext3/ext4 filesystem called C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5779 ../src/guestfs-actions.pod:9061 +#: ../fish/guestfish-actions.pod:5644 ../src/guestfs-actions.pod:8805 msgid "" "Force tune2fs to complete the operation even in the face of errors. This is " "the same as the tune2fs C<-f> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5782 ../src/guestfs-actions.pod:9064 +#: ../fish/guestfish-actions.pod:5647 ../src/guestfs-actions.pod:8808 msgid "C<maxmountcount>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5784 ../src/guestfs-actions.pod:9066 +#: ../fish/guestfish-actions.pod:5649 ../src/guestfs-actions.pod:8810 msgid "" "Set the number of mounts after which the filesystem is checked by " "L<e2fsck(8)>. If this is C<0> then the number of mounts is disregarded. " @@ -19929,24 +19796,24 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5788 ../src/guestfs-actions.pod:9070 +#: ../fish/guestfish-actions.pod:5653 ../src/guestfs-actions.pod:8814 msgid "C<mountcount>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5790 ../src/guestfs-actions.pod:9072 +#: ../fish/guestfish-actions.pod:5655 ../src/guestfs-actions.pod:8816 msgid "" "Set the number of times the filesystem has been mounted. This is the same " "as the tune2fs C<-C> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5793 ../src/guestfs-actions.pod:9075 +#: ../fish/guestfish-actions.pod:5658 ../src/guestfs-actions.pod:8819 msgid "C<errorbehavior>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5795 ../src/guestfs-actions.pod:9077 +#: ../fish/guestfish-actions.pod:5660 ../src/guestfs-actions.pod:8821 msgid "" "Change the behavior of the kernel code when errors are detected. Possible " "values currently are: C<continue>, C<remount-ro>, C<panic>. In practice " @@ -19955,77 +19822,77 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5800 ../src/guestfs-actions.pod:9082 +#: ../fish/guestfish-actions.pod:5665 ../src/guestfs-actions.pod:8826 msgid "This is the same as the tune2fs C<-e> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5802 ../src/guestfs-actions.pod:9084 +#: ../fish/guestfish-actions.pod:5667 ../src/guestfs-actions.pod:8828 msgid "C<group>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5804 ../src/guestfs-actions.pod:9086 +#: ../fish/guestfish-actions.pod:5669 ../src/guestfs-actions.pod:8830 msgid "" "Set the group which can use reserved filesystem blocks. This is the same as " "the tune2fs C<-g> option except that it can only be specified as a number." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5808 ../src/guestfs-actions.pod:9090 +#: ../fish/guestfish-actions.pod:5673 ../src/guestfs-actions.pod:8834 msgid "C<intervalbetweenchecks>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5810 ../src/guestfs-actions.pod:9092 +#: ../fish/guestfish-actions.pod:5675 ../src/guestfs-actions.pod:8836 msgid "" "Adjust the maximal time between two filesystem checks (in seconds). If the " "option is passed as C<0> then time-dependent checking is disabled." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5814 ../src/guestfs-actions.pod:9096 +#: ../fish/guestfish-actions.pod:5679 ../src/guestfs-actions.pod:8840 msgid "This is the same as the tune2fs C<-i> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5816 ../src/guestfs-actions.pod:9098 +#: ../fish/guestfish-actions.pod:5681 ../src/guestfs-actions.pod:8842 msgid "C<reservedblockspercentage>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5818 ../src/guestfs-actions.pod:9100 +#: ../fish/guestfish-actions.pod:5683 ../src/guestfs-actions.pod:8844 msgid "" "Set the percentage of the filesystem which may only be allocated by " "privileged processes. This is the same as the tune2fs C<-m> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5822 ../src/guestfs-actions.pod:9104 +#: ../fish/guestfish-actions.pod:5687 ../src/guestfs-actions.pod:8848 msgid "C<lastmounteddirectory>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5824 ../src/guestfs-actions.pod:9106 +#: ../fish/guestfish-actions.pod:5689 ../src/guestfs-actions.pod:8850 msgid "" "Set the last mounted directory. This is the same as the tune2fs C<-M> " "option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5827 ../src/guestfs-actions.pod:9109 +#: ../fish/guestfish-actions.pod:5692 ../src/guestfs-actions.pod:8853 msgid "" "C<reservedblockscount> Set the number of reserved filesystem blocks. This " "is the same as the tune2fs C<-r> option." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:5831 ../src/guestfs-actions.pod:9113 +#: ../fish/guestfish-actions.pod:5696 ../src/guestfs-actions.pod:8857 msgid "C<user>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5833 ../src/guestfs-actions.pod:9115 +#: ../fish/guestfish-actions.pod:5698 ../src/guestfs-actions.pod:8859 msgid "" "Set the user who can use the reserved filesystem blocks. This is the same " "as the tune2fs C<-u> option except that it can only be specified as a " @@ -20033,19 +19900,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5839 +#: ../fish/guestfish-actions.pod:5704 msgid "" "To get the current values of filesystem parameters, see L</tune2fs-l>. For " "precise details of how tune2fs works, see the L<tune2fs(8)> man page." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5845 +#: ../fish/guestfish-actions.pod:5710 msgid "tune2fs-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5847 +#: ../fish/guestfish-actions.pod:5712 #, no-wrap msgid "" " tune2fs-l device\n" @@ -20053,14 +19920,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5849 ../src/guestfs-actions.pod:9157 +#: ../fish/guestfish-actions.pod:5714 ../src/guestfs-actions.pod:8901 msgid "" "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on " "C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5852 ../src/guestfs-actions.pod:9160 +#: ../fish/guestfish-actions.pod:5717 ../src/guestfs-actions.pod:8904 msgid "" "It is the same as running C<tune2fs -l device>. See L<tune2fs(8)> manpage " "for more details. The list of fields returned isn't clearly defined, and " @@ -20069,12 +19936,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5857 +#: ../fish/guestfish-actions.pod:5722 msgid "txz-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5859 +#: ../fish/guestfish-actions.pod:5724 #, no-wrap msgid "" " txz-in (tarball|-) directory\n" @@ -20082,19 +19949,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5861 ../src/guestfs-actions.pod:9180 +#: ../fish/guestfish-actions.pod:5726 ../src/guestfs-actions.pod:8924 msgid "" "This command uploads and unpacks local file C<tarball> (an I<xz compressed> " "tar file) into C<directory>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5866 +#: ../fish/guestfish-actions.pod:5731 msgid "txz-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5868 +#: ../fish/guestfish-actions.pod:5733 #, no-wrap msgid "" " txz-out directory (tarball|-)\n" @@ -20102,19 +19969,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5870 ../src/guestfs-actions.pod:9194 +#: ../fish/guestfish-actions.pod:5735 ../src/guestfs-actions.pod:8938 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarball> (as an xz compressed tar archive)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5875 +#: ../fish/guestfish-actions.pod:5740 msgid "umask" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5877 +#: ../fish/guestfish-actions.pod:5742 #, no-wrap msgid "" " umask mask\n" @@ -20122,14 +19989,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5879 ../src/guestfs-actions.pod:9207 +#: ../fish/guestfish-actions.pod:5744 ../src/guestfs-actions.pod:8951 msgid "" "This function sets the mask used for creating new files and device nodes to " "C<mask & 0777>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5882 ../src/guestfs-actions.pod:9210 +#: ../fish/guestfish-actions.pod:5747 ../src/guestfs-actions.pod:8954 msgid "" "Typical umask values would be C<022> which creates new files with " "permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates " @@ -20137,7 +20004,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5887 ../src/guestfs-actions.pod:9215 +#: ../fish/guestfish-actions.pod:5752 ../src/guestfs-actions.pod:8959 msgid "" "The default umask is C<022>. This is important because it means that " "directories and device nodes will be created with C<0644> or C<0755> mode " @@ -20145,57 +20012,52 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5891 +#: ../fish/guestfish-actions.pod:5756 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5894 ../src/guestfs-actions.pod:9222 +#: ../fish/guestfish-actions.pod:5759 ../src/guestfs-actions.pod:8966 msgid "This call returns the previous umask." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5896 +#: ../fish/guestfish-actions.pod:5761 msgid "umount" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5898 +#: ../fish/guestfish-actions.pod:5763 msgid "unmount" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:5900 -msgid "umount-opts" -msgstr "" - #. type: verbatim -#: ../fish/guestfish-actions.pod:5902 +#: ../fish/guestfish-actions.pod:5765 #, no-wrap msgid "" -" umount pathordevice [force:true|false] [lazyunmount:true|false]\n" +" umount pathordevice\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5904 ../src/guestfs-actions.pod:9256 +#: ../fish/guestfish-actions.pod:5767 ../src/guestfs-actions.pod:8978 msgid "" "This unmounts the given filesystem. The filesystem may be specified either " "by its mountpoint (path) or the device which contains the filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5910 +#: ../fish/guestfish-actions.pod:5771 msgid "umount-all" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5912 +#: ../fish/guestfish-actions.pod:5773 msgid "unmount-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5914 +#: ../fish/guestfish-actions.pod:5775 #, no-wrap msgid "" " umount-all\n" @@ -20203,22 +20065,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5916 ../src/guestfs-actions.pod:9289 +#: ../fish/guestfish-actions.pod:5777 ../src/guestfs-actions.pod:8991 msgid "This unmounts all mounted filesystems." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5918 ../src/guestfs-actions.pod:9291 +#: ../fish/guestfish-actions.pod:5779 ../src/guestfs-actions.pod:8993 msgid "Some internal mounts are not unmounted by this call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5920 +#: ../fish/guestfish-actions.pod:5781 msgid "umount-local" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5922 +#: ../fish/guestfish-actions.pod:5783 #, no-wrap msgid "" " umount-local [retry:true|false]\n" @@ -20226,19 +20088,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5924 ../src/guestfs-actions.pod:9310 +#: ../fish/guestfish-actions.pod:5785 ../src/guestfs-actions.pod:9012 msgid "" "If libguestfs is exporting the filesystem on a local mountpoint, then this " "unmounts it." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5931 +#: ../fish/guestfish-actions.pod:5792 msgid "upload" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5933 +#: ../fish/guestfish-actions.pod:5794 #, no-wrap msgid "" " upload (filename|-) remotefilename\n" @@ -20246,22 +20108,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5935 ../fish/guestfish-actions.pod:5948 ../src/guestfs-actions.pod:9346 ../src/guestfs-actions.pod:9370 +#: ../fish/guestfish-actions.pod:5796 ../fish/guestfish-actions.pod:5809 ../src/guestfs-actions.pod:9048 ../src/guestfs-actions.pod:9072 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5940 +#: ../fish/guestfish-actions.pod:5801 msgid "See also L</download>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5944 +#: ../fish/guestfish-actions.pod:5805 msgid "upload-offset" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5946 +#: ../fish/guestfish-actions.pod:5807 #, no-wrap msgid "" " upload-offset (filename|-) remotefilename offset\n" @@ -20269,7 +20131,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5951 ../src/guestfs-actions.pod:9373 +#: ../fish/guestfish-actions.pod:5812 ../src/guestfs-actions.pod:9075 msgid "" "C<remotefilename> is overwritten starting at the byte C<offset> specified. " "The intention is to overwrite parts of existing files or devices, although " @@ -20279,7 +20141,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5958 +#: ../fish/guestfish-actions.pod:5819 msgid "" "Note that there is no limit on the amount of data that can be uploaded with " "this call, unlike with L</pwrite>, and this call always writes the full " @@ -20287,17 +20149,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5963 +#: ../fish/guestfish-actions.pod:5824 msgid "See also L</upload>, L</pwrite>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5967 +#: ../fish/guestfish-actions.pod:5828 msgid "utimens" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5969 +#: ../fish/guestfish-actions.pod:5830 #, no-wrap msgid "" " utimens path atsecs atnsecs mtsecs mtnsecs\n" @@ -20305,26 +20167,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5971 ../src/guestfs-actions.pod:9406 +#: ../fish/guestfish-actions.pod:5832 ../src/guestfs-actions.pod:9108 msgid "This command sets the timestamps of a file with nanosecond precision." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5974 ../src/guestfs-actions.pod:9409 +#: ../fish/guestfish-actions.pod:5835 ../src/guestfs-actions.pod:9111 msgid "" "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds " "from the epoch." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5977 ../src/guestfs-actions.pod:9412 +#: ../fish/guestfish-actions.pod:5838 ../src/guestfs-actions.pod:9114 msgid "" "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and " "nanoseconds from the epoch." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5980 ../src/guestfs-actions.pod:9415 +#: ../fish/guestfish-actions.pod:5841 ../src/guestfs-actions.pod:9117 msgid "" "If the C<*nsecs> field contains the special value C<-1> then the " "corresponding timestamp is set to the current time. (The C<*secs> field is " @@ -20332,7 +20194,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5984 ../src/guestfs-actions.pod:9419 +#: ../fish/guestfish-actions.pod:5845 ../src/guestfs-actions.pod:9121 msgid "" "If the C<*nsecs> field contains the special value C<-2> then the " "corresponding timestamp is left unchanged. (The C<*secs> field is ignored " @@ -20340,33 +20202,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5988 -msgid "utsname" -msgstr "" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:5990 -#, no-wrap -msgid "" -" utsname\n" -"\n" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:5992 ../src/guestfs-actions.pod:9432 -msgid "" -"This returns the kernel version of the appliance, where this is available. " -"This information is only useful for debugging. Nothing in the returned " -"structure is defined by the API." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:5996 +#: ../fish/guestfish-actions.pod:5849 msgid "version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5998 +#: ../fish/guestfish-actions.pod:5851 #, no-wrap msgid "" " version\n" @@ -20374,12 +20215,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6000 ../src/guestfs-actions.pod:9445 +#: ../fish/guestfish-actions.pod:5853 ../src/guestfs-actions.pod:9134 msgid "Return the libguestfs version number that the program is linked against." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6003 ../src/guestfs-actions.pod:9448 +#: ../fish/guestfish-actions.pod:5856 ../src/guestfs-actions.pod:9137 msgid "" "Note that because of dynamic linking this is not necessarily the version of " "libguestfs that you compiled against. You can compile the program, and then " @@ -20388,7 +20229,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6008 ../src/guestfs-actions.pod:9453 +#: ../fish/guestfish-actions.pod:5861 ../src/guestfs-actions.pod:9142 msgid "" "This call was added in version C<1.0.58>. In previous versions of " "libguestfs there was no way to get the version number. From C code you can " @@ -20397,7 +20238,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6014 ../src/guestfs-actions.pod:9459 +#: ../fish/guestfish-actions.pod:5867 ../src/guestfs-actions.pod:9148 msgid "" "The call returns a structure with four elements. The first three (C<major>, " "C<minor> and C<release>) are numbers and correspond to the usual version " @@ -20406,17 +20247,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6020 ../src/guestfs-actions.pod:9465 +#: ../fish/guestfish-actions.pod:5873 ../src/guestfs-actions.pod:9154 msgid "To construct the original version string: C<$major.$minor.$release$extra>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6023 ../src/guestfs-actions.pod:9468 +#: ../fish/guestfish-actions.pod:5876 ../src/guestfs-actions.pod:9157 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6025 +#: ../fish/guestfish-actions.pod:5878 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " @@ -20425,12 +20266,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6031 +#: ../fish/guestfish-actions.pod:5884 msgid "vfs-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6033 +#: ../fish/guestfish-actions.pod:5886 #, no-wrap msgid "" " vfs-label device\n" @@ -20438,27 +20279,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6035 ../src/guestfs-actions.pod:9488 +#: ../fish/guestfish-actions.pod:5888 ../src/guestfs-actions.pod:9177 msgid "This returns the filesystem label of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6038 ../src/guestfs-actions.pod:9491 +#: ../fish/guestfish-actions.pod:5891 ../src/guestfs-actions.pod:9180 msgid "If the filesystem is unlabeled, this returns the empty string." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6040 +#: ../fish/guestfish-actions.pod:5893 msgid "To find a filesystem from the label, use L</findfs-label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6042 +#: ../fish/guestfish-actions.pod:5895 msgid "vfs-type" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6044 +#: ../fish/guestfish-actions.pod:5897 #, no-wrap msgid "" " vfs-type device\n" @@ -20466,14 +20307,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6046 ../src/guestfs-actions.pod:9506 +#: ../fish/guestfish-actions.pod:5899 ../src/guestfs-actions.pod:9195 msgid "" "This command gets the filesystem type corresponding to the filesystem on " "C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6049 ../src/guestfs-actions.pod:9509 +#: ../fish/guestfish-actions.pod:5902 ../src/guestfs-actions.pod:9198 msgid "" "For most filesystems, the result is the name of the Linux VFS module which " "would be used to mount this filesystem if you mounted it without specifying " @@ -20481,12 +20322,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6054 +#: ../fish/guestfish-actions.pod:5907 msgid "vfs-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6056 +#: ../fish/guestfish-actions.pod:5909 #, no-wrap msgid "" " vfs-uuid device\n" @@ -20494,27 +20335,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6058 ../src/guestfs-actions.pod:9525 +#: ../fish/guestfish-actions.pod:5911 ../src/guestfs-actions.pod:9214 msgid "This returns the filesystem UUID of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6061 ../src/guestfs-actions.pod:9528 +#: ../fish/guestfish-actions.pod:5914 ../src/guestfs-actions.pod:9217 msgid "If the filesystem does not have a UUID, this returns the empty string." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6063 +#: ../fish/guestfish-actions.pod:5916 msgid "To find a filesystem from the UUID, use L</findfs-uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6065 +#: ../fish/guestfish-actions.pod:5918 msgid "vg-activate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6067 +#: ../fish/guestfish-actions.pod:5920 #, no-wrap msgid "" " vg-activate true|false 'volgroups ...'\n" @@ -20522,31 +20363,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6069 ../src/guestfs-actions.pod:9544 +#: ../fish/guestfish-actions.pod:5922 ../src/guestfs-actions.pod:9233 msgid "" "This command activates or (if C<activate> is false) deactivates all logical " "volumes in the listed volume groups C<volgroups>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6072 ../src/guestfs-actions.pod:9547 +#: ../fish/guestfish-actions.pod:5925 ../src/guestfs-actions.pod:9236 msgid "This command is the same as running C<vgchange -a y|n volgroups...>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6074 ../src/guestfs-actions.pod:9549 +#: ../fish/guestfish-actions.pod:5927 ../src/guestfs-actions.pod:9238 msgid "" "Note that if C<volgroups> is an empty list then B<all> volume groups are " "activated or deactivated." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6077 +#: ../fish/guestfish-actions.pod:5930 msgid "vg-activate-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6079 +#: ../fish/guestfish-actions.pod:5932 #, no-wrap msgid "" " vg-activate-all true|false\n" @@ -20554,60 +20395,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6081 ../src/guestfs-actions.pod:9562 +#: ../fish/guestfish-actions.pod:5934 ../src/guestfs-actions.pod:9251 msgid "" "This command activates or (if C<activate> is false) deactivates all logical " "volumes in all volume groups." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6084 ../src/guestfs-actions.pod:9565 +#: ../fish/guestfish-actions.pod:5937 ../src/guestfs-actions.pod:9254 msgid "This command is the same as running C<vgchange -a y|n>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6086 -msgid "vgchange-uuid" -msgstr "" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:6088 -#, no-wrap -msgid "" -" vgchange-uuid vg\n" -"\n" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:6090 ../src/guestfs-actions.pod:9577 -msgid "Generate a new random UUID for the volume group C<vg>." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:6092 -msgid "vgchange-uuid-all" -msgstr "" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:6094 -#, no-wrap -msgid "" -" vgchange-uuid-all\n" -"\n" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:6096 ../src/guestfs-actions.pod:9586 -msgid "Generate new random UUIDs for all volume groups." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:6098 +#: ../fish/guestfish-actions.pod:5939 msgid "vgcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6100 +#: ../fish/guestfish-actions.pod:5941 #, no-wrap msgid "" " vgcreate volgroup 'physvols ...'\n" @@ -20615,19 +20420,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6102 ../src/guestfs-actions.pod:9597 +#: ../fish/guestfish-actions.pod:5943 ../src/guestfs-actions.pod:9267 msgid "" "This creates an LVM volume group called C<volgroup> from the non-empty list " "of physical volumes C<physvols>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6105 +#: ../fish/guestfish-actions.pod:5946 msgid "vglvuuids" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6107 +#: ../fish/guestfish-actions.pod:5948 #, no-wrap msgid "" " vglvuuids vgname\n" @@ -20635,31 +20440,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6109 ../src/guestfs-actions.pod:9610 +#: ../fish/guestfish-actions.pod:5950 ../src/guestfs-actions.pod:9280 msgid "" "Given a VG called C<vgname>, this returns the UUIDs of all the logical " "volumes created in this volume group." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6112 +#: ../fish/guestfish-actions.pod:5953 msgid "" "You can use this along with L</lvs> and L</lvuuid> calls to associate " "logical volumes and volume groups." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6115 +#: ../fish/guestfish-actions.pod:5956 msgid "See also L</vgpvuuids>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6117 +#: ../fish/guestfish-actions.pod:5958 msgid "vgmeta" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6119 +#: ../fish/guestfish-actions.pod:5960 #, no-wrap msgid "" " vgmeta vgname\n" @@ -20667,26 +20472,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6121 ../src/guestfs-actions.pod:9631 +#: ../fish/guestfish-actions.pod:5962 ../src/guestfs-actions.pod:9301 msgid "" "C<vgname> is an LVM volume group. This command examines the volume group " "and returns its metadata." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6124 ../src/guestfs-actions.pod:9634 +#: ../fish/guestfish-actions.pod:5965 ../src/guestfs-actions.pod:9304 msgid "" "Note that the metadata is an internal structure used by LVM, subject to " "change at any time, and is provided for information only." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6127 +#: ../fish/guestfish-actions.pod:5968 msgid "vgpvuuids" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6129 +#: ../fish/guestfish-actions.pod:5970 #, no-wrap msgid "" " vgpvuuids vgname\n" @@ -20694,31 +20499,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6131 ../src/guestfs-actions.pod:9649 +#: ../fish/guestfish-actions.pod:5972 ../src/guestfs-actions.pod:9319 msgid "" "Given a VG called C<vgname>, this returns the UUIDs of all the physical " "volumes that this volume group resides on." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6134 +#: ../fish/guestfish-actions.pod:5975 msgid "" "You can use this along with L</pvs> and L</pvuuid> calls to associate " "physical volumes and volume groups." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6137 +#: ../fish/guestfish-actions.pod:5978 msgid "See also L</vglvuuids>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6139 +#: ../fish/guestfish-actions.pod:5980 msgid "vgremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6141 +#: ../fish/guestfish-actions.pod:5982 #, no-wrap msgid "" " vgremove vgname\n" @@ -20726,22 +20531,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6143 ../src/guestfs-actions.pod:9669 +#: ../fish/guestfish-actions.pod:5984 ../src/guestfs-actions.pod:9339 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6145 ../src/guestfs-actions.pod:9671 +#: ../fish/guestfish-actions.pod:5986 ../src/guestfs-actions.pod:9341 msgid "This also forcibly removes all logical volumes in the volume group (if any)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6148 +#: ../fish/guestfish-actions.pod:5989 msgid "vgrename" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6150 +#: ../fish/guestfish-actions.pod:5991 #, no-wrap msgid "" " vgrename volgroup newvolgroup\n" @@ -20749,17 +20554,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6152 ../src/guestfs-actions.pod:9685 +#: ../fish/guestfish-actions.pod:5993 ../src/guestfs-actions.pod:9355 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6154 +#: ../fish/guestfish-actions.pod:5995 msgid "vgs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6156 +#: ../fish/guestfish-actions.pod:5997 #, no-wrap msgid "" " vgs\n" @@ -20767,31 +20572,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6158 ../src/guestfs-actions.pod:9696 +#: ../fish/guestfish-actions.pod:5999 ../src/guestfs-actions.pod:9366 msgid "" "List all the volumes groups detected. This is the equivalent of the " "L<vgs(8)> command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6161 ../src/guestfs-actions.pod:9699 +#: ../fish/guestfish-actions.pod:6002 ../src/guestfs-actions.pod:9369 msgid "" "This returns a list of just the volume group names that were detected " "(eg. C<VolGroup00>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6164 +#: ../fish/guestfish-actions.pod:6005 msgid "See also L</vgs-full>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6166 +#: ../fish/guestfish-actions.pod:6007 msgid "vgs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6168 +#: ../fish/guestfish-actions.pod:6009 #, no-wrap msgid "" " vgs-full\n" @@ -20799,19 +20604,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6170 ../src/guestfs-actions.pod:9715 +#: ../fish/guestfish-actions.pod:6011 ../src/guestfs-actions.pod:9385 msgid "" "List all the volumes groups detected. This is the equivalent of the " "L<vgs(8)> command. The \"full\" version includes all fields." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6173 +#: ../fish/guestfish-actions.pod:6014 msgid "vgscan" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6175 +#: ../fish/guestfish-actions.pod:6016 #, no-wrap msgid "" " vgscan\n" @@ -20819,19 +20624,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6177 ../src/guestfs-actions.pod:9729 +#: ../fish/guestfish-actions.pod:6018 ../src/guestfs-actions.pod:9399 msgid "" "This rescans all block devices and rebuilds the list of LVM physical " "volumes, volume groups and logical volumes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6180 +#: ../fish/guestfish-actions.pod:6021 msgid "vguuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6182 +#: ../fish/guestfish-actions.pod:6023 #, no-wrap msgid "" " vguuid vgname\n" @@ -20839,17 +20644,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6184 ../src/guestfs-actions.pod:9742 +#: ../fish/guestfish-actions.pod:6025 ../src/guestfs-actions.pod:9412 msgid "This command returns the UUID of the LVM VG named C<vgname>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6186 +#: ../fish/guestfish-actions.pod:6027 msgid "wc-c" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6188 +#: ../fish/guestfish-actions.pod:6029 #, no-wrap msgid "" " wc-c path\n" @@ -20857,19 +20662,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6190 ../src/guestfs-actions.pod:9782 +#: ../fish/guestfish-actions.pod:6031 ../src/guestfs-actions.pod:9452 msgid "" "This command counts the characters in a file, using the C<wc -c> external " "command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6193 +#: ../fish/guestfish-actions.pod:6034 msgid "wc-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6195 +#: ../fish/guestfish-actions.pod:6036 #, no-wrap msgid "" " wc-l path\n" @@ -20877,19 +20682,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6197 ../src/guestfs-actions.pod:9795 +#: ../fish/guestfish-actions.pod:6038 ../src/guestfs-actions.pod:9465 msgid "" "This command counts the lines in a file, using the C<wc -l> external " "command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6200 +#: ../fish/guestfish-actions.pod:6041 msgid "wc-w" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6202 +#: ../fish/guestfish-actions.pod:6043 #, no-wrap msgid "" " wc-w path\n" @@ -20897,19 +20702,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6204 ../src/guestfs-actions.pod:9808 +#: ../fish/guestfish-actions.pod:6045 ../src/guestfs-actions.pod:9478 msgid "" "This command counts the words in a file, using the C<wc -w> external " "command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6207 +#: ../fish/guestfish-actions.pod:6048 msgid "wipefs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6209 +#: ../fish/guestfish-actions.pod:6050 #, no-wrap msgid "" " wipefs device\n" @@ -20917,31 +20722,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6211 ../src/guestfs-actions.pod:9821 +#: ../fish/guestfish-actions.pod:6052 ../src/guestfs-actions.pod:9491 msgid "" "This command erases filesystem or RAID signatures from the specified " "C<device> to make the filesystem invisible to libblkid." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6214 ../src/guestfs-actions.pod:9824 +#: ../fish/guestfish-actions.pod:6055 ../src/guestfs-actions.pod:9494 msgid "" "This does not erase the filesystem itself nor any other data from the " "C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6217 +#: ../fish/guestfish-actions.pod:6058 msgid "Compare with L</zero> which zeroes the first few blocks of a device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6220 +#: ../fish/guestfish-actions.pod:6061 msgid "write" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6222 +#: ../fish/guestfish-actions.pod:6063 #, no-wrap msgid "" " write path content\n" @@ -20949,24 +20754,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6224 ../src/guestfs-actions.pod:9842 +#: ../fish/guestfish-actions.pod:6065 ../src/guestfs-actions.pod:9512 msgid "" "This call creates a file called C<path>. The content of the file is the " "string C<content> (which can contain any 8 bit data)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6227 +#: ../fish/guestfish-actions.pod:6068 msgid "See also L</write-append>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6232 +#: ../fish/guestfish-actions.pod:6073 msgid "write-append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6234 +#: ../fish/guestfish-actions.pod:6075 #, no-wrap msgid "" " write-append path content\n" @@ -20974,24 +20779,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6236 ../src/guestfs-actions.pod:9862 +#: ../fish/guestfish-actions.pod:6077 ../src/guestfs-actions.pod:9532 msgid "" "This call appends C<content> to the end of file C<path>. If C<path> does " "not exist, then a new file is created." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6239 +#: ../fish/guestfish-actions.pod:6080 msgid "See also L</write>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6244 +#: ../fish/guestfish-actions.pod:6085 msgid "write-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6246 +#: ../fish/guestfish-actions.pod:6087 #, no-wrap msgid "" " write-file path content size\n" @@ -20999,84 +20804,38 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6248 ../src/guestfs-actions.pod:9889 +#: ../fish/guestfish-actions.pod:6089 ../src/guestfs-actions.pod:9559 msgid "" "This call creates a file called C<path>. The contents of the file is the " "string C<content> (which can contain any 8 bit data), with length C<size>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6252 ../src/guestfs-actions.pod:9893 +#: ../fish/guestfish-actions.pod:6093 ../src/guestfs-actions.pod:9563 msgid "" "As a special case, if C<size> is C<0> then the length is calculated using " "C<strlen> (so in this case the content cannot contain embedded ASCII NULs)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6256 ../src/guestfs-actions.pod:9897 +#: ../fish/guestfish-actions.pod:6097 ../src/guestfs-actions.pod:9567 msgid "" "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does " "I<not> work, even if the length is specified." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6262 +#: ../fish/guestfish-actions.pod:6103 msgid "I<This function is deprecated.> In new code, use the L</write> call instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6269 -msgid "xfs-growfs" -msgstr "" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:6271 -#, no-wrap -msgid "" -" xfs-growfs path [datasec:true|false] [logsec:true|false] [rtsec:true|false] " -"[datasize:N] [logsize:N] [rtsize:N] [rtextsize:N] [maxpct:N]\n" -"\n" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:6273 ../src/guestfs-actions.pod:9928 -msgid "Grow the XFS filesystem mounted at C<path>." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:6275 ../fish/guestfish-actions.pod:6288 ../src/guestfs-actions.pod:9930 ../src/guestfs-actions.pod:9968 -msgid "" -"The returned struct contains geometry information. Missing fields are " -"returned as C<-1> (for numeric fields) or empty string." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:6281 -msgid "xfs-info" -msgstr "" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:6283 -#, no-wrap -msgid "" -" xfs-info pathordevice\n" -"\n" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:6285 ../src/guestfs-actions.pod:9965 -msgid "" -"C<pathordevice> is a mounted XFS filesystem or a device containing an XFS " -"filesystem. This command returns the geometry of the filesystem." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:6292 +#: ../fish/guestfish-actions.pod:6110 msgid "zegrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6294 +#: ../fish/guestfish-actions.pod:6112 #, no-wrap msgid "" " zegrep regex path\n" @@ -21084,17 +20843,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6296 ../src/guestfs-actions.pod:9990 +#: ../fish/guestfish-actions.pod:6114 ../src/guestfs-actions.pod:9584 msgid "This calls the external C<zegrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6309 +#: ../fish/guestfish-actions.pod:6120 msgid "zegrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6311 +#: ../fish/guestfish-actions.pod:6122 #, no-wrap msgid "" " zegrepi regex path\n" @@ -21102,17 +20861,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6313 ../src/guestfs-actions.pod:10016 +#: ../fish/guestfish-actions.pod:6124 ../src/guestfs-actions.pod:9603 msgid "This calls the external C<zegrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6326 +#: ../fish/guestfish-actions.pod:6130 msgid "zero" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6328 +#: ../fish/guestfish-actions.pod:6132 #, no-wrap msgid "" " zero device\n" @@ -21120,12 +20879,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6330 ../src/guestfs-actions.pod:10034 +#: ../fish/guestfish-actions.pod:6134 ../src/guestfs-actions.pod:9621 msgid "This command writes zeroes over the first few blocks of C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6332 ../src/guestfs-actions.pod:10036 +#: ../fish/guestfish-actions.pod:6136 ../src/guestfs-actions.pod:9623 msgid "" "How many blocks are zeroed isn't specified (but it's I<not> enough to " "securely wipe the device). It should be sufficient to remove any partition " @@ -21133,7 +20892,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6336 ../fish/guestfish-actions.pod:6351 ../src/guestfs-actions.pod:10040 ../src/guestfs-actions.pod:10066 +#: ../fish/guestfish-actions.pod:6140 ../fish/guestfish-actions.pod:6155 ../src/guestfs-actions.pod:9627 ../src/guestfs-actions.pod:9653 msgid "" "If blocks are already zero, then this command avoids writing zeroes. This " "prevents the underlying device from becoming non-sparse or growing " @@ -21141,17 +20900,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6340 +#: ../fish/guestfish-actions.pod:6144 msgid "See also: L</zero-device>, L</scrub-device>, L</is-zero-device>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6343 +#: ../fish/guestfish-actions.pod:6147 msgid "zero-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6345 +#: ../fish/guestfish-actions.pod:6149 #, no-wrap msgid "" " zero-device device\n" @@ -21159,19 +20918,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6347 +#: ../fish/guestfish-actions.pod:6151 msgid "" "This command writes zeroes over the entire C<device>. Compare with L</zero> " "which just zeroes the first few blocks of a device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6355 +#: ../fish/guestfish-actions.pod:6159 msgid "zero-free-space" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6357 +#: ../fish/guestfish-actions.pod:6161 #, no-wrap msgid "" " zero-free-space directory\n" @@ -21179,33 +20938,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6359 ../src/guestfs-actions.pod:10085 +#: ../fish/guestfish-actions.pod:6163 ../src/guestfs-actions.pod:9672 msgid "" "Zero the free space in the filesystem mounted on C<directory>. The " "filesystem must be mounted read-write." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6362 ../src/guestfs-actions.pod:10088 +#: ../fish/guestfish-actions.pod:6166 ../src/guestfs-actions.pod:9675 msgid "" "The filesystem contents are not affected, but any free space in the " "filesystem is freed." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6365 +#: ../fish/guestfish-actions.pod:6169 ../src/guestfs-actions.pod:9678 msgid "" -"Free space is not \"trimmed\". You may want to call L</fstrim> either as an " -"alternative to this, or after calling this, depending on your requirements." +"In future (but not currently) these zeroed blocks will be \"sparsified\" - " +"that is, given back to the host." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6369 +#: ../fish/guestfish-actions.pod:6172 msgid "zerofree" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6371 +#: ../fish/guestfish-actions.pod:6174 #, no-wrap msgid "" " zerofree device\n" @@ -21213,7 +20972,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6373 ../src/guestfs-actions.pod:10110 +#: ../fish/guestfish-actions.pod:6176 ../src/guestfs-actions.pod:9696 msgid "" "This runs the I<zerofree> program on C<device>. This program claims to zero " "unused inodes and disk blocks on an ext2/3 filesystem, thus making it " @@ -21221,24 +20980,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6378 ../src/guestfs-actions.pod:10115 +#: ../fish/guestfish-actions.pod:6181 ../src/guestfs-actions.pod:9701 msgid "You should B<not> run this program if the filesystem is mounted." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6381 ../src/guestfs-actions.pod:10118 +#: ../fish/guestfish-actions.pod:6184 ../src/guestfs-actions.pod:9704 msgid "" "It is possible that using this program can damage the filesystem or data on " "the filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6384 +#: ../fish/guestfish-actions.pod:6187 msgid "zfgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6386 +#: ../fish/guestfish-actions.pod:6189 #, no-wrap msgid "" " zfgrep pattern path\n" @@ -21246,17 +21005,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6388 ../src/guestfs-actions.pod:10139 +#: ../fish/guestfish-actions.pod:6191 ../src/guestfs-actions.pod:9718 msgid "This calls the external C<zfgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6401 +#: ../fish/guestfish-actions.pod:6197 msgid "zfgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6403 +#: ../fish/guestfish-actions.pod:6199 #, no-wrap msgid "" " zfgrepi pattern path\n" @@ -21264,17 +21023,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6405 ../src/guestfs-actions.pod:10165 +#: ../fish/guestfish-actions.pod:6201 ../src/guestfs-actions.pod:9737 msgid "This calls the external C<zfgrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6418 +#: ../fish/guestfish-actions.pod:6207 msgid "zfile" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6420 +#: ../fish/guestfish-actions.pod:6209 #, no-wrap msgid "" " zfile meth path\n" @@ -21282,32 +21041,32 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6422 ../src/guestfs-actions.pod:10191 +#: ../fish/guestfish-actions.pod:6211 ../src/guestfs-actions.pod:9763 msgid "This command runs C<file> after first decompressing C<path> using C<method>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6425 ../src/guestfs-actions.pod:10194 +#: ../fish/guestfish-actions.pod:6214 ../src/guestfs-actions.pod:9766 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6427 +#: ../fish/guestfish-actions.pod:6216 msgid "Since 1.0.63, use L</file> instead which can now process compressed files." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6430 +#: ../fish/guestfish-actions.pod:6219 msgid "I<This function is deprecated.> In new code, use the L</file> call instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6437 +#: ../fish/guestfish-actions.pod:6226 msgid "zgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6439 +#: ../fish/guestfish-actions.pod:6228 #, no-wrap msgid "" " zgrep regex path\n" @@ -21315,17 +21074,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6441 ../src/guestfs-actions.pod:10218 +#: ../fish/guestfish-actions.pod:6230 ../src/guestfs-actions.pod:9783 msgid "This calls the external C<zgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:6454 +#: ../fish/guestfish-actions.pod:6236 msgid "zgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:6456 +#: ../fish/guestfish-actions.pod:6238 #, no-wrap msgid "" " zgrepi regex path\n" @@ -21333,7 +21092,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:6458 ../src/guestfs-actions.pod:10244 +#: ../fish/guestfish-actions.pod:6240 ../src/guestfs-actions.pod:9802 msgid "This calls the external C<zgrep -i> program and returns the matching lines." msgstr "" @@ -22312,7 +22071,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:135 ../src/guestfs.pod:2346 +#: ../fish/guestfish.pod:135 ../src/guestfs.pod:2417 #, no-wrap msgid "" " guestfish -N fs\n" @@ -22523,7 +22282,7 @@ msgstr "" 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 " -"with malicious guests (CVE-2010-3851). See also L</add>." +"with malicious guests (CVE-2010-3851). See also L</add-drive-opts>." msgstr "" #. type: =item @@ -23240,7 +22999,7 @@ msgstr "" #: ../fish/guestfish.pod:597 #, no-wrap msgid "" -" add filename\n" +" add-drive-opts filename\n" "\n" msgstr "" @@ -23248,7 +23007,7 @@ msgstr "" #: ../fish/guestfish.pod:599 #, no-wrap msgid "" -" add filename readonly:true\n" +" add-drive-opts filename readonly:true\n" "\n" msgstr "" @@ -23256,7 +23015,7 @@ msgstr "" #: ../fish/guestfish.pod:601 #, no-wrap msgid "" -" add filename format:qcow2 readonly:false\n" +" add-drive-opts filename format:qcow2 readonly:false\n" "\n" msgstr "" @@ -24173,14 +23932,6 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:994 ../src/guestfs.pod:1046 -#, no-wrap -msgid "" -" #!/bin/bash -\n" -" \n" -msgstr "" - -#. type: verbatim #: ../fish/guestfish.pod:998 #, no-wrap msgid "" @@ -24459,7 +24210,7 @@ msgid "COMMANDS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1124 ../src/guestfs.pod:1613 +#: ../fish/guestfish.pod:1124 ../src/guestfs.pod:1694 msgid "@ACTIONS@" msgstr "" @@ -24483,17 +24234,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1140 ../src/guestfs.pod:3321 +#: ../fish/guestfish.pod:1140 ../src/guestfs.pod:3377 msgid "FEBOOTSTRAP_KERNEL" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1142 ../src/guestfs.pod:3323 +#: ../fish/guestfish.pod:1142 ../src/guestfs.pod:3379 msgid "FEBOOTSTRAP_MODULES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1144 ../src/guestfs.pod:3325 +#: ../fish/guestfish.pod:1144 ../src/guestfs.pod:3381 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 " @@ -24551,51 +24302,39 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1172 ../src/guestfs.pod:3331 +#: ../fish/guestfish.pod:1172 ../src/guestfs.pod:3387 msgid "LIBGUESTFS_APPEND" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1174 ../src/guestfs.pod:3333 +#: ../fish/guestfish.pod:1174 ../src/guestfs.pod:3389 msgid "Pass additional options to the guest kernel." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1176 ../src/guestfs.pod:3335 -msgid "LIBGUESTFS_ATTACH_METHOD" -msgstr "" - -#. type: textblock -#: ../fish/guestfish.pod:1178 -msgid "" -"Choose the default way to create the appliance. See " -"L<guestfs(3)/guestfs_set_attach_method>." -msgstr "" - -#. type: =item -#: ../fish/guestfish.pod:1181 ../src/guestfs.pod:3340 +#: ../fish/guestfish.pod:1176 ../src/guestfs.pod:3391 msgid "LIBGUESTFS_DEBUG" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1183 +#: ../fish/guestfish.pod:1178 msgid "" "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages. This has the same " "effect as using the B<-v> option." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1186 ../src/guestfs.pod:3345 +#: ../fish/guestfish.pod:1181 ../src/guestfs.pod:3396 msgid "LIBGUESTFS_MEMSIZE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1188 ../src/guestfs.pod:3347 +#: ../fish/guestfish.pod:1183 ../src/guestfs.pod:3398 msgid "Set the memory allocated to the qemu process, in megabytes. For example:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1191 ../src/guestfs.pod:3350 +#: ../fish/guestfish.pod:1186 ../src/guestfs.pod:3401 #, no-wrap msgid "" " LIBGUESTFS_MEMSIZE=700\n" @@ -24603,65 +24342,65 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1193 ../src/guestfs.pod:3352 +#: ../fish/guestfish.pod:1188 ../src/guestfs.pod:3403 msgid "LIBGUESTFS_PATH" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1195 +#: ../fish/guestfish.pod:1190 msgid "" "Set the path that guestfish uses to search for kernel and initrd.img. See " "the discussion of paths in L<guestfs(3)>." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1198 ../src/guestfs.pod:3357 +#: ../fish/guestfish.pod:1193 ../src/guestfs.pod:3408 msgid "LIBGUESTFS_QEMU" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1200 ../src/guestfs.pod:3359 +#: ../fish/guestfish.pod:1195 ../src/guestfs.pod:3410 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:1204 ../src/guestfs.pod:3365 +#: ../fish/guestfish.pod:1199 ../src/guestfs.pod:3416 msgid "LIBGUESTFS_TRACE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1206 +#: ../fish/guestfish.pod:1201 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1208 +#: ../fish/guestfish.pod:1203 msgid "PAGER" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1210 +#: ../fish/guestfish.pod:1205 msgid "" "The C<more> command uses C<$PAGER> as the pager. If not set, it uses " "C<more>." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1213 ../sparsify/virt-sparsify.pod:263 ../src/guestfs.pod:3370 +#: ../fish/guestfish.pod:1208 ../sparsify/virt-sparsify.pod:276 ../src/guestfs.pod:3421 msgid "TMPDIR" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1215 ../src/guestfs.pod:3372 +#: ../fish/guestfish.pod:1210 ../src/guestfs.pod:3423 msgid "" "Location of temporary directory, defaults to C</tmp> except for the cached " "supermin appliance which defaults to C</var/tmp>." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1218 ../src/guestfs.pod:3375 +#: ../fish/guestfish.pod:1213 ../src/guestfs.pod:3426 msgid "" "If libguestfs was compiled to use the supermin appliance then the real " "appliance is cached in this directory, shared between all handles belonging " @@ -24670,56 +24409,56 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:1226 ../fuse/guestmount.pod:378 ../rescue/virt-rescue.pod:325 +#: ../fish/guestfish.pod:1221 ../fuse/guestmount.pod:378 ../rescue/virt-rescue.pod:325 msgid "FILES" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1230 ../fuse/guestmount.pod:382 ../rescue/virt-rescue.pod:329 +#: ../fish/guestfish.pod:1225 ../fuse/guestmount.pod:382 ../rescue/virt-rescue.pod:329 msgid "$HOME/.libguestfs-tools.rc" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1232 ../fuse/guestmount.pod:384 ../rescue/virt-rescue.pod:331 +#: ../fish/guestfish.pod:1227 ../fuse/guestmount.pod:384 ../rescue/virt-rescue.pod:331 msgid "/etc/libguestfs-tools.conf" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1234 ../fuse/guestmount.pod:386 ../rescue/virt-rescue.pod:333 +#: ../fish/guestfish.pod:1229 ../fuse/guestmount.pod:386 ../rescue/virt-rescue.pod:333 msgid "" "This configuration file controls the default read-only or read-write mode " "(I<--ro> or I<--rw>)." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1237 +#: ../fish/guestfish.pod:1232 msgid "See L</OPENING DISKS FOR READ AND WRITE>." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1239 +#: ../fish/guestfish.pod:1234 msgid "$HOME/.guestfish" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1241 +#: ../fish/guestfish.pod:1236 msgid "" "If compiled with GNU readline support, then the command history is saved in " "this file." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1244 +#: ../fish/guestfish.pod:1239 msgid "$HOME/.inputrc" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1246 +#: ../fish/guestfish.pod:1241 msgid "/etc/inputrc" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1248 +#: ../fish/guestfish.pod:1243 msgid "" "If compiled with GNU readline support, then these files can be used to " "configure readline. For further information, please see " @@ -24727,12 +24466,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1252 +#: ../fish/guestfish.pod:1247 msgid "To write rules which only apply to guestfish, use:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1254 +#: ../fish/guestfish.pod:1249 #, no-wrap msgid "" " $if guestfish\n" @@ -24742,26 +24481,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1258 +#: ../fish/guestfish.pod:1253 msgid "" "Variables that you can set in inputrc that change the behaviour of guestfish " "in useful ways include:" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1263 +#: ../fish/guestfish.pod:1258 msgid "completion-ignore-case (default: on)" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1265 +#: ../fish/guestfish.pod:1260 msgid "" "By default, guestfish will ignore case when tab-completing paths on the " "disk. Use:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1268 +#: ../fish/guestfish.pod:1263 #, no-wrap msgid "" " set completion-ignore-case off\n" @@ -24769,22 +24508,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1270 +#: ../fish/guestfish.pod:1265 msgid "to make guestfish case sensitive." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1274 +#: ../fish/guestfish.pod:1269 msgid "test1.img" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1276 +#: ../fish/guestfish.pod:1271 msgid "test2.img (etc)" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1278 +#: ../fish/guestfish.pod:1273 msgid "" "When using the I<-N> or I<--new> option, the prepared disk or filesystem " "will be created in the file C<test1.img> in the current directory. The " @@ -24793,7 +24532,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1287 +#: ../fish/guestfish.pod:1282 msgid "" "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-alignment-scan(1)>, " "L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-df(1)>, " @@ -24899,11 +24638,6 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/virt-copy-in.pod:66 ../fish/virt-copy-out.pod:55 ../fish/virt-tar-in.pod:64 ../fish/virt-tar-out.pod:57 -msgid "Copyright (C) 2011 Red Hat Inc. L<http://libguestfs.org/>" -msgstr "" - -#. type: textblock #: ../fish/virt-copy-out.pod:5 msgid "" "virt-copy-out - Copy files and directories out of a virtual machine disk " @@ -25303,7 +25037,7 @@ msgid "Create no logical volume. This is the default." msgstr "" #. type: =item -#: ../format/virt-format.pod:125 ../tools/virt-make-fs.pl:261 +#: ../format/virt-format.pod:125 ../tools/virt-make-fs.pl:247 msgid "B<--partition>" msgstr "" @@ -25385,11 +25119,6 @@ msgid "" msgstr "" #. type: textblock -#: ../format/virt-format.pod:193 -msgid "Copyright (C) 2012 Red Hat Inc." -msgstr "" - -#. type: textblock #: ../fuse/guestmount.pod:5 msgid "guestmount - Mount a guest filesystem on the host using FUSE and libguestfs" msgstr "" @@ -26120,7 +25849,7 @@ msgid "" msgstr "" #. type: textblock -#: ../inspector/virt-inspector.pod:110 ../resize/virt-resize.pod:397 ../resize/virt-resize.pod:489 ../sparsify/virt-sparsify.pod:139 ../tools/virt-list-filesystems.pl:103 ../tools/virt-list-partitions.pl:104 ../tools/virt-tar.pl:151 ../tools/virt-win-reg.pl:152 +#: ../inspector/virt-inspector.pod:110 ../resize/virt-resize.pod:397 ../resize/virt-resize.pod:489 ../sparsify/virt-sparsify.pod:152 ../tools/virt-list-filesystems.pl:103 ../tools/virt-list-partitions.pl:104 ../tools/virt-tar.pl:151 ../tools/virt-win-reg.pl:152 msgid "" "If working with untrusted raw-format guest disk images, you should ensure " "the format is always specified." @@ -28129,7 +27858,7 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:268 ../sparsify/virt-sparsify.pod:100 +#: ../resize/virt-resize.pod:268 ../sparsify/virt-sparsify.pod:113 msgid "Display help." msgstr "" @@ -28253,7 +27982,7 @@ msgid "B<-d>" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:328 ../tools/virt-make-fs.pl:180 ../tools/virt-win-reg.pl:120 +#: ../resize/virt-resize.pod:328 ../tools/virt-make-fs.pl:175 ../tools/virt-win-reg.pl:120 msgid "B<--debug>" msgstr "" @@ -28263,7 +27992,7 @@ msgid "Enable debugging messages." msgstr "" #. type: =item -#: ../resize/virt-resize.pod:332 ../sparsify/virt-sparsify.pod:126 +#: ../resize/virt-resize.pod:332 ../sparsify/virt-sparsify.pod:139 msgid "B<--debug-gc>" msgstr "" @@ -28296,7 +28025,7 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:349 ../resize/virt-resize.pod:410 ../resize/virt-resize.pod:537 ../sparsify/virt-sparsify.pod:152 +#: ../resize/virt-resize.pod:349 ../resize/virt-resize.pod:410 ../resize/virt-resize.pod:537 ../sparsify/virt-sparsify.pod:165 msgid "You can give this option multiple times." msgstr "" @@ -28364,12 +28093,12 @@ msgid "Note that you cannot use I<--expand> and I<--shrink> together." msgstr "" #. type: =item -#: ../resize/virt-resize.pod:392 ../sparsify/virt-sparsify.pod:132 ../tools/virt-list-filesystems.pl:93 ../tools/virt-list-partitions.pl:94 ../tools/virt-tar.pl:141 ../tools/virt-win-reg.pl:142 +#: ../resize/virt-resize.pod:392 ../sparsify/virt-sparsify.pod:145 ../tools/virt-list-filesystems.pl:93 ../tools/virt-list-partitions.pl:94 ../tools/virt-tar.pl:141 ../tools/virt-win-reg.pl:142 msgid "B<--format> raw" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:394 ../sparsify/virt-sparsify.pod:136 +#: ../resize/virt-resize.pod:394 ../sparsify/virt-sparsify.pod:149 msgid "" "Specify the format of the input disk image. If this flag is not given then " "it is auto-detected from the image itself." @@ -28448,12 +28177,12 @@ msgid "" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:435 ../sparsify/virt-sparsify.pod:154 +#: ../resize/virt-resize.pod:435 ../sparsify/virt-sparsify.pod:167 msgid "B<--machine-readable>" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:437 ../sparsify/virt-sparsify.pod:156 +#: ../resize/virt-resize.pod:437 ../sparsify/virt-sparsify.pod:169 msgid "" "This option is used to make the output more machine friendly when being " "parsed by other programs. See L</MACHINE READABLE OUTPUT> below." @@ -28710,7 +28439,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../resize/virt-resize.pod:575 ../sparsify/virt-sparsify.pod:204 +#: ../resize/virt-resize.pod:575 ../sparsify/virt-sparsify.pod:217 msgid "MACHINE READABLE OUTPUT" msgstr "" @@ -28723,7 +28452,7 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:581 ../sparsify/virt-sparsify.pod:210 +#: ../resize/virt-resize.pod:581 ../sparsify/virt-sparsify.pod:223 msgid "There are two ways to use this option." msgstr "" @@ -28748,33 +28477,33 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:593 ../sparsify/virt-sparsify.pod:220 +#: ../resize/virt-resize.pod:593 ../sparsify/virt-sparsify.pod:233 msgid "" "A list of features is printed, one per line, and the program exits with " "status 0." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:596 ../sparsify/virt-sparsify.pod:223 +#: ../resize/virt-resize.pod:596 ../sparsify/virt-sparsify.pod:236 msgid "" "Secondly use the option in conjunction with other options to make the " "regular program output more machine friendly." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:599 ../sparsify/virt-sparsify.pod:226 +#: ../resize/virt-resize.pod:599 ../sparsify/virt-sparsify.pod:239 msgid "At the moment this means:" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:605 ../sparsify/virt-sparsify.pod:232 +#: ../resize/virt-resize.pod:605 ../sparsify/virt-sparsify.pod:245 msgid "" "Progress bar messages can be parsed from stdout by looking for this regular " "expression:" msgstr "" #. type: verbatim -#: ../resize/virt-resize.pod:608 ../sparsify/virt-sparsify.pod:235 +#: ../resize/virt-resize.pod:608 ../sparsify/virt-sparsify.pod:248 #, no-wrap msgid "" " ^[0-9]+/[0-9]+$\n" @@ -28782,7 +28511,7 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:612 ../sparsify/virt-sparsify.pod:239 +#: ../resize/virt-resize.pod:612 ../sparsify/virt-sparsify.pod:252 msgid "" "The calling program should treat messages sent to stdout (except for " "progress bar messages) as status messages. They can be logged and/or " @@ -29016,11 +28745,24 @@ msgstr "" #. type: =head2 #: ../sparsify/virt-sparsify.pod:28 +msgid "IMPORTANT NOTE ABOUT SPARSE OUTPUT IMAGES" +msgstr "" + +#. type: textblock +#: ../sparsify/virt-sparsify.pod:30 +msgid "" +"If the input is raw, then the default output is raw sparse. B<You must " +"check the output size using a tool that understands sparseness> such as C<du " +"-sh>. It can make a huge difference:" +msgstr "" + +#. type: =head2 +#: ../sparsify/virt-sparsify.pod:41 msgid "IMPORTANT LIMITATIONS" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:34 +#: ../sparsify/virt-sparsify.pod:47 msgid "" "Virt-sparsify does not do in-place modifications. It copies from a source " "image to a destination image, leaving the source unchanged. I<Check that " @@ -29028,12 +28770,12 @@ msgid "" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:41 +#: ../sparsify/virt-sparsify.pod:54 msgid "The virtual machine I<must be shut down> before using this tool." msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:45 +#: ../sparsify/virt-sparsify.pod:58 msgid "" "Virt-sparsify may require up to 2x the virtual size of the source disk image " "(1 temporary copy + 1 destination image). This is in the worst case and " @@ -29041,19 +28783,19 @@ msgid "" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:51 +#: ../sparsify/virt-sparsify.pod:64 msgid "Virt-sparsify cannot resize disk images. To do that, use L<virt-resize(1)>." msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:56 +#: ../sparsify/virt-sparsify.pod:69 msgid "" "Virt-sparsify cannot handle encrypted disks. Libguestfs supports encrypted " "disks, but encrypted disks themselves cannot be sparsified." msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:61 +#: ../sparsify/virt-sparsify.pod:74 msgid "" "Virt-sparsify cannot yet sparsify the space between partitions. Note that " "this space is often used for critical items like bootloaders so it's not " @@ -29061,19 +28803,19 @@ msgid "" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:67 +#: ../sparsify/virt-sparsify.pod:80 msgid "" "You may also want to read the manual pages for the associated tools " "L<virt-filesystems(1)> and L<virt-df(1)> before starting." msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:72 +#: ../sparsify/virt-sparsify.pod:85 msgid "Typical usage is:" msgstr "" #. type: verbatim -#: ../sparsify/virt-sparsify.pod:74 +#: ../sparsify/virt-sparsify.pod:87 #, no-wrap msgid "" " virt-sparsify indisk outdisk\n" @@ -29081,7 +28823,7 @@ msgid "" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:76 +#: ../sparsify/virt-sparsify.pod:89 msgid "" "which copies C<indisk> to C<outdisk>, making the output sparse. C<outdisk> " "is created, or overwritten if it already exists. The format of the input " @@ -29090,12 +28832,12 @@ msgid "" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:81 +#: ../sparsify/virt-sparsify.pod:94 msgid "To convert between formats, use the I<--convert> option:" msgstr "" #. type: verbatim -#: ../sparsify/virt-sparsify.pod:83 +#: ../sparsify/virt-sparsify.pod:96 #, no-wrap msgid "" " virt-sparsify disk.raw --convert qcow2 disk.qcow2\n" @@ -29103,7 +28845,7 @@ msgid "" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:85 +#: ../sparsify/virt-sparsify.pod:98 msgid "" "Virt-sparsify tries to zero and sparsify free space on every filesystem it " "can find within the source disk image. You can get it to ignore (don't zero " @@ -29111,7 +28853,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../sparsify/virt-sparsify.pod:89 +#: ../sparsify/virt-sparsify.pod:102 #, no-wrap msgid "" " virt-sparsify --ignore /dev/sda1 indisk outdisk\n" @@ -29119,111 +28861,111 @@ msgid "" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:91 +#: ../sparsify/virt-sparsify.pod:104 msgid "See L<virt-filesystems(1)> to get a list of filesystems within a disk image." msgstr "" #. type: =item -#: ../sparsify/virt-sparsify.pod:102 +#: ../sparsify/virt-sparsify.pod:115 msgid "B<--compress>" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:104 +#: ../sparsify/virt-sparsify.pod:117 msgid "" "Compress the output file. This I<only> works if the output format is " "C<qcow2>." msgstr "" #. type: =item -#: ../sparsify/virt-sparsify.pod:107 +#: ../sparsify/virt-sparsify.pod:120 msgid "B<--convert> raw" msgstr "" #. type: =item -#: ../sparsify/virt-sparsify.pod:109 +#: ../sparsify/virt-sparsify.pod:122 msgid "B<--convert> qcow2" msgstr "" #. type: =item -#: ../sparsify/virt-sparsify.pod:111 +#: ../sparsify/virt-sparsify.pod:124 msgid "B<--convert> [other formats]" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:113 +#: ../sparsify/virt-sparsify.pod:126 msgid "" "Use C<output-format> as the format for the destination image. If this is " "not specified, then the input format is used." msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:116 +#: ../sparsify/virt-sparsify.pod:129 msgid "Supported and known-working output formats are: C<raw>, C<qcow2>, C<vdi>." msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:118 +#: ../sparsify/virt-sparsify.pod:131 msgid "" "You can also use any format supported by the L<qemu-img(1)> program, " "eg. C<vmdk>, but support for other formats is reliant on qemu." msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:121 +#: ../sparsify/virt-sparsify.pod:134 msgid "" "Specifying the I<--convert> option is usually a good idea, because then " "virt-sparsify doesn't need to try to guess the input format." msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:124 +#: ../sparsify/virt-sparsify.pod:137 msgid "For fine-tuning the output format, see: I<--compress>, I<-o>." msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:128 +#: ../sparsify/virt-sparsify.pod:141 msgid "" "Debug garbage collection and memory allocation. This is only useful when " "debugging memory problems in virt-sparsify or the OCaml libguestfs bindings." msgstr "" #. type: =item -#: ../sparsify/virt-sparsify.pod:134 +#: ../sparsify/virt-sparsify.pod:147 msgid "B<--format> qcow2" msgstr "" #. type: =item -#: ../sparsify/virt-sparsify.pod:142 +#: ../sparsify/virt-sparsify.pod:155 msgid "B<--ignore> filesystem" msgstr "" #. type: =item -#: ../sparsify/virt-sparsify.pod:144 +#: ../sparsify/virt-sparsify.pod:157 msgid "B<--ignore> volgroup" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:146 +#: ../sparsify/virt-sparsify.pod:159 msgid "" "Ignore the named filesystem. Free space on the filesystem will not be " "zeroed, but existing blocks of zeroes will still be sparsified." msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:149 +#: ../sparsify/virt-sparsify.pod:162 msgid "" "In the second form, this ignores the named volume group. Use the volume " "group name without the C</dev/> prefix, eg. I<--ignore vg_foo>" msgstr "" #. type: =item -#: ../sparsify/virt-sparsify.pod:160 +#: ../sparsify/virt-sparsify.pod:173 msgid "B<-o> option[,option,...]" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:162 +#: ../sparsify/virt-sparsify.pod:175 msgid "" "Pass I<-o> option(s) to the L<qemu-img(1)> command to fine-tune the output " "format. Options available depend on the output format (see I<--convert>) " @@ -29231,14 +28973,14 @@ msgid "" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:166 +#: ../sparsify/virt-sparsify.pod:179 msgid "" "You should use I<-o> at most once. To pass multiple options, separate them " "with commas, eg:" msgstr "" #. type: verbatim -#: ../sparsify/virt-sparsify.pod:169 +#: ../sparsify/virt-sparsify.pod:182 #, no-wrap msgid "" " virt-sparsify --convert qcow2 \\\n" @@ -29247,22 +28989,22 @@ msgid "" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:176 +#: ../sparsify/virt-sparsify.pod:189 msgid "This disables progress bars and other unnecessary output." msgstr "" #. type: =item -#: ../sparsify/virt-sparsify.pod:194 +#: ../sparsify/virt-sparsify.pod:207 msgid "B<--zero> partition" msgstr "" #. type: =item -#: ../sparsify/virt-sparsify.pod:196 +#: ../sparsify/virt-sparsify.pod:209 msgid "B<--zero> logvol" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:198 +#: ../sparsify/virt-sparsify.pod:211 msgid "" "Zero the contents of the named partition or logical volume in the guest. " "All data on the device is lost, but sparsification is excellent! You can " @@ -29270,7 +29012,7 @@ msgid "" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:206 +#: ../sparsify/virt-sparsify.pod:219 msgid "" "The I<--machine-readable> option can be used to make the output more machine " "friendly, which is useful when calling virt-sparsify from other programs, " @@ -29278,14 +29020,14 @@ msgid "" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:212 +#: ../sparsify/virt-sparsify.pod:225 msgid "" "Firstly use the option on its own to query the capabilities of the " "virt-sparsify binary. Typical output looks like this:" msgstr "" #. type: verbatim -#: ../sparsify/virt-sparsify.pod:215 +#: ../sparsify/virt-sparsify.pod:228 #, no-wrap msgid "" " $ virt-sparsify --machine-readable\n" @@ -29296,7 +29038,7 @@ msgid "" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:245 +#: ../sparsify/virt-sparsify.pod:258 msgid "" "The calling program should treat messages sent to stderr as error messages. " "In addition, virt-sparsify exits with a non-zero status code if there was a " @@ -29304,21 +29046,21 @@ msgid "" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:251 +#: ../sparsify/virt-sparsify.pod:264 msgid "" "All versions of virt-sparsify have supported the I<--machine-readable> " "option." msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:265 +#: ../sparsify/virt-sparsify.pod:278 msgid "" "Location of the temporary directory used for the potentially large temporary " "overlay file." msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:268 +#: ../sparsify/virt-sparsify.pod:281 msgid "" "You should ensure there is enough free space in the worst case for a full " "copy of the source disk (I<virtual> size), or else set C<$TMPDIR> to point " @@ -29326,12 +29068,12 @@ msgid "" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:272 +#: ../sparsify/virt-sparsify.pod:285 msgid "This defaults to C</tmp>." msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:274 +#: ../sparsify/virt-sparsify.pod:287 msgid "" "Note that if C<$TMPDIR> is a tmpfs (eg. if C</tmp> is on tmpfs, or if you " "use C<TMPDIR=/dev/shm>), tmpfs defaults to a maximum size of I<half> of " @@ -29341,7 +29083,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../sparsify/virt-sparsify.pod:280 +#: ../sparsify/virt-sparsify.pod:293 #, no-wrap msgid "" " mount -o remount,size=10G /tmp\n" @@ -29349,12 +29091,12 @@ msgid "" msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:284 +#: ../sparsify/virt-sparsify.pod:297 msgid "For other environment variables, see L<guestfs(3)/ENVIRONMENT VARIABLES>." msgstr "" #. type: textblock -#: ../sparsify/virt-sparsify.pod:288 +#: ../sparsify/virt-sparsify.pod:301 msgid "" "L<virt-filesystems(1)>, L<virt-df(1)>, L<virt-resize(1)>, L<virt-rescue(1)>, " "L<guestfs(3)>, L<guestfish(1)>, L<truncate(1)>, L<fallocate(1)>, " @@ -29377,36 +29119,46 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7 ../src/guestfs-actions.pod:280 ../src/guestfs-actions.pod:301 +#: ../src/guestfs-actions.pod:7 ../src/guestfs-actions.pod:305 ../src/guestfs-actions.pod:326 msgid "" -"I<This function is deprecated.> In new code, use the L</guestfs_add_drive> " -"call instead." +"I<This function is deprecated.> In new code, use the " +"L</guestfs_add_drive_opts> call instead." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:24 +msgid "" +"This call checks for the existence of C<filename>. This stops you from " +"specifying other types of drive which are supported by qemu such as C<nbd:> " +"and C<http:> URLs. To specify those, use the general C<guestfs_config> call " +"instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:16 +#: ../src/guestfs-actions.pod:31 msgid "" -"B<Do not use this function!> ISO files are just ordinary read-only disk " -"images. Use C<guestfs_add_drive_ro> instead." +"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 " +"C<guestfs_add_drive_ro> instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:19 ../src/guestfs-actions.pod:232 ../src/guestfs-actions.pod:269 ../src/guestfs-actions.pod:290 ../src/guestfs-actions.pod:311 ../src/guestfs-actions.pod:324 ../src/guestfs-actions.pod:338 ../src/guestfs-actions.pod:458 ../src/guestfs-actions.pod:478 ../src/guestfs-actions.pod:492 ../src/guestfs-actions.pod:537 ../src/guestfs-actions.pod:565 ../src/guestfs-actions.pod:583 ../src/guestfs-actions.pod:652 ../src/guestfs-actions.pod:685 ../src/guestfs-actions.pod:699 ../src/guestfs-actions.pod:755 ../src/guestfs-actions.pod:854 ../src/guestfs-actions.pod:872 ../src/guestfs-actions.pod:886 ../src/guestfs-actions.pod:900 ../src/guestfs-actions.pod:914 ../src/guestfs-actions.pod:928 ../src/guestfs-actions.pod:941 ../src/guestfs-actions.pod:978 ../src/guestfs-actions.pod:1012 ../src/guestfs-actions.pod:1034 ../src/guestfs-actions.pod:1070 ../src/guestfs-actions.pod:1083 ../src/guestfs-actions.pod:1095 ../src/guestfs-actions.pod:1125 ../src/guestfs-actions.pod:1140 ../src/guestfs-actions.pod:1336 ../src/guestfs-actions.pod:1356 ../src/guestfs-actions.pod:1374 ../src/guestfs-actions.pod:1464 ../src/guestfs-actions.pod:1523 ../src/guestfs-actions.pod:1569 ../src/guestfs-actions.pod:1609 ../src/guestfs-actions.pod:1662 ../src/guestfs-actions.pod:1715 ../src/guestfs-actions.pod:1773 ../src/guestfs-actions.pod:1827 ../src/guestfs-actions.pod:1846 ../src/guestfs-actions.pod:1860 ../src/guestfs-actions.pod:1888 ../src/guestfs-actions.pod:1976 ../src/guestfs-actions.pod:2007 ../src/guestfs-actions.pod:2032 ../src/guestfs-actions.pod:2098 ../src/guestfs-actions.pod:2141 ../src/guestfs-actions.pod:2268 ../src/guestfs-actions.pod:2295 ../src/guestfs-actions.pod:2547 ../src/guestfs-actions.pod:2569 ../src/guestfs-actions.pod:2656 ../src/guestfs-actions.pod:2767 ../src/guestfs-actions.pod:3446 ../src/guestfs-actions.pod:3590 ../src/guestfs-actions.pod:3649 ../src/guestfs-actions.pod:3684 ../src/guestfs-actions.pod:4797 ../src/guestfs-actions.pod:4812 ../src/guestfs-actions.pod:4837 ../src/guestfs-actions.pod:5055 ../src/guestfs-actions.pod:5069 ../src/guestfs-actions.pod:5082 ../src/guestfs-actions.pod:5096 ../src/guestfs-actions.pod:5111 ../src/guestfs-actions.pod:5147 ../src/guestfs-actions.pod:5219 ../src/guestfs-actions.pod:5239 ../src/guestfs-actions.pod:5256 ../src/guestfs-actions.pod:5276 ../src/guestfs-actions.pod:5296 ../src/guestfs-actions.pod:5331 ../src/guestfs-actions.pod:5350 ../src/guestfs-actions.pod:5369 ../src/guestfs-actions.pod:5386 ../src/guestfs-actions.pod:5421 ../src/guestfs-actions.pod:5433 ../src/guestfs-actions.pod:5466 ../src/guestfs-actions.pod:5482 ../src/guestfs-actions.pod:5495 ../src/guestfs-actions.pod:5510 ../src/guestfs-actions.pod:5527 ../src/guestfs-actions.pod:5703 ../src/guestfs-actions.pod:5839 ../src/guestfs-actions.pod:5851 ../src/guestfs-actions.pod:5871 ../src/guestfs-actions.pod:5884 ../src/guestfs-actions.pod:5935 ../src/guestfs-actions.pod:5953 ../src/guestfs-actions.pod:5971 ../src/guestfs-actions.pod:5987 ../src/guestfs-actions.pod:6001 ../src/guestfs-actions.pod:6015 ../src/guestfs-actions.pod:6032 ../src/guestfs-actions.pod:6109 ../src/guestfs-actions.pod:6160 ../src/guestfs-actions.pod:6193 ../src/guestfs-actions.pod:6264 ../src/guestfs-actions.pod:6295 ../src/guestfs-actions.pod:6314 ../src/guestfs-actions.pod:6333 ../src/guestfs-actions.pod:6345 ../src/guestfs-actions.pod:6362 ../src/guestfs-actions.pod:6375 ../src/guestfs-actions.pod:6390 ../src/guestfs-actions.pod:6405 ../src/guestfs-actions.pod:6437 ../src/guestfs-actions.pod:6463 ../src/guestfs-actions.pod:6532 ../src/guestfs-actions.pod:6581 ../src/guestfs-actions.pod:6596 ../src/guestfs-actions.pod:6616 ../src/guestfs-actions.pod:6630 ../src/guestfs-actions.pod:6647 ../src/guestfs-actions.pod:6696 ../src/guestfs-actions.pod:6748 ../src/guestfs-actions.pod:6786 ../src/guestfs-actions.pod:6838 ../src/guestfs-actions.pod:6920 ../src/guestfs-actions.pod:6963 ../src/guestfs-actions.pod:6991 ../src/guestfs-actions.pod:7008 ../src/guestfs-actions.pod:7026 ../src/guestfs-actions.pod:7163 ../src/guestfs-actions.pod:7220 ../src/guestfs-actions.pod:7242 ../src/guestfs-actions.pod:7260 ../src/guestfs-actions.pod:7312 ../src/guestfs-actions.pod:7376 ../src/guestfs-actions.pod:7385 ../src/guestfs-actions.pod:7397 ../src/guestfs-actions.pod:7414 ../src/guestfs-actions.pod:7427 ../src/guestfs-actions.pod:7441 ../src/guestfs-actions.pod:7730 ../src/guestfs-actions.pod:7745 ../src/guestfs-actions.pod:7766 ../src/guestfs-actions.pod:7782 ../src/guestfs-actions.pod:7794 ../src/guestfs-actions.pod:7808 ../src/guestfs-actions.pod:7820 ../src/guestfs-actions.pod:7834 ../src/guestfs-actions.pod:7850 ../src/guestfs-actions.pod:7868 ../src/guestfs-actions.pod:7887 ../src/guestfs-actions.pod:7906 ../src/guestfs-actions.pod:7969 ../src/guestfs-actions.pod:7987 ../src/guestfs-actions.pod:8010 ../src/guestfs-actions.pod:8049 ../src/guestfs-actions.pod:8088 ../src/guestfs-actions.pod:8113 ../src/guestfs-actions.pod:8132 ../src/guestfs-actions.pod:8154 ../src/guestfs-actions.pod:8175 ../src/guestfs-actions.pod:8194 ../src/guestfs-actions.pod:8211 ../src/guestfs-actions.pod:8232 ../src/guestfs-actions.pod:8260 ../src/guestfs-actions.pod:8284 ../src/guestfs-actions.pod:8303 ../src/guestfs-actions.pod:8319 ../src/guestfs-actions.pod:8343 ../src/guestfs-actions.pod:8362 ../src/guestfs-actions.pod:8377 ../src/guestfs-actions.pod:8396 ../src/guestfs-actions.pod:8440 ../src/guestfs-actions.pod:8467 ../src/guestfs-actions.pod:8497 ../src/guestfs-actions.pod:8622 ../src/guestfs-actions.pod:8632 ../src/guestfs-actions.pod:8753 ../src/guestfs-actions.pod:8765 ../src/guestfs-actions.pod:8778 ../src/guestfs-actions.pod:8791 ../src/guestfs-actions.pod:8813 ../src/guestfs-actions.pod:8826 ../src/guestfs-actions.pod:8839 ../src/guestfs-actions.pod:8852 ../src/guestfs-actions.pod:8867 ../src/guestfs-actions.pod:8926 ../src/guestfs-actions.pod:8943 ../src/guestfs-actions.pod:8959 ../src/guestfs-actions.pod:8975 ../src/guestfs-actions.pod:8992 ../src/guestfs-actions.pod:9005 ../src/guestfs-actions.pod:9025 ../src/guestfs-actions.pod:9125 ../src/guestfs-actions.pod:9183 ../src/guestfs-actions.pod:9197 ../src/guestfs-actions.pod:9260 ../src/guestfs-actions.pod:9293 ../src/guestfs-actions.pod:9315 ../src/guestfs-actions.pod:9353 ../src/guestfs-actions.pod:9387 ../src/guestfs-actions.pod:9423 ../src/guestfs-actions.pod:9552 ../src/guestfs-actions.pod:9567 ../src/guestfs-actions.pod:9579 ../src/guestfs-actions.pod:9588 ../src/guestfs-actions.pod:9600 ../src/guestfs-actions.pod:9674 ../src/guestfs-actions.pod:9687 ../src/guestfs-actions.pod:9732 ../src/guestfs-actions.pod:9772 ../src/guestfs-actions.pod:9830 ../src/guestfs-actions.pod:9847 ../src/guestfs-actions.pod:9867 ../src/guestfs-actions.pod:9900 ../src/guestfs-actions.pod:10047 ../src/guestfs-actions.pod:10070 ../src/guestfs-actions.pod:10095 ../src/guestfs-actions.pod:10121 +#: ../src/guestfs-actions.pod:37 ../src/guestfs-actions.pod:187 ../src/guestfs-actions.pod:257 ../src/guestfs-actions.pod:294 ../src/guestfs-actions.pod:315 ../src/guestfs-actions.pod:336 ../src/guestfs-actions.pod:349 ../src/guestfs-actions.pod:363 ../src/guestfs-actions.pod:483 ../src/guestfs-actions.pod:503 ../src/guestfs-actions.pod:517 ../src/guestfs-actions.pod:562 ../src/guestfs-actions.pod:590 ../src/guestfs-actions.pod:608 ../src/guestfs-actions.pod:675 ../src/guestfs-actions.pod:708 ../src/guestfs-actions.pod:722 ../src/guestfs-actions.pod:778 ../src/guestfs-actions.pod:877 ../src/guestfs-actions.pod:895 ../src/guestfs-actions.pod:909 ../src/guestfs-actions.pod:923 ../src/guestfs-actions.pod:937 ../src/guestfs-actions.pod:951 ../src/guestfs-actions.pod:964 ../src/guestfs-actions.pod:1001 ../src/guestfs-actions.pod:1035 ../src/guestfs-actions.pod:1057 ../src/guestfs-actions.pod:1093 ../src/guestfs-actions.pod:1106 ../src/guestfs-actions.pod:1118 ../src/guestfs-actions.pod:1148 ../src/guestfs-actions.pod:1163 ../src/guestfs-actions.pod:1324 ../src/guestfs-actions.pod:1344 ../src/guestfs-actions.pod:1362 ../src/guestfs-actions.pod:1452 ../src/guestfs-actions.pod:1511 ../src/guestfs-actions.pod:1557 ../src/guestfs-actions.pod:1597 ../src/guestfs-actions.pod:1650 ../src/guestfs-actions.pod:1703 ../src/guestfs-actions.pod:1761 ../src/guestfs-actions.pod:1815 ../src/guestfs-actions.pod:1834 ../src/guestfs-actions.pod:1848 ../src/guestfs-actions.pod:1876 ../src/guestfs-actions.pod:1962 ../src/guestfs-actions.pod:1993 ../src/guestfs-actions.pod:2018 ../src/guestfs-actions.pod:2084 ../src/guestfs-actions.pod:2127 ../src/guestfs-actions.pod:2240 ../src/guestfs-actions.pod:2267 ../src/guestfs-actions.pod:2482 ../src/guestfs-actions.pod:2504 ../src/guestfs-actions.pod:2591 ../src/guestfs-actions.pod:3242 ../src/guestfs-actions.pod:3386 ../src/guestfs-actions.pod:3445 ../src/guestfs-actions.pod:3480 ../src/guestfs-actions.pod:4593 ../src/guestfs-actions.pod:4608 ../src/guestfs-actions.pod:4633 ../src/guestfs-actions.pod:4851 ../src/guestfs-actions.pod:4865 ../src/guestfs-actions.pod:4878 ../src/guestfs-actions.pod:4892 ../src/guestfs-actions.pod:4907 ../src/guestfs-actions.pod:4943 ../src/guestfs-actions.pod:5015 ../src/guestfs-actions.pod:5035 ../src/guestfs-actions.pod:5052 ../src/guestfs-actions.pod:5072 ../src/guestfs-actions.pod:5092 ../src/guestfs-actions.pod:5127 ../src/guestfs-actions.pod:5146 ../src/guestfs-actions.pod:5165 ../src/guestfs-actions.pod:5182 ../src/guestfs-actions.pod:5217 ../src/guestfs-actions.pod:5229 ../src/guestfs-actions.pod:5262 ../src/guestfs-actions.pod:5278 ../src/guestfs-actions.pod:5291 ../src/guestfs-actions.pod:5306 ../src/guestfs-actions.pod:5323 ../src/guestfs-actions.pod:5481 ../src/guestfs-actions.pod:5617 ../src/guestfs-actions.pod:5629 ../src/guestfs-actions.pod:5649 ../src/guestfs-actions.pod:5662 ../src/guestfs-actions.pod:5713 ../src/guestfs-actions.pod:5731 ../src/guestfs-actions.pod:5749 ../src/guestfs-actions.pod:5765 ../src/guestfs-actions.pod:5779 ../src/guestfs-actions.pod:5793 ../src/guestfs-actions.pod:5810 ../src/guestfs-actions.pod:5825 ../src/guestfs-actions.pod:5852 ../src/guestfs-actions.pod:5885 ../src/guestfs-actions.pod:5970 ../src/guestfs-actions.pod:6043 ../src/guestfs-actions.pod:6074 ../src/guestfs-actions.pod:6093 ../src/guestfs-actions.pod:6112 ../src/guestfs-actions.pod:6124 ../src/guestfs-actions.pod:6141 ../src/guestfs-actions.pod:6154 ../src/guestfs-actions.pod:6169 ../src/guestfs-actions.pod:6184 ../src/guestfs-actions.pod:6216 ../src/guestfs-actions.pod:6242 ../src/guestfs-actions.pod:6311 ../src/guestfs-actions.pod:6360 ../src/guestfs-actions.pod:6375 ../src/guestfs-actions.pod:6395 ../src/guestfs-actions.pod:6409 ../src/guestfs-actions.pod:6426 ../src/guestfs-actions.pod:6475 ../src/guestfs-actions.pod:6527 ../src/guestfs-actions.pod:6565 ../src/guestfs-actions.pod:6617 ../src/guestfs-actions.pod:6669 ../src/guestfs-actions.pod:6716 ../src/guestfs-actions.pod:6759 ../src/guestfs-actions.pod:6787 ../src/guestfs-actions.pod:6804 ../src/guestfs-actions.pod:6822 ../src/guestfs-actions.pod:6959 ../src/guestfs-actions.pod:7016 ../src/guestfs-actions.pod:7038 ../src/guestfs-actions.pod:7056 ../src/guestfs-actions.pod:7108 ../src/guestfs-actions.pod:7174 ../src/guestfs-actions.pod:7191 ../src/guestfs-actions.pod:7204 ../src/guestfs-actions.pod:7218 ../src/guestfs-actions.pod:7507 ../src/guestfs-actions.pod:7522 ../src/guestfs-actions.pod:7543 ../src/guestfs-actions.pod:7559 ../src/guestfs-actions.pod:7571 ../src/guestfs-actions.pod:7585 ../src/guestfs-actions.pod:7597 ../src/guestfs-actions.pod:7611 ../src/guestfs-actions.pod:7627 ../src/guestfs-actions.pod:7645 ../src/guestfs-actions.pod:7664 ../src/guestfs-actions.pod:7683 ../src/guestfs-actions.pod:7713 ../src/guestfs-actions.pod:7731 ../src/guestfs-actions.pod:7754 ../src/guestfs-actions.pod:7793 ../src/guestfs-actions.pod:7832 ../src/guestfs-actions.pod:7857 ../src/guestfs-actions.pod:7876 ../src/guestfs-actions.pod:7898 ../src/guestfs-actions.pod:7919 ../src/guestfs-actions.pod:7938 ../src/guestfs-actions.pod:7955 ../src/guestfs-actions.pod:7976 ../src/guestfs-actions.pod:8004 ../src/guestfs-actions.pod:8028 ../src/guestfs-actions.pod:8047 ../src/guestfs-actions.pod:8063 ../src/guestfs-actions.pod:8087 ../src/guestfs-actions.pod:8106 ../src/guestfs-actions.pod:8121 ../src/guestfs-actions.pod:8140 ../src/guestfs-actions.pod:8184 ../src/guestfs-actions.pod:8211 ../src/guestfs-actions.pod:8241 ../src/guestfs-actions.pod:8366 ../src/guestfs-actions.pod:8376 ../src/guestfs-actions.pod:8497 ../src/guestfs-actions.pod:8509 ../src/guestfs-actions.pod:8522 ../src/guestfs-actions.pod:8535 ../src/guestfs-actions.pod:8557 ../src/guestfs-actions.pod:8570 ../src/guestfs-actions.pod:8583 ../src/guestfs-actions.pod:8596 ../src/guestfs-actions.pod:8611 ../src/guestfs-actions.pod:8670 ../src/guestfs-actions.pod:8687 ../src/guestfs-actions.pod:8703 ../src/guestfs-actions.pod:8719 ../src/guestfs-actions.pod:8736 ../src/guestfs-actions.pod:8749 ../src/guestfs-actions.pod:8769 ../src/guestfs-actions.pod:8869 ../src/guestfs-actions.pod:8927 ../src/guestfs-actions.pod:8941 ../src/guestfs-actions.pod:8982 ../src/guestfs-actions.pod:8995 ../src/guestfs-actions.pod:9017 ../src/guestfs-actions.pod:9055 ../src/guestfs-actions.pod:9089 ../src/guestfs-actions.pod:9125 ../src/guestfs-actions.pod:9241 ../src/guestfs-actions.pod:9256 ../src/guestfs-actions.pod:9270 ../src/guestfs-actions.pod:9344 ../src/guestfs-actions.pod:9357 ../src/guestfs-actions.pod:9402 ../src/guestfs-actions.pod:9442 ../src/guestfs-actions.pod:9500 ../src/guestfs-actions.pod:9517 ../src/guestfs-actions.pod:9537 ../src/guestfs-actions.pod:9570 ../src/guestfs-actions.pod:9634 ../src/guestfs-actions.pod:9657 ../src/guestfs-actions.pod:9681 ../src/guestfs-actions.pod:9707 msgid "This function returns 0 on success or -1 on error." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:21 ../src/guestfs-actions.pod:162 ../src/guestfs-actions.pod:1571 ../src/guestfs-actions.pod:2830 ../src/guestfs-actions.pod:3067 ../src/guestfs-actions.pod:3192 ../src/guestfs-actions.pod:4799 ../src/guestfs-actions.pod:4819 ../src/guestfs-actions.pod:6439 ../src/guestfs-actions.pod:7989 ../src/guestfs-actions.pod:8213 ../src/guestfs-actions.pod:8364 ../src/guestfs-actions.pod:8869 ../src/guestfs-actions.pod:8994 ../src/guestfs-actions.pod:9774 +#: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:189 ../src/guestfs-actions.pod:1559 ../src/guestfs-actions.pod:2705 ../src/guestfs-actions.pod:2942 ../src/guestfs-actions.pod:3067 ../src/guestfs-actions.pod:4595 ../src/guestfs-actions.pod:4615 ../src/guestfs-actions.pod:6218 ../src/guestfs-actions.pod:7733 ../src/guestfs-actions.pod:7957 ../src/guestfs-actions.pod:8108 ../src/guestfs-actions.pod:8613 ../src/guestfs-actions.pod:8738 ../src/guestfs-actions.pod:9444 msgid "(Added in 0.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:23 +#: ../src/guestfs-actions.pod:41 msgid "guestfs_add_domain" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:25 +#: ../src/guestfs-actions.pod:43 #, no-wrap msgid "" " int\n" @@ -29417,7 +29169,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:172 ../src/guestfs-actions.pod:952 ../src/guestfs-actions.pod:1023 ../src/guestfs-actions.pod:1451 ../src/guestfs-actions.pod:1503 ../src/guestfs-actions.pod:1581 ../src/guestfs-actions.pod:1650 ../src/guestfs-actions.pod:1703 ../src/guestfs-actions.pod:1756 ../src/guestfs-actions.pod:2068 ../src/guestfs-actions.pod:2740 ../src/guestfs-actions.pod:3308 ../src/guestfs-actions.pod:3953 ../src/guestfs-actions.pod:5638 ../src/guestfs-actions.pod:6058 ../src/guestfs-actions.pod:6171 ../src/guestfs-actions.pod:6449 ../src/guestfs-actions.pod:6498 ../src/guestfs-actions.pod:6760 ../src/guestfs-actions.pod:6821 ../src/guestfs-actions.pod:6884 ../src/guestfs-actions.pod:8022 ../src/guestfs-actions.pod:9036 ../src/guestfs-actions.pod:9248 ../src/guestfs-actions.pod:9303 ../src/guestfs-actions.pod:9914 +#: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:198 ../src/guestfs-actions.pod:975 ../src/guestfs-actions.pod:1046 ../src/guestfs-actions.pod:1439 ../src/guestfs-actions.pod:1491 ../src/guestfs-actions.pod:1569 ../src/guestfs-actions.pod:1638 ../src/guestfs-actions.pod:1691 ../src/guestfs-actions.pod:1744 ../src/guestfs-actions.pod:2054 ../src/guestfs-actions.pod:3749 ../src/guestfs-actions.pod:5416 ../src/guestfs-actions.pod:5863 ../src/guestfs-actions.pod:5919 ../src/guestfs-actions.pod:6228 ../src/guestfs-actions.pod:6277 ../src/guestfs-actions.pod:6539 ../src/guestfs-actions.pod:6600 ../src/guestfs-actions.pod:6680 ../src/guestfs-actions.pod:7766 ../src/guestfs-actions.pod:8780 ../src/guestfs-actions.pod:9005 msgid "" "You may supply a list of optional arguments to this call. Use zero or more " "of the following pairs of parameters, and terminate the list with C<-1> on " @@ -29425,7 +29177,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:35 +#: ../src/guestfs-actions.pod:53 #, no-wrap msgid "" " GUESTFS_ADD_DOMAIN_LIBVIRTURI, const char *libvirturi,\n" @@ -29438,7 +29190,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:42 +#: ../src/guestfs-actions.pod:60 msgid "" "This function adds the disk(s) attached to the named libvirt domain C<dom>. " "It works by connecting to libvirt, requesting the domain and domain XML from " @@ -29447,29 +29199,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:123 +#: ../src/guestfs-actions.pod:141 msgid "" "The other optional parameters are passed directly through to " "C<guestfs_add_drive_opts>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:126 ../src/guestfs-actions.pod:381 ../src/guestfs-actions.pod:551 ../src/guestfs-actions.pod:772 ../src/guestfs-actions.pod:803 ../src/guestfs-actions.pod:821 ../src/guestfs-actions.pod:840 ../src/guestfs-actions.pod:1906 ../src/guestfs-actions.pod:2052 ../src/guestfs-actions.pod:2503 ../src/guestfs-actions.pod:2729 ../src/guestfs-actions.pod:2978 ../src/guestfs-actions.pod:3039 ../src/guestfs-actions.pod:3090 ../src/guestfs-actions.pod:3142 ../src/guestfs-actions.pod:3156 ../src/guestfs-actions.pod:3179 ../src/guestfs-actions.pod:3577 ../src/guestfs-actions.pod:4071 ../src/guestfs-actions.pod:4089 ../src/guestfs-actions.pod:5626 ../src/guestfs-actions.pod:6712 ../src/guestfs-actions.pod:6733 ../src/guestfs-actions.pod:7060 ../src/guestfs-actions.pod:7298 ../src/guestfs-actions.pod:7511 ../src/guestfs-actions.pod:7537 ../src/guestfs-actions.pod:9224 ../src/guestfs-actions.pod:9785 ../src/guestfs-actions.pod:9798 ../src/guestfs-actions.pod:9811 +#: ../src/guestfs-actions.pod:144 ../src/guestfs-actions.pod:406 ../src/guestfs-actions.pod:576 ../src/guestfs-actions.pod:795 ../src/guestfs-actions.pod:826 ../src/guestfs-actions.pod:844 ../src/guestfs-actions.pod:863 ../src/guestfs-actions.pod:1894 ../src/guestfs-actions.pod:2038 ../src/guestfs-actions.pod:2461 ../src/guestfs-actions.pod:2664 ../src/guestfs-actions.pod:2853 ../src/guestfs-actions.pod:2914 ../src/guestfs-actions.pod:2965 ../src/guestfs-actions.pod:3017 ../src/guestfs-actions.pod:3031 ../src/guestfs-actions.pod:3054 ../src/guestfs-actions.pod:3373 ../src/guestfs-actions.pod:3867 ../src/guestfs-actions.pod:3885 ../src/guestfs-actions.pod:6491 ../src/guestfs-actions.pod:6512 ../src/guestfs-actions.pod:6856 ../src/guestfs-actions.pod:7094 ../src/guestfs-actions.pod:7288 ../src/guestfs-actions.pod:7314 ../src/guestfs-actions.pod:8968 ../src/guestfs-actions.pod:9455 ../src/guestfs-actions.pod:9468 ../src/guestfs-actions.pod:9481 msgid "On error this function returns -1." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:128 +#: ../src/guestfs-actions.pod:146 msgid "(Added in 1.7.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:130 +#: ../src/guestfs-actions.pod:148 msgid "guestfs_add_domain_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:132 +#: ../src/guestfs-actions.pod:150 #, no-wrap msgid "" " int\n" @@ -29480,22 +29232,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:137 +#: ../src/guestfs-actions.pod:155 msgid "This is the \"va_list variant\" of L</guestfs_add_domain>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:139 ../src/guestfs-actions.pod:150 ../src/guestfs-actions.pod:245 ../src/guestfs-actions.pod:256 ../src/guestfs-actions.pod:991 ../src/guestfs-actions.pod:1002 ../src/guestfs-actions.pod:1047 ../src/guestfs-actions.pod:1058 ../src/guestfs-actions.pod:1479 ../src/guestfs-actions.pod:1492 ../src/guestfs-actions.pod:1538 ../src/guestfs-actions.pod:1551 ../src/guestfs-actions.pod:1628 ../src/guestfs-actions.pod:1640 ../src/guestfs-actions.pod:1681 ../src/guestfs-actions.pod:1693 ../src/guestfs-actions.pod:1734 ../src/guestfs-actions.pod:1746 ../src/guestfs-actions.pod:1792 ../src/guestfs-actions.pod:1804 ../src/guestfs-actions.pod:2111 ../src/guestfs-actions.pod:2122 ../src/guestfs-actions.pod:2780 ../src/guestfs-actions.pod:2791 ../src/guestfs-actions.pod:3363 ../src/guestfs-actions.pod:3375 ../src/guestfs-actions.pod:4037 ../src/guestfs-actions.pod:4049 ../src/guestfs-actions.pod:5717 ../src/guestfs-actions.pod:5729 ../src/guestfs-actions.pod:6123 ../src/guestfs-actions.pod:6135 ../src/guestfs-actions.pod:6206 ../src/guestfs-actions.pod:6217 ../src/guestfs-actions.pod:6477 ../src/guestfs-actions.pod:6489 ../src/guestfs-actions.pod:6545 ../src/guestfs-actions.pod:6556 ../src/guestfs-actions.pod:6800 ../src/guestfs-actions.pod:6812 ../src/guestfs-actions.pod:6851 ../src/guestfs-actions.pod:6862 ../src/guestfs-actions.pod:6933 ../src/guestfs-actions.pod:6944 ../src/guestfs-actions.pod:8063 ../src/guestfs-actions.pod:8075 ../src/guestfs-actions.pod:9138 ../src/guestfs-actions.pod:9149 ../src/guestfs-actions.pod:9271 ../src/guestfs-actions.pod:9282 ../src/guestfs-actions.pod:9327 ../src/guestfs-actions.pod:9337 ../src/guestfs-actions.pod:9946 ../src/guestfs-actions.pod:9957 +#: ../src/guestfs-actions.pod:157 ../src/guestfs-actions.pod:168 ../src/guestfs-actions.pod:270 ../src/guestfs-actions.pod:281 ../src/guestfs-actions.pod:1014 ../src/guestfs-actions.pod:1025 ../src/guestfs-actions.pod:1070 ../src/guestfs-actions.pod:1081 ../src/guestfs-actions.pod:1467 ../src/guestfs-actions.pod:1480 ../src/guestfs-actions.pod:1526 ../src/guestfs-actions.pod:1539 ../src/guestfs-actions.pod:1616 ../src/guestfs-actions.pod:1628 ../src/guestfs-actions.pod:1669 ../src/guestfs-actions.pod:1681 ../src/guestfs-actions.pod:1722 ../src/guestfs-actions.pod:1734 ../src/guestfs-actions.pod:1780 ../src/guestfs-actions.pod:1792 ../src/guestfs-actions.pod:2097 ../src/guestfs-actions.pod:2108 ../src/guestfs-actions.pod:3833 ../src/guestfs-actions.pod:3845 ../src/guestfs-actions.pod:5495 ../src/guestfs-actions.pod:5507 ../src/guestfs-actions.pod:5898 ../src/guestfs-actions.pod:5909 ../src/guestfs-actions.pod:5984 ../src/guestfs-actions.pod:5996 ../src/guestfs-actions.pod:6256 ../src/guestfs-actions.pod:6268 ../src/guestfs-actions.pod:6324 ../src/guestfs-actions.pod:6335 ../src/guestfs-actions.pod:6579 ../src/guestfs-actions.pod:6591 ../src/guestfs-actions.pod:6630 ../src/guestfs-actions.pod:6641 ../src/guestfs-actions.pod:6729 ../src/guestfs-actions.pod:6740 ../src/guestfs-actions.pod:7807 ../src/guestfs-actions.pod:7819 ../src/guestfs-actions.pod:8882 ../src/guestfs-actions.pod:8893 ../src/guestfs-actions.pod:9029 ../src/guestfs-actions.pod:9039 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:141 +#: ../src/guestfs-actions.pod:159 msgid "guestfs_add_domain_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:143 +#: ../src/guestfs-actions.pod:161 #, no-wrap msgid "" " int\n" @@ -29506,17 +29258,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:148 +#: ../src/guestfs-actions.pod:166 msgid "This is the \"argv variant\" of L</guestfs_add_domain>." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:152 -msgid "= head2 guestfs_add_drive" +#. type: =head2 +#: ../src/guestfs-actions.pod:170 +msgid "guestfs_add_drive" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:154 +#: ../src/guestfs-actions.pod:172 #, no-wrap msgid "" " int\n" @@ -29526,20 +29278,30 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:158 +#: ../src/guestfs-actions.pod:176 msgid "" -"This function is provided for backwards compatibility with earlier versions " -"of libguestfs. It simply calls L</guestfs_add_drive_opts> with no optional " -"arguments." +"This function is the equivalent of calling C<guestfs_add_drive_opts> with no " +"optional parameters, so the disk is added writable, with the format being " +"detected automatically." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:180 +msgid "" +"Automatic detection of the format opens you up to a potential security hole " +"when dealing with untrusted raw-format images. See CVE-2010-3851 and " +"RHBZ#642934. Specifying the format closes this security hole. Therefore " +"you should think about replacing calls to this function with calls to " +"C<guestfs_add_drive_opts>, and specifying the format." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:165 +#: ../src/guestfs-actions.pod:191 msgid "guestfs_add_drive_opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:167 +#: ../src/guestfs-actions.pod:193 #, no-wrap msgid "" " int\n" @@ -29550,7 +29312,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:177 +#: ../src/guestfs-actions.pod:203 #, no-wrap msgid "" " GUESTFS_ADD_DRIVE_OPTS_READONLY, int readonly,\n" @@ -29561,7 +29323,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:207 +#: ../src/guestfs-actions.pod:236 msgid "" "This forces the image format. If you omit this (or use C<guestfs_add_drive> " "or C<guestfs_add_drive_ro>) then the format is automatically detected. " @@ -29569,24 +29331,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:218 +#: ../src/guestfs-actions.pod:247 msgid "" "This rarely-used option lets you emulate the behaviour of the deprecated " "C<guestfs_add_drive_with_if> call (q.v.)" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:234 +#: ../src/guestfs-actions.pod:259 msgid "(Added in 1.5.23)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:236 +#: ../src/guestfs-actions.pod:261 msgid "guestfs_add_drive_opts_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:238 +#: ../src/guestfs-actions.pod:263 #, no-wrap msgid "" " int\n" @@ -29597,17 +29359,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:243 +#: ../src/guestfs-actions.pod:268 msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:247 +#: ../src/guestfs-actions.pod:272 msgid "guestfs_add_drive_opts_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:249 +#: ../src/guestfs-actions.pod:274 #, no-wrap msgid "" " int\n" @@ -29619,17 +29381,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:254 +#: ../src/guestfs-actions.pod:279 msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:258 +#: ../src/guestfs-actions.pod:283 msgid "guestfs_add_drive_ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:260 +#: ../src/guestfs-actions.pod:285 #, no-wrap msgid "" " int\n" @@ -29639,7 +29401,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:264 +#: ../src/guestfs-actions.pod:289 msgid "" "This function is the equivalent of calling C<guestfs_add_drive_opts> with " "the optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the " @@ -29647,17 +29409,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:271 +#: ../src/guestfs-actions.pod:296 msgid "(Added in 1.0.38)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:273 +#: ../src/guestfs-actions.pod:298 msgid "guestfs_add_drive_ro_with_if" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:275 +#: ../src/guestfs-actions.pod:300 #, no-wrap msgid "" " int\n" @@ -29668,24 +29430,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:287 +#: ../src/guestfs-actions.pod:312 msgid "" "This is the same as C<guestfs_add_drive_ro> but it allows you to specify the " "QEMU interface emulation to use at run time." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:292 ../src/guestfs-actions.pod:313 ../src/guestfs-actions.pod:3536 +#: ../src/guestfs-actions.pod:317 ../src/guestfs-actions.pod:338 ../src/guestfs-actions.pod:3332 msgid "(Added in 1.0.84)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:294 +#: ../src/guestfs-actions.pod:319 msgid "guestfs_add_drive_with_if" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:296 +#: ../src/guestfs-actions.pod:321 #, no-wrap msgid "" " int\n" @@ -29696,19 +29458,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:308 +#: ../src/guestfs-actions.pod:333 msgid "" "This is the same as C<guestfs_add_drive> but it allows you to specify the " "QEMU interface emulation to use at run time." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:315 +#: ../src/guestfs-actions.pod:340 msgid "guestfs_aug_clear" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:317 +#: ../src/guestfs-actions.pod:342 #, no-wrap msgid "" " int\n" @@ -29718,17 +29480,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:326 ../src/guestfs-actions.pod:3181 +#: ../src/guestfs-actions.pod:351 ../src/guestfs-actions.pod:3056 msgid "(Added in 1.3.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:328 +#: ../src/guestfs-actions.pod:353 msgid "guestfs_aug_close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:330 +#: ../src/guestfs-actions.pod:355 #, no-wrap msgid "" " int\n" @@ -29737,7 +29499,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:333 +#: ../src/guestfs-actions.pod:358 msgid "" "Close the current Augeas handle and free up any resources used by it. After " "calling this, you have to call C<guestfs_aug_init> again before you can use " @@ -29745,17 +29507,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:340 ../src/guestfs-actions.pod:365 ../src/guestfs-actions.pod:383 ../src/guestfs-actions.pod:397 ../src/guestfs-actions.pod:460 ../src/guestfs-actions.pod:480 ../src/guestfs-actions.pod:494 ../src/guestfs-actions.pod:525 ../src/guestfs-actions.pod:539 ../src/guestfs-actions.pod:553 ../src/guestfs-actions.pod:567 ../src/guestfs-actions.pod:585 ../src/guestfs-actions.pod:7588 +#: ../src/guestfs-actions.pod:365 ../src/guestfs-actions.pod:390 ../src/guestfs-actions.pod:408 ../src/guestfs-actions.pod:422 ../src/guestfs-actions.pod:485 ../src/guestfs-actions.pod:505 ../src/guestfs-actions.pod:519 ../src/guestfs-actions.pod:550 ../src/guestfs-actions.pod:564 ../src/guestfs-actions.pod:578 ../src/guestfs-actions.pod:592 ../src/guestfs-actions.pod:610 ../src/guestfs-actions.pod:7365 msgid "(Added in 0.7)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:342 +#: ../src/guestfs-actions.pod:367 msgid "guestfs_aug_defnode" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:344 +#: ../src/guestfs-actions.pod:369 #, no-wrap msgid "" " struct guestfs_int_bool *\n" @@ -29767,7 +29529,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:353 +#: ../src/guestfs-actions.pod:378 msgid "" "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to " "calling C<guestfs_aug_set> C<expr>, C<value>. C<name> will be the nodeset " @@ -29775,19 +29537,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:361 +#: ../src/guestfs-actions.pod:386 msgid "" "This function returns a C<struct guestfs_int_bool *>, or NULL if there was " "an error. I<The caller must call C<guestfs_free_int_bool> after use>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:367 +#: ../src/guestfs-actions.pod:392 msgid "guestfs_aug_defvar" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:369 +#: ../src/guestfs-actions.pod:394 #, no-wrap msgid "" " int\n" @@ -29798,12 +29560,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:385 +#: ../src/guestfs-actions.pod:410 msgid "guestfs_aug_get" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:387 +#: ../src/guestfs-actions.pod:412 #, no-wrap msgid "" " char *\n" @@ -29813,19 +29575,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:394 ../src/guestfs-actions.pod:1174 ../src/guestfs-actions.pod:1217 ../src/guestfs-actions.pod:1235 ../src/guestfs-actions.pod:1295 ../src/guestfs-actions.pod:1311 ../src/guestfs-actions.pod:1414 ../src/guestfs-actions.pod:1921 ../src/guestfs-actions.pod:1938 ../src/guestfs-actions.pod:1957 ../src/guestfs-actions.pod:2158 ../src/guestfs-actions.pod:2374 ../src/guestfs-actions.pod:2486 ../src/guestfs-actions.pod:2672 ../src/guestfs-actions.pod:2689 ../src/guestfs-actions.pod:2816 ../src/guestfs-actions.pod:2957 ../src/guestfs-actions.pod:2998 ../src/guestfs-actions.pod:3019 ../src/guestfs-actions.pod:3204 ../src/guestfs-actions.pod:3501 ../src/guestfs-actions.pod:3703 ../src/guestfs-actions.pod:3817 ../src/guestfs-actions.pod:3921 ../src/guestfs-actions.pod:3940 ../src/guestfs-actions.pod:4155 ../src/guestfs-actions.pod:4183 ../src/guestfs-actions.pod:4204 ../src/guestfs-actions.pod:4238 ../src/guestfs-actions.pod:4309 ../src/guestfs-actions.pod:4329 ../src/guestfs-actions.pod:4349 ../src/guestfs-actions.pod:5025 ../src/guestfs-actions.pod:5041 ../src/guestfs-actions.pod:5405 ../src/guestfs-actions.pod:5572 ../src/guestfs-actions.pod:5913 ../src/guestfs-actions.pod:7078 ../src/guestfs-actions.pod:7279 ../src/guestfs-actions.pod:7486 ../src/guestfs-actions.pod:7664 ../src/guestfs-actions.pod:7713 ../src/guestfs-actions.pod:8515 ../src/guestfs-actions.pod:8531 ../src/guestfs-actions.pod:8555 ../src/guestfs-actions.pod:8579 ../src/guestfs-actions.pod:9495 ../src/guestfs-actions.pod:9514 ../src/guestfs-actions.pod:9532 ../src/guestfs-actions.pod:9744 ../src/guestfs-actions.pod:9934 ../src/guestfs-actions.pod:10199 +#: ../src/guestfs-actions.pod:419 ../src/guestfs-actions.pod:1205 ../src/guestfs-actions.pod:1223 ../src/guestfs-actions.pod:1283 ../src/guestfs-actions.pod:1299 ../src/guestfs-actions.pod:1402 ../src/guestfs-actions.pod:1907 ../src/guestfs-actions.pod:1924 ../src/guestfs-actions.pod:1943 ../src/guestfs-actions.pod:2144 ../src/guestfs-actions.pod:2332 ../src/guestfs-actions.pod:2444 ../src/guestfs-actions.pod:2607 ../src/guestfs-actions.pod:2624 ../src/guestfs-actions.pod:2691 ../src/guestfs-actions.pod:2832 ../src/guestfs-actions.pod:2873 ../src/guestfs-actions.pod:2894 ../src/guestfs-actions.pod:3079 ../src/guestfs-actions.pod:3297 ../src/guestfs-actions.pod:3499 ../src/guestfs-actions.pod:3613 ../src/guestfs-actions.pod:3717 ../src/guestfs-actions.pod:3736 ../src/guestfs-actions.pod:3951 ../src/guestfs-actions.pod:3979 ../src/guestfs-actions.pod:4000 ../src/guestfs-actions.pod:4034 ../src/guestfs-actions.pod:4105 ../src/guestfs-actions.pod:4125 ../src/guestfs-actions.pod:4145 ../src/guestfs-actions.pod:4821 ../src/guestfs-actions.pod:4837 ../src/guestfs-actions.pod:5201 ../src/guestfs-actions.pod:5368 ../src/guestfs-actions.pod:5691 ../src/guestfs-actions.pod:6874 ../src/guestfs-actions.pod:7075 ../src/guestfs-actions.pod:7263 ../src/guestfs-actions.pod:7441 ../src/guestfs-actions.pod:7490 ../src/guestfs-actions.pod:8259 ../src/guestfs-actions.pod:8275 ../src/guestfs-actions.pod:8299 ../src/guestfs-actions.pod:8323 ../src/guestfs-actions.pod:9184 ../src/guestfs-actions.pod:9203 ../src/guestfs-actions.pod:9221 ../src/guestfs-actions.pod:9414 ../src/guestfs-actions.pod:9771 msgid "" "This function returns a string, or NULL on error. I<The caller must free " "the returned string after use>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:399 +#: ../src/guestfs-actions.pod:424 msgid "guestfs_aug_init" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:401 +#: ../src/guestfs-actions.pod:426 #, no-wrap msgid "" " int\n" @@ -29836,12 +29598,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:410 +#: ../src/guestfs-actions.pod:435 msgid "You must call this before using any other C<guestfs_aug_*> commands." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:435 +#: ../src/guestfs-actions.pod:460 msgid "" "This option is only useful when debugging Augeas lenses. Use of this option " "may require additional memory for the libguestfs appliance. You may need to " @@ -29850,22 +29612,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:450 +#: ../src/guestfs-actions.pod:475 msgid "Do not load the tree in C<guestfs_aug_init>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:454 +#: ../src/guestfs-actions.pod:479 msgid "To close the handle, you can call C<guestfs_aug_close>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:462 +#: ../src/guestfs-actions.pod:487 msgid "guestfs_aug_insert" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:464 +#: ../src/guestfs-actions.pod:489 #, no-wrap msgid "" " int\n" @@ -29877,12 +29639,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:482 +#: ../src/guestfs-actions.pod:507 msgid "guestfs_aug_load" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:484 +#: ../src/guestfs-actions.pod:509 #, no-wrap msgid "" " int\n" @@ -29891,12 +29653,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:496 +#: ../src/guestfs-actions.pod:521 msgid "guestfs_aug_ls" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:498 +#: ../src/guestfs-actions.pod:523 #, no-wrap msgid "" " char **\n" @@ -29906,14 +29668,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:502 +#: ../src/guestfs-actions.pod:527 msgid "" "This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and " "sorting the resulting nodes into alphabetical order." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:505 ../src/guestfs-actions.pod:521 ../src/guestfs-actions.pod:669 ../src/guestfs-actions.pod:1433 ../src/guestfs-actions.pod:2180 ../src/guestfs-actions.pod:2206 ../src/guestfs-actions.pod:2316 ../src/guestfs-actions.pod:2342 ../src/guestfs-actions.pod:2611 ../src/guestfs-actions.pod:3280 ../src/guestfs-actions.pod:3346 ../src/guestfs-actions.pod:3394 ../src/guestfs-actions.pod:3459 ../src/guestfs-actions.pod:3483 ../src/guestfs-actions.pod:3554 ../src/guestfs-actions.pod:3603 ../src/guestfs-actions.pod:3882 ../src/guestfs-actions.pod:4257 ../src/guestfs-actions.pod:4545 ../src/guestfs-actions.pod:4895 ../src/guestfs-actions.pod:4912 ../src/guestfs-actions.pod:4932 ../src/guestfs-actions.pod:4987 ../src/guestfs-actions.pod:5007 ../src/guestfs-actions.pod:5128 ../src/guestfs-actions.pod:5544 ../src/guestfs-actions.pod:6680 ../src/guestfs-actions.pod:7458 ../src/guestfs-actions.pod:7584 ../src/guestfs-actions.pod:7698 ../src/guestfs-actions.pod:8595 ../src/guestfs-actions.pod:8679 ../src/guestfs-actions.pod:8734 ../src/guestfs-actions.pod:8880 ../src/guestfs-actions.pod:8904 ../src/guestfs-actions.pod:9618 ../src/guestfs-actions.pod:9657 ../src/guestfs-actions.pod:9704 ../src/guestfs-actions.pod:9993 ../src/guestfs-actions.pod:10019 ../src/guestfs-actions.pod:10142 ../src/guestfs-actions.pod:10168 ../src/guestfs-actions.pod:10221 ../src/guestfs-actions.pod:10247 +#: ../src/guestfs-actions.pod:530 ../src/guestfs-actions.pod:546 ../src/guestfs-actions.pod:692 ../src/guestfs-actions.pod:1421 ../src/guestfs-actions.pod:2159 ../src/guestfs-actions.pod:2178 ../src/guestfs-actions.pod:2281 ../src/guestfs-actions.pod:2300 ../src/guestfs-actions.pod:2546 ../src/guestfs-actions.pod:3155 ../src/guestfs-actions.pod:3171 ../src/guestfs-actions.pod:3190 ../src/guestfs-actions.pod:3255 ../src/guestfs-actions.pod:3279 ../src/guestfs-actions.pod:3350 ../src/guestfs-actions.pod:3399 ../src/guestfs-actions.pod:3678 ../src/guestfs-actions.pod:4053 ../src/guestfs-actions.pod:4341 ../src/guestfs-actions.pod:4691 ../src/guestfs-actions.pod:4708 ../src/guestfs-actions.pod:4728 ../src/guestfs-actions.pod:4783 ../src/guestfs-actions.pod:4803 ../src/guestfs-actions.pod:4924 ../src/guestfs-actions.pod:5340 ../src/guestfs-actions.pod:6459 ../src/guestfs-actions.pod:7235 ../src/guestfs-actions.pod:7361 ../src/guestfs-actions.pod:7475 ../src/guestfs-actions.pod:8339 ../src/guestfs-actions.pod:8423 ../src/guestfs-actions.pod:8478 ../src/guestfs-actions.pod:8624 ../src/guestfs-actions.pod:8648 ../src/guestfs-actions.pod:9288 ../src/guestfs-actions.pod:9327 ../src/guestfs-actions.pod:9374 ../src/guestfs-actions.pod:9587 ../src/guestfs-actions.pod:9606 ../src/guestfs-actions.pod:9721 ../src/guestfs-actions.pod:9740 ../src/guestfs-actions.pod:9786 ../src/guestfs-actions.pod:9805 msgid "" "This function returns a NULL-terminated array of strings (like " "L<environ(3)>), or NULL if there was an error. I<The caller must free the " @@ -29921,17 +29683,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:509 ../src/guestfs-actions.pod:1358 ../src/guestfs-actions.pod:1376 ../src/guestfs-actions.pod:2244 ../src/guestfs-actions.pod:4609 ../src/guestfs-actions.pod:4640 ../src/guestfs-actions.pod:5371 ../src/guestfs-actions.pod:5435 ../src/guestfs-actions.pod:5853 ../src/guestfs-actions.pod:5886 ../src/guestfs-actions.pod:6047 ../src/guestfs-actions.pod:6684 ../src/guestfs-actions.pod:7399 ../src/guestfs-actions.pod:7796 ../src/guestfs-actions.pod:7810 ../src/guestfs-actions.pod:7822 ../src/guestfs-actions.pod:8442 ../src/guestfs-actions.pod:9238 ../src/guestfs-actions.pod:9295 ../src/guestfs-actions.pod:9602 ../src/guestfs-actions.pod:9905 +#: ../src/guestfs-actions.pod:534 ../src/guestfs-actions.pod:1346 ../src/guestfs-actions.pod:1364 ../src/guestfs-actions.pod:2216 ../src/guestfs-actions.pod:4405 ../src/guestfs-actions.pod:4436 ../src/guestfs-actions.pod:5167 ../src/guestfs-actions.pod:5231 ../src/guestfs-actions.pod:5631 ../src/guestfs-actions.pod:5664 ../src/guestfs-actions.pod:5827 ../src/guestfs-actions.pod:6463 ../src/guestfs-actions.pod:7176 ../src/guestfs-actions.pod:7573 ../src/guestfs-actions.pod:7587 ../src/guestfs-actions.pod:7599 ../src/guestfs-actions.pod:8186 ../src/guestfs-actions.pod:8984 ../src/guestfs-actions.pod:8997 ../src/guestfs-actions.pod:9272 ../src/guestfs-actions.pod:9575 msgid "(Added in 0.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:511 +#: ../src/guestfs-actions.pod:536 msgid "guestfs_aug_match" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:513 +#: ../src/guestfs-actions.pod:538 #, no-wrap msgid "" " char **\n" @@ -29941,12 +29703,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:527 +#: ../src/guestfs-actions.pod:552 msgid "guestfs_aug_mv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:529 +#: ../src/guestfs-actions.pod:554 #, no-wrap msgid "" " int\n" @@ -29957,12 +29719,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:541 +#: ../src/guestfs-actions.pod:566 msgid "guestfs_aug_rm" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:543 +#: ../src/guestfs-actions.pod:568 #, no-wrap msgid "" " int\n" @@ -29972,12 +29734,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:555 +#: ../src/guestfs-actions.pod:580 msgid "guestfs_aug_save" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:557 +#: ../src/guestfs-actions.pod:582 #, no-wrap msgid "" " int\n" @@ -29986,19 +29748,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:562 +#: ../src/guestfs-actions.pod:587 msgid "" "The flags which were passed to C<guestfs_aug_init> affect exactly how files " "are saved." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:569 +#: ../src/guestfs-actions.pod:594 msgid "guestfs_aug_set" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:571 +#: ../src/guestfs-actions.pod:596 #, no-wrap msgid "" " int\n" @@ -30009,7 +29771,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:578 +#: ../src/guestfs-actions.pod:603 msgid "" "In the Augeas API, it is possible to clear a node by setting the value to " "NULL. Due to an oversight in the libguestfs API you cannot do that with " @@ -30017,12 +29779,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:587 +#: ../src/guestfs-actions.pod:612 msgid "guestfs_available" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:589 +#: ../src/guestfs-actions.pod:614 #, no-wrap msgid "" " int\n" @@ -30032,7 +29794,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:597 +#: ../src/guestfs-actions.pod:622 msgid "" "The libguestfs groups, and the functions that those groups correspond to, " "are listed in L<guestfs(3)/AVAILABILITY>. You can also fetch this list at " @@ -30040,12 +29802,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:621 +#: ../src/guestfs-actions.pod:646 msgid "You must call C<guestfs_launch> before calling this function." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:643 +#: ../src/guestfs-actions.pod:668 msgid "" "This call was added in version C<1.0.80>. In previous versions of " "libguestfs all you could do would be to speculatively execute a command to " @@ -30053,22 +29815,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:650 -msgid "See also C<guestfs_filesystem_available>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:654 ../src/guestfs-actions.pod:1890 +#: ../src/guestfs-actions.pod:677 ../src/guestfs-actions.pod:1878 msgid "(Added in 1.0.80)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:656 +#: ../src/guestfs-actions.pod:679 msgid "guestfs_available_all_groups" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:658 +#: ../src/guestfs-actions.pod:681 #, no-wrap msgid "" " char **\n" @@ -30077,7 +29834,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:661 +#: ../src/guestfs-actions.pod:684 msgid "" "This command returns a list of all optional groups that this daemon knows " "about. Note this returns both supported and unsupported groups. To find " @@ -30086,22 +29843,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:667 +#: ../src/guestfs-actions.pod:690 msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:673 +#: ../src/guestfs-actions.pod:696 msgid "(Added in 1.3.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:675 +#: ../src/guestfs-actions.pod:698 msgid "guestfs_base64_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:677 +#: ../src/guestfs-actions.pod:700 #, no-wrap msgid "" " int\n" @@ -30112,17 +29869,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:687 ../src/guestfs-actions.pod:701 +#: ../src/guestfs-actions.pod:710 ../src/guestfs-actions.pod:724 msgid "(Added in 1.3.5)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:689 +#: ../src/guestfs-actions.pod:712 msgid "guestfs_base64_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:691 +#: ../src/guestfs-actions.pod:714 #, no-wrap msgid "" " int\n" @@ -30133,12 +29890,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:703 +#: ../src/guestfs-actions.pod:726 msgid "guestfs_blkid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:705 +#: ../src/guestfs-actions.pod:728 #, no-wrap msgid "" " char **\n" @@ -30148,7 +29905,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:736 ../src/guestfs-actions.pod:3857 ../src/guestfs-actions.pod:4125 ../src/guestfs-actions.pod:4972 ../src/guestfs-actions.pod:5765 ../src/guestfs-actions.pod:6660 ../src/guestfs-actions.pod:9165 +#: ../src/guestfs-actions.pod:759 ../src/guestfs-actions.pod:3653 ../src/guestfs-actions.pod:3921 ../src/guestfs-actions.pod:4768 ../src/guestfs-actions.pod:5543 ../src/guestfs-actions.pod:6439 ../src/guestfs-actions.pod:8909 msgid "" "This function returns a NULL-terminated array of strings, or NULL if there " "was an error. The array of strings will always have length C<2n+1>, where " @@ -30157,17 +29914,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:742 +#: ../src/guestfs-actions.pod:765 msgid "(Added in 1.15.9)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:744 +#: ../src/guestfs-actions.pod:767 msgid "guestfs_blockdev_flushbufs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:746 +#: ../src/guestfs-actions.pod:769 #, no-wrap msgid "" " int\n" @@ -30177,17 +29934,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:757 ../src/guestfs-actions.pod:774 ../src/guestfs-actions.pod:789 ../src/guestfs-actions.pod:805 ../src/guestfs-actions.pod:823 ../src/guestfs-actions.pod:842 ../src/guestfs-actions.pod:856 ../src/guestfs-actions.pod:874 ../src/guestfs-actions.pod:888 ../src/guestfs-actions.pod:902 +#: ../src/guestfs-actions.pod:780 ../src/guestfs-actions.pod:797 ../src/guestfs-actions.pod:812 ../src/guestfs-actions.pod:828 ../src/guestfs-actions.pod:846 ../src/guestfs-actions.pod:865 ../src/guestfs-actions.pod:879 ../src/guestfs-actions.pod:897 ../src/guestfs-actions.pod:911 ../src/guestfs-actions.pod:925 msgid "(Added in 0.9.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:759 +#: ../src/guestfs-actions.pod:782 msgid "guestfs_blockdev_getbsz" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:761 +#: ../src/guestfs-actions.pod:784 #, no-wrap msgid "" " int\n" @@ -30197,12 +29954,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:776 +#: ../src/guestfs-actions.pod:799 msgid "guestfs_blockdev_getro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:778 +#: ../src/guestfs-actions.pod:801 #, no-wrap msgid "" " int\n" @@ -30212,17 +29969,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:787 ../src/guestfs-actions.pod:2227 ../src/guestfs-actions.pod:2242 ../src/guestfs-actions.pod:2526 ../src/guestfs-actions.pod:2828 ../src/guestfs-actions.pod:2839 ../src/guestfs-actions.pod:3050 ../src/guestfs-actions.pod:3076 ../src/guestfs-actions.pod:3116 ../src/guestfs-actions.pod:3131 ../src/guestfs-actions.pod:3167 ../src/guestfs-actions.pod:3190 ../src/guestfs-actions.pod:4366 ../src/guestfs-actions.pod:4382 ../src/guestfs-actions.pod:4400 ../src/guestfs-actions.pod:4562 ../src/guestfs-actions.pod:4577 ../src/guestfs-actions.pod:4591 ../src/guestfs-actions.pod:4607 ../src/guestfs-actions.pod:4622 ../src/guestfs-actions.pod:4638 ../src/guestfs-actions.pod:4652 ../src/guestfs-actions.pod:4665 ../src/guestfs-actions.pod:4679 ../src/guestfs-actions.pod:4694 ../src/guestfs-actions.pod:4709 ../src/guestfs-actions.pod:4722 ../src/guestfs-actions.pod:4736 ../src/guestfs-actions.pod:7042 +#: ../src/guestfs-actions.pod:810 ../src/guestfs-actions.pod:2199 ../src/guestfs-actions.pod:2214 ../src/guestfs-actions.pod:2703 ../src/guestfs-actions.pod:2714 ../src/guestfs-actions.pod:2925 ../src/guestfs-actions.pod:2951 ../src/guestfs-actions.pod:2991 ../src/guestfs-actions.pod:3006 ../src/guestfs-actions.pod:3042 ../src/guestfs-actions.pod:3065 ../src/guestfs-actions.pod:4162 ../src/guestfs-actions.pod:4178 ../src/guestfs-actions.pod:4196 ../src/guestfs-actions.pod:4358 ../src/guestfs-actions.pod:4373 ../src/guestfs-actions.pod:4387 ../src/guestfs-actions.pod:4403 ../src/guestfs-actions.pod:4418 ../src/guestfs-actions.pod:4434 ../src/guestfs-actions.pod:4448 ../src/guestfs-actions.pod:4461 ../src/guestfs-actions.pod:4475 ../src/guestfs-actions.pod:4490 ../src/guestfs-actions.pod:4505 ../src/guestfs-actions.pod:4518 ../src/guestfs-actions.pod:4532 ../src/guestfs-actions.pod:6838 msgid "This function returns a C truth value on success or -1 on error." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:791 +#: ../src/guestfs-actions.pod:814 msgid "guestfs_blockdev_getsize64" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:793 +#: ../src/guestfs-actions.pod:816 #, no-wrap msgid "" " int64_t\n" @@ -30232,17 +29989,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:799 +#: ../src/guestfs-actions.pod:822 msgid "See also C<guestfs_blockdev_getsz>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:807 +#: ../src/guestfs-actions.pod:830 msgid "guestfs_blockdev_getss" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:809 +#: ../src/guestfs-actions.pod:832 #, no-wrap msgid "" " int\n" @@ -30252,19 +30009,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:816 +#: ../src/guestfs-actions.pod:839 msgid "" "(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for " "that)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:825 +#: ../src/guestfs-actions.pod:848 msgid "guestfs_blockdev_getsz" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:827 +#: ../src/guestfs-actions.pod:850 #, no-wrap msgid "" " int64_t\n" @@ -30274,19 +30031,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:834 +#: ../src/guestfs-actions.pod:857 msgid "" "See also C<guestfs_blockdev_getss> for the real sector size of the device, " "and C<guestfs_blockdev_getsize64> for the more useful I<size in bytes>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:844 +#: ../src/guestfs-actions.pod:867 msgid "guestfs_blockdev_rereadpt" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:846 +#: ../src/guestfs-actions.pod:869 #, no-wrap msgid "" " int\n" @@ -30296,12 +30053,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:858 +#: ../src/guestfs-actions.pod:881 msgid "guestfs_blockdev_setbsz" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:860 +#: ../src/guestfs-actions.pod:883 #, no-wrap msgid "" " int\n" @@ -30312,12 +30069,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:876 +#: ../src/guestfs-actions.pod:899 msgid "guestfs_blockdev_setro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:878 +#: ../src/guestfs-actions.pod:901 #, no-wrap msgid "" " int\n" @@ -30327,12 +30084,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:890 +#: ../src/guestfs-actions.pod:913 msgid "guestfs_blockdev_setrw" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:892 +#: ../src/guestfs-actions.pod:915 #, no-wrap msgid "" " int\n" @@ -30342,12 +30099,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:904 +#: ../src/guestfs-actions.pod:927 msgid "guestfs_btrfs_device_add" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:906 +#: ../src/guestfs-actions.pod:929 #, no-wrap msgid "" " int\n" @@ -30358,17 +30115,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:916 ../src/guestfs-actions.pod:930 ../src/guestfs-actions.pod:943 ../src/guestfs-actions.pod:1014 ../src/guestfs-actions.pod:1085 ../src/guestfs-actions.pod:1097 ../src/guestfs-actions.pod:1112 ../src/guestfs-actions.pod:1127 ../src/guestfs-actions.pod:1142 +#: ../src/guestfs-actions.pod:939 ../src/guestfs-actions.pod:953 ../src/guestfs-actions.pod:966 ../src/guestfs-actions.pod:1037 ../src/guestfs-actions.pod:1108 ../src/guestfs-actions.pod:1120 ../src/guestfs-actions.pod:1135 ../src/guestfs-actions.pod:1150 ../src/guestfs-actions.pod:1165 msgid "(Added in 1.17.35)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:918 +#: ../src/guestfs-actions.pod:941 msgid "guestfs_btrfs_device_delete" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:920 +#: ../src/guestfs-actions.pod:943 #, no-wrap msgid "" " int\n" @@ -30379,12 +30136,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:932 +#: ../src/guestfs-actions.pod:955 msgid "guestfs_btrfs_filesystem_balance" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:934 +#: ../src/guestfs-actions.pod:957 #, no-wrap msgid "" " int\n" @@ -30394,12 +30151,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:945 +#: ../src/guestfs-actions.pod:968 msgid "guestfs_btrfs_filesystem_resize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:947 +#: ../src/guestfs-actions.pod:970 #, no-wrap msgid "" " int\n" @@ -30410,7 +30167,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:957 +#: ../src/guestfs-actions.pod:980 #, no-wrap msgid "" " GUESTFS_BTRFS_FILESYSTEM_RESIZE_SIZE, int64_t size,\n" @@ -30418,17 +30175,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:980 +#: ../src/guestfs-actions.pod:1003 msgid "(Added in 1.11.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:982 +#: ../src/guestfs-actions.pod:1005 msgid "guestfs_btrfs_filesystem_resize_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:984 +#: ../src/guestfs-actions.pod:1007 #, no-wrap msgid "" " int\n" @@ -30439,17 +30196,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:989 +#: ../src/guestfs-actions.pod:1012 msgid "This is the \"va_list variant\" of L</guestfs_btrfs_filesystem_resize>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:993 +#: ../src/guestfs-actions.pod:1016 msgid "guestfs_btrfs_filesystem_resize_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:995 +#: ../src/guestfs-actions.pod:1018 #, no-wrap msgid "" " int\n" @@ -30461,17 +30218,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1000 +#: ../src/guestfs-actions.pod:1023 msgid "This is the \"argv variant\" of L</guestfs_btrfs_filesystem_resize>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1004 +#: ../src/guestfs-actions.pod:1027 msgid "guestfs_btrfs_filesystem_sync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1006 +#: ../src/guestfs-actions.pod:1029 #, no-wrap msgid "" " int\n" @@ -30481,12 +30238,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1016 +#: ../src/guestfs-actions.pod:1039 msgid "guestfs_btrfs_fsck" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1018 +#: ../src/guestfs-actions.pod:1041 #, no-wrap msgid "" " int\n" @@ -30497,7 +30254,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1028 +#: ../src/guestfs-actions.pod:1051 #, no-wrap msgid "" " GUESTFS_BTRFS_FSCK_SUPERBLOCK, int64_t superblock,\n" @@ -30506,17 +30263,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1036 ../src/guestfs-actions.pod:1072 +#: ../src/guestfs-actions.pod:1059 ../src/guestfs-actions.pod:1095 msgid "(Added in 1.17.43)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1038 +#: ../src/guestfs-actions.pod:1061 msgid "guestfs_btrfs_fsck_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1040 +#: ../src/guestfs-actions.pod:1063 #, no-wrap msgid "" " int\n" @@ -30527,17 +30284,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1045 +#: ../src/guestfs-actions.pod:1068 msgid "This is the \"va_list variant\" of L</guestfs_btrfs_fsck>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1049 +#: ../src/guestfs-actions.pod:1072 msgid "guestfs_btrfs_fsck_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1051 +#: ../src/guestfs-actions.pod:1074 #, no-wrap msgid "" " int\n" @@ -30548,17 +30305,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1056 +#: ../src/guestfs-actions.pod:1079 msgid "This is the \"argv variant\" of L</guestfs_btrfs_fsck>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1060 +#: ../src/guestfs-actions.pod:1083 msgid "guestfs_btrfs_set_seeding" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1062 +#: ../src/guestfs-actions.pod:1085 #, no-wrap msgid "" " int\n" @@ -30569,12 +30326,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1074 +#: ../src/guestfs-actions.pod:1097 msgid "guestfs_btrfs_subvolume_create" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1076 +#: ../src/guestfs-actions.pod:1099 #, no-wrap msgid "" " int\n" @@ -30584,12 +30341,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1087 +#: ../src/guestfs-actions.pod:1110 msgid "guestfs_btrfs_subvolume_delete" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1089 +#: ../src/guestfs-actions.pod:1112 #, no-wrap msgid "" " int\n" @@ -30599,12 +30356,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1099 +#: ../src/guestfs-actions.pod:1122 msgid "guestfs_btrfs_subvolume_list" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1101 +#: ../src/guestfs-actions.pod:1124 #, no-wrap msgid "" " struct guestfs_btrfssubvolume_list *\n" @@ -30614,7 +30371,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1108 +#: ../src/guestfs-actions.pod:1131 msgid "" "This function returns a C<struct guestfs_btrfssubvolume_list *>, or NULL if " "there was an error. I<The caller must call " @@ -30622,12 +30379,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1114 +#: ../src/guestfs-actions.pod:1137 msgid "guestfs_btrfs_subvolume_set_default" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1116 +#: ../src/guestfs-actions.pod:1139 #, no-wrap msgid "" " int\n" @@ -30638,19 +30395,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1121 +#: ../src/guestfs-actions.pod:1144 msgid "" "Set the subvolume of the btrfs filesystem C<fs> which will be mounted by " "default. See C<guestfs_btrfs_subvolume_list> to get a list of subvolumes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1129 +#: ../src/guestfs-actions.pod:1152 msgid "guestfs_btrfs_subvolume_snapshot" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1131 +#: ../src/guestfs-actions.pod:1154 #, no-wrap msgid "" " int\n" @@ -30661,37 +30418,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1144 -msgid "guestfs_canonical_device_name" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:1146 -#, no-wrap -msgid "" -" char *\n" -" guestfs_canonical_device_name (guestfs_h *g,\n" -" const char *device);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:1168 -msgid "Converted to C</dev/VG/LV> form using C<guestfs_lvm_canonical_lvm_name>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:1177 ../src/guestfs-actions.pod:1908 ../src/guestfs-actions.pod:5628 -msgid "(Added in 1.19.7)" -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:1179 +#: ../src/guestfs-actions.pod:1167 msgid "guestfs_case_sensitive_path" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1181 +#: ../src/guestfs-actions.pod:1169 #, no-wrap msgid "" " char *\n" @@ -30701,7 +30433,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1207 +#: ../src/guestfs-actions.pod:1195 msgid "" "Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\") might return " "C<\"/WINDOWS/system32\"> (the exact return value would depend on details of " @@ -30709,22 +30441,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1215 +#: ../src/guestfs-actions.pod:1203 msgid "See also C<guestfs_realpath>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1220 ../src/guestfs-actions.pod:9517 +#: ../src/guestfs-actions.pod:1208 ../src/guestfs-actions.pod:9206 msgid "(Added in 1.0.75)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1222 +#: ../src/guestfs-actions.pod:1210 msgid "guestfs_cat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1224 +#: ../src/guestfs-actions.pod:1212 #, no-wrap msgid "" " char *\n" @@ -30734,7 +30466,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1230 +#: ../src/guestfs-actions.pod:1218 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of string). For " @@ -30743,17 +30475,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1241 ../src/guestfs-actions.pod:4916 ../src/guestfs-actions.pod:5011 ../src/guestfs-actions.pod:5028 ../src/guestfs-actions.pod:5132 ../src/guestfs-actions.pod:5548 ../src/guestfs-actions.pod:5562 ../src/guestfs-actions.pod:7462 ../src/guestfs-actions.pod:7476 ../src/guestfs-actions.pod:9708 ../src/guestfs-actions.pod:9722 +#: ../src/guestfs-actions.pod:1229 ../src/guestfs-actions.pod:4712 ../src/guestfs-actions.pod:4807 ../src/guestfs-actions.pod:4824 ../src/guestfs-actions.pod:4928 ../src/guestfs-actions.pod:5344 ../src/guestfs-actions.pod:5358 ../src/guestfs-actions.pod:7239 ../src/guestfs-actions.pod:7253 ../src/guestfs-actions.pod:9378 ../src/guestfs-actions.pod:9392 msgid "(Added in 0.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1243 +#: ../src/guestfs-actions.pod:1231 msgid "guestfs_checksum" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1245 +#: ../src/guestfs-actions.pod:1233 #, no-wrap msgid "" " char *\n" @@ -30764,27 +30496,27 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1291 +#: ../src/guestfs-actions.pod:1279 msgid "To get the checksum for a device, use C<guestfs_checksum_device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1293 +#: ../src/guestfs-actions.pod:1281 msgid "To get the checksums for many files, use C<guestfs_checksums_out>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1298 ../src/guestfs-actions.pod:1983 ../src/guestfs-actions.pod:3158 ../src/guestfs-actions.pod:4593 ../src/guestfs-actions.pod:4654 ../src/guestfs-actions.pod:4681 ../src/guestfs-actions.pod:9360 +#: ../src/guestfs-actions.pod:1286 ../src/guestfs-actions.pod:1969 ../src/guestfs-actions.pod:3033 ../src/guestfs-actions.pod:4389 ../src/guestfs-actions.pod:4450 ../src/guestfs-actions.pod:4477 ../src/guestfs-actions.pod:9062 msgid "(Added in 1.0.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1300 +#: ../src/guestfs-actions.pod:1288 msgid "guestfs_checksum_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1302 +#: ../src/guestfs-actions.pod:1290 #, no-wrap msgid "" " char *\n" @@ -30795,7 +30527,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1307 +#: ../src/guestfs-actions.pod:1295 msgid "" "This call computes the MD5, SHAx or CRC checksum of the contents of the " "device named C<device>. For the types of checksums supported see the " @@ -30803,17 +30535,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1314 ../src/guestfs-actions.pod:6874 ../src/guestfs-actions.pod:7010 ../src/guestfs-actions.pod:7044 ../src/guestfs-actions.pod:7062 ../src/guestfs-actions.pod:7244 ../src/guestfs-actions.pod:9185 ../src/guestfs-actions.pod:9199 ../src/guestfs-actions.pod:9734 +#: ../src/guestfs-actions.pod:1302 ../src/guestfs-actions.pod:6671 ../src/guestfs-actions.pod:6806 ../src/guestfs-actions.pod:6840 ../src/guestfs-actions.pod:6858 ../src/guestfs-actions.pod:7040 ../src/guestfs-actions.pod:8929 ../src/guestfs-actions.pod:8943 ../src/guestfs-actions.pod:9404 msgid "(Added in 1.3.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1316 +#: ../src/guestfs-actions.pod:1304 msgid "guestfs_checksums_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1318 +#: ../src/guestfs-actions.pod:1306 #, no-wrap msgid "" " int\n" @@ -30825,17 +30557,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1338 +#: ../src/guestfs-actions.pod:1326 msgid "(Added in 1.3.7)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1340 +#: ../src/guestfs-actions.pod:1328 msgid "guestfs_chmod" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1342 +#: ../src/guestfs-actions.pod:1330 #, no-wrap msgid "" " int\n" @@ -30846,12 +30578,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1360 +#: ../src/guestfs-actions.pod:1348 msgid "guestfs_chown" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1362 +#: ../src/guestfs-actions.pod:1350 #, no-wrap msgid "" " int\n" @@ -30863,12 +30595,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1378 +#: ../src/guestfs-actions.pod:1366 msgid "guestfs_command" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1380 +#: ../src/guestfs-actions.pod:1368 #, no-wrap msgid "" " char *\n" @@ -30878,7 +30610,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1389 +#: ../src/guestfs-actions.pod:1377 msgid "" "The single parameter is an argv-style list of arguments. The first element " "is the name of the program to run. Subsequent elements are parameters. The " @@ -30888,17 +30620,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1420 ../src/guestfs-actions.pod:1440 ../src/guestfs-actions.pod:2377 +#: ../src/guestfs-actions.pod:1408 ../src/guestfs-actions.pod:1428 ../src/guestfs-actions.pod:2335 msgid "(Added in 0.9.1)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1422 +#: ../src/guestfs-actions.pod:1410 msgid "guestfs_command_lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1424 +#: ../src/guestfs-actions.pod:1412 #, no-wrap msgid "" " char **\n" @@ -30908,24 +30640,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1428 +#: ../src/guestfs-actions.pod:1416 msgid "" "This is the same as C<guestfs_command>, but splits the result into a list of " "lines." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1431 +#: ../src/guestfs-actions.pod:1419 msgid "See also: C<guestfs_sh_lines>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1442 +#: ../src/guestfs-actions.pod:1430 msgid "guestfs_compress_device_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1444 +#: ../src/guestfs-actions.pod:1432 #, no-wrap msgid "" " int\n" @@ -30938,7 +30670,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1456 +#: ../src/guestfs-actions.pod:1444 #, no-wrap msgid "" " GUESTFS_COMPRESS_DEVICE_OUT_LEVEL, int level,\n" @@ -30946,24 +30678,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1461 +#: ../src/guestfs-actions.pod:1449 msgid "" "The C<ctype> and optional C<level> parameters have the same meaning as in " "C<guestfs_compress_out>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1466 ../src/guestfs-actions.pod:1525 ../src/guestfs-actions.pod:3144 ../src/guestfs-actions.pod:8321 +#: ../src/guestfs-actions.pod:1454 ../src/guestfs-actions.pod:1513 ../src/guestfs-actions.pod:3019 ../src/guestfs-actions.pod:8065 msgid "(Added in 1.13.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1468 +#: ../src/guestfs-actions.pod:1456 msgid "guestfs_compress_device_out_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1470 +#: ../src/guestfs-actions.pod:1458 #, no-wrap msgid "" " int\n" @@ -30976,17 +30708,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1477 +#: ../src/guestfs-actions.pod:1465 msgid "This is the \"va_list variant\" of L</guestfs_compress_device_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1481 +#: ../src/guestfs-actions.pod:1469 msgid "guestfs_compress_device_out_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1483 +#: ../src/guestfs-actions.pod:1471 #, no-wrap msgid "" " int\n" @@ -31000,17 +30732,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1490 +#: ../src/guestfs-actions.pod:1478 msgid "This is the \"argv variant\" of L</guestfs_compress_device_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1494 +#: ../src/guestfs-actions.pod:1482 msgid "guestfs_compress_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1496 +#: ../src/guestfs-actions.pod:1484 #, no-wrap msgid "" " int\n" @@ -31023,7 +30755,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1508 +#: ../src/guestfs-actions.pod:1496 #, no-wrap msgid "" " GUESTFS_COMPRESS_OUT_LEVEL, int level,\n" @@ -31031,12 +30763,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1527 +#: ../src/guestfs-actions.pod:1515 msgid "guestfs_compress_out_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1529 +#: ../src/guestfs-actions.pod:1517 #, no-wrap msgid "" " int\n" @@ -31049,17 +30781,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1536 +#: ../src/guestfs-actions.pod:1524 msgid "This is the \"va_list variant\" of L</guestfs_compress_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1540 +#: ../src/guestfs-actions.pod:1528 msgid "guestfs_compress_out_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1542 +#: ../src/guestfs-actions.pod:1530 #, no-wrap msgid "" " int\n" @@ -31073,17 +30805,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1549 +#: ../src/guestfs-actions.pod:1537 msgid "This is the \"argv variant\" of L</guestfs_compress_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1553 +#: ../src/guestfs-actions.pod:1541 msgid "guestfs_config" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1555 +#: ../src/guestfs-actions.pod:1543 #, no-wrap msgid "" " int\n" @@ -31094,12 +30826,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1573 +#: ../src/guestfs-actions.pod:1561 msgid "guestfs_copy_device_to_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1575 +#: ../src/guestfs-actions.pod:1563 #, no-wrap msgid "" " int\n" @@ -31111,7 +30843,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1586 +#: ../src/guestfs-actions.pod:1574 #, no-wrap msgid "" " GUESTFS_COPY_DEVICE_TO_DEVICE_SRCOFFSET, int64_t srcoffset,\n" @@ -31121,7 +30853,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1590 +#: ../src/guestfs-actions.pod:1578 msgid "" "The four calls C<guestfs_copy_device_to_device>, " "C<guestfs_copy_device_to_file>, C<guestfs_copy_file_to_device>, and " @@ -31130,7 +30862,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1611 ../src/guestfs-actions.pod:1664 ../src/guestfs-actions.pod:1717 ../src/guestfs-actions.pod:1775 ../src/guestfs-actions.pod:1829 ../src/guestfs-actions.pod:1978 ../src/guestfs-actions.pod:2009 ../src/guestfs-actions.pod:2054 ../src/guestfs-actions.pod:2549 ../src/guestfs-actions.pod:2571 ../src/guestfs-actions.pod:4814 ../src/guestfs-actions.pod:9355 ../src/guestfs-actions.pod:9389 ../src/guestfs-actions.pod:10049 ../src/guestfs-actions.pod:10072 ../src/guestfs-actions.pod:10097 +#: ../src/guestfs-actions.pod:1599 ../src/guestfs-actions.pod:1652 ../src/guestfs-actions.pod:1705 ../src/guestfs-actions.pod:1763 ../src/guestfs-actions.pod:1817 ../src/guestfs-actions.pod:1964 ../src/guestfs-actions.pod:1995 ../src/guestfs-actions.pod:2040 ../src/guestfs-actions.pod:2484 ../src/guestfs-actions.pod:2506 ../src/guestfs-actions.pod:4610 ../src/guestfs-actions.pod:9057 ../src/guestfs-actions.pod:9091 ../src/guestfs-actions.pod:9636 ../src/guestfs-actions.pod:9659 ../src/guestfs-actions.pod:9683 msgid "" "This long-running command can generate progress notification messages so " "that the caller can display a progress bar or indicator. To receive these " @@ -31139,17 +30871,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1616 ../src/guestfs-actions.pod:1669 ../src/guestfs-actions.pod:1722 ../src/guestfs-actions.pod:1780 ../src/guestfs-actions.pod:7300 +#: ../src/guestfs-actions.pod:1604 ../src/guestfs-actions.pod:1657 ../src/guestfs-actions.pod:1710 ../src/guestfs-actions.pod:1768 ../src/guestfs-actions.pod:7096 msgid "(Added in 1.13.25)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1618 +#: ../src/guestfs-actions.pod:1606 msgid "guestfs_copy_device_to_device_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1620 +#: ../src/guestfs-actions.pod:1608 #, no-wrap msgid "" " int\n" @@ -31161,17 +30893,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1626 +#: ../src/guestfs-actions.pod:1614 msgid "This is the \"va_list variant\" of L</guestfs_copy_device_to_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1630 +#: ../src/guestfs-actions.pod:1618 msgid "guestfs_copy_device_to_device_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1632 +#: ../src/guestfs-actions.pod:1620 #, no-wrap msgid "" " int\n" @@ -31184,17 +30916,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1638 +#: ../src/guestfs-actions.pod:1626 msgid "This is the \"argv variant\" of L</guestfs_copy_device_to_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1642 +#: ../src/guestfs-actions.pod:1630 msgid "guestfs_copy_device_to_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1644 +#: ../src/guestfs-actions.pod:1632 #, no-wrap msgid "" " int\n" @@ -31206,7 +30938,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1655 +#: ../src/guestfs-actions.pod:1643 #, no-wrap msgid "" " GUESTFS_COPY_DEVICE_TO_FILE_SRCOFFSET, int64_t srcoffset,\n" @@ -31216,17 +30948,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1659 ../src/guestfs-actions.pod:1712 ../src/guestfs-actions.pod:1765 +#: ../src/guestfs-actions.pod:1647 ../src/guestfs-actions.pod:1700 ../src/guestfs-actions.pod:1753 msgid "See C<guestfs_copy_device_to_device> for a general overview of this call." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1671 +#: ../src/guestfs-actions.pod:1659 msgid "guestfs_copy_device_to_file_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1673 +#: ../src/guestfs-actions.pod:1661 #, no-wrap msgid "" " int\n" @@ -31238,17 +30970,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1679 +#: ../src/guestfs-actions.pod:1667 msgid "This is the \"va_list variant\" of L</guestfs_copy_device_to_file>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1683 +#: ../src/guestfs-actions.pod:1671 msgid "guestfs_copy_device_to_file_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1685 +#: ../src/guestfs-actions.pod:1673 #, no-wrap msgid "" " int\n" @@ -31261,17 +30993,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1691 +#: ../src/guestfs-actions.pod:1679 msgid "This is the \"argv variant\" of L</guestfs_copy_device_to_file>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1695 +#: ../src/guestfs-actions.pod:1683 msgid "guestfs_copy_file_to_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1697 +#: ../src/guestfs-actions.pod:1685 #, no-wrap msgid "" " int\n" @@ -31283,7 +31015,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1708 +#: ../src/guestfs-actions.pod:1696 #, no-wrap msgid "" " GUESTFS_COPY_FILE_TO_DEVICE_SRCOFFSET, int64_t srcoffset,\n" @@ -31293,12 +31025,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1724 +#: ../src/guestfs-actions.pod:1712 msgid "guestfs_copy_file_to_device_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1726 +#: ../src/guestfs-actions.pod:1714 #, no-wrap msgid "" " int\n" @@ -31310,17 +31042,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1732 +#: ../src/guestfs-actions.pod:1720 msgid "This is the \"va_list variant\" of L</guestfs_copy_file_to_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1736 +#: ../src/guestfs-actions.pod:1724 msgid "guestfs_copy_file_to_device_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1738 +#: ../src/guestfs-actions.pod:1726 #, no-wrap msgid "" " int\n" @@ -31333,17 +31065,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1744 +#: ../src/guestfs-actions.pod:1732 msgid "This is the \"argv variant\" of L</guestfs_copy_file_to_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1748 +#: ../src/guestfs-actions.pod:1736 msgid "guestfs_copy_file_to_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1750 +#: ../src/guestfs-actions.pod:1738 #, no-wrap msgid "" " int\n" @@ -31355,7 +31087,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1761 +#: ../src/guestfs-actions.pod:1749 #, no-wrap msgid "" " GUESTFS_COPY_FILE_TO_FILE_SRCOFFSET, int64_t srcoffset,\n" @@ -31365,7 +31097,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1768 +#: ../src/guestfs-actions.pod:1756 msgid "" "This is B<not> the function you want for copying files. This is for copying " "blocks within existing files. See C<guestfs_cp>, C<guestfs_cp_a> and " @@ -31373,12 +31105,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1782 +#: ../src/guestfs-actions.pod:1770 msgid "guestfs_copy_file_to_file_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1784 +#: ../src/guestfs-actions.pod:1772 #, no-wrap msgid "" " int\n" @@ -31390,17 +31122,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1790 +#: ../src/guestfs-actions.pod:1778 msgid "This is the \"va_list variant\" of L</guestfs_copy_file_to_file>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1794 +#: ../src/guestfs-actions.pod:1782 msgid "guestfs_copy_file_to_file_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1796 +#: ../src/guestfs-actions.pod:1784 #, no-wrap msgid "" " int\n" @@ -31413,17 +31145,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1802 +#: ../src/guestfs-actions.pod:1790 msgid "This is the \"argv variant\" of L</guestfs_copy_file_to_file>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1806 +#: ../src/guestfs-actions.pod:1794 msgid "guestfs_copy_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1808 +#: ../src/guestfs-actions.pod:1796 #, no-wrap msgid "" " int\n" @@ -31435,24 +31167,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1814 ../src/guestfs-actions.pod:1871 +#: ../src/guestfs-actions.pod:1802 ../src/guestfs-actions.pod:1859 msgid "" "I<This function is deprecated.> In new code, use the " "L</guestfs_copy_device_to_device> call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1834 ../src/guestfs-actions.pod:5575 ../src/guestfs-actions.pod:7489 ../src/guestfs-actions.pod:9622 ../src/guestfs-actions.pod:9661 ../src/guestfs-actions.pod:9747 +#: ../src/guestfs-actions.pod:1822 ../src/guestfs-actions.pod:5371 ../src/guestfs-actions.pod:7266 ../src/guestfs-actions.pod:9292 ../src/guestfs-actions.pod:9331 ../src/guestfs-actions.pod:9417 msgid "(Added in 1.0.87)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1836 +#: ../src/guestfs-actions.pod:1824 msgid "guestfs_cp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1838 +#: ../src/guestfs-actions.pod:1826 #, no-wrap msgid "" " int\n" @@ -31463,17 +31195,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1848 ../src/guestfs-actions.pod:1862 ../src/guestfs-actions.pod:1960 ../src/guestfs-actions.pod:2034 ../src/guestfs-actions.pod:2229 ../src/guestfs-actions.pod:6698 ../src/guestfs-actions.pod:7314 +#: ../src/guestfs-actions.pod:1836 ../src/guestfs-actions.pod:1850 ../src/guestfs-actions.pod:1946 ../src/guestfs-actions.pod:2020 ../src/guestfs-actions.pod:2201 ../src/guestfs-actions.pod:6477 ../src/guestfs-actions.pod:7110 msgid "(Added in 1.0.18)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1850 +#: ../src/guestfs-actions.pod:1838 msgid "guestfs_cp_a" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1852 +#: ../src/guestfs-actions.pod:1840 #, no-wrap msgid "" " int\n" @@ -31484,12 +31216,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1864 +#: ../src/guestfs-actions.pod:1852 msgid "guestfs_dd" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1866 +#: ../src/guestfs-actions.pod:1854 #, no-wrap msgid "" " int\n" @@ -31500,7 +31232,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1883 +#: ../src/guestfs-actions.pod:1871 msgid "" "If the destination is a device, it must be as large or larger than the " "source file or device, otherwise the copy will fail. This command cannot do " @@ -31508,12 +31240,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1892 +#: ../src/guestfs-actions.pod:1880 msgid "guestfs_device_index" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1894 +#: ../src/guestfs-actions.pod:1882 #, no-wrap msgid "" " int\n" @@ -31523,24 +31255,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1901 +#: ../src/guestfs-actions.pod:1889 msgid "" "Index numbers start from 0. The named device must exist, for example as a " "string returned from C<guestfs_list_devices>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1904 +#: ../src/guestfs-actions.pod:1892 msgid "See also C<guestfs_list_devices>, C<guestfs_part_to_dev>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1910 +#: ../src/guestfs-actions.pod:1896 msgid "guestfs_df" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1912 +#: ../src/guestfs-actions.pod:1898 #, no-wrap msgid "" " char *\n" @@ -31549,7 +31281,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1917 ../src/guestfs-actions.pod:1934 +#: ../src/guestfs-actions.pod:1903 ../src/guestfs-actions.pod:1920 msgid "" "This command is mostly useful for interactive sessions. It is I<not> " "intended that you try to parse the output string. Use C<guestfs_statvfs> " @@ -31557,17 +31289,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1924 ../src/guestfs-actions.pod:1941 ../src/guestfs-actions.pod:2059 ../src/guestfs-actions.pod:3466 ../src/guestfs-actions.pod:3490 ../src/guestfs-actions.pod:3558 ../src/guestfs-actions.pod:5916 ../src/guestfs-actions.pod:6598 ../src/guestfs-actions.pod:8887 ../src/guestfs-actions.pod:8911 ../src/guestfs-actions.pod:9787 ../src/guestfs-actions.pod:9800 ../src/guestfs-actions.pod:9813 +#: ../src/guestfs-actions.pod:1910 ../src/guestfs-actions.pod:1927 ../src/guestfs-actions.pod:2045 ../src/guestfs-actions.pod:3262 ../src/guestfs-actions.pod:3286 ../src/guestfs-actions.pod:3354 ../src/guestfs-actions.pod:5694 ../src/guestfs-actions.pod:6377 ../src/guestfs-actions.pod:8631 ../src/guestfs-actions.pod:8655 ../src/guestfs-actions.pod:9457 ../src/guestfs-actions.pod:9470 ../src/guestfs-actions.pod:9483 msgid "(Added in 1.0.54)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1926 +#: ../src/guestfs-actions.pod:1912 msgid "guestfs_df_h" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1928 +#: ../src/guestfs-actions.pod:1914 #, no-wrap msgid "" " char *\n" @@ -31576,12 +31308,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1943 +#: ../src/guestfs-actions.pod:1929 msgid "guestfs_dmesg" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1945 +#: ../src/guestfs-actions.pod:1931 #, no-wrap msgid "" " char *\n" @@ -31590,7 +31322,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1952 +#: ../src/guestfs-actions.pod:1938 msgid "" "Another way to get the same information is to enable verbose messages with " "C<guestfs_set_verbose> or by setting the environment variable " @@ -31598,12 +31330,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1962 +#: ../src/guestfs-actions.pod:1948 msgid "guestfs_download" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1964 +#: ../src/guestfs-actions.pod:1950 #, no-wrap msgid "" " int\n" @@ -31614,17 +31346,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1974 +#: ../src/guestfs-actions.pod:1960 msgid "See also C<guestfs_upload>, C<guestfs_cat>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1985 +#: ../src/guestfs-actions.pod:1971 msgid "guestfs_download_offset" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1987 +#: ../src/guestfs-actions.pod:1973 #, no-wrap msgid "" " int\n" @@ -31637,7 +31369,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2000 +#: ../src/guestfs-actions.pod:1986 msgid "" "Note that there is no limit on the amount of data that can be downloaded " "with this call, unlike with C<guestfs_pread>, and this call always reads the " @@ -31645,22 +31377,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2005 +#: ../src/guestfs-actions.pod:1991 msgid "See also C<guestfs_download>, C<guestfs_pread>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2014 ../src/guestfs-actions.pod:9394 +#: ../src/guestfs-actions.pod:2000 ../src/guestfs-actions.pod:9096 msgid "(Added in 1.5.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2016 +#: ../src/guestfs-actions.pod:2002 msgid "guestfs_drop_caches" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2018 +#: ../src/guestfs-actions.pod:2004 #, no-wrap msgid "" " int\n" @@ -31670,12 +31402,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2036 +#: ../src/guestfs-actions.pod:2022 msgid "guestfs_du" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2038 +#: ../src/guestfs-actions.pod:2024 #, no-wrap msgid "" " int64_t\n" @@ -31685,12 +31417,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2061 +#: ../src/guestfs-actions.pod:2047 msgid "guestfs_e2fsck" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2063 +#: ../src/guestfs-actions.pod:2049 #, no-wrap msgid "" " int\n" @@ -31701,7 +31433,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2073 +#: ../src/guestfs-actions.pod:2059 #, no-wrap msgid "" " GUESTFS_E2FSCK_CORRECT, int correct,\n" @@ -31710,17 +31442,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2100 +#: ../src/guestfs-actions.pod:2086 msgid "(Added in 1.15.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2102 +#: ../src/guestfs-actions.pod:2088 msgid "guestfs_e2fsck_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2104 +#: ../src/guestfs-actions.pod:2090 #, no-wrap msgid "" " int\n" @@ -31731,17 +31463,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2109 +#: ../src/guestfs-actions.pod:2095 msgid "This is the \"va_list variant\" of L</guestfs_e2fsck>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2113 +#: ../src/guestfs-actions.pod:2099 msgid "guestfs_e2fsck_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2115 +#: ../src/guestfs-actions.pod:2101 #, no-wrap msgid "" " int\n" @@ -31752,17 +31484,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2120 +#: ../src/guestfs-actions.pod:2106 msgid "This is the \"argv variant\" of L</guestfs_e2fsck>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2124 +#: ../src/guestfs-actions.pod:2110 msgid "guestfs_e2fsck_f" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2126 +#: ../src/guestfs-actions.pod:2112 #, no-wrap msgid "" " int\n" @@ -31772,24 +31504,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2130 +#: ../src/guestfs-actions.pod:2116 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_e2fsck> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2143 +#: ../src/guestfs-actions.pod:2129 msgid "(Added in 1.0.29)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2145 +#: ../src/guestfs-actions.pod:2131 msgid "guestfs_echo_daemon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2147 +#: ../src/guestfs-actions.pod:2133 #, no-wrap msgid "" " char *\n" @@ -31799,22 +31531,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2156 +#: ../src/guestfs-actions.pod:2142 msgid "See also C<guestfs_ping_daemon>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2161 ../src/guestfs-actions.pod:3169 ../src/guestfs-actions.pod:8345 +#: ../src/guestfs-actions.pod:2147 ../src/guestfs-actions.pod:3044 ../src/guestfs-actions.pod:8089 msgid "(Added in 1.0.69)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2163 +#: ../src/guestfs-actions.pod:2149 msgid "guestfs_egrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2165 +#: ../src/guestfs-actions.pod:2151 #, no-wrap msgid "" " char **\n" @@ -31825,24 +31557,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2170 ../src/guestfs-actions.pod:2196 ../src/guestfs-actions.pod:2306 ../src/guestfs-actions.pod:2332 ../src/guestfs-actions.pod:3384 ../src/guestfs-actions.pod:9983 ../src/guestfs-actions.pod:10009 ../src/guestfs-actions.pod:10132 ../src/guestfs-actions.pod:10158 ../src/guestfs-actions.pod:10211 ../src/guestfs-actions.pod:10237 -msgid "" -"I<This function is deprecated.> In new code, use the L</guestfs_grep> call " -"instead." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2187 ../src/guestfs-actions.pod:2213 ../src/guestfs-actions.pod:2270 ../src/guestfs-actions.pod:2323 ../src/guestfs-actions.pod:2349 ../src/guestfs-actions.pod:3297 ../src/guestfs-actions.pod:3401 ../src/guestfs-actions.pod:3579 ../src/guestfs-actions.pod:3592 ../src/guestfs-actions.pod:3607 ../src/guestfs-actions.pod:3651 ../src/guestfs-actions.pod:3673 ../src/guestfs-actions.pod:3686 ../src/guestfs-actions.pod:5057 ../src/guestfs-actions.pod:5071 ../src/guestfs-actions.pod:5084 ../src/guestfs-actions.pod:5098 ../src/guestfs-actions.pod:6392 ../src/guestfs-actions.pod:7667 ../src/guestfs-actions.pod:7716 ../src/guestfs-actions.pod:8755 ../src/guestfs-actions.pod:8767 ../src/guestfs-actions.pod:8780 ../src/guestfs-actions.pod:8793 ../src/guestfs-actions.pod:8815 ../src/guestfs-actions.pod:8828 ../src/guestfs-actions.pod:8841 ../src/guestfs-actions.pod:8854 ../src/guestfs-actions.pod:10000 ../src/guestfs-actions.pod:10026 ../src/guestfs-actions.pod:10149 ../src/guestfs-actions.pod:10175 ../src/guestfs-actions.pod:10228 ../src/guestfs-actions.pod:10254 +#: ../src/guestfs-actions.pod:2166 ../src/guestfs-actions.pod:2185 ../src/guestfs-actions.pod:2242 ../src/guestfs-actions.pod:2288 ../src/guestfs-actions.pod:2307 ../src/guestfs-actions.pod:3178 ../src/guestfs-actions.pod:3197 ../src/guestfs-actions.pod:3375 ../src/guestfs-actions.pod:3388 ../src/guestfs-actions.pod:3403 ../src/guestfs-actions.pod:3447 ../src/guestfs-actions.pod:3469 ../src/guestfs-actions.pod:3482 ../src/guestfs-actions.pod:4853 ../src/guestfs-actions.pod:4867 ../src/guestfs-actions.pod:4880 ../src/guestfs-actions.pod:4894 ../src/guestfs-actions.pod:6171 ../src/guestfs-actions.pod:7444 ../src/guestfs-actions.pod:7493 ../src/guestfs-actions.pod:8499 ../src/guestfs-actions.pod:8511 ../src/guestfs-actions.pod:8524 ../src/guestfs-actions.pod:8537 ../src/guestfs-actions.pod:8559 ../src/guestfs-actions.pod:8572 ../src/guestfs-actions.pod:8585 ../src/guestfs-actions.pod:8598 ../src/guestfs-actions.pod:9594 ../src/guestfs-actions.pod:9613 ../src/guestfs-actions.pod:9728 ../src/guestfs-actions.pod:9747 ../src/guestfs-actions.pod:9793 ../src/guestfs-actions.pod:9812 msgid "(Added in 1.0.66)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2189 +#: ../src/guestfs-actions.pod:2168 msgid "guestfs_egrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2191 +#: ../src/guestfs-actions.pod:2170 #, no-wrap msgid "" " char **\n" @@ -31853,12 +31578,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2215 +#: ../src/guestfs-actions.pod:2187 msgid "guestfs_equal" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2217 +#: ../src/guestfs-actions.pod:2189 #, no-wrap msgid "" " int\n" @@ -31869,12 +31594,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2231 +#: ../src/guestfs-actions.pod:2203 msgid "guestfs_exists" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2233 +#: ../src/guestfs-actions.pod:2205 #, no-wrap msgid "" " int\n" @@ -31884,17 +31609,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2240 +#: ../src/guestfs-actions.pod:2212 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2246 +#: ../src/guestfs-actions.pod:2218 msgid "guestfs_fallocate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2248 +#: ../src/guestfs-actions.pod:2220 #, no-wrap msgid "" " int\n" @@ -31905,19 +31630,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2253 +#: ../src/guestfs-actions.pod:2225 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_fallocate64> " "call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2272 +#: ../src/guestfs-actions.pod:2244 msgid "guestfs_fallocate64" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2274 +#: ../src/guestfs-actions.pod:2246 #, no-wrap msgid "" " int\n" @@ -31928,14 +31653,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2283 +#: ../src/guestfs-actions.pod:2255 msgid "" "Note that this call allocates disk blocks for the file. To create a sparse " "file use C<guestfs_truncate_size> instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2286 +#: ../src/guestfs-actions.pod:2258 msgid "" "The deprecated call C<guestfs_fallocate> does the same, but owing to an " "oversight it only allowed 30 bit lengths to be specified, effectively " @@ -31943,17 +31668,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2297 +#: ../src/guestfs-actions.pod:2269 msgid "(Added in 1.3.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2299 +#: ../src/guestfs-actions.pod:2271 msgid "guestfs_fgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2301 +#: ../src/guestfs-actions.pod:2273 #, no-wrap msgid "" " char **\n" @@ -31964,12 +31689,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2325 +#: ../src/guestfs-actions.pod:2290 msgid "guestfs_fgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2327 +#: ../src/guestfs-actions.pod:2292 #, no-wrap msgid "" " char **\n" @@ -31980,12 +31705,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2351 +#: ../src/guestfs-actions.pod:2309 msgid "guestfs_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2353 +#: ../src/guestfs-actions.pod:2311 #, no-wrap msgid "" " char *\n" @@ -31995,19 +31720,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2371 +#: ../src/guestfs-actions.pod:2329 msgid "" "See also: L<file(1)>, C<guestfs_vfs_type>, C<guestfs_lstat>, " "C<guestfs_is_file>, C<guestfs_is_blockdev> (etc), C<guestfs_is_zero>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2379 +#: ../src/guestfs-actions.pod:2337 msgid "guestfs_file_architecture" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2381 +#: ../src/guestfs-actions.pod:2339 #, no-wrap msgid "" " char *\n" @@ -32017,17 +31742,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2489 ../src/guestfs-actions.pod:2675 ../src/guestfs-actions.pod:2692 ../src/guestfs-actions.pod:3706 ../src/guestfs-actions.pod:3820 ../src/guestfs-actions.pod:3886 ../src/guestfs-actions.pod:4073 ../src/guestfs-actions.pod:4091 ../src/guestfs-actions.pod:4131 ../src/guestfs-actions.pod:4207 ../src/guestfs-actions.pod:4312 ../src/guestfs-actions.pod:4549 ../src/guestfs-actions.pod:4667 +#: ../src/guestfs-actions.pod:2447 ../src/guestfs-actions.pod:2610 ../src/guestfs-actions.pod:2627 ../src/guestfs-actions.pod:3502 ../src/guestfs-actions.pod:3616 ../src/guestfs-actions.pod:3682 ../src/guestfs-actions.pod:3869 ../src/guestfs-actions.pod:3887 ../src/guestfs-actions.pod:3927 ../src/guestfs-actions.pod:4003 ../src/guestfs-actions.pod:4108 ../src/guestfs-actions.pod:4345 ../src/guestfs-actions.pod:4463 msgid "(Added in 1.5.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2491 +#: ../src/guestfs-actions.pod:2449 msgid "guestfs_filesize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2493 +#: ../src/guestfs-actions.pod:2451 #, no-wrap msgid "" " int64_t\n" @@ -32037,7 +31762,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2499 +#: ../src/guestfs-actions.pod:2457 msgid "" "To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, " "C<guestfs_is_dir>, C<guestfs_is_file> etc. To get the size of block " @@ -32045,47 +31770,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2505 +#: ../src/guestfs-actions.pod:2463 msgid "(Added in 1.0.82)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2507 -msgid "guestfs_filesystem_available" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:2509 -#, no-wrap -msgid "" -" int\n" -" guestfs_filesystem_available (guestfs_h *g,\n" -" const char *filesystem);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2517 -msgid "You must call C<guestfs_launch> before using this command." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2524 -msgid "See also C<guestfs_available>, L<guestfs(3)/AVAILABILITY>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2528 -msgid "(Added in 1.19.5)" -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:2530 +#: ../src/guestfs-actions.pod:2465 msgid "guestfs_fill" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2532 +#: ../src/guestfs-actions.pod:2467 #, no-wrap msgid "" " int\n" @@ -32097,7 +31792,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2542 +#: ../src/guestfs-actions.pod:2477 msgid "" "To fill a file with zero bytes (sparsely), it is much more efficient to use " "C<guestfs_truncate_size>. To create a file with a pattern of repeating " @@ -32105,17 +31800,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2554 +#: ../src/guestfs-actions.pod:2489 msgid "(Added in 1.0.79)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2556 +#: ../src/guestfs-actions.pod:2491 msgid "guestfs_fill_pattern" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2558 +#: ../src/guestfs-actions.pod:2493 #, no-wrap msgid "" " int\n" @@ -32127,7 +31822,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2564 +#: ../src/guestfs-actions.pod:2499 msgid "" "This function is like C<guestfs_fill> except that it creates a new file of " "length C<len> containing the repeating pattern of bytes in C<pattern>. The " @@ -32136,17 +31831,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2576 +#: ../src/guestfs-actions.pod:2511 msgid "(Added in 1.3.12)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2578 +#: ../src/guestfs-actions.pod:2513 msgid "guestfs_find" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2580 +#: ../src/guestfs-actions.pod:2515 #, no-wrap msgid "" " char **\n" @@ -32156,27 +31851,27 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2596 +#: ../src/guestfs-actions.pod:2531 msgid "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2609 +#: ../src/guestfs-actions.pod:2544 msgid "See also C<guestfs_find0>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2618 ../src/guestfs-actions.pod:5512 ../src/guestfs-actions.pod:7747 +#: ../src/guestfs-actions.pod:2553 ../src/guestfs-actions.pod:5308 ../src/guestfs-actions.pod:7524 msgid "(Added in 1.0.27)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2620 +#: ../src/guestfs-actions.pod:2555 msgid "guestfs_find0" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2622 +#: ../src/guestfs-actions.pod:2557 #, no-wrap msgid "" " int\n" @@ -32187,24 +31882,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2631 +#: ../src/guestfs-actions.pod:2566 msgid "" "This command works the same way as C<guestfs_find> with the following " "exceptions:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2658 +#: ../src/guestfs-actions.pod:2593 msgid "(Added in 1.0.74)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2660 +#: ../src/guestfs-actions.pod:2595 msgid "guestfs_findfs_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2662 +#: ../src/guestfs-actions.pod:2597 #, no-wrap msgid "" " char *\n" @@ -32214,17 +31909,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2670 +#: ../src/guestfs-actions.pod:2605 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2677 +#: ../src/guestfs-actions.pod:2612 msgid "guestfs_findfs_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2679 +#: ../src/guestfs-actions.pod:2614 #, no-wrap msgid "" " char *\n" @@ -32234,17 +31929,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2687 +#: ../src/guestfs-actions.pod:2622 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2694 +#: ../src/guestfs-actions.pod:2629 msgid "guestfs_fsck" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2696 +#: ../src/guestfs-actions.pod:2631 #, no-wrap msgid "" " int\n" @@ -32255,99 +31950,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2731 ../src/guestfs-actions.pod:10054 +#: ../src/guestfs-actions.pod:2666 ../src/guestfs-actions.pod:9641 msgid "(Added in 1.0.16)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2733 -msgid "guestfs_fstrim" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:2735 -#, no-wrap -msgid "" -" int\n" -" guestfs_fstrim (guestfs_h *g,\n" -" const char *mountpoint,\n" -" ...);\n" -"\n" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:2745 -#, no-wrap -msgid "" -" GUESTFS_FSTRIM_OFFSET, int64_t offset,\n" -" GUESTFS_FSTRIM_LENGTH, int64_t length,\n" -" GUESTFS_FSTRIM_MINIMUMFREEEXTENT, int64_t minimumfreeextent,\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2762 -msgid "" -"See also C<guestfs_zero_free_space>. That is a slightly different operation " -"that turns free space in the filesystem into zeroes. It is valid to call " -"C<guestfs_fstrim> either instead of, or after calling " -"C<guestfs_zero_free_space>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2769 -msgid "(Added in 1.19.6)" -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:2771 -msgid "guestfs_fstrim_va" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:2773 -#, no-wrap -msgid "" -" int\n" -" guestfs_fstrim_va (guestfs_h *g,\n" -" const char *mountpoint,\n" -" va_list args);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2778 -msgid "This is the \"va_list variant\" of L</guestfs_fstrim>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:2782 -msgid "guestfs_fstrim_argv" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:2784 -#, no-wrap -msgid "" -" int\n" -" guestfs_fstrim_argv (guestfs_h *g,\n" -" const char *mountpoint,\n" -" const struct guestfs_fstrim_argv *optargs);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2789 -msgid "This is the \"argv variant\" of L</guestfs_fstrim>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:2793 +#: ../src/guestfs-actions.pod:2668 msgid "guestfs_get_append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2795 +#: ../src/guestfs-actions.pod:2670 #, no-wrap msgid "" " const char *\n" @@ -32356,7 +31969,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2803 +#: ../src/guestfs-actions.pod:2678 msgid "" "This function returns a string which may be NULL. There is no way to return " "an error from this function. The string is owned by the guest handle and " @@ -32364,17 +31977,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2807 ../src/guestfs-actions.pod:7429 ../src/guestfs-actions.pod:7908 ../src/guestfs-actions.pod:8499 ../src/guestfs-actions.pod:8518 ../src/guestfs-actions.pod:8534 ../src/guestfs-actions.pod:8558 ../src/guestfs-actions.pod:9554 ../src/guestfs-actions.pod:9569 ../src/guestfs-actions.pod:10123 +#: ../src/guestfs-actions.pod:2682 ../src/guestfs-actions.pod:7206 ../src/guestfs-actions.pod:7685 ../src/guestfs-actions.pod:8243 ../src/guestfs-actions.pod:8262 ../src/guestfs-actions.pod:8278 ../src/guestfs-actions.pod:8302 ../src/guestfs-actions.pod:9243 ../src/guestfs-actions.pod:9258 ../src/guestfs-actions.pod:9709 msgid "(Added in 1.0.26)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2809 +#: ../src/guestfs-actions.pod:2684 msgid "guestfs_get_attach_method" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2811 +#: ../src/guestfs-actions.pod:2686 #, no-wrap msgid "" " char *\n" @@ -32383,22 +31996,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2814 +#: ../src/guestfs-actions.pod:2689 msgid "Return the current attach method. See C<guestfs_set_attach_method>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2819 ../src/guestfs-actions.pod:7971 +#: ../src/guestfs-actions.pod:2694 ../src/guestfs-actions.pod:7715 msgid "(Added in 1.9.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2821 +#: ../src/guestfs-actions.pod:2696 msgid "guestfs_get_autosync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2823 +#: ../src/guestfs-actions.pod:2698 #, no-wrap msgid "" " int\n" @@ -32407,12 +32020,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2832 +#: ../src/guestfs-actions.pod:2707 msgid "guestfs_get_direct" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2834 +#: ../src/guestfs-actions.pod:2709 #, no-wrap msgid "" " int\n" @@ -32421,17 +32034,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2841 ../src/guestfs-actions.pod:8012 +#: ../src/guestfs-actions.pod:2716 ../src/guestfs-actions.pod:7756 msgid "(Added in 1.0.72)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2843 +#: ../src/guestfs-actions.pod:2718 msgid "guestfs_get_e2attrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2845 +#: ../src/guestfs-actions.pod:2720 #, no-wrap msgid "" " char *\n" @@ -32441,29 +32054,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2952 +#: ../src/guestfs-actions.pod:2827 msgid "See also C<guestfs_set_e2attrs>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2954 +#: ../src/guestfs-actions.pod:2829 msgid "" "Don't confuse these attributes with extended attributes (see " "C<guestfs_getxattr>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2960 ../src/guestfs-actions.pod:2980 ../src/guestfs-actions.pod:8051 ../src/guestfs-actions.pod:8090 +#: ../src/guestfs-actions.pod:2835 ../src/guestfs-actions.pod:2855 ../src/guestfs-actions.pod:7795 ../src/guestfs-actions.pod:7834 msgid "(Added in 1.17.31)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2962 +#: ../src/guestfs-actions.pod:2837 msgid "guestfs_get_e2generation" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2964 +#: ../src/guestfs-actions.pod:2839 #, no-wrap msgid "" " int64_t\n" @@ -32473,17 +32086,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2976 +#: ../src/guestfs-actions.pod:2851 msgid "See C<guestfs_set_e2generation>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2982 +#: ../src/guestfs-actions.pod:2857 msgid "guestfs_get_e2label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2984 +#: ../src/guestfs-actions.pod:2859 #, no-wrap msgid "" " char *\n" @@ -32493,24 +32106,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2988 +#: ../src/guestfs-actions.pod:2863 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_vfs_label> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3001 ../src/guestfs-actions.pod:3022 ../src/guestfs-actions.pod:8115 ../src/guestfs-actions.pod:8134 +#: ../src/guestfs-actions.pod:2876 ../src/guestfs-actions.pod:2897 ../src/guestfs-actions.pod:7859 ../src/guestfs-actions.pod:7878 msgid "(Added in 1.0.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3003 +#: ../src/guestfs-actions.pod:2878 msgid "guestfs_get_e2uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3005 +#: ../src/guestfs-actions.pod:2880 #, no-wrap msgid "" " char *\n" @@ -32520,19 +32133,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3009 +#: ../src/guestfs-actions.pod:2884 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_vfs_uuid> " "call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3024 +#: ../src/guestfs-actions.pod:2899 msgid "guestfs_get_memsize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3026 +#: ../src/guestfs-actions.pod:2901 #, no-wrap msgid "" " int\n" @@ -32541,7 +32154,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3032 +#: ../src/guestfs-actions.pod:2907 msgid "" "If C<guestfs_set_memsize> was not called on this handle, and if " "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default " @@ -32549,17 +32162,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3041 ../src/guestfs-actions.pod:6034 ../src/guestfs-actions.pod:6297 ../src/guestfs-actions.pod:6316 ../src/guestfs-actions.pod:6335 ../src/guestfs-actions.pod:6347 ../src/guestfs-actions.pod:6364 ../src/guestfs-actions.pod:6377 ../src/guestfs-actions.pod:7654 ../src/guestfs-actions.pod:8177 ../src/guestfs-actions.pod:8469 ../src/guestfs-actions.pod:9226 +#: ../src/guestfs-actions.pod:2916 ../src/guestfs-actions.pod:5812 ../src/guestfs-actions.pod:6076 ../src/guestfs-actions.pod:6095 ../src/guestfs-actions.pod:6114 ../src/guestfs-actions.pod:6126 ../src/guestfs-actions.pod:6143 ../src/guestfs-actions.pod:6156 ../src/guestfs-actions.pod:7431 ../src/guestfs-actions.pod:7921 ../src/guestfs-actions.pod:8213 ../src/guestfs-actions.pod:8970 msgid "(Added in 1.0.55)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3043 +#: ../src/guestfs-actions.pod:2918 msgid "guestfs_get_network" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3045 +#: ../src/guestfs-actions.pod:2920 #, no-wrap msgid "" " int\n" @@ -32568,17 +32181,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3052 ../src/guestfs-actions.pod:8196 +#: ../src/guestfs-actions.pod:2927 ../src/guestfs-actions.pod:7940 msgid "(Added in 1.5.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3054 +#: ../src/guestfs-actions.pod:2929 msgid "guestfs_get_path" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3056 +#: ../src/guestfs-actions.pod:2931 #, no-wrap msgid "" " const char *\n" @@ -32587,19 +32200,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3064 ../src/guestfs-actions.pod:3104 +#: ../src/guestfs-actions.pod:2939 ../src/guestfs-actions.pod:2979 msgid "" "This function returns a string, or NULL on error. The string is owned by " "the guest handle and must I<not> be freed." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3069 +#: ../src/guestfs-actions.pod:2944 msgid "guestfs_get_pgroup" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3071 +#: ../src/guestfs-actions.pod:2946 #, no-wrap msgid "" " int\n" @@ -32608,17 +32221,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3078 ../src/guestfs-actions.pod:8234 ../src/guestfs-actions.pod:9872 +#: ../src/guestfs-actions.pod:2953 ../src/guestfs-actions.pod:7978 ../src/guestfs-actions.pod:9542 msgid "(Added in 1.11.18)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3080 +#: ../src/guestfs-actions.pod:2955 msgid "guestfs_get_pid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3082 +#: ../src/guestfs-actions.pod:2957 #, no-wrap msgid "" " int\n" @@ -32627,17 +32240,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3092 +#: ../src/guestfs-actions.pod:2967 msgid "(Added in 1.0.56)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3094 +#: ../src/guestfs-actions.pod:2969 msgid "guestfs_get_qemu" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3096 +#: ../src/guestfs-actions.pod:2971 #, no-wrap msgid "" " const char *\n" @@ -32646,17 +32259,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3107 ../src/guestfs-actions.pod:8262 +#: ../src/guestfs-actions.pod:2982 ../src/guestfs-actions.pod:8006 msgid "(Added in 1.0.6)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3109 +#: ../src/guestfs-actions.pod:2984 msgid "guestfs_get_recovery_proc" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3111 +#: ../src/guestfs-actions.pod:2986 #, no-wrap msgid "" " int\n" @@ -32665,17 +32278,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3118 ../src/guestfs-actions.pod:4839 ../src/guestfs-actions.pod:5199 ../src/guestfs-actions.pod:5610 ../src/guestfs-actions.pod:5873 ../src/guestfs-actions.pod:7340 ../src/guestfs-actions.pod:7702 ../src/guestfs-actions.pod:8286 ../src/guestfs-actions.pod:9007 ../src/guestfs-actions.pod:9027 ../src/guestfs-actions.pod:9425 +#: ../src/guestfs-actions.pod:2993 ../src/guestfs-actions.pod:4635 ../src/guestfs-actions.pod:4995 ../src/guestfs-actions.pod:5406 ../src/guestfs-actions.pod:5651 ../src/guestfs-actions.pod:7136 ../src/guestfs-actions.pod:7479 ../src/guestfs-actions.pod:8030 ../src/guestfs-actions.pod:8751 ../src/guestfs-actions.pod:8771 ../src/guestfs-actions.pod:9127 msgid "(Added in 1.0.77)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3120 +#: ../src/guestfs-actions.pod:2995 msgid "guestfs_get_selinux" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3122 +#: ../src/guestfs-actions.pod:2997 #, no-wrap msgid "" " int\n" @@ -32684,24 +32297,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3125 +#: ../src/guestfs-actions.pod:3000 msgid "" "This returns the current setting of the selinux flag which is passed to the " "appliance at boot time. See C<guestfs_set_selinux>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3133 ../src/guestfs-actions.pod:3207 ../src/guestfs-actions.pod:8305 ../src/guestfs-actions.pod:8379 +#: ../src/guestfs-actions.pod:3008 ../src/guestfs-actions.pod:3082 ../src/guestfs-actions.pod:8049 ../src/guestfs-actions.pod:8123 msgid "(Added in 1.0.67)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3135 +#: ../src/guestfs-actions.pod:3010 msgid "guestfs_get_smp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3137 +#: ../src/guestfs-actions.pod:3012 #, no-wrap msgid "" " int\n" @@ -32710,12 +32323,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3146 +#: ../src/guestfs-actions.pod:3021 msgid "guestfs_get_state" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3148 +#: ../src/guestfs-actions.pod:3023 #, no-wrap msgid "" " int\n" @@ -32724,12 +32337,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3160 +#: ../src/guestfs-actions.pod:3035 msgid "guestfs_get_trace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3162 +#: ../src/guestfs-actions.pod:3037 #, no-wrap msgid "" " int\n" @@ -32738,12 +32351,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3171 +#: ../src/guestfs-actions.pod:3046 msgid "guestfs_get_umask" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3173 +#: ../src/guestfs-actions.pod:3048 #, no-wrap msgid "" " int\n" @@ -32752,19 +32365,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3176 +#: ../src/guestfs-actions.pod:3051 msgid "" "Return the current umask. By default the umask is C<022> unless it has been " "set by calling C<guestfs_umask>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3183 +#: ../src/guestfs-actions.pod:3058 msgid "guestfs_get_verbose" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3185 +#: ../src/guestfs-actions.pod:3060 #, no-wrap msgid "" " int\n" @@ -32773,12 +32386,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3194 +#: ../src/guestfs-actions.pod:3069 msgid "guestfs_getcon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3196 +#: ../src/guestfs-actions.pod:3071 #, no-wrap msgid "" " char *\n" @@ -32787,17 +32400,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3201 +#: ../src/guestfs-actions.pod:3076 msgid "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3209 +#: ../src/guestfs-actions.pod:3084 msgid "guestfs_getxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3211 +#: ../src/guestfs-actions.pod:3086 #, no-wrap msgid "" " char *\n" @@ -32809,7 +32422,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3217 +#: ../src/guestfs-actions.pod:3092 msgid "" "Get a single extended attribute from file C<path> named C<name>. This call " "follows symlinks. If you want to lookup an extended attribute for the " @@ -32817,7 +32430,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3221 ../src/guestfs-actions.pod:4853 +#: ../src/guestfs-actions.pod:3096 ../src/guestfs-actions.pod:4649 msgid "" "Normally it is better to get all extended attributes from a file in one go " "by calling C<guestfs_getxattrs>. However some Linux filesystem " @@ -32827,12 +32440,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3231 +#: ../src/guestfs-actions.pod:3106 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3233 ../src/guestfs-actions.pod:3529 ../src/guestfs-actions.pod:4021 ../src/guestfs-actions.pod:4865 ../src/guestfs-actions.pod:7333 ../src/guestfs-actions.pod:7359 ../src/guestfs-actions.pod:7559 ../src/guestfs-actions.pod:9637 +#: ../src/guestfs-actions.pod:3108 ../src/guestfs-actions.pod:3325 ../src/guestfs-actions.pod:3817 ../src/guestfs-actions.pod:4661 ../src/guestfs-actions.pod:7129 ../src/guestfs-actions.pod:7155 ../src/guestfs-actions.pod:7336 ../src/guestfs-actions.pod:9307 msgid "" "This function returns a buffer, or NULL on error. The size of the returned " "buffer is written to C<*size_r>. I<The caller must free the returned buffer " @@ -32840,17 +32453,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3237 ../src/guestfs-actions.pod:4869 +#: ../src/guestfs-actions.pod:3112 ../src/guestfs-actions.pod:4665 msgid "(Added in 1.7.24)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3239 +#: ../src/guestfs-actions.pod:3114 msgid "guestfs_getxattrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3241 +#: ../src/guestfs-actions.pod:3116 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -32860,29 +32473,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3251 +#: ../src/guestfs-actions.pod:3126 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3253 ../src/guestfs-actions.pod:4881 ../src/guestfs-actions.pod:5606 +#: ../src/guestfs-actions.pod:3128 ../src/guestfs-actions.pod:4677 ../src/guestfs-actions.pod:5402 msgid "" "This function returns a C<struct guestfs_xattr_list *>, or NULL if there was " "an error. I<The caller must call C<guestfs_free_xattr_list> after use>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3257 ../src/guestfs-actions.pod:4885 ../src/guestfs-actions.pod:5113 ../src/guestfs-actions.pod:5149 ../src/guestfs-actions.pod:7732 ../src/guestfs-actions.pod:8398 ../src/guestfs-actions.pod:10202 +#: ../src/guestfs-actions.pod:3132 ../src/guestfs-actions.pod:4681 ../src/guestfs-actions.pod:4909 ../src/guestfs-actions.pod:4945 ../src/guestfs-actions.pod:7509 ../src/guestfs-actions.pod:8142 ../src/guestfs-actions.pod:9774 msgid "(Added in 1.0.59)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3259 +#: ../src/guestfs-actions.pod:3134 msgid "guestfs_glob_expand" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3261 +#: ../src/guestfs-actions.pod:3136 #, no-wrap msgid "" " char **\n" @@ -32892,7 +32505,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3276 +#: ../src/guestfs-actions.pod:3151 msgid "" "Notice that there is no equivalent command for expanding a device name " "(eg. C</dev/sd*>). Use C<guestfs_list_devices>, C<guestfs_list_partitions> " @@ -32900,17 +32513,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3284 ../src/guestfs-actions.pod:8582 ../src/guestfs-actions.pod:8599 +#: ../src/guestfs-actions.pod:3159 ../src/guestfs-actions.pod:8326 ../src/guestfs-actions.pod:8343 msgid "(Added in 1.0.50)" msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:3286 -msgid "= head2 guestfs_grep" +#. type: =head2 +#: ../src/guestfs-actions.pod:3161 +msgid "guestfs_grep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3288 +#: ../src/guestfs-actions.pod:3163 #, no-wrap msgid "" " char **\n" @@ -32920,93 +32533,13 @@ msgid "" "\n" msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:3293 -msgid "" -"This function is provided for backwards compatibility with earlier versions " -"of libguestfs. It simply calls L</guestfs_grep_opts> with no optional " -"arguments." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:3300 -msgid "guestfs_grep_opts" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:3302 -#, no-wrap -msgid "" -" char **\n" -" guestfs_grep_opts (guestfs_h *g,\n" -" const char *regex,\n" -" const char *path,\n" -" ...);\n" -"\n" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:3313 -#, no-wrap -msgid "" -" GUESTFS_GREP_OPTS_EXTENDED, int extended,\n" -" GUESTFS_GREP_OPTS_FIXED, int fixed,\n" -" GUESTFS_GREP_OPTS_INSENSITIVE, int insensitive,\n" -" GUESTFS_GREP_OPTS_COMPRESSED, int compressed,\n" -"\n" -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:3353 -msgid "guestfs_grep_opts_va" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:3355 -#, no-wrap -msgid "" -" char **\n" -" guestfs_grep_opts_va (guestfs_h *g,\n" -" const char *regex,\n" -" const char *path,\n" -" va_list args);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:3361 -msgid "This is the \"va_list variant\" of L</guestfs_grep_opts>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:3365 -msgid "guestfs_grep_opts_argv" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:3367 -#, no-wrap -msgid "" -" char **\n" -" guestfs_grep_opts_argv (guestfs_h *g,\n" -" const char *regex,\n" -" const char *path,\n" -" const struct guestfs_grep_opts_argv *optargs);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:3373 -msgid "This is the \"argv variant\" of L</guestfs_grep_opts>." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:3377 +#: ../src/guestfs-actions.pod:3180 msgid "guestfs_grepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3379 +#: ../src/guestfs-actions.pod:3182 #, no-wrap msgid "" " char **\n" @@ -33017,12 +32550,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3403 +#: ../src/guestfs-actions.pod:3199 msgid "guestfs_grub_install" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3405 +#: ../src/guestfs-actions.pod:3201 #, no-wrap msgid "" " int\n" @@ -33033,17 +32566,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3448 +#: ../src/guestfs-actions.pod:3244 msgid "(Added in 1.0.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3450 +#: ../src/guestfs-actions.pod:3246 msgid "guestfs_head" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3452 +#: ../src/guestfs-actions.pod:3248 #, no-wrap msgid "" " char **\n" @@ -33053,12 +32586,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3468 +#: ../src/guestfs-actions.pod:3264 msgid "guestfs_head_n" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3470 +#: ../src/guestfs-actions.pod:3266 #, no-wrap msgid "" " char **\n" @@ -33069,12 +32602,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3492 +#: ../src/guestfs-actions.pod:3288 msgid "guestfs_hexdump" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3494 +#: ../src/guestfs-actions.pod:3290 #, no-wrap msgid "" " char *\n" @@ -33084,17 +32617,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3507 ../src/guestfs-actions.pod:8686 ../src/guestfs-actions.pod:8741 +#: ../src/guestfs-actions.pod:3303 ../src/guestfs-actions.pod:8430 ../src/guestfs-actions.pod:8485 msgid "(Added in 1.0.22)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3509 +#: ../src/guestfs-actions.pod:3305 msgid "guestfs_initrd_cat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3511 +#: ../src/guestfs-actions.pod:3307 #, no-wrap msgid "" " char *\n" @@ -33106,17 +32639,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3527 +#: ../src/guestfs-actions.pod:3323 msgid "See also C<guestfs_initrd_list>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3538 +#: ../src/guestfs-actions.pod:3334 msgid "guestfs_initrd_list" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3540 +#: ../src/guestfs-actions.pod:3336 #, no-wrap msgid "" " char **\n" @@ -33126,12 +32659,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3560 +#: ../src/guestfs-actions.pod:3356 msgid "guestfs_inotify_add_watch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3562 +#: ../src/guestfs-actions.pod:3358 #, no-wrap msgid "" " int64_t\n" @@ -33142,12 +32675,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3581 +#: ../src/guestfs-actions.pod:3377 msgid "guestfs_inotify_close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3583 +#: ../src/guestfs-actions.pod:3379 #, no-wrap msgid "" " int\n" @@ -33156,12 +32689,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3594 +#: ../src/guestfs-actions.pod:3390 msgid "guestfs_inotify_files" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3596 +#: ../src/guestfs-actions.pod:3392 #, no-wrap msgid "" " char **\n" @@ -33170,7 +32703,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3599 +#: ../src/guestfs-actions.pod:3395 msgid "" "This function is a helpful wrapper around C<guestfs_inotify_read> which just " "returns a list of pathnames of objects that were touched. The returned " @@ -33178,12 +32711,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3609 +#: ../src/guestfs-actions.pod:3405 msgid "guestfs_inotify_init" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3611 +#: ../src/guestfs-actions.pod:3407 #, no-wrap msgid "" " int\n" @@ -33193,7 +32726,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3619 +#: ../src/guestfs-actions.pod:3415 msgid "" "C<maxevents> is the maximum number of events which will be queued up between " "calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>. If this is " @@ -33205,7 +32738,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3629 +#: ../src/guestfs-actions.pod:3425 msgid "" "Before any events are generated, you have to add some watches to the " "internal watch list. See: C<guestfs_inotify_add_watch> and " @@ -33213,7 +32746,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3633 +#: ../src/guestfs-actions.pod:3429 msgid "" "Queued up events should be read periodically by calling " "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful " @@ -33222,19 +32755,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3640 +#: ../src/guestfs-actions.pod:3436 msgid "" "The handle should be closed after use by calling C<guestfs_inotify_close>. " "This also removes any watches automatically." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3653 +#: ../src/guestfs-actions.pod:3449 msgid "guestfs_inotify_read" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3655 +#: ../src/guestfs-actions.pod:3451 #, no-wrap msgid "" " struct guestfs_inotify_event_list *\n" @@ -33243,7 +32776,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3669 +#: ../src/guestfs-actions.pod:3465 msgid "" "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if " "there was an error. I<The caller must call " @@ -33251,12 +32784,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3675 +#: ../src/guestfs-actions.pod:3471 msgid "guestfs_inotify_rm_watch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3677 +#: ../src/guestfs-actions.pod:3473 #, no-wrap msgid "" " int\n" @@ -33266,19 +32799,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3681 +#: ../src/guestfs-actions.pod:3477 msgid "" "Remove a previously defined inotify watch. See " "C<guestfs_inotify_add_watch>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3688 +#: ../src/guestfs-actions.pod:3484 msgid "guestfs_inspect_get_arch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3690 +#: ../src/guestfs-actions.pod:3486 #, no-wrap msgid "" " char *\n" @@ -33288,19 +32821,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3694 +#: ../src/guestfs-actions.pod:3490 msgid "" "This returns the architecture of the inspected operating system. The " "possible return values are listed under C<guestfs_file_architecture>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3708 +#: ../src/guestfs-actions.pod:3504 msgid "guestfs_inspect_get_distro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3710 +#: ../src/guestfs-actions.pod:3506 #, no-wrap msgid "" " char *\n" @@ -33310,12 +32843,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3822 +#: ../src/guestfs-actions.pod:3618 msgid "guestfs_inspect_get_drive_mappings" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3824 +#: ../src/guestfs-actions.pod:3620 #, no-wrap msgid "" " char **\n" @@ -33325,24 +32858,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3853 +#: ../src/guestfs-actions.pod:3649 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_mountpoints>, C<guestfs_inspect_get_filesystems>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3863 ../src/guestfs-actions.pod:4332 +#: ../src/guestfs-actions.pod:3659 ../src/guestfs-actions.pod:4128 msgid "(Added in 1.9.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3865 +#: ../src/guestfs-actions.pod:3661 msgid "guestfs_inspect_get_filesystems" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3867 +#: ../src/guestfs-actions.pod:3663 #, no-wrap msgid "" " char **\n" @@ -33352,19 +32885,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3879 +#: ../src/guestfs-actions.pod:3675 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_mountpoints>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3888 +#: ../src/guestfs-actions.pod:3684 msgid "guestfs_inspect_get_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3890 +#: ../src/guestfs-actions.pod:3686 #, no-wrap msgid "" " char *\n" @@ -33374,17 +32907,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3924 ../src/guestfs-actions.pod:4368 ../src/guestfs-actions.pod:4384 ../src/guestfs-actions.pod:4402 ../src/guestfs-actions.pod:7768 +#: ../src/guestfs-actions.pod:3720 ../src/guestfs-actions.pod:4164 ../src/guestfs-actions.pod:4180 ../src/guestfs-actions.pod:4198 ../src/guestfs-actions.pod:7545 msgid "(Added in 1.9.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3926 +#: ../src/guestfs-actions.pod:3722 msgid "guestfs_inspect_get_hostname" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3928 +#: ../src/guestfs-actions.pod:3724 #, no-wrap msgid "" " char *\n" @@ -33394,17 +32927,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3943 +#: ../src/guestfs-actions.pod:3739 msgid "(Added in 1.7.9)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3945 +#: ../src/guestfs-actions.pod:3741 msgid "guestfs_inspect_get_icon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3947 +#: ../src/guestfs-actions.pod:3743 #, no-wrap msgid "" " char *\n" @@ -33416,7 +32949,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3958 +#: ../src/guestfs-actions.pod:3754 #, no-wrap msgid "" " GUESTFS_INSPECT_GET_ICON_FAVICON, int favicon,\n" @@ -33425,17 +32958,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4025 ../src/guestfs-actions.pod:4899 ../src/guestfs-actions.pod:6465 +#: ../src/guestfs-actions.pod:3821 ../src/guestfs-actions.pod:4695 ../src/guestfs-actions.pod:6244 msgid "(Added in 1.11.12)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4027 +#: ../src/guestfs-actions.pod:3823 msgid "guestfs_inspect_get_icon_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4029 +#: ../src/guestfs-actions.pod:3825 #, no-wrap msgid "" " char *\n" @@ -33447,17 +32980,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4035 +#: ../src/guestfs-actions.pod:3831 msgid "This is the \"va_list variant\" of L</guestfs_inspect_get_icon>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4039 +#: ../src/guestfs-actions.pod:3835 msgid "guestfs_inspect_get_icon_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4041 +#: ../src/guestfs-actions.pod:3837 #, no-wrap msgid "" " char *\n" @@ -33470,17 +33003,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4047 +#: ../src/guestfs-actions.pod:3843 msgid "This is the \"argv variant\" of L</guestfs_inspect_get_icon>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4051 +#: ../src/guestfs-actions.pod:3847 msgid "guestfs_inspect_get_major_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4053 +#: ../src/guestfs-actions.pod:3849 #, no-wrap msgid "" " int\n" @@ -33490,12 +33023,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4075 +#: ../src/guestfs-actions.pod:3871 msgid "guestfs_inspect_get_minor_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4077 +#: ../src/guestfs-actions.pod:3873 #, no-wrap msgid "" " int\n" @@ -33505,19 +33038,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4086 +#: ../src/guestfs-actions.pod:3882 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_major_version>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4093 +#: ../src/guestfs-actions.pod:3889 msgid "guestfs_inspect_get_mountpoints" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4095 +#: ../src/guestfs-actions.pod:3891 #, no-wrap msgid "" " char **\n" @@ -33527,7 +33060,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4116 +#: ../src/guestfs-actions.pod:3912 msgid "" "For operating systems like Windows which still use drive letters, this call " "will only return an entry for the first drive \"mounted on\" C</>. For " @@ -33536,19 +33069,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4122 +#: ../src/guestfs-actions.pod:3918 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4133 +#: ../src/guestfs-actions.pod:3929 msgid "guestfs_inspect_get_package_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4135 +#: ../src/guestfs-actions.pod:3931 #, no-wrap msgid "" " char *\n" @@ -33558,7 +33091,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4139 +#: ../src/guestfs-actions.pod:3935 msgid "" "This function and C<guestfs_inspect_get_package_management> return the " "package format and package management tool used by the inspected operating " @@ -33567,17 +33100,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4158 ../src/guestfs-actions.pod:4186 +#: ../src/guestfs-actions.pod:3954 ../src/guestfs-actions.pod:3982 msgid "(Added in 1.7.5)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4160 +#: ../src/guestfs-actions.pod:3956 msgid "guestfs_inspect_get_package_management" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4162 +#: ../src/guestfs-actions.pod:3958 #, no-wrap msgid "" " char *\n" @@ -33587,7 +33120,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4166 +#: ../src/guestfs-actions.pod:3962 msgid "" "C<guestfs_inspect_get_package_format> and this function return the package " "format and package management tool used by the inspected operating system. " @@ -33596,12 +33129,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4188 +#: ../src/guestfs-actions.pod:3984 msgid "guestfs_inspect_get_product_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4190 +#: ../src/guestfs-actions.pod:3986 #, no-wrap msgid "" " char *\n" @@ -33611,12 +33144,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4209 +#: ../src/guestfs-actions.pod:4005 msgid "guestfs_inspect_get_product_variant" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4211 +#: ../src/guestfs-actions.pod:4007 #, no-wrap msgid "" " char *\n" @@ -33626,24 +33159,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4234 +#: ../src/guestfs-actions.pod:4030 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_product_name>, C<guestfs_inspect_get_major_version>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4241 +#: ../src/guestfs-actions.pod:4037 msgid "(Added in 1.9.13)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4243 +#: ../src/guestfs-actions.pod:4039 msgid "guestfs_inspect_get_roots" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4245 +#: ../src/guestfs-actions.pod:4041 #, no-wrap msgid "" " char **\n" @@ -33652,7 +33185,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4248 +#: ../src/guestfs-actions.pod:4044 msgid "" "This function is a convenient way to get the list of root devices, as " "returned from a previous call to C<guestfs_inspect_os>, but without redoing " @@ -33660,24 +33193,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4252 +#: ../src/guestfs-actions.pod:4048 msgid "" "This returns an empty list if either no root devices were found or the " "caller has not called C<guestfs_inspect_os>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4261 +#: ../src/guestfs-actions.pod:4057 msgid "(Added in 1.7.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4263 +#: ../src/guestfs-actions.pod:4059 msgid "guestfs_inspect_get_type" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4265 +#: ../src/guestfs-actions.pod:4061 #, no-wrap msgid "" " char *\n" @@ -33687,12 +33220,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4314 +#: ../src/guestfs-actions.pod:4110 msgid "guestfs_inspect_get_windows_current_control_set" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4316 +#: ../src/guestfs-actions.pod:4112 #, no-wrap msgid "" " char *\n" @@ -33702,12 +33235,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4334 +#: ../src/guestfs-actions.pod:4130 msgid "guestfs_inspect_get_windows_systemroot" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4336 +#: ../src/guestfs-actions.pod:4132 #, no-wrap msgid "" " char *\n" @@ -33717,17 +33250,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4352 +#: ../src/guestfs-actions.pod:4148 msgid "(Added in 1.5.25)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4354 +#: ../src/guestfs-actions.pod:4150 msgid "guestfs_inspect_is_live" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4356 +#: ../src/guestfs-actions.pod:4152 #, no-wrap msgid "" " int\n" @@ -33737,19 +33270,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4360 +#: ../src/guestfs-actions.pod:4156 msgid "" "If C<guestfs_inspect_get_format> returns C<installer> (this is an install " "disk), then this returns true if a live image was detected on the disk." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4370 +#: ../src/guestfs-actions.pod:4166 msgid "guestfs_inspect_is_multipart" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4372 +#: ../src/guestfs-actions.pod:4168 #, no-wrap msgid "" " int\n" @@ -33759,19 +33292,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4376 +#: ../src/guestfs-actions.pod:4172 msgid "" "If C<guestfs_inspect_get_format> returns C<installer> (this is an install " "disk), then this returns true if the disk is part of a set." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4386 +#: ../src/guestfs-actions.pod:4182 msgid "guestfs_inspect_is_netinst" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4388 +#: ../src/guestfs-actions.pod:4184 #, no-wrap msgid "" " int\n" @@ -33781,7 +33314,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4392 +#: ../src/guestfs-actions.pod:4188 msgid "" "If C<guestfs_inspect_get_format> returns C<installer> (this is an install " "disk), then this returns true if the disk is a network installer, ie. not a " @@ -33790,12 +33323,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4404 +#: ../src/guestfs-actions.pod:4200 msgid "guestfs_inspect_list_applications" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4406 +#: ../src/guestfs-actions.pod:4202 #, no-wrap msgid "" " struct guestfs_application_list *\n" @@ -33805,7 +33338,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4412 +#: ../src/guestfs-actions.pod:4208 msgid "" "I<Note:> This call works differently from other parts of the inspection " "API. You have to call C<guestfs_inspect_os>, then " @@ -33818,7 +33351,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4502 +#: ../src/guestfs-actions.pod:4298 msgid "" "This function returns a C<struct guestfs_application_list *>, or NULL if " "there was an error. I<The caller must call C<guestfs_free_application_list> " @@ -33826,17 +33359,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4506 +#: ../src/guestfs-actions.pod:4302 msgid "(Added in 1.7.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4508 +#: ../src/guestfs-actions.pod:4304 msgid "guestfs_inspect_os" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4510 +#: ../src/guestfs-actions.pod:4306 #, no-wrap msgid "" " char **\n" @@ -33845,7 +33378,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4526 +#: ../src/guestfs-actions.pod:4322 msgid "" "You can pass the root string(s) returned to other C<guestfs_inspect_get_*> " "functions in order to query further information about each operating system, " @@ -33853,7 +33386,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4531 +#: ../src/guestfs-actions.pod:4327 msgid "" "This function uses other libguestfs features such as C<guestfs_mount_ro> and " "C<guestfs_umount_all> in order to mount and unmount filesystems and look at " @@ -33862,17 +33395,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4543 ../src/guestfs-actions.pod:4910 ../src/guestfs-actions.pod:5005 +#: ../src/guestfs-actions.pod:4339 ../src/guestfs-actions.pod:4706 ../src/guestfs-actions.pod:4801 msgid "See also C<guestfs_list_filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4551 +#: ../src/guestfs-actions.pod:4347 msgid "guestfs_is_blockdev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4553 +#: ../src/guestfs-actions.pod:4349 #, no-wrap msgid "" " int\n" @@ -33882,22 +33415,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4560 ../src/guestfs-actions.pod:4575 ../src/guestfs-actions.pod:4605 ../src/guestfs-actions.pod:4620 ../src/guestfs-actions.pod:4636 ../src/guestfs-actions.pod:4692 ../src/guestfs-actions.pod:4707 +#: ../src/guestfs-actions.pod:4356 ../src/guestfs-actions.pod:4371 ../src/guestfs-actions.pod:4401 ../src/guestfs-actions.pod:4416 ../src/guestfs-actions.pod:4432 ../src/guestfs-actions.pod:4488 ../src/guestfs-actions.pod:4503 msgid "See also C<guestfs_stat>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4564 ../src/guestfs-actions.pod:4579 ../src/guestfs-actions.pod:4624 ../src/guestfs-actions.pod:4696 ../src/guestfs-actions.pod:4711 +#: ../src/guestfs-actions.pod:4360 ../src/guestfs-actions.pod:4375 ../src/guestfs-actions.pod:4420 ../src/guestfs-actions.pod:4492 ../src/guestfs-actions.pod:4507 msgid "(Added in 1.5.10)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4566 +#: ../src/guestfs-actions.pod:4362 msgid "guestfs_is_chardev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4568 +#: ../src/guestfs-actions.pod:4364 #, no-wrap msgid "" " int\n" @@ -33907,12 +33440,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4581 +#: ../src/guestfs-actions.pod:4377 msgid "guestfs_is_config" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4583 +#: ../src/guestfs-actions.pod:4379 #, no-wrap msgid "" " int\n" @@ -33921,12 +33454,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4595 +#: ../src/guestfs-actions.pod:4391 msgid "guestfs_is_dir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4597 +#: ../src/guestfs-actions.pod:4393 #, no-wrap msgid "" " int\n" @@ -33936,12 +33469,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4611 +#: ../src/guestfs-actions.pod:4407 msgid "guestfs_is_fifo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4613 +#: ../src/guestfs-actions.pod:4409 #, no-wrap msgid "" " int\n" @@ -33951,12 +33484,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4626 +#: ../src/guestfs-actions.pod:4422 msgid "guestfs_is_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4628 +#: ../src/guestfs-actions.pod:4424 #, no-wrap msgid "" " int\n" @@ -33966,12 +33499,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4642 +#: ../src/guestfs-actions.pod:4438 msgid "guestfs_is_launching" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4644 +#: ../src/guestfs-actions.pod:4440 #, no-wrap msgid "" " int\n" @@ -33980,12 +33513,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4656 +#: ../src/guestfs-actions.pod:4452 msgid "guestfs_is_lv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4658 +#: ../src/guestfs-actions.pod:4454 #, no-wrap msgid "" " int\n" @@ -33995,12 +33528,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4669 +#: ../src/guestfs-actions.pod:4465 msgid "guestfs_is_ready" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4671 +#: ../src/guestfs-actions.pod:4467 #, no-wrap msgid "" " int\n" @@ -34009,12 +33542,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4683 +#: ../src/guestfs-actions.pod:4479 msgid "guestfs_is_socket" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4685 +#: ../src/guestfs-actions.pod:4481 #, no-wrap msgid "" " int\n" @@ -34024,12 +33557,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4698 +#: ../src/guestfs-actions.pod:4494 msgid "guestfs_is_symlink" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4700 +#: ../src/guestfs-actions.pod:4496 #, no-wrap msgid "" " int\n" @@ -34039,12 +33572,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4713 +#: ../src/guestfs-actions.pod:4509 msgid "guestfs_is_zero" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4715 +#: ../src/guestfs-actions.pod:4511 #, no-wrap msgid "" " int\n" @@ -34054,17 +33587,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4724 ../src/guestfs-actions.pod:4738 +#: ../src/guestfs-actions.pod:4520 ../src/guestfs-actions.pod:4534 msgid "(Added in 1.11.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4726 +#: ../src/guestfs-actions.pod:4522 msgid "guestfs_is_zero_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4728 +#: ../src/guestfs-actions.pod:4524 #, no-wrap msgid "" " int\n" @@ -34074,12 +33607,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4740 ../src/guestfs-structs.pod:268 +#: ../src/guestfs-actions.pod:4536 ../src/guestfs-structs.pod:268 msgid "guestfs_isoinfo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4742 +#: ../src/guestfs-actions.pod:4538 #, no-wrap msgid "" " struct guestfs_isoinfo *\n" @@ -34089,7 +33622,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4746 +#: ../src/guestfs-actions.pod:4542 msgid "" "This is the same as C<guestfs_isoinfo_device> except that it works for an " "ISO file located inside some other mounted filesystem. Note that in the " @@ -34098,24 +33631,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4752 ../src/guestfs-actions.pod:4775 +#: ../src/guestfs-actions.pod:4548 ../src/guestfs-actions.pod:4571 msgid "" "This function returns a C<struct guestfs_isoinfo *>, or NULL if there was an " "error. I<The caller must call C<guestfs_free_isoinfo> after use>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4756 ../src/guestfs-actions.pod:4779 +#: ../src/guestfs-actions.pod:4552 ../src/guestfs-actions.pod:4575 msgid "(Added in 1.17.19)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4758 +#: ../src/guestfs-actions.pod:4554 msgid "guestfs_isoinfo_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4760 +#: ../src/guestfs-actions.pod:4556 #, no-wrap msgid "" " struct guestfs_isoinfo *\n" @@ -34125,12 +33658,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4781 +#: ../src/guestfs-actions.pod:4577 msgid "guestfs_kill_subprocess" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4783 +#: ../src/guestfs-actions.pod:4579 #, no-wrap msgid "" " int\n" @@ -34139,24 +33672,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4786 +#: ../src/guestfs-actions.pod:4582 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_shutdown> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4795 +#: ../src/guestfs-actions.pod:4591 msgid "Do not call this. See: C<guestfs_shutdown> instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4801 +#: ../src/guestfs-actions.pod:4597 msgid "guestfs_launch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4803 +#: ../src/guestfs-actions.pod:4599 #, no-wrap msgid "" " int\n" @@ -34165,12 +33698,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4821 +#: ../src/guestfs-actions.pod:4617 msgid "guestfs_lchown" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4823 +#: ../src/guestfs-actions.pod:4619 #, no-wrap msgid "" " int\n" @@ -34182,7 +33715,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4829 +#: ../src/guestfs-actions.pod:4625 msgid "" "Change the file owner to C<owner> and group to C<group>. This is like " "C<guestfs_chown> but if C<path> is a symlink then the link itself is " @@ -34190,12 +33723,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4841 +#: ../src/guestfs-actions.pod:4637 msgid "guestfs_lgetxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4843 +#: ../src/guestfs-actions.pod:4639 #, no-wrap msgid "" " char *\n" @@ -34207,17 +33740,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4863 +#: ../src/guestfs-actions.pod:4659 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4871 +#: ../src/guestfs-actions.pod:4667 msgid "guestfs_lgetxattrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4873 +#: ../src/guestfs-actions.pod:4669 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -34227,19 +33760,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4877 +#: ../src/guestfs-actions.pod:4673 msgid "" "This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, " "then it returns the extended attributes of the link itself." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4887 +#: ../src/guestfs-actions.pod:4683 msgid "guestfs_list_9p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4889 +#: ../src/guestfs-actions.pod:4685 #, no-wrap msgid "" " char **\n" @@ -34248,12 +33781,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4901 +#: ../src/guestfs-actions.pod:4697 msgid "guestfs_list_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4903 +#: ../src/guestfs-actions.pod:4699 #, no-wrap msgid "" " char **\n" @@ -34262,12 +33795,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4918 +#: ../src/guestfs-actions.pod:4714 msgid "guestfs_list_dm_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4920 +#: ../src/guestfs-actions.pod:4716 #, no-wrap msgid "" " char **\n" @@ -34276,14 +33809,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4925 +#: ../src/guestfs-actions.pod:4721 msgid "" "The returned list contains C</dev/mapper/*> devices, eg. ones created by a " "previous call to C<guestfs_luks_open>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4928 +#: ../src/guestfs-actions.pod:4724 msgid "" "Device mapper devices which correspond to logical volumes are I<not> " "returned in this list. Call C<guestfs_lvs> if you want to list logical " @@ -34291,17 +33824,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4936 ../src/guestfs-actions.pod:6922 +#: ../src/guestfs-actions.pod:4732 ../src/guestfs-actions.pod:6718 msgid "(Added in 1.11.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4938 +#: ../src/guestfs-actions.pod:4734 msgid "guestfs_list_filesystems" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4940 +#: ../src/guestfs-actions.pod:4736 #, no-wrap msgid "" " char **\n" @@ -34310,7 +33843,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4960 +#: ../src/guestfs-actions.pod:4756 msgid "" "This command runs other libguestfs commands, which might include " "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this " @@ -34318,7 +33851,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4964 +#: ../src/guestfs-actions.pod:4760 msgid "" "Not all of the filesystems returned will be mountable. In particular, swap " "partitions are returned in the list. Also this command does not check that " @@ -34329,17 +33862,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4978 ../src/guestfs-actions.pod:7282 +#: ../src/guestfs-actions.pod:4774 ../src/guestfs-actions.pod:7078 msgid "(Added in 1.5.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4980 +#: ../src/guestfs-actions.pod:4776 msgid "guestfs_list_md_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4982 +#: ../src/guestfs-actions.pod:4778 #, no-wrap msgid "" " char **\n" @@ -34348,17 +33881,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4991 ../src/guestfs-actions.pod:9127 +#: ../src/guestfs-actions.pod:4787 ../src/guestfs-actions.pod:8871 msgid "(Added in 1.15.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4993 +#: ../src/guestfs-actions.pod:4789 msgid "guestfs_list_partitions" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4995 +#: ../src/guestfs-actions.pod:4791 #, no-wrap msgid "" " char **\n" @@ -34367,19 +33900,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5002 +#: ../src/guestfs-actions.pod:4798 msgid "" "This does not return logical volumes. For that you will need to call " "C<guestfs_lvs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5013 +#: ../src/guestfs-actions.pod:4809 msgid "guestfs_ll" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5015 +#: ../src/guestfs-actions.pod:4811 #, no-wrap msgid "" " char *\n" @@ -34389,12 +33922,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5030 +#: ../src/guestfs-actions.pod:4826 msgid "guestfs_llz" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5032 +#: ../src/guestfs-actions.pod:4828 #, no-wrap msgid "" " char *\n" @@ -34404,17 +33937,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5044 ../src/guestfs-actions.pod:9832 +#: ../src/guestfs-actions.pod:4840 ../src/guestfs-actions.pod:9502 msgid "(Added in 1.17.6)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5046 +#: ../src/guestfs-actions.pod:4842 msgid "guestfs_ln" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5048 +#: ../src/guestfs-actions.pod:4844 #, no-wrap msgid "" " int\n" @@ -34425,12 +33958,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5059 +#: ../src/guestfs-actions.pod:4855 msgid "guestfs_ln_f" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5061 +#: ../src/guestfs-actions.pod:4857 #, no-wrap msgid "" " int\n" @@ -34441,12 +33974,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5073 +#: ../src/guestfs-actions.pod:4869 msgid "guestfs_ln_s" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5075 +#: ../src/guestfs-actions.pod:4871 #, no-wrap msgid "" " int\n" @@ -34457,12 +33990,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5086 +#: ../src/guestfs-actions.pod:4882 msgid "guestfs_ln_sf" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5088 +#: ../src/guestfs-actions.pod:4884 #, no-wrap msgid "" " int\n" @@ -34473,12 +34006,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5100 +#: ../src/guestfs-actions.pod:4896 msgid "guestfs_lremovexattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5102 +#: ../src/guestfs-actions.pod:4898 #, no-wrap msgid "" " int\n" @@ -34489,19 +34022,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5107 +#: ../src/guestfs-actions.pod:4903 msgid "" "This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic " "link, then it removes an extended attribute of the link itself." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5115 +#: ../src/guestfs-actions.pod:4911 msgid "guestfs_ls" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5117 +#: ../src/guestfs-actions.pod:4913 #, no-wrap msgid "" " char **\n" @@ -34511,19 +34044,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5125 +#: ../src/guestfs-actions.pod:4921 msgid "" "This command is mostly useful for interactive sessions. Programs should " "probably use C<guestfs_readdir> instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5134 +#: ../src/guestfs-actions.pod:4930 msgid "guestfs_lsetxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5136 +#: ../src/guestfs-actions.pod:4932 #, no-wrap msgid "" " int\n" @@ -34536,19 +34069,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5143 +#: ../src/guestfs-actions.pod:4939 msgid "" "This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, " "then it sets an extended attribute of the link itself." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5151 +#: ../src/guestfs-actions.pod:4947 msgid "guestfs_lstat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5153 +#: ../src/guestfs-actions.pod:4949 #, no-wrap msgid "" " struct guestfs_stat *\n" @@ -34558,31 +34091,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5159 +#: ../src/guestfs-actions.pod:4955 msgid "" "This is the same as C<guestfs_stat> except that if C<path> is a symbolic " "link, then the link is stat-ed, not the file it refers to." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5165 ../src/guestfs-actions.pod:8646 +#: ../src/guestfs-actions.pod:4961 ../src/guestfs-actions.pod:8390 msgid "" "This function returns a C<struct guestfs_stat *>, or NULL if there was an " "error. I<The caller must call C<guestfs_free_stat> after use>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5169 ../src/guestfs-actions.pod:8650 ../src/guestfs-actions.pod:8668 ../src/guestfs-actions.pod:9171 +#: ../src/guestfs-actions.pod:4965 ../src/guestfs-actions.pod:8394 ../src/guestfs-actions.pod:8412 ../src/guestfs-actions.pod:8915 msgid "(Added in 0.9.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5171 +#: ../src/guestfs-actions.pod:4967 msgid "guestfs_lstatlist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5173 +#: ../src/guestfs-actions.pod:4969 #, no-wrap msgid "" " struct guestfs_stat_list *\n" @@ -34593,7 +34126,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5178 +#: ../src/guestfs-actions.pod:4974 msgid "" "This call allows you to perform the C<guestfs_lstat> operation on multiple " "files, where all files are in the directory C<path>. C<names> is the list " @@ -34601,7 +34134,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5187 +#: ../src/guestfs-actions.pod:4983 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. See also C<guestfs_lxattrlist> " @@ -34612,19 +34145,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5195 +#: ../src/guestfs-actions.pod:4991 msgid "" "This function returns a C<struct guestfs_stat_list *>, or NULL if there was " "an error. I<The caller must call C<guestfs_free_stat_list> after use>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5201 +#: ../src/guestfs-actions.pod:4997 msgid "guestfs_luks_add_key" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5203 +#: ../src/guestfs-actions.pod:4999 #, no-wrap msgid "" " int\n" @@ -34637,14 +34170,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5215 +#: ../src/guestfs-actions.pod:5011 msgid "" "Note that if C<keyslot> already contains a key, then this command will " "fail. You have to use C<guestfs_luks_kill_slot> first to remove that key." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5221 ../src/guestfs-actions.pod:5258 ../src/guestfs-actions.pod:5278 ../src/guestfs-actions.pod:5298 ../src/guestfs-actions.pod:5333 ../src/guestfs-actions.pod:5352 +#: ../src/guestfs-actions.pod:5017 ../src/guestfs-actions.pod:5054 ../src/guestfs-actions.pod:5074 ../src/guestfs-actions.pod:5094 ../src/guestfs-actions.pod:5129 ../src/guestfs-actions.pod:5148 msgid "" "This function takes a key or passphrase parameter which could contain " "sensitive material. Read the section L</KEYS AND PASSPHRASES> for more " @@ -34652,17 +34185,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5225 ../src/guestfs-actions.pod:5262 ../src/guestfs-actions.pod:5282 ../src/guestfs-actions.pod:5302 +#: ../src/guestfs-actions.pod:5021 ../src/guestfs-actions.pod:5058 ../src/guestfs-actions.pod:5078 ../src/guestfs-actions.pod:5098 msgid "(Added in 1.5.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5227 +#: ../src/guestfs-actions.pod:5023 msgid "guestfs_luks_close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5229 +#: ../src/guestfs-actions.pod:5025 #, no-wrap msgid "" " int\n" @@ -34672,7 +34205,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5233 +#: ../src/guestfs-actions.pod:5029 msgid "" "This closes a LUKS device that was created earlier by C<guestfs_luks_open> " "or C<guestfs_luks_open_ro>. The C<device> parameter must be the name of the " @@ -34681,17 +34214,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5241 ../src/guestfs-actions.pod:5337 ../src/guestfs-actions.pod:5356 ../src/guestfs-actions.pod:5423 ../src/guestfs-actions.pod:5468 +#: ../src/guestfs-actions.pod:5037 ../src/guestfs-actions.pod:5133 ../src/guestfs-actions.pod:5152 ../src/guestfs-actions.pod:5219 ../src/guestfs-actions.pod:5264 msgid "(Added in 1.5.1)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5243 +#: ../src/guestfs-actions.pod:5039 msgid "guestfs_luks_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5245 +#: ../src/guestfs-actions.pod:5041 #, no-wrap msgid "" " int\n" @@ -34703,12 +34236,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5264 +#: ../src/guestfs-actions.pod:5060 msgid "guestfs_luks_format_cipher" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5266 +#: ../src/guestfs-actions.pod:5062 #, no-wrap msgid "" " int\n" @@ -34721,19 +34254,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5273 +#: ../src/guestfs-actions.pod:5069 msgid "" "This command is the same as C<guestfs_luks_format> but it also allows you to " "set the C<cipher> used." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5284 +#: ../src/guestfs-actions.pod:5080 msgid "guestfs_luks_kill_slot" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5286 +#: ../src/guestfs-actions.pod:5082 #, no-wrap msgid "" " int\n" @@ -34745,12 +34278,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5304 +#: ../src/guestfs-actions.pod:5100 msgid "guestfs_luks_open" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5306 +#: ../src/guestfs-actions.pod:5102 #, no-wrap msgid "" " int\n" @@ -34762,7 +34295,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5324 +#: ../src/guestfs-actions.pod:5120 msgid "" "If this block device contains LVM volume groups, then calling " "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them " @@ -34770,17 +34303,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5328 +#: ../src/guestfs-actions.pod:5124 msgid "Use C<guestfs_list_dm_devices> to list all device mapper devices." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5339 +#: ../src/guestfs-actions.pod:5135 msgid "guestfs_luks_open_ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5341 +#: ../src/guestfs-actions.pod:5137 #, no-wrap msgid "" " int\n" @@ -34792,19 +34325,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5347 +#: ../src/guestfs-actions.pod:5143 msgid "" "This is the same as C<guestfs_luks_open> except that a read-only mapping is " "created." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5358 +#: ../src/guestfs-actions.pod:5154 msgid "guestfs_lvcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5360 +#: ../src/guestfs-actions.pod:5156 #, no-wrap msgid "" " int\n" @@ -34816,12 +34349,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5373 +#: ../src/guestfs-actions.pod:5169 msgid "guestfs_lvcreate_free" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5375 +#: ../src/guestfs-actions.pod:5171 #, no-wrap msgid "" " int\n" @@ -34833,17 +34366,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5388 ../src/guestfs-actions.pod:10102 +#: ../src/guestfs-actions.pod:5184 ../src/guestfs-actions.pod:9688 msgid "(Added in 1.17.18)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5390 +#: ../src/guestfs-actions.pod:5186 msgid "guestfs_lvm_canonical_lv_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5392 +#: ../src/guestfs-actions.pod:5188 #, no-wrap msgid "" " char *\n" @@ -34853,22 +34386,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5403 -msgid "See also C<guestfs_is_lv>, C<guestfs_canonical_device_name>." +#: ../src/guestfs-actions.pod:5199 +msgid "See also C<guestfs_is_lv>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5408 +#: ../src/guestfs-actions.pod:5204 msgid "(Added in 1.5.24)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5410 +#: ../src/guestfs-actions.pod:5206 msgid "guestfs_lvm_clear_filter" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5412 +#: ../src/guestfs-actions.pod:5208 #, no-wrap msgid "" " int\n" @@ -34877,19 +34410,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5415 +#: ../src/guestfs-actions.pod:5211 msgid "" "This undoes the effect of C<guestfs_lvm_set_filter>. LVM will be able to " "see every block device." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5425 +#: ../src/guestfs-actions.pod:5221 msgid "guestfs_lvm_remove_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5427 +#: ../src/guestfs-actions.pod:5223 #, no-wrap msgid "" " int\n" @@ -34898,12 +34431,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5437 +#: ../src/guestfs-actions.pod:5233 msgid "guestfs_lvm_set_filter" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5439 +#: ../src/guestfs-actions.pod:5235 #, no-wrap msgid "" " int\n" @@ -34913,12 +34446,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5470 +#: ../src/guestfs-actions.pod:5266 msgid "guestfs_lvremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5472 +#: ../src/guestfs-actions.pod:5268 #, no-wrap msgid "" " int\n" @@ -34928,17 +34461,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5484 ../src/guestfs-actions.pod:7416 ../src/guestfs-actions.pod:9676 +#: ../src/guestfs-actions.pod:5280 ../src/guestfs-actions.pod:7193 ../src/guestfs-actions.pod:9346 msgid "(Added in 1.0.13)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5486 +#: ../src/guestfs-actions.pod:5282 msgid "guestfs_lvrename" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5488 +#: ../src/guestfs-actions.pod:5284 #, no-wrap msgid "" " int\n" @@ -34949,17 +34482,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5497 ../src/guestfs-actions.pod:9689 +#: ../src/guestfs-actions.pod:5293 ../src/guestfs-actions.pod:9359 msgid "(Added in 1.0.83)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5499 +#: ../src/guestfs-actions.pod:5295 msgid "guestfs_lvresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5501 +#: ../src/guestfs-actions.pod:5297 #, no-wrap msgid "" " int\n" @@ -34970,12 +34503,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5514 +#: ../src/guestfs-actions.pod:5310 msgid "guestfs_lvresize_free" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5516 +#: ../src/guestfs-actions.pod:5312 #, no-wrap msgid "" " int\n" @@ -34986,17 +34519,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5529 +#: ../src/guestfs-actions.pod:5325 msgid "(Added in 1.3.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5531 +#: ../src/guestfs-actions.pod:5327 msgid "guestfs_lvs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5533 +#: ../src/guestfs-actions.pod:5329 #, no-wrap msgid "" " char **\n" @@ -35005,17 +34538,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5542 +#: ../src/guestfs-actions.pod:5338 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5550 +#: ../src/guestfs-actions.pod:5346 msgid "guestfs_lvs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5552 +#: ../src/guestfs-actions.pod:5348 #, no-wrap msgid "" " struct guestfs_lvm_lv_list *\n" @@ -35024,7 +34557,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5558 +#: ../src/guestfs-actions.pod:5354 msgid "" "This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there " "was an error. I<The caller must call C<guestfs_free_lvm_lv_list> after " @@ -35032,12 +34565,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5564 +#: ../src/guestfs-actions.pod:5360 msgid "guestfs_lvuuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5566 +#: ../src/guestfs-actions.pod:5362 #, no-wrap msgid "" " char *\n" @@ -35047,12 +34580,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5577 +#: ../src/guestfs-actions.pod:5373 msgid "guestfs_lxattrlist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5579 +#: ../src/guestfs-actions.pod:5375 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -35063,7 +34596,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5598 +#: ../src/guestfs-actions.pod:5394 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. See also C<guestfs_lstatlist> for " @@ -35074,33 +34607,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5612 -msgid "guestfs_max_disks" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:5614 -#, no-wrap -msgid "" -" int\n" -" guestfs_max_disks (guestfs_h *g);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:5617 -msgid "" -"Return the maximum number of disks that may be added to a handle (eg. by " -"C<guestfs_add_drive_opts> and similar calls)." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:5630 +#: ../src/guestfs-actions.pod:5408 msgid "guestfs_md_create" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5632 +#: ../src/guestfs-actions.pod:5410 #, no-wrap msgid "" " int\n" @@ -35112,7 +34624,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5643 +#: ../src/guestfs-actions.pod:5421 #, no-wrap msgid "" " GUESTFS_MD_CREATE_MISSINGBITMAP, int64_t missingbitmap,\n" @@ -35124,17 +34636,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5705 ../src/guestfs-actions.pod:5771 ../src/guestfs-actions.pod:5841 +#: ../src/guestfs-actions.pod:5483 ../src/guestfs-actions.pod:5549 ../src/guestfs-actions.pod:5619 msgid "(Added in 1.15.6)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5707 +#: ../src/guestfs-actions.pod:5485 msgid "guestfs_md_create_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5709 +#: ../src/guestfs-actions.pod:5487 #, no-wrap msgid "" " int\n" @@ -35146,17 +34658,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5715 +#: ../src/guestfs-actions.pod:5493 msgid "This is the \"va_list variant\" of L</guestfs_md_create>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5719 +#: ../src/guestfs-actions.pod:5497 msgid "guestfs_md_create_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5721 +#: ../src/guestfs-actions.pod:5499 #, no-wrap msgid "" " int\n" @@ -35168,17 +34680,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5727 +#: ../src/guestfs-actions.pod:5505 msgid "This is the \"argv variant\" of L</guestfs_md_create>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5731 +#: ../src/guestfs-actions.pod:5509 msgid "guestfs_md_detail" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5733 +#: ../src/guestfs-actions.pod:5511 #, no-wrap msgid "" " char **\n" @@ -35188,12 +34700,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5773 +#: ../src/guestfs-actions.pod:5551 msgid "guestfs_md_stat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5775 +#: ../src/guestfs-actions.pod:5553 #, no-wrap msgid "" " struct guestfs_mdstat_list *\n" @@ -35203,12 +34715,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5782 +#: ../src/guestfs-actions.pod:5560 msgid "To get a list of software RAID devices, call C<guestfs_list_md_devices>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5824 +#: ../src/guestfs-actions.pod:5602 msgid "" "This function returns a C<struct guestfs_mdstat_list *>, or NULL if there " "was an error. I<The caller must call C<guestfs_free_mdstat_list> after " @@ -35216,17 +34728,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5828 +#: ../src/guestfs-actions.pod:5606 msgid "(Added in 1.17.21)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5830 +#: ../src/guestfs-actions.pod:5608 msgid "guestfs_md_stop" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5832 +#: ../src/guestfs-actions.pod:5610 #, no-wrap msgid "" " int\n" @@ -35236,12 +34748,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5843 +#: ../src/guestfs-actions.pod:5621 msgid "guestfs_mkdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5845 +#: ../src/guestfs-actions.pod:5623 #, no-wrap msgid "" " int\n" @@ -35251,12 +34763,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5855 +#: ../src/guestfs-actions.pod:5633 msgid "guestfs_mkdir_mode" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5857 +#: ../src/guestfs-actions.pod:5635 #, no-wrap msgid "" " int\n" @@ -35267,17 +34779,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5869 +#: ../src/guestfs-actions.pod:5647 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5875 +#: ../src/guestfs-actions.pod:5653 msgid "guestfs_mkdir_p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5877 +#: ../src/guestfs-actions.pod:5655 #, no-wrap msgid "" " int\n" @@ -35287,12 +34799,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5888 +#: ../src/guestfs-actions.pod:5666 msgid "guestfs_mkdtemp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5890 +#: ../src/guestfs-actions.pod:5668 #, no-wrap msgid "" " char *\n" @@ -35302,12 +34814,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5918 +#: ../src/guestfs-actions.pod:5696 msgid "guestfs_mke2fs_J" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5920 +#: ../src/guestfs-actions.pod:5698 #, no-wrap msgid "" " int\n" @@ -35320,22 +34832,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5933 +#: ../src/guestfs-actions.pod:5711 msgid "See also C<guestfs_mke2journal>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5937 ../src/guestfs-actions.pod:5955 ../src/guestfs-actions.pod:5973 ../src/guestfs-actions.pod:5989 ../src/guestfs-actions.pod:6003 ../src/guestfs-actions.pod:6017 ../src/guestfs-actions.pod:6162 ../src/guestfs-actions.pod:6407 +#: ../src/guestfs-actions.pod:5715 ../src/guestfs-actions.pod:5733 ../src/guestfs-actions.pod:5751 ../src/guestfs-actions.pod:5767 ../src/guestfs-actions.pod:5781 ../src/guestfs-actions.pod:5795 ../src/guestfs-actions.pod:5854 ../src/guestfs-actions.pod:6186 msgid "(Added in 1.0.68)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5939 +#: ../src/guestfs-actions.pod:5717 msgid "guestfs_mke2fs_JL" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5941 +#: ../src/guestfs-actions.pod:5719 #, no-wrap msgid "" " int\n" @@ -35348,17 +34860,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5951 +#: ../src/guestfs-actions.pod:5729 msgid "See also C<guestfs_mke2journal_L>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5957 +#: ../src/guestfs-actions.pod:5735 msgid "guestfs_mke2fs_JU" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5959 +#: ../src/guestfs-actions.pod:5737 #, no-wrap msgid "" " int\n" @@ -35371,17 +34883,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5969 +#: ../src/guestfs-actions.pod:5747 msgid "See also C<guestfs_mke2journal_U>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5975 +#: ../src/guestfs-actions.pod:5753 msgid "guestfs_mke2journal" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5977 +#: ../src/guestfs-actions.pod:5755 #, no-wrap msgid "" " int\n" @@ -35392,12 +34904,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5991 +#: ../src/guestfs-actions.pod:5769 msgid "guestfs_mke2journal_L" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5993 +#: ../src/guestfs-actions.pod:5771 #, no-wrap msgid "" " int\n" @@ -35409,12 +34921,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6005 +#: ../src/guestfs-actions.pod:5783 msgid "guestfs_mke2journal_U" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6007 +#: ../src/guestfs-actions.pod:5785 #, no-wrap msgid "" " int\n" @@ -35426,12 +34938,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6019 +#: ../src/guestfs-actions.pod:5797 msgid "guestfs_mkfifo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6021 +#: ../src/guestfs-actions.pod:5799 #, no-wrap msgid "" " int\n" @@ -35442,19 +34954,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6026 +#: ../src/guestfs-actions.pod:5804 msgid "" "This call creates a FIFO (named pipe) called C<path> with mode C<mode>. It " "is just a convenient wrapper around C<guestfs_mknod>." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:6036 -msgid "= head2 guestfs_mkfs" +#. type: =head2 +#: ../src/guestfs-actions.pod:5814 +msgid "guestfs_mkfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6038 +#: ../src/guestfs-actions.pod:5816 #, no-wrap msgid "" " int\n" @@ -35464,213 +34976,205 @@ msgid "" "\n" msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:6043 -msgid "" -"This function is provided for backwards compatibility with earlier versions " -"of libguestfs. It simply calls L</guestfs_mkfs_opts> with no optional " -"arguments." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:6050 -msgid "guestfs_mkfs_opts" +#: ../src/guestfs-actions.pod:5829 +msgid "guestfs_mkfs_b" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6052 +#: ../src/guestfs-actions.pod:5831 #, no-wrap msgid "" " int\n" -" guestfs_mkfs_opts (guestfs_h *g,\n" -" const char *fstype,\n" -" const char *device,\n" -" ...);\n" +" guestfs_mkfs_b (guestfs_h *g,\n" +" const char *fstype,\n" +" int blocksize,\n" +" const char *device);\n" "\n" msgstr "" -#. type: verbatim -#: ../src/guestfs-actions.pod:6063 -#, no-wrap +#. type: textblock +#: ../src/guestfs-actions.pod:5837 msgid "" -" GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n" -" GUESTFS_MKFS_OPTS_FEATURES, const char *features,\n" -" GUESTFS_MKFS_OPTS_INODE, int inode,\n" -" GUESTFS_MKFS_OPTS_SECTORSIZE, int sectorsize,\n" -"\n" +"I<This function is deprecated.> In new code, use the L</guestfs_mkfs_opts> " +"call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6111 -msgid "(Added in 1.7.19)" +#: ../src/guestfs-actions.pod:5844 +msgid "" +"This call is similar to C<guestfs_mkfs>, but it allows you to control the " +"block size of the resulting filesystem. Supported block sizes depend on the " +"filesystem type, but typically they are C<1024>, C<2048> or C<4096> only." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6113 -msgid "guestfs_mkfs_opts_va" +#: ../src/guestfs-actions.pod:5856 +msgid "guestfs_mkfs_btrfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6115 +#: ../src/guestfs-actions.pod:5858 #, no-wrap msgid "" " int\n" -" guestfs_mkfs_opts_va (guestfs_h *g,\n" -" const char *fstype,\n" -" const char *device,\n" -" va_list args);\n" +" guestfs_mkfs_btrfs (guestfs_h *g,\n" +" char *const *devices,\n" +" ...);\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:5868 +#, no-wrap +msgid "" +" GUESTFS_MKFS_BTRFS_ALLOCSTART, int64_t allocstart,\n" +" GUESTFS_MKFS_BTRFS_BYTECOUNT, int64_t bytecount,\n" +" GUESTFS_MKFS_BTRFS_DATATYPE, const char *datatype,\n" +" GUESTFS_MKFS_BTRFS_LEAFSIZE, int leafsize,\n" +" GUESTFS_MKFS_BTRFS_LABEL, const char *label,\n" +" GUESTFS_MKFS_BTRFS_METADATA, const char *metadata,\n" +" GUESTFS_MKFS_BTRFS_NODESIZE, int nodesize,\n" +" GUESTFS_MKFS_BTRFS_SECTORSIZE, int sectorsize,\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6121 -msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>." +#: ../src/guestfs-actions.pod:5883 +msgid "To create general filesystems, use C<guestfs_mkfs_opts>." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:5887 +msgid "(Added in 1.17.25)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6125 -msgid "guestfs_mkfs_opts_argv" +#: ../src/guestfs-actions.pod:5889 +msgid "guestfs_mkfs_btrfs_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6127 +#: ../src/guestfs-actions.pod:5891 #, no-wrap msgid "" " int\n" -" guestfs_mkfs_opts_argv (guestfs_h *g,\n" -" const char *fstype,\n" -" const char *device,\n" -" const struct guestfs_mkfs_opts_argv *optargs);\n" +" guestfs_mkfs_btrfs_va (guestfs_h *g,\n" +" char *const *devices,\n" +" va_list args);\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6133 -msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>." +#: ../src/guestfs-actions.pod:5896 +msgid "This is the \"va_list variant\" of L</guestfs_mkfs_btrfs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6137 -msgid "guestfs_mkfs_b" +#: ../src/guestfs-actions.pod:5900 +msgid "guestfs_mkfs_btrfs_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6139 +#: ../src/guestfs-actions.pod:5902 #, no-wrap msgid "" " int\n" -" guestfs_mkfs_b (guestfs_h *g,\n" -" const char *fstype,\n" -" int blocksize,\n" -" const char *device);\n" +" guestfs_mkfs_btrfs_argv (guestfs_h *g,\n" +" char *const *devices,\n" +" const struct guestfs_mkfs_btrfs_argv *optargs);\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6145 -msgid "" -"I<This function is deprecated.> In new code, use the L</guestfs_mkfs> call " -"instead." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:6152 -msgid "" -"This call is similar to C<guestfs_mkfs>, but it allows you to control the " -"block size of the resulting filesystem. Supported block sizes depend on the " -"filesystem type, but typically they are C<1024>, C<2048> or C<4096> only." +#: ../src/guestfs-actions.pod:5907 +msgid "This is the \"argv variant\" of L</guestfs_mkfs_btrfs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6164 -msgid "guestfs_mkfs_btrfs" +#: ../src/guestfs-actions.pod:5911 +msgid "guestfs_mkfs_opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6166 +#: ../src/guestfs-actions.pod:5913 #, no-wrap msgid "" " int\n" -" guestfs_mkfs_btrfs (guestfs_h *g,\n" -" char *const *devices,\n" -" ...);\n" +" guestfs_mkfs_opts (guestfs_h *g,\n" +" const char *fstype,\n" +" const char *device,\n" +" ...);\n" "\n" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6176 +#: ../src/guestfs-actions.pod:5924 #, no-wrap msgid "" -" GUESTFS_MKFS_BTRFS_ALLOCSTART, int64_t allocstart,\n" -" GUESTFS_MKFS_BTRFS_BYTECOUNT, int64_t bytecount,\n" -" GUESTFS_MKFS_BTRFS_DATATYPE, const char *datatype,\n" -" GUESTFS_MKFS_BTRFS_LEAFSIZE, int leafsize,\n" -" GUESTFS_MKFS_BTRFS_LABEL, const char *label,\n" -" GUESTFS_MKFS_BTRFS_METADATA, const char *metadata,\n" -" GUESTFS_MKFS_BTRFS_NODESIZE, int nodesize,\n" -" GUESTFS_MKFS_BTRFS_SECTORSIZE, int sectorsize,\n" +" GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n" +" GUESTFS_MKFS_OPTS_FEATURES, const char *features,\n" +" GUESTFS_MKFS_OPTS_INODE, int inode,\n" +" GUESTFS_MKFS_OPTS_SECTORSIZE, int sectorsize,\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6191 -msgid "To create general filesystems, use C<guestfs_mkfs>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:6195 -msgid "(Added in 1.17.25)" +#: ../src/guestfs-actions.pod:5972 +msgid "(Added in 1.7.19)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6197 -msgid "guestfs_mkfs_btrfs_va" +#: ../src/guestfs-actions.pod:5974 +msgid "guestfs_mkfs_opts_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6199 +#: ../src/guestfs-actions.pod:5976 #, no-wrap msgid "" " int\n" -" guestfs_mkfs_btrfs_va (guestfs_h *g,\n" -" char *const *devices,\n" -" va_list args);\n" +" guestfs_mkfs_opts_va (guestfs_h *g,\n" +" const char *fstype,\n" +" const char *device,\n" +" va_list args);\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6204 -msgid "This is the \"va_list variant\" of L</guestfs_mkfs_btrfs>." +#: ../src/guestfs-actions.pod:5982 +msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6208 -msgid "guestfs_mkfs_btrfs_argv" +#: ../src/guestfs-actions.pod:5986 +msgid "guestfs_mkfs_opts_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6210 +#: ../src/guestfs-actions.pod:5988 #, no-wrap msgid "" " int\n" -" guestfs_mkfs_btrfs_argv (guestfs_h *g,\n" -" char *const *devices,\n" -" const struct guestfs_mkfs_btrfs_argv *optargs);\n" +" guestfs_mkfs_opts_argv (guestfs_h *g,\n" +" const char *fstype,\n" +" const char *device,\n" +" const struct guestfs_mkfs_opts_argv *optargs);\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6215 -msgid "This is the \"argv variant\" of L</guestfs_mkfs_btrfs>." +#: ../src/guestfs-actions.pod:5994 +msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6219 +#: ../src/guestfs-actions.pod:5998 msgid "guestfs_mkmountpoint" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6221 +#: ../src/guestfs-actions.pod:6000 #, no-wrap msgid "" " int\n" @@ -35680,7 +35184,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6225 +#: ../src/guestfs-actions.pod:6004 msgid "" "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls " "that can be used to create extra mountpoints before mounting the first " @@ -35688,7 +35192,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6249 +#: ../src/guestfs-actions.pod:6028 msgid "" "C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>. You " "may get unexpected errors if you try to mix these calls. It is safest to " @@ -35696,7 +35200,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6253 +#: ../src/guestfs-actions.pod:6032 msgid "" "C<guestfs_umount_all> unmounts filesystems by sorting the paths longest " "first, so for this to work for manual mountpoints, you must ensure that the " @@ -35705,7 +35209,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6260 +#: ../src/guestfs-actions.pod:6039 msgid "" "Autosync [see C<guestfs_set_autosync>, this is set by default on handles] " "can cause C<guestfs_umount_all> to be called when the handle is closed which " @@ -35713,17 +35217,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6266 ../src/guestfs-actions.pod:6666 ../src/guestfs-actions.pod:7836 +#: ../src/guestfs-actions.pod:6045 ../src/guestfs-actions.pod:6445 ../src/guestfs-actions.pod:7613 msgid "(Added in 1.0.62)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6268 +#: ../src/guestfs-actions.pod:6047 msgid "guestfs_mknod" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6270 +#: ../src/guestfs-actions.pod:6049 #, no-wrap msgid "" " int\n" @@ -35736,7 +35240,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6285 +#: ../src/guestfs-actions.pod:6064 msgid "" "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with " "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a " @@ -35747,12 +35251,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6299 +#: ../src/guestfs-actions.pod:6078 msgid "guestfs_mknod_b" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6301 +#: ../src/guestfs-actions.pod:6080 #, no-wrap msgid "" " int\n" @@ -35765,7 +35269,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6308 +#: ../src/guestfs-actions.pod:6087 msgid "" "This call creates a block device node called C<path> with mode C<mode> and " "device major/minor C<devmajor> and C<devminor>. It is just a convenient " @@ -35773,12 +35277,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6318 +#: ../src/guestfs-actions.pod:6097 msgid "guestfs_mknod_c" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6320 +#: ../src/guestfs-actions.pod:6099 #, no-wrap msgid "" " int\n" @@ -35791,7 +35295,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6327 +#: ../src/guestfs-actions.pod:6106 msgid "" "This call creates a char device node called C<path> with mode C<mode> and " "device major/minor C<devmajor> and C<devminor>. It is just a convenient " @@ -35799,12 +35303,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6337 +#: ../src/guestfs-actions.pod:6116 msgid "guestfs_mkswap" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6339 +#: ../src/guestfs-actions.pod:6118 #, no-wrap msgid "" " int\n" @@ -35814,12 +35318,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6349 +#: ../src/guestfs-actions.pod:6128 msgid "guestfs_mkswap_L" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6351 +#: ../src/guestfs-actions.pod:6130 #, no-wrap msgid "" " int\n" @@ -35830,12 +35334,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6366 +#: ../src/guestfs-actions.pod:6145 msgid "guestfs_mkswap_U" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6368 +#: ../src/guestfs-actions.pod:6147 #, no-wrap msgid "" " int\n" @@ -35846,12 +35350,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6379 +#: ../src/guestfs-actions.pod:6158 msgid "guestfs_mkswap_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6381 +#: ../src/guestfs-actions.pod:6160 #, no-wrap msgid "" " int\n" @@ -35861,19 +35365,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6387 +#: ../src/guestfs-actions.pod:6166 msgid "" "This command just writes a swap file signature to an existing file. To " "create the file itself, use something like C<guestfs_fallocate>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6394 +#: ../src/guestfs-actions.pod:6173 msgid "guestfs_modprobe" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6396 +#: ../src/guestfs-actions.pod:6175 #, no-wrap msgid "" " int\n" @@ -35883,12 +35387,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6409 +#: ../src/guestfs-actions.pod:6188 msgid "guestfs_mount" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6411 +#: ../src/guestfs-actions.pod:6190 #, no-wrap msgid "" " int\n" @@ -35899,7 +35403,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6430 +#: ../src/guestfs-actions.pod:6209 msgid "" "Before libguestfs 1.13.16, this call implicitly added the options C<sync> " "and C<noatime>. The C<sync> option greatly slowed writes and caused many " @@ -35909,12 +35413,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6441 +#: ../src/guestfs-actions.pod:6220 msgid "guestfs_mount_9p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6443 +#: ../src/guestfs-actions.pod:6222 #, no-wrap msgid "" " int\n" @@ -35926,7 +35430,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6454 +#: ../src/guestfs-actions.pod:6233 #, no-wrap msgid "" " GUESTFS_MOUNT_9P_OPTIONS, const char *options,\n" @@ -35934,12 +35438,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6467 +#: ../src/guestfs-actions.pod:6246 msgid "guestfs_mount_9p_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6469 +#: ../src/guestfs-actions.pod:6248 #, no-wrap msgid "" " int\n" @@ -35951,17 +35455,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6475 +#: ../src/guestfs-actions.pod:6254 msgid "This is the \"va_list variant\" of L</guestfs_mount_9p>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6479 +#: ../src/guestfs-actions.pod:6258 msgid "guestfs_mount_9p_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6481 +#: ../src/guestfs-actions.pod:6260 #, no-wrap msgid "" " int\n" @@ -35973,17 +35477,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6487 +#: ../src/guestfs-actions.pod:6266 msgid "This is the \"argv variant\" of L</guestfs_mount_9p>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6491 +#: ../src/guestfs-actions.pod:6270 msgid "guestfs_mount_local" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6493 +#: ../src/guestfs-actions.pod:6272 #, no-wrap msgid "" " int\n" @@ -35994,7 +35498,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6503 +#: ../src/guestfs-actions.pod:6282 #, no-wrap msgid "" " GUESTFS_MOUNT_LOCAL_READONLY, int readonly,\n" @@ -36005,7 +35509,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6526 +#: ../src/guestfs-actions.pod:6305 msgid "" "When C<guestfs_mount_local> returns, the filesystem is ready, but is not " "processing requests (access to it will block). You have to call " @@ -36013,17 +35517,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6534 ../src/guestfs-actions.pod:6583 ../src/guestfs-actions.pod:9317 +#: ../src/guestfs-actions.pod:6313 ../src/guestfs-actions.pod:6362 ../src/guestfs-actions.pod:9019 msgid "(Added in 1.17.22)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6536 +#: ../src/guestfs-actions.pod:6315 msgid "guestfs_mount_local_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6538 +#: ../src/guestfs-actions.pod:6317 #, no-wrap msgid "" " int\n" @@ -36034,17 +35538,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6543 +#: ../src/guestfs-actions.pod:6322 msgid "This is the \"va_list variant\" of L</guestfs_mount_local>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6547 +#: ../src/guestfs-actions.pod:6326 msgid "guestfs_mount_local_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6549 +#: ../src/guestfs-actions.pod:6328 #, no-wrap msgid "" " int\n" @@ -36056,17 +35560,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6554 +#: ../src/guestfs-actions.pod:6333 msgid "This is the \"argv variant\" of L</guestfs_mount_local>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6558 +#: ../src/guestfs-actions.pod:6337 msgid "guestfs_mount_local_run" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6560 +#: ../src/guestfs-actions.pod:6339 #, no-wrap msgid "" " int\n" @@ -36075,21 +35579,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6566 +#: ../src/guestfs-actions.pod:6345 msgid "" "This should only be called after C<guestfs_mount_local> returns " "successfully. The call will not return until the filesystem is unmounted." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6570 +#: ../src/guestfs-actions.pod:6349 msgid "" "B<Note> you must I<not> make concurrent libguestfs calls on the same handle " "from another thread, with the exception of C<guestfs_umount_local>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6574 +#: ../src/guestfs-actions.pod:6353 msgid "" "You may call this from a different thread than the one which called " "C<guestfs_mount_local>, subject to the usual rules for threads and " @@ -36097,12 +35601,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6585 +#: ../src/guestfs-actions.pod:6364 msgid "guestfs_mount_loop" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6587 +#: ../src/guestfs-actions.pod:6366 #, no-wrap msgid "" " int\n" @@ -36113,12 +35617,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6600 +#: ../src/guestfs-actions.pod:6379 msgid "guestfs_mount_options" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6602 +#: ../src/guestfs-actions.pod:6381 #, no-wrap msgid "" " int\n" @@ -36130,24 +35634,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6608 +#: ../src/guestfs-actions.pod:6387 msgid "" "This is the same as the C<guestfs_mount> command, but it allows you to set " "the mount options as for the L<mount(8)> I<-o> flag." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6618 ../src/guestfs-actions.pod:6632 ../src/guestfs-actions.pod:6649 +#: ../src/guestfs-actions.pod:6397 ../src/guestfs-actions.pod:6411 ../src/guestfs-actions.pod:6428 msgid "(Added in 1.0.10)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6620 +#: ../src/guestfs-actions.pod:6399 msgid "guestfs_mount_ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6622 +#: ../src/guestfs-actions.pod:6401 #, no-wrap msgid "" " int\n" @@ -36158,19 +35662,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6627 +#: ../src/guestfs-actions.pod:6406 msgid "" "This is the same as the C<guestfs_mount> command, but it mounts the " "filesystem with the read-only (I<-o ro>) flag." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6634 +#: ../src/guestfs-actions.pod:6413 msgid "guestfs_mount_vfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6636 +#: ../src/guestfs-actions.pod:6415 #, no-wrap msgid "" " int\n" @@ -36183,7 +35687,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6643 +#: ../src/guestfs-actions.pod:6422 msgid "" "This is the same as the C<guestfs_mount> command, but it allows you to set " "both the mount options and the vfstype as for the L<mount(8)> I<-o> and " @@ -36191,12 +35695,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6651 +#: ../src/guestfs-actions.pod:6430 msgid "guestfs_mountpoints" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6653 +#: ../src/guestfs-actions.pod:6432 #, no-wrap msgid "" " char **\n" @@ -36205,7 +35709,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6656 +#: ../src/guestfs-actions.pod:6435 msgid "" "This call is similar to C<guestfs_mounts>. That call returns a list of " "devices. This one returns a hash table (map) of device name to directory " @@ -36213,12 +35717,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6668 +#: ../src/guestfs-actions.pod:6447 msgid "guestfs_mounts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6670 +#: ../src/guestfs-actions.pod:6449 #, no-wrap msgid "" " char **\n" @@ -36227,17 +35731,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6678 +#: ../src/guestfs-actions.pod:6457 msgid "See also: C<guestfs_mountpoints>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6686 +#: ../src/guestfs-actions.pod:6465 msgid "guestfs_mv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6688 +#: ../src/guestfs-actions.pod:6467 #, no-wrap msgid "" " int\n" @@ -36248,12 +35752,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6700 +#: ../src/guestfs-actions.pod:6479 msgid "guestfs_nr_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6702 +#: ../src/guestfs-actions.pod:6481 #, no-wrap msgid "" " int\n" @@ -36262,7 +35766,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6705 +#: ../src/guestfs-actions.pod:6484 msgid "" "This returns the number of whole block devices that were added. This is the " "same as the number of devices that would be returned if you called " @@ -36270,19 +35774,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6709 +#: ../src/guestfs-actions.pod:6488 msgid "" "To find out the maximum number of devices that could be added, call " "C<guestfs_max_disks>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6714 +#: ../src/guestfs-actions.pod:6493 msgid "guestfs_ntfs_3g_probe" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6716 +#: ../src/guestfs-actions.pod:6495 #, no-wrap msgid "" " int\n" @@ -36293,17 +35797,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6735 +#: ../src/guestfs-actions.pod:6514 msgid "(Added in 1.0.43)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6737 +#: ../src/guestfs-actions.pod:6516 msgid "guestfs_ntfsclone_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6739 +#: ../src/guestfs-actions.pod:6518 #, no-wrap msgid "" " int\n" @@ -36314,24 +35818,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6744 +#: ../src/guestfs-actions.pod:6523 msgid "" "Restore the C<backupfile> (from a previous call to C<guestfs_ntfsclone_out>) " "to C<device>, overwriting any existing contents of this device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6750 ../src/guestfs-actions.pod:6788 ../src/guestfs-actions.pod:6840 ../src/guestfs-actions.pod:8156 +#: ../src/guestfs-actions.pod:6529 ../src/guestfs-actions.pod:6567 ../src/guestfs-actions.pod:6619 ../src/guestfs-actions.pod:7900 msgid "(Added in 1.17.9)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6752 +#: ../src/guestfs-actions.pod:6531 msgid "guestfs_ntfsclone_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6754 +#: ../src/guestfs-actions.pod:6533 #, no-wrap msgid "" " int\n" @@ -36343,7 +35847,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6765 +#: ../src/guestfs-actions.pod:6544 #, no-wrap msgid "" " GUESTFS_NTFSCLONE_OUT_METADATAONLY, int metadataonly,\n" @@ -36355,17 +35859,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6783 +#: ../src/guestfs-actions.pod:6562 msgid "Use C<guestfs_ntfsclone_in> to restore the file back to a libguestfs device." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6790 +#: ../src/guestfs-actions.pod:6569 msgid "guestfs_ntfsclone_out_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6792 +#: ../src/guestfs-actions.pod:6571 #, no-wrap msgid "" " int\n" @@ -36377,17 +35881,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6798 +#: ../src/guestfs-actions.pod:6577 msgid "This is the \"va_list variant\" of L</guestfs_ntfsclone_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6802 +#: ../src/guestfs-actions.pod:6581 msgid "guestfs_ntfsclone_out_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6804 +#: ../src/guestfs-actions.pod:6583 #, no-wrap msgid "" " int\n" @@ -36400,17 +35904,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6810 +#: ../src/guestfs-actions.pod:6589 msgid "This is the \"argv variant\" of L</guestfs_ntfsclone_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6814 +#: ../src/guestfs-actions.pod:6593 msgid "guestfs_ntfsfix" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6816 +#: ../src/guestfs-actions.pod:6595 #, no-wrap msgid "" " int\n" @@ -36421,7 +35925,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6826 +#: ../src/guestfs-actions.pod:6605 #, no-wrap msgid "" " GUESTFS_NTFSFIX_CLEARBADSECTORS, int clearbadsectors,\n" @@ -36429,12 +35933,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6842 +#: ../src/guestfs-actions.pod:6621 msgid "guestfs_ntfsfix_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6844 +#: ../src/guestfs-actions.pod:6623 #, no-wrap msgid "" " int\n" @@ -36445,17 +35949,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6849 +#: ../src/guestfs-actions.pod:6628 msgid "This is the \"va_list variant\" of L</guestfs_ntfsfix>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6853 +#: ../src/guestfs-actions.pod:6632 msgid "guestfs_ntfsfix_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6855 +#: ../src/guestfs-actions.pod:6634 #, no-wrap msgid "" " int\n" @@ -36466,17 +35970,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6860 +#: ../src/guestfs-actions.pod:6639 msgid "This is the \"argv variant\" of L</guestfs_ntfsfix>." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:6864 -msgid "= head2 guestfs_ntfsresize" +#. type: =head2 +#: ../src/guestfs-actions.pod:6643 +msgid "guestfs_ntfsresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6866 +#: ../src/guestfs-actions.pod:6645 #, no-wrap msgid "" " int\n" @@ -36486,20 +35990,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6870 +#: ../src/guestfs-actions.pod:6649 ../src/guestfs-actions.pod:6749 msgid "" -"This function is provided for backwards compatibility with earlier versions " -"of libguestfs. It simply calls L</guestfs_ntfsresize_opts> with no optional " -"arguments." +"I<This function is deprecated.> In new code, use the " +"L</guestfs_ntfsresize_opts> call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6877 +#: ../src/guestfs-actions.pod:6673 msgid "guestfs_ntfsresize_opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6879 +#: ../src/guestfs-actions.pod:6675 #, no-wrap msgid "" " int\n" @@ -36510,7 +36013,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6889 +#: ../src/guestfs-actions.pod:6685 #, no-wrap msgid "" " GUESTFS_NTFSRESIZE_OPTS_SIZE, int64_t size,\n" @@ -36519,22 +36022,23 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6909 +#: ../src/guestfs-actions.pod:6705 msgid "" "After the resize operation, the filesystem is always marked as requiring a " "consistency check (for safety). You have to boot into Windows to perform " "this check and clear this condition. If you I<don't> set the C<force> " -"option then it is not possible to call C<guestfs_ntfsresize> multiple times " -"on a single filesystem without booting into Windows between each resize." +"option then it is not possible to call C<guestfs_ntfsresize_opts> multiple " +"times on a single filesystem without booting into Windows between each " +"resize." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6924 +#: ../src/guestfs-actions.pod:6720 msgid "guestfs_ntfsresize_opts_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6926 +#: ../src/guestfs-actions.pod:6722 #, no-wrap msgid "" " int\n" @@ -36545,17 +36049,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6931 +#: ../src/guestfs-actions.pod:6727 msgid "This is the \"va_list variant\" of L</guestfs_ntfsresize_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6935 +#: ../src/guestfs-actions.pod:6731 msgid "guestfs_ntfsresize_opts_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6937 +#: ../src/guestfs-actions.pod:6733 #, no-wrap msgid "" " int\n" @@ -36567,17 +36071,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6942 +#: ../src/guestfs-actions.pod:6738 msgid "This is the \"argv variant\" of L</guestfs_ntfsresize_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6946 +#: ../src/guestfs-actions.pod:6742 msgid "guestfs_ntfsresize_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6948 +#: ../src/guestfs-actions.pod:6744 #, no-wrap msgid "" " int\n" @@ -36588,31 +36092,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6953 -msgid "" -"I<This function is deprecated.> In new code, use the L</guestfs_ntfsresize> " -"call instead." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:6960 +#: ../src/guestfs-actions.pod:6756 msgid "" "This command is the same as C<guestfs_ntfsresize> except that it allows you " "to specify the new size (in bytes) explicitly." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6965 ../src/guestfs-actions.pod:7443 ../src/guestfs-actions.pod:7516 ../src/guestfs-actions.pod:7784 ../src/guestfs-actions.pod:9852 +#: ../src/guestfs-actions.pod:6761 ../src/guestfs-actions.pod:7220 ../src/guestfs-actions.pod:7293 ../src/guestfs-actions.pod:7561 ../src/guestfs-actions.pod:9522 msgid "(Added in 1.3.14)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6967 +#: ../src/guestfs-actions.pod:6763 msgid "guestfs_part_add" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6969 +#: ../src/guestfs-actions.pod:6765 #, no-wrap msgid "" " int\n" @@ -36625,31 +36122,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6976 +#: ../src/guestfs-actions.pod:6772 msgid "" "This command adds a partition to C<device>. If there is no partition table " "on the device, call C<guestfs_part_init> first." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6988 +#: ../src/guestfs-actions.pod:6784 msgid "" "Creating a partition which covers the whole disk is not so easy. Use " "C<guestfs_part_disk> to do that." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6993 ../src/guestfs-actions.pod:7028 ../src/guestfs-actions.pod:7081 ../src/guestfs-actions.pod:7165 ../src/guestfs-actions.pod:7203 ../src/guestfs-actions.pod:7222 ../src/guestfs-actions.pod:7262 +#: ../src/guestfs-actions.pod:6789 ../src/guestfs-actions.pod:6824 ../src/guestfs-actions.pod:6877 ../src/guestfs-actions.pod:6961 ../src/guestfs-actions.pod:6999 ../src/guestfs-actions.pod:7018 ../src/guestfs-actions.pod:7058 msgid "(Added in 1.0.78)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6995 +#: ../src/guestfs-actions.pod:6791 msgid "guestfs_part_del" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6997 +#: ../src/guestfs-actions.pod:6793 #, no-wrap msgid "" " int\n" @@ -36660,12 +36157,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7012 +#: ../src/guestfs-actions.pod:6808 msgid "guestfs_part_disk" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7014 +#: ../src/guestfs-actions.pod:6810 #, no-wrap msgid "" " int\n" @@ -36676,7 +36173,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7019 +#: ../src/guestfs-actions.pod:6815 msgid "" "This command is simply a combination of C<guestfs_part_init> followed by " "C<guestfs_part_add> to create a single primary partition covering the whole " @@ -36684,19 +36181,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7023 +#: ../src/guestfs-actions.pod:6819 msgid "" "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other " "possible values are described in C<guestfs_part_init>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7030 +#: ../src/guestfs-actions.pod:6826 msgid "guestfs_part_get_bootable" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7032 +#: ../src/guestfs-actions.pod:6828 #, no-wrap msgid "" " int\n" @@ -36707,17 +36204,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7040 +#: ../src/guestfs-actions.pod:6836 msgid "See also C<guestfs_part_set_bootable>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7046 +#: ../src/guestfs-actions.pod:6842 msgid "guestfs_part_get_mbr_id" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7048 +#: ../src/guestfs-actions.pod:6844 #, no-wrap msgid "" " int\n" @@ -36728,7 +36225,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7056 ../src/guestfs-actions.pod:7238 +#: ../src/guestfs-actions.pod:6852 ../src/guestfs-actions.pod:7034 msgid "" "Note that only MBR (old DOS-style) partitions have type bytes. You will get " "undefined results for other partition table types (see " @@ -36736,12 +36233,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7064 +#: ../src/guestfs-actions.pod:6860 msgid "guestfs_part_get_parttype" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7066 +#: ../src/guestfs-actions.pod:6862 #, no-wrap msgid "" " char *\n" @@ -36751,7 +36248,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7073 +#: ../src/guestfs-actions.pod:6869 msgid "" "Common return values include: C<msdos> (a DOS/Windows style MBR partition " "table), C<gpt> (a GPT/EFI-style partition table). Other values are " @@ -36759,12 +36256,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7083 +#: ../src/guestfs-actions.pod:6879 msgid "guestfs_part_init" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7085 +#: ../src/guestfs-actions.pod:6881 #, no-wrap msgid "" " int\n" @@ -36775,19 +36272,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7094 +#: ../src/guestfs-actions.pod:6890 msgid "" "Initially there are no partitions. Following this, you should call " "C<guestfs_part_add> for each partition required." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7167 +#: ../src/guestfs-actions.pod:6963 msgid "guestfs_part_list" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7169 +#: ../src/guestfs-actions.pod:6965 #, no-wrap msgid "" " struct guestfs_partition_list *\n" @@ -36797,14 +36294,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7186 +#: ../src/guestfs-actions.pod:6982 msgid "" "Start of the partition I<in bytes>. To get sectors you have to divide by " "the device's sector size, see C<guestfs_blockdev_getss>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7199 +#: ../src/guestfs-actions.pod:6995 msgid "" "This function returns a C<struct guestfs_partition_list *>, or NULL if there " "was an error. I<The caller must call C<guestfs_free_partition_list> after " @@ -36812,12 +36309,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7205 +#: ../src/guestfs-actions.pod:7001 msgid "guestfs_part_set_bootable" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7207 +#: ../src/guestfs-actions.pod:7003 #, no-wrap msgid "" " int\n" @@ -36829,12 +36326,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7224 +#: ../src/guestfs-actions.pod:7020 msgid "guestfs_part_set_mbr_id" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7226 +#: ../src/guestfs-actions.pod:7022 #, no-wrap msgid "" " int\n" @@ -36846,12 +36343,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7246 +#: ../src/guestfs-actions.pod:7042 msgid "guestfs_part_set_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7248 +#: ../src/guestfs-actions.pod:7044 #, no-wrap msgid "" " int\n" @@ -36863,12 +36360,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7264 +#: ../src/guestfs-actions.pod:7060 msgid "guestfs_part_to_dev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7266 +#: ../src/guestfs-actions.pod:7062 #, no-wrap msgid "" " char *\n" @@ -36878,24 +36375,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7274 ../src/guestfs-actions.pod:7293 +#: ../src/guestfs-actions.pod:7070 ../src/guestfs-actions.pod:7089 msgid "" "The named partition must exist, for example as a string returned from " "C<guestfs_list_partitions>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7277 +#: ../src/guestfs-actions.pod:7073 msgid "See also C<guestfs_part_to_partnum>, C<guestfs_device_index>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7284 +#: ../src/guestfs-actions.pod:7080 msgid "guestfs_part_to_partnum" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7286 +#: ../src/guestfs-actions.pod:7082 #, no-wrap msgid "" " int\n" @@ -36905,17 +36402,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7296 +#: ../src/guestfs-actions.pod:7092 msgid "See also C<guestfs_part_to_dev>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7302 +#: ../src/guestfs-actions.pod:7098 msgid "guestfs_ping_daemon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7304 +#: ../src/guestfs-actions.pod:7100 #, no-wrap msgid "" " int\n" @@ -36924,12 +36421,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7316 +#: ../src/guestfs-actions.pod:7112 msgid "guestfs_pread" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7318 +#: ../src/guestfs-actions.pod:7114 #, no-wrap msgid "" " char *\n" @@ -36942,17 +36439,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7331 +#: ../src/guestfs-actions.pod:7127 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7342 +#: ../src/guestfs-actions.pod:7138 msgid "guestfs_pread_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7344 +#: ../src/guestfs-actions.pod:7140 #, no-wrap msgid "" " char *\n" @@ -36965,51 +36462,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7357 +#: ../src/guestfs-actions.pod:7153 msgid "See also C<guestfs_pread>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7366 +#: ../src/guestfs-actions.pod:7162 msgid "(Added in 1.5.21)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7368 -msgid "guestfs_pvchange_uuid" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:7370 -#, no-wrap -msgid "" -" int\n" -" guestfs_pvchange_uuid (guestfs_h *g,\n" -" const char *device);\n" -"\n" -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:7378 -msgid "guestfs_pvchange_uuid_all" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:7380 -#, no-wrap -msgid "" -" int\n" -" guestfs_pvchange_uuid_all (guestfs_h *g);\n" -"\n" -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:7387 +#: ../src/guestfs-actions.pod:7164 msgid "guestfs_pvcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7389 +#: ../src/guestfs-actions.pod:7166 #, no-wrap msgid "" " int\n" @@ -37019,12 +36487,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7401 +#: ../src/guestfs-actions.pod:7178 msgid "guestfs_pvremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7403 +#: ../src/guestfs-actions.pod:7180 #, no-wrap msgid "" " int\n" @@ -37034,12 +36502,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7418 +#: ../src/guestfs-actions.pod:7195 msgid "guestfs_pvresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7420 +#: ../src/guestfs-actions.pod:7197 #, no-wrap msgid "" " int\n" @@ -37049,12 +36517,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7431 +#: ../src/guestfs-actions.pod:7208 msgid "guestfs_pvresize_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7433 +#: ../src/guestfs-actions.pod:7210 #, no-wrap msgid "" " int\n" @@ -37065,19 +36533,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7438 +#: ../src/guestfs-actions.pod:7215 msgid "" "This command is the same as C<guestfs_pvresize> except that it allows you to " "specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7445 +#: ../src/guestfs-actions.pod:7222 msgid "guestfs_pvs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7447 +#: ../src/guestfs-actions.pod:7224 #, no-wrap msgid "" " char **\n" @@ -37086,17 +36554,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7456 +#: ../src/guestfs-actions.pod:7233 msgid "See also C<guestfs_pvs_full>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7464 +#: ../src/guestfs-actions.pod:7241 msgid "guestfs_pvs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7466 +#: ../src/guestfs-actions.pod:7243 #, no-wrap msgid "" " struct guestfs_lvm_pv_list *\n" @@ -37105,7 +36573,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7472 +#: ../src/guestfs-actions.pod:7249 msgid "" "This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there " "was an error. I<The caller must call C<guestfs_free_lvm_pv_list> after " @@ -37113,12 +36581,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7478 +#: ../src/guestfs-actions.pod:7255 msgid "guestfs_pvuuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7480 +#: ../src/guestfs-actions.pod:7257 #, no-wrap msgid "" " char *\n" @@ -37128,12 +36596,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7491 +#: ../src/guestfs-actions.pod:7268 msgid "guestfs_pwrite" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7493 +#: ../src/guestfs-actions.pod:7270 #, no-wrap msgid "" " int\n" @@ -37146,17 +36614,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7509 +#: ../src/guestfs-actions.pod:7286 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7518 +#: ../src/guestfs-actions.pod:7295 msgid "guestfs_pwrite_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7520 +#: ../src/guestfs-actions.pod:7297 #, no-wrap msgid "" " int\n" @@ -37169,22 +36637,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7535 +#: ../src/guestfs-actions.pod:7312 msgid "See also C<guestfs_pwrite>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7542 +#: ../src/guestfs-actions.pod:7319 msgid "(Added in 1.5.20)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7544 +#: ../src/guestfs-actions.pod:7321 msgid "guestfs_read_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7546 +#: ../src/guestfs-actions.pod:7323 #, no-wrap msgid "" " char *\n" @@ -37195,7 +36663,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7554 +#: ../src/guestfs-actions.pod:7331 msgid "" "Unlike C<guestfs_cat>, this function can correctly handle files that contain " "embedded ASCII NUL characters. However unlike C<guestfs_download>, this " @@ -37203,17 +36671,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7566 +#: ../src/guestfs-actions.pod:7343 msgid "(Added in 1.0.63)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7568 +#: ../src/guestfs-actions.pod:7345 msgid "guestfs_read_lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7570 +#: ../src/guestfs-actions.pod:7347 #, no-wrap msgid "" " char **\n" @@ -37223,7 +36691,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7579 +#: ../src/guestfs-actions.pod:7356 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of line). For " @@ -37232,12 +36700,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7590 +#: ../src/guestfs-actions.pod:7367 msgid "guestfs_readdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7592 +#: ../src/guestfs-actions.pod:7369 #, no-wrap msgid "" " struct guestfs_dirent_list *\n" @@ -37247,7 +36715,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7646 +#: ../src/guestfs-actions.pod:7423 msgid "" "This function is primarily intended for use by programs. To get a simple " "list of names, use C<guestfs_ls>. To get a printable directory for human " @@ -37255,7 +36723,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7650 +#: ../src/guestfs-actions.pod:7427 msgid "" "This function returns a C<struct guestfs_dirent_list *>, or NULL if there " "was an error. I<The caller must call C<guestfs_free_dirent_list> after " @@ -37263,12 +36731,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7656 +#: ../src/guestfs-actions.pod:7433 msgid "guestfs_readlink" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7658 +#: ../src/guestfs-actions.pod:7435 #, no-wrap msgid "" " char *\n" @@ -37278,12 +36746,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7669 +#: ../src/guestfs-actions.pod:7446 msgid "guestfs_readlinklist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7671 +#: ../src/guestfs-actions.pod:7448 #, no-wrap msgid "" " char **\n" @@ -37294,12 +36762,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7704 +#: ../src/guestfs-actions.pod:7481 msgid "guestfs_realpath" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7706 +#: ../src/guestfs-actions.pod:7483 #, no-wrap msgid "" " char *\n" @@ -37309,12 +36777,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7718 +#: ../src/guestfs-actions.pod:7495 msgid "guestfs_removexattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7720 +#: ../src/guestfs-actions.pod:7497 #, no-wrap msgid "" " int\n" @@ -37325,17 +36793,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7728 +#: ../src/guestfs-actions.pod:7505 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7734 +#: ../src/guestfs-actions.pod:7511 msgid "guestfs_resize2fs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7736 +#: ../src/guestfs-actions.pod:7513 #, no-wrap msgid "" " int\n" @@ -37345,12 +36813,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7749 +#: ../src/guestfs-actions.pod:7526 msgid "guestfs_resize2fs_M" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7751 +#: ../src/guestfs-actions.pod:7528 #, no-wrap msgid "" " int\n" @@ -37360,7 +36828,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7755 +#: ../src/guestfs-actions.pod:7532 msgid "" "This command is the same as C<guestfs_resize2fs>, but the filesystem is " "resized to its minimum size. This works like the I<-M> option to the " @@ -37368,7 +36836,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7759 +#: ../src/guestfs-actions.pod:7536 msgid "" "To get the resulting size of the filesystem you should call " "C<guestfs_tune2fs_l> and read the C<Block size> and C<Block count> values. " @@ -37377,12 +36845,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7770 +#: ../src/guestfs-actions.pod:7547 msgid "guestfs_resize2fs_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7772 +#: ../src/guestfs-actions.pod:7549 #, no-wrap msgid "" " int\n" @@ -37393,19 +36861,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7777 +#: ../src/guestfs-actions.pod:7554 msgid "" "This command is the same as C<guestfs_resize2fs> except that it allows you " "to specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7786 +#: ../src/guestfs-actions.pod:7563 msgid "guestfs_rm" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7788 +#: ../src/guestfs-actions.pod:7565 #, no-wrap msgid "" " int\n" @@ -37415,12 +36883,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7798 +#: ../src/guestfs-actions.pod:7575 msgid "guestfs_rm_rf" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7800 +#: ../src/guestfs-actions.pod:7577 #, no-wrap msgid "" " int\n" @@ -37430,12 +36898,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7812 +#: ../src/guestfs-actions.pod:7589 msgid "guestfs_rmdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7814 +#: ../src/guestfs-actions.pod:7591 #, no-wrap msgid "" " int\n" @@ -37445,12 +36913,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7824 +#: ../src/guestfs-actions.pod:7601 msgid "guestfs_rmmountpoint" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7826 +#: ../src/guestfs-actions.pod:7603 #, no-wrap msgid "" " int\n" @@ -37460,19 +36928,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7830 +#: ../src/guestfs-actions.pod:7607 msgid "" "This calls removes a mountpoint that was previously created with " "C<guestfs_mkmountpoint>. See C<guestfs_mkmountpoint> for full details." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7838 +#: ../src/guestfs-actions.pod:7615 msgid "guestfs_scrub_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7840 +#: ../src/guestfs-actions.pod:7617 #, no-wrap msgid "" " int\n" @@ -37482,17 +36950,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7852 ../src/guestfs-actions.pod:7870 ../src/guestfs-actions.pod:7889 +#: ../src/guestfs-actions.pod:7629 ../src/guestfs-actions.pod:7647 ../src/guestfs-actions.pod:7666 msgid "(Added in 1.0.52)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7854 +#: ../src/guestfs-actions.pod:7631 msgid "guestfs_scrub_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7856 +#: ../src/guestfs-actions.pod:7633 #, no-wrap msgid "" " int\n" @@ -37502,12 +36970,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7872 +#: ../src/guestfs-actions.pod:7649 msgid "guestfs_scrub_freespace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7874 +#: ../src/guestfs-actions.pod:7651 #, no-wrap msgid "" " int\n" @@ -37517,7 +36985,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7878 +#: ../src/guestfs-actions.pod:7655 msgid "" "This command creates the directory C<dir> and then fills it with files until " "the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, " @@ -37526,12 +36994,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7891 +#: ../src/guestfs-actions.pod:7668 msgid "guestfs_set_append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7893 +#: ../src/guestfs-actions.pod:7670 #, no-wrap msgid "" " int\n" @@ -37541,12 +37009,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7910 +#: ../src/guestfs-actions.pod:7687 msgid "guestfs_set_attach_method" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7912 +#: ../src/guestfs-actions.pod:7689 #, no-wrap msgid "" " int\n" @@ -37556,12 +37024,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7973 +#: ../src/guestfs-actions.pod:7717 msgid "guestfs_set_autosync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7975 +#: ../src/guestfs-actions.pod:7719 #, no-wrap msgid "" " int\n" @@ -37571,12 +37039,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7991 +#: ../src/guestfs-actions.pod:7735 msgid "guestfs_set_direct" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7993 +#: ../src/guestfs-actions.pod:7737 #, no-wrap msgid "" " int\n" @@ -37586,7 +37054,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8001 +#: ../src/guestfs-actions.pod:7745 msgid "" "One consequence of this is that log messages aren't caught by the library " "and handled by C<guestfs_set_log_message_callback>, but go straight to " @@ -37594,12 +37062,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8014 +#: ../src/guestfs-actions.pod:7758 msgid "guestfs_set_e2attrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8016 +#: ../src/guestfs-actions.pod:7760 #, no-wrap msgid "" " int\n" @@ -37611,7 +37079,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8027 +#: ../src/guestfs-actions.pod:7771 #, no-wrap msgid "" " GUESTFS_SET_E2ATTRS_CLEAR, int clear,\n" @@ -37619,7 +37087,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8032 +#: ../src/guestfs-actions.pod:7776 msgid "" "C<attrs> is a string of characters representing file attributes. See " "C<guestfs_get_e2attrs> for a list of possible attributes. Not all " @@ -37627,12 +37095,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8053 +#: ../src/guestfs-actions.pod:7797 msgid "guestfs_set_e2attrs_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8055 +#: ../src/guestfs-actions.pod:7799 #, no-wrap msgid "" " int\n" @@ -37644,17 +37112,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8061 +#: ../src/guestfs-actions.pod:7805 msgid "This is the \"va_list variant\" of L</guestfs_set_e2attrs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8065 +#: ../src/guestfs-actions.pod:7809 msgid "guestfs_set_e2attrs_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8067 +#: ../src/guestfs-actions.pod:7811 #, no-wrap msgid "" " int\n" @@ -37667,17 +37135,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8073 +#: ../src/guestfs-actions.pod:7817 msgid "This is the \"argv variant\" of L</guestfs_set_e2attrs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8077 +#: ../src/guestfs-actions.pod:7821 msgid "guestfs_set_e2generation" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8079 +#: ../src/guestfs-actions.pod:7823 #, no-wrap msgid "" " int\n" @@ -37688,17 +37156,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8086 +#: ../src/guestfs-actions.pod:7830 msgid "See C<guestfs_get_e2generation>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8092 +#: ../src/guestfs-actions.pod:7836 msgid "guestfs_set_e2label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8094 +#: ../src/guestfs-actions.pod:7838 #, no-wrap msgid "" " int\n" @@ -37709,26 +37177,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8099 +#: ../src/guestfs-actions.pod:7843 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_set_label> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8110 +#: ../src/guestfs-actions.pod:7854 msgid "" "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return " "the existing label on a filesystem." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8117 +#: ../src/guestfs-actions.pod:7861 msgid "guestfs_set_e2uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8119 +#: ../src/guestfs-actions.pod:7863 #, no-wrap msgid "" " int\n" @@ -37739,19 +37207,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8129 +#: ../src/guestfs-actions.pod:7873 msgid "" "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return " "the existing UUID of a filesystem." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8136 +#: ../src/guestfs-actions.pod:7880 msgid "guestfs_set_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8138 +#: ../src/guestfs-actions.pod:7882 #, no-wrap msgid "" " int\n" @@ -37762,17 +37230,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8152 +#: ../src/guestfs-actions.pod:7896 msgid "To read the label on a filesystem, call C<guestfs_vfs_label>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8158 +#: ../src/guestfs-actions.pod:7902 msgid "guestfs_set_memsize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8160 +#: ../src/guestfs-actions.pod:7904 #, no-wrap msgid "" " int\n" @@ -37782,19 +37250,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8164 +#: ../src/guestfs-actions.pod:7908 msgid "" "This sets the memory size in megabytes allocated to the qemu subprocess. " "This only has any effect if called before C<guestfs_launch>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8179 +#: ../src/guestfs-actions.pod:7923 msgid "guestfs_set_network" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8181 +#: ../src/guestfs-actions.pod:7925 #, no-wrap msgid "" " int\n" @@ -37804,19 +37272,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8191 +#: ../src/guestfs-actions.pod:7935 msgid "" "You must call this before calling C<guestfs_launch>, otherwise it has no " "effect." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8198 +#: ../src/guestfs-actions.pod:7942 msgid "guestfs_set_path" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8200 +#: ../src/guestfs-actions.pod:7944 #, no-wrap msgid "" " int\n" @@ -37826,12 +37294,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8215 +#: ../src/guestfs-actions.pod:7959 msgid "guestfs_set_pgroup" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8217 +#: ../src/guestfs-actions.pod:7961 #, no-wrap msgid "" " int\n" @@ -37841,7 +37309,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8227 +#: ../src/guestfs-actions.pod:7971 msgid "" "The default for this flag is false, because usually you want C<^C> to kill " "the subprocess. Guestfish sets this flag to true when used interactively, " @@ -37850,12 +37318,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8236 +#: ../src/guestfs-actions.pod:7980 msgid "guestfs_set_qemu" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8238 +#: ../src/guestfs-actions.pod:7982 #, no-wrap msgid "" " int\n" @@ -37865,12 +37333,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8264 +#: ../src/guestfs-actions.pod:8008 msgid "guestfs_set_recovery_proc" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8266 +#: ../src/guestfs-actions.pod:8010 #, no-wrap msgid "" " int\n" @@ -37880,7 +37348,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8270 +#: ../src/guestfs-actions.pod:8014 msgid "" "If this is called with the parameter C<false> then C<guestfs_launch> does " "not create a recovery process. The purpose of the recovery process is to " @@ -37889,19 +37357,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8275 +#: ../src/guestfs-actions.pod:8019 msgid "" "This only has any effect if called before C<guestfs_launch>, and the default " "is true." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8288 +#: ../src/guestfs-actions.pod:8032 msgid "guestfs_set_selinux" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8290 +#: ../src/guestfs-actions.pod:8034 #, no-wrap msgid "" " int\n" @@ -37911,12 +37379,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8307 +#: ../src/guestfs-actions.pod:8051 msgid "guestfs_set_smp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8309 +#: ../src/guestfs-actions.pod:8053 #, no-wrap msgid "" " int\n" @@ -37926,17 +37394,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8317 +#: ../src/guestfs-actions.pod:8061 msgid "This function must be called before C<guestfs_launch>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8323 +#: ../src/guestfs-actions.pod:8067 msgid "guestfs_set_trace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8325 +#: ../src/guestfs-actions.pod:8069 #, no-wrap msgid "" " int\n" @@ -37946,19 +37414,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8339 +#: ../src/guestfs-actions.pod:8083 msgid "" "Trace messages are normally sent to C<stderr>, unless you register a " "callback to send them somewhere else (see C<guestfs_set_event_callback>)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8347 +#: ../src/guestfs-actions.pod:8091 msgid "guestfs_set_verbose" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8349 +#: ../src/guestfs-actions.pod:8093 #, no-wrap msgid "" " int\n" @@ -37968,19 +37436,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8358 +#: ../src/guestfs-actions.pod:8102 msgid "" "Verbose messages are normally sent to C<stderr>, unless you register a " "callback to send them somewhere else (see C<guestfs_set_event_callback>)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8366 +#: ../src/guestfs-actions.pod:8110 msgid "guestfs_setcon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8368 +#: ../src/guestfs-actions.pod:8112 #, no-wrap msgid "" " int\n" @@ -37990,12 +37458,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8381 +#: ../src/guestfs-actions.pod:8125 msgid "guestfs_setxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8383 +#: ../src/guestfs-actions.pod:8127 #, no-wrap msgid "" " int\n" @@ -38008,17 +37476,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8394 +#: ../src/guestfs-actions.pod:8138 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8400 +#: ../src/guestfs-actions.pod:8144 msgid "guestfs_sfdisk" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8402 +#: ../src/guestfs-actions.pod:8146 #, no-wrap msgid "" " int\n" @@ -38032,24 +37500,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8410 ../src/guestfs-actions.pod:8451 ../src/guestfs-actions.pod:8482 +#: ../src/guestfs-actions.pod:8154 ../src/guestfs-actions.pod:8195 ../src/guestfs-actions.pod:8226 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_part_add> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8437 +#: ../src/guestfs-actions.pod:8181 msgid "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8444 +#: ../src/guestfs-actions.pod:8188 msgid "guestfs_sfdiskM" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8446 +#: ../src/guestfs-actions.pod:8190 #, no-wrap msgid "" " int\n" @@ -38060,7 +37528,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8458 +#: ../src/guestfs-actions.pod:8202 msgid "" "This is a simplified interface to the C<guestfs_sfdisk> command, where " "partition sizes are specified in megabytes only (rounded to the nearest " @@ -38069,19 +37537,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8464 +#: ../src/guestfs-actions.pod:8208 msgid "" "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and " "C<guestfs_part_disk>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8471 +#: ../src/guestfs-actions.pod:8215 msgid "guestfs_sfdisk_N" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8473 +#: ../src/guestfs-actions.pod:8217 #, no-wrap msgid "" " int\n" @@ -38096,24 +37564,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8492 +#: ../src/guestfs-actions.pod:8236 msgid "" "For other parameters, see C<guestfs_sfdisk>. You should usually pass C<0> " "for the cyls/heads/sectors parameters." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8495 +#: ../src/guestfs-actions.pod:8239 msgid "See also: C<guestfs_part_add>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8501 +#: ../src/guestfs-actions.pod:8245 msgid "guestfs_sfdisk_disk_geometry" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8503 +#: ../src/guestfs-actions.pod:8247 #, no-wrap msgid "" " char *\n" @@ -38123,7 +37591,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8507 +#: ../src/guestfs-actions.pod:8251 msgid "" "This displays the disk geometry of C<device> read from the partition table. " "Especially in the case where the underlying block device has been resized, " @@ -38132,12 +37600,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8520 +#: ../src/guestfs-actions.pod:8264 msgid "guestfs_sfdisk_kernel_geometry" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8522 +#: ../src/guestfs-actions.pod:8266 #, no-wrap msgid "" " char *\n" @@ -38147,12 +37615,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8536 +#: ../src/guestfs-actions.pod:8280 msgid "guestfs_sfdisk_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8538 +#: ../src/guestfs-actions.pod:8282 #, no-wrap msgid "" " char *\n" @@ -38162,24 +37630,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8542 +#: ../src/guestfs-actions.pod:8286 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_part_list> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8553 +#: ../src/guestfs-actions.pod:8297 msgid "See also: C<guestfs_part_list>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8560 +#: ../src/guestfs-actions.pod:8304 msgid "guestfs_sh" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8562 +#: ../src/guestfs-actions.pod:8306 #, no-wrap msgid "" " char *\n" @@ -38189,22 +37657,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8569 +#: ../src/guestfs-actions.pod:8313 msgid "This is like C<guestfs_command>, but passes the command to:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8577 +#: ../src/guestfs-actions.pod:8321 msgid "All the provisos about C<guestfs_command> apply to this call." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8584 +#: ../src/guestfs-actions.pod:8328 msgid "guestfs_sh_lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8586 +#: ../src/guestfs-actions.pod:8330 #, no-wrap msgid "" " char **\n" @@ -38214,24 +37682,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8590 +#: ../src/guestfs-actions.pod:8334 msgid "" "This is the same as C<guestfs_sh>, but splits the result into a list of " "lines." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8593 +#: ../src/guestfs-actions.pod:8337 msgid "See also: C<guestfs_command_lines>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8601 +#: ../src/guestfs-actions.pod:8345 msgid "guestfs_shutdown" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8603 +#: ../src/guestfs-actions.pod:8347 #, no-wrap msgid "" " int\n" @@ -38240,7 +37708,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8606 +#: ../src/guestfs-actions.pod:8350 msgid "" "This is the opposite of C<guestfs_launch>. It performs an orderly shutdown " "of the backend process(es). If the autosync flag is set (which is the " @@ -38248,26 +37716,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8616 +#: ../src/guestfs-actions.pod:8360 msgid "" "This call does I<not> close or free up the handle. You still need to call " "C<guestfs_close> afterwards." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8619 +#: ../src/guestfs-actions.pod:8363 msgid "" "C<guestfs_close> will call this if you don't do it explicitly, but note that " "any errors are ignored in that case." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8624 +#: ../src/guestfs-actions.pod:8368 msgid "guestfs_sleep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8626 +#: ../src/guestfs-actions.pod:8370 #, no-wrap msgid "" " int\n" @@ -38277,17 +37745,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8634 +#: ../src/guestfs-actions.pod:8378 msgid "(Added in 1.0.41)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8636 ../src/guestfs-structs.pod:109 +#: ../src/guestfs-actions.pod:8380 ../src/guestfs-structs.pod:109 msgid "guestfs_stat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8638 +#: ../src/guestfs-actions.pod:8382 #, no-wrap msgid "" " struct guestfs_stat *\n" @@ -38297,12 +37765,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8652 ../src/guestfs-structs.pod:135 +#: ../src/guestfs-actions.pod:8396 ../src/guestfs-structs.pod:135 msgid "guestfs_statvfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8654 +#: ../src/guestfs-actions.pod:8398 #, no-wrap msgid "" " struct guestfs_statvfs *\n" @@ -38312,19 +37780,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8664 +#: ../src/guestfs-actions.pod:8408 msgid "" "This function returns a C<struct guestfs_statvfs *>, or NULL if there was an " "error. I<The caller must call C<guestfs_free_statvfs> after use>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8670 +#: ../src/guestfs-actions.pod:8414 msgid "guestfs_strings" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8672 +#: ../src/guestfs-actions.pod:8416 #, no-wrap msgid "" " char **\n" @@ -38334,12 +37802,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8688 +#: ../src/guestfs-actions.pod:8432 msgid "guestfs_strings_e" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8690 +#: ../src/guestfs-actions.pod:8434 #, no-wrap msgid "" " char **\n" @@ -38350,26 +37818,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8695 +#: ../src/guestfs-actions.pod:8439 msgid "" "This is like the C<guestfs_strings> command, but allows you to specify the " "encoding of strings that are looked for in the source file C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8705 +#: ../src/guestfs-actions.pod:8449 msgid "" "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of " "ISO-8859-X (this is what C<guestfs_strings> uses)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8743 +#: ../src/guestfs-actions.pod:8487 msgid "guestfs_swapoff_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8745 +#: ../src/guestfs-actions.pod:8489 #, no-wrap msgid "" " int\n" @@ -38379,19 +37847,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8749 +#: ../src/guestfs-actions.pod:8493 msgid "" "This command disables the libguestfs appliance swap device or partition " "named C<device>. See C<guestfs_swapon_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8757 +#: ../src/guestfs-actions.pod:8501 msgid "guestfs_swapoff_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8759 +#: ../src/guestfs-actions.pod:8503 #, no-wrap msgid "" " int\n" @@ -38401,12 +37869,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8769 +#: ../src/guestfs-actions.pod:8513 msgid "guestfs_swapoff_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8771 +#: ../src/guestfs-actions.pod:8515 #, no-wrap msgid "" " int\n" @@ -38416,12 +37884,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8782 +#: ../src/guestfs-actions.pod:8526 msgid "guestfs_swapoff_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8784 +#: ../src/guestfs-actions.pod:8528 #, no-wrap msgid "" " int\n" @@ -38431,12 +37899,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8795 +#: ../src/guestfs-actions.pod:8539 msgid "guestfs_swapon_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8797 +#: ../src/guestfs-actions.pod:8541 #, no-wrap msgid "" " int\n" @@ -38446,7 +37914,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8801 +#: ../src/guestfs-actions.pod:8545 msgid "" "This command enables the libguestfs appliance to use the swap device or " "partition named C<device>. The increased memory is made available for all " @@ -38454,12 +37922,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8817 +#: ../src/guestfs-actions.pod:8561 msgid "guestfs_swapon_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8819 +#: ../src/guestfs-actions.pod:8563 #, no-wrap msgid "" " int\n" @@ -38469,19 +37937,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8823 +#: ../src/guestfs-actions.pod:8567 msgid "" "This command enables swap to a file. See C<guestfs_swapon_device> for other " "notes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8830 +#: ../src/guestfs-actions.pod:8574 msgid "guestfs_swapon_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8832 +#: ../src/guestfs-actions.pod:8576 #, no-wrap msgid "" " int\n" @@ -38491,19 +37959,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8836 +#: ../src/guestfs-actions.pod:8580 msgid "" "This command enables swap to a labeled swap partition. See " "C<guestfs_swapon_device> for other notes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8843 +#: ../src/guestfs-actions.pod:8587 msgid "guestfs_swapon_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8845 +#: ../src/guestfs-actions.pod:8589 #, no-wrap msgid "" " int\n" @@ -38513,19 +37981,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8849 +#: ../src/guestfs-actions.pod:8593 msgid "" "This command enables swap to a swap partition with the given UUID. See " "C<guestfs_swapon_device> for other notes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8856 +#: ../src/guestfs-actions.pod:8600 msgid "guestfs_sync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8858 +#: ../src/guestfs-actions.pod:8602 #, no-wrap msgid "" " int\n" @@ -38534,12 +38002,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8871 +#: ../src/guestfs-actions.pod:8615 msgid "guestfs_tail" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8873 +#: ../src/guestfs-actions.pod:8617 #, no-wrap msgid "" " char **\n" @@ -38549,12 +38017,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8889 +#: ../src/guestfs-actions.pod:8633 msgid "guestfs_tail_n" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8891 +#: ../src/guestfs-actions.pod:8635 #, no-wrap msgid "" " char **\n" @@ -38565,12 +38033,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8913 +#: ../src/guestfs-actions.pod:8657 msgid "guestfs_tar_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8915 +#: ../src/guestfs-actions.pod:8659 #, no-wrap msgid "" " int\n" @@ -38581,22 +38049,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8923 +#: ../src/guestfs-actions.pod:8667 msgid "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8928 ../src/guestfs-actions.pod:8945 ../src/guestfs-actions.pod:8961 ../src/guestfs-actions.pod:8977 +#: ../src/guestfs-actions.pod:8672 ../src/guestfs-actions.pod:8689 ../src/guestfs-actions.pod:8705 ../src/guestfs-actions.pod:8721 msgid "(Added in 1.0.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8930 +#: ../src/guestfs-actions.pod:8674 msgid "guestfs_tar_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8932 +#: ../src/guestfs-actions.pod:8676 #, no-wrap msgid "" " int\n" @@ -38607,19 +38075,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8940 +#: ../src/guestfs-actions.pod:8684 msgid "" "To download a compressed tarball, use C<guestfs_tgz_out> or " "C<guestfs_txz_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8947 +#: ../src/guestfs-actions.pod:8691 msgid "guestfs_tgz_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8949 +#: ../src/guestfs-actions.pod:8693 #, no-wrap msgid "" " int\n" @@ -38630,17 +38098,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8957 +#: ../src/guestfs-actions.pod:8701 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8963 +#: ../src/guestfs-actions.pod:8707 msgid "guestfs_tgz_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8965 +#: ../src/guestfs-actions.pod:8709 #, no-wrap msgid "" " int\n" @@ -38651,17 +38119,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8973 +#: ../src/guestfs-actions.pod:8717 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8979 +#: ../src/guestfs-actions.pod:8723 msgid "guestfs_touch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8981 +#: ../src/guestfs-actions.pod:8725 #, no-wrap msgid "" " int\n" @@ -38671,12 +38139,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8996 +#: ../src/guestfs-actions.pod:8740 msgid "guestfs_truncate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8998 +#: ../src/guestfs-actions.pod:8742 #, no-wrap msgid "" " int\n" @@ -38686,12 +38154,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9009 +#: ../src/guestfs-actions.pod:8753 msgid "guestfs_truncate_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9011 +#: ../src/guestfs-actions.pod:8755 #, no-wrap msgid "" " int\n" @@ -38702,7 +38170,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9019 +#: ../src/guestfs-actions.pod:8763 msgid "" "If the current file size is less than C<size> then the file is extended to " "the required size with zero bytes. This creates a sparse file (ie. disk " @@ -38711,12 +38179,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9029 +#: ../src/guestfs-actions.pod:8773 msgid "guestfs_tune2fs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9031 +#: ../src/guestfs-actions.pod:8775 #, no-wrap msgid "" " int\n" @@ -38727,7 +38195,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9041 +#: ../src/guestfs-actions.pod:8785 #, no-wrap msgid "" " GUESTFS_TUNE2FS_FORCE, int force,\n" @@ -38744,7 +38212,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9121 +#: ../src/guestfs-actions.pod:8865 msgid "" "To get the current values of filesystem parameters, see " "C<guestfs_tune2fs_l>. For precise details of how tune2fs works, see the " @@ -38752,12 +38220,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9129 +#: ../src/guestfs-actions.pod:8873 msgid "guestfs_tune2fs_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9131 +#: ../src/guestfs-actions.pod:8875 #, no-wrap msgid "" " int\n" @@ -38768,17 +38236,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9136 +#: ../src/guestfs-actions.pod:8880 msgid "This is the \"va_list variant\" of L</guestfs_tune2fs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9140 +#: ../src/guestfs-actions.pod:8884 msgid "guestfs_tune2fs_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9142 +#: ../src/guestfs-actions.pod:8886 #, no-wrap msgid "" " int\n" @@ -38789,17 +38257,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9147 +#: ../src/guestfs-actions.pod:8891 msgid "This is the \"argv variant\" of L</guestfs_tune2fs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9151 +#: ../src/guestfs-actions.pod:8895 msgid "guestfs_tune2fs_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9153 +#: ../src/guestfs-actions.pod:8897 #, no-wrap msgid "" " char **\n" @@ -38809,12 +38277,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9173 +#: ../src/guestfs-actions.pod:8917 msgid "guestfs_txz_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9175 +#: ../src/guestfs-actions.pod:8919 #, no-wrap msgid "" " int\n" @@ -38825,12 +38293,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9187 +#: ../src/guestfs-actions.pod:8931 msgid "guestfs_txz_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9189 +#: ../src/guestfs-actions.pod:8933 #, no-wrap msgid "" " int\n" @@ -38841,12 +38309,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9201 +#: ../src/guestfs-actions.pod:8945 msgid "guestfs_umask" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9203 +#: ../src/guestfs-actions.pod:8947 #, no-wrap msgid "" " int\n" @@ -38856,19 +38324,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9219 +#: ../src/guestfs-actions.pod:8963 msgid "" "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, " "C<guestfs_mkdir>." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:9228 -msgid "= head2 guestfs_umount" +#. type: =head2 +#: ../src/guestfs-actions.pod:8972 +msgid "guestfs_umount" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9230 +#: ../src/guestfs-actions.pod:8974 #, no-wrap msgid "" " int\n" @@ -38877,89 +38345,13 @@ msgid "" "\n" msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:9234 -msgid "" -"This function is provided for backwards compatibility with earlier versions " -"of libguestfs. It simply calls L</guestfs_umount_opts> with no optional " -"arguments." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:9241 -msgid "guestfs_umount_opts" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:9243 -#, no-wrap -msgid "" -" int\n" -" guestfs_umount_opts (guestfs_h *g,\n" -" const char *pathordevice,\n" -" ...);\n" -"\n" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:9253 -#, no-wrap -msgid "" -" GUESTFS_UMOUNT_OPTS_FORCE, int force,\n" -" GUESTFS_UMOUNT_OPTS_LAZYUNMOUNT, int lazyunmount,\n" -"\n" -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:9262 -msgid "guestfs_umount_opts_va" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:9264 -#, no-wrap -msgid "" -" int\n" -" guestfs_umount_opts_va (guestfs_h *g,\n" -" const char *pathordevice,\n" -" va_list args);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:9269 -msgid "This is the \"va_list variant\" of L</guestfs_umount_opts>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:9273 -msgid "guestfs_umount_opts_argv" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:9275 -#, no-wrap -msgid "" -" int\n" -" guestfs_umount_opts_argv (guestfs_h *g,\n" -" const char *pathordevice,\n" -" const struct guestfs_umount_opts_argv " -"*optargs);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:9280 -msgid "This is the \"argv variant\" of L</guestfs_umount_opts>." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:9284 +#: ../src/guestfs-actions.pod:8986 msgid "guestfs_umount_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9286 +#: ../src/guestfs-actions.pod:8988 #, no-wrap msgid "" " int\n" @@ -38968,12 +38360,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9297 +#: ../src/guestfs-actions.pod:8999 msgid "guestfs_umount_local" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9299 +#: ../src/guestfs-actions.pod:9001 #, no-wrap msgid "" " int\n" @@ -38983,7 +38375,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9308 +#: ../src/guestfs-actions.pod:9010 #, no-wrap msgid "" " GUESTFS_UMOUNT_LOCAL_RETRY, int retry,\n" @@ -38991,12 +38383,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9319 +#: ../src/guestfs-actions.pod:9021 msgid "guestfs_umount_local_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9321 +#: ../src/guestfs-actions.pod:9023 #, no-wrap msgid "" " int\n" @@ -39006,17 +38398,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9325 +#: ../src/guestfs-actions.pod:9027 msgid "This is the \"va_list variant\" of L</guestfs_umount_local>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9329 +#: ../src/guestfs-actions.pod:9031 msgid "guestfs_umount_local_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9331 +#: ../src/guestfs-actions.pod:9033 #, no-wrap msgid "" " int\n" @@ -39027,17 +38419,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9335 +#: ../src/guestfs-actions.pod:9037 msgid "This is the \"argv variant\" of L</guestfs_umount_local>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9339 +#: ../src/guestfs-actions.pod:9041 msgid "guestfs_upload" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9341 +#: ../src/guestfs-actions.pod:9043 #, no-wrap msgid "" " int\n" @@ -39048,17 +38440,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9351 +#: ../src/guestfs-actions.pod:9053 msgid "See also C<guestfs_download>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9362 +#: ../src/guestfs-actions.pod:9064 msgid "guestfs_upload_offset" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9364 +#: ../src/guestfs-actions.pod:9066 #, no-wrap msgid "" " int\n" @@ -39070,7 +38462,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9380 +#: ../src/guestfs-actions.pod:9082 msgid "" "Note that there is no limit on the amount of data that can be uploaded with " "this call, unlike with C<guestfs_pwrite>, and this call always writes the " @@ -39078,17 +38470,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9385 +#: ../src/guestfs-actions.pod:9087 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9396 +#: ../src/guestfs-actions.pod:9098 msgid "guestfs_utimens" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9398 +#: ../src/guestfs-actions.pod:9100 #, no-wrap msgid "" " int\n" @@ -39102,33 +38494,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9427 ../src/guestfs-structs.pod:368 -msgid "guestfs_utsname" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:9429 -#, no-wrap -msgid "" -" struct guestfs_utsname *\n" -" guestfs_utsname (guestfs_h *g);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:9436 -msgid "" -"This function returns a C<struct guestfs_utsname *>, or NULL if there was an " -"error. I<The caller must call C<guestfs_free_utsname> after use>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:9440 ../src/guestfs-structs.pod:175 +#: ../src/guestfs-actions.pod:9129 ../src/guestfs-structs.pod:175 msgid "guestfs_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9442 +#: ../src/guestfs-actions.pod:9131 #, no-wrap msgid "" " struct guestfs_version *\n" @@ -39137,7 +38508,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9470 +#: ../src/guestfs-actions.pod:9159 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " @@ -39146,24 +38517,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9476 +#: ../src/guestfs-actions.pod:9165 msgid "" "This function returns a C<struct guestfs_version *>, or NULL if there was an " "error. I<The caller must call C<guestfs_free_version> after use>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9480 +#: ../src/guestfs-actions.pod:9169 msgid "(Added in 1.0.58)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9482 +#: ../src/guestfs-actions.pod:9171 msgid "guestfs_vfs_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9484 +#: ../src/guestfs-actions.pod:9173 #, no-wrap msgid "" " char *\n" @@ -39173,22 +38544,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9493 +#: ../src/guestfs-actions.pod:9182 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9498 ../src/guestfs-actions.pod:9535 +#: ../src/guestfs-actions.pod:9187 ../src/guestfs-actions.pod:9224 msgid "(Added in 1.3.18)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9500 +#: ../src/guestfs-actions.pod:9189 msgid "guestfs_vfs_type" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9502 +#: ../src/guestfs-actions.pod:9191 #, no-wrap msgid "" " char *\n" @@ -39198,12 +38569,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9519 +#: ../src/guestfs-actions.pod:9208 msgid "guestfs_vfs_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9521 +#: ../src/guestfs-actions.pod:9210 #, no-wrap msgid "" " char *\n" @@ -39213,17 +38584,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9530 +#: ../src/guestfs-actions.pod:9219 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9537 +#: ../src/guestfs-actions.pod:9226 msgid "guestfs_vg_activate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9539 +#: ../src/guestfs-actions.pod:9228 #, no-wrap msgid "" " int\n" @@ -39234,12 +38605,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9556 +#: ../src/guestfs-actions.pod:9245 msgid "guestfs_vg_activate_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9558 +#: ../src/guestfs-actions.pod:9247 #, no-wrap msgid "" " int\n" @@ -39249,41 +38620,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9571 -msgid "guestfs_vgchange_uuid" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:9573 -#, no-wrap -msgid "" -" int\n" -" guestfs_vgchange_uuid (guestfs_h *g,\n" -" const char *vg);\n" -"\n" -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:9581 -msgid "guestfs_vgchange_uuid_all" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:9583 -#, no-wrap -msgid "" -" int\n" -" guestfs_vgchange_uuid_all (guestfs_h *g);\n" -"\n" -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:9590 +#: ../src/guestfs-actions.pod:9260 msgid "guestfs_vgcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9592 +#: ../src/guestfs-actions.pod:9262 #, no-wrap msgid "" " int\n" @@ -39294,12 +38636,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9604 +#: ../src/guestfs-actions.pod:9274 msgid "guestfs_vglvuuids" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9606 +#: ../src/guestfs-actions.pod:9276 #, no-wrap msgid "" " char **\n" @@ -39309,24 +38651,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9613 +#: ../src/guestfs-actions.pod:9283 msgid "" "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to " "associate logical volumes and volume groups." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9616 +#: ../src/guestfs-actions.pod:9286 msgid "See also C<guestfs_vgpvuuids>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9624 +#: ../src/guestfs-actions.pod:9294 msgid "guestfs_vgmeta" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9626 +#: ../src/guestfs-actions.pod:9296 #, no-wrap msgid "" " char *\n" @@ -39337,17 +38679,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9641 +#: ../src/guestfs-actions.pod:9311 msgid "(Added in 1.17.20)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9643 +#: ../src/guestfs-actions.pod:9313 msgid "guestfs_vgpvuuids" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9645 +#: ../src/guestfs-actions.pod:9315 #, no-wrap msgid "" " char **\n" @@ -39357,24 +38699,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9652 +#: ../src/guestfs-actions.pod:9322 msgid "" "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to " "associate physical volumes and volume groups." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9655 +#: ../src/guestfs-actions.pod:9325 msgid "See also C<guestfs_vglvuuids>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9663 +#: ../src/guestfs-actions.pod:9333 msgid "guestfs_vgremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9665 +#: ../src/guestfs-actions.pod:9335 #, no-wrap msgid "" " int\n" @@ -39384,12 +38726,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9678 +#: ../src/guestfs-actions.pod:9348 msgid "guestfs_vgrename" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9680 +#: ../src/guestfs-actions.pod:9350 #, no-wrap msgid "" " int\n" @@ -39400,12 +38742,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9691 +#: ../src/guestfs-actions.pod:9361 msgid "guestfs_vgs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9693 +#: ../src/guestfs-actions.pod:9363 #, no-wrap msgid "" " char **\n" @@ -39414,17 +38756,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9702 +#: ../src/guestfs-actions.pod:9372 msgid "See also C<guestfs_vgs_full>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9710 +#: ../src/guestfs-actions.pod:9380 msgid "guestfs_vgs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9712 +#: ../src/guestfs-actions.pod:9382 #, no-wrap msgid "" " struct guestfs_lvm_vg_list *\n" @@ -39433,7 +38775,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9718 +#: ../src/guestfs-actions.pod:9388 msgid "" "This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there " "was an error. I<The caller must call C<guestfs_free_lvm_vg_list> after " @@ -39441,12 +38783,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9724 +#: ../src/guestfs-actions.pod:9394 msgid "guestfs_vgscan" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9726 +#: ../src/guestfs-actions.pod:9396 #, no-wrap msgid "" " int\n" @@ -39455,12 +38797,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9736 +#: ../src/guestfs-actions.pod:9406 msgid "guestfs_vguuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9738 +#: ../src/guestfs-actions.pod:9408 #, no-wrap msgid "" " char *\n" @@ -39470,12 +38812,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9749 +#: ../src/guestfs-actions.pod:9419 msgid "guestfs_wait_ready" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9751 +#: ../src/guestfs-actions.pod:9421 #, no-wrap msgid "" " int\n" @@ -39484,19 +38826,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9754 +#: ../src/guestfs-actions.pod:9424 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_launch> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9761 +#: ../src/guestfs-actions.pod:9431 msgid "This function is a no op." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9763 +#: ../src/guestfs-actions.pod:9433 msgid "" "In versions of the API E<lt> 1.0.71 you had to call this function just after " "calling C<guestfs_launch> to wait for the launch to complete. However this " @@ -39504,19 +38846,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9768 +#: ../src/guestfs-actions.pod:9438 msgid "" "If you see any calls to this function in code then you can just remove them, " "unless you want to retain compatibility with older versions of the API." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9776 +#: ../src/guestfs-actions.pod:9446 msgid "guestfs_wc_c" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9778 +#: ../src/guestfs-actions.pod:9448 #, no-wrap msgid "" " int\n" @@ -39526,12 +38868,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9789 +#: ../src/guestfs-actions.pod:9459 msgid "guestfs_wc_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9791 +#: ../src/guestfs-actions.pod:9461 #, no-wrap msgid "" " int\n" @@ -39541,12 +38883,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9802 +#: ../src/guestfs-actions.pod:9472 msgid "guestfs_wc_w" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9804 +#: ../src/guestfs-actions.pod:9474 #, no-wrap msgid "" " int\n" @@ -39556,12 +38898,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9815 +#: ../src/guestfs-actions.pod:9485 msgid "guestfs_wipefs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9817 +#: ../src/guestfs-actions.pod:9487 #, no-wrap msgid "" " int\n" @@ -39571,17 +38913,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9827 +#: ../src/guestfs-actions.pod:9497 msgid "Compare with C<guestfs_zero> which zeroes the first few blocks of a device." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9834 +#: ../src/guestfs-actions.pod:9504 msgid "guestfs_write" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9836 +#: ../src/guestfs-actions.pod:9506 #, no-wrap msgid "" " int\n" @@ -39593,17 +38935,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9845 +#: ../src/guestfs-actions.pod:9515 msgid "See also C<guestfs_write_append>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9854 +#: ../src/guestfs-actions.pod:9524 msgid "guestfs_write_append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9856 +#: ../src/guestfs-actions.pod:9526 #, no-wrap msgid "" " int\n" @@ -39615,17 +38957,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9865 +#: ../src/guestfs-actions.pod:9535 msgid "See also C<guestfs_write>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9874 +#: ../src/guestfs-actions.pod:9544 msgid "guestfs_write_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9876 +#: ../src/guestfs-actions.pod:9546 #, no-wrap msgid "" " int\n" @@ -39637,114 +38979,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9882 +#: ../src/guestfs-actions.pod:9552 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_write> call " "instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:9907 -msgid "guestfs_xfs_growfs" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:9909 -#, no-wrap -msgid "" -" char *\n" -" guestfs_xfs_growfs (guestfs_h *g,\n" -" const char *path,\n" -" ...);\n" -"\n" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:9919 -#, no-wrap -msgid "" -" GUESTFS_XFS_GROWFS_DATASEC, int datasec,\n" -" GUESTFS_XFS_GROWFS_LOGSEC, int logsec,\n" -" GUESTFS_XFS_GROWFS_RTSEC, int rtsec,\n" -" GUESTFS_XFS_GROWFS_DATASIZE, int64_t datasize,\n" -" GUESTFS_XFS_GROWFS_LOGSIZE, int64_t logsize,\n" -" GUESTFS_XFS_GROWFS_RTSIZE, int64_t rtsize,\n" -" GUESTFS_XFS_GROWFS_RTEXTSIZE, int64_t rtextsize,\n" -" GUESTFS_XFS_GROWFS_MAXPCT, int maxpct,\n" -"\n" -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:9937 -msgid "guestfs_xfs_growfs_va" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:9939 -#, no-wrap -msgid "" -" char *\n" -" guestfs_xfs_growfs_va (guestfs_h *g,\n" -" const char *path,\n" -" va_list args);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:9944 -msgid "This is the \"va_list variant\" of L</guestfs_xfs_growfs>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:9948 -msgid "guestfs_xfs_growfs_argv" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:9950 -#, no-wrap -msgid "" -" char *\n" -" guestfs_xfs_growfs_argv (guestfs_h *g,\n" -" const char *path,\n" -" const struct guestfs_xfs_growfs_argv *optargs);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:9955 -msgid "This is the \"argv variant\" of L</guestfs_xfs_growfs>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:9959 -msgid "guestfs_xfs_info" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:9961 -#, no-wrap -msgid "" -" struct guestfs_xfsinfo *\n" -" guestfs_xfs_info (guestfs_h *g,\n" -" const char *pathordevice);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:9972 -msgid "" -"This function returns a C<struct guestfs_xfsinfo *>, or NULL if there was an " -"error. I<The caller must call C<guestfs_free_xfsinfo> after use>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:9976 +#: ../src/guestfs-actions.pod:9577 msgid "guestfs_zegrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:9978 +#: ../src/guestfs-actions.pod:9579 #, no-wrap msgid "" " char **\n" @@ -39755,12 +39002,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10002 +#: ../src/guestfs-actions.pod:9596 msgid "guestfs_zegrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10004 +#: ../src/guestfs-actions.pod:9598 #, no-wrap msgid "" " char **\n" @@ -39771,12 +39018,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10028 +#: ../src/guestfs-actions.pod:9615 msgid "guestfs_zero" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10030 +#: ../src/guestfs-actions.pod:9617 #, no-wrap msgid "" " int\n" @@ -39786,19 +39033,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10044 +#: ../src/guestfs-actions.pod:9631 msgid "" "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>, " "C<guestfs_is_zero_device>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10056 +#: ../src/guestfs-actions.pod:9643 msgid "guestfs_zero_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10058 +#: ../src/guestfs-actions.pod:9645 #, no-wrap msgid "" " int\n" @@ -39808,24 +39055,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10062 +#: ../src/guestfs-actions.pod:9649 msgid "" "This command writes zeroes over the entire C<device>. Compare with " "C<guestfs_zero> which just zeroes the first few blocks of a device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10077 +#: ../src/guestfs-actions.pod:9664 msgid "(Added in 1.3.1)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10079 +#: ../src/guestfs-actions.pod:9666 msgid "guestfs_zero_free_space" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10081 +#: ../src/guestfs-actions.pod:9668 #, no-wrap msgid "" " int\n" @@ -39834,21 +39081,13 @@ msgid "" "\n" msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:10091 -msgid "" -"Free space is not \"trimmed\". You may want to call C<guestfs_fstrim> " -"either as an alternative to this, or after calling this, depending on your " -"requirements." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:10104 +#: ../src/guestfs-actions.pod:9690 msgid "guestfs_zerofree" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10106 +#: ../src/guestfs-actions.pod:9692 #, no-wrap msgid "" " int\n" @@ -39858,12 +39097,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10125 +#: ../src/guestfs-actions.pod:9711 msgid "guestfs_zfgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10127 +#: ../src/guestfs-actions.pod:9713 #, no-wrap msgid "" " char **\n" @@ -39874,12 +39113,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10151 +#: ../src/guestfs-actions.pod:9730 msgid "guestfs_zfgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10153 +#: ../src/guestfs-actions.pod:9732 #, no-wrap msgid "" " char **\n" @@ -39890,12 +39129,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10177 +#: ../src/guestfs-actions.pod:9749 msgid "guestfs_zfile" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10179 +#: ../src/guestfs-actions.pod:9751 #, no-wrap msgid "" " char *\n" @@ -39906,26 +39145,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10184 +#: ../src/guestfs-actions.pod:9756 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_file> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:10196 +#: ../src/guestfs-actions.pod:9768 msgid "" "Since 1.0.63, use C<guestfs_file> instead which can now process compressed " "files." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10204 +#: ../src/guestfs-actions.pod:9776 msgid "guestfs_zgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10206 +#: ../src/guestfs-actions.pod:9778 #, no-wrap msgid "" " char **\n" @@ -39936,12 +39175,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:10230 +#: ../src/guestfs-actions.pod:9795 msgid "guestfs_zgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:10232 +#: ../src/guestfs-actions.pod:9797 #, no-wrap msgid "" " char **\n" @@ -39985,31 +39224,21 @@ msgstr "" #. type: =item #: ../src/guestfs-availability.pod:38 -msgid "B<fstrim>" -msgstr "" - -#. type: textblock -#: ../src/guestfs-availability.pod:40 -msgid "The following functions: L</guestfs_fstrim>" -msgstr "" - -#. type: =item -#: ../src/guestfs-availability.pod:43 msgid "B<grub>" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:45 +#: ../src/guestfs-availability.pod:40 msgid "The following functions: L</guestfs_grub_install>" msgstr "" #. type: =item -#: ../src/guestfs-availability.pod:48 +#: ../src/guestfs-availability.pod:43 msgid "B<inotify>" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:50 +#: ../src/guestfs-availability.pod:45 msgid "" "The following functions: L</guestfs_inotify_add_watch> " "L</guestfs_inotify_close> L</guestfs_inotify_files> L</guestfs_inotify_init> " @@ -40017,34 +39246,34 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs-availability.pod:58 +#: ../src/guestfs-availability.pod:53 msgid "B<linuxfsuuid>" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:60 +#: ../src/guestfs-availability.pod:55 msgid "" "The following functions: L</guestfs_mke2fs_JU> L</guestfs_mke2journal_U> " "L</guestfs_mkswap_U> L</guestfs_swapoff_uuid> L</guestfs_swapon_uuid>" msgstr "" #. type: =item -#: ../src/guestfs-availability.pod:67 +#: ../src/guestfs-availability.pod:62 msgid "B<linuxmodules>" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:69 +#: ../src/guestfs-availability.pod:64 msgid "The following functions: L</guestfs_modprobe>" msgstr "" #. type: =item -#: ../src/guestfs-availability.pod:72 +#: ../src/guestfs-availability.pod:67 msgid "B<linuxxattrs>" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:74 +#: ../src/guestfs-availability.pod:69 msgid "" "The following functions: L</guestfs_getxattr> L</guestfs_getxattrs> " "L</guestfs_lgetxattr> L</guestfs_lgetxattrs> L</guestfs_lremovexattr> " @@ -40053,12 +39282,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs-availability.pod:85 +#: ../src/guestfs-availability.pod:80 msgid "B<luks>" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:87 +#: ../src/guestfs-availability.pod:82 msgid "" "The following functions: L</guestfs_luks_add_key> L</guestfs_luks_close> " "L</guestfs_luks_format> L</guestfs_luks_format_cipher> " @@ -40066,140 +39295,130 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs-availability.pod:96 +#: ../src/guestfs-availability.pod:91 msgid "B<lvm2>" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:98 +#: ../src/guestfs-availability.pod:93 msgid "" "The following functions: L</guestfs_is_lv> L</guestfs_lvcreate> " "L</guestfs_lvcreate_free> L</guestfs_lvm_remove_all> " "L</guestfs_lvm_set_filter> L</guestfs_lvremove> L</guestfs_lvresize> " "L</guestfs_lvresize_free> L</guestfs_lvs> L</guestfs_lvs_full> " -"L</guestfs_pvchange_uuid> L</guestfs_pvchange_uuid_all> L</guestfs_pvcreate> " -"L</guestfs_pvremove> L</guestfs_pvresize> L</guestfs_pvresize_size> " -"L</guestfs_pvs> L</guestfs_pvs_full> L</guestfs_vg_activate> " -"L</guestfs_vg_activate_all> L</guestfs_vgchange_uuid> " -"L</guestfs_vgchange_uuid_all> L</guestfs_vgcreate> L</guestfs_vgmeta> " -"L</guestfs_vgremove> L</guestfs_vgs> L</guestfs_vgs_full>" +"L</guestfs_pvcreate> L</guestfs_pvremove> L</guestfs_pvresize> " +"L</guestfs_pvresize_size> L</guestfs_pvs> L</guestfs_pvs_full> " +"L</guestfs_vg_activate> L</guestfs_vg_activate_all> L</guestfs_vgcreate> " +"L</guestfs_vgmeta> L</guestfs_vgremove> L</guestfs_vgs> L</guestfs_vgs_full>" msgstr "" #. type: =item -#: ../src/guestfs-availability.pod:127 +#: ../src/guestfs-availability.pod:118 msgid "B<mdadm>" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:129 +#: ../src/guestfs-availability.pod:120 msgid "" "The following functions: L</guestfs_md_create> L</guestfs_md_detail> " "L</guestfs_md_stat> L</guestfs_md_stop>" msgstr "" #. type: =item -#: ../src/guestfs-availability.pod:135 +#: ../src/guestfs-availability.pod:126 msgid "B<mknod>" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:137 +#: ../src/guestfs-availability.pod:128 msgid "" "The following functions: L</guestfs_mkfifo> L</guestfs_mknod> " "L</guestfs_mknod_b> L</guestfs_mknod_c>" msgstr "" #. type: =item -#: ../src/guestfs-availability.pod:143 +#: ../src/guestfs-availability.pod:134 msgid "B<ntfs3g>" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:145 +#: ../src/guestfs-availability.pod:136 msgid "" "The following functions: L</guestfs_ntfs_3g_probe> L</guestfs_ntfsclone_in> " "L</guestfs_ntfsclone_out> L</guestfs_ntfsfix>" msgstr "" #. type: =item -#: ../src/guestfs-availability.pod:151 +#: ../src/guestfs-availability.pod:142 msgid "B<ntfsprogs>" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:153 -msgid "The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_size>" +#: ../src/guestfs-availability.pod:144 +msgid "" +"The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_opts> " +"L</guestfs_ntfsresize_size>" msgstr "" #. type: =item -#: ../src/guestfs-availability.pod:157 +#: ../src/guestfs-availability.pod:149 msgid "B<realpath>" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:159 +#: ../src/guestfs-availability.pod:151 msgid "The following functions: L</guestfs_realpath>" msgstr "" #. type: =item -#: ../src/guestfs-availability.pod:162 +#: ../src/guestfs-availability.pod:154 msgid "B<scrub>" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:164 +#: ../src/guestfs-availability.pod:156 msgid "" "The following functions: L</guestfs_scrub_device> L</guestfs_scrub_file> " "L</guestfs_scrub_freespace>" msgstr "" #. type: =item -#: ../src/guestfs-availability.pod:169 +#: ../src/guestfs-availability.pod:161 msgid "B<selinux>" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:171 +#: ../src/guestfs-availability.pod:163 msgid "The following functions: L</guestfs_getcon> L</guestfs_setcon>" msgstr "" #. type: =item -#: ../src/guestfs-availability.pod:175 +#: ../src/guestfs-availability.pod:167 msgid "B<wipefs>" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:177 +#: ../src/guestfs-availability.pod:169 msgid "The following functions: L</guestfs_wipefs>" msgstr "" #. type: =item -#: ../src/guestfs-availability.pod:180 -msgid "B<xfs>" -msgstr "" - -#. type: textblock -#: ../src/guestfs-availability.pod:182 -msgid "The following functions: L</guestfs_xfs_growfs> L</guestfs_xfs_info>" -msgstr "" - -#. type: =item -#: ../src/guestfs-availability.pod:186 +#: ../src/guestfs-availability.pod:172 msgid "B<xz>" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:188 +#: ../src/guestfs-availability.pod:174 msgid "The following functions: L</guestfs_txz_in> L</guestfs_txz_out>" msgstr "" #. type: =item -#: ../src/guestfs-availability.pod:192 +#: ../src/guestfs-availability.pod:178 msgid "B<zerofree>" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:194 +#: ../src/guestfs-availability.pod:180 msgid "The following functions: L</guestfs_zerofree>" msgstr "" @@ -40833,98 +40052,6 @@ msgid "" "\n" msgstr "" -#. type: =head2 -#: ../src/guestfs-structs.pod:330 -msgid "guestfs_xfsinfo" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-structs.pod:332 -#, no-wrap -msgid "" -" struct guestfs_xfsinfo {\n" -" char *xfs_mntpoint;\n" -" uint32_t xfs_inodesize;\n" -" uint32_t xfs_agcount;\n" -" uint32_t xfs_agsize;\n" -" uint32_t xfs_sectsize;\n" -" uint32_t xfs_attr;\n" -" uint32_t xfs_blocksize;\n" -" uint64_t xfs_datablocks;\n" -" uint32_t xfs_imaxpct;\n" -" uint32_t xfs_sunit;\n" -" uint32_t xfs_swidth;\n" -" uint32_t xfs_dirversion;\n" -" uint32_t xfs_dirblocksize;\n" -" uint32_t xfs_cimode;\n" -" char *xfs_logname;\n" -" uint32_t xfs_logblocksize;\n" -" uint32_t xfs_logblocks;\n" -" uint32_t xfs_logversion;\n" -" uint32_t xfs_logsectsize;\n" -" uint32_t xfs_logsunit;\n" -" uint32_t xfs_lazycount;\n" -" char *xfs_rtname;\n" -" uint32_t xfs_rtextsize;\n" -" uint64_t xfs_rtblocks;\n" -" uint64_t xfs_rtextents;\n" -" };\n" -" \n" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-structs.pod:360 -#, no-wrap -msgid "" -" struct guestfs_xfsinfo_list {\n" -" uint32_t len; /* Number of elements in list. */\n" -" struct guestfs_xfsinfo *val; /* Elements. */\n" -" };\n" -" \n" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-structs.pod:365 -#, no-wrap -msgid "" -" void guestfs_free_xfsinfo (struct guestfs_free_xfsinfo *);\n" -" void guestfs_free_xfsinfo_list (struct guestfs_free_xfsinfo_list *);\n" -"\n" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-structs.pod:370 -#, no-wrap -msgid "" -" struct guestfs_utsname {\n" -" char *uts_sysname;\n" -" char *uts_release;\n" -" char *uts_version;\n" -" char *uts_machine;\n" -" };\n" -" \n" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-structs.pod:377 -#, no-wrap -msgid "" -" struct guestfs_utsname_list {\n" -" uint32_t len; /* Number of elements in list. */\n" -" struct guestfs_utsname *val; /* Elements. */\n" -" };\n" -" \n" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-structs.pod:382 -#, no-wrap -msgid "" -" void guestfs_free_utsname (struct guestfs_free_utsname *);\n" -" void guestfs_free_utsname_list (struct guestfs_free_utsname_list *);\n" -"\n" -msgstr "" - #. type: textblock #: ../src/guestfs.pod:5 msgid "guestfs - Library for accessing and modifying virtual machine images" @@ -42238,12 +41365,62 @@ msgstr "" #. type: =head3 #: ../src/guestfs.pod:702 -msgid "ACCESSING THE WINDOWS REGISTRY" +msgid "LONG FILENAMES ON NTFS" msgstr "" #. type: textblock #: ../src/guestfs.pod:704 msgid "" +"NTFS supports filenames up to 255 characters long. \"Character\" means a 2 " +"byte UTF-16 codepoint which can encode the most common Unicode codepoints." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:708 +msgid "" +"Most Linux filesystems support filenames up to 255 I<bytes>. This means you " +"may get an error:" +msgstr "" + +#. type: verbatim +#: ../src/guestfs.pod:711 +#, no-wrap +msgid "" +" File name too long\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:713 +msgid "" +"when you copy a file from NTFS to a Linux filesystem if the name, when " +"reencoded as UTF-8, would exceed 255 bytes in length." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:716 +msgid "" +"This will most often happen when using non-ASCII names that are longer than " +"~127 characters (eg. Greek, Cyrillic) or longer than ~85 characters (Asian " +"languages)." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:720 +msgid "" +"A workaround is not to try to store such long filenames on Linux native " +"filesystems. Since the L<tar(1)> format can store unlimited length " +"filenames, keep the files in a tarball." +msgstr "" + +#. type: =head3 +#: ../src/guestfs.pod:724 +msgid "ACCESSING THE WINDOWS REGISTRY" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:726 +msgid "" "Libguestfs also provides some help for decoding Windows Registry \"hive\" " "files, through the library C<hivex> which is part of the libguestfs project " "although ships as a separate tarball. You have to locate and download the " @@ -42253,12 +41430,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:712 +#: ../src/guestfs.pod:734 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:714 +#: ../src/guestfs.pod:736 msgid "" "Ntfs-3g tries to rewrite \"Junction Points\" and NTFS \"symbolic links\" to " "provide something which looks like a Linux symlink. The way it tries to do " @@ -42266,12 +41443,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:718 +#: ../src/guestfs.pod:740 msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-symbolic-links/>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:720 +#: ../src/guestfs.pod:742 msgid "" "The essential problem is that ntfs-3g simply does not have enough " "information to do a correct job. NTFS links can contain drive letters and " @@ -42281,7 +41458,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:727 +#: ../src/guestfs.pod:749 msgid "" "Instead if you encounter a symbolic link on an ntfs-3g filesystem, use " "L</guestfs_lgetxattr> to read the C<system.ntfs_reparse_data> extended " @@ -42290,36 +41467,36 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:732 +#: ../src/guestfs.pod:754 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:734 +#: ../src/guestfs.pod:756 msgid "" "There are other useful extended attributes that can be read from ntfs-3g " "filesystems (using L</guestfs_getxattr>). See:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:737 +#: ../src/guestfs.pod:759 msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:739 +#: ../src/guestfs.pod:761 msgid "RESIZE2FS ERRORS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:741 +#: ../src/guestfs.pod:763 msgid "" "The L</guestfs_resize2fs>, L</guestfs_resize2fs_size> and " "L</guestfs_resize2fs_M> calls are used to resize ext2/3/4 filesystems." msgstr "" #. type: textblock -#: ../src/guestfs.pod:744 +#: ../src/guestfs.pod:766 msgid "" "The underlying program (L<resize2fs(8)>) requires that the filesystem is " "clean and recently fsck'd before you can resize it. Also, if the resize " @@ -42328,7 +41505,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:749 +#: ../src/guestfs.pod:771 msgid "" "In libguestfs C<lt> 1.17.14, you usually had to call L</guestfs_e2fsck_f> " "before the resize. However, in C<ge> 1.17.14, L<e2fsck(8)> is called " @@ -42336,14 +41513,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:754 +#: ../src/guestfs.pod:776 msgid "" "The L<resize2fs(8)> program can still fail, in which case it prints an error " "message similar to:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:757 +#: ../src/guestfs.pod:779 #, no-wrap msgid "" " Please run 'e2fsck -fy <device>' to fix the filesystem\n" @@ -42352,7 +41529,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:760 +#: ../src/guestfs.pod:782 msgid "" "You can do this by calling L</guestfs_e2fsck> with the C<forceall> option. " "However in the context of disk images, it is usually better to avoid this " @@ -42361,19 +41538,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:765 +#: ../src/guestfs.pod:787 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:767 +#: ../src/guestfs.pod:789 msgid "" "Although we don't want to discourage you from using the C API, we will " "mention here that the same API is also available in other languages." msgstr "" #. type: textblock -#: ../src/guestfs.pod:770 +#: ../src/guestfs.pod:792 msgid "" "The API is broadly identical in all supported languages. This means that " "the C call C<guestfs_add_drive_ro(g,file)> is C<$g-E<gt>add_drive_ro($file)> " @@ -42383,14 +41560,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:776 +#: ../src/guestfs.pod:798 msgid "" "Error messages are automatically transformed into exceptions if the language " "supports it." msgstr "" #. type: textblock -#: ../src/guestfs.pod:779 +#: ../src/guestfs.pod:801 msgid "" "We don't try to \"object orientify\" parts of the API in OO languages, " "although contributors are welcome to write higher level APIs above what we " @@ -42398,58 +41575,58 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:785 +#: ../src/guestfs.pod:807 msgid "B<C++>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:787 +#: ../src/guestfs.pod:809 msgid "" "You can use the I<guestfs.h> header file from C++ programs. The C++ API is " "identical to the C API. C++ classes and exceptions are not used." msgstr "" #. type: =item -#: ../src/guestfs.pod:791 +#: ../src/guestfs.pod:813 msgid "B<C#>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:793 +#: ../src/guestfs.pod:815 msgid "" "The C# bindings are highly experimental. Please read the warnings at the " "top of C<csharp/Libguestfs.cs>." msgstr "" #. type: =item -#: ../src/guestfs.pod:796 +#: ../src/guestfs.pod:818 msgid "B<Erlang>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:798 +#: ../src/guestfs.pod:820 msgid "See L<guestfs-erlang(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:800 +#: ../src/guestfs.pod:822 msgid "B<GObject>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:802 +#: ../src/guestfs.pod:824 msgid "" "Experimental GObject bindings (with GObject Introspection support) are " "available. See the C<gobject> directory in the source." msgstr "" #. type: =item -#: ../src/guestfs.pod:805 +#: ../src/guestfs.pod:827 msgid "B<Haskell>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:807 +#: ../src/guestfs.pod:829 msgid "" "This is the only language binding that is working but incomplete. Only " "calls which return simple integers have been bound in Haskell, and we are " @@ -42457,96 +41634,96 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:811 +#: ../src/guestfs.pod:833 msgid "B<Java>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:813 +#: ../src/guestfs.pod:835 msgid "" "Full documentation is contained in the Javadoc which is distributed with " "libguestfs. For examples, see L<guestfs-java(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:816 +#: ../src/guestfs.pod:838 msgid "B<OCaml>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:818 +#: ../src/guestfs.pod:840 msgid "See L<guestfs-ocaml(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:820 +#: ../src/guestfs.pod:842 msgid "B<Perl>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:822 +#: ../src/guestfs.pod:844 msgid "See L<guestfs-perl(3)> and L<Sys::Guestfs(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:824 +#: ../src/guestfs.pod:846 msgid "B<PHP>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:826 +#: ../src/guestfs.pod:848 msgid "" "For documentation see C<README-PHP> supplied with libguestfs sources or in " "the php-libguestfs package for your distribution." msgstr "" #. type: textblock -#: ../src/guestfs.pod:829 +#: ../src/guestfs.pod:851 msgid "The PHP binding only works correctly on 64 bit machines." msgstr "" #. type: =item -#: ../src/guestfs.pod:831 +#: ../src/guestfs.pod:853 msgid "B<Python>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:833 +#: ../src/guestfs.pod:855 msgid "See L<guestfs-python(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:835 +#: ../src/guestfs.pod:857 msgid "B<Ruby>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:837 +#: ../src/guestfs.pod:859 msgid "See L<guestfs-ruby(3)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:839 +#: ../src/guestfs.pod:861 msgid "For JRuby, use the Java bindings." msgstr "" #. type: =item -#: ../src/guestfs.pod:841 +#: ../src/guestfs.pod:863 msgid "B<shell scripts>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:843 +#: ../src/guestfs.pod:865 msgid "See L<guestfish(1)>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:847 +#: ../src/guestfs.pod:869 msgid "LIBGUESTFS GOTCHAS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:849 +#: ../src/guestfs.pod:871 msgid "" "L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a " "system [...] that works in the way it is documented but is counterintuitive " @@ -42554,7 +41731,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:853 +#: ../src/guestfs.pod:875 msgid "" "Since we developed libguestfs and the associated tools, there are several " "things we would have designed differently, but are now stuck with for " @@ -42563,19 +41740,19 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:861 +#: ../src/guestfs.pod:883 msgid "Autosync / forgetting to sync." msgstr "" #. type: textblock -#: ../src/guestfs.pod:863 +#: ../src/guestfs.pod:885 msgid "" "I<Update:> Autosync is enabled by default for all API users starting from " "libguestfs 1.5.24. This section only applies to older versions." msgstr "" #. type: textblock -#: ../src/guestfs.pod:866 +#: ../src/guestfs.pod:888 msgid "" "When modifying a filesystem from C or another language, you B<must> unmount " "all filesystems and call L</guestfs_sync> explicitly before you close the " @@ -42583,7 +41760,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:870 +#: ../src/guestfs.pod:892 #, no-wrap msgid "" " guestfs_set_autosync (g, 1);\n" @@ -42591,7 +41768,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:872 +#: ../src/guestfs.pod:894 msgid "" "to have the unmount/sync done automatically for you when the handle 'g' is " "closed. (This feature is called \"autosync\", L</guestfs_set_autosync> " @@ -42599,7 +41776,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:876 +#: ../src/guestfs.pod:898 msgid "" "If you forget to do this, then it is entirely possible that your changes " "won't be written out, or will be partially written, or (very rarely) that " @@ -42607,7 +41784,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:880 +#: ../src/guestfs.pod:902 msgid "" "Note that in L<guestfish(3)> autosync is the default. So quick and dirty " "guestfish scripts that forget to sync will work just fine, which can make " @@ -42615,19 +41792,19 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:884 +#: ../src/guestfs.pod:906 msgid "Mount option C<-o sync> should not be the default." msgstr "" #. type: textblock -#: ../src/guestfs.pod:886 +#: ../src/guestfs.pod:908 msgid "" "I<Update:> L</guestfs_mount> no longer adds any options starting from " "libguestfs 1.13.16. This section only applies to older versions." msgstr "" #. type: textblock -#: ../src/guestfs.pod:889 +#: ../src/guestfs.pod:911 msgid "" "If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly. " "However C<-o sync> does not add any reliability benefit, but does have a " @@ -42635,31 +41812,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:893 +#: ../src/guestfs.pod:915 msgid "" "The work around is to use L</guestfs_mount_options> and set the mount " "options that you actually want to use." msgstr "" #. type: =item -#: ../src/guestfs.pod:896 +#: ../src/guestfs.pod:918 msgid "Read-only should be the default." msgstr "" #. type: textblock -#: ../src/guestfs.pod:898 +#: ../src/guestfs.pod:920 msgid "" "In L<guestfish(3)>, I<--ro> should be the default, and you should have to " "specify I<--rw> if you want to make changes to the image." msgstr "" #. type: textblock -#: ../src/guestfs.pod:901 +#: ../src/guestfs.pod:923 msgid "This would reduce the potential to corrupt live VM images." msgstr "" #. type: textblock -#: ../src/guestfs.pod:903 +#: ../src/guestfs.pod:925 msgid "" "Note that many filesystems change the disk when you just mount and unmount, " "even if you didn't perform any writes. You need to use " @@ -42667,12 +41844,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:907 +#: ../src/guestfs.pod:929 msgid "guestfish command line is hard to use." msgstr "" #. type: textblock -#: ../src/guestfs.pod:909 +#: ../src/guestfs.pod:931 msgid "" "C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for " "examination). It tries to run a guestfish command C<disk.img> which doesn't " @@ -42682,12 +41859,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:916 +#: ../src/guestfs.pod:938 msgid "guestfish megabyte modifiers don't work right on all commands" msgstr "" #. type: textblock -#: ../src/guestfs.pod:918 +#: ../src/guestfs.pod:940 msgid "" "In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for " "other modifiers). What guestfish actually does is to multiply the number " @@ -42697,12 +41874,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:925 +#: ../src/guestfs.pod:947 msgid "The most common is L</guestfs_lvcreate>. The guestfish command:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:927 +#: ../src/guestfs.pod:949 #, no-wrap msgid "" " lvcreate LV VG 100M\n" @@ -42710,7 +41887,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:929 +#: ../src/guestfs.pod:951 msgid "" "does not do what you might expect. Instead because L</guestfs_lvcreate> is " "already expecting megabytes, this tries to create a 100 I<terabyte> (100 " @@ -42719,19 +41896,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:934 +#: ../src/guestfs.pod:956 msgid "" "This could be fixed in the generator by specially marking parameters and " "return values which take bytes or other units." msgstr "" #. type: =item -#: ../src/guestfs.pod:937 +#: ../src/guestfs.pod:959 msgid "Ambiguity between devices and paths" msgstr "" #. type: textblock -#: ../src/guestfs.pod:939 +#: ../src/guestfs.pod:961 msgid "" "There is a subtle ambiguity in the API between a device name " "(eg. C</dev/sdb2>) and a similar pathname. A file might just happen to be " @@ -42739,7 +41916,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:944 +#: ../src/guestfs.pod:966 msgid "" "In the current API we usually resolve this ambiguity by having two separate " "calls, for example L</guestfs_checksum> and L</guestfs_checksum_device>. " @@ -42748,7 +41925,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:950 +#: ../src/guestfs.pod:972 msgid "" "To avoid both the ambiguity and the need to duplicate some calls, we could " "make paths/devices into structured names. One way to do this would be to " @@ -42758,7 +41935,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:956 +#: ../src/guestfs.pod:978 #, no-wrap msgid "" " type path = Path of string | Device of int | Partition of int * int\n" @@ -42766,12 +41943,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:958 +#: ../src/guestfs.pod:980 msgid "which would allow you to pass arguments like:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:960 +#: ../src/guestfs.pod:982 #, no-wrap msgid "" " Path \"/foo/bar\"\n" @@ -42782,26 +41959,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:965 +#: ../src/guestfs.pod:987 msgid "" "As you can see there are still problems to resolve even with this " "representation. Also consider how it might work in guestfish." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:970 +#: ../src/guestfs.pod:992 msgid "KEYS AND PASSPHRASES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:972 +#: ../src/guestfs.pod:994 msgid "" "Certain libguestfs calls take a parameter that contains sensitive key " "material, passed in as a C string." msgstr "" #. type: textblock -#: ../src/guestfs.pod:975 +#: ../src/guestfs.pod:997 msgid "" "In the future we would hope to change the libguestfs implementation so that " "keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in " @@ -42810,7 +41987,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:980 +#: ../src/guestfs.pod:1002 msgid "" "Therefore you should be aware that any key parameter you pass to libguestfs " "might end up being written out to the swap partition. If this is a concern, " @@ -42818,19 +41995,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:985 +#: ../src/guestfs.pod:1007 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:987 +#: ../src/guestfs.pod:1009 msgid "" "All high-level libguestfs actions are synchronous. If you want to use " "libguestfs asynchronously then you must create a thread." msgstr "" #. type: textblock -#: ../src/guestfs.pod:990 +#: ../src/guestfs.pod:1012 msgid "" "Only use the handle from a single thread. Either use the handle exclusively " "from one thread, or provide your own mutex so that two threads cannot issue " @@ -42838,33 +42015,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:994 +#: ../src/guestfs.pod:1016 msgid "" "See the graphical program guestfs-browser for one possible architecture for " "multithreaded programs using libvirt and libguestfs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:997 +#: ../src/guestfs.pod:1019 msgid "PATH" msgstr "" #. type: textblock -#: ../src/guestfs.pod:999 +#: ../src/guestfs.pod:1021 msgid "" "Libguestfs needs a supermin appliance, which it finds by looking along an " "internal path." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1002 +#: ../src/guestfs.pod:1024 msgid "" "By default it looks for these in the directory C<$libdir/guestfs> " "(eg. C</usr/local/lib/guestfs> or C</usr/lib64/guestfs>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1005 +#: ../src/guestfs.pod:1027 msgid "" "Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> " "to change the directories that libguestfs will search in. The value is a " @@ -42875,12 +42052,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1012 +#: ../src/guestfs.pod:1034 msgid "QEMU WRAPPERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1014 +#: ../src/guestfs.pod:1036 msgid "" "If you want to compile your own qemu, run qemu from a non-standard location, " "or pass extra arguments to qemu, then you can write a shell-script wrapper " @@ -42888,7 +42065,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1018 +#: ../src/guestfs.pod:1040 msgid "" "There is one important rule to remember: you I<must C<exec qemu>> as the " "last command in the shell script (so that qemu replaces the shell and " @@ -42897,14 +42074,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1023 +#: ../src/guestfs.pod:1045 msgid "" "Here is an example of a wrapper, where I have built my own copy of qemu from " "source:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1026 +#: ../src/guestfs.pod:1048 #, no-wrap msgid "" " #!/bin/sh -\n" @@ -42915,7 +42092,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1030 +#: ../src/guestfs.pod:1052 msgid "" "Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and " "then use it by setting the LIBGUESTFS_QEMU environment variable. For " @@ -42923,7 +42100,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1034 +#: ../src/guestfs.pod:1056 #, no-wrap msgid "" " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n" @@ -42931,14 +42108,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1036 +#: ../src/guestfs.pod:1058 msgid "" "Note that libguestfs also calls qemu with the -help and -version options in " "order to determine features." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1039 +#: ../src/guestfs.pod:1061 msgid "" "Wrappers can also be used to edit the options passed to qemu. In the " "following example, the C<-machine ...> option (C<-machine> and the following " @@ -42948,7 +42125,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1048 +#: ../src/guestfs.pod:1070 #, no-wrap msgid "" " i=0\n" @@ -42966,7 +42143,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1060 +#: ../src/guestfs.pod:1082 #, no-wrap msgid "" " exec qemu-kvm -machine pc,accel=tcg \"${args[@]}\"\n" @@ -42974,19 +42151,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1062 +#: ../src/guestfs.pod:1084 msgid "ATTACHING TO RUNNING DAEMONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1064 +#: ../src/guestfs.pod:1086 msgid "" "I<Note (1):> This is B<highly experimental> and has a tendency to eat " "babies. Use with caution." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1067 +#: ../src/guestfs.pod:1089 msgid "" "I<Note (2):> This section explains how to attach to a running daemon from a " "low level perspective. For most users, simply using virt tools such as " @@ -42994,12 +42171,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1071 +#: ../src/guestfs.pod:1093 msgid "Using guestfs_set_attach_method" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1073 +#: ../src/guestfs.pod:1095 msgid "" "By calling L</guestfs_set_attach_method> you can change how the library " "connects to the C<guestfsd> daemon in L</guestfs_launch> (read " @@ -43007,15 +42184,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1077 +#: ../src/guestfs.pod:1099 msgid "" "The normal attach method is C<appliance>, where a small appliance is created " -"containing the daemon, and then the library connects to this. C<libvirt> or " -"C<libvirt:I<URI>> are alternatives that use libvirt to start the appliance." +"containing the daemon, and then the library connects to this." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1082 +#: ../src/guestfs.pod:1102 msgid "" "Setting attach method to C<unix:I<path>> (where I<path> is the path of a " "Unix domain socket) causes L</guestfs_launch> to connect to an existing " @@ -43023,7 +42199,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1086 +#: ../src/guestfs.pod:1106 msgid "" "The normal use for this is to connect to a running virtual machine that " "contains a C<guestfsd> daemon, and send commands so you can read and write " @@ -43031,12 +42207,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1090 +#: ../src/guestfs.pod:1110 msgid "Using guestfs_add_domain with live flag" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1092 +#: ../src/guestfs.pod:1112 msgid "" "L</guestfs_add_domain> provides some help for getting the correct attach " "method. If you pass the C<live> option to this function, then (if the " @@ -43045,7 +42221,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1098 +#: ../src/guestfs.pod:1118 #, no-wrap msgid "" " <domain>\n" @@ -43063,14 +42239,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1110 +#: ../src/guestfs.pod:1130 msgid "" "L</guestfs_add_domain> extracts C</path/to/socket> and sets the attach " "method to C<unix:/path/to/socket>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1113 +#: ../src/guestfs.pod:1133 msgid "" "Some of the libguestfs tools (including guestfish) support a I<--live> " "option which is passed through to L</guestfs_add_domain> thus allowing you " @@ -43078,19 +42254,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1117 +#: ../src/guestfs.pod:1137 msgid "" "The virtual machine needs to have been set up beforehand so that it has the " "virtio-serial channel and so that guestfsd is running inside it." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1121 +#: ../src/guestfs.pod:1141 msgid "ABI GUARANTEE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1123 +#: ../src/guestfs.pod:1143 msgid "" "We guarantee the libguestfs ABI (binary interface), for public, high-level " "actions as outlined in this section. Although we will deprecate some " @@ -43100,12 +42276,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1129 +#: ../src/guestfs.pod:1149 msgid "BLOCK DEVICE NAMING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1131 +#: ../src/guestfs.pod:1151 msgid "" "In the kernel there is now quite a profusion of schemata for naming block " "devices (in this context, by I<block device> I mean a physical or virtual " @@ -43120,7 +42296,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1143 +#: ../src/guestfs.pod:1163 msgid "" "As discussed above, libguestfs uses a qemu appliance running an embedded " "Linux kernel to access block devices. We can run a variety of appliances " @@ -43128,7 +42304,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1147 +#: ../src/guestfs.pod:1167 msgid "" "This causes a problem for libguestfs because many API calls use device or " "partition names. Working scripts and the recipe (example) scripts that we " @@ -43136,7 +42312,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1152 +#: ../src/guestfs.pod:1172 msgid "" "Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>. " "Internally C</dev/sd*> names are translated, if necessary, to other names as " @@ -43145,21 +42321,20 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1158 +#: ../src/guestfs.pod:1178 msgid "" "Note that this I<only> applies to parameters. The L</guestfs_list_devices>, " "L</guestfs_list_partitions> and similar calls return the true names of the " -"devices and partitions as known to the appliance, but see " -"L</guestfs_canonical_device_name>." +"devices and partitions as known to the appliance." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1163 +#: ../src/guestfs.pod:1183 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1165 +#: ../src/guestfs.pod:1185 msgid "" "Usually this translation is transparent. However in some (very rare) cases " "you may need to know the exact algorithm. Such cases include where you use " @@ -43169,7 +42344,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1171 +#: ../src/guestfs.pod:1191 msgid "" "The algorithm is applied only to I<parameters> which are known to be either " "device or partition names. Return values from functions such as " @@ -43177,54 +42352,54 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1179 +#: ../src/guestfs.pod:1199 msgid "Is the string a parameter which is a device or partition name?" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1183 +#: ../src/guestfs.pod:1203 msgid "Does the string begin with C</dev/sd>?" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1187 +#: ../src/guestfs.pod:1207 msgid "" "Does the named device exist? If so, we use that device. However if I<not> " "then we continue with this algorithm." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1192 +#: ../src/guestfs.pod:1212 msgid "Replace initial C</dev/sd> string with C</dev/hd>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1194 +#: ../src/guestfs.pod:1214 msgid "For example, change C</dev/sda2> to C</dev/hda2>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1196 +#: ../src/guestfs.pod:1216 msgid "If that named device exists, use it. If not, continue." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1200 +#: ../src/guestfs.pod:1220 msgid "Replace initial C</dev/sd> string with C</dev/vd>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1202 +#: ../src/guestfs.pod:1222 msgid "If that named device exists, use it. If not, return an error." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1206 +#: ../src/guestfs.pod:1226 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1208 +#: ../src/guestfs.pod:1228 msgid "" "Although the standard naming scheme and automatic translation is useful for " "simple programs and guestfish scripts, for larger programs it is best not to " @@ -43232,50 +42407,140 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1212 +#: ../src/guestfs.pod:1232 msgid "" "Where possible for maximum future portability programs using libguestfs " "should use these future-proof techniques:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1219 +#: ../src/guestfs.pod:1239 msgid "" "Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual " "device names, and then use those names directly." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1222 +#: ../src/guestfs.pod:1242 msgid "Since those device names exist by definition, they will never be translated." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1227 +#: ../src/guestfs.pod:1247 msgid "" "Use higher level ways to identify filesystems, such as LVM names, UUIDs and " "filesystem labels." msgstr "" +#. type: =head2 +#: ../src/guestfs.pod:1252 +msgid "NULL DISKS" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1254 +msgid "" +"When adding a disk using, eg., L</guestfs_add_drive>, you can set the " +"filename to C<\"/dev/null\">. This string is treated specially by " +"libguestfs, causing it to add a \"null disk\"." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1258 +msgid "A null disk has the following properties:" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1264 +msgid "" +"A null disk will appear as a normal device, eg. in calls to " +"L</guestfs_list_devices>." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1269 +msgid "You may add C<\"/dev/null\"> multiple times." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1273 +msgid "" +"You should not try to access a null disk in any way. For example, you " +"shouldn't try to read it or mount it." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1278 +msgid "Null disks are used for three main purposes:" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1284 +msgid "Performance testing of libguestfs (see L<guestfs-performance(1)>)." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1288 +msgid "The internal test suite." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1292 +msgid "" +"If you want to use libguestfs APIs that don't refer to disks, since " +"libguestfs requires that at least one disk is added, you should add a null " +"disk." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1296 +msgid "For example, to test if a feature is available, use code like this:" +msgstr "" + +#. type: verbatim +#: ../src/guestfs.pod:1298 +#, no-wrap +msgid "" +" guestfs_h *g;\n" +" char **groups = [ \"btrfs\", NULL ];\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../src/guestfs.pod:1301 +#, no-wrap +msgid "" +" g = guestfs_create ();\n" +" guestfs_add_drive (g, \"/dev/null\");\n" +" guestfs_launch (g);\n" +" if (guestfs_available (g, groups) == 0) {\n" +" // group(s) are available\n" +" } else {\n" +" // group(s) are not available\n" +" }\n" +" guestfs_close (g);\n" +"\n" +msgstr "" + #. type: =head1 -#: ../src/guestfs.pod:1232 ../sysprep/virt-sysprep.pod:386 +#: ../src/guestfs.pod:1313 ../sysprep/virt-sysprep.pod:386 msgid "SECURITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1234 +#: ../src/guestfs.pod:1315 msgid "" "This section discusses security implications of using libguestfs, " "particularly with untrusted or malicious guests or disk images." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1237 +#: ../src/guestfs.pod:1318 msgid "GENERAL SECURITY CONSIDERATIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1239 +#: ../src/guestfs.pod:1320 msgid "" "Be careful with any files or data that you download from a guest (by " "\"download\" we mean not just the L</guestfs_download> command but any " @@ -43285,42 +42550,42 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1249 +#: ../src/guestfs.pod:1330 msgid "the data (file etc) not being present" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1253 +#: ../src/guestfs.pod:1334 msgid "being present but empty" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1257 +#: ../src/guestfs.pod:1338 msgid "being much larger than normal" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1261 +#: ../src/guestfs.pod:1342 msgid "containing arbitrary 8 bit data" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1265 +#: ../src/guestfs.pod:1346 msgid "being in an unexpected character encoding" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1269 +#: ../src/guestfs.pod:1350 msgid "containing homoglyphs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1273 +#: ../src/guestfs.pod:1354 msgid "SECURITY OF MOUNTING FILESYSTEMS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1275 +#: ../src/guestfs.pod:1356 msgid "" "When you mount a filesystem under Linux, mistakes in the kernel filesystem " "(VFS) module can sometimes be escalated into exploits by deliberately " @@ -43336,7 +42601,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1288 +#: ../src/guestfs.pod:1369 msgid "" "That explains why you should never mount a filesystem from an untrusted " "guest on your host kernel. How about libguestfs? We run a Linux kernel " @@ -43350,19 +42615,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1299 +#: ../src/guestfs.pod:1380 msgid "" "In any case callers can reduce the attack surface by forcing the filesystem " "type when mounting (use L</guestfs_mount_vfs>)." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1302 +#: ../src/guestfs.pod:1383 msgid "PROTOCOL SECURITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1304 +#: ../src/guestfs.pod:1385 msgid "" "The protocol is designed to be secure, being based on RFC 4506 (XDR) with a " "defined upper message size. However a program that uses libguestfs must " @@ -43372,12 +42637,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1310 +#: ../src/guestfs.pod:1391 msgid "INSPECTION SECURITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1312 +#: ../src/guestfs.pod:1393 msgid "" "Parts of the inspection API (see L</INSPECTION>) return untrusted strings " "directly from the guest, and these could contain any 8 bit data. Callers " @@ -43386,7 +42651,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1318 +#: ../src/guestfs.pod:1399 msgid "" "Guest configuration may be altered in unusual ways by the administrator of " "the virtual machine, and may not reflect reality (particularly for untrusted " @@ -43397,7 +42662,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1326 +#: ../src/guestfs.pod:1407 msgid "" "The inspection API parses guest configuration using two external libraries: " "Augeas (Linux configuration) and hivex (Windows Registry). Both are " @@ -43407,12 +42672,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1332 +#: ../src/guestfs.pod:1413 msgid "RUNNING UNTRUSTED GUEST COMMANDS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1334 +#: ../src/guestfs.pod:1415 msgid "" "Be very cautious about running commands from the guest. By running a " "command in the guest, you are giving CPU time to a binary that you do not " @@ -43422,24 +42687,24 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1340 +#: ../src/guestfs.pod:1421 msgid "CVE-2010-3851" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1342 +#: ../src/guestfs.pod:1423 msgid "L<https://bugzilla.redhat.com/642934>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1344 +#: ../src/guestfs.pod:1425 msgid "" "This security bug concerns the automatic disk format detection that qemu " "does on disk images." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1347 +#: ../src/guestfs.pod:1428 msgid "" "A raw disk image is just the raw bytes, there is no header. Other disk " "images like qcow2 contain a special header. Qemu deals with this by looking " @@ -43448,7 +42713,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1352 +#: ../src/guestfs.pod:1433 msgid "" "This allows a guest which has been given a raw disk image to write some " "other header. At next boot (or when the disk image is accessed by " @@ -43457,7 +42722,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1357 +#: ../src/guestfs.pod:1438 msgid "" "This in itself would not be a problem, but qcow2 offers many features, one " "of which is to allow a disk image to refer to another image (called the " @@ -43469,24 +42734,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1365 +#: ../src/guestfs.pod:1446 msgid "In libguestfs this is rather hard to exploit except under two circumstances:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1372 +#: ../src/guestfs.pod:1453 msgid "You have enabled the network or have opened the disk in write mode." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1376 +#: ../src/guestfs.pod:1457 msgid "" "You are also running untrusted code from the guest (see L</RUNNING " "COMMANDS>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1381 +#: ../src/guestfs.pod:1462 msgid "" "The way to avoid this is to specify the expected disk format when adding " "disks (the optional C<format> option to L</guestfs_add_drive_opts>). You " @@ -43495,31 +42760,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1386 +#: ../src/guestfs.pod:1467 msgid "" "For disks added from libvirt using calls like L</guestfs_add_domain>, the " "format is fetched from libvirt and passed through." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1389 +#: ../src/guestfs.pod:1470 msgid "" "For libguestfs tools, use the I<--format> command line parameter as " "appropriate." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1392 +#: ../src/guestfs.pod:1473 msgid "CONNECTION MANAGEMENT" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1394 +#: ../src/guestfs.pod:1475 msgid "guestfs_h *" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1396 +#: ../src/guestfs.pod:1477 msgid "" "C<guestfs_h> is the opaque type representing a connection handle. Create a " "handle by calling L</guestfs_create>. Call L</guestfs_close> to free the " @@ -43527,19 +42792,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1400 +#: ../src/guestfs.pod:1481 msgid "" "For information on using multiple handles and threads, see the section " "L</MULTIPLE HANDLES AND MULTIPLE THREADS> above." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1403 +#: ../src/guestfs.pod:1484 msgid "guestfs_create" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1405 +#: ../src/guestfs.pod:1486 #, no-wrap msgid "" " guestfs_h *guestfs_create (void);\n" @@ -43547,19 +42812,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1407 +#: ../src/guestfs.pod:1488 msgid "Create a connection handle." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1409 +#: ../src/guestfs.pod:1490 msgid "" "On success this returns a non-NULL pointer to a handle. On error it returns " "NULL." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1412 +#: ../src/guestfs.pod:1493 msgid "" "You have to \"configure\" the handle after creating it. This includes " "calling L</guestfs_add_drive_opts> (or one of the equivalent calls) on the " @@ -43567,24 +42832,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1416 +#: ../src/guestfs.pod:1497 msgid "After configuring the handle, you have to call L</guestfs_launch>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1418 +#: ../src/guestfs.pod:1499 msgid "" "You may also want to configure error handling for the handle. See the " "L</ERROR HANDLING> section below." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1421 +#: ../src/guestfs.pod:1502 msgid "guestfs_close" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1423 +#: ../src/guestfs.pod:1504 #, no-wrap msgid "" " void guestfs_close (guestfs_h *g);\n" @@ -43592,19 +42857,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1425 +#: ../src/guestfs.pod:1506 msgid "" "This closes the connection handle and frees up all resources used. If a " "close callback was set on the handle, then it is called." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1428 +#: ../src/guestfs.pod:1509 msgid "The correct way to close the handle is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1430 +#: ../src/guestfs.pod:1511 #, no-wrap msgid "" " if (guestfs_shutdown (g) == -1) {\n" @@ -43615,51 +42880,51 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1435 +#: ../src/guestfs.pod:1516 msgid "L</guestfs_shutdown> is only needed if B<all> of the following are true:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1441 +#: ../src/guestfs.pod:1522 msgid "one or more disks were added in read-write mode, I<and>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1445 +#: ../src/guestfs.pod:1526 msgid "guestfs_launch was called, I<and>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1449 +#: ../src/guestfs.pod:1530 msgid "you made some changes, I<and>" msgstr "" #. type: =item -#: ../src/guestfs.pod:1451 +#: ../src/guestfs.pod:1532 msgid "4" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1453 +#: ../src/guestfs.pod:1534 msgid "" "you have a way to handle write errors (eg. by exiting with an error code or " "reporting something to the user)." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1458 +#: ../src/guestfs.pod:1539 msgid "ERROR HANDLING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1460 +#: ../src/guestfs.pod:1541 msgid "" "API functions can return errors. For example, almost all functions that " "return C<int> will return C<-1> to indicate an error." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1463 +#: ../src/guestfs.pod:1544 msgid "" "Additional information is available for errors: an error message string and " "optionally an error number (errno) if the thing that failed was a system " @@ -43667,7 +42932,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1467 +#: ../src/guestfs.pod:1548 msgid "" "You can get at the additional information about the last error on the handle " "by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting " @@ -43675,7 +42940,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1472 +#: ../src/guestfs.pod:1553 msgid "" "When the handle is created, a default error handler is installed which " "prints the error message string to C<stderr>. For small short-running " @@ -43683,7 +42948,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1476 +#: ../src/guestfs.pod:1557 #, no-wrap msgid "" " if (guestfs_launch (g) == -1)\n" @@ -43692,21 +42957,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1479 +#: ../src/guestfs.pod:1560 msgid "" "since the default error handler will ensure that an error message has been " "printed to C<stderr> before the program exits." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1482 +#: ../src/guestfs.pod:1563 msgid "" "For other programs the caller will almost certainly want to install an " "alternate error handler or do error handling in-line like this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1485 +#: ../src/guestfs.pod:1566 #, no-wrap msgid "" " /* This disables the default behaviour of printing errors\n" @@ -43716,7 +42981,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1489 +#: ../src/guestfs.pod:1570 #, no-wrap msgid "" " if (guestfs_launch (g) == -1) {\n" @@ -43733,7 +42998,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1500 +#: ../src/guestfs.pod:1581 msgid "" "Out of memory errors are handled differently. The default action is to call " "L<abort(3)>. If this is undesirable, then you can set a handler using " @@ -43741,7 +43006,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1504 +#: ../src/guestfs.pod:1585 msgid "" "L</guestfs_create> returns C<NULL> if the handle cannot be created, and " "because there is no handle if this happens there is no way to get additional " @@ -43751,12 +43016,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1510 +#: ../src/guestfs.pod:1591 msgid "guestfs_last_error" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1512 +#: ../src/guestfs.pod:1593 #, no-wrap msgid "" " const char *guestfs_last_error (guestfs_h *g);\n" @@ -43764,26 +43029,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1514 +#: ../src/guestfs.pod:1595 msgid "" "This returns the last error message that happened on C<g>. If there has not " "been an error since the handle was created, then this returns C<NULL>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1518 +#: ../src/guestfs.pod:1599 msgid "" "The lifetime of the returned string is until the next error occurs, or " "L</guestfs_close> is called." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1521 +#: ../src/guestfs.pod:1602 msgid "guestfs_last_errno" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1523 +#: ../src/guestfs.pod:1604 #, no-wrap msgid "" " int guestfs_last_errno (guestfs_h *g);\n" @@ -43791,27 +43056,27 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1525 +#: ../src/guestfs.pod:1606 msgid "This returns the last error number (errno) that happened on C<g>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1527 +#: ../src/guestfs.pod:1608 msgid "If successful, an errno integer not equal to zero is returned." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1529 +#: ../src/guestfs.pod:1610 msgid "If no error, this returns 0. This call can return 0 in three situations:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1536 +#: ../src/guestfs.pod:1617 msgid "There has not been any error on the handle." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1540 +#: ../src/guestfs.pod:1621 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 " @@ -43819,14 +43084,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1546 +#: ../src/guestfs.pod:1627 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:1552 +#: ../src/guestfs.pod:1633 msgid "" "Libguestfs tries to convert the errno from inside the applicance into a " "corresponding errno for the caller (not entirely trivial: the appliance " @@ -43837,12 +43102,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1560 +#: ../src/guestfs.pod:1641 msgid "guestfs_set_error_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1562 +#: ../src/guestfs.pod:1643 #, no-wrap msgid "" " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n" @@ -43855,7 +43120,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1569 +#: ../src/guestfs.pod:1650 msgid "" "The callback C<cb> will be called if there is an error. The parameters " "passed to the callback are an opaque data pointer and the error message " @@ -43863,14 +43128,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1573 +#: ../src/guestfs.pod:1654 msgid "" "C<errno> is not passed to the callback. To get that the callback must call " "L</guestfs_last_errno>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1576 +#: ../src/guestfs.pod:1657 msgid "" "Note that the message string C<msg> is freed as soon as the callback " "function returns, so if you want to stash it somewhere you must make your " @@ -43878,22 +43143,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1580 +#: ../src/guestfs.pod:1661 msgid "The default handler prints messages on C<stderr>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1582 +#: ../src/guestfs.pod:1663 msgid "If you set C<cb> to C<NULL> then I<no> handler is called." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1584 +#: ../src/guestfs.pod:1665 msgid "guestfs_get_error_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1586 +#: ../src/guestfs.pod:1667 #, no-wrap msgid "" " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n" @@ -43902,17 +43167,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1589 +#: ../src/guestfs.pod:1670 msgid "Returns the current error handler callback." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1591 +#: ../src/guestfs.pod:1672 msgid "guestfs_set_out_of_memory_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1593 +#: ../src/guestfs.pod:1674 #, no-wrap msgid "" " typedef void (*guestfs_abort_cb) (void);\n" @@ -43922,29 +43187,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1597 +#: ../src/guestfs.pod:1678 msgid "" "The callback C<cb> will be called if there is an out of memory situation. " "I<Note this callback must not return>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1600 +#: ../src/guestfs.pod:1681 msgid "The default is to call L<abort(3)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1602 +#: ../src/guestfs.pod:1683 msgid "You cannot set C<cb> to C<NULL>. You can't ignore out of memory situations." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1605 +#: ../src/guestfs.pod:1686 msgid "guestfs_get_out_of_memory_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1607 +#: ../src/guestfs.pod:1688 #, no-wrap msgid "" " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n" @@ -43952,37 +43217,37 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1609 +#: ../src/guestfs.pod:1690 msgid "This returns the current out of memory handler." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1611 +#: ../src/guestfs.pod:1692 msgid "API CALLS" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1615 +#: ../src/guestfs.pod:1696 msgid "STRUCTURES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1617 +#: ../src/guestfs.pod:1698 msgid "@STRUCTS@" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1619 +#: ../src/guestfs.pod:1700 msgid "AVAILABILITY" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1621 +#: ../src/guestfs.pod:1702 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1623 +#: ../src/guestfs.pod:1704 msgid "" "Using L</guestfs_available> you can test availability of the following " "groups of functions. This test queries the appliance to see if the " @@ -43990,29 +43255,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1628 +#: ../src/guestfs.pod:1709 msgid "@AVAILABILITY@" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1630 -msgid "FILESYSTEM AVAILABLE" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1632 -msgid "" -"The L</guestfs_filesystem_available> call tests whether a filesystem type is " -"supported by the appliance kernel." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:1640 +#: ../src/guestfs.pod:1711 msgid "GUESTFISH supported COMMAND" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1642 +#: ../src/guestfs.pod:1713 msgid "" "In L<guestfish(3)> there is a handy interactive command C<supported> which " "prints out the available groups and whether they are supported by this build " @@ -44020,19 +43273,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1647 +#: ../src/guestfs.pod:1718 msgid "SINGLE CALLS AT COMPILE TIME" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1649 +#: ../src/guestfs.pod:1720 msgid "" "Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API " "function, such as:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1652 +#: ../src/guestfs.pod:1723 #, no-wrap msgid "" " #define LIBGUESTFS_HAVE_DD 1\n" @@ -44040,12 +43293,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1654 +#: ../src/guestfs.pod:1725 msgid "if L</guestfs_dd> is available." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1656 +#: ../src/guestfs.pod:1727 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 " @@ -44053,7 +43306,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1661 +#: ../src/guestfs.pod:1732 #, no-wrap msgid "" " AC_CHECK_LIB([guestfs],[guestfs_create])\n" @@ -44062,19 +43315,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1664 +#: ../src/guestfs.pod:1735 msgid "" "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined " "in your program." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1667 +#: ../src/guestfs.pod:1738 msgid "SINGLE CALLS AT RUN TIME" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1669 +#: ../src/guestfs.pod:1740 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 " @@ -44084,7 +43337,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1676 +#: ../src/guestfs.pod:1747 msgid "" "You can use L<dlopen(3)> to test if a function is available at run time, as " "in this example program (note that you still need the compile time check as " @@ -44092,7 +43345,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1680 +#: ../src/guestfs.pod:1751 #, no-wrap msgid "" " #include <stdio.h>\n" @@ -44104,7 +43357,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1686 +#: ../src/guestfs.pod:1757 #, no-wrap msgid "" " main ()\n" @@ -44116,7 +43369,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1692 +#: ../src/guestfs.pod:1763 #, no-wrap msgid "" " /* Test if the function guestfs_dd is really available. */\n" @@ -44131,7 +43384,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1701 +#: ../src/guestfs.pod:1772 #, no-wrap msgid "" " if (!has_function)\n" @@ -44150,7 +43403,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1714 +#: ../src/guestfs.pod:1785 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 " @@ -44158,7 +43411,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1719 +#: ../src/guestfs.pod:1790 #, no-wrap msgid "" " Requires: libguestfs >= 1.0.80\n" @@ -44166,12 +43419,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1721 +#: ../src/guestfs.pod:1792 msgid "CALLS WITH OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1723 +#: ../src/guestfs.pod:1794 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 " @@ -44179,7 +43432,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1728 +#: ../src/guestfs.pod:1799 #, no-wrap msgid "" " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n" @@ -44187,14 +43440,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1730 +#: ../src/guestfs.pod:1801 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:1733 +#: ../src/guestfs.pod:1804 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename, -1);\n" @@ -44202,12 +43455,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1735 +#: ../src/guestfs.pod:1806 msgid "With a single optional argument:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1737 +#: ../src/guestfs.pod:1808 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -44217,12 +43470,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1741 +#: ../src/guestfs.pod:1812 msgid "With two:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1743 +#: ../src/guestfs.pod:1814 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -44233,19 +43486,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1748 +#: ../src/guestfs.pod:1819 msgid "" "and so forth. Don't forget the terminating C<-1> otherwise Bad Things will " "happen!" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1751 +#: ../src/guestfs.pod:1822 msgid "USING va_list FOR OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1753 +#: ../src/guestfs.pod:1824 msgid "" "The second variant has the same name with the suffix C<_va>, which works the " "same way but takes a C<va_list>. See the C manual for details. For the " @@ -44253,7 +43506,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1757 +#: ../src/guestfs.pod:1828 #, no-wrap msgid "" " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n" @@ -44262,12 +43515,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1760 +#: ../src/guestfs.pod:1831 msgid "CONSTRUCTING OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1762 +#: ../src/guestfs.pod:1833 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 " @@ -44277,7 +43530,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1768 +#: ../src/guestfs.pod:1839 #, no-wrap msgid "" " struct guestfs_add_drive_opts_argv {\n" @@ -44292,12 +43545,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1777 +#: ../src/guestfs.pod:1848 msgid "You could call it like this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1779 +#: ../src/guestfs.pod:1850 #, no-wrap msgid "" " struct guestfs_add_drive_opts_argv optargs = {\n" @@ -44310,7 +43563,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1786 +#: ../src/guestfs.pod:1857 #, no-wrap msgid "" " guestfs_add_drive_opts_argv (g, filename, &optargs);\n" @@ -44318,29 +43571,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1794 +#: ../src/guestfs.pod:1865 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1799 +#: ../src/guestfs.pod:1870 msgid "You do not need to fill in all fields of the structure." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1803 +#: ../src/guestfs.pod:1874 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:1808 +#: ../src/guestfs.pod:1879 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1810 +#: ../src/guestfs.pod:1881 msgid "" "In other languages, optional arguments are expressed in the way that is " "natural for that language. We refer you to the language-specific " @@ -44348,17 +43601,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1814 +#: ../src/guestfs.pod:1885 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1816 +#: ../src/guestfs.pod:1887 msgid "SETTING CALLBACKS TO HANDLE EVENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1818 +#: ../src/guestfs.pod:1889 msgid "" "B<Note:> This section documents the generic event mechanism introduced in " "libguestfs 1.10, which you should use in new code if possible. The old " @@ -44370,7 +43623,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1827 +#: ../src/guestfs.pod:1898 msgid "" "Handles generate events when certain things happen, such as log messages " "being generated, progress messages during long-running operations, or the " @@ -44382,7 +43635,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1835 +#: ../src/guestfs.pod:1906 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 " @@ -44391,31 +43644,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1840 +#: ../src/guestfs.pod:1911 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:1844 +#: ../src/guestfs.pod:1915 msgid "CLASSES OF EVENTS" msgstr "" #. type: =item -#: ../src/guestfs.pod:1848 +#: ../src/guestfs.pod:1919 msgid "GUESTFS_EVENT_CLOSE (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1851 +#: ../src/guestfs.pod:1922 msgid "" "The callback function will be called while the handle is being closed " "(synchronously from L</guestfs_close>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1854 +#: ../src/guestfs.pod:1925 msgid "" "Note that libguestfs installs an L<atexit(3)> handler to try to clean up " "handles that are open when the program exits. This means that this callback " @@ -44426,19 +43679,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1861 +#: ../src/guestfs.pod:1932 msgid "" "If no callback is registered: the handle is closed without any callback " "being invoked." msgstr "" #. type: =item -#: ../src/guestfs.pod:1864 +#: ../src/guestfs.pod:1935 msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1867 +#: ../src/guestfs.pod:1938 msgid "" "The callback function will be called when the child process quits, either " "asynchronously or if killed by L</guestfs_kill_subprocess>. (This " @@ -44446,17 +43699,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1871 ../src/guestfs.pod:1880 ../src/guestfs.pod:1997 +#: ../src/guestfs.pod:1942 ../src/guestfs.pod:1951 ../src/guestfs.pod:2068 msgid "If no callback is registered: the event is ignored." msgstr "" #. type: =item -#: ../src/guestfs.pod:1873 +#: ../src/guestfs.pod:1944 msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1876 +#: ../src/guestfs.pod:1947 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 " @@ -44464,12 +43717,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:1882 +#: ../src/guestfs.pod:1953 msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1885 +#: ../src/guestfs.pod:1956 msgid "" "Some long-running operations can generate progress messages. If this " "callback is registered, then it will be called each time a progress message " @@ -44479,14 +43732,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1891 +#: ../src/guestfs.pod:1962 msgid "" "The callback receives in the payload four unsigned 64 bit numbers which are " "(in order): C<proc_nr>, C<serial>, C<position>, C<total>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1894 +#: ../src/guestfs.pod:1965 msgid "" "The units of C<total> are not defined, although for some operations C<total> " "may relate in some way to the amount of data to be transferred (eg. in bytes " @@ -44495,24 +43748,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1899 +#: ../src/guestfs.pod:1970 msgid "The only defined and stable parts of the API are:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1905 +#: ../src/guestfs.pod:1976 msgid "" "The callback can display to the user some type of progress bar or indicator " "which shows the ratio of C<position>:C<total>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1910 +#: ../src/guestfs.pod:1981 msgid "0 E<lt>= C<position> E<lt>= C<total>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1914 +#: ../src/guestfs.pod:1985 msgid "" "If any progress notification is sent during a call, then a final progress " "notification is always sent when C<position> = C<total> (I<unless> the call " @@ -44520,7 +43773,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1918 +#: ../src/guestfs.pod:1989 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 " @@ -44528,7 +43781,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1924 +#: ../src/guestfs.pod:1995 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 " @@ -44537,7 +43790,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1929 +#: ../src/guestfs.pod:2000 msgid "" "For these calls, zero or more progress messages are generated with " "C<position = 0> and C<total = 1>, followed by a final message with " @@ -44545,14 +43798,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1933 +#: ../src/guestfs.pod:2004 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:1938 +#: ../src/guestfs.pod:2009 msgid "" "The callback also receives the procedure number (C<proc_nr>) and serial " "number (C<serial>) of the call. These are only useful for debugging " @@ -44561,31 +43814,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1944 +#: ../src/guestfs.pod:2015 msgid "If no callback is registered: progress messages are discarded." msgstr "" #. type: =item -#: ../src/guestfs.pod:1946 +#: ../src/guestfs.pod:2017 msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1949 +#: ../src/guestfs.pod:2020 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:1952 +#: ../src/guestfs.pod:2023 msgid "" "If the verbose flag (L</guestfs_set_verbose>) is set before launch " "(L</guestfs_launch>) then additional debug messages are generated." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1955 ../src/guestfs.pod:1969 +#: ../src/guestfs.pod:2026 ../src/guestfs.pod:2040 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 " @@ -44593,62 +43846,62 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:1960 +#: ../src/guestfs.pod:2031 msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1963 +#: ../src/guestfs.pod:2034 msgid "" "The callback function is called whenever a log message is generated by the " "library part of libguestfs." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1966 +#: ../src/guestfs.pod:2037 msgid "" "If the verbose flag (L</guestfs_set_verbose>) is set then additional debug " "messages are generated." msgstr "" #. type: =item -#: ../src/guestfs.pod:1974 +#: ../src/guestfs.pod:2045 msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1977 +#: ../src/guestfs.pod:2048 msgid "" "The callback function is called whenever a trace message is generated. This " "only applies if the trace flag (L</guestfs_set_trace>) is set." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1980 +#: ../src/guestfs.pod:2051 msgid "" "If no callback is registered: the messages are sent to stderr. You can " "override the printing of trace messages to stderr by setting up a callback." msgstr "" #. type: =item -#: ../src/guestfs.pod:1984 +#: ../src/guestfs.pod:2055 msgid "GUESTFS_EVENT_ENTER (payload type: function name)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1987 +#: ../src/guestfs.pod:2058 msgid "The callback function is called whenever a libguestfs function is entered." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1990 +#: ../src/guestfs.pod:2061 msgid "" "The payload is a string which contains the name of the function that we are " "entering (not including C<guestfs_> prefix)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1993 +#: ../src/guestfs.pod:2064 msgid "" "Note that libguestfs functions can call themselves, so you may see many " "events from a single call. A few libguestfs functions do not generate this " @@ -44656,12 +43909,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2001 +#: ../src/guestfs.pod:2072 msgid "guestfs_set_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2003 +#: ../src/guestfs.pod:2074 #, no-wrap msgid "" " int guestfs_set_event_callback (guestfs_h *g,\n" @@ -44673,14 +43926,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2009 +#: ../src/guestfs.pod:2080 msgid "" "This function registers a callback (C<cb>) for all event classes in the " "C<event_bitmask>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2012 +#: ../src/guestfs.pod:2083 msgid "" "For example, to register for all log message events, you could call this " "function with the bitmask C<GUESTFS_EVENT_APPLIANCE|GUESTFS_EVENT_LIBRARY>. " @@ -44689,40 +43942,40 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2018 +#: ../src/guestfs.pod:2089 msgid "C<flags> should always be passed as 0." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2020 +#: ../src/guestfs.pod:2091 msgid "" "C<opaque> is an opaque pointer which is passed to the callback. You can use " "it for any purpose." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2023 +#: ../src/guestfs.pod:2094 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:2026 +#: ../src/guestfs.pod:2097 msgid "" "If there is an error, this function returns C<-1>, and sets the error in the " "handle in the usual way (see L</guestfs_last_error> etc.)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2029 +#: ../src/guestfs.pod:2100 msgid "" "Callbacks remain in effect until they are deleted, or until the handle is " "closed." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2032 +#: ../src/guestfs.pod:2103 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 " @@ -44730,12 +43983,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2036 +#: ../src/guestfs.pod:2107 msgid "guestfs_delete_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2038 +#: ../src/guestfs.pod:2109 #, no-wrap msgid "" " void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n" @@ -44743,7 +43996,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2040 +#: ../src/guestfs.pod:2111 msgid "" "Delete a callback that was previously registered. C<event_handle> should be " "the integer that was returned by a previous call to " @@ -44751,12 +44004,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2044 +#: ../src/guestfs.pod:2115 msgid "guestfs_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2046 +#: ../src/guestfs.pod:2117 #, no-wrap msgid "" " typedef void (*guestfs_event_callback) (\n" @@ -44771,12 +44024,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2055 +#: ../src/guestfs.pod:2126 msgid "This is the type of the event callback function that you have to provide." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2058 +#: ../src/guestfs.pod:2129 msgid "" "The basic parameters are: the handle (C<g>), the opaque user pointer " "(C<opaque>), the event class (eg. C<GUESTFS_EVENT_PROGRESS>), the event " @@ -44784,7 +44037,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2062 +#: ../src/guestfs.pod:2133 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 " @@ -44793,7 +44046,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2067 +#: ../src/guestfs.pod:2138 msgid "" "C<buf> and C<buf_len> contain a message buffer (if C<buf_len == 0>, then " "there is no message buffer). Note that this message buffer can contain " @@ -44801,19 +44054,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2071 +#: ../src/guestfs.pod:2142 msgid "" "C<array> and C<array_len> is an array of 64 bit unsigned integers. At the " "moment this is only used for progress messages." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2074 +#: ../src/guestfs.pod:2145 msgid "EXAMPLE: CAPTURING LOG MESSAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2076 +#: ../src/guestfs.pod:2147 msgid "" "One motivation for the generic event API was to allow GUI programs to " "capture debug and other messages. In libguestfs E<le> 1.8 these were sent " @@ -44821,7 +44074,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2080 +#: ../src/guestfs.pod:2151 msgid "" "Events associated with log messages are: C<GUESTFS_EVENT_LIBRARY>, " "C<GUESTFS_EVENT_APPLIANCE> and C<GUESTFS_EVENT_TRACE>. (Note that error " @@ -44829,14 +44082,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2085 +#: ../src/guestfs.pod:2156 msgid "" "Programs have to set up a callback to capture the classes of events of " "interest:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2088 +#: ../src/guestfs.pod:2159 #, no-wrap msgid "" " int eh =\n" @@ -44852,14 +44105,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2098 +#: ../src/guestfs.pod:2169 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:2101 +#: ../src/guestfs.pod:2172 #, no-wrap msgid "" " static void\n" @@ -44880,12 +44133,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2116 +#: ../src/guestfs.pod:2187 msgid "CANCELLING LONG TRANSFERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2118 +#: ../src/guestfs.pod:2189 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 " @@ -44894,12 +44147,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2123 +#: ../src/guestfs.pod:2194 msgid "guestfs_user_cancel" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2125 +#: ../src/guestfs.pod:2196 #, no-wrap msgid "" " void guestfs_user_cancel (guestfs_h *g);\n" @@ -44907,12 +44160,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2127 +#: ../src/guestfs.pod:2198 msgid "C<guestfs_user_cancel> cancels the current upload or download operation." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2130 +#: ../src/guestfs.pod:2201 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 " @@ -44920,7 +44173,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2134 +#: ../src/guestfs.pod:2205 msgid "" "The transfer that was in progress (if there is one) will stop shortly " "afterwards, and will return an error. The errno (see " @@ -44929,7 +44182,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2140 +#: ../src/guestfs.pod:2211 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 " @@ -44937,12 +44190,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2144 +#: ../src/guestfs.pod:2215 msgid "There are two common places that you might call C<guestfs_user_cancel>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2146 +#: ../src/guestfs.pod:2217 msgid "" "In an interactive text-based program, you might call it from a C<SIGINT> " "signal handler so that pressing C<^C> cancels the current operation. (You " @@ -44951,19 +44204,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2151 +#: ../src/guestfs.pod:2222 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:2155 +#: ../src/guestfs.pod:2226 msgid "PRIVATE DATA AREA" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2157 +#: ../src/guestfs.pod:2228 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 " @@ -44971,12 +44224,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2162 +#: ../src/guestfs.pod:2233 msgid "To attach a named piece of data, use the following call:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2164 +#: ../src/guestfs.pod:2235 #, no-wrap msgid "" " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n" @@ -44984,7 +44237,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2166 +#: ../src/guestfs.pod:2237 msgid "" "C<key> is the name to associate with this data, and C<data> is an arbitrary " "pointer (which can be C<NULL>). Any previous item with the same key is " @@ -44992,7 +44245,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2170 +#: ../src/guestfs.pod:2241 msgid "" "You can use any C<key> you want, but your key should I<not> start with an " "underscore character. Keys beginning with an underscore character are " @@ -45002,12 +44255,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2176 +#: ../src/guestfs.pod:2247 msgid "To retrieve the pointer, use:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2178 +#: ../src/guestfs.pod:2249 #, no-wrap msgid "" " void *guestfs_get_private (guestfs_h *g, const char *key);\n" @@ -45015,7 +44268,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2180 +#: ../src/guestfs.pod:2251 msgid "" "This function returns C<NULL> if either no data is found associated with " "C<key>, or if the user previously set the C<key>'s C<data> pointer to " @@ -45023,7 +44276,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2184 +#: ../src/guestfs.pod:2255 msgid "" "Libguestfs does not try to look at or interpret the C<data> pointer in any " "way. As far as libguestfs is concerned, it need not be a valid pointer at " @@ -45034,12 +44287,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2191 +#: ../src/guestfs.pod:2262 msgid "To walk over all entries, use these two functions:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2193 +#: ../src/guestfs.pod:2264 #, no-wrap msgid "" " void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n" @@ -45047,7 +44300,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2195 +#: ../src/guestfs.pod:2266 #, no-wrap msgid "" " void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n" @@ -45055,7 +44308,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2197 +#: ../src/guestfs.pod:2268 msgid "" "C<guestfs_first_private> returns the first key, pointer pair (\"first\" does " "not have any particular meaning -- keys are not returned in any defined " @@ -45065,7 +44318,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2203 +#: ../src/guestfs.pod:2274 msgid "" "C<guestfs_next_private> returns the next key, pointer pair. The return " "value of this function is also C<NULL> is there are no further entries to " @@ -45073,17 +44326,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2207 +#: ../src/guestfs.pod:2278 msgid "Notes about walking over entries:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2213 +#: ../src/guestfs.pod:2284 msgid "You must not call C<guestfs_set_private> while walking over the entries." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2218 +#: ../src/guestfs.pod:2289 msgid "" "The handle maintains an internal iterator which is reset when you call " "C<guestfs_first_private>. This internal iterator is invalidated when you " @@ -45091,12 +44344,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2224 +#: ../src/guestfs.pod:2295 msgid "If you have set the data pointer associated with a key to C<NULL>, ie:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2226 +#: ../src/guestfs.pod:2297 #, no-wrap msgid "" " guestfs_set_private (g, key, NULL);\n" @@ -45104,26 +44357,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2228 +#: ../src/guestfs.pod:2299 msgid "then that C<key> is not returned when walking." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2232 +#: ../src/guestfs.pod:2303 msgid "" "C<*key_rtn> is only valid until the next call to C<guestfs_first_private>, " "C<guestfs_next_private> or C<guestfs_set_private>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2238 +#: ../src/guestfs.pod:2309 msgid "" "The following example code shows how to print all keys and data pointers " "that are associated with the handle C<g>:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2241 +#: ../src/guestfs.pod:2312 #, no-wrap msgid "" " const char *key;\n" @@ -45137,14 +44390,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2249 +#: ../src/guestfs.pod:2320 msgid "" "More commonly you are only interested in keys that begin with an " "application-specific prefix C<foo_>. Modify the loop like so:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2252 +#: ../src/guestfs.pod:2323 #, no-wrap msgid "" " const char *key;\n" @@ -45159,7 +44412,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2261 +#: ../src/guestfs.pod:2332 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 " @@ -45167,7 +44420,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2265 +#: ../src/guestfs.pod:2336 #, no-wrap msgid "" " const char *key;\n" @@ -45189,7 +44442,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2281 +#: ../src/guestfs.pod:2352 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 " @@ -45198,12 +44451,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2286 +#: ../src/guestfs.pod:2357 msgid "SYSTEMTAP" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2288 +#: ../src/guestfs.pod:2359 msgid "" "The libguestfs C library can be probed using systemtap or DTrace. This is " "true of any library, not just libguestfs. However libguestfs also contains " @@ -45211,12 +44464,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2292 +#: ../src/guestfs.pod:2363 msgid "You can list all the static markers by doing:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2294 +#: ../src/guestfs.pod:2365 #, no-wrap msgid "" " stap -l 'process(\"/usr/lib*/libguestfs.so.0\")\n" @@ -45225,26 +44478,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2297 +#: ../src/guestfs.pod:2368 msgid "" "B<Note:> These static markers are I<not> part of the stable API and may " "change in future versions." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2300 +#: ../src/guestfs.pod:2371 msgid "SYSTEMTAP SCRIPT EXAMPLE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2302 +#: ../src/guestfs.pod:2373 msgid "" "This script contains examples of displaying both the static markers and some " "ordinary C entry points:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2329 +#: ../src/guestfs.pod:2400 #, no-wrap msgid "" " /* Display all calls to guestfs_mkfs* functions. */\n" @@ -45257,7 +44510,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2336 +#: ../src/guestfs.pod:2407 msgid "" "The script above can be saved to C<test.stap> and run using the L<stap(1)> " "program. Note that you either have to be root, or you have to add yourself " @@ -45266,7 +44519,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2341 +#: ../src/guestfs.pod:2412 #, no-wrap msgid "" " # stap /tmp/test.stap\n" @@ -45275,17 +44528,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2344 +#: ../src/guestfs.pod:2415 msgid "In another terminal, run a guestfish command such as this:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2348 +#: ../src/guestfs.pod:2419 msgid "In the first terminal, stap trace output similar to this is shown:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2350 +#: ../src/guestfs.pod:2421 #, no-wrap msgid "" " 1318248056692655 (+0):\tlaunch_start\n" @@ -45299,19 +44552,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2359 +#: ../src/guestfs.pod:2430 msgid "" "<!-- old anchor for the next section --> <a " "name=\"state_machine_and_low_level_event_api\"/>" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2364 +#: ../src/guestfs.pod:2435 msgid "ARCHITECTURE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2366 +#: ../src/guestfs.pod:2437 msgid "" "Internally, libguestfs is implemented by running an appliance (a special " "type of small virtual machine) using L<qemu(1)>. Qemu runs as a child " @@ -45319,7 +44572,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2370 +#: ../src/guestfs.pod:2441 #, no-wrap msgid "" " ___________________\n" @@ -45345,14 +44598,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2390 +#: ../src/guestfs.pod:2461 msgid "" "The library, linked to the main program, creates the child process and hence " "the appliance in the L</guestfs_launch> function." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2393 +#: ../src/guestfs.pod:2464 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 " @@ -45364,7 +44617,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2402 +#: ../src/guestfs.pod:2473 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 " @@ -45375,17 +44628,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2409 +#: ../src/guestfs.pod:2480 msgid "STATE MACHINE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2411 +#: ../src/guestfs.pod:2482 msgid "libguestfs uses a state machine to model the child process:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2413 +#: ../src/guestfs.pod:2484 #, no-wrap msgid "" " |\n" @@ -45413,7 +44666,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2435 +#: ../src/guestfs.pod:2506 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), " @@ -45422,7 +44675,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2440 +#: ../src/guestfs.pod:2511 msgid "" "The guest may be killed by L</guestfs_kill_subprocess>, or may die " "asynchronously at any time (eg. due to some internal error), and that causes " @@ -45430,14 +44683,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2444 +#: ../src/guestfs.pod:2515 msgid "" "Configuration commands for qemu such as L</guestfs_add_drive> can only be " "issued when in the CONFIG state." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2447 +#: ../src/guestfs.pod:2518 msgid "" "The API offers one call that goes from CONFIG through LAUNCHING to READY. " "L</guestfs_launch> blocks until the child process is READY to accept " @@ -45446,7 +44699,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2453 +#: ../src/guestfs.pod:2524 msgid "" "API actions such as L</guestfs_mount> can only be issued when in the READY " "state. These API calls block waiting for the command to be carried out. " @@ -45455,7 +44708,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2458 +#: ../src/guestfs.pod:2529 msgid "" "Finally, the child process sends asynchronous messages back to the main " "program, such as kernel log messages. You can register a callback to " @@ -45463,17 +44716,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2462 +#: ../src/guestfs.pod:2533 msgid "INTERNALS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2464 +#: ../src/guestfs.pod:2535 msgid "APPLIANCE BOOT PROCESS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2466 +#: ../src/guestfs.pod:2537 msgid "" "This process has evolved and continues to evolve. The description here " "corresponds only to the current version of libguestfs and is provided for " @@ -45481,55 +44734,55 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2470 +#: ../src/guestfs.pod:2541 msgid "" "In order to follow the stages involved below, enable libguestfs debugging " "(set the environment variable C<LIBGUESTFS_DEBUG=1>)." msgstr "" #. type: =item -#: ../src/guestfs.pod:2475 +#: ../src/guestfs.pod:2546 msgid "Create the appliance" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2477 +#: ../src/guestfs.pod:2548 msgid "" "C<febootstrap-supermin-helper> is invoked to create the kernel, a small " "initrd and the appliance." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2480 +#: ../src/guestfs.pod:2551 msgid "" "The appliance is cached in C</var/tmp/.guestfs-E<lt>UIDE<gt>> (or in another " "directory if C<TMPDIR> is set)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2483 +#: ../src/guestfs.pod:2554 msgid "" "For a complete description of how the appliance is created and cached, read " "the L<febootstrap(8)> and L<febootstrap-supermin-helper(8)> man pages." msgstr "" #. type: =item -#: ../src/guestfs.pod:2487 +#: ../src/guestfs.pod:2558 msgid "Start qemu and boot the kernel" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2489 +#: ../src/guestfs.pod:2560 msgid "qemu is invoked to boot the kernel." msgstr "" #. type: =item -#: ../src/guestfs.pod:2491 +#: ../src/guestfs.pod:2562 msgid "Run the initrd" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2493 +#: ../src/guestfs.pod:2564 msgid "" "C<febootstrap-supermin-helper> builds a small initrd. The initrd is not the " "appliance. The purpose of the initrd is to load enough kernel modules in " @@ -45537,21 +44790,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2497 +#: ../src/guestfs.pod:2568 msgid "" "The initrd is a cpio archive called " "C</var/tmp/.guestfs-E<lt>UIDE<gt>/initrd>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2500 +#: ../src/guestfs.pod:2571 msgid "" "When the initrd has started you will see messages showing that kernel " "modules are being loaded, similar to this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2503 +#: ../src/guestfs.pod:2574 #, no-wrap msgid "" " febootstrap: ext2 mini initrd starting up\n" @@ -45562,12 +44815,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2508 +#: ../src/guestfs.pod:2579 msgid "Find and mount the appliance device" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2510 +#: ../src/guestfs.pod:2581 msgid "" "The appliance is a sparse file containing an ext2 filesystem which contains " "a familiar (although reduced in size) Linux operating system. It would " @@ -45575,33 +44828,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2514 +#: ../src/guestfs.pod:2585 msgid "" "The regular disks being inspected by libguestfs are the first devices " "exposed by qemu (eg. as C</dev/vda>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2517 +#: ../src/guestfs.pod:2588 msgid "" "The last disk added to qemu is the appliance itself (eg. C</dev/vdb> if " "there was only one regular disk)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2520 +#: ../src/guestfs.pod:2591 msgid "" "Thus the final job of the initrd is to locate the appliance disk, mount it, " "and switch root into the appliance, and run C</init> from the appliance." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2524 +#: ../src/guestfs.pod:2595 msgid "If this works successfully you will see messages such as:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2526 +#: ../src/guestfs.pod:2597 #, no-wrap msgid "" " febootstrap: picked /sys/block/vdb/dev as root device\n" @@ -45613,19 +44866,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2532 +#: ../src/guestfs.pod:2603 msgid "" "Note that C<Starting /init script ...> indicates that the appliance's init " "script is now running." msgstr "" #. type: =item -#: ../src/guestfs.pod:2535 +#: ../src/guestfs.pod:2606 msgid "Initialize the appliance" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2537 +#: ../src/guestfs.pod:2608 msgid "" "The appliance itself now initializes itself. This involves starting certain " "processes like C<udev>, possibly printing some debug information, and " @@ -45633,19 +44886,19 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2541 +#: ../src/guestfs.pod:2612 msgid "The daemon" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2543 +#: ../src/guestfs.pod:2614 msgid "" "Finally the daemon (C<guestfsd>) runs inside the appliance. If it runs you " "should see:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2546 +#: ../src/guestfs.pod:2617 #, no-wrap msgid "" " verbose daemon enabled\n" @@ -45653,14 +44906,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2548 +#: ../src/guestfs.pod:2619 msgid "" "The daemon expects to see a named virtio-serial port exposed by qemu and " "connected on the other end to the library." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2551 +#: ../src/guestfs.pod:2622 msgid "" "The daemon connects to this port (and hence to the library) and sends a four " "byte message C<GUESTFS_LAUNCH_FLAG>, which initiates the communication " @@ -45668,19 +44921,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2557 +#: ../src/guestfs.pod:2628 msgid "COMMUNICATION PROTOCOL" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2559 +#: ../src/guestfs.pod:2630 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:2562 +#: ../src/guestfs.pod:2633 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 " @@ -45688,14 +44941,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2566 +#: ../src/guestfs.pod:2637 msgid "" "The detailed format of structures is in C<src/guestfs_protocol.x> (note: " "this file is automatically generated)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2569 +#: ../src/guestfs.pod:2640 msgid "" "There are two broad cases, ordinary functions that don't have any C<FileIn> " "and C<FileOut> parameters, which are handled with very simple request/reply " @@ -45705,17 +44958,17 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2576 +#: ../src/guestfs.pod:2647 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2578 +#: ../src/guestfs.pod:2649 msgid "For ordinary functions, the request message is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2580 +#: ../src/guestfs.pod:2651 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -45726,7 +44979,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2585 +#: ../src/guestfs.pod:2656 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 " @@ -45735,21 +44988,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2591 +#: ../src/guestfs.pod:2662 msgid "" "Note also that many functions don't take any arguments, in which case the " "C<guestfs_I<foo>_args> is completely omitted." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2594 +#: ../src/guestfs.pod:2665 msgid "" "The header contains the procedure number (C<guestfs_proc>) which is how the " "receiver knows what type of args structure to expect, or none at all." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2598 +#: ../src/guestfs.pod:2669 msgid "" "For functions that take optional arguments, the optional arguments are " "encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary " @@ -45761,12 +45014,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2606 +#: ../src/guestfs.pod:2677 msgid "The reply message for ordinary functions is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2608 +#: ../src/guestfs.pod:2679 #, no-wrap msgid "" " total length (header + ret,\n" @@ -45777,26 +45030,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2613 +#: ../src/guestfs.pod:2684 msgid "" "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for " "functions that return no formal return values." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2616 +#: ../src/guestfs.pod:2687 msgid "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2619 +#: ../src/guestfs.pod:2690 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:2622 +#: ../src/guestfs.pod:2693 #, no-wrap msgid "" " total length (header + error,\n" @@ -45807,19 +45060,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2627 +#: ../src/guestfs.pod:2698 msgid "" "The C<guestfs_message_error> structure contains the error message as a " "string." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2630 +#: ../src/guestfs.pod:2701 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2632 +#: ../src/guestfs.pod:2703 msgid "" "A C<FileIn> parameter indicates that we transfer a file I<into> the guest. " "The normal request message is sent (see above). However this is followed by " @@ -45827,7 +45080,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2636 +#: ../src/guestfs.pod:2707 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -45841,12 +45094,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2644 +#: ../src/guestfs.pod:2715 msgid "The \"sequence of chunks\" is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2646 +#: ../src/guestfs.pod:2717 #, no-wrap msgid "" " length of chunk (not including length word itself)\n" @@ -45860,7 +45113,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2654 +#: ../src/guestfs.pod:2725 msgid "" "The final chunk has the C<data_len> field set to zero. Additionally a flag " "is set in the final chunk to indicate either successful completion or early " @@ -45868,7 +45121,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2658 +#: ../src/guestfs.pod:2729 msgid "" "At time of writing there are no functions that have more than one FileIn " "parameter. However this is (theoretically) supported, by sending the " @@ -45877,7 +45130,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2663 +#: ../src/guestfs.pod:2734 msgid "" "Both the library (sender) I<and> the daemon (receiver) may cancel the " "transfer. The library does this by sending a chunk with a special flag set " @@ -45886,7 +45139,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2669 +#: ../src/guestfs.pod:2740 msgid "" "The daemon may also cancel. It does this by writing a special word " "C<GUESTFS_CANCEL_FLAG> to the socket. The library listens for this during " @@ -45898,7 +45151,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2678 +#: ../src/guestfs.pod:2749 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 " @@ -45908,19 +45161,19 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2684 +#: ../src/guestfs.pod:2755 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2686 +#: ../src/guestfs.pod:2757 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:2689 +#: ../src/guestfs.pod:2760 #, no-wrap msgid "" " total length (header + ret,\n" @@ -45934,12 +45187,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2697 +#: ../src/guestfs.pod:2768 msgid "INITIAL MESSAGE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2699 +#: ../src/guestfs.pod:2770 msgid "" "When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) " "which indicates that the guest and daemon is alive. This is what " @@ -45947,12 +45200,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2703 +#: ../src/guestfs.pod:2774 msgid "PROGRESS NOTIFICATION MESSAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2705 +#: ../src/guestfs.pod:2776 msgid "" "The daemon may send progress notification messages at any time. These are " "distinguished by the normal length word being replaced by " @@ -45960,7 +45213,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2709 +#: ../src/guestfs.pod:2780 msgid "" "The library turns them into progress callbacks (see " "L</GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards " @@ -45968,7 +45221,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2713 +#: ../src/guestfs.pod:2784 msgid "" "The daemon self-limits the frequency of progress messages it sends (see " "C<daemon/proto.c:notify_progress>). Not all calls generate progress " @@ -45976,12 +45229,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2717 +#: ../src/guestfs.pod:2788 msgid "LIBGUESTFS VERSION NUMBERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2719 +#: ../src/guestfs.pod:2790 msgid "" "Since April 2010, libguestfs has started to make separate development and " "stable releases, along with corresponding branches in our git repository. " @@ -45989,7 +45242,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2724 +#: ../src/guestfs.pod:2795 #, no-wrap msgid "" " even numbers for stable: 1.2.x, 1.4.x, ...\n" @@ -46006,12 +45259,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2735 +#: ../src/guestfs.pod:2806 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2737 +#: ../src/guestfs.pod:2808 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 " @@ -46021,26 +45274,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2743 +#: ../src/guestfs.pod:2814 msgid "Our criteria for backporting changes are:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2749 +#: ../src/guestfs.pod:2820 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:2755 +#: ../src/guestfs.pod:2826 msgid "" "Bug fixes which are not controversial, fix obvious problems, and have been " "well tested are backported." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2760 +#: ../src/guestfs.pod:2831 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 " @@ -46048,7 +45301,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2766 +#: ../src/guestfs.pod:2837 msgid "" "We I<don't> backport new features, new APIs, new tools etc, except in one " "exceptional case: the new feature is required in order to implement an " @@ -46056,7 +45309,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2772 +#: ../src/guestfs.pod:2843 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 " @@ -46067,17 +45320,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2780 +#: ../src/guestfs.pod:2851 msgid "EXTENDING LIBGUESTFS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2782 +#: ../src/guestfs.pod:2853 msgid "ADDING A NEW API ACTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2784 +#: ../src/guestfs.pod:2855 msgid "" "Large amounts of boilerplate code in libguestfs (RPC, bindings, " "documentation) are generated, and this makes it easy to extend the " @@ -46085,19 +45338,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2788 +#: ../src/guestfs.pod:2859 msgid "To add a new API action there are two changes:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2794 +#: ../src/guestfs.pod:2865 msgid "" "You need to add a description of the call (name, parameters, return type, " "tests, documentation) to C<generator/generator_actions.ml>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2797 +#: ../src/guestfs.pod:2868 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 " @@ -46108,7 +45361,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2805 +#: ../src/guestfs.pod:2876 msgid "" "Most new actions are of the first type, and get added to the " "C<daemon_functions> list. Each function has a unique procedure number used " @@ -46118,7 +45371,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2811 +#: ../src/guestfs.pod:2882 msgid "" "For library-only actions of the second type, add to the " "C<non_daemon_functions> list. Since these functions are serviced by the " @@ -46128,36 +45381,36 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2819 +#: ../src/guestfs.pod:2890 msgid "Implement the action (in C):" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2821 +#: ../src/guestfs.pod:2892 msgid "" "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the " "C<daemon/> directory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2824 +#: ../src/guestfs.pod:2895 msgid "" "For library actions, implement the function C<guestfs__E<lt>nameE<gt>> " "(note: double underscore) in the C<src/> directory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2827 +#: ../src/guestfs.pod:2898 msgid "In either case, use another function as an example of what to do." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2831 +#: ../src/guestfs.pod:2902 msgid "After making these changes, use C<make> to compile." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2833 +#: ../src/guestfs.pod:2904 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 " @@ -46165,12 +45418,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2837 +#: ../src/guestfs.pod:2908 msgid "ADDING TESTS FOR AN API ACTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2839 +#: ../src/guestfs.pod:2910 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 " @@ -46180,61 +45433,61 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2846 +#: ../src/guestfs.pod:2917 msgid "" "The following describes the test environment used when you add an API test " "in C<generator_actions.ml>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2849 +#: ../src/guestfs.pod:2920 msgid "The test environment has 4 block devices:" msgstr "" #. type: =item -#: ../src/guestfs.pod:2853 +#: ../src/guestfs.pod:2924 msgid "C</dev/sda> 500MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2855 +#: ../src/guestfs.pod:2926 msgid "General block device for testing." msgstr "" #. type: =item -#: ../src/guestfs.pod:2857 +#: ../src/guestfs.pod:2928 msgid "C</dev/sdb> 50MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2859 +#: ../src/guestfs.pod:2930 msgid "" "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write " "operations." msgstr "" #. type: =item -#: ../src/guestfs.pod:2862 +#: ../src/guestfs.pod:2933 msgid "C</dev/sdc> 10MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2864 +#: ../src/guestfs.pod:2935 msgid "Used in a few tests where two block devices are needed." msgstr "" #. type: =item -#: ../src/guestfs.pod:2866 +#: ../src/guestfs.pod:2937 msgid "C</dev/sdd>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2868 +#: ../src/guestfs.pod:2939 msgid "ISO with fixed content (see C<images/test.iso>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2872 +#: ../src/guestfs.pod:2943 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 " @@ -46242,7 +45495,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2876 +#: ../src/guestfs.pod:2947 msgid "" "Each test starts with an initial scenario, selected using one of the " "C<Init*> expressions, described in C<generator/generator_types.ml>. These " @@ -46252,7 +45505,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2882 +#: ../src/guestfs.pod:2953 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 " @@ -46262,14 +45515,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2888 +#: ../src/guestfs.pod:2959 msgid "" "In addition, packagers can skip individual tests by setting environment " "variables before running C<make check>." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2891 +#: ../src/guestfs.pod:2962 #, no-wrap msgid "" " SKIP_TEST_<CMD>_<NUM>=1\n" @@ -46277,12 +45530,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2893 +#: ../src/guestfs.pod:2964 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2897 +#: ../src/guestfs.pod:2968 #, no-wrap msgid "" " SKIP_TEST_<CMD>=1\n" @@ -46290,17 +45543,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2899 +#: ../src/guestfs.pod:2970 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2901 +#: ../src/guestfs.pod:2972 msgid "Packagers can run only certain tests by setting for example:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2903 +#: ../src/guestfs.pod:2974 #, no-wrap msgid "" " TEST_ONLY=\"vfs_type zerofree\"\n" @@ -46308,29 +45561,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2905 +#: ../src/guestfs.pod:2976 msgid "" "See C<tests/c-api/tests.c> for more details of how these environment " "variables work." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2908 +#: ../src/guestfs.pod:2979 msgid "DEBUGGING NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2910 +#: ../src/guestfs.pod:2981 msgid "Test new actions work before submitting them." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2912 +#: ../src/guestfs.pod:2983 msgid "You can use guestfish to try out new commands." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2914 +#: ../src/guestfs.pod:2985 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 " @@ -46338,12 +45591,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2918 +#: ../src/guestfs.pod:2989 msgid "FORMATTING CODE AND OTHER CONVENTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2920 +#: ../src/guestfs.pod:2991 msgid "" "Our C source code generally adheres to some basic code-formatting " "conventions. The existing code base is not totally consistent on this " @@ -46353,14 +45606,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2926 +#: ../src/guestfs.pod:2997 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:2929 +#: ../src/guestfs.pod:3000 #, no-wrap msgid "" " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n" @@ -46376,7 +45629,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2939 +#: ../src/guestfs.pod:3010 #, no-wrap msgid "" " ;;; When editing C sources in libguestfs, use this style.\n" @@ -46394,12 +45647,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2951 +#: ../src/guestfs.pod:3022 msgid "Enable warnings when compiling (and fix any problems this finds):" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2954 +#: ../src/guestfs.pod:3025 #, no-wrap msgid "" " ./configure --enable-gcc-warnings\n" @@ -46407,12 +45660,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2956 +#: ../src/guestfs.pod:3027 msgid "Useful targets are:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2958 +#: ../src/guestfs.pod:3029 #, no-wrap msgid "" " make syntax-check # checks the syntax of the C code\n" @@ -46421,43 +45674,43 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2961 +#: ../src/guestfs.pod:3032 msgid "DAEMON CUSTOM PRINTF FORMATTERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2963 +#: ../src/guestfs.pod:3034 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:2968 +#: ../src/guestfs.pod:3039 msgid "%Q" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2970 +#: ../src/guestfs.pod:3041 msgid "" "Simple shell quoted string. Any spaces or other shell characters are " "escaped for you." msgstr "" #. type: =item -#: ../src/guestfs.pod:2973 +#: ../src/guestfs.pod:3044 msgid "%R" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2975 +#: ../src/guestfs.pod:3046 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:2982 +#: ../src/guestfs.pod:3053 #, no-wrap msgid "" " asprintf (&cmd, \"cat %R\", path);\n" @@ -46465,12 +45718,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2984 +#: ../src/guestfs.pod:3055 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2986 +#: ../src/guestfs.pod:3057 msgid "" "I<Note:> Do I<not> use these when you are passing parameters to the " "C<command{,r,v,rv}()> functions. These parameters do NOT need to be quoted " @@ -46479,12 +45732,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2992 +#: ../src/guestfs.pod:3063 msgid "SUBMITTING YOUR NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2994 +#: ../src/guestfs.pod:3065 msgid "" "Submit patches to the mailing list: " "L<http://www.redhat.com/mailman/listinfo/libguestfs> and CC to " @@ -46492,17 +45745,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2998 +#: ../src/guestfs.pod:3069 msgid "INTERNATIONALIZATION (I18N) SUPPORT" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3000 +#: ../src/guestfs.pod:3071 msgid "We support i18n (gettext anyhow) in the library." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3002 +#: ../src/guestfs.pod:3073 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 " @@ -46511,103 +45764,103 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3008 +#: ../src/guestfs.pod:3079 msgid "" "Debugging messages are never translated, since they are intended for the " "programmers." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3011 +#: ../src/guestfs.pod:3082 msgid "SOURCE CODE SUBDIRECTORIES" msgstr "" #. type: =item -#: ../src/guestfs.pod:3015 +#: ../src/guestfs.pod:3086 msgid "C<align>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3017 +#: ../src/guestfs.pod:3088 msgid "L<virt-alignment-scan(1)> command and documentation." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3021 +#: ../src/guestfs.pod:3092 msgid "The libguestfs appliance, build scripts and so on." msgstr "" #. type: =item -#: ../src/guestfs.pod:3023 +#: ../src/guestfs.pod:3094 msgid "C<cat>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3025 +#: ../src/guestfs.pod:3096 msgid "" "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and " "documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3028 +#: ../src/guestfs.pod:3099 msgid "C<contrib>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3030 +#: ../src/guestfs.pod:3101 msgid "Outside contributions, experimental parts." msgstr "" #. type: =item -#: ../src/guestfs.pod:3032 +#: ../src/guestfs.pod:3103 msgid "C<daemon>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3034 +#: ../src/guestfs.pod:3105 msgid "" "The daemon that runs inside the libguestfs appliance and carries out " "actions." msgstr "" #. type: =item -#: ../src/guestfs.pod:3037 +#: ../src/guestfs.pod:3108 msgid "C<df>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3039 +#: ../src/guestfs.pod:3110 msgid "L<virt-df(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3041 +#: ../src/guestfs.pod:3112 msgid "C<edit>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3043 +#: ../src/guestfs.pod:3114 msgid "L<virt-edit(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3045 +#: ../src/guestfs.pod:3116 msgid "C<examples>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3047 +#: ../src/guestfs.pod:3118 msgid "C API example code." msgstr "" #. type: =item -#: ../src/guestfs.pod:3049 +#: ../src/guestfs.pod:3120 msgid "C<fish>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3051 +#: ../src/guestfs.pod:3122 msgid "" "L<guestfish(1)>, the command-line shell, and various shell scripts built on " "top such as L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, " @@ -46615,79 +45868,79 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3057 +#: ../src/guestfs.pod:3128 msgid "L<virt-format(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3059 +#: ../src/guestfs.pod:3130 msgid "C<fuse>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3061 +#: ../src/guestfs.pod:3132 msgid "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:3063 +#: ../src/guestfs.pod:3134 msgid "C<generator>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3065 +#: ../src/guestfs.pod:3136 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:3068 +#: ../src/guestfs.pod:3139 msgid "C<inspector>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3070 +#: ../src/guestfs.pod:3141 msgid "L<virt-inspector(1)>, the virtual machine image inspector." msgstr "" #. type: =item -#: ../src/guestfs.pod:3072 +#: ../src/guestfs.pod:3143 msgid "C<logo>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3074 +#: ../src/guestfs.pod:3145 msgid "Logo used on the website. The fish is called Arthur by the way." msgstr "" #. type: =item -#: ../src/guestfs.pod:3076 +#: ../src/guestfs.pod:3147 msgid "C<m4>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3078 +#: ../src/guestfs.pod:3149 msgid "M4 macros used by autoconf." msgstr "" #. type: =item -#: ../src/guestfs.pod:3080 +#: ../src/guestfs.pod:3151 msgid "C<po>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3082 +#: ../src/guestfs.pod:3153 msgid "Translations of simple gettext strings." msgstr "" #. type: =item -#: ../src/guestfs.pod:3084 +#: ../src/guestfs.pod:3155 msgid "C<po-docs>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3086 +#: ../src/guestfs.pod:3157 msgid "" "The build infrastructure and PO files for translations of manpages and POD " "files. Eventually this will be combined with the C<po> directory, but that " @@ -46695,149 +45948,149 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:3090 +#: ../src/guestfs.pod:3161 msgid "C<rescue>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3092 +#: ../src/guestfs.pod:3163 msgid "L<virt-rescue(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3094 +#: ../src/guestfs.pod:3165 msgid "C<resize>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3096 +#: ../src/guestfs.pod:3167 msgid "L<virt-resize(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3098 +#: ../src/guestfs.pod:3169 msgid "C<sparsify>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3100 +#: ../src/guestfs.pod:3171 msgid "L<virt-sparsify(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3102 +#: ../src/guestfs.pod:3173 msgid "C<src>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3104 +#: ../src/guestfs.pod:3175 msgid "Source code to the C library." msgstr "" #. type: =item -#: ../src/guestfs.pod:3106 +#: ../src/guestfs.pod:3177 msgid "C<sysprep>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3108 +#: ../src/guestfs.pod:3179 msgid "L<virt-sysprep(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3110 +#: ../src/guestfs.pod:3181 msgid "C<test-tool>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3112 +#: ../src/guestfs.pod:3183 msgid "" "Test tool for end users to test if their qemu/kernel combination will work " "with libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:3115 +#: ../src/guestfs.pod:3186 msgid "C<tests>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3117 +#: ../src/guestfs.pod:3188 msgid "Tests." msgstr "" #. type: =item -#: ../src/guestfs.pod:3119 +#: ../src/guestfs.pod:3190 msgid "C<tools>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3121 +#: ../src/guestfs.pod:3192 msgid "Command line tools written in Perl (L<virt-win-reg(1)> and many others)." msgstr "" #. type: =item -#: ../src/guestfs.pod:3123 +#: ../src/guestfs.pod:3194 msgid "C<csharp>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3125 +#: ../src/guestfs.pod:3196 msgid "C<erlang>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3127 +#: ../src/guestfs.pod:3198 msgid "C<gobject>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3129 +#: ../src/guestfs.pod:3200 msgid "C<haskell>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3131 +#: ../src/guestfs.pod:3202 msgid "C<java>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3133 +#: ../src/guestfs.pod:3204 msgid "C<ocaml>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3135 +#: ../src/guestfs.pod:3206 msgid "C<php>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3137 +#: ../src/guestfs.pod:3208 msgid "C<perl>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3139 +#: ../src/guestfs.pod:3210 msgid "C<python>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3141 +#: ../src/guestfs.pod:3212 msgid "C<ruby>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3143 +#: ../src/guestfs.pod:3214 msgid "Language bindings." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3147 +#: ../src/guestfs.pod:3218 msgid "MAKING A STABLE RELEASE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3149 +#: ../src/guestfs.pod:3220 msgid "" "When we make a stable release, there are several steps documented here. See " "L</LIBGUESTFS VERSION NUMBERS> for general information about the stable " @@ -46845,32 +46098,32 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3157 +#: ../src/guestfs.pod:3228 msgid "Check C<make && make check> works on at least Fedora, Debian and Ubuntu." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3162 +#: ../src/guestfs.pod:3233 msgid "Finalize RELEASE-NOTES." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3166 +#: ../src/guestfs.pod:3237 msgid "Update ROADMAP." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3170 +#: ../src/guestfs.pod:3241 msgid "Run C<src/api-support/update-from-tarballs.sh>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3174 +#: ../src/guestfs.pod:3245 msgid "Push and pull from Transifex." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3178 +#: ../src/guestfs.pod:3249 #, no-wrap msgid "" " tx push -s\n" @@ -46878,12 +46131,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3180 +#: ../src/guestfs.pod:3251 msgid "to push the latest POT files to Transifex. Then run:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3182 +#: ../src/guestfs.pod:3253 #, no-wrap msgid "" " ./tx-pull.sh\n" @@ -46891,24 +46144,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3184 +#: ../src/guestfs.pod:3255 msgid "which is a wrapper to pull the latest translated C<*.po> files." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3188 +#: ../src/guestfs.pod:3259 msgid "" "Create new stable and development directories under " "L<http://libguestfs.org/download>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3193 +#: ../src/guestfs.pod:3264 msgid "Create the branch in git:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3195 +#: ../src/guestfs.pod:3266 #, no-wrap msgid "" " git tag -a 1.XX.0 -m \"Version 1.XX.0 (stable)\"\n" @@ -46919,17 +46172,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:3202 +#: ../src/guestfs.pod:3273 msgid "LIMITS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3204 +#: ../src/guestfs.pod:3275 msgid "PROTOCOL LIMITS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3206 +#: ../src/guestfs.pod:3277 msgid "" "Internally libguestfs uses a message-based protocol to pass API calls and " "their responses to and from a small \"appliance\" (see L</INTERNALS> for " @@ -46940,7 +46193,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3214 +#: ../src/guestfs.pod:3285 msgid "" "A simple call such as L</guestfs_cat> returns its result (the file data) in " "a simple string. Because this string is at some point internally encoded as " @@ -46949,7 +46202,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3220 +#: ../src/guestfs.pod:3291 msgid "" "In order to transfer large files into and out of the guest filesystem, you " "need to use particular calls that support this. The sections L</UPLOADING> " @@ -46957,71 +46210,40 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3224 +#: ../src/guestfs.pod:3295 msgid "" "You might also consider mounting the disk image using our FUSE filesystem " "support (L<guestmount(1)>)." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3227 +#: ../src/guestfs.pod:3298 msgid "MAXIMUM NUMBER OF DISKS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3229 -msgid "" -"In libguestfs E<ge> 1.19.7, you can query the maximum number of disks that " -"may be added by calling L</guestfs_max_disks>. In earlier versions of " -"libguestfs (ie. where this call is not available) you should assume the " -"maximum is 25." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3234 -msgid "" -"The rest of this section covers implementation details, which could change " -"in future." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3237 -msgid "" -"When using virtio-scsi disks (the default if available in qemu) the current " -"limit is B<255> disks. When using virtio-blk (the old default) the limit is " -"around B<27> disks, but may vary according to implementation details and " -"whether the network is enabled." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3242 -msgid "" -"Virtio-scsi as used by libguestfs is configured to use one target per disk, " -"and 256 targets are available." +#: ../src/guestfs.pod:3300 +msgid "When using virtio disks (the default) the current limit is B<25> disks." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3245 +#: ../src/guestfs.pod:3303 msgid "" -"Virtio-blk consumes 1 virtual PCI slot per disk, and PCI is limited to 31 " -"slots, but some of these are used for other purposes." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3248 -msgid "One virtual disk is used by libguestfs internally." +"Virtio itself consumes 1 virtual PCI slot per disk, and PCI is limited to 31 " +"slots. However febootstrap only understands disks with names C</dev/vda> " +"through C</dev/vdz> (26 letters) and it reserves one disk for its own " +"purposes." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3250 +#: ../src/guestfs.pod:3308 msgid "" -"Before libguestfs 1.19.7, disk names had to be a single character " -"(eg. C</dev/sda> through C</dev/sdz>), and since one disk is reserved, that " -"meant the limit was 25. This has been fixed in more recent versions." +"We are working to substantially raise this limit in future versions but it " +"requires complex changes to qemu." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3255 +#: ../src/guestfs.pod:3311 msgid "" "In future versions of libguestfs it should also be possible to \"hot plug\" " "disks (add and remove disks after calling L</guestfs_launch>). This also " @@ -47029,41 +46251,41 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3259 +#: ../src/guestfs.pod:3315 msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3261 +#: ../src/guestfs.pod:3317 msgid "Virtio limits the maximum number of partitions per disk to B<15>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3263 +#: ../src/guestfs.pod:3319 msgid "" "This is because it reserves 4 bits for the minor device number (thus " "C</dev/vda>, and C</dev/vda1> through C</dev/vda15>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3266 +#: ../src/guestfs.pod:3322 msgid "" "If you attach a disk with more than 15 partitions, the extra partitions are " "ignored by libguestfs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3269 +#: ../src/guestfs.pod:3325 msgid "MAXIMUM SIZE OF A DISK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3271 +#: ../src/guestfs.pod:3327 msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3273 +#: ../src/guestfs.pod:3329 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 " @@ -47071,7 +46293,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3277 +#: ../src/guestfs.pod:3333 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 " @@ -47081,19 +46303,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3283 +#: ../src/guestfs.pod:3339 msgid "" "For the hugest disk image files, we recommend using XFS on the host for " "storage." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3286 +#: ../src/guestfs.pod:3342 msgid "MAXIMUM SIZE OF A PARTITION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3288 +#: ../src/guestfs.pod:3344 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 " @@ -47101,7 +46323,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3292 +#: ../src/guestfs.pod:3348 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 " @@ -47109,12 +46331,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3297 +#: ../src/guestfs.pod:3353 msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3299 +#: ../src/guestfs.pod:3355 msgid "" "This depends on the filesystem type. libguestfs itself does not impose any " "known limit. Consult Wikipedia or the filesystem documentation to find out " @@ -47122,12 +46344,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3303 +#: ../src/guestfs.pod:3359 msgid "MAXIMUM UPLOAD AND DOWNLOAD" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3305 +#: ../src/guestfs.pod:3361 msgid "" "The API functions L</guestfs_upload>, L</guestfs_download>, " "L</guestfs_tar_in>, L</guestfs_tar_out> and the like allow unlimited sized " @@ -47135,12 +46357,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3309 +#: ../src/guestfs.pod:3365 msgid "INSPECTION LIMITS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3311 +#: ../src/guestfs.pod:3367 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 " @@ -47150,40 +46372,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3337 -msgid "" -"Choose the default way to create the appliance. See " -"L</guestfs_set_attach_method>." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3342 +#: ../src/guestfs.pod:3393 msgid "" "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages. This has the same " "effect as calling C<guestfs_set_verbose (g, 1)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3354 +#: ../src/guestfs.pod:3405 msgid "" "Set the path that libguestfs uses to search for a supermin appliance. See " "the discussion of paths in section L</PATH> above." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3363 +#: ../src/guestfs.pod:3414 msgid "See also L</QEMU WRAPPERS> above." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3367 +#: ../src/guestfs.pod:3418 msgid "" "Set C<LIBGUESTFS_TRACE=1> to enable command traces. This has the same " "effect as calling C<guestfs_set_trace (g, 1)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3385 +#: ../src/guestfs.pod:3436 msgid "" "L<guestfs-examples(3)>, L<guestfs-erlang(3)>, L<guestfs-java(3)>, " "L<guestfs-ocaml(3)>, L<guestfs-perl(3)>, L<guestfs-python(3)>, " @@ -47202,59 +46417,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3427 +#: ../src/guestfs.pod:3478 msgid "" "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, " "L<lvm(8)>, L<disktype(1)>." msgstr "" -#. type: =head1 -#: ../src/guestfs.pod:3434 ../tools/virt-make-fs.pl:624 ../tools/virt-win-reg.pl:772 -msgid "BUGS" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3436 -msgid "To get a list of bugs against libguestfs use this link:" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3438 -msgid "L<https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3440 -msgid "To report a new bug against libguestfs use this link:" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3444 -msgid "When reporting a bug, please check:" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3450 -msgid "That the bug hasn't been reported already." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3454 -msgid "That you are testing a recent version." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3458 -msgid "Describe the bug accurately, and give a way to reproduce it." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3462 -msgid "" -"Run libguestfs-test-tool and paste the B<complete, unedited> output into the " -"bug report." -msgstr "" - #. type: =item #: ../sysprep/sysprep-extra-options.pod:1 msgid "B<--hostname> hostname (see C<hostname> below)" @@ -47312,162 +46480,147 @@ msgstr "" #. type: =head2 #: ../sysprep/sysprep-operations.pod:1 -msgid "B<abrt-data> *" -msgstr "" - -#. type: textblock -#: ../sysprep/sysprep-operations.pod:4 -msgid "Remove the crash data generated by ABRT." -msgstr "" - -#. type: textblock -#: ../sysprep/sysprep-operations.pod:6 -msgid "Remove the automatically generated ABRT crash data in C</var/spool/abrt/>." -msgstr "" - -#. type: =head2 -#: ../sysprep/sysprep-operations.pod:9 msgid "B<bash-history> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:12 +#: ../sysprep/sysprep-operations.pod:4 msgid "Remove the bash history in the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:14 +#: ../sysprep/sysprep-operations.pod:6 msgid "" "Remove the bash history of user \"root\" and any other users who have a " "C<.bash_history> file in their home directory." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:17 +#: ../sysprep/sysprep-operations.pod:9 msgid "B<blkid-tab> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:20 +#: ../sysprep/sysprep-operations.pod:12 msgid "Remove blkid tab in the guest." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:22 +#: ../sysprep/sysprep-operations.pod:14 msgid "B<ca-certificates>" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:24 +#: ../sysprep/sysprep-operations.pod:16 msgid "Remove CA certificates in the guest." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:26 +#: ../sysprep/sysprep-operations.pod:18 msgid "B<cron-spool> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:29 +#: ../sysprep/sysprep-operations.pod:21 msgid "Remove user at-jobs and cron-jobs." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:31 +#: ../sysprep/sysprep-operations.pod:23 msgid "B<dhcp-client-state> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:34 +#: ../sysprep/sysprep-operations.pod:26 msgid "Remove DHCP client leases." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:36 +#: ../sysprep/sysprep-operations.pod:28 msgid "B<dhcp-server-state> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:39 +#: ../sysprep/sysprep-operations.pod:31 msgid "Remove DHCP server leases." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:41 +#: ../sysprep/sysprep-operations.pod:33 msgid "B<dovecot-data> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:44 +#: ../sysprep/sysprep-operations.pod:36 msgid "Remove Dovecot (mail server) data." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:46 +#: ../sysprep/sysprep-operations.pod:38 msgid "B<flag-reconfiguration>" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:48 +#: ../sysprep/sysprep-operations.pod:40 msgid "Flag the system for reconfiguration." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:50 +#: ../sysprep/sysprep-operations.pod:42 msgid "Note that this may require user intervention when the guest is booted." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:53 +#: ../sysprep/sysprep-operations.pod:45 msgid "B<hostname> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:56 +#: ../sysprep/sysprep-operations.pod:48 msgid "Change the hostname of the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:58 +#: ../sysprep/sysprep-operations.pod:50 msgid "" "This operation changes the hostname of the guest to the value given in the " "I<--hostname> parameter." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:61 +#: ../sysprep/sysprep-operations.pod:53 msgid "" "If the I<--hostname> parameter is not given, then the hostname is changed to " "C<localhost.localdomain>." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:64 +#: ../sysprep/sysprep-operations.pod:56 msgid "B<kerberos-data>" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:66 +#: ../sysprep/sysprep-operations.pod:58 msgid "Remove Kerberos data in the guest." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:68 +#: ../sysprep/sysprep-operations.pod:60 msgid "B<logfiles> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:71 +#: ../sysprep/sysprep-operations.pod:63 msgid "Remove many log files from the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:73 +#: ../sysprep/sysprep-operations.pod:65 msgid "On Linux the following files are removed:" msgstr "" #. type: verbatim -#: ../sysprep/sysprep-operations.pod:75 +#: ../sysprep/sysprep-operations.pod:67 #, no-wrap msgid "" " /root/anaconda-ks.cfg\n" @@ -47511,159 +46664,113 @@ msgid "" msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:113 -msgid "B<lvm-uuids> *" -msgstr "" - -#. type: textblock -#: ../sysprep/sysprep-operations.pod:116 -msgid "Change LVM2 PV and VG UUIDs." -msgstr "" - -#. type: textblock -#: ../sysprep/sysprep-operations.pod:118 -msgid "" -"On Linux guests that have LVM2 physical volumes (PVs) or volume groups " -"(VGs), new random UUIDs are generated and assigned to those PVs and VGs." -msgstr "" - -#. type: =head2 -#: ../sysprep/sysprep-operations.pod:121 -msgid "B<machine-id> *" -msgstr "" - -#. type: textblock -#: ../sysprep/sysprep-operations.pod:124 -msgid "Remove the local machine ID." -msgstr "" - -#. type: textblock -#: ../sysprep/sysprep-operations.pod:126 -msgid "" -"The machine ID is usually generated from a random source during system " -"installation and stays constant for all subsequent boots. Optionally, for " -"stateless systems it is generated during runtime at boot if it is found to " -"be empty." -msgstr "" - -#. type: =head2 -#: ../sysprep/sysprep-operations.pod:131 +#: ../sysprep/sysprep-operations.pod:105 msgid "B<mail-spool> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:134 +#: ../sysprep/sysprep-operations.pod:108 msgid "Remove email from the local mail spool directory." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:136 +#: ../sysprep/sysprep-operations.pod:110 msgid "B<net-hwaddr> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:139 +#: ../sysprep/sysprep-operations.pod:113 msgid "Remove HWADDR (hard-coded MAC address) configuration." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:141 +#: ../sysprep/sysprep-operations.pod:115 msgid "" "For Fedora and Red Hat Enterprise Linux, this is removed from C<ifcfg-*> " "files." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:144 +#: ../sysprep/sysprep-operations.pod:118 msgid "B<package-manager-cache> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:147 +#: ../sysprep/sysprep-operations.pod:121 msgid "Remove package manager cache." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:149 +#: ../sysprep/sysprep-operations.pod:123 msgid "B<pam-data> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:152 +#: ../sysprep/sysprep-operations.pod:126 msgid "Remove the PAM data in the guest." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:154 -msgid "B<puppet-data-log> *" -msgstr "" - -#. type: textblock -#: ../sysprep/sysprep-operations.pod:157 -msgid "Remove the data and log files of puppet." -msgstr "" - -#. type: =head2 -#: ../sysprep/sysprep-operations.pod:159 +#: ../sysprep/sysprep-operations.pod:128 msgid "B<random-seed> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:162 +#: ../sysprep/sysprep-operations.pod:131 msgid "Generate random seed for guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:164 +#: ../sysprep/sysprep-operations.pod:133 msgid "" "Write some random bytes from the host into the random seed file of the " "guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:167 +#: ../sysprep/sysprep-operations.pod:136 msgid "See L</RANDOM SEED> below." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:169 +#: ../sysprep/sysprep-operations.pod:138 msgid "B<rhn-systemid> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:172 +#: ../sysprep/sysprep-operations.pod:141 msgid "Remove the RHN system ID." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:174 +#: ../sysprep/sysprep-operations.pod:143 msgid "B<samba-db-log> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:177 +#: ../sysprep/sysprep-operations.pod:146 msgid "Remove the database and log files of Samba." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:179 +#: ../sysprep/sysprep-operations.pod:148 msgid "B<script> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:182 +#: ../sysprep/sysprep-operations.pod:151 msgid "Run arbitrary scripts against the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:184 +#: ../sysprep/sysprep-operations.pod:153 msgid "" "The C<script> module lets you run arbitrary shell scripts or programs " "against the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:187 +#: ../sysprep/sysprep-operations.pod:156 msgid "" "Note this feature requires FUSE support. You may have to enable this in " "your host, for example by adding the current user to the C<fuse> group, or " @@ -47671,14 +46778,14 @@ msgid "" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:191 +#: ../sysprep/sysprep-operations.pod:160 msgid "" "Use one or more I<--script> parameters to specify scripts or programs that " "will be run against the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:194 +#: ../sysprep/sysprep-operations.pod:163 msgid "" "The script or program is run with its current directory being the guest's " "root directory, so relative paths should be used. For example: C<rm " @@ -47688,48 +46795,48 @@ msgid "" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:200 +#: ../sysprep/sysprep-operations.pod:169 msgid "" "Normally a temporary mount point for the guest is used, but you can choose a " "specific one by using the I<--scriptdir> parameter." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:203 +#: ../sysprep/sysprep-operations.pod:172 msgid "B<smolt-uuid> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:206 +#: ../sysprep/sysprep-operations.pod:175 msgid "Remove the Smolt hardware UUID." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:208 +#: ../sysprep/sysprep-operations.pod:177 msgid "B<ssh-hostkeys> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:211 +#: ../sysprep/sysprep-operations.pod:180 msgid "Remove the SSH host keys in the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:213 +#: ../sysprep/sysprep-operations.pod:182 msgid "" "The SSH host keys are regenerated (differently) next time the guest is " "booted." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:216 +#: ../sysprep/sysprep-operations.pod:185 msgid "" "If, after cloning, the guest gets the same IP address, ssh will give you a " "stark warning about the host key changing:" msgstr "" #. type: verbatim -#: ../sysprep/sysprep-operations.pod:219 +#: ../sysprep/sysprep-operations.pod:188 #, no-wrap msgid "" " @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n" @@ -47740,51 +46847,51 @@ msgid "" msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:224 +#: ../sysprep/sysprep-operations.pod:193 msgid "B<ssh-userdir> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:227 +#: ../sysprep/sysprep-operations.pod:196 msgid "Remove \".ssh\" directories in the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:229 +#: ../sysprep/sysprep-operations.pod:198 msgid "" "Remove the C<.ssh> directory of user \"root\" and any other users who have a " "C<.ssh> directory in their home directory." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:232 +#: ../sysprep/sysprep-operations.pod:201 msgid "B<sssd-db-log> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:235 +#: ../sysprep/sysprep-operations.pod:204 msgid "Remove the database and log files of sssd." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:237 +#: ../sysprep/sysprep-operations.pod:206 msgid "B<udev-persistent-net> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:240 +#: ../sysprep/sysprep-operations.pod:209 msgid "Remove udev persistent net rules." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:242 +#: ../sysprep/sysprep-operations.pod:211 msgid "" "Remove udev persistent net rules which map the guest's existing MAC address " "to a fixed ethernet device (eg. eth0)." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:245 +#: ../sysprep/sysprep-operations.pod:214 msgid "" "After a guest is cloned, the MAC address usually changes. Since the old MAC " "address occupies the old name (eg. eth0), this means the fresh MAC address " @@ -47793,34 +46900,34 @@ msgid "" msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:250 +#: ../sysprep/sysprep-operations.pod:219 msgid "B<user-account>" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:252 +#: ../sysprep/sysprep-operations.pod:221 msgid "Remove the user accounts in the guest." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:254 +#: ../sysprep/sysprep-operations.pod:223 msgid "" "Remove all the user accounts and their home directories. The \"root\" " "account is not removed." msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:257 +#: ../sysprep/sysprep-operations.pod:226 msgid "B<utmp> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:260 +#: ../sysprep/sysprep-operations.pod:229 msgid "Remove the utmp file." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:262 +#: ../sysprep/sysprep-operations.pod:231 msgid "" "This file records who is currently logged in on a machine. In modern Linux " "distros it is stored in a ramdisk and hence not part of the virtual " @@ -47828,17 +46935,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../sysprep/sysprep-operations.pod:266 +#: ../sysprep/sysprep-operations.pod:235 msgid "B<yum-uuid> *" msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:269 +#: ../sysprep/sysprep-operations.pod:238 msgid "Remove the yum UUID." msgstr "" #. type: textblock -#: ../sysprep/sysprep-operations.pod:271 +#: ../sysprep/sysprep-operations.pod:240 msgid "" "Yum creates a fresh UUID the next time it runs when it notices that the " "original UUID has been erased." @@ -48550,11 +47657,6 @@ msgid "Wanlong Gao, Fujitsu Ltd." msgstr "" #. type: textblock -#: ../sysprep/virt-sysprep.pod:465 -msgid "Copyright (C) 2011-2012 Red Hat Inc." -msgstr "" - -#. type: textblock #: ../sysprep/virt-sysprep.pod:467 msgid "Copyright (C) 2012 Fujitsu Ltd." msgstr "" @@ -48995,34 +48097,25 @@ msgstr "" msgid "Useful if exporting data to a Windows guest." msgstr "" -#. type: textblock -#: ../tools/virt-make-fs.pl:88 -msgid "" -"I<Note for vfat>: The tar archive or local directory must only contain files " -"which are owned by root (ie. UID:GID = 0:0). The reason is that the tar " -"program running within libguestfs is unable to change the ownership of " -"non-root files, since vfat itself does not support this." -msgstr "" - #. type: =item -#: ../tools/virt-make-fs.pl:93 +#: ../tools/virt-make-fs.pl:88 msgid "I<minix>" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:95 +#: ../tools/virt-make-fs.pl:90 msgid "" "Lower overhead than C<ext2>, but certain limitations on filename length and " "total filesystem size." msgstr "" #. type: =head3 -#: ../tools/virt-make-fs.pl:100 ../tools/virt-make-fs.pl:119 ../tools/virt-make-fs.pl:152 +#: ../tools/virt-make-fs.pl:95 ../tools/virt-make-fs.pl:114 ../tools/virt-make-fs.pl:147 msgid "EXAMPLE" msgstr "" #. type: verbatim -#: ../tools/virt-make-fs.pl:102 +#: ../tools/virt-make-fs.pl:97 #, no-wrap msgid "" " virt-make-fs --type=minix input minixfs.img\n" @@ -49030,17 +48123,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../tools/virt-make-fs.pl:104 +#: ../tools/virt-make-fs.pl:99 msgid "TO PARTITION OR NOT TO PARTITION" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:106 +#: ../tools/virt-make-fs.pl:101 msgid "Optionally virt-make-fs can add a partition table to the output disk." msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:108 +#: ../tools/virt-make-fs.pl:103 msgid "" "Adding a partition can make the disk image more compatible with certain " "virtualized operating systems which don't expect to see a filesystem " @@ -49049,7 +48142,7 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:113 +#: ../tools/virt-make-fs.pl:108 msgid "" "On the other hand, if you have a partition table then the output image is no " "longer a straight filesystem. For example you cannot run L<fsck(8)> " @@ -49058,12 +48151,12 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:121 +#: ../tools/virt-make-fs.pl:116 msgid "Add an MBR partition:" msgstr "" #. type: verbatim -#: ../tools/virt-make-fs.pl:123 +#: ../tools/virt-make-fs.pl:118 #, no-wrap msgid "" " virt-make-fs --partition -- input disk.img\n" @@ -49071,14 +48164,14 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:125 +#: ../tools/virt-make-fs.pl:120 msgid "" "If the output disk image could be terabyte-sized or larger, it's better to " "use an EFI/GPT-compatible partition table:" msgstr "" #. type: verbatim -#: ../tools/virt-make-fs.pl:128 +#: ../tools/virt-make-fs.pl:123 #, no-wrap msgid "" " virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n" @@ -49086,12 +48179,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../tools/virt-make-fs.pl:130 +#: ../tools/virt-make-fs.pl:125 msgid "EXTRA SPACE" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:132 +#: ../tools/virt-make-fs.pl:127 msgid "" "Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" " "the files that it contains, but might have extra space. Depending on how " @@ -49103,7 +48196,7 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:140 +#: ../tools/virt-make-fs.pl:135 msgid "" "An alternative way to leave extra space but not make the output image any " "bigger is to use an alternative disk image format (instead of the default " @@ -49114,7 +48207,7 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:148 +#: ../tools/virt-make-fs.pl:143 msgid "" "Don't forget that you can also use local commands including L<resize2fs(8)> " "and L<virt-resize(1)> to resize existing filesystems, or rerun virt-make-fs " @@ -49122,7 +48215,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../tools/virt-make-fs.pl:154 +#: ../tools/virt-make-fs.pl:149 #, no-wrap msgid "" " virt-make-fs --format=qcow2 --size=+200M input output.img\n" @@ -49130,61 +48223,44 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:182 +#: ../tools/virt-make-fs.pl:177 msgid "Enable debugging information." msgstr "" #. type: =item -#: ../tools/virt-make-fs.pl:186 -msgid "B<--floppy>" -msgstr "" - -#. type: textblock -#: ../tools/virt-make-fs.pl:188 -msgid "Create a virtual floppy disk." -msgstr "" - -#. type: textblock -#: ../tools/virt-make-fs.pl:190 -msgid "" -"Currently this preselects the size (1440K), partition type (MBR) and " -"filesystem type (VFAT). In future it may also choose the geometry." -msgstr "" - -#. type: =item -#: ../tools/virt-make-fs.pl:197 +#: ../tools/virt-make-fs.pl:183 msgid "B<--size=E<lt>NE<gt>>" msgstr "" #. type: =item -#: ../tools/virt-make-fs.pl:199 +#: ../tools/virt-make-fs.pl:185 msgid "B<--size=+E<lt>NE<gt>>" msgstr "" #. type: =item -#: ../tools/virt-make-fs.pl:201 +#: ../tools/virt-make-fs.pl:187 msgid "B<-s E<lt>NE<gt>>" msgstr "" #. type: =item -#: ../tools/virt-make-fs.pl:203 +#: ../tools/virt-make-fs.pl:189 msgid "B<-s +E<lt>NE<gt>>" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:205 +#: ../tools/virt-make-fs.pl:191 msgid "Use the I<--size> (or I<-s>) option to choose the size of the output image." msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:208 +#: ../tools/virt-make-fs.pl:194 msgid "" "If this option is I<not> given, then the output image will be just large " "enough to contain all the files, with not much wasted space." msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:211 +#: ../tools/virt-make-fs.pl:197 msgid "" "To choose a fixed size output disk, specify an absolute number followed by " "b/K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, " @@ -49193,7 +48269,7 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:216 +#: ../tools/virt-make-fs.pl:202 msgid "" "To leave extra space, specify C<+> (plus sign) and a number followed by " "b/K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, " @@ -49202,7 +48278,7 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:222 +#: ../tools/virt-make-fs.pl:208 msgid "" "Note that virt-make-fs estimates free space, and therefore will not produce " "filesystems containing precisely the free space requested. (It is much more " @@ -49211,85 +48287,85 @@ msgid "" msgstr "" #. type: =item -#: ../tools/virt-make-fs.pl:231 +#: ../tools/virt-make-fs.pl:217 msgid "B<--format=E<lt>fmtE<gt>>" msgstr "" #. type: =item -#: ../tools/virt-make-fs.pl:233 +#: ../tools/virt-make-fs.pl:219 msgid "B<-F E<lt>fmtE<gt>>" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:235 +#: ../tools/virt-make-fs.pl:221 msgid "Choose the output disk image format." msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:237 +#: ../tools/virt-make-fs.pl:223 msgid "The default is C<raw> (raw sparse disk image)." msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:239 +#: ../tools/virt-make-fs.pl:225 msgid "" "For other choices, see the L<qemu-img(1)> manpage. The only other choice " "that would really make sense here is C<qcow2>." msgstr "" #. type: =item -#: ../tools/virt-make-fs.pl:246 +#: ../tools/virt-make-fs.pl:232 msgid "B<--type=E<lt>fsE<gt>>" msgstr "" #. type: =item -#: ../tools/virt-make-fs.pl:248 +#: ../tools/virt-make-fs.pl:234 msgid "B<-t E<lt>fsE<gt>>" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:250 +#: ../tools/virt-make-fs.pl:236 msgid "Choose the output filesystem type." msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:252 +#: ../tools/virt-make-fs.pl:238 msgid "The default is C<ext2>." msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:254 +#: ../tools/virt-make-fs.pl:240 msgid "Any filesystem which is supported read-write by libguestfs can be used here." msgstr "" #. type: =item -#: ../tools/virt-make-fs.pl:263 +#: ../tools/virt-make-fs.pl:249 msgid "B<--partition=E<lt>parttypeE<gt>>" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:265 +#: ../tools/virt-make-fs.pl:251 msgid "" "If specified, this flag adds an MBR partition table to the output disk " "image." msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:268 +#: ../tools/virt-make-fs.pl:254 msgid "" "You can change the partition table type, eg. I<--partition=gpt> for large " "disks." msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:271 +#: ../tools/virt-make-fs.pl:257 msgid "" "Note that if you just use a lonesome I<--partition>, the Perl option parser " "might consider the next parameter to be the partition type. For example:" msgstr "" #. type: verbatim -#: ../tools/virt-make-fs.pl:275 +#: ../tools/virt-make-fs.pl:261 #, no-wrap msgid "" " virt-make-fs --partition input.tar output.img\n" @@ -49297,7 +48373,7 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:277 +#: ../tools/virt-make-fs.pl:263 msgid "" "would cause virt-make-fs to think you wanted to use a partition type of " "C<input.tar> which is completely wrong. To avoid this, use I<--> (a double " @@ -49305,7 +48381,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../tools/virt-make-fs.pl:281 +#: ../tools/virt-make-fs.pl:267 #, no-wrap msgid "" " virt-make-fs --partition -- input.tar output.img\n" @@ -49313,12 +48389,12 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:283 +#: ../tools/virt-make-fs.pl:269 msgid "For MBR, virt-make-fs sets the partition type byte automatically." msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:611 +#: ../tools/virt-make-fs.pl:592 msgid "" "L<guestfish(1)>, L<virt-format(1)>, L<virt-resize(1)>, L<virt-tar-in(1)>, " "L<mkisofs(1)>, L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, " @@ -49327,29 +48403,6 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-make-fs.pl:626 ../tools/virt-win-reg.pl:774 -msgid "" -"When reporting bugs, please enable debugging and capture the I<complete> " -"output:" -msgstr "" - -#. type: verbatim -#: ../tools/virt-make-fs.pl:629 -#, no-wrap -msgid "" -" export LIBGUESTFS_DEBUG=1\n" -" virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n" -"\n" -msgstr "" - -#. type: textblock -#: ../tools/virt-make-fs.pl:632 -msgid "" -"Attach /tmp/virt-make-fs.log to a new bug report at " -"L<https://bugzilla.redhat.com/>" -msgstr "" - -#. type: textblock #: ../tools/virt-tar.pl:33 msgid "virt-tar - Extract or upload files to a virtual machine" msgstr "" @@ -50217,18 +49270,7 @@ msgid "" "L<Sys::Virt(3)>, L<http://libguestfs.org/>." msgstr "" -#. type: verbatim -#: ../tools/virt-win-reg.pl:777 -#, no-wrap -msgid "" -" export LIBGUESTFS_DEBUG=1\n" -" virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n" -"\n" -msgstr "" - #. type: textblock -#: ../tools/virt-win-reg.pl:780 -msgid "" -"Attach /tmp/virt-win-reg.log to a new bug report at " -"L<https://bugzilla.redhat.com/>" +#: ../tools/virt-win-reg.pl:778 +msgid "Copyright (C) 2010 Red Hat Inc." msgstr "" |