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