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