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-04 19:22+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 #: ../cat/virt-cat.pod:3 ../cat/virt-filesystems.pod:3 ../cat/virt-ls.pod:3
23 #: ../df/virt-df.pod:3 ../edit/virt-edit.pod:3
24 #: ../erlang/examples/guestfs-erlang.pod:3 ../examples/guestfs-examples.pod:3
25 #: ../examples/guestfs-recipes.pod:14 ../fish/guestfish.pod:3
26 #: ../fish/virt-copy-in.pod:3 ../fish/virt-copy-out.pod:3
27 #: ../fish/virt-tar-in.pod:3 ../fish/virt-tar-out.pod:3
28 #: ../fuse/guestmount.pod:3 ../inspector/virt-inspector.pod:3
29 #: ../java/examples/guestfs-java.pod:3 ../ocaml/examples/guestfs-ocaml.pod:3
30 #: ../perl/examples/guestfs-perl.pod:3 ../python/examples/guestfs-python.pod:3
31 #: ../rescue/virt-rescue.pod:3 ../resize/virt-resize.pod:3
32 #: ../ruby/examples/guestfs-ruby.pod:3 ../sparsify/virt-sparsify.pod:3
33 #: ../src/guestfs.pod:3 ../test-tool/libguestfs-test-tool.pod:3
34 #: ../tools/virt-list-filesystems.pl:30 ../tools/virt-list-partitions.pl:30
35 #: ../tools/virt-make-fs.pl:35 ../tools/virt-tar.pl:31
36 #: ../tools/virt-win-reg.pl:35
41 #: ../cat/virt-cat.pod:5
42 msgid "virt-cat - Display files in a virtual machine"
46 #: ../cat/virt-cat.pod:7 ../cat/virt-filesystems.pod:7 ../cat/virt-ls.pod:7
47 #: ../df/virt-df.pod:7 ../edit/virt-edit.pod:7
48 #: ../erlang/examples/guestfs-erlang.pod:7 ../examples/guestfs-examples.pod:7
49 #: ../fish/guestfish.pod:7 ../fish/virt-copy-in.pod:7
50 #: ../fish/virt-copy-out.pod:7 ../fish/virt-tar-in.pod:7
51 #: ../fish/virt-tar-out.pod:7 ../fuse/guestmount.pod:7
52 #: ../inspector/virt-inspector.pod:7 ../java/examples/guestfs-java.pod:7
53 #: ../ocaml/examples/guestfs-ocaml.pod:7 ../perl/examples/guestfs-perl.pod:7
54 #: ../python/examples/guestfs-python.pod:7 ../rescue/virt-rescue.pod:7
55 #: ../resize/virt-resize.pod:7 ../ruby/examples/guestfs-ruby.pod:7
56 #: ../sparsify/virt-sparsify.pod:7 ../src/guestfs.pod:7
57 #: ../test-tool/libguestfs-test-tool.pod:7
58 #: ../tools/virt-list-filesystems.pl:34 ../tools/virt-list-partitions.pl:34
59 #: ../tools/virt-make-fs.pl:39 ../tools/virt-tar.pl:35
60 #: ../tools/virt-win-reg.pl:39
62 msgstr "КОРОТКИЙ ОПИС"
65 #: ../cat/virt-cat.pod:9
68 #| " virt-list-partitions [--options] domname\n"
71 " virt-cat [--options] -d domname file [file ...]\n"
74 " virt-list-partitions [--параметри] назва_домену\n"
78 #: ../cat/virt-cat.pod:11
81 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
84 " virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
87 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
91 #: ../cat/virt-cat.pod:13 ../edit/virt-edit.pod:15
92 #: ../inspector/virt-inspector.pod:13
97 #: ../cat/virt-cat.pod:15
100 " virt-cat domname file\n"
105 #: ../cat/virt-cat.pod:17
108 " virt-cat disk.img file\n"
113 #: ../cat/virt-cat.pod:19 ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19
114 #: ../df/virt-df.pod:21 ../edit/virt-edit.pod:27
115 #: ../erlang/examples/guestfs-erlang.pod:16
116 #: ../examples/guestfs-examples.pod:19 ../examples/guestfs-recipes.pod:18
117 #: ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19
118 #: ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21
119 #: ../fish/virt-tar-out.pod:15 ../fuse/guestmount.pod:20
120 #: ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15
121 #: ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:18
122 #: ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:29
123 #: ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15
124 #: ../sparsify/virt-sparsify.pod:11 ../src/guestfs.pod:23
125 #: ../test-tool/libguestfs-test-tool.pod:11
126 #: ../tools/virt-list-filesystems.pl:40 ../tools/virt-list-partitions.pl:40
127 #: ../tools/virt-make-fs.pl:47 ../tools/virt-tar.pl:77
128 #: ../tools/virt-win-reg.pl:63
133 #: ../cat/virt-cat.pod:21
135 "C<virt-cat> is a command line tool to display the contents of C<file> where "
136 "C<file> exists in the named virtual machine (or disk image)."
140 #: ../cat/virt-cat.pod:24
142 "Multiple filenames can be given, in which case they are concatenated "
143 "together. Each filename must be a full path, starting at the root directory "
144 "(starting with '/')."
148 #: ../cat/virt-cat.pod:28
150 "C<virt-cat> can be used to quickly view a file. To edit a file, use C<virt-"
151 "edit>. For more complex cases you should look at the L<guestfish(1)> tool "
152 "(see L</USING GUESTFISH> below)."
156 #: ../cat/virt-cat.pod:32 ../cat/virt-ls.pod:35 ../df/virt-df.pod:43
157 #: ../edit/virt-edit.pod:44 ../fish/guestfish.pod:41
158 #: ../fish/guestfish.pod:1018 ../fish/virt-copy-in.pod:29
159 #: ../fish/virt-copy-out.pod:21 ../fish/virt-tar-in.pod:30
160 #: ../fish/virt-tar-out.pod:24 ../fuse/guestmount.pod:39
161 #: ../resize/virt-resize.pod:27 ../sparsify/virt-sparsify.pod:75
162 #: ../tools/virt-tar.pl:50
167 #: ../cat/virt-cat.pod:34
169 "Display C</etc/fstab> file from inside the libvirt VM called C<mydomain>:"
173 #: ../cat/virt-cat.pod:37
176 " virt-cat -d mydomain /etc/fstab\n"
181 #: ../cat/virt-cat.pod:39
182 msgid "List syslog messages from a VM disk image file:"
186 #: ../cat/virt-cat.pod:41
189 " virt-cat -a disk.img /var/log/messages | tail\n"
194 #: ../cat/virt-cat.pod:43
195 msgid "Find out what DHCP IP address a VM acquired:"
199 #: ../cat/virt-cat.pod:45
202 " virt-cat -d mydomain /var/log/messages | \\\n"
203 " grep 'dhclient: bound to' | tail\n"
208 #: ../cat/virt-cat.pod:48
209 msgid "Find out what packages were recently installed:"
213 #: ../cat/virt-cat.pod:50
216 " virt-cat -d mydomain /var/log/yum.log | tail\n"
221 #: ../cat/virt-cat.pod:52
222 msgid "Find out who is logged on inside a virtual machine:"
226 #: ../cat/virt-cat.pod:54
229 " virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n"
235 #: ../cat/virt-cat.pod:57
236 msgid "or who was logged on:"
240 #: ../cat/virt-cat.pod:59
243 " virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n"
244 " last -f /tmp/wtmp\n"
249 #: ../cat/virt-cat.pod:62 ../cat/virt-filesystems.pod:91
250 #: ../cat/virt-ls.pod:261 ../df/virt-df.pod:59 ../edit/virt-edit.pod:62
251 #: ../fish/guestfish.pod:148 ../fish/virt-copy-in.pod:45
252 #: ../fish/virt-copy-out.pod:34 ../fish/virt-tar-in.pod:42
253 #: ../fish/virt-tar-out.pod:36 ../fuse/guestmount.pod:83
254 #: ../inspector/virt-inspector.pod:55 ../rescue/virt-rescue.pod:84
255 #: ../resize/virt-resize.pod:241 ../sparsify/virt-sparsify.pod:99
256 #: ../test-tool/libguestfs-test-tool.pod:36
257 #: ../tools/virt-list-filesystems.pl:53 ../tools/virt-list-partitions.pl:54
258 #: ../tools/virt-make-fs.pl:153 ../tools/virt-tar.pl:103
259 #: ../tools/virt-win-reg.pl:96
264 #: ../cat/virt-cat.pod:66 ../cat/virt-filesystems.pod:95
265 #: ../cat/virt-ls.pod:265 ../df/virt-df.pod:63 ../edit/virt-edit.pod:66
266 #: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:151
267 #: ../inspector/virt-inspector.pod:59 ../rescue/virt-rescue.pod:88
268 #: ../resize/virt-resize.pod:245 ../sparsify/virt-sparsify.pod:103
269 #: ../test-tool/libguestfs-test-tool.pod:40
270 #: ../tools/virt-list-filesystems.pl:61 ../tools/virt-list-partitions.pl:62
271 #: ../tools/virt-make-fs.pl:161 ../tools/virt-tar.pl:111
272 #: ../tools/virt-win-reg.pl:104
277 #: ../cat/virt-cat.pod:68 ../cat/virt-filesystems.pod:97
278 #: ../cat/virt-ls.pod:267 ../df/virt-df.pod:65 ../edit/virt-edit.pod:68
279 #: ../inspector/virt-inspector.pod:61 ../rescue/virt-rescue.pod:90
280 #: ../tools/virt-list-filesystems.pl:63 ../tools/virt-list-partitions.pl:64
281 #: ../tools/virt-make-fs.pl:163 ../tools/virt-tar.pl:113
282 #: ../tools/virt-win-reg.pl:106
283 msgid "Display brief help."
287 #: ../cat/virt-cat.pod:70 ../cat/virt-filesystems.pod:99
288 #: ../cat/virt-ls.pod:269 ../df/virt-df.pod:67 ../edit/virt-edit.pod:70
289 #: ../inspector/virt-inspector.pod:63 ../rescue/virt-rescue.pod:92
291 #| msgid "B<-f file>"
296 #: ../cat/virt-cat.pod:72 ../cat/virt-filesystems.pod:101
297 #: ../cat/virt-ls.pod:271 ../df/virt-df.pod:69 ../edit/virt-edit.pod:72
298 #: ../inspector/virt-inspector.pod:65 ../rescue/virt-rescue.pod:94
300 #| msgid "B<--add image>"
301 msgid "B<--add> file"
302 msgstr "B<--add образ>"
305 #: ../cat/virt-cat.pod:74 ../cat/virt-filesystems.pod:103
306 #: ../cat/virt-ls.pod:273 ../df/virt-df.pod:71 ../edit/virt-edit.pod:74
307 #: ../inspector/virt-inspector.pod:67 ../rescue/virt-rescue.pod:96
309 "Add I<file> which should be a disk image from a virtual machine. If the "
310 "virtual machine has multiple block devices, you must supply all of them with "
311 "separate I<-a> options."
315 #: ../cat/virt-cat.pod:78 ../cat/virt-filesystems.pod:107
316 #: ../cat/virt-ls.pod:277 ../df/virt-df.pod:75 ../edit/virt-edit.pod:78
317 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:93
318 #: ../inspector/virt-inspector.pod:71 ../rescue/virt-rescue.pod:100
320 "The format of the disk image is auto-detected. To override this and force a "
321 "particular format use the I<--format=..> option."
325 #: ../cat/virt-cat.pod:81 ../cat/virt-filesystems.pod:125
326 #: ../cat/virt-ls.pod:291 ../df/virt-df.pod:78 ../rescue/virt-rescue.pod:107
330 msgstr "B<-c адреса>"
333 #: ../cat/virt-cat.pod:83 ../cat/virt-filesystems.pod:127
334 #: ../cat/virt-ls.pod:293 ../df/virt-df.pod:80 ../rescue/virt-rescue.pod:109
336 #| msgid "B<--connect URI>"
337 msgid "B<--connect> URI"
338 msgstr "B<--connect адреса>"
341 #: ../cat/virt-cat.pod:85 ../cat/virt-filesystems.pod:129
342 #: ../cat/virt-ls.pod:295 ../df/virt-df.pod:82 ../edit/virt-edit.pod:99
343 #: ../inspector/virt-inspector.pod:78 ../rescue/virt-rescue.pod:111
344 #: ../tools/virt-list-filesystems.pl:81 ../tools/virt-list-partitions.pl:82
345 #: ../tools/virt-tar.pl:131 ../tools/virt-win-reg.pl:132
347 "If using libvirt, connect to the given I<URI>. If omitted, then we connect "
348 "to the default libvirt hypervisor."
352 #: ../cat/virt-cat.pod:88 ../cat/virt-filesystems.pod:132
353 #: ../cat/virt-ls.pod:298 ../df/virt-df.pod:85 ../rescue/virt-rescue.pod:114
355 "If you specify guest block devices directly (I<-a>), then libvirt is not "
360 #: ../cat/virt-cat.pod:91 ../cat/virt-filesystems.pod:141
361 #: ../cat/virt-ls.pod:307 ../df/virt-df.pod:94 ../edit/virt-edit.pod:105
362 #: ../inspector/virt-inspector.pod:85 ../rescue/virt-rescue.pod:117
367 #: ../cat/virt-cat.pod:93 ../cat/virt-filesystems.pod:143
368 #: ../cat/virt-ls.pod:309 ../df/virt-df.pod:96 ../edit/virt-edit.pod:107
369 #: ../inspector/virt-inspector.pod:87 ../rescue/virt-rescue.pod:119
370 msgid "B<--domain> guest"
374 #: ../cat/virt-cat.pod:95 ../cat/virt-filesystems.pod:145
375 #: ../cat/virt-ls.pod:311 ../df/virt-df.pod:98 ../edit/virt-edit.pod:109
376 #: ../inspector/virt-inspector.pod:89 ../rescue/virt-rescue.pod:121
378 "Add all the disks from the named libvirt guest. Domain UUIDs can be used "
383 #: ../cat/virt-cat.pod:98 ../cat/virt-filesystems.pod:148
384 #: ../cat/virt-ls.pod:314 ../edit/virt-edit.pod:112 ../fish/guestfish.pod:217
385 #: ../fuse/guestmount.pod:126 ../inspector/virt-inspector.pod:92
386 msgid "B<--echo-keys>"
387 msgstr "B<--echo-keys>"
390 #: ../cat/virt-cat.pod:100
392 "When prompting for keys and passphrases, virt-cat normally turns echoing off "
393 "so you cannot see what you are typing. If you are not worried about Tempest "
394 "attacks and there is no one else in the room you can specify this flag to "
395 "see what you are typing."
399 #: ../cat/virt-cat.pod:105 ../cat/virt-filesystems.pod:170
400 #: ../cat/virt-ls.pod:328 ../df/virt-df.pod:101 ../fish/guestfish.pod:233
401 #: ../fuse/guestmount.pod:133 ../inspector/virt-inspector.pod:99
402 #: ../rescue/virt-rescue.pod:124
403 msgid "B<--format=raw|qcow2|..>"
404 msgstr "B<--format=raw|qcow2|..>"
407 #: ../cat/virt-cat.pod:107 ../cat/virt-filesystems.pod:172
408 #: ../cat/virt-ls.pod:330 ../df/virt-df.pod:103 ../edit/virt-edit.pod:134
409 #: ../fish/guestfish.pod:235 ../fuse/guestmount.pod:135
410 #: ../inspector/virt-inspector.pod:101 ../rescue/virt-rescue.pod:126
415 #: ../cat/virt-cat.pod:109 ../cat/virt-filesystems.pod:174
416 #: ../cat/virt-ls.pod:332 ../df/virt-df.pod:105 ../edit/virt-edit.pod:136
417 #: ../fish/guestfish.pod:237 ../fuse/guestmount.pod:137
418 #: ../rescue/virt-rescue.pod:128
420 "The default for the I<-a> option is to auto-detect the format of the disk "
421 "image. Using this forces the disk format for I<-a> options which follow on "
422 "the command line. Using I<--format> with no argument switches back to auto-"
423 "detection for subsequent I<-a> options."
427 #: ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179
428 #: ../cat/virt-ls.pod:337 ../df/virt-df.pod:110 ../edit/virt-edit.pod:141
429 #: ../fish/guestfish.pod:242 ../fish/guestfish.pod:673
430 #: ../inspector/virt-inspector.pod:336 ../rescue/virt-rescue.pod:133
431 #: ../src/guestfs.pod:2791
436 #: ../cat/virt-cat.pod:116
439 #| " guestfish --format=raw -a disk.img\n"
442 " virt-cat --format=raw -a disk.img file\n"
445 " guestfish --format=raw -a disk.img\n"
449 #: ../cat/virt-cat.pod:118 ../cat/virt-filesystems.pod:183
450 #: ../cat/virt-ls.pod:341 ../df/virt-df.pod:114 ../edit/virt-edit.pod:145
451 #: ../fish/guestfish.pod:246 ../rescue/virt-rescue.pod:137
452 msgid "forces raw format (no auto-detection) for C<disk.img>."
456 #: ../cat/virt-cat.pod:120
459 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
462 " virt-cat --format=raw -a disk.img --format -a another.img file\n"
465 " guestfish --format=raw -a disk.img --format -a another.img\n"
469 #: ../cat/virt-cat.pod:122 ../cat/virt-filesystems.pod:187
470 #: ../cat/virt-ls.pod:345 ../df/virt-df.pod:118 ../edit/virt-edit.pod:149
471 #: ../fish/guestfish.pod:250 ../rescue/virt-rescue.pod:141
473 "forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
474 "detection for C<another.img>."
478 #: ../cat/virt-cat.pod:125 ../cat/virt-filesystems.pod:190
479 #: ../cat/virt-ls.pod:348 ../df/virt-df.pod:121 ../edit/virt-edit.pod:152
480 #: ../rescue/virt-rescue.pod:144
482 "If you have untrusted raw-format guest disk images, you should use this "
483 "option to specify the disk format. This avoids a possible security problem "
484 "with malicious guests (CVE-2010-3851)."
488 #: ../cat/virt-cat.pod:129 ../cat/virt-filesystems.pod:200
489 #: ../cat/virt-ls.pod:361 ../edit/virt-edit.pod:156 ../fish/guestfish.pod:289
490 #: ../fuse/guestmount.pod:163 ../inspector/virt-inspector.pod:114
491 msgid "B<--keys-from-stdin>"
492 msgstr "B<--keys-from-stdin>"
495 #: ../cat/virt-cat.pod:131 ../cat/virt-filesystems.pod:202
496 #: ../cat/virt-ls.pod:363 ../edit/virt-edit.pod:158 ../fish/guestfish.pod:291
497 #: ../fuse/guestmount.pod:165 ../inspector/virt-inspector.pod:116
499 "Read key or passphrase parameters from stdin. The default is to try to read "
500 "passphrases from the user by opening C</dev/tty>."
504 #: ../cat/virt-cat.pod:134 ../cat/virt-filesystems.pod:261
505 #: ../cat/virt-ls.pod:425 ../df/virt-df.pod:173 ../edit/virt-edit.pod:161
506 #: ../fish/guestfish.pod:390 ../fuse/guestmount.pod:257
507 #: ../inspector/virt-inspector.pod:119 ../rescue/virt-rescue.pod:182
508 #: ../sparsify/virt-sparsify.pod:159
513 #: ../cat/virt-cat.pod:136 ../cat/virt-filesystems.pod:263
514 #: ../cat/virt-ls.pod:427 ../df/virt-df.pod:175 ../edit/virt-edit.pod:163
515 #: ../fish/guestfish.pod:392 ../fuse/guestmount.pod:259
516 #: ../inspector/virt-inspector.pod:121 ../rescue/virt-rescue.pod:184
517 #: ../sparsify/virt-sparsify.pod:161
519 msgstr "B<--verbose>"
522 #: ../cat/virt-cat.pod:138 ../cat/virt-filesystems.pod:265
523 #: ../cat/virt-ls.pod:429 ../df/virt-df.pod:177 ../edit/virt-edit.pod:165
524 #: ../inspector/virt-inspector.pod:123 ../rescue/virt-rescue.pod:186
525 #: ../sparsify/virt-sparsify.pod:163
526 msgid "Enable verbose messages for debugging."
530 #: ../cat/virt-cat.pod:140 ../cat/virt-filesystems.pod:267
531 #: ../cat/virt-ls.pod:431 ../df/virt-df.pod:179 ../edit/virt-edit.pod:167
532 #: ../fish/guestfish.pod:397 ../fuse/guestmount.pod:263
533 #: ../inspector/virt-inspector.pod:125 ../rescue/virt-rescue.pod:188
534 #: ../resize/virt-resize.pod:484 ../sparsify/virt-sparsify.pod:165
539 #: ../cat/virt-cat.pod:142 ../cat/virt-filesystems.pod:269
540 #: ../cat/virt-ls.pod:433 ../df/virt-df.pod:181 ../edit/virt-edit.pod:169
541 #: ../fish/guestfish.pod:399 ../fuse/guestmount.pod:265
542 #: ../inspector/virt-inspector.pod:127 ../rescue/virt-rescue.pod:190
543 #: ../resize/virt-resize.pod:486 ../sparsify/virt-sparsify.pod:167
544 #: ../tools/virt-list-filesystems.pl:69 ../tools/virt-list-partitions.pl:70
545 #: ../tools/virt-make-fs.pl:169 ../tools/virt-tar.pl:119
546 #: ../tools/virt-win-reg.pl:112
548 msgstr "B<--version>"
551 #: ../cat/virt-cat.pod:144 ../cat/virt-filesystems.pod:271
552 #: ../cat/virt-ls.pod:435 ../df/virt-df.pod:183 ../edit/virt-edit.pod:171
553 #: ../inspector/virt-inspector.pod:129 ../rescue/virt-rescue.pod:192
554 #: ../resize/virt-resize.pod:488 ../sparsify/virt-sparsify.pod:169
555 #: ../tools/virt-list-filesystems.pl:71 ../tools/virt-list-partitions.pl:72
556 #: ../tools/virt-make-fs.pl:171 ../tools/virt-tar.pl:121
557 #: ../tools/virt-win-reg.pl:114
558 msgid "Display version number and exit."
559 msgstr "Показати дані щодо версії і завершити роботу."
562 #: ../cat/virt-cat.pod:146 ../cat/virt-filesystems.pod:281
563 #: ../cat/virt-ls.pod:437 ../df/virt-df.pod:185 ../edit/virt-edit.pod:173
564 #: ../fish/guestfish.pod:412 ../fuse/guestmount.pod:278
565 #: ../inspector/virt-inspector.pod:131 ../rescue/virt-rescue.pod:203
566 #: ../sparsify/virt-sparsify.pod:171 ../tools/virt-tar.pl:158
571 #: ../cat/virt-cat.pod:148 ../cat/virt-filesystems.pod:283
572 #: ../cat/virt-ls.pod:439 ../df/virt-df.pod:187 ../edit/virt-edit.pod:175
573 #: ../inspector/virt-inspector.pod:133 ../rescue/virt-rescue.pod:205
574 #: ../sparsify/virt-sparsify.pod:173
575 msgid "Enable tracing of libguestfs API calls."
579 #: ../cat/virt-cat.pod:152 ../cat/virt-ls.pod:443 ../edit/virt-edit.pod:179
580 #: ../inspector/virt-inspector.pod:137 ../rescue/virt-rescue.pod:209
581 msgid "OLD-STYLE COMMAND LINE ARGUMENTS"
585 #: ../cat/virt-cat.pod:154
586 msgid "Previous versions of virt-cat allowed you to write either:"
590 #: ../cat/virt-cat.pod:156
593 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
596 " virt-cat disk.img [disk.img ...] file\n"
599 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
603 #: ../cat/virt-cat.pod:158 ../cat/virt-ls.pod:449 ../edit/virt-edit.pod:185
604 #: ../inspector/virt-inspector.pod:143 ../rescue/virt-rescue.pod:215
611 #: ../cat/virt-cat.pod:160
614 " virt-cat guestname file\n"
619 #: ../cat/virt-cat.pod:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189
620 #: ../inspector/virt-inspector.pod:147 ../rescue/virt-rescue.pod:219
622 "whereas in this version you should use I<-a> or I<-d> respectively to avoid "
623 "the confusing case where a disk image might have the same name as a guest."
627 #: ../cat/virt-cat.pod:166 ../cat/virt-ls.pod:457 ../edit/virt-edit.pod:193
628 #: ../inspector/virt-inspector.pod:151 ../rescue/virt-rescue.pod:223
629 msgid "For compatibility the old style is still supported."
633 #: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:297
634 msgid "USING GUESTFISH"
638 #: ../cat/virt-cat.pod:170
640 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
641 "C<virt-cat> doesn't work."
645 #: ../cat/virt-cat.pod:173
646 msgid "Using C<virt-cat> is approximately equivalent to doing:"
650 #: ../cat/virt-cat.pod:175
653 #| " guestfish --ro -d myguest -i\n"
656 " guestfish --ro -i -d domname download file -\n"
659 " guestfish --ro -d myguest -i\n"
663 #: ../cat/virt-cat.pod:177
665 "where C<domname> is the name of the libvirt guest, and C<file> is the full "
666 "path to the file. Note the final C<-> (meaning \"output to stdout\")."
670 #: ../cat/virt-cat.pod:181
672 "The command above uses libguestfs's guest inspection feature and so does not "
673 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
674 "disk images that don't contain guests. To display a file from a disk image "
679 #: ../cat/virt-cat.pod:186
682 #| " guestfish [--ro] -i disk.img\n"
685 " guestfish --ro -a disk.img -m /dev/sda1 download file -\n"
688 " guestfish [--ro] -i disk.img\n"
692 #: ../cat/virt-cat.pod:188
694 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
695 "the disk image, and C<file> is the full path to the file."
699 #: ../cat/virt-cat.pod:191 ../cat/virt-filesystems.pod:365
700 #: ../cat/virt-ls.pod:483 ../df/virt-df.pod:215 ../edit/virt-edit.pod:342
701 #: ../inspector/virt-inspector.pod:352 ../rescue/virt-rescue.pod:266
702 #: ../resize/virt-resize.pod:601 ../tools/virt-list-filesystems.pl:188
703 #: ../tools/virt-list-partitions.pl:258 ../tools/virt-make-fs.pl:532
704 #: ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:733
705 msgid "SHELL QUOTING"
709 #: ../cat/virt-cat.pod:193 ../cat/virt-filesystems.pod:367
710 #: ../cat/virt-ls.pod:485 ../df/virt-df.pod:217 ../edit/virt-edit.pod:344
711 #: ../inspector/virt-inspector.pod:354 ../rescue/virt-rescue.pod:268
712 #: ../resize/virt-resize.pod:603 ../tools/virt-list-filesystems.pl:190
713 #: ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:534
714 #: ../tools/virt-tar.pl:291 ../tools/virt-win-reg.pl:741
716 "Libvirt guest names can contain arbitrary characters, some of which have "
717 "meaning to the shell such as C<#> and space. You may need to quote or "
718 "escape these characters on the command line. See the shell manual page L<sh"
723 #: ../cat/virt-cat.pod:198 ../cat/virt-filesystems.pod:372
724 #: ../cat/virt-ls.pod:490 ../df/virt-df.pod:222 ../edit/virt-edit.pod:349
725 #: ../fish/guestfish.pod:1081 ../fuse/guestmount.pod:303
726 #: ../inspector/virt-inspector.pod:375 ../resize/virt-resize.pod:608
727 #: ../sparsify/virt-sparsify.pod:227 ../test-tool/libguestfs-test-tool.pod:90
732 #: ../cat/virt-cat.pod:200 ../cat/virt-filesystems.pod:374
733 #: ../cat/virt-ls.pod:492 ../df/virt-df.pod:224 ../edit/virt-edit.pod:351
734 #: ../fuse/guestmount.pod:305 ../inspector/virt-inspector.pod:377
735 #: ../resize/virt-resize.pod:610 ../sparsify/virt-sparsify.pod:229
737 "This program returns 0 if successful, or non-zero if there was an error."
741 #: ../cat/virt-cat.pod:203 ../cat/virt-filesystems.pod:377
742 #: ../cat/virt-ls.pod:495 ../df/virt-df.pod:227 ../edit/virt-edit.pod:354
743 #: ../erlang/examples/guestfs-erlang.pod:97
744 #: ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384
745 #: ../fish/guestfish.pod:1235 ../fish/virt-copy-in.pod:50
746 #: ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47
747 #: ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:308
748 #: ../inspector/virt-inspector.pod:380 ../java/examples/guestfs-java.pod:45
749 #: ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39
750 #: ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:288
751 #: ../resize/virt-resize.pod:613 ../ruby/examples/guestfs-ruby.pod:36
752 #: ../sparsify/virt-sparsify.pod:251 ../src/guestfs.pod:3167
753 #: ../test-tool/libguestfs-test-tool.pod:100
754 #: ../tools/virt-list-filesystems.pl:195 ../tools/virt-list-partitions.pl:265
755 #: ../tools/virt-make-fs.pl:539 ../tools/virt-tar.pl:296
756 #: ../tools/virt-win-reg.pl:746
758 msgstr "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
761 #: ../cat/virt-cat.pod:205
764 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
765 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
766 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
768 "L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, L<virt-"
769 "tar-out(1)>, L<http://libguestfs.org/>."
771 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
772 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
773 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
776 #: ../cat/virt-cat.pod:212 ../cat/virt-filesystems.pod:388
777 #: ../cat/virt-ls.pod:507 ../df/virt-df.pod:235 ../edit/virt-edit.pod:368
778 #: ../rescue/virt-rescue.pod:296 ../resize/virt-resize.pod:635
779 #: ../sparsify/virt-sparsify.pod:264 ../tools/virt-list-filesystems.pl:208
780 #: ../tools/virt-list-partitions.pl:277 ../tools/virt-make-fs.pl:564
781 #: ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:772
786 #: ../cat/virt-cat.pod:214 ../cat/virt-filesystems.pod:390
787 #: ../cat/virt-ls.pod:509 ../df/virt-df.pod:237 ../edit/virt-edit.pod:370
788 #: ../inspector/virt-inspector.pod:395 ../rescue/virt-rescue.pod:298
789 #: ../resize/virt-resize.pod:637 ../sparsify/virt-sparsify.pod:266
790 #: ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279
791 #: ../tools/virt-make-fs.pl:566 ../tools/virt-tar.pl:313
792 #: ../tools/virt-win-reg.pl:774
793 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
794 msgstr "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
797 #: ../cat/virt-cat.pod:216 ../cat/virt-filesystems.pod:392
798 #: ../cat/virt-ls.pod:511 ../df/virt-df.pod:239 ../edit/virt-edit.pod:372
799 #: ../erlang/examples/guestfs-erlang.pod:114
800 #: ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401
801 #: ../fish/guestfish.pod:1265 ../fish/virt-copy-in.pod:64
802 #: ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62
803 #: ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:323
804 #: ../inspector/virt-inspector.pod:403 ../java/examples/guestfs-java.pod:62
805 #: ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56
806 #: ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:300
807 #: ../resize/virt-resize.pod:639 ../ruby/examples/guestfs-ruby.pod:52
808 #: ../sparsify/virt-sparsify.pod:268 ../src/guestfs.pod:3246
809 #: ../test-tool/libguestfs-test-tool.pod:110
810 #: ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281
811 #: ../tools/virt-make-fs.pl:568 ../tools/virt-tar.pl:315
812 #: ../tools/virt-win-reg.pl:776
814 msgstr "АВТОРСЬКІ ПРАВА"
817 #: ../cat/virt-cat.pod:218 ../inspector/virt-inspector.pod:405
818 #: ../resize/virt-resize.pod:641
820 #| msgid "Copyright (C) 2009-2010 Red Hat Inc."
821 msgid "Copyright (C) 2010-2011 Red Hat Inc."
822 msgstr "© Red Hat Inc., 2009–2010"
825 #: ../cat/virt-cat.pod:220 ../cat/virt-filesystems.pod:396
826 #: ../cat/virt-ls.pod:515 ../df/virt-df.pod:243 ../edit/virt-edit.pod:376
827 #: ../fish/guestfish.pod:1270 ../fish/virt-copy-in.pod:69
828 #: ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67
829 #: ../fish/virt-tar-out.pod:60 ../fuse/guestmount.pod:328
830 #: ../inspector/virt-inspector.pod:407 ../rescue/virt-rescue.pod:304
831 #: ../resize/virt-resize.pod:643 ../sparsify/virt-sparsify.pod:272
832 #: ../test-tool/libguestfs-test-tool.pod:115
833 #: ../tools/virt-list-filesystems.pl:216 ../tools/virt-list-partitions.pl:285
834 #: ../tools/virt-make-fs.pl:572 ../tools/virt-tar.pl:319
835 #: ../tools/virt-win-reg.pl:780
837 "This program is free software; you can redistribute it and/or modify it "
838 "under the terms of the GNU General Public License as published by the Free "
839 "Software Foundation; either version 2 of the License, or (at your option) "
844 #: ../cat/virt-cat.pod:225 ../cat/virt-filesystems.pod:401
845 #: ../cat/virt-ls.pod:520 ../df/virt-df.pod:248 ../edit/virt-edit.pod:381
846 #: ../fish/guestfish.pod:1275 ../fish/virt-copy-in.pod:74
847 #: ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72
848 #: ../fish/virt-tar-out.pod:65 ../fuse/guestmount.pod:333
849 #: ../inspector/virt-inspector.pod:412 ../rescue/virt-rescue.pod:309
850 #: ../resize/virt-resize.pod:648 ../sparsify/virt-sparsify.pod:277
851 #: ../test-tool/libguestfs-test-tool.pod:120
852 #: ../tools/virt-list-filesystems.pl:221 ../tools/virt-list-partitions.pl:290
853 #: ../tools/virt-make-fs.pl:577 ../tools/virt-tar.pl:324
854 #: ../tools/virt-win-reg.pl:785
856 "This program is distributed in the hope that it will be useful, but WITHOUT "
857 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
858 "FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for "
861 "Ця програма поширюється у сподіванні, що вона буде корисною, але БЕЗ БУДЬ-"
862 "ЯКИХ ГАРАНТІЙНИХ ЗОБОВ’ЯЗАНЬ; навіть без очевидної гарантії ПРАЦЕЗДАТНОСТІ "
863 "або ПРИДАТНОСТІ ДЛЯ ВИКОРИСТАННЯ З ПЕВНОЮ МЕТОЮ. Докладніше про це можна "
864 "дізнатися з GNU General Public License."
867 #: ../cat/virt-cat.pod:230 ../cat/virt-filesystems.pod:406
868 #: ../cat/virt-ls.pod:525 ../df/virt-df.pod:253 ../edit/virt-edit.pod:386
869 #: ../fish/guestfish.pod:1280 ../fish/virt-copy-in.pod:79
870 #: ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77
871 #: ../fish/virt-tar-out.pod:70 ../fuse/guestmount.pod:338
872 #: ../inspector/virt-inspector.pod:417 ../rescue/virt-rescue.pod:314
873 #: ../resize/virt-resize.pod:653 ../sparsify/virt-sparsify.pod:282
874 #: ../test-tool/libguestfs-test-tool.pod:125
875 #: ../tools/virt-list-filesystems.pl:226 ../tools/virt-list-partitions.pl:295
876 #: ../tools/virt-make-fs.pl:582 ../tools/virt-tar.pl:329
877 #: ../tools/virt-win-reg.pl:790
879 "You should have received a copy of the GNU General Public License along with "
880 "this program; if not, write to the Free Software Foundation, Inc., 675 Mass "
881 "Ave, Cambridge, MA 02139, USA."
885 #: ../cat/virt-filesystems.pod:5
887 "virt-filesystems - List filesystems, partitions, block devices, LVM in a "
888 "virtual machine or disk image"
892 #: ../cat/virt-filesystems.pod:9
895 #| " virt-list-partitions [--options] domname\n"
898 " virt-filesystems [--options] -d domname\n"
901 " virt-list-partitions [--параметри] назва_домену\n"
905 #: ../cat/virt-filesystems.pod:11
908 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
911 " virt-filesystems [--options] -a disk.img [-a disk.img ...]\n"
914 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
918 #: ../cat/virt-filesystems.pod:15
920 "This tool allows you to discover filesystems, partitions, logical volumes, "
921 "and their sizes in a disk image or virtual machine. It is a replacement for "
922 "L<virt-list-filesystems(1)> and L<virt-list-partitions(1)>."
926 #: ../cat/virt-filesystems.pod:20
928 "One use for this tool is from shell scripts to iterate over all filesystems "
933 #: ../cat/virt-filesystems.pod:23
936 " for fs in $(virt-filesystems -a disk.img); do\n"
943 #: ../cat/virt-filesystems.pod:27
945 "Another use is to list partitions before using another tool to modify those "
946 "partitions (such as L<virt-resize(1)>). If you are curious about what an "
947 "unknown disk image contains, use this tool along with L<virt-inspector(1)>."
951 #: ../cat/virt-filesystems.pod:32
953 "Various command line options control what this program displays. You need "
954 "to give either I<-a> or I<-d> options to specify the disk image or libvirt "
955 "guest respectively. If you just specify that then the program shows "
956 "filesystems found, one per line, like this:"
960 #: ../cat/virt-filesystems.pod:37
963 " $ virt-filesystems -a disk.img\n"
965 " /dev/vg_guest/lv_root\n"
970 #: ../cat/virt-filesystems.pod:41
972 "If you add I<-l> or I<--long> then the output includes extra information:"
976 #: ../cat/virt-filesystems.pod:44
979 " $ virt-filesystems -a disk.img -l\n"
980 " Name Type VFS Label Size\n"
981 " /dev/sda1 filesystem ext4 boot 524288000\n"
982 " /dev/vg_guest/lv_root filesystem ext4 root 10212081664\n"
987 #: ../cat/virt-filesystems.pod:49
989 "If you add I<--extra> then non-mountable (swap, unknown) filesystems are "
994 #: ../cat/virt-filesystems.pod:52
997 " $ virt-filesystems -a disk.img --extra\n"
999 " /dev/vg_guest/lv_root\n"
1000 " /dev/vg_guest/lv_swap\n"
1001 " /dev/vg_guest/lv_data\n"
1006 #: ../cat/virt-filesystems.pod:58
1008 "If you add I<--partitions> then partitions are shown instead of filesystems:"
1012 #: ../cat/virt-filesystems.pod:60
1015 " $ virt-filesystems -a disk.img --partitions\n"
1022 #: ../cat/virt-filesystems.pod:64
1024 "Similarly you can use I<--logical-volumes>, I<--volume-groups>, I<--physical-"
1025 "volumes>, I<--block-devices> to list those items."
1029 #: ../cat/virt-filesystems.pod:67
1031 "You can use these options in combination as well (if you want a combination "
1032 "including filesystems, you have to add I<--filesystems>). Notice that some "
1033 "items fall into several categories (eg. C</dev/sda1> might be both a "
1034 "partition and a filesystem). These items are listed several times. To get "
1035 "a list which includes absolutely everything that virt-filesystems knows "
1036 "about, use the I<--all> option."
1040 #: ../cat/virt-filesystems.pod:74
1042 "UUIDs (because they are quite long) are not shown by default. Add the I<--"
1043 "uuid> option to display device and filesystem UUIDs in the long output."
1047 #: ../cat/virt-filesystems.pod:78
1049 "I<--all --long --uuid> is a useful combination to display all possible "
1050 "information about everything."
1054 #: ../cat/virt-filesystems.pod:81
1057 " $ virt-filesystems -a win.img --all --long --uuid -h\n"
1058 " Name Type VFS Label Size Parent UUID\n"
1059 " /dev/sda1 filesystem ntfs System Reserved 100M - F81C92571C92112C\n"
1060 " /dev/sda2 filesystem ntfs - 20G - F2E8996AE8992E3B\n"
1061 " /dev/sda1 partition - - 100M /dev/sda -\n"
1062 " /dev/sda2 partition - - 20G /dev/sda -\n"
1063 " /dev/sda device - - 20G - -\n"
1068 #: ../cat/virt-filesystems.pod:89
1070 "For machine-readable output, use I<--csv> to get Comma-Separated Values."
1074 #: ../cat/virt-filesystems.pod:110 ../tools/virt-list-filesystems.pl:121
1076 #| msgid "B<--help>"
1081 #: ../cat/virt-filesystems.pod:112
1083 "Display everything. This is currently the same as specifying these options: "
1084 "I<--filesystems>, I<--extra>, I<--partitions>, I<--block-devices>, I<--"
1085 "logical-volumes>, I<--volume-groups>, I<--physical-volumes>. (More may be "
1086 "added to this list in future)."
1090 #: ../cat/virt-filesystems.pod:117
1092 #| msgid "See also L</is-lv>."
1093 msgid "See also I<--long>."
1094 msgstr "Див. також L</is-lv>."
1097 #: ../cat/virt-filesystems.pod:119
1099 #| msgid "B<--live>"
1100 msgid "B<--blkdevs>"
1104 #: ../cat/virt-filesystems.pod:121
1106 #| msgid "is-blockdev"
1107 msgid "B<--block-devices>"
1108 msgstr "is-blockdev"
1111 #: ../cat/virt-filesystems.pod:123
1113 #| msgid "is-blockdev"
1114 msgid "Display block devices."
1115 msgstr "is-blockdev"
1118 #: ../cat/virt-filesystems.pod:135 ../cat/virt-ls.pod:301 ../df/virt-df.pod:88
1125 #: ../cat/virt-filesystems.pod:137 ../cat/virt-ls.pod:303 ../df/virt-df.pod:90
1127 "Write out the results in CSV format (comma-separated values). This format "
1128 "can be imported easily into databases and spreadsheets, but read L</NOTE "
1129 "ABOUT CSV FORMAT> below."
1133 #: ../cat/virt-filesystems.pod:150
1135 "When prompting for keys and passphrases, virt-filesystems normally turns "
1136 "echoing off so you cannot see what you are typing. If you are not worried "
1137 "about Tempest attacks and there is no one else in the room you can specify "
1138 "this flag to see what you are typing."
1142 #: ../cat/virt-filesystems.pod:155
1149 #: ../cat/virt-filesystems.pod:157
1151 "This causes filesystems that are not ordinary, mountable filesystems to be "
1152 "displayed. This category includes swapspace, and filesystems that are empty "
1153 "or contain unknown data."
1157 #: ../cat/virt-filesystems.pod:161
1158 msgid "This option implies I<--filesystems>."
1162 #: ../cat/virt-filesystems.pod:163
1164 #| msgid "list-filesystems"
1165 msgid "B<--filesystems>"
1166 msgstr "list-filesystems"
1169 #: ../cat/virt-filesystems.pod:165
1171 "Display mountable filesystems. If no display option was selected then this "
1172 "option is implied."
1176 #: ../cat/virt-filesystems.pod:168
1177 msgid "With I<--extra>, non-mountable filesystems are shown too."
1181 #: ../cat/virt-filesystems.pod:181
1184 #| " guestfish --format=raw -a disk.img\n"
1187 " virt-filesystems --format=raw -a disk.img\n"
1190 " guestfish --format=raw -a disk.img\n"
1194 #: ../cat/virt-filesystems.pod:185
1197 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
1200 " virt-filesystems --format=raw -a disk.img --format -a another.img\n"
1203 " guestfish --format=raw -a disk.img --format -a another.img\n"
1207 #: ../cat/virt-filesystems.pod:194 ../cat/virt-ls.pod:352
1208 #: ../df/virt-df.pod:125 ../fish/guestfish.pod:156
1209 #: ../tools/virt-list-partitions.pl:109
1214 #: ../cat/virt-filesystems.pod:196 ../cat/virt-ls.pod:354
1215 #: ../df/virt-df.pod:127 ../tools/virt-list-partitions.pl:111
1217 #| msgid "B<-h> | B<--human-readable>"
1218 msgid "B<--human-readable>"
1219 msgstr "B<-h> | B<--human-readable>"
1222 #: ../cat/virt-filesystems.pod:198
1223 msgid "In I<--long> mode, display sizes in human-readable format."
1227 #: ../cat/virt-filesystems.pod:205 ../cat/virt-ls.pod:366
1228 #: ../tools/virt-list-filesystems.pl:108 ../tools/virt-list-partitions.pl:119
1233 #: ../cat/virt-filesystems.pod:207 ../cat/virt-ls.pod:368
1234 #: ../tools/virt-list-filesystems.pl:110 ../tools/virt-list-partitions.pl:121
1241 #: ../cat/virt-filesystems.pod:209
1242 msgid "Display extra columns of data (\"long format\")."
1246 #: ../cat/virt-filesystems.pod:211
1247 msgid "A title row is added unless you also specify I<--no-title>."
1251 #: ../cat/virt-filesystems.pod:213
1253 "The extra columns displayed depend on what output you select, and the "
1254 "ordering of columns may change in future versions. Use the title row, I<--"
1255 "csv> output and/or L<csvtool(1)> to match columns to data in external "
1260 #: ../cat/virt-filesystems.pod:218
1262 "Use I<-h> if you want sizes to be displayed in human-readable format. The "
1263 "default is to show raw numbers of I<bytes>."
1267 #: ../cat/virt-filesystems.pod:221
1268 msgid "Use I<--uuid> to display UUIDs too."
1272 #: ../cat/virt-filesystems.pod:223
1274 #| msgid "B<--live>"
1279 #: ../cat/virt-filesystems.pod:225
1281 #| msgid "B<--live>"
1282 msgid "B<--logvols>"
1286 #: ../cat/virt-filesystems.pod:227
1288 #| msgid "B<--live>"
1289 msgid "B<--logical-volumes>"
1293 #: ../cat/virt-filesystems.pod:229
1295 "Display LVM logical volumes. In this mode, these are displayed irrespective "
1296 "of whether the LVs contain filesystems."
1300 #: ../cat/virt-filesystems.pod:232
1302 #| msgid "B<--listen>"
1303 msgid "B<--no-title>"
1304 msgstr "B<--listen>"
1307 #: ../cat/virt-filesystems.pod:234
1308 msgid "In I<--long> mode, don't add a title row."
1312 #: ../cat/virt-filesystems.pod:236
1314 "Note that the order of the columns is not fixed, and may change in future "
1315 "versions of virt-filesystems, so using this option may give you unexpected "
1320 #: ../cat/virt-filesystems.pod:240
1322 #| msgid "B<--partition>"
1324 msgstr "B<--partition>"
1327 #: ../cat/virt-filesystems.pod:242
1329 #| msgid "B<--partition>"
1330 msgid "B<--partitions>"
1331 msgstr "B<--partition>"
1334 #: ../cat/virt-filesystems.pod:244
1336 "Display partitions. In this mode, these are displayed irrespective of "
1337 "whether the partitions contain filesystems."
1341 #: ../cat/virt-filesystems.pod:247
1348 #: ../cat/virt-filesystems.pod:249
1350 #| msgid "B<--verbose>"
1351 msgid "B<--physvols>"
1352 msgstr "B<--verbose>"
1355 #: ../cat/virt-filesystems.pod:251
1356 msgid "B<--physical-volumes>"
1360 #: ../cat/virt-filesystems.pod:253
1361 msgid "Display LVM physical volumes."
1365 #: ../cat/virt-filesystems.pod:255 ../df/virt-df.pod:163
1367 #| msgid "B<--live>"
1372 #: ../cat/virt-filesystems.pod:257
1379 #: ../cat/virt-filesystems.pod:259
1380 msgid "In I<--long> mode, display UUIDs as well."
1384 #: ../cat/virt-filesystems.pod:273
1391 #: ../cat/virt-filesystems.pod:275
1393 #| msgid "B<--verbose>"
1394 msgid "B<--volgroups>"
1395 msgstr "B<--verbose>"
1398 #: ../cat/virt-filesystems.pod:277
1400 #| msgid "B<--verbose>"
1401 msgid "B<--volume-groups>"
1402 msgstr "B<--verbose>"
1405 #: ../cat/virt-filesystems.pod:279
1406 msgid "Display LVM volume groups."
1410 #: ../cat/virt-filesystems.pod:287
1415 #: ../cat/virt-filesystems.pod:289
1417 "Note that columns in the output are subject to reordering and change in "
1418 "future versions of this tool."
1422 #: ../cat/virt-filesystems.pod:294
1427 #: ../cat/virt-filesystems.pod:296
1428 msgid "The filesystem, partition, block device or LVM name."
1432 #: ../cat/virt-filesystems.pod:298
1434 "For device and partition names these are displayed as canonical libguestfs "
1435 "names, so that for example C</dev/sda2> is the second partition on the first "
1440 #: ../cat/virt-filesystems.pod:302
1442 "If the I<--long> option is B<not> specified, then only the name column is "
1443 "shown in the output."
1447 #: ../cat/virt-filesystems.pod:305
1449 #| msgid "B<-N type>"
1454 #: ../cat/virt-filesystems.pod:307
1455 msgid "The object type, for example C<filesystem>, C<lv>, C<device> etc."
1459 #: ../cat/virt-filesystems.pod:309
1464 #: ../cat/virt-filesystems.pod:311
1466 "If there is a filesystem, then this column displays the filesystem type if "
1467 "one could be detected, eg. C<ext4>."
1471 #: ../cat/virt-filesystems.pod:314
1476 #: ../cat/virt-filesystems.pod:316
1478 "If the object has a label (used for identifying and mounting filesystems) "
1479 "then this column contains the label."
1483 #: ../cat/virt-filesystems.pod:319
1485 #| msgid "B<part_size>"
1487 msgstr "B<part_size>"
1490 #: ../cat/virt-filesystems.pod:321
1492 "The size of the object in bytes. If the I<--human> option is used then the "
1493 "size is displayed in a human-readable form."
1497 #: ../cat/virt-filesystems.pod:324
1502 #: ../cat/virt-filesystems.pod:326
1504 "The parent column records the parent relationship between objects. For "
1505 "example, if the object is a partition, then this column contains the name of "
1506 "the containing device. If the object is a logical volume, then this column "
1507 "is the name of the volume group."
1511 #: ../cat/virt-filesystems.pod:331
1516 #: ../cat/virt-filesystems.pod:333
1518 "If the object has a UUID (used for identifying and mounting filesystems and "
1519 "block devices) then this column contains the UUID as a string."
1523 #: ../cat/virt-filesystems.pod:337
1524 msgid "The UUID is only displayed if the I<--uuid> option is given."
1528 #: ../cat/virt-filesystems.pod:341 ../cat/virt-ls.pod:459
1529 #: ../df/virt-df.pod:191
1530 msgid "NOTE ABOUT CSV FORMAT"
1534 #: ../cat/virt-filesystems.pod:343 ../cat/virt-ls.pod:461
1535 #: ../df/virt-df.pod:193
1537 "Comma-separated values (CSV) is a deceptive format. It I<seems> like it "
1538 "should be easy to parse, but it is definitely not easy to parse."
1542 #: ../cat/virt-filesystems.pod:346 ../cat/virt-ls.pod:464
1543 #: ../df/virt-df.pod:196
1545 "Myth: Just split fields at commas. Reality: This does I<not> work "
1546 "reliably. This example has two columns:"
1550 #: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:467
1551 #: ../df/virt-df.pod:199
1554 " \"foo,bar\",baz\n"
1559 #: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:469
1560 #: ../df/virt-df.pod:201
1562 "Myth: Read the file one line at a time. Reality: This does I<not> work "
1563 "reliably. This example has one row:"
1567 #: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:472
1568 #: ../df/virt-df.pod:204
1577 #: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:475
1578 #: ../df/virt-df.pod:207
1580 "For shell scripts, use C<csvtool> (L<http://merjis.com/developers/csv> also "
1581 "packaged in major Linux distributions)."
1585 #: ../cat/virt-filesystems.pod:360 ../cat/virt-ls.pod:478
1586 #: ../df/virt-df.pod:210
1588 "For other languages, use a CSV processing library (eg. C<Text::CSV> for Perl "
1589 "or Python's built-in csv library)."
1593 #: ../cat/virt-filesystems.pod:363 ../cat/virt-ls.pod:481
1594 #: ../df/virt-df.pod:213
1595 msgid "Most spreadsheets and databases can import CSV directly."
1599 #: ../cat/virt-filesystems.pod:379
1602 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
1603 #| "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
1604 #| "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
1606 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-df(1)>, L<virt-list-"
1607 "filesystems(1)>, L<virt-list-partitions(1)>, L<csvtool(1)>, L<http://"
1610 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
1611 "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
1612 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
1615 #: ../cat/virt-filesystems.pod:394 ../tools/virt-make-fs.pl:570
1616 #: ../tools/virt-win-reg.pl:778
1617 msgid "Copyright (C) 2010 Red Hat Inc."
1621 #: ../cat/virt-ls.pod:5
1622 msgid "virt-ls - List files in a virtual machine"
1626 #: ../cat/virt-ls.pod:9
1629 " virt-ls [--options] -d domname directory [directory ...]\n"
1634 #: ../cat/virt-ls.pod:11
1637 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
1640 " virt-ls [--options] -a disk.img [-a disk.img ...] directory [directory ...]\n"
1643 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
1647 #: ../cat/virt-ls.pod:13 ../df/virt-df.pod:15 ../rescue/virt-rescue.pod:13
1652 #: ../cat/virt-ls.pod:15
1655 #| " virt-list-partitions [--options] domname\n"
1658 " virt-ls [--options] domname directory\n"
1661 " virt-list-partitions [--параметри] назва_домену\n"
1665 #: ../cat/virt-ls.pod:17
1668 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
1671 " virt-ls [--options] disk.img [disk.img ...] directory\n"
1674 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
1678 #: ../cat/virt-ls.pod:21
1680 "C<virt-ls> lists filenames, file sizes, checksums, extended attributes and "
1681 "more from a virtual machine or disk image."
1685 #: ../cat/virt-ls.pod:24
1687 "Multiple directory names can be given, in which case the output from each is "
1692 #: ../cat/virt-ls.pod:27
1694 "To list directories from a libvirt guest use the I<-d> option to specify the "
1695 "name of the guest. For a disk image, use the I<-a> option."
1699 #: ../cat/virt-ls.pod:31
1701 "C<virt-ls> can do many simple file listings. For more complicated cases you "
1702 "may need to use L<guestfish(1)>, or write a program directly to the L<guestfs"
1707 #: ../cat/virt-ls.pod:37
1708 msgid "Get a list of all files and directories in a virtual machine:"
1712 #: ../cat/virt-ls.pod:39
1715 #| " guestfish --ro -d myguest -i\n"
1718 " virt-ls -R -d guest /\n"
1721 " guestfish --ro -d myguest -i\n"
1725 #: ../cat/virt-ls.pod:41
1726 msgid "List all setuid or setgid programs in a Linux virtual machine:"
1730 #: ../cat/virt-ls.pod:43
1733 " virt-ls -lR -d guest / | grep '^- [42]'\n"
1738 #: ../cat/virt-ls.pod:45
1739 msgid "List all public-writable directories in a Linux virtual machine:"
1743 #: ../cat/virt-ls.pod:47
1746 " virt-ls -lR -d guest / | grep '^d ...7'\n"
1751 #: ../cat/virt-ls.pod:49
1752 msgid "List all Unix domain sockets in a Linux virtual machine:"
1756 #: ../cat/virt-ls.pod:51
1759 " virt-ls -lR -d guest / | grep '^s'\n"
1764 #: ../cat/virt-ls.pod:53
1765 msgid "List all regular files with filenames ending in '.png':"
1769 #: ../cat/virt-ls.pod:55
1772 " virt-ls -lR -d guest / | grep -i '^-.*\\.png$'\n"
1777 #: ../cat/virt-ls.pod:57
1778 msgid "To display files larger than 10MB in home directories:"
1782 #: ../cat/virt-ls.pod:59
1785 " virt-ls -lR -d guest /home | awk '$3 > 10*1024*1024'\n"
1790 #: ../cat/virt-ls.pod:61
1791 msgid "Find everything modified in the last 7 days:"
1795 #: ../cat/virt-ls.pod:63
1798 " virt-ls -lR -d guest --time-days / | awk '$6 <= 7'\n"
1803 #: ../cat/virt-ls.pod:65
1804 msgid "Find regular files modified in the last 24 hours:"
1808 #: ../cat/virt-ls.pod:67
1811 " virt-ls -lR -d guest --time-days / | grep '^-' | awk '$6 < 1'\n"
1816 #: ../cat/virt-ls.pod:69
1817 msgid "DIFFERENCES IN SNAPSHOTS AND BACKING FILES"
1821 #: ../cat/virt-ls.pod:71
1823 "Find the differences between files in a guest and an earlier snapshot of the "
1828 #: ../cat/virt-ls.pod:74
1831 " virt-ls -lR -a snapshot.img / --uids --time-t > old\n"
1832 " virt-ls -lR -a current.img / --uids --time-t > new\n"
1833 " diff -u old new | less\n"
1838 #: ../cat/virt-ls.pod:78
1840 "The commands above won't find files where the content has changed but the "
1841 "metadata (eg. file size and modification date) is the same. To do that, you "
1842 "need to add the I<--checksum> parameter to both C<virt-ls> commands. I<--"
1843 "checksum> can be quite slow since it has to read and compute a checksum of "
1844 "every regular file in the virtual machine."
1848 #: ../cat/virt-ls.pod:84
1849 msgid "OUTPUT MODES"
1853 #: ../cat/virt-ls.pod:86
1855 "C<virt-ls> has four output modes, controlled by different combinations of "
1856 "the I<-l> and I<-R> options."
1860 #: ../cat/virt-ls.pod:89
1861 msgid "SIMPLE LISTING"
1865 #: ../cat/virt-ls.pod:91
1866 msgid "A simple listing is like the ordinary L<ls(1)> command:"
1870 #: ../cat/virt-ls.pod:93
1873 " $ virt-ls -d guest /\n"
1881 #: ../cat/virt-ls.pod:98
1884 msgid "LONG LISTING"
1888 #: ../cat/virt-ls.pod:100
1890 "With the I<-l> (I<--long>) option, the output is like the C<ls -l> command "
1891 "(more specifically, like the C<guestfs_ll> function)."
1895 #: ../cat/virt-ls.pod:103
1898 " $ virt-ls -l -d guest /\n"
1900 " dr-xr-xr-x. 2 root root 4096 2009-08-25 19:06 bin\n"
1901 " dr-xr-xr-x. 5 root root 3072 2009-08-25 19:06 boot\n"
1907 #: ../cat/virt-ls.pod:109
1909 "Note that while this is useful for displaying a directory, do not try "
1910 "parsing this output in another program. Use L</RECURSIVE LONG LISTING> "
1915 #: ../cat/virt-ls.pod:113
1916 msgid "RECURSIVE LISTING"
1920 #: ../cat/virt-ls.pod:115
1922 "With the I<-R> (I<--recursive>) option, C<virt-ls> lists the names of files "
1923 "and directories recursively:"
1927 #: ../cat/virt-ls.pod:118
1930 " $ virt-ls -R -d guest /tmp\n"
1938 #: ../cat/virt-ls.pod:123
1940 "To generate this output, C<virt-ls> runs the C<guestfs_find0> function and "
1941 "converts C<\\0> characters to C<\\n>."
1945 #: ../cat/virt-ls.pod:126
1946 msgid "RECURSIVE LONG LISTING"
1950 #: ../cat/virt-ls.pod:128
1952 "Using I<-lR> options together changes the output to display directories "
1953 "recursively, with file stats, and optionally other features such as "
1954 "checksums and extended attributes."
1958 #: ../cat/virt-ls.pod:132
1960 "Most of the interesting features of C<virt-ls> are only available when using "
1965 #: ../cat/virt-ls.pod:135
1967 "The fields are normally space-separated. Filenames are B<not> quoted, so "
1968 "you cannot use the output in another program (because filenames can contain "
1969 "spaces and other unsafe characters). If the guest was untrusted and someone "
1970 "knew you were using C<virt-ls> to analyze the guest, they could play tricks "
1971 "on you by creating filenames with embedded newline characters. To B<safely> "
1972 "parse the output in another program, use the I<--csv> (Comma-Separated "
1977 #: ../cat/virt-ls.pod:143
1979 "Note that this output format is completely unrelated to the C<ls -lR> "
1984 #: ../cat/virt-ls.pod:146
1987 " $ virt-ls -lR -d guest /bin\n"
1988 " d 0555 4096 /bin\n"
1989 " - 0755 123 /bin/alsaunmute\n"
1990 " - 0755 28328 /bin/arch\n"
1991 " l 0777 4 /bin/awk -> gawk\n"
1992 " - 0755 27216 /bin/basename\n"
1993 " - 0755 943360 /bin/bash\n"
1999 #: ../cat/virt-ls.pod:155
2000 msgid "These basic fields are always shown:"
2004 #: ../cat/virt-ls.pod:159
2011 #: ../cat/virt-ls.pod:161
2013 "The file type, one of: C<-> (regular file), C<d> (directory), C<c> "
2014 "(character device), C<b> (block device), C<p> (named pipe), C<l> (symbolic "
2015 "link), C<s> (socket) or C<u> (unknown)."
2019 #: ../cat/virt-ls.pod:171
2026 #: ../cat/virt-ls.pod:173
2027 msgid "The Unix permissions, displayed as a 4 digit octal number."
2031 #: ../cat/virt-ls.pod:175
2038 #: ../cat/virt-ls.pod:177
2040 "The size of the file. This is shown in bytes unless I<-h> or I<--human-"
2041 "readable> option is given, in which case this is shown as a human-readable "
2046 #: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4245
2051 #: ../cat/virt-ls.pod:183
2052 msgid "The full path of the file or directory."
2056 #: ../cat/virt-ls.pod:185
2063 #: ../cat/virt-ls.pod:187
2064 msgid "For symbolic links only, the link target."
2068 #: ../cat/virt-ls.pod:191
2070 "In I<-lR> mode, additional command line options enable the display of more "
2075 #: ../cat/virt-ls.pod:194
2077 "With the I<--uids> flag, these additional fields are displayed before the "
2082 #: ../cat/virt-ls.pod:199
2089 #: ../cat/virt-ls.pod:201
2096 #: ../cat/virt-ls.pod:203
2098 "The UID and GID of the owner of the file (displayed numerically). Note "
2099 "these only make sense in the context of a Unix-like guest."
2103 #: ../cat/virt-ls.pod:208
2104 msgid "With the I<--times> flag, these additional fields are displayed:"
2108 #: ../cat/virt-ls.pod:212
2115 #: ../cat/virt-ls.pod:214
2116 msgid "The time of last access."
2120 #: ../cat/virt-ls.pod:216
2127 #: ../cat/virt-ls.pod:218
2128 msgid "The time of last modification."
2132 #: ../cat/virt-ls.pod:220
2139 #: ../cat/virt-ls.pod:222
2140 msgid "The time of last status change."
2144 #: ../cat/virt-ls.pod:226
2146 "The time fields are displayed as string dates and times, unless one of the "
2147 "I<--time-t>, I<--time-relative> or I<--time-days> flags is given."
2151 #: ../cat/virt-ls.pod:229
2152 msgid "With the I<--extra-stats> flag, these additional fields are displayed:"
2156 #: ../cat/virt-ls.pod:233
2158 #| msgid "zero-device"
2160 msgstr "zero-device"
2163 #: ../cat/virt-ls.pod:235
2165 "The device containing the file (displayed as major:minor). This may not "
2166 "match devices as known to the guest."
2170 #: ../cat/virt-ls.pod:238
2175 #: ../cat/virt-ls.pod:240
2176 msgid "The inode number."
2180 #: ../cat/virt-ls.pod:242
2187 #: ../cat/virt-ls.pod:244
2188 msgid "The number of hard links."
2192 #: ../cat/virt-ls.pod:246
2197 #: ../cat/virt-ls.pod:248
2199 "For block and char special files, the device (displayed as major:minor)."
2203 #: ../cat/virt-ls.pod:251
2205 #| msgid "C<blocksize>"
2207 msgstr "C<blocksize>"
2210 #: ../cat/virt-ls.pod:253
2211 msgid "The number of 512 byte blocks allocated to the file."
2215 #: ../cat/virt-ls.pod:257
2217 "With the I<--checksum> flag, the checksum of the file contents is shown "
2218 "(only for regular files). Computing file checksums can take a considerable "
2223 #: ../cat/virt-ls.pod:280
2226 msgid "B<--checksum>"
2230 #: ../cat/virt-ls.pod:282
2231 msgid "B<--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512>"
2235 #: ../cat/virt-ls.pod:284
2237 "Display checksum over file contents for regular files. With no argument, "
2238 "this defaults to using I<md5>. Using an argument, you can select the "
2239 "checksum type to use."
2243 #: ../cat/virt-ls.pod:288 ../cat/virt-ls.pod:325 ../cat/virt-ls.pod:358
2244 #: ../cat/virt-ls.pod:391 ../cat/virt-ls.pod:401 ../cat/virt-ls.pod:408
2245 #: ../cat/virt-ls.pod:415 ../cat/virt-ls.pod:422
2247 "This option only has effect in I<-lR> output mode. See L</RECURSIVE LONG "
2252 #: ../cat/virt-ls.pod:316
2254 "When prompting for keys and passphrases, virt-ls normally turns echoing off "
2255 "so you cannot see what you are typing. If you are not worried about Tempest "
2256 "attacks and there is no one else in the room you can specify this flag to "
2257 "see what you are typing."
2261 #: ../cat/virt-ls.pod:321
2263 #| msgid "B<--no-dest-paths>"
2264 msgid "B<--extra-stats>"
2265 msgstr "B<--no-dest-paths>"
2268 #: ../cat/virt-ls.pod:323
2269 msgid "Display extra stats."
2273 #: ../cat/virt-ls.pod:339
2276 #| " guestfish --format=raw -a disk.img\n"
2279 " virt-ls --format=raw -a disk.img /dir\n"
2282 " guestfish --format=raw -a disk.img\n"
2286 #: ../cat/virt-ls.pod:343
2289 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
2292 " virt-ls --format=raw -a disk.img --format -a another.img /dir\n"
2295 " guestfish --format=raw -a disk.img --format -a another.img\n"
2299 #: ../cat/virt-ls.pod:356
2300 msgid "Display file sizes in human-readable format."
2304 #: ../cat/virt-ls.pod:370
2309 #: ../cat/virt-ls.pod:372
2311 #| msgid "B<--live>"
2312 msgid "B<--recursive>"
2316 #: ../cat/virt-ls.pod:374
2318 "Select the mode. With neither of these options, C<virt-ls> produces a "
2319 "simple, flat list of the files in the named directory. See L</SIMPLE "
2324 #: ../cat/virt-ls.pod:378
2326 "C<virt-ls -l> produces a \"long listing\", which shows more detail. See L</"
2331 #: ../cat/virt-ls.pod:381
2333 "C<virt-ls -R> produces a recursive list of files starting at the named "
2334 "directory. See L</RECURSIVE LISTING>."
2338 #: ../cat/virt-ls.pod:384
2340 "C<virt-ls -lR> produces a recursive long listing which can be more easily "
2341 "parsed. See L</RECURSIVE LONG LISTING>."
2345 #: ../cat/virt-ls.pod:387
2347 #| msgid "B<--live>"
2352 #: ../cat/virt-ls.pod:389
2353 msgid "Display time fields."
2357 #: ../cat/virt-ls.pod:394
2359 #| msgid "B<--echo-keys>"
2360 msgid "B<--time-days>"
2361 msgstr "B<--echo-keys>"
2364 #: ../cat/virt-ls.pod:396
2365 msgid "Display time fields as days before now (negative if in the future)."
2369 #: ../cat/virt-ls.pod:398
2371 "Note that C<0> in output means \"up to 1 day before now\", or that the age "
2372 "of the file is between 0 and 86399 seconds."
2376 #: ../cat/virt-ls.pod:404
2378 #| msgid "B<--live>"
2379 msgid "B<--time-relative>"
2383 #: ../cat/virt-ls.pod:406
2384 msgid "Display time fields as seconds before now (negative if in the future)."
2388 #: ../cat/virt-ls.pod:411
2390 #| msgid "I<--timeout N>"
2392 msgstr "I<--timeout N>"
2395 #: ../cat/virt-ls.pod:413
2396 msgid "Display time fields as seconds since the Unix epoch."
2400 #: ../cat/virt-ls.pod:418
2407 #: ../cat/virt-ls.pod:420
2408 msgid "Display UID and GID fields."
2412 #: ../cat/virt-ls.pod:445
2413 msgid "Previous versions of virt-ls allowed you to write either:"
2417 #: ../cat/virt-ls.pod:447
2420 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
2423 " virt-ls disk.img [disk.img ...] /dir\n"
2426 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
2430 #: ../cat/virt-ls.pod:451
2433 #| " inspect-get-hostname root\n"
2436 " virt-ls guestname /dir\n"
2439 " inspect-get-hostname корінь\n"
2443 #: ../cat/virt-ls.pod:497
2446 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
2447 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
2448 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
2450 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-out(1)>, L<virt-"
2451 "tar-out(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
2452 "L<http://libguestfs.org/>."
2454 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
2455 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
2456 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
2459 #: ../cat/virt-ls.pod:513 ../df/virt-df.pod:241 ../edit/virt-edit.pod:374
2460 #: ../rescue/virt-rescue.pod:302
2462 #| msgid "Copyright (C) 2009-2010 Red Hat Inc."
2463 msgid "Copyright (C) 2009-2011 Red Hat Inc."
2464 msgstr "© Red Hat Inc., 2009–2010"
2467 #: ../df/virt-df.pod:5
2468 msgid "virt-df - Display free space on virtual filesystems"
2472 #: ../df/virt-df.pod:9
2475 #| " virt-list-partitions [--options] domname\n"
2478 " virt-df [--options]\n"
2481 " virt-list-partitions [--параметри] назва_домену\n"
2485 #: ../df/virt-df.pod:11
2488 #| " virt-list-partitions [--options] domname\n"
2491 " virt-df [--options] -d domname\n"
2494 " virt-list-partitions [--параметри] назва_домену\n"
2498 #: ../df/virt-df.pod:13
2501 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
2504 " virt-df [--options] -a disk.img [-a disk.img ...]\n"
2507 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
2511 #: ../df/virt-df.pod:17
2514 #| " virt-list-partitions [--options] domname\n"
2517 " virt-df [--options] domname\n"
2520 " virt-list-partitions [--параметри] назва_домену\n"
2524 #: ../df/virt-df.pod:19
2527 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
2530 " virt-df [--options] disk.img [disk.img ...]\n"
2533 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
2537 #: ../df/virt-df.pod:23
2539 "C<virt-df> is a command line tool to display free space on virtual machine "
2540 "filesystems. Unlike other tools, it doesn't just display the size of disk "
2541 "allocated to a virtual machine, but can look inside disk images to see how "
2542 "much space is really being used."
2546 #: ../df/virt-df.pod:28
2548 "If used without any I<-a> or I<-d> arguments, C<virt-df> checks with libvirt "
2549 "to get a list of all active and inactive guests, and performs a C<df>-type "
2550 "operation on each one in turn, printing out the results."
2554 #: ../df/virt-df.pod:32
2556 "If any I<-a> or I<-d> arguments are specified, C<virt-df> performs a C<df>-"
2557 "type operation on either the single named libvirt domain, or on the disk "
2558 "image(s) listed on the command line (which must all belong to a single VM). "
2559 "In this mode (with arguments), C<virt-df> will I<only work for a single "
2560 "guest>. If you want to run on multiple guests, then you have to invoke "
2561 "C<virt-df> multiple times."
2565 #: ../df/virt-df.pod:39
2567 "Use the I<--csv> option to get a format which can be easily parsed by other "
2568 "programs. Other options are similar to the standard L<df(1)> command."
2572 #: ../df/virt-df.pod:45
2574 "Show disk usage for a single libvirt guest called C<F14x64>. Make the "
2575 "output human-readable:"
2579 #: ../df/virt-df.pod:48
2582 " # virt-df -d F14x64 -h\n"
2583 " Filesystem Size Used Available Use%\n"
2584 " F14x64:/dev/sda1 484M 66M 393M 14%\n"
2585 " F14x64:/dev/vg_f13x64/lv_root 7.4G 3.4G 4.0G 46%\n"
2590 #: ../df/virt-df.pod:53
2591 msgid "Show disk usage for a disk image file called C<test.img>:"
2595 #: ../df/virt-df.pod:55
2598 " $ virt-df -a test1.img\n"
2599 " Filesystem 1K-blocks Used Available Use%\n"
2600 " test1.img:/dev/sda1 99099 1551 92432 2%\n"
2605 #: ../df/virt-df.pod:112
2608 #| " guestfish --format=raw -a disk.img\n"
2611 " virt-df --format=raw -a disk.img\n"
2614 " guestfish --format=raw -a disk.img\n"
2618 #: ../df/virt-df.pod:116
2621 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
2624 " virt-df --format=raw -a disk.img --format -a another.img\n"
2627 " guestfish --format=raw -a disk.img --format -a another.img\n"
2631 #: ../df/virt-df.pod:129
2632 msgid "Print sizes in human-readable format."
2636 #: ../df/virt-df.pod:131
2637 msgid "You are not allowed to use I<-h> and I<--csv> at the same time."
2641 #: ../df/virt-df.pod:133 ../fish/guestfish.pod:258 ../fuse/guestmount.pod:155
2646 #: ../df/virt-df.pod:135
2648 #| msgid "B<--live>"
2653 #: ../df/virt-df.pod:137
2654 msgid "Print inodes instead of blocks."
2658 #: ../df/virt-df.pod:139
2660 #| msgid "B<--merge>"
2661 msgid "B<--one-per-guest>"
2665 #: ../df/virt-df.pod:141
2667 "Run one libguestfs appliance per guest. Normally C<virt-df> will add the "
2668 "disks from several guests to a single libguestfs appliance."
2672 #: ../df/virt-df.pod:144
2673 msgid "You might use this option in the following circumstances:"
2677 #: ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266
2678 #: ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276
2679 #: ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291
2680 #: ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102
2681 #: ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132
2682 #: ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227
2683 #: ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235
2684 #: ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243
2685 #: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20
2686 #: ../fish/guestfish-actions.pod:390 ../fish/guestfish-actions.pod:398
2687 #: ../fish/guestfish-actions.pod:405 ../fish/guestfish-actions.pod:412
2688 #: ../fish/guestfish-actions.pod:1139 ../fish/guestfish-actions.pod:1143
2689 #: ../fish/guestfish-actions.pod:1147 ../fish/guestfish-actions.pod:1151
2690 #: ../fish/guestfish-actions.pod:1159 ../fish/guestfish-actions.pod:1163
2691 #: ../fish/guestfish-actions.pod:1167 ../fish/guestfish-actions.pod:1177
2692 #: ../fish/guestfish-actions.pod:1181 ../fish/guestfish-actions.pod:1185
2693 #: ../fish/guestfish-actions.pod:1275 ../fish/guestfish-actions.pod:1279
2694 #: ../fish/guestfish-actions.pod:1284 ../fish/guestfish-actions.pod:1289
2695 #: ../fish/guestfish-actions.pod:1331 ../fish/guestfish-actions.pod:1335
2696 #: ../fish/guestfish-actions.pod:1340 ../fish/guestfish-actions.pod:1596
2697 #: ../fish/guestfish-actions.pod:1603 ../fish/guestfish-actions.pod:1610
2698 #: ../fish/guestfish-actions.pod:2005 ../fish/guestfish-actions.pod:2011
2699 #: ../fish/guestfish-actions.pod:2019 ../fish/guestfish-actions.pod:2026
2700 #: ../fish/guestfish-actions.pod:2033 ../fish/guestfish.pod:445
2701 #: ../fish/guestfish.pod:449 ../fish/guestfish.pod:453
2702 #: ../fish/guestfish.pod:457 ../inspector/virt-inspector.pod:393
2703 #: ../inspector/virt-inspector.pod:397 ../resize/virt-resize.pod:282
2704 #: ../resize/virt-resize.pod:286 ../resize/virt-resize.pod:295
2705 #: ../resize/virt-resize.pod:301 ../sparsify/virt-sparsify.pod:32
2706 #: ../sparsify/virt-sparsify.pod:39 ../sparsify/virt-sparsify.pod:43
2707 #: ../sparsify/virt-sparsify.pod:49 ../sparsify/virt-sparsify.pod:54
2708 #: ../sparsify/virt-sparsify.pod:58 ../sparsify/virt-sparsify.pod:64
2709 #: ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:29
2710 #: ../src/guestfs-actions.pod:588 ../src/guestfs-actions.pod:596
2711 #: ../src/guestfs-actions.pod:603 ../src/guestfs-actions.pod:610
2712 #: ../src/guestfs-actions.pod:1778 ../src/guestfs-actions.pod:1782
2713 #: ../src/guestfs-actions.pod:1786 ../src/guestfs-actions.pod:1790
2714 #: ../src/guestfs-actions.pod:1798 ../src/guestfs-actions.pod:1802
2715 #: ../src/guestfs-actions.pod:1806 ../src/guestfs-actions.pod:1816
2716 #: ../src/guestfs-actions.pod:1820 ../src/guestfs-actions.pod:1824
2717 #: ../src/guestfs-actions.pod:1962 ../src/guestfs-actions.pod:1966
2718 #: ../src/guestfs-actions.pod:1971 ../src/guestfs-actions.pod:1976
2719 #: ../src/guestfs-actions.pod:2037 ../src/guestfs-actions.pod:2041
2720 #: ../src/guestfs-actions.pod:2046 ../src/guestfs-actions.pod:2461
2721 #: ../src/guestfs-actions.pod:2468 ../src/guestfs-actions.pod:2475
2722 #: ../src/guestfs-actions.pod:3012 ../src/guestfs-actions.pod:3018
2723 #: ../src/guestfs-actions.pod:3026 ../src/guestfs-actions.pod:3033
2724 #: ../src/guestfs-actions.pod:3040 ../src/guestfs.pod:388
2725 #: ../src/guestfs.pod:393 ../src/guestfs.pod:398 ../src/guestfs.pod:402
2726 #: ../src/guestfs.pod:407 ../src/guestfs.pod:411 ../src/guestfs.pod:416
2727 #: ../src/guestfs.pod:421 ../src/guestfs.pod:1094 ../src/guestfs.pod:1098
2728 #: ../src/guestfs.pod:1102 ../src/guestfs.pod:1107 ../src/guestfs.pod:1115
2729 #: ../src/guestfs.pod:1134 ../src/guestfs.pod:1142 ../src/guestfs.pod:1164
2730 #: ../src/guestfs.pod:1168 ../src/guestfs.pod:1172 ../src/guestfs.pod:1176
2731 #: ../src/guestfs.pod:1180 ../src/guestfs.pod:1184 ../src/guestfs.pod:1674
2732 #: ../src/guestfs.pod:1679 ../src/guestfs.pod:1683 ../src/guestfs.pod:1785
2733 #: ../src/guestfs.pod:1790 ../src/guestfs.pod:1794 ../src/guestfs.pod:1804
2734 #: ../src/guestfs.pod:2093 ../src/guestfs.pod:2098 ../src/guestfs.pod:2104
2735 #: ../src/guestfs.pod:2112 ../src/guestfs.pod:2559 ../src/guestfs.pod:2565
2736 #: ../src/guestfs.pod:2570 ../src/guestfs.pod:2576 ../src/guestfs.pod:2959
2737 #: ../src/guestfs.pod:2964 ../src/guestfs.pod:2968 ../src/guestfs.pod:2972
2738 #: ../src/guestfs.pod:2976 ../src/guestfs.pod:2990 ../src/guestfs.pod:2995
2739 #: ../src/guestfs.pod:3223 ../src/guestfs.pod:3227 ../src/guestfs.pod:3231
2740 #: ../src/guestfs.pod:3235 ../tools/virt-win-reg.pl:197
2741 #: ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208
2742 #: ../tools/virt-win-reg.pl:710 ../tools/virt-win-reg.pl:716
2743 #: ../tools/virt-win-reg.pl:722
2748 #: ../df/virt-df.pod:150
2750 "If you think an untrusted guest might actively try to exploit the libguestfs "
2751 "appliance kernel, then this prevents one guest from interfering with the "
2752 "stats printed for another guest."
2756 #: ../df/virt-df.pod:156
2758 "If the kernel has a bug which stops it from accessing a filesystem in one "
2759 "guest (see for example RHBZ#635373) then this allows libguestfs to continue "
2760 "and report stats for further guests."
2764 #: ../df/virt-df.pod:165
2766 "Print UUIDs instead of names. This is useful for following a guest even "
2767 "when the guest is migrated or renamed, or when two guests happen to have the "
2772 #: ../df/virt-df.pod:169
2774 "Note that only domains that we fetch from libvirt come with UUIDs. For disk "
2775 "images, we still print the disk image name even when this option is "
2780 #: ../df/virt-df.pod:229
2782 "L<df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<http://"
2787 #: ../edit/virt-edit.pod:5
2788 msgid "virt-edit - Edit a file in a virtual machine"
2792 #: ../edit/virt-edit.pod:9
2795 #| " virt-list-partitions [--options] domname\n"
2798 " virt-edit [--options] -d domname file [file ...]\n"
2801 " virt-list-partitions [--параметри] назва_домену\n"
2805 #: ../edit/virt-edit.pod:11
2808 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
2811 " virt-edit [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
2814 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
2818 #: ../edit/virt-edit.pod:13
2821 " virt-edit [-d domname|-a disk.img] file -e 'expr'\n"
2826 #: ../edit/virt-edit.pod:17
2829 " virt-edit domname file\n"
2834 #: ../edit/virt-edit.pod:19 ../edit/virt-edit.pod:183
2837 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
2840 " virt-edit disk.img [disk.img ...] file\n"
2843 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
2847 #: ../edit/virt-edit.pod:21 ../fish/guestfish.pod:23
2848 #: ../fish/virt-copy-in.pod:13 ../fish/virt-tar-in.pod:15
2849 #: ../fuse/guestmount.pod:15 ../rescue/virt-rescue.pod:19
2850 #: ../tools/virt-tar.pl:64 ../tools/virt-win-reg.pl:51
2852 msgstr "ПОПЕРЕДЖЕННЯ"
2855 #: ../edit/virt-edit.pod:23
2857 "You must I<not> use C<virt-edit> on live virtual machines. If you do this, "
2858 "you risk disk corruption in the VM. C<virt-edit> tries to stop you from "
2859 "doing this, but doesn't catch all cases."
2863 #: ../edit/virt-edit.pod:29
2865 "C<virt-edit> is a command line tool to edit C<file> where each C<file> "
2866 "exists in the named virtual machine (or disk image)."
2870 #: ../edit/virt-edit.pod:32
2872 "Multiple filenames can be given, in which case they are each edited in "
2873 "turn. Each filename must be a full path, starting at the root directory "
2874 "(starting with '/')."
2878 #: ../edit/virt-edit.pod:36
2879 msgid "If you want to just view a file, use L<virt-cat(1)>."
2883 #: ../edit/virt-edit.pod:38
2885 "For more complex cases you should look at the L<guestfish(1)> tool (see L</"
2886 "USING GUESTFISH> below)."
2890 #: ../edit/virt-edit.pod:41
2892 "C<virt-edit> cannot be used to create a new file. L<guestfish(1)> can do "
2893 "that and much more."
2897 #: ../edit/virt-edit.pod:46
2898 msgid "Edit the named files interactively:"
2902 #: ../edit/virt-edit.pod:48
2905 " virt-edit -d mydomain /boot/grub/grub.conf\n"
2910 #: ../edit/virt-edit.pod:50
2913 " virt-edit -d mydomain /etc/passwd\n"
2918 #: ../edit/virt-edit.pod:52
2919 msgid "For Windows guests, some Windows paths are understood:"
2923 #: ../edit/virt-edit.pod:54
2926 " virt-edit -d mywindomain 'c:\\autoexec.bat'\n"
2931 #: ../edit/virt-edit.pod:56
2933 "If Perl is installed, you can also edit files non-interactively (see L</NON-"
2934 "INTERACTIVE EDITING> below). To change the init default level to 5:"
2938 #: ../edit/virt-edit.pod:60
2941 " virt-edit -d mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
2946 #: ../edit/virt-edit.pod:81
2947 msgid "B<-b> extension"
2951 #: ../edit/virt-edit.pod:83
2952 msgid "B<--backup> extension"
2956 #: ../edit/virt-edit.pod:85
2958 "Create a backup of the original file I<in the guest disk image>. The backup "
2959 "has the original filename with C<extension> added."
2963 #: ../edit/virt-edit.pod:88
2965 "Usually the first character of C<extension> would be a dot C<.> so you would "
2970 #: ../edit/virt-edit.pod:91
2973 " virt-edit -b .orig [etc]\n"
2978 #: ../edit/virt-edit.pod:93
2979 msgid "By default, no backup file is made."
2983 #: ../edit/virt-edit.pod:95 ../fish/guestfish.pod:181
2984 #: ../fuse/guestmount.pod:96 ../inspector/virt-inspector.pod:74
2985 #: ../tools/virt-list-filesystems.pl:77 ../tools/virt-list-partitions.pl:78
2986 #: ../tools/virt-tar.pl:127 ../tools/virt-win-reg.pl:128
2988 msgstr "B<-c адреса>"
2991 #: ../edit/virt-edit.pod:97 ../fish/guestfish.pod:183
2992 #: ../fuse/guestmount.pod:98 ../inspector/virt-inspector.pod:76
2993 #: ../tools/virt-list-filesystems.pl:79 ../tools/virt-list-partitions.pl:80
2994 #: ../tools/virt-tar.pl:129 ../tools/virt-win-reg.pl:130
2995 msgid "B<--connect URI>"
2996 msgstr "B<--connect адреса>"
2999 #: ../edit/virt-edit.pod:102 ../tools/virt-list-filesystems.pl:84
3000 #: ../tools/virt-list-partitions.pl:85 ../tools/virt-tar.pl:134
3001 #: ../tools/virt-win-reg.pl:135
3003 "If you specify guest block devices directly, then libvirt is not used at all."
3007 #: ../edit/virt-edit.pod:114
3009 "When prompting for keys and passphrases, virt-edit normally turns echoing "
3010 "off so you cannot see what you are typing. If you are not worried about "
3011 "Tempest attacks and there is no one else in the room you can specify this "
3012 "flag to see what you are typing."
3016 #: ../edit/virt-edit.pod:119
3021 #: ../edit/virt-edit.pod:121
3023 #| msgid "B<--help>"
3024 msgid "B<--expr> EXPR"
3028 #: ../edit/virt-edit.pod:123
3030 "Instead of launching the external editor, non-interactively apply the Perl "
3031 "expression C<EXPR> to each line in the file. See L</NON-INTERACTIVE "
3036 #: ../edit/virt-edit.pod:127
3038 "Be careful to properly quote the expression to prevent it from being altered "
3043 #: ../edit/virt-edit.pod:130
3044 msgid "Note that this option is only available when Perl 5 is installed."
3048 #: ../edit/virt-edit.pod:132
3050 #| msgid "B<--format=raw|qcow2|..>"
3051 msgid "B<--format> raw|qcow2|..."
3052 msgstr "B<--format=raw|qcow2|..>"
3055 #: ../edit/virt-edit.pod:143
3058 #| " guestfish --format=raw -a disk.img\n"
3061 " virt-edit --format=raw -a disk.img file\n"
3064 " guestfish --format=raw -a disk.img\n"
3068 #: ../edit/virt-edit.pod:147
3071 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
3074 " virt-edit --format=raw -a disk.img --format -a another.img file\n"
3077 " guestfish --format=raw -a disk.img --format -a another.img\n"
3081 #: ../edit/virt-edit.pod:181
3082 msgid "Previous versions of virt-edit allowed you to write either:"
3086 #: ../edit/virt-edit.pod:187
3089 #| " edit filename\n"
3092 " virt-edit guestname file\n"
3095 " edit назва_файла\n"
3099 #: ../edit/virt-edit.pod:195
3100 msgid "NON-INTERACTIVE EDITING"
3104 #: ../edit/virt-edit.pod:197
3106 "C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
3107 "administrator can interactively edit the file."
3111 #: ../edit/virt-edit.pod:200
3113 "There are two ways also to use C<virt-edit> from scripts in order to make "
3114 "automated edits to files. (Note that although you I<can> use C<virt-edit> "
3115 "like this, it's less error-prone to write scripts directly using the "
3116 "libguestfs API and Augeas for configuration file editing.)"
3120 #: ../edit/virt-edit.pod:206
3122 "The first method is to temporarily set C<$EDITOR> to any script or program "
3123 "you want to run. The script is invoked as C<$EDITOR tmpfile> and it should "
3124 "update C<tmpfile> in place however it likes."
3128 #: ../edit/virt-edit.pod:210
3130 "The second method is to use the I<-e> parameter of C<virt-edit> to run a "
3131 "short Perl snippet in the style of L<sed(1)>. For example to replace all "
3132 "instances of C<foo> with C<bar> in a file:"
3136 #: ../edit/virt-edit.pod:214
3139 " virt-edit -d domname filename -e 's/foo/bar/'\n"
3144 #: ../edit/virt-edit.pod:216
3146 "The full power of Perl regular expressions can be used (see L<perlre(1)>). "
3147 "For example to delete root's password you could do:"
3151 #: ../edit/virt-edit.pod:219
3154 " virt-edit -d domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
3159 #: ../edit/virt-edit.pod:221
3161 "What really happens is that the snippet is evaluated as a Perl expression "
3162 "for each line of the file. The line, including the final C<\\n>, is passed "
3163 "in C<$_> and the expression should update C<$_> or leave it unchanged."
3167 #: ../edit/virt-edit.pod:226
3169 "To delete a line, set C<$_> to the empty string. For example, to delete the "
3170 "C<apache> user account from the password file you can do:"
3174 #: ../edit/virt-edit.pod:229
3177 " virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
3182 #: ../edit/virt-edit.pod:231
3184 "To insert a line, prepend or append it to C<$_>. However appending lines to "
3185 "the end of the file is rather difficult this way since there is no concept "
3186 "of \"last line of the file\" - your expression just doesn't get called "
3187 "again. You might want to use the first method (setting C<$EDITOR>) if you "
3192 #: ../edit/virt-edit.pod:237
3194 "The variable C<$lineno> contains the current line number. As is "
3195 "traditional, the first line in the file is number C<1>."
3199 #: ../edit/virt-edit.pod:240
3201 "The return value from the expression is ignored, but the expression may call "
3202 "C<die> in order to abort the whole program, leaving the original file "
3207 #: ../edit/virt-edit.pod:244
3209 "Remember when matching the end of a line that C<$_> may contain the final C<"
3210 "\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a "
3211 "newline then neither of these. Thus to match or substitute some text at the "
3212 "end of a line, use this regular expression:"
3216 #: ../edit/virt-edit.pod:249
3219 " /some text(\\r?\\n)?$/\n"
3224 #: ../edit/virt-edit.pod:251
3226 "Alternately, use the perl C<chomp> function, being careful not to chomp C<"
3227 "$_> itself (since that would remove all newlines from the file):"
3231 #: ../edit/virt-edit.pod:255
3234 " my $m = $_; chomp $m; $m =~ /some text$/\n"
3239 #: ../edit/virt-edit.pod:257 ../fish/guestfish.pod:858
3240 msgid "WINDOWS PATHS"
3244 #: ../edit/virt-edit.pod:259
3246 "C<virt-edit> has a limited ability to understand Windows drive letters and "
3247 "paths (eg. C<E:\\foo\\bar.txt>)."
3251 #: ../edit/virt-edit.pod:262
3252 msgid "If and only if the guest is running Windows then:"
3256 #: ../edit/virt-edit.pod:268
3258 "Drive letter prefixes like C<C:> are resolved against the Windows Registry "
3259 "to the correct filesystem."
3263 #: ../edit/virt-edit.pod:273
3265 "Any backslash (C<\\>) characters in the path are replaced with forward "
3266 "slashes so that libguestfs can process it."
3270 #: ../edit/virt-edit.pod:278
3272 "The path is resolved case insensitively to locate the file that should be "
3277 #: ../edit/virt-edit.pod:283
3278 msgid "There are some known shortcomings:"
3282 #: ../edit/virt-edit.pod:289
3283 msgid "Some NTFS symbolic links may not be followed correctly."
3287 #: ../edit/virt-edit.pod:293
3288 msgid "NTFS junction points that cross filesystems are not followed."
3292 #: ../edit/virt-edit.pod:299
3294 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
3295 "C<virt-edit> doesn't work."
3299 #: ../edit/virt-edit.pod:302
3300 msgid "Using C<virt-edit> is approximately equivalent to doing:"
3304 #: ../edit/virt-edit.pod:304
3307 #| " guestfish --ro -d myguest -i\n"
3310 " guestfish --rw -i -d domname edit /file\n"
3313 " guestfish --ro -d myguest -i\n"
3317 #: ../edit/virt-edit.pod:306
3319 "where C<domname> is the name of the libvirt guest, and C</file> is the full "
3324 #: ../edit/virt-edit.pod:309
3326 "The command above uses libguestfs's guest inspection feature and so does not "
3327 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
3328 "disk images that don't contain guests. To edit a file on a disk image "
3333 #: ../edit/virt-edit.pod:314
3336 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
3339 " guestfish --rw -a disk.img -m /dev/sda1 edit /file\n"
3342 " guestfish --format=raw -a disk.img --format -a another.img\n"
3346 #: ../edit/virt-edit.pod:316
3348 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
3349 "the disk image to edit, and C</file> is the full path to the file."
3353 #: ../edit/virt-edit.pod:320
3355 "C<virt-edit> cannot create new files. Use the guestfish commands C<touch>, "
3356 "C<write> or C<upload> instead:"
3360 #: ../edit/virt-edit.pod:323
3363 #| " guestfish --ro -d myguest -i\n"
3366 " guestfish --rw -i -d domname touch /newfile\n"
3369 " guestfish --ro -d myguest -i\n"
3373 #: ../edit/virt-edit.pod:325
3376 " guestfish --rw -i -d domname write /newfile \"new content\"\n"
3381 #: ../edit/virt-edit.pod:327
3384 " guestfish --rw -i -d domname upload localfile /newfile\n"
3389 #: ../edit/virt-edit.pod:329 ../fish/guestfish.pod:1086
3390 #: ../rescue/virt-rescue.pod:261 ../sparsify/virt-sparsify.pod:232
3391 #: ../src/guestfs.pod:3106 ../test-tool/libguestfs-test-tool.pod:95
3392 msgid "ENVIRONMENT VARIABLES"
3393 msgstr "ЗМІННІ СЕРЕДОВИЩА"
3396 #: ../edit/virt-edit.pod:333
3403 #: ../edit/virt-edit.pod:335
3405 "If set, this string is used as the editor. It may contain arguments, eg. C<"
3410 #: ../edit/virt-edit.pod:338
3411 msgid "If not set, C<vi> is used."
3415 #: ../edit/virt-edit.pod:356
3418 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
3419 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
3420 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
3422 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-"
3423 "tar-in(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
3424 "L<http://libguestfs.org/>, L<perl(1)>, L<perlre(1)>."
3426 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
3427 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
3428 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
3431 #: ../erlang/examples/guestfs-erlang.pod:5
3432 msgid "guestfs-erlang - How to use libguestfs from Erlang"
3436 #: ../erlang/examples/guestfs-erlang.pod:9
3439 " {ok, G} = guestfs:create(),\n"
3440 " ok = guestfs:add_drive_opts(G, Disk,\n"
3441 " [{format, \"raw\"}, {readonly, true}]),\n"
3442 " ok = guestfs:launch(G),\n"
3443 " [Device] = guestfs:list_devices(G),\n"
3444 " ok = guestfs:close(G).\n"
3449 #: ../erlang/examples/guestfs-erlang.pod:18
3451 "This manual page documents how to call libguestfs from the Erlang "
3452 "programming language. This page just documents the differences from the C "
3453 "API and gives some examples. If you are not familiar with using libguestfs, "
3454 "you also need to read L<guestfs(3)>."
3458 #: ../erlang/examples/guestfs-erlang.pod:23
3459 msgid "OPENING AND CLOSING THE HANDLE"
3463 #: ../erlang/examples/guestfs-erlang.pod:25
3465 "The Erlang bindings are implemented using an external program called C<erl-"
3466 "guestfs>. This program must be on the current PATH, or else you should "
3467 "specify the full path to the program:"
3471 #: ../erlang/examples/guestfs-erlang.pod:29
3474 #| " g = guestfs_create ();\n"
3477 " {ok, G} = guestfs:create().\n"
3480 " g = guestfs_create ();\n"
3484 #: ../erlang/examples/guestfs-erlang.pod:31
3487 " {ok, G} = guestfs:create(\"/path/to/erl-guestfs\").\n"
3492 #: ../erlang/examples/guestfs-erlang.pod:33
3493 msgid "C<G> is the libguestfs handle which you should pass to other functions."
3497 #: ../erlang/examples/guestfs-erlang.pod:36
3498 msgid "To close the handle:"
3502 #: ../erlang/examples/guestfs-erlang.pod:38
3505 #| " g = guestfs_create ();\n"
3508 " ok = guestfs:close(G).\n"
3511 " g = guestfs_create ();\n"
3515 #: ../erlang/examples/guestfs-erlang.pod:40
3517 #| msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>."
3518 msgid "FUNCTIONS WITH OPTIONAL ARGUMENTS"
3519 msgstr "Див. L</CALLS WITH OPTIONAL ARGUMENTS>."
3522 #: ../erlang/examples/guestfs-erlang.pod:42
3524 "For functions that take optional arguments, the first arguments are the non-"
3525 "optional ones. The last argument is a list of tuples supplying the "
3526 "remaining optional arguments."
3530 #: ../erlang/examples/guestfs-erlang.pod:46
3533 #| " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
3534 #| " va_list args);\n"
3537 " ok = guestfs:add_drive_opts(G, Disk,\n"
3538 " [{format, \"raw\"}, {readonly, true}]).\n"
3541 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
3546 #: ../erlang/examples/guestfs-erlang.pod:49
3547 msgid "If the last argument would be an empty list, you can also omit it:"
3551 #: ../erlang/examples/guestfs-erlang.pod:51
3554 #| " guestfs_add_drive_opts (g, filename, -1);\n"
3557 " ok = guestfs:add_drive_opts(G, Disk).\n"
3560 " guestfs_add_drive_opts (g, filename, -1);\n"
3564 #: ../erlang/examples/guestfs-erlang.pod:53
3565 msgid "RETURN VALUES AND ERRORS"
3569 #: ../erlang/examples/guestfs-erlang.pod:55
3571 "On success, most functions return a C<Result> term (which could be a list, "
3572 "string, tuple etc.). If there is nothing for the function to return, then "
3573 "the atom C<ok> is returned."
3577 #: ../erlang/examples/guestfs-erlang.pod:59
3578 msgid "On error, you would see one of the following tuples:"
3582 #: ../erlang/examples/guestfs-erlang.pod:63
3583 msgid "C<{error, Msg, Errno}>"
3587 #: ../erlang/examples/guestfs-erlang.pod:65
3588 msgid "This indicates an ordinary error from the function."
3592 #: ../erlang/examples/guestfs-erlang.pod:67
3594 "C<Msg> is the error message (string) and C<Errno> is the Unix error "
3599 #: ../erlang/examples/guestfs-erlang.pod:70
3600 msgid "C<Errno> can be zero. See L<guestfs(3)/guestfs_last_errno>."
3604 #: ../erlang/examples/guestfs-erlang.pod:72
3605 msgid "C<{unknown, Function}>"
3609 #: ../erlang/examples/guestfs-erlang.pod:74
3611 "This indicates that the function you called is not known. Generally this "
3612 "means you are mixing C<erl-guestfs> from another version of libguestfs, "
3613 "which you should not do."
3617 #: ../erlang/examples/guestfs-erlang.pod:78
3618 msgid "C<Function> is the name of the unknown function."
3622 #: ../erlang/examples/guestfs-erlang.pod:80
3623 msgid "C<{unknownarg, Arg}>"
3627 #: ../erlang/examples/guestfs-erlang.pod:82
3629 "This indicates that you called a function with optional arguments, with an "
3630 "unknown argument name."
3634 #: ../erlang/examples/guestfs-erlang.pod:85
3635 msgid "C<Arg> is the name of the unknown argument."
3639 #: ../erlang/examples/guestfs-erlang.pod:89
3640 #: ../examples/guestfs-examples.pod:25 ../java/examples/guestfs-java.pod:37
3641 #: ../ocaml/examples/guestfs-ocaml.pod:70 ../perl/examples/guestfs-perl.pod:31
3642 #: ../python/examples/guestfs-python.pod:34
3643 #: ../ruby/examples/guestfs-ruby.pod:28
3644 msgid "EXAMPLE 1: CREATE A DISK IMAGE"
3648 #: ../erlang/examples/guestfs-erlang.pod:91
3649 #: ../examples/guestfs-examples.pod:27 ../java/examples/guestfs-java.pod:39
3650 #: ../ocaml/examples/guestfs-ocaml.pod:72 ../perl/examples/guestfs-perl.pod:33
3651 #: ../python/examples/guestfs-python.pod:36
3652 #: ../ruby/examples/guestfs-ruby.pod:30
3659 #: ../erlang/examples/guestfs-erlang.pod:93
3660 #: ../examples/guestfs-examples.pod:29 ../java/examples/guestfs-java.pod:41
3661 #: ../ocaml/examples/guestfs-ocaml.pod:74 ../perl/examples/guestfs-perl.pod:35
3662 #: ../python/examples/guestfs-python.pod:38
3663 #: ../ruby/examples/guestfs-ruby.pod:32
3664 msgid "EXAMPLE 2: INSPECT A VIRTUAL MACHINE DISK IMAGE"
3668 #: ../erlang/examples/guestfs-erlang.pod:95
3669 #: ../examples/guestfs-examples.pod:31 ../java/examples/guestfs-java.pod:43
3670 #: ../ocaml/examples/guestfs-ocaml.pod:76 ../perl/examples/guestfs-perl.pod:37
3671 #: ../python/examples/guestfs-python.pod:40
3672 #: ../ruby/examples/guestfs-ruby.pod:34
3679 #: ../erlang/examples/guestfs-erlang.pod:99
3682 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
3683 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
3684 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
3686 "L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-java(3)>, L<guestfs-ocaml(3)"
3687 ">, L<guestfs-perl(3)>, L<guestfs-python(3)>, L<guestfs-recipes(1)>, "
3688 "L<guestfs-ruby(3)>, L<http://www.erlang.org/>. L<http://libguestfs.org/>."
3690 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
3691 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
3692 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
3695 #: ../erlang/examples/guestfs-erlang.pod:110
3696 #: ../examples/guestfs-examples.pod:45 ../examples/guestfs-recipes.pod:397
3697 #: ../fish/guestfish.pod:1261 ../fish/virt-copy-in.pod:60
3698 #: ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58
3699 #: ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:319
3700 #: ../inspector/virt-inspector.pod:389 ../java/examples/guestfs-java.pod:58
3701 #: ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52
3702 #: ../python/examples/guestfs-python.pod:54
3703 #: ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3242
3704 #: ../test-tool/libguestfs-test-tool.pod:106
3709 #: ../erlang/examples/guestfs-erlang.pod:112
3710 #: ../examples/guestfs-examples.pod:47 ../examples/guestfs-recipes.pod:399
3711 #: ../fish/guestfish.pod:1263 ../fish/virt-copy-in.pod:62
3712 #: ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60
3713 #: ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:321
3714 #: ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93
3715 #: ../perl/examples/guestfs-perl.pod:54
3716 #: ../python/examples/guestfs-python.pod:56
3717 #: ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3244
3718 #: ../test-tool/libguestfs-test-tool.pod:108
3719 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
3723 #: ../erlang/examples/guestfs-erlang.pod:116
3724 #: ../java/examples/guestfs-java.pod:64 ../perl/examples/guestfs-perl.pod:58
3726 #| msgid "Copyright (C) 2009 Red Hat Inc."
3727 msgid "Copyright (C) 2011 Red Hat Inc. L<http://libguestfs.org/>"
3728 msgstr "© Red Hat Inc., 2009"
3731 #: ../erlang/examples/guestfs-erlang.pod:118
3732 #: ../examples/guestfs-examples.pod:53 ../examples/guestfs-recipes.pod:405
3733 #: ../java/examples/guestfs-java.pod:66 ../ocaml/examples/guestfs-ocaml.pod:99
3734 #: ../perl/examples/guestfs-perl.pod:60
3735 #: ../python/examples/guestfs-python.pod:62
3736 #: ../ruby/examples/guestfs-ruby.pod:56
3738 "The examples in this manual page may be freely copied, modified and "
3739 "distributed without any restrictions."
3743 #: ../erlang/examples/guestfs-erlang.pod:121
3744 #: ../examples/guestfs-examples.pod:56 ../examples/guestfs-recipes.pod:408
3745 #: ../java/examples/guestfs-java.pod:69
3746 #: ../ocaml/examples/guestfs-ocaml.pod:102
3747 #: ../perl/examples/guestfs-perl.pod:63
3748 #: ../python/examples/guestfs-python.pod:65
3749 #: ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3251
3751 "This library is free software; you can redistribute it and/or modify it "
3752 "under the terms of the GNU Lesser General Public License as published by the "
3753 "Free Software Foundation; either version 2 of the License, or (at your "
3754 "option) any later version."
3758 #: ../erlang/examples/guestfs-erlang.pod:126
3759 #: ../examples/guestfs-examples.pod:61 ../examples/guestfs-recipes.pod:413
3760 #: ../java/examples/guestfs-java.pod:74
3761 #: ../ocaml/examples/guestfs-ocaml.pod:107
3762 #: ../perl/examples/guestfs-perl.pod:68
3763 #: ../python/examples/guestfs-python.pod:70
3764 #: ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3256
3766 "This library is distributed in the hope that it will be useful, but WITHOUT "
3767 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
3768 "FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License "
3773 #: ../erlang/examples/guestfs-erlang.pod:131
3774 #: ../examples/guestfs-examples.pod:66 ../examples/guestfs-recipes.pod:418
3775 #: ../java/examples/guestfs-java.pod:79
3776 #: ../ocaml/examples/guestfs-ocaml.pod:112
3777 #: ../perl/examples/guestfs-perl.pod:73
3778 #: ../python/examples/guestfs-python.pod:75
3779 #: ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3261
3781 "You should have received a copy of the GNU Lesser General Public License "
3782 "along with this library; if not, write to the Free Software Foundation, "
3783 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA"
3787 #: ../examples/guestfs-examples.pod:5
3788 msgid "guestfs-examples - Examples of using libguestfs from C"
3792 #: ../examples/guestfs-examples.pod:9 ../src/guestfs.pod:9
3795 " #include <guestfs.h>\n"
3798 " #include <guestfs.h>\n"
3802 #: ../examples/guestfs-examples.pod:11
3805 " guestfs_h *g = guestfs_create ();\n"
3806 " guestfs_add_drive_ro (g, \"disk.img\");\n"
3807 " guestfs_launch (g);\n"
3812 #: ../examples/guestfs-examples.pod:15 ../src/guestfs.pod:19
3815 " cc prog.c -o prog -lguestfs\n"
3817 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
3820 " cc prog.c -o prog -lguestfs\n"
3822 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
3826 #: ../examples/guestfs-examples.pod:21
3828 "This manual page contains examples of calling libguestfs from the C "
3829 "programming language. If you are not familiar with using libguestfs, you "
3830 "also need to read L<guestfs(3)>."
3834 #: ../examples/guestfs-examples.pod:35
3837 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
3838 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
3839 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
3841 "L<guestfs(3)>, L<guestfs-erlang(3)>, L<guestfs-java(3)>, L<guestfs-ocaml(3)"
3842 ">, L<guestfs-perl(3)>, L<guestfs-python(3)>, L<guestfs-recipes(1)>, "
3843 "L<guestfs-ruby(3)>, L<http://libguestfs.org/>."
3845 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
3846 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
3847 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
3850 #: ../examples/guestfs-examples.pod:51 ../ocaml/examples/guestfs-ocaml.pod:97
3851 #: ../python/examples/guestfs-python.pod:60
3852 #: ../ruby/examples/guestfs-ruby.pod:54
3854 #| msgid "Copyright (C) 2009 Red Hat Inc."
3855 msgid "Copyright (C) 2010 Red Hat Inc. L<http://libguestfs.org/>"
3856 msgstr "© Red Hat Inc., 2009"
3859 #: ../examples/guestfs-recipes.pod:3 ../examples/guestfs-recipes.pod:12
3864 #: ../examples/guestfs-recipes.pod:5
3866 "pod2man and pod2html have differing bugs which makes it hard to write URLs "
3867 "here. The only way which works for both sorts of output is to just write "
3868 "the URL directly. Do NOT use L<...> for URLs."
3872 #: ../examples/guestfs-recipes.pod:9
3874 "We break with tradition here and don't use ALL CAPS for the section "
3875 "headings, as this makes them much easier to read."
3879 #: ../examples/guestfs-recipes.pod:16
3880 msgid "guestfs-recipes - libguestfs, guestfish and virt tools recipes"
3884 #: ../examples/guestfs-recipes.pod:20
3886 "This page contains recipes for and links to things you can do using "
3887 "libguestfs, L<guestfish(1)> and the virt tools."
3891 #: ../examples/guestfs-recipes.pod:23
3892 msgid "Audit a virtual machine for setuid files"
3896 #: ../examples/guestfs-recipes.pod:25
3898 "The link below contains a small program which can be used to audit a Linux "
3899 "virtual machine to see what setuid and setgid files it contains."
3903 #: ../examples/guestfs-recipes.pod:28
3905 "https://rwmj.wordpress.com/2010/12/15/tip-audit-virtual-machine-for-setuid-"
3910 #: ../examples/guestfs-recipes.pod:30
3911 msgid "Change the background image in a Windows XP VM"
3915 #: ../examples/guestfs-recipes.pod:32
3917 "The links below explain how to use L<guestfish(1)> to change the background "
3918 "image for a user of a Windows XP VM. Unfortunately the technique appears to "
3919 "be substantially different for each version of Windows."
3923 #: ../examples/guestfs-recipes.pod:37
3925 "https://lists.fedoraproject.org/pipermail/virt/2011-May/002655.html https://"
3926 "lists.fedoraproject.org/pipermail/virt/2011-May/002658.html"
3930 #: ../examples/guestfs-recipes.pod:40
3931 msgid "Cloning a virtual machine (Linux)"
3935 #: ../examples/guestfs-recipes.pod:42
3937 "The guestfish technique described in the link below works well for most "
3938 "Linux VMs. Depending on the Linux distro you may need to change the paths "
3943 #: ../examples/guestfs-recipes.pod:46
3945 "https://rwmj.wordpress.com/2010/09/24/tip-my-procedure-for-cloning-a-fedora-"
3950 #: ../examples/guestfs-recipes.pod:48
3952 "Avoid L<virt-clone(1)>. Currently what to do about virt-clone is under "
3957 #: ../examples/guestfs-recipes.pod:51
3958 msgid "https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html"
3962 #: ../examples/guestfs-recipes.pod:53
3963 msgid "Cloning a virtual machine (Windows)"
3967 #: ../examples/guestfs-recipes.pod:55
3969 "It is possible to do a \"sysprep\" using libguestfs alone, although not "
3970 "straightforward. Currently there is code in the Aeolus Oz project which "
3971 "does this (using libguestfs). As part of our review of the virt-clone tool, "
3972 "we may add sysprepping ability."
3976 #: ../examples/guestfs-recipes.pod:60
3978 "https://github.com/clalancette/oz https://www.redhat.com/archives/virt-tools-"
3979 "list/2011-May/msg00019.html"
3983 #: ../examples/guestfs-recipes.pod:63
3984 msgid "Convert a CD-ROM / DVD / ISO to a tarball"
3988 #: ../examples/guestfs-recipes.pod:65
3989 msgid "This converts input C<cd.iso> to output C<cd.tar.gz>:"
3993 #: ../examples/guestfs-recipes.pod:67
3996 " guestfish --ro -a cd.iso -m /dev/sda tgz-out / cd.tar.gz\n"
4001 #: ../examples/guestfs-recipes.pod:69
4002 msgid "To export just a subdirectory, eg. C</files>, do:"
4006 #: ../examples/guestfs-recipes.pod:71
4009 " guestfish --ro -a cd.iso -m /dev/sda tgz-out /files cd.tar.gz\n"
4014 #: ../examples/guestfs-recipes.pod:73
4015 msgid "Create empty disk images"
4019 #: ../examples/guestfs-recipes.pod:75
4021 "You can use the L<guestfish(1)> I<-N> option to create empty disk images. "
4022 "The useful guide below explains the options available."
4026 #: ../examples/guestfs-recipes.pod:78
4028 "https://rwmj.wordpress.com/2010/09/08/new-guestfish-n-options-in-1-5-9/"
4033 #: ../examples/guestfs-recipes.pod:80
4034 msgid "Dump raw filesystem content from inside a disk image or VM"
4038 #: ../examples/guestfs-recipes.pod:82
4040 "You can use the L<guestfish(1)> C<download> command to extract the raw "
4041 "filesystem content from any filesystem in a disk image or a VM (even one "
4042 "which is encrypted or buried inside an LV):"
4046 #: ../examples/guestfs-recipes.pod:86
4049 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
4052 " guestfish --ro -a disk.img run : download /dev/sda1 sda1.img\n"
4055 " guestfish --format=raw -a disk.img --format -a another.img\n"
4059 #: ../examples/guestfs-recipes.pod:88
4062 " guestfish --ro -d Guest run : download /dev/vg_guest/lv_root lv.img\n"
4067 #: ../examples/guestfs-recipes.pod:90
4068 msgid "To list the filesystems in a disk image, use L<virt-filesystems(1)>."
4072 #: ../examples/guestfs-recipes.pod:92
4073 msgid "Edit grub configuration in a VM"
4077 #: ../examples/guestfs-recipes.pod:94
4078 msgid "You can use this to:"
4082 #: ../examples/guestfs-recipes.pod:100
4083 msgid "Fix a virtual machine that does not boot."
4087 #: ../examples/guestfs-recipes.pod:104
4088 msgid "Change which kernel is used to boot the VM."
4092 #: ../examples/guestfs-recipes.pod:108
4093 msgid "Change kernel command line options."
4097 #: ../examples/guestfs-recipes.pod:112
4098 msgid "Use L<virt-edit(1)> to edit the grub configuration:"
4102 #: ../examples/guestfs-recipes.pod:114
4105 " virt-edit -d BrokenGuest /boot/grub/grub.conf\n"
4110 #: ../examples/guestfs-recipes.pod:116
4112 "or for general tinkering inside an unbootable VM use L<virt-rescue(1)> like "
4117 #: ../examples/guestfs-recipes.pod:119
4120 " virt-rescue -d BrokenGuest\n"
4125 #: ../examples/guestfs-recipes.pod:121
4126 msgid "Export any directory from a VM"
4130 #: ../examples/guestfs-recipes.pod:123
4132 "To export C</home> from a VM into a local directory use L<virt-copy-out(1)>:"
4136 #: ../examples/guestfs-recipes.pod:126
4139 #| " copy-out /home .\n"
4142 " virt-copy-out -d Guest /home .\n"
4145 " copy-out /home .\n"
4149 #: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9
4150 #: ../fish/guestfish-actions.pod:1327 ../fish/guestfish-actions.pod:1592
4151 #: ../fish/guestfish-actions.pod:2001 ../src/guestfs-actions.pod:18
4152 #: ../src/guestfs-actions.pod:2033 ../src/guestfs-actions.pod:2457
4153 #: ../src/guestfs-actions.pod:3008 ../src/guestfs.pod:1670
4154 #: ../tools/virt-win-reg.pl:706
4159 #: ../examples/guestfs-recipes.pod:134
4161 "The final dot of the command is not a printing error. It means we want to "
4162 "copy out to the current directory."
4166 #: ../examples/guestfs-recipes.pod:139
4167 msgid "This creates a directory called C<home> under the current directory."
4171 #: ../examples/guestfs-recipes.pod:143
4173 "If the guest is a Windows guest then you can use drive letters and "
4174 "backslashes, but you must prefix the path with C<win:> and quote it to "
4175 "protect it from the shell, like this:"
4179 #: ../examples/guestfs-recipes.pod:147
4182 " virt-copy-out -d WinGuest 'win:c:\\windows\\system32\\config' .\n"
4187 #: ../examples/guestfs-recipes.pod:149
4188 msgid "To get the output as a compressed tarball, do:"
4192 #: ../examples/guestfs-recipes.pod:151
4195 " virt-tar-out -d Guest /home - | gzip --best > home.tar.gz\n"
4200 #: ../examples/guestfs-recipes.pod:153
4202 "Although it sounds tempting, this is usually not a reliable way to get a "
4203 "backup from a running guest. See the entry in the FAQ: http://libguestfs."
4204 "org/FAQ.html#backup"
4208 #: ../examples/guestfs-recipes.pod:157
4209 msgid "Find out which user is using the most space"
4213 #: ../examples/guestfs-recipes.pod:159
4215 "This simple script examines a Linux guest to find out which user is using "
4216 "the most space in their home directory:"
4220 #: ../examples/guestfs-recipes.pod:162
4223 #| " #!/usr/bin/guestfish -f\n"
4229 " #!/usr/bin/guestfish -f\n"
4233 #: ../examples/guestfs-recipes.pod:164
4236 #| " set-qemu qemu\n"
4246 #: ../examples/guestfs-recipes.pod:166
4255 #: ../examples/guestfs-recipes.pod:169
4258 #| " guestfish --ro -d myguest -i\n"
4261 " eval $(guestfish --ro -d \"$vm\" -i --listen)\n"
4264 " guestfish --ro -d myguest -i\n"
4268 #: ../examples/guestfs-recipes.pod:171
4271 " for d in $(guestfish --remote ls \"$dir\"); do\n"
4272 " echo -n \"$dir/$d\"\n"
4274 " guestfish --remote du \"$dir/$d\";\n"
4275 " done | sort -nr -k 2\n"
4280 #: ../examples/guestfs-recipes.pod:177 ../fish/guestfish.pod:941
4283 " guestfish --remote exit\n"
4288 #: ../examples/guestfs-recipes.pod:179
4289 msgid "Get DHCP address from a VM"
4293 #: ../examples/guestfs-recipes.pod:181
4295 "The link below explains the many different possible techniques for getting "
4296 "the last assigned DHCP address of a virtual machine."
4300 #: ../examples/guestfs-recipes.pod:184
4302 "https://rwmj.wordpress.com/2011/03/31/tip-code-for-getting-dhcp-address-from-"
4303 "a-virtual-machine-disk-image/#content"
4307 #: ../examples/guestfs-recipes.pod:186
4309 "In the libguestfs source examples directory you will find the latest version "
4310 "of the C<virt-dhcp-address.c> program."
4314 #: ../examples/guestfs-recipes.pod:189
4315 msgid "Get the operating system product name string"
4319 #: ../examples/guestfs-recipes.pod:191
4320 msgid "Save the following script into a file called C<product-name.sh>:"
4324 #: ../examples/guestfs-recipes.pod:193
4327 #| " eval \"`guestfish --listen`\"\n"
4328 #| " guestfish --remote add-ro disk.img\n"
4329 #| " guestfish --remote run\n"
4330 #| " guestfish --remote lvs\n"
4335 " eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n"
4336 " root=\"$(guestfish --remote inspect-get-roots)\"\n"
4337 " guestfish --remote inspect-get-product-name \"$root\"\n"
4338 " guestfish --remote exit\n"
4341 " eval \"`guestfish --listen`\"\n"
4342 " guestfish --remote add-ro disk.img\n"
4343 " guestfish --remote run\n"
4344 " guestfish --remote lvs\n"
4348 #: ../examples/guestfs-recipes.pod:200
4349 msgid "Make the script executable and run it on a named guest:"
4353 #: ../examples/guestfs-recipes.pod:202
4356 " # product-name.sh RHEL60x64\n"
4357 " Red Hat Enterprise Linux Server release 6.0 (Santiago)\n"
4362 #: ../examples/guestfs-recipes.pod:205
4364 "You can also use an XPath query on the L<virt-inspector(1)> XML using the "
4365 "C<xpath> command line tool or from your favourite programming language:"
4369 #: ../examples/guestfs-recipes.pod:209
4372 " # virt-inspector RHEL60x64 > xml\n"
4373 " # xpath '//product_name' < xml\n"
4376 " <product_name>Red Hat Enterprise Linux Server release 6.0 (Santiago)</product_name>\n"
4381 #: ../examples/guestfs-recipes.pod:215
4382 msgid "Get the default boot kernel for a Linux VM"
4386 #: ../examples/guestfs-recipes.pod:217
4388 "The link below contains a program to print the default boot kernel for a "
4393 #: ../examples/guestfs-recipes.pod:220
4395 "https://rwmj.wordpress.com/2010/10/30/tip-use-augeas-to-get-the-default-boot-"
4396 "kernel-for-a-vm/#content"
4400 #: ../examples/guestfs-recipes.pod:222
4402 "It uses Augeas, and the technique is generally applicable for many different "
4407 #: ../examples/guestfs-recipes.pod:229
4408 msgid "listing the user accounts in the guest"
4412 #: ../examples/guestfs-recipes.pod:233
4413 msgid "what repositories is it configured to use"
4417 #: ../examples/guestfs-recipes.pod:237
4418 msgid "what NTP servers does it connect to"
4422 #: ../examples/guestfs-recipes.pod:241
4423 msgid "what were the boot messages last time it booted"
4427 #: ../examples/guestfs-recipes.pod:245
4428 msgid "listing who was logged in recently"
4432 #: ../examples/guestfs-recipes.pod:249
4433 msgid "http://augeas.net/"
4437 #: ../examples/guestfs-recipes.pod:251
4438 msgid "Install RPMs in a guest"
4442 #: ../examples/guestfs-recipes.pod:253
4444 "The link below contains a method to install RPMs in a guest. In fact the "
4445 "RPMs are just uploaded to the guest along with a \"firstboot\" script that "
4446 "installs them next time the guest is booted. You could use this technique "
4447 "to install vital security updates in an offline guest."
4451 #: ../examples/guestfs-recipes.pod:259
4453 "https://rwmj.wordpress.com/2010/12/01/tip-install-rpms-in-a-guest/#content"
4457 #: ../examples/guestfs-recipes.pod:261
4458 msgid "List applications installed in a VM"
4462 #: ../examples/guestfs-recipes.pod:263
4463 msgid "Save the following to a file C<list-apps.sh>:"
4467 #: ../examples/guestfs-recipes.pod:265
4470 #| " eval \"`guestfish --listen`\"\n"
4471 #| " guestfish --remote add-ro disk.img\n"
4472 #| " guestfish --remote run\n"
4473 #| " guestfish --remote lvs\n"
4478 " eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n"
4479 " root=\"$(guestfish --remote inspect-get-roots)\"\n"
4480 " guestfish --remote inspect-list-applications \"$root\"\n"
4481 " guestfish --remote exit\n"
4484 " eval \"`guestfish --listen`\"\n"
4485 " guestfish --remote add-ro disk.img\n"
4486 " guestfish --remote run\n"
4487 " guestfish --remote lvs\n"
4491 #: ../examples/guestfs-recipes.pod:272
4493 "Make the file executable and then you can run it on any named virtual "
4498 #: ../examples/guestfs-recipes.pod:275
4501 " # list-apps.sh WinGuest\n"
4503 " app_name: Mozilla Firefox (3.6.12)\n"
4504 " app_display_name: Mozilla Firefox (3.6.12)\n"
4506 " app_version: 3.6.12 (en-GB)\n"
4508 " app_install_path: C:\\Program Files\\Mozilla Firefox\n"
4509 " app_trans_path:\n"
4510 " app_publisher: Mozilla\n"
4511 " app_url: http://www.mozilla.com/en-GB/\n"
4512 " app_source_package:\n"
4514 " app_description: Mozilla Firefox\n"
4517 " app_name: VLC media player\n"
4518 " app_display_name: VLC media player 1.1.5\n"
4520 " app_version: 1.1.5\n"
4522 " app_install_path: C:\\Program Files\\VideoLAN\\VLC\n"
4523 " app_trans_path:\n"
4524 " app_publisher: VideoLAN\n"
4525 " app_url: http://www.videolan.org/\n"
4526 " app_source_package:\n"
4528 " app_description:\n"
4534 #: ../examples/guestfs-recipes.pod:305
4536 "If you want to run the script on disk images (instead of libvirt virtual "
4537 "machines), change C<-d \"$1\"> to C<-a \"$1\">. See also L<virt-inspector(1)"
4542 #: ../examples/guestfs-recipes.pod:309
4543 msgid "List files and directories in a VM"
4547 #: ../examples/guestfs-recipes.pod:311
4548 msgid "This involves using the L<guestfish(1)> C<find0> command like this:"
4552 #: ../examples/guestfs-recipes.pod:313
4555 #| " guestfish --ro -d myguest -i\n"
4558 " guestfish --ro -d Guest -i find0 / - | tr '\\0' '\\n' | sort\n"
4561 " guestfish --ro -d myguest -i\n"
4565 #: ../examples/guestfs-recipes.pod:315
4566 msgid "List services in a Windows VM"
4570 #: ../examples/guestfs-recipes.pod:317
4572 "The link below contains a script that can be used to list out the services "
4573 "from a Windows VM, and whether those services run at boot time or are loaded "
4578 #: ../examples/guestfs-recipes.pod:321
4580 "https://rwmj.wordpress.com/2010/12/10/tip-list-services-in-a-windows-guest/"
4585 #: ../examples/guestfs-recipes.pod:323
4586 msgid "Make a disk image sparse"
4590 #: ../examples/guestfs-recipes.pod:325
4592 "The link below contains some guides for making a disk image sparse (or "
4593 "reintroducing sparseness)."
4597 #: ../examples/guestfs-recipes.pod:328
4599 "https://rwmj.wordpress.com/2010/10/19/tip-making-a-disk-image-sparse/#content"
4603 #: ../examples/guestfs-recipes.pod:330
4604 msgid "Monitor disk usage over time"
4608 #: ../examples/guestfs-recipes.pod:332
4610 "You can use L<virt-df(1)> to monitor disk usage of your guests over time. "
4611 "The link below contains a guide."
4615 #: ../examples/guestfs-recipes.pod:335
4616 msgid "http://virt-tools.org/learning/advanced-virt-df/"
4620 #: ../examples/guestfs-recipes.pod:337
4621 msgid "Reading the Windows Event Log from Windows Vista (or later)"
4625 #: ../examples/guestfs-recipes.pod:339
4627 "L<guestfish(1)> plus the tools described in the link below can be used to "
4628 "read out the Windows Event Log from any virtual machine running Windows "
4629 "Vista or a later version."
4633 #: ../examples/guestfs-recipes.pod:343
4635 "https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-"
4636 "guestfish/#content"
4640 #: ../examples/guestfs-recipes.pod:345
4641 msgid "Remove root password (Linux)"
4645 #: ../examples/guestfs-recipes.pod:347
4647 "Using the L<virt-edit(1)> I<-e> option you can do simple replacements on "
4648 "files. One use is to remove the root password from a Linux guest:"
4652 #: ../examples/guestfs-recipes.pod:350
4655 " virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
4660 #: ../examples/guestfs-recipes.pod:352
4661 msgid "Remove Administrator password (Windows)"
4665 #: ../examples/guestfs-recipes.pod:354
4667 "The link below contains one technique for removing the Administrator "
4668 "password from a Windows VM, or to be more precise, it gives you a command "
4669 "prompt the next time you log in which you can use to bypass any security:"
4673 #: ../examples/guestfs-recipes.pod:359
4675 "https://mdbooth.wordpress.com/2010/10/18/resetting-a-windows-guests-"
4676 "administrator-password-with-guestfish/"
4680 #: ../examples/guestfs-recipes.pod:361
4681 msgid "Unpack a live CD"
4685 #: ../examples/guestfs-recipes.pod:363
4687 "Linux live CDs often contain multiple layers of disk images wrapped like a "
4688 "Russian doll. You can use L<guestfish(1)> to look inside these multiple "
4689 "layers, as outlined in the guide below."
4693 #: ../examples/guestfs-recipes.pod:367
4695 "https://rwmj.wordpress.com/2009/07/15/unpack-the-russian-doll-of-a-f11-live-"
4700 #: ../examples/guestfs-recipes.pod:369
4701 msgid "Uploading and downloading files"
4705 #: ../examples/guestfs-recipes.pod:371
4707 "The link below contains general tips on uploading (copying in) and "
4708 "downloading (copying out) files from VMs."
4712 #: ../examples/guestfs-recipes.pod:374
4714 "https://rwmj.wordpress.com/2010/12/02/tip-uploading-and-downloading/#content"
4718 #: ../examples/guestfs-recipes.pod:376
4719 msgid "Use libguestfs tools on VMware ESX guests"
4723 #: ../examples/guestfs-recipes.pod:378
4725 "The link below explains how to use libguestfs, L<guestfish(1)> and the virt "
4726 "tools on any VMware ESX guests, by first sharing the VMware VMFS over sshfs."
4730 #: ../examples/guestfs-recipes.pod:382
4732 "https://rwmj.wordpress.com/2011/05/10/tip-use-libguestfs-on-vmware-esx-"
4737 #: ../examples/guestfs-recipes.pod:386
4740 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
4741 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
4742 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
4744 "L<guestfs(3)>, L<guestfish(1)>, L<guestfs-examples(3)>, L<guestfs-erlang(3)"
4745 ">, L<guestfs-java(3)>, L<guestfs-ocaml(3)>, L<guestfs-perl(3)>, L<guestfs-"
4746 "python(3)>, L<guestfs-ruby(3)>, L<http://libguestfs.org/>."
4748 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
4749 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
4750 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
4753 #: ../examples/guestfs-recipes.pod:403
4755 #| msgid "Copyright (C) 2009-2010 Red Hat Inc."
4756 msgid "Copyright (C) 2009-2011 Red Hat Inc. L<http://libguestfs.org/>"
4757 msgstr "© Red Hat Inc., 2009–2010"
4760 #: ../fish/guestfish-actions.pod:1
4765 #: ../fish/guestfish-actions.pod:3
4768 " add-cdrom filename\n"
4773 #: ../fish/guestfish-actions.pod:5 ../src/guestfs-actions.pod:14
4774 msgid "This function adds a virtual CD-ROM disk image to the guest."
4778 #: ../fish/guestfish-actions.pod:7 ../src/guestfs-actions.pod:16
4779 msgid "This is equivalent to the qemu parameter I<-cdrom filename>."
4783 #: ../fish/guestfish-actions.pod:15
4785 "This call checks for the existence of C<filename>. This stops you from "
4786 "specifying other types of drive which are supported by qemu such as C<nbd:> "
4787 "and C<http:> URLs. To specify those, use the general L</config> call "
4792 #: ../fish/guestfish-actions.pod:22
4794 "If you just want to add an ISO file (often you use this as an efficient way "
4795 "to transfer large files into the guest), then you should probably use L</add-"
4796 "drive-ro> instead."
4800 #: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:163
4801 #: ../fish/guestfish-actions.pod:177
4803 "I<This function is deprecated.> In new code, use the L</add_drive_opts> call "
4808 #: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:166
4809 #: ../fish/guestfish-actions.pod:180 ../fish/guestfish-actions.pod:1026
4810 #: ../fish/guestfish-actions.pod:1386 ../fish/guestfish-actions.pod:1400
4811 #: ../fish/guestfish-actions.pod:3157 ../fish/guestfish-actions.pod:3468
4812 #: ../fish/guestfish-actions.pod:3516 ../fish/guestfish-actions.pod:4429
4813 #: ../fish/guestfish-actions.pod:4452 ../fish/guestfish-actions.pod:4474
4814 #: ../fish/guestfish-actions.pod:4512 ../fish/guestfish-actions.pod:5161
4815 #: ../fish/guestfish-actions.pod:5267 ../src/guestfs-actions.pod:10
4816 #: ../src/guestfs-actions.pod:252 ../src/guestfs-actions.pod:273
4817 #: ../src/guestfs-actions.pod:1619 ../src/guestfs-actions.pod:2118
4818 #: ../src/guestfs-actions.pod:2139 ../src/guestfs-actions.pod:4771
4819 #: ../src/guestfs-actions.pod:5293 ../src/guestfs-actions.pod:5393
4820 #: ../src/guestfs-actions.pod:6675 ../src/guestfs-actions.pod:6719
4821 #: ../src/guestfs-actions.pod:6753 ../src/guestfs-actions.pod:6816
4822 #: ../src/guestfs-actions.pod:7748 ../src/guestfs-actions.pod:7857
4823 #: ../src/guestfs-actions.pod:8040
4825 "Deprecated functions will not be removed from the API, but the fact that "
4826 "they are deprecated indicates that there are problems with correct use of "
4831 #: ../fish/guestfish-actions.pod:35
4836 #: ../fish/guestfish-actions.pod:37
4841 #: ../fish/guestfish-actions.pod:39
4844 " add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..] [allowuuid:..]\n"
4849 #: ../fish/guestfish-actions.pod:41
4851 "This function adds the disk(s) attached to the named libvirt domain C<dom>. "
4852 "It works by connecting to libvirt, requesting the domain and domain XML from "
4853 "libvirt, parsing it for disks, and calling L</add-drive-opts> on each one."
4857 #: ../fish/guestfish-actions.pod:46 ../src/guestfs-actions.pod:64
4859 "The number of disks added is returned. This operation is atomic: if an "
4860 "error is returned, then no disks are added."
4864 #: ../fish/guestfish-actions.pod:49 ../src/guestfs-actions.pod:67
4866 "This function does some minimal checks to make sure the libvirt domain is "
4867 "not running (unless C<readonly> is true). In a future version we will try "
4868 "to acquire the libvirt lock on each disk."
4872 #: ../fish/guestfish-actions.pod:53 ../src/guestfs-actions.pod:71
4874 "Disks must be accessible locally. This often means that adding disks from a "
4875 "remote libvirt connection (see L<http://libvirt.org/remote.html>) will fail "
4876 "unless those disks are accessible via the same device path locally too."
4880 #: ../fish/guestfish-actions.pod:58 ../src/guestfs-actions.pod:76
4882 "The optional C<libvirturi> parameter sets the libvirt URI (see L<http://"
4883 "libvirt.org/uri.html>). If this is not set then we connect to the default "
4884 "libvirt URI (or one set through an environment variable, see the libvirt "
4885 "documentation for full details)."
4889 #: ../fish/guestfish-actions.pod:64 ../src/guestfs-actions.pod:82
4891 "The optional C<live> flag controls whether this call will try to connect to "
4892 "a running virtual machine C<guestfsd> process if it sees a suitable "
4893 "E<lt>channelE<gt> element in the libvirt XML definition. The default (if "
4894 "the flag is omitted) is never to try. See L<guestfs(3)/ATTACHING TO RUNNING "
4895 "DAEMONS> for more information."
4899 #: ../fish/guestfish-actions.pod:71 ../src/guestfs-actions.pod:89
4901 "If the C<allowuuid> flag is true (default is false) then a UUID I<may> be "
4902 "passed instead of the domain name. The C<dom> string is treated as a UUID "
4903 "first and looked up, and if that lookup fails then we treat C<dom> as a name "
4908 #: ../fish/guestfish-actions.pod:76
4910 "The other optional parameters are passed directly through to L</add-drive-"
4915 #: ../fish/guestfish-actions.pod:79 ../fish/guestfish-actions.pod:143
4916 #: ../fish/guestfish-actions.pod:573 ../fish/guestfish-actions.pod:784
4917 #: ../fish/guestfish-actions.pod:805 ../fish/guestfish-actions.pod:2040
4918 #: ../fish/guestfish-actions.pod:3206 ../fish/guestfish-actions.pod:3369
4919 #: ../fish/guestfish-actions.pod:3504
4921 "This command has one or more optional arguments. See L</OPTIONAL ARGUMENTS>."
4925 #: ../fish/guestfish-actions.pod:81
4930 #: ../fish/guestfish-actions.pod:83
4933 " add-drive filename\n"
4936 " add-drive назва_файла\n"
4940 #: ../fish/guestfish-actions.pod:85
4942 "This function is the equivalent of calling L</add-drive-opts> with no "
4943 "optional parameters, so the disk is added writable, with the format being "
4944 "detected automatically."
4948 #: ../fish/guestfish-actions.pod:89
4950 "Automatic detection of the format opens you up to a potential security hole "
4951 "when dealing with untrusted raw-format images. See CVE-2010-3851 and "
4952 "RHBZ#642934. Specifying the format closes this security hole. Therefore "
4953 "you should think about replacing calls to this function with calls to L</add-"
4954 "drive-opts>, and specifying the format."
4958 #: ../fish/guestfish-actions.pod:96
4959 msgid "add-drive-opts"
4960 msgstr "add-drive-opts"
4963 #: ../fish/guestfish-actions.pod:98
4968 #: ../fish/guestfish-actions.pod:100
4971 " add-drive-opts filename [readonly:..] [format:..] [iface:..]\n"
4976 #: ../fish/guestfish-actions.pod:102 ../src/guestfs-actions.pod:160
4978 "This function adds a virtual machine disk image C<filename> to libguestfs. "
4979 "The first time you call this function, the disk appears as C</dev/sda>, the "
4980 "second time as C</dev/sdb>, and so on."
4984 #: ../fish/guestfish-actions.pod:107 ../src/guestfs-actions.pod:165
4986 "You don't necessarily need to be root when using libguestfs. However you "
4987 "obviously do need sufficient permissions to access the filename for whatever "
4988 "operations you want to perform (ie. read access if you just want to read the "
4989 "image or write access if you want to modify the image)."
4993 #: ../fish/guestfish-actions.pod:113 ../src/guestfs-actions.pod:171
4994 msgid "This call checks that C<filename> exists."
4998 #: ../fish/guestfish-actions.pod:115 ../fish/guestfish-actions.pod:3168
4999 #: ../src/guestfs-actions.pod:173 ../src/guestfs-actions.pod:4808
5000 msgid "The optional arguments are:"
5004 #: ../fish/guestfish-actions.pod:119 ../src/guestfs-actions.pod:177
5006 msgstr "C<readonly>"
5009 #: ../fish/guestfish-actions.pod:121 ../src/guestfs-actions.pod:179
5011 "If true then the image is treated as read-only. Writes are still allowed, "
5012 "but they are stored in a temporary snapshot overlay which is discarded at "
5013 "the end. The disk that you add is not modified."
5017 #: ../fish/guestfish-actions.pod:125 ../src/guestfs-actions.pod:183
5022 #: ../fish/guestfish-actions.pod:127
5024 "This forces the image format. If you omit this (or use L</add-drive> or L</"
5025 "add-drive-ro>) then the format is automatically detected. Possible formats "
5026 "include C<raw> and C<qcow2>."
5030 #: ../fish/guestfish-actions.pod:131 ../src/guestfs-actions.pod:189
5032 "Automatic detection of the format opens you up to a potential security hole "
5033 "when dealing with untrusted raw-format images. See CVE-2010-3851 and "
5034 "RHBZ#642934. Specifying the format closes this security hole."
5038 #: ../fish/guestfish-actions.pod:136 ../src/guestfs-actions.pod:194
5043 #: ../fish/guestfish-actions.pod:138
5045 "This rarely-used option lets you emulate the behaviour of the deprecated L</"
5046 "add-drive-with-if> call (q.v.)"
5050 #: ../fish/guestfish-actions.pod:145
5051 msgid "add-drive-ro"
5052 msgstr "add-drive-ro"
5055 #: ../fish/guestfish-actions.pod:147
5060 #: ../fish/guestfish-actions.pod:149
5063 " add-drive-ro filename\n"
5068 #: ../fish/guestfish-actions.pod:151
5070 "This function is the equivalent of calling L</add-drive-opts> with the "
5071 "optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk "
5072 "is added read-only, with the format being detected automatically."