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