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