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