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