1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Red Hat Inc.
3 # This file is distributed under the same license as the libguestfs package.
6 # Yuri Chornoivan <yurchor@ukr.net>, 2011.
9 "Project-Id-Version: libguestfs\n"
10 "Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
11 "POT-Creation-Date: 2011-11-21 13:23+0000\n"
12 "PO-Revision-Date: 2011-10-27 09:15+0000\n"
13 "Last-Translator: rjones <rjones@redhat.com>\n"
14 "Language-Team: Ukrainian <trans-uk@lists.fedoraproject.org>\n"
17 "Content-Type: text/plain; charset=UTF-8\n"
18 "Content-Transfer-Encoding: 8bit\n"
19 "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n"
20 "%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2)\n"
23 #: ../align/virt-alignment-scan.pod:3 ../cat/virt-cat.pod:3
24 #: ../cat/virt-filesystems.pod:3 ../cat/virt-ls.pod:3
25 #: ../clone/virt-sysprep.pod:3 ../df/virt-df.pod:3 ../edit/virt-edit.pod:3
26 #: ../erlang/examples/guestfs-erlang.pod:3 ../examples/guestfs-examples.pod:3
27 #: ../examples/guestfs-recipes.pod:14 ../examples/guestfs-testing.pod:3
28 #: ../fish/guestfish.pod:3 ../fish/virt-copy-in.pod:3
29 #: ../fish/virt-copy-out.pod:3 ../fish/virt-tar-in.pod:3
30 #: ../fish/virt-tar-out.pod:3 ../fuse/guestmount.pod:3
31 #: ../inspector/virt-inspector.pod:3 ../java/examples/guestfs-java.pod:3
32 #: ../ocaml/examples/guestfs-ocaml.pod:3 ../perl/examples/guestfs-perl.pod:3
33 #: ../python/examples/guestfs-python.pod:3 ../rescue/virt-rescue.pod:3
34 #: ../resize/virt-resize.pod:3 ../ruby/examples/guestfs-ruby.pod:3
35 #: ../sparsify/virt-sparsify.pod:3 ../src/guestfs.pod:3
36 #: ../test-tool/libguestfs-test-tool.pod:3
37 #: ../tools/virt-list-filesystems.pl:30 ../tools/virt-list-partitions.pl:30
38 #: ../tools/virt-make-fs.pl:35 ../tools/virt-tar.pl:31
39 #: ../tools/virt-win-reg.pl:35
44 #: ../align/virt-alignment-scan.pod:5
45 msgid "virt-alignment-scan - Check alignment of virtual machine partitions"
49 #: ../align/virt-alignment-scan.pod:7 ../cat/virt-cat.pod:7
50 #: ../cat/virt-filesystems.pod:7 ../cat/virt-ls.pod:7
51 #: ../clone/virt-sysprep.pod:7 ../df/virt-df.pod:7 ../edit/virt-edit.pod:7
52 #: ../erlang/examples/guestfs-erlang.pod:7 ../examples/guestfs-examples.pod:7
53 #: ../fish/guestfish.pod:7 ../fish/virt-copy-in.pod:7
54 #: ../fish/virt-copy-out.pod:7 ../fish/virt-tar-in.pod:7
55 #: ../fish/virt-tar-out.pod:7 ../fuse/guestmount.pod:7
56 #: ../inspector/virt-inspector.pod:7 ../java/examples/guestfs-java.pod:7
57 #: ../ocaml/examples/guestfs-ocaml.pod:7 ../perl/examples/guestfs-perl.pod:7
58 #: ../python/examples/guestfs-python.pod:7 ../rescue/virt-rescue.pod:7
59 #: ../resize/virt-resize.pod:7 ../ruby/examples/guestfs-ruby.pod:7
60 #: ../sparsify/virt-sparsify.pod:7 ../src/guestfs.pod:7
61 #: ../test-tool/libguestfs-test-tool.pod:7
62 #: ../tools/virt-list-filesystems.pl:34 ../tools/virt-list-partitions.pl:34
63 #: ../tools/virt-make-fs.pl:39 ../tools/virt-tar.pl:35
64 #: ../tools/virt-win-reg.pl:39
66 msgstr "КОРОТКИЙ ОПИС"
69 #: ../align/virt-alignment-scan.pod:9
72 " virt-alignment-scan [--options] -d domname\n"
77 #: ../align/virt-alignment-scan.pod:11
80 " virt-alignment-scan [--options] -a disk.img [-a disk.img ...]\n"
85 #: ../align/virt-alignment-scan.pod:13 ../cat/virt-cat.pod:19
86 #: ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19
87 #: ../clone/virt-sysprep.pod:13 ../df/virt-df.pod:21 ../edit/virt-edit.pod:27
88 #: ../erlang/examples/guestfs-erlang.pod:16
89 #: ../examples/guestfs-examples.pod:19 ../examples/guestfs-recipes.pod:18
90 #: ../examples/guestfs-testing.pod:7 ../fish/guestfish.pod:30
91 #: ../fish/virt-copy-in.pod:19 ../fish/virt-copy-out.pod:13
92 #: ../fish/virt-tar-in.pod:21 ../fish/virt-tar-out.pod:15
93 #: ../fuse/guestmount.pod:20 ../inspector/virt-inspector.pod:19
94 #: ../java/examples/guestfs-java.pod:15 ../ocaml/examples/guestfs-ocaml.pod:25
95 #: ../perl/examples/guestfs-perl.pod:18
96 #: ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:31
97 #: ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15
98 #: ../sparsify/virt-sparsify.pod:11 ../src/guestfs.pod:23
99 #: ../test-tool/libguestfs-test-tool.pod:11
100 #: ../tools/virt-list-filesystems.pl:40 ../tools/virt-list-partitions.pl:40
101 #: ../tools/virt-make-fs.pl:47 ../tools/virt-tar.pl:77
102 #: ../tools/virt-win-reg.pl:63
107 #: ../align/virt-alignment-scan.pod:15
109 "When older operating systems install themselves, the partitioning tools "
110 "place partitions at a sector misaligned with the underlying storage "
111 "(commonly the first partition starts on sector C<63>). Misaligned "
112 "partitions can result in an operating system issuing more I/O than should be "
117 #: ../align/virt-alignment-scan.pod:21
119 "The virt-alignment-scan tool checks the alignment of partitions in virtual "
120 "machines and disk images and warns you if there are alignment problems."
124 #: ../align/virt-alignment-scan.pod:25
126 "Currently there is no virt tool for fixing alignment problems. You can only "
127 "reinstall the guest operating system. The following NetApp document "
128 "summarises the problem and possible solutions: L<http://media.netapp.com/"
129 "documents/tr-3747.pdf>"
133 #: ../align/virt-alignment-scan.pod:30
138 #: ../align/virt-alignment-scan.pod:32
139 msgid "To run this tool on a disk image directly, use the I<-a> option:"
143 #: ../align/virt-alignment-scan.pod:34
146 " $ virt-alignment-scan -a winxp.img\n"
147 " /dev/sda1 32256 512 bad (alignment < 4K)\n"
152 #: ../align/virt-alignment-scan.pod:37
155 " $ virt-alignment-scan -a fedora16.img\n"
156 " /dev/sda1 1048576 1024K ok\n"
157 " /dev/sda2 2097152 2048K ok\n"
158 " /dev/sda3 526385152 2048K ok\n"
163 #: ../align/virt-alignment-scan.pod:42
165 "To run the tool on a guest known to libvirt, use the I<-d> option and "
166 "possibly the I<-c> option:"
170 #: ../align/virt-alignment-scan.pod:45
173 " # virt-alignment-scan -d RHEL5\n"
174 " /dev/sda1 32256 512 bad (alignment < 4K)\n"
175 " /dev/sda2 106928640 512 bad (alignment < 4K)\n"
180 #: ../align/virt-alignment-scan.pod:49
183 " $ virt-alignment-scan -c qemu:///system -d Win7TwoDisks\n"
184 " /dev/sda1 1048576 1024K ok\n"
185 " /dev/sda2 105906176 1024K ok\n"
186 " /dev/sdb1 65536 64K ok\n"
191 #: ../align/virt-alignment-scan.pod:54
193 "The output consists of 4 or more whitespace-separated columns. Only the "
194 "first 4 columns are signficant if you want to parse this from a program. "
199 #: ../align/virt-alignment-scan.pod:60
204 #: ../align/virt-alignment-scan.pod:62
206 "the device and partition name (eg. C</dev/sda1> meaning the first partition "
207 "on the first block device)"
211 #: ../align/virt-alignment-scan.pod:65
216 #: ../align/virt-alignment-scan.pod:67
217 msgid "the start of the partition in bytes"
221 #: ../align/virt-alignment-scan.pod:69
226 #: ../align/virt-alignment-scan.pod:71
227 msgid "the alignment in bytes or Kbytes (eg. C<512> or C<4K>)"
231 #: ../align/virt-alignment-scan.pod:73
236 #: ../align/virt-alignment-scan.pod:75
238 "C<ok> if the alignment is best for performance, or C<bad> if the alignment "
239 "can cause performance problems"
243 #: ../align/virt-alignment-scan.pod:78
248 #: ../align/virt-alignment-scan.pod:80
249 msgid "optional free-text explanation."
253 #: ../align/virt-alignment-scan.pod:84
255 "The exit code from the program changes depending on whether poorly aligned "
256 "partitions were found. See L</EXIT STATUS> below."
260 #: ../align/virt-alignment-scan.pod:87
261 msgid "If you just want the exit code with no output, use the I<-q> option."
265 #: ../align/virt-alignment-scan.pod:89 ../cat/virt-cat.pod:62
266 #: ../cat/virt-filesystems.pod:91 ../cat/virt-ls.pod:261
267 #: ../clone/virt-sysprep.pod:42 ../df/virt-df.pod:59 ../edit/virt-edit.pod:62
268 #: ../fish/guestfish.pod:148 ../fish/virt-copy-in.pod:45
269 #: ../fish/virt-copy-out.pod:34 ../fish/virt-tar-in.pod:42
270 #: ../fish/virt-tar-out.pod:36 ../fuse/guestmount.pod:92
271 #: ../inspector/virt-inspector.pod:55 ../rescue/virt-rescue.pod:112
272 #: ../resize/virt-resize.pod:262 ../sparsify/virt-sparsify.pod:99
273 #: ../test-tool/libguestfs-test-tool.pod:36
274 #: ../tools/virt-list-filesystems.pl:53 ../tools/virt-list-partitions.pl:54
275 #: ../tools/virt-make-fs.pl:153 ../tools/virt-tar.pl:103
276 #: ../tools/virt-win-reg.pl:96
281 #: ../align/virt-alignment-scan.pod:93 ../cat/virt-cat.pod:66
282 #: ../cat/virt-filesystems.pod:95 ../cat/virt-ls.pod:265
283 #: ../clone/virt-sysprep.pod:46 ../df/virt-df.pod:63 ../edit/virt-edit.pod:66
284 #: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:160
285 #: ../inspector/virt-inspector.pod:59 ../rescue/virt-rescue.pod:116
286 #: ../resize/virt-resize.pod:266 ../sparsify/virt-sparsify.pod:103
287 #: ../test-tool/libguestfs-test-tool.pod:40
288 #: ../tools/virt-list-filesystems.pl:61 ../tools/virt-list-partitions.pl:62
289 #: ../tools/virt-make-fs.pl:161 ../tools/virt-tar.pl:111
290 #: ../tools/virt-win-reg.pl:104
295 #: ../align/virt-alignment-scan.pod:95 ../cat/virt-cat.pod:68
296 #: ../cat/virt-filesystems.pod:97 ../cat/virt-ls.pod:267
297 #: ../clone/virt-sysprep.pod:48 ../df/virt-df.pod:65 ../edit/virt-edit.pod:68
298 #: ../inspector/virt-inspector.pod:61 ../rescue/virt-rescue.pod:118
299 #: ../tools/virt-list-filesystems.pl:63 ../tools/virt-list-partitions.pl:64
300 #: ../tools/virt-make-fs.pl:163 ../tools/virt-tar.pl:113
301 #: ../tools/virt-win-reg.pl:106
302 msgid "Display brief help."
303 msgstr "Показати коротку довідку."
306 #: ../align/virt-alignment-scan.pod:97 ../cat/virt-cat.pod:70
307 #: ../cat/virt-filesystems.pod:99 ../cat/virt-ls.pod:269
308 #: ../clone/virt-sysprep.pod:50 ../df/virt-df.pod:67 ../edit/virt-edit.pod:70
309 #: ../inspector/virt-inspector.pod:63 ../rescue/virt-rescue.pod:120
314 #: ../align/virt-alignment-scan.pod:99 ../cat/virt-cat.pod:72
315 #: ../cat/virt-filesystems.pod:101 ../cat/virt-ls.pod:271
316 #: ../clone/virt-sysprep.pod:52 ../df/virt-df.pod:69 ../edit/virt-edit.pod:72
317 #: ../inspector/virt-inspector.pod:65 ../rescue/virt-rescue.pod:122
318 msgid "B<--add> file"
319 msgstr "B<--add> файл"
322 #: ../align/virt-alignment-scan.pod:101 ../clone/virt-sysprep.pod:54
323 msgid "Add I<file> which should be a disk image from a virtual machine."
327 #: ../align/virt-alignment-scan.pod:103 ../cat/virt-cat.pod:78
328 #: ../cat/virt-filesystems.pod:107 ../cat/virt-ls.pod:277
329 #: ../clone/virt-sysprep.pod:56 ../df/virt-df.pod:75 ../edit/virt-edit.pod:78
330 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:102
331 #: ../inspector/virt-inspector.pod:71 ../rescue/virt-rescue.pod:128
333 "The format of the disk image is auto-detected. To override this and force a "
334 "particular format use the I<--format=..> option."
338 #: ../align/virt-alignment-scan.pod:106 ../cat/virt-cat.pod:81
339 #: ../cat/virt-filesystems.pod:125 ../cat/virt-ls.pod:291
340 #: ../clone/virt-sysprep.pod:59 ../df/virt-df.pod:78
341 #: ../rescue/virt-rescue.pod:135
343 msgstr "B<-c> адреса"
346 #: ../align/virt-alignment-scan.pod:108 ../cat/virt-cat.pod:83
347 #: ../cat/virt-filesystems.pod:127 ../cat/virt-ls.pod:293
348 #: ../clone/virt-sysprep.pod:61 ../df/virt-df.pod:80
349 #: ../rescue/virt-rescue.pod:137
350 msgid "B<--connect> URI"
351 msgstr "B<--connect> адреса"
354 #: ../align/virt-alignment-scan.pod:110 ../cat/virt-cat.pod:85
355 #: ../cat/virt-filesystems.pod:129 ../cat/virt-ls.pod:295
356 #: ../clone/virt-sysprep.pod:63 ../df/virt-df.pod:82 ../edit/virt-edit.pod:99
357 #: ../inspector/virt-inspector.pod:78 ../rescue/virt-rescue.pod:139
358 #: ../tools/virt-list-filesystems.pl:81 ../tools/virt-list-partitions.pl:82
359 #: ../tools/virt-tar.pl:131 ../tools/virt-win-reg.pl:132
361 "If using libvirt, connect to the given I<URI>. If omitted, then we connect "
362 "to the default libvirt hypervisor."
366 #: ../align/virt-alignment-scan.pod:113 ../cat/virt-cat.pod:88
367 #: ../cat/virt-filesystems.pod:132 ../cat/virt-ls.pod:298
368 #: ../clone/virt-sysprep.pod:66 ../df/virt-df.pod:85
369 #: ../rescue/virt-rescue.pod:142
371 "If you specify guest block devices directly (I<-a>), then libvirt is not "
376 #: ../align/virt-alignment-scan.pod:116 ../cat/virt-cat.pod:91
377 #: ../cat/virt-filesystems.pod:141 ../cat/virt-ls.pod:307
378 #: ../clone/virt-sysprep.pod:69 ../df/virt-df.pod:94 ../edit/virt-edit.pod:105
379 #: ../inspector/virt-inspector.pod:85 ../rescue/virt-rescue.pod:145
384 #: ../align/virt-alignment-scan.pod:118 ../cat/virt-cat.pod:93
385 #: ../cat/virt-filesystems.pod:143 ../cat/virt-ls.pod:309
386 #: ../clone/virt-sysprep.pod:71 ../df/virt-df.pod:96 ../edit/virt-edit.pod:107
387 #: ../inspector/virt-inspector.pod:87 ../rescue/virt-rescue.pod:147
388 msgid "B<--domain> guest"
389 msgstr "B<--domain> гість"
392 #: ../align/virt-alignment-scan.pod:120 ../cat/virt-cat.pod:95
393 #: ../cat/virt-filesystems.pod:145 ../cat/virt-ls.pod:311
394 #: ../clone/virt-sysprep.pod:73 ../df/virt-df.pod:98 ../edit/virt-edit.pod:109
395 #: ../inspector/virt-inspector.pod:89 ../rescue/virt-rescue.pod:149
397 "Add all the disks from the named libvirt guest. Domain UUIDs can be used "
402 #: ../align/virt-alignment-scan.pod:123 ../cat/virt-cat.pod:105
403 #: ../cat/virt-filesystems.pod:170 ../cat/virt-ls.pod:328
404 #: ../clone/virt-sysprep.pod:95 ../df/virt-df.pod:101
405 #: ../fish/guestfish.pod:233 ../fuse/guestmount.pod:142
406 #: ../inspector/virt-inspector.pod:99 ../rescue/virt-rescue.pod:152
407 msgid "B<--format=raw|qcow2|..>"
408 msgstr "B<--format=raw|qcow2|..>"
411 #: ../align/virt-alignment-scan.pod:125 ../cat/virt-cat.pod:107
412 #: ../cat/virt-filesystems.pod:172 ../cat/virt-ls.pod:330
413 #: ../clone/virt-sysprep.pod:97 ../df/virt-df.pod:103
414 #: ../edit/virt-edit.pod:134 ../fish/guestfish.pod:235
415 #: ../fuse/guestmount.pod:144 ../inspector/virt-inspector.pod:101
416 #: ../rescue/virt-rescue.pod:154
421 #: ../align/virt-alignment-scan.pod:127 ../cat/virt-cat.pod:109
422 #: ../cat/virt-filesystems.pod:174 ../cat/virt-ls.pod:332
423 #: ../clone/virt-sysprep.pod:99 ../df/virt-df.pod:105
424 #: ../edit/virt-edit.pod:136 ../fish/guestfish.pod:237
425 #: ../fuse/guestmount.pod:146 ../rescue/virt-rescue.pod:156
427 "The default for the I<-a> option is to auto-detect the format of the disk "
428 "image. Using this forces the disk format for I<-a> options which follow on "
429 "the command line. Using I<--format> with no argument switches back to auto-"
430 "detection for subsequent I<-a> options."
434 #: ../align/virt-alignment-scan.pod:132 ../cat/virt-cat.pod:114
435 #: ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337
436 #: ../clone/virt-sysprep.pod:104 ../df/virt-df.pod:110
437 #: ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242
438 #: ../fish/guestfish.pod:673 ../inspector/virt-inspector.pod:351
439 #: ../rescue/virt-rescue.pod:161 ../src/guestfs.pod:2877
444 #: ../align/virt-alignment-scan.pod:134
447 " virt-alignment-scan --format=raw -a disk.img\n"
452 #: ../align/virt-alignment-scan.pod:136 ../cat/virt-cat.pod:118
453 #: ../cat/virt-filesystems.pod:183 ../cat/virt-ls.pod:341
454 #: ../clone/virt-sysprep.pod:108 ../df/virt-df.pod:114
455 #: ../edit/virt-edit.pod:145 ../fish/guestfish.pod:246
456 #: ../rescue/virt-rescue.pod:165
457 msgid "forces raw format (no auto-detection) for C<disk.img>."
461 #: ../align/virt-alignment-scan.pod:138
464 " virt-alignment-scan --format=raw -a disk.img --format -a another.img\n"
469 #: ../align/virt-alignment-scan.pod:140 ../cat/virt-cat.pod:122
470 #: ../cat/virt-filesystems.pod:187 ../cat/virt-ls.pod:345
471 #: ../clone/virt-sysprep.pod:112 ../df/virt-df.pod:118
472 #: ../edit/virt-edit.pod:149 ../fish/guestfish.pod:250
473 #: ../rescue/virt-rescue.pod:169
475 "forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
476 "detection for C<another.img>."
480 #: ../align/virt-alignment-scan.pod:143 ../cat/virt-cat.pod:125
481 #: ../cat/virt-filesystems.pod:190 ../cat/virt-ls.pod:348
482 #: ../clone/virt-sysprep.pod:115 ../df/virt-df.pod:121
483 #: ../edit/virt-edit.pod:152 ../rescue/virt-rescue.pod:172
485 "If you have untrusted raw-format guest disk images, you should use this "
486 "option to specify the disk format. This avoids a possible security problem "
487 "with malicious guests (CVE-2010-3851)."
491 #: ../align/virt-alignment-scan.pod:147 ../resize/virt-resize.pod:491
492 #: ../sparsify/virt-sparsify.pod:153
497 #: ../align/virt-alignment-scan.pod:149 ../resize/virt-resize.pod:493
498 #: ../sparsify/virt-sparsify.pod:155
503 #: ../align/virt-alignment-scan.pod:151
505 "Don't produce any output. Just set the exit code (see L</EXIT STATUS> "
510 #: ../align/virt-alignment-scan.pod:154 ../cat/virt-cat.pod:134
511 #: ../cat/virt-filesystems.pod:261 ../cat/virt-ls.pod:425
512 #: ../clone/virt-sysprep.pod:138 ../df/virt-df.pod:173
513 #: ../edit/virt-edit.pod:161 ../fish/guestfish.pod:390
514 #: ../fuse/guestmount.pod:266 ../inspector/virt-inspector.pod:119
515 #: ../rescue/virt-rescue.pod:219 ../sparsify/virt-sparsify.pod:159
520 #: ../align/virt-alignment-scan.pod:156 ../cat/virt-cat.pod:136
521 #: ../cat/virt-filesystems.pod:263 ../cat/virt-ls.pod:427
522 #: ../clone/virt-sysprep.pod:140 ../df/virt-df.pod:175
523 #: ../edit/virt-edit.pod:163 ../fish/guestfish.pod:392
524 #: ../fuse/guestmount.pod:268 ../inspector/virt-inspector.pod:121
525 #: ../rescue/virt-rescue.pod:221 ../sparsify/virt-sparsify.pod:161
527 msgstr "B<--verbose>"
530 #: ../align/virt-alignment-scan.pod:158 ../cat/virt-cat.pod:138
531 #: ../cat/virt-filesystems.pod:265 ../cat/virt-ls.pod:429
532 #: ../clone/virt-sysprep.pod:142 ../df/virt-df.pod:177
533 #: ../edit/virt-edit.pod:165 ../inspector/virt-inspector.pod:123
534 #: ../rescue/virt-rescue.pod:223 ../sparsify/virt-sparsify.pod:163
535 msgid "Enable verbose messages for debugging."
539 #: ../align/virt-alignment-scan.pod:160 ../cat/virt-cat.pod:140
540 #: ../cat/virt-filesystems.pod:267 ../cat/virt-ls.pod:431
541 #: ../clone/virt-sysprep.pod:144 ../df/virt-df.pod:179
542 #: ../edit/virt-edit.pod:167 ../fish/guestfish.pod:397
543 #: ../fuse/guestmount.pod:272 ../inspector/virt-inspector.pod:125
544 #: ../rescue/virt-rescue.pod:225 ../resize/virt-resize.pod:561
545 #: ../sparsify/virt-sparsify.pod:165
550 #: ../align/virt-alignment-scan.pod:162 ../cat/virt-cat.pod:142
551 #: ../cat/virt-filesystems.pod:269 ../cat/virt-ls.pod:433
552 #: ../clone/virt-sysprep.pod:146 ../df/virt-df.pod:181
553 #: ../edit/virt-edit.pod:169 ../fish/guestfish.pod:399
554 #: ../fuse/guestmount.pod:274 ../inspector/virt-inspector.pod:127
555 #: ../rescue/virt-rescue.pod:227 ../resize/virt-resize.pod:563
556 #: ../sparsify/virt-sparsify.pod:167 ../tools/virt-list-filesystems.pl:69
557 #: ../tools/virt-list-partitions.pl:70 ../tools/virt-make-fs.pl:169
558 #: ../tools/virt-tar.pl:119 ../tools/virt-win-reg.pl:112
560 msgstr "B<--version>"
563 #: ../align/virt-alignment-scan.pod:164 ../cat/virt-cat.pod:144
564 #: ../cat/virt-filesystems.pod:271 ../cat/virt-ls.pod:435
565 #: ../clone/virt-sysprep.pod:148 ../df/virt-df.pod:183
566 #: ../edit/virt-edit.pod:171 ../inspector/virt-inspector.pod:129
567 #: ../rescue/virt-rescue.pod:229 ../resize/virt-resize.pod:565
568 #: ../sparsify/virt-sparsify.pod:169 ../tools/virt-list-filesystems.pl:71
569 #: ../tools/virt-list-partitions.pl:72 ../tools/virt-make-fs.pl:171
570 #: ../tools/virt-tar.pl:121 ../tools/virt-win-reg.pl:114
571 msgid "Display version number and exit."
572 msgstr "Показати дані щодо версії і завершити роботу."
575 #: ../align/virt-alignment-scan.pod:166 ../cat/virt-cat.pod:146
576 #: ../cat/virt-filesystems.pod:281 ../cat/virt-ls.pod:437
577 #: ../clone/virt-sysprep.pod:150 ../df/virt-df.pod:185
578 #: ../edit/virt-edit.pod:173 ../fish/guestfish.pod:412
579 #: ../fuse/guestmount.pod:287 ../inspector/virt-inspector.pod:131
580 #: ../rescue/virt-rescue.pod:240 ../sparsify/virt-sparsify.pod:171
581 #: ../tools/virt-tar.pl:158
586 #: ../align/virt-alignment-scan.pod:168 ../cat/virt-cat.pod:148
587 #: ../cat/virt-filesystems.pod:283 ../cat/virt-ls.pod:439
588 #: ../clone/virt-sysprep.pod:152 ../df/virt-df.pod:187
589 #: ../edit/virt-edit.pod:175 ../inspector/virt-inspector.pod:133
590 #: ../rescue/virt-rescue.pod:242 ../sparsify/virt-sparsify.pod:173
591 msgid "Enable tracing of libguestfs API calls."
595 #: ../align/virt-alignment-scan.pod:172
596 msgid "RECOMMENDED ALIGNMENT"
600 #: ../align/virt-alignment-scan.pod:174
602 "Operating systems older than Windows 2008 and Linux before ca.2010 place the "
603 "first sector of the first partition at sector 63, with a 512 byte sector "
604 "size. This happens because of a historical accident. Drives have to report "
605 "a cylinder / head / sector (CHS) geometry to the BIOS. The geometry is "
606 "completely meaningless on modern drives, but it happens that the geometry "
607 "reported always has 63 sectors per track. The operating system therefore "
608 "places the first partition at the start of the second \"track\", at sector "
613 #: ../align/virt-alignment-scan.pod:183
615 "When the guest OS is virtualized, the host operating system and hypervisor "
616 "may prefer accesses aligned to one of:"
620 #: ../align/virt-alignment-scan.pod:188
625 #: ../align/virt-alignment-scan.pod:190
627 "if the host OS uses local storage directly on hard drive partitions, and the "
628 "hard drive has 512 byte physical sectors."
632 #: ../align/virt-alignment-scan.pod:193
637 #: ../align/virt-alignment-scan.pod:195
639 "for local storage on new hard drives with 4Kbyte physical sectors; for file-"
640 "backed storage on filesystems with 4Kbyte block size; or for some types of "
641 "network-attached storage."
645 #: ../align/virt-alignment-scan.pod:199
650 #: ../align/virt-alignment-scan.pod:201
652 "for high-end network-attached storage. This is the optimal block size for "
653 "some NetApp hardware."
657 #: ../align/virt-alignment-scan.pod:204
662 #: ../align/virt-alignment-scan.pod:206
663 msgid "see L</1 MB PARTITION ALIGNMENT> below."
667 #: ../align/virt-alignment-scan.pod:210
669 "Partitions which are not aligned correctly to the underlying storage cause "
670 "extra I/O. For example:"
674 #: ../align/virt-alignment-scan.pod:213
678 " +--------------------------+------\n"
680 " | filesystem block |\n"
681 " ---+------------------+------+-------------------+-----+---\n"
682 " | host block | host block |\n"
684 " ---+-------------------------+-------------------------+---\n"
689 #: ../align/virt-alignment-scan.pod:222
691 "In this example, each time a 4K guest block is read, two blocks on the host "
692 "must be accessed (so twice as much I/O is done). When a 4K guest block is "
693 "written, two host blocks must first be read, the old and new data combined, "
694 "and the two blocks written back (4x I/O)."
698 #: ../align/virt-alignment-scan.pod:227
699 msgid "LINUX HOST BLOCK AND I/O SIZE"
703 #: ../align/virt-alignment-scan.pod:229
705 "New versions of the Linux kernel expose the physical and logical block size, "
706 "and minimum and recommended I/O size."
710 #: ../align/virt-alignment-scan.pod:232
711 msgid "For a typical consumer hard drive with 512 byte sectors:"
715 #: ../align/virt-alignment-scan.pod:234
718 " $ cat /sys/block/sda/queue/hw_sector_size\n"
720 " $ cat /sys/block/sda/queue/physical_block_size\n"
722 " $ cat /sys/block/sda/queue/logical_block_size\n"
724 " $ cat /sys/block/sda/queue/minimum_io_size\n"
726 " $ cat /sys/block/sda/queue/optimal_io_size\n"
732 #: ../align/virt-alignment-scan.pod:245
733 msgid "For a new consumer hard drive with 4Kbyte sectors:"
737 #: ../align/virt-alignment-scan.pod:247
740 " $ cat /sys/block/sda/queue/hw_sector_size\n"
742 " $ cat /sys/block/sda/queue/physical_block_size\n"
744 " $ cat /sys/block/sda/queue/logical_block_size\n"
746 " $ cat /sys/block/sda/queue/minimum_io_size\n"
748 " $ cat /sys/block/sda/queue/optimal_io_size\n"
754 #: ../align/virt-alignment-scan.pod:258
755 msgid "For a NetApp LUN:"
759 #: ../align/virt-alignment-scan.pod:260
762 " $ cat /sys/block/sdc/queue/logical_block_size\n"
764 " $ cat /sys/block/sdc/queue/physical_block_size\n"
766 " $ cat /sys/block/sdc/queue/minimum_io_size\n"
768 " $ cat /sys/block/sdc/queue/optimal_io_size\n"
774 #: ../align/virt-alignment-scan.pod:269
776 "The NetApp allows 512 byte accesses (but they will be very inefficient), "
777 "prefers a minimum 4K I/O size, but the optimal I/O size is 64K."
781 #: ../align/virt-alignment-scan.pod:273
783 "For detailed information about what these numbers mean, see L<http://docs."
784 "redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/"
785 "Storage_Administration_Guide/newstorage-iolimits.html>"
789 #: ../align/virt-alignment-scan.pod:276
791 "[Thanks to Matt Booth for providing 4K drive data. Thanks to Mike Snitzer "
792 "for providing NetApp data and additional information.]"
796 #: ../align/virt-alignment-scan.pod:279
797 msgid "1 MB PARTITION ALIGNMENT"
801 #: ../align/virt-alignment-scan.pod:281
803 "Microsoft picked 1 MB as the default alignment for all partitions starting "
804 "with Windows 2008 Server, and Linux has followed this."
808 #: ../align/virt-alignment-scan.pod:284
810 "Assuming 512 byte sectors in the guest, you will now see the first partition "
811 "starting at sector 2048, and subsequent partitions (if any) will start at a "
812 "multiple of 2048 sectors."
816 #: ../align/virt-alignment-scan.pod:288
818 "1 MB alignment is compatible with all current alignment requirements (4K, "
819 "64K) and provides room for future growth in physical block sizes."
823 #: ../align/virt-alignment-scan.pod:291
824 msgid "SETTING ALIGNMENT"
828 #: ../align/virt-alignment-scan.pod:293
830 "L<virt-resize(1)> can change the alignment of the partitions of some "
831 "guests. Currently it can fully align all the partitions of all Windows "
832 "guests, and it will fix the bootloader where necessary. For Linux guests, "
833 "it can align the second and subsequent partitions, so the majority of OS "
834 "accesses except at boot will be aligned."
838 #: ../align/virt-alignment-scan.pod:299
840 "Another way to correct partition alignment problems is to reinstall your "
841 "guest operating systems. If you install operating systems from templates, "
842 "ensure these have correct partition alignment too."
846 #: ../align/virt-alignment-scan.pod:303
848 "For older versions of Windows, the following NetApp document contains useful "
849 "information: L<http://media.netapp.com/documents/tr-3747.pdf>"
853 #: ../align/virt-alignment-scan.pod:306
855 "For Red Hat Enterprise Linux E<le> 5, use a Kickstart script that contains "
856 "an explicit C<%pre> section that creates aligned partitions using L<parted(8)"
857 ">. Do not use the Kickstart C<part> command. The NetApp document above "
858 "contains an example."
862 #: ../align/virt-alignment-scan.pod:311 ../cat/virt-cat.pod:231
863 #: ../cat/virt-filesystems.pod:373 ../cat/virt-ls.pod:483
864 #: ../clone/virt-sysprep.pod:475 ../df/virt-df.pod:215
865 #: ../edit/virt-edit.pod:342 ../inspector/virt-inspector.pod:367
866 #: ../rescue/virt-rescue.pod:303 ../resize/virt-resize.pod:676
867 #: ../tools/virt-list-filesystems.pl:188 ../tools/virt-list-partitions.pl:258
868 #: ../tools/virt-make-fs.pl:550 ../tools/virt-tar.pl:289
869 #: ../tools/virt-win-reg.pl:744
870 msgid "SHELL QUOTING"
874 #: ../align/virt-alignment-scan.pod:313 ../cat/virt-cat.pod:233
875 #: ../cat/virt-filesystems.pod:375 ../cat/virt-ls.pod:485
876 #: ../clone/virt-sysprep.pod:477 ../df/virt-df.pod:217
877 #: ../edit/virt-edit.pod:344 ../inspector/virt-inspector.pod:369
878 #: ../rescue/virt-rescue.pod:305 ../resize/virt-resize.pod:678
879 #: ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260
880 #: ../tools/virt-make-fs.pl:552 ../tools/virt-tar.pl:291
881 #: ../tools/virt-win-reg.pl:752
883 "Libvirt guest names can contain arbitrary characters, some of which have "
884 "meaning to the shell such as C<#> and space. You may need to quote or "
885 "escape these characters on the command line. See the shell manual page L<sh"
890 #: ../align/virt-alignment-scan.pod:318 ../cat/virt-cat.pod:238
891 #: ../cat/virt-filesystems.pod:380 ../cat/virt-ls.pod:490
892 #: ../clone/virt-sysprep.pod:482 ../df/virt-df.pod:222
893 #: ../edit/virt-edit.pod:349 ../fish/guestfish.pod:1114
894 #: ../fuse/guestmount.pod:312 ../inspector/virt-inspector.pod:390
895 #: ../resize/virt-resize.pod:683 ../sparsify/virt-sparsify.pod:227
896 #: ../test-tool/libguestfs-test-tool.pod:90
901 #: ../align/virt-alignment-scan.pod:320
902 msgid "This program returns:"
906 #: ../align/virt-alignment-scan.pod:324 ../align/virt-alignment-scan.pod:330
907 #: ../align/virt-alignment-scan.pod:336 ../align/virt-alignment-scan.pod:343
908 #: ../cat/virt-cat.pod:177 ../cat/virt-cat.pod:182 ../cat/virt-cat.pod:187
909 #: ../cat/virt-cat.pod:198 ../cat/virt-cat.pod:202
910 #: ../clone/virt-sysprep.pod:283 ../clone/virt-sysprep.pod:287
911 #: ../clone/virt-sysprep.pod:291 ../clone/virt-sysprep.pod:295
912 #: ../clone/virt-sysprep.pod:310 ../clone/virt-sysprep.pod:314
913 #: ../clone/virt-sysprep.pod:318 ../clone/virt-sysprep.pod:322
914 #: ../clone/virt-sysprep.pod:326 ../clone/virt-sysprep.pod:362
915 #: ../clone/virt-sysprep.pod:384 ../clone/virt-sysprep.pod:388
916 #: ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266
917 #: ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276
918 #: ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291
919 #: ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102
920 #: ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132
921 #: ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227
922 #: ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235
923 #: ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243
924 #: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20
925 #: ../fish/guestfish-actions.pod:441 ../fish/guestfish-actions.pod:449
926 #: ../fish/guestfish-actions.pod:456 ../fish/guestfish-actions.pod:463
927 #: ../fish/guestfish-actions.pod:1262 ../fish/guestfish-actions.pod:1266
928 #: ../fish/guestfish-actions.pod:1270 ../fish/guestfish-actions.pod:1274
929 #: ../fish/guestfish-actions.pod:1282 ../fish/guestfish-actions.pod:1286
930 #: ../fish/guestfish-actions.pod:1290 ../fish/guestfish-actions.pod:1300
931 #: ../fish/guestfish-actions.pod:1304 ../fish/guestfish-actions.pod:1308
932 #: ../fish/guestfish-actions.pod:1398 ../fish/guestfish-actions.pod:1402
933 #: ../fish/guestfish-actions.pod:1407 ../fish/guestfish-actions.pod:1412
934 #: ../fish/guestfish-actions.pod:1454 ../fish/guestfish-actions.pod:1458
935 #: ../fish/guestfish-actions.pod:1463 ../fish/guestfish-actions.pod:1719
936 #: ../fish/guestfish-actions.pod:1726 ../fish/guestfish-actions.pod:1733
937 #: ../fish/guestfish-actions.pod:2136 ../fish/guestfish-actions.pod:2142
938 #: ../fish/guestfish-actions.pod:2150 ../fish/guestfish-actions.pod:2157
939 #: ../fish/guestfish-actions.pod:2164 ../fish/guestfish.pod:445
940 #: ../fish/guestfish.pod:449 ../fish/guestfish.pod:453
941 #: ../fish/guestfish.pod:457 ../inspector/virt-inspector.pod:408
942 #: ../inspector/virt-inspector.pod:412 ../resize/virt-resize.pod:359
943 #: ../resize/virt-resize.pod:363 ../resize/virt-resize.pod:372
944 #: ../resize/virt-resize.pod:378 ../sparsify/virt-sparsify.pod:32
945 #: ../sparsify/virt-sparsify.pod:39 ../sparsify/virt-sparsify.pod:43
946 #: ../sparsify/virt-sparsify.pod:49 ../sparsify/virt-sparsify.pod:54
947 #: ../sparsify/virt-sparsify.pod:58 ../sparsify/virt-sparsify.pod:64
948 #: ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:29
949 #: ../src/guestfs-actions.pod:641 ../src/guestfs-actions.pod:649
950 #: ../src/guestfs-actions.pod:656 ../src/guestfs-actions.pod:663
951 #: ../src/guestfs-actions.pod:2079 ../src/guestfs-actions.pod:2083
952 #: ../src/guestfs-actions.pod:2087 ../src/guestfs-actions.pod:2091
953 #: ../src/guestfs-actions.pod:2099 ../src/guestfs-actions.pod:2103
954 #: ../src/guestfs-actions.pod:2107 ../src/guestfs-actions.pod:2117
955 #: ../src/guestfs-actions.pod:2121 ../src/guestfs-actions.pod:2125
956 #: ../src/guestfs-actions.pod:2263 ../src/guestfs-actions.pod:2267
957 #: ../src/guestfs-actions.pod:2272 ../src/guestfs-actions.pod:2277
958 #: ../src/guestfs-actions.pod:2338 ../src/guestfs-actions.pod:2342
959 #: ../src/guestfs-actions.pod:2347 ../src/guestfs-actions.pod:2762
960 #: ../src/guestfs-actions.pod:2769 ../src/guestfs-actions.pod:2776
961 #: ../src/guestfs-actions.pod:3321 ../src/guestfs-actions.pod:3327
962 #: ../src/guestfs-actions.pod:3335 ../src/guestfs-actions.pod:3342
963 #: ../src/guestfs-actions.pod:3349 ../src/guestfs.pod:403
964 #: ../src/guestfs.pod:408 ../src/guestfs.pod:413 ../src/guestfs.pod:417
965 #: ../src/guestfs.pod:422 ../src/guestfs.pod:426 ../src/guestfs.pod:431
966 #: ../src/guestfs.pod:436 ../src/guestfs.pod:1109 ../src/guestfs.pod:1113
967 #: ../src/guestfs.pod:1117 ../src/guestfs.pod:1122 ../src/guestfs.pod:1130
968 #: ../src/guestfs.pod:1149 ../src/guestfs.pod:1157 ../src/guestfs.pod:1179
969 #: ../src/guestfs.pod:1183 ../src/guestfs.pod:1187 ../src/guestfs.pod:1191
970 #: ../src/guestfs.pod:1195 ../src/guestfs.pod:1199 ../src/guestfs.pod:1689
971 #: ../src/guestfs.pod:1694 ../src/guestfs.pod:1698 ../src/guestfs.pod:1800
972 #: ../src/guestfs.pod:1805 ../src/guestfs.pod:1809 ../src/guestfs.pod:1819
973 #: ../src/guestfs.pod:2108 ../src/guestfs.pod:2113 ../src/guestfs.pod:2119
974 #: ../src/guestfs.pod:2127 ../src/guestfs.pod:2645 ../src/guestfs.pod:2651
975 #: ../src/guestfs.pod:2656 ../src/guestfs.pod:2662 ../src/guestfs.pod:3062
976 #: ../src/guestfs.pod:3067 ../src/guestfs.pod:3071 ../src/guestfs.pod:3075
977 #: ../src/guestfs.pod:3079 ../src/guestfs.pod:3093 ../src/guestfs.pod:3098
978 #: ../src/guestfs.pod:3330 ../src/guestfs.pod:3334 ../src/guestfs.pod:3338
979 #: ../src/guestfs.pod:3342 ../tools/virt-win-reg.pl:197
980 #: ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208
981 #: ../tools/virt-win-reg.pl:721 ../tools/virt-win-reg.pl:727
982 #: ../tools/virt-win-reg.pl:733
987 #: ../align/virt-alignment-scan.pod:326
992 #: ../align/virt-alignment-scan.pod:328
994 "successful exit, all partitions are aligned E<ge> 64K for best performance"
998 #: ../align/virt-alignment-scan.pod:332
1003 #: ../align/virt-alignment-scan.pod:334
1004 msgid "an error scanning the disk image or guest"
1008 #: ../align/virt-alignment-scan.pod:338
1013 #: ../align/virt-alignment-scan.pod:340
1015 "successful exit, some partitions have alignment E<lt> 64K which can result "
1016 "in poor performance on high end network storage"
1020 #: ../align/virt-alignment-scan.pod:345
1025 #: ../align/virt-alignment-scan.pod:347
1027 "successful exit, some partitions have alignment E<lt> 4K which can result in "
1028 "poor performance on most hypervisors"
1032 #: ../align/virt-alignment-scan.pod:352 ../cat/virt-cat.pod:243
1033 #: ../cat/virt-filesystems.pod:385 ../cat/virt-ls.pod:495
1034 #: ../clone/virt-sysprep.pod:486 ../df/virt-df.pod:227
1035 #: ../edit/virt-edit.pod:354 ../erlang/examples/guestfs-erlang.pod:97
1036 #: ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384
1037 #: ../examples/guestfs-testing.pod:269 ../fish/guestfish.pod:1268
1038 #: ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39
1039 #: ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41
1040 #: ../fuse/guestmount.pod:317 ../inspector/virt-inspector.pod:395
1041 #: ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78
1042 #: ../perl/examples/guestfs-perl.pod:39
1043 #: ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:325
1044 #: ../resize/virt-resize.pod:688 ../ruby/examples/guestfs-ruby.pod:36
1045 #: ../sparsify/virt-sparsify.pod:251 ../src/guestfs.pod:3270
1046 #: ../test-tool/libguestfs-test-tool.pod:100
1047 #: ../tools/virt-list-filesystems.pl:195 ../tools/virt-list-partitions.pl:265
1048 #: ../tools/virt-make-fs.pl:557 ../tools/virt-tar.pl:296
1049 #: ../tools/virt-win-reg.pl:757
1051 msgstr "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
1054 #: ../align/virt-alignment-scan.pod:354
1056 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-rescue(1)>, "
1057 "L<virt-resize(1)>, L<http://libguestfs.org/>."
1061 #: ../align/virt-alignment-scan.pod:361 ../cat/virt-cat.pod:252
1062 #: ../cat/virt-filesystems.pod:396 ../cat/virt-ls.pod:507
1063 #: ../clone/virt-sysprep.pod:501 ../df/virt-df.pod:235
1064 #: ../edit/virt-edit.pod:368 ../rescue/virt-rescue.pod:334
1065 #: ../resize/virt-resize.pod:711 ../sparsify/virt-sparsify.pod:264
1066 #: ../tools/virt-list-filesystems.pl:208 ../tools/virt-list-partitions.pl:277
1067 #: ../tools/virt-make-fs.pl:582 ../tools/virt-tar.pl:311
1068 #: ../tools/virt-win-reg.pl:783
1073 #: ../align/virt-alignment-scan.pod:363 ../cat/virt-cat.pod:254
1074 #: ../cat/virt-filesystems.pod:398 ../cat/virt-ls.pod:509
1075 #: ../clone/virt-sysprep.pod:503 ../df/virt-df.pod:237
1076 #: ../edit/virt-edit.pod:370 ../inspector/virt-inspector.pod:410
1077 #: ../rescue/virt-rescue.pod:336 ../resize/virt-resize.pod:713
1078 #: ../sparsify/virt-sparsify.pod:266 ../tools/virt-list-filesystems.pl:210
1079 #: ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:584
1080 #: ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:785
1081 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
1082 msgstr "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
1085 #: ../align/virt-alignment-scan.pod:365 ../cat/virt-cat.pod:256
1086 #: ../cat/virt-filesystems.pod:400 ../cat/virt-ls.pod:511
1087 #: ../clone/virt-sysprep.pod:505 ../df/virt-df.pod:239
1088 #: ../edit/virt-edit.pod:372 ../erlang/examples/guestfs-erlang.pod:114
1089 #: ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401
1090 #: ../examples/guestfs-testing.pod:280 ../fish/guestfish.pod:1300
1091 #: ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53
1092 #: ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55
1093 #: ../fuse/guestmount.pod:332 ../inspector/virt-inspector.pod:418
1094 #: ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95
1095 #: ../perl/examples/guestfs-perl.pod:56
1096 #: ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:338
1097 #: ../resize/virt-resize.pod:715 ../ruby/examples/guestfs-ruby.pod:52
1098 #: ../sparsify/virt-sparsify.pod:268 ../src/guestfs.pod:3353
1099 #: ../test-tool/libguestfs-test-tool.pod:110
1100 #: ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281
1101 #: ../tools/virt-make-fs.pl:586 ../tools/virt-tar.pl:315
1102 #: ../tools/virt-win-reg.pl:787
1104 msgstr "АВТОРСЬКІ ПРАВА"
1107 #: ../align/virt-alignment-scan.pod:367 ../clone/virt-sysprep.pod:507
1108 #: ../sparsify/virt-sparsify.pod:270
1109 msgid "Copyright (C) 2011 Red Hat Inc."
1113 #: ../align/virt-alignment-scan.pod:369 ../cat/virt-cat.pod:260
1114 #: ../cat/virt-filesystems.pod:404 ../cat/virt-ls.pod:515
1115 #: ../clone/virt-sysprep.pod:509 ../df/virt-df.pod:243
1116 #: ../edit/virt-edit.pod:376 ../fish/guestfish.pod:1305
1117 #: ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58
1118 #: ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60
1119 #: ../fuse/guestmount.pod:337 ../inspector/virt-inspector.pod:422
1120 #: ../rescue/virt-rescue.pod:342 ../resize/virt-resize.pod:719
1121 #: ../sparsify/virt-sparsify.pod:272 ../test-tool/libguestfs-test-tool.pod:115
1122 #: ../tools/virt-list-filesystems.pl:216 ../tools/virt-list-partitions.pl:285
1123 #: ../tools/virt-make-fs.pl:590 ../tools/virt-tar.pl:319
1124 #: ../tools/virt-win-reg.pl:791
1126 "This program is free software; you can redistribute it and/or modify it "
1127 "under the terms of the GNU General Public License as published by the Free "
1128 "Software Foundation; either version 2 of the License, or (at your option) "
1129 "any later version."
1133 #: ../align/virt-alignment-scan.pod:374 ../cat/virt-cat.pod:265
1134 #: ../cat/virt-filesystems.pod:409 ../cat/virt-ls.pod:520
1135 #: ../clone/virt-sysprep.pod:514 ../df/virt-df.pod:248
1136 #: ../edit/virt-edit.pod:381 ../fish/guestfish.pod:1310
1137 #: ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63
1138 #: ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65
1139 #: ../fuse/guestmount.pod:342 ../inspector/virt-inspector.pod:427
1140 #: ../rescue/virt-rescue.pod:347 ../resize/virt-resize.pod:724
1141 #: ../sparsify/virt-sparsify.pod:277 ../test-tool/libguestfs-test-tool.pod:120
1142 #: ../tools/virt-list-filesystems.pl:221 ../tools/virt-list-partitions.pl:290
1143 #: ../tools/virt-make-fs.pl:595 ../tools/virt-tar.pl:324
1144 #: ../tools/virt-win-reg.pl:796
1146 "This program is distributed in the hope that it will be useful, but WITHOUT "
1147 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
1148 "FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for "
1151 "Ця програма поширюється у сподіванні, що вона буде корисною, але БЕЗ БУДЬ-"
1152 "ЯКИХ ГАРАНТІЙНИХ ЗОБОВ’ЯЗАНЬ; навіть без очевидної гарантії ПРАЦЕЗДАТНОСТІ "
1153 "або ПРИДАТНОСТІ ДЛЯ ВИКОРИСТАННЯ З ПЕВНОЮ МЕТОЮ. Докладніше про це можна "
1154 "дізнатися з GNU General Public License."
1157 #: ../align/virt-alignment-scan.pod:379 ../cat/virt-cat.pod:270
1158 #: ../cat/virt-filesystems.pod:414 ../cat/virt-ls.pod:525
1159 #: ../clone/virt-sysprep.pod:519 ../df/virt-df.pod:253
1160 #: ../edit/virt-edit.pod:386 ../fish/guestfish.pod:1315
1161 #: ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68
1162 #: ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70
1163 #: ../fuse/guestmount.pod:347 ../inspector/virt-inspector.pod:432
1164 #: ../rescue/virt-rescue.pod:352 ../resize/virt-resize.pod:729
1165 #: ../sparsify/virt-sparsify.pod:282 ../test-tool/libguestfs-test-tool.pod:125
1166 #: ../tools/virt-list-filesystems.pl:226 ../tools/virt-list-partitions.pl:295
1167 #: ../tools/virt-make-fs.pl:600 ../tools/virt-tar.pl:329
1168 #: ../tools/virt-win-reg.pl:801
1170 "You should have received a copy of the GNU General Public License along with "
1171 "this program; if not, write to the Free Software Foundation, Inc., 51 "
1172 "Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA."
1174 "Ви маєте отримати копію GNU General Public License разом з цією програмою; "
1175 "якщо це не так, повідомте про факт за адресою Free Software Foundation, "
1176 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA."
1179 #: ../cat/virt-cat.pod:5
1180 msgid "virt-cat - Display files in a virtual machine"
1181 msgstr "virt-cat — показ файлів у віртуальній машині"
1184 #: ../cat/virt-cat.pod:9
1187 " virt-cat [--options] -d domname file [file ...]\n"
1190 " virt-cat [--параметри] -d назва_домену файл [файл...]\n"
1194 #: ../cat/virt-cat.pod:11
1197 " virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
1200 " virt-cat [--параметри] -a диск.img [-a диск.img ...] файл [файл...]\n"
1204 #: ../cat/virt-cat.pod:13 ../edit/virt-edit.pod:15
1205 #: ../inspector/virt-inspector.pod:13
1207 msgstr "Застарілий стиль:"
1210 #: ../cat/virt-cat.pod:15
1213 " virt-cat domname file\n"
1216 " virt-cat назва_домену файл\n"
1220 #: ../cat/virt-cat.pod:17
1223 " virt-cat disk.img file\n"
1226 " virt-cat диск.img файл\n"
1230 #: ../cat/virt-cat.pod:21
1232 "C<virt-cat> is a command line tool to display the contents of C<file> where "
1233 "C<file> exists in the named virtual machine (or disk image)."
1235 "C<virt-cat> — інструмент командного рядка для показу вмісту C<файла>, який "
1236 "зберігається у вказаній віртуальній машині (або образі диска)."
1239 #: ../cat/virt-cat.pod:24
1241 "Multiple filenames can be given, in which case they are concatenated "
1242 "together. Each filename must be a full path, starting at the root directory "
1243 "(starting with '/')."
1245 "Ви можете вказати декілька назв файлів. Вміст таких файлів буде об’єднано. "
1246 "Назви файлів слід вказувати повністю (разом зі шляхом), починаючи з "
1247 "кореневого каталогу (тобто назва має починатися з «/»)."
1250 #: ../cat/virt-cat.pod:28
1252 "C<virt-cat> can be used to quickly view a file. To edit a file, use C<virt-"
1253 "edit>. For more complex cases you should look at the L<guestfish(1)> tool "
1254 "(see L</USING GUESTFISH> below)."
1256 "C<virt-cat> можна скористатися для пришвидшення перегляду файла. Для "
1257 "редагування даних слід користуватися C<virt-edit>. Для виконання складніших "
1258 "дій можна скористатися програмою L<guestfish(1)> (див. L</USING GUESTFISH> "
1262 #: ../cat/virt-cat.pod:32 ../cat/virt-ls.pod:35 ../df/virt-df.pod:43
1263 #: ../edit/virt-edit.pod:44 ../fish/guestfish.pod:41
1264 #: ../fish/guestfish.pod:1051 ../fish/virt-copy-in.pod:29
1265 #: ../fish/virt-copy-out.pod:21 ../fish/virt-tar-in.pod:30
1266 #: ../fish/virt-tar-out.pod:24 ../fuse/guestmount.pod:39
1267 #: ../resize/virt-resize.pod:27 ../sparsify/virt-sparsify.pod:75
1268 #: ../tools/virt-tar.pl:50
1273 #: ../cat/virt-cat.pod:34
1275 "Display C</etc/fstab> file from inside the libvirt VM called C<mydomain>:"
1277 "Показ файла C</etc/fstab> з віртуальної машини libvirt з назвою C<mydomain>:"
1280 #: ../cat/virt-cat.pod:37
1283 " virt-cat -d mydomain /etc/fstab\n"
1286 " virt-cat -d mydomain /etc/fstab\n"
1290 #: ../cat/virt-cat.pod:39
1291 msgid "List syslog messages from a VM disk image file:"
1293 "Показ списку повідомлень syslog з файла образу диска віртуальної машини:"
1296 #: ../cat/virt-cat.pod:41
1299 " virt-cat -a disk.img /var/log/messages | tail\n"
1302 " virt-cat -a disk.img /var/log/messages | tail\n"
1306 #: ../cat/virt-cat.pod:43
1307 msgid "Find out what DHCP IP address a VM acquired:"
1308 msgstr "Визначення IP-адреси DHCP, використаної віртуальною машиною:"
1311 #: ../cat/virt-cat.pod:45
1314 " virt-cat -d mydomain /var/log/messages | \\\n"
1315 " grep 'dhclient: bound to' | tail\n"
1318 " virt-cat -d mydomain /var/log/messages | \\\n"
1319 " grep 'dhclient: bound to' | tail\n"
1323 #: ../cat/virt-cat.pod:48
1324 msgid "Find out what packages were recently installed:"
1325 msgstr "Пошук нещодавно встановлених пакунків:"
1328 #: ../cat/virt-cat.pod:50
1331 " virt-cat -d mydomain /var/log/yum.log | tail\n"
1334 " virt-cat -d mydomain /var/log/yum.log | tail\n"
1338 #: ../cat/virt-cat.pod:52
1339 msgid "Find out who is logged on inside a virtual machine:"
1340 msgstr "Визначення користувачів, які працюють у віртуальній машині:"
1343 #: ../cat/virt-cat.pod:54
1346 " virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n"
1350 " virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n"
1355 #: ../cat/virt-cat.pod:57
1356 msgid "or who was logged on:"
1357 msgstr "або тих, які у ній працювали:"
1360 #: ../cat/virt-cat.pod:59
1363 " virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n"
1364 " last -f /tmp/wtmp\n"
1367 " virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n"
1368 " last -f /tmp/wtmp\n"
1372 #: ../cat/virt-cat.pod:74 ../cat/virt-filesystems.pod:103
1373 #: ../cat/virt-ls.pod:273 ../df/virt-df.pod:71 ../edit/virt-edit.pod:74
1374 #: ../inspector/virt-inspector.pod:67 ../rescue/virt-rescue.pod:124
1376 "Add I<file> which should be a disk image from a virtual machine. If the "
1377 "virtual machine has multiple block devices, you must supply all of them with "
1378 "separate I<-a> options."
1382 #: ../cat/virt-cat.pod:98 ../cat/virt-filesystems.pod:148
1383 #: ../cat/virt-ls.pod:314 ../edit/virt-edit.pod:112 ../fish/guestfish.pod:217
1384 #: ../fuse/guestmount.pod:135 ../inspector/virt-inspector.pod:92
1385 msgid "B<--echo-keys>"
1386 msgstr "B<--echo-keys>"
1389 #: ../cat/virt-cat.pod:100
1391 "When prompting for keys and passphrases, virt-cat normally turns echoing off "
1392 "so you cannot see what you are typing. If you are not worried about Tempest "
1393 "attacks and there is no one else in the room you can specify this flag to "
1394 "see what you are typing."
1398 #: ../cat/virt-cat.pod:116
1401 " virt-cat --format=raw -a disk.img file\n"
1404 " virt-cat --format=raw -a disk.img file\n"
1408 #: ../cat/virt-cat.pod:120
1411 " virt-cat --format=raw -a disk.img --format -a another.img file\n"
1414 " virt-cat --format=raw -a disk.img --format -a another.img file\n"
1418 #: ../cat/virt-cat.pod:129 ../cat/virt-filesystems.pod:200
1419 #: ../cat/virt-ls.pod:361 ../edit/virt-edit.pod:156 ../fish/guestfish.pod:289
1420 #: ../fuse/guestmount.pod:172 ../inspector/virt-inspector.pod:114
1421 msgid "B<--keys-from-stdin>"
1422 msgstr "B<--keys-from-stdin>"
1425 #: ../cat/virt-cat.pod:131 ../cat/virt-filesystems.pod:202
1426 #: ../cat/virt-ls.pod:363 ../edit/virt-edit.pod:158 ../fish/guestfish.pod:291
1427 #: ../fuse/guestmount.pod:174 ../inspector/virt-inspector.pod:116
1429 "Read key or passphrase parameters from stdin. The default is to try to read "
1430 "passphrases from the user by opening C</dev/tty>."
1434 #: ../cat/virt-cat.pod:152 ../cat/virt-ls.pod:443 ../edit/virt-edit.pod:179
1435 #: ../inspector/virt-inspector.pod:144 ../rescue/virt-rescue.pod:246
1436 msgid "OLD-STYLE COMMAND LINE ARGUMENTS"
1440 #: ../cat/virt-cat.pod:154
1441 msgid "Previous versions of virt-cat allowed you to write either:"
1445 #: ../cat/virt-cat.pod:156
1448 " virt-cat disk.img [disk.img ...] file\n"
1453 #: ../cat/virt-cat.pod:158 ../cat/virt-ls.pod:449 ../edit/virt-edit.pod:185
1454 #: ../inspector/virt-inspector.pod:150 ../rescue/virt-rescue.pod:252
1459 #: ../cat/virt-cat.pod:160
1462 " virt-cat guestname file\n"
1467 #: ../cat/virt-cat.pod:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189
1468 #: ../inspector/virt-inspector.pod:154 ../rescue/virt-rescue.pod:256
1470 "whereas in this version you should use I<-a> or I<-d> respectively to avoid "
1471 "the confusing case where a disk image might have the same name as a guest."
1475 #: ../cat/virt-cat.pod:166 ../cat/virt-ls.pod:457 ../edit/virt-edit.pod:193
1476 #: ../inspector/virt-inspector.pod:158 ../rescue/virt-rescue.pod:260
1477 msgid "For compatibility the old style is still supported."
1481 #: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:257 ../fish/guestfish.pod:858
1482 msgid "WINDOWS PATHS"
1483 msgstr "ШЛЯХИ У WINDOWS"
1486 #: ../cat/virt-cat.pod:170
1488 "C<virt-cat> has a limited ability to understand Windows drive letters and "
1489 "paths (eg. C<E:\\foo\\bar.txt>)."
1493 #: ../cat/virt-cat.pod:173 ../edit/virt-edit.pod:262
1494 msgid "If and only if the guest is running Windows then:"
1498 #: ../cat/virt-cat.pod:179 ../edit/virt-edit.pod:268
1500 "Drive letter prefixes like C<C:> are resolved against the Windows Registry "
1501 "to the correct filesystem."
1505 #: ../cat/virt-cat.pod:184 ../edit/virt-edit.pod:273
1507 "Any backslash (C<\\>) characters in the path are replaced with forward "
1508 "slashes so that libguestfs can process it."
1512 #: ../cat/virt-cat.pod:189
1514 "The path is resolved case insensitively to locate the file that should be "
1519 #: ../cat/virt-cat.pod:194 ../edit/virt-edit.pod:283
1520 msgid "There are some known shortcomings:"
1524 #: ../cat/virt-cat.pod:200 ../edit/virt-edit.pod:289
1525 msgid "Some NTFS symbolic links may not be followed correctly."
1529 #: ../cat/virt-cat.pod:204 ../edit/virt-edit.pod:293
1530 msgid "NTFS junction points that cross filesystems are not followed."
1534 #: ../cat/virt-cat.pod:208 ../edit/virt-edit.pod:297
1535 msgid "USING GUESTFISH"
1536 msgstr "ВИКОРИСТАННЯ GUESTFISH"
1539 #: ../cat/virt-cat.pod:210
1541 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
1542 "C<virt-cat> doesn't work."
1546 #: ../cat/virt-cat.pod:213
1547 msgid "Using C<virt-cat> is approximately equivalent to doing:"
1551 #: ../cat/virt-cat.pod:215
1554 " guestfish --ro -i -d domname download file -\n"
1559 #: ../cat/virt-cat.pod:217
1561 "where C<domname> is the name of the libvirt guest, and C<file> is the full "
1562 "path to the file. Note the final C<-> (meaning \"output to stdout\")."
1566 #: ../cat/virt-cat.pod:221
1568 "The command above uses libguestfs's guest inspection feature and so does not "
1569 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
1570 "disk images that don't contain guests. To display a file from a disk image "
1575 #: ../cat/virt-cat.pod:226
1578 " guestfish --ro -a disk.img -m /dev/sda1 download file -\n"
1583 #: ../cat/virt-cat.pod:228
1585 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
1586 "the disk image, and C<file> is the full path to the file."
1590 #: ../cat/virt-cat.pod:240 ../cat/virt-filesystems.pod:382
1591 #: ../cat/virt-ls.pod:492 ../df/virt-df.pod:224 ../edit/virt-edit.pod:351
1592 #: ../fuse/guestmount.pod:314 ../inspector/virt-inspector.pod:392
1593 #: ../resize/virt-resize.pod:685 ../sparsify/virt-sparsify.pod:229
1595 "This program returns 0 if successful, or non-zero if there was an error."
1599 #: ../cat/virt-cat.pod:245
1601 "L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, L<virt-"
1602 "tar-out(1)>, L<http://libguestfs.org/>."
1604 "L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, L<virt-"
1605 "tar-out(1)>, L<http://libguestfs.org/>."
1608 #: ../cat/virt-cat.pod:258 ../inspector/virt-inspector.pod:420
1609 #: ../resize/virt-resize.pod:717 ../tools/virt-make-fs.pl:588
1610 msgid "Copyright (C) 2010-2011 Red Hat Inc."
1611 msgstr "©Red Hat Inc., 2010–2011"
1614 #: ../cat/virt-filesystems.pod:5
1616 "virt-filesystems - List filesystems, partitions, block devices, LVM in a "
1617 "virtual machine or disk image"
1621 #: ../cat/virt-filesystems.pod:9
1624 " virt-filesystems [--options] -d domname\n"
1627 " virt-filesystems [--параметри] -d назва_домену\n"
1631 #: ../cat/virt-filesystems.pod:11
1634 " virt-filesystems [--options] -a disk.img [-a disk.img ...]\n"
1639 #: ../cat/virt-filesystems.pod:15
1641 "This tool allows you to discover filesystems, partitions, logical volumes, "
1642 "and their sizes in a disk image or virtual machine. It is a replacement for "
1643 "L<virt-list-filesystems(1)> and L<virt-list-partitions(1)>."
1647 #: ../cat/virt-filesystems.pod:20
1649 "One use for this tool is from shell scripts to iterate over all filesystems "
1650 "from a disk image:"
1654 #: ../cat/virt-filesystems.pod:23
1657 " for fs in $(virt-filesystems -a disk.img); do\n"
1662 " for fs in $(virt-filesystems -a disk.img); do\n"
1668 #: ../cat/virt-filesystems.pod:27
1670 "Another use is to list partitions before using another tool to modify those "
1671 "partitions (such as L<virt-resize(1)>). If you are curious about what an "
1672 "unknown disk image contains, use this tool along with L<virt-inspector(1)>."
1676 #: ../cat/virt-filesystems.pod:32
1678 "Various command line options control what this program displays. You need "
1679 "to give either I<-a> or I<-d> options to specify the disk image or libvirt "
1680 "guest respectively. If you just specify that then the program shows "
1681 "filesystems found, one per line, like this:"
1685 #: ../cat/virt-filesystems.pod:37
1688 " $ virt-filesystems -a disk.img\n"
1690 " /dev/vg_guest/lv_root\n"
1693 " $ virt-filesystems -a disk.img\n"
1695 " /dev/vg_guest/lv_root\n"
1699 #: ../cat/virt-filesystems.pod:41
1701 "If you add I<-l> or I<--long> then the output includes extra information:"
1705 #: ../cat/virt-filesystems.pod:44
1708 " $ virt-filesystems -a disk.img -l\n"
1709 " Name Type VFS Label Size\n"
1710 " /dev/sda1 filesystem ext4 boot 524288000\n"
1711 " /dev/vg_guest/lv_root filesystem ext4 root 10212081664\n"
1716 #: ../cat/virt-filesystems.pod:49
1718 "If you add I<--extra> then non-mountable (swap, unknown) filesystems are "
1723 #: ../cat/virt-filesystems.pod:52
1726 " $ virt-filesystems -a disk.img --extra\n"
1728 " /dev/vg_guest/lv_root\n"
1729 " /dev/vg_guest/lv_swap\n"
1730 " /dev/vg_guest/lv_data\n"
1733 " $ virt-filesystems -a disk.img --extra\n"
1735 " /dev/vg_guest/lv_root\n"
1736 " /dev/vg_guest/lv_swap\n"
1737 " /dev/vg_guest/lv_data\n"
1741 #: ../cat/virt-filesystems.pod:58
1743 "If you add I<--partitions> then partitions are shown instead of filesystems:"
1747 #: ../cat/virt-filesystems.pod:60
1750 " $ virt-filesystems -a disk.img --partitions\n"
1755 " $ virt-filesystems -a disk.img --partitions\n"
1761 #: ../cat/virt-filesystems.pod:64
1763 "Similarly you can use I<--logical-volumes>, I<--volume-groups>, I<--physical-"
1764 "volumes>, I<--block-devices> to list those items."
1768 #: ../cat/virt-filesystems.pod:67
1770 "You can use these options in combination as well (if you want a combination "
1771 "including filesystems, you have to add I<--filesystems>). Notice that some "
1772 "items fall into several categories (eg. C</dev/sda1> might be both a "
1773 "partition and a filesystem). These items are listed several times. To get "
1774 "a list which includes absolutely everything that virt-filesystems knows "
1775 "about, use the I<--all> option."
1779 #: ../cat/virt-filesystems.pod:74
1781 "UUIDs (because they are quite long) are not shown by default. Add the I<--"
1782 "uuid> option to display device and filesystem UUIDs in the long output."
1786 #: ../cat/virt-filesystems.pod:78
1788 "I<--all --long --uuid> is a useful combination to display all possible "
1789 "information about everything."
1793 #: ../cat/virt-filesystems.pod:81
1796 " $ virt-filesystems -a win.img --all --long --uuid -h\n"
1797 " Name Type VFS Label Size Parent UUID\n"
1798 " /dev/sda1 filesystem ntfs System Reserved 100M - F81C92571C92112C\n"
1799 " /dev/sda2 filesystem ntfs - 20G - F2E8996AE8992E3B\n"
1800 " /dev/sda1 partition - - 100M /dev/sda -\n"
1801 " /dev/sda2 partition - - 20G /dev/sda -\n"
1802 " /dev/sda device - - 20G - -\n"
1807 #: ../cat/virt-filesystems.pod:89
1809 "For machine-readable output, use I<--csv> to get Comma-Separated Values."
1813 #: ../cat/virt-filesystems.pod:110 ../tools/virt-list-filesystems.pl:121
1818 #: ../cat/virt-filesystems.pod:112
1820 "Display everything. This is currently the same as specifying these options: "
1821 "I<--filesystems>, I<--extra>, I<--partitions>, I<--block-devices>, I<--"
1822 "logical-volumes>, I<--volume-groups>, I<--physical-volumes>. (More may be "
1823 "added to this list in future)."
1827 #: ../cat/virt-filesystems.pod:117
1828 msgid "See also I<--long>."
1829 msgstr "Див. також I<--long>."
1832 #: ../cat/virt-filesystems.pod:119
1833 msgid "B<--blkdevs>"
1834 msgstr "B<--blkdevs>"
1837 #: ../cat/virt-filesystems.pod:121
1838 msgid "B<--block-devices>"
1839 msgstr "B<--block-devices>"
1842 #: ../cat/virt-filesystems.pod:123
1843 msgid "Display block devices."
1844 msgstr "Показати список блокових пристроїв."
1847 #: ../cat/virt-filesystems.pod:135 ../cat/virt-ls.pod:301 ../df/virt-df.pod:88
1852 #: ../cat/virt-filesystems.pod:137 ../cat/virt-ls.pod:303 ../df/virt-df.pod:90
1854 "Write out the results in CSV format (comma-separated values). This format "
1855 "can be imported easily into databases and spreadsheets, but read L</NOTE "
1856 "ABOUT CSV FORMAT> below."
1860 #: ../cat/virt-filesystems.pod:150
1862 "When prompting for keys and passphrases, virt-filesystems normally turns "
1863 "echoing off so you cannot see what you are typing. If you are not worried "
1864 "about Tempest attacks and there is no one else in the room you can specify "
1865 "this flag to see what you are typing."
1869 #: ../cat/virt-filesystems.pod:155
1874 #: ../cat/virt-filesystems.pod:157
1876 "This causes filesystems that are not ordinary, mountable filesystems to be "
1877 "displayed. This category includes swapspace, and filesystems that are empty "
1878 "or contain unknown data."
1882 #: ../cat/virt-filesystems.pod:161
1883 msgid "This option implies I<--filesystems>."
1887 #: ../cat/virt-filesystems.pod:163
1888 msgid "B<--filesystems>"
1889 msgstr "B<--filesystems>"
1892 #: ../cat/virt-filesystems.pod:165
1894 "Display mountable filesystems. If no display option was selected then this "
1895 "option is implied."
1899 #: ../cat/virt-filesystems.pod:168
1900 msgid "With I<--extra>, non-mountable filesystems are shown too."
1904 #: ../cat/virt-filesystems.pod:181
1907 " virt-filesystems --format=raw -a disk.img\n"
1910 " virt-filesystems --format=raw -a диск.img\n"
1914 #: ../cat/virt-filesystems.pod:185
1917 " virt-filesystems --format=raw -a disk.img --format -a another.img\n"
1922 #: ../cat/virt-filesystems.pod:194 ../cat/virt-ls.pod:352
1923 #: ../df/virt-df.pod:125 ../fish/guestfish.pod:156
1924 #: ../tools/virt-list-partitions.pl:109
1929 #: ../cat/virt-filesystems.pod:196 ../cat/virt-ls.pod:354
1930 #: ../df/virt-df.pod:127 ../tools/virt-list-partitions.pl:111
1931 msgid "B<--human-readable>"
1932 msgstr "B<--human-readable>"
1935 #: ../cat/virt-filesystems.pod:198
1936 msgid "In I<--long> mode, display sizes in human-readable format."
1940 #: ../cat/virt-filesystems.pod:205 ../cat/virt-ls.pod:366
1941 #: ../tools/virt-list-filesystems.pl:108 ../tools/virt-list-partitions.pl:119
1946 #: ../cat/virt-filesystems.pod:207 ../cat/virt-ls.pod:368
1947 #: ../tools/virt-list-filesystems.pl:110 ../tools/virt-list-partitions.pl:121
1952 #: ../cat/virt-filesystems.pod:209
1953 msgid "Display extra columns of data (\"long format\")."
1957 #: ../cat/virt-filesystems.pod:211
1958 msgid "A title row is added unless you also specify I<--no-title>."
1962 #: ../cat/virt-filesystems.pod:213
1964 "The extra columns displayed depend on what output you select, and the "
1965 "ordering of columns may change in future versions. Use the title row, I<--"
1966 "csv> output and/or L<csvtool(1)> to match columns to data in external "
1971 #: ../cat/virt-filesystems.pod:218
1973 "Use I<-h> if you want sizes to be displayed in human-readable format. The "
1974 "default is to show raw numbers of I<bytes>."
1978 #: ../cat/virt-filesystems.pod:221
1979 msgid "Use I<--uuid> to display UUIDs too."
1983 #: ../cat/virt-filesystems.pod:223
1988 #: ../cat/virt-filesystems.pod:225
1989 msgid "B<--logvols>"
1990 msgstr "B<--logvols>"
1993 #: ../cat/virt-filesystems.pod:227
1994 msgid "B<--logical-volumes>"
1995 msgstr "B<--logical-volumes>"
1998 #: ../cat/virt-filesystems.pod:229
2000 "Display LVM logical volumes. In this mode, these are displayed irrespective "
2001 "of whether the LVs contain filesystems."
2005 #: ../cat/virt-filesystems.pod:232
2006 msgid "B<--no-title>"
2007 msgstr "B<--no-title>"
2010 #: ../cat/virt-filesystems.pod:234
2011 msgid "In I<--long> mode, don't add a title row."
2015 #: ../cat/virt-filesystems.pod:236
2017 "Note that the order of the columns is not fixed, and may change in future "
2018 "versions of virt-filesystems, so using this option may give you unexpected "
2023 #: ../cat/virt-filesystems.pod:240
2028 #: ../cat/virt-filesystems.pod:242
2029 msgid "B<--partitions>"
2030 msgstr "B<--partitions>"
2033 #: ../cat/virt-filesystems.pod:244
2035 "Display partitions. In this mode, these are displayed irrespective of "
2036 "whether the partitions contain filesystems."
2040 #: ../cat/virt-filesystems.pod:247
2045 #: ../cat/virt-filesystems.pod:249
2046 msgid "B<--physvols>"
2047 msgstr "B<--physvols>"
2050 #: ../cat/virt-filesystems.pod:251
2051 msgid "B<--physical-volumes>"
2052 msgstr "B<--physical-volumes>"
2055 #: ../cat/virt-filesystems.pod:253
2056 msgid "Display LVM physical volumes."
2060 #: ../cat/virt-filesystems.pod:255 ../df/virt-df.pod:163
2065 #: ../cat/virt-filesystems.pod:257
2070 #: ../cat/virt-filesystems.pod:259
2071 msgid "In I<--long> mode, display UUIDs as well."
2075 #: ../cat/virt-filesystems.pod:273
2080 #: ../cat/virt-filesystems.pod:275
2081 msgid "B<--volgroups>"
2082 msgstr "B<--volgroups>"
2085 #: ../cat/virt-filesystems.pod:277
2086 msgid "B<--volume-groups>"
2087 msgstr "B<--volume-groups>"
2090 #: ../cat/virt-filesystems.pod:279
2091 msgid "Display LVM volume groups."
2095 #: ../cat/virt-filesystems.pod:287
2100 #: ../cat/virt-filesystems.pod:289
2102 "Note that columns in the output are subject to reordering and change in "
2103 "future versions of this tool."
2107 #: ../cat/virt-filesystems.pod:294
2112 #: ../cat/virt-filesystems.pod:296
2113 msgid "The filesystem, partition, block device or LVM name."
2117 #: ../cat/virt-filesystems.pod:298
2119 "For device and partition names these are displayed as canonical libguestfs "
2120 "names, so that for example C</dev/sda2> is the second partition on the first "
2125 #: ../cat/virt-filesystems.pod:302
2127 "If the I<--long> option is B<not> specified, then only the name column is "
2128 "shown in the output."
2132 #: ../cat/virt-filesystems.pod:305
2137 #: ../cat/virt-filesystems.pod:307
2138 msgid "The object type, for example C<filesystem>, C<lv>, C<device> etc."
2142 #: ../cat/virt-filesystems.pod:309
2147 #: ../cat/virt-filesystems.pod:311
2149 "If there is a filesystem, then this column displays the filesystem type if "
2150 "one could be detected, eg. C<ext4>."
2154 #: ../cat/virt-filesystems.pod:314
2159 #: ../cat/virt-filesystems.pod:316
2161 "If the object has a label (used for identifying and mounting filesystems) "
2162 "then this column contains the label."
2166 #: ../cat/virt-filesystems.pod:319
2171 #: ../cat/virt-filesystems.pod:321
2173 "The partition type byte, displayed as a two digit hexadecimal number. A "
2174 "comprehensive list of partition types can be found here: L<http://www.win."
2175 "tue.nl/~aeb/partitions/partition_types-1.html>"
2179 #: ../cat/virt-filesystems.pod:325
2180 msgid "This is only applicable for DOS (MBR) partitions."
2184 #: ../cat/virt-filesystems.pod:327
2189 #: ../cat/virt-filesystems.pod:329
2191 "The size of the object in bytes. If the I<--human> option is used then the "
2192 "size is displayed in a human-readable form."
2196 #: ../cat/virt-filesystems.pod:332
2201 #: ../cat/virt-filesystems.pod:334
2203 "The parent column records the parent relationship between objects. For "
2204 "example, if the object is a partition, then this column contains the name of "
2205 "the containing device. If the object is a logical volume, then this column "
2206 "is the name of the volume group."
2210 #: ../cat/virt-filesystems.pod:339
2215 #: ../cat/virt-filesystems.pod:341
2217 "If the object has a UUID (used for identifying and mounting filesystems and "
2218 "block devices) then this column contains the UUID as a string."
2222 #: ../cat/virt-filesystems.pod:345
2223 msgid "The UUID is only displayed if the I<--uuid> option is given."
2227 #: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:459
2228 #: ../df/virt-df.pod:191
2229 msgid "NOTE ABOUT CSV FORMAT"
2233 #: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:461
2234 #: ../df/virt-df.pod:193
2236 "Comma-separated values (CSV) is a deceptive format. It I<seems> like it "
2237 "should be easy to parse, but it is definitely not easy to parse."
2241 #: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:464
2242 #: ../df/virt-df.pod:196
2244 "Myth: Just split fields at commas. Reality: This does I<not> work "
2245 "reliably. This example has two columns:"
2249 #: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:467
2250 #: ../df/virt-df.pod:199
2253 " \"foo,bar\",baz\n"
2258 #: ../cat/virt-filesystems.pod:359 ../cat/virt-ls.pod:469
2259 #: ../df/virt-df.pod:201
2261 "Myth: Read the file one line at a time. Reality: This does I<not> work "
2262 "reliably. This example has one row:"
2266 #: ../cat/virt-filesystems.pod:362 ../cat/virt-ls.pod:472
2267 #: ../df/virt-df.pod:204
2276 #: ../cat/virt-filesystems.pod:365 ../cat/virt-ls.pod:475
2277 #: ../df/virt-df.pod:207
2279 "For shell scripts, use C<csvtool> (L<http://merjis.com/developers/csv> also "
2280 "packaged in major Linux distributions)."
2284 #: ../cat/virt-filesystems.pod:368 ../cat/virt-ls.pod:478
2285 #: ../df/virt-df.pod:210
2287 "For other languages, use a CSV processing library (eg. C<Text::CSV> for Perl "
2288 "or Python's built-in csv library)."
2292 #: ../cat/virt-filesystems.pod:371 ../cat/virt-ls.pod:481
2293 #: ../df/virt-df.pod:213
2294 msgid "Most spreadsheets and databases can import CSV directly."
2298 #: ../cat/virt-filesystems.pod:387
2300 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-df(1)>, L<virt-list-"
2301 "filesystems(1)>, L<virt-list-partitions(1)>, L<csvtool(1)>, L<http://"
2304 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-df(1)>, L<virt-list-"
2305 "filesystems(1)>, L<virt-list-partitions(1)>, L<csvtool(1)>, L<http://"
2309 #: ../cat/virt-filesystems.pod:402 ../tools/virt-win-reg.pl:789
2310 msgid "Copyright (C) 2010 Red Hat Inc."
2311 msgstr "©Red Hat Inc., 2010"
2314 #: ../cat/virt-ls.pod:5
2315 msgid "virt-ls - List files in a virtual machine"
2319 #: ../cat/virt-ls.pod:9
2322 " virt-ls [--options] -d domname directory [directory ...]\n"
2327 #: ../cat/virt-ls.pod:11
2330 " virt-ls [--options] -a disk.img [-a disk.img ...] directory [directory ...]\n"
2335 #: ../cat/virt-ls.pod:13 ../df/virt-df.pod:15 ../rescue/virt-rescue.pod:15
2337 msgstr "Старий стиль:"
2340 #: ../cat/virt-ls.pod:15
2343 " virt-ls [--options] domname directory\n"
2348 #: ../cat/virt-ls.pod:17
2351 " virt-ls [--options] disk.img [disk.img ...] directory\n"
2356 #: ../cat/virt-ls.pod:21
2358 "C<virt-ls> lists filenames, file sizes, checksums, extended attributes and "
2359 "more from a virtual machine or disk image."
2363 #: ../cat/virt-ls.pod:24
2365 "Multiple directory names can be given, in which case the output from each is "
2370 #: ../cat/virt-ls.pod:27
2372 "To list directories from a libvirt guest use the I<-d> option to specify the "
2373 "name of the guest. For a disk image, use the I<-a> option."
2377 #: ../cat/virt-ls.pod:31
2379 "C<virt-ls> can do many simple file listings. For more complicated cases you "
2380 "may need to use L<guestfish(1)>, or write a program directly to the L<guestfs"
2385 #: ../cat/virt-ls.pod:37
2386 msgid "Get a list of all files and directories in a virtual machine:"
2390 #: ../cat/virt-ls.pod:39
2393 " virt-ls -R -d guest /\n"
2398 #: ../cat/virt-ls.pod:41 ../examples/guestfs-testing.pod:160
2399 msgid "List all setuid or setgid programs in a Linux virtual machine:"
2403 #: ../cat/virt-ls.pod:43
2406 " virt-ls -lR -d guest / | grep '^- [42]'\n"
2411 #: ../cat/virt-ls.pod:45 ../examples/guestfs-testing.pod:164
2412 msgid "List all public-writable directories in a Linux virtual machine:"
2416 #: ../cat/virt-ls.pod:47
2419 " virt-ls -lR -d guest / | grep '^d ...7'\n"
2424 #: ../cat/virt-ls.pod:49 ../examples/guestfs-testing.pod:168
2425 msgid "List all Unix domain sockets in a Linux virtual machine:"
2429 #: ../cat/virt-ls.pod:51
2432 " virt-ls -lR -d guest / | grep '^s'\n"
2437 #: ../cat/virt-ls.pod:53 ../examples/guestfs-testing.pod:172
2438 msgid "List all regular files with filenames ending in '.png':"
2442 #: ../cat/virt-ls.pod:55
2445 " virt-ls -lR -d guest / | grep -i '^-.*\\.png$'\n"
2450 #: ../cat/virt-ls.pod:57
2451 msgid "To display files larger than 10MB in home directories:"
2455 #: ../cat/virt-ls.pod:59
2458 " virt-ls -lR -d guest /home | awk '$3 > 10*1024*1024'\n"
2463 #: ../cat/virt-ls.pod:61 ../examples/guestfs-testing.pod:180
2464 msgid "Find everything modified in the last 7 days:"
2468 #: ../cat/virt-ls.pod:63
2471 " virt-ls -lR -d guest --time-days / | awk '$6 <= 7'\n"
2476 #: ../cat/virt-ls.pod:65 ../examples/guestfs-testing.pod:184
2477 msgid "Find regular files modified in the last 24 hours:"
2481 #: ../cat/virt-ls.pod:67
2484 " virt-ls -lR -d guest --time-days / | grep '^-' | awk '$6 < 1'\n"
2489 #: ../cat/virt-ls.pod:69
2490 msgid "DIFFERENCES IN SNAPSHOTS AND BACKING FILES"
2494 #: ../cat/virt-ls.pod:71
2496 "Find the differences between files in a guest and an earlier snapshot of the "
2501 #: ../cat/virt-ls.pod:74
2504 " virt-ls -lR -a snapshot.img / --uids --time-t > old\n"
2505 " virt-ls -lR -a current.img / --uids --time-t > new\n"
2506 " diff -u old new | less\n"
2511 #: ../cat/virt-ls.pod:78
2513 "The commands above won't find files where the content has changed but the "
2514 "metadata (eg. file size and modification date) is the same. To do that, you "
2515 "need to add the I<--checksum> parameter to both C<virt-ls> commands. I<--"
2516 "checksum> can be quite slow since it has to read and compute a checksum of "
2517 "every regular file in the virtual machine."
2521 #: ../cat/virt-ls.pod:84
2522 msgid "OUTPUT MODES"
2523 msgstr "РЕЖИМИ ВИВЕДЕННЯ ДАНИХ"
2526 #: ../cat/virt-ls.pod:86
2528 "C<virt-ls> has four output modes, controlled by different combinations of "
2529 "the I<-l> and I<-R> options."
2533 #: ../cat/virt-ls.pod:89
2534 msgid "SIMPLE LISTING"
2535 msgstr "ПРОСТИЙ СПИСОК"
2538 #: ../cat/virt-ls.pod:91
2539 msgid "A simple listing is like the ordinary L<ls(1)> command:"
2543 #: ../cat/virt-ls.pod:93
2546 " $ virt-ls -d guest /\n"
2552 " $ virt-ls -d guest /\n"
2559 #: ../cat/virt-ls.pod:98
2560 msgid "LONG LISTING"
2561 msgstr "ДОВГИЙ СПИСОК"
2564 #: ../cat/virt-ls.pod:100
2566 "With the I<-l> (I<--long>) option, the output is like the C<ls -l> command "
2567 "(more specifically, like the C<guestfs_ll> function)."
2571 #: ../cat/virt-ls.pod:103
2574 " $ virt-ls -l -d guest /\n"
2576 " dr-xr-xr-x. 2 root root 4096 2009-08-25 19:06 bin\n"
2577 " dr-xr-xr-x. 5 root root 3072 2009-08-25 19:06 boot\n"
2581 " $ virt-ls -l -d guest /\n"
2583 " dr-xr-xr-x. 2 root root 4096 2009-08-25 19:06 bin\n"
2584 " dr-xr-xr-x. 5 root root 3072 2009-08-25 19:06 boot\n"
2589 #: ../cat/virt-ls.pod:109
2591 "Note that while this is useful for displaying a directory, do not try "
2592 "parsing this output in another program. Use L</RECURSIVE LONG LISTING> "
2597 #: ../cat/virt-ls.pod:113
2598 msgid "RECURSIVE LISTING"
2599 msgstr "РЕКУРСИВНИЙ СПИСОК"
2602 #: ../cat/virt-ls.pod:115
2604 "With the I<-R> (I<--recursive>) option, C<virt-ls> lists the names of files "
2605 "and directories recursively:"
2609 #: ../cat/virt-ls.pod:118
2612 " $ virt-ls -R -d guest /tmp\n"
2618 " $ virt-ls -R -d guest /tmp\n"
2625 #: ../cat/virt-ls.pod:123
2627 "To generate this output, C<virt-ls> runs the C<guestfs_find0> function and "
2628 "converts C<\\0> characters to C<\\n>."
2632 #: ../cat/virt-ls.pod:126
2633 msgid "RECURSIVE LONG LISTING"
2634 msgstr "РЕКУРСИВНИЙ ДОВГИЙ СПИСОК"
2637 #: ../cat/virt-ls.pod:128
2639 "Using I<-lR> options together changes the output to display directories "
2640 "recursively, with file stats, and optionally other features such as "
2641 "checksums and extended attributes."
2645 #: ../cat/virt-ls.pod:132
2647 "Most of the interesting features of C<virt-ls> are only available when using "
2652 #: ../cat/virt-ls.pod:135
2654 "The fields are normally space-separated. Filenames are B<not> quoted, so "
2655 "you cannot use the output in another program (because filenames can contain "
2656 "spaces and other unsafe characters). If the guest was untrusted and someone "
2657 "knew you were using C<virt-ls> to analyze the guest, they could play tricks "
2658 "on you by creating filenames with embedded newline characters. To B<safely> "
2659 "parse the output in another program, use the I<--csv> (Comma-Separated "
2664 #: ../cat/virt-ls.pod:143
2666 "Note that this output format is completely unrelated to the C<ls -lR> "
2671 #: ../cat/virt-ls.pod:146
2674 " $ virt-ls -lR -d guest /bin\n"
2675 " d 0555 4096 /bin\n"
2676 " - 0755 123 /bin/alsaunmute\n"
2677 " - 0755 28328 /bin/arch\n"
2678 " l 0777 4 /bin/awk -> gawk\n"
2679 " - 0755 27216 /bin/basename\n"
2680 " - 0755 943360 /bin/bash\n"
2684 " $ virt-ls -lR -d guest /bin\n"
2685 " d 0555 4096 /bin\n"
2686 " - 0755 123 /bin/alsaunmute\n"
2687 " - 0755 28328 /bin/arch\n"
2688 " l 0777 4 /bin/awk -> gawk\n"
2689 " - 0755 27216 /bin/basename\n"
2690 " - 0755 943360 /bin/bash\n"
2695 #: ../cat/virt-ls.pod:155
2696 msgid "These basic fields are always shown:"
2700 #: ../cat/virt-ls.pod:159
2705 #: ../cat/virt-ls.pod:161
2707 "The file type, one of: C<-> (regular file), C<d> (directory), C<c> "
2708 "(character device), C<b> (block device), C<p> (named pipe), C<l> (symbolic "
2709 "link), C<s> (socket) or C<u> (unknown)."
2713 #: ../cat/virt-ls.pod:171
2715 msgstr "права доступу"
2718 #: ../cat/virt-ls.pod:173
2719 msgid "The Unix permissions, displayed as a 4 digit octal number."
2723 #: ../cat/virt-ls.pod:175
2728 #: ../cat/virt-ls.pod:177
2730 "The size of the file. This is shown in bytes unless I<-h> or I<--human-"
2731 "readable> option is given, in which case this is shown as a human-readable "
2736 #: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4477
2741 #: ../cat/virt-ls.pod:183
2742 msgid "The full path of the file or directory."
2746 #: ../cat/virt-ls.pod:185
2751 #: ../cat/virt-ls.pod:187
2752 msgid "For symbolic links only, the link target."
2756 #: ../cat/virt-ls.pod:191
2758 "In I<-lR> mode, additional command line options enable the display of more "
2763 #: ../cat/virt-ls.pod:194
2765 "With the I<--uids> flag, these additional fields are displayed before the "
2770 #: ../cat/virt-ls.pod:199
2775 #: ../cat/virt-ls.pod:201
2780 #: ../cat/virt-ls.pod:203
2782 "The UID and GID of the owner of the file (displayed numerically). Note "
2783 "these only make sense in the context of a Unix-like guest."
2787 #: ../cat/virt-ls.pod:208
2788 msgid "With the I<--times> flag, these additional fields are displayed:"
2792 #: ../cat/virt-ls.pod:212
2797 #: ../cat/virt-ls.pod:214
2798 msgid "The time of last access."
2799 msgstr "Час останнього доступу."
2802 #: ../cat/virt-ls.pod:216
2807 #: ../cat/virt-ls.pod:218
2808 msgid "The time of last modification."
2809 msgstr "Час останнього внесення змін."
2812 #: ../cat/virt-ls.pod:220
2817 #: ../cat/virt-ls.pod:222
2818 msgid "The time of last status change."
2819 msgstr "Час останньої зміни стану."
2822 #: ../cat/virt-ls.pod:226
2824 "The time fields are displayed as string dates and times, unless one of the "
2825 "I<--time-t>, I<--time-relative> or I<--time-days> flags is given."
2829 #: ../cat/virt-ls.pod:229
2830 msgid "With the I<--extra-stats> flag, these additional fields are displayed:"
2834 #: ../cat/virt-ls.pod:233
2839 #: ../cat/virt-ls.pod:235
2841 "The device containing the file (displayed as major:minor). This may not "
2842 "match devices as known to the guest."
2846 #: ../cat/virt-ls.pod:238
2851 #: ../cat/virt-ls.pod:240
2852 msgid "The inode number."
2856 #: ../cat/virt-ls.pod:242
2861 #: ../cat/virt-ls.pod:244
2862 msgid "The number of hard links."
2863 msgstr "Кількість жорстких посилань."
2866 #: ../cat/virt-ls.pod:246
2871 #: ../cat/virt-ls.pod:248
2873 "For block and char special files, the device (displayed as major:minor)."
2877 #: ../cat/virt-ls.pod:251
2882 #: ../cat/virt-ls.pod:253
2883 msgid "The number of 512 byte blocks allocated to the file."
2887 #: ../cat/virt-ls.pod:257
2889 "With the I<--checksum> flag, the checksum of the file contents is shown "
2890 "(only for regular files). Computing file checksums can take a considerable "
2895 #: ../cat/virt-ls.pod:280
2896 msgid "B<--checksum>"
2897 msgstr "B<--checksum>"
2900 #: ../cat/virt-ls.pod:282
2901 msgid "B<--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512>"
2902 msgstr "B<--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512>"
2905 #: ../cat/virt-ls.pod:284
2907 "Display checksum over file contents for regular files. With no argument, "
2908 "this defaults to using I<md5>. Using an argument, you can select the "
2909 "checksum type to use."
2913 #: ../cat/virt-ls.pod:288 ../cat/virt-ls.pod:325 ../cat/virt-ls.pod:358
2914 #: ../cat/virt-ls.pod:391 ../cat/virt-ls.pod:401 ../cat/virt-ls.pod:408
2915 #: ../cat/virt-ls.pod:415 ../cat/virt-ls.pod:422
2917 "This option only has effect in I<-lR> output mode. See L</RECURSIVE LONG "
2922 #: ../cat/virt-ls.pod:316
2924 "When prompting for keys and passphrases, virt-ls normally turns echoing off "
2925 "so you cannot see what you are typing. If you are not worried about Tempest "
2926 "attacks and there is no one else in the room you can specify this flag to "
2927 "see what you are typing."
2931 #: ../cat/virt-ls.pod:321
2932 msgid "B<--extra-stats>"
2933 msgstr "B<--extra-stats>"
2936 #: ../cat/virt-ls.pod:323
2937 msgid "Display extra stats."
2938 msgstr "Показати додаткові дані."
2941 #: ../cat/virt-ls.pod:339
2944 " virt-ls --format=raw -a disk.img /dir\n"
2949 #: ../cat/virt-ls.pod:343
2952 " virt-ls --format=raw -a disk.img --format -a another.img /dir\n"
2957 #: ../cat/virt-ls.pod:356
2958 msgid "Display file sizes in human-readable format."
2962 #: ../cat/virt-ls.pod:370
2967 #: ../cat/virt-ls.pod:372
2968 msgid "B<--recursive>"
2969 msgstr "B<--recursive>"
2972 #: ../cat/virt-ls.pod:374
2974 "Select the mode. With neither of these options, C<virt-ls> produces a "
2975 "simple, flat list of the files in the named directory. See L</SIMPLE "
2980 #: ../cat/virt-ls.pod:378
2982 "C<virt-ls -l> produces a \"long listing\", which shows more detail. See L</"
2987 #: ../cat/virt-ls.pod:381
2989 "C<virt-ls -R> produces a recursive list of files starting at the named "
2990 "directory. See L</RECURSIVE LISTING>."
2994 #: ../cat/virt-ls.pod:384
2996 "C<virt-ls -lR> produces a recursive long listing which can be more easily "
2997 "parsed. See L</RECURSIVE LONG LISTING>."
3001 #: ../cat/virt-ls.pod:387
3006 #: ../cat/virt-ls.pod:389
3007 msgid "Display time fields."
3011 #: ../cat/virt-ls.pod:394
3012 msgid "B<--time-days>"
3013 msgstr "B<--time-days>"
3016 #: ../cat/virt-ls.pod:396
3017 msgid "Display time fields as days before now (negative if in the future)."
3021 #: ../cat/virt-ls.pod:398
3023 "Note that C<0> in output means \"up to 1 day before now\", or that the age "
3024 "of the file is between 0 and 86399 seconds."
3028 #: ../cat/virt-ls.pod:404
3029 msgid "B<--time-relative>"
3030 msgstr "B<--time-relative>"
3033 #: ../cat/virt-ls.pod:406
3034 msgid "Display time fields as seconds before now (negative if in the future)."
3038 #: ../cat/virt-ls.pod:411
3040 msgstr "B<--time-t>"
3043 #: ../cat/virt-ls.pod:413
3044 msgid "Display time fields as seconds since the Unix epoch."
3048 #: ../cat/virt-ls.pod:418
3053 #: ../cat/virt-ls.pod:420
3054 msgid "Display UID and GID fields."
3058 #: ../cat/virt-ls.pod:445
3059 msgid "Previous versions of virt-ls allowed you to write either:"
3063 #: ../cat/virt-ls.pod:447
3066 " virt-ls disk.img [disk.img ...] /dir\n"
3071 #: ../cat/virt-ls.pod:451
3074 " virt-ls guestname /dir\n"
3079 #: ../cat/virt-ls.pod:497
3081 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-out(1)>, L<virt-"
3082 "tar-out(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
3083 "L<http://libguestfs.org/>."
3085 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-out(1)>, L<virt-"
3086 "tar-out(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
3087 "L<http://libguestfs.org/>."
3090 #: ../cat/virt-ls.pod:513 ../df/virt-df.pod:241 ../edit/virt-edit.pod:374
3091 #: ../rescue/virt-rescue.pod:340
3092 msgid "Copyright (C) 2009-2011 Red Hat Inc."
3093 msgstr "©Red Hat Inc., 2009–2011"
3096 #: ../clone/virt-sysprep.pod:5
3098 "virt-sysprep - Reset or unconfigure a virtual machine so clones can be made"
3102 #: ../clone/virt-sysprep.pod:9
3105 " virt-sysprep [--options] -d domname\n"
3110 #: ../clone/virt-sysprep.pod:11
3113 " virt-sysprep [--options] -a disk.img [-a disk.img ...]\n"
3118 #: ../clone/virt-sysprep.pod:15
3120 "Virt-sysprep \"resets\" or \"unconfigures\" a virtual machine so that clones "
3121 "can be made from it. Steps in this process include removing SSH host keys, "
3122 "removing persistent network MAC configuration, and removing user accounts. "
3123 "Each step can be enabled or disabled as required."
3127 #: ../clone/virt-sysprep.pod:21
3129 "Virt-sysprep is a simple shell script, allowing easy inspection or "
3130 "customization by the system administrator."
3134 #: ../clone/virt-sysprep.pod:24
3136 "Virt-sysprep modifies the guest or disk image I<in place>. The guest must "
3137 "be shut down. If you want to preserve the existing contents of the guest, "
3138 "you I<must copy or clone the disk first>. See L</COPYING AND CLONING> below."
3142 #: ../clone/virt-sysprep.pod:29
3144 "You do I<not> need to run virt-sysprep as root. In fact we'd generally "
3145 "recommend that you don't. The time you might want to run it as root is when "
3146 "you need root in order to access the disk image, but even in this case it "
3147 "would be better to change the permissions on the disk image to be writable "
3148 "as the non-root user running virt-sysprep."
3152 #: ../clone/virt-sysprep.pod:35
3154 "\"Sysprep\" stands for \"system preparation\" tool. The name comes from the "
3155 "Microsoft program C<sysprep.exe> which is used to unconfigure Windows "
3156 "machines in preparation for cloning them. Having said that, virt-sysprep "
3157 "does I<not> currently work on Microsoft Windows guests. We plan to support "
3158 "Windows sysprepping in a future version, and we already have code to do it."
3162 #: ../clone/virt-sysprep.pod:76
3163 msgid "B<--enable=...>"
3167 #: ../clone/virt-sysprep.pod:78
3169 "Choose which sysprep operations to perform. Give a comma-separated list of "
3170 "operations, for example:"
3174 #: ../clone/virt-sysprep.pod:81
3177 " --enable=ssh-hostkeys,udev-persistent-net\n"
3182 #: ../clone/virt-sysprep.pod:83
3184 "would enable ONLY C<ssh-hostkeys> and C<udev-persistent-net> operations."
3188 #: ../clone/virt-sysprep.pod:85
3190 "If the I<--enable> option is not given, then we default to trying all "
3191 "possible sysprep operations. But some sysprep operations are skipped for "
3196 #: ../clone/virt-sysprep.pod:89
3198 "Use I<--list-operations> to list operations supported by a particular "
3199 "version of virt-sysprep."
3203 #: ../clone/virt-sysprep.pod:92
3205 "See L</OPERATIONS> below for a list and an explanation of each operation."
3209 #: ../clone/virt-sysprep.pod:106
3212 " virt-sysprep --format=raw -a disk.img\n"
3217 #: ../clone/virt-sysprep.pod:110
3220 " virt-sysprep --format=raw -a disk.img --format -a another.img\n"
3225 #: ../clone/virt-sysprep.pod:119
3226 msgid "B<--hostname> newhostname"
3230 #: ../clone/virt-sysprep.pod:121
3232 "Change the hostname. See the L</hostname> operation below. If not given, "
3233 "defaults to C<localhost.localdomain>."
3237 #: ../clone/virt-sysprep.pod:124
3238 msgid "B<--list-operations>"
3242 #: ../clone/virt-sysprep.pod:126
3243 msgid "List the operations supported by the virt-sysprep program."
3247 #: ../clone/virt-sysprep.pod:128
3248 msgid "B<--selinux-relabel>"
3252 #: ../clone/virt-sysprep.pod:130
3253 msgid "B<--no-selinux-relabel>"
3257 #: ../clone/virt-sysprep.pod:132
3259 "I<--selinux-relabel> forces SELinux relabelling next time the guest boots. "
3260 "I<--no-selinux-relabel> disables relabelling."
3264 #: ../clone/virt-sysprep.pod:135
3266 "The default is to try to detect if SELinux relabelling is required. See L</"
3267 "SELINUX RELABELLING> below for more details."
3271 #: ../clone/virt-sysprep.pod:156
3276 #: ../clone/virt-sysprep.pod:158
3278 "If the I<--enable> option is I<not> given, then I<all sysprep operations are "
3279 "enabled>, although some are skipped depending on the type of guest."
3283 #: ../clone/virt-sysprep.pod:162
3285 "Operations can be individually enabled using the I<--enable> option. Use a "
3286 "comma-separated list, for example:"
3290 #: ../clone/virt-sysprep.pod:165
3293 " virt-sysprep --enable=ssh-hostkeys,udev-persistent-net [etc..]\n"
3298 #: ../clone/virt-sysprep.pod:167
3300 "To list the operations supported by the current version of virt-sysprep, use "
3301 "I<--list-operations>."
3305 #: ../clone/virt-sysprep.pod:170
3307 "Future versions of virt-sysprep may add more operations. If you are using "
3308 "virt-sysprep and want predictable behaviour, specify only the operations "
3309 "that you want to have enabled."
3313 #: ../clone/virt-sysprep.pod:174
3318 #: ../clone/virt-sysprep.pod:176
3319 msgid "Remove user at-jobs and cron-jobs."
3323 #: ../clone/virt-sysprep.pod:178
3324 msgid "dhcp-client-state"
3328 #: ../clone/virt-sysprep.pod:180
3329 msgid "Remove DHCP client leases."
3333 #: ../clone/virt-sysprep.pod:182
3334 msgid "dhcp-server-state"
3338 #: ../clone/virt-sysprep.pod:184
3339 msgid "Remove DHCP server leases."
3343 #: ../clone/virt-sysprep.pod:186
3348 #: ../clone/virt-sysprep.pod:188
3350 "Changes the hostname of the guest to the value given in the I<--hostname> "
3355 #: ../clone/virt-sysprep.pod:191
3357 "If the I<--hostname> parameter is not given, then the hostname is changed to "
3358 "C<localhost.localdomain>."
3362 #: ../clone/virt-sysprep.pod:194
3367 #: ../clone/virt-sysprep.pod:196
3368 msgid "Remove many log files."
3372 #: ../clone/virt-sysprep.pod:198
3377 #: ../clone/virt-sysprep.pod:200
3378 msgid "Remove email from the local mail spool directory."
3382 #: ../clone/virt-sysprep.pod:202
3387 #: ../clone/virt-sysprep.pod:204
3389 "Remove HWADDR (hard-coded MAC address) configuration. For Fedora and Red "
3390 "Hat Enterprise Linux, this is removed from C<ifcfg-*> files."
3394 #: ../clone/virt-sysprep.pod:207
3399 #: ../clone/virt-sysprep.pod:209
3401 "Write some random bytes from the host into the random seed file of the guest."
3405 #: ../clone/virt-sysprep.pod:212
3406 msgid "See L</RANDOM SEED> below."
3410 #: ../clone/virt-sysprep.pod:214
3411 msgid "rhn-systemid"
3415 #: ../clone/virt-sysprep.pod:216
3416 msgid "Remove the RHN system ID."
3420 #: ../clone/virt-sysprep.pod:218
3425 #: ../clone/virt-sysprep.pod:220
3426 msgid "Remove the Smolt hardware UUID."
3430 #: ../clone/virt-sysprep.pod:222
3431 msgid "ssh-hostkeys"
3435 #: ../clone/virt-sysprep.pod:224
3436 msgid "Remove the SSH host keys in the guest."
3440 #: ../clone/virt-sysprep.pod:226
3442 "The SSH host keys are regenerated (differently) next time the guest is "
3447 #: ../clone/virt-sysprep.pod:229
3449 "If, after cloning, the guest gets the same IP address, ssh will give you a "
3450 "stark warning about the host key changing:"
3454 #: ../clone/virt-sysprep.pod:232
3457 " @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n"
3458 " @ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @\n"
3459 " @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n"
3460 " IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!\n"
3465 #: ../clone/virt-sysprep.pod:237
3466 msgid "udev-persistent-net"
3470 #: ../clone/virt-sysprep.pod:239
3472 "Remove udev persistent net rules which map the guest's existing MAC address "
3473 "to a fixed ethernet device (eg. eth0)."
3477 #: ../clone/virt-sysprep.pod:242
3479 "After a guest is cloned, the MAC address usually changes. Since the old MAC "
3480 "address occupies the old name (eg. eth0), this means the fresh MAC address "
3481 "is assigned to a new name (eg. eth1) and this is usually undesirable. "
3482 "Erasing the udev persistent net rules avoids this."
3486 #: ../clone/virt-sysprep.pod:247
3491 #: ../clone/virt-sysprep.pod:249
3492 msgid "Remove the utmp file."
3496 #: ../clone/virt-sysprep.pod:251
3498 "This records who is currently logged in on a machine. In modern Linux "
3499 "distros it is stored in a ramdisk and hence not part of the virtual "
3500 "machine's disk, but it was stored on disk in older distros."
3504 #: ../clone/virt-sysprep.pod:255
3509 #: ../clone/virt-sysprep.pod:257
3510 msgid "Remove the yum UUID."
3514 #: ../clone/virt-sysprep.pod:259
3516 "Yum creates a fresh UUID the next time it runs when it notices that the "
3517 "original UUID has been erased."
3521 #: ../clone/virt-sysprep.pod:262
3522 msgid "COPYING AND CLONING"
3526 #: ../clone/virt-sysprep.pod:264
3528 "Virt-sysprep can be used as part of a process of cloning guests, or to "
3529 "prepare a template from which guests can be cloned. There are many "
3530 "different ways to achieve this using the virt tools, and this section is "
3531 "just an introduction."
3535 #: ../clone/virt-sysprep.pod:269
3536 msgid "A virtual machine (when switched off) consists of two parts:"
3540 #: ../clone/virt-sysprep.pod:273
3541 msgid "I<configuration>"
3545 #: ../clone/virt-sysprep.pod:275
3547 "The configuration or description of the guest. eg. The libvirt XML (see "
3548 "C<virsh dumpxml>), the running configuration of the guest, or another "
3549 "external format like OVF."
3553 #: ../clone/virt-sysprep.pod:279
3554 msgid "Some configuration items that might need to be changed:"
3558 #: ../clone/virt-sysprep.pod:285
3563 #: ../clone/virt-sysprep.pod:289 ../clone/virt-sysprep.pod:316
3568 #: ../clone/virt-sysprep.pod:293
3569 msgid "path to block device(s)"
3573 #: ../clone/virt-sysprep.pod:297
3574 msgid "network card MAC address"
3578 #: ../clone/virt-sysprep.pod:301
3579 msgid "I<block device(s)>"
3583 #: ../clone/virt-sysprep.pod:303
3585 "One or more hard disk images, themselves containing files, directories, "
3586 "applications, kernels, configuration, etc."
3590 #: ../clone/virt-sysprep.pod:306
3591 msgid "Some things inside the block devices that might need to be changed:"
3595 #: ../clone/virt-sysprep.pod:312
3596 msgid "hostname and other net configuration"
3600 #: ../clone/virt-sysprep.pod:320
3601 msgid "SSH host keys"
3605 #: ../clone/virt-sysprep.pod:324
3606 msgid "Windows unique security ID (SID)"
3610 #: ../clone/virt-sysprep.pod:328
3611 msgid "Puppet registration"
3615 #: ../clone/virt-sysprep.pod:334
3616 msgid "COPYING THE BLOCK DEVICE"
3620 #: ../clone/virt-sysprep.pod:336
3622 "Starting with an original guest, you probably wish to copy the guest block "
3623 "device and its configuration to make a template. Then once you are happy "
3624 "with the template, you will want to make many clones from it."
3628 #: ../clone/virt-sysprep.pod:341
3634 " original guest --------> template ---------->\n"
3635 " \\------> cloned\n"
3636 " \\-----> guests\n"
3642 #: ../clone/virt-sysprep.pod:349
3644 "You can, of course, just copy the block device on the host using L<cp(1)> or "
3649 #: ../clone/virt-sysprep.pod:352
3653 " original guest --------> template ---------->\n"
3654 " \\------> cloned\n"
3655 " \\-----> guests\n"
3661 #: ../clone/virt-sysprep.pod:358
3662 msgid "There are some smarter (and faster) ways too:"
3666 #: ../clone/virt-sysprep.pod:364
3670 " template ---------->\n"
3671 " \\------> cloned\n"
3672 " \\-----> guests\n"
3678 #: ../clone/virt-sysprep.pod:370
3680 "Use the block device as a backing file and create a snapshot on top for each "
3681 "guest. The advantage is that you don't need to copy the block device (very "
3682 "fast) and only changes are stored (less storage required)."
3686 #: ../clone/virt-sysprep.pod:375
3688 "Note that writing to the backing file once you have created guests on top of "
3689 "it is not possible: you will corrupt the guests."
3693 #: ../clone/virt-sysprep.pod:378
3695 "Tools that can do this include: L<qemu-img(1)> (with the I<create -f qcow2 -"
3696 "o backing_file> option), L<lvcreate(8)> (I<--snapshot> option). Some "
3697 "filesystems (such as btrfs) and most Network Attached Storage devices can "
3698 "also create cheap snapshots from files or LUNs."
3702 #: ../clone/virt-sysprep.pod:386
3703 msgid "Get your NAS to snapshot and/or duplicate the LUN."
3707 #: ../clone/virt-sysprep.pod:390
3708 msgid "Prepare your template using L<virt-sparsify(1)>. See below."
3712 #: ../clone/virt-sysprep.pod:394
3717 #: ../clone/virt-sysprep.pod:396
3719 "A separate tool, L<virt-clone(1)>, can be used to duplicate the block device "
3720 "and/or modify the external libvirt configuration of a guest. It will reset "
3721 "the name, UUID and MAC address of the guest in the libvirt XML."
3725 #: ../clone/virt-sysprep.pod:401
3727 "L<virt-clone(1)> does not use libguestfs and cannot look inside the disk "
3728 "image. This was the original motivation to write virt-sysprep."
3732 #: ../clone/virt-sysprep.pod:404
3737 #: ../clone/virt-sysprep.pod:406
3741 " original guest --------> template\n"
3746 #: ../clone/virt-sysprep.pod:409
3748 "L<virt-sparsify(1)> can be used to make the cloning template smaller, making "
3749 "it easier to compress and/or faster to copy."
3753 #: ../clone/virt-sysprep.pod:412
3755 "Notice that since virt-sparsify also copies the image, you can use it to "
3756 "make the initial copy (instead of C<dd>)."
3760 #: ../clone/virt-sysprep.pod:415
3765 #: ../clone/virt-sysprep.pod:417
3769 " template ---------->\n"
3770 " \\------> cloned\n"
3771 " \\-----> guests\n"
3777 #: ../clone/virt-sysprep.pod:423
3779 "If you want to give people cloned guests, but let them pick the size of the "
3780 "guest themselves (eg. depending on how much they are prepared to pay for "
3781 "disk space), then instead of copying the template, you can run L<virt-resize"
3782 "(1)>. Virt-resize performs a copy and resize, and thus is ideal for cloning "
3783 "guests from a template."
3787 #: ../clone/virt-sysprep.pod:429 ../src/guestfs.pod:1164
3792 #: ../clone/virt-sysprep.pod:431
3794 "Although virt-sysprep removes some sensitive information from the guest, it "
3795 "does not pretend to remove all of it. You should examine the L</OPERATIONS> "
3796 "above, and the implementation of the operations in the shell script. You "
3797 "should also examine the guest afterwards."
3801 #: ../clone/virt-sysprep.pod:436
3803 "Sensitive files are simply removed. The data they contained may still exist "
3804 "on the disk, easily recovered with a hex editor or undelete tool. Use "
3805 "L<virt-sparsify(1)> as one way to remove this content. See also the L<scrub"
3806 "(1)> command to get rid of deleted content in directory entries and inodes."
3810 #: ../clone/virt-sysprep.pod:442
3815 #: ../clone/virt-sysprep.pod:444
3816 msgid "I<(This section applies to Linux guests only)>"
3820 #: ../clone/virt-sysprep.pod:446
3822 "The virt-sysprep C<random-seed> operation writes a few bytes of randomness "
3823 "from the host into the guest's random seed file."
3827 #: ../clone/virt-sysprep.pod:449
3829 "If this is just done once and the guest is cloned from the same template, "
3830 "then each guest will start with the same entropy, and things like SSH host "
3831 "keys and TCP sequence numbers may be predictable."
3835 #: ../clone/virt-sysprep.pod:453
3837 "Therefore you should arrange to add more randomness I<after> cloning from a "
3838 "template too, which can be done by just enabling the C<random-seed> "
3843 #: ../clone/virt-sysprep.pod:457
3846 " cp template.img newguest.img\n"
3847 " virt-sysprep --enable=random-seed -a newguest.img\n"
3852 #: ../clone/virt-sysprep.pod:460
3853 msgid "SELINUX RELABELLING"
3857 #: ../clone/virt-sysprep.pod:462
3858 msgid "I<(This section applies to Linux guests using SELinux only)>"
3862 #: ../clone/virt-sysprep.pod:464
3864 "If any new files are created by virt-sysprep, then virt-sysprep touches C</."
3865 "autorelabel> so that these will be correctly labelled by SELinux the next "
3866 "time the guest is booted. This process interrupts boot and can take some "
3871 #: ../clone/virt-sysprep.pod:469
3873 "You can force relabelling for all guests by supplying the I<--selinux-"
3878 #: ../clone/virt-sysprep.pod:472
3880 "You can disable relabelling entirely by supplying the I<--no-selinux-"
3885 #: ../clone/virt-sysprep.pod:484
3886 msgid "This program returns 0 on success, or 1 if there was an error."
3890 #: ../clone/virt-sysprep.pod:488
3892 "L<guestfs(3)>, L<guestfish(1)>, L<virt-clone(1)>, L<virt-rescue(1)>, L<virt-"
3893 "resize(1)>, L<virt-sparsify(1)>, L<virsh(1)>, L<lvcreate(8)>, L<qemu-img(1)"
3894 ">, L<scrub(1)>, L<http://libguestfs.org/>, L<http://libvirt.org/>."
3898 #: ../df/virt-df.pod:5
3899 msgid "virt-df - Display free space on virtual filesystems"
3903 #: ../df/virt-df.pod:9
3906 " virt-df [--options]\n"
3909 " virt-df [--параметри]\n"
3913 #: ../df/virt-df.pod:11
3916 " virt-df [--options] -d domname\n"
3921 #: ../df/virt-df.pod:13
3924 " virt-df [--options] -a disk.img [-a disk.img ...]\n"
3929 #: ../df/virt-df.pod:17
3932 " virt-df [--options] domname\n"
3937 #: ../df/virt-df.pod:19
3940 " virt-df [--options] disk.img [disk.img ...]\n"
3945 #: ../df/virt-df.pod:23
3947 "C<virt-df> is a command line tool to display free space on virtual machine "
3948 "filesystems. Unlike other tools, it doesn't just display the size of disk "
3949 "allocated to a virtual machine, but can look inside disk images to see how "
3950 "much space is really being used."
3954 #: ../df/virt-df.pod:28
3956 "If used without any I<-a> or I<-d> arguments, C<virt-df> checks with libvirt "
3957 "to get a list of all active and inactive guests, and performs a C<df>-type "
3958 "operation on each one in turn, printing out the results."
3962 #: ../df/virt-df.pod:32
3964 "If any I<-a> or I<-d> arguments are specified, C<virt-df> performs a C<df>-"
3965 "type operation on either the single named libvirt domain, or on the disk "
3966 "image(s) listed on the command line (which must all belong to a single VM). "
3967 "In this mode (with arguments), C<virt-df> will I<only work for a single "
3968 "guest>. If you want to run on multiple guests, then you have to invoke "
3969 "C<virt-df> multiple times."
3973 #: ../df/virt-df.pod:39
3975 "Use the I<--csv> option to get a format which can be easily parsed by other "
3976 "programs. Other options are similar to the standard L<df(1)> command."
3980 #: ../df/virt-df.pod:45
3982 "Show disk usage for a single libvirt guest called C<F14x64>. Make the "
3983 "output human-readable:"
3987 #: ../df/virt-df.pod:48
3990 " # virt-df -d F14x64 -h\n"
3991 " Filesystem Size Used Available Use%\n"
3992 " F14x64:/dev/sda1 484M 66M 393M 14%\n"
3993 " F14x64:/dev/vg_f13x64/lv_root 7.4G 3.4G 4.0G 46%\n"
3998 #: ../df/virt-df.pod:53
3999 msgid "Show disk usage for a disk image file called C<test.img>:"
4003 #: ../df/virt-df.pod:55
4006 " $ virt-df -a test1.img\n"
4007 " Filesystem 1K-blocks Used Available Use%\n"
4008 " test1.img:/dev/sda1 99099 1551 92432 2%\n"
4013 #: ../df/virt-df.pod:112
4016 " virt-df --format=raw -a disk.img\n"
4021 #: ../df/virt-df.pod:116
4024 " virt-df --format=raw -a disk.img --format -a another.img\n"
4029 #: ../df/virt-df.pod:129
4030 msgid "Print sizes in human-readable format."
4034 #: ../df/virt-df.pod:131
4035 msgid "You are not allowed to use I<-h> and I<--csv> at the same time."
4039 #: ../df/virt-df.pod:133 ../fish/guestfish.pod:258 ../fuse/guestmount.pod:164
4044 #: ../df/virt-df.pod:135
4046 msgstr "B<--inodes>"
4049 #: ../df/virt-df.pod:137
4050 msgid "Print inodes instead of blocks."
4054 #: ../df/virt-df.pod:139
4055 msgid "B<--one-per-guest>"
4056 msgstr "B<--one-per-guest>"
4059 #: ../df/virt-df.pod:141
4061 "Run one libguestfs appliance per guest. Normally C<virt-df> will add the "
4062 "disks from several guests to a single libguestfs appliance."
4066 #: ../df/virt-df.pod:144
4067 msgid "You might use this option in the following circumstances:"
4071 #: ../df/virt-df.pod:150
4073 "If you think an untrusted guest might actively try to exploit the libguestfs "
4074 "appliance kernel, then this prevents one guest from interfering with the "
4075 "stats printed for another guest."
4079 #: ../df/virt-df.pod:156
4081 "If the kernel has a bug which stops it from accessing a filesystem in one "
4082 "guest (see for example RHBZ#635373) then this allows libguestfs to continue "
4083 "and report stats for further guests."
4087 #: ../df/virt-df.pod:165
4089 "Print UUIDs instead of names. This is useful for following a guest even "
4090 "when the guest is migrated or renamed, or when two guests happen to have the "
4095 #: ../df/virt-df.pod:169
4097 "Note that only domains that we fetch from libvirt come with UUIDs. For disk "
4098 "images, we still print the disk image name even when this option is "
4103 #: ../df/virt-df.pod:229
4105 "L<df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<http://"
4110 #: ../edit/virt-edit.pod:5
4111 msgid "virt-edit - Edit a file in a virtual machine"
4115 #: ../edit/virt-edit.pod:9
4118 " virt-edit [--options] -d domname file [file ...]\n"
4123 #: ../edit/virt-edit.pod:11
4126 " virt-edit [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
4131 #: ../edit/virt-edit.pod:13
4134 " virt-edit [-d domname|-a disk.img] file -e 'expr'\n"
4139 #: ../edit/virt-edit.pod:17
4142 " virt-edit domname file\n"
4147 #: ../edit/virt-edit.pod:19 ../edit/virt-edit.pod:183
4150 " virt-edit disk.img [disk.img ...] file\n"
4155 #: ../edit/virt-edit.pod:21 ../fish/guestfish.pod:23
4156 #: ../fish/virt-copy-in.pod:13 ../fish/virt-tar-in.pod:15
4157 #: ../fuse/guestmount.pod:15 ../rescue/virt-rescue.pod:21
4158 #: ../tools/virt-tar.pl:64 ../tools/virt-win-reg.pl:51
4160 msgstr "ПОПЕРЕДЖЕННЯ"
4163 #: ../edit/virt-edit.pod:23
4165 "You must I<not> use C<virt-edit> on live virtual machines. If you do this, "
4166 "you risk disk corruption in the VM. C<virt-edit> tries to stop you from "
4167 "doing this, but doesn't catch all cases."
4171 #: ../edit/virt-edit.pod:29
4173 "C<virt-edit> is a command line tool to edit C<file> where each C<file> "
4174 "exists in the named virtual machine (or disk image)."
4178 #: ../edit/virt-edit.pod:32
4180 "Multiple filenames can be given, in which case they are each edited in "
4181 "turn. Each filename must be a full path, starting at the root directory "
4182 "(starting with '/')."
4186 #: ../edit/virt-edit.pod:36
4187 msgid "If you want to just view a file, use L<virt-cat(1)>."
4191 #: ../edit/virt-edit.pod:38
4193 "For more complex cases you should look at the L<guestfish(1)> tool (see L</"
4194 "USING GUESTFISH> below)."
4198 #: ../edit/virt-edit.pod:41
4200 "C<virt-edit> cannot be used to create a new file. L<guestfish(1)> can do "
4201 "that and much more."
4205 #: ../edit/virt-edit.pod:46
4206 msgid "Edit the named files interactively:"
4210 #: ../edit/virt-edit.pod:48
4213 " virt-edit -d mydomain /boot/grub/grub.conf\n"
4218 #: ../edit/virt-edit.pod:50
4221 " virt-edit -d mydomain /etc/passwd\n"
4226 #: ../edit/virt-edit.pod:52
4227 msgid "For Windows guests, some Windows paths are understood:"
4231 #: ../edit/virt-edit.pod:54
4234 " virt-edit -d mywindomain 'c:\\autoexec.bat'\n"
4239 #: ../edit/virt-edit.pod:56
4241 "If Perl is installed, you can also edit files non-interactively (see L</NON-"
4242 "INTERACTIVE EDITING> below). To change the init default level to 5:"
4246 #: ../edit/virt-edit.pod:60
4249 " virt-edit -d mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
4254 #: ../edit/virt-edit.pod:81
4255 msgid "B<-b> extension"
4259 #: ../edit/virt-edit.pod:83
4260 msgid "B<--backup> extension"
4264 #: ../edit/virt-edit.pod:85
4266 "Create a backup of the original file I<in the guest disk image>. The backup "
4267 "has the original filename with C<extension> added."
4271 #: ../edit/virt-edit.pod:88
4273 "Usually the first character of C<extension> would be a dot C<.> so you would "
4278 #: ../edit/virt-edit.pod:91
4281 " virt-edit -b .orig [etc]\n"
4286 #: ../edit/virt-edit.pod:93
4287 msgid "By default, no backup file is made."
4291 #: ../edit/virt-edit.pod:95 ../fish/guestfish.pod:181
4292 #: ../fuse/guestmount.pod:105 ../inspector/virt-inspector.pod:74
4293 #: ../tools/virt-list-filesystems.pl:77 ../tools/virt-list-partitions.pl:78
4294 #: ../tools/virt-tar.pl:127 ../tools/virt-win-reg.pl:128
4296 msgstr "B<-c адреса>"
4299 #: ../edit/virt-edit.pod:97 ../fish/guestfish.pod:183
4300 #: ../fuse/guestmount.pod:107 ../inspector/virt-inspector.pod:76
4301 #: ../tools/virt-list-filesystems.pl:79 ../tools/virt-list-partitions.pl:80
4302 #: ../tools/virt-tar.pl:129 ../tools/virt-win-reg.pl:130
4303 msgid "B<--connect URI>"
4304 msgstr "B<--connect адреса>"
4307 #: ../edit/virt-edit.pod:102 ../tools/virt-list-filesystems.pl:84
4308 #: ../tools/virt-list-partitions.pl:85 ../tools/virt-tar.pl:134
4309 #: ../tools/virt-win-reg.pl:135
4311 "If you specify guest block devices directly, then libvirt is not used at all."
4315 #: ../edit/virt-edit.pod:114
4317 "When prompting for keys and passphrases, virt-edit normally turns echoing "
4318 "off so you cannot see what you are typing. If you are not worried about "
4319 "Tempest attacks and there is no one else in the room you can specify this "
4320 "flag to see what you are typing."
4324 #: ../edit/virt-edit.pod:119
4326 msgstr "B<-e> вираз"
4329 #: ../edit/virt-edit.pod:121
4330 msgid "B<--expr> EXPR"
4331 msgstr "B<--expr> вираз"
4334 #: ../edit/virt-edit.pod:123
4336 "Instead of launching the external editor, non-interactively apply the Perl "
4337 "expression C<EXPR> to each line in the file. See L</NON-INTERACTIVE "
4342 #: ../edit/virt-edit.pod:127
4344 "Be careful to properly quote the expression to prevent it from being altered "
4349 #: ../edit/virt-edit.pod:130
4350 msgid "Note that this option is only available when Perl 5 is installed."
4354 #: ../edit/virt-edit.pod:132
4355 msgid "B<--format> raw|qcow2|..."
4356 msgstr "B<--format> raw|qcow2|..."
4359 #: ../edit/virt-edit.pod:143
4362 " virt-edit --format=raw -a disk.img file\n"
4367 #: ../edit/virt-edit.pod:147
4370 " virt-edit --format=raw -a disk.img --format -a another.img file\n"
4375 #: ../edit/virt-edit.pod:181
4376 msgid "Previous versions of virt-edit allowed you to write either:"
4380 #: ../edit/virt-edit.pod:187
4383 " virt-edit guestname file\n"
4388 #: ../edit/virt-edit.pod:195
4389 msgid "NON-INTERACTIVE EDITING"
4390 msgstr "НЕІНТЕРАКТИВНЕ РЕДАГУВАННЯ"
4393 #: ../edit/virt-edit.pod:197
4395 "C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
4396 "administrator can interactively edit the file."
4400 #: ../edit/virt-edit.pod:200
4402 "There are two ways also to use C<virt-edit> from scripts in order to make "
4403 "automated edits to files. (Note that although you I<can> use C<virt-edit> "
4404 "like this, it's less error-prone to write scripts directly using the "
4405 "libguestfs API and Augeas for configuration file editing.)"
4409 #: ../edit/virt-edit.pod:206
4411 "The first method is to temporarily set C<$EDITOR> to any script or program "
4412 "you want to run. The script is invoked as C<$EDITOR tmpfile> and it should "
4413 "update C<tmpfile> in place however it likes."
4417 #: ../edit/virt-edit.pod:210
4419 "The second method is to use the I<-e> parameter of C<virt-edit> to run a "
4420 "short Perl snippet in the style of L<sed(1)>. For example to replace all "
4421 "instances of C<foo> with C<bar> in a file:"
4425 #: ../edit/virt-edit.pod:214
4428 " virt-edit -d domname filename -e 's/foo/bar/'\n"
4433 #: ../edit/virt-edit.pod:216
4435 "The full power of Perl regular expressions can be used (see L<perlre(1)>). "
4436 "For example to delete root's password you could do:"
4440 #: ../edit/virt-edit.pod:219
4443 " virt-edit -d domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
4446 " virt-edit -d назва_домену /etc/passwd -e 's/^root:.*?:/root::/'\n"
4450 #: ../edit/virt-edit.pod:221
4452 "What really happens is that the snippet is evaluated as a Perl expression "
4453 "for each line of the file. The line, including the final C<\\n>, is passed "
4454 "in C<$_> and the expression should update C<$_> or leave it unchanged."
4458 #: ../edit/virt-edit.pod:226
4460 "To delete a line, set C<$_> to the empty string. For example, to delete the "
4461 "C<apache> user account from the password file you can do:"
4465 #: ../edit/virt-edit.pod:229
4468 " virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
4471 " virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
4475 #: ../edit/virt-edit.pod:231
4477 "To insert a line, prepend or append it to C<$_>. However appending lines to "
4478 "the end of the file is rather difficult this way since there is no concept "
4479 "of \"last line of the file\" - your expression just doesn't get called "
4480 "again. You might want to use the first method (setting C<$EDITOR>) if you "
4485 #: ../edit/virt-edit.pod:237
4487 "The variable C<$lineno> contains the current line number. As is "
4488 "traditional, the first line in the file is number C<1>."
4492 #: ../edit/virt-edit.pod:240
4494 "The return value from the expression is ignored, but the expression may call "
4495 "C<die> in order to abort the whole program, leaving the original file "
4500 #: ../edit/virt-edit.pod:244
4502 "Remember when matching the end of a line that C<$_> may contain the final C<"
4503 "\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a "
4504 "newline then neither of these. Thus to match or substitute some text at the "
4505 "end of a line, use this regular expression:"
4509 #: ../edit/virt-edit.pod:249
4512 " /some text(\\r?\\n)?$/\n"
4515 " /якийсь текст(\\r?\\n)?$/\n"
4519 #: ../edit/virt-edit.pod:251
4521 "Alternately, use the perl C<chomp> function, being careful not to chomp C<"
4522 "$_> itself (since that would remove all newlines from the file):"
4526 #: ../edit/virt-edit.pod:255
4529 " my $m = $_; chomp $m; $m =~ /some text$/\n"
4532 " my $m = $_; chomp $m; $m =~ /якийсь текст$/\n"
4536 #: ../edit/virt-edit.pod:259
4538 "C<virt-edit> has a limited ability to understand Windows drive letters and "
4539 "paths (eg. C<E:\\foo\\bar.txt>)."
4543 #: ../edit/virt-edit.pod:278
4545 "The path is resolved case insensitively to locate the file that should be "
4550 #: ../edit/virt-edit.pod:299
4552 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
4553 "C<virt-edit> doesn't work."
4557 #: ../edit/virt-edit.pod:302
4558 msgid "Using C<virt-edit> is approximately equivalent to doing:"
4562 #: ../edit/virt-edit.pod:304
4565 " guestfish --rw -i -d domname edit /file\n"
4570 #: ../edit/virt-edit.pod:306
4572 "where C<domname> is the name of the libvirt guest, and C</file> is the full "
4577 #: ../edit/virt-edit.pod:309
4579 "The command above uses libguestfs's guest inspection feature and so does not "
4580 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
4581 "disk images that don't contain guests. To edit a file on a disk image "
4586 #: ../edit/virt-edit.pod:314
4589 " guestfish --rw -a disk.img -m /dev/sda1 edit /file\n"
4594 #: ../edit/virt-edit.pod:316
4596 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
4597 "the disk image to edit, and C</file> is the full path to the file."
4601 #: ../edit/virt-edit.pod:320
4603 "C<virt-edit> cannot create new files. Use the guestfish commands C<touch>, "
4604 "C<write> or C<upload> instead:"
4608 #: ../edit/virt-edit.pod:323
4611 " guestfish --rw -i -d domname touch /newfile\n"
4616 #: ../edit/virt-edit.pod:325
4619 " guestfish --rw -i -d domname write /newfile \"new content\"\n"
4624 #: ../edit/virt-edit.pod:327
4627 " guestfish --rw -i -d domname upload localfile /newfile\n"
4632 #: ../edit/virt-edit.pod:329 ../fish/guestfish.pod:1119
4633 #: ../rescue/virt-rescue.pod:298 ../sparsify/virt-sparsify.pod:232
4634 #: ../src/guestfs.pod:3209 ../test-tool/libguestfs-test-tool.pod:95
4635 msgid "ENVIRONMENT VARIABLES"
4636 msgstr "ЗМІННІ СЕРЕДОВИЩА"
4639 #: ../edit/virt-edit.pod:333
4644 #: ../edit/virt-edit.pod:335
4646 "If set, this string is used as the editor. It may contain arguments, eg. C<"
4651 #: ../edit/virt-edit.pod:338
4652 msgid "If not set, C<vi> is used."
4656 #: ../edit/virt-edit.pod:356
4658 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-"
4659 "tar-in(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
4660 "L<http://libguestfs.org/>, L<perl(1)>, L<perlre(1)>."
4662 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-"
4663 "tar-in(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
4664 "L<http://libguestfs.org/>, L<perl(1)>, L<perlre(1)>."
4667 #: ../erlang/examples/guestfs-erlang.pod:5
4668 msgid "guestfs-erlang - How to use libguestfs from Erlang"
4672 #: ../erlang/examples/guestfs-erlang.pod:9
4675 " {ok, G} = guestfs:create(),\n"
4676 " ok = guestfs:add_drive_opts(G, Disk,\n"
4677 " [{format, \"raw\"}, {readonly, true}]),\n"
4678 " ok = guestfs:launch(G),\n"
4679 " [Device] = guestfs:list_devices(G),\n"
4680 " ok = guestfs:close(G).\n"
4685 #: ../erlang/examples/guestfs-erlang.pod:18
4687 "This manual page documents how to call libguestfs from the Erlang "
4688 "programming language. This page just documents the differences from the C "
4689 "API and gives some examples. If you are not familiar with using libguestfs, "
4690 "you also need to read L<guestfs(3)>."
4694 #: ../erlang/examples/guestfs-erlang.pod:23
4695 msgid "OPENING AND CLOSING THE HANDLE"
4699 #: ../erlang/examples/guestfs-erlang.pod:25
4701 "The Erlang bindings are implemented using an external program called C<erl-"
4702 "guestfs>. This program must be on the current PATH, or else you should "
4703 "specify the full path to the program:"
4707 #: ../erlang/examples/guestfs-erlang.pod:29
4710 " {ok, G} = guestfs:create().\n"
4715 #: ../erlang/examples/guestfs-erlang.pod:31
4718 " {ok, G} = guestfs:create(\"/path/to/erl-guestfs\").\n"
4723 #: ../erlang/examples/guestfs-erlang.pod:33
4724 msgid "C<G> is the libguestfs handle which you should pass to other functions."
4728 #: ../erlang/examples/guestfs-erlang.pod:36
4729 msgid "To close the handle:"
4733 #: ../erlang/examples/guestfs-erlang.pod:38
4736 " ok = guestfs:close(G).\n"
4741 #: ../erlang/examples/guestfs-erlang.pod:40
4742 msgid "FUNCTIONS WITH OPTIONAL ARGUMENTS"
4746 #: ../erlang/examples/guestfs-erlang.pod:42
4748 "For functions that take optional arguments, the first arguments are the non-"
4749 "optional ones. The last argument is a list of tuples supplying the "
4750 "remaining optional arguments."
4754 #: ../erlang/examples/guestfs-erlang.pod:46
4757 " ok = guestfs:add_drive_opts(G, Disk,\n"
4758 " [{format, \"raw\"}, {readonly, true}]).\n"
4763 #: ../erlang/examples/guestfs-erlang.pod:49
4764 msgid "If the last argument would be an empty list, you can also omit it:"
4768 #: ../erlang/examples/guestfs-erlang.pod:51
4771 " ok = guestfs:add_drive_opts(G, Disk).\n"
4776 #: ../erlang/examples/guestfs-erlang.pod:53
4777 msgid "RETURN VALUES AND ERRORS"
4781 #: ../erlang/examples/guestfs-erlang.pod:55
4783 "On success, most functions return a C<Result> term (which could be a list, "
4784 "string, tuple etc.). If there is nothing for the function to return, then "
4785 "the atom C<ok> is returned."
4789 #: ../erlang/examples/guestfs-erlang.pod:59
4790 msgid "On error, you would see one of the following tuples:"
4794 #: ../erlang/examples/guestfs-erlang.pod:63
4795 msgid "C<{error, Msg, Errno}>"
4799 #: ../erlang/examples/guestfs-erlang.pod:65
4800 msgid "This indicates an ordinary error from the function."
4804 #: ../erlang/examples/guestfs-erlang.pod:67
4806 "C<Msg> is the error message (string) and C<Errno> is the Unix error "
4811 #: ../erlang/examples/guestfs-erlang.pod:70
4812 msgid "C<Errno> can be zero. See L<guestfs(3)/guestfs_last_errno>."
4816 #: ../erlang/examples/guestfs-erlang.pod:72
4817 msgid "C<{unknown, Function}>"
4821 #: ../erlang/examples/guestfs-erlang.pod:74
4823 "This indicates that the function you called is not known. Generally this "
4824 "means you are mixing C<erl-guestfs> from another version of libguestfs, "
4825 "which you should not do."
4829 #: ../erlang/examples/guestfs-erlang.pod:78
4830 msgid "C<Function> is the name of the unknown function."
4834 #: ../erlang/examples/guestfs-erlang.pod:80
4835 msgid "C<{unknownarg, Arg}>"
4839 #: ../erlang/examples/guestfs-erlang.pod:82
4841 "This indicates that you called a function with optional arguments, with an "
4842 "unknown argument name."
4846 #: ../erlang/examples/guestfs-erlang.pod:85
4847 msgid "C<Arg> is the name of the unknown argument."
4851 #: ../erlang/examples/guestfs-erlang.pod:89
4852 #: ../examples/guestfs-examples.pod:25 ../java/examples/guestfs-java.pod:37
4853 #: ../ocaml/examples/guestfs-ocaml.pod:70 ../perl/examples/guestfs-perl.pod:31
4854 #: ../python/examples/guestfs-python.pod:34
4855 #: ../ruby/examples/guestfs-ruby.pod:28
4856 msgid "EXAMPLE 1: CREATE A DISK IMAGE"
4857 msgstr "ПРИКЛАД 1. СТВОРЕННЯ ОБРАЗУ ДИСКА"
4860 #: ../erlang/examples/guestfs-erlang.pod:91
4861 #: ../examples/guestfs-examples.pod:27 ../java/examples/guestfs-java.pod:39
4862 #: ../ocaml/examples/guestfs-ocaml.pod:72 ../perl/examples/guestfs-perl.pod:33
4863 #: ../python/examples/guestfs-python.pod:36
4864 #: ../ruby/examples/guestfs-ruby.pod:30
4869 #: ../erlang/examples/guestfs-erlang.pod:93
4870 #: ../examples/guestfs-examples.pod:29 ../java/examples/guestfs-java.pod:41
4871 #: ../ocaml/examples/guestfs-ocaml.pod:74 ../perl/examples/guestfs-perl.pod:35
4872 #: ../python/examples/guestfs-python.pod:38
4873 #: ../ruby/examples/guestfs-ruby.pod:32
4874 msgid "EXAMPLE 2: INSPECT A VIRTUAL MACHINE DISK IMAGE"
4875 msgstr "ПРИКЛАД 2. ПЕРЕВІРКА ОБРАЗУ ДИСКА ВІРТУАЛЬНОЇ МАШИНИ"
4878 #: ../erlang/examples/guestfs-erlang.pod:95
4879 #: ../examples/guestfs-examples.pod:31 ../java/examples/guestfs-java.pod:43
4880 #: ../ocaml/examples/guestfs-ocaml.pod:76 ../perl/examples/guestfs-perl.pod:37
4881 #: ../python/examples/guestfs-python.pod:40
4882 #: ../ruby/examples/guestfs-ruby.pod:34
4887 #: ../erlang/examples/guestfs-erlang.pod:99
4889 "L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-java(3)>, L<guestfs-ocaml(3)"
4890 ">, L<guestfs-perl(3)>, L<guestfs-python(3)>, L<guestfs-recipes(1)>, "
4891 "L<guestfs-ruby(3)>, L<http://www.erlang.org/>. L<http://libguestfs.org/>."
4895 #: ../erlang/examples/guestfs-erlang.pod:110
4896 #: ../examples/guestfs-examples.pod:45 ../examples/guestfs-recipes.pod:397
4897 #: ../examples/guestfs-testing.pod:276 ../fish/guestfish.pod:1296
4898 #: ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49
4899 #: ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51
4900 #: ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:404
4901 #: ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91
4902 #: ../perl/examples/guestfs-perl.pod:52
4903 #: ../python/examples/guestfs-python.pod:54
4904 #: ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3349
4905 #: ../test-tool/libguestfs-test-tool.pod:106
4910 #: ../erlang/examples/guestfs-erlang.pod:112
4911 #: ../examples/guestfs-examples.pod:47 ../examples/guestfs-recipes.pod:399
4912 #: ../examples/guestfs-testing.pod:278 ../fish/guestfish.pod:1298
4913 #: ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51
4914 #: ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53
4915 #: ../fuse/guestmount.pod:330 ../java/examples/guestfs-java.pod:60
4916 #: ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:54
4917 #: ../python/examples/guestfs-python.pod:56
4918 #: ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3351
4919 #: ../test-tool/libguestfs-test-tool.pod:108
4920 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
4921 msgstr "Richard W.M. Jones (C<rjones at redhat dot com>)"
4924 #: ../erlang/examples/guestfs-erlang.pod:116
4925 #: ../examples/guestfs-testing.pod:282 ../java/examples/guestfs-java.pod:64
4926 #: ../perl/examples/guestfs-perl.pod:58
4927 msgid "Copyright (C) 2011 Red Hat Inc. L<http://libguestfs.org/>"
4931 #: ../erlang/examples/guestfs-erlang.pod:118
4932 #: ../examples/guestfs-examples.pod:53 ../examples/guestfs-recipes.pod:405
4933 #: ../java/examples/guestfs-java.pod:66 ../ocaml/examples/guestfs-ocaml.pod:99
4934 #: ../perl/examples/guestfs-perl.pod:60
4935 #: ../python/examples/guestfs-python.pod:62
4936 #: ../ruby/examples/guestfs-ruby.pod:56
4938 "The examples in this manual page may be freely copied, modified and "
4939 "distributed without any restrictions."
4943 #: ../erlang/examples/guestfs-erlang.pod:121
4944 #: ../examples/guestfs-examples.pod:56 ../examples/guestfs-recipes.pod:408
4945 #: ../examples/guestfs-testing.pod:284 ../java/examples/guestfs-java.pod:69
4946 #: ../ocaml/examples/guestfs-ocaml.pod:102
4947 #: ../perl/examples/guestfs-perl.pod:63
4948 #: ../python/examples/guestfs-python.pod:65
4949 #: ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3358
4951 "This library is free software; you can redistribute it and/or modify it "
4952 "under the terms of the GNU Lesser General Public License as published by the "
4953 "Free Software Foundation; either version 2 of the License, or (at your "
4954 "option) any later version."
4958 #: ../erlang/examples/guestfs-erlang.pod:126
4959 #: ../examples/guestfs-examples.pod:61 ../examples/guestfs-recipes.pod:413
4960 #: ../examples/guestfs-testing.pod:289 ../java/examples/guestfs-java.pod:74
4961 #: ../ocaml/examples/guestfs-ocaml.pod:107
4962 #: ../perl/examples/guestfs-perl.pod:68
4963 #: ../python/examples/guestfs-python.pod:70
4964 #: ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3363
4966 "This library is distributed in the hope that it will be useful, but WITHOUT "
4967 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
4968 "FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License "
4973 #: ../erlang/examples/guestfs-erlang.pod:131
4974 #: ../examples/guestfs-examples.pod:66 ../examples/guestfs-recipes.pod:418
4975 #: ../examples/guestfs-testing.pod:294 ../java/examples/guestfs-java.pod:79
4976 #: ../ocaml/examples/guestfs-ocaml.pod:112
4977 #: ../perl/examples/guestfs-perl.pod:73
4978 #: ../python/examples/guestfs-python.pod:75
4979 #: ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3368
4981 "You should have received a copy of the GNU Lesser General Public License "
4982 "along with this library; if not, write to the Free Software Foundation, "
4983 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA"
4987 #: ../examples/guestfs-examples.pod:5
4988 msgid "guestfs-examples - Examples of using libguestfs from C"
4992 #: ../examples/guestfs-examples.pod:9 ../src/guestfs.pod:9
4995 " #include <guestfs.h>\n"
4998 " #include <guestfs.h>\n"
5002 #: ../examples/guestfs-examples.pod:11
5005 " guestfs_h *g = guestfs_create ();\n"
5006 " guestfs_add_drive_ro (g, \"disk.img\");\n"
5007 " guestfs_launch (g);\n"
5010 " guestfs_h *g = guestfs_create ();\n"
5011 " guestfs_add_drive_ro (g, \"disk.img\");\n"
5012 " guestfs_launch (g);\n"
5016 #: ../examples/guestfs-examples.pod:15 ../src/guestfs.pod:19
5019 " cc prog.c -o prog -lguestfs\n"
5021 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
5024 " cc prog.c -o prog -lguestfs\n"
5026 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
5030 #: ../examples/guestfs-examples.pod:21
5032 "This manual page contains examples of calling libguestfs from the C "
5033 "programming language. If you are not familiar with using libguestfs, you "
5034 "also need to read L<guestfs(3)>."
5038 #: ../examples/guestfs-examples.pod:35
5040 "L<guestfs(3)>, L<guestfs-erlang(3)>, L<guestfs-java(3)>, L<guestfs-ocaml(3)"
5041 ">, L<guestfs-perl(3)>, L<guestfs-python(3)>, L<guestfs-recipes(1)>, "
5042 "L<guestfs-ruby(3)>, L<http://libguestfs.org/>."
5046 #: ../examples/guestfs-examples.pod:51 ../ocaml/examples/guestfs-ocaml.pod:97
5047 #: ../python/examples/guestfs-python.pod:60
5048 #: ../ruby/examples/guestfs-ruby.pod:54
5049 msgid "Copyright (C) 2010 Red Hat Inc. L<http://libguestfs.org/>"
5053 #: ../examples/guestfs-recipes.pod:3 ../examples/guestfs-recipes.pod:12
5058 #: ../examples/guestfs-recipes.pod:5
5060 "pod2man and pod2html have differing bugs which makes it hard to write URLs "
5061 "here. The only way which works for both sorts of output is to just write "
5062 "the URL directly. Do NOT use L<...> for URLs."
5066 #: ../examples/guestfs-recipes.pod:9
5068 "We break with tradition here and don't use ALL CAPS for the section "
5069 "headings, as this makes them much easier to read."
5073 #: ../examples/guestfs-recipes.pod:16
5074 msgid "guestfs-recipes - libguestfs, guestfish and virt tools recipes"
5078 #: ../examples/guestfs-recipes.pod:20
5080 "This page contains recipes for and links to things you can do using "
5081 "libguestfs, L<guestfish(1)> and the virt tools."
5085 #: ../examples/guestfs-recipes.pod:23
5086 msgid "Audit a virtual machine for setuid files"
5090 #: ../examples/guestfs-recipes.pod:25
5092 "The link below contains a small program which can be used to audit a Linux "
5093 "virtual machine to see what setuid and setgid files it contains."
5097 #: ../examples/guestfs-recipes.pod:28
5099 "https://rwmj.wordpress.com/2010/12/15/tip-audit-virtual-machine-for-setuid-"
5104 #: ../examples/guestfs-recipes.pod:30
5105 msgid "Change the background image in a Windows XP VM"
5109 #: ../examples/guestfs-recipes.pod:32
5111 "The links below explain how to use L<guestfish(1)> to change the background "
5112 "image for a user of a Windows XP VM. Unfortunately the technique appears to "
5113 "be substantially different for each version of Windows."
5117 #: ../examples/guestfs-recipes.pod:37
5119 "https://lists.fedoraproject.org/pipermail/virt/2011-May/002655.html https://"
5120 "lists.fedoraproject.org/pipermail/virt/2011-May/002658.html"
5124 #: ../examples/guestfs-recipes.pod:40
5125 msgid "Cloning a virtual machine (Linux)"
5129 #: ../examples/guestfs-recipes.pod:42
5131 "The guestfish technique described in the link below works well for most "
5132 "Linux VMs. Depending on the Linux distro you may need to change the paths "
5137 #: ../examples/guestfs-recipes.pod:46
5139 "https://rwmj.wordpress.com/2010/09/24/tip-my-procedure-for-cloning-a-fedora-"
5144 #: ../examples/guestfs-recipes.pod:48
5146 "Avoid L<virt-clone(1)>. Currently what to do about virt-clone is under "
5151 #: ../examples/guestfs-recipes.pod:51
5152 msgid "https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html"
5156 #: ../examples/guestfs-recipes.pod:53
5157 msgid "Cloning a virtual machine (Windows)"
5161 #: ../examples/guestfs-recipes.pod:55
5163 "It is possible to do a \"sysprep\" using libguestfs alone, although not "
5164 "straightforward. Currently there is code in the Aeolus Oz project which "
5165 "does this (using libguestfs). As part of our review of the virt-clone tool, "
5166 "we may add sysprepping ability."
5170 #: ../examples/guestfs-recipes.pod:60
5172 "https://github.com/clalancette/oz https://www.redhat.com/archives/virt-tools-"
5173 "list/2011-May/msg00019.html"
5177 #: ../examples/guestfs-recipes.pod:63
5178 msgid "Convert a CD-ROM / DVD / ISO to a tarball"
5182 #: ../examples/guestfs-recipes.pod:65
5183 msgid "This converts input C<cd.iso> to output C<cd.tar.gz>:"
5187 #: ../examples/guestfs-recipes.pod:67
5190 " guestfish --ro -a cd.iso -m /dev/sda tgz-out / cd.tar.gz\n"
5195 #: ../examples/guestfs-recipes.pod:69
5196 msgid "To export just a subdirectory, eg. C</files>, do:"
5200 #: ../examples/guestfs-recipes.pod:71
5203 " guestfish --ro -a cd.iso -m /dev/sda tgz-out /files cd.tar.gz\n"
5208 #: ../examples/guestfs-recipes.pod:73
5209 msgid "Create empty disk images"
5213 #: ../examples/guestfs-recipes.pod:75
5215 "You can use the L<guestfish(1)> I<-N> option to create empty disk images. "
5216 "The useful guide below explains the options available."
5220 #: ../examples/guestfs-recipes.pod:78
5222 "https://rwmj.wordpress.com/2010/09/08/new-guestfish-n-options-in-1-5-9/"
5227 #: ../examples/guestfs-recipes.pod:80
5228 msgid "Dump raw filesystem content from inside a disk image or VM"
5232 #: ../examples/guestfs-recipes.pod:82
5234 "You can use the L<guestfish(1)> C<download> command to extract the raw "
5235 "filesystem content from any filesystem in a disk image or a VM (even one "
5236 "which is encrypted or buried inside an LV):"
5240 #: ../examples/guestfs-recipes.pod:86
5243 " guestfish --ro -a disk.img run : download /dev/sda1 sda1.img\n"
5248 #: ../examples/guestfs-recipes.pod:88
5251 " guestfish --ro -d Guest run : download /dev/vg_guest/lv_root lv.img\n"
5256 #: ../examples/guestfs-recipes.pod:90
5257 msgid "To list the filesystems in a disk image, use L<virt-filesystems(1)>."
5261 #: ../examples/guestfs-recipes.pod:92
5262 msgid "Edit grub configuration in a VM"
5266 #: ../examples/guestfs-recipes.pod:94
5267 msgid "You can use this to:"
5271 #: ../examples/guestfs-recipes.pod:100
5272 msgid "Fix a virtual machine that does not boot."
5276 #: ../examples/guestfs-recipes.pod:104
5277 msgid "Change which kernel is used to boot the VM."
5281 #: ../examples/guestfs-recipes.pod:108
5282 msgid "Change kernel command line options."
5286 #: ../examples/guestfs-recipes.pod:112
5287 msgid "Use L<virt-edit(1)> to edit the grub configuration:"
5291 #: ../examples/guestfs-recipes.pod:114
5294 " virt-edit -d BrokenGuest /boot/grub/grub.conf\n"
5299 #: ../examples/guestfs-recipes.pod:116
5301 "or for general tinkering inside an unbootable VM use L<virt-rescue(1)> like "
5306 #: ../examples/guestfs-recipes.pod:119
5309 " virt-rescue -d BrokenGuest\n"
5314 #: ../examples/guestfs-recipes.pod:121
5315 msgid "Export any directory from a VM"
5319 #: ../examples/guestfs-recipes.pod:123
5321 "To export C</home> from a VM into a local directory use L<virt-copy-out(1)>:"
5325 #: ../examples/guestfs-recipes.pod:126 ../examples/guestfs-testing.pod:93
5328 " virt-copy-out -d Guest /home .\n"
5333 #: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9
5334 #: ../fish/guestfish-actions.pod:1450 ../fish/guestfish-actions.pod:1715
5335 #: ../fish/guestfish-actions.pod:2132 ../src/guestfs-actions.pod:18
5336 #: ../src/guestfs-actions.pod:2334 ../src/guestfs-actions.pod:2758
5337 #: ../src/guestfs-actions.pod:3317 ../src/guestfs.pod:1685
5338 #: ../tools/virt-win-reg.pl:717
5343 #: ../examples/guestfs-recipes.pod:134
5345 "The final dot of the command is not a printing error. It means we want to "
5346 "copy out to the current directory."
5350 #: ../examples/guestfs-recipes.pod:139
5351 msgid "This creates a directory called C<home> under the current directory."
5355 #: ../examples/guestfs-recipes.pod:143
5357 "If the guest is a Windows guest then you can use drive letters and "
5358 "backslashes, but you must prefix the path with C<win:> and quote it to "
5359 "protect it from the shell, like this:"
5363 #: ../examples/guestfs-recipes.pod:147
5366 " virt-copy-out -d WinGuest 'win:c:\\windows\\system32\\config' .\n"
5371 #: ../examples/guestfs-recipes.pod:149
5372 msgid "To get the output as a compressed tarball, do:"
5376 #: ../examples/guestfs-recipes.pod:151
5379 " virt-tar-out -d Guest /home - | gzip --best > home.tar.gz\n"
5384 #: ../examples/guestfs-recipes.pod:153
5386 "Although it sounds tempting, this is usually not a reliable way to get a "
5387 "backup from a running guest. See the entry in the FAQ: http://libguestfs."
5388 "org/FAQ.html#backup"
5392 #: ../examples/guestfs-recipes.pod:157
5393 msgid "Find out which user is using the most space"
5397 #: ../examples/guestfs-recipes.pod:159
5399 "This simple script examines a Linux guest to find out which user is using "
5400 "the most space in their home directory:"
5404 #: ../examples/guestfs-recipes.pod:162
5412 #: ../examples/guestfs-recipes.pod:164 ../fish/guestfish.pod:984
5420 #: ../examples/guestfs-recipes.pod:166
5429 #: ../examples/guestfs-recipes.pod:169
5432 " eval $(guestfish --ro -d \"$vm\" -i --listen)\n"
5437 #: ../examples/guestfs-recipes.pod:171
5440 " for d in $(guestfish --remote ls \"$dir\"); do\n"
5441 " echo -n \"$dir/$d\"\n"
5443 " guestfish --remote du \"$dir/$d\";\n"
5444 " done | sort -nr -k 2\n"
5449 #: ../examples/guestfs-recipes.pod:177 ../fish/guestfish.pod:941
5452 " guestfish --remote exit\n"
5457 #: ../examples/guestfs-recipes.pod:179
5458 msgid "Get DHCP address from a VM"
5462 #: ../examples/guestfs-recipes.pod:181
5464 "The link below explains the many different possible techniques for getting "
5465 "the last assigned DHCP address of a virtual machine."
5469 #: ../examples/guestfs-recipes.pod:184
5471 "https://rwmj.wordpress.com/2011/03/31/tip-code-for-getting-dhcp-address-from-"
5472 "a-virtual-machine-disk-image/#content"
5476 #: ../examples/guestfs-recipes.pod:186
5478 "In the libguestfs source examples directory you will find the latest version "
5479 "of the C<virt-dhcp-address.c> program."
5483 #: ../examples/guestfs-recipes.pod:189
5484 msgid "Get the operating system product name string"
5488 #: ../examples/guestfs-recipes.pod:191
5489 msgid "Save the following script into a file called C<product-name.sh>:"
5493 #: ../examples/guestfs-recipes.pod:193
5498 " eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n"
5499 " root=\"$(guestfish --remote inspect-get-roots)\"\n"
5500 " guestfish --remote inspect-get-product-name \"$root\"\n"
5501 " guestfish --remote exit\n"
5506 #: ../examples/guestfs-recipes.pod:200
5507 msgid "Make the script executable and run it on a named guest:"
5511 #: ../examples/guestfs-recipes.pod:202
5514 " # product-name.sh RHEL60x64\n"
5515 " Red Hat Enterprise Linux Server release 6.0 (Santiago)\n"
5520 #: ../examples/guestfs-recipes.pod:205
5522 "You can also use an XPath query on the L<virt-inspector(1)> XML using the "
5523 "C<xpath> command line tool or from your favourite programming language:"
5527 #: ../examples/guestfs-recipes.pod:209
5530 " # virt-inspector RHEL60x64 > xml\n"
5531 " # xpath '//product_name' < xml\n"
5534 " <product_name>Red Hat Enterprise Linux Server release 6.0 (Santiago)</product_name>\n"
5539 #: ../examples/guestfs-recipes.pod:215
5540 msgid "Get the default boot kernel for a Linux VM"
5544 #: ../examples/guestfs-recipes.pod:217
5546 "The link below contains a program to print the default boot kernel for a "
5551 #: ../examples/guestfs-recipes.pod:220
5553 "https://rwmj.wordpress.com/2010/10/30/tip-use-augeas-to-get-the-default-boot-"
5554 "kernel-for-a-vm/#content"
5558 #: ../examples/guestfs-recipes.pod:222
5560 "It uses Augeas, and the technique is generally applicable for many different "
5565 #: ../examples/guestfs-recipes.pod:229
5566 msgid "listing the user accounts in the guest"
5570 #: ../examples/guestfs-recipes.pod:233
5571 msgid "what repositories is it configured to use"
5575 #: ../examples/guestfs-recipes.pod:237
5576 msgid "what NTP servers does it connect to"
5580 #: ../examples/guestfs-recipes.pod:241
5581 msgid "what were the boot messages last time it booted"
5585 #: ../examples/guestfs-recipes.pod:245
5586 msgid "listing who was logged in recently"
5590 #: ../examples/guestfs-recipes.pod:249
5591 msgid "http://augeas.net/"
5595 #: ../examples/guestfs-recipes.pod:251
5596 msgid "Install RPMs in a guest"
5600 #: ../examples/guestfs-recipes.pod:253
5602 "The link below contains a method to install RPMs in a guest. In fact the "
5603 "RPMs are just uploaded to the guest along with a \"firstboot\" script that "
5604 "installs them next time the guest is booted. You could use this technique "
5605 "to install vital security updates in an offline guest."
5609 #: ../examples/guestfs-recipes.pod:259
5611 "https://rwmj.wordpress.com/2010/12/01/tip-install-rpms-in-a-guest/#content"
5615 #: ../examples/guestfs-recipes.pod:261
5616 msgid "List applications installed in a VM"
5620 #: ../examples/guestfs-recipes.pod:263
5621 msgid "Save the following to a file C<list-apps.sh>:"
5625 #: ../examples/guestfs-recipes.pod:265
5630 " eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n"
5631 " root=\"$(guestfish --remote inspect-get-roots)\"\n"
5632 " guestfish --remote inspect-list-applications \"$root\"\n"
5633 " guestfish --remote exit\n"
5638 #: ../examples/guestfs-recipes.pod:272
5640 "Make the file executable and then you can run it on any named virtual "
5645 #: ../examples/guestfs-recipes.pod:275
5648 " # list-apps.sh WinGuest\n"
5650 " app_name: Mozilla Firefox (3.6.12)\n"
5651 " app_display_name: Mozilla Firefox (3.6.12)\n"
5653 " app_version: 3.6.12 (en-GB)\n"
5655 " app_install_path: C:\\Program Files\\Mozilla Firefox\n"
5656 " app_trans_path:\n"
5657 " app_publisher: Mozilla\n"
5658 " app_url: http://www.mozilla.com/en-GB/\n"
5659 " app_source_package:\n"
5661 " app_description: Mozilla Firefox\n"
5664 " app_name: VLC media player\n"
5665 " app_display_name: VLC media player 1.1.5\n"
5667 " app_version: 1.1.5\n"
5669 " app_install_path: C:\\Program Files\\VideoLAN\\VLC\n"
5670 " app_trans_path:\n"
5671 " app_publisher: VideoLAN\n"
5672 " app_url: http://www.videolan.org/\n"
5673 " app_source_package:\n"
5675 " app_description:\n"
5681 #: ../examples/guestfs-recipes.pod:305
5683 "If you want to run the script on disk images (instead of libvirt virtual "
5684 "machines), change C<-d \"$1\"> to C<-a \"$1\">. See also L<virt-inspector(1)"
5689 #: ../examples/guestfs-recipes.pod:309
5690 msgid "List files and directories in a VM"
5694 #: ../examples/guestfs-recipes.pod:311
5695 msgid "This involves using the L<guestfish(1)> C<find0> command like this:"
5699 #: ../examples/guestfs-recipes.pod:313
5702 " guestfish --ro -d Guest -i find0 / - | tr '\\0' '\\n' | sort\n"
5707 #: ../examples/guestfs-recipes.pod:315
5708 msgid "List services in a Windows VM"
5712 #: ../examples/guestfs-recipes.pod:317
5714 "The link below contains a script that can be used to list out the services "
5715 "from a Windows VM, and whether those services run at boot time or are loaded "
5720 #: ../examples/guestfs-recipes.pod:321
5722 "https://rwmj.wordpress.com/2010/12/10/tip-list-services-in-a-windows-guest/"
5727 #: ../examples/guestfs-recipes.pod:323
5728 msgid "Make a disk image sparse"
5732 #: ../examples/guestfs-recipes.pod:325
5734 "The link below contains some guides for making a disk image sparse (or "
5735 "reintroducing sparseness)."
5739 #: ../examples/guestfs-recipes.pod:328
5741 "https://rwmj.wordpress.com/2010/10/19/tip-making-a-disk-image-sparse/#content"
5745 #: ../examples/guestfs-recipes.pod:330
5746 msgid "Monitor disk usage over time"
5750 #: ../examples/guestfs-recipes.pod:332
5752 "You can use L<virt-df(1)> to monitor disk usage of your guests over time. "
5753 "The link below contains a guide."
5757 #: ../examples/guestfs-recipes.pod:335
5758 msgid "http://virt-tools.org/learning/advanced-virt-df/"
5762 #: ../examples/guestfs-recipes.pod:337
5763 msgid "Reading the Windows Event Log from Windows Vista (or later)"
5767 #: ../examples/guestfs-recipes.pod:339
5769 "L<guestfish(1)> plus the tools described in the link below can be used to "
5770 "read out the Windows Event Log from any virtual machine running Windows "
5771 "Vista or a later version."
5775 #: ../examples/guestfs-recipes.pod:343
5777 "https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-"
5778 "guestfish/#content"
5782 #: ../examples/guestfs-recipes.pod:345
5783 msgid "Remove root password (Linux)"
5787 #: ../examples/guestfs-recipes.pod:347
5789 "Using the L<virt-edit(1)> I<-e> option you can do simple replacements on "
5790 "files. One use is to remove the root password from a Linux guest:"
5794 #: ../examples/guestfs-recipes.pod:350
5797 " virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
5802 #: ../examples/guestfs-recipes.pod:352
5803 msgid "Remove Administrator password (Windows)"
5807 #: ../examples/guestfs-recipes.pod:354
5809 "The link below contains one technique for removing the Administrator "
5810 "password from a Windows VM, or to be more precise, it gives you a command "
5811 "prompt the next time you log in which you can use to bypass any security:"
5815 #: ../examples/guestfs-recipes.pod:359
5817 "https://mdbooth.wordpress.com/2010/10/18/resetting-a-windows-guests-"
5818 "administrator-password-with-guestfish/"
5822 #: ../examples/guestfs-recipes.pod:361
5823 msgid "Unpack a live CD"
5827 #: ../examples/guestfs-recipes.pod:363
5829 "Linux live CDs often contain multiple layers of disk images wrapped like a "
5830 "Russian doll. You can use L<guestfish(1)> to look inside these multiple "
5831 "layers, as outlined in the guide below."
5835 #: ../examples/guestfs-recipes.pod:367
5837 "https://rwmj.wordpress.com/2009/07/15/unpack-the-russian-doll-of-a-f11-live-"
5842 #: ../examples/guestfs-recipes.pod:369
5843 msgid "Uploading and downloading files"
5847 #: ../examples/guestfs-recipes.pod:371
5849 "The link below contains general tips on uploading (copying in) and "
5850 "downloading (copying out) files from VMs."
5854 #: ../examples/guestfs-recipes.pod:374
5856 "https://rwmj.wordpress.com/2010/12/02/tip-uploading-and-downloading/#content"
5860 #: ../examples/guestfs-recipes.pod:376
5861 msgid "Use libguestfs tools on VMware ESX guests"
5865 #: ../examples/guestfs-recipes.pod:378
5867 "The link below explains how to use libguestfs, L<guestfish(1)> and the virt "
5868 "tools on any VMware ESX guests, by first sharing the VMware VMFS over sshfs."
5872 #: ../examples/guestfs-recipes.pod:382
5874 "https://rwmj.wordpress.com/2011/05/10/tip-use-libguestfs-on-vmware-esx-"
5879 #: ../examples/guestfs-recipes.pod:386
5881 "L<guestfs(3)>, L<guestfish(1)>, L<guestfs-examples(3)>, L<guestfs-erlang(3)"
5882 ">, L<guestfs-java(3)>, L<guestfs-ocaml(3)>, L<guestfs-perl(3)>, L<guestfs-"
5883 "python(3)>, L<guestfs-ruby(3)>, L<http://libguestfs.org/>."
5887 #: ../examples/guestfs-recipes.pod:403
5888 msgid "Copyright (C) 2009-2011 Red Hat Inc. L<http://libguestfs.org/>"
5892 #: ../examples/guestfs-testing.pod:5
5893 msgid "guestfs-testing - manual testing of libguestfs, you can help!"
5897 #: ../examples/guestfs-testing.pod:9
5899 "This page has manual tests you can try on libguestfs. Everyone has a "
5900 "slightly different combination of platform, hardware and guests, so this "
5901 "testing is very valuable. Thanks for helping out!"
5905 #: ../examples/guestfs-testing.pod:13
5906 msgid "These tests require libguestfs E<ge> 1.14."
5910 #: ../examples/guestfs-testing.pod:15
5912 "Tests marked with a B<*> (asterisk) can B<destroy data> if you're not "
5913 "careful. The others are safe and won't modify anything."
5917 #: ../examples/guestfs-testing.pod:18
5918 msgid "You can report bugs you find through this link:"
5922 #: ../examples/guestfs-testing.pod:20
5925 #| "L<https://bugzilla.redhat.com/enter_bug.cgi?"
5926 #| "component=libguestfs&product=Virtualization+Tools>"
5928 "https://bugzilla.redhat.com/enter_bug.cgi?"
5929 "component=libguestfs&product=Virtualization+Tools"
5931 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
5932 "component=libguestfs&product=Virtualization+Tools>"
5935 #: ../examples/guestfs-testing.pod:22
5937 "or post on the mailing list (registration is B<not> required, but if you're "
5938 "not registered then you'll have to wait for a moderator to manually approve "
5943 #: ../examples/guestfs-testing.pod:26
5944 msgid "https://www.redhat.com/mailman/listinfo/libguestfs"
5948 #: ../examples/guestfs-testing.pod:28
5953 #: ../examples/guestfs-testing.pod:30
5954 msgid "Check KVM acceleration is being used."
5958 #: ../examples/guestfs-testing.pod:32
5960 "If your host has hardware virt acceleration, then with a hot cache "
5961 "libguestfs should be able to start up in a few seconds. Run the following "
5962 "command a few times:"
5966 #: ../examples/guestfs-testing.pod:36
5969 " time guestfish -a /dev/null run\n"
5974 #: ../examples/guestfs-testing.pod:38
5976 "After a few runs, the time should settle down to a few seconds (under 5 "
5977 "seconds on fast 64 bit hardware)."
5981 #: ../examples/guestfs-testing.pod:41
5982 msgid "How to check for hardware virt:"
5986 #: ../examples/guestfs-testing.pod:43
5987 msgid "http://virt-tools.org/learning/check-hardware-virt/"
5991 #: ../examples/guestfs-testing.pod:45
5993 "If the command above does not work at all, use L<libguestfs-test-tool(1)>."
5997 #: ../examples/guestfs-testing.pod:48
5998 msgid "Run virt-alignment-scan on all your guests."
6002 #: ../examples/guestfs-testing.pod:50
6003 msgid "Run L<virt-alignment-scan(1)> on guests or disk images:"
6007 #: ../examples/guestfs-testing.pod:52
6010 " virt-alignment-scan -a /path/to/disk.img\n"
6015 #: ../examples/guestfs-testing.pod:54 ../examples/guestfs-testing.pod:139
6016 #: ../examples/guestfs-testing.pod:152 ../examples/guestfs-testing.pod:212
6017 #: ../src/guestfs.pod:2792
6022 #: ../examples/guestfs-testing.pod:56
6025 " virt-alignment-scan -d Guest\n"
6030 #: ../examples/guestfs-testing.pod:58
6031 msgid "Does the alignment report match how the guest partitions are aligned?"
6035 #: ../examples/guestfs-testing.pod:60
6038 #| " virt-cat domname file\n"
6040 msgid "Run virt-cat on some files in guests."
6042 " virt-cat назва_домену файл\n"
6046 #: ../examples/guestfs-testing.pod:62
6047 msgid "L<virt-cat(1)> can display files from guests. For a Linux guest, try:"
6051 #: ../examples/guestfs-testing.pod:64
6054 #| " virt-cat -d mydomain /etc/fstab\n"
6057 " virt-cat LinuxGuest /etc/passwd\n"
6060 " virt-cat -d mydomain /etc/fstab\n"
6064 #: ../examples/guestfs-testing.pod:66
6065 msgid "A recent feature is support for Windows paths, for example:"
6069 #: ../examples/guestfs-testing.pod:68
6072 " virt-cat WindowsGuest 'c:\\windows\\win.ini'\n"
6077 #: ../examples/guestfs-testing.pod:70
6079 "An even better test is if you have a Windows guest with multiple drives. Do "
6080 "C<D:>, C<E:> etc paths work correctly?"
6084 #: ../examples/guestfs-testing.pod:73
6085 msgid "B<*> Copy some files into a B<shut off> guest."
6089 #: ../examples/guestfs-testing.pod:75
6091 "L<virt-copy-in(1)> can recursively copy files and directories into a guest "
6096 #: ../examples/guestfs-testing.pod:78
6099 " virt-copy-in -d Guest /etc /tmp\n"
6104 #: ../examples/guestfs-testing.pod:80
6106 "This should copy local directory C</etc> to C</tmp/etc> in the guest "
6107 "(recursively). If you boot the guest, can you see all of the copied files "
6112 #: ../examples/guestfs-testing.pod:84
6113 msgid "Shut the guest down and try copying multiple files and directories:"
6117 #: ../examples/guestfs-testing.pod:86
6120 " virt-copy-in -d Guest /home /etc/issue /tmp\n"
6125 #: ../examples/guestfs-testing.pod:88
6126 msgid "Copy some files out of a guest."
6130 #: ../examples/guestfs-testing.pod:90
6132 "L<virt-copy-out(1)> can recursively copy files and directories out of a "
6133 "guest or disk image."
6137 #: ../examples/guestfs-testing.pod:95
6138 msgid "Note the final space and period in the command is not a typo."
6142 #: ../examples/guestfs-testing.pod:97
6143 msgid "This should copy C</home> from the guest into the current directory."
6147 #: ../examples/guestfs-testing.pod:99
6148 msgid "Run virt-df."
6152 #: ../examples/guestfs-testing.pod:101
6153 msgid "L<virt-df(1)> lists disk space. Run:"
6157 #: ../examples/guestfs-testing.pod:103
6170 #: ../examples/guestfs-testing.pod:105
6171 msgid "Do the results match what's reported inside the guests?"
6175 #: ../examples/guestfs-testing.pod:107
6176 msgid "Try importing virt-df CSV output into a spreadsheet or database."
6180 #: ../examples/guestfs-testing.pod:109 ../src/guestfs.pod:3083
6185 #: ../examples/guestfs-testing.pod:111
6188 " virt-df --csv > /tmp/report.csv\n"
6193 #: ../examples/guestfs-testing.pod:113
6195 "Now try to load this into your favorite spreadsheet or database. Are the "
6196 "results reproduced faithfully in the spreadsheet/database?"
6200 #: ../examples/guestfs-testing.pod:116
6202 "http://www.postgresql.org/docs/8.1/static/sql-copy.html http://dev.mysql.com/"
6203 "doc/refman/5.1/en/load-data.html"
6207 #: ../examples/guestfs-testing.pod:119
6208 msgid "B<*> Edit a file in a B<shut off> guest."
6212 #: ../examples/guestfs-testing.pod:121
6214 "L<virt-edit(1)> can edit files in guests. Try this command on a RHEL or "
6219 #: ../examples/guestfs-testing.pod:124
6222 " virt-edit LinuxGuest /etc/sysconfig/network\n"
6227 #: ../examples/guestfs-testing.pod:126
6228 msgid "On other Linux guests try editing other files such as:"
6232 #: ../examples/guestfs-testing.pod:128
6235 " virt-edit LinuxGuest /etc/motd\n"
6240 #: ../examples/guestfs-testing.pod:130
6241 msgid "Are the changes seen inside the guest when it is booted?"
6245 #: ../examples/guestfs-testing.pod:132
6246 msgid "Display the filesystems / partitions / LVs in a guest."
6250 #: ../examples/guestfs-testing.pod:134
6252 "L<virt-filesystems(1)> can be used to display filesystems in a guest. Try "
6253 "this command on any disk image or guest:"
6257 #: ../examples/guestfs-testing.pod:137
6260 #| " virt-filesystems --format=raw -a disk.img\n"
6263 " virt-filesystems -a /path/to/disk.img --all --long -h\n"
6266 " virt-filesystems --format=raw -a диск.img\n"
6270 #: ../examples/guestfs-testing.pod:141
6273 #| " virt-filesystems [--options] -d domname\n"
6276 " virt-filesystems -d Guest --all --long -h\n"
6279 " virt-filesystems [--параметри] -d назва_домену\n"
6283 #: ../examples/guestfs-testing.pod:143
6284 msgid "Do the results match what is seen in the guest?"
6288 #: ../examples/guestfs-testing.pod:145
6289 msgid "Run virt-inspector on all your guests."
6293 #: ../examples/guestfs-testing.pod:147
6295 "Use L<virt-inspector(1)> to get a report on all of your guests or disk "
6300 #: ../examples/guestfs-testing.pod:150
6303 #| " virt-cat disk.img file\n"
6306 " virt-inspector -a /path/to/disk.img | less\n"
6309 " virt-cat диск.img файл\n"
6313 #: ../examples/guestfs-testing.pod:154
6316 " virt-inspector -d Guest | less\n"
6321 #: ../examples/guestfs-testing.pod:156
6322 msgid "Do the results match what is actually in the guest?"
6326 #: ../examples/guestfs-testing.pod:158
6327 msgid "Try the auditing features of virt-ls on all your guests."
6331 #: ../examples/guestfs-testing.pod:162
6334 #| " $ virt-ls -R -d guest /tmp\n"
6340 " virt-ls -lR -d Guest / | grep '^- [42]'\n"
6343 " $ virt-ls -R -d guest /tmp\n"
6350 #: ../examples/guestfs-testing.pod:166
6353 #| " $ virt-ls -R -d guest /tmp\n"
6359 " virt-ls -lR -d Guest / | grep '^d ...7'\n"
6362 " $ virt-ls -R -d guest /tmp\n"
6369 #: ../examples/guestfs-testing.pod:170
6372 #| " $ virt-ls -R -d guest /tmp\n"
6378 " virt-ls -lR -d Guest / | grep '^s'\n"
6381 " $ virt-ls -R -d guest /tmp\n"
6388 #: ../examples/guestfs-testing.pod:174
6391 " virt-ls -lR -d Guest / | grep -i '^-.*\\.png$'\n"
6396 #: ../examples/guestfs-testing.pod:176
6397 msgid "Display files larger than 10MB in home directories:"
6401 #: ../examples/guestfs-testing.pod:178
6404 " virt-ls -lR -d Guest /home | awk '$3 > 10*1024*1024'\n"
6409 #: ../examples/guestfs-testing.pod:182
6412 " virt-ls -lR -d Guest --time-days / | awk '$6 <= 7'\n"
6417 #: ../examples/guestfs-testing.pod:186
6420 " virt-ls -lR -d Guest --time-days / | grep '^-' | awk '$6 < 1'\n"
6425 #: ../examples/guestfs-testing.pod:188
6426 msgid "Do the results match what is in the guest?"
6430 #: ../examples/guestfs-testing.pod:190
6431 msgid "Create a disk image from a tarball."
6435 #: ../examples/guestfs-testing.pod:192
6437 "Use L<virt-make-fs(1)> to create a disk image from any tarball that you "
6442 #: ../examples/guestfs-testing.pod:195
6445 " virt-make-fs --partition=mbr --type=vfat /any/tarball.tar.gz output.img\n"
6450 #: ../examples/guestfs-testing.pod:197
6452 "Add 'output.img' as a raw disk to an existing guest. Check the guest can "
6453 "see the files. This test is particularly useful if you try it with a "
6458 #: ../examples/guestfs-testing.pod:201
6459 msgid "Try other partitioning schemes, eg. I<--partition=gpt>."
6463 #: ../examples/guestfs-testing.pod:203
6464 msgid "Try other filesystem formats, eg. I<--type=ntfs>, I<--type=ext2>."
6468 #: ../examples/guestfs-testing.pod:205
6469 msgid "B<*> Run virt-rescue on a B<shut off> disk image or guest."
6473 #: ../examples/guestfs-testing.pod:207
6475 "Use L<virt-rescue(1)> to examine, rescue or repair a B<shut off> guest or "
6480 #: ../examples/guestfs-testing.pod:210
6483 #| " virt-cat disk.img file\n"
6486 " virt-rescue -a /path/to/disk.img\n"
6489 " virt-cat диск.img файл\n"
6493 #: ../examples/guestfs-testing.pod:214
6496 " virt-rescue -d Guest\n"
6501 #: ../examples/guestfs-testing.pod:216
6502 msgid "Can you use ordinary shell commands to examine the guest?"
6506 #: ../examples/guestfs-testing.pod:218
6507 msgid "B<*> Resize your guests."
6511 #: ../examples/guestfs-testing.pod:220
6513 "Use L<virt-resize(1)> to give a guest some more disk space. For example, if "
6514 "you have a disk image that is smaller than 30G, increase it to 30G by doing:"
6518 #: ../examples/guestfs-testing.pod:224
6521 " truncate -s 30G newdisk.img\n"
6522 " virt-filesystems -a /path/to/olddisk.img --all --long -h\n"
6523 " virt-resize /path/to/olddisk.img newdisk.img --expand /dev/sda1\n"
6524 " qemu-kvm -m 1024 -hda newdisk.img\n"
6529 #: ../examples/guestfs-testing.pod:229
6530 msgid "Does the guest still boot? Try expanding other partitions."
6534 #: ../examples/guestfs-testing.pod:231
6535 msgid "B<*> Sparsify a guest disk."
6539 #: ../examples/guestfs-testing.pod:233
6540 msgid "Using L<virt-sparsify(1)>, make a disk image more sparse:"
6544 #: ../examples/guestfs-testing.pod:235
6547 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
6550 " virt-sparsify /path/to/olddisk.img newdisk.img\n"
6553 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
6557 #: ../examples/guestfs-testing.pod:237
6559 "Is C<newdisk.img> still bootable after sparsifying? Is the resulting disk "
6560 "image smaller (use C<du> to check)?"
6564 #: ../examples/guestfs-testing.pod:240
6565 msgid "B<*> \"sysprep\" a B<shut off> Linux guest."
6569 #: ../examples/guestfs-testing.pod:242
6571 "Note that this really will mess up an existing guest, so it's better to "
6572 "clone the guest before trying this."
6576 #: ../examples/guestfs-testing.pod:245
6579 " virt-sysprep --hostname newhost.example.com -a /path/to/disk.img\n"
6584 #: ../examples/guestfs-testing.pod:247
6586 "Was the sysprep successful? After booting, what changes were made and were "
6591 #: ../examples/guestfs-testing.pod:250
6592 msgid "Dump the Windows Registry from your Windows guests."
6596 #: ../examples/guestfs-testing.pod:252
6598 "Use L<virt-win-reg(1)> to dump out the Windows Registry from any Windows "
6599 "guests that you have."
6603 #: ../examples/guestfs-testing.pod:255
6606 " virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\Software' |\n"
6612 #: ../examples/guestfs-testing.pod:258
6615 " virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\System' |\n"
6621 #: ../examples/guestfs-testing.pod:261
6622 msgid "Does the output match running C<regedit> inside the guest?"
6626 #: ../examples/guestfs-testing.pod:263
6628 "A recent feature is the ability to dump user registries, so try this, "
6629 "replacing I<username> with the name of a local user in the guest:"
6633 #: ../examples/guestfs-testing.pod:266
6636 " virt-win-reg --unsafe-printable-strings WindowsGuest 'HKEY_USERS\\username' |\n"
6642 #: ../examples/guestfs-testing.pod:271
6645 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, "
6646 #| "L<virt-tar-out(1)>, L<http://libguestfs.org/>."
6648 "L<guestfs(3)>, L<guestfish(1)>, L<guestfs-examples(3)>, L<http://libguestfs."
6651 "L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, L<virt-"
6652 "tar-out(1)>, L<http://libguestfs.org/>."
6655 #: ../fish/guestfish-actions.pod:1
6660 #: ../fish/guestfish-actions.pod:3
6663 " add-cdrom filename\n"
6668 #: ../fish/guestfish-actions.pod:5 ../src/guestfs-actions.pod:14
6669 msgid "This function adds a virtual CD-ROM disk image to the guest."
6673 #: ../fish/guestfish-actions.pod:7 ../src/guestfs-actions.pod:16
6674 msgid "This is equivalent to the qemu parameter I<-cdrom filename>."
6678 #: ../fish/guestfish-actions.pod:15
6680 "This call checks for the existence of C<filename>. This stops you from "
6681 "specifying other types of drive which are supported by qemu such as C<nbd:> "
6682 "and C<http:> URLs. To specify those, use the general L</config> call "
6687 #: ../fish/guestfish-actions.pod:22
6689 "If you just want to add an ISO file (often you use this as an efficient way "
6690 "to transfer large files into the guest), then you should probably use L</add-"
6691 "drive-ro> instead."
6695 #: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:214
6696 #: ../fish/guestfish-actions.pod:228
6698 "I<This function is deprecated.> In new code, use the L</add_drive_opts> call "
6703 #: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:217
6704 #: ../fish/guestfish-actions.pod:231 ../fish/guestfish-actions.pod:941
6705 #: ../fish/guestfish-actions.pod:976 ../fish/guestfish-actions.pod:1149
6706 #: ../fish/guestfish-actions.pod:1509 ../fish/guestfish-actions.pod:1523
6707 #: ../fish/guestfish-actions.pod:3381 ../fish/guestfish-actions.pod:3692
6708 #: ../fish/guestfish-actions.pod:3740 ../fish/guestfish-actions.pod:4658
6709 #: ../fish/guestfish-actions.pod:4678 ../fish/guestfish-actions.pod:4697
6710 #: ../fish/guestfish-actions.pod:4735 ../fish/guestfish-actions.pod:5463
6711 #: ../fish/guestfish-actions.pod:5566 ../src/guestfs-actions.pod:10
6712 #: ../src/guestfs-actions.pod:305 ../src/guestfs-actions.pod:326
6713 #: ../src/guestfs-actions.pod:1580 ../src/guestfs-actions.pod:1637
6714 #: ../src/guestfs-actions.pod:1920 ../src/guestfs-actions.pod:2419
6715 #: ../src/guestfs-actions.pod:2440 ../src/guestfs-actions.pod:5225
6716 #: ../src/guestfs-actions.pod:5747 ../src/guestfs-actions.pod:5847
6717 #: ../src/guestfs-actions.pod:7143 ../src/guestfs-actions.pod:7184
6718 #: ../src/guestfs-actions.pod:7215 ../src/guestfs-actions.pod:7275
6719 #: ../src/guestfs-actions.pod:8327 ../src/guestfs-actions.pod:8436
6720 #: ../src/guestfs-actions.pod:8616
6722 "Deprecated functions will not be removed from the API, but the fact that "
6723 "they are deprecated indicates that there are problems with correct use of "
6728 #: ../fish/guestfish-actions.pod:35
6733 #: ../fish/guestfish-actions.pod:37
6738 #: ../fish/guestfish-actions.pod:39
6741 " add-domain dom [libvirturi:..] [readonly:true|false] [iface:..] [live:true|false] [allowuuid:true|false] [readonlydisk:..]\n"
6746 #: ../fish/guestfish-actions.pod:41
6748 "This function adds the disk(s) attached to the named libvirt domain C<dom>. "
6749 "It works by connecting to libvirt, requesting the domain and domain XML from "
6750 "libvirt, parsing it for disks, and calling L</add-drive-opts> on each one."
6754 #: ../fish/guestfish-actions.pod:46 ../src/guestfs-actions.pod:65
6756 "The number of disks added is returned. This operation is atomic: if an "
6757 "error is returned, then no disks are added."
6761 #: ../fish/guestfish-actions.pod:49 ../src/guestfs-actions.pod:68
6763 "This function does some minimal checks to make sure the libvirt domain is "
6764 "not running (unless C<readonly> is true). In a future version we will try "
6765 "to acquire the libvirt lock on each disk."
6769 #: ../fish/guestfish-actions.pod:53 ../src/guestfs-actions.pod:72
6771 "Disks must be accessible locally. This often means that adding disks from a "
6772 "remote libvirt connection (see L<http://libvirt.org/remote.html>) will fail "
6773 "unless those disks are accessible via the same device path locally too."
6777 #: ../fish/guestfish-actions.pod:58 ../src/guestfs-actions.pod:77
6779 "The optional C<libvirturi> parameter sets the libvirt URI (see L<http://"
6780 "libvirt.org/uri.html>). If this is not set then we connect to the default "
6781 "libvirt URI (or one set through an environment variable, see the libvirt "
6782 "documentation for full details)."
6786 #: ../fish/guestfish-actions.pod:64 ../src/guestfs-actions.pod:83
6788 "The optional C<live> flag controls whether this call will try to connect to "
6789 "a running virtual machine C<guestfsd> process if it sees a suitable "
6790 "E<lt>channelE<gt> element in the libvirt XML definition. The default (if "
6791 "the flag is omitted) is never to try. See L<guestfs(3)/ATTACHING TO RUNNING "
6792 "DAEMONS> for more information."
6796 #: ../fish/guestfish-actions.pod:71 ../src/guestfs-actions.pod:90
6798 "If the C<allowuuid> flag is true (default is false) then a UUID I<may> be "
6799 "passed instead of the domain name. The C<dom> string is treated as a UUID "
6800 "first and looked up, and if that lookup fails then we treat C<dom> as a name "
6805 #: ../fish/guestfish-actions.pod:76 ../src/guestfs-actions.pod:95
6807 "The optional C<readonlydisk> parameter controls what we do for disks which "
6808 "are marked E<lt>readonly/E<gt> in the libvirt XML. Possible values are:"
6812 #: ../fish/guestfish-actions.pod:82 ../src/guestfs-actions.pod:101
6813 msgid "readonlydisk = \"error\""
6817 #: ../fish/guestfish-actions.pod:84 ../fish/guestfish-actions.pod:95
6818 #: ../fish/guestfish-actions.pod:106 ../src/guestfs-actions.pod:103
6819 #: ../src/guestfs-actions.pod:114 ../src/guestfs-actions.pod:125
6820 msgid "If C<readonly> is false:"
6824 #: ../fish/guestfish-actions.pod:86 ../src/guestfs-actions.pod:105
6826 "The whole call is aborted with an error if any disk with the E<lt>readonly/"
6827 "E<gt> flag is found."
6831 #: ../fish/guestfish-actions.pod:89 ../fish/guestfish-actions.pod:100
6832 #: ../fish/guestfish-actions.pod:110 ../src/guestfs-actions.pod:108
6833 #: ../src/guestfs-actions.pod:119 ../src/guestfs-actions.pod:129
6834 msgid "If C<readonly> is true:"
6838 #: ../fish/guestfish-actions.pod:91 ../fish/guestfish-actions.pod:102
6839 #: ../fish/guestfish-actions.pod:112 ../src/guestfs-actions.pod:110
6840 #: ../src/guestfs-actions.pod:121 ../src/guestfs-actions.pod:131
6841 msgid "Disks with the E<lt>readonly/E<gt> flag are added read-only."
6845 #: ../fish/guestfish-actions.pod:93 ../src/guestfs-actions.pod:112
6846 msgid "readonlydisk = \"read\""
6850 #: ../fish/guestfish-actions.pod:97 ../src/guestfs-actions.pod:116
6852 "Disks with the E<lt>readonly/E<gt> flag are added read-only. Other disks "
6853 "are added read/write."
6857 #: ../fish/guestfish-actions.pod:104 ../src/guestfs-actions.pod:123
6858 msgid "readonlydisk = \"write\" (default)"
6862 #: ../fish/guestfish-actions.pod:108 ../src/guestfs-actions.pod:127
6863 msgid "Disks with the E<lt>readonly/E<gt> flag are added read/write."
6867 #: ../fish/guestfish-actions.pod:114 ../src/guestfs-actions.pod:133
6868 msgid "readonlydisk = \"ignore\""
6872 #: ../fish/guestfish-actions.pod:116 ../src/guestfs-actions.pod:135
6873 msgid "If C<readonly> is true or false:"
6877 #: ../fish/guestfish-actions.pod:118 ../src/guestfs-actions.pod:137
6878 msgid "Disks with the E<lt>readonly/E<gt> flag are skipped."
6882 #: ../fish/guestfish-actions.pod:122
6884 "The other optional parameters are passed directly through to L</add-drive-"
6889 #: ../fish/guestfish-actions.pod:125 ../fish/guestfish-actions.pod:194
6890 #: ../fish/guestfish-actions.pod:624 ../fish/guestfish-actions.pod:835
6891 #: ../fish/guestfish-actions.pod:856 ../fish/guestfish-actions.pod:894
6892 #: ../fish/guestfish-actions.pod:903 ../fish/guestfish-actions.pod:912
6893 #: ../fish/guestfish-actions.pod:926 ../fish/guestfish-actions.pod:2171
6894 #: ../fish/guestfish-actions.pod:3215 ../fish/guestfish-actions.pod:3430
6895 #: ../fish/guestfish-actions.pod:3593 ../fish/guestfish-actions.pod:3728
6896 #: ../fish/guestfish-actions.pod:5099
6898 "This command has one or more optional arguments. See L</OPTIONAL ARGUMENTS>."
6902 #: ../fish/guestfish-actions.pod:127
6907 #: ../fish/guestfish-actions.pod:129
6910 " add-drive filename\n"
6913 " add-drive назва_файла\n"
6917 #: ../fish/guestfish-actions.pod:131
6919 "This function is the equivalent of calling L</add-drive-opts> with no "
6920 "optional parameters, so the disk is added writable, with the format being "
6921 "detected automatically."
6925 #: ../fish/guestfish-actions.pod:135
6927 "Automatic detection of the format opens you up to a potential security hole "
6928 "when dealing with untrusted raw-format images. See CVE-2010-3851 and "
6929 "RHBZ#642934. Specifying the format closes this security hole. Therefore "
6930 "you should think about replacing calls to this function with calls to L</add-"
6931 "drive-opts>, and specifying the format."
6935 #: ../fish/guestfish-actions.pod:142
6936 msgid "add-drive-opts"
6937 msgstr "add-drive-opts"
6940 #: ../fish/guestfish-actions.pod:144
6945 #: ../fish/guestfish-actions.pod:146
6948 " add-drive-opts filename [readonly:true|false] [format:..] [iface:..] [name:..]\n"
6953 #: ../fish/guestfish-actions.pod:148 ../src/guestfs-actions.pod:208
6955 "This function adds a virtual machine disk image C<filename> to libguestfs. "
6956 "The first time you call this function, the disk appears as C</dev/sda>, the "
6957 "second time as C</dev/sdb>, and so on."
6961 #: ../fish/guestfish-actions.pod:153 ../src/guestfs-actions.pod:213
6963 "You don't necessarily need to be root when using libguestfs. However you "
6964 "obviously do need sufficient permissions to access the filename for whatever "
6965 "operations you want to perform (ie. read access if you just want to read the "
6966 "image or write access if you want to modify the image)."
6970 #: ../fish/guestfish-actions.pod:159 ../src/guestfs-actions.pod:219
6971 msgid "This call checks that C<filename> exists."
6975 #: ../fish/guestfish-actions.pod:161 ../fish/guestfish-actions.pod:3392
6976 #: ../src/guestfs-actions.pod:221 ../src/guestfs-actions.pod:5262
6977 msgid "The optional arguments are:"
6981 #: ../fish/guestfish-actions.pod:165 ../src/guestfs-actions.pod:225
6983 msgstr "C<readonly>"
6986 #: ../fish/guestfish-actions.pod:167 ../src/guestfs-actions.pod:227
6988 "If true then the image is treated as read-only. Writes are still allowed, "
6989 "but they are stored in a temporary snapshot overlay which is discarded at "
6990 "the end. The disk that you add is not modified."
6994 #: ../fish/guestfish-actions.pod:171 ../src/guestfs-actions.pod:231
6999 #: ../fish/guestfish-actions.pod:173
7001 "This forces the image format. If you omit this (or use L</add-drive> or L</"
7002 "add-drive-ro>) then the format is automatically detected. Possible formats "
7003 "include C<raw> and C<qcow2>."
7007 #: ../fish/guestfish-actions.pod:177 ../src/guestfs-actions.pod:237
7009 "Automatic detection of the format opens you up to a potential security hole "
7010 "when dealing with untrusted raw-format images. See CVE-2010-3851 and "
7011 "RHBZ#642934. Specifying the format closes this security hole."
7015 #: ../fish/guestfish-actions.pod:182 ../src/guestfs-actions.pod:242
7020 #: ../fish/guestfish-actions.pod:184
7022 "This rarely-used option lets you emulate the behaviour of the deprecated L</"
7023 "add-drive-with-if> call (q.v.)"
7027 #: ../fish/guestfish-actions.pod:187 ../fish/guestfish-actions.pod:3242
7028 #: ../src/guestfs-actions.pod:247 ../src/guestfs-actions.pod:4994
7033 #: ../fish/guestfish-actions.pod:189 ../src/guestfs-actions.pod:249
7035 "The name the drive had in the original guest, e.g. /dev/sdb. This is used as "
7036 "a hint to the guest inspection process if it is available."
7040 #: ../fish/guestfish-actions.pod:196
7041 msgid "add-drive-ro"
7042 msgstr "add-drive-ro"
7045 #: ../fish/guestfish-actions.pod:198
7050 #: ../fish/guestfish-actions.pod:200
7053 " add-drive-ro filename\n"
7058 #: ../fish/guestfish-actions.pod:202
7060 "This function is the equivalent of calling L</add-drive-opts> with the "
7061 "optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk "
7062 "is added read-only, with the format being detected automatically."
7066 #: ../fish/guestfish-actions.pod:207
7067 msgid "add-drive-ro-with-if"
7071 #: ../fish/guestfish-actions.pod:209
7074 " add-drive-ro-with-if filename iface\n"
7079 #: ../fish/guestfish-actions.pod:211
7081 "This is the same as L</add-drive-ro> but it allows you to specify the QEMU "
7082 "interface emulation to use at run time."
7086 #: ../fish/guestfish-actions.pod:221
7087 msgid "add-drive-with-if"
7091 #: ../fish/guestfish-actions.pod:223
7094 " add-drive-with-if filename iface\n"
7099 #: ../fish/guestfish-actions.pod:225
7101 "This is the same as L</add-drive> but it allows you to specify the QEMU "
7102 "interface emulation to use at run time."
7106 #: ../fish/guestfish-actions.pod:235
7111 #: ../fish/guestfish-actions.pod:237
7114 " aug-clear augpath\n"
7119 #: ../fish/guestfish-actions.pod:239 ../src/guestfs-actions.pod:343
7121 "Set the value associated with C<path> to C<NULL>. This is the same as the "
7122 "L<augtool(1)> C<clear> command."
7126 #: ../fish/guestfish-actions.pod:242
7131 #: ../fish/guestfish-actions.pod:244
7139 #: ../fish/guestfish-actions.pod:246
7141 "Close the current Augeas handle and free up any resources used by it. After "
7142 "calling this, you have to call L</aug-init> again before you can use any "
7143 "other Augeas functions."
7147 #: ../fish/guestfish-actions.pod:251
7152 #: ../fish/guestfish-actions.pod:253
7155 " aug-defnode name expr val\n"
7160 #: ../fish/guestfish-actions.pod:255 ../src/guestfs-actions.pod:372
7162 "Defines a variable C<name> whose value is the result of evaluating C<expr>."
7166 #: ../fish/guestfish-actions.pod:258
7168 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
7169 "calling L</aug-set> C<expr>, C<value>. C<name> will be the nodeset "
7170 "containing that single node."
7174 #: ../fish/guestfish-actions.pod:262 ../src/guestfs-actions.pod:379
7176 "On success this returns a pair containing the number of nodes in the "
7177 "nodeset, and a boolean flag if a node was created."
7181 #: ../fish/guestfish-actions.pod:266
7186 #: ../fish/guestfish-actions.pod:268
7189 " aug-defvar name expr\n"
7194 #: ../fish/guestfish-actions.pod:270 ../src/guestfs-actions.pod:396
7196 "Defines an Augeas variable C<name> whose value is the result of evaluating "
7197 "C<expr>. If C<expr> is NULL, then C<name> is undefined."
7201 #: ../fish/guestfish-actions.pod:274 ../src/guestfs-actions.pod:400
7203 "On success this returns the number of nodes in C<expr>, or C<0> if C<expr> "
7204 "evaluates to something which is not a nodeset."
7208 #: ../fish/guestfish-actions.pod:277
7213 #: ../fish/guestfish-actions.pod:279
7216 " aug-get augpath\n"
7221 #: ../fish/guestfish-actions.pod:281 ../src/guestfs-actions.pod:413
7223 "Look up the value associated with C<path>. If C<path> matches exactly one "
7224 "node, the C<value> is returned."
7228 #: ../fish/guestfish-actions.pod:284
7233 #: ../fish/guestfish-actions.pod:286
7236 " aug-init root flags\n"
7241 #: ../fish/guestfish-actions.pod:288 ../src/guestfs-actions.pod:428
7243 "Create a new Augeas handle for editing configuration files. If there was "
7244 "any previous Augeas handle associated with this guestfs session, then it is "
7249 #: ../fish/guestfish-actions.pod:292
7250 msgid "You must call this before using any other L</aug-*> commands."
7254 #: ../fish/guestfish-actions.pod:295 ../src/guestfs-actions.pod:435
7256 "C<root> is the filesystem root. C<root> must not be NULL, use C</> instead."
7260 #: ../fish/guestfish-actions.pod:298 ../src/guestfs-actions.pod:438
7262 "The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the "
7263 "logical I<or> of the following integers:"
7267 #: ../fish/guestfish-actions.pod:304 ../src/guestfs-actions.pod:444
7268 msgid "C<AUG_SAVE_BACKUP> = 1"
7269 msgstr "C<AUG_SAVE_BACKUP> = 1"
7272 #: ../fish/guestfish-actions.pod:306 ../src/guestfs-actions.pod:446
7273 msgid "Keep the original file with a C<.augsave> extension."
7277 #: ../fish/guestfish-actions.pod:308 ../src/guestfs-actions.pod:448
7278 msgid "C<AUG_SAVE_NEWFILE> = 2"
7279 msgstr "C<AUG_SAVE_NEWFILE> = 2"
7282 #: ../fish/guestfish-actions.pod:310 ../src/guestfs-actions.pod:450
7284 "Save changes into a file with extension C<.augnew>, and do not overwrite "
7285 "original. Overrides C<AUG_SAVE_BACKUP>."
7289 #: ../fish/guestfish-actions.pod:313 ../src/guestfs-actions.pod:453
7290 msgid "C<AUG_TYPE_CHECK> = 4"
7291 msgstr "C<AUG_TYPE_CHECK> = 4"
7294 #: ../fish/guestfish-actions.pod:315 ../src/guestfs-actions.pod:455
7295 msgid "Typecheck lenses."
7299 #: ../fish/guestfish-actions.pod:317
7301 "This option is only useful when debugging Augeas lenses. Use of this option "
7302 "may require additional memory for the libguestfs appliance. You may need to "
7303 "set the C<LIBGUESTFS_MEMSIZE> environment variable or call L</set-memsize>."
7307 #: ../fish/guestfish-actions.pod:322 ../src/guestfs-actions.pod:462
7308 msgid "C<AUG_NO_STDINC> = 8"
7309 msgstr "C<AUG_NO_STDINC> = 8"
7312 #: ../fish/guestfish-actions.pod:324 ../src/guestfs-actions.pod:464
7313 msgid "Do not use standard load path for modules."
7317 #: ../fish/guestfish-actions.pod:326 ../src/guestfs-actions.pod:466
7318 msgid "C<AUG_SAVE_NOOP> = 16"
7319 msgstr "C<AUG_SAVE_NOOP> = 16"
7322 #: ../fish/guestfish-actions.pod:328 ../src/guestfs-actions.pod:468
7323 msgid "Make save a no-op, just record what would have been changed."
7327 #: ../fish/guestfish-actions.pod:330 ../src/guestfs-actions.pod:470
7328 msgid "C<AUG_NO_LOAD> = 32"
7329 msgstr "C<AUG_NO_LOAD> = 32"
7332 #: ../fish/guestfish-actions.pod:332
7333 msgid "Do not load the tree in L</aug-init>."
7337 #: ../fish/guestfish-actions.pod:336
7338 msgid "To close the handle, you can call L</aug-close>."
7342 #: ../fish/guestfish-actions.pod:338 ../src/guestfs-actions.pod:478
7343 msgid "To find out more about Augeas, see L<http://augeas.net/>."
7347 #: ../fish/guestfish-actions.pod:340
7352 #: ../fish/guestfish-actions.pod:342
7355 " aug-insert augpath label true|false\n"
7360 #: ../fish/guestfish-actions.pod:344 ../src/guestfs-actions.pod:492
7362 "Create a new sibling C<label> for C<path>, inserting it into the tree before "
7363 "or after C<path> (depending on the boolean flag C<before>)."
7367 #: ../fish/guestfish-actions.pod:348 ../src/guestfs-actions.pod:496
7369 "C<path> must match exactly one existing node in the tree, and C<label> must "
7370 "be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>."
7374 #: ../fish/guestfish-actions.pod:352
7379 #: ../fish/guestfish-actions.pod:354
7387 #: ../fish/guestfish-actions.pod:356 ../src/guestfs-actions.pod:509
7388 msgid "Load files into the tree."
7389 msgstr "Завантажити файли до ієрархії."
7392 #: ../fish/guestfish-actions.pod:358 ../src/guestfs-actions.pod:511
7393 msgid "See C<aug_load> in the Augeas documentation for the full gory details."
7397 #: ../fish/guestfish-actions.pod:361
7402 #: ../fish/guestfish-actions.pod:363
7410 #: ../fish/guestfish-actions.pod:365
7412 "This is just a shortcut for listing L</aug-match> C<path/*> and sorting the "
7413 "resulting nodes into alphabetical order."
7417 #: ../fish/guestfish-actions.pod:368
7422 #: ../fish/guestfish-actions.pod:370
7425 " aug-match augpath\n"
7430 #: ../fish/guestfish-actions.pod:372 ../src/guestfs-actions.pod:539
7432 "Returns a list of paths which match the path expression C<path>. The "
7433 "returned paths are sufficiently qualified so that they match exactly one "
7434 "node in the current tree."
7438 #: ../fish/guestfish-actions.pod:376
7443 #: ../fish/guestfish-actions.pod:378
7446 " aug-mv src dest\n"
7451 #: ../fish/guestfish-actions.pod:380 ../src/guestfs-actions.pod:556
7453 "Move the node C<src> to C<dest>. C<src> must match exactly one node. "
7454 "C<dest> is overwritten if it exists."
7458 #: ../fish/guestfish-actions.pod:383
7463 #: ../fish/guestfish-actions.pod:385
7471 #: ../fish/guestfish-actions.pod:387 ../src/guestfs-actions.pod:569
7472 msgid "Remove C<path> and all of its children."
7476 #: ../fish/guestfish-actions.pod:389 ../src/guestfs-actions.pod:571
7477 msgid "On success this returns the number of entries which were removed."
7481 #: ../fish/guestfish-actions.pod:391
7486 #: ../fish/guestfish-actions.pod:393
7494 #: ../fish/guestfish-actions.pod:395 ../src/guestfs-actions.pod:582
7495 msgid "This writes all pending changes to disk."
7499 #: ../fish/guestfish-actions.pod:397
7501 "The flags which were passed to L</aug-init> affect exactly how files are "
7506 #: ../fish/guestfish-actions.pod:400
7511 #: ../fish/guestfish-actions.pod:402
7514 " aug-set augpath val\n"
7519 #: ../fish/guestfish-actions.pod:404 ../src/guestfs-actions.pod:598
7520 msgid "Set the value associated with C<path> to C<val>."
7524 #: ../fish/guestfish-actions.pod:406
7526 "In the Augeas API, it is possible to clear a node by setting the value to "
7527 "NULL. Due to an oversight in the libguestfs API you cannot do that with "
7528 "this call. Instead you must use the L</aug-clear> call."
7532 #: ../fish/guestfish-actions.pod:411
7537 #: ../fish/guestfish-actions.pod:413
7540 " available 'groups ...'\n"
7545 #: ../fish/guestfish-actions.pod:415 ../src/guestfs-actions.pod:615
7547 "This command is used to check the availability of some groups of "
7548 "functionality in the appliance, which not all builds of the libguestfs "
7549 "appliance will be able to provide."
7553 #: ../fish/guestfish-actions.pod:419
7555 "The libguestfs groups, and the functions that those groups correspond to, "
7556 "are listed in L<guestfs(3)/AVAILABILITY>. You can also fetch this list at "
7557 "runtime by calling L</available-all-groups>."
7561 #: ../fish/guestfish-actions.pod:424 ../src/guestfs-actions.pod:624
7563 "The argument C<groups> is a list of group names, eg: C<[\"inotify\", \"augeas"
7564 "\"]> would check for the availability of the Linux inotify functions and "
7565 "Augeas (configuration file editing) functions."
7569 #: ../fish/guestfish-actions.pod:429 ../src/guestfs-actions.pod:629
7570 msgid "The command returns no error if I<all> requested groups are available."
7574 #: ../fish/guestfish-actions.pod:431 ../src/guestfs-actions.pod:631
7576 "It fails with an error if one or more of the requested groups is unavailable "
7581 #: ../fish/guestfish-actions.pod:434 ../src/guestfs-actions.pod:634
7583 "If an unknown group name is included in the list of groups then an error is "
7588 #: ../fish/guestfish-actions.pod:437 ../src/guestfs-actions.pod:637
7590 msgstr "I<Нотатки:>"
7593 #: ../fish/guestfish-actions.pod:443
7594 msgid "You must call L</launch> before calling this function."
7598 #: ../fish/guestfish-actions.pod:445 ../src/guestfs-actions.pod:645
7600 "The reason is because we don't know what groups are supported by the "
7601 "appliance/daemon until it is running and can be queried."
7605 #: ../fish/guestfish-actions.pod:451 ../src/guestfs-actions.pod:651
7607 "If a group of functions is available, this does not necessarily mean that "
7608 "they will work. You still have to check for errors when calling individual "
7609 "API functions even if they are available."
7613 #: ../fish/guestfish-actions.pod:458 ../src/guestfs-actions.pod:658
7615 "It is usually the job of distro packagers to build complete functionality "
7616 "into the libguestfs appliance. Upstream libguestfs, if built from source "
7617 "with all requirements satisfied, will support everything."
7621 #: ../fish/guestfish-actions.pod:465
7623 "This call was added in version C<1.0.80>. In previous versions of "
7624 "libguestfs all you could do would be to speculatively execute a command to "
7625 "find out if the daemon implemented it. See also L</version>."
7629 #: ../fish/guestfish-actions.pod:472
7630 msgid "available-all-groups"
7634 #: ../fish/guestfish-actions.pod:474
7637 " available-all-groups\n"
7642 #: ../fish/guestfish-actions.pod:476
7644 "This command returns a list of all optional groups that this daemon knows "
7645 "about. Note this returns both supported and unsupported groups. To find "
7646 "out which ones the daemon can actually support you have to call L</"
7647 "available> on each member of the returned list."
7651 #: ../fish/guestfish-actions.pod:482
7652 msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>."
7656 #: ../fish/guestfish-actions.pod:484
7661 #: ../fish/guestfish-actions.pod:486
7664 " base64-in (base64file|-) filename\n"
7669 #: ../fish/guestfish-actions.pod:488 ../src/guestfs-actions.pod:702
7671 "This command uploads base64-encoded data from C<base64file> to C<filename>."
7675 #: ../fish/guestfish-actions.pod:491 ../fish/guestfish-actions.pod:500
7676 #: ../fish/guestfish-actions.pod:749 ../fish/guestfish-actions.pod:833
7677 #: ../fish/guestfish-actions.pod:854 ../fish/guestfish-actions.pod:1025
7678 #: ../fish/guestfish-actions.pod:1044 ../fish/guestfish-actions.pod:1418
7679 #: ../fish/guestfish-actions.pod:4955 ../fish/guestfish-actions.pod:4967
7680 #: ../fish/guestfish-actions.pod:4978 ../fish/guestfish-actions.pod:4989
7681 #: ../fish/guestfish-actions.pod:5120 ../fish/guestfish-actions.pod:5129
7682 #: ../fish/guestfish-actions.pod:5183 ../fish/guestfish-actions.pod:5206
7683 msgid "Use C<-> instead of a filename to read/write from stdin/stdout."
7687 #: ../fish/guestfish-actions.pod:493
7692 #: ../fish/guestfish-actions.pod:495
7695 " base64-out filename (base64file|-)\n"
7700 #: ../fish/guestfish-actions.pod:497 ../src/guestfs-actions.pod:716
7702 "This command downloads the contents of C<filename>, writing it out to local "
7703 "file C<base64file> encoded as base64."
7707 #: ../fish/guestfish-actions.pod:502
7708 msgid "blockdev-flushbufs"
7712 #: ../fish/guestfish-actions.pod:504
7715 " blockdev-flushbufs device\n"
7720 #: ../fish/guestfish-actions.pod:506 ../src/guestfs-actions.pod:729
7722 "This tells the kernel to flush internal buffers associated with C<device>."
7726 #: ../fish/guestfish-actions.pod:509 ../fish/guestfish-actions.pod:520
7727 #: ../fish/guestfish-actions.pod:529 ../fish/guestfish-actions.pod:539
7728 #: ../fish/guestfish-actions.pod:551 ../fish/guestfish-actions.pod:564
7729 #: ../fish/guestfish-actions.pod:572 ../fish/guestfish-actions.pod:583
7730 #: ../fish/guestfish-actions.pod:591 ../fish/guestfish-actions.pod:599
7731 #: ../src/guestfs-actions.pod:732 ../src/guestfs-actions.pod:749
7732 #: ../src/guestfs-actions.pod:764 ../src/guestfs-actions.pod:780
7733 #: ../src/guestfs-actions.pod:798 ../src/guestfs-actions.pod:817
7734 #: ../src/guestfs-actions.pod:831 ../src/guestfs-actions.pod:849
7735 #: ../src/guestfs-actions.pod:863 ../src/guestfs-actions.pod:877
7736 msgid "This uses the L<blockdev(8)> command."
7740 #: ../fish/guestfish-actions.pod:511
7741 msgid "blockdev-getbsz"
7745 #: ../fish/guestfish-actions.pod:513
7748 " blockdev-getbsz device\n"
7753 #: ../fish/guestfish-actions.pod:515 ../src/guestfs-actions.pod:744
7754 msgid "This returns the block size of a device."
7758 #: ../fish/guestfish-actions.pod:517 ../fish/guestfish-actions.pod:580
7759 #: ../src/guestfs-actions.pod:746 ../src/guestfs-actions.pod:846
7761 "(Note this is different from both I<size in blocks> and I<filesystem block "
7766 #: ../fish/guestfish-actions.pod:522
7767 msgid "blockdev-getro"
7771 #: ../fish/guestfish-actions.pod:524
7774 " blockdev-getro device\n"
7779 #: ../fish/guestfish-actions.pod:526 ../src/guestfs-actions.pod:761
7781 "Returns a boolean indicating if the block device is read-only (true if read-"
7782 "only, false if not)."
7786 #: ../fish/guestfish-actions.pod:531
7787 msgid "blockdev-getsize64"
7791 #: ../fish/guestfish-actions.pod:533
7794 " blockdev-getsize64 device\n"
7799 #: ../fish/guestfish-actions.pod:535 ../src/guestfs-actions.pod:776
7800 msgid "This returns the size of the device in bytes."
7804 #: ../fish/guestfish-actions.pod:537
7805 msgid "See also L</blockdev-getsz>."
7806 msgstr "Див. також L</blockdev-getsz>."
7809 #: ../fish/guestfish-actions.pod:541
7810 msgid "blockdev-getss"
7814 #: ../fish/guestfish-actions.pod:543
7817 " blockdev-getss device\n"
7822 #: ../fish/guestfish-actions.pod:545 ../src/guestfs-actions.pod:792
7824 "This returns the size of sectors on a block device. Usually 512, but can be "
7825 "larger for modern devices."
7829 #: ../fish/guestfish-actions.pod:548
7831 "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)."
7835 #: ../fish/guestfish-actions.pod:553
7836 msgid "blockdev-getsz"
7840 #: ../fish/guestfish-actions.pod:555
7843 " blockdev-getsz device\n"
7848 #: ../fish/guestfish-actions.pod:557 ../src/guestfs-actions.pod:810
7850 "This returns the size of the device in units of 512-byte sectors (even if "
7851 "the sectorsize isn't 512 bytes ... weird)."
7855 #: ../fish/guestfish-actions.pod:560
7857 "See also L</blockdev-getss> for the real sector size of the device, and L</"
7858 "blockdev-getsize64> for the more useful I<size in bytes>."
7862 #: ../fish/guestfish-actions.pod:566
7863 msgid "blockdev-rereadpt"
7867 #: ../fish/guestfish-actions.pod:568
7870 " blockdev-rereadpt device\n"
7875 #: ../fish/guestfish-actions.pod:570 ../src/guestfs-actions.pod:829
7876 msgid "Reread the partition table on C<device>."
7880 #: ../fish/guestfish-actions.pod:574
7881 msgid "blockdev-setbsz"
7885 #: ../fish/guestfish-actions.pod:576
7888 " blockdev-setbsz device blocksize\n"
7893 #: ../fish/guestfish-actions.pod:578 ../src/guestfs-actions.pod:844
7894 msgid "This sets the block size of a device."
7898 #: ../fish/guestfish-actions.pod:585
7899 msgid "blockdev-setro"
7903 #: ../fish/guestfish-actions.pod:587
7906 " blockdev-setro device\n"
7911 #: ../fish/guestfish-actions.pod:589 ../src/guestfs-actions.pod:861
7912 msgid "Sets the block device named C<device> to read-only."
7916 #: ../fish/guestfish-actions.pod:593
7917 msgid "blockdev-setrw"
7921 #: ../fish/guestfish-actions.pod:595
7924 " blockdev-setrw device\n"
7929 #: ../fish/guestfish-actions.pod:597 ../src/guestfs-actions.pod:875
7930 msgid "Sets the block device named C<device> to read-write."
7934 #: ../fish/guestfish-actions.pod:601
7935 msgid "btrfs-filesystem-resize"
7939 #: ../fish/guestfish-actions.pod:603
7942 " btrfs-filesystem-resize mountpoint [size:N]\n"
7947 #: ../fish/guestfish-actions.pod:605 ../src/guestfs-actions.pod:897
7948 msgid "This command resizes a btrfs filesystem."
7952 #: ../fish/guestfish-actions.pod:607 ../src/guestfs-actions.pod:899
7954 "Note that unlike other resize calls, the filesystem has to be mounted and "
7955 "the parameter is the mountpoint not the device (this is a requirement of "
7960 #: ../fish/guestfish-actions.pod:611 ../fish/guestfish-actions.pod:3164
7961 #: ../fish/guestfish-actions.pod:3703 ../fish/guestfish-actions.pod:5029
7962 #: ../src/guestfs-actions.pod:903 ../src/guestfs-actions.pod:4890
7963 #: ../src/guestfs-actions.pod:5786 ../src/guestfs-actions.pod:7762
7964 msgid "The optional parameters are:"
7968 #: ../fish/guestfish-actions.pod:615 ../fish/guestfish-actions.pod:3707
7969 #: ../src/guestfs-actions.pod:907 ../src/guestfs-actions.pod:5790
7974 #: ../fish/guestfish-actions.pod:617 ../src/guestfs-actions.pod:909
7976 "The new size (in bytes) of the filesystem. If omitted, the filesystem is "
7977 "resized to the maximum size."
7981 #: ../fish/guestfish-actions.pod:622 ../src/guestfs-actions.pod:914
7982 msgid "See also L<btrfs(8)>."
7983 msgstr "Див. також L<btrfs(8)>."
7986 #: ../fish/guestfish-actions.pod:626
7987 msgid "case-sensitive-path"
7991 #: ../fish/guestfish-actions.pod:628
7994 " case-sensitive-path path\n"
7999 #: ../fish/guestfish-actions.pod:630 ../src/guestfs-actions.pod:948
8001 "This can be used to resolve case insensitive paths on a filesystem which is "
8002 "case sensitive. The use case is to resolve paths which you have read from "
8003 "Windows configuration files or the Windows Registry, to the true path."
8007 #: ../fish/guestfish-actions.pod:635 ../src/guestfs-actions.pod:953
8009 "The command handles a peculiarity of the Linux ntfs-3g filesystem driver "
8010 "(and probably others), which is that although the underlying filesystem is "
8011 "case-insensitive, the driver exports the filesystem to Linux as case-"
8016 #: ../fish/guestfish-actions.pod:640 ../src/guestfs-actions.pod:958
8018 "One consequence of this is that special directories such as C<c:\\windows> "
8019 "may appear as C</WINDOWS> or C</windows> (or other things) depending on the "
8020 "precise details of how they were created. In Windows itself this would not "
8025 #: ../fish/guestfish-actions.pod:646 ../src/guestfs-actions.pod:964
8027 "Bug or feature? You decide: L<http://www.tuxera.com/community/ntfs-3g-faq/"
8032 #: ../fish/guestfish-actions.pod:649 ../src/guestfs-actions.pod:967
8034 "This function resolves the true case of each element in the path and returns "
8035 "the case-sensitive path."
8039 #: ../fish/guestfish-actions.pod:652
8041 "Thus L</case-sensitive-path> (\"/Windows/System32\") might return C<\"/"
8042 "WINDOWS/system32\"> (the exact return value would depend on details of how "
8043 "the directories were originally created under Windows)."
8047 #: ../fish/guestfish-actions.pod:657 ../src/guestfs-actions.pod:975
8048 msgid "I<Note>: This function does not handle drive names, backslashes etc."
8052 #: ../fish/guestfish-actions.pod:660
8053 msgid "See also L</realpath>."
8054 msgstr "Див. також L</realpath>."
8057 #: ../fish/guestfish-actions.pod:662
8062 #: ../fish/guestfish-actions.pod:664
8072 #: ../fish/guestfish-actions.pod:666 ../fish/guestfish-actions.pod:4134
8073 #: ../src/guestfs-actions.pod:991 ../src/guestfs-actions.pod:6446
8074 msgid "Return the contents of the file named C<path>."
8078 #: ../fish/guestfish-actions.pod:668
8080 "Note that this function cannot correctly handle binary files (specifically, "
8081 "files containing C<\\0> character which is treated as end of string). For "
8082 "those you need to use the L</read-file> or L</download> functions which have "
8083 "a more complex interface."
8087 #: ../fish/guestfish-actions.pod:673 ../fish/guestfish-actions.pod:808
8088 #: ../fish/guestfish-actions.pod:820 ../fish/guestfish-actions.pod:1103
8089 #: ../fish/guestfish-actions.pod:1113 ../fish/guestfish-actions.pod:1180
8090 #: ../fish/guestfish-actions.pod:1190 ../fish/guestfish-actions.pod:1382
8091 #: ../fish/guestfish-actions.pod:1695 ../fish/guestfish-actions.pod:1705
8092 #: ../fish/guestfish-actions.pod:1755 ../fish/guestfish-actions.pod:1770
8093 #: ../fish/guestfish-actions.pod:1780 ../fish/guestfish-actions.pod:1799
8094 #: ../fish/guestfish-actions.pod:4004 ../fish/guestfish-actions.pod:4019
8095 #: ../fish/guestfish-actions.pod:4095 ../fish/guestfish-actions.pod:4112
8096 #: ../fish/guestfish-actions.pod:4127 ../fish/guestfish-actions.pod:4796
8097 #: ../fish/guestfish-actions.pod:4842 ../fish/guestfish-actions.pod:4927
8098 #: ../fish/guestfish-actions.pod:4942 ../fish/guestfish-actions.pod:5427
8099 #: ../fish/guestfish-actions.pod:5439 ../fish/guestfish-actions.pod:5457
8100 #: ../fish/guestfish-actions.pod:5474 ../fish/guestfish-actions.pod:5484
8101 #: ../fish/guestfish-actions.pod:5538 ../fish/guestfish-actions.pod:5548
8102 #: ../fish/guestfish-actions.pod:5577 ../fish/guestfish-actions.pod:5587
8103 #: ../src/guestfs-actions.pod:1001 ../src/guestfs-actions.pod:1180
8104 #: ../src/guestfs-actions.pod:1200 ../src/guestfs-actions.pod:1855
8105 #: ../src/guestfs-actions.pod:1874 ../src/guestfs-actions.pod:1977
8106 #: ../src/guestfs-actions.pod:1996 ../src/guestfs-actions.pod:2242
8107 #: ../src/guestfs-actions.pod:2724 ../src/guestfs-actions.pod:2743
8108 #: ../src/guestfs-actions.pod:2808 ../src/guestfs-actions.pod:2832
8109 #: ../src/guestfs-actions.pod:2849 ../src/guestfs-actions.pod:2878
8110 #: ../src/guestfs-actions.pod:6228 ../src/guestfs-actions.pod:6254
8111 #: ../src/guestfs-actions.pod:6385 ../src/guestfs-actions.pod:6411
8112 #: ../src/guestfs-actions.pod:6435 ../src/guestfs-actions.pod:7390
8113 #: ../src/guestfs-actions.pod:7445 ../src/guestfs-actions.pod:7591
8114 #: ../src/guestfs-actions.pod:7615 ../src/guestfs-actions.pod:8400
8115 #: ../src/guestfs-actions.pod:8420 ../src/guestfs-actions.pod:8453
8116 #: ../src/guestfs-actions.pod:8472 ../src/guestfs-actions.pod:8491
8117 #: ../src/guestfs-actions.pod:8582 ../src/guestfs-actions.pod:8601
8118 #: ../src/guestfs-actions.pod:8647 ../src/guestfs-actions.pod:8666
8120 "Because of the message protocol, there is a transfer limit of somewhere "
8121 "between 2MB and 4MB. See L<guestfs(3)/PROTOCOL LIMITS>."
8125 #: ../fish/guestfish-actions.pod:676
8130 #: ../fish/guestfish-actions.pod:678
8133 " checksum csumtype path\n"
8138 #: ../fish/guestfish-actions.pod:680 ../src/guestfs-actions.pod:1013
8140 "This call computes the MD5, SHAx or CRC checksum of the file named C<path>."
8144 #: ../fish/guestfish-actions.pod:683 ../src/guestfs-actions.pod:1016
8146 "The type of checksum to compute is given by the C<csumtype> parameter which "
8147 "must have one of the following values:"
8151 #: ../fish/guestfish-actions.pod:688 ../src/guestfs-actions.pod:1021
8156 #: ../fish/guestfish-actions.pod:690 ../src/guestfs-actions.pod:1023
8158 "Compute the cyclic redundancy check (CRC) specified by POSIX for the "
8163 #: ../fish/guestfish-actions.pod:693 ../src/guestfs-actions.pod:1026
8168 #: ../fish/guestfish-actions.pod:695 ../src/guestfs-actions.pod:1028
8169 msgid "Compute the MD5 hash (using the C<md5sum> program)."
8173 #: ../fish/guestfish-actions.pod:697 ../src/guestfs-actions.pod:1030
8178 #: ../fish/guestfish-actions.pod:699 ../src/guestfs-actions.pod:1032
8179 msgid "Compute the SHA1 hash (using the C<sha1sum> program)."
8183 #: ../fish/guestfish-actions.pod:701 ../src/guestfs-actions.pod:1034
8188 #: ../fish/guestfish-actions.pod:703 ../src/guestfs-actions.pod:1036
8189 msgid "Compute the SHA224 hash (using the C<sha224sum> program)."
8193 #: ../fish/guestfish-actions.pod:705 ../src/guestfs-actions.pod:1038
8198 #: ../fish/guestfish-actions.pod:707 ../src/guestfs-actions.pod:1040
8199 msgid "Compute the SHA256 hash (using the C<sha256sum> program)."
8203 #: ../fish/guestfish-actions.pod:709 ../src/guestfs-actions.pod:1042
8208 #: ../fish/guestfish-actions.pod:711 ../src/guestfs-actions.pod:1044
8209 msgid "Compute the SHA384 hash (using the C<sha384sum> program)."
8213 #: ../fish/guestfish-actions.pod:713 ../src/guestfs-actions.pod:1046
8218 #: ../fish/guestfish-actions.pod:715 ../src/guestfs-actions.pod:1048
8219 msgid "Compute the SHA512 hash (using the C<sha512sum> program)."
8223 #: ../fish/guestfish-actions.pod:719 ../src/guestfs-actions.pod:1052
8224 msgid "The checksum is returned as a printable string."
8228 #: ../fish/guestfish-actions.pod:721
8229 msgid "To get the checksum for a device, use L</checksum-device>."
8233 #: ../fish/guestfish-actions.pod:723
8234 msgid "To get the checksums for many files, use L</checksums-out>."
8238 #: ../fish/guestfish-actions.pod:725
8239 msgid "checksum-device"
8240 msgstr "checksum-device"
8243 #: ../fish/guestfish-actions.pod:727
8246 " checksum-device csumtype device\n"
8251 #: ../fish/guestfish-actions.pod:729
8253 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
8254 "device named C<device>. For the types of checksums supported see the L</"
8255 "checksum> command."
8259 #: ../fish/guestfish-actions.pod:733
8260 msgid "checksums-out"
8264 #: ../fish/guestfish-actions.pod:735
8267 " checksums-out csumtype directory (sumsfile|-)\n"
8272 #: ../fish/guestfish-actions.pod:737 ../src/guestfs-actions.pod:1087
8274 "This command computes the checksums of all regular files in C<directory> and "
8275 "then emits a list of those checksums to the local output file C<sumsfile>."
8279 #: ../fish/guestfish-actions.pod:741 ../src/guestfs-actions.pod:1091
8281 "This can be used for verifying the integrity of a virtual machine. However "
8282 "to be properly secure you should pay attention to the output of the checksum "
8283 "command (it uses the ones from GNU coreutils). In particular when the "
8284 "filename is not printable, coreutils uses a special backslash syntax. For "
8285 "more information, see the GNU coreutils info file."
8289 #: ../fish/guestfish-actions.pod:751
8294 #: ../fish/guestfish-actions.pod:753
8297 " chmod mode path\n"
8302 #: ../fish/guestfish-actions.pod:755 ../src/guestfs-actions.pod:1110
8304 "Change the mode (permissions) of C<path> to C<mode>. Only numeric modes are "
8309 #: ../fish/guestfish-actions.pod:758 ../src/guestfs-actions.pod:1113
8311 "I<Note>: When using this command from guestfish, C<mode> by default would be "
8312 "decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not "
8317 #: ../fish/guestfish-actions.pod:762 ../fish/guestfish-actions.pod:3356
8318 #: ../fish/guestfish-actions.pod:3495 ../fish/guestfish-actions.pod:3505
8319 #: ../fish/guestfish-actions.pod:3515 ../src/guestfs-actions.pod:1117
8320 #: ../src/guestfs-actions.pod:5193 ../src/guestfs-actions.pod:5402
8321 #: ../src/guestfs-actions.pod:5421 ../src/guestfs-actions.pod:5440
8322 msgid "The mode actually set is affected by the umask."
8326 #: ../fish/guestfish-actions.pod:764
8331 #: ../fish/guestfish-actions.pod:766
8334 " chown owner group path\n"
8339 #: ../fish/guestfish-actions.pod:768 ../src/guestfs-actions.pod:1131
8340 msgid "Change the file owner to C<owner> and group to C<group>."
8344 #: ../fish/guestfish-actions.pod:770 ../fish/guestfish-actions.pod:2703
8345 #: ../src/guestfs-actions.pod:1133 ../src/guestfs-actions.pod:4124
8347 "Only numeric uid and gid are supported. If you want to use names, you will "
8348 "need to locate and parse the password file yourself (Augeas support makes "
8349 "this relatively easy)."
8353 #: ../fish/guestfish-actions.pod:774
8358 #: ../fish/guestfish-actions.pod:776
8361 " command 'arguments ...'\n"
8364 " command 'параметри...'\n"
8368 #: ../fish/guestfish-actions.pod:778 ../src/guestfs-actions.pod:1147
8370 "This call runs a command from the guest filesystem. The filesystem must be "
8371 "mounted, and must contain a compatible operating system (ie. something "
8372 "Linux, with the same or compatible processor architecture)."
8376 #: ../fish/guestfish-actions.pod:783
8378 "The single parameter is an argv-style list of arguments. The first element "
8379 "is the name of the program to run. Subsequent elements are parameters. The "
8380 "list must be non-empty (ie. must contain a program name). Note that the "
8381 "command runs directly, and is I<not> invoked via the shell (see L</sh>)."
8385 #: ../fish/guestfish-actions.pod:790 ../src/guestfs-actions.pod:1159
8386 msgid "The return value is anything printed to I<stdout> by the command."
8390 #: ../fish/guestfish-actions.pod:793 ../src/guestfs-actions.pod:1162
8392 "If the command returns a non-zero exit status, then this function returns an "
8393 "error message. The error message string is the content of I<stderr> from "
8398 #: ../fish/guestfish-actions.pod:797 ../src/guestfs-actions.pod:1166
8400 "The C<$PATH> environment variable will contain at least C</usr/bin> and C</"
8401 "bin>. If you require a program from another location, you should provide "
8402 "the full path in the first parameter."
8406 #: ../fish/guestfish-actions.pod:802 ../src/guestfs-actions.pod:1171
8408 "Shared libraries and data files required by the program must be available on "
8409 "filesystems which are mounted in the correct places. It is the caller's "
8410 "responsibility to ensure all filesystems that are needed are mounted at the "
8415 #: ../fish/guestfish-actions.pod:811
8416 msgid "command-lines"
8420 #: ../fish/guestfish-actions.pod:813
8423 " command-lines 'arguments ...'\n"
8428 #: ../fish/guestfish-actions.pod:815
8430 "This is the same as L</command>, but splits the result into a list of lines."
8434 #: ../fish/guestfish-actions.pod:818
8435 msgid "See also: L</sh-lines>"
8436 msgstr "Див. також L</sh-lines>"
8439 #: ../fish/guestfish-actions.pod:823
8440 msgid "compress-device-out"
8444 #: ../fish/guestfish-actions.pod:825
8447 " compress-device-out ctype device (zdevice|-) [level:N]\n"
8452 #: ../fish/guestfish-actions.pod:827 ../src/guestfs-actions.pod:1221
8454 "This command compresses C<device> and writes it out to the local file "
8459 #: ../fish/guestfish-actions.pod:830
8461 "The C<ctype> and optional C<level> parameters have the same meaning as in L</"
8466 #: ../fish/guestfish-actions.pod:837
8467 msgid "compress-out"
8471 #: ../fish/guestfish-actions.pod:839
8474 " compress-out ctype file (zfile|-) [level:N]\n"
8479 #: ../fish/guestfish-actions.pod:841 ../src/guestfs-actions.pod:1273
8481 "This command compresses C<file> and writes it out to the local file C<zfile>."
8485 #: ../fish/guestfish-actions.pod:844 ../src/guestfs-actions.pod:1276
8487 "The compression program used is controlled by the C<ctype> parameter. "
8488 "Currently this includes: C<compress>, C<gzip>, C<bzip2>, C<xz> or C<lzop>. "
8489 "Some compression types may not be supported by particular builds of "
8490 "libguestfs, in which case you will get an error containing the substring "
8491 "\"not supported\"."
8495 #: ../fish/guestfish-actions.pod:850 ../src/guestfs-actions.pod:1282
8497 "The optional C<level> parameter controls compression level. The meaning and "
8498 "default for this parameter depends on the compression program being used."
8502 #: ../fish/guestfish-actions.pod:858
8507 #: ../fish/guestfish-actions.pod:860
8510 " config qemuparam qemuvalue\n"
8515 #: ../fish/guestfish-actions.pod:862 ../src/guestfs-actions.pod:1323
8517 "This can be used to add arbitrary qemu command line parameters of the form "
8518 "I<-param value>. Actually it's not quite arbitrary - we prevent you from "
8519 "setting some parameters which would interfere with parameters that we use."
8523 #: ../fish/guestfish-actions.pod:867 ../src/guestfs-actions.pod:1328
8524 msgid "The first character of C<param> string must be a C<-> (dash)."
8528 #: ../fish/guestfish-actions.pod:869 ../src/guestfs-actions.pod:1330
8529 msgid "C<value> can be NULL."
8533 #: ../fish/guestfish-actions.pod:871
8534 msgid "copy-device-to-device"
8538 #: ../fish/guestfish-actions.pod:873
8541 " copy-device-to-device src dest [srcoffset:N] [destoffset:N] [size:N]\n"
8546 #: ../fish/guestfish-actions.pod:875
8548 "The four calls L</copy-device-to-device>, L</copy-device-to-file>, L</copy-"
8549 "file-to-device>, and L</copy-file-to-file> let you copy from a source "
8550 "(device|file) to a destination (device|file)."
8554 #: ../fish/guestfish-actions.pod:882 ../src/guestfs-actions.pod:1360
8556 "Partial copies can be made since you can specify optionally the source "
8557 "offset, destination offset and size to copy. These values are all specified "
8558 "in bytes. If not given, the offsets both default to zero, and the size "
8559 "defaults to copying as much as possible until we hit the end of the source."
8563 #: ../fish/guestfish-actions.pod:888 ../src/guestfs-actions.pod:1366
8565 "The source and destination may be the same object. However overlapping "
8566 "regions may not be copied correctly."
8570 #: ../fish/guestfish-actions.pod:891 ../src/guestfs-actions.pod:1369
8572 "If the destination is a file, it is created if required. If the destination "
8573 "file is not large enough, it is extended."
8577 #: ../fish/guestfish-actions.pod:896
8578 msgid "copy-device-to-file"
8582 #: ../fish/guestfish-actions.pod:898
8585 " copy-device-to-file src dest [srcoffset:N] [destoffset:N] [size:N]\n"
8590 #: ../fish/guestfish-actions.pod:900 ../fish/guestfish-actions.pod:909
8591 #: ../fish/guestfish-actions.pod:918
8592 msgid "See L</copy-device-to-device> for a general overview of this call."
8596 #: ../fish/guestfish-actions.pod:905
8597 msgid "copy-file-to-device"
8601 #: ../fish/guestfish-actions.pod:907
8604 " copy-file-to-device src dest [srcoffset:N] [destoffset:N] [size:N]\n"
8609 #: ../fish/guestfish-actions.pod:914
8610 msgid "copy-file-to-file"
8614 #: ../fish/guestfish-actions.pod:916
8617 " copy-file-to-file src dest [srcoffset:N] [destoffset:N] [size:N]\n"
8622 #: ../fish/guestfish-actions.pod:921
8624 "This is B<not> the function you want for copying files. This is for copying "
8625 "blocks within existing files. See L</cp>, L</cp-a> and L</mv> for general "
8626 "file copying and moving functions."
8630 #: ../fish/guestfish-actions.pod:928
8635 #: ../fish/guestfish-actions.pod:930
8638 " copy-size src dest size\n"
8643 #: ../fish/guestfish-actions.pod:932 ../src/guestfs-actions.pod:1584
8645 "This command copies exactly C<size> bytes from one source device or file "
8646 "C<src> to another destination device or file C<dest>."
8650 #: ../fish/guestfish-actions.pod:935 ../src/guestfs-actions.pod:1587
8652 "Note this will fail if the source is too short or if the destination is not "
8657 #: ../fish/guestfish-actions.pod:938 ../fish/guestfish-actions.pod:973
8659 "I<This function is deprecated.> In new code, use the L</"
8660 "copy_device_to_device> call instead."
8664 #: ../fish/guestfish-actions.pod:945
8669 #: ../fish/guestfish-actions.pod:947
8677 #: ../fish/guestfish-actions.pod:949 ../src/guestfs-actions.pod:1606
8679 "This copies a file from C<src> to C<dest> where C<dest> is either a "
8680 "destination filename or destination directory."
8684 #: ../fish/guestfish-actions.pod:952
8689 #: ../fish/guestfish-actions.pod:954
8697 #: ../fish/guestfish-actions.pod:956 ../src/guestfs-actions.pod:1620
8699 "This copies a file or directory from C<src> to C<dest> recursively using the "
8704 #: ../fish/guestfish-actions.pod:959
8709 #: ../fish/guestfish-actions.pod:961
8717 #: ../fish/guestfish-actions.pod:963 ../src/guestfs-actions.pod:1641
8719 "This command copies from one source device or file C<src> to another "
8720 "destination device or file C<dest>. Normally you would use this to copy to "
8721 "or from a device or partition, for example to duplicate a filesystem."
8725 #: ../fish/guestfish-actions.pod:968
8727 "If the destination is a device, it must be as large or larger than the "
8728 "source file or device, otherwise the copy will fail. This command cannot do "
8729 "partial copies (see L</copy-device-to-device>)."
8733 #: ../fish/guestfish-actions.pod:980
8738 #: ../fish/guestfish-actions.pod:982
8748 #: ../fish/guestfish-actions.pod:984 ../src/guestfs-actions.pod:1660
8749 msgid "This command runs the C<df> command to report disk space used."
8753 #: ../fish/guestfish-actions.pod:986 ../fish/guestfish-actions.pod:997
8755 "This command is mostly useful for interactive sessions. It is I<not> "
8756 "intended that you try to parse the output string. Use L</statvfs> from "
8761 #: ../fish/guestfish-actions.pod:990
8766 #: ../fish/guestfish-actions.pod:992
8776 #: ../fish/guestfish-actions.pod:994 ../src/guestfs-actions.pod:1676
8778 "This command runs the C<df -h> command to report disk space used in human-"
8783 #: ../fish/guestfish-actions.pod:1001
8788 #: ../fish/guestfish-actions.pod:1003
8798 #: ../fish/guestfish-actions.pod:1005 ../src/guestfs-actions.pod:1693
8800 "This returns the kernel messages (C<dmesg> output) from the guest kernel. "
8801 "This is sometimes useful for extended debugging of problems."
8805 #: ../fish/guestfish-actions.pod:1009
8807 "Another way to get the same information is to enable verbose messages with "
8808 "L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> "
8809 "before running the program."
8813 #: ../fish/guestfish-actions.pod:1014
8818 #: ../fish/guestfish-actions.pod:1016
8821 " download remotefilename (filename|-)\n"
8826 #: ../fish/guestfish-actions.pod:1018 ../fish/guestfish-actions.pod:1031
8827 #: ../src/guestfs-actions.pod:1714 ../src/guestfs-actions.pod:1739
8829 "Download file C<remotefilename> and save it as C<filename> on the local "
8834 #: ../fish/guestfish-actions.pod:1021 ../fish/guestfish-actions.pod:5179
8835 #: ../src/guestfs-actions.pod:1717 ../src/guestfs-actions.pod:7970
8836 msgid "C<filename> can also be a named pipe."
8840 #: ../fish/guestfish-actions.pod:1023
8841 msgid "See also L</upload>, L</cat>."
8845 #: ../fish/guestfish-actions.pod:1027
8846 msgid "download-offset"
8847 msgstr "download-offset"
8850 #: ../fish/guestfish-actions.pod:1029
8853 " download-offset remotefilename (filename|-) offset size\n"
8858 #: ../fish/guestfish-actions.pod:1034 ../src/guestfs-actions.pod:1742
8860 "C<remotefilename> is read for C<size> bytes starting at C<offset> (this "
8861 "region must be within the file or device)."
8865 #: ../fish/guestfish-actions.pod:1037
8867 "Note that there is no limit on the amount of data that can be downloaded "
8868 "with this call, unlike with L</pread>, and this call always reads the full "
8869 "amount unless an error occurs."
8873 #: ../fish/guestfish-actions.pod:1042
8874 msgid "See also L</download>, L</pread>."
8878 #: ../fish/guestfish-actions.pod:1046
8883 #: ../fish/guestfish-actions.pod:1048
8886 " drop-caches whattodrop\n"
8891 #: ../fish/guestfish-actions.pod:1050 ../src/guestfs-actions.pod:1767
8893 "This instructs the guest kernel to drop its page cache, and/or dentries and "
8894 "inode caches. The parameter C<whattodrop> tells the kernel what precisely "
8895 "to drop, see L<http://linux-mm.org/Drop_Caches>"
8899 #: ../fish/guestfish-actions.pod:1055 ../src/guestfs-actions.pod:1772
8900 msgid "Setting C<whattodrop> to 3 should drop everything."
8904 #: ../fish/guestfish-actions.pod:1057 ../src/guestfs-actions.pod:1774
8906 "This automatically calls L<sync(2)> before the operation, so that the "
8907 "maximum guest memory is freed."
8911 #: ../fish/guestfish-actions.pod:1060
8916 #: ../fish/guestfish-actions.pod:1062
8926 #: ../fish/guestfish-actions.pod:1064 ../src/guestfs-actions.pod:1787
8928 "This command runs the C<du -s> command to estimate file space usage for "
8933 #: ../fish/guestfish-actions.pod:1067 ../src/guestfs-actions.pod:1790
8935 "C<path> can be a file or a directory. If C<path> is a directory then the "
8936 "estimate includes the contents of the directory and all subdirectories "
8941 #: ../fish/guestfish-actions.pod:1071 ../src/guestfs-actions.pod:1794
8943 "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)."
8947 #: ../fish/guestfish-actions.pod:1074
8952 #: ../fish/guestfish-actions.pod:1076
8955 " e2fsck-f device\n"
8960 #: ../fish/guestfish-actions.pod:1078 ../src/guestfs-actions.pod:1812
8962 "This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker "
8963 "on C<device>, noninteractively (I<-p>), even if the filesystem appears to be "
8968 #: ../fish/guestfish-actions.pod:1082
8970 "This command is only needed because of L</resize2fs> (q.v.). Normally you "
8971 "should use L</fsck>."
8975 #: ../fish/guestfish-actions.pod:1085
8980 #: ../fish/guestfish-actions.pod:1087
8983 " echo-daemon 'words ...'\n"
8988 #: ../fish/guestfish-actions.pod:1089 ../src/guestfs-actions.pod:1829
8990 "This command concatenates the list of C<words> passed with single spaces "
8991 "between them and returns the resulting string."
8995 #: ../fish/guestfish-actions.pod:1092 ../src/guestfs-actions.pod:1832
8996 msgid "You can use this command to test the connection through to the daemon."
9000 #: ../fish/guestfish-actions.pod:1094
9001 msgid "See also L</ping-daemon>."
9002 msgstr "Див. також L</ping-daemon>."
9005 #: ../fish/guestfish-actions.pod:1096
9010 #: ../fish/guestfish-actions.pod:1098
9013 " egrep regex path\n"
9018 #: ../fish/guestfish-actions.pod:1100 ../src/guestfs-actions.pod:1848
9020 "This calls the external C<egrep> program and returns the matching lines."
9024 #: ../fish/guestfish-actions.pod:1106
9029 #: ../fish/guestfish-actions.pod:1108
9032 " egrepi regex path\n"
9037 #: ../fish/guestfish-actions.pod:1110 ../src/guestfs-actions.pod:1867
9039 "This calls the external C<egrep -i> program and returns the matching lines."
9043 #: ../fish/guestfish-actions.pod:1116
9048 #: ../fish/guestfish-actions.pod:1118
9051 " equal file1 file2\n"
9054 " equal файл1 файл2\n"
9058 #: ../fish/guestfish-actions.pod:1120 ../src/guestfs-actions.pod:1886
9060 "This compares the two files C<file1> and C<file2> and returns true if their "
9061 "content is exactly equal, or false otherwise."
9065 #: ../fish/guestfish-actions.pod:1123 ../src/guestfs-actions.pod:1889
9066 msgid "The external L<cmp(1)> program is used for the comparison."
9070 #: ../fish/guestfish-actions.pod:1125
9075 #: ../fish/guestfish-actions.pod:1127
9085 #: ../fish/guestfish-actions.pod:1129 ../src/guestfs-actions.pod:1901
9087 "This returns C<true> if and only if there is a file, directory (or anything) "
9088 "with the given C<path> name."
9092 #: ../fish/guestfish-actions.pod:1132
9093 msgid "See also L</is-file>, L</is-dir>, L</stat>."
9094 msgstr "Див. також L</is-file>, L</is-dir>, L</stat>."
9097 #: ../fish/guestfish-actions.pod:1134
9102 #: ../fish/guestfish-actions.pod:1136
9105 " fallocate path len\n"
9108 " fallocate шлях довжина\n"
9112 #: ../fish/guestfish-actions.pod:1138 ../fish/guestfish-actions.pod:1157
9113 #: ../src/guestfs-actions.pod:1924 ../src/guestfs-actions.pod:1943
9115 "This command preallocates a file (containing zero bytes) named C<path> of "
9116 "size C<len> bytes. If the file exists already, it is overwritten."
9120 #: ../fish/guestfish-actions.pod:1142 ../src/guestfs-actions.pod:1928
9122 "Do not confuse this with the guestfish-specific C<alloc> command which "
9123 "allocates a file in the host and attaches it as a device."
9127 #: ../fish/guestfish-actions.pod:1146
9129 "I<This function is deprecated.> In new code, use the L</fallocate64> call "
9134 #: ../fish/guestfish-actions.pod:1153
9136 msgstr "fallocate64"
9139 #: ../fish/guestfish-actions.pod:1155
9142 " fallocate64 path len\n"
9145 " fallocate64 шлях довжина\n"
9149 #: ../fish/guestfish-actions.pod:1161
9151 "Note that this call allocates disk blocks for the file. To create a sparse "
9152 "file use L</truncate-size> instead."
9156 #: ../fish/guestfish-actions.pod:1164
9158 "The deprecated call L</fallocate> does the same, but owing to an oversight "
9159 "it only allowed 30 bit lengths to be specified, effectively limiting the "
9160 "maximum size of files created through that call to 1GB."
9164 #: ../fish/guestfish-actions.pod:1169 ../src/guestfs-actions.pod:1955
9166 "Do not confuse this with the guestfish-specific C<alloc> and C<sparse> "
9167 "commands which create a file in the host and attach it as a device."
9171 #: ../fish/guestfish-actions.pod:1173
9176 #: ../fish/guestfish-actions.pod:1175
9179 " fgrep pattern path\n"
9182 " fgrep шаблон шлях\n"
9186 #: ../fish/guestfish-actions.pod:1177 ../src/guestfs-actions.pod:1970
9188 "This calls the external C<fgrep> program and returns the matching lines."
9192 #: ../fish/guestfish-actions.pod:1183
9197 #: ../fish/guestfish-actions.pod:1185
9200 " fgrepi pattern path\n"
9203 " fgrepi шаблон шлях\n"
9207 #: ../fish/guestfish-actions.pod:1187 ../src/guestfs-actions.pod:1989
9209 "This calls the external C<fgrep -i> program and returns the matching lines."
9213 #: ../fish/guestfish-actions.pod:1193
9218 #: ../fish/guestfish-actions.pod:1195
9228 #: ../fish/guestfish-actions.pod:1197 ../src/guestfs-actions.pod:2007
9230 "This call uses the standard L<file(1)> command to determine the type or "
9231 "contents of the file."
9235 #: ../fish/guestfish-actions.pod:1200 ../src/guestfs-actions.pod:2010
9237 "This call will also transparently look inside various types of compressed "
9242 #: ../fish/guestfish-actions.pod:1203 ../src/guestfs-actions.pod:2013
9244 "The exact command which runs is C<file -zb path>. Note in particular that "
9245 "the filename is not prepended to the output (the I<-b> option)."
9249 #: ../fish/guestfish-actions.pod:1207 ../src/guestfs-actions.pod:2017
9251 "The output depends on the output of the underlying L<file(1)> command and it "
9252 "can change in future in ways beyond our control. In other words, the output "
9253 "is not guaranteed by the ABI."
9257 #: ../fish/guestfish-actions.pod:1211
9259 "See also: L<file(1)>, L</vfs-type>, L</lstat>, L</is-file>, L</is-blockdev> "
9260 "(etc), L</is-zero>."
9264 #: ../fish/guestfish-actions.pod:1214
9265 msgid "file-architecture"
9266 msgstr "file-architecture"
9269 #: ../fish/guestfish-actions.pod:1216
9272 " file-architecture filename\n"
9275 " file-architecture назва_файла\n"
9279 #: ../fish/guestfish-actions.pod:1218 ../src/guestfs-actions.pod:2035
9281 "This detects the architecture of the binary C<filename>, and returns it if "
9286 #: ../fish/guestfish-actions.pod:1221 ../src/guestfs-actions.pod:2038
9287 msgid "Currently defined architectures are:"
9291 #: ../fish/guestfish-actions.pod:1225 ../src/guestfs-actions.pod:2042
9296 #: ../fish/guestfish-actions.pod:1227 ../src/guestfs-actions.pod:2044
9298 "This string is returned for all 32 bit i386, i486, i586, i686 binaries "
9299 "irrespective of the precise processor requirements of the binary."
9303 #: ../fish/guestfish-actions.pod:1230 ../src/guestfs-actions.pod:2047
9308 #: ../fish/guestfish-actions.pod:1232 ../src/guestfs-actions.pod:2049
9309 msgid "64 bit x86-64."
9313 #: ../fish/guestfish-actions.pod:1234 ../src/guestfs-actions.pod:2051
9318 #: ../fish/guestfish-actions.pod:1236 ../src/guestfs-actions.pod:2053
9319 msgid "32 bit SPARC."
9323 #: ../fish/guestfish-actions.pod:1238 ../src/guestfs-actions.pod:2055
9328 #: ../fish/guestfish-actions.pod:1240 ../src/guestfs-actions.pod:2057
9329 msgid "64 bit SPARC V9 and above."
9333 #: ../fish/guestfish-actions.pod:1242 ../src/guestfs-actions.pod:2059
9338 #: ../fish/guestfish-actions.pod:1244 ../src/guestfs-actions.pod:2061
9339 msgid "Intel Itanium."
9340 msgstr "Intel Itanium."
9343 #: ../fish/guestfish-actions.pod:1246 ../src/guestfs-actions.pod:2063
9348 #: ../fish/guestfish-actions.pod:1248 ../src/guestfs-actions.pod:2065
9349 msgid "32 bit Power PC."
9353 #: ../fish/guestfish-actions.pod:1250 ../src/guestfs-actions.pod:2067
9358 #: ../fish/guestfish-actions.pod:1252 ../src/guestfs-actions.pod:2069
9359 msgid "64 bit Power PC."
9363 #: ../fish/guestfish-actions.pod:1256 ../src/guestfs-actions.pod:2073
9364 msgid "Libguestfs may return other architecture strings in future."
9368 #: ../fish/guestfish-actions.pod:1258 ../src/guestfs-actions.pod:2075
9369 msgid "The function works on at least the following types of files:"
9373 #: ../fish/guestfish-actions.pod:1264 ../src/guestfs-actions.pod:2081
9374 msgid "many types of Un*x and Linux binary"
9378 #: ../fish/guestfish-actions.pod:1268 ../src/guestfs-actions.pod:2085
9379 msgid "many types of Un*x and Linux shared library"
9383 #: ../fish/guestfish-actions.pod:1272 ../src/guestfs-actions.pod:2089
9384 msgid "Windows Win32 and Win64 binaries"
9388 #: ../fish/guestfish-actions.pod:1276 ../src/guestfs-actions.pod:2093
9389 msgid "Windows Win32 and Win64 DLLs"
9393 #: ../fish/guestfish-actions.pod:1278 ../src/guestfs-actions.pod:2095
9394 msgid "Win32 binaries and DLLs return C<i386>."
9398 #: ../fish/guestfish-actions.pod:1280 ../src/guestfs-actions.pod:2097
9399 msgid "Win64 binaries and DLLs return C<x86_64>."
9403 #: ../fish/guestfish-actions.pod:1284 ../src/guestfs-actions.pod:2101
9404 msgid "Linux kernel modules"
9408 #: ../fish/guestfish-actions.pod:1288 ../src/guestfs-actions.pod:2105
9409 msgid "Linux new-style initrd images"
9413 #: ../fish/guestfish-actions.pod:1292 ../src/guestfs-actions.pod:2109
9414 msgid "some non-x86 Linux vmlinuz kernels"
9418 #: ../fish/guestfish-actions.pod:1296 ../src/guestfs-actions.pod:2113
9419 msgid "What it can't do currently:"
9423 #: ../fish/guestfish-actions.pod:1302 ../src/guestfs-actions.pod:2119
9424 msgid "static libraries (libfoo.a)"
9428 #: ../fish/guestfish-actions.pod:1306 ../src/guestfs-actions.pod:2123
9429 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)"
9433 #: ../fish/guestfish-actions.pod:1310 ../src/guestfs-actions.pod:2127
9434 msgid "x86 Linux vmlinuz kernels"
9438 #: ../fish/guestfish-actions.pod:1312 ../src/guestfs-actions.pod:2129
9440 "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and "
9441 "compressed code, and are horribly hard to unpack. If you want to find the "
9442 "architecture of a kernel, use the architecture of the associated initrd or "
9443 "kernel module(s) instead."
9447 #: ../fish/guestfish-actions.pod:1319
9452 #: ../fish/guestfish-actions.pod:1321
9462 #: ../fish/guestfish-actions.pod:1323 ../src/guestfs-actions.pod:2147
9463 msgid "This command returns the size of C<file> in bytes."
9467 #: ../fish/guestfish-actions.pod:1325
9469 "To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, L</is-"
9470 "file> etc. To get the size of block devices, use L</blockdev-getsize64>."
9474 #: ../fish/guestfish-actions.pod:1329
9479 #: ../fish/guestfish-actions.pod:1331
9482 " fill c len path\n"
9487 #: ../fish/guestfish-actions.pod:1333 ../src/guestfs-actions.pod:2165
9489 "This command creates a new file called C<path>. The initial content of the "
9490 "file is C<len> octets of C<c>, where C<c> must be a number in the range C<"
9495 #: ../fish/guestfish-actions.pod:1337
9497 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
9498 "L</truncate-size>. To create a file with a pattern of repeating bytes use "
9503 #: ../fish/guestfish-actions.pod:1342
9504 msgid "fill-pattern"
9505 msgstr "fill-pattern"
9508 #: ../fish/guestfish-actions.pod:1344
9511 " fill-pattern pattern len path\n"
9516 #: ../fish/guestfish-actions.pod:1346
9518 "This function is like L</fill> except that it creates a new file of length "
9519 "C<len> containing the repeating pattern of bytes in C<pattern>. The pattern "
9520 "is truncated if necessary to ensure the length of the file is exactly C<len> "
9525 #: ../fish/guestfish-actions.pod:1351
9530 #: ../fish/guestfish-actions.pod:1353
9540 #: ../fish/guestfish-actions.pod:1355 ../src/guestfs-actions.pod:2211
9542 "This command lists out all files and directories, recursively, starting at "
9543 "C<directory>. It is essentially equivalent to running the shell command "
9544 "C<find directory -print> but some post-processing happens on the output, "
9549 #: ../fish/guestfish-actions.pod:1360 ../src/guestfs-actions.pod:2216
9551 "This returns a list of strings I<without any prefix>. Thus if the directory "
9556 #: ../fish/guestfish-actions.pod:1363 ../src/guestfs-actions.pod:2219
9566 #: ../fish/guestfish-actions.pod:1367
9567 msgid "then the returned list from L</find> C</tmp> would be 4 elements:"
9571 #: ../fish/guestfish-actions.pod:1370 ../src/guestfs-actions.pod:2226
9582 #: ../fish/guestfish-actions.pod:1375 ../src/guestfs-actions.pod:2231
9583 msgid "If C<directory> is not a directory, then this command returns an error."
9587 #: ../fish/guestfish-actions.pod:1378 ../src/guestfs-actions.pod:2234
9588 msgid "The returned list is sorted."
9592 #: ../fish/guestfish-actions.pod:1380
9593 msgid "See also L</find0>."
9594 msgstr "Див. також L</find0>."
9597 #: ../fish/guestfish-actions.pod:1385
9602 #: ../fish/guestfish-actions.pod:1387
9605 " find0 directory (files|-)\n"
9608 " find0 каталог (файли|-)\n"
9612 #: ../fish/guestfish-actions.pod:1389 ../src/guestfs-actions.pod:2254
9614 "This command lists out all files and directories, recursively, starting at "
9615 "C<directory>, placing the resulting list in the external file called "
9620 #: ../fish/guestfish-actions.pod:1393
9622 "This command works the same way as L</find> with the following exceptions:"
9626 #: ../fish/guestfish-actions.pod:1400 ../src/guestfs-actions.pod:2265
9627 msgid "The resulting list is written to an external file."
9631 #: ../fish/guestfish-actions.pod:1404 ../src/guestfs-actions.pod:2269
9633 "Items (filenames) in the result are separated by C<\\0> characters. See "
9634 "L<find(1)> option I<-print0>."
9638 #: ../fish/guestfish-actions.pod:1409 ../src/guestfs-actions.pod:2274
9639 msgid "This command is not limited in the number of names that it can return."
9643 #: ../fish/guestfish-actions.pod:1414 ../src/guestfs-actions.pod:2279
9644 msgid "The result list is not sorted."
9648 #: ../fish/guestfish-actions.pod:1420
9649 msgid "findfs-label"
9650 msgstr "findfs-label"
9653 #: ../fish/guestfish-actions.pod:1422
9656 " findfs-label label\n"
9659 " findfs-label мітка\n"
9663 #: ../fish/guestfish-actions.pod:1424 ../src/guestfs-actions.pod:2293
9665 "This command searches the filesystems and returns the one which has the "
9666 "given label. An error is returned if no such filesystem can be found."
9670 #: ../fish/guestfish-actions.pod:1428
9671 msgid "To find the label of a filesystem, use L</vfs-label>."
9672 msgstr "Для визначення мітки файлової системи скористайтеся L</vfs-label>."
9675 #: ../fish/guestfish-actions.pod:1430
9677 msgstr "findfs-uuid"
9680 #: ../fish/guestfish-actions.pod:1432
9683 " findfs-uuid uuid\n"
9686 " findfs-uuid uuid\n"
9690 #: ../fish/guestfish-actions.pod:1434 ../src/guestfs-actions.pod:2310
9692 "This command searches the filesystems and returns the one which has the "
9693 "given UUID. An error is returned if no such filesystem can be found."
9697 #: ../fish/guestfish-actions.pod:1438
9698 msgid "To find the UUID of a filesystem, use L</vfs-uuid>."
9699 msgstr "Для визначення UUID файлової системи скористайтеся L</vfs-uuid>."
9702 #: ../fish/guestfish-actions.pod:1440
9707 #: ../fish/guestfish-actions.pod:1442
9710 " fsck fstype device\n"
9713 " fsck тип_файлової_системи пристрій\n"
9717 #: ../fish/guestfish-actions.pod:1444 ../src/guestfs-actions.pod:2328
9719 "This runs the filesystem checker (fsck) on C<device> which should have "
9720 "filesystem type C<fstype>."
9724 #: ../fish/guestfish-actions.pod:1447 ../src/guestfs-actions.pod:2331
9726 "The returned integer is the status. See L<fsck(8)> for the list of status "
9727 "codes from C<fsck>."
9731 #: ../fish/guestfish-actions.pod:1456 ../src/guestfs-actions.pod:2340
9732 msgid "Multiple status codes can be summed together."
9736 #: ../fish/guestfish-actions.pod:1460 ../src/guestfs-actions.pod:2344
9738 "A non-zero return code can mean \"success\", for example if errors have been "
9739 "corrected on the filesystem."
9743 #: ../fish/guestfish-actions.pod:1465 ../src/guestfs-actions.pod:2349
9744 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)."
9748 #: ../fish/guestfish-actions.pod:1470 ../src/guestfs-actions.pod:2354
9750 "This command is entirely equivalent to running C<fsck -a -t fstype device>."
9754 #: ../fish/guestfish-actions.pod:1472
9759 #: ../fish/guestfish-actions.pod:1474
9769 #: ../fish/guestfish-actions.pod:1476 ../src/guestfs-actions.pod:2365
9771 "Return the additional kernel options which are added to the guest kernel "
9776 #: ../fish/guestfish-actions.pod:1479 ../src/guestfs-actions.pod:2368
9777 msgid "If C<NULL> then no options are added."
9781 #: ../fish/guestfish-actions.pod:1481
9782 msgid "get-attach-method"
9783 msgstr "get-attach-method"
9786 #: ../fish/guestfish-actions.pod:1483
9789 " get-attach-method\n"
9792 " get-attach-method\n"
9796 #: ../fish/guestfish-actions.pod:1485
9797 msgid "Return the current attach method. See L</set-attach-method>."
9801 #: ../fish/guestfish-actions.pod:1487
9802 msgid "get-autosync"
9803 msgstr "get-autosync"
9806 #: ../fish/guestfish-actions.pod:1489
9816 #: ../fish/guestfish-actions.pod:1491 ../src/guestfs-actions.pod:2393
9817 msgid "Get the autosync flag."
9821 #: ../fish/guestfish-actions.pod:1493
9826 #: ../fish/guestfish-actions.pod:1495
9836 #: ../fish/guestfish-actions.pod:1497 ../src/guestfs-actions.pod:2404
9837 msgid "Return the direct appliance mode flag."
9841 #: ../fish/guestfish-actions.pod:1499
9843 msgstr "get-e2label"
9846 #: ../fish/guestfish-actions.pod:1501
9849 " get-e2label device\n"
9852 " get-e2label пристрій\n"
9856 #: ../fish/guestfish-actions.pod:1503 ../src/guestfs-actions.pod:2423
9858 "This returns the ext2/3/4 filesystem label of the filesystem on C<device>."
9862 #: ../fish/guestfish-actions.pod:1506
9864 "I<This function is deprecated.> In new code, use the L</vfs_label> call "
9869 #: ../fish/guestfish-actions.pod:1513
9874 #: ../fish/guestfish-actions.pod:1515
9877 " get-e2uuid device\n"
9880 " get-e2uuid пристрій\n"
9884 #: ../fish/guestfish-actions.pod:1517 ../src/guestfs-actions.pod:2444
9886 "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>."
9890 #: ../fish/guestfish-actions.pod:1520
9892 "I<This function is deprecated.> In new code, use the L</vfs_uuid> call "
9897 #: ../fish/guestfish-actions.pod:1527
9899 msgstr "get-memsize"
9902 #: ../fish/guestfish-actions.pod:1529
9912 #: ../fish/guestfish-actions.pod:1531 ../src/guestfs-actions.pod:2457
9914 "This gets the memory size in megabytes allocated to the qemu subprocess."
9918 #: ../fish/guestfish-actions.pod:1534
9920 "If L</set-memsize> was not called on this handle, and if "
9921 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
9922 "value for memsize."
9926 #: ../fish/guestfish-actions.pod:1538 ../fish/guestfish-actions.pod:1595
9927 #: ../fish/guestfish-actions.pod:4457 ../fish/guestfish-actions.pod:4559
9928 #: ../src/guestfs-actions.pod:2464 ../src/guestfs-actions.pod:2556
9929 #: ../src/guestfs-actions.pod:6904 ../src/guestfs-actions.pod:7030
9931 "For more information on the architecture of libguestfs, see L<guestfs(3)>."
9935 #: ../fish/guestfish-actions.pod:1541
9937 msgstr "get-network"
9940 #: ../fish/guestfish-actions.pod:1543
9950 #: ../fish/guestfish-actions.pod:1545 ../src/guestfs-actions.pod:2476
9951 msgid "This returns the enable network flag."
9955 #: ../fish/guestfish-actions.pod:1547
9960 #: ../fish/guestfish-actions.pod:1549
9970 #: ../fish/guestfish-actions.pod:1551 ../src/guestfs-actions.pod:2487
9971 msgid "Return the current search path."
9975 #: ../fish/guestfish-actions.pod:1553 ../src/guestfs-actions.pod:2489
9977 "This is always non-NULL. If it wasn't set already, then this will return "
9982 #: ../fish/guestfish-actions.pod:1556
9987 #: ../fish/guestfish-actions.pod:1558
9995 #: ../fish/guestfish-actions.pod:1560 ../src/guestfs-actions.pod:2502
9996 msgid "This returns the process group flag."
10000 #: ../fish/guestfish-actions.pod:1562
10005 #: ../fish/guestfish-actions.pod:1564
10010 #: ../fish/guestfish-actions.pod:1566
10020 #: ../fish/guestfish-actions.pod:1568 ../src/guestfs-actions.pod:2513
10022 "Return the process ID of the qemu subprocess. If there is no qemu "
10023 "subprocess, then this will return an error."
10027 #: ../fish/guestfish-actions.pod:1571 ../src/guestfs-actions.pod:2516
10028 msgid "This is an internal call used for debugging and testing."
10032 #: ../fish/guestfish-actions.pod:1573
10037 #: ../fish/guestfish-actions.pod:1575
10047 #: ../fish/guestfish-actions.pod:1577 ../src/guestfs-actions.pod:2527
10048 msgid "Return the current qemu binary."
10052 #: ../fish/guestfish-actions.pod:1579 ../src/guestfs-actions.pod:2529
10054 "This is always non-NULL. If it wasn't set already, then this will return "
10055 "the default qemu binary name."
10059 #: ../fish/guestfish-actions.pod:1582
10060 msgid "get-recovery-proc"
10061 msgstr "get-recovery-proc"
10064 #: ../fish/guestfish-actions.pod:1584
10067 " get-recovery-proc\n"
10070 " get-recovery-proc\n"
10074 #: ../fish/guestfish-actions.pod:1586 ../src/guestfs-actions.pod:2542
10075 msgid "Return the recovery process enabled flag."
10079 #: ../fish/guestfish-actions.pod:1588
10080 msgid "get-selinux"
10081 msgstr "get-selinux"
10084 #: ../fish/guestfish-actions.pod:1590
10094 #: ../fish/guestfish-actions.pod:1592
10096 "This returns the current setting of the selinux flag which is passed to the "
10097 "appliance at boot time. See L</set-selinux>."
10101 #: ../fish/guestfish-actions.pod:1598
10106 #: ../fish/guestfish-actions.pod:1600
10114 #: ../fish/guestfish-actions.pod:1602 ../src/guestfs-actions.pod:2568
10115 msgid "This returns the number of virtual CPUs assigned to the appliance."
10119 #: ../fish/guestfish-actions.pod:1604
10124 #: ../fish/guestfish-actions.pod:1606
10134 #: ../fish/guestfish-actions.pod:1608 ../src/guestfs-actions.pod:2579
10136 "This returns the current state as an opaque integer. This is only useful "
10137 "for printing debug and internal error messages."
10141 #: ../fish/guestfish-actions.pod:1611 ../fish/guestfish-actions.pod:2570
10142 #: ../fish/guestfish-actions.pod:2588 ../fish/guestfish-actions.pod:2626
10143 #: ../fish/guestfish-actions.pod:2642 ../src/guestfs-actions.pod:2582
10144 #: ../src/guestfs-actions.pod:3901 ../src/guestfs-actions.pod:3930
10145 #: ../src/guestfs-actions.pod:3991 ../src/guestfs-actions.pod:4018
10146 msgid "For more information on states, see L<guestfs(3)>."
10150 #: ../fish/guestfish-actions.pod:1613
10155 #: ../fish/guestfish-actions.pod:1615
10165 #: ../fish/guestfish-actions.pod:1617 ../src/guestfs-actions.pod:2593
10166 msgid "Return the command trace flag."
10170 #: ../fish/guestfish-actions.pod:1619
10175 #: ../fish/guestfish-actions.pod:1621
10185 #: ../fish/guestfish-actions.pod:1623
10187 "Return the current umask. By default the umask is C<022> unless it has been "
10188 "set by calling L</umask>."
10192 #: ../fish/guestfish-actions.pod:1626
10193 msgid "get-verbose"
10194 msgstr "get-verbose"
10197 #: ../fish/guestfish-actions.pod:1628
10207 #: ../fish/guestfish-actions.pod:1630 ../src/guestfs-actions.pod:2616
10208 msgid "This returns the verbose messages flag."
10212 #: ../fish/guestfish-actions.pod:1632
10217 #: ../fish/guestfish-actions.pod:1634
10227 #: ../fish/guestfish-actions.pod:1636 ../src/guestfs-actions.pod:2627
10228 msgid "This gets the SELinux security context of the daemon."
10232 #: ../fish/guestfish-actions.pod:1638
10233 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>"
10237 #: ../fish/guestfish-actions.pod:1641
10242 #: ../fish/guestfish-actions.pod:1643
10245 " getxattr path name\n"
10248 " getxattr шлях назва\n"
10252 #: ../fish/guestfish-actions.pod:1645
10254 "Get a single extended attribute from file C<path> named C<name>. This call "
10255 "follows symlinks. If you want to lookup an extended attribute for the "
10256 "symlink itself, use L</lgetxattr>."
10260 #: ../fish/guestfish-actions.pod:1649 ../fish/guestfish-actions.pod:2715
10262 "Normally it is better to get all extended attributes from a file in one go "
10263 "by calling L</getxattrs>. However some Linux filesystem implementations are "
10264 "buggy and do not provide a way to list out attributes. For these "
10265 "filesystems (notably ntfs-3g) you have to know the names of the extended "
10266 "attributes you want in advance and call this function."
10270 #: ../fish/guestfish-actions.pod:1656 ../fish/guestfish-actions.pod:2722
10271 #: ../src/guestfs-actions.pod:2656 ../src/guestfs-actions.pod:4151
10273 "Extended attribute values are blobs of binary data. If there is no extended "
10274 "attribute named C<name>, this returns an error."
10278 #: ../fish/guestfish-actions.pod:1659
10279 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>."
10280 msgstr "Див. також L</getxattrs>, L</lgetxattr>, L<attr(5)>."
10283 #: ../fish/guestfish-actions.pod:1661
10288 #: ../fish/guestfish-actions.pod:1663
10291 " getxattrs path\n"
10294 " getxattrs шлях\n"
10298 #: ../fish/guestfish-actions.pod:1665 ../src/guestfs-actions.pod:2673
10300 "This call lists the extended attributes of the file or directory C<path>."
10304 #: ../fish/guestfish-actions.pod:1668 ../src/guestfs-actions.pod:2676
10306 "At the system call level, this is a combination of the L<listxattr(2)> and "
10307 "L<getxattr(2)> calls."
10311 #: ../fish/guestfish-actions.pod:1671
10312 msgid "See also: L</lgetxattrs>, L<attr(5)>."
10313 msgstr "Див. також L</lgetxattrs>, L<attr(5)>."
10316 #: ../fish/guestfish-actions.pod:1673
10317 msgid "glob-expand"
10318 msgstr "glob-expand"
10321 #: ../fish/guestfish-actions.pod:1675
10324 " glob-expand pattern\n"
10327 " glob-expand шаблон\n"
10331 #: ../fish/guestfish-actions.pod:1677 ../src/guestfs-actions.pod:2693
10333 "This command searches for all the pathnames matching C<pattern> according to "
10334 "the wildcard expansion rules used by the shell."
10338 #: ../fish/guestfish-actions.pod:1681 ../src/guestfs-actions.pod:2697
10340 "If no paths match, then this returns an empty list (note: not an error)."
10344 #: ../fish/guestfish-actions.pod:1684 ../src/guestfs-actions.pod:2700
10346 "It is just a wrapper around the C L<glob(3)> function with flags C<GLOB_MARK|"
10347 "GLOB_BRACE>. See that manual page for more details."
10351 #: ../fish/guestfish-actions.pod:1688
10356 #: ../fish/guestfish-actions.pod:1690
10359 " grep regex path\n"
10362 " grepi формальний_вираз шлях\n"
10366 #: ../fish/guestfish-actions.pod:1692 ../src/guestfs-actions.pod:2717
10367 msgid "This calls the external C<grep> program and returns the matching lines."
10371 #: ../fish/guestfish-actions.pod:1698
10376 #: ../fish/guestfish-actions.pod:1700
10379 " grepi regex path\n"
10382 " grepi формальний_вираз шлях\n"
10386 #: ../fish/guestfish-actions.pod:1702 ../src/guestfs-actions.pod:2736
10388 "This calls the external C<grep -i> program and returns the matching lines."
10392 #: ../fish/guestfish-actions.pod:1708
10393 msgid "grub-install"
10394 msgstr "grub-install"
10397 #: ../fish/guestfish-actions.pod:1710
10400 " grub-install root device\n"
10403 " grub-install кореневий пристрій\n"
10407 #: ../fish/guestfish-actions.pod:1712 ../src/guestfs-actions.pod:2755
10409 "This command installs GRUB 1 (the Grand Unified Bootloader) on C<device>, "
10410 "with the root directory being C<root>."
10414 #: ../fish/guestfish-actions.pod:1721 ../src/guestfs-actions.pod:2764
10416 "There is currently no way in the API to install grub2, which is used by most "
10417 "modern Linux guests. It is possible to run the grub2 command from the "
10418 "guest, although see the caveats in L<guestfs(3)/RUNNING COMMANDS>."
10422 #: ../fish/guestfish-actions.pod:1728 ../src/guestfs-actions.pod:2771
10424 "This uses C<grub-install> from the host. Unfortunately grub is not always "
10425 "compatible with itself, so this only works in rather narrow circumstances. "
10426 "Careful testing with each guest version is advisable."
10430 #: ../fish/guestfish-actions.pod:1735 ../src/guestfs-actions.pod:2778
10432 "If grub-install reports the error \"No suitable drive was found in the "
10433 "generated device map.\" it may be that you need to create a C</boot/grub/"
10434 "device.map> file first that contains the mapping between grub device names "
10435 "and Linux device names. It is usually sufficient to create a file "
10440 #: ../fish/guestfish-actions.pod:1742 ../src/guestfs-actions.pod:2785
10443 " (hd0) /dev/vda\n"
10448 #: ../fish/guestfish-actions.pod:1744 ../src/guestfs-actions.pod:2787
10449 msgid "replacing C</dev/vda> with the name of the installation device."
10453 #: ../fish/guestfish-actions.pod:1748
10458 #: ../fish/guestfish-actions.pod:1750
10468 #: ../fish/guestfish-actions.pod:1752 ../src/guestfs-actions.pod:2801
10470 "This command returns up to the first 10 lines of a file as a list of strings."
10474 #: ../fish/guestfish-actions.pod:1758
10479 #: ../fish/guestfish-actions.pod:1760
10482 " head-n nrlines path\n"
10487 #: ../fish/guestfish-actions.pod:1762 ../src/guestfs-actions.pod:2820
10489 "If the parameter C<nrlines> is a positive number, this returns the first "
10490 "C<nrlines> lines of the file C<path>."
10494 #: ../fish/guestfish-actions.pod:1765 ../src/guestfs-actions.pod:2823
10496 "If the parameter C<nrlines> is a negative number, this returns lines from "
10497 "the file C<path>, excluding the last C<nrlines> lines."
10501 #: ../fish/guestfish-actions.pod:1768 ../fish/guestfish-actions.pod:4940
10502 #: ../src/guestfs-actions.pod:2826 ../src/guestfs-actions.pod:7609
10503 msgid "If the parameter C<nrlines> is zero, this returns an empty list."
10507 #: ../fish/guestfish-actions.pod:1773
10512 #: ../fish/guestfish-actions.pod:1775
10522 #: ../fish/guestfish-actions.pod:1777 ../src/guestfs-actions.pod:2843
10524 "This runs C<hexdump -C> on the given C<path>. The result is the human-"
10525 "readable, canonical hex dump of the file."
10529 #: ../fish/guestfish-actions.pod:1783
10531 msgstr "initrd-cat"
10534 #: ../fish/guestfish-actions.pod:1785
10537 " initrd-cat initrdpath filename\n"
10540 " initrd-cat шлях_initrd назва_файла\n"
10544 #: ../fish/guestfish-actions.pod:1787 ../src/guestfs-actions.pod:2862
10546 "This command unpacks the file C<filename> from the initrd file called "
10547 "C<initrdpath>. The filename must be given I<without> the initial C</> "
10552 #: ../fish/guestfish-actions.pod:1791 ../src/guestfs-actions.pod:2866
10554 "For example, in guestfish you could use the following command to examine the "
10555 "boot script (usually called C</init>) contained in a Linux initrd or "
10560 #: ../fish/guestfish-actions.pod:1795 ../src/guestfs-actions.pod:2870
10563 " initrd-cat /boot/initrd-<version>.img init\n"
10568 #: ../fish/guestfish-actions.pod:1797
10569 msgid "See also L</initrd-list>."
10570 msgstr "Див. також L</initrd-list>."
10573 #: ../fish/guestfish-actions.pod:1802
10574 msgid "initrd-list"
10575 msgstr "initrd-list"
10578 #: ../fish/guestfish-actions.pod:1804
10581 " initrd-list path\n"
10584 " initrd-list шлях\n"
10588 #: ../fish/guestfish-actions.pod:1806 ../src/guestfs-actions.pod:2889
10589 msgid "This command lists out files contained in an initrd."
10593 #: ../fish/guestfish-actions.pod:1808 ../src/guestfs-actions.pod:2891
10595 "The files are listed without any initial C</> character. The files are "
10596 "listed in the order they appear (not necessarily alphabetical). Directory "
10597 "names are listed as separate items."
10601 #: ../fish/guestfish-actions.pod:1812 ../src/guestfs-actions.pod:2895
10603 "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as "
10604 "initrd. We I<only> support the newer initramfs format (compressed cpio "
10609 #: ../fish/guestfish-actions.pod:1816
10610 msgid "inotify-add-watch"
10611 msgstr "inotify-add-watch"
10614 #: ../fish/guestfish-actions.pod:1818
10617 " inotify-add-watch path mask\n"
10620 " inotify-add-watch шлях маска\n"
10624 #: ../fish/guestfish-actions.pod:1820 ../src/guestfs-actions.pod:2912
10625 msgid "Watch C<path> for the events listed in C<mask>."
10629 #: ../fish/guestfish-actions.pod:1822 ../src/guestfs-actions.pod:2914
10631 "Note that if C<path> is a directory then events within that directory are "
10632 "watched, but this does I<not> happen recursively (in subdirectories)."
10636 #: ../fish/guestfish-actions.pod:1826 ../src/guestfs-actions.pod:2918
10638 "Note for non-C or non-Linux callers: the inotify events are defined by the "
10639 "Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>."
10643 #: ../fish/guestfish-actions.pod:1830
10644 msgid "inotify-close"
10645 msgstr "inotify-close"
10648 #: ../fish/guestfish-actions.pod:1832
10658 #: ../fish/guestfish-actions.pod:1834 ../src/guestfs-actions.pod:2931
10660 "This closes the inotify handle which was previously opened by inotify_init. "
10661 "It removes all watches, throws away any pending events, and deallocates all "
10666 #: ../fish/guestfish-actions.pod:1838
10667 msgid "inotify-files"
10668 msgstr "inotify-files"
10671 #: ../fish/guestfish-actions.pod:1840
10681 #: ../fish/guestfish-actions.pod:1842
10683 "This function is a helpful wrapper around L</inotify-read> which just "
10684 "returns a list of pathnames of objects that were touched. The returned "
10685 "pathnames are sorted and deduplicated."
10689 #: ../fish/guestfish-actions.pod:1846
10690 msgid "inotify-init"
10691 msgstr "inotify-init"
10694 #: ../fish/guestfish-actions.pod:1848
10697 " inotify-init maxevents\n"
10702 #: ../fish/guestfish-actions.pod:1850 ../src/guestfs-actions.pod:2960
10704 "This command creates a new inotify handle. The inotify subsystem can be "
10705 "used to notify events which happen to objects in the guest filesystem."
10709 #: ../fish/guestfish-actions.pod:1854
10711 "C<maxevents> is the maximum number of events which will be queued up between "
10712 "calls to L</inotify-read> or L</inotify-files>. If this is passed as C<0>, "
10713 "then the kernel (or previously set) default is used. For Linux 2.6.29 the "
10714 "default was 16384 events. Beyond this limit, the kernel throws away events, "
10715 "but records the fact that it threw them away by setting a flag "
10716 "C<IN_Q_OVERFLOW> in the returned structure list (see L</inotify-read>)."
10720 #: ../fish/guestfish-actions.pod:1864
10722 "Before any events are generated, you have to add some watches to the "
10723 "internal watch list. See: L</inotify-add-watch>, L</inotify-rm-watch> and "
10724 "L</inotify-watch-all>."
10728 #: ../fish/guestfish-actions.pod:1870
10730 "Queued up events should be read periodically by calling L</inotify-read> (or "
10731 "L</inotify-files> which is just a helpful wrapper around L</inotify-read>). "
10732 "If you don't read the events out often enough then you risk the internal "
10733 "queue overflowing."
10737 #: ../fish/guestfish-actions.pod:1877
10739 "The handle should be closed after use by calling L</inotify-close>. This "
10740 "also removes any watches automatically."
10744 #: ../fish/guestfish-actions.pod:1881 ../src/guestfs-actions.pod:2991
10746 "See also L<inotify(7)> for an overview of the inotify interface as exposed "
10747 "by the Linux kernel, which is roughly what we expose via libguestfs. Note "
10748 "that there is one global inotify handle per libguestfs instance."
10752 #: ../fish/guestfish-actions.pod:1886
10753 msgid "inotify-read"
10754 msgstr "inotify-read"
10757 #: ../fish/guestfish-actions.pod:1888
10767 #: ../fish/guestfish-actions.pod:1890 ../src/guestfs-actions.pod:3005
10769 "Return the complete queue of events that have happened since the previous "
10774 #: ../fish/guestfish-actions.pod:1893 ../src/guestfs-actions.pod:3008
10775 msgid "If no events have happened, this returns an empty list."
10779 #: ../fish/guestfish-actions.pod:1895 ../src/guestfs-actions.pod:3010
10781 "I<Note>: In order to make sure that all events have been read, you must call "
10782 "this function repeatedly until it returns an empty list. The reason is that "
10783 "the call will read events up to the maximum appliance-to-host message size "
10784 "and leave remaining events in the queue."
10788 #: ../fish/guestfish-actions.pod:1901
10789 msgid "inotify-rm-watch"
10790 msgstr "inotify-rm-watch"
10793 #: ../fish/guestfish-actions.pod:1903
10796 " inotify-rm-watch wd\n"
10801 #: ../fish/guestfish-actions.pod:1905
10802 msgid "Remove a previously defined inotify watch. See L</inotify-add-watch>."
10806 #: ../fish/guestfish-actions.pod:1908
10807 msgid "inspect-get-arch"
10808 msgstr "inspect-get-arch"
10811 #: ../fish/guestfish-actions.pod:1910
10814 " inspect-get-arch root\n"
10817 " inspect-get-arch корінь\n"
10821 #: ../fish/guestfish-actions.pod:1912
10823 "This returns the architecture of the inspected operating system. The "
10824 "possible return values are listed under L</file-architecture>."
10828 #: ../fish/guestfish-actions.pod:1916 ../src/guestfs-actions.pod:3045
10830 "If the architecture could not be determined, then the string C<unknown> is "
10835 #: ../fish/guestfish-actions.pod:1919 ../fish/guestfish-actions.pod:2014
10836 #: ../fish/guestfish-actions.pod:2093 ../fish/guestfish-actions.pod:2105
10837 #: ../fish/guestfish-actions.pod:2189 ../fish/guestfish-actions.pod:2251
10838 #: ../fish/guestfish-actions.pod:2272 ../fish/guestfish-actions.pod:2286
10839 #: ../fish/guestfish-actions.pod:2326 ../fish/guestfish-actions.pod:2362
10840 #: ../fish/guestfish-actions.pod:2375 ../fish/guestfish-actions.pod:2388
10841 #: ../fish/guestfish-actions.pod:2398 ../fish/guestfish-actions.pod:2408
10842 #: ../fish/guestfish-actions.pod:2420 ../fish/guestfish-actions.pod:2516
10843 #: ../fish/guestfish-actions.pod:2550 ../src/guestfs-actions.pod:3048
10844 #: ../src/guestfs-actions.pod:3150 ../src/guestfs-actions.pod:3254
10845 #: ../src/guestfs-actions.pod:3273 ../src/guestfs-actions.pod:3404
10846 #: ../src/guestfs-actions.pod:3488 ../src/guestfs-actions.pod:3516
10847 #: ../src/guestfs-actions.pod:3537 ../src/guestfs-actions.pod:3590
10848 #: ../src/guestfs-actions.pod:3634 ../src/guestfs-actions.pod:3654
10849 #: ../src/guestfs-actions.pod:3674 ../src/guestfs-actions.pod:3691
10850 #: ../src/guestfs-actions.pod:3707 ../src/guestfs-actions.pod:3725
10851 #: ../src/guestfs-actions.pod:3827 ../src/guestfs-actions.pod:3868
10852 msgid "Please read L<guestfs(3)/INSPECTION> for more details."
10856 #: ../fish/guestfish-actions.pod:1921
10857 msgid "inspect-get-distro"
10858 msgstr "inspect-get-distro"
10861 #: ../fish/guestfish-actions.pod:1923
10864 " inspect-get-distro root\n"
10867 " inspect-get-distro корінь\n"
10871 #: ../fish/guestfish-actions.pod:1925 ../src/guestfs-actions.pod:3061
10873 "This returns the distro (distribution) of the inspected operating system."
10877 #: ../fish/guestfish-actions.pod:1928 ../src/guestfs-actions.pod:3064
10878 msgid "Currently defined distros are:"
10882 #: ../fish/guestfish-actions.pod:1932 ../src/guestfs-actions.pod:3068
10883 msgid "\"archlinux\""
10884 msgstr "\"archlinux\""
10887 #: ../fish/guestfish-actions.pod:1934 ../src/guestfs-actions.pod:3070
10888 msgid "Arch Linux."
10889 msgstr "Arch Linux."
10892 #: ../fish/guestfish-actions.pod:1936 ../src/guestfs-actions.pod:3072
10897 #: ../fish/guestfish-actions.pod:1938 ../src/guestfs-actions.pod:3074
10902 #: ../fish/guestfish-actions.pod:1940 ../src/guestfs-actions.pod:3076
10904 msgstr "\"debian\""
10907 #: ../fish/guestfish-actions.pod:1942 ../src/guestfs-actions.pod:3078
10912 #: ../fish/guestfish-actions.pod:1944 ../src/guestfs-actions.pod:3080
10914 msgstr "\"fedora\""
10917 #: ../fish/guestfish-actions.pod:1946 ../src/guestfs-actions.pod:3082
10922 #: ../fish/guestfish-actions.pod:1948 ../src/guestfs-actions.pod:3084
10924 msgstr "\"gentoo\""
10927 #: ../fish/guestfish-actions.pod:1950 ../src/guestfs-actions.pod:3086
10932 #: ../fish/guestfish-actions.pod:1952 ../src/guestfs-actions.pod:3088
10933 msgid "\"linuxmint\""
10934 msgstr "\"linuxmint\""
10937 #: ../fish/guestfish-actions.pod:1954 ../src/guestfs-actions.pod:3090
10938 msgid "Linux Mint."
10939 msgstr "Linux Mint."
10942 #: ../fish/guestfish-actions.pod:1956 ../src/guestfs-actions.pod:3092
10947 #: ../fish/guestfish-actions.pod:1958 ../src/guestfs-actions.pod:3094
10952 #: ../fish/guestfish-actions.pod:1960 ../src/guestfs-actions.pod:3096
10953 msgid "\"mandriva\""
10954 msgstr "\"mandriva\""
10957 #: ../fish/guestfish-actions.pod:1962 ../src/guestfs-actions.pod:3098
10962 #: ../fish/guestfish-actions.pod:1964 ../src/guestfs-actions.pod:3100
10967 #: ../fish/guestfish-actions.pod:1966 ../src/guestfs-actions.pod:3102
10972 #: ../fish/guestfish-actions.pod:1968 ../src/guestfs-actions.pod:3104
10973 msgid "\"opensuse\""
10977 #: ../fish/guestfish-actions.pod:1970 ../src/guestfs-actions.pod:3106
10982 #: ../fish/guestfish-actions.pod:1972 ../src/guestfs-actions.pod:3108
10984 msgstr "\"pardus\""
10987 #: ../fish/guestfish-actions.pod:1974 ../src/guestfs-actions.pod:3110
10992 #: ../fish/guestfish-actions.pod:1976 ../src/guestfs-actions.pod:3112
10993 msgid "\"redhat-based\""
10994 msgstr "\"redhat-based\""
10997 #: ../fish/guestfish-actions.pod:1978 ../src/guestfs-actions.pod:3114
10998 msgid "Some Red Hat-derived distro."
10999 msgstr "Дистрибутив, що походить від Red Hat."
11002 #: ../fish/guestfish-actions.pod:1980 ../src/guestfs-actions.pod:3116
11007 #: ../fish/guestfish-actions.pod:1982 ../src/guestfs-actions.pod:3118
11008 msgid "Red Hat Enterprise Linux."
11009 msgstr "Red Hat Enterprise Linux."
11012 #: ../fish/guestfish-actions.pod:1984 ../src/guestfs-actions.pod:3120
11013 msgid "\"scientificlinux\""
11014 msgstr "\"scientificlinux\""
11017 #: ../fish/guestfish-actions.pod:1986 ../src/guestfs-actions.pod:3122
11018 msgid "Scientific Linux."
11019 msgstr "Scientific Linux."
11022 #: ../fish/guestfish-actions.pod:1988 ../src/guestfs-actions.pod:3124
11023 msgid "\"slackware\""
11024 msgstr "\"slackware\""
11027 #: ../fish/guestfish-actions.pod:1990 ../src/guestfs-actions.pod:3126
11029 msgstr "Slackware."
11032 #: ../fish/guestfish-actions.pod:1992 ../src/guestfs-actions.pod:3128
11033 msgid "\"ttylinux\""
11037 #: ../fish/guestfish-actions.pod:1994 ../src/guestfs-actions.pod:3130
11042 #: ../fish/guestfish-actions.pod:1996 ../src/guestfs-actions.pod:3132
11044 msgstr "\"ubuntu\""
11047 #: ../fish/guestfish-actions.pod:1998 ../src/guestfs-actions.pod:3134
11052 #: ../fish/guestfish-actions.pod:2000 ../fish/guestfish-actions.pod:2084
11053 #: ../fish/guestfish-actions.pod:2353 ../src/guestfs-actions.pod:3136
11054 #: ../src/guestfs-actions.pod:3245 ../src/guestfs-actions.pod:3625
11055 msgid "\"unknown\""
11056 msgstr "\"unknown\""
11059 #: ../fish/guestfish-actions.pod:2002 ../src/guestfs-actions.pod:3138
11060 msgid "The distro could not be determined."
11061 msgstr "Дистрибутив, тип якого не вдалося визначити."
11064 #: ../fish/guestfish-actions.pod:2004 ../fish/guestfish-actions.pod:2341
11065 #: ../src/guestfs-actions.pod:3140 ../src/guestfs-actions.pod:3613
11066 msgid "\"windows\""
11067 msgstr "\"windows\""
11070 #: ../fish/guestfish-actions.pod:2006 ../src/guestfs-actions.pod:3142
11072 "Windows does not have distributions. This string is returned if the OS type "
11077 #: ../fish/guestfish-actions.pod:2011 ../fish/guestfish-actions.pod:2090
11078 #: ../fish/guestfish-actions.pod:2359 ../src/guestfs-actions.pod:3147
11079 #: ../src/guestfs-actions.pod:3251 ../src/guestfs-actions.pod:3631
11081 "Future versions of libguestfs may return other strings here. The caller "
11082 "should be prepared to handle any string."
11086 #: ../fish/guestfish-actions.pod:2016
11087 msgid "inspect-get-drive-mappings"
11091 #: ../fish/guestfish-actions.pod:2018
11094 " inspect-get-drive-mappings root\n"
11099 #: ../fish/guestfish-actions.pod:2020 ../src/guestfs-actions.pod:3163
11101 "This call is useful for Windows which uses a primitive system of assigning "
11102 "drive letters (like \"C:\") to partitions. This inspection API examines the "
11103 "Windows Registry to find out how disks/partitions are mapped to drive "
11104 "letters, and returns a hash table as in the example below:"
11108 #: ../fish/guestfish-actions.pod:2026 ../src/guestfs-actions.pod:3169
11111 " C => /dev/vda2\n"
11112 " E => /dev/vdb1\n"
11113 " F => /dev/vdc1\n"
11118 #: ../fish/guestfish-actions.pod:2030 ../src/guestfs-actions.pod:3173
11120 "Note that keys are drive letters. For Windows, the key is case insensitive "
11121 "and just contains the drive letter, without the customary colon separator "
11126 #: ../fish/guestfish-actions.pod:2034 ../src/guestfs-actions.pod:3177
11128 "In future we may support other operating systems that also used drive "
11129 "letters, but the keys for those might not be case insensitive and might be "
11130 "longer than 1 character. For example in OS-9, hard drives were named C<h0>, "
11135 #: ../fish/guestfish-actions.pod:2039 ../src/guestfs-actions.pod:3182
11137 "For Windows guests, currently only hard drive mappings are returned. "
11138 "Removable disks (eg. DVD-ROMs) are ignored."
11142 #: ../fish/guestfish-actions.pod:2042 ../src/guestfs-actions.pod:3185
11144 "For guests that do not use drive mappings, or if the drive mappings could "
11145 "not be determined, this returns an empty hash table."
11149 #: ../fish/guestfish-actions.pod:2045
11151 "Please read L<guestfs(3)/INSPECTION> for more details. See also L</inspect-"
11152 "get-mountpoints>, L</inspect-get-filesystems>."
11156 #: ../fish/guestfish-actions.pod:2049
11157 msgid "inspect-get-filesystems"
11158 msgstr "inspect-get-filesystems"
11161 #: ../fish/guestfish-actions.pod:2051
11164 " inspect-get-filesystems root\n"
11167 " inspect-get-filesystems корінь\n"
11171 #: ../fish/guestfish-actions.pod:2053 ../src/guestfs-actions.pod:3206
11173 "This returns a list of all the filesystems that we think are associated with "
11174 "this operating system. This includes the root filesystem, other ordinary "
11175 "filesystems, and non-mounted devices like swap partitions."
11179 #: ../fish/guestfish-actions.pod:2058 ../src/guestfs-actions.pod:3211
11181 "In the case of a multi-boot virtual machine, it is possible for a filesystem "
11182 "to be shared between operating systems."
11186 #: ../fish/guestfish-actions.pod:2061
11188 "Please read L<guestfs(3)/INSPECTION> for more details. See also L</inspect-"
11189 "get-mountpoints>."
11193 #: ../fish/guestfish-actions.pod:2064
11194 msgid "inspect-get-format"
11195 msgstr "inspect-get-format"
11198 #: ../fish/guestfish-actions.pod:2066
11201 " inspect-get-format root\n"
11204 " inspect-get-format корінь\n"
11208 #: ../fish/guestfish-actions.pod:2068 ../src/guestfs-actions.pod:3229
11210 "This returns the format of the inspected operating system. You can use it "
11211 "to detect install images, live CDs and similar."
11215 #: ../fish/guestfish-actions.pod:2071 ../src/guestfs-actions.pod:3232
11216 msgid "Currently defined formats are:"
11220 #: ../fish/guestfish-actions.pod:2075 ../src/guestfs-actions.pod:3236
11221 msgid "\"installed\""
11222 msgstr "\"installed\""
11225 #: ../fish/guestfish-actions.pod:2077 ../src/guestfs-actions.pod:3238
11226 msgid "This is an installed operating system."
11227 msgstr "Це встановлена операційна система."
11230 #: ../fish/guestfish-actions.pod:2079 ../src/guestfs-actions.pod:3240
11231 msgid "\"installer\""
11235 #: ../fish/guestfish-actions.pod:2081 ../src/guestfs-actions.pod:3242
11237 "The disk image being inspected is not an installed operating system, but a "
11238 "I<bootable> install disk, live CD, or similar."
11242 #: ../fish/guestfish-actions.pod:2086 ../src/guestfs-actions.pod:3247
11243 msgid "The format of this disk image is not known."
11247 #: ../fish/guestfish-actions.pod:2095
11248 msgid "inspect-get-hostname"
11249 msgstr "inspect-get-hostname"
11252 #: ../fish/guestfish-actions.pod:2097
11255 " inspect-get-hostname root\n"
11258 " inspect-get-hostname корінь\n"
11262 #: ../fish/guestfish-actions.pod:2099 ../src/guestfs-actions.pod:3267
11264 "This function returns the hostname of the operating system as found by "
11265 "inspection of the guest's configuration files."
11269 #: ../fish/guestfish-actions.pod:2102 ../src/guestfs-actions.pod:3270
11271 "If the hostname could not be determined, then the string C<unknown> is "
11276 #: ../fish/guestfish-actions.pod:2107
11277 msgid "inspect-get-icon"
11281 #: ../fish/guestfish-actions.pod:2109
11284 " inspect-get-icon root [favicon:true|false] [highquality:true|false]\n"
11289 #: ../fish/guestfish-actions.pod:2111 ../src/guestfs-actions.pod:3296
11291 "This function returns an icon corresponding to the inspected operating "
11292 "system. The icon is returned as a buffer containing a PNG image (re-encoded "
11293 "to PNG if necessary)."
11297 #: ../fish/guestfish-actions.pod:2115 ../src/guestfs-actions.pod:3300
11299 "If it was not possible to get an icon this function returns a zero-length "
11300 "(non-NULL) buffer. I<Callers must check for this case>."
11304 #: ../fish/guestfish-actions.pod:2118 ../src/guestfs-actions.pod:3303
11306 "Libguestfs will start by looking for a file called C</etc/favicon.png> or "
11307 "C<C:\\etc\\favicon.png> and if it has the correct format, the contents of "
11308 "this file will be returned. You can disable favicons by passing the "
11309 "optional C<favicon> boolean as false (default is true)."
11313 #: ../fish/guestfish-actions.pod:2124 ../src/guestfs-actions.pod:3309
11315 "If finding the favicon fails, then we look in other places in the guest for "
11320 #: ../fish/guestfish-actions.pod:2127 ../src/guestfs-actions.pod:3312
11322 "If the optional C<highquality> boolean is true then only high quality icons "
11323 "are returned, which means only icons of high resolution with an alpha "
11324 "channel. The default (false) is to return any icon we can, even if it is of "
11325 "substandard quality."
11329 #: ../fish/guestfish-actions.pod:2138 ../src/guestfs-actions.pod:3323
11331 "Unlike most other inspection API calls, the guest's disks must be mounted up "
11332 "before you call this, since it needs to read information from the guest "
11333 "filesystem during the call."
11337 #: ../fish/guestfish-actions.pod:2144 ../src/guestfs-actions.pod:3329
11339 "B<Security:> The icon data comes from the untrusted guest, and should be "
11340 "treated with caution. PNG files have been known to contain exploits. "
11341 "Ensure that libpng (or other relevant libraries) are fully up to date before "
11342 "trying to process or display the icon."
11346 #: ../fish/guestfish-actions.pod:2152 ../src/guestfs-actions.pod:3337
11348 "The PNG image returned can be any size. It might not be square. Libguestfs "
11349 "tries to return the largest, highest quality icon available. The "
11350 "application must scale the icon to the required size."
11354 #: ../fish/guestfish-actions.pod:2159 ../src/guestfs-actions.pod:3344
11356 "Extracting icons from Windows guests requires the external C<wrestool> "
11357 "program from the C<icoutils> package, and several programs (C<bmptopnm>, "
11358 "C<pnmtopng>, C<pamcut>) from the C<netpbm> package. These must be "
11359 "installed separately."
11363 #: ../fish/guestfish-actions.pod:2166 ../src/guestfs-actions.pod:3351
11365 "Operating system icons are usually trademarks. Seek legal advice before "
11366 "using trademarks in applications."
11370 #: ../fish/guestfish-actions.pod:2173
11371 msgid "inspect-get-major-version"
11372 msgstr "inspect-get-major-version"
11375 #: ../fish/guestfish-actions.pod:2175
11378 " inspect-get-major-version root\n"
11381 " inspect-get-major-version корінь\n"
11385 #: ../fish/guestfish-actions.pod:2177 ../src/guestfs-actions.pod:3392
11387 "This returns the major version number of the inspected operating system."
11391 #: ../fish/guestfish-actions.pod:2180 ../src/guestfs-actions.pod:3395
11393 "Windows uses a consistent versioning scheme which is I<not> reflected in the "
11394 "popular public names used by the operating system. Notably the operating "
11395 "system known as \"Windows 7\" is really version 6.1 (ie. major = 6, minor = "
11396 "1). You can find out the real versions corresponding to releases of Windows "
11397 "by consulting Wikipedia or MSDN."
11401 #: ../fish/guestfish-actions.pod:2187 ../fish/guestfish-actions.pod:2198
11402 #: ../src/guestfs-actions.pod:3402 ../src/guestfs-actions.pod:3419
11403 msgid "If the version could not be determined, then C<0> is returned."
11407 #: ../fish/guestfish-actions.pod:2191
11408 msgid "inspect-get-minor-version"
11409 msgstr "inspect-get-minor-version"
11412 #: ../fish/guestfish-actions.pod:2193
11415 " inspect-get-minor-version root\n"
11418 " inspect-get-minor-version корінь\n"
11422 #: ../fish/guestfish-actions.pod:2195 ../src/guestfs-actions.pod:3416
11424 "This returns the minor version number of the inspected operating system."
11428 #: ../fish/guestfish-actions.pod:2200
11430 "Please read L<guestfs(3)/INSPECTION> for more details. See also L</inspect-"
11431 "get-major-version>."
11435 #: ../fish/guestfish-actions.pod:2203
11436 msgid "inspect-get-mountpoints"
11437 msgstr "inspect-get-mountpoints"
11440 #: ../fish/guestfish-actions.pod:2205
11443 " inspect-get-mountpoints root\n"
11446 " inspect-get-mountpoints корінь\n"
11450 #: ../fish/guestfish-actions.pod:2207 ../src/guestfs-actions.pod:3434
11452 "This returns a hash of where we think the filesystems associated with this "
11453 "operating system should be mounted. Callers should note that this is at "
11454 "best an educated guess made by reading configuration files such as C</etc/"
11455 "fstab>. I<In particular note> that this may return filesystems which are "
11456 "non-existent or not mountable and callers should be prepared to handle or "
11457 "ignore failures if they try to mount them."
11461 #: ../fish/guestfish-actions.pod:2216 ../src/guestfs-actions.pod:3443
11463 "Each element in the returned hashtable has a key which is the path of the "
11464 "mountpoint (eg. C</boot>) and a value which is the filesystem that would be "
11465 "mounted there (eg. C</dev/sda1>)."
11469 #: ../fish/guestfish-actions.pod:2221 ../src/guestfs-actions.pod:3448
11471 "Non-mounted devices such as swap devices are I<not> returned in this list."
11475 #: ../fish/guestfish-actions.pod:2224
11477 "For operating systems like Windows which still use drive letters, this call "
11478 "will only return an entry for the first drive \"mounted on\" C</>. For "
11479 "information about the mapping of drive letters to partitions, see L</inspect-"
11480 "get-drive-mappings>."
11484 #: ../fish/guestfish-actions.pod:2230
11486 "Please read L<guestfs(3)/INSPECTION> for more details. See also L</inspect-"
11487 "get-filesystems>."
11491 #: ../fish/guestfish-actions.pod:2233
11492 msgid "inspect-get-package-format"
11493 msgstr "inspect-get-package-format"
11496 #: ../fish/guestfish-actions.pod:2235
11499 " inspect-get-package-format root\n"
11502 " inspect-get-package-format корінь\n"
11506 #: ../fish/guestfish-actions.pod:2237
11508 "This function and L</inspect-get-package-management> return the package "
11509 "format and package management tool used by the inspected operating system. "
11510 "For example for Fedora these functions would return C<rpm> (package format) "
11511 "and C<yum> (package management)."
11515 #: ../fish/guestfish-actions.pod:2243 ../src/guestfs-actions.pod:3480
11517 "This returns the string C<unknown> if we could not determine the package "
11518 "format I<or> if the operating system does not have a real packaging system "
11523 #: ../fish/guestfish-actions.pod:2247 ../src/guestfs-actions.pod:3484
11525 "Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>, "
11526 "C<pkgsrc>. Future versions of libguestfs may return other strings."
11530 #: ../fish/guestfish-actions.pod:2253
11531 msgid "inspect-get-package-management"
11532 msgstr "inspect-get-package-management"
11535 #: ../fish/guestfish-actions.pod:2255
11538 " inspect-get-package-management root\n"
11541 " inspect-get-package-management корінь\n"
11545 #: ../fish/guestfish-actions.pod:2257
11547 "L</inspect-get-package-format> and this function return the package format "
11548 "and package management tool used by the inspected operating system. For "
11549 "example for Fedora these functions would return C<rpm> (package format) and "
11550 "C<yum> (package management)."
11554 #: ../fish/guestfish-actions.pod:2263 ../src/guestfs-actions.pod:3507
11556 "This returns the string C<unknown> if we could not determine the package "
11557 "management tool I<or> if the operating system does not have a real packaging "
11558 "system (eg. Windows)."
11562 #: ../fish/guestfish-actions.pod:2267 ../src/guestfs-actions.pod:3511
11564 "Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian "
11565 "derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>, C<zypper>. Future "
11566 "versions of libguestfs may return other strings."
11570 #: ../fish/guestfish-actions.pod:2274
11571 msgid "inspect-get-product-name"
11572 msgstr "inspect-get-product-name"
11575 #: ../fish/guestfish-actions.pod:2276
11578 " inspect-get-product-name root\n"
11581 " inspect-get-product-name корінь\n"
11585 #: ../fish/guestfish-actions.pod:2278 ../src/guestfs-actions.pod:3529
11587 "This returns the product name of the inspected operating system. The "
11588 "product name is generally some freeform string which can be displayed to the "
11589 "user, but should not be parsed by programs."
11593 #: ../fish/guestfish-actions.pod:2283 ../src/guestfs-actions.pod:3534
11595 "If the product name could not be determined, then the string C<unknown> is "
11600 #: ../fish/guestfish-actions.pod:2288
11601 msgid "inspect-get-product-variant"
11605 #: ../fish/guestfish-actions.pod:2290
11608 " inspect-get-product-variant root\n"
11613 #: ../fish/guestfish-actions.pod:2292 ../src/guestfs-actions.pod:3550
11614 msgid "This returns the product variant of the inspected operating system."
11618 #: ../fish/guestfish-actions.pod:2295 ../src/guestfs-actions.pod:3553
11620 "For Windows guests, this returns the contents of the Registry key C<HKLM"
11621 "\\Software\\Microsoft\\Windows NT\\CurrentVersion> C<InstallationType> which "
11622 "is usually a string such as C<Client> or C<Server> (other values are "
11623 "possible). This can be used to distinguish consumer and enterprise versions "
11624 "of Windows that have the same version number (for example, Windows 7 and "
11625 "Windows 2008 Server are both version 6.1, but the former is C<Client> and "
11626 "the latter is C<Server>)."
11630 #: ../fish/guestfish-actions.pod:2304 ../src/guestfs-actions.pod:3562
11632 "For enterprise Linux guests, in future we intend this to return the product "
11633 "variant such as C<Desktop>, C<Server> and so on. But this is not "
11634 "implemented at present."
11638 #: ../fish/guestfish-actions.pod:2308 ../src/guestfs-actions.pod:3566
11640 "If the product variant could not be determined, then the string C<unknown> "
11645 #: ../fish/guestfish-actions.pod:2311
11647 "Please read L<guestfs(3)/INSPECTION> for more details. See also L</inspect-"
11648 "get-product-name>, L</inspect-get-major-version>."
11652 #: ../fish/guestfish-actions.pod:2315
11653 msgid "inspect-get-roots"
11654 msgstr "inspect-get-roots"
11657 #: ../fish/guestfish-actions.pod:2317
11660 " inspect-get-roots\n"
11663 " inspect-get-roots\n"
11667 #: ../fish/guestfish-actions.pod:2319
11669 "This function is a convenient way to get the list of root devices, as "
11670 "returned from a previous call to L</inspect-os>, but without redoing the "
11671 "whole inspection process."
11675 #: ../fish/guestfish-actions.pod:2323
11677 "This returns an empty list if either no root devices were found or the "
11678 "caller has not called L</inspect-os>."
11682 #: ../fish/guestfish-actions.pod:2328
11683 msgid "inspect-get-type"
11684 msgstr "inspect-get-type"
11687 #: ../fish/guestfish-actions.pod:2330
11690 " inspect-get-type root\n"
11693 " inspect-get-type корінь\n"
11697 #: ../fish/guestfish-actions.pod:2332 ../src/guestfs-actions.pod:3604
11699 "This returns the type of the inspected operating system. Currently defined "
11704 #: ../fish/guestfish-actions.pod:2337 ../src/guestfs-actions.pod:3609
11709 #: ../fish/guestfish-actions.pod:2339 ../src/guestfs-actions.pod:3611
11710 msgid "Any Linux-based operating system."
11714 #: ../fish/guestfish-actions.pod:2343 ../src/guestfs-actions.pod:3615
11715 msgid "Any Microsoft Windows operating system."
11719 #: ../fish/guestfish-actions.pod:2345 ../src/guestfs-actions.pod:3617
11720 msgid "\"freebsd\""
11721 msgstr "\"freebsd\""
11724 #: ../fish/guestfish-actions.pod:2347 ../src/guestfs-actions.pod:3619
11729 #: ../fish/guestfish-actions.pod:2349 ../src/guestfs-actions.pod:3621
11734 #: ../fish/guestfish-actions.pod:2351 ../src/guestfs-actions.pod:3623
11739 #: ../fish/guestfish-actions.pod:2355 ../src/guestfs-actions.pod:3627
11740 msgid "The operating system type could not be determined."
11744 #: ../fish/guestfish-actions.pod:2364
11745 msgid "inspect-get-windows-current-control-set"
11749 #: ../fish/guestfish-actions.pod:2366
11752 " inspect-get-windows-current-control-set root\n"
11757 #: ../fish/guestfish-actions.pod:2368 ../src/guestfs-actions.pod:3647
11759 "This returns the Windows CurrentControlSet of the inspected guest. The "
11760 "CurrentControlSet is a registry key name such as C<ControlSet001>."
11764 #: ../fish/guestfish-actions.pod:2371 ../src/guestfs-actions.pod:3650
11766 "This call assumes that the guest is Windows and that the Registry could be "
11767 "examined by inspection. If this is not the case then an error is returned."
11771 #: ../fish/guestfish-actions.pod:2377
11772 msgid "inspect-get-windows-systemroot"
11773 msgstr "inspect-get-windows-systemroot"
11776 #: ../fish/guestfish-actions.pod:2379
11779 " inspect-get-windows-systemroot root\n"
11782 " inspect-get-windows-systemroot корінь\n"
11786 #: ../fish/guestfish-actions.pod:2381 ../src/guestfs-actions.pod:3667
11788 "This returns the Windows systemroot of the inspected guest. The systemroot "
11789 "is a directory path such as C</WINDOWS>."
11793 #: ../fish/guestfish-actions.pod:2384 ../src/guestfs-actions.pod:3670
11795 "This call assumes that the guest is Windows and that the systemroot could be "
11796 "determined by inspection. If this is not the case then an error is returned."
11800 #: ../fish/guestfish-actions.pod:2390
11801 msgid "inspect-is-live"
11802 msgstr "inspect-is-live"
11805 #: ../fish/guestfish-actions.pod:2392
11808 " inspect-is-live root\n"
11811 " inspect-is-live корінь\n"
11815 #: ../fish/guestfish-actions.pod:2394
11817 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
11818 "then this returns true if a live image was detected on the disk."
11822 #: ../fish/guestfish-actions.pod:2400
11823 msgid "inspect-is-multipart"
11824 msgstr "inspect-is-multipart"
11827 #: ../fish/guestfish-actions.pod:2402
11830 " inspect-is-multipart root\n"
11833 " inspect-is-multipart корінь\n"
11837 #: ../fish/guestfish-actions.pod:2404
11839 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
11840 "then this returns true if the disk is part of a set."
11844 #: ../fish/guestfish-actions.pod:2410
11845 msgid "inspect-is-netinst"
11846 msgstr "inspect-is-netinst"
11849 #: ../fish/guestfish-actions.pod:2412
11852 " inspect-is-netinst root\n"
11855 " inspect-is-netinst корінь\n"
11859 #: ../fish/guestfish-actions.pod:2414
11861 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
11862 "then this returns true if the disk is a network installer, ie. not a self-"
11863 "contained install CD but one which is likely to require network access to "
11864 "complete the install."
11868 #: ../fish/guestfish-actions.pod:2422
11869 msgid "inspect-list-applications"
11870 msgstr "inspect-list-applications"
11873 #: ../fish/guestfish-actions.pod:2424
11876 " inspect-list-applications root\n"
11879 " inspect-list-applications кореневий_каталог\n"
11883 #: ../fish/guestfish-actions.pod:2426 ../src/guestfs-actions.pod:3737
11884 msgid "Return the list of applications installed in the operating system."
11888 #: ../fish/guestfish-actions.pod:2428
11890 "I<Note:> This call works differently from other parts of the inspection "
11891 "API. You have to call L</inspect-os>, then L</inspect-get-mountpoints>, "
11892 "then mount up the disks, before calling this. Listing applications is a "
11893 "significantly more difficult operation which requires access to the full "
11894 "filesystem. Also note that unlike the other L</inspect-get-*> calls which "
11895 "are just returning data cached in the libguestfs handle, this call actually "
11896 "reads parts of the mounted filesystems during the call."
11900 #: ../fish/guestfish-actions.pod:2438 ../src/guestfs-actions.pod:3749
11902 "This returns an empty list if the inspection code was not able to determine "
11903 "the list of applications."
11907 #: ../fish/guestfish-actions.pod:2441 ../src/guestfs-actions.pod:3752
11908 msgid "The application structure contains the following fields:"
11912 #: ../fish/guestfish-actions.pod:2445 ../src/guestfs-actions.pod:3756
11913 msgid "C<app_name>"
11914 msgstr "C<app_name>"
11917 #: ../fish/guestfish-actions.pod:2447 ../src/guestfs-actions.pod:3758
11919 "The name of the application. For Red Hat-derived and Debian-derived Linux "
11920 "guests, this is the package name."
11924 #: ../fish/guestfish-actions.pod:2450 ../src/guestfs-actions.pod:3761
11925 msgid "C<app_display_name>"
11926 msgstr "C<app_display_name>"
11929 #: ../fish/guestfish-actions.pod:2452 ../src/guestfs-actions.pod:3763
11931 "The display name of the application, sometimes localized to the install "
11932 "language of the guest operating system."
11936 #: ../fish/guestfish-actions.pod:2455 ../src/guestfs-actions.pod:3766
11938 "If unavailable this is returned as an empty string C<\"\">. Callers needing "
11939 "to display something can use C<app_name> instead."
11943 #: ../fish/guestfish-actions.pod:2458 ../src/guestfs-actions.pod:3769
11944 msgid "C<app_epoch>"
11945 msgstr "C<app_epoch>"
11948 #: ../fish/guestfish-actions.pod:2460 ../src/guestfs-actions.pod:3771
11950 "For package managers which use epochs, this contains the epoch of the "
11951 "package (an integer). If unavailable, this is returned as C<0>."
11955 #: ../fish/guestfish-actions.pod:2463 ../src/guestfs-actions.pod:3774
11956 msgid "C<app_version>"
11957 msgstr "C<app_version>"
11960 #: ../fish/guestfish-actions.pod:2465 ../src/guestfs-actions.pod:3776
11962 "The version string of the application or package. If unavailable this is "
11963 "returned as an empty string C<\"\">."
11967 #: ../fish/guestfish-actions.pod:2468 ../src/guestfs-actions.pod:3779
11968 msgid "C<app_release>"
11969 msgstr "C<app_release>"
11972 #: ../fish/guestfish-actions.pod:2470 ../src/guestfs-actions.pod:3781
11974 "The release string of the application or package, for package managers that "
11975 "use this. If unavailable this is returned as an empty string C<\"\">."
11979 #: ../fish/guestfish-actions.pod:2474 ../src/guestfs-actions.pod:3785
11980 msgid "C<app_install_path>"
11981 msgstr "C<app_install_path>"
11984 #: ../fish/guestfish-actions.pod:2476 ../src/guestfs-actions.pod:3787
11986 "The installation path of the application (on operating systems such as "
11987 "Windows which use installation paths). This path is in the format used by "
11988 "the guest operating system, it is not a libguestfs path."
11992 #: ../fish/guestfish-actions.pod:2481 ../src/guestfs-actions.pod:3792
11993 msgid "If unavailable this is returned as an empty string C<\"\">."
11997 #: ../fish/guestfish-actions.pod:2483 ../src/guestfs-actions.pod:3794
11998 msgid "C<app_trans_path>"
11999 msgstr "C<app_trans_path>"
12002 #: ../fish/guestfish-actions.pod:2485 ../src/guestfs-actions.pod:3796
12004 "The install path translated into a libguestfs path. If unavailable this is "
12005 "returned as an empty string C<\"\">."
12009 #: ../fish/guestfish-actions.pod:2488 ../src/guestfs-actions.pod:3799
12010 msgid "C<app_publisher>"
12011 msgstr "C<app_publisher>"
12014 #: ../fish/guestfish-actions.pod:2490 ../src/guestfs-actions.pod:3801
12016 "The name of the publisher of the application, for package managers that use "
12017 "this. If unavailable this is returned as an empty string C<\"\">."
12021 #: ../fish/guestfish-actions.pod:2494 ../src/guestfs-actions.pod:3805
12023 msgstr "C<app_url>"
12026 #: ../fish/guestfish-actions.pod:2496 ../src/guestfs-actions.pod:3807
12028 "The URL (eg. upstream URL) of the application. If unavailable this is "
12029 "returned as an empty string C<\"\">."
12033 #: ../fish/guestfish-actions.pod:2499 ../src/guestfs-actions.pod:3810
12034 msgid "C<app_source_package>"
12035 msgstr "C<app_source_package>"
12038 #: ../fish/guestfish-actions.pod:2501 ../src/guestfs-actions.pod:3812
12040 "For packaging systems which support this, the name of the source package. "
12041 "If unavailable this is returned as an empty string C<\"\">."
12045 #: ../fish/guestfish-actions.pod:2504 ../src/guestfs-actions.pod:3815
12046 msgid "C<app_summary>"
12047 msgstr "C<app_summary>"
12050 #: ../fish/guestfish-actions.pod:2506 ../src/guestfs-actions.pod:3817
12052 "A short (usually one line) description of the application or package. If "
12053 "unavailable this is returned as an empty string C<\"\">."
12057 #: ../fish/guestfish-actions.pod:2509 ../src/guestfs-actions.pod:3820
12058 msgid "C<app_description>"
12059 msgstr "C<app_description>"
12062 #: ../fish/guestfish-actions.pod:2511 ../src/guestfs-actions.pod:3822
12064 "A longer description of the application or package. If unavailable this is "
12065 "returned as an empty string C<\"\">."
12069 #: ../fish/guestfish-actions.pod:2518
12071 msgstr "inspect-os"
12074 #: ../fish/guestfish-actions.pod:2520
12084 #: ../fish/guestfish-actions.pod:2522 ../src/guestfs-actions.pod:3840
12086 "This function uses other libguestfs functions and certain heuristics to "
12087 "inspect the disk(s) (usually disks belonging to a virtual machine), looking "
12088 "for operating systems."
12092 #: ../fish/guestfish-actions.pod:2526 ../src/guestfs-actions.pod:3844
12093 msgid "The list returned is empty if no operating systems were found."
12097 #: ../fish/guestfish-actions.pod:2528 ../src/guestfs-actions.pod:3846
12099 "If one operating system was found, then this returns a list with a single "
12100 "element, which is the name of the root filesystem of this operating system. "
12101 "It is also possible for this function to return a list containing more than "
12102 "one element, indicating a dual-boot or multi-boot virtual machine, with each "
12103 "element being the root filesystem of one of the operating systems."
12107 #: ../fish/guestfish-actions.pod:2535
12109 "You can pass the root string(s) returned to other L</inspect-get-*> "
12110 "functions in order to query further information about each operating system, "
12111 "such as the name and version."
12115 #: ../fish/guestfish-actions.pod:2540
12117 "This function uses other libguestfs features such as L</mount-ro> and L</"
12118 "umount-all> in order to mount and unmount filesystems and look at the "
12119 "contents. This should be called with no disks currently mounted. The "
12120 "function may also use Augeas, so any existing Augeas handle will be closed."
12124 #: ../fish/guestfish-actions.pod:2546 ../src/guestfs-actions.pod:3864
12126 "This function cannot decrypt encrypted disks. The caller must do that first "
12127 "(supplying the necessary keys) if the disk is encrypted."
12131 #: ../fish/guestfish-actions.pod:2552 ../fish/guestfish-actions.pod:2750
12132 #: ../fish/guestfish-actions.pod:2815
12133 msgid "See also L</list-filesystems>."
12134 msgstr "Див. також L</list-filesystems>."
12137 #: ../fish/guestfish-actions.pod:2554
12138 msgid "is-blockdev"
12139 msgstr "is-blockdev"
12142 #: ../fish/guestfish-actions.pod:2556
12145 " is-blockdev path\n"
12148 " is-blockdev шлях\n"
12152 #: ../fish/guestfish-actions.pod:2558 ../src/guestfs-actions.pod:3884
12154 "This returns C<true> if and only if there is a block device with the given "
12159 #: ../fish/guestfish-actions.pod:2561 ../fish/guestfish-actions.pod:2579
12160 #: ../fish/guestfish-actions.pod:2598 ../fish/guestfish-actions.pod:2607
12161 #: ../fish/guestfish-actions.pod:2617 ../fish/guestfish-actions.pod:2651
12162 #: ../fish/guestfish-actions.pod:2660
12163 msgid "See also L</stat>."
12164 msgstr "Див. також L</stat>."
12167 #: ../fish/guestfish-actions.pod:2563
12172 #: ../fish/guestfish-actions.pod:2565
12182 #: ../fish/guestfish-actions.pod:2567 ../src/guestfs-actions.pod:3898
12184 "This returns true iff this handle is busy processing a command (in the "
12189 #: ../fish/guestfish-actions.pod:2572
12191 msgstr "is-chardev"
12194 #: ../fish/guestfish-actions.pod:2574
12197 " is-chardev path\n"
12200 " is-chardev шлях\n"
12204 #: ../fish/guestfish-actions.pod:2576 ../src/guestfs-actions.pod:3913
12206 "This returns C<true> if and only if there is a character device with the "
12207 "given C<path> name."
12211 #: ../fish/guestfish-actions.pod:2581
12216 #: ../fish/guestfish-actions.pod:2583
12226 #: ../fish/guestfish-actions.pod:2585 ../src/guestfs-actions.pod:3927
12228 "This returns true iff this handle is being configured (in the C<CONFIG> "
12233 #: ../fish/guestfish-actions.pod:2590
12238 #: ../fish/guestfish-actions.pod:2592
12248 #: ../fish/guestfish-actions.pod:2594 ../src/guestfs-actions.pod:3942
12250 "This returns C<true> if and only if there is a directory with the given "
12251 "C<path> name. Note that it returns false for other objects like files."
12255 #: ../fish/guestfish-actions.pod:2600
12260 #: ../fish/guestfish-actions.pod:2602
12270 #: ../fish/guestfish-actions.pod:2604 ../src/guestfs-actions.pod:3958
12272 "This returns C<true> if and only if there is a FIFO (named pipe) with the "
12273 "given C<path> name."
12277 #: ../fish/guestfish-actions.pod:2609
12282 #: ../fish/guestfish-actions.pod:2611
12292 #: ../fish/guestfish-actions.pod:2613 ../src/guestfs-actions.pod:3973
12294 "This returns C<true> if and only if there is a regular file with the given "
12295 "C<path> name. Note that it returns false for other objects like directories."
12299 #: ../fish/guestfish-actions.pod:2619
12300 msgid "is-launching"
12301 msgstr "is-launching"
12304 #: ../fish/guestfish-actions.pod:2621
12314 #: ../fish/guestfish-actions.pod:2623 ../src/guestfs-actions.pod:3988
12316 "This returns true iff this handle is launching the subprocess (in the "
12317 "C<LAUNCHING> state)."
12321 #: ../fish/guestfish-actions.pod:2628
12326 #: ../fish/guestfish-actions.pod:2630
12332 " is-lv пристрій\n"
12336 #: ../fish/guestfish-actions.pod:2632 ../src/guestfs-actions.pod:4003
12338 "This command tests whether C<device> is a logical volume, and returns true "
12339 "iff this is the case."
12343 #: ../fish/guestfish-actions.pod:2635
12348 #: ../fish/guestfish-actions.pod:2637
12358 #: ../fish/guestfish-actions.pod:2639 ../src/guestfs-actions.pod:4015
12360 "This returns true iff this handle is ready to accept commands (in the "
12365 #: ../fish/guestfish-actions.pod:2644
12370 #: ../fish/guestfish-actions.pod:2646
12373 " is-socket path\n"
12376 " is-socket шлях\n"
12380 #: ../fish/guestfish-actions.pod:2648 ../src/guestfs-actions.pod:4030
12382 "This returns C<true> if and only if there is a Unix domain socket with the "
12383 "given C<path> name."
12387 #: ../fish/guestfish-actions.pod:2653
12389 msgstr "is-symlink"
12392 #: ../fish/guestfish-actions.pod:2655
12395 " is-symlink path\n"
12398 " is-symlink шлях\n"
12402 #: ../fish/guestfish-actions.pod:2657 ../src/guestfs-actions.pod:4045
12404 "This returns C<true> if and only if there is a symbolic link with the given "
12409 #: ../fish/guestfish-actions.pod:2662
12414 #: ../fish/guestfish-actions.pod:2664
12422 #: ../fish/guestfish-actions.pod:2666 ../src/guestfs-actions.pod:4060
12424 "This returns true iff the file exists and the file is empty or it contains "
12429 #: ../fish/guestfish-actions.pod:2669
12430 msgid "is-zero-device"
12434 #: ../fish/guestfish-actions.pod:2671
12437 " is-zero-device device\n"
12442 #: ../fish/guestfish-actions.pod:2673 ../src/guestfs-actions.pod:4073
12443 msgid "This returns true iff the device exists and contains all zero bytes."
12447 #: ../fish/guestfish-actions.pod:2675 ../src/guestfs-actions.pod:4075
12448 msgid "Note that for large devices this can take a long time to run."
12452 #: ../fish/guestfish-actions.pod:2677
12453 msgid "kill-subprocess"
12454 msgstr "kill-subprocess"
12457 #: ../fish/guestfish-actions.pod:2679
12460 " kill-subprocess\n"
12463 " kill-subprocess\n"
12467 #: ../fish/guestfish-actions.pod:2681 ../src/guestfs-actions.pod:4086
12468 msgid "This kills the qemu subprocess. You should never need to call this."
12472 #: ../fish/guestfish-actions.pod:2683
12477 #: ../fish/guestfish-actions.pod:2685
12482 #: ../fish/guestfish-actions.pod:2687
12492 #: ../fish/guestfish-actions.pod:2689 ../src/guestfs-actions.pod:4097
12494 "Internally libguestfs is implemented by running a virtual machine using "
12499 #: ../fish/guestfish-actions.pod:2692 ../src/guestfs-actions.pod:4100
12501 "You should call this after configuring the handle (eg. adding drives) but "
12502 "before performing any actions."
12506 #: ../fish/guestfish-actions.pod:2695
12511 #: ../fish/guestfish-actions.pod:2697
12514 " lchown owner group path\n"
12517 " lchown власник група шлях\n"
12521 #: ../fish/guestfish-actions.pod:2699
12523 "Change the file owner to C<owner> and group to C<group>. This is like L</"
12524 "chown> but if C<path> is a symlink then the link itself is changed, not the "
12529 #: ../fish/guestfish-actions.pod:2707
12534 #: ../fish/guestfish-actions.pod:2709
12537 " lgetxattr path name\n"
12540 " lgetxattr шлях назва\n"
12544 #: ../fish/guestfish-actions.pod:2711 ../src/guestfs-actions.pod:4140
12546 "Get a single extended attribute from file C<path> named C<name>. If C<path> "
12547 "is a symlink, then this call returns an extended attribute from the symlink."
12551 #: ../fish/guestfish-actions.pod:2725
12552 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>."
12553 msgstr "Див. також L</lgetxattrs>, L</getxattr>, L<attr(5)>."
12556 #: ../fish/guestfish-actions.pod:2727
12558 msgstr "lgetxattrs"
12561 #: ../fish/guestfish-actions.pod:2729
12564 " lgetxattrs path\n"
12567 " lgetxattrs шлях\n"
12571 #: ../fish/guestfish-actions.pod:2731
12573 "This is the same as L</getxattrs>, but if C<path> is a symbolic link, then "
12574 "it returns the extended attributes of the link itself."
12578 #: ../fish/guestfish-actions.pod:2735
12583 #: ../fish/guestfish-actions.pod:2737
12591 #: ../fish/guestfish-actions.pod:2739 ../src/guestfs-actions.pod:4183
12593 "List all 9p filesystems attached to the guest. A list of mount tags is "
12598 #: ../fish/guestfish-actions.pod:2742
12599 msgid "list-devices"
12600 msgstr "list-devices"
12603 #: ../fish/guestfish-actions.pod:2744
12613 #: ../fish/guestfish-actions.pod:2746 ../src/guestfs-actions.pod:4197
12614 msgid "List all the block devices."
12618 #: ../fish/guestfish-actions.pod:2748 ../src/guestfs-actions.pod:4199
12619 msgid "The full block device names are returned, eg. C</dev/sda>."
12623 #: ../fish/guestfish-actions.pod:2752
12624 msgid "list-dm-devices"
12628 #: ../fish/guestfish-actions.pod:2754
12631 " list-dm-devices\n"
12636 #: ../fish/guestfish-actions.pod:2756 ../src/guestfs-actions.pod:4214
12637 msgid "List all device mapper devices."
12641 #: ../fish/guestfish-actions.pod:2758
12643 "The returned list contains C</dev/mapper/*> devices, eg. ones created by a "
12644 "previous call to L</luks-open>."
12648 #: ../fish/guestfish-actions.pod:2761
12650 "Device mapper devices which correspond to logical volumes are I<not> "
12651 "returned in this list. Call L</lvs> if you want to list logical volumes."
12655 #: ../fish/guestfish-actions.pod:2765
12656 msgid "list-filesystems"
12657 msgstr "list-filesystems"
12660 #: ../fish/guestfish-actions.pod:2767
12663 " list-filesystems\n"
12666 " list-filesystems\n"
12670 #: ../fish/guestfish-actions.pod:2769 ../src/guestfs-actions.pod:4234
12672 "This inspection command looks for filesystems on partitions, block devices "
12673 "and logical volumes, returning a list of devices containing filesystems and "
12678 #: ../fish/guestfish-actions.pod:2773 ../src/guestfs-actions.pod:4238
12680 "The return value is a hash, where the keys are the devices containing "
12681 "filesystems, and the values are the filesystem types. For example:"
12685 #: ../fish/guestfish-actions.pod:2777 ../src/guestfs-actions.pod:4242
12688 " \"/dev/sda1\" => \"ntfs\"\n"
12689 " \"/dev/sda2\" => \"ext2\"\n"
12690 " \"/dev/vg_guest/lv_root\" => \"ext4\"\n"
12691 " \"/dev/vg_guest/lv_swap\" => \"swap\"\n"
12696 #: ../fish/guestfish-actions.pod:2782 ../src/guestfs-actions.pod:4247
12698 "The value can have the special value \"unknown\", meaning the content of the "
12699 "device is undetermined or empty. \"swap\" means a Linux swap partition."
12703 #: ../fish/guestfish-actions.pod:2786
12705 "This command runs other libguestfs commands, which might include L</mount> "
12706 "and L</umount>, and therefore you should use this soon after launch and only "
12707 "when nothing is mounted."
12711 #: ../fish/guestfish-actions.pod:2790
12713 "Not all of the filesystems returned will be mountable. In particular, swap "
12714 "partitions are returned in the list. Also this command does not check that "
12715 "each filesystem found is valid and mountable, and some filesystems might be "
12716 "mountable but require special options. Filesystems may not all belong to a "
12717 "single logical operating system (use L</inspect-os> to look for OSes)."
12721 #: ../fish/guestfish-actions.pod:2798
12723 #| msgid "list-devices"
12724 msgid "list-md-devices"
12725 msgstr "list-devices"
12728 #: ../fish/guestfish-actions.pod:2800
12731 #| " list-devices\n"
12734 " list-md-devices\n"
12741 #: ../fish/guestfish-actions.pod:2802 ../src/guestfs-actions.pod:4276
12742 msgid "List all Linux md devices."
12746 #: ../fish/guestfish-actions.pod:2804
12747 msgid "list-partitions"
12748 msgstr "list-partitions"
12751 #: ../fish/guestfish-actions.pod:2806
12754 " list-partitions\n"
12757 " list-partitions\n"
12761 #: ../fish/guestfish-actions.pod:2808 ../src/guestfs-actions.pod:4287
12762 msgid "List all the partitions detected on all block devices."
12766 #: ../fish/guestfish-actions.pod:2810 ../src/guestfs-actions.pod:4289
12767 msgid "The full partition device names are returned, eg. C</dev/sda1>"
12771 #: ../fish/guestfish-actions.pod:2812
12773 "This does not return logical volumes. For that you will need to call L</"
12778 #: ../fish/guestfish-actions.pod:2817
12783 #: ../fish/guestfish-actions.pod:2819
12793 #: ../fish/guestfish-actions.pod:2821 ../src/guestfs-actions.pod:4308
12795 "List the files in C<directory> (relative to the root directory, there is no "
12796 "cwd) in the format of 'ls -la'."
12800 #: ../fish/guestfish-actions.pod:2824 ../src/guestfs-actions.pod:4311
12802 "This command is mostly useful for interactive sessions. It is I<not> "
12803 "intended that you try to parse the output string."
12807 #: ../fish/guestfish-actions.pod:2827
12812 #: ../fish/guestfish-actions.pod:2829
12815 " ln target linkname\n"
12818 " ln призначення назва_посилання\n"
12822 #: ../fish/guestfish-actions.pod:2831 ../src/guestfs-actions.pod:4326
12823 msgid "This command creates a hard link using the C<ln> command."
12827 #: ../fish/guestfish-actions.pod:2833
12832 #: ../fish/guestfish-actions.pod:2835
12835 " ln-f target linkname\n"
12838 " ln-f призначення назва_посилання\n"
12842 #: ../fish/guestfish-actions.pod:2837 ../src/guestfs-actions.pod:4339
12844 "This command creates a hard link using the C<ln -f> command. The I<-f> "
12845 "option removes the link (C<linkname>) if it exists already."
12849 #: ../fish/guestfish-actions.pod:2840
12854 #: ../fish/guestfish-actions.pod:2842
12857 " ln-s target linkname\n"
12860 " ln-s призначення назва_посилання\n"
12864 #: ../fish/guestfish-actions.pod:2844 ../src/guestfs-actions.pod:4353
12865 msgid "This command creates a symbolic link using the C<ln -s> command."
12869 #: ../fish/guestfish-actions.pod:2846
12874 #: ../fish/guestfish-actions.pod:2848
12877 " ln-sf target linkname\n"
12880 " ln-sf призначення назва_посилання\n"
12884 #: ../fish/guestfish-actions.pod:2850 ../src/guestfs-actions.pod:4366
12886 "This command creates a symbolic link using the C<ln -sf> command, The I<-f> "
12887 "option removes the link (C<linkname>) if it exists already."
12891 #: ../fish/guestfish-actions.pod:2853
12892 msgid "lremovexattr"
12893 msgstr "lremovexattr"
12896 #: ../fish/guestfish-actions.pod:2855
12899 " lremovexattr xattr path\n"
12904 #: ../fish/guestfish-actions.pod:2857
12906 "This is the same as L</removexattr>, but if C<path> is a symbolic link, then "
12907 "it removes an extended attribute of the link itself."
12911 #: ../fish/guestfish-actions.pod:2861
12916 #: ../fish/guestfish-actions.pod:2863
12926 #: ../fish/guestfish-actions.pod:2865 ../src/guestfs-actions.pod:4394
12928 "List the files in C<directory> (relative to the root directory, there is no "
12929 "cwd). The '.' and '..' entries are not returned, but hidden files are shown."
12933 #: ../fish/guestfish-actions.pod:2869
12935 "This command is mostly useful for interactive sessions. Programs should "
12936 "probably use L</readdir> instead."
12940 #: ../fish/guestfish-actions.pod:2872
12945 #: ../fish/guestfish-actions.pod:2874
12948 " lsetxattr xattr val vallen path\n"
12953 #: ../fish/guestfish-actions.pod:2876
12955 "This is the same as L</setxattr>, but if C<path> is a symbolic link, then it "
12956 "sets an extended attribute of the link itself."
12960 #: ../fish/guestfish-actions.pod:2880
12965 #: ../fish/guestfish-actions.pod:2882
12975 #: ../fish/guestfish-actions.pod:2884 ../fish/guestfish-actions.pod:4775
12976 #: ../src/guestfs-actions.pod:4430 ../src/guestfs-actions.pod:7349
12977 msgid "Returns file information for the given C<path>."
12981 #: ../fish/guestfish-actions.pod:2886
12983 "This is the same as L</stat> except that if C<path> is a symbolic link, then "
12984 "the link is stat-ed, not the file it refers to."
12988 #: ../fish/guestfish-actions.pod:2890 ../src/guestfs-actions.pod:4436
12989 msgid "This is the same as the C<lstat(2)> system call."
12993 #: ../fish/guestfish-actions.pod:2892
12998 #: ../fish/guestfish-actions.pod:2894
13001 " lstatlist path 'names ...'\n"
13006 #: ../fish/guestfish-actions.pod:2896
13008 "This call allows you to perform the L</lstat> operation on multiple files, "
13009 "where all files are in the directory C<path>. C<names> is the list of files "
13010 "from this directory."
13014 #: ../fish/guestfish-actions.pod:2900 ../src/guestfs-actions.pod:4455
13016 "On return you get a list of stat structs, with a one-to-one correspondence "
13017 "to the C<names> list. If any name did not exist or could not be lstat'd, "
13018 "then the C<ino> field of that structure is set to C<-1>."
13022 #: ../fish/guestfish-actions.pod:2905
13024 "This call is intended for programs that want to efficiently list a directory "
13025 "contents without making many round-trips. See also L</lxattrlist> for a "
13026 "similarly efficient call for getting extended attributes. Very long "
13027 "directory listings might cause the protocol message size to be exceeded, "
13028 "causing this call to fail. The caller must split up such requests into "
13029 "smaller groups of names."
13033 #: ../fish/guestfish-actions.pod:2913
13034 msgid "luks-add-key"
13035 msgstr "luks-add-key"
13038 #: ../fish/guestfish-actions.pod:2915
13041 " luks-add-key device keyslot\n"
13046 #: ../fish/guestfish-actions.pod:2917 ../src/guestfs-actions.pod:4483
13048 "This command adds a new key on LUKS device C<device>. C<key> is any "
13049 "existing key, and is used to access the device. C<newkey> is the new key to "
13050 "add. C<keyslot> is the key slot that will be replaced."
13054 #: ../fish/guestfish-actions.pod:2922
13056 "Note that if C<keyslot> already contains a key, then this command will "
13057 "fail. You have to use L</luks-kill-slot> first to remove that key."
13061 #: ../fish/guestfish-actions.pod:2926 ../fish/guestfish-actions.pod:2948
13062 #: ../fish/guestfish-actions.pod:2958 ../fish/guestfish-actions.pod:2969
13063 #: ../fish/guestfish-actions.pod:2995 ../fish/guestfish-actions.pod:3005
13065 "This command has one or more key or passphrase parameters. Guestfish will "
13066 "prompt for these separately."
13070 #: ../fish/guestfish-actions.pod:2929
13072 msgstr "luks-close"
13075 #: ../fish/guestfish-actions.pod:2931
13078 " luks-close device\n"
13081 " luks-close пристрій\n"
13085 #: ../fish/guestfish-actions.pod:2933
13087 "This closes a LUKS device that was created earlier by L</luks-open> or L</"
13088 "luks-open-ro>. The C<device> parameter must be the name of the LUKS mapping "
13089 "device (ie. C</dev/mapper/mapname>) and I<not> the name of the underlying "
13094 #: ../fish/guestfish-actions.pod:2939
13095 msgid "luks-format"
13096 msgstr "luks-format"
13099 #: ../fish/guestfish-actions.pod:2941
13102 " luks-format device keyslot\n"
13107 #: ../fish/guestfish-actions.pod:2943 ../src/guestfs-actions.pod:4524
13109 "This command erases existing data on C<device> and formats the device as a "
13110 "LUKS encrypted device. C<key> is the initial key, which is added to key "
13111 "slot C<slot>. (LUKS supports 8 key slots, numbered 0-7)."
13115 #: ../fish/guestfish-actions.pod:2951
13116 msgid "luks-format-cipher"
13117 msgstr "luks-format-cipher"
13120 #: ../fish/guestfish-actions.pod:2953
13123 " luks-format-cipher device keyslot cipher\n"
13128 #: ../fish/guestfish-actions.pod:2955
13130 "This command is the same as L</luks-format> but it also allows you to set "
13131 "the C<cipher> used."
13135 #: ../fish/guestfish-actions.pod:2961
13136 msgid "luks-kill-slot"
13137 msgstr "luks-kill-slot"
13140 #: ../fish/guestfish-actions.pod:2963
13143 " luks-kill-slot device keyslot\n"
13148 #: ../fish/guestfish-actions.pod:2965 ../src/guestfs-actions.pod:4565
13150 "This command deletes the key in key slot C<keyslot> from the encrypted LUKS "
13151 "device C<device>. C<key> must be one of the I<other> keys."
13155 #: ../fish/guestfish-actions.pod:2972
13160 #: ../fish/guestfish-actions.pod:2974
13163 " luks-open device mapname\n"
13168 #: ../fish/guestfish-actions.pod:2976 ../src/guestfs-actions.pod:4585
13170 "This command opens a block device which has been encrypted according to the "
13171 "Linux Unified Key Setup (LUKS) standard."
13175 #: ../fish/guestfish-actions.pod:2979 ../src/guestfs-actions.pod:4588
13176 msgid "C<device> is the encrypted block device or partition."
13180 #: ../fish/guestfish-actions.pod:2981 ../src/guestfs-actions.pod:4590
13182 "The caller must supply one of the keys associated with the LUKS block "
13183 "device, in the C<key> parameter."
13187 #: ../fish/guestfish-actions.pod:2984 ../src/guestfs-actions.pod:4593
13189 "This creates a new block device called C</dev/mapper/mapname>. Reads and "
13190 "writes to this block device are decrypted from and encrypted to the "
13191 "underlying C<device> respectively."
13195 #: ../fish/guestfish-actions.pod:2988
13197 "If this block device contains LVM volume groups, then calling L</vgscan> "
13198 "followed by L</vg-activate-all> will make them visible."
13202 #: ../fish/guestfish-actions.pod:2992
13203 msgid "Use L</list-dm-devices> to list all device mapper devices."
13207 #: ../fish/guestfish-actions.pod:2998
13208 msgid "luks-open-ro"
13209 msgstr "luks-open-ro"
13212 #: ../fish/guestfish-actions.pod:3000
13215 " luks-open-ro device mapname\n"
13220 #: ../fish/guestfish-actions.pod:3002
13222 "This is the same as L</luks-open> except that a read-only mapping is created."
13226 #: ../fish/guestfish-actions.pod:3008
13231 #: ../fish/guestfish-actions.pod:3010
13234 " lvcreate logvol volgroup mbytes\n"
13239 #: ../fish/guestfish-actions.pod:3012 ../src/guestfs-actions.pod:4639
13241 "This creates an LVM logical volume called C<logvol> on the volume group "
13242 "C<volgroup>, with C<size> megabytes."
13246 #: ../fish/guestfish-actions.pod:3015
13247 msgid "lvm-canonical-lv-name"
13248 msgstr "lvm-canonical-lv-name"
13251 #: ../fish/guestfish-actions.pod:3017
13254 " lvm-canonical-lv-name lvname\n"
13259 #: ../fish/guestfish-actions.pod:3019 ../src/guestfs-actions.pod:4652
13261 "This converts alternative naming schemes for LVs that you might find to the "
13262 "canonical name. For example, C</dev/mapper/VG-LV> is converted to C</dev/VG/"
13267 #: ../fish/guestfish-actions.pod:3023 ../src/guestfs-actions.pod:4656
13269 "This command returns an error if the C<lvname> parameter does not refer to a "
13274 #: ../fish/guestfish-actions.pod:3026
13275 msgid "See also L</is-lv>."
13276 msgstr "Див. також L</is-lv>."
13279 #: ../fish/guestfish-actions.pod:3028
13280 msgid "lvm-clear-filter"
13281 msgstr "lvm-clear-filter"
13284 #: ../fish/guestfish-actions.pod:3030
13287 " lvm-clear-filter\n"
13290 " lvm-clear-filter\n"
13294 #: ../fish/guestfish-actions.pod:3032
13296 "This undoes the effect of L</lvm-set-filter>. LVM will be able to see every "
13301 #: ../fish/guestfish-actions.pod:3035 ../fish/guestfish-actions.pod:3063
13302 #: ../src/guestfs-actions.pod:4674 ../src/guestfs-actions.pod:4713
13304 "This command also clears the LVM cache and performs a volume group scan."
13308 #: ../fish/guestfish-actions.pod:3038
13309 msgid "lvm-remove-all"
13310 msgstr "lvm-remove-all"
13313 #: ../fish/guestfish-actions.pod:3040
13316 " lvm-remove-all\n"
13319 " lvm-remove-all\n"
13323 #: ../fish/guestfish-actions.pod:3042 ../src/guestfs-actions.pod:4686
13325 "This command removes all LVM logical volumes, volume groups and physical "
13330 #: ../fish/guestfish-actions.pod:3045
13331 msgid "lvm-set-filter"
13332 msgstr "lvm-set-filter"
13335 #: ../fish/guestfish-actions.pod:3047
13338 " lvm-set-filter 'devices ...'\n"
13341 " lvm-set-filter 'пристрої...'\n"
13345 #: ../fish/guestfish-actions.pod:3049 ../src/guestfs-actions.pod:4699
13347 "This sets the LVM device filter so that LVM will only be able to \"see\" the "
13348 "block devices in the list C<devices>, and will ignore all other attached "
13353 #: ../fish/guestfish-actions.pod:3053 ../src/guestfs-actions.pod:4703
13355 "Where disk image(s) contain duplicate PVs or VGs, this command is useful to "
13356 "get LVM to ignore the duplicates, otherwise LVM can get confused. Note also "
13357 "there are two types of duplication possible: either cloned PVs/VGs which "
13358 "have identical UUIDs; or VGs that are not cloned but just happen to have the "
13359 "same name. In normal operation you cannot create this situation, but you "
13360 "can do it outside LVM, eg. by cloning disk images or by bit twiddling "
13361 "inside the LVM metadata."
13365 #: ../fish/guestfish-actions.pod:3066 ../src/guestfs-actions.pod:4716
13366 msgid "You can filter whole block devices or individual partitions."
13370 #: ../fish/guestfish-actions.pod:3068 ../src/guestfs-actions.pod:4718
13372 "You cannot use this if any VG is currently in use (eg. contains a mounted "
13373 "filesystem), even if you are not filtering out that VG."
13377 #: ../fish/guestfish-actions.pod:3072
13382 #: ../fish/guestfish-actions.pod:3074
13385 " lvremove device\n"
13388 " lvremove пристрій\n"
13392 #: ../fish/guestfish-actions.pod:3076 ../src/guestfs-actions.pod:4732
13394 "Remove an LVM logical volume C<device>, where C<device> is the path to the "
13395 "LV, such as C</dev/VG/LV>."
13399 #: ../fish/guestfish-actions.pod:3079 ../src/guestfs-actions.pod:4735
13401 "You can also remove all LVs in a volume group by specifying the VG name, C</"
13406 #: ../fish/guestfish-actions.pod:3082
13411 #: ../fish/guestfish-actions.pod:3084
13414 " lvrename logvol newlogvol\n"
13419 #: ../fish/guestfish-actions.pod:3086 ../src/guestfs-actions.pod:4749
13420 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>."
13424 #: ../fish/guestfish-actions.pod:3088
13429 #: ../fish/guestfish-actions.pod:3090
13432 " lvresize device mbytes\n"
13437 #: ../fish/guestfish-actions.pod:3092 ../src/guestfs-actions.pod:4762
13439 "This resizes (expands or shrinks) an existing LVM logical volume to "
13440 "C<mbytes>. When reducing, data in the reduced part is lost."
13444 #: ../fish/guestfish-actions.pod:3096
13445 msgid "lvresize-free"
13446 msgstr "lvresize-free"
13449 #: ../fish/guestfish-actions.pod:3098
13452 " lvresize-free lv percent\n"
13457 #: ../fish/guestfish-actions.pod:3100 ../src/guestfs-actions.pod:4777
13459 "This expands an existing logical volume C<lv> so that it fills C<pc>% of the "
13460 "remaining free space in the volume group. Commonly you would call this with "
13461 "pc = 100 which expands the logical volume as much as possible, using all "
13462 "remaining free space in the volume group."
13466 #: ../fish/guestfish-actions.pod:3106
13471 #: ../fish/guestfish-actions.pod:3108
13481 #: ../fish/guestfish-actions.pod:3110 ../src/guestfs-actions.pod:4792
13483 "List all the logical volumes detected. This is the equivalent of the L<lvs"
13488 #: ../fish/guestfish-actions.pod:3113 ../src/guestfs-actions.pod:4795
13490 "This returns a list of the logical volume device names (eg. C</dev/"
13491 "VolGroup00/LogVol00>)."
13495 #: ../fish/guestfish-actions.pod:3116
13496 msgid "See also L</lvs-full>, L</list-filesystems>."
13497 msgstr "Див. також L</lvs-full>, L</list-filesystems>."
13500 #: ../fish/guestfish-actions.pod:3118
13505 #: ../fish/guestfish-actions.pod:3120
13515 #: ../fish/guestfish-actions.pod:3122 ../src/guestfs-actions.pod:4811
13517 "List all the logical volumes detected. This is the equivalent of the L<lvs"
13518 "(8)> command. The \"full\" version includes all fields."
13522 #: ../fish/guestfish-actions.pod:3125
13527 #: ../fish/guestfish-actions.pod:3127
13533 " lvuuid пристрій\n"
13537 #: ../fish/guestfish-actions.pod:3129 ../src/guestfs-actions.pod:4826
13538 msgid "This command returns the UUID of the LVM LV C<device>."
13542 #: ../fish/guestfish-actions.pod:3131
13544 msgstr "lxattrlist"
13547 #: ../fish/guestfish-actions.pod:3133
13550 " lxattrlist path 'names ...'\n"
13555 #: ../fish/guestfish-actions.pod:3135 ../src/guestfs-actions.pod:4840
13557 "This call allows you to get the extended attributes of multiple files, where "
13558 "all files are in the directory C<path>. C<names> is the list of files from "
13563 #: ../fish/guestfish-actions.pod:3139 ../src/guestfs-actions.pod:4844
13565 "On return you get a flat list of xattr structs which must be interpreted "
13566 "sequentially. The first xattr struct always has a zero-length C<attrname>. "
13567 "C<attrval> in this struct is zero-length to indicate there was an error "
13568 "doing C<lgetxattr> for this file, I<or> is a C string which is a decimal "
13569 "number (the number of following attributes for this file, which could be C<"
13570 "\"0\">). Then after the first xattr struct are the zero or more attributes "
13571 "for the first named file. This repeats for the second and subsequent files."
13575 #: ../fish/guestfish-actions.pod:3149
13577 "This call is intended for programs that want to efficiently list a directory "
13578 "contents without making many round-trips. See also L</lstatlist> for a "
13579 "similarly efficient call for getting standard stats. Very long directory "
13580 "listings might cause the protocol message size to be exceeded, causing this "
13581 "call to fail. The caller must split up such requests into smaller groups of "
13586 #: ../fish/guestfish-actions.pod:3157
13588 #| msgid "lvcreate"
13589 msgid "mdadm-create"
13593 #: ../fish/guestfish-actions.pod:3159
13596 " mdadm-create name 'devices ...' [missingbitmap:N] [nrdevices:N] [spare:N] [chunk:N] [level:..]\n"
13601 #: ../fish/guestfish-actions.pod:3161 ../src/guestfs-actions.pod:4887
13603 "Create a Linux md (RAID) device named C<name> on the devices in the list "
13608 #: ../fish/guestfish-actions.pod:3168 ../src/guestfs-actions.pod:4894
13609 msgid "C<missingbitmap>"
13613 #: ../fish/guestfish-actions.pod:3170 ../src/guestfs-actions.pod:4896
13615 "A bitmap of missing devices. If a bit is set it means that a missing device "
13616 "is added to the array. The least significant bit corresponds to the first "
13617 "device in the array."
13621 #: ../fish/guestfish-actions.pod:3174 ../src/guestfs-actions.pod:4900
13623 #| msgid "For example:"
13624 msgid "As examples:"
13628 #: ../fish/guestfish-actions.pod:3176 ../src/guestfs-actions.pod:4902
13630 "If C<devices = [\"/dev/sda\"]> and C<missingbitmap = 0x1> then the resulting "
13631 "array would be C<[E<lt>missingE<gt>, \"/dev/sda\"]>."
13635 #: ../fish/guestfish-actions.pod:3179 ../src/guestfs-actions.pod:4905
13637 "If C<devices = [\"/dev/sda\"]> and C<missingbitmap = 0x2> then the resulting "
13638 "array would be C<[\"/dev/sda\", E<lt>missingE<gt>]>."
13642 #: ../fish/guestfish-actions.pod:3182 ../src/guestfs-actions.pod:4908
13643 msgid "This defaults to C<0> (no missing devices)."
13647 #: ../fish/guestfish-actions.pod:3184 ../src/guestfs-actions.pod:4910
13649 "The length of C<devices> + the number of bits set in C<missingbitmap> must "
13650 "equal C<nrdevices> + C<spare>."
13654 #: ../fish/guestfish-actions.pod:3187 ../src/guestfs-actions.pod:4913
13657 msgid "C<nrdevices>"
13661 #: ../fish/guestfish-actions.pod:3189 ../src/guestfs-actions.pod:4915
13663 #| msgid "The number of hard links."
13664 msgid "The number of active RAID devices."
13665 msgstr "Кількість жорстких посилань."
13668 #: ../fish/guestfish-actions.pod:3191 ../src/guestfs-actions.pod:4917
13670 "If not set, this defaults to the length of C<devices> plus the number of "
13671 "bits set in C<missingbitmap>."
13675 #: ../fish/guestfish-actions.pod:3194 ../src/guestfs-actions.pod:4920
13682 #: ../fish/guestfish-actions.pod:3196 ../src/guestfs-actions.pod:4922
13684 #| msgid "The number of hard links."
13685 msgid "The number of spare devices."
13686 msgstr "Кількість жорстких посилань."
13689 #: ../fish/guestfish-actions.pod:3198 ../src/guestfs-actions.pod:4924
13690 msgid "If not set, this defaults to C<0>."
13694 #: ../fish/guestfish-actions.pod:3200 ../src/guestfs-actions.pod:4926
13699 #: ../fish/guestfish-actions.pod:3202 ../src/guestfs-actions.pod:4928
13701 #| msgid "The size in SI 1000 byte units."
13702 msgid "The chunk size in bytes."
13703 msgstr "Розмір у одиницях СІ: 1000 байтів."
13706 #: ../fish/guestfish-actions.pod:3204 ../fish/guestfish-actions.pod:3226
13707 #: ../src/guestfs-actions.pod:4930 ../src/guestfs-actions.pod:4978
13712 #: ../fish/guestfish-actions.pod:3206 ../src/guestfs-actions.pod:4932
13714 "The RAID level, which can be one of: I<linear>, I<raid0>, I<0>, I<stripe>, "
13715 "I<raid1>, I<1>, I<mirror>, I<raid4>, I<4>, I<raid5>, I<5>, I<raid6>, I<6>, "
13716 "I<raid10>, I<10>. Some of these are synonymous, and more levels may be "
13721 #: ../fish/guestfish-actions.pod:3211 ../src/guestfs-actions.pod:4937
13722 msgid "If not set, this defaults to C<raid1>."
13726 #: ../fish/guestfish-actions.pod:3217
13727 msgid "mdadm-detail"
13731 #: ../fish/guestfish-actions.pod:3219
13734 " mdadm-detail md\n"
13739 #: ../fish/guestfish-actions.pod:3221 ../src/guestfs-actions.pod:4973
13741 "This command exposes the output of 'mdadm -DY <md>'. The following fields "
13742 "are usually present in the returned hash. Other fields may also be present."
13746 #: ../fish/guestfish-actions.pod:3228 ../src/guestfs-actions.pod:4980
13747 msgid "The raid level of the MD device."
13751 #: ../fish/guestfish-actions.pod:3230 ../src/guestfs-actions.pod:4982
13758 #: ../fish/guestfish-actions.pod:3232 ../src/guestfs-actions.pod:4984
13759 msgid "The number of underlying devices in the MD device."
13763 #: ../fish/guestfish-actions.pod:3234 ../src/guestfs-actions.pod:4986
13764 msgid "C<metadata>"
13768 #: ../fish/guestfish-actions.pod:3236 ../src/guestfs-actions.pod:4988
13769 msgid "The metadata version used."
13773 #: ../fish/guestfish-actions.pod:3238 ../src/guestfs-actions.pod:4990
13775 #| msgid "B<--uuid>"
13780 #: ../fish/guestfish-actions.pod:3240 ../src/guestfs-actions.pod:4992
13781 msgid "The UUID of the MD device."
13785 #: ../fish/guestfish-actions.pod:3244 ../src/guestfs-actions.pod:4996
13787 #| msgid "The time of last access."
13788 msgid "The name of the MD device."
13789 msgstr "Час останнього доступу."
13792 #: ../fish/guestfish-actions.pod:3248
13797 #: ../fish/guestfish-actions.pod:3250
13807 #: ../fish/guestfish-actions.pod:3252 ../src/guestfs-actions.pod:5012
13808 msgid "Create a directory named C<path>."
13812 #: ../fish/guestfish-actions.pod:3254
13814 msgstr "mkdir-mode"
13817 #: ../fish/guestfish-actions.pod:3256
13820 " mkdir-mode path mode\n"
13823 " mkdir-mode шлях режим\n"
13827 #: ../fish/guestfish-actions.pod:3258 ../src/guestfs-actions.pod:5025
13829 "This command creates a directory, setting the initial permissions of the "
13830 "directory to C<mode>."
13834 #: ../fish/guestfish-actions.pod:3261 ../src/guestfs-actions.pod:5028
13836 "For common Linux filesystems, the actual mode which is set will be C<mode & "
13837 "~umask & 01777>. Non-native-Linux filesystems may interpret the mode in "
13842 #: ../fish/guestfish-actions.pod:3265
13843 msgid "See also L</mkdir>, L</umask>"
13844 msgstr "Див. також L</mkdir>, L</umask>"
13847 #: ../fish/guestfish-actions.pod:3267
13852 #: ../fish/guestfish-actions.pod:3269
13862 #: ../fish/guestfish-actions.pod:3271 ../src/guestfs-actions.pod:5044
13864 "Create a directory named C<path>, creating any parent directories as "
13865 "necessary. This is like the C<mkdir -p> shell command."
13869 #: ../fish/guestfish-actions.pod:3274
13874 #: ../fish/guestfish-actions.pod:3276
13877 " mkdtemp template\n"
13880 " mkdtemp шаблон\n"
13884 #: ../fish/guestfish-actions.pod:3278 ../src/guestfs-actions.pod:5057
13886 "This command creates a temporary directory. The C<template> parameter "
13887 "should be a full pathname for the temporary directory name with the final "
13888 "six characters being \"XXXXXX\"."
13892 #: ../fish/guestfish-actions.pod:3283 ../src/guestfs-actions.pod:5062
13894 "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one "
13895 "being suitable for Windows filesystems."
13899 #: ../fish/guestfish-actions.pod:3286 ../src/guestfs-actions.pod:5065
13900 msgid "The name of the temporary directory that was created is returned."
13904 #: ../fish/guestfish-actions.pod:3289 ../src/guestfs-actions.pod:5068
13905 msgid "The temporary directory is created with mode 0700 and is owned by root."
13909 #: ../fish/guestfish-actions.pod:3292 ../src/guestfs-actions.pod:5071
13911 "The caller is responsible for deleting the temporary directory and its "
13912 "contents after use."
13916 #: ../fish/guestfish-actions.pod:3295 ../src/guestfs-actions.pod:5074
13917 msgid "See also: L<mkdtemp(3)>"
13918 msgstr "Див. також L<mkdtemp(3)>"
13921 #: ../fish/guestfish-actions.pod:3297
13926 #: ../fish/guestfish-actions.pod:3299
13929 " mke2fs-J fstype blocksize device journal\n"
13934 #: ../fish/guestfish-actions.pod:3301 ../src/guestfs-actions.pod:5090
13936 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
13937 "C<journal>. It is equivalent to the command:"
13941 #: ../fish/guestfish-actions.pod:3305 ../src/guestfs-actions.pod:5094
13944 " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n"
13947 " mke2fs -t fstype -b blocksize -J device=<журнал> <пристрій>\n"
13951 #: ../fish/guestfish-actions.pod:3307
13952 msgid "See also L</mke2journal>."
13953 msgstr "Див. також L</mke2journal>."
13956 #: ../fish/guestfish-actions.pod:3309
13961 #: ../fish/guestfish-actions.pod:3311
13964 " mke2fs-JL fstype blocksize device label\n"
13969 #: ../fish/guestfish-actions.pod:3313 ../src/guestfs-actions.pod:5111
13971 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
13972 "the journal labeled C<label>."
13976 #: ../fish/guestfish-actions.pod:3316
13977 msgid "See also L</mke2journal-L>."
13978 msgstr "Див. також L</mke2journal-L>."
13981 #: ../fish/guestfish-actions.pod:3318
13986 #: ../fish/guestfish-actions.pod:3320
13989 " mke2fs-JU fstype blocksize device uuid\n"
13994 #: ../fish/guestfish-actions.pod:3322 ../src/guestfs-actions.pod:5129
13996 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
13997 "the journal with UUID C<uuid>."
14001 #: ../fish/guestfish-actions.pod:3325
14002 msgid "See also L</mke2journal-U>."
14003 msgstr "Див. також L</mke2journal-U>."
14006 #: ../fish/guestfish-actions.pod:3327
14007 msgid "mke2journal"
14008 msgstr "mke2journal"
14011 #: ../fish/guestfish-actions.pod:3329
14014 " mke2journal blocksize device\n"
14019 #: ../fish/guestfish-actions.pod:3331 ../src/guestfs-actions.pod:5145
14021 "This creates an ext2 external journal on C<device>. It is equivalent to the "
14026 #: ../fish/guestfish-actions.pod:3334 ../src/guestfs-actions.pod:5148
14029 " mke2fs -O journal_dev -b blocksize device\n"
14034 #: ../fish/guestfish-actions.pod:3336
14035 msgid "mke2journal-L"
14036 msgstr "mke2journal-L"
14039 #: ../fish/guestfish-actions.pod:3338
14042 " mke2journal-L blocksize label device\n"
14047 #: ../fish/guestfish-actions.pod:3340 ../src/guestfs-actions.pod:5162
14048 msgid "This creates an ext2 external journal on C<device> with label C<label>."
14052 #: ../fish/guestfish-actions.pod:3342
14053 msgid "mke2journal-U"
14054 msgstr "mke2journal-U"
14057 #: ../fish/guestfish-actions.pod:3344
14060 " mke2journal-U blocksize uuid device\n"
14065 #: ../fish/guestfish-actions.pod:3346 ../src/guestfs-actions.pod:5176
14066 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>."
14070 #: ../fish/guestfish-actions.pod:3348
14075 #: ../fish/guestfish-actions.pod:3350
14078 " mkfifo mode path\n"
14081 " mkfifo режим шлях\n"
14085 #: ../fish/guestfish-actions.pod:3352
14087 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>. It "
14088 "is just a convenient wrapper around L</mknod>."
14092 #: ../fish/guestfish-actions.pod:3358
14097 #: ../fish/guestfish-actions.pod:3360
14100 " mkfs fstype device\n"
14103 " mkfs тип_файлової_системи пристрій\n"
14107 #: ../fish/guestfish-actions.pod:3362 ../src/guestfs-actions.pod:5206
14109 "This creates a filesystem on C<device> (usually a partition or LVM logical "
14110 "volume). The filesystem type is C<fstype>, for example C<ext3>."
14114 #: ../fish/guestfish-actions.pod:3366
14119 #: ../fish/guestfish-actions.pod:3368
14122 " mkfs-b fstype blocksize device\n"
14127 #: ../fish/guestfish-actions.pod:3370
14129 "This call is similar to L</mkfs>, but it allows you to control the block "
14130 "size of the resulting filesystem. Supported block sizes depend on the "
14131 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
14135 #: ../fish/guestfish-actions.pod:3375 ../fish/guestfish-actions.pod:3402
14136 #: ../src/guestfs-actions.pod:5234 ../src/guestfs-actions.pod:5272
14138 "For VFAT and NTFS the C<blocksize> parameter is treated as the requested "
14143 #: ../fish/guestfish-actions.pod:3378
14145 "I<This function is deprecated.> In new code, use the L</mkfs_opts> call "
14150 #: ../fish/guestfish-actions.pod:3385
14155 #: ../fish/guestfish-actions.pod:3387
14158 " mkfs-opts fstype device [blocksize:N] [features:..] [inode:N] [sectorsize:N]\n"
14163 #: ../fish/guestfish-actions.pod:3389 ../src/guestfs-actions.pod:5259
14165 "This function creates a filesystem on C<device>. The filesystem type is "
14166 "C<fstype>, for example C<ext3>."
14170 #: ../fish/guestfish-actions.pod:3396 ../src/guestfs-actions.pod:5266
14171 msgid "C<blocksize>"
14172 msgstr "C<blocksize>"
14175 #: ../fish/guestfish-actions.pod:3398 ../src/guestfs-actions.pod:5268
14177 "The filesystem block size. Supported block sizes depend on the filesystem "
14178 "type, but typically they are C<1024>, C<2048> or C<4096> for Linux ext2/3 "
14183 #: ../fish/guestfish-actions.pod:3405 ../src/guestfs-actions.pod:5275
14184 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>."
14188 #: ../fish/guestfish-actions.pod:3407 ../src/guestfs-actions.pod:5277
14189 msgid "C<features>"
14190 msgstr "C<features>"
14193 #: ../fish/guestfish-actions.pod:3409 ../src/guestfs-actions.pod:5279
14194 msgid "This passes the I<-O> parameter to the external mkfs program."
14198 #: ../fish/guestfish-actions.pod:3411 ../src/guestfs-actions.pod:5281
14200 "For certain filesystem types, this allows extra filesystem features to be "
14201 "selected. See L<mke2fs(8)> and L<mkfs.ufs(8)> for more details."
14205 #: ../fish/guestfish-actions.pod:3415 ../src/guestfs-actions.pod:5285
14207 "You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem "
14212 #: ../fish/guestfish-actions.pod:3418 ../src/guestfs-actions.pod:5288
14217 #: ../fish/guestfish-actions.pod:3420 ../src/guestfs-actions.pod:5290
14219 "This passes the I<-I> parameter to the external L<mke2fs(8)> program which "
14220 "sets the inode size (only for ext2/3/4 filesystems at present)."
14224 #: ../fish/guestfish-actions.pod:3423 ../src/guestfs-actions.pod:5293
14225 msgid "C<sectorsize>"
14226 msgstr "C<sectorsize>"
14229 #: ../fish/guestfish-actions.pod:3425 ../src/guestfs-actions.pod:5295
14231 "This passes the I<-S> parameter to external L<mkfs.ufs(8)> program, which "
14232 "sets sector size for ufs filesystem."
14236 #: ../fish/guestfish-actions.pod:3432
14237 msgid "mkmountpoint"
14238 msgstr "mkmountpoint"
14241 #: ../fish/guestfish-actions.pod:3434
14244 " mkmountpoint exemptpath\n"
14249 #: ../fish/guestfish-actions.pod:3436
14251 "L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used "
14252 "to create extra mountpoints before mounting the first filesystem."
14256 #: ../fish/guestfish-actions.pod:3440 ../src/guestfs-actions.pod:5338
14258 "These calls are I<only> necessary in some very limited circumstances, mainly "
14259 "the case where you want to mount a mix of unrelated and/or read-only "
14260 "filesystems together."
14264 #: ../fish/guestfish-actions.pod:3444 ../src/guestfs-actions.pod:5342
14266 "For example, live CDs often contain a \"Russian doll\" nest of filesystems, "
14267 "an ISO outer layer, with a squashfs image inside, with an ext2/3 image "
14268 "inside that. You can unpack this as follows in guestfish:"
14272 #: ../fish/guestfish-actions.pod:3449 ../src/guestfs-actions.pod:5347
14275 " add-ro Fedora-11-i686-Live.iso\n"
14277 " mkmountpoint /cd\n"
14278 " mkmountpoint /sqsh\n"
14279 " mkmountpoint /ext3fs\n"
14280 " mount /dev/sda /cd\n"
14281 " mount-loop /cd/LiveOS/squashfs.img /sqsh\n"
14282 " mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs\n"
14285 " add-ro Fedora-11-i686-Live.iso\n"
14287 " mkmountpoint /cd\n"
14288 " mkmountpoint /sqsh\n"
14289 " mkmountpoint /ext3fs\n"
14290 " mount /dev/sda /cd\n"
14291 " mount-loop /cd/LiveOS/squashfs.img /sqsh\n"
14292 " mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs\n"
14296 #: ../fish/guestfish-actions.pod:3458 ../src/guestfs-actions.pod:5356
14297 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint."
14301 #: ../fish/guestfish-actions.pod:3460
14303 "L</mkmountpoint> is not compatible with L</umount-all>. You may get "
14304 "unexpected errors if you try to mix these calls. It is safest to manually "
14305 "unmount filesystems and remove mountpoints after use."
14309 #: ../fish/guestfish-actions.pod:3464
14311 "L</umount-all> unmounts filesystems by sorting the paths longest first, so "
14312 "for this to work for manual mountpoints, you must ensure that the innermost "
14313 "mountpoints have the longest pathnames, as in the example code above."
14317 #: ../fish/guestfish-actions.pod:3469 ../src/guestfs-actions.pod:5367
14319 "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>"
14323 #: ../fish/guestfish-actions.pod:3471
14325 "Autosync [see L</set-autosync>, this is set by default on handles] can cause "
14326 "L</umount-all> to be called when the handle is closed which can also trigger "
14331 #: ../fish/guestfish-actions.pod:3475
14336 #: ../fish/guestfish-actions.pod:3477
14339 " mknod mode devmajor devminor path\n"
14344 #: ../fish/guestfish-actions.pod:3479 ../src/guestfs-actions.pod:5386
14346 "This call creates block or character special devices, or named pipes (FIFOs)."
14350 #: ../fish/guestfish-actions.pod:3482 ../src/guestfs-actions.pod:5389
14352 "The C<mode> parameter should be the mode, using the standard constants. "
14353 "C<devmajor> and C<devminor> are the device major and minor numbers, only "
14354 "used when creating block and character special devices."
14358 #: ../fish/guestfish-actions.pod:3487
14360 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
14361 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
14362 "regular file). These constants are available in the standard Linux header "
14363 "files, or you can use L</mknod-b>, L</mknod-c> or L</mkfifo> which are "
14364 "wrappers around this command which bitwise OR in the appropriate constant "
14369 #: ../fish/guestfish-actions.pod:3497
14374 #: ../fish/guestfish-actions.pod:3499
14377 " mknod-b mode devmajor devminor path\n"
14382 #: ../fish/guestfish-actions.pod:3501
14384 "This call creates a block device node called C<path> with mode C<mode> and "
14385 "device major/minor C<devmajor> and C<devminor>. It is just a convenient "
14386 "wrapper around L</mknod>."
14390 #: ../fish/guestfish-actions.pod:3507
14395 #: ../fish/guestfish-actions.pod:3509
14398 " mknod-c mode devmajor devminor path\n"
14403 #: ../fish/guestfish-actions.pod:3511
14405 "This call creates a char device node called C<path> with mode C<mode> and "
14406 "device major/minor C<devmajor> and C<devminor>. It is just a convenient "
14407 "wrapper around L</mknod>."
14411 #: ../fish/guestfish-actions.pod:3517
14416 #: ../fish/guestfish-actions.pod:3519
14422 " mkswap пристрій\n"
14426 #: ../fish/guestfish-actions.pod:3521 ../src/guestfs-actions.pod:5452
14427 msgid "Create a swap partition on C<device>."
14431 #: ../fish/guestfish-actions.pod:3523
14436 #: ../fish/guestfish-actions.pod:3525
14439 " mkswap-L label device\n"
14442 " mkswap-L мітка пристрій\n"
14446 #: ../fish/guestfish-actions.pod:3527 ../src/guestfs-actions.pod:5465
14447 msgid "Create a swap partition on C<device> with label C<label>."
14451 #: ../fish/guestfish-actions.pod:3529 ../src/guestfs-actions.pod:5467
14453 "Note that you cannot attach a swap label to a block device (eg. C</dev/"
14454 "sda>), just to a partition. This appears to be a limitation of the kernel "
14459 #: ../fish/guestfish-actions.pod:3533
14464 #: ../fish/guestfish-actions.pod:3535
14467 " mkswap-U uuid device\n"
14470 " mkswap-U uuid пристрій\n"
14474 #: ../fish/guestfish-actions.pod:3537 ../src/guestfs-actions.pod:5482
14475 msgid "Create a swap partition on C<device> with UUID C<uuid>."
14479 #: ../fish/guestfish-actions.pod:3539
14480 msgid "mkswap-file"
14481 msgstr "mkswap-file"
14484 #: ../fish/guestfish-actions.pod:3541
14487 " mkswap-file path\n"
14490 " mkswap-file шлях\n"
14494 #: ../fish/guestfish-actions.pod:3543 ../src/guestfs-actions.pod:5494
14495 msgid "Create a swap file."
14496 msgstr "Створити файл резервної пам’яті."
14499 #: ../fish/guestfish-actions.pod:3545
14501 "This command just writes a swap file signature to an existing file. To "
14502 "create the file itself, use something like L</fallocate>."
14506 #: ../fish/guestfish-actions.pod:3548
14511 #: ../fish/guestfish-actions.pod:3550
14514 " modprobe modulename\n"
14517 " modprobe назва_модуля\n"
14521 #: ../fish/guestfish-actions.pod:3552 ../src/guestfs-actions.pod:5509
14522 msgid "This loads a kernel module in the appliance."
14526 #: ../fish/guestfish-actions.pod:3554 ../src/guestfs-actions.pod:5511
14528 "The kernel module must have been whitelisted when libguestfs was built (see "
14529 "C<appliance/kmod.whitelist.in> in the source)."
14533 #: ../fish/guestfish-actions.pod:3557
14538 #: ../fish/guestfish-actions.pod:3559
14541 " mount device mountpoint\n"
14544 " mount пристрій точка_монтування\n"
14548 #: ../fish/guestfish-actions.pod:3561 ../src/guestfs-actions.pod:5525
14550 "Mount a guest disk at a position in the filesystem. Block devices are named "
14551 "C</dev/sda>, C</dev/sdb> and so on, as they were added to the guest. If "
14552 "those block devices contain partitions, they will have the usual names (eg. "
14553 "C</dev/sda1>). Also LVM C</dev/VG/LV>-style names can be used."
14557 #: ../fish/guestfish-actions.pod:3567 ../src/guestfs-actions.pod:5531
14559 "The rules are the same as for L<mount(2)>: A filesystem must first be "
14560 "mounted on C</> before others can be mounted. Other filesystems can only be "
14561 "mounted on directories which already exist."
14565 #: ../fish/guestfish-actions.pod:3572 ../src/guestfs-actions.pod:5536
14567 "The mounted filesystem is writable, if we have sufficient permissions on the "
14568 "underlying device."
14572 #: ../fish/guestfish-actions.pod:3575
14574 "Before libguestfs 1.13.16, this call implicitly added the options C<sync> "
14575 "and C<noatime>. The C<sync> option greatly slowed writes and caused many "
14576 "problems for users. If your program might need to work with older versions "
14577 "of libguestfs, use L</mount-options> instead (using an empty string for the "
14578 "first parameter if you don't want any options)."
14582 #: ../fish/guestfish-actions.pod:3582
14587 #: ../fish/guestfish-actions.pod:3584
14590 " mount-9p mounttag mountpoint [options:..]\n"
14595 #: ../fish/guestfish-actions.pod:3586 ../src/guestfs-actions.pod:5565
14597 "Mount the virtio-9p filesystem with the tag C<mounttag> on the directory "
14602 #: ../fish/guestfish-actions.pod:3589 ../src/guestfs-actions.pod:5568
14604 "If required, C<trans=virtio> will be automatically added to the options. "
14605 "Any other options required can be passed in the optional C<options> "
14610 #: ../fish/guestfish-actions.pod:3595
14612 msgstr "mount-loop"
14615 #: ../fish/guestfish-actions.pod:3597
14618 " mount-loop file mountpoint\n"
14623 #: ../fish/guestfish-actions.pod:3599 ../src/guestfs-actions.pod:5607
14625 "This command lets you mount C<file> (a filesystem image in a file) on a "
14626 "mount point. It is entirely equivalent to the command C<mount -o loop file "
14631 #: ../fish/guestfish-actions.pod:3603
14632 msgid "mount-options"
14633 msgstr "mount-options"
14636 #: ../fish/guestfish-actions.pod:3605
14639 " mount-options options device mountpoint\n"
14644 #: ../fish/guestfish-actions.pod:3607
14646 "This is the same as the L</mount> command, but it allows you to set the "
14647 "mount options as for the L<mount(8)> I<-o> flag."
14651 #: ../fish/guestfish-actions.pod:3611 ../src/guestfs-actions.pod:5627
14653 "If the C<options> parameter is an empty string, then no options are passed "
14654 "(all options default to whatever the filesystem uses)."
14658 #: ../fish/guestfish-actions.pod:3615
14663 #: ../fish/guestfish-actions.pod:3617
14666 " mount-ro device mountpoint\n"
14669 " mount-ro пристрій точка_монтування\n"
14673 #: ../fish/guestfish-actions.pod:3619
14675 "This is the same as the L</mount> command, but it mounts the filesystem with "
14676 "the read-only (I<-o ro>) flag."
14680 #: ../fish/guestfish-actions.pod:3622
14685 #: ../fish/guestfish-actions.pod:3624
14688 " mount-vfs options vfstype device mountpoint\n"
14693 #: ../fish/guestfish-actions.pod:3626
14695 "This is the same as the L</mount> command, but it allows you to set both the "
14696 "mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags."
14700 #: ../fish/guestfish-actions.pod:3630
14701 msgid "mountpoints"
14702 msgstr "mountpoints"
14705 #: ../fish/guestfish-actions.pod:3632
14715 #: ../fish/guestfish-actions.pod:3634
14717 "This call is similar to L</mounts>. That call returns a list of devices. "
14718 "This one returns a hash table (map) of device name to directory where the "
14719 "device is mounted."
14723 #: ../fish/guestfish-actions.pod:3638
14728 #: ../fish/guestfish-actions.pod:3640
14738 #: ../fish/guestfish-actions.pod:3642 ../src/guestfs-actions.pod:5688
14740 "This returns the list of currently mounted filesystems. It returns the list "
14741 "of devices (eg. C</dev/sda1>, C</dev/VG/LV>)."
14745 #: ../fish/guestfish-actions.pod:3645 ../src/guestfs-actions.pod:5691
14746 msgid "Some internal mounts are not shown."
14750 #: ../fish/guestfish-actions.pod:3647
14751 msgid "See also: L</mountpoints>"
14752 msgstr "Див. також L</mountpoints>"
14755 #: ../fish/guestfish-actions.pod:3649
14760 #: ../fish/guestfish-actions.pod:3651
14766 " mv джерело призначення\n"
14770 #: ../fish/guestfish-actions.pod:3653 ../src/guestfs-actions.pod:5708
14772 "This moves a file from C<src> to C<dest> where C<dest> is either a "
14773 "destination filename or destination directory."
14777 #: ../fish/guestfish-actions.pod:3656
14778 msgid "ntfs-3g-probe"
14779 msgstr "ntfs-3g-probe"
14782 #: ../fish/guestfish-actions.pod:3658
14785 " ntfs-3g-probe true|false device\n"
14790 #: ../fish/guestfish-actions.pod:3660 ../src/guestfs-actions.pod:5722
14792 "This command runs the L<ntfs-3g.probe(8)> command which probes an NTFS "
14793 "C<device> for mountability. (Not all NTFS volumes can be mounted read-"
14794 "write, and some cannot be mounted at all)."
14798 #: ../fish/guestfish-actions.pod:3664 ../src/guestfs-actions.pod:5726
14800 "C<rw> is a boolean flag. Set it to true if you want to test if the volume "
14801 "can be mounted read-write. Set it to false if you want to test if the "
14802 "volume can be mounted read-only."
14806 #: ../fish/guestfish-actions.pod:3668 ../src/guestfs-actions.pod:5730
14808 "The return value is an integer which C<0> if the operation would succeed, or "
14809 "some non-zero value documented in the L<ntfs-3g.probe(8)> manual page."
14813 #: ../fish/guestfish-actions.pod:3672
14815 msgstr "ntfsresize"
14818 #: ../fish/guestfish-actions.pod:3674
14821 " ntfsresize device\n"
14824 " ntfsresize пристрій\n"
14828 #: ../fish/guestfish-actions.pod:3676 ../fish/guestfish-actions.pod:3700
14829 #: ../src/guestfs-actions.pod:5751 ../src/guestfs-actions.pod:5783
14831 "This command resizes an NTFS filesystem, expanding or shrinking it to the "
14832 "size of the underlying device."
14836 #: ../fish/guestfish-actions.pod:3679 ../src/guestfs-actions.pod:5754
14838 "I<Note:> After the resize operation, the filesystem is marked as requiring a "
14839 "consistency check (for safety). You have to boot into Windows to perform "
14840 "this check and clear this condition. Furthermore, ntfsresize refuses to "
14841 "resize filesystems which have been marked in this way. So in effect it is "
14842 "not possible to call ntfsresize multiple times on a single filesystem "
14843 "without booting into Windows between each resize."
14847 #: ../fish/guestfish-actions.pod:3687 ../fish/guestfish-actions.pod:3726
14848 #: ../src/guestfs-actions.pod:5762 ../src/guestfs-actions.pod:5809
14849 msgid "See also L<ntfsresize(8)>."
14850 msgstr "Див. також L<ntfsresize(8)>."
14853 #: ../fish/guestfish-actions.pod:3689 ../fish/guestfish-actions.pod:3737
14855 "I<This function is deprecated.> In new code, use the L</ntfsresize_opts> "
14860 #: ../fish/guestfish-actions.pod:3696
14861 msgid "ntfsresize-opts"
14865 #: ../fish/guestfish-actions.pod:3698
14868 " ntfsresize-opts device [size:N] [force:true|false]\n"
14873 #: ../fish/guestfish-actions.pod:3709 ../src/guestfs-actions.pod:5792
14875 "The new size (in bytes) of the filesystem. If omitted, the filesystem is "
14876 "resized to fit the container (eg. partition)."
14880 #: ../fish/guestfish-actions.pod:3712 ../fish/guestfish-actions.pod:5033
14881 #: ../src/guestfs-actions.pod:5795 ../src/guestfs-actions.pod:7766
14886 #: ../fish/guestfish-actions.pod:3714 ../src/guestfs-actions.pod:5797
14888 "If this option is true, then force the resize of the filesystem even if the "
14889 "filesystem is marked as requiring a consistency check."
14893 #: ../fish/guestfish-actions.pod:3717
14895 "After the resize operation, the filesystem is always marked as requiring a "
14896 "consistency check (for safety). You have to boot into Windows to perform "
14897 "this check and clear this condition. If you I<don't> set the C<force> "
14898 "option then it is not possible to call L</ntfsresize-opts> multiple times on "
14899 "a single filesystem without booting into Windows between each resize."
14903 #: ../fish/guestfish-actions.pod:3730
14904 msgid "ntfsresize-size"
14905 msgstr "ntfsresize-size"
14908 #: ../fish/guestfish-actions.pod:3732
14911 " ntfsresize-size device size\n"
14916 #: ../fish/guestfish-actions.pod:3734
14918 "This command is the same as L</ntfsresize> except that it allows you to "
14919 "specify the new size (in bytes) explicitly."
14923 #: ../fish/guestfish-actions.pod:3744
14928 #: ../fish/guestfish-actions.pod:3746
14931 " part-add device prlogex startsect endsect\n"
14936 #: ../fish/guestfish-actions.pod:3748
14938 "This command adds a partition to C<device>. If there is no partition table "
14939 "on the device, call L</part-init> first."
14943 #: ../fish/guestfish-actions.pod:3751 ../src/guestfs-actions.pod:5870
14945 "The C<prlogex> parameter is the type of partition. Normally you should pass "
14946 "C<p> or C<primary> here, but MBR partition tables also support C<l> (or "
14947 "C<logical>) and C<e> (or C<extended>) partition types."
14951 #: ../fish/guestfish-actions.pod:3756 ../src/guestfs-actions.pod:5875
14953 "C<startsect> and C<endsect> are the start and end of the partition in "
14954 "I<sectors>. C<endsect> may be negative, which means it counts backwards "
14955 "from the end of the disk (C<-1> is the last sector)."
14959 #: ../fish/guestfish-actions.pod:3760
14961 "Creating a partition which covers the whole disk is not so easy. Use L</"
14962 "part-disk> to do that."
14966 #: ../fish/guestfish-actions.pod:3763
14971 #: ../fish/guestfish-actions.pod:3765
14974 " part-del device partnum\n"
14979 #: ../fish/guestfish-actions.pod:3767 ../src/guestfs-actions.pod:5893
14980 msgid "This command deletes the partition numbered C<partnum> on C<device>."
14984 #: ../fish/guestfish-actions.pod:3769 ../src/guestfs-actions.pod:5895
14986 "Note that in the case of MBR partitioning, deleting an extended partition "
14987 "also deletes any logical partitions it contains."
14991 #: ../fish/guestfish-actions.pod:3773
14996 #: ../fish/guestfish-actions.pod:3775
14999 " part-disk device parttype\n"
15002 " part-disk пристрій тип_розділу\n"
15006 #: ../fish/guestfish-actions.pod:3777
15008 "This command is simply a combination of L</part-init> followed by L</part-"
15009 "add> to create a single primary partition covering the whole disk."
15013 #: ../fish/guestfish-actions.pod:3781
15015 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
15016 "possible values are described in L</part-init>."
15020 #: ../fish/guestfish-actions.pod:3784
15021 msgid "part-get-bootable"
15022 msgstr "part-get-bootable"
15025 #: ../fish/guestfish-actions.pod:3786
15028 " part-get-bootable device partnum\n"
15033 #: ../fish/guestfish-actions.pod:3788 ../src/guestfs-actions.pod:5928
15035 "This command returns true if the partition C<partnum> on C<device> has the "
15036 "bootable flag set."
15040 #: ../fish/guestfish-actions.pod:3791
15041 msgid "See also L</part-set-bootable>."
15042 msgstr "Див. також L</part-set-bootable>."
15045 #: ../fish/guestfish-actions.pod:3793
15046 msgid "part-get-mbr-id"
15047 msgstr "part-get-mbr-id"
15050 #: ../fish/guestfish-actions.pod:3795
15053 " part-get-mbr-id device partnum\n"
15058 #: ../fish/guestfish-actions.pod:3797 ../src/guestfs-actions.pod:5944
15060 "Returns the MBR type byte (also known as the ID byte) from the numbered "
15061 "partition C<partnum>."
15065 #: ../fish/guestfish-actions.pod:3800 ../fish/guestfish-actions.pod:3944
15067 "Note that only MBR (old DOS-style) partitions have type bytes. You will get "
15068 "undefined results for other partition table types (see L</part-get-"
15073 #: ../fish/guestfish-actions.pod:3804
15074 msgid "part-get-parttype"
15075 msgstr "part-get-parttype"
15078 #: ../fish/guestfish-actions.pod:3806
15081 " part-get-parttype device\n"
15084 " part-get-parttype пристрій\n"
15088 #: ../fish/guestfish-actions.pod:3808 ../src/guestfs-actions.pod:5961
15090 "This command examines the partition table on C<device> and returns the "
15091 "partition table type (format) being used."
15095 #: ../fish/guestfish-actions.pod:3811
15097 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
15098 "table), C<gpt> (a GPT/EFI-style partition table). Other values are "
15099 "possible, although unusual. See L</part-init> for a full list."
15103 #: ../fish/guestfish-actions.pod:3816
15108 #: ../fish/guestfish-actions.pod:3818
15111 " part-init device parttype\n"
15116 #: ../fish/guestfish-actions.pod:3820 ../src/guestfs-actions.pod:5981
15118 "This creates an empty partition table on C<device> of one of the partition "
15119 "types listed below. Usually C<parttype> should be either C<msdos> or C<gpt> "
15120 "(for large disks)."
15124 #: ../fish/guestfish-actions.pod:3824
15126 "Initially there are no partitions. Following this, you should call L</part-"
15127 "add> for each partition required."
15131 #: ../fish/guestfish-actions.pod:3827 ../src/guestfs-actions.pod:5988
15132 msgid "Possible values for C<parttype> are:"
15136 #: ../fish/guestfish-actions.pod:3831 ../src/guestfs-actions.pod:5992
15141 #: ../fish/guestfish-actions.pod:3833 ../src/guestfs-actions.pod:5994
15146 #: ../fish/guestfish-actions.pod:3835 ../src/guestfs-actions.pod:5996
15147 msgid "Intel EFI / GPT partition table."
15151 #: ../fish/guestfish-actions.pod:3837 ../src/guestfs-actions.pod:5998
15153 "This is recommended for >= 2 TB partitions that will be accessed from Linux "
15154 "and Intel-based Mac OS X. It also has limited backwards compatibility with "
15155 "the C<mbr> format."
15159 #: ../fish/guestfish-actions.pod:3841 ../src/guestfs-actions.pod:6002
15164 #: ../fish/guestfish-actions.pod:3843 ../src/guestfs-actions.pod:6004
15169 #: ../fish/guestfish-actions.pod:3845 ../src/guestfs-actions.pod:6006
15171 "The standard PC \"Master Boot Record\" (MBR) format used by MS-DOS and "
15172 "Windows. This partition type will B<only> work for device sizes up to 2 "
15173 "TB. For large disks we recommend using C<gpt>."
15177 #: ../fish/guestfish-actions.pod:3852 ../src/guestfs-actions.pod:6013
15179 "Other partition table types that may work but are not supported include:"
15183 #: ../fish/guestfish-actions.pod:3857 ../src/guestfs-actions.pod:6018
15188 #: ../fish/guestfish-actions.pod:3859 ../src/guestfs-actions.pod:6020
15189 msgid "AIX disk labels."
15190 msgstr "Мітки дисків AIX."
15193 #: ../fish/guestfish-actions.pod:3861 ../src/guestfs-actions.pod:6022
15198 #: ../fish/guestfish-actions.pod:3863 ../src/guestfs-actions.pod:6024
15203 #: ../fish/guestfish-actions.pod:3865 ../src/guestfs-actions.pod:6026
15204 msgid "Amiga \"Rigid Disk Block\" format."
15205 msgstr "Формат \"Rigid Disk Block\" Amiga."
15208 #: ../fish/guestfish-actions.pod:3867 ../src/guestfs-actions.pod:6028
15213 #: ../fish/guestfish-actions.pod:3869 ../src/guestfs-actions.pod:6030
15214 msgid "BSD disk labels."
15215 msgstr "Мітки дисків BSD."
15218 #: ../fish/guestfish-actions.pod:3871 ../src/guestfs-actions.pod:6032
15223 #: ../fish/guestfish-actions.pod:3873 ../src/guestfs-actions.pod:6034
15224 msgid "DASD, used on IBM mainframes."
15225 msgstr "DASD, використовувалися у мейнфреймах IBM."
15228 #: ../fish/guestfish-actions.pod:3875 ../src/guestfs-actions.pod:6036
15233 #: ../fish/guestfish-actions.pod:3877 ../src/guestfs-actions.pod:6038
15234 msgid "MIPS/SGI volumes."
15235 msgstr "Томи MIPS/SGI."
15238 #: ../fish/guestfish-actions.pod:3879 ../src/guestfs-actions.pod:6040
15243 #: ../fish/guestfish-actions.pod:3881 ../src/guestfs-actions.pod:6042
15244 msgid "Old Mac partition format. Modern Macs use C<gpt>."
15245 msgstr "Старий формат розділів Mac. Сучасні системи Mac використовують C<gpt>."
15248 #: ../fish/guestfish-actions.pod:3883 ../src/guestfs-actions.pod:6044
15253 #: ../fish/guestfish-actions.pod:3885 ../src/guestfs-actions.pod:6046
15254 msgid "NEC PC-98 format, common in Japan apparently."
15255 msgstr "Формат NEC PC-98, поширений у Японії."
15258 #: ../fish/guestfish-actions.pod:3887 ../src/guestfs-actions.pod:6048
15263 #: ../fish/guestfish-actions.pod:3889 ../src/guestfs-actions.pod:6050
15264 msgid "Sun disk labels."
15265 msgstr "Мітки дисків Sun."
15268 #: ../fish/guestfish-actions.pod:3893
15273 #: ../fish/guestfish-actions.pod:3895
15276 " part-list device\n"
15279 " part-list device\n"
15283 #: ../fish/guestfish-actions.pod:3897 ../src/guestfs-actions.pod:6064
15285 "This command parses the partition table on C<device> and returns the list of "
15286 "partitions found."
15290 #: ../fish/guestfish-actions.pod:3900 ../src/guestfs-actions.pod:6067
15291 msgid "The fields in the returned structure are:"
15295 #: ../fish/guestfish-actions.pod:3904 ../src/guestfs-actions.pod:6071
15296 msgid "B<part_num>"
15297 msgstr "B<part_num>"
15300 #: ../fish/guestfish-actions.pod:3906 ../src/guestfs-actions.pod:6073
15301 msgid "Partition number, counting from 1."
15305 #: ../fish/guestfish-actions.pod:3908 ../src/guestfs-actions.pod:6075
15306 msgid "B<part_start>"
15307 msgstr "B<part_start>"
15310 #: ../fish/guestfish-actions.pod:3910
15312 "Start of the partition I<in bytes>. To get sectors you have to divide by "
15313 "the device's sector size, see L</blockdev-getss>."
15317 #: ../fish/guestfish-actions.pod:3913 ../src/guestfs-actions.pod:6080
15318 msgid "B<part_end>"
15319 msgstr "B<part_end>"
15322 #: ../fish/guestfish-actions.pod:3915 ../src/guestfs-actions.pod:6082
15323 msgid "End of the partition in bytes."
15327 #: ../fish/guestfish-actions.pod:3917 ../src/guestfs-actions.pod:6084
15328 msgid "B<part_size>"
15329 msgstr "B<part_size>"
15332 #: ../fish/guestfish-actions.pod:3919 ../src/guestfs-actions.pod:6086
15333 msgid "Size of the partition in bytes."
15337 #: ../fish/guestfish-actions.pod:3923
15338 msgid "part-set-bootable"
15339 msgstr "part-set-bootable"
15342 #: ../fish/guestfish-actions.pod:3925
15345 " part-set-bootable device partnum true|false\n"
15350 #: ../fish/guestfish-actions.pod:3927 ../src/guestfs-actions.pod:6104
15352 "This sets the bootable flag on partition numbered C<partnum> on device "
15353 "C<device>. Note that partitions are numbered from 1."
15357 #: ../fish/guestfish-actions.pod:3930 ../src/guestfs-actions.pod:6107
15359 "The bootable flag is used by some operating systems (notably Windows) to "
15360 "determine which partition to boot from. It is by no means universally "
15365 #: ../fish/guestfish-actions.pod:3934
15366 msgid "part-set-mbr-id"
15367 msgstr "part-set-mbr-id"
15370 #: ../fish/guestfish-actions.pod:3936
15373 " part-set-mbr-id device partnum idbyte\n"
15378 #: ../fish/guestfish-actions.pod:3938 ../src/guestfs-actions.pod:6123
15380 "Sets the MBR type byte (also known as the ID byte) of the numbered partition "
15381 "C<partnum> to C<idbyte>. Note that the type bytes quoted in most "
15382 "documentation are in fact hexadecimal numbers, but usually documented "
15383 "without any leading \"0x\" which might be confusing."
15387 #: ../fish/guestfish-actions.pod:3948
15388 msgid "part-set-name"
15389 msgstr "part-set-name"
15392 #: ../fish/guestfish-actions.pod:3950
15395 " part-set-name device partnum name\n"
15400 #: ../fish/guestfish-actions.pod:3952 ../src/guestfs-actions.pod:6145
15402 "This sets the partition name on partition numbered C<partnum> on device "
15403 "C<device>. Note that partitions are numbered from 1."
15407 #: ../fish/guestfish-actions.pod:3955 ../src/guestfs-actions.pod:6148
15409 "The partition name can only be set on certain types of partition table. "
15410 "This works on C<gpt> but not on C<mbr> partitions."
15414 #: ../fish/guestfish-actions.pod:3958
15415 msgid "part-to-dev"
15416 msgstr "part-to-dev"
15419 #: ../fish/guestfish-actions.pod:3960
15422 " part-to-dev partition\n"
15425 " part-to-dev розділ\n"
15429 #: ../fish/guestfish-actions.pod:3962 ../src/guestfs-actions.pod:6161
15431 "This function takes a partition name (eg. \"/dev/sdb1\") and removes the "
15432 "partition number, returning the device name (eg. \"/dev/sdb\")."
15436 #: ../fish/guestfish-actions.pod:3966 ../fish/guestfish-actions.pod:3978
15438 "The named partition must exist, for example as a string returned from L</"
15439 "list-partitions>."
15443 #: ../fish/guestfish-actions.pod:3969
15444 msgid "See also L</part-to-partnum>."
15448 #: ../fish/guestfish-actions.pod:3971
15449 msgid "part-to-partnum"
15453 #: ../fish/guestfish-actions.pod:3973
15456 " part-to-partnum partition\n"
15461 #: ../fish/guestfish-actions.pod:3975 ../src/guestfs-actions.pod:6181
15463 "This function takes a partition name (eg. \"/dev/sdb1\") and returns the "
15464 "partition number (eg. C<1>)."
15468 #: ../fish/guestfish-actions.pod:3981
15469 msgid "See also L</part-to-dev>."
15473 #: ../fish/guestfish-actions.pod:3983
15474 msgid "ping-daemon"
15475 msgstr "ping-daemon"
15478 #: ../fish/guestfish-actions.pod:3985
15488 #: ../fish/guestfish-actions.pod:3987 ../src/guestfs-actions.pod:6198
15490 "This is a test probe into the guestfs daemon running inside the qemu "
15491 "subprocess. Calling this function checks that the daemon responds to the "
15492 "ping message, without affecting the daemon or attached block device(s) in "
15497 #: ../fish/guestfish-actions.pod:3992
15502 #: ../fish/guestfish-actions.pod:3994
15505 " pread path count offset\n"
15510 #: ../fish/guestfish-actions.pod:3996 ../src/guestfs-actions.pod:6216
15512 "This command lets you read part of a file. It reads C<count> bytes of the "
15513 "file, starting at C<offset>, from file C<path>."
15517 #: ../fish/guestfish-actions.pod:3999 ../fish/guestfish-actions.pod:4014
15518 #: ../src/guestfs-actions.pod:6219 ../src/guestfs-actions.pod:6245
15520 "This may read fewer bytes than requested. For further details see the "
15521 "L<pread(2)> system call."
15525 #: ../fish/guestfish-actions.pod:4002
15526 msgid "See also L</pwrite>, L</pread-device>."
15527 msgstr "Див. також L</pwrite>, L</pread-device>."
15530 #: ../fish/guestfish-actions.pod:4007
15531 msgid "pread-device"
15532 msgstr "pread-device"
15535 #: ../fish/guestfish-actions.pod:4009
15538 " pread-device device count offset\n"
15543 #: ../fish/guestfish-actions.pod:4011 ../src/guestfs-actions.pod:6242
15545 "This command lets you read part of a file. It reads C<count> bytes of "
15546 "C<device>, starting at C<offset>."
15550 #: ../fish/guestfish-actions.pod:4017
15551 msgid "See also L</pread>."
15552 msgstr "Див. також L</pread>."
15555 #: ../fish/guestfish-actions.pod:4022
15560 #: ../fish/guestfish-actions.pod:4024
15563 " pvcreate device\n"
15566 " pvcreate пристрій\n"
15570 #: ../fish/guestfish-actions.pod:4026 ../src/guestfs-actions.pod:6265
15572 "This creates an LVM physical volume on the named C<device>, where C<device> "
15573 "should usually be a partition name such as C</dev/sda1>."
15577 #: ../fish/guestfish-actions.pod:4030
15582 #: ../fish/guestfish-actions.pod:4032
15585 " pvremove device\n"
15588 " pvremove пристрій\n"
15592 #: ../fish/guestfish-actions.pod:4034 ../src/guestfs-actions.pod:6279
15594 "This wipes a physical volume C<device> so that LVM will no longer recognise "
15599 #: ../fish/guestfish-actions.pod:4037 ../src/guestfs-actions.pod:6282
15601 "The implementation uses the C<pvremove> command which refuses to wipe "
15602 "physical volumes that contain any volume groups, so you have to remove those "
15607 #: ../fish/guestfish-actions.pod:4041
15612 #: ../fish/guestfish-actions.pod:4043
15615 " pvresize device\n"
15618 " pvresize пристрій\n"
15622 #: ../fish/guestfish-actions.pod:4045 ../src/guestfs-actions.pod:6296
15624 "This resizes (expands or shrinks) an existing LVM physical volume to match "
15625 "the new size of the underlying device."
15629 #: ../fish/guestfish-actions.pod:4048
15630 msgid "pvresize-size"
15631 msgstr "pvresize-size"
15634 #: ../fish/guestfish-actions.pod:4050
15637 " pvresize-size device size\n"
15642 #: ../fish/guestfish-actions.pod:4052
15644 "This command is the same as L</pvresize> except that it allows you to "
15645 "specify the new size (in bytes) explicitly."
15649 #: ../fish/guestfish-actions.pod:4055
15654 #: ../fish/guestfish-actions.pod:4057
15664 #: ../fish/guestfish-actions.pod:4059 ../src/guestfs-actions.pod:6322
15666 "List all the physical volumes detected. This is the equivalent of the L<pvs"
15671 #: ../fish/guestfish-actions.pod:4062 ../src/guestfs-actions.pod:6325
15673 "This returns a list of just the device names that contain PVs (eg. C</dev/"
15678 #: ../fish/guestfish-actions.pod:4065
15679 msgid "See also L</pvs-full>."
15680 msgstr "Див. також L</pvs-full>."
15683 #: ../fish/guestfish-actions.pod:4067
15688 #: ../fish/guestfish-actions.pod:4069
15698 #: ../fish/guestfish-actions.pod:4071 ../src/guestfs-actions.pod:6341
15700 "List all the physical volumes detected. This is the equivalent of the L<pvs"
15701 "(8)> command. The \"full\" version includes all fields."
15705 #: ../fish/guestfish-actions.pod:4074
15710 #: ../fish/guestfish-actions.pod:4076
15716 " pvuuid пристрій\n"
15720 #: ../fish/guestfish-actions.pod:4078 ../src/guestfs-actions.pod:6356
15721 msgid "This command returns the UUID of the LVM PV C<device>."
15725 #: ../fish/guestfish-actions.pod:4080
15730 #: ../fish/guestfish-actions.pod:4082
15733 " pwrite path content offset\n"
15738 #: ../fish/guestfish-actions.pod:4084 ../src/guestfs-actions.pod:6372
15740 "This command writes to part of a file. It writes the data buffer C<content> "
15741 "to the file C<path> starting at offset C<offset>."
15745 #: ../fish/guestfish-actions.pod:4087 ../src/guestfs-actions.pod:6375
15747 "This command implements the L<pwrite(2)> system call, and like that system "
15748 "call it may not write the full data requested. The return value is the "
15749 "number of bytes that were actually written to the file. This could even be "
15750 "0, although short writes are unlikely for regular files in ordinary "
15755 #: ../fish/guestfish-actions.pod:4093
15756 msgid "See also L</pread>, L</pwrite-device>."
15757 msgstr "Див. також L</pread>, L</pwrite-device>."
15760 #: ../fish/guestfish-actions.pod:4098
15761 msgid "pwrite-device"
15762 msgstr "pwrite-device"
15765 #: ../fish/guestfish-actions.pod:4100
15768 " pwrite-device device content offset\n"
15773 #: ../fish/guestfish-actions.pod:4102 ../src/guestfs-actions.pod:6399
15775 "This command writes to part of a device. It writes the data buffer "
15776 "C<content> to C<device> starting at offset C<offset>."
15780 #: ../fish/guestfish-actions.pod:4105 ../src/guestfs-actions.pod:6402
15782 "This command implements the L<pwrite(2)> system call, and like that system "
15783 "call it may not write the full data requested (although short writes to disk "
15784 "devices and partitions are probably impossible with standard Linux kernels)."
15788 #: ../fish/guestfish-actions.pod:4110
15789 msgid "See also L</pwrite>."
15790 msgstr "Див. також L</pwrite>."
15793 #: ../fish/guestfish-actions.pod:4115
15798 #: ../fish/guestfish-actions.pod:4117
15801 " read-file path\n"
15804 " read-file шлях\n"
15808 #: ../fish/guestfish-actions.pod:4119 ../src/guestfs-actions.pod:6423
15809 msgid "This calls returns the contents of the file C<path> as a buffer."
15813 #: ../fish/guestfish-actions.pod:4122
15815 "Unlike L</cat>, this function can correctly handle files that contain "
15816 "embedded ASCII NUL characters. However unlike L</download>, this function "
15817 "is limited in the total size of file that can be handled."
15821 #: ../fish/guestfish-actions.pod:4130
15823 msgstr "read-lines"
15826 #: ../fish/guestfish-actions.pod:4132
15829 " read-lines path\n"
15832 " read-lines шлях\n"
15836 #: ../fish/guestfish-actions.pod:4136 ../src/guestfs-actions.pod:6448
15838 "The file contents are returned as a list of lines. Trailing C<LF> and "
15839 "C<CRLF> character sequences are I<not> returned."
15843 #: ../fish/guestfish-actions.pod:4139
15845 "Note that this function cannot correctly handle binary files (specifically, "
15846 "files containing C<\\0> character which is treated as end of line). For "
15847 "those you need to use the L</read-file> function which has a more complex "
15852 #: ../fish/guestfish-actions.pod:4144
15857 #: ../fish/guestfish-actions.pod:4146
15863 " readdir каталог\n"
15867 #: ../fish/guestfish-actions.pod:4148 ../src/guestfs-actions.pod:6468
15868 msgid "This returns the list of directory entries in directory C<dir>."
15872 #: ../fish/guestfish-actions.pod:4150 ../src/guestfs-actions.pod:6470
15874 "All entries in the directory are returned, including C<.> and C<..>. The "
15875 "entries are I<not> sorted, but returned in the same order as the underlying "
15880 #: ../fish/guestfish-actions.pod:4154 ../src/guestfs-actions.pod:6474
15882 "Also this call returns basic file type information about each file. The "
15883 "C<ftyp> field will contain one of the following characters:"
15887 #: ../fish/guestfish-actions.pod:4159 ../src/guestfs-actions.pod:6479
15892 #: ../fish/guestfish-actions.pod:4161 ../src/guestfs-actions.pod:6481
15893 msgid "Block special"
15894 msgstr "Блоковий особливий"
15897 #: ../fish/guestfish-actions.pod:4163 ../src/guestfs-actions.pod:6483
15902 #: ../fish/guestfish-actions.pod:4165 ../src/guestfs-actions.pod:6485
15903 msgid "Char special"
15904 msgstr "Символьний особливий"
15907 #: ../fish/guestfish-actions.pod:4167 ../src/guestfs-actions.pod:6487
15912 #: ../fish/guestfish-actions.pod:4169 ../src/guestfs-actions.pod:6489
15917 #: ../fish/guestfish-actions.pod:4171 ../src/guestfs-actions.pod:6491
15922 #: ../fish/guestfish-actions.pod:4173 ../src/guestfs-actions.pod:6493
15923 msgid "FIFO (named pipe)"
15924 msgstr "FIFO (іменований канал)"
15927 #: ../fish/guestfish-actions.pod:4175 ../src/guestfs-actions.pod:6495
15932 #: ../fish/guestfish-actions.pod:4177 ../src/guestfs-actions.pod:6497
15933 msgid "Symbolic link"
15934 msgstr "Символічне посилання"
15937 #: ../fish/guestfish-actions.pod:4179 ../src/guestfs-actions.pod:6499
15942 #: ../fish/guestfish-actions.pod:4181 ../src/guestfs-actions.pod:6501
15943 msgid "Regular file"
15944 msgstr "Звичайний файл"
15947 #: ../fish/guestfish-actions.pod:4183 ../src/guestfs-actions.pod:6503
15952 #: ../fish/guestfish-actions.pod:4185 ../src/guestfs-actions.pod:6505
15957 #: ../fish/guestfish-actions.pod:4187 ../src/guestfs-actions.pod:6507
15962 #: ../fish/guestfish-actions.pod:4189 ../src/guestfs-actions.pod:6509
15963 msgid "Unknown file type"
15964 msgstr "Невідомий тип файла"
15967 #: ../fish/guestfish-actions.pod:4191 ../src/guestfs-actions.pod:6511
15972 #: ../fish/guestfish-actions.pod:4193 ../src/guestfs-actions.pod:6513
15974 "The L<readdir(3)> call returned a C<d_type> field with an unexpected value"
15978 #: ../fish/guestfish-actions.pod:4198
15980 "This function is primarily intended for use by programs. To get a simple "
15981 "list of names, use L</ls>. To get a printable directory for human "
15982 "consumption, use L</ll>."
15986 #: ../fish/guestfish-actions.pod:4202
15991 #: ../fish/guestfish-actions.pod:4204
16001 #: ../fish/guestfish-actions.pod:4206 ../src/guestfs-actions.pod:6534
16002 msgid "This command reads the target of a symbolic link."
16006 #: ../fish/guestfish-actions.pod:4208
16007 msgid "readlinklist"
16008 msgstr "readlinklist"
16011 #: ../fish/guestfish-actions.pod:4210
16014 " readlinklist path 'names ...'\n"
16019 #: ../fish/guestfish-actions.pod:4212 ../src/guestfs-actions.pod:6548
16021 "This call allows you to do a C<readlink> operation on multiple files, where "
16022 "all files are in the directory C<path>. C<names> is the list of files from "
16027 #: ../fish/guestfish-actions.pod:4216 ../src/guestfs-actions.pod:6552
16029 "On return you get a list of strings, with a one-to-one correspondence to the "
16030 "C<names> list. Each string is the value of the symbolic link."
16034 #: ../fish/guestfish-actions.pod:4220 ../src/guestfs-actions.pod:6556
16036 "If the C<readlink(2)> operation fails on any name, then the corresponding "
16037 "result string is the empty string C<\"\">. However the whole operation is "
16038 "completed even if there were C<readlink(2)> errors, and so you can call this "
16039 "function with names where you don't know if they are symbolic links already "
16040 "(albeit slightly less efficient)."
16044 #: ../fish/guestfish-actions.pod:4227 ../src/guestfs-actions.pod:6563
16046 "This call is intended for programs that want to efficiently list a directory "
16047 "contents without making many round-trips. Very long directory listings "
16048 "might cause the protocol message size to be exceeded, causing this call to "
16049 "fail. The caller must split up such requests into smaller groups of names."
16053 #: ../fish/guestfish-actions.pod:4234
16058 #: ../fish/guestfish-actions.pod:4236
16068 #: ../fish/guestfish-actions.pod:4238 ../src/guestfs-actions.pod:6582
16070 "Return the canonicalized absolute pathname of C<path>. The returned path "
16071 "has no C<.>, C<..> or symbolic link path elements."
16075 #: ../fish/guestfish-actions.pod:4241
16076 msgid "removexattr"
16077 msgstr "removexattr"
16080 #: ../fish/guestfish-actions.pod:4243
16083 " removexattr xattr path\n"
16088 #: ../fish/guestfish-actions.pod:4245 ../src/guestfs-actions.pod:6597
16090 "This call removes the extended attribute named C<xattr> of the file C<path>."
16094 #: ../fish/guestfish-actions.pod:4248
16095 msgid "See also: L</lremovexattr>, L<attr(5)>."
16096 msgstr "Див. також L</lremovexattr>, L<attr(5)>."
16099 #: ../fish/guestfish-actions.pod:4250
16104 #: ../fish/guestfish-actions.pod:4252
16107 " resize2fs device\n"
16110 " resize2fs пристрій\n"
16114 #: ../fish/guestfish-actions.pod:4254 ../src/guestfs-actions.pod:6612
16116 "This resizes an ext2, ext3 or ext4 filesystem to match the size of the "
16117 "underlying device."
16121 #: ../fish/guestfish-actions.pod:4257
16123 "I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> "
16124 "before calling this command. For unknown reasons C<resize2fs> sometimes "
16125 "gives an error about this and sometimes not. In any case, it is always safe "
16126 "to call L</e2fsck-f> before calling this function."
16130 #: ../fish/guestfish-actions.pod:4263
16131 msgid "resize2fs-M"
16132 msgstr "resize2fs-M"
16135 #: ../fish/guestfish-actions.pod:4265
16138 " resize2fs-M device\n"
16141 " resize2fs-M пристрій\n"
16145 #: ../fish/guestfish-actions.pod:4267
16147 "This command is the same as L</resize2fs>, but the filesystem is resized to "
16148 "its minimum size. This works like the I<-M> option to the C<resize2fs> "
16153 #: ../fish/guestfish-actions.pod:4271
16155 "To get the resulting size of the filesystem you should call L</tune2fs-l> "
16156 "and read the C<Block size> and C<Block count> values. These two numbers, "
16157 "multiplied together, give the resulting size of the minimal filesystem in "
16162 #: ../fish/guestfish-actions.pod:4276
16163 msgid "resize2fs-size"
16164 msgstr "resize2fs-size"
16167 #: ../fish/guestfish-actions.pod:4278
16170 " resize2fs-size device size\n"
16175 #: ../fish/guestfish-actions.pod:4280
16177 "This command is the same as L</resize2fs> except that it allows you to "
16178 "specify the new size (in bytes) explicitly."
16182 #: ../fish/guestfish-actions.pod:4283
16187 #: ../fish/guestfish-actions.pod:4285
16197 #: ../fish/guestfish-actions.pod:4287 ../src/guestfs-actions.pod:6664
16198 msgid "Remove the single file C<path>."
16202 #: ../fish/guestfish-actions.pod:4289
16207 #: ../fish/guestfish-actions.pod:4291
16217 #: ../fish/guestfish-actions.pod:4293 ../src/guestfs-actions.pod:6676
16219 "Remove the file or directory C<path>, recursively removing the contents if "
16220 "its a directory. This is like the C<rm -rf> shell command."
16224 #: ../fish/guestfish-actions.pod:4297
16229 #: ../fish/guestfish-actions.pod:4299
16239 #: ../fish/guestfish-actions.pod:4301 ../src/guestfs-actions.pod:6690
16240 msgid "Remove the single directory C<path>."
16244 #: ../fish/guestfish-actions.pod:4303
16245 msgid "rmmountpoint"
16246 msgstr "rmmountpoint"
16249 #: ../fish/guestfish-actions.pod:4305
16252 " rmmountpoint exemptpath\n"
16257 #: ../fish/guestfish-actions.pod:4307
16259 "This calls removes a mountpoint that was previously created with L</"
16260 "mkmountpoint>. See L</mkmountpoint> for full details."
16264 #: ../fish/guestfish-actions.pod:4311
16265 msgid "scrub-device"
16266 msgstr "scrub-device"
16269 #: ../fish/guestfish-actions.pod:4313
16272 " scrub-device device\n"
16275 " scrub-device пристрій\n"
16279 #: ../fish/guestfish-actions.pod:4315 ../src/guestfs-actions.pod:6716
16281 "This command writes patterns over C<device> to make data retrieval more "
16286 #: ../fish/guestfish-actions.pod:4318 ../fish/guestfish-actions.pod:4330
16287 #: ../fish/guestfish-actions.pod:4343 ../src/guestfs-actions.pod:6719
16288 #: ../src/guestfs-actions.pod:6737 ../src/guestfs-actions.pod:6756
16290 "It is an interface to the L<scrub(1)> program. See that manual page for "
16295 #: ../fish/guestfish-actions.pod:4321
16297 msgstr "scrub-file"
16300 #: ../fish/guestfish-actions.pod:4323
16303 " scrub-file file\n"
16306 " scrub-file файл\n"
16310 #: ../fish/guestfish-actions.pod:4325 ../src/guestfs-actions.pod:6732
16312 "This command writes patterns over a file to make data retrieval more "
16317 #: ../fish/guestfish-actions.pod:4328 ../src/guestfs-actions.pod:6735
16318 msgid "The file is I<removed> after scrubbing."
16322 #: ../fish/guestfish-actions.pod:4333
16323 msgid "scrub-freespace"
16324 msgstr "scrub-freespace"
16327 #: ../fish/guestfish-actions.pod:4335
16330 " scrub-freespace dir\n"
16333 " scrub-freespace каталог\n"
16337 #: ../fish/guestfish-actions.pod:4337
16339 "This command creates the directory C<dir> and then fills it with files until "
16340 "the filesystem is full, and scrubs the files as for L</scrub-file>, and "
16341 "deletes them. The intention is to scrub any free space on the partition "
16342 "containing C<dir>."
16346 #: ../fish/guestfish-actions.pod:4346
16348 msgstr "set-append"
16351 #: ../fish/guestfish-actions.pod:4348
16356 #: ../fish/guestfish-actions.pod:4350
16359 " set-append append\n"
16364 #: ../fish/guestfish-actions.pod:4352 ../src/guestfs-actions.pod:6769
16366 "This function is used to add additional options to the guest kernel command "
16371 #: ../fish/guestfish-actions.pod:4355 ../src/guestfs-actions.pod:6772
16373 "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> "
16374 "environment variable."
16378 #: ../fish/guestfish-actions.pod:4358 ../src/guestfs-actions.pod:6775
16380 "Setting C<append> to C<NULL> means I<no> additional options are passed "
16381 "(libguestfs always adds a few of its own)."
16385 #: ../fish/guestfish-actions.pod:4361
16386 msgid "set-attach-method"
16387 msgstr "set-attach-method"
16390 #: ../fish/guestfish-actions.pod:4363
16391 msgid "attach-method"
16395 #: ../fish/guestfish-actions.pod:4365
16398 " set-attach-method attachmethod\n"
16403 #: ../fish/guestfish-actions.pod:4367 ../src/guestfs-actions.pod:6788
16405 "Set the method that libguestfs uses to connect to the back end guestfsd "
16406 "daemon. Possible methods are:"
16410 #: ../fish/guestfish-actions.pod:4372 ../src/guestfs-actions.pod:6793
16411 #: ../src/guestfs.pod:2916
16412 msgid "C<appliance>"
16413 msgstr "C<appliance>"
16416 #: ../fish/guestfish-actions.pod:4374 ../src/guestfs-actions.pod:6795
16418 "Launch an appliance and connect to it. This is the ordinary method and the "
16423 #: ../fish/guestfish-actions.pod:4377 ../src/guestfs-actions.pod:6798
16424 msgid "C<unix:I<path>>"
16425 msgstr "C<unix:I<шлях>>"
16428 #: ../fish/guestfish-actions.pod:4379 ../src/guestfs-actions.pod:6800
16429 msgid "Connect to the Unix domain socket I<path>."
16430 msgstr "Встановити з’єднання з сокетом домену Unix I<шлях>."
16433 #: ../fish/guestfish-actions.pod:4381 ../src/guestfs-actions.pod:6802
16435 "This method lets you connect to an existing daemon or (using virtio-serial) "
16436 "to a live guest. For more information, see L<guestfs(3)/ATTACHING TO "
16437 "RUNNING DAEMONS>."
16441 #: ../fish/guestfish-actions.pod:4387
16442 msgid "set-autosync"
16443 msgstr "set-autosync"
16446 #: ../fish/guestfish-actions.pod:4389
16451 #: ../fish/guestfish-actions.pod:4391
16454 " set-autosync true|false\n"
16457 " set-autosync true|false\n"
16461 #: ../fish/guestfish-actions.pod:4393 ../src/guestfs-actions.pod:6818
16463 "If C<autosync> is true, this enables autosync. Libguestfs will make a best "
16464 "effort attempt to make filesystems consistent and synchronized when the "
16465 "handle is closed (also if the program exits without closing handles)."
16469 #: ../fish/guestfish-actions.pod:4398 ../src/guestfs-actions.pod:6823
16471 "This is enabled by default (since libguestfs 1.5.24, previously it was "
16472 "disabled by default)."
16476 #: ../fish/guestfish-actions.pod:4401
16478 msgstr "set-direct"
16481 #: ../fish/guestfish-actions.pod:4403
16486 #: ../fish/guestfish-actions.pod:4405
16489 " set-direct true|false\n"
16492 " set-direct true|false\n"
16496 #: ../fish/guestfish-actions.pod:4407 ../src/guestfs-actions.pod:6836
16498 "If the direct appliance mode flag is enabled, then stdin and stdout are "
16499 "passed directly through to the appliance once it is launched."
16503 #: ../fish/guestfish-actions.pod:4411
16505 "One consequence of this is that log messages aren't caught by the library "
16506 "and handled by L</set-log-message-callback>, but go straight to stdout."
16510 #: ../fish/guestfish-actions.pod:4415 ../src/guestfs-actions.pod:6844
16511 msgid "You probably don't want to use this unless you know what you are doing."
16515 #: ../fish/guestfish-actions.pod:4418 ../src/guestfs-actions.pod:6847
16516 msgid "The default is disabled."
16520 #: ../fish/guestfish-actions.pod:4420
16521 msgid "set-e2label"
16522 msgstr "set-e2label"
16525 #: ../fish/guestfish-actions.pod:4422
16528 " set-e2label device label\n"
16533 #: ../fish/guestfish-actions.pod:4424 ../src/guestfs-actions.pod:6860
16535 "This sets the ext2/3/4 filesystem label of the filesystem on C<device> to "
16536 "C<label>. Filesystem labels are limited to 16 characters."
16540 #: ../fish/guestfish-actions.pod:4428
16542 "You can use either L</tune2fs-l> or L</get-e2label> to return the existing "
16543 "label on a filesystem."
16547 #: ../fish/guestfish-actions.pod:4431
16549 msgstr "set-e2uuid"
16552 #: ../fish/guestfish-actions.pod:4433
16555 " set-e2uuid device uuid\n"
16560 #: ../fish/guestfish-actions.pod:4435 ../src/guestfs-actions.pod:6878
16562 "This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to "
16563 "C<uuid>. The format of the UUID and alternatives such as C<clear>, "
16564 "C<random> and C<time> are described in the L<tune2fs(8)> manpage."
16568 #: ../fish/guestfish-actions.pod:4440
16570 "You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing "
16571 "UUID of a filesystem."
16575 #: ../fish/guestfish-actions.pod:4443
16576 msgid "set-memsize"
16577 msgstr "set-memsize"
16580 #: ../fish/guestfish-actions.pod:4445
16585 #: ../fish/guestfish-actions.pod:4447
16588 " set-memsize memsize\n"
16593 #: ../fish/guestfish-actions.pod:4449
16595 "This sets the memory size in megabytes allocated to the qemu subprocess. "
16596 "This only has any effect if called before L</launch>."
16600 #: ../fish/guestfish-actions.pod:4453 ../src/guestfs-actions.pod:6900
16602 "You can also change this by setting the environment variable "
16603 "C<LIBGUESTFS_MEMSIZE> before the handle is created."
16607 #: ../fish/guestfish-actions.pod:4460
16608 msgid "set-network"
16609 msgstr "set-network"
16612 #: ../fish/guestfish-actions.pod:4462
16617 #: ../fish/guestfish-actions.pod:4464
16620 " set-network true|false\n"
16623 " set-network true|false\n"
16627 #: ../fish/guestfish-actions.pod:4466 ../src/guestfs-actions.pod:6917
16629 "If C<network> is true, then the network is enabled in the libguestfs "
16630 "appliance. The default is false."
16634 #: ../fish/guestfish-actions.pod:4469 ../src/guestfs-actions.pod:6920
16636 "This affects whether commands are able to access the network (see L<guestfs"
16637 "(3)/RUNNING COMMANDS>)."
16641 #: ../fish/guestfish-actions.pod:4472
16643 "You must call this before calling L</launch>, otherwise it has no effect."
16647 #: ../fish/guestfish-actions.pod:4475
16652 #: ../fish/guestfish-actions.pod:4479
16655 " set-path searchpath\n"
16660 #: ../fish/guestfish-actions.pod:4481 ../src/guestfs-actions.pod:6936
16661 msgid "Set the path that libguestfs searches for kernel and initrd.img."
16665 #: ../fish/guestfish-actions.pod:4483 ../src/guestfs-actions.pod:6938
16667 "The default is C<$libdir/guestfs> unless overridden by setting "
16668 "C<LIBGUESTFS_PATH> environment variable."
16672 #: ../fish/guestfish-actions.pod:4486 ../src/guestfs-actions.pod:6941
16673 msgid "Setting C<path> to C<NULL> restores the default path."
16677 #: ../fish/guestfish-actions.pod:4488
16682 #: ../fish/guestfish-actions.pod:4490
16687 #: ../fish/guestfish-actions.pod:4492
16690 " set-pgroup true|false\n"
16695 #: ../fish/guestfish-actions.pod:4494 ../src/guestfs-actions.pod:6953
16697 "If C<pgroup> is true, child processes are placed into their own process "
16702 #: ../fish/guestfish-actions.pod:4497 ../src/guestfs-actions.pod:6956
16704 "The practical upshot of this is that signals like C<SIGINT> (from users "
16705 "pressing C<^C>) won't be received by the child process."
16709 #: ../fish/guestfish-actions.pod:4500 ../src/guestfs-actions.pod:6959
16711 "The default for this flag is false, because usually you want C<^C> to kill "
16716 #: ../fish/guestfish-actions.pod:4503
16721 #: ../fish/guestfish-actions.pod:4505
16726 #: ../fish/guestfish-actions.pod:4507
16736 #: ../fish/guestfish-actions.pod:4509 ../src/guestfs-actions.pod:6972
16737 msgid "Set the qemu binary that we will use."
16741 #: ../fish/guestfish-actions.pod:4511 ../src/guestfs-actions.pod:6974
16743 "The default is chosen when the library was compiled by the configure script."
16747 #: ../fish/guestfish-actions.pod:4514 ../src/guestfs-actions.pod:6977
16749 "You can also override this by setting the C<LIBGUESTFS_QEMU> environment "
16754 #: ../fish/guestfish-actions.pod:4517 ../src/guestfs-actions.pod:6980
16755 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary."
16759 #: ../fish/guestfish-actions.pod:4519 ../src/guestfs-actions.pod:6982
16761 "Note that you should call this function as early as possible after creating "
16762 "the handle. This is because some pre-launch operations depend on testing "
16763 "qemu features (by running C<qemu -help>). If the qemu binary changes, we "
16764 "don't retest features, and so you might see inconsistent results. Using the "
16765 "environment variable C<LIBGUESTFS_QEMU> is safest of all since that picks "
16766 "the qemu binary at the same time as the handle is created."
16770 #: ../fish/guestfish-actions.pod:4527
16771 msgid "set-recovery-proc"
16772 msgstr "set-recovery-proc"
16775 #: ../fish/guestfish-actions.pod:4529
16776 msgid "recovery-proc"
16777 msgstr "recovery-proc"
16780 #: ../fish/guestfish-actions.pod:4531
16783 " set-recovery-proc true|false\n"
16786 " set-recovery-proc true|false\n"
16790 #: ../fish/guestfish-actions.pod:4533
16792 "If this is called with the parameter C<false> then L</launch> does not "
16793 "create a recovery process. The purpose of the recovery process is to stop "
16794 "runaway qemu processes in the case where the main program aborts abruptly."
16798 #: ../fish/guestfish-actions.pod:4538
16800 "This only has any effect if called before L</launch>, and the default is "
16805 #: ../fish/guestfish-actions.pod:4541 ../src/guestfs-actions.pod:7008
16807 "About the only time when you would want to disable this is if the main "
16808 "process will fork itself into the background (\"daemonize\" itself). In "
16809 "this case the recovery process thinks that the main program has disappeared "
16810 "and so kills qemu, which is not very helpful."
16814 #: ../fish/guestfish-actions.pod:4547
16815 msgid "set-selinux"
16816 msgstr "set-selinux"
16819 #: ../fish/guestfish-actions.pod:4549
16824 #: ../fish/guestfish-actions.pod:4551
16827 " set-selinux true|false\n"
16830 " set-selinux true|false\n"
16834 #: ../fish/guestfish-actions.pod:4553 ../src/guestfs-actions.pod:7024
16836 "This sets the selinux flag that is passed to the appliance at boot time. "
16837 "The default is C<selinux=0> (disabled)."
16841 #: ../fish/guestfish-actions.pod:4556 ../src/guestfs-actions.pod:7027
16843 "Note that if SELinux is enabled, it is always in Permissive mode "
16844 "(C<enforcing=0>)."
16848 #: ../fish/guestfish-actions.pod:4562
16853 #: ../fish/guestfish-actions.pod:4564
16858 #: ../fish/guestfish-actions.pod:4566
16866 #: ../fish/guestfish-actions.pod:4568 ../src/guestfs-actions.pod:7043
16868 "Change the number of virtual CPUs assigned to the appliance. The default is "
16869 "C<1>. Increasing this may improve performance, though often it has no "
16874 #: ../fish/guestfish-actions.pod:4572
16875 msgid "This function must be called before L</launch>."
16879 #: ../fish/guestfish-actions.pod:4574
16884 #: ../fish/guestfish-actions.pod:4576
16889 #: ../fish/guestfish-actions.pod:4578
16892 " set-trace true|false\n"
16895 " set-trace true|false\n"
16899 #: ../fish/guestfish-actions.pod:4580 ../src/guestfs-actions.pod:7059
16901 "If the command trace flag is set to 1, then libguestfs calls, parameters and "
16902 "return values are traced."
16906 #: ../fish/guestfish-actions.pod:4583 ../src/guestfs-actions.pod:7062
16908 "If you want to trace C API calls into libguestfs (and other libraries) then "
16909 "possibly a better way is to use the external ltrace(1) command."
16913 #: ../fish/guestfish-actions.pod:4587 ../src/guestfs-actions.pod:7066
16915 "Command traces are disabled unless the environment variable "
16916 "C<LIBGUESTFS_TRACE> is defined and set to C<1>."
16920 #: ../fish/guestfish-actions.pod:4590
16922 "Trace messages are normally sent to C<stderr>, unless you register a "
16923 "callback to send them somewhere else (see L</set-event-callback>)."
16927 #: ../fish/guestfish-actions.pod:4594
16928 msgid "set-verbose"
16929 msgstr "set-verbose"
16932 #: ../fish/guestfish-actions.pod:4596
16937 #: ../fish/guestfish-actions.pod:4598
16940 " set-verbose true|false\n"
16943 " set-verbose true|false\n"
16947 #: ../fish/guestfish-actions.pod:4600 ../src/guestfs-actions.pod:7083
16948 msgid "If C<verbose> is true, this turns on verbose messages."
16952 #: ../fish/guestfish-actions.pod:4602 ../src/guestfs-actions.pod:7085
16954 "Verbose messages are disabled unless the environment variable "
16955 "C<LIBGUESTFS_DEBUG> is defined and set to C<1>."
16959 #: ../fish/guestfish-actions.pod:4605
16961 "Verbose messages are normally sent to C<stderr>, unless you register a "
16962 "callback to send them somewhere else (see L</set-event-callback>)."
16966 #: ../fish/guestfish-actions.pod:4609
16971 #: ../fish/guestfish-actions.pod:4611
16974 " setcon context\n"
16977 " setcon контекст\n"
16981 #: ../fish/guestfish-actions.pod:4613 ../src/guestfs-actions.pod:7102
16983 "This sets the SELinux security context of the daemon to the string "
16988 #: ../fish/guestfish-actions.pod:4616 ../src/guestfs-actions.pod:7105
16989 msgid "See the documentation about SELINUX in L<guestfs(3)>."
16993 #: ../fish/guestfish-actions.pod:4618
16998 #: ../fish/guestfish-actions.pod:4620
17001 " setxattr xattr val vallen path\n"
17006 #: ../fish/guestfish-actions.pod:4622 ../src/guestfs-actions.pod:7120
17008 "This call sets the extended attribute named C<xattr> of the file C<path> to "
17009 "the value C<val> (of length C<vallen>). The value is arbitrary 8 bit data."
17013 #: ../fish/guestfish-actions.pod:4626
17014 msgid "See also: L</lsetxattr>, L<attr(5)>."
17015 msgstr "Див. також L</lsetxattr>, L<attr(5)>."
17018 #: ../fish/guestfish-actions.pod:4628
17023 #: ../fish/guestfish-actions.pod:4630
17026 " sfdisk device cyls heads sectors 'lines ...'\n"
17031 #: ../fish/guestfish-actions.pod:4632 ../src/guestfs-actions.pod:7147
17033 "This is a direct interface to the L<sfdisk(8)> program for creating "
17034 "partitions on block devices."
17038 #: ../fish/guestfish-actions.pod:4635 ../src/guestfs-actions.pod:7150
17039 msgid "C<device> should be a block device, for example C</dev/sda>."
17043 #: ../fish/guestfish-actions.pod:4637 ../src/guestfs-actions.pod:7152
17045 "C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and "
17046 "sectors on the device, which are passed directly to sfdisk as the I<-C>, I<-"
17047 "H> and I<-S> parameters. If you pass C<0> for any of these, then the "
17048 "corresponding parameter is omitted. Usually for 'large' disks, you can just "
17049 "pass C<0> for these, but for small (floppy-sized) disks, sfdisk (or rather, "
17050 "the kernel) cannot work out the right geometry and you will need to tell it."
17054 #: ../fish/guestfish-actions.pod:4645 ../src/guestfs-actions.pod:7160
17056 "C<lines> is a list of lines that we feed to C<sfdisk>. For more information "
17057 "refer to the L<sfdisk(8)> manpage."
17061 #: ../fish/guestfish-actions.pod:4648 ../src/guestfs-actions.pod:7163
17063 "To create a single partition occupying the whole disk, you would pass "
17064 "C<lines> as a single element list, when the single element being the string "
17069 #: ../fish/guestfish-actions.pod:4652
17070 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>"
17071 msgstr "Див. також L</sfdisk-l>, L</sfdisk-N>, L</part-init>"
17074 #: ../fish/guestfish-actions.pod:4655 ../fish/guestfish-actions.pod:4675
17075 #: ../fish/guestfish-actions.pod:4694
17077 "I<This function is deprecated.> In new code, use the L</part_add> call "
17082 #: ../fish/guestfish-actions.pod:4662
17087 #: ../fish/guestfish-actions.pod:4664
17090 " sfdiskM device 'lines ...'\n"
17095 #: ../fish/guestfish-actions.pod:4666
17097 "This is a simplified interface to the L</sfdisk> command, where partition "
17098 "sizes are specified in megabytes only (rounded to the nearest cylinder) and "
17099 "you don't need to specify the cyls, heads and sectors parameters which were "
17100 "rarely if ever used anyway."
17104 #: ../fish/guestfish-actions.pod:4672
17105 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>"
17107 "Див також L</sfdisk>, сторінку довідки (man) L<sfdisk(8)> та L</part-disk>"
17110 #: ../fish/guestfish-actions.pod:4682
17115 #: ../fish/guestfish-actions.pod:4684
17118 " sfdisk-N device partnum cyls heads sectors line\n"
17123 #: ../fish/guestfish-actions.pod:4686 ../src/guestfs-actions.pod:7219
17125 "This runs L<sfdisk(8)> option to modify just the single partition C<n> "
17126 "(note: C<n> counts from 1)."
17130 #: ../fish/guestfish-actions.pod:4689
17132 "For other parameters, see L</sfdisk>. You should usually pass C<0> for the "
17133 "cyls/heads/sectors parameters."
17137 #: ../fish/guestfish-actions.pod:4692
17138 msgid "See also: L</part-add>"
17139 msgstr "Див. також L</part-add>"
17142 #: ../fish/guestfish-actions.pod:4701
17143 msgid "sfdisk-disk-geometry"
17144 msgstr "sfdisk-disk-geometry"
17147 #: ../fish/guestfish-actions.pod:4703
17150 " sfdisk-disk-geometry device\n"
17153 " sfdisk-disk-geometry пристрій\n"
17157 #: ../fish/guestfish-actions.pod:4705
17159 "This displays the disk geometry of C<device> read from the partition table. "
17160 "Especially in the case where the underlying block device has been resized, "
17161 "this can be different from the kernel's idea of the geometry (see L</sfdisk-"
17162 "kernel-geometry>)."
17166 #: ../fish/guestfish-actions.pod:4710 ../fish/guestfish-actions.pod:4719
17167 #: ../src/guestfs-actions.pod:7242 ../src/guestfs-actions.pod:7258
17168 msgid "The result is in human-readable format, and not designed to be parsed."
17172 #: ../fish/guestfish-actions.pod:4713
17173 msgid "sfdisk-kernel-geometry"
17174 msgstr "sfdisk-kernel-geometry"
17177 #: ../fish/guestfish-actions.pod:4715
17180 " sfdisk-kernel-geometry device\n"
17183 " sfdisk-kernel-geometry пристрій\n"
17187 #: ../fish/guestfish-actions.pod:4717 ../src/guestfs-actions.pod:7256
17188 msgid "This displays the kernel's idea of the geometry of C<device>."
17192 #: ../fish/guestfish-actions.pod:4722
17197 #: ../fish/guestfish-actions.pod:4724
17200 " sfdisk-l device\n"
17203 " sfdisk-l пристрій\n"
17207 #: ../fish/guestfish-actions.pod:4726 ../src/guestfs-actions.pod:7279
17209 "This displays the partition table on C<device>, in the human-readable output "
17210 "of the L<sfdisk(8)> command. It is not intended to be parsed."
17214 #: ../fish/guestfish-actions.pod:4730
17215 msgid "See also: L</part-list>"
17216 msgstr "Див. також L</part-list>"
17219 #: ../fish/guestfish-actions.pod:4732
17221 "I<This function is deprecated.> In new code, use the L</part_list> call "
17226 #: ../fish/guestfish-actions.pod:4739
17231 #: ../fish/guestfish-actions.pod:4741
17241 #: ../fish/guestfish-actions.pod:4743 ../src/guestfs-actions.pod:7296
17243 "This call runs a command from the guest filesystem via the guest's C</bin/"
17248 #: ../fish/guestfish-actions.pod:4746
17249 msgid "This is like L</command>, but passes the command to:"
17253 #: ../fish/guestfish-actions.pod:4748 ../src/guestfs-actions.pod:7301
17256 " /bin/sh -c \"command\"\n"
17261 #: ../fish/guestfish-actions.pod:4750 ../src/guestfs-actions.pod:7303
17263 "Depending on the guest's shell, this usually results in wildcards being "
17264 "expanded, shell expressions being interpolated and so on."
17268 #: ../fish/guestfish-actions.pod:4754
17269 msgid "All the provisos about L</command> apply to this call."
17273 #: ../fish/guestfish-actions.pod:4756
17278 #: ../fish/guestfish-actions.pod:4758
17281 " sh-lines command\n"
17284 " sh-lines команда\n"
17288 #: ../fish/guestfish-actions.pod:4760
17289 msgid "This is the same as L</sh>, but splits the result into a list of lines."
17293 #: ../fish/guestfish-actions.pod:4763
17294 msgid "See also: L</command-lines>"
17295 msgstr "Див. також L</command-lines>"
17298 #: ../fish/guestfish-actions.pod:4765
17303 #: ../fish/guestfish-actions.pod:4767
17309 " sleep час_у_секундах\n"
17313 #: ../fish/guestfish-actions.pod:4769 ../src/guestfs-actions.pod:7337
17314 msgid "Sleep for C<secs> seconds."
17318 #: ../fish/guestfish-actions.pod:4771
17323 #: ../fish/guestfish-actions.pod:4773
17333 #: ../fish/guestfish-actions.pod:4777 ../src/guestfs-actions.pod:7351
17334 msgid "This is the same as the C<stat(2)> system call."
17338 #: ../fish/guestfish-actions.pod:4779
17343 #: ../fish/guestfish-actions.pod:4781
17353 #: ../fish/guestfish-actions.pod:4783 ../src/guestfs-actions.pod:7365
17355 "Returns file system statistics for any mounted file system. C<path> should "
17356 "be a file or directory in the mounted file system (typically it is the mount "
17357 "point itself, but it doesn't need to be)."
17361 #: ../fish/guestfish-actions.pod:4787 ../src/guestfs-actions.pod:7369
17362 msgid "This is the same as the C<statvfs(2)> system call."
17366 #: ../fish/guestfish-actions.pod:4789
17371 #: ../fish/guestfish-actions.pod:4791
17381 #: ../fish/guestfish-actions.pod:4793 ../src/guestfs-actions.pod:7383
17383 "This runs the L<strings(1)> command on a file and returns the list of "
17384 "printable strings found."
17388 #: ../fish/guestfish-actions.pod:4799
17393 #: ../fish/guestfish-actions.pod:4801
17396 " strings-e encoding path\n"
17399 " strings-e кодування шлях\n"
17403 #: ../fish/guestfish-actions.pod:4803
17405 "This is like the L</strings> command, but allows you to specify the encoding "
17406 "of strings that are looked for in the source file C<path>."
17410 #: ../fish/guestfish-actions.pod:4807 ../src/guestfs-actions.pod:7406
17411 msgid "Allowed encodings are:"
17412 msgstr "Можливими кодуваннями є:"
17415 #: ../fish/guestfish-actions.pod:4811 ../src/guestfs-actions.pod:7410
17420 #: ../fish/guestfish-actions.pod:4813
17422 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
17423 "ISO-8859-X (this is what L</strings> uses)."
17427 #: ../fish/guestfish-actions.pod:4816 ../src/guestfs-actions.pod:7415
17432 #: ../fish/guestfish-actions.pod:4818 ../src/guestfs-actions.pod:7417
17433 msgid "Single 8-bit-byte characters."
17434 msgstr "Окремі 8-бітові-байтові символи."
17437 #: ../fish/guestfish-actions.pod:4820 ../src/guestfs-actions.pod:7419
17442 #: ../fish/guestfish-actions.pod:4822 ../src/guestfs-actions.pod:7421
17443 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE."
17447 #: ../fish/guestfish-actions.pod:4825 ../src/guestfs-actions.pod:7424
17448 msgid "l (lower case letter L)"
17452 #: ../fish/guestfish-actions.pod:4827 ../src/guestfs-actions.pod:7426
17454 "16-bit little endian such as UTF-16LE and UCS-2LE. This is useful for "
17455 "examining binaries in Windows guests."
17459 #: ../fish/guestfish-actions.pod:4830 ../src/guestfs-actions.pod:7429
17464 #: ../fish/guestfish-actions.pod:4832 ../src/guestfs-actions.pod:7431
17465 msgid "32-bit big endian such as UCS-4BE."
17469 #: ../fish/guestfish-actions.pod:4834 ../src/guestfs-actions.pod:7433
17474 #: ../fish/guestfish-actions.pod:4836 ../src/guestfs-actions.pod:7435
17475 msgid "32-bit little endian such as UCS-4LE."
17479 #: ../fish/guestfish-actions.pod:4840 ../src/guestfs-actions.pod:7439
17480 msgid "The returned strings are transcoded to UTF-8."
17484 #: ../fish/guestfish-actions.pod:4845
17485 msgid "swapoff-device"
17486 msgstr "swapoff-device"
17489 #: ../fish/guestfish-actions.pod:4847
17492 " swapoff-device device\n"
17495 " swapoff-device пристрій\n"
17499 #: ../fish/guestfish-actions.pod:4849
17501 "This command disables the libguestfs appliance swap device or partition "
17502 "named C<device>. See L</swapon-device>."
17506 #: ../fish/guestfish-actions.pod:4853
17507 msgid "swapoff-file"
17508 msgstr "swapoff-file"
17511 #: ../fish/guestfish-actions.pod:4855
17514 " swapoff-file file\n"
17517 " swapoff-file файл\n"
17521 #: ../fish/guestfish-actions.pod:4857 ../src/guestfs-actions.pod:7470
17522 msgid "This command disables the libguestfs appliance swap on file."
17526 #: ../fish/guestfish-actions.pod:4859
17527 msgid "swapoff-label"
17528 msgstr "swapoff-label"
17531 #: ../fish/guestfish-actions.pod:4861
17534 " swapoff-label label\n"
17537 " swapoff-label мітка\n"
17541 #: ../fish/guestfish-actions.pod:4863 ../src/guestfs-actions.pod:7482
17543 "This command disables the libguestfs appliance swap on labeled swap "
17548 #: ../fish/guestfish-actions.pod:4866
17549 msgid "swapoff-uuid"
17550 msgstr "swapoff-uuid"
17553 #: ../fish/guestfish-actions.pod:4868
17556 " swapoff-uuid uuid\n"
17559 " swapoff-uuid uuid\n"
17563 #: ../fish/guestfish-actions.pod:4870 ../src/guestfs-actions.pod:7495
17565 "This command disables the libguestfs appliance swap partition with the given "
17570 #: ../fish/guestfish-actions.pod:4873
17571 msgid "swapon-device"
17572 msgstr "swapon-device"
17575 #: ../fish/guestfish-actions.pod:4875
17578 " swapon-device device\n"
17581 " swapon-device пристрій\n"
17585 #: ../fish/guestfish-actions.pod:4877
17587 "This command enables the libguestfs appliance to use the swap device or "
17588 "partition named C<device>. The increased memory is made available for all "
17589 "commands, for example those run using L</command> or L</sh>."
17593 #: ../fish/guestfish-actions.pod:4882 ../src/guestfs-actions.pod:7513
17595 "Note that you should not swap to existing guest swap partitions unless you "
17596 "know what you are doing. They may contain hibernation information, or other "
17597 "information that the guest doesn't want you to trash. You also risk leaking "
17598 "information about the host to the guest this way. Instead, attach a new "
17599 "host device to the guest and swap on that."
17603 #: ../fish/guestfish-actions.pod:4889
17604 msgid "swapon-file"
17605 msgstr "swapon-file"
17608 #: ../fish/guestfish-actions.pod:4891
17611 " swapon-file file\n"
17614 " swapon-file файл\n"
17618 #: ../fish/guestfish-actions.pod:4893
17620 "This command enables swap to a file. See L</swapon-device> for other notes."
17624 #: ../fish/guestfish-actions.pod:4896
17625 msgid "swapon-label"
17626 msgstr "swapon-label"
17629 #: ../fish/guestfish-actions.pod:4898
17632 " swapon-label label\n"
17635 " swapon-label мітка\n"
17639 #: ../fish/guestfish-actions.pod:4900
17641 "This command enables swap to a labeled swap partition. See L</swapon-"
17642 "device> for other notes."
17646 #: ../fish/guestfish-actions.pod:4903
17647 msgid "swapon-uuid"
17648 msgstr "swapon-uuid"
17651 #: ../fish/guestfish-actions.pod:4905
17654 " swapon-uuid uuid\n"
17657 " swapon-uuid uuid\n"
17661 #: ../fish/guestfish-actions.pod:4907
17663 "This command enables swap to a swap partition with the given UUID. See L</"
17664 "swapon-device> for other notes."
17668 #: ../fish/guestfish-actions.pod:4910
17673 #: ../fish/guestfish-actions.pod:4912
17683 #: ../fish/guestfish-actions.pod:4914 ../src/guestfs-actions.pod:7568
17685 "This syncs the disk, so that any writes are flushed through to the "
17686 "underlying disk image."
17690 #: ../fish/guestfish-actions.pod:4917 ../src/guestfs-actions.pod:7571
17692 "You should always call this if you have modified a disk image, before "
17693 "closing the handle."
17697 #: ../fish/guestfish-actions.pod:4920
17702 #: ../fish/guestfish-actions.pod:4922
17712 #: ../fish/guestfish-actions.pod:4924 ../src/guestfs-actions.pod:7584
17714 "This command returns up to the last 10 lines of a file as a list of strings."
17718 #: ../fish/guestfish-actions.pod:4930
17723 #: ../fish/guestfish-actions.pod:4932
17726 " tail-n nrlines path\n"
17731 #: ../fish/guestfish-actions.pod:4934 ../src/guestfs-actions.pod:7603
17733 "If the parameter C<nrlines> is a positive number, this returns the last "
17734 "C<nrlines> lines of the file C<path>."
17738 #: ../fish/guestfish-actions.pod:4937 ../src/guestfs-actions.pod:7606
17740 "If the parameter C<nrlines> is a negative number, this returns lines from "
17741 "the file C<path>, starting with the C<-nrlines>th line."
17745 #: ../fish/guestfish-actions.pod:4945
17750 #: ../fish/guestfish-actions.pod:4947
17753 " tar-in (tarfile|-) directory\n"
17756 " tar-in (файл_tar|-) каталог\n"
17760 #: ../fish/guestfish-actions.pod:4949 ../src/guestfs-actions.pod:7627
17762 "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> "
17763 "tar file) into C<directory>."
17767 #: ../fish/guestfish-actions.pod:4952
17768 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>."
17772 #: ../fish/guestfish-actions.pod:4957
17777 #: ../fish/guestfish-actions.pod:4959
17780 " tar-out directory (tarfile|-)\n"
17783 " tar-out каталог (файл tar|-)\n"
17787 #: ../fish/guestfish-actions.pod:4961 ../src/guestfs-actions.pod:7644
17789 "This command packs the contents of C<directory> and downloads it to local "
17794 #: ../fish/guestfish-actions.pod:4964
17795 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>."
17799 #: ../fish/guestfish-actions.pod:4969
17804 #: ../fish/guestfish-actions.pod:4971
17807 " tgz-in (tarball|-) directory\n"
17810 " tgz-in (архів tar|-) каталог\n"
17814 #: ../fish/guestfish-actions.pod:4973 ../src/guestfs-actions.pod:7661
17816 "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> "
17817 "tar file) into C<directory>."
17821 #: ../fish/guestfish-actions.pod:4976
17822 msgid "To upload an uncompressed tarball, use L</tar-in>."
17826 #: ../fish/guestfish-actions.pod:4980
17831 #: ../fish/guestfish-actions.pod:4982
17834 " tgz-out directory (tarball|-)\n"
17837 " tgz-out каталог (архів tar|-)\n"
17841 #: ../fish/guestfish-actions.pod:4984 ../src/guestfs-actions.pod:7677
17843 "This command packs the contents of C<directory> and downloads it to local "
17848 #: ../fish/guestfish-actions.pod:4987
17849 msgid "To download an uncompressed tarball, use L</tar-out>."
17853 #: ../fish/guestfish-actions.pod:4991
17858 #: ../fish/guestfish-actions.pod:4993
17868 #: ../fish/guestfish-actions.pod:4995 ../src/guestfs-actions.pod:7692
17870 "Touch acts like the L<touch(1)> command. It can be used to update the "
17871 "timestamps on a file, or, if the file does not exist, to create a new zero-"
17876 #: ../fish/guestfish-actions.pod:4999 ../src/guestfs-actions.pod:7696
17878 "This command only works on regular files, and will fail on other file types "
17879 "such as directories, symbolic links, block special etc."
17883 #: ../fish/guestfish-actions.pod:5002
17888 #: ../fish/guestfish-actions.pod:5004
17898 #: ../fish/guestfish-actions.pod:5006 ../src/guestfs-actions.pod:7709
17900 "This command truncates C<path> to a zero-length file. The file must exist "
17905 #: ../fish/guestfish-actions.pod:5009
17906 msgid "truncate-size"
17907 msgstr "truncate-size"
17910 #: ../fish/guestfish-actions.pod:5011
17913 " truncate-size path size\n"
17916 " truncate-size шлях розмір\n"
17920 #: ../fish/guestfish-actions.pod:5013 ../src/guestfs-actions.pod:7723
17922 "This command truncates C<path> to size C<size> bytes. The file must exist "
17927 #: ../fish/guestfish-actions.pod:5016
17929 "If the current file size is less than C<size> then the file is extended to "
17930 "the required size with zero bytes. This creates a sparse file (ie. disk "
17931 "blocks are not allocated for the file until you write to it). To create a "
17932 "non-sparse file of zeroes, use L</fallocate64> instead."
17936 #: ../fish/guestfish-actions.pod:5022
17938 #| msgid "tune2fs-l"
17943 #: ../fish/guestfish-actions.pod:5024
17946 " tune2fs device [force:true|false] [maxmountcount:N] [mountcount:N] [errorbehavior:..] [group:N] [intervalbetweenchecks:N] [reservedblockspercentage:N] [lastmounteddirectory:..] [reservedblockscount:N] [user:N]\n"
17951 #: ../fish/guestfish-actions.pod:5026 ../src/guestfs-actions.pod:7759
17953 "This call allows you to adjust various filesystem parameters of an ext2/ext3/"
17954 "ext4 filesystem called C<device>."
17958 #: ../fish/guestfish-actions.pod:5035 ../src/guestfs-actions.pod:7768
17960 "Force tune2fs to complete the operation even in the face of errors. This is "
17961 "the same as the tune2fs C<-f> option."
17965 #: ../fish/guestfish-actions.pod:5038 ../src/guestfs-actions.pod:7771
17967 #| msgid "mkmountpoint"
17968 msgid "C<maxmountcount>"
17969 msgstr "mkmountpoint"
17972 #: ../fish/guestfish-actions.pod:5040 ../src/guestfs-actions.pod:7773
17974 "Set the number of mounts after which the filesystem is checked by L<e2fsck(8)"
17975 ">. If this is C<0> then the number of mounts is disregarded. This is the "
17976 "same as the tune2fs C<-c> option."
17980 #: ../fish/guestfish-actions.pod:5044 ../src/guestfs-actions.pod:7777
17982 #| msgid "mountpoints"
17983 msgid "C<mountcount>"
17984 msgstr "mountpoints"
17987 #: ../fish/guestfish-actions.pod:5046 ../src/guestfs-actions.pod:7779
17989 "Set the number of times the filesystem has been mounted. This is the same "
17990 "as the tune2fs C<-C> option."
17994 #: ../fish/guestfish-actions.pod:5049 ../src/guestfs-actions.pod:7782
17995 msgid "C<errorbehavior>"
17999 #: ../fish/guestfish-actions.pod:5051 ../src/guestfs-actions.pod:7784
18001 "Change the behavior of the kernel code when errors are detected. Possible "
18002 "values currently are: C<continue>, C<remount-ro>, C<panic>. In practice "
18003 "these options don't really make any difference, particularly for write "
18008 #: ../fish/guestfish-actions.pod:5056 ../src/guestfs-actions.pod:7789
18009 msgid "This is the same as the tune2fs C<-e> option."
18013 #: ../fish/guestfish-actions.pod:5058 ../src/guestfs-actions.pod:7791
18015 #| msgid "B<--volgroups>"
18017 msgstr "B<--volgroups>"
18020 #: ../fish/guestfish-actions.pod:5060 ../src/guestfs-actions.pod:7793
18022 "Set the group which can use reserved filesystem blocks. This is the same as "
18023 "the tune2fs C<-g> option except that it can only be specified as a number."
18027 #: ../fish/guestfish-actions.pod:5064 ../src/guestfs-actions.pod:7797
18028 msgid "C<intervalbetweenchecks>"
18032 #: ../fish/guestfish-actions.pod:5066 ../src/guestfs-actions.pod:7799
18034 "Adjust the maximal time between two filesystem checks (in seconds). If the "
18035 "option is passed as C<0> then time-dependent checking is disabled."
18039 #: ../fish/guestfish-actions.pod:5070 ../src/guestfs-actions.pod:7803
18040 msgid "This is the same as the tune2fs C<-i> option."
18044 #: ../fish/guestfish-actions.pod:5072 ../src/guestfs-actions.pod:7805
18045 msgid "C<reservedblockspercentage>"
18049 #: ../fish/guestfish-actions.pod:5074 ../src/guestfs-actions.pod:7807
18051 "Set the percentage of the filesystem which may only be allocated by "
18052 "privileged processes. This is the same as the tune2fs C<-m> option."
18056 #: ../fish/guestfish-actions.pod:5078 ../src/guestfs-actions.pod:7811
18057 msgid "C<lastmounteddirectory>"
18061 #: ../fish/guestfish-actions.pod:5080 ../src/guestfs-actions.pod:7813
18063 "Set the last mounted directory. This is the same as the tune2fs C<-M> "
18068 #: ../fish/guestfish-actions.pod:5083 ../src/guestfs-actions.pod:7816
18070 "C<reservedblockscount> Set the number of reserved filesystem blocks. This "
18071 "is the same as the tune2fs C<-r> option."
18075 #: ../fish/guestfish-actions.pod:5087 ../src/guestfs-actions.pod:7820
18080 #: ../fish/guestfish-actions.pod:5089 ../src/guestfs-actions.pod:7822
18082 "Set the user who can use the reserved filesystem blocks. This is the same "
18083 "as the tune2fs C<-u> option except that it can only be specified as a number."
18087 #: ../fish/guestfish-actions.pod:5095
18089 "To get the current values of filesystem parameters, see L</tune2fs-l>. For "
18090 "precise details of how tune2fs works, see the L<tune2fs(8)> man page."
18094 #: ../fish/guestfish-actions.pod:5101
18099 #: ../fish/guestfish-actions.pod:5103
18102 " tune2fs-l device\n"
18105 " tune2fs-l пристрій\n"
18109 #: ../fish/guestfish-actions.pod:5105 ../src/guestfs-actions.pod:7862
18111 "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on "
18116 #: ../fish/guestfish-actions.pod:5108 ../src/guestfs-actions.pod:7865
18118 "It is the same as running C<tune2fs -l device>. See L<tune2fs(8)> manpage "
18119 "for more details. The list of fields returned isn't clearly defined, and "
18120 "depends on both the version of C<tune2fs> that libguestfs was built against, "
18121 "and the filesystem itself."
18125 #: ../fish/guestfish-actions.pod:5113
18130 #: ../fish/guestfish-actions.pod:5115
18133 " txz-in (tarball|-) directory\n"
18136 " txz-in (архів tar|-) каталог\n"
18140 #: ../fish/guestfish-actions.pod:5117 ../src/guestfs-actions.pod:7885
18142 "This command uploads and unpacks local file C<tarball> (an I<xz compressed> "
18143 "tar file) into C<directory>."
18147 #: ../fish/guestfish-actions.pod:5122
18152 #: ../fish/guestfish-actions.pod:5124
18155 " txz-out directory (tarball|-)\n"
18158 " txz-out каталог (архів tar|-)\n"
18162 #: ../fish/guestfish-actions.pod:5126 ../src/guestfs-actions.pod:7899
18164 "This command packs the contents of C<directory> and downloads it to local "
18165 "file C<tarball> (as an xz compressed tar archive)."
18169 #: ../fish/guestfish-actions.pod:5131
18174 #: ../fish/guestfish-actions.pod:5133
18184 #: ../fish/guestfish-actions.pod:5135 ../src/guestfs-actions.pod:7912
18186 "This function sets the mask used for creating new files and device nodes to "
18191 #: ../fish/guestfish-actions.pod:5138 ../src/guestfs-actions.pod:7915
18193 "Typical umask values would be C<022> which creates new files with "
18194 "permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates "
18195 "new files with permissions like \"-rw-rw-r--\" or \"-rwxrwxr-x\"."
18199 #: ../fish/guestfish-actions.pod:5143 ../src/guestfs-actions.pod:7920
18201 "The default umask is C<022>. This is important because it means that "
18202 "directories and device nodes will be created with C<0644> or C<0755> mode "
18203 "even if you specify C<0777>."
18207 #: ../fish/guestfish-actions.pod:5147
18208 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>."
18209 msgstr "Див. також L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>."
18212 #: ../fish/guestfish-actions.pod:5150 ../src/guestfs-actions.pod:7927
18213 msgid "This call returns the previous umask."
18217 #: ../fish/guestfish-actions.pod:5152
18222 #: ../fish/guestfish-actions.pod:5154
18227 #: ../fish/guestfish-actions.pod:5156
18230 " umount pathordevice\n"
18233 " umount шлях_або_пристрій\n"
18237 #: ../fish/guestfish-actions.pod:5158 ../src/guestfs-actions.pod:7939
18239 "This unmounts the given filesystem. The filesystem may be specified either "
18240 "by its mountpoint (path) or the device which contains the filesystem."
18244 #: ../fish/guestfish-actions.pod:5162
18246 msgstr "umount-all"
18249 #: ../fish/guestfish-actions.pod:5164
18250 msgid "unmount-all"
18251 msgstr "unmount-all"
18254 #: ../fish/guestfish-actions.pod:5166
18264 #: ../fish/guestfish-actions.pod:5168 ../src/guestfs-actions.pod:7952
18265 msgid "This unmounts all mounted filesystems."
18269 #: ../fish/guestfish-actions.pod:5170 ../src/guestfs-actions.pod:7954
18270 msgid "Some internal mounts are not unmounted by this call."
18274 #: ../fish/guestfish-actions.pod:5172
18279 #: ../fish/guestfish-actions.pod:5174
18282 " upload (filename|-) remotefilename\n"
18285 " upload (назва_файла|-) назва_віддаленого_файла\n"
18289 #: ../fish/guestfish-actions.pod:5176 ../fish/guestfish-actions.pod:5189
18290 #: ../src/guestfs-actions.pod:7967 ../src/guestfs-actions.pod:7991
18291 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem."
18295 #: ../fish/guestfish-actions.pod:5181
18296 msgid "See also L</download>."
18297 msgstr "Див. також L</download>."
18300 #: ../fish/guestfish-actions.pod:5185
18301 msgid "upload-offset"
18302 msgstr "upload-offset"
18305 #: ../fish/guestfish-actions.pod:5187
18308 " upload-offset (filename|-) remotefilename offset\n"
18311 " upload-offset (назва_файла|-) назва_віддаленого_файла відступ\n"
18315 #: ../fish/guestfish-actions.pod:5192 ../src/guestfs-actions.pod:7994
18317 "C<remotefilename> is overwritten starting at the byte C<offset> specified. "
18318 "The intention is to overwrite parts of existing files or devices, although "
18319 "if a non-existant file is specified then it is created with a \"hole\" "
18320 "before C<offset>. The size of the data written is implicit in the size of "
18321 "the source C<filename>."
18325 #: ../fish/guestfish-actions.pod:5199
18327 "Note that there is no limit on the amount of data that can be uploaded with "
18328 "this call, unlike with L</pwrite>, and this call always writes the full "
18329 "amount unless an error occurs."
18333 #: ../fish/guestfish-actions.pod:5204
18334 msgid "See also L</upload>, L</pwrite>."
18335 msgstr "Див. також L</upload>, L</pwrite>."
18338 #: ../fish/guestfish-actions.pod:5208
18343 #: ../fish/guestfish-actions.pod:5210
18346 " utimens path atsecs atnsecs mtsecs mtnsecs\n"
18351 #: ../fish/guestfish-actions.pod:5212 ../src/guestfs-actions.pod:8027
18352 msgid "This command sets the timestamps of a file with nanosecond precision."
18356 #: ../fish/guestfish-actions.pod:5215 ../src/guestfs-actions.pod:8030
18358 "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds "
18363 #: ../fish/guestfish-actions.pod:5218 ../src/guestfs-actions.pod:8033
18365 "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and "
18366 "nanoseconds from the epoch."
18370 #: ../fish/guestfish-actions.pod:5221 ../src/guestfs-actions.pod:8036
18372 "If the C<*nsecs> field contains the special value C<-1> then the "
18373 "corresponding timestamp is set to the current time. (The C<*secs> field is "
18374 "ignored in this case)."
18378 #: ../fish/guestfish-actions.pod:5225 ../src/guestfs-actions.pod:8040
18380 "If the C<*nsecs> field contains the special value C<-2> then the "
18381 "corresponding timestamp is left unchanged. (The C<*secs> field is ignored "
18386 #: ../fish/guestfish-actions.pod:5229
18391 #: ../fish/guestfish-actions.pod:5231
18401 #: ../fish/guestfish-actions.pod:5233 ../src/guestfs-actions.pod:8053
18403 "Return the libguestfs version number that the program is linked against."
18407 #: ../fish/guestfish-actions.pod:5236 ../src/guestfs-actions.pod:8056
18409 "Note that because of dynamic linking this is not necessarily the version of "
18410 "libguestfs that you compiled against. You can compile the program, and then "
18411 "at runtime dynamically link against a completely different C<libguestfs.so> "
18416 #: ../fish/guestfish-actions.pod:5241 ../src/guestfs-actions.pod:8061
18418 "This call was added in version C<1.0.58>. In previous versions of "
18419 "libguestfs there was no way to get the version number. From C code you can "
18420 "use dynamic linker functions to find out if this symbol exists (if it "
18421 "doesn't, then it's an earlier version)."
18425 #: ../fish/guestfish-actions.pod:5247 ../src/guestfs-actions.pod:8067
18427 "The call returns a structure with four elements. The first three (C<major>, "
18428 "C<minor> and C<release>) are numbers and correspond to the usual version "
18429 "triplet. The fourth element (C<extra>) is a string and is normally empty, "
18430 "but may be used for distro-specific information."
18434 #: ../fish/guestfish-actions.pod:5253 ../src/guestfs-actions.pod:8073
18436 "To construct the original version string: C<$major.$minor.$release$extra>"
18440 #: ../fish/guestfish-actions.pod:5256 ../src/guestfs-actions.pod:8076
18441 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>."
18442 msgstr "Див також: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>."
18445 #: ../fish/guestfish-actions.pod:5258
18447 "I<Note:> Don't use this call to test for availability of features. In "
18448 "enterprise distributions we backport features from later versions into "
18449 "earlier versions, making this an unreliable way to test for features. Use "
18450 "L</available> instead."
18454 #: ../fish/guestfish-actions.pod:5264
18459 #: ../fish/guestfish-actions.pod:5266
18462 " vfs-label device\n"
18465 " vfs-label пристрій\n"
18469 #: ../fish/guestfish-actions.pod:5268 ../src/guestfs-actions.pod:8096
18470 msgid "This returns the filesystem label of the filesystem on C<device>."
18474 #: ../fish/guestfish-actions.pod:5271 ../src/guestfs-actions.pod:8099
18475 msgid "If the filesystem is unlabeled, this returns the empty string."
18479 #: ../fish/guestfish-actions.pod:5273
18480 msgid "To find a filesystem from the label, use L</findfs-label>."
18484 #: ../fish/guestfish-actions.pod:5275
18489 #: ../fish/guestfish-actions.pod:5277
18492 " vfs-type device\n"
18495 " vfs-type пристрій\n"
18499 #: ../fish/guestfish-actions.pod:5279 ../src/guestfs-actions.pod:8114
18501 "This command gets the filesystem type corresponding to the filesystem on "
18506 #: ../fish/guestfish-actions.pod:5282 ../src/guestfs-actions.pod:8117
18508 "For most filesystems, the result is the name of the Linux VFS module which "
18509 "would be used to mount this filesystem if you mounted it without specifying "
18510 "the filesystem type. For example a string such as C<ext3> or C<ntfs>."
18514 #: ../fish/guestfish-actions.pod:5287
18519 #: ../fish/guestfish-actions.pod:5289
18522 " vfs-uuid device\n"
18525 " vfs-uuid пристрій\n"
18529 #: ../fish/guestfish-actions.pod:5291 ../src/guestfs-actions.pod:8133
18530 msgid "This returns the filesystem UUID of the filesystem on C<device>."
18534 #: ../fish/guestfish-actions.pod:5294 ../src/guestfs-actions.pod:8136
18535 msgid "If the filesystem does not have a UUID, this returns the empty string."
18539 #: ../fish/guestfish-actions.pod:5296
18540 msgid "To find a filesystem from the UUID, use L</findfs-uuid>."
18544 #: ../fish/guestfish-actions.pod:5298
18545 msgid "vg-activate"
18546 msgstr "vg-activate"
18549 #: ../fish/guestfish-actions.pod:5300
18552 " vg-activate true|false 'volgroups ...'\n"
18557 #: ../fish/guestfish-actions.pod:5302 ../src/guestfs-actions.pod:8152
18559 "This command activates or (if C<activate> is false) deactivates all logical "
18560 "volumes in the listed volume groups C<volgroups>."
18564 #: ../fish/guestfish-actions.pod:5305 ../src/guestfs-actions.pod:8155
18565 msgid "This command is the same as running C<vgchange -a y|n volgroups...>"
18569 #: ../fish/guestfish-actions.pod:5307 ../src/guestfs-actions.pod:8157
18571 "Note that if C<volgroups> is an empty list then B<all> volume groups are "
18572 "activated or deactivated."
18576 #: ../fish/guestfish-actions.pod:5310
18577 msgid "vg-activate-all"
18578 msgstr "vg-activate-all"
18581 #: ../fish/guestfish-actions.pod:5312
18584 " vg-activate-all true|false\n"
18587 " vg-activate-all true|false\n"
18591 #: ../fish/guestfish-actions.pod:5314 ../src/guestfs-actions.pod:8170
18593 "This command activates or (if C<activate> is false) deactivates all logical "
18594 "volumes in all volume groups."
18598 #: ../fish/guestfish-actions.pod:5317 ../src/guestfs-actions.pod:8173
18599 msgid "This command is the same as running C<vgchange -a y|n>"
18603 #: ../fish/guestfish-actions.pod:5319
18608 #: ../fish/guestfish-actions.pod:5321
18611 " vgcreate volgroup 'physvols ...'\n"
18616 #: ../fish/guestfish-actions.pod:5323 ../src/guestfs-actions.pod:8186
18618 "This creates an LVM volume group called C<volgroup> from the non-empty list "
18619 "of physical volumes C<physvols>."
18623 #: ../fish/guestfish-actions.pod:5326
18628 #: ../fish/guestfish-actions.pod:5328
18631 " vglvuuids vgname\n"
18636 #: ../fish/guestfish-actions.pod:5330 ../src/guestfs-actions.pod:8199
18638 "Given a VG called C<vgname>, this returns the UUIDs of all the logical "
18639 "volumes created in this volume group."
18643 #: ../fish/guestfish-actions.pod:5333
18645 "You can use this along with L</lvs> and L</lvuuid> calls to associate "
18646 "logical volumes and volume groups."
18650 #: ../fish/guestfish-actions.pod:5336
18651 msgid "See also L</vgpvuuids>."
18652 msgstr "Див. також L</vgpvuuids>."
18655 #: ../fish/guestfish-actions.pod:5338
18660 #: ../fish/guestfish-actions.pod:5340
18663 " vgpvuuids vgname\n"
18668 #: ../fish/guestfish-actions.pod:5342 ../src/guestfs-actions.pod:8219
18670 "Given a VG called C<vgname>, this returns the UUIDs of all the physical "
18671 "volumes that this volume group resides on."
18675 #: ../fish/guestfish-actions.pod:5345
18677 "You can use this along with L</pvs> and L</pvuuid> calls to associate "
18678 "physical volumes and volume groups."
18682 #: ../fish/guestfish-actions.pod:5348
18683 msgid "See also L</vglvuuids>."
18684 msgstr "Див. також L</vglvuuids>."
18687 #: ../fish/guestfish-actions.pod:5350
18692 #: ../fish/guestfish-actions.pod:5352
18695 " vgremove vgname\n"
18700 #: ../fish/guestfish-actions.pod:5354 ../src/guestfs-actions.pod:8239
18701 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)."
18705 #: ../fish/guestfish-actions.pod:5356 ../src/guestfs-actions.pod:8241
18707 "This also forcibly removes all logical volumes in the volume group (if any)."
18711 #: ../fish/guestfish-actions.pod:5359
18716 #: ../fish/guestfish-actions.pod:5361
18719 " vgrename volgroup newvolgroup\n"
18724 #: ../fish/guestfish-actions.pod:5363 ../src/guestfs-actions.pod:8255
18725 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>."
18729 #: ../fish/guestfish-actions.pod:5365
18734 #: ../fish/guestfish-actions.pod:5367
18744 #: ../fish/guestfish-actions.pod:5369 ../src/guestfs-actions.pod:8266
18746 "List all the volumes groups detected. This is the equivalent of the L<vgs(8)"
18751 #: ../fish/guestfish-actions.pod:5372 ../src/guestfs-actions.pod:8269
18753 "This returns a list of just the volume group names that were detected (eg. "
18758 #: ../fish/guestfish-actions.pod:5375
18759 msgid "See also L</vgs-full>."
18760 msgstr "Див. також L</vgs-full>."
18763 #: ../fish/guestfish-actions.pod:5377
18768 #: ../fish/guestfish-actions.pod:5379
18778 #: ../fish/guestfish-actions.pod:5381 ../src/guestfs-actions.pod:8285
18780 "List all the volumes groups detected. This is the equivalent of the L<vgs(8)"
18781 "> command. The \"full\" version includes all fields."
18785 #: ../fish/guestfish-actions.pod:5384
18790 #: ../fish/guestfish-actions.pod:5386
18800 #: ../fish/guestfish-actions.pod:5388 ../src/guestfs-actions.pod:8299
18802 "This rescans all block devices and rebuilds the list of LVM physical "
18803 "volumes, volume groups and logical volumes."
18807 #: ../fish/guestfish-actions.pod:5391
18812 #: ../fish/guestfish-actions.pod:5393
18820 #: ../fish/guestfish-actions.pod:5395 ../src/guestfs-actions.pod:8312
18821 msgid "This command returns the UUID of the LVM VG named C<vgname>."
18825 #: ../fish/guestfish-actions.pod:5397
18830 #: ../fish/guestfish-actions.pod:5399
18840 #: ../fish/guestfish-actions.pod:5401 ../src/guestfs-actions.pod:8352
18842 "This command counts the characters in a file, using the C<wc -c> external "
18847 #: ../fish/guestfish-actions.pod:5404
18852 #: ../fish/guestfish-actions.pod:5406
18862 #: ../fish/guestfish-actions.pod:5408 ../src/guestfs-actions.pod:8365
18864 "This command counts the lines in a file, using the C<wc -l> external command."
18868 #: ../fish/guestfish-actions.pod:5411
18873 #: ../fish/guestfish-actions.pod:5413
18883 #: ../fish/guestfish-actions.pod:5415 ../src/guestfs-actions.pod:8378
18885 "This command counts the words in a file, using the C<wc -w> external command."
18889 #: ../fish/guestfish-actions.pod:5418
18894 #: ../fish/guestfish-actions.pod:5420
18897 " write path content\n"
18900 " write шлях дані\n"
18904 #: ../fish/guestfish-actions.pod:5422 ../src/guestfs-actions.pod:8393
18906 "This call creates a file called C<path>. The content of the file is the "
18907 "string C<content> (which can contain any 8 bit data)."
18911 #: ../fish/guestfish-actions.pod:5425
18912 msgid "See also L</write-append>."
18913 msgstr "Див. також L</write-append>."
18916 #: ../fish/guestfish-actions.pod:5430
18917 msgid "write-append"
18921 #: ../fish/guestfish-actions.pod:5432
18924 " write-append path content\n"
18929 #: ../fish/guestfish-actions.pod:5434 ../src/guestfs-actions.pod:8413
18931 "This call appends C<content> to the end of file C<path>. If C<path> does "
18932 "not exist, then a new file is created."
18936 #: ../fish/guestfish-actions.pod:5437
18937 msgid "See also L</write>."
18938 msgstr "Див. також L</write>."
18941 #: ../fish/guestfish-actions.pod:5442
18943 msgstr "write-file"
18946 #: ../fish/guestfish-actions.pod:5444
18949 " write-file path content size\n"
18954 #: ../fish/guestfish-actions.pod:5446 ../src/guestfs-actions.pod:8440
18956 "This call creates a file called C<path>. The contents of the file is the "
18957 "string C<content> (which can contain any 8 bit data), with length C<size>."
18961 #: ../fish/guestfish-actions.pod:5450 ../src/guestfs-actions.pod:8444
18963 "As a special case, if C<size> is C<0> then the length is calculated using "
18964 "C<strlen> (so in this case the content cannot contain embedded ASCII NULs)."
18968 #: ../fish/guestfish-actions.pod:5454 ../src/guestfs-actions.pod:8448
18970 "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does "
18971 "I<not> work, even if the length is specified."
18975 #: ../fish/guestfish-actions.pod:5460
18977 "I<This function is deprecated.> In new code, use the L</write> call instead."
18981 #: ../fish/guestfish-actions.pod:5467
18986 #: ../fish/guestfish-actions.pod:5469
18989 " zegrep regex path\n"
18992 " zegrep формальний_вираз шлях\n"
18996 #: ../fish/guestfish-actions.pod:5471 ../src/guestfs-actions.pod:8465
18998 "This calls the external C<zegrep> program and returns the matching lines."
19002 #: ../fish/guestfish-actions.pod:5477
19007 #: ../fish/guestfish-actions.pod:5479
19010 " zegrepi regex path\n"
19015 #: ../fish/guestfish-actions.pod:5481 ../src/guestfs-actions.pod:8484
19017 "This calls the external C<zegrep -i> program and returns the matching lines."
19021 #: ../fish/guestfish-actions.pod:5487
19026 #: ../fish/guestfish-actions.pod:5489
19036 #: ../fish/guestfish-actions.pod:5491 ../src/guestfs-actions.pod:8502
19037 msgid "This command writes zeroes over the first few blocks of C<device>."
19041 #: ../fish/guestfish-actions.pod:5493 ../src/guestfs-actions.pod:8504
19043 "How many blocks are zeroed isn't specified (but it's I<not> enough to "
19044 "securely wipe the device). It should be sufficient to remove any partition "
19045 "tables, filesystem superblocks and so on."
19049 #: ../fish/guestfish-actions.pod:5497 ../fish/guestfish-actions.pod:5512
19050 #: ../src/guestfs-actions.pod:8508 ../src/guestfs-actions.pod:8534
19052 "If blocks are already zero, then this command avoids writing zeroes. This "
19053 "prevents the underlying device from becoming non-sparse or growing "
19058 #: ../fish/guestfish-actions.pod:5501
19059 msgid "See also: L</zero-device>, L</scrub-device>, L</is-zero-device>"
19063 #: ../fish/guestfish-actions.pod:5504
19064 msgid "zero-device"
19065 msgstr "zero-device"
19068 #: ../fish/guestfish-actions.pod:5506
19071 " zero-device device\n"
19074 " zero-device пристрій\n"
19078 #: ../fish/guestfish-actions.pod:5508
19080 "This command writes zeroes over the entire C<device>. Compare with L</zero> "
19081 "which just zeroes the first few blocks of a device."
19085 #: ../fish/guestfish-actions.pod:5516
19090 #: ../fish/guestfish-actions.pod:5518
19093 " zerofree device\n"
19096 " zerofree пристрій\n"
19100 #: ../fish/guestfish-actions.pod:5520 ../src/guestfs-actions.pod:8553
19102 "This runs the I<zerofree> program on C<device>. This program claims to zero "
19103 "unused inodes and disk blocks on an ext2/3 filesystem, thus making it "
19104 "possible to compress the filesystem more effectively."
19108 #: ../fish/guestfish-actions.pod:5525 ../src/guestfs-actions.pod:8558
19109 msgid "You should B<not> run this program if the filesystem is mounted."
19113 #: ../fish/guestfish-actions.pod:5528 ../src/guestfs-actions.pod:8561
19115 "It is possible that using this program can damage the filesystem or data on "
19120 #: ../fish/guestfish-actions.pod:5531
19125 #: ../fish/guestfish-actions.pod:5533
19128 " zfgrep pattern path\n"
19131 " zfgrep шаблон шлях\n"
19135 #: ../fish/guestfish-actions.pod:5535 ../src/guestfs-actions.pod:8575
19137 "This calls the external C<zfgrep> program and returns the matching lines."
19141 #: ../fish/guestfish-actions.pod:5541
19146 #: ../fish/guestfish-actions.pod:5543
19149 " zfgrepi pattern path\n"
19152 " zfgrepi шаблон шлях\n"
19156 #: ../fish/guestfish-actions.pod:5545 ../src/guestfs-actions.pod:8594
19158 "This calls the external C<zfgrep -i> program and returns the matching lines."
19162 #: ../fish/guestfish-actions.pod:5551
19167 #: ../fish/guestfish-actions.pod:5553
19170 " zfile meth path\n"
19173 " zfile метод шлях\n"
19177 #: ../fish/guestfish-actions.pod:5555 ../src/guestfs-actions.pod:8620
19179 "This command runs C<file> after first decompressing C<path> using C<method>."
19183 #: ../fish/guestfish-actions.pod:5558 ../src/guestfs-actions.pod:8623
19184 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>."
19188 #: ../fish/guestfish-actions.pod:5560
19190 "Since 1.0.63, use L</file> instead which can now process compressed files."
19194 #: ../fish/guestfish-actions.pod:5563
19196 "I<This function is deprecated.> In new code, use the L</file> call instead."
19200 #: ../fish/guestfish-actions.pod:5570
19205 #: ../fish/guestfish-actions.pod:5572
19208 " zgrep regex path\n"
19211 " zgrep формальний_вираз шлях\n"
19215 #: ../fish/guestfish-actions.pod:5574 ../src/guestfs-actions.pod:8640
19217 "This calls the external C<zgrep> program and returns the matching lines."
19221 #: ../fish/guestfish-actions.pod:5580
19226 #: ../fish/guestfish-actions.pod:5582
19229 " zgrepi regex path\n"
19232 " zgrepi формальний_вираз шлях\n"
19236 #: ../fish/guestfish-actions.pod:5584 ../src/guestfs-actions.pod:8659
19238 "This calls the external C<zgrep -i> program and returns the matching lines."
19242 #: ../fish/guestfish-commands.pod:1
19247 #: ../fish/guestfish-commands.pod:3
19252 #: ../fish/guestfish-commands.pod:5
19255 " alloc filename size\n"
19260 #: ../fish/guestfish-commands.pod:7
19262 "This creates an empty (zeroed) file of the given size, and then adds so it "
19263 "can be further examined."
19267 #: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:193
19268 msgid "For more advanced image creation, see L<qemu-img(1)> utility."
19272 #: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:195
19273 msgid "Size can be specified using standard suffixes, eg. C<1M>."
19277 #: ../fish/guestfish-commands.pod:14
19279 "To create a sparse file, use L</sparse> instead. To create a prepared disk "
19280 "image, see L</PREPARED DISK IMAGES>."
19284 #: ../fish/guestfish-commands.pod:17
19289 #: ../fish/guestfish-commands.pod:19
19292 " copy-in local [local ...] /remotedir\n"
19297 #: ../fish/guestfish-commands.pod:21
19299 "C<copy-in> copies local files or directories recursively into the disk "
19300 "image, placing them in the directory called C</remotedir> (which must "
19301 "exist). This guestfish meta-command turns into a sequence of L</tar-in> and "
19302 "other commands as necessary."
19306 #: ../fish/guestfish-commands.pod:26
19308 "Multiple local files and directories can be specified, but the last "
19309 "parameter must always be a remote directory. Wildcards cannot be used."
19313 #: ../fish/guestfish-commands.pod:30
19318 #: ../fish/guestfish-commands.pod:32
19321 " copy-out remote [remote ...] localdir\n"
19326 #: ../fish/guestfish-commands.pod:34
19328 "C<copy-out> copies remote files or directories recursively out of the disk "
19329 "image, placing them on the host disk in a local directory called C<localdir> "
19330 "(which must exist). This guestfish meta-command turns into a sequence of L</"
19331 "download>, L</tar-out> and other commands as necessary."
19335 #: ../fish/guestfish-commands.pod:40
19337 "Multiple remote files and directories can be specified, but the last "
19338 "parameter must always be a local directory. To download to the current "
19339 "directory, use C<.> as in:"
19343 #: ../fish/guestfish-commands.pod:44
19346 " copy-out /home .\n"
19349 " copy-out /home .\n"
19353 #: ../fish/guestfish-commands.pod:46
19355 "Wildcards cannot be used in the ordinary command, but you can use them with "
19356 "the help of L</glob> like this:"
19360 #: ../fish/guestfish-commands.pod:49
19363 " glob copy-out /home/* .\n"
19366 " glob copy-out /home/* .\n"
19370 #: ../fish/guestfish-commands.pod:51
19375 #: ../fish/guestfish-commands.pod:53
19378 " display filename\n"
19383 #: ../fish/guestfish-commands.pod:55
19385 "Use C<display> (a graphical display program) to display an image file. It "
19386 "downloads the file, and runs C<display> on it."
19390 #: ../fish/guestfish-commands.pod:58
19392 "To use an alternative program, set the C<GUESTFISH_DISPLAY_IMAGE> "
19393 "environment variable. For example to use the GNOME display program:"
19397 #: ../fish/guestfish-commands.pod:61
19400 " export GUESTFISH_DISPLAY_IMAGE=eog\n"
19405 #: ../fish/guestfish-commands.pod:63
19406 msgid "See also L<display(1)>."
19407 msgstr "Див. також L<display(1)>."
19410 #: ../fish/guestfish-commands.pod:65
19415 #: ../fish/guestfish-commands.pod:67
19418 " echo [params ...]\n"
19421 " echo [параметри...]\n"
19425 #: ../fish/guestfish-commands.pod:69
19426 msgid "This echos the parameters to the terminal."
19430 #: ../fish/guestfish-commands.pod:71
19435 #: ../fish/guestfish-commands.pod:73
19440 #: ../fish/guestfish-commands.pod:75
19445 #: ../fish/guestfish-commands.pod:77
19451 " edit назва_файла\n"
19455 #: ../fish/guestfish-commands.pod:79
19457 "This is used to edit a file. It downloads the file, edits it locally using "
19458 "your editor, then uploads the result."
19462 #: ../fish/guestfish-commands.pod:82
19464 "The editor is C<$EDITOR>. However if you use the alternate commands C<vi> "
19465 "or C<emacs> you will get those corresponding editors."
19469 #: ../fish/guestfish-commands.pod:86
19474 #: ../fish/guestfish-commands.pod:88
19477 " glob command args...\n"
19480 " glob команда параметри...\n"
19484 #: ../fish/guestfish-commands.pod:90
19486 "Expand wildcards in any paths in the args list, and run C<command> "
19487 "repeatedly on each matching path."
19491 #: ../fish/guestfish-commands.pod:93
19492 msgid "See L</WILDCARDS AND GLOBBING>."
19493 msgstr "Див. L</WILDCARDS AND GLOBBING>."
19496 #: ../fish/guestfish-commands.pod:95
19501 #: ../fish/guestfish-commands.pod:97
19504 " hexedit <filename|device>\n"
19505 " hexedit <filename|device> <max>\n"
19506 " hexedit <filename|device> <start> <max>\n"
19511 #: ../fish/guestfish-commands.pod:101
19513 "Use hexedit (a hex editor) to edit all or part of a binary file or block "
19518 #: ../fish/guestfish-commands.pod:104
19520 "This command works by downloading potentially the whole file or device, "
19521 "editing it locally, then uploading it. If the file or device is large, you "
19522 "have to specify which part you wish to edit by using C<max> and/or C<start> "
19523 "C<max> parameters. C<start> and C<max> are specified in bytes, with the "
19524 "usual modifiers allowed such as C<1M> (1 megabyte)."
19528 #: ../fish/guestfish-commands.pod:111
19529 msgid "For example to edit the first few sectors of a disk you might do:"
19533 #: ../fish/guestfish-commands.pod:114
19536 " hexedit /dev/sda 1M\n"
19539 " hexedit /dev/sda 1M\n"
19543 #: ../fish/guestfish-commands.pod:116
19545 "which would allow you to edit anywhere within the first megabyte of the disk."
19549 #: ../fish/guestfish-commands.pod:119
19550 msgid "To edit the superblock of an ext2 filesystem on C</dev/sda1>, do:"
19554 #: ../fish/guestfish-commands.pod:121
19557 " hexedit /dev/sda1 0x400 0x400\n"
19560 " hexedit /dev/sda1 0x400 0x400\n"
19564 #: ../fish/guestfish-commands.pod:123
19565 msgid "(assuming the superblock is in the standard location)."
19569 #: ../fish/guestfish-commands.pod:125
19571 "This command requires the external L<hexedit(1)> program. You can specify "
19572 "another program to use by setting the C<HEXEDITOR> environment variable."
19576 #: ../fish/guestfish-commands.pod:129
19577 msgid "See also L</hexdump>."
19578 msgstr "Див. також L</hexdump>."
19581 #: ../fish/guestfish-commands.pod:131
19586 #: ../fish/guestfish-commands.pod:133
19594 #: ../fish/guestfish-commands.pod:135
19596 "Change the local directory, ie. the current directory of guestfish itself."
19600 #: ../fish/guestfish-commands.pod:138
19601 msgid "Note that C<!cd> won't do what you might expect."
19605 #: ../fish/guestfish-commands.pod:140
19610 #: ../fish/guestfish-commands.pod:142
19615 #: ../fish/guestfish-commands.pod:144
19625 #: ../fish/guestfish-commands.pod:146
19626 msgid "Opens the manual page for guestfish."
19630 #: ../fish/guestfish-commands.pod:148
19635 #: ../fish/guestfish-commands.pod:150
19640 #: ../fish/guestfish-commands.pod:152
19648 #: ../fish/guestfish-commands.pod:154
19656 #: ../fish/guestfish-commands.pod:156
19657 msgid "This is used to view a file."
19661 #: ../fish/guestfish-commands.pod:158
19663 "The default viewer is C<$PAGER>. However if you use the alternate command "
19664 "C<less> you will get the C<less> command specifically."
19668 #: ../fish/guestfish-commands.pod:161
19673 #: ../fish/guestfish-commands.pod:163
19681 #: ../fish/guestfish-commands.pod:165
19683 "Close and reopen the libguestfs handle. It is not necessary to use this "
19684 "normally, because the handle is closed properly when guestfish exits. "
19685 "However this is occasionally useful for testing."
19689 #: ../fish/guestfish-commands.pod:169
19694 #: ../fish/guestfish-commands.pod:171
19697 " setenv VAR value\n"
19702 #: ../fish/guestfish-commands.pod:173
19703 msgid "Set the environment variable C<VAR> to the string C<value>."
19707 #: ../fish/guestfish-commands.pod:175
19709 "To print the value of an environment variable use a shell command such as:"
19713 #: ../fish/guestfish-commands.pod:178
19721 #: ../fish/guestfish-commands.pod:180
19726 #: ../fish/guestfish-commands.pod:182
19729 " sparse filename size\n"
19734 #: ../fish/guestfish-commands.pod:184
19736 "This creates an empty sparse file of the given size, and then adds so it can "
19737 "be further examined."
19741 #: ../fish/guestfish-commands.pod:187
19743 "In all respects it works the same as the L</alloc> command, except that the "
19744 "image file is allocated sparsely, which means that disk blocks are not "
19745 "assigned to the file until they are needed. Sparse disk files only use "
19746 "space when written to, but they are slower and there is a danger you could "
19747 "run out of real disk space during a write operation."
19751 #: ../fish/guestfish-commands.pod:197
19756 #: ../fish/guestfish-commands.pod:199
19766 #: ../fish/guestfish-commands.pod:201
19768 "This command returns a list of the optional groups known to the daemon, and "
19769 "indicates which ones are supported by this build of the libguestfs appliance."
19773 #: ../fish/guestfish-commands.pod:205
19774 msgid "See also L<guestfs(3)/AVAILABILITY>."
19775 msgstr "Див. також L<guestfs(3)/AVAILABILITY>."
19778 #: ../fish/guestfish-commands.pod:207
19783 #: ../fish/guestfish-commands.pod:209
19786 " time command args...\n"
19791 #: ../fish/guestfish-commands.pod:211
19793 "Run the command as usual, but print the elapsed time afterwards. This can "
19794 "be useful for benchmarking operations."
19798 #: ../fish/guestfish-commands.pod:214
19803 #: ../fish/guestfish-commands.pod:216
19811 #: ../fish/guestfish-commands.pod:218
19812 msgid "Remove C<VAR> from the environment."
19816 #: ../fish/guestfish.pod:5
19817 msgid "guestfish - the libguestfs Filesystem Interactive SHell"
19821 #: ../fish/guestfish.pod:9
19824 " guestfish [--options] [commands]\n"
19829 #: ../fish/guestfish.pod:11
19837 #: ../fish/guestfish.pod:13
19840 " guestfish [--ro|--rw] -a disk.img\n"
19845 #: ../fish/guestfish.pod:15
19848 " guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]\n"
19853 #: ../fish/guestfish.pod:17
19856 " guestfish -d libvirt-domain\n"
19861 #: ../fish/guestfish.pod:19
19864 " guestfish [--ro|--rw] -a disk.img -i\n"
19869 #: ../fish/guestfish.pod:21
19872 " guestfish -d libvirt-domain -i\n"
19877 #: ../fish/guestfish.pod:25
19879 "Using guestfish in read/write mode on live virtual machines can be "
19880 "dangerous, potentially causing disk corruption. Use the I<--ro> (read-only) "
19881 "option to use guestfish safely if the disk image or virtual machine might be "
19886 #: ../fish/guestfish.pod:32
19888 "Guestfish is a shell and command-line tool for examining and modifying "
19889 "virtual machine filesystems. It uses libguestfs and exposes all of the "
19890 "functionality of the guestfs API, see L<guestfs(3)>."
19894 #: ../fish/guestfish.pod:36
19896 "Guestfish gives you structured access to the libguestfs API, from shell "
19897 "scripts or the command line or interactively. If you want to rescue a "
19898 "broken virtual machine image, you should look at the L<virt-rescue(1)> "
19903 #: ../fish/guestfish.pod:43
19904 msgid "As an interactive shell"
19908 #: ../fish/guestfish.pod:45
19916 #: ../fish/guestfish.pod:47
19919 " Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
19920 " editing virtual machine filesystems.\n"
19925 #: ../fish/guestfish.pod:50
19928 " Type: 'help' for a list of commands\n"
19929 " 'man' to read the manual\n"
19930 " 'quit' to quit the shell\n"
19935 #: ../fish/guestfish.pod:54
19938 " ><fs> add-ro disk.img\n"
19940 " ><fs> list-filesystems\n"
19941 " /dev/sda1: ext4\n"
19942 " /dev/vg_guest/lv_root: ext4\n"
19943 " /dev/vg_guest/lv_swap: swap\n"
19944 " ><fs> mount /dev/vg_guest/lv_root /\n"
19945 " ><fs> cat /etc/fstab\n"
19947 " # Created by anaconda\n"
19954 #: ../fish/guestfish.pod:67
19955 msgid "From shell scripts"
19959 #: ../fish/guestfish.pod:69
19960 msgid "Create a new C</etc/motd> file in a guest or disk image:"
19964 #: ../fish/guestfish.pod:71
19967 " guestfish <<_EOF_\n"
19970 " mount /dev/vg_guest/lv_root /\n"
19971 " write /etc/motd \"Welcome, new users\"\n"
19977 #: ../fish/guestfish.pod:78
19978 msgid "List the LVM logical volumes in a disk image:"
19982 #: ../fish/guestfish.pod:80
19985 " guestfish -a disk.img --ro <<_EOF_\n"
19993 #: ../fish/guestfish.pod:85
19994 msgid "List all the filesystems in a disk image:"
19998 #: ../fish/guestfish.pod:87
20001 " guestfish -a disk.img --ro <<_EOF_\n"
20003 " list-filesystems\n"
20009 #: ../fish/guestfish.pod:92
20010 msgid "On one command line"
20014 #: ../fish/guestfish.pod:94 ../fish/virt-copy-in.pod:31
20015 msgid "Update C</etc/resolv.conf> in a guest:"
20019 #: ../fish/guestfish.pod:96
20023 " add disk.img : run : mount /dev/vg_guest/lv_root / : \\\n"
20024 " write /etc/resolv.conf \"nameserver 1.2.3.4\"\n"
20029 #: ../fish/guestfish.pod:100
20030 msgid "Edit C</boot/grub/grub.conf> interactively:"
20034 #: ../fish/guestfish.pod:102
20037 " guestfish --rw --add disk.img \\\n"
20038 " --mount /dev/vg_guest/lv_root \\\n"
20039 " --mount /dev/sda1:/boot \\\n"
20040 " edit /boot/grub/grub.conf\n"
20045 #: ../fish/guestfish.pod:107
20046 msgid "Mount disks automatically"
20050 #: ../fish/guestfish.pod:109
20052 "Use the I<-i> option to automatically mount the disks from a virtual machine:"
20056 #: ../fish/guestfish.pod:112
20059 " guestfish --ro -a disk.img -i cat /etc/group\n"
20064 #: ../fish/guestfish.pod:114
20067 " guestfish --ro -d libvirt-domain -i cat /etc/group\n"
20072 #: ../fish/guestfish.pod:116
20073 msgid "Another way to edit C</boot/grub/grub.conf> interactively is:"
20077 #: ../fish/guestfish.pod:118
20080 " guestfish --rw -a disk.img -i edit /boot/grub/grub.conf\n"
20085 #: ../fish/guestfish.pod:120
20086 msgid "As a script interpreter"
20090 #: ../fish/guestfish.pod:122
20091 msgid "Create a 100MB disk containing an ext2-formatted partition:"
20095 #: ../fish/guestfish.pod:124
20098 " #!/usr/bin/guestfish -f\n"
20099 " sparse test1.img 100M\n"
20101 " part-disk /dev/sda mbr\n"
20102 " mkfs ext2 /dev/sda1\n"
20107 #: ../fish/guestfish.pod:130
20108 msgid "Start with a prepared disk"
20112 #: ../fish/guestfish.pod:132
20114 "An alternate way to create a 100MB disk called C<test1.img> containing a "
20115 "single ext2-formatted partition:"
20119 #: ../fish/guestfish.pod:135 ../src/guestfs.pod:2243
20122 " guestfish -N fs\n"
20127 #: ../fish/guestfish.pod:137
20128 msgid "To list what is available do:"
20132 #: ../fish/guestfish.pod:139 ../fish/guestfish.pod:1042
20135 " guestfish -N help | less\n"
20140 #: ../fish/guestfish.pod:141
20141 msgid "Remote control"
20142 msgstr "Дистанційне керування"
20145 #: ../fish/guestfish.pod:143
20148 " eval \"`guestfish --listen`\"\n"
20149 " guestfish --remote add-ro disk.img\n"
20150 " guestfish --remote run\n"
20151 " guestfish --remote lvs\n"
20154 " eval \"`guestfish --listen`\"\n"
20155 " guestfish --remote add-ro disk.img\n"
20156 " guestfish --remote run\n"
20157 " guestfish --remote lvs\n"
20161 #: ../fish/guestfish.pod:154
20162 msgid "Displays general help on options."
20166 #: ../fish/guestfish.pod:158
20167 msgid "B<--cmd-help>"
20168 msgstr "B<--cmd-help>"
20171 #: ../fish/guestfish.pod:160
20172 msgid "Lists all available guestfish commands."
20176 #: ../fish/guestfish.pod:162
20178 msgstr "B<-h команда>"
20181 #: ../fish/guestfish.pod:164
20182 msgid "B<--cmd-help cmd>"
20183 msgstr "B<--cmd-help команда>"
20186 #: ../fish/guestfish.pod:166
20187 msgid "Displays detailed help on a single command C<cmd>."
20191 #: ../fish/guestfish.pod:168 ../fuse/guestmount.pod:96
20192 msgid "B<-a image>"
20193 msgstr "B<-a образ>"
20196 #: ../fish/guestfish.pod:170 ../fuse/guestmount.pod:98
20197 msgid "B<--add image>"
20198 msgstr "B<--add образ>"
20201 #: ../fish/guestfish.pod:172
20202 msgid "Add a block device or virtual machine image to the shell."
20206 #: ../fish/guestfish.pod:177
20208 "Using this flag is mostly equivalent to using the C<add> command, with "
20209 "C<readonly:true> if the I<--ro> flag was given, and with C<format:...> if "
20210 "the I<--format=...> flag was given."
20214 #: ../fish/guestfish.pod:185 ../fuse/guestmount.pod:109
20216 "When used in conjunction with the I<-d> option, this specifies the libvirt "
20217 "URI to use. The default is to use the default libvirt connection."
20221 #: ../fish/guestfish.pod:189
20226 #: ../fish/guestfish.pod:191
20228 "If using the I<--listen> option and a csh-like shell, use this option. See "
20229 "section L</REMOTE CONTROL AND CSH> below."
20233 #: ../fish/guestfish.pod:194 ../fuse/guestmount.pod:113
20234 msgid "B<-d libvirt-domain>"
20235 msgstr "B<-d домен-libvirt>"
20238 #: ../fish/guestfish.pod:196 ../fuse/guestmount.pod:115
20239 msgid "B<--domain libvirt-domain>"
20240 msgstr "B<--domain домен-libvirt>"
20243 #: ../fish/guestfish.pod:198 ../fuse/guestmount.pod:117
20245 "Add disks from the named libvirt domain. If the I<--ro> option is also "
20246 "used, then any libvirt domain can be used. However in write mode, only "
20247 "libvirt domains which are shut down can be named here."
20251 #: ../fish/guestfish.pod:202 ../fuse/guestmount.pod:121
20252 msgid "Domain UUIDs can be used instead of names."
20256 #: ../fish/guestfish.pod:204
20258 "Using this flag is mostly equivalent to using the C<add-domain> command, "
20259 "with C<readonly:true> if the I<--ro> flag was given, and with C<format:...> "
20260 "if the I<--format:...> flag was given."
20264 #: ../fish/guestfish.pod:208
20269 #: ../fish/guestfish.pod:210
20270 msgid "B<--no-dest-paths>"
20271 msgstr "B<--no-dest-paths>"
20274 #: ../fish/guestfish.pod:212
20276 "Don't tab-complete paths on the guest filesystem. It is useful to be able "
20277 "to hit the tab key to complete paths on the guest filesystem, but this "
20278 "causes extra \"hidden\" guestfs calls to be made, so this option is here to "
20279 "allow this feature to be disabled."
20283 #: ../fish/guestfish.pod:219 ../fuse/guestmount.pod:137
20285 "When prompting for keys and passphrases, guestfish normally turns echoing "
20286 "off so you cannot see what you are typing. If you are not worried about "
20287 "Tempest attacks and there is no one else in the room you can specify this "
20288 "flag to see what you are typing."
20292 #: ../fish/guestfish.pod:224
20294 msgstr "B<-f файл>"
20297 #: ../fish/guestfish.pod:226
20298 msgid "B<--file file>"
20299 msgstr "B<--file файл>"
20302 #: ../fish/guestfish.pod:228
20303 msgid "Read commands from C<file>. To write pure guestfish scripts, use:"
20307 #: ../fish/guestfish.pod:231
20310 " #!/usr/bin/guestfish -f\n"
20313 " #!/usr/bin/guestfish -f\n"
20317 #: ../fish/guestfish.pod:244
20320 " guestfish --format=raw -a disk.img\n"
20323 " guestfish --format=raw -a disk.img\n"
20327 #: ../fish/guestfish.pod:248
20330 " guestfish --format=raw -a disk.img --format -a another.img\n"
20333 " guestfish --format=raw -a disk.img --format -a another.img\n"
20337 #: ../fish/guestfish.pod:253
20339 "If you have untrusted raw-format guest disk images, you should use this "
20340 "option to specify the disk format. This avoids a possible security problem "
20341 "with malicious guests (CVE-2010-3851). See also L</add-drive-opts>."
20345 #: ../fish/guestfish.pod:260 ../fuse/guestmount.pod:166
20346 msgid "B<--inspector>"
20347 msgstr "B<--inspector>"
20350 #: ../fish/guestfish.pod:262 ../fuse/guestmount.pod:168
20352 "Using L<virt-inspector(1)> code, inspect the disks looking for an operating "
20353 "system and mount filesystems as they would be mounted on the real virtual "
20358 #: ../fish/guestfish.pod:266
20359 msgid "Typical usage is either:"
20363 #: ../fish/guestfish.pod:268
20366 " guestfish -d myguest -i\n"
20369 " guestfish -d myguest -i\n"
20373 #: ../fish/guestfish.pod:270
20374 msgid "(for an inactive libvirt domain called I<myguest>), or:"
20378 #: ../fish/guestfish.pod:272
20381 " guestfish --ro -d myguest -i\n"
20384 " guestfish --ro -d myguest -i\n"
20388 #: ../fish/guestfish.pod:274
20389 msgid "(for active domains, readonly), or specify the block device directly:"
20393 #: ../fish/guestfish.pod:276
20396 " guestfish --rw -a /dev/Guests/MyGuest -i\n"
20399 " guestfish --rw -a /dev/Guests/MyGuest -i\n"
20403 #: ../fish/guestfish.pod:278
20405 "Note that the command line syntax changed slightly over older versions of "
20406 "guestfish. You can still use the old syntax:"
20410 #: ../fish/guestfish.pod:281
20413 " guestfish [--ro] -i disk.img\n"
20416 " guestfish [--ro] -i disk.img\n"
20420 #: ../fish/guestfish.pod:283
20423 " guestfish [--ro] -i libvirt-domain\n"
20428 #: ../fish/guestfish.pod:285
20430 "Using this flag is mostly equivalent to using the C<inspect-os> command and "
20431 "then using other commands to mount the filesystems that were found."
20435 #: ../fish/guestfish.pod:294
20436 msgid "B<--listen>"
20437 msgstr "B<--listen>"
20440 #: ../fish/guestfish.pod:296
20442 "Fork into the background and listen for remote commands. See section L</"
20443 "REMOTE CONTROL GUESTFISH OVER A SOCKET> below."
20447 #: ../fish/guestfish.pod:299 ../fuse/guestmount.pod:177
20452 #: ../fish/guestfish.pod:301 ../fuse/guestmount.pod:179
20454 "Connect to a live virtual machine. (Experimental, see L<guestfs(3)/"
20455 "ATTACHING TO RUNNING DAEMONS>)."
20459 #: ../fish/guestfish.pod:304 ../fuse/guestmount.pod:182
20460 msgid "B<-m dev[:mountpoint[:options]]>"
20461 msgstr "B<-m пристрій[:точка_монтування[:параметри]]>"
20464 #: ../fish/guestfish.pod:306 ../fuse/guestmount.pod:184
20465 msgid "B<--mount dev[:mountpoint[:options]]>"
20466 msgstr "B<--mount пристрій[:точка_монтування[:параметри]]>"
20469 #: ../fish/guestfish.pod:308
20470 msgid "Mount the named partition or logical volume on the given mountpoint."
20474 #: ../fish/guestfish.pod:310
20475 msgid "If the mountpoint is omitted, it defaults to C</>."
20479 #: ../fish/guestfish.pod:312
20480 msgid "You have to mount something on C</> before most commands will work."
20484 #: ../fish/guestfish.pod:314
20486 "If any I<-m> or I<--mount> options are given, the guest is automatically "
20491 #: ../fish/guestfish.pod:317
20493 "If you don't know what filesystems a disk image contains, you can either run "
20494 "guestfish without this option, then list the partitions, filesystems and LVs "
20495 "available (see L</list-partitions>, L</list-filesystems> and L</lvs> "
20496 "commands), or you can use the L<virt-filesystems(1)> program."
20500 #: ../fish/guestfish.pod:323 ../fuse/guestmount.pod:192
20502 "The third (and rarely used) part of the mount parameter is the list of mount "
20503 "options used to mount the underlying filesystem. If this is not given, then "
20504 "the mount options are either the empty string or C<ro> (the latter if the "
20505 "I<--ro> flag is used). By specifying the mount options, you override this "
20506 "default choice. Probably the only time you would use this is to enable ACLs "
20507 "and/or extended attributes if the filesystem can support them:"
20511 #: ../fish/guestfish.pod:331 ../fuse/guestmount.pod:200
20514 " -m /dev/sda1:/:acl,user_xattr\n"
20519 #: ../fish/guestfish.pod:333
20520 msgid "Using this flag is equivalent to using the C<mount-options> command."
20524 #: ../fish/guestfish.pod:335 ../fuse/guestmount.pod:202
20525 #: ../resize/virt-resize.pod:435
20530 #: ../fish/guestfish.pod:337 ../fuse/guestmount.pod:204
20531 msgid "B<--no-sync>"
20532 msgstr "B<--no-sync>"
20535 #: ../fish/guestfish.pod:339
20537 "Disable autosync. This is enabled by default. See the discussion of "
20538 "autosync in the L<guestfs(3)> manpage."
20542 #: ../fish/guestfish.pod:342
20547 #: ../fish/guestfish.pod:344
20548 msgid "B<--new type>"
20549 msgstr "B<--new тип>"
20552 #: ../fish/guestfish.pod:346
20554 msgstr "B<-N help>"
20557 #: ../fish/guestfish.pod:348
20559 "Prepare a fresh disk image formatted as \"type\". This is an alternative to "
20560 "the I<-a> option: whereas I<-a> adds an existing disk, I<-N> creates a "
20561 "preformatted disk with a filesystem and adds it. See L</PREPARED DISK "
20566 #: ../fish/guestfish.pod:353
20567 msgid "B<--progress-bars>"
20568 msgstr "B<--progress-bars>"
20571 #: ../fish/guestfish.pod:355
20572 msgid "Enable progress bars, even when guestfish is used non-interactively."
20576 #: ../fish/guestfish.pod:357
20578 "Progress bars are enabled by default when guestfish is used as an "
20579 "interactive shell."
20583 #: ../fish/guestfish.pod:360
20584 msgid "B<--no-progress-bars>"
20585 msgstr "B<--no-progress-bars>"
20588 #: ../fish/guestfish.pod:362
20589 msgid "Disable progress bars."
20593 #: ../fish/guestfish.pod:364
20594 msgid "B<--remote[=pid]>"
20595 msgstr "B<--remote[=pid]>"
20598 #: ../fish/guestfish.pod:366
20600 "Send remote commands to C<$GUESTFISH_PID> or C<pid>. See section L</REMOTE "
20601 "CONTROL GUESTFISH OVER A SOCKET> below."
20605 #: ../fish/guestfish.pod:369 ../fuse/guestmount.pod:248
20606 #: ../rescue/virt-rescue.pod:189
20611 #: ../fish/guestfish.pod:371 ../fuse/guestmount.pod:250
20612 #: ../rescue/virt-rescue.pod:191
20617 #: ../fish/guestfish.pod:373
20619 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
20620 "mounts are done read-only."
20624 #: ../fish/guestfish.pod:376 ../rescue/virt-rescue.pod:195
20626 "The option must always be used if the disk image or virtual machine might be "
20627 "running, and is generally recommended in cases where you don't need write "
20628 "access to the disk."
20632 #: ../fish/guestfish.pod:380
20634 "Note that prepared disk images created with I<-N> are not affected by this "
20635 "option. Also commands like C<add> are not affected - you have to specify "
20636 "the C<readonly:true> option explicitly if you need it."
20640 #: ../fish/guestfish.pod:384
20641 msgid "See also L</OPENING DISKS FOR READ AND WRITE> below."
20645 #: ../fish/guestfish.pod:386 ../fuse/guestmount.pod:262
20646 #: ../rescue/virt-rescue.pod:201
20647 msgid "B<--selinux>"
20648 msgstr "B<--selinux>"
20651 #: ../fish/guestfish.pod:388
20652 msgid "Enable SELinux support for the guest. See L<guestfs(3)/SELINUX>."
20656 #: ../fish/guestfish.pod:394
20658 "Enable very verbose messages. This is particularly useful if you find a bug."
20662 #: ../fish/guestfish.pod:401
20663 msgid "Display the guestfish / libguestfs version number and exit."
20667 #: ../fish/guestfish.pod:403 ../fuse/guestmount.pod:278
20668 #: ../rescue/virt-rescue.pod:231
20673 #: ../fish/guestfish.pod:405 ../fuse/guestmount.pod:280
20674 #: ../rescue/virt-rescue.pod:233
20679 #: ../fish/guestfish.pod:407 ../fuse/guestmount.pod:282
20681 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
20682 "mounts are done read-write."
20686 #: ../fish/guestfish.pod:410
20687 msgid "See L</OPENING DISKS FOR READ AND WRITE> below."
20691 #: ../fish/guestfish.pod:414
20692 msgid "Echo each command before executing it."
20696 #: ../fish/guestfish.pod:418
20697 msgid "COMMANDS ON COMMAND LINE"
20701 #: ../fish/guestfish.pod:420
20703 "Any additional (non-option) arguments are treated as commands to execute."
20707 #: ../fish/guestfish.pod:423
20709 "Commands to execute should be separated by a colon (C<:>), where the colon "
20710 "is a separate parameter. Thus:"
20714 #: ../fish/guestfish.pod:426
20717 " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n"
20722 #: ../fish/guestfish.pod:428
20724 "If there are no additional arguments, then we enter a shell, either an "
20725 "interactive shell with a prompt (if the input is a terminal) or a non-"
20726 "interactive shell."
20730 #: ../fish/guestfish.pod:432
20732 "In either command line mode or non-interactive shell, the first command that "
20733 "gives an error causes the whole shell to exit. In interactive mode (with a "
20734 "prompt) if a command fails, you can continue to enter commands."
20738 #: ../fish/guestfish.pod:437
20739 msgid "USING launch (OR run)"
20743 #: ../fish/guestfish.pod:439
20745 "As with L<guestfs(3)>, you must first configure your guest by adding disks, "
20746 "then launch it, then mount any disks you need, and finally issue actions/"
20747 "commands. So the general order of the day is:"
20751 #: ../fish/guestfish.pod:447
20752 msgid "add or -a/--add"
20756 #: ../fish/guestfish.pod:451
20757 msgid "launch (aka run)"
20761 #: ../fish/guestfish.pod:455
20762 msgid "mount or -m/--mount"
20766 #: ../fish/guestfish.pod:459
20767 msgid "any other commands"
20771 #: ../fish/guestfish.pod:463
20773 "C<run> is a synonym for C<launch>. You must C<launch> (or C<run>) your "
20774 "guest before mounting or performing any other commands."
20778 #: ../fish/guestfish.pod:466
20780 "The only exception is that if any of the I<-i>, I<-m>, I<--mount>, I<-N> or "
20781 "I<--new> options were given then C<run> is done automatically, simply "
20782 "because guestfish can't perform the action you asked for without doing this."
20786 #: ../fish/guestfish.pod:471
20787 msgid "OPENING DISKS FOR READ AND WRITE"
20791 #: ../fish/guestfish.pod:473
20793 "The guestfish, L<guestmount(1)> and L<virt-rescue(1)> options I<--ro> and "
20794 "I<--rw> affect whether the other command line options I<-a>, I<-c>, I<-d>, "
20795 "I<-i> and I<-m> open disk images read-only or for writing."
20799 #: ../fish/guestfish.pod:478
20801 "In libguestfs E<le> 1.10, guestfish, guestmount and virt-rescue defaulted to "
20802 "opening disk images supplied on the command line for write. To open a disk "
20803 "image read-only you have to do I<-a image --ro>."
20807 #: ../fish/guestfish.pod:482
20809 "This matters: If you accidentally open a live VM disk image writable then "
20810 "you will cause irreversible disk corruption."
20814 #: ../fish/guestfish.pod:485
20816 "In a future libguestfs we intend to change the default the other way. Disk "
20817 "images will be opened read-only. You will have to either specify "
20818 "I<guestfish --rw>, I<guestmount --rw>, I<virt-rescue --rw>, or change the "
20819 "configuration file C</etc/libguestfs-tools.conf> in order to get write "
20820 "access for disk images specified by those other command line options."
20824 #: ../fish/guestfish.pod:492
20826 "This version of guestfish, guestmount and virt-rescue has a I<--rw> option "
20827 "which does nothing (it is already the default). However it is highly "
20828 "recommended that you use this option to indicate that you need write access, "
20829 "and prepare your scripts for the day when this option will be required for "
20834 #: ../fish/guestfish.pod:498
20836 "B<Note:> This does I<not> affect commands like L</add> and L</mount>, or any "
20837 "other libguestfs program apart from guestfish and guestmount."
20841 #: ../fish/guestfish.pod:501
20846 #: ../fish/guestfish.pod:503
20848 "You can quote ordinary parameters using either single or double quotes. For "
20853 #: ../fish/guestfish.pod:506
20856 " add \"file with a space.img\"\n"
20861 #: ../fish/guestfish.pod:508
20864 " rm '/file name'\n"
20869 #: ../fish/guestfish.pod:510
20877 #: ../fish/guestfish.pod:512
20879 "A few commands require a list of strings to be passed. For these, use a "
20880 "whitespace-separated list, enclosed in quotes. Strings containing "
20881 "whitespace to be passed through must be enclosed in single quotes. A "
20882 "literal single quote must be escaped with a backslash."
20886 #: ../fish/guestfish.pod:517
20889 " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n"
20890 " command \"/bin/echo 'foo bar'\"\n"
20891 " command \"/bin/echo \\'foo\\'\"\n"
20896 #: ../fish/guestfish.pod:521
20897 msgid "ESCAPE SEQUENCES IN DOUBLE QUOTED ARGUMENTS"
20901 #: ../fish/guestfish.pod:523
20903 "In double-quoted arguments (only) use backslash to insert special characters:"
20907 #: ../fish/guestfish.pod:528
20912 #: ../fish/guestfish.pod:530
20913 msgid "Alert (bell) character."
20914 msgstr "Символ гудка (дзвінка)."
20917 #: ../fish/guestfish.pod:532
20922 #: ../fish/guestfish.pod:534
20923 msgid "Backspace character."
20927 #: ../fish/guestfish.pod:536
20932 #: ../fish/guestfish.pod:538
20933 msgid "Form feed character."
20937 #: ../fish/guestfish.pod:540
20942 #: ../fish/guestfish.pod:542
20943 msgid "Newline character."
20947 #: ../fish/guestfish.pod:544
20952 #: ../fish/guestfish.pod:546
20953 msgid "Carriage return character."
20954 msgstr "Символ повернення каретки."
20957 #: ../fish/guestfish.pod:548
20962 #: ../fish/guestfish.pod:550
20963 msgid "Horizontal tab character."
20964 msgstr "Символ горизонтальної табуляції"
20967 #: ../fish/guestfish.pod:552
20972 #: ../fish/guestfish.pod:554
20973 msgid "Vertical tab character."
20974 msgstr "Символ вертикальної табуляції."
20977 #: ../fish/guestfish.pod:556
20982 #: ../fish/guestfish.pod:558
20983 msgid "A literal double quote character."
20987 #: ../fish/guestfish.pod:560
20992 #: ../fish/guestfish.pod:562
20994 "A character with octal value I<ooo>. There must be precisely 3 octal digits "
20999 #: ../fish/guestfish.pod:565
21004 #: ../fish/guestfish.pod:567
21006 "A character with hex value I<hh>. There must be precisely 2 hex digits."
21010 #: ../fish/guestfish.pod:570
21012 "In the current implementation C<\\000> and C<\\x00> cannot be used in "
21017 #: ../fish/guestfish.pod:573
21022 #: ../fish/guestfish.pod:575
21023 msgid "A literal backslash character."
21027 #: ../fish/guestfish.pod:579
21028 msgid "OPTIONAL ARGUMENTS"
21032 #: ../fish/guestfish.pod:581
21034 "Some commands take optional arguments. These arguments appear in this "
21035 "documentation as C<[argname:..]>. You can use them as in these examples:"
21039 #: ../fish/guestfish.pod:585
21042 " add-drive-opts filename\n"
21047 #: ../fish/guestfish.pod:587
21050 " add-drive-opts filename readonly:true\n"
21055 #: ../fish/guestfish.pod:589
21058 " add-drive-opts filename format:qcow2 readonly:false\n"
21063 #: ../fish/guestfish.pod:591
21065 "Each optional argument can appear at most once. All optional arguments must "
21066 "appear after the required ones."
21070 #: ../fish/guestfish.pod:594
21075 #: ../fish/guestfish.pod:596
21077 "This section applies to all commands which can take integers as parameters."
21081 #: ../fish/guestfish.pod:599
21082 msgid "SIZE SUFFIX"
21086 #: ../fish/guestfish.pod:601
21088 "When the command takes a parameter measured in bytes, you can use one of the "
21089 "following suffixes to specify kilobytes, megabytes and larger sizes:"
21093 #: ../fish/guestfish.pod:607
21094 msgid "B<k> or B<K> or B<KiB>"
21095 msgstr "B<k>, B<K> або B<KiB>"
21098 #: ../fish/guestfish.pod:609
21099 msgid "The size in kilobytes (multiplied by 1024)."
21100 msgstr "Розмір у кілобайтах (у одному кілобайті 1024 байтів)."
21103 #: ../fish/guestfish.pod:611
21108 #: ../fish/guestfish.pod:613
21109 msgid "The size in SI 1000 byte units."
21110 msgstr "Розмір у одиницях СІ: 1000 байтів."
21113 #: ../fish/guestfish.pod:615
21114 msgid "B<M> or B<MiB>"
21115 msgstr "B<M> або B<MiB>"
21118 #: ../fish/guestfish.pod:617
21119 msgid "The size in megabytes (multiplied by 1048576)."
21120 msgstr "Розмір у мегабайтах (у одному мегабайті 1048576 байтів)."
21123 #: ../fish/guestfish.pod:619
21128 #: ../fish/guestfish.pod:621
21129 msgid "The size in SI 1000000 byte units."
21130 msgstr "Розмір у одиницях СІ: 1000000 байтів."
21133 #: ../fish/guestfish.pod:623
21134 msgid "B<G> or B<GiB>"
21135 msgstr "B<G> або B<GiB>"
21138 #: ../fish/guestfish.pod:625
21139 msgid "The size in gigabytes (multiplied by 2**30)."
21140 msgstr "Розмір у гігабайтах (з множником 2**30)."
21143 #: ../fish/guestfish.pod:627
21148 #: ../fish/guestfish.pod:629
21149 msgid "The size in SI 10**9 byte units."
21150 msgstr "Розмір у одиницях СІ: 10**9 байтів."
21153 #: ../fish/guestfish.pod:631
21154 msgid "B<T> or B<TiB>"
21155 msgstr "B<T> або B<TiB>"
21158 #: ../fish/guestfish.pod:633
21159 msgid "The size in terabytes (multiplied by 2**40)."
21160 msgstr "Розмір у терабайтах (з множником 2**40)."
21163 #: ../fish/guestfish.pod:635
21168 #: ../fish/guestfish.pod:637
21169 msgid "The size in SI 10**12 byte units."
21170 msgstr "Розмір у одиницях СІ: 10**12 байтів."
21173 #: ../fish/guestfish.pod:639
21174 msgid "B<P> or B<PiB>"
21175 msgstr "B<P> або B<PiB>"
21178 #: ../fish/guestfish.pod:641
21179 msgid "The size in petabytes (multiplied by 2**50)."
21180 msgstr "Розмір у петабайтах (у одному петабайті 2**50 байтів)."
21183 #: ../fish/guestfish.pod:643
21188 #: ../fish/guestfish.pod:645
21189 msgid "The size in SI 10**15 byte units."
21190 msgstr "Розмір у одиницях СІ: 10**15 байтів."
21193 #: ../fish/guestfish.pod:647
21194 msgid "B<E> or B<EiB>"
21195 msgstr "B<E> або B<EiB>"
21198 #: ../fish/guestfish.pod:649
21199 msgid "The size in exabytes (multiplied by 2**60)."
21200 msgstr "Розмір у ексабайтах (у одному ексабайті 2**60 байтів)."
21203 #: ../fish/guestfish.pod:651
21208 #: ../fish/guestfish.pod:653
21209 msgid "The size in SI 10**18 byte units."
21210 msgstr "Розмір у одиницях СІ: 10**18 байтів."
21213 #: ../fish/guestfish.pod:655
21214 msgid "B<Z> or B<ZiB>"
21215 msgstr "B<Z> або B<ZiB>"
21218 #: ../fish/guestfish.pod:657
21219 msgid "The size in zettabytes (multiplied by 2**70)."
21220 msgstr "Розмір у зетабайтах (у одному зетабайті 2**70 байтів)."
21223 #: ../fish/guestfish.pod:659
21228 #: ../fish/guestfish.pod:661
21229 msgid "The size in SI 10**21 byte units."
21230 msgstr "Розмір у одиницях СІ: 10**21 байтів."
21233 #: ../fish/guestfish.pod:663
21234 msgid "B<Y> or B<YiB>"
21235 msgstr "B<Y> або B<YiB>"
21238 #: ../fish/guestfish.pod:665
21239 msgid "The size in yottabytes (multiplied by 2**80)."
21240 msgstr "Розмір у йотабайтах (у одному йотабайті 2**80 байтів)."
21243 #: ../fish/guestfish.pod:667
21248 #: ../fish/guestfish.pod:669
21249 msgid "The size in SI 10**24 byte units."
21250 msgstr "Розмір у одиницях СІ: 10**24 байтів."
21253 #: ../fish/guestfish.pod:675
21256 " truncate-size /file 1G\n"
21261 #: ../fish/guestfish.pod:677
21262 msgid "would truncate the file to 1 gigabyte."
21266 #: ../fish/guestfish.pod:679
21268 "Be careful because a few commands take sizes in kilobytes or megabytes (eg. "
21269 "the parameter to L</memsize> is specified in megabytes already). Adding a "
21270 "suffix will probably not do what you expect."
21274 #: ../fish/guestfish.pod:683
21275 msgid "OCTAL AND HEXADECIMAL NUMBERS"
21279 #: ../fish/guestfish.pod:685
21281 "For specifying the radix (base) use the C convention: C<0> to prefix an "
21282 "octal number or C<0x> to prefix a hexadecimal number. For example:"
21286 #: ../fish/guestfish.pod:688
21289 " 1234 decimal number 1234\n"
21290 " 02322 octal number, equivalent to decimal 1234\n"
21291 " 0x4d2 hexadecimal number, equivalent to decimal 1234\n"
21296 #: ../fish/guestfish.pod:692
21298 "When using the C<chmod> command, you almost always want to specify an octal "
21299 "number for the mode, and you must prefix it with C<0> (unlike the Unix "
21300 "L<chmod(1)> program):"
21304 #: ../fish/guestfish.pod:696
21307 " chmod 0777 /public # OK\n"
21308 " chmod 777 /public # WRONG! This is mode 777 decimal = 01411 octal.\n"
21313 #: ../fish/guestfish.pod:699
21315 "Commands that return numbers usually print them in decimal, but some "
21316 "commands print numbers in other radices (eg. C<umask> prints the mode in "
21317 "octal, preceeded by C<0>)."
21321 #: ../fish/guestfish.pod:703
21322 msgid "WILDCARDS AND GLOBBING"
21326 #: ../fish/guestfish.pod:705
21328 "Neither guestfish nor the underlying guestfs API performs wildcard expansion "
21329 "(globbing) by default. So for example the following will not do what you "
21334 #: ../fish/guestfish.pod:709
21342 #: ../fish/guestfish.pod:711
21344 "Assuming you don't have a directory called literally C</home/*> then the "
21345 "above command will return an error."
21349 #: ../fish/guestfish.pod:714
21350 msgid "To perform wildcard expansion, use the C<glob> command."
21354 #: ../fish/guestfish.pod:716
21357 " glob rm-rf /home/*\n"
21362 #: ../fish/guestfish.pod:718
21364 "runs C<rm-rf> on each path that matches (ie. potentially running the command "
21365 "many times), equivalent to:"
21369 #: ../fish/guestfish.pod:721
21372 " rm-rf /home/jim\n"
21373 " rm-rf /home/joe\n"
21374 " rm-rf /home/mary\n"
21379 #: ../fish/guestfish.pod:725
21380 msgid "C<glob> only works on simple guest paths and not on device names."
21384 #: ../fish/guestfish.pod:727
21386 "If you have several parameters, each containing a wildcard, then glob will "
21387 "perform a Cartesian product."
21391 #: ../fish/guestfish.pod:730
21396 #: ../fish/guestfish.pod:732
21398 "Any line which starts with a I<#> character is treated as a comment and "
21399 "ignored. The I<#> can optionally be preceeded by whitespace, but B<not> by "
21400 "a command. For example:"
21404 #: ../fish/guestfish.pod:736
21407 " # this is a comment\n"
21408 " # this is a comment\n"
21409 " foo # NOT a comment\n"
21414 #: ../fish/guestfish.pod:740
21415 msgid "Blank lines are also ignored."
21419 #: ../fish/guestfish.pod:742
21420 msgid "RUNNING COMMANDS LOCALLY"
21424 #: ../fish/guestfish.pod:744
21426 "Any line which starts with a I<!> character is treated as a command sent to "
21427 "the local shell (C</bin/sh> or whatever L<system(3)> uses). For example:"
21431 #: ../fish/guestfish.pod:748
21435 " tgz-out /remote local/remote-data.tar.gz\n"
21440 #: ../fish/guestfish.pod:751
21442 "will create a directory C<local> on the host, and then export the contents "
21443 "of C</remote> on the mounted filesystem to C<local/remote-data.tar.gz>. "
21444 "(See C<tgz-out>)."
21448 #: ../fish/guestfish.pod:755
21450 "To change the local directory, use the C<lcd> command. C<!cd> will have no "
21451 "effect, due to the way that subprocesses work in Unix."
21455 #: ../fish/guestfish.pod:758
21456 msgid "LOCAL COMMANDS WITH INLINE EXECUTION"
21460 #: ../fish/guestfish.pod:760
21462 "If a line starts with I<E<lt>!> then the shell command is executed (as for "
21463 "I<!>), but subsequently any output (stdout) of the shell command is parsed "
21464 "and executed as guestfish commands."
21468 #: ../fish/guestfish.pod:764
21470 "Thus you can use shell script to construct arbitrary guestfish commands "
21471 "which are then parsed by guestfish."
21475 #: ../fish/guestfish.pod:767
21477 "For example it is tedious to create a sequence of files (eg. C</foo.1> "
21478 "through C</foo.100>) using guestfish commands alone. However this is simple "
21479 "if we use a shell script to create the guestfish commands for us:"
21483 #: ../fish/guestfish.pod:772
21486 " <! for n in `seq 1 100`; do echo write /foo.$n $n; done\n"
21491 #: ../fish/guestfish.pod:774
21492 msgid "or with names like C</foo.001>:"
21496 #: ../fish/guestfish.pod:776
21499 " <! for n in `seq 1 100`; do printf \"write /foo.%03d %d\\n\" $n $n; done\n"
21504 #: ../fish/guestfish.pod:778
21506 "When using guestfish interactively it can be helpful to just run the shell "
21507 "script first (ie. remove the initial C<E<lt>> character so it is just an "
21508 "ordinary I<!> local command), see what guestfish commands it would run, and "
21509 "when you are happy with those prepend the C<E<lt>> character to run the "
21510 "guestfish commands for real."
21514 #: ../fish/guestfish.pod:784
21519 #: ../fish/guestfish.pod:786
21521 "Use C<command E<lt>spaceE<gt> | command> to pipe the output of the first "
21522 "command (a guestfish command) to the second command (any host command). For "
21527 #: ../fish/guestfish.pod:790
21530 " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n"
21535 #: ../fish/guestfish.pod:792
21537 "(where C<cat> is the guestfish cat command, but C<awk> is the host awk "
21538 "program). The above command would list all accounts in the guest filesystem "
21539 "which have UID 0, ie. root accounts including backdoors. Other examples:"
21543 #: ../fish/guestfish.pod:797
21546 " hexdump /bin/ls | head\n"
21547 " list-devices | tail -1\n"
21548 " tgz-out / - | tar ztf -\n"
21553 #: ../fish/guestfish.pod:801
21555 "The space before the pipe symbol is required, any space after the pipe "
21556 "symbol is optional. Everything after the pipe symbol is just passed "
21557 "straight to the host shell, so it can contain redirections, globs and "
21558 "anything else that makes sense on the host side."
21562 #: ../fish/guestfish.pod:806
21564 "To use a literal argument which begins with a pipe symbol, you have to quote "
21569 #: ../fish/guestfish.pod:809
21577 #: ../fish/guestfish.pod:811
21578 msgid "HOME DIRECTORIES"
21582 #: ../fish/guestfish.pod:813
21584 "If a parameter starts with the character C<~> then the tilde may be expanded "
21585 "as a home directory path (either C<~> for the current user's home directory, "
21586 "or C<~user> for another user)."
21590 #: ../fish/guestfish.pod:817
21592 "Note that home directory expansion happens for users known I<on the host>, "
21593 "not in the guest filesystem."
21597 #: ../fish/guestfish.pod:820
21599 "To use a literal argument which begins with a tilde, you have to quote it, "
21604 #: ../fish/guestfish.pod:823
21612 #: ../fish/guestfish.pod:825 ../src/guestfs.pod:534
21613 msgid "ENCRYPTED DISKS"
21614 msgstr "ЗАШИФРОВАНІ ДИСКИ"
21617 #: ../fish/guestfish.pod:827
21619 "Libguestfs has some support for Linux guests encrypted according to the "
21620 "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole "
21621 "disk encryption systems used by modern Linux guests. Currently only LVM-on-"
21622 "LUKS is supported."
21626 #: ../fish/guestfish.pod:832
21627 msgid "Identify encrypted block devices and partitions using L</vfs-type>:"
21631 #: ../fish/guestfish.pod:834
21634 " ><fs> vfs-type /dev/sda2\n"
21640 #: ../fish/guestfish.pod:837
21642 "Then open those devices using L</luks-open>. This creates a device-mapper "
21643 "device called C</dev/mapper/luksdev>."
21647 #: ../fish/guestfish.pod:840
21650 " ><fs> luks-open /dev/sda2 luksdev\n"
21651 " Enter key or passphrase (\"key\"): <enter the passphrase>\n"
21656 #: ../fish/guestfish.pod:843
21658 "Finally you have to tell LVM to scan for volume groups on the newly created "
21663 #: ../fish/guestfish.pod:846
21667 " vg-activate-all true\n"
21672 #: ../fish/guestfish.pod:849
21673 msgid "The logical volume(s) can now be mounted in the usual way."
21677 #: ../fish/guestfish.pod:851
21679 "Before closing a LUKS device you must unmount any logical volumes on it and "
21680 "deactivate the volume groups by calling C<vg-activate false VG> on each "
21681 "one. Then you can close the mapper device:"
21685 #: ../fish/guestfish.pod:855
21688 " vg-activate false /dev/VG\n"
21689 " luks-close /dev/mapper/luksdev\n"
21694 #: ../fish/guestfish.pod:860
21696 "If a path is prefixed with C<win:> then you can use Windows-style drive "
21697 "letters and paths (with some limitations). The following commands are "
21702 #: ../fish/guestfish.pod:864
21705 " file /WINDOWS/system32/config/system.LOG\n"
21710 #: ../fish/guestfish.pod:866
21713 " file win:\\windows\\system32\\config\\system.log\n"
21718 #: ../fish/guestfish.pod:868
21721 " file WIN:C:\\Windows\\SYSTEM32\\CONFIG\\SYSTEM.LOG\n"
21726 #: ../fish/guestfish.pod:870
21728 "The parameter is rewritten \"behind the scenes\" by looking up the position "
21729 "where the drive is mounted, prepending that to the path, changing all "
21730 "backslash characters to forward slash, then resolving the result using L</"
21731 "case-sensitive-path>. For example if the E: drive was mounted on C</e> then "
21732 "the parameter might be rewritten like this:"
21736 #: ../fish/guestfish.pod:876
21739 " win:e:\\foo\\bar => /e/FOO/bar\n"
21744 #: ../fish/guestfish.pod:878
21745 msgid "This only works in argument positions that expect a path."
21749 #: ../fish/guestfish.pod:880
21750 msgid "UPLOADING AND DOWNLOADING FILES"
21754 #: ../fish/guestfish.pod:882
21756 "For commands such as C<upload>, C<download>, C<tar-in>, C<tar-out> and "
21757 "others which upload from or download to a local file, you can use the "
21758 "special filename C<-> to mean \"from stdin\" or \"to stdout\". For example:"
21762 #: ../fish/guestfish.pod:886
21770 #: ../fish/guestfish.pod:888
21772 "reads stdin and creates from that a file C</foo> in the disk image, and:"
21776 #: ../fish/guestfish.pod:891
21779 " tar-out /etc - | tar tf -\n"
21784 #: ../fish/guestfish.pod:893
21786 "writes the tarball to stdout and then pipes that into the external \"tar\" "
21787 "command (see L</PIPES>)."
21791 #: ../fish/guestfish.pod:896
21793 "When using C<-> to read from stdin, the input is read up to the end of "
21794 "stdin. You can also use a special \"heredoc\"-like syntax to read up to "
21795 "some arbitrary end marker:"
21799 #: ../fish/guestfish.pod:900
21802 " upload -<<END /foo\n"
21811 #: ../fish/guestfish.pod:906
21813 "Any string of characters can be used instead of C<END>. The end marker must "
21814 "appear on a line of its own, without any preceeding or following characters "
21815 "(not even spaces)."
21819 #: ../fish/guestfish.pod:910
21821 "Note that the C<-E<lt>E<lt>> syntax only applies to parameters used to "
21822 "upload local files (so-called \"FileIn\" parameters in the generator)."
21826 #: ../fish/guestfish.pod:913
21827 msgid "EXIT ON ERROR BEHAVIOUR"
21831 #: ../fish/guestfish.pod:915
21833 "By default, guestfish will ignore any errors when in interactive mode (ie. "
21834 "taking commands from a human over a tty), and will exit on the first error "
21835 "in non-interactive mode (scripts, commands given on the command line)."
21839 #: ../fish/guestfish.pod:920
21841 "If you prefix a command with a I<-> character, then that command will not "
21842 "cause guestfish to exit, even if that (one) command returns an error."
21846 #: ../fish/guestfish.pod:924
21847 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET"
21851 #: ../fish/guestfish.pod:926
21853 "Guestfish can be remote-controlled over a socket. This is useful "
21854 "particularly in shell scripts where you want to make several different "
21855 "changes to a filesystem, but you don't want the overhead of starting up a "
21856 "guestfish process each time."
21860 #: ../fish/guestfish.pod:931
21861 msgid "Start a guestfish server process using:"
21865 #: ../fish/guestfish.pod:933
21868 " eval \"`guestfish --listen`\"\n"
21873 #: ../fish/guestfish.pod:935
21874 msgid "and then send it commands by doing:"
21878 #: ../fish/guestfish.pod:937
21881 " guestfish --remote cmd [...]\n"
21886 #: ../fish/guestfish.pod:939
21887 msgid "To cause the server to exit, send it the exit command:"
21891 #: ../fish/guestfish.pod:943
21893 "Note that the server will normally exit if there is an error in a command. "
21894 "You can change this in the usual way. See section L</EXIT ON ERROR "
21899 #: ../fish/guestfish.pod:947
21900 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES"
21904 #: ../fish/guestfish.pod:949
21906 "The C<eval> statement sets the environment variable C<$GUESTFISH_PID>, which "
21907 "is how the I<--remote> option knows where to send the commands. You can "
21908 "have several guestfish listener processes running using:"
21912 #: ../fish/guestfish.pod:953
21915 " eval \"`guestfish --listen`\"\n"
21916 " pid1=$GUESTFISH_PID\n"
21917 " eval \"`guestfish --listen`\"\n"
21918 " pid2=$GUESTFISH_PID\n"
21920 " guestfish --remote=$pid1 cmd\n"
21921 " guestfish --remote=$pid2 cmd\n"
21926 #: ../fish/guestfish.pod:961
21927 msgid "REMOTE CONTROL AND CSH"
21931 #: ../fish/guestfish.pod:963
21933 "When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> "
21938 #: ../fish/guestfish.pod:966
21941 " eval \"`guestfish --listen --csh`\"\n"
21946 #: ../fish/guestfish.pod:968
21947 msgid "REMOTE CONTROL DETAILS"
21951 #: ../fish/guestfish.pod:970
21953 "Remote control happens over a Unix domain socket called C</tmp/.guestfish-"
21954 "$UID/socket-$PID>, where C<$UID> is the effective user ID of the process, "
21955 "and C<$PID> is the process ID of the server."
21959 #: ../fish/guestfish.pod:974
21960 msgid "Guestfish client and server versions must match exactly."
21964 #: ../fish/guestfish.pod:976
21965 msgid "USING REMOTE CONTROL ROBUSTLY FROM SHELL SCRIPTS"
21969 #: ../fish/guestfish.pod:978
21971 "From Bash, you can use the following code which creates a guestfish "
21972 "instance, correctly quotes the command line, handles failure to start, and "
21973 "cleans up guestfish when the script exits:"
21977 #: ../fish/guestfish.pod:982 ../src/guestfs.pod:980
21985 #: ../fish/guestfish.pod:986
21988 " guestfish[0]=\"guestfish\"\n"
21989 " guestfish[1]=\"--listen\"\n"
21990 " guestfish[2]=\"--ro\"\n"
21991 " guestfish[3]=\"-a\"\n"
21992 " guestfish[4]=\"disk.img\"\n"
21997 #: ../fish/guestfish.pod:992
22000 " GUESTFISH_PID=\n"
22001 " eval $(\"${guestfish[@]}\")\n"
22002 " if [ -z \"$GUESTFISH_PID\" ]; then\n"
22003 " echo \"error: guestfish didn't start up, see error messages above\"\n"
22010 #: ../fish/guestfish.pod:999
22013 " cleanup_guestfish ()\n"
22015 " guestfish --remote -- exit >/dev/null 2>&1 ||:\n"
22017 " trap cleanup_guestfish EXIT ERR\n"
22022 #: ../fish/guestfish.pod:1005
22025 " guestfish --remote -- run\n"
22030 #: ../fish/guestfish.pod:1007
22038 #: ../fish/guestfish.pod:1009
22039 msgid "REMOTE CONTROL RUN COMMAND HANGING"
22043 #: ../fish/guestfish.pod:1011
22045 "Using the C<run> (or C<launch>) command remotely in a command substitution "
22046 "context hangs, ie. don't do (note the backquotes):"
22050 #: ../fish/guestfish.pod:1014
22053 " a=`guestfish --remote run`\n"
22058 #: ../fish/guestfish.pod:1016
22060 "Since the C<run> command produces no output on stdout, this is not useful "
22061 "anyway. For further information see L<https://bugzilla.redhat.com/show_bug."
22066 #: ../fish/guestfish.pod:1020
22067 msgid "PREPARED DISK IMAGES"
22071 #: ../fish/guestfish.pod:1022
22073 "Use the I<-N type> or I<--new type> parameter to select one of a set of "
22074 "preformatted disk images that guestfish can make for you to save typing. "
22075 "This is particularly useful for testing purposes. This option is used "
22076 "instead of the I<-a> option, and like I<-a> can appear multiple times (and "
22077 "can be mixed with I<-a>)."
22081 #: ../fish/guestfish.pod:1028
22083 "The new disk is called C<test1.img> for the first I<-N>, C<test2.img> for "
22084 "the second and so on. Existing files in the current directory are "
22089 #: ../fish/guestfish.pod:1032
22091 "The type briefly describes how the disk should be sized, partitioned, how "
22092 "filesystem(s) should be created, and how content should be added. "
22093 "Optionally the type can be followed by extra parameters, separated by C<:> "
22094 "(colon) characters. For example, I<-N fs> creates a default 100MB, sparsely-"
22095 "allocated disk, containing a single partition, with the partition formatted "
22096 "as ext2. I<-N fs:ext4:1G> is the same, but for an ext4 filesystem on a 1GB "
22101 #: ../fish/guestfish.pod:1040
22102 msgid "To list the available types and any extra parameters they take, run:"
22106 #: ../fish/guestfish.pod:1044
22108 "Note that the prepared filesystem is not mounted. You would usually have to "
22109 "use the C<mount /dev/sda1 /> command or add the I<-m /dev/sda1> option."
22113 #: ../fish/guestfish.pod:1048
22115 "If any I<-N> or I<--new> options are given, the guest is automatically "
22120 #: ../fish/guestfish.pod:1053
22121 msgid "Create a 100MB disk with an ext4-formatted partition:"
22125 #: ../fish/guestfish.pod:1055
22128 " guestfish -N fs:ext4\n"
22133 #: ../fish/guestfish.pod:1057
22134 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:"
22138 #: ../fish/guestfish.pod:1059
22141 " guestfish -N fs:vfat:32M -m /dev/sda1\n"
22146 #: ../fish/guestfish.pod:1061
22147 msgid "Create a blank 200MB disk:"
22151 #: ../fish/guestfish.pod:1063
22154 " guestfish -N disk:200M\n"
22159 #: ../fish/guestfish.pod:1065
22160 msgid "PROGRESS BARS"
22164 #: ../fish/guestfish.pod:1067
22166 "Some (not all) long-running commands send progress notification messages as "
22167 "they are running. Guestfish turns these messages into progress bars."
22171 #: ../fish/guestfish.pod:1071
22173 "When a command that supports progress bars takes longer than two seconds to "
22174 "run, and if progress bars are enabled, then you will see one appearing below "
22179 #: ../fish/guestfish.pod:1075
22182 " ><fs> copy-size /large-file /another-file 2048M\n"
22183 " / 10% [#####-----------------------------------------] 00:30\n"
22188 #: ../fish/guestfish.pod:1078
22190 "The spinner on the left hand side moves round once for every progress "
22191 "notification received from the backend. This is a (reasonably) golden "
22192 "assurance that the command is \"doing something\" even if the progress bar "
22193 "is not moving, because the command is able to send the progress "
22194 "notifications. When the bar reaches 100% and the command finishes, the "
22195 "spinner disappears."
22199 #: ../fish/guestfish.pod:1085
22201 "Progress bars are enabled by default when guestfish is used interactively. "
22202 "You can enable them even for non-interactive modes using I<--progress-bars>, "
22203 "and you can disable them completely using I<--no-progress-bars>."
22207 #: ../fish/guestfish.pod:1090
22208 msgid "GUESTFISH COMMANDS"
22212 #: ../fish/guestfish.pod:1092
22214 "The commands in this section are guestfish convenience commands, in other "
22215 "words, they are not part of the L<guestfs(3)> API."
22219 #: ../fish/guestfish.pod:1095
22224 #: ../fish/guestfish.pod:1097
22236 #: ../fish/guestfish.pod:1100
22237 msgid "Without any parameter, this provides general help."
22238 msgstr "Без параметра показує загальну довідкову інформацію."
22241 #: ../fish/guestfish.pod:1102
22242 msgid "With a C<cmd> parameter, this displays detailed help for that command."
22246 #: ../fish/guestfish.pod:1104
22247 msgid "quit | exit"
22251 #: ../fish/guestfish.pod:1106
22252 msgid "This exits guestfish. You can also use C<^D> key."
22256 #: ../fish/guestfish.pod:1108
22257 msgid "@FISH_COMMANDS@"
22261 #: ../fish/guestfish.pod:1110
22266 #: ../fish/guestfish.pod:1112 ../src/guestfs.pod:1520
22271 #: ../fish/guestfish.pod:1116
22273 "guestfish returns 0 if the commands completed without error, or 1 if there "
22278 #: ../fish/guestfish.pod:1123
22283 #: ../fish/guestfish.pod:1125
22285 "The C<edit> command uses C<$EDITOR> as the editor. If not set, it uses "
22290 #: ../fish/guestfish.pod:1128 ../src/guestfs.pod:3213
22291 msgid "FEBOOTSTRAP_KERNEL"
22295 #: ../fish/guestfish.pod:1130 ../src/guestfs.pod:3215
22296 msgid "FEBOOTSTRAP_MODULES"
22300 #: ../fish/guestfish.pod:1132 ../src/guestfs.pod:3217
22302 "These two environment variables allow the kernel that libguestfs uses in the "
22303 "appliance to be selected. If C<$FEBOOTSTRAP_KERNEL> is not set, then the "
22304 "most recent host kernel is chosen. For more information about kernel "
22305 "selection, see L<febootstrap-supermin-helper(8)>. This feature is only "
22306 "available in febootstrap E<ge> 3.8."
22310 #: ../fish/guestfish.pod:1138
22311 msgid "GUESTFISH_DISPLAY_IMAGE"
22315 #: ../fish/guestfish.pod:1140
22317 "The C<display> command uses C<$GUESTFISH_DISPLAY_IMAGE> to display images. "
22318 "If not set, it uses L<display(1)>."
22322 #: ../fish/guestfish.pod:1143
22323 msgid "GUESTFISH_PID"
22327 #: ../fish/guestfish.pod:1145
22329 "Used with the I<--remote> option to specify the remote guestfish process to "
22330 "control. See section L</REMOTE CONTROL GUESTFISH OVER A SOCKET>."
22334 #: ../fish/guestfish.pod:1149
22339 #: ../fish/guestfish.pod:1151
22341 "The L</hexedit> command uses C<$HEXEDITOR> as the external hex editor. If "
22342 "not specified, the external L<hexedit(1)> program is used."
22346 #: ../fish/guestfish.pod:1155
22351 #: ../fish/guestfish.pod:1157
22353 "If compiled with GNU readline support, various files in the home directory "
22354 "can be used. See L</FILES>."
22358 #: ../fish/guestfish.pod:1160 ../src/guestfs.pod:3223
22359 msgid "LIBGUESTFS_APPEND"
22363 #: ../fish/guestfish.pod:1162 ../src/guestfs.pod:3225
22364 msgid "Pass additional options to the guest kernel."
22368 #: ../fish/guestfish.pod:1164 ../src/guestfs.pod:3227
22369 msgid "LIBGUESTFS_DEBUG"
22370 msgstr "LIBGUESTFS_DEBUG"
22373 #: ../fish/guestfish.pod:1166
22375 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages. This has the same "
22376 "effect as using the B<-v> option."
22380 #: ../fish/guestfish.pod:1169 ../src/guestfs.pod:3232
22381 msgid "LIBGUESTFS_MEMSIZE"
22382 msgstr "LIBGUESTFS_MEMSIZE"
22385 #: ../fish/guestfish.pod:1171 ../src/guestfs.pod:3234
22387 "Set the memory allocated to the qemu process, in megabytes. For example:"
22391 #: ../fish/guestfish.pod:1174 ../src/guestfs.pod:3237
22394 " LIBGUESTFS_MEMSIZE=700\n"
22397 " LIBGUESTFS_MEMSIZE=700\n"
22401 #: ../fish/guestfish.pod:1176 ../src/guestfs.pod:3239
22402 msgid "LIBGUESTFS_PATH"
22406 #: ../fish/guestfish.pod:1178
22408 "Set the path that guestfish uses to search for kernel and initrd.img. See "
22409 "the discussion of paths in L<guestfs(3)>."
22413 #: ../fish/guestfish.pod:1181 ../src/guestfs.pod:3244
22414 msgid "LIBGUESTFS_QEMU"
22418 #: ../fish/guestfish.pod:1183 ../src/guestfs.pod:3246
22420 "Set the default qemu binary that libguestfs uses. If not set, then the qemu "
22421 "which was found at compile time by the configure script is used."
22425 #: ../fish/guestfish.pod:1187 ../src/guestfs.pod:3252
22426 msgid "LIBGUESTFS_TRACE"
22430 #: ../fish/guestfish.pod:1189
22431 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces."
22435 #: ../fish/guestfish.pod:1191
22437 msgstr "РОЗБИТТЯ НА СТОРІНКИ"
22440 #: ../fish/guestfish.pod:1193
22442 "The C<more> command uses C<$PAGER> as the pager. If not set, it uses "
22447 #: ../fish/guestfish.pod:1196 ../sparsify/virt-sparsify.pod:236
22448 #: ../src/guestfs.pod:3257
22453 #: ../fish/guestfish.pod:1198 ../src/guestfs.pod:3259
22455 "Location of temporary directory, defaults to C</tmp> except for the cached "
22456 "supermin appliance which defaults to C</var/tmp>."
22460 #: ../fish/guestfish.pod:1201 ../src/guestfs.pod:3262
22462 "If libguestfs was compiled to use the supermin appliance then the real "
22463 "appliance is cached in this directory, shared between all handles belonging "
22464 "to the same EUID. You can use C<$TMPDIR> to configure another directory to "
22465 "use in case C</var/tmp> is not large enough."
22469 #: ../fish/guestfish.pod:1209 ../fuse/guestmount.pod:297
22470 #: ../rescue/virt-rescue.pod:310
22475 #: ../fish/guestfish.pod:1213 ../fuse/guestmount.pod:301
22476 #: ../rescue/virt-rescue.pod:314
22477 msgid "$HOME/.libguestfs-tools.rc"
22481 #: ../fish/guestfish.pod:1215 ../fuse/guestmount.pod:303
22482 #: ../rescue/virt-rescue.pod:316
22483 msgid "/etc/libguestfs-tools.conf"
22487 #: ../fish/guestfish.pod:1217 ../fuse/guestmount.pod:305
22488 #: ../rescue/virt-rescue.pod:318
22490 "This configuration file controls the default read-only or read-write mode "
22491 "(I<--ro> or I<--rw>)."
22495 #: ../fish/guestfish.pod:1220
22496 msgid "See L</OPENING DISKS FOR READ AND WRITE>."
22497 msgstr "Див. L</OPENING DISKS FOR READ AND WRITE>."
22500 #: ../fish/guestfish.pod:1222
22501 msgid "$HOME/.guestfish"
22505 #: ../fish/guestfish.pod:1224
22507 "If compiled with GNU readline support, then the command history is saved in "
22512 #: ../fish/guestfish.pod:1227
22513 msgid "$HOME/.inputrc"
22517 #: ../fish/guestfish.pod:1229
22518 msgid "/etc/inputrc"
22522 #: ../fish/guestfish.pod:1231
22524 "If compiled with GNU readline support, then these files can be used to "
22525 "configure readline. For further information, please see L<readline(3)/"
22526 "INITIALIZATION FILE>."
22530 #: ../fish/guestfish.pod:1235
22531 msgid "To write rules which only apply to guestfish, use:"
22535 #: ../fish/guestfish.pod:1237
22545 #: ../fish/guestfish.pod:1241
22547 "Variables that you can set in inputrc that change the behaviour of guestfish "
22548 "in useful ways include:"
22552 #: ../fish/guestfish.pod:1246
22553 msgid "completion-ignore-case (default: on)"
22557 #: ../fish/guestfish.pod:1248
22559 "By default, guestfish will ignore case when tab-completing paths on the "
22564 #: ../fish/guestfish.pod:1251
22567 " set completion-ignore-case off\n"
22572 #: ../fish/guestfish.pod:1253
22573 msgid "to make guestfish case sensitive."
22577 #: ../fish/guestfish.pod:1257
22582 #: ../fish/guestfish.pod:1259
22583 msgid "test2.img (etc)"
22587 #: ../fish/guestfish.pod:1261
22589 "When using the I<-N> or I<--new> option, the prepared disk or filesystem "
22590 "will be created in the file C<test1.img> in the current directory. The "
22591 "second use of I<-N> will use C<test2.img> and so on. Any existing file with "
22592 "the same name will be overwritten."
22596 #: ../fish/guestfish.pod:1270
22598 "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-alignment-scan(1)>, L<virt-"
22599 "cat(1)>, L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit"
22600 "(1)>, L<virt-filesystems(1)>, L<virt-inspector(1)>, L<virt-list-filesystems"
22601 "(1)>, L<virt-list-partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-"
22602 "rescue(1)>, L<virt-resize(1)>, L<virt-sparsify(1)>, L<virt-sysprep(1)>, "
22603 "L<virt-tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)>, "
22604 "L<display(1)>, L<hexedit(1)>, L<febootstrap-supermin-helper(8)>."
22608 #: ../fish/guestfish.pod:1302 ../src/guestfs.pod:3355
22609 #: ../test-tool/libguestfs-test-tool.pod:112
22610 msgid "Copyright (C) 2009-2011 Red Hat Inc. L<http://libguestfs.org/>"
22614 #: ../fish/virt-copy-in.pod:5
22616 "virt-copy-in - Copy files and directories into a virtual machine disk image."
22620 #: ../fish/virt-copy-in.pod:9
22623 " virt-copy-in -a disk.img file|dir [file|dir ...] /destination\n"
22628 #: ../fish/virt-copy-in.pod:11
22631 " virt-copy-in -d domain file|dir [file|dir ...] /destination\n"
22636 #: ../fish/virt-copy-in.pod:15
22638 "Using C<virt-copy-in> on live virtual machines can be dangerous, potentially "
22639 "causing disk corruption. The virtual machine must be shut down before you "
22640 "use this command."
22644 #: ../fish/virt-copy-in.pod:21
22646 "C<virt-copy-in> copies files and directories from the local disk into a "
22647 "virtual machine disk image or named libvirt domain."
22651 #: ../fish/virt-copy-in.pod:24
22653 "You can give one of more filenames and directories on the command line. "
22654 "Directories are copied in recursively. The final parameter must be the "
22655 "destination directory in the disk image which must be an absolute path "
22656 "starting with a C</> character."
22660 #: ../fish/virt-copy-in.pod:33
22663 " virt-copy-in -d MyGuest resolv.conf /etc\n"
22668 #: ../fish/virt-copy-in.pod:35 ../fish/virt-tar-in.pod:32
22669 msgid "Upload a home directory to a guest:"
22673 #: ../fish/virt-copy-in.pod:37
22676 " virt-copy-in -d MyGuest skel /home\n"
22681 #: ../fish/virt-copy-in.pod:39 ../fish/virt-copy-out.pod:28
22682 #: ../fish/virt-tar-in.pod:36 ../fish/virt-tar-out.pod:30
22683 msgid "JUST A SHELL SCRIPT WRAPPER AROUND GUESTFISH"
22687 #: ../fish/virt-copy-in.pod:41
22689 "This command is just a simple shell script wrapper around the L<guestfish(1)"
22690 "> C<copy-in> command. For anything more complex than a trivial copy, you "
22691 "are probably better off using guestfish directly."
22695 #: ../fish/virt-copy-in.pod:47 ../fish/virt-copy-out.pod:36
22696 #: ../fish/virt-tar-in.pod:44 ../fish/virt-tar-out.pod:38
22698 "Since the shell script just passes options straight to guestfish, read "
22699 "L<guestfish(1)> to see the full list of options."
22703 #: ../fish/virt-copy-in.pod:52
22705 "L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, "
22706 "L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<http://libguestfs.org/>."
22710 #: ../fish/virt-copy-in.pod:66 ../fish/virt-copy-out.pod:55
22711 #: ../fish/virt-tar-in.pod:64 ../fish/virt-tar-out.pod:57
22712 msgid "Copyright (C) 2011 Red Hat Inc. L<http://libguestfs.org/>"
22716 #: ../fish/virt-copy-out.pod:5
22718 "virt-copy-out - Copy files and directories out of a virtual machine disk "
22723 #: ../fish/virt-copy-out.pod:9
22726 " virt-copy-out -a disk.img /file|dir [/file|dir ...] localdir\n"
22731 #: ../fish/virt-copy-out.pod:11
22734 " virt-copy-out -d domain /file|dir [/file|dir ...] localdir\n"
22739 #: ../fish/virt-copy-out.pod:15
22741 "C<virt-copy-out> copies files and directories out of a virtual machine disk "
22742 "image or named libvirt domain."
22746 #: ../fish/virt-copy-out.pod:18
22748 "You can give one of more filenames and directories on the command line. "
22749 "Directories are copied out recursively."
22753 #: ../fish/virt-copy-out.pod:23
22754 msgid "Download the home directories from a virtual machine:"
22758 #: ../fish/virt-copy-out.pod:25
22762 " virt-copy-out -d MyGuest /home homes\n"
22767 #: ../fish/virt-copy-out.pod:30
22769 "This command is just a simple shell script wrapper around the L<guestfish(1)"
22770 "> C<copy-out> command. For anything more complex than a trivial copy, you "
22771 "are probably better off using guestfish directly."
22775 #: ../fish/virt-copy-out.pod:41
22777 "L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-edit(1)>, L<virt-"
22778 "tar-in(1)>, L<virt-tar-out(1)>, L<http://libguestfs.org/>."
22782 #: ../fish/virt-tar-in.pod:5
22783 msgid "virt-tar-in - Unpack a tarball into a virtual machine disk image."
22787 #: ../fish/virt-tar-in.pod:9
22790 " virt-tar-in -a disk.img data.tar /destination\n"
22795 #: ../fish/virt-tar-in.pod:11
22798 " virt-tar-in -d domain data.tar /destination\n"
22803 #: ../fish/virt-tar-in.pod:13
22806 " zcat data.tar.gz | virt-tar-in -d domain - /destination\n"
22811 #: ../fish/virt-tar-in.pod:17
22813 "Using C<virt-tar-in> on live virtual machines can be dangerous, potentially "
22814 "causing disk corruption. The virtual machine must be shut down before you "
22815 "use this command."
22819 #: ../fish/virt-tar-in.pod:23
22821 "C<virt-tar-in> unpacks an uncompressed tarball into a virtual machine disk "
22822 "image or named libvirt domain."
22826 #: ../fish/virt-tar-in.pod:26
22828 "The first parameter is the tar file. Use C<-> to read the tar file from "
22829 "standard input. The second parameter is the absolute target directory to "
22834 #: ../fish/virt-tar-in.pod:34
22837 " virt-tar-in -d MyGuest homes.tar /home\n"
22842 #: ../fish/virt-tar-in.pod:38
22844 "This command is just a simple shell script wrapper around the L<guestfish(1)"
22845 "> C<tar-in> command. For anything more complex than a trivial copy, you are "
22846 "probably better off using guestfish directly."
22850 #: ../fish/virt-tar-in.pod:49
22852 "L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-copy-out(1)>, "
22853 "L<virt-edit(1)>, L<virt-make-fs(1)>, L<virt-tar-out(1)>, L<http://libguestfs."
22858 #: ../fish/virt-tar-out.pod:5
22860 "virt-tar-out - Pack a virtual machine disk image directory into a tarball."
22864 #: ../fish/virt-tar-out.pod:9
22867 " virt-tar-out -a disk.img /dir files.tar\n"
22872 #: ../fish/virt-tar-out.pod:11
22875 " virt-tar-out -d domain /dir files.tar\n"
22880 #: ../fish/virt-tar-out.pod:13
22883 " virt-tar-out -d domain /dir - | gzip --best > files.tar.gz\n"
22888 #: ../fish/virt-tar-out.pod:17
22890 "C<virt-tar-out> packs a virtual machine disk image directory into a tarball."
22894 #: ../fish/virt-tar-out.pod:20
22896 "The first parameter is the absolute path of the virtual machine directory. "
22897 "The second parameter is the tar file to write. Use C<-> to write to "
22902 #: ../fish/virt-tar-out.pod:26
22903 msgid "Download the home directories from a guest:"
22907 #: ../fish/virt-tar-out.pod:28
22910 " virt-tar-out -d MyGuest /home - | gzip --best > homes.tar.gz\n"
22915 #: ../fish/virt-tar-out.pod:32
22917 "This command is just a simple shell script wrapper around the L<guestfish(1)"
22918 "> C<tar-out> command. For anything more complex than a trivial copy, you "
22919 "are probably better off using guestfish directly."
22923 #: ../fish/virt-tar-out.pod:43
22925 "L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-copy-out(1)>, "
22926 "L<virt-edit(1)>, L<virt-tar-in(1)>, L<http://libguestfs.org/>."
22930 #: ../fuse/guestmount.pod:5
22932 "guestmount - Mount a guest filesystem on the host using FUSE and libguestfs"
22936 #: ../fuse/guestmount.pod:9
22939 " guestmount [--options] -a disk.img -m device [--ro] mountpoint\n"
22944 #: ../fuse/guestmount.pod:11
22947 " guestmount [--options] -a disk.img -i [--ro] mountpoint\n"
22952 #: ../fuse/guestmount.pod:13
22955 " guestmount [--options] -d Guest -i [--ro] mountpoint\n"
22960 #: ../fuse/guestmount.pod:17
22962 "You must I<not> use C<guestmount> in read-write mode on live virtual "
22963 "machines. If you do this, you risk disk corruption in the VM."
22967 #: ../fuse/guestmount.pod:22
22969 "The guestmount program can be used to mount virtual machine filesystems and "
22970 "other disk images on the host. It uses libguestfs for access to the guest "
22971 "filesystem, and FUSE (the \"filesystem in userspace\") to make it appear as "
22972 "a mountable device."
22976 #: ../fuse/guestmount.pod:27
22978 "Along with other options, you have to give at least one device (I<-a> "
22979 "option) or libvirt domain (I<-d> option), and at least one mountpoint (I<-m> "
22980 "option) or use the I<-i> inspection option or the I<--live> option. How "
22981 "this works is better explained in the L<guestfish(1)> manual page, or by "
22982 "looking at the examples below."
22986 #: ../fuse/guestmount.pod:33
22988 "FUSE lets you mount filesystems as non-root. The mountpoint must be owned "
22989 "by you, and the filesystem will not be visible to any other users unless you "
22990 "make certain global configuration changes to C</etc/fuse.conf>. To unmount "
22991 "the filesystem, use the C<fusermount -u> command."
22995 #: ../fuse/guestmount.pod:41
22997 "For a typical Windows guest which has its main filesystem on the first "
23002 #: ../fuse/guestmount.pod:44
23005 " guestmount -a windows.img -m /dev/sda1 --ro /mnt\n"
23010 #: ../fuse/guestmount.pod:46
23012 "For a typical Linux guest which has a /boot filesystem on the first "
23013 "partition, and the root filesystem on a logical volume:"
23017 #: ../fuse/guestmount.pod:49
23020 " guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt\n"
23025 #: ../fuse/guestmount.pod:51
23026 msgid "To get libguestfs to detect guest mountpoints for you:"
23030 #: ../fuse/guestmount.pod:53
23033 " guestmount -a guest.img -i --ro /mnt\n"
23038 #: ../fuse/guestmount.pod:55
23039 msgid "For a libvirt guest called \"Guest\" you could do:"
23043 #: ../fuse/guestmount.pod:57
23046 " guestmount -d Guest -i --ro /mnt\n"
23051 #: ../fuse/guestmount.pod:59
23053 "If you don't know what filesystems are contained in a guest or disk image, "
23054 "use L<virt-filesystems(1)> first:"
23058 #: ../fuse/guestmount.pod:62
23061 " virt-filesystems MyGuest\n"
23066 #: ../fuse/guestmount.pod:64
23068 "If you want to trace the libguestfs calls but without excessive debugging "
23069 "information, we recommend:"
23073 #: ../fuse/guestmount.pod:67
23076 " guestmount [...] --trace /mnt\n"
23081 #: ../fuse/guestmount.pod:69
23082 msgid "If you want to debug the program, we recommend:"
23086 #: ../fuse/guestmount.pod:71
23089 " guestmount [...] --trace --verbose /mnt\n"
23094 #: ../fuse/guestmount.pod:73 ../rescue/virt-rescue.pod:96
23095 #: ../resize/virt-resize.pod:621
23100 #: ../fuse/guestmount.pod:75
23101 msgid "Other users cannot see the filesystem by default"
23105 #: ../fuse/guestmount.pod:77
23107 "If you mount a filesystem as one user (eg. root), then other users will not "
23108 "be able to see it by default. The fix is to add the FUSE C<allow_other> "
23109 "option when mounting:"
23113 #: ../fuse/guestmount.pod:81
23116 " sudo guestmount [...] -o allow_other /mnt\n"
23121 #: ../fuse/guestmount.pod:83
23122 msgid "Enabling FUSE"
23126 #: ../fuse/guestmount.pod:85
23128 "On some distros, you may need to add yourself to a special group (eg. "
23129 "C<fuse>) before you can use any FUSE filesystem. This is necessary on "
23130 "Debian and derivatives."
23134 #: ../fuse/guestmount.pod:89
23136 "On other distros, no special group is required. It is not necessary on "
23137 "Fedora or Red Hat Enterprise Linux."
23141 #: ../fuse/guestmount.pod:100
23142 msgid "Add a block device or virtual machine image."
23146 #: ../fuse/guestmount.pod:123
23147 msgid "B<--dir-cache-timeout N>"
23148 msgstr "B<--dir-cache-timeout N>"
23151 #: ../fuse/guestmount.pod:125
23153 "Set the readdir cache timeout to I<N> seconds, the default being 60 "
23154 "seconds. The readdir cache [actually, there are several semi-independent "
23155 "caches] is populated after a readdir(2) call with the stat and extended "
23156 "attributes of the files in the directory, in anticipation that they will be "
23157 "requested soon after."
23161 #: ../fuse/guestmount.pod:131
23163 "There is also a different attribute cache implemented by FUSE (see the FUSE "
23164 "option I<-o attr_timeout>), but the FUSE cache does not anticipate future "
23165 "requests, only cache existing ones."
23169 #: ../fuse/guestmount.pod:151
23171 "If you have untrusted raw-format guest disk images, you should use this "
23172 "option to specify the disk format. This avoids a possible security problem "
23173 "with malicious guests (CVE-2010-3851). See also L<guestfs(3)/"
23174 "guestfs_add_drive_opts>."
23178 #: ../fuse/guestmount.pod:156
23179 msgid "B<--fuse-help>"
23180 msgstr "B<--fuse-help>"
23183 #: ../fuse/guestmount.pod:158
23184 msgid "Display help on special FUSE options (see I<-o> below)."
23188 #: ../fuse/guestmount.pod:162
23189 msgid "Display brief help and exit."
23193 #: ../fuse/guestmount.pod:186
23195 "Mount the named partition or logical volume on the given mountpoint B<in the "
23196 "guest> (this has nothing to do with mountpoints in the host)."
23200 #: ../fuse/guestmount.pod:189
23202 "If the mountpoint is omitted, it defaults to C</>. You have to mount "
23203 "something on C</>."
23207 #: ../fuse/guestmount.pod:206
23209 "By default, we attempt to sync the guest disk when the FUSE mountpoint is "
23210 "unmounted. If you specify this option, then we don't attempt to sync the "
23211 "disk. See the discussion of autosync in the L<guestfs(3)> manpage."
23215 #: ../fuse/guestmount.pod:211
23216 msgid "B<-o option>"
23217 msgstr "B<-o параметр>"
23220 #: ../fuse/guestmount.pod:213
23221 msgid "B<--option option>"
23222 msgstr "B<--option параметр>"
23225 #: ../fuse/guestmount.pod:215
23226 msgid "Pass extra options to FUSE."
23230 #: ../fuse/guestmount.pod:217
23232 "To get a list of all the extra options supported by FUSE, use the command "
23233 "below. Note that only the FUSE I<-o> options can be passed, and only some "
23234 "of them are a good idea."
23238 #: ../fuse/guestmount.pod:221
23241 " guestmount --fuse-help\n"
23246 #: ../fuse/guestmount.pod:223
23247 msgid "Some potentially useful FUSE options:"
23251 #: ../fuse/guestmount.pod:227
23252 msgid "B<-o allow_other>"
23256 #: ../fuse/guestmount.pod:229
23257 msgid "Allow other users to see the filesystem."
23261 #: ../fuse/guestmount.pod:231
23262 msgid "B<-o attr_timeout=N>"
23263 msgstr "B<-o attr_timeout=N>"
23266 #: ../fuse/guestmount.pod:233
23267 msgid "Enable attribute caching by FUSE, and set the timeout to I<N> seconds."
23271 #: ../fuse/guestmount.pod:235
23272 msgid "B<-o kernel_cache>"
23276 #: ../fuse/guestmount.pod:237
23278 "Allow the kernel to cache files (reduces the number of reads that have to go "
23279 "through the L<guestfs(3)> API). This is generally a good idea if you can "
23280 "afford the extra memory usage."
23284 #: ../fuse/guestmount.pod:241
23285 msgid "B<-o uid=N> B<-o gid=N>"
23286 msgstr "B<-o uid=N> B<-o gid=N>"
23289 #: ../fuse/guestmount.pod:243
23291 "Use these options to map all UIDs and GIDs inside the guest filesystem to "
23292 "the chosen values."
23296 #: ../fuse/guestmount.pod:252
23298 "Add devices and mount everything read-only. Also disallow writes and make "
23299 "the disk appear read-only to FUSE."
23303 #: ../fuse/guestmount.pod:255
23305 "This is highly recommended if you are not going to edit the guest disk. If "
23306 "the guest is running and this option is I<not> supplied, then there is a "
23307 "strong risk of disk corruption in the guest. We try to prevent this from "
23308 "happening, but it is not always possible."
23312 #: ../fuse/guestmount.pod:260 ../rescue/virt-rescue.pod:199
23313 msgid "See also L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
23314 msgstr "Див. також L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
23317 #: ../fuse/guestmount.pod:264
23318 msgid "Enable SELinux support for the guest."
23322 #: ../fuse/guestmount.pod:270
23323 msgid "Enable verbose messages from underlying libguestfs."
23327 #: ../fuse/guestmount.pod:276
23328 msgid "Display the program version and exit."
23332 #: ../fuse/guestmount.pod:285 ../fuse/guestmount.pod:308
23333 #: ../rescue/virt-rescue.pod:238 ../rescue/virt-rescue.pod:321
23334 msgid "See L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
23335 msgstr "Див. L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
23338 #: ../fuse/guestmount.pod:289
23340 msgstr "B<--trace>"
23343 #: ../fuse/guestmount.pod:291
23344 msgid "Trace libguestfs calls and entry into each FUSE function."
23348 #: ../fuse/guestmount.pod:293
23349 msgid "This also stops the daemon from forking into the background."
23353 #: ../fuse/guestmount.pod:319
23355 "L<guestfish(1)>, L<virt-inspector(1)>, L<virt-cat(1)>, L<virt-edit(1)>, "
23356 "L<virt-tar(1)>, L<guestfs(3)>, L<http://libguestfs.org/>, L<http://fuse.sf."
23359 "L<guestfish(1)>, L<virt-inspector(1)>, L<virt-cat(1)>, L<virt-edit(1)>, "
23360 "L<virt-tar(1)>, L<guestfs(3)>, L<http://libguestfs.org/>, L<http://fuse.sf."
23364 #: ../fuse/guestmount.pod:334
23365 msgid "Copyright (C) 2009-2010 Red Hat Inc. L<http://libguestfs.org/>"
23369 #: ../inspector/virt-inspector.pod:5
23371 "virt-inspector - Display operating system version and other information "
23372 "about a virtual machine"
23376 #: ../inspector/virt-inspector.pod:9
23379 " virt-inspector [--options] -d domname\n"
23384 #: ../inspector/virt-inspector.pod:11
23387 " virt-inspector [--options] -a disk.img [-a disk.img ...]\n"
23392 #: ../inspector/virt-inspector.pod:15
23395 " virt-inspector domname\n"
23400 #: ../inspector/virt-inspector.pod:17 ../inspector/virt-inspector.pod:148
23403 " virt-inspector disk.img [disk.img ...]\n"
23408 #: ../inspector/virt-inspector.pod:21
23410 "B<virt-inspector> examines a virtual machine or disk image and tries to "
23411 "determine the version of the operating system and other information about "
23412 "the virtual machine."
23416 #: ../inspector/virt-inspector.pod:25
23417 msgid "Virt-inspector produces XML output for feeding into other programs."
23421 #: ../inspector/virt-inspector.pod:27
23423 "In the normal usage, use C<virt-inspector -d domname> where C<domname> is "
23424 "the libvirt domain (see: C<virsh list --all>)."
23428 #: ../inspector/virt-inspector.pod:30
23430 "You can also run virt-inspector directly on disk images from a single "
23431 "virtual machine. Use C<virt-inspector -a disk.img>. In rare cases a domain "
23432 "has several block devices, in which case you should list several I<-a> "
23433 "options one after another, with the first corresponding to the guest's C</"
23434 "dev/sda>, the second to the guest's C</dev/sdb> and so on."
23438 #: ../inspector/virt-inspector.pod:37
23440 "You can also run virt-inspector on install disks, live CDs, bootable USB "
23441 "keys and similar."
23445 #: ../inspector/virt-inspector.pod:40
23447 "Virt-inspector can only inspect and report upon I<one domain at a time>. To "
23448 "inspect several virtual machines, you have to run virt-inspector several "
23449 "times (for example, from a shell script for-loop)."
23453 #: ../inspector/virt-inspector.pod:45
23455 "Because virt-inspector needs direct access to guest images, it won't "
23456 "normally work over remote libvirt connections."
23460 #: ../inspector/virt-inspector.pod:48
23462 "All of the information available from virt-inspector is also available "
23463 "through the core libguestfs inspection API (see L<guestfs(3)/INSPECTION>). "
23464 "The same information can also be fetched using guestfish or via libguestfs "
23465 "bindings in many programming languages (see L<guestfs(3)/USING LIBGUESTFS "
23466 "WITH OTHER PROGRAMMING LANGUAGES>)."
23470 #: ../inspector/virt-inspector.pod:81
23472 "Libvirt is only used if you specify a C<domname> on the command line. If "
23473 "you specify guest block devices directly (I<-a>), then libvirt is not used "
23478 #: ../inspector/virt-inspector.pod:94
23480 "When prompting for keys and passphrases, virt-inspector normally turns "
23481 "echoing off so you cannot see what you are typing. If you are not worried "
23482 "about Tempest attacks and there is no one else in the room you can specify "
23483 "this flag to see what you are typing."
23487 #: ../inspector/virt-inspector.pod:103 ../tools/virt-list-filesystems.pl:93
23488 #: ../tools/virt-list-partitions.pl:94 ../tools/virt-tar.pl:143
23489 #: ../tools/virt-win-reg.pl:144
23491 "Specify the format of disk images given on the command line. If this is "
23492 "omitted then the format is autodetected from the content of the disk image."
23496 #: ../inspector/virt-inspector.pod:107 ../tools/virt-list-filesystems.pl:97
23497 #: ../tools/virt-list-partitions.pl:98 ../tools/virt-tar.pl:147
23498 #: ../tools/virt-win-reg.pl:148
23500 "If disk images are requested from libvirt, then this program asks libvirt "
23501 "for this information. In this case, the value of the format parameter is "
23506 #: ../inspector/virt-inspector.pod:111 ../resize/virt-resize.pod:391
23507 #: ../resize/virt-resize.pod:483 ../sparsify/virt-sparsify.pod:132
23508 #: ../tools/virt-list-filesystems.pl:101 ../tools/virt-list-partitions.pl:102
23509 #: ../tools/virt-tar.pl:151 ../tools/virt-win-reg.pl:152
23511 "If working with untrusted raw-format guest disk images, you should ensure "
23512 "the format is always specified."
23516 #: ../inspector/virt-inspector.pod:135
23518 #| msgid "B<--parts>"
23519 msgid "B<--xpath> query"
23520 msgstr "B<--parts>"
23523 #: ../inspector/virt-inspector.pod:137
23525 "Perform an XPath query on the XML on stdin, and print the result on stdout. "
23526 "In this mode virt-inspector simply runs an XPath query; all other inspection "
23527 "functions are disabled. See L</XPATH QUERIES> below for some examples."
23531 #: ../inspector/virt-inspector.pod:146
23532 msgid "Previous versions of virt-inspector allowed you to write either:"
23536 #: ../inspector/virt-inspector.pod:152
23539 " virt-inspector guestname\n"
23544 #: ../inspector/virt-inspector.pod:160
23549 #: ../inspector/virt-inspector.pod:162
23551 "The virt-inspector XML is described precisely in a RELAX NG schema file "
23552 "C<virt-inspector.rng> which is supplied with libguestfs. This section is "
23553 "just an overview."
23557 #: ../inspector/virt-inspector.pod:166
23559 "The top-level element is E<lt>operatingsystemsE<gt>, and it contains one or "
23560 "more E<lt>operatingsystemE<gt> elements. You would only see more than one "
23561 "E<lt>operatingsystemE<gt> element if the virtual machine is multi-boot, "
23562 "which is vanishingly rare in real world VMs."
23566 #: ../inspector/virt-inspector.pod:171
23567 msgid "E<lt>operatingsystemE<gt>"
23571 #: ../inspector/virt-inspector.pod:173
23573 "In the E<lt>operatingsystemE<gt> tag are various optional fields that "
23574 "describe the operating system, its architecture, the descriptive \"product "
23575 "name\" string, the type of OS and so on, as in this example:"
23579 #: ../inspector/virt-inspector.pod:177
23582 " <operatingsystems>\n"
23583 " <operatingsystem>\n"
23584 " <root>/dev/sda2</root>\n"
23585 " <name>windows</name>\n"
23586 " <arch>i386</arch>\n"
23587 " <distro>windows</distro>\n"
23588 " <product_name>Windows 7 Enterprise</product_name>\n"
23589 " <product_variant>Client</product_variant>\n"
23590 " <major_version>6</major_version>\n"
23591 " <minor_version>1</minor_version>\n"
23592 " <windows_systemroot>/Windows</windows_systemroot>\n"
23593 " <format>installed</format>\n"
23598 #: ../inspector/virt-inspector.pod:190
23600 "In brief, E<lt>nameE<gt> is the class of operating system (something like "
23601 "C<linux> or C<windows>), E<lt>distroE<gt> is the distribution (eg. C<fedora> "
23602 "but many other distros are recognized) and E<lt>archE<gt> is the guest "
23603 "architecture. The other fields are fairly self-explanatory, but because "
23604 "these fields are taken directly from the libguestfs inspection API you can "
23605 "find precise information from L<guestfs(3)/INSPECTION>."
23609 #: ../inspector/virt-inspector.pod:198
23611 "The E<lt>rootE<gt> element is the root filesystem device, but from the point "
23612 "of view of libguestfs (block devices may have completely different names "
23613 "inside the VM itself)."
23617 #: ../inspector/virt-inspector.pod:202
23618 msgid "E<lt>mountpointsE<gt>"
23622 #: ../inspector/virt-inspector.pod:204
23624 "Un*x-like guests typically have multiple filesystems which are mounted at "
23625 "various mountpoints, and these are described in the E<lt>mountpointsE<gt> "
23626 "element which looks like this:"
23630 #: ../inspector/virt-inspector.pod:208
23633 " <operatingsystems>\n"
23634 " <operatingsystem>\n"
23637 " <mountpoint dev=\"/dev/vg_f13x64/lv_root\">/</mountpoint>\n"
23638 " <mountpoint dev=\"/dev/sda1\">/boot</mountpoint>\n"
23639 " </mountpoints>\n"
23644 #: ../inspector/virt-inspector.pod:216
23646 "As with E<lt>rootE<gt>, devices are from the point of view of libguestfs, "
23647 "and may have completely different names inside the guest. Only mountable "
23648 "filesystems appear in this list, not things like swap devices."
23652 #: ../inspector/virt-inspector.pod:221
23653 msgid "E<lt>filesystemsE<gt>"
23657 #: ../inspector/virt-inspector.pod:223
23659 "E<lt>filesystemsE<gt> is like E<lt>mountpointsE<gt> but covers I<all> "
23660 "filesystems belonging to the guest, including swap and empty partitions. "
23661 "(In the rare case of a multi-boot guest, it covers filesystems belonging to "
23662 "this OS or shared with this OS and other OSes)."
23666 #: ../inspector/virt-inspector.pod:229
23667 msgid "You might see something like this:"
23671 #: ../inspector/virt-inspector.pod:231
23674 " <operatingsystems>\n"
23675 " <operatingsystem>\n"
23678 " <filesystem dev=\"/dev/vg_f13x64/lv_root\">\n"
23679 " <type>ext4</type>\n"
23680 " <label>Fedora-13-x86_64</label>\n"
23681 " <uuid>e6a4db1e-15c2-477b-ac2a-699181c396aa</uuid>\n"
23687 #: ../inspector/virt-inspector.pod:241
23689 "The optional elements within E<lt>filesystemE<gt> are the filesystem type, "
23690 "the label, and the UUID."
23694 #: ../inspector/virt-inspector.pod:244
23695 msgid "E<lt>applicationsE<gt>"
23699 #: ../inspector/virt-inspector.pod:246
23701 "The related elements E<lt>package_formatE<gt>, E<lt>package_managementE<gt> "
23702 "and E<lt>applicationsE<gt> describe applications installed in the virtual "
23707 #: ../inspector/virt-inspector.pod:250
23709 "E<lt>package_formatE<gt>, if present, describes the packaging system used. "
23710 "Typical values would be C<rpm> and C<deb>."
23714 #: ../inspector/virt-inspector.pod:253
23716 "E<lt>package_managementE<gt>, if present, describes the package manager. "
23717 "Typical values include C<yum>, C<up2date> and C<apt>"
23721 #: ../inspector/virt-inspector.pod:256
23722 msgid "E<lt>applicationsE<gt> lists the packages or applications installed."
23726 #: ../inspector/virt-inspector.pod:259
23729 " <operatingsystems>\n"
23730 " <operatingsystem>\n"
23732 " <applications>\n"
23734 " <name>coreutils</name>\n"
23735 " <version>8.5</version>\n"
23736 " <release>1</release>\n"
23737 " </application>\n"
23742 #: ../inspector/virt-inspector.pod:269
23744 "The version and release fields may not be available for some types guests. "
23745 "Other fields are possible, see L<guestfs(3)/"
23746 "guestfs_inspect_list_applications>."
23750 #: ../inspector/virt-inspector.pod:273
23751 msgid "E<lt>drive_mappingsE<gt>"
23755 #: ../inspector/virt-inspector.pod:275
23757 "For operating systems like Windows which use drive letters, virt-inspector "
23758 "is able to find out how drive letters map to filesystems."
23762 #: ../inspector/virt-inspector.pod:279
23765 " <operatingsystems>\n"
23766 " <operatingsystem>\n"
23768 " <drive_mappings>\n"
23769 " <drive_mapping name=\"C\">/dev/sda2</drive_mapping>\n"
23770 " <drive_mapping name=\"E\">/dev/sdb1</drive_mapping>\n"
23771 " </drive_mappings>\n"
23776 #: ../inspector/virt-inspector.pod:287
23778 "In the example above, drive C maps to the filesystem on the second partition "
23779 "on the first disk, and drive E maps to the filesystem on the first partition "
23780 "on the second disk."
23784 #: ../inspector/virt-inspector.pod:291
23786 "Note that this only covers permanent local filesystem mappings, not things "
23787 "like network shares. Furthermore NTFS volume mount points may not be listed "
23792 #: ../inspector/virt-inspector.pod:295
23793 msgid "E<lt>iconE<gt>"
23797 #: ../inspector/virt-inspector.pod:297
23799 "Virt-inspector is sometimes able to extract an icon or logo for the guest. "
23800 "The icon is returned as base64-encoded PNG data. Note that the icon can be "
23801 "very large and high quality."
23805 #: ../inspector/virt-inspector.pod:301
23808 " <operatingsystems>\n"
23809 " <operatingsystem>\n"
23812 " iVBORw0KGgoAAAANSUhEUgAAAGAAAABg[.......]\n"
23813 " [... many lines of base64 data ...]\n"
23819 #: ../inspector/virt-inspector.pod:309
23821 "To display the icon, you have to extract it and convert the base64 data back "
23822 "to a binary file. Use an XPath query or simply an editor to extract the "
23823 "data, then use the coreutils L<base64(1)> program to do the conversion back "
23828 #: ../inspector/virt-inspector.pod:314
23831 " base64 -i -d < icon.data > icon.png\n"
23836 #: ../inspector/virt-inspector.pod:316
23837 msgid "INSPECTING INSTALL DISKS, LIVE CDs"
23841 #: ../inspector/virt-inspector.pod:318
23843 "Virt-inspector can detect some operating system installers on install disks, "
23844 "live CDs, bootable USB keys and more."
23848 #: ../inspector/virt-inspector.pod:321
23850 "In this case the E<lt>formatE<gt> tag will contain C<installer> and other "
23851 "fields may be present to indicate a live CD, network installer, or one part "
23852 "of a multipart CD. For example:"
23856 #: ../inspector/virt-inspector.pod:325
23859 " <operatingsystems>\n"
23860 " <operatingsystem>\n"
23861 " <root>/dev/sda</root>\n"
23862 " <name>linux</name>\n"
23863 " <arch>i386</arch>\n"
23864 " <distro>ubuntu</distro>\n"
23865 " <product_name>Ubuntu 10.10 "Maverick Meerkat"</product_name>\n"
23866 " <major_version>10</major_version>\n"
23867 " <minor_version>10</minor_version>\n"
23868 " <format>installer</format>\n"
23874 #: ../inspector/virt-inspector.pod:337
23875 msgid "XPATH QUERIES"
23879 #: ../inspector/virt-inspector.pod:339
23881 "Virt-inspector includes built in support for running XPath queries. The "
23882 "reason for including XPath support directly in virt-inspector is simply that "
23883 "there are no good and widely available command line programs that can do "
23884 "XPath queries. The only good one is L<xmlstarlet(1)> and that is not "
23885 "available on Red Hat Enterprise Linux."
23889 #: ../inspector/virt-inspector.pod:346
23891 "To perform an XPath query, use the I<--xpath> option. Note that in this "
23892 "mode, virt-inspector simply reads XML from stdin and outputs the query "
23893 "result on stdout. All other inspection features are disabled in this mode."
23897 #: ../inspector/virt-inspector.pod:353
23900 " $ virt-inspector -d Guest | virt-inspector --xpath '//filesystems'\n"
23902 " <filesystem dev=\"/dev/vg_f13x64/lv_root\">\n"
23903 " <type>ext4</type>\n"
23909 #: ../inspector/virt-inspector.pod:359
23912 " $ virt-inspector -d Guest | \\\n"
23913 " virt-inspector --xpath \"string(//filesystem[@dev='/dev/sda1']/type)\"\n"
23919 #: ../inspector/virt-inspector.pod:363
23922 " $ virt-inspector -d Guest | \\\n"
23923 " virt-inspector --xpath 'string(//icon)' | base64 -i -d | display -\n"
23924 " [displays the guest icon, if there is one]\n"
23929 #: ../inspector/virt-inspector.pod:374
23930 msgid "OLD VERSIONS OF VIRT-INSPECTOR"
23934 #: ../inspector/virt-inspector.pod:376
23936 "Early versions of libguestfs shipped with a different virt-inspector program "
23937 "written in Perl (the current version is written in C). The XML output of "
23938 "the Perl virt-inspector was different and it could also output in other "
23939 "formats like text."
23943 #: ../inspector/virt-inspector.pod:381
23945 "The old virt-inspector is no longer supported or shipped with libguestfs."
23949 #: ../inspector/virt-inspector.pod:384
23951 "To confuse matters further, in Red Hat Enterprise Linux 6 we ship two "
23952 "versions of virt-inspector with different names:"
23956 #: ../inspector/virt-inspector.pod:387
23959 " virt-inspector Old Perl version.\n"
23960 " virt-inspector2 New C version.\n"
23965 #: ../inspector/virt-inspector.pod:397
23967 "L<guestfs(3)>, L<guestfish(1)>, L<http://www.w3.org/TR/xpath/>, L<base64(1)"
23968 ">, L<xmlstarlet(1)>, L<http://libguestfs.org/>."
23972 #: ../inspector/virt-inspector.pod:414
23973 msgid "Matthew Booth L<mbooth@redhat.com>"
23977 #: ../java/examples/guestfs-java.pod:5
23978 msgid "guestfs-java - How to use libguestfs from Java"
23982 #: ../java/examples/guestfs-java.pod:9
23985 " import com.redhat.et.libguestfs.*;\n"
23990 #: ../java/examples/guestfs-java.pod:11
23993 " GuestFS g = new GuestFS ();\n"
23994 " g.add_drive_opts (\"disk.img\", null);\n"
24000 #: ../java/examples/guestfs-java.pod:17
24002 "This manual page documents how to call libguestfs from the Java programming "
24003 "language. This page just documents the differences from the C API and gives "
24004 "some examples. If you are not familiar with using libguestfs, you also need "
24005 "to read L<guestfs(3)>."
24009 #: ../java/examples/guestfs-java.pod:22 ../ocaml/examples/guestfs-ocaml.pod:53
24010 msgid "CLOSING THE HANDLE"
24014 #: ../java/examples/guestfs-java.pod:24
24016 "The handle is closed when it is reaped by the garbage collector. Because "
24017 "libguestfs handles include a lot of state, it is also possible to close (and "
24018 "hence free) them explicitly by calling the C<close> method."
24022 #: ../java/examples/guestfs-java.pod:29 ../ocaml/examples/guestfs-ocaml.pod:60
24023 #: ../python/examples/guestfs-python.pod:21
24024 #: ../ruby/examples/guestfs-ruby.pod:22
24029 #: ../java/examples/guestfs-java.pod:31
24031 "Errors from libguestfs functions are mapped into the C<LibGuestFSException> "
24032 "exception. This has a single parameter which is the error message (a "
24037 #: ../java/examples/guestfs-java.pod:35
24038 msgid "Calling any method on a closed handle raises the same exception."
24042 #: ../java/examples/guestfs-java.pod:47
24044 "L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-erlang(3)>, L<guestfs-ocaml"
24045 "(3)>, L<guestfs-perl(3)>, L<guestfs-python(3)>, L<guestfs-recipes(1)>, "
24046 "L<guestfs-ruby(3)>, L<http://libguestfs.org/>, L<http://caml.inria.fr/>."
24050 #: ../ocaml/examples/guestfs-ocaml.pod:5
24051 msgid "guestfs-ocaml - How to use libguestfs from OCaml"
24055 #: ../ocaml/examples/guestfs-ocaml.pod:9
24056 msgid "Module style:"
24060 #: ../ocaml/examples/guestfs-ocaml.pod:11
24063 " let g = Guestfs.create () in\n"
24064 " Guestfs.add_drive_opts g ~format:\"raw\" ~readonly:true \"disk.img\";\n"
24065 " Guestfs.launch g;\n"
24070 #: ../ocaml/examples/guestfs-ocaml.pod:15
24071 msgid "Object-oriented style:"
24075 #: ../ocaml/examples/guestfs-ocaml.pod:17
24078 " let g = new Guestfs.guestfs () in\n"
24079 " g#add_drive_opts ~format:\"raw\" ~readonly:true \"disk.img\";\n"
24085 #: ../ocaml/examples/guestfs-ocaml.pod:21
24088 " ocamlfind opt prog.ml -package guestfs -linkpkg -o prog\n"
24090 " ocamlopt -I +guestfs mlguestfs.cmxa prog.ml -o prog\n"
24095 #: ../ocaml/examples/guestfs-ocaml.pod:27
24097 "This manual page documents how to call libguestfs from the OCaml programming "
24098 "language. This page just documents the differences from the C API and gives "
24099 "some examples. If you are not familiar with using libguestfs, you also need "
24100 "to read L<guestfs(3)>."
24104 #: ../ocaml/examples/guestfs-ocaml.pod:32
24105 msgid "PROGRAMMING STYLES"
24109 #: ../ocaml/examples/guestfs-ocaml.pod:34
24111 "There are two different programming styles supported by the OCaml bindings. "
24112 "You can use a module style, with each C function mapped to an OCaml function:"
24116 #: ../ocaml/examples/guestfs-ocaml.pod:38
24119 " int guestfs_set_verbose (guestfs_h *g, int flag);\n"
24124 #: ../ocaml/examples/guestfs-ocaml.pod:40
24129 #: ../ocaml/examples/guestfs-ocaml.pod:42
24132 " val Guestfs.set_verbose : Guestfs.t -> bool -> unit\n"
24137 #: ../ocaml/examples/guestfs-ocaml.pod:44
24139 "Alternately you can use an object-oriented style, calling methods on the "
24140 "class C<Guestfs.guestfs>:"
24144 #: ../ocaml/examples/guestfs-ocaml.pod:47
24147 " method set_verbose : bool -> unit\n"
24152 #: ../ocaml/examples/guestfs-ocaml.pod:49
24154 "The object-oriented style is usually briefer, and the minor performance "
24155 "penalty isn't noticable in the general overhead of performing libguestfs "
24160 #: ../ocaml/examples/guestfs-ocaml.pod:55
24162 "The handle is closed when it is reaped by the garbage collector. Because "
24163 "libguestfs handles include a lot of state, it is also possible to close (and "
24164 "hence free) them explicitly by calling C<Guestfs.close> or the C<#close> "
24169 #: ../ocaml/examples/guestfs-ocaml.pod:62
24171 "Errors from libguestfs functions are mapped into the C<Guestfs.Error> "
24172 "exception. This has a single parameter which is the error message (a "
24177 #: ../ocaml/examples/guestfs-ocaml.pod:66
24179 "Calling any function/method on a closed handle raises C<Guestfs."
24180 "Handle_closed>. The single parameter is the name of the function that you "
24185 #: ../ocaml/examples/guestfs-ocaml.pod:80
24187 "L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-erlang(3)>, L<guestfs-java"
24188 "(3)>, L<guestfs-perl(3)>, L<guestfs-python(3)>, L<guestfs-recipes(1)>, "
24189 "L<guestfs-ruby(3)>, L<http://libguestfs.org/>, L<http://caml.inria.fr/>."
24193 #: ../perl/examples/guestfs-perl.pod:5
24194 msgid "guestfs-perl - How to use libguestfs from Perl"
24198 #: ../perl/examples/guestfs-perl.pod:9
24201 " use Sys::Guestfs;\n"
24206 #: ../perl/examples/guestfs-perl.pod:11
24209 " my $h = Sys::Guestfs->new ();\n"
24210 " $h->add_drive_opts ('guest.img', format => 'raw');\n"
24211 " $h->launch ();\n"
24212 " $h->mount_options ('', '/dev/sda1', '/');\n"
24213 " $h->touch ('/hello');\n"
24219 #: ../perl/examples/guestfs-perl.pod:20
24221 "This manual page documents how to call libguestfs from the Perl programming "
24222 "language. This page just documents the differences from the C API and gives "
24223 "some examples. If you are not familiar with using libguestfs, you also need "
24224 "to read L<guestfs(3)>. To read the full Perl API, see L<Sys::Guestfs(3)>."
24228 #: ../perl/examples/guestfs-perl.pod:26
24233 #: ../perl/examples/guestfs-perl.pod:28
24235 "Errors from libguestfs functions turn into calls to C<croak> (see L<Carp(3)"
24240 #: ../perl/examples/guestfs-perl.pod:41
24242 "L<Sys::Guestfs(3)>, L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-erlang"
24243 "(3)>, L<guestfs-java(3)>, L<guestfs-ocaml(3)>, L<guestfs-python(3)>, "
24244 "L<guestfs-recipes(1)>, L<guestfs-ruby(3)>, L<http://libguestfs.org/>."
24248 #: ../python/examples/guestfs-python.pod:5
24249 msgid "guestfs-python - How to use libguestfs from Python"
24253 #: ../python/examples/guestfs-python.pod:9
24256 " import guestfs\n"
24257 " g = guestfs.GuestFS ()\n"
24258 " g.add_drive_opts (\"disk.img\", format=\"raw\", readonly=1)\n"
24264 #: ../python/examples/guestfs-python.pod:16
24266 "This manual page documents how to call libguestfs from the Python "
24267 "programming language. This page just documents the differences from the C "
24268 "API and gives some examples. If you are not familiar with using libguestfs, "
24269 "you also need to read L<guestfs(3)>."
24273 #: ../python/examples/guestfs-python.pod:23
24275 "Errors from libguestfs functions are mapped into C<RuntimeException> with a "
24276 "single string argument which is the error message."
24280 #: ../python/examples/guestfs-python.pod:26
24281 msgid "MORE DOCUMENTATION"
24285 #: ../python/examples/guestfs-python.pod:28
24290 #: ../python/examples/guestfs-python.pod:30
24294 " >>> import guestfs\n"
24295 " >>> help (guestfs)\n"
24300 #: ../python/examples/guestfs-python.pod:44
24302 "L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-erlang(3)>, L<guestfs-java"
24303 "(3)>, L<guestfs-ocaml(3)>, L<guestfs-perl(3)>, L<guestfs-recipes(1)>, "
24304 "L<guestfs-ruby(3)>, L<http://libguestfs.org/>."
24308 #: ../rescue/virt-rescue.pod:5
24309 msgid "virt-rescue - Run a rescue shell on a virtual machine"
24313 #: ../rescue/virt-rescue.pod:9
24316 " virt-rescue [--options] -d domname\n"
24321 #: ../rescue/virt-rescue.pod:11
24324 " virt-rescue [--options] -a disk.img [-a disk.img ...]\n"
24329 #: ../rescue/virt-rescue.pod:13
24332 #| " virt-filesystems --format=raw -a disk.img\n"
24335 " virt-rescue --suggest (-d domname | -a disk.img ...)\n"
24338 " virt-filesystems --format=raw -a диск.img\n"
24342 #: ../rescue/virt-rescue.pod:17
24345 " virt-rescue [--options] domname\n"
24350 #: ../rescue/virt-rescue.pod:19
24353 " virt-rescue [--options] disk.img [disk.img ...]\n"
24358 #: ../rescue/virt-rescue.pod:23
24360 "You must I<not> use C<virt-rescue> on live virtual machines. Doing so will "
24361 "probably result in disk corruption in the VM. C<virt-rescue> tries to stop "
24362 "you from doing this, but doesn't catch all cases."
24366 #: ../rescue/virt-rescue.pod:27
24368 "However if you use the I<--ro> (read only) option, then you can attach a "
24369 "shell to a live virtual machine. The results might be strange or "
24370 "inconsistent at times but you won't get disk corruption."
24374 #: ../rescue/virt-rescue.pod:33
24376 "virt-rescue is like a Rescue CD, but for virtual machines, and without the "
24377 "need for a CD. virt-rescue gives you a rescue shell and some simple "
24378 "recovery tools which you can use to examine or rescue a virtual machine or "
24383 #: ../rescue/virt-rescue.pod:38
24385 "You can run virt-rescue on any virtual machine known to libvirt, or directly "
24386 "on disk image(s):"
24390 #: ../rescue/virt-rescue.pod:41
24393 " virt-rescue -d GuestName\n"
24398 #: ../rescue/virt-rescue.pod:43
24401 " virt-rescue --ro -a /path/to/disk.img\n"
24406 #: ../rescue/virt-rescue.pod:45
24409 " virt-rescue -a /dev/sdc\n"
24414 #: ../rescue/virt-rescue.pod:47
24415 msgid "For live VMs you I<must> use the --ro option."
24419 #: ../rescue/virt-rescue.pod:49
24421 "When you run virt-rescue on a virtual machine or disk image, you are placed "
24422 "in an interactive bash shell where you can use many ordinary Linux "
24423 "commands. What you see in C</> (C</bin>, C</lib> etc) is the rescue "
24424 "appliance. You must mount the virtual machine's filesystems by hand. There "
24425 "is an empty directory called C</sysroot> where you can mount filesystems."
24429 #: ../rescue/virt-rescue.pod:56
24431 "You can get virt-rescue to suggest mount commands for you by using the I<--"
24432 "suggest> option (in another terminal):"
24436 #: ../rescue/virt-rescue.pod:59
24439 " $ virt-rescue --suggest -d Fedora15\n"
24440 " Inspecting the virtual machine or disk image ...\n"
24445 #: ../rescue/virt-rescue.pod:62
24448 " This disk contains one or more operating systems. You can use these\n"
24449 " mount commands in virt-rescue (at the ><rescue> prompt) to mount the\n"
24455 #: ../rescue/virt-rescue.pod:66
24458 " # /dev/vg_f15x32/lv_root is the root of a linux operating system\n"
24459 " # type: linux, distro: fedora, version: 15.0\n"
24460 " # Fedora release 15 (Lovelock)\n"
24465 #: ../rescue/virt-rescue.pod:70
24468 " mount /dev/vg_f15x32/lv_root /sysroot/\n"
24469 " mount /dev/vda1 /sysroot/boot\n"
24470 " mount --bind /dev /sysroot/dev\n"
24471 " mount --bind /dev/pts /sysroot/dev/pts\n"
24472 " mount --bind /proc /sysroot/proc\n"
24473 " mount --bind /sys /sysroot/sys\n"
24478 #: ../rescue/virt-rescue.pod:77
24480 "Another way is to list the logical volumes (with L<lvs(8)>) and partitions "
24481 "(with L<parted(8)>) and mount them by hand:"
24485 #: ../rescue/virt-rescue.pod:80
24489 " LV VG Attr LSize Origin Snap% Move Log Copy% Convert\n"
24490 " lv_root vg_f15x32 -wi-a- 8.83G\n"
24491 " lv_swap vg_f15x32 -wi-a- 992.00M\n"
24492 " ><rescue> mount /dev/vg_f15x32/lv_root /sysroot\n"
24493 " ><rescue> mount /dev/vda1 /sysroot/boot\n"
24494 " ><rescue> ls /sysroot\n"
24499 #: ../rescue/virt-rescue.pod:88
24501 "Another command to list available filesystems is L<virt-filesystems(1)>."
24505 #: ../rescue/virt-rescue.pod:91
24507 "To run commands in a Linux guest (for example, grub), you should chroot into "
24508 "the /sysroot directory first:"
24512 #: ../rescue/virt-rescue.pod:94
24515 " ><rescue> chroot /sysroot\n"
24520 #: ../rescue/virt-rescue.pod:98
24522 "Virt-rescue can be used on I<any> disk image file or device, not just a "
24523 "virtual machine. For example you can use it on a blank file if you want to "
24524 "partition that file (although we would recommend using L<guestfish(1)> "
24525 "instead as it is more suitable for this purpose). You can even use virt-"
24526 "rescue on things like SD cards."
24530 #: ../rescue/virt-rescue.pod:104
24532 "Virt-rescue does not require root. You only need to run it as root if you "
24533 "need root to open the disk image."
24537 #: ../rescue/virt-rescue.pod:107
24539 "This tool is just designed for quick interactive hacking on a virtual "
24540 "machine. For more structured access to a virtual machine disk image, you "
24541 "should use L<guestfs(3)>. To get a structured shell that you can use to "
24542 "make scripted changes to guests, use L<guestfish(1)>."
24546 #: ../rescue/virt-rescue.pod:131
24547 msgid "B<--append kernelopts>"
24548 msgstr "B<--append параметри_ядра>"
24551 #: ../rescue/virt-rescue.pod:133
24552 msgid "Pass additional options to the rescue kernel."
24556 #: ../rescue/virt-rescue.pod:163
24559 " virt-rescue --format=raw -a disk.img\n"
24564 #: ../rescue/virt-rescue.pod:167
24567 " virt-rescue --format=raw -a disk.img --format -a another.img\n"
24572 #: ../rescue/virt-rescue.pod:176
24577 #: ../rescue/virt-rescue.pod:178
24578 msgid "B<--memsize MB>"
24579 msgstr "B<--memsize МБ>"
24582 #: ../rescue/virt-rescue.pod:180
24584 "Change the amount of memory allocated to the rescue system. The default is "
24585 "set by libguestfs and is small but adequate for running system tools. The "
24586 "occasional program might need more memory. The parameter is specified in "
24591 #: ../rescue/virt-rescue.pod:185
24592 msgid "B<--network>"
24593 msgstr "B<--network>"
24596 #: ../rescue/virt-rescue.pod:187
24597 msgid "Enable QEMU user networking in the guest. See L</NETWORK>."
24601 #: ../rescue/virt-rescue.pod:193
24602 msgid "Open the image read-only."
24606 #: ../rescue/virt-rescue.pod:203
24608 "Enable SELinux in the rescue appliance. You should read L<guestfs(3)/"
24609 "SELINUX> before using this option."
24613 #: ../rescue/virt-rescue.pod:206
24618 #: ../rescue/virt-rescue.pod:208
24619 msgid "Enable N E<ge> 2 virtual CPUs in the rescue appliance."
24623 #: ../rescue/virt-rescue.pod:210
24625 #| msgid "B<--quiet>"
24626 msgid "B<--suggest>"
24627 msgstr "B<--quiet>"
24630 #: ../rescue/virt-rescue.pod:212
24632 "Inspect the disk image and suggest what mount commands should be used to "
24633 "mount the disks. You should use the I<--suggest> option in a second "
24634 "terminal, then paste the commands into another virt-rescue."
24638 #: ../rescue/virt-rescue.pod:216
24640 "This option implies I<--ro> and is safe to use even if the guest is up or if "
24641 "another virt-rescue is running."
24645 #: ../rescue/virt-rescue.pod:235
24647 "This changes the I<-a> and I<-d> options so that disks are added and mounts "
24648 "are done read-write."
24652 #: ../rescue/virt-rescue.pod:248
24653 msgid "Previous versions of virt-rescue allowed you to write either:"
24657 #: ../rescue/virt-rescue.pod:250
24660 " virt-rescue disk.img [disk.img ...]\n"
24665 #: ../rescue/virt-rescue.pod:254
24668 " virt-rescue guestname\n"
24673 #: ../rescue/virt-rescue.pod:262
24678 #: ../rescue/virt-rescue.pod:264
24680 "Adding the I<--network> option enables QEMU user networking in the rescue "
24681 "appliance. There are some differences between user networking and ordinary "
24686 #: ../rescue/virt-rescue.pod:270
24687 msgid "ping does not work"
24691 #: ../rescue/virt-rescue.pod:272
24693 "Because the ICMP ECHO_REQUEST protocol generally requires root in order to "
24694 "send the ping packets, and because virt-rescue must be able to run as non-"
24695 "root, QEMU user networking is not able to emulate the L<ping(8)> command. "
24696 "The ping command will appear to resolve addresses but will not be able to "
24697 "send or receive any packets. This does not mean that the network is not "
24702 #: ../rescue/virt-rescue.pod:279
24703 msgid "cannot receive connections"
24707 #: ../rescue/virt-rescue.pod:281
24708 msgid "QEMU user networking cannot receive incoming connections."
24712 #: ../rescue/virt-rescue.pod:283
24713 msgid "making TCP connections"
24717 #: ../rescue/virt-rescue.pod:285
24719 "The virt-rescue appliance needs to be small and so does not include many "
24720 "network tools. In particular there is no L<telnet(1)> command. You can "
24721 "make TCP connections from the shell using the magical C</dev/tcp/"
24722 "E<lt>hostnameE<gt>/E<lt>portE<gt>> syntax:"
24726 #: ../rescue/virt-rescue.pod:290
24729 " exec 3<>/dev/tcp/redhat.com/80\n"
24730 " echo \"GET /\" >&3\n"
24736 #: ../rescue/virt-rescue.pod:294
24737 msgid "See L<bash(1)> for more details."
24741 #: ../rescue/virt-rescue.pod:300
24743 "Several environment variables affect virt-rescue. See L<guestfs(3)/"
24744 "ENVIRONMENT VARIABLES> for the complete list."
24748 #: ../rescue/virt-rescue.pod:327
24751 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, "
24752 #| "L<virt-tar-out(1)>, L<http://libguestfs.org/>."
24754 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-"
24755 "filesystems(1)>, L<http://libguestfs.org/>."
24757 "L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, L<virt-"
24758 "tar-out(1)>, L<http://libguestfs.org/>."
24761 #: ../resize/virt-resize.pod:5
24762 msgid "virt-resize - Resize a virtual machine disk"
24766 #: ../resize/virt-resize.pod:9
24769 " virt-resize [--resize /dev/sdaN=[+/-]<size>[%]]\n"
24770 " [--expand /dev/sdaN] [--shrink /dev/sdaN]\n"
24771 " [--ignore /dev/sdaN] [--delete /dev/sdaN] [...] indisk outdisk\n"
24776 #: ../resize/virt-resize.pod:15
24778 "Virt-resize is a tool which can resize a virtual machine disk, making it "
24779 "larger or smaller overall, and resizing or deleting any partitions contained "
24784 #: ../resize/virt-resize.pod:19
24786 "Virt-resize B<cannot> resize disk images in-place. Virt-resize B<should "
24787 "not> be used on live virtual machines - for consistent results, shut the "
24788 "virtual machine down before resizing it."
24792 #: ../resize/virt-resize.pod:23
24794 "If you are not familiar with the associated tools: L<virt-filesystems(1)> "
24795 "and L<virt-df(1)>, we recommend you go and read those manual pages first."
24799 #: ../resize/virt-resize.pod:31 ../resize/virt-resize.pod:597
24800 #: ../sparsify/virt-sparsify.pod:203 ../src/guestfs.pod:484
24801 #: ../src/guestfs.pod:1302 ../src/guestfs.pod:1441 ../src/guestfs.pod:2690
24806 #: ../resize/virt-resize.pod:33
24808 "Copy C<olddisk> to C<newdisk>, extending one of the guest's partitions to "
24809 "fill the extra 5GB of space."
24813 #: ../resize/virt-resize.pod:36
24816 " virt-filesystems --long -h --all -a olddisk\n"
24821 #: ../resize/virt-resize.pod:38
24824 " truncate -r olddisk newdisk\n"
24825 " truncate -s +5G newdisk\n"
24830 #: ../resize/virt-resize.pod:41
24833 " # Note \"/dev/sda2\" is a partition inside the \"olddisk\" file.\n"
24834 " virt-resize --expand /dev/sda2 olddisk newdisk\n"
24839 #: ../resize/virt-resize.pod:44 ../resize/virt-resize.pod:604
24840 #: ../sparsify/virt-sparsify.pod:210 ../src/guestfs.pod:490
24841 #: ../src/guestfs.pod:1306 ../src/guestfs.pod:1445 ../src/guestfs.pod:2715
24846 #: ../resize/virt-resize.pod:46
24848 "As above, but make the /boot partition 200MB bigger, while giving the "
24849 "remaining space to /dev/sda2:"
24853 #: ../resize/virt-resize.pod:49
24856 " virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 \\\n"
24857 " olddisk newdisk\n"
24862 #: ../resize/virt-resize.pod:52 ../resize/virt-resize.pod:610
24863 #: ../sparsify/virt-sparsify.pod:216 ../src/guestfs.pod:501
24864 #: ../src/guestfs.pod:1451
24869 #: ../resize/virt-resize.pod:54
24871 "As in the first example, but expand a logical volume as the final step. "
24872 "This is what you would typically use for Linux guests that use LVM:"
24876 #: ../resize/virt-resize.pod:58
24879 " virt-resize --expand /dev/sda2 --LV-expand /dev/vg_guest/lv_root \\\n"
24880 " olddisk newdisk\n"
24885 #: ../resize/virt-resize.pod:61
24890 #: ../resize/virt-resize.pod:63
24892 "As in the first example, but the output format will be qcow2 instead of a "
24897 #: ../resize/virt-resize.pod:66
24900 " qemu-img create -f qcow2 newdisk.qcow2 15G\n"
24901 " virt-resize --expand /dev/sda2 olddisk newdisk.qcow2\n"
24906 #: ../resize/virt-resize.pod:71
24907 msgid "DETAILED USAGE"
24908 msgstr "ДОКЛАДНІШЕ ЩОДО ВИКОРИСТАННЯ"
24911 #: ../resize/virt-resize.pod:73
24912 msgid "EXPANDING A VIRTUAL MACHINE DISK"
24913 msgstr "РОЗШИРЕННЯ ДИСКА ВІРТУАЛЬНОЇ МАШИНИ"
24916 #: ../resize/virt-resize.pod:77
24917 msgid "1. Shut down the virtual machine"
24921 #: ../resize/virt-resize.pod:79
24922 msgid "2. Locate input disk image"
24926 #: ../resize/virt-resize.pod:81
24928 "Locate the input disk image (ie. the file or device on the host containing "
24929 "the guest's disk). If the guest is managed by libvirt, you can use C<virsh "
24930 "dumpxml> like this to find the disk image name:"
24934 #: ../resize/virt-resize.pod:85
24937 " # virsh dumpxml guestname | xpath /domain/devices/disk/source\n"
24938 " Found 1 nodes:\n"
24940 " <source dev=\"/dev/vg/lv_guest\" />\n"
24945 #: ../resize/virt-resize.pod:90
24946 msgid "3. Look at current sizing"
24950 #: ../resize/virt-resize.pod:92
24951 msgid "Use L<virt-filesystems(1)> to display the current partitions and sizes:"
24955 #: ../resize/virt-resize.pod:95
24958 " # virt-filesystems --long --parts --blkdevs -h -a /dev/vg/lv_guest\n"
24959 " Name Type Size Parent\n"
24960 " /dev/sda1 partition 101M /dev/sda\n"
24961 " /dev/sda2 partition 7.9G /dev/sda\n"
24962 " /dev/sda device 8.0G -\n"
24967 #: ../resize/virt-resize.pod:101
24969 "(This example is a virtual machine with an 8 GB disk which we would like to "
24970 "expand up to 10 GB)."
24974 #: ../resize/virt-resize.pod:104
24975 msgid "4. Create output disk"
24979 #: ../resize/virt-resize.pod:106
24981 "Virt-resize cannot do in-place disk modifications. You have to have space "
24982 "to store the resized output disk."
24986 #: ../resize/virt-resize.pod:109
24988 "To store the resized disk image in a file, create a file of a suitable size:"
24992 #: ../resize/virt-resize.pod:112
24995 " # rm -f outdisk\n"
24996 " # truncate -s 10G outdisk\n"
25001 #: ../resize/virt-resize.pod:115
25002 msgid "Or use L<lvcreate(1)> to create a logical volume:"
25006 #: ../resize/virt-resize.pod:117
25009 " # lvcreate -L 10G -n lv_name vg_name\n"
25014 #: ../resize/virt-resize.pod:119
25015 msgid "Or use L<virsh(1)> vol-create-as to create a libvirt storage volume:"
25019 #: ../resize/virt-resize.pod:121
25022 " # virsh pool-list\n"
25023 " # virsh vol-create-as poolname newvol 10G\n"
25028 #: ../resize/virt-resize.pod:124
25030 msgstr "5. Зміна розміру"
25033 #: ../resize/virt-resize.pod:126
25035 "virt-resize takes two mandatory parameters, the input disk (eg. device or "
25036 "file) and the output disk. The output disk is the one created in the "
25041 #: ../resize/virt-resize.pod:130
25044 " # virt-resize indisk outdisk\n"
25049 #: ../resize/virt-resize.pod:132
25051 "This command just copies disk image C<indisk> to disk image C<outdisk> "
25052 "I<without> resizing or changing any existing partitions. If C<outdisk> is "
25053 "larger, then an extra, empty partition is created at the end of the disk "
25054 "covering the extra space. If C<outdisk> is smaller, then it will give an "
25059 #: ../resize/virt-resize.pod:138
25061 "More realistically you'd want to expand existing partitions in the disk "
25062 "image by passing extra options (for the full list see the L</OPTIONS> "
25067 #: ../resize/virt-resize.pod:142
25069 "L</--expand> is the most useful option. It expands the named partition "
25070 "within the disk to fill any extra space:"
25074 #: ../resize/virt-resize.pod:145
25077 " # virt-resize --expand /dev/sda2 indisk outdisk\n"
25082 #: ../resize/virt-resize.pod:147
25084 "(In this case, an extra partition is I<not> created at the end of the disk, "
25085 "because there will be no unused space)."
25089 #: ../resize/virt-resize.pod:150
25091 "L</--resize> is the other commonly used option. The following would "
25092 "increase the size of /dev/sda1 by 200M, and expand /dev/sda2 to fill the "
25093 "rest of the available space:"
25097 #: ../resize/virt-resize.pod:154
25100 " # virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 \\\n"
25101 " indisk outdisk\n"
25106 #: ../resize/virt-resize.pod:157
25108 "If the expanded partition in the image contains a filesystem or LVM PV, then "
25109 "if virt-resize knows how, it will resize the contents, the equivalent of "
25110 "calling a command such as L<pvresize(8)>, L<resize2fs(8)>, L<ntfsresize(8)> "
25111 "or L<btrfs(8)>. However virt-resize does not know how to resize some "
25112 "filesystems, so you would have to online resize them after booting the guest."
25116 #: ../resize/virt-resize.pod:164
25117 msgid "Other options are covered below."
25121 #: ../resize/virt-resize.pod:166
25123 msgstr "6. Перевірка"
25126 #: ../resize/virt-resize.pod:168
25127 msgid "Thoroughly test the new disk image I<before> discarding the old one."
25131 #: ../resize/virt-resize.pod:170
25132 msgid "If you are using libvirt, edit the XML to point at the new disk:"
25136 #: ../resize/virt-resize.pod:172
25139 " # virsh edit guestname\n"
25144 #: ../resize/virt-resize.pod:174
25146 "Change E<lt>source ...E<gt>, see L<http://libvirt.org/formatdomain."
25147 "html#elementsDisks>"
25151 #: ../resize/virt-resize.pod:177
25152 msgid "Then start up the domain with the new, resized disk:"
25156 #: ../resize/virt-resize.pod:179
25159 " # virsh start guestname\n"
25164 #: ../resize/virt-resize.pod:181
25166 "and check that it still works. See also the L</NOTES> section below for "
25167 "additional information."
25171 #: ../resize/virt-resize.pod:184
25172 msgid "7. Resize LVs etc inside the guest"
25176 #: ../resize/virt-resize.pod:186
25177 msgid "(This can also be done offline using L<guestfish(1)>)"
25181 #: ../resize/virt-resize.pod:188
25183 "Once the guest has booted you should see the new space available, at least "
25184 "for filesystems that virt-resize knows how to resize, and for PVs. The user "
25185 "may need to resize LVs inside PVs, and also resize filesystem types that "
25186 "virt-resize does not know how to expand."
25190 #: ../resize/virt-resize.pod:195
25191 msgid "SHRINKING A VIRTUAL MACHINE DISK"
25195 #: ../resize/virt-resize.pod:197
25197 "Shrinking is somewhat more complex than expanding, and only an overview is "
25202 #: ../resize/virt-resize.pod:200
25204 "Firstly virt-resize will not attempt to shrink any partition content (PVs, "
25205 "filesystems). The user has to shrink content before passing the disk image "
25206 "to virt-resize, and virt-resize will check that the content has been shrunk "
25211 #: ../resize/virt-resize.pod:205
25212 msgid "(Shrinking can also be done offline using L<guestfish(1)>)"
25216 #: ../resize/virt-resize.pod:207
25218 "After shrinking PVs and filesystems, shut down the guest, and proceed with "
25219 "steps 3 and 4 above to allocate a new disk image."
25223 #: ../resize/virt-resize.pod:210
25225 "Then run virt-resize with any of the I<--shrink> and/or I<--resize> options."
25229 #: ../resize/virt-resize.pod:213
25230 msgid "IGNORING OR DELETING PARTITIONS"
25234 #: ../resize/virt-resize.pod:215
25236 "virt-resize also gives a convenient way to ignore or delete partitions when "
25237 "copying from the input disk to the output disk. Ignoring a partition speeds "
25238 "up the copy where you don't care about the existing contents of a "
25239 "partition. Deleting a partition removes it completely, but note that it "
25240 "also renumbers any partitions after the one which is deleted, which can "
25241 "leave some guests unbootable."
25245 #: ../resize/virt-resize.pod:222
25246 msgid "QCOW2 AND NON-SPARSE RAW FORMATS"
25250 #: ../resize/virt-resize.pod:224
25252 "If the input disk is in qcow2 format, then you may prefer that the output is "
25253 "in qcow2 format as well. Alternately, virt-resize can convert the format on "
25254 "the fly. The output format is simply determined by the format of the empty "
25255 "output container that you provide. Thus to create qcow2 output, use:"
25259 #: ../resize/virt-resize.pod:230
25262 " qemu-img create [-c] -f qcow2 outdisk [size]\n"
25267 #: ../resize/virt-resize.pod:232
25268 msgid "instead of the truncate command (use I<-c> for a compressed disk)."
25272 #: ../resize/virt-resize.pod:234
25273 msgid "Similarly, to get non-sparse raw output use:"
25277 #: ../resize/virt-resize.pod:236
25280 " fallocate -l size outdisk\n"
25285 #: ../resize/virt-resize.pod:238
25287 "(on older systems that don't have the L<fallocate(1)> command use C<dd if=/"
25288 "dev/zero of=outdisk bs=1M count=..>)"
25292 #: ../resize/virt-resize.pod:241
25293 msgid "LOGICAL PARTITIONS"
25297 #: ../resize/virt-resize.pod:243
25299 "Logical partitions (a.k.a. C</dev/sda5+> on disks using DOS partition "
25300 "tables) cannot be resized."
25304 #: ../resize/virt-resize.pod:246
25306 "To understand what is going on, firstly one of the four partitions C</dev/"
25307 "sda1-4> will have MBR partition type C<05> or C<0f>. This is called the "
25308 "B<extended partition>. Use L<virt-filesystems(1)> to see the MBR partition "
25313 #: ../resize/virt-resize.pod:251
25314 msgid "Logical partitions live inside the extended partition."
25318 #: ../resize/virt-resize.pod:253
25320 "The extended partition can be expanded, but not shrunk (unless you force it, "
25321 "which is not advisable). When the extended partition is copied across, all "
25322 "the logical partitions contained inside are copied over implicitly. Virt-"
25323 "resize does not look inside the extended partition, so it copies the logical "
25324 "partitions blindly."
25328 #: ../resize/virt-resize.pod:259
25330 "You cannot specify a logical partition (C</dev/sda5+>) at all on the command "
25331 "line. Doing so will give an error."
25335 #: ../resize/virt-resize.pod:268 ../sparsify/virt-sparsify.pod:105
25336 msgid "Display help."
25340 #: ../resize/virt-resize.pod:270
25341 msgid "B<--align-first auto>"
25345 #: ../resize/virt-resize.pod:272
25346 msgid "B<--align-first never>"
25350 #: ../resize/virt-resize.pod:274
25351 msgid "B<--align-first always>"
25355 #: ../resize/virt-resize.pod:276
25357 "Align the first partition for improved performance (see also the I<--"
25358 "alignment> option)."
25362 #: ../resize/virt-resize.pod:279
25364 "The default is I<--align-first auto> which only aligns the first partition "
25365 "if it is safe to do so. That is, only when we know how to fix the "
25366 "bootloader automatically, and at the moment that can only be done for "
25371 #: ../resize/virt-resize.pod:284
25373 "I<--align-first never> means we never move the first partition. This is the "
25374 "safest option. Try this if the guest does not boot after resizing."
25378 #: ../resize/virt-resize.pod:288
25380 "I<--align-first always> means we always align the first partition (if it "
25381 "needs to be aligned). For some guests this will break the bootloader, "
25382 "making the guest unbootable."
25386 #: ../resize/virt-resize.pod:292
25387 msgid "B<--alignment N>"
25391 #: ../resize/virt-resize.pod:294
25393 "Set the alignment of partitions to C<N> sectors. The default in virt-resize "
25394 "E<lt> 1.13.19 was 64 sectors, and after that is 128 sectors."
25398 #: ../resize/virt-resize.pod:298
25400 "Assuming 512 byte sector size inside the guest, here are some suitable "
25405 #: ../resize/virt-resize.pod:303
25406 msgid "I<--alignment 1> (512 bytes)"
25410 #: ../resize/virt-resize.pod:305
25412 "The partitions would be packed together as closely as possible, but would be "
25413 "completely unaligned. In some cases this can cause very poor performance. "
25414 "See L<virt-alignment-scan(1)> for further details."
25418 #: ../resize/virt-resize.pod:309
25419 msgid "I<--alignment 8> (4K)"
25423 #: ../resize/virt-resize.pod:311
25425 "This would be the minimum acceptable alignment for reasonable performance on "
25430 #: ../resize/virt-resize.pod:314
25431 msgid "I<--alignment 128> (64K)"
25435 #: ../resize/virt-resize.pod:316
25437 "This alignment provides good performance when the host is using high end "
25442 #: ../resize/virt-resize.pod:319
25443 msgid "I<--alignment 2048> (1M)"
25447 #: ../resize/virt-resize.pod:321
25449 "This is the standard alignment used by all newly installed guests since "
25454 #: ../resize/virt-resize.pod:326
25459 #: ../resize/virt-resize.pod:328 ../tools/virt-make-fs.pl:177
25460 #: ../tools/virt-win-reg.pl:120
25462 msgstr "B<--debug>"
25465 #: ../resize/virt-resize.pod:330 ../tools/virt-win-reg.pl:122
25466 msgid "Enable debugging messages."
25470 #: ../resize/virt-resize.pod:332
25471 msgid "B<--delete part>"
25472 msgstr "B<--delete розділ>"
25475 #: ../resize/virt-resize.pod:334
25477 "Delete the named partition. It would be more accurate to describe this as "
25478 "\"don't copy it over\", since virt-resize doesn't do in-place changes and "
25479 "the original disk image is left intact."
25483 #: ../resize/virt-resize.pod:338
25485 "Note that when you delete a partition, then anything contained in the "
25486 "partition is also deleted. Furthermore, this causes any partitions that "
25487 "come after to be I<renumbered>, which can easily make your guest unbootable."
25491 #: ../resize/virt-resize.pod:343 ../resize/virt-resize.pod:404
25492 #: ../resize/virt-resize.pod:531 ../sparsify/virt-sparsify.pod:145
25493 msgid "You can give this option multiple times."
25497 #: ../resize/virt-resize.pod:345
25498 msgid "B<--expand part>"
25499 msgstr "B<--expand розділ>"
25502 #: ../resize/virt-resize.pod:347
25504 "Expand the named partition so it uses up all extra space (space left over "
25505 "after any other resize changes that you request have been done)."
25509 #: ../resize/virt-resize.pod:350
25511 "If virt-resize knows how, it will expand the direct content of the "
25512 "partition. For example, if the partition is an LVM PV, it will expand the "
25513 "PV to fit (like calling L<pvresize(8)>). Virt-resize leaves any other "
25514 "content it doesn't know about alone."
25518 #: ../resize/virt-resize.pod:355
25519 msgid "Currently virt-resize can resize:"
25523 #: ../resize/virt-resize.pod:361
25524 msgid "ext2, ext3 and ext4 filesystems."
25528 #: ../resize/virt-resize.pod:365
25529 msgid "NTFS filesystems, if libguestfs was compiled with support for NTFS."
25533 #: ../resize/virt-resize.pod:367
25535 "The filesystem must have been shut down consistently last time it was used. "
25536 "Additionally, L<ntfsresize(8)> marks the resized filesystem as requiring a "
25537 "consistency check, so at the first boot after resizing Windows will check "
25542 #: ../resize/virt-resize.pod:374
25544 "LVM PVs (physical volumes). virt-resize does not usually resize anything "
25545 "inside the PV, but see the I<--LV-expand> option. The user could also "
25546 "resize LVs as desired after boot."
25550 #: ../resize/virt-resize.pod:380
25551 msgid "Btrfs filesystems, if libguestfs was compiled with support for btrfs."
25555 #: ../resize/virt-resize.pod:384 ../resize/virt-resize.pod:559
25556 msgid "Note that you cannot use I<--expand> and I<--shrink> together."
25560 #: ../resize/virt-resize.pod:386 ../sparsify/virt-sparsify.pod:125
25561 #: ../tools/virt-list-filesystems.pl:91 ../tools/virt-list-partitions.pl:92
25562 #: ../tools/virt-tar.pl:141 ../tools/virt-win-reg.pl:142
25563 msgid "B<--format> raw"
25564 msgstr "B<--format> raw"
25567 #: ../resize/virt-resize.pod:388 ../sparsify/virt-sparsify.pod:129
25569 "Specify the format of the input disk image. If this flag is not given then "
25570 "it is auto-detected from the image itself."
25574 #: ../resize/virt-resize.pod:394
25576 "Note that this option I<does not> affect the output format. See L</QCOW2 "
25577 "AND NON-SPARSE RAW FORMATS>."
25581 #: ../resize/virt-resize.pod:397
25582 msgid "B<--ignore part>"
25583 msgstr "B<--ignore розділ>"
25586 #: ../resize/virt-resize.pod:399
25588 "Ignore the named partition. Effectively this means the partition is "
25589 "allocated on the destination disk, but the content is not copied across from "
25590 "the source disk. The content of the partition will be blank (all zero "
25595 #: ../resize/virt-resize.pod:406
25596 msgid "B<--LV-expand logvol>"
25597 msgstr "B<--LV-expand логічний_том>"
25600 #: ../resize/virt-resize.pod:408
25602 "This takes the logical volume and, as a final step, expands it to fill all "
25603 "the space available in its volume group. A typical usage, assuming a Linux "
25604 "guest with a single PV C</dev/sda2> and a root device called C</dev/vg_guest/"
25605 "lv_root> would be:"
25609 #: ../resize/virt-resize.pod:413
25612 " virt-resize indisk outdisk \\\n"
25613 " --expand /dev/sda2 --LV-expand /dev/vg_guest/lv_root\n"
25618 #: ../resize/virt-resize.pod:416
25620 "This would first expand the partition (and PV), and then expand the root "
25621 "device to fill the extra space in the PV."
25625 #: ../resize/virt-resize.pod:419
25627 "The contents of the LV are also resized if virt-resize knows how to do "
25628 "that. You can stop virt-resize from trying to expand the content by using "
25629 "the option I<--no-expand-content>."
25633 #: ../resize/virt-resize.pod:423
25634 msgid "Use L<virt-filesystems(1)> to list the filesystems in the guest."
25638 #: ../resize/virt-resize.pod:425
25640 "You can give this option multiple times, I<but> it doesn't make sense to do "
25641 "this unless the logical volumes you specify are all in different volume "
25646 #: ../resize/virt-resize.pod:429 ../sparsify/virt-sparsify.pod:147
25647 msgid "B<--machine-readable>"
25651 #: ../resize/virt-resize.pod:431 ../sparsify/virt-sparsify.pod:149
25653 "This option is used to make the output more machine friendly when being "
25654 "parsed by other programs. See L</MACHINE READABLE OUTPUT> below."
25658 #: ../resize/virt-resize.pod:437
25659 msgid "B<--dryrun>"
25660 msgstr "B<--dryrun>"
25663 #: ../resize/virt-resize.pod:439
25664 msgid "Print a summary of what would be done, but don't do anything."
25668 #: ../resize/virt-resize.pod:441
25669 msgid "B<--no-copy-boot-loader>"
25670 msgstr "B<--no-copy-boot-loader>"
25673 #: ../resize/virt-resize.pod:443
25675 "By default, virt-resize copies over some sectors at the start of the disk "
25676 "(up to the beginning of the first partition). Commonly these sectors "
25677 "contain the Master Boot Record (MBR) and the boot loader, and are required "
25678 "in order for the guest to boot correctly."
25682 #: ../resize/virt-resize.pod:448
25684 "If you specify this flag, then this initial copy is not done. You may need "
25685 "to reinstall the boot loader in this case."
25689 #: ../resize/virt-resize.pod:451
25690 msgid "B<--no-extra-partition>"
25691 msgstr "B<--no-extra-partition>"
25694 #: ../resize/virt-resize.pod:453
25696 "By default, virt-resize creates an extra partition if there is any extra, "
25697 "unused space after all resizing has happened. Use this option to prevent "
25698 "the extra partition from being created. If you do this then the extra space "
25699 "will be inaccessible until you run fdisk, parted, or some other partitioning "
25700 "tool in the guest."
25704 #: ../resize/virt-resize.pod:459
25706 "Note that if the surplus space is smaller than 10 MB, no extra partition "
25711 #: ../resize/virt-resize.pod:462
25712 msgid "B<--no-expand-content>"
25713 msgstr "B<--no-expand-content>"
25716 #: ../resize/virt-resize.pod:464
25718 "By default, virt-resize will try to expand the direct contents of "
25719 "partitions, if it knows how (see I<--expand> option above)."
25723 #: ../resize/virt-resize.pod:467
25725 "If you give the I<--no-expand-content> option then virt-resize will not "
25730 #: ../resize/virt-resize.pod:470
25731 msgid "B<--ntfsresize-force>"
25732 msgstr "B<--ntfsresize-force>"
25735 #: ../resize/virt-resize.pod:472
25737 "Pass the I<--force> option to L<ntfsresize(8)>, allowing resizing even if "
25738 "the NTFS disk is marked as needing a consistency check. You have to use "
25739 "this option if you want to resize a Windows guest multiple times without "
25740 "booting into Windows between each resize."
25744 #: ../resize/virt-resize.pod:478
25745 msgid "B<--output-format> raw"
25746 msgstr "B<--output-format> raw"
25749 #: ../resize/virt-resize.pod:480
25751 "Specify the format of the output disk image. If this flag is not given then "
25752 "it is auto-detected from the image itself."
25756 #: ../resize/virt-resize.pod:486
25758 "Note that this option I<does not create> the output format. This option "
25759 "just tells libguestfs what it is so it doesn't try to guess it. You still "
25760 "need to create the output disk with the right format. See L</QCOW2 AND NON-"
25761 "SPARSE RAW FORMATS>."
25765 #: ../resize/virt-resize.pod:495
25766 msgid "Don't print the summary."
25770 #: ../resize/virt-resize.pod:497
25771 msgid "B<--resize part=size>"
25772 msgstr "B<--resize розділ=розмір>"
25775 #: ../resize/virt-resize.pod:499
25777 "Resize the named partition (expanding or shrinking it) so that it has the "
25782 #: ../resize/virt-resize.pod:502
25784 "C<size> can be expressed as an absolute number followed by b/K/M/G to mean "
25785 "bytes, Kilobytes, Megabytes, or Gigabytes; or as a percentage of the current "
25786 "size; or as a relative number or percentage. For example:"
25790 #: ../resize/virt-resize.pod:508
25793 " --resize /dev/sda2=10G\n"
25798 #: ../resize/virt-resize.pod:510
25801 " --resize /dev/sda4=90%\n"
25806 #: ../resize/virt-resize.pod:512
25809 " --resize /dev/sda2=+1G\n"
25814 #: ../resize/virt-resize.pod:514
25817 " --resize /dev/sda2=-200M\n"
25822 #: ../resize/virt-resize.pod:516
25825 " --resize /dev/sda1=+128K\n"
25830 #: ../resize/virt-resize.pod:518
25833 " --resize /dev/sda1=+10%\n"
25838 #: ../resize/virt-resize.pod:520
25841 " --resize /dev/sda1=-10%\n"
25846 #: ../resize/virt-resize.pod:522
25848 "You can increase the size of any partition. Virt-resize will expand the "
25849 "direct content of the partition if it knows how (see I<--expand> below)."
25853 #: ../resize/virt-resize.pod:526
25855 "You can only I<decrease> the size of partitions that contain filesystems or "
25856 "PVs which have already been shrunk. Virt-resize will check this has been "
25857 "done before proceeding, or else will print an error (see also I<--resize-"
25862 #: ../resize/virt-resize.pod:533
25863 msgid "B<--resize-force part=size>"
25864 msgstr "B<--resize-force розділ=розмір>"
25867 #: ../resize/virt-resize.pod:535
25869 "This is the same as I<--resize> except that it will let you decrease the "
25870 "size of any partition. Generally this means you will lose any data which "
25871 "was at the end of the partition you shrink, but you may not care about that "
25872 "(eg. if shrinking an unused partition, or if you can easily recreate it such "
25873 "as a swap partition)."
25877 #: ../resize/virt-resize.pod:541
25878 msgid "See also the I<--ignore> option."
25882 #: ../resize/virt-resize.pod:543
25883 msgid "B<--shrink part>"
25884 msgstr "B<--shrink розділ>"
25887 #: ../resize/virt-resize.pod:545
25889 "Shrink the named partition until the overall disk image fits in the "
25890 "destination. The named partition B<must> contain a filesystem or PV which "
25891 "has already been shrunk using another tool (eg. L<guestfish(1)> or other "
25892 "online tools). Virt-resize will check this and give an error if it has not "
25897 #: ../resize/virt-resize.pod:551
25899 "The amount by which the overall disk must be shrunk (after carrying out all "
25900 "other operations requested by the user) is called the \"deficit\". For "
25901 "example, a straight copy (assume no other operations) from a 5GB disk image "
25902 "to a 4GB disk image results in a 1GB deficit. In this case, virt-resize "
25903 "would give an error unless the user specified a partition to shrink and that "
25904 "partition had more than a gigabyte of free space."
25908 #: ../resize/virt-resize.pod:569 ../sparsify/virt-sparsify.pod:177
25909 msgid "MACHINE READABLE OUTPUT"
25913 #: ../resize/virt-resize.pod:571
25915 "The I<--machine-readable> option can be used to make the output more machine "
25916 "friendly, which is useful when calling virt-resize from other programs, GUIs "
25921 #: ../resize/virt-resize.pod:575 ../sparsify/virt-sparsify.pod:183
25922 msgid "There are two ways to use this option."
25926 #: ../resize/virt-resize.pod:577
25928 "Firstly use the option on its own to query the capabilities of the virt-"
25929 "resize binary. Typical output looks like this:"
25933 #: ../resize/virt-resize.pod:580
25936 " $ virt-resize --machine-readable\n"
25938 " ntfsresize-force\n"
25946 #: ../resize/virt-resize.pod:587 ../sparsify/virt-sparsify.pod:193
25948 "A list of features is printed, one per line, and the program exits with "
25953 #: ../resize/virt-resize.pod:590 ../sparsify/virt-sparsify.pod:196
25955 "Secondly use the option in conjunction with other options to make the "
25956 "regular program output more machine friendly."
25960 #: ../resize/virt-resize.pod:593 ../sparsify/virt-sparsify.pod:199
25961 msgid "At the moment this means:"
25965 #: ../resize/virt-resize.pod:599 ../sparsify/virt-sparsify.pod:205
25967 "Progress bar messages can be parsed from stdout by looking for this regular "
25972 #: ../resize/virt-resize.pod:602 ../sparsify/virt-sparsify.pod:208
25975 " ^[0-9]+/[0-9]+$\n"
25980 #: ../resize/virt-resize.pod:606 ../sparsify/virt-sparsify.pod:212
25982 "The calling program should treat messages sent to stdout (except for "
25983 "progress bar messages) as status messages. They can be logged and/or "
25984 "displayed to the user."
25988 #: ../resize/virt-resize.pod:612
25990 "The calling program should treat messages sent to stderr as error messages. "
25991 "In addition, virt-resize exits with a non-zero status code if there was a "
25996 #: ../resize/virt-resize.pod:618
25998 "Versions of the program prior to 1.13.9 did not support the I<--machine-"
25999 "readable> option and will return an error."
26003 #: ../resize/virt-resize.pod:623
26004 msgid "\"Partition 1 does not end on cylinder boundary.\""
26008 #: ../resize/virt-resize.pod:625
26010 "Virt-resize aligns partitions to multiples of 128 sectors (see the I<--"
26011 "alignment> parameter). Usually this means the partitions will not be "
26012 "aligned to the ancient CHS geometry. However CHS geometry is meaningless "
26013 "for disks manufactured since the early 1990s, and doubly so for virtual hard "
26014 "drives. Alignment of partitions to cylinders is not required by any modern "
26015 "operating system."
26019 #: ../resize/virt-resize.pod:632
26020 msgid "RESIZING WINDOWS VIRTUAL MACHINES"
26024 #: ../resize/virt-resize.pod:634
26026 "In Windows Vista and later versions, Microsoft switched to using a separate "
26027 "boot partition. In these VMs, typically C</dev/sda1> is the boot partition "
26028 "and C</dev/sda2> is the main (C:) drive. Resizing the first (boot) "
26029 "partition causes the bootloader to fail with C<0xC0000225> error. Resizing "
26030 "the second partition (ie. C: drive) should work."
26034 #: ../resize/virt-resize.pod:641
26036 "Windows may initiate a lengthy \"chkdsk\" on first boot after a resize, if "
26037 "NTFS partitions have been expanded. This is just a safety check and (unless "
26038 "it find errors) is nothing to worry about."
26042 #: ../resize/virt-resize.pod:645
26043 msgid "GUEST BOOT STUCK AT \"GRUB\""
26047 #: ../resize/virt-resize.pod:647
26049 "If a Linux guest does not boot after resizing, and the boot is stuck after "
26050 "printing C<GRUB> on the console, try reinstalling grub."
26054 #: ../resize/virt-resize.pod:650
26057 " guestfish -i -a newdisk\n"
26058 " ><fs> cat /boot/grub/device.map\n"
26059 " # check the contents of this file are sensible or\n"
26060 " # edit the file if necessary\n"
26061 " ><fs> grub-install / /dev/vda\n"
26067 #: ../resize/virt-resize.pod:657
26069 "For more flexible guest reconfiguration, including if you need to specify "
26070 "other parameters to grub-install, use L<virt-rescue(1)>."
26074 #: ../resize/virt-resize.pod:660
26075 msgid "ALTERNATIVE TOOLS"
26079 #: ../resize/virt-resize.pod:662
26081 "There are several proprietary tools for resizing partitions. We won't "
26082 "mention any here."
26086 #: ../resize/virt-resize.pod:665
26088 "L<parted(8)> and its graphical shell gparted can do some types of resizing "
26089 "operations on disk images. They can resize and move partitions, but I don't "
26090 "think they can do anything with the contents, and they certainly don't "
26095 #: ../resize/virt-resize.pod:670
26097 "L<guestfish(1)> can do everything that virt-resize can do and a lot more, "
26098 "but at a much lower level. You will probably end up hand-calculating sector "
26099 "offsets, which is something that virt-resize was designed to avoid. If you "
26100 "want to see the guestfish-equivalent commands that virt-resize runs, use the "
26105 #: ../resize/virt-resize.pod:690
26107 "L<virt-filesystems(1)>, L<virt-df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<lvm"
26108 "(8)>, L<pvresize(8)>, L<lvresize(8)>, L<resize2fs(8)>, L<ntfsresize(8)>, "
26109 "L<btrfs(8)>, L<virsh(1)>, L<parted(8)>, L<truncate(1)>, L<fallocate(1)>, "
26110 "L<grub(8)>, L<grub-install(8)>, L<virt-rescue(1)>, L<virt-sparsify(1)>, "
26111 "L<virt-alignment-scan(1)>, L<http://libguestfs.org/>."
26115 #: ../ruby/examples/guestfs-ruby.pod:5
26116 msgid "guestfs-ruby - How to use libguestfs from Ruby"
26120 #: ../ruby/examples/guestfs-ruby.pod:9
26123 " require 'guestfs'\n"
26124 " g = Guestfs::Guestfs.new()\n"
26125 " g.add_drive_opts(\"disk.img\",\n"
26126 " :readonly => 1, :format => \"raw\")\n"
26132 #: ../ruby/examples/guestfs-ruby.pod:17
26134 "This manual page documents how to call libguestfs from the Ruby programming "
26135 "language. This page just documents the differences from the C API and gives "
26136 "some examples. If you are not familiar with using libguestfs, you also need "
26137 "to read L<guestfs(3)>."
26141 #: ../ruby/examples/guestfs-ruby.pod:24
26143 "Errors from libguestfs functions are mapped into the C<Error> exception. "
26144 "This has a single parameter which is the error message (a string)."
26148 #: ../ruby/examples/guestfs-ruby.pod:38
26150 "L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-erlang(3)>, L<guestfs-java"
26151 "(3)>, L<guestfs-ocaml(3)>, L<guestfs-perl(3)>, L<guestfs-python(3)>, "
26152 "L<guestfs-recipes(1)>, L<http://libguestfs.org/>."
26156 #: ../sparsify/virt-sparsify.pod:5
26157 msgid "virt-sparsify - Make a virtual machine disk sparse"
26161 #: ../sparsify/virt-sparsify.pod:9
26164 " virt-sparsify [--options] indisk outdisk\n"
26169 #: ../sparsify/virt-sparsify.pod:13
26171 "Virt-sparsify is a tool which can make a virtual machine disk (or any disk "
26172 "image) sparse a.k.a. thin-provisioned. This means that free space within "
26173 "the disk image can be converted back to free space on the host."
26177 #: ../sparsify/virt-sparsify.pod:18
26179 "Virt-sparsify can locate and sparsify free space in most filesystems (eg. "
26180 "ext2/3/4, btrfs, NTFS, etc.), and also in LVM physical volumes."
26184 #: ../sparsify/virt-sparsify.pod:21
26186 "Virt-sparsify can also convert between some disk formats, for example "
26187 "converting a raw disk image to a thin-provisioned qcow2 image."
26191 #: ../sparsify/virt-sparsify.pod:24
26193 "Virt-sparsify can operate on any disk image, not just ones from virtual "
26194 "machines. If a virtual machine has more than one attached disk, you must "
26195 "sparsify each one separately."
26199 #: ../sparsify/virt-sparsify.pod:28
26200 msgid "IMPORTANT LIMITATIONS"
26204 #: ../sparsify/virt-sparsify.pod:34
26206 "Virt-sparsify does not do in-place modifications. It copies from a source "
26207 "image to a destination image, leaving the source unchanged. I<Check that "
26208 "the sparsification was successful before deleting the source image>."
26212 #: ../sparsify/virt-sparsify.pod:41
26213 msgid "The virtual machine I<must be shut down> before using this tool."
26217 #: ../sparsify/virt-sparsify.pod:45
26219 "Virt-sparsify may require up to 2x the virtual size of the source disk image "
26220 "(1 temporary copy + 1 destination image). This is in the worst case and "
26221 "usually much less space is required."
26225 #: ../sparsify/virt-sparsify.pod:51
26227 "Virt-sparsify cannot resize disk images. To do that, use L<virt-resize(1)>."
26231 #: ../sparsify/virt-sparsify.pod:56
26232 msgid "Virt-sparsify cannot handle encrypted disks."
26236 #: ../sparsify/virt-sparsify.pod:60
26238 "Virt-sparsify cannot yet sparsify the space between partitions. Note that "
26239 "this space is often used for critical items like bootloaders so it's not "
26244 #: ../sparsify/virt-sparsify.pod:66
26246 "Virt-sparsify does not yet know how to sparsify swapspace. It is not safe "
26247 "to do this unless we can be sure there is no hibernation data, so at the "
26248 "moment swap partitions are ignored."
26252 #: ../sparsify/virt-sparsify.pod:72
26254 "You may also want to read the manual pages for the associated tools L<virt-"
26255 "filesystems(1)> and L<virt-df(1)> before starting."
26259 #: ../sparsify/virt-sparsify.pod:77
26260 msgid "Typical usage is:"
26264 #: ../sparsify/virt-sparsify.pod:79
26267 " virt-sparsify indisk outdisk\n"
26272 #: ../sparsify/virt-sparsify.pod:81
26274 "which copies C<indisk> to C<outdisk>, making the output sparse. C<outdisk> "
26275 "is created, or overwritten if it already exists. The format of the input "
26276 "disk is detected (eg. qcow2) and the same format is used for the output disk."
26280 #: ../sparsify/virt-sparsify.pod:86
26281 msgid "To convert between formats, use the I<--convert> option:"
26285 #: ../sparsify/virt-sparsify.pod:88
26288 " virt-sparsify disk.raw --convert qcow2 disk.qcow2\n"
26293 #: ../sparsify/virt-sparsify.pod:90
26295 "Virt-sparsify tries to zero and sparsify free space on every filesystem it "
26296 "can find within the source disk image. You can get it to ignore (don't zero "
26297 "free space on) certain filesystems by doing:"
26301 #: ../sparsify/virt-sparsify.pod:94
26304 " virt-sparsify --ignore /dev/sda1 indisk outdisk\n"
26309 #: ../sparsify/virt-sparsify.pod:96
26311 "See L<virt-filesystems(1)> to get a list of filesystems within a disk image."
26315 #: ../sparsify/virt-sparsify.pod:107
26316 msgid "B<--convert> raw"
26320 #: ../sparsify/virt-sparsify.pod:109
26321 msgid "B<--convert> qcow2"
26325 #: ../sparsify/virt-sparsify.pod:111
26326 msgid "B<--convert> [other formats]"
26330 #: ../sparsify/virt-sparsify.pod:113
26332 "Use C<output-format> as the format for the destination image. If this is "
26333 "not specified, then the input format is used."
26337 #: ../sparsify/virt-sparsify.pod:116
26338 msgid "Supported and known-working output formats are: C<raw>, C<qcow2>."
26342 #: ../sparsify/virt-sparsify.pod:118
26344 "You can also use any format supported by the L<qemu-img(1)> program, eg. "
26345 "C<vdi> or C<vmdk>, but support for other formats is reliant on qemu."
26349 #: ../sparsify/virt-sparsify.pod:122
26351 "Specifying the I<--convert> option is usually a good idea, because then virt-"
26352 "sparsify doesn't need to try to guess the input format."
26356 #: ../sparsify/virt-sparsify.pod:127
26357 msgid "B<--format> qcow2"
26361 #: ../sparsify/virt-sparsify.pod:135
26362 msgid "B<--ignore> filesystem"
26366 #: ../sparsify/virt-sparsify.pod:137
26367 msgid "B<--ignore> volgroup"
26371 #: ../sparsify/virt-sparsify.pod:139
26373 "Ignore the named filesystem. Free space on the filesystem will not be "
26374 "zeroed, but existing blocks of zeroes will still be sparsified."
26378 #: ../sparsify/virt-sparsify.pod:142
26380 "In the second form, this ignores the named volume group. Use the volume "
26381 "group name without the C</dev/> prefix, eg. I<--ignore vg_foo>"
26385 #: ../sparsify/virt-sparsify.pod:157
26386 msgid "This disables progress bars and other unnecessary output."
26390 #: ../sparsify/virt-sparsify.pod:179
26392 "The I<--machine-readable> option can be used to make the output more machine "
26393 "friendly, which is useful when calling virt-sparsify from other programs, "
26398 #: ../sparsify/virt-sparsify.pod:185
26400 "Firstly use the option on its own to query the capabilities of the virt-"
26401 "sparsify binary. Typical output looks like this:"
26405 #: ../sparsify/virt-sparsify.pod:188
26408 " $ virt-sparsify --machine-readable\n"
26416 #: ../sparsify/virt-sparsify.pod:218
26418 "The calling program should treat messages sent to stderr as error messages. "
26419 "In addition, virt-sparsify exits with a non-zero status code if there was a "
26424 #: ../sparsify/virt-sparsify.pod:224
26426 "All versions of virt-sparsify have supported the I<--machine-readable> "
26431 #: ../sparsify/virt-sparsify.pod:238
26433 "Location of the temporary directory used for the potentially large temporary "
26438 #: ../sparsify/virt-sparsify.pod:241
26440 "You should ensure there is enough free space in the worst case for a full "
26441 "copy of the source disk (I<virtual> size), or else set C<$TMPDIR> to point "
26442 "to another directory that has enough space."
26446 #: ../sparsify/virt-sparsify.pod:245
26447 msgid "This defaults to C</tmp>."
26451 #: ../sparsify/virt-sparsify.pod:249
26453 "For other environment variables, see L<guestfs(3)/ENVIRONMENT VARIABLES>."
26457 #: ../sparsify/virt-sparsify.pod:253
26459 "L<virt-filesystems(1)>, L<virt-df(1)>, L<virt-resize(1)>, L<virt-rescue(1)>, "
26460 "L<guestfs(3)>, L<guestfish(1)>, L<truncate(1)>, L<fallocate(1)>, L<qemu-img"
26461 "(1)>, L<http://libguestfs.org/>."
26465 #: ../src/guestfs-actions.pod:1
26466 msgid "guestfs_add_cdrom"
26470 #: ../src/guestfs-actions.pod:3
26474 " guestfs_add_cdrom (guestfs_h *g,\n"
26475 " const char *filename);\n"
26480 #: ../src/guestfs-actions.pod:7 ../src/guestfs-actions.pod:302
26481 #: ../src/guestfs-actions.pod:323
26483 "I<This function is deprecated.> In new code, use the L</"
26484 "guestfs_add_drive_opts> call instead."
26488 #: ../src/guestfs-actions.pod:24
26490 "This call checks for the existence of C<filename>. This stops you from "
26491 "specifying other types of drive which are supported by qemu such as C<nbd:> "
26492 "and C<http:> URLs. To specify those, use the general C<guestfs_config> call "
26497 #: ../src/guestfs-actions.pod:31
26499 "If you just want to add an ISO file (often you use this as an efficient way "
26500 "to transfer large files into the guest), then you should probably use "
26501 "C<guestfs_add_drive_ro> instead."
26505 #: ../src/guestfs-actions.pod:37 ../src/guestfs-actions.pod:187
26506 #: ../src/guestfs-actions.pod:254 ../src/guestfs-actions.pod:291
26507 #: ../src/guestfs-actions.pod:312 ../src/guestfs-actions.pod:333
26508 #: ../src/guestfs-actions.pod:346 ../src/guestfs-actions.pod:360
26509 #: ../src/guestfs-actions.pod:480 ../src/guestfs-actions.pod:500
26510 #: ../src/guestfs-actions.pod:514 ../src/guestfs-actions.pod:559
26511 #: ../src/guestfs-actions.pod:587 ../src/guestfs-actions.pod:605
26512 #: ../src/guestfs-actions.pod:672 ../src/guestfs-actions.pod:705
26513 #: ../src/guestfs-actions.pod:719 ../src/guestfs-actions.pod:734
26514 #: ../src/guestfs-actions.pod:833 ../src/guestfs-actions.pod:851
26515 #: ../src/guestfs-actions.pod:865 ../src/guestfs-actions.pod:879
26516 #: ../src/guestfs-actions.pod:916 ../src/guestfs-actions.pod:1099
26517 #: ../src/guestfs-actions.pod:1119 ../src/guestfs-actions.pod:1137
26518 #: ../src/guestfs-actions.pod:1227 ../src/guestfs-actions.pod:1286
26519 #: ../src/guestfs-actions.pod:1332 ../src/guestfs-actions.pod:1372
26520 #: ../src/guestfs-actions.pod:1425 ../src/guestfs-actions.pod:1478
26521 #: ../src/guestfs-actions.pod:1536 ../src/guestfs-actions.pod:1590
26522 #: ../src/guestfs-actions.pod:1609 ../src/guestfs-actions.pod:1623
26523 #: ../src/guestfs-actions.pod:1651 ../src/guestfs-actions.pod:1721
26524 #: ../src/guestfs-actions.pod:1752 ../src/guestfs-actions.pod:1777
26525 #: ../src/guestfs-actions.pod:1819 ../src/guestfs-actions.pod:1932
26526 #: ../src/guestfs-actions.pod:1959 ../src/guestfs-actions.pod:2174
26527 #: ../src/guestfs-actions.pod:2196 ../src/guestfs-actions.pod:2283
26528 #: ../src/guestfs-actions.pod:2791 ../src/guestfs-actions.pod:2935
26529 #: ../src/guestfs-actions.pod:2996 ../src/guestfs-actions.pod:3031
26530 #: ../src/guestfs-actions.pod:4088 ../src/guestfs-actions.pod:4103
26531 #: ../src/guestfs-actions.pod:4128 ../src/guestfs-actions.pod:4328
26532 #: ../src/guestfs-actions.pod:4342 ../src/guestfs-actions.pod:4355
26533 #: ../src/guestfs-actions.pod:4369 ../src/guestfs-actions.pod:4384
26534 #: ../src/guestfs-actions.pod:4420 ../src/guestfs-actions.pod:4492
26535 #: ../src/guestfs-actions.pod:4512 ../src/guestfs-actions.pod:4529
26536 #: ../src/guestfs-actions.pod:4549 ../src/guestfs-actions.pod:4569
26537 #: ../src/guestfs-actions.pod:4604 ../src/guestfs-actions.pod:4623
26538 #: ../src/guestfs-actions.pod:4642 ../src/guestfs-actions.pod:4677
26539 #: ../src/guestfs-actions.pod:4689 ../src/guestfs-actions.pod:4722
26540 #: ../src/guestfs-actions.pod:4738 ../src/guestfs-actions.pod:4751
26541 #: ../src/guestfs-actions.pod:4766 ../src/guestfs-actions.pod:4783
26542 #: ../src/guestfs-actions.pod:4941 ../src/guestfs-actions.pod:5014
26543 #: ../src/guestfs-actions.pod:5034 ../src/guestfs-actions.pod:5047
26544 #: ../src/guestfs-actions.pod:5098 ../src/guestfs-actions.pod:5116
26545 #: ../src/guestfs-actions.pod:5134 ../src/guestfs-actions.pod:5150
26546 #: ../src/guestfs-actions.pod:5164 ../src/guestfs-actions.pod:5178
26547 #: ../src/guestfs-actions.pod:5195 ../src/guestfs-actions.pod:5210
26548 #: ../src/guestfs-actions.pod:5237 ../src/guestfs-actions.pod:5300
26549 #: ../src/guestfs-actions.pod:5373 ../src/guestfs-actions.pod:5404
26550 #: ../src/guestfs-actions.pod:5423 ../src/guestfs-actions.pod:5442
26551 #: ../src/guestfs-actions.pod:5454 ../src/guestfs-actions.pod:5471
26552 #: ../src/guestfs-actions.pod:5484 ../src/guestfs-actions.pod:5499
26553 #: ../src/guestfs-actions.pod:5514 ../src/guestfs-actions.pod:5546
26554 #: ../src/guestfs-actions.pod:5572 ../src/guestfs-actions.pod:5611
26555 #: ../src/guestfs-actions.pod:5631 ../src/guestfs-actions.pod:5645
26556 #: ../src/guestfs-actions.pod:5662 ../src/guestfs-actions.pod:5711
26557 #: ../src/guestfs-actions.pod:5764 ../src/guestfs-actions.pod:5811
26558 #: ../src/guestfs-actions.pod:5854 ../src/guestfs-actions.pod:5882
26559 #: ../src/guestfs-actions.pod:5899 ../src/guestfs-actions.pod:5917
26560 #: ../src/guestfs-actions.pod:6054 ../src/guestfs-actions.pod:6111
26561 #: ../src/guestfs-actions.pod:6133 ../src/guestfs-actions.pod:6151
26562 #: ../src/guestfs-actions.pod:6203 ../src/guestfs-actions.pod:6269
26563 #: ../src/guestfs-actions.pod:6286 ../src/guestfs-actions.pod:6299
26564 #: ../src/guestfs-actions.pod:6313 ../src/guestfs-actions.pod:6602
26565 #: ../src/guestfs-actions.pod:6621 ../src/guestfs-actions.pod:6640
26566 #: ../src/guestfs-actions.pod:6654 ../src/guestfs-actions.pod:6666
26567 #: ../src/guestfs-actions.pod:6680 ../src/guestfs-actions.pod:6692
26568 #: ../src/guestfs-actions.pod:6706 ../src/guestfs-actions.pod:6722
26569 #: ../src/guestfs-actions.pod:6740 ../src/guestfs-actions.pod:6759
26570 #: ../src/guestfs-actions.pod:6778 ../src/guestfs-actions.pod:6808
26571 #: ../src/guestfs-actions.pod:6826 ../src/guestfs-actions.pod:6849
26572 #: ../src/guestfs-actions.pod:6867 ../src/guestfs-actions.pod:6886
26573 #: ../src/guestfs-actions.pod:6907 ../src/guestfs-actions.pod:6926
26574 #: ../src/guestfs-actions.pod:6943 ../src/guestfs-actions.pod:6962
26575 #: ../src/guestfs-actions.pod:6990 ../src/guestfs-actions.pod:7014
26576 #: ../src/guestfs-actions.pod:7033 ../src/guestfs-actions.pod:7049
26577 #: ../src/guestfs-actions.pod:7073 ../src/guestfs-actions.pod:7092
26578 #: ../src/guestfs-actions.pod:7107 ../src/guestfs-actions.pod:7126
26579 #: ../src/guestfs-actions.pod:7170 ../src/guestfs-actions.pod:7197
26580 #: ../src/guestfs-actions.pod:7227 ../src/guestfs-actions.pod:7339
26581 #: ../src/guestfs-actions.pod:7460 ../src/guestfs-actions.pod:7472
26582 #: ../src/guestfs-actions.pod:7485 ../src/guestfs-actions.pod:7498
26583 #: ../src/guestfs-actions.pod:7520 ../src/guestfs-actions.pod:7533
26584 #: ../src/guestfs-actions.pod:7546 ../src/guestfs-actions.pod:7559
26585 #: ../src/guestfs-actions.pod:7574 ../src/guestfs-actions.pod:7633
26586 #: ../src/guestfs-actions.pod:7650 ../src/guestfs-actions.pod:7666
26587 #: ../src/guestfs-actions.pod:7682 ../src/guestfs-actions.pod:7699
26588 #: ../src/guestfs-actions.pod:7712 ../src/guestfs-actions.pod:7732
26589 #: ../src/guestfs-actions.pod:7832 ../src/guestfs-actions.pod:7888
26590 #: ../src/guestfs-actions.pod:7902 ../src/guestfs-actions.pod:7943
26591 #: ../src/guestfs-actions.pod:7956 ../src/guestfs-actions.pod:7974
26592 #: ../src/guestfs-actions.pod:8008 ../src/guestfs-actions.pod:8044
26593 #: ../src/guestfs-actions.pod:8160 ../src/guestfs-actions.pod:8175
26594 #: ../src/guestfs-actions.pod:8189 ../src/guestfs-actions.pod:8244
26595 #: ../src/guestfs-actions.pod:8257 ../src/guestfs-actions.pod:8302
26596 #: ../src/guestfs-actions.pod:8342 ../src/guestfs-actions.pod:8398
26597 #: ../src/guestfs-actions.pod:8418 ../src/guestfs-actions.pod:8451
26598 #: ../src/guestfs-actions.pod:8515 ../src/guestfs-actions.pod:8538
26599 #: ../src/guestfs-actions.pod:8564
26600 msgid "This function returns 0 on success or -1 on error."
26604 #: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:189
26605 #: ../src/guestfs-actions.pod:1334 ../src/guestfs-actions.pod:2397
26606 #: ../src/guestfs-actions.pod:2495 ../src/guestfs-actions.pod:2620
26607 #: ../src/guestfs-actions.pod:4090 ../src/guestfs-actions.pod:4110
26608 #: ../src/guestfs-actions.pod:5548 ../src/guestfs-actions.pod:6828
26609 #: ../src/guestfs-actions.pod:6945 ../src/guestfs-actions.pod:7094
26610 #: ../src/guestfs-actions.pod:7576 ../src/guestfs-actions.pod:7701
26611 #: ../src/guestfs-actions.pod:8344
26612 msgid "(Added in 0.3)"
26613 msgstr "(Додано у 0.3)"
26616 #: ../src/guestfs-actions.pod:41
26617 msgid "guestfs_add_domain"
26621 #: ../src/guestfs-actions.pod:43
26625 " guestfs_add_domain (guestfs_h *g,\n"
26626 " const char *dom,\n"
26632 #: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:198
26633 #: ../src/guestfs-actions.pod:890 ../src/guestfs-actions.pod:1214
26634 #: ../src/guestfs-actions.pod:1266 ../src/guestfs-actions.pod:1344
26635 #: ../src/guestfs-actions.pod:1413 ../src/guestfs-actions.pod:1466
26636 #: ../src/guestfs-actions.pod:1519 ../src/guestfs-actions.pod:3288
26637 #: ../src/guestfs-actions.pod:4876 ../src/guestfs-actions.pod:5249
26638 #: ../src/guestfs-actions.pod:5558 ../src/guestfs-actions.pod:5775
26639 #: ../src/guestfs-actions.pod:7743
26641 "You may supply a list of optional arguments to this call. Use zero or more "
26642 "of the following pairs of parameters, and terminate the list with C<-1> on "
26643 "its own. See L</CALLS WITH OPTIONAL ARGUMENTS>."
26647 #: ../src/guestfs-actions.pod:53
26650 " GUESTFS_ADD_DOMAIN_LIBVIRTURI, const char *libvirturi,\n"
26651 " GUESTFS_ADD_DOMAIN_READONLY, int readonly,\n"
26652 " GUESTFS_ADD_DOMAIN_IFACE, const char *iface,\n"
26653 " GUESTFS_ADD_DOMAIN_LIVE, int live,\n"
26654 " GUESTFS_ADD_DOMAIN_ALLOWUUID, int allowuuid,\n"
26655 " GUESTFS_ADD_DOMAIN_READONLYDISK, const char *readonlydisk,\n"
26660 #: ../src/guestfs-actions.pod:60
26662 "This function adds the disk(s) attached to the named libvirt domain C<dom>. "
26663 "It works by connecting to libvirt, requesting the domain and domain XML from "
26664 "libvirt, parsing it for disks, and calling C<guestfs_add_drive_opts> on each "
26669 #: ../src/guestfs-actions.pod:141
26671 "The other optional parameters are passed directly through to "
26672 "C<guestfs_add_drive_opts>."
26676 #: ../src/guestfs-actions.pod:144 ../src/guestfs-actions.pod:403
26677 #: ../src/guestfs-actions.pod:573 ../src/guestfs-actions.pod:751
26678 #: ../src/guestfs-actions.pod:782 ../src/guestfs-actions.pod:800
26679 #: ../src/guestfs-actions.pod:819 ../src/guestfs-actions.pod:1797
26680 #: ../src/guestfs-actions.pod:2153 ../src/guestfs-actions.pod:2356
26681 #: ../src/guestfs-actions.pod:2467 ../src/guestfs-actions.pod:2518
26682 #: ../src/guestfs-actions.pod:2570 ../src/guestfs-actions.pod:2584
26683 #: ../src/guestfs-actions.pod:2607 ../src/guestfs-actions.pod:2922
26684 #: ../src/guestfs-actions.pod:3406 ../src/guestfs-actions.pod:3424
26685 #: ../src/guestfs-actions.pod:5734 ../src/guestfs-actions.pod:5951
26686 #: ../src/guestfs-actions.pod:6189 ../src/guestfs-actions.pod:6383
26687 #: ../src/guestfs-actions.pod:6409 ../src/guestfs-actions.pod:7929
26688 #: ../src/guestfs-actions.pod:8355 ../src/guestfs-actions.pod:8368
26689 #: ../src/guestfs-actions.pod:8381
26690 msgid "On error this function returns -1."
26694 #: ../src/guestfs-actions.pod:146
26695 msgid "(Added in 1.7.4)"
26696 msgstr "(Додано у 1.7.4)"
26699 #: ../src/guestfs-actions.pod:148
26700 msgid "guestfs_add_domain_va"
26704 #: ../src/guestfs-actions.pod:150
26708 " guestfs_add_domain_va (guestfs_h *g,\n"
26709 " const char *dom,\n"
26710 " va_list args);\n"
26715 #: ../src/guestfs-actions.pod:155
26716 msgid "This is the \"va_list variant\" of L</guestfs_add_domain>."
26720 #: ../src/guestfs-actions.pod:157 ../src/guestfs-actions.pod:168
26721 #: ../src/guestfs-actions.pod:267 ../src/guestfs-actions.pod:278
26722 #: ../src/guestfs-actions.pod:929 ../src/guestfs-actions.pod:940
26723 #: ../src/guestfs-actions.pod:1242 ../src/guestfs-actions.pod:1255
26724 #: ../src/guestfs-actions.pod:1301 ../src/guestfs-actions.pod:1314
26725 #: ../src/guestfs-actions.pod:1391 ../src/guestfs-actions.pod:1403
26726 #: ../src/guestfs-actions.pod:1444 ../src/guestfs-actions.pod:1456
26727 #: ../src/guestfs-actions.pod:1497 ../src/guestfs-actions.pod:1509
26728 #: ../src/guestfs-actions.pod:1555 ../src/guestfs-actions.pod:1567
26729 #: ../src/guestfs-actions.pod:3372 ../src/guestfs-actions.pod:3384
26730 #: ../src/guestfs-actions.pod:4953 ../src/guestfs-actions.pod:4965
26731 #: ../src/guestfs-actions.pod:5314 ../src/guestfs-actions.pod:5326
26732 #: ../src/guestfs-actions.pod:5586 ../src/guestfs-actions.pod:5598
26733 #: ../src/guestfs-actions.pod:5824 ../src/guestfs-actions.pod:5835
26734 #: ../src/guestfs-actions.pod:7843 ../src/guestfs-actions.pod:7854
26735 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>."
26736 msgstr "Див. L</CALLS WITH OPTIONAL ARGUMENTS>."
26739 #: ../src/guestfs-actions.pod:159
26740 msgid "guestfs_add_domain_argv"
26741 msgstr "guestfs_add_domain_argv"
26744 #: ../src/guestfs-actions.pod:161
26748 " guestfs_add_domain_argv (guestfs_h *g,\n"
26749 " const char *dom,\n"
26750 " const struct guestfs_add_domain_argv *optargs);\n"
26755 #: ../src/guestfs-actions.pod:166
26756 msgid "This is the \"argv variant\" of L</guestfs_add_domain>."
26760 #: ../src/guestfs-actions.pod:170
26761 msgid "guestfs_add_drive"
26765 #: ../src/guestfs-actions.pod:172
26769 " guestfs_add_drive (guestfs_h *g,\n"
26770 " const char *filename);\n"
26775 #: ../src/guestfs-actions.pod:176
26777 "This function is the equivalent of calling C<guestfs_add_drive_opts> with no "
26778 "optional parameters, so the disk is added writable, with the format being "
26779 "detected automatically."
26783 #: ../src/guestfs-actions.pod:180
26785 "Automatic detection of the format opens you up to a potential security hole "
26786 "when dealing with untrusted raw-format images. See CVE-2010-3851 and "
26787 "RHBZ#642934. Specifying the format closes this security hole. Therefore "
26788 "you should think about replacing calls to this function with calls to "
26789 "C<guestfs_add_drive_opts>, and specifying the format."
26793 #: ../src/guestfs-actions.pod:191
26794 msgid "guestfs_add_drive_opts"
26798 #: ../src/guestfs-actions.pod:193
26802 " guestfs_add_drive_opts (guestfs_h *g,\n"
26803 " const char *filename,\n"
26809 #: ../src/guestfs-actions.pod:203
26812 " GUESTFS_ADD_DRIVE_OPTS_READONLY, int readonly,\n"
26813 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, const char *format,\n"
26814 " GUESTFS_ADD_DRIVE_OPTS_IFACE, const char *iface,\n"
26815 " GUESTFS_ADD_DRIVE_OPTS_NAME, const char *name,\n"
26820 #: ../src/guestfs-actions.pod:233
26822 "This forces the image format. If you omit this (or use C<guestfs_add_drive> "
26823 "or C<guestfs_add_drive_ro>) then the format is automatically detected. "
26824 "Possible formats include C<raw> and C<qcow2>."
26828 #: ../src/guestfs-actions.pod:244
26830 "This rarely-used option lets you emulate the behaviour of the deprecated "
26831 "C<guestfs_add_drive_with_if> call (q.v.)"
26835 #: ../src/guestfs-actions.pod:256
26836 msgid "(Added in 1.5.23)"
26837 msgstr "(Додано у 1.5.23)"
26840 #: ../src/guestfs-actions.pod:258
26841 msgid "guestfs_add_drive_opts_va"
26845 #: ../src/guestfs-actions.pod:260
26849 " guestfs_add_drive_opts_va (guestfs_h *g,\n"
26850 " const char *filename,\n"
26851 " va_list args);\n"
26856 #: ../src/guestfs-actions.pod:265
26857 msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>."
26861 #: ../src/guestfs-actions.pod:269
26862 msgid "guestfs_add_drive_opts_argv"
26866 #: ../src/guestfs-actions.pod:271
26870 " guestfs_add_drive_opts_argv (guestfs_h *g,\n"
26871 " const char *filename,\n"
26872 " const struct guestfs_add_drive_opts_argv *optargs);\n"
26877 #: ../src/guestfs-actions.pod:276
26878 msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>."
26882 #: ../src/guestfs-actions.pod:280
26883 msgid "guestfs_add_drive_ro"
26887 #: ../src/guestfs-actions.pod:282
26891 " guestfs_add_drive_ro (guestfs_h *g,\n"
26892 " const char *filename);\n"
26897 #: ../src/guestfs-actions.pod:286
26899 "This function is the equivalent of calling C<guestfs_add_drive_opts> with "
26900 "the optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the "
26901 "disk is added read-only, with the format being detected automatically."
26905 #: ../src/guestfs-actions.pod:293
26906 msgid "(Added in 1.0.38)"
26907 msgstr "(Додано у 1.0.38)"
26910 #: ../src/guestfs-actions.pod:295
26911 msgid "guestfs_add_drive_ro_with_if"
26915 #: ../src/guestfs-actions.pod:297
26919 " guestfs_add_drive_ro_with_if (guestfs_h *g,\n"
26920 " const char *filename,\n"
26921 " const char *iface);\n"
26926 #: ../src/guestfs-actions.pod:309
26928 "This is the same as C<guestfs_add_drive_ro> but it allows you to specify the "
26929 "QEMU interface emulation to use at run time."
26933 #: ../src/guestfs-actions.pod:314 ../src/guestfs-actions.pod:335
26934 #: ../src/guestfs-actions.pod:2881
26935 msgid "(Added in 1.0.84)"
26936 msgstr "(Додано у 1.0.84)"
26939 #: ../src/guestfs-actions.pod:316
26940 msgid "guestfs_add_drive_with_if"
26944 #: ../src/guestfs-actions.pod:318
26948 " guestfs_add_drive_with_if (guestfs_h *g,\n"
26949 " const char *filename,\n"
26950 " const char *iface);\n"
26955 #: ../src/guestfs-actions.pod:330
26957 "This is the same as C<guestfs_add_drive> but it allows you to specify the "
26958 "QEMU interface emulation to use at run time."
26962 #: ../src/guestfs-actions.pod:337
26963 msgid "guestfs_aug_clear"
26967 #: ../src/guestfs-actions.pod:339
26971 " guestfs_aug_clear (guestfs_h *g,\n"
26972 " const char *augpath);\n"
26977 #: ../src/guestfs-actions.pod:348 ../src/guestfs-actions.pod:2609
26978 msgid "(Added in 1.3.4)"
26979 msgstr "(Додано у 1.3.4)"
26982 #: ../src/guestfs-actions.pod:350
26983 msgid "guestfs_aug_close"
26987 #: ../src/guestfs-actions.pod:352
26991 " guestfs_aug_close (guestfs_h *g);\n"
26996 #: ../src/guestfs-actions.pod:355
26998 "Close the current Augeas handle and free up any resources used by it. After "
26999 "calling this, you have to call C<guestfs_aug_init> again before you can use "
27000 "any other Augeas functions."
27004 #: ../src/guestfs-actions.pod:362 ../src/guestfs-actions.pod:387
27005 #: ../src/guestfs-actions.pod:405 ../src/guestfs-actions.pod:419
27006 #: ../src/guestfs-actions.pod:482 ../src/guestfs-actions.pod:502
27007 #: ../src/guestfs-actions.pod:516 ../src/guestfs-actions.pod:547
27008 #: ../src/guestfs-actions.pod:561 ../src/guestfs-actions.pod:575
27009 #: ../src/guestfs-actions.pod:589 ../src/guestfs-actions.pod:607
27010 #: ../src/guestfs-actions.pod:6460
27011 msgid "(Added in 0.7)"
27012 msgstr "(Додано у 0.7)"
27015 #: ../src/guestfs-actions.pod:364
27016 msgid "guestfs_aug_defnode"
27020 #: ../src/guestfs-actions.pod:366
27023 " struct guestfs_int_bool *\n"
27024 " guestfs_aug_defnode (guestfs_h *g,\n"
27025 " const char *name,\n"
27026 " const char *expr,\n"
27027 " const char *val);\n"
27032 #: ../src/guestfs-actions.pod:375
27034 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
27035 "calling C<guestfs_aug_set> C<expr>, C<value>. C<name> will be the nodeset "
27036 "containing that single node."
27040 #: ../src/guestfs-actions.pod:383
27042 "This function returns a C<struct guestfs_int_bool *>, or NULL if there was "
27043 "an error. I<The caller must call C<guestfs_free_int_bool> after use>."
27047 #: ../src/guestfs-actions.pod:389
27048 msgid "guestfs_aug_defvar"
27052 #: ../src/guestfs-actions.pod:391
27056 " guestfs_aug_defvar (guestfs_h *g,\n"
27057 " const char *name,\n"
27058 " const char *expr);\n"
27063 #: ../src/guestfs-actions.pod:407
27064 msgid "guestfs_aug_get"
27065 msgstr "guestfs_aug_get"
27068 #: ../src/guestfs-actions.pod:409
27072 " guestfs_aug_get (guestfs_h *g,\n"
27073 " const char *augpath);\n"
27077 " guestfs_aug_get (guestfs_h *g,\n"
27078 " const char *augpath);\n"
27082 #: ../src/guestfs-actions.pod:416 ../src/guestfs-actions.pod:980
27083 #: ../src/guestfs-actions.pod:998 ../src/guestfs-actions.pod:1058
27084 #: ../src/guestfs-actions.pod:1074 ../src/guestfs-actions.pod:1177
27085 #: ../src/guestfs-actions.pod:1666 ../src/guestfs-actions.pod:1683
27086 #: ../src/guestfs-actions.pod:1702 ../src/guestfs-actions.pod:1836
27087 #: ../src/guestfs-actions.pod:2024 ../src/guestfs-actions.pod:2136
27088 #: ../src/guestfs-actions.pod:2299 ../src/guestfs-actions.pod:2316
27089 #: ../src/guestfs-actions.pod:2383 ../src/guestfs-actions.pod:2426
27090 #: ../src/guestfs-actions.pod:2447 ../src/guestfs-actions.pod:2632
27091 #: ../src/guestfs-actions.pod:2846 ../src/guestfs-actions.pod:3050
27092 #: ../src/guestfs-actions.pod:3152 ../src/guestfs-actions.pod:3256
27093 #: ../src/guestfs-actions.pod:3275 ../src/guestfs-actions.pod:3490
27094 #: ../src/guestfs-actions.pod:3518 ../src/guestfs-actions.pod:3539
27095 #: ../src/guestfs-actions.pod:3573 ../src/guestfs-actions.pod:3636
27096 #: ../src/guestfs-actions.pod:3656 ../src/guestfs-actions.pod:3676
27097 #: ../src/guestfs-actions.pod:4314 ../src/guestfs-actions.pod:4661
27098 #: ../src/guestfs-actions.pod:4828 ../src/guestfs-actions.pod:5076
27099 #: ../src/guestfs-actions.pod:5969 ../src/guestfs-actions.pod:6170
27100 #: ../src/guestfs-actions.pod:6358 ../src/guestfs-actions.pod:6536
27101 #: ../src/guestfs-actions.pod:6585 ../src/guestfs-actions.pod:7245
27102 #: ../src/guestfs-actions.pod:7261 ../src/guestfs-actions.pod:7285
27103 #: ../src/guestfs-actions.pod:7309 ../src/guestfs-actions.pod:8103
27104 #: ../src/guestfs-actions.pod:8122 ../src/guestfs-actions.pod:8140
27105 #: ../src/guestfs-actions.pod:8314 ../src/guestfs-actions.pod:8628
27107 "This function returns a string, or NULL on error. I<The caller must free "
27108 "the returned string after use>."
27112 #: ../src/guestfs-actions.pod:421
27113 msgid "guestfs_aug_init"
27114 msgstr "guestfs_aug_init"
27117 #: ../src/guestfs-actions.pod:423
27121 " guestfs_aug_init (guestfs_h *g,\n"
27122 " const char *root,\n"
27127 " guestfs_aug_init (guestfs_h *g,\n"
27128 " const char *root,\n"
27133 #: ../src/guestfs-actions.pod:432
27134 msgid "You must call this before using any other C<guestfs_aug_*> commands."
27138 #: ../src/guestfs-actions.pod:457
27140 "This option is only useful when debugging Augeas lenses. Use of this option "
27141 "may require additional memory for the libguestfs appliance. You may need to "
27142 "set the C<LIBGUESTFS_MEMSIZE> environment variable or call "
27143 "C<guestfs_set_memsize>."
27147 #: ../src/guestfs-actions.pod:472
27148 msgid "Do not load the tree in C<guestfs_aug_init>."
27152 #: ../src/guestfs-actions.pod:476
27153 msgid "To close the handle, you can call C<guestfs_aug_close>."
27157 #: ../src/guestfs-actions.pod:484
27158 msgid "guestfs_aug_insert"
27159 msgstr "guestfs_aug_insert"
27162 #: ../src/guestfs-actions.pod:486
27166 " guestfs_aug_insert (guestfs_h *g,\n"
27167 " const char *augpath,\n"
27168 " const char *label,\n"
27173 " guestfs_aug_insert (guestfs_h *g,\n"
27174 " const char *augpath,\n"
27175 " const char *label,\n"
27180 #: ../src/guestfs-actions.pod:504
27181 msgid "guestfs_aug_load"
27182 msgstr "guestfs_aug_load"
27185 #: ../src/guestfs-actions.pod:506
27189 " guestfs_aug_load (guestfs_h *g);\n"
27193 " guestfs_aug_load (guestfs_h *g);\n"
27197 #: ../src/guestfs-actions.pod:518
27198 msgid "guestfs_aug_ls"
27199 msgstr "guestfs_aug_ls"
27202 #: ../src/guestfs-actions.pod:520
27206 " guestfs_aug_ls (guestfs_h *g,\n"
27207 " const char *augpath);\n"
27211 " guestfs_aug_ls (guestfs_h *g,\n"
27212 " const char *augpath);\n"
27216 #: ../src/guestfs-actions.pod:524
27218 "This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and "
27219 "sorting the resulting nodes into alphabetical order."
27223 #: ../src/guestfs-actions.pod:527 ../src/guestfs-actions.pod:543
27224 #: ../src/guestfs-actions.pod:689 ../src/guestfs-actions.pod:1196
27225 #: ../src/guestfs-actions.pod:1851 ../src/guestfs-actions.pod:1870
27226 #: ../src/guestfs-actions.pod:1973 ../src/guestfs-actions.pod:1992
27227 #: ../src/guestfs-actions.pod:2238 ../src/guestfs-actions.pod:2704
27228 #: ../src/guestfs-actions.pod:2720 ../src/guestfs-actions.pod:2739
27229 #: ../src/guestfs-actions.pod:2804 ../src/guestfs-actions.pod:2828
27230 #: ../src/guestfs-actions.pod:2899 ../src/guestfs-actions.pod:2948
27231 #: ../src/guestfs-actions.pod:3217 ../src/guestfs-actions.pod:3592
27232 #: ../src/guestfs-actions.pod:3872 ../src/guestfs-actions.pod:4186
27233 #: ../src/guestfs-actions.pod:4203 ../src/guestfs-actions.pod:4223
27234 #: ../src/guestfs-actions.pod:4278 ../src/guestfs-actions.pod:4296
27235 #: ../src/guestfs-actions.pod:4401 ../src/guestfs-actions.pod:4800
27236 #: ../src/guestfs-actions.pod:5695 ../src/guestfs-actions.pod:6330
27237 #: ../src/guestfs-actions.pod:6456 ../src/guestfs-actions.pod:6570
27238 #: ../src/guestfs-actions.pod:7325 ../src/guestfs-actions.pod:7386
27239 #: ../src/guestfs-actions.pod:7441 ../src/guestfs-actions.pod:7587
27240 #: ../src/guestfs-actions.pod:7611 ../src/guestfs-actions.pod:8207
27241 #: ../src/guestfs-actions.pod:8227 ../src/guestfs-actions.pod:8274
27242 #: ../src/guestfs-actions.pod:8468 ../src/guestfs-actions.pod:8487
27243 #: ../src/guestfs-actions.pod:8578 ../src/guestfs-actions.pod:8597
27244 #: ../src/guestfs-actions.pod:8643 ../src/guestfs-actions.pod:8662
27246 "This function returns a NULL-terminated array of strings (like L<environ(3)"
27247 ">), or NULL if there was an error. I<The caller must free the strings and "
27248 "the array after use>."
27252 #: ../src/guestfs-actions.pod:531 ../src/guestfs-actions.pod:1121
27253 #: ../src/guestfs-actions.pod:1139 ../src/guestfs-actions.pod:1908
27254 #: ../src/guestfs-actions.pod:3950 ../src/guestfs-actions.pod:3981
27255 #: ../src/guestfs-actions.pod:4644 ../src/guestfs-actions.pod:4691
27256 #: ../src/guestfs-actions.pod:5016 ../src/guestfs-actions.pod:5049
27257 #: ../src/guestfs-actions.pod:5212 ../src/guestfs-actions.pod:5699
27258 #: ../src/guestfs-actions.pod:6271 ../src/guestfs-actions.pod:6668
27259 #: ../src/guestfs-actions.pod:6682 ../src/guestfs-actions.pod:6694
27260 #: ../src/guestfs-actions.pod:7172 ../src/guestfs-actions.pod:7945
27261 #: ../src/guestfs-actions.pod:7958 ../src/guestfs-actions.pod:8191
27262 #: ../src/guestfs-actions.pod:8456
27263 msgid "(Added in 0.8)"
27264 msgstr "(Додано у 0.8)"
27267 #: ../src/guestfs-actions.pod:533
27268 msgid "guestfs_aug_match"
27269 msgstr "guestfs_aug_match"
27272 #: ../src/guestfs-actions.pod:535
27276 " guestfs_aug_match (guestfs_h *g,\n"
27277 " const char *augpath);\n"
27281 " guestfs_aug_match (guestfs_h *g,\n"
27282 " const char *augpath);\n"
27286 #: ../src/guestfs-actions.pod:549
27287 msgid "guestfs_aug_mv"
27288 msgstr "guestfs_aug_mv"
27291 #: ../src/guestfs-actions.pod:551
27295 " guestfs_aug_mv (guestfs_h *g,\n"
27296 " const char *src,\n"
27297 " const char *dest);\n"
27301 " guestfs_aug_mv (guestfs_h *g,\n"
27302 " const char *src,\n"
27303 " const char *dest);\n"
27307 #: ../src/guestfs-actions.pod:563
27308 msgid "guestfs_aug_rm"
27309 msgstr "guestfs_aug_rm"
27312 #: ../src/guestfs-actions.pod:565
27316 " guestfs_aug_rm (guestfs_h *g,\n"
27317 " const char *augpath);\n"
27321 " guestfs_aug_rm (guestfs_h *g,\n"
27322 " const char *augpath);\n"
27326 #: ../src/guestfs-actions.pod:577
27327 msgid "guestfs_aug_save"
27328 msgstr "guestfs_aug_save"
27331 #: ../src/guestfs-actions.pod:579
27335 " guestfs_aug_save (guestfs_h *g);\n"
27339 " guestfs_aug_save (guestfs_h *g);\n"
27343 #: ../src/guestfs-actions.pod:584
27345 "The flags which were passed to C<guestfs_aug_init> affect exactly how files "
27350 #: ../src/guestfs-actions.pod:591
27351 msgid "guestfs_aug_set"
27352 msgstr "guestfs_aug_set"
27355 #: ../src/guestfs-actions.pod:593
27359 " guestfs_aug_set (guestfs_h *g,\n"
27360 " const char *augpath,\n"
27361 " const char *val);\n"
27365 " guestfs_aug_set (guestfs_h *g,\n"
27366 " const char *augpath,\n"
27367 " const char *val);\n"
27371 #: ../src/guestfs-actions.pod:600
27373 "In the Augeas API, it is possible to clear a node by setting the value to "
27374 "NULL. Due to an oversight in the libguestfs API you cannot do that with "
27375 "this call. Instead you must use the C<guestfs_aug_clear> call."
27379 #: ../src/guestfs-actions.pod:609
27380 msgid "guestfs_available"
27381 msgstr "guestfs_available"
27384 #: ../src/guestfs-actions.pod:611
27388 " guestfs_available (guestfs_h *g,\n"
27389 " char *const *groups);\n"
27393 " guestfs_available (guestfs_h *g,\n"
27394 " char *const *groups);\n"
27398 #: ../src/guestfs-actions.pod:619
27400 "The libguestfs groups, and the functions that those groups correspond to, "
27401 "are listed in L<guestfs(3)/AVAILABILITY>. You can also fetch this list at "
27402 "runtime by calling C<guestfs_available_all_groups>."
27406 #: ../src/guestfs-actions.pod:643
27407 msgid "You must call C<guestfs_launch> before calling this function."
27411 #: ../src/guestfs-actions.pod:665
27413 "This call was added in version C<1.0.80>. In previous versions of "
27414 "libguestfs all you could do would be to speculatively execute a command to "
27415 "find out if the daemon implemented it. See also C<guestfs_version>."
27419 #: ../src/guestfs-actions.pod:674 ../src/guestfs-actions.pod:1653
27420 msgid "(Added in 1.0.80)"
27421 msgstr "(Додано у 1.0.80)"
27424 #: ../src/guestfs-actions.pod:676
27425 msgid "guestfs_available_all_groups"
27426 msgstr "guestfs_available_all_groups"
27429 #: ../src/guestfs-actions.pod:678
27433 " guestfs_available_all_groups (guestfs_h *g);\n"
27437 " guestfs_available_all_groups (guestfs_h *g);\n"
27441 #: ../src/guestfs-actions.pod:681
27443 "This command returns a list of all optional groups that this daemon knows "
27444 "about. Note this returns both supported and unsupported groups. To find "
27445 "out which ones the daemon can actually support you have to call "
27446 "C<guestfs_available> on each member of the returned list."
27450 #: ../src/guestfs-actions.pod:687
27451 msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>."
27455 #: ../src/guestfs-actions.pod:693
27456 msgid "(Added in 1.3.15)"
27457 msgstr "(Додано у 1.3.15)"
27460 #: ../src/guestfs-actions.pod:695
27461 msgid "guestfs_base64_in"
27462 msgstr "guestfs_base64_in"
27465 #: ../src/guestfs-actions.pod:697
27469 " guestfs_base64_in (guestfs_h *g,\n"
27470 " const char *base64file,\n"
27471 " const char *filename);\n"
27475 " guestfs_base64_in (guestfs_h *g,\n"
27476 " const char *base64file,\n"
27477 " const char *filename);\n"
27481 #: ../src/guestfs-actions.pod:707 ../src/guestfs-actions.pod:721
27482 msgid "(Added in 1.3.5)"
27483 msgstr "(Додано у 1.3.5)"
27486 #: ../src/guestfs-actions.pod:709
27487 msgid "guestfs_base64_out"
27488 msgstr "guestfs_base64_out"
27491 #: ../src/guestfs-actions.pod:711
27495 " guestfs_base64_out (guestfs_h *g,\n"
27496 " const char *filename,\n"
27497 " const char *base64file);\n"
27501 " guestfs_base64_out (guestfs_h *g,\n"
27502 " const char *filename,\n"
27503 " const char *base64file);\n"
27507 #: ../src/guestfs-actions.pod:723
27508 msgid "guestfs_blockdev_flushbufs"
27509 msgstr "guestfs_blockdev_flushbufs"
27512 #: ../src/guestfs-actions.pod:725
27516 " guestfs_blockdev_flushbufs (guestfs_h *g,\n"
27517 " const char *device);\n"
27521 " guestfs_blockdev_flushbufs (guestfs_h *g,\n"
27522 " const char *device);\n"
27526 #: ../src/guestfs-actions.pod:736 ../src/guestfs-actions.pod:753
27527 #: ../src/guestfs-actions.pod:768 ../src/guestfs-actions.pod:784
27528 #: ../src/guestfs-actions.pod:802 ../src/guestfs-actions.pod:821
27529 #: ../src/guestfs-actions.pod:835 ../src/guestfs-actions.pod:853
27530 #: ../src/guestfs-actions.pod:867 ../src/guestfs-actions.pod:881
27531 msgid "(Added in 0.9.3)"
27532 msgstr "(Додано у 0.9.3)"
27535 #: ../src/guestfs-actions.pod:738
27536 msgid "guestfs_blockdev_getbsz"
27537 msgstr "guestfs_blockdev_getbsz"
27540 #: ../src/guestfs-actions.pod:740
27544 " guestfs_blockdev_getbsz (guestfs_h *g,\n"
27545 " const char *device);\n"
27549 " guestfs_blockdev_getbsz (guestfs_h *g,\n"
27550 " const char *device);\n"
27554 #: ../src/guestfs-actions.pod:755
27555 msgid "guestfs_blockdev_getro"
27556 msgstr "guestfs_blockdev_getro"
27559 #: ../src/guestfs-actions.pod:757
27563 " guestfs_blockdev_getro (guestfs_h *g,\n"
27564 " const char *device);\n"
27568 " guestfs_blockdev_getro (guestfs_h *g,\n"
27569 " const char *device);\n"
27573 #: ../src/guestfs-actions.pod:766 ../src/guestfs-actions.pod:1891
27574 #: ../src/guestfs-actions.pod:1906 ../src/guestfs-actions.pod:2395
27575 #: ../src/guestfs-actions.pod:2406 ../src/guestfs-actions.pod:2478
27576 #: ../src/guestfs-actions.pod:2504 ../src/guestfs-actions.pod:2544
27577 #: ../src/guestfs-actions.pod:2559 ../src/guestfs-actions.pod:2595
27578 #: ../src/guestfs-actions.pod:2618 ../src/guestfs-actions.pod:3693
27579 #: ../src/guestfs-actions.pod:3709 ../src/guestfs-actions.pod:3727
27580 #: ../src/guestfs-actions.pod:3889 ../src/guestfs-actions.pod:3903
27581 #: ../src/guestfs-actions.pod:3918 ../src/guestfs-actions.pod:3932
27582 #: ../src/guestfs-actions.pod:3948 ../src/guestfs-actions.pod:3963
27583 #: ../src/guestfs-actions.pod:3979 ../src/guestfs-actions.pod:3993
27584 #: ../src/guestfs-actions.pod:4006 ../src/guestfs-actions.pod:4020
27585 #: ../src/guestfs-actions.pod:4035 ../src/guestfs-actions.pod:4050
27586 #: ../src/guestfs-actions.pod:4063 ../src/guestfs-actions.pod:4077
27587 #: ../src/guestfs-actions.pod:5933
27588 msgid "This function returns a C truth value on success or -1 on error."
27592 #: ../src/guestfs-actions.pod:770
27593 msgid "guestfs_blockdev_getsize64"
27594 msgstr "guestfs_blockdev_getsize64"
27597 #: ../src/guestfs-actions.pod:772
27601 " guestfs_blockdev_getsize64 (guestfs_h *g,\n"
27602 " const char *device);\n"
27606 " guestfs_blockdev_getsize64 (guestfs_h *g,\n"
27607 " const char *device);\n"
27611 #: ../src/guestfs-actions.pod:778
27612 msgid "See also C<guestfs_blockdev_getsz>."
27616 #: ../src/guestfs-actions.pod:786
27617 msgid "guestfs_blockdev_getss"
27618 msgstr "guestfs_blockdev_getss"
27621 #: ../src/guestfs-actions.pod:788
27625 " guestfs_blockdev_getss (guestfs_h *g,\n"
27626 " const char *device);\n"
27630 " guestfs_blockdev_getss (guestfs_h *g,\n"
27631 " const char *device);\n"
27635 #: ../src/guestfs-actions.pod:795
27637 "(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for "
27642 #: ../src/guestfs-actions.pod:804
27643 msgid "guestfs_blockdev_getsz"
27644 msgstr "guestfs_blockdev_getsz"
27647 #: ../src/guestfs-actions.pod:806
27651 " guestfs_blockdev_getsz (guestfs_h *g,\n"
27652 " const char *device);\n"
27656 " guestfs_blockdev_getsz (guestfs_h *g,\n"
27657 " const char *device);\n"
27661 #: ../src/guestfs-actions.pod:813
27663 "See also C<guestfs_blockdev_getss> for the real sector size of the device, "
27664 "and C<guestfs_blockdev_getsize64> for the more useful I<size in bytes>."
27668 #: ../src/guestfs-actions.pod:823
27669 msgid "guestfs_blockdev_rereadpt"
27670 msgstr "guestfs_blockdev_rereadpt"
27673 #: ../src/guestfs-actions.pod:825
27677 " guestfs_blockdev_rereadpt (guestfs_h *g,\n"
27678 " const char *device);\n"
27682 " guestfs_blockdev_rereadpt (guestfs_h *g,\n"
27683 " const char *device);\n"
27687 #: ../src/guestfs-actions.pod:837
27688 msgid "guestfs_blockdev_setbsz"
27689 msgstr "guestfs_blockdev_setbsz"
27692 #: ../src/guestfs-actions.pod:839
27696 " guestfs_blockdev_setbsz (guestfs_h *g,\n"
27697 " const char *device,\n"
27698 " int blocksize);\n"
27702 " guestfs_blockdev_setbsz (guestfs_h *g,\n"
27703 " const char *device,\n"
27704 " int blocksize);\n"
27708 #: ../src/guestfs-actions.pod:855
27709 msgid "guestfs_blockdev_setro"
27710 msgstr "guestfs_blockdev_setro"
27713 #: ../src/guestfs-actions.pod:857
27717 " guestfs_blockdev_setro (guestfs_h *g,\n"
27718 " const char *device);\n"
27722 " guestfs_blockdev_setro (guestfs_h *g,\n"
27723 " const char *device);\n"
27727 #: ../src/guestfs-actions.pod:869
27728 msgid "guestfs_blockdev_setrw"
27729 msgstr "guestfs_blockdev_setrw"
27732 #: ../src/guestfs-actions.pod:871
27736 " guestfs_blockdev_setrw (guestfs_h *g,\n"
27737 " const char *device);\n"
27741 " guestfs_blockdev_setrw (guestfs_h *g,\n"
27742 " const char *device);\n"
27746 #: ../src/guestfs-actions.pod:883
27747 msgid "guestfs_btrfs_filesystem_resize"
27748 msgstr "guestfs_btrfs_filesystem_resize"
27751 #: ../src/guestfs-actions.pod:885
27755 " guestfs_btrfs_filesystem_resize (guestfs_h *g,\n"
27756 " const char *mountpoint,\n"
27761 " guestfs_btrfs_filesystem_resize (guestfs_h *g,\n"
27762 " const char *mountpoint,\n"
27767 #: ../src/guestfs-actions.pod:895
27770 " GUESTFS_BTRFS_FILESYSTEM_RESIZE_SIZE, int64_t size,\n"
27773 " GUESTFS_BTRFS_FILESYSTEM_RESIZE_SIZE, int64_t size,\n"
27777 #: ../src/guestfs-actions.pod:918
27778 msgid "(Added in 1.11.17)"
27779 msgstr "(Додано у 1.11.17)"
27782 #: ../src/guestfs-actions.pod:920
27783 msgid "guestfs_btrfs_filesystem_resize_va"
27784 msgstr "guestfs_btrfs_filesystem_resize_va"
27787 #: ../src/guestfs-actions.pod:922
27791 " guestfs_btrfs_filesystem_resize_va (guestfs_h *g,\n"
27792 " const char *mountpoint,\n"
27793 " va_list args);\n"
27797 " guestfs_btrfs_filesystem_resize_va (guestfs_h *g,\n"
27798 " const char *mountpoint,\n"
27799 " va_list args);\n"
27803 #: ../src/guestfs-actions.pod:927
27804 msgid "This is the \"va_list variant\" of L</guestfs_btrfs_filesystem_resize>."
27808 #: ../src/guestfs-actions.pod:931
27809 msgid "guestfs_btrfs_filesystem_resize_argv"
27810 msgstr "guestfs_btrfs_filesystem_resize_argv"
27813 #: ../src/guestfs-actions.pod:933
27817 " guestfs_btrfs_filesystem_resize_argv (guestfs_h *g,\n"
27818 " const char *mountpoint,\n"
27819 " const struct guestfs_btrfs_filesystem_resize_argv *optargs);\n"
27823 " guestfs_btrfs_filesystem_resize_argv (guestfs_h *g,\n"
27824 " const char *mountpoint,\n"
27825 " const struct guestfs_btrfs_filesystem_resize_argv *optargs);\n"
27829 #: ../src/guestfs-actions.pod:938
27830 msgid "This is the \"argv variant\" of L</guestfs_btrfs_filesystem_resize>."
27834 #: ../src/guestfs-actions.pod:942
27835 msgid "guestfs_case_sensitive_path"
27839 #: ../src/guestfs-actions.pod:944
27843 " guestfs_case_sensitive_path (guestfs_h *g,\n"
27844 " const char *path);\n"
27849 #: ../src/guestfs-actions.pod:970
27851 "Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\") might return C<"
27852 "\"/WINDOWS/system32\"> (the exact return value would depend on details of "
27853 "how the directories were originally created under Windows)."
27857 #: ../src/guestfs-actions.pod:978
27858 msgid "See also C<guestfs_realpath>."
27862 #: ../src/guestfs-actions.pod:983 ../src/guestfs-actions.pod:8125
27863 msgid "(Added in 1.0.75)"
27864 msgstr "(Додано у 1.0.75)"
27867 #: ../src/guestfs-actions.pod:985
27868 msgid "guestfs_cat"
27872 #: ../src/guestfs-actions.pod:987
27876 " guestfs_cat (guestfs_h *g,\n"
27877 " const char *path);\n"
27882 #: ../src/guestfs-actions.pod:993
27884 "Note that this function cannot correctly handle binary files (specifically, "
27885 "files containing C<\\0> character which is treated as end of string). For "
27886 "those you need to use the C<guestfs_read_file> or C<guestfs_download> "
27887 "functions which have a more complex interface."
27891 #: ../src/guestfs-actions.pod:1004 ../src/guestfs-actions.pod:4207
27892 #: ../src/guestfs-actions.pod:4300 ../src/guestfs-actions.pod:4317
27893 #: ../src/guestfs-actions.pod:4405 ../src/guestfs-actions.pod:4804
27894 #: ../src/guestfs-actions.pod:4818 ../src/guestfs-actions.pod:6334
27895 #: ../src/guestfs-actions.pod:6348 ../src/guestfs-actions.pod:8278
27896 #: ../src/guestfs-actions.pod:8292
27897 msgid "(Added in 0.4)"
27898 msgstr "(Додано у 0.4)"
27901 #: ../src/guestfs-actions.pod:1006
27902 msgid "guestfs_checksum"
27906 #: ../src/guestfs-actions.pod:1008
27910 " guestfs_checksum (guestfs_h *g,\n"
27911 " const char *csumtype,\n"
27912 " const char *path);\n"
27917 #: ../src/guestfs-actions.pod:1054
27918 msgid "To get the checksum for a device, use C<guestfs_checksum_device>."
27922 #: ../src/guestfs-actions.pod:1056
27923 msgid "To get the checksums for many files, use C<guestfs_checksums_out>."
27927 #: ../src/guestfs-actions.pod:1061 ../src/guestfs-actions.pod:1728
27928 #: ../src/guestfs-actions.pod:2586 ../src/guestfs-actions.pod:3905
27929 #: ../src/guestfs-actions.pod:3934 ../src/guestfs-actions.pod:3995
27930 #: ../src/guestfs-actions.pod:4022 ../src/guestfs-actions.pod:7981
27931 msgid "(Added in 1.0.2)"
27932 msgstr "(Додано у 1.0.2)"
27935 #: ../src/guestfs-actions.pod:1063
27936 msgid "guestfs_checksum_device"
27940 #: ../src/guestfs-actions.pod:1065
27944 " guestfs_checksum_device (guestfs_h *g,\n"
27945 " const char *csumtype,\n"
27946 " const char *device);\n"
27951 #: ../src/guestfs-actions.pod:1070
27953 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
27954 "device named C<device>. For the types of checksums supported see the "
27955 "C<guestfs_checksum> command."
27959 #: ../src/guestfs-actions.pod:1077 ../src/guestfs-actions.pod:5766
27960 #: ../src/guestfs-actions.pod:5901 ../src/guestfs-actions.pod:5935
27961 #: ../src/guestfs-actions.pod:5953 ../src/guestfs-actions.pod:6135
27962 #: ../src/guestfs-actions.pod:7890 ../src/guestfs-actions.pod:7904
27963 #: ../src/guestfs-actions.pod:8304
27964 msgid "(Added in 1.3.2)"
27965 msgstr "(Додано у 1.3.2)"
27968 #: ../src/guestfs-actions.pod:1079
27969 msgid "guestfs_checksums_out"
27973 #: ../src/guestfs-actions.pod:1081
27977 " guestfs_checksums_out (guestfs_h *g,\n"
27978 " const char *csumtype,\n"
27979 " const char *directory,\n"
27980 " const char *sumsfile);\n"
27985 #: ../src/guestfs-actions.pod:1101
27986 msgid "(Added in 1.3.7)"
27987 msgstr "(Додано у 1.3.7)"
27990 #: ../src/guestfs-actions.pod:1103
27991 msgid "guestfs_chmod"
27995 #: ../src/guestfs-actions.pod:1105
27999 " guestfs_chmod (guestfs_h *g,\n"
28001 " const char *path);\n"
28006 #: ../src/guestfs-actions.pod:1123
28007 msgid "guestfs_chown"
28011 #: ../src/guestfs-actions.pod:1125
28015 " guestfs_chown (guestfs_h *g,\n"
28018 " const char *path);\n"
28023 #: ../src/guestfs-actions.pod:1141
28024 msgid "guestfs_command"
28028 #: ../src/guestfs-actions.pod:1143
28032 " guestfs_command (guestfs_h *g,\n"
28033 " char *const *arguments);\n"
28038 #: ../src/guestfs-actions.pod:1152
28040 "The single parameter is an argv-style list of arguments. The first element "
28041 "is the name of the program to run. Subsequent elements are parameters. The "
28042 "list must be non-empty (ie. must contain a program name). Note that the "
28043 "command runs directly, and is I<not> invoked via the shell (see "
28048 #: ../src/guestfs-actions.pod:1183 ../src/guestfs-actions.pod:1203
28049 #: ../src/guestfs-actions.pod:2027
28050 msgid "(Added in 0.9.1)"
28051 msgstr "(Додано у 0.9.1)"
28054 #: ../src/guestfs-actions.pod:1185
28055 msgid "guestfs_command_lines"
28059 #: ../src/guestfs-actions.pod:1187
28063 " guestfs_command_lines (guestfs_h *g,\n"
28064 " char *const *arguments);\n"
28069 #: ../src/guestfs-actions.pod:1191
28071 "This is the same as C<guestfs_command>, but splits the result into a list of "
28076 #: ../src/guestfs-actions.pod:1194
28077 msgid "See also: C<guestfs_sh_lines>"
28081 #: ../src/guestfs-actions.pod:1205
28082 msgid "guestfs_compress_device_out"
28086 #: ../src/guestfs-actions.pod:1207
28090 " guestfs_compress_device_out (guestfs_h *g,\n"
28091 " const char *ctype,\n"
28092 " const char *device,\n"
28093 " const char *zdevice,\n"
28099 #: ../src/guestfs-actions.pod:1219
28102 " GUESTFS_COMPRESS_DEVICE_OUT_LEVEL, int level,\n"
28107 #: ../src/guestfs-actions.pod:1224
28109 "The C<ctype> and optional C<level> parameters have the same meaning as in "
28110 "C<guestfs_compress_out>."
28114 #: ../src/guestfs-actions.pod:1229 ../src/guestfs-actions.pod:1288
28115 #: ../src/guestfs-actions.pod:2572 ../src/guestfs-actions.pod:7051
28116 msgid "(Added in 1.13.15)"
28120 #: ../src/guestfs-actions.pod:1231
28121 msgid "guestfs_compress_device_out_va"
28125 #: ../src/guestfs-actions.pod:1233
28129 " guestfs_compress_device_out_va (guestfs_h *g,\n"
28130 " const char *ctype,\n"
28131 " const char *device,\n"
28132 " const char *zdevice,\n"
28133 " va_list args);\n"
28138 #: ../src/guestfs-actions.pod:1240
28139 msgid "This is the \"va_list variant\" of L</guestfs_compress_device_out>."
28143 #: ../src/guestfs-actions.pod:1244
28144 msgid "guestfs_compress_device_out_argv"
28148 #: ../src/guestfs-actions.pod:1246
28152 " guestfs_compress_device_out_argv (guestfs_h *g,\n"
28153 " const char *ctype,\n"
28154 " const char *device,\n"
28155 " const char *zdevice,\n"
28156 " const struct guestfs_compress_device_out_argv *optargs);\n"
28161 #: ../src/guestfs-actions.pod:1253
28162 msgid "This is the \"argv variant\" of L</guestfs_compress_device_out>."
28166 #: ../src/guestfs-actions.pod:1257
28167 msgid "guestfs_compress_out"
28171 #: ../src/guestfs-actions.pod:1259
28175 " guestfs_compress_out (guestfs_h *g,\n"
28176 " const char *ctype,\n"
28177 " const char *file,\n"
28178 " const char *zfile,\n"
28184 #: ../src/guestfs-actions.pod:1271
28187 " GUESTFS_COMPRESS_OUT_LEVEL, int level,\n"
28192 #: ../src/guestfs-actions.pod:1290
28193 msgid "guestfs_compress_out_va"
28197 #: ../src/guestfs-actions.pod:1292
28201 " guestfs_compress_out_va (guestfs_h *g,\n"
28202 " const char *ctype,\n"
28203 " const char *file,\n"
28204 " const char *zfile,\n"
28205 " va_list args);\n"
28210 #: ../src/guestfs-actions.pod:1299
28211 msgid "This is the \"va_list variant\" of L</guestfs_compress_out>."
28215 #: ../src/guestfs-actions.pod:1303
28216 msgid "guestfs_compress_out_argv"
28220 #: ../src/guestfs-actions.pod:1305
28224 " guestfs_compress_out_argv (guestfs_h *g,\n"
28225 " const char *ctype,\n"
28226 " const char *file,\n"
28227 " const char *zfile,\n"
28228 " const struct guestfs_compress_out_argv *optargs);\n"
28233 #: ../src/guestfs-actions.pod:1312
28234 msgid "This is the \"argv variant\" of L</guestfs_compress_out>."
28238 #: ../src/guestfs-actions.pod:1316
28239 msgid "guestfs_config"
28243 #: ../src/guestfs-actions.pod:1318
28247 " guestfs_config (guestfs_h *g,\n"
28248 " const char *qemuparam,\n"
28249 " const char *qemuvalue);\n"
28254 #: ../src/guestfs-actions.pod:1336
28255 msgid "guestfs_copy_device_to_device"
28259 #: ../src/guestfs-actions.pod:1338
28263 " guestfs_copy_device_to_device (guestfs_h *g,\n"
28264 " const char *src,\n"
28265 " const char *dest,\n"
28271 #: ../src/guestfs-actions.pod:1349
28274 " GUESTFS_COPY_DEVICE_TO_DEVICE_SRCOFFSET, int64_t srcoffset,\n"
28275 " GUESTFS_COPY_DEVICE_TO_DEVICE_DESTOFFSET, int64_t destoffset,\n"
28276 " GUESTFS_COPY_DEVICE_TO_DEVICE_SIZE, int64_t size,\n"
28281 #: ../src/guestfs-actions.pod:1353
28283 "The four calls C<guestfs_copy_device_to_device>, "
28284 "C<guestfs_copy_device_to_file>, C<guestfs_copy_file_to_device>, and "
28285 "C<guestfs_copy_file_to_file> let you copy from a source (device|file) to a "
28286 "destination (device|file)."
28290 #: ../src/guestfs-actions.pod:1374 ../src/guestfs-actions.pod:1427
28291 #: ../src/guestfs-actions.pod:1480 ../src/guestfs-actions.pod:1538
28292 #: ../src/guestfs-actions.pod:1592 ../src/guestfs-actions.pod:1723
28293 #: ../src/guestfs-actions.pod:1754 ../src/guestfs-actions.pod:1799
28294 #: ../src/guestfs-actions.pod:2176 ../src/guestfs-actions.pod:2198
28295 #: ../src/guestfs-actions.pod:4105 ../src/guestfs-actions.pod:7976
28296 #: ../src/guestfs-actions.pod:8010 ../src/guestfs-actions.pod:8517
28297 #: ../src/guestfs-actions.pod:8540
28299 "This long-running command can generate progress notification messages so "
28300 "that the caller can display a progress bar or indicator. To receive these "
28301 "messages, the caller must register a progress event callback. See L<guestfs"
28302 "(3)/GUESTFS_EVENT_PROGRESS>."
28306 #: ../src/guestfs-actions.pod:1379 ../src/guestfs-actions.pod:1432
28307 #: ../src/guestfs-actions.pod:1485 ../src/guestfs-actions.pod:1543
28308 #: ../src/guestfs-actions.pod:6191
28310 #| msgid "(Added in 1.3.5)"
28311 msgid "(Added in 1.13.25)"
28312 msgstr "(Додано у 1.3.5)"
28315 #: ../src/guestfs-actions.pod:1381
28316 msgid "guestfs_copy_device_to_device_va"
28320 #: ../src/guestfs-actions.pod:1383
28324 " guestfs_copy_device_to_device_va (guestfs_h *g,\n"
28325 " const char *src,\n"
28326 " const char *dest,\n"
28327 " va_list args);\n"
28332 #: ../src/guestfs-actions.pod:1389
28333 msgid "This is the \"va_list variant\" of L</guestfs_copy_device_to_device>."
28337 #: ../src/guestfs-actions.pod:1393
28338 msgid "guestfs_copy_device_to_device_argv"
28342 #: ../src/guestfs-actions.pod:1395
28346 " guestfs_copy_device_to_device_argv (guestfs_h *g,\n"
28347 " const char *src,\n"
28348 " const char *dest,\n"
28349 " const struct guestfs_copy_device_to_device_argv *optargs);\n"
28354 #: ../src/guestfs-actions.pod:1401
28355 msgid "This is the \"argv variant\" of L</guestfs_copy_device_to_device>."
28359 #: ../src/guestfs-actions.pod:1405
28360 msgid "guestfs_copy_device_to_file"
28364 #: ../src/guestfs-actions.pod:1407
28368 " guestfs_copy_device_to_file (guestfs_h *g,\n"
28369 " const char *src,\n"
28370 " const char *dest,\n"
28376 #: ../src/guestfs-actions.pod:1418
28379 " GUESTFS_COPY_DEVICE_TO_FILE_SRCOFFSET, int64_t srcoffset,\n"
28380 " GUESTFS_COPY_DEVICE_TO_FILE_DESTOFFSET, int64_t destoffset,\n"
28381 " GUESTFS_COPY_DEVICE_TO_FILE_SIZE, int64_t size,\n"
28386 #: ../src/guestfs-actions.pod:1422 ../src/guestfs-actions.pod:1475
28387 #: ../src/guestfs-actions.pod:1528
28389 "See C<guestfs_copy_device_to_device> for a general overview of this call."
28393 #: ../src/guestfs-actions.pod:1434
28394 msgid "guestfs_copy_device_to_file_va"
28398 #: ../src/guestfs-actions.pod:1436
28402 " guestfs_copy_device_to_file_va (guestfs_h *g,\n"
28403 " const char *src,\n"
28404 " const char *dest,\n"
28405 " va_list args);\n"
28410 #: ../src/guestfs-actions.pod:1442
28411 msgid "This is the \"va_list variant\" of L</guestfs_copy_device_to_file>."
28415 #: ../src/guestfs-actions.pod:1446
28416 msgid "guestfs_copy_device_to_file_argv"
28420 #: ../src/guestfs-actions.pod:1448
28424 " guestfs_copy_device_to_file_argv (guestfs_h *g,\n"
28425 " const char *src,\n"
28426 " const char *dest,\n"
28427 " const struct guestfs_copy_device_to_file_argv *optargs);\n"
28432 #: ../src/guestfs-actions.pod:1454
28433 msgid "This is the \"argv variant\" of L</guestfs_copy_device_to_file>."
28437 #: ../src/guestfs-actions.pod:1458
28438 msgid "guestfs_copy_file_to_device"
28442 #: ../src/guestfs-actions.pod:1460
28446 " guestfs_copy_file_to_device (guestfs_h *g,\n"
28447 " const char *src,\n"
28448 " const char *dest,\n"
28454 #: ../src/guestfs-actions.pod:1471
28457 " GUESTFS_COPY_FILE_TO_DEVICE_SRCOFFSET, int64_t srcoffset,\n"
28458 " GUESTFS_COPY_FILE_TO_DEVICE_DESTOFFSET, int64_t destoffset,\n"
28459 " GUESTFS_COPY_FILE_TO_DEVICE_SIZE, int64_t size,\n"
28464 #: ../src/guestfs-actions.pod:1487
28465 msgid "guestfs_copy_file_to_device_va"
28469 #: ../src/guestfs-actions.pod:1489
28473 " guestfs_copy_file_to_device_va (guestfs_h *g,\n"
28474 " const char *src,\n"
28475 " const char *dest,\n"
28476 " va_list args);\n"
28481 #: ../src/guestfs-actions.pod:1495
28482 msgid "This is the \"va_list variant\" of L</guestfs_copy_file_to_device>."
28486 #: ../src/guestfs-actions.pod:1499
28487 msgid "guestfs_copy_file_to_device_argv"
28491 #: ../src/guestfs-actions.pod:1501
28495 " guestfs_copy_file_to_device_argv (guestfs_h *g,\n"
28496 " const char *src,\n"
28497 " const char *dest,\n"
28498 " const struct guestfs_copy_file_to_device_argv *optargs);\n"
28503 #: ../src/guestfs-actions.pod:1507
28504 msgid "This is the \"argv variant\" of L</guestfs_copy_file_to_device>."
28508 #: ../src/guestfs-actions.pod:1511
28509 msgid "guestfs_copy_file_to_file"
28513 #: ../src/guestfs-actions.pod:1513
28517 " guestfs_copy_file_to_file (guestfs_h *g,\n"
28518 " const char *src,\n"
28519 " const char *dest,\n"
28525 #: ../src/guestfs-actions.pod:1524
28528 " GUESTFS_COPY_FILE_TO_FILE_SRCOFFSET, int64_t srcoffset,\n"
28529 " GUESTFS_COPY_FILE_TO_FILE_DESTOFFSET, int64_t destoffset,\n"
28530 " GUESTFS_COPY_FILE_TO_FILE_SIZE, int64_t size,\n"
28535 #: ../src/guestfs-actions.pod:1531
28537 "This is B<not> the function you want for copying files. This is for copying "
28538 "blocks within existing files. See C<guestfs_cp>, C<guestfs_cp_a> and "
28539 "C<guestfs_mv> for general file copying and moving functions."
28543 #: ../src/guestfs-actions.pod:1545
28544 msgid "guestfs_copy_file_to_file_va"
28548 #: ../src/guestfs-actions.pod:1547
28552 " guestfs_copy_file_to_file_va (guestfs_h *g,\n"
28553 " const char *src,\n"
28554 " const char *dest,\n"
28555 " va_list args);\n"
28560 #: ../src/guestfs-actions.pod:1553
28561 msgid "This is the \"va_list variant\" of L</guestfs_copy_file_to_file>."
28565 #: ../src/guestfs-actions.pod:1557
28566 msgid "guestfs_copy_file_to_file_argv"
28570 #: ../src/guestfs-actions.pod:1559
28574 " guestfs_copy_file_to_file_argv (guestfs_h *g,\n"
28575 " const char *src,\n"
28576 " const char *dest,\n"
28577 " const struct guestfs_copy_file_to_file_argv *optargs);\n"
28582 #: ../src/guestfs-actions.pod:1565
28583 msgid "This is the \"argv variant\" of L</guestfs_copy_file_to_file>."
28587 #: ../src/guestfs-actions.pod:1569
28588 msgid "guestfs_copy_size"
28592 #: ../src/guestfs-actions.pod:1571
28596 " guestfs_copy_size (guestfs_h *g,\n"
28597 " const char *src,\n"
28598 " const char *dest,\n"
28599 " int64_t size);\n"
28604 #: ../src/guestfs-actions.pod:1577 ../src/guestfs-actions.pod:1634
28606 "I<This function is deprecated.> In new code, use the L</"
28607 "guestfs_copy_device_to_device> call instead."
28611 #: ../src/guestfs-actions.pod:1597 ../src/guestfs-actions.pod:4831
28612 #: ../src/guestfs-actions.pod:6361 ../src/guestfs-actions.pod:8211
28613 #: ../src/guestfs-actions.pod:8231 ../src/guestfs-actions.pod:8317
28614 msgid "(Added in 1.0.87)"
28615 msgstr "(Додано у 1.0.87)"
28618 #: ../src/guestfs-actions.pod:1599
28623 #: ../src/guestfs-actions.pod:1601
28627 " guestfs_cp (guestfs_h *g,\n"
28628 " const char *src,\n"
28629 " const char *dest);\n"
28634 #: ../src/guestfs-actions.pod:1611 ../src/guestfs-actions.pod:1625
28635 #: ../src/guestfs-actions.pod:1705 ../src/guestfs-actions.pod:1779
28636 #: ../src/guestfs-actions.pod:1893 ../src/guestfs-actions.pod:5713
28637 #: ../src/guestfs-actions.pod:6205
28638 msgid "(Added in 1.0.18)"
28639 msgstr "(Додано у 1.0.18)"
28642 #: ../src/guestfs-actions.pod:1613
28643 msgid "guestfs_cp_a"
28647 #: ../src/guestfs-actions.pod:1615
28651 " guestfs_cp_a (guestfs_h *g,\n"
28652 " const char *src,\n"
28653 " const char *dest);\n"
28658 #: ../src/guestfs-actions.pod:1627
28663 #: ../src/guestfs-actions.pod:1629
28667 " guestfs_dd (guestfs_h *g,\n"
28668 " const char *src,\n"
28669 " const char *dest);\n"
28674 #: ../src/guestfs-actions.pod:1646
28676 "If the destination is a device, it must be as large or larger than the "
28677 "source file or device, otherwise the copy will fail. This command cannot do "
28678 "partial copies (see C<guestfs_copy_device_to_device>)."
28682 #: ../src/guestfs-actions.pod:1655
28687 #: ../src/guestfs-actions.pod:1657
28691 " guestfs_df (guestfs_h *g);\n"
28696 #: ../src/guestfs-actions.pod:1662 ../src/guestfs-actions.pod:1679
28698 "This command is mostly useful for interactive sessions. It is I<not> "
28699 "intended that you try to parse the output string. Use C<guestfs_statvfs> "
28704 #: ../src/guestfs-actions.pod:1669 ../src/guestfs-actions.pod:1686
28705 #: ../src/guestfs-actions.pod:1804 ../src/guestfs-actions.pod:2811
28706 #: ../src/guestfs-actions.pod:2835 ../src/guestfs-actions.pod:2903
28707 #: ../src/guestfs-actions.pod:5079 ../src/guestfs-actions.pod:5613
28708 #: ../src/guestfs-actions.pod:7594 ../src/guestfs-actions.pod:7618
28709 #: ../src/guestfs-actions.pod:8357 ../src/guestfs-actions.pod:8370
28710 #: ../src/guestfs-actions.pod:8383
28711 msgid "(Added in 1.0.54)"
28712 msgstr "(Додано у 1.0.54)"
28715 #: ../src/guestfs-actions.pod:1671
28716 msgid "guestfs_df_h"
28720 #: ../src/guestfs-actions.pod:1673
28724 " guestfs_df_h (guestfs_h *g);\n"
28729 #: ../src/guestfs-actions.pod:1688
28730 msgid "guestfs_dmesg"
28734 #: ../src/guestfs-actions.pod:1690
28738 " guestfs_dmesg (guestfs_h *g);\n"
28743 #: ../src/guestfs-actions.pod:1697
28745 "Another way to get the same information is to enable verbose messages with "
28746 "C<guestfs_set_verbose> or by setting the environment variable "
28747 "C<LIBGUESTFS_DEBUG=1> before running the program."
28751 #: ../src/guestfs-actions.pod:1707
28752 msgid "guestfs_download"
28756 #: ../src/guestfs-actions.pod:1709
28760 " guestfs_download (guestfs_h *g,\n"
28761 " const char *remotefilename,\n"
28762 " const char *filename);\n"
28767 #: ../src/guestfs-actions.pod:1719
28768 msgid "See also C<guestfs_upload>, C<guestfs_cat>."
28772 #: ../src/guestfs-actions.pod:1730
28773 msgid "guestfs_download_offset"
28777 #: ../src/guestfs-actions.pod:1732
28781 " guestfs_download_offset (guestfs_h *g,\n"
28782 " const char *remotefilename,\n"
28783 " const char *filename,\n"
28784 " int64_t offset,\n"
28785 " int64_t size);\n"
28790 #: ../src/guestfs-actions.pod:1745
28792 "Note that there is no limit on the amount of data that can be downloaded "
28793 "with this call, unlike with C<guestfs_pread>, and this call always reads the "
28794 "full amount unless an error occurs."
28798 #: ../src/guestfs-actions.pod:1750
28799 msgid "See also C<guestfs_download>, C<guestfs_pread>."
28803 #: ../src/guestfs-actions.pod:1759 ../src/guestfs-actions.pod:8015
28804 msgid "(Added in 1.5.17)"
28805 msgstr "(Додано у 1.5.17)"
28808 #: ../src/guestfs-actions.pod:1761
28809 msgid "guestfs_drop_caches"
28813 #: ../src/guestfs-actions.pod:1763
28817 " guestfs_drop_caches (guestfs_h *g,\n"
28818 " int whattodrop);\n"
28823 #: ../src/guestfs-actions.pod:1781
28828 #: ../src/guestfs-actions.pod:1783
28832 " guestfs_du (guestfs_h *g,\n"
28833 " const char *path);\n"
28838 #: ../src/guestfs-actions.pod:1806
28839 msgid "guestfs_e2fsck_f"
28843 #: ../src/guestfs-actions.pod:1808
28847 " guestfs_e2fsck_f (guestfs_h *g,\n"
28848 " const char *device);\n"
28853 #: ../src/guestfs-actions.pod:1816
28855 "This command is only needed because of C<guestfs_resize2fs> (q.v.). "
28856 "Normally you should use C<guestfs_fsck>."
28860 #: ../src/guestfs-actions.pod:1821
28861 msgid "(Added in 1.0.29)"
28862 msgstr "(Додано у 1.0.29)"
28865 #: ../src/guestfs-actions.pod:1823
28866 msgid "guestfs_echo_daemon"
28867 msgstr "guestfs_echo_daemon"
28870 #: ../src/guestfs-actions.pod:1825
28874 " guestfs_echo_daemon (guestfs_h *g,\n"
28875 " char *const *words);\n"
28879 " guestfs_echo_daemon (guestfs_h *g,\n"
28880 " char *const *words);\n"
28884 #: ../src/guestfs-actions.pod:1834
28885 msgid "See also C<guestfs_ping_daemon>."
28889 #: ../src/guestfs-actions.pod:1839 ../src/guestfs-actions.pod:2597
28890 #: ../src/guestfs-actions.pod:7075
28891 msgid "(Added in 1.0.69)"
28892 msgstr "(Додано у 1.0.69)"
28895 #: ../src/guestfs-actions.pod:1841
28896 msgid "guestfs_egrep"
28897 msgstr "guestfs_egrep"
28900 #: ../src/guestfs-actions.pod:1843
28904 " guestfs_egrep (guestfs_h *g,\n"
28905 " const char *regex,\n"
28906 " const char *path);\n"
28910 " guestfs_egrep (guestfs_h *g,\n"
28911 " const char *regex,\n"
28912 " const char *path);\n"
28916 #: ../src/guestfs-actions.pod:1858 ../src/guestfs-actions.pod:1877
28917 #: ../src/guestfs-actions.pod:1934 ../src/guestfs-actions.pod:1980
28918 #: ../src/guestfs-actions.pod:1999 ../src/guestfs-actions.pod:2727
28919 #: ../src/guestfs-actions.pod:2746 ../src/guestfs-actions.pod:2924
28920 #: ../src/guestfs-actions.pod:2937 ../src/guestfs-actions.pod:2952
28921 #: ../src/guestfs-actions.pod:2998 ../src/guestfs-actions.pod:3020
28922 #: ../src/guestfs-actions.pod:3033 ../src/guestfs-actions.pod:4330
28923 #: ../src/guestfs-actions.pod:4344 ../src/guestfs-actions.pod:4357
28924 #: ../src/guestfs-actions.pod:4371 ../src/guestfs-actions.pod:5501
28925 #: ../src/guestfs-actions.pod:6539 ../src/guestfs-actions.pod:6588
28926 #: ../src/guestfs-actions.pod:7462 ../src/guestfs-actions.pod:7474
28927 #: ../src/guestfs-actions.pod:7487 ../src/guestfs-actions.pod:7500
28928 #: ../src/guestfs-actions.pod:7522 ../src/guestfs-actions.pod:7535
28929 #: ../src/guestfs-actions.pod:7548 ../src/guestfs-actions.pod:7561
28930 #: ../src/guestfs-actions.pod:8475 ../src/guestfs-actions.pod:8494
28931 #: ../src/guestfs-actions.pod:8585 ../src/guestfs-actions.pod:8604
28932 #: ../src/guestfs-actions.pod:8650 ../src/guestfs-actions.pod:8669
28933 msgid "(Added in 1.0.66)"
28934 msgstr "(Додано у 1.0.66)"
28937 #: ../src/guestfs-actions.pod:1860
28938 msgid "guestfs_egrepi"
28939 msgstr "guestfs_egrepi"
28942 #: ../src/guestfs-actions.pod:1862
28946 " guestfs_egrepi (guestfs_h *g,\n"
28947 " const char *regex,\n"
28948 " const char *path);\n"
28953 #: ../src/guestfs-actions.pod:1879
28954 msgid "guestfs_equal"
28958 #: ../src/guestfs-actions.pod:1881
28962 " guestfs_equal (guestfs_h *g,\n"
28963 " const char *file1,\n"
28964 " const char *file2);\n"
28969 #: ../src/guestfs-actions.pod:1895
28970 msgid "guestfs_exists"
28974 #: ../src/guestfs-actions.pod:1897
28978 " guestfs_exists (guestfs_h *g,\n"
28979 " const char *path);\n"
28984 #: ../src/guestfs-actions.pod:1904
28985 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>."
28989 #: ../src/guestfs-actions.pod:1910
28990 msgid "guestfs_fallocate"
28994 #: ../src/guestfs-actions.pod:1912
28998 " guestfs_fallocate (guestfs_h *g,\n"
28999 " const char *path,\n"
29005 #: ../src/guestfs-actions.pod:1917
29007 "I<This function is deprecated.> In new code, use the L</guestfs_fallocate64> "
29012 #: ../src/guestfs-actions.pod:1936
29013 msgid "guestfs_fallocate64"
29017 #: ../src/guestfs-actions.pod:1938
29021 " guestfs_fallocate64 (guestfs_h *g,\n"
29022 " const char *path,\n"
29028 #: ../src/guestfs-actions.pod:1947
29030 "Note that this call allocates disk blocks for the file. To create a sparse "
29031 "file use C<guestfs_truncate_size> instead."
29035 #: ../src/guestfs-actions.pod:1950
29037 "The deprecated call C<guestfs_fallocate> does the same, but owing to an "
29038 "oversight it only allowed 30 bit lengths to be specified, effectively "
29039 "limiting the maximum size of files created through that call to 1GB."
29043 #: ../src/guestfs-actions.pod:1961
29044 msgid "(Added in 1.3.17)"
29045 msgstr "(Додано у 1.3.17)"
29048 #: ../src/guestfs-actions.pod:1963
29049 msgid "guestfs_fgrep"
29053 #: ../src/guestfs-actions.pod:1965
29057 " guestfs_fgrep (guestfs_h *g,\n"
29058 " const char *pattern,\n"
29059 " const char *path);\n"
29064 #: ../src/guestfs-actions.pod:1982
29065 msgid "guestfs_fgrepi"
29069 #: ../src/guestfs-actions.pod:1984
29073 " guestfs_fgrepi (guestfs_h *g,\n"
29074 " const char *pattern,\n"
29075 " const char *path);\n"
29080 #: ../src/guestfs-actions.pod:2001
29081 msgid "guestfs_file"
29085 #: ../src/guestfs-actions.pod:2003
29089 " guestfs_file (guestfs_h *g,\n"
29090 " const char *path);\n"
29095 #: ../src/guestfs-actions.pod:2021
29097 "See also: L<file(1)>, C<guestfs_vfs_type>, C<guestfs_lstat>, "
29098 "C<guestfs_is_file>, C<guestfs_is_blockdev> (etc), C<guestfs_is_zero>."
29102 #: ../src/guestfs-actions.pod:2029
29103 msgid "guestfs_file_architecture"
29107 #: ../src/guestfs-actions.pod:2031
29111 " guestfs_file_architecture (guestfs_h *g,\n"
29112 " const char *filename);\n"
29117 #: ../src/guestfs-actions.pod:2139 ../src/guestfs-actions.pod:2302
29118 #: ../src/guestfs-actions.pod:2319 ../src/guestfs-actions.pod:3053
29119 #: ../src/guestfs-actions.pod:3155 ../src/guestfs-actions.pod:3221
29120 #: ../src/guestfs-actions.pod:3408 ../src/guestfs-actions.pod:3426
29121 #: ../src/guestfs-actions.pod:3466 ../src/guestfs-actions.pod:3542
29122 #: ../src/guestfs-actions.pod:3639 ../src/guestfs-actions.pod:3876
29123 #: ../src/guestfs-actions.pod:4008
29124 msgid "(Added in 1.5.3)"
29125 msgstr "(Додано у 1.5.3)"
29128 #: ../src/guestfs-actions.pod:2141
29129 msgid "guestfs_filesize"
29133 #: ../src/guestfs-actions.pod:2143
29137 " guestfs_filesize (guestfs_h *g,\n"
29138 " const char *file);\n"
29143 #: ../src/guestfs-actions.pod:2149
29145 "To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, "
29146 "C<guestfs_is_dir>, C<guestfs_is_file> etc. To get the size of block "
29147 "devices, use C<guestfs_blockdev_getsize64>."
29151 #: ../src/guestfs-actions.pod:2155
29152 msgid "(Added in 1.0.82)"
29153 msgstr "(Додано у 1.0.82)"
29156 #: ../src/guestfs-actions.pod:2157
29157 msgid "guestfs_fill"
29161 #: ../src/guestfs-actions.pod:2159
29165 " guestfs_fill (guestfs_h *g,\n"
29168 " const char *path);\n"
29173 #: ../src/guestfs-actions.pod:2169
29175 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
29176 "C<guestfs_truncate_size>. To create a file with a pattern of repeating "
29177 "bytes use C<guestfs_fill_pattern>."
29181 #: ../src/guestfs-actions.pod:2181
29182 msgid "(Added in 1.0.79)"
29183 msgstr "(Додано у 1.0.79)"
29186 #: ../src/guestfs-actions.pod:2183
29187 msgid "guestfs_fill_pattern"
29191 #: ../src/guestfs-actions.pod:2185
29195 " guestfs_fill_pattern (guestfs_h *g,\n"
29196 " const char *pattern,\n"
29198 " const char *path);\n"
29203 #: ../src/guestfs-actions.pod:2191
29205 "This function is like C<guestfs_fill> except that it creates a new file of "
29206 "length C<len> containing the repeating pattern of bytes in C<pattern>. The "
29207 "pattern is truncated if necessary to ensure the length of the file is "
29208 "exactly C<len> bytes."
29212 #: ../src/guestfs-actions.pod:2203
29213 msgid "(Added in 1.3.12)"
29214 msgstr "(Додано у 1.3.12)"
29217 #: ../src/guestfs-actions.pod:2205
29218 msgid "guestfs_find"
29222 #: ../src/guestfs-actions.pod:2207
29226 " guestfs_find (guestfs_h *g,\n"
29227 " const char *directory);\n"
29232 #: ../src/guestfs-actions.pod:2223
29234 "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:"
29238 #: ../src/guestfs-actions.pod:2236
29239 msgid "See also C<guestfs_find0>."
29243 #: ../src/guestfs-actions.pod:2245 ../src/guestfs-actions.pod:4768
29244 #: ../src/guestfs-actions.pod:6623
29245 msgid "(Added in 1.0.27)"
29246 msgstr "(Додано у 1.0.27)"
29249 #: ../src/guestfs-actions.pod:2247
29250 msgid "guestfs_find0"
29254 #: ../src/guestfs-actions.pod:2249
29258 " guestfs_find0 (guestfs_h *g,\n"
29259 " const char *directory,\n"
29260 " const char *files);\n"
29265 #: ../src/guestfs-actions.pod:2258
29267 "This command works the same way as C<guestfs_find> with the following "
29272 #: ../src/guestfs-actions.pod:2285
29273 msgid "(Added in 1.0.74)"
29274 msgstr "(Додано у 1.0.74)"
29277 #: ../src/guestfs-actions.pod:2287
29278 msgid "guestfs_findfs_label"
29282 #: ../src/guestfs-actions.pod:2289
29286 " guestfs_findfs_label (guestfs_h *g,\n"
29287 " const char *label);\n"
29292 #: ../src/guestfs-actions.pod:2297
29293 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>."
29297 #: ../src/guestfs-actions.pod:2304
29298 msgid "guestfs_findfs_uuid"
29302 #: ../src/guestfs-actions.pod:2306
29306 " guestfs_findfs_uuid (guestfs_h *g,\n"
29307 " const char *uuid);\n"
29312 #: ../src/guestfs-actions.pod:2314
29313 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>."
29317 #: ../src/guestfs-actions.pod:2321
29318 msgid "guestfs_fsck"
29322 #: ../src/guestfs-actions.pod:2323
29326 " guestfs_fsck (guestfs_h *g,\n"
29327 " const char *fstype,\n"
29328 " const char *device);\n"
29333 #: ../src/guestfs-actions.pod:2358 ../src/guestfs-actions.pod:8522
29334 msgid "(Added in 1.0.16)"
29335 msgstr "(Додано у 1.0.16)"
29338 #: ../src/guestfs-actions.pod:2360
29339 msgid "guestfs_get_append"
29343 #: ../src/guestfs-actions.pod:2362
29347 " guestfs_get_append (guestfs_h *g);\n"
29352 #: ../src/guestfs-actions.pod:2370
29354 "This function returns a string which may be NULL. There is no way to return "
29355 "an error from this function. The string is owned by the guest handle and "
29356 "must I<not> be freed."
29360 #: ../src/guestfs-actions.pod:2374 ../src/guestfs-actions.pod:6301
29361 #: ../src/guestfs-actions.pod:6780 ../src/guestfs-actions.pod:7229
29362 #: ../src/guestfs-actions.pod:7248 ../src/guestfs-actions.pod:7264
29363 #: ../src/guestfs-actions.pod:7288 ../src/guestfs-actions.pod:8162
29364 #: ../src/guestfs-actions.pod:8177 ../src/guestfs-actions.pod:8566
29365 msgid "(Added in 1.0.26)"
29366 msgstr "(Додано у 1.0.26)"
29369 #: ../src/guestfs-actions.pod:2376
29370 msgid "guestfs_get_attach_method"
29374 #: ../src/guestfs-actions.pod:2378
29378 " guestfs_get_attach_method (guestfs_h *g);\n"
29383 #: ../src/guestfs-actions.pod:2381
29384 msgid "Return the current attach method. See C<guestfs_set_attach_method>."
29388 #: ../src/guestfs-actions.pod:2386 ../src/guestfs-actions.pod:6810
29389 msgid "(Added in 1.9.8)"
29390 msgstr "(Додано у 1.9.8)"
29393 #: ../src/guestfs-actions.pod:2388
29394 msgid "guestfs_get_autosync"
29398 #: ../src/guestfs-actions.pod:2390
29402 " guestfs_get_autosync (guestfs_h *g);\n"
29407 #: ../src/guestfs-actions.pod:2399
29408 msgid "guestfs_get_direct"
29412 #: ../src/guestfs-actions.pod:2401
29416 " guestfs_get_direct (guestfs_h *g);\n"
29421 #: ../src/guestfs-actions.pod:2408 ../src/guestfs-actions.pod:6851
29422 msgid "(Added in 1.0.72)"
29423 msgstr "(Додано у 1.0.72)"
29426 #: ../src/guestfs-actions.pod:2410
29427 msgid "guestfs_get_e2label"
29431 #: ../src/guestfs-actions.pod:2412
29435 " guestfs_get_e2label (guestfs_h *g,\n"
29436 " const char *device);\n"
29441 #: ../src/guestfs-actions.pod:2416
29443 "I<This function is deprecated.> In new code, use the L</guestfs_vfs_label> "
29448 #: ../src/guestfs-actions.pod:2429 ../src/guestfs-actions.pod:2450
29449 #: ../src/guestfs-actions.pod:6869 ../src/guestfs-actions.pod:6888
29450 msgid "(Added in 1.0.15)"
29451 msgstr "(Додано у 1.0.15)"
29454 #: ../src/guestfs-actions.pod:2431
29455 msgid "guestfs_get_e2uuid"
29459 #: ../src/guestfs-actions.pod:2433
29463 " guestfs_get_e2uuid (guestfs_h *g,\n"
29464 " const char *device);\n"
29469 #: ../src/guestfs-actions.pod:2437
29471 "I<This function is deprecated.> In new code, use the L</guestfs_vfs_uuid> "
29476 #: ../src/guestfs-actions.pod:2452
29477 msgid "guestfs_get_memsize"
29481 #: ../src/guestfs-actions.pod:2454
29485 " guestfs_get_memsize (guestfs_h *g);\n"
29490 #: ../src/guestfs-actions.pod:2460
29492 "If C<guestfs_set_memsize> was not called on this handle, and if "
29493 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
29494 "value for memsize."
29498 #: ../src/guestfs-actions.pod:2469 ../src/guestfs-actions.pod:5197
29499 #: ../src/guestfs-actions.pod:5406 ../src/guestfs-actions.pod:5425
29500 #: ../src/guestfs-actions.pod:5444 ../src/guestfs-actions.pod:5456
29501 #: ../src/guestfs-actions.pod:5473 ../src/guestfs-actions.pod:5486
29502 #: ../src/guestfs-actions.pod:6526 ../src/guestfs-actions.pod:6909
29503 #: ../src/guestfs-actions.pod:7199 ../src/guestfs-actions.pod:7931
29504 msgid "(Added in 1.0.55)"
29505 msgstr "(Додано у 1.0.55)"
29508 #: ../src/guestfs-actions.pod:2471
29509 msgid "guestfs_get_network"
29513 #: ../src/guestfs-actions.pod:2473
29517 " guestfs_get_network (guestfs_h *g);\n"
29522 #: ../src/guestfs-actions.pod:2480 ../src/guestfs-actions.pod:6928
29523 msgid "(Added in 1.5.4)"
29524 msgstr "(Додано у 1.5.4)"
29527 #: ../src/guestfs-actions.pod:2482
29528 msgid "guestfs_get_path"
29532 #: ../src/guestfs-actions.pod:2484
29536 " guestfs_get_path (guestfs_h *g);\n"
29541 #: ../src/guestfs-actions.pod:2492 ../src/guestfs-actions.pod:2532
29543 "This function returns a string, or NULL on error. The string is owned by "
29544 "the guest handle and must I<not> be freed."
29548 #: ../src/guestfs-actions.pod:2497
29549 msgid "guestfs_get_pgroup"
29553 #: ../src/guestfs-actions.pod:2499
29557 " guestfs_get_pgroup (guestfs_h *g);\n"
29562 #: ../src/guestfs-actions.pod:2506 ../src/guestfs-actions.pod:6964
29563 #: ../src/guestfs-actions.pod:8423
29564 msgid "(Added in 1.11.18)"
29565 msgstr "(Додано у 1.11.18)"
29568 #: ../src/guestfs-actions.pod:2508
29569 msgid "guestfs_get_pid"
29573 #: ../src/guestfs-actions.pod:2510
29577 " guestfs_get_pid (guestfs_h *g);\n"
29582 #: ../src/guestfs-actions.pod:2520
29583 msgid "(Added in 1.0.56)"
29584 msgstr "(Додано у 1.0.56)"
29587 #: ../src/guestfs-actions.pod:2522
29588 msgid "guestfs_get_qemu"
29592 #: ../src/guestfs-actions.pod:2524
29596 " guestfs_get_qemu (guestfs_h *g);\n"
29601 #: ../src/guestfs-actions.pod:2535 ../src/guestfs-actions.pod:6992
29602 msgid "(Added in 1.0.6)"
29603 msgstr "(Додано у 1.0.6)"
29606 #: ../src/guestfs-actions.pod:2537
29607 msgid "guestfs_get_recovery_proc"
29611 #: ../src/guestfs-actions.pod:2539
29615 " guestfs_get_recovery_proc (guestfs_h *g);\n"
29620 #: ../src/guestfs-actions.pod:2546 ../src/guestfs-actions.pod:4130
29621 #: ../src/guestfs-actions.pod:4472 ../src/guestfs-actions.pod:4866
29622 #: ../src/guestfs-actions.pod:5036 ../src/guestfs-actions.pod:6231
29623 #: ../src/guestfs-actions.pod:6574 ../src/guestfs-actions.pod:7016
29624 #: ../src/guestfs-actions.pod:7714 ../src/guestfs-actions.pod:7734
29625 #: ../src/guestfs-actions.pod:8046
29626 msgid "(Added in 1.0.77)"
29627 msgstr "(Додано у 1.0.77)"
29630 #: ../src/guestfs-actions.pod:2548
29631 msgid "guestfs_get_selinux"
29635 #: ../src/guestfs-actions.pod:2550
29639 " guestfs_get_selinux (guestfs_h *g);\n"
29644 #: ../src/guestfs-actions.pod:2553
29646 "This returns the current setting of the selinux flag which is passed to the "
29647 "appliance at boot time. See C<guestfs_set_selinux>."
29651 #: ../src/guestfs-actions.pod:2561 ../src/guestfs-actions.pod:2635
29652 #: ../src/guestfs-actions.pod:7035 ../src/guestfs-actions.pod:7109
29653 msgid "(Added in 1.0.67)"
29654 msgstr "(Додано у 1.0.67)"
29657 #: ../src/guestfs-actions.pod:2563
29658 msgid "guestfs_get_smp"
29662 #: ../src/guestfs-actions.pod:2565
29666 " guestfs_get_smp (guestfs_h *g);\n"
29671 #: ../src/guestfs-actions.pod:2574
29672 msgid "guestfs_get_state"
29676 #: ../src/guestfs-actions.pod:2576
29680 " guestfs_get_state (guestfs_h *g);\n"
29685 #: ../src/guestfs-actions.pod:2588
29686 msgid "guestfs_get_trace"
29690 #: ../src/guestfs-actions.pod:2590
29694 " guestfs_get_trace (guestfs_h *g);\n"
29699 #: ../src/guestfs-actions.pod:2599
29700 msgid "guestfs_get_umask"
29704 #: ../src/guestfs-actions.pod:2601
29708 " guestfs_get_umask (guestfs_h *g);\n"
29713 #: ../src/guestfs-actions.pod:2604
29715 "Return the current umask. By default the umask is C<022> unless it has been "
29716 "set by calling C<guestfs_umask>."
29720 #: ../src/guestfs-actions.pod:2611
29721 msgid "guestfs_get_verbose"
29725 #: ../src/guestfs-actions.pod:2613
29729 " guestfs_get_verbose (guestfs_h *g);\n"
29734 #: ../src/guestfs-actions.pod:2622
29735 msgid "guestfs_getcon"
29739 #: ../src/guestfs-actions.pod:2624
29743 " guestfs_getcon (guestfs_h *g);\n"
29748 #: ../src/guestfs-actions.pod:2629
29750 "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>"
29754 #: ../src/guestfs-actions.pod:2637
29755 msgid "guestfs_getxattr"
29759 #: ../src/guestfs-actions.pod:2639
29763 " guestfs_getxattr (guestfs_h *g,\n"
29764 " const char *path,\n"
29765 " const char *name,\n"
29766 " size_t *size_r);\n"
29771 #: ../src/guestfs-actions.pod:2645
29773 "Get a single extended attribute from file C<path> named C<name>. This call "
29774 "follows symlinks. If you want to lookup an extended attribute for the "
29775 "symlink itself, use C<guestfs_lgetxattr>."
29779 #: ../src/guestfs-actions.pod:2649 ../src/guestfs-actions.pod:4144
29781 "Normally it is better to get all extended attributes from a file in one go "
29782 "by calling C<guestfs_getxattrs>. However some Linux filesystem "
29783 "implementations are buggy and do not provide a way to list out attributes. "
29784 "For these filesystems (notably ntfs-3g) you have to know the names of the "
29785 "extended attributes you want in advance and call this function."
29789 #: ../src/guestfs-actions.pod:2659
29790 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>."
29794 #: ../src/guestfs-actions.pod:2661 ../src/guestfs-actions.pod:2874
29795 #: ../src/guestfs-actions.pod:3356 ../src/guestfs-actions.pod:4156
29796 #: ../src/guestfs-actions.pod:6224 ../src/guestfs-actions.pod:6250
29797 #: ../src/guestfs-actions.pod:6431
29799 "This function returns a buffer, or NULL on error. The size of the returned "
29800 "buffer is written to C<*size_r>. I<The caller must free the returned buffer "
29805 #: ../src/guestfs-actions.pod:2665 ../src/guestfs-actions.pod:4160
29806 msgid "(Added in 1.7.24)"
29807 msgstr "(Додано у 1.7.24)"
29810 #: ../src/guestfs-actions.pod:2667
29811 msgid "guestfs_getxattrs"
29815 #: ../src/guestfs-actions.pod:2669
29818 " struct guestfs_xattr_list *\n"
29819 " guestfs_getxattrs (guestfs_h *g,\n"
29820 " const char *path);\n"
29825 #: ../src/guestfs-actions.pod:2679
29826 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>."
29830 #: ../src/guestfs-actions.pod:2681 ../src/guestfs-actions.pod:4172
29831 #: ../src/guestfs-actions.pod:4862
29833 "This function returns a C<struct guestfs_xattr_list *>, or NULL if there was "
29834 "an error. I<The caller must call C<guestfs_free_xattr_list> after use>."
29838 #: ../src/guestfs-actions.pod:2685 ../src/guestfs-actions.pod:4176
29839 #: ../src/guestfs-actions.pod:4386 ../src/guestfs-actions.pod:4422
29840 #: ../src/guestfs-actions.pod:6604 ../src/guestfs-actions.pod:7128
29841 #: ../src/guestfs-actions.pod:8631
29842 msgid "(Added in 1.0.59)"
29843 msgstr "(Додано у 1.0.59)"
29846 #: ../src/guestfs-actions.pod:2687
29847 msgid "guestfs_glob_expand"
29851 #: ../src/guestfs-actions.pod:2689
29855 " guestfs_glob_expand (guestfs_h *g,\n"
29856 " const char *pattern);\n"
29861 #: ../src/guestfs-actions.pod:2708 ../src/guestfs-actions.pod:7312
29862 #: ../src/guestfs-actions.pod:7329
29863 msgid "(Added in 1.0.50)"
29864 msgstr "(Додано у 1.0.50)"
29867 #: ../src/guestfs-actions.pod:2710
29868 msgid "guestfs_grep"
29872 #: ../src/guestfs-actions.pod:2712
29876 " guestfs_grep (guestfs_h *g,\n"
29877 " const char *regex,\n"
29878 " const char *path);\n"
29883 #: ../src/guestfs-actions.pod:2729
29884 msgid "guestfs_grepi"
29888 #: ../src/guestfs-actions.pod:2731
29892 " guestfs_grepi (guestfs_h *g,\n"
29893 " const char *regex,\n"
29894 " const char *path);\n"
29899 #: ../src/guestfs-actions.pod:2748
29900 msgid "guestfs_grub_install"
29904 #: ../src/guestfs-actions.pod:2750
29908 " guestfs_grub_install (guestfs_h *g,\n"
29909 " const char *root,\n"
29910 " const char *device);\n"
29915 #: ../src/guestfs-actions.pod:2793
29916 msgid "(Added in 1.0.17)"
29917 msgstr "(Додано у 1.0.17)"
29920 #: ../src/guestfs-actions.pod:2795
29921 msgid "guestfs_head"
29925 #: ../src/guestfs-actions.pod:2797
29929 " guestfs_head (guestfs_h *g,\n"
29930 " const char *path);\n"
29935 #: ../src/guestfs-actions.pod:2813
29936 msgid "guestfs_head_n"
29940 #: ../src/guestfs-actions.pod:2815
29944 " guestfs_head_n (guestfs_h *g,\n"
29946 " const char *path);\n"
29951 #: ../src/guestfs-actions.pod:2837
29952 msgid "guestfs_hexdump"
29956 #: ../src/guestfs-actions.pod:2839
29960 " guestfs_hexdump (guestfs_h *g,\n"
29961 " const char *path);\n"
29966 #: ../src/guestfs-actions.pod:2852 ../src/guestfs-actions.pod:7393
29967 #: ../src/guestfs-actions.pod:7448
29968 msgid "(Added in 1.0.22)"
29969 msgstr "(Додано у 1.0.22)"
29972 #: ../src/guestfs-actions.pod:2854
29973 msgid "guestfs_initrd_cat"
29977 #: ../src/guestfs-actions.pod:2856
29981 " guestfs_initrd_cat (guestfs_h *g,\n"
29982 " const char *initrdpath,\n"
29983 " const char *filename,\n"
29984 " size_t *size_r);\n"
29989 #: ../src/guestfs-actions.pod:2872
29990 msgid "See also C<guestfs_initrd_list>."
29994 #: ../src/guestfs-actions.pod:2883
29995 msgid "guestfs_initrd_list"
29999 #: ../src/guestfs-actions.pod:2885
30003 " guestfs_initrd_list (guestfs_h *g,\n"
30004 " const char *path);\n"
30009 #: ../src/guestfs-actions.pod:2905
30010 msgid "guestfs_inotify_add_watch"
30014 #: ../src/guestfs-actions.pod:2907
30018 " guestfs_inotify_add_watch (guestfs_h *g,\n"
30019 " const char *path,\n"
30025 #: ../src/guestfs-actions.pod:2926
30026 msgid "guestfs_inotify_close"
30030 #: ../src/guestfs-actions.pod:2928
30034 " guestfs_inotify_close (guestfs_h *g);\n"
30039 #: ../src/guestfs-actions.pod:2939
30040 msgid "guestfs_inotify_files"
30044 #: ../src/guestfs-actions.pod:2941
30048 " guestfs_inotify_files (guestfs_h *g);\n"
30053 #: ../src/guestfs-actions.pod:2944
30055 "This function is a helpful wrapper around C<guestfs_inotify_read> which just "
30056 "returns a list of pathnames of objects that were touched. The returned "
30057 "pathnames are sorted and deduplicated."
30061 #: ../src/guestfs-actions.pod:2954
30062 msgid "guestfs_inotify_init"
30066 #: ../src/guestfs-actions.pod:2956
30070 " guestfs_inotify_init (guestfs_h *g,\n"
30071 " int maxevents);\n"
30076 #: ../src/guestfs-actions.pod:2964
30078 "C<maxevents> is the maximum number of events which will be queued up between "
30079 "calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>. If this is "
30080 "passed as C<0>, then the kernel (or previously set) default is used. For "
30081 "Linux 2.6.29 the default was 16384 events. Beyond this limit, the kernel "
30082 "throws away events, but records the fact that it threw them away by setting "
30083 "a flag C<IN_Q_OVERFLOW> in the returned structure list (see "
30084 "C<guestfs_inotify_read>)."
30088 #: ../src/guestfs-actions.pod:2974
30090 "Before any events are generated, you have to add some watches to the "
30091 "internal watch list. See: C<guestfs_inotify_add_watch>, "
30092 "C<guestfs_inotify_rm_watch> and C<guestfs_inotify_watch_all>."
30096 #: ../src/guestfs-actions.pod:2980
30098 "Queued up events should be read periodically by calling "
30099 "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful "
30100 "wrapper around C<guestfs_inotify_read>). If you don't read the events out "
30101 "often enough then you risk the internal queue overflowing."
30105 #: ../src/guestfs-actions.pod:2987
30107 "The handle should be closed after use by calling C<guestfs_inotify_close>. "
30108 "This also removes any watches automatically."
30112 #: ../src/guestfs-actions.pod:3000
30113 msgid "guestfs_inotify_read"
30117 #: ../src/guestfs-actions.pod:3002
30120 " struct guestfs_inotify_event_list *\n"
30121 " guestfs_inotify_read (guestfs_h *g);\n"
30126 #: ../src/guestfs-actions.pod:3016
30128 "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if "
30129 "there was an error. I<The caller must call "
30130 "C<guestfs_free_inotify_event_list> after use>."
30134 #: ../src/guestfs-actions.pod:3022
30135 msgid "guestfs_inotify_rm_watch"
30139 #: ../src/guestfs-actions.pod:3024
30143 " guestfs_inotify_rm_watch (guestfs_h *g,\n"
30149 #: ../src/guestfs-actions.pod:3028
30151 "Remove a previously defined inotify watch. See C<guestfs_inotify_add_watch>."
30155 #: ../src/guestfs-actions.pod:3035
30156 msgid "guestfs_inspect_get_arch"
30160 #: ../src/guestfs-actions.pod:3037
30164 " guestfs_inspect_get_arch (guestfs_h *g,\n"
30165 " const char *root);\n"
30170 #: ../src/guestfs-actions.pod:3041
30172 "This returns the architecture of the inspected operating system. The "
30173 "possible return values are listed under C<guestfs_file_architecture>."
30177 #: ../src/guestfs-actions.pod:3055
30178 msgid "guestfs_inspect_get_distro"
30182 #: ../src/guestfs-actions.pod:3057
30186 " guestfs_inspect_get_distro (guestfs_h *g,\n"
30187 " const char *root);\n"
30192 #: ../src/guestfs-actions.pod:3157
30193 msgid "guestfs_inspect_get_drive_mappings"
30197 #: ../src/guestfs-actions.pod:3159
30201 " guestfs_inspect_get_drive_mappings (guestfs_h *g,\n"
30202 " const char *root);\n"
30207 #: ../src/guestfs-actions.pod:3188
30209 "Please read L<guestfs(3)/INSPECTION> for more details. See also "
30210 "C<guestfs_inspect_get_mountpoints>, C<guestfs_inspect_get_filesystems>."
30214 #: ../src/guestfs-actions.pod:3192 ../src/guestfs-actions.pod:3460
30215 #: ../src/guestfs-actions.pod:4263 ../src/guestfs-actions.pod:5000
30216 #: ../src/guestfs-actions.pod:5675 ../src/guestfs-actions.pod:7870
30218 "This function returns a NULL-terminated array of strings, or NULL if there "
30219 "was an error. The array of strings will always have length C<2n+1>, where "
30220 "C<n> keys and values alternate, followed by the trailing NULL entry. I<The "
30221 "caller must free the strings and the array after use>."
30225 #: ../src/guestfs-actions.pod:3198 ../src/guestfs-actions.pod:3659
30226 msgid "(Added in 1.9.17)"
30227 msgstr "(Додано у 1.9.17)"
30230 #: ../src/guestfs-actions.pod:3200
30231 msgid "guestfs_inspect_get_filesystems"
30235 #: ../src/guestfs-actions.pod:3202
30239 " guestfs_inspect_get_filesystems (guestfs_h *g,\n"
30240 " const char *root);\n"
30245 #: ../src/guestfs-actions.pod:3214
30247 "Please read L<guestfs(3)/INSPECTION> for more details. See also "
30248 "C<guestfs_inspect_get_mountpoints>."
30252 #: ../src/guestfs-actions.pod:3223
30253 msgid "guestfs_inspect_get_format"
30257 #: ../src/guestfs-actions.pod:3225
30261 " guestfs_inspect_get_format (guestfs_h *g,\n"
30262 " const char *root);\n"
30267 #: ../src/guestfs-actions.pod:3259 ../src/guestfs-actions.pod:3695
30268 #: ../src/guestfs-actions.pod:3711 ../src/guestfs-actions.pod:3729
30269 #: ../src/guestfs-actions.pod:6642
30270 msgid "(Added in 1.9.4)"
30271 msgstr "(Додано у 1.9.4)"
30274 #: ../src/guestfs-actions.pod:3261
30275 msgid "guestfs_inspect_get_hostname"
30279 #: ../src/guestfs-actions.pod:3263
30283 " guestfs_inspect_get_hostname (guestfs_h *g,\n"
30284 " const char *root);\n"
30289 #: ../src/guestfs-actions.pod:3278
30290 msgid "(Added in 1.7.9)"
30291 msgstr "(Додано у 1.7.9)"
30294 #: ../src/guestfs-actions.pod:3280
30295 msgid "guestfs_inspect_get_icon"
30299 #: ../src/guestfs-actions.pod:3282
30303 " guestfs_inspect_get_icon (guestfs_h *g,\n"
30304 " const char *root,\n"
30305 " size_t *size_r,\n"
30311 #: ../src/guestfs-actions.pod:3293
30314 " GUESTFS_INSPECT_GET_ICON_FAVICON, int favicon,\n"
30315 " GUESTFS_INSPECT_GET_ICON_HIGHQUALITY, int highquality,\n"
30320 #: ../src/guestfs-actions.pod:3360 ../src/guestfs-actions.pod:4190
30321 #: ../src/guestfs-actions.pod:5574
30322 msgid "(Added in 1.11.12)"
30323 msgstr "(Додано у 1.11.12)"
30326 #: ../src/guestfs-actions.pod:3362
30327 msgid "guestfs_inspect_get_icon_va"
30331 #: ../src/guestfs-actions.pod:3364
30335 " guestfs_inspect_get_icon_va (guestfs_h *g,\n"
30336 " const char *root,\n"
30337 " size_t *size_r,\n"
30338 " va_list args);\n"
30343 #: ../src/guestfs-actions.pod:3370
30344 msgid "This is the \"va_list variant\" of L</guestfs_inspect_get_icon>."
30348 #: ../src/guestfs-actions.pod:3374
30349 msgid "guestfs_inspect_get_icon_argv"
30353 #: ../src/guestfs-actions.pod:3376
30357 " guestfs_inspect_get_icon_argv (guestfs_h *g,\n"
30358 " const char *root,\n"
30359 " size_t *size_r,\n"
30360 " const struct guestfs_inspect_get_icon_argv *optargs);\n"
30365 #: ../src/guestfs-actions.pod:3382
30366 msgid "This is the \"argv variant\" of L</guestfs_inspect_get_icon>."
30370 #: ../src/guestfs-actions.pod:3386
30371 msgid "guestfs_inspect_get_major_version"
30375 #: ../src/guestfs-actions.pod:3388
30379 " guestfs_inspect_get_major_version (guestfs_h *g,\n"
30380 " const char *root);\n"
30385 #: ../src/guestfs-actions.pod:3410
30386 msgid "guestfs_inspect_get_minor_version"
30390 #: ../src/guestfs-actions.pod:3412
30394 " guestfs_inspect_get_minor_version (guestfs_h *g,\n"
30395 " const char *root);\n"
30400 #: ../src/guestfs-actions.pod:3421
30402 "Please read L<guestfs(3)/INSPECTION> for more details. See also "
30403 "C<guestfs_inspect_get_major_version>."
30407 #: ../src/guestfs-actions.pod:3428
30408 msgid "guestfs_inspect_get_mountpoints"
30412 #: ../src/guestfs-actions.pod:3430
30416 " guestfs_inspect_get_mountpoints (guestfs_h *g,\n"
30417 " const char *root);\n"
30422 #: ../src/guestfs-actions.pod:3451
30424 "For operating systems like Windows which still use drive letters, this call "
30425 "will only return an entry for the first drive \"mounted on\" C</>. For "
30426 "information about the mapping of drive letters to partitions, see "
30427 "C<guestfs_inspect_get_drive_mappings>."
30431 #: ../src/guestfs-actions.pod:3457
30433 "Please read L<guestfs(3)/INSPECTION> for more details. See also "
30434 "C<guestfs_inspect_get_filesystems>."
30438 #: ../src/guestfs-actions.pod:3468
30439 msgid "guestfs_inspect_get_package_format"
30443 #: ../src/guestfs-actions.pod:3470
30447 " guestfs_inspect_get_package_format (guestfs_h *g,\n"
30448 " const char *root);\n"
30453 #: ../src/guestfs-actions.pod:3474
30455 "This function and C<guestfs_inspect_get_package_management> return the "
30456 "package format and package management tool used by the inspected operating "
30457 "system. For example for Fedora these functions would return C<rpm> (package "
30458 "format) and C<yum> (package management)."
30462 #: ../src/guestfs-actions.pod:3493 ../src/guestfs-actions.pod:3521
30463 msgid "(Added in 1.7.5)"
30464 msgstr "(Додано у 1.7.5)"
30467 #: ../src/guestfs-actions.pod:3495
30468 msgid "guestfs_inspect_get_package_management"
30472 #: ../src/guestfs-actions.pod:3497
30476 " guestfs_inspect_get_package_management (guestfs_h *g,\n"
30477 " const char *root);\n"
30482 #: ../src/guestfs-actions.pod:3501
30484 "C<guestfs_inspect_get_package_format> and this function return the package "
30485 "format and package management tool used by the inspected operating system. "
30486 "For example for Fedora these functions would return C<rpm> (package format) "
30487 "and C<yum> (package management)."
30491 #: ../src/guestfs-actions.pod:3523
30492 msgid "guestfs_inspect_get_product_name"
30496 #: ../src/guestfs-actions.pod:3525
30500 " guestfs_inspect_get_product_name (guestfs_h *g,\n"
30501 " const char *root);\n"
30506 #: ../src/guestfs-actions.pod:3544
30507 msgid "guestfs_inspect_get_product_variant"
30511 #: ../src/guestfs-actions.pod:3546
30515 " guestfs_inspect_get_product_variant (guestfs_h *g,\n"
30516 " const char *root);\n"
30521 #: ../src/guestfs-actions.pod:3569
30523 "Please read L<guestfs(3)/INSPECTION> for more details. See also "
30524 "C<guestfs_inspect_get_product_name>, C<guestfs_inspect_get_major_version>."
30528 #: ../src/guestfs-actions.pod:3576
30529 msgid "(Added in 1.9.13)"
30530 msgstr "(Додано у 1.9.13)"
30533 #: ../src/guestfs-actions.pod:3578
30534 msgid "guestfs_inspect_get_roots"
30538 #: ../src/guestfs-actions.pod:3580
30542 " guestfs_inspect_get_roots (guestfs_h *g);\n"
30547 #: ../src/guestfs-actions.pod:3583
30549 "This function is a convenient way to get the list of root devices, as "
30550 "returned from a previous call to C<guestfs_inspect_os>, but without redoing "
30551 "the whole inspection process."
30555 #: ../src/guestfs-actions.pod:3587
30557 "This returns an empty list if either no root devices were found or the "
30558 "caller has not called C<guestfs_inspect_os>."
30562 #: ../src/guestfs-actions.pod:3596
30563 msgid "(Added in 1.7.3)"
30564 msgstr "(Додано у 1.7.3)"
30567 #: ../src/guestfs-actions.pod:3598
30568 msgid "guestfs_inspect_get_type"
30572 #: ../src/guestfs-actions.pod:3600
30576 " guestfs_inspect_get_type (guestfs_h *g,\n"
30577 " const char *root);\n"
30582 #: ../src/guestfs-actions.pod:3641
30583 msgid "guestfs_inspect_get_windows_current_control_set"
30587 #: ../src/guestfs-actions.pod:3643
30591 " guestfs_inspect_get_windows_current_control_set (guestfs_h *g,\n"
30592 " const char *root);\n"
30597 #: ../src/guestfs-actions.pod:3661
30598 msgid "guestfs_inspect_get_windows_systemroot"
30602 #: ../src/guestfs-actions.pod:3663
30606 " guestfs_inspect_get_windows_systemroot (guestfs_h *g,\n"
30607 " const char *root);\n"
30612 #: ../src/guestfs-actions.pod:3679
30613 msgid "(Added in 1.5.25)"
30614 msgstr "(Додано у 1.5.25)"
30617 #: ../src/guestfs-actions.pod:3681
30618 msgid "guestfs_inspect_is_live"
30622 #: ../src/guestfs-actions.pod:3683
30626 " guestfs_inspect_is_live (guestfs_h *g,\n"
30627 " const char *root);\n"
30632 #: ../src/guestfs-actions.pod:3687
30634 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
30635 "disk), then this returns true if a live image was detected on the disk."
30639 #: ../src/guestfs-actions.pod:3697
30640 msgid "guestfs_inspect_is_multipart"
30644 #: ../src/guestfs-actions.pod:3699
30648 " guestfs_inspect_is_multipart (guestfs_h *g,\n"
30649 " const char *root);\n"
30654 #: ../src/guestfs-actions.pod:3703
30656 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
30657 "disk), then this returns true if the disk is part of a set."
30661 #: ../src/guestfs-actions.pod:3713
30662 msgid "guestfs_inspect_is_netinst"
30666 #: ../src/guestfs-actions.pod:3715
30670 " guestfs_inspect_is_netinst (guestfs_h *g,\n"
30671 " const char *root);\n"
30676 #: ../src/guestfs-actions.pod:3719
30678 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
30679 "disk), then this returns true if the disk is a network installer, ie. not a "
30680 "self-contained install CD but one which is likely to require network access "
30681 "to complete the install."
30685 #: ../src/guestfs-actions.pod:3731
30686 msgid "guestfs_inspect_list_applications"
30690 #: ../src/guestfs-actions.pod:3733
30693 " struct guestfs_application_list *\n"
30694 " guestfs_inspect_list_applications (guestfs_h *g,\n"
30695 " const char *root);\n"
30700 #: ../src/guestfs-actions.pod:3739
30702 "I<Note:> This call works differently from other parts of the inspection "
30703 "API. You have to call C<guestfs_inspect_os>, then "
30704 "C<guestfs_inspect_get_mountpoints>, then mount up the disks, before calling "
30705 "this. Listing applications is a significantly more difficult operation "
30706 "which requires access to the full filesystem. Also note that unlike the "
30707 "other C<guestfs_inspect_get_*> calls which are just returning data cached in "
30708 "the libguestfs handle, this call actually reads parts of the mounted "
30709 "filesystems during the call."
30713 #: ../src/guestfs-actions.pod:3829
30715 "This function returns a C<struct guestfs_application_list *>, or NULL if "
30716 "there was an error. I<The caller must call C<guestfs_free_application_list> "
30721 #: ../src/guestfs-actions.pod:3833
30722 msgid "(Added in 1.7.8)"
30723 msgstr "(Додано у 1.7.8)"
30726 #: ../src/guestfs-actions.pod:3835
30727 msgid "guestfs_inspect_os"
30731 #: ../src/guestfs-actions.pod:3837
30735 " guestfs_inspect_os (guestfs_h *g);\n"
30740 #: ../src/guestfs-actions.pod:3853
30742 "You can pass the root string(s) returned to other C<guestfs_inspect_get_*> "
30743 "functions in order to query further information about each operating system, "
30744 "such as the name and version."
30748 #: ../src/guestfs-actions.pod:3858
30750 "This function uses other libguestfs features such as C<guestfs_mount_ro> and "
30751 "C<guestfs_umount_all> in order to mount and unmount filesystems and look at "
30752 "the contents. This should be called with no disks currently mounted. The "
30753 "function may also use Augeas, so any existing Augeas handle will be closed."
30757 #: ../src/guestfs-actions.pod:3870 ../src/guestfs-actions.pod:4201
30758 #: ../src/guestfs-actions.pod:4294
30759 msgid "See also C<guestfs_list_filesystems>."
30763 #: ../src/guestfs-actions.pod:3878
30764 msgid "guestfs_is_blockdev"
30768 #: ../src/guestfs-actions.pod:3880
30772 " guestfs_is_blockdev (guestfs_h *g,\n"
30773 " const char *path);\n"
30778 #: ../src/guestfs-actions.pod:3887 ../src/guestfs-actions.pod:3916
30779 #: ../src/guestfs-actions.pod:3946 ../src/guestfs-actions.pod:3961
30780 #: ../src/guestfs-actions.pod:3977 ../src/guestfs-actions.pod:4033
30781 #: ../src/guestfs-actions.pod:4048
30782 msgid "See also C<guestfs_stat>."
30786 #: ../src/guestfs-actions.pod:3891 ../src/guestfs-actions.pod:3920
30787 #: ../src/guestfs-actions.pod:3965 ../src/guestfs-actions.pod:4037
30788 #: ../src/guestfs-actions.pod:4052
30789 msgid "(Added in 1.5.10)"
30790 msgstr "(Додано у 1.5.10)"
30793 #: ../src/guestfs-actions.pod:3893
30794 msgid "guestfs_is_busy"
30798 #: ../src/guestfs-actions.pod:3895
30802 " guestfs_is_busy (guestfs_h *g);\n"
30807 #: ../src/guestfs-actions.pod:3907
30808 msgid "guestfs_is_chardev"
30812 #: ../src/guestfs-actions.pod:3909
30816 " guestfs_is_chardev (guestfs_h *g,\n"
30817 " const char *path);\n"
30822 #: ../src/guestfs-actions.pod:3922
30823 msgid "guestfs_is_config"
30827 #: ../src/guestfs-actions.pod:3924
30831 " guestfs_is_config (guestfs_h *g);\n"
30836 #: ../src/guestfs-actions.pod:3936
30837 msgid "guestfs_is_dir"
30841 #: ../src/guestfs-actions.pod:3938
30845 " guestfs_is_dir (guestfs_h *g,\n"
30846 " const char *path);\n"
30851 #: ../src/guestfs-actions.pod:3952
30852 msgid "guestfs_is_fifo"
30856 #: ../src/guestfs-actions.pod:3954
30860 " guestfs_is_fifo (guestfs_h *g,\n"
30861 " const char *path);\n"
30866 #: ../src/guestfs-actions.pod:3967
30867 msgid "guestfs_is_file"
30871 #: ../src/guestfs-actions.pod:3969
30875 " guestfs_is_file (guestfs_h *g,\n"
30876 " const char *path);\n"
30881 #: ../src/guestfs-actions.pod:3983
30882 msgid "guestfs_is_launching"
30886 #: ../src/guestfs-actions.pod:3985
30890 " guestfs_is_launching (guestfs_h *g);\n"
30895 #: ../src/guestfs-actions.pod:3997
30896 msgid "guestfs_is_lv"
30900 #: ../src/guestfs-actions.pod:3999
30904 " guestfs_is_lv (guestfs_h *g,\n"
30905 " const char *device);\n"
30910 #: ../src/guestfs-actions.pod:4010
30911 msgid "guestfs_is_ready"
30915 #: ../src/guestfs-actions.pod:4012
30919 " guestfs_is_ready (guestfs_h *g);\n"
30924 #: ../src/guestfs-actions.pod:4024
30925 msgid "guestfs_is_socket"
30929 #: ../src/guestfs-actions.pod:4026
30933 " guestfs_is_socket (guestfs_h *g,\n"
30934 " const char *path);\n"
30939 #: ../src/guestfs-actions.pod:4039
30940 msgid "guestfs_is_symlink"
30944 #: ../src/guestfs-actions.pod:4041
30948 " guestfs_is_symlink (guestfs_h *g,\n"
30949 " const char *path);\n"
30954 #: ../src/guestfs-actions.pod:4054
30955 msgid "guestfs_is_zero"
30959 #: ../src/guestfs-actions.pod:4056
30963 " guestfs_is_zero (guestfs_h *g,\n"
30964 " const char *path);\n"
30969 #: ../src/guestfs-actions.pod:4065 ../src/guestfs-actions.pod:4079
30970 msgid "(Added in 1.11.8)"
30971 msgstr "(Додано у 1.11.8)"
30974 #: ../src/guestfs-actions.pod:4067
30975 msgid "guestfs_is_zero_device"
30979 #: ../src/guestfs-actions.pod:4069
30983 " guestfs_is_zero_device (guestfs_h *g,\n"
30984 " const char *device);\n"
30989 #: ../src/guestfs-actions.pod:4081
30990 msgid "guestfs_kill_subprocess"
30994 #: ../src/guestfs-actions.pod:4083
30998 " guestfs_kill_subprocess (guestfs_h *g);\n"
31003 #: ../src/guestfs-actions.pod:4092
31004 msgid "guestfs_launch"
31008 #: ../src/guestfs-actions.pod:4094
31012 " guestfs_launch (guestfs_h *g);\n"
31017 #: ../src/guestfs-actions.pod:4112
31018 msgid "guestfs_lchown"
31022 #: ../src/guestfs-actions.pod:4114
31026 " guestfs_lchown (guestfs_h *g,\n"
31029 " const char *path);\n"
31034 #: ../src/guestfs-actions.pod:4120
31036 "Change the file owner to C<owner> and group to C<group>. This is like "
31037 "C<guestfs_chown> but if C<path> is a symlink then the link itself is "
31038 "changed, not the target."
31042 #: ../src/guestfs-actions.pod:4132
31043 msgid "guestfs_lgetxattr"
31047 #: ../src/guestfs-actions.pod:4134
31051 " guestfs_lgetxattr (guestfs_h *g,\n"
31052 " const char *path,\n"
31053 " const char *name,\n"
31054 " size_t *size_r);\n"
31059 #: ../src/guestfs-actions.pod:4154
31060 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>."
31064 #: ../src/guestfs-actions.pod:4162
31065 msgid "guestfs_lgetxattrs"
31069 #: ../src/guestfs-actions.pod:4164
31072 " struct guestfs_xattr_list *\n"
31073 " guestfs_lgetxattrs (guestfs_h *g,\n"
31074 " const char *path);\n"
31079 #: ../src/guestfs-actions.pod:4168
31081 "This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, "
31082 "then it returns the extended attributes of the link itself."
31086 #: ../src/guestfs-actions.pod:4178
31087 msgid "guestfs_list_9p"
31091 #: ../src/guestfs-actions.pod:4180
31095 " guestfs_list_9p (guestfs_h *g);\n"
31100 #: ../src/guestfs-actions.pod:4192
31101 msgid "guestfs_list_devices"
31105 #: ../src/guestfs-actions.pod:4194
31109 " guestfs_list_devices (guestfs_h *g);\n"
31114 #: ../src/guestfs-actions.pod:4209
31115 msgid "guestfs_list_dm_devices"
31119 #: ../src/guestfs-actions.pod:4211
31123 " guestfs_list_dm_devices (guestfs_h *g);\n"
31128 #: ../src/guestfs-actions.pod:4216
31130 "The returned list contains C</dev/mapper/*> devices, eg. ones created by a "
31131 "previous call to C<guestfs_luks_open>."
31135 #: ../src/guestfs-actions.pod:4219
31137 "Device mapper devices which correspond to logical volumes are I<not> "
31138 "returned in this list. Call C<guestfs_lvs> if you want to list logical "
31143 #: ../src/guestfs-actions.pod:4227 ../src/guestfs-actions.pod:5813
31144 msgid "(Added in 1.11.15)"
31145 msgstr "(Додано у 1.11.15)"
31148 #: ../src/guestfs-actions.pod:4229
31149 msgid "guestfs_list_filesystems"
31153 #: ../src/guestfs-actions.pod:4231
31157 " guestfs_list_filesystems (guestfs_h *g);\n"
31162 #: ../src/guestfs-actions.pod:4251
31164 "This command runs other libguestfs commands, which might include "
31165 "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this "
31166 "soon after launch and only when nothing is mounted."
31170 #: ../src/guestfs-actions.pod:4255
31172 "Not all of the filesystems returned will be mountable. In particular, swap "
31173 "partitions are returned in the list. Also this command does not check that "
31174 "each filesystem found is valid and mountable, and some filesystems might be "
31175 "mountable but require special options. Filesystems may not all belong to a "
31176 "single logical operating system (use C<guestfs_inspect_os> to look for OSes)."
31180 #: ../src/guestfs-actions.pod:4269 ../src/guestfs-actions.pod:6173
31181 msgid "(Added in 1.5.15)"
31182 msgstr "(Додано у 1.5.15)"
31185 #: ../src/guestfs-actions.pod:4271
31187 #| msgid "guestfs_zero_device"
31188 msgid "guestfs_list_md_devices"
31189 msgstr "guestfs_zero_device"
31192 #: ../src/guestfs-actions.pod:4273
31196 #| " guestfs_lvs (guestfs_h *g);\n"
31200 " guestfs_list_md_devices (guestfs_h *g);\n"
31204 " guestfs_lvs (guestfs_h *g);\n"
31208 #: ../src/guestfs-actions.pod:4282
31209 msgid "guestfs_list_partitions"
31210 msgstr "guestfs_list_partitions"
31213 #: ../src/guestfs-actions.pod:4284
31217 " guestfs_list_partitions (guestfs_h *g);\n"
31221 " guestfs_list_partitions (guestfs_h *g);\n"
31225 #: ../src/guestfs-actions.pod:4291
31227 "This does not return logical volumes. For that you will need to call "
31232 #: ../src/guestfs-actions.pod:4302
31234 msgstr "guestfs_ll"
31237 #: ../src/guestfs-actions.pod:4304
31241 " guestfs_ll (guestfs_h *g,\n"
31242 " const char *directory);\n"
31246 " guestfs_ll (guestfs_h *g,\n"
31247 " const char *directory);\n"
31251 #: ../src/guestfs-actions.pod:4319
31253 msgstr "guestfs_ln"
31256 #: ../src/guestfs-actions.pod:4321
31260 " guestfs_ln (guestfs_h *g,\n"
31261 " const char *target,\n"
31262 " const char *linkname);\n"
31266 " guestfs_ln (guestfs_h *g,\n"
31267 " const char *target,\n"
31268 " const char *linkname);\n"
31272 #: ../src/guestfs-actions.pod:4332
31273 msgid "guestfs_ln_f"
31274 msgstr "guestfs_ln_f"
31277 #: ../src/guestfs-actions.pod:4334
31281 " guestfs_ln_f (guestfs_h *g,\n"
31282 " const char *target,\n"
31283 " const char *linkname);\n"
31287 " guestfs_ln_f (guestfs_h *g,\n"
31288 " const char *target,\n"
31289 " const char *linkname);\n"
31293 #: ../src/guestfs-actions.pod:4346
31294 msgid "guestfs_ln_s"
31295 msgstr "guestfs_ln_s"
31298 #: ../src/guestfs-actions.pod:4348
31302 " guestfs_ln_s (guestfs_h *g,\n"
31303 " const char *target,\n"
31304 " const char *linkname);\n"
31308 " guestfs_ln_s (guestfs_h *g,\n"
31309 " const char *target,\n"
31310 " const char *linkname);\n"
31314 #: ../src/guestfs-actions.pod:4359
31315 msgid "guestfs_ln_sf"
31316 msgstr "guestfs_ln_sf"
31319 #: ../src/guestfs-actions.pod:4361
31323 " guestfs_ln_sf (guestfs_h *g,\n"
31324 " const char *target,\n"
31325 " const char *linkname);\n"
31329 " guestfs_ln_sf (guestfs_h *g,\n"
31330 " const char *target,\n"
31331 " const char *linkname);\n"
31335 #: ../src/guestfs-actions.pod:4373
31336 msgid "guestfs_lremovexattr"
31337 msgstr "guestfs_lremovexattr"
31340 #: ../src/guestfs-actions.pod:4375
31344 " guestfs_lremovexattr (guestfs_h *g,\n"
31345 " const char *xattr,\n"
31346 " const char *path);\n"
31350 " guestfs_lremovexattr (guestfs_h *g,\n"
31351 " const char *xattr,\n"
31352 " const char *path);\n"
31356 #: ../src/guestfs-actions.pod:4380
31358 "This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic "
31359 "link, then it removes an extended attribute of the link itself."
31363 #: ../src/guestfs-actions.pod:4388
31365 msgstr "guestfs_ls"
31368 #: ../src/guestfs-actions.pod:4390
31372 " guestfs_ls (guestfs_h *g,\n"
31373 " const char *directory);\n"
31377 " guestfs_ls (guestfs_h *g,\n"
31378 " const char *directory);\n"
31382 #: ../src/guestfs-actions.pod:4398
31384 "This command is mostly useful for interactive sessions. Programs should "
31385 "probably use C<guestfs_readdir> instead."
31389 #: ../src/guestfs-actions.pod:4407
31390 msgid "guestfs_lsetxattr"
31391 msgstr "guestfs_lsetxattr"
31394 #: ../src/guestfs-actions.pod:4409
31398 " guestfs_lsetxattr (guestfs_h *g,\n"
31399 " const char *xattr,\n"
31400 " const char *val,\n"
31402 " const char *path);\n"
31406 " guestfs_lsetxattr (guestfs_h *g,\n"
31407 " const char *xattr,\n"
31408 " const char *val,\n"
31410 " const char *path);\n"
31414 #: ../src/guestfs-actions.pod:4416
31416 "This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, "
31417 "then it sets an extended attribute of the link itself."
31421 #: ../src/guestfs-actions.pod:4424
31422 msgid "guestfs_lstat"
31423 msgstr "guestfs_lstat"
31426 #: ../src/guestfs-actions.pod:4426
31429 " struct guestfs_stat *\n"
31430 " guestfs_lstat (guestfs_h *g,\n"
31431 " const char *path);\n"
31434 " struct guestfs_stat *\n"
31435 " guestfs_lstat (guestfs_h *g,\n"
31436 " const char *path);\n"
31440 #: ../src/guestfs-actions.pod:4432
31442 "This is the same as C<guestfs_stat> except that if C<path> is a symbolic "
31443 "link, then the link is stat-ed, not the file it refers to."
31447 #: ../src/guestfs-actions.pod:4438 ../src/guestfs-actions.pod:7353
31449 "This function returns a C<struct guestfs_stat *>, or NULL if there was an "
31450 "error. I<The caller must call C<guestfs_free_stat> after use>."
31454 #: ../src/guestfs-actions.pod:4442 ../src/guestfs-actions.pod:7357
31455 #: ../src/guestfs-actions.pod:7375 ../src/guestfs-actions.pod:7876
31456 msgid "(Added in 0.9.2)"
31457 msgstr "(Додано у 0.9.2)"
31460 #: ../src/guestfs-actions.pod:4444
31461 msgid "guestfs_lstatlist"
31462 msgstr "guestfs_lstatlist"
31465 #: ../src/guestfs-actions.pod:4446
31468 " struct guestfs_stat_list *\n"
31469 " guestfs_lstatlist (guestfs_h *g,\n"
31470 " const char *path,\n"
31471 " char *const *names);\n"
31474 " struct guestfs_stat_list *\n"
31475 " guestfs_lstatlist (guestfs_h *g,\n"
31476 " const char *path,\n"
31477 " char *const *names);\n"
31481 #: ../src/guestfs-actions.pod:4451
31483 "This call allows you to perform the C<guestfs_lstat> operation on multiple "
31484 "files, where all files are in the directory C<path>. C<names> is the list "
31485 "of files from this directory."
31489 #: ../src/guestfs-actions.pod:4460
31491 "This call is intended for programs that want to efficiently list a directory "
31492 "contents without making many round-trips. See also C<guestfs_lxattrlist> "
31493 "for a similarly efficient call for getting extended attributes. Very long "
31494 "directory listings might cause the protocol message size to be exceeded, "
31495 "causing this call to fail. The caller must split up such requests into "
31496 "smaller groups of names."
31500 #: ../src/guestfs-actions.pod:4468
31502 "This function returns a C<struct guestfs_stat_list *>, or NULL if there was "
31503 "an error. I<The caller must call C<guestfs_free_stat_list> after use>."
31507 #: ../src/guestfs-actions.pod:4474
31508 msgid "guestfs_luks_add_key"
31509 msgstr "guestfs_luks_add_key"
31512 #: ../src/guestfs-actions.pod:4476
31516 " guestfs_luks_add_key (guestfs_h *g,\n"
31517 " const char *device,\n"
31518 " const char *key,\n"
31519 " const char *newkey,\n"
31524 " guestfs_luks_add_key (guestfs_h *g,\n"
31525 " const char *device,\n"
31526 " const char *key,\n"
31527 " const char *newkey,\n"
31532 #: ../src/guestfs-actions.pod:4488
31534 "Note that if C<keyslot> already contains a key, then this command will "
31535 "fail. You have to use C<guestfs_luks_kill_slot> first to remove that key."
31539 #: ../src/guestfs-actions.pod:4494 ../src/guestfs-actions.pod:4531
31540 #: ../src/guestfs-actions.pod:4551 ../src/guestfs-actions.pod:4571
31541 #: ../src/guestfs-actions.pod:4606 ../src/guestfs-actions.pod:4625
31543 "This function takes a key or passphrase parameter which could contain "
31544 "sensitive material. Read the section L</KEYS AND PASSPHRASES> for more "
31549 #: ../src/guestfs-actions.pod:4498 ../src/guestfs-actions.pod:4535
31550 #: ../src/guestfs-actions.pod:4555 ../src/guestfs-actions.pod:4575
31551 msgid "(Added in 1.5.2)"
31552 msgstr "(Додано у 1.5.2)"
31555 #: ../src/guestfs-actions.pod:4500
31556 msgid "guestfs_luks_close"
31557 msgstr "guestfs_luks_close"
31560 #: ../src/guestfs-actions.pod:4502
31564 " guestfs_luks_close (guestfs_h *g,\n"
31565 " const char *device);\n"
31569 " guestfs_luks_close (guestfs_h *g,\n"
31570 " const char *device);\n"
31574 #: ../src/guestfs-actions.pod:4506
31576 "This closes a LUKS device that was created earlier by C<guestfs_luks_open> "
31577 "or C<guestfs_luks_open_ro>. The C<device> parameter must be the name of the "
31578 "LUKS mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the "
31579 "underlying block device."
31583 #: ../src/guestfs-actions.pod:4514 ../src/guestfs-actions.pod:4610
31584 #: ../src/guestfs-actions.pod:4629 ../src/guestfs-actions.pod:4679
31585 #: ../src/guestfs-actions.pod:4724
31586 msgid "(Added in 1.5.1)"
31587 msgstr "(Додано у 1.5.1)"
31590 #: ../src/guestfs-actions.pod:4516
31591 msgid "guestfs_luks_format"
31592 msgstr "guestfs_luks_format"
31595 #: ../src/guestfs-actions.pod:4518
31599 " guestfs_luks_format (guestfs_h *g,\n"
31600 " const char *device,\n"
31601 " const char *key,\n"
31606 " guestfs_luks_format (guestfs_h *g,\n"
31607 " const char *device,\n"
31608 " const char *key,\n"
31613 #: ../src/guestfs-actions.pod:4537
31614 msgid "guestfs_luks_format_cipher"
31615 msgstr "guestfs_luks_format_cipher"
31618 #: ../src/guestfs-actions.pod:4539
31622 " guestfs_luks_format_cipher (guestfs_h *g,\n"
31623 " const char *device,\n"
31624 " const char *key,\n"
31626 " const char *cipher);\n"
31630 " guestfs_luks_format_cipher (guestfs_h *g,\n"
31631 " const char *device,\n"
31632 " const char *key,\n"
31634 " const char *cipher);\n"
31638 #: ../src/guestfs-actions.pod:4546
31640 "This command is the same as C<guestfs_luks_format> but it also allows you to "
31641 "set the C<cipher> used."
31645 #: ../src/guestfs-actions.pod:4557
31646 msgid "guestfs_luks_kill_slot"
31647 msgstr "guestfs_luks_kill_slot"
31650 #: ../src/guestfs-actions.pod:4559
31654 " guestfs_luks_kill_slot (guestfs_h *g,\n"
31655 " const char *device,\n"
31656 " const char *key,\n"
31661 " guestfs_luks_kill_slot (guestfs_h *g,\n"
31662 " const char *device,\n"
31663 " const char *key,\n"
31668 #: ../src/guestfs-actions.pod:4577
31669 msgid "guestfs_luks_open"
31670 msgstr "guestfs_luks_open"
31673 #: ../src/guestfs-actions.pod:4579
31677 " guestfs_luks_open (guestfs_h *g,\n"
31678 " const char *device,\n"
31679 " const char *key,\n"
31680 " const char *mapname);\n"
31684 " guestfs_luks_open (guestfs_h *g,\n"
31685 " const char *device,\n"
31686 " const char *key,\n"
31687 " const char *mapname);\n"
31691 #: ../src/guestfs-actions.pod:4597
31693 "If this block device contains LVM volume groups, then calling "
31694 "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them "
31699 #: ../src/guestfs-actions.pod:4601
31700 msgid "Use C<guestfs_list_dm_devices> to list all device mapper devices."
31704 #: ../src/guestfs-actions.pod:4612
31705 msgid "guestfs_luks_open_ro"
31706 msgstr "guestfs_luks_open_ro"
31709 #: ../src/guestfs-actions.pod:4614
31713 " guestfs_luks_open_ro (guestfs_h *g,\n"
31714 " const char *device,\n"
31715 " const char *key,\n"
31716 " const char *mapname);\n"
31720 " guestfs_luks_open_ro (guestfs_h *g,\n"
31721 " const char *device,\n"
31722 " const char *key,\n"
31723 " const char *mapname);\n"
31727 #: ../src/guestfs-actions.pod:4620
31729 "This is the same as C<guestfs_luks_open> except that a read-only mapping is "
31734 #: ../src/guestfs-actions.pod:4631
31735 msgid "guestfs_lvcreate"
31736 msgstr "guestfs_lvcreate"
31739 #: ../src/guestfs-actions.pod:4633
31743 " guestfs_lvcreate (guestfs_h *g,\n"
31744 " const char *logvol,\n"
31745 " const char *volgroup,\n"
31750 " guestfs_lvcreate (guestfs_h *g,\n"
31751 " const char *logvol,\n"
31752 " const char *volgroup,\n"
31757 #: ../src/guestfs-actions.pod:4646
31758 msgid "guestfs_lvm_canonical_lv_name"
31759 msgstr "guestfs_lvm_canonical_lv_name"
31762 #: ../src/guestfs-actions.pod:4648
31766 " guestfs_lvm_canonical_lv_name (guestfs_h *g,\n"
31767 " const char *lvname);\n"
31771 " guestfs_lvm_canonical_lv_name (guestfs_h *g,\n"
31772 " const char *lvname);\n"
31776 #: ../src/guestfs-actions.pod:4659
31777 msgid "See also C<guestfs_is_lv>."
31781 #: ../src/guestfs-actions.pod:4664
31782 msgid "(Added in 1.5.24)"
31783 msgstr "(Додано у 1.5.24)"
31786 #: ../src/guestfs-actions.pod:4666
31787 msgid "guestfs_lvm_clear_filter"
31788 msgstr "guestfs_lvm_clear_filter"
31791 #: ../src/guestfs-actions.pod:4668
31795 " guestfs_lvm_clear_filter (guestfs_h *g);\n"
31799 " guestfs_lvm_clear_filter (guestfs_h *g);\n"
31803 #: ../src/guestfs-actions.pod:4671
31805 "This undoes the effect of C<guestfs_lvm_set_filter>. LVM will be able to "
31806 "see every block device."
31810 #: ../src/guestfs-actions.pod:4681
31811 msgid "guestfs_lvm_remove_all"
31812 msgstr "guestfs_lvm_remove_all"
31815 #: ../src/guestfs-actions.pod:4683
31819 " guestfs_lvm_remove_all (guestfs_h *g);\n"
31823 " guestfs_lvm_remove_all (guestfs_h *g);\n"
31827 #: ../src/guestfs-actions.pod:4693
31828 msgid "guestfs_lvm_set_filter"
31829 msgstr "guestfs_lvm_set_filter"
31832 #: ../src/guestfs-actions.pod:4695
31836 " guestfs_lvm_set_filter (guestfs_h *g,\n"
31837 " char *const *devices);\n"
31841 " guestfs_lvm_set_filter (guestfs_h *g,\n"
31842 " char *const *devices);\n"
31846 #: ../src/guestfs-actions.pod:4726
31847 msgid "guestfs_lvremove"
31848 msgstr "guestfs_lvremove"
31851 #: ../src/guestfs-actions.pod:4728
31855 " guestfs_lvremove (guestfs_h *g,\n"
31856 " const char *device);\n"
31860 " guestfs_lvremove (guestfs_h *g,\n"
31861 " const char *device);\n"
31865 #: ../src/guestfs-actions.pod:4740 ../src/guestfs-actions.pod:6288
31866 #: ../src/guestfs-actions.pod:8246
31867 msgid "(Added in 1.0.13)"
31868 msgstr "(Додано у 1.0.13)"
31871 #: ../src/guestfs-actions.pod:4742
31872 msgid "guestfs_lvrename"
31873 msgstr "guestfs_lvrename"
31876 #: ../src/guestfs-actions.pod:4744
31880 " guestfs_lvrename (guestfs_h *g,\n"
31881 " const char *logvol,\n"
31882 " const char *newlogvol);\n"
31886 " guestfs_lvrename (guestfs_h *g,\n"
31887 " const char *logvol,\n"
31888 " const char *newlogvol);\n"
31892 #: ../src/guestfs-actions.pod:4753 ../src/guestfs-actions.pod:8259
31893 msgid "(Added in 1.0.83)"
31894 msgstr "(Додано у 1.0.83)"
31897 #: ../src/guestfs-actions.pod:4755
31898 msgid "guestfs_lvresize"
31899 msgstr "guestfs_lvresize"
31902 #: ../src/guestfs-actions.pod:4757
31906 " guestfs_lvresize (guestfs_h *g,\n"
31907 " const char *device,\n"
31912 " guestfs_lvresize (guestfs_h *g,\n"
31913 " const char *device,\n"
31918 #: ../src/guestfs-actions.pod:4770
31919 msgid "guestfs_lvresize_free"
31920 msgstr "guestfs_lvresize_free"
31923 #: ../src/guestfs-actions.pod:4772
31927 " guestfs_lvresize_free (guestfs_h *g,\n"
31928 " const char *lv,\n"
31933 " guestfs_lvresize_free (guestfs_h *g,\n"
31934 " const char *lv,\n"
31939 #: ../src/guestfs-actions.pod:4785
31940 msgid "(Added in 1.3.3)"
31941 msgstr "(Додано у 1.3.3)"
31944 #: ../src/guestfs-actions.pod:4787
31945 msgid "guestfs_lvs"
31946 msgstr "guestfs_lvs"
31949 #: ../src/guestfs-actions.pod:4789
31953 " guestfs_lvs (guestfs_h *g);\n"
31957 " guestfs_lvs (guestfs_h *g);\n"
31961 #: ../src/guestfs-actions.pod:4798
31962 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>."
31966 #: ../src/guestfs-actions.pod:4806
31967 msgid "guestfs_lvs_full"
31968 msgstr "guestfs_lvs_full"
31971 #: ../src/guestfs-actions.pod:4808
31974 " struct guestfs_lvm_lv_list *\n"
31975 " guestfs_lvs_full (guestfs_h *g);\n"
31978 " struct guestfs_lvm_lv_list *\n"
31979 " guestfs_lvs_full (guestfs_h *g);\n"
31983 #: ../src/guestfs-actions.pod:4814
31985 "This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there "
31986 "was an error. I<The caller must call C<guestfs_free_lvm_lv_list> after use>."
31990 #: ../src/guestfs-actions.pod:4820
31991 msgid "guestfs_lvuuid"
31992 msgstr "guestfs_lvuuid"
31995 #: ../src/guestfs-actions.pod:4822
31999 " guestfs_lvuuid (guestfs_h *g,\n"
32000 " const char *device);\n"
32004 " guestfs_lvuuid (guestfs_h *g,\n"
32005 " const char *device);\n"
32009 #: ../src/guestfs-actions.pod:4833
32010 msgid "guestfs_lxattrlist"
32011 msgstr "guestfs_lxattrlist"
32014 #: ../src/guestfs-actions.pod:4835
32017 " struct guestfs_xattr_list *\n"
32018 " guestfs_lxattrlist (guestfs_h *g,\n"
32019 " const char *path,\n"
32020 " char *const *names);\n"
32023 " struct guestfs_xattr_list *\n"
32024 " guestfs_lxattrlist (guestfs_h *g,\n"
32025 " const char *path,\n"
32026 " char *const *names);\n"
32030 #: ../src/guestfs-actions.pod:4854
32032 "This call is intended for programs that want to efficiently list a directory "
32033 "contents without making many round-trips. See also C<guestfs_lstatlist> for "
32034 "a similarly efficient call for getting standard stats. Very long directory "
32035 "listings might cause the protocol message size to be exceeded, causing this "
32036 "call to fail. The caller must split up such requests into smaller groups of "
32041 #: ../src/guestfs-actions.pod:4868
32043 #| msgid "guestfs_create"
32044 msgid "guestfs_mdadm_create"
32045 msgstr "guestfs_create"
32048 #: ../src/guestfs-actions.pod:4870
32052 #| " guestfs_mkfs_opts (guestfs_h *g,\n"
32053 #| " const char *fstype,\n"
32054 #| " const char *device,\n"
32059 " guestfs_mdadm_create (guestfs_h *g,\n"
32060 " const char *name,\n"
32061 " char *const *devices,\n"
32066 " guestfs_mkfs_opts (guestfs_h *g,\n"
32067 " const char *fstype,\n"
32068 " const char *device,\n"
32073 #: ../src/guestfs-actions.pod:4881
32076 " GUESTFS_MDADM_CREATE_MISSINGBITMAP, int64_t missingbitmap,\n"
32077 " GUESTFS_MDADM_CREATE_NRDEVICES, int nrdevices,\n"
32078 " GUESTFS_MDADM_CREATE_SPARE, int spare,\n"
32079 " GUESTFS_MDADM_CREATE_CHUNK, int64_t chunk,\n"
32080 " GUESTFS_MDADM_CREATE_LEVEL, const char *level,\n"
32085 #: ../src/guestfs-actions.pod:4943
32087 #| msgid "guestfs_create"
32088 msgid "guestfs_mdadm_create_va"
32089 msgstr "guestfs_create"
32092 #: ../src/guestfs-actions.pod:4945
32096 #| " guestfs_mkfs_opts_va (guestfs_h *g,\n"
32097 #| " const char *fstype,\n"
32098 #| " const char *device,\n"
32099 #| " va_list args);\n"
32103 " guestfs_mdadm_create_va (guestfs_h *g,\n"
32104 " const char *name,\n"
32105 " char *const *devices,\n"
32106 " va_list args);\n"
32110 " guestfs_mkfs_opts_va (guestfs_h *g,\n"
32111 " const char *fstype,\n"
32112 " const char *device,\n"
32113 " va_list args);\n"
32117 #: ../src/guestfs-actions.pod:4951
32118 msgid "This is the \"va_list variant\" of L</guestfs_mdadm_create>."
32122 #: ../src/guestfs-actions.pod:4955
32124 #| msgid "guestfs_create"
32125 msgid "guestfs_mdadm_create_argv"
32126 msgstr "guestfs_create"
32129 #: ../src/guestfs-actions.pod:4957
32133 #| " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
32134 #| " const char *fstype,\n"
32135 #| " const char *device,\n"
32136 #| " const struct guestfs_mkfs_opts_argv *optargs);\n"
32140 " guestfs_mdadm_create_argv (guestfs_h *g,\n"
32141 " const char *name,\n"
32142 " char *const *devices,\n"
32143 " const struct guestfs_mdadm_create_argv *optargs);\n"
32147 " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
32148 " const char *fstype,\n"
32149 " const char *device,\n"
32150 " const struct guestfs_mkfs_opts_argv *optargs);\n"
32154 #: ../src/guestfs-actions.pod:4963
32155 msgid "This is the \"argv variant\" of L</guestfs_mdadm_create>."
32159 #: ../src/guestfs-actions.pod:4967
32161 #| msgid "guestfs_aug_get"
32162 msgid "guestfs_mdadm_detail"
32163 msgstr "guestfs_aug_get"
32166 #: ../src/guestfs-actions.pod:4969
32170 #| " guestfs_aug_get (guestfs_h *g,\n"
32171 #| " const char *augpath);\n"
32175 " guestfs_mdadm_detail (guestfs_h *g,\n"
32176 " const char *md);\n"
32180 " guestfs_aug_get (guestfs_h *g,\n"
32181 " const char *augpath);\n"
32185 #: ../src/guestfs-actions.pod:5006
32186 msgid "guestfs_mkdir"
32187 msgstr "guestfs_mkdir"
32190 #: ../src/guestfs-actions.pod:5008
32194 " guestfs_mkdir (guestfs_h *g,\n"
32195 " const char *path);\n"
32199 " guestfs_mkdir (guestfs_h *g,\n"
32200 " const char *path);\n"
32204 #: ../src/guestfs-actions.pod:5018
32205 msgid "guestfs_mkdir_mode"
32206 msgstr "guestfs_mkdir_mode"
32209 #: ../src/guestfs-actions.pod:5020
32213 " guestfs_mkdir_mode (guestfs_h *g,\n"
32214 " const char *path,\n"
32219 " guestfs_mkdir_mode (guestfs_h *g,\n"
32220 " const char *path,\n"
32225 #: ../src/guestfs-actions.pod:5032
32226 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>"
32230 #: ../src/guestfs-actions.pod:5038
32231 msgid "guestfs_mkdir_p"
32232 msgstr "guestfs_mkdir_p"
32235 #: ../src/guestfs-actions.pod:5040
32239 " guestfs_mkdir_p (guestfs_h *g,\n"
32240 " const char *path);\n"
32244 " guestfs_mkdir_p (guestfs_h *g,\n"
32245 " const char *path);\n"
32249 #: ../src/guestfs-actions.pod:5051
32250 msgid "guestfs_mkdtemp"
32251 msgstr "guestfs_mkdtemp"
32254 #: ../src/guestfs-actions.pod:5053
32258 " guestfs_mkdtemp (guestfs_h *g,\n"
32259 " const char *template);\n"
32263 " guestfs_mkdtemp (guestfs_h *g,\n"
32264 " const char *template);\n"
32268 #: ../src/guestfs-actions.pod:5081
32269 msgid "guestfs_mke2fs_J"
32270 msgstr "guestfs_mke2fs_J"
32273 #: ../src/guestfs-actions.pod:5083
32277 " guestfs_mke2fs_J (guestfs_h *g,\n"
32278 " const char *fstype,\n"
32279 " int blocksize,\n"
32280 " const char *device,\n"
32281 " const char *journal);\n"
32285 " guestfs_mke2fs_J (guestfs_h *g,\n"
32286 " const char *fstype,\n"
32287 " int blocksize,\n"
32288 " const char *device,\n"
32289 " const char *journal);\n"
32293 #: ../src/guestfs-actions.pod:5096
32294 msgid "See also C<guestfs_mke2journal>."
32298 #: ../src/guestfs-actions.pod:5100 ../src/guestfs-actions.pod:5118
32299 #: ../src/guestfs-actions.pod:5136 ../src/guestfs-actions.pod:5152
32300 #: ../src/guestfs-actions.pod:5166 ../src/guestfs-actions.pod:5180
32301 #: ../src/guestfs-actions.pod:5239 ../src/guestfs-actions.pod:5516
32302 msgid "(Added in 1.0.68)"
32303 msgstr "(Додано у 1.0.68)"
32306 #: ../src/guestfs-actions.pod:5102
32307 msgid "guestfs_mke2fs_JL"
32308 msgstr "guestfs_mke2fs_JL"
32311 #: ../src/guestfs-actions.pod:5104
32315 " guestfs_mke2fs_JL (guestfs_h *g,\n"
32316 " const char *fstype,\n"
32317 " int blocksize,\n"
32318 " const char *device,\n"
32319 " const char *label);\n"
32323 " guestfs_mke2fs_JL (guestfs_h *g,\n"
32324 " const char *fstype,\n"
32325 " int blocksize,\n"
32326 " const char *device,\n"
32327 " const char *label);\n"
32331 #: ../src/guestfs-actions.pod:5114
32332 msgid "See also C<guestfs_mke2journal_L>."
32336 #: ../src/guestfs-actions.pod:5120
32337 msgid "guestfs_mke2fs_JU"
32338 msgstr "guestfs_mke2fs_JU"
32341 #: ../src/guestfs-actions.pod:5122
32345 " guestfs_mke2fs_JU (guestfs_h *g,\n"
32346 " const char *fstype,\n"
32347 " int blocksize,\n"
32348 " const char *device,\n"
32349 " const char *uuid);\n"
32353 " guestfs_mke2fs_JU (guestfs_h *g,\n"
32354 " const char *fstype,\n"
32355 " int blocksize,\n"
32356 " const char *device,\n"
32357 " const char *uuid);\n"
32361 #: ../src/guestfs-actions.pod:5132
32362 msgid "See also C<guestfs_mke2journal_U>."
32366 #: ../src/guestfs-actions.pod:5138
32367 msgid "guestfs_mke2journal"
32368 msgstr "guestfs_mke2journal"
32371 #: ../src/guestfs-actions.pod:5140
32375 " guestfs_mke2journal (guestfs_h *g,\n"
32376 " int blocksize,\n"
32377 " const char *device);\n"
32381 " guestfs_mke2journal (guestfs_h *g,\n"
32382 " int blocksize,\n"
32383 " const char *device);\n"
32387 #: ../src/guestfs-actions.pod:5154
32388 msgid "guestfs_mke2journal_L"
32389 msgstr "guestfs_mke2journal_L"
32392 #: ../src/guestfs-actions.pod:5156
32396 " guestfs_mke2journal_L (guestfs_h *g,\n"
32397 " int blocksize,\n"
32398 " const char *label,\n"
32399 " const char *device);\n"
32403 " guestfs_mke2journal_L (guestfs_h *g,\n"
32404 " int blocksize,\n"
32405 " const char *label,\n"
32406 " const char *device);\n"
32410 #: ../src/guestfs-actions.pod:5168
32411 msgid "guestfs_mke2journal_U"
32412 msgstr "guestfs_mke2journal_U"
32415 #: ../src/guestfs-actions.pod:5170
32419 " guestfs_mke2journal_U (guestfs_h *g,\n"
32420 " int blocksize,\n"
32421 " const char *uuid,\n"
32422 " const char *device);\n"
32426 " guestfs_mke2journal_U (guestfs_h *g,\n"
32427 " int blocksize,\n"
32428 " const char *uuid,\n"
32429 " const char *device);\n"
32433 #: ../src/guestfs-actions.pod:5182
32434 msgid "guestfs_mkfifo"
32435 msgstr "guestfs_mkfifo"
32438 #: ../src/guestfs-actions.pod:5184
32442 " guestfs_mkfifo (guestfs_h *g,\n"
32444 " const char *path);\n"
32448 " guestfs_mkfifo (guestfs_h *g,\n"
32450 " const char *path);\n"
32454 #: ../src/guestfs-actions.pod:5189
32456 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>. It "
32457 "is just a convenient wrapper around C<guestfs_mknod>."
32461 #: ../src/guestfs-actions.pod:5199
32462 msgid "guestfs_mkfs"
32463 msgstr "guestfs_mkfs"
32466 #: ../src/guestfs-actions.pod:5201
32470 " guestfs_mkfs (guestfs_h *g,\n"
32471 " const char *fstype,\n"
32472 " const char *device);\n"
32476 " guestfs_mkfs (guestfs_h *g,\n"
32477 " const char *fstype,\n"
32478 " const char *device);\n"
32482 #: ../src/guestfs-actions.pod:5214
32483 msgid "guestfs_mkfs_b"
32484 msgstr "guestfs_mkfs_b"
32487 #: ../src/guestfs-actions.pod:5216
32491 " guestfs_mkfs_b (guestfs_h *g,\n"
32492 " const char *fstype,\n"
32493 " int blocksize,\n"
32494 " const char *device);\n"
32498 " guestfs_mkfs_b (guestfs_h *g,\n"
32499 " const char *fstype,\n"
32500 " int blocksize,\n"
32501 " const char *device);\n"
32505 #: ../src/guestfs-actions.pod:5222
32507 "I<This function is deprecated.> In new code, use the L</guestfs_mkfs_opts> "
32512 #: ../src/guestfs-actions.pod:5229
32514 "This call is similar to C<guestfs_mkfs>, but it allows you to control the "
32515 "block size of the resulting filesystem. Supported block sizes depend on the "
32516 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
32520 #: ../src/guestfs-actions.pod:5241
32521 msgid "guestfs_mkfs_opts"
32522 msgstr "guestfs_mkfs_opts"
32525 #: ../src/guestfs-actions.pod:5243
32529 " guestfs_mkfs_opts (guestfs_h *g,\n"
32530 " const char *fstype,\n"
32531 " const char *device,\n"
32536 " guestfs_mkfs_opts (guestfs_h *g,\n"
32537 " const char *fstype,\n"
32538 " const char *device,\n"
32543 #: ../src/guestfs-actions.pod:5254
32546 " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n"
32547 " GUESTFS_MKFS_OPTS_FEATURES, const char *features,\n"
32548 " GUESTFS_MKFS_OPTS_INODE, int inode,\n"
32549 " GUESTFS_MKFS_OPTS_SECTORSIZE, int sectorsize,\n"
32554 #: ../src/guestfs-actions.pod:5302
32555 msgid "(Added in 1.7.19)"
32556 msgstr "(Додано у 1.7.19)"
32559 #: ../src/guestfs-actions.pod:5304
32560 msgid "guestfs_mkfs_opts_va"
32561 msgstr "guestfs_mkfs_opts_va"
32564 #: ../src/guestfs-actions.pod:5306
32568 " guestfs_mkfs_opts_va (guestfs_h *g,\n"
32569 " const char *fstype,\n"
32570 " const char *device,\n"
32571 " va_list args);\n"
32575 " guestfs_mkfs_opts_va (guestfs_h *g,\n"
32576 " const char *fstype,\n"
32577 " const char *device,\n"
32578 " va_list args);\n"
32582 #: ../src/guestfs-actions.pod:5312
32583 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>."
32587 #: ../src/guestfs-actions.pod:5316
32588 msgid "guestfs_mkfs_opts_argv"
32589 msgstr "guestfs_mkfs_opts_argv"
32592 #: ../src/guestfs-actions.pod:5318
32596 " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
32597 " const char *fstype,\n"
32598 " const char *device,\n"
32599 " const struct guestfs_mkfs_opts_argv *optargs);\n"
32603 " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
32604 " const char *fstype,\n"
32605 " const char *device,\n"
32606 " const struct guestfs_mkfs_opts_argv *optargs);\n"
32610 #: ../src/guestfs-actions.pod:5324
32611 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>."
32615 #: ../src/guestfs-actions.pod:5328
32616 msgid "guestfs_mkmountpoint"
32617 msgstr "guestfs_mkmountpoint"
32620 #: ../src/guestfs-actions.pod:5330
32624 " guestfs_mkmountpoint (guestfs_h *g,\n"
32625 " const char *exemptpath);\n"
32629 " guestfs_mkmountpoint (guestfs_h *g,\n"
32630 " const char *exemptpath);\n"
32634 #: ../src/guestfs-actions.pod:5334
32636 "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls "
32637 "that can be used to create extra mountpoints before mounting the first "
32642 #: ../src/guestfs-actions.pod:5358
32644 "C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>. You "
32645 "may get unexpected errors if you try to mix these calls. It is safest to "
32646 "manually unmount filesystems and remove mountpoints after use."
32650 #: ../src/guestfs-actions.pod:5362
32652 "C<guestfs_umount_all> unmounts filesystems by sorting the paths longest "
32653 "first, so for this to work for manual mountpoints, you must ensure that the "
32654 "innermost mountpoints have the longest pathnames, as in the example code "
32659 #: ../src/guestfs-actions.pod:5369
32661 "Autosync [see C<guestfs_set_autosync>, this is set by default on handles] "
32662 "can cause C<guestfs_umount_all> to be called when the handle is closed which "
32663 "can also trigger these issues."
32667 #: ../src/guestfs-actions.pod:5375 ../src/guestfs-actions.pod:5681
32668 #: ../src/guestfs-actions.pod:6708
32669 msgid "(Added in 1.0.62)"
32670 msgstr "(Додано у 1.0.62)"
32673 #: ../src/guestfs-actions.pod:5377
32674 msgid "guestfs_mknod"
32678 #: ../src/guestfs-actions.pod:5379
32682 " guestfs_mknod (guestfs_h *g,\n"
32686 " const char *path);\n"
32691 #: ../src/guestfs-actions.pod:5394
32693 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
32694 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
32695 "regular file). These constants are available in the standard Linux header "
32696 "files, or you can use C<guestfs_mknod_b>, C<guestfs_mknod_c> or "
32697 "C<guestfs_mkfifo> which are wrappers around this command which bitwise OR in "
32698 "the appropriate constant for you."
32702 #: ../src/guestfs-actions.pod:5408
32703 msgid "guestfs_mknod_b"
32707 #: ../src/guestfs-actions.pod:5410
32711 " guestfs_mknod_b (guestfs_h *g,\n"
32715 " const char *path);\n"
32720 #: ../src/guestfs-actions.pod:5417
32722 "This call creates a block device node called C<path> with mode C<mode> and "
32723 "device major/minor C<devmajor> and C<devminor>. It is just a convenient "
32724 "wrapper around C<guestfs_mknod>."
32728 #: ../src/guestfs-actions.pod:5427
32729 msgid "guestfs_mknod_c"
32733 #: ../src/guestfs-actions.pod:5429
32737 " guestfs_mknod_c (guestfs_h *g,\n"
32741 " const char *path);\n"
32746 #: ../src/guestfs-actions.pod:5436
32748 "This call creates a char device node called C<path> with mode C<mode> and "
32749 "device major/minor C<devmajor> and C<devminor>. It is just a convenient "
32750 "wrapper around C<guestfs_mknod>."
32754 #: ../src/guestfs-actions.pod:5446
32755 msgid "guestfs_mkswap"
32759 #: ../src/guestfs-actions.pod:5448
32763 " guestfs_mkswap (guestfs_h *g,\n"
32764 " const char *device);\n"
32769 #: ../src/guestfs-actions.pod:5458
32770 msgid "guestfs_mkswap_L"
32774 #: ../src/guestfs-actions.pod:5460
32778 " guestfs_mkswap_L (guestfs_h *g,\n"
32779 " const char *label,\n"
32780 " const char *device);\n"
32785 #: ../src/guestfs-actions.pod:5475
32786 msgid "guestfs_mkswap_U"
32790 #: ../src/guestfs-actions.pod:5477
32794 " guestfs_mkswap_U (guestfs_h *g,\n"
32795 " const char *uuid,\n"
32796 " const char *device);\n"
32801 #: ../src/guestfs-actions.pod:5488
32802 msgid "guestfs_mkswap_file"
32806 #: ../src/guestfs-actions.pod:5490
32810 " guestfs_mkswap_file (guestfs_h *g,\n"
32811 " const char *path);\n"
32816 #: ../src/guestfs-actions.pod:5496
32818 "This command just writes a swap file signature to an existing file. To "
32819 "create the file itself, use something like C<guestfs_fallocate>."
32823 #: ../src/guestfs-actions.pod:5503
32824 msgid "guestfs_modprobe"
32828 #: ../src/guestfs-actions.pod:5505
32832 " guestfs_modprobe (guestfs_h *g,\n"
32833 " const char *modulename);\n"
32838 #: ../src/guestfs-actions.pod:5518
32839 msgid "guestfs_mount"
32843 #: ../src/guestfs-actions.pod:5520
32847 " guestfs_mount (guestfs_h *g,\n"
32848 " const char *device,\n"
32849 " const char *mountpoint);\n"
32854 #: ../src/guestfs-actions.pod:5539
32856 "Before libguestfs 1.13.16, this call implicitly added the options C<sync> "
32857 "and C<noatime>. The C<sync> option greatly slowed writes and caused many "
32858 "problems for users. If your program might need to work with older versions "
32859 "of libguestfs, use C<guestfs_mount_options> instead (using an empty string "
32860 "for the first parameter if you don't want any options)."
32864 #: ../src/guestfs-actions.pod:5550
32865 msgid "guestfs_mount_9p"
32869 #: ../src/guestfs-actions.pod:5552
32873 " guestfs_mount_9p (guestfs_h *g,\n"
32874 " const char *mounttag,\n"
32875 " const char *mountpoint,\n"
32881 #: ../src/guestfs-actions.pod:5563
32884 " GUESTFS_MOUNT_9P_OPTIONS, const char *options,\n"
32889 #: ../src/guestfs-actions.pod:5576
32890 msgid "guestfs_mount_9p_va"
32894 #: ../src/guestfs-actions.pod:5578
32898 " guestfs_mount_9p_va (guestfs_h *g,\n"
32899 " const char *mounttag,\n"
32900 " const char *mountpoint,\n"
32901 " va_list args);\n"
32906 #: ../src/guestfs-actions.pod:5584
32907 msgid "This is the \"va_list variant\" of L</guestfs_mount_9p>."
32911 #: ../src/guestfs-actions.pod:5588
32912 msgid "guestfs_mount_9p_argv"
32916 #: ../src/guestfs-actions.pod:5590
32920 " guestfs_mount_9p_argv (guestfs_h *g,\n"
32921 " const char *mounttag,\n"
32922 " const char *mountpoint,\n"
32923 " const struct guestfs_mount_9p_argv *optargs);\n"
32928 #: ../src/guestfs-actions.pod:5596
32929 msgid "This is the \"argv variant\" of L</guestfs_mount_9p>."
32933 #: ../src/guestfs-actions.pod:5600
32934 msgid "guestfs_mount_loop"
32938 #: ../src/guestfs-actions.pod:5602
32942 " guestfs_mount_loop (guestfs_h *g,\n"
32943 " const char *file,\n"
32944 " const char *mountpoint);\n"
32949 #: ../src/guestfs-actions.pod:5615
32950 msgid "guestfs_mount_options"
32954 #: ../src/guestfs-actions.pod:5617
32958 " guestfs_mount_options (guestfs_h *g,\n"
32959 " const char *options,\n"
32960 " const char *device,\n"
32961 " const char *mountpoint);\n"
32966 #: ../src/guestfs-actions.pod:5623
32968 "This is the same as the C<guestfs_mount> command, but it allows you to set "
32969 "the mount options as for the L<mount(8)> I<-o> flag."
32973 #: ../src/guestfs-actions.pod:5633 ../src/guestfs-actions.pod:5647
32974 #: ../src/guestfs-actions.pod:5664
32975 msgid "(Added in 1.0.10)"
32976 msgstr "(Додано у 1.0.10)"
32979 #: ../src/guestfs-actions.pod:5635
32980 msgid "guestfs_mount_ro"
32984 #: ../src/guestfs-actions.pod:5637
32988 " guestfs_mount_ro (guestfs_h *g,\n"
32989 " const char *device,\n"
32990 " const char *mountpoint);\n"
32995 #: ../src/guestfs-actions.pod:5642
32997 "This is the same as the C<guestfs_mount> command, but it mounts the "
32998 "filesystem with the read-only (I<-o ro>) flag."
33002 #: ../src/guestfs-actions.pod:5649
33003 msgid "guestfs_mount_vfs"
33007 #: ../src/guestfs-actions.pod:5651
33011 " guestfs_mount_vfs (guestfs_h *g,\n"
33012 " const char *options,\n"
33013 " const char *vfstype,\n"
33014 " const char *device,\n"
33015 " const char *mountpoint);\n"
33020 #: ../src/guestfs-actions.pod:5658
33022 "This is the same as the C<guestfs_mount> command, but it allows you to set "
33023 "both the mount options and the vfstype as for the L<mount(8)> I<-o> and I<-"
33028 #: ../src/guestfs-actions.pod:5666
33029 msgid "guestfs_mountpoints"
33033 #: ../src/guestfs-actions.pod:5668
33037 " guestfs_mountpoints (guestfs_h *g);\n"
33042 #: ../src/guestfs-actions.pod:5671
33044 "This call is similar to C<guestfs_mounts>. That call returns a list of "
33045 "devices. This one returns a hash table (map) of device name to directory "
33046 "where the device is mounted."
33050 #: ../src/guestfs-actions.pod:5683
33051 msgid "guestfs_mounts"
33055 #: ../src/guestfs-actions.pod:5685
33059 " guestfs_mounts (guestfs_h *g);\n"
33064 #: ../src/guestfs-actions.pod:5693
33065 msgid "See also: C<guestfs_mountpoints>"
33069 #: ../src/guestfs-actions.pod:5701
33074 #: ../src/guestfs-actions.pod:5703
33078 " guestfs_mv (guestfs_h *g,\n"
33079 " const char *src,\n"
33080 " const char *dest);\n"
33085 #: ../src/guestfs-actions.pod:5715
33086 msgid "guestfs_ntfs_3g_probe"
33090 #: ../src/guestfs-actions.pod:5717
33094 " guestfs_ntfs_3g_probe (guestfs_h *g,\n"
33096 " const char *device);\n"
33101 #: ../src/guestfs-actions.pod:5736
33102 msgid "(Added in 1.0.43)"
33103 msgstr "(Додано у 1.0.43)"
33106 #: ../src/guestfs-actions.pod:5738
33107 msgid "guestfs_ntfsresize"
33111 #: ../src/guestfs-actions.pod:5740
33115 " guestfs_ntfsresize (guestfs_h *g,\n"
33116 " const char *device);\n"
33121 #: ../src/guestfs-actions.pod:5744 ../src/guestfs-actions.pod:5844
33123 "I<This function is deprecated.> In new code, use the L</"
33124 "guestfs_ntfsresize_opts> call instead."
33128 #: ../src/guestfs-actions.pod:5768
33129 msgid "guestfs_ntfsresize_opts"
33133 #: ../src/guestfs-actions.pod:5770
33137 " guestfs_ntfsresize_opts (guestfs_h *g,\n"
33138 " const char *device,\n"
33144 #: ../src/guestfs-actions.pod:5780
33147 " GUESTFS_NTFSRESIZE_OPTS_SIZE, int64_t size,\n"
33148 " GUESTFS_NTFSRESIZE_OPTS_FORCE, int force,\n"
33153 #: ../src/guestfs-actions.pod:5800
33155 "After the resize operation, the filesystem is always marked as requiring a "
33156 "consistency check (for safety). You have to boot into Windows to perform "
33157 "this check and clear this condition. If you I<don't> set the C<force> "
33158 "option then it is not possible to call C<guestfs_ntfsresize_opts> multiple "
33159 "times on a single filesystem without booting into Windows between each "
33164 #: ../src/guestfs-actions.pod:5815
33165 msgid "guestfs_ntfsresize_opts_va"
33169 #: ../src/guestfs-actions.pod:5817
33173 " guestfs_ntfsresize_opts_va (guestfs_h *g,\n"
33174 " const char *device,\n"
33175 " va_list args);\n"
33180 #: ../src/guestfs-actions.pod:5822
33181 msgid "This is the \"va_list variant\" of L</guestfs_ntfsresize_opts>."
33185 #: ../src/guestfs-actions.pod:5826
33186 msgid "guestfs_ntfsresize_opts_argv"
33190 #: ../src/guestfs-actions.pod:5828
33194 " guestfs_ntfsresize_opts_argv (guestfs_h *g,\n"
33195 " const char *device,\n"
33196 " const struct guestfs_ntfsresize_opts_argv *optargs);\n"
33201 #: ../src/guestfs-actions.pod:5833
33202 msgid "This is the \"argv variant\" of L</guestfs_ntfsresize_opts>."
33206 #: ../src/guestfs-actions.pod:5837
33207 msgid "guestfs_ntfsresize_size"
33211 #: ../src/guestfs-actions.pod:5839
33215 " guestfs_ntfsresize_size (guestfs_h *g,\n"
33216 " const char *device,\n"
33217 " int64_t size);\n"
33222 #: ../src/guestfs-actions.pod:5851
33224 "This command is the same as C<guestfs_ntfsresize> except that it allows you "
33225 "to specify the new size (in bytes) explicitly."
33229 #: ../src/guestfs-actions.pod:5856 ../src/guestfs-actions.pod:6315
33230 #: ../src/guestfs-actions.pod:6388 ../src/guestfs-actions.pod:6656
33231 #: ../src/guestfs-actions.pod:8403
33232 msgid "(Added in 1.3.14)"
33233 msgstr "(Додано у 1.3.14)"
33236 #: ../src/guestfs-actions.pod:5858
33237 msgid "guestfs_part_add"
33241 #: ../src/guestfs-actions.pod:5860
33245 " guestfs_part_add (guestfs_h *g,\n"
33246 " const char *device,\n"
33247 " const char *prlogex,\n"
33248 " int64_t startsect,\n"
33249 " int64_t endsect);\n"
33254 #: ../src/guestfs-actions.pod:5867
33256 "This command adds a partition to C<device>. If there is no partition table "
33257 "on the device, call C<guestfs_part_init> first."
33261 #: ../src/guestfs-actions.pod:5879
33263 "Creating a partition which covers the whole disk is not so easy. Use "
33264 "C<guestfs_part_disk> to do that."
33268 #: ../src/guestfs-actions.pod:5884 ../src/guestfs-actions.pod:5919
33269 #: ../src/guestfs-actions.pod:5972 ../src/guestfs-actions.pod:6056
33270 #: ../src/guestfs-actions.pod:6094 ../src/guestfs-actions.pod:6113
33271 #: ../src/guestfs-actions.pod:6153
33272 msgid "(Added in 1.0.78)"
33273 msgstr "(Додано у 1.0.78)"
33276 #: ../src/guestfs-actions.pod:5886
33277 msgid "guestfs_part_del"
33281 #: ../src/guestfs-actions.pod:5888
33285 " guestfs_part_del (guestfs_h *g,\n"
33286 " const char *device,\n"
33292 #: ../src/guestfs-actions.pod:5903
33293 msgid "guestfs_part_disk"
33297 #: ../src/guestfs-actions.pod:5905
33301 " guestfs_part_disk (guestfs_h *g,\n"
33302 " const char *device,\n"
33303 " const char *parttype);\n"
33308 #: ../src/guestfs-actions.pod:5910
33310 "This command is simply a combination of C<guestfs_part_init> followed by "
33311 "C<guestfs_part_add> to create a single primary partition covering the whole "
33316 #: ../src/guestfs-actions.pod:5914
33318 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
33319 "possible values are described in C<guestfs_part_init>."
33323 #: ../src/guestfs-actions.pod:5921
33324 msgid "guestfs_part_get_bootable"
33328 #: ../src/guestfs-actions.pod:5923
33332 " guestfs_part_get_bootable (guestfs_h *g,\n"
33333 " const char *device,\n"
33339 #: ../src/guestfs-actions.pod:5931
33340 msgid "See also C<guestfs_part_set_bootable>."
33344 #: ../src/guestfs-actions.pod:5937
33345 msgid "guestfs_part_get_mbr_id"
33349 #: ../src/guestfs-actions.pod:5939
33353 " guestfs_part_get_mbr_id (guestfs_h *g,\n"
33354 " const char *device,\n"
33360 #: ../src/guestfs-actions.pod:5947 ../src/guestfs-actions.pod:6129
33362 "Note that only MBR (old DOS-style) partitions have type bytes. You will get "
33363 "undefined results for other partition table types (see "
33364 "C<guestfs_part_get_parttype>)."
33368 #: ../src/guestfs-actions.pod:5955
33369 msgid "guestfs_part_get_parttype"
33373 #: ../src/guestfs-actions.pod:5957
33377 " guestfs_part_get_parttype (guestfs_h *g,\n"
33378 " const char *device);\n"
33383 #: ../src/guestfs-actions.pod:5964
33385 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
33386 "table), C<gpt> (a GPT/EFI-style partition table). Other values are "
33387 "possible, although unusual. See C<guestfs_part_init> for a full list."
33391 #: ../src/guestfs-actions.pod:5974
33392 msgid "guestfs_part_init"
33396 #: ../src/guestfs-actions.pod:5976
33400 " guestfs_part_init (guestfs_h *g,\n"
33401 " const char *device,\n"
33402 " const char *parttype);\n"
33407 #: ../src/guestfs-actions.pod:5985
33409 "Initially there are no partitions. Following this, you should call "
33410 "C<guestfs_part_add> for each partition required."
33414 #: ../src/guestfs-actions.pod:6058
33415 msgid "guestfs_part_list"
33416 msgstr "guestfs_part_list"
33419 #: ../src/guestfs-actions.pod:6060
33422 " struct guestfs_partition_list *\n"
33423 " guestfs_part_list (guestfs_h *g,\n"
33424 " const char *device);\n"
33427 " struct guestfs_partition_list *\n"
33428 " guestfs_part_list (guestfs_h *g,\n"
33429 " const char *device);\n"
33433 #: ../src/guestfs-actions.pod:6077
33435 "Start of the partition I<in bytes>. To get sectors you have to divide by "
33436 "the device's sector size, see C<guestfs_blockdev_getss>."
33440 #: ../src/guestfs-actions.pod:6090
33442 "This function returns a C<struct guestfs_partition_list *>, or NULL if there "
33443 "was an error. I<The caller must call C<guestfs_free_partition_list> after "
33448 #: ../src/guestfs-actions.pod:6096
33449 msgid "guestfs_part_set_bootable"
33453 #: ../src/guestfs-actions.pod:6098
33457 " guestfs_part_set_bootable (guestfs_h *g,\n"
33458 " const char *device,\n"
33460 " int bootable);\n"
33465 #: ../src/guestfs-actions.pod:6115
33466 msgid "guestfs_part_set_mbr_id"
33470 #: ../src/guestfs-actions.pod:6117
33474 " guestfs_part_set_mbr_id (guestfs_h *g,\n"
33475 " const char *device,\n"
33482 #: ../src/guestfs-actions.pod:6137
33483 msgid "guestfs_part_set_name"
33487 #: ../src/guestfs-actions.pod:6139
33491 " guestfs_part_set_name (guestfs_h *g,\n"
33492 " const char *device,\n"
33494 " const char *name);\n"
33499 #: ../src/guestfs-actions.pod:6155
33500 msgid "guestfs_part_to_dev"
33504 #: ../src/guestfs-actions.pod:6157
33508 " guestfs_part_to_dev (guestfs_h *g,\n"
33509 " const char *partition);\n"
33514 #: ../src/guestfs-actions.pod:6165 ../src/guestfs-actions.pod:6184
33516 "The named partition must exist, for example as a string returned from "
33517 "C<guestfs_list_partitions>."
33521 #: ../src/guestfs-actions.pod:6168
33522 msgid "See also C<guestfs_part_to_partnum>."
33526 #: ../src/guestfs-actions.pod:6175
33527 msgid "guestfs_part_to_partnum"
33531 #: ../src/guestfs-actions.pod:6177
33535 " guestfs_part_to_partnum (guestfs_h *g,\n"
33536 " const char *partition);\n"
33541 #: ../src/guestfs-actions.pod:6187
33542 msgid "See also C<guestfs_part_to_dev>."
33546 #: ../src/guestfs-actions.pod:6193
33547 msgid "guestfs_ping_daemon"
33551 #: ../src/guestfs-actions.pod:6195
33555 " guestfs_ping_daemon (guestfs_h *g);\n"
33560 #: ../src/guestfs-actions.pod:6207
33561 msgid "guestfs_pread"
33565 #: ../src/guestfs-actions.pod:6209
33569 " guestfs_pread (guestfs_h *g,\n"
33570 " const char *path,\n"
33572 " int64_t offset,\n"
33573 " size_t *size_r);\n"
33578 #: ../src/guestfs-actions.pod:6222
33579 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>."
33583 #: ../src/guestfs-actions.pod:6233
33584 msgid "guestfs_pread_device"
33588 #: ../src/guestfs-actions.pod:6235
33592 " guestfs_pread_device (guestfs_h *g,\n"
33593 " const char *device,\n"
33595 " int64_t offset,\n"
33596 " size_t *size_r);\n"
33601 #: ../src/guestfs-actions.pod:6248
33602 msgid "See also C<guestfs_pread>."
33606 #: ../src/guestfs-actions.pod:6257
33607 msgid "(Added in 1.5.21)"
33608 msgstr "(Додано у 1.5.21)"
33611 #: ../src/guestfs-actions.pod:6259
33612 msgid "guestfs_pvcreate"
33616 #: ../src/guestfs-actions.pod:6261
33620 " guestfs_pvcreate (guestfs_h *g,\n"
33621 " const char *device);\n"
33626 #: ../src/guestfs-actions.pod:6273
33627 msgid "guestfs_pvremove"
33631 #: ../src/guestfs-actions.pod:6275
33635 " guestfs_pvremove (guestfs_h *g,\n"
33636 " const char *device);\n"
33641 #: ../src/guestfs-actions.pod:6290
33642 msgid "guestfs_pvresize"
33646 #: ../src/guestfs-actions.pod:6292
33650 " guestfs_pvresize (guestfs_h *g,\n"
33651 " const char *device);\n"
33656 #: ../src/guestfs-actions.pod:6303
33657 msgid "guestfs_pvresize_size"
33661 #: ../src/guestfs-actions.pod:6305
33665 " guestfs_pvresize_size (guestfs_h *g,\n"
33666 " const char *device,\n"
33667 " int64_t size);\n"
33672 #: ../src/guestfs-actions.pod:6310
33674 "This command is the same as C<guestfs_pvresize> except that it allows you to "
33675 "specify the new size (in bytes) explicitly."
33679 #: ../src/guestfs-actions.pod:6317
33680 msgid "guestfs_pvs"
33684 #: ../src/guestfs-actions.pod:6319
33688 " guestfs_pvs (guestfs_h *g);\n"
33693 #: ../src/guestfs-actions.pod:6328
33694 msgid "See also C<guestfs_pvs_full>."
33698 #: ../src/guestfs-actions.pod:6336
33699 msgid "guestfs_pvs_full"
33703 #: ../src/guestfs-actions.pod:6338
33706 " struct guestfs_lvm_pv_list *\n"
33707 " guestfs_pvs_full (guestfs_h *g);\n"
33712 #: ../src/guestfs-actions.pod:6344
33714 "This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there "
33715 "was an error. I<The caller must call C<guestfs_free_lvm_pv_list> after use>."
33719 #: ../src/guestfs-actions.pod:6350
33720 msgid "guestfs_pvuuid"
33724 #: ../src/guestfs-actions.pod:6352
33728 " guestfs_pvuuid (guestfs_h *g,\n"
33729 " const char *device);\n"
33734 #: ../src/guestfs-actions.pod:6363
33735 msgid "guestfs_pwrite"
33739 #: ../src/guestfs-actions.pod:6365
33743 " guestfs_pwrite (guestfs_h *g,\n"
33744 " const char *path,\n"
33745 " const char *content,\n"
33746 " size_t content_size,\n"
33747 " int64_t offset);\n"
33752 #: ../src/guestfs-actions.pod:6381
33753 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>."
33757 #: ../src/guestfs-actions.pod:6390
33758 msgid "guestfs_pwrite_device"
33762 #: ../src/guestfs-actions.pod:6392
33766 " guestfs_pwrite_device (guestfs_h *g,\n"
33767 " const char *device,\n"
33768 " const char *content,\n"
33769 " size_t content_size,\n"
33770 " int64_t offset);\n"
33775 #: ../src/guestfs-actions.pod:6407
33776 msgid "See also C<guestfs_pwrite>."
33780 #: ../src/guestfs-actions.pod:6414
33781 msgid "(Added in 1.5.20)"
33782 msgstr "(Додано у 1.5.20)"
33785 #: ../src/guestfs-actions.pod:6416
33786 msgid "guestfs_read_file"
33790 #: ../src/guestfs-actions.pod:6418
33794 " guestfs_read_file (guestfs_h *g,\n"
33795 " const char *path,\n"
33796 " size_t *size_r);\n"
33801 #: ../src/guestfs-actions.pod:6426
33803 "Unlike C<guestfs_cat>, this function can correctly handle files that contain "
33804 "embedded ASCII NUL characters. However unlike C<guestfs_download>, this "
33805 "function is limited in the total size of file that can be handled."
33809 #: ../src/guestfs-actions.pod:6438
33810 msgid "(Added in 1.0.63)"
33811 msgstr "(Додано у 1.0.63)"
33814 #: ../src/guestfs-actions.pod:6440
33815 msgid "guestfs_read_lines"
33819 #: ../src/guestfs-actions.pod:6442
33823 " guestfs_read_lines (guestfs_h *g,\n"
33824 " const char *path);\n"
33829 #: ../src/guestfs-actions.pod:6451
33831 "Note that this function cannot correctly handle binary files (specifically, "
33832 "files containing C<\\0> character which is treated as end of line). For "
33833 "those you need to use the C<guestfs_read_file> function which has a more "
33834 "complex interface."
33838 #: ../src/guestfs-actions.pod:6462
33839 msgid "guestfs_readdir"
33843 #: ../src/guestfs-actions.pod:6464
33846 " struct guestfs_dirent_list *\n"
33847 " guestfs_readdir (guestfs_h *g,\n"
33848 " const char *dir);\n"
33853 #: ../src/guestfs-actions.pod:6518
33855 "This function is primarily intended for use by programs. To get a simple "
33856 "list of names, use C<guestfs_ls>. To get a printable directory for human "
33857 "consumption, use C<guestfs_ll>."
33861 #: ../src/guestfs-actions.pod:6522
33863 "This function returns a C<struct guestfs_dirent_list *>, or NULL if there "
33864 "was an error. I<The caller must call C<guestfs_free_dirent_list> after use>."
33868 #: ../src/guestfs-actions.pod:6528
33869 msgid "guestfs_readlink"
33873 #: ../src/guestfs-actions.pod:6530
33877 " guestfs_readlink (guestfs_h *g,\n"
33878 " const char *path);\n"
33883 #: ../src/guestfs-actions.pod:6541
33884 msgid "guestfs_readlinklist"
33888 #: ../src/guestfs-actions.pod:6543
33892 " guestfs_readlinklist (guestfs_h *g,\n"
33893 " const char *path,\n"
33894 " char *const *names);\n"
33899 #: ../src/guestfs-actions.pod:6576
33900 msgid "guestfs_realpath"
33904 #: ../src/guestfs-actions.pod:6578
33908 " guestfs_realpath (guestfs_h *g,\n"
33909 " const char *path);\n"
33914 #: ../src/guestfs-actions.pod:6590
33915 msgid "guestfs_removexattr"
33919 #: ../src/guestfs-actions.pod:6592
33923 " guestfs_removexattr (guestfs_h *g,\n"
33924 " const char *xattr,\n"
33925 " const char *path);\n"
33930 #: ../src/guestfs-actions.pod:6600
33931 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>."
33935 #: ../src/guestfs-actions.pod:6606
33936 msgid "guestfs_resize2fs"
33940 #: ../src/guestfs-actions.pod:6608
33944 " guestfs_resize2fs (guestfs_h *g,\n"
33945 " const char *device);\n"
33950 #: ../src/guestfs-actions.pod:6615
33952 "I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the "
33953 "C<device> before calling this command. For unknown reasons C<resize2fs> "
33954 "sometimes gives an error about this and sometimes not. In any case, it is "
33955 "always safe to call C<guestfs_e2fsck_f> before calling this function."
33959 #: ../src/guestfs-actions.pod:6625
33960 msgid "guestfs_resize2fs_M"
33964 #: ../src/guestfs-actions.pod:6627
33968 " guestfs_resize2fs_M (guestfs_h *g,\n"
33969 " const char *device);\n"
33974 #: ../src/guestfs-actions.pod:6631
33976 "This command is the same as C<guestfs_resize2fs>, but the filesystem is "
33977 "resized to its minimum size. This works like the I<-M> option to the "
33978 "C<resize2fs> command."
33982 #: ../src/guestfs-actions.pod:6635
33984 "To get the resulting size of the filesystem you should call "
33985 "C<guestfs_tune2fs_l> and read the C<Block size> and C<Block count> values. "
33986 "These two numbers, multiplied together, give the resulting size of the "
33987 "minimal filesystem in bytes."
33991 #: ../src/guestfs-actions.pod:6644
33992 msgid "guestfs_resize2fs_size"
33996 #: ../src/guestfs-actions.pod:6646
34000 " guestfs_resize2fs_size (guestfs_h *g,\n"
34001 " const char *device,\n"
34002 " int64_t size);\n"
34007 #: ../src/guestfs-actions.pod:6651
34009 "This command is the same as C<guestfs_resize2fs> except that it allows you "
34010 "to specify the new size (in bytes) explicitly."
34014 #: ../src/guestfs-actions.pod:6658
34019 #: ../src/guestfs-actions.pod:6660
34023 " guestfs_rm (guestfs_h *g,\n"
34024 " const char *path);\n"
34029 #: ../src/guestfs-actions.pod:6670
34030 msgid "guestfs_rm_rf"
34034 #: ../src/guestfs-actions.pod:6672
34038 " guestfs_rm_rf (guestfs_h *g,\n"
34039 " const char *path);\n"
34044 #: ../src/guestfs-actions.pod:6684
34045 msgid "guestfs_rmdir"
34049 #: ../src/guestfs-actions.pod:6686
34053 " guestfs_rmdir (guestfs_h *g,\n"
34054 " const char *path);\n"
34059 #: ../src/guestfs-actions.pod:6696
34060 msgid "guestfs_rmmountpoint"
34064 #: ../src/guestfs-actions.pod:6698
34068 " guestfs_rmmountpoint (guestfs_h *g,\n"
34069 " const char *exemptpath);\n"
34074 #: ../src/guestfs-actions.pod:6702
34076 "This calls removes a mountpoint that was previously created with "
34077 "C<guestfs_mkmountpoint>. See C<guestfs_mkmountpoint> for full details."
34081 #: ../src/guestfs-actions.pod:6710
34082 msgid "guestfs_scrub_device"
34086 #: ../src/guestfs-actions.pod:6712
34090 " guestfs_scrub_device (guestfs_h *g,\n"
34091 " const char *device);\n"
34096 #: ../src/guestfs-actions.pod:6724 ../src/guestfs-actions.pod:6742
34097 #: ../src/guestfs-actions.pod:6761
34098 msgid "(Added in 1.0.52)"
34099 msgstr "(Додано у 1.0.52)"
34102 #: ../src/guestfs-actions.pod:6726
34103 msgid "guestfs_scrub_file"
34107 #: ../src/guestfs-actions.pod:6728
34111 " guestfs_scrub_file (guestfs_h *g,\n"
34112 " const char *file);\n"
34117 #: ../src/guestfs-actions.pod:6744
34118 msgid "guestfs_scrub_freespace"
34122 #: ../src/guestfs-actions.pod:6746
34126 " guestfs_scrub_freespace (guestfs_h *g,\n"
34127 " const char *dir);\n"
34132 #: ../src/guestfs-actions.pod:6750
34134 "This command creates the directory C<dir> and then fills it with files until "
34135 "the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, "
34136 "and deletes them. The intention is to scrub any free space on the partition "
34137 "containing C<dir>."
34141 #: ../src/guestfs-actions.pod:6763
34142 msgid "guestfs_set_append"
34146 #: ../src/guestfs-actions.pod:6765
34150 " guestfs_set_append (guestfs_h *g,\n"
34151 " const char *append);\n"
34156 #: ../src/guestfs-actions.pod:6782
34157 msgid "guestfs_set_attach_method"
34161 #: ../src/guestfs-actions.pod:6784
34165 " guestfs_set_attach_method (guestfs_h *g,\n"
34166 " const char *attachmethod);\n"
34171 #: ../src/guestfs-actions.pod:6812
34172 msgid "guestfs_set_autosync"
34176 #: ../src/guestfs-actions.pod:6814
34180 " guestfs_set_autosync (guestfs_h *g,\n"
34181 " int autosync);\n"
34186 #: ../src/guestfs-actions.pod:6830
34187 msgid "guestfs_set_direct"
34191 #: ../src/guestfs-actions.pod:6832
34195 " guestfs_set_direct (guestfs_h *g,\n"
34201 #: ../src/guestfs-actions.pod:6840
34203 "One consequence of this is that log messages aren't caught by the library "
34204 "and handled by C<guestfs_set_log_message_callback>, but go straight to "
34209 #: ../src/guestfs-actions.pod:6853
34210 msgid "guestfs_set_e2label"
34214 #: ../src/guestfs-actions.pod:6855
34218 " guestfs_set_e2label (guestfs_h *g,\n"
34219 " const char *device,\n"
34220 " const char *label);\n"
34225 #: ../src/guestfs-actions.pod:6864
34227 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return "
34228 "the existing label on a filesystem."
34232 #: ../src/guestfs-actions.pod:6871
34233 msgid "guestfs_set_e2uuid"
34237 #: ../src/guestfs-actions.pod:6873
34241 " guestfs_set_e2uuid (guestfs_h *g,\n"
34242 " const char *device,\n"
34243 " const char *uuid);\n"
34248 #: ../src/guestfs-actions.pod:6883
34250 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return "
34251 "the existing UUID of a filesystem."
34255 #: ../src/guestfs-actions.pod:6890
34256 msgid "guestfs_set_memsize"
34260 #: ../src/guestfs-actions.pod:6892
34264 " guestfs_set_memsize (guestfs_h *g,\n"
34270 #: ../src/guestfs-actions.pod:6896
34272 "This sets the memory size in megabytes allocated to the qemu subprocess. "
34273 "This only has any effect if called before C<guestfs_launch>."
34277 #: ../src/guestfs-actions.pod:6911
34278 msgid "guestfs_set_network"
34282 #: ../src/guestfs-actions.pod:6913
34286 " guestfs_set_network (guestfs_h *g,\n"
34292 #: ../src/guestfs-actions.pod:6923
34294 "You must call this before calling C<guestfs_launch>, otherwise it has no "
34299 #: ../src/guestfs-actions.pod:6930
34300 msgid "guestfs_set_path"
34304 #: ../src/guestfs-actions.pod:6932
34308 " guestfs_set_path (guestfs_h *g,\n"
34309 " const char *searchpath);\n"
34314 #: ../src/guestfs-actions.pod:6947
34315 msgid "guestfs_set_pgroup"
34319 #: ../src/guestfs-actions.pod:6949
34323 " guestfs_set_pgroup (guestfs_h *g,\n"
34329 #: ../src/guestfs-actions.pod:6966
34330 msgid "guestfs_set_qemu"
34334 #: ../src/guestfs-actions.pod:6968
34338 " guestfs_set_qemu (guestfs_h *g,\n"
34339 " const char *qemu);\n"
34344 #: ../src/guestfs-actions.pod:6994
34345 msgid "guestfs_set_recovery_proc"
34349 #: ../src/guestfs-actions.pod:6996
34353 " guestfs_set_recovery_proc (guestfs_h *g,\n"
34354 " int recoveryproc);\n"
34359 #: ../src/guestfs-actions.pod:7000
34361 "If this is called with the parameter C<false> then C<guestfs_launch> does "
34362 "not create a recovery process. The purpose of the recovery process is to "
34363 "stop runaway qemu processes in the case where the main program aborts "
34368 #: ../src/guestfs-actions.pod:7005
34370 "This only has any effect if called before C<guestfs_launch>, and the default "
34375 #: ../src/guestfs-actions.pod:7018
34376 msgid "guestfs_set_selinux"
34380 #: ../src/guestfs-actions.pod:7020
34384 " guestfs_set_selinux (guestfs_h *g,\n"
34390 #: ../src/guestfs-actions.pod:7037
34391 msgid "guestfs_set_smp"
34395 #: ../src/guestfs-actions.pod:7039
34399 " guestfs_set_smp (guestfs_h *g,\n"
34405 #: ../src/guestfs-actions.pod:7047
34406 msgid "This function must be called before C<guestfs_launch>."
34410 #: ../src/guestfs-actions.pod:7053
34411 msgid "guestfs_set_trace"
34415 #: ../src/guestfs-actions.pod:7055
34419 " guestfs_set_trace (guestfs_h *g,\n"
34425 #: ../src/guestfs-actions.pod:7069
34427 "Trace messages are normally sent to C<stderr>, unless you register a "
34428 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
34432 #: ../src/guestfs-actions.pod:7077
34433 msgid "guestfs_set_verbose"
34437 #: ../src/guestfs-actions.pod:7079
34441 " guestfs_set_verbose (guestfs_h *g,\n"
34447 #: ../src/guestfs-actions.pod:7088
34449 "Verbose messages are normally sent to C<stderr>, unless you register a "
34450 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
34454 #: ../src/guestfs-actions.pod:7096
34455 msgid "guestfs_setcon"
34459 #: ../src/guestfs-actions.pod:7098
34463 " guestfs_setcon (guestfs_h *g,\n"
34464 " const char *context);\n"
34469 #: ../src/guestfs-actions.pod:7111
34470 msgid "guestfs_setxattr"
34474 #: ../src/guestfs-actions.pod:7113
34478 " guestfs_setxattr (guestfs_h *g,\n"
34479 " const char *xattr,\n"
34480 " const char *val,\n"
34482 " const char *path);\n"
34487 #: ../src/guestfs-actions.pod:7124
34488 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>."
34492 #: ../src/guestfs-actions.pod:7130
34493 msgid "guestfs_sfdisk"
34497 #: ../src/guestfs-actions.pod:7132
34501 " guestfs_sfdisk (guestfs_h *g,\n"
34502 " const char *device,\n"
34506 " char *const *lines);\n"
34511 #: ../src/guestfs-actions.pod:7140 ../src/guestfs-actions.pod:7181
34512 #: ../src/guestfs-actions.pod:7212
34514 "I<This function is deprecated.> In new code, use the L</guestfs_part_add> "
34519 #: ../src/guestfs-actions.pod:7167
34521 "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>"
34525 #: ../src/guestfs-actions.pod:7174
34526 msgid "guestfs_sfdiskM"
34530 #: ../src/guestfs-actions.pod:7176
34534 " guestfs_sfdiskM (guestfs_h *g,\n"
34535 " const char *device,\n"
34536 " char *const *lines);\n"
34541 #: ../src/guestfs-actions.pod:7188
34543 "This is a simplified interface to the C<guestfs_sfdisk> command, where "
34544 "partition sizes are specified in megabytes only (rounded to the nearest "
34545 "cylinder) and you don't need to specify the cyls, heads and sectors "
34546 "parameters which were rarely if ever used anyway."
34550 #: ../src/guestfs-actions.pod:7194
34552 "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and "
34553 "C<guestfs_part_disk>"
34557 #: ../src/guestfs-actions.pod:7201
34558 msgid "guestfs_sfdisk_N"
34562 #: ../src/guestfs-actions.pod:7203
34566 " guestfs_sfdisk_N (guestfs_h *g,\n"
34567 " const char *device,\n"
34572 " const char *line);\n"
34577 #: ../src/guestfs-actions.pod:7222
34579 "For other parameters, see C<guestfs_sfdisk>. You should usually pass C<0> "
34580 "for the cyls/heads/sectors parameters."
34584 #: ../src/guestfs-actions.pod:7225
34585 msgid "See also: C<guestfs_part_add>"
34589 #: ../src/guestfs-actions.pod:7231
34590 msgid "guestfs_sfdisk_disk_geometry"
34594 #: ../src/guestfs-actions.pod:7233
34598 " guestfs_sfdisk_disk_geometry (guestfs_h *g,\n"
34599 " const char *device);\n"
34604 #: ../src/guestfs-actions.pod:7237
34606 "This displays the disk geometry of C<device> read from the partition table. "
34607 "Especially in the case where the underlying block device has been resized, "
34608 "this can be different from the kernel's idea of the geometry (see "
34609 "C<guestfs_sfdisk_kernel_geometry>)."
34613 #: ../src/guestfs-actions.pod:7250
34614 msgid "guestfs_sfdisk_kernel_geometry"
34618 #: ../src/guestfs-actions.pod:7252
34622 " guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n"
34623 " const char *device);\n"
34628 #: ../src/guestfs-actions.pod:7266
34629 msgid "guestfs_sfdisk_l"
34633 #: ../src/guestfs-actions.pod:7268
34637 " guestfs_sfdisk_l (guestfs_h *g,\n"
34638 " const char *device);\n"
34643 #: ../src/guestfs-actions.pod:7272
34645 "I<This function is deprecated.> In new code, use the L</guestfs_part_list> "
34650 #: ../src/guestfs-actions.pod:7283
34651 msgid "See also: C<guestfs_part_list>"
34655 #: ../src/guestfs-actions.pod:7290
34660 #: ../src/guestfs-actions.pod:7292
34664 " guestfs_sh (guestfs_h *g,\n"
34665 " const char *command);\n"
34670 #: ../src/guestfs-actions.pod:7299
34671 msgid "This is like C<guestfs_command>, but passes the command to:"
34675 #: ../src/guestfs-actions.pod:7307
34676 msgid "All the provisos about C<guestfs_command> apply to this call."
34680 #: ../src/guestfs-actions.pod:7314
34681 msgid "guestfs_sh_lines"
34685 #: ../src/guestfs-actions.pod:7316
34689 " guestfs_sh_lines (guestfs_h *g,\n"
34690 " const char *command);\n"
34695 #: ../src/guestfs-actions.pod:7320
34697 "This is the same as C<guestfs_sh>, but splits the result into a list of "
34702 #: ../src/guestfs-actions.pod:7323
34703 msgid "See also: C<guestfs_command_lines>"
34707 #: ../src/guestfs-actions.pod:7331
34708 msgid "guestfs_sleep"
34712 #: ../src/guestfs-actions.pod:7333
34716 " guestfs_sleep (guestfs_h *g,\n"
34722 #: ../src/guestfs-actions.pod:7341
34723 msgid "(Added in 1.0.41)"
34724 msgstr "(Додано у 1.0.41)"
34727 #: ../src/guestfs-actions.pod:7343 ../src/guestfs-structs.pod:109
34728 msgid "guestfs_stat"
34732 #: ../src/guestfs-actions.pod:7345
34735 " struct guestfs_stat *\n"
34736 " guestfs_stat (guestfs_h *g,\n"
34737 " const char *path);\n"
34742 #: ../src/guestfs-actions.pod:7359 ../src/guestfs-structs.pod:135
34743 msgid "guestfs_statvfs"
34747 #: ../src/guestfs-actions.pod:7361
34750 " struct guestfs_statvfs *\n"
34751 " guestfs_statvfs (guestfs_h *g,\n"
34752 " const char *path);\n"
34757 #: ../src/guestfs-actions.pod:7371
34759 "This function returns a C<struct guestfs_statvfs *>, or NULL if there was an "
34760 "error. I<The caller must call C<guestfs_free_statvfs> after use>."
34764 #: ../src/guestfs-actions.pod:7377
34765 msgid "guestfs_strings"
34769 #: ../src/guestfs-actions.pod:7379
34773 " guestfs_strings (guestfs_h *g,\n"
34774 " const char *path);\n"
34779 #: ../src/guestfs-actions.pod:7395
34780 msgid "guestfs_strings_e"
34784 #: ../src/guestfs-actions.pod:7397
34788 " guestfs_strings_e (guestfs_h *g,\n"
34789 " const char *encoding,\n"
34790 " const char *path);\n"
34795 #: ../src/guestfs-actions.pod:7402
34797 "This is like the C<guestfs_strings> command, but allows you to specify the "
34798 "encoding of strings that are looked for in the source file C<path>."
34802 #: ../src/guestfs-actions.pod:7412
34804 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
34805 "ISO-8859-X (this is what C<guestfs_strings> uses)."
34809 #: ../src/guestfs-actions.pod:7450
34810 msgid "guestfs_swapoff_device"
34814 #: ../src/guestfs-actions.pod:7452
34818 " guestfs_swapoff_device (guestfs_h *g,\n"
34819 " const char *device);\n"
34824 #: ../src/guestfs-actions.pod:7456
34826 "This command disables the libguestfs appliance swap device or partition "
34827 "named C<device>. See C<guestfs_swapon_device>."
34831 #: ../src/guestfs-actions.pod:7464
34832 msgid "guestfs_swapoff_file"
34836 #: ../src/guestfs-actions.pod:7466
34840 " guestfs_swapoff_file (guestfs_h *g,\n"
34841 " const char *file);\n"
34846 #: ../src/guestfs-actions.pod:7476
34847 msgid "guestfs_swapoff_label"
34851 #: ../src/guestfs-actions.pod:7478
34855 " guestfs_swapoff_label (guestfs_h *g,\n"
34856 " const char *label);\n"
34861 #: ../src/guestfs-actions.pod:7489
34862 msgid "guestfs_swapoff_uuid"
34866 #: ../src/guestfs-actions.pod:7491
34870 " guestfs_swapoff_uuid (guestfs_h *g,\n"
34871 " const char *uuid);\n"
34876 #: ../src/guestfs-actions.pod:7502
34877 msgid "guestfs_swapon_device"
34881 #: ../src/guestfs-actions.pod:7504
34885 " guestfs_swapon_device (guestfs_h *g,\n"
34886 " const char *device);\n"
34891 #: ../src/guestfs-actions.pod:7508
34893 "This command enables the libguestfs appliance to use the swap device or "
34894 "partition named C<device>. The increased memory is made available for all "
34895 "commands, for example those run using C<guestfs_command> or C<guestfs_sh>."
34899 #: ../src/guestfs-actions.pod:7524
34900 msgid "guestfs_swapon_file"
34904 #: ../src/guestfs-actions.pod:7526
34908 " guestfs_swapon_file (guestfs_h *g,\n"
34909 " const char *file);\n"
34914 #: ../src/guestfs-actions.pod:7530
34916 "This command enables swap to a file. See C<guestfs_swapon_device> for other "
34921 #: ../src/guestfs-actions.pod:7537
34922 msgid "guestfs_swapon_label"
34926 #: ../src/guestfs-actions.pod:7539
34930 " guestfs_swapon_label (guestfs_h *g,\n"
34931 " const char *label);\n"
34936 #: ../src/guestfs-actions.pod:7543
34938 "This command enables swap to a labeled swap partition. See "
34939 "C<guestfs_swapon_device> for other notes."
34943 #: ../src/guestfs-actions.pod:7550
34944 msgid "guestfs_swapon_uuid"
34948 #: ../src/guestfs-actions.pod:7552
34952 " guestfs_swapon_uuid (guestfs_h *g,\n"
34953 " const char *uuid);\n"
34958 #: ../src/guestfs-actions.pod:7556
34960 "This command enables swap to a swap partition with the given UUID. See "
34961 "C<guestfs_swapon_device> for other notes."
34965 #: ../src/guestfs-actions.pod:7563
34966 msgid "guestfs_sync"
34970 #: ../src/guestfs-actions.pod:7565
34974 " guestfs_sync (guestfs_h *g);\n"
34979 #: ../src/guestfs-actions.pod:7578
34980 msgid "guestfs_tail"
34984 #: ../src/guestfs-actions.pod:7580
34988 " guestfs_tail (guestfs_h *g,\n"
34989 " const char *path);\n"
34994 #: ../src/guestfs-actions.pod:7596
34995 msgid "guestfs_tail_n"
34999 #: ../src/guestfs-actions.pod:7598
35003 " guestfs_tail_n (guestfs_h *g,\n"
35005 " const char *path);\n"
35010 #: ../src/guestfs-actions.pod:7620
35011 msgid "guestfs_tar_in"
35015 #: ../src/guestfs-actions.pod:7622
35019 " guestfs_tar_in (guestfs_h *g,\n"
35020 " const char *tarfile,\n"
35021 " const char *directory);\n"
35026 #: ../src/guestfs-actions.pod:7630
35028 "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>."
35032 #: ../src/guestfs-actions.pod:7635 ../src/guestfs-actions.pod:7652
35033 #: ../src/guestfs-actions.pod:7668 ../src/guestfs-actions.pod:7684
35034 msgid "(Added in 1.0.3)"
35035 msgstr "(Додано у 1.0.3)"
35038 #: ../src/guestfs-actions.pod:7637
35039 msgid "guestfs_tar_out"
35043 #: ../src/guestfs-actions.pod:7639
35047 " guestfs_tar_out (guestfs_h *g,\n"
35048 " const char *directory,\n"
35049 " const char *tarfile);\n"
35054 #: ../src/guestfs-actions.pod:7647
35056 "To download a compressed tarball, use C<guestfs_tgz_out> or "
35057 "C<guestfs_txz_out>."
35061 #: ../src/guestfs-actions.pod:7654
35062 msgid "guestfs_tgz_in"
35066 #: ../src/guestfs-actions.pod:7656
35070 " guestfs_tgz_in (guestfs_h *g,\n"
35071 " const char *tarball,\n"
35072 " const char *directory);\n"
35077 #: ../src/guestfs-actions.pod:7664
35078 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>."
35082 #: ../src/guestfs-actions.pod:7670
35083 msgid "guestfs_tgz_out"
35087 #: ../src/guestfs-actions.pod:7672
35091 " guestfs_tgz_out (guestfs_h *g,\n"
35092 " const char *directory,\n"
35093 " const char *tarball);\n"
35098 #: ../src/guestfs-actions.pod:7680
35099 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>."
35103 #: ../src/guestfs-actions.pod:7686
35104 msgid "guestfs_touch"
35108 #: ../src/guestfs-actions.pod:7688
35112 " guestfs_touch (guestfs_h *g,\n"
35113 " const char *path);\n"
35118 #: ../src/guestfs-actions.pod:7703
35119 msgid "guestfs_truncate"
35123 #: ../src/guestfs-actions.pod:7705
35127 " guestfs_truncate (guestfs_h *g,\n"
35128 " const char *path);\n"
35133 #: ../src/guestfs-actions.pod:7716
35134 msgid "guestfs_truncate_size"
35138 #: ../src/guestfs-actions.pod:7718
35142 " guestfs_truncate_size (guestfs_h *g,\n"
35143 " const char *path,\n"
35144 " int64_t size);\n"
35149 #: ../src/guestfs-actions.pod:7726
35151 "If the current file size is less than C<size> then the file is extended to "
35152 "the required size with zero bytes. This creates a sparse file (ie. disk "
35153 "blocks are not allocated for the file until you write to it). To create a "
35154 "non-sparse file of zeroes, use C<guestfs_fallocate64> instead."
35158 #: ../src/guestfs-actions.pod:7736
35160 #| msgid "guestfs_mke2fs_J"
35161 msgid "guestfs_tune2fs"
35162 msgstr "guestfs_mke2fs_J"
35165 #: ../src/guestfs-actions.pod:7738
35169 #| " guestfs_lvresize (guestfs_h *g,\n"
35170 #| " const char *device,\n"
35171 #| " int mbytes);\n"
35175 " guestfs_tune2fs (guestfs_h *g,\n"
35176 " const char *device,\n"
35181 " guestfs_lvresize (guestfs_h *g,\n"
35182 " const char *device,\n"
35187 #: ../src/guestfs-actions.pod:7748
35190 " GUESTFS_TUNE2FS_FORCE, int force,\n"
35191 " GUESTFS_TUNE2FS_MAXMOUNTCOUNT, int maxmountcount,\n"
35192 " GUESTFS_TUNE2FS_MOUNTCOUNT, int mountcount,\n"
35193 " GUESTFS_TUNE2FS_ERRORBEHAVIOR, const char *errorbehavior,\n"
35194 " GUESTFS_TUNE2FS_GROUP, int64_t group,\n"
35195 " GUESTFS_TUNE2FS_INTERVALBETWEENCHECKS, int intervalbetweenchecks,\n"
35196 " GUESTFS_TUNE2FS_RESERVEDBLOCKSPERCENTAGE, int reservedblockspercentage,\n"
35197 " GUESTFS_TUNE2FS_LASTMOUNTEDDIRECTORY, const char *lastmounteddirectory,\n"
35198 " GUESTFS_TUNE2FS_RESERVEDBLOCKSCOUNT, int64_t reservedblockscount,\n"
35199 " GUESTFS_TUNE2FS_USER, int64_t user,\n"
35204 #: ../src/guestfs-actions.pod:7828
35206 "To get the current values of filesystem parameters, see "
35207 "C<guestfs_tune2fs_l>. For precise details of how tune2fs works, see the "
35208 "L<tune2fs(8)> man page."
35212 #: ../src/guestfs-actions.pod:7834
35214 #| msgid "guestfs_mke2fs_J"
35215 msgid "guestfs_tune2fs_va"
35216 msgstr "guestfs_mke2fs_J"
35219 #: ../src/guestfs-actions.pod:7836
35223 #| " guestfs_lvresize (guestfs_h *g,\n"
35224 #| " const char *device,\n"
35225 #| " int mbytes);\n"
35229 " guestfs_tune2fs_va (guestfs_h *g,\n"
35230 " const char *device,\n"
35231 " va_list args);\n"
35235 " guestfs_lvresize (guestfs_h *g,\n"
35236 " const char *device,\n"
35241 #: ../src/guestfs-actions.pod:7841
35242 msgid "This is the \"va_list variant\" of L</guestfs_tune2fs>."
35246 #: ../src/guestfs-actions.pod:7845
35248 #| msgid "guestfs_mke2fs_J"
35249 msgid "guestfs_tune2fs_argv"
35250 msgstr "guestfs_mke2fs_J"
35253 #: ../src/guestfs-actions.pod:7847
35257 #| " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
35258 #| " const char *fstype,\n"
35259 #| " const char *device,\n"
35260 #| " const struct guestfs_mkfs_opts_argv *optargs);\n"
35264 " guestfs_tune2fs_argv (guestfs_h *g,\n"
35265 " const char *device,\n"
35266 " const struct guestfs_tune2fs_argv *optargs);\n"
35270 " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
35271 " const char *fstype,\n"
35272 " const char *device,\n"
35273 " const struct guestfs_mkfs_opts_argv *optargs);\n"
35277 #: ../src/guestfs-actions.pod:7852
35278 msgid "This is the \"argv variant\" of L</guestfs_tune2fs>."
35282 #: ../src/guestfs-actions.pod:7856
35283 msgid "guestfs_tune2fs_l"
35287 #: ../src/guestfs-actions.pod:7858
35291 " guestfs_tune2fs_l (guestfs_h *g,\n"
35292 " const char *device);\n"
35297 #: ../src/guestfs-actions.pod:7878
35298 msgid "guestfs_txz_in"
35302 #: ../src/guestfs-actions.pod:7880
35306 " guestfs_txz_in (guestfs_h *g,\n"
35307 " const char *tarball,\n"
35308 " const char *directory);\n"
35313 #: ../src/guestfs-actions.pod:7892
35314 msgid "guestfs_txz_out"
35318 #: ../src/guestfs-actions.pod:7894
35322 " guestfs_txz_out (guestfs_h *g,\n"
35323 " const char *directory,\n"
35324 " const char *tarball);\n"
35329 #: ../src/guestfs-actions.pod:7906
35330 msgid "guestfs_umask"
35334 #: ../src/guestfs-actions.pod:7908
35338 " guestfs_umask (guestfs_h *g,\n"
35344 #: ../src/guestfs-actions.pod:7924
35346 "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, "
35347 "C<guestfs_mkdir>."
35351 #: ../src/guestfs-actions.pod:7933
35352 msgid "guestfs_umount"
35356 #: ../src/guestfs-actions.pod:7935
35360 " guestfs_umount (guestfs_h *g,\n"
35361 " const char *pathordevice);\n"
35366 #: ../src/guestfs-actions.pod:7947
35367 msgid "guestfs_umount_all"
35371 #: ../src/guestfs-actions.pod:7949
35375 " guestfs_umount_all (guestfs_h *g);\n"
35380 #: ../src/guestfs-actions.pod:7960
35381 msgid "guestfs_upload"
35385 #: ../src/guestfs-actions.pod:7962
35389 " guestfs_upload (guestfs_h *g,\n"
35390 " const char *filename,\n"
35391 " const char *remotefilename);\n"
35396 #: ../src/guestfs-actions.pod:7972
35397 msgid "See also C<guestfs_download>."
35401 #: ../src/guestfs-actions.pod:7983
35402 msgid "guestfs_upload_offset"
35406 #: ../src/guestfs-actions.pod:7985
35410 " guestfs_upload_offset (guestfs_h *g,\n"
35411 " const char *filename,\n"
35412 " const char *remotefilename,\n"
35413 " int64_t offset);\n"
35418 #: ../src/guestfs-actions.pod:8001
35420 "Note that there is no limit on the amount of data that can be uploaded with "
35421 "this call, unlike with C<guestfs_pwrite>, and this call always writes the "
35422 "full amount unless an error occurs."
35426 #: ../src/guestfs-actions.pod:8006
35427 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>."
35431 #: ../src/guestfs-actions.pod:8017
35432 msgid "guestfs_utimens"
35436 #: ../src/guestfs-actions.pod:8019
35440 " guestfs_utimens (guestfs_h *g,\n"
35441 " const char *path,\n"
35442 " int64_t atsecs,\n"
35443 " int64_t atnsecs,\n"
35444 " int64_t mtsecs,\n"
35445 " int64_t mtnsecs);\n"
35450 #: ../src/guestfs-actions.pod:8048 ../src/guestfs-structs.pod:175
35451 msgid "guestfs_version"
35455 #: ../src/guestfs-actions.pod:8050
35458 " struct guestfs_version *\n"
35459 " guestfs_version (guestfs_h *g);\n"
35464 #: ../src/guestfs-actions.pod:8078
35466 "I<Note:> Don't use this call to test for availability of features. In "
35467 "enterprise distributions we backport features from later versions into "
35468 "earlier versions, making this an unreliable way to test for features. Use "
35469 "C<guestfs_available> instead."
35473 #: ../src/guestfs-actions.pod:8084
35475 "This function returns a C<struct guestfs_version *>, or NULL if there was an "
35476 "error. I<The caller must call C<guestfs_free_version> after use>."
35480 #: ../src/guestfs-actions.pod:8088
35481 msgid "(Added in 1.0.58)"
35482 msgstr "(Додано у 1.0.58)"
35485 #: ../src/guestfs-actions.pod:8090
35486 msgid "guestfs_vfs_label"
35490 #: ../src/guestfs-actions.pod:8092
35494 " guestfs_vfs_label (guestfs_h *g,\n"
35495 " const char *device);\n"
35500 #: ../src/guestfs-actions.pod:8101
35501 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>."
35505 #: ../src/guestfs-actions.pod:8106 ../src/guestfs-actions.pod:8143
35506 msgid "(Added in 1.3.18)"
35507 msgstr "(Додано у 1.3.18)"
35510 #: ../src/guestfs-actions.pod:8108
35511 msgid "guestfs_vfs_type"
35515 #: ../src/guestfs-actions.pod:8110
35519 " guestfs_vfs_type (guestfs_h *g,\n"
35520 " const char *device);\n"
35525 #: ../src/guestfs-actions.pod:8127
35526 msgid "guestfs_vfs_uuid"
35530 #: ../src/guestfs-actions.pod:8129
35534 " guestfs_vfs_uuid (guestfs_h *g,\n"
35535 " const char *device);\n"
35540 #: ../src/guestfs-actions.pod:8138
35541 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>."
35545 #: ../src/guestfs-actions.pod:8145
35546 msgid "guestfs_vg_activate"
35550 #: ../src/guestfs-actions.pod:8147
35554 " guestfs_vg_activate (guestfs_h *g,\n"
35556 " char *const *volgroups);\n"
35561 #: ../src/guestfs-actions.pod:8164
35562 msgid "guestfs_vg_activate_all"
35566 #: ../src/guestfs-actions.pod:8166
35570 " guestfs_vg_activate_all (guestfs_h *g,\n"
35571 " int activate);\n"
35576 #: ../src/guestfs-actions.pod:8179
35577 msgid "guestfs_vgcreate"
35581 #: ../src/guestfs-actions.pod:8181
35585 " guestfs_vgcreate (guestfs_h *g,\n"
35586 " const char *volgroup,\n"
35587 " char *const *physvols);\n"
35592 #: ../src/guestfs-actions.pod:8193
35593 msgid "guestfs_vglvuuids"
35597 #: ../src/guestfs-actions.pod:8195
35601 " guestfs_vglvuuids (guestfs_h *g,\n"
35602 " const char *vgname);\n"
35607 #: ../src/guestfs-actions.pod:8202
35609 "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to "
35610 "associate logical volumes and volume groups."
35614 #: ../src/guestfs-actions.pod:8205
35615 msgid "See also C<guestfs_vgpvuuids>."
35619 #: ../src/guestfs-actions.pod:8213
35620 msgid "guestfs_vgpvuuids"
35624 #: ../src/guestfs-actions.pod:8215
35628 " guestfs_vgpvuuids (guestfs_h *g,\n"
35629 " const char *vgname);\n"
35634 #: ../src/guestfs-actions.pod:8222
35636 "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to "
35637 "associate physical volumes and volume groups."
35641 #: ../src/guestfs-actions.pod:8225
35642 msgid "See also C<guestfs_vglvuuids>."
35646 #: ../src/guestfs-actions.pod:8233
35647 msgid "guestfs_vgremove"
35651 #: ../src/guestfs-actions.pod:8235
35655 " guestfs_vgremove (guestfs_h *g,\n"
35656 " const char *vgname);\n"
35661 #: ../src/guestfs-actions.pod:8248
35662 msgid "guestfs_vgrename"
35666 #: ../src/guestfs-actions.pod:8250
35670 " guestfs_vgrename (guestfs_h *g,\n"
35671 " const char *volgroup,\n"
35672 " const char *newvolgroup);\n"
35677 #: ../src/guestfs-actions.pod:8261
35678 msgid "guestfs_vgs"
35682 #: ../src/guestfs-actions.pod:8263
35686 " guestfs_vgs (guestfs_h *g);\n"
35691 #: ../src/guestfs-actions.pod:8272
35692 msgid "See also C<guestfs_vgs_full>."
35696 #: ../src/guestfs-actions.pod:8280
35697 msgid "guestfs_vgs_full"
35701 #: ../src/guestfs-actions.pod:8282
35704 " struct guestfs_lvm_vg_list *\n"
35705 " guestfs_vgs_full (guestfs_h *g);\n"
35710 #: ../src/guestfs-actions.pod:8288
35712 "This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there "
35713 "was an error. I<The caller must call C<guestfs_free_lvm_vg_list> after use>."
35717 #: ../src/guestfs-actions.pod:8294
35718 msgid "guestfs_vgscan"
35722 #: ../src/guestfs-actions.pod:8296
35726 " guestfs_vgscan (guestfs_h *g);\n"
35731 #: ../src/guestfs-actions.pod:8306
35732 msgid "guestfs_vguuid"
35736 #: ../src/guestfs-actions.pod:8308
35740 " guestfs_vguuid (guestfs_h *g,\n"
35741 " const char *vgname);\n"
35746 #: ../src/guestfs-actions.pod:8319
35747 msgid "guestfs_wait_ready"
35751 #: ../src/guestfs-actions.pod:8321
35755 " guestfs_wait_ready (guestfs_h *g);\n"
35760 #: ../src/guestfs-actions.pod:8324
35762 "I<This function is deprecated.> In new code, use the L</guestfs_launch> call "
35767 #: ../src/guestfs-actions.pod:8331
35768 msgid "This function is a no op."
35772 #: ../src/guestfs-actions.pod:8333
35774 "In versions of the API E<lt> 1.0.71 you had to call this function just after "
35775 "calling C<guestfs_launch> to wait for the launch to complete. However this "
35776 "is no longer necessary because C<guestfs_launch> now does the waiting."
35780 #: ../src/guestfs-actions.pod:8338
35782 "If you see any calls to this function in code then you can just remove them, "
35783 "unless you want to retain compatibility with older versions of the API."
35787 #: ../src/guestfs-actions.pod:8346
35788 msgid "guestfs_wc_c"
35792 #: ../src/guestfs-actions.pod:8348
35796 " guestfs_wc_c (guestfs_h *g,\n"
35797 " const char *path);\n"
35802 #: ../src/guestfs-actions.pod:8359
35803 msgid "guestfs_wc_l"
35807 #: ../src/guestfs-actions.pod:8361
35811 " guestfs_wc_l (guestfs_h *g,\n"
35812 " const char *path);\n"
35817 #: ../src/guestfs-actions.pod:8372
35818 msgid "guestfs_wc_w"
35822 #: ../src/guestfs-actions.pod:8374
35826 " guestfs_wc_w (guestfs_h *g,\n"
35827 " const char *path);\n"
35832 #: ../src/guestfs-actions.pod:8385
35833 msgid "guestfs_write"
35837 #: ../src/guestfs-actions.pod:8387
35841 " guestfs_write (guestfs_h *g,\n"
35842 " const char *path,\n"
35843 " const char *content,\n"
35844 " size_t content_size);\n"
35849 #: ../src/guestfs-actions.pod:8396
35850 msgid "See also C<guestfs_write_append>."
35854 #: ../src/guestfs-actions.pod:8405
35855 msgid "guestfs_write_append"
35859 #: ../src/guestfs-actions.pod:8407
35863 " guestfs_write_append (guestfs_h *g,\n"
35864 " const char *path,\n"
35865 " const char *content,\n"
35866 " size_t content_size);\n"
35871 #: ../src/guestfs-actions.pod:8416
35872 msgid "See also C<guestfs_write>."
35876 #: ../src/guestfs-actions.pod:8425
35877 msgid "guestfs_write_file"
35878 msgstr "guestfs_write_file"
35881 #: ../src/guestfs-actions.pod:8427
35885 " guestfs_write_file (guestfs_h *g,\n"
35886 " const char *path,\n"
35887 " const char *content,\n"
35892 " guestfs_write_file (guestfs_h *g,\n"
35893 " const char *path,\n"
35894 " const char *content,\n"
35899 #: ../src/guestfs-actions.pod:8433
35901 "I<This function is deprecated.> In new code, use the L</guestfs_write> call "
35906 #: ../src/guestfs-actions.pod:8458
35907 msgid "guestfs_zegrep"
35908 msgstr "guestfs_zegrep"
35911 #: ../src/guestfs-actions.pod:8460
35915 " guestfs_zegrep (guestfs_h *g,\n"
35916 " const char *regex,\n"
35917 " const char *path);\n"
35921 " guestfs_zegrep (guestfs_h *g,\n"
35922 " const char *regex,\n"
35923 " const char *path);\n"
35927 #: ../src/guestfs-actions.pod:8477
35928 msgid "guestfs_zegrepi"
35929 msgstr "guestfs_zegrepi"
35932 #: ../src/guestfs-actions.pod:8479
35936 " guestfs_zegrepi (guestfs_h *g,\n"
35937 " const char *regex,\n"
35938 " const char *path);\n"
35942 " guestfs_zegrepi (guestfs_h *g,\n"
35943 " const char *regex,\n"
35944 " const char *path);\n"
35948 #: ../src/guestfs-actions.pod:8496
35949 msgid "guestfs_zero"
35950 msgstr "guestfs_zero"
35953 #: ../src/guestfs-actions.pod:8498
35957 " guestfs_zero (guestfs_h *g,\n"
35958 " const char *device);\n"
35962 " guestfs_zero (guestfs_h *g,\n"
35963 " const char *device);\n"
35967 #: ../src/guestfs-actions.pod:8512
35969 "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>, "
35970 "C<guestfs_is_zero_device>"
35974 #: ../src/guestfs-actions.pod:8524
35975 msgid "guestfs_zero_device"
35976 msgstr "guestfs_zero_device"
35979 #: ../src/guestfs-actions.pod:8526
35983 " guestfs_zero_device (guestfs_h *g,\n"
35984 " const char *device);\n"
35988 " guestfs_zero_device (guestfs_h *g,\n"
35989 " const char *device);\n"
35993 #: ../src/guestfs-actions.pod:8530
35995 "This command writes zeroes over the entire C<device>. Compare with "
35996 "C<guestfs_zero> which just zeroes the first few blocks of a device."
36000 #: ../src/guestfs-actions.pod:8545
36001 msgid "(Added in 1.3.1)"
36002 msgstr "(Додано у 1.3.1)"
36005 #: ../src/guestfs-actions.pod:8547
36006 msgid "guestfs_zerofree"
36007 msgstr "guestfs_zerofree"
36010 #: ../src/guestfs-actions.pod:8549
36014 " guestfs_zerofree (guestfs_h *g,\n"
36015 " const char *device);\n"
36019 " guestfs_zerofree (guestfs_h *g,\n"
36020 " const char *device);\n"
36024 #: ../src/guestfs-actions.pod:8568
36025 msgid "guestfs_zfgrep"
36026 msgstr "guestfs_zfgrep"
36029 #: ../src/guestfs-actions.pod:8570
36033 " guestfs_zfgrep (guestfs_h *g,\n"
36034 " const char *pattern,\n"
36035 " const char *path);\n"
36039 " guestfs_zfgrep (guestfs_h *g,\n"
36040 " const char *pattern,\n"
36041 " const char *path);\n"
36045 #: ../src/guestfs-actions.pod:8587
36046 msgid "guestfs_zfgrepi"
36047 msgstr "guestfs_zfgrepi"
36050 #: ../src/guestfs-actions.pod:8589
36054 " guestfs_zfgrepi (guestfs_h *g,\n"
36055 " const char *pattern,\n"
36056 " const char *path);\n"
36060 " guestfs_zfgrepi (guestfs_h *g,\n"
36061 " const char *pattern,\n"
36062 " const char *path);\n"
36066 #: ../src/guestfs-actions.pod:8606
36067 msgid "guestfs_zfile"
36068 msgstr "guestfs_zfile"
36071 #: ../src/guestfs-actions.pod:8608
36075 " guestfs_zfile (guestfs_h *g,\n"
36076 " const char *meth,\n"
36077 " const char *path);\n"
36081 " guestfs_zfile (guestfs_h *g,\n"
36082 " const char *meth,\n"
36083 " const char *path);\n"
36087 #: ../src/guestfs-actions.pod:8613
36089 "I<This function is deprecated.> In new code, use the L</guestfs_file> call "
36094 #: ../src/guestfs-actions.pod:8625
36096 "Since 1.0.63, use C<guestfs_file> instead which can now process compressed "
36101 #: ../src/guestfs-actions.pod:8633
36102 msgid "guestfs_zgrep"
36103 msgstr "guestfs_zgrep"
36106 #: ../src/guestfs-actions.pod:8635
36110 " guestfs_zgrep (guestfs_h *g,\n"
36111 " const char *regex,\n"
36112 " const char *path);\n"
36116 " guestfs_zgrep (guestfs_h *g,\n"
36117 " const char *regex,\n"
36118 " const char *path);\n"
36122 #: ../src/guestfs-actions.pod:8652
36123 msgid "guestfs_zgrepi"
36124 msgstr "guestfs_zgrepi"
36127 #: ../src/guestfs-actions.pod:8654
36131 " guestfs_zgrepi (guestfs_h *g,\n"
36132 " const char *regex,\n"
36133 " const char *path);\n"
36137 " guestfs_zgrepi (guestfs_h *g,\n"
36138 " const char *regex,\n"
36139 " const char *path);\n"
36143 #: ../src/guestfs-availability.pod:3
36148 #: ../src/guestfs-availability.pod:5
36150 "The following functions: L</guestfs_aug_clear> L</guestfs_aug_close> L</"
36151 "guestfs_aug_defnode> L</guestfs_aug_defvar> L</guestfs_aug_get> L</"
36152 "guestfs_aug_init> L</guestfs_aug_insert> L</guestfs_aug_load> L</"
36153 "guestfs_aug_ls> L</guestfs_aug_match> L</guestfs_aug_mv> L</guestfs_aug_rm> "
36154 "L</guestfs_aug_save> L</guestfs_aug_set>"
36158 #: ../src/guestfs-availability.pod:21
36163 #: ../src/guestfs-availability.pod:23
36164 msgid "The following functions: L</guestfs_btrfs_filesystem_resize>"
36168 #: ../src/guestfs-availability.pod:26
36173 #: ../src/guestfs-availability.pod:28
36174 msgid "The following functions: L</guestfs_grub_install>"
36178 #: ../src/guestfs-availability.pod:31
36180 msgstr "B<inotify>"
36183 #: ../src/guestfs-availability.pod:33
36185 "The following functions: L</guestfs_inotify_add_watch> L</"
36186 "guestfs_inotify_close> L</guestfs_inotify_files> L</guestfs_inotify_init> L</"
36187 "guestfs_inotify_read> L</guestfs_inotify_rm_watch>"
36191 #: ../src/guestfs-availability.pod:41
36192 msgid "B<linuxfsuuid>"
36193 msgstr "B<linuxfsuuid>"
36196 #: ../src/guestfs-availability.pod:43
36198 "The following functions: L</guestfs_mke2fs_JU> L</guestfs_mke2journal_U> L</"
36199 "guestfs_mkswap_U> L</guestfs_swapoff_uuid> L</guestfs_swapon_uuid>"
36203 #: ../src/guestfs-availability.pod:50
36204 msgid "B<linuxmodules>"
36205 msgstr "B<linuxmodules>"
36208 #: ../src/guestfs-availability.pod:52
36209 msgid "The following functions: L</guestfs_modprobe>"
36213 #: ../src/guestfs-availability.pod:55
36214 msgid "B<linuxxattrs>"
36215 msgstr "B<linuxxattrs>"
36218 #: ../src/guestfs-availability.pod:57
36220 "The following functions: L</guestfs_getxattr> L</guestfs_getxattrs> L</"
36221 "guestfs_lgetxattr> L</guestfs_lgetxattrs> L</guestfs_lremovexattr> L</"
36222 "guestfs_lsetxattr> L</guestfs_lxattrlist> L</guestfs_removexattr> L</"
36223 "guestfs_setxattr>"
36227 #: ../src/guestfs-availability.pod:68
36232 #: ../src/guestfs-availability.pod:70
36234 "The following functions: L</guestfs_luks_add_key> L</guestfs_luks_close> L</"
36235 "guestfs_luks_format> L</guestfs_luks_format_cipher> L</"
36236 "guestfs_luks_kill_slot> L</guestfs_luks_open> L</guestfs_luks_open_ro>"
36240 #: ../src/guestfs-availability.pod:79
36245 #: ../src/guestfs-availability.pod:81
36247 "The following functions: L</guestfs_is_lv> L</guestfs_lvcreate> L</"
36248 "guestfs_lvm_remove_all> L</guestfs_lvm_set_filter> L</guestfs_lvremove> L</"
36249 "guestfs_lvresize> L</guestfs_lvresize_free> L</guestfs_lvs> L</"
36250 "guestfs_lvs_full> L</guestfs_pvcreate> L</guestfs_pvremove> L</"
36251 "guestfs_pvresize> L</guestfs_pvresize_size> L</guestfs_pvs> L</"
36252 "guestfs_pvs_full> L</guestfs_vg_activate> L</guestfs_vg_activate_all> L</"
36253 "guestfs_vgcreate> L</guestfs_vgremove> L</guestfs_vgs> L</guestfs_vgs_full>"
36257 #: ../src/guestfs-availability.pod:104
36262 #: ../src/guestfs-availability.pod:106
36264 "The following functions: L</guestfs_mdadm_create> L</guestfs_mdadm_detail>"
36268 #: ../src/guestfs-availability.pod:110
36273 #: ../src/guestfs-availability.pod:112
36275 "The following functions: L</guestfs_mkfifo> L</guestfs_mknod> L</"
36276 "guestfs_mknod_b> L</guestfs_mknod_c>"
36280 #: ../src/guestfs-availability.pod:118
36285 #: ../src/guestfs-availability.pod:120
36286 msgid "The following functions: L</guestfs_ntfs_3g_probe>"
36290 #: ../src/guestfs-availability.pod:123
36291 msgid "B<ntfsprogs>"
36292 msgstr "B<ntfsprogs>"
36295 #: ../src/guestfs-availability.pod:125
36297 "The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_opts> "
36298 "L</guestfs_ntfsresize_size>"
36302 #: ../src/guestfs-availability.pod:130
36303 msgid "B<realpath>"
36304 msgstr "B<realpath>"
36307 #: ../src/guestfs-availability.pod:132
36308 msgid "The following functions: L</guestfs_realpath>"
36312 #: ../src/guestfs-availability.pod:135
36317 #: ../src/guestfs-availability.pod:137
36319 "The following functions: L</guestfs_scrub_device> L</guestfs_scrub_file> L</"
36320 "guestfs_scrub_freespace>"
36324 #: ../src/guestfs-availability.pod:142
36326 msgstr "B<selinux>"
36329 #: ../src/guestfs-availability.pod:144
36330 msgid "The following functions: L</guestfs_getcon> L</guestfs_setcon>"
36334 #: ../src/guestfs-availability.pod:148
36339 #: ../src/guestfs-availability.pod:150
36340 msgid "The following functions: L</guestfs_txz_in> L</guestfs_txz_out>"
36344 #: ../src/guestfs-availability.pod:154
36345 msgid "B<zerofree>"
36346 msgstr "B<zerofree>"
36349 #: ../src/guestfs-availability.pod:156
36350 msgid "The following functions: L</guestfs_zerofree>"
36354 #: ../src/guestfs-structs.pod:1
36355 msgid "guestfs_int_bool"
36359 #: ../src/guestfs-structs.pod:3
36362 " struct guestfs_int_bool {\n"
36370 #: ../src/guestfs-structs.pod:8
36373 " struct guestfs_int_bool_list {\n"
36374 " uint32_t len; /* Number of elements in list. */\n"
36375 " struct guestfs_int_bool *val; /* Elements. */\n"
36381 #: ../src/guestfs-structs.pod:13
36384 " void guestfs_free_int_bool (struct guestfs_free_int_bool *);\n"
36385 " void guestfs_free_int_bool_list (struct guestfs_free_int_bool_list *);\n"
36390 #: ../src/guestfs-structs.pod:16
36391 msgid "guestfs_lvm_pv"
36395 #: ../src/guestfs-structs.pod:18
36398 " struct guestfs_lvm_pv {\n"
36399 " char *pv_name;\n"
36400 " /* The next field is NOT nul-terminated, be careful when printing it: */\n"
36401 " char pv_uuid[32];\n"
36403 " uint64_t pv_size;\n"
36404 " uint64_t dev_size;\n"
36405 " uint64_t pv_free;\n"
36406 " uint64_t pv_used;\n"
36407 " char *pv_attr;\n"
36408 " int64_t pv_pe_count;\n"
36409 " int64_t pv_pe_alloc_count;\n"
36410 " char *pv_tags;\n"
36411 " uint64_t pe_start;\n"
36412 " int64_t pv_mda_count;\n"
36413 " uint64_t pv_mda_free;\n"
36419 #: ../src/guestfs-structs.pod:36
36422 " struct guestfs_lvm_pv_list {\n"
36423 " uint32_t len; /* Number of elements in list. */\n"
36424 " struct guestfs_lvm_pv *val; /* Elements. */\n"
36430 #: ../src/guestfs-structs.pod:41
36433 " void guestfs_free_lvm_pv (struct guestfs_free_lvm_pv *);\n"
36434 " void guestfs_free_lvm_pv_list (struct guestfs_free_lvm_pv_list *);\n"
36439 #: ../src/guestfs-structs.pod:44
36440 msgid "guestfs_lvm_vg"
36444 #: ../src/guestfs-structs.pod:46
36447 " struct guestfs_lvm_vg {\n"
36448 " char *vg_name;\n"
36449 " /* The next field is NOT nul-terminated, be careful when printing it: */\n"
36450 " char vg_uuid[32];\n"
36452 " char *vg_attr;\n"
36453 " uint64_t vg_size;\n"
36454 " uint64_t vg_free;\n"
36455 " char *vg_sysid;\n"
36456 " uint64_t vg_extent_size;\n"
36457 " int64_t vg_extent_count;\n"
36458 " int64_t vg_free_count;\n"
36459 " int64_t max_lv;\n"
36460 " int64_t max_pv;\n"
36461 " int64_t pv_count;\n"
36462 " int64_t lv_count;\n"
36463 " int64_t snap_count;\n"
36464 " int64_t vg_seqno;\n"
36465 " char *vg_tags;\n"
36466 " int64_t vg_mda_count;\n"
36467 " uint64_t vg_mda_free;\n"
36473 #: ../src/guestfs-structs.pod:69
36476 " struct guestfs_lvm_vg_list {\n"
36477 " uint32_t len; /* Number of elements in list. */\n"
36478 " struct guestfs_lvm_vg *val; /* Elements. */\n"
36484 #: ../src/guestfs-structs.pod:74
36487 " void guestfs_free_lvm_vg (struct guestfs_free_lvm_vg *);\n"
36488 " void guestfs_free_lvm_vg_list (struct guestfs_free_lvm_vg_list *);\n"
36493 #: ../src/guestfs-structs.pod:77
36494 msgid "guestfs_lvm_lv"
36498 #: ../src/guestfs-structs.pod:79
36501 " struct guestfs_lvm_lv {\n"
36502 " char *lv_name;\n"
36503 " /* The next field is NOT nul-terminated, be careful when printing it: */\n"
36504 " char lv_uuid[32];\n"
36505 " char *lv_attr;\n"
36506 " int64_t lv_major;\n"
36507 " int64_t lv_minor;\n"
36508 " int64_t lv_kernel_major;\n"
36509 " int64_t lv_kernel_minor;\n"
36510 " uint64_t lv_size;\n"
36511 " int64_t seg_count;\n"
36513 " /* The next field is [0..100] or -1 meaning 'not present': */\n"
36514 " float snap_percent;\n"
36515 " /* The next field is [0..100] or -1 meaning 'not present': */\n"
36516 " float copy_percent;\n"
36517 " char *move_pv;\n"
36518 " char *lv_tags;\n"
36519 " char *mirror_log;\n"
36520 " char *modules;\n"
36526 #: ../src/guestfs-structs.pod:101
36529 " struct guestfs_lvm_lv_list {\n"
36530 " uint32_t len; /* Number of elements in list. */\n"
36531 " struct guestfs_lvm_lv *val; /* Elements. */\n"
36537 #: ../src/guestfs-structs.pod:106
36540 " void guestfs_free_lvm_lv (struct guestfs_free_lvm_lv *);\n"
36541 " void guestfs_free_lvm_lv_list (struct guestfs_free_lvm_lv_list *);\n"
36546 #: ../src/guestfs-structs.pod:111
36549 " struct guestfs_stat {\n"
36553 " int64_t nlink;\n"
36558 " int64_t blksize;\n"
36559 " int64_t blocks;\n"
36560 " int64_t atime;\n"
36561 " int64_t mtime;\n"
36562 " int64_t ctime;\n"
36568 #: ../src/guestfs-structs.pod:127
36571 " struct guestfs_stat_list {\n"
36572 " uint32_t len; /* Number of elements in list. */\n"
36573 " struct guestfs_stat *val; /* Elements. */\n"
36579 #: ../src/guestfs-structs.pod:132
36582 " void guestfs_free_stat (struct guestfs_free_stat *);\n"
36583 " void guestfs_free_stat_list (struct guestfs_free_stat_list *);\n"
36588 #: ../src/guestfs-structs.pod:137
36591 " struct guestfs_statvfs {\n"
36592 " int64_t bsize;\n"
36593 " int64_t frsize;\n"
36594 " int64_t blocks;\n"
36595 " int64_t bfree;\n"
36596 " int64_t bavail;\n"
36597 " int64_t files;\n"
36598 " int64_t ffree;\n"
36599 " int64_t favail;\n"
36602 " int64_t namemax;\n"
36608 #: ../src/guestfs-structs.pod:151
36611 " struct guestfs_statvfs_list {\n"
36612 " uint32_t len; /* Number of elements in list. */\n"
36613 " struct guestfs_statvfs *val; /* Elements. */\n"
36619 #: ../src/guestfs-structs.pod:156
36622 " void guestfs_free_statvfs (struct guestfs_free_statvfs *);\n"
36623 " void guestfs_free_statvfs_list (struct guestfs_free_statvfs_list *);\n"
36628 #: ../src/guestfs-structs.pod:159
36629 msgid "guestfs_dirent"
36633 #: ../src/guestfs-structs.pod:161
36636 " struct guestfs_dirent {\n"
36645 #: ../src/guestfs-structs.pod:167
36648 " struct guestfs_dirent_list {\n"
36649 " uint32_t len; /* Number of elements in list. */\n"
36650 " struct guestfs_dirent *val; /* Elements. */\n"
36656 #: ../src/guestfs-structs.pod:172
36659 " void guestfs_free_dirent (struct guestfs_free_dirent *);\n"
36660 " void guestfs_free_dirent_list (struct guestfs_free_dirent_list *);\n"
36665 #: ../src/guestfs-structs.pod:177
36668 " struct guestfs_version {\n"
36669 " int64_t major;\n"
36670 " int64_t minor;\n"
36671 " int64_t release;\n"
36678 #: ../src/guestfs-structs.pod:184
36681 " struct guestfs_version_list {\n"
36682 " uint32_t len; /* Number of elements in list. */\n"
36683 " struct guestfs_version *val; /* Elements. */\n"
36689 #: ../src/guestfs-structs.pod:189
36692 " void guestfs_free_version (struct guestfs_free_version *);\n"
36693 " void guestfs_free_version_list (struct guestfs_free_version_list *);\n"
36698 #: ../src/guestfs-structs.pod:192
36699 msgid "guestfs_xattr"
36703 #: ../src/guestfs-structs.pod:194
36706 " struct guestfs_xattr {\n"
36707 " char *attrname;\n"
36708 " /* The next two fields describe a byte array. */\n"
36709 " uint32_t attrval_len;\n"
36710 " char *attrval;\n"
36716 #: ../src/guestfs-structs.pod:201
36719 " struct guestfs_xattr_list {\n"
36720 " uint32_t len; /* Number of elements in list. */\n"
36721 " struct guestfs_xattr *val; /* Elements. */\n"
36727 #: ../src/guestfs-structs.pod:206
36730 " void guestfs_free_xattr (struct guestfs_free_xattr *);\n"
36731 " void guestfs_free_xattr_list (struct guestfs_free_xattr_list *);\n"
36736 #: ../src/guestfs-structs.pod:209
36737 msgid "guestfs_inotify_event"
36741 #: ../src/guestfs-structs.pod:211
36744 " struct guestfs_inotify_event {\n"
36745 " int64_t in_wd;\n"
36746 " uint32_t in_mask;\n"
36747 " uint32_t in_cookie;\n"
36748 " char *in_name;\n"
36754 #: ../src/guestfs-structs.pod:218
36757 " struct guestfs_inotify_event_list {\n"
36758 " uint32_t len; /* Number of elements in list. */\n"
36759 " struct guestfs_inotify_event *val; /* Elements. */\n"
36765 #: ../src/guestfs-structs.pod:223
36768 " void guestfs_free_inotify_event (struct guestfs_free_inotify_event *);\n"
36769 " void guestfs_free_inotify_event_list (struct guestfs_free_inotify_event_list *);\n"
36774 #: ../src/guestfs-structs.pod:226
36775 msgid "guestfs_partition"
36779 #: ../src/guestfs-structs.pod:228
36782 " struct guestfs_partition {\n"
36783 " int32_t part_num;\n"
36784 " uint64_t part_start;\n"
36785 " uint64_t part_end;\n"
36786 " uint64_t part_size;\n"
36792 #: ../src/guestfs-structs.pod:235
36795 " struct guestfs_partition_list {\n"
36796 " uint32_t len; /* Number of elements in list. */\n"
36797 " struct guestfs_partition *val; /* Elements. */\n"
36803 #: ../src/guestfs-structs.pod:240
36806 " void guestfs_free_partition (struct guestfs_free_partition *);\n"
36807 " void guestfs_free_partition_list (struct guestfs_free_partition_list *);\n"
36812 #: ../src/guestfs-structs.pod:243
36813 msgid "guestfs_application"
36817 #: ../src/guestfs-structs.pod:245
36820 " struct guestfs_application {\n"
36821 " char *app_name;\n"
36822 " char *app_display_name;\n"
36823 " int32_t app_epoch;\n"
36824 " char *app_version;\n"
36825 " char *app_release;\n"
36826 " char *app_install_path;\n"
36827 " char *app_trans_path;\n"
36828 " char *app_publisher;\n"
36829 " char *app_url;\n"
36830 " char *app_source_package;\n"
36831 " char *app_summary;\n"
36832 " char *app_description;\n"
36838 #: ../src/guestfs-structs.pod:260
36841 " struct guestfs_application_list {\n"
36842 " uint32_t len; /* Number of elements in list. */\n"
36843 " struct guestfs_application *val; /* Elements. */\n"
36849 #: ../src/guestfs-structs.pod:265
36852 " void guestfs_free_application (struct guestfs_free_application *);\n"
36853 " void guestfs_free_application_list (struct guestfs_free_application_list *);\n"
36858 #: ../src/guestfs.pod:5
36859 msgid "guestfs - Library for accessing and modifying virtual machine images"
36861 "guestfs — бібліотека для доступу та внесення змін до образів віртуальних "
36865 #: ../src/guestfs.pod:11
36868 " guestfs_h *g = guestfs_create ();\n"
36869 " guestfs_add_drive (g, \"guest.img\");\n"
36870 " guestfs_launch (g);\n"
36871 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
36872 " guestfs_touch (g, \"/hello\");\n"
36873 " guestfs_umount (g, \"/\");\n"
36874 " guestfs_close (g);\n"
36877 " guestfs_h *g = guestfs_create ();\n"
36878 " guestfs_add_drive (g, \"guest.img\");\n"
36879 " guestfs_launch (g);\n"
36880 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
36881 " guestfs_touch (g, \"/hello\");\n"
36882 " guestfs_umount (g, \"/\");\n"
36883 " guestfs_close (g);\n"
36887 #: ../src/guestfs.pod:25
36889 "Libguestfs is a library for accessing and modifying guest disk images. "
36890 "Amongst the things this is good for: making batch configuration changes to "
36891 "guests, getting disk used/free statistics (see also: virt-df), migrating "
36892 "between virtualization systems (see also: virt-p2v), performing partial "
36893 "backups, performing partial guest clones, cloning guests and changing "
36894 "registry/UUID/hostname info, and much else besides."
36898 #: ../src/guestfs.pod:33
36900 "Libguestfs uses Linux kernel and qemu code, and can access any type of guest "
36901 "filesystem that Linux and qemu can, including but not limited to: ext2/3/4, "
36902 "btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, "
36907 #: ../src/guestfs.pod:38
36909 "Libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, "
36910 "what filesystem is in each LV, etc.). It can also run commands in the "
36911 "context of the guest. Also you can access filesystems over FUSE."
36915 #: ../src/guestfs.pod:43
36917 "Libguestfs is a library that can be linked with C and C++ management "
36918 "programs (or management programs written in OCaml, Perl, Python, Ruby, Java, "
36919 "PHP, Erlang, Haskell or C#). You can also use it from shell scripts or the "
36924 #: ../src/guestfs.pod:48
36926 "You don't need to be root to use libguestfs, although obviously you do need "
36927 "enough permissions to access the disk images."
36931 #: ../src/guestfs.pod:51
36933 "Libguestfs is a large API because it can do many things. For a gentle "
36934 "introduction, please read the L</API OVERVIEW> section next."
36938 #: ../src/guestfs.pod:54
36940 "There are also some example programs in the L<guestfs-examples(3)> manual "
36945 #: ../src/guestfs.pod:57
36946 msgid "API OVERVIEW"
36950 #: ../src/guestfs.pod:59
36952 "This section provides a gentler overview of the libguestfs API. We also try "
36953 "to group API calls together, where that may not be obvious from reading "
36954 "about the individual calls in the main section of this manual."
36958 #: ../src/guestfs.pod:64
36963 #: ../src/guestfs.pod:66
36965 "Before you can use libguestfs calls, you have to create a handle. Then you "
36966 "must add at least one disk image to the handle, followed by launching the "
36967 "handle, then performing whatever operations you want, and finally closing "
36968 "the handle. By convention we use the single letter C<g> for the name of the "
36969 "handle variable, although of course you can use any name you want."
36973 #: ../src/guestfs.pod:73
36974 msgid "The general structure of all libguestfs-using programs looks like this:"
36978 #: ../src/guestfs.pod:76
36981 " guestfs_h *g = guestfs_create ();\n"
36984 " guestfs_h *g = guestfs_create ();\n"
36988 #: ../src/guestfs.pod:78
36991 " /* Call guestfs_add_drive additional times if there are\n"
36992 " * multiple disk images.\n"
36994 " guestfs_add_drive (g, \"guest.img\");\n"
36999 #: ../src/guestfs.pod:83
37002 " /* Most manipulation calls won't work until you've launched\n"
37003 " * the handle 'g'. You have to do this _after_ adding drives\n"
37004 " * and _before_ other commands.\n"
37006 " guestfs_launch (g);\n"
37011 #: ../src/guestfs.pod:89
37014 " /* Now you can examine what partitions, LVs etc are available.\n"
37016 " char **partitions = guestfs_list_partitions (g);\n"
37017 " char **logvols = guestfs_lvs (g);\n"
37020 " /* Тепер можна перевірити, які розділи, логічні томи тощо доступні.\n"
37022 " char **partitions = guestfs_list_partitions (g);\n"
37023 " char **logvols = guestfs_lvs (g);\n"
37027 #: ../src/guestfs.pod:94
37030 " /* To access a filesystem in the image, you must mount it.\n"
37032 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
37035 " /* Щоб отримати доступ до файлової системи на образі, вам слід його змонтувати.\n"
37037 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
37041 #: ../src/guestfs.pod:98
37044 " /* Now you can perform filesystem actions on the guest\n"
37047 " guestfs_touch (g, \"/hello\");\n"
37050 " /* Тепер ви можете виконувати дії з файловою системою на\n"
37051 " * образі диска операційної системи.\n"
37053 " guestfs_touch (g, \"/hello\");\n"
37057 #: ../src/guestfs.pod:103
37060 " /* This is only needed for libguestfs < 1.5.24. Since then\n"
37061 " * it is done automatically when you close the handle. See\n"
37062 " * discussion of autosync in this page.\n"
37064 " guestfs_sync (g);\n"
37069 #: ../src/guestfs.pod:109
37072 " /* Close the handle 'g'. */\n"
37073 " guestfs_close (g);\n"
37076 " /* Закрити дескриптор 'g'. */\n"
37077 " guestfs_close (g);\n"
37081 #: ../src/guestfs.pod:112
37083 "The code above doesn't include any error checking. In real code you should "
37084 "check return values carefully for errors. In general all functions that "
37085 "return integers return C<-1> on error, and all functions that return "
37086 "pointers return C<NULL> on error. See section L</ERROR HANDLING> below for "
37087 "how to handle errors, and consult the documentation for each function call "
37088 "below to see precisely how they return error indications. See L<guestfs-"
37089 "examples(3)> for fully worked examples."
37093 #: ../src/guestfs.pod:121
37094 msgid "DISK IMAGES"
37095 msgstr "ОБРАЗИ ДИСКІВ"
37098 #: ../src/guestfs.pod:123
37100 "The image filename (C<\"guest.img\"> in the example above) could be a disk "
37101 "image from a virtual machine, a L<dd(1)> copy of a physical hard disk, an "
37102 "actual block device, or simply an empty file of zeroes that you have created "
37103 "through L<posix_fallocate(3)>. Libguestfs lets you do useful things to all "
37108 #: ../src/guestfs.pod:129
37110 "The call you should use in modern code for adding drives is L</"
37111 "guestfs_add_drive_opts>. To add a disk image, allowing writes, and "
37112 "specifying that the format is raw, do:"
37116 #: ../src/guestfs.pod:133
37119 " guestfs_add_drive_opts (g, filename,\n"
37120 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
37124 " guestfs_add_drive_opts (g, filename,\n"
37125 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
37130 #: ../src/guestfs.pod:137
37131 msgid "You can add a disk read-only using:"
37132 msgstr "Ви можете додати диск у режимі лише читання:"
37135 #: ../src/guestfs.pod:139
37138 " guestfs_add_drive_opts (g, filename,\n"
37139 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
37140 " GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
37144 " guestfs_add_drive_opts (g, filename,\n"
37145 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
37146 " GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
37151 #: ../src/guestfs.pod:144
37153 "or by calling the older function L</guestfs_add_drive_ro>. In either case "
37154 "libguestfs won't modify the file."
37158 #: ../src/guestfs.pod:147
37160 "Be extremely cautious if the disk image is in use, eg. if it is being used "
37161 "by a virtual machine. Adding it read-write will almost certainly cause disk "
37162 "corruption, but adding it read-only is safe."
37166 #: ../src/guestfs.pod:151
37168 "You must add at least one disk image, and you may add multiple disk images. "
37169 "In the API, the disk images are usually referred to as C</dev/sda> (for the "
37170 "first one you added), C</dev/sdb> (for the second one you added), etc."
37174 #: ../src/guestfs.pod:156
37176 "Once L</guestfs_launch> has been called you cannot add any more images. You "
37177 "can call L</guestfs_list_devices> to get a list of the device names, in the "
37178 "order that you added them. See also L</BLOCK DEVICE NAMING> below."
37182 #: ../src/guestfs.pod:161
37184 msgstr "МОНТУВАННЯ"
37187 #: ../src/guestfs.pod:163
37189 "Before you can read or write files, create directories and so on in a disk "
37190 "image that contains filesystems, you have to mount those filesystems using "
37191 "L</guestfs_mount_options> or L</guestfs_mount_ro>. If you already know that "
37192 "a disk image contains (for example) one partition with a filesystem on that "
37193 "partition, then you can mount it directly:"
37197 #: ../src/guestfs.pod:170
37200 " guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n"
37203 " guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n"
37207 #: ../src/guestfs.pod:172
37209 "where C</dev/sda1> means literally the first partition (C<1>) of the first "
37210 "disk image that we added (C</dev/sda>). If the disk contains Linux LVM2 "
37211 "logical volumes you could refer to those instead (eg. C</dev/VG/LV>). Note "
37212 "that these are libguestfs virtual devices, and are nothing to do with host "
37217 #: ../src/guestfs.pod:178
37219 "If you are given a disk image and you don't know what it contains then you "
37220 "have to find out. Libguestfs can do that too: use L</"
37221 "guestfs_list_partitions> and L</guestfs_lvs> to list possible partitions and "
37222 "LVs, and either try mounting each to see what is mountable, or else examine "
37223 "them with L</guestfs_vfs_type> or L</guestfs_file>. To list just "
37224 "filesystems, use L</guestfs_list_filesystems>."
37228 #: ../src/guestfs.pod:186
37230 "Libguestfs also has a set of APIs for inspection of unknown disk images (see "
37231 "L</INSPECTION> below). But you might find it easier to look at higher level "
37232 "programs built on top of libguestfs, in particular L<virt-inspector(1)>."
37236 #: ../src/guestfs.pod:191
37238 "To mount a filesystem read-only, use L</guestfs_mount_ro>. There are "
37239 "several other variations of the C<guestfs_mount_*> call."
37243 #: ../src/guestfs.pod:194
37244 msgid "FILESYSTEM ACCESS AND MODIFICATION"
37245 msgstr "ДОСТУП ТА ВНЕСЕННЯ ЗМІН ДО ФАЙЛОВИХ СИСТЕМ"
37248 #: ../src/guestfs.pod:196
37250 "The majority of the libguestfs API consists of fairly low-level calls for "
37251 "accessing and modifying the files, directories, symlinks etc on mounted "
37252 "filesystems. There are over a hundred such calls which you can find listed "
37253 "in detail below in this man page, and we don't even pretend to cover them "
37254 "all in this overview."
37258 #: ../src/guestfs.pod:202
37260 "Specify filenames as full paths, starting with C<\"/\"> and including the "
37263 "Вказуйте адреси і назви файлів повністю, починаючи з C<\"/\">, разом з "
37264 "точкою монтування."
37267 #: ../src/guestfs.pod:205
37269 "For example, if you mounted a filesystem at C<\"/\"> and you want to read "
37270 "the file called C<\"etc/passwd\"> then you could do:"
37272 "Наприклад, якщо вами змонтовано файлову систему до C<\"/\">, і ви бажаєте "
37273 "виконати читання файла з назвою C<\"etc/passwd\">, ви можете скористатися "
37277 #: ../src/guestfs.pod:208
37280 " char *data = guestfs_cat (g, \"/etc/passwd\");\n"
37283 " char *data = guestfs_cat (g, \"/etc/passwd\");\n"
37287 #: ../src/guestfs.pod:210
37289 "This would return C<data> as a newly allocated buffer containing the full "
37290 "content of that file (with some conditions: see also L</DOWNLOADING> below), "
37291 "or C<NULL> if there was an error."
37295 #: ../src/guestfs.pod:214
37297 "As another example, to create a top-level directory on that filesystem "
37298 "called C<\"var\"> you would do:"
37302 #: ../src/guestfs.pod:217
37305 " guestfs_mkdir (g, \"/var\");\n"
37308 " guestfs_mkdir (g, \"/var\");\n"
37312 #: ../src/guestfs.pod:219
37313 msgid "To create a symlink you could do:"
37314 msgstr "Щоб створити символічне посилання, ви можете скористатися таким кодом:"
37317 #: ../src/guestfs.pod:221
37320 " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n"
37321 " \"/etc/rc3.d/S30portmap\");\n"
37324 " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n"
37325 " \"/etc/rc3.d/S30portmap\");\n"
37329 #: ../src/guestfs.pod:224
37331 "Libguestfs will reject attempts to use relative paths and there is no "
37332 "concept of a current working directory."
37336 #: ../src/guestfs.pod:227
37338 "Libguestfs can return errors in many situations: for example if the "
37339 "filesystem isn't writable, or if a file or directory that you requested "
37340 "doesn't exist. If you are using the C API (documented here) you have to "
37341 "check for those error conditions after each call. (Other language bindings "
37342 "turn these errors into exceptions)."
37346 #: ../src/guestfs.pod:233
37348 "File writes are affected by the per-handle umask, set by calling L</"
37349 "guestfs_umask> and defaulting to 022. See L</UMASK>."
37353 #: ../src/guestfs.pod:236
37354 msgid "PARTITIONING"
37355 msgstr "ПОДІЛ НА РОЗДІЛИ"
37358 #: ../src/guestfs.pod:238
37360 "Libguestfs contains API calls to read, create and modify partition tables on "
37365 #: ../src/guestfs.pod:241
37367 "In the common case where you want to create a single partition covering the "
37368 "whole disk, you should use the L</guestfs_part_disk> call:"
37372 #: ../src/guestfs.pod:245
37375 " const char *parttype = \"mbr\";\n"
37376 " if (disk_is_larger_than_2TB)\n"
37377 " parttype = \"gpt\";\n"
37378 " guestfs_part_disk (g, \"/dev/sda\", parttype);\n"
37381 " const char *parttype = \"mbr\";\n"
37382 " if (disk_is_larger_than_2TB)\n"
37383 " parttype = \"gpt\";\n"
37384 " guestfs_part_disk (g, \"/dev/sda\", parttype);\n"
37388 #: ../src/guestfs.pod:250
37390 "Obviously this effectively wipes anything that was on that disk image before."
37394 #: ../src/guestfs.pod:253
37399 #: ../src/guestfs.pod:255
37401 "Libguestfs provides access to a large part of the LVM2 API, such as L</"
37402 "guestfs_lvcreate> and L</guestfs_vgremove>. It won't make much sense unless "
37403 "you familiarize yourself with the concepts of physical volumes, volume "
37404 "groups and logical volumes."
37408 #: ../src/guestfs.pod:260
37410 "This author strongly recommends reading the LVM HOWTO, online at L<http://"
37411 "tldp.org/HOWTO/LVM-HOWTO/>."
37415 #: ../src/guestfs.pod:263
37416 msgid "DOWNLOADING"
37417 msgstr "ОТРИМАННЯ ДАНИХ"
37420 #: ../src/guestfs.pod:265
37422 "Use L</guestfs_cat> to download small, text only files. This call is "
37423 "limited to files which are less than 2 MB and which cannot contain any ASCII "
37424 "NUL (C<\\0>) characters. However the API is very simple to use."
37428 #: ../src/guestfs.pod:269
37430 "L</guestfs_read_file> can be used to read files which contain arbitrary 8 "
37431 "bit data, since it returns a (pointer, size) pair. However it is still "
37432 "limited to \"small\" files, less than 2 MB."
37436 #: ../src/guestfs.pod:273
37438 "L</guestfs_download> can be used to download any file, with no limits on "
37439 "content or size (even files larger than 4 GB)."
37443 #: ../src/guestfs.pod:276
37445 "To download multiple files, see L</guestfs_tar_out> and L</guestfs_tgz_out>."
37449 #: ../src/guestfs.pod:279
37451 msgstr "ВИВАНТАЖЕННЯ"
37454 #: ../src/guestfs.pod:281
37456 "It's often the case that you want to write a file or files to the disk image."
37460 #: ../src/guestfs.pod:284
37462 "To write a small file with fixed content, use L</guestfs_write>. To create "
37463 "a file of all zeroes, use L</guestfs_truncate_size> (sparse) or L</"
37464 "guestfs_fallocate64> (with all disk blocks allocated). There are a variety "
37465 "of other functions for creating test files, for example L</guestfs_fill> and "
37466 "L</guestfs_fill_pattern>."
37470 #: ../src/guestfs.pod:290
37472 "To upload a single file, use L</guestfs_upload>. This call has no limits on "
37473 "file content or size (even files larger than 4 GB)."
37477 #: ../src/guestfs.pod:293
37479 "To upload multiple files, see L</guestfs_tar_in> and L</guestfs_tgz_in>."
37483 #: ../src/guestfs.pod:295
37485 "However the fastest way to upload I<large numbers of arbitrary files> is to "
37486 "turn them into a squashfs or CD ISO (see L<mksquashfs(8)> and L<mkisofs(8)"
37487 ">), then attach this using L</guestfs_add_drive_ro>. If you add the drive "
37488 "in a predictable way (eg. adding it last after all other drives) then you "
37489 "can get the device name from L</guestfs_list_devices> and mount it directly "
37490 "using L</guestfs_mount_ro>. Note that squashfs images are sometimes non-"
37491 "portable between kernel versions, and they don't support labels or UUIDs. "
37492 "If you want to pre-build an image or you need to mount it using a label or "
37493 "UUID, use an ISO image instead."
37497 #: ../src/guestfs.pod:306
37499 msgstr "КОПІЮВАННЯ"
37502 #: ../src/guestfs.pod:308
37504 "There are various different commands for copying between files and devices "
37505 "and in and out of the guest filesystem. These are summarised in the table "
37510 #: ../src/guestfs.pod:314
37511 msgid "B<file> to B<file>"
37512 msgstr "B<файл> у B<файл>"
37515 #: ../src/guestfs.pod:316
37517 "Use L</guestfs_cp> to copy a single file, or L</guestfs_cp_a> to copy "
37518 "directories recursively."
37522 #: ../src/guestfs.pod:319
37524 "To copy part of a file (offset and size) use L</guestfs_copy_file_to_file>."
37528 #: ../src/guestfs.pod:322
37529 msgid "B<file> to B<device>"
37533 #: ../src/guestfs.pod:324
37534 msgid "B<device> to B<file>"
37538 #: ../src/guestfs.pod:326
37539 msgid "B<device> to B<device>"
37543 #: ../src/guestfs.pod:328
37545 "Use L</guestfs_copy_file_to_device>, L</guestfs_copy_device_to_file>, or L</"
37546 "guestfs_copy_device_to_device>."
37550 #: ../src/guestfs.pod:331
37551 msgid "Example: duplicate the contents of an LV:"
37555 #: ../src/guestfs.pod:333
37558 " guestfs_copy_device_to_device (g,\n"
37559 " \"/dev/VG/Original\", \"/dev/VG/Copy\",\n"
37560 " /* -1 marks the end of the list of optional parameters */\n"
37566 #: ../src/guestfs.pod:338
37568 "The destination (C</dev/VG/Copy>) must be at least as large as the source "
37569 "(C</dev/VG/Original>). To copy less than the whole source device, use the "
37570 "optional C<size> parameter:"
37574 #: ../src/guestfs.pod:342
37577 " guestfs_copy_device_to_device (g,\n"
37578 " \"/dev/VG/Original\", \"/dev/VG/Copy\",\n"
37579 " GUESTFS_COPY_DEVICE_TO_DEVICE_SIZE, 10000,\n"
37585 #: ../src/guestfs.pod:347
37586 msgid "B<file on the host> to B<file or device>"
37590 #: ../src/guestfs.pod:349
37591 msgid "Use L</guestfs_upload>. See L</UPLOADING> above."
37595 #: ../src/guestfs.pod:351
37596 msgid "B<file or device> to B<file on the host>"
37600 #: ../src/guestfs.pod:353
37601 msgid "Use L</guestfs_download>. See L</DOWNLOADING> above."
37605 #: ../src/guestfs.pod:357
37606 msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS"
37610 #: ../src/guestfs.pod:359
37612 "Calls like L</guestfs_upload>, L</guestfs_download>, L</guestfs_tar_in>, L</"
37613 "guestfs_tar_out> etc appear to only take filenames as arguments, so it "
37614 "appears you can only upload and download to files. However many Un*x-like "
37615 "hosts let you use the special device files C</dev/stdin>, C</dev/stdout>, C</"
37616 "dev/stderr> and C</dev/fd/N> to read and write from stdin, stdout, stderr, "
37617 "and arbitrary file descriptor N."
37621 #: ../src/guestfs.pod:367
37622 msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:"
37626 #: ../src/guestfs.pod:370
37629 " guestfs_download (g, filename, \"/dev/stdout\");\n"
37632 " guestfs_download (g, filename, \"/dev/stdout\");\n"
37636 #: ../src/guestfs.pod:372
37637 msgid "and you can write tar output to a file descriptor C<fd> by doing:"
37641 #: ../src/guestfs.pod:374
37644 " char devfd[64];\n"
37645 " snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n"
37646 " guestfs_tar_out (g, \"/\", devfd);\n"
37649 " char devfd[64];\n"
37650 " snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n"
37651 " guestfs_tar_out (g, \"/\", devfd);\n"
37655 #: ../src/guestfs.pod:378
37656 msgid "LISTING FILES"
37657 msgstr "СПИСКИ ФАЙЛІВ"
37660 #: ../src/guestfs.pod:380
37662 "L</guestfs_ll> is just designed for humans to read (mainly when using the "
37663 "L<guestfish(1)>-equivalent command C<ll>)."
37667 #: ../src/guestfs.pod:383
37669 "L</guestfs_ls> is a quick way to get a list of files in a directory from "
37670 "programs, as a flat list of strings."
37674 #: ../src/guestfs.pod:386
37676 "L</guestfs_readdir> is a programmatic way to get a list of files in a "
37677 "directory, plus additional information about each one. It is more "
37678 "equivalent to using the L<readdir(3)> call on a local filesystem."
37682 #: ../src/guestfs.pod:390
37684 "L</guestfs_find> and L</guestfs_find0> can be used to recursively list files."
37688 #: ../src/guestfs.pod:393
37689 msgid "RUNNING COMMANDS"
37690 msgstr "ВИКОНАННЯ КОМАНД"
37693 #: ../src/guestfs.pod:395
37695 "Although libguestfs is primarily an API for manipulating files inside guest "
37696 "images, we also provide some limited facilities for running commands inside "
37701 #: ../src/guestfs.pod:399
37702 msgid "There are many limitations to this:"
37706 #: ../src/guestfs.pod:405
37708 "The kernel version that the command runs under will be different from what "
37713 #: ../src/guestfs.pod:410
37715 "If the command needs to communicate with daemons, then most likely they "
37716 "won't be running."
37720 #: ../src/guestfs.pod:415
37721 msgid "The command will be running in limited memory."
37725 #: ../src/guestfs.pod:419
37727 "The network may not be available unless you enable it (see L</"
37728 "guestfs_set_network>)."
37732 #: ../src/guestfs.pod:424
37733 msgid "Only supports Linux guests (not Windows, BSD, etc)."
37737 #: ../src/guestfs.pod:428
37739 "Architecture limitations (eg. won't work for a PPC guest on an X86 host)."
37743 #: ../src/guestfs.pod:433
37745 "For SELinux guests, you may need to enable SELinux and load policy first. "
37746 "See L</SELINUX> in this manpage."
37750 #: ../src/guestfs.pod:438
37752 "I<Security:> It is not safe to run commands from untrusted, possibly "
37753 "malicious guests. These commands may attempt to exploit your program by "
37754 "sending unexpected output. They could also try to exploit the Linux kernel "
37755 "or qemu provided by the libguestfs appliance. They could use the network "
37756 "provided by the libguestfs appliance to bypass ordinary network partitions "
37757 "and firewalls. They could use the elevated privileges or different SELinux "
37758 "context of your program to their advantage."
37762 #: ../src/guestfs.pod:447
37764 "A secure alternative is to use libguestfs to install a \"firstboot\" script "
37765 "(a script which runs when the guest next boots normally), and to have this "
37766 "script run the commands you want in the normal context of the running guest, "
37767 "network security and so on. For information about other security issues, "
37768 "see L</SECURITY>."
37772 #: ../src/guestfs.pod:455
37774 "The two main API calls to run commands are L</guestfs_command> and L</"
37775 "guestfs_sh> (there are also variations)."
37779 #: ../src/guestfs.pod:458
37781 "The difference is that L</guestfs_sh> runs commands using the shell, so any "
37782 "shell globs, redirections, etc will work."
37786 #: ../src/guestfs.pod:461
37787 msgid "CONFIGURATION FILES"
37788 msgstr "ФАЙЛИ НАЛАШТУВАННЯ"
37791 #: ../src/guestfs.pod:463
37793 "To read and write configuration files in Linux guest filesystems, we "
37794 "strongly recommend using Augeas. For example, Augeas understands how to "
37795 "read and write, say, a Linux shadow password file or X.org configuration "
37796 "file, and so avoids you having to write that code."
37800 #: ../src/guestfs.pod:468
37802 "The main Augeas calls are bound through the C<guestfs_aug_*> APIs. We don't "
37803 "document Augeas itself here because there is excellent documentation on the "
37804 "L<http://augeas.net/> website."
37808 #: ../src/guestfs.pod:472
37810 "If you don't want to use Augeas (you fool!) then try calling L</"
37811 "guestfs_read_lines> to get the file as a list of lines which you can iterate "
37816 #: ../src/guestfs.pod:476
37821 #: ../src/guestfs.pod:478
37823 "We support SELinux guests. To ensure that labeling happens correctly in "
37824 "SELinux guests, you need to enable SELinux and load the guest's policy:"
37828 #: ../src/guestfs.pod:486
37829 msgid "Before launching, do:"
37833 #: ../src/guestfs.pod:488
37836 " guestfs_set_selinux (g, 1);\n"
37839 " guestfs_set_selinux (g, 1);\n"
37843 #: ../src/guestfs.pod:492
37845 "After mounting the guest's filesystem(s), load the policy. This is best "
37846 "done by running the L<load_policy(8)> command in the guest itself:"
37850 #: ../src/guestfs.pod:496
37853 " guestfs_sh (g, \"/usr/sbin/load_policy\");\n"
37856 " guestfs_sh (g, \"/usr/sbin/load_policy\");\n"
37860 #: ../src/guestfs.pod:498
37862 "(Older versions of C<load_policy> require you to specify the name of the "
37867 #: ../src/guestfs.pod:503
37869 "Optionally, set the security context for the API. The correct security "
37870 "context to use can only be known by inspecting the guest. As an example:"
37874 #: ../src/guestfs.pod:507
37877 " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n"
37880 " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n"
37884 #: ../src/guestfs.pod:511
37885 msgid "This will work for running commands and editing existing files."
37889 #: ../src/guestfs.pod:513
37891 "When new files are created, you may need to label them explicitly, for "
37892 "example by running the external command C<restorecon pathname>."
37896 #: ../src/guestfs.pod:517
37901 #: ../src/guestfs.pod:519
37903 "Certain calls are affected by the current file mode creation mask (the "
37904 "\"umask\"). In particular ones which create files or directories, such as "
37905 "L</guestfs_touch>, L</guestfs_mknod> or L</guestfs_mkdir>. This affects "
37906 "either the default mode that the file is created with or modifies the mode "
37911 #: ../src/guestfs.pod:525
37913 "The default umask is C<022>, so files are created with modes such as C<0644> "
37914 "and directories with C<0755>."
37918 #: ../src/guestfs.pod:528
37920 "There are two ways to avoid being affected by umask. Either set umask to 0 "
37921 "(call C<guestfs_umask (g, 0)> early after launching). Or call L</"
37922 "guestfs_chmod> after creating each file or directory."
37926 #: ../src/guestfs.pod:532
37927 msgid "For more information about umask, see L<umask(2)>."
37931 #: ../src/guestfs.pod:536
37933 "Libguestfs allows you to access Linux guests which have been encrypted using "
37934 "whole disk encryption that conforms to the Linux Unified Key Setup (LUKS) "
37935 "standard. This includes nearly all whole disk encryption systems used by "
37936 "modern Linux guests."
37940 #: ../src/guestfs.pod:542
37942 "Use L</guestfs_vfs_type> to identify LUKS-encrypted block devices (it "
37943 "returns the string C<crypto_LUKS>)."
37947 #: ../src/guestfs.pod:545
37949 "Then open these devices by calling L</guestfs_luks_open>. Obviously you "
37950 "will require the passphrase!"
37954 #: ../src/guestfs.pod:548
37956 "Opening a LUKS device creates a new device mapper device called C</dev/"
37957 "mapper/mapname> (where C<mapname> is the string you supply to L</"
37958 "guestfs_luks_open>). Reads and writes to this mapper device are decrypted "
37959 "from and encrypted to the underlying block device respectively."
37963 #: ../src/guestfs.pod:554
37965 "LVM volume groups on the device can be made visible by calling L</"
37966 "guestfs_vgscan> followed by L</guestfs_vg_activate_all>. The logical volume"
37967 "(s) can now be mounted in the usual way."
37971 #: ../src/guestfs.pod:558
37973 "Use the reverse process to close a LUKS device. Unmount any logical volumes "
37974 "on it, deactivate the volume groups by caling C<guestfs_vg_activate (g, 0, "
37975 "[\"/dev/VG\"])>. Then close the mapper device by calling L</"
37976 "guestfs_luks_close> on the C</dev/mapper/mapname> device (I<not> the "
37977 "underlying encrypted block device)."
37981 #: ../src/guestfs.pod:565
37986 #: ../src/guestfs.pod:567
37988 "Libguestfs has APIs for inspecting an unknown disk image to find out if it "
37989 "contains operating systems, an install CD or a live CD. (These APIs used to "
37990 "be in a separate Perl-only library called L<Sys::Guestfs::Lib(3)> but since "
37991 "version 1.5.3 the most frequently used part of this library has been "
37992 "rewritten in C and moved into the core code)."
37996 #: ../src/guestfs.pod:574
37998 "Add all disks belonging to the unknown virtual machine and call L</"
37999 "guestfs_launch> in the usual way."
38003 #: ../src/guestfs.pod:577
38005 "Then call L</guestfs_inspect_os>. This function uses other libguestfs calls "
38006 "and certain heuristics, and returns a list of operating systems that were "
38007 "found. An empty list means none were found. A single element is the root "
38008 "filesystem of the operating system. For dual- or multi-boot guests, "
38009 "multiple roots can be returned, each one corresponding to a separate "
38010 "operating system. (Multi-boot virtual machines are extremely rare in the "
38011 "world of virtualization, but since this scenario can happen, we have built "
38012 "libguestfs to deal with it.)"
38016 #: ../src/guestfs.pod:586
38018 "For each root, you can then call various C<guestfs_inspect_get_*> functions "
38019 "to get additional details about that operating system. For example, call L</"
38020 "guestfs_inspect_get_type> to return the string C<windows> or C<linux> for "
38021 "Windows and Linux-based operating systems respectively."
38025 #: ../src/guestfs.pod:592
38027 "Un*x-like and Linux-based operating systems usually consist of several "
38028 "filesystems which are mounted at boot time (for example, a separate boot "
38029 "partition mounted on C</boot>). The inspection rules are able to detect how "
38030 "filesystems correspond to mount points. Call "
38031 "C<guestfs_inspect_get_mountpoints> to get this mapping. It might return a "
38032 "hash table like this example:"
38036 #: ../src/guestfs.pod:599
38039 " /boot => /dev/sda1\n"
38040 " / => /dev/vg_guest/lv_root\n"
38041 " /usr => /dev/vg_guest/lv_usr\n"
38044 " /boot => /dev/sda1\n"
38045 " / => /dev/vg_guest/lv_root\n"
38046 " /usr => /dev/vg_guest/lv_usr\n"
38050 #: ../src/guestfs.pod:603
38052 "The caller can then make calls to L</guestfs_mount_options> to mount the "
38053 "filesystems as suggested."
38057 #: ../src/guestfs.pod:606
38059 "Be careful to mount filesystems in the right order (eg. C</> before C</"
38060 "usr>). Sorting the keys of the hash by length, shortest first, should work."
38064 #: ../src/guestfs.pod:610
38066 "Inspection currently only works for some common operating systems. "
38067 "Contributors are welcome to send patches for other operating systems that we "
38068 "currently cannot detect."
38072 #: ../src/guestfs.pod:614
38074 "Encrypted disks must be opened before inspection. See L</ENCRYPTED DISKS> "
38075 "for more details. The L</guestfs_inspect_os> function just ignores any "
38076 "encrypted devices."
38080 #: ../src/guestfs.pod:618
38082 "A note on the implementation: The call L</guestfs_inspect_os> performs "
38083 "inspection and caches the results in the guest handle. Subsequent calls to "
38084 "C<guestfs_inspect_get_*> return this cached information, but I<do not> re-"
38085 "read the disks. If you change the content of the guest disks, you can redo "
38086 "inspection by calling L</guestfs_inspect_os> again. (L</"
38087 "guestfs_inspect_list_applications> works a little differently from the other "
38088 "calls and does read the disks. See documentation for that function for "
38093 #: ../src/guestfs.pod:627
38094 msgid "INSPECTING INSTALL DISKS"
38098 #: ../src/guestfs.pod:629
38100 "Libguestfs (since 1.9.4) can detect some install disks, install CDs, live "
38105 #: ../src/guestfs.pod:632
38107 "Call L</guestfs_inspect_get_format> to return the format of the operating "
38108 "system, which currently can be C<installed> (a regular operating system) or "
38109 "C<installer> (some sort of install disk)."
38113 #: ../src/guestfs.pod:636
38115 "Further information is available about the operating system that can be "
38116 "installed using the regular inspection APIs like L</"
38117 "guestfs_inspect_get_product_name>, L</guestfs_inspect_get_major_version> etc."
38121 #: ../src/guestfs.pod:641
38123 "Some additional information specific to installer disks is also available "
38124 "from the L</guestfs_inspect_is_live>, L</guestfs_inspect_is_netinst> and L</"
38125 "guestfs_inspect_is_multipart> calls."
38129 #: ../src/guestfs.pod:646
38130 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS"
38134 #: ../src/guestfs.pod:648
38136 "Libguestfs can mount NTFS partitions. It does this using the L<http://www."
38137 "ntfs-3g.org/> driver."
38141 #: ../src/guestfs.pod:651
38142 msgid "DRIVE LETTERS AND PATHS"
38143 msgstr "ЛІТЕРИ ДИСКІВ ТА ШЛЯХИ"
38146 #: ../src/guestfs.pod:653
38148 "DOS and Windows still use drive letters, and the filesystems are always "
38149 "treated as case insensitive by Windows itself, and therefore you might find "
38150 "a Windows configuration file referring to a path like C<c:\\windows"
38151 "\\system32>. When the filesystem is mounted in libguestfs, that directory "
38152 "might be referred to as C</WINDOWS/System32>."
38156 #: ../src/guestfs.pod:659
38158 "Drive letter mappings can be found using inspection (see L</INSPECTION> and "
38159 "L</guestfs_inspect_get_drive_mappings>)"
38163 #: ../src/guestfs.pod:662
38165 "Dealing with separator characters (backslash vs forward slash) is outside "
38166 "the scope of libguestfs, but usually a simple character replacement will "
38171 #: ../src/guestfs.pod:666
38173 "To resolve the case insensitivity of paths, call L</"
38174 "guestfs_case_sensitive_path>."
38178 #: ../src/guestfs.pod:669
38179 msgid "ACCESSING THE WINDOWS REGISTRY"
38180 msgstr "ДОСТУП ДО РЕГІСТРУ WINDOWS"
38183 #: ../src/guestfs.pod:671
38185 "Libguestfs also provides some help for decoding Windows Registry \"hive\" "
38186 "files, through the library C<hivex> which is part of the libguestfs project "
38187 "although ships as a separate tarball. You have to locate and download the "
38188 "hive file(s) yourself, and then pass them to C<hivex> functions. See also "
38189 "the programs L<hivexml(1)>, L<hivexsh(1)>, L<hivexregedit(1)> and L<virt-win-"
38190 "reg(1)> for more help on this issue."
38194 #: ../src/guestfs.pod:679
38195 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS"
38196 msgstr "СИМВОЛІЧНІ ПОСИЛАННЯ У ФАЙЛОВИХ СИСТЕМАХ NTFS-3G"
38199 #: ../src/guestfs.pod:681
38201 "Ntfs-3g tries to rewrite \"Junction Points\" and NTFS \"symbolic links\" to "
38202 "provide something which looks like a Linux symlink. The way it tries to do "
38203 "the rewriting is described here:"
38207 #: ../src/guestfs.pod:685
38209 "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-"
38212 "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-"
38216 #: ../src/guestfs.pod:687
38218 "The essential problem is that ntfs-3g simply does not have enough "
38219 "information to do a correct job. NTFS links can contain drive letters and "
38220 "references to external device GUIDs that ntfs-3g has no way of resolving. "
38221 "It is almost certainly the case that libguestfs callers should ignore what "
38222 "ntfs-3g does (ie. don't use L</guestfs_readlink> on NTFS volumes)."
38226 #: ../src/guestfs.pod:694
38228 "Instead if you encounter a symbolic link on an ntfs-3g filesystem, use L</"
38229 "guestfs_lgetxattr> to read the C<system.ntfs_reparse_data> extended "
38230 "attribute, and read the raw reparse data from that (you can find the format "
38231 "documented in various places around the web)."
38235 #: ../src/guestfs.pod:699
38236 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS"
38240 #: ../src/guestfs.pod:701
38242 "There are other useful extended attributes that can be read from ntfs-3g "
38243 "filesystems (using L</guestfs_getxattr>). See:"
38247 #: ../src/guestfs.pod:704
38249 "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
38251 "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
38254 #: ../src/guestfs.pod:706
38255 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES"
38256 msgstr "ВИКОРИСТАННЯ LIBGUESTFS ЗА ДОПОМОГОЮ ІНШИХ МОВ ПРОГРАМУВАННЯ"
38259 #: ../src/guestfs.pod:708
38261 "Although we don't want to discourage you from using the C API, we will "
38262 "mention here that the same API is also available in other languages."
38266 #: ../src/guestfs.pod:711
38268 "The API is broadly identical in all supported languages. This means that "
38269 "the C call C<guestfs_add_drive_ro(g,file)> is C<$g-E<gt>add_drive_ro($file)> "
38270 "in Perl, C<g.add_drive_ro(file)> in Python, and C<g#add_drive_ro file> in "
38271 "OCaml. In other words, a straightforward, predictable isomorphism between "
38276 #: ../src/guestfs.pod:717
38278 "Error messages are automatically transformed into exceptions if the language "
38283 #: ../src/guestfs.pod:720
38285 "We don't try to \"object orientify\" parts of the API in OO languages, "
38286 "although contributors are welcome to write higher level APIs above what we "
38287 "provide in their favourite languages if they wish."
38291 #: ../src/guestfs.pod:726
38296 #: ../src/guestfs.pod:728
38298 "You can use the I<guestfs.h> header file from C++ programs. The C++ API is "
38299 "identical to the C API. C++ classes and exceptions are not used."
38303 #: ../src/guestfs.pod:732
38308 #: ../src/guestfs.pod:734
38310 "The C# bindings are highly experimental. Please read the warnings at the "
38311 "top of C<csharp/Libguestfs.cs>."
38315 #: ../src/guestfs.pod:737
38320 #: ../src/guestfs.pod:739
38321 msgid "See L<guestfs-erlang(3)>."
38325 #: ../src/guestfs.pod:741
38327 msgstr "B<Haskell>"
38330 #: ../src/guestfs.pod:743
38332 "This is the only language binding that is working but incomplete. Only "
38333 "calls which return simple integers have been bound in Haskell, and we are "
38334 "looking for help to complete this binding."
38338 #: ../src/guestfs.pod:747
38343 #: ../src/guestfs.pod:749
38345 "Full documentation is contained in the Javadoc which is distributed with "
38346 "libguestfs. For examples, see L<guestfs-java(3)>."
38350 #: ../src/guestfs.pod:752
38355 #: ../src/guestfs.pod:754
38356 msgid "See L<guestfs-ocaml(3)>."
38357 msgstr "Див. L<guestfs-ocaml(3)>."
38360 #: ../src/guestfs.pod:756
38365 #: ../src/guestfs.pod:758
38366 msgid "See L<guestfs-perl(3)> and L<Sys::Guestfs(3)>."
38367 msgstr "Див. L<guestfs-perl(3)> та L<Sys::Guestfs(3)>."
38370 #: ../src/guestfs.pod:760
38375 #: ../src/guestfs.pod:762
38377 "For documentation see C<README-PHP> supplied with libguestfs sources or in "
38378 "the php-libguestfs package for your distribution."
38382 #: ../src/guestfs.pod:765
38383 msgid "The PHP binding only works correctly on 64 bit machines."
38387 #: ../src/guestfs.pod:767
38392 #: ../src/guestfs.pod:769
38393 msgid "See L<guestfs-python(3)>."
38394 msgstr "Див. L<guestfs-python(3)>."
38397 #: ../src/guestfs.pod:771
38402 #: ../src/guestfs.pod:773
38403 msgid "See L<guestfs-ruby(3)>."
38404 msgstr "Див. L<guestfs-ruby(3)>."
38407 #: ../src/guestfs.pod:775
38408 msgid "B<shell scripts>"
38409 msgstr "B<скрипти оболонки>"
38412 #: ../src/guestfs.pod:777
38413 msgid "See L<guestfish(1)>."
38414 msgstr "Див. L<guestfish(1)>."
38417 #: ../src/guestfs.pod:781
38418 msgid "LIBGUESTFS GOTCHAS"
38422 #: ../src/guestfs.pod:783
38424 "L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a "
38425 "system [...] that works in the way it is documented but is counterintuitive "
38426 "and almost invites mistakes.\""
38430 #: ../src/guestfs.pod:787
38432 "Since we developed libguestfs and the associated tools, there are several "
38433 "things we would have designed differently, but are now stuck with for "
38434 "backwards compatibility or other reasons. If there is ever a libguestfs 2.0 "
38435 "release, you can expect these to change. Beware of them."
38439 #: ../src/guestfs.pod:795
38440 msgid "Autosync / forgetting to sync."
38444 #: ../src/guestfs.pod:797
38446 "I<Update:> Autosync is enabled by default for all API users starting from "
38447 "libguestfs 1.5.24. This section only applies to older versions."
38451 #: ../src/guestfs.pod:800
38453 "When modifying a filesystem from C or another language, you B<must> unmount "
38454 "all filesystems and call L</guestfs_sync> explicitly before you close the "
38455 "libguestfs handle. You can also call:"
38459 #: ../src/guestfs.pod:804
38462 " guestfs_set_autosync (g, 1);\n"
38465 " guestfs_set_autosync (g, 1);\n"
38469 #: ../src/guestfs.pod:806
38471 "to have the unmount/sync done automatically for you when the handle 'g' is "
38472 "closed. (This feature is called \"autosync\", L</guestfs_set_autosync> q.v.)"
38476 #: ../src/guestfs.pod:810
38478 "If you forget to do this, then it is entirely possible that your changes "
38479 "won't be written out, or will be partially written, or (very rarely) that "
38480 "you'll get disk corruption."
38484 #: ../src/guestfs.pod:814
38486 "Note that in L<guestfish(3)> autosync is the default. So quick and dirty "
38487 "guestfish scripts that forget to sync will work just fine, which can make "
38488 "this very puzzling if you are trying to debug a problem."
38492 #: ../src/guestfs.pod:818
38493 msgid "Mount option C<-o sync> should not be the default."
38497 #: ../src/guestfs.pod:820
38499 "I<Update:> L</guestfs_mount> no longer adds any options starting from "
38500 "libguestfs 1.13.16. This section only applies to older versions."
38504 #: ../src/guestfs.pod:823
38506 "If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly. "
38507 "However C<-o sync> does not add any reliability benefit, but does have a "
38508 "very large performance impact."
38512 #: ../src/guestfs.pod:827
38514 "The work around is to use L</guestfs_mount_options> and set the mount "
38515 "options that you actually want to use."
38519 #: ../src/guestfs.pod:830
38520 msgid "Read-only should be the default."
38524 #: ../src/guestfs.pod:832
38526 "In L<guestfish(3)>, I<--ro> should be the default, and you should have to "
38527 "specify I<--rw> if you want to make changes to the image."
38531 #: ../src/guestfs.pod:835
38532 msgid "This would reduce the potential to corrupt live VM images."
38536 #: ../src/guestfs.pod:837
38538 "Note that many filesystems change the disk when you just mount and unmount, "
38539 "even if you didn't perform any writes. You need to use L</"
38540 "guestfs_add_drive_ro> to guarantee that the disk is not changed."
38544 #: ../src/guestfs.pod:841
38545 msgid "guestfish command line is hard to use."
38549 #: ../src/guestfs.pod:843
38551 "C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for "
38552 "examination). It tries to run a guestfish command C<disk.img> which doesn't "
38553 "exist, so it fails. In earlier versions of guestfish the error message was "
38554 "also unintuitive, but we have corrected this since. Like the Bourne shell, "
38555 "we should have used C<guestfish -c command> to run commands."
38559 #: ../src/guestfs.pod:850
38560 msgid "guestfish megabyte modifiers don't work right on all commands"
38564 #: ../src/guestfs.pod:852
38566 "In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for "
38567 "other modifiers). What guestfish actually does is to multiply the number "
38568 "part by the modifier part and pass the result to the C API. However this "
38569 "doesn't work for a few APIs which aren't expecting bytes, but are already "
38570 "expecting some other unit (eg. megabytes)."
38574 #: ../src/guestfs.pod:859
38575 msgid "The most common is L</guestfs_lvcreate>. The guestfish command:"
38579 #: ../src/guestfs.pod:861
38582 " lvcreate LV VG 100M\n"
38585 " lvcreate LV VG 100M\n"
38589 #: ../src/guestfs.pod:863
38591 "does not do what you might expect. Instead because L</guestfs_lvcreate> is "
38592 "already expecting megabytes, this tries to create a 100 I<terabyte> (100 "
38593 "megabytes * megabytes) logical volume. The error message you get from this "
38594 "is also a little obscure."
38598 #: ../src/guestfs.pod:868
38600 "This could be fixed in the generator by specially marking parameters and "
38601 "return values which take bytes or other units."
38605 #: ../src/guestfs.pod:871
38606 msgid "Ambiguity between devices and paths"
38610 #: ../src/guestfs.pod:873
38612 "There is a subtle ambiguity in the API between a device name (eg. C</dev/"
38613 "sdb2>) and a similar pathname. A file might just happen to be called "
38614 "C<sdb2> in the directory C</dev> (consider some non-Unix VM image)."
38618 #: ../src/guestfs.pod:878
38620 "In the current API we usually resolve this ambiguity by having two separate "
38621 "calls, for example L</guestfs_checksum> and L</guestfs_checksum_device>. "
38622 "Some API calls are ambiguous and (incorrectly) resolve the problem by "
38623 "detecting if the path supplied begins with C</dev/>."
38627 #: ../src/guestfs.pod:884
38629 "To avoid both the ambiguity and the need to duplicate some calls, we could "
38630 "make paths/devices into structured names. One way to do this would be to "
38631 "use a notation like grub (C<hd(0,0)>), although nobody really likes this "
38632 "aspect of grub. Another way would be to use a structured type, equivalent "
38633 "to this OCaml type:"
38637 #: ../src/guestfs.pod:890
38640 " type path = Path of string | Device of int | Partition of int * int\n"
38645 #: ../src/guestfs.pod:892
38646 msgid "which would allow you to pass arguments like:"
38650 #: ../src/guestfs.pod:894
38653 " Path \"/foo/bar\"\n"
38654 " Device 1 (* /dev/sdb, or perhaps /dev/sda *)\n"
38655 " Partition (1, 2) (* /dev/sdb2 (or is it /dev/sda2 or /dev/sdb3?) *)\n"
38656 " Path \"/dev/sdb2\" (* not a device *)\n"
38661 #: ../src/guestfs.pod:899
38663 "As you can see there are still problems to resolve even with this "
38664 "representation. Also consider how it might work in guestfish."
38668 #: ../src/guestfs.pod:904
38669 msgid "KEYS AND PASSPHRASES"
38670 msgstr "КЛЮЧІ І ПАРОЛІ"
38673 #: ../src/guestfs.pod:906
38675 "Certain libguestfs calls take a parameter that contains sensitive key "
38676 "material, passed in as a C string."
38680 #: ../src/guestfs.pod:909
38682 "In the future we would hope to change the libguestfs implementation so that "
38683 "keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in "
38684 "swap. However this is I<not> done at the moment, because of the complexity "
38685 "of such an implementation."
38689 #: ../src/guestfs.pod:914
38691 "Therefore you should be aware that any key parameter you pass to libguestfs "
38692 "might end up being written out to the swap partition. If this is a concern, "
38693 "scrub the swap partition or don't use libguestfs on encrypted devices."
38697 #: ../src/guestfs.pod:919
38698 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS"
38702 #: ../src/guestfs.pod:921
38704 "All high-level libguestfs actions are synchronous. If you want to use "
38705 "libguestfs asynchronously then you must create a thread."
38709 #: ../src/guestfs.pod:924
38711 "Only use the handle from a single thread. Either use the handle exclusively "
38712 "from one thread, or provide your own mutex so that two threads cannot issue "
38713 "calls on the same handle at the same time."
38717 #: ../src/guestfs.pod:928
38719 "See the graphical program guestfs-browser for one possible architecture for "
38720 "multithreaded programs using libvirt and libguestfs."
38724 #: ../src/guestfs.pod:931
38729 #: ../src/guestfs.pod:933
38731 "Libguestfs needs a supermin appliance, which it finds by looking along an "
38736 #: ../src/guestfs.pod:936
38738 "By default it looks for these in the directory C<$libdir/guestfs> (eg. C</"
38739 "usr/local/lib/guestfs> or C</usr/lib64/guestfs>)."
38743 #: ../src/guestfs.pod:939
38745 "Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> "
38746 "to change the directories that libguestfs will search in. The value is a "
38747 "colon-separated list of paths. The current directory is I<not> searched "
38748 "unless the path contains an empty element or C<.>. For example "
38749 "C<LIBGUESTFS_PATH=:/usr/lib/guestfs> would search the current directory and "
38750 "then C</usr/lib/guestfs>."
38754 #: ../src/guestfs.pod:946
38755 msgid "QEMU WRAPPERS"
38759 #: ../src/guestfs.pod:948
38761 "If you want to compile your own qemu, run qemu from a non-standard location, "
38762 "or pass extra arguments to qemu, then you can write a shell-script wrapper "
38767 #: ../src/guestfs.pod:952
38769 "There is one important rule to remember: you I<must C<exec qemu>> as the "
38770 "last command in the shell script (so that qemu replaces the shell and "
38771 "becomes the direct child of the libguestfs-using program). If you don't do "
38772 "this, then the qemu process won't be cleaned up correctly."
38776 #: ../src/guestfs.pod:957
38778 "Here is an example of a wrapper, where I have built my own copy of qemu from "
38783 #: ../src/guestfs.pod:960
38787 " qemudir=/home/rjones/d/qemu\n"
38788 " exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios \"$@\"\n"
38792 " qemudir=/home/rjones/d/qemu\n"
38793 " exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios \"$@\"\n"
38797 #: ../src/guestfs.pod:964
38799 "Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and "
38800 "then use it by setting the LIBGUESTFS_QEMU environment variable. For "
38805 #: ../src/guestfs.pod:968
38808 " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
38811 " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
38815 #: ../src/guestfs.pod:970
38817 "Note that libguestfs also calls qemu with the -help and -version options in "
38818 "order to determine features."
38822 #: ../src/guestfs.pod:973
38824 "Wrappers can also be used to edit the options passed to qemu. In the "
38825 "following example, the C<-machine ...> option (C<-machine> and the following "
38826 "argument) are removed from the command line and replaced with C<-machine pc,"
38827 "accel=tcg>. The while loop iterates over the options until it finds the "
38828 "right one to remove, putting the remaining options into the C<args> array."
38832 #: ../src/guestfs.pod:982
38836 " while [ $# -gt 0 ]; do\n"
38837 " case \"$1\" in\n"
38841 " args[i]=\"$1\"\n"
38850 #: ../src/guestfs.pod:994
38853 " exec qemu-kvm -machine pc,accel=tcg \"${args[@]}\"\n"
38858 #: ../src/guestfs.pod:996
38859 msgid "ATTACHING TO RUNNING DAEMONS"
38860 msgstr "ДОЛУЧЕННЯ ДО ЗАПУЩЕНИХ ФОНОВИХ СЛУЖБ"
38863 #: ../src/guestfs.pod:998
38865 "I<Note (1):> This is B<highly experimental> and has a tendency to eat "
38866 "babies. Use with caution."
38870 #: ../src/guestfs.pod:1001
38872 "I<Note (2):> This section explains how to attach to a running daemon from a "
38873 "low level perspective. For most users, simply using virt tools such as "
38874 "L<guestfish(1)> with the I<--live> option will \"just work\"."
38878 #: ../src/guestfs.pod:1005
38879 msgid "Using guestfs_set_attach_method"
38880 msgstr "За допомогою guestfs_set_attach_method"
38883 #: ../src/guestfs.pod:1007
38885 "By calling L</guestfs_set_attach_method> you can change how the library "
38886 "connects to the C<guestfsd> daemon in L</guestfs_launch> (read L</"
38887 "ARCHITECTURE> for some background)."
38891 #: ../src/guestfs.pod:1011
38893 "The normal attach method is C<appliance>, where a small appliance is created "
38894 "containing the daemon, and then the library connects to this."
38898 #: ../src/guestfs.pod:1014
38900 "Setting attach method to C<unix:I<path>> (where I<path> is the path of a "
38901 "Unix domain socket) causes L</guestfs_launch> to connect to an existing "
38902 "daemon over the Unix domain socket."
38906 #: ../src/guestfs.pod:1018
38908 "The normal use for this is to connect to a running virtual machine that "
38909 "contains a C<guestfsd> daemon, and send commands so you can read and write "
38910 "files inside the live virtual machine."
38914 #: ../src/guestfs.pod:1022
38915 msgid "Using guestfs_add_domain with live flag"
38916 msgstr "За допомогою guestfs_add_domain з прапорцем live"
38919 #: ../src/guestfs.pod:1024
38921 "L</guestfs_add_domain> provides some help for getting the correct attach "
38922 "method. If you pass the C<live> option to this function, then (if the "
38923 "virtual machine is running) it will examine the libvirt XML looking for a "
38924 "virtio-serial channel to connect to:"
38928 #: ../src/guestfs.pod:1030
38935 " <channel type='unix'>\n"
38936 " <source mode='bind' path='/path/to/socket'/>\n"
38937 " <target type='virtio' name='org.libguestfs.channel.0'/>\n"
38948 " <channel type='unix'>\n"
38949 " <source mode='bind' path='/path/to/socket'/>\n"
38950 " <target type='virtio' name='org.libguestfs.channel.0'/>\n"
38958 #: ../src/guestfs.pod:1042
38960 "L</guestfs_add_domain> extracts C</path/to/socket> and sets the attach "
38961 "method to C<unix:/path/to/socket>."
38965 #: ../src/guestfs.pod:1045
38967 "Some of the libguestfs tools (including guestfish) support a I<--live> "
38968 "option which is passed through to L</guestfs_add_domain> thus allowing you "
38969 "to attach to and modify live virtual machines."
38973 #: ../src/guestfs.pod:1049
38975 "The virtual machine needs to have been set up beforehand so that it has the "
38976 "virtio-serial channel and so that guestfsd is running inside it."
38980 #: ../src/guestfs.pod:1053
38981 msgid "ABI GUARANTEE"
38982 msgstr "ГАРАНТІЯ ЩОДО ABI"
38985 #: ../src/guestfs.pod:1055
38987 "We guarantee the libguestfs ABI (binary interface), for public, high-level "
38988 "actions as outlined in this section. Although we will deprecate some "
38989 "actions, for example if they get replaced by newer calls, we will keep the "
38990 "old actions forever. This allows you the developer to program in confidence "
38991 "against the libguestfs API."
38995 #: ../src/guestfs.pod:1061
38996 msgid "BLOCK DEVICE NAMING"
38997 msgstr "ІМЕНУВАННЯ БЛОКОВИХ ПРИСТРОЇВ"
39000 #: ../src/guestfs.pod:1063
39002 "In the kernel there is now quite a profusion of schemata for naming block "
39003 "devices (in this context, by I<block device> I mean a physical or virtual "
39004 "hard drive). The original Linux IDE driver used names starting with C</dev/"
39005 "hd*>. SCSI devices have historically used a different naming scheme, C</dev/"
39006 "sd*>. When the Linux kernel I<libata> driver became a popular replacement "
39007 "for the old IDE driver (particularly for SATA devices) those devices also "
39008 "used the C</dev/sd*> scheme. Additionally we now have virtual machines with "
39009 "paravirtualized drivers. This has created several different naming systems, "
39010 "such as C</dev/vd*> for virtio disks and C</dev/xvd*> for Xen PV disks."
39014 #: ../src/guestfs.pod:1075
39016 "As discussed above, libguestfs uses a qemu appliance running an embedded "
39017 "Linux kernel to access block devices. We can run a variety of appliances "
39018 "based on a variety of Linux kernels."
39022 #: ../src/guestfs.pod:1079
39024 "This causes a problem for libguestfs because many API calls use device or "
39025 "partition names. Working scripts and the recipe (example) scripts that we "
39026 "make available over the internet could fail if the naming scheme changes."
39030 #: ../src/guestfs.pod:1084
39032 "Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>. "
39033 "Internally C</dev/sd*> names are translated, if necessary, to other names as "
39034 "required. For example, under RHEL 5 which uses the C</dev/hd*> scheme, any "
39035 "device parameter C</dev/sda2> is translated to C</dev/hda2> transparently."
39039 #: ../src/guestfs.pod:1090
39041 "Note that this I<only> applies to parameters. The L</guestfs_list_devices>, "
39042 "L</guestfs_list_partitions> and similar calls return the true names of the "
39043 "devices and partitions as known to the appliance."
39047 #: ../src/guestfs.pod:1095
39048 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION"
39052 #: ../src/guestfs.pod:1097
39054 "Usually this translation is transparent. However in some (very rare) cases "
39055 "you may need to know the exact algorithm. Such cases include where you use "
39056 "L</guestfs_config> to add a mixture of virtio and IDE devices to the qemu-"
39057 "based appliance, so have a mixture of C</dev/sd*> and C</dev/vd*> devices."
39061 #: ../src/guestfs.pod:1103
39063 "The algorithm is applied only to I<parameters> which are known to be either "
39064 "device or partition names. Return values from functions such as L</"
39065 "guestfs_list_devices> are never changed."
39069 #: ../src/guestfs.pod:1111
39070 msgid "Is the string a parameter which is a device or partition name?"
39074 #: ../src/guestfs.pod:1115
39075 msgid "Does the string begin with C</dev/sd>?"
39076 msgstr "Чи починається рядок з C</dev/sd>?"
39079 #: ../src/guestfs.pod:1119
39081 "Does the named device exist? If so, we use that device. However if I<not> "
39082 "then we continue with this algorithm."
39086 #: ../src/guestfs.pod:1124
39087 msgid "Replace initial C</dev/sd> string with C</dev/hd>."
39091 #: ../src/guestfs.pod:1126
39092 msgid "For example, change C</dev/sda2> to C</dev/hda2>."
39096 #: ../src/guestfs.pod:1128
39097 msgid "If that named device exists, use it. If not, continue."
39101 #: ../src/guestfs.pod:1132
39102 msgid "Replace initial C</dev/sd> string with C</dev/vd>."
39106 #: ../src/guestfs.pod:1134
39107 msgid "If that named device exists, use it. If not, return an error."
39111 #: ../src/guestfs.pod:1138
39112 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING"
39116 #: ../src/guestfs.pod:1140
39118 "Although the standard naming scheme and automatic translation is useful for "
39119 "simple programs and guestfish scripts, for larger programs it is best not to "
39120 "rely on this mechanism."
39124 #: ../src/guestfs.pod:1144
39126 "Where possible for maximum future portability programs using libguestfs "
39127 "should use these future-proof techniques:"
39131 #: ../src/guestfs.pod:1151
39133 "Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual "
39134 "device names, and then use those names directly."
39138 #: ../src/guestfs.pod:1154
39140 "Since those device names exist by definition, they will never be translated."
39144 #: ../src/guestfs.pod:1159
39146 "Use higher level ways to identify filesystems, such as LVM names, UUIDs and "
39147 "filesystem labels."
39151 #: ../src/guestfs.pod:1166
39153 "This section discusses security implications of using libguestfs, "
39154 "particularly with untrusted or malicious guests or disk images."
39158 #: ../src/guestfs.pod:1169
39159 msgid "GENERAL SECURITY CONSIDERATIONS"
39160 msgstr "ЗАГАЛЬНІ ЗАУВАЖЕННЯ ЩОДО ЗАХИСТУ"
39163 #: ../src/guestfs.pod:1171
39165 "Be careful with any files or data that you download from a guest (by "
39166 "\"download\" we mean not just the L</guestfs_download> command but any "
39167 "command that reads files, filenames, directories or anything else from a "
39168 "disk image). An attacker could manipulate the data to fool your program "
39169 "into doing the wrong thing. Consider cases such as:"
39173 #: ../src/guestfs.pod:1181
39174 msgid "the data (file etc) not being present"
39178 #: ../src/guestfs.pod:1185
39179 msgid "being present but empty"
39183 #: ../src/guestfs.pod:1189
39184 msgid "being much larger than normal"
39188 #: ../src/guestfs.pod:1193
39189 msgid "containing arbitrary 8 bit data"
39193 #: ../src/guestfs.pod:1197
39194 msgid "being in an unexpected character encoding"
39198 #: ../src/guestfs.pod:1201
39199 msgid "containing homoglyphs."
39203 #: ../src/guestfs.pod:1205
39204 msgid "SECURITY OF MOUNTING FILESYSTEMS"
39205 msgstr "ЗАХИСТ ФАЙЛОВИХ СИСТЕМ МОНТУВАННЯ"
39208 #: ../src/guestfs.pod:1207
39210 "When you mount a filesystem under Linux, mistakes in the kernel filesystem "
39211 "(VFS) module can sometimes be escalated into exploits by deliberately "
39212 "creating a malicious, malformed filesystem. These exploits are very severe "
39213 "for two reasons. Firstly there are very many filesystem drivers in the "
39214 "kernel, and many of them are infrequently used and not much developer "
39215 "attention has been paid to the code. Linux userspace helps potential "
39216 "crackers by detecting the filesystem type and automatically choosing the "
39217 "right VFS driver, even if that filesystem type is obscure or unexpected for "
39218 "the administrator. Secondly, a kernel-level exploit is like a local root "
39219 "exploit (worse in some ways), giving immediate and total access to the "
39220 "system right down to the hardware level."
39224 #: ../src/guestfs.pod:1220
39226 "That explains why you should never mount a filesystem from an untrusted "
39227 "guest on your host kernel. How about libguestfs? We run a Linux kernel "
39228 "inside a qemu virtual machine, usually running as a non-root user. The "
39229 "attacker would need to write a filesystem which first exploited the kernel, "
39230 "and then exploited either qemu virtualization (eg. a faulty qemu driver) or "
39231 "the libguestfs protocol, and finally to be as serious as the host kernel "
39232 "exploit it would need to escalate its privileges to root. This multi-step "
39233 "escalation, performed by a static piece of data, is thought to be extremely "
39234 "hard to do, although we never say 'never' about security issues."
39238 #: ../src/guestfs.pod:1231
39240 "In any case callers can reduce the attack surface by forcing the filesystem "
39241 "type when mounting (use L</guestfs_mount_vfs>)."
39245 #: ../src/guestfs.pod:1234
39246 msgid "PROTOCOL SECURITY"
39247 msgstr "ЗАХИСТ ПРОТОКОЛУ"
39250 #: ../src/guestfs.pod:1236
39252 "The protocol is designed to be secure, being based on RFC 4506 (XDR) with a "
39253 "defined upper message size. However a program that uses libguestfs must "
39254 "also take care - for example you can write a program that downloads a binary "
39255 "from a disk image and executes it locally, and no amount of protocol "
39256 "security will save you from the consequences."
39260 #: ../src/guestfs.pod:1242
39261 msgid "INSPECTION SECURITY"
39265 #: ../src/guestfs.pod:1244
39267 "Parts of the inspection API (see L</INSPECTION>) return untrusted strings "
39268 "directly from the guest, and these could contain any 8 bit data. Callers "
39269 "should be careful to escape these before printing them to a structured file "
39270 "(for example, use HTML escaping if creating a web page)."
39274 #: ../src/guestfs.pod:1250
39276 "Guest configuration may be altered in unusual ways by the administrator of "
39277 "the virtual machine, and may not reflect reality (particularly for untrusted "
39278 "or actively malicious guests). For example we parse the hostname from "
39279 "configuration files like C</etc/sysconfig/network> that we find in the "
39280 "guest, but the guest administrator can easily manipulate these files to "
39281 "provide the wrong hostname."
39285 #: ../src/guestfs.pod:1258
39287 "The inspection API parses guest configuration using two external libraries: "
39288 "Augeas (Linux configuration) and hivex (Windows Registry). Both are "
39289 "designed to be robust in the face of malicious data, although denial of "
39290 "service attacks are still possible, for example with oversized configuration "
39295 #: ../src/guestfs.pod:1264
39296 msgid "RUNNING UNTRUSTED GUEST COMMANDS"
39297 msgstr "ЗАПУСК НЕЗАХИЩЕНИХ КОМАНД ГОСТЬОВОЇ СИСТЕМИ"
39300 #: ../src/guestfs.pod:1266
39302 "Be very cautious about running commands from the guest. By running a "
39303 "command in the guest, you are giving CPU time to a binary that you do not "
39304 "control, under the same user account as the library, albeit wrapped in qemu "
39305 "virtualization. More information and alternatives can be found in the "
39306 "section L</RUNNING COMMANDS>."
39310 #: ../src/guestfs.pod:1272
39311 msgid "CVE-2010-3851"
39312 msgstr "CVE-2010-3851"
39315 #: ../src/guestfs.pod:1274
39316 msgid "https://bugzilla.redhat.com/642934"
39317 msgstr "https://bugzilla.redhat.com/642934"
39320 #: ../src/guestfs.pod:1276
39322 "This security bug concerns the automatic disk format detection that qemu "
39323 "does on disk images."
39327 #: ../src/guestfs.pod:1279
39329 "A raw disk image is just the raw bytes, there is no header. Other disk "
39330 "images like qcow2 contain a special header. Qemu deals with this by looking "
39331 "for one of the known headers, and if none is found then assuming the disk "
39332 "image must be raw."
39336 #: ../src/guestfs.pod:1284
39338 "This allows a guest which has been given a raw disk image to write some "
39339 "other header. At next boot (or when the disk image is accessed by "
39340 "libguestfs) qemu would do autodetection and think the disk image format was, "
39341 "say, qcow2 based on the header written by the guest."
39345 #: ../src/guestfs.pod:1289
39347 "This in itself would not be a problem, but qcow2 offers many features, one "
39348 "of which is to allow a disk image to refer to another image (called the "
39349 "\"backing disk\"). It does this by placing the path to the backing disk "
39350 "into the qcow2 header. This path is not validated and could point to any "
39351 "host file (eg. \"/etc/passwd\"). The backing disk is then exposed through "
39352 "\"holes\" in the qcow2 disk image, which of course is completely under the "
39353 "control of the attacker."
39357 #: ../src/guestfs.pod:1297
39359 "In libguestfs this is rather hard to exploit except under two circumstances:"
39363 #: ../src/guestfs.pod:1304
39364 msgid "You have enabled the network or have opened the disk in write mode."
39368 #: ../src/guestfs.pod:1308
39370 "You are also running untrusted code from the guest (see L</RUNNING "
39375 #: ../src/guestfs.pod:1313
39377 "The way to avoid this is to specify the expected disk format when adding "
39378 "disks (the optional C<format> option to L</guestfs_add_drive_opts>). You "
39379 "should always do this if the disk is raw format, and it's a good idea for "
39384 #: ../src/guestfs.pod:1318
39386 "For disks added from libvirt using calls like L</guestfs_add_domain>, the "
39387 "format is fetched from libvirt and passed through."
39391 #: ../src/guestfs.pod:1321
39393 "For libguestfs tools, use the I<--format> command line parameter as "
39398 #: ../src/guestfs.pod:1324
39399 msgid "CONNECTION MANAGEMENT"
39400 msgstr "КЕРУВАННЯ З’ЄДНАННЯМ"
39403 #: ../src/guestfs.pod:1326
39404 msgid "guestfs_h *"
39405 msgstr "guestfs_h *"
39408 #: ../src/guestfs.pod:1328
39410 "C<guestfs_h> is the opaque type representing a connection handle. Create a "
39411 "handle by calling L</guestfs_create>. Call L</guestfs_close> to free the "
39412 "handle and release all resources used."
39416 #: ../src/guestfs.pod:1332
39418 "For information on using multiple handles and threads, see the section L</"
39419 "MULTIPLE HANDLES AND MULTIPLE THREADS> above."
39423 #: ../src/guestfs.pod:1335
39424 msgid "guestfs_create"
39425 msgstr "guestfs_create"
39428 #: ../src/guestfs.pod:1337
39431 " guestfs_h *guestfs_create (void);\n"
39434 " guestfs_h *guestfs_create (void);\n"
39438 #: ../src/guestfs.pod:1339
39439 msgid "Create a connection handle."
39440 msgstr "Створити дескриптор з’єднання."
39443 #: ../src/guestfs.pod:1341
39445 "On success this returns a non-NULL pointer to a handle. On error it returns "
39450 #: ../src/guestfs.pod:1344
39452 "You have to \"configure\" the handle after creating it. This includes "
39453 "calling L</guestfs_add_drive_opts> (or one of the equivalent calls) on the "
39454 "handle at least once."
39458 #: ../src/guestfs.pod:1348
39459 msgid "After configuring the handle, you have to call L</guestfs_launch>."
39463 #: ../src/guestfs.pod:1350
39465 "You may also want to configure error handling for the handle. See the L</"
39466 "ERROR HANDLING> section below."
39470 #: ../src/guestfs.pod:1353
39471 msgid "guestfs_close"
39472 msgstr "guestfs_close"
39475 #: ../src/guestfs.pod:1355
39478 " void guestfs_close (guestfs_h *g);\n"
39481 " void guestfs_close (guestfs_h *g);\n"
39485 #: ../src/guestfs.pod:1357
39486 msgid "This closes the connection handle and frees up all resources used."
39490 #: ../src/guestfs.pod:1359
39492 "If autosync was set on the handle and the handle was launched, then this "
39493 "implicitly calls various functions to unmount filesystems and sync the "
39494 "disk. See L</guestfs_set_autosync> for more details."
39498 #: ../src/guestfs.pod:1363
39499 msgid "If a close callback was set on the handle, then it is called."
39503 #: ../src/guestfs.pod:1365
39504 msgid "ERROR HANDLING"
39505 msgstr "ОБРОБКА ПОМИЛОК"
39508 #: ../src/guestfs.pod:1367
39510 "API functions can return errors. For example, almost all functions that "
39511 "return C<int> will return C<-1> to indicate an error."
39515 #: ../src/guestfs.pod:1370
39517 "Additional information is available for errors: an error message string and "
39518 "optionally an error number (errno) if the thing that failed was a system "
39523 #: ../src/guestfs.pod:1374
39525 "You can get at the additional information about the last error on the handle "
39526 "by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting "
39527 "up an error handler with L</guestfs_set_error_handler>."
39531 #: ../src/guestfs.pod:1379
39533 "When the handle is created, a default error handler is installed which "
39534 "prints the error message string to C<stderr>. For small short-running "
39535 "command line programs it is sufficient to do:"
39539 #: ../src/guestfs.pod:1383
39542 " if (guestfs_launch (g) == -1)\n"
39543 " exit (EXIT_FAILURE);\n"
39546 " if (guestfs_launch (g) == -1)\n"
39547 " exit (EXIT_FAILURE);\n"
39551 #: ../src/guestfs.pod:1386
39553 "since the default error handler will ensure that an error message has been "
39554 "printed to C<stderr> before the program exits."
39558 #: ../src/guestfs.pod:1389
39560 "For other programs the caller will almost certainly want to install an "
39561 "alternate error handler or do error handling in-line like this:"
39565 #: ../src/guestfs.pod:1392
39568 " /* This disables the default behaviour of printing errors\n"
39570 " guestfs_set_error_handler (g, NULL, NULL);\n"
39575 #: ../src/guestfs.pod:1396
39578 " if (guestfs_launch (g) == -1) {\n"
39579 " /* Examine the error message and print it etc. */\n"
39580 " char *msg = guestfs_last_error (g);\n"
39581 " int errnum = guestfs_last_errno (g);\n"
39582 " fprintf (stderr, \"%s\", msg);\n"
39583 " if (errnum != 0)\n"
39584 " fprintf (stderr, \": %s\", strerror (errnum));\n"
39585 " fprintf (stderr, \"\\n\");\n"
39592 #: ../src/guestfs.pod:1407
39594 "Out of memory errors are handled differently. The default action is to call "
39595 "L<abort(3)>. If this is undesirable, then you can set a handler using L</"
39596 "guestfs_set_out_of_memory_handler>."
39600 #: ../src/guestfs.pod:1411
39602 "L</guestfs_create> returns C<NULL> if the handle cannot be created, and "
39603 "because there is no handle if this happens there is no way to get additional "
39604 "error information. However L</guestfs_create> is supposed to be a "
39605 "lightweight operation which can only fail because of insufficient memory (it "
39606 "returns NULL in this case)."
39610 #: ../src/guestfs.pod:1417
39611 msgid "guestfs_last_error"
39612 msgstr "guestfs_last_error"
39615 #: ../src/guestfs.pod:1419
39618 " const char *guestfs_last_error (guestfs_h *g);\n"
39621 " const char *guestfs_last_error (guestfs_h *g);\n"
39625 #: ../src/guestfs.pod:1421
39627 "This returns the last error message that happened on C<g>. If there has not "
39628 "been an error since the handle was created, then this returns C<NULL>."
39632 #: ../src/guestfs.pod:1425
39634 "The lifetime of the returned string is until the next error occurs, or L</"
39635 "guestfs_close> is called."
39639 #: ../src/guestfs.pod:1428
39640 msgid "guestfs_last_errno"
39641 msgstr "guestfs_last_errno"
39644 #: ../src/guestfs.pod:1430
39647 " int guestfs_last_errno (guestfs_h *g);\n"
39650 " int guestfs_last_errno (guestfs_h *g);\n"
39654 #: ../src/guestfs.pod:1432
39655 msgid "This returns the last error number (errno) that happened on C<g>."
39659 #: ../src/guestfs.pod:1434
39660 msgid "If successful, an errno integer not equal to zero is returned."
39664 #: ../src/guestfs.pod:1436
39666 "If no error, this returns 0. This call can return 0 in three situations:"
39670 #: ../src/guestfs.pod:1443
39671 msgid "There has not been any error on the handle."
39675 #: ../src/guestfs.pod:1447
39677 "There has been an error but the errno was meaningless. This corresponds to "
39678 "the case where the error did not come from a failed system call, but for "
39679 "some other reason."
39683 #: ../src/guestfs.pod:1453
39685 "There was an error from a failed system call, but for some reason the errno "
39686 "was not captured and returned. This usually indicates a bug in libguestfs."
39690 #: ../src/guestfs.pod:1459
39692 "Libguestfs tries to convert the errno from inside the applicance into a "
39693 "corresponding errno for the caller (not entirely trivial: the appliance "
39694 "might be running a completely different operating system from the library "
39695 "and error numbers are not standardized across Un*xen). If this could not be "
39696 "done, then the error is translated to C<EINVAL>. In practice this should "
39697 "only happen in very rare circumstances."
39701 #: ../src/guestfs.pod:1467
39702 msgid "guestfs_set_error_handler"
39703 msgstr "guestfs_set_error_handler"
39706 #: ../src/guestfs.pod:1469
39709 " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
39711 " const char *msg);\n"
39712 " void guestfs_set_error_handler (guestfs_h *g,\n"
39713 " guestfs_error_handler_cb cb,\n"
39714 " void *opaque);\n"
39717 " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
39719 " const char *msg);\n"
39720 " void guestfs_set_error_handler (guestfs_h *g,\n"
39721 " guestfs_error_handler_cb cb,\n"
39722 " void *opaque);\n"
39726 #: ../src/guestfs.pod:1476
39728 "The callback C<cb> will be called if there is an error. The parameters "
39729 "passed to the callback are an opaque data pointer and the error message "
39734 #: ../src/guestfs.pod:1480
39736 "C<errno> is not passed to the callback. To get that the callback must call "
39737 "L</guestfs_last_errno>."
39741 #: ../src/guestfs.pod:1483
39743 "Note that the message string C<msg> is freed as soon as the callback "
39744 "function returns, so if you want to stash it somewhere you must make your "
39749 #: ../src/guestfs.pod:1487
39750 msgid "The default handler prints messages on C<stderr>."
39754 #: ../src/guestfs.pod:1489
39755 msgid "If you set C<cb> to C<NULL> then I<no> handler is called."
39759 #: ../src/guestfs.pod:1491
39760 msgid "guestfs_get_error_handler"
39761 msgstr "guestfs_get_error_handler"
39764 #: ../src/guestfs.pod:1493
39767 " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
39768 " void **opaque_rtn);\n"
39771 " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
39772 " void **opaque_rtn);\n"
39776 #: ../src/guestfs.pod:1496
39777 msgid "Returns the current error handler callback."
39781 #: ../src/guestfs.pod:1498
39782 msgid "guestfs_set_out_of_memory_handler"
39783 msgstr "guestfs_set_out_of_memory_handler"
39786 #: ../src/guestfs.pod:1500
39789 " typedef void (*guestfs_abort_cb) (void);\n"
39790 " void guestfs_set_out_of_memory_handler (guestfs_h *g,\n"
39791 " guestfs_abort_cb);\n"
39796 #: ../src/guestfs.pod:1504
39798 "The callback C<cb> will be called if there is an out of memory situation. "
39799 "I<Note this callback must not return>."
39803 #: ../src/guestfs.pod:1507
39804 msgid "The default is to call L<abort(3)>."
39808 #: ../src/guestfs.pod:1509
39810 "You cannot set C<cb> to C<NULL>. You can't ignore out of memory situations."
39814 #: ../src/guestfs.pod:1512
39815 msgid "guestfs_get_out_of_memory_handler"
39816 msgstr "guestfs_get_out_of_memory_handler"
39819 #: ../src/guestfs.pod:1514
39822 " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
39825 " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
39829 #: ../src/guestfs.pod:1516
39830 msgid "This returns the current out of memory handler."
39834 #: ../src/guestfs.pod:1518
39836 msgstr "ВИКЛИКИ API"
39839 #: ../src/guestfs.pod:1522
39844 #: ../src/guestfs.pod:1524
39849 #: ../src/guestfs.pod:1526
39850 msgid "AVAILABILITY"
39851 msgstr "ДОСТУПНІСТЬ"
39854 #: ../src/guestfs.pod:1528
39855 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE"
39856 msgstr "ГРУПИ ФУНКЦІОНАЛЬНИХ МОЖЛИВОСТЕЙ У ОБРАЗІ ОСНОВНОЇ СИСТЕМИ"
39859 #: ../src/guestfs.pod:1530
39861 "Using L</guestfs_available> you can test availability of the following "
39862 "groups of functions. This test queries the appliance to see if the "
39863 "appliance you are currently using supports the functionality."
39867 #: ../src/guestfs.pod:1535
39868 msgid "@AVAILABILITY@"
39869 msgstr "@AVAILABILITY@"
39872 #: ../src/guestfs.pod:1537
39873 msgid "GUESTFISH supported COMMAND"
39877 #: ../src/guestfs.pod:1539
39879 "In L<guestfish(3)> there is a handy interactive command C<supported> which "
39880 "prints out the available groups and whether they are supported by this build "
39881 "of libguestfs. Note however that you have to do C<run> first."
39885 #: ../src/guestfs.pod:1544
39886 msgid "SINGLE CALLS AT COMPILE TIME"
39890 #: ../src/guestfs.pod:1546
39892 "Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API "
39893 "function, such as:"
39897 #: ../src/guestfs.pod:1549
39900 " #define LIBGUESTFS_HAVE_DD 1\n"
39903 " #define LIBGUESTFS_HAVE_DD 1\n"
39907 #: ../src/guestfs.pod:1551
39908 msgid "if L</guestfs_dd> is available."
39912 #: ../src/guestfs.pod:1553
39914 "Before version 1.5.8, if you needed to test whether a single libguestfs "
39915 "function is available at compile time, we recommended using build tools such "
39916 "as autoconf or cmake. For example in autotools you could use:"
39920 #: ../src/guestfs.pod:1558
39923 " AC_CHECK_LIB([guestfs],[guestfs_create])\n"
39924 " AC_CHECK_FUNCS([guestfs_dd])\n"
39927 " AC_CHECK_LIB([guestfs],[guestfs_create])\n"
39928 " AC_CHECK_FUNCS([guestfs_dd])\n"
39932 #: ../src/guestfs.pod:1561
39934 "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined "
39939 #: ../src/guestfs.pod:1564
39940 msgid "SINGLE CALLS AT RUN TIME"
39944 #: ../src/guestfs.pod:1566
39946 "Testing at compile time doesn't guarantee that a function really exists in "
39947 "the library. The reason is that you might be dynamically linked against a "
39948 "previous I<libguestfs.so> (dynamic library) which doesn't have the call. "
39949 "This situation unfortunately results in a segmentation fault, which is a "
39950 "shortcoming of the C dynamic linking system itself."
39954 #: ../src/guestfs.pod:1573
39956 "You can use L<dlopen(3)> to test if a function is available at run time, as "
39957 "in this example program (note that you still need the compile time check as "
39962 #: ../src/guestfs.pod:1577
39965 " #include <stdio.h>\n"
39966 " #include <stdlib.h>\n"
39967 " #include <unistd.h>\n"
39968 " #include <dlfcn.h>\n"
39969 " #include <guestfs.h>\n"
39972 " #include <stdio.h>\n"
39973 " #include <stdlib.h>\n"
39974 " #include <unistd.h>\n"
39975 " #include <dlfcn.h>\n"
39976 " #include <guestfs.h>\n"
39980 #: ../src/guestfs.pod:1583
39985 " #ifdef LIBGUESTFS_HAVE_DD\n"
39987 " int has_function;\n"
39992 " #ifdef LIBGUESTFS_HAVE_DD\n"
39994 " int has_function;\n"
39998 #: ../src/guestfs.pod:1589
40001 " /* Test if the function guestfs_dd is really available. */\n"
40002 " dl = dlopen (NULL, RTLD_LAZY);\n"
40004 " fprintf (stderr, \"dlopen: %s\\n\", dlerror ());\n"
40005 " exit (EXIT_FAILURE);\n"
40007 " has_function = dlsym (dl, \"guestfs_dd\") != NULL;\n"
40013 #: ../src/guestfs.pod:1598
40016 " if (!has_function)\n"
40017 " printf (\"this libguestfs.so does NOT have guestfs_dd function\\n\");\n"
40019 " printf (\"this libguestfs.so has guestfs_dd function\\n\");\n"
40020 " /* Now it's safe to call\n"
40021 " guestfs_dd (g, \"foo\", \"bar\");\n"
40025 " printf (\"guestfs_dd function was not found at compile time\\n\");\n"
40032 #: ../src/guestfs.pod:1611
40034 "You may think the above is an awful lot of hassle, and it is. There are "
40035 "other ways outside of the C linking system to ensure that this kind of "
40036 "incompatibility never arises, such as using package versioning:"
40040 #: ../src/guestfs.pod:1616
40043 " Requires: libguestfs >= 1.0.80\n"
40048 #: ../src/guestfs.pod:1618
40049 msgid "CALLS WITH OPTIONAL ARGUMENTS"
40053 #: ../src/guestfs.pod:1620
40055 "A recent feature of the API is the introduction of calls which take optional "
40056 "arguments. In C these are declared 3 ways. The main way is as a call which "
40057 "takes variable arguments (ie. C<...>), as in this example:"
40061 #: ../src/guestfs.pod:1625
40064 " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n"
40067 " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n"
40071 #: ../src/guestfs.pod:1627
40073 "Call this with a list of optional arguments, terminated by C<-1>. So to "
40074 "call with no optional arguments specified:"
40078 #: ../src/guestfs.pod:1630
40081 " guestfs_add_drive_opts (g, filename, -1);\n"
40084 " guestfs_add_drive_opts (g, filename, -1);\n"
40088 #: ../src/guestfs.pod:1632
40089 msgid "With a single optional argument:"
40093 #: ../src/guestfs.pod:1634
40096 " guestfs_add_drive_opts (g, filename,\n"
40097 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
40101 " guestfs_add_drive_opts (g, filename,\n"
40102 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
40107 #: ../src/guestfs.pod:1638
40112 #: ../src/guestfs.pod:1640
40115 " guestfs_add_drive_opts (g, filename,\n"
40116 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
40117 " GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
40121 " guestfs_add_drive_opts (g, filename,\n"
40122 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
40123 " GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
40128 #: ../src/guestfs.pod:1645
40130 "and so forth. Don't forget the terminating C<-1> otherwise Bad Things will "
40135 #: ../src/guestfs.pod:1648
40136 msgid "USING va_list FOR OPTIONAL ARGUMENTS"
40140 #: ../src/guestfs.pod:1650
40142 "The second variant has the same name with the suffix C<_va>, which works the "
40143 "same way but takes a C<va_list>. See the C manual for details. For the "
40144 "example function, this is declared:"
40148 #: ../src/guestfs.pod:1654
40151 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
40152 " va_list args);\n"
40155 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
40156 " va_list args);\n"
40160 #: ../src/guestfs.pod:1657
40161 msgid "CONSTRUCTING OPTIONAL ARGUMENTS"
40165 #: ../src/guestfs.pod:1659
40167 "The third variant is useful where you need to construct these calls. You "
40168 "pass in a structure where you fill in the optional fields. The structure "
40169 "has a bitmask as the first element which you must set to indicate which "
40170 "fields you have filled in. For our example function the structure and call "
40175 #: ../src/guestfs.pod:1665
40178 " struct guestfs_add_drive_opts_argv {\n"
40179 " uint64_t bitmask;\n"
40181 " const char *format;\n"
40184 " int guestfs_add_drive_opts_argv (guestfs_h *g, const char *filename,\n"
40185 " const struct guestfs_add_drive_opts_argv *optargs);\n"
40188 " struct guestfs_add_drive_opts_argv {\n"
40189 " uint64_t bitmask;\n"
40191 " const char *format;\n"
40194 " int guestfs_add_drive_opts_argv (guestfs_h *g, const char *filename,\n"
40195 " const struct guestfs_add_drive_opts_argv *optargs);\n"
40199 #: ../src/guestfs.pod:1674
40200 msgid "You could call it like this:"
40204 #: ../src/guestfs.pod:1676
40207 " struct guestfs_add_drive_opts_argv optargs = {\n"
40208 " .bitmask = GUESTFS_ADD_DRIVE_OPTS_READONLY_BITMASK |\n"
40209 " GUESTFS_ADD_DRIVE_OPTS_FORMAT_BITMASK,\n"
40210 " .readonly = 1,\n"
40211 " .format = \"qcow2\"\n"
40215 " struct guestfs_add_drive_opts_argv optargs = {\n"
40216 " .bitmask = GUESTFS_ADD_DRIVE_OPTS_READONLY_BITMASK |\n"
40217 " GUESTFS_ADD_DRIVE_OPTS_FORMAT_BITMASK,\n"
40218 " .readonly = 1,\n"
40219 " .format = \"qcow2\"\n"
40224 #: ../src/guestfs.pod:1683
40227 " guestfs_add_drive_opts_argv (g, filename, &optargs);\n"
40230 " guestfs_add_drive_opts_argv (g, filename, &optargs);\n"
40234 #: ../src/guestfs.pod:1691
40235 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask."
40239 #: ../src/guestfs.pod:1696
40240 msgid "You do not need to fill in all fields of the structure."
40244 #: ../src/guestfs.pod:1700
40246 "There must be a one-to-one correspondence between fields of the structure "
40247 "that are filled in, and bits set in the bitmask."
40251 #: ../src/guestfs.pod:1705
40252 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES"
40256 #: ../src/guestfs.pod:1707
40258 "In other languages, optional arguments are expressed in the way that is "
40259 "natural for that language. We refer you to the language-specific "
40260 "documentation for more details on that."
40264 #: ../src/guestfs.pod:1711
40265 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>."
40269 #: ../src/guestfs.pod:1713
40270 msgid "SETTING CALLBACKS TO HANDLE EVENTS"
40274 #: ../src/guestfs.pod:1715
40276 "B<Note:> This section documents the generic event mechanism introduced in "
40277 "libguestfs 1.10, which you should use in new code if possible. The old "
40278 "functions C<guestfs_set_log_message_callback>, "
40279 "C<guestfs_set_subprocess_quit_callback>, "
40280 "C<guestfs_set_launch_done_callback>, C<guestfs_set_close_callback> and "
40281 "C<guestfs_set_progress_callback> are no longer documented in this manual "
40282 "page. Because of the ABI guarantee, the old functions continue to work."
40286 #: ../src/guestfs.pod:1724
40288 "Handles generate events when certain things happen, such as log messages "
40289 "being generated, progress messages during long-running operations, or the "
40290 "handle being closed. The API calls described below let you register a "
40291 "callback to be called when events happen. You can register multiple "
40292 "callbacks (for the same, different or overlapping sets of events), and "
40293 "individually remove callbacks. If callbacks are not removed, then they "
40294 "remain in force until the handle is closed."
40298 #: ../src/guestfs.pod:1732
40300 "In the current implementation, events are only generated synchronously: that "
40301 "means that events (and hence callbacks) can only happen while you are in the "
40302 "middle of making another libguestfs call. The callback is called in the "
40307 #: ../src/guestfs.pod:1737
40309 "Events may contain a payload, usually nothing (void), an array of 64 bit "
40310 "unsigned integers, or a message buffer. Payloads are discussed later on."
40314 #: ../src/guestfs.pod:1741
40315 msgid "CLASSES OF EVENTS"
40319 #: ../src/guestfs.pod:1745
40320 msgid "GUESTFS_EVENT_CLOSE (payload type: void)"
40324 #: ../src/guestfs.pod:1748
40326 "The callback function will be called while the handle is being closed "
40327 "(synchronously from L</guestfs_close>)."
40331 #: ../src/guestfs.pod:1751
40333 "Note that libguestfs installs an L<atexit(3)> handler to try to clean up "
40334 "handles that are open when the program exits. This means that this callback "
40335 "might be called indirectly from L<exit(3)>, which can cause unexpected "
40336 "problems in higher-level languages (eg. if your HLL interpreter has already "
40337 "been cleaned up by the time this is called, and if your callback then jumps "
40338 "into some HLL function)."
40342 #: ../src/guestfs.pod:1758
40344 "If no callback is registered: the handle is closed without any callback "
40349 #: ../src/guestfs.pod:1761
40350 msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)"
40354 #: ../src/guestfs.pod:1764
40356 "The callback function will be called when the child process quits, either "
40357 "asynchronously or if killed by L</guestfs_kill_subprocess>. (This "
40358 "corresponds to a transition from any state to the CONFIG state)."
40362 #: ../src/guestfs.pod:1768 ../src/guestfs.pod:1777 ../src/guestfs.pod:1894
40363 msgid "If no callback is registered: the event is ignored."
40367 #: ../src/guestfs.pod:1770
40368 msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)"
40372 #: ../src/guestfs.pod:1773
40374 "The callback function will be called when the child process becomes ready "
40375 "first time after it has been launched. (This corresponds to a transition "
40376 "from LAUNCHING to the READY state)."
40380 #: ../src/guestfs.pod:1779
40381 msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)"
40385 #: ../src/guestfs.pod:1782
40387 "Some long-running operations can generate progress messages. If this "
40388 "callback is registered, then it will be called each time a progress message "
40389 "is generated (usually two seconds after the operation started, and three "
40390 "times per second thereafter until it completes, although the frequency may "
40391 "change in future versions)."
40395 #: ../src/guestfs.pod:1788
40397 "The callback receives in the payload four unsigned 64 bit numbers which are "
40398 "(in order): C<proc_nr>, C<serial>, C<position>, C<total>."
40402 #: ../src/guestfs.pod:1791
40404 "The units of C<total> are not defined, although for some operations C<total> "
40405 "may relate in some way to the amount of data to be transferred (eg. in bytes "
40406 "or megabytes), and C<position> may be the portion which has been transferred."
40410 #: ../src/guestfs.pod:1796
40411 msgid "The only defined and stable parts of the API are:"
40415 #: ../src/guestfs.pod:1802
40417 "The callback can display to the user some type of progress bar or indicator "
40418 "which shows the ratio of C<position>:C<total>."
40422 #: ../src/guestfs.pod:1807
40423 msgid "0 E<lt>= C<position> E<lt>= C<total>"
40427 #: ../src/guestfs.pod:1811
40429 "If any progress notification is sent during a call, then a final progress "
40430 "notification is always sent when C<position> = C<total> (I<unless> the call "
40431 "fails with an error)."
40435 #: ../src/guestfs.pod:1815
40437 "This is to simplify caller code, so callers can easily set the progress "
40438 "indicator to \"100%\" at the end of the operation, without requiring special "
40439 "code to detect this case."
40443 #: ../src/guestfs.pod:1821
40445 "For some calls we are unable to estimate the progress of the call, but we "
40446 "can still generate progress messages to indicate activity. This is known as "
40447 "\"pulse mode\", and is directly supported by certain progress bar "
40448 "implementations (eg. GtkProgressBar)."
40452 #: ../src/guestfs.pod:1826
40454 "For these calls, zero or more progress messages are generated with "
40455 "C<position = 0> and C<total = 1>, followed by a final message with "
40456 "C<position = total = 1>."
40460 #: ../src/guestfs.pod:1830
40462 "As noted above, if the call fails with an error then the final message may "
40463 "not be generated."
40467 #: ../src/guestfs.pod:1835
40469 "The callback also receives the procedure number (C<proc_nr>) and serial "
40470 "number (C<serial>) of the call. These are only useful for debugging "
40471 "protocol issues, and the callback can normally ignore them. The callback "
40472 "may want to print these numbers in error messages or debugging messages."
40476 #: ../src/guestfs.pod:1841
40477 msgid "If no callback is registered: progress messages are discarded."
40481 #: ../src/guestfs.pod:1843
40482 msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)"
40486 #: ../src/guestfs.pod:1846
40488 "The callback function is called whenever a log message is generated by qemu, "
40489 "the appliance kernel, guestfsd (daemon), or utility programs."
40493 #: ../src/guestfs.pod:1849
40495 "If the verbose flag (L</guestfs_set_verbose>) is set before launch (L</"
40496 "guestfs_launch>) then additional debug messages are generated."
40500 #: ../src/guestfs.pod:1852 ../src/guestfs.pod:1866
40502 "If no callback is registered: the messages are discarded unless the verbose "
40503 "flag is set in which case they are sent to stderr. You can override the "
40504 "printing of verbose messages to stderr by setting up a callback."
40508 #: ../src/guestfs.pod:1857
40509 msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)"
40513 #: ../src/guestfs.pod:1860
40515 "The callback function is called whenever a log message is generated by the "
40516 "library part of libguestfs."
40520 #: ../src/guestfs.pod:1863
40522 "If the verbose flag (L</guestfs_set_verbose>) is set then additional debug "
40523 "messages are generated."
40527 #: ../src/guestfs.pod:1871
40528 msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)"
40532 #: ../src/guestfs.pod:1874
40534 "The callback function is called whenever a trace message is generated. This "
40535 "only applies if the trace flag (L</guestfs_set_trace>) is set."
40539 #: ../src/guestfs.pod:1877
40541 "If no callback is registered: the messages are sent to stderr. You can "
40542 "override the printing of trace messages to stderr by setting up a callback."
40546 #: ../src/guestfs.pod:1881
40547 msgid "GUESTFS_EVENT_ENTER (payload type: function name)"
40551 #: ../src/guestfs.pod:1884
40553 "The callback function is called whenever a libguestfs function is entered."
40557 #: ../src/guestfs.pod:1887
40559 "The payload is a string which contains the name of the function that we are "
40560 "entering (not including C<guestfs_> prefix)."
40564 #: ../src/guestfs.pod:1890
40566 "Note that libguestfs functions can call themselves, so you may see many "
40567 "events from a single call. A few libguestfs functions do not generate this "
40572 #: ../src/guestfs.pod:1898
40573 msgid "guestfs_set_event_callback"
40577 #: ../src/guestfs.pod:1900
40580 " int guestfs_set_event_callback (guestfs_h *g,\n"
40581 " guestfs_event_callback cb,\n"
40582 " uint64_t event_bitmask,\n"
40584 " void *opaque);\n"
40589 #: ../src/guestfs.pod:1906
40591 "This function registers a callback (C<cb>) for all event classes in the "
40592 "C<event_bitmask>."
40596 #: ../src/guestfs.pod:1909
40598 "For example, to register for all log message events, you could call this "
40599 "function with the bitmask C<GUESTFS_EVENT_APPLIANCE|GUESTFS_EVENT_LIBRARY>. "
40600 "To register a single callback for all possible classes of events, use "
40601 "C<GUESTFS_EVENT_ALL>."
40605 #: ../src/guestfs.pod:1915
40606 msgid "C<flags> should always be passed as 0."
40610 #: ../src/guestfs.pod:1917
40612 "C<opaque> is an opaque pointer which is passed to the callback. You can use "
40613 "it for any purpose."
40617 #: ../src/guestfs.pod:1920
40619 "The return value is the event handle (an integer) which you can use to "
40620 "delete the callback (see below)."
40624 #: ../src/guestfs.pod:1923
40626 "If there is an error, this function returns C<-1>, and sets the error in the "
40627 "handle in the usual way (see L</guestfs_last_error> etc.)"
40631 #: ../src/guestfs.pod:1926
40633 "Callbacks remain in effect until they are deleted, or until the handle is "
40638 #: ../src/guestfs.pod:1929
40640 "In the case where multiple callbacks are registered for a particular event "
40641 "class, all of the callbacks are called. The order in which multiple "
40642 "callbacks are called is not defined."
40646 #: ../src/guestfs.pod:1933
40647 msgid "guestfs_delete_event_callback"
40651 #: ../src/guestfs.pod:1935
40654 " void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n"
40659 #: ../src/guestfs.pod:1937
40661 "Delete a callback that was previously registered. C<event_handle> should be "
40662 "the integer that was returned by a previous call to "
40663 "C<guestfs_set_event_callback> on the same handle."
40667 #: ../src/guestfs.pod:1941
40668 msgid "guestfs_event_callback"
40672 #: ../src/guestfs.pod:1943
40675 " typedef void (*guestfs_event_callback) (\n"
40678 " uint64_t event,\n"
40679 " int event_handle,\n"
40681 " const char *buf, size_t buf_len,\n"
40682 " const uint64_t *array, size_t array_len);\n"
40687 #: ../src/guestfs.pod:1952
40689 "This is the type of the event callback function that you have to provide."
40693 #: ../src/guestfs.pod:1955
40695 "The basic parameters are: the handle (C<g>), the opaque user pointer "
40696 "(C<opaque>), the event class (eg. C<GUESTFS_EVENT_PROGRESS>), the event "
40697 "handle, and C<flags> which in the current API you should ignore."
40701 #: ../src/guestfs.pod:1959
40703 "The remaining parameters contain the event payload (if any). Each event may "
40704 "contain a payload, which usually relates to the event class, but for future "
40705 "proofing your code should be written to handle any payload for any event "
40710 #: ../src/guestfs.pod:1964
40712 "C<buf> and C<buf_len> contain a message buffer (if C<buf_len == 0>, then "
40713 "there is no message buffer). Note that this message buffer can contain "
40714 "arbitrary 8 bit data, including NUL bytes."
40718 #: ../src/guestfs.pod:1968
40720 "C<array> and C<array_len> is an array of 64 bit unsigned integers. At the "
40721 "moment this is only used for progress messages."
40725 #: ../src/guestfs.pod:1971
40726 msgid "EXAMPLE: CAPTURING LOG MESSAGES"
40730 #: ../src/guestfs.pod:1973
40732 "One motivation for the generic event API was to allow GUI programs to "
40733 "capture debug and other messages. In libguestfs E<le> 1.8 these were sent "
40734 "unconditionally to C<stderr>."
40738 #: ../src/guestfs.pod:1977
40740 "Events associated with log messages are: C<GUESTFS_EVENT_LIBRARY>, "
40741 "C<GUESTFS_EVENT_APPLIANCE> and C<GUESTFS_EVENT_TRACE>. (Note that error "
40742 "messages are not events; you must capture error messages separately)."
40746 #: ../src/guestfs.pod:1982
40748 "Programs have to set up a callback to capture the classes of events of "
40753 #: ../src/guestfs.pod:1985
40757 " guestfs_set_event_callback\n"
40758 " (g, message_callback,\n"
40759 " GUESTFS_EVENT_LIBRARY|GUESTFS_EVENT_APPLIANCE|\n"
40760 " GUESTFS_EVENT_TRACE,\n"
40761 " 0, NULL) == -1)\n"
40762 " if (eh == -1) {\n"
40763 " // handle error in the usual way\n"
40769 #: ../src/guestfs.pod:1995
40771 "The callback can then direct messages to the appropriate place. In this "
40772 "example, messages are directed to syslog:"
40776 #: ../src/guestfs.pod:1998
40780 " message_callback (\n"
40783 " uint64_t event,\n"
40784 " int event_handle,\n"
40786 " const char *buf, size_t buf_len,\n"
40787 " const uint64_t *array, size_t array_len)\n"
40789 " const int priority = LOG_USER|LOG_INFO;\n"
40790 " if (buf_len > 0)\n"
40791 " syslog (priority, \"event 0x%lx: %s\", event, buf);\n"
40797 #: ../src/guestfs.pod:2013
40798 msgid "CANCELLING LONG TRANSFERS"
40802 #: ../src/guestfs.pod:2015
40804 "Some operations can be cancelled by the caller while they are in progress. "
40805 "Currently only operations that involve uploading or downloading data can be "
40806 "cancelled (technically: operations that have C<FileIn> or C<FileOut> "
40807 "parameters in the generator)."
40811 #: ../src/guestfs.pod:2020
40812 msgid "guestfs_user_cancel"
40816 #: ../src/guestfs.pod:2022
40819 " void guestfs_user_cancel (guestfs_h *g);\n"
40824 #: ../src/guestfs.pod:2024
40826 "C<guestfs_user_cancel> cancels the current upload or download operation."
40830 #: ../src/guestfs.pod:2027
40832 "Unlike most other libguestfs calls, this function is signal safe and thread "
40833 "safe. You can call it from a signal handler or from another thread, without "
40834 "needing to do any locking."
40838 #: ../src/guestfs.pod:2031
40840 "The transfer that was in progress (if there is one) will stop shortly "
40841 "afterwards, and will return an error. The errno (see L</"
40842 "guestfs_last_errno>) is set to C<EINTR>, so you can test for this to find "
40843 "out if the operation was cancelled or failed because of another error."
40847 #: ../src/guestfs.pod:2037
40849 "No cleanup is performed: for example, if a file was being uploaded then "
40850 "after cancellation there may be a partially uploaded file. It is the "
40851 "caller's responsibility to clean up if necessary."
40855 #: ../src/guestfs.pod:2041
40856 msgid "There are two common places that you might call C<guestfs_user_cancel>."
40860 #: ../src/guestfs.pod:2043
40862 "In an interactive text-based program, you might call it from a C<SIGINT> "
40863 "signal handler so that pressing C<^C> cancels the current operation. (You "
40864 "also need to call L</guestfs_set_pgroup> so that child processes don't "
40865 "receive the C<^C> signal)."
40869 #: ../src/guestfs.pod:2048
40871 "In a graphical program, when the main thread is displaying a progress bar "
40872 "with a cancel button, wire up the cancel button to call this function."
40876 #: ../src/guestfs.pod:2052
40877 msgid "PRIVATE DATA AREA"
40881 #: ../src/guestfs.pod:2054
40883 "You can attach named pieces of private data to the libguestfs handle, fetch "
40884 "them by name, and walk over them, for the lifetime of the handle. This is "
40885 "called the private data area and is only available from the C API."
40889 #: ../src/guestfs.pod:2059
40890 msgid "To attach a named piece of data, use the following call:"
40894 #: ../src/guestfs.pod:2061
40897 " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
40900 " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
40904 #: ../src/guestfs.pod:2063
40906 "C<key> is the name to associate with this data, and C<data> is an arbitrary "
40907 "pointer (which can be C<NULL>). Any previous item with the same key is "
40912 #: ../src/guestfs.pod:2067
40914 "You can use any C<key> you want, but your key should I<not> start with an "
40915 "underscore character. Keys beginning with an underscore character are "
40916 "reserved for internal libguestfs purposes (eg. for implementing language "
40917 "bindings). It is recommended that you prefix the key with some unique "
40918 "string to avoid collisions with other users."
40922 #: ../src/guestfs.pod:2073
40923 msgid "To retrieve the pointer, use:"
40927 #: ../src/guestfs.pod:2075
40930 " void *guestfs_get_private (guestfs_h *g, const char *key);\n"
40933 " void *guestfs_get_private (guestfs_h *g, const char *key);\n"
40937 #: ../src/guestfs.pod:2077
40939 "This function returns C<NULL> if either no data is found associated with "
40940 "C<key>, or if the user previously set the C<key>'s C<data> pointer to "
40945 #: ../src/guestfs.pod:2081
40947 "Libguestfs does not try to look at or interpret the C<data> pointer in any "
40948 "way. As far as libguestfs is concerned, it need not be a valid pointer at "
40949 "all. In particular, libguestfs does I<not> try to free the data when the "
40950 "handle is closed. If the data must be freed, then the caller must either "
40951 "free it before calling L</guestfs_close> or must set up a close callback to "
40952 "do it (see L</GUESTFS_EVENT_CLOSE>)."
40956 #: ../src/guestfs.pod:2088
40957 msgid "To walk over all entries, use these two functions:"
40961 #: ../src/guestfs.pod:2090
40964 " void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n"
40969 #: ../src/guestfs.pod:2092
40972 " void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n"
40977 #: ../src/guestfs.pod:2094
40979 "C<guestfs_first_private> returns the first key, pointer pair (\"first\" does "
40980 "not have any particular meaning -- keys are not returned in any defined "
40981 "order). A pointer to the key is returned in C<*key_rtn> and the "
40982 "corresponding data pointer is returned from the function. C<NULL> is "
40983 "returned if there are no keys stored in the handle."
40987 #: ../src/guestfs.pod:2100
40989 "C<guestfs_next_private> returns the next key, pointer pair. The return "
40990 "value of this function is also C<NULL> is there are no further entries to "
40995 #: ../src/guestfs.pod:2104
40996 msgid "Notes about walking over entries:"
41000 #: ../src/guestfs.pod:2110
41002 "You must not call C<guestfs_set_private> while walking over the entries."
41006 #: ../src/guestfs.pod:2115
41008 "The handle maintains an internal iterator which is reset when you call "
41009 "C<guestfs_first_private>. This internal iterator is invalidated when you "
41010 "call C<guestfs_set_private>."
41014 #: ../src/guestfs.pod:2121
41015 msgid "If you have set the data pointer associated with a key to C<NULL>, ie:"
41019 #: ../src/guestfs.pod:2123
41022 " guestfs_set_private (g, key, NULL);\n"
41027 #: ../src/guestfs.pod:2125
41028 msgid "then that C<key> is not returned when walking."
41032 #: ../src/guestfs.pod:2129
41034 "C<*key_rtn> is only valid until the next call to C<guestfs_first_private>, "
41035 "C<guestfs_next_private> or C<guestfs_set_private>."
41039 #: ../src/guestfs.pod:2135
41041 "The following example code shows how to print all keys and data pointers "
41042 "that are associated with the handle C<g>:"
41046 #: ../src/guestfs.pod:2138
41049 " const char *key;\n"
41050 " void *data = guestfs_first_private (g, &key);\n"
41051 " while (data != NULL)\n"
41053 " printf (\"key = %s, data = %p\\n\", key, data);\n"
41054 " data = guestfs_next_private (g, &key);\n"
41060 #: ../src/guestfs.pod:2146
41062 "More commonly you are only interested in keys that begin with an application-"
41063 "specific prefix C<foo_>. Modify the loop like so:"
41067 #: ../src/guestfs.pod:2149
41070 " const char *key;\n"
41071 " void *data = guestfs_first_private (g, &key);\n"
41072 " while (data != NULL)\n"
41074 " if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
41075 " printf (\"key = %s, data = %p\\n\", key, data);\n"
41076 " data = guestfs_next_private (g, &key);\n"
41082 #: ../src/guestfs.pod:2158
41084 "If you need to modify keys while walking, then you have to jump back to the "
41085 "beginning of the loop. For example, to delete all keys prefixed with "
41090 #: ../src/guestfs.pod:2162
41093 " const char *key;\n"
41096 " data = guestfs_first_private (g, &key);\n"
41097 " while (data != NULL)\n"
41099 " if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
41101 " guestfs_set_private (g, key, NULL);\n"
41102 " /* note that 'key' pointer is now invalid, and so is\n"
41103 " the internal iterator */\n"
41106 " data = guestfs_next_private (g, &key);\n"
41112 #: ../src/guestfs.pod:2178
41114 "Note that the above loop is guaranteed to terminate because the keys are "
41115 "being deleted, but other manipulations of keys within the loop might not "
41116 "terminate unless you also maintain an indication of which keys have been "
41121 #: ../src/guestfs.pod:2183
41126 #: ../src/guestfs.pod:2185
41128 "The libguestfs C library can be probed using systemtap or DTrace. This is "
41129 "true of any library, not just libguestfs. However libguestfs also contains "
41130 "static markers to help in probing internal operations."
41134 #: ../src/guestfs.pod:2189
41135 msgid "You can list all the static markers by doing:"
41139 #: ../src/guestfs.pod:2191
41142 " stap -l 'process(\"/usr/lib*/libguestfs.so.0\")\n"
41143 " .provider(\"guestfs\").mark(\"*\")'\n"
41148 #: ../src/guestfs.pod:2194
41150 "B<Note:> These static markers are I<not> part of the stable API and may "
41151 "change in future versions."
41155 #: ../src/guestfs.pod:2197
41156 msgid "SYSTEMTAP SCRIPT EXAMPLE"
41160 #: ../src/guestfs.pod:2199
41162 "This script contains examples of displaying both the static markers and some "
41163 "ordinary C entry points:"
41167 #: ../src/guestfs.pod:2202
41175 #: ../src/guestfs.pod:2204
41178 " function display_time () {\n"
41179 " now = gettimeofday_us ();\n"
41182 " delta = now - last;\n"
41188 #: ../src/guestfs.pod:2211
41191 " printf (\"%d (+%d):\", now, delta);\n"
41197 #: ../src/guestfs.pod:2214
41202 " printf (\"ready\\n\");\n"
41208 #: ../src/guestfs.pod:2219
41211 " /* Display all calls to static markers. */\n"
41212 " probe process(\"/usr/lib*/libguestfs.so.0\")\n"
41213 " .provider(\"guestfs\").mark(\"*\") ? {\n"
41214 " display_time();\n"
41215 " printf (\"\\t%s %s\\n\", $$name, $$parms);\n"
41221 #: ../src/guestfs.pod:2226
41224 " /* Display all calls to guestfs_mkfs* functions. */\n"
41225 " probe process(\"/usr/lib*/libguestfs.so.0\")\n"
41226 " .function(\"guestfs_mkfs*\") ? {\n"
41227 " display_time();\n"
41228 " printf (\"\\t%s %s\\n\", probefunc(), $$parms);\n"
41234 #: ../src/guestfs.pod:2233
41236 "The script above can be saved to C<test.stap> and run using the L<stap(1)> "
41237 "program. Note that you either have to be root, or you have to add yourself "
41238 "to several special stap groups. Consult the systemtap documentation for "
41239 "more information."
41243 #: ../src/guestfs.pod:2238
41246 " # stap /tmp/test.stap\n"
41252 #: ../src/guestfs.pod:2241
41253 msgid "In another terminal, run a guestfish command such as this:"
41257 #: ../src/guestfs.pod:2245
41258 msgid "In the first terminal, stap trace output similar to this is shown:"
41262 #: ../src/guestfs.pod:2247
41265 " 1318248056692655 (+0):\tlaunch_start\n"
41266 " 1318248056692850 (+195): launch_build_appliance_start\n"
41267 " 1318248056818285 (+125435): launch_build_appliance_end\n"
41268 " 1318248056838059 (+19774): launch_run_qemu\n"
41269 " 1318248061071167 (+4233108): launch_end\n"
41270 " 1318248061280324 (+209157): guestfs_mkfs g=0x1024ab0 fstype=0x46116f device=0x1024e60\n"
41275 #: ../src/guestfs.pod:2254 ../src/guestfs.pod:2259
41280 #: ../src/guestfs.pod:2256
41282 "<!-- old anchor for the next section --> <a name="
41283 "\"state_machine_and_low_level_event_api\"/>"
41285 "<!-- old anchor for the next section --> <a name="
41286 "\"state_machine_and_low_level_event_api\"/>"
41289 #: ../src/guestfs.pod:2261
41290 msgid "ARCHITECTURE"
41291 msgstr "АРХІТЕКТУРА"
41294 #: ../src/guestfs.pod:2263
41296 "Internally, libguestfs is implemented by running an appliance (a special "
41297 "type of small virtual machine) using L<qemu(1)>. Qemu runs as a child "
41298 "process of the main program."
41302 #: ../src/guestfs.pod:2267
41305 " ___________________\n"
41307 " | main program |\n"
41309 " | | child process / appliance\n"
41310 " | | __________________________\n"
41312 " +-------------------+ RPC | +-----------------+ |\n"
41313 " | libguestfs <--------------------> guestfsd | |\n"
41314 " | | | +-----------------+ |\n"
41315 " \\___________________/ | | Linux kernel | |\n"
41316 " | +--^--------------+ |\n"
41317 " \\_________|________________/\n"
41319 " _______v______\n"
41322 " | disk image |\n"
41323 " \\______________/\n"
41328 #: ../src/guestfs.pod:2287
41330 "The library, linked to the main program, creates the child process and hence "
41331 "the appliance in the L</guestfs_launch> function."
41335 #: ../src/guestfs.pod:2290
41337 "Inside the appliance is a Linux kernel and a complete stack of userspace "
41338 "tools (such as LVM and ext2 programs) and a small controlling daemon called "
41339 "L</guestfsd>. The library talks to L</guestfsd> using remote procedure "
41340 "calls (RPC). There is a mostly one-to-one correspondence between libguestfs "
41341 "API calls and RPC calls to the daemon. Lastly the disk image(s) are "
41342 "attached to the qemu process which translates device access by the "
41343 "appliance's Linux kernel into accesses to the image."
41347 #: ../src/guestfs.pod:2299
41349 "A common misunderstanding is that the appliance \"is\" the virtual machine. "
41350 "Although the disk image you are attached to might also be used by some "
41351 "virtual machine, libguestfs doesn't know or care about this. (But you will "
41352 "care if both libguestfs's qemu process and your virtual machine are trying "
41353 "to update the disk image at the same time, since these usually results in "
41354 "massive disk corruption)."
41358 #: ../src/guestfs.pod:2306
41359 msgid "STATE MACHINE"
41360 msgstr "СКІНЧЕННИЙ АВТОМАТ"
41363 #: ../src/guestfs.pod:2308
41364 msgid "libguestfs uses a state machine to model the child process:"
41368 #: ../src/guestfs.pod:2310
41372 " guestfs_create\n"
41380 " / | \\ \\ guestfs_launch\n"
41381 " / | _\\__V______\n"
41383 " / | | LAUNCHING |\n"
41384 " / | \\___________/\n"
41386 " / | guestfs_launch\n"
41388 " ______ / __|____V\n"
41389 " / \\ ------> / \\\n"
41390 " | BUSY | | READY |\n"
41391 " \\______/ <------ \\________/\n"
41396 #: ../src/guestfs.pod:2332
41398 "The normal transitions are (1) CONFIG (when the handle is created, but there "
41399 "is no child process), (2) LAUNCHING (when the child process is booting up), "
41400 "(3) alternating between READY and BUSY as commands are issued to, and "
41401 "carried out by, the child process."
41405 #: ../src/guestfs.pod:2337
41407 "The guest may be killed by L</guestfs_kill_subprocess>, or may die "
41408 "asynchronously at any time (eg. due to some internal error), and that causes "
41409 "the state to transition back to CONFIG."
41413 #: ../src/guestfs.pod:2341
41415 "Configuration commands for qemu such as L</guestfs_add_drive> can only be "
41416 "issued when in the CONFIG state."
41420 #: ../src/guestfs.pod:2344
41422 "The API offers one call that goes from CONFIG through LAUNCHING to READY. "
41423 "L</guestfs_launch> blocks until the child process is READY to accept "
41424 "commands (or until some failure or timeout). L</guestfs_launch> internally "
41425 "moves the state from CONFIG to LAUNCHING while it is running."
41429 #: ../src/guestfs.pod:2350
41431 "API actions such as L</guestfs_mount> can only be issued when in the READY "
41432 "state. These API calls block waiting for the command to be carried out (ie. "
41433 "the state to transition to BUSY and then back to READY). There are no non-"
41434 "blocking versions, and no way to issue more than one command per handle at "
41439 #: ../src/guestfs.pod:2356
41441 "Finally, the child process sends asynchronous messages back to the main "
41442 "program, such as kernel log messages. You can register a callback to "
41443 "receive these messages."
41447 #: ../src/guestfs.pod:2360
41452 #: ../src/guestfs.pod:2362
41453 msgid "APPLIANCE BOOT PROCESS"
41457 #: ../src/guestfs.pod:2364
41459 "This process has evolved and continues to evolve. The description here "
41460 "corresponds only to the current version of libguestfs and is provided for "
41461 "information only."
41465 #: ../src/guestfs.pod:2368
41467 "In order to follow the stages involved below, enable libguestfs debugging "
41468 "(set the environment variable C<LIBGUESTFS_DEBUG=1>)."
41472 #: ../src/guestfs.pod:2373
41473 msgid "Create the appliance"
41477 #: ../src/guestfs.pod:2375
41479 "C<febootstrap-supermin-helper> is invoked to create the kernel, a small "
41480 "initrd and the appliance."
41484 #: ../src/guestfs.pod:2378
41486 "The appliance is cached in C</var/tmp/.guestfs-E<lt>UIDE<gt>> (or in another "
41487 "directory if C<TMPDIR> is set)."
41491 #: ../src/guestfs.pod:2381
41493 "For a complete description of how the appliance is created and cached, read "
41494 "the L<febootstrap(8)> and L<febootstrap-supermin-helper(8)> man pages."
41498 #: ../src/guestfs.pod:2385
41499 msgid "Start qemu and boot the kernel"
41503 #: ../src/guestfs.pod:2387
41504 msgid "qemu is invoked to boot the kernel."
41508 #: ../src/guestfs.pod:2389
41509 msgid "Run the initrd"
41513 #: ../src/guestfs.pod:2391
41515 "C<febootstrap-supermin-helper> builds a small initrd. The initrd is not the "
41516 "appliance. The purpose of the initrd is to load enough kernel modules in "
41517 "order that the appliance itself can be mounted and started."
41521 #: ../src/guestfs.pod:2395
41523 "The initrd is a cpio archive called C</var/tmp/.guestfs-E<lt>UIDE<gt>/"
41528 #: ../src/guestfs.pod:2398
41530 "When the initrd has started you will see messages showing that kernel "
41531 "modules are being loaded, similar to this:"
41535 #: ../src/guestfs.pod:2401
41538 " febootstrap: ext2 mini initrd starting up\n"
41539 " febootstrap: mounting /sys\n"
41540 " febootstrap: internal insmod libcrc32c.ko\n"
41541 " febootstrap: internal insmod crc32c-intel.ko\n"
41546 #: ../src/guestfs.pod:2406
41547 msgid "Find and mount the appliance device"
41551 #: ../src/guestfs.pod:2408
41553 "The appliance is a sparse file containing an ext2 filesystem which contains "
41554 "a familiar (although reduced in size) Linux operating system. It would "
41555 "normally be called C</var/tmp/.guestfs-E<lt>UIDE<gt>/root>."
41559 #: ../src/guestfs.pod:2412
41561 "The regular disks being inspected by libguestfs are the first devices "
41562 "exposed by qemu (eg. as C</dev/vda>)."
41566 #: ../src/guestfs.pod:2415
41568 "The last disk added to qemu is the appliance itself (eg. C</dev/vdb> if "
41569 "there was only one regular disk)."
41573 #: ../src/guestfs.pod:2418
41575 "Thus the final job of the initrd is to locate the appliance disk, mount it, "
41576 "and switch root into the appliance, and run C</init> from the appliance."
41580 #: ../src/guestfs.pod:2422
41581 msgid "If this works successfully you will see messages such as:"
41585 #: ../src/guestfs.pod:2424
41588 " febootstrap: picked /sys/block/vdb/dev as root device\n"
41589 " febootstrap: creating /dev/root as block special 252:16\n"
41590 " febootstrap: mounting new root on /root\n"
41591 " febootstrap: chroot\n"
41592 " Starting /init script ...\n"
41597 #: ../src/guestfs.pod:2430
41599 "Note that C<Starting /init script ...> indicates that the appliance's init "
41600 "script is now running."
41604 #: ../src/guestfs.pod:2433
41605 msgid "Initialize the appliance"
41609 #: ../src/guestfs.pod:2435
41611 "The appliance itself now initializes itself. This involves starting certain "
41612 "processes like C<udev>, possibly printing some debug information, and "
41613 "finally running the daemon (C<guestfsd>)."
41617 #: ../src/guestfs.pod:2439
41622 #: ../src/guestfs.pod:2441
41624 "Finally the daemon (C<guestfsd>) runs inside the appliance. If it runs you "
41629 #: ../src/guestfs.pod:2444
41632 " verbose daemon enabled\n"
41637 #: ../src/guestfs.pod:2446
41639 "The daemon expects to see a named virtio-serial port exposed by qemu and "
41640 "connected on the other end to the library."
41644 #: ../src/guestfs.pod:2449
41646 "The daemon connects to this port (and hence to the library) and sends a four "
41647 "byte message C<GUESTFS_LAUNCH_FLAG>, which initiates the communication "
41648 "protocol (see below)."
41652 #: ../src/guestfs.pod:2455
41653 msgid "COMMUNICATION PROTOCOL"
41657 #: ../src/guestfs.pod:2457
41659 "Don't rely on using this protocol directly. This section documents how it "
41660 "currently works, but it may change at any time."
41664 #: ../src/guestfs.pod:2460
41666 "The protocol used to talk between the library and the daemon running inside "
41667 "the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC "
41668 "1014, RFC 1832, RFC 4506)."
41672 #: ../src/guestfs.pod:2464
41674 "The detailed format of structures is in C<src/guestfs_protocol.x> (note: "
41675 "this file is automatically generated)."
41679 #: ../src/guestfs.pod:2467
41681 "There are two broad cases, ordinary functions that don't have any C<FileIn> "
41682 "and C<FileOut> parameters, which are handled with very simple request/reply "
41683 "messages. Then there are functions that have any C<FileIn> or C<FileOut> "
41684 "parameters, which use the same request and reply messages, but they may also "
41685 "be followed by files sent using a chunked encoding."
41689 #: ../src/guestfs.pod:2474
41690 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)"
41694 #: ../src/guestfs.pod:2476
41695 msgid "For ordinary functions, the request message is:"
41699 #: ../src/guestfs.pod:2478
41702 " total length (header + arguments,\n"
41703 " but not including the length word itself)\n"
41704 " struct guestfs_message_header (encoded as XDR)\n"
41705 " struct guestfs_<foo>_args (encoded as XDR)\n"
41710 #: ../src/guestfs.pod:2483
41712 "The total length field allows the daemon to allocate a fixed size buffer "
41713 "into which it slurps the rest of the message. As a result, the total length "
41714 "is limited to C<GUESTFS_MESSAGE_MAX> bytes (currently 4MB), which means the "
41715 "effective size of any request is limited to somewhere under this size."
41719 #: ../src/guestfs.pod:2489
41721 "Note also that many functions don't take any arguments, in which case the "
41722 "C<guestfs_I<foo>_args> is completely omitted."
41726 #: ../src/guestfs.pod:2492
41728 "The header contains the procedure number (C<guestfs_proc>) which is how the "
41729 "receiver knows what type of args structure to expect, or none at all."
41733 #: ../src/guestfs.pod:2496
41735 "For functions that take optional arguments, the optional arguments are "
41736 "encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary "
41737 "arguments. A bitmask in the header indicates which optional arguments are "
41738 "meaningful. The bitmask is also checked to see if it contains bits set "
41739 "which the daemon does not know about (eg. if more optional arguments were "
41740 "added in a later version of the library), and this causes the call to be "
41745 #: ../src/guestfs.pod:2504
41746 msgid "The reply message for ordinary functions is:"
41750 #: ../src/guestfs.pod:2506
41753 " total length (header + ret,\n"
41754 " but not including the length word itself)\n"
41755 " struct guestfs_message_header (encoded as XDR)\n"
41756 " struct guestfs_<foo>_ret (encoded as XDR)\n"
41761 #: ../src/guestfs.pod:2511
41763 "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for "
41764 "functions that return no formal return values."
41768 #: ../src/guestfs.pod:2514
41770 "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>."
41774 #: ../src/guestfs.pod:2517
41776 "In the case of an error, a flag is set in the header, and the reply message "
41777 "is slightly changed:"
41781 #: ../src/guestfs.pod:2520
41784 " total length (header + error,\n"
41785 " but not including the length word itself)\n"
41786 " struct guestfs_message_header (encoded as XDR)\n"
41787 " struct guestfs_message_error (encoded as XDR)\n"
41792 #: ../src/guestfs.pod:2525
41794 "The C<guestfs_message_error> structure contains the error message as a "
41799 #: ../src/guestfs.pod:2528
41800 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS"
41804 #: ../src/guestfs.pod:2530
41806 "A C<FileIn> parameter indicates that we transfer a file I<into> the guest. "
41807 "The normal request message is sent (see above). However this is followed by "
41808 "a sequence of file chunks."
41812 #: ../src/guestfs.pod:2534
41815 " total length (header + arguments,\n"
41816 " but not including the length word itself,\n"
41817 " and not including the chunks)\n"
41818 " struct guestfs_message_header (encoded as XDR)\n"
41819 " struct guestfs_<foo>_args (encoded as XDR)\n"
41820 " sequence of chunks for FileIn param #0\n"
41821 " sequence of chunks for FileIn param #1 etc.\n"
41826 #: ../src/guestfs.pod:2542
41827 msgid "The \"sequence of chunks\" is:"
41831 #: ../src/guestfs.pod:2544
41834 " length of chunk (not including length word itself)\n"
41835 " struct guestfs_chunk (encoded as XDR)\n"
41836 " length of chunk\n"
41837 " struct guestfs_chunk (encoded as XDR)\n"
41839 " length of chunk\n"
41840 " struct guestfs_chunk (with data.data_len == 0)\n"
41845 #: ../src/guestfs.pod:2552
41847 "The final chunk has the C<data_len> field set to zero. Additionally a flag "
41848 "is set in the final chunk to indicate either successful completion or early "
41853 #: ../src/guestfs.pod:2556
41855 "At time of writing there are no functions that have more than one FileIn "
41856 "parameter. However this is (theoretically) supported, by sending the "
41857 "sequence of chunks for each FileIn parameter one after another (from left to "
41862 #: ../src/guestfs.pod:2561
41864 "Both the library (sender) I<and> the daemon (receiver) may cancel the "
41865 "transfer. The library does this by sending a chunk with a special flag set "
41866 "to indicate cancellation. When the daemon sees this, it cancels the whole "
41867 "RPC, does I<not> send any reply, and goes back to reading the next request."
41871 #: ../src/guestfs.pod:2567
41873 "The daemon may also cancel. It does this by writing a special word "
41874 "C<GUESTFS_CANCEL_FLAG> to the socket. The library listens for this during "
41875 "the transfer, and if it gets it, it will cancel the transfer (it sends a "
41876 "cancel chunk). The special word is chosen so that even if cancellation "
41877 "happens right at the end of the transfer (after the library has finished "
41878 "writing and has started listening for the reply), the \"spurious\" cancel "
41879 "flag will not be confused with the reply message."
41883 #: ../src/guestfs.pod:2576
41885 "This protocol allows the transfer of arbitrary sized files (no 32 bit "
41886 "limit), and also files where the size is not known in advance (eg. from "
41887 "pipes or sockets). However the chunks are rather small "
41888 "(C<GUESTFS_MAX_CHUNK_SIZE>), so that neither the library nor the daemon need "
41889 "to keep much in memory."
41893 #: ../src/guestfs.pod:2582
41894 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS"
41898 #: ../src/guestfs.pod:2584
41900 "The protocol for FileOut parameters is exactly the same as for FileIn "
41901 "parameters, but with the roles of daemon and library reversed."
41905 #: ../src/guestfs.pod:2587
41908 " total length (header + ret,\n"
41909 " but not including the length word itself,\n"
41910 " and not including the chunks)\n"
41911 " struct guestfs_message_header (encoded as XDR)\n"
41912 " struct guestfs_<foo>_ret (encoded as XDR)\n"
41913 " sequence of chunks for FileOut param #0\n"
41914 " sequence of chunks for FileOut param #1 etc.\n"
41919 #: ../src/guestfs.pod:2595
41920 msgid "INITIAL MESSAGE"
41924 #: ../src/guestfs.pod:2597
41926 "When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) "
41927 "which indicates that the guest and daemon is alive. This is what L</"
41928 "guestfs_launch> waits for."
41932 #: ../src/guestfs.pod:2601
41933 msgid "PROGRESS NOTIFICATION MESSAGES"
41937 #: ../src/guestfs.pod:2603
41939 "The daemon may send progress notification messages at any time. These are "
41940 "distinguished by the normal length word being replaced by "
41941 "C<GUESTFS_PROGRESS_FLAG>, followed by a fixed size progress message."
41945 #: ../src/guestfs.pod:2607
41947 "The library turns them into progress callbacks (see L</"
41948 "GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards them "
41953 #: ../src/guestfs.pod:2611
41955 "The daemon self-limits the frequency of progress messages it sends (see "
41956 "C<daemon/proto.c:notify_progress>). Not all calls generate progress "
41961 #: ../src/guestfs.pod:2615
41962 msgid "LIBGUESTFS VERSION NUMBERS"
41966 #: ../src/guestfs.pod:2617
41968 "Since April 2010, libguestfs has started to make separate development and "
41969 "stable releases, along with corresponding branches in our git repository. "
41970 "These separate releases can be identified by version number:"
41974 #: ../src/guestfs.pod:2622
41977 " even numbers for stable: 1.2.x, 1.4.x, ...\n"
41978 " .-------- odd numbers for development: 1.3.x, 1.5.x, ...\n"
41984 " | `-------- sub-version\n"
41986 " `------ always '1' because we don't change the ABI\n"
41991 #: ../src/guestfs.pod:2633
41992 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"."
41996 #: ../src/guestfs.pod:2635
41998 "As time passes we cherry pick fixes from the development branch and backport "
41999 "those into the stable branch, the effect being that the stable branch should "
42000 "get more stable and less buggy over time. So the stable releases are ideal "
42001 "for people who don't need new features but would just like the software to "
42006 #: ../src/guestfs.pod:2641
42007 msgid "Our criteria for backporting changes are:"
42011 #: ../src/guestfs.pod:2647
42013 "Documentation changes which don't affect any code are backported unless the "
42014 "documentation refers to a future feature which is not in stable."
42018 #: ../src/guestfs.pod:2653
42020 "Bug fixes which are not controversial, fix obvious problems, and have been "
42021 "well tested are backported."
42025 #: ../src/guestfs.pod:2658
42027 "Simple rearrangements of code which shouldn't affect how it works get "
42028 "backported. This is so that the code in the two branches doesn't get too "
42029 "far out of step, allowing us to backport future fixes more easily."
42033 #: ../src/guestfs.pod:2664
42035 "We I<don't> backport new features, new APIs, new tools etc, except in one "
42036 "exceptional case: the new feature is required in order to implement an "
42037 "important bug fix."
42041 #: ../src/guestfs.pod:2670
42043 "A new stable branch starts when we think the new features in development are "
42044 "substantial and compelling enough over the current stable branch to warrant "
42045 "it. When that happens we create new stable and development versions 1.N.0 "
42046 "and 1.(N+1).0 [N is even]. The new dot-oh release won't necessarily be so "
42047 "stable at this point, but by backporting fixes from development, that branch "
42048 "will stabilize over time."
42052 #: ../src/guestfs.pod:2678
42053 msgid "EXTENDING LIBGUESTFS"
42057 #: ../src/guestfs.pod:2680
42058 msgid "ADDING A NEW API ACTION"
42062 #: ../src/guestfs.pod:2682
42064 "Large amounts of boilerplate code in libguestfs (RPC, bindings, "
42065 "documentation) are generated, and this makes it easy to extend the "
42070 #: ../src/guestfs.pod:2686
42071 msgid "To add a new API action there are two changes:"
42075 #: ../src/guestfs.pod:2692
42077 "You need to add a description of the call (name, parameters, return type, "
42078 "tests, documentation) to C<generator/generator_actions.ml>."
42082 #: ../src/guestfs.pod:2695
42084 "There are two sorts of API action, depending on whether the call goes "
42085 "through to the daemon in the appliance, or is serviced entirely by the "
42086 "library (see L</ARCHITECTURE> above). L</guestfs_sync> is an example of the "
42087 "former, since the sync is done in the appliance. L</guestfs_set_trace> is "
42088 "an example of the latter, since a trace flag is maintained in the handle and "
42089 "all tracing is done on the library side."
42093 #: ../src/guestfs.pod:2703
42095 "Most new actions are of the first type, and get added to the "
42096 "C<daemon_functions> list. Each function has a unique procedure number used "
42097 "in the RPC protocol which is assigned to that action when we publish "
42098 "libguestfs and cannot be reused. Take the latest procedure number and "
42103 #: ../src/guestfs.pod:2709
42105 "For library-only actions of the second type, add to the "
42106 "C<non_daemon_functions> list. Since these functions are serviced by the "
42107 "library and do not travel over the RPC mechanism to the daemon, these "
42108 "functions do not need a procedure number, and so the procedure number is set "
42113 #: ../src/guestfs.pod:2717
42114 msgid "Implement the action (in C):"
42118 #: ../src/guestfs.pod:2719
42120 "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the "
42121 "C<daemon/> directory."
42125 #: ../src/guestfs.pod:2722
42127 "For library actions, implement the function C<guestfs__E<lt>nameE<gt>> "
42128 "(note: double underscore) in the C<src/> directory."
42132 #: ../src/guestfs.pod:2725
42133 msgid "In either case, use another function as an example of what to do."
42137 #: ../src/guestfs.pod:2729
42138 msgid "After making these changes, use C<make> to compile."
42142 #: ../src/guestfs.pod:2731
42144 "Note that you don't need to implement the RPC, language bindings, manual "
42145 "pages or anything else. It's all automatically generated from the OCaml "
42150 #: ../src/guestfs.pod:2735
42151 msgid "ADDING TESTS FOR AN API ACTION"
42155 #: ../src/guestfs.pod:2737
42157 "You can supply zero or as many tests as you want per API call. The tests "
42158 "can either be added as part of the API description (C<generator/"
42159 "generator_actions.ml>), or in some rarer cases you may want to drop a script "
42160 "into C<regressions/>. Note that adding a script to C<regressions/> is "
42161 "slower, so if possible use the first method."
42165 #: ../src/guestfs.pod:2743
42167 "The following describes the test environment used when you add an API test "
42168 "in C<generator_actions.ml>."
42172 #: ../src/guestfs.pod:2746
42173 msgid "The test environment has 4 block devices:"
42177 #: ../src/guestfs.pod:2750
42178 msgid "C</dev/sda> 500MB"
42179 msgstr "C</dev/sda> 500 МБ"
42182 #: ../src/guestfs.pod:2752
42183 msgid "General block device for testing."
42187 #: ../src/guestfs.pod:2754
42188 msgid "C</dev/sdb> 50MB"
42189 msgstr "C</dev/sdb> 50 МБ"
42192 #: ../src/guestfs.pod:2756
42194 "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write "
42199 #: ../src/guestfs.pod:2759
42200 msgid "C</dev/sdc> 10MB"
42201 msgstr "C</dev/sdc> 10 МБ"
42204 #: ../src/guestfs.pod:2761
42205 msgid "Used in a few tests where two block devices are needed."
42209 #: ../src/guestfs.pod:2763
42210 msgid "C</dev/sdd>"
42211 msgstr "C</dev/sdd>"
42214 #: ../src/guestfs.pod:2765
42215 msgid "ISO with fixed content (see C<images/test.iso>)."
42219 #: ../src/guestfs.pod:2769
42221 "To be able to run the tests in a reasonable amount of time, the libguestfs "
42222 "appliance and block devices are reused between tests. So don't try testing "
42223 "L</guestfs_kill_subprocess> :-x"
42227 #: ../src/guestfs.pod:2773
42229 "Each test starts with an initial scenario, selected using one of the "
42230 "C<Init*> expressions, described in C<generator/generator_types.ml>. These "
42231 "initialize the disks mentioned above in a particular way as documented in "
42232 "C<generator_types.ml>. You should not assume anything about the previous "
42233 "contents of other disks that are not initialized."
42237 #: ../src/guestfs.pod:2779
42239 "You can add a prerequisite clause to any individual test. This is a run-"
42240 "time check, which, if it fails, causes the test to be skipped. Useful if "
42241 "testing a command which might not work on all variations of libguestfs "
42242 "builds. A test that has prerequisite of C<Always> means to run "
42247 #: ../src/guestfs.pod:2785
42249 "In addition, packagers can skip individual tests by setting environment "
42250 "variables before running C<make check>."
42254 #: ../src/guestfs.pod:2788
42257 " SKIP_TEST_<CMD>_<NUM>=1\n"
42262 #: ../src/guestfs.pod:2790
42263 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>."
42267 #: ../src/guestfs.pod:2794
42270 " SKIP_TEST_<CMD>=1\n"
42275 #: ../src/guestfs.pod:2796
42276 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests."
42280 #: ../src/guestfs.pod:2798
42281 msgid "Packagers can run only certain tests by setting for example:"
42285 #: ../src/guestfs.pod:2800
42288 " TEST_ONLY=\"vfs_type zerofree\"\n"
42293 #: ../src/guestfs.pod:2802
42295 "See C<capitests/tests.c> for more details of how these environment variables "
42300 #: ../src/guestfs.pod:2805
42301 msgid "DEBUGGING NEW API ACTIONS"
42305 #: ../src/guestfs.pod:2807
42306 msgid "Test new actions work before submitting them."
42310 #: ../src/guestfs.pod:2809
42311 msgid "You can use guestfish to try out new commands."
42315 #: ../src/guestfs.pod:2811
42317 "Debugging the daemon is a problem because it runs inside a minimal "
42318 "environment. However you can fprintf messages in the daemon to stderr, and "
42319 "they will show up if you use C<guestfish -v>."
42323 #: ../src/guestfs.pod:2815
42324 msgid "FORMATTING CODE AND OTHER CONVENTIONS"
42328 #: ../src/guestfs.pod:2817
42330 "Our C source code generally adheres to some basic code-formatting "
42331 "conventions. The existing code base is not totally consistent on this "
42332 "front, but we do prefer that contributed code be formatted similarly. In "
42333 "short, use spaces-not-TABs for indentation, use 2 spaces for each "
42334 "indentation level, and other than that, follow the K&R style."
42338 #: ../src/guestfs.pod:2823
42340 "If you use Emacs, add the following to one of one of your start-up files (e."
42341 "g., ~/.emacs), to help ensure that you get indentation right:"
42345 #: ../src/guestfs.pod:2826
42348 " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n"
42349 " ;;; Exceptions: Makefile and ChangeLog modes.\n"
42350 " (add-hook 'find-file-hook\n"
42351 " '(lambda () (if (and buffer-file-name\n"
42352 " (string-match \"/libguestfs\\\\>\"\n"
42353 " (buffer-file-name))\n"
42354 " (not (string-equal mode-name \"Change Log\"))\n"
42355 " (not (string-equal mode-name \"Makefile\")))\n"
42356 " (setq indent-tabs-mode nil))))\n"
42361 #: ../src/guestfs.pod:2836
42364 " ;;; When editing C sources in libguestfs, use this style.\n"
42365 " (defun libguestfs-c-mode ()\n"
42366 " \"C mode with adjusted defaults for use with libguestfs.\"\n"
42368 " (c-set-style \"K&R\")\n"
42369 " (setq c-indent-level 2)\n"
42370 " (setq c-basic-offset 2))\n"
42371 " (add-hook 'c-mode-hook\n"
42372 " '(lambda () (if (string-match \"/libguestfs\\\\>\"\n"
42373 " (buffer-file-name))\n"
42374 " (libguestfs-c-mode))))\n"
42379 #: ../src/guestfs.pod:2848
42380 msgid "Enable warnings when compiling (and fix any problems this finds):"
42384 #: ../src/guestfs.pod:2851
42387 " ./configure --enable-gcc-warnings\n"
42390 " ./configure --enable-gcc-warnings\n"
42394 #: ../src/guestfs.pod:2853
42395 msgid "Useful targets are:"
42399 #: ../src/guestfs.pod:2855
42402 " make syntax-check # checks the syntax of the C code\n"
42403 " make check # runs the test suite\n"
42408 #: ../src/guestfs.pod:2858
42409 msgid "DAEMON CUSTOM PRINTF FORMATTERS"
42413 #: ../src/guestfs.pod:2860
42415 "In the daemon code we have created custom printf formatters C<%Q> and C<%R>, "
42416 "which are used to do shell quoting."
42420 #: ../src/guestfs.pod:2865
42425 #: ../src/guestfs.pod:2867
42427 "Simple shell quoted string. Any spaces or other shell characters are "
42432 #: ../src/guestfs.pod:2870
42437 #: ../src/guestfs.pod:2872
42439 "Same as C<%Q> except the string is treated as a path which is prefixed by "
42444 #: ../src/guestfs.pod:2879
42447 " asprintf (&cmd, \"cat %R\", path);\n"
42450 " asprintf (&cmd, \"cat %R\", path);\n"
42454 #: ../src/guestfs.pod:2881
42455 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>"
42459 #: ../src/guestfs.pod:2883
42461 "I<Note:> Do I<not> use these when you are passing parameters to the C<command"
42462 "{,r,v,rv}()> functions. These parameters do NOT need to be quoted because "
42463 "they are not passed via the shell (instead, straight to exec). You probably "
42464 "want to use the C<sysroot_path()> function however."
42468 #: ../src/guestfs.pod:2889
42469 msgid "SUBMITTING YOUR NEW API ACTIONS"
42473 #: ../src/guestfs.pod:2891
42475 "Submit patches to the mailing list: L<http://www.redhat.com/mailman/listinfo/"
42476 "libguestfs> and CC to L<rjones@redhat.com>."
42480 #: ../src/guestfs.pod:2895
42481 msgid "INTERNATIONALIZATION (I18N) SUPPORT"
42485 #: ../src/guestfs.pod:2897
42486 msgid "We support i18n (gettext anyhow) in the library."
42490 #: ../src/guestfs.pod:2899
42492 "However many messages come from the daemon, and we don't translate those at "
42493 "the moment. One reason is that the appliance generally has all locale files "
42494 "removed from it, because they take up a lot of space. So we'd have to readd "
42495 "some of those, as well as copying our PO files into the appliance."
42499 #: ../src/guestfs.pod:2905
42501 "Debugging messages are never translated, since they are intended for the "
42506 #: ../src/guestfs.pod:2908
42507 msgid "SOURCE CODE SUBDIRECTORIES"
42511 #: ../src/guestfs.pod:2912
42516 #: ../src/guestfs.pod:2914
42517 msgid "L<virt-alignment-scan(1)> command and documentation."
42521 #: ../src/guestfs.pod:2918
42522 msgid "The libguestfs appliance, build scripts and so on."
42526 #: ../src/guestfs.pod:2920
42527 msgid "C<capitests>"
42528 msgstr "C<capitests>"
42531 #: ../src/guestfs.pod:2922
42532 msgid "Automated tests of the C API."
42536 #: ../src/guestfs.pod:2924
42541 #: ../src/guestfs.pod:2926
42543 "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and "
42548 #: ../src/guestfs.pod:2929
42550 msgstr "C<caution>"
42553 #: ../src/guestfs.pod:2931
42555 "Safety and liveness tests of components that libguestfs depends upon (not of "
42556 "libguestfs itself). Mainly this is for qemu and the kernel."
42560 #: ../src/guestfs.pod:2934
42565 #: ../src/guestfs.pod:2936
42567 "Tools for cloning virtual machines. Currently contains L<virt-sysprep(1)> "
42568 "command and documentation."
42572 #: ../src/guestfs.pod:2939
42574 msgstr "C<contrib>"
42577 #: ../src/guestfs.pod:2941
42578 msgid "Outside contributions, experimental parts."
42582 #: ../src/guestfs.pod:2943
42587 #: ../src/guestfs.pod:2945
42589 "The daemon that runs inside the libguestfs appliance and carries out actions."
42593 #: ../src/guestfs.pod:2948
42598 #: ../src/guestfs.pod:2950
42599 msgid "L<virt-df(1)> command and documentation."
42603 #: ../src/guestfs.pod:2952
42608 #: ../src/guestfs.pod:2954
42609 msgid "L<virt-edit(1)> command and documentation."
42613 #: ../src/guestfs.pod:2956
42614 msgid "C<examples>"
42615 msgstr "C<examples>"
42618 #: ../src/guestfs.pod:2958
42619 msgid "C API example code."
42620 msgstr "Код прикладів використання програмного інтерфейсу мовою C."
42623 #: ../src/guestfs.pod:2960
42628 #: ../src/guestfs.pod:2962
42630 "L<guestfish(1)>, the command-line shell, and various shell scripts built on "
42631 "top such as L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, "
42632 "L<virt-tar-out(1)>."
42636 #: ../src/guestfs.pod:2966
42641 #: ../src/guestfs.pod:2968
42643 "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs."
42647 #: ../src/guestfs.pod:2970
42648 msgid "C<generator>"
42649 msgstr "C<generator>"
42652 #: ../src/guestfs.pod:2972
42654 "The crucially important generator, used to automatically generate large "
42655 "amounts of boilerplate C code for things like RPC and bindings."
42659 #: ../src/guestfs.pod:2975
42664 #: ../src/guestfs.pod:2977
42665 msgid "Files used by the test suite."
42669 #: ../src/guestfs.pod:2979
42670 msgid "Some \"phony\" guest images which we test against."
42674 #: ../src/guestfs.pod:2981
42675 msgid "C<inspector>"
42676 msgstr "C<inspector>"
42679 #: ../src/guestfs.pod:2983
42680 msgid "L<virt-inspector(1)>, the virtual machine image inspector."
42684 #: ../src/guestfs.pod:2985
42689 #: ../src/guestfs.pod:2987
42690 msgid "Logo used on the website. The fish is called Arthur by the way."
42694 #: ../src/guestfs.pod:2989
42699 #: ../src/guestfs.pod:2991
42700 msgid "M4 macros used by autoconf."
42704 #: ../src/guestfs.pod:2993
42709 #: ../src/guestfs.pod:2995
42710 msgid "Translations of simple gettext strings."
42711 msgstr "Переклади простих рядків gettext."
42714 #: ../src/guestfs.pod:2997
42716 msgstr "C<po-docs>"
42719 #: ../src/guestfs.pod:2999
42721 "The build infrastructure and PO files for translations of manpages and POD "
42722 "files. Eventually this will be combined with the C<po> directory, but that "
42723 "is rather complicated."
42727 #: ../src/guestfs.pod:3003
42728 msgid "C<regressions>"
42729 msgstr "C<regressions>"
42732 #: ../src/guestfs.pod:3005
42733 msgid "Regression tests."
42734 msgstr "Тести на регресії."
42737 #: ../src/guestfs.pod:3007
42742 #: ../src/guestfs.pod:3009
42743 msgid "L<virt-rescue(1)> command and documentation."
42747 #: ../src/guestfs.pod:3011
42752 #: ../src/guestfs.pod:3013
42753 msgid "L<virt-resize(1)> command and documentation."
42757 #: ../src/guestfs.pod:3015
42758 msgid "C<sparsify>"
42762 #: ../src/guestfs.pod:3017
42763 msgid "L<virt-sparsify(1)> command and documentation."
42767 #: ../src/guestfs.pod:3019
42772 #: ../src/guestfs.pod:3021
42773 msgid "Source code to the C library."
42777 #: ../src/guestfs.pod:3023
42782 #: ../src/guestfs.pod:3025
42784 "Command line tools written in Perl (L<virt-win-reg(1)> and many others)."
42788 #: ../src/guestfs.pod:3027
42789 msgid "C<test-tool>"
42790 msgstr "C<test-tool>"
42793 #: ../src/guestfs.pod:3029
42795 "Test tool for end users to test if their qemu/kernel combination will work "
42800 #: ../src/guestfs.pod:3032
42805 #: ../src/guestfs.pod:3034
42810 #: ../src/guestfs.pod:3036
42812 msgstr "C<haskell>"
42815 #: ../src/guestfs.pod:3038
42820 #: ../src/guestfs.pod:3040
42825 #: ../src/guestfs.pod:3042
42830 #: ../src/guestfs.pod:3044
42835 #: ../src/guestfs.pod:3046
42840 #: ../src/guestfs.pod:3048
42845 #: ../src/guestfs.pod:3050
42846 msgid "Language bindings."
42847 msgstr "Прив’язки до мов програмування."
42850 #: ../src/guestfs.pod:3054
42851 msgid "MAKING A STABLE RELEASE"
42855 #: ../src/guestfs.pod:3056
42857 "When we make a stable release, there are several steps documented here. See "
42858 "L</LIBGUESTFS VERSION NUMBERS> for general information about the stable "
42863 #: ../src/guestfs.pod:3064
42865 "Check C<make && make check> works on at least Fedora, Debian and Ubuntu."
42869 #: ../src/guestfs.pod:3069
42870 msgid "Finalize RELEASE-NOTES."
42874 #: ../src/guestfs.pod:3073
42875 msgid "Update ROADMAP."
42879 #: ../src/guestfs.pod:3077
42880 msgid "Run C<src/api-support/update-from-tarballs.sh>."
42884 #: ../src/guestfs.pod:3081
42885 msgid "Push and pull from Transifex."
42889 #: ../src/guestfs.pod:3085
42897 #: ../src/guestfs.pod:3087
42898 msgid "to push the latest POT files to Transifex. Then run:"
42902 #: ../src/guestfs.pod:3089
42910 #: ../src/guestfs.pod:3091
42911 msgid "which is a wrapper to pull the latest translated C<*.po> files."
42915 #: ../src/guestfs.pod:3095
42917 "Create new stable and development directories under L<http://libguestfs.org/"
42922 #: ../src/guestfs.pod:3100
42923 msgid "Create the branch in git:"
42927 #: ../src/guestfs.pod:3102
42930 " git tag -a 1.XX.0 -m \"Version 1.XX.0 (stable)\"\n"
42931 " git tag -a 1.YY.0 -m \"Version 1.YY.0 (development)\"\n"
42932 " git branch stable-1.XX\n"
42933 " git push origin tag 1.XX.0 1.YY.0 stable-1.XX\n"
42938 #: ../src/guestfs.pod:3109
42943 #: ../src/guestfs.pod:3111
42944 msgid "PROTOCOL LIMITS"
42945 msgstr "ОБМЕЖЕННЯ ПРОТОКОЛУ"
42948 #: ../src/guestfs.pod:3113
42950 "Internally libguestfs uses a message-based protocol to pass API calls and "
42951 "their responses to and from a small \"appliance\" (see L</INTERNALS> for "
42952 "plenty more detail about this). The maximum message size used by the "
42953 "protocol is slightly less than 4 MB. For some API calls you may need to be "
42954 "aware of this limit. The API calls which may be affected are individually "
42955 "documented, with a link back to this section of the documentation."
42959 #: ../src/guestfs.pod:3121
42961 "A simple call such as L</guestfs_cat> returns its result (the file data) in "
42962 "a simple string. Because this string is at some point internally encoded as "
42963 "a message, the maximum size that it can return is slightly under 4 MB. If "
42964 "the requested file is larger than this then you will get an error."
42968 #: ../src/guestfs.pod:3127
42970 "In order to transfer large files into and out of the guest filesystem, you "
42971 "need to use particular calls that support this. The sections L</UPLOADING> "
42972 "and L</DOWNLOADING> document how to do this."
42976 #: ../src/guestfs.pod:3131
42978 "You might also consider mounting the disk image using our FUSE filesystem "
42979 "support (L<guestmount(1)>)."
42983 #: ../src/guestfs.pod:3134
42984 msgid "MAXIMUM NUMBER OF DISKS"
42988 #: ../src/guestfs.pod:3136
42989 msgid "When using virtio disks (the default) the current limit is B<25> disks."
42993 #: ../src/guestfs.pod:3139
42995 "Virtio itself consumes 1 virtual PCI slot per disk, and PCI is limited to 31 "
42996 "slots. However febootstrap only understands disks with names C</dev/vda> "
42997 "through C</dev/vdz> (26 letters) and it reserves one disk for its own "
43002 #: ../src/guestfs.pod:3144
43004 "We are working to substantially raise this limit in future versions but it "
43005 "requires complex changes to qemu."
43009 #: ../src/guestfs.pod:3147
43011 "In future versions of libguestfs it should also be possible to \"hot plug\" "
43012 "disks (add and remove disks after calling L</guestfs_launch>). This also "
43013 "requires changes to qemu."
43017 #: ../src/guestfs.pod:3151
43018 msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK"
43022 #: ../src/guestfs.pod:3153
43023 msgid "Virtio limits the maximum number of partitions per disk to B<15>."
43027 #: ../src/guestfs.pod:3155
43029 "This is because it reserves 4 bits for the minor device number (thus C</dev/"
43030 "vda>, and C</dev/vda1> through C</dev/vda15>)."
43034 #: ../src/guestfs.pod:3158
43036 "If you attach a disk with more than 15 partitions, the extra partitions are "
43037 "ignored by libguestfs."
43041 #: ../src/guestfs.pod:3161
43042 msgid "MAXIMUM SIZE OF A DISK"
43046 #: ../src/guestfs.pod:3163
43047 msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes."
43051 #: ../src/guestfs.pod:3165
43053 "We have tested block devices up to 1 exabyte (2**60 or "
43054 "1,152,921,504,606,846,976 bytes) using sparse files backed by an XFS host "
43059 #: ../src/guestfs.pod:3169
43061 "Although libguestfs probably does not impose any limit, the underlying host "
43062 "storage will. If you store disk images on a host ext4 filesystem, then the "
43063 "maximum size will be limited by the maximum ext4 file size (currently 16 "
43064 "TB). If you store disk images as host logical volumes then you are limited "
43065 "by the maximum size of an LV."
43069 #: ../src/guestfs.pod:3175
43071 "For the hugest disk image files, we recommend using XFS on the host for "
43076 #: ../src/guestfs.pod:3178
43077 msgid "MAXIMUM SIZE OF A PARTITION"
43081 #: ../src/guestfs.pod:3180
43083 "The MBR (ie. classic MS-DOS) partitioning scheme uses 32 bit sector "
43084 "numbers. Assuming a 512 byte sector size, this means that MBR cannot "
43085 "address a partition located beyond 2 TB on the disk."
43089 #: ../src/guestfs.pod:3184
43091 "It is recommended that you use GPT partitions on disks which are larger than "
43092 "this size. GPT uses 64 bit sector numbers and so can address partitions "
43093 "which are theoretically larger than the largest disk we could support."
43097 #: ../src/guestfs.pod:3189
43098 msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES"
43102 #: ../src/guestfs.pod:3191
43104 "This depends on the filesystem type. libguestfs itself does not impose any "
43105 "known limit. Consult Wikipedia or the filesystem documentation to find out "
43106 "what these limits are."
43110 #: ../src/guestfs.pod:3195
43111 msgid "MAXIMUM UPLOAD AND DOWNLOAD"
43115 #: ../src/guestfs.pod:3197
43117 "The API functions L</guestfs_upload>, L</guestfs_download>, L</"
43118 "guestfs_tar_in>, L</guestfs_tar_out> and the like allow unlimited sized "
43119 "uploads and downloads."
43123 #: ../src/guestfs.pod:3201
43124 msgid "INSPECTION LIMITS"
43128 #: ../src/guestfs.pod:3203
43130 "The inspection code has several arbitrary limits on things like the size of "
43131 "Windows Registry hive it will read, and the length of product name. These "
43132 "are intended to stop a malicious guest from consuming arbitrary amounts of "
43133 "memory and disk space on the host, and should not be reached in practice. "
43134 "See the source code for more information."
43138 #: ../src/guestfs.pod:3229
43140 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages. This has the same "
43141 "effect as calling C<guestfs_set_verbose (g, 1)>."
43145 #: ../src/guestfs.pod:3241
43147 "Set the path that libguestfs uses to search for a supermin appliance. See "
43148 "the discussion of paths in section L</PATH> above."
43152 #: ../src/guestfs.pod:3250
43153 msgid "See also L</QEMU WRAPPERS> above."
43157 #: ../src/guestfs.pod:3254
43159 "Set C<LIBGUESTFS_TRACE=1> to enable command traces. This has the same "
43160 "effect as calling C<guestfs_set_trace (g, 1)>."
43164 #: ../src/guestfs.pod:3272
43166 "L<guestfs-examples(3)>, L<guestfs-erlang(3)>, L<guestfs-java(3)>, L<guestfs-"
43167 "ocaml(3)>, L<guestfs-perl(3)>, L<guestfs-python(3)>, L<guestfs-ruby(3)>, "
43168 "L<guestfish(1)>, L<guestmount(1)>, L<virt-alignment-scan(1)>, L<virt-cat(1)"
43169 ">, L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, "
43170 "L<virt-filesystems(1)>, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, "
43171 "L<virt-list-partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-rescue"
43172 "(1)>, L<virt-resize(1)>, L<virt-sparsify(1)>, L<virt-sysprep(1)>, L<virt-tar"
43173 "(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)>, L<guestfs-"
43174 "testing(1)>, L<qemu(1)>, L<febootstrap(1)>, L<febootstrap-supermin-helper(8)"
43175 ">, L<hivex(3)>, L<stap(1)>, L<http://libguestfs.org/>."
43179 #: ../src/guestfs.pod:3309
43181 "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, L<lvm"
43182 "(8)>, L<disktype(1)>."
43186 #: ../src/guestfs.pod:3316 ../tools/virt-make-fs.pl:571
43187 #: ../tools/virt-win-reg.pl:772
43192 #: ../src/guestfs.pod:3318
43193 msgid "To get a list of bugs against libguestfs use this link:"
43195 "Щоб переглянути список відомих вад у libguestfs, скористайтеся таким "
43199 #: ../src/guestfs.pod:3320
43201 "L<https://bugzilla.redhat.com/buglist.cgi?"
43202 "component=libguestfs&product=Virtualization+Tools>"
43204 "L<https://bugzilla.redhat.com/buglist.cgi?"
43205 "component=libguestfs&product=Virtualization+Tools>"
43208 #: ../src/guestfs.pod:3322
43209 msgid "To report a new bug against libguestfs use this link:"
43210 msgstr "Для звітування щодо вад у libguestfs скористайтеся цим посиланням:"
43213 #: ../src/guestfs.pod:3324
43215 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
43216 "component=libguestfs&product=Virtualization+Tools>"
43218 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
43219 "component=libguestfs&product=Virtualization+Tools>"
43222 #: ../src/guestfs.pod:3326
43223 msgid "When reporting a bug, please check:"
43227 #: ../src/guestfs.pod:3332
43228 msgid "That the bug hasn't been reported already."
43232 #: ../src/guestfs.pod:3336
43233 msgid "That you are testing a recent version."
43237 #: ../src/guestfs.pod:3340
43238 msgid "Describe the bug accurately, and give a way to reproduce it."
43242 #: ../src/guestfs.pod:3344
43244 "Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
43249 #: ../test-tool/libguestfs-test-tool.pod:5
43250 msgid "libguestfs-test-tool - Diagnostics for libguestfs"
43254 #: ../test-tool/libguestfs-test-tool.pod:9
43257 " libguestfs-test-tool [--options]\n"
43262 #: ../test-tool/libguestfs-test-tool.pod:13
43264 "libguestfs-test-tool is a test program shipped with libguestfs to allow you "
43265 "to check basic libguestfs functionality is working. This is needed because "
43266 "libguestfs occasionally breaks for reasons beyond our control: usually "
43267 "because of changes in the underlying qemu or kernel packages, or the host "
43272 #: ../test-tool/libguestfs-test-tool.pod:19
43273 msgid "If you suspect a problem in libguestfs, then just run:"
43277 #: ../test-tool/libguestfs-test-tool.pod:21
43280 " libguestfs-test-tool\n"
43285 #: ../test-tool/libguestfs-test-tool.pod:23
43286 msgid "It will print lots of diagnostic messages."
43290 #: ../test-tool/libguestfs-test-tool.pod:25
43291 msgid "If it runs to completion successfully, you will see this near the end:"
43295 #: ../test-tool/libguestfs-test-tool.pod:27
43298 " ===== TEST FINISHED OK =====\n"
43303 #: ../test-tool/libguestfs-test-tool.pod:29
43304 msgid "and the test tool will exit with code 0."
43308 #: ../test-tool/libguestfs-test-tool.pod:31
43310 "If it fails (and/or exits with non-zero error code), please paste the "
43311 "I<complete, unedited> output of the test tool into a bug report. More "
43312 "information about reporting bugs can be found on the L<http://libguestfs.org/"
43317 #: ../test-tool/libguestfs-test-tool.pod:42
43318 msgid "Display short usage information and exit."
43322 #: ../test-tool/libguestfs-test-tool.pod:44
43323 msgid "B<--qemu qemu_binary>"
43327 #: ../test-tool/libguestfs-test-tool.pod:46
43329 "If you have downloaded another qemu binary, point this option at the full "
43330 "path of the binary to try it."
43334 #: ../test-tool/libguestfs-test-tool.pod:49
43335 msgid "B<--qemudir qemu_source_dir>"
43339 #: ../test-tool/libguestfs-test-tool.pod:51
43341 "If you have compiled qemu from source, point this option at the source "
43342 "directory to try it."
43346 #: ../test-tool/libguestfs-test-tool.pod:54
43351 #: ../test-tool/libguestfs-test-tool.pod:56
43352 msgid "B<--timeout N>"
43356 #: ../test-tool/libguestfs-test-tool.pod:58
43358 "Set the launch timeout to C<N> seconds. The default is 600 seconds (10 "
43359 "minutes) which does not usually need to be adjusted."
43363 #: ../test-tool/libguestfs-test-tool.pod:63
43364 msgid "TRYING OUT A DIFFERENT VERSION OF QEMU"
43368 #: ../test-tool/libguestfs-test-tool.pod:65
43370 "If you have compiled another version of qemu from source and would like to "
43371 "try that, then you can use the I<--qemudir> option to point to the qemu "
43372 "source directory."
43376 #: ../test-tool/libguestfs-test-tool.pod:69
43378 "If you have downloaded a qemu binary from somewhere, use the I<--qemu> "
43379 "option to point to the binary."
43383 #: ../test-tool/libguestfs-test-tool.pod:72
43385 "Note when using these options, you can ignore the business of qemu wrapper "
43386 "scripts (L<guestfs(3)/QEMU WRAPPERS>), since libguestfs-test-tool writes a "
43387 "wrapper script for you if one is needed."
43391 #: ../test-tool/libguestfs-test-tool.pod:76
43392 msgid "TRYING OUT A DIFFERENT KERNEL"
43396 #: ../test-tool/libguestfs-test-tool.pod:78
43398 "If you are using febootstrap E<ge> 3.8 then you can select which kernel "
43399 "libguestfs tries. You do this by setting the environment variables "
43400 "C<FEBOOTSTRAP_KERNEL> and/or C<FEBOOTSTRAP_MODULES>."
43404 #: ../test-tool/libguestfs-test-tool.pod:82
43406 "Refer to L<febootstrap-supermin-helper(8)/ENVIRONMENT VARIABLES> for further "
43411 #: ../test-tool/libguestfs-test-tool.pod:85
43412 msgid "SELF-DIAGNOSIS"
43416 #: ../test-tool/libguestfs-test-tool.pod:87
43418 "Refer to L<guestfs(3)/APPLIANCE BOOT PROCESS> to understand the messages "
43419 "produced by libguestfs-test-tool and/or possible errors."
43423 #: ../test-tool/libguestfs-test-tool.pod:92
43425 "libguestfs-test-tool returns I<0> if the tests completed without error, or "
43426 "I<1> if there was an error."
43430 #: ../test-tool/libguestfs-test-tool.pod:97
43432 "For the full list of environment variables which may affect libguestfs, "
43433 "please see the L<guestfs(3)> manual page."
43437 #: ../test-tool/libguestfs-test-tool.pod:102
43438 msgid "L<guestfs(3)>, L<http://libguestfs.org/>, L<http://qemu.org/>."
43442 #: ../tools/virt-list-filesystems.pl:32
43444 "virt-list-filesystems - List filesystems in a virtual machine or disk image"
43448 #: ../tools/virt-list-filesystems.pl:36
43451 " virt-list-filesystems [--options] domname\n"
43456 #: ../tools/virt-list-filesystems.pl:38
43459 " virt-list-filesystems [--options] disk.img [disk.img ...]\n"
43464 #: ../tools/virt-list-filesystems.pl:42 ../tools/virt-list-partitions.pl:42
43466 "This tool is obsolete. Use L<virt-filesystems(1)> as a more flexible "
43471 #: ../tools/virt-list-filesystems.pl:45
43473 "C<virt-list-filesystems> is a command line tool to list the filesystems that "
43474 "are contained in a virtual machine or disk image."
43478 #: ../tools/virt-list-filesystems.pl:49
43480 "C<virt-list-filesystems> is just a simple wrapper around L<libguestfs(3)> "
43481 "functionality. For more complex cases you should look at the L<guestfish(1)"
43486 #: ../tools/virt-list-filesystems.pl:112
43488 "With this option, C<virt-list-filesystems> displays the type of each "
43489 "filesystem too (where \"type\" means C<ext3>, C<xfs> etc.)"
43493 #: ../tools/virt-list-filesystems.pl:119
43498 #: ../tools/virt-list-filesystems.pl:123
43500 "Normally we only show mountable filesystems. If this option is given then "
43501 "swap devices are shown too."
43505 #: ../tools/virt-list-filesystems.pl:197
43507 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
43508 "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
43509 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
43511 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
43512 "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
43513 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
43516 #: ../tools/virt-list-filesystems.pl:214 ../tools/virt-tar.pl:317
43517 msgid "Copyright (C) 2009 Red Hat Inc."
43518 msgstr "© Red Hat Inc., 2009"
43521 #: ../tools/virt-list-partitions.pl:32
43523 "virt-list-partitions - List partitions in a virtual machine or disk image"
43527 #: ../tools/virt-list-partitions.pl:36
43530 " virt-list-partitions [--options] domname\n"
43533 " virt-list-partitions [--параметри] назва_домену\n"
43537 #: ../tools/virt-list-partitions.pl:38
43540 " virt-list-partitions [--options] disk.img [disk.img ...]\n"
43543 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
43547 #: ../tools/virt-list-partitions.pl:45
43549 "C<virt-list-partitions> is a command line tool to list the partitions that "
43550 "are contained in a virtual machine or disk image. It is mainly useful as a "
43551 "first step to using L<virt-resize(1)>."
43555 #: ../tools/virt-list-partitions.pl:50
43557 "C<virt-list-partitions> is just a simple wrapper around L<libguestfs(3)> "
43558 "functionality. For more complex cases you should look at the L<guestfish(1)"
43563 #: ../tools/virt-list-partitions.pl:113
43564 msgid "Show sizes in human-readable form (eg. \"1G\")."
43568 #: ../tools/virt-list-partitions.pl:123
43570 "With this option, C<virt-list-partitions> displays the type and size of each "
43571 "partition too (where \"type\" means C<ext3>, C<pv> etc.)"
43575 #: ../tools/virt-list-partitions.pl:130
43580 #: ../tools/virt-list-partitions.pl:132
43582 msgstr "B<--total>"
43585 #: ../tools/virt-list-partitions.pl:134
43587 "Display the total size of each block device (as a separate row or rows)."
43591 #: ../tools/virt-list-partitions.pl:267
43593 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
43594 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
43595 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
43597 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
43598 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
43599 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
43602 #: ../tools/virt-list-partitions.pl:283
43603 msgid "Copyright (C) 2009-2010 Red Hat Inc."
43604 msgstr "© Red Hat Inc., 2009–2010"
43607 #: ../tools/virt-make-fs.pl:37
43608 msgid "virt-make-fs - Make a filesystem from a tar archive or files"
43612 #: ../tools/virt-make-fs.pl:41
43615 " virt-make-fs [--options] input.tar output.img\n"
43620 #: ../tools/virt-make-fs.pl:43
43623 " virt-make-fs [--options] input.tar.gz output.img\n"
43628 #: ../tools/virt-make-fs.pl:45
43631 " virt-make-fs [--options] directory output.img\n"
43636 #: ../tools/virt-make-fs.pl:49
43638 "Virt-make-fs is a command line tool for creating a filesystem from a tar "
43639 "archive or some files in a directory. It is similar to tools like L<mkisofs"
43640 "(1)>, L<genisoimage(1)> and L<mksquashfs(1)>. Unlike those tools, it can "
43641 "create common filesystem types like ext2/3 or NTFS, which can be useful if "
43642 "you want to attach these filesystems to existing virtual machines (eg. to "
43643 "import large amounts of read-only data to a VM)."
43647 #: ../tools/virt-make-fs.pl:57
43648 msgid "Basic usage is:"
43652 #: ../tools/virt-make-fs.pl:59
43655 " virt-make-fs input output.img\n"
43660 #: ../tools/virt-make-fs.pl:61
43662 "where C<input> is either a directory containing files that you want to add, "
43663 "or a tar archive (either uncompressed tar or gzip-compressed tar); and "
43664 "C<output.img> is a disk image. The input type is detected automatically. "
43665 "The output disk image defaults to a raw ext2 sparse image unless you specify "
43666 "extra flags (see L</OPTIONS> below)."
43670 #: ../tools/virt-make-fs.pl:67
43671 msgid "FILESYSTEM TYPE"
43672 msgstr "ТИП ФАЙЛОВОЇ СИСТЕМИ"
43675 #: ../tools/virt-make-fs.pl:69
43677 "The default filesystem type is C<ext2>. Just about any filesystem type that "
43678 "libguestfs supports can be used (but I<not> read-only formats like "
43679 "ISO9660). Here are some of the more common choices:"
43683 #: ../tools/virt-make-fs.pl:75
43688 #: ../tools/virt-make-fs.pl:77
43690 "Note that ext3 filesystems contain a journal, typically 1-32 MB in size. If "
43691 "you are not going to use the filesystem in a way that requires the journal, "
43692 "then this is just wasted overhead."
43696 #: ../tools/virt-make-fs.pl:81
43697 msgid "I<ntfs> or I<vfat>"
43698 msgstr "I<ntfs> або I<vfat>"
43701 #: ../tools/virt-make-fs.pl:83
43702 msgid "Useful if exporting data to a Windows guest."
43706 #: ../tools/virt-make-fs.pl:85
43708 "I<Note for vfat>: The tar archive or local directory must only contain files "
43709 "which are owned by root (ie. UID:GID = 0:0). The reason is that the tar "
43710 "program running within libguestfs is unable to change the ownership of non-"
43711 "root files, since vfat itself does not support this."
43715 #: ../tools/virt-make-fs.pl:90
43720 #: ../tools/virt-make-fs.pl:92
43722 "Lower overhead than C<ext2>, but certain limitations on filename length and "
43723 "total filesystem size."
43727 #: ../tools/virt-make-fs.pl:97 ../tools/virt-make-fs.pl:116
43728 #: ../tools/virt-make-fs.pl:149
43733 #: ../tools/virt-make-fs.pl:99
43736 " virt-make-fs --type=minix input minixfs.img\n"
43741 #: ../tools/virt-make-fs.pl:101
43742 msgid "TO PARTITION OR NOT TO PARTITION"
43746 #: ../tools/virt-make-fs.pl:103
43747 msgid "Optionally virt-make-fs can add a partition table to the output disk."
43751 #: ../tools/virt-make-fs.pl:105
43753 "Adding a partition can make the disk image more compatible with certain "
43754 "virtualized operating systems which don't expect to see a filesystem "
43755 "directly located on a block device (Linux doesn't care and will happily "
43756 "handle both types)."
43760 #: ../tools/virt-make-fs.pl:110
43762 "On the other hand, if you have a partition table then the output image is no "
43763 "longer a straight filesystem. For example you cannot run L<fsck(8)> "
43764 "directly on a partitioned disk image. (However libguestfs tools such as "
43765 "L<guestfish(1)> and L<virt-resize(1)> can still be used)."
43769 #: ../tools/virt-make-fs.pl:118
43770 msgid "Add an MBR partition:"
43774 #: ../tools/virt-make-fs.pl:120
43777 " virt-make-fs --partition -- input disk.img\n"
43782 #: ../tools/virt-make-fs.pl:122
43784 "If the output disk image could be terabyte-sized or larger, it's better to "
43785 "use an EFI/GPT-compatible partition table:"
43789 #: ../tools/virt-make-fs.pl:125
43792 " virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n"
43797 #: ../tools/virt-make-fs.pl:127
43798 msgid "EXTRA SPACE"
43802 #: ../tools/virt-make-fs.pl:129
43804 "Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" "
43805 "the files that it contains, but might have extra space. Depending on how "
43806 "you are going to use the output, you might think this extra space is wasted "
43807 "and want to minimize it, or you might want to leave space so that more files "
43808 "can be added later. Virt-make-fs defaults to minimizing the extra space, "
43809 "but you can use the I<--size> flag to leave space in the filesystem if you "
43814 #: ../tools/virt-make-fs.pl:137
43816 "An alternative way to leave extra space but not make the output image any "
43817 "bigger is to use an alternative disk image format (instead of the default "
43818 "\"raw\" format). Using I<--format=qcow2> will use the native QEmu/KVM qcow2 "
43819 "image format (check your hypervisor supports this before using it). This "
43820 "allows you to choose a large I<--size> but the extra space won't actually be "
43821 "allocated in the image until you try to store something in it."
43825 #: ../tools/virt-make-fs.pl:145
43827 "Don't forget that you can also use local commands including L<resize2fs(8)> "
43828 "and L<virt-resize(1)> to resize existing filesystems, or rerun virt-make-fs "
43829 "to build another image from scratch."
43833 #: ../tools/virt-make-fs.pl:151
43836 " virt-make-fs --format=qcow2 --size=+200M input output.img\n"
43839 " virt-make-fs --format=qcow2 --size=+200M input output.img\n"
43843 #: ../tools/virt-make-fs.pl:179
43844 msgid "Enable debugging information."
43845 msgstr "Увімкнути виведення діагностичних даних."
43848 #: ../tools/virt-make-fs.pl:185
43849 msgid "B<--size=E<lt>NE<gt>>"
43850 msgstr "B<--size=E<lt>NE<gt>>"
43853 #: ../tools/virt-make-fs.pl:187
43854 msgid "B<--size=+E<lt>NE<gt>>"
43855 msgstr "B<--size=+E<lt>NE<gt>>"
43858 #: ../tools/virt-make-fs.pl:189
43859 msgid "B<-s E<lt>NE<gt>>"
43860 msgstr "B<-s E<lt>NE<gt>>"
43863 #: ../tools/virt-make-fs.pl:191
43864 msgid "B<-s +E<lt>NE<gt>>"
43865 msgstr "B<-s +E<lt>NE<gt>>"
43868 #: ../tools/virt-make-fs.pl:193
43870 "Use the I<--size> (or I<-s>) option to choose the size of the output image."
43874 #: ../tools/virt-make-fs.pl:196
43876 "If this option is I<not> given, then the output image will be just large "
43877 "enough to contain all the files, with not much wasted space."
43881 #: ../tools/virt-make-fs.pl:199
43883 "To choose a fixed size output disk, specify an absolute number followed by b/"
43884 "K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
43885 "Petabytes or Exabytes. This must be large enough to contain all the input "
43886 "files, else you will get an error."
43890 #: ../tools/virt-make-fs.pl:204
43892 "To leave extra space, specify C<+> (plus sign) and a number followed by b/K/"
43893 "M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
43894 "Petabytes or Exabytes. For example: I<--size=+200M> means enough space for "
43895 "the input files, and (approximately) an extra 200 MB free space."
43899 #: ../tools/virt-make-fs.pl:210
43901 "Note that virt-make-fs estimates free space, and therefore will not produce "
43902 "filesystems containing precisely the free space requested. (It is much more "
43903 "expensive and time-consuming to produce a filesystem which has precisely the "
43904 "desired free space)."
43908 #: ../tools/virt-make-fs.pl:219
43909 msgid "B<--format=E<lt>fmtE<gt>>"
43913 #: ../tools/virt-make-fs.pl:221
43914 msgid "B<-F E<lt>fmtE<gt>>"
43918 #: ../tools/virt-make-fs.pl:223
43919 msgid "Choose the output disk image format."
43923 #: ../tools/virt-make-fs.pl:225
43924 msgid "The default is C<raw> (raw sparse disk image)."
43928 #: ../tools/virt-make-fs.pl:227
43930 "For other choices, see the L<qemu-img(1)> manpage. The only other choice "
43931 "that would really make sense here is C<qcow2>."
43935 #: ../tools/virt-make-fs.pl:234
43936 msgid "B<--type=E<lt>fsE<gt>>"
43940 #: ../tools/virt-make-fs.pl:236
43941 msgid "B<-t E<lt>fsE<gt>>"
43945 #: ../tools/virt-make-fs.pl:238
43946 msgid "Choose the output filesystem type."
43950 #: ../tools/virt-make-fs.pl:240
43951 msgid "The default is C<ext2>."
43952 msgstr "Типовим значенням є C<ext2>."
43955 #: ../tools/virt-make-fs.pl:242
43957 "Any filesystem which is supported read-write by libguestfs can be used here."
43961 #: ../tools/virt-make-fs.pl:249
43962 msgid "B<--partition>"
43963 msgstr "B<--partition>"
43966 #: ../tools/virt-make-fs.pl:251
43967 msgid "B<--partition=E<lt>parttypeE<gt>>"
43971 #: ../tools/virt-make-fs.pl:253
43973 "If specified, this flag adds an MBR partition table to the output disk image."
43977 #: ../tools/virt-make-fs.pl:256
43979 "You can change the partition table type, eg. I<--partition=gpt> for large "
43984 #: ../tools/virt-make-fs.pl:259
43986 "Note that if you just use a lonesome I<--partition>, the Perl option parser "
43987 "might consider the next parameter to be the partition type. For example:"
43991 #: ../tools/virt-make-fs.pl:263
43994 " virt-make-fs --partition input.tar output.img\n"
43999 #: ../tools/virt-make-fs.pl:265
44001 "would cause virt-make-fs to think you wanted to use a partition type of "
44002 "C<input.tar> which is completely wrong. To avoid this, use I<--> (a double "
44003 "dash) between options and the input and output arguments:"
44007 #: ../tools/virt-make-fs.pl:269
44010 " virt-make-fs --partition -- input.tar output.img\n"
44015 #: ../tools/virt-make-fs.pl:271
44016 msgid "For MBR, virt-make-fs sets the partition type byte automatically."
44020 #: ../tools/virt-make-fs.pl:559
44022 "L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar-in(1)>, L<mkisofs(1)>, "
44023 "L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, L<guestfs"
44024 "(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>."
44026 "L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar-in(1)>, L<mkisofs(1)>, "
44027 "L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, L<guestfs"
44028 "(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>."
44031 #: ../tools/virt-make-fs.pl:573 ../tools/virt-win-reg.pl:774
44033 "When reporting bugs, please enable debugging and capture the I<complete> "
44038 #: ../tools/virt-make-fs.pl:576
44041 " export LIBGUESTFS_DEBUG=1\n"
44042 " virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n"
44045 " export LIBGUESTFS_DEBUG=1\n"
44046 " virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n"
44050 #: ../tools/virt-make-fs.pl:579
44052 "Attach /tmp/virt-make-fs.log to a new bug report at L<https://bugzilla."
44057 #: ../tools/virt-tar.pl:33
44058 msgid "virt-tar - Extract or upload files to a virtual machine"
44062 #: ../tools/virt-tar.pl:37
44065 " virt-tar [--options] -x domname directory tarball\n"
44070 #: ../tools/virt-tar.pl:39
44073 " virt-tar [--options] -u domname tarball directory\n"
44078 #: ../tools/virt-tar.pl:41
44081 " virt-tar [--options] disk.img [disk.img ...] -x directory tarball\n"
44086 #: ../tools/virt-tar.pl:43
44089 " virt-tar [--options] disk.img [disk.img ...] -u tarball directory\n"
44094 #: ../tools/virt-tar.pl:45 ../tools/virt-win-reg.pl:88
44099 #: ../tools/virt-tar.pl:47
44101 "This tool is obsolete. Use L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-"
44102 "tar-in(1)>, L<virt-tar-out(1)> as replacements."
44106 #: ../tools/virt-tar.pl:52
44107 msgid "Download C</home> from the VM into a local tarball:"
44111 #: ../tools/virt-tar.pl:54
44114 " virt-tar -x domname /home home.tar\n"
44119 #: ../tools/virt-tar.pl:56
44122 " virt-tar -zx domname /home home.tar.gz\n"
44127 #: ../tools/virt-tar.pl:58
44128 msgid "Upload a local tarball and unpack it inside C</tmp> in the VM:"
44132 #: ../tools/virt-tar.pl:60
44135 " virt-tar -u domname uploadstuff.tar /tmp\n"
44140 #: ../tools/virt-tar.pl:62
44143 " virt-tar -zu domname uploadstuff.tar.gz /tmp\n"
44148 #: ../tools/virt-tar.pl:66
44150 "You must I<not> use C<virt-tar> with the I<-u> option (upload) on live "
44151 "virtual machines. If you do this, you risk disk corruption in the VM. "
44152 "C<virt-tar> tries to stop you from doing this, but doesn't catch all cases."
44156 #: ../tools/virt-tar.pl:71
44158 "You can use I<-x> (extract) on live virtual machines, but you might get "
44159 "inconsistent results or errors if there is filesystem activity inside the "
44160 "VM. If the live VM is synched and quiescent, then C<virt-tar> will usually "
44161 "work, but the only way to guarantee consistent results is if the virtual "
44162 "machine is shut down."
44166 #: ../tools/virt-tar.pl:79
44168 "C<virt-tar> is a general purpose archive tool for downloading and uploading "
44169 "parts of a guest filesystem. There are many possibilities: making backups, "
44170 "uploading data files, snooping on guest activity, fixing or customizing "
44175 #: ../tools/virt-tar.pl:84
44177 "If you want to just view a single file, use L<virt-cat(1)>. If you just "
44178 "want to edit a single file, use L<virt-edit(1)>. For more complex cases you "
44179 "should look at the L<guestfish(1)> tool."
44183 #: ../tools/virt-tar.pl:88
44185 "There are two modes of operation: I<-x> (eXtract) downloads a directory and "
44186 "its contents (recursively) from the virtual machine into a local tarball. "
44187 "I<-u> uploads from a local tarball, unpacking it into a directory inside the "
44188 "virtual machine. You cannot use these two options together."
44192 #: ../tools/virt-tar.pl:94
44194 "In addition, you may need to use the I<-z> (gZip) option to enable "
44195 "compression. When uploading, you have to specify I<-z> if the upload file "
44196 "is compressed because virt-tar won't detect this on its own."
44200 #: ../tools/virt-tar.pl:98
44202 "C<virt-tar> can only handle tar (optionally gzipped) format tarballs. For "
44203 "example it cannot do PKZip files or bzip2 compression. If you want that "
44204 "then you'll have to rebuild the tarballs yourself. (This is a limitation of "
44205 "the L<libguestfs(3)> API)."
44209 #: ../tools/virt-tar.pl:160
44210 msgid "B<--extract>"
44211 msgstr "B<--extract>"
44214 #: ../tools/virt-tar.pl:162
44215 msgid "B<--download>"
44216 msgstr "B<--download>"
44219 #: ../tools/virt-tar.pl:164
44224 #: ../tools/virt-tar.pl:166
44225 msgid "B<--upload>"
44226 msgstr "B<--upload>"
44229 #: ../tools/virt-tar.pl:168
44231 "Use I<-x> to extract (download) a directory from a virtual machine to a "
44236 #: ../tools/virt-tar.pl:171
44238 "Use I<-u> to upload and unpack from a local tarball into a virtual machine. "
44239 "Please read the L</WARNING> section above before using this option."
44243 #: ../tools/virt-tar.pl:175
44244 msgid "You must specify exactly one of these options."
44248 #: ../tools/virt-tar.pl:181
44253 #: ../tools/virt-tar.pl:183
44258 #: ../tools/virt-tar.pl:185
44259 msgid "Specify that the input or output tarball is gzip-compressed."
44263 #: ../tools/virt-tar.pl:298
44265 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-copy-"
44266 "in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<Sys::"
44267 "Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs."
44270 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-copy-"
44271 "in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<Sys::"
44272 "Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs."
44276 #: ../tools/virt-win-reg.pl:37
44278 "virt-win-reg - Export and merge Windows Registry entries from a Windows guest"
44282 #: ../tools/virt-win-reg.pl:41
44285 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n"
44290 #: ../tools/virt-win-reg.pl:43
44293 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n"
44298 #: ../tools/virt-win-reg.pl:45
44301 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n"
44306 #: ../tools/virt-win-reg.pl:47
44309 " virt-win-reg --merge domname [input.reg ...]\n"
44314 #: ../tools/virt-win-reg.pl:49
44317 " virt-win-reg [--options] disk.img ... # instead of domname\n"
44322 #: ../tools/virt-win-reg.pl:53
44324 "You must I<not> use C<virt-win-reg> with the I<--merge> option on live "
44325 "virtual machines. If you do this, you I<will> get irreversible disk "
44326 "corruption in the VM. C<virt-win-reg> tries to stop you from doing this, "
44327 "but doesn't catch all cases."
44331 #: ../tools/virt-win-reg.pl:58
44333 "Modifying the Windows Registry is an inherently risky operation. The format "
44334 "is deliberately obscure and undocumented, and Registry changes can leave the "
44335 "system unbootable. Therefore when using the I<--merge> option, make sure "
44336 "you have a reliable backup first."
44340 #: ../tools/virt-win-reg.pl:65
44342 "This program can export and merge Windows Registry entries from a Windows "
44347 #: ../tools/virt-win-reg.pl:68
44349 "The first parameter is the libvirt guest name or the raw disk image of a "
44354 #: ../tools/virt-win-reg.pl:71
44356 "If I<--merge> is I<not> specified, then the chosen registry key is displayed/"
44357 "exported (recursively). For example:"
44361 #: ../tools/virt-win-reg.pl:74
44364 " $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n"
44367 " $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n"
44371 #: ../tools/virt-win-reg.pl:76
44373 "You can also display single values from within registry keys, for example:"
44377 #: ../tools/virt-win-reg.pl:79
44380 " $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n"
44381 " $ virt-win-reg Windows7 $cvkey ProductName\n"
44382 " Windows 7 Enterprise\n"
44385 " $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n"
44386 " $ virt-win-reg Windows7 $cvkey ProductName\n"
44387 " Windows 7 Enterprise\n"
44391 #: ../tools/virt-win-reg.pl:83
44393 "With I<--merge>, you can merge a textual regedit file into the Windows "
44398 #: ../tools/virt-win-reg.pl:86
44401 " $ virt-win-reg --merge Windows7 changes.reg\n"
44404 " $ virt-win-reg --merge Windows7 changes.reg\n"
44408 #: ../tools/virt-win-reg.pl:90
44410 "This program is only meant for simple access to the registry. If you want "
44411 "to do complicated things with the registry, we suggest you download the "
44412 "Registry hive files from the guest using L<libguestfs(3)> or L<guestfish(1)> "
44413 "and access them locally, eg. using L<hivex(3)>, L<hivexsh(1)> or "
44414 "L<hivexregedit(1)>."
44418 #: ../tools/virt-win-reg.pl:159
44420 msgstr "B<--merge>"
44423 #: ../tools/virt-win-reg.pl:161
44425 "In merge mode, this merges a textual regedit file into the Windows Registry "
44426 "of the virtual machine. If this flag is I<not> given then virt-win-reg "
44427 "displays or exports Registry entries instead."
44431 #: ../tools/virt-win-reg.pl:165
44433 "Note that I<--merge> is I<unsafe> to use on live virtual machines, and will "
44434 "result in disk corruption. However exporting (without this flag) is always "
44439 #: ../tools/virt-win-reg.pl:173
44440 msgid "B<--encoding> UTF-16LE|ASCII"
44441 msgstr "B<--encoding> UTF-16LE|ASCII"
44444 #: ../tools/virt-win-reg.pl:175
44446 "When merging (only), you may need to specify the encoding for strings to be "
44447 "used in the hive file. This is explained in detail in L<Win::Hivex::Regedit"
44448 "(3)/ENCODING STRINGS>."
44452 #: ../tools/virt-win-reg.pl:179
44454 "The default is to use UTF-16LE, which should work with recent versions of "
44459 #: ../tools/virt-win-reg.pl:186
44460 msgid "B<--unsafe-printable-strings>"
44461 msgstr "B<--unsafe-printable-strings>"
44464 #: ../tools/virt-win-reg.pl:188
44466 "When exporting (only), assume strings are UTF-16LE and print them as strings "
44467 "instead of hex sequences. Remove the final zero codepoint from strings if "
44472 #: ../tools/virt-win-reg.pl:192
44474 "This is unsafe and does not preserve the fidelity of strings in the original "
44475 "Registry for various reasons:"
44479 #: ../tools/virt-win-reg.pl:199
44481 "Assumes the original encoding is UTF-16LE. ASCII strings and strings in "
44482 "other encodings will be corrupted by this transformation."
44486 #: ../tools/virt-win-reg.pl:204
44488 "Assumes that everything which has type 1 or 2 is really a string and that "
44489 "everything else is not a string, but the type field in real Registries is "
44494 #: ../tools/virt-win-reg.pl:210
44496 "Loses information about whether a zero codepoint followed the string in the "
44501 #: ../tools/virt-win-reg.pl:215
44503 "This all happens because the Registry itself contains no information about "
44504 "how strings are encoded (see L<Win::Hivex::Regedit(3)/ENCODING STRINGS>)."
44508 #: ../tools/virt-win-reg.pl:219
44510 "You should only use this option for quick hacking and debugging of the "
44511 "Registry contents, and I<never> use it if the output is going to be passed "
44512 "into another program or stored in another Registry."
44516 #: ../tools/virt-win-reg.pl:556
44517 msgid "SUPPORTED SYSTEMS"
44518 msgstr "ПІДТРИМУВАНІ СИСТЕМИ"
44521 #: ../tools/virt-win-reg.pl:558
44523 "The program currently supports Windows NT-derived guests starting with "
44524 "Windows XP through to at least Windows 7."
44528 #: ../tools/virt-win-reg.pl:561
44529 msgid "The following Registry keys are supported:"
44533 #: ../tools/virt-win-reg.pl:565
44534 msgid "C<HKEY_LOCAL_MACHINE\\SAM>"
44535 msgstr "C<HKEY_LOCAL_MACHINE\\SAM>"
44538 #: ../tools/virt-win-reg.pl:567
44539 msgid "C<HKEY_LOCAL_MACHINE\\SECURITY>"
44540 msgstr "C<HKEY_LOCAL_MACHINE\\SECURITY>"
44543 #: ../tools/virt-win-reg.pl:569
44544 msgid "C<HKEY_LOCAL_MACHINE\\SOFTWARE>"
44545 msgstr "C<HKEY_LOCAL_MACHINE\\SOFTWARE>"
44548 #: ../tools/virt-win-reg.pl:571
44549 msgid "C<HKEY_LOCAL_MACHINE\\SYSTEM>"
44550 msgstr "C<HKEY_LOCAL_MACHINE\\SYSTEM>"
44553 #: ../tools/virt-win-reg.pl:573
44554 msgid "C<HKEY_USERS\\.DEFAULT>"
44555 msgstr "C<HKEY_USERS\\.DEFAULT>"
44558 #: ../tools/virt-win-reg.pl:575
44559 msgid "C<HKEY_USERS\\I<SID>>"
44560 msgstr "C<HKEY_USERS\\I<SID>>"
44563 #: ../tools/virt-win-reg.pl:577
44564 msgid "where I<SID> is a Windows User SID (eg. C<S-1-5-18>)."
44568 #: ../tools/virt-win-reg.pl:579
44569 msgid "C<HKEY_USERS\\I<username>>"
44570 msgstr "C<HKEY_USERS\\I<користувач>>"
44573 #: ../tools/virt-win-reg.pl:581
44575 "where I<username> is a local user name (this is a libguestfs extension)."
44579 #: ../tools/virt-win-reg.pl:585
44581 "You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for "
44586 #: ../tools/virt-win-reg.pl:588
44588 "The literal keys C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are not "
44589 "supported (there is no \"current user\")."
44593 #: ../tools/virt-win-reg.pl:591
44598 #: ../tools/virt-win-reg.pl:593
44600 "C<virt-win-reg> expects that regedit files have already been reencoded in "
44601 "the local encoding. Usually on Linux hosts, this means UTF-8 with Unix-"
44602 "style line endings. Since Windows regedit files are often in UTF-16LE with "
44603 "Windows-style line endings, you may need to reencode the whole file before "
44604 "or after processing."
44608 #: ../tools/virt-win-reg.pl:599
44610 "To reencode a file from Windows format to Linux (before processing it with "
44611 "the I<--merge> option), you would do something like this:"
44615 #: ../tools/virt-win-reg.pl:602
44618 " iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n"
44621 " iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n"
44625 #: ../tools/virt-win-reg.pl:604
44627 "To go in the opposite direction, after exporting and before sending the file "
44628 "to a Windows user, do something like this:"
44632 #: ../tools/virt-win-reg.pl:607
44635 " unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n"
44638 " unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n"
44642 #: ../tools/virt-win-reg.pl:609
44643 msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>."
44647 #: ../tools/virt-win-reg.pl:611
44649 "If you are unsure about the current encoding, use the L<file(1)> command. "
44650 "Recent versions of Windows regedit.exe produce a UTF-16LE file with Windows-"
44651 "style (CRLF) line endings, like this:"
44655 #: ../tools/virt-win-reg.pl:615
44658 " $ file software.reg\n"
44659 " software.reg: Little-endian UTF-16 Unicode text, with very long lines,\n"
44660 " with CRLF line terminators\n"
44665 #: ../tools/virt-win-reg.pl:619
44666 msgid "This file would need conversion before you could I<--merge> it."
44670 #: ../tools/virt-win-reg.pl:621
44671 msgid "CurrentControlSet etc."
44675 #: ../tools/virt-win-reg.pl:623
44677 "Registry keys like C<CurrentControlSet> don't really exist in the Windows "
44678 "Registry at the level of the hive file, and therefore you cannot modify "
44683 #: ../tools/virt-win-reg.pl:627
44685 "C<CurrentControlSet> is usually an alias for C<ControlSet001>. In some "
44686 "circumstances it might refer to another control set. The way to find out is "
44687 "to look at the C<HKLM\\SYSTEM\\Select> key:"
44691 #: ../tools/virt-win-reg.pl:631
44694 " # virt-win-reg WindowsGuest 'HKLM\\SYSTEM\\Select'\n"
44695 " [HKEY_LOCAL_MACHINE\\SYSTEM\\Select]\n"
44696 " \"Current\"=dword:00000001\n"
44697 " \"Default\"=dword:00000001\n"
44698 " \"Failed\"=dword:00000000\n"
44699 " \"LastKnownGood\"=dword:00000002\n"
44702 " # virt-win-reg WindowsGuest 'HKLM\\SYSTEM\\Select'\n"
44703 " [HKEY_LOCAL_MACHINE\\SYSTEM\\Select]\n"
44704 " \"Current\"=dword:00000001\n"
44705 " \"Default\"=dword:00000001\n"
44706 " \"Failed\"=dword:00000000\n"
44707 " \"LastKnownGood\"=dword:00000002\n"
44711 #: ../tools/virt-win-reg.pl:638
44712 msgid "\"Current\" is the one which Windows will choose when it boots."
44716 #: ../tools/virt-win-reg.pl:640
44718 "Similarly, other C<Current...> keys in the path may need to be replaced."
44722 #: ../tools/virt-win-reg.pl:643
44723 msgid "DELETING REGISTRY KEYS AND VALUES"
44727 #: ../tools/virt-win-reg.pl:645
44728 msgid "To delete a whole registry key, use the syntax:"
44732 #: ../tools/virt-win-reg.pl:647
44735 " [-HKEY_LOCAL_MACHINE\\Foo]\n"
44740 #: ../tools/virt-win-reg.pl:649
44741 msgid "To delete a single value within a key, use the syntax:"
44745 #: ../tools/virt-win-reg.pl:651
44748 " [HKEY_LOCAL_MACHINE\\Foo]\n"
44754 #: ../tools/virt-win-reg.pl:654
44755 msgid "WINDOWS TIPS"
44759 #: ../tools/virt-win-reg.pl:656
44761 "Note that some of these tips modify the guest disk image. The guest I<must> "
44762 "be shut off, else you will get disk corruption."
44766 #: ../tools/virt-win-reg.pl:659
44767 msgid "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN"
44771 #: ../tools/virt-win-reg.pl:661
44773 "Prepare a DOS batch script, VBScript or executable. Upload this using "
44774 "L<guestfish(1)>. For this example the script is called C<test.bat> and it "
44775 "is uploaded into C<C:\\>:"
44779 #: ../tools/virt-win-reg.pl:665
44782 " guestfish -i -d WindowsGuest upload test.bat /test.bat\n"
44785 " guestfish -i -d WindowsGuest upload test.bat /test.bat\n"
44789 #: ../tools/virt-win-reg.pl:667
44790 msgid "Prepare a regedit file containing the registry change:"
44794 #: ../tools/virt-win-reg.pl:669
44797 " cat > test.reg <<'EOF'\n"
44798 " [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n"
44799 " \"Test\"=\"c:\\\\test.bat\"\n"
44803 " cat > test.reg <<'EOF'\n"
44804 " [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n"
44805 " \"Test\"=\"c:\\\\test.bat\"\n"
44810 #: ../tools/virt-win-reg.pl:674
44812 "In this example we use the key C<RunOnce> which means that the script will "
44813 "run precisely once when the first user logs in. If you want it to run every "
44814 "time a user logs in, replace C<RunOnce> with C<Run>."
44818 #: ../tools/virt-win-reg.pl:678
44819 msgid "Now update the registry:"
44820 msgstr "Оновіть регістр:"
44823 #: ../tools/virt-win-reg.pl:680
44826 " virt-win-reg --merge WindowsGuest test.reg\n"
44831 #: ../tools/virt-win-reg.pl:682
44832 msgid "INSTALLING A SERVICE"
44836 #: ../tools/virt-win-reg.pl:684
44838 "This section assumes you are familiar with Windows services, and you either "
44839 "have a program which handles the Windows Service Control Protocol directly "
44840 "or you want to run any program using a service wrapper like SrvAny or the "
44845 #: ../tools/virt-win-reg.pl:689
44847 "First upload the program and optionally the service wrapper. In this case "
44848 "the test program is called C<test.exe> and we are using the RHSrvAny wrapper:"
44852 #: ../tools/virt-win-reg.pl:693
44855 " guestfish -i -d WindowsGuest <<EOF\n"
44856 " upload rhsrvany.exe /rhsrvany.exe\n"
44857 " upload test.exe /test.exe\n"
44861 " guestfish -i -d WindowsGuest <<EOF\n"
44862 " upload rhsrvany.exe /rhsrvany.exe\n"
44863 " upload test.exe /test.exe\n"
44868 #: ../tools/virt-win-reg.pl:698
44870 "Prepare a regedit file containing the registry changes. In this example, "
44871 "the first registry change is needed for the service itself or the service "
44872 "wrapper (if used). The second registry change is only needed because I am "
44873 "using the RHSrvAny service wrapper."
44877 #: ../tools/virt-win-reg.pl:703
44880 " cat > service.reg <<'EOF'\n"
44881 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny]\n"
44882 " \"Type\"=dword:00000010\n"
44883 " \"Start\"=dword:00000002\n"
44884 " \"ErrorControl\"=dword:00000001\n"
44885 " \"ImagePath\"=\"c:\\\\rhsrvany.exe\"\n"
44886 " \"DisplayName\"=\"RHSrvAny\"\n"
44887 " \"ObjectName\"=\"NetworkService\"\n"
44890 " cat > service.reg <<'EOF'\n"
44891 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny]\n"
44892 " \"Type\"=dword:00000010\n"
44893 " \"Start\"=dword:00000002\n"
44894 " \"ErrorControl\"=dword:00000001\n"
44895 " \"ImagePath\"=\"c:\\\\rhsrvany.exe\"\n"
44896 " \"DisplayName\"=\"RHSrvAny\"\n"
44897 " \"ObjectName\"=\"NetworkService\"\n"
44901 #: ../tools/virt-win-reg.pl:712
44904 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n"
44905 " \"CommandLine\"=\"c:\\\\test.exe\"\n"
44906 " \"PWD\"=\"c:\\\\Temp\"\n"
44910 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n"
44911 " \"CommandLine\"=\"c:\\\\test.exe\"\n"
44912 " \"PWD\"=\"c:\\\\Temp\"\n"
44917 #: ../tools/virt-win-reg.pl:723
44919 "For use of C<ControlSet001> see the section above in this manual page. You "
44920 "may need to adjust this according to the control set that is in use by the "
44925 #: ../tools/virt-win-reg.pl:729
44927 "C<\"ObjectName\"> controls the privileges that the service will have. An "
44928 "alternative is C<\"ObjectName\"=\"LocalSystem\"> which would be the most "
44929 "privileged account."
44933 #: ../tools/virt-win-reg.pl:735
44935 "For the meaning of the magic numbers, see this Microsoft KB article: "
44936 "L<http://support.microsoft.com/kb/103000>."
44940 #: ../tools/virt-win-reg.pl:740
44941 msgid "Update the registry:"
44942 msgstr "Оновіть регістр:"
44945 #: ../tools/virt-win-reg.pl:742
44948 " virt-win-reg --merge WindowsGuest service.reg\n"
44953 #: ../tools/virt-win-reg.pl:746
44955 "Be careful when passing parameters containing C<\\> (backslash) in the "
44956 "shell. Usually you will have to use 'single quotes' or double backslashes "
44957 "(but not both) to protect them from the shell."
44961 #: ../tools/virt-win-reg.pl:750
44962 msgid "Paths and value names are case-insensitive."
44966 #: ../tools/virt-win-reg.pl:759
44968 "L<hivex(3)>, L<hivexsh(1)>, L<hivexregedit(1)>, L<guestfs(3)>, L<guestfish(1)"
44969 ">, L<virt-cat(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Win::Hivex"
44970 "(3)>, L<Win::Hivex::Regedit(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
44972 "L<hivex(3)>, L<hivexsh(1)>, L<hivexregedit(1)>, L<guestfs(3)>, L<guestfish(1)"
44973 ">, L<virt-cat(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Win::Hivex"
44974 "(3)>, L<Win::Hivex::Regedit(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
44977 #: ../tools/virt-win-reg.pl:777
44980 " export LIBGUESTFS_DEBUG=1\n"
44981 " virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n"
44986 #: ../tools/virt-win-reg.pl:780
44988 "Attach /tmp/virt-win-reg.log to a new bug report at L<https://bugzilla."