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