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