X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=po-docs%2Fja.po;h=5e951f35d22de51942541ef871e4a5e51cbe8c33;hp=97787d7eb4c9f6462f7868bb1ced7f0bdef731cb;hb=ece902712bcd54e0cd28b57352c6a4efcf26c4f6;hpb=639232f2b0e2b6d537c8947ee51837d5509b1339 diff --git a/po-docs/ja.po b/po-docs/ja.po index 97787d7..5e951f3 100644 --- a/po-docs/ja.po +++ b/po-docs/ja.po @@ -9,8 +9,8 @@ msgid "" msgstr "" "Project-Id-Version: libguestfs\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2011-10-24 17:16+0200\n" -"PO-Revision-Date: 2011-10-19 15:46+0000\n" +"POT-Creation-Date: 2011-11-29 21:47+0000\n" +"PO-Revision-Date: 2011-10-27 09:15+0000\n" "Last-Translator: rjones \n" "Language-Team: Japanese \n" "Language: ja\n" @@ -24,15 +24,16 @@ msgstr "" #: ../cat/virt-filesystems.pod:3 ../cat/virt-ls.pod:3 #: ../clone/virt-sysprep.pod:3 ../df/virt-df.pod:3 ../edit/virt-edit.pod:3 #: ../erlang/examples/guestfs-erlang.pod:3 ../examples/guestfs-examples.pod:3 -#: ../examples/guestfs-recipes.pod:14 ../fish/guestfish.pod:3 -#: ../fish/virt-copy-in.pod:3 ../fish/virt-copy-out.pod:3 -#: ../fish/virt-tar-in.pod:3 ../fish/virt-tar-out.pod:3 -#: ../fuse/guestmount.pod:3 ../inspector/virt-inspector.pod:3 -#: ../java/examples/guestfs-java.pod:3 ../ocaml/examples/guestfs-ocaml.pod:3 -#: ../perl/examples/guestfs-perl.pod:3 ../python/examples/guestfs-python.pod:3 -#: ../rescue/virt-rescue.pod:3 ../resize/virt-resize.pod:3 -#: ../ruby/examples/guestfs-ruby.pod:3 ../sparsify/virt-sparsify.pod:3 -#: ../src/guestfs.pod:3 ../test-tool/libguestfs-test-tool.pod:3 +#: ../examples/guestfs-recipes.pod:14 ../examples/guestfs-testing.pod:3 +#: ../fish/guestfish.pod:3 ../fish/virt-copy-in.pod:3 +#: ../fish/virt-copy-out.pod:3 ../fish/virt-tar-in.pod:3 +#: ../fish/virt-tar-out.pod:3 ../fuse/guestmount.pod:3 +#: ../inspector/virt-inspector.pod:3 ../java/examples/guestfs-java.pod:3 +#: ../ocaml/examples/guestfs-ocaml.pod:3 ../perl/examples/guestfs-perl.pod:3 +#: ../python/examples/guestfs-python.pod:3 ../rescue/virt-rescue.pod:3 +#: ../resize/virt-resize.pod:3 ../ruby/examples/guestfs-ruby.pod:3 +#: ../sparsify/virt-sparsify.pod:3 ../src/guestfs.pod:3 +#: ../test-tool/libguestfs-test-tool.pod:3 #: ../tools/virt-list-filesystems.pl:30 ../tools/virt-list-partitions.pl:30 #: ../tools/virt-make-fs.pl:35 ../tools/virt-tar.pl:31 #: ../tools/virt-win-reg.pl:35 @@ -86,12 +87,13 @@ msgstr "" #: ../clone/virt-sysprep.pod:13 ../df/virt-df.pod:21 ../edit/virt-edit.pod:27 #: ../erlang/examples/guestfs-erlang.pod:16 #: ../examples/guestfs-examples.pod:19 ../examples/guestfs-recipes.pod:18 -#: ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19 -#: ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21 -#: ../fish/virt-tar-out.pod:15 ../fuse/guestmount.pod:20 -#: ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15 -#: ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:18 -#: ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:29 +#: ../examples/guestfs-testing.pod:7 ../fish/guestfish.pod:30 +#: ../fish/virt-copy-in.pod:19 ../fish/virt-copy-out.pod:13 +#: ../fish/virt-tar-in.pod:21 ../fish/virt-tar-out.pod:15 +#: ../fuse/guestmount.pod:20 ../inspector/virt-inspector.pod:19 +#: ../java/examples/guestfs-java.pod:15 ../ocaml/examples/guestfs-ocaml.pod:25 +#: ../perl/examples/guestfs-perl.pod:18 +#: ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:31 #: ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15 #: ../sparsify/virt-sparsify.pod:11 ../src/guestfs.pod:23 #: ../test-tool/libguestfs-test-tool.pod:11 @@ -266,8 +268,8 @@ msgstr "" #: ../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 +#: ../inspector/virt-inspector.pod:55 ../rescue/virt-rescue.pod:112 +#: ../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 @@ -280,8 +282,8 @@ msgstr "" #: ../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 +#: ../inspector/virt-inspector.pod:59 ../rescue/virt-rescue.pod:116 +#: ../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 @@ -293,7 +295,7 @@ msgstr "" #: ../align/virt-alignment-scan.pod:95 ../cat/virt-cat.pod:68 #: ../cat/virt-filesystems.pod:97 ../cat/virt-ls.pod:267 #: ../clone/virt-sysprep.pod:48 ../df/virt-df.pod:65 ../edit/virt-edit.pod:68 -#: ../inspector/virt-inspector.pod:61 ../rescue/virt-rescue.pod:90 +#: ../inspector/virt-inspector.pod:61 ../rescue/virt-rescue.pod:118 #: ../tools/virt-list-filesystems.pl:63 ../tools/virt-list-partitions.pl:64 #: ../tools/virt-make-fs.pl:163 ../tools/virt-tar.pl:113 #: ../tools/virt-win-reg.pl:106 @@ -304,7 +306,7 @@ msgstr "" #: ../align/virt-alignment-scan.pod:97 ../cat/virt-cat.pod:70 #: ../cat/virt-filesystems.pod:99 ../cat/virt-ls.pod:269 #: ../clone/virt-sysprep.pod:50 ../df/virt-df.pod:67 ../edit/virt-edit.pod:70 -#: ../inspector/virt-inspector.pod:63 ../rescue/virt-rescue.pod:92 +#: ../inspector/virt-inspector.pod:63 ../rescue/virt-rescue.pod:120 msgid "B<-a> file" msgstr "" @@ -312,7 +314,7 @@ msgstr "" #: ../align/virt-alignment-scan.pod:99 ../cat/virt-cat.pod:72 #: ../cat/virt-filesystems.pod:101 ../cat/virt-ls.pod:271 #: ../clone/virt-sysprep.pod:52 ../df/virt-df.pod:69 ../edit/virt-edit.pod:72 -#: ../inspector/virt-inspector.pod:65 ../rescue/virt-rescue.pod:94 +#: ../inspector/virt-inspector.pod:65 ../rescue/virt-rescue.pod:122 msgid "B<--add> file" msgstr "" @@ -326,7 +328,7 @@ msgstr "" #: ../cat/virt-filesystems.pod:107 ../cat/virt-ls.pod:277 #: ../clone/virt-sysprep.pod:56 ../df/virt-df.pod:75 ../edit/virt-edit.pod:78 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:102 -#: ../inspector/virt-inspector.pod:71 ../rescue/virt-rescue.pod:100 +#: ../inspector/virt-inspector.pod:71 ../rescue/virt-rescue.pod:128 msgid "" "The format of the disk image is auto-detected. To override this and force a " "particular format use the I<--format=..> option." @@ -336,7 +338,7 @@ msgstr "" #: ../align/virt-alignment-scan.pod:106 ../cat/virt-cat.pod:81 #: ../cat/virt-filesystems.pod:125 ../cat/virt-ls.pod:291 #: ../clone/virt-sysprep.pod:59 ../df/virt-df.pod:78 -#: ../rescue/virt-rescue.pod:107 +#: ../rescue/virt-rescue.pod:135 msgid "B<-c> URI" msgstr "" @@ -344,7 +346,7 @@ msgstr "" #: ../align/virt-alignment-scan.pod:108 ../cat/virt-cat.pod:83 #: ../cat/virt-filesystems.pod:127 ../cat/virt-ls.pod:293 #: ../clone/virt-sysprep.pod:61 ../df/virt-df.pod:80 -#: ../rescue/virt-rescue.pod:109 +#: ../rescue/virt-rescue.pod:137 msgid "B<--connect> URI" msgstr "" @@ -352,7 +354,7 @@ msgstr "" #: ../align/virt-alignment-scan.pod:110 ../cat/virt-cat.pod:85 #: ../cat/virt-filesystems.pod:129 ../cat/virt-ls.pod:295 #: ../clone/virt-sysprep.pod:63 ../df/virt-df.pod:82 ../edit/virt-edit.pod:99 -#: ../inspector/virt-inspector.pod:78 ../rescue/virt-rescue.pod:111 +#: ../inspector/virt-inspector.pod:78 ../rescue/virt-rescue.pod:139 #: ../tools/virt-list-filesystems.pl:81 ../tools/virt-list-partitions.pl:82 #: ../tools/virt-tar.pl:131 ../tools/virt-win-reg.pl:132 msgid "" @@ -364,7 +366,7 @@ msgstr "" #: ../align/virt-alignment-scan.pod:113 ../cat/virt-cat.pod:88 #: ../cat/virt-filesystems.pod:132 ../cat/virt-ls.pod:298 #: ../clone/virt-sysprep.pod:66 ../df/virt-df.pod:85 -#: ../rescue/virt-rescue.pod:114 +#: ../rescue/virt-rescue.pod:142 msgid "" "If you specify guest block devices directly (I<-a>), then libvirt is not " "used at all." @@ -374,7 +376,7 @@ msgstr "" #: ../align/virt-alignment-scan.pod:116 ../cat/virt-cat.pod:91 #: ../cat/virt-filesystems.pod:141 ../cat/virt-ls.pod:307 #: ../clone/virt-sysprep.pod:69 ../df/virt-df.pod:94 ../edit/virt-edit.pod:105 -#: ../inspector/virt-inspector.pod:85 ../rescue/virt-rescue.pod:117 +#: ../inspector/virt-inspector.pod:85 ../rescue/virt-rescue.pod:145 msgid "B<-d> guest" msgstr "" @@ -382,7 +384,7 @@ msgstr "" #: ../align/virt-alignment-scan.pod:118 ../cat/virt-cat.pod:93 #: ../cat/virt-filesystems.pod:143 ../cat/virt-ls.pod:309 #: ../clone/virt-sysprep.pod:71 ../df/virt-df.pod:96 ../edit/virt-edit.pod:107 -#: ../inspector/virt-inspector.pod:87 ../rescue/virt-rescue.pod:119 +#: ../inspector/virt-inspector.pod:87 ../rescue/virt-rescue.pod:147 msgid "B<--domain> guest" msgstr "" @@ -390,7 +392,7 @@ msgstr "" #: ../align/virt-alignment-scan.pod:120 ../cat/virt-cat.pod:95 #: ../cat/virt-filesystems.pod:145 ../cat/virt-ls.pod:311 #: ../clone/virt-sysprep.pod:73 ../df/virt-df.pod:98 ../edit/virt-edit.pod:109 -#: ../inspector/virt-inspector.pod:89 ../rescue/virt-rescue.pod:121 +#: ../inspector/virt-inspector.pod:89 ../rescue/virt-rescue.pod:149 msgid "" "Add all the disks from the named libvirt guest. Domain UUIDs can be used " "instead of names." @@ -401,7 +403,7 @@ msgstr "" #: ../cat/virt-filesystems.pod:170 ../cat/virt-ls.pod:328 #: ../clone/virt-sysprep.pod:95 ../df/virt-df.pod:101 #: ../fish/guestfish.pod:233 ../fuse/guestmount.pod:142 -#: ../inspector/virt-inspector.pod:99 ../rescue/virt-rescue.pod:124 +#: ../inspector/virt-inspector.pod:99 ../rescue/virt-rescue.pod:152 msgid "B<--format=raw|qcow2|..>" msgstr "" @@ -411,7 +413,7 @@ msgstr "" #: ../clone/virt-sysprep.pod:97 ../df/virt-df.pod:103 #: ../edit/virt-edit.pod:134 ../fish/guestfish.pod:235 #: ../fuse/guestmount.pod:144 ../inspector/virt-inspector.pod:101 -#: ../rescue/virt-rescue.pod:126 +#: ../rescue/virt-rescue.pod:154 msgid "B<--format>" msgstr "" @@ -420,7 +422,7 @@ msgstr "" #: ../cat/virt-filesystems.pod:174 ../cat/virt-ls.pod:332 #: ../clone/virt-sysprep.pod:99 ../df/virt-df.pod:105 #: ../edit/virt-edit.pod:136 ../fish/guestfish.pod:237 -#: ../fuse/guestmount.pod:146 ../rescue/virt-rescue.pod:128 +#: ../fuse/guestmount.pod:146 ../rescue/virt-rescue.pod:156 msgid "" "The default for the I<-a> option is to auto-detect the format of the disk " "image. Using this forces the disk format for I<-a> options which follow on " @@ -433,8 +435,8 @@ msgstr "" #: ../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 +#: ../fish/guestfish.pod:673 ../inspector/virt-inspector.pod:351 +#: ../rescue/virt-rescue.pod:161 ../src/guestfs.pod:2877 msgid "For example:" msgstr "" @@ -451,7 +453,7 @@ msgstr "" #: ../cat/virt-filesystems.pod:183 ../cat/virt-ls.pod:341 #: ../clone/virt-sysprep.pod:108 ../df/virt-df.pod:114 #: ../edit/virt-edit.pod:145 ../fish/guestfish.pod:246 -#: ../rescue/virt-rescue.pod:137 +#: ../rescue/virt-rescue.pod:165 msgid "forces raw format (no auto-detection) for C." msgstr "" @@ -468,7 +470,7 @@ msgstr "" #: ../cat/virt-filesystems.pod:187 ../cat/virt-ls.pod:345 #: ../clone/virt-sysprep.pod:112 ../df/virt-df.pod:118 #: ../edit/virt-edit.pod:149 ../fish/guestfish.pod:250 -#: ../rescue/virt-rescue.pod:141 +#: ../rescue/virt-rescue.pod:169 msgid "" "forces raw format (no auto-detection) for C and reverts to auto-" "detection for C." @@ -478,7 +480,7 @@ msgstr "" #: ../align/virt-alignment-scan.pod:143 ../cat/virt-cat.pod:125 #: ../cat/virt-filesystems.pod:190 ../cat/virt-ls.pod:348 #: ../clone/virt-sysprep.pod:115 ../df/virt-df.pod:121 -#: ../edit/virt-edit.pod:152 ../rescue/virt-rescue.pod:144 +#: ../edit/virt-edit.pod:152 ../rescue/virt-rescue.pod:172 msgid "" "If you have untrusted raw-format guest disk images, you should use this " "option to specify the disk format. This avoids a possible security problem " @@ -486,14 +488,14 @@ 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:497 +#: ../sparsify/virt-sparsify.pod:177 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:499 +#: ../sparsify/virt-sparsify.pod:179 msgid "B<--quiet>" msgstr "" @@ -510,7 +512,7 @@ msgstr "" #: ../clone/virt-sysprep.pod:138 ../df/virt-df.pod:173 #: ../edit/virt-edit.pod:161 ../fish/guestfish.pod:390 #: ../fuse/guestmount.pod:266 ../inspector/virt-inspector.pod:119 -#: ../rescue/virt-rescue.pod:182 ../sparsify/virt-sparsify.pod:159 +#: ../rescue/virt-rescue.pod:219 ../sparsify/virt-sparsify.pod:183 msgid "B<-v>" msgstr "" @@ -520,7 +522,7 @@ msgstr "" #: ../clone/virt-sysprep.pod:140 ../df/virt-df.pod:175 #: ../edit/virt-edit.pod:163 ../fish/guestfish.pod:392 #: ../fuse/guestmount.pod:268 ../inspector/virt-inspector.pod:121 -#: ../rescue/virt-rescue.pod:184 ../sparsify/virt-sparsify.pod:161 +#: ../rescue/virt-rescue.pod:221 ../sparsify/virt-sparsify.pod:185 msgid "B<--verbose>" msgstr "" @@ -529,7 +531,7 @@ msgstr "" #: ../cat/virt-filesystems.pod:265 ../cat/virt-ls.pod:429 #: ../clone/virt-sysprep.pod:142 ../df/virt-df.pod:177 #: ../edit/virt-edit.pod:165 ../inspector/virt-inspector.pod:123 -#: ../rescue/virt-rescue.pod:186 ../sparsify/virt-sparsify.pod:163 +#: ../rescue/virt-rescue.pod:223 ../sparsify/virt-sparsify.pod:187 msgid "Enable verbose messages for debugging." msgstr "" @@ -539,8 +541,8 @@ msgstr "" #: ../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 +#: ../rescue/virt-rescue.pod:225 ../resize/virt-resize.pod:567 +#: ../sparsify/virt-sparsify.pod:189 msgid "B<-V>" msgstr "" @@ -550,8 +552,8 @@ msgstr "" #: ../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 +#: ../rescue/virt-rescue.pod:227 ../resize/virt-resize.pod:569 +#: ../sparsify/virt-sparsify.pod:191 ../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>" @@ -562,8 +564,8 @@ msgstr "" #: ../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 +#: ../rescue/virt-rescue.pod:229 ../resize/virt-resize.pod:571 +#: ../sparsify/virt-sparsify.pod:193 ../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." @@ -575,7 +577,7 @@ msgstr "" #: ../clone/virt-sysprep.pod:150 ../df/virt-df.pod:185 #: ../edit/virt-edit.pod:173 ../fish/guestfish.pod:412 #: ../fuse/guestmount.pod:287 ../inspector/virt-inspector.pod:131 -#: ../rescue/virt-rescue.pod:203 ../sparsify/virt-sparsify.pod:171 +#: ../rescue/virt-rescue.pod:240 ../sparsify/virt-sparsify.pod:195 #: ../tools/virt-tar.pl:158 msgid "B<-x>" msgstr "" @@ -585,7 +587,7 @@ msgstr "" #: ../cat/virt-filesystems.pod:283 ../cat/virt-ls.pod:439 #: ../clone/virt-sysprep.pod:152 ../df/virt-df.pod:187 #: ../edit/virt-edit.pod:175 ../inspector/virt-inspector.pod:133 -#: ../rescue/virt-rescue.pod:205 ../sparsify/virt-sparsify.pod:173 +#: ../rescue/virt-rescue.pod:242 ../sparsify/virt-sparsify.pod:197 msgid "Enable tracing of libguestfs API calls." msgstr "" @@ -706,13 +708,15 @@ msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:232 -msgid "For a typical hard drive with 512 byte sectors:" +msgid "For a typical consumer hard drive with 512 byte sectors:" msgstr "" #. type: verbatim #: ../align/virt-alignment-scan.pod:234 #, no-wrap msgid "" +" $ cat /sys/block/sda/queue/hw_sector_size\n" +" 512\n" " $ cat /sys/block/sda/queue/physical_block_size\n" " 512\n" " $ cat /sys/block/sda/queue/logical_block_size\n" @@ -725,12 +729,34 @@ msgid "" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:243 +#: ../align/virt-alignment-scan.pod:245 +msgid "For a new consumer hard drive with 4Kbyte sectors:" +msgstr "" + +#. type: verbatim +#: ../align/virt-alignment-scan.pod:247 +#, no-wrap +msgid "" +" $ cat /sys/block/sda/queue/hw_sector_size\n" +" 4096\n" +" $ cat /sys/block/sda/queue/physical_block_size\n" +" 4096\n" +" $ cat /sys/block/sda/queue/logical_block_size\n" +" 4096\n" +" $ cat /sys/block/sda/queue/minimum_io_size\n" +" 4096\n" +" $ cat /sys/block/sda/queue/optimal_io_size\n" +" 0\n" +"\n" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:258 msgid "For a NetApp LUN:" msgstr "" #. type: verbatim -#: ../align/virt-alignment-scan.pod:245 +#: ../align/virt-alignment-scan.pod:260 #, no-wrap msgid "" " $ cat /sys/block/sdc/queue/logical_block_size\n" @@ -745,14 +771,14 @@ msgid "" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:254 +#: ../align/virt-alignment-scan.pod:269 msgid "" "The NetApp allows 512 byte accesses (but they will be very inefficient), " "prefers a minimum 4K I/O size, but the optimal I/O size is 64K." msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:258 +#: ../align/virt-alignment-scan.pod:273 msgid "" "For detailed information about what these numbers mean, see L can change the alignment of the partitions of some " "guests. Currently it can fully align all the partitions of all Windows " @@ -809,7 +835,7 @@ msgid "" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:284 +#: ../align/virt-alignment-scan.pod:299 msgid "" "Another way to correct partition alignment problems is to reinstall your " "guest operating systems. If you install operating systems from templates, " @@ -817,14 +843,14 @@ msgid "" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:288 +#: ../align/virt-alignment-scan.pod:303 msgid "" "For older versions of Windows, the following NetApp document contains useful " "information: L" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:291 +#: ../align/virt-alignment-scan.pod:306 msgid "" "For Red Hat Enterprise Linux E 5, use a Kickstart script that contains " "an explicit C<%pre> section that creates aligned partitions using L 64K for best performance" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:317 +#: ../align/virt-alignment-scan.pod:332 msgid "1" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:319 +#: ../align/virt-alignment-scan.pod:334 msgid "an error scanning the disk image or guest" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:323 +#: ../align/virt-alignment-scan.pod:338 msgid "2" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:325 +#: ../align/virt-alignment-scan.pod:340 msgid "" "successful exit, some partitions have alignment E 64K which can result " "in poor performance on high end network storage" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:330 +#: ../align/virt-alignment-scan.pod:345 msgid "3" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:332 +#: ../align/virt-alignment-scan.pod:347 msgid "" "successful exit, some partitions have alignment E 4K which can result in " "poor performance on most hypervisors" 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 +#: ../align/virt-alignment-scan.pod:352 ../cat/virt-cat.pod:243 +#: ../cat/virt-filesystems.pod:385 ../cat/virt-ls.pod:495 +#: ../clone/virt-sysprep.pod:486 ../df/virt-df.pod:253 #: ../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 +#: ../examples/guestfs-testing.pod:291 ../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:395 +#: ../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:325 +#: ../resize/virt-resize.pod:694 ../ruby/examples/guestfs-ruby.pod:36 +#: ../sparsify/virt-sparsify.pod:275 ../src/guestfs.pod:3275 #: ../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 @@ -1022,18 +1052,18 @@ msgid "SEE ALSO" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:339 +#: ../align/virt-alignment-scan.pod:354 msgid "" "L, L, L, L, " "L, L." 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 +#: ../align/virt-alignment-scan.pod:361 ../cat/virt-cat.pod:252 +#: ../cat/virt-filesystems.pod:396 ../cat/virt-ls.pod:507 +#: ../clone/virt-sysprep.pod:501 ../df/virt-df.pod:261 +#: ../edit/virt-edit.pod:368 ../rescue/virt-rescue.pod:334 +#: ../resize/virt-resize.pod:717 ../sparsify/virt-sparsify.pod:288 #: ../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 @@ -1041,31 +1071,32 @@ 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 +#: ../align/virt-alignment-scan.pod:363 ../cat/virt-cat.pod:254 +#: ../cat/virt-filesystems.pod:398 ../cat/virt-ls.pod:509 +#: ../clone/virt-sysprep.pod:503 ../df/virt-df.pod:263 +#: ../edit/virt-edit.pod:370 ../inspector/virt-inspector.pod:410 +#: ../rescue/virt-rescue.pod:336 ../resize/virt-resize.pod:719 +#: ../sparsify/virt-sparsify.pod:290 ../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" 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 +#: ../align/virt-alignment-scan.pod:365 ../cat/virt-cat.pod:256 +#: ../cat/virt-filesystems.pod:400 ../cat/virt-ls.pod:511 +#: ../clone/virt-sysprep.pod:505 ../df/virt-df.pod:265 #: ../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 +#: ../examples/guestfs-testing.pod:302 ../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:418 +#: ../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:338 +#: ../resize/virt-resize.pod:721 ../ruby/examples/guestfs-ruby.pod:52 +#: ../sparsify/virt-sparsify.pod:292 ../src/guestfs.pod:3358 #: ../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 @@ -1074,21 +1105,21 @@ msgid "COPYRIGHT" msgstr "" #. type: textblock -#: ../align/virt-alignment-scan.pod:352 ../clone/virt-sysprep.pod:507 -#: ../sparsify/virt-sparsify.pod:270 +#: ../align/virt-alignment-scan.pod:367 ../clone/virt-sysprep.pod:507 +#: ../sparsify/virt-sparsify.pod:294 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 +#: ../align/virt-alignment-scan.pod:369 ../cat/virt-cat.pod:260 +#: ../cat/virt-filesystems.pod:404 ../cat/virt-ls.pod:515 +#: ../clone/virt-sysprep.pod:509 ../df/virt-df.pod:269 #: ../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 +#: ../fuse/guestmount.pod:337 ../inspector/virt-inspector.pod:422 +#: ../rescue/virt-rescue.pod:342 ../resize/virt-resize.pod:725 +#: ../sparsify/virt-sparsify.pod:296 ../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 @@ -1100,15 +1131,15 @@ 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 +#: ../align/virt-alignment-scan.pod:374 ../cat/virt-cat.pod:265 +#: ../cat/virt-filesystems.pod:409 ../cat/virt-ls.pod:520 +#: ../clone/virt-sysprep.pod:514 ../df/virt-df.pod:274 #: ../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 +#: ../fuse/guestmount.pod:342 ../inspector/virt-inspector.pod:427 +#: ../rescue/virt-rescue.pod:347 ../resize/virt-resize.pod:730 +#: ../sparsify/virt-sparsify.pod:301 ../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 @@ -1120,22 +1151,22 @@ 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 +#: ../align/virt-alignment-scan.pod:379 ../cat/virt-cat.pod:270 +#: ../cat/virt-filesystems.pod:414 ../cat/virt-ls.pod:525 +#: ../clone/virt-sysprep.pod:519 ../df/virt-df.pod:279 #: ../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 +#: ../fuse/guestmount.pod:347 ../inspector/virt-inspector.pod:432 +#: ../rescue/virt-rescue.pod:352 ../resize/virt-resize.pod:735 +#: ../sparsify/virt-sparsify.pod:306 ../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 " -"Ave, Cambridge, MA 02139, USA." +"this program; if not, write to the Free Software Foundation, Inc., 51 " +"Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA." msgstr "" #. type: textblock @@ -1300,7 +1331,7 @@ msgstr "" #. type: textblock #: ../cat/virt-cat.pod:74 ../cat/virt-filesystems.pod:103 #: ../cat/virt-ls.pod:273 ../df/virt-df.pod:71 ../edit/virt-edit.pod:74 -#: ../inspector/virt-inspector.pod:67 ../rescue/virt-rescue.pod:96 +#: ../inspector/virt-inspector.pod:67 ../rescue/virt-rescue.pod:124 msgid "" "Add I which should be a disk image from a virtual machine. If the " "virtual machine has multiple block devices, you must supply all of them with " @@ -1357,7 +1388,7 @@ msgstr "" #. type: =head1 #: ../cat/virt-cat.pod:152 ../cat/virt-ls.pod:443 ../edit/virt-edit.pod:179 -#: ../inspector/virt-inspector.pod:137 ../rescue/virt-rescue.pod:209 +#: ../inspector/virt-inspector.pod:144 ../rescue/virt-rescue.pod:246 msgid "OLD-STYLE COMMAND LINE ARGUMENTS" msgstr "" @@ -1376,7 +1407,7 @@ msgstr "" #. type: textblock #: ../cat/virt-cat.pod:158 ../cat/virt-ls.pod:449 ../edit/virt-edit.pod:185 -#: ../inspector/virt-inspector.pod:143 ../rescue/virt-rescue.pod:215 +#: ../inspector/virt-inspector.pod:150 ../rescue/virt-rescue.pod:252 msgid "or" msgstr "" @@ -1390,7 +1421,7 @@ msgstr "" #. type: textblock #: ../cat/virt-cat.pod:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189 -#: ../inspector/virt-inspector.pod:147 ../rescue/virt-rescue.pod:219 +#: ../inspector/virt-inspector.pod:154 ../rescue/virt-rescue.pod:256 msgid "" "whereas in this version you should use I<-a> or I<-d> respectively to avoid " "the confusing case where a disk image might have the same name as a guest." @@ -1398,29 +1429,82 @@ msgstr "" #. type: textblock #: ../cat/virt-cat.pod:166 ../cat/virt-ls.pod:457 ../edit/virt-edit.pod:193 -#: ../inspector/virt-inspector.pod:151 ../rescue/virt-rescue.pod:223 +#: ../inspector/virt-inspector.pod:158 ../rescue/virt-rescue.pod:260 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 has a limited ability to understand Windows drive letters and " +"paths (eg. C)." +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 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 is a more powerful, lower level tool which you can use when " "C doesn't work." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:173 +#: ../cat/virt-cat.pod:213 msgid "Using C 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" @@ -1428,14 +1512,14 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:177 +#: ../cat/virt-cat.pod:217 msgid "" "where C is the name of the libvirt guest, and C 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 " @@ -1444,7 +1528,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" @@ -1452,31 +1536,31 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:188 +#: ../cat/virt-cat.pod:228 msgid "" "where C is the disk image, C is the filesystem within " "the disk image, and C 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:250 ../edit/virt-edit.pod:351 +#: ../fuse/guestmount.pod:314 ../inspector/virt-inspector.pod:392 +#: ../resize/virt-resize.pod:691 ../sparsify/virt-sparsify.pod:253 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, L, L, L, L, L." 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:420 +#: ../resize/virt-resize.pod:723 ../tools/virt-make-fs.pl:588 msgid "Copyright (C) 2010-2011 Red Hat Inc." msgstr "" @@ -2012,23 +2096,41 @@ msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:319 -msgid "B" +msgid "B" 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" +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" +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" 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 " @@ -2037,47 +2139,47 @@ msgid "" msgstr "" #. type: =item -#: ../cat/virt-filesystems.pod:331 +#: ../cat/virt-filesystems.pod:339 msgid "B" 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:217 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:219 msgid "" "Comma-separated values (CSV) is a deceptive format. It I like it " "should be easy to parse, but it is definitely not easy to parse." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:346 ../cat/virt-ls.pod:464 -#: ../df/virt-df.pod:196 +#: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:464 +#: ../df/virt-df.pod:222 msgid "" "Myth: Just split fields at commas. Reality: This does I work " "reliably. This example has two columns:" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:467 -#: ../df/virt-df.pod:199 +#: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:467 +#: ../df/virt-df.pod:225 #, no-wrap msgid "" " \"foo,bar\",baz\n" @@ -2085,16 +2187,16 @@ 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:227 msgid "" "Myth: Read the file one line at a time. Reality: This does I work " "reliably. This example has one row:" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:472 -#: ../df/virt-df.pod:204 +#: ../cat/virt-filesystems.pod:362 ../cat/virt-ls.pod:472 +#: ../df/virt-df.pod:230 #, no-wrap msgid "" " \"foo\n" @@ -2103,29 +2205,29 @@ 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:233 msgid "" "For shell scripts, use C (L also " "packaged in major Linux distributions)." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:360 ../cat/virt-ls.pod:478 -#: ../df/virt-df.pod:210 +#: ../cat/virt-filesystems.pod:368 ../cat/virt-ls.pod:478 +#: ../df/virt-df.pod:236 msgid "" "For other languages, use a CSV processing library (eg. C for Perl " "or Python's built-in csv library)." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:363 ../cat/virt-ls.pod:481 -#: ../df/virt-df.pod:213 +#: ../cat/virt-filesystems.pod:371 ../cat/virt-ls.pod:481 +#: ../df/virt-df.pod:239 msgid "Most spreadsheets and databases can import CSV directly." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:379 +#: ../cat/virt-filesystems.pod:387 msgid "" "L, L, L, L, L, L, L, L (and L) get information by issuing a L system " +"call. You can get the same information directly, either from the host " +"(using libguestfs) or inside the guest:" +msgstr "" + +#. type: =item +#: ../df/virt-df.pod:199 +msgid "From the host" +msgstr "" + #. type: textblock -#: ../df/virt-df.pod:229 +#: ../df/virt-df.pod:201 ../df/virt-df.pod:209 +msgid "Run this command:" +msgstr "" + +#. type: verbatim +#: ../df/virt-df.pod:203 +#, no-wrap +msgid "" +" guestfish --ro -d GuestName -i statvfs /\n" +"\n" +msgstr "" + +#. type: textblock +#: ../df/virt-df.pod:205 ../df/virt-df.pod:213 +msgid "(change C to see stats for other filesystems)." +msgstr "" + +#. type: =item +#: ../df/virt-df.pod:207 +msgid "From inside the guest" +msgstr "" + +#. type: verbatim +#: ../df/virt-df.pod:211 +#, no-wrap +msgid "" +" python -c 'import os; s = os.statvfs (\"/\"); print s'\n" +"\n" +msgstr "" + +#. type: textblock +#: ../df/virt-df.pod:255 msgid "" "L, L, L, L, L." @@ -3951,7 +4102,7 @@ msgstr "" #. type: =head1 #: ../edit/virt-edit.pod:21 ../fish/guestfish.pod:23 #: ../fish/virt-copy-in.pod:13 ../fish/virt-tar-in.pod:15 -#: ../fuse/guestmount.pod:15 ../rescue/virt-rescue.pod:19 +#: ../fuse/guestmount.pod:15 ../rescue/virt-rescue.pod:21 #: ../tools/virt-tar.pl:64 ../tools/virt-win-reg.pl:51 msgid "WARNING" msgstr "" @@ -4321,11 +4472,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 "" @@ -4334,25 +4480,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 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 " @@ -4360,21 +4487,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 is a more powerful, lower level tool which you can use when " @@ -4458,8 +4570,8 @@ 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 +#: ../rescue/virt-rescue.pod:298 ../sparsify/virt-sparsify.pod:256 +#: ../src/guestfs.pod:3214 ../test-tool/libguestfs-test-tool.pod:95 msgid "ENVIRONMENT VARIABLES" msgstr "" @@ -4719,13 +4831,14 @@ 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 +#: ../examples/guestfs-testing.pod:298 ../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:404 +#: ../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 +#: ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3354 #: ../test-tool/libguestfs-test-tool.pod:106 msgid "AUTHORS" msgstr "" @@ -4733,20 +4846,21 @@ 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 +#: ../examples/guestfs-testing.pod:300 ../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 +#: ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3356 #: ../test-tool/libguestfs-test-tool.pod:108 msgid "Richard W.M. Jones (C)" msgstr "" #. type: textblock #: ../erlang/examples/guestfs-erlang.pod:116 -#: ../java/examples/guestfs-java.pod:64 ../perl/examples/guestfs-perl.pod:58 +#: ../examples/guestfs-testing.pod:304 ../java/examples/guestfs-java.pod:64 +#: ../perl/examples/guestfs-perl.pod:58 msgid "Copyright (C) 2011 Red Hat Inc. L" msgstr "" @@ -4765,11 +4879,11 @@ 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 +#: ../examples/guestfs-testing.pod:306 ../java/examples/guestfs-java.pod:69 #: ../ocaml/examples/guestfs-ocaml.pod:102 #: ../perl/examples/guestfs-perl.pod:63 #: ../python/examples/guestfs-python.pod:65 -#: ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3342 +#: ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3363 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 " @@ -4780,11 +4894,11 @@ 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 +#: ../examples/guestfs-testing.pod:311 ../java/examples/guestfs-java.pod:74 #: ../ocaml/examples/guestfs-ocaml.pod:107 #: ../perl/examples/guestfs-perl.pod:68 #: ../python/examples/guestfs-python.pod:70 -#: ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3347 +#: ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3368 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 " @@ -4795,11 +4909,11 @@ 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 +#: ../examples/guestfs-testing.pod:316 ../java/examples/guestfs-java.pod:79 #: ../ocaml/examples/guestfs-ocaml.pod:112 #: ../perl/examples/guestfs-perl.pod:73 #: ../python/examples/guestfs-python.pod:75 -#: ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3352 +#: ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3373 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, " @@ -5139,7 +5253,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:126 +#: ../examples/guestfs-recipes.pod:126 ../examples/guestfs-testing.pod:93 #, no-wrap msgid "" " virt-copy-out -d Guest /home .\n" @@ -5148,10 +5262,10 @@ 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 +#: ../fish/guestfish-actions.pod:1450 ../fish/guestfish-actions.pod:1715 +#: ../fish/guestfish-actions.pod:2132 ../src/guestfs-actions.pod:18 +#: ../src/guestfs-actions.pod:2334 ../src/guestfs-actions.pod:2758 +#: ../src/guestfs-actions.pod:3317 ../src/guestfs.pod:1685 #: ../tools/virt-win-reg.pl:717 msgid "Notes:" msgstr "" @@ -5705,6 +5819,710 @@ msgstr "" msgid "Copyright (C) 2009-2011 Red Hat Inc. L" msgstr "" +#. type: textblock +#: ../examples/guestfs-testing.pod:5 +msgid "guestfs-testing - manual testing of libguestfs, you can help!" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:9 +msgid "" +"This page has manual tests you can try on libguestfs. Everyone has a " +"slightly different combination of platform, hardware and guests, so this " +"testing is very valuable. Thanks for helping out!" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:13 +msgid "These tests require libguestfs E 1.14." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:15 +msgid "" +"Tests marked with a B<*> (asterisk) can B if you're not " +"careful. The others are safe and won't modify anything." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:18 +msgid "You can report bugs you find through this link:" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:20 +msgid "" +"https://bugzilla.redhat.com/enter_bug.cgi?" +"component=libguestfs&product=Virtualization+Tools" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:22 +msgid "" +"or post on the mailing list (registration is B required, but if you're " +"not registered then you'll have to wait for a moderator to manually approve " +"your message):" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:26 +msgid "https://www.redhat.com/mailman/listinfo/libguestfs" +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-testing.pod:28 +msgid "TESTS" +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:30 +msgid "Check KVM acceleration is being used." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:32 +msgid "" +"If your host has hardware virt acceleration, then with a hot cache " +"libguestfs should be able to start up in a few seconds. Run the following " +"command a few times:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:36 +#, no-wrap +msgid "" +" time guestfish -a /dev/null run\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:38 +msgid "" +"After a few runs, the time should settle down to a few seconds (under 5 " +"seconds on fast 64 bit hardware)." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:41 +msgid "How to check for hardware virt:" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:43 +msgid "http://virt-tools.org/learning/check-hardware-virt/" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:45 +msgid "" +"If the command above does not work at all, use L." +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:48 +msgid "Run virt-alignment-scan on all your guests." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:50 +msgid "Run L on guests or disk images:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:52 +#, no-wrap +msgid "" +" virt-alignment-scan -a /path/to/disk.img\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:54 ../examples/guestfs-testing.pod:161 +#: ../examples/guestfs-testing.pod:174 ../examples/guestfs-testing.pod:234 +#: ../src/guestfs.pod:2792 +msgid "or:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:56 +#, no-wrap +msgid "" +" virt-alignment-scan -d Guest\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:58 +msgid "Does the alignment report match how the guest partitions are aligned?" +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:60 +msgid "Run virt-cat on some files in guests." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:62 +msgid "L can display files from guests. For a Linux guest, try:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:64 +#, no-wrap +msgid "" +" virt-cat LinuxGuest /etc/passwd\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:66 +msgid "A recent feature is support for Windows paths, for example:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:68 +#, no-wrap +msgid "" +" virt-cat WindowsGuest 'c:\\windows\\win.ini'\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:70 +msgid "" +"An even better test is if you have a Windows guest with multiple drives. Do " +"C, C etc paths work correctly?" +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:73 +msgid "B<*> Copy some files into a B guest." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:75 +msgid "" +"L can recursively copy files and directories into a guest " +"or disk image." +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:78 +#, no-wrap +msgid "" +" virt-copy-in -d Guest /etc /tmp\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:80 +msgid "" +"This should copy local directory C to C in the guest " +"(recursively). If you boot the guest, can you see all of the copied files " +"and directories?" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:84 +msgid "Shut the guest down and try copying multiple files and directories:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:86 +#, no-wrap +msgid "" +" virt-copy-in -d Guest /home /etc/issue /tmp\n" +"\n" +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:88 +msgid "Copy some files out of a guest." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:90 +msgid "" +"L can recursively copy files and directories out of a " +"guest or disk image." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:95 +msgid "Note the final space and period in the command is not a typo." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:97 +msgid "This should copy C from the guest into the current directory." +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:99 +msgid "Run virt-df." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:101 +msgid "L lists disk space. Run:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:103 +#, no-wrap +msgid "" +" virt-df\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:105 +msgid "" +"You can try comparing this to the results from L inside the guest, " +"but there are some provisos:" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:112 +msgid "The guest must be idle." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:116 +msgid "The guest disks must be synched using L." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:120 +msgid "" +"Any action such as booting the guest will write log files causing the " +"numbers to change." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:125 +msgid "" +"We don't guarantee that the numbers will be identical even under these " +"circumstances. They should be similar. It would indicate a bug if you saw " +"greatly differing numbers." +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:129 +msgid "Try importing virt-df CSV output into a spreadsheet or database." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:131 ../src/guestfs.pod:3088 +msgid "Run:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:133 +#, no-wrap +msgid "" +" virt-df --csv > /tmp/report.csv\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:135 +msgid "" +"Now try to load this into your favorite spreadsheet or database. Are the " +"results reproduced faithfully in the spreadsheet/database?" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:138 +msgid "" +"http://www.postgresql.org/docs/8.1/static/sql-copy.html http://dev.mysql.com/" +"doc/refman/5.1/en/load-data.html" +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:141 +msgid "B<*> Edit a file in a B guest." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:143 +msgid "" +"L can edit files in guests. Try this command on a RHEL or " +"Fedora guest:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:146 +#, no-wrap +msgid "" +" virt-edit LinuxGuest /etc/sysconfig/network\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:148 +msgid "On other Linux guests try editing other files such as:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:150 +#, no-wrap +msgid "" +" virt-edit LinuxGuest /etc/motd\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:152 +msgid "Are the changes seen inside the guest when it is booted?" +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:154 +msgid "Display the filesystems / partitions / LVs in a guest." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:156 +msgid "" +"L can be used to display filesystems in a guest. Try " +"this command on any disk image or guest:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:159 +#, no-wrap +msgid "" +" virt-filesystems -a /path/to/disk.img --all --long -h\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:163 +#, no-wrap +msgid "" +" virt-filesystems -d Guest --all --long -h\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:165 +msgid "Do the results match what is seen in the guest?" +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:167 +msgid "Run virt-inspector on all your guests." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:169 +msgid "" +"Use L to get a report on all of your guests or disk " +"images:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:172 +#, no-wrap +msgid "" +" virt-inspector -a /path/to/disk.img | less\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:176 +#, no-wrap +msgid "" +" virt-inspector -d Guest | less\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:178 +msgid "Do the results match what is actually in the guest?" +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:180 +msgid "Try the auditing features of virt-ls on all your guests." +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:184 +#, no-wrap +msgid "" +" virt-ls -lR -d Guest / | grep '^- [42]'\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:188 +#, no-wrap +msgid "" +" virt-ls -lR -d Guest / | grep '^d ...7'\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:192 +#, no-wrap +msgid "" +" virt-ls -lR -d Guest / | grep '^s'\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:196 +#, no-wrap +msgid "" +" virt-ls -lR -d Guest / | grep -i '^-.*\\.png$'\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:198 +msgid "Display files larger than 10MB in home directories:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:200 +#, no-wrap +msgid "" +" virt-ls -lR -d Guest /home | awk '$3 > 10*1024*1024'\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:204 +#, no-wrap +msgid "" +" virt-ls -lR -d Guest --time-days / | awk '$6 <= 7'\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:208 +#, no-wrap +msgid "" +" virt-ls -lR -d Guest --time-days / | grep '^-' | awk '$6 < 1'\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:210 +msgid "Do the results match what is in the guest?" +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:212 +msgid "Create a disk image from a tarball." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:214 +msgid "" +"Use L to create a disk image from any tarball that you " +"happen to have:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:217 +#, no-wrap +msgid "" +" virt-make-fs --partition=mbr --type=vfat /any/tarball.tar.gz output.img\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:219 +msgid "" +"Add 'output.img' as a raw disk to an existing guest. Check the guest can " +"see the files. This test is particularly useful if you try it with a " +"Windows guest." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:223 +msgid "Try other partitioning schemes, eg. I<--partition=gpt>." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:225 +msgid "Try other filesystem formats, eg. I<--type=ntfs>, I<--type=ext2>." +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:227 +msgid "B<*> Run virt-rescue on a B disk image or guest." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:229 +msgid "" +"Use L to examine, rescue or repair a B guest or " +"disk image:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:232 +#, no-wrap +msgid "" +" virt-rescue -a /path/to/disk.img\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:236 +#, no-wrap +msgid "" +" virt-rescue -d Guest\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:238 +msgid "Can you use ordinary shell commands to examine the guest?" +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:240 +msgid "B<*> Resize your guests." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:242 +msgid "" +"Use L to give a guest some more disk space. For example, if " +"you have a disk image that is smaller than 30G, increase it to 30G by doing:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:246 +#, no-wrap +msgid "" +" truncate -s 30G newdisk.img\n" +" virt-filesystems -a /path/to/olddisk.img --all --long -h\n" +" virt-resize /path/to/olddisk.img newdisk.img --expand /dev/sda1\n" +" qemu-kvm -m 1024 -hda newdisk.img\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:251 +msgid "Does the guest still boot? Try expanding other partitions." +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:253 +msgid "B<*> Sparsify a guest disk." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:255 +msgid "Using L, make a disk image more sparse:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:257 +#, no-wrap +msgid "" +" virt-sparsify /path/to/olddisk.img newdisk.img\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:259 +msgid "" +"Is C still bootable after sparsifying? Is the resulting disk " +"image smaller (use C to check)?" +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:262 +msgid "B<*> \"sysprep\" a B Linux guest." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:264 +msgid "" +"Note that this really will mess up an existing guest, so it's better to " +"clone the guest before trying this." +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:267 +#, no-wrap +msgid "" +" virt-sysprep --hostname newhost.example.com -a /path/to/disk.img\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:269 +msgid "" +"Was the sysprep successful? After booting, what changes were made and were " +"they successful?" +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:272 +msgid "Dump the Windows Registry from your Windows guests." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:274 +msgid "" +"Use L to dump out the Windows Registry from any Windows " +"guests that you have." +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:277 +#, no-wrap +msgid "" +" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\Software' |\n" +" less\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:280 +#, no-wrap +msgid "" +" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\System' |\n" +" less\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:283 +msgid "Does the output match running C inside the guest?" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:285 +msgid "" +"A recent feature is the ability to dump user registries, so try this, " +"replacing I with the name of a local user in the guest:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:288 +#, no-wrap +msgid "" +" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKEY_USERS\\username' |\n" +" less\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:293 +msgid "" +"L, L, L, L." +msgstr "" + #. type: =head2 #: ../fish/guestfish-actions.pod:1 msgid "add-cdrom" @@ -5746,30 +6564,32 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:168 -#: ../fish/guestfish-actions.pod:182 +#: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:214 +#: ../fish/guestfish-actions.pod:228 msgid "" "I In new code, use the L call " "instead." 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:217 +#: ../fish/guestfish-actions.pod:231 ../fish/guestfish-actions.pod:941 +#: ../fish/guestfish-actions.pod:976 ../fish/guestfish-actions.pod:1149 +#: ../fish/guestfish-actions.pod:1509 ../fish/guestfish-actions.pod:1523 +#: ../fish/guestfish-actions.pod:3392 ../fish/guestfish-actions.pod:3703 +#: ../fish/guestfish-actions.pod:3751 ../fish/guestfish-actions.pod:4669 +#: ../fish/guestfish-actions.pod:4689 ../fish/guestfish-actions.pod:4708 +#: ../fish/guestfish-actions.pod:4746 ../fish/guestfish-actions.pod:5474 +#: ../fish/guestfish-actions.pod:5577 ../src/guestfs-actions.pod:10 +#: ../src/guestfs-actions.pod:305 ../src/guestfs-actions.pod:326 +#: ../src/guestfs-actions.pod:1580 ../src/guestfs-actions.pod:1637 +#: ../src/guestfs-actions.pod:1920 ../src/guestfs-actions.pod:2419 +#: ../src/guestfs-actions.pod:2440 ../src/guestfs-actions.pod:5242 +#: ../src/guestfs-actions.pod:5764 ../src/guestfs-actions.pod:5864 +#: ../src/guestfs-actions.pod:7160 ../src/guestfs-actions.pod:7201 +#: ../src/guestfs-actions.pod:7232 ../src/guestfs-actions.pod:7292 +#: ../src/guestfs-actions.pod:8346 ../src/guestfs-actions.pod:8455 +#: ../src/guestfs-actions.pod:8635 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 " @@ -5790,7 +6610,7 @@ msgstr "" #: ../fish/guestfish-actions.pod:39 #, no-wrap msgid "" -" add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..] [allowuuid:..]\n" +" add-domain dom [libvirturi:..] [readonly:true|false] [iface:..] [live:true|false] [allowuuid:true|false] [readonlydisk:..]\n" "\n" msgstr "" @@ -5803,14 +6623,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:46 ../src/guestfs-actions.pod:64 +#: ../fish/guestfish-actions.pod:46 ../src/guestfs-actions.pod:65 msgid "" "The number of disks added is returned. This operation is atomic: if an " "error is returned, then no disks are added." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:49 ../src/guestfs-actions.pod:67 +#: ../fish/guestfish-actions.pod:49 ../src/guestfs-actions.pod:68 msgid "" "This function does some minimal checks to make sure the libvirt domain is " "not running (unless C is true). In a future version we will try " @@ -5818,7 +6638,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:53 ../src/guestfs-actions.pod:71 +#: ../fish/guestfish-actions.pod:53 ../src/guestfs-actions.pod:72 msgid "" "Disks must be accessible locally. This often means that adding disks from a " "remote libvirt connection (see L) will fail " @@ -5826,7 +6646,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:58 ../src/guestfs-actions.pod:76 +#: ../fish/guestfish-actions.pod:58 ../src/guestfs-actions.pod:77 msgid "" "The optional C parameter sets the libvirt URI (see L). If this is not set then we connect to the default " @@ -5835,7 +6655,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:64 ../src/guestfs-actions.pod:82 +#: ../fish/guestfish-actions.pod:64 ../src/guestfs-actions.pod:83 msgid "" "The optional C flag controls whether this call will try to connect to " "a running virtual machine C process if it sees a suitable " @@ -5845,7 +6665,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:71 ../src/guestfs-actions.pod:89 +#: ../fish/guestfish-actions.pod:71 ../src/guestfs-actions.pod:90 msgid "" "If the C flag is true (default is false) then a UUID I be " "passed instead of the domain name. The C string is treated as a UUID " @@ -5854,29 +6674,109 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:76 +#: ../fish/guestfish-actions.pod:76 ../src/guestfs-actions.pod:95 +msgid "" +"The optional C parameter controls what we do for disks which " +"are marked Ereadonly/E in the libvirt XML. Possible values are:" +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:82 ../src/guestfs-actions.pod:101 +msgid "readonlydisk = \"error\"" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:84 ../fish/guestfish-actions.pod:95 +#: ../fish/guestfish-actions.pod:106 ../src/guestfs-actions.pod:103 +#: ../src/guestfs-actions.pod:114 ../src/guestfs-actions.pod:125 +msgid "If C is false:" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:86 ../src/guestfs-actions.pod:105 +msgid "" +"The whole call is aborted with an error if any disk with the Ereadonly/" +"E flag is found." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:89 ../fish/guestfish-actions.pod:100 +#: ../fish/guestfish-actions.pod:110 ../src/guestfs-actions.pod:108 +#: ../src/guestfs-actions.pod:119 ../src/guestfs-actions.pod:129 +msgid "If C is true:" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:91 ../fish/guestfish-actions.pod:102 +#: ../fish/guestfish-actions.pod:112 ../src/guestfs-actions.pod:110 +#: ../src/guestfs-actions.pod:121 ../src/guestfs-actions.pod:131 +msgid "Disks with the Ereadonly/E flag are added read-only." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:93 ../src/guestfs-actions.pod:112 +msgid "readonlydisk = \"read\"" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:97 ../src/guestfs-actions.pod:116 +msgid "" +"Disks with the Ereadonly/E flag are added read-only. Other disks " +"are added read/write." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:104 ../src/guestfs-actions.pod:123 +msgid "readonlydisk = \"write\" (default)" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:108 ../src/guestfs-actions.pod:127 +msgid "Disks with the Ereadonly/E flag are added read/write." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:114 ../src/guestfs-actions.pod:133 +msgid "readonlydisk = \"ignore\"" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:116 ../src/guestfs-actions.pod:135 +msgid "If C is true or false:" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:118 ../src/guestfs-actions.pod:137 +msgid "Disks with the Ereadonly/E flag are skipped." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:122 msgid "" "The other optional parameters are passed directly through to L." 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:125 ../fish/guestfish-actions.pod:194 +#: ../fish/guestfish-actions.pod:624 ../fish/guestfish-actions.pod:835 +#: ../fish/guestfish-actions.pod:856 ../fish/guestfish-actions.pod:894 +#: ../fish/guestfish-actions.pod:903 ../fish/guestfish-actions.pod:912 +#: ../fish/guestfish-actions.pod:926 ../fish/guestfish-actions.pod:2171 +#: ../fish/guestfish-actions.pod:3219 ../fish/guestfish-actions.pod:3441 +#: ../fish/guestfish-actions.pod:3604 ../fish/guestfish-actions.pod:3739 +#: ../fish/guestfish-actions.pod:5110 msgid "" "This command has one or more optional arguments. See L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:81 +#: ../fish/guestfish-actions.pod:127 msgid "add-drive" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:83 +#: ../fish/guestfish-actions.pod:129 #, no-wrap msgid "" " add-drive filename\n" @@ -5884,7 +6784,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:85 +#: ../fish/guestfish-actions.pod:131 msgid "" "This function is the equivalent of calling L with no " "optional parameters, so the disk is added writable, with the format being " @@ -5892,7 +6792,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:89 +#: ../fish/guestfish-actions.pod:135 msgid "" "Automatic detection of the format opens you up to a potential security hole " "when dealing with untrusted raw-format images. See CVE-2010-3851 and " @@ -5902,25 +6802,25 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:96 +#: ../fish/guestfish-actions.pod:142 msgid "add-drive-opts" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:98 +#: ../fish/guestfish-actions.pod:144 msgid "add" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:100 +#: ../fish/guestfish-actions.pod:146 #, no-wrap msgid "" -" add-drive-opts filename [readonly:..] [format:..] [iface:..] [name:..]\n" +" add-drive-opts filename [readonly:true|false] [format:..] [iface:..] [name:..]\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:102 ../src/guestfs-actions.pod:161 +#: ../fish/guestfish-actions.pod:148 ../src/guestfs-actions.pod:208 msgid "" "This function adds a virtual machine disk image C to libguestfs. " "The first time you call this function, the disk appears as C, the " @@ -5928,7 +6828,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:107 ../src/guestfs-actions.pod:166 +#: ../fish/guestfish-actions.pod:153 ../src/guestfs-actions.pod:213 msgid "" "You don't necessarily need to be root when using libguestfs. However you " "obviously do need sufficient permissions to access the filename for whatever " @@ -5937,23 +6837,23 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:113 ../src/guestfs-actions.pod:172 +#: ../fish/guestfish-actions.pod:159 ../src/guestfs-actions.pod:219 msgid "This call checks that C 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:161 ../fish/guestfish-actions.pod:3403 +#: ../src/guestfs-actions.pod:221 ../src/guestfs-actions.pod:5279 msgid "The optional arguments are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:119 ../src/guestfs-actions.pod:178 +#: ../fish/guestfish-actions.pod:165 ../src/guestfs-actions.pod:225 msgid "C" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:121 ../src/guestfs-actions.pod:180 +#: ../fish/guestfish-actions.pod:167 ../src/guestfs-actions.pod:227 msgid "" "If true then the image is treated as read-only. Writes are still allowed, " "but they are stored in a temporary snapshot overlay which is discarded at " @@ -5961,12 +6861,12 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:125 ../src/guestfs-actions.pod:184 +#: ../fish/guestfish-actions.pod:171 ../src/guestfs-actions.pod:231 msgid "C" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:127 +#: ../fish/guestfish-actions.pod:173 msgid "" "This forces the image format. If you omit this (or use L or L) then the format is automatically detected. Possible formats " @@ -5974,7 +6874,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:131 ../src/guestfs-actions.pod:190 +#: ../fish/guestfish-actions.pod:177 ../src/guestfs-actions.pod:237 msgid "" "Automatic detection of the format opens you up to a potential security hole " "when dealing with untrusted raw-format images. See CVE-2010-3851 and " @@ -5982,41 +6882,42 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:136 ../src/guestfs-actions.pod:195 +#: ../fish/guestfish-actions.pod:182 ../src/guestfs-actions.pod:242 msgid "C" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:138 +#: ../fish/guestfish-actions.pod:184 msgid "" "This rarely-used option lets you emulate the behaviour of the deprecated L call (q.v.)" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:141 ../src/guestfs-actions.pod:200 +#: ../fish/guestfish-actions.pod:187 ../fish/guestfish-actions.pod:3246 +#: ../src/guestfs-actions.pod:247 ../src/guestfs-actions.pod:5000 msgid "C" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:143 ../src/guestfs-actions.pod:202 +#: ../fish/guestfish-actions.pod:189 ../src/guestfs-actions.pod:249 msgid "" "The name the drive had in the original guest, e.g. /dev/sdb. This is used as " "a hint to the guest inspection process if it is available." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:150 +#: ../fish/guestfish-actions.pod:196 msgid "add-drive-ro" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:152 +#: ../fish/guestfish-actions.pod:198 msgid "add-ro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:154 +#: ../fish/guestfish-actions.pod:200 #, no-wrap msgid "" " add-drive-ro filename\n" @@ -6024,7 +6925,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:156 +#: ../fish/guestfish-actions.pod:202 msgid "" "This function is the equivalent of calling L with the " "optional parameter C set to 1, so the disk " @@ -6032,12 +6933,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:161 +#: ../fish/guestfish-actions.pod:207 msgid "add-drive-ro-with-if" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:163 +#: ../fish/guestfish-actions.pod:209 #, no-wrap msgid "" " add-drive-ro-with-if filename iface\n" @@ -6045,19 +6946,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:165 +#: ../fish/guestfish-actions.pod:211 msgid "" "This is the same as L but it allows you to specify the QEMU " "interface emulation to use at run time." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:175 +#: ../fish/guestfish-actions.pod:221 msgid "add-drive-with-if" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:177 +#: ../fish/guestfish-actions.pod:223 #, no-wrap msgid "" " add-drive-with-if filename iface\n" @@ -6065,19 +6966,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:179 +#: ../fish/guestfish-actions.pod:225 msgid "" "This is the same as L but it allows you to specify the QEMU " "interface emulation to use at run time." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:189 +#: ../fish/guestfish-actions.pod:235 msgid "aug-clear" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:191 +#: ../fish/guestfish-actions.pod:237 #, no-wrap msgid "" " aug-clear augpath\n" @@ -6085,19 +6986,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:193 ../src/guestfs-actions.pod:296 +#: ../fish/guestfish-actions.pod:239 ../src/guestfs-actions.pod:343 msgid "" "Set the value associated with C to C. This is the same as the " "L C command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:196 +#: ../fish/guestfish-actions.pod:242 msgid "aug-close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:198 +#: ../fish/guestfish-actions.pod:244 #, no-wrap msgid "" " aug-close\n" @@ -6105,7 +7006,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:200 +#: ../fish/guestfish-actions.pod:246 msgid "" "Close the current Augeas handle and free up any resources used by it. After " "calling this, you have to call L again before you can use any " @@ -6113,12 +7014,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:205 +#: ../fish/guestfish-actions.pod:251 msgid "aug-defnode" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:207 +#: ../fish/guestfish-actions.pod:253 #, no-wrap msgid "" " aug-defnode name expr val\n" @@ -6126,13 +7027,13 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:209 ../src/guestfs-actions.pod:325 +#: ../fish/guestfish-actions.pod:255 ../src/guestfs-actions.pod:372 msgid "" "Defines a variable C whose value is the result of evaluating C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:212 +#: ../fish/guestfish-actions.pod:258 msgid "" "If C evaluates to an empty nodeset, a node is created, equivalent to " "calling L C, C. C will be the nodeset " @@ -6140,19 +7041,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:216 ../src/guestfs-actions.pod:332 +#: ../fish/guestfish-actions.pod:262 ../src/guestfs-actions.pod:379 msgid "" "On success this returns a pair containing the number of nodes in the " "nodeset, and a boolean flag if a node was created." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:220 +#: ../fish/guestfish-actions.pod:266 msgid "aug-defvar" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:222 +#: ../fish/guestfish-actions.pod:268 #, no-wrap msgid "" " aug-defvar name expr\n" @@ -6160,26 +7061,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:224 ../src/guestfs-actions.pod:349 +#: ../fish/guestfish-actions.pod:270 ../src/guestfs-actions.pod:396 msgid "" "Defines an Augeas variable C whose value is the result of evaluating " "C. If C is NULL, then C is undefined." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:228 ../src/guestfs-actions.pod:353 +#: ../fish/guestfish-actions.pod:274 ../src/guestfs-actions.pod:400 msgid "" "On success this returns the number of nodes in C, or C<0> if C " "evaluates to something which is not a nodeset." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:231 +#: ../fish/guestfish-actions.pod:277 msgid "aug-get" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:233 +#: ../fish/guestfish-actions.pod:279 #, no-wrap msgid "" " aug-get augpath\n" @@ -6187,19 +7088,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:235 ../src/guestfs-actions.pod:366 +#: ../fish/guestfish-actions.pod:281 ../src/guestfs-actions.pod:413 msgid "" "Look up the value associated with C. If C matches exactly one " "node, the C is returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:238 +#: ../fish/guestfish-actions.pod:284 msgid "aug-init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:240 +#: ../fish/guestfish-actions.pod:286 #, no-wrap msgid "" " aug-init root flags\n" @@ -6207,7 +7108,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:242 ../src/guestfs-actions.pod:381 +#: ../fish/guestfish-actions.pod:288 ../src/guestfs-actions.pod:428 msgid "" "Create a new Augeas handle for editing configuration files. If there was " "any previous Augeas handle associated with this guestfs session, then it is " @@ -6215,57 +7116,57 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:246 +#: ../fish/guestfish-actions.pod:292 msgid "You must call this before using any other L commands." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:249 ../src/guestfs-actions.pod:388 +#: ../fish/guestfish-actions.pod:295 ../src/guestfs-actions.pod:435 msgid "" "C is the filesystem root. C must not be NULL, use C instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:252 ../src/guestfs-actions.pod:391 +#: ../fish/guestfish-actions.pod:298 ../src/guestfs-actions.pod:438 msgid "" "The flags are the same as the flags defined in Eaugeas.hE, the " "logical I of the following integers:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:258 ../src/guestfs-actions.pod:397 +#: ../fish/guestfish-actions.pod:304 ../src/guestfs-actions.pod:444 msgid "C = 1" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:260 ../src/guestfs-actions.pod:399 +#: ../fish/guestfish-actions.pod:306 ../src/guestfs-actions.pod:446 msgid "Keep the original file with a C<.augsave> extension." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:262 ../src/guestfs-actions.pod:401 +#: ../fish/guestfish-actions.pod:308 ../src/guestfs-actions.pod:448 msgid "C = 2" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:264 ../src/guestfs-actions.pod:403 +#: ../fish/guestfish-actions.pod:310 ../src/guestfs-actions.pod:450 msgid "" "Save changes into a file with extension C<.augnew>, and do not overwrite " "original. Overrides C." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:267 ../src/guestfs-actions.pod:406 +#: ../fish/guestfish-actions.pod:313 ../src/guestfs-actions.pod:453 msgid "C = 4" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:269 ../src/guestfs-actions.pod:408 +#: ../fish/guestfish-actions.pod:315 ../src/guestfs-actions.pod:455 msgid "Typecheck lenses." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:271 +#: ../fish/guestfish-actions.pod:317 msgid "" "This option is only useful when debugging Augeas lenses. Use of this option " "may require additional memory for the libguestfs appliance. You may need to " @@ -6273,52 +7174,52 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:276 ../src/guestfs-actions.pod:415 +#: ../fish/guestfish-actions.pod:322 ../src/guestfs-actions.pod:462 msgid "C = 8" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:278 ../src/guestfs-actions.pod:417 +#: ../fish/guestfish-actions.pod:324 ../src/guestfs-actions.pod:464 msgid "Do not use standard load path for modules." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:280 ../src/guestfs-actions.pod:419 +#: ../fish/guestfish-actions.pod:326 ../src/guestfs-actions.pod:466 msgid "C = 16" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:282 ../src/guestfs-actions.pod:421 +#: ../fish/guestfish-actions.pod:328 ../src/guestfs-actions.pod:468 msgid "Make save a no-op, just record what would have been changed." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:284 ../src/guestfs-actions.pod:423 +#: ../fish/guestfish-actions.pod:330 ../src/guestfs-actions.pod:470 msgid "C = 32" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:286 +#: ../fish/guestfish-actions.pod:332 msgid "Do not load the tree in L." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:290 +#: ../fish/guestfish-actions.pod:336 msgid "To close the handle, you can call L." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:292 ../src/guestfs-actions.pod:431 +#: ../fish/guestfish-actions.pod:338 ../src/guestfs-actions.pod:478 msgid "To find out more about Augeas, see L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:294 +#: ../fish/guestfish-actions.pod:340 msgid "aug-insert" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:296 +#: ../fish/guestfish-actions.pod:342 #, no-wrap msgid "" " aug-insert augpath label true|false\n" @@ -6326,26 +7227,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:298 ../src/guestfs-actions.pod:445 +#: ../fish/guestfish-actions.pod:344 ../src/guestfs-actions.pod:492 msgid "" "Create a new sibling C