Version 1.13.25.
[libguestfs.git] / po-docs / ja.po
1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Red Hat Inc.
3 # This file is distributed under the same license as the libguestfs package.
4 #
5 # Translators:
6 # rjones <rjones@redhat.com>, 2011.
7 #   <www.carrotsoft@gmail.com>, 2011.
8 msgid ""
9 msgstr ""
10 "Project-Id-Version: libguestfs\n"
11 "Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
12 "POT-Creation-Date: 2011-10-26 14:08+0200\n"
13 "PO-Revision-Date: 2011-10-19 15:46+0000\n"
14 "Last-Translator: rjones <rjones@redhat.com>\n"
15 "Language-Team: Japanese <trans-ja@lists.fedoraproject.org>\n"
16 "Language: ja\n"
17 "MIME-Version: 1.0\n"
18 "Content-Type: text/plain; charset=UTF-8\n"
19 "Content-Transfer-Encoding: 8bit\n"
20 "Plural-Forms: nplurals=1; plural=0\n"
21
22 #. type: =head1
23 #: ../align/virt-alignment-scan.pod:3 ../cat/virt-cat.pod:3
24 #: ../cat/virt-filesystems.pod:3 ../cat/virt-ls.pod:3
25 #: ../clone/virt-sysprep.pod:3 ../df/virt-df.pod:3 ../edit/virt-edit.pod:3
26 #: ../erlang/examples/guestfs-erlang.pod:3 ../examples/guestfs-examples.pod:3
27 #: ../examples/guestfs-recipes.pod:14 ../fish/guestfish.pod:3
28 #: ../fish/virt-copy-in.pod:3 ../fish/virt-copy-out.pod:3
29 #: ../fish/virt-tar-in.pod:3 ../fish/virt-tar-out.pod:3
30 #: ../fuse/guestmount.pod:3 ../inspector/virt-inspector.pod:3
31 #: ../java/examples/guestfs-java.pod:3 ../ocaml/examples/guestfs-ocaml.pod:3
32 #: ../perl/examples/guestfs-perl.pod:3 ../python/examples/guestfs-python.pod:3
33 #: ../rescue/virt-rescue.pod:3 ../resize/virt-resize.pod:3
34 #: ../ruby/examples/guestfs-ruby.pod:3 ../sparsify/virt-sparsify.pod:3
35 #: ../src/guestfs.pod:3 ../test-tool/libguestfs-test-tool.pod:3
36 #: ../tools/virt-list-filesystems.pl:30 ../tools/virt-list-partitions.pl:30
37 #: ../tools/virt-make-fs.pl:35 ../tools/virt-tar.pl:31
38 #: ../tools/virt-win-reg.pl:35
39 msgid "NAME"
40 msgstr "名前"
41
42 #. type: textblock
43 #: ../align/virt-alignment-scan.pod:5
44 msgid "virt-alignment-scan - Check alignment of virtual machine partitions"
45 msgstr ""
46
47 #. type: =head1
48 #: ../align/virt-alignment-scan.pod:7 ../cat/virt-cat.pod:7
49 #: ../cat/virt-filesystems.pod:7 ../cat/virt-ls.pod:7
50 #: ../clone/virt-sysprep.pod:7 ../df/virt-df.pod:7 ../edit/virt-edit.pod:7
51 #: ../erlang/examples/guestfs-erlang.pod:7 ../examples/guestfs-examples.pod:7
52 #: ../fish/guestfish.pod:7 ../fish/virt-copy-in.pod:7
53 #: ../fish/virt-copy-out.pod:7 ../fish/virt-tar-in.pod:7
54 #: ../fish/virt-tar-out.pod:7 ../fuse/guestmount.pod:7
55 #: ../inspector/virt-inspector.pod:7 ../java/examples/guestfs-java.pod:7
56 #: ../ocaml/examples/guestfs-ocaml.pod:7 ../perl/examples/guestfs-perl.pod:7
57 #: ../python/examples/guestfs-python.pod:7 ../rescue/virt-rescue.pod:7
58 #: ../resize/virt-resize.pod:7 ../ruby/examples/guestfs-ruby.pod:7
59 #: ../sparsify/virt-sparsify.pod:7 ../src/guestfs.pod:7
60 #: ../test-tool/libguestfs-test-tool.pod:7
61 #: ../tools/virt-list-filesystems.pl:34 ../tools/virt-list-partitions.pl:34
62 #: ../tools/virt-make-fs.pl:39 ../tools/virt-tar.pl:35
63 #: ../tools/virt-win-reg.pl:39
64 msgid "SYNOPSIS"
65 msgstr ""
66
67 #. type: verbatim
68 #: ../align/virt-alignment-scan.pod:9
69 #, no-wrap
70 msgid ""
71 " virt-alignment-scan [--options] -d domname\n"
72 "\n"
73 msgstr ""
74
75 #. type: verbatim
76 #: ../align/virt-alignment-scan.pod:11
77 #, no-wrap
78 msgid ""
79 " virt-alignment-scan [--options] -a disk.img [-a disk.img ...]\n"
80 "\n"
81 msgstr ""
82
83 #. type: =head1
84 #: ../align/virt-alignment-scan.pod:13 ../cat/virt-cat.pod:19
85 #: ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19
86 #: ../clone/virt-sysprep.pod:13 ../df/virt-df.pod:21 ../edit/virt-edit.pod:27
87 #: ../erlang/examples/guestfs-erlang.pod:16
88 #: ../examples/guestfs-examples.pod:19 ../examples/guestfs-recipes.pod:18
89 #: ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19
90 #: ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21
91 #: ../fish/virt-tar-out.pod:15 ../fuse/guestmount.pod:20
92 #: ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15
93 #: ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:18
94 #: ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:29
95 #: ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15
96 #: ../sparsify/virt-sparsify.pod:11 ../src/guestfs.pod:23
97 #: ../test-tool/libguestfs-test-tool.pod:11
98 #: ../tools/virt-list-filesystems.pl:40 ../tools/virt-list-partitions.pl:40
99 #: ../tools/virt-make-fs.pl:47 ../tools/virt-tar.pl:77
100 #: ../tools/virt-win-reg.pl:63
101 msgid "DESCRIPTION"
102 msgstr ""
103
104 #. type: textblock
105 #: ../align/virt-alignment-scan.pod:15
106 msgid ""
107 "When older operating systems install themselves, the partitioning tools "
108 "place partitions at a sector misaligned with the underlying storage "
109 "(commonly the first partition starts on sector C<63>).  Misaligned "
110 "partitions can result in an operating system issuing more I/O than should be "
111 "necessary."
112 msgstr ""
113
114 #. type: textblock
115 #: ../align/virt-alignment-scan.pod:21
116 msgid ""
117 "The virt-alignment-scan tool checks the alignment of partitions in virtual "
118 "machines and disk images and warns you if there are alignment problems."
119 msgstr ""
120
121 #. type: textblock
122 #: ../align/virt-alignment-scan.pod:25
123 msgid ""
124 "Currently there is no virt tool for fixing alignment problems.  You can only "
125 "reinstall the guest operating system.  The following NetApp document "
126 "summarises the problem and possible solutions: L<http://media.netapp.com/"
127 "documents/tr-3747.pdf>"
128 msgstr ""
129
130 #. type: =head1
131 #: ../align/virt-alignment-scan.pod:30
132 msgid "OUTPUT"
133 msgstr ""
134
135 #. type: textblock
136 #: ../align/virt-alignment-scan.pod:32
137 msgid "To run this tool on a disk image directly, use the I<-a> option:"
138 msgstr ""
139
140 #. type: verbatim
141 #: ../align/virt-alignment-scan.pod:34
142 #, no-wrap
143 msgid ""
144 " $ virt-alignment-scan -a winxp.img\n"
145 " /dev/sda1        32256          512    bad (alignment < 4K)\n"
146 "\n"
147 msgstr ""
148
149 #. type: verbatim
150 #: ../align/virt-alignment-scan.pod:37
151 #, no-wrap
152 msgid ""
153 " $ virt-alignment-scan -a fedora16.img\n"
154 " /dev/sda1      1048576         1024K   ok\n"
155 " /dev/sda2      2097152         2048K   ok\n"
156 " /dev/sda3    526385152         2048K   ok\n"
157 "\n"
158 msgstr ""
159
160 #. type: textblock
161 #: ../align/virt-alignment-scan.pod:42
162 msgid ""
163 "To run the tool on a guest known to libvirt, use the I<-d> option and "
164 "possibly the I<-c> option:"
165 msgstr ""
166
167 #. type: verbatim
168 #: ../align/virt-alignment-scan.pod:45
169 #, no-wrap
170 msgid ""
171 " # virt-alignment-scan -d RHEL5\n"
172 " /dev/sda1        32256          512    bad (alignment < 4K)\n"
173 " /dev/sda2    106928640          512    bad (alignment < 4K)\n"
174 "\n"
175 msgstr ""
176
177 #. type: verbatim
178 #: ../align/virt-alignment-scan.pod:49
179 #, no-wrap
180 msgid ""
181 " $ virt-alignment-scan -c qemu:///system -d Win7TwoDisks\n"
182 " /dev/sda1      1048576         1024K   ok\n"
183 " /dev/sda2    105906176         1024K   ok\n"
184 " /dev/sdb1        65536           64K   ok\n"
185 "\n"
186 msgstr ""
187
188 #. type: textblock
189 #: ../align/virt-alignment-scan.pod:54
190 msgid ""
191 "The output consists of 4 or more whitespace-separated columns.  Only the "
192 "first 4 columns are signficant if you want to parse this from a program.  "
193 "The columns are:"
194 msgstr ""
195
196 #. type: =item
197 #: ../align/virt-alignment-scan.pod:60
198 msgid "col 1"
199 msgstr ""
200
201 #. type: textblock
202 #: ../align/virt-alignment-scan.pod:62
203 msgid ""
204 "the device and partition name (eg. C</dev/sda1> meaning the first partition "
205 "on the first block device)"
206 msgstr ""
207
208 #. type: =item
209 #: ../align/virt-alignment-scan.pod:65
210 msgid "col 2"
211 msgstr ""
212
213 #. type: textblock
214 #: ../align/virt-alignment-scan.pod:67
215 msgid "the start of the partition in bytes"
216 msgstr ""
217
218 #. type: =item
219 #: ../align/virt-alignment-scan.pod:69
220 msgid "col 3"
221 msgstr ""
222
223 #. type: textblock
224 #: ../align/virt-alignment-scan.pod:71
225 msgid "the alignment in bytes or Kbytes (eg. C<512> or C<4K>)"
226 msgstr ""
227
228 #. type: =item
229 #: ../align/virt-alignment-scan.pod:73
230 msgid "col 4"
231 msgstr ""
232
233 #. type: textblock
234 #: ../align/virt-alignment-scan.pod:75
235 msgid ""
236 "C<ok> if the alignment is best for performance, or C<bad> if the alignment "
237 "can cause performance problems"
238 msgstr ""
239
240 #. type: =item
241 #: ../align/virt-alignment-scan.pod:78
242 msgid "cols 5+"
243 msgstr ""
244
245 #. type: textblock
246 #: ../align/virt-alignment-scan.pod:80
247 msgid "optional free-text explanation."
248 msgstr ""
249
250 #. type: textblock
251 #: ../align/virt-alignment-scan.pod:84
252 msgid ""
253 "The exit code from the program changes depending on whether poorly aligned "
254 "partitions were found.  See L</EXIT STATUS> below."
255 msgstr ""
256
257 #. type: textblock
258 #: ../align/virt-alignment-scan.pod:87
259 msgid "If you just want the exit code with no output, use the I<-q> option."
260 msgstr ""
261
262 #. type: =head1
263 #: ../align/virt-alignment-scan.pod:89 ../cat/virt-cat.pod:62
264 #: ../cat/virt-filesystems.pod:91 ../cat/virt-ls.pod:261
265 #: ../clone/virt-sysprep.pod:42 ../df/virt-df.pod:59 ../edit/virt-edit.pod:62
266 #: ../fish/guestfish.pod:148 ../fish/virt-copy-in.pod:45
267 #: ../fish/virt-copy-out.pod:34 ../fish/virt-tar-in.pod:42
268 #: ../fish/virt-tar-out.pod:36 ../fuse/guestmount.pod:92
269 #: ../inspector/virt-inspector.pod:55 ../rescue/virt-rescue.pod:84
270 #: ../resize/virt-resize.pod:262 ../sparsify/virt-sparsify.pod:99
271 #: ../test-tool/libguestfs-test-tool.pod:36
272 #: ../tools/virt-list-filesystems.pl:53 ../tools/virt-list-partitions.pl:54
273 #: ../tools/virt-make-fs.pl:153 ../tools/virt-tar.pl:103
274 #: ../tools/virt-win-reg.pl:96
275 msgid "OPTIONS"
276 msgstr ""
277
278 #. type: =item
279 #: ../align/virt-alignment-scan.pod:93 ../cat/virt-cat.pod:66
280 #: ../cat/virt-filesystems.pod:95 ../cat/virt-ls.pod:265
281 #: ../clone/virt-sysprep.pod:46 ../df/virt-df.pod:63 ../edit/virt-edit.pod:66
282 #: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:160
283 #: ../inspector/virt-inspector.pod:59 ../rescue/virt-rescue.pod:88
284 #: ../resize/virt-resize.pod:266 ../sparsify/virt-sparsify.pod:103
285 #: ../test-tool/libguestfs-test-tool.pod:40
286 #: ../tools/virt-list-filesystems.pl:61 ../tools/virt-list-partitions.pl:62
287 #: ../tools/virt-make-fs.pl:161 ../tools/virt-tar.pl:111
288 #: ../tools/virt-win-reg.pl:104
289 msgid "B<--help>"
290 msgstr ""
291
292 #. type: textblock
293 #: ../align/virt-alignment-scan.pod:95 ../cat/virt-cat.pod:68
294 #: ../cat/virt-filesystems.pod:97 ../cat/virt-ls.pod:267
295 #: ../clone/virt-sysprep.pod:48 ../df/virt-df.pod:65 ../edit/virt-edit.pod:68
296 #: ../inspector/virt-inspector.pod:61 ../rescue/virt-rescue.pod:90
297 #: ../tools/virt-list-filesystems.pl:63 ../tools/virt-list-partitions.pl:64
298 #: ../tools/virt-make-fs.pl:163 ../tools/virt-tar.pl:113
299 #: ../tools/virt-win-reg.pl:106
300 msgid "Display brief help."
301 msgstr ""
302
303 #. type: =item
304 #: ../align/virt-alignment-scan.pod:97 ../cat/virt-cat.pod:70
305 #: ../cat/virt-filesystems.pod:99 ../cat/virt-ls.pod:269
306 #: ../clone/virt-sysprep.pod:50 ../df/virt-df.pod:67 ../edit/virt-edit.pod:70
307 #: ../inspector/virt-inspector.pod:63 ../rescue/virt-rescue.pod:92
308 msgid "B<-a> file"
309 msgstr ""
310
311 #. type: =item
312 #: ../align/virt-alignment-scan.pod:99 ../cat/virt-cat.pod:72
313 #: ../cat/virt-filesystems.pod:101 ../cat/virt-ls.pod:271
314 #: ../clone/virt-sysprep.pod:52 ../df/virt-df.pod:69 ../edit/virt-edit.pod:72
315 #: ../inspector/virt-inspector.pod:65 ../rescue/virt-rescue.pod:94
316 msgid "B<--add> file"
317 msgstr ""
318
319 #. type: textblock
320 #: ../align/virt-alignment-scan.pod:101 ../clone/virt-sysprep.pod:54
321 msgid "Add I<file> which should be a disk image from a virtual machine."
322 msgstr ""
323
324 #. type: textblock
325 #: ../align/virt-alignment-scan.pod:103 ../cat/virt-cat.pod:78
326 #: ../cat/virt-filesystems.pod:107 ../cat/virt-ls.pod:277
327 #: ../clone/virt-sysprep.pod:56 ../df/virt-df.pod:75 ../edit/virt-edit.pod:78
328 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:102
329 #: ../inspector/virt-inspector.pod:71 ../rescue/virt-rescue.pod:100
330 msgid ""
331 "The format of the disk image is auto-detected.  To override this and force a "
332 "particular format use the I<--format=..> option."
333 msgstr ""
334
335 #. type: =item
336 #: ../align/virt-alignment-scan.pod:106 ../cat/virt-cat.pod:81
337 #: ../cat/virt-filesystems.pod:125 ../cat/virt-ls.pod:291
338 #: ../clone/virt-sysprep.pod:59 ../df/virt-df.pod:78
339 #: ../rescue/virt-rescue.pod:107
340 msgid "B<-c> URI"
341 msgstr ""
342
343 #. type: =item
344 #: ../align/virt-alignment-scan.pod:108 ../cat/virt-cat.pod:83
345 #: ../cat/virt-filesystems.pod:127 ../cat/virt-ls.pod:293
346 #: ../clone/virt-sysprep.pod:61 ../df/virt-df.pod:80
347 #: ../rescue/virt-rescue.pod:109
348 msgid "B<--connect> URI"
349 msgstr ""
350
351 #. type: textblock
352 #: ../align/virt-alignment-scan.pod:110 ../cat/virt-cat.pod:85
353 #: ../cat/virt-filesystems.pod:129 ../cat/virt-ls.pod:295
354 #: ../clone/virt-sysprep.pod:63 ../df/virt-df.pod:82 ../edit/virt-edit.pod:99
355 #: ../inspector/virt-inspector.pod:78 ../rescue/virt-rescue.pod:111
356 #: ../tools/virt-list-filesystems.pl:81 ../tools/virt-list-partitions.pl:82
357 #: ../tools/virt-tar.pl:131 ../tools/virt-win-reg.pl:132
358 msgid ""
359 "If using libvirt, connect to the given I<URI>.  If omitted, then we connect "
360 "to the default libvirt hypervisor."
361 msgstr ""
362
363 #. type: textblock
364 #: ../align/virt-alignment-scan.pod:113 ../cat/virt-cat.pod:88
365 #: ../cat/virt-filesystems.pod:132 ../cat/virt-ls.pod:298
366 #: ../clone/virt-sysprep.pod:66 ../df/virt-df.pod:85
367 #: ../rescue/virt-rescue.pod:114
368 msgid ""
369 "If you specify guest block devices directly (I<-a>), then libvirt is not "
370 "used at all."
371 msgstr ""
372
373 #. type: =item
374 #: ../align/virt-alignment-scan.pod:116 ../cat/virt-cat.pod:91
375 #: ../cat/virt-filesystems.pod:141 ../cat/virt-ls.pod:307
376 #: ../clone/virt-sysprep.pod:69 ../df/virt-df.pod:94 ../edit/virt-edit.pod:105
377 #: ../inspector/virt-inspector.pod:85 ../rescue/virt-rescue.pod:117
378 msgid "B<-d> guest"
379 msgstr ""
380
381 #. type: =item
382 #: ../align/virt-alignment-scan.pod:118 ../cat/virt-cat.pod:93
383 #: ../cat/virt-filesystems.pod:143 ../cat/virt-ls.pod:309
384 #: ../clone/virt-sysprep.pod:71 ../df/virt-df.pod:96 ../edit/virt-edit.pod:107
385 #: ../inspector/virt-inspector.pod:87 ../rescue/virt-rescue.pod:119
386 msgid "B<--domain> guest"
387 msgstr ""
388
389 #. type: textblock
390 #: ../align/virt-alignment-scan.pod:120 ../cat/virt-cat.pod:95
391 #: ../cat/virt-filesystems.pod:145 ../cat/virt-ls.pod:311
392 #: ../clone/virt-sysprep.pod:73 ../df/virt-df.pod:98 ../edit/virt-edit.pod:109
393 #: ../inspector/virt-inspector.pod:89 ../rescue/virt-rescue.pod:121
394 msgid ""
395 "Add all the disks from the named libvirt guest.  Domain UUIDs can be used "
396 "instead of names."
397 msgstr ""
398
399 #. type: =item
400 #: ../align/virt-alignment-scan.pod:123 ../cat/virt-cat.pod:105
401 #: ../cat/virt-filesystems.pod:170 ../cat/virt-ls.pod:328
402 #: ../clone/virt-sysprep.pod:95 ../df/virt-df.pod:101
403 #: ../fish/guestfish.pod:233 ../fuse/guestmount.pod:142
404 #: ../inspector/virt-inspector.pod:99 ../rescue/virt-rescue.pod:124
405 msgid "B<--format=raw|qcow2|..>"
406 msgstr ""
407
408 #. type: =item
409 #: ../align/virt-alignment-scan.pod:125 ../cat/virt-cat.pod:107
410 #: ../cat/virt-filesystems.pod:172 ../cat/virt-ls.pod:330
411 #: ../clone/virt-sysprep.pod:97 ../df/virt-df.pod:103
412 #: ../edit/virt-edit.pod:134 ../fish/guestfish.pod:235
413 #: ../fuse/guestmount.pod:144 ../inspector/virt-inspector.pod:101
414 #: ../rescue/virt-rescue.pod:126
415 msgid "B<--format>"
416 msgstr ""
417
418 #. type: textblock
419 #: ../align/virt-alignment-scan.pod:127 ../cat/virt-cat.pod:109
420 #: ../cat/virt-filesystems.pod:174 ../cat/virt-ls.pod:332
421 #: ../clone/virt-sysprep.pod:99 ../df/virt-df.pod:105
422 #: ../edit/virt-edit.pod:136 ../fish/guestfish.pod:237
423 #: ../fuse/guestmount.pod:146 ../rescue/virt-rescue.pod:128
424 msgid ""
425 "The default for the I<-a> option is to auto-detect the format of the disk "
426 "image.  Using this forces the disk format for I<-a> options which follow on "
427 "the command line.  Using I<--format> with no argument switches back to auto-"
428 "detection for subsequent I<-a> options."
429 msgstr ""
430
431 #. type: textblock
432 #: ../align/virt-alignment-scan.pod:132 ../cat/virt-cat.pod:114
433 #: ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337
434 #: ../clone/virt-sysprep.pod:104 ../df/virt-df.pod:110
435 #: ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242
436 #: ../fish/guestfish.pod:673 ../inspector/virt-inspector.pod:336
437 #: ../rescue/virt-rescue.pod:133 ../src/guestfs.pod:2877
438 msgid "For example:"
439 msgstr ""
440
441 #. type: verbatim
442 #: ../align/virt-alignment-scan.pod:134
443 #, no-wrap
444 msgid ""
445 " virt-alignment-scan --format=raw -a disk.img\n"
446 "\n"
447 msgstr ""
448
449 #. type: textblock
450 #: ../align/virt-alignment-scan.pod:136 ../cat/virt-cat.pod:118
451 #: ../cat/virt-filesystems.pod:183 ../cat/virt-ls.pod:341
452 #: ../clone/virt-sysprep.pod:108 ../df/virt-df.pod:114
453 #: ../edit/virt-edit.pod:145 ../fish/guestfish.pod:246
454 #: ../rescue/virt-rescue.pod:137
455 msgid "forces raw format (no auto-detection) for C<disk.img>."
456 msgstr ""
457
458 #. type: verbatim
459 #: ../align/virt-alignment-scan.pod:138
460 #, no-wrap
461 msgid ""
462 " virt-alignment-scan --format=raw -a disk.img --format -a another.img\n"
463 "\n"
464 msgstr ""
465
466 #. type: textblock
467 #: ../align/virt-alignment-scan.pod:140 ../cat/virt-cat.pod:122
468 #: ../cat/virt-filesystems.pod:187 ../cat/virt-ls.pod:345
469 #: ../clone/virt-sysprep.pod:112 ../df/virt-df.pod:118
470 #: ../edit/virt-edit.pod:149 ../fish/guestfish.pod:250
471 #: ../rescue/virt-rescue.pod:141
472 msgid ""
473 "forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
474 "detection for C<another.img>."
475 msgstr ""
476
477 #. type: textblock
478 #: ../align/virt-alignment-scan.pod:143 ../cat/virt-cat.pod:125
479 #: ../cat/virt-filesystems.pod:190 ../cat/virt-ls.pod:348
480 #: ../clone/virt-sysprep.pod:115 ../df/virt-df.pod:121
481 #: ../edit/virt-edit.pod:152 ../rescue/virt-rescue.pod:144
482 msgid ""
483 "If you have untrusted raw-format guest disk images, you should use this "
484 "option to specify the disk format.  This avoids a possible security problem "
485 "with malicious guests (CVE-2010-3851)."
486 msgstr ""
487
488 #. type: =item
489 #: ../align/virt-alignment-scan.pod:147 ../resize/virt-resize.pod:491
490 #: ../sparsify/virt-sparsify.pod:153
491 msgid "B<-q>"
492 msgstr ""
493
494 #. type: =item
495 #: ../align/virt-alignment-scan.pod:149 ../resize/virt-resize.pod:493
496 #: ../sparsify/virt-sparsify.pod:155
497 msgid "B<--quiet>"
498 msgstr ""
499
500 #. type: textblock
501 #: ../align/virt-alignment-scan.pod:151
502 msgid ""
503 "Don't produce any output.  Just set the exit code (see L</EXIT STATUS> "
504 "below)."
505 msgstr ""
506
507 #. type: =item
508 #: ../align/virt-alignment-scan.pod:154 ../cat/virt-cat.pod:134
509 #: ../cat/virt-filesystems.pod:261 ../cat/virt-ls.pod:425
510 #: ../clone/virt-sysprep.pod:138 ../df/virt-df.pod:173
511 #: ../edit/virt-edit.pod:161 ../fish/guestfish.pod:390
512 #: ../fuse/guestmount.pod:266 ../inspector/virt-inspector.pod:119
513 #: ../rescue/virt-rescue.pod:182 ../sparsify/virt-sparsify.pod:159
514 msgid "B<-v>"
515 msgstr ""
516
517 #. type: =item
518 #: ../align/virt-alignment-scan.pod:156 ../cat/virt-cat.pod:136
519 #: ../cat/virt-filesystems.pod:263 ../cat/virt-ls.pod:427
520 #: ../clone/virt-sysprep.pod:140 ../df/virt-df.pod:175
521 #: ../edit/virt-edit.pod:163 ../fish/guestfish.pod:392
522 #: ../fuse/guestmount.pod:268 ../inspector/virt-inspector.pod:121
523 #: ../rescue/virt-rescue.pod:184 ../sparsify/virt-sparsify.pod:161
524 msgid "B<--verbose>"
525 msgstr ""
526
527 #. type: textblock
528 #: ../align/virt-alignment-scan.pod:158 ../cat/virt-cat.pod:138
529 #: ../cat/virt-filesystems.pod:265 ../cat/virt-ls.pod:429
530 #: ../clone/virt-sysprep.pod:142 ../df/virt-df.pod:177
531 #: ../edit/virt-edit.pod:165 ../inspector/virt-inspector.pod:123
532 #: ../rescue/virt-rescue.pod:186 ../sparsify/virt-sparsify.pod:163
533 msgid "Enable verbose messages for debugging."
534 msgstr ""
535
536 #. type: =item
537 #: ../align/virt-alignment-scan.pod:160 ../cat/virt-cat.pod:140
538 #: ../cat/virt-filesystems.pod:267 ../cat/virt-ls.pod:431
539 #: ../clone/virt-sysprep.pod:144 ../df/virt-df.pod:179
540 #: ../edit/virt-edit.pod:167 ../fish/guestfish.pod:397
541 #: ../fuse/guestmount.pod:272 ../inspector/virt-inspector.pod:125
542 #: ../rescue/virt-rescue.pod:188 ../resize/virt-resize.pod:561
543 #: ../sparsify/virt-sparsify.pod:165
544 msgid "B<-V>"
545 msgstr ""
546
547 #. type: =item
548 #: ../align/virt-alignment-scan.pod:162 ../cat/virt-cat.pod:142
549 #: ../cat/virt-filesystems.pod:269 ../cat/virt-ls.pod:433
550 #: ../clone/virt-sysprep.pod:146 ../df/virt-df.pod:181
551 #: ../edit/virt-edit.pod:169 ../fish/guestfish.pod:399
552 #: ../fuse/guestmount.pod:274 ../inspector/virt-inspector.pod:127
553 #: ../rescue/virt-rescue.pod:190 ../resize/virt-resize.pod:563
554 #: ../sparsify/virt-sparsify.pod:167 ../tools/virt-list-filesystems.pl:69
555 #: ../tools/virt-list-partitions.pl:70 ../tools/virt-make-fs.pl:169
556 #: ../tools/virt-tar.pl:119 ../tools/virt-win-reg.pl:112
557 msgid "B<--version>"
558 msgstr ""
559
560 #. type: textblock
561 #: ../align/virt-alignment-scan.pod:164 ../cat/virt-cat.pod:144
562 #: ../cat/virt-filesystems.pod:271 ../cat/virt-ls.pod:435
563 #: ../clone/virt-sysprep.pod:148 ../df/virt-df.pod:183
564 #: ../edit/virt-edit.pod:171 ../inspector/virt-inspector.pod:129
565 #: ../rescue/virt-rescue.pod:192 ../resize/virt-resize.pod:565
566 #: ../sparsify/virt-sparsify.pod:169 ../tools/virt-list-filesystems.pl:71
567 #: ../tools/virt-list-partitions.pl:72 ../tools/virt-make-fs.pl:171
568 #: ../tools/virt-tar.pl:121 ../tools/virt-win-reg.pl:114
569 msgid "Display version number and exit."
570 msgstr ""
571
572 #. type: =item
573 #: ../align/virt-alignment-scan.pod:166 ../cat/virt-cat.pod:146
574 #: ../cat/virt-filesystems.pod:281 ../cat/virt-ls.pod:437
575 #: ../clone/virt-sysprep.pod:150 ../df/virt-df.pod:185
576 #: ../edit/virt-edit.pod:173 ../fish/guestfish.pod:412
577 #: ../fuse/guestmount.pod:287 ../inspector/virt-inspector.pod:131
578 #: ../rescue/virt-rescue.pod:203 ../sparsify/virt-sparsify.pod:171
579 #: ../tools/virt-tar.pl:158
580 msgid "B<-x>"
581 msgstr ""
582
583 #. type: textblock
584 #: ../align/virt-alignment-scan.pod:168 ../cat/virt-cat.pod:148
585 #: ../cat/virt-filesystems.pod:283 ../cat/virt-ls.pod:439
586 #: ../clone/virt-sysprep.pod:152 ../df/virt-df.pod:187
587 #: ../edit/virt-edit.pod:175 ../inspector/virt-inspector.pod:133
588 #: ../rescue/virt-rescue.pod:205 ../sparsify/virt-sparsify.pod:173
589 msgid "Enable tracing of libguestfs API calls."
590 msgstr ""
591
592 #. type: =head1
593 #: ../align/virt-alignment-scan.pod:172
594 msgid "RECOMMENDED ALIGNMENT"
595 msgstr ""
596
597 #. type: textblock
598 #: ../align/virt-alignment-scan.pod:174
599 msgid ""
600 "Operating systems older than Windows 2008 and Linux before ca.2010 place the "
601 "first sector of the first partition at sector 63, with a 512 byte sector "
602 "size.  This happens because of a historical accident.  Drives have to report "
603 "a cylinder / head / sector (CHS) geometry to the BIOS.  The geometry is "
604 "completely meaningless on modern drives, but it happens that the geometry "
605 "reported always has 63 sectors per track.  The operating system therefore "
606 "places the first partition at the start of the second \"track\", at sector "
607 "63."
608 msgstr ""
609
610 #. type: textblock
611 #: ../align/virt-alignment-scan.pod:183
612 msgid ""
613 "When the guest OS is virtualized, the host operating system and hypervisor "
614 "may prefer accesses aligned to one of:"
615 msgstr ""
616
617 #. type: =item
618 #: ../align/virt-alignment-scan.pod:188
619 msgid "* 512 bytes"
620 msgstr ""
621
622 #. type: textblock
623 #: ../align/virt-alignment-scan.pod:190
624 msgid ""
625 "if the host OS uses local storage directly on hard drive partitions, and the "
626 "hard drive has 512 byte physical sectors."
627 msgstr ""
628
629 #. type: =item
630 #: ../align/virt-alignment-scan.pod:193
631 msgid "* 4 Kbytes"
632 msgstr ""
633
634 #. type: textblock
635 #: ../align/virt-alignment-scan.pod:195
636 msgid ""
637 "for local storage on new hard drives with 4Kbyte physical sectors; for file-"
638 "backed storage on filesystems with 4Kbyte block size; or for some types of "
639 "network-attached storage."
640 msgstr ""
641
642 #. type: =item
643 #: ../align/virt-alignment-scan.pod:199
644 msgid "* 64 Kbytes"
645 msgstr ""
646
647 #. type: textblock
648 #: ../align/virt-alignment-scan.pod:201
649 msgid ""
650 "for high-end network-attached storage.  This is the optimal block size for "
651 "some NetApp hardware."
652 msgstr ""
653
654 #. type: =item
655 #: ../align/virt-alignment-scan.pod:204
656 msgid "* 1 Mbyte"
657 msgstr ""
658
659 #. type: textblock
660 #: ../align/virt-alignment-scan.pod:206
661 msgid "see L</1 MB PARTITION ALIGNMENT> below."
662 msgstr ""
663
664 #. type: textblock
665 #: ../align/virt-alignment-scan.pod:210
666 msgid ""
667 "Partitions which are not aligned correctly to the underlying storage cause "
668 "extra I/O.  For example:"
669 msgstr ""
670
671 #. type: verbatim
672 #: ../align/virt-alignment-scan.pod:213
673 #, no-wrap
674 msgid ""
675 "                       sect#63\n"
676 "                       +--------------------------+------\n"
677 "                       |         guest            |\n"
678 "                       |    filesystem block      |\n"
679 " ---+------------------+------+-------------------+-----+---\n"
680 "    |  host block             |  host block             |\n"
681 "    |                         |                         |\n"
682 " ---+-------------------------+-------------------------+---\n"
683 "\n"
684 msgstr ""
685
686 #. type: textblock
687 #: ../align/virt-alignment-scan.pod:222
688 msgid ""
689 "In this example, each time a 4K guest block is read, two blocks on the host "
690 "must be accessed (so twice as much I/O is done).  When a 4K guest block is "
691 "written, two host blocks must first be read, the old and new data combined, "
692 "and the two blocks written back (4x I/O)."
693 msgstr ""
694
695 #. type: =head2
696 #: ../align/virt-alignment-scan.pod:227
697 msgid "LINUX HOST BLOCK AND I/O SIZE"
698 msgstr ""
699
700 #. type: textblock
701 #: ../align/virt-alignment-scan.pod:229
702 msgid ""
703 "New versions of the Linux kernel expose the physical and logical block size, "
704 "and minimum and recommended I/O size."
705 msgstr ""
706
707 #. type: textblock
708 #: ../align/virt-alignment-scan.pod:232
709 msgid "For a typical hard drive with 512 byte sectors:"
710 msgstr ""
711
712 #. type: verbatim
713 #: ../align/virt-alignment-scan.pod:234
714 #, no-wrap
715 msgid ""
716 " $ cat /sys/block/sda/queue/physical_block_size\n"
717 " 512\n"
718 " $ cat /sys/block/sda/queue/logical_block_size\n"
719 " 512\n"
720 " $ cat /sys/block/sda/queue/minimum_io_size\n"
721 " 512\n"
722 " $ cat /sys/block/sda/queue/optimal_io_size\n"
723 " 0\n"
724 "\n"
725 msgstr ""
726
727 #. type: textblock
728 #: ../align/virt-alignment-scan.pod:243
729 msgid "For a NetApp LUN:"
730 msgstr ""
731
732 #. type: verbatim
733 #: ../align/virt-alignment-scan.pod:245
734 #, no-wrap
735 msgid ""
736 " $ cat /sys/block/sdc/queue/logical_block_size\n"
737 " 512\n"
738 " $ cat /sys/block/sdc/queue/physical_block_size\n"
739 " 512\n"
740 " $ cat /sys/block/sdc/queue/minimum_io_size\n"
741 " 4096\n"
742 " $ cat /sys/block/sdc/queue/optimal_io_size\n"
743 " 65536\n"
744 "\n"
745 msgstr ""
746
747 #. type: textblock
748 #: ../align/virt-alignment-scan.pod:254
749 msgid ""
750 "The NetApp allows 512 byte accesses (but they will be very inefficient), "
751 "prefers a minimum 4K I/O size, but the optimal I/O size is 64K."
752 msgstr ""
753
754 #. type: textblock
755 #: ../align/virt-alignment-scan.pod:258
756 msgid ""
757 "For detailed information about what these numbers mean, see L<http://docs."
758 "redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/"
759 "Storage_Administration_Guide/newstorage-iolimits.html>"
760 msgstr ""
761
762 #. type: textblock
763 #: ../align/virt-alignment-scan.pod:261
764 msgid ""
765 "[Thanks to Mike Snitzer for providing NetApp data and additional "
766 "information.]"
767 msgstr ""
768
769 #. type: =head2
770 #: ../align/virt-alignment-scan.pod:264
771 msgid "1 MB PARTITION ALIGNMENT"
772 msgstr ""
773
774 #. type: textblock
775 #: ../align/virt-alignment-scan.pod:266
776 msgid ""
777 "Microsoft picked 1 MB as the default alignment for all partitions starting "
778 "with Windows 2008 Server, and Linux has followed this."
779 msgstr ""
780
781 #. type: textblock
782 #: ../align/virt-alignment-scan.pod:269
783 msgid ""
784 "Assuming 512 byte sectors in the guest, you will now see the first partition "
785 "starting at sector 2048, and subsequent partitions (if any)  will start at a "
786 "multiple of 2048 sectors."
787 msgstr ""
788
789 #. type: textblock
790 #: ../align/virt-alignment-scan.pod:273
791 msgid ""
792 "1 MB alignment is compatible with all current alignment requirements (4K, "
793 "64K) and provides room for future growth in physical block sizes."
794 msgstr ""
795
796 #. type: =head2
797 #: ../align/virt-alignment-scan.pod:276
798 msgid "SETTING ALIGNMENT"
799 msgstr ""
800
801 #. type: textblock
802 #: ../align/virt-alignment-scan.pod:278
803 msgid ""
804 "L<virt-resize(1)> can change the alignment of the partitions of some "
805 "guests.  Currently it can fully align all the partitions of all Windows "
806 "guests, and it will fix the bootloader where necessary.  For Linux guests, "
807 "it can align the second and subsequent partitions, so the majority of OS "
808 "accesses except at boot will be aligned."
809 msgstr ""
810
811 #. type: textblock
812 #: ../align/virt-alignment-scan.pod:284
813 msgid ""
814 "Another way to correct partition alignment problems is to reinstall your "
815 "guest operating systems.  If you install operating systems from templates, "
816 "ensure these have correct partition alignment too."
817 msgstr ""
818
819 #. type: textblock
820 #: ../align/virt-alignment-scan.pod:288
821 msgid ""
822 "For older versions of Windows, the following NetApp document contains useful "
823 "information: L<http://media.netapp.com/documents/tr-3747.pdf>"
824 msgstr ""
825
826 #. type: textblock
827 #: ../align/virt-alignment-scan.pod:291
828 msgid ""
829 "For Red Hat Enterprise Linux E<le> 5, use a Kickstart script that contains "
830 "an explicit C<%pre> section that creates aligned partitions using L<parted(8)"
831 ">.  Do not use the Kickstart C<part> command.  The NetApp document above "
832 "contains an example."
833 msgstr ""
834
835 #. type: =head1
836 #: ../align/virt-alignment-scan.pod:296 ../cat/virt-cat.pod:231
837 #: ../cat/virt-filesystems.pod:373 ../cat/virt-ls.pod:483
838 #: ../clone/virt-sysprep.pod:475 ../df/virt-df.pod:215
839 #: ../edit/virt-edit.pod:342 ../inspector/virt-inspector.pod:352
840 #: ../rescue/virt-rescue.pod:266 ../resize/virt-resize.pod:676
841 #: ../tools/virt-list-filesystems.pl:188 ../tools/virt-list-partitions.pl:258
842 #: ../tools/virt-make-fs.pl:550 ../tools/virt-tar.pl:289
843 #: ../tools/virt-win-reg.pl:744
844 msgid "SHELL QUOTING"
845 msgstr ""
846
847 #. type: textblock
848 #: ../align/virt-alignment-scan.pod:298 ../cat/virt-cat.pod:233
849 #: ../cat/virt-filesystems.pod:375 ../cat/virt-ls.pod:485
850 #: ../clone/virt-sysprep.pod:477 ../df/virt-df.pod:217
851 #: ../edit/virt-edit.pod:344 ../inspector/virt-inspector.pod:354
852 #: ../rescue/virt-rescue.pod:268 ../resize/virt-resize.pod:678
853 #: ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260
854 #: ../tools/virt-make-fs.pl:552 ../tools/virt-tar.pl:291
855 #: ../tools/virt-win-reg.pl:752
856 msgid ""
857 "Libvirt guest names can contain arbitrary characters, some of which have "
858 "meaning to the shell such as C<#> and space.  You may need to quote or "
859 "escape these characters on the command line.  See the shell manual page L<sh"
860 "(1)> for details."
861 msgstr ""
862
863 #. type: =head1
864 #: ../align/virt-alignment-scan.pod:303 ../cat/virt-cat.pod:238
865 #: ../cat/virt-filesystems.pod:380 ../cat/virt-ls.pod:490
866 #: ../clone/virt-sysprep.pod:482 ../df/virt-df.pod:222
867 #: ../edit/virt-edit.pod:349 ../fish/guestfish.pod:1114
868 #: ../fuse/guestmount.pod:312 ../inspector/virt-inspector.pod:375
869 #: ../resize/virt-resize.pod:683 ../sparsify/virt-sparsify.pod:227
870 #: ../test-tool/libguestfs-test-tool.pod:90
871 msgid "EXIT STATUS"
872 msgstr ""
873
874 #. type: textblock
875 #: ../align/virt-alignment-scan.pod:305
876 msgid "This program returns:"
877 msgstr ""
878
879 #. type: =item
880 #: ../align/virt-alignment-scan.pod:309 ../align/virt-alignment-scan.pod:315
881 #: ../align/virt-alignment-scan.pod:321 ../align/virt-alignment-scan.pod:328
882 #: ../cat/virt-cat.pod:177 ../cat/virt-cat.pod:182 ../cat/virt-cat.pod:187
883 #: ../cat/virt-cat.pod:198 ../cat/virt-cat.pod:202
884 #: ../clone/virt-sysprep.pod:283 ../clone/virt-sysprep.pod:287
885 #: ../clone/virt-sysprep.pod:291 ../clone/virt-sysprep.pod:295
886 #: ../clone/virt-sysprep.pod:310 ../clone/virt-sysprep.pod:314
887 #: ../clone/virt-sysprep.pod:318 ../clone/virt-sysprep.pod:322
888 #: ../clone/virt-sysprep.pod:326 ../clone/virt-sysprep.pod:362
889 #: ../clone/virt-sysprep.pod:384 ../clone/virt-sysprep.pod:388
890 #: ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266
891 #: ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276
892 #: ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291
893 #: ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102
894 #: ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132
895 #: ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227
896 #: ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235
897 #: ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243
898 #: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20
899 #: ../fish/guestfish-actions.pod:395 ../fish/guestfish-actions.pod:403
900 #: ../fish/guestfish-actions.pod:410 ../fish/guestfish-actions.pod:417
901 #: ../fish/guestfish-actions.pod:1216 ../fish/guestfish-actions.pod:1220
902 #: ../fish/guestfish-actions.pod:1224 ../fish/guestfish-actions.pod:1228
903 #: ../fish/guestfish-actions.pod:1236 ../fish/guestfish-actions.pod:1240
904 #: ../fish/guestfish-actions.pod:1244 ../fish/guestfish-actions.pod:1254
905 #: ../fish/guestfish-actions.pod:1258 ../fish/guestfish-actions.pod:1262
906 #: ../fish/guestfish-actions.pod:1352 ../fish/guestfish-actions.pod:1356
907 #: ../fish/guestfish-actions.pod:1361 ../fish/guestfish-actions.pod:1366
908 #: ../fish/guestfish-actions.pod:1408 ../fish/guestfish-actions.pod:1412
909 #: ../fish/guestfish-actions.pod:1417 ../fish/guestfish-actions.pod:1673
910 #: ../fish/guestfish-actions.pod:1680 ../fish/guestfish-actions.pod:1687
911 #: ../fish/guestfish-actions.pod:2090 ../fish/guestfish-actions.pod:2096
912 #: ../fish/guestfish-actions.pod:2104 ../fish/guestfish-actions.pod:2111
913 #: ../fish/guestfish-actions.pod:2118 ../fish/guestfish.pod:445
914 #: ../fish/guestfish.pod:449 ../fish/guestfish.pod:453
915 #: ../fish/guestfish.pod:457 ../inspector/virt-inspector.pod:393
916 #: ../inspector/virt-inspector.pod:397 ../resize/virt-resize.pod:359
917 #: ../resize/virt-resize.pod:363 ../resize/virt-resize.pod:372
918 #: ../resize/virt-resize.pod:378 ../sparsify/virt-sparsify.pod:32
919 #: ../sparsify/virt-sparsify.pod:39 ../sparsify/virt-sparsify.pod:43
920 #: ../sparsify/virt-sparsify.pod:49 ../sparsify/virt-sparsify.pod:54
921 #: ../sparsify/virt-sparsify.pod:58 ../sparsify/virt-sparsify.pod:64
922 #: ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:29
923 #: ../src/guestfs-actions.pod:594 ../src/guestfs-actions.pod:602
924 #: ../src/guestfs-actions.pod:609 ../src/guestfs-actions.pod:616
925 #: ../src/guestfs-actions.pod:2024 ../src/guestfs-actions.pod:2028
926 #: ../src/guestfs-actions.pod:2032 ../src/guestfs-actions.pod:2036
927 #: ../src/guestfs-actions.pod:2044 ../src/guestfs-actions.pod:2048
928 #: ../src/guestfs-actions.pod:2052 ../src/guestfs-actions.pod:2062
929 #: ../src/guestfs-actions.pod:2066 ../src/guestfs-actions.pod:2070
930 #: ../src/guestfs-actions.pod:2208 ../src/guestfs-actions.pod:2212
931 #: ../src/guestfs-actions.pod:2217 ../src/guestfs-actions.pod:2222
932 #: ../src/guestfs-actions.pod:2283 ../src/guestfs-actions.pod:2287
933 #: ../src/guestfs-actions.pod:2292 ../src/guestfs-actions.pod:2707
934 #: ../src/guestfs-actions.pod:2714 ../src/guestfs-actions.pod:2721
935 #: ../src/guestfs-actions.pod:3266 ../src/guestfs-actions.pod:3272
936 #: ../src/guestfs-actions.pod:3280 ../src/guestfs-actions.pod:3287
937 #: ../src/guestfs-actions.pod:3294 ../src/guestfs.pod:403
938 #: ../src/guestfs.pod:408 ../src/guestfs.pod:413 ../src/guestfs.pod:417
939 #: ../src/guestfs.pod:422 ../src/guestfs.pod:426 ../src/guestfs.pod:431
940 #: ../src/guestfs.pod:436 ../src/guestfs.pod:1109 ../src/guestfs.pod:1113
941 #: ../src/guestfs.pod:1117 ../src/guestfs.pod:1122 ../src/guestfs.pod:1130
942 #: ../src/guestfs.pod:1149 ../src/guestfs.pod:1157 ../src/guestfs.pod:1179
943 #: ../src/guestfs.pod:1183 ../src/guestfs.pod:1187 ../src/guestfs.pod:1191
944 #: ../src/guestfs.pod:1195 ../src/guestfs.pod:1199 ../src/guestfs.pod:1689
945 #: ../src/guestfs.pod:1694 ../src/guestfs.pod:1698 ../src/guestfs.pod:1800
946 #: ../src/guestfs.pod:1805 ../src/guestfs.pod:1809 ../src/guestfs.pod:1819
947 #: ../src/guestfs.pod:2108 ../src/guestfs.pod:2113 ../src/guestfs.pod:2119
948 #: ../src/guestfs.pod:2127 ../src/guestfs.pod:2645 ../src/guestfs.pod:2651
949 #: ../src/guestfs.pod:2656 ../src/guestfs.pod:2662 ../src/guestfs.pod:3062
950 #: ../src/guestfs.pod:3067 ../src/guestfs.pod:3071 ../src/guestfs.pod:3075
951 #: ../src/guestfs.pod:3079 ../src/guestfs.pod:3093 ../src/guestfs.pod:3098
952 #: ../src/guestfs.pod:3329 ../src/guestfs.pod:3333 ../src/guestfs.pod:3337
953 #: ../src/guestfs.pod:3341 ../tools/virt-win-reg.pl:197
954 #: ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208
955 #: ../tools/virt-win-reg.pl:721 ../tools/virt-win-reg.pl:727
956 #: ../tools/virt-win-reg.pl:733
957 msgid "*"
958 msgstr ""
959
960 #. type: textblock
961 #: ../align/virt-alignment-scan.pod:311
962 msgid "0"
963 msgstr ""
964
965 #. type: textblock
966 #: ../align/virt-alignment-scan.pod:313
967 msgid ""
968 "successful exit, all partitions are aligned E<ge> 64K for best performance"
969 msgstr ""
970
971 #. type: textblock
972 #: ../align/virt-alignment-scan.pod:317
973 msgid "1"
974 msgstr ""
975
976 #. type: textblock
977 #: ../align/virt-alignment-scan.pod:319
978 msgid "an error scanning the disk image or guest"
979 msgstr ""
980
981 #. type: textblock
982 #: ../align/virt-alignment-scan.pod:323
983 msgid "2"
984 msgstr ""
985
986 #. type: textblock
987 #: ../align/virt-alignment-scan.pod:325
988 msgid ""
989 "successful exit, some partitions have alignment E<lt> 64K which can result "
990 "in poor performance on high end network storage"
991 msgstr ""
992
993 #. type: textblock
994 #: ../align/virt-alignment-scan.pod:330
995 msgid "3"
996 msgstr ""
997
998 #. type: textblock
999 #: ../align/virt-alignment-scan.pod:332
1000 msgid ""
1001 "successful exit, some partitions have alignment E<lt> 4K which can result in "
1002 "poor performance on most hypervisors"
1003 msgstr ""
1004
1005 #. type: =head1
1006 #: ../align/virt-alignment-scan.pod:337 ../cat/virt-cat.pod:243
1007 #: ../cat/virt-filesystems.pod:385 ../cat/virt-ls.pod:495
1008 #: ../clone/virt-sysprep.pod:486 ../df/virt-df.pod:227
1009 #: ../edit/virt-edit.pod:354 ../erlang/examples/guestfs-erlang.pod:97
1010 #: ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384
1011 #: ../fish/guestfish.pod:1268 ../fish/virt-copy-in.pod:50
1012 #: ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47
1013 #: ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:317
1014 #: ../inspector/virt-inspector.pod:380 ../java/examples/guestfs-java.pod:45
1015 #: ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39
1016 #: ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:288
1017 #: ../resize/virt-resize.pod:688 ../ruby/examples/guestfs-ruby.pod:36
1018 #: ../sparsify/virt-sparsify.pod:251 ../src/guestfs.pod:3270
1019 #: ../test-tool/libguestfs-test-tool.pod:100
1020 #: ../tools/virt-list-filesystems.pl:195 ../tools/virt-list-partitions.pl:265
1021 #: ../tools/virt-make-fs.pl:557 ../tools/virt-tar.pl:296
1022 #: ../tools/virt-win-reg.pl:757
1023 msgid "SEE ALSO"
1024 msgstr ""
1025
1026 #. type: textblock
1027 #: ../align/virt-alignment-scan.pod:339
1028 msgid ""
1029 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-rescue(1)>, "
1030 "L<virt-resize(1)>, L<http://libguestfs.org/>."
1031 msgstr ""
1032
1033 #. type: =head1
1034 #: ../align/virt-alignment-scan.pod:346 ../cat/virt-cat.pod:252
1035 #: ../cat/virt-filesystems.pod:396 ../cat/virt-ls.pod:507
1036 #: ../clone/virt-sysprep.pod:501 ../df/virt-df.pod:235
1037 #: ../edit/virt-edit.pod:368 ../rescue/virt-rescue.pod:296
1038 #: ../resize/virt-resize.pod:711 ../sparsify/virt-sparsify.pod:264
1039 #: ../tools/virt-list-filesystems.pl:208 ../tools/virt-list-partitions.pl:277
1040 #: ../tools/virt-make-fs.pl:582 ../tools/virt-tar.pl:311
1041 #: ../tools/virt-win-reg.pl:783
1042 msgid "AUTHOR"
1043 msgstr ""
1044
1045 #. type: textblock
1046 #: ../align/virt-alignment-scan.pod:348 ../cat/virt-cat.pod:254
1047 #: ../cat/virt-filesystems.pod:398 ../cat/virt-ls.pod:509
1048 #: ../clone/virt-sysprep.pod:503 ../df/virt-df.pod:237
1049 #: ../edit/virt-edit.pod:370 ../inspector/virt-inspector.pod:395
1050 #: ../rescue/virt-rescue.pod:298 ../resize/virt-resize.pod:713
1051 #: ../sparsify/virt-sparsify.pod:266 ../tools/virt-list-filesystems.pl:210
1052 #: ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:584
1053 #: ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:785
1054 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
1055 msgstr ""
1056
1057 #. type: =head1
1058 #: ../align/virt-alignment-scan.pod:350 ../cat/virt-cat.pod:256
1059 #: ../cat/virt-filesystems.pod:400 ../cat/virt-ls.pod:511
1060 #: ../clone/virt-sysprep.pod:505 ../df/virt-df.pod:239
1061 #: ../edit/virt-edit.pod:372 ../erlang/examples/guestfs-erlang.pod:114
1062 #: ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401
1063 #: ../fish/guestfish.pod:1300 ../fish/virt-copy-in.pod:64
1064 #: ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62
1065 #: ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:332
1066 #: ../inspector/virt-inspector.pod:403 ../java/examples/guestfs-java.pod:62
1067 #: ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56
1068 #: ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:300
1069 #: ../resize/virt-resize.pod:715 ../ruby/examples/guestfs-ruby.pod:52
1070 #: ../sparsify/virt-sparsify.pod:268 ../src/guestfs.pod:3352
1071 #: ../test-tool/libguestfs-test-tool.pod:110
1072 #: ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281
1073 #: ../tools/virt-make-fs.pl:586 ../tools/virt-tar.pl:315
1074 #: ../tools/virt-win-reg.pl:787
1075 msgid "COPYRIGHT"
1076 msgstr ""
1077
1078 #. type: textblock
1079 #: ../align/virt-alignment-scan.pod:352 ../clone/virt-sysprep.pod:507
1080 #: ../sparsify/virt-sparsify.pod:270
1081 msgid "Copyright (C) 2011 Red Hat Inc."
1082 msgstr ""
1083
1084 #. type: textblock
1085 #: ../align/virt-alignment-scan.pod:354 ../cat/virt-cat.pod:260
1086 #: ../cat/virt-filesystems.pod:404 ../cat/virt-ls.pod:515
1087 #: ../clone/virt-sysprep.pod:509 ../df/virt-df.pod:243
1088 #: ../edit/virt-edit.pod:376 ../fish/guestfish.pod:1305
1089 #: ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58
1090 #: ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60
1091 #: ../fuse/guestmount.pod:337 ../inspector/virt-inspector.pod:407
1092 #: ../rescue/virt-rescue.pod:304 ../resize/virt-resize.pod:719
1093 #: ../sparsify/virt-sparsify.pod:272 ../test-tool/libguestfs-test-tool.pod:115
1094 #: ../tools/virt-list-filesystems.pl:216 ../tools/virt-list-partitions.pl:285
1095 #: ../tools/virt-make-fs.pl:590 ../tools/virt-tar.pl:319
1096 #: ../tools/virt-win-reg.pl:791
1097 msgid ""
1098 "This program is free software; you can redistribute it and/or modify it "
1099 "under the terms of the GNU General Public License as published by the Free "
1100 "Software Foundation; either version 2 of the License, or (at your option) "
1101 "any later version."
1102 msgstr ""
1103
1104 #. type: textblock
1105 #: ../align/virt-alignment-scan.pod:359 ../cat/virt-cat.pod:265
1106 #: ../cat/virt-filesystems.pod:409 ../cat/virt-ls.pod:520
1107 #: ../clone/virt-sysprep.pod:514 ../df/virt-df.pod:248
1108 #: ../edit/virt-edit.pod:381 ../fish/guestfish.pod:1310
1109 #: ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63
1110 #: ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65
1111 #: ../fuse/guestmount.pod:342 ../inspector/virt-inspector.pod:412
1112 #: ../rescue/virt-rescue.pod:309 ../resize/virt-resize.pod:724
1113 #: ../sparsify/virt-sparsify.pod:277 ../test-tool/libguestfs-test-tool.pod:120
1114 #: ../tools/virt-list-filesystems.pl:221 ../tools/virt-list-partitions.pl:290
1115 #: ../tools/virt-make-fs.pl:595 ../tools/virt-tar.pl:324
1116 #: ../tools/virt-win-reg.pl:796
1117 msgid ""
1118 "This program is distributed in the hope that it will be useful, but WITHOUT "
1119 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
1120 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for "
1121 "more details."
1122 msgstr ""
1123
1124 #. type: textblock
1125 #: ../align/virt-alignment-scan.pod:364 ../cat/virt-cat.pod:270
1126 #: ../cat/virt-filesystems.pod:414 ../cat/virt-ls.pod:525
1127 #: ../clone/virt-sysprep.pod:519 ../df/virt-df.pod:253
1128 #: ../edit/virt-edit.pod:386 ../fish/guestfish.pod:1315
1129 #: ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68
1130 #: ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70
1131 #: ../fuse/guestmount.pod:347 ../inspector/virt-inspector.pod:417
1132 #: ../rescue/virt-rescue.pod:314 ../resize/virt-resize.pod:729
1133 #: ../sparsify/virt-sparsify.pod:282 ../test-tool/libguestfs-test-tool.pod:125
1134 #: ../tools/virt-list-filesystems.pl:226 ../tools/virt-list-partitions.pl:295
1135 #: ../tools/virt-make-fs.pl:600 ../tools/virt-tar.pl:329
1136 #: ../tools/virt-win-reg.pl:801
1137 msgid ""
1138 "You should have received a copy of the GNU General Public License along with "
1139 "this program; if not, write to the Free Software Foundation, Inc., 675 Mass "
1140 "Ave, Cambridge, MA 02139, USA."
1141 msgstr ""
1142
1143 #. type: textblock
1144 #: ../cat/virt-cat.pod:5
1145 msgid "virt-cat - Display files in a virtual machine"
1146 msgstr ""
1147
1148 #. type: verbatim
1149 #: ../cat/virt-cat.pod:9
1150 #, no-wrap
1151 msgid ""
1152 " virt-cat [--options] -d domname file [file ...]\n"
1153 "\n"
1154 msgstr ""
1155
1156 #. type: verbatim
1157 #: ../cat/virt-cat.pod:11
1158 #, no-wrap
1159 msgid ""
1160 " virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
1161 "\n"
1162 msgstr ""
1163
1164 #. type: textblock
1165 #: ../cat/virt-cat.pod:13 ../edit/virt-edit.pod:15
1166 #: ../inspector/virt-inspector.pod:13
1167 msgid "Old-style:"
1168 msgstr ""
1169
1170 #. type: verbatim
1171 #: ../cat/virt-cat.pod:15
1172 #, no-wrap
1173 msgid ""
1174 " virt-cat domname file\n"
1175 "\n"
1176 msgstr ""
1177
1178 #. type: verbatim
1179 #: ../cat/virt-cat.pod:17
1180 #, no-wrap
1181 msgid ""
1182 " virt-cat disk.img file\n"
1183 "\n"
1184 msgstr ""
1185
1186 #. type: textblock
1187 #: ../cat/virt-cat.pod:21
1188 msgid ""
1189 "C<virt-cat> is a command line tool to display the contents of C<file> where "
1190 "C<file> exists in the named virtual machine (or disk image)."
1191 msgstr ""
1192
1193 #. type: textblock
1194 #: ../cat/virt-cat.pod:24
1195 msgid ""
1196 "Multiple filenames can be given, in which case they are concatenated "
1197 "together.  Each filename must be a full path, starting at the root directory "
1198 "(starting with '/')."
1199 msgstr ""
1200
1201 #. type: textblock
1202 #: ../cat/virt-cat.pod:28
1203 msgid ""
1204 "C<virt-cat> can be used to quickly view a file.  To edit a file, use C<virt-"
1205 "edit>.  For more complex cases you should look at the L<guestfish(1)> tool "
1206 "(see L</USING GUESTFISH> below)."
1207 msgstr ""
1208
1209 #. type: =head1
1210 #: ../cat/virt-cat.pod:32 ../cat/virt-ls.pod:35 ../df/virt-df.pod:43
1211 #: ../edit/virt-edit.pod:44 ../fish/guestfish.pod:41
1212 #: ../fish/guestfish.pod:1051 ../fish/virt-copy-in.pod:29
1213 #: ../fish/virt-copy-out.pod:21 ../fish/virt-tar-in.pod:30
1214 #: ../fish/virt-tar-out.pod:24 ../fuse/guestmount.pod:39
1215 #: ../resize/virt-resize.pod:27 ../sparsify/virt-sparsify.pod:75
1216 #: ../tools/virt-tar.pl:50
1217 msgid "EXAMPLES"
1218 msgstr ""
1219
1220 #. type: textblock
1221 #: ../cat/virt-cat.pod:34
1222 msgid ""
1223 "Display C</etc/fstab> file from inside the libvirt VM called C<mydomain>:"
1224 msgstr ""
1225
1226 #. type: verbatim
1227 #: ../cat/virt-cat.pod:37
1228 #, no-wrap
1229 msgid ""
1230 " virt-cat -d mydomain /etc/fstab\n"
1231 "\n"
1232 msgstr ""
1233
1234 #. type: textblock
1235 #: ../cat/virt-cat.pod:39
1236 msgid "List syslog messages from a VM disk image file:"
1237 msgstr ""
1238
1239 #. type: verbatim
1240 #: ../cat/virt-cat.pod:41
1241 #, no-wrap
1242 msgid ""
1243 " virt-cat -a disk.img /var/log/messages | tail\n"
1244 "\n"
1245 msgstr ""
1246
1247 #. type: textblock
1248 #: ../cat/virt-cat.pod:43
1249 msgid "Find out what DHCP IP address a VM acquired:"
1250 msgstr ""
1251
1252 #. type: verbatim
1253 #: ../cat/virt-cat.pod:45
1254 #, no-wrap
1255 msgid ""
1256 " virt-cat -d mydomain /var/log/messages | \\\n"
1257 "   grep 'dhclient: bound to' | tail\n"
1258 "\n"
1259 msgstr ""
1260
1261 #. type: textblock
1262 #: ../cat/virt-cat.pod:48
1263 msgid "Find out what packages were recently installed:"
1264 msgstr ""
1265
1266 #. type: verbatim
1267 #: ../cat/virt-cat.pod:50
1268 #, no-wrap
1269 msgid ""
1270 " virt-cat -d mydomain /var/log/yum.log | tail\n"
1271 "\n"
1272 msgstr ""
1273
1274 #. type: textblock
1275 #: ../cat/virt-cat.pod:52
1276 msgid "Find out who is logged on inside a virtual machine:"
1277 msgstr ""
1278
1279 #. type: verbatim
1280 #: ../cat/virt-cat.pod:54
1281 #, no-wrap
1282 msgid ""
1283 " virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n"
1284 " who /tmp/utmp\n"
1285 "\n"
1286 msgstr ""
1287
1288 #. type: textblock
1289 #: ../cat/virt-cat.pod:57
1290 msgid "or who was logged on:"
1291 msgstr ""
1292
1293 #. type: verbatim
1294 #: ../cat/virt-cat.pod:59
1295 #, no-wrap
1296 msgid ""
1297 " virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n"
1298 " last -f /tmp/wtmp\n"
1299 "\n"
1300 msgstr ""
1301
1302 #. type: textblock
1303 #: ../cat/virt-cat.pod:74 ../cat/virt-filesystems.pod:103
1304 #: ../cat/virt-ls.pod:273 ../df/virt-df.pod:71 ../edit/virt-edit.pod:74
1305 #: ../inspector/virt-inspector.pod:67 ../rescue/virt-rescue.pod:96
1306 msgid ""
1307 "Add I<file> which should be a disk image from a virtual machine.  If the "
1308 "virtual machine has multiple block devices, you must supply all of them with "
1309 "separate I<-a> options."
1310 msgstr ""
1311
1312 #. type: =item
1313 #: ../cat/virt-cat.pod:98 ../cat/virt-filesystems.pod:148
1314 #: ../cat/virt-ls.pod:314 ../edit/virt-edit.pod:112 ../fish/guestfish.pod:217
1315 #: ../fuse/guestmount.pod:135 ../inspector/virt-inspector.pod:92
1316 msgid "B<--echo-keys>"
1317 msgstr ""
1318
1319 #. type: textblock
1320 #: ../cat/virt-cat.pod:100
1321 msgid ""
1322 "When prompting for keys and passphrases, virt-cat normally turns echoing off "
1323 "so you cannot see what you are typing.  If you are not worried about Tempest "
1324 "attacks and there is no one else in the room you can specify this flag to "
1325 "see what you are typing."
1326 msgstr ""
1327
1328 #. type: verbatim
1329 #: ../cat/virt-cat.pod:116
1330 #, no-wrap
1331 msgid ""
1332 " virt-cat --format=raw -a disk.img file\n"
1333 "\n"
1334 msgstr ""
1335
1336 #. type: verbatim
1337 #: ../cat/virt-cat.pod:120
1338 #, no-wrap
1339 msgid ""
1340 " virt-cat --format=raw -a disk.img --format -a another.img file\n"
1341 "\n"
1342 msgstr ""
1343
1344 #. type: =item
1345 #: ../cat/virt-cat.pod:129 ../cat/virt-filesystems.pod:200
1346 #: ../cat/virt-ls.pod:361 ../edit/virt-edit.pod:156 ../fish/guestfish.pod:289
1347 #: ../fuse/guestmount.pod:172 ../inspector/virt-inspector.pod:114
1348 msgid "B<--keys-from-stdin>"
1349 msgstr ""
1350
1351 #. type: textblock
1352 #: ../cat/virt-cat.pod:131 ../cat/virt-filesystems.pod:202
1353 #: ../cat/virt-ls.pod:363 ../edit/virt-edit.pod:158 ../fish/guestfish.pod:291
1354 #: ../fuse/guestmount.pod:174 ../inspector/virt-inspector.pod:116
1355 msgid ""
1356 "Read key or passphrase parameters from stdin.  The default is to try to read "
1357 "passphrases from the user by opening C</dev/tty>."
1358 msgstr ""
1359
1360 #. type: =head1
1361 #: ../cat/virt-cat.pod:152 ../cat/virt-ls.pod:443 ../edit/virt-edit.pod:179
1362 #: ../inspector/virt-inspector.pod:137 ../rescue/virt-rescue.pod:209
1363 msgid "OLD-STYLE COMMAND LINE ARGUMENTS"
1364 msgstr ""
1365
1366 #. type: textblock
1367 #: ../cat/virt-cat.pod:154
1368 msgid "Previous versions of virt-cat allowed you to write either:"
1369 msgstr ""
1370
1371 #. type: verbatim
1372 #: ../cat/virt-cat.pod:156
1373 #, no-wrap
1374 msgid ""
1375 " virt-cat disk.img [disk.img ...] file\n"
1376 "\n"
1377 msgstr ""
1378
1379 #. type: textblock
1380 #: ../cat/virt-cat.pod:158 ../cat/virt-ls.pod:449 ../edit/virt-edit.pod:185
1381 #: ../inspector/virt-inspector.pod:143 ../rescue/virt-rescue.pod:215
1382 msgid "or"
1383 msgstr ""
1384
1385 #. type: verbatim
1386 #: ../cat/virt-cat.pod:160
1387 #, no-wrap
1388 msgid ""
1389 " virt-cat guestname file\n"
1390 "\n"
1391 msgstr ""
1392
1393 #. type: textblock
1394 #: ../cat/virt-cat.pod:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189
1395 #: ../inspector/virt-inspector.pod:147 ../rescue/virt-rescue.pod:219
1396 msgid ""
1397 "whereas in this version you should use I<-a> or I<-d> respectively to avoid "
1398 "the confusing case where a disk image might have the same name as a guest."
1399 msgstr ""
1400
1401 #. type: textblock
1402 #: ../cat/virt-cat.pod:166 ../cat/virt-ls.pod:457 ../edit/virt-edit.pod:193
1403 #: ../inspector/virt-inspector.pod:151 ../rescue/virt-rescue.pod:223
1404 msgid "For compatibility the old style is still supported."
1405 msgstr ""
1406
1407 #. type: =head1
1408 #: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:257 ../fish/guestfish.pod:858
1409 msgid "WINDOWS PATHS"
1410 msgstr ""
1411
1412 #. type: textblock
1413 #: ../cat/virt-cat.pod:170
1414 msgid ""
1415 "C<virt-cat> has a limited ability to understand Windows drive letters and "
1416 "paths (eg. C<E:\\foo\\bar.txt>)."
1417 msgstr ""
1418
1419 #. type: textblock
1420 #: ../cat/virt-cat.pod:173 ../edit/virt-edit.pod:262
1421 msgid "If and only if the guest is running Windows then:"
1422 msgstr ""
1423
1424 #. type: textblock
1425 #: ../cat/virt-cat.pod:179 ../edit/virt-edit.pod:268
1426 msgid ""
1427 "Drive letter prefixes like C<C:> are resolved against the Windows Registry "
1428 "to the correct filesystem."
1429 msgstr ""
1430
1431 #. type: textblock
1432 #: ../cat/virt-cat.pod:184 ../edit/virt-edit.pod:273
1433 msgid ""
1434 "Any backslash (C<\\>) characters in the path are replaced with forward "
1435 "slashes so that libguestfs can process it."
1436 msgstr ""
1437
1438 #. type: textblock
1439 #: ../cat/virt-cat.pod:189
1440 msgid ""
1441 "The path is resolved case insensitively to locate the file that should be "
1442 "displayed."
1443 msgstr ""
1444
1445 #. type: textblock
1446 #: ../cat/virt-cat.pod:194 ../edit/virt-edit.pod:283
1447 msgid "There are some known shortcomings:"
1448 msgstr ""
1449
1450 #. type: textblock
1451 #: ../cat/virt-cat.pod:200 ../edit/virt-edit.pod:289
1452 msgid "Some NTFS symbolic links may not be followed correctly."
1453 msgstr ""
1454
1455 #. type: textblock
1456 #: ../cat/virt-cat.pod:204 ../edit/virt-edit.pod:293
1457 msgid "NTFS junction points that cross filesystems are not followed."
1458 msgstr ""
1459
1460 #. type: =head1
1461 #: ../cat/virt-cat.pod:208 ../edit/virt-edit.pod:297
1462 msgid "USING GUESTFISH"
1463 msgstr ""
1464
1465 #. type: textblock
1466 #: ../cat/virt-cat.pod:210
1467 msgid ""
1468 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
1469 "C<virt-cat> doesn't work."
1470 msgstr ""
1471
1472 #. type: textblock
1473 #: ../cat/virt-cat.pod:213
1474 msgid "Using C<virt-cat> is approximately equivalent to doing:"
1475 msgstr ""
1476
1477 #. type: verbatim
1478 #: ../cat/virt-cat.pod:215
1479 #, no-wrap
1480 msgid ""
1481 " guestfish --ro -i -d domname download file -\n"
1482 "\n"
1483 msgstr ""
1484
1485 #. type: textblock
1486 #: ../cat/virt-cat.pod:217
1487 msgid ""
1488 "where C<domname> is the name of the libvirt guest, and C<file> is the full "
1489 "path to the file.  Note the final C<-> (meaning \"output to stdout\")."
1490 msgstr ""
1491
1492 #. type: textblock
1493 #: ../cat/virt-cat.pod:221
1494 msgid ""
1495 "The command above uses libguestfs's guest inspection feature and so does not "
1496 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
1497 "disk images that don't contain guests.  To display a file from a disk image "
1498 "directly, use:"
1499 msgstr ""
1500
1501 #. type: verbatim
1502 #: ../cat/virt-cat.pod:226
1503 #, no-wrap
1504 msgid ""
1505 " guestfish --ro -a disk.img -m /dev/sda1 download file -\n"
1506 "\n"
1507 msgstr ""
1508
1509 #. type: textblock
1510 #: ../cat/virt-cat.pod:228
1511 msgid ""
1512 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
1513 "the disk image, and C<file> is the full path to the file."
1514 msgstr ""
1515
1516 #. type: textblock
1517 #: ../cat/virt-cat.pod:240 ../cat/virt-filesystems.pod:382
1518 #: ../cat/virt-ls.pod:492 ../df/virt-df.pod:224 ../edit/virt-edit.pod:351
1519 #: ../fuse/guestmount.pod:314 ../inspector/virt-inspector.pod:377
1520 #: ../resize/virt-resize.pod:685 ../sparsify/virt-sparsify.pod:229
1521 msgid ""
1522 "This program returns 0 if successful, or non-zero if there was an error."
1523 msgstr ""
1524
1525 #. type: textblock
1526 #: ../cat/virt-cat.pod:245
1527 msgid ""
1528 "L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, L<virt-"
1529 "tar-out(1)>, L<http://libguestfs.org/>."
1530 msgstr ""
1531
1532 #. type: textblock
1533 #: ../cat/virt-cat.pod:258 ../inspector/virt-inspector.pod:405
1534 #: ../resize/virt-resize.pod:717 ../tools/virt-make-fs.pl:588
1535 msgid "Copyright (C) 2010-2011 Red Hat Inc."
1536 msgstr ""
1537
1538 #. type: textblock
1539 #: ../cat/virt-filesystems.pod:5
1540 msgid ""
1541 "virt-filesystems - List filesystems, partitions, block devices, LVM in a "
1542 "virtual machine or disk image"
1543 msgstr ""
1544
1545 #. type: verbatim
1546 #: ../cat/virt-filesystems.pod:9
1547 #, no-wrap
1548 msgid ""
1549 " virt-filesystems [--options] -d domname\n"
1550 "\n"
1551 msgstr ""
1552
1553 #. type: verbatim
1554 #: ../cat/virt-filesystems.pod:11
1555 #, no-wrap
1556 msgid ""
1557 " virt-filesystems [--options] -a disk.img [-a disk.img ...]\n"
1558 "\n"
1559 msgstr ""
1560
1561 #. type: textblock
1562 #: ../cat/virt-filesystems.pod:15
1563 msgid ""
1564 "This tool allows you to discover filesystems, partitions, logical volumes, "
1565 "and their sizes in a disk image or virtual machine.  It is a replacement for "
1566 "L<virt-list-filesystems(1)> and L<virt-list-partitions(1)>."
1567 msgstr ""
1568
1569 #. type: textblock
1570 #: ../cat/virt-filesystems.pod:20
1571 msgid ""
1572 "One use for this tool is from shell scripts to iterate over all filesystems "
1573 "from a disk image:"
1574 msgstr ""
1575
1576 #. type: verbatim
1577 #: ../cat/virt-filesystems.pod:23
1578 #, no-wrap
1579 msgid ""
1580 " for fs in $(virt-filesystems -a disk.img); do\n"
1581 "   # ...\n"
1582 " done\n"
1583 "\n"
1584 msgstr ""
1585
1586 #. type: textblock
1587 #: ../cat/virt-filesystems.pod:27
1588 msgid ""
1589 "Another use is to list partitions before using another tool to modify those "
1590 "partitions (such as L<virt-resize(1)>).  If you are curious about what an "
1591 "unknown disk image contains, use this tool along with L<virt-inspector(1)>."
1592 msgstr ""
1593
1594 #. type: textblock
1595 #: ../cat/virt-filesystems.pod:32
1596 msgid ""
1597 "Various command line options control what this program displays.  You need "
1598 "to give either I<-a> or I<-d> options to specify the disk image or libvirt "
1599 "guest respectively.  If you just specify that then the program shows "
1600 "filesystems found, one per line, like this:"
1601 msgstr ""
1602
1603 #. type: verbatim
1604 #: ../cat/virt-filesystems.pod:37
1605 #, no-wrap
1606 msgid ""
1607 " $ virt-filesystems -a disk.img\n"
1608 " /dev/sda1\n"
1609 " /dev/vg_guest/lv_root\n"
1610 "\n"
1611 msgstr ""
1612
1613 #. type: textblock
1614 #: ../cat/virt-filesystems.pod:41
1615 msgid ""
1616 "If you add I<-l> or I<--long> then the output includes extra information:"
1617 msgstr ""
1618
1619 #. type: verbatim
1620 #: ../cat/virt-filesystems.pod:44
1621 #, no-wrap
1622 msgid ""
1623 " $ virt-filesystems -a disk.img -l\n"
1624 " Name                   Type         VFS   Label  Size\n"
1625 " /dev/sda1              filesystem   ext4  boot   524288000\n"
1626 " /dev/vg_guest/lv_root  filesystem   ext4  root   10212081664\n"
1627 "\n"
1628 msgstr ""
1629
1630 #. type: textblock
1631 #: ../cat/virt-filesystems.pod:49
1632 msgid ""
1633 "If you add I<--extra> then non-mountable (swap, unknown) filesystems are "
1634 "shown as well:"
1635 msgstr ""
1636
1637 #. type: verbatim
1638 #: ../cat/virt-filesystems.pod:52
1639 #, no-wrap
1640 msgid ""
1641 " $ virt-filesystems -a disk.img --extra\n"
1642 " /dev/sda1\n"
1643 " /dev/vg_guest/lv_root\n"
1644 " /dev/vg_guest/lv_swap\n"
1645 " /dev/vg_guest/lv_data\n"
1646 "\n"
1647 msgstr ""
1648
1649 #. type: textblock
1650 #: ../cat/virt-filesystems.pod:58
1651 msgid ""
1652 "If you add I<--partitions> then partitions are shown instead of filesystems:"
1653 msgstr ""
1654
1655 #. type: verbatim
1656 #: ../cat/virt-filesystems.pod:60
1657 #, no-wrap
1658 msgid ""
1659 " $ virt-filesystems -a disk.img --partitions\n"
1660 " /dev/sda1\n"
1661 " /dev/sda2\n"
1662 "\n"
1663 msgstr ""
1664
1665 #. type: textblock
1666 #: ../cat/virt-filesystems.pod:64
1667 msgid ""
1668 "Similarly you can use I<--logical-volumes>, I<--volume-groups>, I<--physical-"
1669 "volumes>, I<--block-devices> to list those items."
1670 msgstr ""
1671
1672 #. type: textblock
1673 #: ../cat/virt-filesystems.pod:67
1674 msgid ""
1675 "You can use these options in combination as well (if you want a combination "
1676 "including filesystems, you have to add I<--filesystems>).  Notice that some "
1677 "items fall into several categories (eg. C</dev/sda1> might be both a "
1678 "partition and a filesystem).  These items are listed several times.  To get "
1679 "a list which includes absolutely everything that virt-filesystems knows "
1680 "about, use the I<--all> option."
1681 msgstr ""
1682
1683 #. type: textblock
1684 #: ../cat/virt-filesystems.pod:74
1685 msgid ""
1686 "UUIDs (because they are quite long) are not shown by default.  Add the I<--"
1687 "uuid> option to display device and filesystem UUIDs in the long output."
1688 msgstr ""
1689
1690 #. type: textblock
1691 #: ../cat/virt-filesystems.pod:78
1692 msgid ""
1693 "I<--all --long --uuid> is a useful combination to display all possible "
1694 "information about everything."
1695 msgstr ""
1696
1697 #. type: verbatim
1698 #: ../cat/virt-filesystems.pod:81
1699 #, no-wrap
1700 msgid ""
1701 " $ virt-filesystems -a win.img --all --long --uuid -h\n"
1702 " Name      Type       VFS  Label           Size Parent   UUID\n"
1703 " /dev/sda1 filesystem ntfs System Reserved 100M -        F81C92571C92112C\n"
1704 " /dev/sda2 filesystem ntfs -               20G  -        F2E8996AE8992E3B\n"
1705 " /dev/sda1 partition  -    -               100M /dev/sda -\n"
1706 " /dev/sda2 partition  -    -               20G  /dev/sda -\n"
1707 " /dev/sda  device     -    -               20G  -        -\n"
1708 "\n"
1709 msgstr ""
1710
1711 #. type: textblock
1712 #: ../cat/virt-filesystems.pod:89
1713 msgid ""
1714 "For machine-readable output, use I<--csv> to get Comma-Separated Values."
1715 msgstr ""
1716
1717 #. type: =item
1718 #: ../cat/virt-filesystems.pod:110 ../tools/virt-list-filesystems.pl:121
1719 msgid "B<--all>"
1720 msgstr ""
1721
1722 #. type: textblock
1723 #: ../cat/virt-filesystems.pod:112
1724 msgid ""
1725 "Display everything.  This is currently the same as specifying these options: "
1726 "I<--filesystems>, I<--extra>, I<--partitions>, I<--block-devices>, I<--"
1727 "logical-volumes>, I<--volume-groups>, I<--physical-volumes>.  (More may be "
1728 "added to this list in future)."
1729 msgstr ""
1730
1731 #. type: textblock
1732 #: ../cat/virt-filesystems.pod:117
1733 msgid "See also I<--long>."
1734 msgstr ""
1735
1736 #. type: =item
1737 #: ../cat/virt-filesystems.pod:119
1738 msgid "B<--blkdevs>"
1739 msgstr ""
1740
1741 #. type: =item
1742 #: ../cat/virt-filesystems.pod:121
1743 msgid "B<--block-devices>"
1744 msgstr ""
1745
1746 #. type: textblock
1747 #: ../cat/virt-filesystems.pod:123
1748 msgid "Display block devices."
1749 msgstr ""
1750
1751 #. type: =item
1752 #: ../cat/virt-filesystems.pod:135 ../cat/virt-ls.pod:301 ../df/virt-df.pod:88
1753 msgid "B<--csv>"
1754 msgstr ""
1755
1756 #. type: textblock
1757 #: ../cat/virt-filesystems.pod:137 ../cat/virt-ls.pod:303 ../df/virt-df.pod:90
1758 msgid ""
1759 "Write out the results in CSV format (comma-separated values).  This format "
1760 "can be imported easily into databases and spreadsheets, but read L</NOTE "
1761 "ABOUT CSV FORMAT> below."
1762 msgstr ""
1763
1764 #. type: textblock
1765 #: ../cat/virt-filesystems.pod:150
1766 msgid ""
1767 "When prompting for keys and passphrases, virt-filesystems normally turns "
1768 "echoing off so you cannot see what you are typing.  If you are not worried "
1769 "about Tempest attacks and there is no one else in the room you can specify "
1770 "this flag to see what you are typing."
1771 msgstr ""
1772
1773 #. type: =item
1774 #: ../cat/virt-filesystems.pod:155
1775 msgid "B<--extra>"
1776 msgstr ""
1777
1778 #. type: textblock
1779 #: ../cat/virt-filesystems.pod:157
1780 msgid ""
1781 "This causes filesystems that are not ordinary, mountable filesystems to be "
1782 "displayed.  This category includes swapspace, and filesystems that are empty "
1783 "or contain unknown data."
1784 msgstr ""
1785
1786 #. type: textblock
1787 #: ../cat/virt-filesystems.pod:161
1788 msgid "This option implies I<--filesystems>."
1789 msgstr ""
1790
1791 #. type: =item
1792 #: ../cat/virt-filesystems.pod:163
1793 msgid "B<--filesystems>"
1794 msgstr ""
1795
1796 #. type: textblock
1797 #: ../cat/virt-filesystems.pod:165
1798 msgid ""
1799 "Display mountable filesystems.  If no display option was selected then this "
1800 "option is implied."
1801 msgstr ""
1802
1803 #. type: textblock
1804 #: ../cat/virt-filesystems.pod:168
1805 msgid "With I<--extra>, non-mountable filesystems are shown too."
1806 msgstr ""
1807
1808 #. type: verbatim
1809 #: ../cat/virt-filesystems.pod:181
1810 #, no-wrap
1811 msgid ""
1812 " virt-filesystems --format=raw -a disk.img\n"
1813 "\n"
1814 msgstr ""
1815
1816 #. type: verbatim
1817 #: ../cat/virt-filesystems.pod:185
1818 #, no-wrap
1819 msgid ""
1820 " virt-filesystems --format=raw -a disk.img --format -a another.img\n"
1821 "\n"
1822 msgstr ""
1823
1824 #. type: =item
1825 #: ../cat/virt-filesystems.pod:194 ../cat/virt-ls.pod:352
1826 #: ../df/virt-df.pod:125 ../fish/guestfish.pod:156
1827 #: ../tools/virt-list-partitions.pl:109
1828 msgid "B<-h>"
1829 msgstr ""
1830
1831 #. type: =item
1832 #: ../cat/virt-filesystems.pod:196 ../cat/virt-ls.pod:354
1833 #: ../df/virt-df.pod:127 ../tools/virt-list-partitions.pl:111
1834 msgid "B<--human-readable>"
1835 msgstr ""
1836
1837 #. type: textblock
1838 #: ../cat/virt-filesystems.pod:198
1839 msgid "In I<--long> mode, display sizes in human-readable format."
1840 msgstr ""
1841
1842 #. type: =item
1843 #: ../cat/virt-filesystems.pod:205 ../cat/virt-ls.pod:366
1844 #: ../tools/virt-list-filesystems.pl:108 ../tools/virt-list-partitions.pl:119
1845 msgid "B<-l>"
1846 msgstr ""
1847
1848 #. type: =item
1849 #: ../cat/virt-filesystems.pod:207 ../cat/virt-ls.pod:368
1850 #: ../tools/virt-list-filesystems.pl:110 ../tools/virt-list-partitions.pl:121
1851 msgid "B<--long>"
1852 msgstr ""
1853
1854 #. type: textblock
1855 #: ../cat/virt-filesystems.pod:209
1856 msgid "Display extra columns of data (\"long format\")."
1857 msgstr ""
1858
1859 #. type: textblock
1860 #: ../cat/virt-filesystems.pod:211
1861 msgid "A title row is added unless you also specify I<--no-title>."
1862 msgstr ""
1863
1864 #. type: textblock
1865 #: ../cat/virt-filesystems.pod:213
1866 msgid ""
1867 "The extra columns displayed depend on what output you select, and the "
1868 "ordering of columns may change in future versions.  Use the title row, I<--"
1869 "csv> output and/or L<csvtool(1)> to match columns to data in external "
1870 "programs."
1871 msgstr ""
1872
1873 #. type: textblock
1874 #: ../cat/virt-filesystems.pod:218
1875 msgid ""
1876 "Use I<-h> if you want sizes to be displayed in human-readable format.  The "
1877 "default is to show raw numbers of I<bytes>."
1878 msgstr ""
1879
1880 #. type: textblock
1881 #: ../cat/virt-filesystems.pod:221
1882 msgid "Use I<--uuid> to display UUIDs too."
1883 msgstr ""
1884
1885 #. type: =item
1886 #: ../cat/virt-filesystems.pod:223
1887 msgid "B<--lvs>"
1888 msgstr ""
1889
1890 #. type: =item
1891 #: ../cat/virt-filesystems.pod:225
1892 msgid "B<--logvols>"
1893 msgstr ""
1894
1895 #. type: =item
1896 #: ../cat/virt-filesystems.pod:227
1897 msgid "B<--logical-volumes>"
1898 msgstr ""
1899
1900 #. type: textblock
1901 #: ../cat/virt-filesystems.pod:229
1902 msgid ""
1903 "Display LVM logical volumes.  In this mode, these are displayed irrespective "
1904 "of whether the LVs contain filesystems."
1905 msgstr ""
1906
1907 #. type: =item
1908 #: ../cat/virt-filesystems.pod:232
1909 msgid "B<--no-title>"
1910 msgstr ""
1911
1912 #. type: textblock
1913 #: ../cat/virt-filesystems.pod:234
1914 msgid "In I<--long> mode, don't add a title row."
1915 msgstr ""
1916
1917 #. type: textblock
1918 #: ../cat/virt-filesystems.pod:236
1919 msgid ""
1920 "Note that the order of the columns is not fixed, and may change in future "
1921 "versions of virt-filesystems, so using this option may give you unexpected "
1922 "surprises."
1923 msgstr ""
1924
1925 #. type: =item
1926 #: ../cat/virt-filesystems.pod:240
1927 msgid "B<--parts>"
1928 msgstr ""
1929
1930 #. type: =item
1931 #: ../cat/virt-filesystems.pod:242
1932 msgid "B<--partitions>"
1933 msgstr ""
1934
1935 #. type: textblock
1936 #: ../cat/virt-filesystems.pod:244
1937 msgid ""
1938 "Display partitions.  In this mode, these are displayed irrespective of "
1939 "whether the partitions contain filesystems."
1940 msgstr ""
1941
1942 #. type: =item
1943 #: ../cat/virt-filesystems.pod:247
1944 msgid "B<--pvs>"
1945 msgstr ""
1946
1947 #. type: =item
1948 #: ../cat/virt-filesystems.pod:249
1949 msgid "B<--physvols>"
1950 msgstr ""
1951
1952 #. type: =item
1953 #: ../cat/virt-filesystems.pod:251
1954 msgid "B<--physical-volumes>"
1955 msgstr ""
1956
1957 #. type: textblock
1958 #: ../cat/virt-filesystems.pod:253
1959 msgid "Display LVM physical volumes."
1960 msgstr ""
1961
1962 #. type: =item
1963 #: ../cat/virt-filesystems.pod:255 ../df/virt-df.pod:163
1964 msgid "B<--uuid>"
1965 msgstr ""
1966
1967 #. type: =item
1968 #: ../cat/virt-filesystems.pod:257
1969 msgid "B<--uuids>"
1970 msgstr ""
1971
1972 #. type: textblock
1973 #: ../cat/virt-filesystems.pod:259
1974 msgid "In I<--long> mode, display UUIDs as well."
1975 msgstr ""
1976
1977 #. type: =item
1978 #: ../cat/virt-filesystems.pod:273
1979 msgid "B<--vgs>"
1980 msgstr ""
1981
1982 #. type: =item
1983 #: ../cat/virt-filesystems.pod:275
1984 msgid "B<--volgroups>"
1985 msgstr ""
1986
1987 #. type: =item
1988 #: ../cat/virt-filesystems.pod:277
1989 msgid "B<--volume-groups>"
1990 msgstr ""
1991
1992 #. type: textblock
1993 #: ../cat/virt-filesystems.pod:279
1994 msgid "Display LVM volume groups."
1995 msgstr ""
1996
1997 #. type: =head1
1998 #: ../cat/virt-filesystems.pod:287
1999 msgid "COLUMNS"
2000 msgstr ""
2001
2002 #. type: textblock
2003 #: ../cat/virt-filesystems.pod:289
2004 msgid ""
2005 "Note that columns in the output are subject to reordering and change in "
2006 "future versions of this tool."
2007 msgstr ""
2008
2009 #. type: =item
2010 #: ../cat/virt-filesystems.pod:294
2011 msgid "B<Name>"
2012 msgstr ""
2013
2014 #. type: textblock
2015 #: ../cat/virt-filesystems.pod:296
2016 msgid "The filesystem, partition, block device or LVM name."
2017 msgstr ""
2018
2019 #. type: textblock
2020 #: ../cat/virt-filesystems.pod:298
2021 msgid ""
2022 "For device and partition names these are displayed as canonical libguestfs "
2023 "names, so that for example C</dev/sda2> is the second partition on the first "
2024 "device."
2025 msgstr ""
2026
2027 #. type: textblock
2028 #: ../cat/virt-filesystems.pod:302
2029 msgid ""
2030 "If the I<--long> option is B<not> specified, then only the name column is "
2031 "shown in the output."
2032 msgstr ""
2033
2034 #. type: =item
2035 #: ../cat/virt-filesystems.pod:305
2036 msgid "B<Type>"
2037 msgstr ""
2038
2039 #. type: textblock
2040 #: ../cat/virt-filesystems.pod:307
2041 msgid "The object type, for example C<filesystem>, C<lv>, C<device> etc."
2042 msgstr ""
2043
2044 #. type: =item
2045 #: ../cat/virt-filesystems.pod:309
2046 msgid "B<VFS>"
2047 msgstr ""
2048
2049 #. type: textblock
2050 #: ../cat/virt-filesystems.pod:311
2051 msgid ""
2052 "If there is a filesystem, then this column displays the filesystem type if "
2053 "one could be detected, eg. C<ext4>."
2054 msgstr ""
2055
2056 #. type: =item
2057 #: ../cat/virt-filesystems.pod:314
2058 msgid "B<Label>"
2059 msgstr ""
2060
2061 #. type: textblock
2062 #: ../cat/virt-filesystems.pod:316
2063 msgid ""
2064 "If the object has a label (used for identifying and mounting filesystems) "
2065 "then this column contains the label."
2066 msgstr ""
2067
2068 #. type: =item
2069 #: ../cat/virt-filesystems.pod:319
2070 msgid "B<MBR>"
2071 msgstr ""
2072
2073 #. type: textblock
2074 #: ../cat/virt-filesystems.pod:321
2075 msgid ""
2076 "The partition type byte, displayed as a two digit hexadecimal number.  A "
2077 "comprehensive list of partition types can be found here: L<http://www.win."
2078 "tue.nl/~aeb/partitions/partition_types-1.html>"
2079 msgstr ""
2080
2081 #. type: textblock
2082 #: ../cat/virt-filesystems.pod:325
2083 msgid "This is only applicable for DOS (MBR) partitions."
2084 msgstr ""
2085
2086 #. type: =item
2087 #: ../cat/virt-filesystems.pod:327
2088 msgid "B<Size>"
2089 msgstr ""
2090
2091 #. type: textblock
2092 #: ../cat/virt-filesystems.pod:329
2093 msgid ""
2094 "The size of the object in bytes.  If the I<--human> option is used then the "
2095 "size is displayed in a human-readable form."
2096 msgstr ""
2097
2098 #. type: =item
2099 #: ../cat/virt-filesystems.pod:332
2100 msgid "B<Parent>"
2101 msgstr ""
2102
2103 #. type: textblock
2104 #: ../cat/virt-filesystems.pod:334
2105 msgid ""
2106 "The parent column records the parent relationship between objects.  For "
2107 "example, if the object is a partition, then this column contains the name of "
2108 "the containing device.  If the object is a logical volume, then this column "
2109 "is the name of the volume group."
2110 msgstr ""
2111
2112 #. type: =item
2113 #: ../cat/virt-filesystems.pod:339
2114 msgid "B<UUID>"
2115 msgstr ""
2116
2117 #. type: textblock
2118 #: ../cat/virt-filesystems.pod:341
2119 msgid ""
2120 "If the object has a UUID (used for identifying and mounting filesystems and "
2121 "block devices) then this column contains the UUID as a string."
2122 msgstr ""
2123
2124 #. type: textblock
2125 #: ../cat/virt-filesystems.pod:345
2126 msgid "The UUID is only displayed if the I<--uuid> option is given."
2127 msgstr ""
2128
2129 #. type: =head1
2130 #: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:459
2131 #: ../df/virt-df.pod:191
2132 msgid "NOTE ABOUT CSV FORMAT"
2133 msgstr ""
2134
2135 #. type: textblock
2136 #: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:461
2137 #: ../df/virt-df.pod:193
2138 msgid ""
2139 "Comma-separated values (CSV) is a deceptive format.  It I<seems> like it "
2140 "should be easy to parse, but it is definitely not easy to parse."
2141 msgstr ""
2142
2143 #. type: textblock
2144 #: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:464
2145 #: ../df/virt-df.pod:196
2146 msgid ""
2147 "Myth: Just split fields at commas.  Reality: This does I<not> work "
2148 "reliably.  This example has two columns:"
2149 msgstr ""
2150
2151 #. type: verbatim
2152 #: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:467
2153 #: ../df/virt-df.pod:199
2154 #, no-wrap
2155 msgid ""
2156 " \"foo,bar\",baz\n"
2157 "\n"
2158 msgstr ""
2159
2160 #. type: textblock
2161 #: ../cat/virt-filesystems.pod:359 ../cat/virt-ls.pod:469
2162 #: ../df/virt-df.pod:201
2163 msgid ""
2164 "Myth: Read the file one line at a time.  Reality: This does I<not> work "
2165 "reliably.  This example has one row:"
2166 msgstr ""
2167
2168 #. type: verbatim
2169 #: ../cat/virt-filesystems.pod:362 ../cat/virt-ls.pod:472
2170 #: ../df/virt-df.pod:204
2171 #, no-wrap
2172 msgid ""
2173 " \"foo\n"
2174 " bar\",baz\n"
2175 "\n"
2176 msgstr ""
2177
2178 #. type: textblock
2179 #: ../cat/virt-filesystems.pod:365 ../cat/virt-ls.pod:475
2180 #: ../df/virt-df.pod:207
2181 msgid ""
2182 "For shell scripts, use C<csvtool> (L<http://merjis.com/developers/csv> also "
2183 "packaged in major Linux distributions)."
2184 msgstr ""
2185
2186 #. type: textblock
2187 #: ../cat/virt-filesystems.pod:368 ../cat/virt-ls.pod:478
2188 #: ../df/virt-df.pod:210
2189 msgid ""
2190 "For other languages, use a CSV processing library (eg. C<Text::CSV> for Perl "
2191 "or Python's built-in csv library)."
2192 msgstr ""
2193
2194 #. type: textblock
2195 #: ../cat/virt-filesystems.pod:371 ../cat/virt-ls.pod:481
2196 #: ../df/virt-df.pod:213
2197 msgid "Most spreadsheets and databases can import CSV directly."
2198 msgstr ""
2199
2200 #. type: textblock
2201 #: ../cat/virt-filesystems.pod:387
2202 msgid ""
2203 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-df(1)>, L<virt-list-"
2204 "filesystems(1)>, L<virt-list-partitions(1)>, L<csvtool(1)>, L<http://"
2205 "libguestfs.org/>."
2206 msgstr ""
2207
2208 #. type: textblock
2209 #: ../cat/virt-filesystems.pod:402 ../tools/virt-win-reg.pl:789
2210 msgid "Copyright (C) 2010 Red Hat Inc."
2211 msgstr ""
2212
2213 #. type: textblock
2214 #: ../cat/virt-ls.pod:5
2215 msgid "virt-ls - List files in a virtual machine"
2216 msgstr ""
2217
2218 #. type: verbatim
2219 #: ../cat/virt-ls.pod:9
2220 #, no-wrap
2221 msgid ""
2222 " virt-ls [--options] -d domname directory [directory ...]\n"
2223 "\n"
2224 msgstr ""
2225
2226 #. type: verbatim
2227 #: ../cat/virt-ls.pod:11
2228 #, no-wrap
2229 msgid ""
2230 " virt-ls [--options] -a disk.img [-a disk.img ...] directory [directory ...]\n"
2231 "\n"
2232 msgstr ""
2233
2234 #. type: textblock
2235 #: ../cat/virt-ls.pod:13 ../df/virt-df.pod:15 ../rescue/virt-rescue.pod:13
2236 msgid "Old style:"
2237 msgstr ""
2238
2239 #. type: verbatim
2240 #: ../cat/virt-ls.pod:15
2241 #, no-wrap
2242 msgid ""
2243 " virt-ls [--options] domname directory\n"
2244 "\n"
2245 msgstr ""
2246
2247 #. type: verbatim
2248 #: ../cat/virt-ls.pod:17
2249 #, no-wrap
2250 msgid ""
2251 " virt-ls [--options] disk.img [disk.img ...] directory\n"
2252 "\n"
2253 msgstr ""
2254
2255 #. type: textblock
2256 #: ../cat/virt-ls.pod:21
2257 msgid ""
2258 "C<virt-ls> lists filenames, file sizes, checksums, extended attributes and "
2259 "more from a virtual machine or disk image."
2260 msgstr ""
2261
2262 #. type: textblock
2263 #: ../cat/virt-ls.pod:24
2264 msgid ""
2265 "Multiple directory names can be given, in which case the output from each is "
2266 "concatenated."
2267 msgstr ""
2268
2269 #. type: textblock
2270 #: ../cat/virt-ls.pod:27
2271 msgid ""
2272 "To list directories from a libvirt guest use the I<-d> option to specify the "
2273 "name of the guest.  For a disk image, use the I<-a> option."
2274 msgstr ""
2275
2276 #. type: textblock
2277 #: ../cat/virt-ls.pod:31
2278 msgid ""
2279 "C<virt-ls> can do many simple file listings.  For more complicated cases you "
2280 "may need to use L<guestfish(1)>, or write a program directly to the L<guestfs"
2281 "(3)> API."
2282 msgstr ""
2283
2284 #. type: textblock
2285 #: ../cat/virt-ls.pod:37
2286 msgid "Get a list of all files and directories in a virtual machine:"
2287 msgstr ""
2288
2289 #. type: verbatim
2290 #: ../cat/virt-ls.pod:39
2291 #, no-wrap
2292 msgid ""
2293 " virt-ls -R -d guest /\n"
2294 "\n"
2295 msgstr ""
2296
2297 #. type: textblock
2298 #: ../cat/virt-ls.pod:41
2299 msgid "List all setuid or setgid programs in a Linux virtual machine:"
2300 msgstr ""
2301
2302 #. type: verbatim
2303 #: ../cat/virt-ls.pod:43
2304 #, no-wrap
2305 msgid ""
2306 " virt-ls -lR -d guest / | grep '^- [42]'\n"
2307 "\n"
2308 msgstr ""
2309
2310 #. type: textblock
2311 #: ../cat/virt-ls.pod:45
2312 msgid "List all public-writable directories in a Linux virtual machine:"
2313 msgstr ""
2314
2315 #. type: verbatim
2316 #: ../cat/virt-ls.pod:47
2317 #, no-wrap
2318 msgid ""
2319 " virt-ls -lR -d guest / | grep '^d ...7'\n"
2320 "\n"
2321 msgstr ""
2322
2323 #. type: textblock
2324 #: ../cat/virt-ls.pod:49
2325 msgid "List all Unix domain sockets in a Linux virtual machine:"
2326 msgstr ""
2327
2328 #. type: verbatim
2329 #: ../cat/virt-ls.pod:51
2330 #, no-wrap
2331 msgid ""
2332 " virt-ls -lR -d guest / | grep '^s'\n"
2333 "\n"
2334 msgstr ""
2335
2336 #. type: textblock
2337 #: ../cat/virt-ls.pod:53
2338 msgid "List all regular files with filenames ending in '.png':"
2339 msgstr ""
2340
2341 #. type: verbatim
2342 #: ../cat/virt-ls.pod:55
2343 #, no-wrap
2344 msgid ""
2345 " virt-ls -lR -d guest / | grep -i '^-.*\\.png$'\n"
2346 "\n"
2347 msgstr ""
2348
2349 #. type: textblock
2350 #: ../cat/virt-ls.pod:57
2351 msgid "To display files larger than 10MB in home directories:"
2352 msgstr ""
2353
2354 #. type: verbatim
2355 #: ../cat/virt-ls.pod:59
2356 #, no-wrap
2357 msgid ""
2358 " virt-ls -lR -d guest /home | awk '$3 > 10*1024*1024'\n"
2359 "\n"
2360 msgstr ""
2361
2362 #. type: textblock
2363 #: ../cat/virt-ls.pod:61
2364 msgid "Find everything modified in the last 7 days:"
2365 msgstr ""
2366
2367 #. type: verbatim
2368 #: ../cat/virt-ls.pod:63
2369 #, no-wrap
2370 msgid ""
2371 " virt-ls -lR -d guest --time-days / | awk '$6 <= 7'\n"
2372 "\n"
2373 msgstr ""
2374
2375 #. type: textblock
2376 #: ../cat/virt-ls.pod:65
2377 msgid "Find regular files modified in the last 24 hours:"
2378 msgstr ""
2379
2380 #. type: verbatim
2381 #: ../cat/virt-ls.pod:67
2382 #, no-wrap
2383 msgid ""
2384 " virt-ls -lR -d guest --time-days / | grep '^-' | awk '$6 < 1'\n"
2385 "\n"
2386 msgstr ""
2387
2388 #. type: =head2
2389 #: ../cat/virt-ls.pod:69
2390 msgid "DIFFERENCES IN SNAPSHOTS AND BACKING FILES"
2391 msgstr ""
2392
2393 #. type: textblock
2394 #: ../cat/virt-ls.pod:71
2395 msgid ""
2396 "Find the differences between files in a guest and an earlier snapshot of the "
2397 "same guest."
2398 msgstr ""
2399
2400 #. type: verbatim
2401 #: ../cat/virt-ls.pod:74
2402 #, no-wrap
2403 msgid ""
2404 " virt-ls -lR -a snapshot.img / --uids --time-t > old\n"
2405 " virt-ls -lR -a current.img / --uids --time-t > new\n"
2406 " diff -u old new | less\n"
2407 "\n"
2408 msgstr ""
2409
2410 #. type: textblock
2411 #: ../cat/virt-ls.pod:78
2412 msgid ""
2413 "The commands above won't find files where the content has changed but the "
2414 "metadata (eg. file size and modification date) is the same.  To do that, you "
2415 "need to add the I<--checksum> parameter to both C<virt-ls> commands.  I<--"
2416 "checksum> can be quite slow since it has to read and compute a checksum of "
2417 "every regular file in the virtual machine."
2418 msgstr ""
2419
2420 #. type: =head1
2421 #: ../cat/virt-ls.pod:84
2422 msgid "OUTPUT MODES"
2423 msgstr ""
2424
2425 #. type: textblock
2426 #: ../cat/virt-ls.pod:86
2427 msgid ""
2428 "C<virt-ls> has four output modes, controlled by different combinations of "
2429 "the I<-l> and I<-R> options."
2430 msgstr ""
2431
2432 #. type: =head2
2433 #: ../cat/virt-ls.pod:89
2434 msgid "SIMPLE LISTING"
2435 msgstr ""
2436
2437 #. type: textblock
2438 #: ../cat/virt-ls.pod:91
2439 msgid "A simple listing is like the ordinary L<ls(1)> command:"
2440 msgstr ""
2441
2442 #. type: verbatim
2443 #: ../cat/virt-ls.pod:93
2444 #, no-wrap
2445 msgid ""
2446 " $ virt-ls -d guest /\n"
2447 " bin\n"
2448 " boot\n"
2449 " [etc.]\n"
2450 "\n"
2451 msgstr ""
2452
2453 #. type: =head2
2454 #: ../cat/virt-ls.pod:98
2455 msgid "LONG LISTING"
2456 msgstr ""
2457
2458 #. type: textblock
2459 #: ../cat/virt-ls.pod:100
2460 msgid ""
2461 "With the I<-l> (I<--long>) option, the output is like the C<ls -l> command "
2462 "(more specifically, like the C<guestfs_ll> function)."
2463 msgstr ""
2464
2465 #. type: verbatim
2466 #: ../cat/virt-ls.pod:103
2467 #, no-wrap
2468 msgid ""
2469 " $ virt-ls -l -d guest /\n"
2470 " total 204\n"
2471 " dr-xr-xr-x.   2 root root   4096 2009-08-25 19:06 bin\n"
2472 " dr-xr-xr-x.   5 root root   3072 2009-08-25 19:06 boot\n"
2473 " [etc.]\n"
2474 "\n"
2475 msgstr ""
2476
2477 #. type: textblock
2478 #: ../cat/virt-ls.pod:109
2479 msgid ""
2480 "Note that while this is useful for displaying a directory, do not try "
2481 "parsing this output in another program.  Use L</RECURSIVE LONG LISTING> "
2482 "instead."
2483 msgstr ""
2484
2485 #. type: =head2
2486 #: ../cat/virt-ls.pod:113
2487 msgid "RECURSIVE LISTING"
2488 msgstr ""
2489
2490 #. type: textblock
2491 #: ../cat/virt-ls.pod:115
2492 msgid ""
2493 "With the I<-R> (I<--recursive>) option, C<virt-ls> lists the names of files "
2494 "and directories recursively:"
2495 msgstr ""
2496
2497 #. type: verbatim
2498 #: ../cat/virt-ls.pod:118
2499 #, no-wrap
2500 msgid ""
2501 " $ virt-ls -R -d guest /tmp\n"
2502 " foo\n"
2503 " foo/bar\n"
2504 " [etc.]\n"
2505 "\n"
2506 msgstr ""
2507
2508 #. type: textblock
2509 #: ../cat/virt-ls.pod:123
2510 msgid ""
2511 "To generate this output, C<virt-ls> runs the C<guestfs_find0> function and "
2512 "converts C<\\0> characters to C<\\n>."
2513 msgstr ""
2514
2515 #. type: =head2
2516 #: ../cat/virt-ls.pod:126
2517 msgid "RECURSIVE LONG LISTING"
2518 msgstr ""
2519
2520 #. type: textblock
2521 #: ../cat/virt-ls.pod:128
2522 msgid ""
2523 "Using I<-lR> options together changes the output to display directories "
2524 "recursively, with file stats, and optionally other features such as "
2525 "checksums and extended attributes."
2526 msgstr ""
2527
2528 #. type: textblock
2529 #: ../cat/virt-ls.pod:132
2530 msgid ""
2531 "Most of the interesting features of C<virt-ls> are only available when using "
2532 "I<-lR> mode."
2533 msgstr ""
2534
2535 #. type: textblock
2536 #: ../cat/virt-ls.pod:135
2537 msgid ""
2538 "The fields are normally space-separated.  Filenames are B<not> quoted, so "
2539 "you cannot use the output in another program (because filenames can contain "
2540 "spaces and other unsafe characters).  If the guest was untrusted and someone "
2541 "knew you were using C<virt-ls> to analyze the guest, they could play tricks "
2542 "on you by creating filenames with embedded newline characters.  To B<safely> "
2543 "parse the output in another program, use the I<--csv> (Comma-Separated "
2544 "Values) option."
2545 msgstr ""
2546
2547 #. type: textblock
2548 #: ../cat/virt-ls.pod:143
2549 msgid ""
2550 "Note that this output format is completely unrelated to the C<ls -lR> "
2551 "command."
2552 msgstr ""
2553
2554 #. type: verbatim
2555 #: ../cat/virt-ls.pod:146
2556 #, no-wrap
2557 msgid ""
2558 " $ virt-ls -lR -d guest /bin\n"
2559 " d 0555       4096 /bin\n"
2560 " - 0755        123 /bin/alsaunmute\n"
2561 " - 0755      28328 /bin/arch\n"
2562 " l 0777          4 /bin/awk -> gawk\n"
2563 " - 0755      27216 /bin/basename\n"
2564 " - 0755     943360 /bin/bash\n"
2565 " [etc.]\n"
2566 "\n"
2567 msgstr ""
2568
2569 #. type: textblock
2570 #: ../cat/virt-ls.pod:155
2571 msgid "These basic fields are always shown:"
2572 msgstr ""
2573
2574 #. type: =item
2575 #: ../cat/virt-ls.pod:159
2576 msgid "type"
2577 msgstr ""
2578
2579 #. type: textblock
2580 #: ../cat/virt-ls.pod:161
2581 msgid ""
2582 "The file type, one of: C<-> (regular file), C<d> (directory), C<c> "
2583 "(character device), C<b> (block device), C<p> (named pipe), C<l> (symbolic "
2584 "link), C<s> (socket) or C<u> (unknown)."
2585 msgstr ""
2586
2587 #. type: =item
2588 #: ../cat/virt-ls.pod:171
2589 msgid "permissions"
2590 msgstr ""
2591
2592 #. type: textblock
2593 #: ../cat/virt-ls.pod:173
2594 msgid "The Unix permissions, displayed as a 4 digit octal number."
2595 msgstr ""
2596
2597 #. type: =item
2598 #: ../cat/virt-ls.pod:175
2599 msgid "size"
2600 msgstr ""
2601
2602 #. type: textblock
2603 #: ../cat/virt-ls.pod:177
2604 msgid ""
2605 "The size of the file.  This is shown in bytes unless I<-h> or I<--human-"
2606 "readable> option is given, in which case this is shown as a human-readable "
2607 "number."
2608 msgstr ""
2609
2610 #. type: =head2
2611 #: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4349
2612 msgid "path"
2613 msgstr ""
2614
2615 #. type: textblock
2616 #: ../cat/virt-ls.pod:183
2617 msgid "The full path of the file or directory."
2618 msgstr ""
2619
2620 #. type: =item
2621 #: ../cat/virt-ls.pod:185
2622 msgid "link"
2623 msgstr ""
2624
2625 #. type: textblock
2626 #: ../cat/virt-ls.pod:187
2627 msgid "For symbolic links only, the link target."
2628 msgstr ""
2629
2630 #. type: textblock
2631 #: ../cat/virt-ls.pod:191
2632 msgid ""
2633 "In I<-lR> mode, additional command line options enable the display of more "
2634 "fields."
2635 msgstr ""
2636
2637 #. type: textblock
2638 #: ../cat/virt-ls.pod:194
2639 msgid ""
2640 "With the I<--uids> flag, these additional fields are displayed before the "
2641 "path:"
2642 msgstr ""
2643
2644 #. type: =item
2645 #: ../cat/virt-ls.pod:199
2646 msgid "uid"
2647 msgstr ""
2648
2649 #. type: =item
2650 #: ../cat/virt-ls.pod:201
2651 msgid "gid"
2652 msgstr ""
2653
2654 #. type: textblock
2655 #: ../cat/virt-ls.pod:203
2656 msgid ""
2657 "The UID and GID of the owner of the file (displayed numerically).  Note "
2658 "these only make sense in the context of a Unix-like guest."
2659 msgstr ""
2660
2661 #. type: textblock
2662 #: ../cat/virt-ls.pod:208
2663 msgid "With the I<--times> flag, these additional fields are displayed:"
2664 msgstr ""
2665
2666 #. type: =item
2667 #: ../cat/virt-ls.pod:212
2668 msgid "atime"
2669 msgstr ""
2670
2671 #. type: textblock
2672 #: ../cat/virt-ls.pod:214
2673 msgid "The time of last access."
2674 msgstr ""
2675
2676 #. type: =item
2677 #: ../cat/virt-ls.pod:216
2678 msgid "mtime"
2679 msgstr ""
2680
2681 #. type: textblock
2682 #: ../cat/virt-ls.pod:218
2683 msgid "The time of last modification."
2684 msgstr ""
2685
2686 #. type: =item
2687 #: ../cat/virt-ls.pod:220
2688 msgid "ctime"
2689 msgstr ""
2690
2691 #. type: textblock
2692 #: ../cat/virt-ls.pod:222
2693 msgid "The time of last status change."
2694 msgstr ""
2695
2696 #. type: textblock
2697 #: ../cat/virt-ls.pod:226
2698 msgid ""
2699 "The time fields are displayed as string dates and times, unless one of the "
2700 "I<--time-t>, I<--time-relative> or I<--time-days> flags is given."
2701 msgstr ""
2702
2703 #. type: textblock
2704 #: ../cat/virt-ls.pod:229
2705 msgid "With the I<--extra-stats> flag, these additional fields are displayed:"
2706 msgstr ""
2707
2708 #. type: =item
2709 #: ../cat/virt-ls.pod:233
2710 msgid "device"
2711 msgstr ""
2712
2713 #. type: textblock
2714 #: ../cat/virt-ls.pod:235
2715 msgid ""
2716 "The device containing the file (displayed as major:minor).  This may not "
2717 "match devices as known to the guest."
2718 msgstr ""
2719
2720 #. type: =item
2721 #: ../cat/virt-ls.pod:238
2722 msgid "inode"
2723 msgstr ""
2724
2725 #. type: textblock
2726 #: ../cat/virt-ls.pod:240
2727 msgid "The inode number."
2728 msgstr ""
2729
2730 #. type: =item
2731 #: ../cat/virt-ls.pod:242
2732 msgid "nlink"
2733 msgstr ""
2734
2735 #. type: textblock
2736 #: ../cat/virt-ls.pod:244
2737 msgid "The number of hard links."
2738 msgstr ""
2739
2740 #. type: =item
2741 #: ../cat/virt-ls.pod:246
2742 msgid "rdev"
2743 msgstr ""
2744
2745 #. type: textblock
2746 #: ../cat/virt-ls.pod:248
2747 msgid ""
2748 "For block and char special files, the device (displayed as major:minor)."
2749 msgstr ""
2750
2751 #. type: =item
2752 #: ../cat/virt-ls.pod:251
2753 msgid "blocks"
2754 msgstr ""
2755
2756 #. type: textblock
2757 #: ../cat/virt-ls.pod:253
2758 msgid "The number of 512 byte blocks allocated to the file."
2759 msgstr ""
2760
2761 #. type: textblock
2762 #: ../cat/virt-ls.pod:257
2763 msgid ""
2764 "With the I<--checksum> flag, the checksum of the file contents is shown "
2765 "(only for regular files).  Computing file checksums can take a considerable "
2766 "amount of time."
2767 msgstr ""
2768
2769 #. type: =item
2770 #: ../cat/virt-ls.pod:280
2771 msgid "B<--checksum>"
2772 msgstr ""
2773
2774 #. type: =item
2775 #: ../cat/virt-ls.pod:282
2776 msgid "B<--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512>"
2777 msgstr ""
2778
2779 #. type: textblock
2780 #: ../cat/virt-ls.pod:284
2781 msgid ""
2782 "Display checksum over file contents for regular files.  With no argument, "
2783 "this defaults to using I<md5>.  Using an argument, you can select the "
2784 "checksum type to use."
2785 msgstr ""
2786
2787 #. type: textblock
2788 #: ../cat/virt-ls.pod:288 ../cat/virt-ls.pod:325 ../cat/virt-ls.pod:358
2789 #: ../cat/virt-ls.pod:391 ../cat/virt-ls.pod:401 ../cat/virt-ls.pod:408
2790 #: ../cat/virt-ls.pod:415 ../cat/virt-ls.pod:422
2791 msgid ""
2792 "This option only has effect in I<-lR> output mode.  See L</RECURSIVE LONG "
2793 "LISTING> above."
2794 msgstr ""
2795
2796 #. type: textblock
2797 #: ../cat/virt-ls.pod:316
2798 msgid ""
2799 "When prompting for keys and passphrases, virt-ls normally turns echoing off "
2800 "so you cannot see what you are typing.  If you are not worried about Tempest "
2801 "attacks and there is no one else in the room you can specify this flag to "
2802 "see what you are typing."
2803 msgstr ""
2804
2805 #. type: =item
2806 #: ../cat/virt-ls.pod:321
2807 msgid "B<--extra-stats>"
2808 msgstr ""
2809
2810 #. type: textblock
2811 #: ../cat/virt-ls.pod:323
2812 msgid "Display extra stats."
2813 msgstr ""
2814
2815 #. type: verbatim
2816 #: ../cat/virt-ls.pod:339
2817 #, no-wrap
2818 msgid ""
2819 " virt-ls --format=raw -a disk.img /dir\n"
2820 "\n"
2821 msgstr ""
2822
2823 #. type: verbatim
2824 #: ../cat/virt-ls.pod:343
2825 #, no-wrap
2826 msgid ""
2827 " virt-ls --format=raw -a disk.img --format -a another.img /dir\n"
2828 "\n"
2829 msgstr ""
2830
2831 #. type: textblock
2832 #: ../cat/virt-ls.pod:356
2833 msgid "Display file sizes in human-readable format."
2834 msgstr ""
2835
2836 #. type: =item
2837 #: ../cat/virt-ls.pod:370
2838 msgid "B<-R>"
2839 msgstr ""
2840
2841 #. type: =item
2842 #: ../cat/virt-ls.pod:372
2843 msgid "B<--recursive>"
2844 msgstr ""
2845
2846 #. type: textblock
2847 #: ../cat/virt-ls.pod:374
2848 msgid ""
2849 "Select the mode.  With neither of these options, C<virt-ls> produces a "
2850 "simple, flat list of the files in the named directory.  See L</SIMPLE "
2851 "LISTING>."
2852 msgstr ""
2853
2854 #. type: textblock
2855 #: ../cat/virt-ls.pod:378
2856 msgid ""
2857 "C<virt-ls -l> produces a \"long listing\", which shows more detail.  See L</"
2858 "LONG LISTING>."
2859 msgstr ""
2860
2861 #. type: textblock
2862 #: ../cat/virt-ls.pod:381
2863 msgid ""
2864 "C<virt-ls -R> produces a recursive list of files starting at the named "
2865 "directory.  See L</RECURSIVE LISTING>."
2866 msgstr ""
2867
2868 #. type: textblock
2869 #: ../cat/virt-ls.pod:384
2870 msgid ""
2871 "C<virt-ls -lR> produces a recursive long listing which can be more easily "
2872 "parsed.  See L</RECURSIVE LONG LISTING>."
2873 msgstr ""
2874
2875 #. type: =item
2876 #: ../cat/virt-ls.pod:387
2877 msgid "B<--times>"
2878 msgstr ""
2879
2880 #. type: textblock
2881 #: ../cat/virt-ls.pod:389
2882 msgid "Display time fields."
2883 msgstr ""
2884
2885 #. type: =item
2886 #: ../cat/virt-ls.pod:394
2887 msgid "B<--time-days>"
2888 msgstr ""
2889
2890 #. type: textblock
2891 #: ../cat/virt-ls.pod:396
2892 msgid "Display time fields as days before now (negative if in the future)."
2893 msgstr ""
2894
2895 #. type: textblock
2896 #: ../cat/virt-ls.pod:398
2897 msgid ""
2898 "Note that C<0> in output means \"up to 1 day before now\", or that the age "
2899 "of the file is between 0 and 86399 seconds."
2900 msgstr ""
2901
2902 #. type: =item
2903 #: ../cat/virt-ls.pod:404
2904 msgid "B<--time-relative>"
2905 msgstr ""
2906
2907 #. type: textblock
2908 #: ../cat/virt-ls.pod:406
2909 msgid "Display time fields as seconds before now (negative if in the future)."
2910 msgstr ""
2911
2912 #. type: =item
2913 #: ../cat/virt-ls.pod:411
2914 msgid "B<--time-t>"
2915 msgstr ""
2916
2917 #. type: textblock
2918 #: ../cat/virt-ls.pod:413
2919 msgid "Display time fields as seconds since the Unix epoch."
2920 msgstr ""
2921
2922 #. type: =item
2923 #: ../cat/virt-ls.pod:418
2924 msgid "B<--uids>"
2925 msgstr ""
2926
2927 #. type: textblock
2928 #: ../cat/virt-ls.pod:420
2929 msgid "Display UID and GID fields."
2930 msgstr ""
2931
2932 #. type: textblock
2933 #: ../cat/virt-ls.pod:445
2934 msgid "Previous versions of virt-ls allowed you to write either:"
2935 msgstr ""
2936
2937 #. type: verbatim
2938 #: ../cat/virt-ls.pod:447
2939 #, no-wrap
2940 msgid ""
2941 " virt-ls disk.img [disk.img ...] /dir\n"
2942 "\n"
2943 msgstr ""
2944
2945 #. type: verbatim
2946 #: ../cat/virt-ls.pod:451
2947 #, no-wrap
2948 msgid ""
2949 " virt-ls guestname /dir\n"
2950 "\n"
2951 msgstr ""
2952
2953 #. type: textblock
2954 #: ../cat/virt-ls.pod:497
2955 msgid ""
2956 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-out(1)>, L<virt-"
2957 "tar-out(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
2958 "L<http://libguestfs.org/>."
2959 msgstr ""
2960
2961 #. type: textblock
2962 #: ../cat/virt-ls.pod:513 ../df/virt-df.pod:241 ../edit/virt-edit.pod:374
2963 #: ../rescue/virt-rescue.pod:302
2964 msgid "Copyright (C) 2009-2011 Red Hat Inc."
2965 msgstr ""
2966
2967 #. type: textblock
2968 #: ../clone/virt-sysprep.pod:5
2969 msgid ""
2970 "virt-sysprep - Reset or unconfigure a virtual machine so clones can be made"
2971 msgstr ""
2972
2973 #. type: verbatim
2974 #: ../clone/virt-sysprep.pod:9
2975 #, no-wrap
2976 msgid ""
2977 " virt-sysprep [--options] -d domname\n"
2978 "\n"
2979 msgstr ""
2980
2981 #. type: verbatim
2982 #: ../clone/virt-sysprep.pod:11
2983 #, no-wrap
2984 msgid ""
2985 " virt-sysprep [--options] -a disk.img [-a disk.img ...]\n"
2986 "\n"
2987 msgstr ""
2988
2989 #. type: textblock
2990 #: ../clone/virt-sysprep.pod:15
2991 msgid ""
2992 "Virt-sysprep \"resets\" or \"unconfigures\" a virtual machine so that clones "
2993 "can be made from it.  Steps in this process include removing SSH host keys, "
2994 "removing persistent network MAC configuration, and removing user accounts.  "
2995 "Each step can be enabled or disabled as required."
2996 msgstr ""
2997
2998 #. type: textblock
2999 #: ../clone/virt-sysprep.pod:21
3000 msgid ""
3001 "Virt-sysprep is a simple shell script, allowing easy inspection or "
3002 "customization by the system administrator."
3003 msgstr ""
3004
3005 #. type: textblock
3006 #: ../clone/virt-sysprep.pod:24
3007 msgid ""
3008 "Virt-sysprep modifies the guest or disk image I<in place>.  The guest must "
3009 "be shut down.  If you want to preserve the existing contents of the guest, "
3010 "you I<must copy or clone the disk first>.  See L</COPYING AND CLONING> below."
3011 msgstr ""
3012
3013 #. type: textblock
3014 #: ../clone/virt-sysprep.pod:29
3015 msgid ""
3016 "You do I<not> need to run virt-sysprep as root.  In fact we'd generally "
3017 "recommend that you don't.  The time you might want to run it as root is when "
3018 "you need root in order to access the disk image, but even in this case it "
3019 "would be better to change the permissions on the disk image to be writable "
3020 "as the non-root user running virt-sysprep."
3021 msgstr ""
3022
3023 #. type: textblock
3024 #: ../clone/virt-sysprep.pod:35
3025 msgid ""
3026 "\"Sysprep\" stands for \"system preparation\" tool.  The name comes from the "
3027 "Microsoft program C<sysprep.exe> which is used to unconfigure Windows "
3028 "machines in preparation for cloning them.  Having said that, virt-sysprep "
3029 "does I<not> currently work on Microsoft Windows guests.  We plan to support "
3030 "Windows sysprepping in a future version, and we already have code to do it."
3031 msgstr ""
3032
3033 #. type: =item
3034 #: ../clone/virt-sysprep.pod:76
3035 msgid "B<--enable=...>"
3036 msgstr ""
3037
3038 #. type: textblock
3039 #: ../clone/virt-sysprep.pod:78
3040 msgid ""
3041 "Choose which sysprep operations to perform.  Give a comma-separated list of "
3042 "operations, for example:"
3043 msgstr ""
3044
3045 #. type: verbatim
3046 #: ../clone/virt-sysprep.pod:81
3047 #, no-wrap
3048 msgid ""
3049 " --enable=ssh-hostkeys,udev-persistent-net\n"
3050 "\n"
3051 msgstr ""
3052
3053 #. type: textblock
3054 #: ../clone/virt-sysprep.pod:83
3055 msgid ""
3056 "would enable ONLY C<ssh-hostkeys> and C<udev-persistent-net> operations."
3057 msgstr ""
3058
3059 #. type: textblock
3060 #: ../clone/virt-sysprep.pod:85
3061 msgid ""
3062 "If the I<--enable> option is not given, then we default to trying all "
3063 "possible sysprep operations.  But some sysprep operations are skipped for "
3064 "some guest types."
3065 msgstr ""
3066
3067 #. type: textblock
3068 #: ../clone/virt-sysprep.pod:89
3069 msgid ""
3070 "Use I<--list-operations> to list operations supported by a particular "
3071 "version of virt-sysprep."
3072 msgstr ""
3073
3074 #. type: textblock
3075 #: ../clone/virt-sysprep.pod:92
3076 msgid ""
3077 "See L</OPERATIONS> below for a list and an explanation of each operation."
3078 msgstr ""
3079
3080 #. type: verbatim
3081 #: ../clone/virt-sysprep.pod:106
3082 #, no-wrap
3083 msgid ""
3084 " virt-sysprep --format=raw -a disk.img\n"
3085 "\n"
3086 msgstr ""
3087
3088 #. type: verbatim
3089 #: ../clone/virt-sysprep.pod:110
3090 #, no-wrap
3091 msgid ""
3092 " virt-sysprep --format=raw -a disk.img --format -a another.img\n"
3093 "\n"
3094 msgstr ""
3095
3096 #. type: =item
3097 #: ../clone/virt-sysprep.pod:119
3098 msgid "B<--hostname> newhostname"
3099 msgstr ""
3100
3101 #. type: textblock
3102 #: ../clone/virt-sysprep.pod:121
3103 msgid ""
3104 "Change the hostname.  See the L</hostname> operation below.  If not given, "
3105 "defaults to C<localhost.localdomain>."
3106 msgstr ""
3107
3108 #. type: =item
3109 #: ../clone/virt-sysprep.pod:124
3110 msgid "B<--list-operations>"
3111 msgstr ""
3112
3113 #. type: textblock
3114 #: ../clone/virt-sysprep.pod:126
3115 msgid "List the operations supported by the virt-sysprep program."
3116 msgstr ""
3117
3118 #. type: =item
3119 #: ../clone/virt-sysprep.pod:128
3120 msgid "B<--selinux-relabel>"
3121 msgstr ""
3122
3123 #. type: =item
3124 #: ../clone/virt-sysprep.pod:130
3125 msgid "B<--no-selinux-relabel>"
3126 msgstr ""
3127
3128 #. type: textblock
3129 #: ../clone/virt-sysprep.pod:132
3130 msgid ""
3131 "I<--selinux-relabel> forces SELinux relabelling next time the guest boots.  "
3132 "I<--no-selinux-relabel> disables relabelling."
3133 msgstr ""
3134
3135 #. type: textblock
3136 #: ../clone/virt-sysprep.pod:135
3137 msgid ""
3138 "The default is to try to detect if SELinux relabelling is required.  See L</"
3139 "SELINUX RELABELLING> below for more details."
3140 msgstr ""
3141
3142 #. type: =head1
3143 #: ../clone/virt-sysprep.pod:156
3144 msgid "OPERATIONS"
3145 msgstr ""
3146
3147 #. type: textblock
3148 #: ../clone/virt-sysprep.pod:158
3149 msgid ""
3150 "If the I<--enable> option is I<not> given, then I<all sysprep operations are "
3151 "enabled>, although some are skipped depending on the type of guest."
3152 msgstr ""
3153
3154 #. type: textblock
3155 #: ../clone/virt-sysprep.pod:162
3156 msgid ""
3157 "Operations can be individually enabled using the I<--enable> option.  Use a "
3158 "comma-separated list, for example:"
3159 msgstr ""
3160
3161 #. type: verbatim
3162 #: ../clone/virt-sysprep.pod:165
3163 #, no-wrap
3164 msgid ""
3165 " virt-sysprep --enable=ssh-hostkeys,udev-persistent-net [etc..]\n"
3166 "\n"
3167 msgstr ""
3168
3169 #. type: textblock
3170 #: ../clone/virt-sysprep.pod:167
3171 msgid ""
3172 "To list the operations supported by the current version of virt-sysprep, use "
3173 "I<--list-operations>."
3174 msgstr ""
3175
3176 #. type: textblock
3177 #: ../clone/virt-sysprep.pod:170
3178 msgid ""
3179 "Future versions of virt-sysprep may add more operations.  If you are using "
3180 "virt-sysprep and want predictable behaviour, specify only the operations "
3181 "that you want to have enabled."
3182 msgstr ""
3183
3184 #. type: =head2
3185 #: ../clone/virt-sysprep.pod:174
3186 msgid "cron-spool"
3187 msgstr ""
3188
3189 #. type: textblock
3190 #: ../clone/virt-sysprep.pod:176
3191 msgid "Remove user at-jobs and cron-jobs."
3192 msgstr ""
3193
3194 #. type: =head2
3195 #: ../clone/virt-sysprep.pod:178
3196 msgid "dhcp-client-state"
3197 msgstr ""
3198
3199 #. type: textblock
3200 #: ../clone/virt-sysprep.pod:180
3201 msgid "Remove DHCP client leases."
3202 msgstr ""
3203
3204 #. type: =head2
3205 #: ../clone/virt-sysprep.pod:182
3206 msgid "dhcp-server-state"
3207 msgstr ""
3208
3209 #. type: textblock
3210 #: ../clone/virt-sysprep.pod:184
3211 msgid "Remove DHCP server leases."
3212 msgstr ""
3213
3214 #. type: =head2
3215 #: ../clone/virt-sysprep.pod:186
3216 msgid "hostname"
3217 msgstr ""
3218
3219 #. type: textblock
3220 #: ../clone/virt-sysprep.pod:188
3221 msgid ""
3222 "Changes the hostname of the guest to the value given in the I<--hostname> "
3223 "parameter."
3224 msgstr ""
3225
3226 #. type: textblock
3227 #: ../clone/virt-sysprep.pod:191
3228 msgid ""
3229 "If the I<--hostname> parameter is not given, then the hostname is changed to "
3230 "C<localhost.localdomain>."
3231 msgstr ""
3232
3233 #. type: =head2
3234 #: ../clone/virt-sysprep.pod:194
3235 msgid "logfiles"
3236 msgstr ""
3237
3238 #. type: textblock
3239 #: ../clone/virt-sysprep.pod:196
3240 msgid "Remove many log files."
3241 msgstr ""
3242
3243 #. type: =head2
3244 #: ../clone/virt-sysprep.pod:198
3245 msgid "mail-spool"
3246 msgstr ""
3247
3248 #. type: textblock
3249 #: ../clone/virt-sysprep.pod:200
3250 msgid "Remove email from the local mail spool directory."
3251 msgstr ""
3252
3253 #. type: =head2
3254 #: ../clone/virt-sysprep.pod:202
3255 msgid "net-hwaddr"
3256 msgstr ""
3257
3258 #. type: textblock
3259 #: ../clone/virt-sysprep.pod:204
3260 msgid ""
3261 "Remove HWADDR (hard-coded MAC address) configuration.  For Fedora and Red "
3262 "Hat Enterprise Linux, this is removed from C<ifcfg-*> files."
3263 msgstr ""
3264
3265 #. type: =head2
3266 #: ../clone/virt-sysprep.pod:207
3267 msgid "random-seed"
3268 msgstr ""
3269
3270 #. type: textblock
3271 #: ../clone/virt-sysprep.pod:209
3272 msgid ""
3273 "Write some random bytes from the host into the random seed file of the guest."
3274 msgstr ""
3275
3276 #. type: textblock
3277 #: ../clone/virt-sysprep.pod:212
3278 msgid "See L</RANDOM SEED> below."
3279 msgstr ""
3280
3281 #. type: =head2
3282 #: ../clone/virt-sysprep.pod:214
3283 msgid "rhn-systemid"
3284 msgstr ""
3285
3286 #. type: textblock
3287 #: ../clone/virt-sysprep.pod:216
3288 msgid "Remove the RHN system ID."
3289 msgstr ""
3290
3291 #. type: =head2
3292 #: ../clone/virt-sysprep.pod:218
3293 msgid "smolt-uuid"
3294 msgstr ""
3295
3296 #. type: textblock
3297 #: ../clone/virt-sysprep.pod:220
3298 msgid "Remove the Smolt hardware UUID."
3299 msgstr ""
3300
3301 #. type: =head2
3302 #: ../clone/virt-sysprep.pod:222
3303 msgid "ssh-hostkeys"
3304 msgstr ""
3305
3306 #. type: textblock
3307 #: ../clone/virt-sysprep.pod:224
3308 msgid "Remove the SSH host keys in the guest."
3309 msgstr ""
3310
3311 #. type: textblock
3312 #: ../clone/virt-sysprep.pod:226
3313 msgid ""
3314 "The SSH host keys are regenerated (differently) next time the guest is "
3315 "booted."
3316 msgstr ""
3317
3318 #. type: textblock
3319 #: ../clone/virt-sysprep.pod:229
3320 msgid ""
3321 "If, after cloning, the guest gets the same IP address, ssh will give you a "
3322 "stark warning about the host key changing:"
3323 msgstr ""
3324
3325 #. type: verbatim
3326 #: ../clone/virt-sysprep.pod:232
3327 #, no-wrap
3328 msgid ""
3329 " @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n"
3330 " @    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @\n"
3331 " @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n"
3332 " IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!\n"
3333 "\n"
3334 msgstr ""
3335
3336 #. type: =head2
3337 #: ../clone/virt-sysprep.pod:237
3338 msgid "udev-persistent-net"
3339 msgstr ""
3340
3341 #. type: textblock
3342 #: ../clone/virt-sysprep.pod:239
3343 msgid ""
3344 "Remove udev persistent net rules which map the guest's existing MAC address "
3345 "to a fixed ethernet device (eg. eth0)."
3346 msgstr ""
3347
3348 #. type: textblock
3349 #: ../clone/virt-sysprep.pod:242
3350 msgid ""
3351 "After a guest is cloned, the MAC address usually changes.  Since the old MAC "
3352 "address occupies the old name (eg. eth0), this means the fresh MAC address "
3353 "is assigned to a new name (eg. eth1) and this is usually undesirable.  "
3354 "Erasing the udev persistent net rules avoids this."
3355 msgstr ""
3356
3357 #. type: =head2
3358 #: ../clone/virt-sysprep.pod:247
3359 msgid "utmp"
3360 msgstr ""
3361
3362 #. type: textblock
3363 #: ../clone/virt-sysprep.pod:249
3364 msgid "Remove the utmp file."
3365 msgstr ""
3366
3367 #. type: textblock
3368 #: ../clone/virt-sysprep.pod:251
3369 msgid ""
3370 "This records who is currently logged in on a machine.  In modern Linux "
3371 "distros it is stored in a ramdisk and hence not part of the virtual "
3372 "machine's disk, but it was stored on disk in older distros."
3373 msgstr ""
3374
3375 #. type: =head2
3376 #: ../clone/virt-sysprep.pod:255
3377 msgid "yum-uuid"
3378 msgstr ""
3379
3380 #. type: textblock
3381 #: ../clone/virt-sysprep.pod:257
3382 msgid "Remove the yum UUID."
3383 msgstr ""
3384
3385 #. type: textblock
3386 #: ../clone/virt-sysprep.pod:259
3387 msgid ""
3388 "Yum creates a fresh UUID the next time it runs when it notices that the "
3389 "original UUID has been erased."
3390 msgstr ""
3391
3392 #. type: =head1
3393 #: ../clone/virt-sysprep.pod:262
3394 msgid "COPYING AND CLONING"
3395 msgstr ""
3396
3397 #. type: textblock
3398 #: ../clone/virt-sysprep.pod:264
3399 msgid ""
3400 "Virt-sysprep can be used as part of a process of cloning guests, or to "
3401 "prepare a template from which guests can be cloned.  There are many "
3402 "different ways to achieve this using the virt tools, and this section is "
3403 "just an introduction."
3404 msgstr ""
3405
3406 #. type: textblock
3407 #: ../clone/virt-sysprep.pod:269
3408 msgid "A virtual machine (when switched off) consists of two parts:"
3409 msgstr ""
3410
3411 #. type: =item
3412 #: ../clone/virt-sysprep.pod:273
3413 msgid "I<configuration>"
3414 msgstr ""
3415
3416 #. type: textblock
3417 #: ../clone/virt-sysprep.pod:275
3418 msgid ""
3419 "The configuration or description of the guest.  eg. The libvirt XML (see "
3420 "C<virsh dumpxml>), the running configuration of the guest, or another "
3421 "external format like OVF."
3422 msgstr ""
3423
3424 #. type: textblock
3425 #: ../clone/virt-sysprep.pod:279
3426 msgid "Some configuration items that might need to be changed:"
3427 msgstr ""
3428
3429 #. type: textblock
3430 #: ../clone/virt-sysprep.pod:285
3431 msgid "name"
3432 msgstr ""
3433
3434 #. type: textblock
3435 #: ../clone/virt-sysprep.pod:289 ../clone/virt-sysprep.pod:316
3436 msgid "UUID"
3437 msgstr ""
3438
3439 #. type: textblock
3440 #: ../clone/virt-sysprep.pod:293
3441 msgid "path to block device(s)"
3442 msgstr ""
3443
3444 #. type: textblock
3445 #: ../clone/virt-sysprep.pod:297
3446 msgid "network card MAC address"
3447 msgstr ""
3448
3449 #. type: =item
3450 #: ../clone/virt-sysprep.pod:301
3451 msgid "I<block device(s)>"
3452 msgstr ""
3453
3454 #. type: textblock
3455 #: ../clone/virt-sysprep.pod:303
3456 msgid ""
3457 "One or more hard disk images, themselves containing files, directories, "
3458 "applications, kernels, configuration, etc."
3459 msgstr ""
3460
3461 #. type: textblock
3462 #: ../clone/virt-sysprep.pod:306
3463 msgid "Some things inside the block devices that might need to be changed:"
3464 msgstr ""
3465
3466 #. type: textblock
3467 #: ../clone/virt-sysprep.pod:312
3468 msgid "hostname and other net configuration"
3469 msgstr ""
3470
3471 #. type: textblock
3472 #: ../clone/virt-sysprep.pod:320
3473 msgid "SSH host keys"
3474 msgstr ""
3475
3476 #. type: textblock
3477 #: ../clone/virt-sysprep.pod:324
3478 msgid "Windows unique security ID (SID)"
3479 msgstr ""
3480
3481 #. type: textblock
3482 #: ../clone/virt-sysprep.pod:328
3483 msgid "Puppet registration"
3484 msgstr ""
3485
3486 #. type: =head2
3487 #: ../clone/virt-sysprep.pod:334
3488 msgid "COPYING THE BLOCK DEVICE"
3489 msgstr ""
3490
3491 #. type: textblock
3492 #: ../clone/virt-sysprep.pod:336
3493 msgid ""
3494 "Starting with an original guest, you probably wish to copy the guest block "
3495 "device and its configuration to make a template.  Then once you are happy "
3496 "with the template, you will want to make many clones from it."
3497 msgstr ""
3498
3499 #. type: verbatim
3500 #: ../clone/virt-sysprep.pod:341
3501 #, no-wrap
3502 msgid ""
3503 "                        virt-sysprep\n"
3504 "                             |\n"
3505 "                             v\n"
3506 " original guest --------> template ---------->\n"
3507 "                                      \\------> cloned\n"
3508 "                                       \\-----> guests\n"
3509 "                                        \\---->\n"
3510 "\n"
3511 msgstr ""
3512
3513 #. type: textblock
3514 #: ../clone/virt-sysprep.pod:349
3515 msgid ""
3516 "You can, of course, just copy the block device on the host using L<cp(1)> or "
3517 "L<dd(1)>."
3518 msgstr ""
3519
3520 #. type: verbatim
3521 #: ../clone/virt-sysprep.pod:352
3522 #, no-wrap
3523 msgid ""
3524 "                   dd                 dd\n"
3525 " original guest --------> template ---------->\n"
3526 "                                      \\------> cloned\n"
3527 "                                       \\-----> guests\n"
3528 "                                        \\---->\n"
3529 "\n"
3530 msgstr ""
3531
3532 #. type: textblock
3533 #: ../clone/virt-sysprep.pod:358
3534 msgid "There are some smarter (and faster) ways too:"
3535 msgstr ""
3536
3537 #. type: verbatim
3538 #: ../clone/virt-sysprep.pod:364
3539 #, no-wrap
3540 msgid ""
3541 "                          snapshot\n"
3542 "                template ---------->\n"
3543 "                            \\------> cloned\n"
3544 "                             \\-----> guests\n"
3545 "                              \\---->\n"
3546 "\n"
3547 msgstr ""
3548
3549 #. type: textblock
3550 #: ../clone/virt-sysprep.pod:370
3551 msgid ""
3552 "Use the block device as a backing file and create a snapshot on top for each "
3553 "guest.  The advantage is that you don't need to copy the block device (very "
3554 "fast) and only changes are stored (less storage required)."
3555 msgstr ""
3556
3557 #. type: textblock
3558 #: ../clone/virt-sysprep.pod:375
3559 msgid ""
3560 "Note that writing to the backing file once you have created guests on top of "
3561 "it is not possible: you will corrupt the guests."
3562 msgstr ""
3563
3564 #. type: textblock
3565 #: ../clone/virt-sysprep.pod:378
3566 msgid ""
3567 "Tools that can do this include: L<qemu-img(1)> (with the I<create -f qcow2 -"
3568 "o backing_file> option), L<lvcreate(8)> (I<--snapshot> option).  Some "
3569 "filesystems (such as btrfs) and most Network Attached Storage devices can "
3570 "also create cheap snapshots from files or LUNs."
3571 msgstr ""
3572
3573 #. type: textblock
3574 #: ../clone/virt-sysprep.pod:386
3575 msgid "Get your NAS to snapshot and/or duplicate the LUN."
3576 msgstr ""
3577
3578 #. type: textblock
3579 #: ../clone/virt-sysprep.pod:390
3580 msgid "Prepare your template using L<virt-sparsify(1)>.  See below."
3581 msgstr ""
3582
3583 #. type: =head2
3584 #: ../clone/virt-sysprep.pod:394
3585 msgid "VIRT-CLONE"
3586 msgstr ""
3587
3588 #. type: textblock
3589 #: ../clone/virt-sysprep.pod:396
3590 msgid ""
3591 "A separate tool, L<virt-clone(1)>, can be used to duplicate the block device "
3592 "and/or modify the external libvirt configuration of a guest.  It will reset "
3593 "the name, UUID and MAC address of the guest in the libvirt XML."
3594 msgstr ""
3595
3596 #. type: textblock
3597 #: ../clone/virt-sysprep.pod:401
3598 msgid ""
3599 "L<virt-clone(1)> does not use libguestfs and cannot look inside the disk "
3600 "image.  This was the original motivation to write virt-sysprep."
3601 msgstr ""
3602
3603 #. type: =head2
3604 #: ../clone/virt-sysprep.pod:404
3605 msgid "SPARSIFY"
3606 msgstr ""
3607
3608 #. type: verbatim
3609 #: ../clone/virt-sysprep.pod:406
3610 #, no-wrap
3611 msgid ""
3612 "              virt-sparsify\n"
3613 " original guest --------> template\n"
3614 "\n"
3615 msgstr ""
3616
3617 #. type: textblock
3618 #: ../clone/virt-sysprep.pod:409
3619 msgid ""
3620 "L<virt-sparsify(1)> can be used to make the cloning template smaller, making "
3621 "it easier to compress and/or faster to copy."
3622 msgstr ""
3623
3624 #. type: textblock
3625 #: ../clone/virt-sysprep.pod:412
3626 msgid ""
3627 "Notice that since virt-sparsify also copies the image, you can use it to "
3628 "make the initial copy (instead of C<dd>)."
3629 msgstr ""
3630
3631 #. type: =head2
3632 #: ../clone/virt-sysprep.pod:415
3633 msgid "RESIZE"
3634 msgstr ""
3635
3636 #. type: verbatim
3637 #: ../clone/virt-sysprep.pod:417
3638 #, no-wrap
3639 msgid ""
3640 "                         virt-resize\n"
3641 "                template ---------->\n"
3642 "                            \\------> cloned\n"
3643 "                             \\-----> guests\n"
3644 "                              \\---->\n"
3645 "\n"
3646 msgstr ""
3647
3648 #. type: textblock
3649 #: ../clone/virt-sysprep.pod:423
3650 msgid ""
3651 "If you want to give people cloned guests, but let them pick the size of the "
3652 "guest themselves (eg. depending on how much they are prepared to pay for "
3653 "disk space), then instead of copying the template, you can run L<virt-resize"
3654 "(1)>.  Virt-resize performs a copy and resize, and thus is ideal for cloning "
3655 "guests from a template."
3656 msgstr ""
3657
3658 #. type: =head1
3659 #: ../clone/virt-sysprep.pod:429 ../src/guestfs.pod:1164
3660 msgid "SECURITY"
3661 msgstr ""
3662
3663 #. type: textblock
3664 #: ../clone/virt-sysprep.pod:431
3665 msgid ""
3666 "Although virt-sysprep removes some sensitive information from the guest, it "
3667 "does not pretend to remove all of it.  You should examine the L</OPERATIONS> "
3668 "above, and the implementation of the operations in the shell script.  You "
3669 "should also examine the guest afterwards."
3670 msgstr ""
3671
3672 #. type: textblock
3673 #: ../clone/virt-sysprep.pod:436
3674 msgid ""
3675 "Sensitive files are simply removed.  The data they contained may still exist "
3676 "on the disk, easily recovered with a hex editor or undelete tool.  Use "
3677 "L<virt-sparsify(1)> as one way to remove this content.  See also the L<scrub"
3678 "(1)> command to get rid of deleted content in directory entries and inodes."
3679 msgstr ""
3680
3681 #. type: =head2
3682 #: ../clone/virt-sysprep.pod:442
3683 msgid "RANDOM SEED"
3684 msgstr ""
3685
3686 #. type: textblock
3687 #: ../clone/virt-sysprep.pod:444
3688 msgid "I<(This section applies to Linux guests only)>"
3689 msgstr ""
3690
3691 #. type: textblock
3692 #: ../clone/virt-sysprep.pod:446
3693 msgid ""
3694 "The virt-sysprep C<random-seed> operation writes a few bytes of randomness "
3695 "from the host into the guest's random seed file."
3696 msgstr ""
3697
3698 #. type: textblock
3699 #: ../clone/virt-sysprep.pod:449
3700 msgid ""
3701 "If this is just done once and the guest is cloned from the same template, "
3702 "then each guest will start with the same entropy, and things like SSH host "
3703 "keys and TCP sequence numbers may be predictable."
3704 msgstr ""
3705
3706 #. type: textblock
3707 #: ../clone/virt-sysprep.pod:453
3708 msgid ""
3709 "Therefore you should arrange to add more randomness I<after> cloning from a "
3710 "template too, which can be done by just enabling the C<random-seed> "
3711 "operation:"
3712 msgstr ""
3713
3714 #. type: verbatim
3715 #: ../clone/virt-sysprep.pod:457
3716 #, no-wrap
3717 msgid ""
3718 " cp template.img newguest.img\n"
3719 " virt-sysprep --enable=random-seed -a newguest.img\n"
3720 "\n"
3721 msgstr ""
3722
3723 #. type: =head2
3724 #: ../clone/virt-sysprep.pod:460
3725 msgid "SELINUX RELABELLING"
3726 msgstr ""
3727
3728 #. type: textblock
3729 #: ../clone/virt-sysprep.pod:462
3730 msgid "I<(This section applies to Linux guests using SELinux only)>"
3731 msgstr ""
3732
3733 #. type: textblock
3734 #: ../clone/virt-sysprep.pod:464
3735 msgid ""
3736 "If any new files are created by virt-sysprep, then virt-sysprep touches C</."
3737 "autorelabel> so that these will be correctly labelled by SELinux the next "
3738 "time the guest is booted.  This process interrupts boot and can take some "
3739 "time."
3740 msgstr ""
3741
3742 #. type: textblock
3743 #: ../clone/virt-sysprep.pod:469
3744 msgid ""
3745 "You can force relabelling for all guests by supplying the I<--selinux-"
3746 "relabel> option."
3747 msgstr ""
3748
3749 #. type: textblock
3750 #: ../clone/virt-sysprep.pod:472
3751 msgid ""
3752 "You can disable relabelling entirely by supplying the I<--no-selinux-"
3753 "relabel> option."
3754 msgstr ""
3755
3756 #. type: textblock
3757 #: ../clone/virt-sysprep.pod:484
3758 msgid "This program returns 0 on success, or 1 if there was an error."
3759 msgstr ""
3760
3761 #. type: textblock
3762 #: ../clone/virt-sysprep.pod:488
3763 msgid ""
3764 "L<guestfs(3)>, L<guestfish(1)>, L<virt-clone(1)>, L<virt-rescue(1)>, L<virt-"
3765 "resize(1)>, L<virt-sparsify(1)>, L<virsh(1)>, L<lvcreate(8)>, L<qemu-img(1)"
3766 ">, L<scrub(1)>, L<http://libguestfs.org/>, L<http://libvirt.org/>."
3767 msgstr ""
3768
3769 #. type: textblock
3770 #: ../df/virt-df.pod:5
3771 msgid "virt-df - Display free space on virtual filesystems"
3772 msgstr ""
3773
3774 #. type: verbatim
3775 #: ../df/virt-df.pod:9
3776 #, no-wrap
3777 msgid ""
3778 " virt-df [--options]\n"
3779 "\n"
3780 msgstr ""
3781
3782 #. type: verbatim
3783 #: ../df/virt-df.pod:11
3784 #, no-wrap
3785 msgid ""
3786 " virt-df [--options] -d domname\n"
3787 "\n"
3788 msgstr ""
3789
3790 #. type: verbatim
3791 #: ../df/virt-df.pod:13
3792 #, no-wrap
3793 msgid ""
3794 " virt-df [--options] -a disk.img [-a disk.img ...]\n"
3795 "\n"
3796 msgstr ""
3797
3798 #. type: verbatim
3799 #: ../df/virt-df.pod:17
3800 #, no-wrap
3801 msgid ""
3802 " virt-df [--options] domname\n"
3803 "\n"
3804 msgstr ""
3805
3806 #. type: verbatim
3807 #: ../df/virt-df.pod:19
3808 #, no-wrap
3809 msgid ""
3810 " virt-df [--options] disk.img [disk.img ...]\n"
3811 "\n"
3812 msgstr ""
3813
3814 #. type: textblock
3815 #: ../df/virt-df.pod:23
3816 msgid ""
3817 "C<virt-df> is a command line tool to display free space on virtual machine "
3818 "filesystems.  Unlike other tools, it doesn't just display the size of disk "
3819 "allocated to a virtual machine, but can look inside disk images to see how "
3820 "much space is really being used."
3821 msgstr ""
3822
3823 #. type: textblock
3824 #: ../df/virt-df.pod:28
3825 msgid ""
3826 "If used without any I<-a> or I<-d> arguments, C<virt-df> checks with libvirt "
3827 "to get a list of all active and inactive guests, and performs a C<df>-type "
3828 "operation on each one in turn, printing out the results."
3829 msgstr ""
3830
3831 #. type: textblock
3832 #: ../df/virt-df.pod:32
3833 msgid ""
3834 "If any I<-a> or I<-d> arguments are specified, C<virt-df> performs a C<df>-"
3835 "type operation on either the single named libvirt domain, or on the disk "
3836 "image(s) listed on the command line (which must all belong to a single VM).  "
3837 "In this mode (with arguments), C<virt-df> will I<only work for a single "
3838 "guest>.  If you want to run on multiple guests, then you have to invoke "
3839 "C<virt-df> multiple times."
3840 msgstr ""
3841
3842 #. type: textblock
3843 #: ../df/virt-df.pod:39
3844 msgid ""
3845 "Use the I<--csv> option to get a format which can be easily parsed by other "
3846 "programs.  Other options are similar to the standard L<df(1)> command."
3847 msgstr ""
3848
3849 #. type: textblock
3850 #: ../df/virt-df.pod:45
3851 msgid ""
3852 "Show disk usage for a single libvirt guest called C<F14x64>.  Make the "
3853 "output human-readable:"
3854 msgstr ""
3855
3856 #. type: verbatim
3857 #: ../df/virt-df.pod:48
3858 #, no-wrap
3859 msgid ""
3860 " # virt-df -d F14x64 -h\n"
3861 " Filesystem                       Size     Used  Available  Use%\n"
3862 " F14x64:/dev/sda1                 484M      66M       393M   14%\n"
3863 " F14x64:/dev/vg_f13x64/lv_root    7.4G     3.4G       4.0G   46%\n"
3864 "\n"
3865 msgstr ""
3866
3867 #. type: textblock
3868 #: ../df/virt-df.pod:53
3869 msgid "Show disk usage for a disk image file called C<test.img>:"
3870 msgstr ""
3871
3872 #. type: verbatim
3873 #: ../df/virt-df.pod:55
3874 #, no-wrap
3875 msgid ""
3876 " $ virt-df -a test1.img\n"
3877 " Filesystem                  1K-blocks     Used  Available  Use%\n"
3878 " test1.img:/dev/sda1             99099     1551      92432    2%\n"
3879 "\n"
3880 msgstr ""
3881
3882 #. type: verbatim
3883 #: ../df/virt-df.pod:112
3884 #, no-wrap
3885 msgid ""
3886 " virt-df --format=raw -a disk.img\n"
3887 "\n"
3888 msgstr ""
3889
3890 #. type: verbatim
3891 #: ../df/virt-df.pod:116
3892 #, no-wrap
3893 msgid ""
3894 " virt-df --format=raw -a disk.img --format -a another.img\n"
3895 "\n"
3896 msgstr ""
3897
3898 #. type: textblock
3899 #: ../df/virt-df.pod:129
3900 msgid "Print sizes in human-readable format."
3901 msgstr ""
3902
3903 #. type: textblock
3904 #: ../df/virt-df.pod:131
3905 msgid "You are not allowed to use I<-h> and I<--csv> at the same time."
3906 msgstr ""
3907
3908 #. type: =item
3909 #: ../df/virt-df.pod:133 ../fish/guestfish.pod:258 ../fuse/guestmount.pod:164
3910 msgid "B<-i>"
3911 msgstr ""
3912
3913 #. type: =item
3914 #: ../df/virt-df.pod:135
3915 msgid "B<--inodes>"
3916 msgstr ""
3917
3918 #. type: textblock
3919 #: ../df/virt-df.pod:137
3920 msgid "Print inodes instead of blocks."
3921 msgstr ""
3922
3923 #. type: =item
3924 #: ../df/virt-df.pod:139
3925 msgid "B<--one-per-guest>"
3926 msgstr ""
3927
3928 #. type: textblock
3929 #: ../df/virt-df.pod:141
3930 msgid ""
3931 "Run one libguestfs appliance per guest.  Normally C<virt-df> will add the "
3932 "disks from several guests to a single libguestfs appliance."
3933 msgstr ""
3934
3935 #. type: textblock
3936 #: ../df/virt-df.pod:144
3937 msgid "You might use this option in the following circumstances:"
3938 msgstr ""
3939
3940 #. type: textblock
3941 #: ../df/virt-df.pod:150
3942 msgid ""
3943 "If you think an untrusted guest might actively try to exploit the libguestfs "
3944 "appliance kernel, then this prevents one guest from interfering with the "
3945 "stats printed for another guest."
3946 msgstr ""
3947
3948 #. type: textblock
3949 #: ../df/virt-df.pod:156
3950 msgid ""
3951 "If the kernel has a bug which stops it from accessing a filesystem in one "
3952 "guest (see for example RHBZ#635373) then this allows libguestfs to continue "
3953 "and report stats for further guests."
3954 msgstr ""
3955
3956 #. type: textblock
3957 #: ../df/virt-df.pod:165
3958 msgid ""
3959 "Print UUIDs instead of names.  This is useful for following a guest even "
3960 "when the guest is migrated or renamed, or when two guests happen to have the "
3961 "same name."
3962 msgstr ""
3963
3964 #. type: textblock
3965 #: ../df/virt-df.pod:169
3966 msgid ""
3967 "Note that only domains that we fetch from libvirt come with UUIDs.  For disk "
3968 "images, we still print the disk image name even when this option is "
3969 "specified."
3970 msgstr ""
3971
3972 #. type: textblock
3973 #: ../df/virt-df.pod:229
3974 msgid ""
3975 "L<df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<http://"
3976 "libguestfs.org/>."
3977 msgstr ""
3978
3979 #. type: textblock
3980 #: ../edit/virt-edit.pod:5
3981 msgid "virt-edit - Edit a file in a virtual machine"
3982 msgstr ""
3983
3984 #. type: verbatim
3985 #: ../edit/virt-edit.pod:9
3986 #, no-wrap
3987 msgid ""
3988 " virt-edit [--options] -d domname file [file ...]\n"
3989 "\n"
3990 msgstr ""
3991
3992 #. type: verbatim
3993 #: ../edit/virt-edit.pod:11
3994 #, no-wrap
3995 msgid ""
3996 " virt-edit [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
3997 "\n"
3998 msgstr ""
3999
4000 #. type: verbatim
4001 #: ../edit/virt-edit.pod:13
4002 #, no-wrap
4003 msgid ""
4004 " virt-edit [-d domname|-a disk.img] file -e 'expr'\n"
4005 "\n"
4006 msgstr ""
4007
4008 #. type: verbatim
4009 #: ../edit/virt-edit.pod:17
4010 #, no-wrap
4011 msgid ""
4012 " virt-edit domname file\n"
4013 "\n"
4014 msgstr ""
4015
4016 #. type: verbatim
4017 #: ../edit/virt-edit.pod:19 ../edit/virt-edit.pod:183
4018 #, no-wrap
4019 msgid ""
4020 " virt-edit disk.img [disk.img ...] file\n"
4021 "\n"
4022 msgstr ""
4023
4024 #. type: =head1
4025 #: ../edit/virt-edit.pod:21 ../fish/guestfish.pod:23
4026 #: ../fish/virt-copy-in.pod:13 ../fish/virt-tar-in.pod:15
4027 #: ../fuse/guestmount.pod:15 ../rescue/virt-rescue.pod:19
4028 #: ../tools/virt-tar.pl:64 ../tools/virt-win-reg.pl:51
4029 msgid "WARNING"
4030 msgstr ""
4031
4032 #. type: textblock
4033 #: ../edit/virt-edit.pod:23
4034 msgid ""
4035 "You must I<not> use C<virt-edit> on live virtual machines.  If you do this, "
4036 "you risk disk corruption in the VM.  C<virt-edit> tries to stop you from "
4037 "doing this, but doesn't catch all cases."
4038 msgstr ""
4039
4040 #. type: textblock
4041 #: ../edit/virt-edit.pod:29
4042 msgid ""
4043 "C<virt-edit> is a command line tool to edit C<file> where each C<file> "
4044 "exists in the named virtual machine (or disk image)."
4045 msgstr ""
4046
4047 #. type: textblock
4048 #: ../edit/virt-edit.pod:32
4049 msgid ""
4050 "Multiple filenames can be given, in which case they are each edited in "
4051 "turn.  Each filename must be a full path, starting at the root directory "
4052 "(starting with '/')."
4053 msgstr ""
4054
4055 #. type: textblock
4056 #: ../edit/virt-edit.pod:36
4057 msgid "If you want to just view a file, use L<virt-cat(1)>."
4058 msgstr ""
4059
4060 #. type: textblock
4061 #: ../edit/virt-edit.pod:38
4062 msgid ""
4063 "For more complex cases you should look at the L<guestfish(1)> tool (see L</"
4064 "USING GUESTFISH> below)."
4065 msgstr ""
4066
4067 #. type: textblock
4068 #: ../edit/virt-edit.pod:41
4069 msgid ""
4070 "C<virt-edit> cannot be used to create a new file.  L<guestfish(1)> can do "
4071 "that and much more."
4072 msgstr ""
4073
4074 #. type: textblock
4075 #: ../edit/virt-edit.pod:46
4076 msgid "Edit the named files interactively:"
4077 msgstr ""
4078
4079 #. type: verbatim
4080 #: ../edit/virt-edit.pod:48
4081 #, no-wrap
4082 msgid ""
4083 " virt-edit -d mydomain /boot/grub/grub.conf\n"
4084 "\n"
4085 msgstr ""
4086
4087 #. type: verbatim
4088 #: ../edit/virt-edit.pod:50
4089 #, no-wrap
4090 msgid ""
4091 " virt-edit -d mydomain /etc/passwd\n"
4092 "\n"
4093 msgstr ""
4094
4095 #. type: textblock
4096 #: ../edit/virt-edit.pod:52
4097 msgid "For Windows guests, some Windows paths are understood:"
4098 msgstr ""
4099
4100 #. type: verbatim
4101 #: ../edit/virt-edit.pod:54
4102 #, no-wrap
4103 msgid ""
4104 " virt-edit -d mywindomain 'c:\\autoexec.bat'\n"
4105 "\n"
4106 msgstr ""
4107
4108 #. type: textblock
4109 #: ../edit/virt-edit.pod:56
4110 msgid ""
4111 "If Perl is installed, you can also edit files non-interactively (see L</NON-"
4112 "INTERACTIVE EDITING> below).  To change the init default level to 5:"
4113 msgstr ""
4114
4115 #. type: verbatim
4116 #: ../edit/virt-edit.pod:60
4117 #, no-wrap
4118 msgid ""
4119 " virt-edit -d mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
4120 "\n"
4121 msgstr ""
4122
4123 #. type: =item
4124 #: ../edit/virt-edit.pod:81
4125 msgid "B<-b> extension"
4126 msgstr ""
4127
4128 #. type: =item
4129 #: ../edit/virt-edit.pod:83
4130 msgid "B<--backup> extension"
4131 msgstr ""
4132
4133 #. type: textblock
4134 #: ../edit/virt-edit.pod:85
4135 msgid ""
4136 "Create a backup of the original file I<in the guest disk image>.  The backup "
4137 "has the original filename with C<extension> added."
4138 msgstr ""
4139
4140 #. type: textblock
4141 #: ../edit/virt-edit.pod:88
4142 msgid ""
4143 "Usually the first character of C<extension> would be a dot C<.> so you would "
4144 "write:"
4145 msgstr ""
4146
4147 #. type: verbatim
4148 #: ../edit/virt-edit.pod:91
4149 #, no-wrap
4150 msgid ""
4151 " virt-edit -b .orig [etc]\n"
4152 "\n"
4153 msgstr ""
4154
4155 #. type: textblock
4156 #: ../edit/virt-edit.pod:93
4157 msgid "By default, no backup file is made."
4158 msgstr ""
4159
4160 #. type: =item
4161 #: ../edit/virt-edit.pod:95 ../fish/guestfish.pod:181
4162 #: ../fuse/guestmount.pod:105 ../inspector/virt-inspector.pod:74
4163 #: ../tools/virt-list-filesystems.pl:77 ../tools/virt-list-partitions.pl:78
4164 #: ../tools/virt-tar.pl:127 ../tools/virt-win-reg.pl:128
4165 msgid "B<-c URI>"
4166 msgstr ""
4167
4168 #. type: =item
4169 #: ../edit/virt-edit.pod:97 ../fish/guestfish.pod:183
4170 #: ../fuse/guestmount.pod:107 ../inspector/virt-inspector.pod:76
4171 #: ../tools/virt-list-filesystems.pl:79 ../tools/virt-list-partitions.pl:80
4172 #: ../tools/virt-tar.pl:129 ../tools/virt-win-reg.pl:130
4173 msgid "B<--connect URI>"
4174 msgstr ""
4175
4176 #. type: textblock
4177 #: ../edit/virt-edit.pod:102 ../tools/virt-list-filesystems.pl:84
4178 #: ../tools/virt-list-partitions.pl:85 ../tools/virt-tar.pl:134
4179 #: ../tools/virt-win-reg.pl:135
4180 msgid ""
4181 "If you specify guest block devices directly, then libvirt is not used at all."