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