1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Red Hat Inc.
3 # This file is distributed under the same license as the libguestfs package.
5 # Yuri Chornoivan <yurchor@ukr.net>, 2011.
8 "Project-Id-Version: libguestfs\n"
9 "Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
10 "POT-Creation-Date: 2011-10-05 18:11+0200\n"
11 "PO-Revision-Date: 2011-07-17 20:50+0000\n"
12 "Last-Translator: rjones <rjones@redhat.com>\n"
13 "Language-Team: Ukrainian <trans-uk@lists.fedoraproject.org>\n"
16 "Content-Type: text/plain; charset=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
18 "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n"
19 "%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2)\n"
22 #: ../align/virt-alignment-scan.pod:3 ../cat/virt-cat.pod:3
23 #: ../cat/virt-filesystems.pod:3 ../cat/virt-ls.pod:3 ../df/virt-df.pod:3
24 #: ../edit/virt-edit.pod:3 ../erlang/examples/guestfs-erlang.pod:3
25 #: ../examples/guestfs-examples.pod:3 ../examples/guestfs-recipes.pod:14
26 #: ../fish/guestfish.pod:3 ../fish/virt-copy-in.pod:3
27 #: ../fish/virt-copy-out.pod:3 ../fish/virt-tar-in.pod:3
28 #: ../fish/virt-tar-out.pod:3 ../fuse/guestmount.pod:3
29 #: ../inspector/virt-inspector.pod:3 ../java/examples/guestfs-java.pod:3
30 #: ../ocaml/examples/guestfs-ocaml.pod:3 ../perl/examples/guestfs-perl.pod:3
31 #: ../python/examples/guestfs-python.pod:3 ../rescue/virt-rescue.pod:3
32 #: ../resize/virt-resize.pod:3 ../ruby/examples/guestfs-ruby.pod:3
33 #: ../sparsify/virt-sparsify.pod:3 ../src/guestfs.pod:3
34 #: ../test-tool/libguestfs-test-tool.pod:3
35 #: ../tools/virt-list-filesystems.pl:30 ../tools/virt-list-partitions.pl:30
36 #: ../tools/virt-make-fs.pl:35 ../tools/virt-tar.pl:31
37 #: ../tools/virt-win-reg.pl:35
42 #: ../align/virt-alignment-scan.pod:5
43 msgid "virt-alignment-scan - Check alignment of virtual machine partitions"
47 #: ../align/virt-alignment-scan.pod:7 ../cat/virt-cat.pod:7
48 #: ../cat/virt-filesystems.pod:7 ../cat/virt-ls.pod:7 ../df/virt-df.pod:7
49 #: ../edit/virt-edit.pod:7 ../erlang/examples/guestfs-erlang.pod:7
50 #: ../examples/guestfs-examples.pod:7 ../fish/guestfish.pod:7
51 #: ../fish/virt-copy-in.pod:7 ../fish/virt-copy-out.pod:7
52 #: ../fish/virt-tar-in.pod:7 ../fish/virt-tar-out.pod:7
53 #: ../fuse/guestmount.pod:7 ../inspector/virt-inspector.pod:7
54 #: ../java/examples/guestfs-java.pod:7 ../ocaml/examples/guestfs-ocaml.pod:7
55 #: ../perl/examples/guestfs-perl.pod:7 ../python/examples/guestfs-python.pod:7
56 #: ../rescue/virt-rescue.pod:7 ../resize/virt-resize.pod:7
57 #: ../ruby/examples/guestfs-ruby.pod:7 ../sparsify/virt-sparsify.pod:7
58 #: ../src/guestfs.pod:7 ../test-tool/libguestfs-test-tool.pod:7
59 #: ../tools/virt-list-filesystems.pl:34 ../tools/virt-list-partitions.pl:34
60 #: ../tools/virt-make-fs.pl:39 ../tools/virt-tar.pl:35
61 #: ../tools/virt-win-reg.pl:39
63 msgstr "КОРОТКИЙ ОПИС"
66 #: ../align/virt-alignment-scan.pod:9
69 #| " virt-list-partitions [--options] domname\n"
72 " virt-alignment-scan [--options]\n"
75 " virt-list-partitions [--параметри] назва_домену\n"
79 #: ../align/virt-alignment-scan.pod:11
82 #| " virt-list-partitions [--options] domname\n"
85 " virt-alignment-scan [--options] -d domname\n"
88 " virt-list-partitions [--параметри] назва_домену\n"
92 #: ../align/virt-alignment-scan.pod:13
95 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
98 " virt-alignment-scan [--options] -a disk.img [-a disk.img ...]\n"
101 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
105 #: ../align/virt-alignment-scan.pod:15 ../cat/virt-cat.pod:19
106 #: ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19 ../df/virt-df.pod:21
107 #: ../edit/virt-edit.pod:27 ../erlang/examples/guestfs-erlang.pod:16
108 #: ../examples/guestfs-examples.pod:19 ../examples/guestfs-recipes.pod:18
109 #: ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19
110 #: ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21
111 #: ../fish/virt-tar-out.pod:15 ../fuse/guestmount.pod:20
112 #: ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15
113 #: ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:18
114 #: ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:29
115 #: ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15
116 #: ../sparsify/virt-sparsify.pod:11 ../src/guestfs.pod:23
117 #: ../test-tool/libguestfs-test-tool.pod:11
118 #: ../tools/virt-list-filesystems.pl:40 ../tools/virt-list-partitions.pl:40
119 #: ../tools/virt-make-fs.pl:47 ../tools/virt-tar.pl:77
120 #: ../tools/virt-win-reg.pl:63
125 #: ../align/virt-alignment-scan.pod:17
127 "When older operating systems install themselves, the partitioning tools "
128 "place partitions at a sector misaligned with the underlying storage "
129 "(commonly the first partition starts on sector C<63>). Misaligned "
130 "partitions can result in an operating system issuing more I/O than should be "
135 #: ../align/virt-alignment-scan.pod:23
137 "The virt-alignment-scan tool checks the alignment of partitions in virtual "
138 "machines and disk images and warns you if there are alignment problems."
142 #: ../align/virt-alignment-scan.pod:27
144 "Currently there is no virt tool for fixing alignment problems, except to "
145 "reinstall the operating system. The following NetApp document summarises "
146 "the problem and possible solutions: L<http://media.netapp.com/documents/"
151 #: ../align/virt-alignment-scan.pod:32
156 #: ../align/virt-alignment-scan.pod:34
157 msgid "To run this tool on a disk image directly, use the I<-a> option:"
161 #: ../align/virt-alignment-scan.pod:36
164 " $ virt-alignment-scan -a winxp.img\n"
165 " /dev/sda1 32256 512 bad (alignment < 4K)\n"
170 #: ../align/virt-alignment-scan.pod:39
173 " $ virt-alignment-scan -a fedora16.img\n"
174 " /dev/sda1 1048576 1024K ok\n"
175 " /dev/sda2 2097152 2048K ok\n"
176 " /dev/sda3 526385152 2048K ok\n"
181 #: ../align/virt-alignment-scan.pod:44
183 "To run the tool on a guest known to libvirt, use the I<-d> option and "
184 "possibly the I<-c> option:"
188 #: ../align/virt-alignment-scan.pod:47
191 " # virt-alignment-scan -d RHEL5\n"
192 " /dev/sda1 32256 512 bad (alignment < 4K)\n"
193 " /dev/sda2 106928640 512 bad (alignment < 4K)\n"
198 #: ../align/virt-alignment-scan.pod:51
201 " $ virt-alignment-scan -c qemu:///system -d Win7TwoDisks\n"
202 " /dev/sda1 1048576 1024K ok\n"
203 " /dev/sda2 105906176 1024K ok\n"
204 " /dev/sdb1 65536 64K ok\n"
209 #: ../align/virt-alignment-scan.pod:56
211 "The output consists of 4 or more whitespace-separated columns. Only the "
212 "first 4 columns are signficant if you want to parse this from a program. "
217 #: ../align/virt-alignment-scan.pod:62
222 #: ../align/virt-alignment-scan.pod:64
224 "the device and partition name (eg. C</dev/sda1> meaning the first partition "
225 "on the first block device)"
229 #: ../align/virt-alignment-scan.pod:67
234 #: ../align/virt-alignment-scan.pod:69
235 msgid "the start of the partition in bytes"
239 #: ../align/virt-alignment-scan.pod:71
244 #: ../align/virt-alignment-scan.pod:73
245 msgid "the alignment in bytes or Kbytes (eg. C<512> or C<4K>)"
249 #: ../align/virt-alignment-scan.pod:75
254 #: ../align/virt-alignment-scan.pod:77
256 "C<ok> if the alignment is best for performance, or C<bad> if the alignment "
257 "can cause performance problems"
261 #: ../align/virt-alignment-scan.pod:80
266 #: ../align/virt-alignment-scan.pod:82
267 msgid "optional free-text explanation."
271 #: ../align/virt-alignment-scan.pod:86
273 "The exit code from the program changes depending on whether poorly aligned "
274 "partitions were found. See L</EXIT STATUS> below."
278 #: ../align/virt-alignment-scan.pod:89
279 msgid "If you just want the exit code with no output, use the I<-q> option."
283 #: ../align/virt-alignment-scan.pod:91 ../cat/virt-cat.pod:62
284 #: ../cat/virt-filesystems.pod:91 ../cat/virt-ls.pod:261 ../df/virt-df.pod:59
285 #: ../edit/virt-edit.pod:62 ../fish/guestfish.pod:148
286 #: ../fish/virt-copy-in.pod:45 ../fish/virt-copy-out.pod:34
287 #: ../fish/virt-tar-in.pod:42 ../fish/virt-tar-out.pod:36
288 #: ../fuse/guestmount.pod:83 ../inspector/virt-inspector.pod:55
289 #: ../rescue/virt-rescue.pod:84 ../resize/virt-resize.pod:241
290 #: ../sparsify/virt-sparsify.pod:99 ../test-tool/libguestfs-test-tool.pod:36
291 #: ../tools/virt-list-filesystems.pl:53 ../tools/virt-list-partitions.pl:54
292 #: ../tools/virt-make-fs.pl:153 ../tools/virt-tar.pl:103
293 #: ../tools/virt-win-reg.pl:96
298 #: ../align/virt-alignment-scan.pod:95 ../cat/virt-cat.pod:66
299 #: ../cat/virt-filesystems.pod:95 ../cat/virt-ls.pod:265 ../df/virt-df.pod:63
300 #: ../edit/virt-edit.pod:66 ../fish/guestfish.pod:152
301 #: ../fuse/guestmount.pod:151 ../inspector/virt-inspector.pod:59
302 #: ../rescue/virt-rescue.pod:88 ../resize/virt-resize.pod:245
303 #: ../sparsify/virt-sparsify.pod:103 ../test-tool/libguestfs-test-tool.pod:40
304 #: ../tools/virt-list-filesystems.pl:61 ../tools/virt-list-partitions.pl:62
305 #: ../tools/virt-make-fs.pl:161 ../tools/virt-tar.pl:111
306 #: ../tools/virt-win-reg.pl:104
311 #: ../align/virt-alignment-scan.pod:97 ../cat/virt-cat.pod:68
312 #: ../cat/virt-filesystems.pod:97 ../cat/virt-ls.pod:267 ../df/virt-df.pod:65
313 #: ../edit/virt-edit.pod:68 ../inspector/virt-inspector.pod:61
314 #: ../rescue/virt-rescue.pod:90 ../tools/virt-list-filesystems.pl:63
315 #: ../tools/virt-list-partitions.pl:64 ../tools/virt-make-fs.pl:163
316 #: ../tools/virt-tar.pl:113 ../tools/virt-win-reg.pl:106
317 msgid "Display brief help."
321 #: ../align/virt-alignment-scan.pod:99 ../cat/virt-cat.pod:70
322 #: ../cat/virt-filesystems.pod:99 ../cat/virt-ls.pod:269 ../df/virt-df.pod:67
323 #: ../edit/virt-edit.pod:70 ../inspector/virt-inspector.pod:63
324 #: ../rescue/virt-rescue.pod:92
326 #| msgid "B<-f file>"
331 #: ../align/virt-alignment-scan.pod:101 ../cat/virt-cat.pod:72
332 #: ../cat/virt-filesystems.pod:101 ../cat/virt-ls.pod:271 ../df/virt-df.pod:69
333 #: ../edit/virt-edit.pod:72 ../inspector/virt-inspector.pod:65
334 #: ../rescue/virt-rescue.pod:94
336 #| msgid "B<--add image>"
337 msgid "B<--add> file"
338 msgstr "B<--add образ>"
341 #: ../align/virt-alignment-scan.pod:103
342 msgid "Add I<file> which should be a disk image from a virtual machine."
346 #: ../align/virt-alignment-scan.pod:105 ../cat/virt-cat.pod:78
347 #: ../cat/virt-filesystems.pod:107 ../cat/virt-ls.pod:277 ../df/virt-df.pod:75
348 #: ../edit/virt-edit.pod:78 ../fish/guestfish.pod:174
349 #: ../fuse/guestmount.pod:93 ../inspector/virt-inspector.pod:71
350 #: ../rescue/virt-rescue.pod:100
352 "The format of the disk image is auto-detected. To override this and force a "
353 "particular format use the I<--format=..> option."
357 #: ../align/virt-alignment-scan.pod:108 ../cat/virt-cat.pod:81
358 #: ../cat/virt-filesystems.pod:125 ../cat/virt-ls.pod:291 ../df/virt-df.pod:78
359 #: ../rescue/virt-rescue.pod:107
363 msgstr "B<-c адреса>"
366 #: ../align/virt-alignment-scan.pod:110 ../cat/virt-cat.pod:83
367 #: ../cat/virt-filesystems.pod:127 ../cat/virt-ls.pod:293 ../df/virt-df.pod:80
368 #: ../rescue/virt-rescue.pod:109
370 #| msgid "B<--connect URI>"
371 msgid "B<--connect> URI"
372 msgstr "B<--connect адреса>"
375 #: ../align/virt-alignment-scan.pod:112 ../cat/virt-cat.pod:85
376 #: ../cat/virt-filesystems.pod:129 ../cat/virt-ls.pod:295 ../df/virt-df.pod:82
377 #: ../edit/virt-edit.pod:99 ../inspector/virt-inspector.pod:78
378 #: ../rescue/virt-rescue.pod:111 ../tools/virt-list-filesystems.pl:81
379 #: ../tools/virt-list-partitions.pl:82 ../tools/virt-tar.pl:131
380 #: ../tools/virt-win-reg.pl:132
382 "If using libvirt, connect to the given I<URI>. If omitted, then we connect "
383 "to the default libvirt hypervisor."
387 #: ../align/virt-alignment-scan.pod:115 ../cat/virt-cat.pod:88
388 #: ../cat/virt-filesystems.pod:132 ../cat/virt-ls.pod:298 ../df/virt-df.pod:85
389 #: ../rescue/virt-rescue.pod:114
391 "If you specify guest block devices directly (I<-a>), then libvirt is not "
396 #: ../align/virt-alignment-scan.pod:118 ../cat/virt-cat.pod:91
397 #: ../cat/virt-filesystems.pod:141 ../cat/virt-ls.pod:307 ../df/virt-df.pod:94
398 #: ../edit/virt-edit.pod:105 ../inspector/virt-inspector.pod:85
399 #: ../rescue/virt-rescue.pod:117
404 #: ../align/virt-alignment-scan.pod:120 ../cat/virt-cat.pod:93
405 #: ../cat/virt-filesystems.pod:143 ../cat/virt-ls.pod:309 ../df/virt-df.pod:96
406 #: ../edit/virt-edit.pod:107 ../inspector/virt-inspector.pod:87
407 #: ../rescue/virt-rescue.pod:119
408 msgid "B<--domain> guest"
412 #: ../align/virt-alignment-scan.pod:122 ../cat/virt-cat.pod:95
413 #: ../cat/virt-filesystems.pod:145 ../cat/virt-ls.pod:311 ../df/virt-df.pod:98
414 #: ../edit/virt-edit.pod:109 ../inspector/virt-inspector.pod:89
415 #: ../rescue/virt-rescue.pod:121
417 "Add all the disks from the named libvirt guest. Domain UUIDs can be used "
422 #: ../align/virt-alignment-scan.pod:125 ../cat/virt-cat.pod:105
423 #: ../cat/virt-filesystems.pod:170 ../cat/virt-ls.pod:328
424 #: ../df/virt-df.pod:101 ../fish/guestfish.pod:233 ../fuse/guestmount.pod:133
425 #: ../inspector/virt-inspector.pod:99 ../rescue/virt-rescue.pod:124
426 msgid "B<--format=raw|qcow2|..>"
427 msgstr "B<--format=raw|qcow2|..>"
430 #: ../align/virt-alignment-scan.pod:127 ../cat/virt-cat.pod:107
431 #: ../cat/virt-filesystems.pod:172 ../cat/virt-ls.pod:330
432 #: ../df/virt-df.pod:103 ../edit/virt-edit.pod:134 ../fish/guestfish.pod:235
433 #: ../fuse/guestmount.pod:135 ../inspector/virt-inspector.pod:101
434 #: ../rescue/virt-rescue.pod:126
439 #: ../align/virt-alignment-scan.pod:129 ../cat/virt-cat.pod:109
440 #: ../cat/virt-filesystems.pod:174 ../cat/virt-ls.pod:332
441 #: ../df/virt-df.pod:105 ../edit/virt-edit.pod:136 ../fish/guestfish.pod:237
442 #: ../fuse/guestmount.pod:137 ../rescue/virt-rescue.pod:128
444 "The default for the I<-a> option is to auto-detect the format of the disk "
445 "image. Using this forces the disk format for I<-a> options which follow on "
446 "the command line. Using I<--format> with no argument switches back to auto-"
447 "detection for subsequent I<-a> options."
451 #: ../align/virt-alignment-scan.pod:134 ../cat/virt-cat.pod:114
452 #: ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337
453 #: ../df/virt-df.pod:110 ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242
454 #: ../fish/guestfish.pod:673 ../inspector/virt-inspector.pod:336
455 #: ../rescue/virt-rescue.pod:133 ../src/guestfs.pod:2791
460 #: ../align/virt-alignment-scan.pod:136
463 #| " guestfish --format=raw -a disk.img\n"
466 " virt-alignment-scan --format=raw -a disk.img\n"
469 " guestfish --format=raw -a disk.img\n"
473 #: ../align/virt-alignment-scan.pod:138 ../cat/virt-cat.pod:118
474 #: ../cat/virt-filesystems.pod:183 ../cat/virt-ls.pod:341
475 #: ../df/virt-df.pod:114 ../edit/virt-edit.pod:145 ../fish/guestfish.pod:246
476 #: ../rescue/virt-rescue.pod:137
477 msgid "forces raw format (no auto-detection) for C<disk.img>."
481 #: ../align/virt-alignment-scan.pod:140
484 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
487 " virt-alignment-scan --format=raw -a disk.img --format -a another.img\n"
490 " guestfish --format=raw -a disk.img --format -a another.img\n"
494 #: ../align/virt-alignment-scan.pod:142 ../cat/virt-cat.pod:122
495 #: ../cat/virt-filesystems.pod:187 ../cat/virt-ls.pod:345
496 #: ../df/virt-df.pod:118 ../edit/virt-edit.pod:149 ../fish/guestfish.pod:250
497 #: ../rescue/virt-rescue.pod:141
499 "forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
500 "detection for C<another.img>."
504 #: ../align/virt-alignment-scan.pod:145 ../cat/virt-cat.pod:125
505 #: ../cat/virt-filesystems.pod:190 ../cat/virt-ls.pod:348
506 #: ../df/virt-df.pod:121 ../edit/virt-edit.pod:152
507 #: ../rescue/virt-rescue.pod:144
509 "If you have untrusted raw-format guest disk images, you should use this "
510 "option to specify the disk format. This avoids a possible security problem "
511 "with malicious guests (CVE-2010-3851)."
515 #: ../align/virt-alignment-scan.pod:149 ../resize/virt-resize.pod:414
516 #: ../sparsify/virt-sparsify.pod:153
521 #: ../align/virt-alignment-scan.pod:151 ../resize/virt-resize.pod:416
522 #: ../sparsify/virt-sparsify.pod:155
529 #: ../align/virt-alignment-scan.pod:153
531 "Don't produce any output. Just set the exit code (see L</EXIT STATUS> "
536 #: ../align/virt-alignment-scan.pod:156 ../cat/virt-cat.pod:134
537 #: ../cat/virt-filesystems.pod:261 ../cat/virt-ls.pod:425
538 #: ../df/virt-df.pod:173 ../edit/virt-edit.pod:161 ../fish/guestfish.pod:390
539 #: ../fuse/guestmount.pod:257 ../inspector/virt-inspector.pod:119
540 #: ../rescue/virt-rescue.pod:182 ../sparsify/virt-sparsify.pod:159
545 #: ../align/virt-alignment-scan.pod:158 ../cat/virt-cat.pod:136
546 #: ../cat/virt-filesystems.pod:263 ../cat/virt-ls.pod:427
547 #: ../df/virt-df.pod:175 ../edit/virt-edit.pod:163 ../fish/guestfish.pod:392
548 #: ../fuse/guestmount.pod:259 ../inspector/virt-inspector.pod:121
549 #: ../rescue/virt-rescue.pod:184 ../sparsify/virt-sparsify.pod:161
551 msgstr "B<--verbose>"
554 #: ../align/virt-alignment-scan.pod:160 ../cat/virt-cat.pod:138
555 #: ../cat/virt-filesystems.pod:265 ../cat/virt-ls.pod:429
556 #: ../df/virt-df.pod:177 ../edit/virt-edit.pod:165
557 #: ../inspector/virt-inspector.pod:123 ../rescue/virt-rescue.pod:186
558 #: ../sparsify/virt-sparsify.pod:163
559 msgid "Enable verbose messages for debugging."
563 #: ../align/virt-alignment-scan.pod:162 ../cat/virt-cat.pod:140
564 #: ../cat/virt-filesystems.pod:267 ../cat/virt-ls.pod:431
565 #: ../df/virt-df.pod:179 ../edit/virt-edit.pod:167 ../fish/guestfish.pod:397
566 #: ../fuse/guestmount.pod:263 ../inspector/virt-inspector.pod:125
567 #: ../rescue/virt-rescue.pod:188 ../resize/virt-resize.pod:484
568 #: ../sparsify/virt-sparsify.pod:165
573 #: ../align/virt-alignment-scan.pod:164 ../cat/virt-cat.pod:142
574 #: ../cat/virt-filesystems.pod:269 ../cat/virt-ls.pod:433
575 #: ../df/virt-df.pod:181 ../edit/virt-edit.pod:169 ../fish/guestfish.pod:399
576 #: ../fuse/guestmount.pod:265 ../inspector/virt-inspector.pod:127
577 #: ../rescue/virt-rescue.pod:190 ../resize/virt-resize.pod:486
578 #: ../sparsify/virt-sparsify.pod:167 ../tools/virt-list-filesystems.pl:69
579 #: ../tools/virt-list-partitions.pl:70 ../tools/virt-make-fs.pl:169
580 #: ../tools/virt-tar.pl:119 ../tools/virt-win-reg.pl:112
582 msgstr "B<--version>"
585 #: ../align/virt-alignment-scan.pod:166 ../cat/virt-cat.pod:144
586 #: ../cat/virt-filesystems.pod:271 ../cat/virt-ls.pod:435
587 #: ../df/virt-df.pod:183 ../edit/virt-edit.pod:171
588 #: ../inspector/virt-inspector.pod:129 ../rescue/virt-rescue.pod:192
589 #: ../resize/virt-resize.pod:488 ../sparsify/virt-sparsify.pod:169
590 #: ../tools/virt-list-filesystems.pl:71 ../tools/virt-list-partitions.pl:72
591 #: ../tools/virt-make-fs.pl:171 ../tools/virt-tar.pl:121
592 #: ../tools/virt-win-reg.pl:114
593 msgid "Display version number and exit."
594 msgstr "Показати дані щодо версії і завершити роботу."
597 #: ../align/virt-alignment-scan.pod:168 ../cat/virt-cat.pod:146
598 #: ../cat/virt-filesystems.pod:281 ../cat/virt-ls.pod:437
599 #: ../df/virt-df.pod:185 ../edit/virt-edit.pod:173 ../fish/guestfish.pod:412
600 #: ../fuse/guestmount.pod:278 ../inspector/virt-inspector.pod:131
601 #: ../rescue/virt-rescue.pod:203 ../sparsify/virt-sparsify.pod:171
602 #: ../tools/virt-tar.pl:158
607 #: ../align/virt-alignment-scan.pod:170 ../cat/virt-cat.pod:148
608 #: ../cat/virt-filesystems.pod:283 ../cat/virt-ls.pod:439
609 #: ../df/virt-df.pod:187 ../edit/virt-edit.pod:175
610 #: ../inspector/virt-inspector.pod:133 ../rescue/virt-rescue.pod:205
611 #: ../sparsify/virt-sparsify.pod:173
612 msgid "Enable tracing of libguestfs API calls."
616 #: ../align/virt-alignment-scan.pod:174 ../cat/virt-cat.pod:191
617 #: ../cat/virt-filesystems.pod:365 ../cat/virt-ls.pod:483
618 #: ../df/virt-df.pod:215 ../edit/virt-edit.pod:342
619 #: ../inspector/virt-inspector.pod:352 ../rescue/virt-rescue.pod:266
620 #: ../resize/virt-resize.pod:601 ../tools/virt-list-filesystems.pl:188
621 #: ../tools/virt-list-partitions.pl:258 ../tools/virt-make-fs.pl:532
622 #: ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:733
623 msgid "SHELL QUOTING"
627 #: ../align/virt-alignment-scan.pod:176 ../cat/virt-cat.pod:193
628 #: ../cat/virt-filesystems.pod:367 ../cat/virt-ls.pod:485
629 #: ../df/virt-df.pod:217 ../edit/virt-edit.pod:344
630 #: ../inspector/virt-inspector.pod:354 ../rescue/virt-rescue.pod:268
631 #: ../resize/virt-resize.pod:603 ../tools/virt-list-filesystems.pl:190
632 #: ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:534
633 #: ../tools/virt-tar.pl:291 ../tools/virt-win-reg.pl:741
635 "Libvirt guest names can contain arbitrary characters, some of which have "
636 "meaning to the shell such as C<#> and space. You may need to quote or "
637 "escape these characters on the command line. See the shell manual page L<sh"
642 #: ../align/virt-alignment-scan.pod:181 ../cat/virt-cat.pod:198
643 #: ../cat/virt-filesystems.pod:372 ../cat/virt-ls.pod:490
644 #: ../df/virt-df.pod:222 ../edit/virt-edit.pod:349 ../fish/guestfish.pod:1081
645 #: ../fuse/guestmount.pod:303 ../inspector/virt-inspector.pod:375
646 #: ../resize/virt-resize.pod:608 ../sparsify/virt-sparsify.pod:227
647 #: ../test-tool/libguestfs-test-tool.pod:90
652 #: ../align/virt-alignment-scan.pod:183
653 msgid "This program returns:"
657 #: ../align/virt-alignment-scan.pod:187
662 #: ../align/virt-alignment-scan.pod:189
664 "successful exit, all partitions are aligned E<ge> 64K for best performance"
668 #: ../align/virt-alignment-scan.pod:191
673 #: ../align/virt-alignment-scan.pod:193
674 msgid "an error scanning the disk image or guest"
678 #: ../align/virt-alignment-scan.pod:195
683 #: ../align/virt-alignment-scan.pod:197
685 "successful exit, some partitions have alignment E<lt> 64K which can result "
686 "in poor performance on high end network storage"
690 #: ../align/virt-alignment-scan.pod:200
695 #: ../align/virt-alignment-scan.pod:202
697 "successful exit, some partitions have alignment E<lt> 4K which can result in "
698 "poor performance on most hypervisors"
702 #: ../align/virt-alignment-scan.pod:207 ../cat/virt-cat.pod:203
703 #: ../cat/virt-filesystems.pod:377 ../cat/virt-ls.pod:495
704 #: ../df/virt-df.pod:227 ../edit/virt-edit.pod:354
705 #: ../erlang/examples/guestfs-erlang.pod:97
706 #: ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384
707 #: ../fish/guestfish.pod:1235 ../fish/virt-copy-in.pod:50
708 #: ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47
709 #: ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:308
710 #: ../inspector/virt-inspector.pod:380 ../java/examples/guestfs-java.pod:45
711 #: ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39
712 #: ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:288
713 #: ../resize/virt-resize.pod:613 ../ruby/examples/guestfs-ruby.pod:36
714 #: ../sparsify/virt-sparsify.pod:251 ../src/guestfs.pod:3179
715 #: ../test-tool/libguestfs-test-tool.pod:100
716 #: ../tools/virt-list-filesystems.pl:195 ../tools/virt-list-partitions.pl:265
717 #: ../tools/virt-make-fs.pl:539 ../tools/virt-tar.pl:296
718 #: ../tools/virt-win-reg.pl:746
720 msgstr "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
723 #: ../align/virt-alignment-scan.pod:209
726 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
727 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
728 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
730 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<http://libguestfs."
733 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
734 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
735 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
738 #: ../align/virt-alignment-scan.pod:214 ../cat/virt-cat.pod:212
739 #: ../cat/virt-filesystems.pod:388 ../cat/virt-ls.pod:507
740 #: ../df/virt-df.pod:235 ../edit/virt-edit.pod:368
741 #: ../rescue/virt-rescue.pod:296 ../resize/virt-resize.pod:635
742 #: ../sparsify/virt-sparsify.pod:264 ../tools/virt-list-filesystems.pl:208
743 #: ../tools/virt-list-partitions.pl:277 ../tools/virt-make-fs.pl:564
744 #: ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:772
749 #: ../align/virt-alignment-scan.pod:216 ../cat/virt-cat.pod:214
750 #: ../cat/virt-filesystems.pod:390 ../cat/virt-ls.pod:509
751 #: ../df/virt-df.pod:237 ../edit/virt-edit.pod:370
752 #: ../inspector/virt-inspector.pod:395 ../rescue/virt-rescue.pod:298
753 #: ../resize/virt-resize.pod:637 ../sparsify/virt-sparsify.pod:266
754 #: ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279
755 #: ../tools/virt-make-fs.pl:566 ../tools/virt-tar.pl:313
756 #: ../tools/virt-win-reg.pl:774
757 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
758 msgstr "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
761 #: ../align/virt-alignment-scan.pod:218 ../cat/virt-cat.pod:216
762 #: ../cat/virt-filesystems.pod:392 ../cat/virt-ls.pod:511
763 #: ../df/virt-df.pod:239 ../edit/virt-edit.pod:372
764 #: ../erlang/examples/guestfs-erlang.pod:114
765 #: ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401
766 #: ../fish/guestfish.pod:1266 ../fish/virt-copy-in.pod:64
767 #: ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62
768 #: ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:323
769 #: ../inspector/virt-inspector.pod:403 ../java/examples/guestfs-java.pod:62
770 #: ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56
771 #: ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:300
772 #: ../resize/virt-resize.pod:639 ../ruby/examples/guestfs-ruby.pod:52
773 #: ../sparsify/virt-sparsify.pod:268 ../src/guestfs.pod:3259
774 #: ../test-tool/libguestfs-test-tool.pod:110
775 #: ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281
776 #: ../tools/virt-make-fs.pl:568 ../tools/virt-tar.pl:315
777 #: ../tools/virt-win-reg.pl:776
779 msgstr "АВТОРСЬКІ ПРАВА"
782 #: ../align/virt-alignment-scan.pod:220 ../sparsify/virt-sparsify.pod:270
784 #| msgid "Copyright (C) 2009 Red Hat Inc."
785 msgid "Copyright (C) 2011 Red Hat Inc."
786 msgstr "© Red Hat Inc., 2009"
789 #: ../align/virt-alignment-scan.pod:222 ../cat/virt-cat.pod:220
790 #: ../cat/virt-filesystems.pod:396 ../cat/virt-ls.pod:515
791 #: ../df/virt-df.pod:243 ../edit/virt-edit.pod:376 ../fish/guestfish.pod:1271
792 #: ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58
793 #: ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60
794 #: ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:407
795 #: ../rescue/virt-rescue.pod:304 ../resize/virt-resize.pod:643
796 #: ../sparsify/virt-sparsify.pod:272 ../test-tool/libguestfs-test-tool.pod:115
797 #: ../tools/virt-list-filesystems.pl:216 ../tools/virt-list-partitions.pl:285
798 #: ../tools/virt-make-fs.pl:572 ../tools/virt-tar.pl:319
799 #: ../tools/virt-win-reg.pl:780
801 "This program is free software; you can redistribute it and/or modify it "
802 "under the terms of the GNU General Public License as published by the Free "
803 "Software Foundation; either version 2 of the License, or (at your option) "
808 #: ../align/virt-alignment-scan.pod:227 ../cat/virt-cat.pod:225
809 #: ../cat/virt-filesystems.pod:401 ../cat/virt-ls.pod:520
810 #: ../df/virt-df.pod:248 ../edit/virt-edit.pod:381 ../fish/guestfish.pod:1276
811 #: ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63
812 #: ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65
813 #: ../fuse/guestmount.pod:333 ../inspector/virt-inspector.pod:412
814 #: ../rescue/virt-rescue.pod:309 ../resize/virt-resize.pod:648
815 #: ../sparsify/virt-sparsify.pod:277 ../test-tool/libguestfs-test-tool.pod:120
816 #: ../tools/virt-list-filesystems.pl:221 ../tools/virt-list-partitions.pl:290
817 #: ../tools/virt-make-fs.pl:577 ../tools/virt-tar.pl:324
818 #: ../tools/virt-win-reg.pl:785
820 "This program is distributed in the hope that it will be useful, but WITHOUT "
821 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
822 "FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for "
825 "Ця програма поширюється у сподіванні, що вона буде корисною, але БЕЗ БУДЬ-"
826 "ЯКИХ ГАРАНТІЙНИХ ЗОБОВ’ЯЗАНЬ; навіть без очевидної гарантії ПРАЦЕЗДАТНОСТІ "
827 "або ПРИДАТНОСТІ ДЛЯ ВИКОРИСТАННЯ З ПЕВНОЮ МЕТОЮ. Докладніше про це можна "
828 "дізнатися з GNU General Public License."
831 #: ../align/virt-alignment-scan.pod:232 ../cat/virt-cat.pod:230
832 #: ../cat/virt-filesystems.pod:406 ../cat/virt-ls.pod:525
833 #: ../df/virt-df.pod:253 ../edit/virt-edit.pod:386 ../fish/guestfish.pod:1281
834 #: ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68
835 #: ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70
836 #: ../fuse/guestmount.pod:338 ../inspector/virt-inspector.pod:417
837 #: ../rescue/virt-rescue.pod:314 ../resize/virt-resize.pod:653
838 #: ../sparsify/virt-sparsify.pod:282 ../test-tool/libguestfs-test-tool.pod:125
839 #: ../tools/virt-list-filesystems.pl:226 ../tools/virt-list-partitions.pl:295
840 #: ../tools/virt-make-fs.pl:582 ../tools/virt-tar.pl:329
841 #: ../tools/virt-win-reg.pl:790
843 "You should have received a copy of the GNU General Public License along with "
844 "this program; if not, write to the Free Software Foundation, Inc., 675 Mass "
845 "Ave, Cambridge, MA 02139, USA."
849 #: ../cat/virt-cat.pod:5
850 msgid "virt-cat - Display files in a virtual machine"
854 #: ../cat/virt-cat.pod:9
857 #| " virt-list-partitions [--options] domname\n"
860 " virt-cat [--options] -d domname file [file ...]\n"
863 " virt-list-partitions [--параметри] назва_домену\n"
867 #: ../cat/virt-cat.pod:11
870 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
873 " virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
876 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
880 #: ../cat/virt-cat.pod:13 ../edit/virt-edit.pod:15
881 #: ../inspector/virt-inspector.pod:13
886 #: ../cat/virt-cat.pod:15
889 " virt-cat domname file\n"
894 #: ../cat/virt-cat.pod:17
897 " virt-cat disk.img file\n"
902 #: ../cat/virt-cat.pod:21
904 "C<virt-cat> is a command line tool to display the contents of C<file> where "
905 "C<file> exists in the named virtual machine (or disk image)."
909 #: ../cat/virt-cat.pod:24
911 "Multiple filenames can be given, in which case they are concatenated "
912 "together. Each filename must be a full path, starting at the root directory "
913 "(starting with '/')."
917 #: ../cat/virt-cat.pod:28
919 "C<virt-cat> can be used to quickly view a file. To edit a file, use C<virt-"
920 "edit>. For more complex cases you should look at the L<guestfish(1)> tool "
921 "(see L</USING GUESTFISH> below)."
925 #: ../cat/virt-cat.pod:32 ../cat/virt-ls.pod:35 ../df/virt-df.pod:43
926 #: ../edit/virt-edit.pod:44 ../fish/guestfish.pod:41
927 #: ../fish/guestfish.pod:1018 ../fish/virt-copy-in.pod:29
928 #: ../fish/virt-copy-out.pod:21 ../fish/virt-tar-in.pod:30
929 #: ../fish/virt-tar-out.pod:24 ../fuse/guestmount.pod:39
930 #: ../resize/virt-resize.pod:27 ../sparsify/virt-sparsify.pod:75
931 #: ../tools/virt-tar.pl:50
936 #: ../cat/virt-cat.pod:34
938 "Display C</etc/fstab> file from inside the libvirt VM called C<mydomain>:"
942 #: ../cat/virt-cat.pod:37
945 " virt-cat -d mydomain /etc/fstab\n"
950 #: ../cat/virt-cat.pod:39
951 msgid "List syslog messages from a VM disk image file:"
955 #: ../cat/virt-cat.pod:41
958 " virt-cat -a disk.img /var/log/messages | tail\n"
963 #: ../cat/virt-cat.pod:43
964 msgid "Find out what DHCP IP address a VM acquired:"
968 #: ../cat/virt-cat.pod:45
971 " virt-cat -d mydomain /var/log/messages | \\\n"
972 " grep 'dhclient: bound to' | tail\n"
977 #: ../cat/virt-cat.pod:48
978 msgid "Find out what packages were recently installed:"
982 #: ../cat/virt-cat.pod:50
985 " virt-cat -d mydomain /var/log/yum.log | tail\n"
990 #: ../cat/virt-cat.pod:52
991 msgid "Find out who is logged on inside a virtual machine:"
995 #: ../cat/virt-cat.pod:54
998 " virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n"
1004 #: ../cat/virt-cat.pod:57
1005 msgid "or who was logged on:"
1009 #: ../cat/virt-cat.pod:59
1012 " virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n"
1013 " last -f /tmp/wtmp\n"
1018 #: ../cat/virt-cat.pod:74 ../cat/virt-filesystems.pod:103
1019 #: ../cat/virt-ls.pod:273 ../df/virt-df.pod:71 ../edit/virt-edit.pod:74
1020 #: ../inspector/virt-inspector.pod:67 ../rescue/virt-rescue.pod:96
1022 "Add I<file> which should be a disk image from a virtual machine. If the "
1023 "virtual machine has multiple block devices, you must supply all of them with "
1024 "separate I<-a> options."
1028 #: ../cat/virt-cat.pod:98 ../cat/virt-filesystems.pod:148
1029 #: ../cat/virt-ls.pod:314 ../edit/virt-edit.pod:112 ../fish/guestfish.pod:217
1030 #: ../fuse/guestmount.pod:126 ../inspector/virt-inspector.pod:92
1031 msgid "B<--echo-keys>"
1032 msgstr "B<--echo-keys>"
1035 #: ../cat/virt-cat.pod:100
1037 "When prompting for keys and passphrases, virt-cat normally turns echoing off "
1038 "so you cannot see what you are typing. If you are not worried about Tempest "
1039 "attacks and there is no one else in the room you can specify this flag to "
1040 "see what you are typing."
1044 #: ../cat/virt-cat.pod:116
1047 #| " guestfish --format=raw -a disk.img\n"
1050 " virt-cat --format=raw -a disk.img file\n"
1053 " guestfish --format=raw -a disk.img\n"
1057 #: ../cat/virt-cat.pod:120
1060 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
1063 " virt-cat --format=raw -a disk.img --format -a another.img file\n"
1066 " guestfish --format=raw -a disk.img --format -a another.img\n"
1070 #: ../cat/virt-cat.pod:129 ../cat/virt-filesystems.pod:200
1071 #: ../cat/virt-ls.pod:361 ../edit/virt-edit.pod:156 ../fish/guestfish.pod:289
1072 #: ../fuse/guestmount.pod:163 ../inspector/virt-inspector.pod:114
1073 msgid "B<--keys-from-stdin>"
1074 msgstr "B<--keys-from-stdin>"
1077 #: ../cat/virt-cat.pod:131 ../cat/virt-filesystems.pod:202
1078 #: ../cat/virt-ls.pod:363 ../edit/virt-edit.pod:158 ../fish/guestfish.pod:291
1079 #: ../fuse/guestmount.pod:165 ../inspector/virt-inspector.pod:116
1081 "Read key or passphrase parameters from stdin. The default is to try to read "
1082 "passphrases from the user by opening C</dev/tty>."
1086 #: ../cat/virt-cat.pod:152 ../cat/virt-ls.pod:443 ../edit/virt-edit.pod:179
1087 #: ../inspector/virt-inspector.pod:137 ../rescue/virt-rescue.pod:209
1088 msgid "OLD-STYLE COMMAND LINE ARGUMENTS"
1092 #: ../cat/virt-cat.pod:154
1093 msgid "Previous versions of virt-cat allowed you to write either:"
1097 #: ../cat/virt-cat.pod:156
1100 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
1103 " virt-cat disk.img [disk.img ...] file\n"
1106 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
1110 #: ../cat/virt-cat.pod:158 ../cat/virt-ls.pod:449 ../edit/virt-edit.pod:185
1111 #: ../inspector/virt-inspector.pod:143 ../rescue/virt-rescue.pod:215
1118 #: ../cat/virt-cat.pod:160
1121 " virt-cat guestname file\n"
1126 #: ../cat/virt-cat.pod:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189
1127 #: ../inspector/virt-inspector.pod:147 ../rescue/virt-rescue.pod:219
1129 "whereas in this version you should use I<-a> or I<-d> respectively to avoid "
1130 "the confusing case where a disk image might have the same name as a guest."
1134 #: ../cat/virt-cat.pod:166 ../cat/virt-ls.pod:457 ../edit/virt-edit.pod:193
1135 #: ../inspector/virt-inspector.pod:151 ../rescue/virt-rescue.pod:223
1136 msgid "For compatibility the old style is still supported."
1140 #: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:297
1141 msgid "USING GUESTFISH"
1145 #: ../cat/virt-cat.pod:170
1147 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
1148 "C<virt-cat> doesn't work."
1152 #: ../cat/virt-cat.pod:173
1153 msgid "Using C<virt-cat> is approximately equivalent to doing:"
1157 #: ../cat/virt-cat.pod:175
1160 #| " guestfish --ro -d myguest -i\n"
1163 " guestfish --ro -i -d domname download file -\n"
1166 " guestfish --ro -d myguest -i\n"
1170 #: ../cat/virt-cat.pod:177
1172 "where C<domname> is the name of the libvirt guest, and C<file> is the full "
1173 "path to the file. Note the final C<-> (meaning \"output to stdout\")."
1177 #: ../cat/virt-cat.pod:181
1179 "The command above uses libguestfs's guest inspection feature and so does not "
1180 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
1181 "disk images that don't contain guests. To display a file from a disk image "
1186 #: ../cat/virt-cat.pod:186
1189 #| " guestfish [--ro] -i disk.img\n"
1192 " guestfish --ro -a disk.img -m /dev/sda1 download file -\n"
1195 " guestfish [--ro] -i disk.img\n"
1199 #: ../cat/virt-cat.pod:188
1201 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
1202 "the disk image, and C<file> is the full path to the file."
1206 #: ../cat/virt-cat.pod:200 ../cat/virt-filesystems.pod:374
1207 #: ../cat/virt-ls.pod:492 ../df/virt-df.pod:224 ../edit/virt-edit.pod:351
1208 #: ../fuse/guestmount.pod:305 ../inspector/virt-inspector.pod:377
1209 #: ../resize/virt-resize.pod:610 ../sparsify/virt-sparsify.pod:229
1211 "This program returns 0 if successful, or non-zero if there was an error."
1215 #: ../cat/virt-cat.pod:205
1218 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
1219 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
1220 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
1222 "L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, L<virt-"
1223 "tar-out(1)>, L<http://libguestfs.org/>."
1225 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
1226 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
1227 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
1230 #: ../cat/virt-cat.pod:218 ../inspector/virt-inspector.pod:405
1231 #: ../resize/virt-resize.pod:641
1233 #| msgid "Copyright (C) 2009-2010 Red Hat Inc."
1234 msgid "Copyright (C) 2010-2011 Red Hat Inc."
1235 msgstr "© Red Hat Inc., 2009–2010"
1238 #: ../cat/virt-filesystems.pod:5
1240 "virt-filesystems - List filesystems, partitions, block devices, LVM in a "
1241 "virtual machine or disk image"
1245 #: ../cat/virt-filesystems.pod:9
1248 #| " virt-list-partitions [--options] domname\n"
1251 " virt-filesystems [--options] -d domname\n"
1254 " virt-list-partitions [--параметри] назва_домену\n"
1258 #: ../cat/virt-filesystems.pod:11
1261 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
1264 " virt-filesystems [--options] -a disk.img [-a disk.img ...]\n"
1267 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
1271 #: ../cat/virt-filesystems.pod:15
1273 "This tool allows you to discover filesystems, partitions, logical volumes, "
1274 "and their sizes in a disk image or virtual machine. It is a replacement for "
1275 "L<virt-list-filesystems(1)> and L<virt-list-partitions(1)>."
1279 #: ../cat/virt-filesystems.pod:20
1281 "One use for this tool is from shell scripts to iterate over all filesystems "
1282 "from a disk image:"
1286 #: ../cat/virt-filesystems.pod:23
1289 " for fs in $(virt-filesystems -a disk.img); do\n"
1296 #: ../cat/virt-filesystems.pod:27
1298 "Another use is to list partitions before using another tool to modify those "
1299 "partitions (such as L<virt-resize(1)>). If you are curious about what an "
1300 "unknown disk image contains, use this tool along with L<virt-inspector(1)>."
1304 #: ../cat/virt-filesystems.pod:32
1306 "Various command line options control what this program displays. You need "
1307 "to give either I<-a> or I<-d> options to specify the disk image or libvirt "
1308 "guest respectively. If you just specify that then the program shows "
1309 "filesystems found, one per line, like this:"
1313 #: ../cat/virt-filesystems.pod:37
1316 " $ virt-filesystems -a disk.img\n"
1318 " /dev/vg_guest/lv_root\n"
1323 #: ../cat/virt-filesystems.pod:41
1325 "If you add I<-l> or I<--long> then the output includes extra information:"
1329 #: ../cat/virt-filesystems.pod:44
1332 " $ virt-filesystems -a disk.img -l\n"
1333 " Name Type VFS Label Size\n"
1334 " /dev/sda1 filesystem ext4 boot 524288000\n"
1335 " /dev/vg_guest/lv_root filesystem ext4 root 10212081664\n"
1340 #: ../cat/virt-filesystems.pod:49
1342 "If you add I<--extra> then non-mountable (swap, unknown) filesystems are "
1347 #: ../cat/virt-filesystems.pod:52
1350 " $ virt-filesystems -a disk.img --extra\n"
1352 " /dev/vg_guest/lv_root\n"
1353 " /dev/vg_guest/lv_swap\n"
1354 " /dev/vg_guest/lv_data\n"
1359 #: ../cat/virt-filesystems.pod:58
1361 "If you add I<--partitions> then partitions are shown instead of filesystems:"
1365 #: ../cat/virt-filesystems.pod:60
1368 " $ virt-filesystems -a disk.img --partitions\n"
1375 #: ../cat/virt-filesystems.pod:64
1377 "Similarly you can use I<--logical-volumes>, I<--volume-groups>, I<--physical-"
1378 "volumes>, I<--block-devices> to list those items."
1382 #: ../cat/virt-filesystems.pod:67
1384 "You can use these options in combination as well (if you want a combination "
1385 "including filesystems, you have to add I<--filesystems>). Notice that some "
1386 "items fall into several categories (eg. C</dev/sda1> might be both a "
1387 "partition and a filesystem). These items are listed several times. To get "
1388 "a list which includes absolutely everything that virt-filesystems knows "
1389 "about, use the I<--all> option."
1393 #: ../cat/virt-filesystems.pod:74
1395 "UUIDs (because they are quite long) are not shown by default. Add the I<--"
1396 "uuid> option to display device and filesystem UUIDs in the long output."
1400 #: ../cat/virt-filesystems.pod:78
1402 "I<--all --long --uuid> is a useful combination to display all possible "
1403 "information about everything."
1407 #: ../cat/virt-filesystems.pod:81
1410 " $ virt-filesystems -a win.img --all --long --uuid -h\n"
1411 " Name Type VFS Label Size Parent UUID\n"
1412 " /dev/sda1 filesystem ntfs System Reserved 100M - F81C92571C92112C\n"
1413 " /dev/sda2 filesystem ntfs - 20G - F2E8996AE8992E3B\n"
1414 " /dev/sda1 partition - - 100M /dev/sda -\n"
1415 " /dev/sda2 partition - - 20G /dev/sda -\n"
1416 " /dev/sda device - - 20G - -\n"
1421 #: ../cat/virt-filesystems.pod:89
1423 "For machine-readable output, use I<--csv> to get Comma-Separated Values."
1427 #: ../cat/virt-filesystems.pod:110 ../tools/virt-list-filesystems.pl:121
1429 #| msgid "B<--help>"
1434 #: ../cat/virt-filesystems.pod:112
1436 "Display everything. This is currently the same as specifying these options: "
1437 "I<--filesystems>, I<--extra>, I<--partitions>, I<--block-devices>, I<--"
1438 "logical-volumes>, I<--volume-groups>, I<--physical-volumes>. (More may be "
1439 "added to this list in future)."
1443 #: ../cat/virt-filesystems.pod:117
1445 #| msgid "See also L</is-lv>."
1446 msgid "See also I<--long>."
1447 msgstr "Див. також L</is-lv>."
1450 #: ../cat/virt-filesystems.pod:119
1452 #| msgid "B<--live>"
1453 msgid "B<--blkdevs>"
1457 #: ../cat/virt-filesystems.pod:121
1459 #| msgid "is-blockdev"
1460 msgid "B<--block-devices>"
1461 msgstr "is-blockdev"
1464 #: ../cat/virt-filesystems.pod:123
1466 #| msgid "is-blockdev"
1467 msgid "Display block devices."
1468 msgstr "is-blockdev"
1471 #: ../cat/virt-filesystems.pod:135 ../cat/virt-ls.pod:301 ../df/virt-df.pod:88
1478 #: ../cat/virt-filesystems.pod:137 ../cat/virt-ls.pod:303 ../df/virt-df.pod:90
1480 "Write out the results in CSV format (comma-separated values). This format "
1481 "can be imported easily into databases and spreadsheets, but read L</NOTE "
1482 "ABOUT CSV FORMAT> below."
1486 #: ../cat/virt-filesystems.pod:150
1488 "When prompting for keys and passphrases, virt-filesystems normally turns "
1489 "echoing off so you cannot see what you are typing. If you are not worried "
1490 "about Tempest attacks and there is no one else in the room you can specify "
1491 "this flag to see what you are typing."
1495 #: ../cat/virt-filesystems.pod:155
1502 #: ../cat/virt-filesystems.pod:157
1504 "This causes filesystems that are not ordinary, mountable filesystems to be "
1505 "displayed. This category includes swapspace, and filesystems that are empty "
1506 "or contain unknown data."
1510 #: ../cat/virt-filesystems.pod:161
1511 msgid "This option implies I<--filesystems>."
1515 #: ../cat/virt-filesystems.pod:163
1517 #| msgid "list-filesystems"
1518 msgid "B<--filesystems>"
1519 msgstr "list-filesystems"
1522 #: ../cat/virt-filesystems.pod:165
1524 "Display mountable filesystems. If no display option was selected then this "
1525 "option is implied."
1529 #: ../cat/virt-filesystems.pod:168
1530 msgid "With I<--extra>, non-mountable filesystems are shown too."
1534 #: ../cat/virt-filesystems.pod:181
1537 #| " guestfish --format=raw -a disk.img\n"
1540 " virt-filesystems --format=raw -a disk.img\n"
1543 " guestfish --format=raw -a disk.img\n"
1547 #: ../cat/virt-filesystems.pod:185
1550 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
1553 " virt-filesystems --format=raw -a disk.img --format -a another.img\n"
1556 " guestfish --format=raw -a disk.img --format -a another.img\n"
1560 #: ../cat/virt-filesystems.pod:194 ../cat/virt-ls.pod:352
1561 #: ../df/virt-df.pod:125 ../fish/guestfish.pod:156
1562 #: ../tools/virt-list-partitions.pl:109
1567 #: ../cat/virt-filesystems.pod:196 ../cat/virt-ls.pod:354
1568 #: ../df/virt-df.pod:127 ../tools/virt-list-partitions.pl:111
1570 #| msgid "B<-h> | B<--human-readable>"
1571 msgid "B<--human-readable>"
1572 msgstr "B<-h> | B<--human-readable>"
1575 #: ../cat/virt-filesystems.pod:198
1576 msgid "In I<--long> mode, display sizes in human-readable format."
1580 #: ../cat/virt-filesystems.pod:205 ../cat/virt-ls.pod:366
1581 #: ../tools/virt-list-filesystems.pl:108 ../tools/virt-list-partitions.pl:119
1586 #: ../cat/virt-filesystems.pod:207 ../cat/virt-ls.pod:368
1587 #: ../tools/virt-list-filesystems.pl:110 ../tools/virt-list-partitions.pl:121
1594 #: ../cat/virt-filesystems.pod:209
1595 msgid "Display extra columns of data (\"long format\")."
1599 #: ../cat/virt-filesystems.pod:211
1600 msgid "A title row is added unless you also specify I<--no-title>."
1604 #: ../cat/virt-filesystems.pod:213
1606 "The extra columns displayed depend on what output you select, and the "
1607 "ordering of columns may change in future versions. Use the title row, I<--"
1608 "csv> output and/or L<csvtool(1)> to match columns to data in external "
1613 #: ../cat/virt-filesystems.pod:218
1615 "Use I<-h> if you want sizes to be displayed in human-readable format. The "
1616 "default is to show raw numbers of I<bytes>."
1620 #: ../cat/virt-filesystems.pod:221
1621 msgid "Use I<--uuid> to display UUIDs too."
1625 #: ../cat/virt-filesystems.pod:223
1627 #| msgid "B<--live>"
1632 #: ../cat/virt-filesystems.pod:225
1634 #| msgid "B<--live>"
1635 msgid "B<--logvols>"
1639 #: ../cat/virt-filesystems.pod:227
1641 #| msgid "B<--live>"
1642 msgid "B<--logical-volumes>"
1646 #: ../cat/virt-filesystems.pod:229
1648 "Display LVM logical volumes. In this mode, these are displayed irrespective "
1649 "of whether the LVs contain filesystems."
1653 #: ../cat/virt-filesystems.pod:232
1655 #| msgid "B<--listen>"
1656 msgid "B<--no-title>"
1657 msgstr "B<--listen>"
1660 #: ../cat/virt-filesystems.pod:234
1661 msgid "In I<--long> mode, don't add a title row."
1665 #: ../cat/virt-filesystems.pod:236
1667 "Note that the order of the columns is not fixed, and may change in future "
1668 "versions of virt-filesystems, so using this option may give you unexpected "
1673 #: ../cat/virt-filesystems.pod:240
1675 #| msgid "B<--partition>"
1677 msgstr "B<--partition>"
1680 #: ../cat/virt-filesystems.pod:242
1682 #| msgid "B<--partition>"
1683 msgid "B<--partitions>"
1684 msgstr "B<--partition>"
1687 #: ../cat/virt-filesystems.pod:244
1689 "Display partitions. In this mode, these are displayed irrespective of "
1690 "whether the partitions contain filesystems."
1694 #: ../cat/virt-filesystems.pod:247
1701 #: ../cat/virt-filesystems.pod:249
1703 #| msgid "B<--verbose>"
1704 msgid "B<--physvols>"
1705 msgstr "B<--verbose>"
1708 #: ../cat/virt-filesystems.pod:251
1709 msgid "B<--physical-volumes>"
1713 #: ../cat/virt-filesystems.pod:253
1714 msgid "Display LVM physical volumes."
1718 #: ../cat/virt-filesystems.pod:255 ../df/virt-df.pod:163
1720 #| msgid "B<--live>"
1725 #: ../cat/virt-filesystems.pod:257
1732 #: ../cat/virt-filesystems.pod:259
1733 msgid "In I<--long> mode, display UUIDs as well."
1737 #: ../cat/virt-filesystems.pod:273
1744 #: ../cat/virt-filesystems.pod:275
1746 #| msgid "B<--verbose>"
1747 msgid "B<--volgroups>"
1748 msgstr "B<--verbose>"
1751 #: ../cat/virt-filesystems.pod:277
1753 #| msgid "B<--verbose>"
1754 msgid "B<--volume-groups>"
1755 msgstr "B<--verbose>"
1758 #: ../cat/virt-filesystems.pod:279
1759 msgid "Display LVM volume groups."
1763 #: ../cat/virt-filesystems.pod:287
1768 #: ../cat/virt-filesystems.pod:289
1770 "Note that columns in the output are subject to reordering and change in "
1771 "future versions of this tool."
1775 #: ../cat/virt-filesystems.pod:294
1780 #: ../cat/virt-filesystems.pod:296
1781 msgid "The filesystem, partition, block device or LVM name."
1785 #: ../cat/virt-filesystems.pod:298
1787 "For device and partition names these are displayed as canonical libguestfs "
1788 "names, so that for example C</dev/sda2> is the second partition on the first "
1793 #: ../cat/virt-filesystems.pod:302
1795 "If the I<--long> option is B<not> specified, then only the name column is "
1796 "shown in the output."
1800 #: ../cat/virt-filesystems.pod:305
1802 #| msgid "B<-N type>"
1807 #: ../cat/virt-filesystems.pod:307
1808 msgid "The object type, for example C<filesystem>, C<lv>, C<device> etc."
1812 #: ../cat/virt-filesystems.pod:309
1817 #: ../cat/virt-filesystems.pod:311
1819 "If there is a filesystem, then this column displays the filesystem type if "
1820 "one could be detected, eg. C<ext4>."
1824 #: ../cat/virt-filesystems.pod:314
1829 #: ../cat/virt-filesystems.pod:316
1831 "If the object has a label (used for identifying and mounting filesystems) "
1832 "then this column contains the label."
1836 #: ../cat/virt-filesystems.pod:319
1838 #| msgid "B<part_size>"
1840 msgstr "B<part_size>"
1843 #: ../cat/virt-filesystems.pod:321
1845 "The size of the object in bytes. If the I<--human> option is used then the "
1846 "size is displayed in a human-readable form."
1850 #: ../cat/virt-filesystems.pod:324
1855 #: ../cat/virt-filesystems.pod:326
1857 "The parent column records the parent relationship between objects. For "
1858 "example, if the object is a partition, then this column contains the name of "
1859 "the containing device. If the object is a logical volume, then this column "
1860 "is the name of the volume group."
1864 #: ../cat/virt-filesystems.pod:331
1869 #: ../cat/virt-filesystems.pod:333
1871 "If the object has a UUID (used for identifying and mounting filesystems and "
1872 "block devices) then this column contains the UUID as a string."
1876 #: ../cat/virt-filesystems.pod:337
1877 msgid "The UUID is only displayed if the I<--uuid> option is given."
1881 #: ../cat/virt-filesystems.pod:341 ../cat/virt-ls.pod:459
1882 #: ../df/virt-df.pod:191
1883 msgid "NOTE ABOUT CSV FORMAT"
1887 #: ../cat/virt-filesystems.pod:343 ../cat/virt-ls.pod:461
1888 #: ../df/virt-df.pod:193
1890 "Comma-separated values (CSV) is a deceptive format. It I<seems> like it "
1891 "should be easy to parse, but it is definitely not easy to parse."
1895 #: ../cat/virt-filesystems.pod:346 ../cat/virt-ls.pod:464
1896 #: ../df/virt-df.pod:196
1898 "Myth: Just split fields at commas. Reality: This does I<not> work "
1899 "reliably. This example has two columns:"
1903 #: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:467
1904 #: ../df/virt-df.pod:199
1907 " \"foo,bar\",baz\n"
1912 #: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:469
1913 #: ../df/virt-df.pod:201
1915 "Myth: Read the file one line at a time. Reality: This does I<not> work "
1916 "reliably. This example has one row:"
1920 #: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:472
1921 #: ../df/virt-df.pod:204
1930 #: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:475
1931 #: ../df/virt-df.pod:207
1933 "For shell scripts, use C<csvtool> (L<http://merjis.com/developers/csv> also "
1934 "packaged in major Linux distributions)."
1938 #: ../cat/virt-filesystems.pod:360 ../cat/virt-ls.pod:478
1939 #: ../df/virt-df.pod:210
1941 "For other languages, use a CSV processing library (eg. C<Text::CSV> for Perl "
1942 "or Python's built-in csv library)."
1946 #: ../cat/virt-filesystems.pod:363 ../cat/virt-ls.pod:481
1947 #: ../df/virt-df.pod:213
1948 msgid "Most spreadsheets and databases can import CSV directly."
1952 #: ../cat/virt-filesystems.pod:379
1955 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
1956 #| "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
1957 #| "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
1959 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-df(1)>, L<virt-list-"
1960 "filesystems(1)>, L<virt-list-partitions(1)>, L<csvtool(1)>, L<http://"
1963 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
1964 "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
1965 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
1968 #: ../cat/virt-filesystems.pod:394 ../tools/virt-make-fs.pl:570
1969 #: ../tools/virt-win-reg.pl:778
1970 msgid "Copyright (C) 2010 Red Hat Inc."
1974 #: ../cat/virt-ls.pod:5
1975 msgid "virt-ls - List files in a virtual machine"
1979 #: ../cat/virt-ls.pod:9
1982 " virt-ls [--options] -d domname directory [directory ...]\n"
1987 #: ../cat/virt-ls.pod:11
1990 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
1993 " virt-ls [--options] -a disk.img [-a disk.img ...] directory [directory ...]\n"
1996 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
2000 #: ../cat/virt-ls.pod:13 ../df/virt-df.pod:15 ../rescue/virt-rescue.pod:13
2005 #: ../cat/virt-ls.pod:15
2008 #| " virt-list-partitions [--options] domname\n"
2011 " virt-ls [--options] domname directory\n"
2014 " virt-list-partitions [--параметри] назва_домену\n"
2018 #: ../cat/virt-ls.pod:17
2021 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
2024 " virt-ls [--options] disk.img [disk.img ...] directory\n"
2027 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
2031 #: ../cat/virt-ls.pod:21
2033 "C<virt-ls> lists filenames, file sizes, checksums, extended attributes and "
2034 "more from a virtual machine or disk image."
2038 #: ../cat/virt-ls.pod:24
2040 "Multiple directory names can be given, in which case the output from each is "
2045 #: ../cat/virt-ls.pod:27
2047 "To list directories from a libvirt guest use the I<-d> option to specify the "
2048 "name of the guest. For a disk image, use the I<-a> option."
2052 #: ../cat/virt-ls.pod:31
2054 "C<virt-ls> can do many simple file listings. For more complicated cases you "
2055 "may need to use L<guestfish(1)>, or write a program directly to the L<guestfs"
2060 #: ../cat/virt-ls.pod:37
2061 msgid "Get a list of all files and directories in a virtual machine:"
2065 #: ../cat/virt-ls.pod:39
2068 #| " guestfish --ro -d myguest -i\n"
2071 " virt-ls -R -d guest /\n"
2074 " guestfish --ro -d myguest -i\n"
2078 #: ../cat/virt-ls.pod:41
2079 msgid "List all setuid or setgid programs in a Linux virtual machine:"
2083 #: ../cat/virt-ls.pod:43
2086 " virt-ls -lR -d guest / | grep '^- [42]'\n"
2091 #: ../cat/virt-ls.pod:45
2092 msgid "List all public-writable directories in a Linux virtual machine:"
2096 #: ../cat/virt-ls.pod:47
2099 " virt-ls -lR -d guest / | grep '^d ...7'\n"
2104 #: ../cat/virt-ls.pod:49
2105 msgid "List all Unix domain sockets in a Linux virtual machine:"
2109 #: ../cat/virt-ls.pod:51
2112 " virt-ls -lR -d guest / | grep '^s'\n"
2117 #: ../cat/virt-ls.pod:53
2118 msgid "List all regular files with filenames ending in '.png':"
2122 #: ../cat/virt-ls.pod:55
2125 " virt-ls -lR -d guest / | grep -i '^-.*\\.png$'\n"
2130 #: ../cat/virt-ls.pod:57
2131 msgid "To display files larger than 10MB in home directories:"
2135 #: ../cat/virt-ls.pod:59
2138 " virt-ls -lR -d guest /home | awk '$3 > 10*1024*1024'\n"
2143 #: ../cat/virt-ls.pod:61
2144 msgid "Find everything modified in the last 7 days:"
2148 #: ../cat/virt-ls.pod:63
2151 " virt-ls -lR -d guest --time-days / | awk '$6 <= 7'\n"
2156 #: ../cat/virt-ls.pod:65
2157 msgid "Find regular files modified in the last 24 hours:"
2161 #: ../cat/virt-ls.pod:67
2164 " virt-ls -lR -d guest --time-days / | grep '^-' | awk '$6 < 1'\n"
2169 #: ../cat/virt-ls.pod:69
2170 msgid "DIFFERENCES IN SNAPSHOTS AND BACKING FILES"
2174 #: ../cat/virt-ls.pod:71
2176 "Find the differences between files in a guest and an earlier snapshot of the "
2181 #: ../cat/virt-ls.pod:74
2184 " virt-ls -lR -a snapshot.img / --uids --time-t > old\n"
2185 " virt-ls -lR -a current.img / --uids --time-t > new\n"
2186 " diff -u old new | less\n"
2191 #: ../cat/virt-ls.pod:78
2193 "The commands above won't find files where the content has changed but the "
2194 "metadata (eg. file size and modification date) is the same. To do that, you "
2195 "need to add the I<--checksum> parameter to both C<virt-ls> commands. I<--"
2196 "checksum> can be quite slow since it has to read and compute a checksum of "
2197 "every regular file in the virtual machine."
2201 #: ../cat/virt-ls.pod:84
2202 msgid "OUTPUT MODES"
2206 #: ../cat/virt-ls.pod:86
2208 "C<virt-ls> has four output modes, controlled by different combinations of "
2209 "the I<-l> and I<-R> options."
2213 #: ../cat/virt-ls.pod:89
2214 msgid "SIMPLE LISTING"
2218 #: ../cat/virt-ls.pod:91
2219 msgid "A simple listing is like the ordinary L<ls(1)> command:"
2223 #: ../cat/virt-ls.pod:93
2226 " $ virt-ls -d guest /\n"
2234 #: ../cat/virt-ls.pod:98
2237 msgid "LONG LISTING"
2241 #: ../cat/virt-ls.pod:100
2243 "With the I<-l> (I<--long>) option, the output is like the C<ls -l> command "
2244 "(more specifically, like the C<guestfs_ll> function)."
2248 #: ../cat/virt-ls.pod:103
2251 " $ virt-ls -l -d guest /\n"
2253 " dr-xr-xr-x. 2 root root 4096 2009-08-25 19:06 bin\n"
2254 " dr-xr-xr-x. 5 root root 3072 2009-08-25 19:06 boot\n"
2260 #: ../cat/virt-ls.pod:109
2262 "Note that while this is useful for displaying a directory, do not try "
2263 "parsing this output in another program. Use L</RECURSIVE LONG LISTING> "
2268 #: ../cat/virt-ls.pod:113
2269 msgid "RECURSIVE LISTING"
2273 #: ../cat/virt-ls.pod:115
2275 "With the I<-R> (I<--recursive>) option, C<virt-ls> lists the names of files "
2276 "and directories recursively:"
2280 #: ../cat/virt-ls.pod:118
2283 " $ virt-ls -R -d guest /tmp\n"
2291 #: ../cat/virt-ls.pod:123
2293 "To generate this output, C<virt-ls> runs the C<guestfs_find0> function and "
2294 "converts C<\\0> characters to C<\\n>."
2298 #: ../cat/virt-ls.pod:126
2299 msgid "RECURSIVE LONG LISTING"
2303 #: ../cat/virt-ls.pod:128
2305 "Using I<-lR> options together changes the output to display directories "
2306 "recursively, with file stats, and optionally other features such as "
2307 "checksums and extended attributes."
2311 #: ../cat/virt-ls.pod:132
2313 "Most of the interesting features of C<virt-ls> are only available when using "
2318 #: ../cat/virt-ls.pod:135
2320 "The fields are normally space-separated. Filenames are B<not> quoted, so "
2321 "you cannot use the output in another program (because filenames can contain "
2322 "spaces and other unsafe characters). If the guest was untrusted and someone "
2323 "knew you were using C<virt-ls> to analyze the guest, they could play tricks "
2324 "on you by creating filenames with embedded newline characters. To B<safely> "
2325 "parse the output in another program, use the I<--csv> (Comma-Separated "
2330 #: ../cat/virt-ls.pod:143
2332 "Note that this output format is completely unrelated to the C<ls -lR> "
2337 #: ../cat/virt-ls.pod:146
2340 " $ virt-ls -lR -d guest /bin\n"
2341 " d 0555 4096 /bin\n"
2342 " - 0755 123 /bin/alsaunmute\n"
2343 " - 0755 28328 /bin/arch\n"
2344 " l 0777 4 /bin/awk -> gawk\n"
2345 " - 0755 27216 /bin/basename\n"
2346 " - 0755 943360 /bin/bash\n"
2352 #: ../cat/virt-ls.pod:155
2353 msgid "These basic fields are always shown:"
2357 #: ../cat/virt-ls.pod:159
2364 #: ../cat/virt-ls.pod:161
2366 "The file type, one of: C<-> (regular file), C<d> (directory), C<c> "
2367 "(character device), C<b> (block device), C<p> (named pipe), C<l> (symbolic "
2368 "link), C<s> (socket) or C<u> (unknown)."
2372 #: ../cat/virt-ls.pod:171
2379 #: ../cat/virt-ls.pod:173
2380 msgid "The Unix permissions, displayed as a 4 digit octal number."
2384 #: ../cat/virt-ls.pod:175
2391 #: ../cat/virt-ls.pod:177
2393 "The size of the file. This is shown in bytes unless I<-h> or I<--human-"
2394 "readable> option is given, in which case this is shown as a human-readable "
2399 #: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4245
2404 #: ../cat/virt-ls.pod:183
2405 msgid "The full path of the file or directory."
2409 #: ../cat/virt-ls.pod:185
2416 #: ../cat/virt-ls.pod:187
2417 msgid "For symbolic links only, the link target."
2421 #: ../cat/virt-ls.pod:191
2423 "In I<-lR> mode, additional command line options enable the display of more "
2428 #: ../cat/virt-ls.pod:194
2430 "With the I<--uids> flag, these additional fields are displayed before the "
2435 #: ../cat/virt-ls.pod:199
2442 #: ../cat/virt-ls.pod:201
2449 #: ../cat/virt-ls.pod:203
2451 "The UID and GID of the owner of the file (displayed numerically). Note "
2452 "these only make sense in the context of a Unix-like guest."
2456 #: ../cat/virt-ls.pod:208
2457 msgid "With the I<--times> flag, these additional fields are displayed:"
2461 #: ../cat/virt-ls.pod:212
2468 #: ../cat/virt-ls.pod:214
2469 msgid "The time of last access."
2473 #: ../cat/virt-ls.pod:216
2480 #: ../cat/virt-ls.pod:218
2481 msgid "The time of last modification."
2485 #: ../cat/virt-ls.pod:220
2492 #: ../cat/virt-ls.pod:222
2493 msgid "The time of last status change."
2497 #: ../cat/virt-ls.pod:226
2499 "The time fields are displayed as string dates and times, unless one of the "
2500 "I<--time-t>, I<--time-relative> or I<--time-days> flags is given."
2504 #: ../cat/virt-ls.pod:229
2505 msgid "With the I<--extra-stats> flag, these additional fields are displayed:"
2509 #: ../cat/virt-ls.pod:233
2511 #| msgid "zero-device"
2513 msgstr "zero-device"
2516 #: ../cat/virt-ls.pod:235
2518 "The device containing the file (displayed as major:minor). This may not "
2519 "match devices as known to the guest."
2523 #: ../cat/virt-ls.pod:238
2528 #: ../cat/virt-ls.pod:240
2529 msgid "The inode number."
2533 #: ../cat/virt-ls.pod:242
2540 #: ../cat/virt-ls.pod:244
2541 msgid "The number of hard links."
2545 #: ../cat/virt-ls.pod:246
2550 #: ../cat/virt-ls.pod:248
2552 "For block and char special files, the device (displayed as major:minor)."
2556 #: ../cat/virt-ls.pod:251
2558 #| msgid "C<blocksize>"
2560 msgstr "C<blocksize>"
2563 #: ../cat/virt-ls.pod:253
2564 msgid "The number of 512 byte blocks allocated to the file."
2568 #: ../cat/virt-ls.pod:257
2570 "With the I<--checksum> flag, the checksum of the file contents is shown "
2571 "(only for regular files). Computing file checksums can take a considerable "
2576 #: ../cat/virt-ls.pod:280
2579 msgid "B<--checksum>"
2583 #: ../cat/virt-ls.pod:282
2584 msgid "B<--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512>"
2588 #: ../cat/virt-ls.pod:284
2590 "Display checksum over file contents for regular files. With no argument, "
2591 "this defaults to using I<md5>. Using an argument, you can select the "
2592 "checksum type to use."
2596 #: ../cat/virt-ls.pod:288 ../cat/virt-ls.pod:325 ../cat/virt-ls.pod:358
2597 #: ../cat/virt-ls.pod:391 ../cat/virt-ls.pod:401 ../cat/virt-ls.pod:408
2598 #: ../cat/virt-ls.pod:415 ../cat/virt-ls.pod:422
2600 "This option only has effect in I<-lR> output mode. See L</RECURSIVE LONG "
2605 #: ../cat/virt-ls.pod:316
2607 "When prompting for keys and passphrases, virt-ls normally turns echoing off "
2608 "so you cannot see what you are typing. If you are not worried about Tempest "
2609 "attacks and there is no one else in the room you can specify this flag to "
2610 "see what you are typing."
2614 #: ../cat/virt-ls.pod:321
2616 #| msgid "B<--no-dest-paths>"
2617 msgid "B<--extra-stats>"
2618 msgstr "B<--no-dest-paths>"
2621 #: ../cat/virt-ls.pod:323
2622 msgid "Display extra stats."
2626 #: ../cat/virt-ls.pod:339
2629 #| " guestfish --format=raw -a disk.img\n"
2632 " virt-ls --format=raw -a disk.img /dir\n"
2635 " guestfish --format=raw -a disk.img\n"
2639 #: ../cat/virt-ls.pod:343
2642 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
2645 " virt-ls --format=raw -a disk.img --format -a another.img /dir\n"
2648 " guestfish --format=raw -a disk.img --format -a another.img\n"
2652 #: ../cat/virt-ls.pod:356
2653 msgid "Display file sizes in human-readable format."
2657 #: ../cat/virt-ls.pod:370
2662 #: ../cat/virt-ls.pod:372
2664 #| msgid "B<--live>"
2665 msgid "B<--recursive>"
2669 #: ../cat/virt-ls.pod:374
2671 "Select the mode. With neither of these options, C<virt-ls> produces a "
2672 "simple, flat list of the files in the named directory. See L</SIMPLE "
2677 #: ../cat/virt-ls.pod:378
2679 "C<virt-ls -l> produces a \"long listing\", which shows more detail. See L</"
2684 #: ../cat/virt-ls.pod:381
2686 "C<virt-ls -R> produces a recursive list of files starting at the named "
2687 "directory. See L</RECURSIVE LISTING>."
2691 #: ../cat/virt-ls.pod:384
2693 "C<virt-ls -lR> produces a recursive long listing which can be more easily "
2694 "parsed. See L</RECURSIVE LONG LISTING>."
2698 #: ../cat/virt-ls.pod:387
2700 #| msgid "B<--live>"
2705 #: ../cat/virt-ls.pod:389
2706 msgid "Display time fields."
2710 #: ../cat/virt-ls.pod:394
2712 #| msgid "B<--echo-keys>"
2713 msgid "B<--time-days>"
2714 msgstr "B<--echo-keys>"
2717 #: ../cat/virt-ls.pod:396
2718 msgid "Display time fields as days before now (negative if in the future)."
2722 #: ../cat/virt-ls.pod:398
2724 "Note that C<0> in output means \"up to 1 day before now\", or that the age "
2725 "of the file is between 0 and 86399 seconds."
2729 #: ../cat/virt-ls.pod:404
2731 #| msgid "B<--live>"
2732 msgid "B<--time-relative>"
2736 #: ../cat/virt-ls.pod:406
2737 msgid "Display time fields as seconds before now (negative if in the future)."
2741 #: ../cat/virt-ls.pod:411
2743 #| msgid "I<--timeout N>"
2745 msgstr "I<--timeout N>"
2748 #: ../cat/virt-ls.pod:413
2749 msgid "Display time fields as seconds since the Unix epoch."
2753 #: ../cat/virt-ls.pod:418
2760 #: ../cat/virt-ls.pod:420
2761 msgid "Display UID and GID fields."
2765 #: ../cat/virt-ls.pod:445
2766 msgid "Previous versions of virt-ls allowed you to write either:"
2770 #: ../cat/virt-ls.pod:447
2773 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
2776 " virt-ls disk.img [disk.img ...] /dir\n"
2779 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
2783 #: ../cat/virt-ls.pod:451
2786 #| " inspect-get-hostname root\n"
2789 " virt-ls guestname /dir\n"
2792 " inspect-get-hostname корінь\n"
2796 #: ../cat/virt-ls.pod:497
2799 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
2800 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
2801 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
2803 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-out(1)>, L<virt-"
2804 "tar-out(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
2805 "L<http://libguestfs.org/>."
2807 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
2808 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
2809 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
2812 #: ../cat/virt-ls.pod:513 ../df/virt-df.pod:241 ../edit/virt-edit.pod:374
2813 #: ../rescue/virt-rescue.pod:302
2815 #| msgid "Copyright (C) 2009-2010 Red Hat Inc."
2816 msgid "Copyright (C) 2009-2011 Red Hat Inc."
2817 msgstr "© Red Hat Inc., 2009–2010"
2820 #: ../df/virt-df.pod:5
2821 msgid "virt-df - Display free space on virtual filesystems"
2825 #: ../df/virt-df.pod:9
2828 #| " virt-list-partitions [--options] domname\n"
2831 " virt-df [--options]\n"
2834 " virt-list-partitions [--параметри] назва_домену\n"
2838 #: ../df/virt-df.pod:11
2841 #| " virt-list-partitions [--options] domname\n"
2844 " virt-df [--options] -d domname\n"
2847 " virt-list-partitions [--параметри] назва_домену\n"
2851 #: ../df/virt-df.pod:13
2854 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
2857 " virt-df [--options] -a disk.img [-a disk.img ...]\n"
2860 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
2864 #: ../df/virt-df.pod:17
2867 #| " virt-list-partitions [--options] domname\n"
2870 " virt-df [--options] domname\n"
2873 " virt-list-partitions [--параметри] назва_домену\n"
2877 #: ../df/virt-df.pod:19
2880 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
2883 " virt-df [--options] disk.img [disk.img ...]\n"
2886 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
2890 #: ../df/virt-df.pod:23
2892 "C<virt-df> is a command line tool to display free space on virtual machine "
2893 "filesystems. Unlike other tools, it doesn't just display the size of disk "
2894 "allocated to a virtual machine, but can look inside disk images to see how "
2895 "much space is really being used."
2899 #: ../df/virt-df.pod:28
2901 "If used without any I<-a> or I<-d> arguments, C<virt-df> checks with libvirt "
2902 "to get a list of all active and inactive guests, and performs a C<df>-type "
2903 "operation on each one in turn, printing out the results."
2907 #: ../df/virt-df.pod:32
2909 "If any I<-a> or I<-d> arguments are specified, C<virt-df> performs a C<df>-"
2910 "type operation on either the single named libvirt domain, or on the disk "
2911 "image(s) listed on the command line (which must all belong to a single VM). "
2912 "In this mode (with arguments), C<virt-df> will I<only work for a single "
2913 "guest>. If you want to run on multiple guests, then you have to invoke "
2914 "C<virt-df> multiple times."
2918 #: ../df/virt-df.pod:39
2920 "Use the I<--csv> option to get a format which can be easily parsed by other "
2921 "programs. Other options are similar to the standard L<df(1)> command."
2925 #: ../df/virt-df.pod:45
2927 "Show disk usage for a single libvirt guest called C<F14x64>. Make the "
2928 "output human-readable:"
2932 #: ../df/virt-df.pod:48
2935 " # virt-df -d F14x64 -h\n"
2936 " Filesystem Size Used Available Use%\n"
2937 " F14x64:/dev/sda1 484M 66M 393M 14%\n"
2938 " F14x64:/dev/vg_f13x64/lv_root 7.4G 3.4G 4.0G 46%\n"
2943 #: ../df/virt-df.pod:53
2944 msgid "Show disk usage for a disk image file called C<test.img>:"
2948 #: ../df/virt-df.pod:55
2951 " $ virt-df -a test1.img\n"
2952 " Filesystem 1K-blocks Used Available Use%\n"
2953 " test1.img:/dev/sda1 99099 1551 92432 2%\n"
2958 #: ../df/virt-df.pod:112
2961 #| " guestfish --format=raw -a disk.img\n"
2964 " virt-df --format=raw -a disk.img\n"
2967 " guestfish --format=raw -a disk.img\n"
2971 #: ../df/virt-df.pod:116
2974 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
2977 " virt-df --format=raw -a disk.img --format -a another.img\n"
2980 " guestfish --format=raw -a disk.img --format -a another.img\n"
2984 #: ../df/virt-df.pod:129
2985 msgid "Print sizes in human-readable format."
2989 #: ../df/virt-df.pod:131
2990 msgid "You are not allowed to use I<-h> and I<--csv> at the same time."
2994 #: ../df/virt-df.pod:133 ../fish/guestfish.pod:258 ../fuse/guestmount.pod:155
2999 #: ../df/virt-df.pod:135
3001 #| msgid "B<--live>"
3006 #: ../df/virt-df.pod:137
3007 msgid "Print inodes instead of blocks."
3011 #: ../df/virt-df.pod:139
3013 #| msgid "B<--merge>"
3014 msgid "B<--one-per-guest>"
3018 #: ../df/virt-df.pod:141
3020 "Run one libguestfs appliance per guest. Normally C<virt-df> will add the "
3021 "disks from several guests to a single libguestfs appliance."
3025 #: ../df/virt-df.pod:144
3026 msgid "You might use this option in the following circumstances:"
3030 #: ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266
3031 #: ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276
3032 #: ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291
3033 #: ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102
3034 #: ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132
3035 #: ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227
3036 #: ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235
3037 #: ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243
3038 #: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20
3039 #: ../fish/guestfish-actions.pod:390 ../fish/guestfish-actions.pod:398
3040 #: ../fish/guestfish-actions.pod:405 ../fish/guestfish-actions.pod:412
3041 #: ../fish/guestfish-actions.pod:1139 ../fish/guestfish-actions.pod:1143
3042 #: ../fish/guestfish-actions.pod:1147 ../fish/guestfish-actions.pod:1151
3043 #: ../fish/guestfish-actions.pod:1159 ../fish/guestfish-actions.pod:1163
3044 #: ../fish/guestfish-actions.pod:1167 ../fish/guestfish-actions.pod:1177
3045 #: ../fish/guestfish-actions.pod:1181 ../fish/guestfish-actions.pod:1185
3046 #: ../fish/guestfish-actions.pod:1275 ../fish/guestfish-actions.pod:1279
3047 #: ../fish/guestfish-actions.pod:1284 ../fish/guestfish-actions.pod:1289
3048 #: ../fish/guestfish-actions.pod:1331 ../fish/guestfish-actions.pod:1335
3049 #: ../fish/guestfish-actions.pod:1340 ../fish/guestfish-actions.pod:1596
3050 #: ../fish/guestfish-actions.pod:1603 ../fish/guestfish-actions.pod:1610
3051 #: ../fish/guestfish-actions.pod:2005 ../fish/guestfish-actions.pod:2011
3052 #: ../fish/guestfish-actions.pod:2019 ../fish/guestfish-actions.pod:2026
3053 #: ../fish/guestfish-actions.pod:2033 ../fish/guestfish.pod:445
3054 #: ../fish/guestfish.pod:449 ../fish/guestfish.pod:453
3055 #: ../fish/guestfish.pod:457 ../inspector/virt-inspector.pod:393
3056 #: ../inspector/virt-inspector.pod:397 ../resize/virt-resize.pod:282
3057 #: ../resize/virt-resize.pod:286 ../resize/virt-resize.pod:295
3058 #: ../resize/virt-resize.pod:301 ../sparsify/virt-sparsify.pod:32
3059 #: ../sparsify/virt-sparsify.pod:39 ../sparsify/virt-sparsify.pod:43
3060 #: ../sparsify/virt-sparsify.pod:49 ../sparsify/virt-sparsify.pod:54
3061 #: ../sparsify/virt-sparsify.pod:58 ../sparsify/virt-sparsify.pod:64
3062 #: ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:29
3063 #: ../src/guestfs-actions.pod:588 ../src/guestfs-actions.pod:596
3064 #: ../src/guestfs-actions.pod:603 ../src/guestfs-actions.pod:610
3065 #: ../src/guestfs-actions.pod:1778 ../src/guestfs-actions.pod:1782
3066 #: ../src/guestfs-actions.pod:1786 ../src/guestfs-actions.pod:1790
3067 #: ../src/guestfs-actions.pod:1798 ../src/guestfs-actions.pod:1802
3068 #: ../src/guestfs-actions.pod:1806 ../src/guestfs-actions.pod:1816
3069 #: ../src/guestfs-actions.pod:1820 ../src/guestfs-actions.pod:1824
3070 #: ../src/guestfs-actions.pod:1962 ../src/guestfs-actions.pod:1966
3071 #: ../src/guestfs-actions.pod:1971 ../src/guestfs-actions.pod:1976
3072 #: ../src/guestfs-actions.pod:2037 ../src/guestfs-actions.pod:2041
3073 #: ../src/guestfs-actions.pod:2046 ../src/guestfs-actions.pod:2461
3074 #: ../src/guestfs-actions.pod:2468 ../src/guestfs-actions.pod:2475
3075 #: ../src/guestfs-actions.pod:3012 ../src/guestfs-actions.pod:3018
3076 #: ../src/guestfs-actions.pod:3026 ../src/guestfs-actions.pod:3033
3077 #: ../src/guestfs-actions.pod:3040 ../src/guestfs.pod:388
3078 #: ../src/guestfs.pod:393 ../src/guestfs.pod:398 ../src/guestfs.pod:402
3079 #: ../src/guestfs.pod:407 ../src/guestfs.pod:411 ../src/guestfs.pod:416
3080 #: ../src/guestfs.pod:421 ../src/guestfs.pod:1094 ../src/guestfs.pod:1098
3081 #: ../src/guestfs.pod:1102 ../src/guestfs.pod:1107 ../src/guestfs.pod:1115
3082 #: ../src/guestfs.pod:1134 ../src/guestfs.pod:1142 ../src/guestfs.pod:1164
3083 #: ../src/guestfs.pod:1168 ../src/guestfs.pod:1172 ../src/guestfs.pod:1176
3084 #: ../src/guestfs.pod:1180 ../src/guestfs.pod:1184 ../src/guestfs.pod:1674
3085 #: ../src/guestfs.pod:1679 ../src/guestfs.pod:1683 ../src/guestfs.pod:1785
3086 #: ../src/guestfs.pod:1790 ../src/guestfs.pod:1794 ../src/guestfs.pod:1804
3087 #: ../src/guestfs.pod:2093 ../src/guestfs.pod:2098 ../src/guestfs.pod:2104
3088 #: ../src/guestfs.pod:2112 ../src/guestfs.pod:2559 ../src/guestfs.pod:2565
3089 #: ../src/guestfs.pod:2570 ../src/guestfs.pod:2576 ../src/guestfs.pod:2971
3090 #: ../src/guestfs.pod:2976 ../src/guestfs.pod:2980 ../src/guestfs.pod:2984
3091 #: ../src/guestfs.pod:2988 ../src/guestfs.pod:3002 ../src/guestfs.pod:3007
3092 #: ../src/guestfs.pod:3236 ../src/guestfs.pod:3240 ../src/guestfs.pod:3244
3093 #: ../src/guestfs.pod:3248 ../tools/virt-win-reg.pl:197
3094 #: ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208
3095 #: ../tools/virt-win-reg.pl:710 ../tools/virt-win-reg.pl:716
3096 #: ../tools/virt-win-reg.pl:722
3101 #: ../df/virt-df.pod:150
3103 "If you think an untrusted guest might actively try to exploit the libguestfs "
3104 "appliance kernel, then this prevents one guest from interfering with the "
3105 "stats printed for another guest."
3109 #: ../df/virt-df.pod:156
3111 "If the kernel has a bug which stops it from accessing a filesystem in one "
3112 "guest (see for example RHBZ#635373) then this allows libguestfs to continue "
3113 "and report stats for further guests."
3117 #: ../df/virt-df.pod:165
3119 "Print UUIDs instead of names. This is useful for following a guest even "
3120 "when the guest is migrated or renamed, or when two guests happen to have the "
3125 #: ../df/virt-df.pod:169
3127 "Note that only domains that we fetch from libvirt come with UUIDs. For disk "
3128 "images, we still print the disk image name even when this option is "
3133 #: ../df/virt-df.pod:229
3135 "L<df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<http://"
3140 #: ../edit/virt-edit.pod:5
3141 msgid "virt-edit - Edit a file in a virtual machine"
3145 #: ../edit/virt-edit.pod:9
3148 #| " virt-list-partitions [--options] domname\n"
3151 " virt-edit [--options] -d domname file [file ...]\n"
3154 " virt-list-partitions [--параметри] назва_домену\n"
3158 #: ../edit/virt-edit.pod:11
3161 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
3164 " virt-edit [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
3167 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
3171 #: ../edit/virt-edit.pod:13
3174 " virt-edit [-d domname|-a disk.img] file -e 'expr'\n"
3179 #: ../edit/virt-edit.pod:17
3182 " virt-edit domname file\n"
3187 #: ../edit/virt-edit.pod:19 ../edit/virt-edit.pod:183
3190 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
3193 " virt-edit disk.img [disk.img ...] file\n"
3196 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
3200 #: ../edit/virt-edit.pod:21 ../fish/guestfish.pod:23
3201 #: ../fish/virt-copy-in.pod:13 ../fish/virt-tar-in.pod:15
3202 #: ../fuse/guestmount.pod:15 ../rescue/virt-rescue.pod:19
3203 #: ../tools/virt-tar.pl:64 ../tools/virt-win-reg.pl:51
3205 msgstr "ПОПЕРЕДЖЕННЯ"
3208 #: ../edit/virt-edit.pod:23
3210 "You must I<not> use C<virt-edit> on live virtual machines. If you do this, "
3211 "you risk disk corruption in the VM. C<virt-edit> tries to stop you from "
3212 "doing this, but doesn't catch all cases."
3216 #: ../edit/virt-edit.pod:29
3218 "C<virt-edit> is a command line tool to edit C<file> where each C<file> "
3219 "exists in the named virtual machine (or disk image)."
3223 #: ../edit/virt-edit.pod:32
3225 "Multiple filenames can be given, in which case they are each edited in "
3226 "turn. Each filename must be a full path, starting at the root directory "
3227 "(starting with '/')."
3231 #: ../edit/virt-edit.pod:36
3232 msgid "If you want to just view a file, use L<virt-cat(1)>."
3236 #: ../edit/virt-edit.pod:38
3238 "For more complex cases you should look at the L<guestfish(1)> tool (see L</"
3239 "USING GUESTFISH> below)."
3243 #: ../edit/virt-edit.pod:41
3245 "C<virt-edit> cannot be used to create a new file. L<guestfish(1)> can do "
3246 "that and much more."
3250 #: ../edit/virt-edit.pod:46
3251 msgid "Edit the named files interactively:"
3255 #: ../edit/virt-edit.pod:48
3258 " virt-edit -d mydomain /boot/grub/grub.conf\n"
3263 #: ../edit/virt-edit.pod:50
3266 " virt-edit -d mydomain /etc/passwd\n"
3271 #: ../edit/virt-edit.pod:52
3272 msgid "For Windows guests, some Windows paths are understood:"
3276 #: ../edit/virt-edit.pod:54
3279 " virt-edit -d mywindomain 'c:\\autoexec.bat'\n"
3284 #: ../edit/virt-edit.pod:56
3286 "If Perl is installed, you can also edit files non-interactively (see L</NON-"
3287 "INTERACTIVE EDITING> below). To change the init default level to 5:"
3291 #: ../edit/virt-edit.pod:60
3294 " virt-edit -d mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
3299 #: ../edit/virt-edit.pod:81
3300 msgid "B<-b> extension"
3304 #: ../edit/virt-edit.pod:83
3305 msgid "B<--backup> extension"
3309 #: ../edit/virt-edit.pod:85
3311 "Create a backup of the original file I<in the guest disk image>. The backup "
3312 "has the original filename with C<extension> added."
3316 #: ../edit/virt-edit.pod:88
3318 "Usually the first character of C<extension> would be a dot C<.> so you would "
3323 #: ../edit/virt-edit.pod:91
3326 " virt-edit -b .orig [etc]\n"
3331 #: ../edit/virt-edit.pod:93
3332 msgid "By default, no backup file is made."
3336 #: ../edit/virt-edit.pod:95 ../fish/guestfish.pod:181
3337 #: ../fuse/guestmount.pod:96 ../inspector/virt-inspector.pod:74
3338 #: ../tools/virt-list-filesystems.pl:77 ../tools/virt-list-partitions.pl:78
3339 #: ../tools/virt-tar.pl:127 ../tools/virt-win-reg.pl:128
3341 msgstr "B<-c адреса>"
3344 #: ../edit/virt-edit.pod:97 ../fish/guestfish.pod:183
3345 #: ../fuse/guestmount.pod:98 ../inspector/virt-inspector.pod:76
3346 #: ../tools/virt-list-filesystems.pl:79 ../tools/virt-list-partitions.pl:80
3347 #: ../tools/virt-tar.pl:129 ../tools/virt-win-reg.pl:130
3348 msgid "B<--connect URI>"
3349 msgstr "B<--connect адреса>"
3352 #: ../edit/virt-edit.pod:102 ../tools/virt-list-filesystems.pl:84
3353 #: ../tools/virt-list-partitions.pl:85 ../tools/virt-tar.pl:134
3354 #: ../tools/virt-win-reg.pl:135
3356 "If you specify guest block devices directly, then libvirt is not used at all."
3360 #: ../edit/virt-edit.pod:114
3362 "When prompting for keys and passphrases, virt-edit normally turns echoing "
3363 "off so you cannot see what you are typing. If you are not worried about "
3364 "Tempest attacks and there is no one else in the room you can specify this "
3365 "flag to see what you are typing."
3369 #: ../edit/virt-edit.pod:119
3374 #: ../edit/virt-edit.pod:121
3376 #| msgid "B<--help>"
3377 msgid "B<--expr> EXPR"
3381 #: ../edit/virt-edit.pod:123
3383 "Instead of launching the external editor, non-interactively apply the Perl "
3384 "expression C<EXPR> to each line in the file. See L</NON-INTERACTIVE "
3389 #: ../edit/virt-edit.pod:127
3391 "Be careful to properly quote the expression to prevent it from being altered "
3396 #: ../edit/virt-edit.pod:130
3397 msgid "Note that this option is only available when Perl 5 is installed."
3401 #: ../edit/virt-edit.pod:132
3403 #| msgid "B<--format=raw|qcow2|..>"
3404 msgid "B<--format> raw|qcow2|..."
3405 msgstr "B<--format=raw|qcow2|..>"
3408 #: ../edit/virt-edit.pod:143
3411 #| " guestfish --format=raw -a disk.img\n"
3414 " virt-edit --format=raw -a disk.img file\n"
3417 " guestfish --format=raw -a disk.img\n"
3421 #: ../edit/virt-edit.pod:147
3424 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
3427 " virt-edit --format=raw -a disk.img --format -a another.img file\n"
3430 " guestfish --format=raw -a disk.img --format -a another.img\n"
3434 #: ../edit/virt-edit.pod:181
3435 msgid "Previous versions of virt-edit allowed you to write either:"
3439 #: ../edit/virt-edit.pod:187
3442 #| " edit filename\n"
3445 " virt-edit guestname file\n"
3448 " edit назва_файла\n"
3452 #: ../edit/virt-edit.pod:195
3453 msgid "NON-INTERACTIVE EDITING"
3457 #: ../edit/virt-edit.pod:197
3459 "C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
3460 "administrator can interactively edit the file."
3464 #: ../edit/virt-edit.pod:200
3466 "There are two ways also to use C<virt-edit> from scripts in order to make "
3467 "automated edits to files. (Note that although you I<can> use C<virt-edit> "
3468 "like this, it's less error-prone to write scripts directly using the "
3469 "libguestfs API and Augeas for configuration file editing.)"
3473 #: ../edit/virt-edit.pod:206
3475 "The first method is to temporarily set C<$EDITOR> to any script or program "
3476 "you want to run. The script is invoked as C<$EDITOR tmpfile> and it should "
3477 "update C<tmpfile> in place however it likes."
3481 #: ../edit/virt-edit.pod:210
3483 "The second method is to use the I<-e> parameter of C<virt-edit> to run a "
3484 "short Perl snippet in the style of L<sed(1)>. For example to replace all "
3485 "instances of C<foo> with C<bar> in a file:"
3489 #: ../edit/virt-edit.pod:214
3492 " virt-edit -d domname filename -e 's/foo/bar/'\n"
3497 #: ../edit/virt-edit.pod:216
3499 "The full power of Perl regular expressions can be used (see L<perlre(1)>). "
3500 "For example to delete root's password you could do:"
3504 #: ../edit/virt-edit.pod:219
3507 " virt-edit -d domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
3512 #: ../edit/virt-edit.pod:221
3514 "What really happens is that the snippet is evaluated as a Perl expression "
3515 "for each line of the file. The line, including the final C<\\n>, is passed "
3516 "in C<$_> and the expression should update C<$_> or leave it unchanged."
3520 #: ../edit/virt-edit.pod:226
3522 "To delete a line, set C<$_> to the empty string. For example, to delete the "
3523 "C<apache> user account from the password file you can do:"
3527 #: ../edit/virt-edit.pod:229
3530 " virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
3535 #: ../edit/virt-edit.pod:231
3537 "To insert a line, prepend or append it to C<$_>. However appending lines to "
3538 "the end of the file is rather difficult this way since there is no concept "
3539 "of \"last line of the file\" - your expression just doesn't get called "
3540 "again. You might want to use the first method (setting C<$EDITOR>) if you "
3545 #: ../edit/virt-edit.pod:237
3547 "The variable C<$lineno> contains the current line number. As is "
3548 "traditional, the first line in the file is number C<1>."
3552 #: ../edit/virt-edit.pod:240
3554 "The return value from the expression is ignored, but the expression may call "
3555 "C<die> in order to abort the whole program, leaving the original file "
3560 #: ../edit/virt-edit.pod:244
3562 "Remember when matching the end of a line that C<$_> may contain the final C<"
3563 "\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a "
3564 "newline then neither of these. Thus to match or substitute some text at the "
3565 "end of a line, use this regular expression:"
3569 #: ../edit/virt-edit.pod:249
3572 " /some text(\\r?\\n)?$/\n"
3577 #: ../edit/virt-edit.pod:251
3579 "Alternately, use the perl C<chomp> function, being careful not to chomp C<"
3580 "$_> itself (since that would remove all newlines from the file):"
3584 #: ../edit/virt-edit.pod:255
3587 " my $m = $_; chomp $m; $m =~ /some text$/\n"
3592 #: ../edit/virt-edit.pod:257 ../fish/guestfish.pod:858
3593 msgid "WINDOWS PATHS"
3597 #: ../edit/virt-edit.pod:259
3599 "C<virt-edit> has a limited ability to understand Windows drive letters and "
3600 "paths (eg. C<E:\\foo\\bar.txt>)."
3604 #: ../edit/virt-edit.pod:262
3605 msgid "If and only if the guest is running Windows then:"
3609 #: ../edit/virt-edit.pod:268
3611 "Drive letter prefixes like C<C:> are resolved against the Windows Registry "
3612 "to the correct filesystem."
3616 #: ../edit/virt-edit.pod:273
3618 "Any backslash (C<\\>) characters in the path are replaced with forward "
3619 "slashes so that libguestfs can process it."
3623 #: ../edit/virt-edit.pod:278
3625 "The path is resolved case insensitively to locate the file that should be "
3630 #: ../edit/virt-edit.pod:283
3631 msgid "There are some known shortcomings:"
3635 #: ../edit/virt-edit.pod:289
3636 msgid "Some NTFS symbolic links may not be followed correctly."
3640 #: ../edit/virt-edit.pod:293
3641 msgid "NTFS junction points that cross filesystems are not followed."
3645 #: ../edit/virt-edit.pod:299
3647 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
3648 "C<virt-edit> doesn't work."
3652 #: ../edit/virt-edit.pod:302
3653 msgid "Using C<virt-edit> is approximately equivalent to doing:"
3657 #: ../edit/virt-edit.pod:304
3660 #| " guestfish --ro -d myguest -i\n"
3663 " guestfish --rw -i -d domname edit /file\n"
3666 " guestfish --ro -d myguest -i\n"
3670 #: ../edit/virt-edit.pod:306
3672 "where C<domname> is the name of the libvirt guest, and C</file> is the full "
3677 #: ../edit/virt-edit.pod:309
3679 "The command above uses libguestfs's guest inspection feature and so does not "
3680 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
3681 "disk images that don't contain guests. To edit a file on a disk image "
3686 #: ../edit/virt-edit.pod:314
3689 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
3692 " guestfish --rw -a disk.img -m /dev/sda1 edit /file\n"
3695 " guestfish --format=raw -a disk.img --format -a another.img\n"
3699 #: ../edit/virt-edit.pod:316
3701 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
3702 "the disk image to edit, and C</file> is the full path to the file."
3706 #: ../edit/virt-edit.pod:320
3708 "C<virt-edit> cannot create new files. Use the guestfish commands C<touch>, "
3709 "C<write> or C<upload> instead:"
3713 #: ../edit/virt-edit.pod:323
3716 #| " guestfish --ro -d myguest -i\n"
3719 " guestfish --rw -i -d domname touch /newfile\n"
3722 " guestfish --ro -d myguest -i\n"
3726 #: ../edit/virt-edit.pod:325
3729 " guestfish --rw -i -d domname write /newfile \"new content\"\n"
3734 #: ../edit/virt-edit.pod:327
3737 " guestfish --rw -i -d domname upload localfile /newfile\n"
3742 #: ../edit/virt-edit.pod:329 ../fish/guestfish.pod:1086
3743 #: ../rescue/virt-rescue.pod:261 ../sparsify/virt-sparsify.pod:232
3744 #: ../src/guestfs.pod:3118 ../test-tool/libguestfs-test-tool.pod:95
3745 msgid "ENVIRONMENT VARIABLES"
3746 msgstr "ЗМІННІ СЕРЕДОВИЩА"
3749 #: ../edit/virt-edit.pod:333
3756 #: ../edit/virt-edit.pod:335
3758 "If set, this string is used as the editor. It may contain arguments, eg. C<"
3763 #: ../edit/virt-edit.pod:338
3764 msgid "If not set, C<vi> is used."
3768 #: ../edit/virt-edit.pod:356
3771 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
3772 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
3773 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
3775 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-"
3776 "tar-in(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
3777 "L<http://libguestfs.org/>, L<perl(1)>, L<perlre(1)>."
3779 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
3780 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
3781 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
3784 #: ../erlang/examples/guestfs-erlang.pod:5
3785 msgid "guestfs-erlang - How to use libguestfs from Erlang"
3789 #: ../erlang/examples/guestfs-erlang.pod:9
3792 " {ok, G} = guestfs:create(),\n"
3793 " ok = guestfs:add_drive_opts(G, Disk,\n"
3794 " [{format, \"raw\"}, {readonly, true}]),\n"
3795 " ok = guestfs:launch(G),\n"
3796 " [Device] = guestfs:list_devices(G),\n"
3797 " ok = guestfs:close(G).\n"
3802 #: ../erlang/examples/guestfs-erlang.pod:18
3804 "This manual page documents how to call libguestfs from the Erlang "
3805 "programming language. This page just documents the differences from the C "
3806 "API and gives some examples. If you are not familiar with using libguestfs, "
3807 "you also need to read L<guestfs(3)>."
3811 #: ../erlang/examples/guestfs-erlang.pod:23
3812 msgid "OPENING AND CLOSING THE HANDLE"
3816 #: ../erlang/examples/guestfs-erlang.pod:25
3818 "The Erlang bindings are implemented using an external program called C<erl-"
3819 "guestfs>. This program must be on the current PATH, or else you should "
3820 "specify the full path to the program:"
3824 #: ../erlang/examples/guestfs-erlang.pod:29
3827 #| " g = guestfs_create ();\n"
3830 " {ok, G} = guestfs:create().\n"
3833 " g = guestfs_create ();\n"
3837 #: ../erlang/examples/guestfs-erlang.pod:31
3840 " {ok, G} = guestfs:create(\"/path/to/erl-guestfs\").\n"
3845 #: ../erlang/examples/guestfs-erlang.pod:33
3846 msgid "C<G> is the libguestfs handle which you should pass to other functions."
3850 #: ../erlang/examples/guestfs-erlang.pod:36
3851 msgid "To close the handle:"
3855 #: ../erlang/examples/guestfs-erlang.pod:38
3858 #| " g = guestfs_create ();\n"
3861 " ok = guestfs:close(G).\n"
3864 " g = guestfs_create ();\n"
3868 #: ../erlang/examples/guestfs-erlang.pod:40
3870 #| msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>."
3871 msgid "FUNCTIONS WITH OPTIONAL ARGUMENTS"
3872 msgstr "Див. L</CALLS WITH OPTIONAL ARGUMENTS>."
3875 #: ../erlang/examples/guestfs-erlang.pod:42
3877 "For functions that take optional arguments, the first arguments are the non-"
3878 "optional ones. The last argument is a list of tuples supplying the "
3879 "remaining optional arguments."
3883 #: ../erlang/examples/guestfs-erlang.pod:46
3886 #| " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
3887 #| " va_list args);\n"
3890 " ok = guestfs:add_drive_opts(G, Disk,\n"
3891 " [{format, \"raw\"}, {readonly, true}]).\n"
3894 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
3899 #: ../erlang/examples/guestfs-erlang.pod:49
3900 msgid "If the last argument would be an empty list, you can also omit it:"
3904 #: ../erlang/examples/guestfs-erlang.pod:51
3907 #| " guestfs_add_drive_opts (g, filename, -1);\n"
3910 " ok = guestfs:add_drive_opts(G, Disk).\n"
3913 " guestfs_add_drive_opts (g, filename, -1);\n"
3917 #: ../erlang/examples/guestfs-erlang.pod:53
3918 msgid "RETURN VALUES AND ERRORS"
3922 #: ../erlang/examples/guestfs-erlang.pod:55
3924 "On success, most functions return a C<Result> term (which could be a list, "
3925 "string, tuple etc.). If there is nothing for the function to return, then "
3926 "the atom C<ok> is returned."
3930 #: ../erlang/examples/guestfs-erlang.pod:59
3931 msgid "On error, you would see one of the following tuples:"
3935 #: ../erlang/examples/guestfs-erlang.pod:63
3936 msgid "C<{error, Msg, Errno}>"
3940 #: ../erlang/examples/guestfs-erlang.pod:65
3941 msgid "This indicates an ordinary error from the function."
3945 #: ../erlang/examples/guestfs-erlang.pod:67
3947 "C<Msg> is the error message (string) and C<Errno> is the Unix error "
3952 #: ../erlang/examples/guestfs-erlang.pod:70
3953 msgid "C<Errno> can be zero. See L<guestfs(3)/guestfs_last_errno>."
3957 #: ../erlang/examples/guestfs-erlang.pod:72
3958 msgid "C<{unknown, Function}>"
3962 #: ../erlang/examples/guestfs-erlang.pod:74
3964 "This indicates that the function you called is not known. Generally this "
3965 "means you are mixing C<erl-guestfs> from another version of libguestfs, "
3966 "which you should not do."
3970 #: ../erlang/examples/guestfs-erlang.pod:78
3971 msgid "C<Function> is the name of the unknown function."
3975 #: ../erlang/examples/guestfs-erlang.pod:80
3976 msgid "C<{unknownarg, Arg}>"
3980 #: ../erlang/examples/guestfs-erlang.pod:82
3982 "This indicates that you called a function with optional arguments, with an "
3983 "unknown argument name."
3987 #: ../erlang/examples/guestfs-erlang.pod:85
3988 msgid "C<Arg> is the name of the unknown argument."
3992 #: ../erlang/examples/guestfs-erlang.pod:89
3993 #: ../examples/guestfs-examples.pod:25 ../java/examples/guestfs-java.pod:37
3994 #: ../ocaml/examples/guestfs-ocaml.pod:70 ../perl/examples/guestfs-perl.pod:31
3995 #: ../python/examples/guestfs-python.pod:34
3996 #: ../ruby/examples/guestfs-ruby.pod:28
3997 msgid "EXAMPLE 1: CREATE A DISK IMAGE"
4001 #: ../erlang/examples/guestfs-erlang.pod:91
4002 #: ../examples/guestfs-examples.pod:27 ../java/examples/guestfs-java.pod:39
4003 #: ../ocaml/examples/guestfs-ocaml.pod:72 ../perl/examples/guestfs-perl.pod:33
4004 #: ../python/examples/guestfs-python.pod:36
4005 #: ../ruby/examples/guestfs-ruby.pod:30
4012 #: ../erlang/examples/guestfs-erlang.pod:93
4013 #: ../examples/guestfs-examples.pod:29 ../java/examples/guestfs-java.pod:41
4014 #: ../ocaml/examples/guestfs-ocaml.pod:74 ../perl/examples/guestfs-perl.pod:35
4015 #: ../python/examples/guestfs-python.pod:38
4016 #: ../ruby/examples/guestfs-ruby.pod:32
4017 msgid "EXAMPLE 2: INSPECT A VIRTUAL MACHINE DISK IMAGE"
4021 #: ../erlang/examples/guestfs-erlang.pod:95
4022 #: ../examples/guestfs-examples.pod:31 ../java/examples/guestfs-java.pod:43
4023 #: ../ocaml/examples/guestfs-ocaml.pod:76 ../perl/examples/guestfs-perl.pod:37
4024 #: ../python/examples/guestfs-python.pod:40
4025 #: ../ruby/examples/guestfs-ruby.pod:34
4032 #: ../erlang/examples/guestfs-erlang.pod:99
4035 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
4036 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
4037 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
4039 "L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-java(3)>, L<guestfs-ocaml(3)"
4040 ">, L<guestfs-perl(3)>, L<guestfs-python(3)>, L<guestfs-recipes(1)>, "
4041 "L<guestfs-ruby(3)>, L<http://www.erlang.org/>. L<http://libguestfs.org/>."
4043 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
4044 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
4045 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
4048 #: ../erlang/examples/guestfs-erlang.pod:110
4049 #: ../examples/guestfs-examples.pod:45 ../examples/guestfs-recipes.pod:397
4050 #: ../fish/guestfish.pod:1262 ../fish/virt-copy-in.pod:60
4051 #: ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58
4052 #: ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:319
4053 #: ../inspector/virt-inspector.pod:389 ../java/examples/guestfs-java.pod:58
4054 #: ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52
4055 #: ../python/examples/guestfs-python.pod:54
4056 #: ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3255
4057 #: ../test-tool/libguestfs-test-tool.pod:106
4062 #: ../erlang/examples/guestfs-erlang.pod:112
4063 #: ../examples/guestfs-examples.pod:47 ../examples/guestfs-recipes.pod:399
4064 #: ../fish/guestfish.pod:1264 ../fish/virt-copy-in.pod:62
4065 #: ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60
4066 #: ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:321
4067 #: ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93
4068 #: ../perl/examples/guestfs-perl.pod:54
4069 #: ../python/examples/guestfs-python.pod:56
4070 #: ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3257
4071 #: ../test-tool/libguestfs-test-tool.pod:108
4072 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
4076 #: ../erlang/examples/guestfs-erlang.pod:116
4077 #: ../java/examples/guestfs-java.pod:64 ../perl/examples/guestfs-perl.pod:58
4079 #| msgid "Copyright (C) 2009 Red Hat Inc."
4080 msgid "Copyright (C) 2011 Red Hat Inc. L<http://libguestfs.org/>"
4081 msgstr "© Red Hat Inc., 2009"
4084 #: ../erlang/examples/guestfs-erlang.pod:118
4085 #: ../examples/guestfs-examples.pod:53 ../examples/guestfs-recipes.pod:405
4086 #: ../java/examples/guestfs-java.pod:66 ../ocaml/examples/guestfs-ocaml.pod:99
4087 #: ../perl/examples/guestfs-perl.pod:60
4088 #: ../python/examples/guestfs-python.pod:62
4089 #: ../ruby/examples/guestfs-ruby.pod:56
4091 "The examples in this manual page may be freely copied, modified and "
4092 "distributed without any restrictions."
4096 #: ../erlang/examples/guestfs-erlang.pod:121
4097 #: ../examples/guestfs-examples.pod:56 ../examples/guestfs-recipes.pod:408
4098 #: ../java/examples/guestfs-java.pod:69
4099 #: ../ocaml/examples/guestfs-ocaml.pod:102
4100 #: ../perl/examples/guestfs-perl.pod:63
4101 #: ../python/examples/guestfs-python.pod:65
4102 #: ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3264
4104 "This library is free software; you can redistribute it and/or modify it "
4105 "under the terms of the GNU Lesser General Public License as published by the "
4106 "Free Software Foundation; either version 2 of the License, or (at your "
4107 "option) any later version."
4111 #: ../erlang/examples/guestfs-erlang.pod:126
4112 #: ../examples/guestfs-examples.pod:61 ../examples/guestfs-recipes.pod:413
4113 #: ../java/examples/guestfs-java.pod:74
4114 #: ../ocaml/examples/guestfs-ocaml.pod:107
4115 #: ../perl/examples/guestfs-perl.pod:68
4116 #: ../python/examples/guestfs-python.pod:70
4117 #: ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3269
4119 "This library is distributed in the hope that it will be useful, but WITHOUT "
4120 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
4121 "FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License "
4126 #: ../erlang/examples/guestfs-erlang.pod:131
4127 #: ../examples/guestfs-examples.pod:66 ../examples/guestfs-recipes.pod:418
4128 #: ../java/examples/guestfs-java.pod:79
4129 #: ../ocaml/examples/guestfs-ocaml.pod:112
4130 #: ../perl/examples/guestfs-perl.pod:73
4131 #: ../python/examples/guestfs-python.pod:75
4132 #: ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3274
4134 "You should have received a copy of the GNU Lesser General Public License "
4135 "along with this library; if not, write to the Free Software Foundation, "
4136 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA"
4140 #: ../examples/guestfs-examples.pod:5
4141 msgid "guestfs-examples - Examples of using libguestfs from C"
4145 #: ../examples/guestfs-examples.pod:9 ../src/guestfs.pod:9
4148 " #include <guestfs.h>\n"
4151 " #include <guestfs.h>\n"
4155 #: ../examples/guestfs-examples.pod:11
4158 " guestfs_h *g = guestfs_create ();\n"
4159 " guestfs_add_drive_ro (g, \"disk.img\");\n"
4160 " guestfs_launch (g);\n"
4165 #: ../examples/guestfs-examples.pod:15 ../src/guestfs.pod:19
4168 " cc prog.c -o prog -lguestfs\n"
4170 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
4173 " cc prog.c -o prog -lguestfs\n"
4175 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"