diff options
| author | Richard W.M. Jones <rjones@redhat.com> | 2011-10-26 14:09:39 +0100 |
|---|---|---|
| committer | Richard W.M. Jones <rjones@redhat.com> | 2011-10-26 14:09:39 +0100 |
| commit | ced99cf69e55515a58b4651767bda4ab17c82776 (patch) | |
| tree | 9061d2ebd23a04e2e2abd82f7fa4e00704271e74 /po-docs/libguestfs-docs.pot | |
| parent | d64fca7b848df36f2043a8af72aaa670e3c14c53 (diff) | |
| download | libguestfs-ced99cf69e55515a58b4651767bda4ab17c82776.tar.gz libguestfs-ced99cf69e55515a58b4651767bda4ab17c82776.tar.xz libguestfs-ced99cf69e55515a58b4651767bda4ab17c82776.zip | |
Version 1.13.25.1.13.25
Diffstat (limited to 'po-docs/libguestfs-docs.pot')
| -rw-r--r-- | po-docs/libguestfs-docs.pot | 7527 |
1 files changed, 4053 insertions, 3474 deletions
diff --git a/po-docs/libguestfs-docs.pot b/po-docs/libguestfs-docs.pot index 83a75dfe..a7ee9be7 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.13.24\n" +"Project-Id-Version: libguestfs 1.13.25\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2011-10-24 17:16+0200\n" +"POT-Creation-Date: 2011-10-26 14:08+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" @@ -212,12 +212,12 @@ msgid "If you just want the exit code with no output, use the I<-q> option." msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:89 ../cat/virt-cat.pod:62 ../cat/virt-filesystems.pod:91 ../cat/virt-ls.pod:261 ../clone/virt-sysprep.pod:42 ../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 ../fuse/guestmount.pod:92 ../inspector/virt-inspector.pod:55 ../rescue/virt-rescue.pod:84 ../resize/virt-resize.pod:241 ../sparsify/virt-sparsify.pod:99 ../test-tool/libguestfs-test-tool.pod:36 ../tools/virt-list-filesystems.pl:53 ../tools/virt-list-partitions.pl:54 ../tools/virt-make-fs.pl:153 ../tools/virt-tar.pl:103 ../tools/virt-win-reg.pl:96 +#: ../align/virt-alignment-scan.pod:89 ../cat/virt-cat.pod:62 ../cat/virt-filesystems.pod:91 ../cat/virt-ls.pod:261 ../clone/virt-sysprep.pod:42 ../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 ../fuse/guestmount.pod:92 ../inspector/virt-inspector.pod:55 ../rescue/virt-rescue.pod:84 ../resize/virt-resize.pod:262 ../sparsify/virt-sparsify.pod:99 ../test-tool/libguestfs-test-tool.pod:36 ../tools/virt-list-filesystems.pl:53 ../tools/virt-list-partitions.pl:54 ../tools/virt-make-fs.pl:153 ../tools/virt-tar.pl:103 ../tools/virt-win-reg.pl:96 msgid "OPTIONS" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:93 ../cat/virt-cat.pod:66 ../cat/virt-filesystems.pod:95 ../cat/virt-ls.pod:265 ../clone/virt-sysprep.pod:46 ../df/virt-df.pod:63 ../edit/virt-edit.pod:66 ../fish/guestfish.pod:152 ../fuse/guestmount.pod:160 ../inspector/virt-inspector.pod:59 ../rescue/virt-rescue.pod:88 ../resize/virt-resize.pod:245 ../sparsify/virt-sparsify.pod:103 ../test-tool/libguestfs-test-tool.pod:40 ../tools/virt-list-filesystems.pl:61 ../tools/virt-list-partitions.pl:62 ../tools/virt-make-fs.pl:161 ../tools/virt-tar.pl:111 ../tools/virt-win-reg.pl:104 +#: ../align/virt-alignment-scan.pod:93 ../cat/virt-cat.pod:66 ../cat/virt-filesystems.pod:95 ../cat/virt-ls.pod:265 ../clone/virt-sysprep.pod:46 ../df/virt-df.pod:63 ../edit/virt-edit.pod:66 ../fish/guestfish.pod:152 ../fuse/guestmount.pod:160 ../inspector/virt-inspector.pod:59 ../rescue/virt-rescue.pod:88 ../resize/virt-resize.pod:266 ../sparsify/virt-sparsify.pod:103 ../test-tool/libguestfs-test-tool.pod:40 ../tools/virt-list-filesystems.pl:61 ../tools/virt-list-partitions.pl:62 ../tools/virt-make-fs.pl:161 ../tools/virt-tar.pl:111 ../tools/virt-win-reg.pl:104 msgid "B<--help>" msgstr "" @@ -309,7 +309,7 @@ msgid "" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:132 ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337 ../clone/virt-sysprep.pod:104 ../df/virt-df.pod:110 ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242 ../fish/guestfish.pod:673 ../inspector/virt-inspector.pod:336 ../rescue/virt-rescue.pod:133 ../src/guestfs.pod:2862 +#: ../align/virt-alignment-scan.pod:132 ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337 ../clone/virt-sysprep.pod:104 ../df/virt-df.pod:110 ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242 ../fish/guestfish.pod:673 ../inspector/virt-inspector.pod:336 ../rescue/virt-rescue.pod:133 ../src/guestfs.pod:2877 msgid "For example:" msgstr "" @@ -350,12 +350,12 @@ msgid "" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:147 ../resize/virt-resize.pod:470 ../sparsify/virt-sparsify.pod:153 +#: ../align/virt-alignment-scan.pod:147 ../resize/virt-resize.pod:491 ../sparsify/virt-sparsify.pod:153 msgid "B<-q>" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:149 ../resize/virt-resize.pod:472 ../sparsify/virt-sparsify.pod:155 +#: ../align/virt-alignment-scan.pod:149 ../resize/virt-resize.pod:493 ../sparsify/virt-sparsify.pod:155 msgid "B<--quiet>" msgstr "" @@ -382,17 +382,17 @@ msgid "Enable verbose messages for debugging." msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:160 ../cat/virt-cat.pod:140 ../cat/virt-filesystems.pod:267 ../cat/virt-ls.pod:431 ../clone/virt-sysprep.pod:144 ../df/virt-df.pod:179 ../edit/virt-edit.pod:167 ../fish/guestfish.pod:397 ../fuse/guestmount.pod:272 ../inspector/virt-inspector.pod:125 ../rescue/virt-rescue.pod:188 ../resize/virt-resize.pod:540 ../sparsify/virt-sparsify.pod:165 +#: ../align/virt-alignment-scan.pod:160 ../cat/virt-cat.pod:140 ../cat/virt-filesystems.pod:267 ../cat/virt-ls.pod:431 ../clone/virt-sysprep.pod:144 ../df/virt-df.pod:179 ../edit/virt-edit.pod:167 ../fish/guestfish.pod:397 ../fuse/guestmount.pod:272 ../inspector/virt-inspector.pod:125 ../rescue/virt-rescue.pod:188 ../resize/virt-resize.pod:561 ../sparsify/virt-sparsify.pod:165 msgid "B<-V>" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:162 ../cat/virt-cat.pod:142 ../cat/virt-filesystems.pod:269 ../cat/virt-ls.pod:433 ../clone/virt-sysprep.pod:146 ../df/virt-df.pod:181 ../edit/virt-edit.pod:169 ../fish/guestfish.pod:399 ../fuse/guestmount.pod:274 ../inspector/virt-inspector.pod:127 ../rescue/virt-rescue.pod:190 ../resize/virt-resize.pod:542 ../sparsify/virt-sparsify.pod:167 ../tools/virt-list-filesystems.pl:69 ../tools/virt-list-partitions.pl:70 ../tools/virt-make-fs.pl:169 ../tools/virt-tar.pl:119 ../tools/virt-win-reg.pl:112 +#: ../align/virt-alignment-scan.pod:162 ../cat/virt-cat.pod:142 ../cat/virt-filesystems.pod:269 ../cat/virt-ls.pod:433 ../clone/virt-sysprep.pod:146 ../df/virt-df.pod:181 ../edit/virt-edit.pod:169 ../fish/guestfish.pod:399 ../fuse/guestmount.pod:274 ../inspector/virt-inspector.pod:127 ../rescue/virt-rescue.pod:190 ../resize/virt-resize.pod:563 ../sparsify/virt-sparsify.pod:167 ../tools/virt-list-filesystems.pl:69 ../tools/virt-list-partitions.pl:70 ../tools/virt-make-fs.pl:169 ../tools/virt-tar.pl:119 ../tools/virt-win-reg.pl:112 msgid "B<--version>" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:164 ../cat/virt-cat.pod:144 ../cat/virt-filesystems.pod:271 ../cat/virt-ls.pod:435 ../clone/virt-sysprep.pod:148 ../df/virt-df.pod:183 ../edit/virt-edit.pod:171 ../inspector/virt-inspector.pod:129 ../rescue/virt-rescue.pod:192 ../resize/virt-resize.pod:544 ../sparsify/virt-sparsify.pod:169 ../tools/virt-list-filesystems.pl:71 ../tools/virt-list-partitions.pl:72 ../tools/virt-make-fs.pl:171 ../tools/virt-tar.pl:121 ../tools/virt-win-reg.pl:114 +#: ../align/virt-alignment-scan.pod:164 ../cat/virt-cat.pod:144 ../cat/virt-filesystems.pod:271 ../cat/virt-ls.pod:435 ../clone/virt-sysprep.pod:148 ../df/virt-df.pod:183 ../edit/virt-edit.pod:171 ../inspector/virt-inspector.pod:129 ../rescue/virt-rescue.pod:192 ../resize/virt-resize.pod:565 ../sparsify/virt-sparsify.pod:169 ../tools/virt-list-filesystems.pl:71 ../tools/virt-list-partitions.pl:72 ../tools/virt-make-fs.pl:171 ../tools/virt-tar.pl:121 ../tools/virt-win-reg.pl:114 msgid "Display version number and exit." msgstr "" @@ -649,12 +649,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:296 ../cat/virt-cat.pod:191 ../cat/virt-filesystems.pod:365 ../cat/virt-ls.pod:483 ../clone/virt-sysprep.pod:475 ../df/virt-df.pod:215 ../edit/virt-edit.pod:342 ../inspector/virt-inspector.pod:352 ../rescue/virt-rescue.pod:266 ../resize/virt-resize.pod:655 ../tools/virt-list-filesystems.pl:188 ../tools/virt-list-partitions.pl:258 ../tools/virt-make-fs.pl:550 ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:744 +#: ../align/virt-alignment-scan.pod:296 ../cat/virt-cat.pod:231 ../cat/virt-filesystems.pod:373 ../cat/virt-ls.pod:483 ../clone/virt-sysprep.pod:475 ../df/virt-df.pod:215 ../edit/virt-edit.pod:342 ../inspector/virt-inspector.pod:352 ../rescue/virt-rescue.pod:266 ../resize/virt-resize.pod:676 ../tools/virt-list-filesystems.pl:188 ../tools/virt-list-partitions.pl:258 ../tools/virt-make-fs.pl:550 ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:744 msgid "SHELL QUOTING" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:298 ../cat/virt-cat.pod:193 ../cat/virt-filesystems.pod:367 ../cat/virt-ls.pod:485 ../clone/virt-sysprep.pod:477 ../df/virt-df.pod:217 ../edit/virt-edit.pod:344 ../inspector/virt-inspector.pod:354 ../rescue/virt-rescue.pod:268 ../resize/virt-resize.pod:657 ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:552 ../tools/virt-tar.pl:291 ../tools/virt-win-reg.pl:752 +#: ../align/virt-alignment-scan.pod:298 ../cat/virt-cat.pod:233 ../cat/virt-filesystems.pod:375 ../cat/virt-ls.pod:485 ../clone/virt-sysprep.pod:477 ../df/virt-df.pod:217 ../edit/virt-edit.pod:344 ../inspector/virt-inspector.pod:354 ../rescue/virt-rescue.pod:268 ../resize/virt-resize.pod:678 ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:552 ../tools/virt-tar.pl:291 ../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 " @@ -663,7 +663,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:303 ../cat/virt-cat.pod:198 ../cat/virt-filesystems.pod:372 ../cat/virt-ls.pod:490 ../clone/virt-sysprep.pod:482 ../df/virt-df.pod:222 ../edit/virt-edit.pod:349 ../fish/guestfish.pod:1114 ../fuse/guestmount.pod:312 ../inspector/virt-inspector.pod:375 ../resize/virt-resize.pod:662 ../sparsify/virt-sparsify.pod:227 ../test-tool/libguestfs-test-tool.pod:90 +#: ../align/virt-alignment-scan.pod:303 ../cat/virt-cat.pod:238 ../cat/virt-filesystems.pod:380 ../cat/virt-ls.pod:490 ../clone/virt-sysprep.pod:482 ../df/virt-df.pod:222 ../edit/virt-edit.pod:349 ../fish/guestfish.pod:1114 ../fuse/guestmount.pod:312 ../inspector/virt-inspector.pod:375 ../resize/virt-resize.pod:683 ../sparsify/virt-sparsify.pod:227 ../test-tool/libguestfs-test-tool.pod:90 msgid "EXIT STATUS" msgstr "" @@ -673,7 +673,7 @@ msgid "This program returns:" msgstr "" #. type: =item -#: ../align/virt-alignment-scan.pod:309 ../align/virt-alignment-scan.pod:315 ../align/virt-alignment-scan.pod:321 ../align/virt-alignment-scan.pod:328 ../clone/virt-sysprep.pod:283 ../clone/virt-sysprep.pod:287 ../clone/virt-sysprep.pod:291 ../clone/virt-sysprep.pod:295 ../clone/virt-sysprep.pod:310 ../clone/virt-sysprep.pod:314 ../clone/virt-sysprep.pod:318 ../clone/virt-sysprep.pod:322 ../clone/virt-sysprep.pod:326 ../clone/virt-sysprep.pod:362 ../clone/virt-sysprep.pod:384 ../clone/virt-sysprep.pod:388 ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266 ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276 ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291 ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102 ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132 ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227 ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235 ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:395 ../fish/guestfish-actions.pod:403 ../fish/guestfish-actions.pod:410 ../fish/guestfish-actions.pod:417 ../fish/guestfish-actions.pod:1144 ../fish/guestfish-actions.pod:1148 ../fish/guestfish-actions.pod:1152 ../fish/guestfish-actions.pod:1156 ../fish/guestfish-actions.pod:1164 ../fish/guestfish-actions.pod:1168 ../fish/guestfish-actions.pod:1172 ../fish/guestfish-actions.pod:1182 ../fish/guestfish-actions.pod:1186 ../fish/guestfish-actions.pod:1190 ../fish/guestfish-actions.pod:1280 ../fish/guestfish-actions.pod:1284 ../fish/guestfish-actions.pod:1289 ../fish/guestfish-actions.pod:1294 ../fish/guestfish-actions.pod:1336 ../fish/guestfish-actions.pod:1340 ../fish/guestfish-actions.pod:1345 ../fish/guestfish-actions.pod:1601 ../fish/guestfish-actions.pod:1608 ../fish/guestfish-actions.pod:1615 ../fish/guestfish-actions.pod:2018 ../fish/guestfish-actions.pod:2024 ../fish/guestfish-actions.pod:2032 ../fish/guestfish-actions.pod:2039 ../fish/guestfish-actions.pod:2046 ../fish/guestfish.pod:445 ../fish/guestfish.pod:449 ../fish/guestfish.pod:453 ../fish/guestfish.pod:457 ../inspector/virt-inspector.pod:393 ../inspector/virt-inspector.pod:397 ../resize/virt-resize.pod:338 ../resize/virt-resize.pod:342 ../resize/virt-resize.pod:351 ../resize/virt-resize.pod:357 ../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:58 ../sparsify/virt-sparsify.pod:64 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:29 ../src/guestfs-actions.pod:594 ../src/guestfs-actions.pod:602 ../src/guestfs-actions.pod:609 ../src/guestfs-actions.pod:616 ../src/guestfs-actions.pod:1784 ../src/guestfs-actions.pod:1788 ../src/guestfs-actions.pod:1792 ../src/guestfs-actions.pod:1796 ../src/guestfs-actions.pod:1804 ../src/guestfs-actions.pod:1808 ../src/guestfs-actions.pod:1812 ../src/guestfs-actions.pod:1822 ../src/guestfs-actions.pod:1826 ../src/guestfs-actions.pod:1830 ../src/guestfs-actions.pod:1968 ../src/guestfs-actions.pod:1972 ../src/guestfs-actions.pod:1977 ../src/guestfs-actions.pod:1982 ../src/guestfs-actions.pod:2043 ../src/guestfs-actions.pod:2047 ../src/guestfs-actions.pod:2052 ../src/guestfs-actions.pod:2467 ../src/guestfs-actions.pod:2474 ../src/guestfs-actions.pod:2481 ../src/guestfs-actions.pod:3026 ../src/guestfs-actions.pod:3032 ../src/guestfs-actions.pod:3040 ../src/guestfs-actions.pod:3047 ../src/guestfs-actions.pod:3054 ../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:1094 ../src/guestfs.pod:1098 ../src/guestfs.pod:1102 ../src/guestfs.pod:1107 ../src/guestfs.pod:1115 ../src/guestfs.pod:1134 ../src/guestfs.pod:1142 ../src/guestfs.pod:1164 ../src/guestfs.pod:1168 ../src/guestfs.pod:1172 ../src/guestfs.pod:1176 ../src/guestfs.pod:1180 ../src/guestfs.pod:1184 ../src/guestfs.pod:1674 ../src/guestfs.pod:1679 ../src/guestfs.pod:1683 ../src/guestfs.pod:1785 ../src/guestfs.pod:1790 ../src/guestfs.pod:1794 ../src/guestfs.pod:1804 ../src/guestfs.pod:2093 ../src/guestfs.pod:2098 ../src/guestfs.pod:2104 ../src/guestfs.pod:2112 ../src/guestfs.pod:2630 ../src/guestfs.pod:2636 ../src/guestfs.pod:2641 ../src/guestfs.pod:2647 ../src/guestfs.pod:3047 ../src/guestfs.pod:3052 ../src/guestfs.pod:3056 ../src/guestfs.pod:3060 ../src/guestfs.pod:3064 ../src/guestfs.pod:3078 ../src/guestfs.pod:3083 ../src/guestfs.pod:3314 ../src/guestfs.pod:3318 ../src/guestfs.pod:3322 ../src/guestfs.pod:3326 ../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:309 ../align/virt-alignment-scan.pod:315 ../align/virt-alignment-scan.pod:321 ../align/virt-alignment-scan.pod:328 ../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 ../clone/virt-sysprep.pod:283 ../clone/virt-sysprep.pod:287 ../clone/virt-sysprep.pod:291 ../clone/virt-sysprep.pod:295 ../clone/virt-sysprep.pod:310 ../clone/virt-sysprep.pod:314 ../clone/virt-sysprep.pod:318 ../clone/virt-sysprep.pod:322 ../clone/virt-sysprep.pod:326 ../clone/virt-sysprep.pod:362 ../clone/virt-sysprep.pod:384 ../clone/virt-sysprep.pod:388 ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266 ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276 ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291 ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102 ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132 ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227 ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235 ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:395 ../fish/guestfish-actions.pod:403 ../fish/guestfish-actions.pod:410 ../fish/guestfish-actions.pod:417 ../fish/guestfish-actions.pod:1216 ../fish/guestfish-actions.pod:1220 ../fish/guestfish-actions.pod:1224 ../fish/guestfish-actions.pod:1228 ../fish/guestfish-actions.pod:1236 ../fish/guestfish-actions.pod:1240 ../fish/guestfish-actions.pod:1244 ../fish/guestfish-actions.pod:1254 ../fish/guestfish-actions.pod:1258 ../fish/guestfish-actions.pod:1262 ../fish/guestfish-actions.pod:1352 ../fish/guestfish-actions.pod:1356 ../fish/guestfish-actions.pod:1361 ../fish/guestfish-actions.pod:1366 ../fish/guestfish-actions.pod:1408 ../fish/guestfish-actions.pod:1412 ../fish/guestfish-actions.pod:1417 ../fish/guestfish-actions.pod:1673 ../fish/guestfish-actions.pod:1680 ../fish/guestfish-actions.pod:1687 ../fish/guestfish-actions.pod:2090 ../fish/guestfish-actions.pod:2096 ../fish/guestfish-actions.pod:2104 ../fish/guestfish-actions.pod:2111 ../fish/guestfish-actions.pod:2118 ../fish/guestfish.pod:445 ../fish/guestfish.pod:449 ../fish/guestfish.pod:453 ../fish/guestfish.pod:457 ../inspector/virt-inspector.pod:393 ../inspector/virt-inspector.pod:397 ../resize/virt-resize.pod:359 ../resize/virt-resize.pod:363 ../resize/virt-resize.pod:372 ../resize/virt-resize.pod:378 ../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:58 ../sparsify/virt-sparsify.pod:64 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:29 ../src/guestfs-actions.pod:594 ../src/guestfs-actions.pod:602 ../src/guestfs-actions.pod:609 ../src/guestfs-actions.pod:616 ../src/guestfs-actions.pod:2024 ../src/guestfs-actions.pod:2028 ../src/guestfs-actions.pod:2032 ../src/guestfs-actions.pod:2036 ../src/guestfs-actions.pod:2044 ../src/guestfs-actions.pod:2048 ../src/guestfs-actions.pod:2052 ../src/guestfs-actions.pod:2062 ../src/guestfs-actions.pod:2066 ../src/guestfs-actions.pod:2070 ../src/guestfs-actions.pod:2208 ../src/guestfs-actions.pod:2212 ../src/guestfs-actions.pod:2217 ../src/guestfs-actions.pod:2222 ../src/guestfs-actions.pod:2283 ../src/guestfs-actions.pod:2287 ../src/guestfs-actions.pod:2292 ../src/guestfs-actions.pod:2707 ../src/guestfs-actions.pod:2714 ../src/guestfs-actions.pod:2721 ../src/guestfs-actions.pod:3266 ../src/guestfs-actions.pod:3272 ../src/guestfs-actions.pod:3280 ../src/guestfs-actions.pod:3287 ../src/guestfs-actions.pod:3294 ../src/guestfs.pod:403 ../src/guestfs.pod:408 ../src/guestfs.pod:413 ../src/guestfs.pod:417 ../src/guestfs.pod:422 ../src/guestfs.pod:426 ../src/guestfs.pod:431 ../src/guestfs.pod:436 ../src/guestfs.pod:1109 ../src/guestfs.pod:1113 ../src/guestfs.pod:1117 ../src/guestfs.pod:1122 ../src/guestfs.pod:1130 ../src/guestfs.pod:1149 ../src/guestfs.pod:1157 ../src/guestfs.pod:1179 ../src/guestfs.pod:1183 ../src/guestfs.pod:1187 ../src/guestfs.pod:1191 ../src/guestfs.pod:1195 ../src/guestfs.pod:1199 ../src/guestfs.pod:1689 ../src/guestfs.pod:1694 ../src/guestfs.pod:1698 ../src/guestfs.pod:1800 ../src/guestfs.pod:1805 ../src/guestfs.pod:1809 ../src/guestfs.pod:1819 ../src/guestfs.pod:2108 ../src/guestfs.pod:2113 ../src/guestfs.pod:2119 ../src/guestfs.pod:2127 ../src/guestfs.pod:2645 ../src/guestfs.pod:2651 ../src/guestfs.pod:2656 ../src/guestfs.pod:2662 ../src/guestfs.pod:3062 ../src/guestfs.pod:3067 ../src/guestfs.pod:3071 ../src/guestfs.pod:3075 ../src/guestfs.pod:3079 ../src/guestfs.pod:3093 ../src/guestfs.pod:3098 ../src/guestfs.pod:3329 ../src/guestfs.pod:3333 ../src/guestfs.pod:3337 ../src/guestfs.pod:3341 ../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 "" @@ -722,7 +722,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:337 ../cat/virt-cat.pod:203 ../cat/virt-filesystems.pod:377 ../cat/virt-ls.pod:495 ../clone/virt-sysprep.pod:486 ../df/virt-df.pod:227 ../edit/virt-edit.pod:354 ../erlang/examples/guestfs-erlang.pod:97 ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384 ../fish/guestfish.pod:1268 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:317 ../inspector/virt-inspector.pod:380 ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39 ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:288 ../resize/virt-resize.pod:667 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:251 ../src/guestfs.pod:3255 ../test-tool/libguestfs-test-tool.pod:100 ../tools/virt-list-filesystems.pl:195 ../tools/virt-list-partitions.pl:265 ../tools/virt-make-fs.pl:557 ../tools/virt-tar.pl:296 ../tools/virt-win-reg.pl:757 +#: ../align/virt-alignment-scan.pod:337 ../cat/virt-cat.pod:243 ../cat/virt-filesystems.pod:385 ../cat/virt-ls.pod:495 ../clone/virt-sysprep.pod:486 ../df/virt-df.pod:227 ../edit/virt-edit.pod:354 ../erlang/examples/guestfs-erlang.pod:97 ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384 ../fish/guestfish.pod:1268 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:317 ../inspector/virt-inspector.pod:380 ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39 ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:288 ../resize/virt-resize.pod:688 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:251 ../src/guestfs.pod:3270 ../test-tool/libguestfs-test-tool.pod:100 ../tools/virt-list-filesystems.pl:195 ../tools/virt-list-partitions.pl:265 ../tools/virt-make-fs.pl:557 ../tools/virt-tar.pl:296 ../tools/virt-win-reg.pl:757 msgid "SEE ALSO" msgstr "" @@ -734,17 +734,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:346 ../cat/virt-cat.pod:212 ../cat/virt-filesystems.pod:388 ../cat/virt-ls.pod:507 ../clone/virt-sysprep.pod:501 ../df/virt-df.pod:235 ../edit/virt-edit.pod:368 ../rescue/virt-rescue.pod:296 ../resize/virt-resize.pod:690 ../sparsify/virt-sparsify.pod:264 ../tools/virt-list-filesystems.pl:208 ../tools/virt-list-partitions.pl:277 ../tools/virt-make-fs.pl:582 ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:783 +#: ../align/virt-alignment-scan.pod:346 ../cat/virt-cat.pod:252 ../cat/virt-filesystems.pod:396 ../cat/virt-ls.pod:507 ../clone/virt-sysprep.pod:501 ../df/virt-df.pod:235 ../edit/virt-edit.pod:368 ../rescue/virt-rescue.pod:296 ../resize/virt-resize.pod:711 ../sparsify/virt-sparsify.pod:264 ../tools/virt-list-filesystems.pl:208 ../tools/virt-list-partitions.pl:277 ../tools/virt-make-fs.pl:582 ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:783 msgid "AUTHOR" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:348 ../cat/virt-cat.pod:214 ../cat/virt-filesystems.pod:390 ../cat/virt-ls.pod:509 ../clone/virt-sysprep.pod:503 ../df/virt-df.pod:237 ../edit/virt-edit.pod:370 ../inspector/virt-inspector.pod:395 ../rescue/virt-rescue.pod:298 ../resize/virt-resize.pod:692 ../sparsify/virt-sparsify.pod:266 ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:584 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:785 +#: ../align/virt-alignment-scan.pod:348 ../cat/virt-cat.pod:254 ../cat/virt-filesystems.pod:398 ../cat/virt-ls.pod:509 ../clone/virt-sysprep.pod:503 ../df/virt-df.pod:237 ../edit/virt-edit.pod:370 ../inspector/virt-inspector.pod:395 ../rescue/virt-rescue.pod:298 ../resize/virt-resize.pod:713 ../sparsify/virt-sparsify.pod:266 ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:584 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:785 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:350 ../cat/virt-cat.pod:216 ../cat/virt-filesystems.pod:392 ../cat/virt-ls.pod:511 ../clone/virt-sysprep.pod:505 ../df/virt-df.pod:239 ../edit/virt-edit.pod:372 ../erlang/examples/guestfs-erlang.pod:114 ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401 ../fish/guestfish.pod:1300 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:332 ../inspector/virt-inspector.pod:403 ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56 ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:300 ../resize/virt-resize.pod:694 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:268 ../src/guestfs.pod:3337 ../test-tool/libguestfs-test-tool.pod:110 ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281 ../tools/virt-make-fs.pl:586 ../tools/virt-tar.pl:315 ../tools/virt-win-reg.pl:787 +#: ../align/virt-alignment-scan.pod:350 ../cat/virt-cat.pod:256 ../cat/virt-filesystems.pod:400 ../cat/virt-ls.pod:511 ../clone/virt-sysprep.pod:505 ../df/virt-df.pod:239 ../edit/virt-edit.pod:372 ../erlang/examples/guestfs-erlang.pod:114 ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401 ../fish/guestfish.pod:1300 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:332 ../inspector/virt-inspector.pod:403 ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56 ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:300 ../resize/virt-resize.pod:715 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:268 ../src/guestfs.pod:3352 ../test-tool/libguestfs-test-tool.pod:110 ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281 ../tools/virt-make-fs.pl:586 ../tools/virt-tar.pl:315 ../tools/virt-win-reg.pl:787 msgid "COPYRIGHT" msgstr "" @@ -754,7 +754,7 @@ msgid "Copyright (C) 2011 Red Hat Inc." msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:354 ../cat/virt-cat.pod:220 ../cat/virt-filesystems.pod:396 ../cat/virt-ls.pod:515 ../clone/virt-sysprep.pod:509 ../df/virt-df.pod:243 ../edit/virt-edit.pod:376 ../fish/guestfish.pod:1305 ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60 ../fuse/guestmount.pod:337 ../inspector/virt-inspector.pod:407 ../rescue/virt-rescue.pod:304 ../resize/virt-resize.pod:698 ../sparsify/virt-sparsify.pod:272 ../test-tool/libguestfs-test-tool.pod:115 ../tools/virt-list-filesystems.pl:216 ../tools/virt-list-partitions.pl:285 ../tools/virt-make-fs.pl:590 ../tools/virt-tar.pl:319 ../tools/virt-win-reg.pl:791 +#: ../align/virt-alignment-scan.pod:354 ../cat/virt-cat.pod:260 ../cat/virt-filesystems.pod:404 ../cat/virt-ls.pod:515 ../clone/virt-sysprep.pod:509 ../df/virt-df.pod:243 ../edit/virt-edit.pod:376 ../fish/guestfish.pod:1305 ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60 ../fuse/guestmount.pod:337 ../inspector/virt-inspector.pod:407 ../rescue/virt-rescue.pod:304 ../resize/virt-resize.pod:719 ../sparsify/virt-sparsify.pod:272 ../test-tool/libguestfs-test-tool.pod:115 ../tools/virt-list-filesystems.pl:216 ../tools/virt-list-partitions.pl:285 ../tools/virt-make-fs.pl:590 ../tools/virt-tar.pl:319 ../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 " @@ -763,7 +763,7 @@ msgid "" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:359 ../cat/virt-cat.pod:225 ../cat/virt-filesystems.pod:401 ../cat/virt-ls.pod:520 ../clone/virt-sysprep.pod:514 ../df/virt-df.pod:248 ../edit/virt-edit.pod:381 ../fish/guestfish.pod:1310 ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65 ../fuse/guestmount.pod:342 ../inspector/virt-inspector.pod:412 ../rescue/virt-rescue.pod:309 ../resize/virt-resize.pod:703 ../sparsify/virt-sparsify.pod:277 ../test-tool/libguestfs-test-tool.pod:120 ../tools/virt-list-filesystems.pl:221 ../tools/virt-list-partitions.pl:290 ../tools/virt-make-fs.pl:595 ../tools/virt-tar.pl:324 ../tools/virt-win-reg.pl:796 +#: ../align/virt-alignment-scan.pod:359 ../cat/virt-cat.pod:265 ../cat/virt-filesystems.pod:409 ../cat/virt-ls.pod:520 ../clone/virt-sysprep.pod:514 ../df/virt-df.pod:248 ../edit/virt-edit.pod:381 ../fish/guestfish.pod:1310 ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65 ../fuse/guestmount.pod:342 ../inspector/virt-inspector.pod:412 ../rescue/virt-rescue.pod:309 ../resize/virt-resize.pod:724 ../sparsify/virt-sparsify.pod:277 ../test-tool/libguestfs-test-tool.pod:120 ../tools/virt-list-filesystems.pl:221 ../tools/virt-list-partitions.pl:290 ../tools/virt-make-fs.pl:595 ../tools/virt-tar.pl:324 ../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 " @@ -772,7 +772,7 @@ msgid "" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:364 ../cat/virt-cat.pod:230 ../cat/virt-filesystems.pod:406 ../cat/virt-ls.pod:525 ../clone/virt-sysprep.pod:519 ../df/virt-df.pod:253 ../edit/virt-edit.pod:386 ../fish/guestfish.pod:1315 ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70 ../fuse/guestmount.pod:347 ../inspector/virt-inspector.pod:417 ../rescue/virt-rescue.pod:314 ../resize/virt-resize.pod:708 ../sparsify/virt-sparsify.pod:282 ../test-tool/libguestfs-test-tool.pod:125 ../tools/virt-list-filesystems.pl:226 ../tools/virt-list-partitions.pl:295 ../tools/virt-make-fs.pl:600 ../tools/virt-tar.pl:329 ../tools/virt-win-reg.pl:801 +#: ../align/virt-alignment-scan.pod:364 ../cat/virt-cat.pod:270 ../cat/virt-filesystems.pod:414 ../cat/virt-ls.pod:525 ../clone/virt-sysprep.pod:519 ../df/virt-df.pod:253 ../edit/virt-edit.pod:386 ../fish/guestfish.pod:1315 ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70 ../fuse/guestmount.pod:347 ../inspector/virt-inspector.pod:417 ../rescue/virt-rescue.pod:314 ../resize/virt-resize.pod:729 ../sparsify/virt-sparsify.pod:282 ../test-tool/libguestfs-test-tool.pod:125 ../tools/virt-list-filesystems.pl:226 ../tools/virt-list-partitions.pl:295 ../tools/virt-make-fs.pl:600 ../tools/virt-tar.pl:329 ../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., 675 Mass " @@ -1024,24 +1024,77 @@ msgid "For compatibility the old style is still supported." msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:297 -msgid "USING GUESTFISH" +#: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:257 ../fish/guestfish.pod:858 +msgid "WINDOWS PATHS" msgstr "" #. type: textblock #: ../cat/virt-cat.pod:170 msgid "" +"C<virt-cat> has a limited ability to understand Windows drive letters and " +"paths (eg. C<E:\\foo\\bar.txt>)." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:173 ../edit/virt-edit.pod:262 +msgid "If and only if the guest is running Windows then:" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:179 ../edit/virt-edit.pod:268 +msgid "" +"Drive letter prefixes like C<C:> are resolved against the Windows Registry " +"to the correct filesystem." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:184 ../edit/virt-edit.pod:273 +msgid "" +"Any backslash (C<\\>) characters in the path are replaced with forward " +"slashes so that libguestfs can process it." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:189 +msgid "" +"The path is resolved case insensitively to locate the file that should be " +"displayed." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:194 ../edit/virt-edit.pod:283 +msgid "There are some known shortcomings:" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:200 ../edit/virt-edit.pod:289 +msgid "Some NTFS symbolic links may not be followed correctly." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:204 ../edit/virt-edit.pod:293 +msgid "NTFS junction points that cross filesystems are not followed." +msgstr "" + +#. type: =head1 +#: ../cat/virt-cat.pod:208 ../edit/virt-edit.pod:297 +msgid "USING GUESTFISH" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:210 +msgid "" "L<guestfish(1)> is a more powerful, lower level tool which you can use when " "C<virt-cat> doesn't work." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:173 +#: ../cat/virt-cat.pod:213 msgid "Using C<virt-cat> is approximately equivalent to doing:" msgstr "" #. type: verbatim -#: ../cat/virt-cat.pod:175 +#: ../cat/virt-cat.pod:215 #, no-wrap msgid "" " guestfish --ro -i -d domname download file -\n" @@ -1049,14 +1102,14 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:177 +#: ../cat/virt-cat.pod:217 msgid "" "where C<domname> is the name of the libvirt guest, and C<file> is the full " "path to the file. Note the final C<-> (meaning \"output to stdout\")." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:181 +#: ../cat/virt-cat.pod:221 msgid "" "The command above uses libguestfs's guest inspection feature and so does not " "work on guests that libguestfs cannot inspect, or on things like arbitrary " @@ -1065,7 +1118,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../cat/virt-cat.pod:186 +#: ../cat/virt-cat.pod:226 #, no-wrap msgid "" " guestfish --ro -a disk.img -m /dev/sda1 download file -\n" @@ -1073,26 +1126,26 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:188 +#: ../cat/virt-cat.pod:228 msgid "" "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within " "the disk image, and C<file> is the full path to the file." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:200 ../cat/virt-filesystems.pod:374 ../cat/virt-ls.pod:492 ../df/virt-df.pod:224 ../edit/virt-edit.pod:351 ../fuse/guestmount.pod:314 ../inspector/virt-inspector.pod:377 ../resize/virt-resize.pod:664 ../sparsify/virt-sparsify.pod:229 +#: ../cat/virt-cat.pod:240 ../cat/virt-filesystems.pod:382 ../cat/virt-ls.pod:492 ../df/virt-df.pod:224 ../edit/virt-edit.pod:351 ../fuse/guestmount.pod:314 ../inspector/virt-inspector.pod:377 ../resize/virt-resize.pod:685 ../sparsify/virt-sparsify.pod:229 msgid "This program returns 0 if successful, or non-zero if there was an error." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:205 +#: ../cat/virt-cat.pod:245 msgid "" "L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, " "L<virt-tar-out(1)>, L<http://libguestfs.org/>." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:218 ../inspector/virt-inspector.pod:405 ../resize/virt-resize.pod:696 ../tools/virt-make-fs.pl:588 +#: ../cat/virt-cat.pod:258 ../inspector/virt-inspector.pod:405 ../resize/virt-resize.pod:717 ../tools/virt-make-fs.pl:588 msgid "Copyright (C) 2010-2011 Red Hat Inc." msgstr "" @@ -1620,23 +1673,41 @@ msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:319 -msgid "B<Size>" +msgid "B<MBR>" msgstr "" #. type: textblock #: ../cat/virt-filesystems.pod:321 msgid "" +"The partition type byte, displayed as a two digit hexadecimal number. A " +"comprehensive list of partition types can be found here: " +"L<http://www.win.tue.nl/~aeb/partitions/partition_types-1.html>" +msgstr "" + +#. type: textblock +#: ../cat/virt-filesystems.pod:325 +msgid "This is only applicable for DOS (MBR) partitions." +msgstr "" + +#. type: =item +#: ../cat/virt-filesystems.pod:327 +msgid "B<Size>" +msgstr "" + +#. type: textblock +#: ../cat/virt-filesystems.pod:329 +msgid "" "The size of the object in bytes. If the I<--human> option is used then the " "size is displayed in a human-readable form." msgstr "" #. type: =item -#: ../cat/virt-filesystems.pod:324 +#: ../cat/virt-filesystems.pod:332 msgid "B<Parent>" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:326 +#: ../cat/virt-filesystems.pod:334 msgid "" "The parent column records the parent relationship between objects. For " "example, if the object is a partition, then this column contains the name of " @@ -1645,43 +1716,43 @@ msgid "" msgstr "" #. type: =item -#: ../cat/virt-filesystems.pod:331 +#: ../cat/virt-filesystems.pod:339 msgid "B<UUID>" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:333 +#: ../cat/virt-filesystems.pod:341 msgid "" "If the object has a UUID (used for identifying and mounting filesystems and " "block devices) then this column contains the UUID as a string." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:337 +#: ../cat/virt-filesystems.pod:345 msgid "The UUID is only displayed if the I<--uuid> option is given." msgstr "" #. type: =head1 -#: ../cat/virt-filesystems.pod:341 ../cat/virt-ls.pod:459 ../df/virt-df.pod:191 +#: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:459 ../df/virt-df.pod:191 msgid "NOTE ABOUT CSV FORMAT" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:343 ../cat/virt-ls.pod:461 ../df/virt-df.pod:193 +#: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:461 ../df/virt-df.pod:193 msgid "" "Comma-separated values (CSV) is a deceptive format. It I<seems> like it " "should be easy to parse, but it is definitely not easy to parse." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:346 ../cat/virt-ls.pod:464 ../df/virt-df.pod:196 +#: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:464 ../df/virt-df.pod:196 msgid "" "Myth: Just split fields at commas. Reality: This does I<not> work " "reliably. This example has two columns:" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:467 ../df/virt-df.pod:199 +#: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:467 ../df/virt-df.pod:199 #, no-wrap msgid "" " \"foo,bar\",baz\n" @@ -1689,14 +1760,14 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:469 ../df/virt-df.pod:201 +#: ../cat/virt-filesystems.pod:359 ../cat/virt-ls.pod:469 ../df/virt-df.pod:201 msgid "" "Myth: Read the file one line at a time. Reality: This does I<not> work " "reliably. This example has one row:" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:472 ../df/virt-df.pod:204 +#: ../cat/virt-filesystems.pod:362 ../cat/virt-ls.pod:472 ../df/virt-df.pod:204 #, no-wrap msgid "" " \"foo\n" @@ -1705,26 +1776,26 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:475 ../df/virt-df.pod:207 +#: ../cat/virt-filesystems.pod:365 ../cat/virt-ls.pod:475 ../df/virt-df.pod:207 msgid "" "For shell scripts, use C<csvtool> (L<http://merjis.com/developers/csv> also " "packaged in major Linux distributions)." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:360 ../cat/virt-ls.pod:478 ../df/virt-df.pod:210 +#: ../cat/virt-filesystems.pod:368 ../cat/virt-ls.pod:478 ../df/virt-df.pod:210 msgid "" "For other languages, use a CSV processing library (eg. C<Text::CSV> for Perl " "or Python's built-in csv library)." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:363 ../cat/virt-ls.pod:481 ../df/virt-df.pod:213 +#: ../cat/virt-filesystems.pod:371 ../cat/virt-ls.pod:481 ../df/virt-df.pod:213 msgid "Most spreadsheets and databases can import CSV directly." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:379 +#: ../cat/virt-filesystems.pod:387 msgid "" "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-df(1)>, " "L<virt-list-filesystems(1)>, L<virt-list-partitions(1)>, L<csvtool(1)>, " @@ -1732,7 +1803,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:394 ../tools/virt-win-reg.pl:789 +#: ../cat/virt-filesystems.pod:402 ../tools/virt-win-reg.pl:789 msgid "Copyright (C) 2010 Red Hat Inc." msgstr "" @@ -2135,7 +2206,7 @@ msgid "" msgstr "" #. type: =head2 -#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4263 +#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4349 msgid "path" msgstr "" @@ -3178,7 +3249,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../clone/virt-sysprep.pod:429 ../src/guestfs.pod:1149 +#: ../clone/virt-sysprep.pod:429 ../src/guestfs.pod:1164 msgid "SECURITY" msgstr "" @@ -3908,11 +3979,6 @@ msgid "" "\n" msgstr "" -#. type: =head1 -#: ../edit/virt-edit.pod:257 ../fish/guestfish.pod:858 -msgid "WINDOWS PATHS" -msgstr "" - #. type: textblock #: ../edit/virt-edit.pod:259 msgid "" @@ -3921,25 +3987,6 @@ msgid "" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:262 -msgid "If and only if the guest is running Windows then:" -msgstr "" - -#. type: textblock -#: ../edit/virt-edit.pod:268 -msgid "" -"Drive letter prefixes like C<C:> are resolved against the Windows Registry " -"to the correct filesystem." -msgstr "" - -#. type: textblock -#: ../edit/virt-edit.pod:273 -msgid "" -"Any backslash (C<\\>) characters in the path are replaced with forward " -"slashes so that libguestfs can process it." -msgstr "" - -#. type: textblock #: ../edit/virt-edit.pod:278 msgid "" "The path is resolved case insensitively to locate the file that should be " @@ -3947,21 +3994,6 @@ msgid "" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:283 -msgid "There are some known shortcomings:" -msgstr "" - -#. type: textblock -#: ../edit/virt-edit.pod:289 -msgid "Some NTFS symbolic links may not be followed correctly." -msgstr "" - -#. type: textblock -#: ../edit/virt-edit.pod:293 -msgid "NTFS junction points that cross filesystems are not followed." -msgstr "" - -#. type: textblock #: ../edit/virt-edit.pod:299 msgid "" "L<guestfish(1)> is a more powerful, lower level tool which you can use when " @@ -4044,7 +4076,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../edit/virt-edit.pod:329 ../fish/guestfish.pod:1119 ../rescue/virt-rescue.pod:261 ../sparsify/virt-sparsify.pod:232 ../src/guestfs.pod:3194 ../test-tool/libguestfs-test-tool.pod:95 +#: ../edit/virt-edit.pod:329 ../fish/guestfish.pod:1119 ../rescue/virt-rescue.pod:261 ../sparsify/virt-sparsify.pod:232 ../src/guestfs.pod:3209 ../test-tool/libguestfs-test-tool.pod:95 msgid "ENVIRONMENT VARIABLES" msgstr "" @@ -4287,12 +4319,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../erlang/examples/guestfs-erlang.pod:110 ../examples/guestfs-examples.pod:45 ../examples/guestfs-recipes.pod:397 ../fish/guestfish.pod:1296 ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:389 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52 ../python/examples/guestfs-python.pod:54 ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3333 ../test-tool/libguestfs-test-tool.pod:106 +#: ../erlang/examples/guestfs-erlang.pod:110 ../examples/guestfs-examples.pod:45 ../examples/guestfs-recipes.pod:397 ../fish/guestfish.pod:1296 ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:389 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52 ../python/examples/guestfs-python.pod:54 ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3348 ../test-tool/libguestfs-test-tool.pod:106 msgid "AUTHORS" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:112 ../examples/guestfs-examples.pod:47 ../examples/guestfs-recipes.pod:399 ../fish/guestfish.pod:1298 ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:330 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:54 ../python/examples/guestfs-python.pod:56 ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3335 ../test-tool/libguestfs-test-tool.pod:108 +#: ../erlang/examples/guestfs-erlang.pod:112 ../examples/guestfs-examples.pod:47 ../examples/guestfs-recipes.pod:399 ../fish/guestfish.pod:1298 ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:330 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:54 ../python/examples/guestfs-python.pod:56 ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3350 ../test-tool/libguestfs-test-tool.pod:108 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)" msgstr "" @@ -4309,7 +4341,7 @@ msgid "" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:121 ../examples/guestfs-examples.pod:56 ../examples/guestfs-recipes.pod:408 ../java/examples/guestfs-java.pod:69 ../ocaml/examples/guestfs-ocaml.pod:102 ../perl/examples/guestfs-perl.pod:63 ../python/examples/guestfs-python.pod:65 ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3342 +#: ../erlang/examples/guestfs-erlang.pod:121 ../examples/guestfs-examples.pod:56 ../examples/guestfs-recipes.pod:408 ../java/examples/guestfs-java.pod:69 ../ocaml/examples/guestfs-ocaml.pod:102 ../perl/examples/guestfs-perl.pod:63 ../python/examples/guestfs-python.pod:65 ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3357 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 " @@ -4318,7 +4350,7 @@ msgid "" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:126 ../examples/guestfs-examples.pod:61 ../examples/guestfs-recipes.pod:413 ../java/examples/guestfs-java.pod:74 ../ocaml/examples/guestfs-ocaml.pod:107 ../perl/examples/guestfs-perl.pod:68 ../python/examples/guestfs-python.pod:70 ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3347 +#: ../erlang/examples/guestfs-erlang.pod:126 ../examples/guestfs-examples.pod:61 ../examples/guestfs-recipes.pod:413 ../java/examples/guestfs-java.pod:74 ../ocaml/examples/guestfs-ocaml.pod:107 ../perl/examples/guestfs-perl.pod:68 ../python/examples/guestfs-python.pod:70 ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3362 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 " @@ -4327,7 +4359,7 @@ msgid "" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:131 ../examples/guestfs-examples.pod:66 ../examples/guestfs-recipes.pod:418 ../java/examples/guestfs-java.pod:79 ../ocaml/examples/guestfs-ocaml.pod:112 ../perl/examples/guestfs-perl.pod:73 ../python/examples/guestfs-python.pod:75 ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3352 +#: ../erlang/examples/guestfs-erlang.pod:131 ../examples/guestfs-examples.pod:66 ../examples/guestfs-recipes.pod:418 ../java/examples/guestfs-java.pod:79 ../ocaml/examples/guestfs-ocaml.pod:112 ../perl/examples/guestfs-perl.pod:73 ../python/examples/guestfs-python.pod:75 ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3367 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, " @@ -4662,7 +4694,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1332 ../fish/guestfish-actions.pod:1597 ../fish/guestfish-actions.pod:2014 ../src/guestfs-actions.pod:18 ../src/guestfs-actions.pod:2039 ../src/guestfs-actions.pod:2463 ../src/guestfs-actions.pod:3022 ../src/guestfs.pod:1670 ../tools/virt-win-reg.pl:717 +#: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1404 ../fish/guestfish-actions.pod:1669 ../fish/guestfish-actions.pod:2086 ../src/guestfs-actions.pod:18 ../src/guestfs-actions.pod:2279 ../src/guestfs-actions.pod:2703 ../src/guestfs-actions.pod:3262 ../src/guestfs.pod:1685 ../tools/virt-win-reg.pl:717 msgid "Notes:" msgstr "" @@ -5248,7 +5280,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:171 ../fish/guestfish-actions.pod:185 ../fish/guestfish-actions.pod:1031 ../fish/guestfish-actions.pod:1391 ../fish/guestfish-actions.pod:1405 ../fish/guestfish-actions.pod:3175 ../fish/guestfish-actions.pod:3486 ../fish/guestfish-actions.pod:3534 ../fish/guestfish-actions.pod:4447 ../fish/guestfish-actions.pod:4470 ../fish/guestfish-actions.pod:4492 ../fish/guestfish-actions.pod:4530 ../fish/guestfish-actions.pod:5179 ../fish/guestfish-actions.pod:5285 ../src/guestfs-actions.pod:10 ../src/guestfs-actions.pod:258 ../src/guestfs-actions.pod:279 ../src/guestfs-actions.pod:1625 ../src/guestfs-actions.pod:2124 ../src/guestfs-actions.pod:2145 ../src/guestfs-actions.pod:4790 ../src/guestfs-actions.pod:5312 ../src/guestfs-actions.pod:5412 ../src/guestfs-actions.pod:6694 ../src/guestfs-actions.pod:6738 ../src/guestfs-actions.pod:6772 ../src/guestfs-actions.pod:6835 ../src/guestfs-actions.pod:7767 ../src/guestfs-actions.pod:7876 ../src/guestfs-actions.pod:8059 +#: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:171 ../fish/guestfish-actions.pod:185 ../fish/guestfish-actions.pod:895 ../fish/guestfish-actions.pod:930 ../fish/guestfish-actions.pod:1103 ../fish/guestfish-actions.pod:1463 ../fish/guestfish-actions.pod:1477 ../fish/guestfish-actions.pod:3247 ../fish/guestfish-actions.pod:3558 ../fish/guestfish-actions.pod:3606 ../fish/guestfish-actions.pod:4533 ../fish/guestfish-actions.pod:4556 ../fish/guestfish-actions.pod:4578 ../fish/guestfish-actions.pod:4616 ../fish/guestfish-actions.pod:5265 ../fish/guestfish-actions.pod:5371 ../src/guestfs-actions.pod:10 ../src/guestfs-actions.pod:258 ../src/guestfs-actions.pod:279 ../src/guestfs-actions.pod:1525 ../src/guestfs-actions.pod:1582 ../src/guestfs-actions.pod:1865 ../src/guestfs-actions.pod:2364 ../src/guestfs-actions.pod:2385 ../src/guestfs-actions.pod:5030 ../src/guestfs-actions.pod:5552 ../src/guestfs-actions.pod:5652 ../src/guestfs-actions.pod:6952 ../src/guestfs-actions.pod:6996 ../src/guestfs-actions.pod:7030 ../src/guestfs-actions.pod:7093 ../src/guestfs-actions.pod:8025 ../src/guestfs-actions.pod:8134 ../src/guestfs-actions.pod:8317 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 " @@ -5341,7 +5373,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:79 ../fish/guestfish-actions.pod:148 ../fish/guestfish-actions.pod:578 ../fish/guestfish-actions.pod:789 ../fish/guestfish-actions.pod:810 ../fish/guestfish-actions.pod:2053 ../fish/guestfish-actions.pod:3224 ../fish/guestfish-actions.pod:3387 ../fish/guestfish-actions.pod:3522 +#: ../fish/guestfish-actions.pod:79 ../fish/guestfish-actions.pod:148 ../fish/guestfish-actions.pod:578 ../fish/guestfish-actions.pod:789 ../fish/guestfish-actions.pod:810 ../fish/guestfish-actions.pod:848 ../fish/guestfish-actions.pod:857 ../fish/guestfish-actions.pod:866 ../fish/guestfish-actions.pod:880 ../fish/guestfish-actions.pod:2125 ../fish/guestfish-actions.pod:3296 ../fish/guestfish-actions.pod:3459 ../fish/guestfish-actions.pod:3594 msgid "" "This command has one or more optional arguments. See L</OPTIONAL " "ARGUMENTS>." @@ -5419,7 +5451,7 @@ msgid "This call checks that C<filename> exists." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:115 ../fish/guestfish-actions.pod:3186 ../src/guestfs-actions.pod:174 ../src/guestfs-actions.pod:4827 +#: ../fish/guestfish-actions.pod:115 ../fish/guestfish-actions.pod:3258 ../src/guestfs-actions.pod:174 ../src/guestfs-actions.pod:5067 msgid "The optional arguments are:" msgstr "" @@ -6114,7 +6146,7 @@ msgid "This command uploads base64-encoded data from C<base64file> to C<filename msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:445 ../fish/guestfish-actions.pod:454 ../fish/guestfish-actions.pod:703 ../fish/guestfish-actions.pod:787 ../fish/guestfish-actions.pod:808 ../fish/guestfish-actions.pod:907 ../fish/guestfish-actions.pod:926 ../fish/guestfish-actions.pod:1300 ../fish/guestfish-actions.pod:4750 ../fish/guestfish-actions.pod:4762 ../fish/guestfish-actions.pod:4773 ../fish/guestfish-actions.pod:4784 ../fish/guestfish-actions.pod:4836 ../fish/guestfish-actions.pod:4845 ../fish/guestfish-actions.pod:4899 ../fish/guestfish-actions.pod:4922 +#: ../fish/guestfish-actions.pod:445 ../fish/guestfish-actions.pod:454 ../fish/guestfish-actions.pod:703 ../fish/guestfish-actions.pod:787 ../fish/guestfish-actions.pod:808 ../fish/guestfish-actions.pod:979 ../fish/guestfish-actions.pod:998 ../fish/guestfish-actions.pod:1372 ../fish/guestfish-actions.pod:4836 ../fish/guestfish-actions.pod:4848 ../fish/guestfish-actions.pod:4859 ../fish/guestfish-actions.pod:4870 ../fish/guestfish-actions.pod:4922 ../fish/guestfish-actions.pod:4931 ../fish/guestfish-actions.pod:4985 ../fish/guestfish-actions.pod:5008 msgid "Use C<-> instead of a filename to read/write from stdin/stdout." msgstr "" @@ -6380,12 +6412,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:565 ../fish/guestfish-actions.pod:3497 ../src/guestfs-actions.pod:856 ../src/guestfs-actions.pod:5351 +#: ../fish/guestfish-actions.pod:565 ../fish/guestfish-actions.pod:3569 ../src/guestfs-actions.pod:856 ../src/guestfs-actions.pod:5591 msgid "The optional parameters are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:569 ../fish/guestfish-actions.pod:3501 ../src/guestfs-actions.pod:860 ../src/guestfs-actions.pod:5355 +#: ../fish/guestfish-actions.pod:569 ../fish/guestfish-actions.pod:3573 ../src/guestfs-actions.pod:860 ../src/guestfs-actions.pod:5595 msgid "C<size>" msgstr "" @@ -6486,7 +6518,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:620 ../fish/guestfish-actions.pod:3917 ../src/guestfs-actions.pod:944 ../src/guestfs-actions.pod:5994 +#: ../fish/guestfish-actions.pod:620 ../fish/guestfish-actions.pod:4003 ../src/guestfs-actions.pod:944 ../src/guestfs-actions.pod:6252 msgid "Return the contents of the file named C<path>." msgstr "" @@ -6500,7 +6532,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:627 ../fish/guestfish-actions.pod:762 ../fish/guestfish-actions.pod:774 ../fish/guestfish-actions.pod:985 ../fish/guestfish-actions.pod:995 ../fish/guestfish-actions.pod:1062 ../fish/guestfish-actions.pod:1072 ../fish/guestfish-actions.pod:1264 ../fish/guestfish-actions.pod:1577 ../fish/guestfish-actions.pod:1587 ../fish/guestfish-actions.pod:1637 ../fish/guestfish-actions.pod:1652 ../fish/guestfish-actions.pod:1662 ../fish/guestfish-actions.pod:1681 ../fish/guestfish-actions.pod:3787 ../fish/guestfish-actions.pod:3802 ../fish/guestfish-actions.pod:3878 ../fish/guestfish-actions.pod:3895 ../fish/guestfish-actions.pod:3910 ../fish/guestfish-actions.pod:4591 ../fish/guestfish-actions.pod:4637 ../fish/guestfish-actions.pod:4722 ../fish/guestfish-actions.pod:4737 ../fish/guestfish-actions.pod:5143 ../fish/guestfish-actions.pod:5155 ../fish/guestfish-actions.pod:5173 ../fish/guestfish-actions.pod:5190 ../fish/guestfish-actions.pod:5200 ../fish/guestfish-actions.pod:5257 ../fish/guestfish-actions.pod:5267 ../fish/guestfish-actions.pod:5296 ../fish/guestfish-actions.pod:5306 ../src/guestfs-actions.pod:954 ../src/guestfs-actions.pod:1133 ../src/guestfs-actions.pod:1153 ../src/guestfs-actions.pod:1560 ../src/guestfs-actions.pod:1579 ../src/guestfs-actions.pod:1682 ../src/guestfs-actions.pod:1701 ../src/guestfs-actions.pod:1947 ../src/guestfs-actions.pod:2429 ../src/guestfs-actions.pod:2448 ../src/guestfs-actions.pod:2513 ../src/guestfs-actions.pod:2537 ../src/guestfs-actions.pod:2554 ../src/guestfs-actions.pod:2583 ../src/guestfs-actions.pod:5776 ../src/guestfs-actions.pod:5802 ../src/guestfs-actions.pod:5933 ../src/guestfs-actions.pod:5959 ../src/guestfs-actions.pod:5983 ../src/guestfs-actions.pod:6950 ../src/guestfs-actions.pod:7005 ../src/guestfs-actions.pod:7151 ../src/guestfs-actions.pod:7175 ../src/guestfs-actions.pod:7840 ../src/guestfs-actions.pod:7860 ../src/guestfs-actions.pod:7893 ../src/guestfs-actions.pod:7912 ../src/guestfs-actions.pod:7931 ../src/guestfs-actions.pod:8025 ../src/guestfs-actions.pod:8044 ../src/guestfs-actions.pod:8090 ../src/guestfs-actions.pod:8109 +#: ../fish/guestfish-actions.pod:627 ../fish/guestfish-actions.pod:762 ../fish/guestfish-actions.pod:774 ../fish/guestfish-actions.pod:1057 ../fish/guestfish-actions.pod:1067 ../fish/guestfish-actions.pod:1134 ../fish/guestfish-actions.pod:1144 ../fish/guestfish-actions.pod:1336 ../fish/guestfish-actions.pod:1649 ../fish/guestfish-actions.pod:1659 ../fish/guestfish-actions.pod:1709 ../fish/guestfish-actions.pod:1724 ../fish/guestfish-actions.pod:1734 ../fish/guestfish-actions.pod:1753 ../fish/guestfish-actions.pod:3873 ../fish/guestfish-actions.pod:3888 ../fish/guestfish-actions.pod:3964 ../fish/guestfish-actions.pod:3981 ../fish/guestfish-actions.pod:3996 ../fish/guestfish-actions.pod:4677 ../fish/guestfish-actions.pod:4723 ../fish/guestfish-actions.pod:4808 ../fish/guestfish-actions.pod:4823 ../fish/guestfish-actions.pod:5229 ../fish/guestfish-actions.pod:5241 ../fish/guestfish-actions.pod:5259 ../fish/guestfish-actions.pod:5276 ../fish/guestfish-actions.pod:5286 ../fish/guestfish-actions.pod:5343 ../fish/guestfish-actions.pod:5353 ../fish/guestfish-actions.pod:5382 ../fish/guestfish-actions.pod:5392 ../src/guestfs-actions.pod:954 ../src/guestfs-actions.pod:1133 ../src/guestfs-actions.pod:1153 ../src/guestfs-actions.pod:1800 ../src/guestfs-actions.pod:1819 ../src/guestfs-actions.pod:1922 ../src/guestfs-actions.pod:1941 ../src/guestfs-actions.pod:2187 ../src/guestfs-actions.pod:2669 ../src/guestfs-actions.pod:2688 ../src/guestfs-actions.pod:2753 ../src/guestfs-actions.pod:2777 ../src/guestfs-actions.pod:2794 ../src/guestfs-actions.pod:2823 ../src/guestfs-actions.pod:6034 ../src/guestfs-actions.pod:6060 ../src/guestfs-actions.pod:6191 ../src/guestfs-actions.pod:6217 ../src/guestfs-actions.pod:6241 ../src/guestfs-actions.pod:7208 ../src/guestfs-actions.pod:7263 ../src/guestfs-actions.pod:7409 ../src/guestfs-actions.pod:7433 ../src/guestfs-actions.pod:8098 ../src/guestfs-actions.pod:8118 ../src/guestfs-actions.pod:8151 ../src/guestfs-actions.pod:8170 ../src/guestfs-actions.pod:8189 ../src/guestfs-actions.pod:8283 ../src/guestfs-actions.pod:8302 ../src/guestfs-actions.pod:8348 ../src/guestfs-actions.pod:8367 msgid "" "Because of the message protocol, there is a transfer limit of somewhere " "between 2MB and 4MB. See L<guestfs(3)/PROTOCOL LIMITS>." @@ -6698,7 +6730,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:716 ../fish/guestfish-actions.pod:3150 ../fish/guestfish-actions.pod:3289 ../fish/guestfish-actions.pod:3299 ../fish/guestfish-actions.pod:3309 ../src/guestfs-actions.pod:1070 ../src/guestfs-actions.pod:4758 ../src/guestfs-actions.pod:4967 ../src/guestfs-actions.pod:4986 ../src/guestfs-actions.pod:5005 +#: ../fish/guestfish-actions.pod:716 ../fish/guestfish-actions.pod:3222 ../fish/guestfish-actions.pod:3361 ../fish/guestfish-actions.pod:3371 ../fish/guestfish-actions.pod:3381 ../src/guestfs-actions.pod:1070 ../src/guestfs-actions.pod:4998 ../src/guestfs-actions.pod:5207 ../src/guestfs-actions.pod:5226 ../src/guestfs-actions.pod:5245 msgid "The mode actually set is affected by the umask." msgstr "" @@ -6721,7 +6753,7 @@ msgid "Change the file owner to C<owner> and group to C<group>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:724 ../fish/guestfish-actions.pod:2585 ../src/guestfs-actions.pod:1086 ../src/guestfs-actions.pod:3829 +#: ../fish/guestfish-actions.pod:724 ../fish/guestfish-actions.pod:2657 ../src/guestfs-actions.pod:1086 ../src/guestfs-actions.pod:4069 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 " @@ -6908,38 +6940,141 @@ msgstr "" #. type: =head2 #: ../fish/guestfish-actions.pod:825 -msgid "copy-size" +msgid "copy-device-to-device" msgstr "" #. type: verbatim #: ../fish/guestfish-actions.pod:827 #, no-wrap msgid "" +" copy-device-to-device src dest [srcoffset:..] [destoffset:..] [size:..]\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:829 +msgid "" +"The four calls L</copy-device-to-device>, L</copy-device-to-file>, " +"L</copy-file-to-device>, and L</copy-file-to-file> let you copy from a " +"source (device|file) to a destination (device|file)." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:836 ../src/guestfs-actions.pod:1313 +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 " +"in bytes. If not given, the offsets both default to zero, and the size " +"defaults to copying as much as possible until we hit the end of the source." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:842 ../src/guestfs-actions.pod:1319 +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:845 ../src/guestfs-actions.pod:1322 +msgid "" +"If the destination is a file, it is created if required. If the destination " +"file is not large enough, it is extended." +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:850 +msgid "copy-device-to-file" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:852 +#, no-wrap +msgid "" +" copy-device-to-file src dest [srcoffset:..] [destoffset:..] [size:..]\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:854 ../fish/guestfish-actions.pod:863 ../fish/guestfish-actions.pod:872 +msgid "See L</copy-device-to-device> for a general overview of this call." +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:859 +msgid "copy-file-to-device" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:861 +#, no-wrap +msgid "" +" copy-file-to-device src dest [srcoffset:..] [destoffset:..] [size:..]\n" +"\n" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:868 +msgid "copy-file-to-file" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:870 +#, no-wrap +msgid "" +" copy-file-to-file src dest [srcoffset:..] [destoffset:..] [size:..]\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:875 +msgid "" +"This is B<not> the function you want for copying files. This is for copying " +"blocks within existing files. See L</cp>, L</cp-a> and L</mv> for general " +"file copying and moving functions." +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:882 +msgid "copy-size" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:884 +#, no-wrap +msgid "" " copy-size src dest size\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:829 ../src/guestfs-actions.pod:1297 +#: ../fish/guestfish-actions.pod:886 ../src/guestfs-actions.pod:1529 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:832 ../src/guestfs-actions.pod:1300 +#: ../fish/guestfish-actions.pod:889 ../src/guestfs-actions.pod:1532 msgid "" "Note this will fail if the source is too short or if the destination is not " "large enough." msgstr "" +#. type: textblock +#: ../fish/guestfish-actions.pod:892 ../fish/guestfish-actions.pod:927 +msgid "" +"I<This function is deprecated.> In new code, use the " +"L</copy_device_to_device> call instead." +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:835 +#: ../fish/guestfish-actions.pod:899 msgid "cp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:837 +#: ../fish/guestfish-actions.pod:901 #, no-wrap msgid "" " cp src dest\n" @@ -6947,19 +7082,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:839 ../src/guestfs-actions.pod:1319 +#: ../fish/guestfish-actions.pod:903 ../src/guestfs-actions.pod:1551 msgid "" "This copies 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:842 +#: ../fish/guestfish-actions.pod:906 msgid "cp-a" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:844 +#: ../fish/guestfish-actions.pod:908 #, no-wrap msgid "" " cp-a src dest\n" @@ -6967,19 +7102,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:846 ../src/guestfs-actions.pod:1333 +#: ../fish/guestfish-actions.pod:910 ../src/guestfs-actions.pod:1565 msgid "" "This copies a file or directory from C<src> to C<dest> recursively using the " "C<cp -a> command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:849 +#: ../fish/guestfish-actions.pod:913 msgid "dd" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:851 +#: ../fish/guestfish-actions.pod:915 #, no-wrap msgid "" " dd src dest\n" @@ -6987,7 +7122,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:853 ../src/guestfs-actions.pod:1347 +#: ../fish/guestfish-actions.pod:917 ../src/guestfs-actions.pod:1586 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 " @@ -6995,20 +7130,20 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:858 +#: ../fish/guestfish-actions.pod:922 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 " -"partial copies (see L</copy-size>)." +"partial copies (see L</copy-device-to-device>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:862 +#: ../fish/guestfish-actions.pod:934 msgid "df" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:864 +#: ../fish/guestfish-actions.pod:936 #, no-wrap msgid "" " df\n" @@ -7016,12 +7151,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:866 ../src/guestfs-actions.pod:1365 +#: ../fish/guestfish-actions.pod:938 ../src/guestfs-actions.pod:1605 msgid "This command runs the C<df> command to report disk space used." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:868 ../fish/guestfish-actions.pod:879 +#: ../fish/guestfish-actions.pod:940 ../fish/guestfish-actions.pod:951 msgid "" "This command is mostly useful for interactive sessions. It is I<not> " "intended that you try to parse the output string. Use L</statvfs> from " @@ -7029,12 +7164,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:872 +#: ../fish/guestfish-actions.pod:944 msgid "df-h" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:874 +#: ../fish/guestfish-actions.pod:946 #, no-wrap msgid "" " df-h\n" @@ -7042,19 +7177,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:876 ../src/guestfs-actions.pod:1381 +#: ../fish/guestfish-actions.pod:948 ../src/guestfs-actions.pod:1621 msgid "" "This command runs the C<df -h> command to report disk space used in " "human-readable format." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:883 +#: ../fish/guestfish-actions.pod:955 msgid "dmesg" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:885 +#: ../fish/guestfish-actions.pod:957 #, no-wrap msgid "" " dmesg\n" @@ -7062,14 +7197,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:887 ../src/guestfs-actions.pod:1398 +#: ../fish/guestfish-actions.pod:959 ../src/guestfs-actions.pod:1638 msgid "" "This returns the kernel messages (C<dmesg> output) from the guest kernel. " "This is sometimes useful for extended debugging of problems." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:891 +#: ../fish/guestfish-actions.pod:963 msgid "" "Another way to get the same information is to enable verbose messages with " "L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> " @@ -7077,12 +7212,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:896 +#: ../fish/guestfish-actions.pod:968 msgid "download" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:898 +#: ../fish/guestfish-actions.pod:970 #, no-wrap msgid "" " download remotefilename (filename|-)\n" @@ -7090,29 +7225,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:900 ../fish/guestfish-actions.pod:913 ../src/guestfs-actions.pod:1419 ../src/guestfs-actions.pod:1444 +#: ../fish/guestfish-actions.pod:972 ../fish/guestfish-actions.pod:985 ../src/guestfs-actions.pod:1659 ../src/guestfs-actions.pod:1684 msgid "" "Download file C<remotefilename> and save it as C<filename> on the local " "machine." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:903 ../fish/guestfish-actions.pod:4895 ../src/guestfs-actions.pod:1422 ../src/guestfs-actions.pod:7410 +#: ../fish/guestfish-actions.pod:975 ../fish/guestfish-actions.pod:4981 ../src/guestfs-actions.pod:1662 ../src/guestfs-actions.pod:7668 msgid "C<filename> can also be a named pipe." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:905 +#: ../fish/guestfish-actions.pod:977 msgid "See also L</upload>, L</cat>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:909 +#: ../fish/guestfish-actions.pod:981 msgid "download-offset" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:911 +#: ../fish/guestfish-actions.pod:983 #, no-wrap msgid "" " download-offset remotefilename (filename|-) offset size\n" @@ -7120,14 +7255,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:916 ../src/guestfs-actions.pod:1447 +#: ../fish/guestfish-actions.pod:988 ../src/guestfs-actions.pod:1687 msgid "" "C<remotefilename> is read for C<size> bytes starting at C<offset> (this " "region must be within the file or device)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:919 +#: ../fish/guestfish-actions.pod:991 msgid "" "Note that there is no limit on the amount of data that can be downloaded " "with this call, unlike with L</pread>, and this call always reads the full " @@ -7135,17 +7270,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:924 +#: ../fish/guestfish-actions.pod:996 msgid "See also L</download>, L</pread>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:928 +#: ../fish/guestfish-actions.pod:1000 msgid "drop-caches" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:930 +#: ../fish/guestfish-actions.pod:1002 #, no-wrap msgid "" " drop-caches whattodrop\n" @@ -7153,7 +7288,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:932 ../src/guestfs-actions.pod:1472 +#: ../fish/guestfish-actions.pod:1004 ../src/guestfs-actions.pod:1712 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 " @@ -7161,24 +7296,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:937 ../src/guestfs-actions.pod:1477 +#: ../fish/guestfish-actions.pod:1009 ../src/guestfs-actions.pod:1717 msgid "Setting C<whattodrop> to 3 should drop everything." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:939 ../src/guestfs-actions.pod:1479 +#: ../fish/guestfish-actions.pod:1011 ../src/guestfs-actions.pod:1719 msgid "" "This automatically calls L<sync(2)> before the operation, so that the " "maximum guest memory is freed." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:942 +#: ../fish/guestfish-actions.pod:1014 msgid "du" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:944 +#: ../fish/guestfish-actions.pod:1016 #, no-wrap msgid "" " du path\n" @@ -7186,14 +7321,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:946 ../src/guestfs-actions.pod:1492 +#: ../fish/guestfish-actions.pod:1018 ../src/guestfs-actions.pod:1732 msgid "" "This command runs the C<du -s> command to estimate file space usage for " "C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:949 ../src/guestfs-actions.pod:1495 +#: ../fish/guestfish-actions.pod:1021 ../src/guestfs-actions.pod:1735 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 " @@ -7201,17 +7336,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:953 ../src/guestfs-actions.pod:1499 +#: ../fish/guestfish-actions.pod:1025 ../src/guestfs-actions.pod:1739 msgid "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:956 +#: ../fish/guestfish-actions.pod:1028 msgid "e2fsck-f" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:958 +#: ../fish/guestfish-actions.pod:1030 #, no-wrap msgid "" " e2fsck-f device\n" @@ -7219,7 +7354,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:960 ../src/guestfs-actions.pod:1517 +#: ../fish/guestfish-actions.pod:1032 ../src/guestfs-actions.pod:1757 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 " @@ -7227,19 +7362,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:964 +#: ../fish/guestfish-actions.pod:1036 msgid "" "This command is only needed because of L</resize2fs> (q.v.). Normally you " "should use L</fsck>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:967 +#: ../fish/guestfish-actions.pod:1039 msgid "echo-daemon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:969 +#: ../fish/guestfish-actions.pod:1041 #, no-wrap msgid "" " echo-daemon 'words ...'\n" @@ -7247,29 +7382,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:971 ../src/guestfs-actions.pod:1534 +#: ../fish/guestfish-actions.pod:1043 ../src/guestfs-actions.pod:1774 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:974 ../src/guestfs-actions.pod:1537 +#: ../fish/guestfish-actions.pod:1046 ../src/guestfs-actions.pod:1777 msgid "You can use this command to test the connection through to the daemon." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:976 +#: ../fish/guestfish-actions.pod:1048 msgid "See also L</ping-daemon>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:978 +#: ../fish/guestfish-actions.pod:1050 msgid "egrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:980 +#: ../fish/guestfish-actions.pod:1052 #, no-wrap msgid "" " egrep regex path\n" @@ -7277,17 +7412,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:982 ../src/guestfs-actions.pod:1553 +#: ../fish/guestfish-actions.pod:1054 ../src/guestfs-actions.pod:1793 msgid "This calls the external C<egrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:988 +#: ../fish/guestfish-actions.pod:1060 msgid "egrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:990 +#: ../fish/guestfish-actions.pod:1062 #, no-wrap msgid "" " egrepi regex path\n" @@ -7295,17 +7430,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:992 ../src/guestfs-actions.pod:1572 +#: ../fish/guestfish-actions.pod:1064 ../src/guestfs-actions.pod:1812 msgid "This calls the external C<egrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:998 +#: ../fish/guestfish-actions.pod:1070 msgid "equal" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1000 +#: ../fish/guestfish-actions.pod:1072 #, no-wrap msgid "" " equal file1 file2\n" @@ -7313,24 +7448,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1002 ../src/guestfs-actions.pod:1591 +#: ../fish/guestfish-actions.pod:1074 ../src/guestfs-actions.pod:1831 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:1005 ../src/guestfs-actions.pod:1594 +#: ../fish/guestfish-actions.pod:1077 ../src/guestfs-actions.pod:1834 msgid "The external L<cmp(1)> program is used for the comparison." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1007 +#: ../fish/guestfish-actions.pod:1079 msgid "exists" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1009 +#: ../fish/guestfish-actions.pod:1081 #, no-wrap msgid "" " exists path\n" @@ -7338,24 +7473,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1011 ../src/guestfs-actions.pod:1606 +#: ../fish/guestfish-actions.pod:1083 ../src/guestfs-actions.pod:1846 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:1014 +#: ../fish/guestfish-actions.pod:1086 msgid "See also L</is-file>, L</is-dir>, L</stat>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1016 +#: ../fish/guestfish-actions.pod:1088 msgid "fallocate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1018 +#: ../fish/guestfish-actions.pod:1090 #, no-wrap msgid "" " fallocate path len\n" @@ -7363,33 +7498,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1020 ../fish/guestfish-actions.pod:1039 ../src/guestfs-actions.pod:1629 ../src/guestfs-actions.pod:1648 +#: ../fish/guestfish-actions.pod:1092 ../fish/guestfish-actions.pod:1111 ../src/guestfs-actions.pod:1869 ../src/guestfs-actions.pod:1888 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:1024 ../src/guestfs-actions.pod:1633 +#: ../fish/guestfish-actions.pod:1096 ../src/guestfs-actions.pod:1873 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:1028 +#: ../fish/guestfish-actions.pod:1100 msgid "" "I<This function is deprecated.> In new code, use the L</fallocate64> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1035 +#: ../fish/guestfish-actions.pod:1107 msgid "fallocate64" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1037 +#: ../fish/guestfish-actions.pod:1109 #, no-wrap msgid "" " fallocate64 path len\n" @@ -7397,14 +7532,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1043 +#: ../fish/guestfish-actions.pod:1115 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:1046 +#: ../fish/guestfish-actions.pod:1118 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 " @@ -7412,19 +7547,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1051 ../src/guestfs-actions.pod:1660 +#: ../fish/guestfish-actions.pod:1123 ../src/guestfs-actions.pod:1900 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:1055 +#: ../fish/guestfish-actions.pod:1127 msgid "fgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1057 +#: ../fish/guestfish-actions.pod:1129 #, no-wrap msgid "" " fgrep pattern path\n" @@ -7432,17 +7567,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1059 ../src/guestfs-actions.pod:1675 +#: ../fish/guestfish-actions.pod:1131 ../src/guestfs-actions.pod:1915 msgid "This calls the external C<fgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1065 +#: ../fish/guestfish-actions.pod:1137 msgid "fgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1067 +#: ../fish/guestfish-actions.pod:1139 #, no-wrap msgid "" " fgrepi pattern path\n" @@ -7450,17 +7585,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1069 ../src/guestfs-actions.pod:1694 +#: ../fish/guestfish-actions.pod:1141 ../src/guestfs-actions.pod:1934 msgid "This calls the external C<fgrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1075 +#: ../fish/guestfish-actions.pod:1147 msgid "file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1077 +#: ../fish/guestfish-actions.pod:1149 #, no-wrap msgid "" " file path\n" @@ -7468,28 +7603,28 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1079 ../src/guestfs-actions.pod:1712 +#: ../fish/guestfish-actions.pod:1151 ../src/guestfs-actions.pod:1952 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:1082 ../src/guestfs-actions.pod:1715 +#: ../fish/guestfish-actions.pod:1154 ../src/guestfs-actions.pod:1955 msgid "" "This call will also transparently look inside various types of compressed " "file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1085 ../src/guestfs-actions.pod:1718 +#: ../fish/guestfish-actions.pod:1157 ../src/guestfs-actions.pod:1958 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:1089 ../src/guestfs-actions.pod:1722 +#: ../fish/guestfish-actions.pod:1161 ../src/guestfs-actions.pod:1962 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 " @@ -7497,19 +7632,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1093 +#: ../fish/guestfish-actions.pod:1165 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:1096 +#: ../fish/guestfish-actions.pod:1168 msgid "file-architecture" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1098 +#: ../fish/guestfish-actions.pod:1170 #, no-wrap msgid "" " file-architecture filename\n" @@ -7517,166 +7652,166 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1100 ../src/guestfs-actions.pod:1740 +#: ../fish/guestfish-actions.pod:1172 ../src/guestfs-actions.pod:1980 msgid "" "This detects the architecture of the binary C<filename>, and returns it if " "known." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1103 ../src/guestfs-actions.pod:1743 +#: ../fish/guestfish-actions.pod:1175 ../src/guestfs-actions.pod:1983 msgid "Currently defined architectures are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1107 ../src/guestfs-actions.pod:1747 +#: ../fish/guestfish-actions.pod:1179 ../src/guestfs-actions.pod:1987 msgid "\"i386\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1109 ../src/guestfs-actions.pod:1749 +#: ../fish/guestfish-actions.pod:1181 ../src/guestfs-actions.pod:1989 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:1112 ../src/guestfs-actions.pod:1752 +#: ../fish/guestfish-actions.pod:1184 ../src/guestfs-actions.pod:1992 msgid "\"x86_64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1114 ../src/guestfs-actions.pod:1754 +#: ../fish/guestfish-actions.pod:1186 ../src/guestfs-actions.pod:1994 msgid "64 bit x86-64." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1116 ../src/guestfs-actions.pod:1756 +#: ../fish/guestfish-actions.pod:1188 ../src/guestfs-actions.pod:1996 msgid "\"sparc\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1118 ../src/guestfs-actions.pod:1758 +#: ../fish/guestfish-actions.pod:1190 ../src/guestfs-actions.pod:1998 msgid "32 bit SPARC." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1120 ../src/guestfs-actions.pod:1760 +#: ../fish/guestfish-actions.pod:1192 ../src/guestfs-actions.pod:2000 msgid "\"sparc64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1122 ../src/guestfs-actions.pod:1762 +#: ../fish/guestfish-actions.pod:1194 ../src/guestfs-actions.pod:2002 msgid "64 bit SPARC V9 and above." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1124 ../src/guestfs-actions.pod:1764 +#: ../fish/guestfish-actions.pod:1196 ../src/guestfs-actions.pod:2004 msgid "\"ia64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1126 ../src/guestfs-actions.pod:1766 +#: ../fish/guestfish-actions.pod:1198 ../src/guestfs-actions.pod:2006 msgid "Intel Itanium." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1128 ../src/guestfs-actions.pod:1768 +#: ../fish/guestfish-actions.pod:1200 ../src/guestfs-actions.pod:2008 msgid "\"ppc\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1130 ../src/guestfs-actions.pod:1770 +#: ../fish/guestfish-actions.pod:1202 ../src/guestfs-actions.pod:2010 msgid "32 bit Power PC." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1132 ../src/guestfs-actions.pod:1772 +#: ../fish/guestfish-actions.pod:1204 ../src/guestfs-actions.pod:2012 msgid "\"ppc64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1134 ../src/guestfs-actions.pod:1774 +#: ../fish/guestfish-actions.pod:1206 ../src/guestfs-actions.pod:2014 msgid "64 bit Power PC." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1138 ../src/guestfs-actions.pod:1778 +#: ../fish/guestfish-actions.pod:1210 ../src/guestfs-actions.pod:2018 msgid "Libguestfs may return other architecture strings in future." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1140 ../src/guestfs-actions.pod:1780 +#: ../fish/guestfish-actions.pod:1212 ../src/guestfs-actions.pod:2020 msgid "The function works on at least the following types of files:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1146 ../src/guestfs-actions.pod:1786 +#: ../fish/guestfish-actions.pod:1218 ../src/guestfs-actions.pod:2026 msgid "many types of Un*x and Linux binary" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1150 ../src/guestfs-actions.pod:1790 +#: ../fish/guestfish-actions.pod:1222 ../src/guestfs-actions.pod:2030 msgid "many types of Un*x and Linux shared library" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1154 ../src/guestfs-actions.pod:1794 +#: ../fish/guestfish-actions.pod:1226 ../src/guestfs-actions.pod:2034 msgid "Windows Win32 and Win64 binaries" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1158 ../src/guestfs-actions.pod:1798 +#: ../fish/guestfish-actions.pod:1230 ../src/guestfs-actions.pod:2038 msgid "Windows Win32 and Win64 DLLs" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1160 ../src/guestfs-actions.pod:1800 +#: ../fish/guestfish-actions.pod:1232 ../src/guestfs-actions.pod:2040 msgid "Win32 binaries and DLLs return C<i386>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1162 ../src/guestfs-actions.pod:1802 +#: ../fish/guestfish-actions.pod:1234 ../src/guestfs-actions.pod:2042 msgid "Win64 binaries and DLLs return C<x86_64>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1166 ../src/guestfs-actions.pod:1806 +#: ../fish/guestfish-actions.pod:1238 ../src/guestfs-actions.pod:2046 msgid "Linux kernel modules" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1170 ../src/guestfs-actions.pod:1810 +#: ../fish/guestfish-actions.pod:1242 ../src/guestfs-actions.pod:2050 msgid "Linux new-style initrd images" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1174 ../src/guestfs-actions.pod:1814 +#: ../fish/guestfish-actions.pod:1246 ../src/guestfs-actions.pod:2054 msgid "some non-x86 Linux vmlinuz kernels" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1178 ../src/guestfs-actions.pod:1818 +#: ../fish/guestfish-actions.pod:1250 ../src/guestfs-actions.pod:2058 msgid "What it can't do currently:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1184 ../src/guestfs-actions.pod:1824 +#: ../fish/guestfish-actions.pod:1256 ../src/guestfs-actions.pod:2064 msgid "static libraries (libfoo.a)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1188 ../src/guestfs-actions.pod:1828 +#: ../fish/guestfish-actions.pod:1260 ../src/guestfs-actions.pod:2068 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1192 ../src/guestfs-actions.pod:1832 +#: ../fish/guestfish-actions.pod:1264 ../src/guestfs-actions.pod:2072 msgid "x86 Linux vmlinuz kernels" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1194 ../src/guestfs-actions.pod:1834 +#: ../fish/guestfish-actions.pod:1266 ../src/guestfs-actions.pod:2074 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 " @@ -7685,12 +7820,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1201 +#: ../fish/guestfish-actions.pod:1273 msgid "filesize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1203 +#: ../fish/guestfish-actions.pod:1275 #, no-wrap msgid "" " filesize file\n" @@ -7698,12 +7833,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1205 ../src/guestfs-actions.pod:1852 +#: ../fish/guestfish-actions.pod:1277 ../src/guestfs-actions.pod:2092 msgid "This command returns the size of C<file> in bytes." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1207 +#: ../fish/guestfish-actions.pod:1279 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 " @@ -7711,12 +7846,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1211 +#: ../fish/guestfish-actions.pod:1283 msgid "fill" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1213 +#: ../fish/guestfish-actions.pod:1285 #, no-wrap msgid "" " fill c len path\n" @@ -7724,7 +7859,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1215 ../src/guestfs-actions.pod:1870 +#: ../fish/guestfish-actions.pod:1287 ../src/guestfs-actions.pod:2110 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 " @@ -7732,7 +7867,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1219 +#: ../fish/guestfish-actions.pod:1291 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 " @@ -7740,12 +7875,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1224 +#: ../fish/guestfish-actions.pod:1296 msgid "fill-pattern" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1226 +#: ../fish/guestfish-actions.pod:1298 #, no-wrap msgid "" " fill-pattern pattern len path\n" @@ -7753,7 +7888,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1228 +#: ../fish/guestfish-actions.pod:1300 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 " @@ -7762,12 +7897,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1233 +#: ../fish/guestfish-actions.pod:1305 msgid "find" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1235 +#: ../fish/guestfish-actions.pod:1307 #, no-wrap msgid "" " find directory\n" @@ -7775,7 +7910,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1237 ../src/guestfs-actions.pod:1916 +#: ../fish/guestfish-actions.pod:1309 ../src/guestfs-actions.pod:2156 msgid "" "This command lists out all files and directories, recursively, starting at " "C<directory>. It is essentially equivalent to running the shell command " @@ -7784,14 +7919,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1242 ../src/guestfs-actions.pod:1921 +#: ../fish/guestfish-actions.pod:1314 ../src/guestfs-actions.pod:2161 msgid "" "This returns a list of strings I<without any prefix>. Thus if the directory " "structure was:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1245 ../src/guestfs-actions.pod:1924 +#: ../fish/guestfish-actions.pod:1317 ../src/guestfs-actions.pod:2164 #, no-wrap msgid "" " /tmp/a\n" @@ -7801,12 +7936,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1249 +#: ../fish/guestfish-actions.pod:1321 msgid "then the returned list from L</find> C</tmp> would be 4 elements:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1252 ../src/guestfs-actions.pod:1931 +#: ../fish/guestfish-actions.pod:1324 ../src/guestfs-actions.pod:2171 #, no-wrap msgid "" " a\n" @@ -7817,27 +7952,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1257 ../src/guestfs-actions.pod:1936 +#: ../fish/guestfish-actions.pod:1329 ../src/guestfs-actions.pod:2176 msgid "If C<directory> is not a directory, then this command returns an error." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1260 ../src/guestfs-actions.pod:1939 +#: ../fish/guestfish-actions.pod:1332 ../src/guestfs-actions.pod:2179 msgid "The returned list is sorted." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1262 +#: ../fish/guestfish-actions.pod:1334 msgid "See also L</find0>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1267 +#: ../fish/guestfish-actions.pod:1339 msgid "find0" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1269 +#: ../fish/guestfish-actions.pod:1341 #, no-wrap msgid "" " find0 directory (files|-)\n" @@ -7845,7 +7980,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1271 ../src/guestfs-actions.pod:1959 +#: ../fish/guestfish-actions.pod:1343 ../src/guestfs-actions.pod:2199 msgid "" "This command lists out all files and directories, recursively, starting at " "C<directory>, placing the resulting list in the external file called " @@ -7853,39 +7988,39 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1275 +#: ../fish/guestfish-actions.pod:1347 msgid "This command works the same way as L</find> with the following exceptions:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1282 ../src/guestfs-actions.pod:1970 +#: ../fish/guestfish-actions.pod:1354 ../src/guestfs-actions.pod:2210 msgid "The resulting list is written to an external file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1286 ../src/guestfs-actions.pod:1974 +#: ../fish/guestfish-actions.pod:1358 ../src/guestfs-actions.pod:2214 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:1291 ../src/guestfs-actions.pod:1979 +#: ../fish/guestfish-actions.pod:1363 ../src/guestfs-actions.pod:2219 msgid "This command is not limited in the number of names that it can return." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1296 ../src/guestfs-actions.pod:1984 +#: ../fish/guestfish-actions.pod:1368 ../src/guestfs-actions.pod:2224 msgid "The result list is not sorted." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1302 +#: ../fish/guestfish-actions.pod:1374 msgid "findfs-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1304 +#: ../fish/guestfish-actions.pod:1376 #, no-wrap msgid "" " findfs-label label\n" @@ -7893,24 +8028,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1306 ../src/guestfs-actions.pod:1998 +#: ../fish/guestfish-actions.pod:1378 ../src/guestfs-actions.pod:2238 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:1310 +#: ../fish/guestfish-actions.pod:1382 msgid "To find the label of a filesystem, use L</vfs-label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1312 +#: ../fish/guestfish-actions.pod:1384 msgid "findfs-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1314 +#: ../fish/guestfish-actions.pod:1386 #, no-wrap msgid "" " findfs-uuid uuid\n" @@ -7918,24 +8053,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1316 ../src/guestfs-actions.pod:2015 +#: ../fish/guestfish-actions.pod:1388 ../src/guestfs-actions.pod:2255 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:1320 +#: ../fish/guestfish-actions.pod:1392 msgid "To find the UUID of a filesystem, use L</vfs-uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1322 +#: ../fish/guestfish-actions.pod:1394 msgid "fsck" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1324 +#: ../fish/guestfish-actions.pod:1396 #, no-wrap msgid "" " fsck fstype device\n" @@ -7943,48 +8078,48 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1326 ../src/guestfs-actions.pod:2033 +#: ../fish/guestfish-actions.pod:1398 ../src/guestfs-actions.pod:2273 msgid "" "This runs the filesystem checker (fsck) on C<device> which should have " "filesystem type C<fstype>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1329 ../src/guestfs-actions.pod:2036 +#: ../fish/guestfish-actions.pod:1401 ../src/guestfs-actions.pod:2276 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:1338 ../src/guestfs-actions.pod:2045 +#: ../fish/guestfish-actions.pod:1410 ../src/guestfs-actions.pod:2285 msgid "Multiple status codes can be summed together." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1342 ../src/guestfs-actions.pod:2049 +#: ../fish/guestfish-actions.pod:1414 ../src/guestfs-actions.pod:2289 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:1347 ../src/guestfs-actions.pod:2054 +#: ../fish/guestfish-actions.pod:1419 ../src/guestfs-actions.pod:2294 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1352 ../src/guestfs-actions.pod:2059 +#: ../fish/guestfish-actions.pod:1424 ../src/guestfs-actions.pod:2299 msgid "This command is entirely equivalent to running C<fsck -a -t fstype device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1354 +#: ../fish/guestfish-actions.pod:1426 msgid "get-append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1356 +#: ../fish/guestfish-actions.pod:1428 #, no-wrap msgid "" " get-append\n" @@ -7992,24 +8127,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1358 ../src/guestfs-actions.pod:2070 +#: ../fish/guestfish-actions.pod:1430 ../src/guestfs-actions.pod:2310 msgid "" "Return the additional kernel options which are added to the guest kernel " "command line." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1361 ../src/guestfs-actions.pod:2073 +#: ../fish/guestfish-actions.pod:1433 ../src/guestfs-actions.pod:2313 msgid "If C<NULL> then no options are added." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1363 +#: ../fish/guestfish-actions.pod:1435 msgid "get-attach-method" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1365 +#: ../fish/guestfish-actions.pod:1437 #, no-wrap msgid "" " get-attach-method\n" @@ -8017,17 +8152,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1367 +#: ../fish/guestfish-actions.pod:1439 msgid "Return the current attach method. See L</set-attach-method>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1369 +#: ../fish/guestfish-actions.pod:1441 msgid "get-autosync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1371 +#: ../fish/guestfish-actions.pod:1443 #, no-wrap msgid "" " get-autosync\n" @@ -8035,17 +8170,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1373 ../src/guestfs-actions.pod:2098 +#: ../fish/guestfish-actions.pod:1445 ../src/guestfs-actions.pod:2338 msgid "Get the autosync flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1375 +#: ../fish/guestfish-actions.pod:1447 msgid "get-direct" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1377 +#: ../fish/guestfish-actions.pod:1449 #, no-wrap msgid "" " get-direct\n" @@ -8053,17 +8188,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1379 ../src/guestfs-actions.pod:2109 +#: ../fish/guestfish-actions.pod:1451 ../src/guestfs-actions.pod:2349 msgid "Return the direct appliance mode flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1381 +#: ../fish/guestfish-actions.pod:1453 msgid "get-e2label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1383 +#: ../fish/guestfish-actions.pod:1455 #, no-wrap msgid "" " get-e2label device\n" @@ -8071,24 +8206,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1385 ../src/guestfs-actions.pod:2128 +#: ../fish/guestfish-actions.pod:1457 ../src/guestfs-actions.pod:2368 msgid "This returns the ext2/3/4 filesystem label of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1388 +#: ../fish/guestfish-actions.pod:1460 msgid "" "I<This function is deprecated.> In new code, use the L</vfs_label> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1395 +#: ../fish/guestfish-actions.pod:1467 msgid "get-e2uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1397 +#: ../fish/guestfish-actions.pod:1469 #, no-wrap msgid "" " get-e2uuid device\n" @@ -8096,24 +8231,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1399 ../src/guestfs-actions.pod:2149 +#: ../fish/guestfish-actions.pod:1471 ../src/guestfs-actions.pod:2389 msgid "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1402 +#: ../fish/guestfish-actions.pod:1474 msgid "" "I<This function is deprecated.> In new code, use the L</vfs_uuid> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1409 +#: ../fish/guestfish-actions.pod:1481 msgid "get-memsize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1411 +#: ../fish/guestfish-actions.pod:1483 #, no-wrap msgid "" " get-memsize\n" @@ -8121,12 +8256,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1413 ../src/guestfs-actions.pod:2162 +#: ../fish/guestfish-actions.pod:1485 ../src/guestfs-actions.pod:2402 msgid "This gets the memory size in megabytes allocated to the qemu subprocess." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1416 +#: ../fish/guestfish-actions.pod:1488 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 " @@ -8134,17 +8269,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1420 ../fish/guestfish-actions.pod:1477 ../fish/guestfish-actions.pod:4243 ../fish/guestfish-actions.pod:4345 ../src/guestfs-actions.pod:2169 ../src/guestfs-actions.pod:2261 ../src/guestfs-actions.pod:6455 ../src/guestfs-actions.pod:6581 +#: ../fish/guestfish-actions.pod:1492 ../fish/guestfish-actions.pod:1549 ../fish/guestfish-actions.pod:4329 ../fish/guestfish-actions.pod:4431 ../src/guestfs-actions.pod:2409 ../src/guestfs-actions.pod:2501 ../src/guestfs-actions.pod:6713 ../src/guestfs-actions.pod:6839 msgid "For more information on the architecture of libguestfs, see L<guestfs(3)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1423 +#: ../fish/guestfish-actions.pod:1495 msgid "get-network" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1425 +#: ../fish/guestfish-actions.pod:1497 #, no-wrap msgid "" " get-network\n" @@ -8152,17 +8287,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1427 ../src/guestfs-actions.pod:2181 +#: ../fish/guestfish-actions.pod:1499 ../src/guestfs-actions.pod:2421 msgid "This returns the enable network flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1429 +#: ../fish/guestfish-actions.pod:1501 msgid "get-path" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1431 +#: ../fish/guestfish-actions.pod:1503 #, no-wrap msgid "" " get-path\n" @@ -8170,24 +8305,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1433 ../src/guestfs-actions.pod:2192 +#: ../fish/guestfish-actions.pod:1505 ../src/guestfs-actions.pod:2432 msgid "Return the current search path." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1435 ../src/guestfs-actions.pod:2194 +#: ../fish/guestfish-actions.pod:1507 ../src/guestfs-actions.pod:2434 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:1438 +#: ../fish/guestfish-actions.pod:1510 msgid "get-pgroup" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1440 +#: ../fish/guestfish-actions.pod:1512 #, no-wrap msgid "" " get-pgroup\n" @@ -8195,22 +8330,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1442 ../src/guestfs-actions.pod:2207 +#: ../fish/guestfish-actions.pod:1514 ../src/guestfs-actions.pod:2447 msgid "This returns the process group flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1444 +#: ../fish/guestfish-actions.pod:1516 msgid "get-pid" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1446 +#: ../fish/guestfish-actions.pod:1518 msgid "pid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1448 +#: ../fish/guestfish-actions.pod:1520 #, no-wrap msgid "" " get-pid\n" @@ -8218,24 +8353,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1450 ../src/guestfs-actions.pod:2218 +#: ../fish/guestfish-actions.pod:1522 ../src/guestfs-actions.pod:2458 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:1453 ../src/guestfs-actions.pod:2221 +#: ../fish/guestfish-actions.pod:1525 ../src/guestfs-actions.pod:2461 msgid "This is an internal call used for debugging and testing." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1455 +#: ../fish/guestfish-actions.pod:1527 msgid "get-qemu" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1457 +#: ../fish/guestfish-actions.pod:1529 #, no-wrap msgid "" " get-qemu\n" @@ -8243,24 +8378,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1459 ../src/guestfs-actions.pod:2232 +#: ../fish/guestfish-actions.pod:1531 ../src/guestfs-actions.pod:2472 msgid "Return the current qemu binary." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1461 ../src/guestfs-actions.pod:2234 +#: ../fish/guestfish-actions.pod:1533 ../src/guestfs-actions.pod:2474 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:1464 +#: ../fish/guestfish-actions.pod:1536 msgid "get-recovery-proc" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1466 +#: ../fish/guestfish-actions.pod:1538 #, no-wrap msgid "" " get-recovery-proc\n" @@ -8268,17 +8403,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1468 ../src/guestfs-actions.pod:2247 +#: ../fish/guestfish-actions.pod:1540 ../src/guestfs-actions.pod:2487 msgid "Return the recovery process enabled flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1470 +#: ../fish/guestfish-actions.pod:1542 msgid "get-selinux" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1472 +#: ../fish/guestfish-actions.pod:1544 #, no-wrap msgid "" " get-selinux\n" @@ -8286,19 +8421,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1474 +#: ../fish/guestfish-actions.pod:1546 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:1480 +#: ../fish/guestfish-actions.pod:1552 msgid "get-smp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1482 +#: ../fish/guestfish-actions.pod:1554 #, no-wrap msgid "" " get-smp\n" @@ -8306,17 +8441,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1484 ../src/guestfs-actions.pod:2273 +#: ../fish/guestfish-actions.pod:1556 ../src/guestfs-actions.pod:2513 msgid "This returns the number of virtual CPUs assigned to the appliance." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1486 +#: ../fish/guestfish-actions.pod:1558 msgid "get-state" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1488 +#: ../fish/guestfish-actions.pod:1560 #, no-wrap msgid "" " get-state\n" @@ -8324,24 +8459,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1490 ../src/guestfs-actions.pod:2284 +#: ../fish/guestfish-actions.pod:1562 ../src/guestfs-actions.pod:2524 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:1493 ../fish/guestfish-actions.pod:2452 ../fish/guestfish-actions.pod:2470 ../fish/guestfish-actions.pod:2508 ../fish/guestfish-actions.pod:2524 ../src/guestfs-actions.pod:2287 ../src/guestfs-actions.pod:3606 ../src/guestfs-actions.pod:3635 ../src/guestfs-actions.pod:3696 ../src/guestfs-actions.pod:3723 +#: ../fish/guestfish-actions.pod:1565 ../fish/guestfish-actions.pod:2524 ../fish/guestfish-actions.pod:2542 ../fish/guestfish-actions.pod:2580 ../fish/guestfish-actions.pod:2596 ../src/guestfs-actions.pod:2527 ../src/guestfs-actions.pod:3846 ../src/guestfs-actions.pod:3875 ../src/guestfs-actions.pod:3936 ../src/guestfs-actions.pod:3963 msgid "For more information on states, see L<guestfs(3)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1495 +#: ../fish/guestfish-actions.pod:1567 msgid "get-trace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1497 +#: ../fish/guestfish-actions.pod:1569 #, no-wrap msgid "" " get-trace\n" @@ -8349,17 +8484,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1499 ../src/guestfs-actions.pod:2298 +#: ../fish/guestfish-actions.pod:1571 ../src/guestfs-actions.pod:2538 msgid "Return the command trace flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1501 +#: ../fish/guestfish-actions.pod:1573 msgid "get-umask" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1503 +#: ../fish/guestfish-actions.pod:1575 #, no-wrap msgid "" " get-umask\n" @@ -8367,19 +8502,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1505 +#: ../fish/guestfish-actions.pod:1577 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:1508 +#: ../fish/guestfish-actions.pod:1580 msgid "get-verbose" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1510 +#: ../fish/guestfish-actions.pod:1582 #, no-wrap msgid "" " get-verbose\n" @@ -8387,17 +8522,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1512 ../src/guestfs-actions.pod:2321 +#: ../fish/guestfish-actions.pod:1584 ../src/guestfs-actions.pod:2561 msgid "This returns the verbose messages flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1514 +#: ../fish/guestfish-actions.pod:1586 msgid "getcon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1516 +#: ../fish/guestfish-actions.pod:1588 #, no-wrap msgid "" " getcon\n" @@ -8405,22 +8540,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1518 ../src/guestfs-actions.pod:2332 +#: ../fish/guestfish-actions.pod:1590 ../src/guestfs-actions.pod:2572 msgid "This gets the SELinux security context of the daemon." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1520 +#: ../fish/guestfish-actions.pod:1592 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1523 +#: ../fish/guestfish-actions.pod:1595 msgid "getxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1525 +#: ../fish/guestfish-actions.pod:1597 #, no-wrap msgid "" " getxattr path name\n" @@ -8428,7 +8563,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1527 +#: ../fish/guestfish-actions.pod:1599 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 " @@ -8436,7 +8571,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1531 ../fish/guestfish-actions.pod:2597 +#: ../fish/guestfish-actions.pod:1603 ../fish/guestfish-actions.pod:2669 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 " @@ -8446,24 +8581,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1538 ../fish/guestfish-actions.pod:2604 ../src/guestfs-actions.pod:2361 ../src/guestfs-actions.pod:3856 +#: ../fish/guestfish-actions.pod:1610 ../fish/guestfish-actions.pod:2676 ../src/guestfs-actions.pod:2601 ../src/guestfs-actions.pod:4096 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:1541 +#: ../fish/guestfish-actions.pod:1613 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1543 +#: ../fish/guestfish-actions.pod:1615 msgid "getxattrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1545 +#: ../fish/guestfish-actions.pod:1617 #, no-wrap msgid "" " getxattrs path\n" @@ -8471,29 +8606,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1547 ../src/guestfs-actions.pod:2378 +#: ../fish/guestfish-actions.pod:1619 ../src/guestfs-actions.pod:2618 msgid "This call lists the extended attributes of the file or directory C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1550 ../src/guestfs-actions.pod:2381 +#: ../fish/guestfish-actions.pod:1622 ../src/guestfs-actions.pod:2621 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:1553 +#: ../fish/guestfish-actions.pod:1625 msgid "See also: L</lgetxattrs>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1555 +#: ../fish/guestfish-actions.pod:1627 msgid "glob-expand" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1557 +#: ../fish/guestfish-actions.pod:1629 #, no-wrap msgid "" " glob-expand pattern\n" @@ -8501,31 +8636,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1559 ../src/guestfs-actions.pod:2398 +#: ../fish/guestfish-actions.pod:1631 ../src/guestfs-actions.pod:2638 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:1563 ../src/guestfs-actions.pod:2402 +#: ../fish/guestfish-actions.pod:1635 ../src/guestfs-actions.pod:2642 msgid "If no paths match, then this returns an empty list (note: not an error)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1566 ../src/guestfs-actions.pod:2405 +#: ../fish/guestfish-actions.pod:1638 ../src/guestfs-actions.pod:2645 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: =head2 -#: ../fish/guestfish-actions.pod:1570 +#: ../fish/guestfish-actions.pod:1642 msgid "grep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1572 +#: ../fish/guestfish-actions.pod:1644 #, no-wrap msgid "" " grep regex path\n" @@ -8533,17 +8668,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1574 ../src/guestfs-actions.pod:2422 +#: ../fish/guestfish-actions.pod:1646 ../src/guestfs-actions.pod:2662 msgid "This calls the external C<grep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1580 +#: ../fish/guestfish-actions.pod:1652 msgid "grepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1582 +#: ../fish/guestfish-actions.pod:1654 #, no-wrap msgid "" " grepi regex path\n" @@ -8551,17 +8686,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1584 ../src/guestfs-actions.pod:2441 +#: ../fish/guestfish-actions.pod:1656 ../src/guestfs-actions.pod:2681 msgid "This calls the external C<grep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1590 +#: ../fish/guestfish-actions.pod:1662 msgid "grub-install" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1592 +#: ../fish/guestfish-actions.pod:1664 #, no-wrap msgid "" " grub-install root device\n" @@ -8569,14 +8704,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1594 ../src/guestfs-actions.pod:2460 +#: ../fish/guestfish-actions.pod:1666 ../src/guestfs-actions.pod:2700 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:1603 ../src/guestfs-actions.pod:2469 +#: ../fish/guestfish-actions.pod:1675 ../src/guestfs-actions.pod:2709 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 " @@ -8584,7 +8719,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1610 ../src/guestfs-actions.pod:2476 +#: ../fish/guestfish-actions.pod:1682 ../src/guestfs-actions.pod:2716 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. " @@ -8592,7 +8727,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1617 ../src/guestfs-actions.pod:2483 +#: ../fish/guestfish-actions.pod:1689 ../src/guestfs-actions.pod:2723 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 " @@ -8602,7 +8737,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1624 ../src/guestfs-actions.pod:2490 +#: ../fish/guestfish-actions.pod:1696 ../src/guestfs-actions.pod:2730 #, no-wrap msgid "" " (hd0) /dev/vda\n" @@ -8610,17 +8745,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1626 ../src/guestfs-actions.pod:2492 +#: ../fish/guestfish-actions.pod:1698 ../src/guestfs-actions.pod:2732 msgid "replacing C</dev/vda> with the name of the installation device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1630 +#: ../fish/guestfish-actions.pod:1702 msgid "head" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1632 +#: ../fish/guestfish-actions.pod:1704 #, no-wrap msgid "" " head path\n" @@ -8628,19 +8763,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1634 ../src/guestfs-actions.pod:2506 +#: ../fish/guestfish-actions.pod:1706 ../src/guestfs-actions.pod:2746 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:1640 +#: ../fish/guestfish-actions.pod:1712 msgid "head-n" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1642 +#: ../fish/guestfish-actions.pod:1714 #, no-wrap msgid "" " head-n nrlines path\n" @@ -8648,31 +8783,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1644 ../src/guestfs-actions.pod:2525 +#: ../fish/guestfish-actions.pod:1716 ../src/guestfs-actions.pod:2765 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:1647 ../src/guestfs-actions.pod:2528 +#: ../fish/guestfish-actions.pod:1719 ../src/guestfs-actions.pod:2768 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:1650 ../fish/guestfish-actions.pod:4735 ../src/guestfs-actions.pod:2531 ../src/guestfs-actions.pod:7169 +#: ../fish/guestfish-actions.pod:1722 ../fish/guestfish-actions.pod:4821 ../src/guestfs-actions.pod:2771 ../src/guestfs-actions.pod:7427 msgid "If the parameter C<nrlines> is zero, this returns an empty list." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1655 +#: ../fish/guestfish-actions.pod:1727 msgid "hexdump" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1657 +#: ../fish/guestfish-actions.pod:1729 #, no-wrap msgid "" " hexdump path\n" @@ -8680,19 +8815,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1659 ../src/guestfs-actions.pod:2548 +#: ../fish/guestfish-actions.pod:1731 ../src/guestfs-actions.pod:2788 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:1665 +#: ../fish/guestfish-actions.pod:1737 msgid "initrd-cat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1667 +#: ../fish/guestfish-actions.pod:1739 #, no-wrap msgid "" " initrd-cat initrdpath filename\n" @@ -8700,7 +8835,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1669 ../src/guestfs-actions.pod:2567 +#: ../fish/guestfish-actions.pod:1741 ../src/guestfs-actions.pod:2807 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</> " @@ -8708,7 +8843,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1673 ../src/guestfs-actions.pod:2571 +#: ../fish/guestfish-actions.pod:1745 ../src/guestfs-actions.pod:2811 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 " @@ -8716,7 +8851,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1677 ../src/guestfs-actions.pod:2575 +#: ../fish/guestfish-actions.pod:1749 ../src/guestfs-actions.pod:2815 #, no-wrap msgid "" " initrd-cat /boot/initrd-<version>.img init\n" @@ -8724,17 +8859,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1679 +#: ../fish/guestfish-actions.pod:1751 msgid "See also L</initrd-list>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1684 +#: ../fish/guestfish-actions.pod:1756 msgid "initrd-list" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1686 +#: ../fish/guestfish-actions.pod:1758 #, no-wrap msgid "" " initrd-list path\n" @@ -8742,12 +8877,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1688 ../src/guestfs-actions.pod:2594 +#: ../fish/guestfish-actions.pod:1760 ../src/guestfs-actions.pod:2834 msgid "This command lists out files contained in an initrd." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1690 ../src/guestfs-actions.pod:2596 +#: ../fish/guestfish-actions.pod:1762 ../src/guestfs-actions.pod:2836 msgid "" "The files are listed without any initial C</> character. The files are " "listed in the order they appear (not necessarily alphabetical). Directory " @@ -8755,7 +8890,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1694 ../src/guestfs-actions.pod:2600 +#: ../fish/guestfish-actions.pod:1766 ../src/guestfs-actions.pod:2840 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 " @@ -8763,12 +8898,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1698 +#: ../fish/guestfish-actions.pod:1770 msgid "inotify-add-watch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1700 +#: ../fish/guestfish-actions.pod:1772 #, no-wrap msgid "" " inotify-add-watch path mask\n" @@ -8776,31 +8911,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1702 ../src/guestfs-actions.pod:2617 +#: ../fish/guestfish-actions.pod:1774 ../src/guestfs-actions.pod:2857 msgid "Watch C<path> for the events listed in C<mask>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1704 ../src/guestfs-actions.pod:2619 +#: ../fish/guestfish-actions.pod:1776 ../src/guestfs-actions.pod:2859 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:1708 ../src/guestfs-actions.pod:2623 +#: ../fish/guestfish-actions.pod:1780 ../src/guestfs-actions.pod:2863 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:1712 +#: ../fish/guestfish-actions.pod:1784 msgid "inotify-close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1714 +#: ../fish/guestfish-actions.pod:1786 #, no-wrap msgid "" " inotify-close\n" @@ -8808,7 +8943,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1716 ../src/guestfs-actions.pod:2636 +#: ../fish/guestfish-actions.pod:1788 ../src/guestfs-actions.pod:2876 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 " @@ -8816,12 +8951,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1720 +#: ../fish/guestfish-actions.pod:1792 msgid "inotify-files" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1722 +#: ../fish/guestfish-actions.pod:1794 #, no-wrap msgid "" " inotify-files\n" @@ -8829,7 +8964,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1724 +#: ../fish/guestfish-actions.pod:1796 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 " @@ -8837,12 +8972,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1728 +#: ../fish/guestfish-actions.pod:1800 msgid "inotify-init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1730 +#: ../fish/guestfish-actions.pod:1802 #, no-wrap msgid "" " inotify-init maxevents\n" @@ -8850,14 +8985,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1732 ../src/guestfs-actions.pod:2665 +#: ../fish/guestfish-actions.pod:1804 ../src/guestfs-actions.pod:2905 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:1736 +#: ../fish/guestfish-actions.pod:1808 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>, " @@ -8868,7 +9003,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1746 +#: ../fish/guestfish-actions.pod:1818 msgid "" "Before any events are generated, you have to add some watches to the " "internal watch list. See: L</inotify-add-watch>, L</inotify-rm-watch> and " @@ -8876,7 +9011,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1752 +#: ../fish/guestfish-actions.pod:1824 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>). " @@ -8885,14 +9020,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1759 +#: ../fish/guestfish-actions.pod:1831 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:1763 ../src/guestfs-actions.pod:2696 +#: ../fish/guestfish-actions.pod:1835 ../src/guestfs-actions.pod:2936 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 " @@ -8900,12 +9035,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1768 +#: ../fish/guestfish-actions.pod:1840 msgid "inotify-read" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1770 +#: ../fish/guestfish-actions.pod:1842 #, no-wrap msgid "" " inotify-read\n" @@ -8913,19 +9048,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1772 ../src/guestfs-actions.pod:2710 +#: ../fish/guestfish-actions.pod:1844 ../src/guestfs-actions.pod:2950 msgid "" "Return the complete queue of events that have happened since the previous " "read call." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1775 ../src/guestfs-actions.pod:2713 +#: ../fish/guestfish-actions.pod:1847 ../src/guestfs-actions.pod:2953 msgid "If no events have happened, this returns an empty list." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1777 ../src/guestfs-actions.pod:2715 +#: ../fish/guestfish-actions.pod:1849 ../src/guestfs-actions.pod:2955 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 " @@ -8934,12 +9069,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1783 +#: ../fish/guestfish-actions.pod:1855 msgid "inotify-rm-watch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1785 +#: ../fish/guestfish-actions.pod:1857 #, no-wrap msgid "" " inotify-rm-watch wd\n" @@ -8947,17 +9082,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1787 +#: ../fish/guestfish-actions.pod:1859 msgid "Remove a previously defined inotify watch. See L</inotify-add-watch>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1790 +#: ../fish/guestfish-actions.pod:1862 msgid "inspect-get-arch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1792 +#: ../fish/guestfish-actions.pod:1864 #, no-wrap msgid "" " inspect-get-arch root\n" @@ -8965,31 +9100,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1794 +#: ../fish/guestfish-actions.pod:1866 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:1798 ../src/guestfs-actions.pod:2750 +#: ../fish/guestfish-actions.pod:1870 ../src/guestfs-actions.pod:2990 msgid "" "If the architecture could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1801 ../fish/guestfish-actions.pod:1896 ../fish/guestfish-actions.pod:1975 ../fish/guestfish-actions.pod:1987 ../fish/guestfish-actions.pod:2071 ../fish/guestfish-actions.pod:2133 ../fish/guestfish-actions.pod:2154 ../fish/guestfish-actions.pod:2168 ../fish/guestfish-actions.pod:2208 ../fish/guestfish-actions.pod:2244 ../fish/guestfish-actions.pod:2257 ../fish/guestfish-actions.pod:2270 ../fish/guestfish-actions.pod:2280 ../fish/guestfish-actions.pod:2290 ../fish/guestfish-actions.pod:2302 ../fish/guestfish-actions.pod:2398 ../fish/guestfish-actions.pod:2432 ../src/guestfs-actions.pod:2753 ../src/guestfs-actions.pod:2855 ../src/guestfs-actions.pod:2959 ../src/guestfs-actions.pod:2978 ../src/guestfs-actions.pod:3109 ../src/guestfs-actions.pod:3193 ../src/guestfs-actions.pod:3221 ../src/guestfs-actions.pod:3242 ../src/guestfs-actions.pod:3295 ../src/guestfs-actions.pod:3339 ../src/guestfs-actions.pod:3359 ../src/guestfs-actions.pod:3379 ../src/guestfs-actions.pod:3396 ../src/guestfs-actions.pod:3412 ../src/guestfs-actions.pod:3430 ../src/guestfs-actions.pod:3532 ../src/guestfs-actions.pod:3573 +#: ../fish/guestfish-actions.pod:1873 ../fish/guestfish-actions.pod:1968 ../fish/guestfish-actions.pod:2047 ../fish/guestfish-actions.pod:2059 ../fish/guestfish-actions.pod:2143 ../fish/guestfish-actions.pod:2205 ../fish/guestfish-actions.pod:2226 ../fish/guestfish-actions.pod:2240 ../fish/guestfish-actions.pod:2280 ../fish/guestfish-actions.pod:2316 ../fish/guestfish-actions.pod:2329 ../fish/guestfish-actions.pod:2342 ../fish/guestfish-actions.pod:2352 ../fish/guestfish-actions.pod:2362 ../fish/guestfish-actions.pod:2374 ../fish/guestfish-actions.pod:2470 ../fish/guestfish-actions.pod:2504 ../src/guestfs-actions.pod:2993 ../src/guestfs-actions.pod:3095 ../src/guestfs-actions.pod:3199 ../src/guestfs-actions.pod:3218 ../src/guestfs-actions.pod:3349 ../src/guestfs-actions.pod:3433 ../src/guestfs-actions.pod:3461 ../src/guestfs-actions.pod:3482 ../src/guestfs-actions.pod:3535 ../src/guestfs-actions.pod:3579 ../src/guestfs-actions.pod:3599 ../src/guestfs-actions.pod:3619 ../src/guestfs-actions.pod:3636 ../src/guestfs-actions.pod:3652 ../src/guestfs-actions.pod:3670 ../src/guestfs-actions.pod:3772 ../src/guestfs-actions.pod:3813 msgid "Please read L<guestfs(3)/INSPECTION> for more details." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1803 +#: ../fish/guestfish-actions.pod:1875 msgid "inspect-get-distro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1805 +#: ../fish/guestfish-actions.pod:1877 #, no-wrap msgid "" " inspect-get-distro root\n" @@ -8997,221 +9132,221 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1807 ../src/guestfs-actions.pod:2766 +#: ../fish/guestfish-actions.pod:1879 ../src/guestfs-actions.pod:3006 msgid "This returns the distro (distribution) of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1810 ../src/guestfs-actions.pod:2769 +#: ../fish/guestfish-actions.pod:1882 ../src/guestfs-actions.pod:3009 msgid "Currently defined distros are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1814 ../src/guestfs-actions.pod:2773 +#: ../fish/guestfish-actions.pod:1886 ../src/guestfs-actions.pod:3013 msgid "\"archlinux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1816 ../src/guestfs-actions.pod:2775 +#: ../fish/guestfish-actions.pod:1888 ../src/guestfs-actions.pod:3015 msgid "Arch Linux." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1818 ../src/guestfs-actions.pod:2777 +#: ../fish/guestfish-actions.pod:1890 ../src/guestfs-actions.pod:3017 msgid "\"centos\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1820 ../src/guestfs-actions.pod:2779 +#: ../fish/guestfish-actions.pod:1892 ../src/guestfs-actions.pod:3019 msgid "CentOS." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1822 ../src/guestfs-actions.pod:2781 +#: ../fish/guestfish-actions.pod:1894 ../src/guestfs-actions.pod:3021 msgid "\"debian\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1824 ../src/guestfs-actions.pod:2783 +#: ../fish/guestfish-actions.pod:1896 ../src/guestfs-actions.pod:3023 msgid "Debian." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1826 ../src/guestfs-actions.pod:2785 +#: ../fish/guestfish-actions.pod:1898 ../src/guestfs-actions.pod:3025 msgid "\"fedora\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1828 ../src/guestfs-actions.pod:2787 +#: ../fish/guestfish-actions.pod:1900 ../src/guestfs-actions.pod:3027 msgid "Fedora." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1830 ../src/guestfs-actions.pod:2789 +#: ../fish/guestfish-actions.pod:1902 ../src/guestfs-actions.pod:3029 msgid "\"gentoo\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1832 ../src/guestfs-actions.pod:2791 +#: ../fish/guestfish-actions.pod:1904 ../src/guestfs-actions.pod:3031 msgid "Gentoo." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1834 ../src/guestfs-actions.pod:2793 +#: ../fish/guestfish-actions.pod:1906 ../src/guestfs-actions.pod:3033 msgid "\"linuxmint\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1836 ../src/guestfs-actions.pod:2795 +#: ../fish/guestfish-actions.pod:1908 ../src/guestfs-actions.pod:3035 msgid "Linux Mint." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1838 ../src/guestfs-actions.pod:2797 +#: ../fish/guestfish-actions.pod:1910 ../src/guestfs-actions.pod:3037 msgid "\"mageia\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1840 ../src/guestfs-actions.pod:2799 +#: ../fish/guestfish-actions.pod:1912 ../src/guestfs-actions.pod:3039 msgid "Mageia." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1842 ../src/guestfs-actions.pod:2801 +#: ../fish/guestfish-actions.pod:1914 ../src/guestfs-actions.pod:3041 msgid "\"mandriva\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1844 ../src/guestfs-actions.pod:2803 +#: ../fish/guestfish-actions.pod:1916 ../src/guestfs-actions.pod:3043 msgid "Mandriva." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1846 ../src/guestfs-actions.pod:2805 +#: ../fish/guestfish-actions.pod:1918 ../src/guestfs-actions.pod:3045 msgid "\"meego\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1848 ../src/guestfs-actions.pod:2807 +#: ../fish/guestfish-actions.pod:1920 ../src/guestfs-actions.pod:3047 msgid "MeeGo." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1850 ../src/guestfs-actions.pod:2809 +#: ../fish/guestfish-actions.pod:1922 ../src/guestfs-actions.pod:3049 msgid "\"opensuse\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1852 ../src/guestfs-actions.pod:2811 +#: ../fish/guestfish-actions.pod:1924 ../src/guestfs-actions.pod:3051 msgid "OpenSUSE." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1854 ../src/guestfs-actions.pod:2813 +#: ../fish/guestfish-actions.pod:1926 ../src/guestfs-actions.pod:3053 msgid "\"pardus\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1856 ../src/guestfs-actions.pod:2815 +#: ../fish/guestfish-actions.pod:1928 ../src/guestfs-actions.pod:3055 msgid "Pardus." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1858 ../src/guestfs-actions.pod:2817 +#: ../fish/guestfish-actions.pod:1930 ../src/guestfs-actions.pod:3057 msgid "\"redhat-based\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1860 ../src/guestfs-actions.pod:2819 +#: ../fish/guestfish-actions.pod:1932 ../src/guestfs-actions.pod:3059 msgid "Some Red Hat-derived distro." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1862 ../src/guestfs-actions.pod:2821 +#: ../fish/guestfish-actions.pod:1934 ../src/guestfs-actions.pod:3061 msgid "\"rhel\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1864 ../src/guestfs-actions.pod:2823 +#: ../fish/guestfish-actions.pod:1936 ../src/guestfs-actions.pod:3063 msgid "Red Hat Enterprise Linux." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1866 ../src/guestfs-actions.pod:2825 +#: ../fish/guestfish-actions.pod:1938 ../src/guestfs-actions.pod:3065 msgid "\"scientificlinux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1868 ../src/guestfs-actions.pod:2827 +#: ../fish/guestfish-actions.pod:1940 ../src/guestfs-actions.pod:3067 msgid "Scientific Linux." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1870 ../src/guestfs-actions.pod:2829 +#: ../fish/guestfish-actions.pod:1942 ../src/guestfs-actions.pod:3069 msgid "\"slackware\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1872 ../src/guestfs-actions.pod:2831 +#: ../fish/guestfish-actions.pod:1944 ../src/guestfs-actions.pod:3071 msgid "Slackware." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1874 ../src/guestfs-actions.pod:2833 +#: ../fish/guestfish-actions.pod:1946 ../src/guestfs-actions.pod:3073 msgid "\"ttylinux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1876 ../src/guestfs-actions.pod:2835 +#: ../fish/guestfish-actions.pod:1948 ../src/guestfs-actions.pod:3075 msgid "ttylinux." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1878 ../src/guestfs-actions.pod:2837 +#: ../fish/guestfish-actions.pod:1950 ../src/guestfs-actions.pod:3077 msgid "\"ubuntu\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1880 ../src/guestfs-actions.pod:2839 +#: ../fish/guestfish-actions.pod:1952 ../src/guestfs-actions.pod:3079 msgid "Ubuntu." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1882 ../fish/guestfish-actions.pod:1966 ../fish/guestfish-actions.pod:2235 ../src/guestfs-actions.pod:2841 ../src/guestfs-actions.pod:2950 ../src/guestfs-actions.pod:3330 +#: ../fish/guestfish-actions.pod:1954 ../fish/guestfish-actions.pod:2038 ../fish/guestfish-actions.pod:2307 ../src/guestfs-actions.pod:3081 ../src/guestfs-actions.pod:3190 ../src/guestfs-actions.pod:3570 msgid "\"unknown\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1884 ../src/guestfs-actions.pod:2843 +#: ../fish/guestfish-actions.pod:1956 ../src/guestfs-actions.pod:3083 msgid "The distro could not be determined." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1886 ../fish/guestfish-actions.pod:2223 ../src/guestfs-actions.pod:2845 ../src/guestfs-actions.pod:3318 +#: ../fish/guestfish-actions.pod:1958 ../fish/guestfish-actions.pod:2295 ../src/guestfs-actions.pod:3085 ../src/guestfs-actions.pod:3558 msgid "\"windows\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1888 ../src/guestfs-actions.pod:2847 +#: ../fish/guestfish-actions.pod:1960 ../src/guestfs-actions.pod:3087 msgid "" "Windows does not have distributions. This string is returned if the OS type " "is Windows." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1893 ../fish/guestfish-actions.pod:1972 ../fish/guestfish-actions.pod:2241 ../src/guestfs-actions.pod:2852 ../src/guestfs-actions.pod:2956 ../src/guestfs-actions.pod:3336 +#: ../fish/guestfish-actions.pod:1965 ../fish/guestfish-actions.pod:2044 ../fish/guestfish-actions.pod:2313 ../src/guestfs-actions.pod:3092 ../src/guestfs-actions.pod:3196 ../src/guestfs-actions.pod:3576 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:1898 +#: ../fish/guestfish-actions.pod:1970 msgid "inspect-get-drive-mappings" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1900 +#: ../fish/guestfish-actions.pod:1972 #, no-wrap msgid "" " inspect-get-drive-mappings root\n" @@ -9219,7 +9354,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1902 ../src/guestfs-actions.pod:2868 +#: ../fish/guestfish-actions.pod:1974 ../src/guestfs-actions.pod:3108 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 " @@ -9228,7 +9363,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1908 ../src/guestfs-actions.pod:2874 +#: ../fish/guestfish-actions.pod:1980 ../src/guestfs-actions.pod:3114 #, no-wrap msgid "" " C => /dev/vda2\n" @@ -9238,7 +9373,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1912 ../src/guestfs-actions.pod:2878 +#: ../fish/guestfish-actions.pod:1984 ../src/guestfs-actions.pod:3118 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 " @@ -9246,7 +9381,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1916 ../src/guestfs-actions.pod:2882 +#: ../fish/guestfish-actions.pod:1988 ../src/guestfs-actions.pod:3122 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 " @@ -9255,33 +9390,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1921 ../src/guestfs-actions.pod:2887 +#: ../fish/guestfish-actions.pod:1993 ../src/guestfs-actions.pod:3127 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:1924 ../src/guestfs-actions.pod:2890 +#: ../fish/guestfish-actions.pod:1996 ../src/guestfs-actions.pod:3130 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:1927 +#: ../fish/guestfish-actions.pod:1999 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:1931 +#: ../fish/guestfish-actions.pod:2003 msgid "inspect-get-filesystems" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1933 +#: ../fish/guestfish-actions.pod:2005 #, no-wrap msgid "" " inspect-get-filesystems root\n" @@ -9289,7 +9424,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1935 ../src/guestfs-actions.pod:2911 +#: ../fish/guestfish-actions.pod:2007 ../src/guestfs-actions.pod:3151 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 " @@ -9297,26 +9432,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1940 ../src/guestfs-actions.pod:2916 +#: ../fish/guestfish-actions.pod:2012 ../src/guestfs-actions.pod:3156 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:1943 +#: ../fish/guestfish-actions.pod:2015 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-mountpoints>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1946 +#: ../fish/guestfish-actions.pod:2018 msgid "inspect-get-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1948 +#: ../fish/guestfish-actions.pod:2020 #, no-wrap msgid "" " inspect-get-format root\n" @@ -9324,51 +9459,51 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1950 ../src/guestfs-actions.pod:2934 +#: ../fish/guestfish-actions.pod:2022 ../src/guestfs-actions.pod:3174 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:1953 ../src/guestfs-actions.pod:2937 +#: ../fish/guestfish-actions.pod:2025 ../src/guestfs-actions.pod:3177 msgid "Currently defined formats are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1957 ../src/guestfs-actions.pod:2941 +#: ../fish/guestfish-actions.pod:2029 ../src/guestfs-actions.pod:3181 msgid "\"installed\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1959 ../src/guestfs-actions.pod:2943 +#: ../fish/guestfish-actions.pod:2031 ../src/guestfs-actions.pod:3183 msgid "This is an installed operating system." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1961 ../src/guestfs-actions.pod:2945 +#: ../fish/guestfish-actions.pod:2033 ../src/guestfs-actions.pod:3185 msgid "\"installer\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1963 ../src/guestfs-actions.pod:2947 +#: ../fish/guestfish-actions.pod:2035 ../src/guestfs-actions.pod:3187 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:1968 ../src/guestfs-actions.pod:2952 +#: ../fish/guestfish-actions.pod:2040 ../src/guestfs-actions.pod:3192 msgid "The format of this disk image is not known." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1977 +#: ../fish/guestfish-actions.pod:2049 msgid "inspect-get-hostname" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1979 +#: ../fish/guestfish-actions.pod:2051 #, no-wrap msgid "" " inspect-get-hostname root\n" @@ -9376,26 +9511,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1981 ../src/guestfs-actions.pod:2972 +#: ../fish/guestfish-actions.pod:2053 ../src/guestfs-actions.pod:3212 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:1984 ../src/guestfs-actions.pod:2975 +#: ../fish/guestfish-actions.pod:2056 ../src/guestfs-actions.pod:3215 msgid "" "If the hostname could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1989 +#: ../fish/guestfish-actions.pod:2061 msgid "inspect-get-icon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1991 +#: ../fish/guestfish-actions.pod:2063 #, no-wrap msgid "" " inspect-get-icon root [favicon:..] [highquality:..]\n" @@ -9403,7 +9538,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1993 ../src/guestfs-actions.pod:3001 +#: ../fish/guestfish-actions.pod:2065 ../src/guestfs-actions.pod:3241 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 " @@ -9411,14 +9546,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1997 ../src/guestfs-actions.pod:3005 +#: ../fish/guestfish-actions.pod:2069 ../src/guestfs-actions.pod:3245 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:2000 ../src/guestfs-actions.pod:3008 +#: ../fish/guestfish-actions.pod:2072 ../src/guestfs-actions.pod:3248 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 " @@ -9427,14 +9562,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2006 ../src/guestfs-actions.pod:3014 +#: ../fish/guestfish-actions.pod:2078 ../src/guestfs-actions.pod:3254 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:2009 ../src/guestfs-actions.pod:3017 +#: ../fish/guestfish-actions.pod:2081 ../src/guestfs-actions.pod:3257 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 " @@ -9443,7 +9578,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2020 ../src/guestfs-actions.pod:3028 +#: ../fish/guestfish-actions.pod:2092 ../src/guestfs-actions.pod:3268 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 " @@ -9451,7 +9586,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2026 ../src/guestfs-actions.pod:3034 +#: ../fish/guestfish-actions.pod:2098 ../src/guestfs-actions.pod:3274 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. " @@ -9460,7 +9595,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2034 ../src/guestfs-actions.pod:3042 +#: ../fish/guestfish-actions.pod:2106 ../src/guestfs-actions.pod:3282 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 " @@ -9468,7 +9603,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2041 ../src/guestfs-actions.pod:3049 +#: ../fish/guestfish-actions.pod:2113 ../src/guestfs-actions.pod:3289 msgid "" "Extracting icons from Windows guests requires the external C<wrestool> " "program from the C<icoutils> package, and several programs (C<bmptopnm>, " @@ -9477,19 +9612,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2048 ../src/guestfs-actions.pod:3056 +#: ../fish/guestfish-actions.pod:2120 ../src/guestfs-actions.pod:3296 msgid "" "Operating system icons are usually trademarks. Seek legal advice before " "using trademarks in applications." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2055 +#: ../fish/guestfish-actions.pod:2127 msgid "inspect-get-major-version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2057 +#: ../fish/guestfish-actions.pod:2129 #, no-wrap msgid "" " inspect-get-major-version root\n" @@ -9497,12 +9632,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2059 ../src/guestfs-actions.pod:3097 +#: ../fish/guestfish-actions.pod:2131 ../src/guestfs-actions.pod:3337 msgid "This returns the major version number of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2062 ../src/guestfs-actions.pod:3100 +#: ../fish/guestfish-actions.pod:2134 ../src/guestfs-actions.pod:3340 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 " @@ -9512,17 +9647,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2069 ../fish/guestfish-actions.pod:2080 ../src/guestfs-actions.pod:3107 ../src/guestfs-actions.pod:3124 +#: ../fish/guestfish-actions.pod:2141 ../fish/guestfish-actions.pod:2152 ../src/guestfs-actions.pod:3347 ../src/guestfs-actions.pod:3364 msgid "If the version could not be determined, then C<0> is returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2073 +#: ../fish/guestfish-actions.pod:2145 msgid "inspect-get-minor-version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2075 +#: ../fish/guestfish-actions.pod:2147 #, no-wrap msgid "" " inspect-get-minor-version root\n" @@ -9530,24 +9665,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2077 ../src/guestfs-actions.pod:3121 +#: ../fish/guestfish-actions.pod:2149 ../src/guestfs-actions.pod:3361 msgid "This returns the minor version number of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2082 +#: ../fish/guestfish-actions.pod:2154 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-major-version>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2085 +#: ../fish/guestfish-actions.pod:2157 msgid "inspect-get-mountpoints" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2087 +#: ../fish/guestfish-actions.pod:2159 #, no-wrap msgid "" " inspect-get-mountpoints root\n" @@ -9555,7 +9690,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2089 ../src/guestfs-actions.pod:3139 +#: ../fish/guestfish-actions.pod:2161 ../src/guestfs-actions.pod:3379 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 " @@ -9566,7 +9701,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2098 ../src/guestfs-actions.pod:3148 +#: ../fish/guestfish-actions.pod:2170 ../src/guestfs-actions.pod:3388 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 " @@ -9574,12 +9709,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2103 ../src/guestfs-actions.pod:3153 +#: ../fish/guestfish-actions.pod:2175 ../src/guestfs-actions.pod:3393 msgid "Non-mounted devices such as swap devices are I<not> returned in this list." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2106 +#: ../fish/guestfish-actions.pod:2178 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 " @@ -9588,19 +9723,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2112 +#: ../fish/guestfish-actions.pod:2184 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2115 +#: ../fish/guestfish-actions.pod:2187 msgid "inspect-get-package-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2117 +#: ../fish/guestfish-actions.pod:2189 #, no-wrap msgid "" " inspect-get-package-format root\n" @@ -9608,7 +9743,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2119 +#: ../fish/guestfish-actions.pod:2191 msgid "" "This function and L</inspect-get-package-management> return the package " "format and package management tool used by the inspected operating system. " @@ -9617,7 +9752,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2125 ../src/guestfs-actions.pod:3185 +#: ../fish/guestfish-actions.pod:2197 ../src/guestfs-actions.pod:3425 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 " @@ -9625,19 +9760,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2129 ../src/guestfs-actions.pod:3189 +#: ../fish/guestfish-actions.pod:2201 ../src/guestfs-actions.pod:3429 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:2135 +#: ../fish/guestfish-actions.pod:2207 msgid "inspect-get-package-management" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2137 +#: ../fish/guestfish-actions.pod:2209 #, no-wrap msgid "" " inspect-get-package-management root\n" @@ -9645,7 +9780,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2139 +#: ../fish/guestfish-actions.pod:2211 msgid "" "L</inspect-get-package-format> and this function return the package format " "and package management tool used by the inspected operating system. For " @@ -9654,7 +9789,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2145 ../src/guestfs-actions.pod:3212 +#: ../fish/guestfish-actions.pod:2217 ../src/guestfs-actions.pod:3452 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 " @@ -9662,7 +9797,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2149 ../src/guestfs-actions.pod:3216 +#: ../fish/guestfish-actions.pod:2221 ../src/guestfs-actions.pod:3456 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 " @@ -9670,12 +9805,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2156 +#: ../fish/guestfish-actions.pod:2228 msgid "inspect-get-product-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2158 +#: ../fish/guestfish-actions.pod:2230 #, no-wrap msgid "" " inspect-get-product-name root\n" @@ -9683,7 +9818,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2160 ../src/guestfs-actions.pod:3234 +#: ../fish/guestfish-actions.pod:2232 ../src/guestfs-actions.pod:3474 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 " @@ -9691,19 +9826,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2165 ../src/guestfs-actions.pod:3239 +#: ../fish/guestfish-actions.pod:2237 ../src/guestfs-actions.pod:3479 msgid "" "If the product name could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2170 +#: ../fish/guestfish-actions.pod:2242 msgid "inspect-get-product-variant" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2172 +#: ../fish/guestfish-actions.pod:2244 #, no-wrap msgid "" " inspect-get-product-variant root\n" @@ -9711,12 +9846,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2174 ../src/guestfs-actions.pod:3255 +#: ../fish/guestfish-actions.pod:2246 ../src/guestfs-actions.pod:3495 msgid "This returns the product variant of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2177 ../src/guestfs-actions.pod:3258 +#: ../fish/guestfish-actions.pod:2249 ../src/guestfs-actions.pod:3498 msgid "" "For Windows guests, this returns the contents of the Registry key " "C<HKLM\\Software\\Microsoft\\Windows NT\\CurrentVersion> C<InstallationType> " @@ -9728,7 +9863,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2186 ../src/guestfs-actions.pod:3267 +#: ../fish/guestfish-actions.pod:2258 ../src/guestfs-actions.pod:3507 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 " @@ -9736,26 +9871,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2190 ../src/guestfs-actions.pod:3271 +#: ../fish/guestfish-actions.pod:2262 ../src/guestfs-actions.pod:3511 msgid "" "If the product variant could not be determined, then the string C<unknown> " "is returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2193 +#: ../fish/guestfish-actions.pod:2265 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:2197 +#: ../fish/guestfish-actions.pod:2269 msgid "inspect-get-roots" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2199 +#: ../fish/guestfish-actions.pod:2271 #, no-wrap msgid "" " inspect-get-roots\n" @@ -9763,7 +9898,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2201 +#: ../fish/guestfish-actions.pod:2273 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 " @@ -9771,19 +9906,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2205 +#: ../fish/guestfish-actions.pod:2277 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:2210 +#: ../fish/guestfish-actions.pod:2282 msgid "inspect-get-type" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2212 +#: ../fish/guestfish-actions.pod:2284 #, no-wrap msgid "" " inspect-get-type root\n" @@ -9791,59 +9926,59 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2214 ../src/guestfs-actions.pod:3309 +#: ../fish/guestfish-actions.pod:2286 ../src/guestfs-actions.pod:3549 msgid "" "This returns the type of the inspected operating system. Currently defined " "types are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2219 ../src/guestfs-actions.pod:3314 +#: ../fish/guestfish-actions.pod:2291 ../src/guestfs-actions.pod:3554 msgid "\"linux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2221 ../src/guestfs-actions.pod:3316 +#: ../fish/guestfish-actions.pod:2293 ../src/guestfs-actions.pod:3556 msgid "Any Linux-based operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2225 ../src/guestfs-actions.pod:3320 +#: ../fish/guestfish-actions.pod:2297 ../src/guestfs-actions.pod:3560 msgid "Any Microsoft Windows operating system." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2227 ../src/guestfs-actions.pod:3322 +#: ../fish/guestfish-actions.pod:2299 ../src/guestfs-actions.pod:3562 msgid "\"freebsd\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2229 ../src/guestfs-actions.pod:3324 +#: ../fish/guestfish-actions.pod:2301 ../src/guestfs-actions.pod:3564 msgid "FreeBSD." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2231 ../src/guestfs-actions.pod:3326 +#: ../fish/guestfish-actions.pod:2303 ../src/guestfs-actions.pod:3566 msgid "\"netbsd\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2233 ../src/guestfs-actions.pod:3328 +#: ../fish/guestfish-actions.pod:2305 ../src/guestfs-actions.pod:3568 msgid "NetBSD." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2237 ../src/guestfs-actions.pod:3332 +#: ../fish/guestfish-actions.pod:2309 ../src/guestfs-actions.pod:3572 msgid "The operating system type could not be determined." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2246 +#: ../fish/guestfish-actions.pod:2318 msgid "inspect-get-windows-current-control-set" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2248 +#: ../fish/guestfish-actions.pod:2320 #, no-wrap msgid "" " inspect-get-windows-current-control-set root\n" @@ -9851,26 +9986,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2250 ../src/guestfs-actions.pod:3352 +#: ../fish/guestfish-actions.pod:2322 ../src/guestfs-actions.pod:3592 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:2253 ../src/guestfs-actions.pod:3355 +#: ../fish/guestfish-actions.pod:2325 ../src/guestfs-actions.pod:3595 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:2259 +#: ../fish/guestfish-actions.pod:2331 msgid "inspect-get-windows-systemroot" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2261 +#: ../fish/guestfish-actions.pod:2333 #, no-wrap msgid "" " inspect-get-windows-systemroot root\n" @@ -9878,14 +10013,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2263 ../src/guestfs-actions.pod:3372 +#: ../fish/guestfish-actions.pod:2335 ../src/guestfs-actions.pod:3612 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:2266 ../src/guestfs-actions.pod:3375 +#: ../fish/guestfish-actions.pod:2338 ../src/guestfs-actions.pod:3615 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 " @@ -9893,12 +10028,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2272 +#: ../fish/guestfish-actions.pod:2344 msgid "inspect-is-live" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2274 +#: ../fish/guestfish-actions.pod:2346 #, no-wrap msgid "" " inspect-is-live root\n" @@ -9906,19 +10041,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2276 +#: ../fish/guestfish-actions.pod:2348 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:2282 +#: ../fish/guestfish-actions.pod:2354 msgid "inspect-is-multipart" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2284 +#: ../fish/guestfish-actions.pod:2356 #, no-wrap msgid "" " inspect-is-multipart root\n" @@ -9926,19 +10061,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2286 +#: ../fish/guestfish-actions.pod:2358 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:2292 +#: ../fish/guestfish-actions.pod:2364 msgid "inspect-is-netinst" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2294 +#: ../fish/guestfish-actions.pod:2366 #, no-wrap msgid "" " inspect-is-netinst root\n" @@ -9946,7 +10081,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2296 +#: ../fish/guestfish-actions.pod:2368 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 " @@ -9955,12 +10090,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2304 +#: ../fish/guestfish-actions.pod:2376 msgid "inspect-list-applications" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2306 +#: ../fish/guestfish-actions.pod:2378 #, no-wrap msgid "" " inspect-list-applications root\n" @@ -9968,12 +10103,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2308 ../src/guestfs-actions.pod:3442 +#: ../fish/guestfish-actions.pod:2380 ../src/guestfs-actions.pod:3682 msgid "Return the list of applications installed in the operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2310 +#: ../fish/guestfish-actions.pod:2382 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>, " @@ -9985,91 +10120,91 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2320 ../src/guestfs-actions.pod:3454 +#: ../fish/guestfish-actions.pod:2392 ../src/guestfs-actions.pod:3694 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:2323 ../src/guestfs-actions.pod:3457 +#: ../fish/guestfish-actions.pod:2395 ../src/guestfs-actions.pod:3697 msgid "The application structure contains the following fields:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2327 ../src/guestfs-actions.pod:3461 +#: ../fish/guestfish-actions.pod:2399 ../src/guestfs-actions.pod:3701 msgid "C<app_name>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2329 ../src/guestfs-actions.pod:3463 +#: ../fish/guestfish-actions.pod:2401 ../src/guestfs-actions.pod:3703 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:2332 ../src/guestfs-actions.pod:3466 +#: ../fish/guestfish-actions.pod:2404 ../src/guestfs-actions.pod:3706 msgid "C<app_display_name>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2334 ../src/guestfs-actions.pod:3468 +#: ../fish/guestfish-actions.pod:2406 ../src/guestfs-actions.pod:3708 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:2337 ../src/guestfs-actions.pod:3471 +#: ../fish/guestfish-actions.pod:2409 ../src/guestfs-actions.pod:3711 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:2340 ../src/guestfs-actions.pod:3474 +#: ../fish/guestfish-actions.pod:2412 ../src/guestfs-actions.pod:3714 msgid "C<app_epoch>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2342 ../src/guestfs-actions.pod:3476 +#: ../fish/guestfish-actions.pod:2414 ../src/guestfs-actions.pod:3716 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:2345 ../src/guestfs-actions.pod:3479 +#: ../fish/guestfish-actions.pod:2417 ../src/guestfs-actions.pod:3719 msgid "C<app_version>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2347 ../src/guestfs-actions.pod:3481 +#: ../fish/guestfish-actions.pod:2419 ../src/guestfs-actions.pod:3721 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:2350 ../src/guestfs-actions.pod:3484 +#: ../fish/guestfish-actions.pod:2422 ../src/guestfs-actions.pod:3724 msgid "C<app_release>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2352 ../src/guestfs-actions.pod:3486 +#: ../fish/guestfish-actions.pod:2424 ../src/guestfs-actions.pod:3726 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:2356 ../src/guestfs-actions.pod:3490 +#: ../fish/guestfish-actions.pod:2428 ../src/guestfs-actions.pod:3730 msgid "C<app_install_path>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2358 ../src/guestfs-actions.pod:3492 +#: ../fish/guestfish-actions.pod:2430 ../src/guestfs-actions.pod:3732 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 " @@ -10077,89 +10212,89 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2363 ../src/guestfs-actions.pod:3497 +#: ../fish/guestfish-actions.pod:2435 ../src/guestfs-actions.pod:3737 msgid "If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2365 ../src/guestfs-actions.pod:3499 +#: ../fish/guestfish-actions.pod:2437 ../src/guestfs-actions.pod:3739 msgid "C<app_trans_path>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2367 ../src/guestfs-actions.pod:3501 +#: ../fish/guestfish-actions.pod:2439 ../src/guestfs-actions.pod:3741 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:2370 ../src/guestfs-actions.pod:3504 +#: ../fish/guestfish-actions.pod:2442 ../src/guestfs-actions.pod:3744 msgid "C<app_publisher>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2372 ../src/guestfs-actions.pod:3506 +#: ../fish/guestfish-actions.pod:2444 ../src/guestfs-actions.pod:3746 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:2376 ../src/guestfs-actions.pod:3510 +#: ../fish/guestfish-actions.pod:2448 ../src/guestfs-actions.pod:3750 msgid "C<app_url>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2378 ../src/guestfs-actions.pod:3512 +#: ../fish/guestfish-actions.pod:2450 ../src/guestfs-actions.pod:3752 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:2381 ../src/guestfs-actions.pod:3515 +#: ../fish/guestfish-actions.pod:2453 ../src/guestfs-actions.pod:3755 msgid "C<app_source_package>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2383 ../src/guestfs-actions.pod:3517 +#: ../fish/guestfish-actions.pod:2455 ../src/guestfs-actions.pod:3757 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:2386 ../src/guestfs-actions.pod:3520 +#: ../fish/guestfish-actions.pod:2458 ../src/guestfs-actions.pod:3760 msgid "C<app_summary>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2388 ../src/guestfs-actions.pod:3522 +#: ../fish/guestfish-actions.pod:2460 ../src/guestfs-actions.pod:3762 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:2391 ../src/guestfs-actions.pod:3525 +#: ../fish/guestfish-actions.pod:2463 ../src/guestfs-actions.pod:3765 msgid "C<app_description>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2393 ../src/guestfs-actions.pod:3527 +#: ../fish/guestfish-actions.pod:2465 ../src/guestfs-actions.pod:3767 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:2400 +#: ../fish/guestfish-actions.pod:2472 msgid "inspect-os" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2402 +#: ../fish/guestfish-actions.pod:2474 #, no-wrap msgid "" " inspect-os\n" @@ -10167,7 +10302,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2404 ../src/guestfs-actions.pod:3545 +#: ../fish/guestfish-actions.pod:2476 ../src/guestfs-actions.pod:3785 msgid "" "This function uses other libguestfs functions and certain heuristics to " "inspect the disk(s) (usually disks belonging to a virtual machine), looking " @@ -10175,12 +10310,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2408 ../src/guestfs-actions.pod:3549 +#: ../fish/guestfish-actions.pod:2480 ../src/guestfs-actions.pod:3789 msgid "The list returned is empty if no operating systems were found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2410 ../src/guestfs-actions.pod:3551 +#: ../fish/guestfish-actions.pod:2482 ../src/guestfs-actions.pod:3791 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. " @@ -10190,7 +10325,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2417 +#: ../fish/guestfish-actions.pod:2489 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, " @@ -10198,7 +10333,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2422 +#: ../fish/guestfish-actions.pod:2494 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 " @@ -10207,24 +10342,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2428 ../src/guestfs-actions.pod:3569 +#: ../fish/guestfish-actions.pod:2500 ../src/guestfs-actions.pod:3809 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:2434 ../fish/guestfish-actions.pod:2632 ../fish/guestfish-actions.pod:2691 +#: ../fish/guestfish-actions.pod:2506 ../fish/guestfish-actions.pod:2704 ../fish/guestfish-actions.pod:2763 msgid "See also L</list-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2436 +#: ../fish/guestfish-actions.pod:2508 msgid "is-blockdev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2438 +#: ../fish/guestfish-actions.pod:2510 #, no-wrap msgid "" " is-blockdev path\n" @@ -10232,24 +10367,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2440 ../src/guestfs-actions.pod:3589 +#: ../fish/guestfish-actions.pod:2512 ../src/guestfs-actions.pod:3829 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:2443 ../fish/guestfish-actions.pod:2461 ../fish/guestfish-actions.pod:2480 ../fish/guestfish-actions.pod:2489 ../fish/guestfish-actions.pod:2499 ../fish/guestfish-actions.pod:2533 ../fish/guestfish-actions.pod:2542 +#: ../fish/guestfish-actions.pod:2515 ../fish/guestfish-actions.pod:2533 ../fish/guestfish-actions.pod:2552 ../fish/guestfish-actions.pod:2561 ../fish/guestfish-actions.pod:2571 ../fish/guestfish-actions.pod:2605 ../fish/guestfish-actions.pod:2614 msgid "See also L</stat>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2445 +#: ../fish/guestfish-actions.pod:2517 msgid "is-busy" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2447 +#: ../fish/guestfish-actions.pod:2519 #, no-wrap msgid "" " is-busy\n" @@ -10257,19 +10392,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2449 ../src/guestfs-actions.pod:3603 +#: ../fish/guestfish-actions.pod:2521 ../src/guestfs-actions.pod:3843 msgid "" "This returns true iff this handle is busy processing a command (in the " "C<BUSY> state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2454 +#: ../fish/guestfish-actions.pod:2526 msgid "is-chardev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2456 +#: ../fish/guestfish-actions.pod:2528 #, no-wrap msgid "" " is-chardev path\n" @@ -10277,19 +10412,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2458 ../src/guestfs-actions.pod:3618 +#: ../fish/guestfish-actions.pod:2530 ../src/guestfs-actions.pod:3858 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:2463 +#: ../fish/guestfish-actions.pod:2535 msgid "is-config" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2465 +#: ../fish/guestfish-actions.pod:2537 #, no-wrap msgid "" " is-config\n" @@ -10297,19 +10432,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2467 ../src/guestfs-actions.pod:3632 +#: ../fish/guestfish-actions.pod:2539 ../src/guestfs-actions.pod:3872 msgid "" "This returns true iff this handle is being configured (in the C<CONFIG> " "state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2472 +#: ../fish/guestfish-actions.pod:2544 msgid "is-dir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2474 +#: ../fish/guestfish-actions.pod:2546 #, no-wrap msgid "" " is-dir path\n" @@ -10317,19 +10452,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2476 ../src/guestfs-actions.pod:3647 +#: ../fish/guestfish-actions.pod:2548 ../src/guestfs-actions.pod:3887 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:2482 +#: ../fish/guestfish-actions.pod:2554 msgid "is-fifo" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2484 +#: ../fish/guestfish-actions.pod:2556 #, no-wrap msgid "" " is-fifo path\n" @@ -10337,19 +10472,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2486 ../src/guestfs-actions.pod:3663 +#: ../fish/guestfish-actions.pod:2558 ../src/guestfs-actions.pod:3903 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:2491 +#: ../fish/guestfish-actions.pod:2563 msgid "is-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2493 +#: ../fish/guestfish-actions.pod:2565 #, no-wrap msgid "" " is-file path\n" @@ -10357,7 +10492,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2495 ../src/guestfs-actions.pod:3678 +#: ../fish/guestfish-actions.pod:2567 ../src/guestfs-actions.pod:3918 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 " @@ -10365,12 +10500,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2501 +#: ../fish/guestfish-actions.pod:2573 msgid "is-launching" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2503 +#: ../fish/guestfish-actions.pod:2575 #, no-wrap msgid "" " is-launching\n" @@ -10378,19 +10513,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2505 ../src/guestfs-actions.pod:3693 +#: ../fish/guestfish-actions.pod:2577 ../src/guestfs-actions.pod:3933 msgid "" "This returns true iff this handle is launching the subprocess (in the " "C<LAUNCHING> state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2510 +#: ../fish/guestfish-actions.pod:2582 msgid "is-lv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2512 +#: ../fish/guestfish-actions.pod:2584 #, no-wrap msgid "" " is-lv device\n" @@ -10398,19 +10533,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2514 ../src/guestfs-actions.pod:3708 +#: ../fish/guestfish-actions.pod:2586 ../src/guestfs-actions.pod:3948 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:2517 +#: ../fish/guestfish-actions.pod:2589 msgid "is-ready" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2519 +#: ../fish/guestfish-actions.pod:2591 #, no-wrap msgid "" " is-ready\n" @@ -10418,19 +10553,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2521 ../src/guestfs-actions.pod:3720 +#: ../fish/guestfish-actions.pod:2593 ../src/guestfs-actions.pod:3960 msgid "" "This returns true iff this handle is ready to accept commands (in the " "C<READY> state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2526 +#: ../fish/guestfish-actions.pod:2598 msgid "is-socket" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2528 +#: ../fish/guestfish-actions.pod:2600 #, no-wrap msgid "" " is-socket path\n" @@ -10438,19 +10573,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2530 ../src/guestfs-actions.pod:3735 +#: ../fish/guestfish-actions.pod:2602 ../src/guestfs-actions.pod:3975 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:2535 +#: ../fish/guestfish-actions.pod:2607 msgid "is-symlink" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2537 +#: ../fish/guestfish-actions.pod:2609 #, no-wrap msgid "" " is-symlink path\n" @@ -10458,19 +10593,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2539 ../src/guestfs-actions.pod:3750 +#: ../fish/guestfish-actions.pod:2611 ../src/guestfs-actions.pod:3990 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:2544 +#: ../fish/guestfish-actions.pod:2616 msgid "is-zero" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2546 +#: ../fish/guestfish-actions.pod:2618 #, no-wrap msgid "" " is-zero path\n" @@ -10478,19 +10613,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2548 ../src/guestfs-actions.pod:3765 +#: ../fish/guestfish-actions.pod:2620 ../src/guestfs-actions.pod:4005 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:2551 +#: ../fish/guestfish-actions.pod:2623 msgid "is-zero-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2553 +#: ../fish/guestfish-actions.pod:2625 #, no-wrap msgid "" " is-zero-device device\n" @@ -10498,22 +10633,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2555 ../src/guestfs-actions.pod:3778 +#: ../fish/guestfish-actions.pod:2627 ../src/guestfs-actions.pod:4018 msgid "This returns true iff the device exists and contains all zero bytes." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2557 ../src/guestfs-actions.pod:3780 +#: ../fish/guestfish-actions.pod:2629 ../src/guestfs-actions.pod:4020 msgid "Note that for large devices this can take a long time to run." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2559 +#: ../fish/guestfish-actions.pod:2631 msgid "kill-subprocess" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2561 +#: ../fish/guestfish-actions.pod:2633 #, no-wrap msgid "" " kill-subprocess\n" @@ -10521,22 +10656,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2563 ../src/guestfs-actions.pod:3791 +#: ../fish/guestfish-actions.pod:2635 ../src/guestfs-actions.pod:4031 msgid "This kills the qemu subprocess. You should never need to call this." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2565 +#: ../fish/guestfish-actions.pod:2637 msgid "launch" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2567 +#: ../fish/guestfish-actions.pod:2639 msgid "run" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2569 +#: ../fish/guestfish-actions.pod:2641 #, no-wrap msgid "" " launch\n" @@ -10544,26 +10679,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2571 ../src/guestfs-actions.pod:3802 +#: ../fish/guestfish-actions.pod:2643 ../src/guestfs-actions.pod:4042 msgid "" "Internally libguestfs is implemented by running a virtual machine using " "L<qemu(1)>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2574 ../src/guestfs-actions.pod:3805 +#: ../fish/guestfish-actions.pod:2646 ../src/guestfs-actions.pod:4045 msgid "" "You should call this after configuring the handle (eg. adding drives) but " "before performing any actions." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2577 +#: ../fish/guestfish-actions.pod:2649 msgid "lchown" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2579 +#: ../fish/guestfish-actions.pod:2651 #, no-wrap msgid "" " lchown owner group path\n" @@ -10571,7 +10706,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2581 +#: ../fish/guestfish-actions.pod:2653 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 " @@ -10579,12 +10714,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2589 +#: ../fish/guestfish-actions.pod:2661 msgid "lgetxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2591 +#: ../fish/guestfish-actions.pod:2663 #, no-wrap msgid "" " lgetxattr path name\n" @@ -10592,24 +10727,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2593 ../src/guestfs-actions.pod:3845 +#: ../fish/guestfish-actions.pod:2665 ../src/guestfs-actions.pod:4085 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:2607 +#: ../fish/guestfish-actions.pod:2679 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2609 +#: ../fish/guestfish-actions.pod:2681 msgid "lgetxattrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2611 +#: ../fish/guestfish-actions.pod:2683 #, no-wrap msgid "" " lgetxattrs path\n" @@ -10617,19 +10752,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2613 +#: ../fish/guestfish-actions.pod:2685 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:2617 +#: ../fish/guestfish-actions.pod:2689 msgid "list-9p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2619 +#: ../fish/guestfish-actions.pod:2691 #, no-wrap msgid "" " list-9p\n" @@ -10637,19 +10772,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2621 ../src/guestfs-actions.pod:3888 +#: ../fish/guestfish-actions.pod:2693 ../src/guestfs-actions.pod:4128 msgid "" "List all 9p filesystems attached to the guest. A list of mount tags is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2624 +#: ../fish/guestfish-actions.pod:2696 msgid "list-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2626 +#: ../fish/guestfish-actions.pod:2698 #, no-wrap msgid "" " list-devices\n" @@ -10657,22 +10792,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2628 ../src/guestfs-actions.pod:3902 +#: ../fish/guestfish-actions.pod:2700 ../src/guestfs-actions.pod:4142 msgid "List all the block devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2630 ../src/guestfs-actions.pod:3904 +#: ../fish/guestfish-actions.pod:2702 ../src/guestfs-actions.pod:4144 msgid "The full block device names are returned, eg. C</dev/sda>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2634 +#: ../fish/guestfish-actions.pod:2706 msgid "list-dm-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2636 +#: ../fish/guestfish-actions.pod:2708 #, no-wrap msgid "" " list-dm-devices\n" @@ -10680,31 +10815,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2638 ../src/guestfs-actions.pod:3919 +#: ../fish/guestfish-actions.pod:2710 ../src/guestfs-actions.pod:4159 msgid "List all device mapper devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2640 +#: ../fish/guestfish-actions.pod:2712 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:2643 +#: ../fish/guestfish-actions.pod:2715 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:2647 +#: ../fish/guestfish-actions.pod:2719 msgid "list-filesystems" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2649 +#: ../fish/guestfish-actions.pod:2721 #, no-wrap msgid "" " list-filesystems\n" @@ -10712,7 +10847,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2651 ../src/guestfs-actions.pod:3939 +#: ../fish/guestfish-actions.pod:2723 ../src/guestfs-actions.pod:4179 msgid "" "This inspection command looks for filesystems on partitions, block devices " "and logical volumes, returning a list of devices containing filesystems and " @@ -10720,14 +10855,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2655 ../src/guestfs-actions.pod:3943 +#: ../fish/guestfish-actions.pod:2727 ../src/guestfs-actions.pod:4183 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:2659 ../src/guestfs-actions.pod:3947 +#: ../fish/guestfish-actions.pod:2731 ../src/guestfs-actions.pod:4187 #, no-wrap msgid "" " \"/dev/sda1\" => \"ntfs\"\n" @@ -10738,14 +10873,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2664 ../src/guestfs-actions.pod:3952 +#: ../fish/guestfish-actions.pod:2736 ../src/guestfs-actions.pod:4192 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:2668 +#: ../fish/guestfish-actions.pod:2740 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 " @@ -10753,7 +10888,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2672 +#: ../fish/guestfish-actions.pod:2744 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 " @@ -10763,12 +10898,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2680 +#: ../fish/guestfish-actions.pod:2752 msgid "list-partitions" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2682 +#: ../fish/guestfish-actions.pod:2754 #, no-wrap msgid "" " list-partitions\n" @@ -10776,29 +10911,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2684 ../src/guestfs-actions.pod:3981 +#: ../fish/guestfish-actions.pod:2756 ../src/guestfs-actions.pod:4221 msgid "List all the partitions detected on all block devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2686 ../src/guestfs-actions.pod:3983 +#: ../fish/guestfish-actions.pod:2758 ../src/guestfs-actions.pod:4223 msgid "The full partition device names are returned, eg. C</dev/sda1>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2688 +#: ../fish/guestfish-actions.pod:2760 msgid "" "This does not return logical volumes. For that you will need to call " "L</lvs>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2693 +#: ../fish/guestfish-actions.pod:2765 msgid "ll" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2695 +#: ../fish/guestfish-actions.pod:2767 #, no-wrap msgid "" " ll directory\n" @@ -10806,26 +10941,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2697 ../src/guestfs-actions.pod:4002 +#: ../fish/guestfish-actions.pod:2769 ../src/guestfs-actions.pod:4242 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:2700 ../src/guestfs-actions.pod:4005 +#: ../fish/guestfish-actions.pod:2772 ../src/guestfs-actions.pod:4245 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:2703 +#: ../fish/guestfish-actions.pod:2775 msgid "ln" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2705 +#: ../fish/guestfish-actions.pod:2777 #, no-wrap msgid "" " ln target linkname\n" @@ -10833,17 +10968,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2707 ../src/guestfs-actions.pod:4020 +#: ../fish/guestfish-actions.pod:2779 ../src/guestfs-actions.pod:4260 msgid "This command creates a hard link using the C<ln> command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2709 +#: ../fish/guestfish-actions.pod:2781 msgid "ln-f" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2711 +#: ../fish/guestfish-actions.pod:2783 #, no-wrap msgid "" " ln-f target linkname\n" @@ -10851,19 +10986,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2713 ../src/guestfs-actions.pod:4033 +#: ../fish/guestfish-actions.pod:2785 ../src/guestfs-actions.pod:4273 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:2716 +#: ../fish/guestfish-actions.pod:2788 msgid "ln-s" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2718 +#: ../fish/guestfish-actions.pod:2790 #, no-wrap msgid "" " ln-s target linkname\n" @@ -10871,17 +11006,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2720 ../src/guestfs-actions.pod:4047 +#: ../fish/guestfish-actions.pod:2792 ../src/guestfs-actions.pod:4287 msgid "This command creates a symbolic link using the C<ln -s> command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2722 +#: ../fish/guestfish-actions.pod:2794 msgid "ln-sf" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2724 +#: ../fish/guestfish-actions.pod:2796 #, no-wrap msgid "" " ln-sf target linkname\n" @@ -10889,19 +11024,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2726 ../src/guestfs-actions.pod:4060 +#: ../fish/guestfish-actions.pod:2798 ../src/guestfs-actions.pod:4300 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:2729 +#: ../fish/guestfish-actions.pod:2801 msgid "lremovexattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2731 +#: ../fish/guestfish-actions.pod:2803 #, no-wrap msgid "" " lremovexattr xattr path\n" @@ -10909,19 +11044,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2733 +#: ../fish/guestfish-actions.pod:2805 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:2737 +#: ../fish/guestfish-actions.pod:2809 msgid "ls" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2739 +#: ../fish/guestfish-actions.pod:2811 #, no-wrap msgid "" " ls directory\n" @@ -10929,7 +11064,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2741 ../src/guestfs-actions.pod:4088 +#: ../fish/guestfish-actions.pod:2813 ../src/guestfs-actions.pod:4328 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 " @@ -10937,19 +11072,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2745 +#: ../fish/guestfish-actions.pod:2817 msgid "" "This command is mostly useful for interactive sessions. Programs should " "probably use L</readdir> instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2748 +#: ../fish/guestfish-actions.pod:2820 msgid "lsetxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2750 +#: ../fish/guestfish-actions.pod:2822 #, no-wrap msgid "" " lsetxattr xattr val vallen path\n" @@ -10957,19 +11092,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2752 +#: ../fish/guestfish-actions.pod:2824 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:2756 +#: ../fish/guestfish-actions.pod:2828 msgid "lstat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2758 +#: ../fish/guestfish-actions.pod:2830 #, no-wrap msgid "" " lstat path\n" @@ -10977,29 +11112,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2760 ../fish/guestfish-actions.pod:4570 ../src/guestfs-actions.pod:4124 ../src/guestfs-actions.pod:6909 +#: ../fish/guestfish-actions.pod:2832 ../fish/guestfish-actions.pod:4656 ../src/guestfs-actions.pod:4364 ../src/guestfs-actions.pod:7167 msgid "Returns file information for the given C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2762 +#: ../fish/guestfish-actions.pod:2834 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:2766 ../src/guestfs-actions.pod:4130 +#: ../fish/guestfish-actions.pod:2838 ../src/guestfs-actions.pod:4370 msgid "This is the same as the C<lstat(2)> system call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2768 +#: ../fish/guestfish-actions.pod:2840 msgid "lstatlist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2770 +#: ../fish/guestfish-actions.pod:2842 #, no-wrap msgid "" " lstatlist path 'names ...'\n" @@ -11007,7 +11142,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2772 +#: ../fish/guestfish-actions.pod:2844 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 " @@ -11015,7 +11150,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2776 ../src/guestfs-actions.pod:4149 +#: ../fish/guestfish-actions.pod:2848 ../src/guestfs-actions.pod:4389 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, " @@ -11023,7 +11158,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2781 +#: ../fish/guestfish-actions.pod:2853 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 " @@ -11034,12 +11169,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2789 +#: ../fish/guestfish-actions.pod:2861 msgid "luks-add-key" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2791 +#: ../fish/guestfish-actions.pod:2863 #, no-wrap msgid "" " luks-add-key device keyslot\n" @@ -11047,7 +11182,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2793 ../src/guestfs-actions.pod:4177 +#: ../fish/guestfish-actions.pod:2865 ../src/guestfs-actions.pod:4417 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 " @@ -11055,26 +11190,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2798 +#: ../fish/guestfish-actions.pod:2870 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:2802 ../fish/guestfish-actions.pod:2824 ../fish/guestfish-actions.pod:2837 ../fish/guestfish-actions.pod:2851 ../fish/guestfish-actions.pod:2877 ../fish/guestfish-actions.pod:2887 +#: ../fish/guestfish-actions.pod:2874 ../fish/guestfish-actions.pod:2896 ../fish/guestfish-actions.pod:2909 ../fish/guestfish-actions.pod:2923 ../fish/guestfish-actions.pod:2949 ../fish/guestfish-actions.pod:2959 msgid "" "This command has one or more key or passphrase parameters. Guestfish will " "prompt for these separately." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2805 +#: ../fish/guestfish-actions.pod:2877 msgid "luks-close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2807 +#: ../fish/guestfish-actions.pod:2879 #, no-wrap msgid "" " luks-close device\n" @@ -11082,7 +11217,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2809 +#: ../fish/guestfish-actions.pod:2881 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 " @@ -11091,12 +11226,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2815 +#: ../fish/guestfish-actions.pod:2887 msgid "luks-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2817 +#: ../fish/guestfish-actions.pod:2889 #, no-wrap msgid "" " luks-format device keyslot\n" @@ -11104,7 +11239,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2819 ../src/guestfs-actions.pod:4218 +#: ../fish/guestfish-actions.pod:2891 ../src/guestfs-actions.pod:4458 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 " @@ -11112,19 +11247,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2827 ../fish/guestfish-actions.pod:2840 ../fish/guestfish-actions.pod:2927 ../fish/guestfish-actions.pod:3578 ../fish/guestfish-actions.pod:4104 ../fish/guestfish-actions.pod:4441 ../fish/guestfish-actions.pod:4464 ../fish/guestfish-actions.pod:4486 ../fish/guestfish-actions.pod:5232 ../src/guestfs-actions.pod:4225 ../src/guestfs-actions.pod:4248 ../src/guestfs-actions.pod:4391 ../src/guestfs-actions.pod:5484 ../src/guestfs-actions.pod:6272 ../src/guestfs-actions.pod:6723 ../src/guestfs-actions.pod:6753 ../src/guestfs-actions.pod:6786 ../src/guestfs-actions.pod:7985 +#: ../fish/guestfish-actions.pod:2899 ../fish/guestfish-actions.pod:2912 ../fish/guestfish-actions.pod:2999 ../fish/guestfish-actions.pod:3650 ../fish/guestfish-actions.pod:4190 ../fish/guestfish-actions.pod:4527 ../fish/guestfish-actions.pod:4550 ../fish/guestfish-actions.pod:4572 ../fish/guestfish-actions.pod:5318 ../src/guestfs-actions.pod:4465 ../src/guestfs-actions.pod:4488 ../src/guestfs-actions.pod:4631 ../src/guestfs-actions.pod:5724 ../src/guestfs-actions.pod:6530 ../src/guestfs-actions.pod:6981 ../src/guestfs-actions.pod:7011 ../src/guestfs-actions.pod:7044 ../src/guestfs-actions.pod:8243 msgid "" "B<This command is dangerous. Without careful use you can easily destroy all " "your data>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2830 +#: ../fish/guestfish-actions.pod:2902 msgid "luks-format-cipher" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2832 +#: ../fish/guestfish-actions.pod:2904 #, no-wrap msgid "" " luks-format-cipher device keyslot cipher\n" @@ -11132,19 +11267,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2834 +#: ../fish/guestfish-actions.pod:2906 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:2843 +#: ../fish/guestfish-actions.pod:2915 msgid "luks-kill-slot" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2845 +#: ../fish/guestfish-actions.pod:2917 #, no-wrap msgid "" " luks-kill-slot device keyslot\n" @@ -11152,19 +11287,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2847 ../src/guestfs-actions.pod:4265 +#: ../fish/guestfish-actions.pod:2919 ../src/guestfs-actions.pod:4505 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:2854 +#: ../fish/guestfish-actions.pod:2926 msgid "luks-open" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2856 +#: ../fish/guestfish-actions.pod:2928 #, no-wrap msgid "" " luks-open device mapname\n" @@ -11172,26 +11307,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2858 ../src/guestfs-actions.pod:4285 +#: ../fish/guestfish-actions.pod:2930 ../src/guestfs-actions.pod:4525 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:2861 ../src/guestfs-actions.pod:4288 +#: ../fish/guestfish-actions.pod:2933 ../src/guestfs-actions.pod:4528 msgid "C<device> is the encrypted block device or partition." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2863 ../src/guestfs-actions.pod:4290 +#: ../fish/guestfish-actions.pod:2935 ../src/guestfs-actions.pod:4530 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:2866 ../src/guestfs-actions.pod:4293 +#: ../fish/guestfish-actions.pod:2938 ../src/guestfs-actions.pod:4533 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 " @@ -11199,24 +11334,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2870 +#: ../fish/guestfish-actions.pod:2942 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:2874 +#: ../fish/guestfish-actions.pod:2946 msgid "Use L</list-dm-devices> to list all device mapper devices." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2880 +#: ../fish/guestfish-actions.pod:2952 msgid "luks-open-ro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2882 +#: ../fish/guestfish-actions.pod:2954 #, no-wrap msgid "" " luks-open-ro device mapname\n" @@ -11224,19 +11359,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2884 +#: ../fish/guestfish-actions.pod:2956 msgid "" "This is the same as L</luks-open> except that a read-only mapping is " "created." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2890 +#: ../fish/guestfish-actions.pod:2962 msgid "lvcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2892 +#: ../fish/guestfish-actions.pod:2964 #, no-wrap msgid "" " lvcreate logvol volgroup mbytes\n" @@ -11244,19 +11379,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2894 ../src/guestfs-actions.pod:4339 +#: ../fish/guestfish-actions.pod:2966 ../src/guestfs-actions.pod:4579 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:2897 +#: ../fish/guestfish-actions.pod:2969 msgid "lvm-canonical-lv-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2899 +#: ../fish/guestfish-actions.pod:2971 #, no-wrap msgid "" " lvm-canonical-lv-name lvname\n" @@ -11264,7 +11399,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2901 ../src/guestfs-actions.pod:4352 +#: ../fish/guestfish-actions.pod:2973 ../src/guestfs-actions.pod:4592 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 " @@ -11272,24 +11407,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2905 ../src/guestfs-actions.pod:4356 +#: ../fish/guestfish-actions.pod:2977 ../src/guestfs-actions.pod:4596 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:2908 +#: ../fish/guestfish-actions.pod:2980 msgid "See also L</is-lv>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2910 +#: ../fish/guestfish-actions.pod:2982 msgid "lvm-clear-filter" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2912 +#: ../fish/guestfish-actions.pod:2984 #, no-wrap msgid "" " lvm-clear-filter\n" @@ -11297,24 +11432,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2914 +#: ../fish/guestfish-actions.pod:2986 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:2917 ../fish/guestfish-actions.pod:2948 ../src/guestfs-actions.pod:4374 ../src/guestfs-actions.pod:4416 +#: ../fish/guestfish-actions.pod:2989 ../fish/guestfish-actions.pod:3020 ../src/guestfs-actions.pod:4614 ../src/guestfs-actions.pod:4656 msgid "This command also clears the LVM cache and performs a volume group scan." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2920 +#: ../fish/guestfish-actions.pod:2992 msgid "lvm-remove-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2922 +#: ../fish/guestfish-actions.pod:2994 #, no-wrap msgid "" " lvm-remove-all\n" @@ -11322,19 +11457,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2924 ../src/guestfs-actions.pod:4386 +#: ../fish/guestfish-actions.pod:2996 ../src/guestfs-actions.pod:4626 msgid "" "This command removes all LVM logical volumes, volume groups and physical " "volumes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2930 +#: ../fish/guestfish-actions.pod:3002 msgid "lvm-set-filter" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2932 +#: ../fish/guestfish-actions.pod:3004 #, no-wrap msgid "" " lvm-set-filter 'devices ...'\n" @@ -11342,7 +11477,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2934 ../src/guestfs-actions.pod:4402 +#: ../fish/guestfish-actions.pod:3006 ../src/guestfs-actions.pod:4642 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 " @@ -11350,7 +11485,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2938 ../src/guestfs-actions.pod:4406 +#: ../fish/guestfish-actions.pod:3010 ../src/guestfs-actions.pod:4646 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 " @@ -11362,24 +11497,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2951 ../src/guestfs-actions.pod:4419 +#: ../fish/guestfish-actions.pod:3023 ../src/guestfs-actions.pod:4659 msgid "You can filter whole block devices or individual partitions." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2953 ../src/guestfs-actions.pod:4421 +#: ../fish/guestfish-actions.pod:3025 ../src/guestfs-actions.pod:4661 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:2957 +#: ../fish/guestfish-actions.pod:3029 msgid "lvremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2959 +#: ../fish/guestfish-actions.pod:3031 #, no-wrap msgid "" " lvremove device\n" @@ -11387,26 +11522,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2961 ../src/guestfs-actions.pod:4435 +#: ../fish/guestfish-actions.pod:3033 ../src/guestfs-actions.pod:4675 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:2964 ../src/guestfs-actions.pod:4438 +#: ../fish/guestfish-actions.pod:3036 ../src/guestfs-actions.pod:4678 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:2967 +#: ../fish/guestfish-actions.pod:3039 msgid "lvrename" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2969 +#: ../fish/guestfish-actions.pod:3041 #, no-wrap msgid "" " lvrename logvol newlogvol\n" @@ -11414,17 +11549,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2971 ../src/guestfs-actions.pod:4452 +#: ../fish/guestfish-actions.pod:3043 ../src/guestfs-actions.pod:4692 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2973 +#: ../fish/guestfish-actions.pod:3045 msgid "lvresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2975 +#: ../fish/guestfish-actions.pod:3047 #, no-wrap msgid "" " lvresize device mbytes\n" @@ -11432,19 +11567,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2977 ../src/guestfs-actions.pod:4465 +#: ../fish/guestfish-actions.pod:3049 ../src/guestfs-actions.pod:4705 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:2981 +#: ../fish/guestfish-actions.pod:3053 msgid "lvresize-free" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2983 +#: ../fish/guestfish-actions.pod:3055 #, no-wrap msgid "" " lvresize-free lv percent\n" @@ -11452,7 +11587,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2985 ../src/guestfs-actions.pod:4480 +#: ../fish/guestfish-actions.pod:3057 ../src/guestfs-actions.pod:4720 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 " @@ -11461,12 +11596,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2991 +#: ../fish/guestfish-actions.pod:3063 msgid "lvs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2993 +#: ../fish/guestfish-actions.pod:3065 #, no-wrap msgid "" " lvs\n" @@ -11474,31 +11609,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2995 ../src/guestfs-actions.pod:4495 +#: ../fish/guestfish-actions.pod:3067 ../src/guestfs-actions.pod:4735 msgid "" "List all the logical volumes detected. This is the equivalent of the " "L<lvs(8)> command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2998 ../src/guestfs-actions.pod:4498 +#: ../fish/guestfish-actions.pod:3070 ../src/guestfs-actions.pod:4738 msgid "" "This returns a list of the logical volume device names " "(eg. C</dev/VolGroup00/LogVol00>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3001 +#: ../fish/guestfish-actions.pod:3073 msgid "See also L</lvs-full>, L</list-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3003 +#: ../fish/guestfish-actions.pod:3075 msgid "lvs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3005 +#: ../fish/guestfish-actions.pod:3077 #, no-wrap msgid "" " lvs-full\n" @@ -11506,19 +11641,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3007 ../src/guestfs-actions.pod:4514 +#: ../fish/guestfish-actions.pod:3079 ../src/guestfs-actions.pod:4754 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:3010 +#: ../fish/guestfish-actions.pod:3082 msgid "lvuuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3012 +#: ../fish/guestfish-actions.pod:3084 #, no-wrap msgid "" " lvuuid device\n" @@ -11526,17 +11661,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3014 ../src/guestfs-actions.pod:4529 +#: ../fish/guestfish-actions.pod:3086 ../src/guestfs-actions.pod:4769 msgid "This command returns the UUID of the LVM LV C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3016 +#: ../fish/guestfish-actions.pod:3088 msgid "lxattrlist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3018 +#: ../fish/guestfish-actions.pod:3090 #, no-wrap msgid "" " lxattrlist path 'names ...'\n" @@ -11544,7 +11679,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3020 ../src/guestfs-actions.pod:4543 +#: ../fish/guestfish-actions.pod:3092 ../src/guestfs-actions.pod:4783 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 " @@ -11552,7 +11687,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3024 ../src/guestfs-actions.pod:4547 +#: ../fish/guestfish-actions.pod:3096 ../src/guestfs-actions.pod:4787 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>. " @@ -11565,7 +11700,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3034 +#: ../fish/guestfish-actions.pod:3106 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 " @@ -11576,12 +11711,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3042 +#: ../fish/guestfish-actions.pod:3114 msgid "mkdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3044 +#: ../fish/guestfish-actions.pod:3116 #, no-wrap msgid "" " mkdir path\n" @@ -11589,17 +11724,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3046 ../src/guestfs-actions.pod:4577 +#: ../fish/guestfish-actions.pod:3118 ../src/guestfs-actions.pod:4817 msgid "Create a directory named C<path>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3048 +#: ../fish/guestfish-actions.pod:3120 msgid "mkdir-mode" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3050 +#: ../fish/guestfish-actions.pod:3122 #, no-wrap msgid "" " mkdir-mode path mode\n" @@ -11607,14 +11742,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3052 ../src/guestfs-actions.pod:4590 +#: ../fish/guestfish-actions.pod:3124 ../src/guestfs-actions.pod:4830 msgid "" "This command creates a directory, setting the initial permissions of the " "directory to C<mode>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3055 ../src/guestfs-actions.pod:4593 +#: ../fish/guestfish-actions.pod:3127 ../src/guestfs-actions.pod:4833 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 " @@ -11622,17 +11757,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3059 +#: ../fish/guestfish-actions.pod:3131 msgid "See also L</mkdir>, L</umask>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3061 +#: ../fish/guestfish-actions.pod:3133 msgid "mkdir-p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3063 +#: ../fish/guestfish-actions.pod:3135 #, no-wrap msgid "" " mkdir-p path\n" @@ -11640,19 +11775,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3065 ../src/guestfs-actions.pod:4609 +#: ../fish/guestfish-actions.pod:3137 ../src/guestfs-actions.pod:4849 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:3068 +#: ../fish/guestfish-actions.pod:3140 msgid "mkdtemp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3070 +#: ../fish/guestfish-actions.pod:3142 #, no-wrap msgid "" " mkdtemp template\n" @@ -11660,7 +11795,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3072 ../src/guestfs-actions.pod:4622 +#: ../fish/guestfish-actions.pod:3144 ../src/guestfs-actions.pod:4862 msgid "" "This command creates a temporary directory. The C<template> parameter " "should be a full pathname for the temporary directory name with the final " @@ -11668,41 +11803,41 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3077 ../src/guestfs-actions.pod:4627 +#: ../fish/guestfish-actions.pod:3149 ../src/guestfs-actions.pod:4867 msgid "" "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one " "being suitable for Windows filesystems." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3080 ../src/guestfs-actions.pod:4630 +#: ../fish/guestfish-actions.pod:3152 ../src/guestfs-actions.pod:4870 msgid "The name of the temporary directory that was created is returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3083 ../src/guestfs-actions.pod:4633 +#: ../fish/guestfish-actions.pod:3155 ../src/guestfs-actions.pod:4873 msgid "The temporary directory is created with mode 0700 and is owned by root." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3086 ../src/guestfs-actions.pod:4636 +#: ../fish/guestfish-actions.pod:3158 ../src/guestfs-actions.pod:4876 msgid "" "The caller is responsible for deleting the temporary directory and its " "contents after use." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3089 ../src/guestfs-actions.pod:4639 +#: ../fish/guestfish-actions.pod:3161 ../src/guestfs-actions.pod:4879 msgid "See also: L<mkdtemp(3)>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3091 +#: ../fish/guestfish-actions.pod:3163 msgid "mke2fs-J" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3093 +#: ../fish/guestfish-actions.pod:3165 #, no-wrap msgid "" " mke2fs-J fstype blocksize device journal\n" @@ -11710,14 +11845,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3095 ../src/guestfs-actions.pod:4655 +#: ../fish/guestfish-actions.pod:3167 ../src/guestfs-actions.pod:4895 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:3099 ../src/guestfs-actions.pod:4659 +#: ../fish/guestfish-actions.pod:3171 ../src/guestfs-actions.pod:4899 #, no-wrap msgid "" " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n" @@ -11725,17 +11860,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3101 +#: ../fish/guestfish-actions.pod:3173 msgid "See also L</mke2journal>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3103 +#: ../fish/guestfish-actions.pod:3175 msgid "mke2fs-JL" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3105 +#: ../fish/guestfish-actions.pod:3177 #, no-wrap msgid "" " mke2fs-JL fstype blocksize device label\n" @@ -11743,24 +11878,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3107 ../src/guestfs-actions.pod:4676 +#: ../fish/guestfish-actions.pod:3179 ../src/guestfs-actions.pod:4916 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:3110 +#: ../fish/guestfish-actions.pod:3182 msgid "See also L</mke2journal-L>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3112 +#: ../fish/guestfish-actions.pod:3184 msgid "mke2fs-JU" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3114 +#: ../fish/guestfish-actions.pod:3186 #, no-wrap msgid "" " mke2fs-JU fstype blocksize device uuid\n" @@ -11768,24 +11903,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3116 ../src/guestfs-actions.pod:4694 +#: ../fish/guestfish-actions.pod:3188 ../src/guestfs-actions.pod:4934 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:3119 +#: ../fish/guestfish-actions.pod:3191 msgid "See also L</mke2journal-U>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3121 +#: ../fish/guestfish-actions.pod:3193 msgid "mke2journal" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3123 +#: ../fish/guestfish-actions.pod:3195 #, no-wrap msgid "" " mke2journal blocksize device\n" @@ -11793,14 +11928,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3125 ../src/guestfs-actions.pod:4710 +#: ../fish/guestfish-actions.pod:3197 ../src/guestfs-actions.pod:4950 msgid "" "This creates an ext2 external journal on C<device>. It is equivalent to the " "command:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3128 ../src/guestfs-actions.pod:4713 +#: ../fish/guestfish-actions.pod:3200 ../src/guestfs-actions.pod:4953 #, no-wrap msgid "" " mke2fs -O journal_dev -b blocksize device\n" @@ -11808,12 +11943,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3130 +#: ../fish/guestfish-actions.pod:3202 msgid "mke2journal-L" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3132 +#: ../fish/guestfish-actions.pod:3204 #, no-wrap msgid "" " mke2journal-L blocksize label device\n" @@ -11821,17 +11956,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3134 ../src/guestfs-actions.pod:4727 +#: ../fish/guestfish-actions.pod:3206 ../src/guestfs-actions.pod:4967 msgid "This creates an ext2 external journal on C<device> with label C<label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3136 +#: ../fish/guestfish-actions.pod:3208 msgid "mke2journal-U" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3138 +#: ../fish/guestfish-actions.pod:3210 #, no-wrap msgid "" " mke2journal-U blocksize uuid device\n" @@ -11839,17 +11974,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3140 ../src/guestfs-actions.pod:4741 +#: ../fish/guestfish-actions.pod:3212 ../src/guestfs-actions.pod:4981 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3142 +#: ../fish/guestfish-actions.pod:3214 msgid "mkfifo" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3144 +#: ../fish/guestfish-actions.pod:3216 #, no-wrap msgid "" " mkfifo mode path\n" @@ -11857,19 +11992,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3146 +#: ../fish/guestfish-actions.pod:3218 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:3152 +#: ../fish/guestfish-actions.pod:3224 msgid "mkfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3154 +#: ../fish/guestfish-actions.pod:3226 #, no-wrap msgid "" " mkfs fstype device\n" @@ -11877,19 +12012,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3156 ../src/guestfs-actions.pod:4771 +#: ../fish/guestfish-actions.pod:3228 ../src/guestfs-actions.pod:5011 msgid "" "This creates a filesystem on C<device> (usually a partition or LVM logical " "volume). The filesystem type is C<fstype>, for example C<ext3>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3160 +#: ../fish/guestfish-actions.pod:3232 msgid "mkfs-b" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3162 +#: ../fish/guestfish-actions.pod:3234 #, no-wrap msgid "" " mkfs-b fstype blocksize device\n" @@ -11897,7 +12032,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3164 +#: ../fish/guestfish-actions.pod:3236 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 " @@ -11905,26 +12040,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3169 ../fish/guestfish-actions.pod:3196 ../src/guestfs-actions.pod:4799 ../src/guestfs-actions.pod:4837 +#: ../fish/guestfish-actions.pod:3241 ../fish/guestfish-actions.pod:3268 ../src/guestfs-actions.pod:5039 ../src/guestfs-actions.pod:5077 msgid "" "For VFAT and NTFS the C<blocksize> parameter is treated as the requested " "cluster size." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3172 +#: ../fish/guestfish-actions.pod:3244 msgid "" "I<This function is deprecated.> In new code, use the L</mkfs_opts> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3179 +#: ../fish/guestfish-actions.pod:3251 msgid "mkfs-opts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3181 +#: ../fish/guestfish-actions.pod:3253 #, no-wrap msgid "" " mkfs-opts fstype device [blocksize:..] [features:..] [inode:..] " @@ -11933,19 +12068,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3183 ../src/guestfs-actions.pod:4824 +#: ../fish/guestfish-actions.pod:3255 ../src/guestfs-actions.pod:5064 msgid "" "This function creates a filesystem on C<device>. The filesystem type is " "C<fstype>, for example C<ext3>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3190 ../src/guestfs-actions.pod:4831 +#: ../fish/guestfish-actions.pod:3262 ../src/guestfs-actions.pod:5071 msgid "C<blocksize>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3192 ../src/guestfs-actions.pod:4833 +#: ../fish/guestfish-actions.pod:3264 ../src/guestfs-actions.pod:5073 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 " @@ -11953,65 +12088,65 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3199 ../src/guestfs-actions.pod:4840 +#: ../fish/guestfish-actions.pod:3271 ../src/guestfs-actions.pod:5080 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3201 ../src/guestfs-actions.pod:4842 +#: ../fish/guestfish-actions.pod:3273 ../src/guestfs-actions.pod:5082 msgid "C<features>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3203 ../src/guestfs-actions.pod:4844 +#: ../fish/guestfish-actions.pod:3275 ../src/guestfs-actions.pod:5084 msgid "This passes the I<-O> parameter to the external mkfs program." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3205 ../src/guestfs-actions.pod:4846 +#: ../fish/guestfish-actions.pod:3277 ../src/guestfs-actions.pod:5086 msgid "" "For certain filesystem types, this allows extra filesystem features to be " "selected. See L<mke2fs(8)> and L<mkfs.ufs(8)> for more details." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3209 ../src/guestfs-actions.pod:4850 +#: ../fish/guestfish-actions.pod:3281 ../src/guestfs-actions.pod:5090 msgid "" "You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem " "type." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3212 ../src/guestfs-actions.pod:4853 +#: ../fish/guestfish-actions.pod:3284 ../src/guestfs-actions.pod:5093 msgid "C<inode>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3214 ../src/guestfs-actions.pod:4855 +#: ../fish/guestfish-actions.pod:3286 ../src/guestfs-actions.pod:5095 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:3217 ../src/guestfs-actions.pod:4858 +#: ../fish/guestfish-actions.pod:3289 ../src/guestfs-actions.pod:5098 msgid "C<sectorsize>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3219 ../src/guestfs-actions.pod:4860 +#: ../fish/guestfish-actions.pod:3291 ../src/guestfs-actions.pod:5100 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:3226 +#: ../fish/guestfish-actions.pod:3298 msgid "mkmountpoint" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3228 +#: ../fish/guestfish-actions.pod:3300 #, no-wrap msgid "" " mkmountpoint exemptpath\n" @@ -12019,14 +12154,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3230 +#: ../fish/guestfish-actions.pod:3302 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:3234 ../src/guestfs-actions.pod:4903 +#: ../fish/guestfish-actions.pod:3306 ../src/guestfs-actions.pod:5143 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 " @@ -12034,7 +12169,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3238 ../src/guestfs-actions.pod:4907 +#: ../fish/guestfish-actions.pod:3310 ../src/guestfs-actions.pod:5147 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 " @@ -12042,7 +12177,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3243 ../src/guestfs-actions.pod:4912 +#: ../fish/guestfish-actions.pod:3315 ../src/guestfs-actions.pod:5152 #, no-wrap msgid "" " add-ro Fedora-11-i686-Live.iso\n" @@ -12057,12 +12192,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3252 ../src/guestfs-actions.pod:4921 +#: ../fish/guestfish-actions.pod:3324 ../src/guestfs-actions.pod:5161 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3254 +#: ../fish/guestfish-actions.pod:3326 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 " @@ -12070,7 +12205,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3258 +#: ../fish/guestfish-actions.pod:3330 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 " @@ -12078,12 +12213,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3263 ../src/guestfs-actions.pod:4932 +#: ../fish/guestfish-actions.pod:3335 ../src/guestfs-actions.pod:5172 msgid "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3265 +#: ../fish/guestfish-actions.pod:3337 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 " @@ -12091,12 +12226,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3269 +#: ../fish/guestfish-actions.pod:3341 msgid "mknod" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3271 +#: ../fish/guestfish-actions.pod:3343 #, no-wrap msgid "" " mknod mode devmajor devminor path\n" @@ -12104,14 +12239,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3273 ../src/guestfs-actions.pod:4951 +#: ../fish/guestfish-actions.pod:3345 ../src/guestfs-actions.pod:5191 msgid "" "This call creates block or character special devices, or named pipes " "(FIFOs)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3276 ../src/guestfs-actions.pod:4954 +#: ../fish/guestfish-actions.pod:3348 ../src/guestfs-actions.pod:5194 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 " @@ -12119,7 +12254,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3281 +#: ../fish/guestfish-actions.pod:3353 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 " @@ -12130,12 +12265,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3291 +#: ../fish/guestfish-actions.pod:3363 msgid "mknod-b" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3293 +#: ../fish/guestfish-actions.pod:3365 #, no-wrap msgid "" " mknod-b mode devmajor devminor path\n" @@ -12143,7 +12278,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3295 +#: ../fish/guestfish-actions.pod:3367 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 " @@ -12151,12 +12286,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3301 +#: ../fish/guestfish-actions.pod:3373 msgid "mknod-c" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3303 +#: ../fish/guestfish-actions.pod:3375 #, no-wrap msgid "" " mknod-c mode devmajor devminor path\n" @@ -12164,7 +12299,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3305 +#: ../fish/guestfish-actions.pod:3377 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 " @@ -12172,12 +12307,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3311 +#: ../fish/guestfish-actions.pod:3383 msgid "mkswap" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3313 +#: ../fish/guestfish-actions.pod:3385 #, no-wrap msgid "" " mkswap device\n" @@ -12185,17 +12320,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3315 ../src/guestfs-actions.pod:5017 +#: ../fish/guestfish-actions.pod:3387 ../src/guestfs-actions.pod:5257 msgid "Create a swap partition on C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3317 +#: ../fish/guestfish-actions.pod:3389 msgid "mkswap-L" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3319 +#: ../fish/guestfish-actions.pod:3391 #, no-wrap msgid "" " mkswap-L label device\n" @@ -12203,12 +12338,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3321 ../src/guestfs-actions.pod:5030 +#: ../fish/guestfish-actions.pod:3393 ../src/guestfs-actions.pod:5270 msgid "Create a swap partition on C<device> with label C<label>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3323 ../src/guestfs-actions.pod:5032 +#: ../fish/guestfish-actions.pod:3395 ../src/guestfs-actions.pod:5272 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 " @@ -12216,12 +12351,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3327 +#: ../fish/guestfish-actions.pod:3399 msgid "mkswap-U" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3329 +#: ../fish/guestfish-actions.pod:3401 #, no-wrap msgid "" " mkswap-U uuid device\n" @@ -12229,17 +12364,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3331 ../src/guestfs-actions.pod:5047 +#: ../fish/guestfish-actions.pod:3403 ../src/guestfs-actions.pod:5287 msgid "Create a swap partition on C<device> with UUID C<uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3333 +#: ../fish/guestfish-actions.pod:3405 msgid "mkswap-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3335 +#: ../fish/guestfish-actions.pod:3407 #, no-wrap msgid "" " mkswap-file path\n" @@ -12247,24 +12382,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3337 ../src/guestfs-actions.pod:5059 +#: ../fish/guestfish-actions.pod:3409 ../src/guestfs-actions.pod:5299 msgid "Create a swap file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3339 +#: ../fish/guestfish-actions.pod:3411 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:3342 +#: ../fish/guestfish-actions.pod:3414 msgid "modprobe" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3344 +#: ../fish/guestfish-actions.pod:3416 #, no-wrap msgid "" " modprobe modulename\n" @@ -12272,24 +12407,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3346 ../src/guestfs-actions.pod:5074 +#: ../fish/guestfish-actions.pod:3418 ../src/guestfs-actions.pod:5314 msgid "This loads a kernel module in the appliance." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3348 ../src/guestfs-actions.pod:5076 +#: ../fish/guestfish-actions.pod:3420 ../src/guestfs-actions.pod:5316 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:3351 +#: ../fish/guestfish-actions.pod:3423 msgid "mount" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3353 +#: ../fish/guestfish-actions.pod:3425 #, no-wrap msgid "" " mount device mountpoint\n" @@ -12297,7 +12432,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3355 ../src/guestfs-actions.pod:5090 +#: ../fish/guestfish-actions.pod:3427 ../src/guestfs-actions.pod:5330 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 " @@ -12306,7 +12441,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3361 ../src/guestfs-actions.pod:5096 +#: ../fish/guestfish-actions.pod:3433 ../src/guestfs-actions.pod:5336 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 " @@ -12314,14 +12449,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3366 ../src/guestfs-actions.pod:5101 +#: ../fish/guestfish-actions.pod:3438 ../src/guestfs-actions.pod:5341 msgid "" "The mounted filesystem is writable, if we have sufficient permissions on the " "underlying device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3369 +#: ../fish/guestfish-actions.pod:3441 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 " @@ -12331,12 +12466,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3376 +#: ../fish/guestfish-actions.pod:3448 msgid "mount-9p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3378 +#: ../fish/guestfish-actions.pod:3450 #, no-wrap msgid "" " mount-9p mounttag mountpoint [options:..]\n" @@ -12344,14 +12479,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3380 ../src/guestfs-actions.pod:5130 +#: ../fish/guestfish-actions.pod:3452 ../src/guestfs-actions.pod:5370 msgid "" "Mount the virtio-9p filesystem with the tag C<mounttag> on the directory " "C<mountpoint>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3383 ../src/guestfs-actions.pod:5133 +#: ../fish/guestfish-actions.pod:3455 ../src/guestfs-actions.pod:5373 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> " @@ -12359,12 +12494,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3389 +#: ../fish/guestfish-actions.pod:3461 msgid "mount-loop" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3391 +#: ../fish/guestfish-actions.pod:3463 #, no-wrap msgid "" " mount-loop file mountpoint\n" @@ -12372,7 +12507,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3393 ../src/guestfs-actions.pod:5172 +#: ../fish/guestfish-actions.pod:3465 ../src/guestfs-actions.pod:5412 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 " @@ -12380,12 +12515,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3397 +#: ../fish/guestfish-actions.pod:3469 msgid "mount-options" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3399 +#: ../fish/guestfish-actions.pod:3471 #, no-wrap msgid "" " mount-options options device mountpoint\n" @@ -12393,26 +12528,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3401 +#: ../fish/guestfish-actions.pod:3473 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:3405 ../src/guestfs-actions.pod:5192 +#: ../fish/guestfish-actions.pod:3477 ../src/guestfs-actions.pod:5432 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:3409 +#: ../fish/guestfish-actions.pod:3481 msgid "mount-ro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3411 +#: ../fish/guestfish-actions.pod:3483 #, no-wrap msgid "" " mount-ro device mountpoint\n" @@ -12420,19 +12555,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3413 +#: ../fish/guestfish-actions.pod:3485 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:3416 +#: ../fish/guestfish-actions.pod:3488 msgid "mount-vfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3418 +#: ../fish/guestfish-actions.pod:3490 #, no-wrap msgid "" " mount-vfs options vfstype device mountpoint\n" @@ -12440,19 +12575,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3420 +#: ../fish/guestfish-actions.pod:3492 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:3424 +#: ../fish/guestfish-actions.pod:3496 msgid "mountpoints" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3426 +#: ../fish/guestfish-actions.pod:3498 #, no-wrap msgid "" " mountpoints\n" @@ -12460,7 +12595,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3428 +#: ../fish/guestfish-actions.pod:3500 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 " @@ -12468,12 +12603,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3432 +#: ../fish/guestfish-actions.pod:3504 msgid "mounts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3434 +#: ../fish/guestfish-actions.pod:3506 #, no-wrap msgid "" " mounts\n" @@ -12481,29 +12616,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3436 ../src/guestfs-actions.pod:5253 +#: ../fish/guestfish-actions.pod:3508 ../src/guestfs-actions.pod:5493 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:3439 ../src/guestfs-actions.pod:5256 +#: ../fish/guestfish-actions.pod:3511 ../src/guestfs-actions.pod:5496 msgid "Some internal mounts are not shown." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3441 +#: ../fish/guestfish-actions.pod:3513 msgid "See also: L</mountpoints>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3443 +#: ../fish/guestfish-actions.pod:3515 msgid "mv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3445 +#: ../fish/guestfish-actions.pod:3517 #, no-wrap msgid "" " mv src dest\n" @@ -12511,19 +12646,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3447 ../src/guestfs-actions.pod:5273 +#: ../fish/guestfish-actions.pod:3519 ../src/guestfs-actions.pod:5513 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:3450 +#: ../fish/guestfish-actions.pod:3522 msgid "ntfs-3g-probe" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3452 +#: ../fish/guestfish-actions.pod:3524 #, no-wrap msgid "" " ntfs-3g-probe true|false device\n" @@ -12531,7 +12666,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3454 ../src/guestfs-actions.pod:5287 +#: ../fish/guestfish-actions.pod:3526 ../src/guestfs-actions.pod:5527 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 " @@ -12539,7 +12674,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3458 ../src/guestfs-actions.pod:5291 +#: ../fish/guestfish-actions.pod:3530 ../src/guestfs-actions.pod:5531 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 " @@ -12547,19 +12682,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3462 ../src/guestfs-actions.pod:5295 +#: ../fish/guestfish-actions.pod:3534 ../src/guestfs-actions.pod:5535 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:3466 +#: ../fish/guestfish-actions.pod:3538 msgid "ntfsresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3468 +#: ../fish/guestfish-actions.pod:3540 #, no-wrap msgid "" " ntfsresize device\n" @@ -12567,14 +12702,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3470 ../fish/guestfish-actions.pod:3494 ../src/guestfs-actions.pod:5316 ../src/guestfs-actions.pod:5348 +#: ../fish/guestfish-actions.pod:3542 ../fish/guestfish-actions.pod:3566 ../src/guestfs-actions.pod:5556 ../src/guestfs-actions.pod:5588 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:3473 ../src/guestfs-actions.pod:5319 +#: ../fish/guestfish-actions.pod:3545 ../src/guestfs-actions.pod:5559 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 " @@ -12585,24 +12720,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3481 ../fish/guestfish-actions.pod:3520 ../src/guestfs-actions.pod:5327 ../src/guestfs-actions.pod:5374 +#: ../fish/guestfish-actions.pod:3553 ../fish/guestfish-actions.pod:3592 ../src/guestfs-actions.pod:5567 ../src/guestfs-actions.pod:5614 msgid "See also L<ntfsresize(8)>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3483 ../fish/guestfish-actions.pod:3531 +#: ../fish/guestfish-actions.pod:3555 ../fish/guestfish-actions.pod:3603 msgid "" "I<This function is deprecated.> In new code, use the L</ntfsresize_opts> " "call instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3490 +#: ../fish/guestfish-actions.pod:3562 msgid "ntfsresize-opts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3492 +#: ../fish/guestfish-actions.pod:3564 #, no-wrap msgid "" " ntfsresize-opts device [size:..] [force:..]\n" @@ -12610,26 +12745,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3503 ../src/guestfs-actions.pod:5357 +#: ../fish/guestfish-actions.pod:3575 ../src/guestfs-actions.pod:5597 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:3506 ../src/guestfs-actions.pod:5360 +#: ../fish/guestfish-actions.pod:3578 ../src/guestfs-actions.pod:5600 msgid "C<force>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3508 ../src/guestfs-actions.pod:5362 +#: ../fish/guestfish-actions.pod:3580 ../src/guestfs-actions.pod:5602 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:3511 +#: ../fish/guestfish-actions.pod:3583 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 " @@ -12639,12 +12774,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3524 +#: ../fish/guestfish-actions.pod:3596 msgid "ntfsresize-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3526 +#: ../fish/guestfish-actions.pod:3598 #, no-wrap msgid "" " ntfsresize-size device size\n" @@ -12652,19 +12787,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3528 +#: ../fish/guestfish-actions.pod:3600 msgid "" "This command is the same as L</ntfsresize> except that it allows you to " "specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3538 +#: ../fish/guestfish-actions.pod:3610 msgid "part-add" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3540 +#: ../fish/guestfish-actions.pod:3612 #, no-wrap msgid "" " part-add device prlogex startsect endsect\n" @@ -12672,14 +12807,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3542 +#: ../fish/guestfish-actions.pod:3614 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:3545 ../src/guestfs-actions.pod:5435 +#: ../fish/guestfish-actions.pod:3617 ../src/guestfs-actions.pod:5675 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 " @@ -12687,7 +12822,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3550 ../src/guestfs-actions.pod:5440 +#: ../fish/guestfish-actions.pod:3622 ../src/guestfs-actions.pod:5680 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 " @@ -12695,19 +12830,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3554 +#: ../fish/guestfish-actions.pod:3626 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:3557 +#: ../fish/guestfish-actions.pod:3629 msgid "part-del" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3559 +#: ../fish/guestfish-actions.pod:3631 #, no-wrap msgid "" " part-del device partnum\n" @@ -12715,24 +12850,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3561 ../src/guestfs-actions.pod:5458 +#: ../fish/guestfish-actions.pod:3633 ../src/guestfs-actions.pod:5698 msgid "This command deletes the partition numbered C<partnum> on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3563 ../src/guestfs-actions.pod:5460 +#: ../fish/guestfish-actions.pod:3635 ../src/guestfs-actions.pod:5700 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:3567 +#: ../fish/guestfish-actions.pod:3639 msgid "part-disk" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3569 +#: ../fish/guestfish-actions.pod:3641 #, no-wrap msgid "" " part-disk device parttype\n" @@ -12740,26 +12875,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3571 +#: ../fish/guestfish-actions.pod:3643 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:3575 +#: ../fish/guestfish-actions.pod:3647 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:3581 +#: ../fish/guestfish-actions.pod:3653 msgid "part-get-bootable" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3583 +#: ../fish/guestfish-actions.pod:3655 #, no-wrap msgid "" " part-get-bootable device partnum\n" @@ -12767,24 +12902,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3585 ../src/guestfs-actions.pod:5496 +#: ../fish/guestfish-actions.pod:3657 ../src/guestfs-actions.pod:5736 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:3588 +#: ../fish/guestfish-actions.pod:3660 msgid "See also L</part-set-bootable>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3590 +#: ../fish/guestfish-actions.pod:3662 msgid "part-get-mbr-id" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3592 +#: ../fish/guestfish-actions.pod:3664 #, no-wrap msgid "" " part-get-mbr-id device partnum\n" @@ -12792,14 +12927,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3594 ../src/guestfs-actions.pod:5512 +#: ../fish/guestfish-actions.pod:3666 ../src/guestfs-actions.pod:5752 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:3597 ../fish/guestfish-actions.pod:3741 +#: ../fish/guestfish-actions.pod:3669 ../fish/guestfish-actions.pod:3813 msgid "" "Note that only MBR (old DOS-style) partitions have type bytes. You will get " "undefined results for other partition table types (see " @@ -12807,12 +12942,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3601 +#: ../fish/guestfish-actions.pod:3673 msgid "part-get-parttype" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3603 +#: ../fish/guestfish-actions.pod:3675 #, no-wrap msgid "" " part-get-parttype device\n" @@ -12820,14 +12955,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3605 ../src/guestfs-actions.pod:5529 +#: ../fish/guestfish-actions.pod:3677 ../src/guestfs-actions.pod:5769 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:3608 +#: ../fish/guestfish-actions.pod:3680 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 " @@ -12835,12 +12970,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3613 +#: ../fish/guestfish-actions.pod:3685 msgid "part-init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3615 +#: ../fish/guestfish-actions.pod:3687 #, no-wrap msgid "" " part-init device parttype\n" @@ -12848,7 +12983,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3617 ../src/guestfs-actions.pod:5549 +#: ../fish/guestfish-actions.pod:3689 ../src/guestfs-actions.pod:5789 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> " @@ -12856,34 +12991,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3621 +#: ../fish/guestfish-actions.pod:3693 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:3624 ../src/guestfs-actions.pod:5556 +#: ../fish/guestfish-actions.pod:3696 ../src/guestfs-actions.pod:5796 msgid "Possible values for C<parttype> are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3628 ../src/guestfs-actions.pod:5560 +#: ../fish/guestfish-actions.pod:3700 ../src/guestfs-actions.pod:5800 msgid "B<efi>" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3630 ../src/guestfs-actions.pod:5562 +#: ../fish/guestfish-actions.pod:3702 ../src/guestfs-actions.pod:5802 msgid "B<gpt>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3632 ../src/guestfs-actions.pod:5564 +#: ../fish/guestfish-actions.pod:3704 ../src/guestfs-actions.pod:5804 msgid "Intel EFI / GPT partition table." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3634 ../src/guestfs-actions.pod:5566 +#: ../fish/guestfish-actions.pod:3706 ../src/guestfs-actions.pod:5806 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 " @@ -12891,17 +13026,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3638 ../src/guestfs-actions.pod:5570 +#: ../fish/guestfish-actions.pod:3710 ../src/guestfs-actions.pod:5810 msgid "B<mbr>" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3640 ../src/guestfs-actions.pod:5572 +#: ../fish/guestfish-actions.pod:3712 ../src/guestfs-actions.pod:5812 msgid "B<msdos>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3642 ../src/guestfs-actions.pod:5574 +#: ../fish/guestfish-actions.pod:3714 ../src/guestfs-actions.pod:5814 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 " @@ -12909,102 +13044,102 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3649 ../src/guestfs-actions.pod:5581 +#: ../fish/guestfish-actions.pod:3721 ../src/guestfs-actions.pod:5821 msgid "Other partition table types that may work but are not supported include:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3654 ../src/guestfs-actions.pod:5586 +#: ../fish/guestfish-actions.pod:3726 ../src/guestfs-actions.pod:5826 msgid "B<aix>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3656 ../src/guestfs-actions.pod:5588 +#: ../fish/guestfish-actions.pod:3728 ../src/guestfs-actions.pod:5828 msgid "AIX disk labels." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3658 ../src/guestfs-actions.pod:5590 +#: ../fish/guestfish-actions.pod:3730 ../src/guestfs-actions.pod:5830 msgid "B<amiga>" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3660 ../src/guestfs-actions.pod:5592 +#: ../fish/guestfish-actions.pod:3732 ../src/guestfs-actions.pod:5832 msgid "B<rdb>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3662 ../src/guestfs-actions.pod:5594 +#: ../fish/guestfish-actions.pod:3734 ../src/guestfs-actions.pod:5834 msgid "Amiga \"Rigid Disk Block\" format." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3664 ../src/guestfs-actions.pod:5596 +#: ../fish/guestfish-actions.pod:3736 ../src/guestfs-actions.pod:5836 msgid "B<bsd>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3666 ../src/guestfs-actions.pod:5598 +#: ../fish/guestfish-actions.pod:3738 ../src/guestfs-actions.pod:5838 msgid "BSD disk labels." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3668 ../src/guestfs-actions.pod:5600 +#: ../fish/guestfish-actions.pod:3740 ../src/guestfs-actions.pod:5840 msgid "B<dasd>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3670 ../src/guestfs-actions.pod:5602 +#: ../fish/guestfish-actions.pod:3742 ../src/guestfs-actions.pod:5842 msgid "DASD, used on IBM mainframes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3672 ../src/guestfs-actions.pod:5604 +#: ../fish/guestfish-actions.pod:3744 ../src/guestfs-actions.pod:5844 msgid "B<dvh>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3674 ../src/guestfs-actions.pod:5606 +#: ../fish/guestfish-actions.pod:3746 ../src/guestfs-actions.pod:5846 msgid "MIPS/SGI volumes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3676 ../src/guestfs-actions.pod:5608 +#: ../fish/guestfish-actions.pod:3748 ../src/guestfs-actions.pod:5848 msgid "B<mac>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3678 ../src/guestfs-actions.pod:5610 +#: ../fish/guestfish-actions.pod:3750 ../src/guestfs-actions.pod:5850 msgid "Old Mac partition format. Modern Macs use C<gpt>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3680 ../src/guestfs-actions.pod:5612 +#: ../fish/guestfish-actions.pod:3752 ../src/guestfs-actions.pod:5852 msgid "B<pc98>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3682 ../src/guestfs-actions.pod:5614 +#: ../fish/guestfish-actions.pod:3754 ../src/guestfs-actions.pod:5854 msgid "NEC PC-98 format, common in Japan apparently." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3684 ../src/guestfs-actions.pod:5616 +#: ../fish/guestfish-actions.pod:3756 ../src/guestfs-actions.pod:5856 msgid "B<sun>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3686 ../src/guestfs-actions.pod:5618 +#: ../fish/guestfish-actions.pod:3758 ../src/guestfs-actions.pod:5858 msgid "Sun disk labels." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3690 +#: ../fish/guestfish-actions.pod:3762 msgid "part-list" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3692 +#: ../fish/guestfish-actions.pod:3764 #, no-wrap msgid "" " part-list device\n" @@ -13012,66 +13147,66 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3694 ../src/guestfs-actions.pod:5632 +#: ../fish/guestfish-actions.pod:3766 ../src/guestfs-actions.pod:5872 msgid "" "This command parses the partition table on C<device> and returns the list of " "partitions found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3697 ../src/guestfs-actions.pod:5635 +#: ../fish/guestfish-actions.pod:3769 ../src/guestfs-actions.pod:5875 msgid "The fields in the returned structure are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3701 ../src/guestfs-actions.pod:5639 +#: ../fish/guestfish-actions.pod:3773 ../src/guestfs-actions.pod:5879 msgid "B<part_num>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3703 ../src/guestfs-actions.pod:5641 +#: ../fish/guestfish-actions.pod:3775 ../src/guestfs-actions.pod:5881 msgid "Partition number, counting from 1." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3705 ../src/guestfs-actions.pod:5643 +#: ../fish/guestfish-actions.pod:3777 ../src/guestfs-actions.pod:5883 msgid "B<part_start>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3707 +#: ../fish/guestfish-actions.pod:3779 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:3710 ../src/guestfs-actions.pod:5648 +#: ../fish/guestfish-actions.pod:3782 ../src/guestfs-actions.pod:5888 msgid "B<part_end>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3712 ../src/guestfs-actions.pod:5650 +#: ../fish/guestfish-actions.pod:3784 ../src/guestfs-actions.pod:5890 msgid "End of the partition in bytes." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3714 ../src/guestfs-actions.pod:5652 +#: ../fish/guestfish-actions.pod:3786 ../src/guestfs-actions.pod:5892 msgid "B<part_size>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3716 ../src/guestfs-actions.pod:5654 +#: ../fish/guestfish-actions.pod:3788 ../src/guestfs-actions.pod:5894 msgid "Size of the partition in bytes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3720 +#: ../fish/guestfish-actions.pod:3792 msgid "part-set-bootable" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3722 +#: ../fish/guestfish-actions.pod:3794 #, no-wrap msgid "" " part-set-bootable device partnum true|false\n" @@ -13079,14 +13214,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3724 ../src/guestfs-actions.pod:5672 +#: ../fish/guestfish-actions.pod:3796 ../src/guestfs-actions.pod:5912 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:3727 ../src/guestfs-actions.pod:5675 +#: ../fish/guestfish-actions.pod:3799 ../src/guestfs-actions.pod:5915 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 " @@ -13094,12 +13229,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3731 +#: ../fish/guestfish-actions.pod:3803 msgid "part-set-mbr-id" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3733 +#: ../fish/guestfish-actions.pod:3805 #, no-wrap msgid "" " part-set-mbr-id device partnum idbyte\n" @@ -13107,7 +13242,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3735 ../src/guestfs-actions.pod:5691 +#: ../fish/guestfish-actions.pod:3807 ../src/guestfs-actions.pod:5931 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 " @@ -13116,12 +13251,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3745 +#: ../fish/guestfish-actions.pod:3817 msgid "part-set-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3747 +#: ../fish/guestfish-actions.pod:3819 #, no-wrap msgid "" " part-set-name device partnum name\n" @@ -13129,26 +13264,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3749 ../src/guestfs-actions.pod:5713 +#: ../fish/guestfish-actions.pod:3821 ../src/guestfs-actions.pod:5953 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:3752 ../src/guestfs-actions.pod:5716 +#: ../fish/guestfish-actions.pod:3824 ../src/guestfs-actions.pod:5956 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:3755 +#: ../fish/guestfish-actions.pod:3827 msgid "part-to-dev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3757 +#: ../fish/guestfish-actions.pod:3829 #, no-wrap msgid "" " part-to-dev partition\n" @@ -13156,26 +13291,56 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3759 ../src/guestfs-actions.pod:5729 +#: ../fish/guestfish-actions.pod:3831 ../src/guestfs-actions.pod:5969 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:3763 +#: ../fish/guestfish-actions.pod:3835 ../fish/guestfish-actions.pod:3847 msgid "" "The named partition must exist, for example as a string returned from " "L</list-partitions>." msgstr "" +#. type: textblock +#: ../fish/guestfish-actions.pod:3838 +msgid "See also L</part-to-partnum>." +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:3766 +#: ../fish/guestfish-actions.pod:3840 +msgid "part-to-partnum" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:3842 +#, no-wrap +msgid "" +" part-to-partnum partition\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3844 ../src/guestfs-actions.pod:5989 +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:3850 +msgid "See also L</part-to-dev>." +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:3852 msgid "ping-daemon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3768 +#: ../fish/guestfish-actions.pod:3854 #, no-wrap msgid "" " ping-daemon\n" @@ -13183,7 +13348,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3770 ../src/guestfs-actions.pod:5746 +#: ../fish/guestfish-actions.pod:3856 ../src/guestfs-actions.pod:6004 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 " @@ -13192,12 +13357,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3775 +#: ../fish/guestfish-actions.pod:3861 msgid "pread" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3777 +#: ../fish/guestfish-actions.pod:3863 #, no-wrap msgid "" " pread path count offset\n" @@ -13205,31 +13370,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3779 ../src/guestfs-actions.pod:5764 +#: ../fish/guestfish-actions.pod:3865 ../src/guestfs-actions.pod:6022 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:3782 ../fish/guestfish-actions.pod:3797 ../src/guestfs-actions.pod:5767 ../src/guestfs-actions.pod:5793 +#: ../fish/guestfish-actions.pod:3868 ../fish/guestfish-actions.pod:3883 ../src/guestfs-actions.pod:6025 ../src/guestfs-actions.pod:6051 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:3785 +#: ../fish/guestfish-actions.pod:3871 msgid "See also L</pwrite>, L</pread-device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3790 +#: ../fish/guestfish-actions.pod:3876 msgid "pread-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3792 +#: ../fish/guestfish-actions.pod:3878 #, no-wrap msgid "" " pread-device device count offset\n" @@ -13237,24 +13402,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3794 ../src/guestfs-actions.pod:5790 +#: ../fish/guestfish-actions.pod:3880 ../src/guestfs-actions.pod:6048 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:3800 +#: ../fish/guestfish-actions.pod:3886 msgid "See also L</pread>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3805 +#: ../fish/guestfish-actions.pod:3891 msgid "pvcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3807 +#: ../fish/guestfish-actions.pod:3893 #, no-wrap msgid "" " pvcreate device\n" @@ -13262,19 +13427,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3809 ../src/guestfs-actions.pod:5813 +#: ../fish/guestfish-actions.pod:3895 ../src/guestfs-actions.pod:6071 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:3813 +#: ../fish/guestfish-actions.pod:3899 msgid "pvremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3815 +#: ../fish/guestfish-actions.pod:3901 #, no-wrap msgid "" " pvremove device\n" @@ -13282,14 +13447,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3817 ../src/guestfs-actions.pod:5827 +#: ../fish/guestfish-actions.pod:3903 ../src/guestfs-actions.pod:6085 msgid "" "This wipes a physical volume C<device> so that LVM will no longer recognise " "it." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3820 ../src/guestfs-actions.pod:5830 +#: ../fish/guestfish-actions.pod:3906 ../src/guestfs-actions.pod:6088 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 " @@ -13297,12 +13462,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3824 +#: ../fish/guestfish-actions.pod:3910 msgid "pvresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3826 +#: ../fish/guestfish-actions.pod:3912 #, no-wrap msgid "" " pvresize device\n" @@ -13310,19 +13475,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3828 ../src/guestfs-actions.pod:5844 +#: ../fish/guestfish-actions.pod:3914 ../src/guestfs-actions.pod:6102 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:3831 +#: ../fish/guestfish-actions.pod:3917 msgid "pvresize-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3833 +#: ../fish/guestfish-actions.pod:3919 #, no-wrap msgid "" " pvresize-size device size\n" @@ -13330,19 +13495,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3835 +#: ../fish/guestfish-actions.pod:3921 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:3838 +#: ../fish/guestfish-actions.pod:3924 msgid "pvs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3840 +#: ../fish/guestfish-actions.pod:3926 #, no-wrap msgid "" " pvs\n" @@ -13350,31 +13515,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3842 ../src/guestfs-actions.pod:5870 +#: ../fish/guestfish-actions.pod:3928 ../src/guestfs-actions.pod:6128 msgid "" "List all the physical volumes detected. This is the equivalent of the " "L<pvs(8)> command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3845 ../src/guestfs-actions.pod:5873 +#: ../fish/guestfish-actions.pod:3931 ../src/guestfs-actions.pod:6131 msgid "" "This returns a list of just the device names that contain PVs " "(eg. C</dev/sda2>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3848 +#: ../fish/guestfish-actions.pod:3934 msgid "See also L</pvs-full>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3850 +#: ../fish/guestfish-actions.pod:3936 msgid "pvs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3852 +#: ../fish/guestfish-actions.pod:3938 #, no-wrap msgid "" " pvs-full\n" @@ -13382,19 +13547,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3854 ../src/guestfs-actions.pod:5889 +#: ../fish/guestfish-actions.pod:3940 ../src/guestfs-actions.pod:6147 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:3857 +#: ../fish/guestfish-actions.pod:3943 msgid "pvuuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3859 +#: ../fish/guestfish-actions.pod:3945 #, no-wrap msgid "" " pvuuid device\n" @@ -13402,17 +13567,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3861 ../src/guestfs-actions.pod:5904 +#: ../fish/guestfish-actions.pod:3947 ../src/guestfs-actions.pod:6162 msgid "This command returns the UUID of the LVM PV C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3863 +#: ../fish/guestfish-actions.pod:3949 msgid "pwrite" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3865 +#: ../fish/guestfish-actions.pod:3951 #, no-wrap msgid "" " pwrite path content offset\n" @@ -13420,14 +13585,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3867 ../src/guestfs-actions.pod:5920 +#: ../fish/guestfish-actions.pod:3953 ../src/guestfs-actions.pod:6178 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:3870 ../src/guestfs-actions.pod:5923 +#: ../fish/guestfish-actions.pod:3956 ../src/guestfs-actions.pod:6181 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 " @@ -13437,17 +13602,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3876 +#: ../fish/guestfish-actions.pod:3962 msgid "See also L</pread>, L</pwrite-device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3881 +#: ../fish/guestfish-actions.pod:3967 msgid "pwrite-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3883 +#: ../fish/guestfish-actions.pod:3969 #, no-wrap msgid "" " pwrite-device device content offset\n" @@ -13455,14 +13620,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3885 ../src/guestfs-actions.pod:5947 +#: ../fish/guestfish-actions.pod:3971 ../src/guestfs-actions.pod:6205 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:3888 ../src/guestfs-actions.pod:5950 +#: ../fish/guestfish-actions.pod:3974 ../src/guestfs-actions.pod:6208 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 " @@ -13470,17 +13635,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3893 +#: ../fish/guestfish-actions.pod:3979 msgid "See also L</pwrite>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3898 +#: ../fish/guestfish-actions.pod:3984 msgid "read-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3900 +#: ../fish/guestfish-actions.pod:3986 #, no-wrap msgid "" " read-file path\n" @@ -13488,12 +13653,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3902 ../src/guestfs-actions.pod:5971 +#: ../fish/guestfish-actions.pod:3988 ../src/guestfs-actions.pod:6229 msgid "This calls returns the contents of the file C<path> as a buffer." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3905 +#: ../fish/guestfish-actions.pod:3991 msgid "" "Unlike L</cat>, this function can correctly handle files that contain " "embedded ASCII NUL characters. However unlike L</download>, this function " @@ -13501,12 +13666,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3913 +#: ../fish/guestfish-actions.pod:3999 msgid "read-lines" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3915 +#: ../fish/guestfish-actions.pod:4001 #, no-wrap msgid "" " read-lines path\n" @@ -13514,14 +13679,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3919 ../src/guestfs-actions.pod:5996 +#: ../fish/guestfish-actions.pod:4005 ../src/guestfs-actions.pod:6254 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:3922 +#: ../fish/guestfish-actions.pod:4008 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of line). For " @@ -13530,12 +13695,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3927 +#: ../fish/guestfish-actions.pod:4013 msgid "readdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3929 +#: ../fish/guestfish-actions.pod:4015 #, no-wrap msgid "" " readdir dir\n" @@ -13543,12 +13708,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3931 ../src/guestfs-actions.pod:6016 +#: ../fish/guestfish-actions.pod:4017 ../src/guestfs-actions.pod:6274 msgid "This returns the list of directory entries in directory C<dir>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3933 ../src/guestfs-actions.pod:6018 +#: ../fish/guestfish-actions.pod:4019 ../src/guestfs-actions.pod:6276 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 " @@ -13556,104 +13721,104 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3937 ../src/guestfs-actions.pod:6022 +#: ../fish/guestfish-actions.pod:4023 ../src/guestfs-actions.pod:6280 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:3942 ../src/guestfs-actions.pod:6027 +#: ../fish/guestfish-actions.pod:4028 ../src/guestfs-actions.pod:6285 msgid "'b'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3944 ../src/guestfs-actions.pod:6029 +#: ../fish/guestfish-actions.pod:4030 ../src/guestfs-actions.pod:6287 msgid "Block special" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3946 ../src/guestfs-actions.pod:6031 +#: ../fish/guestfish-actions.pod:4032 ../src/guestfs-actions.pod:6289 msgid "'c'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3948 ../src/guestfs-actions.pod:6033 +#: ../fish/guestfish-actions.pod:4034 ../src/guestfs-actions.pod:6291 msgid "Char special" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3950 ../src/guestfs-actions.pod:6035 +#: ../fish/guestfish-actions.pod:4036 ../src/guestfs-actions.pod:6293 msgid "'d'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3952 ../src/guestfs-actions.pod:6037 +#: ../fish/guestfish-actions.pod:4038 ../src/guestfs-actions.pod:6295 msgid "Directory" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3954 ../src/guestfs-actions.pod:6039 +#: ../fish/guestfish-actions.pod:4040 ../src/guestfs-actions.pod:6297 msgid "'f'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3956 ../src/guestfs-actions.pod:6041 +#: ../fish/guestfish-actions.pod:4042 ../src/guestfs-actions.pod:6299 msgid "FIFO (named pipe)" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3958 ../src/guestfs-actions.pod:6043 +#: ../fish/guestfish-actions.pod:4044 ../src/guestfs-actions.pod:6301 msgid "'l'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3960 ../src/guestfs-actions.pod:6045 +#: ../fish/guestfish-actions.pod:4046 ../src/guestfs-actions.pod:6303 msgid "Symbolic link" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3962 ../src/guestfs-actions.pod:6047 +#: ../fish/guestfish-actions.pod:4048 ../src/guestfs-actions.pod:6305 msgid "'r'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3964 ../src/guestfs-actions.pod:6049 +#: ../fish/guestfish-actions.pod:4050 ../src/guestfs-actions.pod:6307 msgid "Regular file" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3966 ../src/guestfs-actions.pod:6051 +#: ../fish/guestfish-actions.pod:4052 ../src/guestfs-actions.pod:6309 msgid "'s'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3968 ../src/guestfs-actions.pod:6053 +#: ../fish/guestfish-actions.pod:4054 ../src/guestfs-actions.pod:6311 msgid "Socket" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3970 ../src/guestfs-actions.pod:6055 +#: ../fish/guestfish-actions.pod:4056 ../src/guestfs-actions.pod:6313 msgid "'u'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3972 ../src/guestfs-actions.pod:6057 +#: ../fish/guestfish-actions.pod:4058 ../src/guestfs-actions.pod:6315 msgid "Unknown file type" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:3974 ../src/guestfs-actions.pod:6059 +#: ../fish/guestfish-actions.pod:4060 ../src/guestfs-actions.pod:6317 msgid "'?'" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3976 ../src/guestfs-actions.pod:6061 +#: ../fish/guestfish-actions.pod:4062 ../src/guestfs-actions.pod:6319 msgid "The L<readdir(3)> call returned a C<d_type> field with an unexpected value" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3981 +#: ../fish/guestfish-actions.pod:4067 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 " @@ -13661,12 +13826,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3985 +#: ../fish/guestfish-actions.pod:4071 msgid "readlink" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3987 +#: ../fish/guestfish-actions.pod:4073 #, no-wrap msgid "" " readlink path\n" @@ -13674,17 +13839,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3989 ../src/guestfs-actions.pod:6082 +#: ../fish/guestfish-actions.pod:4075 ../src/guestfs-actions.pod:6340 msgid "This command reads the target of a symbolic link." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3991 +#: ../fish/guestfish-actions.pod:4077 msgid "readlinklist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3993 +#: ../fish/guestfish-actions.pod:4079 #, no-wrap msgid "" " readlinklist path 'names ...'\n" @@ -13692,7 +13857,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3995 ../src/guestfs-actions.pod:6096 +#: ../fish/guestfish-actions.pod:4081 ../src/guestfs-actions.pod:6354 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 " @@ -13700,14 +13865,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3999 ../src/guestfs-actions.pod:6100 +#: ../fish/guestfish-actions.pod:4085 ../src/guestfs-actions.pod:6358 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:4003 ../src/guestfs-actions.pod:6104 +#: ../fish/guestfish-actions.pod:4089 ../src/guestfs-actions.pod:6362 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 " @@ -13717,7 +13882,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4010 ../src/guestfs-actions.pod:6111 +#: ../fish/guestfish-actions.pod:4096 ../src/guestfs-actions.pod:6369 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. Very long directory listings " @@ -13726,12 +13891,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4017 +#: ../fish/guestfish-actions.pod:4103 msgid "realpath" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4019 +#: ../fish/guestfish-actions.pod:4105 #, no-wrap msgid "" " realpath path\n" @@ -13739,19 +13904,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4021 ../src/guestfs-actions.pod:6130 +#: ../fish/guestfish-actions.pod:4107 ../src/guestfs-actions.pod:6388 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:4024 +#: ../fish/guestfish-actions.pod:4110 msgid "removexattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4026 +#: ../fish/guestfish-actions.pod:4112 #, no-wrap msgid "" " removexattr xattr path\n" @@ -13759,22 +13924,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4028 ../src/guestfs-actions.pod:6145 +#: ../fish/guestfish-actions.pod:4114 ../src/guestfs-actions.pod:6403 msgid "This call removes the extended attribute named C<xattr> of the file C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4031 +#: ../fish/guestfish-actions.pod:4117 msgid "See also: L</lremovexattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4033 +#: ../fish/guestfish-actions.pod:4119 msgid "resize2fs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4035 +#: ../fish/guestfish-actions.pod:4121 #, no-wrap msgid "" " resize2fs device\n" @@ -13782,14 +13947,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4037 ../src/guestfs-actions.pod:6160 +#: ../fish/guestfish-actions.pod:4123 ../src/guestfs-actions.pod:6418 msgid "" "This resizes an ext2, ext3 or ext4 filesystem to match the size of the " "underlying device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4040 +#: ../fish/guestfish-actions.pod:4126 msgid "" "I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> " "before calling this command. For unknown reasons C<resize2fs> sometimes " @@ -13798,12 +13963,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4046 +#: ../fish/guestfish-actions.pod:4132 msgid "resize2fs-M" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4048 +#: ../fish/guestfish-actions.pod:4134 #, no-wrap msgid "" " resize2fs-M device\n" @@ -13811,7 +13976,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4050 +#: ../fish/guestfish-actions.pod:4136 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> " @@ -13819,7 +13984,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4054 +#: ../fish/guestfish-actions.pod:4140 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, " @@ -13828,12 +13993,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4059 +#: ../fish/guestfish-actions.pod:4145 msgid "resize2fs-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4061 +#: ../fish/guestfish-actions.pod:4147 #, no-wrap msgid "" " resize2fs-size device size\n" @@ -13841,19 +14006,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4063 +#: ../fish/guestfish-actions.pod:4149 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:4066 +#: ../fish/guestfish-actions.pod:4152 msgid "rm" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4068 +#: ../fish/guestfish-actions.pod:4154 #, no-wrap msgid "" " rm path\n" @@ -13861,17 +14026,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4070 ../src/guestfs-actions.pod:6212 +#: ../fish/guestfish-actions.pod:4156 ../src/guestfs-actions.pod:6470 msgid "Remove the single file C<path>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4072 +#: ../fish/guestfish-actions.pod:4158 msgid "rm-rf" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4074 +#: ../fish/guestfish-actions.pod:4160 #, no-wrap msgid "" " rm-rf path\n" @@ -13879,19 +14044,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4076 ../src/guestfs-actions.pod:6224 +#: ../fish/guestfish-actions.pod:4162 ../src/guestfs-actions.pod:6482 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:4080 +#: ../fish/guestfish-actions.pod:4166 msgid "rmdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4082 +#: ../fish/guestfish-actions.pod:4168 #, no-wrap msgid "" " rmdir path\n" @@ -13899,17 +14064,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4084 ../src/guestfs-actions.pod:6238 +#: ../fish/guestfish-actions.pod:4170 ../src/guestfs-actions.pod:6496 msgid "Remove the single directory C<path>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4086 +#: ../fish/guestfish-actions.pod:4172 msgid "rmmountpoint" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4088 +#: ../fish/guestfish-actions.pod:4174 #, no-wrap msgid "" " rmmountpoint exemptpath\n" @@ -13917,19 +14082,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4090 +#: ../fish/guestfish-actions.pod:4176 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:4094 +#: ../fish/guestfish-actions.pod:4180 msgid "scrub-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4096 +#: ../fish/guestfish-actions.pod:4182 #, no-wrap msgid "" " scrub-device device\n" @@ -13937,26 +14102,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4098 ../src/guestfs-actions.pod:6264 +#: ../fish/guestfish-actions.pod:4184 ../src/guestfs-actions.pod:6522 msgid "" "This command writes patterns over C<device> to make data retrieval more " "difficult." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4101 ../fish/guestfish-actions.pod:4116 ../fish/guestfish-actions.pod:4129 ../src/guestfs-actions.pod:6267 ../src/guestfs-actions.pod:6288 ../src/guestfs-actions.pod:6307 +#: ../fish/guestfish-actions.pod:4187 ../fish/guestfish-actions.pod:4202 ../fish/guestfish-actions.pod:4215 ../src/guestfs-actions.pod:6525 ../src/guestfs-actions.pod:6546 ../src/guestfs-actions.pod:6565 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:4107 +#: ../fish/guestfish-actions.pod:4193 msgid "scrub-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4109 +#: ../fish/guestfish-actions.pod:4195 #, no-wrap msgid "" " scrub-file file\n" @@ -13964,24 +14129,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4111 ../src/guestfs-actions.pod:6283 +#: ../fish/guestfish-actions.pod:4197 ../src/guestfs-actions.pod:6541 msgid "" "This command writes patterns over a file to make data retrieval more " "difficult." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4114 ../src/guestfs-actions.pod:6286 +#: ../fish/guestfish-actions.pod:4200 ../src/guestfs-actions.pod:6544 msgid "The file is I<removed> after scrubbing." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4119 +#: ../fish/guestfish-actions.pod:4205 msgid "scrub-freespace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4121 +#: ../fish/guestfish-actions.pod:4207 #, no-wrap msgid "" " scrub-freespace dir\n" @@ -13989,7 +14154,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4123 +#: ../fish/guestfish-actions.pod:4209 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 " @@ -13998,17 +14163,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4132 +#: ../fish/guestfish-actions.pod:4218 msgid "set-append" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4134 +#: ../fish/guestfish-actions.pod:4220 msgid "append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4136 +#: ../fish/guestfish-actions.pod:4222 #, no-wrap msgid "" " set-append append\n" @@ -14016,38 +14181,38 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4138 ../src/guestfs-actions.pod:6320 +#: ../fish/guestfish-actions.pod:4224 ../src/guestfs-actions.pod:6578 msgid "" "This function is used to add additional options to the guest kernel command " "line." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4141 ../src/guestfs-actions.pod:6323 +#: ../fish/guestfish-actions.pod:4227 ../src/guestfs-actions.pod:6581 msgid "" "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> " "environment variable." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4144 ../src/guestfs-actions.pod:6326 +#: ../fish/guestfish-actions.pod:4230 ../src/guestfs-actions.pod:6584 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:4147 +#: ../fish/guestfish-actions.pod:4233 msgid "set-attach-method" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4149 +#: ../fish/guestfish-actions.pod:4235 msgid "attach-method" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4151 +#: ../fish/guestfish-actions.pod:4237 #, no-wrap msgid "" " set-attach-method attachmethod\n" @@ -14055,36 +14220,36 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4153 ../src/guestfs-actions.pod:6339 +#: ../fish/guestfish-actions.pod:4239 ../src/guestfs-actions.pod:6597 msgid "" "Set the method that libguestfs uses to connect to the back end guestfsd " "daemon. Possible methods are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4158 ../src/guestfs-actions.pod:6344 ../src/guestfs.pod:2901 +#: ../fish/guestfish-actions.pod:4244 ../src/guestfs-actions.pod:6602 ../src/guestfs.pod:2916 msgid "C<appliance>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4160 ../src/guestfs-actions.pod:6346 +#: ../fish/guestfish-actions.pod:4246 ../src/guestfs-actions.pod:6604 msgid "" "Launch an appliance and connect to it. This is the ordinary method and the " "default." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4163 ../src/guestfs-actions.pod:6349 +#: ../fish/guestfish-actions.pod:4249 ../src/guestfs-actions.pod:6607 msgid "C<unix:I<path>>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4165 ../src/guestfs-actions.pod:6351 +#: ../fish/guestfish-actions.pod:4251 ../src/guestfs-actions.pod:6609 msgid "Connect to the Unix domain socket I<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4167 ../src/guestfs-actions.pod:6353 +#: ../fish/guestfish-actions.pod:4253 ../src/guestfs-actions.pod:6611 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 " @@ -14092,17 +14257,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4173 +#: ../fish/guestfish-actions.pod:4259 msgid "set-autosync" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4175 +#: ../fish/guestfish-actions.pod:4261 msgid "autosync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4177 +#: ../fish/guestfish-actions.pod:4263 #, no-wrap msgid "" " set-autosync true|false\n" @@ -14110,7 +14275,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4179 ../src/guestfs-actions.pod:6369 +#: ../fish/guestfish-actions.pod:4265 ../src/guestfs-actions.pod:6627 msgid "" "If C<autosync> is true, this enables autosync. Libguestfs will make a best " "effort attempt to make filesystems consistent and synchronized when the " @@ -14118,24 +14283,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4184 ../src/guestfs-actions.pod:6374 +#: ../fish/guestfish-actions.pod:4270 ../src/guestfs-actions.pod:6632 msgid "" "This is enabled by default (since libguestfs 1.5.24, previously it was " "disabled by default)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4187 +#: ../fish/guestfish-actions.pod:4273 msgid "set-direct" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4189 +#: ../fish/guestfish-actions.pod:4275 msgid "direct" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4191 +#: ../fish/guestfish-actions.pod:4277 #, no-wrap msgid "" " set-direct true|false\n" @@ -14143,36 +14308,36 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4193 ../src/guestfs-actions.pod:6387 +#: ../fish/guestfish-actions.pod:4279 ../src/guestfs-actions.pod:6645 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:4197 +#: ../fish/guestfish-actions.pod:4283 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:4201 ../src/guestfs-actions.pod:6395 +#: ../fish/guestfish-actions.pod:4287 ../src/guestfs-actions.pod:6653 msgid "You probably don't want to use this unless you know what you are doing." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4204 ../src/guestfs-actions.pod:6398 +#: ../fish/guestfish-actions.pod:4290 ../src/guestfs-actions.pod:6656 msgid "The default is disabled." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4206 +#: ../fish/guestfish-actions.pod:4292 msgid "set-e2label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4208 +#: ../fish/guestfish-actions.pod:4294 #, no-wrap msgid "" " set-e2label device label\n" @@ -14180,26 +14345,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4210 ../src/guestfs-actions.pod:6411 +#: ../fish/guestfish-actions.pod:4296 ../src/guestfs-actions.pod:6669 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:4214 +#: ../fish/guestfish-actions.pod:4300 msgid "" "You can use either L</tune2fs-l> or L</get-e2label> to return the existing " "label on a filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4217 +#: ../fish/guestfish-actions.pod:4303 msgid "set-e2uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4219 +#: ../fish/guestfish-actions.pod:4305 #, no-wrap msgid "" " set-e2uuid device uuid\n" @@ -14207,7 +14372,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4221 ../src/guestfs-actions.pod:6429 +#: ../fish/guestfish-actions.pod:4307 ../src/guestfs-actions.pod:6687 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>, " @@ -14215,24 +14380,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4226 +#: ../fish/guestfish-actions.pod:4312 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:4229 +#: ../fish/guestfish-actions.pod:4315 msgid "set-memsize" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4231 +#: ../fish/guestfish-actions.pod:4317 msgid "memsize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4233 +#: ../fish/guestfish-actions.pod:4319 #, no-wrap msgid "" " set-memsize memsize\n" @@ -14240,31 +14405,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4235 +#: ../fish/guestfish-actions.pod:4321 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:4239 ../src/guestfs-actions.pod:6451 +#: ../fish/guestfish-actions.pod:4325 ../src/guestfs-actions.pod:6709 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:4246 +#: ../fish/guestfish-actions.pod:4332 msgid "set-network" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4248 +#: ../fish/guestfish-actions.pod:4334 msgid "network" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4250 +#: ../fish/guestfish-actions.pod:4336 #, no-wrap msgid "" " set-network true|false\n" @@ -14272,31 +14437,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4252 ../src/guestfs-actions.pod:6468 +#: ../fish/guestfish-actions.pod:4338 ../src/guestfs-actions.pod:6726 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:4255 ../src/guestfs-actions.pod:6471 +#: ../fish/guestfish-actions.pod:4341 ../src/guestfs-actions.pod:6729 msgid "" "This affects whether commands are able to access the network (see " "L<guestfs(3)/RUNNING COMMANDS>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4258 +#: ../fish/guestfish-actions.pod:4344 msgid "You must call this before calling L</launch>, otherwise it has no effect." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4261 +#: ../fish/guestfish-actions.pod:4347 msgid "set-path" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4265 +#: ../fish/guestfish-actions.pod:4351 #, no-wrap msgid "" " set-path searchpath\n" @@ -14304,34 +14469,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4267 ../src/guestfs-actions.pod:6487 +#: ../fish/guestfish-actions.pod:4353 ../src/guestfs-actions.pod:6745 msgid "Set the path that libguestfs searches for kernel and initrd.img." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4269 ../src/guestfs-actions.pod:6489 +#: ../fish/guestfish-actions.pod:4355 ../src/guestfs-actions.pod:6747 msgid "" "The default is C<$libdir/guestfs> unless overridden by setting " "C<LIBGUESTFS_PATH> environment variable." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4272 ../src/guestfs-actions.pod:6492 +#: ../fish/guestfish-actions.pod:4358 ../src/guestfs-actions.pod:6750 msgid "Setting C<path> to C<NULL> restores the default path." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4274 +#: ../fish/guestfish-actions.pod:4360 msgid "set-pgroup" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4276 +#: ../fish/guestfish-actions.pod:4362 msgid "pgroup" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4278 +#: ../fish/guestfish-actions.pod:4364 #, no-wrap msgid "" " set-pgroup true|false\n" @@ -14339,38 +14504,38 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4280 ../src/guestfs-actions.pod:6504 +#: ../fish/guestfish-actions.pod:4366 ../src/guestfs-actions.pod:6762 msgid "" "If C<pgroup> is true, child processes are placed into their own process " "group." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4283 ../src/guestfs-actions.pod:6507 +#: ../fish/guestfish-actions.pod:4369 ../src/guestfs-actions.pod:6765 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:4286 ../src/guestfs-actions.pod:6510 +#: ../fish/guestfish-actions.pod:4372 ../src/guestfs-actions.pod:6768 msgid "" "The default for this flag is false, because usually you want C<^C> to kill " "the subprocess." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4289 +#: ../fish/guestfish-actions.pod:4375 msgid "set-qemu" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4291 +#: ../fish/guestfish-actions.pod:4377 msgid "qemu" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4293 +#: ../fish/guestfish-actions.pod:4379 #, no-wrap msgid "" " set-qemu qemu\n" @@ -14378,29 +14543,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4295 ../src/guestfs-actions.pod:6523 +#: ../fish/guestfish-actions.pod:4381 ../src/guestfs-actions.pod:6781 msgid "Set the qemu binary that we will use." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4297 ../src/guestfs-actions.pod:6525 +#: ../fish/guestfish-actions.pod:4383 ../src/guestfs-actions.pod:6783 msgid "The default is chosen when the library was compiled by the configure script." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4300 ../src/guestfs-actions.pod:6528 +#: ../fish/guestfish-actions.pod:4386 ../src/guestfs-actions.pod:6786 msgid "" "You can also override this by setting the C<LIBGUESTFS_QEMU> environment " "variable." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4303 ../src/guestfs-actions.pod:6531 +#: ../fish/guestfish-actions.pod:4389 ../src/guestfs-actions.pod:6789 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4305 ../src/guestfs-actions.pod:6533 +#: ../fish/guestfish-actions.pod:4391 ../src/guestfs-actions.pod:6791 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 " @@ -14411,17 +14576,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4313 +#: ../fish/guestfish-actions.pod:4399 msgid "set-recovery-proc" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4315 +#: ../fish/guestfish-actions.pod:4401 msgid "recovery-proc" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4317 +#: ../fish/guestfish-actions.pod:4403 #, no-wrap msgid "" " set-recovery-proc true|false\n" @@ -14429,7 +14594,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4319 +#: ../fish/guestfish-actions.pod:4405 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 " @@ -14437,14 +14602,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4324 +#: ../fish/guestfish-actions.pod:4410 msgid "" "This only has any effect if called before L</launch>, and the default is " "true." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4327 ../src/guestfs-actions.pod:6559 +#: ../fish/guestfish-actions.pod:4413 ../src/guestfs-actions.pod:6817 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 " @@ -14453,17 +14618,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4333 +#: ../fish/guestfish-actions.pod:4419 msgid "set-selinux" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4335 +#: ../fish/guestfish-actions.pod:4421 msgid "selinux" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4337 +#: ../fish/guestfish-actions.pod:4423 #, no-wrap msgid "" " set-selinux true|false\n" @@ -14471,31 +14636,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4339 ../src/guestfs-actions.pod:6575 +#: ../fish/guestfish-actions.pod:4425 ../src/guestfs-actions.pod:6833 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:4342 ../src/guestfs-actions.pod:6578 +#: ../fish/guestfish-actions.pod:4428 ../src/guestfs-actions.pod:6836 msgid "" "Note that if SELinux is enabled, it is always in Permissive mode " "(C<enforcing=0>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4348 +#: ../fish/guestfish-actions.pod:4434 msgid "set-smp" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4350 +#: ../fish/guestfish-actions.pod:4436 msgid "smp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4352 +#: ../fish/guestfish-actions.pod:4438 #, no-wrap msgid "" " set-smp smp\n" @@ -14503,7 +14668,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4354 ../src/guestfs-actions.pod:6594 +#: ../fish/guestfish-actions.pod:4440 ../src/guestfs-actions.pod:6852 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 " @@ -14511,22 +14676,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4358 +#: ../fish/guestfish-actions.pod:4444 msgid "This function must be called before L</launch>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4360 +#: ../fish/guestfish-actions.pod:4446 msgid "set-trace" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4362 +#: ../fish/guestfish-actions.pod:4448 msgid "trace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4364 +#: ../fish/guestfish-actions.pod:4450 #, no-wrap msgid "" " set-trace true|false\n" @@ -14534,45 +14699,45 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4366 ../src/guestfs-actions.pod:6610 +#: ../fish/guestfish-actions.pod:4452 ../src/guestfs-actions.pod:6868 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:4369 ../src/guestfs-actions.pod:6613 +#: ../fish/guestfish-actions.pod:4455 ../src/guestfs-actions.pod:6871 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:4373 ../src/guestfs-actions.pod:6617 +#: ../fish/guestfish-actions.pod:4459 ../src/guestfs-actions.pod:6875 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:4376 +#: ../fish/guestfish-actions.pod:4462 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:4380 +#: ../fish/guestfish-actions.pod:4466 msgid "set-verbose" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4382 +#: ../fish/guestfish-actions.pod:4468 msgid "verbose" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4384 +#: ../fish/guestfish-actions.pod:4470 #, no-wrap msgid "" " set-verbose true|false\n" @@ -14580,31 +14745,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4386 ../src/guestfs-actions.pod:6634 +#: ../fish/guestfish-actions.pod:4472 ../src/guestfs-actions.pod:6892 msgid "If C<verbose> is true, this turns on verbose messages." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4388 ../src/guestfs-actions.pod:6636 +#: ../fish/guestfish-actions.pod:4474 ../src/guestfs-actions.pod:6894 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:4391 +#: ../fish/guestfish-actions.pod:4477 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:4395 +#: ../fish/guestfish-actions.pod:4481 msgid "setcon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4397 +#: ../fish/guestfish-actions.pod:4483 #, no-wrap msgid "" " setcon context\n" @@ -14612,24 +14777,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4399 ../src/guestfs-actions.pod:6653 +#: ../fish/guestfish-actions.pod:4485 ../src/guestfs-actions.pod:6911 msgid "" "This sets the SELinux security context of the daemon to the string " "C<context>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4402 ../src/guestfs-actions.pod:6656 +#: ../fish/guestfish-actions.pod:4488 ../src/guestfs-actions.pod:6914 msgid "See the documentation about SELINUX in L<guestfs(3)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4404 +#: ../fish/guestfish-actions.pod:4490 msgid "setxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4406 +#: ../fish/guestfish-actions.pod:4492 #, no-wrap msgid "" " setxattr xattr val vallen path\n" @@ -14637,24 +14802,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4408 ../src/guestfs-actions.pod:6671 +#: ../fish/guestfish-actions.pod:4494 ../src/guestfs-actions.pod:6929 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:4412 +#: ../fish/guestfish-actions.pod:4498 msgid "See also: L</lsetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4414 +#: ../fish/guestfish-actions.pod:4500 msgid "sfdisk" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4416 +#: ../fish/guestfish-actions.pod:4502 #, no-wrap msgid "" " sfdisk device cyls heads sectors 'lines ...'\n" @@ -14662,19 +14827,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4418 ../src/guestfs-actions.pod:6698 +#: ../fish/guestfish-actions.pod:4504 ../src/guestfs-actions.pod:6956 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:4421 ../src/guestfs-actions.pod:6701 +#: ../fish/guestfish-actions.pod:4507 ../src/guestfs-actions.pod:6959 msgid "C<device> should be a block device, for example C</dev/sda>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4423 ../src/guestfs-actions.pod:6703 +#: ../fish/guestfish-actions.pod:4509 ../src/guestfs-actions.pod:6961 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>, " @@ -14685,14 +14850,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4431 ../src/guestfs-actions.pod:6711 +#: ../fish/guestfish-actions.pod:4517 ../src/guestfs-actions.pod:6969 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:4434 ../src/guestfs-actions.pod:6714 +#: ../fish/guestfish-actions.pod:4520 ../src/guestfs-actions.pod:6972 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 " @@ -14700,24 +14865,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4438 +#: ../fish/guestfish-actions.pod:4524 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4444 ../fish/guestfish-actions.pod:4467 ../fish/guestfish-actions.pod:4489 +#: ../fish/guestfish-actions.pod:4530 ../fish/guestfish-actions.pod:4553 ../fish/guestfish-actions.pod:4575 msgid "" "I<This function is deprecated.> In new code, use the L</part_add> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4451 +#: ../fish/guestfish-actions.pod:4537 msgid "sfdiskM" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4453 +#: ../fish/guestfish-actions.pod:4539 #, no-wrap msgid "" " sfdiskM device 'lines ...'\n" @@ -14725,7 +14890,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4455 +#: ../fish/guestfish-actions.pod:4541 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 " @@ -14734,17 +14899,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4461 +#: ../fish/guestfish-actions.pod:4547 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4474 +#: ../fish/guestfish-actions.pod:4560 msgid "sfdisk-N" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4476 +#: ../fish/guestfish-actions.pod:4562 #, no-wrap msgid "" " sfdisk-N device partnum cyls heads sectors line\n" @@ -14752,31 +14917,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4478 ../src/guestfs-actions.pod:6776 +#: ../fish/guestfish-actions.pod:4564 ../src/guestfs-actions.pod:7034 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:4481 +#: ../fish/guestfish-actions.pod:4567 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:4484 +#: ../fish/guestfish-actions.pod:4570 msgid "See also: L</part-add>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4496 +#: ../fish/guestfish-actions.pod:4582 msgid "sfdisk-disk-geometry" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4498 +#: ../fish/guestfish-actions.pod:4584 #, no-wrap msgid "" " sfdisk-disk-geometry device\n" @@ -14784,7 +14949,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4500 +#: ../fish/guestfish-actions.pod:4586 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, " @@ -14793,17 +14958,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4505 ../fish/guestfish-actions.pod:4514 ../src/guestfs-actions.pod:6802 ../src/guestfs-actions.pod:6818 +#: ../fish/guestfish-actions.pod:4591 ../fish/guestfish-actions.pod:4600 ../src/guestfs-actions.pod:7060 ../src/guestfs-actions.pod:7076 msgid "The result is in human-readable format, and not designed to be parsed." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4508 +#: ../fish/guestfish-actions.pod:4594 msgid "sfdisk-kernel-geometry" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4510 +#: ../fish/guestfish-actions.pod:4596 #, no-wrap msgid "" " sfdisk-kernel-geometry device\n" @@ -14811,17 +14976,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4512 ../src/guestfs-actions.pod:6816 +#: ../fish/guestfish-actions.pod:4598 ../src/guestfs-actions.pod:7074 msgid "This displays the kernel's idea of the geometry of C<device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4517 +#: ../fish/guestfish-actions.pod:4603 msgid "sfdisk-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4519 +#: ../fish/guestfish-actions.pod:4605 #, no-wrap msgid "" " sfdisk-l device\n" @@ -14829,31 +14994,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4521 ../src/guestfs-actions.pod:6839 +#: ../fish/guestfish-actions.pod:4607 ../src/guestfs-actions.pod:7097 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:4525 +#: ../fish/guestfish-actions.pod:4611 msgid "See also: L</part-list>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4527 +#: ../fish/guestfish-actions.pod:4613 msgid "" "I<This function is deprecated.> In new code, use the L</part_list> call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4534 +#: ../fish/guestfish-actions.pod:4620 msgid "sh" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4536 +#: ../fish/guestfish-actions.pod:4622 #, no-wrap msgid "" " sh command\n" @@ -14861,19 +15026,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4538 ../src/guestfs-actions.pod:6856 +#: ../fish/guestfish-actions.pod:4624 ../src/guestfs-actions.pod:7114 msgid "" "This call runs a command from the guest filesystem via the guest's " "C</bin/sh>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4541 +#: ../fish/guestfish-actions.pod:4627 msgid "This is like L</command>, but passes the command to:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4543 ../src/guestfs-actions.pod:6861 +#: ../fish/guestfish-actions.pod:4629 ../src/guestfs-actions.pod:7119 #, no-wrap msgid "" " /bin/sh -c \"command\"\n" @@ -14881,24 +15046,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4545 ../src/guestfs-actions.pod:6863 +#: ../fish/guestfish-actions.pod:4631 ../src/guestfs-actions.pod:7121 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:4549 +#: ../fish/guestfish-actions.pod:4635 msgid "All the provisos about L</command> apply to this call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4551 +#: ../fish/guestfish-actions.pod:4637 msgid "sh-lines" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4553 +#: ../fish/guestfish-actions.pod:4639 #, no-wrap msgid "" " sh-lines command\n" @@ -14906,22 +15071,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4555 +#: ../fish/guestfish-actions.pod:4641 msgid "This is the same as L</sh>, but splits the result into a list of lines." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4558 +#: ../fish/guestfish-actions.pod:4644 msgid "See also: L</command-lines>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4560 +#: ../fish/guestfish-actions.pod:4646 msgid "sleep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4562 +#: ../fish/guestfish-actions.pod:4648 #, no-wrap msgid "" " sleep secs\n" @@ -14929,17 +15094,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4564 ../src/guestfs-actions.pod:6897 +#: ../fish/guestfish-actions.pod:4650 ../src/guestfs-actions.pod:7155 msgid "Sleep for C<secs> seconds." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4566 +#: ../fish/guestfish-actions.pod:4652 msgid "stat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4568 +#: ../fish/guestfish-actions.pod:4654 #, no-wrap msgid "" " stat path\n" @@ -14947,17 +15112,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4572 ../src/guestfs-actions.pod:6911 +#: ../fish/guestfish-actions.pod:4658 ../src/guestfs-actions.pod:7169 msgid "This is the same as the C<stat(2)> system call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4574 +#: ../fish/guestfish-actions.pod:4660 msgid "statvfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4576 +#: ../fish/guestfish-actions.pod:4662 #, no-wrap msgid "" " statvfs path\n" @@ -14965,7 +15130,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4578 ../src/guestfs-actions.pod:6925 +#: ../fish/guestfish-actions.pod:4664 ../src/guestfs-actions.pod:7183 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 " @@ -14973,17 +15138,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4582 ../src/guestfs-actions.pod:6929 +#: ../fish/guestfish-actions.pod:4668 ../src/guestfs-actions.pod:7187 msgid "This is the same as the C<statvfs(2)> system call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4584 +#: ../fish/guestfish-actions.pod:4670 msgid "strings" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4586 +#: ../fish/guestfish-actions.pod:4672 #, no-wrap msgid "" " strings path\n" @@ -14991,19 +15156,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4588 ../src/guestfs-actions.pod:6943 +#: ../fish/guestfish-actions.pod:4674 ../src/guestfs-actions.pod:7201 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:4594 +#: ../fish/guestfish-actions.pod:4680 msgid "strings-e" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4596 +#: ../fish/guestfish-actions.pod:4682 #, no-wrap msgid "" " strings-e encoding path\n" @@ -15011,93 +15176,93 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4598 +#: ../fish/guestfish-actions.pod:4684 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:4602 ../src/guestfs-actions.pod:6966 +#: ../fish/guestfish-actions.pod:4688 ../src/guestfs-actions.pod:7224 msgid "Allowed encodings are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4606 ../src/guestfs-actions.pod:6970 +#: ../fish/guestfish-actions.pod:4692 ../src/guestfs-actions.pod:7228 msgid "s" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4608 +#: ../fish/guestfish-actions.pod:4694 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:4611 ../src/guestfs-actions.pod:6975 +#: ../fish/guestfish-actions.pod:4697 ../src/guestfs-actions.pod:7233 msgid "S" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4613 ../src/guestfs-actions.pod:6977 +#: ../fish/guestfish-actions.pod:4699 ../src/guestfs-actions.pod:7235 msgid "Single 8-bit-byte characters." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4615 ../src/guestfs-actions.pod:6979 +#: ../fish/guestfish-actions.pod:4701 ../src/guestfs-actions.pod:7237 msgid "b" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4617 ../src/guestfs-actions.pod:6981 +#: ../fish/guestfish-actions.pod:4703 ../src/guestfs-actions.pod:7239 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4620 ../src/guestfs-actions.pod:6984 +#: ../fish/guestfish-actions.pod:4706 ../src/guestfs-actions.pod:7242 msgid "l (lower case letter L)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4622 ../src/guestfs-actions.pod:6986 +#: ../fish/guestfish-actions.pod:4708 ../src/guestfs-actions.pod:7244 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:4625 ../src/guestfs-actions.pod:6989 +#: ../fish/guestfish-actions.pod:4711 ../src/guestfs-actions.pod:7247 msgid "B" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4627 ../src/guestfs-actions.pod:6991 +#: ../fish/guestfish-actions.pod:4713 ../src/guestfs-actions.pod:7249 msgid "32-bit big endian such as UCS-4BE." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:4629 ../src/guestfs-actions.pod:6993 +#: ../fish/guestfish-actions.pod:4715 ../src/guestfs-actions.pod:7251 msgid "L" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4631 ../src/guestfs-actions.pod:6995 +#: ../fish/guestfish-actions.pod:4717 ../src/guestfs-actions.pod:7253 msgid "32-bit little endian such as UCS-4LE." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4635 ../src/guestfs-actions.pod:6999 +#: ../fish/guestfish-actions.pod:4721 ../src/guestfs-actions.pod:7257 msgid "The returned strings are transcoded to UTF-8." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4640 +#: ../fish/guestfish-actions.pod:4726 msgid "swapoff-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4642 +#: ../fish/guestfish-actions.pod:4728 #, no-wrap msgid "" " swapoff-device device\n" @@ -15105,19 +15270,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4644 +#: ../fish/guestfish-actions.pod:4730 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:4648 +#: ../fish/guestfish-actions.pod:4734 msgid "swapoff-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4650 +#: ../fish/guestfish-actions.pod:4736 #, no-wrap msgid "" " swapoff-file file\n" @@ -15125,17 +15290,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4652 ../src/guestfs-actions.pod:7030 +#: ../fish/guestfish-actions.pod:4738 ../src/guestfs-actions.pod:7288 msgid "This command disables the libguestfs appliance swap on file." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4654 +#: ../fish/guestfish-actions.pod:4740 msgid "swapoff-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4656 +#: ../fish/guestfish-actions.pod:4742 #, no-wrap msgid "" " swapoff-label label\n" @@ -15143,19 +15308,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4658 ../src/guestfs-actions.pod:7042 +#: ../fish/guestfish-actions.pod:4744 ../src/guestfs-actions.pod:7300 msgid "" "This command disables the libguestfs appliance swap on labeled swap " "partition." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4661 +#: ../fish/guestfish-actions.pod:4747 msgid "swapoff-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4663 +#: ../fish/guestfish-actions.pod:4749 #, no-wrap msgid "" " swapoff-uuid uuid\n" @@ -15163,19 +15328,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4665 ../src/guestfs-actions.pod:7055 +#: ../fish/guestfish-actions.pod:4751 ../src/guestfs-actions.pod:7313 msgid "" "This command disables the libguestfs appliance swap partition with the given " "UUID." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4668 +#: ../fish/guestfish-actions.pod:4754 msgid "swapon-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4670 +#: ../fish/guestfish-actions.pod:4756 #, no-wrap msgid "" " swapon-device device\n" @@ -15183,7 +15348,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4672 +#: ../fish/guestfish-actions.pod:4758 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 " @@ -15191,7 +15356,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4677 ../src/guestfs-actions.pod:7073 +#: ../fish/guestfish-actions.pod:4763 ../src/guestfs-actions.pod:7331 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 " @@ -15201,12 +15366,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4684 +#: ../fish/guestfish-actions.pod:4770 msgid "swapon-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4686 +#: ../fish/guestfish-actions.pod:4772 #, no-wrap msgid "" " swapon-file file\n" @@ -15214,17 +15379,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4688 +#: ../fish/guestfish-actions.pod:4774 msgid "This command enables swap to a file. See L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4691 +#: ../fish/guestfish-actions.pod:4777 msgid "swapon-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4693 +#: ../fish/guestfish-actions.pod:4779 #, no-wrap msgid "" " swapon-label label\n" @@ -15232,19 +15397,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4695 +#: ../fish/guestfish-actions.pod:4781 msgid "" "This command enables swap to a labeled swap partition. See " "L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4698 +#: ../fish/guestfish-actions.pod:4784 msgid "swapon-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4700 +#: ../fish/guestfish-actions.pod:4786 #, no-wrap msgid "" " swapon-uuid uuid\n" @@ -15252,19 +15417,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4702 +#: ../fish/guestfish-actions.pod:4788 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:4705 +#: ../fish/guestfish-actions.pod:4791 msgid "sync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4707 +#: ../fish/guestfish-actions.pod:4793 #, no-wrap msgid "" " sync\n" @@ -15272,26 +15437,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4709 ../src/guestfs-actions.pod:7128 +#: ../fish/guestfish-actions.pod:4795 ../src/guestfs-actions.pod:7386 msgid "" "This syncs the disk, so that any writes are flushed through to the " "underlying disk image." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4712 ../src/guestfs-actions.pod:7131 +#: ../fish/guestfish-actions.pod:4798 ../src/guestfs-actions.pod:7389 msgid "" "You should always call this if you have modified a disk image, before " "closing the handle." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4715 +#: ../fish/guestfish-actions.pod:4801 msgid "tail" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4717 +#: ../fish/guestfish-actions.pod:4803 #, no-wrap msgid "" " tail path\n" @@ -15299,17 +15464,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4719 ../src/guestfs-actions.pod:7144 +#: ../fish/guestfish-actions.pod:4805 ../src/guestfs-actions.pod:7402 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:4725 +#: ../fish/guestfish-actions.pod:4811 msgid "tail-n" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4727 +#: ../fish/guestfish-actions.pod:4813 #, no-wrap msgid "" " tail-n nrlines path\n" @@ -15317,26 +15482,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4729 ../src/guestfs-actions.pod:7163 +#: ../fish/guestfish-actions.pod:4815 ../src/guestfs-actions.pod:7421 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:4732 ../src/guestfs-actions.pod:7166 +#: ../fish/guestfish-actions.pod:4818 ../src/guestfs-actions.pod:7424 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:4740 +#: ../fish/guestfish-actions.pod:4826 msgid "tar-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4742 +#: ../fish/guestfish-actions.pod:4828 #, no-wrap msgid "" " tar-in (tarfile|-) directory\n" @@ -15344,24 +15509,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4744 ../src/guestfs-actions.pod:7187 +#: ../fish/guestfish-actions.pod:4830 ../src/guestfs-actions.pod:7445 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:4747 +#: ../fish/guestfish-actions.pod:4833 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4752 +#: ../fish/guestfish-actions.pod:4838 msgid "tar-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4754 +#: ../fish/guestfish-actions.pod:4840 #, no-wrap msgid "" " tar-out directory (tarfile|-)\n" @@ -15369,24 +15534,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4756 ../src/guestfs-actions.pod:7204 +#: ../fish/guestfish-actions.pod:4842 ../src/guestfs-actions.pod:7462 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarfile>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4759 +#: ../fish/guestfish-actions.pod:4845 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4764 +#: ../fish/guestfish-actions.pod:4850 msgid "tgz-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4766 +#: ../fish/guestfish-actions.pod:4852 #, no-wrap msgid "" " tgz-in (tarball|-) directory\n" @@ -15394,24 +15559,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4768 ../src/guestfs-actions.pod:7221 +#: ../fish/guestfish-actions.pod:4854 ../src/guestfs-actions.pod:7479 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:4771 +#: ../fish/guestfish-actions.pod:4857 msgid "To upload an uncompressed tarball, use L</tar-in>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4775 +#: ../fish/guestfish-actions.pod:4861 msgid "tgz-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4777 +#: ../fish/guestfish-actions.pod:4863 #, no-wrap msgid "" " tgz-out directory (tarball|-)\n" @@ -15419,24 +15584,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4779 ../src/guestfs-actions.pod:7237 +#: ../fish/guestfish-actions.pod:4865 ../src/guestfs-actions.pod:7495 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarball>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4782 +#: ../fish/guestfish-actions.pod:4868 msgid "To download an uncompressed tarball, use L</tar-out>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4786 +#: ../fish/guestfish-actions.pod:4872 msgid "touch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4788 +#: ../fish/guestfish-actions.pod:4874 #, no-wrap msgid "" " touch path\n" @@ -15444,7 +15609,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4790 ../src/guestfs-actions.pod:7252 +#: ../fish/guestfish-actions.pod:4876 ../src/guestfs-actions.pod:7510 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 " @@ -15452,19 +15617,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4794 ../src/guestfs-actions.pod:7256 +#: ../fish/guestfish-actions.pod:4880 ../src/guestfs-actions.pod:7514 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:4797 +#: ../fish/guestfish-actions.pod:4883 msgid "truncate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4799 +#: ../fish/guestfish-actions.pod:4885 #, no-wrap msgid "" " truncate path\n" @@ -15472,19 +15637,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4801 ../src/guestfs-actions.pod:7269 +#: ../fish/guestfish-actions.pod:4887 ../src/guestfs-actions.pod:7527 msgid "" "This command truncates C<path> to a zero-length file. The file must exist " "already." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4804 +#: ../fish/guestfish-actions.pod:4890 msgid "truncate-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4806 +#: ../fish/guestfish-actions.pod:4892 #, no-wrap msgid "" " truncate-size path size\n" @@ -15492,14 +15657,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4808 ../src/guestfs-actions.pod:7283 +#: ../fish/guestfish-actions.pod:4894 ../src/guestfs-actions.pod:7541 msgid "" "This command truncates C<path> to size C<size> bytes. The file must exist " "already." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4811 +#: ../fish/guestfish-actions.pod:4897 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 " @@ -15508,12 +15673,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4817 +#: ../fish/guestfish-actions.pod:4903 msgid "tune2fs-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4819 +#: ../fish/guestfish-actions.pod:4905 #, no-wrap msgid "" " tune2fs-l device\n" @@ -15521,14 +15686,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4821 ../src/guestfs-actions.pod:7302 +#: ../fish/guestfish-actions.pod:4907 ../src/guestfs-actions.pod:7560 msgid "" "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on " "C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4824 ../src/guestfs-actions.pod:7305 +#: ../fish/guestfish-actions.pod:4910 ../src/guestfs-actions.pod:7563 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 " @@ -15537,12 +15702,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4829 +#: ../fish/guestfish-actions.pod:4915 msgid "txz-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4831 +#: ../fish/guestfish-actions.pod:4917 #, no-wrap msgid "" " txz-in (tarball|-) directory\n" @@ -15550,19 +15715,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4833 ../src/guestfs-actions.pod:7325 +#: ../fish/guestfish-actions.pod:4919 ../src/guestfs-actions.pod:7583 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:4838 +#: ../fish/guestfish-actions.pod:4924 msgid "txz-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4840 +#: ../fish/guestfish-actions.pod:4926 #, no-wrap msgid "" " txz-out directory (tarball|-)\n" @@ -15570,19 +15735,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4842 ../src/guestfs-actions.pod:7339 +#: ../fish/guestfish-actions.pod:4928 ../src/guestfs-actions.pod:7597 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:4847 +#: ../fish/guestfish-actions.pod:4933 msgid "umask" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4849 +#: ../fish/guestfish-actions.pod:4935 #, no-wrap msgid "" " umask mask\n" @@ -15590,14 +15755,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4851 ../src/guestfs-actions.pod:7352 +#: ../fish/guestfish-actions.pod:4937 ../src/guestfs-actions.pod:7610 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:4854 ../src/guestfs-actions.pod:7355 +#: ../fish/guestfish-actions.pod:4940 ../src/guestfs-actions.pod:7613 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 " @@ -15605,7 +15770,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4859 ../src/guestfs-actions.pod:7360 +#: ../fish/guestfish-actions.pod:4945 ../src/guestfs-actions.pod:7618 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 " @@ -15613,27 +15778,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4863 +#: ../fish/guestfish-actions.pod:4949 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4866 ../src/guestfs-actions.pod:7367 +#: ../fish/guestfish-actions.pod:4952 ../src/guestfs-actions.pod:7625 msgid "This call returns the previous umask." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4868 +#: ../fish/guestfish-actions.pod:4954 msgid "umount" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4870 +#: ../fish/guestfish-actions.pod:4956 msgid "unmount" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4872 +#: ../fish/guestfish-actions.pod:4958 #, no-wrap msgid "" " umount pathordevice\n" @@ -15641,24 +15806,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4874 ../src/guestfs-actions.pod:7379 +#: ../fish/guestfish-actions.pod:4960 ../src/guestfs-actions.pod:7637 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:4878 +#: ../fish/guestfish-actions.pod:4964 msgid "umount-all" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4880 +#: ../fish/guestfish-actions.pod:4966 msgid "unmount-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4882 +#: ../fish/guestfish-actions.pod:4968 #, no-wrap msgid "" " umount-all\n" @@ -15666,22 +15831,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4884 ../src/guestfs-actions.pod:7392 +#: ../fish/guestfish-actions.pod:4970 ../src/guestfs-actions.pod:7650 msgid "This unmounts all mounted filesystems." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4886 ../src/guestfs-actions.pod:7394 +#: ../fish/guestfish-actions.pod:4972 ../src/guestfs-actions.pod:7652 msgid "Some internal mounts are not unmounted by this call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4888 +#: ../fish/guestfish-actions.pod:4974 msgid "upload" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4890 +#: ../fish/guestfish-actions.pod:4976 #, no-wrap msgid "" " upload (filename|-) remotefilename\n" @@ -15689,22 +15854,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4892 ../fish/guestfish-actions.pod:4905 ../src/guestfs-actions.pod:7407 ../src/guestfs-actions.pod:7431 +#: ../fish/guestfish-actions.pod:4978 ../fish/guestfish-actions.pod:4991 ../src/guestfs-actions.pod:7665 ../src/guestfs-actions.pod:7689 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4897 +#: ../fish/guestfish-actions.pod:4983 msgid "See also L</download>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4901 +#: ../fish/guestfish-actions.pod:4987 msgid "upload-offset" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4903 +#: ../fish/guestfish-actions.pod:4989 #, no-wrap msgid "" " upload-offset (filename|-) remotefilename offset\n" @@ -15712,7 +15877,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4908 ../src/guestfs-actions.pod:7434 +#: ../fish/guestfish-actions.pod:4994 ../src/guestfs-actions.pod:7692 msgid "" "C<remotefilename> is overwritten starting at the byte C<offset> specified. " "The intention is to overwrite parts of existing files or devices, although " @@ -15722,7 +15887,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4915 +#: ../fish/guestfish-actions.pod:5001 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 " @@ -15730,17 +15895,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4920 +#: ../fish/guestfish-actions.pod:5006 msgid "See also L</upload>, L</pwrite>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4924 +#: ../fish/guestfish-actions.pod:5010 msgid "utimens" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4926 +#: ../fish/guestfish-actions.pod:5012 #, no-wrap msgid "" " utimens path atsecs atnsecs mtsecs mtnsecs\n" @@ -15748,26 +15913,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4928 ../src/guestfs-actions.pod:7467 +#: ../fish/guestfish-actions.pod:5014 ../src/guestfs-actions.pod:7725 msgid "This command sets the timestamps of a file with nanosecond precision." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4931 ../src/guestfs-actions.pod:7470 +#: ../fish/guestfish-actions.pod:5017 ../src/guestfs-actions.pod:7728 msgid "" "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds " "from the epoch." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4934 ../src/guestfs-actions.pod:7473 +#: ../fish/guestfish-actions.pod:5020 ../src/guestfs-actions.pod:7731 msgid "" "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and " "nanoseconds from the epoch." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4937 ../src/guestfs-actions.pod:7476 +#: ../fish/guestfish-actions.pod:5023 ../src/guestfs-actions.pod:7734 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 " @@ -15775,7 +15940,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4941 ../src/guestfs-actions.pod:7480 +#: ../fish/guestfish-actions.pod:5027 ../src/guestfs-actions.pod:7738 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 " @@ -15783,12 +15948,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4945 +#: ../fish/guestfish-actions.pod:5031 msgid "version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4947 +#: ../fish/guestfish-actions.pod:5033 #, no-wrap msgid "" " version\n" @@ -15796,12 +15961,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4949 ../src/guestfs-actions.pod:7493 +#: ../fish/guestfish-actions.pod:5035 ../src/guestfs-actions.pod:7751 msgid "Return the libguestfs version number that the program is linked against." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4952 ../src/guestfs-actions.pod:7496 +#: ../fish/guestfish-actions.pod:5038 ../src/guestfs-actions.pod:7754 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 " @@ -15810,7 +15975,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4957 ../src/guestfs-actions.pod:7501 +#: ../fish/guestfish-actions.pod:5043 ../src/guestfs-actions.pod:7759 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 " @@ -15819,7 +15984,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4963 ../src/guestfs-actions.pod:7507 +#: ../fish/guestfish-actions.pod:5049 ../src/guestfs-actions.pod:7765 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 " @@ -15828,17 +15993,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4969 ../src/guestfs-actions.pod:7513 +#: ../fish/guestfish-actions.pod:5055 ../src/guestfs-actions.pod:7771 msgid "To construct the original version string: C<$major.$minor.$release$extra>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4972 ../src/guestfs-actions.pod:7516 +#: ../fish/guestfish-actions.pod:5058 ../src/guestfs-actions.pod:7774 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4974 +#: ../fish/guestfish-actions.pod:5060 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " @@ -15847,12 +16012,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4980 +#: ../fish/guestfish-actions.pod:5066 msgid "vfs-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4982 +#: ../fish/guestfish-actions.pod:5068 #, no-wrap msgid "" " vfs-label device\n" @@ -15860,27 +16025,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4984 ../src/guestfs-actions.pod:7536 +#: ../fish/guestfish-actions.pod:5070 ../src/guestfs-actions.pod:7794 msgid "This returns the filesystem label of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4987 ../src/guestfs-actions.pod:7539 +#: ../fish/guestfish-actions.pod:5073 ../src/guestfs-actions.pod:7797 msgid "If the filesystem is unlabeled, this returns the empty string." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4989 +#: ../fish/guestfish-actions.pod:5075 msgid "To find a filesystem from the label, use L</findfs-label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4991 +#: ../fish/guestfish-actions.pod:5077 msgid "vfs-type" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4993 +#: ../fish/guestfish-actions.pod:5079 #, no-wrap msgid "" " vfs-type device\n" @@ -15888,14 +16053,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4995 ../src/guestfs-actions.pod:7554 +#: ../fish/guestfish-actions.pod:5081 ../src/guestfs-actions.pod:7812 msgid "" "This command gets the filesystem type corresponding to the filesystem on " "C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4998 ../src/guestfs-actions.pod:7557 +#: ../fish/guestfish-actions.pod:5084 ../src/guestfs-actions.pod:7815 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 " @@ -15903,12 +16068,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5003 +#: ../fish/guestfish-actions.pod:5089 msgid "vfs-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5005 +#: ../fish/guestfish-actions.pod:5091 #, no-wrap msgid "" " vfs-uuid device\n" @@ -15916,27 +16081,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5007 ../src/guestfs-actions.pod:7573 +#: ../fish/guestfish-actions.pod:5093 ../src/guestfs-actions.pod:7831 msgid "This returns the filesystem UUID of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5010 ../src/guestfs-actions.pod:7576 +#: ../fish/guestfish-actions.pod:5096 ../src/guestfs-actions.pod:7834 msgid "If the filesystem does not have a UUID, this returns the empty string." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5012 +#: ../fish/guestfish-actions.pod:5098 msgid "To find a filesystem from the UUID, use L</findfs-uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5014 +#: ../fish/guestfish-actions.pod:5100 msgid "vg-activate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5016 +#: ../fish/guestfish-actions.pod:5102 #, no-wrap msgid "" " vg-activate true|false 'volgroups ...'\n" @@ -15944,31 +16109,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5018 ../src/guestfs-actions.pod:7592 +#: ../fish/guestfish-actions.pod:5104 ../src/guestfs-actions.pod:7850 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:5021 ../src/guestfs-actions.pod:7595 +#: ../fish/guestfish-actions.pod:5107 ../src/guestfs-actions.pod:7853 msgid "This command is the same as running C<vgchange -a y|n volgroups...>" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5023 ../src/guestfs-actions.pod:7597 +#: ../fish/guestfish-actions.pod:5109 ../src/guestfs-actions.pod:7855 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:5026 +#: ../fish/guestfish-actions.pod:5112 msgid "vg-activate-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5028 +#: ../fish/guestfish-actions.pod:5114 #, no-wrap msgid "" " vg-activate-all true|false\n" @@ -15976,24 +16141,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5030 ../src/guestfs-actions.pod:7610 +#: ../fish/guestfish-actions.pod:5116 ../src/guestfs-actions.pod:7868 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:5033 ../src/guestfs-actions.pod:7613 +#: ../fish/guestfish-actions.pod:5119 ../src/guestfs-actions.pod:7871 msgid "This command is the same as running C<vgchange -a y|n>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5035 +#: ../fish/guestfish-actions.pod:5121 msgid "vgcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5037 +#: ../fish/guestfish-actions.pod:5123 #, no-wrap msgid "" " vgcreate volgroup 'physvols ...'\n" @@ -16001,19 +16166,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5039 ../src/guestfs-actions.pod:7626 +#: ../fish/guestfish-actions.pod:5125 ../src/guestfs-actions.pod:7884 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:5042 +#: ../fish/guestfish-actions.pod:5128 msgid "vglvuuids" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5044 +#: ../fish/guestfish-actions.pod:5130 #, no-wrap msgid "" " vglvuuids vgname\n" @@ -16021,31 +16186,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5046 ../src/guestfs-actions.pod:7639 +#: ../fish/guestfish-actions.pod:5132 ../src/guestfs-actions.pod:7897 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:5049 +#: ../fish/guestfish-actions.pod:5135 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:5052 +#: ../fish/guestfish-actions.pod:5138 msgid "See also L</vgpvuuids>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5054 +#: ../fish/guestfish-actions.pod:5140 msgid "vgpvuuids" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5056 +#: ../fish/guestfish-actions.pod:5142 #, no-wrap msgid "" " vgpvuuids vgname\n" @@ -16053,31 +16218,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5058 ../src/guestfs-actions.pod:7659 +#: ../fish/guestfish-actions.pod:5144 ../src/guestfs-actions.pod:7917 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:5061 +#: ../fish/guestfish-actions.pod:5147 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:5064 +#: ../fish/guestfish-actions.pod:5150 msgid "See also L</vglvuuids>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5066 +#: ../fish/guestfish-actions.pod:5152 msgid "vgremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5068 +#: ../fish/guestfish-actions.pod:5154 #, no-wrap msgid "" " vgremove vgname\n" @@ -16085,22 +16250,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5070 ../src/guestfs-actions.pod:7679 +#: ../fish/guestfish-actions.pod:5156 ../src/guestfs-actions.pod:7937 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5072 ../src/guestfs-actions.pod:7681 +#: ../fish/guestfish-actions.pod:5158 ../src/guestfs-actions.pod:7939 msgid "This also forcibly removes all logical volumes in the volume group (if any)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5075 +#: ../fish/guestfish-actions.pod:5161 msgid "vgrename" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5077 +#: ../fish/guestfish-actions.pod:5163 #, no-wrap msgid "" " vgrename volgroup newvolgroup\n" @@ -16108,17 +16273,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5079 ../src/guestfs-actions.pod:7695 +#: ../fish/guestfish-actions.pod:5165 ../src/guestfs-actions.pod:7953 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5081 +#: ../fish/guestfish-actions.pod:5167 msgid "vgs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5083 +#: ../fish/guestfish-actions.pod:5169 #, no-wrap msgid "" " vgs\n" @@ -16126,31 +16291,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5085 ../src/guestfs-actions.pod:7706 +#: ../fish/guestfish-actions.pod:5171 ../src/guestfs-actions.pod:7964 msgid "" "List all the volumes groups detected. This is the equivalent of the " "L<vgs(8)> command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5088 ../src/guestfs-actions.pod:7709 +#: ../fish/guestfish-actions.pod:5174 ../src/guestfs-actions.pod:7967 msgid "" "This returns a list of just the volume group names that were detected " "(eg. C<VolGroup00>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5091 +#: ../fish/guestfish-actions.pod:5177 msgid "See also L</vgs-full>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5093 +#: ../fish/guestfish-actions.pod:5179 msgid "vgs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5095 +#: ../fish/guestfish-actions.pod:5181 #, no-wrap msgid "" " vgs-full\n" @@ -16158,19 +16323,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5097 ../src/guestfs-actions.pod:7725 +#: ../fish/guestfish-actions.pod:5183 ../src/guestfs-actions.pod:7983 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:5100 +#: ../fish/guestfish-actions.pod:5186 msgid "vgscan" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5102 +#: ../fish/guestfish-actions.pod:5188 #, no-wrap msgid "" " vgscan\n" @@ -16178,19 +16343,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5104 ../src/guestfs-actions.pod:7739 +#: ../fish/guestfish-actions.pod:5190 ../src/guestfs-actions.pod:7997 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:5107 +#: ../fish/guestfish-actions.pod:5193 msgid "vguuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5109 +#: ../fish/guestfish-actions.pod:5195 #, no-wrap msgid "" " vguuid vgname\n" @@ -16198,17 +16363,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5111 ../src/guestfs-actions.pod:7752 +#: ../fish/guestfish-actions.pod:5197 ../src/guestfs-actions.pod:8010 msgid "This command returns the UUID of the LVM VG named C<vgname>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5113 +#: ../fish/guestfish-actions.pod:5199 msgid "wc-c" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5115 +#: ../fish/guestfish-actions.pod:5201 #, no-wrap msgid "" " wc-c path\n" @@ -16216,19 +16381,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5117 ../src/guestfs-actions.pod:7792 +#: ../fish/guestfish-actions.pod:5203 ../src/guestfs-actions.pod:8050 msgid "" "This command counts the characters in a file, using the C<wc -c> external " "command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5120 +#: ../fish/guestfish-actions.pod:5206 msgid "wc-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5122 +#: ../fish/guestfish-actions.pod:5208 #, no-wrap msgid "" " wc-l path\n" @@ -16236,19 +16401,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5124 ../src/guestfs-actions.pod:7805 +#: ../fish/guestfish-actions.pod:5210 ../src/guestfs-actions.pod:8063 msgid "" "This command counts the lines in a file, using the C<wc -l> external " "command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5127 +#: ../fish/guestfish-actions.pod:5213 msgid "wc-w" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5129 +#: ../fish/guestfish-actions.pod:5215 #, no-wrap msgid "" " wc-w path\n" @@ -16256,19 +16421,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5131 ../src/guestfs-actions.pod:7818 +#: ../fish/guestfish-actions.pod:5217 ../src/guestfs-actions.pod:8076 msgid "" "This command counts the words in a file, using the C<wc -w> external " "command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5134 +#: ../fish/guestfish-actions.pod:5220 msgid "write" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5136 +#: ../fish/guestfish-actions.pod:5222 #, no-wrap msgid "" " write path content\n" @@ -16276,24 +16441,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5138 ../src/guestfs-actions.pod:7833 +#: ../fish/guestfish-actions.pod:5224 ../src/guestfs-actions.pod:8091 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:5141 +#: ../fish/guestfish-actions.pod:5227 msgid "See also L</write-append>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5146 +#: ../fish/guestfish-actions.pod:5232 msgid "write-append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5148 +#: ../fish/guestfish-actions.pod:5234 #, no-wrap msgid "" " write-append path content\n" @@ -16301,24 +16466,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5150 ../src/guestfs-actions.pod:7853 +#: ../fish/guestfish-actions.pod:5236 ../src/guestfs-actions.pod:8111 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:5153 +#: ../fish/guestfish-actions.pod:5239 msgid "See also L</write>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5158 +#: ../fish/guestfish-actions.pod:5244 msgid "write-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5160 +#: ../fish/guestfish-actions.pod:5246 #, no-wrap msgid "" " write-file path content size\n" @@ -16326,38 +16491,38 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5162 ../src/guestfs-actions.pod:7880 +#: ../fish/guestfish-actions.pod:5248 ../src/guestfs-actions.pod:8138 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:5166 ../src/guestfs-actions.pod:7884 +#: ../fish/guestfish-actions.pod:5252 ../src/guestfs-actions.pod:8142 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:5170 ../src/guestfs-actions.pod:7888 +#: ../fish/guestfish-actions.pod:5256 ../src/guestfs-actions.pod:8146 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:5176 +#: ../fish/guestfish-actions.pod:5262 msgid "I<This function is deprecated.> In new code, use the L</write> call instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5183 +#: ../fish/guestfish-actions.pod:5269 msgid "zegrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5185 +#: ../fish/guestfish-actions.pod:5271 #, no-wrap msgid "" " zegrep regex path\n" @@ -16365,17 +16530,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5187 ../src/guestfs-actions.pod:7905 +#: ../fish/guestfish-actions.pod:5273 ../src/guestfs-actions.pod:8163 msgid "This calls the external C<zegrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5193 +#: ../fish/guestfish-actions.pod:5279 msgid "zegrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5195 +#: ../fish/guestfish-actions.pod:5281 #, no-wrap msgid "" " zegrepi regex path\n" @@ -16383,17 +16548,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5197 ../src/guestfs-actions.pod:7924 +#: ../fish/guestfish-actions.pod:5283 ../src/guestfs-actions.pod:8182 msgid "This calls the external C<zegrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5203 +#: ../fish/guestfish-actions.pod:5289 msgid "zero" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5205 +#: ../fish/guestfish-actions.pod:5291 #, no-wrap msgid "" " zero device\n" @@ -16401,12 +16566,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5207 ../src/guestfs-actions.pod:7942 +#: ../fish/guestfish-actions.pod:5293 ../src/guestfs-actions.pod:8200 msgid "This command writes zeroes over the first few blocks of C<device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5209 ../src/guestfs-actions.pod:7944 +#: ../fish/guestfish-actions.pod:5295 ../src/guestfs-actions.pod:8202 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 " @@ -16414,7 +16579,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5213 ../fish/guestfish-actions.pod:5228 ../src/guestfs-actions.pod:7948 ../src/guestfs-actions.pod:7974 +#: ../fish/guestfish-actions.pod:5299 ../fish/guestfish-actions.pod:5314 ../src/guestfs-actions.pod:8206 ../src/guestfs-actions.pod:8232 msgid "" "If blocks are already zero, then this command avoids writing zeroes. This " "prevents the underlying device from becoming non-sparse or growing " @@ -16422,17 +16587,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5217 +#: ../fish/guestfish-actions.pod:5303 msgid "See also: L</zero-device>, L</scrub-device>, L</is-zero-device>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5220 +#: ../fish/guestfish-actions.pod:5306 msgid "zero-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5222 +#: ../fish/guestfish-actions.pod:5308 #, no-wrap msgid "" " zero-device device\n" @@ -16440,19 +16605,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5224 +#: ../fish/guestfish-actions.pod:5310 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:5235 +#: ../fish/guestfish-actions.pod:5321 msgid "zerofree" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5237 +#: ../fish/guestfish-actions.pod:5323 #, no-wrap msgid "" " zerofree device\n" @@ -16460,7 +16625,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5239 ../src/guestfs-actions.pod:7996 +#: ../fish/guestfish-actions.pod:5325 ../src/guestfs-actions.pod:8254 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 " @@ -16468,24 +16633,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5244 ../src/guestfs-actions.pod:8001 +#: ../fish/guestfish-actions.pod:5330 ../src/guestfs-actions.pod:8259 msgid "You should B<not> run this program if the filesystem is mounted." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5247 ../src/guestfs-actions.pod:8004 +#: ../fish/guestfish-actions.pod:5333 ../src/guestfs-actions.pod:8262 msgid "" "It is possible that using this program can damage the filesystem or data on " "the filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5250 +#: ../fish/guestfish-actions.pod:5336 msgid "zfgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5252 +#: ../fish/guestfish-actions.pod:5338 #, no-wrap msgid "" " zfgrep pattern path\n" @@ -16493,17 +16658,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5254 ../src/guestfs-actions.pod:8018 +#: ../fish/guestfish-actions.pod:5340 ../src/guestfs-actions.pod:8276 msgid "This calls the external C<zfgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5260 +#: ../fish/guestfish-actions.pod:5346 msgid "zfgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5262 +#: ../fish/guestfish-actions.pod:5348 #, no-wrap msgid "" " zfgrepi pattern path\n" @@ -16511,17 +16676,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5264 ../src/guestfs-actions.pod:8037 +#: ../fish/guestfish-actions.pod:5350 ../src/guestfs-actions.pod:8295 msgid "This calls the external C<zfgrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5270 +#: ../fish/guestfish-actions.pod:5356 msgid "zfile" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5272 +#: ../fish/guestfish-actions.pod:5358 #, no-wrap msgid "" " zfile meth path\n" @@ -16529,32 +16694,32 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5274 ../src/guestfs-actions.pod:8063 +#: ../fish/guestfish-actions.pod:5360 ../src/guestfs-actions.pod:8321 msgid "This command runs C<file> after first decompressing C<path> using C<method>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5277 ../src/guestfs-actions.pod:8066 +#: ../fish/guestfish-actions.pod:5363 ../src/guestfs-actions.pod:8324 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5279 +#: ../fish/guestfish-actions.pod:5365 msgid "Since 1.0.63, use L</file> instead which can now process compressed files." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5282 +#: ../fish/guestfish-actions.pod:5368 msgid "I<This function is deprecated.> In new code, use the L</file> call instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5289 +#: ../fish/guestfish-actions.pod:5375 msgid "zgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5291 +#: ../fish/guestfish-actions.pod:5377 #, no-wrap msgid "" " zgrep regex path\n" @@ -16562,17 +16727,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5293 ../src/guestfs-actions.pod:8083 +#: ../fish/guestfish-actions.pod:5379 ../src/guestfs-actions.pod:8341 msgid "This calls the external C<zgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5299 +#: ../fish/guestfish-actions.pod:5385 msgid "zgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5301 +#: ../fish/guestfish-actions.pod:5387 #, no-wrap msgid "" " zgrepi regex path\n" @@ -16580,7 +16745,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5303 ../src/guestfs-actions.pod:8102 +#: ../fish/guestfish-actions.pod:5389 ../src/guestfs-actions.pod:8360 msgid "This calls the external C<zgrep -i> program and returns the matching lines." msgstr "" @@ -17445,7 +17610,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:135 ../src/guestfs.pod:2228 +#: ../fish/guestfish.pod:135 ../src/guestfs.pod:2243 #, no-wrap msgid "" " guestfish -N fs\n" @@ -17831,7 +17996,7 @@ msgid "Using this flag is equivalent to using the C<mount-options> command." msgstr "" #. type: =item -#: ../fish/guestfish.pod:335 ../fuse/guestmount.pod:202 ../resize/virt-resize.pod:414 +#: ../fish/guestfish.pod:335 ../fuse/guestmount.pod:202 ../resize/virt-resize.pod:435 msgid "B<-n>" msgstr "" @@ -18912,7 +19077,7 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:825 ../src/guestfs.pod:519 +#: ../fish/guestfish.pod:825 ../src/guestfs.pod:534 msgid "ENCRYPTED DISKS" msgstr "" @@ -19276,7 +19441,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:982 ../src/guestfs.pod:965 +#: ../fish/guestfish.pod:982 ../src/guestfs.pod:980 #, no-wrap msgid "" " #!/bin/bash -\n" @@ -19562,7 +19727,7 @@ msgid "COMMANDS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1112 ../src/guestfs.pod:1505 +#: ../fish/guestfish.pod:1112 ../src/guestfs.pod:1520 msgid "@ACTIONS@" msgstr "" @@ -19586,17 +19751,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1128 ../src/guestfs.pod:3198 +#: ../fish/guestfish.pod:1128 ../src/guestfs.pod:3213 msgid "FEBOOTSTRAP_KERNEL" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1130 ../src/guestfs.pod:3200 +#: ../fish/guestfish.pod:1130 ../src/guestfs.pod:3215 msgid "FEBOOTSTRAP_MODULES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1132 ../src/guestfs.pod:3202 +#: ../fish/guestfish.pod:1132 ../src/guestfs.pod:3217 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 " @@ -19654,17 +19819,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1160 ../src/guestfs.pod:3208 +#: ../fish/guestfish.pod:1160 ../src/guestfs.pod:3223 msgid "LIBGUESTFS_APPEND" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1162 ../src/guestfs.pod:3210 +#: ../fish/guestfish.pod:1162 ../src/guestfs.pod:3225 msgid "Pass additional options to the guest kernel." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1164 ../src/guestfs.pod:3212 +#: ../fish/guestfish.pod:1164 ../src/guestfs.pod:3227 msgid "LIBGUESTFS_DEBUG" msgstr "" @@ -19676,17 +19841,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1169 ../src/guestfs.pod:3217 +#: ../fish/guestfish.pod:1169 ../src/guestfs.pod:3232 msgid "LIBGUESTFS_MEMSIZE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1171 ../src/guestfs.pod:3219 +#: ../fish/guestfish.pod:1171 ../src/guestfs.pod:3234 msgid "Set the memory allocated to the qemu process, in megabytes. For example:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1174 ../src/guestfs.pod:3222 +#: ../fish/guestfish.pod:1174 ../src/guestfs.pod:3237 #, no-wrap msgid "" " LIBGUESTFS_MEMSIZE=700\n" @@ -19694,7 +19859,7 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1176 ../src/guestfs.pod:3224 +#: ../fish/guestfish.pod:1176 ../src/guestfs.pod:3239 msgid "LIBGUESTFS_PATH" msgstr "" @@ -19706,19 +19871,19 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1181 ../src/guestfs.pod:3229 +#: ../fish/guestfish.pod:1181 ../src/guestfs.pod:3244 msgid "LIBGUESTFS_QEMU" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1183 ../src/guestfs.pod:3231 +#: ../fish/guestfish.pod:1183 ../src/guestfs.pod:3246 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:1187 ../src/guestfs.pod:3237 +#: ../fish/guestfish.pod:1187 ../src/guestfs.pod:3252 msgid "LIBGUESTFS_TRACE" msgstr "" @@ -19740,19 +19905,19 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1196 ../sparsify/virt-sparsify.pod:236 ../src/guestfs.pod:3242 +#: ../fish/guestfish.pod:1196 ../sparsify/virt-sparsify.pod:236 ../src/guestfs.pod:3257 msgid "TMPDIR" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1198 ../src/guestfs.pod:3244 +#: ../fish/guestfish.pod:1198 ../src/guestfs.pod:3259 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:1201 ../src/guestfs.pod:3247 +#: ../fish/guestfish.pod:1201 ../src/guestfs.pod:3262 msgid "" "If libguestfs was compiled to use the supermin appliance then the real " "appliance is cached in this directory, shared between all handles belonging " @@ -19897,7 +20062,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1302 ../src/guestfs.pod:3339 ../test-tool/libguestfs-test-tool.pod:112 +#: ../fish/guestfish.pod:1302 ../src/guestfs.pod:3354 ../test-tool/libguestfs-test-tool.pod:112 msgid "Copyright (C) 2009-2011 Red Hat Inc. L<http://libguestfs.org/>" msgstr "" @@ -20375,7 +20540,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../fuse/guestmount.pod:73 ../rescue/virt-rescue.pod:68 ../resize/virt-resize.pod:600 +#: ../fuse/guestmount.pod:73 ../rescue/virt-rescue.pod:68 ../resize/virt-resize.pod:621 msgid "NOTES" msgstr "" @@ -20778,7 +20943,7 @@ msgid "" msgstr "" #. type: textblock -#: ../inspector/virt-inspector.pod:111 ../resize/virt-resize.pod:370 ../resize/virt-resize.pod:462 ../sparsify/virt-sparsify.pod:132 ../tools/virt-list-filesystems.pl:101 ../tools/virt-list-partitions.pl:102 ../tools/virt-tar.pl:151 ../tools/virt-win-reg.pl:152 +#: ../inspector/virt-inspector.pod:111 ../resize/virt-resize.pod:391 ../resize/virt-resize.pod:483 ../sparsify/virt-sparsify.pod:132 ../tools/virt-list-filesystems.pl:101 ../tools/virt-list-partitions.pl:102 ../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." @@ -21940,7 +22105,7 @@ msgid "" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:31 ../resize/virt-resize.pod:576 ../sparsify/virt-sparsify.pod:203 ../src/guestfs.pod:469 ../src/guestfs.pod:1287 ../src/guestfs.pod:1426 ../src/guestfs.pod:2675 +#: ../resize/virt-resize.pod:31 ../resize/virt-resize.pod:597 ../sparsify/virt-sparsify.pod:203 ../src/guestfs.pod:484 ../src/guestfs.pod:1302 ../src/guestfs.pod:1441 ../src/guestfs.pod:2690 msgid "1." msgstr "" @@ -21978,7 +22143,7 @@ msgid "" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:44 ../resize/virt-resize.pod:583 ../sparsify/virt-sparsify.pod:210 ../src/guestfs.pod:475 ../src/guestfs.pod:1291 ../src/guestfs.pod:1430 ../src/guestfs.pod:2700 +#: ../resize/virt-resize.pod:44 ../resize/virt-resize.pod:604 ../sparsify/virt-sparsify.pod:210 ../src/guestfs.pod:490 ../src/guestfs.pod:1306 ../src/guestfs.pod:1445 ../src/guestfs.pod:2715 msgid "2." msgstr "" @@ -21999,7 +22164,7 @@ msgid "" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:52 ../resize/virt-resize.pod:589 ../sparsify/virt-sparsify.pod:216 ../src/guestfs.pod:486 ../src/guestfs.pod:1436 +#: ../resize/virt-resize.pod:52 ../resize/virt-resize.pod:610 ../sparsify/virt-sparsify.pod:216 ../src/guestfs.pod:501 ../src/guestfs.pod:1451 msgid "3." msgstr "" @@ -22425,35 +22590,78 @@ msgid "" "if=/dev/zero of=outdisk bs=1M count=..>)" msgstr "" +#. type: =head2 +#: ../resize/virt-resize.pod:241 +msgid "LOGICAL PARTITIONS" +msgstr "" + +#. type: textblock +#: ../resize/virt-resize.pod:243 +msgid "" +"Logical partitions (a.k.a. C</dev/sda5+> on disks using DOS partition " +"tables) cannot be resized." +msgstr "" + #. type: textblock -#: ../resize/virt-resize.pod:247 ../sparsify/virt-sparsify.pod:105 +#: ../resize/virt-resize.pod:246 +msgid "" +"To understand what is going on, firstly one of the four partitions " +"C</dev/sda1-4> will have MBR partition type C<05> or C<0f>. This is called " +"the B<extended partition>. Use L<virt-filesystems(1)> to see the MBR " +"partition type." +msgstr "" + +#. type: textblock +#: ../resize/virt-resize.pod:251 +msgid "Logical partitions live inside the extended partition." +msgstr "" + +#. type: textblock +#: ../resize/virt-resize.pod:253 +msgid "" +"The extended partition can be expanded, but not shrunk (unless you force it, " +"which is not advisable). When the extended partition is copied across, all " +"the logical partitions contained inside are copied over implicitly. " +"Virt-resize does not look inside the extended partition, so it copies the " +"logical partitions blindly." +msgstr "" + +#. type: textblock +#: ../resize/virt-resize.pod:259 +msgid "" +"You cannot specify a logical partition (C</dev/sda5+>) at all on the command " +"line. Doing so will give an error." +msgstr "" + +#. type: textblock +#: ../resize/virt-resize.pod:268 ../sparsify/virt-sparsify.pod:105 msgid "Display help." msgstr "" #. type: =item -#: ../resize/virt-resize.pod:249 +#: ../resize/virt-resize.pod:270 msgid "B<--align-first auto>" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:251 +#: ../resize/virt-resize.pod:272 msgid "B<--align-first never>" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:253 +#: ../resize/virt-resize.pod:274 msgid "B<--align-first always>" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:255 +#: ../resize/virt-resize.pod:276 msgid "" "Align the first partition for improved performance (see also the " "I<--alignment> option)." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:258 +#: ../resize/virt-resize.pod:279 msgid "" "The default is I<--align-first auto> which only aligns the first partition " "if it is safe to do so. That is, only when we know how to fix the " @@ -22462,14 +22670,14 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:263 +#: ../resize/virt-resize.pod:284 msgid "" "I<--align-first never> means we never move the first partition. This is the " "safest option. Try this if the guest does not boot after resizing." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:267 +#: ../resize/virt-resize.pod:288 msgid "" "I<--align-first always> means we always align the first partition (if it " "needs to be aligned). For some guests this will break the bootloader, " @@ -22477,31 +22685,31 @@ msgid "" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:271 +#: ../resize/virt-resize.pod:292 msgid "B<--alignment N>" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:273 +#: ../resize/virt-resize.pod:294 msgid "" "Set the alignment of partitions to C<N> sectors. The default in virt-resize " "E<lt> 1.13.19 was 64 sectors, and after that is 128 sectors." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:277 +#: ../resize/virt-resize.pod:298 msgid "" "Assuming 512 byte sector size inside the guest, here are some suitable " "values for this:" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:282 +#: ../resize/virt-resize.pod:303 msgid "I<--alignment 1> (512 bytes)" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:284 +#: ../resize/virt-resize.pod:305 msgid "" "The partitions would be packed together as closely as possible, but would be " "completely unaligned. In some cases this can cause very poor performance. " @@ -22509,63 +22717,63 @@ msgid "" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:288 +#: ../resize/virt-resize.pod:309 msgid "I<--alignment 8> (4K)" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:290 +#: ../resize/virt-resize.pod:311 msgid "" "This would be the minimum acceptable alignment for reasonable performance on " "modern hosts." msgstr "" #. type: =item -#: ../resize/virt-resize.pod:293 +#: ../resize/virt-resize.pod:314 msgid "I<--alignment 128> (64K)" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:295 +#: ../resize/virt-resize.pod:316 msgid "" "This alignment provides good performance when the host is using high end " "network storage." msgstr "" #. type: =item -#: ../resize/virt-resize.pod:298 +#: ../resize/virt-resize.pod:319 msgid "I<--alignment 2048> (1M)" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:300 +#: ../resize/virt-resize.pod:321 msgid "" "This is the standard alignment used by all newly installed guests since " "around 2008." msgstr "" #. type: =item -#: ../resize/virt-resize.pod:305 +#: ../resize/virt-resize.pod:326 msgid "B<-d>" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:307 ../tools/virt-make-fs.pl:177 ../tools/virt-win-reg.pl:120 +#: ../resize/virt-resize.pod:328 ../tools/virt-make-fs.pl:177 ../tools/virt-win-reg.pl:120 msgid "B<--debug>" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:309 ../tools/virt-win-reg.pl:122 +#: ../resize/virt-resize.pod:330 ../tools/virt-win-reg.pl:122 msgid "Enable debugging messages." msgstr "" #. type: =item -#: ../resize/virt-resize.pod:311 +#: ../resize/virt-resize.pod:332 msgid "B<--delete part>" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:313 +#: ../resize/virt-resize.pod:334 msgid "" "Delete the named partition. It would be more accurate to describe this as " "\"don't copy it over\", since virt-resize doesn't do in-place changes and " @@ -22573,7 +22781,7 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:317 +#: ../resize/virt-resize.pod:338 msgid "" "Note that when you delete a partition, then anything contained in the " "partition is also deleted. Furthermore, this causes any partitions that " @@ -22581,24 +22789,24 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:322 ../resize/virt-resize.pod:383 ../resize/virt-resize.pod:510 ../sparsify/virt-sparsify.pod:145 +#: ../resize/virt-resize.pod:343 ../resize/virt-resize.pod:404 ../resize/virt-resize.pod:531 ../sparsify/virt-sparsify.pod:145 msgid "You can give this option multiple times." msgstr "" #. type: =item -#: ../resize/virt-resize.pod:324 +#: ../resize/virt-resize.pod:345 msgid "B<--expand part>" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:326 +#: ../resize/virt-resize.pod:347 msgid "" "Expand the named partition so it uses up all extra space (space left over " "after any other resize changes that you request have been done)." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:329 +#: ../resize/virt-resize.pod:350 msgid "" "If virt-resize knows how, it will expand the direct content of the " "partition. For example, if the partition is an LVM PV, it will expand the " @@ -22607,22 +22815,22 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:334 +#: ../resize/virt-resize.pod:355 msgid "Currently virt-resize can resize:" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:340 +#: ../resize/virt-resize.pod:361 msgid "ext2, ext3 and ext4 filesystems." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:344 +#: ../resize/virt-resize.pod:365 msgid "NTFS filesystems, if libguestfs was compiled with support for NTFS." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:346 +#: ../resize/virt-resize.pod:367 msgid "" "The filesystem must have been shut down consistently last time it was used. " "Additionally, L<ntfsresize(8)> marks the resized filesystem as requiring a " @@ -22631,7 +22839,7 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:353 +#: ../resize/virt-resize.pod:374 msgid "" "LVM PVs (physical volumes). virt-resize does not usually resize anything " "inside the PV, but see the I<--LV-expand> option. The user could also " @@ -22639,41 +22847,41 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:359 +#: ../resize/virt-resize.pod:380 msgid "Btrfs filesystems, if libguestfs was compiled with support for btrfs." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:363 ../resize/virt-resize.pod:538 +#: ../resize/virt-resize.pod:384 ../resize/virt-resize.pod:559 msgid "Note that you cannot use I<--expand> and I<--shrink> together." msgstr "" #. type: =item -#: ../resize/virt-resize.pod:365 ../sparsify/virt-sparsify.pod:125 ../tools/virt-list-filesystems.pl:91 ../tools/virt-list-partitions.pl:92 ../tools/virt-tar.pl:141 ../tools/virt-win-reg.pl:142 +#: ../resize/virt-resize.pod:386 ../sparsify/virt-sparsify.pod:125 ../tools/virt-list-filesystems.pl:91 ../tools/virt-list-partitions.pl:92 ../tools/virt-tar.pl:141 ../tools/virt-win-reg.pl:142 msgid "B<--format> raw" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:367 ../sparsify/virt-sparsify.pod:129 +#: ../resize/virt-resize.pod:388 ../sparsify/virt-sparsify.pod:129 msgid "" "Specify the format of the input disk image. If this flag is not given then " "it is auto-detected from the image itself." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:373 +#: ../resize/virt-resize.pod:394 msgid "" "Note that this option I<does not> affect the output format. See L</QCOW2 " "AND NON-SPARSE RAW FORMATS>." msgstr "" #. type: =item -#: ../resize/virt-resize.pod:376 +#: ../resize/virt-resize.pod:397 msgid "B<--ignore part>" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:378 +#: ../resize/virt-resize.pod:399 msgid "" "Ignore the named partition. Effectively this means the partition is " "allocated on the destination disk, but the content is not copied across from " @@ -22682,12 +22890,12 @@ msgid "" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:385 +#: ../resize/virt-resize.pod:406 msgid "B<--LV-expand logvol>" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:387 +#: ../resize/virt-resize.pod:408 msgid "" "This takes the logical volume and, as a final step, expands it to fill all " "the space available in its volume group. A typical usage, assuming a Linux " @@ -22696,7 +22904,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../resize/virt-resize.pod:392 +#: ../resize/virt-resize.pod:413 #, no-wrap msgid "" " virt-resize indisk outdisk \\\n" @@ -22705,14 +22913,14 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:395 +#: ../resize/virt-resize.pod:416 msgid "" "This would first expand the partition (and PV), and then expand the root " "device to fill the extra space in the PV." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:398 +#: ../resize/virt-resize.pod:419 msgid "" "The contents of the LV are also resized if virt-resize knows how to do " "that. You can stop virt-resize from trying to expand the content by using " @@ -22720,12 +22928,12 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:402 +#: ../resize/virt-resize.pod:423 msgid "Use L<virt-filesystems(1)> to list the filesystems in the guest." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:404 +#: ../resize/virt-resize.pod:425 msgid "" "You can give this option multiple times, I<but> it doesn't make sense to do " "this unless the logical volumes you specify are all in different volume " @@ -22733,34 +22941,34 @@ msgid "" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:408 ../sparsify/virt-sparsify.pod:147 +#: ../resize/virt-resize.pod:429 ../sparsify/virt-sparsify.pod:147 msgid "B<--machine-readable>" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:410 ../sparsify/virt-sparsify.pod:149 +#: ../resize/virt-resize.pod:431 ../sparsify/virt-sparsify.pod:149 msgid "" "This option is used to make the output more machine friendly when being " "parsed by other programs. See L</MACHINE READABLE OUTPUT> below." msgstr "" #. type: =item -#: ../resize/virt-resize.pod:416 +#: ../resize/virt-resize.pod:437 msgid "B<--dryrun>" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:418 +#: ../resize/virt-resize.pod:439 msgid "Print a summary of what would be done, but don't do anything." msgstr "" #. type: =item -#: ../resize/virt-resize.pod:420 +#: ../resize/virt-resize.pod:441 msgid "B<--no-copy-boot-loader>" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:422 +#: ../resize/virt-resize.pod:443 msgid "" "By default, virt-resize copies over some sectors at the start of the disk " "(up to the beginning of the first partition). Commonly these sectors " @@ -22769,19 +22977,19 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:427 +#: ../resize/virt-resize.pod:448 msgid "" "If you specify this flag, then this initial copy is not done. You may need " "to reinstall the boot loader in this case." msgstr "" #. type: =item -#: ../resize/virt-resize.pod:430 +#: ../resize/virt-resize.pod:451 msgid "B<--no-extra-partition>" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:432 +#: ../resize/virt-resize.pod:453 msgid "" "By default, virt-resize creates an extra partition if there is any extra, " "unused space after all resizing has happened. Use this option to prevent " @@ -22791,38 +22999,38 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:438 +#: ../resize/virt-resize.pod:459 msgid "" "Note that if the surplus space is smaller than 10 MB, no extra partition " "will be created." msgstr "" #. type: =item -#: ../resize/virt-resize.pod:441 +#: ../resize/virt-resize.pod:462 msgid "B<--no-expand-content>" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:443 +#: ../resize/virt-resize.pod:464 msgid "" "By default, virt-resize will try to expand the direct contents of " "partitions, if it knows how (see I<--expand> option above)." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:446 +#: ../resize/virt-resize.pod:467 msgid "" "If you give the I<--no-expand-content> option then virt-resize will not " "attempt this." msgstr "" #. type: =item -#: ../resize/virt-resize.pod:449 +#: ../resize/virt-resize.pod:470 msgid "B<--ntfsresize-force>" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:451 +#: ../resize/virt-resize.pod:472 msgid "" "Pass the I<--force> option to L<ntfsresize(8)>, allowing resizing even if " "the NTFS disk is marked as needing a consistency check. You have to use " @@ -22831,19 +23039,19 @@ msgid "" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:457 +#: ../resize/virt-resize.pod:478 msgid "B<--output-format> raw" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:459 +#: ../resize/virt-resize.pod:480 msgid "" "Specify the format of the output disk image. If this flag is not given then " "it is auto-detected from the image itself." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:465 +#: ../resize/virt-resize.pod:486 msgid "" "Note that this option I<does not create> the output format. This option " "just tells libguestfs what it is so it doesn't try to guess it. You still " @@ -22852,24 +23060,24 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:474 +#: ../resize/virt-resize.pod:495 msgid "Don't print the summary." msgstr "" #. type: =item -#: ../resize/virt-resize.pod:476 +#: ../resize/virt-resize.pod:497 msgid "B<--resize part=size>" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:478 +#: ../resize/virt-resize.pod:499 msgid "" "Resize the named partition (expanding or shrinking it) so that it has the " "given size." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:481 +#: ../resize/virt-resize.pod:502 msgid "" "C<size> can be expressed as an absolute number followed by b/K/M/G to mean " "bytes, Kilobytes, Megabytes, or Gigabytes; or as a percentage of the current " @@ -22877,7 +23085,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../resize/virt-resize.pod:487 +#: ../resize/virt-resize.pod:508 #, no-wrap msgid "" " --resize /dev/sda2=10G\n" @@ -22885,7 +23093,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../resize/virt-resize.pod:489 +#: ../resize/virt-resize.pod:510 #, no-wrap msgid "" " --resize /dev/sda4=90%\n" @@ -22893,7 +23101,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../resize/virt-resize.pod:491 +#: ../resize/virt-resize.pod:512 #, no-wrap msgid "" " --resize /dev/sda2=+1G\n" @@ -22901,7 +23109,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../resize/virt-resize.pod:493 +#: ../resize/virt-resize.pod:514 #, no-wrap msgid "" " --resize /dev/sda2=-200M\n" @@ -22909,7 +23117,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../resize/virt-resize.pod:495 +#: ../resize/virt-resize.pod:516 #, no-wrap msgid "" " --resize /dev/sda1=+128K\n" @@ -22917,7 +23125,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../resize/virt-resize.pod:497 +#: ../resize/virt-resize.pod:518 #, no-wrap msgid "" " --resize /dev/sda1=+10%\n" @@ -22925,7 +23133,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../resize/virt-resize.pod:499 +#: ../resize/virt-resize.pod:520 #, no-wrap msgid "" " --resize /dev/sda1=-10%\n" @@ -22933,14 +23141,14 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:501 +#: ../resize/virt-resize.pod:522 msgid "" "You can increase the size of any partition. Virt-resize will expand the " "direct content of the partition if it knows how (see I<--expand> below)." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:505 +#: ../resize/virt-resize.pod:526 msgid "" "You can only I<decrease> the size of partitions that contain filesystems or " "PVs which have already been shrunk. Virt-resize will check this has been " @@ -22949,12 +23157,12 @@ msgid "" msgstr "" #. type: =item -#: ../resize/virt-resize.pod:512 +#: ../resize/virt-resize.pod:533 msgid "B<--resize-force part=size>" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:514 +#: ../resize/virt-resize.pod:535 msgid "" "This is the same as I<--resize> except that it will let you decrease the " "size of any partition. Generally this means you will lose any data which " @@ -22964,17 +23172,17 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:520 +#: ../resize/virt-resize.pod:541 msgid "See also the I<--ignore> option." msgstr "" #. type: =item -#: ../resize/virt-resize.pod:522 +#: ../resize/virt-resize.pod:543 msgid "B<--shrink part>" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:524 +#: ../resize/virt-resize.pod:545 msgid "" "Shrink the named partition until the overall disk image fits in the " "destination. The named partition B<must> contain a filesystem or PV which " @@ -22984,7 +23192,7 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:530 +#: ../resize/virt-resize.pod:551 msgid "" "The amount by which the overall disk must be shrunk (after carrying out all " "other operations requested by the user) is called the \"deficit\". For " @@ -22995,12 +23203,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../resize/virt-resize.pod:548 ../sparsify/virt-sparsify.pod:177 +#: ../resize/virt-resize.pod:569 ../sparsify/virt-sparsify.pod:177 msgid "MACHINE READABLE OUTPUT" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:550 +#: ../resize/virt-resize.pod:571 msgid "" "The I<--machine-readable> option can be used to make the output more machine " "friendly, which is useful when calling virt-resize from other programs, GUIs " @@ -23008,19 +23216,19 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:554 ../sparsify/virt-sparsify.pod:183 +#: ../resize/virt-resize.pod:575 ../sparsify/virt-sparsify.pod:183 msgid "There are two ways to use this option." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:556 +#: ../resize/virt-resize.pod:577 msgid "" "Firstly use the option on its own to query the capabilities of the " "virt-resize binary. Typical output looks like this:" msgstr "" #. type: verbatim -#: ../resize/virt-resize.pod:559 +#: ../resize/virt-resize.pod:580 #, no-wrap msgid "" " $ virt-resize --machine-readable\n" @@ -23033,33 +23241,33 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:566 ../sparsify/virt-sparsify.pod:193 +#: ../resize/virt-resize.pod:587 ../sparsify/virt-sparsify.pod:193 msgid "" "A list of features is printed, one per line, and the program exits with " "status 0." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:569 ../sparsify/virt-sparsify.pod:196 +#: ../resize/virt-resize.pod:590 ../sparsify/virt-sparsify.pod:196 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:572 ../sparsify/virt-sparsify.pod:199 +#: ../resize/virt-resize.pod:593 ../sparsify/virt-sparsify.pod:199 msgid "At the moment this means:" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:578 ../sparsify/virt-sparsify.pod:205 +#: ../resize/virt-resize.pod:599 ../sparsify/virt-sparsify.pod:205 msgid "" "Progress bar messages can be parsed from stdout by looking for this regular " "expression:" msgstr "" #. type: verbatim -#: ../resize/virt-resize.pod:581 ../sparsify/virt-sparsify.pod:208 +#: ../resize/virt-resize.pod:602 ../sparsify/virt-sparsify.pod:208 #, no-wrap msgid "" " ^[0-9]+/[0-9]+$\n" @@ -23067,7 +23275,7 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:585 ../sparsify/virt-sparsify.pod:212 +#: ../resize/virt-resize.pod:606 ../sparsify/virt-sparsify.pod:212 msgid "" "The calling program should treat messages sent to stdout (except for " "progress bar messages) as status messages. They can be logged and/or " @@ -23075,7 +23283,7 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:591 +#: ../resize/virt-resize.pod:612 msgid "" "The calling program should treat messages sent to stderr as error messages. " "In addition, virt-resize exits with a non-zero status code if there was a " @@ -23083,19 +23291,19 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:597 +#: ../resize/virt-resize.pod:618 msgid "" "Versions of the program prior to 1.13.9 did not support the " "I<--machine-readable> option and will return an error." msgstr "" #. type: =head2 -#: ../resize/virt-resize.pod:602 +#: ../resize/virt-resize.pod:623 msgid "\"Partition 1 does not end on cylinder boundary.\"" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:604 +#: ../resize/virt-resize.pod:625 msgid "" "Virt-resize aligns partitions to multiples of 128 sectors (see the " "I<--alignment> parameter). Usually this means the partitions will not be " @@ -23106,12 +23314,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../resize/virt-resize.pod:611 +#: ../resize/virt-resize.pod:632 msgid "RESIZING WINDOWS VIRTUAL MACHINES" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:613 +#: ../resize/virt-resize.pod:634 msgid "" "In Windows Vista and later versions, Microsoft switched to using a separate " "boot partition. In these VMs, typically C</dev/sda1> is the boot partition " @@ -23121,7 +23329,7 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:620 +#: ../resize/virt-resize.pod:641 msgid "" "Windows may initiate a lengthy \"chkdsk\" on first boot after a resize, if " "NTFS partitions have been expanded. This is just a safety check and (unless " @@ -23129,19 +23337,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../resize/virt-resize.pod:624 +#: ../resize/virt-resize.pod:645 msgid "GUEST BOOT STUCK AT \"GRUB\"" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:626 +#: ../resize/virt-resize.pod:647 msgid "" "If a Linux guest does not boot after resizing, and the boot is stuck after " "printing C<GRUB> on the console, try reinstalling grub." msgstr "" #. type: verbatim -#: ../resize/virt-resize.pod:629 +#: ../resize/virt-resize.pod:650 #, no-wrap msgid "" " guestfish -i -a newdisk\n" @@ -23154,26 +23362,26 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:636 +#: ../resize/virt-resize.pod:657 msgid "" "For more flexible guest reconfiguration, including if you need to specify " "other parameters to grub-install, use L<virt-rescue(1)>." msgstr "" #. type: =head1 -#: ../resize/virt-resize.pod:639 +#: ../resize/virt-resize.pod:660 msgid "ALTERNATIVE TOOLS" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:641 +#: ../resize/virt-resize.pod:662 msgid "" "There are several proprietary tools for resizing partitions. We won't " "mention any here." msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:644 +#: ../resize/virt-resize.pod:665 msgid "" "L<parted(8)> and its graphical shell gparted can do some types of resizing " "operations on disk images. They can resize and move partitions, but I don't " @@ -23182,7 +23390,7 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:649 +#: ../resize/virt-resize.pod:670 msgid "" "L<guestfish(1)> can do everything that virt-resize can do and a lot more, " "but at a much lower level. You will probably end up hand-calculating sector " @@ -23192,7 +23400,7 @@ msgid "" msgstr "" #. type: textblock -#: ../resize/virt-resize.pod:669 +#: ../resize/virt-resize.pod:690 msgid "" "L<virt-filesystems(1)>, L<virt-df(1)>, L<guestfs(3)>, L<guestfish(1)>, " "L<lvm(8)>, L<pvresize(8)>, L<lvresize(8)>, L<resize2fs(8)>, " @@ -23589,12 +23797,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:37 ../src/guestfs-actions.pod:140 ../src/guestfs-actions.pod:207 ../src/guestfs-actions.pod:244 ../src/guestfs-actions.pod:265 ../src/guestfs-actions.pod:286 ../src/guestfs-actions.pod:299 ../src/guestfs-actions.pod:313 ../src/guestfs-actions.pod:433 ../src/guestfs-actions.pod:453 ../src/guestfs-actions.pod:467 ../src/guestfs-actions.pod:512 ../src/guestfs-actions.pod:540 ../src/guestfs-actions.pod:558 ../src/guestfs-actions.pod:625 ../src/guestfs-actions.pod:658 ../src/guestfs-actions.pod:672 ../src/guestfs-actions.pod:687 ../src/guestfs-actions.pod:786 ../src/guestfs-actions.pod:804 ../src/guestfs-actions.pod:818 ../src/guestfs-actions.pod:832 ../src/guestfs-actions.pod:869 ../src/guestfs-actions.pod:1052 ../src/guestfs-actions.pod:1072 ../src/guestfs-actions.pod:1090 ../src/guestfs-actions.pod:1180 ../src/guestfs-actions.pod:1239 ../src/guestfs-actions.pod:1285 ../src/guestfs-actions.pod:1303 ../src/guestfs-actions.pod:1322 ../src/guestfs-actions.pod:1336 ../src/guestfs-actions.pod:1356 ../src/guestfs-actions.pod:1426 ../src/guestfs-actions.pod:1457 ../src/guestfs-actions.pod:1482 ../src/guestfs-actions.pod:1524 ../src/guestfs-actions.pod:1637 ../src/guestfs-actions.pod:1664 ../src/guestfs-actions.pod:1879 ../src/guestfs-actions.pod:1901 ../src/guestfs-actions.pod:1988 ../src/guestfs-actions.pod:2496 ../src/guestfs-actions.pod:2640 ../src/guestfs-actions.pod:2701 ../src/guestfs-actions.pod:2736 ../src/guestfs-actions.pod:3793 ../src/guestfs-actions.pod:3808 ../src/guestfs-actions.pod:3833 ../src/guestfs-actions.pod:4022 ../src/guestfs-actions.pod:4036 ../src/guestfs-actions.pod:4049 ../src/guestfs-actions.pod:4063 ../src/guestfs-actions.pod:4078 ../src/guestfs-actions.pod:4114 ../src/guestfs-actions.pod:4186 ../src/guestfs-actions.pod:4206 ../src/guestfs-actions.pod:4223 ../src/guestfs-actions.pod:4246 ../src/guestfs-actions.pod:4269 ../src/guestfs-actions.pod:4304 ../src/guestfs-actions.pod:4323 ../src/guestfs-actions.pod:4342 ../src/guestfs-actions.pod:4377 ../src/guestfs-actions.pod:4389 ../src/guestfs-actions.pod:4425 ../src/guestfs-actions.pod:4441 ../src/guestfs-actions.pod:4454 ../src/guestfs-actions.pod:4469 ../src/guestfs-actions.pod:4486 ../src/guestfs-actions.pod:4579 ../src/guestfs-actions.pod:4599 ../src/guestfs-actions.pod:4612 ../src/guestfs-actions.pod:4663 ../src/guestfs-actions.pod:4681 ../src/guestfs-actions.pod:4699 ../src/guestfs-actions.pod:4715 ../src/guestfs-actions.pod:4729 ../src/guestfs-actions.pod:4743 ../src/guestfs-actions.pod:4760 ../src/guestfs-actions.pod:4775 ../src/guestfs-actions.pod:4802 ../src/guestfs-actions.pod:4865 ../src/guestfs-actions.pod:4938 ../src/guestfs-actions.pod:4969 ../src/guestfs-actions.pod:4988 ../src/guestfs-actions.pod:5007 ../src/guestfs-actions.pod:5019 ../src/guestfs-actions.pod:5036 ../src/guestfs-actions.pod:5049 ../src/guestfs-actions.pod:5064 ../src/guestfs-actions.pod:5079 ../src/guestfs-actions.pod:5111 ../src/guestfs-actions.pod:5137 ../src/guestfs-actions.pod:5176 ../src/guestfs-actions.pod:5196 ../src/guestfs-actions.pod:5210 ../src/guestfs-actions.pod:5227 ../src/guestfs-actions.pod:5276 ../src/guestfs-actions.pod:5329 ../src/guestfs-actions.pod:5376 ../src/guestfs-actions.pod:5419 ../src/guestfs-actions.pod:5447 ../src/guestfs-actions.pod:5464 ../src/guestfs-actions.pod:5482 ../src/guestfs-actions.pod:5622 ../src/guestfs-actions.pod:5679 ../src/guestfs-actions.pod:5701 ../src/guestfs-actions.pod:5719 ../src/guestfs-actions.pod:5751 ../src/guestfs-actions.pod:5817 ../src/guestfs-actions.pod:5834 ../src/guestfs-actions.pod:5847 ../src/guestfs-actions.pod:5861 ../src/guestfs-actions.pod:6150 ../src/guestfs-actions.pod:6169 ../src/guestfs-actions.pod:6188 ../src/guestfs-actions.pod:6202 ../src/guestfs-actions.pod:6214 ../src/guestfs-actions.pod:6228 ../src/guestfs-actions.pod:6240 ../src/guestfs-actions.pod:6254 ../src/guestfs-actions.pod:6270 ../src/guestfs-actions.pod:6291 ../src/guestfs-actions.pod:6310 ../src/guestfs-actions.pod:6329 ../src/guestfs-actions.pod:6359 ../src/guestfs-actions.pod:6377 ../src/guestfs-actions.pod:6400 ../src/guestfs-actions.pod:6418 ../src/guestfs-actions.pod:6437 ../src/guestfs-actions.pod:6458 ../src/guestfs-actions.pod:6477 ../src/guestfs-actions.pod:6494 ../src/guestfs-actions.pod:6513 ../src/guestfs-actions.pod:6541 ../src/guestfs-actions.pod:6565 ../src/guestfs-actions.pod:6584 ../src/guestfs-actions.pod:6600 ../src/guestfs-actions.pod:6624 ../src/guestfs-actions.pod:6643 ../src/guestfs-actions.pod:6658 ../src/guestfs-actions.pod:6677 ../src/guestfs-actions.pod:6721 ../src/guestfs-actions.pod:6751 ../src/guestfs-actions.pod:6784 ../src/guestfs-actions.pod:6899 ../src/guestfs-actions.pod:7020 ../src/guestfs-actions.pod:7032 ../src/guestfs-actions.pod:7045 ../src/guestfs-actions.pod:7058 ../src/guestfs-actions.pod:7080 ../src/guestfs-actions.pod:7093 ../src/guestfs-actions.pod:7106 ../src/guestfs-actions.pod:7119 ../src/guestfs-actions.pod:7134 ../src/guestfs-actions.pod:7193 ../src/guestfs-actions.pod:7210 ../src/guestfs-actions.pod:7226 ../src/guestfs-actions.pod:7242 ../src/guestfs-actions.pod:7259 ../src/guestfs-actions.pod:7272 ../src/guestfs-actions.pod:7292 ../src/guestfs-actions.pod:7328 ../src/guestfs-actions.pod:7342 ../src/guestfs-actions.pod:7383 ../src/guestfs-actions.pod:7396 ../src/guestfs-actions.pod:7414 ../src/guestfs-actions.pod:7448 ../src/guestfs-actions.pod:7484 ../src/guestfs-actions.pod:7600 ../src/guestfs-actions.pod:7615 ../src/guestfs-actions.pod:7629 ../src/guestfs-actions.pod:7684 ../src/guestfs-actions.pod:7697 ../src/guestfs-actions.pod:7742 ../src/guestfs-actions.pod:7782 ../src/guestfs-actions.pod:7838 ../src/guestfs-actions.pod:7858 ../src/guestfs-actions.pod:7891 ../src/guestfs-actions.pod:7955 ../src/guestfs-actions.pod:7978 ../src/guestfs-actions.pod:8007 +#: ../src/guestfs-actions.pod:37 ../src/guestfs-actions.pod:140 ../src/guestfs-actions.pod:207 ../src/guestfs-actions.pod:244 ../src/guestfs-actions.pod:265 ../src/guestfs-actions.pod:286 ../src/guestfs-actions.pod:299 ../src/guestfs-actions.pod:313 ../src/guestfs-actions.pod:433 ../src/guestfs-actions.pod:453 ../src/guestfs-actions.pod:467 ../src/guestfs-actions.pod:512 ../src/guestfs-actions.pod:540 ../src/guestfs-actions.pod:558 ../src/guestfs-actions.pod:625 ../src/guestfs-actions.pod:658 ../src/guestfs-actions.pod:672 ../src/guestfs-actions.pod:687 ../src/guestfs-actions.pod:786 ../src/guestfs-actions.pod:804 ../src/guestfs-actions.pod:818 ../src/guestfs-actions.pod:832 ../src/guestfs-actions.pod:869 ../src/guestfs-actions.pod:1052 ../src/guestfs-actions.pod:1072 ../src/guestfs-actions.pod:1090 ../src/guestfs-actions.pod:1180 ../src/guestfs-actions.pod:1239 ../src/guestfs-actions.pod:1285 ../src/guestfs-actions.pod:1325 ../src/guestfs-actions.pod:1376 ../src/guestfs-actions.pod:1427 ../src/guestfs-actions.pod:1483 ../src/guestfs-actions.pod:1535 ../src/guestfs-actions.pod:1554 ../src/guestfs-actions.pod:1568 ../src/guestfs-actions.pod:1596 ../src/guestfs-actions.pod:1666 ../src/guestfs-actions.pod:1697 ../src/guestfs-actions.pod:1722 ../src/guestfs-actions.pod:1764 ../src/guestfs-actions.pod:1877 ../src/guestfs-actions.pod:1904 ../src/guestfs-actions.pod:2119 ../src/guestfs-actions.pod:2141 ../src/guestfs-actions.pod:2228 ../src/guestfs-actions.pod:2736 ../src/guestfs-actions.pod:2880 ../src/guestfs-actions.pod:2941 ../src/guestfs-actions.pod:2976 ../src/guestfs-actions.pod:4033 ../src/guestfs-actions.pod:4048 ../src/guestfs-actions.pod:4073 ../src/guestfs-actions.pod:4262 ../src/guestfs-actions.pod:4276 ../src/guestfs-actions.pod:4289 ../src/guestfs-actions.pod:4303 ../src/guestfs-actions.pod:4318 ../src/guestfs-actions.pod:4354 ../src/guestfs-actions.pod:4426 ../src/guestfs-actions.pod:4446 ../src/guestfs-actions.pod:4463 ../src/guestfs-actions.pod:4486 ../src/guestfs-actions.pod:4509 ../src/guestfs-actions.pod:4544 ../src/guestfs-actions.pod:4563 ../src/guestfs-actions.pod:4582 ../src/guestfs-actions.pod:4617 ../src/guestfs-actions.pod:4629 ../src/guestfs-actions.pod:4665 ../src/guestfs-actions.pod:4681 ../src/guestfs-actions.pod:4694 ../src/guestfs-actions.pod:4709 ../src/guestfs-actions.pod:4726 ../src/guestfs-actions.pod:4819 ../src/guestfs-actions.pod:4839 ../src/guestfs-actions.pod:4852 ../src/guestfs-actions.pod:4903 ../src/guestfs-actions.pod:4921 ../src/guestfs-actions.pod:4939 ../src/guestfs-actions.pod:4955 ../src/guestfs-actions.pod:4969 ../src/guestfs-actions.pod:4983 ../src/guestfs-actions.pod:5000 ../src/guestfs-actions.pod:5015 ../src/guestfs-actions.pod:5042 ../src/guestfs-actions.pod:5105 ../src/guestfs-actions.pod:5178 ../src/guestfs-actions.pod:5209 ../src/guestfs-actions.pod:5228 ../src/guestfs-actions.pod:5247 ../src/guestfs-actions.pod:5259 ../src/guestfs-actions.pod:5276 ../src/guestfs-actions.pod:5289 ../src/guestfs-actions.pod:5304 ../src/guestfs-actions.pod:5319 ../src/guestfs-actions.pod:5351 ../src/guestfs-actions.pod:5377 ../src/guestfs-actions.pod:5416 ../src/guestfs-actions.pod:5436 ../src/guestfs-actions.pod:5450 ../src/guestfs-actions.pod:5467 ../src/guestfs-actions.pod:5516 ../src/guestfs-actions.pod:5569 ../src/guestfs-actions.pod:5616 ../src/guestfs-actions.pod:5659 ../src/guestfs-actions.pod:5687 ../src/guestfs-actions.pod:5704 ../src/guestfs-actions.pod:5722 ../src/guestfs-actions.pod:5862 ../src/guestfs-actions.pod:5919 ../src/guestfs-actions.pod:5941 ../src/guestfs-actions.pod:5959 ../src/guestfs-actions.pod:6009 ../src/guestfs-actions.pod:6075 ../src/guestfs-actions.pod:6092 ../src/guestfs-actions.pod:6105 ../src/guestfs-actions.pod:6119 ../src/guestfs-actions.pod:6408 ../src/guestfs-actions.pod:6427 ../src/guestfs-actions.pod:6446 ../src/guestfs-actions.pod:6460 ../src/guestfs-actions.pod:6472 ../src/guestfs-actions.pod:6486 ../src/guestfs-actions.pod:6498 ../src/guestfs-actions.pod:6512 ../src/guestfs-actions.pod:6528 ../src/guestfs-actions.pod:6549 ../src/guestfs-actions.pod:6568 ../src/guestfs-actions.pod:6587 ../src/guestfs-actions.pod:6617 ../src/guestfs-actions.pod:6635 ../src/guestfs-actions.pod:6658 ../src/guestfs-actions.pod:6676 ../src/guestfs-actions.pod:6695 ../src/guestfs-actions.pod:6716 ../src/guestfs-actions.pod:6735 ../src/guestfs-actions.pod:6752 ../src/guestfs-actions.pod:6771 ../src/guestfs-actions.pod:6799 ../src/guestfs-actions.pod:6823 ../src/guestfs-actions.pod:6842 ../src/guestfs-actions.pod:6858 ../src/guestfs-actions.pod:6882 ../src/guestfs-actions.pod:6901 ../src/guestfs-actions.pod:6916 ../src/guestfs-actions.pod:6935 ../src/guestfs-actions.pod:6979 ../src/guestfs-actions.pod:7009 ../src/guestfs-actions.pod:7042 ../src/guestfs-actions.pod:7157 ../src/guestfs-actions.pod:7278 ../src/guestfs-actions.pod:7290 ../src/guestfs-actions.pod:7303 ../src/guestfs-actions.pod:7316 ../src/guestfs-actions.pod:7338 ../src/guestfs-actions.pod:7351 ../src/guestfs-actions.pod:7364 ../src/guestfs-actions.pod:7377 ../src/guestfs-actions.pod:7392 ../src/guestfs-actions.pod:7451 ../src/guestfs-actions.pod:7468 ../src/guestfs-actions.pod:7484 ../src/guestfs-actions.pod:7500 ../src/guestfs-actions.pod:7517 ../src/guestfs-actions.pod:7530 ../src/guestfs-actions.pod:7550 ../src/guestfs-actions.pod:7586 ../src/guestfs-actions.pod:7600 ../src/guestfs-actions.pod:7641 ../src/guestfs-actions.pod:7654 ../src/guestfs-actions.pod:7672 ../src/guestfs-actions.pod:7706 ../src/guestfs-actions.pod:7742 ../src/guestfs-actions.pod:7858 ../src/guestfs-actions.pod:7873 ../src/guestfs-actions.pod:7887 ../src/guestfs-actions.pod:7942 ../src/guestfs-actions.pod:7955 ../src/guestfs-actions.pod:8000 ../src/guestfs-actions.pod:8040 ../src/guestfs-actions.pod:8096 ../src/guestfs-actions.pod:8116 ../src/guestfs-actions.pod:8149 ../src/guestfs-actions.pod:8213 ../src/guestfs-actions.pod:8236 ../src/guestfs-actions.pod:8265 msgid "This function returns 0 on success or -1 on error." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:142 ../src/guestfs-actions.pod:1287 ../src/guestfs-actions.pod:2102 ../src/guestfs-actions.pod:2200 ../src/guestfs-actions.pod:2325 ../src/guestfs-actions.pod:3795 ../src/guestfs-actions.pod:3815 ../src/guestfs-actions.pod:5113 ../src/guestfs-actions.pod:6379 ../src/guestfs-actions.pod:6496 ../src/guestfs-actions.pod:6645 ../src/guestfs-actions.pod:7136 ../src/guestfs-actions.pod:7261 ../src/guestfs-actions.pod:7784 +#: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:142 ../src/guestfs-actions.pod:1287 ../src/guestfs-actions.pod:2342 ../src/guestfs-actions.pod:2440 ../src/guestfs-actions.pod:2565 ../src/guestfs-actions.pod:4035 ../src/guestfs-actions.pod:4055 ../src/guestfs-actions.pod:5353 ../src/guestfs-actions.pod:6637 ../src/guestfs-actions.pod:6754 ../src/guestfs-actions.pod:6903 ../src/guestfs-actions.pod:7394 ../src/guestfs-actions.pod:7519 ../src/guestfs-actions.pod:8042 msgid "(Added in 0.3)" msgstr "" @@ -23615,7 +23823,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:151 ../src/guestfs-actions.pod:843 ../src/guestfs-actions.pod:1167 ../src/guestfs-actions.pod:1219 ../src/guestfs-actions.pod:2993 ../src/guestfs-actions.pod:4814 ../src/guestfs-actions.pod:5123 ../src/guestfs-actions.pod:5340 +#: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:151 ../src/guestfs-actions.pod:843 ../src/guestfs-actions.pod:1167 ../src/guestfs-actions.pod:1219 ../src/guestfs-actions.pod:1297 ../src/guestfs-actions.pod:1364 ../src/guestfs-actions.pod:1415 ../src/guestfs-actions.pod:1466 ../src/guestfs-actions.pod:3233 ../src/guestfs-actions.pod:5054 ../src/guestfs-actions.pod:5363 ../src/guestfs-actions.pod:5580 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 " @@ -23651,7 +23859,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:97 ../src/guestfs-actions.pod:356 ../src/guestfs-actions.pod:526 ../src/guestfs-actions.pod:704 ../src/guestfs-actions.pod:735 ../src/guestfs-actions.pod:753 ../src/guestfs-actions.pod:772 ../src/guestfs-actions.pod:1502 ../src/guestfs-actions.pod:1858 ../src/guestfs-actions.pod:2061 ../src/guestfs-actions.pod:2172 ../src/guestfs-actions.pod:2223 ../src/guestfs-actions.pod:2275 ../src/guestfs-actions.pod:2289 ../src/guestfs-actions.pod:2312 ../src/guestfs-actions.pod:2627 ../src/guestfs-actions.pod:3111 ../src/guestfs-actions.pod:3129 ../src/guestfs-actions.pod:5299 ../src/guestfs-actions.pod:5519 ../src/guestfs-actions.pod:5931 ../src/guestfs-actions.pod:5957 ../src/guestfs-actions.pod:7369 ../src/guestfs-actions.pod:7795 ../src/guestfs-actions.pod:7808 ../src/guestfs-actions.pod:7821 +#: ../src/guestfs-actions.pod:97 ../src/guestfs-actions.pod:356 ../src/guestfs-actions.pod:526 ../src/guestfs-actions.pod:704 ../src/guestfs-actions.pod:735 ../src/guestfs-actions.pod:753 ../src/guestfs-actions.pod:772 ../src/guestfs-actions.pod:1742 ../src/guestfs-actions.pod:2098 ../src/guestfs-actions.pod:2301 ../src/guestfs-actions.pod:2412 ../src/guestfs-actions.pod:2463 ../src/guestfs-actions.pod:2515 ../src/guestfs-actions.pod:2529 ../src/guestfs-actions.pod:2552 ../src/guestfs-actions.pod:2867 ../src/guestfs-actions.pod:3351 ../src/guestfs-actions.pod:3369 ../src/guestfs-actions.pod:5539 ../src/guestfs-actions.pod:5759 ../src/guestfs-actions.pod:5997 ../src/guestfs-actions.pod:6189 ../src/guestfs-actions.pod:6215 ../src/guestfs-actions.pod:7627 ../src/guestfs-actions.pod:8053 ../src/guestfs-actions.pod:8066 ../src/guestfs-actions.pod:8079 msgid "On error this function returns -1." msgstr "" @@ -23682,7 +23890,7 @@ msgid "This is the \"va_list variant\" of L</guestfs_add_domain>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:110 ../src/guestfs-actions.pod:121 ../src/guestfs-actions.pod:220 ../src/guestfs-actions.pod:231 ../src/guestfs-actions.pod:882 ../src/guestfs-actions.pod:893 ../src/guestfs-actions.pod:1195 ../src/guestfs-actions.pod:1208 ../src/guestfs-actions.pod:1254 ../src/guestfs-actions.pod:1267 ../src/guestfs-actions.pod:3077 ../src/guestfs-actions.pod:3089 ../src/guestfs-actions.pod:4879 ../src/guestfs-actions.pod:4891 ../src/guestfs-actions.pod:5151 ../src/guestfs-actions.pod:5163 ../src/guestfs-actions.pod:5389 ../src/guestfs-actions.pod:5400 +#: ../src/guestfs-actions.pod:110 ../src/guestfs-actions.pod:121 ../src/guestfs-actions.pod:220 ../src/guestfs-actions.pod:231 ../src/guestfs-actions.pod:882 ../src/guestfs-actions.pod:893 ../src/guestfs-actions.pod:1195 ../src/guestfs-actions.pod:1208 ../src/guestfs-actions.pod:1254 ../src/guestfs-actions.pod:1267 ../src/guestfs-actions.pod:1342 ../src/guestfs-actions.pod:1354 ../src/guestfs-actions.pod:1393 ../src/guestfs-actions.pod:1405 ../src/guestfs-actions.pod:1444 ../src/guestfs-actions.pod:1456 ../src/guestfs-actions.pod:1500 ../src/guestfs-actions.pod:1512 ../src/guestfs-actions.pod:3317 ../src/guestfs-actions.pod:3329 ../src/guestfs-actions.pod:5119 ../src/guestfs-actions.pod:5131 ../src/guestfs-actions.pod:5391 ../src/guestfs-actions.pod:5403 ../src/guestfs-actions.pod:5629 ../src/guestfs-actions.pod:5640 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>." msgstr "" @@ -23882,7 +24090,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:267 ../src/guestfs-actions.pod:288 ../src/guestfs-actions.pod:2586 +#: ../src/guestfs-actions.pod:267 ../src/guestfs-actions.pod:288 ../src/guestfs-actions.pod:2826 msgid "(Added in 1.0.84)" msgstr "" @@ -23925,7 +24133,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:301 ../src/guestfs-actions.pod:2314 +#: ../src/guestfs-actions.pod:301 ../src/guestfs-actions.pod:2554 msgid "(Added in 1.3.4)" msgstr "" @@ -23952,7 +24160,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:315 ../src/guestfs-actions.pod:340 ../src/guestfs-actions.pod:358 ../src/guestfs-actions.pod:372 ../src/guestfs-actions.pod:435 ../src/guestfs-actions.pod:455 ../src/guestfs-actions.pod:469 ../src/guestfs-actions.pod:500 ../src/guestfs-actions.pod:514 ../src/guestfs-actions.pod:528 ../src/guestfs-actions.pod:542 ../src/guestfs-actions.pod:560 ../src/guestfs-actions.pod:6008 +#: ../src/guestfs-actions.pod:315 ../src/guestfs-actions.pod:340 ../src/guestfs-actions.pod:358 ../src/guestfs-actions.pod:372 ../src/guestfs-actions.pod:435 ../src/guestfs-actions.pod:455 ../src/guestfs-actions.pod:469 ../src/guestfs-actions.pod:500 ../src/guestfs-actions.pod:514 ../src/guestfs-actions.pod:528 ../src/guestfs-actions.pod:542 ../src/guestfs-actions.pod:560 ../src/guestfs-actions.pod:6266 msgid "(Added in 0.7)" msgstr "" @@ -24020,7 +24228,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:369 ../src/guestfs-actions.pod:933 ../src/guestfs-actions.pod:951 ../src/guestfs-actions.pod:1011 ../src/guestfs-actions.pod:1027 ../src/guestfs-actions.pod:1130 ../src/guestfs-actions.pod:1371 ../src/guestfs-actions.pod:1388 ../src/guestfs-actions.pod:1407 ../src/guestfs-actions.pod:1541 ../src/guestfs-actions.pod:1729 ../src/guestfs-actions.pod:1841 ../src/guestfs-actions.pod:2004 ../src/guestfs-actions.pod:2021 ../src/guestfs-actions.pod:2088 ../src/guestfs-actions.pod:2131 ../src/guestfs-actions.pod:2152 ../src/guestfs-actions.pod:2337 ../src/guestfs-actions.pod:2551 ../src/guestfs-actions.pod:2755 ../src/guestfs-actions.pod:2857 ../src/guestfs-actions.pod:2961 ../src/guestfs-actions.pod:2980 ../src/guestfs-actions.pod:3195 ../src/guestfs-actions.pod:3223 ../src/guestfs-actions.pod:3244 ../src/guestfs-actions.pod:3278 ../src/guestfs-actions.pod:3341 ../src/guestfs-actions.pod:3361 ../src/guestfs-actions.pod:3381 ../src/guestfs-actions.pod:4008 ../src/guestfs-actions.pod:4361 ../src/guestfs-actions.pod:4531 ../src/guestfs-actions.pod:4641 ../src/guestfs-actions.pod:5537 ../src/guestfs-actions.pod:5736 ../src/guestfs-actions.pod:5906 ../src/guestfs-actions.pod:6084 ../src/guestfs-actions.pod:6133 ../src/guestfs-actions.pod:6805 ../src/guestfs-actions.pod:6821 ../src/guestfs-actions.pod:6845 ../src/guestfs-actions.pod:6869 ../src/guestfs-actions.pod:7543 ../src/guestfs-actions.pod:7562 ../src/guestfs-actions.pod:7580 ../src/guestfs-actions.pod:7754 ../src/guestfs-actions.pod:8071 +#: ../src/guestfs-actions.pod:369 ../src/guestfs-actions.pod:933 ../src/guestfs-actions.pod:951 ../src/guestfs-actions.pod:1011 ../src/guestfs-actions.pod:1027 ../src/guestfs-actions.pod:1130 ../src/guestfs-actions.pod:1611 ../src/guestfs-actions.pod:1628 ../src/guestfs-actions.pod:1647 ../src/guestfs-actions.pod:1781 ../src/guestfs-actions.pod:1969 ../src/guestfs-actions.pod:2081 ../src/guestfs-actions.pod:2244 ../src/guestfs-actions.pod:2261 ../src/guestfs-actions.pod:2328 ../src/guestfs-actions.pod:2371 ../src/guestfs-actions.pod:2392 ../src/guestfs-actions.pod:2577 ../src/guestfs-actions.pod:2791 ../src/guestfs-actions.pod:2995 ../src/guestfs-actions.pod:3097 ../src/guestfs-actions.pod:3201 ../src/guestfs-actions.pod:3220 ../src/guestfs-actions.pod:3435 ../src/guestfs-actions.pod:3463 ../src/guestfs-actions.pod:3484 ../src/guestfs-actions.pod:3518 ../src/guestfs-actions.pod:3581 ../src/guestfs-actions.pod:3601 ../src/guestfs-actions.pod:3621 ../src/guestfs-actions.pod:4248 ../src/guestfs-actions.pod:4601 ../src/guestfs-actions.pod:4771 ../src/guestfs-actions.pod:4881 ../src/guestfs-actions.pod:5777 ../src/guestfs-actions.pod:5978 ../src/guestfs-actions.pod:6164 ../src/guestfs-actions.pod:6342 ../src/guestfs-actions.pod:6391 ../src/guestfs-actions.pod:7063 ../src/guestfs-actions.pod:7079 ../src/guestfs-actions.pod:7103 ../src/guestfs-actions.pod:7127 ../src/guestfs-actions.pod:7801 ../src/guestfs-actions.pod:7820 ../src/guestfs-actions.pod:7838 ../src/guestfs-actions.pod:8012 ../src/guestfs-actions.pod:8329 msgid "" "This function returns a string, or NULL on error. I<The caller must free " "the returned string after use>." @@ -24120,7 +24328,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:480 ../src/guestfs-actions.pod:496 ../src/guestfs-actions.pod:642 ../src/guestfs-actions.pod:1149 ../src/guestfs-actions.pod:1556 ../src/guestfs-actions.pod:1575 ../src/guestfs-actions.pod:1678 ../src/guestfs-actions.pod:1697 ../src/guestfs-actions.pod:1943 ../src/guestfs-actions.pod:2409 ../src/guestfs-actions.pod:2425 ../src/guestfs-actions.pod:2444 ../src/guestfs-actions.pod:2509 ../src/guestfs-actions.pod:2533 ../src/guestfs-actions.pod:2604 ../src/guestfs-actions.pod:2653 ../src/guestfs-actions.pod:2922 ../src/guestfs-actions.pod:3297 ../src/guestfs-actions.pod:3577 ../src/guestfs-actions.pod:3891 ../src/guestfs-actions.pod:3908 ../src/guestfs-actions.pod:3928 ../src/guestfs-actions.pod:3990 ../src/guestfs-actions.pod:4095 ../src/guestfs-actions.pod:4503 ../src/guestfs-actions.pod:5260 ../src/guestfs-actions.pod:5878 ../src/guestfs-actions.pod:6004 ../src/guestfs-actions.pod:6118 ../src/guestfs-actions.pod:6885 ../src/guestfs-actions.pod:6946 ../src/guestfs-actions.pod:7001 ../src/guestfs-actions.pod:7147 ../src/guestfs-actions.pod:7171 ../src/guestfs-actions.pod:7647 ../src/guestfs-actions.pod:7667 ../src/guestfs-actions.pod:7714 ../src/guestfs-actions.pod:7908 ../src/guestfs-actions.pod:7927 ../src/guestfs-actions.pod:8021 ../src/guestfs-actions.pod:8040 ../src/guestfs-actions.pod:8086 ../src/guestfs-actions.pod:8105 +#: ../src/guestfs-actions.pod:480 ../src/guestfs-actions.pod:496 ../src/guestfs-actions.pod:642 ../src/guestfs-actions.pod:1149 ../src/guestfs-actions.pod:1796 ../src/guestfs-actions.pod:1815 ../src/guestfs-actions.pod:1918 ../src/guestfs-actions.pod:1937 ../src/guestfs-actions.pod:2183 ../src/guestfs-actions.pod:2649 ../src/guestfs-actions.pod:2665 ../src/guestfs-actions.pod:2684 ../src/guestfs-actions.pod:2749 ../src/guestfs-actions.pod:2773 ../src/guestfs-actions.pod:2844 ../src/guestfs-actions.pod:2893 ../src/guestfs-actions.pod:3162 ../src/guestfs-actions.pod:3537 ../src/guestfs-actions.pod:3817 ../src/guestfs-actions.pod:4131 ../src/guestfs-actions.pod:4148 ../src/guestfs-actions.pod:4168 ../src/guestfs-actions.pod:4230 ../src/guestfs-actions.pod:4335 ../src/guestfs-actions.pod:4743 ../src/guestfs-actions.pod:5500 ../src/guestfs-actions.pod:6136 ../src/guestfs-actions.pod:6262 ../src/guestfs-actions.pod:6376 ../src/guestfs-actions.pod:7143 ../src/guestfs-actions.pod:7204 ../src/guestfs-actions.pod:7259 ../src/guestfs-actions.pod:7405 ../src/guestfs-actions.pod:7429 ../src/guestfs-actions.pod:7905 ../src/guestfs-actions.pod:7925 ../src/guestfs-actions.pod:7972 ../src/guestfs-actions.pod:8166 ../src/guestfs-actions.pod:8185 ../src/guestfs-actions.pod:8279 ../src/guestfs-actions.pod:8298 ../src/guestfs-actions.pod:8344 ../src/guestfs-actions.pod:8363 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 " @@ -24128,7 +24336,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:484 ../src/guestfs-actions.pod:1074 ../src/guestfs-actions.pod:1092 ../src/guestfs-actions.pod:1613 ../src/guestfs-actions.pod:3655 ../src/guestfs-actions.pod:3686 ../src/guestfs-actions.pod:4344 ../src/guestfs-actions.pod:4394 ../src/guestfs-actions.pod:4581 ../src/guestfs-actions.pod:4614 ../src/guestfs-actions.pod:4777 ../src/guestfs-actions.pod:5264 ../src/guestfs-actions.pod:5819 ../src/guestfs-actions.pod:6216 ../src/guestfs-actions.pod:6230 ../src/guestfs-actions.pod:6242 ../src/guestfs-actions.pod:6726 ../src/guestfs-actions.pod:7385 ../src/guestfs-actions.pod:7398 ../src/guestfs-actions.pod:7631 ../src/guestfs-actions.pod:7896 +#: ../src/guestfs-actions.pod:484 ../src/guestfs-actions.pod:1074 ../src/guestfs-actions.pod:1092 ../src/guestfs-actions.pod:1853 ../src/guestfs-actions.pod:3895 ../src/guestfs-actions.pod:3926 ../src/guestfs-actions.pod:4584 ../src/guestfs-actions.pod:4634 ../src/guestfs-actions.pod:4821 ../src/guestfs-actions.pod:4854 ../src/guestfs-actions.pod:5017 ../src/guestfs-actions.pod:5504 ../src/guestfs-actions.pod:6077 ../src/guestfs-actions.pod:6474 ../src/guestfs-actions.pod:6488 ../src/guestfs-actions.pod:6500 ../src/guestfs-actions.pod:6984 ../src/guestfs-actions.pod:7643 ../src/guestfs-actions.pod:7656 ../src/guestfs-actions.pod:7889 ../src/guestfs-actions.pod:8154 msgid "(Added in 0.8)" msgstr "" @@ -24260,7 +24468,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:627 ../src/guestfs-actions.pod:1358 +#: ../src/guestfs-actions.pod:627 ../src/guestfs-actions.pod:1598 msgid "(Added in 1.0.80)" msgstr "" @@ -24385,7 +24593,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:719 ../src/guestfs-actions.pod:1596 ../src/guestfs-actions.pod:1611 ../src/guestfs-actions.pod:2100 ../src/guestfs-actions.pod:2111 ../src/guestfs-actions.pod:2183 ../src/guestfs-actions.pod:2209 ../src/guestfs-actions.pod:2249 ../src/guestfs-actions.pod:2264 ../src/guestfs-actions.pod:2300 ../src/guestfs-actions.pod:2323 ../src/guestfs-actions.pod:3398 ../src/guestfs-actions.pod:3414 ../src/guestfs-actions.pod:3432 ../src/guestfs-actions.pod:3594 ../src/guestfs-actions.pod:3608 ../src/guestfs-actions.pod:3623 ../src/guestfs-actions.pod:3637 ../src/guestfs-actions.pod:3653 ../src/guestfs-actions.pod:3668 ../src/guestfs-actions.pod:3684 ../src/guestfs-actions.pod:3698 ../src/guestfs-actions.pod:3711 ../src/guestfs-actions.pod:3725 ../src/guestfs-actions.pod:3740 ../src/guestfs-actions.pod:3755 ../src/guestfs-actions.pod:3768 ../src/guestfs-actions.pod:3782 ../src/guestfs-actions.pod:5501 +#: ../src/guestfs-actions.pod:719 ../src/guestfs-actions.pod:1836 ../src/guestfs-actions.pod:1851 ../src/guestfs-actions.pod:2340 ../src/guestfs-actions.pod:2351 ../src/guestfs-actions.pod:2423 ../src/guestfs-actions.pod:2449 ../src/guestfs-actions.pod:2489 ../src/guestfs-actions.pod:2504 ../src/guestfs-actions.pod:2540 ../src/guestfs-actions.pod:2563 ../src/guestfs-actions.pod:3638 ../src/guestfs-actions.pod:3654 ../src/guestfs-actions.pod:3672 ../src/guestfs-actions.pod:3834 ../src/guestfs-actions.pod:3848 ../src/guestfs-actions.pod:3863 ../src/guestfs-actions.pod:3877 ../src/guestfs-actions.pod:3893 ../src/guestfs-actions.pod:3908 ../src/guestfs-actions.pod:3924 ../src/guestfs-actions.pod:3938 ../src/guestfs-actions.pod:3951 ../src/guestfs-actions.pod:3965 ../src/guestfs-actions.pod:3980 ../src/guestfs-actions.pod:3995 ../src/guestfs-actions.pod:4008 ../src/guestfs-actions.pod:4022 ../src/guestfs-actions.pod:5741 msgid "This function returns a C truth value on success or -1 on error." msgstr "" @@ -24615,7 +24823,7 @@ msgid "See also C<guestfs_realpath>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:936 ../src/guestfs-actions.pod:7565 +#: ../src/guestfs-actions.pod:936 ../src/guestfs-actions.pod:7823 msgid "(Added in 1.0.75)" msgstr "" @@ -24644,7 +24852,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:957 ../src/guestfs-actions.pod:3912 ../src/guestfs-actions.pod:3994 ../src/guestfs-actions.pod:4011 ../src/guestfs-actions.pod:4099 ../src/guestfs-actions.pod:4507 ../src/guestfs-actions.pod:4521 ../src/guestfs-actions.pod:5882 ../src/guestfs-actions.pod:5896 ../src/guestfs-actions.pod:7718 ../src/guestfs-actions.pod:7732 +#: ../src/guestfs-actions.pod:957 ../src/guestfs-actions.pod:4152 ../src/guestfs-actions.pod:4234 ../src/guestfs-actions.pod:4251 ../src/guestfs-actions.pod:4339 ../src/guestfs-actions.pod:4747 ../src/guestfs-actions.pod:4761 ../src/guestfs-actions.pod:6140 ../src/guestfs-actions.pod:6154 ../src/guestfs-actions.pod:7976 ../src/guestfs-actions.pod:7990 msgid "(Added in 0.4)" msgstr "" @@ -24675,7 +24883,7 @@ msgid "To get the checksums for many files, use C<guestfs_checksums_out>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1014 ../src/guestfs-actions.pod:1433 ../src/guestfs-actions.pod:2291 ../src/guestfs-actions.pod:3610 ../src/guestfs-actions.pod:3639 ../src/guestfs-actions.pod:3700 ../src/guestfs-actions.pod:3727 ../src/guestfs-actions.pod:7421 +#: ../src/guestfs-actions.pod:1014 ../src/guestfs-actions.pod:1673 ../src/guestfs-actions.pod:2531 ../src/guestfs-actions.pod:3850 ../src/guestfs-actions.pod:3879 ../src/guestfs-actions.pod:3940 ../src/guestfs-actions.pod:3967 ../src/guestfs-actions.pod:7679 msgid "(Added in 1.0.2)" msgstr "" @@ -24704,7 +24912,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1030 ../src/guestfs-actions.pod:5331 ../src/guestfs-actions.pod:5466 ../src/guestfs-actions.pod:5503 ../src/guestfs-actions.pod:5521 ../src/guestfs-actions.pod:5703 ../src/guestfs-actions.pod:7330 ../src/guestfs-actions.pod:7344 ../src/guestfs-actions.pod:7744 +#: ../src/guestfs-actions.pod:1030 ../src/guestfs-actions.pod:5571 ../src/guestfs-actions.pod:5706 ../src/guestfs-actions.pod:5743 ../src/guestfs-actions.pod:5761 ../src/guestfs-actions.pod:5943 ../src/guestfs-actions.pod:7588 ../src/guestfs-actions.pod:7602 ../src/guestfs-actions.pod:8002 msgid "(Added in 1.3.2)" msgstr "" @@ -24789,7 +24997,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1136 ../src/guestfs-actions.pod:1156 ../src/guestfs-actions.pod:1732 +#: ../src/guestfs-actions.pod:1136 ../src/guestfs-actions.pod:1156 ../src/guestfs-actions.pod:1972 msgid "(Added in 0.9.1)" msgstr "" @@ -24854,7 +25062,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1182 ../src/guestfs-actions.pod:1241 ../src/guestfs-actions.pod:2277 ../src/guestfs-actions.pod:6602 +#: ../src/guestfs-actions.pod:1182 ../src/guestfs-actions.pod:1241 ../src/guestfs-actions.pod:2517 ../src/guestfs-actions.pod:6860 msgid "(Added in 1.13.15)" msgstr "" @@ -24996,7 +25204,7 @@ msgstr "" #. type: =head2 #: ../src/guestfs-actions.pod:1289 -msgid "guestfs_copy_size" +msgid "guestfs_copy_device_to_device" msgstr "" #. type: verbatim @@ -25004,15 +25212,34 @@ msgstr "" #, no-wrap msgid "" " int\n" -" guestfs_copy_size (guestfs_h *g,\n" -" const char *src,\n" -" const char *dest,\n" -" int64_t size);\n" +" guestfs_copy_device_to_device (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest,\n" +" ...);\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1302 +#, no-wrap +msgid "" +" GUESTFS_COPY_DEVICE_TO_DEVICE_SRCOFFSET, int64_t srcoffset,\n" +" GUESTFS_COPY_DEVICE_TO_DEVICE_DESTOFFSET, int64_t destoffset,\n" +" GUESTFS_COPY_DEVICE_TO_DEVICE_SIZE, int64_t size,\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1305 ../src/guestfs-actions.pod:1428 ../src/guestfs-actions.pod:1459 ../src/guestfs-actions.pod:1504 ../src/guestfs-actions.pod:1881 ../src/guestfs-actions.pod:1903 ../src/guestfs-actions.pod:3810 ../src/guestfs-actions.pod:7416 ../src/guestfs-actions.pod:7450 ../src/guestfs-actions.pod:7957 ../src/guestfs-actions.pod:7980 +#: ../src/guestfs-actions.pod:1306 +msgid "" +"The four calls C<guestfs_copy_device_to_device>, " +"C<guestfs_copy_device_to_file>, C<guestfs_copy_file_to_device>, and " +"C<guestfs_copy_file_to_file> let you copy from a source (device|file) to a " +"destination (device|file)." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:1327 ../src/guestfs-actions.pod:1378 ../src/guestfs-actions.pod:1429 ../src/guestfs-actions.pod:1485 ../src/guestfs-actions.pod:1537 ../src/guestfs-actions.pod:1668 ../src/guestfs-actions.pod:1699 ../src/guestfs-actions.pod:1744 ../src/guestfs-actions.pod:2121 ../src/guestfs-actions.pod:2143 ../src/guestfs-actions.pod:4050 ../src/guestfs-actions.pod:7674 ../src/guestfs-actions.pod:7708 ../src/guestfs-actions.pod:8215 ../src/guestfs-actions.pod:8238 msgid "" "This long-running command can generate progress notification messages so " "that the caller can display a progress bar or indicator. To receive these " @@ -25020,18 +25247,316 @@ msgid "" "L<guestfs(3)/GUESTFS_EVENT_PROGRESS>." msgstr "" +#. type: =head2 +#: ../src/guestfs-actions.pod:1332 +msgid "guestfs_copy_device_to_device_va" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1334 +#, no-wrap +msgid "" +" int\n" +" guestfs_copy_device_to_device_va (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest,\n" +" va_list args);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:1340 +msgid "This is the \"va_list variant\" of L</guestfs_copy_device_to_device>." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:1344 +msgid "guestfs_copy_device_to_device_argv" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1346 +#, no-wrap +msgid "" +" int\n" +" guestfs_copy_device_to_device_argv (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest,\n" +" const struct " +"guestfs_copy_device_to_device_argv *optargs);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:1352 +msgid "This is the \"argv variant\" of L</guestfs_copy_device_to_device>." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:1356 +msgid "guestfs_copy_device_to_file" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1358 +#, no-wrap +msgid "" +" int\n" +" guestfs_copy_device_to_file (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest,\n" +" ...);\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1369 +#, no-wrap +msgid "" +" GUESTFS_COPY_DEVICE_TO_FILE_SRCOFFSET, int64_t srcoffset,\n" +" GUESTFS_COPY_DEVICE_TO_FILE_DESTOFFSET, int64_t destoffset,\n" +" GUESTFS_COPY_DEVICE_TO_FILE_SIZE, int64_t size,\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:1373 ../src/guestfs-actions.pod:1424 ../src/guestfs-actions.pod:1475 +msgid "See C<guestfs_copy_device_to_device> for a general overview of this call." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:1383 +msgid "guestfs_copy_device_to_file_va" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1385 +#, no-wrap +msgid "" +" int\n" +" guestfs_copy_device_to_file_va (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest,\n" +" va_list args);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:1391 +msgid "This is the \"va_list variant\" of L</guestfs_copy_device_to_file>." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:1395 +msgid "guestfs_copy_device_to_file_argv" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1397 +#, no-wrap +msgid "" +" int\n" +" guestfs_copy_device_to_file_argv (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest,\n" +" const struct " +"guestfs_copy_device_to_file_argv *optargs);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:1403 +msgid "This is the \"argv variant\" of L</guestfs_copy_device_to_file>." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:1407 +msgid "guestfs_copy_file_to_device" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1409 +#, no-wrap +msgid "" +" int\n" +" guestfs_copy_file_to_device (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest,\n" +" ...);\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1420 +#, no-wrap +msgid "" +" GUESTFS_COPY_FILE_TO_DEVICE_SRCOFFSET, int64_t srcoffset,\n" +" GUESTFS_COPY_FILE_TO_DEVICE_DESTOFFSET, int64_t destoffset,\n" +" GUESTFS_COPY_FILE_TO_DEVICE_SIZE, int64_t size,\n" +"\n" +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:1434 +msgid "guestfs_copy_file_to_device_va" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1436 +#, no-wrap +msgid "" +" int\n" +" guestfs_copy_file_to_device_va (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest,\n" +" va_list args);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:1442 +msgid "This is the \"va_list variant\" of L</guestfs_copy_file_to_device>." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:1446 +msgid "guestfs_copy_file_to_device_argv" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1448 +#, no-wrap +msgid "" +" int\n" +" guestfs_copy_file_to_device_argv (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest,\n" +" const struct " +"guestfs_copy_file_to_device_argv *optargs);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:1454 +msgid "This is the \"argv variant\" of L</guestfs_copy_file_to_device>." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:1458 +msgid "guestfs_copy_file_to_file" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1460 +#, no-wrap +msgid "" +" int\n" +" guestfs_copy_file_to_file (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest,\n" +" ...);\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1471 +#, no-wrap +msgid "" +" GUESTFS_COPY_FILE_TO_FILE_SRCOFFSET, int64_t srcoffset,\n" +" GUESTFS_COPY_FILE_TO_FILE_DESTOFFSET, int64_t destoffset,\n" +" GUESTFS_COPY_FILE_TO_FILE_SIZE, int64_t size,\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:1478 +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 " +"C<guestfs_mv> for general file copying and moving functions." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:1490 +msgid "guestfs_copy_file_to_file_va" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1492 +#, no-wrap +msgid "" +" int\n" +" guestfs_copy_file_to_file_va (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest,\n" +" va_list args);\n" +"\n" +msgstr "" + #. type: textblock -#: ../src/guestfs-actions.pod:1310 ../src/guestfs-actions.pod:4534 ../src/guestfs-actions.pod:5909 ../src/guestfs-actions.pod:7651 ../src/guestfs-actions.pod:7671 ../src/guestfs-actions.pod:7757 +#: ../src/guestfs-actions.pod:1498 +msgid "This is the \"va_list variant\" of L</guestfs_copy_file_to_file>." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:1502 +msgid "guestfs_copy_file_to_file_argv" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1504 +#, no-wrap +msgid "" +" int\n" +" guestfs_copy_file_to_file_argv (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest,\n" +" const struct guestfs_copy_file_to_file_argv " +"*optargs);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:1510 +msgid "This is the \"argv variant\" of L</guestfs_copy_file_to_file>." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:1514 +msgid "guestfs_copy_size" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1516 +#, no-wrap +msgid "" +" int\n" +" guestfs_copy_size (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest,\n" +" int64_t size);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:1522 ../src/guestfs-actions.pod:1579 +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:1542 ../src/guestfs-actions.pod:4774 ../src/guestfs-actions.pod:6167 ../src/guestfs-actions.pod:7909 ../src/guestfs-actions.pod:7929 ../src/guestfs-actions.pod:8015 msgid "(Added in 1.0.87)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1312 +#: ../src/guestfs-actions.pod:1544 msgid "guestfs_cp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1314 +#: ../src/guestfs-actions.pod:1546 #, no-wrap msgid "" " int\n" @@ -25042,17 +25567,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1324 ../src/guestfs-actions.pod:1338 ../src/guestfs-actions.pod:1410 ../src/guestfs-actions.pod:1484 ../src/guestfs-actions.pod:1598 ../src/guestfs-actions.pod:5278 ../src/guestfs-actions.pod:5753 +#: ../src/guestfs-actions.pod:1556 ../src/guestfs-actions.pod:1570 ../src/guestfs-actions.pod:1650 ../src/guestfs-actions.pod:1724 ../src/guestfs-actions.pod:1838 ../src/guestfs-actions.pod:5518 ../src/guestfs-actions.pod:6011 msgid "(Added in 1.0.18)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1326 +#: ../src/guestfs-actions.pod:1558 msgid "guestfs_cp_a" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1328 +#: ../src/guestfs-actions.pod:1560 #, no-wrap msgid "" " int\n" @@ -25063,12 +25588,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1340 +#: ../src/guestfs-actions.pod:1572 msgid "guestfs_dd" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1342 +#: ../src/guestfs-actions.pod:1574 #, no-wrap msgid "" " int\n" @@ -25079,20 +25604,20 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1352 +#: ../src/guestfs-actions.pod:1591 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 " -"partial copies (see C<guestfs_copy_size>)." +"partial copies (see C<guestfs_copy_device_to_device>)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1360 +#: ../src/guestfs-actions.pod:1600 msgid "guestfs_df" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1362 +#: ../src/guestfs-actions.pod:1602 #, no-wrap msgid "" " char *\n" @@ -25101,7 +25626,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1367 ../src/guestfs-actions.pod:1384 +#: ../src/guestfs-actions.pod:1607 ../src/guestfs-actions.pod:1624 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> " @@ -25109,17 +25634,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1374 ../src/guestfs-actions.pod:1391 ../src/guestfs-actions.pod:1509 ../src/guestfs-actions.pod:2516 ../src/guestfs-actions.pod:2540 ../src/guestfs-actions.pod:2608 ../src/guestfs-actions.pod:4644 ../src/guestfs-actions.pod:5178 ../src/guestfs-actions.pod:7154 ../src/guestfs-actions.pod:7178 ../src/guestfs-actions.pod:7797 ../src/guestfs-actions.pod:7810 ../src/guestfs-actions.pod:7823 +#: ../src/guestfs-actions.pod:1614 ../src/guestfs-actions.pod:1631 ../src/guestfs-actions.pod:1749 ../src/guestfs-actions.pod:2756 ../src/guestfs-actions.pod:2780 ../src/guestfs-actions.pod:2848 ../src/guestfs-actions.pod:4884 ../src/guestfs-actions.pod:5418 ../src/guestfs-actions.pod:7412 ../src/guestfs-actions.pod:7436 ../src/guestfs-actions.pod:8055 ../src/guestfs-actions.pod:8068 ../src/guestfs-actions.pod:8081 msgid "(Added in 1.0.54)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1376 +#: ../src/guestfs-actions.pod:1616 msgid "guestfs_df_h" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1378 +#: ../src/guestfs-actions.pod:1618 #, no-wrap msgid "" " char *\n" @@ -25128,12 +25653,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1393 +#: ../src/guestfs-actions.pod:1633 msgid "guestfs_dmesg" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1395 +#: ../src/guestfs-actions.pod:1635 #, no-wrap msgid "" " char *\n" @@ -25142,7 +25667,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1402 +#: ../src/guestfs-actions.pod:1642 msgid "" "Another way to get the same information is to enable verbose messages with " "C<guestfs_set_verbose> or by setting the environment variable " @@ -25150,12 +25675,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1412 +#: ../src/guestfs-actions.pod:1652 msgid "guestfs_download" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1414 +#: ../src/guestfs-actions.pod:1654 #, no-wrap msgid "" " int\n" @@ -25166,17 +25691,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1424 +#: ../src/guestfs-actions.pod:1664 msgid "See also C<guestfs_upload>, C<guestfs_cat>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1435 +#: ../src/guestfs-actions.pod:1675 msgid "guestfs_download_offset" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1437 +#: ../src/guestfs-actions.pod:1677 #, no-wrap msgid "" " int\n" @@ -25189,7 +25714,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1450 +#: ../src/guestfs-actions.pod:1690 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 " @@ -25197,22 +25722,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1455 +#: ../src/guestfs-actions.pod:1695 msgid "See also C<guestfs_download>, C<guestfs_pread>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1464 ../src/guestfs-actions.pod:7455 +#: ../src/guestfs-actions.pod:1704 ../src/guestfs-actions.pod:7713 msgid "(Added in 1.5.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1466 +#: ../src/guestfs-actions.pod:1706 msgid "guestfs_drop_caches" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1468 +#: ../src/guestfs-actions.pod:1708 #, no-wrap msgid "" " int\n" @@ -25222,12 +25747,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1486 +#: ../src/guestfs-actions.pod:1726 msgid "guestfs_du" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1488 +#: ../src/guestfs-actions.pod:1728 #, no-wrap msgid "" " int64_t\n" @@ -25237,12 +25762,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1511 +#: ../src/guestfs-actions.pod:1751 msgid "guestfs_e2fsck_f" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1513 +#: ../src/guestfs-actions.pod:1753 #, no-wrap msgid "" " int\n" @@ -25252,24 +25777,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1521 +#: ../src/guestfs-actions.pod:1761 msgid "" "This command is only needed because of C<guestfs_resize2fs> (q.v.). " "Normally you should use C<guestfs_fsck>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1526 +#: ../src/guestfs-actions.pod:1766 msgid "(Added in 1.0.29)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1528 +#: ../src/guestfs-actions.pod:1768 msgid "guestfs_echo_daemon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1530 +#: ../src/guestfs-actions.pod:1770 #, no-wrap msgid "" " char *\n" @@ -25279,22 +25804,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1539 +#: ../src/guestfs-actions.pod:1779 msgid "See also C<guestfs_ping_daemon>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1544 ../src/guestfs-actions.pod:2302 ../src/guestfs-actions.pod:6626 +#: ../src/guestfs-actions.pod:1784 ../src/guestfs-actions.pod:2542 ../src/guestfs-actions.pod:6884 msgid "(Added in 1.0.69)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1546 +#: ../src/guestfs-actions.pod:1786 msgid "guestfs_egrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1548 +#: ../src/guestfs-actions.pod:1788 #, no-wrap msgid "" " char **\n" @@ -25305,17 +25830,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1563 ../src/guestfs-actions.pod:1582 ../src/guestfs-actions.pod:1639 ../src/guestfs-actions.pod:1685 ../src/guestfs-actions.pod:1704 ../src/guestfs-actions.pod:2432 ../src/guestfs-actions.pod:2451 ../src/guestfs-actions.pod:2629 ../src/guestfs-actions.pod:2642 ../src/guestfs-actions.pod:2657 ../src/guestfs-actions.pod:2703 ../src/guestfs-actions.pod:2725 ../src/guestfs-actions.pod:2738 ../src/guestfs-actions.pod:4024 ../src/guestfs-actions.pod:4038 ../src/guestfs-actions.pod:4051 ../src/guestfs-actions.pod:4065 ../src/guestfs-actions.pod:5066 ../src/guestfs-actions.pod:6087 ../src/guestfs-actions.pod:6136 ../src/guestfs-actions.pod:7022 ../src/guestfs-actions.pod:7034 ../src/guestfs-actions.pod:7047 ../src/guestfs-actions.pod:7060 ../src/guestfs-actions.pod:7082 ../src/guestfs-actions.pod:7095 ../src/guestfs-actions.pod:7108 ../src/guestfs-actions.pod:7121 ../src/guestfs-actions.pod:7915 ../src/guestfs-actions.pod:7934 ../src/guestfs-actions.pod:8028 ../src/guestfs-actions.pod:8047 ../src/guestfs-actions.pod:8093 ../src/guestfs-actions.pod:8112 +#: ../src/guestfs-actions.pod:1803 ../src/guestfs-actions.pod:1822 ../src/guestfs-actions.pod:1879 ../src/guestfs-actions.pod:1925 ../src/guestfs-actions.pod:1944 ../src/guestfs-actions.pod:2672 ../src/guestfs-actions.pod:2691 ../src/guestfs-actions.pod:2869 ../src/guestfs-actions.pod:2882 ../src/guestfs-actions.pod:2897 ../src/guestfs-actions.pod:2943 ../src/guestfs-actions.pod:2965 ../src/guestfs-actions.pod:2978 ../src/guestfs-actions.pod:4264 ../src/guestfs-actions.pod:4278 ../src/guestfs-actions.pod:4291 ../src/guestfs-actions.pod:4305 ../src/guestfs-actions.pod:5306 ../src/guestfs-actions.pod:6345 ../src/guestfs-actions.pod:6394 ../src/guestfs-actions.pod:7280 ../src/guestfs-actions.pod:7292 ../src/guestfs-actions.pod:7305 ../src/guestfs-actions.pod:7318 ../src/guestfs-actions.pod:7340 ../src/guestfs-actions.pod:7353 ../src/guestfs-actions.pod:7366 ../src/guestfs-actions.pod:7379 ../src/guestfs-actions.pod:8173 ../src/guestfs-actions.pod:8192 ../src/guestfs-actions.pod:8286 ../src/guestfs-actions.pod:8305 ../src/guestfs-actions.pod:8351 ../src/guestfs-actions.pod:8370 msgid "(Added in 1.0.66)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1565 +#: ../src/guestfs-actions.pod:1805 msgid "guestfs_egrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1567 +#: ../src/guestfs-actions.pod:1807 #, no-wrap msgid "" " char **\n" @@ -25326,12 +25851,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1584 +#: ../src/guestfs-actions.pod:1824 msgid "guestfs_equal" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1586 +#: ../src/guestfs-actions.pod:1826 #, no-wrap msgid "" " int\n" @@ -25342,12 +25867,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1600 +#: ../src/guestfs-actions.pod:1840 msgid "guestfs_exists" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1602 +#: ../src/guestfs-actions.pod:1842 #, no-wrap msgid "" " int\n" @@ -25357,17 +25882,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1609 +#: ../src/guestfs-actions.pod:1849 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1615 +#: ../src/guestfs-actions.pod:1855 msgid "guestfs_fallocate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1617 +#: ../src/guestfs-actions.pod:1857 #, no-wrap msgid "" " int\n" @@ -25378,19 +25903,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1622 +#: ../src/guestfs-actions.pod:1862 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_fallocate64> " "call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1641 +#: ../src/guestfs-actions.pod:1881 msgid "guestfs_fallocate64" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1643 +#: ../src/guestfs-actions.pod:1883 #, no-wrap msgid "" " int\n" @@ -25401,14 +25926,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1652 +#: ../src/guestfs-actions.pod:1892 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:1655 +#: ../src/guestfs-actions.pod:1895 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 " @@ -25416,17 +25941,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1666 +#: ../src/guestfs-actions.pod:1906 msgid "(Added in 1.3.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1668 +#: ../src/guestfs-actions.pod:1908 msgid "guestfs_fgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1670 +#: ../src/guestfs-actions.pod:1910 #, no-wrap msgid "" " char **\n" @@ -25437,12 +25962,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1687 +#: ../src/guestfs-actions.pod:1927 msgid "guestfs_fgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1689 +#: ../src/guestfs-actions.pod:1929 #, no-wrap msgid "" " char **\n" @@ -25453,12 +25978,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1706 +#: ../src/guestfs-actions.pod:1946 msgid "guestfs_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1708 +#: ../src/guestfs-actions.pod:1948 #, no-wrap msgid "" " char *\n" @@ -25468,19 +25993,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1726 +#: ../src/guestfs-actions.pod:1966 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:1734 +#: ../src/guestfs-actions.pod:1974 msgid "guestfs_file_architecture" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1736 +#: ../src/guestfs-actions.pod:1976 #, no-wrap msgid "" " char *\n" @@ -25490,17 +26015,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1844 ../src/guestfs-actions.pod:2007 ../src/guestfs-actions.pod:2024 ../src/guestfs-actions.pod:2758 ../src/guestfs-actions.pod:2860 ../src/guestfs-actions.pod:2926 ../src/guestfs-actions.pod:3113 ../src/guestfs-actions.pod:3131 ../src/guestfs-actions.pod:3171 ../src/guestfs-actions.pod:3247 ../src/guestfs-actions.pod:3344 ../src/guestfs-actions.pod:3581 ../src/guestfs-actions.pod:3713 +#: ../src/guestfs-actions.pod:2084 ../src/guestfs-actions.pod:2247 ../src/guestfs-actions.pod:2264 ../src/guestfs-actions.pod:2998 ../src/guestfs-actions.pod:3100 ../src/guestfs-actions.pod:3166 ../src/guestfs-actions.pod:3353 ../src/guestfs-actions.pod:3371 ../src/guestfs-actions.pod:3411 ../src/guestfs-actions.pod:3487 ../src/guestfs-actions.pod:3584 ../src/guestfs-actions.pod:3821 ../src/guestfs-actions.pod:3953 msgid "(Added in 1.5.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1846 +#: ../src/guestfs-actions.pod:2086 msgid "guestfs_filesize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1848 +#: ../src/guestfs-actions.pod:2088 #, no-wrap msgid "" " int64_t\n" @@ -25510,7 +26035,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1854 +#: ../src/guestfs-actions.pod:2094 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 " @@ -25518,17 +26043,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1860 +#: ../src/guestfs-actions.pod:2100 msgid "(Added in 1.0.82)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1862 +#: ../src/guestfs-actions.pod:2102 msgid "guestfs_fill" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1864 +#: ../src/guestfs-actions.pod:2104 #, no-wrap msgid "" " int\n" @@ -25540,7 +26065,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1874 +#: ../src/guestfs-actions.pod:2114 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 " @@ -25548,17 +26073,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1886 +#: ../src/guestfs-actions.pod:2126 msgid "(Added in 1.0.79)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1888 +#: ../src/guestfs-actions.pod:2128 msgid "guestfs_fill_pattern" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1890 +#: ../src/guestfs-actions.pod:2130 #, no-wrap msgid "" " int\n" @@ -25570,7 +26095,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1896 +#: ../src/guestfs-actions.pod:2136 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 " @@ -25579,17 +26104,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1908 +#: ../src/guestfs-actions.pod:2148 msgid "(Added in 1.3.12)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1910 +#: ../src/guestfs-actions.pod:2150 msgid "guestfs_find" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1912 +#: ../src/guestfs-actions.pod:2152 #, no-wrap msgid "" " char **\n" @@ -25599,27 +26124,27 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1928 +#: ../src/guestfs-actions.pod:2168 msgid "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1941 +#: ../src/guestfs-actions.pod:2181 msgid "See also C<guestfs_find0>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1950 ../src/guestfs-actions.pod:4471 ../src/guestfs-actions.pod:6171 +#: ../src/guestfs-actions.pod:2190 ../src/guestfs-actions.pod:4711 ../src/guestfs-actions.pod:6429 msgid "(Added in 1.0.27)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1952 +#: ../src/guestfs-actions.pod:2192 msgid "guestfs_find0" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1954 +#: ../src/guestfs-actions.pod:2194 #, no-wrap msgid "" " int\n" @@ -25630,24 +26155,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1963 +#: ../src/guestfs-actions.pod:2203 msgid "" "This command works the same way as C<guestfs_find> with the following " "exceptions:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1990 +#: ../src/guestfs-actions.pod:2230 msgid "(Added in 1.0.74)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1992 +#: ../src/guestfs-actions.pod:2232 msgid "guestfs_findfs_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1994 +#: ../src/guestfs-actions.pod:2234 #, no-wrap msgid "" " char *\n" @@ -25657,17 +26182,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2002 +#: ../src/guestfs-actions.pod:2242 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2009 +#: ../src/guestfs-actions.pod:2249 msgid "guestfs_findfs_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2011 +#: ../src/guestfs-actions.pod:2251 #, no-wrap msgid "" " char *\n" @@ -25677,17 +26202,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2019 +#: ../src/guestfs-actions.pod:2259 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2026 +#: ../src/guestfs-actions.pod:2266 msgid "guestfs_fsck" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2028 +#: ../src/guestfs-actions.pod:2268 #, no-wrap msgid "" " int\n" @@ -25698,17 +26223,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2063 ../src/guestfs-actions.pod:7962 +#: ../src/guestfs-actions.pod:2303 ../src/guestfs-actions.pod:8220 msgid "(Added in 1.0.16)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2065 +#: ../src/guestfs-actions.pod:2305 msgid "guestfs_get_append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2067 +#: ../src/guestfs-actions.pod:2307 #, no-wrap msgid "" " const char *\n" @@ -25717,7 +26242,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2075 +#: ../src/guestfs-actions.pod:2315 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 " @@ -25725,17 +26250,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2079 ../src/guestfs-actions.pod:5849 ../src/guestfs-actions.pod:6331 ../src/guestfs-actions.pod:6789 ../src/guestfs-actions.pod:6808 ../src/guestfs-actions.pod:6824 ../src/guestfs-actions.pod:6848 ../src/guestfs-actions.pod:7602 ../src/guestfs-actions.pod:7617 ../src/guestfs-actions.pod:8009 +#: ../src/guestfs-actions.pod:2319 ../src/guestfs-actions.pod:6107 ../src/guestfs-actions.pod:6589 ../src/guestfs-actions.pod:7047 ../src/guestfs-actions.pod:7066 ../src/guestfs-actions.pod:7082 ../src/guestfs-actions.pod:7106 ../src/guestfs-actions.pod:7860 ../src/guestfs-actions.pod:7875 ../src/guestfs-actions.pod:8267 msgid "(Added in 1.0.26)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2081 +#: ../src/guestfs-actions.pod:2321 msgid "guestfs_get_attach_method" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2083 +#: ../src/guestfs-actions.pod:2323 #, no-wrap msgid "" " char *\n" @@ -25744,22 +26269,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2086 +#: ../src/guestfs-actions.pod:2326 msgid "Return the current attach method. See C<guestfs_set_attach_method>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2091 ../src/guestfs-actions.pod:6361 +#: ../src/guestfs-actions.pod:2331 ../src/guestfs-actions.pod:6619 msgid "(Added in 1.9.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2093 +#: ../src/guestfs-actions.pod:2333 msgid "guestfs_get_autosync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2095 +#: ../src/guestfs-actions.pod:2335 #, no-wrap msgid "" " int\n" @@ -25768,12 +26293,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2104 +#: ../src/guestfs-actions.pod:2344 msgid "guestfs_get_direct" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2106 +#: ../src/guestfs-actions.pod:2346 #, no-wrap msgid "" " int\n" @@ -25782,17 +26307,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2113 ../src/guestfs-actions.pod:6402 +#: ../src/guestfs-actions.pod:2353 ../src/guestfs-actions.pod:6660 msgid "(Added in 1.0.72)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2115 +#: ../src/guestfs-actions.pod:2355 msgid "guestfs_get_e2label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2117 +#: ../src/guestfs-actions.pod:2357 #, no-wrap msgid "" " char *\n" @@ -25802,24 +26327,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2121 +#: ../src/guestfs-actions.pod:2361 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_vfs_label> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2134 ../src/guestfs-actions.pod:2155 ../src/guestfs-actions.pod:6420 ../src/guestfs-actions.pod:6439 +#: ../src/guestfs-actions.pod:2374 ../src/guestfs-actions.pod:2395 ../src/guestfs-actions.pod:6678 ../src/guestfs-actions.pod:6697 msgid "(Added in 1.0.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2136 +#: ../src/guestfs-actions.pod:2376 msgid "guestfs_get_e2uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2138 +#: ../src/guestfs-actions.pod:2378 #, no-wrap msgid "" " char *\n" @@ -25829,19 +26354,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2142 +#: ../src/guestfs-actions.pod:2382 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_vfs_uuid> " "call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2157 +#: ../src/guestfs-actions.pod:2397 msgid "guestfs_get_memsize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2159 +#: ../src/guestfs-actions.pod:2399 #, no-wrap msgid "" " int\n" @@ -25850,7 +26375,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2165 +#: ../src/guestfs-actions.pod:2405 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 " @@ -25858,17 +26383,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2174 ../src/guestfs-actions.pod:4762 ../src/guestfs-actions.pod:4971 ../src/guestfs-actions.pod:4990 ../src/guestfs-actions.pod:5009 ../src/guestfs-actions.pod:5021 ../src/guestfs-actions.pod:5038 ../src/guestfs-actions.pod:5051 ../src/guestfs-actions.pod:6074 ../src/guestfs-actions.pod:6460 ../src/guestfs-actions.pod:6756 ../src/guestfs-actions.pod:7371 +#: ../src/guestfs-actions.pod:2414 ../src/guestfs-actions.pod:5002 ../src/guestfs-actions.pod:5211 ../src/guestfs-actions.pod:5230 ../src/guestfs-actions.pod:5249 ../src/guestfs-actions.pod:5261 ../src/guestfs-actions.pod:5278 ../src/guestfs-actions.pod:5291 ../src/guestfs-actions.pod:6332 ../src/guestfs-actions.pod:6718 ../src/guestfs-actions.pod:7014 ../src/guestfs-actions.pod:7629 msgid "(Added in 1.0.55)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2176 +#: ../src/guestfs-actions.pod:2416 msgid "guestfs_get_network" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2178 +#: ../src/guestfs-actions.pod:2418 #, no-wrap msgid "" " int\n" @@ -25877,17 +26402,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2185 ../src/guestfs-actions.pod:6479 +#: ../src/guestfs-actions.pod:2425 ../src/guestfs-actions.pod:6737 msgid "(Added in 1.5.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2187 +#: ../src/guestfs-actions.pod:2427 msgid "guestfs_get_path" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2189 +#: ../src/guestfs-actions.pod:2429 #, no-wrap msgid "" " const char *\n" @@ -25896,19 +26421,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2197 ../src/guestfs-actions.pod:2237 +#: ../src/guestfs-actions.pod:2437 ../src/guestfs-actions.pod:2477 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:2202 +#: ../src/guestfs-actions.pod:2442 msgid "guestfs_get_pgroup" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2204 +#: ../src/guestfs-actions.pod:2444 #, no-wrap msgid "" " int\n" @@ -25917,17 +26442,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2211 ../src/guestfs-actions.pod:6515 ../src/guestfs-actions.pod:7863 +#: ../src/guestfs-actions.pod:2451 ../src/guestfs-actions.pod:6773 ../src/guestfs-actions.pod:8121 msgid "(Added in 1.11.18)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2213 +#: ../src/guestfs-actions.pod:2453 msgid "guestfs_get_pid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2215 +#: ../src/guestfs-actions.pod:2455 #, no-wrap msgid "" " int\n" @@ -25936,17 +26461,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2225 +#: ../src/guestfs-actions.pod:2465 msgid "(Added in 1.0.56)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2227 +#: ../src/guestfs-actions.pod:2467 msgid "guestfs_get_qemu" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2229 +#: ../src/guestfs-actions.pod:2469 #, no-wrap msgid "" " const char *\n" @@ -25955,17 +26480,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2240 ../src/guestfs-actions.pod:6543 +#: ../src/guestfs-actions.pod:2480 ../src/guestfs-actions.pod:6801 msgid "(Added in 1.0.6)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2242 +#: ../src/guestfs-actions.pod:2482 msgid "guestfs_get_recovery_proc" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2244 +#: ../src/guestfs-actions.pod:2484 #, no-wrap msgid "" " int\n" @@ -25974,17 +26499,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2251 ../src/guestfs-actions.pod:3835 ../src/guestfs-actions.pod:4166 ../src/guestfs-actions.pod:4569 ../src/guestfs-actions.pod:4601 ../src/guestfs-actions.pod:5779 ../src/guestfs-actions.pod:6122 ../src/guestfs-actions.pod:6567 ../src/guestfs-actions.pod:7274 ../src/guestfs-actions.pod:7294 ../src/guestfs-actions.pod:7486 +#: ../src/guestfs-actions.pod:2491 ../src/guestfs-actions.pod:4075 ../src/guestfs-actions.pod:4406 ../src/guestfs-actions.pod:4809 ../src/guestfs-actions.pod:4841 ../src/guestfs-actions.pod:6037 ../src/guestfs-actions.pod:6380 ../src/guestfs-actions.pod:6825 ../src/guestfs-actions.pod:7532 ../src/guestfs-actions.pod:7552 ../src/guestfs-actions.pod:7744 msgid "(Added in 1.0.77)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2253 +#: ../src/guestfs-actions.pod:2493 msgid "guestfs_get_selinux" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2255 +#: ../src/guestfs-actions.pod:2495 #, no-wrap msgid "" " int\n" @@ -25993,24 +26518,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2258 +#: ../src/guestfs-actions.pod:2498 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:2266 ../src/guestfs-actions.pod:2340 ../src/guestfs-actions.pod:6586 ../src/guestfs-actions.pod:6660 +#: ../src/guestfs-actions.pod:2506 ../src/guestfs-actions.pod:2580 ../src/guestfs-actions.pod:6844 ../src/guestfs-actions.pod:6918 msgid "(Added in 1.0.67)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2268 +#: ../src/guestfs-actions.pod:2508 msgid "guestfs_get_smp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2270 +#: ../src/guestfs-actions.pod:2510 #, no-wrap msgid "" " int\n" @@ -26019,12 +26544,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2279 +#: ../src/guestfs-actions.pod:2519 msgid "guestfs_get_state" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2281 +#: ../src/guestfs-actions.pod:2521 #, no-wrap msgid "" " int\n" @@ -26033,12 +26558,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2293 +#: ../src/guestfs-actions.pod:2533 msgid "guestfs_get_trace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2295 +#: ../src/guestfs-actions.pod:2535 #, no-wrap msgid "" " int\n" @@ -26047,12 +26572,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2304 +#: ../src/guestfs-actions.pod:2544 msgid "guestfs_get_umask" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2306 +#: ../src/guestfs-actions.pod:2546 #, no-wrap msgid "" " int\n" @@ -26061,19 +26586,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2309 +#: ../src/guestfs-actions.pod:2549 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:2316 +#: ../src/guestfs-actions.pod:2556 msgid "guestfs_get_verbose" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2318 +#: ../src/guestfs-actions.pod:2558 #, no-wrap msgid "" " int\n" @@ -26082,12 +26607,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2327 +#: ../src/guestfs-actions.pod:2567 msgid "guestfs_getcon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2329 +#: ../src/guestfs-actions.pod:2569 #, no-wrap msgid "" " char *\n" @@ -26096,17 +26621,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2334 +#: ../src/guestfs-actions.pod:2574 msgid "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2342 +#: ../src/guestfs-actions.pod:2582 msgid "guestfs_getxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2344 +#: ../src/guestfs-actions.pod:2584 #, no-wrap msgid "" " char *\n" @@ -26118,7 +26643,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2350 +#: ../src/guestfs-actions.pod:2590 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 " @@ -26126,7 +26651,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2354 ../src/guestfs-actions.pod:3849 +#: ../src/guestfs-actions.pod:2594 ../src/guestfs-actions.pod:4089 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 " @@ -26136,12 +26661,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2364 +#: ../src/guestfs-actions.pod:2604 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2366 ../src/guestfs-actions.pod:2579 ../src/guestfs-actions.pod:3061 ../src/guestfs-actions.pod:3861 ../src/guestfs-actions.pod:5772 ../src/guestfs-actions.pod:5798 ../src/guestfs-actions.pod:5979 +#: ../src/guestfs-actions.pod:2606 ../src/guestfs-actions.pod:2819 ../src/guestfs-actions.pod:3301 ../src/guestfs-actions.pod:4101 ../src/guestfs-actions.pod:6030 ../src/guestfs-actions.pod:6056 ../src/guestfs-actions.pod:6237 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 " @@ -26149,17 +26674,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2370 ../src/guestfs-actions.pod:3865 +#: ../src/guestfs-actions.pod:2610 ../src/guestfs-actions.pod:4105 msgid "(Added in 1.7.24)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2372 +#: ../src/guestfs-actions.pod:2612 msgid "guestfs_getxattrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2374 +#: ../src/guestfs-actions.pod:2614 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -26169,29 +26694,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2384 +#: ../src/guestfs-actions.pod:2624 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2386 ../src/guestfs-actions.pod:3877 ../src/guestfs-actions.pod:4565 +#: ../src/guestfs-actions.pod:2626 ../src/guestfs-actions.pod:4117 ../src/guestfs-actions.pod:4805 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:2390 ../src/guestfs-actions.pod:3881 ../src/guestfs-actions.pod:4080 ../src/guestfs-actions.pod:4116 ../src/guestfs-actions.pod:6152 ../src/guestfs-actions.pod:6679 ../src/guestfs-actions.pod:8074 +#: ../src/guestfs-actions.pod:2630 ../src/guestfs-actions.pod:4121 ../src/guestfs-actions.pod:4320 ../src/guestfs-actions.pod:4356 ../src/guestfs-actions.pod:6410 ../src/guestfs-actions.pod:6937 ../src/guestfs-actions.pod:8332 msgid "(Added in 1.0.59)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2392 +#: ../src/guestfs-actions.pod:2632 msgid "guestfs_glob_expand" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2394 +#: ../src/guestfs-actions.pod:2634 #, no-wrap msgid "" " char **\n" @@ -26201,17 +26726,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2413 ../src/guestfs-actions.pod:6872 ../src/guestfs-actions.pod:6889 +#: ../src/guestfs-actions.pod:2653 ../src/guestfs-actions.pod:7130 ../src/guestfs-actions.pod:7147 msgid "(Added in 1.0.50)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2415 +#: ../src/guestfs-actions.pod:2655 msgid "guestfs_grep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2417 +#: ../src/guestfs-actions.pod:2657 #, no-wrap msgid "" " char **\n" @@ -26222,12 +26747,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2434 +#: ../src/guestfs-actions.pod:2674 msgid "guestfs_grepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2436 +#: ../src/guestfs-actions.pod:2676 #, no-wrap msgid "" " char **\n" @@ -26238,12 +26763,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2453 +#: ../src/guestfs-actions.pod:2693 msgid "guestfs_grub_install" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2455 +#: ../src/guestfs-actions.pod:2695 #, no-wrap msgid "" " int\n" @@ -26254,17 +26779,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2498 +#: ../src/guestfs-actions.pod:2738 msgid "(Added in 1.0.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2500 +#: ../src/guestfs-actions.pod:2740 msgid "guestfs_head" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2502 +#: ../src/guestfs-actions.pod:2742 #, no-wrap msgid "" " char **\n" @@ -26274,12 +26799,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2518 +#: ../src/guestfs-actions.pod:2758 msgid "guestfs_head_n" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2520 +#: ../src/guestfs-actions.pod:2760 #, no-wrap msgid "" " char **\n" @@ -26290,12 +26815,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2542 +#: ../src/guestfs-actions.pod:2782 msgid "guestfs_hexdump" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2544 +#: ../src/guestfs-actions.pod:2784 #, no-wrap msgid "" " char *\n" @@ -26305,17 +26830,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2557 ../src/guestfs-actions.pod:6953 ../src/guestfs-actions.pod:7008 +#: ../src/guestfs-actions.pod:2797 ../src/guestfs-actions.pod:7211 ../src/guestfs-actions.pod:7266 msgid "(Added in 1.0.22)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2559 +#: ../src/guestfs-actions.pod:2799 msgid "guestfs_initrd_cat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2561 +#: ../src/guestfs-actions.pod:2801 #, no-wrap msgid "" " char *\n" @@ -26327,17 +26852,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2577 +#: ../src/guestfs-actions.pod:2817 msgid "See also C<guestfs_initrd_list>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2588 +#: ../src/guestfs-actions.pod:2828 msgid "guestfs_initrd_list" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2590 +#: ../src/guestfs-actions.pod:2830 #, no-wrap msgid "" " char **\n" @@ -26347,12 +26872,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2610 +#: ../src/guestfs-actions.pod:2850 msgid "guestfs_inotify_add_watch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2612 +#: ../src/guestfs-actions.pod:2852 #, no-wrap msgid "" " int64_t\n" @@ -26363,12 +26888,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2631 +#: ../src/guestfs-actions.pod:2871 msgid "guestfs_inotify_close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2633 +#: ../src/guestfs-actions.pod:2873 #, no-wrap msgid "" " int\n" @@ -26377,12 +26902,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2644 +#: ../src/guestfs-actions.pod:2884 msgid "guestfs_inotify_files" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2646 +#: ../src/guestfs-actions.pod:2886 #, no-wrap msgid "" " char **\n" @@ -26391,7 +26916,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2649 +#: ../src/guestfs-actions.pod:2889 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 " @@ -26399,12 +26924,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2659 +#: ../src/guestfs-actions.pod:2899 msgid "guestfs_inotify_init" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2661 +#: ../src/guestfs-actions.pod:2901 #, no-wrap msgid "" " int\n" @@ -26414,7 +26939,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2669 +#: ../src/guestfs-actions.pod:2909 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 " @@ -26426,7 +26951,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2679 +#: ../src/guestfs-actions.pod:2919 msgid "" "Before any events are generated, you have to add some watches to the " "internal watch list. See: C<guestfs_inotify_add_watch>, " @@ -26434,7 +26959,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2685 +#: ../src/guestfs-actions.pod:2925 msgid "" "Queued up events should be read periodically by calling " "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful " @@ -26443,19 +26968,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2692 +#: ../src/guestfs-actions.pod:2932 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:2705 +#: ../src/guestfs-actions.pod:2945 msgid "guestfs_inotify_read" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2707 +#: ../src/guestfs-actions.pod:2947 #, no-wrap msgid "" " struct guestfs_inotify_event_list *\n" @@ -26464,7 +26989,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2721 +#: ../src/guestfs-actions.pod:2961 msgid "" "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if " "there was an error. I<The caller must call " @@ -26472,12 +26997,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2727 +#: ../src/guestfs-actions.pod:2967 msgid "guestfs_inotify_rm_watch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2729 +#: ../src/guestfs-actions.pod:2969 #, no-wrap msgid "" " int\n" @@ -26487,19 +27012,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2733 +#: ../src/guestfs-actions.pod:2973 msgid "" "Remove a previously defined inotify watch. See " "C<guestfs_inotify_add_watch>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2740 +#: ../src/guestfs-actions.pod:2980 msgid "guestfs_inspect_get_arch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2742 +#: ../src/guestfs-actions.pod:2982 #, no-wrap msgid "" " char *\n" @@ -26509,19 +27034,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2746 +#: ../src/guestfs-actions.pod:2986 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:2760 +#: ../src/guestfs-actions.pod:3000 msgid "guestfs_inspect_get_distro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2762 +#: ../src/guestfs-actions.pod:3002 #, no-wrap msgid "" " char *\n" @@ -26531,12 +27056,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2862 +#: ../src/guestfs-actions.pod:3102 msgid "guestfs_inspect_get_drive_mappings" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2864 +#: ../src/guestfs-actions.pod:3104 #, no-wrap msgid "" " char **\n" @@ -26546,14 +27071,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2893 +#: ../src/guestfs-actions.pod:3133 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:2897 ../src/guestfs-actions.pod:3165 ../src/guestfs-actions.pod:3968 ../src/guestfs-actions.pod:5240 ../src/guestfs-actions.pod:7310 +#: ../src/guestfs-actions.pod:3137 ../src/guestfs-actions.pod:3405 ../src/guestfs-actions.pod:4208 ../src/guestfs-actions.pod:5480 ../src/guestfs-actions.pod:7568 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 " @@ -26562,17 +27087,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2903 ../src/guestfs-actions.pod:3364 +#: ../src/guestfs-actions.pod:3143 ../src/guestfs-actions.pod:3604 msgid "(Added in 1.9.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2905 +#: ../src/guestfs-actions.pod:3145 msgid "guestfs_inspect_get_filesystems" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2907 +#: ../src/guestfs-actions.pod:3147 #, no-wrap msgid "" " char **\n" @@ -26582,19 +27107,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2919 +#: ../src/guestfs-actions.pod:3159 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_mountpoints>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2928 +#: ../src/guestfs-actions.pod:3168 msgid "guestfs_inspect_get_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2930 +#: ../src/guestfs-actions.pod:3170 #, no-wrap msgid "" " char *\n" @@ -26604,17 +27129,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2964 ../src/guestfs-actions.pod:3400 ../src/guestfs-actions.pod:3416 ../src/guestfs-actions.pod:3434 ../src/guestfs-actions.pod:6190 +#: ../src/guestfs-actions.pod:3204 ../src/guestfs-actions.pod:3640 ../src/guestfs-actions.pod:3656 ../src/guestfs-actions.pod:3674 ../src/guestfs-actions.pod:6448 msgid "(Added in 1.9.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2966 +#: ../src/guestfs-actions.pod:3206 msgid "guestfs_inspect_get_hostname" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2968 +#: ../src/guestfs-actions.pod:3208 #, no-wrap msgid "" " char *\n" @@ -26624,17 +27149,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2983 +#: ../src/guestfs-actions.pod:3223 msgid "(Added in 1.7.9)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2985 +#: ../src/guestfs-actions.pod:3225 msgid "guestfs_inspect_get_icon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2987 +#: ../src/guestfs-actions.pod:3227 #, no-wrap msgid "" " char *\n" @@ -26646,7 +27171,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2998 +#: ../src/guestfs-actions.pod:3238 #, no-wrap msgid "" " GUESTFS_INSPECT_GET_ICON_FAVICON, int favicon,\n" @@ -26655,17 +27180,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3065 ../src/guestfs-actions.pod:3895 ../src/guestfs-actions.pod:5139 +#: ../src/guestfs-actions.pod:3305 ../src/guestfs-actions.pod:4135 ../src/guestfs-actions.pod:5379 msgid "(Added in 1.11.12)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3067 +#: ../src/guestfs-actions.pod:3307 msgid "guestfs_inspect_get_icon_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3069 +#: ../src/guestfs-actions.pod:3309 #, no-wrap msgid "" " char *\n" @@ -26677,17 +27202,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3075 +#: ../src/guestfs-actions.pod:3315 msgid "This is the \"va_list variant\" of L</guestfs_inspect_get_icon>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3079 +#: ../src/guestfs-actions.pod:3319 msgid "guestfs_inspect_get_icon_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3081 +#: ../src/guestfs-actions.pod:3321 #, no-wrap msgid "" " char *\n" @@ -26700,17 +27225,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3087 +#: ../src/guestfs-actions.pod:3327 msgid "This is the \"argv variant\" of L</guestfs_inspect_get_icon>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3091 +#: ../src/guestfs-actions.pod:3331 msgid "guestfs_inspect_get_major_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3093 +#: ../src/guestfs-actions.pod:3333 #, no-wrap msgid "" " int\n" @@ -26720,12 +27245,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3115 +#: ../src/guestfs-actions.pod:3355 msgid "guestfs_inspect_get_minor_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3117 +#: ../src/guestfs-actions.pod:3357 #, no-wrap msgid "" " int\n" @@ -26735,19 +27260,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3126 +#: ../src/guestfs-actions.pod:3366 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:3133 +#: ../src/guestfs-actions.pod:3373 msgid "guestfs_inspect_get_mountpoints" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3135 +#: ../src/guestfs-actions.pod:3375 #, no-wrap msgid "" " char **\n" @@ -26757,7 +27282,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3156 +#: ../src/guestfs-actions.pod:3396 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 " @@ -26766,19 +27291,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3162 +#: ../src/guestfs-actions.pod:3402 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3173 +#: ../src/guestfs-actions.pod:3413 msgid "guestfs_inspect_get_package_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3175 +#: ../src/guestfs-actions.pod:3415 #, no-wrap msgid "" " char *\n" @@ -26788,7 +27313,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3179 +#: ../src/guestfs-actions.pod:3419 msgid "" "This function and C<guestfs_inspect_get_package_management> return the " "package format and package management tool used by the inspected operating " @@ -26797,17 +27322,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3198 ../src/guestfs-actions.pod:3226 +#: ../src/guestfs-actions.pod:3438 ../src/guestfs-actions.pod:3466 msgid "(Added in 1.7.5)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3200 +#: ../src/guestfs-actions.pod:3440 msgid "guestfs_inspect_get_package_management" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3202 +#: ../src/guestfs-actions.pod:3442 #, no-wrap msgid "" " char *\n" @@ -26817,7 +27342,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3206 +#: ../src/guestfs-actions.pod:3446 msgid "" "C<guestfs_inspect_get_package_format> and this function return the package " "format and package management tool used by the inspected operating system. " @@ -26826,12 +27351,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3228 +#: ../src/guestfs-actions.pod:3468 msgid "guestfs_inspect_get_product_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3230 +#: ../src/guestfs-actions.pod:3470 #, no-wrap msgid "" " char *\n" @@ -26841,12 +27366,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3249 +#: ../src/guestfs-actions.pod:3489 msgid "guestfs_inspect_get_product_variant" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3251 +#: ../src/guestfs-actions.pod:3491 #, no-wrap msgid "" " char *\n" @@ -26856,24 +27381,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3274 +#: ../src/guestfs-actions.pod:3514 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:3281 +#: ../src/guestfs-actions.pod:3521 msgid "(Added in 1.9.13)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3283 +#: ../src/guestfs-actions.pod:3523 msgid "guestfs_inspect_get_roots" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3285 +#: ../src/guestfs-actions.pod:3525 #, no-wrap msgid "" " char **\n" @@ -26882,7 +27407,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3288 +#: ../src/guestfs-actions.pod:3528 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 " @@ -26890,24 +27415,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3292 +#: ../src/guestfs-actions.pod:3532 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:3301 +#: ../src/guestfs-actions.pod:3541 msgid "(Added in 1.7.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3303 +#: ../src/guestfs-actions.pod:3543 msgid "guestfs_inspect_get_type" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3305 +#: ../src/guestfs-actions.pod:3545 #, no-wrap msgid "" " char *\n" @@ -26917,12 +27442,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3346 +#: ../src/guestfs-actions.pod:3586 msgid "guestfs_inspect_get_windows_current_control_set" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3348 +#: ../src/guestfs-actions.pod:3588 #, no-wrap msgid "" " char *\n" @@ -26932,12 +27457,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3366 +#: ../src/guestfs-actions.pod:3606 msgid "guestfs_inspect_get_windows_systemroot" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3368 +#: ../src/guestfs-actions.pod:3608 #, no-wrap msgid "" " char *\n" @@ -26947,17 +27472,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3384 +#: ../src/guestfs-actions.pod:3624 msgid "(Added in 1.5.25)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3386 +#: ../src/guestfs-actions.pod:3626 msgid "guestfs_inspect_is_live" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3388 +#: ../src/guestfs-actions.pod:3628 #, no-wrap msgid "" " int\n" @@ -26967,19 +27492,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3392 +#: ../src/guestfs-actions.pod:3632 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:3402 +#: ../src/guestfs-actions.pod:3642 msgid "guestfs_inspect_is_multipart" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3404 +#: ../src/guestfs-actions.pod:3644 #, no-wrap msgid "" " int\n" @@ -26989,19 +27514,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3408 +#: ../src/guestfs-actions.pod:3648 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:3418 +#: ../src/guestfs-actions.pod:3658 msgid "guestfs_inspect_is_netinst" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3420 +#: ../src/guestfs-actions.pod:3660 #, no-wrap msgid "" " int\n" @@ -27011,7 +27536,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3424 +#: ../src/guestfs-actions.pod:3664 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 " @@ -27020,12 +27545,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3436 +#: ../src/guestfs-actions.pod:3676 msgid "guestfs_inspect_list_applications" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3438 +#: ../src/guestfs-actions.pod:3678 #, no-wrap msgid "" " struct guestfs_application_list *\n" @@ -27035,7 +27560,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3444 +#: ../src/guestfs-actions.pod:3684 msgid "" "I<Note:> This call works differently from other parts of the inspection " "API. You have to call C<guestfs_inspect_os>, then " @@ -27048,7 +27573,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3534 +#: ../src/guestfs-actions.pod:3774 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> " @@ -27056,17 +27581,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3538 +#: ../src/guestfs-actions.pod:3778 msgid "(Added in 1.7.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3540 +#: ../src/guestfs-actions.pod:3780 msgid "guestfs_inspect_os" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3542 +#: ../src/guestfs-actions.pod:3782 #, no-wrap msgid "" " char **\n" @@ -27075,7 +27600,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3558 +#: ../src/guestfs-actions.pod:3798 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, " @@ -27083,7 +27608,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3563 +#: ../src/guestfs-actions.pod:3803 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 " @@ -27092,17 +27617,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3575 ../src/guestfs-actions.pod:3906 ../src/guestfs-actions.pod:3988 +#: ../src/guestfs-actions.pod:3815 ../src/guestfs-actions.pod:4146 ../src/guestfs-actions.pod:4228 msgid "See also C<guestfs_list_filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3583 +#: ../src/guestfs-actions.pod:3823 msgid "guestfs_is_blockdev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3585 +#: ../src/guestfs-actions.pod:3825 #, no-wrap msgid "" " int\n" @@ -27112,22 +27637,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3592 ../src/guestfs-actions.pod:3621 ../src/guestfs-actions.pod:3651 ../src/guestfs-actions.pod:3666 ../src/guestfs-actions.pod:3682 ../src/guestfs-actions.pod:3738 ../src/guestfs-actions.pod:3753 +#: ../src/guestfs-actions.pod:3832 ../src/guestfs-actions.pod:3861 ../src/guestfs-actions.pod:3891 ../src/guestfs-actions.pod:3906 ../src/guestfs-actions.pod:3922 ../src/guestfs-actions.pod:3978 ../src/guestfs-actions.pod:3993 msgid "See also C<guestfs_stat>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3596 ../src/guestfs-actions.pod:3625 ../src/guestfs-actions.pod:3670 ../src/guestfs-actions.pod:3742 ../src/guestfs-actions.pod:3757 +#: ../src/guestfs-actions.pod:3836 ../src/guestfs-actions.pod:3865 ../src/guestfs-actions.pod:3910 ../src/guestfs-actions.pod:3982 ../src/guestfs-actions.pod:3997 msgid "(Added in 1.5.10)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3598 +#: ../src/guestfs-actions.pod:3838 msgid "guestfs_is_busy" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3600 +#: ../src/guestfs-actions.pod:3840 #, no-wrap msgid "" " int\n" @@ -27136,12 +27661,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3612 +#: ../src/guestfs-actions.pod:3852 msgid "guestfs_is_chardev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3614 +#: ../src/guestfs-actions.pod:3854 #, no-wrap msgid "" " int\n" @@ -27151,12 +27676,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3627 +#: ../src/guestfs-actions.pod:3867 msgid "guestfs_is_config" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3629 +#: ../src/guestfs-actions.pod:3869 #, no-wrap msgid "" " int\n" @@ -27165,12 +27690,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3641 +#: ../src/guestfs-actions.pod:3881 msgid "guestfs_is_dir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3643 +#: ../src/guestfs-actions.pod:3883 #, no-wrap msgid "" " int\n" @@ -27180,12 +27705,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3657 +#: ../src/guestfs-actions.pod:3897 msgid "guestfs_is_fifo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3659 +#: ../src/guestfs-actions.pod:3899 #, no-wrap msgid "" " int\n" @@ -27195,12 +27720,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3672 +#: ../src/guestfs-actions.pod:3912 msgid "guestfs_is_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3674 +#: ../src/guestfs-actions.pod:3914 #, no-wrap msgid "" " int\n" @@ -27210,12 +27735,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3688 +#: ../src/guestfs-actions.pod:3928 msgid "guestfs_is_launching" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3690 +#: ../src/guestfs-actions.pod:3930 #, no-wrap msgid "" " int\n" @@ -27224,12 +27749,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3702 +#: ../src/guestfs-actions.pod:3942 msgid "guestfs_is_lv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3704 +#: ../src/guestfs-actions.pod:3944 #, no-wrap msgid "" " int\n" @@ -27239,12 +27764,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3715 +#: ../src/guestfs-actions.pod:3955 msgid "guestfs_is_ready" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3717 +#: ../src/guestfs-actions.pod:3957 #, no-wrap msgid "" " int\n" @@ -27253,12 +27778,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3729 +#: ../src/guestfs-actions.pod:3969 msgid "guestfs_is_socket" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3731 +#: ../src/guestfs-actions.pod:3971 #, no-wrap msgid "" " int\n" @@ -27268,12 +27793,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3744 +#: ../src/guestfs-actions.pod:3984 msgid "guestfs_is_symlink" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3746 +#: ../src/guestfs-actions.pod:3986 #, no-wrap msgid "" " int\n" @@ -27283,12 +27808,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3759 +#: ../src/guestfs-actions.pod:3999 msgid "guestfs_is_zero" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3761 +#: ../src/guestfs-actions.pod:4001 #, no-wrap msgid "" " int\n" @@ -27298,17 +27823,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3770 ../src/guestfs-actions.pod:3784 +#: ../src/guestfs-actions.pod:4010 ../src/guestfs-actions.pod:4024 msgid "(Added in 1.11.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3772 +#: ../src/guestfs-actions.pod:4012 msgid "guestfs_is_zero_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3774 +#: ../src/guestfs-actions.pod:4014 #, no-wrap msgid "" " int\n" @@ -27318,12 +27843,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3786 +#: ../src/guestfs-actions.pod:4026 msgid "guestfs_kill_subprocess" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3788 +#: ../src/guestfs-actions.pod:4028 #, no-wrap msgid "" " int\n" @@ -27332,12 +27857,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3797 +#: ../src/guestfs-actions.pod:4037 msgid "guestfs_launch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3799 +#: ../src/guestfs-actions.pod:4039 #, no-wrap msgid "" " int\n" @@ -27346,12 +27871,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3817 +#: ../src/guestfs-actions.pod:4057 msgid "guestfs_lchown" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3819 +#: ../src/guestfs-actions.pod:4059 #, no-wrap msgid "" " int\n" @@ -27363,7 +27888,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3825 +#: ../src/guestfs-actions.pod:4065 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 " @@ -27371,12 +27896,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3837 +#: ../src/guestfs-actions.pod:4077 msgid "guestfs_lgetxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3839 +#: ../src/guestfs-actions.pod:4079 #, no-wrap msgid "" " char *\n" @@ -27388,17 +27913,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3859 +#: ../src/guestfs-actions.pod:4099 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3867 +#: ../src/guestfs-actions.pod:4107 msgid "guestfs_lgetxattrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3869 +#: ../src/guestfs-actions.pod:4109 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -27408,19 +27933,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3873 +#: ../src/guestfs-actions.pod:4113 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:3883 +#: ../src/guestfs-actions.pod:4123 msgid "guestfs_list_9p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3885 +#: ../src/guestfs-actions.pod:4125 #, no-wrap msgid "" " char **\n" @@ -27429,12 +27954,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3897 +#: ../src/guestfs-actions.pod:4137 msgid "guestfs_list_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3899 +#: ../src/guestfs-actions.pod:4139 #, no-wrap msgid "" " char **\n" @@ -27443,12 +27968,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3914 +#: ../src/guestfs-actions.pod:4154 msgid "guestfs_list_dm_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3916 +#: ../src/guestfs-actions.pod:4156 #, no-wrap msgid "" " char **\n" @@ -27457,14 +27982,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3921 +#: ../src/guestfs-actions.pod:4161 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:3924 +#: ../src/guestfs-actions.pod:4164 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 " @@ -27472,17 +27997,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3932 ../src/guestfs-actions.pod:5378 +#: ../src/guestfs-actions.pod:4172 ../src/guestfs-actions.pod:5618 msgid "(Added in 1.11.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3934 +#: ../src/guestfs-actions.pod:4174 msgid "guestfs_list_filesystems" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3936 +#: ../src/guestfs-actions.pod:4176 #, no-wrap msgid "" " char **\n" @@ -27491,7 +28016,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3956 +#: ../src/guestfs-actions.pod:4196 msgid "" "This command runs other libguestfs commands, which might include " "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this " @@ -27499,7 +28024,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3960 +#: ../src/guestfs-actions.pod:4200 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 " @@ -27510,17 +28035,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3974 ../src/guestfs-actions.pod:5739 +#: ../src/guestfs-actions.pod:4214 ../src/guestfs-actions.pod:5981 msgid "(Added in 1.5.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3976 +#: ../src/guestfs-actions.pod:4216 msgid "guestfs_list_partitions" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3978 +#: ../src/guestfs-actions.pod:4218 #, no-wrap msgid "" " char **\n" @@ -27529,19 +28054,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3985 +#: ../src/guestfs-actions.pod:4225 msgid "" "This does not return logical volumes. For that you will need to call " "C<guestfs_lvs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3996 +#: ../src/guestfs-actions.pod:4236 msgid "guestfs_ll" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3998 +#: ../src/guestfs-actions.pod:4238 #, no-wrap msgid "" " char *\n" @@ -27551,12 +28076,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4013 +#: ../src/guestfs-actions.pod:4253 msgid "guestfs_ln" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4015 +#: ../src/guestfs-actions.pod:4255 #, no-wrap msgid "" " int\n" @@ -27567,12 +28092,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4026 +#: ../src/guestfs-actions.pod:4266 msgid "guestfs_ln_f" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4028 +#: ../src/guestfs-actions.pod:4268 #, no-wrap msgid "" " int\n" @@ -27583,12 +28108,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4040 +#: ../src/guestfs-actions.pod:4280 msgid "guestfs_ln_s" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4042 +#: ../src/guestfs-actions.pod:4282 #, no-wrap msgid "" " int\n" @@ -27599,12 +28124,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4053 +#: ../src/guestfs-actions.pod:4293 msgid "guestfs_ln_sf" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4055 +#: ../src/guestfs-actions.pod:4295 #, no-wrap msgid "" " int\n" @@ -27615,12 +28140,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4067 +#: ../src/guestfs-actions.pod:4307 msgid "guestfs_lremovexattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4069 +#: ../src/guestfs-actions.pod:4309 #, no-wrap msgid "" " int\n" @@ -27631,19 +28156,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4074 +#: ../src/guestfs-actions.pod:4314 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:4082 +#: ../src/guestfs-actions.pod:4322 msgid "guestfs_ls" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4084 +#: ../src/guestfs-actions.pod:4324 #, no-wrap msgid "" " char **\n" @@ -27653,19 +28178,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4092 +#: ../src/guestfs-actions.pod:4332 msgid "" "This command is mostly useful for interactive sessions. Programs should " "probably use C<guestfs_readdir> instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4101 +#: ../src/guestfs-actions.pod:4341 msgid "guestfs_lsetxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4103 +#: ../src/guestfs-actions.pod:4343 #, no-wrap msgid "" " int\n" @@ -27678,19 +28203,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4110 +#: ../src/guestfs-actions.pod:4350 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:4118 +#: ../src/guestfs-actions.pod:4358 msgid "guestfs_lstat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4120 +#: ../src/guestfs-actions.pod:4360 #, no-wrap msgid "" " struct guestfs_stat *\n" @@ -27700,31 +28225,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4126 +#: ../src/guestfs-actions.pod:4366 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:4132 ../src/guestfs-actions.pod:6913 +#: ../src/guestfs-actions.pod:4372 ../src/guestfs-actions.pod:7171 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:4136 ../src/guestfs-actions.pod:6917 ../src/guestfs-actions.pod:6935 ../src/guestfs-actions.pod:7316 +#: ../src/guestfs-actions.pod:4376 ../src/guestfs-actions.pod:7175 ../src/guestfs-actions.pod:7193 ../src/guestfs-actions.pod:7574 msgid "(Added in 0.9.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4138 +#: ../src/guestfs-actions.pod:4378 msgid "guestfs_lstatlist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4140 +#: ../src/guestfs-actions.pod:4380 #, no-wrap msgid "" " struct guestfs_stat_list *\n" @@ -27735,7 +28260,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4145 +#: ../src/guestfs-actions.pod:4385 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 " @@ -27743,7 +28268,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4154 +#: ../src/guestfs-actions.pod:4394 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> " @@ -27754,19 +28279,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4162 +#: ../src/guestfs-actions.pod:4402 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:4168 +#: ../src/guestfs-actions.pod:4408 msgid "guestfs_luks_add_key" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4170 +#: ../src/guestfs-actions.pod:4410 #, no-wrap msgid "" " int\n" @@ -27779,14 +28304,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4182 +#: ../src/guestfs-actions.pod:4422 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:4188 ../src/guestfs-actions.pod:4228 ../src/guestfs-actions.pod:4251 ../src/guestfs-actions.pod:4271 ../src/guestfs-actions.pod:4306 ../src/guestfs-actions.pod:4325 +#: ../src/guestfs-actions.pod:4428 ../src/guestfs-actions.pod:4468 ../src/guestfs-actions.pod:4491 ../src/guestfs-actions.pod:4511 ../src/guestfs-actions.pod:4546 ../src/guestfs-actions.pod:4565 msgid "" "This function takes a key or passphrase parameter which could contain " "sensitive material. Read the section L</KEYS AND PASSPHRASES> for more " @@ -27794,17 +28319,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4192 ../src/guestfs-actions.pod:4232 ../src/guestfs-actions.pod:4255 ../src/guestfs-actions.pod:4275 +#: ../src/guestfs-actions.pod:4432 ../src/guestfs-actions.pod:4472 ../src/guestfs-actions.pod:4495 ../src/guestfs-actions.pod:4515 msgid "(Added in 1.5.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4194 +#: ../src/guestfs-actions.pod:4434 msgid "guestfs_luks_close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4196 +#: ../src/guestfs-actions.pod:4436 #, no-wrap msgid "" " int\n" @@ -27814,7 +28339,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4200 +#: ../src/guestfs-actions.pod:4440 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 " @@ -27823,17 +28348,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4208 ../src/guestfs-actions.pod:4310 ../src/guestfs-actions.pod:4329 ../src/guestfs-actions.pod:4379 ../src/guestfs-actions.pod:4427 +#: ../src/guestfs-actions.pod:4448 ../src/guestfs-actions.pod:4550 ../src/guestfs-actions.pod:4569 ../src/guestfs-actions.pod:4619 ../src/guestfs-actions.pod:4667 msgid "(Added in 1.5.1)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4210 +#: ../src/guestfs-actions.pod:4450 msgid "guestfs_luks_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4212 +#: ../src/guestfs-actions.pod:4452 #, no-wrap msgid "" " int\n" @@ -27845,12 +28370,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4234 +#: ../src/guestfs-actions.pod:4474 msgid "guestfs_luks_format_cipher" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4236 +#: ../src/guestfs-actions.pod:4476 #, no-wrap msgid "" " int\n" @@ -27863,19 +28388,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4243 +#: ../src/guestfs-actions.pod:4483 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:4257 +#: ../src/guestfs-actions.pod:4497 msgid "guestfs_luks_kill_slot" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4259 +#: ../src/guestfs-actions.pod:4499 #, no-wrap msgid "" " int\n" @@ -27887,12 +28412,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4277 +#: ../src/guestfs-actions.pod:4517 msgid "guestfs_luks_open" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4279 +#: ../src/guestfs-actions.pod:4519 #, no-wrap msgid "" " int\n" @@ -27904,7 +28429,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4297 +#: ../src/guestfs-actions.pod:4537 msgid "" "If this block device contains LVM volume groups, then calling " "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them " @@ -27912,17 +28437,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4301 +#: ../src/guestfs-actions.pod:4541 msgid "Use C<guestfs_list_dm_devices> to list all device mapper devices." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4312 +#: ../src/guestfs-actions.pod:4552 msgid "guestfs_luks_open_ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4314 +#: ../src/guestfs-actions.pod:4554 #, no-wrap msgid "" " int\n" @@ -27934,19 +28459,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4320 +#: ../src/guestfs-actions.pod:4560 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:4331 +#: ../src/guestfs-actions.pod:4571 msgid "guestfs_lvcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4333 +#: ../src/guestfs-actions.pod:4573 #, no-wrap msgid "" " int\n" @@ -27958,12 +28483,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4346 +#: ../src/guestfs-actions.pod:4586 msgid "guestfs_lvm_canonical_lv_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4348 +#: ../src/guestfs-actions.pod:4588 #, no-wrap msgid "" " char *\n" @@ -27973,22 +28498,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4359 +#: ../src/guestfs-actions.pod:4599 msgid "See also C<guestfs_is_lv>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4364 +#: ../src/guestfs-actions.pod:4604 msgid "(Added in 1.5.24)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4366 +#: ../src/guestfs-actions.pod:4606 msgid "guestfs_lvm_clear_filter" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4368 +#: ../src/guestfs-actions.pod:4608 #, no-wrap msgid "" " int\n" @@ -27997,19 +28522,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4371 +#: ../src/guestfs-actions.pod:4611 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:4381 +#: ../src/guestfs-actions.pod:4621 msgid "guestfs_lvm_remove_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4383 +#: ../src/guestfs-actions.pod:4623 #, no-wrap msgid "" " int\n" @@ -28018,12 +28543,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4396 +#: ../src/guestfs-actions.pod:4636 msgid "guestfs_lvm_set_filter" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4398 +#: ../src/guestfs-actions.pod:4638 #, no-wrap msgid "" " int\n" @@ -28033,12 +28558,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4429 +#: ../src/guestfs-actions.pod:4669 msgid "guestfs_lvremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4431 +#: ../src/guestfs-actions.pod:4671 #, no-wrap msgid "" " int\n" @@ -28048,17 +28573,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4443 ../src/guestfs-actions.pod:5836 ../src/guestfs-actions.pod:7686 +#: ../src/guestfs-actions.pod:4683 ../src/guestfs-actions.pod:6094 ../src/guestfs-actions.pod:7944 msgid "(Added in 1.0.13)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4445 +#: ../src/guestfs-actions.pod:4685 msgid "guestfs_lvrename" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4447 +#: ../src/guestfs-actions.pod:4687 #, no-wrap msgid "" " int\n" @@ -28069,17 +28594,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4456 ../src/guestfs-actions.pod:7699 +#: ../src/guestfs-actions.pod:4696 ../src/guestfs-actions.pod:7957 msgid "(Added in 1.0.83)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4458 +#: ../src/guestfs-actions.pod:4698 msgid "guestfs_lvresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4460 +#: ../src/guestfs-actions.pod:4700 #, no-wrap msgid "" " int\n" @@ -28090,12 +28615,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4473 +#: ../src/guestfs-actions.pod:4713 msgid "guestfs_lvresize_free" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4475 +#: ../src/guestfs-actions.pod:4715 #, no-wrap msgid "" " int\n" @@ -28106,17 +28631,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4488 +#: ../src/guestfs-actions.pod:4728 msgid "(Added in 1.3.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4490 +#: ../src/guestfs-actions.pod:4730 msgid "guestfs_lvs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4492 +#: ../src/guestfs-actions.pod:4732 #, no-wrap msgid "" " char **\n" @@ -28125,17 +28650,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4501 +#: ../src/guestfs-actions.pod:4741 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4509 +#: ../src/guestfs-actions.pod:4749 msgid "guestfs_lvs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4511 +#: ../src/guestfs-actions.pod:4751 #, no-wrap msgid "" " struct guestfs_lvm_lv_list *\n" @@ -28144,7 +28669,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4517 +#: ../src/guestfs-actions.pod:4757 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 " @@ -28152,12 +28677,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4523 +#: ../src/guestfs-actions.pod:4763 msgid "guestfs_lvuuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4525 +#: ../src/guestfs-actions.pod:4765 #, no-wrap msgid "" " char *\n" @@ -28167,12 +28692,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4536 +#: ../src/guestfs-actions.pod:4776 msgid "guestfs_lxattrlist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4538 +#: ../src/guestfs-actions.pod:4778 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -28183,7 +28708,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4557 +#: ../src/guestfs-actions.pod:4797 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 " @@ -28194,12 +28719,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4571 +#: ../src/guestfs-actions.pod:4811 msgid "guestfs_mkdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4573 +#: ../src/guestfs-actions.pod:4813 #, no-wrap msgid "" " int\n" @@ -28209,12 +28734,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4583 +#: ../src/guestfs-actions.pod:4823 msgid "guestfs_mkdir_mode" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4585 +#: ../src/guestfs-actions.pod:4825 #, no-wrap msgid "" " int\n" @@ -28225,17 +28750,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4597 +#: ../src/guestfs-actions.pod:4837 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4603 +#: ../src/guestfs-actions.pod:4843 msgid "guestfs_mkdir_p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4605 +#: ../src/guestfs-actions.pod:4845 #, no-wrap msgid "" " int\n" @@ -28245,12 +28770,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4616 +#: ../src/guestfs-actions.pod:4856 msgid "guestfs_mkdtemp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4618 +#: ../src/guestfs-actions.pod:4858 #, no-wrap msgid "" " char *\n" @@ -28260,12 +28785,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4646 +#: ../src/guestfs-actions.pod:4886 msgid "guestfs_mke2fs_J" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4648 +#: ../src/guestfs-actions.pod:4888 #, no-wrap msgid "" " int\n" @@ -28278,22 +28803,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4661 +#: ../src/guestfs-actions.pod:4901 msgid "See also C<guestfs_mke2journal>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4665 ../src/guestfs-actions.pod:4683 ../src/guestfs-actions.pod:4701 ../src/guestfs-actions.pod:4717 ../src/guestfs-actions.pod:4731 ../src/guestfs-actions.pod:4745 ../src/guestfs-actions.pod:4804 ../src/guestfs-actions.pod:5081 +#: ../src/guestfs-actions.pod:4905 ../src/guestfs-actions.pod:4923 ../src/guestfs-actions.pod:4941 ../src/guestfs-actions.pod:4957 ../src/guestfs-actions.pod:4971 ../src/guestfs-actions.pod:4985 ../src/guestfs-actions.pod:5044 ../src/guestfs-actions.pod:5321 msgid "(Added in 1.0.68)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4667 +#: ../src/guestfs-actions.pod:4907 msgid "guestfs_mke2fs_JL" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4669 +#: ../src/guestfs-actions.pod:4909 #, no-wrap msgid "" " int\n" @@ -28306,17 +28831,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4679 +#: ../src/guestfs-actions.pod:4919 msgid "See also C<guestfs_mke2journal_L>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4685 +#: ../src/guestfs-actions.pod:4925 msgid "guestfs_mke2fs_JU" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4687 +#: ../src/guestfs-actions.pod:4927 #, no-wrap msgid "" " int\n" @@ -28329,17 +28854,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4697 +#: ../src/guestfs-actions.pod:4937 msgid "See also C<guestfs_mke2journal_U>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4703 +#: ../src/guestfs-actions.pod:4943 msgid "guestfs_mke2journal" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4705 +#: ../src/guestfs-actions.pod:4945 #, no-wrap msgid "" " int\n" @@ -28350,12 +28875,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4719 +#: ../src/guestfs-actions.pod:4959 msgid "guestfs_mke2journal_L" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4721 +#: ../src/guestfs-actions.pod:4961 #, no-wrap msgid "" " int\n" @@ -28367,12 +28892,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4733 +#: ../src/guestfs-actions.pod:4973 msgid "guestfs_mke2journal_U" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4735 +#: ../src/guestfs-actions.pod:4975 #, no-wrap msgid "" " int\n" @@ -28384,12 +28909,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4747 +#: ../src/guestfs-actions.pod:4987 msgid "guestfs_mkfifo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4749 +#: ../src/guestfs-actions.pod:4989 #, no-wrap msgid "" " int\n" @@ -28400,19 +28925,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4754 +#: ../src/guestfs-actions.pod:4994 msgid "" "This call creates a FIFO (named pipe) called C<path> with mode C<mode>. It " "is just a convenient wrapper around C<guestfs_mknod>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4764 +#: ../src/guestfs-actions.pod:5004 msgid "guestfs_mkfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4766 +#: ../src/guestfs-actions.pod:5006 #, no-wrap msgid "" " int\n" @@ -28423,12 +28948,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4779 +#: ../src/guestfs-actions.pod:5019 msgid "guestfs_mkfs_b" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4781 +#: ../src/guestfs-actions.pod:5021 #, no-wrap msgid "" " int\n" @@ -28440,14 +28965,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4787 +#: ../src/guestfs-actions.pod:5027 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_mkfs_opts> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4794 +#: ../src/guestfs-actions.pod:5034 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 " @@ -28455,12 +28980,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4806 +#: ../src/guestfs-actions.pod:5046 msgid "guestfs_mkfs_opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4808 +#: ../src/guestfs-actions.pod:5048 #, no-wrap msgid "" " int\n" @@ -28472,7 +28997,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4819 +#: ../src/guestfs-actions.pod:5059 #, no-wrap msgid "" " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n" @@ -28483,17 +29008,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4867 +#: ../src/guestfs-actions.pod:5107 msgid "(Added in 1.7.19)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4869 +#: ../src/guestfs-actions.pod:5109 msgid "guestfs_mkfs_opts_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4871 +#: ../src/guestfs-actions.pod:5111 #, no-wrap msgid "" " int\n" @@ -28505,17 +29030,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4877 +#: ../src/guestfs-actions.pod:5117 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4881 +#: ../src/guestfs-actions.pod:5121 msgid "guestfs_mkfs_opts_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4883 +#: ../src/guestfs-actions.pod:5123 #, no-wrap msgid "" " int\n" @@ -28527,17 +29052,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4889 +#: ../src/guestfs-actions.pod:5129 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4893 +#: ../src/guestfs-actions.pod:5133 msgid "guestfs_mkmountpoint" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4895 +#: ../src/guestfs-actions.pod:5135 #, no-wrap msgid "" " int\n" @@ -28547,7 +29072,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4899 +#: ../src/guestfs-actions.pod:5139 msgid "" "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls " "that can be used to create extra mountpoints before mounting the first " @@ -28555,7 +29080,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4923 +#: ../src/guestfs-actions.pod:5163 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 " @@ -28563,7 +29088,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4927 +#: ../src/guestfs-actions.pod:5167 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 " @@ -28572,7 +29097,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4934 +#: ../src/guestfs-actions.pod:5174 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 " @@ -28580,17 +29105,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4940 ../src/guestfs-actions.pod:5246 ../src/guestfs-actions.pod:6256 +#: ../src/guestfs-actions.pod:5180 ../src/guestfs-actions.pod:5486 ../src/guestfs-actions.pod:6514 msgid "(Added in 1.0.62)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4942 +#: ../src/guestfs-actions.pod:5182 msgid "guestfs_mknod" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4944 +#: ../src/guestfs-actions.pod:5184 #, no-wrap msgid "" " int\n" @@ -28603,7 +29128,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4959 +#: ../src/guestfs-actions.pod:5199 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 " @@ -28614,12 +29139,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4973 +#: ../src/guestfs-actions.pod:5213 msgid "guestfs_mknod_b" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4975 +#: ../src/guestfs-actions.pod:5215 #, no-wrap msgid "" " int\n" @@ -28632,7 +29157,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4982 +#: ../src/guestfs-actions.pod:5222 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 " @@ -28640,12 +29165,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4992 +#: ../src/guestfs-actions.pod:5232 msgid "guestfs_mknod_c" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4994 +#: ../src/guestfs-actions.pod:5234 #, no-wrap msgid "" " int\n" @@ -28658,7 +29183,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5001 +#: ../src/guestfs-actions.pod:5241 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 " @@ -28666,12 +29191,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5011 +#: ../src/guestfs-actions.pod:5251 msgid "guestfs_mkswap" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5013 +#: ../src/guestfs-actions.pod:5253 #, no-wrap msgid "" " int\n" @@ -28681,12 +29206,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5023 +#: ../src/guestfs-actions.pod:5263 msgid "guestfs_mkswap_L" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5025 +#: ../src/guestfs-actions.pod:5265 #, no-wrap msgid "" " int\n" @@ -28697,12 +29222,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5040 +#: ../src/guestfs-actions.pod:5280 msgid "guestfs_mkswap_U" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5042 +#: ../src/guestfs-actions.pod:5282 #, no-wrap msgid "" " int\n" @@ -28713,12 +29238,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5053 +#: ../src/guestfs-actions.pod:5293 msgid "guestfs_mkswap_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5055 +#: ../src/guestfs-actions.pod:5295 #, no-wrap msgid "" " int\n" @@ -28728,19 +29253,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5061 +#: ../src/guestfs-actions.pod:5301 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:5068 +#: ../src/guestfs-actions.pod:5308 msgid "guestfs_modprobe" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5070 +#: ../src/guestfs-actions.pod:5310 #, no-wrap msgid "" " int\n" @@ -28750,12 +29275,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5083 +#: ../src/guestfs-actions.pod:5323 msgid "guestfs_mount" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5085 +#: ../src/guestfs-actions.pod:5325 #, no-wrap msgid "" " int\n" @@ -28766,7 +29291,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5104 +#: ../src/guestfs-actions.pod:5344 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 " @@ -28776,12 +29301,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5115 +#: ../src/guestfs-actions.pod:5355 msgid "guestfs_mount_9p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5117 +#: ../src/guestfs-actions.pod:5357 #, no-wrap msgid "" " int\n" @@ -28793,7 +29318,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5128 +#: ../src/guestfs-actions.pod:5368 #, no-wrap msgid "" " GUESTFS_MOUNT_9P_OPTIONS, const char *options,\n" @@ -28801,12 +29326,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5141 +#: ../src/guestfs-actions.pod:5381 msgid "guestfs_mount_9p_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5143 +#: ../src/guestfs-actions.pod:5383 #, no-wrap msgid "" " int\n" @@ -28818,17 +29343,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5149 +#: ../src/guestfs-actions.pod:5389 msgid "This is the \"va_list variant\" of L</guestfs_mount_9p>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5153 +#: ../src/guestfs-actions.pod:5393 msgid "guestfs_mount_9p_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5155 +#: ../src/guestfs-actions.pod:5395 #, no-wrap msgid "" " int\n" @@ -28840,17 +29365,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5161 +#: ../src/guestfs-actions.pod:5401 msgid "This is the \"argv variant\" of L</guestfs_mount_9p>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5165 +#: ../src/guestfs-actions.pod:5405 msgid "guestfs_mount_loop" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5167 +#: ../src/guestfs-actions.pod:5407 #, no-wrap msgid "" " int\n" @@ -28861,12 +29386,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5180 +#: ../src/guestfs-actions.pod:5420 msgid "guestfs_mount_options" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5182 +#: ../src/guestfs-actions.pod:5422 #, no-wrap msgid "" " int\n" @@ -28878,24 +29403,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5188 +#: ../src/guestfs-actions.pod:5428 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:5198 ../src/guestfs-actions.pod:5212 ../src/guestfs-actions.pod:5229 +#: ../src/guestfs-actions.pod:5438 ../src/guestfs-actions.pod:5452 ../src/guestfs-actions.pod:5469 msgid "(Added in 1.0.10)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5200 +#: ../src/guestfs-actions.pod:5440 msgid "guestfs_mount_ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5202 +#: ../src/guestfs-actions.pod:5442 #, no-wrap msgid "" " int\n" @@ -28906,19 +29431,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5207 +#: ../src/guestfs-actions.pod:5447 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:5214 +#: ../src/guestfs-actions.pod:5454 msgid "guestfs_mount_vfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5216 +#: ../src/guestfs-actions.pod:5456 #, no-wrap msgid "" " int\n" @@ -28931,7 +29456,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5223 +#: ../src/guestfs-actions.pod:5463 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 " @@ -28939,12 +29464,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5231 +#: ../src/guestfs-actions.pod:5471 msgid "guestfs_mountpoints" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5233 +#: ../src/guestfs-actions.pod:5473 #, no-wrap msgid "" " char **\n" @@ -28953,7 +29478,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5236 +#: ../src/guestfs-actions.pod:5476 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 " @@ -28961,12 +29486,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5248 +#: ../src/guestfs-actions.pod:5488 msgid "guestfs_mounts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5250 +#: ../src/guestfs-actions.pod:5490 #, no-wrap msgid "" " char **\n" @@ -28975,17 +29500,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5258 +#: ../src/guestfs-actions.pod:5498 msgid "See also: C<guestfs_mountpoints>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5266 +#: ../src/guestfs-actions.pod:5506 msgid "guestfs_mv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5268 +#: ../src/guestfs-actions.pod:5508 #, no-wrap msgid "" " int\n" @@ -28996,12 +29521,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5280 +#: ../src/guestfs-actions.pod:5520 msgid "guestfs_ntfs_3g_probe" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5282 +#: ../src/guestfs-actions.pod:5522 #, no-wrap msgid "" " int\n" @@ -29012,17 +29537,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5301 +#: ../src/guestfs-actions.pod:5541 msgid "(Added in 1.0.43)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5303 +#: ../src/guestfs-actions.pod:5543 msgid "guestfs_ntfsresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5305 +#: ../src/guestfs-actions.pod:5545 #, no-wrap msgid "" " int\n" @@ -29032,19 +29557,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5309 ../src/guestfs-actions.pod:5409 +#: ../src/guestfs-actions.pod:5549 ../src/guestfs-actions.pod:5649 msgid "" "I<This function is deprecated.> In new code, use the " "L</guestfs_ntfsresize_opts> call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5333 +#: ../src/guestfs-actions.pod:5573 msgid "guestfs_ntfsresize_opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5335 +#: ../src/guestfs-actions.pod:5575 #, no-wrap msgid "" " int\n" @@ -29055,7 +29580,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5345 +#: ../src/guestfs-actions.pod:5585 #, no-wrap msgid "" " GUESTFS_NTFSRESIZE_OPTS_SIZE, int64_t size,\n" @@ -29064,7 +29589,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5365 +#: ../src/guestfs-actions.pod:5605 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 " @@ -29075,12 +29600,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5380 +#: ../src/guestfs-actions.pod:5620 msgid "guestfs_ntfsresize_opts_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5382 +#: ../src/guestfs-actions.pod:5622 #, no-wrap msgid "" " int\n" @@ -29091,17 +29616,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5387 +#: ../src/guestfs-actions.pod:5627 msgid "This is the \"va_list variant\" of L</guestfs_ntfsresize_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5391 +#: ../src/guestfs-actions.pod:5631 msgid "guestfs_ntfsresize_opts_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5393 +#: ../src/guestfs-actions.pod:5633 #, no-wrap msgid "" " int\n" @@ -29113,17 +29638,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5398 +#: ../src/guestfs-actions.pod:5638 msgid "This is the \"argv variant\" of L</guestfs_ntfsresize_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5402 +#: ../src/guestfs-actions.pod:5642 msgid "guestfs_ntfsresize_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5404 +#: ../src/guestfs-actions.pod:5644 #, no-wrap msgid "" " int\n" @@ -29134,24 +29659,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5416 +#: ../src/guestfs-actions.pod:5656 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:5421 ../src/guestfs-actions.pod:5863 ../src/guestfs-actions.pod:5936 ../src/guestfs-actions.pod:6204 ../src/guestfs-actions.pod:7843 +#: ../src/guestfs-actions.pod:5661 ../src/guestfs-actions.pod:6121 ../src/guestfs-actions.pod:6194 ../src/guestfs-actions.pod:6462 ../src/guestfs-actions.pod:8101 msgid "(Added in 1.3.14)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5423 +#: ../src/guestfs-actions.pod:5663 msgid "guestfs_part_add" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5425 +#: ../src/guestfs-actions.pod:5665 #, no-wrap msgid "" " int\n" @@ -29164,31 +29689,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5432 +#: ../src/guestfs-actions.pod:5672 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:5444 +#: ../src/guestfs-actions.pod:5684 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:5449 ../src/guestfs-actions.pod:5487 ../src/guestfs-actions.pod:5540 ../src/guestfs-actions.pod:5624 ../src/guestfs-actions.pod:5662 ../src/guestfs-actions.pod:5681 ../src/guestfs-actions.pod:5721 +#: ../src/guestfs-actions.pod:5689 ../src/guestfs-actions.pod:5727 ../src/guestfs-actions.pod:5780 ../src/guestfs-actions.pod:5864 ../src/guestfs-actions.pod:5902 ../src/guestfs-actions.pod:5921 ../src/guestfs-actions.pod:5961 msgid "(Added in 1.0.78)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5451 +#: ../src/guestfs-actions.pod:5691 msgid "guestfs_part_del" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5453 +#: ../src/guestfs-actions.pod:5693 #, no-wrap msgid "" " int\n" @@ -29199,12 +29724,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5468 +#: ../src/guestfs-actions.pod:5708 msgid "guestfs_part_disk" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5470 +#: ../src/guestfs-actions.pod:5710 #, no-wrap msgid "" " int\n" @@ -29215,7 +29740,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5475 +#: ../src/guestfs-actions.pod:5715 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 " @@ -29223,19 +29748,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5479 +#: ../src/guestfs-actions.pod:5719 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:5489 +#: ../src/guestfs-actions.pod:5729 msgid "guestfs_part_get_bootable" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5491 +#: ../src/guestfs-actions.pod:5731 #, no-wrap msgid "" " int\n" @@ -29246,17 +29771,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5499 +#: ../src/guestfs-actions.pod:5739 msgid "See also C<guestfs_part_set_bootable>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5505 +#: ../src/guestfs-actions.pod:5745 msgid "guestfs_part_get_mbr_id" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5507 +#: ../src/guestfs-actions.pod:5747 #, no-wrap msgid "" " int\n" @@ -29267,7 +29792,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5515 ../src/guestfs-actions.pod:5697 +#: ../src/guestfs-actions.pod:5755 ../src/guestfs-actions.pod:5937 msgid "" "Note that only MBR (old DOS-style) partitions have type bytes. You will get " "undefined results for other partition table types (see " @@ -29275,12 +29800,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5523 +#: ../src/guestfs-actions.pod:5763 msgid "guestfs_part_get_parttype" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5525 +#: ../src/guestfs-actions.pod:5765 #, no-wrap msgid "" " char *\n" @@ -29290,7 +29815,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5532 +#: ../src/guestfs-actions.pod:5772 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 " @@ -29298,12 +29823,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5542 +#: ../src/guestfs-actions.pod:5782 msgid "guestfs_part_init" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5544 +#: ../src/guestfs-actions.pod:5784 #, no-wrap msgid "" " int\n" @@ -29314,19 +29839,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5553 +#: ../src/guestfs-actions.pod:5793 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:5626 +#: ../src/guestfs-actions.pod:5866 msgid "guestfs_part_list" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5628 +#: ../src/guestfs-actions.pod:5868 #, no-wrap msgid "" " struct guestfs_partition_list *\n" @@ -29336,14 +29861,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5645 +#: ../src/guestfs-actions.pod:5885 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:5658 +#: ../src/guestfs-actions.pod:5898 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 " @@ -29351,12 +29876,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5664 +#: ../src/guestfs-actions.pod:5904 msgid "guestfs_part_set_bootable" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5666 +#: ../src/guestfs-actions.pod:5906 #, no-wrap msgid "" " int\n" @@ -29368,12 +29893,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5683 +#: ../src/guestfs-actions.pod:5923 msgid "guestfs_part_set_mbr_id" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5685 +#: ../src/guestfs-actions.pod:5925 #, no-wrap msgid "" " int\n" @@ -29385,12 +29910,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5705 +#: ../src/guestfs-actions.pod:5945 msgid "guestfs_part_set_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5707 +#: ../src/guestfs-actions.pod:5947 #, no-wrap msgid "" " int\n" @@ -29402,12 +29927,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5723 +#: ../src/guestfs-actions.pod:5963 msgid "guestfs_part_to_dev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5725 +#: ../src/guestfs-actions.pod:5965 #, no-wrap msgid "" " char *\n" @@ -29417,19 +29942,44 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5733 +#: ../src/guestfs-actions.pod:5973 ../src/guestfs-actions.pod:5992 msgid "" "The named partition must exist, for example as a string returned from " "C<guestfs_list_partitions>." msgstr "" +#. type: textblock +#: ../src/guestfs-actions.pod:5976 +msgid "See also C<guestfs_part_to_partnum>." +msgstr "" + #. type: =head2 -#: ../src/guestfs-actions.pod:5741 +#: ../src/guestfs-actions.pod:5983 +msgid "guestfs_part_to_partnum" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:5985 +#, no-wrap +msgid "" +" int\n" +" guestfs_part_to_partnum (guestfs_h *g,\n" +" const char *partition);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:5995 +msgid "See also C<guestfs_part_to_dev>." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:5999 msgid "guestfs_ping_daemon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5743 +#: ../src/guestfs-actions.pod:6001 #, no-wrap msgid "" " int\n" @@ -29438,12 +29988,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5755 +#: ../src/guestfs-actions.pod:6013 msgid "guestfs_pread" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5757 +#: ../src/guestfs-actions.pod:6015 #, no-wrap msgid "" " char *\n" @@ -29456,17 +30006,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5770 +#: ../src/guestfs-actions.pod:6028 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5781 +#: ../src/guestfs-actions.pod:6039 msgid "guestfs_pread_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5783 +#: ../src/guestfs-actions.pod:6041 #, no-wrap msgid "" " char *\n" @@ -29479,22 +30029,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5796 +#: ../src/guestfs-actions.pod:6054 msgid "See also C<guestfs_pread>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5805 +#: ../src/guestfs-actions.pod:6063 msgid "(Added in 1.5.21)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5807 +#: ../src/guestfs-actions.pod:6065 msgid "guestfs_pvcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5809 +#: ../src/guestfs-actions.pod:6067 #, no-wrap msgid "" " int\n" @@ -29504,12 +30054,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5821 +#: ../src/guestfs-actions.pod:6079 msgid "guestfs_pvremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5823 +#: ../src/guestfs-actions.pod:6081 #, no-wrap msgid "" " int\n" @@ -29519,12 +30069,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5838 +#: ../src/guestfs-actions.pod:6096 msgid "guestfs_pvresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5840 +#: ../src/guestfs-actions.pod:6098 #, no-wrap msgid "" " int\n" @@ -29534,12 +30084,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5851 +#: ../src/guestfs-actions.pod:6109 msgid "guestfs_pvresize_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5853 +#: ../src/guestfs-actions.pod:6111 #, no-wrap msgid "" " int\n" @@ -29550,19 +30100,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5858 +#: ../src/guestfs-actions.pod:6116 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:5865 +#: ../src/guestfs-actions.pod:6123 msgid "guestfs_pvs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5867 +#: ../src/guestfs-actions.pod:6125 #, no-wrap msgid "" " char **\n" @@ -29571,17 +30121,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5876 +#: ../src/guestfs-actions.pod:6134 msgid "See also C<guestfs_pvs_full>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5884 +#: ../src/guestfs-actions.pod:6142 msgid "guestfs_pvs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5886 +#: ../src/guestfs-actions.pod:6144 #, no-wrap msgid "" " struct guestfs_lvm_pv_list *\n" @@ -29590,7 +30140,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5892 +#: ../src/guestfs-actions.pod:6150 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 " @@ -29598,12 +30148,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5898 +#: ../src/guestfs-actions.pod:6156 msgid "guestfs_pvuuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5900 +#: ../src/guestfs-actions.pod:6158 #, no-wrap msgid "" " char *\n" @@ -29613,12 +30163,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5911 +#: ../src/guestfs-actions.pod:6169 msgid "guestfs_pwrite" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5913 +#: ../src/guestfs-actions.pod:6171 #, no-wrap msgid "" " int\n" @@ -29631,17 +30181,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5929 +#: ../src/guestfs-actions.pod:6187 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5938 +#: ../src/guestfs-actions.pod:6196 msgid "guestfs_pwrite_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5940 +#: ../src/guestfs-actions.pod:6198 #, no-wrap msgid "" " int\n" @@ -29654,22 +30204,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5955 +#: ../src/guestfs-actions.pod:6213 msgid "See also C<guestfs_pwrite>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5962 +#: ../src/guestfs-actions.pod:6220 msgid "(Added in 1.5.20)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5964 +#: ../src/guestfs-actions.pod:6222 msgid "guestfs_read_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5966 +#: ../src/guestfs-actions.pod:6224 #, no-wrap msgid "" " char *\n" @@ -29680,7 +30230,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5974 +#: ../src/guestfs-actions.pod:6232 msgid "" "Unlike C<guestfs_cat>, this function can correctly handle files that contain " "embedded ASCII NUL characters. However unlike C<guestfs_download>, this " @@ -29688,17 +30238,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5986 +#: ../src/guestfs-actions.pod:6244 msgid "(Added in 1.0.63)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5988 +#: ../src/guestfs-actions.pod:6246 msgid "guestfs_read_lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5990 +#: ../src/guestfs-actions.pod:6248 #, no-wrap msgid "" " char **\n" @@ -29708,7 +30258,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5999 +#: ../src/guestfs-actions.pod:6257 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of line). For " @@ -29717,12 +30267,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6010 +#: ../src/guestfs-actions.pod:6268 msgid "guestfs_readdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6012 +#: ../src/guestfs-actions.pod:6270 #, no-wrap msgid "" " struct guestfs_dirent_list *\n" @@ -29732,7 +30282,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6066 +#: ../src/guestfs-actions.pod:6324 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 " @@ -29740,7 +30290,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6070 +#: ../src/guestfs-actions.pod:6328 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 " @@ -29748,12 +30298,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6076 +#: ../src/guestfs-actions.pod:6334 msgid "guestfs_readlink" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6078 +#: ../src/guestfs-actions.pod:6336 #, no-wrap msgid "" " char *\n" @@ -29763,12 +30313,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6089 +#: ../src/guestfs-actions.pod:6347 msgid "guestfs_readlinklist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6091 +#: ../src/guestfs-actions.pod:6349 #, no-wrap msgid "" " char **\n" @@ -29779,12 +30329,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6124 +#: ../src/guestfs-actions.pod:6382 msgid "guestfs_realpath" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6126 +#: ../src/guestfs-actions.pod:6384 #, no-wrap msgid "" " char *\n" @@ -29794,12 +30344,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6138 +#: ../src/guestfs-actions.pod:6396 msgid "guestfs_removexattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6140 +#: ../src/guestfs-actions.pod:6398 #, no-wrap msgid "" " int\n" @@ -29810,17 +30360,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6148 +#: ../src/guestfs-actions.pod:6406 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6154 +#: ../src/guestfs-actions.pod:6412 msgid "guestfs_resize2fs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6156 +#: ../src/guestfs-actions.pod:6414 #, no-wrap msgid "" " int\n" @@ -29830,7 +30380,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6163 +#: ../src/guestfs-actions.pod:6421 msgid "" "I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the " "C<device> before calling this command. For unknown reasons C<resize2fs> " @@ -29839,12 +30389,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6173 +#: ../src/guestfs-actions.pod:6431 msgid "guestfs_resize2fs_M" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6175 +#: ../src/guestfs-actions.pod:6433 #, no-wrap msgid "" " int\n" @@ -29854,7 +30404,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6179 +#: ../src/guestfs-actions.pod:6437 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 " @@ -29862,7 +30412,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6183 +#: ../src/guestfs-actions.pod:6441 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. " @@ -29871,12 +30421,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6192 +#: ../src/guestfs-actions.pod:6450 msgid "guestfs_resize2fs_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6194 +#: ../src/guestfs-actions.pod:6452 #, no-wrap msgid "" " int\n" @@ -29887,19 +30437,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6199 +#: ../src/guestfs-actions.pod:6457 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:6206 +#: ../src/guestfs-actions.pod:6464 msgid "guestfs_rm" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6208 +#: ../src/guestfs-actions.pod:6466 #, no-wrap msgid "" " int\n" @@ -29909,12 +30459,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6218 +#: ../src/guestfs-actions.pod:6476 msgid "guestfs_rm_rf" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6220 +#: ../src/guestfs-actions.pod:6478 #, no-wrap msgid "" " int\n" @@ -29924,12 +30474,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6232 +#: ../src/guestfs-actions.pod:6490 msgid "guestfs_rmdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6234 +#: ../src/guestfs-actions.pod:6492 #, no-wrap msgid "" " int\n" @@ -29939,12 +30489,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6244 +#: ../src/guestfs-actions.pod:6502 msgid "guestfs_rmmountpoint" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6246 +#: ../src/guestfs-actions.pod:6504 #, no-wrap msgid "" " int\n" @@ -29954,19 +30504,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6250 +#: ../src/guestfs-actions.pod:6508 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:6258 +#: ../src/guestfs-actions.pod:6516 msgid "guestfs_scrub_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6260 +#: ../src/guestfs-actions.pod:6518 #, no-wrap msgid "" " int\n" @@ -29976,17 +30526,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6275 ../src/guestfs-actions.pod:6293 ../src/guestfs-actions.pod:6312 +#: ../src/guestfs-actions.pod:6533 ../src/guestfs-actions.pod:6551 ../src/guestfs-actions.pod:6570 msgid "(Added in 1.0.52)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6277 +#: ../src/guestfs-actions.pod:6535 msgid "guestfs_scrub_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6279 +#: ../src/guestfs-actions.pod:6537 #, no-wrap msgid "" " int\n" @@ -29996,12 +30546,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6295 +#: ../src/guestfs-actions.pod:6553 msgid "guestfs_scrub_freespace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6297 +#: ../src/guestfs-actions.pod:6555 #, no-wrap msgid "" " int\n" @@ -30011,7 +30561,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6301 +#: ../src/guestfs-actions.pod:6559 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>, " @@ -30020,12 +30570,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6314 +#: ../src/guestfs-actions.pod:6572 msgid "guestfs_set_append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6316 +#: ../src/guestfs-actions.pod:6574 #, no-wrap msgid "" " int\n" @@ -30035,12 +30585,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6333 +#: ../src/guestfs-actions.pod:6591 msgid "guestfs_set_attach_method" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6335 +#: ../src/guestfs-actions.pod:6593 #, no-wrap msgid "" " int\n" @@ -30050,12 +30600,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6363 +#: ../src/guestfs-actions.pod:6621 msgid "guestfs_set_autosync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6365 +#: ../src/guestfs-actions.pod:6623 #, no-wrap msgid "" " int\n" @@ -30065,12 +30615,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6381 +#: ../src/guestfs-actions.pod:6639 msgid "guestfs_set_direct" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6383 +#: ../src/guestfs-actions.pod:6641 #, no-wrap msgid "" " int\n" @@ -30080,7 +30630,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6391 +#: ../src/guestfs-actions.pod:6649 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 " @@ -30088,12 +30638,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6404 +#: ../src/guestfs-actions.pod:6662 msgid "guestfs_set_e2label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6406 +#: ../src/guestfs-actions.pod:6664 #, no-wrap msgid "" " int\n" @@ -30104,19 +30654,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6415 +#: ../src/guestfs-actions.pod:6673 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:6422 +#: ../src/guestfs-actions.pod:6680 msgid "guestfs_set_e2uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6424 +#: ../src/guestfs-actions.pod:6682 #, no-wrap msgid "" " int\n" @@ -30127,19 +30677,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6434 +#: ../src/guestfs-actions.pod:6692 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:6441 +#: ../src/guestfs-actions.pod:6699 msgid "guestfs_set_memsize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6443 +#: ../src/guestfs-actions.pod:6701 #, no-wrap msgid "" " int\n" @@ -30149,19 +30699,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6447 +#: ../src/guestfs-actions.pod:6705 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:6462 +#: ../src/guestfs-actions.pod:6720 msgid "guestfs_set_network" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6464 +#: ../src/guestfs-actions.pod:6722 #, no-wrap msgid "" " int\n" @@ -30171,19 +30721,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6474 +#: ../src/guestfs-actions.pod:6732 msgid "" "You must call this before calling C<guestfs_launch>, otherwise it has no " "effect." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6481 +#: ../src/guestfs-actions.pod:6739 msgid "guestfs_set_path" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6483 +#: ../src/guestfs-actions.pod:6741 #, no-wrap msgid "" " int\n" @@ -30193,12 +30743,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6498 +#: ../src/guestfs-actions.pod:6756 msgid "guestfs_set_pgroup" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6500 +#: ../src/guestfs-actions.pod:6758 #, no-wrap msgid "" " int\n" @@ -30208,12 +30758,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6517 +#: ../src/guestfs-actions.pod:6775 msgid "guestfs_set_qemu" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6519 +#: ../src/guestfs-actions.pod:6777 #, no-wrap msgid "" " int\n" @@ -30223,12 +30773,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6545 +#: ../src/guestfs-actions.pod:6803 msgid "guestfs_set_recovery_proc" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6547 +#: ../src/guestfs-actions.pod:6805 #, no-wrap msgid "" " int\n" @@ -30238,7 +30788,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6551 +#: ../src/guestfs-actions.pod:6809 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 " @@ -30247,19 +30797,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6556 +#: ../src/guestfs-actions.pod:6814 msgid "" "This only has any effect if called before C<guestfs_launch>, and the default " "is true." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6569 +#: ../src/guestfs-actions.pod:6827 msgid "guestfs_set_selinux" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6571 +#: ../src/guestfs-actions.pod:6829 #, no-wrap msgid "" " int\n" @@ -30269,12 +30819,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6588 +#: ../src/guestfs-actions.pod:6846 msgid "guestfs_set_smp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6590 +#: ../src/guestfs-actions.pod:6848 #, no-wrap msgid "" " int\n" @@ -30284,17 +30834,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6598 +#: ../src/guestfs-actions.pod:6856 msgid "This function must be called before C<guestfs_launch>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6604 +#: ../src/guestfs-actions.pod:6862 msgid "guestfs_set_trace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6606 +#: ../src/guestfs-actions.pod:6864 #, no-wrap msgid "" " int\n" @@ -30304,19 +30854,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6620 +#: ../src/guestfs-actions.pod:6878 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:6628 +#: ../src/guestfs-actions.pod:6886 msgid "guestfs_set_verbose" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6630 +#: ../src/guestfs-actions.pod:6888 #, no-wrap msgid "" " int\n" @@ -30326,19 +30876,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6639 +#: ../src/guestfs-actions.pod:6897 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:6647 +#: ../src/guestfs-actions.pod:6905 msgid "guestfs_setcon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6649 +#: ../src/guestfs-actions.pod:6907 #, no-wrap msgid "" " int\n" @@ -30348,12 +30898,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6662 +#: ../src/guestfs-actions.pod:6920 msgid "guestfs_setxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6664 +#: ../src/guestfs-actions.pod:6922 #, no-wrap msgid "" " int\n" @@ -30366,17 +30916,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6675 +#: ../src/guestfs-actions.pod:6933 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6681 +#: ../src/guestfs-actions.pod:6939 msgid "guestfs_sfdisk" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6683 +#: ../src/guestfs-actions.pod:6941 #, no-wrap msgid "" " int\n" @@ -30390,24 +30940,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6691 ../src/guestfs-actions.pod:6735 ../src/guestfs-actions.pod:6769 +#: ../src/guestfs-actions.pod:6949 ../src/guestfs-actions.pod:6993 ../src/guestfs-actions.pod:7027 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_part_add> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6718 +#: ../src/guestfs-actions.pod:6976 msgid "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6728 +#: ../src/guestfs-actions.pod:6986 msgid "guestfs_sfdiskM" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6730 +#: ../src/guestfs-actions.pod:6988 #, no-wrap msgid "" " int\n" @@ -30418,7 +30968,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6742 +#: ../src/guestfs-actions.pod:7000 msgid "" "This is a simplified interface to the C<guestfs_sfdisk> command, where " "partition sizes are specified in megabytes only (rounded to the nearest " @@ -30427,19 +30977,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6748 +#: ../src/guestfs-actions.pod:7006 msgid "" "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and " "C<guestfs_part_disk>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6758 +#: ../src/guestfs-actions.pod:7016 msgid "guestfs_sfdisk_N" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6760 +#: ../src/guestfs-actions.pod:7018 #, no-wrap msgid "" " int\n" @@ -30454,24 +31004,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6779 +#: ../src/guestfs-actions.pod:7037 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:6782 +#: ../src/guestfs-actions.pod:7040 msgid "See also: C<guestfs_part_add>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6791 +#: ../src/guestfs-actions.pod:7049 msgid "guestfs_sfdisk_disk_geometry" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6793 +#: ../src/guestfs-actions.pod:7051 #, no-wrap msgid "" " char *\n" @@ -30481,7 +31031,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6797 +#: ../src/guestfs-actions.pod:7055 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, " @@ -30490,12 +31040,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6810 +#: ../src/guestfs-actions.pod:7068 msgid "guestfs_sfdisk_kernel_geometry" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6812 +#: ../src/guestfs-actions.pod:7070 #, no-wrap msgid "" " char *\n" @@ -30505,12 +31055,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6826 +#: ../src/guestfs-actions.pod:7084 msgid "guestfs_sfdisk_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6828 +#: ../src/guestfs-actions.pod:7086 #, no-wrap msgid "" " char *\n" @@ -30520,24 +31070,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6832 +#: ../src/guestfs-actions.pod:7090 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_part_list> " "call instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6843 +#: ../src/guestfs-actions.pod:7101 msgid "See also: C<guestfs_part_list>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6850 +#: ../src/guestfs-actions.pod:7108 msgid "guestfs_sh" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6852 +#: ../src/guestfs-actions.pod:7110 #, no-wrap msgid "" " char *\n" @@ -30547,22 +31097,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6859 +#: ../src/guestfs-actions.pod:7117 msgid "This is like C<guestfs_command>, but passes the command to:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6867 +#: ../src/guestfs-actions.pod:7125 msgid "All the provisos about C<guestfs_command> apply to this call." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6874 +#: ../src/guestfs-actions.pod:7132 msgid "guestfs_sh_lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6876 +#: ../src/guestfs-actions.pod:7134 #, no-wrap msgid "" " char **\n" @@ -30572,24 +31122,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6880 +#: ../src/guestfs-actions.pod:7138 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:6883 +#: ../src/guestfs-actions.pod:7141 msgid "See also: C<guestfs_command_lines>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6891 +#: ../src/guestfs-actions.pod:7149 msgid "guestfs_sleep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6893 +#: ../src/guestfs-actions.pod:7151 #, no-wrap msgid "" " int\n" @@ -30599,17 +31149,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6901 +#: ../src/guestfs-actions.pod:7159 msgid "(Added in 1.0.41)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6903 ../src/guestfs-structs.pod:109 +#: ../src/guestfs-actions.pod:7161 ../src/guestfs-structs.pod:109 msgid "guestfs_stat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6905 +#: ../src/guestfs-actions.pod:7163 #, no-wrap msgid "" " struct guestfs_stat *\n" @@ -30619,12 +31169,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6919 ../src/guestfs-structs.pod:135 +#: ../src/guestfs-actions.pod:7177 ../src/guestfs-structs.pod:135 msgid "guestfs_statvfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6921 +#: ../src/guestfs-actions.pod:7179 #, no-wrap msgid "" " struct guestfs_statvfs *\n" @@ -30634,19 +31184,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6931 +#: ../src/guestfs-actions.pod:7189 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:6937 +#: ../src/guestfs-actions.pod:7195 msgid "guestfs_strings" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6939 +#: ../src/guestfs-actions.pod:7197 #, no-wrap msgid "" " char **\n" @@ -30656,12 +31206,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6955 +#: ../src/guestfs-actions.pod:7213 msgid "guestfs_strings_e" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6957 +#: ../src/guestfs-actions.pod:7215 #, no-wrap msgid "" " char **\n" @@ -30672,26 +31222,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6962 +#: ../src/guestfs-actions.pod:7220 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:6972 +#: ../src/guestfs-actions.pod:7230 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:7010 +#: ../src/guestfs-actions.pod:7268 msgid "guestfs_swapoff_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7012 +#: ../src/guestfs-actions.pod:7270 #, no-wrap msgid "" " int\n" @@ -30701,19 +31251,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7016 +#: ../src/guestfs-actions.pod:7274 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:7024 +#: ../src/guestfs-actions.pod:7282 msgid "guestfs_swapoff_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7026 +#: ../src/guestfs-actions.pod:7284 #, no-wrap msgid "" " int\n" @@ -30723,12 +31273,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7036 +#: ../src/guestfs-actions.pod:7294 msgid "guestfs_swapoff_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7038 +#: ../src/guestfs-actions.pod:7296 #, no-wrap msgid "" " int\n" @@ -30738,12 +31288,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7049 +#: ../src/guestfs-actions.pod:7307 msgid "guestfs_swapoff_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7051 +#: ../src/guestfs-actions.pod:7309 #, no-wrap msgid "" " int\n" @@ -30753,12 +31303,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7062 +#: ../src/guestfs-actions.pod:7320 msgid "guestfs_swapon_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7064 +#: ../src/guestfs-actions.pod:7322 #, no-wrap msgid "" " int\n" @@ -30768,7 +31318,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7068 +#: ../src/guestfs-actions.pod:7326 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 " @@ -30776,12 +31326,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7084 +#: ../src/guestfs-actions.pod:7342 msgid "guestfs_swapon_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7086 +#: ../src/guestfs-actions.pod:7344 #, no-wrap msgid "" " int\n" @@ -30791,19 +31341,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7090 +#: ../src/guestfs-actions.pod:7348 msgid "" "This command enables swap to a file. See C<guestfs_swapon_device> for other " "notes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7097 +#: ../src/guestfs-actions.pod:7355 msgid "guestfs_swapon_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7099 +#: ../src/guestfs-actions.pod:7357 #, no-wrap msgid "" " int\n" @@ -30813,19 +31363,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7103 +#: ../src/guestfs-actions.pod:7361 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:7110 +#: ../src/guestfs-actions.pod:7368 msgid "guestfs_swapon_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7112 +#: ../src/guestfs-actions.pod:7370 #, no-wrap msgid "" " int\n" @@ -30835,19 +31385,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7116 +#: ../src/guestfs-actions.pod:7374 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:7123 +#: ../src/guestfs-actions.pod:7381 msgid "guestfs_sync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7125 +#: ../src/guestfs-actions.pod:7383 #, no-wrap msgid "" " int\n" @@ -30856,12 +31406,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7138 +#: ../src/guestfs-actions.pod:7396 msgid "guestfs_tail" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7140 +#: ../src/guestfs-actions.pod:7398 #, no-wrap msgid "" " char **\n" @@ -30871,12 +31421,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7156 +#: ../src/guestfs-actions.pod:7414 msgid "guestfs_tail_n" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7158 +#: ../src/guestfs-actions.pod:7416 #, no-wrap msgid "" " char **\n" @@ -30887,12 +31437,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7180 +#: ../src/guestfs-actions.pod:7438 msgid "guestfs_tar_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7182 +#: ../src/guestfs-actions.pod:7440 #, no-wrap msgid "" " int\n" @@ -30903,22 +31453,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7190 +#: ../src/guestfs-actions.pod:7448 msgid "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7195 ../src/guestfs-actions.pod:7212 ../src/guestfs-actions.pod:7228 ../src/guestfs-actions.pod:7244 +#: ../src/guestfs-actions.pod:7453 ../src/guestfs-actions.pod:7470 ../src/guestfs-actions.pod:7486 ../src/guestfs-actions.pod:7502 msgid "(Added in 1.0.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7197 +#: ../src/guestfs-actions.pod:7455 msgid "guestfs_tar_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7199 +#: ../src/guestfs-actions.pod:7457 #, no-wrap msgid "" " int\n" @@ -30929,19 +31479,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7207 +#: ../src/guestfs-actions.pod:7465 msgid "" "To download a compressed tarball, use C<guestfs_tgz_out> or " "C<guestfs_txz_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7214 +#: ../src/guestfs-actions.pod:7472 msgid "guestfs_tgz_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7216 +#: ../src/guestfs-actions.pod:7474 #, no-wrap msgid "" " int\n" @@ -30952,17 +31502,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7224 +#: ../src/guestfs-actions.pod:7482 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7230 +#: ../src/guestfs-actions.pod:7488 msgid "guestfs_tgz_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7232 +#: ../src/guestfs-actions.pod:7490 #, no-wrap msgid "" " int\n" @@ -30973,17 +31523,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7240 +#: ../src/guestfs-actions.pod:7498 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7246 +#: ../src/guestfs-actions.pod:7504 msgid "guestfs_touch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7248 +#: ../src/guestfs-actions.pod:7506 #, no-wrap msgid "" " int\n" @@ -30993,12 +31543,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7263 +#: ../src/guestfs-actions.pod:7521 msgid "guestfs_truncate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7265 +#: ../src/guestfs-actions.pod:7523 #, no-wrap msgid "" " int\n" @@ -31008,12 +31558,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7276 +#: ../src/guestfs-actions.pod:7534 msgid "guestfs_truncate_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7278 +#: ../src/guestfs-actions.pod:7536 #, no-wrap msgid "" " int\n" @@ -31024,7 +31574,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7286 +#: ../src/guestfs-actions.pod:7544 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 " @@ -31033,12 +31583,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7296 +#: ../src/guestfs-actions.pod:7554 msgid "guestfs_tune2fs_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7298 +#: ../src/guestfs-actions.pod:7556 #, no-wrap msgid "" " char **\n" @@ -31048,12 +31598,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7318 +#: ../src/guestfs-actions.pod:7576 msgid "guestfs_txz_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7320 +#: ../src/guestfs-actions.pod:7578 #, no-wrap msgid "" " int\n" @@ -31064,12 +31614,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7332 +#: ../src/guestfs-actions.pod:7590 msgid "guestfs_txz_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7334 +#: ../src/guestfs-actions.pod:7592 #, no-wrap msgid "" " int\n" @@ -31080,12 +31630,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7346 +#: ../src/guestfs-actions.pod:7604 msgid "guestfs_umask" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7348 +#: ../src/guestfs-actions.pod:7606 #, no-wrap msgid "" " int\n" @@ -31095,19 +31645,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7364 +#: ../src/guestfs-actions.pod:7622 msgid "" "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, " "C<guestfs_mkdir>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7373 +#: ../src/guestfs-actions.pod:7631 msgid "guestfs_umount" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7375 +#: ../src/guestfs-actions.pod:7633 #, no-wrap msgid "" " int\n" @@ -31117,12 +31667,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7387 +#: ../src/guestfs-actions.pod:7645 msgid "guestfs_umount_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7389 +#: ../src/guestfs-actions.pod:7647 #, no-wrap msgid "" " int\n" @@ -31131,12 +31681,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7400 +#: ../src/guestfs-actions.pod:7658 msgid "guestfs_upload" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7402 +#: ../src/guestfs-actions.pod:7660 #, no-wrap msgid "" " int\n" @@ -31147,17 +31697,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7412 +#: ../src/guestfs-actions.pod:7670 msgid "See also C<guestfs_download>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7423 +#: ../src/guestfs-actions.pod:7681 msgid "guestfs_upload_offset" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7425 +#: ../src/guestfs-actions.pod:7683 #, no-wrap msgid "" " int\n" @@ -31169,7 +31719,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7441 +#: ../src/guestfs-actions.pod:7699 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 " @@ -31177,17 +31727,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7446 +#: ../src/guestfs-actions.pod:7704 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7457 +#: ../src/guestfs-actions.pod:7715 msgid "guestfs_utimens" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7459 +#: ../src/guestfs-actions.pod:7717 #, no-wrap msgid "" " int\n" @@ -31201,12 +31751,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7488 ../src/guestfs-structs.pod:175 +#: ../src/guestfs-actions.pod:7746 ../src/guestfs-structs.pod:175 msgid "guestfs_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7490 +#: ../src/guestfs-actions.pod:7748 #, no-wrap msgid "" " struct guestfs_version *\n" @@ -31215,7 +31765,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7518 +#: ../src/guestfs-actions.pod:7776 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " @@ -31224,24 +31774,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7524 +#: ../src/guestfs-actions.pod:7782 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:7528 +#: ../src/guestfs-actions.pod:7786 msgid "(Added in 1.0.58)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7530 +#: ../src/guestfs-actions.pod:7788 msgid "guestfs_vfs_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7532 +#: ../src/guestfs-actions.pod:7790 #, no-wrap msgid "" " char *\n" @@ -31251,22 +31801,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7541 +#: ../src/guestfs-actions.pod:7799 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7546 ../src/guestfs-actions.pod:7583 +#: ../src/guestfs-actions.pod:7804 ../src/guestfs-actions.pod:7841 msgid "(Added in 1.3.18)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7548 +#: ../src/guestfs-actions.pod:7806 msgid "guestfs_vfs_type" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7550 +#: ../src/guestfs-actions.pod:7808 #, no-wrap msgid "" " char *\n" @@ -31276,12 +31826,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7567 +#: ../src/guestfs-actions.pod:7825 msgid "guestfs_vfs_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7569 +#: ../src/guestfs-actions.pod:7827 #, no-wrap msgid "" " char *\n" @@ -31291,17 +31841,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7578 +#: ../src/guestfs-actions.pod:7836 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7585 +#: ../src/guestfs-actions.pod:7843 msgid "guestfs_vg_activate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7587 +#: ../src/guestfs-actions.pod:7845 #, no-wrap msgid "" " int\n" @@ -31312,12 +31862,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7604 +#: ../src/guestfs-actions.pod:7862 msgid "guestfs_vg_activate_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7606 +#: ../src/guestfs-actions.pod:7864 #, no-wrap msgid "" " int\n" @@ -31327,12 +31877,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7619 +#: ../src/guestfs-actions.pod:7877 msgid "guestfs_vgcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7621 +#: ../src/guestfs-actions.pod:7879 #, no-wrap msgid "" " int\n" @@ -31343,12 +31893,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7633 +#: ../src/guestfs-actions.pod:7891 msgid "guestfs_vglvuuids" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7635 +#: ../src/guestfs-actions.pod:7893 #, no-wrap msgid "" " char **\n" @@ -31358,24 +31908,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7642 +#: ../src/guestfs-actions.pod:7900 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:7645 +#: ../src/guestfs-actions.pod:7903 msgid "See also C<guestfs_vgpvuuids>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7653 +#: ../src/guestfs-actions.pod:7911 msgid "guestfs_vgpvuuids" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7655 +#: ../src/guestfs-actions.pod:7913 #, no-wrap msgid "" " char **\n" @@ -31385,24 +31935,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7662 +#: ../src/guestfs-actions.pod:7920 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:7665 +#: ../src/guestfs-actions.pod:7923 msgid "See also C<guestfs_vglvuuids>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7673 +#: ../src/guestfs-actions.pod:7931 msgid "guestfs_vgremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7675 +#: ../src/guestfs-actions.pod:7933 #, no-wrap msgid "" " int\n" @@ -31412,12 +31962,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7688 +#: ../src/guestfs-actions.pod:7946 msgid "guestfs_vgrename" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7690 +#: ../src/guestfs-actions.pod:7948 #, no-wrap msgid "" " int\n" @@ -31428,12 +31978,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7701 +#: ../src/guestfs-actions.pod:7959 msgid "guestfs_vgs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7703 +#: ../src/guestfs-actions.pod:7961 #, no-wrap msgid "" " char **\n" @@ -31442,17 +31992,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7712 +#: ../src/guestfs-actions.pod:7970 msgid "See also C<guestfs_vgs_full>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7720 +#: ../src/guestfs-actions.pod:7978 msgid "guestfs_vgs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7722 +#: ../src/guestfs-actions.pod:7980 #, no-wrap msgid "" " struct guestfs_lvm_vg_list *\n" @@ -31461,7 +32011,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7728 +#: ../src/guestfs-actions.pod:7986 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 " @@ -31469,12 +32019,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7734 +#: ../src/guestfs-actions.pod:7992 msgid "guestfs_vgscan" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7736 +#: ../src/guestfs-actions.pod:7994 #, no-wrap msgid "" " int\n" @@ -31483,12 +32033,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7746 +#: ../src/guestfs-actions.pod:8004 msgid "guestfs_vguuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7748 +#: ../src/guestfs-actions.pod:8006 #, no-wrap msgid "" " char *\n" @@ -31498,12 +32048,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7759 +#: ../src/guestfs-actions.pod:8017 msgid "guestfs_wait_ready" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7761 +#: ../src/guestfs-actions.pod:8019 #, no-wrap msgid "" " int\n" @@ -31512,19 +32062,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7764 +#: ../src/guestfs-actions.pod:8022 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_launch> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7771 +#: ../src/guestfs-actions.pod:8029 msgid "This function is a no op." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7773 +#: ../src/guestfs-actions.pod:8031 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 " @@ -31532,19 +32082,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7778 +#: ../src/guestfs-actions.pod:8036 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:7786 +#: ../src/guestfs-actions.pod:8044 msgid "guestfs_wc_c" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7788 +#: ../src/guestfs-actions.pod:8046 #, no-wrap msgid "" " int\n" @@ -31554,12 +32104,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7799 +#: ../src/guestfs-actions.pod:8057 msgid "guestfs_wc_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7801 +#: ../src/guestfs-actions.pod:8059 #, no-wrap msgid "" " int\n" @@ -31569,12 +32119,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7812 +#: ../src/guestfs-actions.pod:8070 msgid "guestfs_wc_w" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7814 +#: ../src/guestfs-actions.pod:8072 #, no-wrap msgid "" " int\n" @@ -31584,12 +32134,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7825 +#: ../src/guestfs-actions.pod:8083 msgid "guestfs_write" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7827 +#: ../src/guestfs-actions.pod:8085 #, no-wrap msgid "" " int\n" @@ -31601,17 +32151,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7836 +#: ../src/guestfs-actions.pod:8094 msgid "See also C<guestfs_write_append>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7845 +#: ../src/guestfs-actions.pod:8103 msgid "guestfs_write_append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7847 +#: ../src/guestfs-actions.pod:8105 #, no-wrap msgid "" " int\n" @@ -31623,17 +32173,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7856 +#: ../src/guestfs-actions.pod:8114 msgid "See also C<guestfs_write>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7865 +#: ../src/guestfs-actions.pod:8123 msgid "guestfs_write_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7867 +#: ../src/guestfs-actions.pod:8125 #, no-wrap msgid "" " int\n" @@ -31645,19 +32195,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7873 +#: ../src/guestfs-actions.pod:8131 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_write> call " "instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7898 +#: ../src/guestfs-actions.pod:8156 msgid "guestfs_zegrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7900 +#: ../src/guestfs-actions.pod:8158 #, no-wrap msgid "" " char **\n" @@ -31668,12 +32218,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7917 +#: ../src/guestfs-actions.pod:8175 msgid "guestfs_zegrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7919 +#: ../src/guestfs-actions.pod:8177 #, no-wrap msgid "" " char **\n" @@ -31684,12 +32234,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7936 +#: ../src/guestfs-actions.pod:8194 msgid "guestfs_zero" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7938 +#: ../src/guestfs-actions.pod:8196 #, no-wrap msgid "" " int\n" @@ -31699,19 +32249,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7952 +#: ../src/guestfs-actions.pod:8210 msgid "" "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>, " "C<guestfs_is_zero_device>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7964 +#: ../src/guestfs-actions.pod:8222 msgid "guestfs_zero_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7966 +#: ../src/guestfs-actions.pod:8224 #, no-wrap msgid "" " int\n" @@ -31721,24 +32271,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7970 +#: ../src/guestfs-actions.pod:8228 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:7988 +#: ../src/guestfs-actions.pod:8246 msgid "(Added in 1.3.1)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7990 +#: ../src/guestfs-actions.pod:8248 msgid "guestfs_zerofree" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7992 +#: ../src/guestfs-actions.pod:8250 #, no-wrap msgid "" " int\n" @@ -31748,12 +32298,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8011 +#: ../src/guestfs-actions.pod:8269 msgid "guestfs_zfgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8013 +#: ../src/guestfs-actions.pod:8271 #, no-wrap msgid "" " char **\n" @@ -31764,12 +32314,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8030 +#: ../src/guestfs-actions.pod:8288 msgid "guestfs_zfgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8032 +#: ../src/guestfs-actions.pod:8290 #, no-wrap msgid "" " char **\n" @@ -31780,12 +32330,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8049 +#: ../src/guestfs-actions.pod:8307 msgid "guestfs_zfile" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8051 +#: ../src/guestfs-actions.pod:8309 #, no-wrap msgid "" " char *\n" @@ -31796,26 +32346,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8056 +#: ../src/guestfs-actions.pod:8314 msgid "" "I<This function is deprecated.> In new code, use the L</guestfs_file> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:8068 +#: ../src/guestfs-actions.pod:8326 msgid "" "Since 1.0.63, use C<guestfs_file> instead which can now process compressed " "files." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8076 +#: ../src/guestfs-actions.pod:8334 msgid "guestfs_zgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8078 +#: ../src/guestfs-actions.pod:8336 #, no-wrap msgid "" " char **\n" @@ -31826,12 +32376,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:8095 +#: ../src/guestfs-actions.pod:8353 msgid "guestfs_zgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:8097 +#: ../src/guestfs-actions.pod:8355 #, no-wrap msgid "" " char **\n" @@ -33158,66 +33708,95 @@ msgid "" "directories recursively." msgstr "" -#. type: =item +#. type: textblock #: ../src/guestfs.pod:319 -msgid "B<file or device> to B<file or device>" +msgid "To copy part of a file (offset and size) use L</guestfs_copy_file_to_file>." +msgstr "" + +#. type: =item +#: ../src/guestfs.pod:322 +msgid "B<file> to B<device>" +msgstr "" + +#. type: =item +#: ../src/guestfs.pod:324 +msgid "B<device> to B<file>" +msgstr "" + +#. type: =item +#: ../src/guestfs.pod:326 +msgid "B<device> to B<device>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:321 +#: ../src/guestfs.pod:328 msgid "" -"Use L</guestfs_dd> which efficiently uses L<dd(1)> to copy between files and " -"devices in the guest." +"Use L</guestfs_copy_file_to_device>, L</guestfs_copy_device_to_file>, or " +"L</guestfs_copy_device_to_device>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:324 +#: ../src/guestfs.pod:331 msgid "Example: duplicate the contents of an LV:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:326 +#: ../src/guestfs.pod:333 #, no-wrap msgid "" -" guestfs_dd (g, \"/dev/VG/Original\", \"/dev/VG/Copy\");\n" +" guestfs_copy_device_to_device (g,\n" +" \"/dev/VG/Original\", \"/dev/VG/Copy\",\n" +" /* -1 marks the end of the list of optional parameters */\n" +" -1);\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:328 +#: ../src/guestfs.pod:338 msgid "" "The destination (C</dev/VG/Copy>) must be at least as large as the source " -"(C</dev/VG/Original>). To copy less than the whole source device, use " -"L</guestfs_copy_size>." +"(C</dev/VG/Original>). To copy less than the whole source device, use the " +"optional C<size> parameter:" +msgstr "" + +#. type: verbatim +#: ../src/guestfs.pod:342 +#, no-wrap +msgid "" +" guestfs_copy_device_to_device (g,\n" +" \"/dev/VG/Original\", \"/dev/VG/Copy\",\n" +" GUESTFS_COPY_DEVICE_TO_DEVICE_SIZE, 10000,\n" +" -1);\n" +"\n" msgstr "" #. type: =item -#: ../src/guestfs.pod:332 +#: ../src/guestfs.pod:347 msgid "B<file on the host> to B<file or device>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:334 +#: ../src/guestfs.pod:349 msgid "Use L</guestfs_upload>. See L</UPLOADING> above." msgstr "" #. type: =item -#: ../src/guestfs.pod:336 +#: ../src/guestfs.pod:351 msgid "B<file or device> to B<file on the host>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:338 +#: ../src/guestfs.pod:353 msgid "Use L</guestfs_download>. See L</DOWNLOADING> above." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:342 +#: ../src/guestfs.pod:357 msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:344 +#: ../src/guestfs.pod:359 msgid "" "Calls like L</guestfs_upload>, L</guestfs_download>, L</guestfs_tar_in>, " "L</guestfs_tar_out> etc appear to only take filenames as arguments, so it " @@ -33228,12 +33807,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:352 +#: ../src/guestfs.pod:367 msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:355 +#: ../src/guestfs.pod:370 #, no-wrap msgid "" " guestfs_download (g, filename, \"/dev/stdout\");\n" @@ -33241,12 +33820,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:357 +#: ../src/guestfs.pod:372 msgid "and you can write tar output to a file descriptor C<fd> by doing:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:359 +#: ../src/guestfs.pod:374 #, no-wrap msgid "" " char devfd[64];\n" @@ -33256,26 +33835,26 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:363 +#: ../src/guestfs.pod:378 msgid "LISTING FILES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:365 +#: ../src/guestfs.pod:380 msgid "" "L</guestfs_ll> is just designed for humans to read (mainly when using the " "L<guestfish(1)>-equivalent command C<ll>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:368 +#: ../src/guestfs.pod:383 msgid "" "L</guestfs_ls> is a quick way to get a list of files in a directory from " "programs, as a flat list of strings." msgstr "" #. type: textblock -#: ../src/guestfs.pod:371 +#: ../src/guestfs.pod:386 msgid "" "L</guestfs_readdir> is a programmatic way to get a list of files in a " "directory, plus additional information about each one. It is more " @@ -33283,19 +33862,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:375 +#: ../src/guestfs.pod:390 msgid "" "L</guestfs_find> and L</guestfs_find0> can be used to recursively list " "files." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:378 +#: ../src/guestfs.pod:393 msgid "RUNNING COMMANDS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:380 +#: ../src/guestfs.pod:395 msgid "" "Although libguestfs is primarily an API for manipulating files inside guest " "images, we also provide some limited facilities for running commands inside " @@ -33303,55 +33882,55 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:384 +#: ../src/guestfs.pod:399 msgid "There are many limitations to this:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:390 +#: ../src/guestfs.pod:405 msgid "" "The kernel version that the command runs under will be different from what " "it expects." msgstr "" #. type: textblock -#: ../src/guestfs.pod:395 +#: ../src/guestfs.pod:410 msgid "" "If the command needs to communicate with daemons, then most likely they " "won't be running." msgstr "" #. type: textblock -#: ../src/guestfs.pod:400 +#: ../src/guestfs.pod:415 msgid "The command will be running in limited memory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:404 +#: ../src/guestfs.pod:419 msgid "" "The network may not be available unless you enable it (see " "L</guestfs_set_network>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:409 +#: ../src/guestfs.pod:424 msgid "Only supports Linux guests (not Windows, BSD, etc)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:413 +#: ../src/guestfs.pod:428 msgid "Architecture limitations (eg. won't work for a PPC guest on an X86 host)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:418 +#: ../src/guestfs.pod:433 msgid "" "For SELinux guests, you may need to enable SELinux and load policy first. " "See L</SELINUX> in this manpage." msgstr "" #. type: textblock -#: ../src/guestfs.pod:423 +#: ../src/guestfs.pod:438 msgid "" "I<Security:> It is not safe to run commands from untrusted, possibly " "malicious guests. These commands may attempt to exploit your program by " @@ -33363,7 +33942,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:432 +#: ../src/guestfs.pod:447 msgid "" "A secure alternative is to use libguestfs to install a \"firstboot\" script " "(a script which runs when the guest next boots normally), and to have this " @@ -33373,26 +33952,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:440 +#: ../src/guestfs.pod:455 msgid "" "The two main API calls to run commands are L</guestfs_command> and " "L</guestfs_sh> (there are also variations)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:443 +#: ../src/guestfs.pod:458 msgid "" "The difference is that L</guestfs_sh> runs commands using the shell, so any " "shell globs, redirections, etc will work." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:446 +#: ../src/guestfs.pod:461 msgid "CONFIGURATION FILES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:448 +#: ../src/guestfs.pod:463 msgid "" "To read and write configuration files in Linux guest filesystems, we " "strongly recommend using Augeas. For example, Augeas understands how to " @@ -33401,7 +33980,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:453 +#: ../src/guestfs.pod:468 msgid "" "The main Augeas calls are bound through the C<guestfs_aug_*> APIs. We don't " "document Augeas itself here because there is excellent documentation on the " @@ -33409,7 +33988,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:457 +#: ../src/guestfs.pod:472 msgid "" "If you don't want to use Augeas (you fool!) then try calling " "L</guestfs_read_lines> to get the file as a list of lines which you can " @@ -33417,24 +33996,24 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:461 +#: ../src/guestfs.pod:476 msgid "SELINUX" msgstr "" #. type: textblock -#: ../src/guestfs.pod:463 +#: ../src/guestfs.pod:478 msgid "" "We support SELinux guests. To ensure that labeling happens correctly in " "SELinux guests, you need to enable SELinux and load the guest's policy:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:471 +#: ../src/guestfs.pod:486 msgid "Before launching, do:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:473 +#: ../src/guestfs.pod:488 #, no-wrap msgid "" " guestfs_set_selinux (g, 1);\n" @@ -33442,14 +34021,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:477 +#: ../src/guestfs.pod:492 msgid "" "After mounting the guest's filesystem(s), load the policy. This is best " "done by running the L<load_policy(8)> command in the guest itself:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:481 +#: ../src/guestfs.pod:496 #, no-wrap msgid "" " guestfs_sh (g, \"/usr/sbin/load_policy\");\n" @@ -33457,21 +34036,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:483 +#: ../src/guestfs.pod:498 msgid "" "(Older versions of C<load_policy> require you to specify the name of the " "policy file)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:488 +#: ../src/guestfs.pod:503 msgid "" "Optionally, set the security context for the API. The correct security " "context to use can only be known by inspecting the guest. As an example:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:492 +#: ../src/guestfs.pod:507 #, no-wrap msgid "" " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n" @@ -33479,24 +34058,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:496 +#: ../src/guestfs.pod:511 msgid "This will work for running commands and editing existing files." msgstr "" #. type: textblock -#: ../src/guestfs.pod:498 +#: ../src/guestfs.pod:513 msgid "" "When new files are created, you may need to label them explicitly, for " "example by running the external command C<restorecon pathname>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:502 +#: ../src/guestfs.pod:517 msgid "UMASK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:504 +#: ../src/guestfs.pod:519 msgid "" "Certain calls are affected by the current file mode creation mask (the " "\"umask\"). In particular ones which create files or directories, such as " @@ -33506,14 +34085,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:510 +#: ../src/guestfs.pod:525 msgid "" "The default umask is C<022>, so files are created with modes such as C<0644> " "and directories with C<0755>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:513 +#: ../src/guestfs.pod:528 msgid "" "There are two ways to avoid being affected by umask. Either set umask to 0 " "(call C<guestfs_umask (g, 0)> early after launching). Or call " @@ -33521,12 +34100,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:517 +#: ../src/guestfs.pod:532 msgid "For more information about umask, see L<umask(2)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:521 +#: ../src/guestfs.pod:536 msgid "" "Libguestfs allows you to access Linux guests which have been encrypted using " "whole disk encryption that conforms to the Linux Unified Key Setup (LUKS) " @@ -33535,21 +34114,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:527 +#: ../src/guestfs.pod:542 msgid "" "Use L</guestfs_vfs_type> to identify LUKS-encrypted block devices (it " "returns the string C<crypto_LUKS>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:530 +#: ../src/guestfs.pod:545 msgid "" "Then open these devices by calling L</guestfs_luks_open>. Obviously you " "will require the passphrase!" msgstr "" #. type: textblock -#: ../src/guestfs.pod:533 +#: ../src/guestfs.pod:548 msgid "" "Opening a LUKS device creates a new device mapper device called " "C</dev/mapper/mapname> (where C<mapname> is the string you supply to " @@ -33558,7 +34137,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:539 +#: ../src/guestfs.pod:554 msgid "" "LVM volume groups on the device can be made visible by calling " "L</guestfs_vgscan> followed by L</guestfs_vg_activate_all>. The logical " @@ -33566,7 +34145,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:543 +#: ../src/guestfs.pod:558 msgid "" "Use the reverse process to close a LUKS device. Unmount any logical volumes " "on it, deactivate the volume groups by caling C<guestfs_vg_activate (g, 0, " @@ -33576,12 +34155,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:550 +#: ../src/guestfs.pod:565 msgid "INSPECTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:552 +#: ../src/guestfs.pod:567 msgid "" "Libguestfs has APIs for inspecting an unknown disk image to find out if it " "contains operating systems, an install CD or a live CD. (These APIs used to " @@ -33591,14 +34170,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:559 +#: ../src/guestfs.pod:574 msgid "" "Add all disks belonging to the unknown virtual machine and call " "L</guestfs_launch> in the usual way." msgstr "" #. type: textblock -#: ../src/guestfs.pod:562 +#: ../src/guestfs.pod:577 msgid "" "Then call L</guestfs_inspect_os>. This function uses other libguestfs calls " "and certain heuristics, and returns a list of operating systems that were " @@ -33611,7 +34190,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:571 +#: ../src/guestfs.pod:586 msgid "" "For each root, you can then call various C<guestfs_inspect_get_*> functions " "to get additional details about that operating system. For example, call " @@ -33620,7 +34199,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:577 +#: ../src/guestfs.pod:592 msgid "" "Un*x-like and Linux-based operating systems usually consist of several " "filesystems which are mounted at boot time (for example, a separate boot " @@ -33631,7 +34210,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:584 +#: ../src/guestfs.pod:599 #, no-wrap msgid "" " /boot => /dev/sda1\n" @@ -33641,14 +34220,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:588 +#: ../src/guestfs.pod:603 msgid "" "The caller can then make calls to L</guestfs_mount_options> to mount the " "filesystems as suggested." msgstr "" #. type: textblock -#: ../src/guestfs.pod:591 +#: ../src/guestfs.pod:606 msgid "" "Be careful to mount filesystems in the right order (eg. C</> before " "C</usr>). Sorting the keys of the hash by length, shortest first, should " @@ -33656,7 +34235,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:595 +#: ../src/guestfs.pod:610 msgid "" "Inspection currently only works for some common operating systems. " "Contributors are welcome to send patches for other operating systems that we " @@ -33664,7 +34243,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:599 +#: ../src/guestfs.pod:614 msgid "" "Encrypted disks must be opened before inspection. See L</ENCRYPTED DISKS> " "for more details. The L</guestfs_inspect_os> function just ignores any " @@ -33672,7 +34251,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:603 +#: ../src/guestfs.pod:618 msgid "" "A note on the implementation: The call L</guestfs_inspect_os> performs " "inspection and caches the results in the guest handle. Subsequent calls to " @@ -33685,19 +34264,19 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:612 +#: ../src/guestfs.pod:627 msgid "INSPECTING INSTALL DISKS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:614 +#: ../src/guestfs.pod:629 msgid "" "Libguestfs (since 1.9.4) can detect some install disks, install CDs, live " "CDs and more." msgstr "" #. type: textblock -#: ../src/guestfs.pod:617 +#: ../src/guestfs.pod:632 msgid "" "Call L</guestfs_inspect_get_format> to return the format of the operating " "system, which currently can be C<installed> (a regular operating system) or " @@ -33705,7 +34284,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:621 +#: ../src/guestfs.pod:636 msgid "" "Further information is available about the operating system that can be " "installed using the regular inspection APIs like " @@ -33714,7 +34293,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:626 +#: ../src/guestfs.pod:641 msgid "" "Some additional information specific to installer disks is also available " "from the L</guestfs_inspect_is_live>, L</guestfs_inspect_is_netinst> and " @@ -33722,24 +34301,24 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:631 +#: ../src/guestfs.pod:646 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:633 +#: ../src/guestfs.pod:648 msgid "" "Libguestfs can mount NTFS partitions. It does this using the " "L<http://www.ntfs-3g.org/> driver." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:636 +#: ../src/guestfs.pod:651 msgid "DRIVE LETTERS AND PATHS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:638 +#: ../src/guestfs.pod:653 msgid "" "DOS and Windows still use drive letters, and the filesystems are always " "treated as case insensitive by Windows itself, and therefore you might find " @@ -33749,14 +34328,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:644 +#: ../src/guestfs.pod:659 msgid "" "Drive letter mappings can be found using inspection (see L</INSPECTION> and " "L</guestfs_inspect_get_drive_mappings>)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:647 +#: ../src/guestfs.pod:662 msgid "" "Dealing with separator characters (backslash vs forward slash) is outside " "the scope of libguestfs, but usually a simple character replacement will " @@ -33764,19 +34343,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:651 +#: ../src/guestfs.pod:666 msgid "" "To resolve the case insensitivity of paths, call " "L</guestfs_case_sensitive_path>." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:654 +#: ../src/guestfs.pod:669 msgid "ACCESSING THE WINDOWS REGISTRY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:656 +#: ../src/guestfs.pod:671 msgid "" "Libguestfs also provides some help for decoding Windows Registry \"hive\" " "files, through the library C<hivex> which is part of the libguestfs project " @@ -33787,12 +34366,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:664 +#: ../src/guestfs.pod:679 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:666 +#: ../src/guestfs.pod:681 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 " @@ -33800,12 +34379,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:670 +#: ../src/guestfs.pod:685 msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-symbolic-links/>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:672 +#: ../src/guestfs.pod:687 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 " @@ -33815,7 +34394,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:679 +#: ../src/guestfs.pod:694 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 " @@ -33824,36 +34403,36 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:684 +#: ../src/guestfs.pod:699 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:686 +#: ../src/guestfs.pod:701 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:689 +#: ../src/guestfs.pod:704 msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:691 +#: ../src/guestfs.pod:706 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:693 +#: ../src/guestfs.pod:708 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:696 +#: ../src/guestfs.pod:711 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)> " @@ -33863,14 +34442,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:702 +#: ../src/guestfs.pod:717 msgid "" "Error messages are automatically transformed into exceptions if the language " "supports it." msgstr "" #. type: textblock -#: ../src/guestfs.pod:705 +#: ../src/guestfs.pod:720 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 " @@ -33878,46 +34457,46 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:711 +#: ../src/guestfs.pod:726 msgid "B<C++>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:713 +#: ../src/guestfs.pod:728 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:717 +#: ../src/guestfs.pod:732 msgid "B<C#>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:719 +#: ../src/guestfs.pod:734 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:722 +#: ../src/guestfs.pod:737 msgid "B<Erlang>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:724 +#: ../src/guestfs.pod:739 msgid "See L<guestfs-erlang(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:726 +#: ../src/guestfs.pod:741 msgid "B<Haskell>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:728 +#: ../src/guestfs.pod:743 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 " @@ -33925,91 +34504,91 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:732 +#: ../src/guestfs.pod:747 msgid "B<Java>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:734 +#: ../src/guestfs.pod:749 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:737 +#: ../src/guestfs.pod:752 msgid "B<OCaml>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:739 +#: ../src/guestfs.pod:754 msgid "See L<guestfs-ocaml(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:741 +#: ../src/guestfs.pod:756 msgid "B<Perl>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:743 +#: ../src/guestfs.pod:758 msgid "See L<guestfs-perl(3)> and L<Sys::Guestfs(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:745 +#: ../src/guestfs.pod:760 msgid "B<PHP>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:747 +#: ../src/guestfs.pod:762 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:750 +#: ../src/guestfs.pod:765 msgid "The PHP binding only works correctly on 64 bit machines." msgstr "" #. type: =item -#: ../src/guestfs.pod:752 +#: ../src/guestfs.pod:767 msgid "B<Python>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:754 +#: ../src/guestfs.pod:769 msgid "See L<guestfs-python(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:756 +#: ../src/guestfs.pod:771 msgid "B<Ruby>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:758 +#: ../src/guestfs.pod:773 msgid "See L<guestfs-ruby(3)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:760 +#: ../src/guestfs.pod:775 msgid "B<shell scripts>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:762 +#: ../src/guestfs.pod:777 msgid "See L<guestfish(1)>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:766 +#: ../src/guestfs.pod:781 msgid "LIBGUESTFS GOTCHAS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:768 +#: ../src/guestfs.pod:783 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 " @@ -34017,7 +34596,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:772 +#: ../src/guestfs.pod:787 msgid "" "Since we developed libguestfs and the associated tools, there are several " "things we would have designed differently, but are now stuck with for " @@ -34026,19 +34605,19 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:780 +#: ../src/guestfs.pod:795 msgid "Autosync / forgetting to sync." msgstr "" #. type: textblock -#: ../src/guestfs.pod:782 +#: ../src/guestfs.pod:797 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:785 +#: ../src/guestfs.pod:800 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 " @@ -34046,7 +34625,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:789 +#: ../src/guestfs.pod:804 #, no-wrap msgid "" " guestfs_set_autosync (g, 1);\n" @@ -34054,7 +34633,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:791 +#: ../src/guestfs.pod:806 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> " @@ -34062,7 +34641,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:795 +#: ../src/guestfs.pod:810 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 " @@ -34070,7 +34649,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:799 +#: ../src/guestfs.pod:814 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 " @@ -34078,19 +34657,19 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:803 +#: ../src/guestfs.pod:818 msgid "Mount option C<-o sync> should not be the default." msgstr "" #. type: textblock -#: ../src/guestfs.pod:805 +#: ../src/guestfs.pod:820 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:808 +#: ../src/guestfs.pod:823 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 " @@ -34098,31 +34677,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:812 +#: ../src/guestfs.pod:827 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:815 +#: ../src/guestfs.pod:830 msgid "Read-only should be the default." msgstr "" #. type: textblock -#: ../src/guestfs.pod:817 +#: ../src/guestfs.pod:832 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:820 +#: ../src/guestfs.pod:835 msgid "This would reduce the potential to corrupt live VM images." msgstr "" #. type: textblock -#: ../src/guestfs.pod:822 +#: ../src/guestfs.pod:837 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 " @@ -34130,12 +34709,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:826 +#: ../src/guestfs.pod:841 msgid "guestfish command line is hard to use." msgstr "" #. type: textblock -#: ../src/guestfs.pod:828 +#: ../src/guestfs.pod:843 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 " @@ -34145,12 +34724,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:835 +#: ../src/guestfs.pod:850 msgid "guestfish megabyte modifiers don't work right on all commands" msgstr "" #. type: textblock -#: ../src/guestfs.pod:837 +#: ../src/guestfs.pod:852 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 " @@ -34160,12 +34739,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:844 +#: ../src/guestfs.pod:859 msgid "The most common is L</guestfs_lvcreate>. The guestfish command:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:846 +#: ../src/guestfs.pod:861 #, no-wrap msgid "" " lvcreate LV VG 100M\n" @@ -34173,7 +34752,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:848 +#: ../src/guestfs.pod:863 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 " @@ -34182,19 +34761,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:853 +#: ../src/guestfs.pod:868 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:856 +#: ../src/guestfs.pod:871 msgid "Ambiguity between devices and paths" msgstr "" #. type: textblock -#: ../src/guestfs.pod:858 +#: ../src/guestfs.pod:873 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 " @@ -34202,7 +34781,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:863 +#: ../src/guestfs.pod:878 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>. " @@ -34211,7 +34790,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:869 +#: ../src/guestfs.pod:884 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 " @@ -34221,7 +34800,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:875 +#: ../src/guestfs.pod:890 #, no-wrap msgid "" " type path = Path of string | Device of int | Partition of int * int\n" @@ -34229,12 +34808,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:877 +#: ../src/guestfs.pod:892 msgid "which would allow you to pass arguments like:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:879 +#: ../src/guestfs.pod:894 #, no-wrap msgid "" " Path \"/foo/bar\"\n" @@ -34245,26 +34824,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:884 +#: ../src/guestfs.pod:899 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:889 +#: ../src/guestfs.pod:904 msgid "KEYS AND PASSPHRASES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:891 +#: ../src/guestfs.pod:906 msgid "" "Certain libguestfs calls take a parameter that contains sensitive key " "material, passed in as a C string." msgstr "" #. type: textblock -#: ../src/guestfs.pod:894 +#: ../src/guestfs.pod:909 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 " @@ -34273,7 +34852,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:899 +#: ../src/guestfs.pod:914 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, " @@ -34281,19 +34860,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:904 +#: ../src/guestfs.pod:919 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:906 +#: ../src/guestfs.pod:921 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:909 +#: ../src/guestfs.pod:924 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 " @@ -34301,33 +34880,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:913 +#: ../src/guestfs.pod:928 msgid "" "See the graphical program guestfs-browser for one possible architecture for " "multithreaded programs using libvirt and libguestfs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:916 +#: ../src/guestfs.pod:931 msgid "PATH" msgstr "" #. type: textblock -#: ../src/guestfs.pod:918 +#: ../src/guestfs.pod:933 msgid "" "Libguestfs needs a supermin appliance, which it finds by looking along an " "internal path." msgstr "" #. type: textblock -#: ../src/guestfs.pod:921 +#: ../src/guestfs.pod:936 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:924 +#: ../src/guestfs.pod:939 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 " @@ -34338,12 +34917,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:931 +#: ../src/guestfs.pod:946 msgid "QEMU WRAPPERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:933 +#: ../src/guestfs.pod:948 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 " @@ -34351,7 +34930,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:937 +#: ../src/guestfs.pod:952 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 " @@ -34360,14 +34939,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:942 +#: ../src/guestfs.pod:957 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:945 +#: ../src/guestfs.pod:960 #, no-wrap msgid "" " #!/bin/sh -\n" @@ -34378,7 +34957,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:949 +#: ../src/guestfs.pod:964 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 " @@ -34386,7 +34965,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:953 +#: ../src/guestfs.pod:968 #, no-wrap msgid "" " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n" @@ -34394,14 +34973,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:955 +#: ../src/guestfs.pod:970 msgid "" "Note that libguestfs also calls qemu with the -help and -version options in " "order to determine features." msgstr "" #. type: textblock -#: ../src/guestfs.pod:958 +#: ../src/guestfs.pod:973 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 " @@ -34411,7 +34990,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:967 +#: ../src/guestfs.pod:982 #, no-wrap msgid "" " i=0\n" @@ -34429,7 +35008,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:979 +#: ../src/guestfs.pod:994 #, no-wrap msgid "" " exec qemu-kvm -machine pc,accel=tcg \"${args[@]}\"\n" @@ -34437,19 +35016,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:981 +#: ../src/guestfs.pod:996 msgid "ATTACHING TO RUNNING DAEMONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:983 +#: ../src/guestfs.pod:998 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:986 +#: ../src/guestfs.pod:1001 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 " @@ -34457,12 +35036,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:990 +#: ../src/guestfs.pod:1005 msgid "Using guestfs_set_attach_method" msgstr "" #. type: textblock -#: ../src/guestfs.pod:992 +#: ../src/guestfs.pod:1007 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 " @@ -34470,14 +35049,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:996 +#: ../src/guestfs.pod:1011 msgid "" "The normal attach method is C<appliance>, where a small appliance is created " "containing the daemon, and then the library connects to this." msgstr "" #. type: textblock -#: ../src/guestfs.pod:999 +#: ../src/guestfs.pod:1014 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 " @@ -34485,7 +35064,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1003 +#: ../src/guestfs.pod:1018 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 " @@ -34493,12 +35072,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1007 +#: ../src/guestfs.pod:1022 msgid "Using guestfs_add_domain with live flag" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1009 +#: ../src/guestfs.pod:1024 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 " @@ -34507,7 +35086,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1015 +#: ../src/guestfs.pod:1030 #, no-wrap msgid "" " <domain>\n" @@ -34525,14 +35104,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1027 +#: ../src/guestfs.pod:1042 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:1030 +#: ../src/guestfs.pod:1045 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 " @@ -34540,19 +35119,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1034 +#: ../src/guestfs.pod:1049 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:1038 +#: ../src/guestfs.pod:1053 msgid "ABI GUARANTEE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1040 +#: ../src/guestfs.pod:1055 msgid "" "We guarantee the libguestfs ABI (binary interface), for public, high-level " "actions as outlined in this section. Although we will deprecate some " @@ -34562,12 +35141,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1046 +#: ../src/guestfs.pod:1061 msgid "BLOCK DEVICE NAMING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1048 +#: ../src/guestfs.pod:1063 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 " @@ -34582,7 +35161,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1060 +#: ../src/guestfs.pod:1075 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 " @@ -34590,7 +35169,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1064 +#: ../src/guestfs.pod:1079 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 " @@ -34598,7 +35177,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1069 +#: ../src/guestfs.pod:1084 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 " @@ -34607,7 +35186,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1075 +#: ../src/guestfs.pod:1090 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 " @@ -34615,12 +35194,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1080 +#: ../src/guestfs.pod:1095 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1082 +#: ../src/guestfs.pod:1097 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 " @@ -34630,7 +35209,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1088 +#: ../src/guestfs.pod:1103 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 " @@ -34638,54 +35217,54 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1096 +#: ../src/guestfs.pod:1111 msgid "Is the string a parameter which is a device or partition name?" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1100 +#: ../src/guestfs.pod:1115 msgid "Does the string begin with C</dev/sd>?" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1104 +#: ../src/guestfs.pod:1119 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:1109 +#: ../src/guestfs.pod:1124 msgid "Replace initial C</dev/sd> string with C</dev/hd>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1111 +#: ../src/guestfs.pod:1126 msgid "For example, change C</dev/sda2> to C</dev/hda2>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1113 +#: ../src/guestfs.pod:1128 msgid "If that named device exists, use it. If not, continue." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1117 +#: ../src/guestfs.pod:1132 msgid "Replace initial C</dev/sd> string with C</dev/vd>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1119 +#: ../src/guestfs.pod:1134 msgid "If that named device exists, use it. If not, return an error." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1123 +#: ../src/guestfs.pod:1138 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1125 +#: ../src/guestfs.pod:1140 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 " @@ -34693,45 +35272,45 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1129 +#: ../src/guestfs.pod:1144 msgid "" "Where possible for maximum future portability programs using libguestfs " "should use these future-proof techniques:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1136 +#: ../src/guestfs.pod:1151 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:1139 +#: ../src/guestfs.pod:1154 msgid "Since those device names exist by definition, they will never be translated." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1144 +#: ../src/guestfs.pod:1159 msgid "" "Use higher level ways to identify filesystems, such as LVM names, UUIDs and " "filesystem labels." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1151 +#: ../src/guestfs.pod:1166 msgid "" "This section discusses security implications of using libguestfs, " "particularly with untrusted or malicious guests or disk images." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1154 +#: ../src/guestfs.pod:1169 msgid "GENERAL SECURITY CONSIDERATIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1156 +#: ../src/guestfs.pod:1171 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 " @@ -34741,42 +35320,42 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1166 +#: ../src/guestfs.pod:1181 msgid "the data (file etc) not being present" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1170 +#: ../src/guestfs.pod:1185 msgid "being present but empty" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1174 +#: ../src/guestfs.pod:1189 msgid "being much larger than normal" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1178 +#: ../src/guestfs.pod:1193 msgid "containing arbitrary 8 bit data" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1182 +#: ../src/guestfs.pod:1197 msgid "being in an unexpected character encoding" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1186 +#: ../src/guestfs.pod:1201 msgid "containing homoglyphs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1190 +#: ../src/guestfs.pod:1205 msgid "SECURITY OF MOUNTING FILESYSTEMS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1192 +#: ../src/guestfs.pod:1207 msgid "" "When you mount a filesystem under Linux, mistakes in the kernel filesystem " "(VFS) module can sometimes be escalated into exploits by deliberately " @@ -34792,7 +35371,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1205 +#: ../src/guestfs.pod:1220 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 " @@ -34806,19 +35385,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1216 +#: ../src/guestfs.pod:1231 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:1219 +#: ../src/guestfs.pod:1234 msgid "PROTOCOL SECURITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1221 +#: ../src/guestfs.pod:1236 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 " @@ -34828,12 +35407,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1227 +#: ../src/guestfs.pod:1242 msgid "INSPECTION SECURITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1229 +#: ../src/guestfs.pod:1244 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 " @@ -34842,7 +35421,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1235 +#: ../src/guestfs.pod:1250 msgid "" "Guest configuration may be altered in unusual ways by the administrator of " "the virtual machine, and may not reflect reality (particularly for untrusted " @@ -34853,7 +35432,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1243 +#: ../src/guestfs.pod:1258 msgid "" "The inspection API parses guest configuration using two external libraries: " "Augeas (Linux configuration) and hivex (Windows Registry). Both are " @@ -34863,12 +35442,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1249 +#: ../src/guestfs.pod:1264 msgid "RUNNING UNTRUSTED GUEST COMMANDS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1251 +#: ../src/guestfs.pod:1266 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 " @@ -34878,24 +35457,24 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1257 +#: ../src/guestfs.pod:1272 msgid "CVE-2010-3851" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1259 +#: ../src/guestfs.pod:1274 msgid "https://bugzilla.redhat.com/642934" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1261 +#: ../src/guestfs.pod:1276 msgid "" "This security bug concerns the automatic disk format detection that qemu " "does on disk images." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1264 +#: ../src/guestfs.pod:1279 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 " @@ -34904,7 +35483,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1269 +#: ../src/guestfs.pod:1284 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 " @@ -34913,7 +35492,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1274 +#: ../src/guestfs.pod:1289 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 " @@ -34925,24 +35504,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1282 +#: ../src/guestfs.pod:1297 msgid "In libguestfs this is rather hard to exploit except under two circumstances:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1289 +#: ../src/guestfs.pod:1304 msgid "You have enabled the network or have opened the disk in write mode." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1293 +#: ../src/guestfs.pod:1308 msgid "" "You are also running untrusted code from the guest (see L</RUNNING " "COMMANDS>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1298 +#: ../src/guestfs.pod:1313 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 " @@ -34951,31 +35530,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1303 +#: ../src/guestfs.pod:1318 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:1306 +#: ../src/guestfs.pod:1321 msgid "" "For libguestfs tools, use the I<--format> command line parameter as " "appropriate." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1309 +#: ../src/guestfs.pod:1324 msgid "CONNECTION MANAGEMENT" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1311 +#: ../src/guestfs.pod:1326 msgid "guestfs_h *" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1313 +#: ../src/guestfs.pod:1328 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 " @@ -34983,19 +35562,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1317 +#: ../src/guestfs.pod:1332 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:1320 +#: ../src/guestfs.pod:1335 msgid "guestfs_create" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1322 +#: ../src/guestfs.pod:1337 #, no-wrap msgid "" " guestfs_h *guestfs_create (void);\n" @@ -35003,19 +35582,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1324 +#: ../src/guestfs.pod:1339 msgid "Create a connection handle." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1326 +#: ../src/guestfs.pod:1341 msgid "" "On success this returns a non-NULL pointer to a handle. On error it returns " "NULL." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1329 +#: ../src/guestfs.pod:1344 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 " @@ -35023,24 +35602,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1333 +#: ../src/guestfs.pod:1348 msgid "After configuring the handle, you have to call L</guestfs_launch>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1335 +#: ../src/guestfs.pod:1350 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:1338 +#: ../src/guestfs.pod:1353 msgid "guestfs_close" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1340 +#: ../src/guestfs.pod:1355 #, no-wrap msgid "" " void guestfs_close (guestfs_h *g);\n" @@ -35048,12 +35627,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1342 +#: ../src/guestfs.pod:1357 msgid "This closes the connection handle and frees up all resources used." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1344 +#: ../src/guestfs.pod:1359 msgid "" "If autosync was set on the handle and the handle was launched, then this " "implicitly calls various functions to unmount filesystems and sync the " @@ -35061,24 +35640,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1348 +#: ../src/guestfs.pod:1363 msgid "If a close callback was set on the handle, then it is called." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1350 +#: ../src/guestfs.pod:1365 msgid "ERROR HANDLING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1352 +#: ../src/guestfs.pod:1367 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:1355 +#: ../src/guestfs.pod:1370 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 " @@ -35086,7 +35665,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1359 +#: ../src/guestfs.pod:1374 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 " @@ -35094,7 +35673,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1364 +#: ../src/guestfs.pod:1379 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 " @@ -35102,7 +35681,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1368 +#: ../src/guestfs.pod:1383 #, no-wrap msgid "" " if (guestfs_launch (g) == -1)\n" @@ -35111,21 +35690,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1371 +#: ../src/guestfs.pod:1386 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:1374 +#: ../src/guestfs.pod:1389 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:1377 +#: ../src/guestfs.pod:1392 #, no-wrap msgid "" " /* This disables the default behaviour of printing errors\n" @@ -35135,7 +35714,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1381 +#: ../src/guestfs.pod:1396 #, no-wrap msgid "" " if (guestfs_launch (g) == -1) {\n" @@ -35152,7 +35731,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1392 +#: ../src/guestfs.pod:1407 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 " @@ -35160,7 +35739,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1396 +#: ../src/guestfs.pod:1411 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 " @@ -35170,12 +35749,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1402 +#: ../src/guestfs.pod:1417 msgid "guestfs_last_error" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1404 +#: ../src/guestfs.pod:1419 #, no-wrap msgid "" " const char *guestfs_last_error (guestfs_h *g);\n" @@ -35183,26 +35762,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1406 +#: ../src/guestfs.pod:1421 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:1410 +#: ../src/guestfs.pod:1425 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:1413 +#: ../src/guestfs.pod:1428 msgid "guestfs_last_errno" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1415 +#: ../src/guestfs.pod:1430 #, no-wrap msgid "" " int guestfs_last_errno (guestfs_h *g);\n" @@ -35210,27 +35789,27 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1417 +#: ../src/guestfs.pod:1432 msgid "This returns the last error number (errno) that happened on C<g>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1419 +#: ../src/guestfs.pod:1434 msgid "If successful, an errno integer not equal to zero is returned." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1421 +#: ../src/guestfs.pod:1436 msgid "If no error, this returns 0. This call can return 0 in three situations:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1428 +#: ../src/guestfs.pod:1443 msgid "There has not been any error on the handle." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1432 +#: ../src/guestfs.pod:1447 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 " @@ -35238,14 +35817,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1438 +#: ../src/guestfs.pod:1453 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:1444 +#: ../src/guestfs.pod:1459 msgid "" "Libguestfs tries to convert the errno from inside the applicance into a " "corresponding errno for the caller (not entirely trivial: the appliance " @@ -35256,12 +35835,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1452 +#: ../src/guestfs.pod:1467 msgid "guestfs_set_error_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1454 +#: ../src/guestfs.pod:1469 #, no-wrap msgid "" " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n" @@ -35274,7 +35853,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1461 +#: ../src/guestfs.pod:1476 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 " @@ -35282,14 +35861,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1465 +#: ../src/guestfs.pod:1480 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:1468 +#: ../src/guestfs.pod:1483 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 " @@ -35297,22 +35876,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1472 +#: ../src/guestfs.pod:1487 msgid "The default handler prints messages on C<stderr>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1474 +#: ../src/guestfs.pod:1489 msgid "If you set C<cb> to C<NULL> then I<no> handler is called." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1476 +#: ../src/guestfs.pod:1491 msgid "guestfs_get_error_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1478 +#: ../src/guestfs.pod:1493 #, no-wrap msgid "" " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n" @@ -35321,17 +35900,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1481 +#: ../src/guestfs.pod:1496 msgid "Returns the current error handler callback." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1483 +#: ../src/guestfs.pod:1498 msgid "guestfs_set_out_of_memory_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1485 +#: ../src/guestfs.pod:1500 #, no-wrap msgid "" " typedef void (*guestfs_abort_cb) (void);\n" @@ -35341,29 +35920,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1489 +#: ../src/guestfs.pod:1504 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:1492 +#: ../src/guestfs.pod:1507 msgid "The default is to call L<abort(3)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1494 +#: ../src/guestfs.pod:1509 msgid "You cannot set C<cb> to C<NULL>. You can't ignore out of memory situations." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1497 +#: ../src/guestfs.pod:1512 msgid "guestfs_get_out_of_memory_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1499 +#: ../src/guestfs.pod:1514 #, no-wrap msgid "" " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n" @@ -35371,37 +35950,37 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1501 +#: ../src/guestfs.pod:1516 msgid "This returns the current out of memory handler." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1503 +#: ../src/guestfs.pod:1518 msgid "API CALLS" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1507 +#: ../src/guestfs.pod:1522 msgid "STRUCTURES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1509 +#: ../src/guestfs.pod:1524 msgid "@STRUCTS@" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1511 +#: ../src/guestfs.pod:1526 msgid "AVAILABILITY" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1513 +#: ../src/guestfs.pod:1528 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1515 +#: ../src/guestfs.pod:1530 msgid "" "Using L</guestfs_available> you can test availability of the following " "groups of functions. This test queries the appliance to see if the " @@ -35409,17 +35988,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1520 +#: ../src/guestfs.pod:1535 msgid "@AVAILABILITY@" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1522 +#: ../src/guestfs.pod:1537 msgid "GUESTFISH supported COMMAND" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1524 +#: ../src/guestfs.pod:1539 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 " @@ -35427,19 +36006,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1529 +#: ../src/guestfs.pod:1544 msgid "SINGLE CALLS AT COMPILE TIME" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1531 +#: ../src/guestfs.pod:1546 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:1534 +#: ../src/guestfs.pod:1549 #, no-wrap msgid "" " #define LIBGUESTFS_HAVE_DD 1\n" @@ -35447,12 +36026,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1536 +#: ../src/guestfs.pod:1551 msgid "if L</guestfs_dd> is available." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1538 +#: ../src/guestfs.pod:1553 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 " @@ -35460,7 +36039,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1543 +#: ../src/guestfs.pod:1558 #, no-wrap msgid "" " AC_CHECK_LIB([guestfs],[guestfs_create])\n" @@ -35469,19 +36048,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1546 +#: ../src/guestfs.pod:1561 msgid "" "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined " "in your program." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1549 +#: ../src/guestfs.pod:1564 msgid "SINGLE CALLS AT RUN TIME" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1551 +#: ../src/guestfs.pod:1566 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 " @@ -35491,7 +36070,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1558 +#: ../src/guestfs.pod:1573 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 " @@ -35499,7 +36078,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1562 +#: ../src/guestfs.pod:1577 #, no-wrap msgid "" " #include <stdio.h>\n" @@ -35511,7 +36090,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1568 +#: ../src/guestfs.pod:1583 #, no-wrap msgid "" " main ()\n" @@ -35523,7 +36102,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1574 +#: ../src/guestfs.pod:1589 #, no-wrap msgid "" " /* Test if the function guestfs_dd is really available. */\n" @@ -35538,7 +36117,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1583 +#: ../src/guestfs.pod:1598 #, no-wrap msgid "" " if (!has_function)\n" @@ -35557,7 +36136,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1596 +#: ../src/guestfs.pod:1611 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 " @@ -35565,7 +36144,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1601 +#: ../src/guestfs.pod:1616 #, no-wrap msgid "" " Requires: libguestfs >= 1.0.80\n" @@ -35573,12 +36152,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1603 +#: ../src/guestfs.pod:1618 msgid "CALLS WITH OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1605 +#: ../src/guestfs.pod:1620 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 " @@ -35586,7 +36165,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1610 +#: ../src/guestfs.pod:1625 #, no-wrap msgid "" " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n" @@ -35594,14 +36173,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1612 +#: ../src/guestfs.pod:1627 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:1615 +#: ../src/guestfs.pod:1630 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename, -1);\n" @@ -35609,12 +36188,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1617 +#: ../src/guestfs.pod:1632 msgid "With a single optional argument:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1619 +#: ../src/guestfs.pod:1634 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -35624,12 +36203,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1623 +#: ../src/guestfs.pod:1638 msgid "With two:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1625 +#: ../src/guestfs.pod:1640 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -35640,19 +36219,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1630 +#: ../src/guestfs.pod:1645 msgid "" "and so forth. Don't forget the terminating C<-1> otherwise Bad Things will " "happen!" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1633 +#: ../src/guestfs.pod:1648 msgid "USING va_list FOR OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1635 +#: ../src/guestfs.pod:1650 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 " @@ -35660,7 +36239,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1639 +#: ../src/guestfs.pod:1654 #, no-wrap msgid "" " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n" @@ -35669,12 +36248,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1642 +#: ../src/guestfs.pod:1657 msgid "CONSTRUCTING OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1644 +#: ../src/guestfs.pod:1659 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 " @@ -35684,7 +36263,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1650 +#: ../src/guestfs.pod:1665 #, no-wrap msgid "" " struct guestfs_add_drive_opts_argv {\n" @@ -35699,12 +36278,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1659 +#: ../src/guestfs.pod:1674 msgid "You could call it like this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1661 +#: ../src/guestfs.pod:1676 #, no-wrap msgid "" " struct guestfs_add_drive_opts_argv optargs = {\n" @@ -35717,7 +36296,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1668 +#: ../src/guestfs.pod:1683 #, no-wrap msgid "" " guestfs_add_drive_opts_argv (g, filename, &optargs);\n" @@ -35725,29 +36304,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1676 +#: ../src/guestfs.pod:1691 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1681 +#: ../src/guestfs.pod:1696 msgid "You do not need to fill in all fields of the structure." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1685 +#: ../src/guestfs.pod:1700 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:1690 +#: ../src/guestfs.pod:1705 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1692 +#: ../src/guestfs.pod:1707 msgid "" "In other languages, optional arguments are expressed in the way that is " "natural for that language. We refer you to the language-specific " @@ -35755,17 +36334,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1696 +#: ../src/guestfs.pod:1711 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1698 +#: ../src/guestfs.pod:1713 msgid "SETTING CALLBACKS TO HANDLE EVENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1700 +#: ../src/guestfs.pod:1715 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 " @@ -35777,7 +36356,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1709 +#: ../src/guestfs.pod:1724 msgid "" "Handles generate events when certain things happen, such as log messages " "being generated, progress messages during long-running operations, or the " @@ -35789,7 +36368,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1717 +#: ../src/guestfs.pod:1732 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 " @@ -35798,31 +36377,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1722 +#: ../src/guestfs.pod:1737 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:1726 +#: ../src/guestfs.pod:1741 msgid "CLASSES OF EVENTS" msgstr "" #. type: =item -#: ../src/guestfs.pod:1730 +#: ../src/guestfs.pod:1745 msgid "GUESTFS_EVENT_CLOSE (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1733 +#: ../src/guestfs.pod:1748 msgid "" "The callback function will be called while the handle is being closed " "(synchronously from L</guestfs_close>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1736 +#: ../src/guestfs.pod:1751 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 " @@ -35833,19 +36412,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1743 +#: ../src/guestfs.pod:1758 msgid "" "If no callback is registered: the handle is closed without any callback " "being invoked." msgstr "" #. type: =item -#: ../src/guestfs.pod:1746 +#: ../src/guestfs.pod:1761 msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1749 +#: ../src/guestfs.pod:1764 msgid "" "The callback function will be called when the child process quits, either " "asynchronously or if killed by L</guestfs_kill_subprocess>. (This " @@ -35853,17 +36432,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1753 ../src/guestfs.pod:1762 ../src/guestfs.pod:1879 +#: ../src/guestfs.pod:1768 ../src/guestfs.pod:1777 ../src/guestfs.pod:1894 msgid "If no callback is registered: the event is ignored." msgstr "" #. type: =item -#: ../src/guestfs.pod:1755 +#: ../src/guestfs.pod:1770 msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1758 +#: ../src/guestfs.pod:1773 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 " @@ -35871,12 +36450,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:1764 +#: ../src/guestfs.pod:1779 msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1767 +#: ../src/guestfs.pod:1782 msgid "" "Some long-running operations can generate progress messages. If this " "callback is registered, then it will be called each time a progress message " @@ -35886,14 +36465,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1773 +#: ../src/guestfs.pod:1788 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:1776 +#: ../src/guestfs.pod:1791 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 " @@ -35902,24 +36481,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1781 +#: ../src/guestfs.pod:1796 msgid "The only defined and stable parts of the API are:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1787 +#: ../src/guestfs.pod:1802 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:1792 +#: ../src/guestfs.pod:1807 msgid "0 E<lt>= C<position> E<lt>= C<total>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1796 +#: ../src/guestfs.pod:1811 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 " @@ -35927,7 +36506,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1800 +#: ../src/guestfs.pod:1815 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 " @@ -35935,7 +36514,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1806 +#: ../src/guestfs.pod:1821 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 " @@ -35944,7 +36523,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1811 +#: ../src/guestfs.pod:1826 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 " @@ -35952,14 +36531,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1815 +#: ../src/guestfs.pod:1830 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:1820 +#: ../src/guestfs.pod:1835 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 " @@ -35968,31 +36547,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1826 +#: ../src/guestfs.pod:1841 msgid "If no callback is registered: progress messages are discarded." msgstr "" #. type: =item -#: ../src/guestfs.pod:1828 +#: ../src/guestfs.pod:1843 msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1831 +#: ../src/guestfs.pod:1846 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:1834 +#: ../src/guestfs.pod:1849 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:1837 ../src/guestfs.pod:1851 +#: ../src/guestfs.pod:1852 ../src/guestfs.pod:1866 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 " @@ -36000,62 +36579,62 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:1842 +#: ../src/guestfs.pod:1857 msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1845 +#: ../src/guestfs.pod:1860 msgid "" "The callback function is called whenever a log message is generated by the " "library part of libguestfs." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1848 +#: ../src/guestfs.pod:1863 msgid "" "If the verbose flag (L</guestfs_set_verbose>) is set then additional debug " "messages are generated." msgstr "" #. type: =item -#: ../src/guestfs.pod:1856 +#: ../src/guestfs.pod:1871 msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1859 +#: ../src/guestfs.pod:1874 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:1862 +#: ../src/guestfs.pod:1877 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:1866 +#: ../src/guestfs.pod:1881 msgid "GUESTFS_EVENT_ENTER (payload type: function name)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1869 +#: ../src/guestfs.pod:1884 msgid "The callback function is called whenever a libguestfs function is entered." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1872 +#: ../src/guestfs.pod:1887 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:1875 +#: ../src/guestfs.pod:1890 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 " @@ -36063,12 +36642,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1883 +#: ../src/guestfs.pod:1898 msgid "guestfs_set_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1885 +#: ../src/guestfs.pod:1900 #, no-wrap msgid "" " int guestfs_set_event_callback (guestfs_h *g,\n" @@ -36080,14 +36659,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1891 +#: ../src/guestfs.pod:1906 msgid "" "This function registers a callback (C<cb>) for all event classes in the " "C<event_bitmask>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1894 +#: ../src/guestfs.pod:1909 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>. " @@ -36096,40 +36675,40 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1900 +#: ../src/guestfs.pod:1915 msgid "C<flags> should always be passed as 0." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1902 +#: ../src/guestfs.pod:1917 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:1905 +#: ../src/guestfs.pod:1920 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:1908 +#: ../src/guestfs.pod:1923 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:1911 +#: ../src/guestfs.pod:1926 msgid "" "Callbacks remain in effect until they are deleted, or until the handle is " "closed." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1914 +#: ../src/guestfs.pod:1929 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 " @@ -36137,12 +36716,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1918 +#: ../src/guestfs.pod:1933 msgid "guestfs_delete_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1920 +#: ../src/guestfs.pod:1935 #, no-wrap msgid "" " void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n" @@ -36150,7 +36729,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1922 +#: ../src/guestfs.pod:1937 msgid "" "Delete a callback that was previously registered. C<event_handle> should be " "the integer that was returned by a previous call to " @@ -36158,12 +36737,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1926 +#: ../src/guestfs.pod:1941 msgid "guestfs_event_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1928 +#: ../src/guestfs.pod:1943 #, no-wrap msgid "" " typedef void (*guestfs_event_callback) (\n" @@ -36178,12 +36757,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1937 +#: ../src/guestfs.pod:1952 msgid "This is the type of the event callback function that you have to provide." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1940 +#: ../src/guestfs.pod:1955 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 " @@ -36191,7 +36770,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1944 +#: ../src/guestfs.pod:1959 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 " @@ -36200,7 +36779,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1949 +#: ../src/guestfs.pod:1964 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 " @@ -36208,19 +36787,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1953 +#: ../src/guestfs.pod:1968 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:1956 +#: ../src/guestfs.pod:1971 msgid "EXAMPLE: CAPTURING LOG MESSAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1958 +#: ../src/guestfs.pod:1973 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 " @@ -36228,7 +36807,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1962 +#: ../src/guestfs.pod:1977 msgid "" "Events associated with log messages are: C<GUESTFS_EVENT_LIBRARY>, " "C<GUESTFS_EVENT_APPLIANCE> and C<GUESTFS_EVENT_TRACE>. (Note that error " @@ -36236,14 +36815,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1967 +#: ../src/guestfs.pod:1982 msgid "" "Programs have to set up a callback to capture the classes of events of " "interest:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1970 +#: ../src/guestfs.pod:1985 #, no-wrap msgid "" " int eh =\n" @@ -36259,14 +36838,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1980 +#: ../src/guestfs.pod:1995 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:1983 +#: ../src/guestfs.pod:1998 #, no-wrap msgid "" " static void\n" @@ -36287,12 +36866,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1998 +#: ../src/guestfs.pod:2013 msgid "CANCELLING LONG TRANSFERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2000 +#: ../src/guestfs.pod:2015 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 " @@ -36301,12 +36880,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2005 +#: ../src/guestfs.pod:2020 msgid "guestfs_user_cancel" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2007 +#: ../src/guestfs.pod:2022 #, no-wrap msgid "" " void guestfs_user_cancel (guestfs_h *g);\n" @@ -36314,12 +36893,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2009 +#: ../src/guestfs.pod:2024 msgid "C<guestfs_user_cancel> cancels the current upload or download operation." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2012 +#: ../src/guestfs.pod:2027 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 " @@ -36327,7 +36906,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2016 +#: ../src/guestfs.pod:2031 msgid "" "The transfer that was in progress (if there is one) will stop shortly " "afterwards, and will return an error. The errno (see " @@ -36336,7 +36915,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2022 +#: ../src/guestfs.pod:2037 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 " @@ -36344,12 +36923,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2026 +#: ../src/guestfs.pod:2041 msgid "There are two common places that you might call C<guestfs_user_cancel>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2028 +#: ../src/guestfs.pod:2043 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 " @@ -36358,19 +36937,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2033 +#: ../src/guestfs.pod:2048 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:2037 +#: ../src/guestfs.pod:2052 msgid "PRIVATE DATA AREA" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2039 +#: ../src/guestfs.pod:2054 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 " @@ -36378,12 +36957,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2044 +#: ../src/guestfs.pod:2059 msgid "To attach a named piece of data, use the following call:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2046 +#: ../src/guestfs.pod:2061 #, no-wrap msgid "" " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n" @@ -36391,7 +36970,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2048 +#: ../src/guestfs.pod:2063 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 " @@ -36399,7 +36978,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2052 +#: ../src/guestfs.pod:2067 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 " @@ -36409,12 +36988,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2058 +#: ../src/guestfs.pod:2073 msgid "To retrieve the pointer, use:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2060 +#: ../src/guestfs.pod:2075 #, no-wrap msgid "" " void *guestfs_get_private (guestfs_h *g, const char *key);\n" @@ -36422,7 +37001,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2062 +#: ../src/guestfs.pod:2077 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 " @@ -36430,7 +37009,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2066 +#: ../src/guestfs.pod:2081 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 " @@ -36441,12 +37020,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2073 +#: ../src/guestfs.pod:2088 msgid "To walk over all entries, use these two functions:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2075 +#: ../src/guestfs.pod:2090 #, no-wrap msgid "" " void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n" @@ -36454,7 +37033,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2077 +#: ../src/guestfs.pod:2092 #, no-wrap msgid "" " void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n" @@ -36462,7 +37041,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2079 +#: ../src/guestfs.pod:2094 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 " @@ -36472,7 +37051,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2085 +#: ../src/guestfs.pod:2100 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 " @@ -36480,17 +37059,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2089 +#: ../src/guestfs.pod:2104 msgid "Notes about walking over entries:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2095 +#: ../src/guestfs.pod:2110 msgid "You must not call C<guestfs_set_private> while walking over the entries." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2100 +#: ../src/guestfs.pod:2115 msgid "" "The handle maintains an internal iterator which is reset when you call " "C<guestfs_first_private>. This internal iterator is invalidated when you " @@ -36498,12 +37077,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2106 +#: ../src/guestfs.pod:2121 msgid "If you have set the data pointer associated with a key to C<NULL>, ie:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2108 +#: ../src/guestfs.pod:2123 #, no-wrap msgid "" " guestfs_set_private (g, key, NULL);\n" @@ -36511,26 +37090,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2110 +#: ../src/guestfs.pod:2125 msgid "then that C<key> is not returned when walking." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2114 +#: ../src/guestfs.pod:2129 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:2120 +#: ../src/guestfs.pod:2135 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:2123 +#: ../src/guestfs.pod:2138 #, no-wrap msgid "" " const char *key;\n" @@ -36544,14 +37123,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2131 +#: ../src/guestfs.pod:2146 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:2134 +#: ../src/guestfs.pod:2149 #, no-wrap msgid "" " const char *key;\n" @@ -36566,7 +37145,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2143 +#: ../src/guestfs.pod:2158 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 " @@ -36574,7 +37153,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2147 +#: ../src/guestfs.pod:2162 #, no-wrap msgid "" " const char *key;\n" @@ -36596,7 +37175,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2163 +#: ../src/guestfs.pod:2178 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 " @@ -36605,12 +37184,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2168 +#: ../src/guestfs.pod:2183 msgid "SYSTEMTAP" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2170 +#: ../src/guestfs.pod:2185 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 " @@ -36618,12 +37197,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2174 +#: ../src/guestfs.pod:2189 msgid "You can list all the static markers by doing:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2176 +#: ../src/guestfs.pod:2191 #, no-wrap msgid "" " stap -l 'process(\"/usr/lib*/libguestfs.so.0\")\n" @@ -36632,26 +37211,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2179 +#: ../src/guestfs.pod:2194 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:2182 +#: ../src/guestfs.pod:2197 msgid "SYSTEMTAP SCRIPT EXAMPLE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2184 +#: ../src/guestfs.pod:2199 msgid "" "This script contains examples of displaying both the static markers and some " "ordinary C entry points:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2187 +#: ../src/guestfs.pod:2202 #, no-wrap msgid "" " global last;\n" @@ -36659,7 +37238,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2189 +#: ../src/guestfs.pod:2204 #, no-wrap msgid "" " function display_time () {\n" @@ -36672,7 +37251,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2196 +#: ../src/guestfs.pod:2211 #, no-wrap msgid "" " printf (\"%d (+%d):\", now, delta);\n" @@ -36681,7 +37260,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2199 +#: ../src/guestfs.pod:2214 #, no-wrap msgid "" " probe begin {\n" @@ -36692,7 +37271,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2204 +#: ../src/guestfs.pod:2219 #, no-wrap msgid "" " /* Display all calls to static markers. */\n" @@ -36705,7 +37284,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2211 +#: ../src/guestfs.pod:2226 #, no-wrap msgid "" " /* Display all calls to guestfs_mkfs* functions. */\n" @@ -36718,7 +37297,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2218 +#: ../src/guestfs.pod:2233 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 " @@ -36727,7 +37306,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2223 +#: ../src/guestfs.pod:2238 #, no-wrap msgid "" " # stap /tmp/test.stap\n" @@ -36736,17 +37315,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2226 +#: ../src/guestfs.pod:2241 msgid "In another terminal, run a guestfish command such as this:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2230 +#: ../src/guestfs.pod:2245 msgid "In the first terminal, stap trace output similar to this is shown:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2232 +#: ../src/guestfs.pod:2247 #, no-wrap msgid "" " 1318248056692655 (+0):\tlaunch_start\n" @@ -36760,24 +37339,24 @@ msgid "" msgstr "" #. type: =end -#: ../src/guestfs.pod:2239 ../src/guestfs.pod:2244 +#: ../src/guestfs.pod:2254 ../src/guestfs.pod:2259 msgid "html" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2241 +#: ../src/guestfs.pod:2256 msgid "" "<!-- old anchor for the next section --> <a " "name=\"state_machine_and_low_level_event_api\"/>" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2246 +#: ../src/guestfs.pod:2261 msgid "ARCHITECTURE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2248 +#: ../src/guestfs.pod:2263 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 " @@ -36785,7 +37364,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2252 +#: ../src/guestfs.pod:2267 #, no-wrap msgid "" " ___________________\n" @@ -36811,14 +37390,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2272 +#: ../src/guestfs.pod:2287 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:2275 +#: ../src/guestfs.pod:2290 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 " @@ -36830,7 +37409,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2284 +#: ../src/guestfs.pod:2299 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 " @@ -36841,17 +37420,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2291 +#: ../src/guestfs.pod:2306 msgid "STATE MACHINE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2293 +#: ../src/guestfs.pod:2308 msgid "libguestfs uses a state machine to model the child process:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2295 +#: ../src/guestfs.pod:2310 #, no-wrap msgid "" " |\n" @@ -36879,7 +37458,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2317 +#: ../src/guestfs.pod:2332 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), " @@ -36888,7 +37467,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2322 +#: ../src/guestfs.pod:2337 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 " @@ -36896,14 +37475,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2326 +#: ../src/guestfs.pod:2341 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:2329 +#: ../src/guestfs.pod:2344 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 " @@ -36912,7 +37491,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2335 +#: ../src/guestfs.pod:2350 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 " @@ -36922,7 +37501,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2341 +#: ../src/guestfs.pod:2356 msgid "" "Finally, the child process sends asynchronous messages back to the main " "program, such as kernel log messages. You can register a callback to " @@ -36930,17 +37509,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2345 +#: ../src/guestfs.pod:2360 msgid "INTERNALS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2347 +#: ../src/guestfs.pod:2362 msgid "APPLIANCE BOOT PROCESS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2349 +#: ../src/guestfs.pod:2364 msgid "" "This process has evolved and continues to evolve. The description here " "corresponds only to the current version of libguestfs and is provided for " @@ -36948,55 +37527,55 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2353 +#: ../src/guestfs.pod:2368 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:2358 +#: ../src/guestfs.pod:2373 msgid "Create the appliance" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2360 +#: ../src/guestfs.pod:2375 msgid "" "C<febootstrap-supermin-helper> is invoked to create the kernel, a small " "initrd and the appliance." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2363 +#: ../src/guestfs.pod:2378 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:2366 +#: ../src/guestfs.pod:2381 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:2370 +#: ../src/guestfs.pod:2385 msgid "Start qemu and boot the kernel" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2372 +#: ../src/guestfs.pod:2387 msgid "qemu is invoked to boot the kernel." msgstr "" #. type: =item -#: ../src/guestfs.pod:2374 +#: ../src/guestfs.pod:2389 msgid "Run the initrd" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2376 +#: ../src/guestfs.pod:2391 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 " @@ -37004,21 +37583,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2380 +#: ../src/guestfs.pod:2395 msgid "" "The initrd is a cpio archive called " "C</var/tmp/.guestfs-E<lt>UIDE<gt>/initrd>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2383 +#: ../src/guestfs.pod:2398 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:2386 +#: ../src/guestfs.pod:2401 #, no-wrap msgid "" " febootstrap: ext2 mini initrd starting up\n" @@ -37029,12 +37608,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2391 +#: ../src/guestfs.pod:2406 msgid "Find and mount the appliance device" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2393 +#: ../src/guestfs.pod:2408 msgid "" "The appliance is a sparse file containing an ext2 filesystem which contains " "a familiar (although reduced in size) Linux operating system. It would " @@ -37042,33 +37621,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2397 +#: ../src/guestfs.pod:2412 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:2400 +#: ../src/guestfs.pod:2415 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:2403 +#: ../src/guestfs.pod:2418 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:2407 +#: ../src/guestfs.pod:2422 msgid "If this works successfully you will see messages such as:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2409 +#: ../src/guestfs.pod:2424 #, no-wrap msgid "" " febootstrap: picked /sys/block/vdb/dev as root device\n" @@ -37080,19 +37659,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2415 +#: ../src/guestfs.pod:2430 msgid "" "Note that C<Starting /init script ...> indicates that the appliance's init " "script is now running." msgstr "" #. type: =item -#: ../src/guestfs.pod:2418 +#: ../src/guestfs.pod:2433 msgid "Initialize the appliance" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2420 +#: ../src/guestfs.pod:2435 msgid "" "The appliance itself now initializes itself. This involves starting certain " "processes like C<udev>, possibly printing some debug information, and " @@ -37100,19 +37679,19 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2424 +#: ../src/guestfs.pod:2439 msgid "The daemon" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2426 +#: ../src/guestfs.pod:2441 msgid "" "Finally the daemon (C<guestfsd>) runs inside the appliance. If it runs you " "should see:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2429 +#: ../src/guestfs.pod:2444 #, no-wrap msgid "" " verbose daemon enabled\n" @@ -37120,14 +37699,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2431 +#: ../src/guestfs.pod:2446 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:2434 +#: ../src/guestfs.pod:2449 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 " @@ -37135,19 +37714,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2440 +#: ../src/guestfs.pod:2455 msgid "COMMUNICATION PROTOCOL" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2442 +#: ../src/guestfs.pod:2457 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:2445 +#: ../src/guestfs.pod:2460 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 " @@ -37155,14 +37734,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2449 +#: ../src/guestfs.pod:2464 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:2452 +#: ../src/guestfs.pod:2467 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 " @@ -37172,17 +37751,17 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2459 +#: ../src/guestfs.pod:2474 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2461 +#: ../src/guestfs.pod:2476 msgid "For ordinary functions, the request message is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2463 +#: ../src/guestfs.pod:2478 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -37193,7 +37772,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2468 +#: ../src/guestfs.pod:2483 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 " @@ -37202,21 +37781,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2474 +#: ../src/guestfs.pod:2489 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:2477 +#: ../src/guestfs.pod:2492 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:2481 +#: ../src/guestfs.pod:2496 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 " @@ -37228,12 +37807,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2489 +#: ../src/guestfs.pod:2504 msgid "The reply message for ordinary functions is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2491 +#: ../src/guestfs.pod:2506 #, no-wrap msgid "" " total length (header + ret,\n" @@ -37244,26 +37823,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2496 +#: ../src/guestfs.pod:2511 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:2499 +#: ../src/guestfs.pod:2514 msgid "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2502 +#: ../src/guestfs.pod:2517 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:2505 +#: ../src/guestfs.pod:2520 #, no-wrap msgid "" " total length (header + error,\n" @@ -37274,19 +37853,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2510 +#: ../src/guestfs.pod:2525 msgid "" "The C<guestfs_message_error> structure contains the error message as a " "string." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2513 +#: ../src/guestfs.pod:2528 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2515 +#: ../src/guestfs.pod:2530 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 " @@ -37294,7 +37873,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2519 +#: ../src/guestfs.pod:2534 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -37308,12 +37887,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2527 +#: ../src/guestfs.pod:2542 msgid "The \"sequence of chunks\" is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2529 +#: ../src/guestfs.pod:2544 #, no-wrap msgid "" " length of chunk (not including length word itself)\n" @@ -37327,7 +37906,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2537 +#: ../src/guestfs.pod:2552 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 " @@ -37335,7 +37914,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2541 +#: ../src/guestfs.pod:2556 msgid "" "At time of writing there are no functions that have more than one FileIn " "parameter. However this is (theoretically) supported, by sending the " @@ -37344,7 +37923,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2546 +#: ../src/guestfs.pod:2561 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 " @@ -37353,7 +37932,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2552 +#: ../src/guestfs.pod:2567 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 " @@ -37365,7 +37944,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2561 +#: ../src/guestfs.pod:2576 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 " @@ -37375,19 +37954,19 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2567 +#: ../src/guestfs.pod:2582 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2569 +#: ../src/guestfs.pod:2584 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:2572 +#: ../src/guestfs.pod:2587 #, no-wrap msgid "" " total length (header + ret,\n" @@ -37401,12 +37980,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2580 +#: ../src/guestfs.pod:2595 msgid "INITIAL MESSAGE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2582 +#: ../src/guestfs.pod:2597 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 " @@ -37414,12 +37993,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2586 +#: ../src/guestfs.pod:2601 msgid "PROGRESS NOTIFICATION MESSAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2588 +#: ../src/guestfs.pod:2603 msgid "" "The daemon may send progress notification messages at any time. These are " "distinguished by the normal length word being replaced by " @@ -37427,7 +38006,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2592 +#: ../src/guestfs.pod:2607 msgid "" "The library turns them into progress callbacks (see " "L</GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards " @@ -37435,7 +38014,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2596 +#: ../src/guestfs.pod:2611 msgid "" "The daemon self-limits the frequency of progress messages it sends (see " "C<daemon/proto.c:notify_progress>). Not all calls generate progress " @@ -37443,12 +38022,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2600 +#: ../src/guestfs.pod:2615 msgid "LIBGUESTFS VERSION NUMBERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2602 +#: ../src/guestfs.pod:2617 msgid "" "Since April 2010, libguestfs has started to make separate development and " "stable releases, along with corresponding branches in our git repository. " @@ -37456,7 +38035,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2607 +#: ../src/guestfs.pod:2622 #, no-wrap msgid "" " even numbers for stable: 1.2.x, 1.4.x, ...\n" @@ -37473,12 +38052,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2618 +#: ../src/guestfs.pod:2633 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2620 +#: ../src/guestfs.pod:2635 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 " @@ -37488,26 +38067,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2626 +#: ../src/guestfs.pod:2641 msgid "Our criteria for backporting changes are:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2632 +#: ../src/guestfs.pod:2647 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:2638 +#: ../src/guestfs.pod:2653 msgid "" "Bug fixes which are not controversial, fix obvious problems, and have been " "well tested are backported." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2643 +#: ../src/guestfs.pod:2658 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 " @@ -37515,7 +38094,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2649 +#: ../src/guestfs.pod:2664 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 " @@ -37523,7 +38102,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2655 +#: ../src/guestfs.pod:2670 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 " @@ -37534,17 +38113,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2663 +#: ../src/guestfs.pod:2678 msgid "EXTENDING LIBGUESTFS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2665 +#: ../src/guestfs.pod:2680 msgid "ADDING A NEW API ACTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2667 +#: ../src/guestfs.pod:2682 msgid "" "Large amounts of boilerplate code in libguestfs (RPC, bindings, " "documentation) are generated, and this makes it easy to extend the " @@ -37552,19 +38131,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2671 +#: ../src/guestfs.pod:2686 msgid "To add a new API action there are two changes:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2677 +#: ../src/guestfs.pod:2692 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:2680 +#: ../src/guestfs.pod:2695 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 " @@ -37575,7 +38154,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2688 +#: ../src/guestfs.pod:2703 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 " @@ -37585,7 +38164,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2694 +#: ../src/guestfs.pod:2709 msgid "" "For library-only actions of the second type, add to the " "C<non_daemon_functions> list. Since these functions are serviced by the " @@ -37595,36 +38174,36 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2702 +#: ../src/guestfs.pod:2717 msgid "Implement the action (in C):" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2704 +#: ../src/guestfs.pod:2719 msgid "" "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the " "C<daemon/> directory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2707 +#: ../src/guestfs.pod:2722 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:2710 +#: ../src/guestfs.pod:2725 msgid "In either case, use another function as an example of what to do." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2714 +#: ../src/guestfs.pod:2729 msgid "After making these changes, use C<make> to compile." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2716 +#: ../src/guestfs.pod:2731 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 " @@ -37632,12 +38211,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2720 +#: ../src/guestfs.pod:2735 msgid "ADDING TESTS FOR AN API ACTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2722 +#: ../src/guestfs.pod:2737 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 " @@ -37647,61 +38226,61 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2728 +#: ../src/guestfs.pod:2743 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:2731 +#: ../src/guestfs.pod:2746 msgid "The test environment has 4 block devices:" msgstr "" #. type: =item -#: ../src/guestfs.pod:2735 +#: ../src/guestfs.pod:2750 msgid "C</dev/sda> 500MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2737 +#: ../src/guestfs.pod:2752 msgid "General block device for testing." msgstr "" #. type: =item -#: ../src/guestfs.pod:2739 +#: ../src/guestfs.pod:2754 msgid "C</dev/sdb> 50MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2741 +#: ../src/guestfs.pod:2756 msgid "" "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write " "operations." msgstr "" #. type: =item -#: ../src/guestfs.pod:2744 +#: ../src/guestfs.pod:2759 msgid "C</dev/sdc> 10MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2746 +#: ../src/guestfs.pod:2761 msgid "Used in a few tests where two block devices are needed." msgstr "" #. type: =item -#: ../src/guestfs.pod:2748 +#: ../src/guestfs.pod:2763 msgid "C</dev/sdd>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2750 +#: ../src/guestfs.pod:2765 msgid "ISO with fixed content (see C<images/test.iso>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2754 +#: ../src/guestfs.pod:2769 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 " @@ -37709,7 +38288,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2758 +#: ../src/guestfs.pod:2773 msgid "" "Each test starts with an initial scenario, selected using one of the " "C<Init*> expressions, described in C<generator/generator_types.ml>. These " @@ -37719,7 +38298,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2764 +#: ../src/guestfs.pod:2779 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 " @@ -37729,14 +38308,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2770 +#: ../src/guestfs.pod:2785 msgid "" "In addition, packagers can skip individual tests by setting environment " "variables before running C<make check>." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2773 +#: ../src/guestfs.pod:2788 #, no-wrap msgid "" " SKIP_TEST_<CMD>_<NUM>=1\n" @@ -37744,17 +38323,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2775 +#: ../src/guestfs.pod:2790 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2777 +#: ../src/guestfs.pod:2792 msgid "or:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2779 +#: ../src/guestfs.pod:2794 #, no-wrap msgid "" " SKIP_TEST_<CMD>=1\n" @@ -37762,17 +38341,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2781 +#: ../src/guestfs.pod:2796 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2783 +#: ../src/guestfs.pod:2798 msgid "Packagers can run only certain tests by setting for example:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2785 +#: ../src/guestfs.pod:2800 #, no-wrap msgid "" " TEST_ONLY=\"vfs_type zerofree\"\n" @@ -37780,29 +38359,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2787 +#: ../src/guestfs.pod:2802 msgid "" "See C<capitests/tests.c> for more details of how these environment variables " "work." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2790 +#: ../src/guestfs.pod:2805 msgid "DEBUGGING NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2792 +#: ../src/guestfs.pod:2807 msgid "Test new actions work before submitting them." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2794 +#: ../src/guestfs.pod:2809 msgid "You can use guestfish to try out new commands." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2796 +#: ../src/guestfs.pod:2811 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 " @@ -37810,12 +38389,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2800 +#: ../src/guestfs.pod:2815 msgid "FORMATTING CODE AND OTHER CONVENTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2802 +#: ../src/guestfs.pod:2817 msgid "" "Our C source code generally adheres to some basic code-formatting " "conventions. The existing code base is not totally consistent on this " @@ -37825,14 +38404,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2808 +#: ../src/guestfs.pod:2823 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:2811 +#: ../src/guestfs.pod:2826 #, no-wrap msgid "" " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n" @@ -37848,7 +38427,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2821 +#: ../src/guestfs.pod:2836 #, no-wrap msgid "" " ;;; When editing C sources in libguestfs, use this style.\n" @@ -37866,12 +38445,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2833 +#: ../src/guestfs.pod:2848 msgid "Enable warnings when compiling (and fix any problems this finds):" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2836 +#: ../src/guestfs.pod:2851 #, no-wrap msgid "" " ./configure --enable-gcc-warnings\n" @@ -37879,12 +38458,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2838 +#: ../src/guestfs.pod:2853 msgid "Useful targets are:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2840 +#: ../src/guestfs.pod:2855 #, no-wrap msgid "" " make syntax-check # checks the syntax of the C code\n" @@ -37893,43 +38472,43 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2843 +#: ../src/guestfs.pod:2858 msgid "DAEMON CUSTOM PRINTF FORMATTERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2845 +#: ../src/guestfs.pod:2860 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:2850 +#: ../src/guestfs.pod:2865 msgid "%Q" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2852 +#: ../src/guestfs.pod:2867 msgid "" "Simple shell quoted string. Any spaces or other shell characters are " "escaped for you." msgstr "" #. type: =item -#: ../src/guestfs.pod:2855 +#: ../src/guestfs.pod:2870 msgid "%R" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2857 +#: ../src/guestfs.pod:2872 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:2864 +#: ../src/guestfs.pod:2879 #, no-wrap msgid "" " asprintf (&cmd, \"cat %R\", path);\n" @@ -37937,12 +38516,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2866 +#: ../src/guestfs.pod:2881 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2868 +#: ../src/guestfs.pod:2883 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 " @@ -37951,12 +38530,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2874 +#: ../src/guestfs.pod:2889 msgid "SUBMITTING YOUR NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2876 +#: ../src/guestfs.pod:2891 msgid "" "Submit patches to the mailing list: " "L<http://www.redhat.com/mailman/listinfo/libguestfs> and CC to " @@ -37964,17 +38543,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2880 +#: ../src/guestfs.pod:2895 msgid "INTERNATIONALIZATION (I18N) SUPPORT" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2882 +#: ../src/guestfs.pod:2897 msgid "We support i18n (gettext anyhow) in the library." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2884 +#: ../src/guestfs.pod:2899 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 " @@ -37983,137 +38562,137 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2890 +#: ../src/guestfs.pod:2905 msgid "" "Debugging messages are never translated, since they are intended for the " "programmers." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2893 +#: ../src/guestfs.pod:2908 msgid "SOURCE CODE SUBDIRECTORIES" msgstr "" #. type: =item -#: ../src/guestfs.pod:2897 +#: ../src/guestfs.pod:2912 msgid "C<align>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2899 +#: ../src/guestfs.pod:2914 msgid "L<virt-alignment-scan(1)> command and documentation." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2903 +#: ../src/guestfs.pod:2918 msgid "The libguestfs appliance, build scripts and so on." msgstr "" #. type: =item -#: ../src/guestfs.pod:2905 +#: ../src/guestfs.pod:2920 msgid "C<capitests>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2907 +#: ../src/guestfs.pod:2922 msgid "Automated tests of the C API." msgstr "" #. type: =item -#: ../src/guestfs.pod:2909 +#: ../src/guestfs.pod:2924 msgid "C<cat>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2911 +#: ../src/guestfs.pod:2926 msgid "" "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and " "documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2914 +#: ../src/guestfs.pod:2929 msgid "C<caution>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2916 +#: ../src/guestfs.pod:2931 msgid "" "Safety and liveness tests of components that libguestfs depends upon (not of " "libguestfs itself). Mainly this is for qemu and the kernel." msgstr "" #. type: =item -#: ../src/guestfs.pod:2919 +#: ../src/guestfs.pod:2934 msgid "C<clone>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2921 +#: ../src/guestfs.pod:2936 msgid "" "Tools for cloning virtual machines. Currently contains L<virt-sysprep(1)> " "command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2924 +#: ../src/guestfs.pod:2939 msgid "C<contrib>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2926 +#: ../src/guestfs.pod:2941 msgid "Outside contributions, experimental parts." msgstr "" #. type: =item -#: ../src/guestfs.pod:2928 +#: ../src/guestfs.pod:2943 msgid "C<daemon>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2930 +#: ../src/guestfs.pod:2945 msgid "" "The daemon that runs inside the libguestfs appliance and carries out " "actions." msgstr "" #. type: =item -#: ../src/guestfs.pod:2933 +#: ../src/guestfs.pod:2948 msgid "C<df>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2935 +#: ../src/guestfs.pod:2950 msgid "L<virt-df(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2937 +#: ../src/guestfs.pod:2952 msgid "C<edit>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2939 +#: ../src/guestfs.pod:2954 msgid "L<virt-edit(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2941 +#: ../src/guestfs.pod:2956 msgid "C<examples>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2943 +#: ../src/guestfs.pod:2958 msgid "C API example code." msgstr "" #. type: =item -#: ../src/guestfs.pod:2945 +#: ../src/guestfs.pod:2960 msgid "C<fish>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2947 +#: ../src/guestfs.pod:2962 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)>, " @@ -38121,89 +38700,89 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2951 +#: ../src/guestfs.pod:2966 msgid "C<fuse>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2953 +#: ../src/guestfs.pod:2968 msgid "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:2955 +#: ../src/guestfs.pod:2970 msgid "C<generator>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2957 +#: ../src/guestfs.pod:2972 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:2960 +#: ../src/guestfs.pod:2975 msgid "C<images>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2962 +#: ../src/guestfs.pod:2977 msgid "Files used by the test suite." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2964 +#: ../src/guestfs.pod:2979 msgid "Some \"phony\" guest images which we test against." msgstr "" #. type: =item -#: ../src/guestfs.pod:2966 +#: ../src/guestfs.pod:2981 msgid "C<inspector>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2968 +#: ../src/guestfs.pod:2983 msgid "L<virt-inspector(1)>, the virtual machine image inspector." msgstr "" #. type: =item -#: ../src/guestfs.pod:2970 +#: ../src/guestfs.pod:2985 msgid "C<logo>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2972 +#: ../src/guestfs.pod:2987 msgid "Logo used on the website. The fish is called Arthur by the way." msgstr "" #. type: =item -#: ../src/guestfs.pod:2974 +#: ../src/guestfs.pod:2989 msgid "C<m4>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2976 +#: ../src/guestfs.pod:2991 msgid "M4 macros used by autoconf." msgstr "" #. type: =item -#: ../src/guestfs.pod:2978 +#: ../src/guestfs.pod:2993 msgid "C<po>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2980 +#: ../src/guestfs.pod:2995 msgid "Translations of simple gettext strings." msgstr "" #. type: =item -#: ../src/guestfs.pod:2982 +#: ../src/guestfs.pod:2997 msgid "C<po-docs>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2984 +#: ../src/guestfs.pod:2999 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 " @@ -38211,134 +38790,134 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2988 +#: ../src/guestfs.pod:3003 msgid "C<regressions>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2990 +#: ../src/guestfs.pod:3005 msgid "Regression tests." msgstr "" #. type: =item -#: ../src/guestfs.pod:2992 +#: ../src/guestfs.pod:3007 msgid "C<rescue>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2994 +#: ../src/guestfs.pod:3009 msgid "L<virt-rescue(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2996 +#: ../src/guestfs.pod:3011 msgid "C<resize>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2998 +#: ../src/guestfs.pod:3013 msgid "L<virt-resize(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3000 +#: ../src/guestfs.pod:3015 msgid "C<sparsify>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3002 +#: ../src/guestfs.pod:3017 msgid "L<virt-sparsify(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:3004 +#: ../src/guestfs.pod:3019 msgid "C<src>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3006 +#: ../src/guestfs.pod:3021 msgid "Source code to the C library." msgstr "" #. type: =item -#: ../src/guestfs.pod:3008 +#: ../src/guestfs.pod:3023 msgid "C<tools>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3010 +#: ../src/guestfs.pod:3025 msgid "Command line tools written in Perl (L<virt-win-reg(1)> and many others)." msgstr "" #. type: =item -#: ../src/guestfs.pod:3012 +#: ../src/guestfs.pod:3027 msgid "C<test-tool>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3014 +#: ../src/guestfs.pod:3029 msgid "" "Test tool for end users to test if their qemu/kernel combination will work " "with libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:3017 +#: ../src/guestfs.pod:3032 msgid "C<csharp>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3019 +#: ../src/guestfs.pod:3034 msgid "C<erlang>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3021 +#: ../src/guestfs.pod:3036 msgid "C<haskell>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3023 +#: ../src/guestfs.pod:3038 msgid "C<java>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3025 +#: ../src/guestfs.pod:3040 msgid "C<ocaml>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3027 +#: ../src/guestfs.pod:3042 msgid "C<php>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3029 +#: ../src/guestfs.pod:3044 msgid "C<perl>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3031 +#: ../src/guestfs.pod:3046 msgid "C<python>" msgstr "" #. type: =item -#: ../src/guestfs.pod:3033 +#: ../src/guestfs.pod:3048 msgid "C<ruby>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3035 +#: ../src/guestfs.pod:3050 msgid "Language bindings." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3039 +#: ../src/guestfs.pod:3054 msgid "MAKING A STABLE RELEASE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3041 +#: ../src/guestfs.pod:3056 msgid "" "When we make a stable release, there are several steps documented here. See " "L</LIBGUESTFS VERSION NUMBERS> for general information about the stable " @@ -38346,37 +38925,37 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3049 +#: ../src/guestfs.pod:3064 msgid "Check C<make && make check> works on at least Fedora, Debian and Ubuntu." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3054 +#: ../src/guestfs.pod:3069 msgid "Finalize RELEASE-NOTES." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3058 +#: ../src/guestfs.pod:3073 msgid "Update ROADMAP." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3062 +#: ../src/guestfs.pod:3077 msgid "Run C<src/api-support/update-from-tarballs.sh>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3066 +#: ../src/guestfs.pod:3081 msgid "Push and pull from Transifex." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3068 +#: ../src/guestfs.pod:3083 msgid "Run:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3070 +#: ../src/guestfs.pod:3085 #, no-wrap msgid "" " tx push -s\n" @@ -38384,12 +38963,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3072 +#: ../src/guestfs.pod:3087 msgid "to push the latest POT files to Transifex. Then run:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3074 +#: ../src/guestfs.pod:3089 #, no-wrap msgid "" " ./tx-pull.sh\n" @@ -38397,24 +38976,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3076 +#: ../src/guestfs.pod:3091 msgid "which is a wrapper to pull the latest translated C<*.po> files." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3080 +#: ../src/guestfs.pod:3095 msgid "" "Create new stable and development directories under " "L<http://libguestfs.org/download>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3085 +#: ../src/guestfs.pod:3100 msgid "Create the branch in git:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:3087 +#: ../src/guestfs.pod:3102 #, no-wrap msgid "" " git tag -a 1.XX.0 -m \"Version 1.XX.0 (stable)\"\n" @@ -38425,17 +39004,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:3094 +#: ../src/guestfs.pod:3109 msgid "LIMITS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3096 +#: ../src/guestfs.pod:3111 msgid "PROTOCOL LIMITS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3098 +#: ../src/guestfs.pod:3113 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 " @@ -38446,7 +39025,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3106 +#: ../src/guestfs.pod:3121 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 " @@ -38455,7 +39034,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3112 +#: ../src/guestfs.pod:3127 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> " @@ -38463,24 +39042,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3116 +#: ../src/guestfs.pod:3131 msgid "" "You might also consider mounting the disk image using our FUSE filesystem " "support (L<guestmount(1)>)." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3119 +#: ../src/guestfs.pod:3134 msgid "MAXIMUM NUMBER OF DISKS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3121 +#: ../src/guestfs.pod:3136 msgid "When using virtio disks (the default) the current limit is B<25> disks." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3124 +#: ../src/guestfs.pod:3139 msgid "" "Virtio itself consumes 1 virtual PCI slot per disk, and PCI is limited to 31 " "slots. However febootstrap only understands disks with names C</dev/vda> " @@ -38489,14 +39068,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3129 +#: ../src/guestfs.pod:3144 msgid "" "We are working to substantially raise this limit in future versions but it " "requires complex changes to qemu." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3132 +#: ../src/guestfs.pod:3147 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 " @@ -38504,41 +39083,41 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3136 +#: ../src/guestfs.pod:3151 msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3138 +#: ../src/guestfs.pod:3153 msgid "Virtio limits the maximum number of partitions per disk to B<15>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3140 +#: ../src/guestfs.pod:3155 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:3143 +#: ../src/guestfs.pod:3158 msgid "" "If you attach a disk with more than 15 partitions, the extra partitions are " "ignored by libguestfs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3146 +#: ../src/guestfs.pod:3161 msgid "MAXIMUM SIZE OF A DISK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3148 +#: ../src/guestfs.pod:3163 msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3150 +#: ../src/guestfs.pod:3165 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 " @@ -38546,7 +39125,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3154 +#: ../src/guestfs.pod:3169 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 " @@ -38556,19 +39135,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3160 +#: ../src/guestfs.pod:3175 msgid "" "For the hugest disk image files, we recommend using XFS on the host for " "storage." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3163 +#: ../src/guestfs.pod:3178 msgid "MAXIMUM SIZE OF A PARTITION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3165 +#: ../src/guestfs.pod:3180 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 " @@ -38576,7 +39155,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3169 +#: ../src/guestfs.pod:3184 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 " @@ -38584,12 +39163,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3174 +#: ../src/guestfs.pod:3189 msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3176 +#: ../src/guestfs.pod:3191 msgid "" "This depends on the filesystem type. libguestfs itself does not impose any " "known limit. Consult Wikipedia or the filesystem documentation to find out " @@ -38597,12 +39176,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3180 +#: ../src/guestfs.pod:3195 msgid "MAXIMUM UPLOAD AND DOWNLOAD" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3182 +#: ../src/guestfs.pod:3197 msgid "" "The API functions L</guestfs_upload>, L</guestfs_download>, " "L</guestfs_tar_in>, L</guestfs_tar_out> and the like allow unlimited sized " @@ -38610,12 +39189,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:3186 +#: ../src/guestfs.pod:3201 msgid "INSPECTION LIMITS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3188 +#: ../src/guestfs.pod:3203 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 " @@ -38625,33 +39204,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3214 +#: ../src/guestfs.pod:3229 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:3226 +#: ../src/guestfs.pod:3241 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:3235 +#: ../src/guestfs.pod:3250 msgid "See also L</QEMU WRAPPERS> above." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3239 +#: ../src/guestfs.pod:3254 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:3257 +#: ../src/guestfs.pod:3272 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)>, " @@ -38668,59 +39247,59 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3293 +#: ../src/guestfs.pod:3308 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:3300 ../tools/virt-make-fs.pl:571 ../tools/virt-win-reg.pl:772 +#: ../src/guestfs.pod:3315 ../tools/virt-make-fs.pl:571 ../tools/virt-win-reg.pl:772 msgid "BUGS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3302 +#: ../src/guestfs.pod:3317 msgid "To get a list of bugs against libguestfs use this link:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3304 +#: ../src/guestfs.pod:3319 msgid "L<https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3306 +#: ../src/guestfs.pod:3321 msgid "To report a new bug against libguestfs use this link:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3308 +#: ../src/guestfs.pod:3323 msgid "L<https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3310 +#: ../src/guestfs.pod:3325 msgid "When reporting a bug, please check:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3316 +#: ../src/guestfs.pod:3331 msgid "That the bug hasn't been reported already." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3320 +#: ../src/guestfs.pod:3335 msgid "That you are testing a recent version." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3324 +#: ../src/guestfs.pod:3339 msgid "Describe the bug accurately, and give a way to reproduce it." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3328 +#: ../src/guestfs.pod:3343 msgid "" "Run libguestfs-test-tool and paste the B<complete, unedited> output into the " "bug report." |