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