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