1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Red Hat Inc.
3 # This file is distributed under the same license as the libguestfs package.
5 # rjones <rjones@redhat.com>, 2011.
8 "Project-Id-Version: libguestfs\n"
9 "Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
10 "POT-Creation-Date: 2011-10-08 13:55+0200\n"
11 "PO-Revision-Date: 2011-07-17 20:50+0000\n"
12 "Last-Translator: rjones <rjones@redhat.com>\n"
13 "Language-Team: Japanese (http://www.transifex.net/projects/p/fedora/team/"
17 "Content-Type: text/plain; charset=UTF-8\n"
18 "Content-Transfer-Encoding: 8bit\n"
19 "Plural-Forms: nplurals=1; plural=0\n"
22 #: ../align/virt-alignment-scan.pod:3 ../cat/virt-cat.pod:3
23 #: ../cat/virt-filesystems.pod:3 ../cat/virt-ls.pod:3
24 #: ../clone/virt-sysprep.pod:3 ../df/virt-df.pod:3 ../edit/virt-edit.pod:3
25 #: ../erlang/examples/guestfs-erlang.pod:3 ../examples/guestfs-examples.pod:3
26 #: ../examples/guestfs-recipes.pod:14 ../fish/guestfish.pod:3
27 #: ../fish/virt-copy-in.pod:3 ../fish/virt-copy-out.pod:3
28 #: ../fish/virt-tar-in.pod:3 ../fish/virt-tar-out.pod:3
29 #: ../fuse/guestmount.pod:3 ../inspector/virt-inspector.pod:3
30 #: ../java/examples/guestfs-java.pod:3 ../ocaml/examples/guestfs-ocaml.pod:3
31 #: ../perl/examples/guestfs-perl.pod:3 ../python/examples/guestfs-python.pod:3
32 #: ../rescue/virt-rescue.pod:3 ../resize/virt-resize.pod:3
33 #: ../ruby/examples/guestfs-ruby.pod:3 ../sparsify/virt-sparsify.pod:3
34 #: ../src/guestfs.pod:3 ../test-tool/libguestfs-test-tool.pod:3
35 #: ../tools/virt-list-filesystems.pl:30 ../tools/virt-list-partitions.pl:30
36 #: ../tools/virt-make-fs.pl:35 ../tools/virt-tar.pl:31
37 #: ../tools/virt-win-reg.pl:35
42 #: ../align/virt-alignment-scan.pod:5
43 msgid "virt-alignment-scan - Check alignment of virtual machine partitions"
47 #: ../align/virt-alignment-scan.pod:7 ../cat/virt-cat.pod:7
48 #: ../cat/virt-filesystems.pod:7 ../cat/virt-ls.pod:7
49 #: ../clone/virt-sysprep.pod:7 ../df/virt-df.pod:7 ../edit/virt-edit.pod:7
50 #: ../erlang/examples/guestfs-erlang.pod:7 ../examples/guestfs-examples.pod:7
51 #: ../fish/guestfish.pod:7 ../fish/virt-copy-in.pod:7
52 #: ../fish/virt-copy-out.pod:7 ../fish/virt-tar-in.pod:7
53 #: ../fish/virt-tar-out.pod:7 ../fuse/guestmount.pod:7
54 #: ../inspector/virt-inspector.pod:7 ../java/examples/guestfs-java.pod:7
55 #: ../ocaml/examples/guestfs-ocaml.pod:7 ../perl/examples/guestfs-perl.pod:7
56 #: ../python/examples/guestfs-python.pod:7 ../rescue/virt-rescue.pod:7
57 #: ../resize/virt-resize.pod:7 ../ruby/examples/guestfs-ruby.pod:7
58 #: ../sparsify/virt-sparsify.pod:7 ../src/guestfs.pod:7
59 #: ../test-tool/libguestfs-test-tool.pod:7
60 #: ../tools/virt-list-filesystems.pl:34 ../tools/virt-list-partitions.pl:34
61 #: ../tools/virt-make-fs.pl:39 ../tools/virt-tar.pl:35
62 #: ../tools/virt-win-reg.pl:39
67 #: ../align/virt-alignment-scan.pod:9
70 " virt-alignment-scan [--options] -d domname\n"
75 #: ../align/virt-alignment-scan.pod:11
78 " virt-alignment-scan [--options] -a disk.img [-a disk.img ...]\n"
83 #: ../align/virt-alignment-scan.pod:13 ../cat/virt-cat.pod:19
84 #: ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19
85 #: ../clone/virt-sysprep.pod:13 ../df/virt-df.pod:21 ../edit/virt-edit.pod:27
86 #: ../erlang/examples/guestfs-erlang.pod:16
87 #: ../examples/guestfs-examples.pod:19 ../examples/guestfs-recipes.pod:18
88 #: ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19
89 #: ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21
90 #: ../fish/virt-tar-out.pod:15 ../fuse/guestmount.pod:20
91 #: ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15
92 #: ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:18
93 #: ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:29
94 #: ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15
95 #: ../sparsify/virt-sparsify.pod:11 ../src/guestfs.pod:23
96 #: ../test-tool/libguestfs-test-tool.pod:11
97 #: ../tools/virt-list-filesystems.pl:40 ../tools/virt-list-partitions.pl:40
98 #: ../tools/virt-make-fs.pl:47 ../tools/virt-tar.pl:77
99 #: ../tools/virt-win-reg.pl:63
104 #: ../align/virt-alignment-scan.pod:15
106 "When older operating systems install themselves, the partitioning tools "
107 "place partitions at a sector misaligned with the underlying storage "
108 "(commonly the first partition starts on sector C<63>). Misaligned "
109 "partitions can result in an operating system issuing more I/O than should be "
114 #: ../align/virt-alignment-scan.pod:21
116 "The virt-alignment-scan tool checks the alignment of partitions in virtual "
117 "machines and disk images and warns you if there are alignment problems."
121 #: ../align/virt-alignment-scan.pod:25
123 "Currently there is no virt tool for fixing alignment problems. You can only "
124 "reinstall the guest operating system. The following NetApp document "
125 "summarises the problem and possible solutions: L<http://media.netapp.com/"
126 "documents/tr-3747.pdf>"
130 #: ../align/virt-alignment-scan.pod:30
135 #: ../align/virt-alignment-scan.pod:32
136 msgid "To run this tool on a disk image directly, use the I<-a> option:"
140 #: ../align/virt-alignment-scan.pod:34
143 " $ virt-alignment-scan -a winxp.img\n"
144 " /dev/sda1 32256 512 bad (alignment < 4K)\n"
149 #: ../align/virt-alignment-scan.pod:37
152 " $ virt-alignment-scan -a fedora16.img\n"
153 " /dev/sda1 1048576 1024K ok\n"
154 " /dev/sda2 2097152 2048K ok\n"
155 " /dev/sda3 526385152 2048K ok\n"
160 #: ../align/virt-alignment-scan.pod:42
162 "To run the tool on a guest known to libvirt, use the I<-d> option and "
163 "possibly the I<-c> option:"
167 #: ../align/virt-alignment-scan.pod:45
170 " # virt-alignment-scan -d RHEL5\n"
171 " /dev/sda1 32256 512 bad (alignment < 4K)\n"
172 " /dev/sda2 106928640 512 bad (alignment < 4K)\n"
177 #: ../align/virt-alignment-scan.pod:49
180 " $ virt-alignment-scan -c qemu:///system -d Win7TwoDisks\n"
181 " /dev/sda1 1048576 1024K ok\n"
182 " /dev/sda2 105906176 1024K ok\n"
183 " /dev/sdb1 65536 64K ok\n"
188 #: ../align/virt-alignment-scan.pod:54
190 "The output consists of 4 or more whitespace-separated columns. Only the "
191 "first 4 columns are signficant if you want to parse this from a program. "
196 #: ../align/virt-alignment-scan.pod:60
201 #: ../align/virt-alignment-scan.pod:62
203 "the device and partition name (eg. C</dev/sda1> meaning the first partition "
204 "on the first block device)"
208 #: ../align/virt-alignment-scan.pod:65
213 #: ../align/virt-alignment-scan.pod:67
214 msgid "the start of the partition in bytes"
218 #: ../align/virt-alignment-scan.pod:69
223 #: ../align/virt-alignment-scan.pod:71
224 msgid "the alignment in bytes or Kbytes (eg. C<512> or C<4K>)"
228 #: ../align/virt-alignment-scan.pod:73
233 #: ../align/virt-alignment-scan.pod:75
235 "C<ok> if the alignment is best for performance, or C<bad> if the alignment "
236 "can cause performance problems"
240 #: ../align/virt-alignment-scan.pod:78
245 #: ../align/virt-alignment-scan.pod:80
246 msgid "optional free-text explanation."
250 #: ../align/virt-alignment-scan.pod:84
252 "The exit code from the program changes depending on whether poorly aligned "
253 "partitions were found. See L</EXIT STATUS> below."
257 #: ../align/virt-alignment-scan.pod:87
258 msgid "If you just want the exit code with no output, use the I<-q> option."
262 #: ../align/virt-alignment-scan.pod:89 ../cat/virt-cat.pod:62
263 #: ../cat/virt-filesystems.pod:91 ../cat/virt-ls.pod:261
264 #: ../clone/virt-sysprep.pod:36 ../df/virt-df.pod:59 ../edit/virt-edit.pod:62
265 #: ../fish/guestfish.pod:148 ../fish/virt-copy-in.pod:45
266 #: ../fish/virt-copy-out.pod:34 ../fish/virt-tar-in.pod:42
267 #: ../fish/virt-tar-out.pod:36 ../fuse/guestmount.pod:83
268 #: ../inspector/virt-inspector.pod:55 ../rescue/virt-rescue.pod:84
269 #: ../resize/virt-resize.pod:241 ../sparsify/virt-sparsify.pod:99
270 #: ../test-tool/libguestfs-test-tool.pod:36
271 #: ../tools/virt-list-filesystems.pl:53 ../tools/virt-list-partitions.pl:54
272 #: ../tools/virt-make-fs.pl:153 ../tools/virt-tar.pl:103
273 #: ../tools/virt-win-reg.pl:96
278 #: ../align/virt-alignment-scan.pod:93 ../cat/virt-cat.pod:66
279 #: ../cat/virt-filesystems.pod:95 ../cat/virt-ls.pod:265
280 #: ../clone/virt-sysprep.pod:40 ../df/virt-df.pod:63 ../edit/virt-edit.pod:66
281 #: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:151
282 #: ../inspector/virt-inspector.pod:59 ../rescue/virt-rescue.pod:88
283 #: ../resize/virt-resize.pod:245 ../sparsify/virt-sparsify.pod:103
284 #: ../test-tool/libguestfs-test-tool.pod:40
285 #: ../tools/virt-list-filesystems.pl:61 ../tools/virt-list-partitions.pl:62
286 #: ../tools/virt-make-fs.pl:161 ../tools/virt-tar.pl:111
287 #: ../tools/virt-win-reg.pl:104
292 #: ../align/virt-alignment-scan.pod:95 ../cat/virt-cat.pod:68
293 #: ../cat/virt-filesystems.pod:97 ../cat/virt-ls.pod:267
294 #: ../clone/virt-sysprep.pod:42 ../df/virt-df.pod:65 ../edit/virt-edit.pod:68
295 #: ../inspector/virt-inspector.pod:61 ../rescue/virt-rescue.pod:90
296 #: ../tools/virt-list-filesystems.pl:63 ../tools/virt-list-partitions.pl:64
297 #: ../tools/virt-make-fs.pl:163 ../tools/virt-tar.pl:113
298 #: ../tools/virt-win-reg.pl:106
299 msgid "Display brief help."
303 #: ../align/virt-alignment-scan.pod:97 ../cat/virt-cat.pod:70
304 #: ../cat/virt-filesystems.pod:99 ../cat/virt-ls.pod:269
305 #: ../clone/virt-sysprep.pod:44 ../df/virt-df.pod:67 ../edit/virt-edit.pod:70
306 #: ../inspector/virt-inspector.pod:63 ../rescue/virt-rescue.pod:92
311 #: ../align/virt-alignment-scan.pod:99 ../cat/virt-cat.pod:72
312 #: ../cat/virt-filesystems.pod:101 ../cat/virt-ls.pod:271
313 #: ../clone/virt-sysprep.pod:46 ../df/virt-df.pod:69 ../edit/virt-edit.pod:72
314 #: ../inspector/virt-inspector.pod:65 ../rescue/virt-rescue.pod:94
315 msgid "B<--add> file"
319 #: ../align/virt-alignment-scan.pod:101 ../clone/virt-sysprep.pod:48
320 msgid "Add I<file> which should be a disk image from a virtual machine."
324 #: ../align/virt-alignment-scan.pod:103 ../cat/virt-cat.pod:78
325 #: ../cat/virt-filesystems.pod:107 ../cat/virt-ls.pod:277
326 #: ../clone/virt-sysprep.pod:50 ../df/virt-df.pod:75 ../edit/virt-edit.pod:78
327 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:93
328 #: ../inspector/virt-inspector.pod:71 ../rescue/virt-rescue.pod:100
330 "The format of the disk image is auto-detected. To override this and force a "
331 "particular format use the I<--format=..> option."
335 #: ../align/virt-alignment-scan.pod:106 ../cat/virt-cat.pod:81
336 #: ../cat/virt-filesystems.pod:125 ../cat/virt-ls.pod:291
337 #: ../clone/virt-sysprep.pod:53 ../df/virt-df.pod:78
338 #: ../rescue/virt-rescue.pod:107
343 #: ../align/virt-alignment-scan.pod:108 ../cat/virt-cat.pod:83
344 #: ../cat/virt-filesystems.pod:127 ../cat/virt-ls.pod:293
345 #: ../clone/virt-sysprep.pod:55 ../df/virt-df.pod:80
346 #: ../rescue/virt-rescue.pod:109
347 msgid "B<--connect> URI"
351 #: ../align/virt-alignment-scan.pod:110 ../cat/virt-cat.pod:85
352 #: ../cat/virt-filesystems.pod:129 ../cat/virt-ls.pod:295
353 #: ../clone/virt-sysprep.pod:57 ../df/virt-df.pod:82 ../edit/virt-edit.pod:99
354 #: ../inspector/virt-inspector.pod:78 ../rescue/virt-rescue.pod:111
355 #: ../tools/virt-list-filesystems.pl:81 ../tools/virt-list-partitions.pl:82
356 #: ../tools/virt-tar.pl:131 ../tools/virt-win-reg.pl:132
358 "If using libvirt, connect to the given I<URI>. If omitted, then we connect "
359 "to the default libvirt hypervisor."
363 #: ../align/virt-alignment-scan.pod:113 ../cat/virt-cat.pod:88
364 #: ../cat/virt-filesystems.pod:132 ../cat/virt-ls.pod:298
365 #: ../clone/virt-sysprep.pod:60 ../df/virt-df.pod:85
366 #: ../rescue/virt-rescue.pod:114
368 "If you specify guest block devices directly (I<-a>), then libvirt is not "
373 #: ../align/virt-alignment-scan.pod:116 ../cat/virt-cat.pod:91
374 #: ../cat/virt-filesystems.pod:141 ../cat/virt-ls.pod:307
375 #: ../clone/virt-sysprep.pod:63 ../df/virt-df.pod:94 ../edit/virt-edit.pod:105
376 #: ../inspector/virt-inspector.pod:85 ../rescue/virt-rescue.pod:117
381 #: ../align/virt-alignment-scan.pod:118 ../cat/virt-cat.pod:93
382 #: ../cat/virt-filesystems.pod:143 ../cat/virt-ls.pod:309
383 #: ../clone/virt-sysprep.pod:65 ../df/virt-df.pod:96 ../edit/virt-edit.pod:107
384 #: ../inspector/virt-inspector.pod:87 ../rescue/virt-rescue.pod:119
385 msgid "B<--domain> guest"
389 #: ../align/virt-alignment-scan.pod:120 ../cat/virt-cat.pod:95
390 #: ../cat/virt-filesystems.pod:145 ../cat/virt-ls.pod:311
391 #: ../clone/virt-sysprep.pod:67 ../df/virt-df.pod:98 ../edit/virt-edit.pod:109
392 #: ../inspector/virt-inspector.pod:89 ../rescue/virt-rescue.pod:121
394 "Add all the disks from the named libvirt guest. Domain UUIDs can be used "
399 #: ../align/virt-alignment-scan.pod:123 ../cat/virt-cat.pod:105
400 #: ../cat/virt-filesystems.pod:170 ../cat/virt-ls.pod:328
401 #: ../clone/virt-sysprep.pod:89 ../df/virt-df.pod:101
402 #: ../fish/guestfish.pod:233 ../fuse/guestmount.pod:133
403 #: ../inspector/virt-inspector.pod:99 ../rescue/virt-rescue.pod:124
404 msgid "B<--format=raw|qcow2|..>"
408 #: ../align/virt-alignment-scan.pod:125 ../cat/virt-cat.pod:107
409 #: ../cat/virt-filesystems.pod:172 ../cat/virt-ls.pod:330
410 #: ../clone/virt-sysprep.pod:91 ../df/virt-df.pod:103
411 #: ../edit/virt-edit.pod:134 ../fish/guestfish.pod:235
412 #: ../fuse/guestmount.pod:135 ../inspector/virt-inspector.pod:101
413 #: ../rescue/virt-rescue.pod:126
418 #: ../align/virt-alignment-scan.pod:127 ../cat/virt-cat.pod:109
419 #: ../cat/virt-filesystems.pod:174 ../cat/virt-ls.pod:332
420 #: ../clone/virt-sysprep.pod:93 ../df/virt-df.pod:105
421 #: ../edit/virt-edit.pod:136 ../fish/guestfish.pod:237
422 #: ../fuse/guestmount.pod:137 ../rescue/virt-rescue.pod:128
424 "The default for the I<-a> option is to auto-detect the format of the disk "
425 "image. Using this forces the disk format for I<-a> options which follow on "
426 "the command line. Using I<--format> with no argument switches back to auto-"
427 "detection for subsequent I<-a> options."
431 #: ../align/virt-alignment-scan.pod:132 ../cat/virt-cat.pod:114
432 #: ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337
433 #: ../clone/virt-sysprep.pod:98 ../df/virt-df.pod:110
434 #: ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242
435 #: ../fish/guestfish.pod:673 ../inspector/virt-inspector.pod:336
436 #: ../rescue/virt-rescue.pod:133 ../src/guestfs.pod:2791
441 #: ../align/virt-alignment-scan.pod:134
444 " virt-alignment-scan --format=raw -a disk.img\n"
449 #: ../align/virt-alignment-scan.pod:136 ../cat/virt-cat.pod:118
450 #: ../cat/virt-filesystems.pod:183 ../cat/virt-ls.pod:341
451 #: ../clone/virt-sysprep.pod:102 ../df/virt-df.pod:114
452 #: ../edit/virt-edit.pod:145 ../fish/guestfish.pod:246
453 #: ../rescue/virt-rescue.pod:137
454 msgid "forces raw format (no auto-detection) for C<disk.img>."
458 #: ../align/virt-alignment-scan.pod:138
461 " virt-alignment-scan --format=raw -a disk.img --format -a another.img\n"
466 #: ../align/virt-alignment-scan.pod:140 ../cat/virt-cat.pod:122
467 #: ../cat/virt-filesystems.pod:187 ../cat/virt-ls.pod:345
468 #: ../clone/virt-sysprep.pod:106 ../df/virt-df.pod:118
469 #: ../edit/virt-edit.pod:149 ../fish/guestfish.pod:250
470 #: ../rescue/virt-rescue.pod:141
472 "forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
473 "detection for C<another.img>."
477 #: ../align/virt-alignment-scan.pod:143 ../cat/virt-cat.pod:125
478 #: ../cat/virt-filesystems.pod:190 ../cat/virt-ls.pod:348
479 #: ../clone/virt-sysprep.pod:109 ../df/virt-df.pod:121
480 #: ../edit/virt-edit.pod:152 ../rescue/virt-rescue.pod:144
482 "If you have untrusted raw-format guest disk images, you should use this "
483 "option to specify the disk format. This avoids a possible security problem "
484 "with malicious guests (CVE-2010-3851)."
488 #: ../align/virt-alignment-scan.pod:147 ../resize/virt-resize.pod:414
489 #: ../sparsify/virt-sparsify.pod:153
494 #: ../align/virt-alignment-scan.pod:149 ../resize/virt-resize.pod:416
495 #: ../sparsify/virt-sparsify.pod:155
500 #: ../align/virt-alignment-scan.pod:151
502 "Don't produce any output. Just set the exit code (see L</EXIT STATUS> "
507 #: ../align/virt-alignment-scan.pod:154 ../cat/virt-cat.pod:134
508 #: ../cat/virt-filesystems.pod:261 ../cat/virt-ls.pod:425
509 #: ../clone/virt-sysprep.pod:122 ../df/virt-df.pod:173
510 #: ../edit/virt-edit.pod:161 ../fish/guestfish.pod:390
511 #: ../fuse/guestmount.pod:257 ../inspector/virt-inspector.pod:119
512 #: ../rescue/virt-rescue.pod:182 ../sparsify/virt-sparsify.pod:159
517 #: ../align/virt-alignment-scan.pod:156 ../cat/virt-cat.pod:136
518 #: ../cat/virt-filesystems.pod:263 ../cat/virt-ls.pod:427
519 #: ../clone/virt-sysprep.pod:124 ../df/virt-df.pod:175
520 #: ../edit/virt-edit.pod:163 ../fish/guestfish.pod:392
521 #: ../fuse/guestmount.pod:259 ../inspector/virt-inspector.pod:121
522 #: ../rescue/virt-rescue.pod:184 ../sparsify/virt-sparsify.pod:161
527 #: ../align/virt-alignment-scan.pod:158 ../cat/virt-cat.pod:138
528 #: ../cat/virt-filesystems.pod:265 ../cat/virt-ls.pod:429
529 #: ../clone/virt-sysprep.pod:126 ../df/virt-df.pod:177
530 #: ../edit/virt-edit.pod:165 ../inspector/virt-inspector.pod:123
531 #: ../rescue/virt-rescue.pod:186 ../sparsify/virt-sparsify.pod:163
532 msgid "Enable verbose messages for debugging."
536 #: ../align/virt-alignment-scan.pod:160 ../cat/virt-cat.pod:140
537 #: ../cat/virt-filesystems.pod:267 ../cat/virt-ls.pod:431
538 #: ../clone/virt-sysprep.pod:128 ../df/virt-df.pod:179
539 #: ../edit/virt-edit.pod:167 ../fish/guestfish.pod:397
540 #: ../fuse/guestmount.pod:263 ../inspector/virt-inspector.pod:125
541 #: ../rescue/virt-rescue.pod:188 ../resize/virt-resize.pod:484
542 #: ../sparsify/virt-sparsify.pod:165
547 #: ../align/virt-alignment-scan.pod:162 ../cat/virt-cat.pod:142
548 #: ../cat/virt-filesystems.pod:269 ../cat/virt-ls.pod:433
549 #: ../clone/virt-sysprep.pod:130 ../df/virt-df.pod:181
550 #: ../edit/virt-edit.pod:169 ../fish/guestfish.pod:399
551 #: ../fuse/guestmount.pod:265 ../inspector/virt-inspector.pod:127
552 #: ../rescue/virt-rescue.pod:190 ../resize/virt-resize.pod:486
553 #: ../sparsify/virt-sparsify.pod:167 ../tools/virt-list-filesystems.pl:69
554 #: ../tools/virt-list-partitions.pl:70 ../tools/virt-make-fs.pl:169
555 #: ../tools/virt-tar.pl:119 ../tools/virt-win-reg.pl:112
560 #: ../align/virt-alignment-scan.pod:164 ../cat/virt-cat.pod:144
561 #: ../cat/virt-filesystems.pod:271 ../cat/virt-ls.pod:435
562 #: ../clone/virt-sysprep.pod:132 ../df/virt-df.pod:183
563 #: ../edit/virt-edit.pod:171 ../inspector/virt-inspector.pod:129
564 #: ../rescue/virt-rescue.pod:192 ../resize/virt-resize.pod:488
565 #: ../sparsify/virt-sparsify.pod:169 ../tools/virt-list-filesystems.pl:71
566 #: ../tools/virt-list-partitions.pl:72 ../tools/virt-make-fs.pl:171
567 #: ../tools/virt-tar.pl:121 ../tools/virt-win-reg.pl:114
568 msgid "Display version number and exit."
572 #: ../align/virt-alignment-scan.pod:166 ../cat/virt-cat.pod:146
573 #: ../cat/virt-filesystems.pod:281 ../cat/virt-ls.pod:437
574 #: ../clone/virt-sysprep.pod:134 ../df/virt-df.pod:185
575 #: ../edit/virt-edit.pod:173 ../fish/guestfish.pod:412
576 #: ../fuse/guestmount.pod:278 ../inspector/virt-inspector.pod:131
577 #: ../rescue/virt-rescue.pod:203 ../sparsify/virt-sparsify.pod:171
578 #: ../tools/virt-tar.pl:158
583 #: ../align/virt-alignment-scan.pod:168 ../cat/virt-cat.pod:148
584 #: ../cat/virt-filesystems.pod:283 ../cat/virt-ls.pod:439
585 #: ../clone/virt-sysprep.pod:136 ../df/virt-df.pod:187
586 #: ../edit/virt-edit.pod:175 ../inspector/virt-inspector.pod:133
587 #: ../rescue/virt-rescue.pod:205 ../sparsify/virt-sparsify.pod:173
588 msgid "Enable tracing of libguestfs API calls."
592 #: ../align/virt-alignment-scan.pod:172
593 msgid "RECOMMENDED ALIGNMENT"
597 #: ../align/virt-alignment-scan.pod:174
599 "Operating systems older than Windows 2008 and Linux before ca.2010 place the "
600 "first sector of the first partition at sector 63, with a 512 byte sector "
601 "size. This happens because of a historical accident. Drives have to report "
602 "a cylinder / head / sector (CHS) geometry to the BIOS. The geometry is "
603 "completely meaningless on modern drives, but it happens that the geometry "
604 "reported always has 63 sectors per track. The operating system therefore "
605 "places the first partition at the start of the second \"track\", at sector "
610 #: ../align/virt-alignment-scan.pod:183
612 "When the guest OS is virtualized, the host operating system and hypervisor "
613 "may prefer accesses aligned to one of:"
617 #: ../align/virt-alignment-scan.pod:188
622 #: ../align/virt-alignment-scan.pod:190
624 "if the host OS uses local storage directly on hard drive partitions, and the "
625 "hard drive has 512 byte physical sectors."
629 #: ../align/virt-alignment-scan.pod:193
634 #: ../align/virt-alignment-scan.pod:195
636 "for local storage on new hard drives with 4Kbyte physical sectors; for file-"
637 "backed storage on filesystems with 4Kbyte block size; or for some types of "
638 "network-attached storage."
642 #: ../align/virt-alignment-scan.pod:199
647 #: ../align/virt-alignment-scan.pod:201
649 "for high-end network-attached storage. This is the optimal block size for "
650 "some NetApp hardware."
654 #: ../align/virt-alignment-scan.pod:204
659 #: ../align/virt-alignment-scan.pod:206
660 msgid "see L</1 MB PARTITION ALIGNMENT> below."
664 #: ../align/virt-alignment-scan.pod:210
666 "Partitions which are not aligned correctly to the underlying storage cause "
667 "extra I/O. For example:"
671 #: ../align/virt-alignment-scan.pod:213
675 " +--------------------------+------\n"
677 " | filesystem block |\n"
678 " ---+------------------+------+-------------------+-----+---\n"
679 " | host block | host block |\n"
681 " ---+-------------------------+-------------------------+---\n"
686 #: ../align/virt-alignment-scan.pod:222
688 "In this example, each time a 4K guest block is read, two blocks on the host "
689 "must be accessed (so twice as much I/O is done). When a 4K guest block is "
690 "written, two host blocks must first be read, the old and new data combined, "
691 "and the two blocks written back (4x I/O)."
695 #: ../align/virt-alignment-scan.pod:227
696 msgid "LINUX HOST BLOCK AND I/O SIZE"
700 #: ../align/virt-alignment-scan.pod:229
702 "New versions of the Linux kernel expose the physical and logical block size, "
703 "and minimum and recommended I/O size."
707 #: ../align/virt-alignment-scan.pod:232
708 msgid "For a typical hard drive with 512 byte sectors:"
712 #: ../align/virt-alignment-scan.pod:234
715 " $ cat /sys/block/sda/queue/physical_block_size\n"
717 " $ cat /sys/block/sda/queue/logical_block_size\n"
719 " $ cat /sys/block/sda/queue/minimum_io_size\n"
721 " $ cat /sys/block/sda/queue/optimal_io_size\n"
727 #: ../align/virt-alignment-scan.pod:243
728 msgid "For a NetApp LUN:"
732 #: ../align/virt-alignment-scan.pod:245
735 " $ cat /sys/block/sdc/queue/logical_block_size\n"
737 " $ cat /sys/block/sdc/queue/physical_block_size\n"
739 " $ cat /sys/block/sdc/queue/minimum_io_size\n"
741 " $ cat /sys/block/sdc/queue/optimal_io_size\n"
747 #: ../align/virt-alignment-scan.pod:254
749 "The NetApp allows 512 byte accesses (but they will be very inefficient), "
750 "prefers a minimum 4K I/O size, but the optimal I/O size is 64K."
754 #: ../align/virt-alignment-scan.pod:258
756 "For detailed information about what these numbers mean, see L<http://docs."
757 "redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/"
758 "Storage_Administration_Guide/newstorage-iolimits.html>"
762 #: ../align/virt-alignment-scan.pod:261
764 "[Thanks to Mike Snitzer for providing NetApp data and additional "
769 #: ../align/virt-alignment-scan.pod:264
770 msgid "1 MB PARTITION ALIGNMENT"
774 #: ../align/virt-alignment-scan.pod:266
776 "Microsoft picked 1 MB as the default alignment for all partitions starting "
777 "with Windows 2008 Server, and Linux has followed this."
781 #: ../align/virt-alignment-scan.pod:269
783 "Assuming 512 byte sectors in the guest, you will now see the first partition "
784 "starting at sector 2048, and subsequent partitions (if any) will start at a "
785 "multiple of 2048 sectors."
789 #: ../align/virt-alignment-scan.pod:273
791 "1 MB alignment is compatible with all current alignment requirements (4K, "
792 "64K) and provides room for future growth in physical block sizes."
796 #: ../align/virt-alignment-scan.pod:276
797 msgid "SETTING ALIGNMENT"
801 #: ../align/virt-alignment-scan.pod:278
803 "Currently there is no virt tool for fixing alignment problems in guests. "
804 "This is a difficult problem to fix because simply moving partitions around "
805 "breaks the bootloader, necessitating either manual reinstallation of the "
806 "bootloader using a rescue disk, or complex and error-prone hacks."
810 #: ../align/virt-alignment-scan.pod:284
812 "L<virt-resize(1)> does not change the alignment of the first partition, but "
813 "it does align the second and subsequent partitions to a multiple of 64 or "
814 "128 sectors (depending on the version of virt-resize, 128 in virt-resize "
815 "E<ge> 1.13.19). For operating systems that have a separate boot partition, "
816 "virt-resize could be used to align the main OS partition, so that the "
817 "majority of OS accesses except at boot will be aligned."
821 #: ../align/virt-alignment-scan.pod:292
823 "The easiest way to correct partition alignment problems is to reinstall your "
824 "guest operating systems. If you install operating systems from templates, "
825 "ensure these have correct partition alignment too."
829 #: ../align/virt-alignment-scan.pod:297
831 "For older versions of Windows, the following NetApp document contains useful "
832 "information: L<http://media.netapp.com/documents/tr-3747.pdf>"
836 #: ../align/virt-alignment-scan.pod:300
838 "For Red Hat Enterprise Linux E<le> 5, use a Kickstart script that contains "
839 "an explicit C<%pre> section that creates aligned partitions using L<parted(8)"
840 ">. Do not use the Kickstart C<part> command. The NetApp document above "
841 "contains an example."
845 #: ../align/virt-alignment-scan.pod:305 ../cat/virt-cat.pod:191
846 #: ../cat/virt-filesystems.pod:365 ../cat/virt-ls.pod:483
847 #: ../clone/virt-sysprep.pod:359 ../df/virt-df.pod:215
848 #: ../edit/virt-edit.pod:342 ../inspector/virt-inspector.pod:352
849 #: ../rescue/virt-rescue.pod:266 ../resize/virt-resize.pod:601
850 #: ../tools/virt-list-filesystems.pl:188 ../tools/virt-list-partitions.pl:258
851 #: ../tools/virt-make-fs.pl:532 ../tools/virt-tar.pl:289
852 #: ../tools/virt-win-reg.pl:733
853 msgid "SHELL QUOTING"
857 #: ../align/virt-alignment-scan.pod:307 ../cat/virt-cat.pod:193
858 #: ../cat/virt-filesystems.pod:367 ../cat/virt-ls.pod:485
859 #: ../clone/virt-sysprep.pod:361 ../df/virt-df.pod:217
860 #: ../edit/virt-edit.pod:344 ../inspector/virt-inspector.pod:354
861 #: ../rescue/virt-rescue.pod:268 ../resize/virt-resize.pod:603
862 #: ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260
863 #: ../tools/virt-make-fs.pl:534 ../tools/virt-tar.pl:291
864 #: ../tools/virt-win-reg.pl:741
866 "Libvirt guest names can contain arbitrary characters, some of which have "
867 "meaning to the shell such as C<#> and space. You may need to quote or "
868 "escape these characters on the command line. See the shell manual page L<sh"
873 #: ../align/virt-alignment-scan.pod:312 ../cat/virt-cat.pod:198
874 #: ../cat/virt-filesystems.pod:372 ../cat/virt-ls.pod:490
875 #: ../clone/virt-sysprep.pod:366 ../df/virt-df.pod:222
876 #: ../edit/virt-edit.pod:349 ../fish/guestfish.pod:1113
877 #: ../fuse/guestmount.pod:303 ../inspector/virt-inspector.pod:375
878 #: ../resize/virt-resize.pod:608 ../sparsify/virt-sparsify.pod:227
879 #: ../test-tool/libguestfs-test-tool.pod:90
884 #: ../align/virt-alignment-scan.pod:314
885 msgid "This program returns:"
889 #: ../align/virt-alignment-scan.pod:318 ../align/virt-alignment-scan.pod:324
890 #: ../align/virt-alignment-scan.pod:330 ../align/virt-alignment-scan.pod:337
891 #: ../clone/virt-sysprep.pod:213 ../clone/virt-sysprep.pod:217
892 #: ../clone/virt-sysprep.pod:221 ../clone/virt-sysprep.pod:225
893 #: ../clone/virt-sysprep.pod:240 ../clone/virt-sysprep.pod:244
894 #: ../clone/virt-sysprep.pod:248 ../clone/virt-sysprep.pod:252
895 #: ../clone/virt-sysprep.pod:256 ../clone/virt-sysprep.pod:292
896 #: ../clone/virt-sysprep.pod:314 ../clone/virt-sysprep.pod:318
897 #: ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266
898 #: ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276
899 #: ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291
900 #: ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102
901 #: ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132
902 #: ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227
903 #: ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235
904 #: ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243
905 #: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20
906 #: ../fish/guestfish-actions.pod:390 ../fish/guestfish-actions.pod:398
907 #: ../fish/guestfish-actions.pod:405 ../fish/guestfish-actions.pod:412
908 #: ../fish/guestfish-actions.pod:1139 ../fish/guestfish-actions.pod:1143
909 #: ../fish/guestfish-actions.pod:1147 ../fish/guestfish-actions.pod:1151
910 #: ../fish/guestfish-actions.pod:1159 ../fish/guestfish-actions.pod:1163
911 #: ../fish/guestfish-actions.pod:1167 ../fish/guestfish-actions.pod:1177
912 #: ../fish/guestfish-actions.pod:1181 ../fish/guestfish-actions.pod:1185
913 #: ../fish/guestfish-actions.pod:1275 ../fish/guestfish-actions.pod:1279
914 #: ../fish/guestfish-actions.pod:1284 ../fish/guestfish-actions.pod:1289
915 #: ../fish/guestfish-actions.pod:1331 ../fish/guestfish-actions.pod:1335
916 #: ../fish/guestfish-actions.pod:1340 ../fish/guestfish-actions.pod:1596
917 #: ../fish/guestfish-actions.pod:1603 ../fish/guestfish-actions.pod:1610
918 #: ../fish/guestfish-actions.pod:2005 ../fish/guestfish-actions.pod:2011
919 #: ../fish/guestfish-actions.pod:2019 ../fish/guestfish-actions.pod:2026
920 #: ../fish/guestfish-actions.pod:2033 ../fish/guestfish.pod:445
921 #: ../fish/guestfish.pod:449 ../fish/guestfish.pod:453
922 #: ../fish/guestfish.pod:457 ../inspector/virt-inspector.pod:393
923 #: ../inspector/virt-inspector.pod:397 ../resize/virt-resize.pod:282
924 #: ../resize/virt-resize.pod:286 ../resize/virt-resize.pod:295
925 #: ../resize/virt-resize.pod:301 ../sparsify/virt-sparsify.pod:32
926 #: ../sparsify/virt-sparsify.pod:39 ../sparsify/virt-sparsify.pod:43
927 #: ../sparsify/virt-sparsify.pod:49 ../sparsify/virt-sparsify.pod:54
928 #: ../sparsify/virt-sparsify.pod:58 ../sparsify/virt-sparsify.pod:64
929 #: ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:29
930 #: ../src/guestfs-actions.pod:588 ../src/guestfs-actions.pod:596
931 #: ../src/guestfs-actions.pod:603 ../src/guestfs-actions.pod:610
932 #: ../src/guestfs-actions.pod:1778 ../src/guestfs-actions.pod:1782
933 #: ../src/guestfs-actions.pod:1786 ../src/guestfs-actions.pod:1790
934 #: ../src/guestfs-actions.pod:1798 ../src/guestfs-actions.pod:1802
935 #: ../src/guestfs-actions.pod:1806 ../src/guestfs-actions.pod:1816
936 #: ../src/guestfs-actions.pod:1820 ../src/guestfs-actions.pod:1824
937 #: ../src/guestfs-actions.pod:1962 ../src/guestfs-actions.pod:1966
938 #: ../src/guestfs-actions.pod:1971 ../src/guestfs-actions.pod:1976
939 #: ../src/guestfs-actions.pod:2037 ../src/guestfs-actions.pod:2041
940 #: ../src/guestfs-actions.pod:2046 ../src/guestfs-actions.pod:2461
941 #: ../src/guestfs-actions.pod:2468 ../src/guestfs-actions.pod:2475
942 #: ../src/guestfs-actions.pod:3012 ../src/guestfs-actions.pod:3018
943 #: ../src/guestfs-actions.pod:3026 ../src/guestfs-actions.pod:3033
944 #: ../src/guestfs-actions.pod:3040 ../src/guestfs.pod:388
945 #: ../src/guestfs.pod:393 ../src/guestfs.pod:398 ../src/guestfs.pod:402
946 #: ../src/guestfs.pod:407 ../src/guestfs.pod:411 ../src/guestfs.pod:416
947 #: ../src/guestfs.pod:421 ../src/guestfs.pod:1094 ../src/guestfs.pod:1098
948 #: ../src/guestfs.pod:1102 ../src/guestfs.pod:1107 ../src/guestfs.pod:1115
949 #: ../src/guestfs.pod:1134 ../src/guestfs.pod:1142 ../src/guestfs.pod:1164
950 #: ../src/guestfs.pod:1168 ../src/guestfs.pod:1172 ../src/guestfs.pod:1176
951 #: ../src/guestfs.pod:1180 ../src/guestfs.pod:1184 ../src/guestfs.pod:1674
952 #: ../src/guestfs.pod:1679 ../src/guestfs.pod:1683 ../src/guestfs.pod:1785
953 #: ../src/guestfs.pod:1790 ../src/guestfs.pod:1794 ../src/guestfs.pod:1804
954 #: ../src/guestfs.pod:2093 ../src/guestfs.pod:2098 ../src/guestfs.pod:2104
955 #: ../src/guestfs.pod:2112 ../src/guestfs.pod:2559 ../src/guestfs.pod:2565
956 #: ../src/guestfs.pod:2570 ../src/guestfs.pod:2576 ../src/guestfs.pod:2976
957 #: ../src/guestfs.pod:2981 ../src/guestfs.pod:2985 ../src/guestfs.pod:2989
958 #: ../src/guestfs.pod:2993 ../src/guestfs.pod:3007 ../src/guestfs.pod:3012
959 #: ../src/guestfs.pod:3242 ../src/guestfs.pod:3246 ../src/guestfs.pod:3250
960 #: ../src/guestfs.pod:3254 ../tools/virt-win-reg.pl:197
961 #: ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208
962 #: ../tools/virt-win-reg.pl:710 ../tools/virt-win-reg.pl:716
963 #: ../tools/virt-win-reg.pl:722
968 #: ../align/virt-alignment-scan.pod:320
973 #: ../align/virt-alignment-scan.pod:322
975 "successful exit, all partitions are aligned E<ge> 64K for best performance"
979 #: ../align/virt-alignment-scan.pod:326
984 #: ../align/virt-alignment-scan.pod:328
985 msgid "an error scanning the disk image or guest"
989 #: ../align/virt-alignment-scan.pod:332
994 #: ../align/virt-alignment-scan.pod:334
996 "successful exit, some partitions have alignment E<lt> 64K which can result "
997 "in poor performance on high end network storage"
1001 #: ../align/virt-alignment-scan.pod:339
1006 #: ../align/virt-alignment-scan.pod:341
1008 "successful exit, some partitions have alignment E<lt> 4K which can result in "
1009 "poor performance on most hypervisors"
1013 #: ../align/virt-alignment-scan.pod:346 ../cat/virt-cat.pod:203
1014 #: ../cat/virt-filesystems.pod:377 ../cat/virt-ls.pod:495
1015 #: ../clone/virt-sysprep.pod:370 ../df/virt-df.pod:227
1016 #: ../edit/virt-edit.pod:354 ../erlang/examples/guestfs-erlang.pod:97
1017 #: ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384
1018 #: ../fish/guestfish.pod:1267 ../fish/virt-copy-in.pod:50
1019 #: ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47
1020 #: ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:308
1021 #: ../inspector/virt-inspector.pod:380 ../java/examples/guestfs-java.pod:45
1022 #: ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39
1023 #: ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:288
1024 #: ../resize/virt-resize.pod:613 ../ruby/examples/guestfs-ruby.pod:36
1025 #: ../sparsify/virt-sparsify.pod:251 ../src/guestfs.pod:3184
1026 #: ../test-tool/libguestfs-test-tool.pod:100
1027 #: ../tools/virt-list-filesystems.pl:195 ../tools/virt-list-partitions.pl:265
1028 #: ../tools/virt-make-fs.pl:539 ../tools/virt-tar.pl:296
1029 #: ../tools/virt-win-reg.pl:746
1034 #: ../align/virt-alignment-scan.pod:348
1036 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-rescue(1)>, "
1037 "L<virt-resize(1)>, L<http://libguestfs.org/>."
1041 #: ../align/virt-alignment-scan.pod:355 ../cat/virt-cat.pod:212
1042 #: ../cat/virt-filesystems.pod:388 ../cat/virt-ls.pod:507
1043 #: ../clone/virt-sysprep.pod:384 ../df/virt-df.pod:235
1044 #: ../edit/virt-edit.pod:368 ../rescue/virt-rescue.pod:296
1045 #: ../resize/virt-resize.pod:635 ../sparsify/virt-sparsify.pod:264
1046 #: ../tools/virt-list-filesystems.pl:208 ../tools/virt-list-partitions.pl:277
1047 #: ../tools/virt-make-fs.pl:564 ../tools/virt-tar.pl:311
1048 #: ../tools/virt-win-reg.pl:772
1053 #: ../align/virt-alignment-scan.pod:357 ../cat/virt-cat.pod:214
1054 #: ../cat/virt-filesystems.pod:390 ../cat/virt-ls.pod:509
1055 #: ../clone/virt-sysprep.pod:386 ../df/virt-df.pod:237
1056 #: ../edit/virt-edit.pod:370 ../inspector/virt-inspector.pod:395
1057 #: ../rescue/virt-rescue.pod:298 ../resize/virt-resize.pod:637
1058 #: ../sparsify/virt-sparsify.pod:266 ../tools/virt-list-filesystems.pl:210
1059 #: ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:566
1060 #: ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:774
1061 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
1065 #: ../align/virt-alignment-scan.pod:359 ../cat/virt-cat.pod:216
1066 #: ../cat/virt-filesystems.pod:392 ../cat/virt-ls.pod:511
1067 #: ../clone/virt-sysprep.pod:388 ../df/virt-df.pod:239
1068 #: ../edit/virt-edit.pod:372 ../erlang/examples/guestfs-erlang.pod:114
1069 #: ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401
1070 #: ../fish/guestfish.pod:1299 ../fish/virt-copy-in.pod:64
1071 #: ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62
1072 #: ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:323
1073 #: ../inspector/virt-inspector.pod:403 ../java/examples/guestfs-java.pod:62
1074 #: ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56
1075 #: ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:300
1076 #: ../resize/virt-resize.pod:639 ../ruby/examples/guestfs-ruby.pod:52
1077 #: ../sparsify/virt-sparsify.pod:268 ../src/guestfs.pod:3265
1078 #: ../test-tool/libguestfs-test-tool.pod:110
1079 #: ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281
1080 #: ../tools/virt-make-fs.pl:568 ../tools/virt-tar.pl:315
1081 #: ../tools/virt-win-reg.pl:776
1086 #: ../align/virt-alignment-scan.pod:361 ../clone/virt-sysprep.pod:390
1087 #: ../sparsify/virt-sparsify.pod:270
1088 msgid "Copyright (C) 2011 Red Hat Inc."
1092 #: ../align/virt-alignment-scan.pod:363 ../cat/virt-cat.pod:220
1093 #: ../cat/virt-filesystems.pod:396 ../cat/virt-ls.pod:515
1094 #: ../clone/virt-sysprep.pod:392 ../df/virt-df.pod:243
1095 #: ../edit/virt-edit.pod:376 ../fish/guestfish.pod:1304
1096 #: ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58
1097 #: ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60
1098 #: ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:407
1099 #: ../rescue/virt-rescue.pod:304 ../resize/virt-resize.pod:643
1100 #: ../sparsify/virt-sparsify.pod:272 ../test-tool/libguestfs-test-tool.pod:115
1101 #: ../tools/virt-list-filesystems.pl:216 ../tools/virt-list-partitions.pl:285
1102 #: ../tools/virt-make-fs.pl:572 ../tools/virt-tar.pl:319
1103 #: ../tools/virt-win-reg.pl:780
1105 "This program is free software; you can redistribute it and/or modify it "
1106 "under the terms of the GNU General Public License as published by the Free "
1107 "Software Foundation; either version 2 of the License, or (at your option) "
1108 "any later version."
1112 #: ../align/virt-alignment-scan.pod:368 ../cat/virt-cat.pod:225
1113 #: ../cat/virt-filesystems.pod:401 ../cat/virt-ls.pod:520
1114 #: ../clone/virt-sysprep.pod:397 ../df/virt-df.pod:248
1115 #: ../edit/virt-edit.pod:381 ../fish/guestfish.pod:1309
1116 #: ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63
1117 #: ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65
1118 #: ../fuse/guestmount.pod:333 ../inspector/virt-inspector.pod:412
1119 #: ../rescue/virt-rescue.pod:309 ../resize/virt-resize.pod:648
1120 #: ../sparsify/virt-sparsify.pod:277 ../test-tool/libguestfs-test-tool.pod:120
1121 #: ../tools/virt-list-filesystems.pl:221 ../tools/virt-list-partitions.pl:290
1122 #: ../tools/virt-make-fs.pl:577 ../tools/virt-tar.pl:324
1123 #: ../tools/virt-win-reg.pl:785
1125 "This program is distributed in the hope that it will be useful, but WITHOUT "
1126 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
1127 "FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for "
1132 #: ../align/virt-alignment-scan.pod:373 ../cat/virt-cat.pod:230
1133 #: ../cat/virt-filesystems.pod:406 ../cat/virt-ls.pod:525
1134 #: ../clone/virt-sysprep.pod:402 ../df/virt-df.pod:253
1135 #: ../edit/virt-edit.pod:386 ../fish/guestfish.pod:1314
1136 #: ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68
1137 #: ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70
1138 #: ../fuse/guestmount.pod:338 ../inspector/virt-inspector.pod:417
1139 #: ../rescue/virt-rescue.pod:314 ../resize/virt-resize.pod:653
1140 #: ../sparsify/virt-sparsify.pod:282 ../test-tool/libguestfs-test-tool.pod:125
1141 #: ../tools/virt-list-filesystems.pl:226 ../tools/virt-list-partitions.pl:295
1142 #: ../tools/virt-make-fs.pl:582 ../tools/virt-tar.pl:329
1143 #: ../tools/virt-win-reg.pl:790
1145 "You should have received a copy of the GNU General Public License along with "
1146 "this program; if not, write to the Free Software Foundation, Inc., 675 Mass "
1147 "Ave, Cambridge, MA 02139, USA."
1151 #: ../cat/virt-cat.pod:5
1152 msgid "virt-cat - Display files in a virtual machine"
1156 #: ../cat/virt-cat.pod:9
1159 " virt-cat [--options] -d domname file [file ...]\n"
1164 #: ../cat/virt-cat.pod:11
1167 " virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
1172 #: ../cat/virt-cat.pod:13 ../edit/virt-edit.pod:15
1173 #: ../inspector/virt-inspector.pod:13
1178 #: ../cat/virt-cat.pod:15
1181 " virt-cat domname file\n"
1186 #: ../cat/virt-cat.pod:17
1189 " virt-cat disk.img file\n"
1194 #: ../cat/virt-cat.pod:21
1196 "C<virt-cat> is a command line tool to display the contents of C<file> where "
1197 "C<file> exists in the named virtual machine (or disk image)."
1201 #: ../cat/virt-cat.pod:24
1203 "Multiple filenames can be given, in which case they are concatenated "
1204 "together. Each filename must be a full path, starting at the root directory "
1205 "(starting with '/')."
1209 #: ../cat/virt-cat.pod:28
1211 "C<virt-cat> can be used to quickly view a file. To edit a file, use C<virt-"
1212 "edit>. For more complex cases you should look at the L<guestfish(1)> tool "
1213 "(see L</USING GUESTFISH> below)."
1217 #: ../cat/virt-cat.pod:32 ../cat/virt-ls.pod:35 ../df/virt-df.pod:43
1218 #: ../edit/virt-edit.pod:44 ../fish/guestfish.pod:41
1219 #: ../fish/guestfish.pod:1050 ../fish/virt-copy-in.pod:29
1220 #: ../fish/virt-copy-out.pod:21 ../fish/virt-tar-in.pod:30
1221 #: ../fish/virt-tar-out.pod:24 ../fuse/guestmount.pod:39
1222 #: ../resize/virt-resize.pod:27 ../sparsify/virt-sparsify.pod:75
1223 #: ../tools/virt-tar.pl:50
1228 #: ../cat/virt-cat.pod:34
1230 "Display C</etc/fstab> file from inside the libvirt VM called C<mydomain>:"
1234 #: ../cat/virt-cat.pod:37
1237 " virt-cat -d mydomain /etc/fstab\n"
1242 #: ../cat/virt-cat.pod:39
1243 msgid "List syslog messages from a VM disk image file:"
1247 #: ../cat/virt-cat.pod:41
1250 " virt-cat -a disk.img /var/log/messages | tail\n"
1255 #: ../cat/virt-cat.pod:43
1256 msgid "Find out what DHCP IP address a VM acquired:"
1260 #: ../cat/virt-cat.pod:45
1263 " virt-cat -d mydomain /var/log/messages | \\\n"
1264 " grep 'dhclient: bound to' | tail\n"
1269 #: ../cat/virt-cat.pod:48
1270 msgid "Find out what packages were recently installed:"
1274 #: ../cat/virt-cat.pod:50
1277 " virt-cat -d mydomain /var/log/yum.log | tail\n"
1282 #: ../cat/virt-cat.pod:52
1283 msgid "Find out who is logged on inside a virtual machine:"
1287 #: ../cat/virt-cat.pod:54
1290 " virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n"
1296 #: ../cat/virt-cat.pod:57
1297 msgid "or who was logged on:"
1301 #: ../cat/virt-cat.pod:59
1304 " virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n"
1305 " last -f /tmp/wtmp\n"
1310 #: ../cat/virt-cat.pod:74 ../cat/virt-filesystems.pod:103
1311 #: ../cat/virt-ls.pod:273 ../df/virt-df.pod:71 ../edit/virt-edit.pod:74
1312 #: ../inspector/virt-inspector.pod:67 ../rescue/virt-rescue.pod:96
1314 "Add I<file> which should be a disk image from a virtual machine. If the "
1315 "virtual machine has multiple block devices, you must supply all of them with "
1316 "separate I<-a> options."
1320 #: ../cat/virt-cat.pod:98 ../cat/virt-filesystems.pod:148
1321 #: ../cat/virt-ls.pod:314 ../edit/virt-edit.pod:112 ../fish/guestfish.pod:217
1322 #: ../fuse/guestmount.pod:126 ../inspector/virt-inspector.pod:92
1323 msgid "B<--echo-keys>"
1327 #: ../cat/virt-cat.pod:100
1329 "When prompting for keys and passphrases, virt-cat normally turns echoing off "
1330 "so you cannot see what you are typing. If you are not worried about Tempest "
1331 "attacks and there is no one else in the room you can specify this flag to "
1332 "see what you are typing."
1336 #: ../cat/virt-cat.pod:116
1339 " virt-cat --format=raw -a disk.img file\n"
1344 #: ../cat/virt-cat.pod:120
1347 " virt-cat --format=raw -a disk.img --format -a another.img file\n"
1352 #: ../cat/virt-cat.pod:129 ../cat/virt-filesystems.pod:200
1353 #: ../cat/virt-ls.pod:361 ../edit/virt-edit.pod:156 ../fish/guestfish.pod:289
1354 #: ../fuse/guestmount.pod:163 ../inspector/virt-inspector.pod:114
1355 msgid "B<--keys-from-stdin>"
1359 #: ../cat/virt-cat.pod:131 ../cat/virt-filesystems.pod:202
1360 #: ../cat/virt-ls.pod:363 ../edit/virt-edit.pod:158 ../fish/guestfish.pod:291
1361 #: ../fuse/guestmount.pod:165 ../inspector/virt-inspector.pod:116
1363 "Read key or passphrase parameters from stdin. The default is to try to read "
1364 "passphrases from the user by opening C</dev/tty>."
1368 #: ../cat/virt-cat.pod:152 ../cat/virt-ls.pod:443 ../edit/virt-edit.pod:179
1369 #: ../inspector/virt-inspector.pod:137 ../rescue/virt-rescue.pod:209
1370 msgid "OLD-STYLE COMMAND LINE ARGUMENTS"
1374 #: ../cat/virt-cat.pod:154
1375 msgid "Previous versions of virt-cat allowed you to write either:"
1379 #: ../cat/virt-cat.pod:156
1382 " virt-cat disk.img [disk.img ...] file\n"
1387 #: ../cat/virt-cat.pod:158 ../cat/virt-ls.pod:449 ../edit/virt-edit.pod:185
1388 #: ../inspector/virt-inspector.pod:143 ../rescue/virt-rescue.pod:215
1393 #: ../cat/virt-cat.pod:160
1396 " virt-cat guestname file\n"
1401 #: ../cat/virt-cat.pod:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189
1402 #: ../inspector/virt-inspector.pod:147 ../rescue/virt-rescue.pod:219
1404 "whereas in this version you should use I<-a> or I<-d> respectively to avoid "
1405 "the confusing case where a disk image might have the same name as a guest."
1409 #: ../cat/virt-cat.pod:166 ../cat/virt-ls.pod:457 ../edit/virt-edit.pod:193
1410 #: ../inspector/virt-inspector.pod:151 ../rescue/virt-rescue.pod:223
1411 msgid "For compatibility the old style is still supported."
1415 #: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:297
1416 msgid "USING GUESTFISH"
1420 #: ../cat/virt-cat.pod:170
1422 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
1423 "C<virt-cat> doesn't work."
1427 #: ../cat/virt-cat.pod:173
1428 msgid "Using C<virt-cat> is approximately equivalent to doing:"
1432 #: ../cat/virt-cat.pod:175
1435 " guestfish --ro -i -d domname download file -\n"
1440 #: ../cat/virt-cat.pod:177
1442 "where C<domname> is the name of the libvirt guest, and C<file> is the full "
1443 "path to the file. Note the final C<-> (meaning \"output to stdout\")."
1447 #: ../cat/virt-cat.pod:181
1449 "The command above uses libguestfs's guest inspection feature and so does not "
1450 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
1451 "disk images that don't contain guests. To display a file from a disk image "
1456 #: ../cat/virt-cat.pod:186
1459 " guestfish --ro -a disk.img -m /dev/sda1 download file -\n"
1464 #: ../cat/virt-cat.pod:188
1466 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
1467 "the disk image, and C<file> is the full path to the file."
1471 #: ../cat/virt-cat.pod:200 ../cat/virt-filesystems.pod:374
1472 #: ../cat/virt-ls.pod:492 ../df/virt-df.pod:224 ../edit/virt-edit.pod:351
1473 #: ../fuse/guestmount.pod:305 ../inspector/virt-inspector.pod:377
1474 #: ../resize/virt-resize.pod:610 ../sparsify/virt-sparsify.pod:229
1476 "This program returns 0 if successful, or non-zero if there was an error."
1480 #: ../cat/virt-cat.pod:205
1482 "L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, L<virt-"
1483 "tar-out(1)>, L<http://libguestfs.org/>."
1487 #: ../cat/virt-cat.pod:218 ../inspector/virt-inspector.pod:405
1488 #: ../resize/virt-resize.pod:641
1489 msgid "Copyright (C) 2010-2011 Red Hat Inc."
1493 #: ../cat/virt-filesystems.pod:5
1495 "virt-filesystems - List filesystems, partitions, block devices, LVM in a "
1496 "virtual machine or disk image"
1500 #: ../cat/virt-filesystems.pod:9
1503 " virt-filesystems [--options] -d domname\n"
1508 #: ../cat/virt-filesystems.pod:11
1511 " virt-filesystems [--options] -a disk.img [-a disk.img ...]\n"
1516 #: ../cat/virt-filesystems.pod:15
1518 "This tool allows you to discover filesystems, partitions, logical volumes, "
1519 "and their sizes in a disk image or virtual machine. It is a replacement for "
1520 "L<virt-list-filesystems(1)> and L<virt-list-partitions(1)>."
1524 #: ../cat/virt-filesystems.pod:20
1526 "One use for this tool is from shell scripts to iterate over all filesystems "
1527 "from a disk image:"
1531 #: ../cat/virt-filesystems.pod:23
1534 " for fs in $(virt-filesystems -a disk.img); do\n"
1541 #: ../cat/virt-filesystems.pod:27
1543 "Another use is to list partitions before using another tool to modify those "
1544 "partitions (such as L<virt-resize(1)>). If you are curious about what an "
1545 "unknown disk image contains, use this tool along with L<virt-inspector(1)>."
1549 #: ../cat/virt-filesystems.pod:32
1551 "Various command line options control what this program displays. You need "
1552 "to give either I<-a> or I<-d> options to specify the disk image or libvirt "
1553 "guest respectively. If you just specify that then the program shows "
1554 "filesystems found, one per line, like this:"
1558 #: ../cat/virt-filesystems.pod:37
1561 " $ virt-filesystems -a disk.img\n"
1563 " /dev/vg_guest/lv_root\n"
1568 #: ../cat/virt-filesystems.pod:41
1570 "If you add I<-l> or I<--long> then the output includes extra information:"
1574 #: ../cat/virt-filesystems.pod:44
1577 " $ virt-filesystems -a disk.img -l\n"
1578 " Name Type VFS Label Size\n"
1579 " /dev/sda1 filesystem ext4 boot 524288000\n"
1580 " /dev/vg_guest/lv_root filesystem ext4 root 10212081664\n"
1585 #: ../cat/virt-filesystems.pod:49
1587 "If you add I<--extra> then non-mountable (swap, unknown) filesystems are "
1592 #: ../cat/virt-filesystems.pod:52
1595 " $ virt-filesystems -a disk.img --extra\n"
1597 " /dev/vg_guest/lv_root\n"
1598 " /dev/vg_guest/lv_swap\n"
1599 " /dev/vg_guest/lv_data\n"
1604 #: ../cat/virt-filesystems.pod:58
1606 "If you add I<--partitions> then partitions are shown instead of filesystems:"
1610 #: ../cat/virt-filesystems.pod:60
1613 " $ virt-filesystems -a disk.img --partitions\n"
1620 #: ../cat/virt-filesystems.pod:64
1622 "Similarly you can use I<--logical-volumes>, I<--volume-groups>, I<--physical-"
1623 "volumes>, I<--block-devices> to list those items."
1627 #: ../cat/virt-filesystems.pod:67
1629 "You can use these options in combination as well (if you want a combination "
1630 "including filesystems, you have to add I<--filesystems>). Notice that some "
1631 "items fall into several categories (eg. C</dev/sda1> might be both a "
1632 "partition and a filesystem). These items are listed several times. To get "
1633 "a list which includes absolutely everything that virt-filesystems knows "
1634 "about, use the I<--all> option."
1638 #: ../cat/virt-filesystems.pod:74
1640 "UUIDs (because they are quite long) are not shown by default. Add the I<--"
1641 "uuid> option to display device and filesystem UUIDs in the long output."
1645 #: ../cat/virt-filesystems.pod:78
1647 "I<--all --long --uuid> is a useful combination to display all possible "
1648 "information about everything."
1652 #: ../cat/virt-filesystems.pod:81
1655 " $ virt-filesystems -a win.img --all --long --uuid -h\n"
1656 " Name Type VFS Label Size Parent UUID\n"
1657 " /dev/sda1 filesystem ntfs System Reserved 100M - F81C92571C92112C\n"
1658 " /dev/sda2 filesystem ntfs - 20G - F2E8996AE8992E3B\n"
1659 " /dev/sda1 partition - - 100M /dev/sda -\n"
1660 " /dev/sda2 partition - - 20G /dev/sda -\n"
1661 " /dev/sda device - - 20G - -\n"
1666 #: ../cat/virt-filesystems.pod:89
1668 "For machine-readable output, use I<--csv> to get Comma-Separated Values."
1672 #: ../cat/virt-filesystems.pod:110 ../tools/virt-list-filesystems.pl:121
1677 #: ../cat/virt-filesystems.pod:112
1679 "Display everything. This is currently the same as specifying these options: "
1680 "I<--filesystems>, I<--extra>, I<--partitions>, I<--block-devices>, I<--"
1681 "logical-volumes>, I<--volume-groups>, I<--physical-volumes>. (More may be "
1682 "added to this list in future)."
1686 #: ../cat/virt-filesystems.pod:117
1687 msgid "See also I<--long>."
1691 #: ../cat/virt-filesystems.pod:119
1692 msgid "B<--blkdevs>"
1696 #: ../cat/virt-filesystems.pod:121
1697 msgid "B<--block-devices>"
1701 #: ../cat/virt-filesystems.pod:123
1702 msgid "Display block devices."
1706 #: ../cat/virt-filesystems.pod:135 ../cat/virt-ls.pod:301 ../df/virt-df.pod:88
1711 #: ../cat/virt-filesystems.pod:137 ../cat/virt-ls.pod:303 ../df/virt-df.pod:90
1713 "Write out the results in CSV format (comma-separated values). This format "
1714 "can be imported easily into databases and spreadsheets, but read L</NOTE "
1715 "ABOUT CSV FORMAT> below."
1719 #: ../cat/virt-filesystems.pod:150
1721 "When prompting for keys and passphrases, virt-filesystems normally turns "
1722 "echoing off so you cannot see what you are typing. If you are not worried "
1723 "about Tempest attacks and there is no one else in the room you can specify "
1724 "this flag to see what you are typing."
1728 #: ../cat/virt-filesystems.pod:155
1733 #: ../cat/virt-filesystems.pod:157
1735 "This causes filesystems that are not ordinary, mountable filesystems to be "
1736 "displayed. This category includes swapspace, and filesystems that are empty "
1737 "or contain unknown data."
1741 #: ../cat/virt-filesystems.pod:161
1742 msgid "This option implies I<--filesystems>."
1746 #: ../cat/virt-filesystems.pod:163
1747 msgid "B<--filesystems>"
1751 #: ../cat/virt-filesystems.pod:165
1753 "Display mountable filesystems. If no display option was selected then this "
1754 "option is implied."
1758 #: ../cat/virt-filesystems.pod:168
1759 msgid "With I<--extra>, non-mountable filesystems are shown too."
1763 #: ../cat/virt-filesystems.pod:181
1766 " virt-filesystems --format=raw -a disk.img\n"
1771 #: ../cat/virt-filesystems.pod:185
1774 " virt-filesystems --format=raw -a disk.img --format -a another.img\n"
1779 #: ../cat/virt-filesystems.pod:194 ../cat/virt-ls.pod:352
1780 #: ../df/virt-df.pod:125 ../fish/guestfish.pod:156
1781 #: ../tools/virt-list-partitions.pl:109
1786 #: ../cat/virt-filesystems.pod:196 ../cat/virt-ls.pod:354
1787 #: ../df/virt-df.pod:127 ../tools/virt-list-partitions.pl:111
1788 msgid "B<--human-readable>"
1792 #: ../cat/virt-filesystems.pod:198
1793 msgid "In I<--long> mode, display sizes in human-readable format."
1797 #: ../cat/virt-filesystems.pod:205 ../cat/virt-ls.pod:366
1798 #: ../tools/virt-list-filesystems.pl:108 ../tools/virt-list-partitions.pl:119
1803 #: ../cat/virt-filesystems.pod:207 ../cat/virt-ls.pod:368
1804 #: ../tools/virt-list-filesystems.pl:110 ../tools/virt-list-partitions.pl:121
1809 #: ../cat/virt-filesystems.pod:209
1810 msgid "Display extra columns of data (\"long format\")."
1814 #: ../cat/virt-filesystems.pod:211
1815 msgid "A title row is added unless you also specify I<--no-title>."
1819 #: ../cat/virt-filesystems.pod:213
1821 "The extra columns displayed depend on what output you select, and the "
1822 "ordering of columns may change in future versions. Use the title row, I<--"
1823 "csv> output and/or L<csvtool(1)> to match columns to data in external "
1828 #: ../cat/virt-filesystems.pod:218
1830 "Use I<-h> if you want sizes to be displayed in human-readable format. The "
1831 "default is to show raw numbers of I<bytes>."
1835 #: ../cat/virt-filesystems.pod:221
1836 msgid "Use I<--uuid> to display UUIDs too."
1840 #: ../cat/virt-filesystems.pod:223
1845 #: ../cat/virt-filesystems.pod:225
1846 msgid "B<--logvols>"
1850 #: ../cat/virt-filesystems.pod:227
1851 msgid "B<--logical-volumes>"
1855 #: ../cat/virt-filesystems.pod:229
1857 "Display LVM logical volumes. In this mode, these are displayed irrespective "
1858 "of whether the LVs contain filesystems."
1862 #: ../cat/virt-filesystems.pod:232
1863 msgid "B<--no-title>"
1867 #: ../cat/virt-filesystems.pod:234
1868 msgid "In I<--long> mode, don't add a title row."
1872 #: ../cat/virt-filesystems.pod:236
1874 "Note that the order of the columns is not fixed, and may change in future "
1875 "versions of virt-filesystems, so using this option may give you unexpected "
1880 #: ../cat/virt-filesystems.pod:240
1885 #: ../cat/virt-filesystems.pod:242
1886 msgid "B<--partitions>"
1890 #: ../cat/virt-filesystems.pod:244
1892 "Display partitions. In this mode, these are displayed irrespective of "
1893 "whether the partitions contain filesystems."
1897 #: ../cat/virt-filesystems.pod:247
1902 #: ../cat/virt-filesystems.pod:249
1903 msgid "B<--physvols>"
1907 #: ../cat/virt-filesystems.pod:251
1908 msgid "B<--physical-volumes>"
1912 #: ../cat/virt-filesystems.pod:253
1913 msgid "Display LVM physical volumes."
1917 #: ../cat/virt-filesystems.pod:255 ../df/virt-df.pod:163
1922 #: ../cat/virt-filesystems.pod:257
1927 #: ../cat/virt-filesystems.pod:259
1928 msgid "In I<--long> mode, display UUIDs as well."
1932 #: ../cat/virt-filesystems.pod:273
1937 #: ../cat/virt-filesystems.pod:275
1938 msgid "B<--volgroups>"
1942 #: ../cat/virt-filesystems.pod:277
1943 msgid "B<--volume-groups>"
1947 #: ../cat/virt-filesystems.pod:279
1948 msgid "Display LVM volume groups."
1952 #: ../cat/virt-filesystems.pod:287
1957 #: ../cat/virt-filesystems.pod:289
1959 "Note that columns in the output are subject to reordering and change in "
1960 "future versions of this tool."
1964 #: ../cat/virt-filesystems.pod:294
1969 #: ../cat/virt-filesystems.pod:296
1970 msgid "The filesystem, partition, block device or LVM name."
1974 #: ../cat/virt-filesystems.pod:298
1976 "For device and partition names these are displayed as canonical libguestfs "
1977 "names, so that for example C</dev/sda2> is the second partition on the first "
1982 #: ../cat/virt-filesystems.pod:302
1984 "If the I<--long> option is B<not> specified, then only the name column is "
1985 "shown in the output."
1989 #: ../cat/virt-filesystems.pod:305
1994 #: ../cat/virt-filesystems.pod:307
1995 msgid "The object type, for example C<filesystem>, C<lv>, C<device> etc."
1999 #: ../cat/virt-filesystems.pod:309
2004 #: ../cat/virt-filesystems.pod:311
2006 "If there is a filesystem, then this column displays the filesystem type if "
2007 "one could be detected, eg. C<ext4>."
2011 #: ../cat/virt-filesystems.pod:314
2016 #: ../cat/virt-filesystems.pod:316
2018 "If the object has a label (used for identifying and mounting filesystems) "
2019 "then this column contains the label."
2023 #: ../cat/virt-filesystems.pod:319
2028 #: ../cat/virt-filesystems.pod:321
2030 "The size of the object in bytes. If the I<--human> option is used then the "
2031 "size is displayed in a human-readable form."
2035 #: ../cat/virt-filesystems.pod:324
2040 #: ../cat/virt-filesystems.pod:326
2042 "The parent column records the parent relationship between objects. For "
2043 "example, if the object is a partition, then this column contains the name of "
2044 "the containing device. If the object is a logical volume, then this column "
2045 "is the name of the volume group."
2049 #: ../cat/virt-filesystems.pod:331
2054 #: ../cat/virt-filesystems.pod:333
2056 "If the object has a UUID (used for identifying and mounting filesystems and "
2057 "block devices) then this column contains the UUID as a string."
2061 #: ../cat/virt-filesystems.pod:337
2062 msgid "The UUID is only displayed if the I<--uuid> option is given."
2066 #: ../cat/virt-filesystems.pod:341 ../cat/virt-ls.pod:459
2067 #: ../df/virt-df.pod:191
2068 msgid "NOTE ABOUT CSV FORMAT"
2072 #: ../cat/virt-filesystems.pod:343 ../cat/virt-ls.pod:461
2073 #: ../df/virt-df.pod:193
2075 "Comma-separated values (CSV) is a deceptive format. It I<seems> like it "
2076 "should be easy to parse, but it is definitely not easy to parse."
2080 #: ../cat/virt-filesystems.pod:346 ../cat/virt-ls.pod:464
2081 #: ../df/virt-df.pod:196
2083 "Myth: Just split fields at commas. Reality: This does I<not> work "
2084 "reliably. This example has two columns:"
2088 #: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:467
2089 #: ../df/virt-df.pod:199
2092 " \"foo,bar\",baz\n"
2097 #: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:469
2098 #: ../df/virt-df.pod:201
2100 "Myth: Read the file one line at a time. Reality: This does I<not> work "
2101 "reliably. This example has one row:"
2105 #: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:472
2106 #: ../df/virt-df.pod:204
2115 #: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:475
2116 #: ../df/virt-df.pod:207
2118 "For shell scripts, use C<csvtool> (L<http://merjis.com/developers/csv> also "
2119 "packaged in major Linux distributions)."
2123 #: ../cat/virt-filesystems.pod:360 ../cat/virt-ls.pod:478
2124 #: ../df/virt-df.pod:210
2126 "For other languages, use a CSV processing library (eg. C<Text::CSV> for Perl "
2127 "or Python's built-in csv library)."
2131 #: ../cat/virt-filesystems.pod:363 ../cat/virt-ls.pod:481
2132 #: ../df/virt-df.pod:213
2133 msgid "Most spreadsheets and databases can import CSV directly."
2137 #: ../cat/virt-filesystems.pod:379
2139 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-df(1)>, L<virt-list-"
2140 "filesystems(1)>, L<virt-list-partitions(1)>, L<csvtool(1)>, L<http://"
2145 #: ../cat/virt-filesystems.pod:394 ../tools/virt-make-fs.pl:570
2146 #: ../tools/virt-win-reg.pl:778
2147 msgid "Copyright (C) 2010 Red Hat Inc."
2151 #: ../cat/virt-ls.pod:5
2152 msgid "virt-ls - List files in a virtual machine"
2156 #: ../cat/virt-ls.pod:9
2159 " virt-ls [--options] -d domname directory [directory ...]\n"
2164 #: ../cat/virt-ls.pod:11
2167 " virt-ls [--options] -a disk.img [-a disk.img ...] directory [directory ...]\n"
2172 #: ../cat/virt-ls.pod:13 ../df/virt-df.pod:15 ../rescue/virt-rescue.pod:13
2177 #: ../cat/virt-ls.pod:15
2180 " virt-ls [--options] domname directory\n"
2185 #: ../cat/virt-ls.pod:17
2188 " virt-ls [--options] disk.img [disk.img ...] directory\n"
2193 #: ../cat/virt-ls.pod:21
2195 "C<virt-ls> lists filenames, file sizes, checksums, extended attributes and "
2196 "more from a virtual machine or disk image."
2200 #: ../cat/virt-ls.pod:24
2202 "Multiple directory names can be given, in which case the output from each is "
2207 #: ../cat/virt-ls.pod:27
2209 "To list directories from a libvirt guest use the I<-d> option to specify the "
2210 "name of the guest. For a disk image, use the I<-a> option."
2214 #: ../cat/virt-ls.pod:31
2216 "C<virt-ls> can do many simple file listings. For more complicated cases you "
2217 "may need to use L<guestfish(1)>, or write a program directly to the L<guestfs"
2222 #: ../cat/virt-ls.pod:37
2223 msgid "Get a list of all files and directories in a virtual machine:"
2227 #: ../cat/virt-ls.pod:39
2230 " virt-ls -R -d guest /\n"
2235 #: ../cat/virt-ls.pod:41
2236 msgid "List all setuid or setgid programs in a Linux virtual machine:"
2240 #: ../cat/virt-ls.pod:43
2243 " virt-ls -lR -d guest / | grep '^- [42]'\n"
2248 #: ../cat/virt-ls.pod:45
2249 msgid "List all public-writable directories in a Linux virtual machine:"
2253 #: ../cat/virt-ls.pod:47
2256 " virt-ls -lR -d guest / | grep '^d ...7'\n"
2261 #: ../cat/virt-ls.pod:49
2262 msgid "List all Unix domain sockets in a Linux virtual machine:"
2266 #: ../cat/virt-ls.pod:51
2269 " virt-ls -lR -d guest / | grep '^s'\n"
2274 #: ../cat/virt-ls.pod:53
2275 msgid "List all regular files with filenames ending in '.png':"
2279 #: ../cat/virt-ls.pod:55
2282 " virt-ls -lR -d guest / | grep -i '^-.*\\.png$'\n"
2287 #: ../cat/virt-ls.pod:57
2288 msgid "To display files larger than 10MB in home directories:"
2292 #: ../cat/virt-ls.pod:59
2295 " virt-ls -lR -d guest /home | awk '$3 > 10*1024*1024'\n"
2300 #: ../cat/virt-ls.pod:61
2301 msgid "Find everything modified in the last 7 days:"
2305 #: ../cat/virt-ls.pod:63
2308 " virt-ls -lR -d guest --time-days / | awk '$6 <= 7'\n"
2313 #: ../cat/virt-ls.pod:65
2314 msgid "Find regular files modified in the last 24 hours:"
2318 #: ../cat/virt-ls.pod:67
2321 " virt-ls -lR -d guest --time-days / | grep '^-' | awk '$6 < 1'\n"
2326 #: ../cat/virt-ls.pod:69
2327 msgid "DIFFERENCES IN SNAPSHOTS AND BACKING FILES"
2331 #: ../cat/virt-ls.pod:71
2333 "Find the differences between files in a guest and an earlier snapshot of the "
2338 #: ../cat/virt-ls.pod:74
2341 " virt-ls -lR -a snapshot.img / --uids --time-t > old\n"
2342 " virt-ls -lR -a current.img / --uids --time-t > new\n"
2343 " diff -u old new | less\n"
2348 #: ../cat/virt-ls.pod:78
2350 "The commands above won't find files where the content has changed but the "
2351 "metadata (eg. file size and modification date) is the same. To do that, you "
2352 "need to add the I<--checksum> parameter to both C<virt-ls> commands. I<--"
2353 "checksum> can be quite slow since it has to read and compute a checksum of "
2354 "every regular file in the virtual machine."
2358 #: ../cat/virt-ls.pod:84
2359 msgid "OUTPUT MODES"
2363 #: ../cat/virt-ls.pod:86
2365 "C<virt-ls> has four output modes, controlled by different combinations of "
2366 "the I<-l> and I<-R> options."
2370 #: ../cat/virt-ls.pod:89
2371 msgid "SIMPLE LISTING"
2375 #: ../cat/virt-ls.pod:91
2376 msgid "A simple listing is like the ordinary L<ls(1)> command:"
2380 #: ../cat/virt-ls.pod:93
2383 " $ virt-ls -d guest /\n"
2391 #: ../cat/virt-ls.pod:98
2392 msgid "LONG LISTING"
2396 #: ../cat/virt-ls.pod:100
2398 "With the I<-l> (I<--long>) option, the output is like the C<ls -l> command "
2399 "(more specifically, like the C<guestfs_ll> function)."
2403 #: ../cat/virt-ls.pod:103
2406 " $ virt-ls -l -d guest /\n"
2408 " dr-xr-xr-x. 2 root root 4096 2009-08-25 19:06 bin\n"
2409 " dr-xr-xr-x. 5 root root 3072 2009-08-25 19:06 boot\n"
2415 #: ../cat/virt-ls.pod:109
2417 "Note that while this is useful for displaying a directory, do not try "
2418 "parsing this output in another program. Use L</RECURSIVE LONG LISTING> "
2423 #: ../cat/virt-ls.pod:113
2424 msgid "RECURSIVE LISTING"
2428 #: ../cat/virt-ls.pod:115
2430 "With the I<-R> (I<--recursive>) option, C<virt-ls> lists the names of files "
2431 "and directories recursively:"
2435 #: ../cat/virt-ls.pod:118
2438 " $ virt-ls -R -d guest /tmp\n"
2446 #: ../cat/virt-ls.pod:123
2448 "To generate this output, C<virt-ls> runs the C<guestfs_find0> function and "
2449 "converts C<\\0> characters to C<\\n>."
2453 #: ../cat/virt-ls.pod:126
2454 msgid "RECURSIVE LONG LISTING"
2458 #: ../cat/virt-ls.pod:128
2460 "Using I<-lR> options together changes the output to display directories "
2461 "recursively, with file stats, and optionally other features such as "
2462 "checksums and extended attributes."
2466 #: ../cat/virt-ls.pod:132
2468 "Most of the interesting features of C<virt-ls> are only available when using "
2473 #: ../cat/virt-ls.pod:135
2475 "The fields are normally space-separated. Filenames are B<not> quoted, so "
2476 "you cannot use the output in another program (because filenames can contain "
2477 "spaces and other unsafe characters). If the guest was untrusted and someone "
2478 "knew you were using C<virt-ls> to analyze the guest, they could play tricks "
2479 "on you by creating filenames with embedded newline characters. To B<safely> "
2480 "parse the output in another program, use the I<--csv> (Comma-Separated "
2485 #: ../cat/virt-ls.pod:143
2487 "Note that this output format is completely unrelated to the C<ls -lR> "
2492 #: ../cat/virt-ls.pod:146
2495 " $ virt-ls -lR -d guest /bin\n"
2496 " d 0555 4096 /bin\n"
2497 " - 0755 123 /bin/alsaunmute\n"
2498 " - 0755 28328 /bin/arch\n"
2499 " l 0777 4 /bin/awk -> gawk\n"
2500 " - 0755 27216 /bin/basename\n"
2501 " - 0755 943360 /bin/bash\n"
2507 #: ../cat/virt-ls.pod:155
2508 msgid "These basic fields are always shown:"
2512 #: ../cat/virt-ls.pod:159
2517 #: ../cat/virt-ls.pod:161
2519 "The file type, one of: C<-> (regular file), C<d> (directory), C<c> "
2520 "(character device), C<b> (block device), C<p> (named pipe), C<l> (symbolic "
2521 "link), C<s> (socket) or C<u> (unknown)."
2525 #: ../cat/virt-ls.pod:171
2530 #: ../cat/virt-ls.pod:173
2531 msgid "The Unix permissions, displayed as a 4 digit octal number."
2535 #: ../cat/virt-ls.pod:175
2540 #: ../cat/virt-ls.pod:177
2542 "The size of the file. This is shown in bytes unless I<-h> or I<--human-"
2543 "readable> option is given, in which case this is shown as a human-readable "
2548 #: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4245
2553 #: ../cat/virt-ls.pod:183
2554 msgid "The full path of the file or directory."
2558 #: ../cat/virt-ls.pod:185
2563 #: ../cat/virt-ls.pod:187
2564 msgid "For symbolic links only, the link target."
2568 #: ../cat/virt-ls.pod:191
2570 "In I<-lR> mode, additional command line options enable the display of more "
2575 #: ../cat/virt-ls.pod:194
2577 "With the I<--uids> flag, these additional fields are displayed before the "
2582 #: ../cat/virt-ls.pod:199
2587 #: ../cat/virt-ls.pod:201
2592 #: ../cat/virt-ls.pod:203
2594 "The UID and GID of the owner of the file (displayed numerically). Note "
2595 "these only make sense in the context of a Unix-like guest."
2599 #: ../cat/virt-ls.pod:208
2600 msgid "With the I<--times> flag, these additional fields are displayed:"
2604 #: ../cat/virt-ls.pod:212
2609 #: ../cat/virt-ls.pod:214
2610 msgid "The time of last access."
2614 #: ../cat/virt-ls.pod:216
2619 #: ../cat/virt-ls.pod:218
2620 msgid "The time of last modification."
2624 #: ../cat/virt-ls.pod:220
2629 #: ../cat/virt-ls.pod:222
2630 msgid "The time of last status change."
2634 #: ../cat/virt-ls.pod:226
2636 "The time fields are displayed as string dates and times, unless one of the "
2637 "I<--time-t>, I<--time-relative> or I<--time-days> flags is given."
2641 #: ../cat/virt-ls.pod:229
2642 msgid "With the I<--extra-stats> flag, these additional fields are displayed:"
2646 #: ../cat/virt-ls.pod:233
2651 #: ../cat/virt-ls.pod:235
2653 "The device containing the file (displayed as major:minor). This may not "
2654 "match devices as known to the guest."
2658 #: ../cat/virt-ls.pod:238
2663 #: ../cat/virt-ls.pod:240
2664 msgid "The inode number."
2668 #: ../cat/virt-ls.pod:242
2673 #: ../cat/virt-ls.pod:244
2674 msgid "The number of hard links."
2678 #: ../cat/virt-ls.pod:246
2683 #: ../cat/virt-ls.pod:248
2685 "For block and char special files, the device (displayed as major:minor)."
2689 #: ../cat/virt-ls.pod:251
2694 #: ../cat/virt-ls.pod:253
2695 msgid "The number of 512 byte blocks allocated to the file."
2699 #: ../cat/virt-ls.pod:257
2701 "With the I<--checksum> flag, the checksum of the file contents is shown "
2702 "(only for regular files). Computing file checksums can take a considerable "
2707 #: ../cat/virt-ls.pod:280
2708 msgid "B<--checksum>"
2712 #: ../cat/virt-ls.pod:282
2713 msgid "B<--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512>"
2717 #: ../cat/virt-ls.pod:284
2719 "Display checksum over file contents for regular files. With no argument, "
2720 "this defaults to using I<md5>. Using an argument, you can select the "
2721 "checksum type to use."
2725 #: ../cat/virt-ls.pod:288 ../cat/virt-ls.pod:325 ../cat/virt-ls.pod:358
2726 #: ../cat/virt-ls.pod:391 ../cat/virt-ls.pod:401 ../cat/virt-ls.pod:408
2727 #: ../cat/virt-ls.pod:415 ../cat/virt-ls.pod:422
2729 "This option only has effect in I<-lR> output mode. See L</RECURSIVE LONG "
2734 #: ../cat/virt-ls.pod:316
2736 "When prompting for keys and passphrases, virt-ls normally turns echoing off "
2737 "so you cannot see what you are typing. If you are not worried about Tempest "
2738 "attacks and there is no one else in the room you can specify this flag to "
2739 "see what you are typing."
2743 #: ../cat/virt-ls.pod:321
2744 msgid "B<--extra-stats>"
2748 #: ../cat/virt-ls.pod:323
2749 msgid "Display extra stats."
2753 #: ../cat/virt-ls.pod:339
2756 " virt-ls --format=raw -a disk.img /dir\n"
2761 #: ../cat/virt-ls.pod:343
2764 " virt-ls --format=raw -a disk.img --format -a another.img /dir\n"
2769 #: ../cat/virt-ls.pod:356
2770 msgid "Display file sizes in human-readable format."
2774 #: ../cat/virt-ls.pod:370
2779 #: ../cat/virt-ls.pod:372
2780 msgid "B<--recursive>"
2784 #: ../cat/virt-ls.pod:374
2786 "Select the mode. With neither of these options, C<virt-ls> produces a "
2787 "simple, flat list of the files in the named directory. See L</SIMPLE "
2792 #: ../cat/virt-ls.pod:378
2794 "C<virt-ls -l> produces a \"long listing\", which shows more detail. See L</"
2799 #: ../cat/virt-ls.pod:381
2801 "C<virt-ls -R> produces a recursive list of files starting at the named "
2802 "directory. See L</RECURSIVE LISTING>."
2806 #: ../cat/virt-ls.pod:384
2808 "C<virt-ls -lR> produces a recursive long listing which can be more easily "
2809 "parsed. See L</RECURSIVE LONG LISTING>."
2813 #: ../cat/virt-ls.pod:387
2818 #: ../cat/virt-ls.pod:389
2819 msgid "Display time fields."
2823 #: ../cat/virt-ls.pod:394
2824 msgid "B<--time-days>"
2828 #: ../cat/virt-ls.pod:396
2829 msgid "Display time fields as days before now (negative if in the future)."
2833 #: ../cat/virt-ls.pod:398
2835 "Note that C<0> in output means \"up to 1 day before now\", or that the age "
2836 "of the file is between 0 and 86399 seconds."
2840 #: ../cat/virt-ls.pod:404
2841 msgid "B<--time-relative>"
2845 #: ../cat/virt-ls.pod:406
2846 msgid "Display time fields as seconds before now (negative if in the future)."
2850 #: ../cat/virt-ls.pod:411
2855 #: ../cat/virt-ls.pod:413
2856 msgid "Display time fields as seconds since the Unix epoch."
2860 #: ../cat/virt-ls.pod:418
2865 #: ../cat/virt-ls.pod:420
2866 msgid "Display UID and GID fields."
2870 #: ../cat/virt-ls.pod:445
2871 msgid "Previous versions of virt-ls allowed you to write either:"
2875 #: ../cat/virt-ls.pod:447
2878 " virt-ls disk.img [disk.img ...] /dir\n"
2883 #: ../cat/virt-ls.pod:451
2886 " virt-ls guestname /dir\n"
2891 #: ../cat/virt-ls.pod:497
2893 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-out(1)>, L<virt-"
2894 "tar-out(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
2895 "L<http://libguestfs.org/>."
2899 #: ../cat/virt-ls.pod:513 ../df/virt-df.pod:241 ../edit/virt-edit.pod:374
2900 #: ../rescue/virt-rescue.pod:302
2901 msgid "Copyright (C) 2009-2011 Red Hat Inc."
2905 #: ../clone/virt-sysprep.pod:5
2907 "virt-sysprep - Reset or unconfigure a virtual machine so clones can be made"
2911 #: ../clone/virt-sysprep.pod:9
2914 " virt-sysprep [--options] -d domname\n"
2919 #: ../clone/virt-sysprep.pod:11
2922 " virt-sysprep [--options] -a disk.img [-a disk.img ...]\n"
2927 #: ../clone/virt-sysprep.pod:15
2929 "Virt-sysprep \"resets\" or \"unconfigures\" a virtual machine so that clones "
2930 "can be made from it. Steps in this process include removing SSH host keys, "
2931 "removing persistent network MAC configuration, and removing user accounts. "
2932 "Each step can be enabled or disabled as required."
2936 #: ../clone/virt-sysprep.pod:21
2938 "Virt-sysprep is a simple shell script, allowing easy inspection or "
2939 "customization by the system administrator."
2943 #: ../clone/virt-sysprep.pod:24
2945 "Virt-sysprep modifies the guest or disk image I<in place>. The guest must "
2946 "be shut down. If you want to preserve the existing contents of the guest, "
2947 "you I<must copy or clone the disk first>. See L</COPYING AND CLONING> below."
2951 #: ../clone/virt-sysprep.pod:29
2953 "\"Sysprep\" stands for \"system preparation\" tool. The name comes from the "
2954 "Microsoft program C<sysprep.exe> which is used to unconfigure Windows "
2955 "machines in preparation for cloning them. Having said that, virt-sysprep "
2956 "does I<not> currently work on Microsoft Windows guests. We plan to support "
2957 "Windows sysprepping in a future version, and we already have code to do it."
2961 #: ../clone/virt-sysprep.pod:70
2962 msgid "B<--enable=...>"
2966 #: ../clone/virt-sysprep.pod:72
2968 "Choose which sysprep operations to perform. Give a comma-separated list of "
2969 "operations, for example:"
2973 #: ../clone/virt-sysprep.pod:75
2976 " --enable=ssh-hostkeys,udev-persistent-net\n"
2981 #: ../clone/virt-sysprep.pod:77
2983 "would enable ONLY C<ssh-hostkeys> and C<udev-persistent-net> operations."
2987 #: ../clone/virt-sysprep.pod:79
2989 "If the I<--enable> option is not given, then we default to trying all "
2990 "possible sysprep operations. But some sysprep operations are skipped for "
2995 #: ../clone/virt-sysprep.pod:83
2997 "Use I<--list-operations> to list operations supported by a particular "
2998 "version of virt-sysprep."
3002 #: ../clone/virt-sysprep.pod:86
3004 "See L</OPERATIONS> below for a list and an explanation of each operation."
3008 #: ../clone/virt-sysprep.pod:100
3011 " virt-sysprep --format=raw -a disk.img\n"
3016 #: ../clone/virt-sysprep.pod:104
3019 " virt-sysprep --format=raw -a disk.img --format -a another.img\n"
3024 #: ../clone/virt-sysprep.pod:113
3025 msgid "B<--hostname> newhostname"
3029 #: ../clone/virt-sysprep.pod:115
3031 "Change the hostname. See the L</hostname> operation below. If not given, "
3032 "defaults to C<localhost.localdomain>."
3036 #: ../clone/virt-sysprep.pod:118
3037 msgid "B<--list-operations>"
3041 #: ../clone/virt-sysprep.pod:120
3042 msgid "List the operations supported by the virt-sysprep program."
3046 #: ../clone/virt-sysprep.pod:140
3051 #: ../clone/virt-sysprep.pod:142
3053 "If the I<--enable> option is I<not> given, then all sysprep operations in "
3054 "the list below are enabled, although some are skipped depending on the type "
3059 #: ../clone/virt-sysprep.pod:146
3061 "Operations can be individually enabled using the I<--enable> option. Use a "
3062 "comma-separated list, for example:"
3066 #: ../clone/virt-sysprep.pod:149
3069 " virt-sysprep --enable=ssh-hostkeys,udev-persistent-net [etc..]\n"
3074 #: ../clone/virt-sysprep.pod:151
3076 "To list the operations supported by the current version of virt-sysprep, use "
3077 "I<--list-operations>."
3081 #: ../clone/virt-sysprep.pod:154
3086 #: ../clone/virt-sysprep.pod:156
3088 "This changes the hostname of the guest to the value given in the I<--"
3089 "hostname> parameter."
3093 #: ../clone/virt-sysprep.pod:159
3095 "If the I<--hostname> parameter is not given, then the hostname is changed to "
3096 "C<localhost.localdomain>."
3100 #: ../clone/virt-sysprep.pod:162
3105 #: ../clone/virt-sysprep.pod:164
3107 "Remove HWADDR (hard-coded MAC address) configuration. For Fedora and Red "
3108 "Hat Enterprise Linux, this is removed from C<ifcfg-*> files."
3112 #: ../clone/virt-sysprep.pod:167
3113 msgid "ssh-hostkeys"
3117 #: ../clone/virt-sysprep.pod:169
3118 msgid "This erases the SSH host keys in the guest."
3122 #: ../clone/virt-sysprep.pod:171
3124 "The SSH host keys are regenerated (differently) next time the guest is "
3129 #: ../clone/virt-sysprep.pod:174
3131 "If, after cloning, the guest gets the same IP address, ssh will give you a "
3132 "stark warning about the host key changing:"
3136 #: ../clone/virt-sysprep.pod:177
3139 " @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n"
3140 " @ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @\n"
3141 " @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n"
3142 " IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!\n"
3147 #: ../clone/virt-sysprep.pod:182
3148 msgid "udev-persistent-net"
3152 #: ../clone/virt-sysprep.pod:184
3154 "This erases udev persistent net rules which map the guest's existing MAC "
3155 "address to a fixed ethernet device (eg. eth0)."
3159 #: ../clone/virt-sysprep.pod:187
3161 "After a guest is cloned, the MAC address usually changes. Since the old MAC "
3162 "address occupies the old name (eg. eth0), this means the fresh MAC address "
3163 "is assigned to a new name (eg. eth1) and this is usually undesirable. "
3164 "Erasing the udev persistent net rules avoids this."
3168 #: ../clone/virt-sysprep.pod:192
3169 msgid "COPYING AND CLONING"
3173 #: ../clone/virt-sysprep.pod:194
3175 "Virt-sysprep can be used as part of a process of cloning guests, or to "
3176 "prepare a template from which guests can be cloned. There are many "
3177 "different ways to achieve this using the virt tools, and this section is "
3178 "just an introduction."
3182 #: ../clone/virt-sysprep.pod:199
3183 msgid "A virtual machine (when switched off) consists of two parts:"
3187 #: ../clone/virt-sysprep.pod:203
3188 msgid "I<configuration>"
3192 #: ../clone/virt-sysprep.pod:205
3194 "The configuration or description of the guest. eg. The libvirt XML (see "
3195 "C<virsh dumpxml>), the running configuration of the guest, or another "
3196 "external format like OVF."
3200 #: ../clone/virt-sysprep.pod:209
3201 msgid "Some configuration items that might need to be changed:"
3205 #: ../clone/virt-sysprep.pod:215
3210 #: ../clone/virt-sysprep.pod:219 ../clone/virt-sysprep.pod:246
3215 #: ../clone/virt-sysprep.pod:223
3216 msgid "path to block device(s)"
3220 #: ../clone/virt-sysprep.pod:227
3221 msgid "network card MAC address"
3225 #: ../clone/virt-sysprep.pod:231
3226 msgid "I<block device(s)>"
3230 #: ../clone/virt-sysprep.pod:233
3232 "One or more hard disk images, themselves containing files, directories, "
3233 "applications, kernels, configuration, etc."
3237 #: ../clone/virt-sysprep.pod:236
3238 msgid "Some things inside the block devices that might need to be changed:"
3242 #: ../clone/virt-sysprep.pod:242
3243 msgid "hostname and other net configuration"
3247 #: ../clone/virt-sysprep.pod:250
3248 msgid "SSH host keys"
3252 #: ../clone/virt-sysprep.pod:254
3253 msgid "Windows unique security ID (SID)"
3257 #: ../clone/virt-sysprep.pod:258
3258 msgid "Puppet registration"
3262 #: ../clone/virt-sysprep.pod:264
3263 msgid "COPYING THE BLOCK DEVICE"
3267 #: ../clone/virt-sysprep.pod:266
3269 "Starting with an original guest, you probably wish to copy the guest block "
3270 "device and its configuration to make a template. Then once you are happy "
3271 "with the template, you will want to make many clones from it."
3275 #: ../clone/virt-sysprep.pod:271
3281 " original guest --------> template ---------->\n"
3282 " \\------> cloned\n"
3283 " \\-----> guests\n"
3289 #: ../clone/virt-sysprep.pod:279
3291 "You can, of course, just copy the block device on the host using L<cp(1)> or "
3296 #: ../clone/virt-sysprep.pod:282
3300 " original guest --------> template ---------->\n"
3301 " \\------> cloned\n"
3302 " \\-----> guests\n"
3308 #: ../clone/virt-sysprep.pod:288
3309 msgid "There are some smarter (and faster) ways too:"
3313 #: ../clone/virt-sysprep.pod:294
3317 " template ---------->\n"
3318 " \\------> cloned\n"
3319 " \\-----> guests\n"
3325 #: ../clone/virt-sysprep.pod:300
3327 "Use the block device as a backing file and create a snapshot on top for each "
3328 "guest. The advantage is that you don't need to copy the block device (very "
3329 "fast) and only changes are stored (less storage required)."
3333 #: ../clone/virt-sysprep.pod:305
3335 "Note that writing to the backing file once you have created guests on top of "
3336 "it is not possible: you will corrupt the guests."
3340 #: ../clone/virt-sysprep.pod:308
3342 "Tools that can do this include: L<qemu-img(1)> (with the I<create -f qcow2 -"
3343 "o backing_file> option), L<lvcreate(8)> (I<--snapshot> option). Some "
3344 "filesystems (such as btrfs) and most Network Attached Storage devices can "
3345 "also create cheap snapshots from files or LUNs."
3349 #: ../clone/virt-sysprep.pod:316
3350 msgid "Get your NAS to snapshot and/or duplicate the LUN."
3354 #: ../clone/virt-sysprep.pod:320
3355 msgid "Prepare your template using L<virt-sparsify(1)>. See below."
3359 #: ../clone/virt-sysprep.pod:324
3364 #: ../clone/virt-sysprep.pod:326
3366 "A separate tool, L<virt-clone(1)>, can be used to duplicate the block device "
3367 "and/or modify the external libvirt configuration of a guest. It will reset "
3368 "the name, UUID and MAC address of the guest in the libvirt XML."
3372 #: ../clone/virt-sysprep.pod:331
3374 "L<virt-clone(1)> does not use libguestfs and cannot look inside the disk "
3375 "image. This was the original motivation to write virt-sysprep."
3379 #: ../clone/virt-sysprep.pod:334
3384 #: ../clone/virt-sysprep.pod:336
3388 " original guest --------> template\n"
3393 #: ../clone/virt-sysprep.pod:339
3395 "L<virt-sparsify(1)> can be used to make the cloning template smaller, making "
3396 "it easier to compress and/or faster to copy."
3400 #: ../clone/virt-sysprep.pod:342
3402 "Notice that since virt-sparsify also copies the image, you can use it to "
3403 "make the initial copy (instead of C<dd>)."
3407 #: ../clone/virt-sysprep.pod:345
3412 #: ../clone/virt-sysprep.pod:347
3416 " template ---------->\n"
3417 " \\------> cloned\n"
3418 " \\-----> guests\n"
3424 #: ../clone/virt-sysprep.pod:353
3426 "If you want to give people cloned guests, but let them pick the size of the "
3427 "guest themselves (eg. depending on how much they are prepared to pay for "
3428 "disk space), then instead of copying the template, you can run L<virt-resize"
3429 "(1)>. Virt-resize performs a copy and resize, and thus is ideal for cloning "
3430 "guests from a template."
3434 #: ../clone/virt-sysprep.pod:368
3435 msgid "This program returns 0 on success, or 1 if there was an error."
3439 #: ../clone/virt-sysprep.pod:372
3441 "L<guestfs(3)>, L<guestfish(1)>, L<virt-clone(1)>, L<virt-rescue(1)>, L<virt-"
3442 "resize(1)>, L<virt-sparsify(1)>, L<virsh(1)>, L<qemu-img(1)>, L<lvcreate(8)"
3443 ">, L<http://libguestfs.org/>, L<http://libvirt.org/>."
3447 #: ../df/virt-df.pod:5
3448 msgid "virt-df - Display free space on virtual filesystems"
3452 #: ../df/virt-df.pod:9
3455 " virt-df [--options]\n"
3460 #: ../df/virt-df.pod:11
3463 " virt-df [--options] -d domname\n"
3468 #: ../df/virt-df.pod:13
3471 " virt-df [--options] -a disk.img [-a disk.img ...]\n"
3476 #: ../df/virt-df.pod:17
3479 " virt-df [--options] domname\n"
3484 #: ../df/virt-df.pod:19
3487 " virt-df [--options] disk.img [disk.img ...]\n"
3492 #: ../df/virt-df.pod:23
3494 "C<virt-df> is a command line tool to display free space on virtual machine "
3495 "filesystems. Unlike other tools, it doesn't just display the size of disk "
3496 "allocated to a virtual machine, but can look inside disk images to see how "
3497 "much space is really being used."
3501 #: ../df/virt-df.pod:28
3503 "If used without any I<-a> or I<-d> arguments, C<virt-df> checks with libvirt "
3504 "to get a list of all active and inactive guests, and performs a C<df>-type "
3505 "operation on each one in turn, printing out the results."
3509 #: ../df/virt-df.pod:32
3511 "If any I<-a> or I<-d> arguments are specified, C<virt-df> performs a C<df>-"
3512 "type operation on either the single named libvirt domain, or on the disk "
3513 "image(s) listed on the command line (which must all belong to a single VM). "
3514 "In this mode (with arguments), C<virt-df> will I<only work for a single "
3515 "guest>. If you want to run on multiple guests, then you have to invoke "
3516 "C<virt-df> multiple times."
3520 #: ../df/virt-df.pod:39
3522 "Use the I<--csv> option to get a format which can be easily parsed by other "
3523 "programs. Other options are similar to the standard L<df(1)> command."
3527 #: ../df/virt-df.pod:45
3529 "Show disk usage for a single libvirt guest called C<F14x64>. Make the "
3530 "output human-readable:"
3534 #: ../df/virt-df.pod:48
3537 " # virt-df -d F14x64 -h\n"
3538 " Filesystem Size Used Available Use%\n"
3539 " F14x64:/dev/sda1 484M 66M 393M 14%\n"
3540 " F14x64:/dev/vg_f13x64/lv_root 7.4G 3.4G 4.0G 46%\n"
3545 #: ../df/virt-df.pod:53
3546 msgid "Show disk usage for a disk image file called C<test.img>:"
3550 #: ../df/virt-df.pod:55
3553 " $ virt-df -a test1.img\n"
3554 " Filesystem 1K-blocks Used Available Use%\n"
3555 " test1.img:/dev/sda1 99099 1551 92432 2%\n"
3560 #: ../df/virt-df.pod:112
3563 " virt-df --format=raw -a disk.img\n"
3568 #: ../df/virt-df.pod:116
3571 " virt-df --format=raw -a disk.img --format -a another.img\n"
3576 #: ../df/virt-df.pod:129
3577 msgid "Print sizes in human-readable format."
3581 #: ../df/virt-df.pod:131
3582 msgid "You are not allowed to use I<-h> and I<--csv> at the same time."
3586 #: ../df/virt-df.pod:133 ../fish/guestfish.pod:258 ../fuse/guestmount.pod:155
3591 #: ../df/virt-df.pod:135
3596 #: ../df/virt-df.pod:137
3597 msgid "Print inodes instead of blocks."
3601 #: ../df/virt-df.pod:139
3602 msgid "B<--one-per-guest>"
3606 #: ../df/virt-df.pod:141
3608 "Run one libguestfs appliance per guest. Normally C<virt-df> will add the "
3609 "disks from several guests to a single libguestfs appliance."
3613 #: ../df/virt-df.pod:144
3614 msgid "You might use this option in the following circumstances:"
3618 #: ../df/virt-df.pod:150
3620 "If you think an untrusted guest might actively try to exploit the libguestfs "
3621 "appliance kernel, then this prevents one guest from interfering with the "
3622 "stats printed for another guest."
3626 #: ../df/virt-df.pod:156
3628 "If the kernel has a bug which stops it from accessing a filesystem in one "
3629 "guest (see for example RHBZ#635373) then this allows libguestfs to continue "
3630 "and report stats for further guests."
3634 #: ../df/virt-df.pod:165
3636 "Print UUIDs instead of names. This is useful for following a guest even "
3637 "when the guest is migrated or renamed, or when two guests happen to have the "
3642 #: ../df/virt-df.pod:169
3644 "Note that only domains that we fetch from libvirt come with UUIDs. For disk "
3645 "images, we still print the disk image name even when this option is "
3650 #: ../df/virt-df.pod:229
3652 "L<df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<http://"
3657 #: ../edit/virt-edit.pod:5
3658 msgid "virt-edit - Edit a file in a virtual machine"
3662 #: ../edit/virt-edit.pod:9
3665 " virt-edit [--options] -d domname file [file ...]\n"
3670 #: ../edit/virt-edit.pod:11
3673 " virt-edit [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
3678 #: ../edit/virt-edit.pod:13
3681 " virt-edit [-d domname|-a disk.img] file -e 'expr'\n"
3686 #: ../edit/virt-edit.pod:17
3689 " virt-edit domname file\n"
3694 #: ../edit/virt-edit.pod:19 ../edit/virt-edit.pod:183
3697 " virt-edit disk.img [disk.img ...] file\n"
3702 #: ../edit/virt-edit.pod:21 ../fish/guestfish.pod:23
3703 #: ../fish/virt-copy-in.pod:13 ../fish/virt-tar-in.pod:15
3704 #: ../fuse/guestmount.pod:15 ../rescue/virt-rescue.pod:19
3705 #: ../tools/virt-tar.pl:64 ../tools/virt-win-reg.pl:51
3710 #: ../edit/virt-edit.pod:23
3712 "You must I<not> use C<virt-edit> on live virtual machines. If you do this, "
3713 "you risk disk corruption in the VM. C<virt-edit> tries to stop you from "
3714 "doing this, but doesn't catch all cases."
3718 #: ../edit/virt-edit.pod:29
3720 "C<virt-edit> is a command line tool to edit C<file> where each C<file> "
3721 "exists in the named virtual machine (or disk image)."
3725 #: ../edit/virt-edit.pod:32
3727 "Multiple filenames can be given, in which case they are each edited in "
3728 "turn. Each filename must be a full path, starting at the root directory "
3729 "(starting with '/')."
3733 #: ../edit/virt-edit.pod:36
3734 msgid "If you want to just view a file, use L<virt-cat(1)>."
3738 #: ../edit/virt-edit.pod:38
3740 "For more complex cases you should look at the L<guestfish(1)> tool (see L</"
3741 "USING GUESTFISH> below)."
3745 #: ../edit/virt-edit.pod:41
3747 "C<virt-edit> cannot be used to create a new file. L<guestfish(1)> can do "
3748 "that and much more."
3752 #: ../edit/virt-edit.pod:46
3753 msgid "Edit the named files interactively:"
3757 #: ../edit/virt-edit.pod:48
3760 " virt-edit -d mydomain /boot/grub/grub.conf\n"
3765 #: ../edit/virt-edit.pod:50
3768 " virt-edit -d mydomain /etc/passwd\n"
3773 #: ../edit/virt-edit.pod:52
3774 msgid "For Windows guests, some Windows paths are understood:"
3778 #: ../edit/virt-edit.pod:54
3781 " virt-edit -d mywindomain 'c:\\autoexec.bat'\n"
3786 #: ../edit/virt-edit.pod:56
3788 "If Perl is installed, you can also edit files non-interactively (see L</NON-"
3789 "INTERACTIVE EDITING> below). To change the init default level to 5:"
3793 #: ../edit/virt-edit.pod:60
3796 " virt-edit -d mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
3801 #: ../edit/virt-edit.pod:81
3802 msgid "B<-b> extension"
3806 #: ../edit/virt-edit.pod:83
3807 msgid "B<--backup> extension"
3811 #: ../edit/virt-edit.pod:85
3813 "Create a backup of the original file I<in the guest disk image>. The backup "
3814 "has the original filename with C<extension> added."
3818 #: ../edit/virt-edit.pod:88
3820 "Usually the first character of C<extension> would be a dot C<.> so you would "
3825 #: ../edit/virt-edit.pod:91
3828 " virt-edit -b .orig [etc]\n"
3833 #: ../edit/virt-edit.pod:93
3834 msgid "By default, no backup file is made."
3838 #: ../edit/virt-edit.pod:95 ../fish/guestfish.pod:181
3839 #: ../fuse/guestmount.pod:96 ../inspector/virt-inspector.pod:74
3840 #: ../tools/virt-list-filesystems.pl:77 ../tools/virt-list-partitions.pl:78
3841 #: ../tools/virt-tar.pl:127 ../tools/virt-win-reg.pl:128
3846 #: ../edit/virt-edit.pod:97 ../fish/guestfish.pod:183
3847 #: ../fuse/guestmount.pod:98 ../inspector/virt-inspector.pod:76
3848 #: ../tools/virt-list-filesystems.pl:79 ../tools/virt-list-partitions.pl:80
3849 #: ../tools/virt-tar.pl:129 ../tools/virt-win-reg.pl:130
3850 msgid "B<--connect URI>"
3854 #: ../edit/virt-edit.pod:102 ../tools/virt-list-filesystems.pl:84
3855 #: ../tools/virt-list-partitions.pl:85 ../tools/virt-tar.pl:134
3856 #: ../tools/virt-win-reg.pl:135
3858 "If you specify guest block devices directly, then libvirt is not used at all."
3862 #: ../edit/virt-edit.pod:114
3864 "When prompting for keys and passphrases, virt-edit normally turns echoing "
3865 "off so you cannot see what you are typing. If you are not worried about "
3866 "Tempest attacks and there is no one else in the room you can specify this "
3867 "flag to see what you are typing."
3871 #: ../edit/virt-edit.pod:119
3876 #: ../edit/virt-edit.pod:121
3877 msgid "B<--expr> EXPR"
3881 #: ../edit/virt-edit.pod:123
3883 "Instead of launching the external editor, non-interactively apply the Perl "
3884 "expression C<EXPR> to each line in the file. See L</NON-INTERACTIVE "
3889 #: ../edit/virt-edit.pod:127
3891 "Be careful to properly quote the expression to prevent it from being altered "
3896 #: ../edit/virt-edit.pod:130
3897 msgid "Note that this option is only available when Perl 5 is installed."
3901 #: ../edit/virt-edit.pod:132
3902 msgid "B<--format> raw|qcow2|..."
3906 #: ../edit/virt-edit.pod:143
3909 " virt-edit --format=raw -a disk.img file\n"
3914 #: ../edit/virt-edit.pod:147
3917 " virt-edit --format=raw -a disk.img --format -a another.img file\n"
3922 #: ../edit/virt-edit.pod:181
3923 msgid "Previous versions of virt-edit allowed you to write either:"
3927 #: ../edit/virt-edit.pod:187
3930 " virt-edit guestname file\n"
3935 #: ../edit/virt-edit.pod:195
3936 msgid "NON-INTERACTIVE EDITING"
3940 #: ../edit/virt-edit.pod:197
3942 "C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
3943 "administrator can interactively edit the file."
3947 #: ../edit/virt-edit.pod:200
3949 "There are two ways also to use C<virt-edit> from scripts in order to make "
3950 "automated edits to files. (Note that although you I<can> use C<virt-edit> "
3951 "like this, it's less error-prone to write scripts directly using the "
3952 "libguestfs API and Augeas for configuration file editing.)"
3956 #: ../edit/virt-edit.pod:206
3958 "The first method is to temporarily set C<$EDITOR> to any script or program "
3959 "you want to run. The script is invoked as C<$EDITOR tmpfile> and it should "
3960 "update C<tmpfile> in place however it likes."
3964 #: ../edit/virt-edit.pod:210
3966 "The second method is to use the I<-e> parameter of C<virt-edit> to run a "
3967 "short Perl snippet in the style of L<sed(1)>. For example to replace all "
3968 "instances of C<foo> with C<bar> in a file:"
3972 #: ../edit/virt-edit.pod:214
3975 " virt-edit -d domname filename -e 's/foo/bar/'\n"
3980 #: ../edit/virt-edit.pod:216
3982 "The full power of Perl regular expressions can be used (see L<perlre(1)>). "
3983 "For example to delete root's password you could do:"
3987 #: ../edit/virt-edit.pod:219
3990 " virt-edit -d domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
3995 #: ../edit/virt-edit.pod:221
3997 "What really happens is that the snippet is evaluated as a Perl expression "
3998 "for each line of the file. The line, including the final C<\\n>, is passed "
3999 "in C<$_> and the expression should update C<$_> or leave it unchanged."
4003 #: ../edit/virt-edit.pod:226
4005 "To delete a line, set C<$_> to the empty string. For example, to delete the "
4006 "C<apache> user account from the password file you can do:"
4010 #: ../edit/virt-edit.pod:229
4013 " virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
4018 #: ../edit/virt-edit.pod:231
4020 "To insert a line, prepend or append it to C<$_>. However appending lines to "
4021 "the end of the file is rather difficult this way since there is no concept "
4022 "of \"last line of the file\" - your expression just doesn't get called "
4023 "again. You might want to use the first method (setting C<$EDITOR>) if you "
4028 #: ../edit/virt-edit.pod:237
4030 "The variable C<$lineno> contains the current line number. As is "
4031 "traditional, the first line in the file is number C<1>."
4035 #: ../edit/virt-edit.pod:240
4037 "The return value from the expression is ignored, but the expression may call "
4038 "C<die> in order to abort the whole program, leaving the original file "
4043 #: ../edit/virt-edit.pod:244
4045 "Remember when matching the end of a line that C<$_> may contain the final C<"
4046 "\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a "
4047 "newline then neither of these. Thus to match or substitute some text at the "
4048 "end of a line, use this regular expression:"
4052 #: ../edit/virt-edit.pod:249
4055 " /some text(\\r?\\n)?$/\n"
4060 #: ../edit/virt-edit.pod:251
4062 "Alternately, use the perl C<chomp> function, being careful not to chomp C<"
4063 "$_> itself (since that would remove all newlines from the file):"
4067 #: ../edit/virt-edit.pod:255
4070 " my $m = $_; chomp $m; $m =~ /some text$/\n"
4075 #: ../edit/virt-edit.pod:257 ../fish/guestfish.pod:858
4076 msgid "WINDOWS PATHS"
4080 #: ../edit/virt-edit.pod:259
4082 "C<virt-edit> has a limited ability to understand Windows drive letters and "
4083 "paths (eg. C<E:\\foo\\bar.txt>)."
4087 #: ../edit/virt-edit.pod:262
4088 msgid "If and only if the guest is running Windows then:"
4092 #: ../edit/virt-edit.pod:268
4094 "Drive letter prefixes like C<C:> are resolved against the Windows Registry "
4095 "to the correct filesystem."
4099 #: ../edit/virt-edit.pod:273
4101 "Any backslash (C<\\>) characters in the path are replaced with forward "
4102 "slashes so that libguestfs can process it."
4106 #: ../edit/virt-edit.pod:278
4108 "The path is resolved case insensitively to locate the file that should be "
4113 #: ../edit/virt-edit.pod:283
4114 msgid "There are some known shortcomings:"
4118 #: ../edit/virt-edit.pod:289
4119 msgid "Some NTFS symbolic links may not be followed correctly."
4123 #: ../edit/virt-edit.pod:293
4124 msgid "NTFS junction points that cross filesystems are not followed."
4128 #: ../edit/virt-edit.pod:299
4130 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
4131 "C<virt-edit> doesn't work."
4135 #: ../edit/virt-edit.pod:302
4136 msgid "Using C<virt-edit> is approximately equivalent to doing:"
4140 #: ../edit/virt-edit.pod:304
4143 " guestfish --rw -i -d domname edit /file\n"
4148 #: ../edit/virt-edit.pod:306
4150 "where C<domname> is the name of the libvirt guest, and C</file> is the full "
4155 #: ../edit/virt-edit.pod:309
4157 "The command above uses libguestfs's guest inspection feature and so does not "
4158 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
4159 "disk images that don't contain guests. To edit a file on a disk image "
4164 #: ../edit/virt-edit.pod:314
4167 " guestfish --rw -a disk.img -m /dev/sda1 edit /file\n"
4172 #: ../edit/virt-edit.pod:316
4174 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
4175 "the disk image to edit, and C</file> is the full path to the file."