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