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