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