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