Version 1.15.5.
[libguestfs.git] / po-docs / uk.po
1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Red Hat Inc.
3 # This file is distributed under the same license as the libguestfs package.
4 #
5 # Translators:
6 # Yuri Chornoivan <yurchor@ukr.net>, 2011.
7 msgid ""
8 msgstr ""
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"
15 "Language: uk\n"
16 "MIME-Version: 1.0\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"
21
22 #. type: =head1
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
40 msgid "NAME"
41 msgstr "НАЗВА"
42
43 #. type: textblock
44 #: ../align/virt-alignment-scan.pod:5
45 msgid "virt-alignment-scan - Check alignment of virtual machine partitions"
46 msgstr ""
47
48 #. type: =head1
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
65 msgid "SYNOPSIS"
66 msgstr "КОРОТКИЙ ОПИС"
67
68 #. type: verbatim
69 #: ../align/virt-alignment-scan.pod:9
70 #, no-wrap
71 msgid ""
72 " virt-alignment-scan [--options] -d domname\n"
73 "\n"
74 msgstr ""
75
76 #. type: verbatim
77 #: ../align/virt-alignment-scan.pod:11
78 #, no-wrap
79 msgid ""
80 " virt-alignment-scan [--options] -a disk.img [-a disk.img ...]\n"
81 "\n"
82 msgstr ""
83
84 #. type: =head1
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
103 msgid "DESCRIPTION"
104 msgstr "ОПИС"
105
106 #. type: textblock
107 #: ../align/virt-alignment-scan.pod:15
108 msgid ""
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 "
113 "necessary."
114 msgstr ""
115
116 #. type: textblock
117 #: ../align/virt-alignment-scan.pod:21
118 msgid ""
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."
121 msgstr ""
122
123 #. type: textblock
124 #: ../align/virt-alignment-scan.pod:25
125 msgid ""
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>"
130 msgstr ""
131
132 #. type: =head1
133 #: ../align/virt-alignment-scan.pod:30
134 msgid "OUTPUT"
135 msgstr ""
136
137 #. type: textblock
138 #: ../align/virt-alignment-scan.pod:32
139 msgid "To run this tool on a disk image directly, use the I<-a> option:"
140 msgstr ""
141
142 #. type: verbatim
143 #: ../align/virt-alignment-scan.pod:34
144 #, no-wrap
145 msgid ""
146 " $ virt-alignment-scan -a winxp.img\n"
147 " /dev/sda1        32256          512    bad (alignment < 4K)\n"
148 "\n"
149 msgstr ""
150
151 #. type: verbatim
152 #: ../align/virt-alignment-scan.pod:37
153 #, no-wrap
154 msgid ""
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"
159 "\n"
160 msgstr ""
161
162 #. type: textblock
163 #: ../align/virt-alignment-scan.pod:42
164 msgid ""
165 "To run the tool on a guest known to libvirt, use the I<-d> option and "
166 "possibly the I<-c> option:"
167 msgstr ""
168
169 #. type: verbatim
170 #: ../align/virt-alignment-scan.pod:45
171 #, no-wrap
172 msgid ""
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"
176 "\n"
177 msgstr ""
178
179 #. type: verbatim
180 #: ../align/virt-alignment-scan.pod:49
181 #, no-wrap
182 msgid ""
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"
187 "\n"
188 msgstr ""
189
190 #. type: textblock
191 #: ../align/virt-alignment-scan.pod:54
192 msgid ""
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.  "
195 "The columns are:"
196 msgstr ""
197
198 #. type: =item
199 #: ../align/virt-alignment-scan.pod:60
200 msgid "col 1"
201 msgstr ""
202
203 #. type: textblock
204 #: ../align/virt-alignment-scan.pod:62
205 msgid ""
206 "the device and partition name (eg. C</dev/sda1> meaning the first partition "
207 "on the first block device)"
208 msgstr ""
209
210 #. type: =item
211 #: ../align/virt-alignment-scan.pod:65
212 msgid "col 2"
213 msgstr ""
214
215 #. type: textblock
216 #: ../align/virt-alignment-scan.pod:67
217 msgid "the start of the partition in bytes"
218 msgstr ""
219
220 #. type: =item
221 #: ../align/virt-alignment-scan.pod:69
222 msgid "col 3"
223 msgstr ""
224
225 #. type: textblock
226 #: ../align/virt-alignment-scan.pod:71
227 msgid "the alignment in bytes or Kbytes (eg. C<512> or C<4K>)"
228 msgstr ""
229
230 #. type: =item
231 #: ../align/virt-alignment-scan.pod:73
232 msgid "col 4"
233 msgstr ""
234
235 #. type: textblock
236 #: ../align/virt-alignment-scan.pod:75
237 msgid ""
238 "C<ok> if the alignment is best for performance, or C<bad> if the alignment "
239 "can cause performance problems"
240 msgstr ""
241
242 #. type: =item
243 #: ../align/virt-alignment-scan.pod:78
244 msgid "cols 5+"
245 msgstr ""
246
247 #. type: textblock
248 #: ../align/virt-alignment-scan.pod:80
249 msgid "optional free-text explanation."
250 msgstr ""
251
252 #. type: textblock
253 #: ../align/virt-alignment-scan.pod:84
254 msgid ""
255 "The exit code from the program changes depending on whether poorly aligned "
256 "partitions were found.  See L</EXIT STATUS> below."
257 msgstr ""
258
259 #. type: textblock
260 #: ../align/virt-alignment-scan.pod:87
261 msgid "If you just want the exit code with no output, use the I<-q> option."
262 msgstr ""
263
264 #. type: =head1
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
277 msgid "OPTIONS"
278 msgstr "ПАРАМЕТРИ"
279
280 #. type: =item
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
291 msgid "B<--help>"
292 msgstr "B<--help>"
293
294 #. type: textblock
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 "Показати коротку довідку."
304
305 #. type: =item
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
310 msgid "B<-a> file"
311 msgstr "B<-a> файл"
312
313 #. type: =item
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> файл"
320
321 #. type: textblock
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."
324 msgstr ""
325
326 #. type: textblock
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
332 msgid ""
333 "The format of the disk image is auto-detected.  To override this and force a "
334 "particular format use the I<--format=..> option."
335 msgstr ""
336
337 #. type: =item
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
342 msgid "B<-c> URI"
343 msgstr "B<-c> адреса"
344
345 #. type: =item
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> адреса"
352
353 #. type: textblock
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
360 msgid ""
361 "If using libvirt, connect to the given I<URI>.  If omitted, then we connect "
362 "to the default libvirt hypervisor."
363 msgstr ""
364
365 #. type: textblock
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
370 msgid ""
371 "If you specify guest block devices directly (I<-a>), then libvirt is not "
372 "used at all."
373 msgstr ""
374
375 #. type: =item
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
380 msgid "B<-d> guest"
381 msgstr "B<-d> гість"
382
383 #. type: =item
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> гість"
390
391 #. type: textblock
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
396 msgid ""
397 "Add all the disks from the named libvirt guest.  Domain UUIDs can be used "
398 "instead of names."
399 msgstr ""
400
401 #. type: =item
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|..>"
409
410 #. type: =item
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
417 msgid "B<--format>"
418 msgstr "B<--format>"
419
420 #. type: textblock
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
426 msgid ""
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."
431 msgstr ""
432
433 #. type: textblock
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
440 msgid "For example:"
441 msgstr "Приклад:"
442
443 #. type: verbatim
444 #: ../align/virt-alignment-scan.pod:134
445 #, no-wrap
446 msgid ""
447 " virt-alignment-scan --format=raw -a disk.img\n"
448 "\n"
449 msgstr ""
450
451 #. type: textblock
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>."
458 msgstr ""
459
460 #. type: verbatim
461 #: ../align/virt-alignment-scan.pod:138
462 #, no-wrap
463 msgid ""
464 " virt-alignment-scan --format=raw -a disk.img --format -a another.img\n"
465 "\n"
466 msgstr ""
467
468 #. type: textblock
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
474 msgid ""
475 "forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
476 "detection for C<another.img>."
477 msgstr ""
478
479 #. type: textblock
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
484 msgid ""
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)."
488 msgstr ""
489
490 #. type: =item
491 #: ../align/virt-alignment-scan.pod:147 ../resize/virt-resize.pod:491
492 #: ../sparsify/virt-sparsify.pod:153
493 msgid "B<-q>"
494 msgstr "B<-q>"
495
496 #. type: =item
497 #: ../align/virt-alignment-scan.pod:149 ../resize/virt-resize.pod:493
498 #: ../sparsify/virt-sparsify.pod:155
499 msgid "B<--quiet>"
500 msgstr "B<--quiet>"
501
502 #. type: textblock
503 #: ../align/virt-alignment-scan.pod:151
504 msgid ""
505 "Don't produce any output.  Just set the exit code (see L</EXIT STATUS> "
506 "below)."
507 msgstr ""
508
509 #. type: =item
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
516 msgid "B<-v>"
517 msgstr "B<-v>"
518
519 #. type: =item
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
526 msgid "B<--verbose>"
527 msgstr "B<--verbose>"
528
529 #. type: textblock
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."
536 msgstr ""
537
538 #. type: =item
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
546 msgid "B<-V>"
547 msgstr "B<-V>"
548
549 #. type: =item
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
559 msgid "B<--version>"
560 msgstr "B<--version>"
561
562 #. type: textblock
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 "Показати дані щодо версії і завершити роботу."
573
574 #. type: =item
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
582 msgid "B<-x>"
583 msgstr "B<-x>"
584
585 #. type: textblock
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."
592 msgstr ""
593
594 #. type: =head1
595 #: ../align/virt-alignment-scan.pod:172
596 msgid "RECOMMENDED ALIGNMENT"
597 msgstr ""
598
599 #. type: textblock
600 #: ../align/virt-alignment-scan.pod:174
601 msgid ""
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 "
609 "63."
610 msgstr ""
611
612 #. type: textblock
613 #: ../align/virt-alignment-scan.pod:183
614 msgid ""
615 "When the guest OS is virtualized, the host operating system and hypervisor "
616 "may prefer accesses aligned to one of:"
617 msgstr ""
618
619 #. type: =item
620 #: ../align/virt-alignment-scan.pod:188
621 msgid "* 512 bytes"
622 msgstr ""
623
624 #. type: textblock
625 #: ../align/virt-alignment-scan.pod:190
626 msgid ""
627 "if the host OS uses local storage directly on hard drive partitions, and the "
628 "hard drive has 512 byte physical sectors."
629 msgstr ""
630
631 #. type: =item
632 #: ../align/virt-alignment-scan.pod:193
633 msgid "* 4 Kbytes"
634 msgstr ""
635
636 #. type: textblock
637 #: ../align/virt-alignment-scan.pod:195
638 msgid ""
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."
642 msgstr ""
643
644 #. type: =item
645 #: ../align/virt-alignment-scan.pod:199
646 msgid "* 64 Kbytes"
647 msgstr ""
648
649 #. type: textblock
650 #: ../align/virt-alignment-scan.pod:201
651 msgid ""
652 "for high-end network-attached storage.  This is the optimal block size for "
653 "some NetApp hardware."
654 msgstr ""
655
656 #. type: =item
657 #: ../align/virt-alignment-scan.pod:204
658 msgid "* 1 Mbyte"
659 msgstr ""
660
661 #. type: textblock
662 #: ../align/virt-alignment-scan.pod:206
663 msgid "see L</1 MB PARTITION ALIGNMENT> below."
664 msgstr ""
665
666 #. type: textblock
667 #: ../align/virt-alignment-scan.pod:210
668 msgid ""
669 "Partitions which are not aligned correctly to the underlying storage cause "
670 "extra I/O.  For example:"
671 msgstr ""
672
673 #. type: verbatim
674 #: ../align/virt-alignment-scan.pod:213
675 #, no-wrap
676 msgid ""
677 "                       sect#63\n"
678 "                       +--------------------------+------\n"
679 "                       |         guest            |\n"
680 "                       |    filesystem block      |\n"
681 " ---+------------------+------+-------------------+-----+---\n"
682 "    |  host block             |  host block             |\n"
683 "    |                         |                         |\n"
684 " ---+-------------------------+-------------------------+---\n"
685 "\n"
686 msgstr ""
687
688 #. type: textblock
689 #: ../align/virt-alignment-scan.pod:222
690 msgid ""
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)."
695 msgstr ""
696
697 #. type: =head2
698 #: ../align/virt-alignment-scan.pod:227
699 msgid "LINUX HOST BLOCK AND I/O SIZE"
700 msgstr ""
701
702 #. type: textblock
703 #: ../align/virt-alignment-scan.pod:229
704 msgid ""
705 "New versions of the Linux kernel expose the physical and logical block size, "
706 "and minimum and recommended I/O size."
707 msgstr ""
708
709 #. type: textblock
710 #: ../align/virt-alignment-scan.pod:232
711 msgid "For a typical consumer hard drive with 512 byte sectors:"
712 msgstr ""
713
714 #. type: verbatim
715 #: ../align/virt-alignment-scan.pod:234
716 #, no-wrap
717 msgid ""
718 " $ cat /sys/block/sda/queue/hw_sector_size\n"
719 " 512\n"
720 " $ cat /sys/block/sda/queue/physical_block_size\n"
721 " 512\n"
722 " $ cat /sys/block/sda/queue/logical_block_size\n"
723 " 512\n"
724 " $ cat /sys/block/sda/queue/minimum_io_size\n"
725 " 512\n"
726 " $ cat /sys/block/sda/queue/optimal_io_size\n"
727 " 0\n"
728 "\n"
729 msgstr ""
730
731 #. type: textblock
732 #: ../align/virt-alignment-scan.pod:245
733 msgid "For a new consumer hard drive with 4Kbyte sectors:"
734 msgstr ""
735
736 #. type: verbatim
737 #: ../align/virt-alignment-scan.pod:247
738 #, no-wrap
739 msgid ""
740 " $ cat /sys/block/sda/queue/hw_sector_size\n"
741 " 4096\n"
742 " $ cat /sys/block/sda/queue/physical_block_size\n"
743 " 4096\n"
744 " $ cat /sys/block/sda/queue/logical_block_size\n"
745 " 4096\n"
746 " $ cat /sys/block/sda/queue/minimum_io_size\n"
747 " 4096\n"
748 " $ cat /sys/block/sda/queue/optimal_io_size\n"
749 " 0\n"
750 "\n"
751 msgstr ""
752
753 #. type: textblock
754 #: ../align/virt-alignment-scan.pod:258
755 msgid "For a NetApp LUN:"
756 msgstr ""
757
758 #. type: verbatim
759 #: ../align/virt-alignment-scan.pod:260
760 #, no-wrap
761 msgid ""
762 " $ cat /sys/block/sdc/queue/logical_block_size\n"
763 " 512\n"
764 " $ cat /sys/block/sdc/queue/physical_block_size\n"
765 " 512\n"
766 " $ cat /sys/block/sdc/queue/minimum_io_size\n"
767 " 4096\n"
768 " $ cat /sys/block/sdc/queue/optimal_io_size\n"
769 " 65536\n"
770 "\n"
771 msgstr ""
772
773 #. type: textblock
774 #: ../align/virt-alignment-scan.pod:269
775 msgid ""
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."
778 msgstr ""
779
780 #. type: textblock
781 #: ../align/virt-alignment-scan.pod:273
782 msgid ""
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>"
786 msgstr ""
787
788 #. type: textblock
789 #: ../align/virt-alignment-scan.pod:276
790 msgid ""
791 "[Thanks to Matt Booth for providing 4K drive data.  Thanks to Mike Snitzer "
792 "for providing NetApp data and additional information.]"
793 msgstr ""
794
795 #. type: =head2
796 #: ../align/virt-alignment-scan.pod:279
797 msgid "1 MB PARTITION ALIGNMENT"
798 msgstr ""
799
800 #. type: textblock
801 #: ../align/virt-alignment-scan.pod:281
802 msgid ""
803 "Microsoft picked 1 MB as the default alignment for all partitions starting "
804 "with Windows 2008 Server, and Linux has followed this."
805 msgstr ""
806
807 #. type: textblock
808 #: ../align/virt-alignment-scan.pod:284
809 msgid ""
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."
813 msgstr ""
814
815 #. type: textblock
816 #: ../align/virt-alignment-scan.pod:288
817 msgid ""
818 "1 MB alignment is compatible with all current alignment requirements (4K, "
819 "64K) and provides room for future growth in physical block sizes."
820 msgstr ""
821
822 #. type: =head2
823 #: ../align/virt-alignment-scan.pod:291
824 msgid "SETTING ALIGNMENT"
825 msgstr ""
826
827 #. type: textblock
828 #: ../align/virt-alignment-scan.pod:293
829 msgid ""
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."
835 msgstr ""
836
837 #. type: textblock
838 #: ../align/virt-alignment-scan.pod:299
839 msgid ""
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."
843 msgstr ""
844
845 #. type: textblock
846 #: ../align/virt-alignment-scan.pod:303
847 msgid ""
848 "For older versions of Windows, the following NetApp document contains useful "
849 "information: L<http://media.netapp.com/documents/tr-3747.pdf>"
850 msgstr ""
851
852 #. type: textblock
853 #: ../align/virt-alignment-scan.pod:306
854 msgid ""
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."
859 msgstr ""
860
861 #. type: =head1
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"
871 msgstr ""
872
873 #. type: textblock
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
882 msgid ""
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"
886 "(1)> for details."
887 msgstr ""
888
889 #. type: =head1
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
897 msgid "EXIT STATUS"
898 msgstr ""
899
900 #. type: textblock
901 #: ../align/virt-alignment-scan.pod:320
902 msgid "This program returns:"
903 msgstr ""
904
905 #. type: =item
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
983 msgid "*"
984 msgstr "*"
985
986 #. type: textblock
987 #: ../align/virt-alignment-scan.pod:326
988 msgid "0"
989 msgstr ""
990
991 #. type: textblock
992 #: ../align/virt-alignment-scan.pod:328
993 msgid ""
994 "successful exit, all partitions are aligned E<ge> 64K for best performance"
995 msgstr ""
996
997 #. type: textblock
998 #: ../align/virt-alignment-scan.pod:332
999 msgid "1"
1000 msgstr ""
1001
1002 #. type: textblock
1003 #: ../align/virt-alignment-scan.pod:334
1004 msgid "an error scanning the disk image or guest"
1005 msgstr ""
1006
1007 #. type: textblock
1008 #: ../align/virt-alignment-scan.pod:338
1009 msgid "2"
1010 msgstr ""
1011
1012 #. type: textblock
1013 #: ../align/virt-alignment-scan.pod:340
1014 msgid ""
1015 "successful exit, some partitions have alignment E<lt> 64K which can result "
1016 "in poor performance on high end network storage"
1017 msgstr ""
1018
1019 #. type: textblock
1020 #: ../align/virt-alignment-scan.pod:345
1021 msgid "3"
1022 msgstr ""
1023
1024 #. type: textblock
1025 #: ../align/virt-alignment-scan.pod:347
1026 msgid ""
1027 "successful exit, some partitions have alignment E<lt> 4K which can result in "
1028 "poor performance on most hypervisors"
1029 msgstr ""
1030
1031 #. type: =head1
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
1050 msgid "SEE ALSO"
1051 msgstr "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
1052
1053 #. type: textblock
1054 #: ../align/virt-alignment-scan.pod:354
1055 msgid ""
1056 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-rescue(1)>, "
1057 "L<virt-resize(1)>, L<http://libguestfs.org/>."
1058 msgstr ""
1059
1060 #. type: =head1
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
1069 msgid "AUTHOR"
1070 msgstr "АВТОР"
1071
1072 #. type: textblock
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/>"
1083
1084 #. type: =head1
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
1103 msgid "COPYRIGHT"
1104 msgstr "АВТОРСЬКІ ПРАВА"
1105
1106 #. type: textblock
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."
1110 msgstr ""
1111
1112 #. type: textblock
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
1125 msgid ""
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."
1130 msgstr ""
1131
1132 #. type: textblock
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
1145 msgid ""
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 "
1149 "more details."
1150 msgstr ""
1151 "Ця програма поширюється у сподіванні, що вона буде корисною, але БЕЗ БУДЬ-"
1152 "ЯКИХ ГАРАНТІЙНИХ ЗОБОВ’ЯЗАНЬ; навіть без очевидної гарантії ПРАЦЕЗДАТНОСТІ "
1153 "або ПРИДАТНОСТІ ДЛЯ ВИКОРИСТАННЯ З ПЕВНОЮ МЕТОЮ. Докладніше про це можна "
1154 "дізнатися з GNU General Public License."
1155
1156 #. type: textblock
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
1169 msgid ""
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."
1173 msgstr ""
1174 "Ви маєте отримати копію GNU General Public License разом з цією програмою; "
1175 "якщо це не так, повідомте про факт за адресою Free Software Foundation, "
1176 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA."
1177
1178 #. type: textblock
1179 #: ../cat/virt-cat.pod:5
1180 msgid "virt-cat - Display files in a virtual machine"
1181 msgstr "virt-cat — показ файлів у віртуальній машині"
1182
1183 #. type: verbatim
1184 #: ../cat/virt-cat.pod:9
1185 #, no-wrap
1186 msgid ""
1187 " virt-cat [--options] -d domname file [file ...]\n"
1188 "\n"
1189 msgstr ""
1190 " virt-cat [--параметри] -d назва_домену файл [файл...]\n"
1191 "\n"
1192
1193 #. type: verbatim
1194 #: ../cat/virt-cat.pod:11
1195 #, no-wrap
1196 msgid ""
1197 " virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
1198 "\n"
1199 msgstr ""
1200 " virt-cat [--параметри] -a диск.img [-a диск.img ...] файл [файл...]\n"
1201 "\n"
1202
1203 #. type: textblock
1204 #: ../cat/virt-cat.pod:13 ../edit/virt-edit.pod:15
1205 #: ../inspector/virt-inspector.pod:13
1206 msgid "Old-style:"
1207 msgstr "Застарілий стиль:"
1208
1209 #. type: verbatim
1210 #: ../cat/virt-cat.pod:15
1211 #, no-wrap
1212 msgid ""
1213 " virt-cat domname file\n"
1214 "\n"
1215 msgstr ""
1216 " virt-cat назва_домену файл\n"
1217 "\n"
1218
1219 #. type: verbatim
1220 #: ../cat/virt-cat.pod:17
1221 #, no-wrap
1222 msgid ""
1223 " virt-cat disk.img file\n"
1224 "\n"
1225 msgstr ""
1226 " virt-cat диск.img файл\n"
1227 "\n"
1228
1229 #. type: textblock
1230 #: ../cat/virt-cat.pod:21
1231 msgid ""
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)."
1234 msgstr ""
1235 "C<virt-cat> — інструмент командного рядка для показу вмісту C<файла>, який "
1236 "зберігається у вказаній віртуальній машині (або образі диска)."
1237
1238 #. type: textblock
1239 #: ../cat/virt-cat.pod:24
1240 msgid ""
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 '/')."
1244 msgstr ""
1245 "Ви можете вказати декілька назв файлів. Вміст таких файлів буде об’єднано. "
1246 "Назви файлів слід вказувати повністю (разом зі шляхом), починаючи з "
1247 "кореневого каталогу (тобто назва має починатися з «/»)."
1248
1249 #. type: textblock
1250 #: ../cat/virt-cat.pod:28
1251 msgid ""
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)."
1255 msgstr ""
1256 "C<virt-cat> можна скористатися для пришвидшення перегляду файла. Для "
1257 "редагування даних слід користуватися C<virt-edit>. Для виконання складніших "
1258 "дій можна скористатися програмою L<guestfish(1)> (див. L</USING GUESTFISH> "
1259 "нижче)."
1260
1261 #. type: =head1
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
1269 msgid "EXAMPLES"
1270 msgstr "ПРИКЛАДИ"
1271
1272 #. type: textblock
1273 #: ../cat/virt-cat.pod:34
1274 msgid ""
1275 "Display C</etc/fstab> file from inside the libvirt VM called C<mydomain>:"
1276 msgstr ""
1277 "Показ файла C</etc/fstab> з віртуальної машини libvirt з назвою C<mydomain>:"
1278
1279 #. type: verbatim
1280 #: ../cat/virt-cat.pod:37
1281 #, no-wrap
1282 msgid ""
1283 " virt-cat -d mydomain /etc/fstab\n"
1284 "\n"
1285 msgstr ""
1286 " virt-cat -d mydomain /etc/fstab\n"
1287 "\n"
1288
1289 #. type: textblock
1290 #: ../cat/virt-cat.pod:39
1291 msgid "List syslog messages from a VM disk image file:"
1292 msgstr ""
1293 "Показ списку повідомлень syslog з файла образу диска віртуальної машини:"
1294
1295 #. type: verbatim
1296 #: ../cat/virt-cat.pod:41
1297 #, no-wrap
1298 msgid ""
1299 " virt-cat -a disk.img /var/log/messages | tail\n"
1300 "\n"
1301 msgstr ""
1302 " virt-cat -a disk.img /var/log/messages | tail\n"
1303 "\n"
1304
1305 #. type: textblock
1306 #: ../cat/virt-cat.pod:43
1307 msgid "Find out what DHCP IP address a VM acquired:"
1308 msgstr "Визначення IP-адреси DHCP, використаної віртуальною машиною:"
1309
1310 #. type: verbatim
1311 #: ../cat/virt-cat.pod:45
1312 #, no-wrap
1313 msgid ""
1314 " virt-cat -d mydomain /var/log/messages | \\\n"
1315 "   grep 'dhclient: bound to' | tail\n"
1316 "\n"
1317 msgstr ""
1318 " virt-cat -d mydomain /var/log/messages | \\\n"
1319 "   grep 'dhclient: bound to' | tail\n"
1320 "\n"
1321
1322 #. type: textblock
1323 #: ../cat/virt-cat.pod:48
1324 msgid "Find out what packages were recently installed:"
1325 msgstr "Пошук нещодавно встановлених пакунків:"
1326
1327 #. type: verbatim
1328 #: ../cat/virt-cat.pod:50
1329 #, no-wrap
1330 msgid ""
1331 " virt-cat -d mydomain /var/log/yum.log | tail\n"
1332 "\n"
1333 msgstr ""
1334 " virt-cat -d mydomain /var/log/yum.log | tail\n"
1335 "\n"
1336
1337 #. type: textblock
1338 #: ../cat/virt-cat.pod:52
1339 msgid "Find out who is logged on inside a virtual machine:"
1340 msgstr "Визначення користувачів, які працюють у віртуальній машині:"
1341
1342 #. type: verbatim
1343 #: ../cat/virt-cat.pod:54
1344 #, no-wrap
1345 msgid ""
1346 " virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n"
1347 " who /tmp/utmp\n"
1348 "\n"
1349 msgstr ""
1350 " virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n"
1351 " who /tmp/utmp\n"
1352 "\n"
1353
1354 #. type: textblock
1355 #: ../cat/virt-cat.pod:57
1356 msgid "or who was logged on:"
1357 msgstr "або тих, які у ній працювали:"
1358
1359 #. type: verbatim
1360 #: ../cat/virt-cat.pod:59
1361 #, no-wrap
1362 msgid ""
1363 " virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n"
1364 " last -f /tmp/wtmp\n"
1365 "\n"
1366 msgstr ""
1367 " virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n"
1368 " last -f /tmp/wtmp\n"
1369 "\n"
1370
1371 #. type: textblock
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
1375 msgid ""
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."
1379 msgstr ""
1380
1381 #. type: =item
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>"
1387
1388 #. type: textblock
1389 #: ../cat/virt-cat.pod:100
1390 msgid ""
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."
1395 msgstr ""
1396
1397 #. type: verbatim
1398 #: ../cat/virt-cat.pod:116
1399 #, no-wrap
1400 msgid ""
1401 " virt-cat --format=raw -a disk.img file\n"
1402 "\n"
1403 msgstr ""
1404 " virt-cat --format=raw -a disk.img file\n"
1405 "\n"
1406
1407 #. type: verbatim
1408 #: ../cat/virt-cat.pod:120
1409 #, no-wrap
1410 msgid ""
1411 " virt-cat --format=raw -a disk.img --format -a another.img file\n"
1412 "\n"
1413 msgstr ""
1414 " virt-cat --format=raw -a disk.img --format -a another.img file\n"
1415 "\n"
1416
1417 #. type: =item
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>"
1423
1424 #. type: textblock
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
1428 msgid ""
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>."
1431 msgstr ""
1432
1433 #. type: =head1
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"
1437 msgstr ""
1438
1439 #. type: textblock
1440 #: ../cat/virt-cat.pod:154
1441 msgid "Previous versions of virt-cat allowed you to write either:"
1442 msgstr ""
1443
1444 #. type: verbatim
1445 #: ../cat/virt-cat.pod:156
1446 #, no-wrap
1447 msgid ""
1448 " virt-cat disk.img [disk.img ...] file\n"
1449 "\n"
1450 msgstr ""
1451
1452 #. type: textblock
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
1455 msgid "or"
1456 msgstr "або"
1457
1458 #. type: verbatim
1459 #: ../cat/virt-cat.pod:160
1460 #, no-wrap
1461 msgid ""
1462 " virt-cat guestname file\n"
1463 "\n"
1464 msgstr ""
1465
1466 #. type: textblock
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
1469 msgid ""
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."
1472 msgstr ""
1473
1474 #. type: textblock
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."
1478 msgstr ""
1479
1480 #. type: =head1
1481 #: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:257 ../fish/guestfish.pod:858
1482 msgid "WINDOWS PATHS"
1483 msgstr "ШЛЯХИ У WINDOWS"
1484
1485 #. type: textblock
1486 #: ../cat/virt-cat.pod:170
1487 msgid ""
1488 "C<virt-cat> has a limited ability to understand Windows drive letters and "
1489 "paths (eg. C<E:\\foo\\bar.txt>)."
1490 msgstr ""
1491
1492 #. type: textblock
1493 #: ../cat/virt-cat.pod:173 ../edit/virt-edit.pod:262
1494 msgid "If and only if the guest is running Windows then:"
1495 msgstr ""
1496
1497 #. type: textblock
1498 #: ../cat/virt-cat.pod:179 ../edit/virt-edit.pod:268
1499 msgid ""
1500 "Drive letter prefixes like C<C:> are resolved against the Windows Registry "
1501 "to the correct filesystem."
1502 msgstr ""
1503
1504 #. type: textblock
1505 #: ../cat/virt-cat.pod:184 ../edit/virt-edit.pod:273
1506 msgid ""
1507 "Any backslash (C<\\>) characters in the path are replaced with forward "
1508 "slashes so that libguestfs can process it."
1509 msgstr ""
1510
1511 #. type: textblock
1512 #: ../cat/virt-cat.pod:189
1513 msgid ""
1514 "The path is resolved case insensitively to locate the file that should be "
1515 "displayed."
1516 msgstr ""
1517
1518 #. type: textblock
1519 #: ../cat/virt-cat.pod:194 ../edit/virt-edit.pod:283
1520 msgid "There are some known shortcomings:"
1521 msgstr ""
1522
1523 #. type: textblock
1524 #: ../cat/virt-cat.pod:200 ../edit/virt-edit.pod:289
1525 msgid "Some NTFS symbolic links may not be followed correctly."
1526 msgstr ""
1527
1528 #. type: textblock
1529 #: ../cat/virt-cat.pod:204 ../edit/virt-edit.pod:293
1530 msgid "NTFS junction points that cross filesystems are not followed."
1531 msgstr ""
1532
1533 #. type: =head1
1534 #: ../cat/virt-cat.pod:208 ../edit/virt-edit.pod:297
1535 msgid "USING GUESTFISH"
1536 msgstr "ВИКОРИСТАННЯ GUESTFISH"
1537
1538 #. type: textblock
1539 #: ../cat/virt-cat.pod:210
1540 msgid ""
1541 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
1542 "C<virt-cat> doesn't work."
1543 msgstr ""
1544
1545 #. type: textblock
1546 #: ../cat/virt-cat.pod:213
1547 msgid "Using C<virt-cat> is approximately equivalent to doing:"
1548 msgstr ""
1549
1550 #. type: verbatim
1551 #: ../cat/virt-cat.pod:215
1552 #, no-wrap
1553 msgid ""
1554 " guestfish --ro -i -d domname download file -\n"
1555 "\n"
1556 msgstr ""
1557
1558 #. type: textblock
1559 #: ../cat/virt-cat.pod:217
1560 msgid ""
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\")."
1563 msgstr ""
1564
1565 #. type: textblock
1566 #: ../cat/virt-cat.pod:221
1567 msgid ""
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 "
1571 "directly, use:"
1572 msgstr ""
1573
1574 #. type: verbatim
1575 #: ../cat/virt-cat.pod:226
1576 #, no-wrap
1577 msgid ""
1578 " guestfish --ro -a disk.img -m /dev/sda1 download file -\n"
1579 "\n"
1580 msgstr ""
1581
1582 #. type: textblock
1583 #: ../cat/virt-cat.pod:228
1584 msgid ""
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."
1587 msgstr ""
1588
1589 #. type: textblock
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
1594 msgid ""
1595 "This program returns 0 if successful, or non-zero if there was an error."
1596 msgstr ""
1597
1598 #. type: textblock
1599 #: ../cat/virt-cat.pod:245
1600 msgid ""
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/>."
1603 msgstr ""
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/>."
1606
1607 #. type: textblock
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"
1612
1613 #. type: textblock
1614 #: ../cat/virt-filesystems.pod:5
1615 msgid ""
1616 "virt-filesystems - List filesystems, partitions, block devices, LVM in a "
1617 "virtual machine or disk image"
1618 msgstr ""
1619
1620 #. type: verbatim
1621 #: ../cat/virt-filesystems.pod:9
1622 #, no-wrap
1623 msgid ""
1624 " virt-filesystems [--options] -d domname\n"
1625 "\n"
1626 msgstr ""
1627 " virt-filesystems [--параметри] -d назва_домену\n"
1628 "\n"
1629
1630 #. type: verbatim
1631 #: ../cat/virt-filesystems.pod:11
1632 #, no-wrap
1633 msgid ""
1634 " virt-filesystems [--options] -a disk.img [-a disk.img ...]\n"
1635 "\n"
1636 msgstr ""
1637
1638 #. type: textblock
1639 #: ../cat/virt-filesystems.pod:15
1640 msgid ""
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)>."
1644 msgstr ""
1645
1646 #. type: textblock
1647 #: ../cat/virt-filesystems.pod:20
1648 msgid ""
1649 "One use for this tool is from shell scripts to iterate over all filesystems "
1650 "from a disk image:"
1651 msgstr ""
1652
1653 #. type: verbatim
1654 #: ../cat/virt-filesystems.pod:23
1655 #, no-wrap
1656 msgid ""
1657 " for fs in $(virt-filesystems -a disk.img); do\n"
1658 "   # ...\n"
1659 " done\n"
1660 "\n"
1661 msgstr ""
1662 " for fs in $(virt-filesystems -a disk.img); do\n"
1663 "   # ...\n"
1664 " done\n"
1665 "\n"
1666
1667 #. type: textblock
1668 #: ../cat/virt-filesystems.pod:27
1669 msgid ""
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)>."
1673 msgstr ""
1674
1675 #. type: textblock
1676 #: ../cat/virt-filesystems.pod:32
1677 msgid ""
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:"
1682 msgstr ""
1683
1684 #. type: verbatim
1685 #: ../cat/virt-filesystems.pod:37
1686 #, no-wrap
1687 msgid ""
1688 " $ virt-filesystems -a disk.img\n"
1689 " /dev/sda1\n"
1690 " /dev/vg_guest/lv_root\n"
1691 "\n"
1692 msgstr ""
1693 " $ virt-filesystems -a disk.img\n"
1694 " /dev/sda1\n"
1695 " /dev/vg_guest/lv_root\n"
1696 "\n"
1697
1698 #. type: textblock
1699 #: ../cat/virt-filesystems.pod:41
1700 msgid ""
1701 "If you add I<-l> or I<--long> then the output includes extra information:"
1702 msgstr ""
1703
1704 #. type: verbatim
1705 #: ../cat/virt-filesystems.pod:44
1706 #, no-wrap
1707 msgid ""
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"
1712 "\n"
1713 msgstr ""
1714
1715 #. type: textblock
1716 #: ../cat/virt-filesystems.pod:49
1717 msgid ""
1718 "If you add I<--extra> then non-mountable (swap, unknown) filesystems are "
1719 "shown as well:"
1720 msgstr ""
1721
1722 #. type: verbatim
1723 #: ../cat/virt-filesystems.pod:52
1724 #, no-wrap
1725 msgid ""
1726 " $ virt-filesystems -a disk.img --extra\n"
1727 " /dev/sda1\n"
1728 " /dev/vg_guest/lv_root\n"
1729 " /dev/vg_guest/lv_swap\n"
1730 " /dev/vg_guest/lv_data\n"
1731 "\n"
1732 msgstr ""
1733 " $ virt-filesystems -a disk.img --extra\n"
1734 " /dev/sda1\n"
1735 " /dev/vg_guest/lv_root\n"
1736 " /dev/vg_guest/lv_swap\n"
1737 " /dev/vg_guest/lv_data\n"
1738 "\n"
1739
1740 #. type: textblock
1741 #: ../cat/virt-filesystems.pod:58
1742 msgid ""
1743 "If you add I<--partitions> then partitions are shown instead of filesystems:"
1744 msgstr ""
1745
1746 #. type: verbatim
1747 #: ../cat/virt-filesystems.pod:60
1748 #, no-wrap
1749 msgid ""
1750 " $ virt-filesystems -a disk.img --partitions\n"
1751 " /dev/sda1\n"
1752 " /dev/sda2\n"
1753 "\n"
1754 msgstr ""
1755 " $ virt-filesystems -a disk.img --partitions\n"
1756 " /dev/sda1\n"
1757 " /dev/sda2\n"
1758 "\n"
1759
1760 #. type: textblock
1761 #: ../cat/virt-filesystems.pod:64
1762 msgid ""
1763 "Similarly you can use I<--logical-volumes>, I<--volume-groups>, I<--physical-"
1764 "volumes>, I<--block-devices> to list those items."
1765 msgstr ""
1766
1767 #. type: textblock
1768 #: ../cat/virt-filesystems.pod:67
1769 msgid ""
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."
1776 msgstr ""
1777
1778 #. type: textblock
1779 #: ../cat/virt-filesystems.pod:74
1780 msgid ""
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."
1783 msgstr ""
1784
1785 #. type: textblock
1786 #: ../cat/virt-filesystems.pod:78
1787 msgid ""
1788 "I<--all --long --uuid> is a useful combination to display all possible "
1789 "information about everything."
1790 msgstr ""
1791
1792 #. type: verbatim
1793 #: ../cat/virt-filesystems.pod:81
1794 #, no-wrap
1795 msgid ""
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"
1803 "\n"
1804 msgstr ""
1805
1806 #. type: textblock
1807 #: ../cat/virt-filesystems.pod:89
1808 msgid ""
1809 "For machine-readable output, use I<--csv> to get Comma-Separated Values."
1810 msgstr ""
1811
1812 #. type: =item
1813 #: ../cat/virt-filesystems.pod:110 ../tools/virt-list-filesystems.pl:121
1814 msgid "B<--all>"
1815 msgstr "B<--all>"
1816
1817 #. type: textblock
1818 #: ../cat/virt-filesystems.pod:112
1819 msgid ""
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)."
1824 msgstr ""
1825
1826 #. type: textblock
1827 #: ../cat/virt-filesystems.pod:117
1828 msgid "See also I<--long>."
1829 msgstr "Див. також I<--long>."
1830
1831 #. type: =item
1832 #: ../cat/virt-filesystems.pod:119
1833 msgid "B<--blkdevs>"
1834 msgstr "B<--blkdevs>"
1835
1836 #. type: =item
1837 #: ../cat/virt-filesystems.pod:121
1838 msgid "B<--block-devices>"
1839 msgstr "B<--block-devices>"
1840
1841 #. type: textblock
1842 #: ../cat/virt-filesystems.pod:123
1843 msgid "Display block devices."
1844 msgstr "Показати список блокових пристроїв."
1845
1846 #. type: =item
1847 #: ../cat/virt-filesystems.pod:135 ../cat/virt-ls.pod:301 ../df/virt-df.pod:88
1848 msgid "B<--csv>"
1849 msgstr "B<--csv>"
1850
1851 #. type: textblock
1852 #: ../cat/virt-filesystems.pod:137 ../cat/virt-ls.pod:303 ../df/virt-df.pod:90
1853 msgid ""
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."
1857 msgstr ""
1858
1859 #. type: textblock
1860 #: ../cat/virt-filesystems.pod:150
1861 msgid ""
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."
1866 msgstr ""
1867
1868 #. type: =item
1869 #: ../cat/virt-filesystems.pod:155
1870 msgid "B<--extra>"
1871 msgstr "B<--extra>"
1872
1873 #. type: textblock
1874 #: ../cat/virt-filesystems.pod:157
1875 msgid ""
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."
1879 msgstr ""
1880
1881 #. type: textblock
1882 #: ../cat/virt-filesystems.pod:161
1883 msgid "This option implies I<--filesystems>."
1884 msgstr ""
1885
1886 #. type: =item
1887 #: ../cat/virt-filesystems.pod:163
1888 msgid "B<--filesystems>"
1889 msgstr "B<--filesystems>"
1890
1891 #. type: textblock
1892 #: ../cat/virt-filesystems.pod:165
1893 msgid ""
1894 "Display mountable filesystems.  If no display option was selected then this "
1895 "option is implied."
1896 msgstr ""
1897
1898 #. type: textblock
1899 #: ../cat/virt-filesystems.pod:168
1900 msgid "With I<--extra>, non-mountable filesystems are shown too."
1901 msgstr ""
1902
1903 #. type: verbatim
1904 #: ../cat/virt-filesystems.pod:181
1905 #, no-wrap
1906 msgid ""
1907 " virt-filesystems --format=raw -a disk.img\n"
1908 "\n"
1909 msgstr ""
1910 " virt-filesystems --format=raw -a диск.img\n"
1911 "\n"
1912
1913 #. type: verbatim
1914 #: ../cat/virt-filesystems.pod:185
1915 #, no-wrap
1916 msgid ""
1917 " virt-filesystems --format=raw -a disk.img --format -a another.img\n"
1918 "\n"
1919 msgstr ""
1920
1921 #. type: =item
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
1925 msgid "B<-h>"
1926 msgstr "B<-h>"
1927
1928 #. type: =item
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>"
1933
1934 #. type: textblock
1935 #: ../cat/virt-filesystems.pod:198
1936 msgid "In I<--long> mode, display sizes in human-readable format."
1937 msgstr ""
1938
1939 #. type: =item
1940 #: ../cat/virt-filesystems.pod:205 ../cat/virt-ls.pod:366
1941 #: ../tools/virt-list-filesystems.pl:108 ../tools/virt-list-partitions.pl:119
1942 msgid "B<-l>"
1943 msgstr "B<-l>"
1944
1945 #. type: =item
1946 #: ../cat/virt-filesystems.pod:207 ../cat/virt-ls.pod:368
1947 #: ../tools/virt-list-filesystems.pl:110 ../tools/virt-list-partitions.pl:121
1948 msgid "B<--long>"
1949 msgstr "B<--long>"
1950
1951 #. type: textblock
1952 #: ../cat/virt-filesystems.pod:209
1953 msgid "Display extra columns of data (\"long format\")."
1954 msgstr ""
1955
1956 #. type: textblock
1957 #: ../cat/virt-filesystems.pod:211
1958 msgid "A title row is added unless you also specify I<--no-title>."
1959 msgstr ""
1960
1961 #. type: textblock
1962 #: ../cat/virt-filesystems.pod:213
1963 msgid ""
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 "
1967 "programs."
1968 msgstr ""
1969
1970 #. type: textblock
1971 #: ../cat/virt-filesystems.pod:218
1972 msgid ""
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>."
1975 msgstr ""
1976
1977 #. type: textblock
1978 #: ../cat/virt-filesystems.pod:221
1979 msgid "Use I<--uuid> to display UUIDs too."
1980 msgstr ""
1981
1982 #. type: =item
1983 #: ../cat/virt-filesystems.pod:223
1984 msgid "B<--lvs>"
1985 msgstr "B<--lvs>"
1986
1987 #. type: =item
1988 #: ../cat/virt-filesystems.pod:225
1989 msgid "B<--logvols>"
1990 msgstr "B<--logvols>"
1991
1992 #. type: =item
1993 #: ../cat/virt-filesystems.pod:227
1994 msgid "B<--logical-volumes>"
1995 msgstr "B<--logical-volumes>"
1996
1997 #. type: textblock
1998 #: ../cat/virt-filesystems.pod:229
1999 msgid ""
2000 "Display LVM logical volumes.  In this mode, these are displayed irrespective "
2001 "of whether the LVs contain filesystems."
2002 msgstr ""
2003
2004 #. type: =item
2005 #: ../cat/virt-filesystems.pod:232
2006 msgid "B<--no-title>"
2007 msgstr "B<--no-title>"
2008
2009 #. type: textblock
2010 #: ../cat/virt-filesystems.pod:234
2011 msgid "In I<--long> mode, don't add a title row."
2012 msgstr ""
2013
2014 #. type: textblock
2015 #: ../cat/virt-filesystems.pod:236
2016 msgid ""
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 "
2019 "surprises."
2020 msgstr ""
2021
2022 #. type: =item
2023 #: ../cat/virt-filesystems.pod:240
2024 msgid "B<--parts>"
2025 msgstr "B<--parts>"
2026
2027 #. type: =item
2028 #: ../cat/virt-filesystems.pod:242
2029 msgid "B<--partitions>"
2030 msgstr "B<--partitions>"
2031
2032 #. type: textblock
2033 #: ../cat/virt-filesystems.pod:244
2034 msgid ""
2035 "Display partitions.  In this mode, these are displayed irrespective of "
2036 "whether the partitions contain filesystems."
2037 msgstr ""
2038
2039 #. type: =item
2040 #: ../cat/virt-filesystems.pod:247
2041 msgid "B<--pvs>"
2042 msgstr "B<--pvs>"
2043
2044 #. type: =item
2045 #: ../cat/virt-filesystems.pod:249
2046 msgid "B<--physvols>"
2047 msgstr "B<--physvols>"
2048
2049 #. type: =item
2050 #: ../cat/virt-filesystems.pod:251
2051 msgid "B<--physical-volumes>"
2052 msgstr "B<--physical-volumes>"
2053
2054 #. type: textblock
2055 #: ../cat/virt-filesystems.pod:253
2056 msgid "Display LVM physical volumes."
2057 msgstr ""
2058
2059 #. type: =item
2060 #: ../cat/virt-filesystems.pod:255 ../df/virt-df.pod:163
2061 msgid "B<--uuid>"
2062 msgstr "B<--uuid>"
2063
2064 #. type: =item
2065 #: ../cat/virt-filesystems.pod:257
2066 msgid "B<--uuids>"
2067 msgstr "B<--uuids>"
2068
2069 #. type: textblock
2070 #: ../cat/virt-filesystems.pod:259
2071 msgid "In I<--long> mode, display UUIDs as well."
2072 msgstr ""
2073
2074 #. type: =item
2075 #: ../cat/virt-filesystems.pod:273
2076 msgid "B<--vgs>"
2077 msgstr "B<--vgs>"
2078
2079 #. type: =item
2080 #: ../cat/virt-filesystems.pod:275
2081 msgid "B<--volgroups>"
2082 msgstr "B<--volgroups>"
2083
2084 #. type: =item
2085 #: ../cat/virt-filesystems.pod:277
2086 msgid "B<--volume-groups>"
2087 msgstr "B<--volume-groups>"
2088
2089 #. type: textblock
2090 #: ../cat/virt-filesystems.pod:279
2091 msgid "Display LVM volume groups."
2092 msgstr ""
2093
2094 #. type: =head1
2095 #: ../cat/virt-filesystems.pod:287
2096 msgid "COLUMNS"
2097 msgstr "СТОВПЧИКИ"
2098
2099 #. type: textblock
2100 #: ../cat/virt-filesystems.pod:289
2101 msgid ""
2102 "Note that columns in the output are subject to reordering and change in "
2103 "future versions of this tool."
2104 msgstr ""
2105
2106 #. type: =item
2107 #: ../cat/virt-filesystems.pod:294
2108 msgid "B<Name>"
2109 msgstr ""
2110
2111 #. type: textblock
2112 #: ../cat/virt-filesystems.pod:296
2113 msgid "The filesystem, partition, block device or LVM name."
2114 msgstr ""
2115
2116 #. type: textblock
2117 #: ../cat/virt-filesystems.pod:298
2118 msgid ""
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 "
2121 "device."
2122 msgstr ""
2123
2124 #. type: textblock
2125 #: ../cat/virt-filesystems.pod:302
2126 msgid ""
2127 "If the I<--long> option is B<not> specified, then only the name column is "
2128 "shown in the output."
2129 msgstr ""
2130
2131 #. type: =item
2132 #: ../cat/virt-filesystems.pod:305
2133 msgid "B<Type>"
2134 msgstr ""
2135
2136 #. type: textblock
2137 #: ../cat/virt-filesystems.pod:307
2138 msgid "The object type, for example C<filesystem>, C<lv>, C<device> etc."
2139 msgstr ""
2140
2141 #. type: =item
2142 #: ../cat/virt-filesystems.pod:309
2143 msgid "B<VFS>"
2144 msgstr "B<VFS>"
2145
2146 #. type: textblock
2147 #: ../cat/virt-filesystems.pod:311
2148 msgid ""
2149 "If there is a filesystem, then this column displays the filesystem type if "
2150 "one could be detected, eg. C<ext4>."
2151 msgstr ""
2152
2153 #. type: =item
2154 #: ../cat/virt-filesystems.pod:314
2155 msgid "B<Label>"
2156 msgstr ""
2157
2158 #. type: textblock
2159 #: ../cat/virt-filesystems.pod:316
2160 msgid ""
2161 "If the object has a label (used for identifying and mounting filesystems) "
2162 "then this column contains the label."
2163 msgstr ""
2164
2165 #. type: =item
2166 #: ../cat/virt-filesystems.pod:319
2167 msgid "B<MBR>"
2168 msgstr ""
2169
2170 #. type: textblock
2171 #: ../cat/virt-filesystems.pod:321
2172 msgid ""
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>"
2176 msgstr ""
2177
2178 #. type: textblock
2179 #: ../cat/virt-filesystems.pod:325
2180 msgid "This is only applicable for DOS (MBR) partitions."
2181 msgstr ""
2182
2183 #. type: =item
2184 #: ../cat/virt-filesystems.pod:327
2185 msgid "B<Size>"
2186 msgstr ""
2187
2188 #. type: textblock
2189 #: ../cat/virt-filesystems.pod:329
2190 msgid ""
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."
2193 msgstr ""
2194
2195 #. type: =item
2196 #: ../cat/virt-filesystems.pod:332
2197 msgid "B<Parent>"
2198 msgstr ""
2199
2200 #. type: textblock
2201 #: ../cat/virt-filesystems.pod:334
2202 msgid ""
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."
2207 msgstr ""
2208
2209 #. type: =item
2210 #: ../cat/virt-filesystems.pod:339
2211 msgid "B<UUID>"
2212 msgstr "B<UUID>"
2213
2214 #. type: textblock
2215 #: ../cat/virt-filesystems.pod:341
2216 msgid ""
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."
2219 msgstr ""
2220
2221 #. type: textblock
2222 #: ../cat/virt-filesystems.pod:345
2223 msgid "The UUID is only displayed if the I<--uuid> option is given."
2224 msgstr ""
2225
2226 #. type: =head1
2227 #: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:459
2228 #: ../df/virt-df.pod:191
2229 msgid "NOTE ABOUT CSV FORMAT"
2230 msgstr ""
2231
2232 #. type: textblock
2233 #: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:461
2234 #: ../df/virt-df.pod:193
2235 msgid ""
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."
2238 msgstr ""
2239
2240 #. type: textblock
2241 #: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:464
2242 #: ../df/virt-df.pod:196
2243 msgid ""
2244 "Myth: Just split fields at commas.  Reality: This does I<not> work "
2245 "reliably.  This example has two columns:"
2246 msgstr ""
2247
2248 #. type: verbatim
2249 #: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:467
2250 #: ../df/virt-df.pod:199
2251 #, no-wrap
2252 msgid ""
2253 " \"foo,bar\",baz\n"
2254 "\n"
2255 msgstr ""
2256
2257 #. type: textblock
2258 #: ../cat/virt-filesystems.pod:359 ../cat/virt-ls.pod:469
2259 #: ../df/virt-df.pod:201
2260 msgid ""
2261 "Myth: Read the file one line at a time.  Reality: This does I<not> work "
2262 "reliably.  This example has one row:"
2263 msgstr ""
2264
2265 #. type: verbatim
2266 #: ../cat/virt-filesystems.pod:362 ../cat/virt-ls.pod:472
2267 #: ../df/virt-df.pod:204
2268 #, no-wrap
2269 msgid ""
2270 " \"foo\n"
2271 " bar\",baz\n"
2272 "\n"
2273 msgstr ""
2274
2275 #. type: textblock
2276 #: ../cat/virt-filesystems.pod:365 ../cat/virt-ls.pod:475
2277 #: ../df/virt-df.pod:207
2278 msgid ""
2279 "For shell scripts, use C<csvtool> (L<http://merjis.com/developers/csv> also "
2280 "packaged in major Linux distributions)."
2281 msgstr ""
2282
2283 #. type: textblock
2284 #: ../cat/virt-filesystems.pod:368 ../cat/virt-ls.pod:478
2285 #: ../df/virt-df.pod:210
2286 msgid ""
2287 "For other languages, use a CSV processing library (eg. C<Text::CSV> for Perl "
2288 "or Python's built-in csv library)."
2289 msgstr ""
2290
2291 #. type: textblock
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."
2295 msgstr ""
2296
2297 #. type: textblock
2298 #: ../cat/virt-filesystems.pod:387
2299 msgid ""
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://"
2302 "libguestfs.org/>."
2303 msgstr ""
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://"
2306 "libguestfs.org/>."
2307
2308 #. type: textblock
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"
2312
2313 #. type: textblock
2314 #: ../cat/virt-ls.pod:5
2315 msgid "virt-ls - List files in a virtual machine"
2316 msgstr ""
2317
2318 #. type: verbatim
2319 #: ../cat/virt-ls.pod:9
2320 #, no-wrap
2321 msgid ""
2322 " virt-ls [--options] -d domname directory [directory ...]\n"
2323 "\n"
2324 msgstr ""
2325
2326 #. type: verbatim
2327 #: ../cat/virt-ls.pod:11
2328 #, no-wrap
2329 msgid ""
2330 " virt-ls [--options] -a disk.img [-a disk.img ...] directory [directory ...]\n"
2331 "\n"
2332 msgstr ""
2333
2334 #. type: textblock
2335 #: ../cat/virt-ls.pod:13 ../df/virt-df.pod:15 ../rescue/virt-rescue.pod:15
2336 msgid "Old style:"
2337 msgstr "Старий стиль:"
2338
2339 #. type: verbatim
2340 #: ../cat/virt-ls.pod:15
2341 #, no-wrap
2342 msgid ""
2343 " virt-ls [--options] domname directory\n"
2344 "\n"
2345 msgstr ""
2346
2347 #. type: verbatim
2348 #: ../cat/virt-ls.pod:17
2349 #, no-wrap
2350 msgid ""
2351 " virt-ls [--options] disk.img [disk.img ...] directory\n"
2352 "\n"
2353 msgstr ""
2354
2355 #. type: textblock
2356 #: ../cat/virt-ls.pod:21
2357 msgid ""
2358 "C<virt-ls> lists filenames, file sizes, checksums, extended attributes and "
2359 "more from a virtual machine or disk image."
2360 msgstr ""
2361
2362 #. type: textblock
2363 #: ../cat/virt-ls.pod:24
2364 msgid ""
2365 "Multiple directory names can be given, in which case the output from each is "
2366 "concatenated."
2367 msgstr ""
2368
2369 #. type: textblock
2370 #: ../cat/virt-ls.pod:27
2371 msgid ""
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."
2374 msgstr ""
2375
2376 #. type: textblock
2377 #: ../cat/virt-ls.pod:31
2378 msgid ""
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"
2381 "(3)> API."
2382 msgstr ""
2383
2384 #. type: textblock
2385 #: ../cat/virt-ls.pod:37
2386 msgid "Get a list of all files and directories in a virtual machine:"
2387 msgstr ""
2388
2389 #. type: verbatim
2390 #: ../cat/virt-ls.pod:39
2391 #, no-wrap
2392 msgid ""
2393 " virt-ls -R -d guest /\n"
2394 "\n"
2395 msgstr ""
2396
2397 #. type: textblock
2398 #: ../cat/virt-ls.pod:41 ../examples/guestfs-testing.pod:160
2399 msgid "List all setuid or setgid programs in a Linux virtual machine:"
2400 msgstr ""
2401
2402 #. type: verbatim
2403 #: ../cat/virt-ls.pod:43
2404 #, no-wrap
2405 msgid ""
2406 " virt-ls -lR -d guest / | grep '^- [42]'\n"
2407 "\n"
2408 msgstr ""
2409
2410 #. type: textblock
2411 #: ../cat/virt-ls.pod:45 ../examples/guestfs-testing.pod:164
2412 msgid "List all public-writable directories in a Linux virtual machine:"
2413 msgstr ""
2414
2415 #. type: verbatim
2416 #: ../cat/virt-ls.pod:47
2417 #, no-wrap
2418 msgid ""
2419 " virt-ls -lR -d guest / | grep '^d ...7'\n"
2420 "\n"
2421 msgstr ""
2422
2423 #. type: textblock
2424 #: ../cat/virt-ls.pod:49 ../examples/guestfs-testing.pod:168
2425 msgid "List all Unix domain sockets in a Linux virtual machine:"
2426 msgstr ""
2427
2428 #. type: verbatim
2429 #: ../cat/virt-ls.pod:51
2430 #, no-wrap
2431 msgid ""
2432 " virt-ls -lR -d guest / | grep '^s'\n"
2433 "\n"
2434 msgstr ""
2435
2436 #. type: textblock
2437 #: ../cat/virt-ls.pod:53 ../examples/guestfs-testing.pod:172
2438 msgid "List all regular files with filenames ending in '.png':"
2439 msgstr ""
2440
2441 #. type: verbatim
2442 #: ../cat/virt-ls.pod:55
2443 #, no-wrap
2444 msgid ""
2445 " virt-ls -lR -d guest / | grep -i '^-.*\\.png$'\n"
2446 "\n"
2447 msgstr ""
2448
2449 #. type: textblock
2450 #: ../cat/virt-ls.pod:57
2451 msgid "To display files larger than 10MB in home directories:"
2452 msgstr ""
2453
2454 #. type: verbatim
2455 #: ../cat/virt-ls.pod:59
2456 #, no-wrap
2457 msgid ""
2458 " virt-ls -lR -d guest /home | awk '$3 > 10*1024*1024'\n"
2459 "\n"
2460 msgstr ""
2461
2462 #. type: textblock
2463 #: ../cat/virt-ls.pod:61 ../examples/guestfs-testing.pod:180
2464 msgid "Find everything modified in the last 7 days:"
2465 msgstr ""
2466
2467 #. type: verbatim
2468 #: ../cat/virt-ls.pod:63
2469 #, no-wrap
2470 msgid ""
2471 " virt-ls -lR -d guest --time-days / | awk '$6 <= 7'\n"
2472 "\n"
2473 msgstr ""
2474
2475 #. type: textblock
2476 #: ../cat/virt-ls.pod:65 ../examples/guestfs-testing.pod:184
2477 msgid "Find regular files modified in the last 24 hours:"
2478 msgstr ""
2479
2480 #. type: verbatim
2481 #: ../cat/virt-ls.pod:67
2482 #, no-wrap
2483 msgid ""
2484 " virt-ls -lR -d guest --time-days / | grep '^-' | awk '$6 < 1'\n"
2485 "\n"
2486 msgstr ""
2487
2488 #. type: =head2
2489 #: ../cat/virt-ls.pod:69
2490 msgid "DIFFERENCES IN SNAPSHOTS AND BACKING FILES"
2491 msgstr ""
2492
2493 #. type: textblock
2494 #: ../cat/virt-ls.pod:71
2495 msgid ""
2496 "Find the differences between files in a guest and an earlier snapshot of the "
2497 "same guest."
2498 msgstr ""
2499
2500 #. type: verbatim
2501 #: ../cat/virt-ls.pod:74
2502 #, no-wrap
2503 msgid ""
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"
2507 "\n"
2508 msgstr ""
2509
2510 #. type: textblock
2511 #: ../cat/virt-ls.pod:78
2512 msgid ""
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."
2518 msgstr ""
2519
2520 #. type: =head1
2521 #: ../cat/virt-ls.pod:84
2522 msgid "OUTPUT MODES"
2523 msgstr "РЕЖИМИ ВИВЕДЕННЯ ДАНИХ"
2524
2525 #. type: textblock
2526 #: ../cat/virt-ls.pod:86
2527 msgid ""
2528 "C<virt-ls> has four output modes, controlled by different combinations of "
2529 "the I<-l> and I<-R> options."
2530 msgstr ""
2531
2532 #. type: =head2
2533 #: ../cat/virt-ls.pod:89
2534 msgid "SIMPLE LISTING"
2535 msgstr "ПРОСТИЙ СПИСОК"
2536
2537 #. type: textblock
2538 #: ../cat/virt-ls.pod:91
2539 msgid "A simple listing is like the ordinary L<ls(1)> command:"
2540 msgstr ""
2541
2542 #. type: verbatim
2543 #: ../cat/virt-ls.pod:93
2544 #, no-wrap
2545 msgid ""
2546 " $ virt-ls -d guest /\n"
2547 " bin\n"
2548 " boot\n"
2549 " [etc.]\n"
2550 "\n"
2551 msgstr ""
2552 " $ virt-ls -d guest /\n"
2553 " bin\n"
2554 " boot\n"
2555 " [тощо]\n"
2556 "\n"
2557
2558 #. type: =head2
2559 #: ../cat/virt-ls.pod:98
2560 msgid "LONG LISTING"
2561 msgstr "ДОВГИЙ СПИСОК"
2562
2563 #. type: textblock
2564 #: ../cat/virt-ls.pod:100
2565 msgid ""
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)."
2568 msgstr ""
2569
2570 #. type: verbatim
2571 #: ../cat/virt-ls.pod:103
2572 #, no-wrap
2573 msgid ""
2574 " $ virt-ls -l -d guest /\n"
2575 " total 204\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"
2578 " [etc.]\n"
2579 "\n"
2580 msgstr ""
2581 " $ virt-ls -l -d guest /\n"
2582 " total 204\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"
2585 " [тощо]\n"
2586 "\n"
2587
2588 #. type: textblock
2589 #: ../cat/virt-ls.pod:109
2590 msgid ""
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> "
2593 "instead."
2594 msgstr ""
2595
2596 #. type: =head2
2597 #: ../cat/virt-ls.pod:113
2598 msgid "RECURSIVE LISTING"
2599 msgstr "РЕКУРСИВНИЙ СПИСОК"
2600
2601 #. type: textblock
2602 #: ../cat/virt-ls.pod:115
2603 msgid ""
2604 "With the I<-R> (I<--recursive>) option, C<virt-ls> lists the names of files "
2605 "and directories recursively:"
2606 msgstr ""
2607
2608 #. type: verbatim
2609 #: ../cat/virt-ls.pod:118
2610 #, no-wrap
2611 msgid ""
2612 " $ virt-ls -R -d guest /tmp\n"
2613 " foo\n"
2614 " foo/bar\n"
2615 " [etc.]\n"
2616 "\n"
2617 msgstr ""
2618 " $ virt-ls -R -d guest /tmp\n"
2619 " foo\n"
2620 " foo/bar\n"
2621 " [тощо]\n"
2622 "\n"
2623
2624 #. type: textblock
2625 #: ../cat/virt-ls.pod:123
2626 msgid ""
2627 "To generate this output, C<virt-ls> runs the C<guestfs_find0> function and "
2628 "converts C<\\0> characters to C<\\n>."
2629 msgstr ""
2630
2631 #. type: =head2
2632 #: ../cat/virt-ls.pod:126
2633 msgid "RECURSIVE LONG LISTING"
2634 msgstr "РЕКУРСИВНИЙ ДОВГИЙ СПИСОК"
2635
2636 #. type: textblock
2637 #: ../cat/virt-ls.pod:128
2638 msgid ""
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."
2642 msgstr ""
2643
2644 #. type: textblock
2645 #: ../cat/virt-ls.pod:132
2646 msgid ""
2647 "Most of the interesting features of C<virt-ls> are only available when using "
2648 "I<-lR> mode."
2649 msgstr ""
2650
2651 #. type: textblock
2652 #: ../cat/virt-ls.pod:135
2653 msgid ""
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 "
2660 "Values) option."
2661 msgstr ""
2662
2663 #. type: textblock
2664 #: ../cat/virt-ls.pod:143
2665 msgid ""
2666 "Note that this output format is completely unrelated to the C<ls -lR> "
2667 "command."
2668 msgstr ""
2669
2670 #. type: verbatim
2671 #: ../cat/virt-ls.pod:146
2672 #, no-wrap
2673 msgid ""
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"
2681 " [etc.]\n"
2682 "\n"
2683 msgstr ""
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"
2691 " [тощо]\n"
2692 "\n"
2693
2694 #. type: textblock
2695 #: ../cat/virt-ls.pod:155
2696 msgid "These basic fields are always shown:"
2697 msgstr ""
2698
2699 #. type: =item
2700 #: ../cat/virt-ls.pod:159
2701 msgid "type"
2702 msgstr "тип"
2703
2704 #. type: textblock
2705 #: ../cat/virt-ls.pod:161
2706 msgid ""
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)."
2710 msgstr ""
2711
2712 #. type: =item
2713 #: ../cat/virt-ls.pod:171
2714 msgid "permissions"
2715 msgstr "права доступу"
2716
2717 #. type: textblock
2718 #: ../cat/virt-ls.pod:173
2719 msgid "The Unix permissions, displayed as a 4 digit octal number."
2720 msgstr ""
2721
2722 #. type: =item
2723 #: ../cat/virt-ls.pod:175
2724 msgid "size"
2725 msgstr "розмір"
2726
2727 #. type: textblock
2728 #: ../cat/virt-ls.pod:177
2729 msgid ""
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 "
2732 "number."
2733 msgstr ""
2734
2735 #. type: =head2
2736 #: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4477
2737 msgid "path"
2738 msgstr "шлях"
2739
2740 #. type: textblock
2741 #: ../cat/virt-ls.pod:183
2742 msgid "The full path of the file or directory."
2743 msgstr ""
2744
2745 #. type: =item
2746 #: ../cat/virt-ls.pod:185
2747 msgid "link"
2748 msgstr "посилання"
2749
2750 #. type: textblock
2751 #: ../cat/virt-ls.pod:187
2752 msgid "For symbolic links only, the link target."
2753 msgstr ""
2754
2755 #. type: textblock
2756 #: ../cat/virt-ls.pod:191
2757 msgid ""
2758 "In I<-lR> mode, additional command line options enable the display of more "
2759 "fields."
2760 msgstr ""
2761
2762 #. type: textblock
2763 #: ../cat/virt-ls.pod:194
2764 msgid ""
2765 "With the I<--uids> flag, these additional fields are displayed before the "
2766 "path:"
2767 msgstr ""
2768
2769 #. type: =item
2770 #: ../cat/virt-ls.pod:199
2771 msgid "uid"
2772 msgstr "uid"
2773
2774 #. type: =item
2775 #: ../cat/virt-ls.pod:201
2776 msgid "gid"
2777 msgstr "gid"
2778
2779 #. type: textblock
2780 #: ../cat/virt-ls.pod:203
2781 msgid ""
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."
2784 msgstr ""
2785
2786 #. type: textblock
2787 #: ../cat/virt-ls.pod:208
2788 msgid "With the I<--times> flag, these additional fields are displayed:"
2789 msgstr ""
2790
2791 #. type: =item
2792 #: ../cat/virt-ls.pod:212
2793 msgid "atime"
2794 msgstr "atime"
2795
2796 #. type: textblock
2797 #: ../cat/virt-ls.pod:214
2798 msgid "The time of last access."
2799 msgstr "Час останнього доступу."
2800
2801 #. type: =item
2802 #: ../cat/virt-ls.pod:216
2803 msgid "mtime"
2804 msgstr "mtime"
2805
2806 #. type: textblock
2807 #: ../cat/virt-ls.pod:218
2808 msgid "The time of last modification."
2809 msgstr "Час останнього внесення змін."
2810
2811 #. type: =item
2812 #: ../cat/virt-ls.pod:220
2813 msgid "ctime"
2814 msgstr "ctime"
2815
2816 #. type: textblock
2817 #: ../cat/virt-ls.pod:222
2818 msgid "The time of last status change."
2819 msgstr "Час останньої зміни стану."
2820
2821 #. type: textblock
2822 #: ../cat/virt-ls.pod:226
2823 msgid ""
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."
2826 msgstr ""
2827
2828 #. type: textblock
2829 #: ../cat/virt-ls.pod:229
2830 msgid "With the I<--extra-stats> flag, these additional fields are displayed:"
2831 msgstr ""
2832
2833 #. type: =item
2834 #: ../cat/virt-ls.pod:233
2835 msgid "device"
2836 msgstr "пристрій"
2837
2838 #. type: textblock
2839 #: ../cat/virt-ls.pod:235
2840 msgid ""
2841 "The device containing the file (displayed as major:minor).  This may not "
2842 "match devices as known to the guest."
2843 msgstr ""
2844
2845 #. type: =item
2846 #: ../cat/virt-ls.pod:238
2847 msgid "inode"
2848 msgstr "inode"
2849
2850 #. type: textblock
2851 #: ../cat/virt-ls.pod:240
2852 msgid "The inode number."
2853 msgstr ""
2854
2855 #. type: =item
2856 #: ../cat/virt-ls.pod:242
2857 msgid "nlink"
2858 msgstr "nlink"
2859
2860 #. type: textblock
2861 #: ../cat/virt-ls.pod:244
2862 msgid "The number of hard links."
2863 msgstr "Кількість жорстких посилань."
2864
2865 #. type: =item
2866 #: ../cat/virt-ls.pod:246
2867 msgid "rdev"
2868 msgstr "rdev"
2869
2870 #. type: textblock
2871 #: ../cat/virt-ls.pod:248
2872 msgid ""
2873 "For block and char special files, the device (displayed as major:minor)."
2874 msgstr ""
2875
2876 #. type: =item
2877 #: ../cat/virt-ls.pod:251
2878 msgid "blocks"
2879 msgstr "блоки"
2880
2881 #. type: textblock
2882 #: ../cat/virt-ls.pod:253
2883 msgid "The number of 512 byte blocks allocated to the file."
2884 msgstr ""
2885
2886 #. type: textblock
2887 #: ../cat/virt-ls.pod:257
2888 msgid ""
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 "
2891 "amount of time."
2892 msgstr ""
2893
2894 #. type: =item
2895 #: ../cat/virt-ls.pod:280
2896 msgid "B<--checksum>"
2897 msgstr "B<--checksum>"
2898
2899 #. type: =item
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>"
2903
2904 #. type: textblock
2905 #: ../cat/virt-ls.pod:284
2906 msgid ""
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."
2910 msgstr ""
2911
2912 #. type: textblock
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
2916 msgid ""
2917 "This option only has effect in I<-lR> output mode.  See L</RECURSIVE LONG "
2918 "LISTING> above."
2919 msgstr ""
2920
2921 #. type: textblock
2922 #: ../cat/virt-ls.pod:316
2923 msgid ""
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."
2928 msgstr ""
2929
2930 #. type: =item
2931 #: ../cat/virt-ls.pod:321
2932 msgid "B<--extra-stats>"
2933 msgstr "B<--extra-stats>"
2934
2935 #. type: textblock
2936 #: ../cat/virt-ls.pod:323
2937 msgid "Display extra stats."
2938 msgstr "Показати додаткові дані."
2939
2940 #. type: verbatim
2941 #: ../cat/virt-ls.pod:339
2942 #, no-wrap
2943 msgid ""
2944 " virt-ls --format=raw -a disk.img /dir\n"
2945 "\n"
2946 msgstr ""
2947
2948 #. type: verbatim
2949 #: ../cat/virt-ls.pod:343
2950 #, no-wrap
2951 msgid ""
2952 " virt-ls --format=raw -a disk.img --format -a another.img /dir\n"
2953 "\n"
2954 msgstr ""
2955
2956 #. type: textblock
2957 #: ../cat/virt-ls.pod:356
2958 msgid "Display file sizes in human-readable format."
2959 msgstr ""
2960
2961 #. type: =item
2962 #: ../cat/virt-ls.pod:370
2963 msgid "B<-R>"
2964 msgstr "B<-R>"
2965
2966 #. type: =item
2967 #: ../cat/virt-ls.pod:372
2968 msgid "B<--recursive>"
2969 msgstr "B<--recursive>"
2970
2971 #. type: textblock
2972 #: ../cat/virt-ls.pod:374
2973 msgid ""
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 "
2976 "LISTING>."
2977 msgstr ""
2978
2979 #. type: textblock
2980 #: ../cat/virt-ls.pod:378
2981 msgid ""
2982 "C<virt-ls -l> produces a \"long listing\", which shows more detail.  See L</"
2983 "LONG LISTING>."
2984 msgstr ""
2985
2986 #. type: textblock
2987 #: ../cat/virt-ls.pod:381
2988 msgid ""
2989 "C<virt-ls -R> produces a recursive list of files starting at the named "
2990 "directory.  See L</RECURSIVE LISTING>."
2991 msgstr ""
2992
2993 #. type: textblock
2994 #: ../cat/virt-ls.pod:384
2995 msgid ""
2996 "C<virt-ls -lR> produces a recursive long listing which can be more easily "
2997 "parsed.  See L</RECURSIVE LONG LISTING>."
2998 msgstr ""
2999
3000 #. type: =item
3001 #: ../cat/virt-ls.pod:387
3002 msgid "B<--times>"
3003 msgstr "B<--times>"
3004
3005 #. type: textblock
3006 #: ../cat/virt-ls.pod:389
3007 msgid "Display time fields."
3008 msgstr ""
3009
3010 #. type: =item
3011 #: ../cat/virt-ls.pod:394
3012 msgid "B<--time-days>"
3013 msgstr "B<--time-days>"
3014
3015 #. type: textblock
3016 #: ../cat/virt-ls.pod:396
3017 msgid "Display time fields as days before now (negative if in the future)."
3018 msgstr ""
3019
3020 #. type: textblock
3021 #: ../cat/virt-ls.pod:398
3022 msgid ""
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."
3025 msgstr ""
3026
3027 #. type: =item
3028 #: ../cat/virt-ls.pod:404
3029 msgid "B<--time-relative>"
3030 msgstr "B<--time-relative>"
3031
3032 #. type: textblock
3033 #: ../cat/virt-ls.pod:406
3034 msgid "Display time fields as seconds before now (negative if in the future)."
3035 msgstr ""
3036
3037 #. type: =item
3038 #: ../cat/virt-ls.pod:411
3039 msgid "B<--time-t>"
3040 msgstr "B<--time-t>"
3041
3042 #. type: textblock
3043 #: ../cat/virt-ls.pod:413
3044 msgid "Display time fields as seconds since the Unix epoch."
3045 msgstr ""
3046
3047 #. type: =item
3048 #: ../cat/virt-ls.pod:418
3049 msgid "B<--uids>"
3050 msgstr "B<--uids>"
3051
3052 #. type: textblock
3053 #: ../cat/virt-ls.pod:420
3054 msgid "Display UID and GID fields."
3055 msgstr ""
3056
3057 #. type: textblock
3058 #: ../cat/virt-ls.pod:445
3059 msgid "Previous versions of virt-ls allowed you to write either:"
3060 msgstr ""
3061
3062 #. type: verbatim
3063 #: ../cat/virt-ls.pod:447
3064 #, no-wrap
3065 msgid ""
3066 " virt-ls disk.img [disk.img ...] /dir\n"
3067 "\n"
3068 msgstr ""
3069
3070 #. type: verbatim
3071 #: ../cat/virt-ls.pod:451
3072 #, no-wrap
3073 msgid ""
3074 " virt-ls guestname /dir\n"
3075 "\n"
3076 msgstr ""
3077
3078 #. type: textblock
3079 #: ../cat/virt-ls.pod:497
3080 msgid ""
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/>."
3084 msgstr ""
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/>."
3088
3089 #. type: textblock
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"
3094
3095 #. type: textblock
3096 #: ../clone/virt-sysprep.pod:5
3097 msgid ""
3098 "virt-sysprep - Reset or unconfigure a virtual machine so clones can be made"
3099 msgstr ""
3100
3101 #. type: verbatim
3102 #: ../clone/virt-sysprep.pod:9
3103 #, no-wrap
3104 msgid ""
3105 " virt-sysprep [--options] -d domname\n"
3106 "\n"
3107 msgstr ""
3108
3109 #. type: verbatim
3110 #: ../clone/virt-sysprep.pod:11
3111 #, no-wrap
3112 msgid ""
3113 " virt-sysprep [--options] -a disk.img [-a disk.img ...]\n"
3114 "\n"
3115 msgstr ""
3116
3117 #. type: textblock
3118 #: ../clone/virt-sysprep.pod:15
3119 msgid ""
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."
3124 msgstr ""
3125
3126 #. type: textblock
3127 #: ../clone/virt-sysprep.pod:21
3128 msgid ""
3129 "Virt-sysprep is a simple shell script, allowing easy inspection or "
3130 "customization by the system administrator."
3131 msgstr ""
3132
3133 #. type: textblock
3134 #: ../clone/virt-sysprep.pod:24
3135 msgid ""
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."
3139 msgstr ""
3140
3141 #. type: textblock
3142 #: ../clone/virt-sysprep.pod:29
3143 msgid ""
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."
3149 msgstr ""
3150
3151 #. type: textblock
3152 #: ../clone/virt-sysprep.pod:35
3153 msgid ""
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."
3159 msgstr ""
3160
3161 #. type: =item
3162 #: ../clone/virt-sysprep.pod:76
3163 msgid "B<--enable=...>"
3164 msgstr ""
3165
3166 #. type: textblock
3167 #: ../clone/virt-sysprep.pod:78
3168 msgid ""
3169 "Choose which sysprep operations to perform.  Give a comma-separated list of "
3170 "operations, for example:"
3171 msgstr ""
3172
3173 #. type: verbatim
3174 #: ../clone/virt-sysprep.pod:81
3175 #, no-wrap
3176 msgid ""
3177 " --enable=ssh-hostkeys,udev-persistent-net\n"
3178 "\n"
3179 msgstr ""
3180
3181 #. type: textblock
3182 #: ../clone/virt-sysprep.pod:83
3183 msgid ""
3184 "would enable ONLY C<ssh-hostkeys> and C<udev-persistent-net> operations."
3185 msgstr ""
3186
3187 #. type: textblock
3188 #: ../clone/virt-sysprep.pod:85
3189 msgid ""
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 "
3192 "some guest types."
3193 msgstr ""
3194
3195 #. type: textblock
3196 #: ../clone/virt-sysprep.pod:89
3197 msgid ""
3198 "Use I<--list-operations> to list operations supported by a particular "
3199 "version of virt-sysprep."
3200 msgstr ""
3201
3202 #. type: textblock
3203 #: ../clone/virt-sysprep.pod:92
3204 msgid ""
3205 "See L</OPERATIONS> below for a list and an explanation of each operation."
3206 msgstr ""
3207
3208 #. type: verbatim
3209 #: ../clone/virt-sysprep.pod:106
3210 #, no-wrap
3211 msgid ""
3212 " virt-sysprep --format=raw -a disk.img\n"
3213 "\n"
3214 msgstr ""
3215
3216 #. type: verbatim
3217 #: ../clone/virt-sysprep.pod:110
3218 #, no-wrap
3219 msgid ""
3220 " virt-sysprep --format=raw -a disk.img --format -a another.img\n"
3221 "\n"
3222 msgstr ""
3223
3224 #. type: =item
3225 #: ../clone/virt-sysprep.pod:119
3226 msgid "B<--hostname> newhostname"
3227 msgstr ""
3228
3229 #. type: textblock
3230 #: ../clone/virt-sysprep.pod:121
3231 msgid ""
3232 "Change the hostname.  See the L</hostname> operation below.  If not given, "
3233 "defaults to C<localhost.localdomain>."
3234 msgstr ""
3235
3236 #. type: =item
3237 #: ../clone/virt-sysprep.pod:124
3238 msgid "B<--list-operations>"
3239 msgstr ""
3240
3241 #. type: textblock
3242 #: ../clone/virt-sysprep.pod:126
3243 msgid "List the operations supported by the virt-sysprep program."
3244 msgstr ""
3245
3246 #. type: =item
3247 #: ../clone/virt-sysprep.pod:128
3248 msgid "B<--selinux-relabel>"
3249 msgstr ""
3250
3251 #. type: =item
3252 #: ../clone/virt-sysprep.pod:130
3253 msgid "B<--no-selinux-relabel>"
3254 msgstr ""
3255
3256 #. type: textblock
3257 #: ../clone/virt-sysprep.pod:132
3258 msgid ""
3259 "I<--selinux-relabel> forces SELinux relabelling next time the guest boots.  "
3260 "I<--no-selinux-relabel> disables relabelling."
3261 msgstr ""
3262
3263 #. type: textblock
3264 #: ../clone/virt-sysprep.pod:135
3265 msgid ""
3266 "The default is to try to detect if SELinux relabelling is required.  See L</"
3267 "SELINUX RELABELLING> below for more details."
3268 msgstr ""
3269
3270 #. type: =head1
3271 #: ../clone/virt-sysprep.pod:156
3272 msgid "OPERATIONS"
3273 msgstr ""
3274
3275 #. type: textblock
3276 #: ../clone/virt-sysprep.pod:158
3277 msgid ""
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."
3280 msgstr ""
3281
3282 #. type: textblock
3283 #: ../clone/virt-sysprep.pod:162
3284 msgid ""
3285 "Operations can be individually enabled using the I<--enable> option.  Use a "
3286 "comma-separated list, for example:"
3287 msgstr ""
3288
3289 #. type: verbatim
3290 #: ../clone/virt-sysprep.pod:165
3291 #, no-wrap
3292 msgid ""
3293 " virt-sysprep --enable=ssh-hostkeys,udev-persistent-net [etc..]\n"
3294 "\n"
3295 msgstr ""
3296
3297 #. type: textblock
3298 #: ../clone/virt-sysprep.pod:167
3299 msgid ""
3300 "To list the operations supported by the current version of virt-sysprep, use "
3301 "I<--list-operations>."
3302 msgstr ""
3303
3304 #. type: textblock
3305 #: ../clone/virt-sysprep.pod:170
3306 msgid ""
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."
3310 msgstr ""
3311
3312 #. type: =head2
3313 #: ../clone/virt-sysprep.pod:174
3314 msgid "cron-spool"
3315 msgstr ""
3316
3317 #. type: textblock
3318 #: ../clone/virt-sysprep.pod:176
3319 msgid "Remove user at-jobs and cron-jobs."
3320 msgstr ""
3321
3322 #. type: =head2
3323 #: ../clone/virt-sysprep.pod:178
3324 msgid "dhcp-client-state"
3325 msgstr ""
3326
3327 #. type: textblock
3328 #: ../clone/virt-sysprep.pod:180
3329 msgid "Remove DHCP client leases."
3330 msgstr ""
3331
3332 #. type: =head2
3333 #: ../clone/virt-sysprep.pod:182
3334 msgid "dhcp-server-state"
3335 msgstr ""
3336
3337 #. type: textblock
3338 #: ../clone/virt-sysprep.pod:184
3339 msgid "Remove DHCP server leases."
3340 msgstr ""
3341
3342 #. type: =head2
3343 #: ../clone/virt-sysprep.pod:186
3344 msgid "hostname"
3345 msgstr ""
3346
3347 #. type: textblock
3348 #: ../clone/virt-sysprep.pod:188
3349 msgid ""
3350 "Changes the hostname of the guest to the value given in the I<--hostname> "
3351 "parameter."
3352 msgstr ""
3353
3354 #. type: textblock
3355 #: ../clone/virt-sysprep.pod:191
3356 msgid ""
3357 "If the I<--hostname> parameter is not given, then the hostname is changed to "
3358 "C<localhost.localdomain>."
3359 msgstr ""
3360
3361 #. type: =head2
3362 #: ../clone/virt-sysprep.pod:194
3363 msgid "logfiles"
3364 msgstr ""
3365
3366 #. type: textblock
3367 #: ../clone/virt-sysprep.pod:196
3368 msgid "Remove many log files."
3369 msgstr ""
3370
3371 #. type: =head2
3372 #: ../clone/virt-sysprep.pod:198
3373 msgid "mail-spool"
3374 msgstr ""
3375
3376 #. type: textblock
3377 #: ../clone/virt-sysprep.pod:200
3378 msgid "Remove email from the local mail spool directory."
3379 msgstr ""
3380
3381 #. type: =head2
3382 #: ../clone/virt-sysprep.pod:202
3383 msgid "net-hwaddr"
3384 msgstr ""
3385
3386 #. type: textblock
3387 #: ../clone/virt-sysprep.pod:204
3388 msgid ""
3389 "Remove HWADDR (hard-coded MAC address) configuration.  For Fedora and Red "
3390 "Hat Enterprise Linux, this is removed from C<ifcfg-*> files."
3391 msgstr ""
3392
3393 #. type: =head2
3394 #: ../clone/virt-sysprep.pod:207
3395 msgid "random-seed"
3396 msgstr ""
3397
3398 #. type: textblock
3399 #: ../clone/virt-sysprep.pod:209
3400 msgid ""
3401 "Write some random bytes from the host into the random seed file of the guest."
3402 msgstr ""
3403
3404 #. type: textblock
3405 #: ../clone/virt-sysprep.pod:212
3406 msgid "See L</RANDOM SEED> below."
3407 msgstr ""
3408
3409 #. type: =head2
3410 #: ../clone/virt-sysprep.pod:214
3411 msgid "rhn-systemid"
3412 msgstr ""
3413
3414 #. type: textblock
3415 #: ../clone/virt-sysprep.pod:216
3416 msgid "Remove the RHN system ID."
3417 msgstr ""
3418
3419 #. type: =head2
3420 #: ../clone/virt-sysprep.pod:218
3421 msgid "smolt-uuid"
3422 msgstr ""
3423
3424 #. type: textblock
3425 #: ../clone/virt-sysprep.pod:220
3426 msgid "Remove the Smolt hardware UUID."
3427 msgstr ""
3428
3429 #. type: =head2
3430 #: ../clone/virt-sysprep.pod:222
3431 msgid "ssh-hostkeys"
3432 msgstr ""
3433
3434 #. type: textblock
3435 #: ../clone/virt-sysprep.pod:224
3436 msgid "Remove the SSH host keys in the guest."
3437 msgstr ""
3438
3439 #. type: textblock
3440 #: ../clone/virt-sysprep.pod:226
3441 msgid ""
3442 "The SSH host keys are regenerated (differently) next time the guest is "
3443 "booted."
3444 msgstr ""
3445
3446 #. type: textblock
3447 #: ../clone/virt-sysprep.pod:229
3448 msgid ""
3449 "If, after cloning, the guest gets the same IP address, ssh will give you a "
3450 "stark warning about the host key changing:"
3451 msgstr ""
3452
3453 #. type: verbatim
3454 #: ../clone/virt-sysprep.pod:232
3455 #, no-wrap
3456 msgid ""
3457 " @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n"
3458 " @    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @\n"
3459 " @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n"
3460 " IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!\n"
3461 "\n"
3462 msgstr ""
3463
3464 #. type: =head2
3465 #: ../clone/virt-sysprep.pod:237
3466 msgid "udev-persistent-net"
3467 msgstr ""
3468
3469 #. type: textblock
3470 #: ../clone/virt-sysprep.pod:239
3471 msgid ""
3472 "Remove udev persistent net rules which map the guest's existing MAC address "
3473 "to a fixed ethernet device (eg. eth0)."
3474 msgstr ""
3475
3476 #. type: textblock
3477 #: ../clone/virt-sysprep.pod:242
3478 msgid ""
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."
3483 msgstr ""
3484
3485 #. type: =head2
3486 #: ../clone/virt-sysprep.pod:247
3487 msgid "utmp"
3488 msgstr ""
3489
3490 #. type: textblock
3491 #: ../clone/virt-sysprep.pod:249
3492 msgid "Remove the utmp file."
3493 msgstr ""
3494
3495 #. type: textblock
3496 #: ../clone/virt-sysprep.pod:251
3497 msgid ""
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."
3501 msgstr ""
3502
3503 #. type: =head2
3504 #: ../clone/virt-sysprep.pod:255
3505 msgid "yum-uuid"
3506 msgstr ""
3507
3508 #. type: textblock
3509 #: ../clone/virt-sysprep.pod:257
3510 msgid "Remove the yum UUID."
3511 msgstr ""
3512
3513 #. type: textblock
3514 #: ../clone/virt-sysprep.pod:259
3515 msgid ""
3516 "Yum creates a fresh UUID the next time it runs when it notices that the "
3517 "original UUID has been erased."
3518 msgstr ""
3519
3520 #. type: =head1
3521 #: ../clone/virt-sysprep.pod:262
3522 msgid "COPYING AND CLONING"
3523 msgstr ""
3524
3525 #. type: textblock
3526 #: ../clone/virt-sysprep.pod:264
3527 msgid ""
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."
3532 msgstr ""
3533
3534 #. type: textblock
3535 #: ../clone/virt-sysprep.pod:269
3536 msgid "A virtual machine (when switched off) consists of two parts:"
3537 msgstr ""
3538
3539 #. type: =item
3540 #: ../clone/virt-sysprep.pod:273
3541 msgid "I<configuration>"
3542 msgstr ""
3543
3544 #. type: textblock
3545 #: ../clone/virt-sysprep.pod:275
3546 msgid ""
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."
3550 msgstr ""
3551
3552 #. type: textblock
3553 #: ../clone/virt-sysprep.pod:279
3554 msgid "Some configuration items that might need to be changed:"
3555 msgstr ""
3556
3557 #. type: textblock
3558 #: ../clone/virt-sysprep.pod:285
3559 msgid "name"
3560 msgstr ""
3561
3562 #. type: textblock
3563 #: ../clone/virt-sysprep.pod:289 ../clone/virt-sysprep.pod:316
3564 msgid "UUID"
3565 msgstr ""
3566
3567 #. type: textblock
3568 #: ../clone/virt-sysprep.pod:293
3569 msgid "path to block device(s)"
3570 msgstr ""
3571
3572 #. type: textblock
3573 #: ../clone/virt-sysprep.pod:297
3574 msgid "network card MAC address"
3575 msgstr ""
3576
3577 #. type: =item
3578 #: ../clone/virt-sysprep.pod:301
3579 msgid "I<block device(s)>"
3580 msgstr ""
3581
3582 #. type: textblock
3583 #: ../clone/virt-sysprep.pod:303
3584 msgid ""
3585 "One or more hard disk images, themselves containing files, directories, "
3586 "applications, kernels, configuration, etc."
3587 msgstr ""
3588
3589 #. type: textblock
3590 #: ../clone/virt-sysprep.pod:306
3591 msgid "Some things inside the block devices that might need to be changed:"
3592 msgstr ""
3593
3594 #. type: textblock
3595 #: ../clone/virt-sysprep.pod:312
3596 msgid "hostname and other net configuration"
3597 msgstr ""
3598
3599 #. type: textblock
3600 #: ../clone/virt-sysprep.pod:320
3601 msgid "SSH host keys"
3602 msgstr ""
3603
3604 #. type: textblock
3605 #: ../clone/virt-sysprep.pod:324
3606 msgid "Windows unique security ID (SID)"
3607 msgstr ""
3608
3609 #. type: textblock
3610 #: ../clone/virt-sysprep.pod:328
3611 msgid "Puppet registration"
3612 msgstr ""
3613
3614 #. type: =head2
3615 #: ../clone/virt-sysprep.pod:334
3616 msgid "COPYING THE BLOCK DEVICE"
3617 msgstr ""
3618
3619 #. type: textblock
3620 #: ../clone/virt-sysprep.pod:336
3621 msgid ""
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."
3625 msgstr ""
3626
3627 #. type: verbatim
3628 #: ../clone/virt-sysprep.pod:341
3629 #, no-wrap
3630 msgid ""
3631 "                        virt-sysprep\n"
3632 "                             |\n"
3633 "                             v\n"
3634 " original guest --------> template ---------->\n"
3635 "                                      \\------> cloned\n"
3636 "                                       \\-----> guests\n"
3637 "                                        \\---->\n"
3638 "\n"
3639 msgstr ""
3640
3641 #. type: textblock
3642 #: ../clone/virt-sysprep.pod:349
3643 msgid ""
3644 "You can, of course, just copy the block device on the host using L<cp(1)> or "
3645 "L<dd(1)>."
3646 msgstr ""
3647
3648 #. type: verbatim
3649 #: ../clone/virt-sysprep.pod:352
3650 #, no-wrap
3651 msgid ""
3652 "                   dd                 dd\n"
3653 " original guest --------> template ---------->\n"
3654 "                                      \\------> cloned\n"
3655 "                                       \\-----> guests\n"
3656 "                                        \\---->\n"
3657 "\n"
3658 msgstr ""
3659
3660 #. type: textblock
3661 #: ../clone/virt-sysprep.pod:358
3662 msgid "There are some smarter (and faster) ways too:"
3663 msgstr ""
3664
3665 #. type: verbatim
3666 #: ../clone/virt-sysprep.pod:364
3667 #, no-wrap
3668 msgid ""
3669 "                          snapshot\n"
3670 "                template ---------->\n"
3671 "                            \\------> cloned\n"
3672 "                             \\-----> guests\n"
3673 "                              \\---->\n"
3674 "\n"
3675 msgstr ""
3676
3677 #. type: textblock
3678 #: ../clone/virt-sysprep.pod:370
3679 msgid ""
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)."
3683 msgstr ""
3684
3685 #. type: textblock
3686 #: ../clone/virt-sysprep.pod:375
3687 msgid ""
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."
3690 msgstr ""
3691
3692 #. type: textblock
3693 #: ../clone/virt-sysprep.pod:378
3694 msgid ""
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."
3699 msgstr ""
3700
3701 #. type: textblock
3702 #: ../clone/virt-sysprep.pod:386
3703 msgid "Get your NAS to snapshot and/or duplicate the LUN."
3704 msgstr ""
3705
3706 #. type: textblock
3707 #: ../clone/virt-sysprep.pod:390
3708 msgid "Prepare your template using L<virt-sparsify(1)>.  See below."
3709 msgstr ""
3710
3711 #. type: =head2
3712 #: ../clone/virt-sysprep.pod:394
3713 msgid "VIRT-CLONE"
3714 msgstr ""
3715
3716 #. type: textblock
3717 #: ../clone/virt-sysprep.pod:396
3718 msgid ""
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."
3722 msgstr ""
3723
3724 #. type: textblock
3725 #: ../clone/virt-sysprep.pod:401
3726 msgid ""
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."
3729 msgstr ""
3730
3731 #. type: =head2
3732 #: ../clone/virt-sysprep.pod:404
3733 msgid "SPARSIFY"
3734 msgstr ""
3735
3736 #. type: verbatim
3737 #: ../clone/virt-sysprep.pod:406
3738 #, no-wrap
3739 msgid ""
3740 "              virt-sparsify\n"
3741 " original guest --------> template\n"
3742 "\n"
3743 msgstr ""
3744
3745 #. type: textblock
3746 #: ../clone/virt-sysprep.pod:409
3747 msgid ""
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."
3750 msgstr ""
3751
3752 #. type: textblock
3753 #: ../clone/virt-sysprep.pod:412
3754 msgid ""
3755 "Notice that since virt-sparsify also copies the image, you can use it to "
3756 "make the initial copy (instead of C<dd>)."
3757 msgstr ""
3758
3759 #. type: =head2
3760 #: ../clone/virt-sysprep.pod:415
3761 msgid "RESIZE"
3762 msgstr ""
3763
3764 #. type: verbatim
3765 #: ../clone/virt-sysprep.pod:417
3766 #, no-wrap
3767 msgid ""
3768 "                         virt-resize\n"
3769 "                template ---------->\n"
3770 "                            \\------> cloned\n"
3771 "                             \\-----> guests\n"
3772 "                              \\---->\n"
3773 "\n"
3774 msgstr ""
3775
3776 #. type: textblock
3777 #: ../clone/virt-sysprep.pod:423
3778 msgid ""
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."
3784 msgstr ""
3785
3786 #. type: =head1
3787 #: ../clone/virt-sysprep.pod:429 ../src/guestfs.pod:1164
3788 msgid "SECURITY"
3789 msgstr "БЕЗПЕКА"
3790
3791 #. type: textblock
3792 #: ../clone/virt-sysprep.pod:431
3793 msgid ""
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."
3798 msgstr ""
3799
3800 #. type: textblock
3801 #: ../clone/virt-sysprep.pod:436
3802 msgid ""
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."
3807 msgstr ""
3808
3809 #. type: =head2
3810 #: ../clone/virt-sysprep.pod:442
3811 msgid "RANDOM SEED"
3812 msgstr ""
3813
3814 #. type: textblock
3815 #: ../clone/virt-sysprep.pod:444
3816 msgid "I<(This section applies to Linux guests only)>"
3817 msgstr ""
3818
3819 #. type: textblock
3820 #: ../clone/virt-sysprep.pod:446
3821 msgid ""
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."
3824 msgstr ""
3825
3826 #. type: textblock
3827 #: ../clone/virt-sysprep.pod:449
3828 msgid ""
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."
3832 msgstr ""
3833
3834 #. type: textblock
3835 #: ../clone/virt-sysprep.pod:453
3836 msgid ""
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> "
3839 "operation:"
3840 msgstr ""
3841
3842 #. type: verbatim
3843 #: ../clone/virt-sysprep.pod:457
3844 #, no-wrap
3845 msgid ""
3846 " cp template.img newguest.img\n"
3847 " virt-sysprep --enable=random-seed -a newguest.img\n"
3848 "\n"
3849 msgstr ""
3850
3851 #. type: =head2
3852 #: ../clone/virt-sysprep.pod:460
3853 msgid "SELINUX RELABELLING"
3854 msgstr ""
3855
3856 #. type: textblock
3857 #: ../clone/virt-sysprep.pod:462
3858 msgid "I<(This section applies to Linux guests using SELinux only)>"
3859 msgstr ""
3860
3861 #. type: textblock
3862 #: ../clone/virt-sysprep.pod:464
3863 msgid ""
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 "
3867 "time."
3868 msgstr ""
3869
3870 #. type: textblock
3871 #: ../clone/virt-sysprep.pod:469
3872 msgid ""
3873 "You can force relabelling for all guests by supplying the I<--selinux-"
3874 "relabel> option."
3875 msgstr ""
3876
3877 #. type: textblock
3878 #: ../clone/virt-sysprep.pod:472
3879 msgid ""
3880 "You can disable relabelling entirely by supplying the I<--no-selinux-"
3881 "relabel> option."
3882 msgstr ""
3883
3884 #. type: textblock
3885 #: ../clone/virt-sysprep.pod:484
3886 msgid "This program returns 0 on success, or 1 if there was an error."
3887 msgstr ""
3888
3889 #. type: textblock
3890 #: ../clone/virt-sysprep.pod:488
3891 msgid ""
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/>."
3895 msgstr ""
3896
3897 #. type: textblock
3898 #: ../df/virt-df.pod:5
3899 msgid "virt-df - Display free space on virtual filesystems"
3900 msgstr ""
3901
3902 #. type: verbatim
3903 #: ../df/virt-df.pod:9
3904 #, no-wrap
3905 msgid ""
3906 " virt-df [--options]\n"
3907 "\n"
3908 msgstr ""
3909 " virt-df [--параметри]\n"
3910 "\n"
3911
3912 #. type: verbatim
3913 #: ../df/virt-df.pod:11
3914 #, no-wrap
3915 msgid ""
3916 " virt-df [--options] -d domname\n"
3917 "\n"
3918 msgstr ""
3919
3920 #. type: verbatim
3921 #: ../df/virt-df.pod:13
3922 #, no-wrap
3923 msgid ""
3924 " virt-df [--options] -a disk.img [-a disk.img ...]\n"
3925 "\n"
3926 msgstr ""
3927
3928 #. type: verbatim
3929 #: ../df/virt-df.pod:17
3930 #, no-wrap
3931 msgid ""
3932 " virt-df [--options] domname\n"
3933 "\n"
3934 msgstr ""
3935
3936 #. type: verbatim
3937 #: ../df/virt-df.pod:19
3938 #, no-wrap
3939 msgid ""
3940 " virt-df [--options] disk.img [disk.img ...]\n"
3941 "\n"
3942 msgstr ""
3943
3944 #. type: textblock
3945 #: ../df/virt-df.pod:23
3946 msgid ""
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."
3951 msgstr ""
3952
3953 #. type: textblock
3954 #: ../df/virt-df.pod:28
3955 msgid ""
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."
3959 msgstr ""
3960
3961 #. type: textblock
3962 #: ../df/virt-df.pod:32
3963 msgid ""
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."
3970 msgstr ""
3971
3972 #. type: textblock
3973 #: ../df/virt-df.pod:39
3974 msgid ""
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."
3977 msgstr ""
3978
3979 #. type: textblock
3980 #: ../df/virt-df.pod:45
3981 msgid ""
3982 "Show disk usage for a single libvirt guest called C<F14x64>.  Make the "
3983 "output human-readable:"
3984 msgstr ""
3985
3986 #. type: verbatim
3987 #: ../df/virt-df.pod:48
3988 #, no-wrap
3989 msgid ""
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"
3994 "\n"
3995 msgstr ""
3996
3997 #. type: textblock
3998 #: ../df/virt-df.pod:53
3999 msgid "Show disk usage for a disk image file called C<test.img>:"
4000 msgstr ""
4001
4002 #. type: verbatim
4003 #: ../df/virt-df.pod:55
4004 #, no-wrap
4005 msgid ""
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"
4009 "\n"
4010 msgstr ""
4011
4012 #. type: verbatim
4013 #: ../df/virt-df.pod:112
4014 #, no-wrap
4015 msgid ""
4016 " virt-df --format=raw -a disk.img\n"
4017 "\n"
4018 msgstr ""
4019
4020 #. type: verbatim
4021 #: ../df/virt-df.pod:116
4022 #, no-wrap
4023 msgid ""
4024 " virt-df --format=raw -a disk.img --format -a another.img\n"
4025 "\n"
4026 msgstr ""
4027
4028 #. type: textblock
4029 #: ../df/virt-df.pod:129
4030 msgid "Print sizes in human-readable format."
4031 msgstr ""
4032
4033 #. type: textblock
4034 #: ../df/virt-df.pod:131
4035 msgid "You are not allowed to use I<-h> and I<--csv> at the same time."
4036 msgstr ""
4037
4038 #. type: =item
4039 #: ../df/virt-df.pod:133 ../fish/guestfish.pod:258 ../fuse/guestmount.pod:164
4040 msgid "B<-i>"
4041 msgstr "B<-i>"
4042
4043 #. type: =item
4044 #: ../df/virt-df.pod:135
4045 msgid "B<--inodes>"
4046 msgstr "B<--inodes>"
4047
4048 #. type: textblock
4049 #: ../df/virt-df.pod:137
4050 msgid "Print inodes instead of blocks."
4051 msgstr ""
4052
4053 #. type: =item
4054 #: ../df/virt-df.pod:139
4055 msgid "B<--one-per-guest>"
4056 msgstr "B<--one-per-guest>"
4057
4058 #. type: textblock
4059 #: ../df/virt-df.pod:141
4060 msgid ""
4061 "Run one libguestfs appliance per guest.  Normally C<virt-df> will add the "
4062 "disks from several guests to a single libguestfs appliance."
4063 msgstr ""
4064
4065 #. type: textblock
4066 #: ../df/virt-df.pod:144
4067 msgid "You might use this option in the following circumstances:"
4068 msgstr ""
4069
4070 #. type: textblock
4071 #: ../df/virt-df.pod:150
4072 msgid ""
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."
4076 msgstr ""
4077
4078 #. type: textblock
4079 #: ../df/virt-df.pod:156
4080 msgid ""
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."
4084 msgstr ""
4085
4086 #. type: textblock
4087 #: ../df/virt-df.pod:165
4088 msgid ""
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 "
4091 "same name."
4092 msgstr ""
4093
4094 #. type: textblock
4095 #: ../df/virt-df.pod:169
4096 msgid ""
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 "
4099 "specified."
4100 msgstr ""
4101
4102 #. type: textblock
4103 #: ../df/virt-df.pod:229
4104 msgid ""
4105 "L<df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<http://"
4106 "libguestfs.org/>."
4107 msgstr ""
4108
4109 #. type: textblock
4110 #: ../edit/virt-edit.pod:5
4111 msgid "virt-edit - Edit a file in a virtual machine"
4112 msgstr ""
4113
4114 #. type: verbatim
4115 #: ../edit/virt-edit.pod:9
4116 #, no-wrap
4117 msgid ""
4118 " virt-edit [--options] -d domname file [file ...]\n"
4119 "\n"
4120 msgstr ""
4121
4122 #. type: verbatim
4123 #: ../edit/virt-edit.pod:11
4124 #, no-wrap
4125 msgid ""
4126 " virt-edit [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
4127 "\n"
4128 msgstr ""
4129
4130 #. type: verbatim
4131 #: ../edit/virt-edit.pod:13
4132 #, no-wrap
4133 msgid ""
4134 " virt-edit [-d domname|-a disk.img] file -e 'expr'\n"
4135 "\n"
4136 msgstr ""
4137
4138 #. type: verbatim
4139 #: ../edit/virt-edit.pod:17
4140 #, no-wrap
4141 msgid ""
4142 " virt-edit domname file\n"
4143 "\n"
4144 msgstr ""
4145
4146 #. type: verbatim
4147 #: ../edit/virt-edit.pod:19 ../edit/virt-edit.pod:183
4148 #, no-wrap
4149 msgid ""
4150 " virt-edit disk.img [disk.img ...] file\n"
4151 "\n"
4152 msgstr ""
4153
4154 #. type: =head1
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
4159 msgid "WARNING"
4160 msgstr "ПОПЕРЕДЖЕННЯ"
4161
4162 #. type: textblock
4163 #: ../edit/virt-edit.pod:23
4164 msgid ""
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."
4168 msgstr ""
4169
4170 #. type: textblock
4171 #: ../edit/virt-edit.pod:29
4172 msgid ""
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)."
4175 msgstr ""
4176
4177 #. type: textblock
4178 #: ../edit/virt-edit.pod:32
4179 msgid ""
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 '/')."
4183 msgstr ""
4184
4185 #. type: textblock
4186 #: ../edit/virt-edit.pod:36
4187 msgid "If you want to just view a file, use L<virt-cat(1)>."
4188 msgstr ""
4189
4190 #. type: textblock
4191 #: ../edit/virt-edit.pod:38
4192 msgid ""
4193 "For more complex cases you should look at the L<guestfish(1)> tool (see L</"
4194 "USING GUESTFISH> below)."
4195 msgstr ""
4196
4197 #. type: textblock
4198 #: ../edit/virt-edit.pod:41
4199 msgid ""
4200 "C<virt-edit> cannot be used to create a new file.  L<guestfish(1)> can do "
4201 "that and much more."
4202 msgstr ""
4203
4204 #. type: textblock
4205 #: ../edit/virt-edit.pod:46
4206 msgid "Edit the named files interactively:"
4207 msgstr ""
4208
4209 #. type: verbatim
4210 #: ../edit/virt-edit.pod:48
4211 #, no-wrap
4212 msgid ""
4213 " virt-edit -d mydomain /boot/grub/grub.conf\n"
4214 "\n"
4215 msgstr ""
4216
4217 #. type: verbatim
4218 #: ../edit/virt-edit.pod:50
4219 #, no-wrap
4220 msgid ""
4221 " virt-edit -d mydomain /etc/passwd\n"
4222 "\n"
4223 msgstr ""
4224
4225 #. type: textblock
4226 #: ../edit/virt-edit.pod:52
4227 msgid "For Windows guests, some Windows paths are understood:"
4228 msgstr ""
4229
4230 #. type: verbatim
4231 #: ../edit/virt-edit.pod:54
4232 #, no-wrap
4233 msgid ""
4234 " virt-edit -d mywindomain 'c:\\autoexec.bat'\n"
4235 "\n"
4236 msgstr ""
4237
4238 #. type: textblock
4239 #: ../edit/virt-edit.pod:56
4240 msgid ""
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:"
4243 msgstr ""
4244
4245 #. type: verbatim
4246 #: ../edit/virt-edit.pod:60
4247 #, no-wrap
4248 msgid ""
4249 " virt-edit -d mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
4250 "\n"
4251 msgstr ""
4252
4253 #. type: =item
4254 #: ../edit/virt-edit.pod:81
4255 msgid "B<-b> extension"
4256 msgstr ""
4257
4258 #. type: =item
4259 #: ../edit/virt-edit.pod:83
4260 msgid "B<--backup> extension"
4261 msgstr ""
4262
4263 #. type: textblock
4264 #: ../edit/virt-edit.pod:85
4265 msgid ""
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."
4268 msgstr ""
4269
4270 #. type: textblock
4271 #: ../edit/virt-edit.pod:88
4272 msgid ""
4273 "Usually the first character of C<extension> would be a dot C<.> so you would "
4274 "write:"
4275 msgstr ""
4276
4277 #. type: verbatim
4278 #: ../edit/virt-edit.pod:91
4279 #, no-wrap
4280 msgid ""
4281 " virt-edit -b .orig [etc]\n"
4282 "\n"
4283 msgstr ""
4284
4285 #. type: textblock
4286 #: ../edit/virt-edit.pod:93
4287 msgid "By default, no backup file is made."
4288 msgstr ""
4289
4290 #. type: =item
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
4295 msgid "B<-c URI>"
4296 msgstr "B<-c адреса>"
4297
4298 #. type: =item
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 адреса>"
4305
4306 #. type: textblock
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
4310 msgid ""
4311 "If you specify guest block devices directly, then libvirt is not used at all."
4312 msgstr ""
4313
4314 #. type: textblock
4315 #: ../edit/virt-edit.pod:114
4316 msgid ""
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."
4321 msgstr ""
4322
4323 #. type: =item
4324 #: ../edit/virt-edit.pod:119
4325 msgid "B<-e> EXPR"
4326 msgstr "B<-e> вираз"
4327
4328 #. type: =item
4329 #: ../edit/virt-edit.pod:121
4330 msgid "B<--expr> EXPR"
4331 msgstr "B<--expr> вираз"
4332
4333 #. type: textblock
4334 #: ../edit/virt-edit.pod:123
4335 msgid ""
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 "
4338 "EDITING> below."
4339 msgstr ""
4340
4341 #. type: textblock
4342 #: ../edit/virt-edit.pod:127
4343 msgid ""
4344 "Be careful to properly quote the expression to prevent it from being altered "
4345 "by the shell."
4346 msgstr ""
4347
4348 #. type: textblock
4349 #: ../edit/virt-edit.pod:130
4350 msgid "Note that this option is only available when Perl 5 is installed."
4351 msgstr ""
4352
4353 #. type: =item
4354 #: ../edit/virt-edit.pod:132
4355 msgid "B<--format> raw|qcow2|..."
4356 msgstr "B<--format> raw|qcow2|..."
4357
4358 #. type: verbatim
4359 #: ../edit/virt-edit.pod:143
4360 #, no-wrap
4361 msgid ""
4362 " virt-edit --format=raw -a disk.img file\n"
4363 "\n"
4364 msgstr ""
4365
4366 #. type: verbatim
4367 #: ../edit/virt-edit.pod:147
4368 #, no-wrap
4369 msgid ""
4370 " virt-edit --format=raw -a disk.img --format -a another.img file\n"
4371 "\n"
4372 msgstr ""
4373
4374 #. type: textblock
4375 #: ../edit/virt-edit.pod:181
4376 msgid "Previous versions of virt-edit allowed you to write either:"
4377 msgstr ""
4378
4379 #. type: verbatim
4380 #: ../edit/virt-edit.pod:187
4381 #, no-wrap
4382 msgid ""
4383 " virt-edit guestname file\n"
4384 "\n"
4385 msgstr ""
4386
4387 #. type: =head1
4388 #: ../edit/virt-edit.pod:195
4389 msgid "NON-INTERACTIVE EDITING"
4390 msgstr "НЕІНТЕРАКТИВНЕ РЕДАГУВАННЯ"
4391
4392 #. type: textblock
4393 #: ../edit/virt-edit.pod:197
4394 msgid ""
4395 "C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
4396 "administrator can interactively edit the file."
4397 msgstr ""
4398
4399 #. type: textblock
4400 #: ../edit/virt-edit.pod:200
4401 msgid ""
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.)"
4406 msgstr ""
4407
4408 #. type: textblock
4409 #: ../edit/virt-edit.pod:206
4410 msgid ""
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."
4414 msgstr ""
4415
4416 #. type: textblock
4417 #: ../edit/virt-edit.pod:210
4418 msgid ""
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:"
4422 msgstr ""
4423
4424 #. type: verbatim
4425 #: ../edit/virt-edit.pod:214
4426 #, no-wrap
4427 msgid ""
4428 " virt-edit -d domname filename -e 's/foo/bar/'\n"
4429 "\n"
4430 msgstr ""
4431
4432 #. type: textblock
4433 #: ../edit/virt-edit.pod:216
4434 msgid ""
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:"
4437 msgstr ""
4438
4439 #. type: verbatim
4440 #: ../edit/virt-edit.pod:219
4441 #, no-wrap
4442 msgid ""
4443 " virt-edit -d domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
4444 "\n"
4445 msgstr ""
4446 " virt-edit -d назва_домену /etc/passwd -e 's/^root:.*?:/root::/'\n"
4447 "\n"
4448
4449 #. type: textblock
4450 #: ../edit/virt-edit.pod:221
4451 msgid ""
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."
4455 msgstr ""
4456
4457 #. type: textblock
4458 #: ../edit/virt-edit.pod:226
4459 msgid ""
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:"
4462 msgstr ""
4463
4464 #. type: verbatim
4465 #: ../edit/virt-edit.pod:229
4466 #, no-wrap
4467 msgid ""
4468 " virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
4469 "\n"
4470 msgstr ""
4471 " virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
4472 "\n"
4473
4474 #. type: textblock
4475 #: ../edit/virt-edit.pod:231
4476 msgid ""
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 "
4481 "want to do this."
4482 msgstr ""
4483
4484 #. type: textblock
4485 #: ../edit/virt-edit.pod:237
4486 msgid ""
4487 "The variable C<$lineno> contains the current line number.  As is "
4488 "traditional, the first line in the file is number C<1>."
4489 msgstr ""
4490
4491 #. type: textblock
4492 #: ../edit/virt-edit.pod:240
4493 msgid ""
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 "
4496 "untouched."
4497 msgstr ""
4498
4499 #. type: textblock
4500 #: ../edit/virt-edit.pod:244
4501 msgid ""
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:"
4506 msgstr ""
4507
4508 #. type: verbatim
4509 #: ../edit/virt-edit.pod:249
4510 #, no-wrap
4511 msgid ""
4512 " /some text(\\r?\\n)?$/\n"
4513 "\n"
4514 msgstr ""
4515 " /якийсь текст(\\r?\\n)?$/\n"
4516 "\n"
4517
4518 #. type: textblock
4519 #: ../edit/virt-edit.pod:251
4520 msgid ""
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):"
4523 msgstr ""
4524
4525 #. type: verbatim
4526 #: ../edit/virt-edit.pod:255
4527 #, no-wrap
4528 msgid ""
4529 " my $m = $_; chomp $m; $m =~ /some text$/\n"
4530 "\n"
4531 msgstr ""
4532 " my $m = $_; chomp $m; $m =~ /якийсь текст$/\n"
4533 "\n"
4534
4535 #. type: textblock
4536 #: ../edit/virt-edit.pod:259
4537 msgid ""
4538 "C<virt-edit> has a limited ability to understand Windows drive letters and "
4539 "paths (eg. C<E:\\foo\\bar.txt>)."
4540 msgstr ""
4541
4542 #. type: textblock
4543 #: ../edit/virt-edit.pod:278
4544 msgid ""
4545 "The path is resolved case insensitively to locate the file that should be "
4546 "edited."
4547 msgstr ""
4548
4549 #. type: textblock
4550 #: ../edit/virt-edit.pod:299
4551 msgid ""
4552 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
4553 "C<virt-edit> doesn't work."
4554 msgstr ""
4555
4556 #. type: textblock
4557 #: ../edit/virt-edit.pod:302
4558 msgid "Using C<virt-edit> is approximately equivalent to doing:"
4559 msgstr ""
4560
4561 #. type: verbatim
4562 #: ../edit/virt-edit.pod:304
4563 #, no-wrap
4564 msgid ""
4565 " guestfish --rw -i -d domname edit /file\n"
4566 "\n"
4567 msgstr ""
4568
4569 #. type: textblock
4570 #: ../edit/virt-edit.pod:306
4571 msgid ""
4572 "where C<domname> is the name of the libvirt guest, and C</file> is the full "
4573 "path to the file."
4574 msgstr ""
4575
4576 #. type: textblock
4577 #: ../edit/virt-edit.pod:309
4578 msgid ""
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 "
4582 "directly, use:"
4583 msgstr ""
4584
4585 #. type: verbatim
4586 #: ../edit/virt-edit.pod:314
4587 #, no-wrap
4588 msgid ""
4589 " guestfish --rw -a disk.img -m /dev/sda1 edit /file\n"
4590 "\n"
4591 msgstr ""
4592
4593 #. type: textblock
4594 #: ../edit/virt-edit.pod:316
4595 msgid ""
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."
4598 msgstr ""
4599
4600 #. type: textblock
4601 #: ../edit/virt-edit.pod:320
4602 msgid ""
4603 "C<virt-edit> cannot create new files.  Use the guestfish commands C<touch>, "
4604 "C<write> or C<upload> instead:"
4605 msgstr ""
4606
4607 #. type: verbatim
4608 #: ../edit/virt-edit.pod:323
4609 #, no-wrap
4610 msgid ""
4611 " guestfish --rw -i -d domname touch /newfile\n"
4612 "\n"
4613 msgstr ""
4614
4615 #. type: verbatim
4616 #: ../edit/virt-edit.pod:325
4617 #, no-wrap
4618 msgid ""
4619 " guestfish --rw -i -d domname write /newfile \"new content\"\n"
4620 "\n"
4621 msgstr ""
4622
4623 #. type: verbatim
4624 #: ../edit/virt-edit.pod:327
4625 #, no-wrap
4626 msgid ""
4627 " guestfish --rw -i -d domname upload localfile /newfile\n"
4628 "\n"
4629 msgstr ""
4630
4631 #. type: =head1
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 "ЗМІННІ СЕРЕДОВИЩА"
4637
4638 #. type: =item
4639 #: ../edit/virt-edit.pod:333
4640 msgid "C<EDITOR>"
4641 msgstr "C<EDITOR>"
4642
4643 #. type: textblock
4644 #: ../edit/virt-edit.pod:335
4645 msgid ""
4646 "If set, this string is used as the editor.  It may contain arguments, eg. C<"
4647 "\"emacs -nw\">"
4648 msgstr ""
4649
4650 #. type: textblock
4651 #: ../edit/virt-edit.pod:338
4652 msgid "If not set, C<vi> is used."
4653 msgstr ""
4654
4655 #. type: textblock
4656 #: ../edit/virt-edit.pod:356
4657 msgid ""
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)>."
4661 msgstr ""
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)>."
4665
4666 #. type: textblock
4667 #: ../erlang/examples/guestfs-erlang.pod:5
4668 msgid "guestfs-erlang - How to use libguestfs from Erlang"
4669 msgstr ""
4670
4671 #. type: verbatim
4672 #: ../erlang/examples/guestfs-erlang.pod:9
4673 #, no-wrap
4674 msgid ""
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"
4681 "\n"
4682 msgstr ""
4683
4684 #. type: textblock
4685 #: ../erlang/examples/guestfs-erlang.pod:18
4686 msgid ""
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)>."
4691 msgstr ""
4692
4693 #. type: =head2
4694 #: ../erlang/examples/guestfs-erlang.pod:23
4695 msgid "OPENING AND CLOSING THE HANDLE"
4696 msgstr ""
4697
4698 #. type: textblock
4699 #: ../erlang/examples/guestfs-erlang.pod:25
4700 msgid ""
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:"
4704 msgstr ""
4705
4706 #. type: verbatim
4707 #: ../erlang/examples/guestfs-erlang.pod:29
4708 #, no-wrap
4709 msgid ""
4710 " {ok, G} = guestfs:create().\n"
4711 "\n"
4712 msgstr ""
4713
4714 #. type: verbatim
4715 #: ../erlang/examples/guestfs-erlang.pod:31
4716 #, no-wrap
4717 msgid ""
4718 " {ok, G} = guestfs:create(\"/path/to/erl-guestfs\").\n"
4719 "\n"
4720 msgstr ""
4721
4722 #. type: textblock
4723 #: ../erlang/examples/guestfs-erlang.pod:33
4724 msgid "C<G> is the libguestfs handle which you should pass to other functions."
4725 msgstr ""
4726
4727 #. type: textblock
4728 #: ../erlang/examples/guestfs-erlang.pod:36
4729 msgid "To close the handle:"
4730 msgstr ""
4731
4732 #. type: verbatim
4733 #: ../erlang/examples/guestfs-erlang.pod:38
4734 #, no-wrap
4735 msgid ""
4736 " ok = guestfs:close(G).\n"
4737 "\n"
4738 msgstr ""
4739
4740 #. type: =head2
4741 #: ../erlang/examples/guestfs-erlang.pod:40
4742 msgid "FUNCTIONS WITH OPTIONAL ARGUMENTS"
4743 msgstr ""
4744
4745 #. type: textblock
4746 #: ../erlang/examples/guestfs-erlang.pod:42
4747 msgid ""
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."
4751 msgstr ""
4752
4753 #. type: verbatim
4754 #: ../erlang/examples/guestfs-erlang.pod:46
4755 #, no-wrap
4756 msgid ""
4757 " ok = guestfs:add_drive_opts(G, Disk,\n"
4758 "                             [{format, \"raw\"}, {readonly, true}]).\n"
4759 "\n"
4760 msgstr ""
4761
4762 #. type: textblock
4763 #: ../erlang/examples/guestfs-erlang.pod:49
4764 msgid "If the last argument would be an empty list, you can also omit it:"
4765 msgstr ""
4766
4767 #. type: verbatim
4768 #: ../erlang/examples/guestfs-erlang.pod:51
4769 #, no-wrap
4770 msgid ""
4771 " ok = guestfs:add_drive_opts(G, Disk).\n"
4772 "\n"
4773 msgstr ""
4774
4775 #. type: =head2
4776 #: ../erlang/examples/guestfs-erlang.pod:53
4777 msgid "RETURN VALUES AND ERRORS"
4778 msgstr ""
4779
4780 #. type: textblock
4781 #: ../erlang/examples/guestfs-erlang.pod:55
4782 msgid ""
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."
4786 msgstr ""
4787
4788 #. type: textblock
4789 #: ../erlang/examples/guestfs-erlang.pod:59
4790 msgid "On error, you would see one of the following tuples:"
4791 msgstr ""
4792
4793 #. type: =item
4794 #: ../erlang/examples/guestfs-erlang.pod:63
4795 msgid "C<{error, Msg, Errno}>"
4796 msgstr ""
4797
4798 #. type: textblock
4799 #: ../erlang/examples/guestfs-erlang.pod:65
4800 msgid "This indicates an ordinary error from the function."
4801 msgstr ""
4802
4803 #. type: textblock
4804 #: ../erlang/examples/guestfs-erlang.pod:67
4805 msgid ""
4806 "C<Msg> is the error message (string) and C<Errno> is the Unix error "
4807 "(integer)."
4808 msgstr ""
4809
4810 #. type: textblock
4811 #: ../erlang/examples/guestfs-erlang.pod:70
4812 msgid "C<Errno> can be zero.  See L<guestfs(3)/guestfs_last_errno>."
4813 msgstr ""
4814
4815 #. type: =item
4816 #: ../erlang/examples/guestfs-erlang.pod:72
4817 msgid "C<{unknown, Function}>"
4818 msgstr ""
4819
4820 #. type: textblock
4821 #: ../erlang/examples/guestfs-erlang.pod:74
4822 msgid ""
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."
4826 msgstr ""
4827
4828 #. type: textblock
4829 #: ../erlang/examples/guestfs-erlang.pod:78
4830 msgid "C<Function> is the name of the unknown function."
4831 msgstr ""
4832
4833 #. type: =item
4834 #: ../erlang/examples/guestfs-erlang.pod:80
4835 msgid "C<{unknownarg, Arg}>"
4836 msgstr ""
4837
4838 #. type: textblock
4839 #: ../erlang/examples/guestfs-erlang.pod:82
4840 msgid ""
4841 "This indicates that you called a function with optional arguments, with an "
4842 "unknown argument name."
4843 msgstr ""
4844
4845 #. type: textblock
4846 #: ../erlang/examples/guestfs-erlang.pod:85
4847 msgid "C<Arg> is the name of the unknown argument."
4848 msgstr ""
4849
4850 #. type: =head1
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. СТВОРЕННЯ ОБРАЗУ ДИСКА"
4858
4859 #. type: textblock
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
4865 msgid "@EXAMPLE1@"
4866 msgstr "@EXAMPLE1@"
4867
4868 #. type: =head1
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. ПЕРЕВІРКА ОБРАЗУ ДИСКА ВІРТУАЛЬНОЇ МАШИНИ"
4876
4877 #. type: textblock
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
4883 msgid "@EXAMPLE2@"
4884 msgstr "@EXAMPLE2@"
4885
4886 #. type: textblock
4887 #: ../erlang/examples/guestfs-erlang.pod:99
4888 msgid ""
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/>."
4892 msgstr ""
4893
4894 #. type: =head1
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
4906 msgid "AUTHORS"
4907 msgstr "АВТОРИ"
4908
4909 #. type: textblock
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>)"
4922
4923 #. type: textblock
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/>"
4928 msgstr ""
4929
4930 #. type: textblock
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
4937 msgid ""
4938 "The examples in this manual page may be freely copied, modified and "
4939 "distributed without any restrictions."
4940 msgstr ""
4941
4942 #. type: textblock
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
4950 msgid ""
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."
4955 msgstr ""
4956
4957 #. type: textblock
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
4965 msgid ""
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 "
4969 "for more details."
4970 msgstr ""
4971
4972 #. type: textblock
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
4980 msgid ""
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"
4984 msgstr ""
4985
4986 #. type: textblock
4987 #: ../examples/guestfs-examples.pod:5
4988 msgid "guestfs-examples - Examples of using libguestfs from C"
4989 msgstr ""
4990
4991 #. type: verbatim
4992 #: ../examples/guestfs-examples.pod:9 ../src/guestfs.pod:9
4993 #, no-wrap
4994 msgid ""
4995 " #include <guestfs.h>\n"
4996 " \n"
4997 msgstr ""
4998 " #include <guestfs.h>\n"
4999 " \n"
5000
5001 #. type: verbatim
5002 #: ../examples/guestfs-examples.pod:11
5003 #, no-wrap
5004 msgid ""
5005 " guestfs_h *g = guestfs_create ();\n"
5006 " guestfs_add_drive_ro (g, \"disk.img\");\n"
5007 " guestfs_launch (g);\n"
5008 "\n"
5009 msgstr ""
5010 " guestfs_h *g = guestfs_create ();\n"
5011 " guestfs_add_drive_ro (g, \"disk.img\");\n"
5012 " guestfs_launch (g);\n"
5013 "\n"
5014
5015 #. type: verbatim
5016 #: ../examples/guestfs-examples.pod:15 ../src/guestfs.pod:19
5017 #, no-wrap
5018 msgid ""
5019 " cc prog.c -o prog -lguestfs\n"
5020 "or:\n"
5021 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
5022 "\n"
5023 msgstr ""
5024 " cc prog.c -o prog -lguestfs\n"
5025 "або:\n"
5026 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
5027 "\n"
5028
5029 #. type: textblock
5030 #: ../examples/guestfs-examples.pod:21
5031 msgid ""
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)>."
5035 msgstr ""
5036
5037 #. type: textblock
5038 #: ../examples/guestfs-examples.pod:35
5039 msgid ""
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/>."
5043 msgstr ""
5044
5045 #. type: textblock
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/>"
5050 msgstr ""
5051
5052 #. type: =end
5053 #: ../examples/guestfs-recipes.pod:3 ../examples/guestfs-recipes.pod:12
5054 msgid "comment"
5055 msgstr "коментар"
5056
5057 #. type: textblock
5058 #: ../examples/guestfs-recipes.pod:5
5059 msgid ""
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."
5063 msgstr ""
5064
5065 #. type: textblock
5066 #: ../examples/guestfs-recipes.pod:9
5067 msgid ""
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."
5070 msgstr ""
5071
5072 #. type: textblock
5073 #: ../examples/guestfs-recipes.pod:16
5074 msgid "guestfs-recipes - libguestfs, guestfish and virt tools recipes"
5075 msgstr ""
5076
5077 #. type: textblock
5078 #: ../examples/guestfs-recipes.pod:20
5079 msgid ""
5080 "This page contains recipes for and links to things you can do using "
5081 "libguestfs, L<guestfish(1)> and the virt tools."
5082 msgstr ""
5083
5084 #. type: =head1
5085 #: ../examples/guestfs-recipes.pod:23
5086 msgid "Audit a virtual machine for setuid files"
5087 msgstr ""
5088
5089 #. type: textblock
5090 #: ../examples/guestfs-recipes.pod:25
5091 msgid ""
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."
5094 msgstr ""
5095
5096 #. type: textblock
5097 #: ../examples/guestfs-recipes.pod:28
5098 msgid ""
5099 "https://rwmj.wordpress.com/2010/12/15/tip-audit-virtual-machine-for-setuid-"
5100 "files/#content"
5101 msgstr ""
5102
5103 #. type: =head1
5104 #: ../examples/guestfs-recipes.pod:30
5105 msgid "Change the background image in a Windows XP VM"
5106 msgstr ""
5107
5108 #. type: textblock
5109 #: ../examples/guestfs-recipes.pod:32
5110 msgid ""
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."
5114 msgstr ""
5115
5116 #. type: textblock
5117 #: ../examples/guestfs-recipes.pod:37
5118 msgid ""
5119 "https://lists.fedoraproject.org/pipermail/virt/2011-May/002655.html https://"
5120 "lists.fedoraproject.org/pipermail/virt/2011-May/002658.html"
5121 msgstr ""
5122
5123 #. type: =head1
5124 #: ../examples/guestfs-recipes.pod:40
5125 msgid "Cloning a virtual machine (Linux)"
5126 msgstr ""
5127
5128 #. type: textblock
5129 #: ../examples/guestfs-recipes.pod:42
5130 msgid ""
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 "
5133 "slightly."
5134 msgstr ""
5135
5136 #. type: textblock
5137 #: ../examples/guestfs-recipes.pod:46
5138 msgid ""
5139 "https://rwmj.wordpress.com/2010/09/24/tip-my-procedure-for-cloning-a-fedora-"
5140 "vm/#content"
5141 msgstr ""
5142
5143 #. type: textblock
5144 #: ../examples/guestfs-recipes.pod:48
5145 msgid ""
5146 "Avoid L<virt-clone(1)>.  Currently what to do about virt-clone is under "
5147 "discussion."
5148 msgstr ""
5149
5150 #. type: textblock
5151 #: ../examples/guestfs-recipes.pod:51
5152 msgid "https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html"
5153 msgstr ""
5154
5155 #. type: =head1
5156 #: ../examples/guestfs-recipes.pod:53
5157 msgid "Cloning a virtual machine (Windows)"
5158 msgstr ""
5159
5160 #. type: textblock
5161 #: ../examples/guestfs-recipes.pod:55
5162 msgid ""
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."
5167 msgstr ""
5168
5169 #. type: textblock
5170 #: ../examples/guestfs-recipes.pod:60
5171 msgid ""
5172 "https://github.com/clalancette/oz https://www.redhat.com/archives/virt-tools-"
5173 "list/2011-May/msg00019.html"
5174 msgstr ""
5175
5176 #. type: =head1
5177 #: ../examples/guestfs-recipes.pod:63
5178 msgid "Convert a CD-ROM / DVD / ISO to a tarball"
5179 msgstr ""
5180
5181 #. type: textblock
5182 #: ../examples/guestfs-recipes.pod:65
5183 msgid "This converts input C<cd.iso> to output C<cd.tar.gz>:"
5184 msgstr ""
5185
5186 #. type: verbatim
5187 #: ../examples/guestfs-recipes.pod:67
5188 #, no-wrap
5189 msgid ""
5190 " guestfish --ro -a cd.iso -m /dev/sda tgz-out / cd.tar.gz\n"
5191 "\n"
5192 msgstr ""
5193
5194 #. type: textblock
5195 #: ../examples/guestfs-recipes.pod:69
5196 msgid "To export just a subdirectory, eg. C</files>, do:"
5197 msgstr ""
5198
5199 #. type: verbatim
5200 #: ../examples/guestfs-recipes.pod:71
5201 #, no-wrap
5202 msgid ""
5203 " guestfish --ro -a cd.iso -m /dev/sda tgz-out /files cd.tar.gz\n"
5204 "\n"
5205 msgstr ""
5206
5207 #. type: =head1
5208 #: ../examples/guestfs-recipes.pod:73
5209 msgid "Create empty disk images"
5210 msgstr ""
5211
5212 #. type: textblock
5213 #: ../examples/guestfs-recipes.pod:75
5214 msgid ""
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."
5217 msgstr ""
5218
5219 #. type: textblock
5220 #: ../examples/guestfs-recipes.pod:78
5221 msgid ""
5222 "https://rwmj.wordpress.com/2010/09/08/new-guestfish-n-options-in-1-5-9/"
5223 "#content"
5224 msgstr ""
5225
5226 #. type: =head1
5227 #: ../examples/guestfs-recipes.pod:80
5228 msgid "Dump raw filesystem content from inside a disk image or VM"
5229 msgstr ""
5230
5231 #. type: textblock
5232 #: ../examples/guestfs-recipes.pod:82
5233 msgid ""
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):"
5237 msgstr ""
5238
5239 #. type: verbatim
5240 #: ../examples/guestfs-recipes.pod:86
5241 #, no-wrap
5242 msgid ""
5243 " guestfish --ro -a disk.img run : download /dev/sda1 sda1.img\n"
5244 "\n"
5245 msgstr ""
5246
5247 #. type: verbatim
5248 #: ../examples/guestfs-recipes.pod:88
5249 #, no-wrap
5250 msgid ""
5251 " guestfish --ro -d Guest run : download /dev/vg_guest/lv_root lv.img\n"
5252 "\n"
5253 msgstr ""
5254
5255 #. type: textblock
5256 #: ../examples/guestfs-recipes.pod:90
5257 msgid "To list the filesystems in a disk image, use L<virt-filesystems(1)>."
5258 msgstr ""
5259
5260 #. type: =head1
5261 #: ../examples/guestfs-recipes.pod:92
5262 msgid "Edit grub configuration in a VM"
5263 msgstr ""
5264
5265 #. type: textblock
5266 #: ../examples/guestfs-recipes.pod:94
5267 msgid "You can use this to:"
5268 msgstr ""
5269
5270 #. type: textblock
5271 #: ../examples/guestfs-recipes.pod:100
5272 msgid "Fix a virtual machine that does not boot."
5273 msgstr ""
5274
5275 #. type: textblock
5276 #: ../examples/guestfs-recipes.pod:104
5277 msgid "Change which kernel is used to boot the VM."
5278 msgstr ""
5279
5280 #. type: textblock
5281 #: ../examples/guestfs-recipes.pod:108
5282 msgid "Change kernel command line options."
5283 msgstr ""
5284
5285 #. type: textblock
5286 #: ../examples/guestfs-recipes.pod:112
5287 msgid "Use L<virt-edit(1)> to edit the grub configuration:"
5288 msgstr ""
5289
5290 #. type: verbatim
5291 #: ../examples/guestfs-recipes.pod:114
5292 #, no-wrap
5293 msgid ""
5294 " virt-edit -d BrokenGuest /boot/grub/grub.conf\n"
5295 "\n"
5296 msgstr ""
5297
5298 #. type: textblock
5299 #: ../examples/guestfs-recipes.pod:116
5300 msgid ""
5301 "or for general tinkering inside an unbootable VM use L<virt-rescue(1)> like "
5302 "this:"
5303 msgstr ""
5304
5305 #. type: verbatim
5306 #: ../examples/guestfs-recipes.pod:119
5307 #, no-wrap
5308 msgid ""
5309 " virt-rescue -d BrokenGuest\n"
5310 "\n"
5311 msgstr ""
5312
5313 #. type: =head1
5314 #: ../examples/guestfs-recipes.pod:121
5315 msgid "Export any directory from a VM"
5316 msgstr ""
5317
5318 #. type: textblock
5319 #: ../examples/guestfs-recipes.pod:123
5320 msgid ""
5321 "To export C</home> from a VM into a local directory use L<virt-copy-out(1)>:"
5322 msgstr ""
5323
5324 #. type: verbatim
5325 #: ../examples/guestfs-recipes.pod:126 ../examples/guestfs-testing.pod:93
5326 #, no-wrap
5327 msgid ""
5328 " virt-copy-out -d Guest /home .\n"
5329 "\n"
5330 msgstr ""
5331
5332 #. type: textblock
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
5339 msgid "Notes:"
5340 msgstr "Нотатки:"
5341
5342 #. type: textblock
5343 #: ../examples/guestfs-recipes.pod:134
5344 msgid ""
5345 "The final dot of the command is not a printing error.  It means we want to "
5346 "copy out to the current directory."
5347 msgstr ""
5348
5349 #. type: textblock
5350 #: ../examples/guestfs-recipes.pod:139
5351 msgid "This creates a directory called C<home> under the current directory."
5352 msgstr ""
5353
5354 #. type: textblock
5355 #: ../examples/guestfs-recipes.pod:143
5356 msgid ""
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:"
5360 msgstr ""
5361
5362 #. type: verbatim
5363 #: ../examples/guestfs-recipes.pod:147
5364 #, no-wrap
5365 msgid ""
5366 " virt-copy-out -d WinGuest 'win:c:\\windows\\system32\\config' .\n"
5367 "\n"
5368 msgstr ""
5369
5370 #. type: textblock
5371 #: ../examples/guestfs-recipes.pod:149
5372 msgid "To get the output as a compressed tarball, do:"
5373 msgstr ""
5374
5375 #. type: verbatim
5376 #: ../examples/guestfs-recipes.pod:151
5377 #, no-wrap
5378 msgid ""
5379 " virt-tar-out -d Guest /home - | gzip --best > home.tar.gz\n"
5380 "\n"
5381 msgstr ""
5382
5383 #. type: textblock
5384 #: ../examples/guestfs-recipes.pod:153
5385 msgid ""
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"
5389 msgstr ""
5390
5391 #. type: =head1
5392 #: ../examples/guestfs-recipes.pod:157
5393 msgid "Find out which user is using the most space"
5394 msgstr ""
5395
5396 #. type: textblock
5397 #: ../examples/guestfs-recipes.pod:159
5398 msgid ""
5399 "This simple script examines a Linux guest to find out which user is using "
5400 "the most space in their home directory:"
5401 msgstr ""
5402
5403 #. type: verbatim
5404 #: ../examples/guestfs-recipes.pod:162
5405 #, no-wrap
5406 msgid ""
5407 " #!/bin/sh -\n"
5408 " \n"
5409 msgstr ""
5410
5411 #. type: verbatim
5412 #: ../examples/guestfs-recipes.pod:164 ../fish/guestfish.pod:984
5413 #, no-wrap
5414 msgid ""
5415 " set -e\n"
5416 " \n"
5417 msgstr ""
5418
5419 #. type: verbatim
5420 #: ../examples/guestfs-recipes.pod:166
5421 #, no-wrap
5422 msgid ""
5423 " vm=\"$1\"\n"
5424 " dir=/home\n"
5425 " \n"
5426 msgstr ""
5427
5428 #. type: verbatim
5429 #: ../examples/guestfs-recipes.pod:169
5430 #, no-wrap
5431 msgid ""
5432 " eval $(guestfish --ro -d \"$vm\" -i --listen)\n"
5433 " \n"
5434 msgstr ""
5435
5436 #. type: verbatim
5437 #: ../examples/guestfs-recipes.pod:171
5438 #, no-wrap
5439 msgid ""
5440 " for d in $(guestfish --remote ls \"$dir\"); do\n"
5441 "     echo -n \"$dir/$d\"\n"
5442 "     echo -ne '\\t'\n"
5443 "     guestfish --remote du \"$dir/$d\";\n"
5444 " done | sort -nr -k 2\n"
5445 " \n"
5446 msgstr ""
5447
5448 #. type: verbatim
5449 #: ../examples/guestfs-recipes.pod:177 ../fish/guestfish.pod:941
5450 #, no-wrap
5451 msgid ""
5452 " guestfish --remote exit\n"
5453 "\n"
5454 msgstr ""
5455
5456 #. type: =head1
5457 #: ../examples/guestfs-recipes.pod:179
5458 msgid "Get DHCP address from a VM"
5459 msgstr ""
5460
5461 #. type: textblock
5462 #: ../examples/guestfs-recipes.pod:181
5463 msgid ""
5464 "The link below explains the many different possible techniques for getting "
5465 "the last assigned DHCP address of a virtual machine."
5466 msgstr ""
5467
5468 #. type: textblock
5469 #: ../examples/guestfs-recipes.pod:184
5470 msgid ""
5471 "https://rwmj.wordpress.com/2011/03/31/tip-code-for-getting-dhcp-address-from-"
5472 "a-virtual-machine-disk-image/#content"
5473 msgstr ""
5474
5475 #. type: textblock
5476 #: ../examples/guestfs-recipes.pod:186
5477 msgid ""
5478 "In the libguestfs source examples directory you will find the latest version "
5479 "of the C<virt-dhcp-address.c> program."
5480 msgstr ""
5481
5482 #. type: =head1
5483 #: ../examples/guestfs-recipes.pod:189
5484 msgid "Get the operating system product name string"
5485 msgstr ""
5486
5487 #. type: textblock
5488 #: ../examples/guestfs-recipes.pod:191
5489 msgid "Save the following script into a file called C<product-name.sh>:"
5490 msgstr ""
5491
5492 #. type: verbatim
5493 #: ../examples/guestfs-recipes.pod:193
5494 #, no-wrap
5495 msgid ""
5496 " #!/bin/sh -\n"
5497 " set -e\n"
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"
5502 "\n"
5503 msgstr ""
5504
5505 #. type: textblock
5506 #: ../examples/guestfs-recipes.pod:200
5507 msgid "Make the script executable and run it on a named guest:"
5508 msgstr ""
5509
5510 #. type: verbatim
5511 #: ../examples/guestfs-recipes.pod:202
5512 #, no-wrap
5513 msgid ""
5514 " # product-name.sh RHEL60x64\n"
5515 " Red Hat Enterprise Linux Server release 6.0 (Santiago)\n"
5516 "\n"
5517 msgstr ""
5518
5519 #. type: textblock
5520 #: ../examples/guestfs-recipes.pod:205
5521 msgid ""
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:"
5524 msgstr ""
5525
5526 #. type: verbatim
5527 #: ../examples/guestfs-recipes.pod:209
5528 #, no-wrap
5529 msgid ""
5530 " # virt-inspector RHEL60x64 > xml\n"
5531 " # xpath '//product_name' < xml\n"
5532 " Found 1 nodes:\n"
5533 " -- NODE --\n"
5534 " <product_name>Red Hat Enterprise Linux Server release 6.0 (Santiago)</product_name>\n"
5535 "\n"
5536 msgstr ""
5537
5538 #. type: =head1
5539 #: ../examples/guestfs-recipes.pod:215
5540 msgid "Get the default boot kernel for a Linux VM"
5541 msgstr ""
5542
5543 #. type: textblock
5544 #: ../examples/guestfs-recipes.pod:217
5545 msgid ""
5546 "The link below contains a program to print the default boot kernel for a "
5547 "Linux VM."
5548 msgstr ""
5549
5550 #. type: textblock
5551 #: ../examples/guestfs-recipes.pod:220
5552 msgid ""
5553 "https://rwmj.wordpress.com/2010/10/30/tip-use-augeas-to-get-the-default-boot-"
5554 "kernel-for-a-vm/#content"
5555 msgstr ""
5556
5557 #. type: textblock
5558 #: ../examples/guestfs-recipes.pod:222
5559 msgid ""
5560 "It uses Augeas, and the technique is generally applicable for many different "
5561 "tasks, such as:"
5562 msgstr ""
5563
5564 #. type: textblock
5565 #: ../examples/guestfs-recipes.pod:229
5566 msgid "listing the user accounts in the guest"
5567 msgstr ""
5568
5569 #. type: textblock
5570 #: ../examples/guestfs-recipes.pod:233
5571 msgid "what repositories is it configured to use"
5572 msgstr ""
5573
5574 #. type: textblock
5575 #: ../examples/guestfs-recipes.pod:237
5576 msgid "what NTP servers does it connect to"
5577 msgstr ""
5578
5579 #. type: textblock
5580 #: ../examples/guestfs-recipes.pod:241
5581 msgid "what were the boot messages last time it booted"
5582 msgstr ""
5583
5584 #. type: textblock
5585 #: ../examples/guestfs-recipes.pod:245
5586 msgid "listing who was logged in recently"
5587 msgstr ""
5588
5589 #. type: textblock
5590 #: ../examples/guestfs-recipes.pod:249
5591 msgid "http://augeas.net/"
5592 msgstr ""
5593
5594 #. type: =head1
5595 #: ../examples/guestfs-recipes.pod:251
5596 msgid "Install RPMs in a guest"
5597 msgstr ""
5598
5599 #. type: textblock
5600 #: ../examples/guestfs-recipes.pod:253
5601 msgid ""
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."
5606 msgstr ""
5607
5608 #. type: textblock
5609 #: ../examples/guestfs-recipes.pod:259
5610 msgid ""
5611 "https://rwmj.wordpress.com/2010/12/01/tip-install-rpms-in-a-guest/#content"
5612 msgstr ""
5613
5614 #. type: =head1
5615 #: ../examples/guestfs-recipes.pod:261
5616 msgid "List applications installed in a VM"
5617 msgstr ""
5618
5619 #. type: textblock
5620 #: ../examples/guestfs-recipes.pod:263
5621 msgid "Save the following to a file C<list-apps.sh>:"
5622 msgstr ""
5623
5624 #. type: verbatim
5625 #: ../examples/guestfs-recipes.pod:265
5626 #, no-wrap
5627 msgid ""
5628 " #!/bin/sh -\n"
5629 " set -e\n"
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"
5634 "\n"
5635 msgstr ""
5636
5637 #. type: textblock
5638 #: ../examples/guestfs-recipes.pod:272
5639 msgid ""
5640 "Make the file executable and then you can run it on any named virtual "
5641 "machine:"
5642 msgstr ""
5643
5644 #. type: verbatim
5645 #: ../examples/guestfs-recipes.pod:275
5646 #, no-wrap
5647 msgid ""
5648 " # list-apps.sh WinGuest\n"
5649 " [0] = {\n"
5650 "   app_name: Mozilla Firefox (3.6.12)\n"
5651 "   app_display_name: Mozilla Firefox (3.6.12)\n"
5652 "   app_epoch: 0\n"
5653 "   app_version: 3.6.12 (en-GB)\n"
5654 "   app_release:\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"
5660 "   app_summary:\n"
5661 "   app_description: Mozilla Firefox\n"
5662 " }\n"
5663 " [1] = {\n"
5664 "   app_name: VLC media player\n"
5665 "   app_display_name: VLC media player 1.1.5\n"
5666 "   app_epoch: 0\n"
5667 "   app_version: 1.1.5\n"
5668 "   app_release:\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"
5674 "   app_summary:\n"
5675 "   app_description:\n"
5676 " }\n"
5677 "\n"
5678 msgstr ""
5679
5680 #. type: textblock
5681 #: ../examples/guestfs-recipes.pod:305
5682 msgid ""
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)"
5685 ">."
5686 msgstr ""
5687
5688 #. type: =head1
5689 #: ../examples/guestfs-recipes.pod:309
5690 msgid "List files and directories in a VM"
5691 msgstr ""
5692
5693 #. type: textblock
5694 #: ../examples/guestfs-recipes.pod:311
5695 msgid "This involves using the L<guestfish(1)> C<find0> command like this:"
5696 msgstr ""
5697
5698 #. type: verbatim
5699 #: ../examples/guestfs-recipes.pod:313
5700 #, no-wrap
5701 msgid ""
5702 " guestfish --ro -d Guest -i find0 / - | tr '\\0' '\\n' | sort\n"
5703 "\n"
5704 msgstr ""
5705
5706 #. type: =head1
5707 #: ../examples/guestfs-recipes.pod:315
5708 msgid "List services in a Windows VM"
5709 msgstr ""
5710
5711 #. type: textblock
5712 #: ../examples/guestfs-recipes.pod:317
5713 msgid ""
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 "
5716 "on demand."
5717 msgstr ""
5718
5719 #. type: textblock
5720 #: ../examples/guestfs-recipes.pod:321
5721 msgid ""
5722 "https://rwmj.wordpress.com/2010/12/10/tip-list-services-in-a-windows-guest/"
5723 "#content"
5724 msgstr ""
5725
5726 #. type: =head1
5727 #: ../examples/guestfs-recipes.pod:323
5728 msgid "Make a disk image sparse"
5729 msgstr ""
5730
5731 #. type: textblock
5732 #: ../examples/guestfs-recipes.pod:325
5733 msgid ""
5734 "The link below contains some guides for making a disk image sparse (or "
5735 "reintroducing sparseness)."
5736 msgstr ""
5737
5738 #. type: textblock
5739 #: ../examples/guestfs-recipes.pod:328
5740 msgid ""
5741 "https://rwmj.wordpress.com/2010/10/19/tip-making-a-disk-image-sparse/#content"
5742 msgstr ""
5743
5744 #. type: =head1
5745 #: ../examples/guestfs-recipes.pod:330
5746 msgid "Monitor disk usage over time"
5747 msgstr ""
5748
5749 #. type: textblock
5750 #: ../examples/guestfs-recipes.pod:332
5751 msgid ""
5752 "You can use L<virt-df(1)> to monitor disk usage of your guests over time.  "
5753 "The link below contains a guide."
5754 msgstr ""
5755
5756 #. type: textblock
5757 #: ../examples/guestfs-recipes.pod:335
5758 msgid "http://virt-tools.org/learning/advanced-virt-df/"
5759 msgstr ""
5760
5761 #. type: =head1
5762 #: ../examples/guestfs-recipes.pod:337
5763 msgid "Reading the Windows Event Log from Windows Vista (or later)"
5764 msgstr ""
5765
5766 #. type: textblock
5767 #: ../examples/guestfs-recipes.pod:339
5768 msgid ""
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."
5772 msgstr ""
5773
5774 #. type: textblock
5775 #: ../examples/guestfs-recipes.pod:343
5776 msgid ""
5777 "https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-"
5778 "guestfish/#content"
5779 msgstr ""
5780
5781 #. type: =head1
5782 #: ../examples/guestfs-recipes.pod:345
5783 msgid "Remove root password (Linux)"
5784 msgstr ""
5785
5786 #. type: textblock
5787 #: ../examples/guestfs-recipes.pod:347
5788 msgid ""
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:"
5791 msgstr ""
5792
5793 #. type: verbatim
5794 #: ../examples/guestfs-recipes.pod:350
5795 #, no-wrap
5796 msgid ""
5797 " virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
5798 "\n"
5799 msgstr ""
5800
5801 #. type: =head1
5802 #: ../examples/guestfs-recipes.pod:352
5803 msgid "Remove Administrator password (Windows)"
5804 msgstr ""
5805
5806 #. type: textblock
5807 #: ../examples/guestfs-recipes.pod:354
5808 msgid ""
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:"
5812 msgstr ""
5813
5814 #. type: textblock
5815 #: ../examples/guestfs-recipes.pod:359
5816 msgid ""
5817 "https://mdbooth.wordpress.com/2010/10/18/resetting-a-windows-guests-"
5818 "administrator-password-with-guestfish/"
5819 msgstr ""
5820
5821 #. type: =head1
5822 #: ../examples/guestfs-recipes.pod:361
5823 msgid "Unpack a live CD"
5824 msgstr ""
5825
5826 #. type: textblock
5827 #: ../examples/guestfs-recipes.pod:363
5828 msgid ""
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."
5832 msgstr ""
5833
5834 #. type: textblock
5835 #: ../examples/guestfs-recipes.pod:367
5836 msgid ""
5837 "https://rwmj.wordpress.com/2009/07/15/unpack-the-russian-doll-of-a-f11-live-"
5838 "cd/#content"
5839 msgstr ""
5840
5841 #. type: =head1
5842 #: ../examples/guestfs-recipes.pod:369
5843 msgid "Uploading and downloading files"
5844 msgstr ""
5845
5846 #. type: textblock
5847 #: ../examples/guestfs-recipes.pod:371
5848 msgid ""
5849 "The link below contains general tips on uploading (copying in)  and "
5850 "downloading (copying out) files from VMs."
5851 msgstr ""
5852
5853 #. type: textblock
5854 #: ../examples/guestfs-recipes.pod:374
5855 msgid ""
5856 "https://rwmj.wordpress.com/2010/12/02/tip-uploading-and-downloading/#content"
5857 msgstr ""
5858
5859 #. type: =head1
5860 #: ../examples/guestfs-recipes.pod:376
5861 msgid "Use libguestfs tools on VMware ESX guests"
5862 msgstr ""
5863
5864 #. type: textblock
5865 #: ../examples/guestfs-recipes.pod:378
5866 msgid ""
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."
5869 msgstr ""
5870
5871 #. type: textblock
5872 #: ../examples/guestfs-recipes.pod:382
5873 msgid ""
5874 "https://rwmj.wordpress.com/2011/05/10/tip-use-libguestfs-on-vmware-esx-"
5875 "guests/#content"
5876 msgstr ""
5877
5878 #. type: textblock
5879 #: ../examples/guestfs-recipes.pod:386
5880 msgid ""
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/>."
5884 msgstr ""
5885
5886 #. type: textblock
5887 #: ../examples/guestfs-recipes.pod:403
5888 msgid "Copyright (C) 2009-2011 Red Hat Inc. L<http://libguestfs.org/>"
5889 msgstr ""
5890
5891 #. type: textblock
5892 #: ../examples/guestfs-testing.pod:5
5893 msgid "guestfs-testing - manual testing of libguestfs, you can help!"
5894 msgstr ""
5895
5896 #. type: textblock
5897 #: ../examples/guestfs-testing.pod:9
5898 msgid ""
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!"
5902 msgstr ""
5903
5904 #. type: textblock
5905 #: ../examples/guestfs-testing.pod:13
5906 msgid "These tests require libguestfs E<ge> 1.14."
5907 msgstr ""
5908
5909 #. type: textblock
5910 #: ../examples/guestfs-testing.pod:15
5911 msgid ""
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."
5914 msgstr ""
5915
5916 #. type: textblock
5917 #: ../examples/guestfs-testing.pod:18
5918 msgid "You can report bugs you find through this link:"
5919 msgstr ""
5920
5921 #. type: textblock
5922 #: ../examples/guestfs-testing.pod:20
5923 #, fuzzy
5924 #| msgid ""
5925 #| "L<https://bugzilla.redhat.com/enter_bug.cgi?"
5926 #| "component=libguestfs&product=Virtualization+Tools>"
5927 msgid ""
5928 "https://bugzilla.redhat.com/enter_bug.cgi?"
5929 "component=libguestfs&product=Virtualization+Tools"
5930 msgstr ""
5931 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
5932 "component=libguestfs&product=Virtualization+Tools>"
5933
5934 #. type: textblock
5935 #: ../examples/guestfs-testing.pod:22
5936 msgid ""
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 "
5939 "your message):"
5940 msgstr ""
5941
5942 #. type: textblock
5943 #: ../examples/guestfs-testing.pod:26
5944 msgid "https://www.redhat.com/mailman/listinfo/libguestfs"
5945 msgstr ""
5946
5947 #. type: =head1
5948 #: ../examples/guestfs-testing.pod:28
5949 msgid "TESTS"
5950 msgstr ""
5951
5952 #. type: =head2
5953 #: ../examples/guestfs-testing.pod:30
5954 msgid "Check KVM acceleration is being used."
5955 msgstr ""
5956
5957 #. type: textblock
5958 #: ../examples/guestfs-testing.pod:32
5959 msgid ""
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:"
5963 msgstr ""
5964
5965 #. type: verbatim
5966 #: ../examples/guestfs-testing.pod:36
5967 #, no-wrap
5968 msgid ""
5969 " time guestfish -a /dev/null run\n"
5970 "\n"
5971 msgstr ""
5972
5973 #. type: textblock
5974 #: ../examples/guestfs-testing.pod:38
5975 msgid ""
5976 "After a few runs, the time should settle down to a few seconds (under 5 "
5977 "seconds on fast 64 bit hardware)."
5978 msgstr ""
5979
5980 #. type: textblock
5981 #: ../examples/guestfs-testing.pod:41
5982 msgid "How to check for hardware virt:"
5983 msgstr ""
5984
5985 #. type: textblock
5986 #: ../examples/guestfs-testing.pod:43
5987 msgid "http://virt-tools.org/learning/check-hardware-virt/"
5988 msgstr ""
5989
5990 #. type: textblock
5991 #: ../examples/guestfs-testing.pod:45
5992 msgid ""
5993 "If the command above does not work at all, use L<libguestfs-test-tool(1)>."
5994 msgstr ""
5995
5996 #. type: =head2
5997 #: ../examples/guestfs-testing.pod:48
5998 msgid "Run virt-alignment-scan on all your guests."
5999 msgstr ""
6000
6001 #. type: textblock
6002 #: ../examples/guestfs-testing.pod:50
6003 msgid "Run L<virt-alignment-scan(1)> on guests or disk images:"
6004 msgstr ""
6005
6006 #. type: verbatim
6007 #: ../examples/guestfs-testing.pod:52
6008 #, no-wrap
6009 msgid ""
6010 " virt-alignment-scan -a /path/to/disk.img\n"
6011 "\n"
6012 msgstr ""
6013
6014 #. type: textblock
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
6018 msgid "or:"
6019 msgstr "або:"
6020
6021 #. type: verbatim
6022 #: ../examples/guestfs-testing.pod:56
6023 #, no-wrap
6024 msgid ""
6025 " virt-alignment-scan -d Guest\n"
6026 "\n"
6027 msgstr ""
6028
6029 #. type: textblock
6030 #: ../examples/guestfs-testing.pod:58
6031 msgid "Does the alignment report match how the guest partitions are aligned?"
6032 msgstr ""
6033
6034 #. type: =head2
6035 #: ../examples/guestfs-testing.pod:60
6036 #, fuzzy
6037 #| msgid ""
6038 #| " virt-cat domname file\n"
6039 #| "\n"
6040 msgid "Run virt-cat on some files in guests."
6041 msgstr ""
6042 " virt-cat назва_домену файл\n"
6043 "\n"
6044
6045 #. type: textblock
6046 #: ../examples/guestfs-testing.pod:62
6047 msgid "L<virt-cat(1)> can display files from guests.  For a Linux guest, try:"
6048 msgstr ""
6049
6050 #. type: verbatim
6051 #: ../examples/guestfs-testing.pod:64
6052 #, fuzzy, no-wrap
6053 #| msgid ""
6054 #| " virt-cat -d mydomain /etc/fstab\n"
6055 #| "\n"
6056 msgid ""
6057 " virt-cat LinuxGuest /etc/passwd\n"
6058 "\n"
6059 msgstr ""
6060 " virt-cat -d mydomain /etc/fstab\n"
6061 "\n"
6062
6063 #. type: textblock
6064 #: ../examples/guestfs-testing.pod:66
6065 msgid "A recent feature is support for Windows paths, for example:"
6066 msgstr ""
6067
6068 #. type: verbatim
6069 #: ../examples/guestfs-testing.pod:68
6070 #, no-wrap
6071 msgid ""
6072 " virt-cat WindowsGuest 'c:\\windows\\win.ini'\n"
6073 "\n"
6074 msgstr ""
6075
6076 #. type: textblock
6077 #: ../examples/guestfs-testing.pod:70
6078 msgid ""
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?"
6081 msgstr ""
6082
6083 #. type: =head2
6084 #: ../examples/guestfs-testing.pod:73
6085 msgid "B<*> Copy some files into a B<shut off> guest."
6086 msgstr ""
6087
6088 #. type: textblock
6089 #: ../examples/guestfs-testing.pod:75
6090 msgid ""
6091 "L<virt-copy-in(1)> can recursively copy files and directories into a guest "
6092 "or disk image."
6093 msgstr ""
6094
6095 #. type: verbatim
6096 #: ../examples/guestfs-testing.pod:78
6097 #, no-wrap
6098 msgid ""
6099 " virt-copy-in -d Guest /etc /tmp\n"
6100 "\n"
6101 msgstr ""
6102
6103 #. type: textblock
6104 #: ../examples/guestfs-testing.pod:80
6105 msgid ""
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 "
6108 "and directories?"
6109 msgstr ""
6110
6111 #. type: textblock
6112 #: ../examples/guestfs-testing.pod:84
6113 msgid "Shut the guest down and try copying multiple files and directories:"
6114 msgstr ""
6115
6116 #. type: verbatim
6117 #: ../examples/guestfs-testing.pod:86
6118 #, no-wrap
6119 msgid ""
6120 " virt-copy-in -d Guest /home /etc/issue /tmp\n"
6121 "\n"
6122 msgstr ""
6123
6124 #. type: =head2
6125 #: ../examples/guestfs-testing.pod:88
6126 msgid "Copy some files out of a guest."
6127 msgstr ""
6128
6129 #. type: textblock
6130 #: ../examples/guestfs-testing.pod:90
6131 msgid ""
6132 "L<virt-copy-out(1)> can recursively copy files and directories out of a "
6133 "guest or disk image."
6134 msgstr ""
6135
6136 #. type: textblock
6137 #: ../examples/guestfs-testing.pod:95
6138 msgid "Note the final space and period in the command is not a typo."
6139 msgstr ""
6140
6141 #. type: textblock
6142 #: ../examples/guestfs-testing.pod:97
6143 msgid "This should copy C</home> from the guest into the current directory."
6144 msgstr ""
6145
6146 #. type: =head2
6147 #: ../examples/guestfs-testing.pod:99
6148 msgid "Run virt-df."
6149 msgstr ""
6150
6151 #. type: textblock
6152 #: ../examples/guestfs-testing.pod:101
6153 msgid "L<virt-df(1)> lists disk space.  Run:"
6154 msgstr ""
6155
6156 #. type: verbatim
6157 #: ../examples/guestfs-testing.pod:103
6158 #, fuzzy, no-wrap
6159 #| msgid ""
6160 #| " df\n"
6161 #| "\n"
6162 msgid ""
6163 " virt-df\n"
6164 "\n"
6165 msgstr ""
6166 " df\n"
6167 "\n"
6168
6169 #. type: textblock
6170 #: ../examples/guestfs-testing.pod:105
6171 msgid "Do the results match what's reported inside the guests?"
6172 msgstr ""
6173
6174 #. type: =head2
6175 #: ../examples/guestfs-testing.pod:107
6176 msgid "Try importing virt-df CSV output into a spreadsheet or database."
6177 msgstr ""
6178
6179 #. type: textblock
6180 #: ../examples/guestfs-testing.pod:109 ../src/guestfs.pod:3083
6181 msgid "Run:"
6182 msgstr ""
6183
6184 #. type: verbatim
6185 #: ../examples/guestfs-testing.pod:111
6186 #, no-wrap
6187 msgid ""
6188 " virt-df --csv > /tmp/report.csv\n"
6189 "\n"
6190 msgstr ""
6191
6192 #. type: textblock
6193 #: ../examples/guestfs-testing.pod:113
6194 msgid ""
6195 "Now try to load this into your favorite spreadsheet or database.  Are the "
6196 "results reproduced faithfully in the spreadsheet/database?"
6197 msgstr ""
6198
6199 #. type: textblock
6200 #: ../examples/guestfs-testing.pod:116
6201 msgid ""
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"
6204 msgstr ""
6205
6206 #. type: =head2
6207 #: ../examples/guestfs-testing.pod:119
6208 msgid "B<*> Edit a file in a B<shut off> guest."
6209 msgstr ""
6210
6211 #. type: textblock
6212 #: ../examples/guestfs-testing.pod:121
6213 msgid ""
6214 "L<virt-edit(1)> can edit files in guests.  Try this command on a RHEL or "
6215 "Fedora guest:"
6216 msgstr ""
6217
6218 #. type: verbatim
6219 #: ../examples/guestfs-testing.pod:124
6220 #, no-wrap
6221 msgid ""
6222 " virt-edit LinuxGuest /etc/sysconfig/network\n"
6223 "\n"
6224 msgstr ""
6225
6226 #. type: textblock
6227 #: ../examples/guestfs-testing.pod:126
6228 msgid "On other Linux guests try editing other files such as:"
6229 msgstr ""
6230
6231 #. type: verbatim
6232 #: ../examples/guestfs-testing.pod:128
6233 #, no-wrap
6234 msgid ""
6235 " virt-edit LinuxGuest /etc/motd\n"
6236 "\n"
6237 msgstr ""
6238
6239 #. type: textblock
6240 #: ../examples/guestfs-testing.pod:130
6241 msgid "Are the changes seen inside the guest when it is booted?"
6242 msgstr ""
6243
6244 #. type: =head2
6245 #: ../examples/guestfs-testing.pod:132
6246 msgid "Display the filesystems / partitions / LVs in a guest."
6247 msgstr ""
6248
6249 #. type: textblock
6250 #: ../examples/guestfs-testing.pod:134
6251 msgid ""
6252 "L<virt-filesystems(1)> can be used to display filesystems in a guest.  Try "
6253 "this command on any disk image or guest:"
6254 msgstr ""
6255
6256 #. type: verbatim
6257 #: ../examples/guestfs-testing.pod:137
6258 #, fuzzy, no-wrap
6259 #| msgid ""
6260 #| " virt-filesystems --format=raw -a disk.img\n"
6261 #| "\n"
6262 msgid ""
6263 " virt-filesystems -a /path/to/disk.img --all --long -h\n"
6264 "\n"
6265 msgstr ""
6266 " virt-filesystems --format=raw -a диск.img\n"
6267 "\n"
6268
6269 #. type: verbatim
6270 #: ../examples/guestfs-testing.pod:141
6271 #, fuzzy, no-wrap
6272 #| msgid ""
6273 #| " virt-filesystems [--options] -d domname\n"
6274 #| "\n"
6275 msgid ""
6276 " virt-filesystems -d Guest --all --long -h\n"
6277 "\n"
6278 msgstr ""
6279 " virt-filesystems [--параметри] -d назва_домену\n"
6280 "\n"
6281
6282 #. type: textblock
6283 #: ../examples/guestfs-testing.pod:143
6284 msgid "Do the results match what is seen in the guest?"
6285 msgstr ""
6286
6287 #. type: =head2
6288 #: ../examples/guestfs-testing.pod:145
6289 msgid "Run virt-inspector on all your guests."
6290 msgstr ""
6291
6292 #. type: textblock
6293 #: ../examples/guestfs-testing.pod:147
6294 msgid ""
6295 "Use L<virt-inspector(1)> to get a report on all of your guests or disk "
6296 "images:"
6297 msgstr ""
6298
6299 #. type: verbatim
6300 #: ../examples/guestfs-testing.pod:150
6301 #, fuzzy, no-wrap
6302 #| msgid ""
6303 #| " virt-cat disk.img file\n"
6304 #| "\n"
6305 msgid ""
6306 " virt-inspector -a /path/to/disk.img | less\n"
6307 "\n"
6308 msgstr ""
6309 " virt-cat диск.img файл\n"
6310 "\n"
6311
6312 #. type: verbatim
6313 #: ../examples/guestfs-testing.pod:154
6314 #, no-wrap
6315 msgid ""
6316 " virt-inspector -d Guest | less\n"
6317 "\n"
6318 msgstr ""
6319
6320 #. type: textblock
6321 #: ../examples/guestfs-testing.pod:156
6322 msgid "Do the results match what is actually in the guest?"
6323 msgstr ""
6324
6325 #. type: =head2
6326 #: ../examples/guestfs-testing.pod:158
6327 msgid "Try the auditing features of virt-ls on all your guests."
6328 msgstr ""
6329
6330 #. type: verbatim
6331 #: ../examples/guestfs-testing.pod:162
6332 #, fuzzy, no-wrap
6333 #| msgid ""
6334 #| " $ virt-ls -R -d guest /tmp\n"
6335 #| " foo\n"
6336 #| " foo/bar\n"
6337 #| " [etc.]\n"
6338 #| "\n"
6339 msgid ""
6340 " virt-ls -lR -d Guest / | grep '^- [42]'\n"
6341 "\n"
6342 msgstr ""
6343 " $ virt-ls -R -d guest /tmp\n"
6344 " foo\n"
6345 " foo/bar\n"
6346 " [тощо]\n"
6347 "\n"
6348
6349 #. type: verbatim
6350 #: ../examples/guestfs-testing.pod:166
6351 #, fuzzy, no-wrap
6352 #| msgid ""
6353 #| " $ virt-ls -R -d guest /tmp\n"
6354 #| " foo\n"
6355 #| " foo/bar\n"
6356 #| " [etc.]\n"
6357 #| "\n"
6358 msgid ""
6359 " virt-ls -lR -d Guest / | grep '^d ...7'\n"
6360 "\n"
6361 msgstr ""
6362 " $ virt-ls -R -d guest /tmp\n"
6363 " foo\n"
6364 " foo/bar\n"
6365 " [тощо]\n"
6366 "\n"
6367
6368 #. type: verbatim
6369 #: ../examples/guestfs-testing.pod:170
6370 #, fuzzy, no-wrap
6371 #| msgid ""
6372 #| " $ virt-ls -R -d guest /tmp\n"
6373 #| " foo\n"
6374 #| " foo/bar\n"
6375 #| " [etc.]\n"
6376 #| "\n"
6377 msgid ""
6378 " virt-ls -lR -d Guest / | grep '^s'\n"
6379 "\n"
6380 msgstr ""
6381 " $ virt-ls -R -d guest /tmp\n"
6382 " foo\n"
6383 " foo/bar\n"
6384 " [тощо]\n"
6385 "\n"
6386
6387 #. type: verbatim
6388 #: ../examples/guestfs-testing.pod:174
6389 #, no-wrap
6390 msgid ""
6391 " virt-ls -lR -d Guest / | grep -i '^-.*\\.png$'\n"
6392 "\n"
6393 msgstr ""
6394
6395 #. type: textblock
6396 #: ../examples/guestfs-testing.pod:176
6397 msgid "Display files larger than 10MB in home directories:"
6398 msgstr ""
6399
6400 #. type: verbatim
6401 #: ../examples/guestfs-testing.pod:178
6402 #, no-wrap
6403 msgid ""
6404 " virt-ls -lR -d Guest /home | awk '$3 > 10*1024*1024'\n"
6405 "\n"
6406 msgstr ""
6407
6408 #. type: verbatim
6409 #: ../examples/guestfs-testing.pod:182
6410 #, no-wrap
6411 msgid ""
6412 " virt-ls -lR -d Guest --time-days / | awk '$6 <= 7'\n"
6413 "\n"
6414 msgstr ""
6415
6416 #. type: verbatim
6417 #: ../examples/guestfs-testing.pod:186
6418 #, no-wrap
6419 msgid ""
6420 " virt-ls -lR -d Guest --time-days / | grep '^-' | awk '$6 < 1'\n"
6421 "\n"
6422 msgstr ""
6423
6424 #. type: textblock
6425 #: ../examples/guestfs-testing.pod:188
6426 msgid "Do the results match what is in the guest?"
6427 msgstr ""
6428
6429 #. type: =head2
6430 #: ../examples/guestfs-testing.pod:190
6431 msgid "Create a disk image from a tarball."
6432 msgstr ""
6433
6434 #. type: textblock
6435 #: ../examples/guestfs-testing.pod:192
6436 msgid ""
6437 "Use L<virt-make-fs(1)> to create a disk image from any tarball that you "
6438 "happen to have:"
6439 msgstr ""
6440
6441 #. type: verbatim
6442 #: ../examples/guestfs-testing.pod:195
6443 #, no-wrap
6444 msgid ""
6445 " virt-make-fs --partition=mbr --type=vfat /any/tarball.tar.gz output.img\n"
6446 "\n"
6447 msgstr ""
6448
6449 #. type: textblock
6450 #: ../examples/guestfs-testing.pod:197
6451 msgid ""
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 "
6454 "Windows guest."
6455 msgstr ""
6456
6457 #. type: textblock
6458 #: ../examples/guestfs-testing.pod:201
6459 msgid "Try other partitioning schemes, eg. I<--partition=gpt>."
6460 msgstr ""
6461
6462 #. type: textblock
6463 #: ../examples/guestfs-testing.pod:203
6464 msgid "Try other filesystem formats, eg. I<--type=ntfs>, I<--type=ext2>."
6465 msgstr ""
6466
6467 #. type: =head2
6468 #: ../examples/guestfs-testing.pod:205
6469 msgid "B<*> Run virt-rescue on a B<shut off> disk image or guest."
6470 msgstr ""
6471
6472 #. type: textblock
6473 #: ../examples/guestfs-testing.pod:207
6474 msgid ""
6475 "Use L<virt-rescue(1)> to examine, rescue or repair a B<shut off> guest or "
6476 "disk image:"
6477 msgstr ""
6478
6479 #. type: verbatim
6480 #: ../examples/guestfs-testing.pod:210
6481 #, fuzzy, no-wrap
6482 #| msgid ""
6483 #| " virt-cat disk.img file\n"
6484 #| "\n"
6485 msgid ""
6486 " virt-rescue -a /path/to/disk.img\n"
6487 "\n"
6488 msgstr ""
6489 " virt-cat диск.img файл\n"
6490 "\n"
6491
6492 #. type: verbatim
6493 #: ../examples/guestfs-testing.pod:214
6494 #, no-wrap
6495 msgid ""
6496 " virt-rescue -d Guest\n"
6497 "\n"
6498 msgstr ""
6499
6500 #. type: textblock
6501 #: ../examples/guestfs-testing.pod:216
6502 msgid "Can you use ordinary shell commands to examine the guest?"
6503 msgstr ""
6504
6505 #. type: =head2
6506 #: ../examples/guestfs-testing.pod:218
6507 msgid "B<*> Resize your guests."
6508 msgstr ""
6509
6510 #. type: textblock
6511 #: ../examples/guestfs-testing.pod:220
6512 msgid ""
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:"
6515 msgstr ""
6516
6517 #. type: verbatim
6518 #: ../examples/guestfs-testing.pod:224
6519 #, no-wrap
6520 msgid ""
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"
6525 "\n"
6526 msgstr ""
6527
6528 #. type: textblock
6529 #: ../examples/guestfs-testing.pod:229
6530 msgid "Does the guest still boot? Try expanding other partitions."
6531 msgstr ""
6532
6533 #. type: =head2
6534 #: ../examples/guestfs-testing.pod:231
6535 msgid "B<*> Sparsify a guest disk."
6536 msgstr ""
6537
6538 #. type: textblock
6539 #: ../examples/guestfs-testing.pod:233
6540 msgid "Using L<virt-sparsify(1)>, make a disk image more sparse:"
6541 msgstr ""
6542
6543 #. type: verbatim
6544 #: ../examples/guestfs-testing.pod:235
6545 #, fuzzy, no-wrap
6546 #| msgid ""
6547 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
6548 #| "\n"
6549 msgid ""
6550 " virt-sparsify /path/to/olddisk.img newdisk.img\n"
6551 "\n"
6552 msgstr ""
6553 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
6554 "\n"
6555
6556 #. type: textblock
6557 #: ../examples/guestfs-testing.pod:237
6558 msgid ""
6559 "Is C<newdisk.img> still bootable after sparsifying? Is the resulting disk "
6560 "image smaller (use C<du> to check)?"
6561 msgstr ""
6562
6563 #. type: =head2
6564 #: ../examples/guestfs-testing.pod:240
6565 msgid "B<*> \"sysprep\" a B<shut off> Linux guest."
6566 msgstr ""
6567
6568 #. type: textblock
6569 #: ../examples/guestfs-testing.pod:242
6570 msgid ""
6571 "Note that this really will mess up an existing guest, so it's better to "
6572 "clone the guest before trying this."
6573 msgstr ""
6574
6575 #. type: verbatim
6576 #: ../examples/guestfs-testing.pod:245
6577 #, no-wrap
6578 msgid ""
6579 " virt-sysprep --hostname newhost.example.com -a /path/to/disk.img\n"
6580 "\n"
6581 msgstr ""
6582
6583 #. type: textblock
6584 #: ../examples/guestfs-testing.pod:247
6585 msgid ""
6586 "Was the sysprep successful? After booting, what changes were made and were "
6587 "they successful?"
6588 msgstr ""
6589
6590 #. type: =head2
6591 #: ../examples/guestfs-testing.pod:250
6592 msgid "Dump the Windows Registry from your Windows guests."
6593 msgstr ""
6594
6595 #. type: textblock
6596 #: ../examples/guestfs-testing.pod:252
6597 msgid ""
6598 "Use L<virt-win-reg(1)> to dump out the Windows Registry from any Windows "
6599 "guests that you have."
6600 msgstr ""
6601
6602 #. type: verbatim
6603 #: ../examples/guestfs-testing.pod:255
6604 #, no-wrap
6605 msgid ""
6606 " virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\Software' |\n"
6607 "   less\n"
6608 "\n"
6609 msgstr ""
6610
6611 #. type: verbatim
6612 #: ../examples/guestfs-testing.pod:258
6613 #, no-wrap
6614 msgid ""
6615 " virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\System' |\n"
6616 "   less\n"
6617 "\n"
6618 msgstr ""
6619
6620 #. type: textblock
6621 #: ../examples/guestfs-testing.pod:261
6622 msgid "Does the output match running C<regedit> inside the guest?"
6623 msgstr ""
6624
6625 #. type: textblock
6626 #: ../examples/guestfs-testing.pod:263
6627 msgid ""
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:"
6630 msgstr ""
6631
6632 #. type: verbatim
6633 #: ../examples/guestfs-testing.pod:266
6634 #, no-wrap
6635 msgid ""
6636 " virt-win-reg --unsafe-printable-strings WindowsGuest 'HKEY_USERS\\username' |\n"
6637 "   less\n"
6638 "\n"
6639 msgstr ""
6640
6641 #. type: textblock
6642 #: ../examples/guestfs-testing.pod:271
6643 #, fuzzy
6644 #| msgid ""
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/>."
6647 msgid ""
6648 "L<guestfs(3)>, L<guestfish(1)>, L<guestfs-examples(3)>, L<http://libguestfs."
6649 "org/>."
6650 msgstr ""
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/>."
6653
6654 #. type: =head2
6655 #: ../fish/guestfish-actions.pod:1
6656 msgid "add-cdrom"
6657 msgstr ""
6658
6659 #. type: verbatim
6660 #: ../fish/guestfish-actions.pod:3
6661 #, no-wrap
6662 msgid ""
6663 " add-cdrom filename\n"
6664 "\n"
6665 msgstr ""
6666
6667 #. type: textblock
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."
6670 msgstr ""
6671
6672 #. type: textblock
6673 #: ../fish/guestfish-actions.pod:7 ../src/guestfs-actions.pod:16
6674 msgid "This is equivalent to the qemu parameter I<-cdrom filename>."
6675 msgstr ""
6676
6677 #. type: textblock
6678 #: ../fish/guestfish-actions.pod:15
6679 msgid ""
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 "
6683 "instead."
6684 msgstr ""
6685
6686 #. type: textblock
6687 #: ../fish/guestfish-actions.pod:22
6688 msgid ""
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."
6692 msgstr ""
6693
6694 #. type: textblock
6695 #: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:214
6696 #: ../fish/guestfish-actions.pod:228
6697 msgid ""
6698 "I<This function is deprecated.> In new code, use the L</add_drive_opts> call "
6699 "instead."
6700 msgstr ""
6701
6702 #. type: textblock
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
6721 msgid ""
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 "
6724 "these functions."
6725 msgstr ""
6726
6727 #. type: =head2
6728 #: ../fish/guestfish-actions.pod:35
6729 msgid "add-domain"
6730 msgstr "add-domain"
6731
6732 #. type: =head2
6733 #: ../fish/guestfish-actions.pod:37
6734 msgid "domain"
6735 msgstr "домен"
6736
6737 #. type: verbatim
6738 #: ../fish/guestfish-actions.pod:39
6739 #, no-wrap
6740 msgid ""
6741 " add-domain dom [libvirturi:..] [readonly:true|false] [iface:..] [live:true|false] [allowuuid:true|false] [readonlydisk:..]\n"
6742 "\n"
6743 msgstr ""
6744
6745 #. type: textblock
6746 #: ../fish/guestfish-actions.pod:41
6747 msgid ""
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."
6751 msgstr ""
6752
6753 #. type: textblock
6754 #: ../fish/guestfish-actions.pod:46 ../src/guestfs-actions.pod:65
6755 msgid ""
6756 "The number of disks added is returned.  This operation is atomic: if an "
6757 "error is returned, then no disks are added."
6758 msgstr ""
6759
6760 #. type: textblock
6761 #: ../fish/guestfish-actions.pod:49 ../src/guestfs-actions.pod:68
6762 msgid ""
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."
6766 msgstr ""
6767
6768 #. type: textblock
6769 #: ../fish/guestfish-actions.pod:53 ../src/guestfs-actions.pod:72
6770 msgid ""
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."
6774 msgstr ""
6775
6776 #. type: textblock
6777 #: ../fish/guestfish-actions.pod:58 ../src/guestfs-actions.pod:77
6778 msgid ""
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)."
6783 msgstr ""
6784
6785 #. type: textblock
6786 #: ../fish/guestfish-actions.pod:64 ../src/guestfs-actions.pod:83
6787 msgid ""
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."
6793 msgstr ""
6794
6795 #. type: textblock
6796 #: ../fish/guestfish-actions.pod:71 ../src/guestfs-actions.pod:90
6797 msgid ""
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 "
6801 "as usual."
6802 msgstr ""
6803
6804 #. type: textblock
6805 #: ../fish/guestfish-actions.pod:76 ../src/guestfs-actions.pod:95
6806 msgid ""
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:"
6809 msgstr ""
6810
6811 #. type: =item
6812 #: ../fish/guestfish-actions.pod:82 ../src/guestfs-actions.pod:101
6813 msgid "readonlydisk = \"error\""
6814 msgstr ""
6815
6816 #. type: textblock
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:"
6821 msgstr ""
6822
6823 #. type: textblock
6824 #: ../fish/guestfish-actions.pod:86 ../src/guestfs-actions.pod:105
6825 msgid ""
6826 "The whole call is aborted with an error if any disk with the E<lt>readonly/"
6827 "E<gt> flag is found."
6828 msgstr ""
6829
6830 #. type: textblock
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:"
6835 msgstr ""
6836
6837 #. type: textblock
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."
6842 msgstr ""
6843
6844 #. type: =item
6845 #: ../fish/guestfish-actions.pod:93 ../src/guestfs-actions.pod:112
6846 msgid "readonlydisk = \"read\""
6847 msgstr ""
6848
6849 #. type: textblock
6850 #: ../fish/guestfish-actions.pod:97 ../src/guestfs-actions.pod:116
6851 msgid ""
6852 "Disks with the E<lt>readonly/E<gt> flag are added read-only.  Other disks "
6853 "are added read/write."
6854 msgstr ""
6855
6856 #. type: =item
6857 #: ../fish/guestfish-actions.pod:104 ../src/guestfs-actions.pod:123
6858 msgid "readonlydisk = \"write\" (default)"
6859 msgstr ""
6860
6861 #. type: textblock
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."
6864 msgstr ""
6865
6866 #. type: =item
6867 #: ../fish/guestfish-actions.pod:114 ../src/guestfs-actions.pod:133
6868 msgid "readonlydisk = \"ignore\""
6869 msgstr ""
6870
6871 #. type: textblock
6872 #: ../fish/guestfish-actions.pod:116 ../src/guestfs-actions.pod:135
6873 msgid "If C<readonly> is true or false:"
6874 msgstr ""
6875
6876 #. type: textblock
6877 #: ../fish/guestfish-actions.pod:118 ../src/guestfs-actions.pod:137
6878 msgid "Disks with the E<lt>readonly/E<gt> flag are skipped."
6879 msgstr ""
6880
6881 #. type: textblock
6882 #: ../fish/guestfish-actions.pod:122
6883 msgid ""
6884 "The other optional parameters are passed directly through to L</add-drive-"
6885 "opts>."
6886 msgstr ""
6887
6888 #. type: textblock
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
6897 msgid ""
6898 "This command has one or more optional arguments.  See L</OPTIONAL ARGUMENTS>."
6899 msgstr ""
6900
6901 #. type: =head2
6902 #: ../fish/guestfish-actions.pod:127
6903 msgid "add-drive"
6904 msgstr "add-drive"
6905
6906 #. type: verbatim
6907 #: ../fish/guestfish-actions.pod:129
6908 #, no-wrap
6909 msgid ""
6910 " add-drive filename\n"
6911 "\n"
6912 msgstr ""
6913 " add-drive назва_файла\n"
6914 "\n"
6915
6916 #. type: textblock
6917 #: ../fish/guestfish-actions.pod:131
6918 msgid ""
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."
6922 msgstr ""
6923
6924 #. type: textblock
6925 #: ../fish/guestfish-actions.pod:135
6926 msgid ""
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."
6932 msgstr ""
6933
6934 #. type: =head2
6935 #: ../fish/guestfish-actions.pod:142
6936 msgid "add-drive-opts"
6937 msgstr "add-drive-opts"
6938
6939 #. type: =head2
6940 #: ../fish/guestfish-actions.pod:144
6941 msgid "add"
6942 msgstr "add"
6943
6944 #. type: verbatim
6945 #: ../fish/guestfish-actions.pod:146
6946 #, no-wrap
6947 msgid ""
6948 " add-drive-opts filename [readonly:true|false] [format:..] [iface:..] [name:..]\n"
6949 "\n"
6950 msgstr ""
6951
6952 #. type: textblock
6953 #: ../fish/guestfish-actions.pod:148 ../src/guestfs-actions.pod:208
6954 msgid ""
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."
6958 msgstr ""
6959
6960 #. type: textblock
6961 #: ../fish/guestfish-actions.pod:153 ../src/guestfs-actions.pod:213
6962 msgid ""
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)."
6967 msgstr ""
6968
6969 #. type: textblock
6970 #: ../fish/guestfish-actions.pod:159 ../src/guestfs-actions.pod:219
6971 msgid "This call checks that C<filename> exists."
6972 msgstr ""
6973
6974 #. type: textblock
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:"
6978 msgstr ""
6979
6980 #. type: =item
6981 #: ../fish/guestfish-actions.pod:165 ../src/guestfs-actions.pod:225
6982 msgid "C<readonly>"
6983 msgstr "C<readonly>"
6984
6985 #. type: textblock
6986 #: ../fish/guestfish-actions.pod:167 ../src/guestfs-actions.pod:227
6987 msgid ""
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."
6991 msgstr ""
6992
6993 #. type: =item
6994 #: ../fish/guestfish-actions.pod:171 ../src/guestfs-actions.pod:231
6995 msgid "C<format>"
6996 msgstr "C<format>"
6997
6998 #. type: textblock
6999 #: ../fish/guestfish-actions.pod:173
7000 msgid ""
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>."
7004 msgstr ""
7005
7006 #. type: textblock
7007 #: ../fish/guestfish-actions.pod:177 ../src/guestfs-actions.pod:237
7008 msgid ""
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."
7012 msgstr ""
7013
7014 #. type: =item
7015 #: ../fish/guestfish-actions.pod:182 ../src/guestfs-actions.pod:242
7016 msgid "C<iface>"
7017 msgstr "C<iface>"
7018
7019 #. type: textblock
7020 #: ../fish/guestfish-actions.pod:184
7021 msgid ""
7022 "This rarely-used option lets you emulate the behaviour of the deprecated L</"
7023 "add-drive-with-if> call (q.v.)"
7024 msgstr ""
7025
7026 #. type: =item
7027 #: ../fish/guestfish-actions.pod:187 ../fish/guestfish-actions.pod:3242
7028 #: ../src/guestfs-actions.pod:247 ../src/guestfs-actions.pod:4994
7029 msgid "C<name>"
7030 msgstr ""
7031
7032 #. type: textblock
7033 #: ../fish/guestfish-actions.pod:189 ../src/guestfs-actions.pod:249
7034 msgid ""
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."
7037 msgstr ""
7038
7039 #. type: =head2
7040 #: ../fish/guestfish-actions.pod:196
7041 msgid "add-drive-ro"
7042 msgstr "add-drive-ro"
7043
7044 #. type: =head2
7045 #: ../fish/guestfish-actions.pod:198
7046 msgid "add-ro"
7047 msgstr "add-ro"
7048
7049 #. type: verbatim
7050 #: ../fish/guestfish-actions.pod:200
7051 #, no-wrap
7052 msgid ""
7053 " add-drive-ro filename\n"
7054 "\n"
7055 msgstr ""
7056
7057 #. type: textblock
7058 #: ../fish/guestfish-actions.pod:202
7059 msgid ""
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."
7063 msgstr ""
7064
7065 #. type: =head2
7066 #: ../fish/guestfish-actions.pod:207
7067 msgid "add-drive-ro-with-if"
7068 msgstr ""
7069
7070 #. type: verbatim
7071 #: ../fish/guestfish-actions.pod:209
7072 #, no-wrap
7073 msgid ""
7074 " add-drive-ro-with-if filename iface\n"
7075 "\n"
7076 msgstr ""
7077
7078 #. type: textblock
7079 #: ../fish/guestfish-actions.pod:211
7080 msgid ""
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."
7083 msgstr ""
7084
7085 #. type: =head2
7086 #: ../fish/guestfish-actions.pod:221
7087 msgid "add-drive-with-if"
7088 msgstr ""
7089
7090 #. type: verbatim
7091 #: ../fish/guestfish-actions.pod:223
7092 #, no-wrap
7093 msgid ""
7094 " add-drive-with-if filename iface\n"
7095 "\n"
7096 msgstr ""
7097
7098 #. type: textblock
7099 #: ../fish/guestfish-actions.pod:225
7100 msgid ""
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."
7103 msgstr ""
7104
7105 #. type: =head2
7106 #: ../fish/guestfish-actions.pod:235
7107 msgid "aug-clear"
7108 msgstr ""
7109
7110 #. type: verbatim
7111 #: ../fish/guestfish-actions.pod:237
7112 #, no-wrap
7113 msgid ""
7114 " aug-clear augpath\n"
7115 "\n"
7116 msgstr ""
7117
7118 #. type: textblock
7119 #: ../fish/guestfish-actions.pod:239 ../src/guestfs-actions.pod:343
7120 msgid ""
7121 "Set the value associated with C<path> to C<NULL>.  This is the same as the "
7122 "L<augtool(1)> C<clear> command."
7123 msgstr ""
7124
7125 #. type: =head2
7126 #: ../fish/guestfish-actions.pod:242
7127 msgid "aug-close"
7128 msgstr ""
7129
7130 #. type: verbatim
7131 #: ../fish/guestfish-actions.pod:244
7132 #, no-wrap
7133 msgid ""
7134 " aug-close\n"
7135 "\n"
7136 msgstr ""
7137
7138 #. type: textblock
7139 #: ../fish/guestfish-actions.pod:246
7140 msgid ""
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."
7144 msgstr ""
7145
7146 #. type: =head2
7147 #: ../fish/guestfish-actions.pod:251
7148 msgid "aug-defnode"
7149 msgstr ""
7150
7151 #. type: verbatim
7152 #: ../fish/guestfish-actions.pod:253
7153 #, no-wrap
7154 msgid ""
7155 " aug-defnode name expr val\n"
7156 "\n"
7157 msgstr ""
7158
7159 #. type: textblock
7160 #: ../fish/guestfish-actions.pod:255 ../src/guestfs-actions.pod:372
7161 msgid ""
7162 "Defines a variable C<name> whose value is the result of evaluating C<expr>."
7163 msgstr ""
7164
7165 #. type: textblock
7166 #: ../fish/guestfish-actions.pod:258
7167 msgid ""
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."
7171 msgstr ""
7172
7173 #. type: textblock
7174 #: ../fish/guestfish-actions.pod:262 ../src/guestfs-actions.pod:379
7175 msgid ""
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."
7178 msgstr ""
7179
7180 #. type: =head2
7181 #: ../fish/guestfish-actions.pod:266
7182 msgid "aug-defvar"
7183 msgstr ""
7184
7185 #. type: verbatim
7186 #: ../fish/guestfish-actions.pod:268
7187 #, no-wrap
7188 msgid ""
7189 " aug-defvar name expr\n"
7190 "\n"
7191 msgstr ""
7192
7193 #. type: textblock
7194 #: ../fish/guestfish-actions.pod:270 ../src/guestfs-actions.pod:396
7195 msgid ""
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."
7198 msgstr ""
7199
7200 #. type: textblock
7201 #: ../fish/guestfish-actions.pod:274 ../src/guestfs-actions.pod:400
7202 msgid ""
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."
7205 msgstr ""
7206
7207 #. type: =head2
7208 #: ../fish/guestfish-actions.pod:277
7209 msgid "aug-get"
7210 msgstr ""
7211
7212 #. type: verbatim
7213 #: ../fish/guestfish-actions.pod:279
7214 #, no-wrap
7215 msgid ""
7216 " aug-get augpath\n"
7217 "\n"
7218 msgstr ""
7219
7220 #. type: textblock
7221 #: ../fish/guestfish-actions.pod:281 ../src/guestfs-actions.pod:413
7222 msgid ""
7223 "Look up the value associated with C<path>.  If C<path> matches exactly one "
7224 "node, the C<value> is returned."
7225 msgstr ""
7226
7227 #. type: =head2
7228 #: ../fish/guestfish-actions.pod:284
7229 msgid "aug-init"
7230 msgstr ""
7231
7232 #. type: verbatim
7233 #: ../fish/guestfish-actions.pod:286
7234 #, no-wrap
7235 msgid ""
7236 " aug-init root flags\n"
7237 "\n"
7238 msgstr ""
7239
7240 #. type: textblock
7241 #: ../fish/guestfish-actions.pod:288 ../src/guestfs-actions.pod:428
7242 msgid ""
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 "
7245 "closed."
7246 msgstr ""
7247
7248 #. type: textblock
7249 #: ../fish/guestfish-actions.pod:292
7250 msgid "You must call this before using any other L</aug-*> commands."
7251 msgstr ""
7252
7253 #. type: textblock
7254 #: ../fish/guestfish-actions.pod:295 ../src/guestfs-actions.pod:435
7255 msgid ""
7256 "C<root> is the filesystem root.  C<root> must not be NULL, use C</> instead."
7257 msgstr ""
7258
7259 #. type: textblock
7260 #: ../fish/guestfish-actions.pod:298 ../src/guestfs-actions.pod:438
7261 msgid ""
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:"
7264 msgstr ""
7265
7266 #. type: =item
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"
7270
7271 #. type: textblock
7272 #: ../fish/guestfish-actions.pod:306 ../src/guestfs-actions.pod:446
7273 msgid "Keep the original file with a C<.augsave> extension."
7274 msgstr ""
7275
7276 #. type: =item
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"
7280
7281 #. type: textblock
7282 #: ../fish/guestfish-actions.pod:310 ../src/guestfs-actions.pod:450
7283 msgid ""
7284 "Save changes into a file with extension C<.augnew>, and do not overwrite "
7285 "original.  Overrides C<AUG_SAVE_BACKUP>."
7286 msgstr ""
7287
7288 #. type: =item
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"
7292
7293 #. type: textblock
7294 #: ../fish/guestfish-actions.pod:315 ../src/guestfs-actions.pod:455
7295 msgid "Typecheck lenses."
7296 msgstr ""
7297
7298 #. type: textblock
7299 #: ../fish/guestfish-actions.pod:317
7300 msgid ""
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>."
7304 msgstr ""
7305
7306 #. type: =item
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"
7310
7311 #. type: textblock
7312 #: ../fish/guestfish-actions.pod:324 ../src/guestfs-actions.pod:464
7313 msgid "Do not use standard load path for modules."
7314 msgstr ""
7315
7316 #. type: =item
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"
7320
7321 #. type: textblock
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."
7324 msgstr ""
7325
7326 #. type: =item
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"
7330
7331 #. type: textblock
7332 #: ../fish/guestfish-actions.pod:332
7333 msgid "Do not load the tree in L</aug-init>."
7334 msgstr ""
7335
7336 #. type: textblock
7337 #: ../fish/guestfish-actions.pod:336
7338 msgid "To close the handle, you can call L</aug-close>."
7339 msgstr ""
7340
7341 #. type: textblock
7342 #: ../fish/guestfish-actions.pod:338 ../src/guestfs-actions.pod:478
7343 msgid "To find out more about Augeas, see L<http://augeas.net/>."
7344 msgstr ""
7345
7346 #. type: =head2
7347 #: ../fish/guestfish-actions.pod:340
7348 msgid "aug-insert"
7349 msgstr ""
7350
7351 #. type: verbatim
7352 #: ../fish/guestfish-actions.pod:342
7353 #, no-wrap
7354 msgid ""
7355 " aug-insert augpath label true|false\n"
7356 "\n"
7357 msgstr ""
7358
7359 #. type: textblock
7360 #: ../fish/guestfish-actions.pod:344 ../src/guestfs-actions.pod:492
7361 msgid ""
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>)."
7364 msgstr ""
7365
7366 #. type: textblock
7367 #: ../fish/guestfish-actions.pod:348 ../src/guestfs-actions.pod:496
7368 msgid ""
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]>."
7371 msgstr ""
7372
7373 #. type: =head2
7374 #: ../fish/guestfish-actions.pod:352
7375 msgid "aug-load"
7376 msgstr ""
7377
7378 #. type: verbatim
7379 #: ../fish/guestfish-actions.pod:354
7380 #, no-wrap
7381 msgid ""
7382 " aug-load\n"
7383 "\n"
7384 msgstr ""
7385
7386 #. type: textblock
7387 #: ../fish/guestfish-actions.pod:356 ../src/guestfs-actions.pod:509
7388 msgid "Load files into the tree."
7389 msgstr "Завантажити файли до ієрархії."
7390
7391 #. type: textblock
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."
7394 msgstr ""
7395
7396 #. type: =head2
7397 #: ../fish/guestfish-actions.pod:361
7398 msgid "aug-ls"
7399 msgstr ""
7400
7401 #. type: verbatim
7402 #: ../fish/guestfish-actions.pod:363
7403 #, no-wrap
7404 msgid ""
7405 " aug-ls augpath\n"
7406 "\n"
7407 msgstr ""
7408
7409 #. type: textblock
7410 #: ../fish/guestfish-actions.pod:365
7411 msgid ""
7412 "This is just a shortcut for listing L</aug-match> C<path/*> and sorting the "
7413 "resulting nodes into alphabetical order."
7414 msgstr ""
7415
7416 #. type: =head2
7417 #: ../fish/guestfish-actions.pod:368
7418 msgid "aug-match"
7419 msgstr ""
7420
7421 #. type: verbatim
7422 #: ../fish/guestfish-actions.pod:370
7423 #, no-wrap
7424 msgid ""
7425 " aug-match augpath\n"
7426 "\n"
7427 msgstr ""
7428
7429 #. type: textblock
7430 #: ../fish/guestfish-actions.pod:372 ../src/guestfs-actions.pod:539
7431 msgid ""
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."
7435 msgstr ""
7436
7437 #. type: =head2
7438 #: ../fish/guestfish-actions.pod:376
7439 msgid "aug-mv"
7440 msgstr ""
7441
7442 #. type: verbatim
7443 #: ../fish/guestfish-actions.pod:378
7444 #, no-wrap
7445 msgid ""
7446 " aug-mv src dest\n"
7447 "\n"
7448 msgstr ""
7449
7450 #. type: textblock
7451 #: ../fish/guestfish-actions.pod:380 ../src/guestfs-actions.pod:556
7452 msgid ""
7453 "Move the node C<src> to C<dest>.  C<src> must match exactly one node.  "
7454 "C<dest> is overwritten if it exists."
7455 msgstr ""
7456
7457 #. type: =head2
7458 #: ../fish/guestfish-actions.pod:383
7459 msgid "aug-rm"
7460 msgstr ""
7461
7462 #. type: verbatim
7463 #: ../fish/guestfish-actions.pod:385
7464 #, no-wrap
7465 msgid ""
7466 " aug-rm augpath\n"
7467 "\n"
7468 msgstr ""
7469
7470 #. type: textblock
7471 #: ../fish/guestfish-actions.pod:387 ../src/guestfs-actions.pod:569
7472 msgid "Remove C<path> and all of its children."
7473 msgstr ""
7474
7475 #. type: textblock
7476 #: ../fish/guestfish-actions.pod:389 ../src/guestfs-actions.pod:571
7477 msgid "On success this returns the number of entries which were removed."
7478 msgstr ""
7479
7480 #. type: =head2
7481 #: ../fish/guestfish-actions.pod:391
7482 msgid "aug-save"
7483 msgstr ""
7484
7485 #. type: verbatim
7486 #: ../fish/guestfish-actions.pod:393
7487 #, no-wrap
7488 msgid ""
7489 " aug-save\n"
7490 "\n"
7491 msgstr ""
7492
7493 #. type: textblock
7494 #: ../fish/guestfish-actions.pod:395 ../src/guestfs-actions.pod:582
7495 msgid "This writes all pending changes to disk."
7496 msgstr ""
7497
7498 #. type: textblock
7499 #: ../fish/guestfish-actions.pod:397
7500 msgid ""
7501 "The flags which were passed to L</aug-init> affect exactly how files are "
7502 "saved."
7503 msgstr ""
7504
7505 #. type: =head2
7506 #: ../fish/guestfish-actions.pod:400
7507 msgid "aug-set"
7508 msgstr ""
7509
7510 #. type: verbatim
7511 #: ../fish/guestfish-actions.pod:402
7512 #, no-wrap
7513 msgid ""
7514 " aug-set augpath val\n"
7515 "\n"
7516 msgstr ""
7517
7518 #. type: textblock
7519 #: ../fish/guestfish-actions.pod:404 ../src/guestfs-actions.pod:598
7520 msgid "Set the value associated with C<path> to C<val>."
7521 msgstr ""
7522
7523 #. type: textblock
7524 #: ../fish/guestfish-actions.pod:406
7525 msgid ""
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."
7529 msgstr ""
7530
7531 #. type: =head2
7532 #: ../fish/guestfish-actions.pod:411
7533 msgid "available"
7534 msgstr ""
7535
7536 #. type: verbatim
7537 #: ../fish/guestfish-actions.pod:413
7538 #, no-wrap
7539 msgid ""
7540 " available 'groups ...'\n"
7541 "\n"
7542 msgstr ""
7543
7544 #. type: textblock
7545 #: ../fish/guestfish-actions.pod:415 ../src/guestfs-actions.pod:615
7546 msgid ""
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."
7550 msgstr ""
7551
7552 #. type: textblock
7553 #: ../fish/guestfish-actions.pod:419
7554 msgid ""
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>."
7558 msgstr ""
7559
7560 #. type: textblock
7561 #: ../fish/guestfish-actions.pod:424 ../src/guestfs-actions.pod:624
7562 msgid ""
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."
7566 msgstr ""
7567
7568 #. type: textblock
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."
7571 msgstr ""
7572
7573 #. type: textblock
7574 #: ../fish/guestfish-actions.pod:431 ../src/guestfs-actions.pod:631
7575 msgid ""
7576 "It fails with an error if one or more of the requested groups is unavailable "
7577 "in the appliance."
7578 msgstr ""
7579
7580 #. type: textblock
7581 #: ../fish/guestfish-actions.pod:434 ../src/guestfs-actions.pod:634
7582 msgid ""
7583 "If an unknown group name is included in the list of groups then an error is "
7584 "always returned."
7585 msgstr ""
7586
7587 #. type: textblock
7588 #: ../fish/guestfish-actions.pod:437 ../src/guestfs-actions.pod:637
7589 msgid "I<Notes:>"
7590 msgstr "I<Нотатки:>"
7591
7592 #. type: textblock
7593 #: ../fish/guestfish-actions.pod:443
7594 msgid "You must call L</launch> before calling this function."
7595 msgstr ""
7596
7597 #. type: textblock
7598 #: ../fish/guestfish-actions.pod:445 ../src/guestfs-actions.pod:645
7599 msgid ""
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."
7602 msgstr ""
7603
7604 #. type: textblock
7605 #: ../fish/guestfish-actions.pod:451 ../src/guestfs-actions.pod:651
7606 msgid ""
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."
7610 msgstr ""
7611
7612 #. type: textblock
7613 #: ../fish/guestfish-actions.pod:458 ../src/guestfs-actions.pod:658
7614 msgid ""
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."
7618 msgstr ""
7619
7620 #. type: textblock
7621 #: ../fish/guestfish-actions.pod:465
7622 msgid ""
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>."
7626 msgstr ""
7627
7628 #. type: =head2
7629 #: ../fish/guestfish-actions.pod:472
7630 msgid "available-all-groups"
7631 msgstr ""
7632
7633 #. type: verbatim
7634 #: ../fish/guestfish-actions.pod:474
7635 #, no-wrap
7636 msgid ""
7637 " available-all-groups\n"
7638 "\n"
7639 msgstr ""
7640
7641 #. type: textblock
7642 #: ../fish/guestfish-actions.pod:476
7643 msgid ""
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."
7648 msgstr ""
7649
7650 #. type: textblock
7651 #: ../fish/guestfish-actions.pod:482
7652 msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>."
7653 msgstr ""
7654
7655 #. type: =head2
7656 #: ../fish/guestfish-actions.pod:484
7657 msgid "base64-in"
7658 msgstr ""
7659
7660 #. type: verbatim
7661 #: ../fish/guestfish-actions.pod:486
7662 #, no-wrap
7663 msgid ""
7664 " base64-in (base64file|-) filename\n"
7665 "\n"
7666 msgstr ""
7667
7668 #. type: textblock
7669 #: ../fish/guestfish-actions.pod:488 ../src/guestfs-actions.pod:702
7670 msgid ""
7671 "This command uploads base64-encoded data from C<base64file> to C<filename>."
7672 msgstr ""
7673
7674 #. type: textblock
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."
7684 msgstr ""
7685
7686 #. type: =head2
7687 #: ../fish/guestfish-actions.pod:493
7688 msgid "base64-out"
7689 msgstr ""
7690
7691 #. type: verbatim
7692 #: ../fish/guestfish-actions.pod:495
7693 #, no-wrap
7694 msgid ""
7695 " base64-out filename (base64file|-)\n"
7696 "\n"
7697 msgstr ""
7698
7699 #. type: textblock
7700 #: ../fish/guestfish-actions.pod:497 ../src/guestfs-actions.pod:716
7701 msgid ""
7702 "This command downloads the contents of C<filename>, writing it out to local "
7703 "file C<base64file> encoded as base64."
7704 msgstr ""
7705
7706 #. type: =head2
7707 #: ../fish/guestfish-actions.pod:502
7708 msgid "blockdev-flushbufs"
7709 msgstr ""
7710
7711 #. type: verbatim
7712 #: ../fish/guestfish-actions.pod:504
7713 #, no-wrap
7714 msgid ""
7715 " blockdev-flushbufs device\n"
7716 "\n"
7717 msgstr ""
7718
7719 #. type: textblock
7720 #: ../fish/guestfish-actions.pod:506 ../src/guestfs-actions.pod:729
7721 msgid ""
7722 "This tells the kernel to flush internal buffers associated with C<device>."
7723 msgstr ""
7724
7725 #. type: textblock
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."
7737 msgstr ""
7738
7739 #. type: =head2
7740 #: ../fish/guestfish-actions.pod:511
7741 msgid "blockdev-getbsz"
7742 msgstr ""
7743
7744 #. type: verbatim
7745 #: ../fish/guestfish-actions.pod:513
7746 #, no-wrap
7747 msgid ""
7748 " blockdev-getbsz device\n"
7749 "\n"
7750 msgstr ""
7751
7752 #. type: textblock
7753 #: ../fish/guestfish-actions.pod:515 ../src/guestfs-actions.pod:744
7754 msgid "This returns the block size of a device."
7755 msgstr ""
7756
7757 #. type: textblock
7758 #: ../fish/guestfish-actions.pod:517 ../fish/guestfish-actions.pod:580
7759 #: ../src/guestfs-actions.pod:746 ../src/guestfs-actions.pod:846
7760 msgid ""
7761 "(Note this is different from both I<size in blocks> and I<filesystem block "
7762 "size>)."
7763 msgstr ""
7764
7765 #. type: =head2
7766 #: ../fish/guestfish-actions.pod:522
7767 msgid "blockdev-getro"
7768 msgstr ""
7769
7770 #. type: verbatim
7771 #: ../fish/guestfish-actions.pod:524
7772 #, no-wrap
7773 msgid ""
7774 " blockdev-getro device\n"
7775 "\n"
7776 msgstr ""
7777
7778 #. type: textblock
7779 #: ../fish/guestfish-actions.pod:526 ../src/guestfs-actions.pod:761
7780 msgid ""
7781 "Returns a boolean indicating if the block device is read-only (true if read-"
7782 "only, false if not)."
7783 msgstr ""
7784
7785 #. type: =head2
7786 #: ../fish/guestfish-actions.pod:531
7787 msgid "blockdev-getsize64"
7788 msgstr ""
7789
7790 #. type: verbatim
7791 #: ../fish/guestfish-actions.pod:533
7792 #, no-wrap
7793 msgid ""
7794 " blockdev-getsize64 device\n"
7795 "\n"
7796 msgstr ""
7797
7798 #. type: textblock
7799 #: ../fish/guestfish-actions.pod:535 ../src/guestfs-actions.pod:776
7800 msgid "This returns the size of the device in bytes."
7801 msgstr ""
7802
7803 #. type: textblock
7804 #: ../fish/guestfish-actions.pod:537
7805 msgid "See also L</blockdev-getsz>."
7806 msgstr "Див. також L</blockdev-getsz>."
7807
7808 #. type: =head2
7809 #: ../fish/guestfish-actions.pod:541
7810 msgid "blockdev-getss"
7811 msgstr ""
7812
7813 #. type: verbatim
7814 #: ../fish/guestfish-actions.pod:543
7815 #, no-wrap
7816 msgid ""
7817 " blockdev-getss device\n"
7818 "\n"
7819 msgstr ""
7820
7821 #. type: textblock
7822 #: ../fish/guestfish-actions.pod:545 ../src/guestfs-actions.pod:792
7823 msgid ""
7824 "This returns the size of sectors on a block device.  Usually 512, but can be "
7825 "larger for modern devices."
7826 msgstr ""
7827
7828 #. type: textblock
7829 #: ../fish/guestfish-actions.pod:548
7830 msgid ""
7831 "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)."
7832 msgstr ""
7833
7834 #. type: =head2
7835 #: ../fish/guestfish-actions.pod:553
7836 msgid "blockdev-getsz"
7837 msgstr ""
7838
7839 #. type: verbatim
7840 #: ../fish/guestfish-actions.pod:555
7841 #, no-wrap
7842 msgid ""
7843 " blockdev-getsz device\n"
7844 "\n"
7845 msgstr ""
7846
7847 #. type: textblock
7848 #: ../fish/guestfish-actions.pod:557 ../src/guestfs-actions.pod:810
7849 msgid ""
7850 "This returns the size of the device in units of 512-byte sectors (even if "
7851 "the sectorsize isn't 512 bytes ... weird)."
7852 msgstr ""
7853
7854 #. type: textblock
7855 #: ../fish/guestfish-actions.pod:560
7856 msgid ""
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>."
7859 msgstr ""
7860
7861 #. type: =head2
7862 #: ../fish/guestfish-actions.pod:566
7863 msgid "blockdev-rereadpt"
7864 msgstr ""
7865
7866 #. type: verbatim
7867 #: ../fish/guestfish-actions.pod:568
7868 #, no-wrap
7869 msgid ""
7870 " blockdev-rereadpt device\n"
7871 "\n"
7872 msgstr ""
7873
7874 #. type: textblock
7875 #: ../fish/guestfish-actions.pod:570 ../src/guestfs-actions.pod:829
7876 msgid "Reread the partition table on C<device>."
7877 msgstr ""
7878
7879 #. type: =head2
7880 #: ../fish/guestfish-actions.pod:574
7881 msgid "blockdev-setbsz"
7882 msgstr ""
7883
7884 #. type: verbatim
7885 #: ../fish/guestfish-actions.pod:576
7886 #, no-wrap
7887 msgid ""
7888 " blockdev-setbsz device blocksize\n"
7889 "\n"
7890 msgstr ""
7891
7892 #. type: textblock
7893 #: ../fish/guestfish-actions.pod:578 ../src/guestfs-actions.pod:844
7894 msgid "This sets the block size of a device."
7895 msgstr ""
7896
7897 #. type: =head2
7898 #: ../fish/guestfish-actions.pod:585
7899 msgid "blockdev-setro"
7900 msgstr ""
7901
7902 #. type: verbatim
7903 #: ../fish/guestfish-actions.pod:587
7904 #, no-wrap
7905 msgid ""
7906 " blockdev-setro device\n"
7907 "\n"
7908 msgstr ""
7909
7910 #. type: textblock
7911 #: ../fish/guestfish-actions.pod:589 ../src/guestfs-actions.pod:861
7912 msgid "Sets the block device named C<device> to read-only."
7913 msgstr ""
7914
7915 #. type: =head2
7916 #: ../fish/guestfish-actions.pod:593
7917 msgid "blockdev-setrw"
7918 msgstr ""
7919
7920 #. type: verbatim
7921 #: ../fish/guestfish-actions.pod:595
7922 #, no-wrap
7923 msgid ""
7924 " blockdev-setrw device\n"
7925 "\n"
7926 msgstr ""
7927
7928 #. type: textblock
7929 #: ../fish/guestfish-actions.pod:597 ../src/guestfs-actions.pod:875
7930 msgid "Sets the block device named C<device> to read-write."
7931 msgstr ""
7932
7933 #. type: =head2
7934 #: ../fish/guestfish-actions.pod:601
7935 msgid "btrfs-filesystem-resize"
7936 msgstr ""
7937
7938 #. type: verbatim
7939 #: ../fish/guestfish-actions.pod:603
7940 #, no-wrap
7941 msgid ""
7942 " btrfs-filesystem-resize mountpoint [size:N]\n"
7943 "\n"
7944 msgstr ""
7945
7946 #. type: textblock
7947 #: ../fish/guestfish-actions.pod:605 ../src/guestfs-actions.pod:897
7948 msgid "This command resizes a btrfs filesystem."
7949 msgstr ""
7950
7951 #. type: textblock
7952 #: ../fish/guestfish-actions.pod:607 ../src/guestfs-actions.pod:899
7953 msgid ""
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 "
7956 "btrfs itself)."
7957 msgstr ""
7958
7959 #. type: textblock
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:"
7965 msgstr ""
7966
7967 #. type: =item
7968 #: ../fish/guestfish-actions.pod:615 ../fish/guestfish-actions.pod:3707
7969 #: ../src/guestfs-actions.pod:907 ../src/guestfs-actions.pod:5790
7970 msgid "C<size>"
7971 msgstr "C<розмір>"
7972
7973 #. type: textblock
7974 #: ../fish/guestfish-actions.pod:617 ../src/guestfs-actions.pod:909
7975 msgid ""
7976 "The new size (in bytes) of the filesystem.  If omitted, the filesystem is "
7977 "resized to the maximum size."
7978 msgstr ""
7979
7980 #. type: textblock
7981 #: ../fish/guestfish-actions.pod:622 ../src/guestfs-actions.pod:914
7982 msgid "See also L<btrfs(8)>."
7983 msgstr "Див. також L<btrfs(8)>."
7984
7985 #. type: =head2
7986 #: ../fish/guestfish-actions.pod:626
7987 msgid "case-sensitive-path"
7988 msgstr ""
7989
7990 #. type: verbatim
7991 #: ../fish/guestfish-actions.pod:628
7992 #, no-wrap
7993 msgid ""
7994 " case-sensitive-path path\n"
7995 "\n"
7996 msgstr ""
7997
7998 #. type: textblock
7999 #: ../fish/guestfish-actions.pod:630 ../src/guestfs-actions.pod:948
8000 msgid ""
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."
8004 msgstr ""
8005
8006 #. type: textblock
8007 #: ../fish/guestfish-actions.pod:635 ../src/guestfs-actions.pod:953
8008 msgid ""
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-"
8012 "sensitive."
8013 msgstr ""
8014
8015 #. type: textblock
8016 #: ../fish/guestfish-actions.pod:640 ../src/guestfs-actions.pod:958
8017 msgid ""
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 "
8021 "be a problem."
8022 msgstr ""
8023
8024 #. type: textblock
8025 #: ../fish/guestfish-actions.pod:646 ../src/guestfs-actions.pod:964
8026 msgid ""
8027 "Bug or feature? You decide: L<http://www.tuxera.com/community/ntfs-3g-faq/"
8028 "#posixfilenames1>"
8029 msgstr ""
8030
8031 #. type: textblock
8032 #: ../fish/guestfish-actions.pod:649 ../src/guestfs-actions.pod:967
8033 msgid ""
8034 "This function resolves the true case of each element in the path and returns "
8035 "the case-sensitive path."
8036 msgstr ""
8037
8038 #. type: textblock
8039 #: ../fish/guestfish-actions.pod:652
8040 msgid ""
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)."
8044 msgstr ""
8045
8046 #. type: textblock
8047 #: ../fish/guestfish-actions.pod:657 ../src/guestfs-actions.pod:975
8048 msgid "I<Note>: This function does not handle drive names, backslashes etc."
8049 msgstr ""
8050
8051 #. type: textblock
8052 #: ../fish/guestfish-actions.pod:660
8053 msgid "See also L</realpath>."
8054 msgstr "Див. також L</realpath>."
8055
8056 #. type: =head2
8057 #: ../fish/guestfish-actions.pod:662
8058 msgid "cat"
8059 msgstr "cat"
8060
8061 #. type: verbatim
8062 #: ../fish/guestfish-actions.pod:664
8063 #, no-wrap
8064 msgid ""
8065 " cat path\n"
8066 "\n"
8067 msgstr ""
8068 " cat шлях\n"
8069 "\n"
8070
8071 #. type: textblock
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>."
8075 msgstr ""
8076
8077 #. type: textblock
8078 #: ../fish/guestfish-actions.pod:668
8079 msgid ""
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."
8084 msgstr ""
8085
8086 #. type: textblock
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
8119 msgid ""
8120 "Because of the message protocol, there is a transfer limit of somewhere "
8121 "between 2MB and 4MB.  See L<guestfs(3)/PROTOCOL LIMITS>."
8122 msgstr ""
8123
8124 #. type: =head2
8125 #: ../fish/guestfish-actions.pod:676
8126 msgid "checksum"
8127 msgstr "checksum"
8128
8129 #. type: verbatim
8130 #: ../fish/guestfish-actions.pod:678
8131 #, no-wrap
8132 msgid ""
8133 " checksum csumtype path\n"
8134 "\n"
8135 msgstr ""
8136
8137 #. type: textblock
8138 #: ../fish/guestfish-actions.pod:680 ../src/guestfs-actions.pod:1013
8139 msgid ""
8140 "This call computes the MD5, SHAx or CRC checksum of the file named C<path>."
8141 msgstr ""
8142
8143 #. type: textblock
8144 #: ../fish/guestfish-actions.pod:683 ../src/guestfs-actions.pod:1016
8145 msgid ""
8146 "The type of checksum to compute is given by the C<csumtype> parameter which "
8147 "must have one of the following values:"
8148 msgstr ""
8149
8150 #. type: =item
8151 #: ../fish/guestfish-actions.pod:688 ../src/guestfs-actions.pod:1021
8152 msgid "C<crc>"
8153 msgstr "C<crc>"
8154
8155 #. type: textblock
8156 #: ../fish/guestfish-actions.pod:690 ../src/guestfs-actions.pod:1023
8157 msgid ""
8158 "Compute the cyclic redundancy check (CRC) specified by POSIX for the "
8159 "C<cksum> command."
8160 msgstr ""
8161
8162 #. type: =item
8163 #: ../fish/guestfish-actions.pod:693 ../src/guestfs-actions.pod:1026
8164 msgid "C<md5>"
8165 msgstr "C<md5>"
8166
8167 #. type: textblock
8168 #: ../fish/guestfish-actions.pod:695 ../src/guestfs-actions.pod:1028
8169 msgid "Compute the MD5 hash (using the C<md5sum> program)."
8170 msgstr ""
8171
8172 #. type: =item
8173 #: ../fish/guestfish-actions.pod:697 ../src/guestfs-actions.pod:1030
8174 msgid "C<sha1>"
8175 msgstr "C<sha1>"
8176
8177 #. type: textblock
8178 #: ../fish/guestfish-actions.pod:699 ../src/guestfs-actions.pod:1032
8179 msgid "Compute the SHA1 hash (using the C<sha1sum> program)."
8180 msgstr ""
8181
8182 #. type: =item
8183 #: ../fish/guestfish-actions.pod:701 ../src/guestfs-actions.pod:1034
8184 msgid "C<sha224>"
8185 msgstr "C<sha224>"
8186
8187 #. type: textblock
8188 #: ../fish/guestfish-actions.pod:703 ../src/guestfs-actions.pod:1036
8189 msgid "Compute the SHA224 hash (using the C<sha224sum> program)."
8190 msgstr ""
8191
8192 #. type: =item
8193 #: ../fish/guestfish-actions.pod:705 ../src/guestfs-actions.pod:1038
8194 msgid "C<sha256>"
8195 msgstr "C<sha256>"
8196
8197 #. type: textblock
8198 #: ../fish/guestfish-actions.pod:707 ../src/guestfs-actions.pod:1040
8199 msgid "Compute the SHA256 hash (using the C<sha256sum> program)."
8200 msgstr ""
8201
8202 #. type: =item
8203 #: ../fish/guestfish-actions.pod:709 ../src/guestfs-actions.pod:1042
8204 msgid "C<sha384>"
8205 msgstr "C<sha384>"
8206
8207 #. type: textblock
8208 #: ../fish/guestfish-actions.pod:711 ../src/guestfs-actions.pod:1044
8209 msgid "Compute the SHA384 hash (using the C<sha384sum> program)."
8210 msgstr ""
8211
8212 #. type: =item
8213 #: ../fish/guestfish-actions.pod:713 ../src/guestfs-actions.pod:1046
8214 msgid "C<sha512>"
8215 msgstr "C<sha512>"
8216
8217 #. type: textblock
8218 #: ../fish/guestfish-actions.pod:715 ../src/guestfs-actions.pod:1048
8219 msgid "Compute the SHA512 hash (using the C<sha512sum> program)."
8220 msgstr ""
8221
8222 #. type: textblock
8223 #: ../fish/guestfish-actions.pod:719 ../src/guestfs-actions.pod:1052
8224 msgid "The checksum is returned as a printable string."
8225 msgstr ""
8226
8227 #. type: textblock
8228 #: ../fish/guestfish-actions.pod:721
8229 msgid "To get the checksum for a device, use L</checksum-device>."
8230 msgstr ""
8231
8232 #. type: textblock
8233 #: ../fish/guestfish-actions.pod:723
8234 msgid "To get the checksums for many files, use L</checksums-out>."
8235 msgstr ""
8236
8237 #. type: =head2
8238 #: ../fish/guestfish-actions.pod:725
8239 msgid "checksum-device"
8240 msgstr "checksum-device"
8241
8242 #. type: verbatim
8243 #: ../fish/guestfish-actions.pod:727
8244 #, no-wrap
8245 msgid ""
8246 " checksum-device csumtype device\n"
8247 "\n"
8248 msgstr ""
8249
8250 #. type: textblock
8251 #: ../fish/guestfish-actions.pod:729
8252 msgid ""
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."
8256 msgstr ""
8257
8258 #. type: =head2
8259 #: ../fish/guestfish-actions.pod:733
8260 msgid "checksums-out"
8261 msgstr ""
8262
8263 #. type: verbatim
8264 #: ../fish/guestfish-actions.pod:735
8265 #, no-wrap
8266 msgid ""
8267 " checksums-out csumtype directory (sumsfile|-)\n"
8268 "\n"
8269 msgstr ""
8270
8271 #. type: textblock
8272 #: ../fish/guestfish-actions.pod:737 ../src/guestfs-actions.pod:1087
8273 msgid ""
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>."
8276 msgstr ""
8277
8278 #. type: textblock
8279 #: ../fish/guestfish-actions.pod:741 ../src/guestfs-actions.pod:1091
8280 msgid ""
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."
8286 msgstr ""
8287
8288 #. type: =head2
8289 #: ../fish/guestfish-actions.pod:751
8290 msgid "chmod"
8291 msgstr "chmod"
8292
8293 #. type: verbatim
8294 #: ../fish/guestfish-actions.pod:753
8295 #, no-wrap
8296 msgid ""
8297 " chmod mode path\n"
8298 "\n"
8299 msgstr ""
8300
8301 #. type: textblock
8302 #: ../fish/guestfish-actions.pod:755 ../src/guestfs-actions.pod:1110
8303 msgid ""
8304 "Change the mode (permissions) of C<path> to C<mode>.  Only numeric modes are "
8305 "supported."
8306 msgstr ""
8307
8308 #. type: textblock
8309 #: ../fish/guestfish-actions.pod:758 ../src/guestfs-actions.pod:1113
8310 msgid ""
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 "
8313 "C<700>."
8314 msgstr ""
8315
8316 #. type: textblock
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."
8323 msgstr ""
8324
8325 #. type: =head2
8326 #: ../fish/guestfish-actions.pod:764
8327 msgid "chown"
8328 msgstr "chown"
8329
8330 #. type: verbatim
8331 #: ../fish/guestfish-actions.pod:766
8332 #, no-wrap
8333 msgid ""
8334 " chown owner group path\n"
8335 "\n"
8336 msgstr ""
8337
8338 #. type: textblock
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>."
8341 msgstr ""
8342
8343 #. type: textblock
8344 #: ../fish/guestfish-actions.pod:770 ../fish/guestfish-actions.pod:2703
8345 #: ../src/guestfs-actions.pod:1133 ../src/guestfs-actions.pod:4124
8346 msgid ""
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)."
8350 msgstr ""
8351
8352 #. type: =head2
8353 #: ../fish/guestfish-actions.pod:774
8354 msgid "command"
8355 msgstr "command"
8356
8357 #. type: verbatim
8358 #: ../fish/guestfish-actions.pod:776
8359 #, no-wrap
8360 msgid ""
8361 " command 'arguments ...'\n"
8362 "\n"
8363 msgstr ""
8364 " command 'параметри...'\n"
8365 "\n"
8366
8367 #. type: textblock
8368 #: ../fish/guestfish-actions.pod:778 ../src/guestfs-actions.pod:1147
8369 msgid ""
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)."
8373 msgstr ""
8374
8375 #. type: textblock
8376 #: ../fish/guestfish-actions.pod:783
8377 msgid ""
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>)."
8382 msgstr ""
8383
8384 #. type: textblock
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."
8387 msgstr ""
8388
8389 #. type: textblock
8390 #: ../fish/guestfish-actions.pod:793 ../src/guestfs-actions.pod:1162
8391 msgid ""
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 "
8394 "the command."
8395 msgstr ""
8396
8397 #. type: textblock
8398 #: ../fish/guestfish-actions.pod:797 ../src/guestfs-actions.pod:1166
8399 msgid ""
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."
8403 msgstr ""
8404
8405 #. type: textblock
8406 #: ../fish/guestfish-actions.pod:802 ../src/guestfs-actions.pod:1171
8407 msgid ""
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 "
8411 "right locations."
8412 msgstr ""
8413
8414 #. type: =head2
8415 #: ../fish/guestfish-actions.pod:811
8416 msgid "command-lines"
8417 msgstr ""
8418
8419 #. type: verbatim
8420 #: ../fish/guestfish-actions.pod:813
8421 #, no-wrap
8422 msgid ""
8423 " command-lines 'arguments ...'\n"
8424 "\n"
8425 msgstr ""
8426
8427 #. type: textblock
8428 #: ../fish/guestfish-actions.pod:815
8429 msgid ""
8430 "This is the same as L</command>, but splits the result into a list of lines."
8431 msgstr ""
8432
8433 #. type: textblock
8434 #: ../fish/guestfish-actions.pod:818
8435 msgid "See also: L</sh-lines>"
8436 msgstr "Див. також L</sh-lines>"
8437
8438 #. type: =head2
8439 #: ../fish/guestfish-actions.pod:823
8440 msgid "compress-device-out"
8441 msgstr ""
8442
8443 #. type: verbatim
8444 #: ../fish/guestfish-actions.pod:825
8445 #, no-wrap
8446 msgid ""
8447 " compress-device-out ctype device (zdevice|-) [level:N]\n"
8448 "\n"
8449 msgstr ""
8450
8451 #. type: textblock
8452 #: ../fish/guestfish-actions.pod:827 ../src/guestfs-actions.pod:1221
8453 msgid ""
8454 "This command compresses C<device> and writes it out to the local file "
8455 "C<zdevice>."
8456 msgstr ""
8457
8458 #. type: textblock
8459 #: ../fish/guestfish-actions.pod:830
8460 msgid ""
8461 "The C<ctype> and optional C<level> parameters have the same meaning as in L</"
8462 "compress-out>."
8463 msgstr ""
8464
8465 #. type: =head2
8466 #: ../fish/guestfish-actions.pod:837
8467 msgid "compress-out"
8468 msgstr ""
8469
8470 #. type: verbatim
8471 #: ../fish/guestfish-actions.pod:839
8472 #, no-wrap
8473 msgid ""
8474 " compress-out ctype file (zfile|-) [level:N]\n"
8475 "\n"
8476 msgstr ""
8477
8478 #. type: textblock
8479 #: ../fish/guestfish-actions.pod:841 ../src/guestfs-actions.pod:1273
8480 msgid ""
8481 "This command compresses C<file> and writes it out to the local file C<zfile>."
8482 msgstr ""
8483
8484 #. type: textblock
8485 #: ../fish/guestfish-actions.pod:844 ../src/guestfs-actions.pod:1276
8486 msgid ""
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\"."
8492 msgstr ""
8493
8494 #. type: textblock
8495 #: ../fish/guestfish-actions.pod:850 ../src/guestfs-actions.pod:1282
8496 msgid ""
8497 "The optional C<level> parameter controls compression level.  The meaning and "
8498 "default for this parameter depends on the compression program being used."
8499 msgstr ""
8500
8501 #. type: =head2
8502 #: ../fish/guestfish-actions.pod:858
8503 msgid "config"
8504 msgstr ""
8505
8506 #. type: verbatim
8507 #: ../fish/guestfish-actions.pod:860
8508 #, no-wrap
8509 msgid ""
8510 " config qemuparam qemuvalue\n"
8511 "\n"
8512 msgstr ""
8513
8514 #. type: textblock
8515 #: ../fish/guestfish-actions.pod:862 ../src/guestfs-actions.pod:1323
8516 msgid ""
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."
8520 msgstr ""
8521
8522 #. type: textblock
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)."
8525 msgstr ""
8526
8527 #. type: textblock
8528 #: ../fish/guestfish-actions.pod:869 ../src/guestfs-actions.pod:1330
8529 msgid "C<value> can be NULL."
8530 msgstr ""
8531
8532 #. type: =head2
8533 #: ../fish/guestfish-actions.pod:871
8534 msgid "copy-device-to-device"
8535 msgstr ""
8536
8537 #. type: verbatim
8538 #: ../fish/guestfish-actions.pod:873
8539 #, no-wrap
8540 msgid ""
8541 " copy-device-to-device src dest [srcoffset:N] [destoffset:N] [size:N]\n"
8542 "\n"
8543 msgstr ""
8544
8545 #. type: textblock
8546 #: ../fish/guestfish-actions.pod:875
8547 msgid ""
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)."
8551 msgstr ""
8552
8553 #. type: textblock
8554 #: ../fish/guestfish-actions.pod:882 ../src/guestfs-actions.pod:1360
8555 msgid ""
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."
8560 msgstr ""
8561
8562 #. type: textblock
8563 #: ../fish/guestfish-actions.pod:888 ../src/guestfs-actions.pod:1366
8564 msgid ""
8565 "The source and destination may be the same object.  However overlapping "
8566 "regions may not be copied correctly."
8567 msgstr ""
8568
8569 #. type: textblock
8570 #: ../fish/guestfish-actions.pod:891 ../src/guestfs-actions.pod:1369
8571 msgid ""
8572 "If the destination is a file, it is created if required.  If the destination "
8573 "file is not large enough, it is extended."
8574 msgstr ""
8575
8576 #. type: =head2
8577 #: ../fish/guestfish-actions.pod:896
8578 msgid "copy-device-to-file"
8579 msgstr ""
8580
8581 #. type: verbatim
8582 #: ../fish/guestfish-actions.pod:898
8583 #, no-wrap
8584 msgid ""
8585 " copy-device-to-file src dest [srcoffset:N] [destoffset:N] [size:N]\n"
8586 "\n"
8587 msgstr ""
8588
8589 #. type: textblock
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."
8593 msgstr ""
8594
8595 #. type: =head2
8596 #: ../fish/guestfish-actions.pod:905
8597 msgid "copy-file-to-device"
8598 msgstr ""
8599
8600 #. type: verbatim
8601 #: ../fish/guestfish-actions.pod:907
8602 #, no-wrap
8603 msgid ""
8604 " copy-file-to-device src dest [srcoffset:N] [destoffset:N] [size:N]\n"
8605 "\n"
8606 msgstr ""
8607
8608 #. type: =head2
8609 #: ../fish/guestfish-actions.pod:914
8610 msgid "copy-file-to-file"
8611 msgstr ""
8612
8613 #. type: verbatim
8614 #: ../fish/guestfish-actions.pod:916
8615 #, no-wrap
8616 msgid ""
8617 " copy-file-to-file src dest [srcoffset:N] [destoffset:N] [size:N]\n"
8618 "\n"
8619 msgstr ""
8620
8621 #. type: textblock
8622 #: ../fish/guestfish-actions.pod:921
8623 msgid ""
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."
8627 msgstr ""
8628
8629 #. type: =head2
8630 #: ../fish/guestfish-actions.pod:928
8631 msgid "copy-size"
8632 msgstr ""
8633
8634 #. type: verbatim
8635 #: ../fish/guestfish-actions.pod:930
8636 #, no-wrap
8637 msgid ""
8638 " copy-size src dest size\n"
8639 "\n"
8640 msgstr ""
8641
8642 #. type: textblock
8643 #: ../fish/guestfish-actions.pod:932 ../src/guestfs-actions.pod:1584
8644 msgid ""
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>."
8647 msgstr ""
8648
8649 #. type: textblock
8650 #: ../fish/guestfish-actions.pod:935 ../src/guestfs-actions.pod:1587
8651 msgid ""
8652 "Note this will fail if the source is too short or if the destination is not "
8653 "large enough."
8654 msgstr ""
8655
8656 #. type: textblock
8657 #: ../fish/guestfish-actions.pod:938 ../fish/guestfish-actions.pod:973
8658 msgid ""
8659 "I<This function is deprecated.> In new code, use the L</"
8660 "copy_device_to_device> call instead."
8661 msgstr ""
8662
8663 #. type: =head2
8664 #: ../fish/guestfish-actions.pod:945
8665 msgid "cp"
8666 msgstr "cp"
8667
8668 #. type: verbatim
8669 #: ../fish/guestfish-actions.pod:947
8670 #, no-wrap
8671 msgid ""
8672 " cp src dest\n"
8673 "\n"
8674 msgstr ""
8675
8676 #. type: textblock
8677 #: ../fish/guestfish-actions.pod:949 ../src/guestfs-actions.pod:1606
8678 msgid ""
8679 "This copies a file from C<src> to C<dest> where C<dest> is either a "
8680 "destination filename or destination directory."
8681 msgstr ""
8682
8683 #. type: =head2
8684 #: ../fish/guestfish-actions.pod:952
8685 msgid "cp-a"
8686 msgstr "cp-a"
8687
8688 #. type: verbatim
8689 #: ../fish/guestfish-actions.pod:954
8690 #, no-wrap
8691 msgid ""
8692 " cp-a src dest\n"
8693 "\n"
8694 msgstr ""
8695
8696 #. type: textblock
8697 #: ../fish/guestfish-actions.pod:956 ../src/guestfs-actions.pod:1620
8698 msgid ""
8699 "This copies a file or directory from C<src> to C<dest> recursively using the "
8700 "C<cp -a> command."
8701 msgstr ""
8702
8703 #. type: =head2
8704 #: ../fish/guestfish-actions.pod:959
8705 msgid "dd"
8706 msgstr "dd"
8707
8708 #. type: verbatim
8709 #: ../fish/guestfish-actions.pod:961
8710 #, no-wrap
8711 msgid ""
8712 " dd src dest\n"
8713 "\n"
8714 msgstr ""
8715
8716 #. type: textblock
8717 #: ../fish/guestfish-actions.pod:963 ../src/guestfs-actions.pod:1641
8718 msgid ""
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."
8722 msgstr ""
8723
8724 #. type: textblock
8725 #: ../fish/guestfish-actions.pod:968
8726 msgid ""
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>)."
8730 msgstr ""
8731
8732 #. type: =head2
8733 #: ../fish/guestfish-actions.pod:980
8734 msgid "df"
8735 msgstr "df"
8736
8737 #. type: verbatim
8738 #: ../fish/guestfish-actions.pod:982
8739 #, no-wrap
8740 msgid ""
8741 " df\n"
8742 "\n"
8743 msgstr ""
8744 " df\n"
8745 "\n"
8746
8747 #. type: textblock
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."
8750 msgstr ""
8751
8752 #. type: textblock
8753 #: ../fish/guestfish-actions.pod:986 ../fish/guestfish-actions.pod:997
8754 msgid ""
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 "
8757 "programs."
8758 msgstr ""
8759
8760 #. type: =head2
8761 #: ../fish/guestfish-actions.pod:990
8762 msgid "df-h"
8763 msgstr "df-h"
8764
8765 #. type: verbatim
8766 #: ../fish/guestfish-actions.pod:992
8767 #, no-wrap
8768 msgid ""
8769 " df-h\n"
8770 "\n"
8771 msgstr ""
8772 " df-h\n"
8773 "\n"
8774
8775 #. type: textblock
8776 #: ../fish/guestfish-actions.pod:994 ../src/guestfs-actions.pod:1676
8777 msgid ""
8778 "This command runs the C<df -h> command to report disk space used in human-"
8779 "readable format."
8780 msgstr ""
8781
8782 #. type: =head2
8783 #: ../fish/guestfish-actions.pod:1001
8784 msgid "dmesg"
8785 msgstr "dmesg"
8786
8787 #. type: verbatim
8788 #: ../fish/guestfish-actions.pod:1003
8789 #, no-wrap
8790 msgid ""
8791 " dmesg\n"
8792 "\n"
8793 msgstr ""
8794 " dmesg\n"
8795 "\n"
8796
8797 #. type: textblock
8798 #: ../fish/guestfish-actions.pod:1005 ../src/guestfs-actions.pod:1693
8799 msgid ""
8800 "This returns the kernel messages (C<dmesg> output) from the guest kernel.  "
8801 "This is sometimes useful for extended debugging of problems."
8802 msgstr ""
8803
8804 #. type: textblock
8805 #: ../fish/guestfish-actions.pod:1009
8806 msgid ""
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."
8810 msgstr ""
8811
8812 #. type: =head2
8813 #: ../fish/guestfish-actions.pod:1014
8814 msgid "download"
8815 msgstr "download"
8816
8817 #. type: verbatim
8818 #: ../fish/guestfish-actions.pod:1016
8819 #, no-wrap
8820 msgid ""
8821 " download remotefilename (filename|-)\n"
8822 "\n"
8823 msgstr ""
8824
8825 #. type: textblock
8826 #: ../fish/guestfish-actions.pod:1018 ../fish/guestfish-actions.pod:1031
8827 #: ../src/guestfs-actions.pod:1714 ../src/guestfs-actions.pod:1739
8828 msgid ""
8829 "Download file C<remotefilename> and save it as C<filename> on the local "
8830 "machine."
8831 msgstr ""
8832
8833 #. type: textblock
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."
8837 msgstr ""
8838
8839 #. type: textblock
8840 #: ../fish/guestfish-actions.pod:1023
8841 msgid "See also L</upload>, L</cat>."
8842 msgstr ""
8843
8844 #. type: =head2
8845 #: ../fish/guestfish-actions.pod:1027
8846 msgid "download-offset"
8847 msgstr "download-offset"
8848
8849 #. type: verbatim
8850 #: ../fish/guestfish-actions.pod:1029
8851 #, no-wrap
8852 msgid ""
8853 " download-offset remotefilename (filename|-) offset size\n"
8854 "\n"
8855 msgstr ""
8856
8857 #. type: textblock
8858 #: ../fish/guestfish-actions.pod:1034 ../src/guestfs-actions.pod:1742
8859 msgid ""
8860 "C<remotefilename> is read for C<size> bytes starting at C<offset> (this "
8861 "region must be within the file or device)."
8862 msgstr ""
8863
8864 #. type: textblock
8865 #: ../fish/guestfish-actions.pod:1037
8866 msgid ""
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."
8870 msgstr ""
8871
8872 #. type: textblock
8873 #: ../fish/guestfish-actions.pod:1042
8874 msgid "See also L</download>, L</pread>."
8875 msgstr ""
8876
8877 #. type: =head2
8878 #: ../fish/guestfish-actions.pod:1046
8879 msgid "drop-caches"
8880 msgstr ""
8881
8882 #. type: verbatim
8883 #: ../fish/guestfish-actions.pod:1048
8884 #, no-wrap
8885 msgid ""
8886 " drop-caches whattodrop\n"
8887 "\n"
8888 msgstr ""
8889
8890 #. type: textblock
8891 #: ../fish/guestfish-actions.pod:1050 ../src/guestfs-actions.pod:1767
8892 msgid ""
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>"
8896 msgstr ""
8897
8898 #. type: textblock
8899 #: ../fish/guestfish-actions.pod:1055 ../src/guestfs-actions.pod:1772
8900 msgid "Setting C<whattodrop> to 3 should drop everything."
8901 msgstr ""
8902
8903 #. type: textblock
8904 #: ../fish/guestfish-actions.pod:1057 ../src/guestfs-actions.pod:1774
8905 msgid ""
8906 "This automatically calls L<sync(2)> before the operation, so that the "
8907 "maximum guest memory is freed."
8908 msgstr ""
8909
8910 #. type: =head2
8911 #: ../fish/guestfish-actions.pod:1060
8912 msgid "du"
8913 msgstr "du"
8914
8915 #. type: verbatim
8916 #: ../fish/guestfish-actions.pod:1062
8917 #, no-wrap
8918 msgid ""
8919 " du path\n"
8920 "\n"
8921 msgstr ""
8922 " du шлях\n"
8923 "\n"
8924
8925 #. type: textblock
8926 #: ../fish/guestfish-actions.pod:1064 ../src/guestfs-actions.pod:1787
8927 msgid ""
8928 "This command runs the C<du -s> command to estimate file space usage for "
8929 "C<path>."
8930 msgstr ""
8931
8932 #. type: textblock
8933 #: ../fish/guestfish-actions.pod:1067 ../src/guestfs-actions.pod:1790
8934 msgid ""
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 "
8937 "(recursively)."
8938 msgstr ""
8939
8940 #. type: textblock
8941 #: ../fish/guestfish-actions.pod:1071 ../src/guestfs-actions.pod:1794
8942 msgid ""
8943 "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)."
8944 msgstr ""
8945
8946 #. type: =head2
8947 #: ../fish/guestfish-actions.pod:1074
8948 msgid "e2fsck-f"
8949 msgstr "e2fsck-f"
8950
8951 #. type: verbatim
8952 #: ../fish/guestfish-actions.pod:1076
8953 #, no-wrap
8954 msgid ""
8955 " e2fsck-f device\n"
8956 "\n"
8957 msgstr ""
8958
8959 #. type: textblock
8960 #: ../fish/guestfish-actions.pod:1078 ../src/guestfs-actions.pod:1812
8961 msgid ""
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 "
8964 "clean (I<-f>)."
8965 msgstr ""
8966
8967 #. type: textblock
8968 #: ../fish/guestfish-actions.pod:1082
8969 msgid ""
8970 "This command is only needed because of L</resize2fs> (q.v.).  Normally you "
8971 "should use L</fsck>."
8972 msgstr ""
8973
8974 #. type: =head2
8975 #: ../fish/guestfish-actions.pod:1085
8976 msgid "echo-daemon"
8977 msgstr ""
8978
8979 #. type: verbatim
8980 #: ../fish/guestfish-actions.pod:1087
8981 #, no-wrap
8982 msgid ""
8983 " echo-daemon 'words ...'\n"
8984 "\n"
8985 msgstr ""
8986
8987 #. type: textblock
8988 #: ../fish/guestfish-actions.pod:1089 ../src/guestfs-actions.pod:1829
8989 msgid ""
8990 "This command concatenates the list of C<words> passed with single spaces "
8991 "between them and returns the resulting string."
8992 msgstr ""
8993
8994 #. type: textblock
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."
8997 msgstr ""
8998
8999 #. type: textblock
9000 #: ../fish/guestfish-actions.pod:1094
9001 msgid "See also L</ping-daemon>."
9002 msgstr "Див. також L</ping-daemon>."
9003
9004 #. type: =head2
9005 #: ../fish/guestfish-actions.pod:1096
9006 msgid "egrep"
9007 msgstr "egrep"
9008
9009 #. type: verbatim
9010 #: ../fish/guestfish-actions.pod:1098
9011 #, no-wrap
9012 msgid ""
9013 " egrep regex path\n"
9014 "\n"
9015 msgstr ""
9016
9017 #. type: textblock
9018 #: ../fish/guestfish-actions.pod:1100 ../src/guestfs-actions.pod:1848
9019 msgid ""
9020 "This calls the external C<egrep> program and returns the matching lines."
9021 msgstr ""
9022
9023 #. type: =head2
9024 #: ../fish/guestfish-actions.pod:1106
9025 msgid "egrepi"
9026 msgstr "egrepi"
9027
9028 #. type: verbatim
9029 #: ../fish/guestfish-actions.pod:1108
9030 #, no-wrap
9031 msgid ""
9032 " egrepi regex path\n"
9033 "\n"
9034 msgstr ""
9035
9036 #. type: textblock
9037 #: ../fish/guestfish-actions.pod:1110 ../src/guestfs-actions.pod:1867
9038 msgid ""
9039 "This calls the external C<egrep -i> program and returns the matching lines."
9040 msgstr ""
9041
9042 #. type: =head2
9043 #: ../fish/guestfish-actions.pod:1116
9044 msgid "equal"
9045 msgstr "equal"
9046
9047 #. type: verbatim
9048 #: ../fish/guestfish-actions.pod:1118
9049 #, no-wrap
9050 msgid ""
9051 " equal file1 file2\n"
9052 "\n"
9053 msgstr ""
9054 " equal файл1 файл2\n"
9055 "\n"
9056
9057 #. type: textblock
9058 #: ../fish/guestfish-actions.pod:1120 ../src/guestfs-actions.pod:1886
9059 msgid ""
9060 "This compares the two files C<file1> and C<file2> and returns true if their "
9061 "content is exactly equal, or false otherwise."
9062 msgstr ""
9063
9064 #. type: textblock
9065 #: ../fish/guestfish-actions.pod:1123 ../src/guestfs-actions.pod:1889
9066 msgid "The external L<cmp(1)> program is used for the comparison."
9067 msgstr ""
9068
9069 #. type: =head2
9070 #: ../fish/guestfish-actions.pod:1125
9071 msgid "exists"
9072 msgstr "exists"
9073
9074 #. type: verbatim
9075 #: ../fish/guestfish-actions.pod:1127
9076 #, no-wrap
9077 msgid ""
9078 " exists path\n"
9079 "\n"
9080 msgstr ""
9081 " exists шлях\n"
9082 "\n"
9083
9084 #. type: textblock
9085 #: ../fish/guestfish-actions.pod:1129 ../src/guestfs-actions.pod:1901
9086 msgid ""
9087 "This returns C<true> if and only if there is a file, directory (or anything) "
9088 "with the given C<path> name."
9089 msgstr ""
9090
9091 #. type: textblock
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>."
9095
9096 #. type: =head2
9097 #: ../fish/guestfish-actions.pod:1134
9098 msgid "fallocate"
9099 msgstr "fallocate"
9100
9101 #. type: verbatim
9102 #: ../fish/guestfish-actions.pod:1136
9103 #, no-wrap
9104 msgid ""
9105 " fallocate path len\n"
9106 "\n"
9107 msgstr ""
9108 " fallocate шлях довжина\n"
9109 "\n"
9110
9111 #. type: textblock
9112 #: ../fish/guestfish-actions.pod:1138 ../fish/guestfish-actions.pod:1157
9113 #: ../src/guestfs-actions.pod:1924 ../src/guestfs-actions.pod:1943
9114 msgid ""
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."
9117 msgstr ""
9118
9119 #. type: textblock
9120 #: ../fish/guestfish-actions.pod:1142 ../src/guestfs-actions.pod:1928
9121 msgid ""
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."
9124 msgstr ""
9125
9126 #. type: textblock
9127 #: ../fish/guestfish-actions.pod:1146
9128 msgid ""
9129 "I<This function is deprecated.> In new code, use the L</fallocate64> call "
9130 "instead."
9131 msgstr ""
9132
9133 #. type: =head2
9134 #: ../fish/guestfish-actions.pod:1153
9135 msgid "fallocate64"
9136 msgstr "fallocate64"
9137
9138 #. type: verbatim
9139 #: ../fish/guestfish-actions.pod:1155
9140 #, no-wrap
9141 msgid ""
9142 " fallocate64 path len\n"
9143 "\n"
9144 msgstr ""
9145 " fallocate64 шлях довжина\n"
9146 "\n"
9147
9148 #. type: textblock
9149 #: ../fish/guestfish-actions.pod:1161
9150 msgid ""
9151 "Note that this call allocates disk blocks for the file.  To create a sparse "
9152 "file use L</truncate-size> instead."
9153 msgstr ""
9154
9155 #. type: textblock
9156 #: ../fish/guestfish-actions.pod:1164
9157 msgid ""
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."
9161 msgstr ""
9162
9163 #. type: textblock
9164 #: ../fish/guestfish-actions.pod:1169 ../src/guestfs-actions.pod:1955
9165 msgid ""
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."
9168 msgstr ""
9169
9170 #. type: =head2
9171 #: ../fish/guestfish-actions.pod:1173
9172 msgid "fgrep"
9173 msgstr "fgrep"
9174
9175 #. type: verbatim
9176 #: ../fish/guestfish-actions.pod:1175
9177 #, no-wrap
9178 msgid ""
9179 " fgrep pattern path\n"
9180 "\n"
9181 msgstr ""
9182 " fgrep шаблон шлях\n"
9183 "\n"
9184
9185 #. type: textblock
9186 #: ../fish/guestfish-actions.pod:1177 ../src/guestfs-actions.pod:1970
9187 msgid ""
9188 "This calls the external C<fgrep> program and returns the matching lines."
9189 msgstr ""
9190
9191 #. type: =head2
9192 #: ../fish/guestfish-actions.pod:1183
9193 msgid "fgrepi"
9194 msgstr "fgrepi"
9195
9196 #. type: verbatim
9197 #: ../fish/guestfish-actions.pod:1185
9198 #, no-wrap
9199 msgid ""
9200 " fgrepi pattern path\n"
9201 "\n"
9202 msgstr ""
9203 " fgrepi шаблон шлях\n"
9204 "\n"
9205
9206 #. type: textblock
9207 #: ../fish/guestfish-actions.pod:1187 ../src/guestfs-actions.pod:1989
9208 msgid ""
9209 "This calls the external C<fgrep -i> program and returns the matching lines."
9210 msgstr ""
9211
9212 #. type: =head2
9213 #: ../fish/guestfish-actions.pod:1193
9214 msgid "file"
9215 msgstr "file"
9216
9217 #. type: verbatim
9218 #: ../fish/guestfish-actions.pod:1195
9219 #, no-wrap
9220 msgid ""
9221 " file path\n"
9222 "\n"
9223 msgstr ""
9224 " file шлях\n"
9225 "\n"
9226
9227 #. type: textblock
9228 #: ../fish/guestfish-actions.pod:1197 ../src/guestfs-actions.pod:2007
9229 msgid ""
9230 "This call uses the standard L<file(1)> command to determine the type or "
9231 "contents of the file."
9232 msgstr ""
9233
9234 #. type: textblock
9235 #: ../fish/guestfish-actions.pod:1200 ../src/guestfs-actions.pod:2010
9236 msgid ""
9237 "This call will also transparently look inside various types of compressed "
9238 "file."
9239 msgstr ""
9240
9241 #. type: textblock
9242 #: ../fish/guestfish-actions.pod:1203 ../src/guestfs-actions.pod:2013
9243 msgid ""
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)."
9246 msgstr ""
9247
9248 #. type: textblock
9249 #: ../fish/guestfish-actions.pod:1207 ../src/guestfs-actions.pod:2017
9250 msgid ""
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."
9254 msgstr ""
9255
9256 #. type: textblock
9257 #: ../fish/guestfish-actions.pod:1211
9258 msgid ""
9259 "See also: L<file(1)>, L</vfs-type>, L</lstat>, L</is-file>, L</is-blockdev> "
9260 "(etc), L</is-zero>."
9261 msgstr ""
9262
9263 #. type: =head2
9264 #: ../fish/guestfish-actions.pod:1214
9265 msgid "file-architecture"
9266 msgstr "file-architecture"
9267
9268 #. type: verbatim
9269 #: ../fish/guestfish-actions.pod:1216
9270 #, no-wrap
9271 msgid ""
9272 " file-architecture filename\n"
9273 "\n"
9274 msgstr ""
9275 " file-architecture назва_файла\n"
9276 "\n"
9277
9278 #. type: textblock
9279 #: ../fish/guestfish-actions.pod:1218 ../src/guestfs-actions.pod:2035
9280 msgid ""
9281 "This detects the architecture of the binary C<filename>, and returns it if "
9282 "known."
9283 msgstr ""
9284
9285 #. type: textblock
9286 #: ../fish/guestfish-actions.pod:1221 ../src/guestfs-actions.pod:2038
9287 msgid "Currently defined architectures are:"
9288 msgstr ""
9289
9290 #. type: =item
9291 #: ../fish/guestfish-actions.pod:1225 ../src/guestfs-actions.pod:2042
9292 msgid "\"i386\""
9293 msgstr "\"i386\""
9294
9295 #. type: textblock
9296 #: ../fish/guestfish-actions.pod:1227 ../src/guestfs-actions.pod:2044
9297 msgid ""
9298 "This string is returned for all 32 bit i386, i486, i586, i686 binaries "
9299 "irrespective of the precise processor requirements of the binary."
9300 msgstr ""
9301
9302 #. type: =item
9303 #: ../fish/guestfish-actions.pod:1230 ../src/guestfs-actions.pod:2047
9304 msgid "\"x86_64\""
9305 msgstr "\"x86_64\""
9306
9307 #. type: textblock
9308 #: ../fish/guestfish-actions.pod:1232 ../src/guestfs-actions.pod:2049
9309 msgid "64 bit x86-64."
9310 msgstr ""
9311
9312 #. type: =item
9313 #: ../fish/guestfish-actions.pod:1234 ../src/guestfs-actions.pod:2051
9314 msgid "\"sparc\""
9315 msgstr ""
9316
9317 #. type: textblock
9318 #: ../fish/guestfish-actions.pod:1236 ../src/guestfs-actions.pod:2053
9319 msgid "32 bit SPARC."
9320 msgstr ""
9321
9322 #. type: =item
9323 #: ../fish/guestfish-actions.pod:1238 ../src/guestfs-actions.pod:2055
9324 msgid "\"sparc64\""
9325 msgstr ""
9326
9327 #. type: textblock
9328 #: ../fish/guestfish-actions.pod:1240 ../src/guestfs-actions.pod:2057
9329 msgid "64 bit SPARC V9 and above."
9330 msgstr ""
9331
9332 #. type: =item
9333 #: ../fish/guestfish-actions.pod:1242 ../src/guestfs-actions.pod:2059
9334 msgid "\"ia64\""
9335 msgstr "\"ia64\""
9336
9337 #. type: textblock
9338 #: ../fish/guestfish-actions.pod:1244 ../src/guestfs-actions.pod:2061
9339 msgid "Intel Itanium."
9340 msgstr "Intel Itanium."
9341
9342 #. type: =item
9343 #: ../fish/guestfish-actions.pod:1246 ../src/guestfs-actions.pod:2063
9344 msgid "\"ppc\""
9345 msgstr ""
9346
9347 #. type: textblock
9348 #: ../fish/guestfish-actions.pod:1248 ../src/guestfs-actions.pod:2065
9349 msgid "32 bit Power PC."
9350 msgstr ""
9351
9352 #. type: =item
9353 #: ../fish/guestfish-actions.pod:1250 ../src/guestfs-actions.pod:2067
9354 msgid "\"ppc64\""
9355 msgstr ""
9356
9357 #. type: textblock
9358 #: ../fish/guestfish-actions.pod:1252 ../src/guestfs-actions.pod:2069
9359 msgid "64 bit Power PC."
9360 msgstr ""
9361
9362 #. type: textblock
9363 #: ../fish/guestfish-actions.pod:1256 ../src/guestfs-actions.pod:2073
9364 msgid "Libguestfs may return other architecture strings in future."
9365 msgstr ""
9366
9367 #. type: textblock
9368 #: ../fish/guestfish-actions.pod:1258 ../src/guestfs-actions.pod:2075
9369 msgid "The function works on at least the following types of files:"
9370 msgstr ""
9371
9372 #. type: textblock
9373 #: ../fish/guestfish-actions.pod:1264 ../src/guestfs-actions.pod:2081
9374 msgid "many types of Un*x and Linux binary"
9375 msgstr ""
9376
9377 #. type: textblock
9378 #: ../fish/guestfish-actions.pod:1268 ../src/guestfs-actions.pod:2085
9379 msgid "many types of Un*x and Linux shared library"
9380 msgstr ""
9381
9382 #. type: textblock
9383 #: ../fish/guestfish-actions.pod:1272 ../src/guestfs-actions.pod:2089
9384 msgid "Windows Win32 and Win64 binaries"
9385 msgstr ""
9386
9387 #. type: textblock
9388 #: ../fish/guestfish-actions.pod:1276 ../src/guestfs-actions.pod:2093
9389 msgid "Windows Win32 and Win64 DLLs"
9390 msgstr ""
9391
9392 #. type: textblock
9393 #: ../fish/guestfish-actions.pod:1278 ../src/guestfs-actions.pod:2095
9394 msgid "Win32 binaries and DLLs return C<i386>."
9395 msgstr ""
9396
9397 #. type: textblock
9398 #: ../fish/guestfish-actions.pod:1280 ../src/guestfs-actions.pod:2097
9399 msgid "Win64 binaries and DLLs return C<x86_64>."
9400 msgstr ""
9401
9402 #. type: textblock
9403 #: ../fish/guestfish-actions.pod:1284 ../src/guestfs-actions.pod:2101
9404 msgid "Linux kernel modules"
9405 msgstr ""
9406
9407 #. type: textblock
9408 #: ../fish/guestfish-actions.pod:1288 ../src/guestfs-actions.pod:2105
9409 msgid "Linux new-style initrd images"
9410 msgstr ""
9411
9412 #. type: textblock
9413 #: ../fish/guestfish-actions.pod:1292 ../src/guestfs-actions.pod:2109
9414 msgid "some non-x86 Linux vmlinuz kernels"
9415 msgstr ""
9416
9417 #. type: textblock
9418 #: ../fish/guestfish-actions.pod:1296 ../src/guestfs-actions.pod:2113
9419 msgid "What it can't do currently:"
9420 msgstr ""
9421
9422 #. type: textblock
9423 #: ../fish/guestfish-actions.pod:1302 ../src/guestfs-actions.pod:2119
9424 msgid "static libraries (libfoo.a)"
9425 msgstr ""
9426
9427 #. type: textblock
9428 #: ../fish/guestfish-actions.pod:1306 ../src/guestfs-actions.pod:2123
9429 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)"
9430 msgstr ""
9431
9432 #. type: textblock
9433 #: ../fish/guestfish-actions.pod:1310 ../src/guestfs-actions.pod:2127
9434 msgid "x86 Linux vmlinuz kernels"
9435 msgstr ""
9436
9437 #. type: textblock
9438 #: ../fish/guestfish-actions.pod:1312 ../src/guestfs-actions.pod:2129
9439 msgid ""
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."
9444 msgstr ""
9445
9446 #. type: =head2
9447 #: ../fish/guestfish-actions.pod:1319
9448 msgid "filesize"
9449 msgstr "filesize"
9450
9451 #. type: verbatim
9452 #: ../fish/guestfish-actions.pod:1321
9453 #, no-wrap
9454 msgid ""
9455 " filesize file\n"
9456 "\n"
9457 msgstr ""
9458 " filesize файл\n"
9459 "\n"
9460
9461 #. type: textblock
9462 #: ../fish/guestfish-actions.pod:1323 ../src/guestfs-actions.pod:2147
9463 msgid "This command returns the size of C<file> in bytes."
9464 msgstr ""
9465
9466 #. type: textblock
9467 #: ../fish/guestfish-actions.pod:1325
9468 msgid ""
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>."
9471 msgstr ""
9472
9473 #. type: =head2
9474 #: ../fish/guestfish-actions.pod:1329
9475 msgid "fill"
9476 msgstr "fill"
9477
9478 #. type: verbatim
9479 #: ../fish/guestfish-actions.pod:1331
9480 #, no-wrap
9481 msgid ""
9482 " fill c len path\n"
9483 "\n"
9484 msgstr ""
9485
9486 #. type: textblock
9487 #: ../fish/guestfish-actions.pod:1333 ../src/guestfs-actions.pod:2165
9488 msgid ""
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<"
9491 "[0..255]>."
9492 msgstr ""
9493
9494 #. type: textblock
9495 #: ../fish/guestfish-actions.pod:1337
9496 msgid ""
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 "
9499 "L</fill-pattern>."
9500 msgstr ""
9501
9502 #. type: =head2
9503 #: ../fish/guestfish-actions.pod:1342
9504 msgid "fill-pattern"
9505 msgstr "fill-pattern"
9506
9507 #. type: verbatim
9508 #: ../fish/guestfish-actions.pod:1344
9509 #, no-wrap
9510 msgid ""
9511 " fill-pattern pattern len path\n"
9512 "\n"
9513 msgstr ""
9514
9515 #. type: textblock
9516 #: ../fish/guestfish-actions.pod:1346
9517 msgid ""
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> "
9521 "bytes."
9522 msgstr ""
9523
9524 #. type: =head2
9525 #: ../fish/guestfish-actions.pod:1351
9526 msgid "find"
9527 msgstr "find"
9528
9529 #. type: verbatim
9530 #: ../fish/guestfish-actions.pod:1353
9531 #, no-wrap
9532 msgid ""
9533 " find directory\n"
9534 "\n"
9535 msgstr ""
9536 " find каталог\n"
9537 "\n"
9538
9539 #. type: textblock
9540 #: ../fish/guestfish-actions.pod:1355 ../src/guestfs-actions.pod:2211
9541 msgid ""
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, "
9545 "described below."
9546 msgstr ""
9547
9548 #. type: textblock
9549 #: ../fish/guestfish-actions.pod:1360 ../src/guestfs-actions.pod:2216
9550 msgid ""
9551 "This returns a list of strings I<without any prefix>.  Thus if the directory "
9552 "structure was:"
9553 msgstr ""
9554
9555 #. type: verbatim
9556 #: ../fish/guestfish-actions.pod:1363 ../src/guestfs-actions.pod:2219
9557 #, no-wrap
9558 msgid ""
9559 " /tmp/a\n"
9560 " /tmp/b\n"
9561 " /tmp/c/d\n"
9562 "\n"
9563 msgstr ""
9564
9565 #. type: textblock
9566 #: ../fish/guestfish-actions.pod:1367
9567 msgid "then the returned list from L</find> C</tmp> would be 4 elements:"
9568 msgstr ""
9569
9570 #. type: verbatim
9571 #: ../fish/guestfish-actions.pod:1370 ../src/guestfs-actions.pod:2226
9572 #, no-wrap
9573 msgid ""
9574 " a\n"
9575 " b\n"
9576 " c\n"
9577 " c/d\n"
9578 "\n"
9579 msgstr ""
9580
9581 #. type: textblock
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."
9584 msgstr ""
9585
9586 #. type: textblock
9587 #: ../fish/guestfish-actions.pod:1378 ../src/guestfs-actions.pod:2234
9588 msgid "The returned list is sorted."
9589 msgstr ""
9590
9591 #. type: textblock
9592 #: ../fish/guestfish-actions.pod:1380
9593 msgid "See also L</find0>."
9594 msgstr "Див. також L</find0>."
9595
9596 #. type: =head2
9597 #: ../fish/guestfish-actions.pod:1385
9598 msgid "find0"
9599 msgstr "find0"
9600
9601 #. type: verbatim
9602 #: ../fish/guestfish-actions.pod:1387
9603 #, no-wrap
9604 msgid ""
9605 " find0 directory (files|-)\n"
9606 "\n"
9607 msgstr ""
9608 " find0 каталог (файли|-)\n"
9609 "\n"
9610
9611 #. type: textblock
9612 #: ../fish/guestfish-actions.pod:1389 ../src/guestfs-actions.pod:2254
9613 msgid ""
9614 "This command lists out all files and directories, recursively, starting at "
9615 "C<directory>, placing the resulting list in the external file called "
9616 "C<files>."
9617 msgstr ""
9618
9619 #. type: textblock
9620 #: ../fish/guestfish-actions.pod:1393
9621 msgid ""
9622 "This command works the same way as L</find> with the following exceptions:"
9623 msgstr ""
9624
9625 #. type: textblock
9626 #: ../fish/guestfish-actions.pod:1400 ../src/guestfs-actions.pod:2265
9627 msgid "The resulting list is written to an external file."
9628 msgstr ""
9629
9630 #. type: textblock
9631 #: ../fish/guestfish-actions.pod:1404 ../src/guestfs-actions.pod:2269
9632 msgid ""
9633 "Items (filenames) in the result are separated by C<\\0> characters.  See "
9634 "L<find(1)> option I<-print0>."
9635 msgstr ""
9636
9637 #. type: textblock
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."
9640 msgstr ""
9641
9642 #. type: textblock
9643 #: ../fish/guestfish-actions.pod:1414 ../src/guestfs-actions.pod:2279
9644 msgid "The result list is not sorted."
9645 msgstr ""
9646
9647 #. type: =head2
9648 #: ../fish/guestfish-actions.pod:1420
9649 msgid "findfs-label"
9650 msgstr "findfs-label"
9651
9652 #. type: verbatim
9653 #: ../fish/guestfish-actions.pod:1422
9654 #, no-wrap
9655 msgid ""
9656 " findfs-label label\n"
9657 "\n"
9658 msgstr ""
9659 " findfs-label мітка\n"
9660 "\n"
9661
9662 #. type: textblock
9663 #: ../fish/guestfish-actions.pod:1424 ../src/guestfs-actions.pod:2293
9664 msgid ""
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."
9667 msgstr ""
9668
9669 #. type: textblock
9670 #: ../fish/guestfish-actions.pod:1428
9671 msgid "To find the label of a filesystem, use L</vfs-label>."
9672 msgstr "Для визначення мітки файлової системи скористайтеся L</vfs-label>."
9673
9674 #. type: =head2
9675 #: ../fish/guestfish-actions.pod:1430
9676 msgid "findfs-uuid"
9677 msgstr "findfs-uuid"
9678
9679 #. type: verbatim
9680 #: ../fish/guestfish-actions.pod:1432
9681 #, no-wrap
9682 msgid ""
9683 " findfs-uuid uuid\n"
9684 "\n"
9685 msgstr ""
9686 " findfs-uuid uuid\n"
9687 "\n"
9688
9689 #. type: textblock
9690 #: ../fish/guestfish-actions.pod:1434 ../src/guestfs-actions.pod:2310
9691 msgid ""
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."
9694 msgstr ""
9695
9696 #. type: textblock
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>."
9700
9701 #. type: =head2
9702 #: ../fish/guestfish-actions.pod:1440
9703 msgid "fsck"
9704 msgstr "fsck"
9705
9706 #. type: verbatim
9707 #: ../fish/guestfish-actions.pod:1442
9708 #, no-wrap
9709 msgid ""
9710 " fsck fstype device\n"
9711 "\n"
9712 msgstr ""
9713 " fsck тип_файлової_системи пристрій\n"
9714 "\n"
9715
9716 #. type: textblock
9717 #: ../fish/guestfish-actions.pod:1444 ../src/guestfs-actions.pod:2328
9718 msgid ""
9719 "This runs the filesystem checker (fsck) on C<device> which should have "
9720 "filesystem type C<fstype>."
9721 msgstr ""
9722
9723 #. type: textblock
9724 #: ../fish/guestfish-actions.pod:1447 ../src/guestfs-actions.pod:2331
9725 msgid ""
9726 "The returned integer is the status.  See L<fsck(8)> for the list of status "
9727 "codes from C<fsck>."
9728 msgstr ""
9729
9730 #. type: textblock
9731 #: ../fish/guestfish-actions.pod:1456 ../src/guestfs-actions.pod:2340
9732 msgid "Multiple status codes can be summed together."
9733 msgstr ""
9734
9735 #. type: textblock
9736 #: ../fish/guestfish-actions.pod:1460 ../src/guestfs-actions.pod:2344
9737 msgid ""
9738 "A non-zero return code can mean \"success\", for example if errors have been "
9739 "corrected on the filesystem."
9740 msgstr ""
9741
9742 #. type: textblock
9743 #: ../fish/guestfish-actions.pod:1465 ../src/guestfs-actions.pod:2349
9744 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)."
9745 msgstr ""
9746
9747 #. type: textblock
9748 #: ../fish/guestfish-actions.pod:1470 ../src/guestfs-actions.pod:2354
9749 msgid ""
9750 "This command is entirely equivalent to running C<fsck -a -t fstype device>."
9751 msgstr ""
9752
9753 #. type: =head2
9754 #: ../fish/guestfish-actions.pod:1472
9755 msgid "get-append"
9756 msgstr "get-append"
9757
9758 #. type: verbatim
9759 #: ../fish/guestfish-actions.pod:1474
9760 #, no-wrap
9761 msgid ""
9762 " get-append\n"
9763 "\n"
9764 msgstr ""
9765 " get-append\n"
9766 "\n"
9767
9768 #. type: textblock
9769 #: ../fish/guestfish-actions.pod:1476 ../src/guestfs-actions.pod:2365
9770 msgid ""
9771 "Return the additional kernel options which are added to the guest kernel "
9772 "command line."
9773 msgstr ""
9774
9775 #. type: textblock
9776 #: ../fish/guestfish-actions.pod:1479 ../src/guestfs-actions.pod:2368
9777 msgid "If C<NULL> then no options are added."
9778 msgstr ""
9779
9780 #. type: =head2
9781 #: ../fish/guestfish-actions.pod:1481
9782 msgid "get-attach-method"
9783 msgstr "get-attach-method"
9784
9785 #. type: verbatim
9786 #: ../fish/guestfish-actions.pod:1483
9787 #, no-wrap
9788 msgid ""
9789 " get-attach-method\n"
9790 "\n"
9791 msgstr ""
9792 " get-attach-method\n"
9793 "\n"
9794
9795 #. type: textblock
9796 #: ../fish/guestfish-actions.pod:1485
9797 msgid "Return the current attach method.  See L</set-attach-method>."
9798 msgstr ""
9799
9800 #. type: =head2
9801 #: ../fish/guestfish-actions.pod:1487
9802 msgid "get-autosync"
9803 msgstr "get-autosync"
9804
9805 #. type: verbatim
9806 #: ../fish/guestfish-actions.pod:1489
9807 #, no-wrap
9808 msgid ""
9809 " get-autosync\n"
9810 "\n"
9811 msgstr ""
9812 " get-autosync\n"
9813 "\n"
9814
9815 #. type: textblock
9816 #: ../fish/guestfish-actions.pod:1491 ../src/guestfs-actions.pod:2393
9817 msgid "Get the autosync flag."
9818 msgstr ""
9819
9820 #. type: =head2
9821 #: ../fish/guestfish-actions.pod:1493
9822 msgid "get-direct"
9823 msgstr "get-direct"
9824
9825 #. type: verbatim
9826 #: ../fish/guestfish-actions.pod:1495
9827 #, no-wrap
9828 msgid ""
9829 " get-direct\n"
9830 "\n"
9831 msgstr ""
9832 " get-direct\n"
9833 "\n"
9834
9835 #. type: textblock
9836 #: ../fish/guestfish-actions.pod:1497 ../src/guestfs-actions.pod:2404
9837 msgid "Return the direct appliance mode flag."
9838 msgstr ""
9839
9840 #. type: =head2
9841 #: ../fish/guestfish-actions.pod:1499
9842 msgid "get-e2label"
9843 msgstr "get-e2label"
9844
9845 #. type: verbatim
9846 #: ../fish/guestfish-actions.pod:1501
9847 #, no-wrap
9848 msgid ""
9849 " get-e2label device\n"
9850 "\n"
9851 msgstr ""
9852 " get-e2label пристрій\n"
9853 "\n"
9854
9855 #. type: textblock
9856 #: ../fish/guestfish-actions.pod:1503 ../src/guestfs-actions.pod:2423
9857 msgid ""
9858 "This returns the ext2/3/4 filesystem label of the filesystem on C<device>."
9859 msgstr ""
9860
9861 #. type: textblock
9862 #: ../fish/guestfish-actions.pod:1506
9863 msgid ""
9864 "I<This function is deprecated.> In new code, use the L</vfs_label> call "
9865 "instead."
9866 msgstr ""
9867
9868 #. type: =head2
9869 #: ../fish/guestfish-actions.pod:1513
9870 msgid "get-e2uuid"
9871 msgstr "get-e2uuid"
9872
9873 #. type: verbatim
9874 #: ../fish/guestfish-actions.pod:1515
9875 #, no-wrap
9876 msgid ""
9877 " get-e2uuid device\n"
9878 "\n"
9879 msgstr ""
9880 " get-e2uuid пристрій\n"
9881 "\n"
9882
9883 #. type: textblock
9884 #: ../fish/guestfish-actions.pod:1517 ../src/guestfs-actions.pod:2444
9885 msgid ""
9886 "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>."
9887 msgstr ""
9888
9889 #. type: textblock
9890 #: ../fish/guestfish-actions.pod:1520
9891 msgid ""
9892 "I<This function is deprecated.> In new code, use the L</vfs_uuid> call "
9893 "instead."
9894 msgstr ""
9895
9896 #. type: =head2
9897 #: ../fish/guestfish-actions.pod:1527
9898 msgid "get-memsize"
9899 msgstr "get-memsize"
9900
9901 #. type: verbatim
9902 #: ../fish/guestfish-actions.pod:1529
9903 #, no-wrap
9904 msgid ""
9905 " get-memsize\n"
9906 "\n"
9907 msgstr ""
9908 " get-memsize\n"
9909 "\n"
9910
9911 #. type: textblock
9912 #: ../fish/guestfish-actions.pod:1531 ../src/guestfs-actions.pod:2457
9913 msgid ""
9914 "This gets the memory size in megabytes allocated to the qemu subprocess."
9915 msgstr ""
9916
9917 #. type: textblock
9918 #: ../fish/guestfish-actions.pod:1534
9919 msgid ""
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."
9923 msgstr ""
9924
9925 #. type: textblock
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
9930 msgid ""
9931 "For more information on the architecture of libguestfs, see L<guestfs(3)>."
9932 msgstr ""
9933
9934 #. type: =head2
9935 #: ../fish/guestfish-actions.pod:1541
9936 msgid "get-network"
9937 msgstr "get-network"
9938
9939 #. type: verbatim
9940 #: ../fish/guestfish-actions.pod:1543
9941 #, no-wrap
9942 msgid ""
9943 " get-network\n"
9944 "\n"
9945 msgstr ""
9946 " get-network\n"
9947 "\n"
9948
9949 #. type: textblock
9950 #: ../fish/guestfish-actions.pod:1545 ../src/guestfs-actions.pod:2476
9951 msgid "This returns the enable network flag."
9952 msgstr ""
9953
9954 #. type: =head2
9955 #: ../fish/guestfish-actions.pod:1547
9956 msgid "get-path"
9957 msgstr "get-path"
9958
9959 #. type: verbatim
9960 #: ../fish/guestfish-actions.pod:1549
9961 #, no-wrap
9962 msgid ""
9963 " get-path\n"
9964 "\n"
9965 msgstr ""
9966 " get-path\n"
9967 "\n"
9968
9969 #. type: textblock
9970 #: ../fish/guestfish-actions.pod:1551 ../src/guestfs-actions.pod:2487
9971 msgid "Return the current search path."
9972 msgstr ""
9973
9974 #. type: textblock
9975 #: ../fish/guestfish-actions.pod:1553 ../src/guestfs-actions.pod:2489
9976 msgid ""
9977 "This is always non-NULL.  If it wasn't set already, then this will return "
9978 "the default path."
9979 msgstr ""
9980
9981 #. type: =head2
9982 #: ../fish/guestfish-actions.pod:1556
9983 msgid "get-pgroup"
9984 msgstr ""
9985
9986 #. type: verbatim
9987 #: ../fish/guestfish-actions.pod:1558
9988 #, no-wrap
9989 msgid ""
9990 " get-pgroup\n"
9991 "\n"
9992 msgstr ""
9993
9994 #. type: textblock
9995 #: ../fish/guestfish-actions.pod:1560 ../src/guestfs-actions.pod:2502
9996 msgid "This returns the process group flag."
9997 msgstr ""
9998
9999 #. type: =head2
10000 #: ../fish/guestfish-actions.pod:1562
10001 msgid "get-pid"
10002 msgstr "get-pid"
10003
10004 #. type: =head2
10005 #: ../fish/guestfish-actions.pod:1564
10006 msgid "pid"
10007 msgstr "PID"
10008
10009 #. type: verbatim
10010 #: ../fish/guestfish-actions.pod:1566
10011 #, no-wrap
10012 msgid ""
10013 " get-pid\n"
10014 "\n"
10015 msgstr ""
10016 " get-pid\n"
10017 "\n"
10018
10019 #. type: textblock
10020 #: ../fish/guestfish-actions.pod:1568 ../src/guestfs-actions.pod:2513
10021 msgid ""
10022 "Return the process ID of the qemu subprocess.  If there is no qemu "
10023 "subprocess, then this will return an error."
10024 msgstr ""
10025
10026 #. type: textblock
10027 #: ../fish/guestfish-actions.pod:1571 ../src/guestfs-actions.pod:2516
10028 msgid "This is an internal call used for debugging and testing."
10029 msgstr ""
10030
10031 #. type: =head2
10032 #: ../fish/guestfish-actions.pod:1573
10033 msgid "get-qemu"
10034 msgstr "get-qemu"
10035
10036 #. type: verbatim
10037 #: ../fish/guestfish-actions.pod:1575
10038 #, no-wrap
10039 msgid ""
10040 " get-qemu\n"
10041 "\n"
10042 msgstr ""
10043 " get-qemu\n"
10044 "\n"
10045
10046 #. type: textblock
10047 #: ../fish/guestfish-actions.pod:1577 ../src/guestfs-actions.pod:2527
10048 msgid "Return the current qemu binary."
10049 msgstr ""
10050
10051 #. type: textblock
10052 #: ../fish/guestfish-actions.pod:1579 ../src/guestfs-actions.pod:2529
10053 msgid ""
10054 "This is always non-NULL.  If it wasn't set already, then this will return "
10055 "the default qemu binary name."
10056 msgstr ""
10057
10058 #. type: =head2
10059 #: ../fish/guestfish-actions.pod:1582
10060 msgid "get-recovery-proc"
10061 msgstr "get-recovery-proc"
10062
10063 #. type: verbatim
10064 #: ../fish/guestfish-actions.pod:1584
10065 #, no-wrap
10066 msgid ""
10067 " get-recovery-proc\n"
10068 "\n"
10069 msgstr ""
10070 " get-recovery-proc\n"
10071 "\n"
10072
10073 #. type: textblock
10074 #: ../fish/guestfish-actions.pod:1586 ../src/guestfs-actions.pod:2542
10075 msgid "Return the recovery process enabled flag."
10076 msgstr ""
10077
10078 #. type: =head2
10079 #: ../fish/guestfish-actions.pod:1588
10080 msgid "get-selinux"
10081 msgstr "get-selinux"
10082
10083 #. type: verbatim
10084 #: ../fish/guestfish-actions.pod:1590
10085 #, no-wrap
10086 msgid ""
10087 " get-selinux\n"
10088 "\n"
10089 msgstr ""
10090 " get-selinux\n"
10091 "\n"
10092
10093 #. type: textblock
10094 #: ../fish/guestfish-actions.pod:1592
10095 msgid ""
10096 "This returns the current setting of the selinux flag which is passed to the "
10097 "appliance at boot time.  See L</set-selinux>."
10098 msgstr ""
10099
10100 #. type: =head2
10101 #: ../fish/guestfish-actions.pod:1598
10102 msgid "get-smp"
10103 msgstr ""
10104
10105 #. type: verbatim
10106 #: ../fish/guestfish-actions.pod:1600
10107 #, no-wrap
10108 msgid ""
10109 " get-smp\n"
10110 "\n"
10111 msgstr ""
10112
10113 #. type: textblock
10114 #: ../fish/guestfish-actions.pod:1602 ../src/guestfs-actions.pod:2568
10115 msgid "This returns the number of virtual CPUs assigned to the appliance."
10116 msgstr ""
10117
10118 #. type: =head2
10119 #: ../fish/guestfish-actions.pod:1604
10120 msgid "get-state"
10121 msgstr "get-state"
10122
10123 #. type: verbatim
10124 #: ../fish/guestfish-actions.pod:1606
10125 #, no-wrap
10126 msgid ""
10127 " get-state\n"
10128 "\n"
10129 msgstr ""
10130 " get-state\n"
10131 "\n"
10132
10133 #. type: textblock
10134 #: ../fish/guestfish-actions.pod:1608 ../src/guestfs-actions.pod:2579
10135 msgid ""
10136 "This returns the current state as an opaque integer.  This is only useful "
10137 "for printing debug and internal error messages."
10138 msgstr ""
10139
10140 #. type: textblock
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)>."
10147 msgstr ""
10148
10149 #. type: =head2
10150 #: ../fish/guestfish-actions.pod:1613
10151 msgid "get-trace"
10152 msgstr "get-trace"
10153
10154 #. type: verbatim
10155 #: ../fish/guestfish-actions.pod:1615
10156 #, no-wrap
10157 msgid ""
10158 " get-trace\n"
10159 "\n"
10160 msgstr ""
10161 " get-trace\n"
10162 "\n"
10163
10164 #. type: textblock
10165 #: ../fish/guestfish-actions.pod:1617 ../src/guestfs-actions.pod:2593
10166 msgid "Return the command trace flag."
10167 msgstr ""
10168
10169 #. type: =head2
10170 #: ../fish/guestfish-actions.pod:1619
10171 msgid "get-umask"
10172 msgstr "get-umask"
10173
10174 #. type: verbatim
10175 #: ../fish/guestfish-actions.pod:1621
10176 #, no-wrap
10177 msgid ""
10178 " get-umask\n"
10179 "\n"
10180 msgstr ""
10181 " get-umask\n"
10182 "\n"
10183
10184 #. type: textblock
10185 #: ../fish/guestfish-actions.pod:1623
10186 msgid ""
10187 "Return the current umask.  By default the umask is C<022> unless it has been "
10188 "set by calling L</umask>."
10189 msgstr ""
10190
10191 #. type: =head2
10192 #: ../fish/guestfish-actions.pod:1626
10193 msgid "get-verbose"
10194 msgstr "get-verbose"
10195
10196 #. type: verbatim
10197 #: ../fish/guestfish-actions.pod:1628
10198 #, no-wrap
10199 msgid ""
10200 " get-verbose\n"
10201 "\n"
10202 msgstr ""
10203 " get-verbose\n"
10204 "\n"
10205
10206 #. type: textblock
10207 #: ../fish/guestfish-actions.pod:1630 ../src/guestfs-actions.pod:2616
10208 msgid "This returns the verbose messages flag."
10209 msgstr ""
10210
10211 #. type: =head2
10212 #: ../fish/guestfish-actions.pod:1632
10213 msgid "getcon"
10214 msgstr "getcon"
10215
10216 #. type: verbatim
10217 #: ../fish/guestfish-actions.pod:1634
10218 #, no-wrap
10219 msgid ""
10220 " getcon\n"
10221 "\n"
10222 msgstr ""
10223 " getcon\n"
10224 "\n"
10225
10226 #. type: textblock
10227 #: ../fish/guestfish-actions.pod:1636 ../src/guestfs-actions.pod:2627
10228 msgid "This gets the SELinux security context of the daemon."
10229 msgstr ""
10230
10231 #. type: textblock
10232 #: ../fish/guestfish-actions.pod:1638
10233 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>"
10234 msgstr ""
10235
10236 #. type: =head2
10237 #: ../fish/guestfish-actions.pod:1641
10238 msgid "getxattr"
10239 msgstr "getxattr"
10240
10241 #. type: verbatim
10242 #: ../fish/guestfish-actions.pod:1643
10243 #, no-wrap
10244 msgid ""
10245 " getxattr path name\n"
10246 "\n"
10247 msgstr ""
10248 " getxattr шлях назва\n"
10249 "\n"
10250
10251 #. type: textblock
10252 #: ../fish/guestfish-actions.pod:1645
10253 msgid ""
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>."
10257 msgstr ""
10258
10259 #. type: textblock
10260 #: ../fish/guestfish-actions.pod:1649 ../fish/guestfish-actions.pod:2715
10261 msgid ""
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."
10267 msgstr ""
10268
10269 #. type: textblock
10270 #: ../fish/guestfish-actions.pod:1656 ../fish/guestfish-actions.pod:2722
10271 #: ../src/guestfs-actions.pod:2656 ../src/guestfs-actions.pod:4151
10272 msgid ""
10273 "Extended attribute values are blobs of binary data.  If there is no extended "
10274 "attribute named C<name>, this returns an error."
10275 msgstr ""
10276
10277 #. type: textblock
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)>."
10281
10282 #. type: =head2
10283 #: ../fish/guestfish-actions.pod:1661
10284 msgid "getxattrs"
10285 msgstr "getxattrs"
10286
10287 #. type: verbatim
10288 #: ../fish/guestfish-actions.pod:1663
10289 #, no-wrap
10290 msgid ""
10291 " getxattrs path\n"
10292 "\n"
10293 msgstr ""
10294 " getxattrs шлях\n"
10295 "\n"
10296
10297 #. type: textblock
10298 #: ../fish/guestfish-actions.pod:1665 ../src/guestfs-actions.pod:2673
10299 msgid ""
10300 "This call lists the extended attributes of the file or directory C<path>."
10301 msgstr ""
10302
10303 #. type: textblock
10304 #: ../fish/guestfish-actions.pod:1668 ../src/guestfs-actions.pod:2676
10305 msgid ""
10306 "At the system call level, this is a combination of the L<listxattr(2)> and "
10307 "L<getxattr(2)> calls."
10308 msgstr ""
10309
10310 #. type: textblock
10311 #: ../fish/guestfish-actions.pod:1671
10312 msgid "See also: L</lgetxattrs>, L<attr(5)>."
10313 msgstr "Див. також L</lgetxattrs>, L<attr(5)>."
10314
10315 #. type: =head2
10316 #: ../fish/guestfish-actions.pod:1673
10317 msgid "glob-expand"
10318 msgstr "glob-expand"
10319
10320 #. type: verbatim
10321 #: ../fish/guestfish-actions.pod:1675
10322 #, no-wrap
10323 msgid ""
10324 " glob-expand pattern\n"
10325 "\n"
10326 msgstr ""
10327 " glob-expand шаблон\n"
10328 "\n"
10329
10330 #. type: textblock
10331 #: ../fish/guestfish-actions.pod:1677 ../src/guestfs-actions.pod:2693
10332 msgid ""
10333 "This command searches for all the pathnames matching C<pattern> according to "
10334 "the wildcard expansion rules used by the shell."
10335 msgstr ""
10336
10337 #. type: textblock
10338 #: ../fish/guestfish-actions.pod:1681 ../src/guestfs-actions.pod:2697
10339 msgid ""
10340 "If no paths match, then this returns an empty list (note: not an error)."
10341 msgstr ""
10342
10343 #. type: textblock
10344 #: ../fish/guestfish-actions.pod:1684 ../src/guestfs-actions.pod:2700
10345 msgid ""
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."
10348 msgstr ""
10349
10350 #. type: =head2
10351 #: ../fish/guestfish-actions.pod:1688
10352 msgid "grep"
10353 msgstr "grep"
10354
10355 #. type: verbatim
10356 #: ../fish/guestfish-actions.pod:1690
10357 #, no-wrap
10358 msgid ""
10359 " grep regex path\n"
10360 "\n"
10361 msgstr ""
10362 " grepi формальний_вираз шлях\n"
10363 "\n"
10364
10365 #. type: textblock
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."
10368 msgstr ""
10369
10370 #. type: =head2
10371 #: ../fish/guestfish-actions.pod:1698
10372 msgid "grepi"
10373 msgstr "grepi"
10374
10375 #. type: verbatim
10376 #: ../fish/guestfish-actions.pod:1700
10377 #, no-wrap
10378 msgid ""
10379 " grepi regex path\n"
10380 "\n"
10381 msgstr ""
10382 " grepi формальний_вираз шлях\n"
10383 "\n"
10384
10385 #. type: textblock
10386 #: ../fish/guestfish-actions.pod:1702 ../src/guestfs-actions.pod:2736
10387 msgid ""
10388 "This calls the external C<grep -i> program and returns the matching lines."
10389 msgstr ""
10390
10391 #. type: =head2
10392 #: ../fish/guestfish-actions.pod:1708
10393 msgid "grub-install"
10394 msgstr "grub-install"
10395
10396 #. type: verbatim
10397 #: ../fish/guestfish-actions.pod:1710
10398 #, no-wrap
10399 msgid ""
10400 " grub-install root device\n"
10401 "\n"
10402 msgstr ""
10403 " grub-install кореневий пристрій\n"
10404 "\n"
10405
10406 #. type: textblock
10407 #: ../fish/guestfish-actions.pod:1712 ../src/guestfs-actions.pod:2755
10408 msgid ""
10409 "This command installs GRUB 1 (the Grand Unified Bootloader) on C<device>, "
10410 "with the root directory being C<root>."
10411 msgstr ""
10412
10413 #. type: textblock
10414 #: ../fish/guestfish-actions.pod:1721 ../src/guestfs-actions.pod:2764
10415 msgid ""
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>."
10419 msgstr ""
10420
10421 #. type: textblock
10422 #: ../fish/guestfish-actions.pod:1728 ../src/guestfs-actions.pod:2771
10423 msgid ""
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."
10427 msgstr ""
10428
10429 #. type: textblock
10430 #: ../fish/guestfish-actions.pod:1735 ../src/guestfs-actions.pod:2778
10431 msgid ""
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 "
10436 "containing:"
10437 msgstr ""
10438
10439 #. type: verbatim
10440 #: ../fish/guestfish-actions.pod:1742 ../src/guestfs-actions.pod:2785
10441 #, no-wrap
10442 msgid ""
10443 " (hd0) /dev/vda\n"
10444 "\n"
10445 msgstr ""
10446
10447 #. type: textblock
10448 #: ../fish/guestfish-actions.pod:1744 ../src/guestfs-actions.pod:2787
10449 msgid "replacing C</dev/vda> with the name of the installation device."
10450 msgstr ""
10451
10452 #. type: =head2
10453 #: ../fish/guestfish-actions.pod:1748
10454 msgid "head"
10455 msgstr "head"
10456
10457 #. type: verbatim
10458 #: ../fish/guestfish-actions.pod:1750
10459 #, no-wrap
10460 msgid ""
10461 " head path\n"
10462 "\n"
10463 msgstr ""
10464 " head шлях\n"
10465 "\n"
10466
10467 #. type: textblock
10468 #: ../fish/guestfish-actions.pod:1752 ../src/guestfs-actions.pod:2801
10469 msgid ""
10470 "This command returns up to the first 10 lines of a file as a list of strings."
10471 msgstr ""
10472
10473 #. type: =head2
10474 #: ../fish/guestfish-actions.pod:1758
10475 msgid "head-n"
10476 msgstr "head-n"
10477
10478 #. type: verbatim
10479 #: ../fish/guestfish-actions.pod:1760
10480 #, no-wrap
10481 msgid ""
10482 " head-n nrlines path\n"
10483 "\n"
10484 msgstr ""
10485
10486 #. type: textblock
10487 #: ../fish/guestfish-actions.pod:1762 ../src/guestfs-actions.pod:2820
10488 msgid ""
10489 "If the parameter C<nrlines> is a positive number, this returns the first "
10490 "C<nrlines> lines of the file C<path>."
10491 msgstr ""
10492
10493 #. type: textblock
10494 #: ../fish/guestfish-actions.pod:1765 ../src/guestfs-actions.pod:2823
10495 msgid ""
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."
10498 msgstr ""
10499
10500 #. type: textblock
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."
10504 msgstr ""
10505
10506 #. type: =head2
10507 #: ../fish/guestfish-actions.pod:1773
10508 msgid "hexdump"
10509 msgstr "hexdump"
10510
10511 #. type: verbatim
10512 #: ../fish/guestfish-actions.pod:1775
10513 #, no-wrap
10514 msgid ""
10515 " hexdump path\n"
10516 "\n"
10517 msgstr ""
10518 " hexdump шлях\n"
10519 "\n"
10520
10521 #. type: textblock
10522 #: ../fish/guestfish-actions.pod:1777 ../src/guestfs-actions.pod:2843
10523 msgid ""
10524 "This runs C<hexdump -C> on the given C<path>.  The result is the human-"
10525 "readable, canonical hex dump of the file."
10526 msgstr ""
10527
10528 #. type: =head2
10529 #: ../fish/guestfish-actions.pod:1783
10530 msgid "initrd-cat"
10531 msgstr "initrd-cat"
10532
10533 #. type: verbatim
10534 #: ../fish/guestfish-actions.pod:1785
10535 #, no-wrap
10536 msgid ""
10537 " initrd-cat initrdpath filename\n"
10538 "\n"
10539 msgstr ""
10540 " initrd-cat шлях_initrd назва_файла\n"
10541 "\n"
10542
10543 #. type: textblock
10544 #: ../fish/guestfish-actions.pod:1787 ../src/guestfs-actions.pod:2862
10545 msgid ""
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</> "
10548 "character."
10549 msgstr ""
10550
10551 #. type: textblock
10552 #: ../fish/guestfish-actions.pod:1791 ../src/guestfs-actions.pod:2866
10553 msgid ""
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 "
10556 "initramfs image:"
10557 msgstr ""
10558
10559 #. type: verbatim
10560 #: ../fish/guestfish-actions.pod:1795 ../src/guestfs-actions.pod:2870
10561 #, no-wrap
10562 msgid ""
10563 " initrd-cat /boot/initrd-<version>.img init\n"
10564 "\n"
10565 msgstr ""
10566
10567 #. type: textblock
10568 #: ../fish/guestfish-actions.pod:1797
10569 msgid "See also L</initrd-list>."
10570 msgstr "Див. також L</initrd-list>."
10571
10572 #. type: =head2
10573 #: ../fish/guestfish-actions.pod:1802
10574 msgid "initrd-list"
10575 msgstr "initrd-list"
10576
10577 #. type: verbatim
10578 #: ../fish/guestfish-actions.pod:1804
10579 #, no-wrap
10580 msgid ""
10581 " initrd-list path\n"
10582 "\n"
10583 msgstr ""
10584 " initrd-list шлях\n"
10585 "\n"
10586
10587 #. type: textblock
10588 #: ../fish/guestfish-actions.pod:1806 ../src/guestfs-actions.pod:2889
10589 msgid "This command lists out files contained in an initrd."
10590 msgstr ""
10591
10592 #. type: textblock
10593 #: ../fish/guestfish-actions.pod:1808 ../src/guestfs-actions.pod:2891
10594 msgid ""
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."
10598 msgstr ""
10599
10600 #. type: textblock
10601 #: ../fish/guestfish-actions.pod:1812 ../src/guestfs-actions.pod:2895
10602 msgid ""
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 "
10605 "files)."
10606 msgstr ""
10607
10608 #. type: =head2
10609 #: ../fish/guestfish-actions.pod:1816
10610 msgid "inotify-add-watch"
10611 msgstr "inotify-add-watch"
10612
10613 #. type: verbatim
10614 #: ../fish/guestfish-actions.pod:1818
10615 #, no-wrap
10616 msgid ""
10617 " inotify-add-watch path mask\n"
10618 "\n"
10619 msgstr ""
10620 " inotify-add-watch шлях маска\n"
10621 "\n"
10622
10623 #. type: textblock
10624 #: ../fish/guestfish-actions.pod:1820 ../src/guestfs-actions.pod:2912
10625 msgid "Watch C<path> for the events listed in C<mask>."
10626 msgstr ""
10627
10628 #. type: textblock
10629 #: ../fish/guestfish-actions.pod:1822 ../src/guestfs-actions.pod:2914
10630 msgid ""
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)."
10633 msgstr ""
10634
10635 #. type: textblock
10636 #: ../fish/guestfish-actions.pod:1826 ../src/guestfs-actions.pod:2918
10637 msgid ""
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>."
10640 msgstr ""
10641
10642 #. type: =head2
10643 #: ../fish/guestfish-actions.pod:1830
10644 msgid "inotify-close"
10645 msgstr "inotify-close"
10646
10647 #. type: verbatim
10648 #: ../fish/guestfish-actions.pod:1832
10649 #, no-wrap
10650 msgid ""
10651 " inotify-close\n"
10652 "\n"
10653 msgstr ""
10654 " inotify-close\n"
10655 "\n"
10656
10657 #. type: textblock
10658 #: ../fish/guestfish-actions.pod:1834 ../src/guestfs-actions.pod:2931
10659 msgid ""
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 "
10662 "resources."
10663 msgstr ""
10664
10665 #. type: =head2
10666 #: ../fish/guestfish-actions.pod:1838
10667 msgid "inotify-files"
10668 msgstr "inotify-files"
10669
10670 #. type: verbatim
10671 #: ../fish/guestfish-actions.pod:1840
10672 #, no-wrap
10673 msgid ""
10674 " inotify-files\n"
10675 "\n"
10676 msgstr ""
10677 " inotify-files\n"
10678 "\n"
10679
10680 #. type: textblock
10681 #: ../fish/guestfish-actions.pod:1842
10682 msgid ""
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."
10686 msgstr ""
10687
10688 #. type: =head2
10689 #: ../fish/guestfish-actions.pod:1846
10690 msgid "inotify-init"
10691 msgstr "inotify-init"
10692
10693 #. type: verbatim
10694 #: ../fish/guestfish-actions.pod:1848
10695 #, no-wrap
10696 msgid ""
10697 " inotify-init maxevents\n"
10698 "\n"
10699 msgstr ""
10700
10701 #. type: textblock
10702 #: ../fish/guestfish-actions.pod:1850 ../src/guestfs-actions.pod:2960
10703 msgid ""
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."
10706 msgstr ""
10707
10708 #. type: textblock
10709 #: ../fish/guestfish-actions.pod:1854
10710 msgid ""
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>)."
10717 msgstr ""
10718
10719 #. type: textblock
10720 #: ../fish/guestfish-actions.pod:1864
10721 msgid ""
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>."
10725 msgstr ""
10726
10727 #. type: textblock
10728 #: ../fish/guestfish-actions.pod:1870
10729 msgid ""
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."
10734 msgstr ""
10735
10736 #. type: textblock
10737 #: ../fish/guestfish-actions.pod:1877
10738 msgid ""
10739 "The handle should be closed after use by calling L</inotify-close>.  This "
10740 "also removes any watches automatically."
10741 msgstr ""
10742
10743 #. type: textblock
10744 #: ../fish/guestfish-actions.pod:1881 ../src/guestfs-actions.pod:2991
10745 msgid ""
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."
10749 msgstr ""
10750
10751 #. type: =head2
10752 #: ../fish/guestfish-actions.pod:1886
10753 msgid "inotify-read"
10754 msgstr "inotify-read"
10755
10756 #. type: verbatim
10757 #: ../fish/guestfish-actions.pod:1888
10758 #, no-wrap
10759 msgid ""
10760 " inotify-read\n"
10761 "\n"
10762 msgstr ""
10763 " inotify-read\n"
10764 "\n"
10765
10766 #. type: textblock
10767 #: ../fish/guestfish-actions.pod:1890 ../src/guestfs-actions.pod:3005
10768 msgid ""
10769 "Return the complete queue of events that have happened since the previous "
10770 "read call."
10771 msgstr ""
10772
10773 #. type: textblock
10774 #: ../fish/guestfish-actions.pod:1893 ../src/guestfs-actions.pod:3008
10775 msgid "If no events have happened, this returns an empty list."
10776 msgstr ""
10777
10778 #. type: textblock
10779 #: ../fish/guestfish-actions.pod:1895 ../src/guestfs-actions.pod:3010
10780 msgid ""
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."
10785 msgstr ""
10786
10787 #. type: =head2
10788 #: ../fish/guestfish-actions.pod:1901
10789 msgid "inotify-rm-watch"
10790 msgstr "inotify-rm-watch"
10791
10792 #. type: verbatim
10793 #: ../fish/guestfish-actions.pod:1903
10794 #, no-wrap
10795 msgid ""
10796 " inotify-rm-watch wd\n"
10797 "\n"
10798 msgstr ""
10799
10800 #. type: textblock
10801 #: ../fish/guestfish-actions.pod:1905
10802 msgid "Remove a previously defined inotify watch.  See L</inotify-add-watch>."
10803 msgstr ""
10804
10805 #. type: =head2
10806 #: ../fish/guestfish-actions.pod:1908
10807 msgid "inspect-get-arch"
10808 msgstr "inspect-get-arch"
10809
10810 #. type: verbatim
10811 #: ../fish/guestfish-actions.pod:1910
10812 #, no-wrap
10813 msgid ""
10814 " inspect-get-arch root\n"
10815 "\n"
10816 msgstr ""
10817 " inspect-get-arch корінь\n"
10818 "\n"
10819
10820 #. type: textblock
10821 #: ../fish/guestfish-actions.pod:1912
10822 msgid ""
10823 "This returns the architecture of the inspected operating system.  The "
10824 "possible return values are listed under L</file-architecture>."
10825 msgstr ""
10826
10827 #. type: textblock
10828 #: ../fish/guestfish-actions.pod:1916 ../src/guestfs-actions.pod:3045
10829 msgid ""
10830 "If the architecture could not be determined, then the string C<unknown> is "
10831 "returned."
10832 msgstr ""
10833
10834 #. type: textblock
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."
10853 msgstr ""
10854
10855 #. type: =head2
10856 #: ../fish/guestfish-actions.pod:1921
10857 msgid "inspect-get-distro"
10858 msgstr "inspect-get-distro"
10859
10860 #. type: verbatim
10861 #: ../fish/guestfish-actions.pod:1923
10862 #, no-wrap
10863 msgid ""
10864 " inspect-get-distro root\n"
10865 "\n"
10866 msgstr ""
10867 " inspect-get-distro корінь\n"
10868 "\n"
10869
10870 #. type: textblock
10871 #: ../fish/guestfish-actions.pod:1925 ../src/guestfs-actions.pod:3061
10872 msgid ""
10873 "This returns the distro (distribution) of the inspected operating system."
10874 msgstr ""
10875
10876 #. type: textblock
10877 #: ../fish/guestfish-actions.pod:1928 ../src/guestfs-actions.pod:3064
10878 msgid "Currently defined distros are:"
10879 msgstr ""
10880
10881 #. type: =item
10882 #: ../fish/guestfish-actions.pod:1932 ../src/guestfs-actions.pod:3068
10883 msgid "\"archlinux\""
10884 msgstr "\"archlinux\""
10885
10886 #. type: textblock
10887 #: ../fish/guestfish-actions.pod:1934 ../src/guestfs-actions.pod:3070
10888 msgid "Arch Linux."
10889 msgstr "Arch Linux."
10890
10891 #. type: =item
10892 #: ../fish/guestfish-actions.pod:1936 ../src/guestfs-actions.pod:3072
10893 msgid "\"centos\""
10894 msgstr ""
10895
10896 #. type: textblock
10897 #: ../fish/guestfish-actions.pod:1938 ../src/guestfs-actions.pod:3074
10898 msgid "CentOS."
10899 msgstr ""
10900
10901 #. type: =item
10902 #: ../fish/guestfish-actions.pod:1940 ../src/guestfs-actions.pod:3076
10903 msgid "\"debian\""
10904 msgstr "\"debian\""
10905
10906 #. type: textblock
10907 #: ../fish/guestfish-actions.pod:1942 ../src/guestfs-actions.pod:3078
10908 msgid "Debian."
10909 msgstr "Debian."
10910
10911 #. type: =item
10912 #: ../fish/guestfish-actions.pod:1944 ../src/guestfs-actions.pod:3080
10913 msgid "\"fedora\""
10914 msgstr "\"fedora\""
10915
10916 #. type: textblock
10917 #: ../fish/guestfish-actions.pod:1946 ../src/guestfs-actions.pod:3082
10918 msgid "Fedora."
10919 msgstr "Fedora."
10920
10921 #. type: =item
10922 #: ../fish/guestfish-actions.pod:1948 ../src/guestfs-actions.pod:3084
10923 msgid "\"gentoo\""
10924 msgstr "\"gentoo\""
10925
10926 #. type: textblock
10927 #: ../fish/guestfish-actions.pod:1950 ../src/guestfs-actions.pod:3086
10928 msgid "Gentoo."
10929 msgstr "Gentoo."
10930
10931 #. type: =item
10932 #: ../fish/guestfish-actions.pod:1952 ../src/guestfs-actions.pod:3088
10933 msgid "\"linuxmint\""
10934 msgstr "\"linuxmint\""
10935
10936 #. type: textblock
10937 #: ../fish/guestfish-actions.pod:1954 ../src/guestfs-actions.pod:3090
10938 msgid "Linux Mint."
10939 msgstr "Linux Mint."
10940
10941 #. type: =item
10942 #: ../fish/guestfish-actions.pod:1956 ../src/guestfs-actions.pod:3092
10943 msgid "\"mageia\""
10944 msgstr ""
10945
10946 #. type: textblock
10947 #: ../fish/guestfish-actions.pod:1958 ../src/guestfs-actions.pod:3094
10948 msgid "Mageia."
10949 msgstr ""
10950
10951 #. type: =item
10952 #: ../fish/guestfish-actions.pod:1960 ../src/guestfs-actions.pod:3096
10953 msgid "\"mandriva\""
10954 msgstr "\"mandriva\""
10955
10956 #. type: textblock
10957 #: ../fish/guestfish-actions.pod:1962 ../src/guestfs-actions.pod:3098
10958 msgid "Mandriva."
10959 msgstr "Mandriva."
10960
10961 #. type: =item
10962 #: ../fish/guestfish-actions.pod:1964 ../src/guestfs-actions.pod:3100
10963 msgid "\"meego\""
10964 msgstr "\"meego\""
10965
10966 #. type: textblock
10967 #: ../fish/guestfish-actions.pod:1966 ../src/guestfs-actions.pod:3102
10968 msgid "MeeGo."
10969 msgstr "MeeGo."
10970
10971 #. type: =item
10972 #: ../fish/guestfish-actions.pod:1968 ../src/guestfs-actions.pod:3104
10973 msgid "\"opensuse\""
10974 msgstr ""
10975
10976 #. type: textblock
10977 #: ../fish/guestfish-actions.pod:1970 ../src/guestfs-actions.pod:3106
10978 msgid "OpenSUSE."
10979 msgstr ""
10980
10981 #. type: =item
10982 #: ../fish/guestfish-actions.pod:1972 ../src/guestfs-actions.pod:3108
10983 msgid "\"pardus\""
10984 msgstr "\"pardus\""
10985
10986 #. type: textblock
10987 #: ../fish/guestfish-actions.pod:1974 ../src/guestfs-actions.pod:3110
10988 msgid "Pardus."
10989 msgstr "Pardus."
10990
10991 #. type: =item
10992 #: ../fish/guestfish-actions.pod:1976 ../src/guestfs-actions.pod:3112
10993 msgid "\"redhat-based\""
10994 msgstr "\"redhat-based\""
10995
10996 #. type: textblock
10997 #: ../fish/guestfish-actions.pod:1978 ../src/guestfs-actions.pod:3114
10998 msgid "Some Red Hat-derived distro."
10999 msgstr "Дистрибутив, що походить від Red Hat."
11000
11001 #. type: =item
11002 #: ../fish/guestfish-actions.pod:1980 ../src/guestfs-actions.pod:3116
11003 msgid "\"rhel\""
11004 msgstr "\"rhel\""
11005
11006 #. type: textblock
11007 #: ../fish/guestfish-actions.pod:1982 ../src/guestfs-actions.pod:3118
11008 msgid "Red Hat Enterprise Linux."
11009 msgstr "Red Hat Enterprise Linux."
11010
11011 #. type: =item
11012 #: ../fish/guestfish-actions.pod:1984 ../src/guestfs-actions.pod:3120
11013 msgid "\"scientificlinux\""
11014 msgstr "\"scientificlinux\""
11015
11016 #. type: textblock
11017 #: ../fish/guestfish-actions.pod:1986 ../src/guestfs-actions.pod:3122
11018 msgid "Scientific Linux."
11019 msgstr "Scientific Linux."
11020
11021 #. type: =item
11022 #: ../fish/guestfish-actions.pod:1988 ../src/guestfs-actions.pod:3124
11023 msgid "\"slackware\""
11024 msgstr "\"slackware\""
11025
11026 #. type: textblock
11027 #: ../fish/guestfish-actions.pod:1990 ../src/guestfs-actions.pod:3126
11028 msgid "Slackware."
11029 msgstr "Slackware."
11030
11031 #. type: =item
11032 #: ../fish/guestfish-actions.pod:1992 ../src/guestfs-actions.pod:3128
11033 msgid "\"ttylinux\""
11034 msgstr ""
11035
11036 #. type: textblock
11037 #: ../fish/guestfish-actions.pod:1994 ../src/guestfs-actions.pod:3130
11038 msgid "ttylinux."
11039 msgstr ""
11040
11041 #. type: =item
11042 #: ../fish/guestfish-actions.pod:1996 ../src/guestfs-actions.pod:3132
11043 msgid "\"ubuntu\""
11044 msgstr "\"ubuntu\""
11045
11046 #. type: textblock
11047 #: ../fish/guestfish-actions.pod:1998 ../src/guestfs-actions.pod:3134
11048 msgid "Ubuntu."
11049 msgstr "Ubuntu."
11050
11051 #. type: =item
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\""
11057
11058 #. type: textblock
11059 #: ../fish/guestfish-actions.pod:2002 ../src/guestfs-actions.pod:3138
11060 msgid "The distro could not be determined."
11061 msgstr "Дистрибутив, тип якого не вдалося визначити."
11062
11063 #. type: =item
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\""
11068
11069 #. type: textblock
11070 #: ../fish/guestfish-actions.pod:2006 ../src/guestfs-actions.pod:3142
11071 msgid ""
11072 "Windows does not have distributions.  This string is returned if the OS type "
11073 "is Windows."
11074 msgstr ""
11075
11076 #. type: textblock
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
11080 msgid ""
11081 "Future versions of libguestfs may return other strings here.  The caller "
11082 "should be prepared to handle any string."
11083 msgstr ""
11084
11085 #. type: =head2
11086 #: ../fish/guestfish-actions.pod:2016
11087 msgid "inspect-get-drive-mappings"
11088 msgstr ""
11089
11090 #. type: verbatim
11091 #: ../fish/guestfish-actions.pod:2018
11092 #, no-wrap
11093 msgid ""
11094 " inspect-get-drive-mappings root\n"
11095 "\n"
11096 msgstr ""
11097
11098 #. type: textblock
11099 #: ../fish/guestfish-actions.pod:2020 ../src/guestfs-actions.pod:3163
11100 msgid ""
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:"
11105 msgstr ""
11106
11107 #. type: verbatim
11108 #: ../fish/guestfish-actions.pod:2026 ../src/guestfs-actions.pod:3169
11109 #, no-wrap
11110 msgid ""
11111 " C      =>     /dev/vda2\n"
11112 " E      =>     /dev/vdb1\n"
11113 " F      =>     /dev/vdc1\n"
11114 "\n"
11115 msgstr ""
11116
11117 #. type: textblock
11118 #: ../fish/guestfish-actions.pod:2030 ../src/guestfs-actions.pod:3173
11119 msgid ""
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 "
11122 "character."
11123 msgstr ""
11124
11125 #. type: textblock
11126 #: ../fish/guestfish-actions.pod:2034 ../src/guestfs-actions.pod:3177
11127 msgid ""
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>, "
11131 "C<h1> etc."
11132 msgstr ""
11133
11134 #. type: textblock
11135 #: ../fish/guestfish-actions.pod:2039 ../src/guestfs-actions.pod:3182
11136 msgid ""
11137 "For Windows guests, currently only hard drive mappings are returned.  "
11138 "Removable disks (eg. DVD-ROMs) are ignored."
11139 msgstr ""
11140
11141 #. type: textblock
11142 #: ../fish/guestfish-actions.pod:2042 ../src/guestfs-actions.pod:3185
11143 msgid ""
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."
11146 msgstr ""
11147
11148 #. type: textblock
11149 #: ../fish/guestfish-actions.pod:2045
11150 msgid ""
11151 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
11152 "get-mountpoints>, L</inspect-get-filesystems>."
11153 msgstr ""
11154
11155 #. type: =head2
11156 #: ../fish/guestfish-actions.pod:2049
11157 msgid "inspect-get-filesystems"
11158 msgstr "inspect-get-filesystems"
11159
11160 #. type: verbatim
11161 #: ../fish/guestfish-actions.pod:2051
11162 #, no-wrap
11163 msgid ""
11164 " inspect-get-filesystems root\n"
11165 "\n"
11166 msgstr ""
11167 " inspect-get-filesystems корінь\n"
11168 "\n"
11169
11170 #. type: textblock
11171 #: ../fish/guestfish-actions.pod:2053 ../src/guestfs-actions.pod:3206
11172 msgid ""
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."
11176 msgstr ""
11177
11178 #. type: textblock
11179 #: ../fish/guestfish-actions.pod:2058 ../src/guestfs-actions.pod:3211
11180 msgid ""
11181 "In the case of a multi-boot virtual machine, it is possible for a filesystem "
11182 "to be shared between operating systems."
11183 msgstr ""
11184
11185 #. type: textblock
11186 #: ../fish/guestfish-actions.pod:2061
11187 msgid ""
11188 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
11189 "get-mountpoints>."
11190 msgstr ""
11191
11192 #. type: =head2
11193 #: ../fish/guestfish-actions.pod:2064
11194 msgid "inspect-get-format"
11195 msgstr "inspect-get-format"
11196
11197 #. type: verbatim
11198 #: ../fish/guestfish-actions.pod:2066
11199 #, no-wrap
11200 msgid ""
11201 " inspect-get-format root\n"
11202 "\n"
11203 msgstr ""
11204 " inspect-get-format корінь\n"
11205 "\n"
11206
11207 #. type: textblock
11208 #: ../fish/guestfish-actions.pod:2068 ../src/guestfs-actions.pod:3229
11209 msgid ""
11210 "This returns the format of the inspected operating system.  You can use it "
11211 "to detect install images, live CDs and similar."
11212 msgstr ""
11213
11214 #. type: textblock
11215 #: ../fish/guestfish-actions.pod:2071 ../src/guestfs-actions.pod:3232
11216 msgid "Currently defined formats are:"
11217 msgstr ""
11218
11219 #. type: =item
11220 #: ../fish/guestfish-actions.pod:2075 ../src/guestfs-actions.pod:3236
11221 msgid "\"installed\""
11222 msgstr "\"installed\""
11223
11224 #. type: textblock
11225 #: ../fish/guestfish-actions.pod:2077 ../src/guestfs-actions.pod:3238
11226 msgid "This is an installed operating system."
11227 msgstr "Це встановлена операційна система."
11228
11229 #. type: =item
11230 #: ../fish/guestfish-actions.pod:2079 ../src/guestfs-actions.pod:3240
11231 msgid "\"installer\""
11232 msgstr ""
11233
11234 #. type: textblock
11235 #: ../fish/guestfish-actions.pod:2081 ../src/guestfs-actions.pod:3242
11236 msgid ""
11237 "The disk image being inspected is not an installed operating system, but a "
11238 "I<bootable> install disk, live CD, or similar."
11239 msgstr ""
11240
11241 #. type: textblock
11242 #: ../fish/guestfish-actions.pod:2086 ../src/guestfs-actions.pod:3247
11243 msgid "The format of this disk image is not known."
11244 msgstr ""
11245
11246 #. type: =head2
11247 #: ../fish/guestfish-actions.pod:2095
11248 msgid "inspect-get-hostname"
11249 msgstr "inspect-get-hostname"
11250
11251 #. type: verbatim
11252 #: ../fish/guestfish-actions.pod:2097
11253 #, no-wrap
11254 msgid ""
11255 " inspect-get-hostname root\n"
11256 "\n"
11257 msgstr ""
11258 " inspect-get-hostname корінь\n"
11259 "\n"
11260
11261 #. type: textblock
11262 #: ../fish/guestfish-actions.pod:2099 ../src/guestfs-actions.pod:3267
11263 msgid ""
11264 "This function returns the hostname of the operating system as found by "
11265 "inspection of the guest's configuration files."
11266 msgstr ""
11267
11268 #. type: textblock
11269 #: ../fish/guestfish-actions.pod:2102 ../src/guestfs-actions.pod:3270
11270 msgid ""
11271 "If the hostname could not be determined, then the string C<unknown> is "
11272 "returned."
11273 msgstr ""
11274
11275 #. type: =head2
11276 #: ../fish/guestfish-actions.pod:2107
11277 msgid "inspect-get-icon"
11278 msgstr ""
11279
11280 #. type: verbatim
11281 #: ../fish/guestfish-actions.pod:2109
11282 #, no-wrap
11283 msgid ""
11284 " inspect-get-icon root [favicon:true|false] [highquality:true|false]\n"
11285 "\n"
11286 msgstr ""
11287
11288 #. type: textblock
11289 #: ../fish/guestfish-actions.pod:2111 ../src/guestfs-actions.pod:3296
11290 msgid ""
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)."
11294 msgstr ""
11295
11296 #. type: textblock
11297 #: ../fish/guestfish-actions.pod:2115 ../src/guestfs-actions.pod:3300
11298 msgid ""
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>."
11301 msgstr ""
11302
11303 #. type: textblock
11304 #: ../fish/guestfish-actions.pod:2118 ../src/guestfs-actions.pod:3303
11305 msgid ""
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)."
11310 msgstr ""
11311
11312 #. type: textblock
11313 #: ../fish/guestfish-actions.pod:2124 ../src/guestfs-actions.pod:3309
11314 msgid ""
11315 "If finding the favicon fails, then we look in other places in the guest for "
11316 "a suitable icon."
11317 msgstr ""
11318
11319 #. type: textblock
11320 #: ../fish/guestfish-actions.pod:2127 ../src/guestfs-actions.pod:3312
11321 msgid ""
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."
11326 msgstr ""
11327
11328 #. type: textblock
11329 #: ../fish/guestfish-actions.pod:2138 ../src/guestfs-actions.pod:3323
11330 msgid ""
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."
11334 msgstr ""
11335
11336 #. type: textblock
11337 #: ../fish/guestfish-actions.pod:2144 ../src/guestfs-actions.pod:3329
11338 msgid ""
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."
11343 msgstr ""
11344
11345 #. type: textblock
11346 #: ../fish/guestfish-actions.pod:2152 ../src/guestfs-actions.pod:3337
11347 msgid ""
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."
11351 msgstr ""
11352
11353 #. type: textblock
11354 #: ../fish/guestfish-actions.pod:2159 ../src/guestfs-actions.pod:3344
11355 msgid ""
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."
11360 msgstr ""
11361
11362 #. type: textblock
11363 #: ../fish/guestfish-actions.pod:2166 ../src/guestfs-actions.pod:3351
11364 msgid ""
11365 "Operating system icons are usually trademarks.  Seek legal advice before "
11366 "using trademarks in applications."
11367 msgstr ""
11368
11369 #. type: =head2
11370 #: ../fish/guestfish-actions.pod:2173
11371 msgid "inspect-get-major-version"
11372 msgstr "inspect-get-major-version"
11373
11374 #. type: verbatim
11375 #: ../fish/guestfish-actions.pod:2175
11376 #, no-wrap
11377 msgid ""
11378 " inspect-get-major-version root\n"
11379 "\n"
11380 msgstr ""
11381 " inspect-get-major-version корінь\n"
11382 "\n"
11383
11384 #. type: textblock
11385 #: ../fish/guestfish-actions.pod:2177 ../src/guestfs-actions.pod:3392
11386 msgid ""
11387 "This returns the major version number of the inspected operating system."
11388 msgstr ""
11389
11390 #. type: textblock
11391 #: ../fish/guestfish-actions.pod:2180 ../src/guestfs-actions.pod:3395
11392 msgid ""
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."
11398 msgstr ""
11399
11400 #. type: textblock
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."
11404 msgstr ""
11405
11406 #. type: =head2
11407 #: ../fish/guestfish-actions.pod:2191
11408 msgid "inspect-get-minor-version"
11409 msgstr "inspect-get-minor-version"
11410
11411 #. type: verbatim
11412 #: ../fish/guestfish-actions.pod:2193
11413 #, no-wrap
11414 msgid ""
11415 " inspect-get-minor-version root\n"
11416 "\n"
11417 msgstr ""
11418 " inspect-get-minor-version корінь\n"
11419 "\n"
11420
11421 #. type: textblock
11422 #: ../fish/guestfish-actions.pod:2195 ../src/guestfs-actions.pod:3416
11423 msgid ""
11424 "This returns the minor version number of the inspected operating system."
11425 msgstr ""
11426
11427 #. type: textblock
11428 #: ../fish/guestfish-actions.pod:2200
11429 msgid ""
11430 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
11431 "get-major-version>."
11432 msgstr ""
11433
11434 #. type: =head2
11435 #: ../fish/guestfish-actions.pod:2203
11436 msgid "inspect-get-mountpoints"
11437 msgstr "inspect-get-mountpoints"
11438
11439 #. type: verbatim
11440 #: ../fish/guestfish-actions.pod:2205
11441 #, no-wrap
11442 msgid ""
11443 " inspect-get-mountpoints root\n"
11444 "\n"
11445 msgstr ""
11446 " inspect-get-mountpoints корінь\n"
11447 "\n"
11448
11449 #. type: textblock
11450 #: ../fish/guestfish-actions.pod:2207 ../src/guestfs-actions.pod:3434
11451 msgid ""
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."
11458 msgstr ""
11459
11460 #. type: textblock
11461 #: ../fish/guestfish-actions.pod:2216 ../src/guestfs-actions.pod:3443
11462 msgid ""
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>)."
11466 msgstr ""
11467
11468 #. type: textblock
11469 #: ../fish/guestfish-actions.pod:2221 ../src/guestfs-actions.pod:3448
11470 msgid ""
11471 "Non-mounted devices such as swap devices are I<not> returned in this list."
11472 msgstr ""
11473
11474 #. type: textblock
11475 #: ../fish/guestfish-actions.pod:2224
11476 msgid ""
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>."
11481 msgstr ""
11482
11483 #. type: textblock
11484 #: ../fish/guestfish-actions.pod:2230
11485 msgid ""
11486 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
11487 "get-filesystems>."
11488 msgstr ""
11489
11490 #. type: =head2
11491 #: ../fish/guestfish-actions.pod:2233
11492 msgid "inspect-get-package-format"
11493 msgstr "inspect-get-package-format"
11494
11495 #. type: verbatim
11496 #: ../fish/guestfish-actions.pod:2235
11497 #, no-wrap
11498 msgid ""
11499 " inspect-get-package-format root\n"
11500 "\n"
11501 msgstr ""
11502 " inspect-get-package-format корінь\n"
11503 "\n"
11504
11505 #. type: textblock
11506 #: ../fish/guestfish-actions.pod:2237
11507 msgid ""
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)."
11512 msgstr ""
11513
11514 #. type: textblock
11515 #: ../fish/guestfish-actions.pod:2243 ../src/guestfs-actions.pod:3480
11516 msgid ""
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 "
11519 "(eg. Windows)."
11520 msgstr ""
11521
11522 #. type: textblock
11523 #: ../fish/guestfish-actions.pod:2247 ../src/guestfs-actions.pod:3484
11524 msgid ""
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."
11527 msgstr ""
11528
11529 #. type: =head2
11530 #: ../fish/guestfish-actions.pod:2253
11531 msgid "inspect-get-package-management"
11532 msgstr "inspect-get-package-management"
11533
11534 #. type: verbatim
11535 #: ../fish/guestfish-actions.pod:2255
11536 #, no-wrap
11537 msgid ""
11538 " inspect-get-package-management root\n"
11539 "\n"
11540 msgstr ""
11541 " inspect-get-package-management корінь\n"
11542 "\n"
11543
11544 #. type: textblock
11545 #: ../fish/guestfish-actions.pod:2257
11546 msgid ""
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)."
11551 msgstr ""
11552
11553 #. type: textblock
11554 #: ../fish/guestfish-actions.pod:2263 ../src/guestfs-actions.pod:3507
11555 msgid ""
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)."
11559 msgstr ""
11560
11561 #. type: textblock
11562 #: ../fish/guestfish-actions.pod:2267 ../src/guestfs-actions.pod:3511
11563 msgid ""
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."
11567 msgstr ""
11568
11569 #. type: =head2
11570 #: ../fish/guestfish-actions.pod:2274
11571 msgid "inspect-get-product-name"
11572 msgstr "inspect-get-product-name"
11573
11574 #. type: verbatim
11575 #: ../fish/guestfish-actions.pod:2276
11576 #, no-wrap
11577 msgid ""
11578 " inspect-get-product-name root\n"
11579 "\n"
11580 msgstr ""
11581 " inspect-get-product-name корінь\n"
11582 "\n"
11583
11584 #. type: textblock
11585 #: ../fish/guestfish-actions.pod:2278 ../src/guestfs-actions.pod:3529
11586 msgid ""
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."
11590 msgstr ""
11591
11592 #. type: textblock
11593 #: ../fish/guestfish-actions.pod:2283 ../src/guestfs-actions.pod:3534
11594 msgid ""
11595 "If the product name could not be determined, then the string C<unknown> is "
11596 "returned."
11597 msgstr ""
11598
11599 #. type: =head2
11600 #: ../fish/guestfish-actions.pod:2288
11601 msgid "inspect-get-product-variant"
11602 msgstr ""
11603
11604 #. type: verbatim
11605 #: ../fish/guestfish-actions.pod:2290
11606 #, no-wrap
11607 msgid ""
11608 " inspect-get-product-variant root\n"
11609 "\n"
11610 msgstr ""
11611
11612 #. type: textblock
11613 #: ../fish/guestfish-actions.pod:2292 ../src/guestfs-actions.pod:3550
11614 msgid "This returns the product variant of the inspected operating system."
11615 msgstr ""
11616
11617 #. type: textblock
11618 #: ../fish/guestfish-actions.pod:2295 ../src/guestfs-actions.pod:3553
11619 msgid ""
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>)."
11627 msgstr ""
11628
11629 #. type: textblock
11630 #: ../fish/guestfish-actions.pod:2304 ../src/guestfs-actions.pod:3562
11631 msgid ""
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."
11635 msgstr ""
11636
11637 #. type: textblock
11638 #: ../fish/guestfish-actions.pod:2308 ../src/guestfs-actions.pod:3566
11639 msgid ""
11640 "If the product variant could not be determined, then the string C<unknown> "
11641 "is returned."
11642 msgstr ""
11643
11644 #. type: textblock
11645 #: ../fish/guestfish-actions.pod:2311
11646 msgid ""
11647 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
11648 "get-product-name>, L</inspect-get-major-version>."
11649 msgstr ""
11650
11651 #. type: =head2
11652 #: ../fish/guestfish-actions.pod:2315
11653 msgid "inspect-get-roots"
11654 msgstr "inspect-get-roots"
11655
11656 #. type: verbatim
11657 #: ../fish/guestfish-actions.pod:2317
11658 #, no-wrap
11659 msgid ""
11660 " inspect-get-roots\n"
11661 "\n"
11662 msgstr ""
11663 " inspect-get-roots\n"
11664 "\n"
11665
11666 #. type: textblock
11667 #: ../fish/guestfish-actions.pod:2319
11668 msgid ""
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."
11672 msgstr ""
11673
11674 #. type: textblock
11675 #: ../fish/guestfish-actions.pod:2323
11676 msgid ""
11677 "This returns an empty list if either no root devices were found or the "
11678 "caller has not called L</inspect-os>."
11679 msgstr ""
11680
11681 #. type: =head2
11682 #: ../fish/guestfish-actions.pod:2328
11683 msgid "inspect-get-type"
11684 msgstr "inspect-get-type"
11685
11686 #. type: verbatim
11687 #: ../fish/guestfish-actions.pod:2330
11688 #, no-wrap
11689 msgid ""
11690 " inspect-get-type root\n"
11691 "\n"
11692 msgstr ""
11693 " inspect-get-type корінь\n"
11694 "\n"
11695
11696 #. type: textblock
11697 #: ../fish/guestfish-actions.pod:2332 ../src/guestfs-actions.pod:3604
11698 msgid ""
11699 "This returns the type of the inspected operating system.  Currently defined "
11700 "types are:"
11701 msgstr ""
11702
11703 #. type: =item
11704 #: ../fish/guestfish-actions.pod:2337 ../src/guestfs-actions.pod:3609
11705 msgid "\"linux\""
11706 msgstr "\"linux\""
11707
11708 #. type: textblock
11709 #: ../fish/guestfish-actions.pod:2339 ../src/guestfs-actions.pod:3611
11710 msgid "Any Linux-based operating system."
11711 msgstr ""
11712
11713 #. type: textblock
11714 #: ../fish/guestfish-actions.pod:2343 ../src/guestfs-actions.pod:3615
11715 msgid "Any Microsoft Windows operating system."
11716 msgstr ""
11717
11718 #. type: =item
11719 #: ../fish/guestfish-actions.pod:2345 ../src/guestfs-actions.pod:3617
11720 msgid "\"freebsd\""
11721 msgstr "\"freebsd\""
11722
11723 #. type: textblock
11724 #: ../fish/guestfish-actions.pod:2347 ../src/guestfs-actions.pod:3619
11725 msgid "FreeBSD."
11726 msgstr "FreeBSD."
11727
11728 #. type: =item
11729 #: ../fish/guestfish-actions.pod:2349 ../src/guestfs-actions.pod:3621
11730 msgid "\"netbsd\""
11731 msgstr ""
11732
11733 #. type: textblock
11734 #: ../fish/guestfish-actions.pod:2351 ../src/guestfs-actions.pod:3623
11735 msgid "NetBSD."
11736 msgstr ""
11737
11738 #. type: textblock
11739 #: ../fish/guestfish-actions.pod:2355 ../src/guestfs-actions.pod:3627
11740 msgid "The operating system type could not be determined."
11741 msgstr ""
11742
11743 #. type: =head2
11744 #: ../fish/guestfish-actions.pod:2364
11745 msgid "inspect-get-windows-current-control-set"
11746 msgstr ""
11747
11748 #. type: verbatim
11749 #: ../fish/guestfish-actions.pod:2366
11750 #, no-wrap
11751 msgid ""
11752 " inspect-get-windows-current-control-set root\n"
11753 "\n"
11754 msgstr ""
11755
11756 #. type: textblock
11757 #: ../fish/guestfish-actions.pod:2368 ../src/guestfs-actions.pod:3647
11758 msgid ""
11759 "This returns the Windows CurrentControlSet of the inspected guest.  The "
11760 "CurrentControlSet is a registry key name such as C<ControlSet001>."
11761 msgstr ""
11762
11763 #. type: textblock
11764 #: ../fish/guestfish-actions.pod:2371 ../src/guestfs-actions.pod:3650
11765 msgid ""
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."
11768 msgstr ""
11769
11770 #. type: =head2
11771 #: ../fish/guestfish-actions.pod:2377
11772 msgid "inspect-get-windows-systemroot"
11773 msgstr "inspect-get-windows-systemroot"
11774
11775 #. type: verbatim
11776 #: ../fish/guestfish-actions.pod:2379
11777 #, no-wrap
11778 msgid ""
11779 " inspect-get-windows-systemroot root\n"
11780 "\n"
11781 msgstr ""
11782 " inspect-get-windows-systemroot корінь\n"
11783 "\n"
11784
11785 #. type: textblock
11786 #: ../fish/guestfish-actions.pod:2381 ../src/guestfs-actions.pod:3667
11787 msgid ""
11788 "This returns the Windows systemroot of the inspected guest.  The systemroot "
11789 "is a directory path such as C</WINDOWS>."
11790 msgstr ""
11791
11792 #. type: textblock
11793 #: ../fish/guestfish-actions.pod:2384 ../src/guestfs-actions.pod:3670
11794 msgid ""
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."
11797 msgstr ""
11798
11799 #. type: =head2
11800 #: ../fish/guestfish-actions.pod:2390
11801 msgid "inspect-is-live"
11802 msgstr "inspect-is-live"
11803
11804 #. type: verbatim
11805 #: ../fish/guestfish-actions.pod:2392
11806 #, no-wrap
11807 msgid ""
11808 " inspect-is-live root\n"
11809 "\n"
11810 msgstr ""
11811 " inspect-is-live корінь\n"
11812 "\n"
11813
11814 #. type: textblock
11815 #: ../fish/guestfish-actions.pod:2394
11816 msgid ""
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."
11819 msgstr ""
11820
11821 #. type: =head2
11822 #: ../fish/guestfish-actions.pod:2400
11823 msgid "inspect-is-multipart"
11824 msgstr "inspect-is-multipart"
11825
11826 #. type: verbatim
11827 #: ../fish/guestfish-actions.pod:2402
11828 #, no-wrap
11829 msgid ""
11830 " inspect-is-multipart root\n"
11831 "\n"
11832 msgstr ""
11833 " inspect-is-multipart корінь\n"
11834 "\n"
11835
11836 #. type: textblock
11837 #: ../fish/guestfish-actions.pod:2404
11838 msgid ""
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."
11841 msgstr ""
11842
11843 #. type: =head2
11844 #: ../fish/guestfish-actions.pod:2410
11845 msgid "inspect-is-netinst"
11846 msgstr "inspect-is-netinst"
11847
11848 #. type: verbatim
11849 #: ../fish/guestfish-actions.pod:2412
11850 #, no-wrap
11851 msgid ""
11852 " inspect-is-netinst root\n"
11853 "\n"
11854 msgstr ""
11855 " inspect-is-netinst корінь\n"
11856 "\n"
11857
11858 #. type: textblock
11859 #: ../fish/guestfish-actions.pod:2414
11860 msgid ""
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."
11865 msgstr ""
11866
11867 #. type: =head2
11868 #: ../fish/guestfish-actions.pod:2422
11869 msgid "inspect-list-applications"
11870 msgstr "inspect-list-applications"
11871
11872 #. type: verbatim
11873 #: ../fish/guestfish-actions.pod:2424
11874 #, no-wrap
11875 msgid ""
11876 " inspect-list-applications root\n"
11877 "\n"
11878 msgstr ""
11879 " inspect-list-applications кореневий_каталог\n"
11880 "\n"
11881
11882 #. type: textblock
11883 #: ../fish/guestfish-actions.pod:2426 ../src/guestfs-actions.pod:3737
11884 msgid "Return the list of applications installed in the operating system."
11885 msgstr ""
11886
11887 #. type: textblock
11888 #: ../fish/guestfish-actions.pod:2428
11889 msgid ""
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."
11897 msgstr ""
11898
11899 #. type: textblock
11900 #: ../fish/guestfish-actions.pod:2438 ../src/guestfs-actions.pod:3749
11901 msgid ""
11902 "This returns an empty list if the inspection code was not able to determine "
11903 "the list of applications."
11904 msgstr ""
11905
11906 #. type: textblock
11907 #: ../fish/guestfish-actions.pod:2441 ../src/guestfs-actions.pod:3752
11908 msgid "The application structure contains the following fields:"
11909 msgstr ""
11910
11911 #. type: =item
11912 #: ../fish/guestfish-actions.pod:2445 ../src/guestfs-actions.pod:3756
11913 msgid "C<app_name>"
11914 msgstr "C<app_name>"
11915
11916 #. type: textblock
11917 #: ../fish/guestfish-actions.pod:2447 ../src/guestfs-actions.pod:3758
11918 msgid ""
11919 "The name of the application.  For Red Hat-derived and Debian-derived Linux "
11920 "guests, this is the package name."
11921 msgstr ""
11922
11923 #. type: =item
11924 #: ../fish/guestfish-actions.pod:2450 ../src/guestfs-actions.pod:3761
11925 msgid "C<app_display_name>"
11926 msgstr "C<app_display_name>"
11927
11928 #. type: textblock
11929 #: ../fish/guestfish-actions.pod:2452 ../src/guestfs-actions.pod:3763
11930 msgid ""
11931 "The display name of the application, sometimes localized to the install "
11932 "language of the guest operating system."
11933 msgstr ""
11934
11935 #. type: textblock
11936 #: ../fish/guestfish-actions.pod:2455 ../src/guestfs-actions.pod:3766
11937 msgid ""
11938 "If unavailable this is returned as an empty string C<\"\">.  Callers needing "
11939 "to display something can use C<app_name> instead."
11940 msgstr ""
11941
11942 #. type: =item
11943 #: ../fish/guestfish-actions.pod:2458 ../src/guestfs-actions.pod:3769
11944 msgid "C<app_epoch>"
11945 msgstr "C<app_epoch>"
11946
11947 #. type: textblock
11948 #: ../fish/guestfish-actions.pod:2460 ../src/guestfs-actions.pod:3771
11949 msgid ""
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>."
11952 msgstr ""
11953
11954 #. type: =item
11955 #: ../fish/guestfish-actions.pod:2463 ../src/guestfs-actions.pod:3774
11956 msgid "C<app_version>"
11957 msgstr "C<app_version>"
11958
11959 #. type: textblock
11960 #: ../fish/guestfish-actions.pod:2465 ../src/guestfs-actions.pod:3776
11961 msgid ""
11962 "The version string of the application or package.  If unavailable this is "
11963 "returned as an empty string C<\"\">."
11964 msgstr ""
11965
11966 #. type: =item
11967 #: ../fish/guestfish-actions.pod:2468 ../src/guestfs-actions.pod:3779
11968 msgid "C<app_release>"
11969 msgstr "C<app_release>"
11970
11971 #. type: textblock
11972 #: ../fish/guestfish-actions.pod:2470 ../src/guestfs-actions.pod:3781
11973 msgid ""
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<\"\">."
11976 msgstr ""
11977
11978 #. type: =item
11979 #: ../fish/guestfish-actions.pod:2474 ../src/guestfs-actions.pod:3785
11980 msgid "C<app_install_path>"
11981 msgstr "C<app_install_path>"
11982
11983 #. type: textblock
11984 #: ../fish/guestfish-actions.pod:2476 ../src/guestfs-actions.pod:3787
11985 msgid ""
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."
11989 msgstr ""
11990
11991 #. type: textblock
11992 #: ../fish/guestfish-actions.pod:2481 ../src/guestfs-actions.pod:3792
11993 msgid "If unavailable this is returned as an empty string C<\"\">."
11994 msgstr ""
11995
11996 #. type: =item
11997 #: ../fish/guestfish-actions.pod:2483 ../src/guestfs-actions.pod:3794
11998 msgid "C<app_trans_path>"
11999 msgstr "C<app_trans_path>"
12000
12001 #. type: textblock
12002 #: ../fish/guestfish-actions.pod:2485 ../src/guestfs-actions.pod:3796
12003 msgid ""
12004 "The install path translated into a libguestfs path.  If unavailable this is "
12005 "returned as an empty string C<\"\">."
12006 msgstr ""
12007
12008 #. type: =item
12009 #: ../fish/guestfish-actions.pod:2488 ../src/guestfs-actions.pod:3799
12010 msgid "C<app_publisher>"
12011 msgstr "C<app_publisher>"
12012
12013 #. type: textblock
12014 #: ../fish/guestfish-actions.pod:2490 ../src/guestfs-actions.pod:3801
12015 msgid ""
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<\"\">."
12018 msgstr ""
12019
12020 #. type: =item
12021 #: ../fish/guestfish-actions.pod:2494 ../src/guestfs-actions.pod:3805
12022 msgid "C<app_url>"
12023 msgstr "C<app_url>"
12024
12025 #. type: textblock
12026 #: ../fish/guestfish-actions.pod:2496 ../src/guestfs-actions.pod:3807
12027 msgid ""
12028 "The URL (eg. upstream URL) of the application.  If unavailable this is "
12029 "returned as an empty string C<\"\">."
12030 msgstr ""
12031
12032 #. type: =item
12033 #: ../fish/guestfish-actions.pod:2499 ../src/guestfs-actions.pod:3810
12034 msgid "C<app_source_package>"
12035 msgstr "C<app_source_package>"
12036
12037 #. type: textblock
12038 #: ../fish/guestfish-actions.pod:2501 ../src/guestfs-actions.pod:3812
12039 msgid ""
12040 "For packaging systems which support this, the name of the source package.  "
12041 "If unavailable this is returned as an empty string C<\"\">."
12042 msgstr ""
12043
12044 #. type: =item
12045 #: ../fish/guestfish-actions.pod:2504 ../src/guestfs-actions.pod:3815
12046 msgid "C<app_summary>"
12047 msgstr "C<app_summary>"
12048
12049 #. type: textblock
12050 #: ../fish/guestfish-actions.pod:2506 ../src/guestfs-actions.pod:3817
12051 msgid ""
12052 "A short (usually one line) description of the application or package.  If "
12053 "unavailable this is returned as an empty string C<\"\">."
12054 msgstr ""
12055
12056 #. type: =item
12057 #: ../fish/guestfish-actions.pod:2509 ../src/guestfs-actions.pod:3820
12058 msgid "C<app_description>"
12059 msgstr "C<app_description>"
12060
12061 #. type: textblock
12062 #: ../fish/guestfish-actions.pod:2511 ../src/guestfs-actions.pod:3822
12063 msgid ""
12064 "A longer description of the application or package.  If unavailable this is "
12065 "returned as an empty string C<\"\">."
12066 msgstr ""
12067
12068 #. type: =head2
12069 #: ../fish/guestfish-actions.pod:2518
12070 msgid "inspect-os"
12071 msgstr "inspect-os"
12072
12073 #. type: verbatim
12074 #: ../fish/guestfish-actions.pod:2520
12075 #, no-wrap
12076 msgid ""
12077 " inspect-os\n"
12078 "\n"
12079 msgstr ""
12080 " inspect-os\n"
12081 "\n"
12082
12083 #. type: textblock
12084 #: ../fish/guestfish-actions.pod:2522 ../src/guestfs-actions.pod:3840
12085 msgid ""
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."
12089 msgstr ""
12090
12091 #. type: textblock
12092 #: ../fish/guestfish-actions.pod:2526 ../src/guestfs-actions.pod:3844
12093 msgid "The list returned is empty if no operating systems were found."
12094 msgstr ""
12095
12096 #. type: textblock
12097 #: ../fish/guestfish-actions.pod:2528 ../src/guestfs-actions.pod:3846
12098 msgid ""
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."
12104 msgstr ""
12105
12106 #. type: textblock
12107 #: ../fish/guestfish-actions.pod:2535
12108 msgid ""
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."
12112 msgstr ""
12113
12114 #. type: textblock
12115 #: ../fish/guestfish-actions.pod:2540
12116 msgid ""
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."
12121 msgstr ""
12122
12123 #. type: textblock
12124 #: ../fish/guestfish-actions.pod:2546 ../src/guestfs-actions.pod:3864
12125 msgid ""
12126 "This function cannot decrypt encrypted disks.  The caller must do that first "
12127 "(supplying the necessary keys) if the disk is encrypted."
12128 msgstr ""
12129
12130 #. type: textblock
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>."
12135
12136 #. type: =head2
12137 #: ../fish/guestfish-actions.pod:2554
12138 msgid "is-blockdev"
12139 msgstr "is-blockdev"
12140
12141 #. type: verbatim
12142 #: ../fish/guestfish-actions.pod:2556
12143 #, no-wrap
12144 msgid ""
12145 " is-blockdev path\n"
12146 "\n"
12147 msgstr ""
12148 " is-blockdev шлях\n"
12149 "\n"
12150
12151 #. type: textblock
12152 #: ../fish/guestfish-actions.pod:2558 ../src/guestfs-actions.pod:3884
12153 msgid ""
12154 "This returns C<true> if and only if there is a block device with the given "
12155 "C<path> name."
12156 msgstr ""
12157
12158 #. type: textblock
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>."
12165
12166 #. type: =head2
12167 #: ../fish/guestfish-actions.pod:2563
12168 msgid "is-busy"
12169 msgstr "is-busy"
12170
12171 #. type: verbatim
12172 #: ../fish/guestfish-actions.pod:2565
12173 #, no-wrap
12174 msgid ""
12175 " is-busy\n"
12176 "\n"
12177 msgstr ""
12178 " is-busy\n"
12179 "\n"
12180
12181 #. type: textblock
12182 #: ../fish/guestfish-actions.pod:2567 ../src/guestfs-actions.pod:3898
12183 msgid ""
12184 "This returns true iff this handle is busy processing a command (in the "
12185 "C<BUSY> state)."
12186 msgstr ""
12187
12188 #. type: =head2
12189 #: ../fish/guestfish-actions.pod:2572
12190 msgid "is-chardev"
12191 msgstr "is-chardev"
12192
12193 #. type: verbatim
12194 #: ../fish/guestfish-actions.pod:2574
12195 #, no-wrap
12196 msgid ""
12197 " is-chardev path\n"
12198 "\n"
12199 msgstr ""
12200 " is-chardev шлях\n"
12201 "\n"
12202
12203 #. type: textblock
12204 #: ../fish/guestfish-actions.pod:2576 ../src/guestfs-actions.pod:3913
12205 msgid ""
12206 "This returns C<true> if and only if there is a character device with the "
12207 "given C<path> name."
12208 msgstr ""
12209
12210 #. type: =head2
12211 #: ../fish/guestfish-actions.pod:2581
12212 msgid "is-config"
12213 msgstr "is-config"
12214
12215 #. type: verbatim
12216 #: ../fish/guestfish-actions.pod:2583
12217 #, no-wrap
12218 msgid ""
12219 " is-config\n"
12220 "\n"
12221 msgstr ""
12222 " is-config\n"
12223 "\n"
12224
12225 #. type: textblock
12226 #: ../fish/guestfish-actions.pod:2585 ../src/guestfs-actions.pod:3927
12227 msgid ""
12228 "This returns true iff this handle is being configured (in the C<CONFIG> "
12229 "state)."
12230 msgstr ""
12231
12232 #. type: =head2
12233 #: ../fish/guestfish-actions.pod:2590
12234 msgid "is-dir"
12235 msgstr "is-dir"
12236
12237 #. type: verbatim
12238 #: ../fish/guestfish-actions.pod:2592
12239 #, no-wrap
12240 msgid ""
12241 " is-dir path\n"
12242 "\n"
12243 msgstr ""
12244 " is-dir шлях\n"
12245 "\n"
12246
12247 #. type: textblock
12248 #: ../fish/guestfish-actions.pod:2594 ../src/guestfs-actions.pod:3942
12249 msgid ""
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."
12252 msgstr ""
12253
12254 #. type: =head2
12255 #: ../fish/guestfish-actions.pod:2600
12256 msgid "is-fifo"
12257 msgstr "is-fifo"
12258
12259 #. type: verbatim
12260 #: ../fish/guestfish-actions.pod:2602
12261 #, no-wrap
12262 msgid ""
12263 " is-fifo path\n"
12264 "\n"
12265 msgstr ""
12266 " is-fifo шлях\n"
12267 "\n"
12268
12269 #. type: textblock
12270 #: ../fish/guestfish-actions.pod:2604 ../src/guestfs-actions.pod:3958
12271 msgid ""
12272 "This returns C<true> if and only if there is a FIFO (named pipe)  with the "
12273 "given C<path> name."
12274 msgstr ""
12275
12276 #. type: =head2
12277 #: ../fish/guestfish-actions.pod:2609
12278 msgid "is-file"
12279 msgstr "is-file"
12280
12281 #. type: verbatim
12282 #: ../fish/guestfish-actions.pod:2611
12283 #, no-wrap
12284 msgid ""
12285 " is-file path\n"
12286 "\n"
12287 msgstr ""
12288 " is-file шлях\n"
12289 "\n"
12290
12291 #. type: textblock
12292 #: ../fish/guestfish-actions.pod:2613 ../src/guestfs-actions.pod:3973
12293 msgid ""
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."
12296 msgstr ""
12297
12298 #. type: =head2
12299 #: ../fish/guestfish-actions.pod:2619
12300 msgid "is-launching"
12301 msgstr "is-launching"
12302
12303 #. type: verbatim
12304 #: ../fish/guestfish-actions.pod:2621
12305 #, no-wrap
12306 msgid ""
12307 " is-launching\n"
12308 "\n"
12309 msgstr ""
12310 " is-launching\n"
12311 "\n"
12312
12313 #. type: textblock
12314 #: ../fish/guestfish-actions.pod:2623 ../src/guestfs-actions.pod:3988
12315 msgid ""
12316 "This returns true iff this handle is launching the subprocess (in the "
12317 "C<LAUNCHING> state)."
12318 msgstr ""
12319
12320 #. type: =head2
12321 #: ../fish/guestfish-actions.pod:2628
12322 msgid "is-lv"
12323 msgstr "is-lv"
12324
12325 #. type: verbatim
12326 #: ../fish/guestfish-actions.pod:2630
12327 #, no-wrap
12328 msgid ""
12329 " is-lv device\n"
12330 "\n"
12331 msgstr ""
12332 " is-lv пристрій\n"
12333 "\n"
12334
12335 #. type: textblock
12336 #: ../fish/guestfish-actions.pod:2632 ../src/guestfs-actions.pod:4003
12337 msgid ""
12338 "This command tests whether C<device> is a logical volume, and returns true "
12339 "iff this is the case."
12340 msgstr ""
12341
12342 #. type: =head2
12343 #: ../fish/guestfish-actions.pod:2635
12344 msgid "is-ready"
12345 msgstr "is-ready"
12346
12347 #. type: verbatim
12348 #: ../fish/guestfish-actions.pod:2637
12349 #, no-wrap
12350 msgid ""
12351 " is-ready\n"
12352 "\n"
12353 msgstr ""
12354 " is-ready\n"
12355 "\n"
12356
12357 #. type: textblock
12358 #: ../fish/guestfish-actions.pod:2639 ../src/guestfs-actions.pod:4015
12359 msgid ""
12360 "This returns true iff this handle is ready to accept commands (in the "
12361 "C<READY> state)."
12362 msgstr ""
12363
12364 #. type: =head2
12365 #: ../fish/guestfish-actions.pod:2644
12366 msgid "is-socket"
12367 msgstr "is-socket"
12368
12369 #. type: verbatim
12370 #: ../fish/guestfish-actions.pod:2646
12371 #, no-wrap
12372 msgid ""
12373 " is-socket path\n"
12374 "\n"
12375 msgstr ""
12376 " is-socket шлях\n"
12377 "\n"
12378
12379 #. type: textblock
12380 #: ../fish/guestfish-actions.pod:2648 ../src/guestfs-actions.pod:4030
12381 msgid ""
12382 "This returns C<true> if and only if there is a Unix domain socket with the "
12383 "given C<path> name."
12384 msgstr ""
12385
12386 #. type: =head2
12387 #: ../fish/guestfish-actions.pod:2653
12388 msgid "is-symlink"
12389 msgstr "is-symlink"
12390
12391 #. type: verbatim
12392 #: ../fish/guestfish-actions.pod:2655
12393 #, no-wrap
12394 msgid ""
12395 " is-symlink path\n"
12396 "\n"
12397 msgstr ""
12398 " is-symlink шлях\n"
12399 "\n"
12400
12401 #. type: textblock
12402 #: ../fish/guestfish-actions.pod:2657 ../src/guestfs-actions.pod:4045
12403 msgid ""
12404 "This returns C<true> if and only if there is a symbolic link with the given "
12405 "C<path> name."
12406 msgstr ""
12407
12408 #. type: =head2
12409 #: ../fish/guestfish-actions.pod:2662
12410 msgid "is-zero"
12411 msgstr ""
12412
12413 #. type: verbatim
12414 #: ../fish/guestfish-actions.pod:2664
12415 #, no-wrap
12416 msgid ""
12417 " is-zero path\n"
12418 "\n"
12419 msgstr ""
12420
12421 #. type: textblock
12422 #: ../fish/guestfish-actions.pod:2666 ../src/guestfs-actions.pod:4060
12423 msgid ""
12424 "This returns true iff the file exists and the file is empty or it contains "
12425 "all zero bytes."
12426 msgstr ""
12427
12428 #. type: =head2
12429 #: ../fish/guestfish-actions.pod:2669
12430 msgid "is-zero-device"
12431 msgstr ""
12432
12433 #. type: verbatim
12434 #: ../fish/guestfish-actions.pod:2671
12435 #, no-wrap
12436 msgid ""
12437 " is-zero-device device\n"
12438 "\n"
12439 msgstr ""
12440
12441 #. type: textblock
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."
12444 msgstr ""
12445
12446 #. type: textblock
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."
12449 msgstr ""
12450
12451 #. type: =head2
12452 #: ../fish/guestfish-actions.pod:2677
12453 msgid "kill-subprocess"
12454 msgstr "kill-subprocess"
12455
12456 #. type: verbatim
12457 #: ../fish/guestfish-actions.pod:2679
12458 #, no-wrap
12459 msgid ""
12460 " kill-subprocess\n"
12461 "\n"
12462 msgstr ""
12463 " kill-subprocess\n"
12464 "\n"
12465
12466 #. type: textblock
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."
12469 msgstr ""
12470
12471 #. type: =head2
12472 #: ../fish/guestfish-actions.pod:2683
12473 msgid "launch"
12474 msgstr "launch"
12475
12476 #. type: =head2
12477 #: ../fish/guestfish-actions.pod:2685
12478 msgid "run"
12479 msgstr ""
12480
12481 #. type: verbatim
12482 #: ../fish/guestfish-actions.pod:2687
12483 #, no-wrap
12484 msgid ""
12485 " launch\n"
12486 "\n"
12487 msgstr ""
12488 " launch\n"
12489 "\n"
12490
12491 #. type: textblock
12492 #: ../fish/guestfish-actions.pod:2689 ../src/guestfs-actions.pod:4097
12493 msgid ""
12494 "Internally libguestfs is implemented by running a virtual machine using "
12495 "L<qemu(1)>."
12496 msgstr ""
12497
12498 #. type: textblock
12499 #: ../fish/guestfish-actions.pod:2692 ../src/guestfs-actions.pod:4100
12500 msgid ""
12501 "You should call this after configuring the handle (eg. adding drives) but "
12502 "before performing any actions."
12503 msgstr ""
12504
12505 #. type: =head2
12506 #: ../fish/guestfish-actions.pod:2695
12507 msgid "lchown"
12508 msgstr "lchown"
12509
12510 #. type: verbatim
12511 #: ../fish/guestfish-actions.pod:2697
12512 #, no-wrap
12513 msgid ""
12514 " lchown owner group path\n"
12515 "\n"
12516 msgstr ""
12517 " lchown власник група шлях\n"
12518 "\n"
12519
12520 #. type: textblock
12521 #: ../fish/guestfish-actions.pod:2699
12522 msgid ""
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 "
12525 "target."
12526 msgstr ""
12527
12528 #. type: =head2
12529 #: ../fish/guestfish-actions.pod:2707
12530 msgid "lgetxattr"
12531 msgstr "lgetxattr"
12532
12533 #. type: verbatim
12534 #: ../fish/guestfish-actions.pod:2709
12535 #, no-wrap
12536 msgid ""
12537 " lgetxattr path name\n"
12538 "\n"
12539 msgstr ""
12540 " lgetxattr шлях назва\n"
12541 "\n"
12542
12543 #. type: textblock
12544 #: ../fish/guestfish-actions.pod:2711 ../src/guestfs-actions.pod:4140
12545 msgid ""
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."
12548 msgstr ""
12549
12550 #. type: textblock
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)>."
12554
12555 #. type: =head2
12556 #: ../fish/guestfish-actions.pod:2727
12557 msgid "lgetxattrs"
12558 msgstr "lgetxattrs"
12559
12560 #. type: verbatim
12561 #: ../fish/guestfish-actions.pod:2729
12562 #, no-wrap
12563 msgid ""
12564 " lgetxattrs path\n"
12565 "\n"
12566 msgstr ""
12567 " lgetxattrs шлях\n"
12568 "\n"
12569
12570 #. type: textblock
12571 #: ../fish/guestfish-actions.pod:2731
12572 msgid ""
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."
12575 msgstr ""
12576
12577 #. type: =head2
12578 #: ../fish/guestfish-actions.pod:2735
12579 msgid "list-9p"
12580 msgstr ""
12581
12582 #. type: verbatim
12583 #: ../fish/guestfish-actions.pod:2737
12584 #, no-wrap
12585 msgid ""
12586 " list-9p\n"
12587 "\n"
12588 msgstr ""
12589
12590 #. type: textblock
12591 #: ../fish/guestfish-actions.pod:2739 ../src/guestfs-actions.pod:4183
12592 msgid ""
12593 "List all 9p filesystems attached to the guest.  A list of mount tags is "
12594 "returned."
12595 msgstr ""
12596
12597 #. type: =head2
12598 #: ../fish/guestfish-actions.pod:2742
12599 msgid "list-devices"
12600 msgstr "list-devices"
12601
12602 #. type: verbatim
12603 #: ../fish/guestfish-actions.pod:2744
12604 #, no-wrap
12605 msgid ""
12606 " list-devices\n"
12607 "\n"
12608 msgstr ""
12609 " list-devices\n"
12610 "\n"
12611
12612 #. type: textblock
12613 #: ../fish/guestfish-actions.pod:2746 ../src/guestfs-actions.pod:4197
12614 msgid "List all the block devices."
12615 msgstr ""
12616
12617 #. type: textblock
12618 #: ../fish/guestfish-actions.pod:2748 ../src/guestfs-actions.pod:4199
12619 msgid "The full block device names are returned, eg. C</dev/sda>."
12620 msgstr ""
12621
12622 #. type: =head2
12623 #: ../fish/guestfish-actions.pod:2752
12624 msgid "list-dm-devices"
12625 msgstr ""
12626
12627 #. type: verbatim
12628 #: ../fish/guestfish-actions.pod:2754
12629 #, no-wrap
12630 msgid ""
12631 " list-dm-devices\n"
12632 "\n"
12633 msgstr ""
12634
12635 #. type: textblock
12636 #: ../fish/guestfish-actions.pod:2756 ../src/guestfs-actions.pod:4214
12637 msgid "List all device mapper devices."
12638 msgstr ""
12639
12640 #. type: textblock
12641 #: ../fish/guestfish-actions.pod:2758
12642 msgid ""
12643 "The returned list contains C</dev/mapper/*> devices, eg. ones created by a "
12644 "previous call to L</luks-open>."
12645 msgstr ""
12646
12647 #. type: textblock
12648 #: ../fish/guestfish-actions.pod:2761
12649 msgid ""
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."
12652 msgstr ""
12653
12654 #. type: =head2
12655 #: ../fish/guestfish-actions.pod:2765
12656 msgid "list-filesystems"
12657 msgstr "list-filesystems"
12658
12659 #. type: verbatim
12660 #: ../fish/guestfish-actions.pod:2767
12661 #, no-wrap
12662 msgid ""
12663 " list-filesystems\n"
12664 "\n"
12665 msgstr ""
12666 " list-filesystems\n"
12667 "\n"
12668
12669 #. type: textblock
12670 #: ../fish/guestfish-actions.pod:2769 ../src/guestfs-actions.pod:4234
12671 msgid ""
12672 "This inspection command looks for filesystems on partitions, block devices "
12673 "and logical volumes, returning a list of devices containing filesystems and "
12674 "their type."
12675 msgstr ""
12676
12677 #. type: textblock
12678 #: ../fish/guestfish-actions.pod:2773 ../src/guestfs-actions.pod:4238
12679 msgid ""
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:"
12682 msgstr ""
12683
12684 #. type: verbatim
12685 #: ../fish/guestfish-actions.pod:2777 ../src/guestfs-actions.pod:4242
12686 #, no-wrap
12687 msgid ""
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"
12692 "\n"
12693 msgstr ""
12694
12695 #. type: textblock
12696 #: ../fish/guestfish-actions.pod:2782 ../src/guestfs-actions.pod:4247
12697 msgid ""
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."
12700 msgstr ""
12701
12702 #. type: textblock
12703 #: ../fish/guestfish-actions.pod:2786
12704 msgid ""
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."
12708 msgstr ""
12709
12710 #. type: textblock
12711 #: ../fish/guestfish-actions.pod:2790
12712 msgid ""
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)."
12718 msgstr ""
12719
12720 #. type: =head2
12721 #: ../fish/guestfish-actions.pod:2798
12722 #, fuzzy
12723 #| msgid "list-devices"
12724 msgid "list-md-devices"
12725 msgstr "list-devices"
12726
12727 #. type: verbatim
12728 #: ../fish/guestfish-actions.pod:2800
12729 #, fuzzy, no-wrap
12730 #| msgid ""
12731 #| " list-devices\n"
12732 #| "\n"
12733 msgid ""
12734 " list-md-devices\n"
12735 "\n"
12736 msgstr ""
12737 " list-devices\n"
12738 "\n"
12739
12740 #. type: textblock
12741 #: ../fish/guestfish-actions.pod:2802 ../src/guestfs-actions.pod:4276
12742 msgid "List all Linux md devices."
12743 msgstr ""
12744
12745 #. type: =head2
12746 #: ../fish/guestfish-actions.pod:2804
12747 msgid "list-partitions"
12748 msgstr "list-partitions"
12749
12750 #. type: verbatim
12751 #: ../fish/guestfish-actions.pod:2806
12752 #, no-wrap
12753 msgid ""
12754 " list-partitions\n"
12755 "\n"
12756 msgstr ""
12757 " list-partitions\n"
12758 "\n"
12759
12760 #. type: textblock
12761 #: ../fish/guestfish-actions.pod:2808 ../src/guestfs-actions.pod:4287
12762 msgid "List all the partitions detected on all block devices."
12763 msgstr ""
12764
12765 #. type: textblock
12766 #: ../fish/guestfish-actions.pod:2810 ../src/guestfs-actions.pod:4289
12767 msgid "The full partition device names are returned, eg. C</dev/sda1>"
12768 msgstr ""
12769
12770 #. type: textblock
12771 #: ../fish/guestfish-actions.pod:2812
12772 msgid ""
12773 "This does not return logical volumes.  For that you will need to call L</"
12774 "lvs>."
12775 msgstr ""
12776
12777 #. type: =head2
12778 #: ../fish/guestfish-actions.pod:2817
12779 msgid "ll"
12780 msgstr "ll"
12781
12782 #. type: verbatim
12783 #: ../fish/guestfish-actions.pod:2819
12784 #, no-wrap
12785 msgid ""
12786 " ll directory\n"
12787 "\n"
12788 msgstr ""
12789 " ll каталог\n"
12790 "\n"
12791
12792 #. type: textblock
12793 #: ../fish/guestfish-actions.pod:2821 ../src/guestfs-actions.pod:4308
12794 msgid ""
12795 "List the files in C<directory> (relative to the root directory, there is no "
12796 "cwd) in the format of 'ls -la'."
12797 msgstr ""
12798
12799 #. type: textblock
12800 #: ../fish/guestfish-actions.pod:2824 ../src/guestfs-actions.pod:4311
12801 msgid ""
12802 "This command is mostly useful for interactive sessions.  It is I<not> "
12803 "intended that you try to parse the output string."
12804 msgstr ""
12805
12806 #. type: =head2
12807 #: ../fish/guestfish-actions.pod:2827
12808 msgid "ln"
12809 msgstr "ln"
12810
12811 #. type: verbatim
12812 #: ../fish/guestfish-actions.pod:2829
12813 #, no-wrap
12814 msgid ""
12815 " ln target linkname\n"
12816 "\n"
12817 msgstr ""
12818 " ln призначення назва_посилання\n"
12819 "\n"
12820
12821 #. type: textblock
12822 #: ../fish/guestfish-actions.pod:2831 ../src/guestfs-actions.pod:4326
12823 msgid "This command creates a hard link using the C<ln> command."
12824 msgstr ""
12825
12826 #. type: =head2
12827 #: ../fish/guestfish-actions.pod:2833
12828 msgid "ln-f"
12829 msgstr "ln-f"
12830
12831 #. type: verbatim
12832 #: ../fish/guestfish-actions.pod:2835
12833 #, no-wrap
12834 msgid ""
12835 " ln-f target linkname\n"
12836 "\n"
12837 msgstr ""
12838 " ln-f призначення назва_посилання\n"
12839 "\n"
12840
12841 #. type: textblock
12842 #: ../fish/guestfish-actions.pod:2837 ../src/guestfs-actions.pod:4339
12843 msgid ""
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."
12846 msgstr ""
12847
12848 #. type: =head2
12849 #: ../fish/guestfish-actions.pod:2840
12850 msgid "ln-s"
12851 msgstr "ln-s"
12852
12853 #. type: verbatim
12854 #: ../fish/guestfish-actions.pod:2842
12855 #, no-wrap
12856 msgid ""
12857 " ln-s target linkname\n"
12858 "\n"
12859 msgstr ""
12860 " ln-s призначення назва_посилання\n"
12861 "\n"
12862
12863 #. type: textblock
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."
12866 msgstr ""
12867
12868 #. type: =head2
12869 #: ../fish/guestfish-actions.pod:2846
12870 msgid "ln-sf"
12871 msgstr "ln-sf"
12872
12873 #. type: verbatim
12874 #: ../fish/guestfish-actions.pod:2848
12875 #, no-wrap
12876 msgid ""
12877 " ln-sf target linkname\n"
12878 "\n"
12879 msgstr ""
12880 " ln-sf призначення назва_посилання\n"
12881 "\n"
12882
12883 #. type: textblock
12884 #: ../fish/guestfish-actions.pod:2850 ../src/guestfs-actions.pod:4366
12885 msgid ""
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."
12888 msgstr ""
12889
12890 #. type: =head2
12891 #: ../fish/guestfish-actions.pod:2853
12892 msgid "lremovexattr"
12893 msgstr "lremovexattr"
12894
12895 #. type: verbatim
12896 #: ../fish/guestfish-actions.pod:2855
12897 #, no-wrap
12898 msgid ""
12899 " lremovexattr xattr path\n"
12900 "\n"
12901 msgstr ""
12902
12903 #. type: textblock
12904 #: ../fish/guestfish-actions.pod:2857
12905 msgid ""
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."
12908 msgstr ""
12909
12910 #. type: =head2
12911 #: ../fish/guestfish-actions.pod:2861
12912 msgid "ls"
12913 msgstr "ls"
12914
12915 #. type: verbatim
12916 #: ../fish/guestfish-actions.pod:2863
12917 #, no-wrap
12918 msgid ""
12919 " ls directory\n"
12920 "\n"
12921 msgstr ""
12922 " ls каталог\n"
12923 "\n"
12924
12925 #. type: textblock
12926 #: ../fish/guestfish-actions.pod:2865 ../src/guestfs-actions.pod:4394
12927 msgid ""
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."
12930 msgstr ""
12931
12932 #. type: textblock
12933 #: ../fish/guestfish-actions.pod:2869
12934 msgid ""
12935 "This command is mostly useful for interactive sessions.  Programs should "
12936 "probably use L</readdir> instead."
12937 msgstr ""
12938
12939 #. type: =head2
12940 #: ../fish/guestfish-actions.pod:2872
12941 msgid "lsetxattr"
12942 msgstr "lsetxattr"
12943
12944 #. type: verbatim
12945 #: ../fish/guestfish-actions.pod:2874
12946 #, no-wrap
12947 msgid ""
12948 " lsetxattr xattr val vallen path\n"
12949 "\n"
12950 msgstr ""
12951
12952 #. type: textblock
12953 #: ../fish/guestfish-actions.pod:2876
12954 msgid ""
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."
12957 msgstr ""
12958
12959 #. type: =head2
12960 #: ../fish/guestfish-actions.pod:2880
12961 msgid "lstat"
12962 msgstr "lstat"
12963
12964 #. type: verbatim
12965 #: ../fish/guestfish-actions.pod:2882
12966 #, no-wrap
12967 msgid ""
12968 " lstat path\n"
12969 "\n"
12970 msgstr ""
12971 " lstat шлях\n"
12972 "\n"
12973
12974 #. type: textblock
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>."
12978 msgstr ""
12979
12980 #. type: textblock
12981 #: ../fish/guestfish-actions.pod:2886
12982 msgid ""
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."
12985 msgstr ""
12986
12987 #. type: textblock
12988 #: ../fish/guestfish-actions.pod:2890 ../src/guestfs-actions.pod:4436
12989 msgid "This is the same as the C<lstat(2)> system call."
12990 msgstr ""
12991
12992 #. type: =head2
12993 #: ../fish/guestfish-actions.pod:2892
12994 msgid "lstatlist"
12995 msgstr "lstatlist"
12996
12997 #. type: verbatim
12998 #: ../fish/guestfish-actions.pod:2894
12999 #, no-wrap
13000 msgid ""
13001 " lstatlist path 'names ...'\n"
13002 "\n"
13003 msgstr ""
13004
13005 #. type: textblock
13006 #: ../fish/guestfish-actions.pod:2896
13007 msgid ""
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."
13011 msgstr ""
13012
13013 #. type: textblock
13014 #: ../fish/guestfish-actions.pod:2900 ../src/guestfs-actions.pod:4455
13015 msgid ""
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>."
13019 msgstr ""
13020
13021 #. type: textblock
13022 #: ../fish/guestfish-actions.pod:2905
13023 msgid ""
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."
13030 msgstr ""
13031
13032 #. type: =head2
13033 #: ../fish/guestfish-actions.pod:2913
13034 msgid "luks-add-key"
13035 msgstr "luks-add-key"
13036
13037 #. type: verbatim
13038 #: ../fish/guestfish-actions.pod:2915
13039 #, no-wrap
13040 msgid ""
13041 " luks-add-key device keyslot\n"
13042 "\n"
13043 msgstr ""
13044
13045 #. type: textblock
13046 #: ../fish/guestfish-actions.pod:2917 ../src/guestfs-actions.pod:4483
13047 msgid ""
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."
13051 msgstr ""
13052
13053 #. type: textblock
13054 #: ../fish/guestfish-actions.pod:2922
13055 msgid ""
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."
13058 msgstr ""
13059
13060 #. type: textblock
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
13064 msgid ""
13065 "This command has one or more key or passphrase parameters.  Guestfish will "
13066 "prompt for these separately."
13067 msgstr ""
13068
13069 #. type: =head2
13070 #: ../fish/guestfish-actions.pod:2929
13071 msgid "luks-close"
13072 msgstr "luks-close"
13073
13074 #. type: verbatim
13075 #: ../fish/guestfish-actions.pod:2931
13076 #, no-wrap
13077 msgid ""
13078 " luks-close device\n"
13079 "\n"
13080 msgstr ""
13081 " luks-close пристрій\n"
13082 "\n"
13083
13084 #. type: textblock
13085 #: ../fish/guestfish-actions.pod:2933
13086 msgid ""
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 "
13090 "block device."
13091 msgstr ""
13092
13093 #. type: =head2
13094 #: ../fish/guestfish-actions.pod:2939
13095 msgid "luks-format"
13096 msgstr "luks-format"
13097
13098 #. type: verbatim
13099 #: ../fish/guestfish-actions.pod:2941
13100 #, no-wrap
13101 msgid ""
13102 " luks-format device keyslot\n"
13103 "\n"
13104 msgstr ""
13105
13106 #. type: textblock
13107 #: ../fish/guestfish-actions.pod:2943 ../src/guestfs-actions.pod:4524
13108 msgid ""
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)."
13112 msgstr ""
13113
13114 #. type: =head2
13115 #: ../fish/guestfish-actions.pod:2951
13116 msgid "luks-format-cipher"
13117 msgstr "luks-format-cipher"
13118
13119 #. type: verbatim
13120 #: ../fish/guestfish-actions.pod:2953
13121 #, no-wrap
13122 msgid ""
13123 " luks-format-cipher device keyslot cipher\n"
13124 "\n"
13125 msgstr ""
13126
13127 #. type: textblock
13128 #: ../fish/guestfish-actions.pod:2955
13129 msgid ""
13130 "This command is the same as L</luks-format> but it also allows you to set "
13131 "the C<cipher> used."
13132 msgstr ""
13133
13134 #. type: =head2
13135 #: ../fish/guestfish-actions.pod:2961
13136 msgid "luks-kill-slot"
13137 msgstr "luks-kill-slot"
13138
13139 #. type: verbatim
13140 #: ../fish/guestfish-actions.pod:2963
13141 #, no-wrap
13142 msgid ""
13143 " luks-kill-slot device keyslot\n"
13144 "\n"
13145 msgstr ""
13146
13147 #. type: textblock
13148 #: ../fish/guestfish-actions.pod:2965 ../src/guestfs-actions.pod:4565
13149 msgid ""
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."
13152 msgstr ""
13153
13154 #. type: =head2
13155 #: ../fish/guestfish-actions.pod:2972
13156 msgid "luks-open"
13157 msgstr "luks-open"
13158
13159 #. type: verbatim
13160 #: ../fish/guestfish-actions.pod:2974
13161 #, no-wrap
13162 msgid ""
13163 " luks-open device mapname\n"
13164 "\n"
13165 msgstr ""
13166
13167 #. type: textblock
13168 #: ../fish/guestfish-actions.pod:2976 ../src/guestfs-actions.pod:4585
13169 msgid ""
13170 "This command opens a block device which has been encrypted according to the "
13171 "Linux Unified Key Setup (LUKS) standard."
13172 msgstr ""
13173
13174 #. type: textblock
13175 #: ../fish/guestfish-actions.pod:2979 ../src/guestfs-actions.pod:4588
13176 msgid "C<device> is the encrypted block device or partition."
13177 msgstr ""
13178
13179 #. type: textblock
13180 #: ../fish/guestfish-actions.pod:2981 ../src/guestfs-actions.pod:4590
13181 msgid ""
13182 "The caller must supply one of the keys associated with the LUKS block "
13183 "device, in the C<key> parameter."
13184 msgstr ""
13185
13186 #. type: textblock
13187 #: ../fish/guestfish-actions.pod:2984 ../src/guestfs-actions.pod:4593
13188 msgid ""
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."
13192 msgstr ""
13193
13194 #. type: textblock
13195 #: ../fish/guestfish-actions.pod:2988
13196 msgid ""
13197 "If this block device contains LVM volume groups, then calling L</vgscan> "
13198 "followed by L</vg-activate-all> will make them visible."
13199 msgstr ""
13200
13201 #. type: textblock
13202 #: ../fish/guestfish-actions.pod:2992
13203 msgid "Use L</list-dm-devices> to list all device mapper devices."
13204 msgstr ""
13205
13206 #. type: =head2
13207 #: ../fish/guestfish-actions.pod:2998
13208 msgid "luks-open-ro"
13209 msgstr "luks-open-ro"
13210
13211 #. type: verbatim
13212 #: ../fish/guestfish-actions.pod:3000
13213 #, no-wrap
13214 msgid ""
13215 " luks-open-ro device mapname\n"
13216 "\n"
13217 msgstr ""
13218
13219 #. type: textblock
13220 #: ../fish/guestfish-actions.pod:3002
13221 msgid ""
13222 "This is the same as L</luks-open> except that a read-only mapping is created."
13223 msgstr ""
13224
13225 #. type: =head2
13226 #: ../fish/guestfish-actions.pod:3008
13227 msgid "lvcreate"
13228 msgstr "lvcreate"
13229
13230 #. type: verbatim
13231 #: ../fish/guestfish-actions.pod:3010
13232 #, no-wrap
13233 msgid ""
13234 " lvcreate logvol volgroup mbytes\n"
13235 "\n"
13236 msgstr ""
13237
13238 #. type: textblock
13239 #: ../fish/guestfish-actions.pod:3012 ../src/guestfs-actions.pod:4639
13240 msgid ""
13241 "This creates an LVM logical volume called C<logvol> on the volume group "
13242 "C<volgroup>, with C<size> megabytes."
13243 msgstr ""
13244
13245 #. type: =head2
13246 #: ../fish/guestfish-actions.pod:3015
13247 msgid "lvm-canonical-lv-name"
13248 msgstr "lvm-canonical-lv-name"
13249
13250 #. type: verbatim
13251 #: ../fish/guestfish-actions.pod:3017
13252 #, no-wrap
13253 msgid ""
13254 " lvm-canonical-lv-name lvname\n"
13255 "\n"
13256 msgstr ""
13257
13258 #. type: textblock
13259 #: ../fish/guestfish-actions.pod:3019 ../src/guestfs-actions.pod:4652
13260 msgid ""
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/"
13263 "LV>."
13264 msgstr ""
13265
13266 #. type: textblock
13267 #: ../fish/guestfish-actions.pod:3023 ../src/guestfs-actions.pod:4656
13268 msgid ""
13269 "This command returns an error if the C<lvname> parameter does not refer to a "
13270 "logical volume."
13271 msgstr ""
13272
13273 #. type: textblock
13274 #: ../fish/guestfish-actions.pod:3026
13275 msgid "See also L</is-lv>."
13276 msgstr "Див. також L</is-lv>."
13277
13278 #. type: =head2
13279 #: ../fish/guestfish-actions.pod:3028
13280 msgid "lvm-clear-filter"
13281 msgstr "lvm-clear-filter"
13282
13283 #. type: verbatim
13284 #: ../fish/guestfish-actions.pod:3030
13285 #, no-wrap
13286 msgid ""
13287 " lvm-clear-filter\n"
13288 "\n"
13289 msgstr ""
13290 " lvm-clear-filter\n"
13291 "\n"
13292
13293 #. type: textblock
13294 #: ../fish/guestfish-actions.pod:3032
13295 msgid ""
13296 "This undoes the effect of L</lvm-set-filter>.  LVM will be able to see every "
13297 "block device."
13298 msgstr ""
13299
13300 #. type: textblock
13301 #: ../fish/guestfish-actions.pod:3035 ../fish/guestfish-actions.pod:3063
13302 #: ../src/guestfs-actions.pod:4674 ../src/guestfs-actions.pod:4713
13303 msgid ""
13304 "This command also clears the LVM cache and performs a volume group scan."
13305 msgstr ""
13306
13307 #. type: =head2
13308 #: ../fish/guestfish-actions.pod:3038
13309 msgid "lvm-remove-all"
13310 msgstr "lvm-remove-all"
13311
13312 #. type: verbatim
13313 #: ../fish/guestfish-actions.pod:3040
13314 #, no-wrap
13315 msgid ""
13316 " lvm-remove-all\n"
13317 "\n"
13318 msgstr ""
13319 " lvm-remove-all\n"
13320 "\n"
13321
13322 #. type: textblock
13323 #: ../fish/guestfish-actions.pod:3042 ../src/guestfs-actions.pod:4686
13324 msgid ""
13325 "This command removes all LVM logical volumes, volume groups and physical "
13326 "volumes."
13327 msgstr ""
13328
13329 #. type: =head2
13330 #: ../fish/guestfish-actions.pod:3045
13331 msgid "lvm-set-filter"
13332 msgstr "lvm-set-filter"
13333
13334 #. type: verbatim
13335 #: ../fish/guestfish-actions.pod:3047
13336 #, no-wrap
13337 msgid ""
13338 " lvm-set-filter 'devices ...'\n"
13339 "\n"
13340 msgstr ""
13341 " lvm-set-filter 'пристрої...'\n"
13342 "\n"
13343
13344 #. type: textblock
13345 #: ../fish/guestfish-actions.pod:3049 ../src/guestfs-actions.pod:4699
13346 msgid ""
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 "
13349 "block devices."
13350 msgstr ""
13351
13352 #. type: textblock
13353 #: ../fish/guestfish-actions.pod:3053 ../src/guestfs-actions.pod:4703
13354 msgid ""
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."
13362 msgstr ""
13363
13364 #. type: textblock
13365 #: ../fish/guestfish-actions.pod:3066 ../src/guestfs-actions.pod:4716
13366 msgid "You can filter whole block devices or individual partitions."
13367 msgstr ""
13368
13369 #. type: textblock
13370 #: ../fish/guestfish-actions.pod:3068 ../src/guestfs-actions.pod:4718
13371 msgid ""
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."
13374 msgstr ""
13375
13376 #. type: =head2
13377 #: ../fish/guestfish-actions.pod:3072
13378 msgid "lvremove"
13379 msgstr "lvremove"
13380
13381 #. type: verbatim
13382 #: ../fish/guestfish-actions.pod:3074
13383 #, no-wrap
13384 msgid ""
13385 " lvremove device\n"
13386 "\n"
13387 msgstr ""
13388 " lvremove пристрій\n"
13389 "\n"
13390
13391 #. type: textblock
13392 #: ../fish/guestfish-actions.pod:3076 ../src/guestfs-actions.pod:4732
13393 msgid ""
13394 "Remove an LVM logical volume C<device>, where C<device> is the path to the "
13395 "LV, such as C</dev/VG/LV>."
13396 msgstr ""
13397
13398 #. type: textblock
13399 #: ../fish/guestfish-actions.pod:3079 ../src/guestfs-actions.pod:4735
13400 msgid ""
13401 "You can also remove all LVs in a volume group by specifying the VG name, C</"
13402 "dev/VG>."
13403 msgstr ""
13404
13405 #. type: =head2
13406 #: ../fish/guestfish-actions.pod:3082
13407 msgid "lvrename"
13408 msgstr "lvrename"
13409
13410 #. type: verbatim
13411 #: ../fish/guestfish-actions.pod:3084
13412 #, no-wrap
13413 msgid ""
13414 " lvrename logvol newlogvol\n"
13415 "\n"
13416 msgstr ""
13417
13418 #. type: textblock
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>."
13421 msgstr ""
13422
13423 #. type: =head2
13424 #: ../fish/guestfish-actions.pod:3088
13425 msgid "lvresize"
13426 msgstr "lvresize"
13427
13428 #. type: verbatim
13429 #: ../fish/guestfish-actions.pod:3090
13430 #, no-wrap
13431 msgid ""
13432 " lvresize device mbytes\n"
13433 "\n"
13434 msgstr ""
13435
13436 #. type: textblock
13437 #: ../fish/guestfish-actions.pod:3092 ../src/guestfs-actions.pod:4762
13438 msgid ""
13439 "This resizes (expands or shrinks) an existing LVM logical volume to "
13440 "C<mbytes>.  When reducing, data in the reduced part is lost."
13441 msgstr ""
13442
13443 #. type: =head2
13444 #: ../fish/guestfish-actions.pod:3096
13445 msgid "lvresize-free"
13446 msgstr "lvresize-free"
13447
13448 #. type: verbatim
13449 #: ../fish/guestfish-actions.pod:3098
13450 #, no-wrap
13451 msgid ""
13452 " lvresize-free lv percent\n"
13453 "\n"
13454 msgstr ""
13455
13456 #. type: textblock
13457 #: ../fish/guestfish-actions.pod:3100 ../src/guestfs-actions.pod:4777
13458 msgid ""
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."
13463 msgstr ""
13464
13465 #. type: =head2
13466 #: ../fish/guestfish-actions.pod:3106
13467 msgid "lvs"
13468 msgstr "lvs"
13469
13470 #. type: verbatim
13471 #: ../fish/guestfish-actions.pod:3108
13472 #, no-wrap
13473 msgid ""
13474 " lvs\n"
13475 "\n"
13476 msgstr ""
13477 " lvs\n"
13478 "\n"
13479
13480 #. type: textblock
13481 #: ../fish/guestfish-actions.pod:3110 ../src/guestfs-actions.pod:4792
13482 msgid ""
13483 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
13484 "(8)> command."
13485 msgstr ""
13486
13487 #. type: textblock
13488 #: ../fish/guestfish-actions.pod:3113 ../src/guestfs-actions.pod:4795
13489 msgid ""
13490 "This returns a list of the logical volume device names (eg. C</dev/"
13491 "VolGroup00/LogVol00>)."
13492 msgstr ""
13493
13494 #. type: textblock
13495 #: ../fish/guestfish-actions.pod:3116
13496 msgid "See also L</lvs-full>, L</list-filesystems>."
13497 msgstr "Див. також L</lvs-full>, L</list-filesystems>."
13498
13499 #. type: =head2
13500 #: ../fish/guestfish-actions.pod:3118
13501 msgid "lvs-full"
13502 msgstr "lvs-full"
13503
13504 #. type: verbatim
13505 #: ../fish/guestfish-actions.pod:3120
13506 #, no-wrap
13507 msgid ""
13508 " lvs-full\n"
13509 "\n"
13510 msgstr ""
13511 " lvs-full\n"
13512 "\n"
13513
13514 #. type: textblock
13515 #: ../fish/guestfish-actions.pod:3122 ../src/guestfs-actions.pod:4811
13516 msgid ""
13517 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
13518 "(8)> command.  The \"full\" version includes all fields."
13519 msgstr ""
13520
13521 #. type: =head2
13522 #: ../fish/guestfish-actions.pod:3125
13523 msgid "lvuuid"
13524 msgstr "lvuuid"
13525
13526 #. type: verbatim
13527 #: ../fish/guestfish-actions.pod:3127
13528 #, no-wrap
13529 msgid ""
13530 " lvuuid device\n"
13531 "\n"
13532 msgstr ""
13533 " lvuuid пристрій\n"
13534 "\n"
13535
13536 #. type: textblock
13537 #: ../fish/guestfish-actions.pod:3129 ../src/guestfs-actions.pod:4826
13538 msgid "This command returns the UUID of the LVM LV C<device>."
13539 msgstr ""
13540
13541 #. type: =head2
13542 #: ../fish/guestfish-actions.pod:3131
13543 msgid "lxattrlist"
13544 msgstr "lxattrlist"
13545
13546 #. type: verbatim
13547 #: ../fish/guestfish-actions.pod:3133
13548 #, no-wrap
13549 msgid ""
13550 " lxattrlist path 'names ...'\n"
13551 "\n"
13552 msgstr ""
13553
13554 #. type: textblock
13555 #: ../fish/guestfish-actions.pod:3135 ../src/guestfs-actions.pod:4840
13556 msgid ""
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 "
13559 "this directory."
13560 msgstr ""
13561
13562 #. type: textblock
13563 #: ../fish/guestfish-actions.pod:3139 ../src/guestfs-actions.pod:4844
13564 msgid ""
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."
13572 msgstr ""
13573
13574 #. type: textblock
13575 #: ../fish/guestfish-actions.pod:3149
13576 msgid ""
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 "
13582 "names."
13583 msgstr ""
13584
13585 #. type: =head2
13586 #: ../fish/guestfish-actions.pod:3157
13587 #, fuzzy
13588 #| msgid "lvcreate"
13589 msgid "mdadm-create"
13590 msgstr "lvcreate"
13591
13592 #. type: verbatim
13593 #: ../fish/guestfish-actions.pod:3159
13594 #, no-wrap
13595 msgid ""
13596 " mdadm-create name 'devices ...' [missingbitmap:N] [nrdevices:N] [spare:N] [chunk:N] [level:..]\n"
13597 "\n"
13598 msgstr ""
13599
13600 #. type: textblock
13601 #: ../fish/guestfish-actions.pod:3161 ../src/guestfs-actions.pod:4887
13602 msgid ""
13603 "Create a Linux md (RAID) device named C<name> on the devices in the list "
13604 "C<devices>."
13605 msgstr ""
13606
13607 #. type: =item
13608 #: ../fish/guestfish-actions.pod:3168 ../src/guestfs-actions.pod:4894
13609 msgid "C<missingbitmap>"
13610 msgstr ""
13611
13612 #. type: textblock
13613 #: ../fish/guestfish-actions.pod:3170 ../src/guestfs-actions.pod:4896
13614 msgid ""
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."
13618 msgstr ""
13619
13620 #. type: textblock
13621 #: ../fish/guestfish-actions.pod:3174 ../src/guestfs-actions.pod:4900
13622 #, fuzzy
13623 #| msgid "For example:"
13624 msgid "As examples:"
13625 msgstr "Приклад:"
13626
13627 #. type: textblock
13628 #: ../fish/guestfish-actions.pod:3176 ../src/guestfs-actions.pod:4902
13629 msgid ""
13630 "If C<devices = [\"/dev/sda\"]> and C<missingbitmap = 0x1> then the resulting "
13631 "array would be C<[E<lt>missingE<gt>, \"/dev/sda\"]>."
13632 msgstr ""
13633
13634 #. type: textblock
13635 #: ../fish/guestfish-actions.pod:3179 ../src/guestfs-actions.pod:4905
13636 msgid ""
13637 "If C<devices = [\"/dev/sda\"]> and C<missingbitmap = 0x2> then the resulting "
13638 "array would be C<[\"/dev/sda\", E<lt>missingE<gt>]>."
13639 msgstr ""
13640
13641 #. type: textblock
13642 #: ../fish/guestfish-actions.pod:3182 ../src/guestfs-actions.pod:4908
13643 msgid "This defaults to C<0> (no missing devices)."
13644 msgstr ""
13645
13646 #. type: textblock
13647 #: ../fish/guestfish-actions.pod:3184 ../src/guestfs-actions.pod:4910
13648 msgid ""
13649 "The length of C<devices> + the number of bits set in C<missingbitmap> must "
13650 "equal C<nrdevices> + C<spare>."
13651 msgstr ""
13652
13653 #. type: =item
13654 #: ../fish/guestfish-actions.pod:3187 ../src/guestfs-actions.pod:4913
13655 #, fuzzy
13656 #| msgid "device"
13657 msgid "C<nrdevices>"
13658 msgstr "пристрій"
13659
13660 #. type: textblock
13661 #: ../fish/guestfish-actions.pod:3189 ../src/guestfs-actions.pod:4915
13662 #, fuzzy
13663 #| msgid "The number of hard links."
13664 msgid "The number of active RAID devices."
13665 msgstr "Кількість жорстких посилань."
13666
13667 #. type: textblock
13668 #: ../fish/guestfish-actions.pod:3191 ../src/guestfs-actions.pod:4917
13669 msgid ""
13670 "If not set, this defaults to the length of C<devices> plus the number of "
13671 "bits set in C<missingbitmap>."
13672 msgstr ""
13673
13674 #. type: =item
13675 #: ../fish/guestfish-actions.pod:3194 ../src/guestfs-actions.pod:4920
13676 #, fuzzy
13677 #| msgid "sparse"
13678 msgid "C<spare>"
13679 msgstr "sparse"
13680
13681 #. type: textblock
13682 #: ../fish/guestfish-actions.pod:3196 ../src/guestfs-actions.pod:4922
13683 #, fuzzy
13684 #| msgid "The number of hard links."
13685 msgid "The number of spare devices."
13686 msgstr "Кількість жорстких посилань."
13687
13688 #. type: textblock
13689 #: ../fish/guestfish-actions.pod:3198 ../src/guestfs-actions.pod:4924
13690 msgid "If not set, this defaults to C<0>."
13691 msgstr ""
13692
13693 #. type: =item
13694 #: ../fish/guestfish-actions.pod:3200 ../src/guestfs-actions.pod:4926
13695 msgid "C<chunk>"
13696 msgstr ""
13697
13698 #. type: textblock
13699 #: ../fish/guestfish-actions.pod:3202 ../src/guestfs-actions.pod:4928
13700 #, fuzzy
13701 #| msgid "The size in SI 1000 byte units."
13702 msgid "The chunk size in bytes."
13703 msgstr "Розмір у одиницях СІ: 1000 байтів."
13704
13705 #. type: =item
13706 #: ../fish/guestfish-actions.pod:3204 ../fish/guestfish-actions.pod:3226
13707 #: ../src/guestfs-actions.pod:4930 ../src/guestfs-actions.pod:4978
13708 msgid "C<level>"
13709 msgstr ""
13710
13711 #. type: textblock
13712 #: ../fish/guestfish-actions.pod:3206 ../src/guestfs-actions.pod:4932
13713 msgid ""
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 "
13717 "added in future."
13718 msgstr ""
13719
13720 #. type: textblock
13721 #: ../fish/guestfish-actions.pod:3211 ../src/guestfs-actions.pod:4937
13722 msgid "If not set, this defaults to C<raid1>."
13723 msgstr ""
13724
13725 #. type: =head2
13726 #: ../fish/guestfish-actions.pod:3217
13727 msgid "mdadm-detail"
13728 msgstr ""
13729
13730 #. type: verbatim
13731 #: ../fish/guestfish-actions.pod:3219
13732 #, no-wrap
13733 msgid ""
13734 " mdadm-detail md\n"
13735 "\n"
13736 msgstr ""
13737
13738 #. type: textblock
13739 #: ../fish/guestfish-actions.pod:3221 ../src/guestfs-actions.pod:4973
13740 msgid ""
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."
13743 msgstr ""
13744
13745 #. type: textblock
13746 #: ../fish/guestfish-actions.pod:3228 ../src/guestfs-actions.pod:4980
13747 msgid "The raid level of the MD device."
13748 msgstr ""
13749
13750 #. type: =item
13751 #: ../fish/guestfish-actions.pod:3230 ../src/guestfs-actions.pod:4982
13752 #, fuzzy
13753 #| msgid "device"
13754 msgid "C<devices>"
13755 msgstr "пристрій"
13756
13757 #. type: textblock
13758 #: ../fish/guestfish-actions.pod:3232 ../src/guestfs-actions.pod:4984
13759 msgid "The number of underlying devices in the MD device."
13760 msgstr ""
13761
13762 #. type: =item
13763 #: ../fish/guestfish-actions.pod:3234 ../src/guestfs-actions.pod:4986
13764 msgid "C<metadata>"
13765 msgstr ""
13766
13767 #. type: textblock
13768 #: ../fish/guestfish-actions.pod:3236 ../src/guestfs-actions.pod:4988
13769 msgid "The metadata version used."
13770 msgstr ""
13771
13772 #. type: =item
13773 #: ../fish/guestfish-actions.pod:3238 ../src/guestfs-actions.pod:4990
13774 #, fuzzy
13775 #| msgid "B<--uuid>"
13776 msgid "C<uuid>"
13777 msgstr "B<--uuid>"
13778
13779 #. type: textblock
13780 #: ../fish/guestfish-actions.pod:3240 ../src/guestfs-actions.pod:4992
13781 msgid "The UUID of the MD device."
13782 msgstr ""
13783
13784 #. type: textblock
13785 #: ../fish/guestfish-actions.pod:3244 ../src/guestfs-actions.pod:4996
13786 #, fuzzy
13787 #| msgid "The time of last access."
13788 msgid "The name of the MD device."
13789 msgstr "Час останнього доступу."
13790
13791 #. type: =head2
13792 #: ../fish/guestfish-actions.pod:3248
13793 msgid "mkdir"
13794 msgstr "mkdir"
13795
13796 #. type: verbatim
13797 #: ../fish/guestfish-actions.pod:3250
13798 #, no-wrap
13799 msgid ""
13800 " mkdir path\n"
13801 "\n"
13802 msgstr ""
13803 " mkdir шлях\n"
13804 "\n"
13805
13806 #. type: textblock
13807 #: ../fish/guestfish-actions.pod:3252 ../src/guestfs-actions.pod:5012
13808 msgid "Create a directory named C<path>."
13809 msgstr ""
13810
13811 #. type: =head2
13812 #: ../fish/guestfish-actions.pod:3254
13813 msgid "mkdir-mode"
13814 msgstr "mkdir-mode"
13815
13816 #. type: verbatim
13817 #: ../fish/guestfish-actions.pod:3256
13818 #, no-wrap
13819 msgid ""
13820 " mkdir-mode path mode\n"
13821 "\n"
13822 msgstr ""
13823 " mkdir-mode шлях режим\n"
13824 "\n"
13825
13826 #. type: textblock
13827 #: ../fish/guestfish-actions.pod:3258 ../src/guestfs-actions.pod:5025
13828 msgid ""
13829 "This command creates a directory, setting the initial permissions of the "
13830 "directory to C<mode>."
13831 msgstr ""
13832
13833 #. type: textblock
13834 #: ../fish/guestfish-actions.pod:3261 ../src/guestfs-actions.pod:5028
13835 msgid ""
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 "
13838 "other ways."
13839 msgstr ""
13840
13841 #. type: textblock
13842 #: ../fish/guestfish-actions.pod:3265
13843 msgid "See also L</mkdir>, L</umask>"
13844 msgstr "Див. також L</mkdir>, L</umask>"
13845
13846 #. type: =head2
13847 #: ../fish/guestfish-actions.pod:3267
13848 msgid "mkdir-p"
13849 msgstr "mkdir-p"
13850
13851 #. type: verbatim
13852 #: ../fish/guestfish-actions.pod:3269
13853 #, no-wrap
13854 msgid ""
13855 " mkdir-p path\n"
13856 "\n"
13857 msgstr ""
13858 " mkdir-p шлях\n"
13859 "\n"
13860
13861 #. type: textblock
13862 #: ../fish/guestfish-actions.pod:3271 ../src/guestfs-actions.pod:5044
13863 msgid ""
13864 "Create a directory named C<path>, creating any parent directories as "
13865 "necessary.  This is like the C<mkdir -p> shell command."
13866 msgstr ""
13867
13868 #. type: =head2
13869 #: ../fish/guestfish-actions.pod:3274
13870 msgid "mkdtemp"
13871 msgstr "mkdtemp"
13872
13873 #. type: verbatim
13874 #: ../fish/guestfish-actions.pod:3276
13875 #, no-wrap
13876 msgid ""
13877 " mkdtemp template\n"
13878 "\n"
13879 msgstr ""
13880 " mkdtemp шаблон\n"
13881 "\n"
13882
13883 #. type: textblock
13884 #: ../fish/guestfish-actions.pod:3278 ../src/guestfs-actions.pod:5057
13885 msgid ""
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\"."
13889 msgstr ""
13890
13891 #. type: textblock
13892 #: ../fish/guestfish-actions.pod:3283 ../src/guestfs-actions.pod:5062
13893 msgid ""
13894 "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one "
13895 "being suitable for Windows filesystems."
13896 msgstr ""
13897
13898 #. type: textblock
13899 #: ../fish/guestfish-actions.pod:3286 ../src/guestfs-actions.pod:5065
13900 msgid "The name of the temporary directory that was created is returned."
13901 msgstr ""
13902
13903 #. type: textblock
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."
13906 msgstr ""
13907
13908 #. type: textblock
13909 #: ../fish/guestfish-actions.pod:3292 ../src/guestfs-actions.pod:5071
13910 msgid ""
13911 "The caller is responsible for deleting the temporary directory and its "
13912 "contents after use."
13913 msgstr ""
13914
13915 #. type: textblock
13916 #: ../fish/guestfish-actions.pod:3295 ../src/guestfs-actions.pod:5074
13917 msgid "See also: L<mkdtemp(3)>"
13918 msgstr "Див. також L<mkdtemp(3)>"
13919
13920 #. type: =head2
13921 #: ../fish/guestfish-actions.pod:3297
13922 msgid "mke2fs-J"
13923 msgstr "mke2fs-J"
13924
13925 #. type: verbatim
13926 #: ../fish/guestfish-actions.pod:3299
13927 #, no-wrap
13928 msgid ""
13929 " mke2fs-J fstype blocksize device journal\n"
13930 "\n"
13931 msgstr ""
13932
13933 #. type: textblock
13934 #: ../fish/guestfish-actions.pod:3301 ../src/guestfs-actions.pod:5090
13935 msgid ""
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:"
13938 msgstr ""
13939
13940 #. type: verbatim
13941 #: ../fish/guestfish-actions.pod:3305 ../src/guestfs-actions.pod:5094
13942 #, no-wrap
13943 msgid ""
13944 " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n"
13945 "\n"
13946 msgstr ""
13947 " mke2fs -t fstype -b blocksize -J device=<журнал> <пристрій>\n"
13948 "\n"
13949
13950 #. type: textblock
13951 #: ../fish/guestfish-actions.pod:3307
13952 msgid "See also L</mke2journal>."
13953 msgstr "Див. також L</mke2journal>."
13954
13955 #. type: =head2
13956 #: ../fish/guestfish-actions.pod:3309
13957 msgid "mke2fs-JL"
13958 msgstr "mke2fs-JL"
13959
13960 #. type: verbatim
13961 #: ../fish/guestfish-actions.pod:3311
13962 #, no-wrap
13963 msgid ""
13964 " mke2fs-JL fstype blocksize device label\n"
13965 "\n"
13966 msgstr ""
13967
13968 #. type: textblock
13969 #: ../fish/guestfish-actions.pod:3313 ../src/guestfs-actions.pod:5111
13970 msgid ""
13971 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
13972 "the journal labeled C<label>."
13973 msgstr ""
13974
13975 #. type: textblock
13976 #: ../fish/guestfish-actions.pod:3316
13977 msgid "See also L</mke2journal-L>."
13978 msgstr "Див. також L</mke2journal-L>."
13979
13980 #. type: =head2
13981 #: ../fish/guestfish-actions.pod:3318
13982 msgid "mke2fs-JU"
13983 msgstr "mke2fs-JU"
13984
13985 #. type: verbatim
13986 #: ../fish/guestfish-actions.pod:3320
13987 #, no-wrap
13988 msgid ""
13989 " mke2fs-JU fstype blocksize device uuid\n"
13990 "\n"
13991 msgstr ""
13992
13993 #. type: textblock
13994 #: ../fish/guestfish-actions.pod:3322 ../src/guestfs-actions.pod:5129
13995 msgid ""
13996 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
13997 "the journal with UUID C<uuid>."
13998 msgstr ""
13999
14000 #. type: textblock
14001 #: ../fish/guestfish-actions.pod:3325
14002 msgid "See also L</mke2journal-U>."
14003 msgstr "Див. також L</mke2journal-U>."
14004
14005 #. type: =head2
14006 #: ../fish/guestfish-actions.pod:3327
14007 msgid "mke2journal"
14008 msgstr "mke2journal"
14009
14010 #. type: verbatim
14011 #: ../fish/guestfish-actions.pod:3329
14012 #, no-wrap
14013 msgid ""
14014 " mke2journal blocksize device\n"
14015 "\n"
14016 msgstr ""
14017
14018 #. type: textblock
14019 #: ../fish/guestfish-actions.pod:3331 ../src/guestfs-actions.pod:5145
14020 msgid ""
14021 "This creates an ext2 external journal on C<device>.  It is equivalent to the "
14022 "command:"
14023 msgstr ""
14024
14025 #. type: verbatim
14026 #: ../fish/guestfish-actions.pod:3334 ../src/guestfs-actions.pod:5148
14027 #, no-wrap
14028 msgid ""
14029 " mke2fs -O journal_dev -b blocksize device\n"
14030 "\n"
14031 msgstr ""
14032
14033 #. type: =head2
14034 #: ../fish/guestfish-actions.pod:3336
14035 msgid "mke2journal-L"
14036 msgstr "mke2journal-L"
14037
14038 #. type: verbatim
14039 #: ../fish/guestfish-actions.pod:3338
14040 #, no-wrap
14041 msgid ""
14042 " mke2journal-L blocksize label device\n"
14043 "\n"
14044 msgstr ""
14045
14046 #. type: textblock
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>."
14049 msgstr ""
14050
14051 #. type: =head2
14052 #: ../fish/guestfish-actions.pod:3342
14053 msgid "mke2journal-U"
14054 msgstr "mke2journal-U"
14055
14056 #. type: verbatim
14057 #: ../fish/guestfish-actions.pod:3344
14058 #, no-wrap
14059 msgid ""
14060 " mke2journal-U blocksize uuid device\n"
14061 "\n"
14062 msgstr ""
14063
14064 #. type: textblock
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>."
14067 msgstr ""
14068
14069 #. type: =head2
14070 #: ../fish/guestfish-actions.pod:3348
14071 msgid "mkfifo"
14072 msgstr "mkfifo"
14073
14074 #. type: verbatim
14075 #: ../fish/guestfish-actions.pod:3350
14076 #, no-wrap
14077 msgid ""
14078 " mkfifo mode path\n"
14079 "\n"
14080 msgstr ""
14081 " mkfifo режим шлях\n"
14082 "\n"
14083
14084 #. type: textblock
14085 #: ../fish/guestfish-actions.pod:3352
14086 msgid ""
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>."
14089 msgstr ""
14090
14091 #. type: =head2
14092 #: ../fish/guestfish-actions.pod:3358
14093 msgid "mkfs"
14094 msgstr "mkfs"
14095
14096 #. type: verbatim
14097 #: ../fish/guestfish-actions.pod:3360
14098 #, no-wrap
14099 msgid ""
14100 " mkfs fstype device\n"
14101 "\n"
14102 msgstr ""
14103 " mkfs тип_файлової_системи пристрій\n"
14104 "\n"
14105
14106 #. type: textblock
14107 #: ../fish/guestfish-actions.pod:3362 ../src/guestfs-actions.pod:5206
14108 msgid ""
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>."
14111 msgstr ""
14112
14113 #. type: =head2
14114 #: ../fish/guestfish-actions.pod:3366
14115 msgid "mkfs-b"
14116 msgstr "mkfs-b"
14117
14118 #. type: verbatim
14119 #: ../fish/guestfish-actions.pod:3368
14120 #, no-wrap
14121 msgid ""
14122 " mkfs-b fstype blocksize device\n"
14123 "\n"
14124 msgstr ""
14125
14126 #. type: textblock
14127 #: ../fish/guestfish-actions.pod:3370
14128 msgid ""
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."
14132 msgstr ""
14133
14134 #. type: textblock
14135 #: ../fish/guestfish-actions.pod:3375 ../fish/guestfish-actions.pod:3402
14136 #: ../src/guestfs-actions.pod:5234 ../src/guestfs-actions.pod:5272
14137 msgid ""
14138 "For VFAT and NTFS the C<blocksize> parameter is treated as the requested "
14139 "cluster size."
14140 msgstr ""
14141
14142 #. type: textblock
14143 #: ../fish/guestfish-actions.pod:3378
14144 msgid ""
14145 "I<This function is deprecated.> In new code, use the L</mkfs_opts> call "
14146 "instead."
14147 msgstr ""
14148
14149 #. type: =head2
14150 #: ../fish/guestfish-actions.pod:3385
14151 msgid "mkfs-opts"
14152 msgstr "mkfs-opts"
14153
14154 #. type: verbatim
14155 #: ../fish/guestfish-actions.pod:3387
14156 #, no-wrap
14157 msgid ""
14158 " mkfs-opts fstype device [blocksize:N] [features:..] [inode:N] [sectorsize:N]\n"
14159 "\n"
14160 msgstr ""
14161
14162 #. type: textblock
14163 #: ../fish/guestfish-actions.pod:3389 ../src/guestfs-actions.pod:5259
14164 msgid ""
14165 "This function creates a filesystem on C<device>.  The filesystem type is "
14166 "C<fstype>, for example C<ext3>."
14167 msgstr ""
14168
14169 #. type: =item
14170 #: ../fish/guestfish-actions.pod:3396 ../src/guestfs-actions.pod:5266
14171 msgid "C<blocksize>"
14172 msgstr "C<blocksize>"
14173
14174 #. type: textblock
14175 #: ../fish/guestfish-actions.pod:3398 ../src/guestfs-actions.pod:5268
14176 msgid ""
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 "
14179 "filesystems."
14180 msgstr ""
14181
14182 #. type: textblock
14183 #: ../fish/guestfish-actions.pod:3405 ../src/guestfs-actions.pod:5275
14184 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>."
14185 msgstr ""
14186
14187 #. type: =item
14188 #: ../fish/guestfish-actions.pod:3407 ../src/guestfs-actions.pod:5277
14189 msgid "C<features>"
14190 msgstr "C<features>"
14191
14192 #. type: textblock
14193 #: ../fish/guestfish-actions.pod:3409 ../src/guestfs-actions.pod:5279
14194 msgid "This passes the I<-O> parameter to the external mkfs program."
14195 msgstr ""
14196
14197 #. type: textblock
14198 #: ../fish/guestfish-actions.pod:3411 ../src/guestfs-actions.pod:5281
14199 msgid ""
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."
14202 msgstr ""
14203
14204 #. type: textblock
14205 #: ../fish/guestfish-actions.pod:3415 ../src/guestfs-actions.pod:5285
14206 msgid ""
14207 "You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem "
14208 "type."
14209 msgstr ""
14210
14211 #. type: =item
14212 #: ../fish/guestfish-actions.pod:3418 ../src/guestfs-actions.pod:5288
14213 msgid "C<inode>"
14214 msgstr "C<inode>"
14215
14216 #. type: textblock
14217 #: ../fish/guestfish-actions.pod:3420 ../src/guestfs-actions.pod:5290
14218 msgid ""
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)."
14221 msgstr ""
14222
14223 #. type: =item
14224 #: ../fish/guestfish-actions.pod:3423 ../src/guestfs-actions.pod:5293
14225 msgid "C<sectorsize>"
14226 msgstr "C<sectorsize>"
14227
14228 #. type: textblock
14229 #: ../fish/guestfish-actions.pod:3425 ../src/guestfs-actions.pod:5295
14230 msgid ""
14231 "This passes the I<-S> parameter to external L<mkfs.ufs(8)> program, which "
14232 "sets sector size for ufs filesystem."
14233 msgstr ""
14234
14235 #. type: =head2
14236 #: ../fish/guestfish-actions.pod:3432
14237 msgid "mkmountpoint"
14238 msgstr "mkmountpoint"
14239
14240 #. type: verbatim
14241 #: ../fish/guestfish-actions.pod:3434
14242 #, no-wrap
14243 msgid ""
14244 " mkmountpoint exemptpath\n"
14245 "\n"
14246 msgstr ""
14247
14248 #. type: textblock
14249 #: ../fish/guestfish-actions.pod:3436
14250 msgid ""
14251 "L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used "
14252 "to create extra mountpoints before mounting the first filesystem."
14253 msgstr ""
14254
14255 #. type: textblock
14256 #: ../fish/guestfish-actions.pod:3440 ../src/guestfs-actions.pod:5338
14257 msgid ""
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."
14261 msgstr ""
14262
14263 #. type: textblock
14264 #: ../fish/guestfish-actions.pod:3444 ../src/guestfs-actions.pod:5342
14265 msgid ""
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:"
14269 msgstr ""
14270
14271 #. type: verbatim
14272 #: ../fish/guestfish-actions.pod:3449 ../src/guestfs-actions.pod:5347
14273 #, no-wrap
14274 msgid ""
14275 " add-ro Fedora-11-i686-Live.iso\n"
14276 " run\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"
14283 "\n"
14284 msgstr ""
14285 " add-ro Fedora-11-i686-Live.iso\n"
14286 " run\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"
14293 "\n"
14294
14295 #. type: textblock
14296 #: ../fish/guestfish-actions.pod:3458 ../src/guestfs-actions.pod:5356
14297 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint."
14298 msgstr ""
14299
14300 #. type: textblock
14301 #: ../fish/guestfish-actions.pod:3460
14302 msgid ""
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."
14306 msgstr ""
14307
14308 #. type: textblock
14309 #: ../fish/guestfish-actions.pod:3464
14310 msgid ""
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."
14314 msgstr ""
14315
14316 #. type: textblock
14317 #: ../fish/guestfish-actions.pod:3469 ../src/guestfs-actions.pod:5367
14318 msgid ""
14319 "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>"
14320 msgstr ""
14321
14322 #. type: textblock
14323 #: ../fish/guestfish-actions.pod:3471
14324 msgid ""
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 "
14327 "these issues."
14328 msgstr ""
14329
14330 #. type: =head2
14331 #: ../fish/guestfish-actions.pod:3475
14332 msgid "mknod"
14333 msgstr "mknod"
14334
14335 #. type: verbatim
14336 #: ../fish/guestfish-actions.pod:3477
14337 #, no-wrap
14338 msgid ""
14339 " mknod mode devmajor devminor path\n"
14340 "\n"
14341 msgstr ""
14342
14343 #. type: textblock
14344 #: ../fish/guestfish-actions.pod:3479 ../src/guestfs-actions.pod:5386
14345 msgid ""
14346 "This call creates block or character special devices, or named pipes (FIFOs)."
14347 msgstr ""
14348
14349 #. type: textblock
14350 #: ../fish/guestfish-actions.pod:3482 ../src/guestfs-actions.pod:5389
14351 msgid ""
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."
14355 msgstr ""
14356
14357 #. type: textblock
14358 #: ../fish/guestfish-actions.pod:3487
14359 msgid ""
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 "
14365 "for you."
14366 msgstr ""
14367
14368 #. type: =head2
14369 #: ../fish/guestfish-actions.pod:3497
14370 msgid "mknod-b"
14371 msgstr "mknod-b"
14372
14373 #. type: verbatim
14374 #: ../fish/guestfish-actions.pod:3499
14375 #, no-wrap
14376 msgid ""
14377 " mknod-b mode devmajor devminor path\n"
14378 "\n"
14379 msgstr ""
14380
14381 #. type: textblock
14382 #: ../fish/guestfish-actions.pod:3501
14383 msgid ""
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>."
14387 msgstr ""
14388
14389 #. type: =head2
14390 #: ../fish/guestfish-actions.pod:3507
14391 msgid "mknod-c"
14392 msgstr "mknod-c"
14393
14394 #. type: verbatim
14395 #: ../fish/guestfish-actions.pod:3509
14396 #, no-wrap
14397 msgid ""
14398 " mknod-c mode devmajor devminor path\n"
14399 "\n"
14400 msgstr ""
14401
14402 #. type: textblock
14403 #: ../fish/guestfish-actions.pod:3511
14404 msgid ""
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>."
14408 msgstr ""
14409
14410 #. type: =head2
14411 #: ../fish/guestfish-actions.pod:3517
14412 msgid "mkswap"
14413 msgstr "mkswap"
14414
14415 #. type: verbatim
14416 #: ../fish/guestfish-actions.pod:3519
14417 #, no-wrap
14418 msgid ""
14419 " mkswap device\n"
14420 "\n"
14421 msgstr ""
14422 " mkswap пристрій\n"
14423 "\n"
14424
14425 #. type: textblock
14426 #: ../fish/guestfish-actions.pod:3521 ../src/guestfs-actions.pod:5452
14427 msgid "Create a swap partition on C<device>."
14428 msgstr ""
14429
14430 #. type: =head2
14431 #: ../fish/guestfish-actions.pod:3523
14432 msgid "mkswap-L"
14433 msgstr "mkswap-L"
14434
14435 #. type: verbatim
14436 #: ../fish/guestfish-actions.pod:3525
14437 #, no-wrap
14438 msgid ""
14439 " mkswap-L label device\n"
14440 "\n"
14441 msgstr ""
14442 " mkswap-L мітка пристрій\n"
14443 "\n"
14444
14445 #. type: textblock
14446 #: ../fish/guestfish-actions.pod:3527 ../src/guestfs-actions.pod:5465
14447 msgid "Create a swap partition on C<device> with label C<label>."
14448 msgstr ""
14449
14450 #. type: textblock
14451 #: ../fish/guestfish-actions.pod:3529 ../src/guestfs-actions.pod:5467
14452 msgid ""
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 "
14455 "or swap tools."
14456 msgstr ""
14457
14458 #. type: =head2
14459 #: ../fish/guestfish-actions.pod:3533
14460 msgid "mkswap-U"
14461 msgstr "mkswap-U"
14462
14463 #. type: verbatim
14464 #: ../fish/guestfish-actions.pod:3535
14465 #, no-wrap
14466 msgid ""
14467 " mkswap-U uuid device\n"
14468 "\n"
14469 msgstr ""
14470 " mkswap-U uuid пристрій\n"
14471 "\n"
14472
14473 #. type: textblock
14474 #: ../fish/guestfish-actions.pod:3537 ../src/guestfs-actions.pod:5482
14475 msgid "Create a swap partition on C<device> with UUID C<uuid>."
14476 msgstr ""
14477
14478 #. type: =head2
14479 #: ../fish/guestfish-actions.pod:3539
14480 msgid "mkswap-file"
14481 msgstr "mkswap-file"
14482
14483 #. type: verbatim
14484 #: ../fish/guestfish-actions.pod:3541
14485 #, no-wrap
14486 msgid ""
14487 " mkswap-file path\n"
14488 "\n"
14489 msgstr ""
14490 " mkswap-file шлях\n"
14491 "\n"
14492
14493 #. type: textblock
14494 #: ../fish/guestfish-actions.pod:3543 ../src/guestfs-actions.pod:5494
14495 msgid "Create a swap file."
14496 msgstr "Створити файл резервної пам’яті."
14497
14498 #. type: textblock
14499 #: ../fish/guestfish-actions.pod:3545
14500 msgid ""
14501 "This command just writes a swap file signature to an existing file.  To "
14502 "create the file itself, use something like L</fallocate>."
14503 msgstr ""
14504
14505 #. type: =head2
14506 #: ../fish/guestfish-actions.pod:3548
14507 msgid "modprobe"
14508 msgstr "modprobe"
14509
14510 #. type: verbatim
14511 #: ../fish/guestfish-actions.pod:3550
14512 #, no-wrap
14513 msgid ""
14514 " modprobe modulename\n"
14515 "\n"
14516 msgstr ""
14517 " modprobe назва_модуля\n"
14518 "\n"
14519
14520 #. type: textblock
14521 #: ../fish/guestfish-actions.pod:3552 ../src/guestfs-actions.pod:5509
14522 msgid "This loads a kernel module in the appliance."
14523 msgstr ""
14524
14525 #. type: textblock
14526 #: ../fish/guestfish-actions.pod:3554 ../src/guestfs-actions.pod:5511
14527 msgid ""
14528 "The kernel module must have been whitelisted when libguestfs was built (see "
14529 "C<appliance/kmod.whitelist.in> in the source)."
14530 msgstr ""
14531
14532 #. type: =head2
14533 #: ../fish/guestfish-actions.pod:3557
14534 msgid "mount"
14535 msgstr "mount"
14536
14537 #. type: verbatim
14538 #: ../fish/guestfish-actions.pod:3559
14539 #, no-wrap
14540 msgid ""
14541 " mount device mountpoint\n"
14542 "\n"
14543 msgstr ""
14544 " mount пристрій точка_монтування\n"
14545 "\n"
14546
14547 #. type: textblock
14548 #: ../fish/guestfish-actions.pod:3561 ../src/guestfs-actions.pod:5525
14549 msgid ""
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."
14554 msgstr ""
14555
14556 #. type: textblock
14557 #: ../fish/guestfish-actions.pod:3567 ../src/guestfs-actions.pod:5531
14558 msgid ""
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."
14562 msgstr ""
14563
14564 #. type: textblock
14565 #: ../fish/guestfish-actions.pod:3572 ../src/guestfs-actions.pod:5536
14566 msgid ""
14567 "The mounted filesystem is writable, if we have sufficient permissions on the "
14568 "underlying device."
14569 msgstr ""
14570
14571 #. type: textblock
14572 #: ../fish/guestfish-actions.pod:3575
14573 msgid ""
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)."
14579 msgstr ""
14580
14581 #. type: =head2
14582 #: ../fish/guestfish-actions.pod:3582
14583 msgid "mount-9p"
14584 msgstr ""
14585
14586 #. type: verbatim
14587 #: ../fish/guestfish-actions.pod:3584
14588 #, no-wrap
14589 msgid ""
14590 " mount-9p mounttag mountpoint [options:..]\n"
14591 "\n"
14592 msgstr ""
14593
14594 #. type: textblock
14595 #: ../fish/guestfish-actions.pod:3586 ../src/guestfs-actions.pod:5565
14596 msgid ""
14597 "Mount the virtio-9p filesystem with the tag C<mounttag> on the directory "
14598 "C<mountpoint>."
14599 msgstr ""
14600
14601 #. type: textblock
14602 #: ../fish/guestfish-actions.pod:3589 ../src/guestfs-actions.pod:5568
14603 msgid ""
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> "
14606 "parameter."
14607 msgstr ""
14608
14609 #. type: =head2
14610 #: ../fish/guestfish-actions.pod:3595
14611 msgid "mount-loop"
14612 msgstr "mount-loop"
14613
14614 #. type: verbatim
14615 #: ../fish/guestfish-actions.pod:3597
14616 #, no-wrap
14617 msgid ""
14618 " mount-loop file mountpoint\n"
14619 "\n"
14620 msgstr ""
14621
14622 #. type: textblock
14623 #: ../fish/guestfish-actions.pod:3599 ../src/guestfs-actions.pod:5607
14624 msgid ""
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 "
14627 "mountpoint>."
14628 msgstr ""
14629
14630 #. type: =head2
14631 #: ../fish/guestfish-actions.pod:3603
14632 msgid "mount-options"
14633 msgstr "mount-options"
14634
14635 #. type: verbatim
14636 #: ../fish/guestfish-actions.pod:3605
14637 #, no-wrap
14638 msgid ""
14639 " mount-options options device mountpoint\n"
14640 "\n"
14641 msgstr ""
14642
14643 #. type: textblock
14644 #: ../fish/guestfish-actions.pod:3607
14645 msgid ""
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."
14648 msgstr ""
14649
14650 #. type: textblock
14651 #: ../fish/guestfish-actions.pod:3611 ../src/guestfs-actions.pod:5627
14652 msgid ""
14653 "If the C<options> parameter is an empty string, then no options are passed "
14654 "(all options default to whatever the filesystem uses)."
14655 msgstr ""
14656
14657 #. type: =head2
14658 #: ../fish/guestfish-actions.pod:3615
14659 msgid "mount-ro"
14660 msgstr "mount-ro"
14661
14662 #. type: verbatim
14663 #: ../fish/guestfish-actions.pod:3617
14664 #, no-wrap
14665 msgid ""
14666 " mount-ro device mountpoint\n"
14667 "\n"
14668 msgstr ""
14669 " mount-ro пристрій точка_монтування\n"
14670 "\n"
14671
14672 #. type: textblock
14673 #: ../fish/guestfish-actions.pod:3619
14674 msgid ""
14675 "This is the same as the L</mount> command, but it mounts the filesystem with "
14676 "the read-only (I<-o ro>) flag."
14677 msgstr ""
14678
14679 #. type: =head2
14680 #: ../fish/guestfish-actions.pod:3622
14681 msgid "mount-vfs"
14682 msgstr "mount-vfs"
14683
14684 #. type: verbatim
14685 #: ../fish/guestfish-actions.pod:3624
14686 #, no-wrap
14687 msgid ""
14688 " mount-vfs options vfstype device mountpoint\n"
14689 "\n"
14690 msgstr ""
14691
14692 #. type: textblock
14693 #: ../fish/guestfish-actions.pod:3626
14694 msgid ""
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."
14697 msgstr ""
14698
14699 #. type: =head2
14700 #: ../fish/guestfish-actions.pod:3630
14701 msgid "mountpoints"
14702 msgstr "mountpoints"
14703
14704 #. type: verbatim
14705 #: ../fish/guestfish-actions.pod:3632
14706 #, no-wrap
14707 msgid ""
14708 " mountpoints\n"
14709 "\n"
14710 msgstr ""
14711 " mountpoints\n"
14712 "\n"
14713
14714 #. type: textblock
14715 #: ../fish/guestfish-actions.pod:3634
14716 msgid ""
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."
14720 msgstr ""
14721
14722 #. type: =head2
14723 #: ../fish/guestfish-actions.pod:3638
14724 msgid "mounts"
14725 msgstr "mounts"
14726
14727 #. type: verbatim
14728 #: ../fish/guestfish-actions.pod:3640
14729 #, no-wrap
14730 msgid ""
14731 " mounts\n"
14732 "\n"
14733 msgstr ""
14734 " mounts\n"
14735 "\n"
14736
14737 #. type: textblock
14738 #: ../fish/guestfish-actions.pod:3642 ../src/guestfs-actions.pod:5688
14739 msgid ""
14740 "This returns the list of currently mounted filesystems.  It returns the list "
14741 "of devices (eg. C</dev/sda1>, C</dev/VG/LV>)."
14742 msgstr ""
14743
14744 #. type: textblock
14745 #: ../fish/guestfish-actions.pod:3645 ../src/guestfs-actions.pod:5691
14746 msgid "Some internal mounts are not shown."
14747 msgstr ""
14748
14749 #. type: textblock
14750 #: ../fish/guestfish-actions.pod:3647
14751 msgid "See also: L</mountpoints>"
14752 msgstr "Див. також L</mountpoints>"
14753
14754 #. type: =head2
14755 #: ../fish/guestfish-actions.pod:3649
14756 msgid "mv"
14757 msgstr "mv"
14758
14759 #. type: verbatim
14760 #: ../fish/guestfish-actions.pod:3651
14761 #, no-wrap
14762 msgid ""
14763 " mv src dest\n"
14764 "\n"
14765 msgstr ""
14766 " mv джерело призначення\n"
14767 "\n"
14768
14769 #. type: textblock
14770 #: ../fish/guestfish-actions.pod:3653 ../src/guestfs-actions.pod:5708
14771 msgid ""
14772 "This moves a file from C<src> to C<dest> where C<dest> is either a "
14773 "destination filename or destination directory."
14774 msgstr ""
14775
14776 #. type: =head2
14777 #: ../fish/guestfish-actions.pod:3656
14778 msgid "ntfs-3g-probe"
14779 msgstr "ntfs-3g-probe"
14780
14781 #. type: verbatim
14782 #: ../fish/guestfish-actions.pod:3658
14783 #, no-wrap
14784 msgid ""
14785 " ntfs-3g-probe true|false device\n"
14786 "\n"
14787 msgstr ""
14788
14789 #. type: textblock
14790 #: ../fish/guestfish-actions.pod:3660 ../src/guestfs-actions.pod:5722
14791 msgid ""
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)."
14795 msgstr ""
14796
14797 #. type: textblock
14798 #: ../fish/guestfish-actions.pod:3664 ../src/guestfs-actions.pod:5726
14799 msgid ""
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."
14803 msgstr ""
14804
14805 #. type: textblock
14806 #: ../fish/guestfish-actions.pod:3668 ../src/guestfs-actions.pod:5730
14807 msgid ""
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."
14810 msgstr ""
14811
14812 #. type: =head2
14813 #: ../fish/guestfish-actions.pod:3672
14814 msgid "ntfsresize"
14815 msgstr "ntfsresize"
14816
14817 #. type: verbatim
14818 #: ../fish/guestfish-actions.pod:3674
14819 #, no-wrap
14820 msgid ""
14821 " ntfsresize device\n"
14822 "\n"
14823 msgstr ""
14824 " ntfsresize пристрій\n"
14825 "\n"
14826
14827 #. type: textblock
14828 #: ../fish/guestfish-actions.pod:3676 ../fish/guestfish-actions.pod:3700
14829 #: ../src/guestfs-actions.pod:5751 ../src/guestfs-actions.pod:5783
14830 msgid ""
14831 "This command resizes an NTFS filesystem, expanding or shrinking it to the "
14832 "size of the underlying device."
14833 msgstr ""
14834
14835 #. type: textblock
14836 #: ../fish/guestfish-actions.pod:3679 ../src/guestfs-actions.pod:5754
14837 msgid ""
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."
14844 msgstr ""
14845
14846 #. type: textblock
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)>."
14851
14852 #. type: textblock
14853 #: ../fish/guestfish-actions.pod:3689 ../fish/guestfish-actions.pod:3737
14854 msgid ""
14855 "I<This function is deprecated.> In new code, use the L</ntfsresize_opts> "
14856 "call instead."
14857 msgstr ""
14858
14859 #. type: =head2
14860 #: ../fish/guestfish-actions.pod:3696
14861 msgid "ntfsresize-opts"
14862 msgstr ""
14863
14864 #. type: verbatim
14865 #: ../fish/guestfish-actions.pod:3698
14866 #, no-wrap
14867 msgid ""
14868 " ntfsresize-opts device [size:N] [force:true|false]\n"
14869 "\n"
14870 msgstr ""
14871
14872 #. type: textblock
14873 #: ../fish/guestfish-actions.pod:3709 ../src/guestfs-actions.pod:5792
14874 msgid ""
14875 "The new size (in bytes) of the filesystem.  If omitted, the filesystem is "
14876 "resized to fit the container (eg. partition)."
14877 msgstr ""
14878
14879 #. type: =item
14880 #: ../fish/guestfish-actions.pod:3712 ../fish/guestfish-actions.pod:5033
14881 #: ../src/guestfs-actions.pod:5795 ../src/guestfs-actions.pod:7766
14882 msgid "C<force>"
14883 msgstr "C<force>"
14884
14885 #. type: textblock
14886 #: ../fish/guestfish-actions.pod:3714 ../src/guestfs-actions.pod:5797
14887 msgid ""
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."
14890 msgstr ""
14891
14892 #. type: textblock
14893 #: ../fish/guestfish-actions.pod:3717
14894 msgid ""
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."
14900 msgstr ""
14901
14902 #. type: =head2
14903 #: ../fish/guestfish-actions.pod:3730
14904 msgid "ntfsresize-size"
14905 msgstr "ntfsresize-size"
14906
14907 #. type: verbatim
14908 #: ../fish/guestfish-actions.pod:3732
14909 #, no-wrap
14910 msgid ""
14911 " ntfsresize-size device size\n"
14912 "\n"
14913 msgstr ""
14914
14915 #. type: textblock
14916 #: ../fish/guestfish-actions.pod:3734
14917 msgid ""
14918 "This command is the same as L</ntfsresize> except that it allows you to "
14919 "specify the new size (in bytes) explicitly."
14920 msgstr ""
14921
14922 #. type: =head2
14923 #: ../fish/guestfish-actions.pod:3744
14924 msgid "part-add"
14925 msgstr "part-add"
14926
14927 #. type: verbatim
14928 #: ../fish/guestfish-actions.pod:3746
14929 #, no-wrap
14930 msgid ""
14931 " part-add device prlogex startsect endsect\n"
14932 "\n"
14933 msgstr ""
14934
14935 #. type: textblock
14936 #: ../fish/guestfish-actions.pod:3748
14937 msgid ""
14938 "This command adds a partition to C<device>.  If there is no partition table "
14939 "on the device, call L</part-init> first."
14940 msgstr ""
14941
14942 #. type: textblock
14943 #: ../fish/guestfish-actions.pod:3751 ../src/guestfs-actions.pod:5870
14944 msgid ""
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."
14948 msgstr ""
14949
14950 #. type: textblock
14951 #: ../fish/guestfish-actions.pod:3756 ../src/guestfs-actions.pod:5875
14952 msgid ""
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)."
14956 msgstr ""
14957
14958 #. type: textblock
14959 #: ../fish/guestfish-actions.pod:3760
14960 msgid ""
14961 "Creating a partition which covers the whole disk is not so easy.  Use L</"
14962 "part-disk> to do that."
14963 msgstr ""
14964
14965 #. type: =head2
14966 #: ../fish/guestfish-actions.pod:3763
14967 msgid "part-del"
14968 msgstr "part-del"
14969
14970 #. type: verbatim
14971 #: ../fish/guestfish-actions.pod:3765
14972 #, no-wrap
14973 msgid ""
14974 " part-del device partnum\n"
14975 "\n"
14976 msgstr ""
14977
14978 #. type: textblock
14979 #: ../fish/guestfish-actions.pod:3767 ../src/guestfs-actions.pod:5893
14980 msgid "This command deletes the partition numbered C<partnum> on C<device>."
14981 msgstr ""
14982
14983 #. type: textblock
14984 #: ../fish/guestfish-actions.pod:3769 ../src/guestfs-actions.pod:5895
14985 msgid ""
14986 "Note that in the case of MBR partitioning, deleting an extended partition "
14987 "also deletes any logical partitions it contains."
14988 msgstr ""
14989
14990 #. type: =head2
14991 #: ../fish/guestfish-actions.pod:3773
14992 msgid "part-disk"
14993 msgstr "part-disk"
14994
14995 #. type: verbatim
14996 #: ../fish/guestfish-actions.pod:3775
14997 #, no-wrap
14998 msgid ""
14999 " part-disk device parttype\n"
15000 "\n"
15001 msgstr ""
15002 " part-disk пристрій тип_розділу\n"
15003 "\n"
15004
15005 #. type: textblock
15006 #: ../fish/guestfish-actions.pod:3777
15007 msgid ""
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."
15010 msgstr ""
15011
15012 #. type: textblock
15013 #: ../fish/guestfish-actions.pod:3781
15014 msgid ""
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>."
15017 msgstr ""
15018
15019 #. type: =head2
15020 #: ../fish/guestfish-actions.pod:3784
15021 msgid "part-get-bootable"
15022 msgstr "part-get-bootable"
15023
15024 #. type: verbatim
15025 #: ../fish/guestfish-actions.pod:3786
15026 #, no-wrap
15027 msgid ""
15028 " part-get-bootable device partnum\n"
15029 "\n"
15030 msgstr ""
15031
15032 #. type: textblock
15033 #: ../fish/guestfish-actions.pod:3788 ../src/guestfs-actions.pod:5928
15034 msgid ""
15035 "This command returns true if the partition C<partnum> on C<device> has the "
15036 "bootable flag set."
15037 msgstr ""
15038
15039 #. type: textblock
15040 #: ../fish/guestfish-actions.pod:3791
15041 msgid "See also L</part-set-bootable>."
15042 msgstr "Див. також L</part-set-bootable>."
15043
15044 #. type: =head2
15045 #: ../fish/guestfish-actions.pod:3793
15046 msgid "part-get-mbr-id"
15047 msgstr "part-get-mbr-id"
15048
15049 #. type: verbatim
15050 #: ../fish/guestfish-actions.pod:3795
15051 #, no-wrap
15052 msgid ""
15053 " part-get-mbr-id device partnum\n"
15054 "\n"
15055 msgstr ""
15056
15057 #. type: textblock
15058 #: ../fish/guestfish-actions.pod:3797 ../src/guestfs-actions.pod:5944
15059 msgid ""
15060 "Returns the MBR type byte (also known as the ID byte) from the numbered "
15061 "partition C<partnum>."
15062 msgstr ""
15063
15064 #. type: textblock
15065 #: ../fish/guestfish-actions.pod:3800 ../fish/guestfish-actions.pod:3944
15066 msgid ""
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-"
15069 "parttype>)."
15070 msgstr ""
15071
15072 #. type: =head2
15073 #: ../fish/guestfish-actions.pod:3804
15074 msgid "part-get-parttype"
15075 msgstr "part-get-parttype"
15076
15077 #. type: verbatim
15078 #: ../fish/guestfish-actions.pod:3806
15079 #, no-wrap
15080 msgid ""
15081 " part-get-parttype device\n"
15082 "\n"
15083 msgstr ""
15084 " part-get-parttype пристрій\n"
15085 "\n"
15086
15087 #. type: textblock
15088 #: ../fish/guestfish-actions.pod:3808 ../src/guestfs-actions.pod:5961
15089 msgid ""
15090 "This command examines the partition table on C<device> and returns the "
15091 "partition table type (format) being used."
15092 msgstr ""
15093
15094 #. type: textblock
15095 #: ../fish/guestfish-actions.pod:3811
15096 msgid ""
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."
15100 msgstr ""
15101
15102 #. type: =head2
15103 #: ../fish/guestfish-actions.pod:3816
15104 msgid "part-init"
15105 msgstr "part-init"
15106
15107 #. type: verbatim
15108 #: ../fish/guestfish-actions.pod:3818
15109 #, no-wrap
15110 msgid ""
15111 " part-init device parttype\n"
15112 "\n"
15113 msgstr ""
15114
15115 #. type: textblock
15116 #: ../fish/guestfish-actions.pod:3820 ../src/guestfs-actions.pod:5981
15117 msgid ""
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)."
15121 msgstr ""
15122
15123 #. type: textblock
15124 #: ../fish/guestfish-actions.pod:3824
15125 msgid ""
15126 "Initially there are no partitions.  Following this, you should call L</part-"
15127 "add> for each partition required."
15128 msgstr ""
15129
15130 #. type: textblock
15131 #: ../fish/guestfish-actions.pod:3827 ../src/guestfs-actions.pod:5988
15132 msgid "Possible values for C<parttype> are:"
15133 msgstr ""
15134
15135 #. type: =item
15136 #: ../fish/guestfish-actions.pod:3831 ../src/guestfs-actions.pod:5992
15137 msgid "B<efi>"
15138 msgstr "B<efi>"
15139
15140 #. type: =item
15141 #: ../fish/guestfish-actions.pod:3833 ../src/guestfs-actions.pod:5994
15142 msgid "B<gpt>"
15143 msgstr "B<gpt>"
15144
15145 #. type: textblock
15146 #: ../fish/guestfish-actions.pod:3835 ../src/guestfs-actions.pod:5996
15147 msgid "Intel EFI / GPT partition table."
15148 msgstr ""
15149
15150 #. type: textblock
15151 #: ../fish/guestfish-actions.pod:3837 ../src/guestfs-actions.pod:5998
15152 msgid ""
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."
15156 msgstr ""
15157
15158 #. type: =item
15159 #: ../fish/guestfish-actions.pod:3841 ../src/guestfs-actions.pod:6002
15160 msgid "B<mbr>"
15161 msgstr "B<mbr>"
15162
15163 #. type: =item
15164 #: ../fish/guestfish-actions.pod:3843 ../src/guestfs-actions.pod:6004
15165 msgid "B<msdos>"
15166 msgstr "B<msdos>"
15167
15168 #. type: textblock
15169 #: ../fish/guestfish-actions.pod:3845 ../src/guestfs-actions.pod:6006
15170 msgid ""
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>."
15174 msgstr ""
15175
15176 #. type: textblock
15177 #: ../fish/guestfish-actions.pod:3852 ../src/guestfs-actions.pod:6013
15178 msgid ""
15179 "Other partition table types that may work but are not supported include:"
15180 msgstr ""
15181
15182 #. type: =item
15183 #: ../fish/guestfish-actions.pod:3857 ../src/guestfs-actions.pod:6018
15184 msgid "B<aix>"
15185 msgstr "B<aix>"
15186
15187 #. type: textblock
15188 #: ../fish/guestfish-actions.pod:3859 ../src/guestfs-actions.pod:6020
15189 msgid "AIX disk labels."
15190 msgstr "Мітки дисків AIX."
15191
15192 #. type: =item
15193 #: ../fish/guestfish-actions.pod:3861 ../src/guestfs-actions.pod:6022
15194 msgid "B<amiga>"
15195 msgstr "B<amiga>"
15196
15197 #. type: =item
15198 #: ../fish/guestfish-actions.pod:3863 ../src/guestfs-actions.pod:6024
15199 msgid "B<rdb>"
15200 msgstr "B<rdb>"
15201
15202 #. type: textblock
15203 #: ../fish/guestfish-actions.pod:3865 ../src/guestfs-actions.pod:6026
15204 msgid "Amiga \"Rigid Disk Block\" format."
15205 msgstr "Формат \"Rigid Disk Block\" Amiga."
15206
15207 #. type: =item
15208 #: ../fish/guestfish-actions.pod:3867 ../src/guestfs-actions.pod:6028
15209 msgid "B<bsd>"
15210 msgstr "B<bsd>"
15211
15212 #. type: textblock
15213 #: ../fish/guestfish-actions.pod:3869 ../src/guestfs-actions.pod:6030
15214 msgid "BSD disk labels."
15215 msgstr "Мітки дисків BSD."
15216
15217 #. type: =item
15218 #: ../fish/guestfish-actions.pod:3871 ../src/guestfs-actions.pod:6032
15219 msgid "B<dasd>"
15220 msgstr "B<dasd>"
15221
15222 #. type: textblock
15223 #: ../fish/guestfish-actions.pod:3873 ../src/guestfs-actions.pod:6034
15224 msgid "DASD, used on IBM mainframes."
15225 msgstr "DASD, використовувалися у мейнфреймах IBM."
15226
15227 #. type: =item
15228 #: ../fish/guestfish-actions.pod:3875 ../src/guestfs-actions.pod:6036
15229 msgid "B<dvh>"
15230 msgstr "B<dvh>"
15231
15232 #. type: textblock
15233 #: ../fish/guestfish-actions.pod:3877 ../src/guestfs-actions.pod:6038
15234 msgid "MIPS/SGI volumes."
15235 msgstr "Томи MIPS/SGI."
15236
15237 #. type: =item
15238 #: ../fish/guestfish-actions.pod:3879 ../src/guestfs-actions.pod:6040
15239 msgid "B<mac>"
15240 msgstr "B<mac>"
15241
15242 #. type: textblock
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>."
15246
15247 #. type: =item
15248 #: ../fish/guestfish-actions.pod:3883 ../src/guestfs-actions.pod:6044
15249 msgid "B<pc98>"
15250 msgstr "B<pc98>"
15251
15252 #. type: textblock
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, поширений у Японії."
15256
15257 #. type: =item
15258 #: ../fish/guestfish-actions.pod:3887 ../src/guestfs-actions.pod:6048
15259 msgid "B<sun>"
15260 msgstr "B<sun>"
15261
15262 #. type: textblock
15263 #: ../fish/guestfish-actions.pod:3889 ../src/guestfs-actions.pod:6050
15264 msgid "Sun disk labels."
15265 msgstr "Мітки дисків Sun."
15266
15267 #. type: =head2
15268 #: ../fish/guestfish-actions.pod:3893
15269 msgid "part-list"
15270 msgstr "part-list"
15271
15272 #. type: verbatim
15273 #: ../fish/guestfish-actions.pod:3895
15274 #, no-wrap
15275 msgid ""
15276 " part-list device\n"
15277 "\n"
15278 msgstr ""
15279 " part-list device\n"
15280 "\n"
15281
15282 #. type: textblock
15283 #: ../fish/guestfish-actions.pod:3897 ../src/guestfs-actions.pod:6064
15284 msgid ""
15285 "This command parses the partition table on C<device> and returns the list of "
15286 "partitions found."
15287 msgstr ""
15288
15289 #. type: textblock
15290 #: ../fish/guestfish-actions.pod:3900 ../src/guestfs-actions.pod:6067
15291 msgid "The fields in the returned structure are:"
15292 msgstr ""
15293
15294 #. type: =item
15295 #: ../fish/guestfish-actions.pod:3904 ../src/guestfs-actions.pod:6071
15296 msgid "B<part_num>"
15297 msgstr "B<part_num>"
15298
15299 #. type: textblock
15300 #: ../fish/guestfish-actions.pod:3906 ../src/guestfs-actions.pod:6073
15301 msgid "Partition number, counting from 1."
15302 msgstr ""
15303
15304 #. type: =item
15305 #: ../fish/guestfish-actions.pod:3908 ../src/guestfs-actions.pod:6075
15306 msgid "B<part_start>"
15307 msgstr "B<part_start>"
15308
15309 #. type: textblock
15310 #: ../fish/guestfish-actions.pod:3910
15311 msgid ""
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>."
15314 msgstr ""
15315
15316 #. type: =item
15317 #: ../fish/guestfish-actions.pod:3913 ../src/guestfs-actions.pod:6080
15318 msgid "B<part_end>"
15319 msgstr "B<part_end>"
15320
15321 #. type: textblock
15322 #: ../fish/guestfish-actions.pod:3915 ../src/guestfs-actions.pod:6082
15323 msgid "End of the partition in bytes."
15324 msgstr ""
15325
15326 #. type: =item
15327 #: ../fish/guestfish-actions.pod:3917 ../src/guestfs-actions.pod:6084
15328 msgid "B<part_size>"
15329 msgstr "B<part_size>"
15330
15331 #. type: textblock
15332 #: ../fish/guestfish-actions.pod:3919 ../src/guestfs-actions.pod:6086
15333 msgid "Size of the partition in bytes."
15334 msgstr ""
15335
15336 #. type: =head2
15337 #: ../fish/guestfish-actions.pod:3923
15338 msgid "part-set-bootable"
15339 msgstr "part-set-bootable"
15340
15341 #. type: verbatim
15342 #: ../fish/guestfish-actions.pod:3925
15343 #, no-wrap
15344 msgid ""
15345 " part-set-bootable device partnum true|false\n"
15346 "\n"
15347 msgstr ""
15348
15349 #. type: textblock
15350 #: ../fish/guestfish-actions.pod:3927 ../src/guestfs-actions.pod:6104
15351 msgid ""
15352 "This sets the bootable flag on partition numbered C<partnum> on device "
15353 "C<device>.  Note that partitions are numbered from 1."
15354 msgstr ""
15355
15356 #. type: textblock
15357 #: ../fish/guestfish-actions.pod:3930 ../src/guestfs-actions.pod:6107
15358 msgid ""
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 "
15361 "recognized."
15362 msgstr ""
15363
15364 #. type: =head2
15365 #: ../fish/guestfish-actions.pod:3934
15366 msgid "part-set-mbr-id"
15367 msgstr "part-set-mbr-id"
15368
15369 #. type: verbatim
15370 #: ../fish/guestfish-actions.pod:3936
15371 #, no-wrap
15372 msgid ""
15373 " part-set-mbr-id device partnum idbyte\n"
15374 "\n"
15375 msgstr ""
15376
15377 #. type: textblock
15378 #: ../fish/guestfish-actions.pod:3938 ../src/guestfs-actions.pod:6123
15379 msgid ""
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."
15384 msgstr ""
15385
15386 #. type: =head2
15387 #: ../fish/guestfish-actions.pod:3948
15388 msgid "part-set-name"
15389 msgstr "part-set-name"
15390
15391 #. type: verbatim
15392 #: ../fish/guestfish-actions.pod:3950
15393 #, no-wrap
15394 msgid ""
15395 " part-set-name device partnum name\n"
15396 "\n"
15397 msgstr ""
15398
15399 #. type: textblock
15400 #: ../fish/guestfish-actions.pod:3952 ../src/guestfs-actions.pod:6145
15401 msgid ""
15402 "This sets the partition name on partition numbered C<partnum> on device "
15403 "C<device>.  Note that partitions are numbered from 1."
15404 msgstr ""
15405
15406 #. type: textblock
15407 #: ../fish/guestfish-actions.pod:3955 ../src/guestfs-actions.pod:6148
15408 msgid ""
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."
15411 msgstr ""
15412
15413 #. type: =head2
15414 #: ../fish/guestfish-actions.pod:3958
15415 msgid "part-to-dev"
15416 msgstr "part-to-dev"
15417
15418 #. type: verbatim
15419 #: ../fish/guestfish-actions.pod:3960
15420 #, no-wrap
15421 msgid ""
15422 " part-to-dev partition\n"
15423 "\n"
15424 msgstr ""
15425 " part-to-dev розділ\n"
15426 "\n"
15427
15428 #. type: textblock
15429 #: ../fish/guestfish-actions.pod:3962 ../src/guestfs-actions.pod:6161
15430 msgid ""
15431 "This function takes a partition name (eg. \"/dev/sdb1\") and removes the "
15432 "partition number, returning the device name (eg. \"/dev/sdb\")."
15433 msgstr ""
15434
15435 #. type: textblock
15436 #: ../fish/guestfish-actions.pod:3966 ../fish/guestfish-actions.pod:3978
15437 msgid ""
15438 "The named partition must exist, for example as a string returned from L</"
15439 "list-partitions>."
15440 msgstr ""
15441
15442 #. type: textblock
15443 #: ../fish/guestfish-actions.pod:3969
15444 msgid "See also L</part-to-partnum>."
15445 msgstr ""
15446
15447 #. type: =head2
15448 #: ../fish/guestfish-actions.pod:3971
15449 msgid "part-to-partnum"
15450 msgstr ""
15451
15452 #. type: verbatim
15453 #: ../fish/guestfish-actions.pod:3973
15454 #, no-wrap
15455 msgid ""
15456 " part-to-partnum partition\n"
15457 "\n"
15458 msgstr ""
15459
15460 #. type: textblock
15461 #: ../fish/guestfish-actions.pod:3975 ../src/guestfs-actions.pod:6181
15462 msgid ""
15463 "This function takes a partition name (eg. \"/dev/sdb1\") and returns the "
15464 "partition number (eg. C<1>)."
15465 msgstr ""
15466
15467 #. type: textblock
15468 #: ../fish/guestfish-actions.pod:3981
15469 msgid "See also L</part-to-dev>."
15470 msgstr ""
15471
15472 #. type: =head2
15473 #: ../fish/guestfish-actions.pod:3983
15474 msgid "ping-daemon"
15475 msgstr "ping-daemon"
15476
15477 #. type: verbatim
15478 #: ../fish/guestfish-actions.pod:3985
15479 #, no-wrap
15480 msgid ""
15481 " ping-daemon\n"
15482 "\n"
15483 msgstr ""
15484 " ping-daemon\n"
15485 "\n"
15486
15487 #. type: textblock
15488 #: ../fish/guestfish-actions.pod:3987 ../src/guestfs-actions.pod:6198
15489 msgid ""
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 "
15493 "any other way."
15494 msgstr ""
15495
15496 #. type: =head2
15497 #: ../fish/guestfish-actions.pod:3992
15498 msgid "pread"
15499 msgstr "pread"
15500
15501 #. type: verbatim
15502 #: ../fish/guestfish-actions.pod:3994
15503 #, no-wrap
15504 msgid ""
15505 " pread path count offset\n"
15506 "\n"
15507 msgstr ""
15508
15509 #. type: textblock
15510 #: ../fish/guestfish-actions.pod:3996 ../src/guestfs-actions.pod:6216
15511 msgid ""
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>."
15514 msgstr ""
15515
15516 #. type: textblock
15517 #: ../fish/guestfish-actions.pod:3999 ../fish/guestfish-actions.pod:4014
15518 #: ../src/guestfs-actions.pod:6219 ../src/guestfs-actions.pod:6245
15519 msgid ""
15520 "This may read fewer bytes than requested.  For further details see the "
15521 "L<pread(2)> system call."
15522 msgstr ""
15523
15524 #. type: textblock
15525 #: ../fish/guestfish-actions.pod:4002
15526 msgid "See also L</pwrite>, L</pread-device>."
15527 msgstr "Див. також L</pwrite>, L</pread-device>."
15528
15529 #. type: =head2
15530 #: ../fish/guestfish-actions.pod:4007
15531 msgid "pread-device"
15532 msgstr "pread-device"
15533
15534 #. type: verbatim
15535 #: ../fish/guestfish-actions.pod:4009
15536 #, no-wrap
15537 msgid ""
15538 " pread-device device count offset\n"
15539 "\n"
15540 msgstr ""
15541
15542 #. type: textblock
15543 #: ../fish/guestfish-actions.pod:4011 ../src/guestfs-actions.pod:6242
15544 msgid ""
15545 "This command lets you read part of a file.  It reads C<count> bytes of "
15546 "C<device>, starting at C<offset>."
15547 msgstr ""
15548
15549 #. type: textblock
15550 #: ../fish/guestfish-actions.pod:4017
15551 msgid "See also L</pread>."
15552 msgstr "Див. також L</pread>."
15553
15554 #. type: =head2
15555 #: ../fish/guestfish-actions.pod:4022
15556 msgid "pvcreate"
15557 msgstr "pvcreate"
15558
15559 #. type: verbatim
15560 #: ../fish/guestfish-actions.pod:4024
15561 #, no-wrap
15562 msgid ""
15563 " pvcreate device\n"
15564 "\n"
15565 msgstr ""
15566 " pvcreate пристрій\n"
15567 "\n"
15568
15569 #. type: textblock
15570 #: ../fish/guestfish-actions.pod:4026 ../src/guestfs-actions.pod:6265
15571 msgid ""
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>."
15574 msgstr ""
15575
15576 #. type: =head2
15577 #: ../fish/guestfish-actions.pod:4030
15578 msgid "pvremove"
15579 msgstr "pvremove"
15580
15581 #. type: verbatim
15582 #: ../fish/guestfish-actions.pod:4032
15583 #, no-wrap
15584 msgid ""
15585 " pvremove device\n"
15586 "\n"
15587 msgstr ""
15588 " pvremove пристрій\n"
15589 "\n"
15590
15591 #. type: textblock
15592 #: ../fish/guestfish-actions.pod:4034 ../src/guestfs-actions.pod:6279
15593 msgid ""
15594 "This wipes a physical volume C<device> so that LVM will no longer recognise "
15595 "it."
15596 msgstr ""
15597
15598 #. type: textblock
15599 #: ../fish/guestfish-actions.pod:4037 ../src/guestfs-actions.pod:6282
15600 msgid ""
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 "
15603 "first."
15604 msgstr ""
15605
15606 #. type: =head2
15607 #: ../fish/guestfish-actions.pod:4041
15608 msgid "pvresize"
15609 msgstr "pvresize"
15610
15611 #. type: verbatim
15612 #: ../fish/guestfish-actions.pod:4043
15613 #, no-wrap
15614 msgid ""
15615 " pvresize device\n"
15616 "\n"
15617 msgstr ""
15618 " pvresize пристрій\n"
15619 "\n"
15620
15621 #. type: textblock
15622 #: ../fish/guestfish-actions.pod:4045 ../src/guestfs-actions.pod:6296
15623 msgid ""
15624 "This resizes (expands or shrinks) an existing LVM physical volume to match "
15625 "the new size of the underlying device."
15626 msgstr ""
15627
15628 #. type: =head2
15629 #: ../fish/guestfish-actions.pod:4048
15630 msgid "pvresize-size"
15631 msgstr "pvresize-size"
15632
15633 #. type: verbatim
15634 #: ../fish/guestfish-actions.pod:4050
15635 #, no-wrap
15636 msgid ""
15637 " pvresize-size device size\n"
15638 "\n"
15639 msgstr ""
15640
15641 #. type: textblock
15642 #: ../fish/guestfish-actions.pod:4052
15643 msgid ""
15644 "This command is the same as L</pvresize> except that it allows you to "
15645 "specify the new size (in bytes) explicitly."
15646 msgstr ""
15647
15648 #. type: =head2
15649 #: ../fish/guestfish-actions.pod:4055
15650 msgid "pvs"
15651 msgstr "pvs"
15652
15653 #. type: verbatim
15654 #: ../fish/guestfish-actions.pod:4057
15655 #, no-wrap
15656 msgid ""
15657 " pvs\n"
15658 "\n"
15659 msgstr ""
15660 " pvs\n"
15661 "\n"
15662
15663 #. type: textblock
15664 #: ../fish/guestfish-actions.pod:4059 ../src/guestfs-actions.pod:6322
15665 msgid ""
15666 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
15667 "(8)> command."
15668 msgstr ""
15669
15670 #. type: textblock
15671 #: ../fish/guestfish-actions.pod:4062 ../src/guestfs-actions.pod:6325
15672 msgid ""
15673 "This returns a list of just the device names that contain PVs (eg. C</dev/"
15674 "sda2>)."
15675 msgstr ""
15676
15677 #. type: textblock
15678 #: ../fish/guestfish-actions.pod:4065
15679 msgid "See also L</pvs-full>."
15680 msgstr "Див. також L</pvs-full>."
15681
15682 #. type: =head2
15683 #: ../fish/guestfish-actions.pod:4067
15684 msgid "pvs-full"
15685 msgstr "pvs-full"
15686
15687 #. type: verbatim
15688 #: ../fish/guestfish-actions.pod:4069
15689 #, no-wrap
15690 msgid ""
15691 " pvs-full\n"
15692 "\n"
15693 msgstr ""
15694 " pvs-full\n"
15695 "\n"
15696
15697 #. type: textblock
15698 #: ../fish/guestfish-actions.pod:4071 ../src/guestfs-actions.pod:6341
15699 msgid ""
15700 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
15701 "(8)> command.  The \"full\" version includes all fields."
15702 msgstr ""
15703
15704 #. type: =head2
15705 #: ../fish/guestfish-actions.pod:4074
15706 msgid "pvuuid"
15707 msgstr "pvuuid"
15708
15709 #. type: verbatim
15710 #: ../fish/guestfish-actions.pod:4076
15711 #, no-wrap
15712 msgid ""
15713 " pvuuid device\n"
15714 "\n"
15715 msgstr ""
15716 " pvuuid пристрій\n"
15717 "\n"
15718
15719 #. type: textblock
15720 #: ../fish/guestfish-actions.pod:4078 ../src/guestfs-actions.pod:6356
15721 msgid "This command returns the UUID of the LVM PV C<device>."
15722 msgstr ""
15723
15724 #. type: =head2
15725 #: ../fish/guestfish-actions.pod:4080
15726 msgid "pwrite"
15727 msgstr "pwrite"
15728
15729 #. type: verbatim
15730 #: ../fish/guestfish-actions.pod:4082
15731 #, no-wrap
15732 msgid ""
15733 " pwrite path content offset\n"
15734 "\n"
15735 msgstr ""
15736
15737 #. type: textblock
15738 #: ../fish/guestfish-actions.pod:4084 ../src/guestfs-actions.pod:6372
15739 msgid ""
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>."
15742 msgstr ""
15743
15744 #. type: textblock
15745 #: ../fish/guestfish-actions.pod:4087 ../src/guestfs-actions.pod:6375
15746 msgid ""
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 "
15751 "circumstances."
15752 msgstr ""
15753
15754 #. type: textblock
15755 #: ../fish/guestfish-actions.pod:4093
15756 msgid "See also L</pread>, L</pwrite-device>."
15757 msgstr "Див. також L</pread>, L</pwrite-device>."
15758
15759 #. type: =head2
15760 #: ../fish/guestfish-actions.pod:4098
15761 msgid "pwrite-device"
15762 msgstr "pwrite-device"
15763
15764 #. type: verbatim
15765 #: ../fish/guestfish-actions.pod:4100
15766 #, no-wrap
15767 msgid ""
15768 " pwrite-device device content offset\n"
15769 "\n"
15770 msgstr ""
15771
15772 #. type: textblock
15773 #: ../fish/guestfish-actions.pod:4102 ../src/guestfs-actions.pod:6399
15774 msgid ""
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>."
15777 msgstr ""
15778
15779 #. type: textblock
15780 #: ../fish/guestfish-actions.pod:4105 ../src/guestfs-actions.pod:6402
15781 msgid ""
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)."
15785 msgstr ""
15786
15787 #. type: textblock
15788 #: ../fish/guestfish-actions.pod:4110
15789 msgid "See also L</pwrite>."
15790 msgstr "Див. також L</pwrite>."
15791
15792 #. type: =head2
15793 #: ../fish/guestfish-actions.pod:4115
15794 msgid "read-file"
15795 msgstr "read-file"
15796
15797 #. type: verbatim
15798 #: ../fish/guestfish-actions.pod:4117
15799 #, no-wrap
15800 msgid ""
15801 " read-file path\n"
15802 "\n"
15803 msgstr ""
15804 " read-file шлях\n"
15805 "\n"
15806
15807 #. type: textblock
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."
15810 msgstr ""
15811
15812 #. type: textblock
15813 #: ../fish/guestfish-actions.pod:4122
15814 msgid ""
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."
15818 msgstr ""
15819
15820 #. type: =head2
15821 #: ../fish/guestfish-actions.pod:4130
15822 msgid "read-lines"
15823 msgstr "read-lines"
15824
15825 #. type: verbatim
15826 #: ../fish/guestfish-actions.pod:4132
15827 #, no-wrap
15828 msgid ""
15829 " read-lines path\n"
15830 "\n"
15831 msgstr ""
15832 " read-lines шлях\n"
15833 "\n"
15834
15835 #. type: textblock
15836 #: ../fish/guestfish-actions.pod:4136 ../src/guestfs-actions.pod:6448
15837 msgid ""
15838 "The file contents are returned as a list of lines.  Trailing C<LF> and "
15839 "C<CRLF> character sequences are I<not> returned."
15840 msgstr ""
15841
15842 #. type: textblock
15843 #: ../fish/guestfish-actions.pod:4139
15844 msgid ""
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 "
15848 "interface."
15849 msgstr ""
15850
15851 #. type: =head2
15852 #: ../fish/guestfish-actions.pod:4144
15853 msgid "readdir"
15854 msgstr "readdir"
15855
15856 #. type: verbatim
15857 #: ../fish/guestfish-actions.pod:4146
15858 #, no-wrap
15859 msgid ""
15860 " readdir dir\n"
15861 "\n"
15862 msgstr ""
15863 " readdir каталог\n"
15864 "\n"
15865
15866 #. type: textblock
15867 #: ../fish/guestfish-actions.pod:4148 ../src/guestfs-actions.pod:6468
15868 msgid "This returns the list of directory entries in directory C<dir>."
15869 msgstr ""
15870
15871 #. type: textblock
15872 #: ../fish/guestfish-actions.pod:4150 ../src/guestfs-actions.pod:6470
15873 msgid ""
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 "
15876 "filesystem."
15877 msgstr ""
15878
15879 #. type: textblock
15880 #: ../fish/guestfish-actions.pod:4154 ../src/guestfs-actions.pod:6474
15881 msgid ""
15882 "Also this call returns basic file type information about each file.  The "
15883 "C<ftyp> field will contain one of the following characters:"
15884 msgstr ""
15885
15886 #. type: =item
15887 #: ../fish/guestfish-actions.pod:4159 ../src/guestfs-actions.pod:6479
15888 msgid "'b'"
15889 msgstr "'b'"
15890
15891 #. type: textblock
15892 #: ../fish/guestfish-actions.pod:4161 ../src/guestfs-actions.pod:6481
15893 msgid "Block special"
15894 msgstr "Блоковий особливий"
15895
15896 #. type: =item
15897 #: ../fish/guestfish-actions.pod:4163 ../src/guestfs-actions.pod:6483
15898 msgid "'c'"
15899 msgstr "'c'"
15900
15901 #. type: textblock
15902 #: ../fish/guestfish-actions.pod:4165 ../src/guestfs-actions.pod:6485
15903 msgid "Char special"
15904 msgstr "Символьний особливий"
15905
15906 #. type: =item
15907 #: ../fish/guestfish-actions.pod:4167 ../src/guestfs-actions.pod:6487
15908 msgid "'d'"
15909 msgstr "'d'"
15910
15911 #. type: textblock
15912 #: ../fish/guestfish-actions.pod:4169 ../src/guestfs-actions.pod:6489
15913 msgid "Directory"
15914 msgstr "Каталог"
15915
15916 #. type: =item
15917 #: ../fish/guestfish-actions.pod:4171 ../src/guestfs-actions.pod:6491
15918 msgid "'f'"
15919 msgstr "'f'"
15920
15921 #. type: textblock
15922 #: ../fish/guestfish-actions.pod:4173 ../src/guestfs-actions.pod:6493
15923 msgid "FIFO (named pipe)"
15924 msgstr "FIFO (іменований канал)"
15925
15926 #. type: =item
15927 #: ../fish/guestfish-actions.pod:4175 ../src/guestfs-actions.pod:6495
15928 msgid "'l'"
15929 msgstr "'l'"
15930
15931 #. type: textblock
15932 #: ../fish/guestfish-actions.pod:4177 ../src/guestfs-actions.pod:6497
15933 msgid "Symbolic link"
15934 msgstr "Символічне посилання"
15935
15936 #. type: =item
15937 #: ../fish/guestfish-actions.pod:4179 ../src/guestfs-actions.pod:6499
15938 msgid "'r'"
15939 msgstr "'r'"
15940
15941 #. type: textblock
15942 #: ../fish/guestfish-actions.pod:4181 ../src/guestfs-actions.pod:6501
15943 msgid "Regular file"
15944 msgstr "Звичайний файл"
15945
15946 #. type: =item
15947 #: ../fish/guestfish-actions.pod:4183 ../src/guestfs-actions.pod:6503
15948 msgid "'s'"
15949 msgstr "'s'"
15950
15951 #. type: textblock
15952 #: ../fish/guestfish-actions.pod:4185 ../src/guestfs-actions.pod:6505
15953 msgid "Socket"
15954 msgstr "Сокет"
15955
15956 #. type: =item
15957 #: ../fish/guestfish-actions.pod:4187 ../src/guestfs-actions.pod:6507
15958 msgid "'u'"
15959 msgstr "'u'"
15960
15961 #. type: textblock
15962 #: ../fish/guestfish-actions.pod:4189 ../src/guestfs-actions.pod:6509
15963 msgid "Unknown file type"
15964 msgstr "Невідомий тип файла"
15965
15966 #. type: =item
15967 #: ../fish/guestfish-actions.pod:4191 ../src/guestfs-actions.pod:6511
15968 msgid "'?'"
15969 msgstr ""
15970
15971 #. type: textblock
15972 #: ../fish/guestfish-actions.pod:4193 ../src/guestfs-actions.pod:6513
15973 msgid ""
15974 "The L<readdir(3)> call returned a C<d_type> field with an unexpected value"
15975 msgstr ""
15976
15977 #. type: textblock
15978 #: ../fish/guestfish-actions.pod:4198
15979 msgid ""
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>."
15983 msgstr ""
15984
15985 #. type: =head2
15986 #: ../fish/guestfish-actions.pod:4202
15987 msgid "readlink"
15988 msgstr "readlink"
15989
15990 #. type: verbatim
15991 #: ../fish/guestfish-actions.pod:4204
15992 #, no-wrap
15993 msgid ""
15994 " readlink path\n"
15995 "\n"
15996 msgstr ""
15997 " readlink шлях\n"
15998 "\n"
15999
16000 #. type: textblock
16001 #: ../fish/guestfish-actions.pod:4206 ../src/guestfs-actions.pod:6534
16002 msgid "This command reads the target of a symbolic link."
16003 msgstr ""
16004
16005 #. type: =head2
16006 #: ../fish/guestfish-actions.pod:4208
16007 msgid "readlinklist"
16008 msgstr "readlinklist"
16009
16010 #. type: verbatim
16011 #: ../fish/guestfish-actions.pod:4210
16012 #, no-wrap
16013 msgid ""
16014 " readlinklist path 'names ...'\n"
16015 "\n"
16016 msgstr ""
16017
16018 #. type: textblock
16019 #: ../fish/guestfish-actions.pod:4212 ../src/guestfs-actions.pod:6548
16020 msgid ""
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 "
16023 "this directory."
16024 msgstr ""
16025
16026 #. type: textblock
16027 #: ../fish/guestfish-actions.pod:4216 ../src/guestfs-actions.pod:6552
16028 msgid ""
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."
16031 msgstr ""
16032
16033 #. type: textblock
16034 #: ../fish/guestfish-actions.pod:4220 ../src/guestfs-actions.pod:6556
16035 msgid ""
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)."
16041 msgstr ""
16042
16043 #. type: textblock
16044 #: ../fish/guestfish-actions.pod:4227 ../src/guestfs-actions.pod:6563
16045 msgid ""
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."
16050 msgstr ""
16051
16052 #. type: =head2
16053 #: ../fish/guestfish-actions.pod:4234
16054 msgid "realpath"
16055 msgstr "realpath"
16056
16057 #. type: verbatim
16058 #: ../fish/guestfish-actions.pod:4236
16059 #, no-wrap
16060 msgid ""
16061 " realpath path\n"
16062 "\n"
16063 msgstr ""
16064 " realpath шлях\n"
16065 "\n"
16066
16067 #. type: textblock
16068 #: ../fish/guestfish-actions.pod:4238 ../src/guestfs-actions.pod:6582
16069 msgid ""
16070 "Return the canonicalized absolute pathname of C<path>.  The returned path "
16071 "has no C<.>, C<..> or symbolic link path elements."
16072 msgstr ""
16073
16074 #. type: =head2
16075 #: ../fish/guestfish-actions.pod:4241
16076 msgid "removexattr"
16077 msgstr "removexattr"
16078
16079 #. type: verbatim
16080 #: ../fish/guestfish-actions.pod:4243
16081 #, no-wrap
16082 msgid ""
16083 " removexattr xattr path\n"
16084 "\n"
16085 msgstr ""
16086
16087 #. type: textblock
16088 #: ../fish/guestfish-actions.pod:4245 ../src/guestfs-actions.pod:6597
16089 msgid ""
16090 "This call removes the extended attribute named C<xattr> of the file C<path>."
16091 msgstr ""
16092
16093 #. type: textblock
16094 #: ../fish/guestfish-actions.pod:4248
16095 msgid "See also: L</lremovexattr>, L<attr(5)>."
16096 msgstr "Див. також L</lremovexattr>, L<attr(5)>."
16097
16098 #. type: =head2
16099 #: ../fish/guestfish-actions.pod:4250
16100 msgid "resize2fs"
16101 msgstr "resize2fs"
16102
16103 #. type: verbatim
16104 #: ../fish/guestfish-actions.pod:4252
16105 #, no-wrap
16106 msgid ""
16107 " resize2fs device\n"
16108 "\n"
16109 msgstr ""
16110 " resize2fs пристрій\n"
16111 "\n"
16112
16113 #. type: textblock
16114 #: ../fish/guestfish-actions.pod:4254 ../src/guestfs-actions.pod:6612
16115 msgid ""
16116 "This resizes an ext2, ext3 or ext4 filesystem to match the size of the "
16117 "underlying device."
16118 msgstr ""
16119
16120 #. type: textblock
16121 #: ../fish/guestfish-actions.pod:4257
16122 msgid ""
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."
16127 msgstr ""
16128
16129 #. type: =head2
16130 #: ../fish/guestfish-actions.pod:4263
16131 msgid "resize2fs-M"
16132 msgstr "resize2fs-M"
16133
16134 #. type: verbatim
16135 #: ../fish/guestfish-actions.pod:4265
16136 #, no-wrap
16137 msgid ""
16138 " resize2fs-M device\n"
16139 "\n"
16140 msgstr ""
16141 " resize2fs-M пристрій\n"
16142 "\n"
16143
16144 #. type: textblock
16145 #: ../fish/guestfish-actions.pod:4267
16146 msgid ""
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> "
16149 "command."
16150 msgstr ""
16151
16152 #. type: textblock
16153 #: ../fish/guestfish-actions.pod:4271
16154 msgid ""
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 "
16158 "bytes."
16159 msgstr ""
16160
16161 #. type: =head2
16162 #: ../fish/guestfish-actions.pod:4276
16163 msgid "resize2fs-size"
16164 msgstr "resize2fs-size"
16165
16166 #. type: verbatim
16167 #: ../fish/guestfish-actions.pod:4278
16168 #, no-wrap
16169 msgid ""
16170 " resize2fs-size device size\n"
16171 "\n"
16172 msgstr ""
16173
16174 #. type: textblock
16175 #: ../fish/guestfish-actions.pod:4280
16176 msgid ""
16177 "This command is the same as L</resize2fs> except that it allows you to "
16178 "specify the new size (in bytes) explicitly."
16179 msgstr ""
16180
16181 #. type: =head2
16182 #: ../fish/guestfish-actions.pod:4283
16183 msgid "rm"
16184 msgstr "rm"
16185
16186 #. type: verbatim
16187 #: ../fish/guestfish-actions.pod:4285
16188 #, no-wrap
16189 msgid ""
16190 " rm path\n"
16191 "\n"
16192 msgstr ""
16193 " rm шлях\n"
16194 "\n"
16195
16196 #. type: textblock
16197 #: ../fish/guestfish-actions.pod:4287 ../src/guestfs-actions.pod:6664
16198 msgid "Remove the single file C<path>."
16199 msgstr ""
16200
16201 #. type: =head2
16202 #: ../fish/guestfish-actions.pod:4289
16203 msgid "rm-rf"
16204 msgstr "rm-rf"
16205
16206 #. type: verbatim
16207 #: ../fish/guestfish-actions.pod:4291
16208 #, no-wrap
16209 msgid ""
16210 " rm-rf path\n"
16211 "\n"
16212 msgstr ""
16213 " rm-rf шлях\n"
16214 "\n"
16215
16216 #. type: textblock
16217 #: ../fish/guestfish-actions.pod:4293 ../src/guestfs-actions.pod:6676
16218 msgid ""
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."
16221 msgstr ""
16222
16223 #. type: =head2
16224 #: ../fish/guestfish-actions.pod:4297
16225 msgid "rmdir"
16226 msgstr "rmdir"
16227
16228 #. type: verbatim
16229 #: ../fish/guestfish-actions.pod:4299
16230 #, no-wrap
16231 msgid ""
16232 " rmdir path\n"
16233 "\n"
16234 msgstr ""
16235 " rmdir шлях\n"
16236 "\n"
16237
16238 #. type: textblock
16239 #: ../fish/guestfish-actions.pod:4301 ../src/guestfs-actions.pod:6690
16240 msgid "Remove the single directory C<path>."
16241 msgstr ""
16242
16243 #. type: =head2
16244 #: ../fish/guestfish-actions.pod:4303
16245 msgid "rmmountpoint"
16246 msgstr "rmmountpoint"
16247
16248 #. type: verbatim
16249 #: ../fish/guestfish-actions.pod:4305
16250 #, no-wrap
16251 msgid ""
16252 " rmmountpoint exemptpath\n"
16253 "\n"
16254 msgstr ""
16255
16256 #. type: textblock
16257 #: ../fish/guestfish-actions.pod:4307
16258 msgid ""
16259 "This calls removes a mountpoint that was previously created with L</"
16260 "mkmountpoint>.  See L</mkmountpoint> for full details."
16261 msgstr ""
16262
16263 #. type: =head2
16264 #: ../fish/guestfish-actions.pod:4311
16265 msgid "scrub-device"
16266 msgstr "scrub-device"
16267
16268 #. type: verbatim
16269 #: ../fish/guestfish-actions.pod:4313
16270 #, no-wrap
16271 msgid ""
16272 " scrub-device device\n"
16273 "\n"
16274 msgstr ""
16275 " scrub-device пристрій\n"
16276 "\n"
16277
16278 #. type: textblock
16279 #: ../fish/guestfish-actions.pod:4315 ../src/guestfs-actions.pod:6716
16280 msgid ""
16281 "This command writes patterns over C<device> to make data retrieval more "
16282 "difficult."
16283 msgstr ""
16284
16285 #. type: textblock
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
16289 msgid ""
16290 "It is an interface to the L<scrub(1)> program.  See that manual page for "
16291 "more details."
16292 msgstr ""
16293
16294 #. type: =head2
16295 #: ../fish/guestfish-actions.pod:4321
16296 msgid "scrub-file"
16297 msgstr "scrub-file"
16298
16299 #. type: verbatim
16300 #: ../fish/guestfish-actions.pod:4323
16301 #, no-wrap
16302 msgid ""
16303 " scrub-file file\n"
16304 "\n"
16305 msgstr ""
16306 " scrub-file файл\n"
16307 "\n"
16308
16309 #. type: textblock
16310 #: ../fish/guestfish-actions.pod:4325 ../src/guestfs-actions.pod:6732
16311 msgid ""
16312 "This command writes patterns over a file to make data retrieval more "
16313 "difficult."
16314 msgstr ""
16315
16316 #. type: textblock
16317 #: ../fish/guestfish-actions.pod:4328 ../src/guestfs-actions.pod:6735
16318 msgid "The file is I<removed> after scrubbing."
16319 msgstr ""
16320
16321 #. type: =head2
16322 #: ../fish/guestfish-actions.pod:4333
16323 msgid "scrub-freespace"
16324 msgstr "scrub-freespace"
16325
16326 #. type: verbatim
16327 #: ../fish/guestfish-actions.pod:4335
16328 #, no-wrap
16329 msgid ""
16330 " scrub-freespace dir\n"
16331 "\n"
16332 msgstr ""
16333 " scrub-freespace каталог\n"
16334 "\n"
16335
16336 #. type: textblock
16337 #: ../fish/guestfish-actions.pod:4337
16338 msgid ""
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>."
16343 msgstr ""
16344
16345 #. type: =head2
16346 #: ../fish/guestfish-actions.pod:4346
16347 msgid "set-append"
16348 msgstr "set-append"
16349
16350 #. type: =head2
16351 #: ../fish/guestfish-actions.pod:4348
16352 msgid "append"
16353 msgstr ""
16354
16355 #. type: verbatim
16356 #: ../fish/guestfish-actions.pod:4350
16357 #, no-wrap
16358 msgid ""
16359 " set-append append\n"
16360 "\n"
16361 msgstr ""
16362
16363 #. type: textblock
16364 #: ../fish/guestfish-actions.pod:4352 ../src/guestfs-actions.pod:6769
16365 msgid ""
16366 "This function is used to add additional options to the guest kernel command "
16367 "line."
16368 msgstr ""
16369
16370 #. type: textblock
16371 #: ../fish/guestfish-actions.pod:4355 ../src/guestfs-actions.pod:6772
16372 msgid ""
16373 "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> "
16374 "environment variable."
16375 msgstr ""
16376
16377 #. type: textblock
16378 #: ../fish/guestfish-actions.pod:4358 ../src/guestfs-actions.pod:6775
16379 msgid ""
16380 "Setting C<append> to C<NULL> means I<no> additional options are passed "
16381 "(libguestfs always adds a few of its own)."
16382 msgstr ""
16383
16384 #. type: =head2
16385 #: ../fish/guestfish-actions.pod:4361
16386 msgid "set-attach-method"
16387 msgstr "set-attach-method"
16388
16389 #. type: =head2
16390 #: ../fish/guestfish-actions.pod:4363
16391 msgid "attach-method"
16392 msgstr ""
16393
16394 #. type: verbatim
16395 #: ../fish/guestfish-actions.pod:4365
16396 #, no-wrap
16397 msgid ""
16398 " set-attach-method attachmethod\n"
16399 "\n"
16400 msgstr ""
16401
16402 #. type: textblock
16403 #: ../fish/guestfish-actions.pod:4367 ../src/guestfs-actions.pod:6788
16404 msgid ""
16405 "Set the method that libguestfs uses to connect to the back end guestfsd "
16406 "daemon.  Possible methods are:"
16407 msgstr ""
16408
16409 #. type: =item
16410 #: ../fish/guestfish-actions.pod:4372 ../src/guestfs-actions.pod:6793
16411 #: ../src/guestfs.pod:2916
16412 msgid "C<appliance>"
16413 msgstr "C<appliance>"
16414
16415 #. type: textblock
16416 #: ../fish/guestfish-actions.pod:4374 ../src/guestfs-actions.pod:6795
16417 msgid ""
16418 "Launch an appliance and connect to it.  This is the ordinary method and the "
16419 "default."
16420 msgstr ""
16421
16422 #. type: =item
16423 #: ../fish/guestfish-actions.pod:4377 ../src/guestfs-actions.pod:6798
16424 msgid "C<unix:I<path>>"
16425 msgstr "C<unix:I<шлях>>"
16426
16427 #. type: textblock
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<шлях>."
16431
16432 #. type: textblock
16433 #: ../fish/guestfish-actions.pod:4381 ../src/guestfs-actions.pod:6802
16434 msgid ""
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>."
16438 msgstr ""
16439
16440 #. type: =head2
16441 #: ../fish/guestfish-actions.pod:4387
16442 msgid "set-autosync"
16443 msgstr "set-autosync"
16444
16445 #. type: =head2
16446 #: ../fish/guestfish-actions.pod:4389
16447 msgid "autosync"
16448 msgstr "autosync"
16449
16450 #. type: verbatim
16451 #: ../fish/guestfish-actions.pod:4391
16452 #, no-wrap
16453 msgid ""
16454 " set-autosync true|false\n"
16455 "\n"
16456 msgstr ""
16457 " set-autosync true|false\n"
16458 "\n"
16459
16460 #. type: textblock
16461 #: ../fish/guestfish-actions.pod:4393 ../src/guestfs-actions.pod:6818
16462 msgid ""
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)."
16466 msgstr ""
16467
16468 #. type: textblock
16469 #: ../fish/guestfish-actions.pod:4398 ../src/guestfs-actions.pod:6823
16470 msgid ""
16471 "This is enabled by default (since libguestfs 1.5.24, previously it was "
16472 "disabled by default)."
16473 msgstr ""
16474
16475 #. type: =head2
16476 #: ../fish/guestfish-actions.pod:4401
16477 msgid "set-direct"
16478 msgstr "set-direct"
16479
16480 #. type: =head2
16481 #: ../fish/guestfish-actions.pod:4403
16482 msgid "direct"
16483 msgstr "direct"
16484
16485 #. type: verbatim
16486 #: ../fish/guestfish-actions.pod:4405
16487 #, no-wrap
16488 msgid ""
16489 " set-direct true|false\n"
16490 "\n"
16491 msgstr ""
16492 " set-direct true|false\n"
16493 "\n"
16494
16495 #. type: textblock
16496 #: ../fish/guestfish-actions.pod:4407 ../src/guestfs-actions.pod:6836
16497 msgid ""
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."
16500 msgstr ""
16501
16502 #. type: textblock
16503 #: ../fish/guestfish-actions.pod:4411
16504 msgid ""
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."
16507 msgstr ""
16508
16509 #. type: textblock
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."
16512 msgstr ""
16513
16514 #. type: textblock
16515 #: ../fish/guestfish-actions.pod:4418 ../src/guestfs-actions.pod:6847
16516 msgid "The default is disabled."
16517 msgstr ""
16518
16519 #. type: =head2
16520 #: ../fish/guestfish-actions.pod:4420
16521 msgid "set-e2label"
16522 msgstr "set-e2label"
16523
16524 #. type: verbatim
16525 #: ../fish/guestfish-actions.pod:4422
16526 #, no-wrap
16527 msgid ""
16528 " set-e2label device label\n"
16529 "\n"
16530 msgstr ""
16531
16532 #. type: textblock
16533 #: ../fish/guestfish-actions.pod:4424 ../src/guestfs-actions.pod:6860
16534 msgid ""
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."
16537 msgstr ""
16538
16539 #. type: textblock
16540 #: ../fish/guestfish-actions.pod:4428
16541 msgid ""
16542 "You can use either L</tune2fs-l> or L</get-e2label> to return the existing "
16543 "label on a filesystem."
16544 msgstr ""
16545
16546 #. type: =head2
16547 #: ../fish/guestfish-actions.pod:4431
16548 msgid "set-e2uuid"
16549 msgstr "set-e2uuid"
16550
16551 #. type: verbatim
16552 #: ../fish/guestfish-actions.pod:4433
16553 #, no-wrap
16554 msgid ""
16555 " set-e2uuid device uuid\n"
16556 "\n"
16557 msgstr ""
16558
16559 #. type: textblock
16560 #: ../fish/guestfish-actions.pod:4435 ../src/guestfs-actions.pod:6878
16561 msgid ""
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."
16565 msgstr ""
16566
16567 #. type: textblock
16568 #: ../fish/guestfish-actions.pod:4440
16569 msgid ""
16570 "You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing "
16571 "UUID of a filesystem."
16572 msgstr ""
16573
16574 #. type: =head2
16575 #: ../fish/guestfish-actions.pod:4443
16576 msgid "set-memsize"
16577 msgstr "set-memsize"
16578
16579 #. type: =head2
16580 #: ../fish/guestfish-actions.pod:4445
16581 msgid "memsize"
16582 msgstr ""
16583
16584 #. type: verbatim
16585 #: ../fish/guestfish-actions.pod:4447
16586 #, no-wrap
16587 msgid ""
16588 " set-memsize memsize\n"
16589 "\n"
16590 msgstr ""
16591
16592 #. type: textblock
16593 #: ../fish/guestfish-actions.pod:4449
16594 msgid ""
16595 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
16596 "This only has any effect if called before L</launch>."
16597 msgstr ""
16598
16599 #. type: textblock
16600 #: ../fish/guestfish-actions.pod:4453 ../src/guestfs-actions.pod:6900
16601 msgid ""
16602 "You can also change this by setting the environment variable "
16603 "C<LIBGUESTFS_MEMSIZE> before the handle is created."
16604 msgstr ""
16605
16606 #. type: =head2
16607 #: ../fish/guestfish-actions.pod:4460
16608 msgid "set-network"
16609 msgstr "set-network"
16610
16611 #. type: =head2
16612 #: ../fish/guestfish-actions.pod:4462
16613 msgid "network"
16614 msgstr "network"
16615
16616 #. type: verbatim
16617 #: ../fish/guestfish-actions.pod:4464
16618 #, no-wrap
16619 msgid ""
16620 " set-network true|false\n"
16621 "\n"
16622 msgstr ""
16623 " set-network true|false\n"
16624 "\n"
16625
16626 #. type: textblock
16627 #: ../fish/guestfish-actions.pod:4466 ../src/guestfs-actions.pod:6917
16628 msgid ""
16629 "If C<network> is true, then the network is enabled in the libguestfs "
16630 "appliance.  The default is false."
16631 msgstr ""
16632
16633 #. type: textblock
16634 #: ../fish/guestfish-actions.pod:4469 ../src/guestfs-actions.pod:6920
16635 msgid ""
16636 "This affects whether commands are able to access the network (see L<guestfs"
16637 "(3)/RUNNING COMMANDS>)."
16638 msgstr ""
16639
16640 #. type: textblock
16641 #: ../fish/guestfish-actions.pod:4472
16642 msgid ""
16643 "You must call this before calling L</launch>, otherwise it has no effect."
16644 msgstr ""
16645
16646 #. type: =head2
16647 #: ../fish/guestfish-actions.pod:4475
16648 msgid "set-path"
16649 msgstr "set-path"
16650
16651 #. type: verbatim
16652 #: ../fish/guestfish-actions.pod:4479
16653 #, no-wrap
16654 msgid ""
16655 " set-path searchpath\n"
16656 "\n"
16657 msgstr ""
16658
16659 #. type: textblock
16660 #: ../fish/guestfish-actions.pod:4481 ../src/guestfs-actions.pod:6936
16661 msgid "Set the path that libguestfs searches for kernel and initrd.img."
16662 msgstr ""
16663
16664 #. type: textblock
16665 #: ../fish/guestfish-actions.pod:4483 ../src/guestfs-actions.pod:6938
16666 msgid ""
16667 "The default is C<$libdir/guestfs> unless overridden by setting "
16668 "C<LIBGUESTFS_PATH> environment variable."
16669 msgstr ""
16670
16671 #. type: textblock
16672 #: ../fish/guestfish-actions.pod:4486 ../src/guestfs-actions.pod:6941
16673 msgid "Setting C<path> to C<NULL> restores the default path."
16674 msgstr ""
16675
16676 #. type: =head2
16677 #: ../fish/guestfish-actions.pod:4488
16678 msgid "set-pgroup"
16679 msgstr ""
16680
16681 #. type: =head2
16682 #: ../fish/guestfish-actions.pod:4490
16683 msgid "pgroup"
16684 msgstr ""
16685
16686 #. type: verbatim
16687 #: ../fish/guestfish-actions.pod:4492
16688 #, no-wrap
16689 msgid ""
16690 " set-pgroup true|false\n"
16691 "\n"
16692 msgstr ""
16693
16694 #. type: textblock
16695 #: ../fish/guestfish-actions.pod:4494 ../src/guestfs-actions.pod:6953
16696 msgid ""
16697 "If C<pgroup> is true, child processes are placed into their own process "
16698 "group."
16699 msgstr ""
16700
16701 #. type: textblock
16702 #: ../fish/guestfish-actions.pod:4497 ../src/guestfs-actions.pod:6956
16703 msgid ""
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."
16706 msgstr ""
16707
16708 #. type: textblock
16709 #: ../fish/guestfish-actions.pod:4500 ../src/guestfs-actions.pod:6959
16710 msgid ""
16711 "The default for this flag is false, because usually you want C<^C> to kill "
16712 "the subprocess."
16713 msgstr ""
16714
16715 #. type: =head2
16716 #: ../fish/guestfish-actions.pod:4503
16717 msgid "set-qemu"
16718 msgstr "set-qemu"
16719
16720 #. type: =head2
16721 #: ../fish/guestfish-actions.pod:4505
16722 msgid "qemu"
16723 msgstr "qemu"
16724
16725 #. type: verbatim
16726 #: ../fish/guestfish-actions.pod:4507
16727 #, no-wrap
16728 msgid ""
16729 " set-qemu qemu\n"
16730 "\n"
16731 msgstr ""
16732 " set-qemu qemu\n"
16733 "\n"
16734
16735 #. type: textblock
16736 #: ../fish/guestfish-actions.pod:4509 ../src/guestfs-actions.pod:6972
16737 msgid "Set the qemu binary that we will use."
16738 msgstr ""
16739
16740 #. type: textblock
16741 #: ../fish/guestfish-actions.pod:4511 ../src/guestfs-actions.pod:6974
16742 msgid ""
16743 "The default is chosen when the library was compiled by the configure script."
16744 msgstr ""
16745
16746 #. type: textblock
16747 #: ../fish/guestfish-actions.pod:4514 ../src/guestfs-actions.pod:6977
16748 msgid ""
16749 "You can also override this by setting the C<LIBGUESTFS_QEMU> environment "
16750 "variable."
16751 msgstr ""
16752
16753 #. type: textblock
16754 #: ../fish/guestfish-actions.pod:4517 ../src/guestfs-actions.pod:6980
16755 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary."
16756 msgstr ""
16757
16758 #. type: textblock
16759 #: ../fish/guestfish-actions.pod:4519 ../src/guestfs-actions.pod:6982
16760 msgid ""
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."
16767 msgstr ""
16768
16769 #. type: =head2
16770 #: ../fish/guestfish-actions.pod:4527
16771 msgid "set-recovery-proc"
16772 msgstr "set-recovery-proc"
16773
16774 #. type: =head2
16775 #: ../fish/guestfish-actions.pod:4529
16776 msgid "recovery-proc"
16777 msgstr "recovery-proc"
16778
16779 #. type: verbatim
16780 #: ../fish/guestfish-actions.pod:4531
16781 #, no-wrap
16782 msgid ""
16783 " set-recovery-proc true|false\n"
16784 "\n"
16785 msgstr ""
16786 " set-recovery-proc true|false\n"
16787 "\n"
16788
16789 #. type: textblock
16790 #: ../fish/guestfish-actions.pod:4533
16791 msgid ""
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."
16795 msgstr ""
16796
16797 #. type: textblock
16798 #: ../fish/guestfish-actions.pod:4538
16799 msgid ""
16800 "This only has any effect if called before L</launch>, and the default is "
16801 "true."
16802 msgstr ""
16803
16804 #. type: textblock
16805 #: ../fish/guestfish-actions.pod:4541 ../src/guestfs-actions.pod:7008
16806 msgid ""
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."
16811 msgstr ""
16812
16813 #. type: =head2
16814 #: ../fish/guestfish-actions.pod:4547
16815 msgid "set-selinux"
16816 msgstr "set-selinux"
16817
16818 #. type: =head2
16819 #: ../fish/guestfish-actions.pod:4549
16820 msgid "selinux"
16821 msgstr "selinux"
16822
16823 #. type: verbatim
16824 #: ../fish/guestfish-actions.pod:4551
16825 #, no-wrap
16826 msgid ""
16827 " set-selinux true|false\n"
16828 "\n"
16829 msgstr ""
16830 " set-selinux true|false\n"
16831 "\n"
16832
16833 #. type: textblock
16834 #: ../fish/guestfish-actions.pod:4553 ../src/guestfs-actions.pod:7024
16835 msgid ""
16836 "This sets the selinux flag that is passed to the appliance at boot time.  "
16837 "The default is C<selinux=0> (disabled)."
16838 msgstr ""
16839
16840 #. type: textblock
16841 #: ../fish/guestfish-actions.pod:4556 ../src/guestfs-actions.pod:7027
16842 msgid ""
16843 "Note that if SELinux is enabled, it is always in Permissive mode "
16844 "(C<enforcing=0>)."
16845 msgstr ""
16846
16847 #. type: =head2
16848 #: ../fish/guestfish-actions.pod:4562
16849 msgid "set-smp"
16850 msgstr ""
16851
16852 #. type: =head2
16853 #: ../fish/guestfish-actions.pod:4564
16854 msgid "smp"
16855 msgstr ""
16856
16857 #. type: verbatim
16858 #: ../fish/guestfish-actions.pod:4566
16859 #, no-wrap
16860 msgid ""
16861 " set-smp smp\n"
16862 "\n"
16863 msgstr ""
16864
16865 #. type: textblock
16866 #: ../fish/guestfish-actions.pod:4568 ../src/guestfs-actions.pod:7043
16867 msgid ""
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 "
16870 "effect."
16871 msgstr ""
16872
16873 #. type: textblock
16874 #: ../fish/guestfish-actions.pod:4572
16875 msgid "This function must be called before L</launch>."
16876 msgstr ""
16877
16878 #. type: =head2
16879 #: ../fish/guestfish-actions.pod:4574
16880 msgid "set-trace"
16881 msgstr "set-trace"
16882
16883 #. type: =head2
16884 #: ../fish/guestfish-actions.pod:4576
16885 msgid "trace"
16886 msgstr "trace"
16887
16888 #. type: verbatim
16889 #: ../fish/guestfish-actions.pod:4578
16890 #, no-wrap
16891 msgid ""
16892 " set-trace true|false\n"
16893 "\n"
16894 msgstr ""
16895 " set-trace true|false\n"
16896 "\n"
16897
16898 #. type: textblock
16899 #: ../fish/guestfish-actions.pod:4580 ../src/guestfs-actions.pod:7059
16900 msgid ""
16901 "If the command trace flag is set to 1, then libguestfs calls, parameters and "
16902 "return values are traced."
16903 msgstr ""
16904
16905 #. type: textblock
16906 #: ../fish/guestfish-actions.pod:4583 ../src/guestfs-actions.pod:7062
16907 msgid ""
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."
16910 msgstr ""
16911
16912 #. type: textblock
16913 #: ../fish/guestfish-actions.pod:4587 ../src/guestfs-actions.pod:7066
16914 msgid ""
16915 "Command traces are disabled unless the environment variable "
16916 "C<LIBGUESTFS_TRACE> is defined and set to C<1>."
16917 msgstr ""
16918
16919 #. type: textblock
16920 #: ../fish/guestfish-actions.pod:4590
16921 msgid ""
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>)."
16924 msgstr ""
16925
16926 #. type: =head2
16927 #: ../fish/guestfish-actions.pod:4594
16928 msgid "set-verbose"
16929 msgstr "set-verbose"
16930
16931 #. type: =head2
16932 #: ../fish/guestfish-actions.pod:4596
16933 msgid "verbose"
16934 msgstr "verbose"
16935
16936 #. type: verbatim
16937 #: ../fish/guestfish-actions.pod:4598
16938 #, no-wrap
16939 msgid ""
16940 " set-verbose true|false\n"
16941 "\n"
16942 msgstr ""
16943 " set-verbose true|false\n"
16944 "\n"
16945
16946 #. type: textblock
16947 #: ../fish/guestfish-actions.pod:4600 ../src/guestfs-actions.pod:7083
16948 msgid "If C<verbose> is true, this turns on verbose messages."
16949 msgstr ""
16950
16951 #. type: textblock
16952 #: ../fish/guestfish-actions.pod:4602 ../src/guestfs-actions.pod:7085
16953 msgid ""
16954 "Verbose messages are disabled unless the environment variable "
16955 "C<LIBGUESTFS_DEBUG> is defined and set to C<1>."
16956 msgstr ""
16957
16958 #. type: textblock
16959 #: ../fish/guestfish-actions.pod:4605
16960 msgid ""
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>)."
16963 msgstr ""
16964
16965 #. type: =head2
16966 #: ../fish/guestfish-actions.pod:4609
16967 msgid "setcon"
16968 msgstr "setcon"
16969
16970 #. type: verbatim
16971 #: ../fish/guestfish-actions.pod:4611
16972 #, no-wrap
16973 msgid ""
16974 " setcon context\n"
16975 "\n"
16976 msgstr ""
16977 " setcon контекст\n"
16978 "\n"
16979
16980 #. type: textblock
16981 #: ../fish/guestfish-actions.pod:4613 ../src/guestfs-actions.pod:7102
16982 msgid ""
16983 "This sets the SELinux security context of the daemon to the string "
16984 "C<context>."
16985 msgstr ""
16986
16987 #. type: textblock
16988 #: ../fish/guestfish-actions.pod:4616 ../src/guestfs-actions.pod:7105
16989 msgid "See the documentation about SELINUX in L<guestfs(3)>."
16990 msgstr ""
16991
16992 #. type: =head2
16993 #: ../fish/guestfish-actions.pod:4618
16994 msgid "setxattr"
16995 msgstr "setxattr"
16996
16997 #. type: verbatim
16998 #: ../fish/guestfish-actions.pod:4620
16999 #, no-wrap
17000 msgid ""
17001 " setxattr xattr val vallen path\n"
17002 "\n"
17003 msgstr ""
17004
17005 #. type: textblock
17006 #: ../fish/guestfish-actions.pod:4622 ../src/guestfs-actions.pod:7120
17007 msgid ""
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."
17010 msgstr ""
17011
17012 #. type: textblock
17013 #: ../fish/guestfish-actions.pod:4626
17014 msgid "See also: L</lsetxattr>, L<attr(5)>."
17015 msgstr "Див. також L</lsetxattr>, L<attr(5)>."
17016
17017 #. type: =head2
17018 #: ../fish/guestfish-actions.pod:4628
17019 msgid "sfdisk"
17020 msgstr "sfdisk"
17021
17022 #. type: verbatim
17023 #: ../fish/guestfish-actions.pod:4630
17024 #, no-wrap
17025 msgid ""
17026 " sfdisk device cyls heads sectors 'lines ...'\n"
17027 "\n"
17028 msgstr ""
17029
17030 #. type: textblock
17031 #: ../fish/guestfish-actions.pod:4632 ../src/guestfs-actions.pod:7147
17032 msgid ""
17033 "This is a direct interface to the L<sfdisk(8)> program for creating "
17034 "partitions on block devices."
17035 msgstr ""
17036
17037 #. type: textblock
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>."
17040 msgstr ""
17041
17042 #. type: textblock
17043 #: ../fish/guestfish-actions.pod:4637 ../src/guestfs-actions.pod:7152
17044 msgid ""
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."
17051 msgstr ""
17052
17053 #. type: textblock
17054 #: ../fish/guestfish-actions.pod:4645 ../src/guestfs-actions.pod:7160
17055 msgid ""
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."
17058 msgstr ""
17059
17060 #. type: textblock
17061 #: ../fish/guestfish-actions.pod:4648 ../src/guestfs-actions.pod:7163
17062 msgid ""
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 "
17065 "C<,> (comma)."
17066 msgstr ""
17067
17068 #. type: textblock
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>"
17072
17073 #. type: textblock
17074 #: ../fish/guestfish-actions.pod:4655 ../fish/guestfish-actions.pod:4675
17075 #: ../fish/guestfish-actions.pod:4694
17076 msgid ""
17077 "I<This function is deprecated.> In new code, use the L</part_add> call "
17078 "instead."
17079 msgstr ""
17080
17081 #. type: =head2
17082 #: ../fish/guestfish-actions.pod:4662
17083 msgid "sfdiskM"
17084 msgstr "sfdiskM"
17085
17086 #. type: verbatim
17087 #: ../fish/guestfish-actions.pod:4664
17088 #, no-wrap
17089 msgid ""
17090 " sfdiskM device 'lines ...'\n"
17091 "\n"
17092 msgstr ""
17093
17094 #. type: textblock
17095 #: ../fish/guestfish-actions.pod:4666
17096 msgid ""
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."
17101 msgstr ""
17102
17103 #. type: textblock
17104 #: ../fish/guestfish-actions.pod:4672
17105 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>"
17106 msgstr ""
17107 "Див також L</sfdisk>, сторінку довідки (man) L<sfdisk(8)> та L</part-disk>"
17108
17109 #. type: =head2
17110 #: ../fish/guestfish-actions.pod:4682
17111 msgid "sfdisk-N"
17112 msgstr "sfdisk-N"
17113
17114 #. type: verbatim
17115 #: ../fish/guestfish-actions.pod:4684
17116 #, no-wrap
17117 msgid ""
17118 " sfdisk-N device partnum cyls heads sectors line\n"
17119 "\n"
17120 msgstr ""
17121
17122 #. type: textblock
17123 #: ../fish/guestfish-actions.pod:4686 ../src/guestfs-actions.pod:7219
17124 msgid ""
17125 "This runs L<sfdisk(8)> option to modify just the single partition C<n> "
17126 "(note: C<n> counts from 1)."
17127 msgstr ""
17128
17129 #. type: textblock
17130 #: ../fish/guestfish-actions.pod:4689
17131 msgid ""
17132 "For other parameters, see L</sfdisk>.  You should usually pass C<0> for the "
17133 "cyls/heads/sectors parameters."
17134 msgstr ""
17135
17136 #. type: textblock
17137 #: ../fish/guestfish-actions.pod:4692
17138 msgid "See also: L</part-add>"
17139 msgstr "Див. також L</part-add>"
17140
17141 #. type: =head2
17142 #: ../fish/guestfish-actions.pod:4701
17143 msgid "sfdisk-disk-geometry"
17144 msgstr "sfdisk-disk-geometry"
17145
17146 #. type: verbatim
17147 #: ../fish/guestfish-actions.pod:4703
17148 #, no-wrap
17149 msgid ""
17150 " sfdisk-disk-geometry device\n"
17151 "\n"
17152 msgstr ""
17153 " sfdisk-disk-geometry пристрій\n"
17154 "\n"
17155
17156 #. type: textblock
17157 #: ../fish/guestfish-actions.pod:4705
17158 msgid ""
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>)."
17163 msgstr ""
17164
17165 #. type: textblock
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."
17169 msgstr ""
17170
17171 #. type: =head2
17172 #: ../fish/guestfish-actions.pod:4713
17173 msgid "sfdisk-kernel-geometry"
17174 msgstr "sfdisk-kernel-geometry"
17175
17176 #. type: verbatim
17177 #: ../fish/guestfish-actions.pod:4715
17178 #, no-wrap
17179 msgid ""
17180 " sfdisk-kernel-geometry device\n"
17181 "\n"
17182 msgstr ""
17183 " sfdisk-kernel-geometry пристрій\n"
17184 "\n"
17185
17186 #. type: textblock
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>."
17189 msgstr ""
17190
17191 #. type: =head2
17192 #: ../fish/guestfish-actions.pod:4722
17193 msgid "sfdisk-l"
17194 msgstr "sfdisk-l"
17195
17196 #. type: verbatim
17197 #: ../fish/guestfish-actions.pod:4724
17198 #, no-wrap
17199 msgid ""
17200 " sfdisk-l device\n"
17201 "\n"
17202 msgstr ""
17203 " sfdisk-l пристрій\n"
17204 "\n"
17205
17206 #. type: textblock
17207 #: ../fish/guestfish-actions.pod:4726 ../src/guestfs-actions.pod:7279
17208 msgid ""
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."
17211 msgstr ""
17212
17213 #. type: textblock
17214 #: ../fish/guestfish-actions.pod:4730
17215 msgid "See also: L</part-list>"
17216 msgstr "Див. також L</part-list>"
17217
17218 #. type: textblock
17219 #: ../fish/guestfish-actions.pod:4732
17220 msgid ""
17221 "I<This function is deprecated.> In new code, use the L</part_list> call "
17222 "instead."
17223 msgstr ""
17224
17225 #. type: =head2
17226 #: ../fish/guestfish-actions.pod:4739
17227 msgid "sh"
17228 msgstr "sh"
17229
17230 #. type: verbatim
17231 #: ../fish/guestfish-actions.pod:4741
17232 #, no-wrap
17233 msgid ""
17234 " sh command\n"
17235 "\n"
17236 msgstr ""
17237 " sh команда\n"
17238 "\n"
17239
17240 #. type: textblock
17241 #: ../fish/guestfish-actions.pod:4743 ../src/guestfs-actions.pod:7296
17242 msgid ""
17243 "This call runs a command from the guest filesystem via the guest's C</bin/"
17244 "sh>."
17245 msgstr ""
17246
17247 #. type: textblock
17248 #: ../fish/guestfish-actions.pod:4746
17249 msgid "This is like L</command>, but passes the command to:"
17250 msgstr ""
17251
17252 #. type: verbatim
17253 #: ../fish/guestfish-actions.pod:4748 ../src/guestfs-actions.pod:7301
17254 #, no-wrap
17255 msgid ""
17256 " /bin/sh -c \"command\"\n"
17257 "\n"
17258 msgstr ""
17259
17260 #. type: textblock
17261 #: ../fish/guestfish-actions.pod:4750 ../src/guestfs-actions.pod:7303
17262 msgid ""
17263 "Depending on the guest's shell, this usually results in wildcards being "
17264 "expanded, shell expressions being interpolated and so on."
17265 msgstr ""
17266
17267 #. type: textblock
17268 #: ../fish/guestfish-actions.pod:4754
17269 msgid "All the provisos about L</command> apply to this call."
17270 msgstr ""
17271
17272 #. type: =head2
17273 #: ../fish/guestfish-actions.pod:4756
17274 msgid "sh-lines"
17275 msgstr "sh-lines"
17276
17277 #. type: verbatim
17278 #: ../fish/guestfish-actions.pod:4758
17279 #, no-wrap
17280 msgid ""
17281 " sh-lines command\n"
17282 "\n"
17283 msgstr ""
17284 " sh-lines команда\n"
17285 "\n"
17286
17287 #. type: textblock
17288 #: ../fish/guestfish-actions.pod:4760
17289 msgid "This is the same as L</sh>, but splits the result into a list of lines."
17290 msgstr ""
17291
17292 #. type: textblock
17293 #: ../fish/guestfish-actions.pod:4763
17294 msgid "See also: L</command-lines>"
17295 msgstr "Див. також L</command-lines>"
17296
17297 #. type: =head2
17298 #: ../fish/guestfish-actions.pod:4765
17299 msgid "sleep"
17300 msgstr "sleep"
17301
17302 #. type: verbatim
17303 #: ../fish/guestfish-actions.pod:4767
17304 #, no-wrap
17305 msgid ""
17306 " sleep secs\n"
17307 "\n"
17308 msgstr ""
17309 " sleep час_у_секундах\n"
17310 "\n"
17311
17312 #. type: textblock
17313 #: ../fish/guestfish-actions.pod:4769 ../src/guestfs-actions.pod:7337
17314 msgid "Sleep for C<secs> seconds."
17315 msgstr ""
17316
17317 #. type: =head2
17318 #: ../fish/guestfish-actions.pod:4771
17319 msgid "stat"
17320 msgstr "stat"
17321
17322 #. type: verbatim
17323 #: ../fish/guestfish-actions.pod:4773
17324 #, no-wrap
17325 msgid ""
17326 " stat path\n"
17327 "\n"
17328 msgstr ""
17329 " stat шлях\n"
17330 "\n"
17331
17332 #. type: textblock
17333 #: ../fish/guestfish-actions.pod:4777 ../src/guestfs-actions.pod:7351
17334 msgid "This is the same as the C<stat(2)> system call."
17335 msgstr ""
17336
17337 #. type: =head2
17338 #: ../fish/guestfish-actions.pod:4779
17339 msgid "statvfs"
17340 msgstr "statvfs"
17341
17342 #. type: verbatim
17343 #: ../fish/guestfish-actions.pod:4781
17344 #, no-wrap
17345 msgid ""
17346 " statvfs path\n"
17347 "\n"
17348 msgstr ""
17349 " statvfs шлях\n"
17350 "\n"
17351
17352 #. type: textblock
17353 #: ../fish/guestfish-actions.pod:4783 ../src/guestfs-actions.pod:7365
17354 msgid ""
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)."
17358 msgstr ""
17359
17360 #. type: textblock
17361 #: ../fish/guestfish-actions.pod:4787 ../src/guestfs-actions.pod:7369
17362 msgid "This is the same as the C<statvfs(2)> system call."
17363 msgstr ""
17364
17365 #. type: =head2
17366 #: ../fish/guestfish-actions.pod:4789
17367 msgid "strings"
17368 msgstr "strings"
17369
17370 #. type: verbatim
17371 #: ../fish/guestfish-actions.pod:4791
17372 #, no-wrap
17373 msgid ""
17374 " strings path\n"
17375 "\n"
17376 msgstr ""
17377 " strings шлях\n"
17378 "\n"
17379
17380 #. type: textblock
17381 #: ../fish/guestfish-actions.pod:4793 ../src/guestfs-actions.pod:7383
17382 msgid ""
17383 "This runs the L<strings(1)> command on a file and returns the list of "
17384 "printable strings found."
17385 msgstr ""
17386
17387 #. type: =head2
17388 #: ../fish/guestfish-actions.pod:4799
17389 msgid "strings-e"
17390 msgstr "strings-e"
17391
17392 #. type: verbatim
17393 #: ../fish/guestfish-actions.pod:4801
17394 #, no-wrap
17395 msgid ""
17396 " strings-e encoding path\n"
17397 "\n"
17398 msgstr ""
17399 " strings-e кодування шлях\n"
17400 "\n"
17401
17402 #. type: textblock
17403 #: ../fish/guestfish-actions.pod:4803
17404 msgid ""
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>."
17407 msgstr ""
17408
17409 #. type: textblock
17410 #: ../fish/guestfish-actions.pod:4807 ../src/guestfs-actions.pod:7406
17411 msgid "Allowed encodings are:"
17412 msgstr "Можливими кодуваннями є:"
17413
17414 #. type: =item
17415 #: ../fish/guestfish-actions.pod:4811 ../src/guestfs-actions.pod:7410
17416 msgid "s"
17417 msgstr "s"
17418
17419 #. type: textblock
17420 #: ../fish/guestfish-actions.pod:4813
17421 msgid ""
17422 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
17423 "ISO-8859-X (this is what L</strings> uses)."
17424 msgstr ""
17425
17426 #. type: =item
17427 #: ../fish/guestfish-actions.pod:4816 ../src/guestfs-actions.pod:7415
17428 msgid "S"
17429 msgstr "S"
17430
17431 #. type: textblock
17432 #: ../fish/guestfish-actions.pod:4818 ../src/guestfs-actions.pod:7417
17433 msgid "Single 8-bit-byte characters."
17434 msgstr "Окремі 8-бітові-байтові символи."
17435
17436 #. type: =item
17437 #: ../fish/guestfish-actions.pod:4820 ../src/guestfs-actions.pod:7419
17438 msgid "b"
17439 msgstr "b"
17440
17441 #. type: textblock
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."
17444 msgstr ""
17445
17446 #. type: =item
17447 #: ../fish/guestfish-actions.pod:4825 ../src/guestfs-actions.pod:7424
17448 msgid "l (lower case letter L)"
17449 msgstr ""
17450
17451 #. type: textblock
17452 #: ../fish/guestfish-actions.pod:4827 ../src/guestfs-actions.pod:7426
17453 msgid ""
17454 "16-bit little endian such as UTF-16LE and UCS-2LE.  This is useful for "
17455 "examining binaries in Windows guests."
17456 msgstr ""
17457
17458 #. type: =item
17459 #: ../fish/guestfish-actions.pod:4830 ../src/guestfs-actions.pod:7429
17460 msgid "B"
17461 msgstr "B"
17462
17463 #. type: textblock
17464 #: ../fish/guestfish-actions.pod:4832 ../src/guestfs-actions.pod:7431
17465 msgid "32-bit big endian such as UCS-4BE."
17466 msgstr ""
17467
17468 #. type: =item
17469 #: ../fish/guestfish-actions.pod:4834 ../src/guestfs-actions.pod:7433
17470 msgid "L"
17471 msgstr "L"
17472
17473 #. type: textblock
17474 #: ../fish/guestfish-actions.pod:4836 ../src/guestfs-actions.pod:7435
17475 msgid "32-bit little endian such as UCS-4LE."
17476 msgstr ""
17477
17478 #. type: textblock
17479 #: ../fish/guestfish-actions.pod:4840 ../src/guestfs-actions.pod:7439
17480 msgid "The returned strings are transcoded to UTF-8."
17481 msgstr ""
17482
17483 #. type: =head2
17484 #: ../fish/guestfish-actions.pod:4845
17485 msgid "swapoff-device"
17486 msgstr "swapoff-device"
17487
17488 #. type: verbatim
17489 #: ../fish/guestfish-actions.pod:4847
17490 #, no-wrap
17491 msgid ""
17492 " swapoff-device device\n"
17493 "\n"
17494 msgstr ""
17495 " swapoff-device пристрій\n"
17496 "\n"
17497
17498 #. type: textblock
17499 #: ../fish/guestfish-actions.pod:4849
17500 msgid ""
17501 "This command disables the libguestfs appliance swap device or partition "
17502 "named C<device>.  See L</swapon-device>."
17503 msgstr ""
17504
17505 #. type: =head2
17506 #: ../fish/guestfish-actions.pod:4853
17507 msgid "swapoff-file"
17508 msgstr "swapoff-file"
17509
17510 #. type: verbatim
17511 #: ../fish/guestfish-actions.pod:4855
17512 #, no-wrap
17513 msgid ""
17514 " swapoff-file file\n"
17515 "\n"
17516 msgstr ""
17517 " swapoff-file файл\n"
17518 "\n"
17519
17520 #. type: textblock
17521 #: ../fish/guestfish-actions.pod:4857 ../src/guestfs-actions.pod:7470
17522 msgid "This command disables the libguestfs appliance swap on file."
17523 msgstr ""
17524
17525 #. type: =head2
17526 #: ../fish/guestfish-actions.pod:4859
17527 msgid "swapoff-label"
17528 msgstr "swapoff-label"
17529
17530 #. type: verbatim
17531 #: ../fish/guestfish-actions.pod:4861
17532 #, no-wrap
17533 msgid ""
17534 " swapoff-label label\n"
17535 "\n"
17536 msgstr ""
17537 " swapoff-label мітка\n"
17538 "\n"
17539
17540 #. type: textblock
17541 #: ../fish/guestfish-actions.pod:4863 ../src/guestfs-actions.pod:7482
17542 msgid ""
17543 "This command disables the libguestfs appliance swap on labeled swap "
17544 "partition."
17545 msgstr ""
17546
17547 #. type: =head2
17548 #: ../fish/guestfish-actions.pod:4866
17549 msgid "swapoff-uuid"
17550 msgstr "swapoff-uuid"
17551
17552 #. type: verbatim
17553 #: ../fish/guestfish-actions.pod:4868
17554 #, no-wrap
17555 msgid ""
17556 " swapoff-uuid uuid\n"
17557 "\n"
17558 msgstr ""
17559 " swapoff-uuid uuid\n"
17560 "\n"
17561
17562 #. type: textblock
17563 #: ../fish/guestfish-actions.pod:4870 ../src/guestfs-actions.pod:7495
17564 msgid ""
17565 "This command disables the libguestfs appliance swap partition with the given "
17566 "UUID."
17567 msgstr ""
17568
17569 #. type: =head2
17570 #: ../fish/guestfish-actions.pod:4873
17571 msgid "swapon-device"
17572 msgstr "swapon-device"
17573
17574 #. type: verbatim
17575 #: ../fish/guestfish-actions.pod:4875
17576 #, no-wrap
17577 msgid ""
17578 " swapon-device device\n"
17579 "\n"
17580 msgstr ""
17581 " swapon-device пристрій\n"
17582 "\n"
17583
17584 #. type: textblock
17585 #: ../fish/guestfish-actions.pod:4877
17586 msgid ""
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>."
17590 msgstr ""
17591
17592 #. type: textblock
17593 #: ../fish/guestfish-actions.pod:4882 ../src/guestfs-actions.pod:7513
17594 msgid ""
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."
17600 msgstr ""
17601
17602 #. type: =head2
17603 #: ../fish/guestfish-actions.pod:4889
17604 msgid "swapon-file"
17605 msgstr "swapon-file"
17606
17607 #. type: verbatim
17608 #: ../fish/guestfish-actions.pod:4891
17609 #, no-wrap
17610 msgid ""
17611 " swapon-file file\n"
17612 "\n"
17613 msgstr ""
17614 " swapon-file файл\n"
17615 "\n"
17616
17617 #. type: textblock
17618 #: ../fish/guestfish-actions.pod:4893
17619 msgid ""
17620 "This command enables swap to a file.  See L</swapon-device> for other notes."
17621 msgstr ""
17622
17623 #. type: =head2
17624 #: ../fish/guestfish-actions.pod:4896
17625 msgid "swapon-label"
17626 msgstr "swapon-label"
17627
17628 #. type: verbatim
17629 #: ../fish/guestfish-actions.pod:4898
17630 #, no-wrap
17631 msgid ""
17632 " swapon-label label\n"
17633 "\n"
17634 msgstr ""
17635 " swapon-label мітка\n"
17636 "\n"
17637
17638 #. type: textblock
17639 #: ../fish/guestfish-actions.pod:4900
17640 msgid ""
17641 "This command enables swap to a labeled swap partition.  See L</swapon-"
17642 "device> for other notes."
17643 msgstr ""
17644
17645 #. type: =head2
17646 #: ../fish/guestfish-actions.pod:4903
17647 msgid "swapon-uuid"
17648 msgstr "swapon-uuid"
17649
17650 #. type: verbatim
17651 #: ../fish/guestfish-actions.pod:4905
17652 #, no-wrap
17653 msgid ""
17654 " swapon-uuid uuid\n"
17655 "\n"
17656 msgstr ""
17657 " swapon-uuid uuid\n"
17658 "\n"
17659
17660 #. type: textblock
17661 #: ../fish/guestfish-actions.pod:4907
17662 msgid ""
17663 "This command enables swap to a swap partition with the given UUID.  See L</"
17664 "swapon-device> for other notes."
17665 msgstr ""
17666
17667 #. type: =head2
17668 #: ../fish/guestfish-actions.pod:4910
17669 msgid "sync"
17670 msgstr "sync"
17671
17672 #. type: verbatim
17673 #: ../fish/guestfish-actions.pod:4912
17674 #, no-wrap
17675 msgid ""
17676 " sync\n"
17677 "\n"
17678 msgstr ""
17679 " sync\n"
17680 "\n"
17681
17682 #. type: textblock
17683 #: ../fish/guestfish-actions.pod:4914 ../src/guestfs-actions.pod:7568
17684 msgid ""
17685 "This syncs the disk, so that any writes are flushed through to the "
17686 "underlying disk image."
17687 msgstr ""
17688
17689 #. type: textblock
17690 #: ../fish/guestfish-actions.pod:4917 ../src/guestfs-actions.pod:7571
17691 msgid ""
17692 "You should always call this if you have modified a disk image, before "
17693 "closing the handle."
17694 msgstr ""
17695
17696 #. type: =head2
17697 #: ../fish/guestfish-actions.pod:4920
17698 msgid "tail"
17699 msgstr "tail"
17700
17701 #. type: verbatim
17702 #: ../fish/guestfish-actions.pod:4922
17703 #, no-wrap
17704 msgid ""
17705 " tail path\n"
17706 "\n"
17707 msgstr ""
17708 " tail шлях\n"
17709 "\n"
17710
17711 #. type: textblock
17712 #: ../fish/guestfish-actions.pod:4924 ../src/guestfs-actions.pod:7584
17713 msgid ""
17714 "This command returns up to the last 10 lines of a file as a list of strings."
17715 msgstr ""
17716
17717 #. type: =head2
17718 #: ../fish/guestfish-actions.pod:4930
17719 msgid "tail-n"
17720 msgstr "tail-n"
17721
17722 #. type: verbatim
17723 #: ../fish/guestfish-actions.pod:4932
17724 #, no-wrap
17725 msgid ""
17726 " tail-n nrlines path\n"
17727 "\n"
17728 msgstr ""
17729
17730 #. type: textblock
17731 #: ../fish/guestfish-actions.pod:4934 ../src/guestfs-actions.pod:7603
17732 msgid ""
17733 "If the parameter C<nrlines> is a positive number, this returns the last "
17734 "C<nrlines> lines of the file C<path>."
17735 msgstr ""
17736
17737 #. type: textblock
17738 #: ../fish/guestfish-actions.pod:4937 ../src/guestfs-actions.pod:7606
17739 msgid ""
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."
17742 msgstr ""
17743
17744 #. type: =head2
17745 #: ../fish/guestfish-actions.pod:4945
17746 msgid "tar-in"
17747 msgstr "tar-in"
17748
17749 #. type: verbatim
17750 #: ../fish/guestfish-actions.pod:4947
17751 #, no-wrap
17752 msgid ""
17753 " tar-in (tarfile|-) directory\n"
17754 "\n"
17755 msgstr ""
17756 " tar-in (файл_tar|-) каталог\n"
17757 "\n"
17758
17759 #. type: textblock
17760 #: ../fish/guestfish-actions.pod:4949 ../src/guestfs-actions.pod:7627
17761 msgid ""
17762 "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> "
17763 "tar file) into C<directory>."
17764 msgstr ""
17765
17766 #. type: textblock
17767 #: ../fish/guestfish-actions.pod:4952
17768 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>."
17769 msgstr ""
17770
17771 #. type: =head2
17772 #: ../fish/guestfish-actions.pod:4957
17773 msgid "tar-out"
17774 msgstr "tar-out"
17775
17776 #. type: verbatim
17777 #: ../fish/guestfish-actions.pod:4959
17778 #, no-wrap
17779 msgid ""
17780 " tar-out directory (tarfile|-)\n"
17781 "\n"
17782 msgstr ""
17783 " tar-out каталог (файл tar|-)\n"
17784 "\n"
17785
17786 #. type: textblock
17787 #: ../fish/guestfish-actions.pod:4961 ../src/guestfs-actions.pod:7644
17788 msgid ""
17789 "This command packs the contents of C<directory> and downloads it to local "
17790 "file C<tarfile>."
17791 msgstr ""
17792
17793 #. type: textblock
17794 #: ../fish/guestfish-actions.pod:4964
17795 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>."
17796 msgstr ""
17797
17798 #. type: =head2
17799 #: ../fish/guestfish-actions.pod:4969
17800 msgid "tgz-in"
17801 msgstr "tgz-in"
17802
17803 #. type: verbatim
17804 #: ../fish/guestfish-actions.pod:4971
17805 #, no-wrap
17806 msgid ""
17807 " tgz-in (tarball|-) directory\n"
17808 "\n"
17809 msgstr ""
17810 " tgz-in (архів tar|-) каталог\n"
17811 "\n"
17812
17813 #. type: textblock
17814 #: ../fish/guestfish-actions.pod:4973 ../src/guestfs-actions.pod:7661
17815 msgid ""
17816 "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> "
17817 "tar file) into C<directory>."
17818 msgstr ""
17819
17820 #. type: textblock
17821 #: ../fish/guestfish-actions.pod:4976
17822 msgid "To upload an uncompressed tarball, use L</tar-in>."
17823 msgstr ""
17824
17825 #. type: =head2
17826 #: ../fish/guestfish-actions.pod:4980
17827 msgid "tgz-out"
17828 msgstr "tgz-out"
17829
17830 #. type: verbatim
17831 #: ../fish/guestfish-actions.pod:4982
17832 #, no-wrap
17833 msgid ""
17834 " tgz-out directory (tarball|-)\n"
17835 "\n"
17836 msgstr ""
17837 " tgz-out каталог (архів tar|-)\n"
17838 "\n"
17839
17840 #. type: textblock
17841 #: ../fish/guestfish-actions.pod:4984 ../src/guestfs-actions.pod:7677
17842 msgid ""
17843 "This command packs the contents of C<directory> and downloads it to local "
17844 "file C<tarball>."
17845 msgstr ""
17846
17847 #. type: textblock
17848 #: ../fish/guestfish-actions.pod:4987
17849 msgid "To download an uncompressed tarball, use L</tar-out>."
17850 msgstr ""
17851
17852 #. type: =head2
17853 #: ../fish/guestfish-actions.pod:4991
17854 msgid "touch"
17855 msgstr "touch"
17856
17857 #. type: verbatim
17858 #: ../fish/guestfish-actions.pod:4993
17859 #, no-wrap
17860 msgid ""
17861 " touch path\n"
17862 "\n"
17863 msgstr ""
17864 " touch шлях\n"
17865 "\n"
17866
17867 #. type: textblock
17868 #: ../fish/guestfish-actions.pod:4995 ../src/guestfs-actions.pod:7692
17869 msgid ""
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-"
17872 "length file."
17873 msgstr ""
17874
17875 #. type: textblock
17876 #: ../fish/guestfish-actions.pod:4999 ../src/guestfs-actions.pod:7696
17877 msgid ""
17878 "This command only works on regular files, and will fail on other file types "
17879 "such as directories, symbolic links, block special etc."
17880 msgstr ""
17881
17882 #. type: =head2
17883 #: ../fish/guestfish-actions.pod:5002
17884 msgid "truncate"
17885 msgstr "truncate"
17886
17887 #. type: verbatim
17888 #: ../fish/guestfish-actions.pod:5004
17889 #, no-wrap
17890 msgid ""
17891 " truncate path\n"
17892 "\n"
17893 msgstr ""
17894 " truncate шлях\n"
17895 "\n"
17896
17897 #. type: textblock
17898 #: ../fish/guestfish-actions.pod:5006 ../src/guestfs-actions.pod:7709
17899 msgid ""
17900 "This command truncates C<path> to a zero-length file.  The file must exist "
17901 "already."
17902 msgstr ""
17903
17904 #. type: =head2
17905 #: ../fish/guestfish-actions.pod:5009
17906 msgid "truncate-size"
17907 msgstr "truncate-size"
17908
17909 #. type: verbatim
17910 #: ../fish/guestfish-actions.pod:5011
17911 #, no-wrap
17912 msgid ""
17913 " truncate-size path size\n"
17914 "\n"
17915 msgstr ""
17916 " truncate-size шлях розмір\n"
17917 "\n"
17918
17919 #. type: textblock
17920 #: ../fish/guestfish-actions.pod:5013 ../src/guestfs-actions.pod:7723
17921 msgid ""
17922 "This command truncates C<path> to size C<size> bytes.  The file must exist "
17923 "already."
17924 msgstr ""
17925
17926 #. type: textblock
17927 #: ../fish/guestfish-actions.pod:5016
17928 msgid ""
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."
17933 msgstr ""
17934
17935 #. type: =head2
17936 #: ../fish/guestfish-actions.pod:5022
17937 #, fuzzy
17938 #| msgid "tune2fs-l"
17939 msgid "tune2fs"
17940 msgstr "tune2fs-l"
17941
17942 #. type: verbatim
17943 #: ../fish/guestfish-actions.pod:5024
17944 #, no-wrap
17945 msgid ""
17946 " tune2fs device [force:true|false] [maxmountcount:N] [mountcount:N] [errorbehavior:..] [group:N] [intervalbetweenchecks:N] [reservedblockspercentage:N] [lastmounteddirectory:..] [reservedblockscount:N] [user:N]\n"
17947 "\n"
17948 msgstr ""
17949
17950 #. type: textblock
17951 #: ../fish/guestfish-actions.pod:5026 ../src/guestfs-actions.pod:7759
17952 msgid ""
17953 "This call allows you to adjust various filesystem parameters of an ext2/ext3/"
17954 "ext4 filesystem called C<device>."
17955 msgstr ""
17956
17957 #. type: textblock
17958 #: ../fish/guestfish-actions.pod:5035 ../src/guestfs-actions.pod:7768
17959 msgid ""
17960 "Force tune2fs to complete the operation even in the face of errors.  This is "
17961 "the same as the tune2fs C<-f> option."
17962 msgstr ""
17963
17964 #. type: =item
17965 #: ../fish/guestfish-actions.pod:5038 ../src/guestfs-actions.pod:7771
17966 #, fuzzy
17967 #| msgid "mkmountpoint"
17968 msgid "C<maxmountcount>"
17969 msgstr "mkmountpoint"
17970
17971 #. type: textblock
17972 #: ../fish/guestfish-actions.pod:5040 ../src/guestfs-actions.pod:7773
17973 msgid ""
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."
17977 msgstr ""
17978
17979 #. type: =item
17980 #: ../fish/guestfish-actions.pod:5044 ../src/guestfs-actions.pod:7777
17981 #, fuzzy
17982 #| msgid "mountpoints"
17983 msgid "C<mountcount>"
17984 msgstr "mountpoints"
17985
17986 #. type: textblock
17987 #: ../fish/guestfish-actions.pod:5046 ../src/guestfs-actions.pod:7779
17988 msgid ""
17989 "Set the number of times the filesystem has been mounted.  This is the same "
17990 "as the tune2fs C<-C> option."
17991 msgstr ""
17992
17993 #. type: =item
17994 #: ../fish/guestfish-actions.pod:5049 ../src/guestfs-actions.pod:7782
17995 msgid "C<errorbehavior>"
17996 msgstr ""
17997
17998 #. type: textblock
17999 #: ../fish/guestfish-actions.pod:5051 ../src/guestfs-actions.pod:7784
18000 msgid ""
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 "
18004 "errors."
18005 msgstr ""
18006
18007 #. type: textblock
18008 #: ../fish/guestfish-actions.pod:5056 ../src/guestfs-actions.pod:7789
18009 msgid "This is the same as the tune2fs C<-e> option."
18010 msgstr ""
18011
18012 #. type: =item
18013 #: ../fish/guestfish-actions.pod:5058 ../src/guestfs-actions.pod:7791
18014 #, fuzzy
18015 #| msgid "B<--volgroups>"
18016 msgid "C<group>"
18017 msgstr "B<--volgroups>"
18018
18019 #. type: textblock
18020 #: ../fish/guestfish-actions.pod:5060 ../src/guestfs-actions.pod:7793
18021 msgid ""
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."
18024 msgstr ""
18025
18026 #. type: =item
18027 #: ../fish/guestfish-actions.pod:5064 ../src/guestfs-actions.pod:7797
18028 msgid "C<intervalbetweenchecks>"
18029 msgstr ""
18030
18031 #. type: textblock
18032 #: ../fish/guestfish-actions.pod:5066 ../src/guestfs-actions.pod:7799
18033 msgid ""
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."
18036 msgstr ""
18037
18038 #. type: textblock
18039 #: ../fish/guestfish-actions.pod:5070 ../src/guestfs-actions.pod:7803
18040 msgid "This is the same as the tune2fs C<-i> option."
18041 msgstr ""
18042
18043 #. type: =item
18044 #: ../fish/guestfish-actions.pod:5072 ../src/guestfs-actions.pod:7805
18045 msgid "C<reservedblockspercentage>"
18046 msgstr ""
18047
18048 #. type: textblock
18049 #: ../fish/guestfish-actions.pod:5074 ../src/guestfs-actions.pod:7807
18050 msgid ""
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."
18053 msgstr ""
18054
18055 #. type: =item
18056 #: ../fish/guestfish-actions.pod:5078 ../src/guestfs-actions.pod:7811
18057 msgid "C<lastmounteddirectory>"
18058 msgstr ""
18059
18060 #. type: textblock
18061 #: ../fish/guestfish-actions.pod:5080 ../src/guestfs-actions.pod:7813
18062 msgid ""
18063 "Set the last mounted directory.  This is the same as the tune2fs C<-M> "
18064 "option."
18065 msgstr ""
18066
18067 #. type: =item
18068 #: ../fish/guestfish-actions.pod:5083 ../src/guestfs-actions.pod:7816
18069 msgid ""
18070 "C<reservedblockscount> Set the number of reserved filesystem blocks.  This "
18071 "is the same as the tune2fs C<-r> option."
18072 msgstr ""
18073
18074 #. type: =item
18075 #: ../fish/guestfish-actions.pod:5087 ../src/guestfs-actions.pod:7820
18076 msgid "C<user>"
18077 msgstr ""
18078
18079 #. type: textblock
18080 #: ../fish/guestfish-actions.pod:5089 ../src/guestfs-actions.pod:7822
18081 msgid ""
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."
18084 msgstr ""
18085
18086 #. type: textblock
18087 #: ../fish/guestfish-actions.pod:5095
18088 msgid ""
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."
18091 msgstr ""
18092
18093 #. type: =head2
18094 #: ../fish/guestfish-actions.pod:5101
18095 msgid "tune2fs-l"
18096 msgstr "tune2fs-l"
18097
18098 #. type: verbatim
18099 #: ../fish/guestfish-actions.pod:5103
18100 #, no-wrap
18101 msgid ""
18102 " tune2fs-l device\n"
18103 "\n"
18104 msgstr ""
18105 " tune2fs-l пристрій\n"
18106 "\n"
18107
18108 #. type: textblock
18109 #: ../fish/guestfish-actions.pod:5105 ../src/guestfs-actions.pod:7862
18110 msgid ""
18111 "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on "
18112 "C<device>."
18113 msgstr ""
18114
18115 #. type: textblock
18116 #: ../fish/guestfish-actions.pod:5108 ../src/guestfs-actions.pod:7865
18117 msgid ""
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."
18122 msgstr ""
18123
18124 #. type: =head2
18125 #: ../fish/guestfish-actions.pod:5113
18126 msgid "txz-in"
18127 msgstr "txz-in"
18128
18129 #. type: verbatim
18130 #: ../fish/guestfish-actions.pod:5115
18131 #, no-wrap
18132 msgid ""
18133 " txz-in (tarball|-) directory\n"
18134 "\n"
18135 msgstr ""
18136 " txz-in (архів tar|-) каталог\n"
18137 "\n"
18138
18139 #. type: textblock
18140 #: ../fish/guestfish-actions.pod:5117 ../src/guestfs-actions.pod:7885
18141 msgid ""
18142 "This command uploads and unpacks local file C<tarball> (an I<xz compressed> "
18143 "tar file) into C<directory>."
18144 msgstr ""
18145
18146 #. type: =head2
18147 #: ../fish/guestfish-actions.pod:5122
18148 msgid "txz-out"
18149 msgstr "txz-out"
18150
18151 #. type: verbatim
18152 #: ../fish/guestfish-actions.pod:5124
18153 #, no-wrap
18154 msgid ""
18155 " txz-out directory (tarball|-)\n"
18156 "\n"
18157 msgstr ""
18158 " txz-out каталог (архів tar|-)\n"
18159 "\n"
18160
18161 #. type: textblock
18162 #: ../fish/guestfish-actions.pod:5126 ../src/guestfs-actions.pod:7899
18163 msgid ""
18164 "This command packs the contents of C<directory> and downloads it to local "
18165 "file C<tarball> (as an xz compressed tar archive)."
18166 msgstr ""
18167
18168 #. type: =head2
18169 #: ../fish/guestfish-actions.pod:5131
18170 msgid "umask"
18171 msgstr "umask"
18172
18173 #. type: verbatim
18174 #: ../fish/guestfish-actions.pod:5133
18175 #, no-wrap
18176 msgid ""
18177 " umask mask\n"
18178 "\n"
18179 msgstr ""
18180 " umask маска\n"
18181 "\n"
18182
18183 #. type: textblock
18184 #: ../fish/guestfish-actions.pod:5135 ../src/guestfs-actions.pod:7912
18185 msgid ""
18186 "This function sets the mask used for creating new files and device nodes to "
18187 "C<mask & 0777>."
18188 msgstr ""
18189
18190 #. type: textblock
18191 #: ../fish/guestfish-actions.pod:5138 ../src/guestfs-actions.pod:7915
18192 msgid ""
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\"."
18196 msgstr ""
18197
18198 #. type: textblock
18199 #: ../fish/guestfish-actions.pod:5143 ../src/guestfs-actions.pod:7920
18200 msgid ""
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>."
18204 msgstr ""
18205
18206 #. type: textblock
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>."
18210
18211 #. type: textblock
18212 #: ../fish/guestfish-actions.pod:5150 ../src/guestfs-actions.pod:7927
18213 msgid "This call returns the previous umask."
18214 msgstr ""
18215
18216 #. type: =head2
18217 #: ../fish/guestfish-actions.pod:5152
18218 msgid "umount"
18219 msgstr "umount"
18220
18221 #. type: =head2
18222 #: ../fish/guestfish-actions.pod:5154
18223 msgid "unmount"
18224 msgstr "unmount"
18225
18226 #. type: verbatim
18227 #: ../fish/guestfish-actions.pod:5156
18228 #, no-wrap
18229 msgid ""
18230 " umount pathordevice\n"
18231 "\n"
18232 msgstr ""
18233 " umount шлях_або_пристрій\n"
18234 "\n"
18235
18236 #. type: textblock
18237 #: ../fish/guestfish-actions.pod:5158 ../src/guestfs-actions.pod:7939
18238 msgid ""
18239 "This unmounts the given filesystem.  The filesystem may be specified either "
18240 "by its mountpoint (path) or the device which contains the filesystem."
18241 msgstr ""
18242
18243 #. type: =head2
18244 #: ../fish/guestfish-actions.pod:5162
18245 msgid "umount-all"
18246 msgstr "umount-all"
18247
18248 #. type: =head2
18249 #: ../fish/guestfish-actions.pod:5164
18250 msgid "unmount-all"
18251 msgstr "unmount-all"
18252
18253 #. type: verbatim
18254 #: ../fish/guestfish-actions.pod:5166
18255 #, no-wrap
18256 msgid ""
18257 " umount-all\n"
18258 "\n"
18259 msgstr ""
18260 " umount-all\n"
18261 "\n"
18262
18263 #. type: textblock
18264 #: ../fish/guestfish-actions.pod:5168 ../src/guestfs-actions.pod:7952
18265 msgid "This unmounts all mounted filesystems."
18266 msgstr ""
18267
18268 #. type: textblock
18269 #: ../fish/guestfish-actions.pod:5170 ../src/guestfs-actions.pod:7954
18270 msgid "Some internal mounts are not unmounted by this call."
18271 msgstr ""
18272
18273 #. type: =head2
18274 #: ../fish/guestfish-actions.pod:5172
18275 msgid "upload"
18276 msgstr "upload"
18277
18278 #. type: verbatim
18279 #: ../fish/guestfish-actions.pod:5174
18280 #, no-wrap
18281 msgid ""
18282 " upload (filename|-) remotefilename\n"
18283 "\n"
18284 msgstr ""
18285 " upload (назва_файла|-) назва_віддаленого_файла\n"
18286 "\n"
18287
18288 #. type: textblock
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."
18292 msgstr ""
18293
18294 #. type: textblock
18295 #: ../fish/guestfish-actions.pod:5181
18296 msgid "See also L</download>."
18297 msgstr "Див. також L</download>."
18298
18299 #. type: =head2
18300 #: ../fish/guestfish-actions.pod:5185
18301 msgid "upload-offset"
18302 msgstr "upload-offset"
18303
18304 #. type: verbatim
18305 #: ../fish/guestfish-actions.pod:5187
18306 #, no-wrap
18307 msgid ""
18308 " upload-offset (filename|-) remotefilename offset\n"
18309 "\n"
18310 msgstr ""
18311 " upload-offset (назва_файла|-) назва_віддаленого_файла відступ\n"
18312 "\n"
18313
18314 #. type: textblock
18315 #: ../fish/guestfish-actions.pod:5192 ../src/guestfs-actions.pod:7994
18316 msgid ""
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>."
18322 msgstr ""
18323
18324 #. type: textblock
18325 #: ../fish/guestfish-actions.pod:5199
18326 msgid ""
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."
18330 msgstr ""
18331
18332 #. type: textblock
18333 #: ../fish/guestfish-actions.pod:5204
18334 msgid "See also L</upload>, L</pwrite>."
18335 msgstr "Див. також L</upload>, L</pwrite>."
18336
18337 #. type: =head2
18338 #: ../fish/guestfish-actions.pod:5208
18339 msgid "utimens"
18340 msgstr "utimens"
18341
18342 #. type: verbatim
18343 #: ../fish/guestfish-actions.pod:5210
18344 #, no-wrap
18345 msgid ""
18346 " utimens path atsecs atnsecs mtsecs mtnsecs\n"
18347 "\n"
18348 msgstr ""
18349
18350 #. type: textblock
18351 #: ../fish/guestfish-actions.pod:5212 ../src/guestfs-actions.pod:8027
18352 msgid "This command sets the timestamps of a file with nanosecond precision."
18353 msgstr ""
18354
18355 #. type: textblock
18356 #: ../fish/guestfish-actions.pod:5215 ../src/guestfs-actions.pod:8030
18357 msgid ""
18358 "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds "
18359 "from the epoch."
18360 msgstr ""
18361
18362 #. type: textblock
18363 #: ../fish/guestfish-actions.pod:5218 ../src/guestfs-actions.pod:8033
18364 msgid ""
18365 "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and "
18366 "nanoseconds from the epoch."
18367 msgstr ""
18368
18369 #. type: textblock
18370 #: ../fish/guestfish-actions.pod:5221 ../src/guestfs-actions.pod:8036
18371 msgid ""
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)."
18375 msgstr ""
18376
18377 #. type: textblock
18378 #: ../fish/guestfish-actions.pod:5225 ../src/guestfs-actions.pod:8040
18379 msgid ""
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 "
18382 "in this case)."
18383 msgstr ""
18384
18385 #. type: =head2
18386 #: ../fish/guestfish-actions.pod:5229
18387 msgid "version"
18388 msgstr "version"
18389
18390 #. type: verbatim
18391 #: ../fish/guestfish-actions.pod:5231
18392 #, no-wrap
18393 msgid ""
18394 " version\n"
18395 "\n"
18396 msgstr ""
18397 " version\n"
18398 "\n"
18399
18400 #. type: textblock
18401 #: ../fish/guestfish-actions.pod:5233 ../src/guestfs-actions.pod:8053
18402 msgid ""
18403 "Return the libguestfs version number that the program is linked against."
18404 msgstr ""
18405
18406 #. type: textblock
18407 #: ../fish/guestfish-actions.pod:5236 ../src/guestfs-actions.pod:8056
18408 msgid ""
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> "
18412 "library."
18413 msgstr ""
18414
18415 #. type: textblock
18416 #: ../fish/guestfish-actions.pod:5241 ../src/guestfs-actions.pod:8061
18417 msgid ""
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)."
18422 msgstr ""
18423
18424 #. type: textblock
18425 #: ../fish/guestfish-actions.pod:5247 ../src/guestfs-actions.pod:8067
18426 msgid ""
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."
18431 msgstr ""
18432
18433 #. type: textblock
18434 #: ../fish/guestfish-actions.pod:5253 ../src/guestfs-actions.pod:8073
18435 msgid ""
18436 "To construct the original version string: C<$major.$minor.$release$extra>"
18437 msgstr ""
18438
18439 #. type: textblock
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>."
18443
18444 #. type: textblock
18445 #: ../fish/guestfish-actions.pod:5258
18446 msgid ""
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."
18451 msgstr ""
18452
18453 #. type: =head2
18454 #: ../fish/guestfish-actions.pod:5264
18455 msgid "vfs-label"
18456 msgstr "vfs-label"
18457
18458 #. type: verbatim
18459 #: ../fish/guestfish-actions.pod:5266
18460 #, no-wrap
18461 msgid ""
18462 " vfs-label device\n"
18463 "\n"
18464 msgstr ""
18465 " vfs-label пристрій\n"
18466 "\n"
18467
18468 #. type: textblock
18469 #: ../fish/guestfish-actions.pod:5268 ../src/guestfs-actions.pod:8096
18470 msgid "This returns the filesystem label of the filesystem on C<device>."
18471 msgstr ""
18472
18473 #. type: textblock
18474 #: ../fish/guestfish-actions.pod:5271 ../src/guestfs-actions.pod:8099
18475 msgid "If the filesystem is unlabeled, this returns the empty string."
18476 msgstr ""
18477
18478 #. type: textblock
18479 #: ../fish/guestfish-actions.pod:5273
18480 msgid "To find a filesystem from the label, use L</findfs-label>."
18481 msgstr ""
18482
18483 #. type: =head2
18484 #: ../fish/guestfish-actions.pod:5275
18485 msgid "vfs-type"
18486 msgstr "vfs-type"
18487
18488 #. type: verbatim
18489 #: ../fish/guestfish-actions.pod:5277
18490 #, no-wrap
18491 msgid ""
18492 " vfs-type device\n"
18493 "\n"
18494 msgstr ""
18495 " vfs-type пристрій\n"
18496 "\n"
18497
18498 #. type: textblock
18499 #: ../fish/guestfish-actions.pod:5279 ../src/guestfs-actions.pod:8114
18500 msgid ""
18501 "This command gets the filesystem type corresponding to the filesystem on "
18502 "C<device>."
18503 msgstr ""
18504
18505 #. type: textblock
18506 #: ../fish/guestfish-actions.pod:5282 ../src/guestfs-actions.pod:8117
18507 msgid ""
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>."
18511 msgstr ""
18512
18513 #. type: =head2
18514 #: ../fish/guestfish-actions.pod:5287
18515 msgid "vfs-uuid"
18516 msgstr "vfs-uuid"
18517
18518 #. type: verbatim
18519 #: ../fish/guestfish-actions.pod:5289
18520 #, no-wrap
18521 msgid ""
18522 " vfs-uuid device\n"
18523 "\n"
18524 msgstr ""
18525 " vfs-uuid пристрій\n"
18526 "\n"
18527
18528 #. type: textblock
18529 #: ../fish/guestfish-actions.pod:5291 ../src/guestfs-actions.pod:8133
18530 msgid "This returns the filesystem UUID of the filesystem on C<device>."
18531 msgstr ""
18532
18533 #. type: textblock
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."
18536 msgstr ""
18537
18538 #. type: textblock
18539 #: ../fish/guestfish-actions.pod:5296
18540 msgid "To find a filesystem from the UUID, use L</findfs-uuid>."
18541 msgstr ""
18542
18543 #. type: =head2
18544 #: ../fish/guestfish-actions.pod:5298
18545 msgid "vg-activate"
18546 msgstr "vg-activate"
18547
18548 #. type: verbatim
18549 #: ../fish/guestfish-actions.pod:5300
18550 #, no-wrap
18551 msgid ""
18552 " vg-activate true|false 'volgroups ...'\n"
18553 "\n"
18554 msgstr ""
18555
18556 #. type: textblock
18557 #: ../fish/guestfish-actions.pod:5302 ../src/guestfs-actions.pod:8152
18558 msgid ""
18559 "This command activates or (if C<activate> is false) deactivates all logical "
18560 "volumes in the listed volume groups C<volgroups>."
18561 msgstr ""
18562
18563 #. type: textblock
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...>"
18566 msgstr ""
18567
18568 #. type: textblock
18569 #: ../fish/guestfish-actions.pod:5307 ../src/guestfs-actions.pod:8157
18570 msgid ""
18571 "Note that if C<volgroups> is an empty list then B<all> volume groups are "
18572 "activated or deactivated."
18573 msgstr ""
18574
18575 #. type: =head2
18576 #: ../fish/guestfish-actions.pod:5310
18577 msgid "vg-activate-all"
18578 msgstr "vg-activate-all"
18579
18580 #. type: verbatim
18581 #: ../fish/guestfish-actions.pod:5312
18582 #, no-wrap
18583 msgid ""
18584 " vg-activate-all true|false\n"
18585 "\n"
18586 msgstr ""
18587 " vg-activate-all true|false\n"
18588 "\n"
18589
18590 #. type: textblock
18591 #: ../fish/guestfish-actions.pod:5314 ../src/guestfs-actions.pod:8170
18592 msgid ""
18593 "This command activates or (if C<activate> is false) deactivates all logical "
18594 "volumes in all volume groups."
18595 msgstr ""
18596
18597 #. type: textblock
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>"
18600 msgstr ""
18601
18602 #. type: =head2
18603 #: ../fish/guestfish-actions.pod:5319
18604 msgid "vgcreate"
18605 msgstr "vgcreate"
18606
18607 #. type: verbatim
18608 #: ../fish/guestfish-actions.pod:5321
18609 #, no-wrap
18610 msgid ""
18611 " vgcreate volgroup 'physvols ...'\n"
18612 "\n"
18613 msgstr ""
18614
18615 #. type: textblock
18616 #: ../fish/guestfish-actions.pod:5323 ../src/guestfs-actions.pod:8186
18617 msgid ""
18618 "This creates an LVM volume group called C<volgroup> from the non-empty list "
18619 "of physical volumes C<physvols>."
18620 msgstr ""
18621
18622 #. type: =head2
18623 #: ../fish/guestfish-actions.pod:5326
18624 msgid "vglvuuids"
18625 msgstr "vglvuuids"
18626
18627 #. type: verbatim
18628 #: ../fish/guestfish-actions.pod:5328
18629 #, no-wrap
18630 msgid ""
18631 " vglvuuids vgname\n"
18632 "\n"
18633 msgstr ""
18634
18635 #. type: textblock
18636 #: ../fish/guestfish-actions.pod:5330 ../src/guestfs-actions.pod:8199
18637 msgid ""
18638 "Given a VG called C<vgname>, this returns the UUIDs of all the logical "
18639 "volumes created in this volume group."
18640 msgstr ""
18641
18642 #. type: textblock
18643 #: ../fish/guestfish-actions.pod:5333
18644 msgid ""
18645 "You can use this along with L</lvs> and L</lvuuid> calls to associate "
18646 "logical volumes and volume groups."
18647 msgstr ""
18648
18649 #. type: textblock
18650 #: ../fish/guestfish-actions.pod:5336
18651 msgid "See also L</vgpvuuids>."
18652 msgstr "Див. також L</vgpvuuids>."
18653
18654 #. type: =head2
18655 #: ../fish/guestfish-actions.pod:5338
18656 msgid "vgpvuuids"
18657 msgstr "vgpvuuids"
18658
18659 #. type: verbatim
18660 #: ../fish/guestfish-actions.pod:5340
18661 #, no-wrap
18662 msgid ""
18663 " vgpvuuids vgname\n"
18664 "\n"
18665 msgstr ""
18666
18667 #. type: textblock
18668 #: ../fish/guestfish-actions.pod:5342 ../src/guestfs-actions.pod:8219
18669 msgid ""
18670 "Given a VG called C<vgname>, this returns the UUIDs of all the physical "
18671 "volumes that this volume group resides on."
18672 msgstr ""
18673
18674 #. type: textblock
18675 #: ../fish/guestfish-actions.pod:5345
18676 msgid ""
18677 "You can use this along with L</pvs> and L</pvuuid> calls to associate "
18678 "physical volumes and volume groups."
18679 msgstr ""
18680
18681 #. type: textblock
18682 #: ../fish/guestfish-actions.pod:5348
18683 msgid "See also L</vglvuuids>."
18684 msgstr "Див. також L</vglvuuids>."
18685
18686 #. type: =head2
18687 #: ../fish/guestfish-actions.pod:5350
18688 msgid "vgremove"
18689 msgstr "vgremove"
18690
18691 #. type: verbatim
18692 #: ../fish/guestfish-actions.pod:5352
18693 #, no-wrap
18694 msgid ""
18695 " vgremove vgname\n"
18696 "\n"
18697 msgstr ""
18698
18699 #. type: textblock
18700 #: ../fish/guestfish-actions.pod:5354 ../src/guestfs-actions.pod:8239
18701 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)."
18702 msgstr ""
18703
18704 #. type: textblock
18705 #: ../fish/guestfish-actions.pod:5356 ../src/guestfs-actions.pod:8241
18706 msgid ""
18707 "This also forcibly removes all logical volumes in the volume group (if any)."
18708 msgstr ""
18709
18710 #. type: =head2
18711 #: ../fish/guestfish-actions.pod:5359
18712 msgid "vgrename"
18713 msgstr "vgrename"
18714
18715 #. type: verbatim
18716 #: ../fish/guestfish-actions.pod:5361
18717 #, no-wrap
18718 msgid ""
18719 " vgrename volgroup newvolgroup\n"
18720 "\n"
18721 msgstr ""
18722
18723 #. type: textblock
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>."
18726 msgstr ""
18727
18728 #. type: =head2
18729 #: ../fish/guestfish-actions.pod:5365
18730 msgid "vgs"
18731 msgstr "vgs"
18732
18733 #. type: verbatim
18734 #: ../fish/guestfish-actions.pod:5367
18735 #, no-wrap
18736 msgid ""
18737 " vgs\n"
18738 "\n"
18739 msgstr ""
18740 " vgs\n"
18741 "\n"
18742
18743 #. type: textblock
18744 #: ../fish/guestfish-actions.pod:5369 ../src/guestfs-actions.pod:8266
18745 msgid ""
18746 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
18747 "> command."
18748 msgstr ""
18749
18750 #. type: textblock
18751 #: ../fish/guestfish-actions.pod:5372 ../src/guestfs-actions.pod:8269
18752 msgid ""
18753 "This returns a list of just the volume group names that were detected (eg. "
18754 "C<VolGroup00>)."
18755 msgstr ""
18756
18757 #. type: textblock
18758 #: ../fish/guestfish-actions.pod:5375
18759 msgid "See also L</vgs-full>."
18760 msgstr "Див. також L</vgs-full>."
18761
18762 #. type: =head2
18763 #: ../fish/guestfish-actions.pod:5377
18764 msgid "vgs-full"
18765 msgstr "vgs-full"
18766
18767 #. type: verbatim
18768 #: ../fish/guestfish-actions.pod:5379
18769 #, no-wrap
18770 msgid ""
18771 " vgs-full\n"
18772 "\n"
18773 msgstr ""
18774 " vgs-full\n"
18775 "\n"
18776
18777 #. type: textblock
18778 #: ../fish/guestfish-actions.pod:5381 ../src/guestfs-actions.pod:8285
18779 msgid ""
18780 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
18781 "> command.  The \"full\" version includes all fields."
18782 msgstr ""
18783
18784 #. type: =head2
18785 #: ../fish/guestfish-actions.pod:5384
18786 msgid "vgscan"
18787 msgstr "vgscan"
18788
18789 #. type: verbatim
18790 #: ../fish/guestfish-actions.pod:5386
18791 #, no-wrap
18792 msgid ""
18793 " vgscan\n"
18794 "\n"
18795 msgstr ""
18796 " vgscan\n"
18797 "\n"
18798
18799 #. type: textblock
18800 #: ../fish/guestfish-actions.pod:5388 ../src/guestfs-actions.pod:8299
18801 msgid ""
18802 "This rescans all block devices and rebuilds the list of LVM physical "
18803 "volumes, volume groups and logical volumes."
18804 msgstr ""
18805
18806 #. type: =head2
18807 #: ../fish/guestfish-actions.pod:5391
18808 msgid "vguuid"
18809 msgstr "vguuid"
18810
18811 #. type: verbatim
18812 #: ../fish/guestfish-actions.pod:5393
18813 #, no-wrap
18814 msgid ""
18815 " vguuid vgname\n"
18816 "\n"
18817 msgstr ""
18818
18819 #. type: textblock
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>."
18822 msgstr ""
18823
18824 #. type: =head2
18825 #: ../fish/guestfish-actions.pod:5397
18826 msgid "wc-c"
18827 msgstr "wc-c"
18828
18829 #. type: verbatim
18830 #: ../fish/guestfish-actions.pod:5399
18831 #, no-wrap
18832 msgid ""
18833 " wc-c path\n"
18834 "\n"
18835 msgstr ""
18836 " wc-c шлях\n"
18837 "\n"
18838
18839 #. type: textblock
18840 #: ../fish/guestfish-actions.pod:5401 ../src/guestfs-actions.pod:8352
18841 msgid ""
18842 "This command counts the characters in a file, using the C<wc -c> external "
18843 "command."
18844 msgstr ""
18845
18846 #. type: =head2
18847 #: ../fish/guestfish-actions.pod:5404
18848 msgid "wc-l"
18849 msgstr "wc-l"
18850
18851 #. type: verbatim
18852 #: ../fish/guestfish-actions.pod:5406
18853 #, no-wrap
18854 msgid ""
18855 " wc-l path\n"
18856 "\n"
18857 msgstr ""
18858 " wc-l шлях\n"
18859 "\n"
18860
18861 #. type: textblock
18862 #: ../fish/guestfish-actions.pod:5408 ../src/guestfs-actions.pod:8365
18863 msgid ""
18864 "This command counts the lines in a file, using the C<wc -l> external command."
18865 msgstr ""
18866
18867 #. type: =head2
18868 #: ../fish/guestfish-actions.pod:5411
18869 msgid "wc-w"
18870 msgstr "wc-w"
18871
18872 #. type: verbatim
18873 #: ../fish/guestfish-actions.pod:5413
18874 #, no-wrap
18875 msgid ""
18876 " wc-w path\n"
18877 "\n"
18878 msgstr ""
18879 " wc-w шлях\n"
18880 "\n"
18881
18882 #. type: textblock
18883 #: ../fish/guestfish-actions.pod:5415 ../src/guestfs-actions.pod:8378
18884 msgid ""
18885 "This command counts the words in a file, using the C<wc -w> external command."
18886 msgstr ""
18887
18888 #. type: =head2
18889 #: ../fish/guestfish-actions.pod:5418
18890 msgid "write"
18891 msgstr "write"
18892
18893 #. type: verbatim
18894 #: ../fish/guestfish-actions.pod:5420
18895 #, no-wrap
18896 msgid ""
18897 " write path content\n"
18898 "\n"
18899 msgstr ""
18900 " write шлях дані\n"
18901 "\n"
18902
18903 #. type: textblock
18904 #: ../fish/guestfish-actions.pod:5422 ../src/guestfs-actions.pod:8393
18905 msgid ""
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)."
18908 msgstr ""
18909
18910 #. type: textblock
18911 #: ../fish/guestfish-actions.pod:5425
18912 msgid "See also L</write-append>."
18913 msgstr "Див. також L</write-append>."
18914
18915 #. type: =head2
18916 #: ../fish/guestfish-actions.pod:5430
18917 msgid "write-append"
18918 msgstr ""
18919
18920 #. type: verbatim
18921 #: ../fish/guestfish-actions.pod:5432
18922 #, no-wrap
18923 msgid ""
18924 " write-append path content\n"
18925 "\n"
18926 msgstr ""
18927
18928 #. type: textblock
18929 #: ../fish/guestfish-actions.pod:5434 ../src/guestfs-actions.pod:8413
18930 msgid ""
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."
18933 msgstr ""
18934
18935 #. type: textblock
18936 #: ../fish/guestfish-actions.pod:5437
18937 msgid "See also L</write>."
18938 msgstr "Див. також L</write>."
18939
18940 #. type: =head2
18941 #: ../fish/guestfish-actions.pod:5442
18942 msgid "write-file"
18943 msgstr "write-file"
18944
18945 #. type: verbatim
18946 #: ../fish/guestfish-actions.pod:5444
18947 #, no-wrap
18948 msgid ""
18949 " write-file path content size\n"
18950 "\n"
18951 msgstr ""
18952
18953 #. type: textblock
18954 #: ../fish/guestfish-actions.pod:5446 ../src/guestfs-actions.pod:8440
18955 msgid ""
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>."
18958 msgstr ""
18959
18960 #. type: textblock
18961 #: ../fish/guestfish-actions.pod:5450 ../src/guestfs-actions.pod:8444
18962 msgid ""
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)."
18965 msgstr ""
18966
18967 #. type: textblock
18968 #: ../fish/guestfish-actions.pod:5454 ../src/guestfs-actions.pod:8448
18969 msgid ""
18970 "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does "
18971 "I<not> work, even if the length is specified."
18972 msgstr ""
18973
18974 #. type: textblock
18975 #: ../fish/guestfish-actions.pod:5460
18976 msgid ""
18977 "I<This function is deprecated.> In new code, use the L</write> call instead."
18978 msgstr ""
18979
18980 #. type: =head2
18981 #: ../fish/guestfish-actions.pod:5467
18982 msgid "zegrep"
18983 msgstr "zegrep"
18984
18985 #. type: verbatim
18986 #: ../fish/guestfish-actions.pod:5469
18987 #, no-wrap
18988 msgid ""
18989 " zegrep regex path\n"
18990 "\n"
18991 msgstr ""
18992 " zegrep формальний_вираз шлях\n"
18993 "\n"
18994
18995 #. type: textblock
18996 #: ../fish/guestfish-actions.pod:5471 ../src/guestfs-actions.pod:8465
18997 msgid ""
18998 "This calls the external C<zegrep> program and returns the matching lines."
18999 msgstr ""
19000
19001 #. type: =head2
19002 #: ../fish/guestfish-actions.pod:5477
19003 msgid "zegrepi"
19004 msgstr "zegrepi"
19005
19006 #. type: verbatim
19007 #: ../fish/guestfish-actions.pod:5479
19008 #, no-wrap
19009 msgid ""
19010 " zegrepi regex path\n"
19011 "\n"
19012 msgstr ""
19013
19014 #. type: textblock
19015 #: ../fish/guestfish-actions.pod:5481 ../src/guestfs-actions.pod:8484
19016 msgid ""
19017 "This calls the external C<zegrep -i> program and returns the matching lines."
19018 msgstr ""
19019
19020 #. type: =head2
19021 #: ../fish/guestfish-actions.pod:5487
19022 msgid "zero"
19023 msgstr "zero"
19024
19025 #. type: verbatim
19026 #: ../fish/guestfish-actions.pod:5489
19027 #, no-wrap
19028 msgid ""
19029 " zero device\n"
19030 "\n"
19031 msgstr ""
19032 " zero пристрій\n"
19033 "\n"
19034
19035 #. type: textblock
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>."
19038 msgstr ""
19039
19040 #. type: textblock
19041 #: ../fish/guestfish-actions.pod:5493 ../src/guestfs-actions.pod:8504
19042 msgid ""
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."
19046 msgstr ""
19047
19048 #. type: textblock
19049 #: ../fish/guestfish-actions.pod:5497 ../fish/guestfish-actions.pod:5512
19050 #: ../src/guestfs-actions.pod:8508 ../src/guestfs-actions.pod:8534
19051 msgid ""
19052 "If blocks are already zero, then this command avoids writing zeroes.  This "
19053 "prevents the underlying device from becoming non-sparse or growing "
19054 "unnecessarily."
19055 msgstr ""
19056
19057 #. type: textblock
19058 #: ../fish/guestfish-actions.pod:5501
19059 msgid "See also: L</zero-device>, L</scrub-device>, L</is-zero-device>"
19060 msgstr ""
19061
19062 #. type: =head2
19063 #: ../fish/guestfish-actions.pod:5504
19064 msgid "zero-device"
19065 msgstr "zero-device"
19066
19067 #. type: verbatim
19068 #: ../fish/guestfish-actions.pod:5506
19069 #, no-wrap
19070 msgid ""
19071 " zero-device device\n"
19072 "\n"
19073 msgstr ""
19074 " zero-device пристрій\n"
19075 "\n"
19076
19077 #. type: textblock
19078 #: ../fish/guestfish-actions.pod:5508
19079 msgid ""
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."
19082 msgstr ""
19083
19084 #. type: =head2
19085 #: ../fish/guestfish-actions.pod:5516
19086 msgid "zerofree"
19087 msgstr "zerofree"
19088
19089 #. type: verbatim
19090 #: ../fish/guestfish-actions.pod:5518
19091 #, no-wrap
19092 msgid ""
19093 " zerofree device\n"
19094 "\n"
19095 msgstr ""
19096 " zerofree пристрій\n"
19097 "\n"
19098
19099 #. type: textblock
19100 #: ../fish/guestfish-actions.pod:5520 ../src/guestfs-actions.pod:8553
19101 msgid ""
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."
19105 msgstr ""
19106
19107 #. type: textblock
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."
19110 msgstr ""
19111
19112 #. type: textblock
19113 #: ../fish/guestfish-actions.pod:5528 ../src/guestfs-actions.pod:8561
19114 msgid ""
19115 "It is possible that using this program can damage the filesystem or data on "
19116 "the filesystem."
19117 msgstr ""
19118
19119 #. type: =head2
19120 #: ../fish/guestfish-actions.pod:5531
19121 msgid "zfgrep"
19122 msgstr "zfgrep"
19123
19124 #. type: verbatim
19125 #: ../fish/guestfish-actions.pod:5533
19126 #, no-wrap
19127 msgid ""
19128 " zfgrep pattern path\n"
19129 "\n"
19130 msgstr ""
19131 " zfgrep шаблон шлях\n"
19132 "\n"
19133
19134 #. type: textblock
19135 #: ../fish/guestfish-actions.pod:5535 ../src/guestfs-actions.pod:8575
19136 msgid ""
19137 "This calls the external C<zfgrep> program and returns the matching lines."
19138 msgstr ""
19139
19140 #. type: =head2
19141 #: ../fish/guestfish-actions.pod:5541
19142 msgid "zfgrepi"
19143 msgstr "zfgrepi"
19144
19145 #. type: verbatim
19146 #: ../fish/guestfish-actions.pod:5543
19147 #, no-wrap
19148 msgid ""
19149 " zfgrepi pattern path\n"
19150 "\n"
19151 msgstr ""
19152 " zfgrepi шаблон шлях\n"
19153 "\n"
19154
19155 #. type: textblock
19156 #: ../fish/guestfish-actions.pod:5545 ../src/guestfs-actions.pod:8594
19157 msgid ""
19158 "This calls the external C<zfgrep -i> program and returns the matching lines."
19159 msgstr ""
19160
19161 #. type: =head2
19162 #: ../fish/guestfish-actions.pod:5551
19163 msgid "zfile"
19164 msgstr "zfile"
19165
19166 #. type: verbatim
19167 #: ../fish/guestfish-actions.pod:5553
19168 #, no-wrap
19169 msgid ""
19170 " zfile meth path\n"
19171 "\n"
19172 msgstr ""
19173 " zfile метод шлях\n"
19174 "\n"
19175
19176 #. type: textblock
19177 #: ../fish/guestfish-actions.pod:5555 ../src/guestfs-actions.pod:8620
19178 msgid ""
19179 "This command runs C<file> after first decompressing C<path> using C<method>."
19180 msgstr ""
19181
19182 #. type: textblock
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>."
19185 msgstr ""
19186
19187 #. type: textblock
19188 #: ../fish/guestfish-actions.pod:5560
19189 msgid ""
19190 "Since 1.0.63, use L</file> instead which can now process compressed files."
19191 msgstr ""
19192
19193 #. type: textblock
19194 #: ../fish/guestfish-actions.pod:5563
19195 msgid ""
19196 "I<This function is deprecated.> In new code, use the L</file> call instead."
19197 msgstr ""
19198
19199 #. type: =head2
19200 #: ../fish/guestfish-actions.pod:5570
19201 msgid "zgrep"
19202 msgstr "zgrep"
19203
19204 #. type: verbatim
19205 #: ../fish/guestfish-actions.pod:5572
19206 #, no-wrap
19207 msgid ""
19208 " zgrep regex path\n"
19209 "\n"
19210 msgstr ""
19211 " zgrep формальний_вираз шлях\n"
19212 "\n"
19213
19214 #. type: textblock
19215 #: ../fish/guestfish-actions.pod:5574 ../src/guestfs-actions.pod:8640
19216 msgid ""
19217 "This calls the external C<zgrep> program and returns the matching lines."
19218 msgstr ""
19219
19220 #. type: =head2
19221 #: ../fish/guestfish-actions.pod:5580
19222 msgid "zgrepi"
19223 msgstr "zgrepi"
19224
19225 #. type: verbatim
19226 #: ../fish/guestfish-actions.pod:5582
19227 #, no-wrap
19228 msgid ""
19229 " zgrepi regex path\n"
19230 "\n"
19231 msgstr ""
19232 " zgrepi формальний_вираз шлях\n"
19233 "\n"
19234
19235 #. type: textblock
19236 #: ../fish/guestfish-actions.pod:5584 ../src/guestfs-actions.pod:8659
19237 msgid ""
19238 "This calls the external C<zgrep -i> program and returns the matching lines."
19239 msgstr ""
19240
19241 #. type: =head2
19242 #: ../fish/guestfish-commands.pod:1
19243 msgid "alloc"
19244 msgstr "alloc"
19245
19246 #. type: =head2
19247 #: ../fish/guestfish-commands.pod:3
19248 msgid "allocate"
19249 msgstr ""
19250
19251 #. type: verbatim
19252 #: ../fish/guestfish-commands.pod:5
19253 #, no-wrap
19254 msgid ""
19255 " alloc filename size\n"
19256 "\n"
19257 msgstr ""
19258
19259 #. type: textblock
19260 #: ../fish/guestfish-commands.pod:7
19261 msgid ""
19262 "This creates an empty (zeroed) file of the given size, and then adds so it "
19263 "can be further examined."
19264 msgstr ""
19265
19266 #. type: textblock
19267 #: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:193
19268 msgid "For more advanced image creation, see L<qemu-img(1)> utility."
19269 msgstr ""
19270
19271 #. type: textblock
19272 #: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:195
19273 msgid "Size can be specified using standard suffixes, eg. C<1M>."
19274 msgstr ""
19275
19276 #. type: textblock
19277 #: ../fish/guestfish-commands.pod:14
19278 msgid ""
19279 "To create a sparse file, use L</sparse> instead.  To create a prepared disk "
19280 "image, see L</PREPARED DISK IMAGES>."
19281 msgstr ""
19282
19283 #. type: =head2
19284 #: ../fish/guestfish-commands.pod:17
19285 msgid "copy-in"
19286 msgstr "copy-in"
19287
19288 #. type: verbatim
19289 #: ../fish/guestfish-commands.pod:19
19290 #, no-wrap
19291 msgid ""
19292 " copy-in local [local ...] /remotedir\n"
19293 "\n"
19294 msgstr ""
19295
19296 #. type: textblock
19297 #: ../fish/guestfish-commands.pod:21
19298 msgid ""
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."
19303 msgstr ""
19304
19305 #. type: textblock
19306 #: ../fish/guestfish-commands.pod:26
19307 msgid ""
19308 "Multiple local files and directories can be specified, but the last "
19309 "parameter must always be a remote directory.  Wildcards cannot be used."
19310 msgstr ""
19311
19312 #. type: =head2
19313 #: ../fish/guestfish-commands.pod:30
19314 msgid "copy-out"
19315 msgstr "copy-out"
19316
19317 #. type: verbatim
19318 #: ../fish/guestfish-commands.pod:32
19319 #, no-wrap
19320 msgid ""
19321 " copy-out remote [remote ...] localdir\n"
19322 "\n"
19323 msgstr ""
19324
19325 #. type: textblock
19326 #: ../fish/guestfish-commands.pod:34
19327 msgid ""
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."
19332 msgstr ""
19333
19334 #. type: textblock
19335 #: ../fish/guestfish-commands.pod:40
19336 msgid ""
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:"
19340 msgstr ""
19341
19342 #. type: verbatim
19343 #: ../fish/guestfish-commands.pod:44
19344 #, no-wrap
19345 msgid ""
19346 " copy-out /home .\n"
19347 "\n"
19348 msgstr ""
19349 " copy-out /home .\n"
19350 "\n"
19351
19352 #. type: textblock
19353 #: ../fish/guestfish-commands.pod:46
19354 msgid ""
19355 "Wildcards cannot be used in the ordinary command, but you can use them with "
19356 "the help of L</glob> like this:"
19357 msgstr ""
19358
19359 #. type: verbatim
19360 #: ../fish/guestfish-commands.pod:49
19361 #, no-wrap
19362 msgid ""
19363 " glob copy-out /home/* .\n"
19364 "\n"
19365 msgstr ""
19366 " glob copy-out /home/* .\n"
19367 "\n"
19368
19369 #. type: =head2
19370 #: ../fish/guestfish-commands.pod:51
19371 msgid "display"
19372 msgstr ""
19373
19374 #. type: verbatim
19375 #: ../fish/guestfish-commands.pod:53
19376 #, no-wrap
19377 msgid ""
19378 " display filename\n"
19379 "\n"
19380 msgstr ""
19381
19382 #. type: textblock
19383 #: ../fish/guestfish-commands.pod:55
19384 msgid ""
19385 "Use C<display> (a graphical display program) to display an image file.  It "
19386 "downloads the file, and runs C<display> on it."
19387 msgstr ""
19388
19389 #. type: textblock
19390 #: ../fish/guestfish-commands.pod:58
19391 msgid ""
19392 "To use an alternative program, set the C<GUESTFISH_DISPLAY_IMAGE> "
19393 "environment variable.  For example to use the GNOME display program:"
19394 msgstr ""
19395
19396 #. type: verbatim
19397 #: ../fish/guestfish-commands.pod:61
19398 #, no-wrap
19399 msgid ""
19400 " export GUESTFISH_DISPLAY_IMAGE=eog\n"
19401 "\n"
19402 msgstr ""
19403
19404 #. type: textblock
19405 #: ../fish/guestfish-commands.pod:63
19406 msgid "See also L<display(1)>."
19407 msgstr "Див. також L<display(1)>."
19408
19409 #. type: =head2
19410 #: ../fish/guestfish-commands.pod:65
19411 msgid "echo"
19412 msgstr "echo"
19413
19414 #. type: verbatim
19415 #: ../fish/guestfish-commands.pod:67
19416 #, no-wrap
19417 msgid ""
19418 " echo [params ...]\n"
19419 "\n"
19420 msgstr ""
19421 " echo [параметри...]\n"
19422 "\n"
19423
19424 #. type: textblock
19425 #: ../fish/guestfish-commands.pod:69
19426 msgid "This echos the parameters to the terminal."
19427 msgstr ""
19428
19429 #. type: =head2
19430 #: ../fish/guestfish-commands.pod:71
19431 msgid "edit"
19432 msgstr "edit"
19433
19434 #. type: =head2
19435 #: ../fish/guestfish-commands.pod:73
19436 msgid "vi"
19437 msgstr "vi"
19438
19439 #. type: =head2
19440 #: ../fish/guestfish-commands.pod:75
19441 msgid "emacs"
19442 msgstr "emacs"
19443
19444 #. type: verbatim
19445 #: ../fish/guestfish-commands.pod:77
19446 #, no-wrap
19447 msgid ""
19448 " edit filename\n"
19449 "\n"
19450 msgstr ""
19451 " edit назва_файла\n"
19452 "\n"
19453
19454 #. type: textblock
19455 #: ../fish/guestfish-commands.pod:79
19456 msgid ""
19457 "This is used to edit a file.  It downloads the file, edits it locally using "
19458 "your editor, then uploads the result."
19459 msgstr ""
19460
19461 #. type: textblock
19462 #: ../fish/guestfish-commands.pod:82
19463 msgid ""
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."
19466 msgstr ""
19467
19468 #. type: =head2
19469 #: ../fish/guestfish-commands.pod:86
19470 msgid "glob"
19471 msgstr "glob"
19472
19473 #. type: verbatim
19474 #: ../fish/guestfish-commands.pod:88
19475 #, no-wrap
19476 msgid ""
19477 " glob command args...\n"
19478 "\n"
19479 msgstr ""
19480 " glob команда параметри...\n"
19481 "\n"
19482
19483 #. type: textblock
19484 #: ../fish/guestfish-commands.pod:90
19485 msgid ""
19486 "Expand wildcards in any paths in the args list, and run C<command> "
19487 "repeatedly on each matching path."
19488 msgstr ""
19489
19490 #. type: textblock
19491 #: ../fish/guestfish-commands.pod:93
19492 msgid "See L</WILDCARDS AND GLOBBING>."
19493 msgstr "Див. L</WILDCARDS AND GLOBBING>."
19494
19495 #. type: =head2
19496 #: ../fish/guestfish-commands.pod:95
19497 msgid "hexedit"
19498 msgstr "hexedit"
19499
19500 #. type: verbatim
19501 #: ../fish/guestfish-commands.pod:97
19502 #, no-wrap
19503 msgid ""
19504 " hexedit <filename|device>\n"
19505 " hexedit <filename|device> <max>\n"
19506 " hexedit <filename|device> <start> <max>\n"
19507 "\n"
19508 msgstr ""
19509
19510 #. type: textblock
19511 #: ../fish/guestfish-commands.pod:101
19512 msgid ""
19513 "Use hexedit (a hex editor) to edit all or part of a binary file or block "
19514 "device."
19515 msgstr ""
19516
19517 #. type: textblock
19518 #: ../fish/guestfish-commands.pod:104
19519 msgid ""
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)."
19525 msgstr ""
19526
19527 #. type: textblock
19528 #: ../fish/guestfish-commands.pod:111
19529 msgid "For example to edit the first few sectors of a disk you might do:"
19530 msgstr ""
19531
19532 #. type: verbatim
19533 #: ../fish/guestfish-commands.pod:114
19534 #, no-wrap
19535 msgid ""
19536 " hexedit /dev/sda 1M\n"
19537 "\n"
19538 msgstr ""
19539 " hexedit /dev/sda 1M\n"
19540 "\n"
19541
19542 #. type: textblock
19543 #: ../fish/guestfish-commands.pod:116
19544 msgid ""
19545 "which would allow you to edit anywhere within the first megabyte of the disk."
19546 msgstr ""
19547
19548 #. type: textblock
19549 #: ../fish/guestfish-commands.pod:119
19550 msgid "To edit the superblock of an ext2 filesystem on C</dev/sda1>, do:"
19551 msgstr ""
19552
19553 #. type: verbatim
19554 #: ../fish/guestfish-commands.pod:121
19555 #, no-wrap
19556 msgid ""
19557 " hexedit /dev/sda1 0x400 0x400\n"
19558 "\n"
19559 msgstr ""
19560 " hexedit /dev/sda1 0x400 0x400\n"
19561 "\n"
19562
19563 #. type: textblock
19564 #: ../fish/guestfish-commands.pod:123
19565 msgid "(assuming the superblock is in the standard location)."
19566 msgstr ""
19567
19568 #. type: textblock
19569 #: ../fish/guestfish-commands.pod:125
19570 msgid ""
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."
19573 msgstr ""
19574
19575 #. type: textblock
19576 #: ../fish/guestfish-commands.pod:129
19577 msgid "See also L</hexdump>."
19578 msgstr "Див. також L</hexdump>."
19579
19580 #. type: =head2
19581 #: ../fish/guestfish-commands.pod:131
19582 msgid "lcd"
19583 msgstr "lcd"
19584
19585 #. type: verbatim
19586 #: ../fish/guestfish-commands.pod:133
19587 #, no-wrap
19588 msgid ""
19589 " lcd directory\n"
19590 "\n"
19591 msgstr ""
19592
19593 #. type: textblock
19594 #: ../fish/guestfish-commands.pod:135
19595 msgid ""
19596 "Change the local directory, ie. the current directory of guestfish itself."
19597 msgstr ""
19598
19599 #. type: textblock
19600 #: ../fish/guestfish-commands.pod:138
19601 msgid "Note that C<!cd> won't do what you might expect."
19602 msgstr ""
19603
19604 #. type: =head2
19605 #: ../fish/guestfish-commands.pod:140
19606 msgid "man"
19607 msgstr "man"
19608
19609 #. type: =head2
19610 #: ../fish/guestfish-commands.pod:142
19611 msgid "manual"
19612 msgstr "підручник"
19613
19614 #. type: verbatim
19615 #: ../fish/guestfish-commands.pod:144
19616 #, no-wrap
19617 msgid ""
19618 "  man\n"
19619 "\n"
19620 msgstr ""
19621 "  man\n"
19622 "\n"
19623
19624 #. type: textblock
19625 #: ../fish/guestfish-commands.pod:146
19626 msgid "Opens the manual page for guestfish."
19627 msgstr ""
19628
19629 #. type: =head2
19630 #: ../fish/guestfish-commands.pod:148
19631 msgid "more"
19632 msgstr "more"
19633
19634 #. type: =head2
19635 #: ../fish/guestfish-commands.pod:150
19636 msgid "less"
19637 msgstr "less"
19638
19639 #. type: verbatim
19640 #: ../fish/guestfish-commands.pod:152
19641 #, no-wrap
19642 msgid ""
19643 " more filename\n"
19644 "\n"
19645 msgstr ""
19646
19647 #. type: verbatim
19648 #: ../fish/guestfish-commands.pod:154
19649 #, no-wrap
19650 msgid ""
19651 " less filename\n"
19652 "\n"
19653 msgstr ""
19654
19655 #. type: textblock
19656 #: ../fish/guestfish-commands.pod:156
19657 msgid "This is used to view a file."
19658 msgstr ""
19659
19660 #. type: textblock
19661 #: ../fish/guestfish-commands.pod:158
19662 msgid ""
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."
19665 msgstr ""
19666
19667 #. type: =head2
19668 #: ../fish/guestfish-commands.pod:161
19669 msgid "reopen"
19670 msgstr "reopen"
19671
19672 #. type: verbatim
19673 #: ../fish/guestfish-commands.pod:163
19674 #, no-wrap
19675 msgid ""
19676 "  reopen\n"
19677 "\n"
19678 msgstr ""
19679
19680 #. type: textblock
19681 #: ../fish/guestfish-commands.pod:165
19682 msgid ""
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."
19686 msgstr ""
19687
19688 #. type: =head2
19689 #: ../fish/guestfish-commands.pod:169
19690 msgid "setenv"
19691 msgstr ""
19692
19693 #. type: verbatim
19694 #: ../fish/guestfish-commands.pod:171
19695 #, no-wrap
19696 msgid ""
19697 "  setenv VAR value\n"
19698 "\n"
19699 msgstr ""
19700
19701 #. type: textblock
19702 #: ../fish/guestfish-commands.pod:173
19703 msgid "Set the environment variable C<VAR> to the string C<value>."
19704 msgstr ""
19705
19706 #. type: textblock
19707 #: ../fish/guestfish-commands.pod:175
19708 msgid ""
19709 "To print the value of an environment variable use a shell command such as:"
19710 msgstr ""
19711
19712 #. type: verbatim
19713 #: ../fish/guestfish-commands.pod:178
19714 #, no-wrap
19715 msgid ""
19716 " !echo $VAR\n"
19717 "\n"
19718 msgstr ""
19719
19720 #. type: =head2
19721 #: ../fish/guestfish-commands.pod:180
19722 msgid "sparse"
19723 msgstr "sparse"
19724
19725 #. type: verbatim
19726 #: ../fish/guestfish-commands.pod:182
19727 #, no-wrap
19728 msgid ""
19729 " sparse filename size\n"
19730 "\n"
19731 msgstr ""
19732
19733 #. type: textblock
19734 #: ../fish/guestfish-commands.pod:184
19735 msgid ""
19736 "This creates an empty sparse file of the given size, and then adds so it can "
19737 "be further examined."
19738 msgstr ""
19739
19740 #. type: textblock
19741 #: ../fish/guestfish-commands.pod:187
19742 msgid ""
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."
19748 msgstr ""
19749
19750 #. type: =head2
19751 #: ../fish/guestfish-commands.pod:197
19752 msgid "supported"
19753 msgstr "supported"
19754
19755 #. type: verbatim
19756 #: ../fish/guestfish-commands.pod:199
19757 #, no-wrap
19758 msgid ""
19759 " supported\n"
19760 "\n"
19761 msgstr ""
19762 " supported\n"
19763 "\n"
19764
19765 #. type: textblock
19766 #: ../fish/guestfish-commands.pod:201
19767 msgid ""
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."
19770 msgstr ""
19771
19772 #. type: textblock
19773 #: ../fish/guestfish-commands.pod:205
19774 msgid "See also L<guestfs(3)/AVAILABILITY>."
19775 msgstr "Див. також L<guestfs(3)/AVAILABILITY>."
19776
19777 #. type: =head2
19778 #: ../fish/guestfish-commands.pod:207
19779 msgid "time"
19780 msgstr "time"
19781
19782 #. type: verbatim
19783 #: ../fish/guestfish-commands.pod:209
19784 #, no-wrap
19785 msgid ""
19786 " time command args...\n"
19787 "\n"
19788 msgstr ""
19789
19790 #. type: textblock
19791 #: ../fish/guestfish-commands.pod:211
19792 msgid ""
19793 "Run the command as usual, but print the elapsed time afterwards.  This can "
19794 "be useful for benchmarking operations."
19795 msgstr ""
19796
19797 #. type: =head2
19798 #: ../fish/guestfish-commands.pod:214
19799 msgid "unsetenv"
19800 msgstr ""
19801
19802 #. type: verbatim
19803 #: ../fish/guestfish-commands.pod:216
19804 #, no-wrap
19805 msgid ""
19806 "  unsetenv VAR\n"
19807 "\n"
19808 msgstr ""
19809
19810 #. type: textblock
19811 #: ../fish/guestfish-commands.pod:218
19812 msgid "Remove C<VAR> from the environment."
19813 msgstr ""
19814
19815 #. type: textblock
19816 #: ../fish/guestfish.pod:5
19817 msgid "guestfish - the libguestfs Filesystem Interactive SHell"
19818 msgstr ""
19819
19820 #. type: verbatim
19821 #: ../fish/guestfish.pod:9
19822 #, no-wrap
19823 msgid ""
19824 " guestfish [--options] [commands]\n"
19825 "\n"
19826 msgstr ""
19827
19828 #. type: verbatim
19829 #: ../fish/guestfish.pod:11
19830 #, no-wrap
19831 msgid ""
19832 " guestfish\n"
19833 "\n"
19834 msgstr ""
19835
19836 #. type: verbatim
19837 #: ../fish/guestfish.pod:13
19838 #, no-wrap
19839 msgid ""
19840 " guestfish [--ro|--rw] -a disk.img\n"
19841 "\n"
19842 msgstr ""
19843
19844 #. type: verbatim
19845 #: ../fish/guestfish.pod:15
19846 #, no-wrap
19847 msgid ""
19848 " guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]\n"
19849 "\n"
19850 msgstr ""
19851
19852 #. type: verbatim
19853 #: ../fish/guestfish.pod:17
19854 #, no-wrap
19855 msgid ""
19856 " guestfish -d libvirt-domain\n"
19857 "\n"
19858 msgstr ""
19859
19860 #. type: verbatim
19861 #: ../fish/guestfish.pod:19
19862 #, no-wrap
19863 msgid ""
19864 " guestfish [--ro|--rw] -a disk.img -i\n"
19865 "\n"
19866 msgstr ""
19867
19868 #. type: verbatim
19869 #: ../fish/guestfish.pod:21
19870 #, no-wrap
19871 msgid ""
19872 " guestfish -d libvirt-domain -i\n"
19873 "\n"
19874 msgstr ""
19875
19876 #. type: textblock
19877 #: ../fish/guestfish.pod:25
19878 msgid ""
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 "
19882 "live."
19883 msgstr ""
19884
19885 #. type: textblock
19886 #: ../fish/guestfish.pod:32
19887 msgid ""
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)>."
19891 msgstr ""
19892
19893 #. type: textblock
19894 #: ../fish/guestfish.pod:36
19895 msgid ""
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)> "
19899 "command."
19900 msgstr ""
19901
19902 #. type: =head2
19903 #: ../fish/guestfish.pod:43
19904 msgid "As an interactive shell"
19905 msgstr ""
19906
19907 #. type: verbatim
19908 #: ../fish/guestfish.pod:45
19909 #, no-wrap
19910 msgid ""
19911 " $ guestfish\n"
19912 " \n"
19913 msgstr ""
19914
19915 #. type: verbatim
19916 #: ../fish/guestfish.pod:47
19917 #, no-wrap
19918 msgid ""
19919 " Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
19920 " editing virtual machine filesystems.\n"
19921 " \n"
19922 msgstr ""
19923
19924 #. type: verbatim
19925 #: ../fish/guestfish.pod:50
19926 #, no-wrap
19927 msgid ""
19928 " Type: 'help' for a list of commands\n"
19929 "       'man' to read the manual\n"
19930 "       'quit' to quit the shell\n"
19931 " \n"
19932 msgstr ""
19933
19934 #. type: verbatim
19935 #: ../fish/guestfish.pod:54
19936 #, no-wrap
19937 msgid ""
19938 " ><fs> add-ro disk.img\n"
19939 " ><fs> run\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"
19946 " # /etc/fstab\n"
19947 " # Created by anaconda\n"
19948 " [...]\n"
19949 " ><fs> exit\n"
19950 "\n"
19951 msgstr ""
19952
19953 #. type: =head2
19954 #: ../fish/guestfish.pod:67
19955 msgid "From shell scripts"
19956 msgstr ""
19957
19958 #. type: textblock
19959 #: ../fish/guestfish.pod:69
19960 msgid "Create a new C</etc/motd> file in a guest or disk image:"
19961 msgstr ""
19962
19963 #. type: verbatim
19964 #: ../fish/guestfish.pod:71
19965 #, no-wrap
19966 msgid ""
19967 " guestfish <<_EOF_\n"
19968 " add disk.img\n"
19969 " run\n"
19970 " mount /dev/vg_guest/lv_root /\n"
19971 " write /etc/motd \"Welcome, new users\"\n"
19972 " _EOF_\n"
19973 "\n"
19974 msgstr ""
19975
19976 #. type: textblock
19977 #: ../fish/guestfish.pod:78
19978 msgid "List the LVM logical volumes in a disk image:"
19979 msgstr ""
19980
19981 #. type: verbatim
19982 #: ../fish/guestfish.pod:80
19983 #, no-wrap
19984 msgid ""
19985 " guestfish -a disk.img --ro <<_EOF_\n"
19986 " run\n"
19987 " lvs\n"
19988 " _EOF_\n"
19989 "\n"
19990 msgstr ""
19991
19992 #. type: textblock
19993 #: ../fish/guestfish.pod:85
19994 msgid "List all the filesystems in a disk image:"
19995 msgstr ""
19996
19997 #. type: verbatim
19998 #: ../fish/guestfish.pod:87
19999 #, no-wrap
20000 msgid ""
20001 " guestfish -a disk.img --ro <<_EOF_\n"
20002 " run\n"
20003 " list-filesystems\n"
20004 " _EOF_\n"
20005 "\n"
20006 msgstr ""
20007
20008 #. type: =head2
20009 #: ../fish/guestfish.pod:92
20010 msgid "On one command line"
20011 msgstr ""
20012
20013 #. type: textblock
20014 #: ../fish/guestfish.pod:94 ../fish/virt-copy-in.pod:31
20015 msgid "Update C</etc/resolv.conf> in a guest:"
20016 msgstr ""
20017
20018 #. type: verbatim
20019 #: ../fish/guestfish.pod:96
20020 #, no-wrap
20021 msgid ""
20022 " guestfish \\\n"
20023 "   add disk.img : run : mount /dev/vg_guest/lv_root / : \\\n"
20024 "   write /etc/resolv.conf \"nameserver 1.2.3.4\"\n"
20025 "\n"
20026 msgstr ""
20027
20028 #. type: textblock
20029 #: ../fish/guestfish.pod:100
20030 msgid "Edit C</boot/grub/grub.conf> interactively:"
20031 msgstr ""
20032
20033 #. type: verbatim
20034 #: ../fish/guestfish.pod:102
20035 #, no-wrap
20036 msgid ""
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"
20041 "\n"
20042 msgstr ""
20043
20044 #. type: =head2
20045 #: ../fish/guestfish.pod:107
20046 msgid "Mount disks automatically"
20047 msgstr ""
20048
20049 #. type: textblock
20050 #: ../fish/guestfish.pod:109
20051 msgid ""
20052 "Use the I<-i> option to automatically mount the disks from a virtual machine:"
20053 msgstr ""
20054
20055 #. type: verbatim
20056 #: ../fish/guestfish.pod:112
20057 #, no-wrap
20058 msgid ""
20059 " guestfish --ro -a disk.img -i cat /etc/group\n"
20060 "\n"
20061 msgstr ""
20062
20063 #. type: verbatim
20064 #: ../fish/guestfish.pod:114
20065 #, no-wrap
20066 msgid ""
20067 " guestfish --ro -d libvirt-domain -i cat /etc/group\n"
20068 "\n"
20069 msgstr ""
20070
20071 #. type: textblock
20072 #: ../fish/guestfish.pod:116
20073 msgid "Another way to edit C</boot/grub/grub.conf> interactively is:"
20074 msgstr ""
20075
20076 #. type: verbatim
20077 #: ../fish/guestfish.pod:118
20078 #, no-wrap
20079 msgid ""
20080 " guestfish --rw -a disk.img -i edit /boot/grub/grub.conf\n"
20081 "\n"
20082 msgstr ""
20083
20084 #. type: =head2
20085 #: ../fish/guestfish.pod:120
20086 msgid "As a script interpreter"
20087 msgstr ""
20088
20089 #. type: textblock
20090 #: ../fish/guestfish.pod:122
20091 msgid "Create a 100MB disk containing an ext2-formatted partition:"
20092 msgstr ""
20093
20094 #. type: verbatim
20095 #: ../fish/guestfish.pod:124
20096 #, no-wrap
20097 msgid ""
20098 " #!/usr/bin/guestfish -f\n"
20099 " sparse test1.img 100M\n"
20100 " run\n"
20101 " part-disk /dev/sda mbr\n"
20102 " mkfs ext2 /dev/sda1\n"
20103 "\n"
20104 msgstr ""
20105
20106 #. type: =head2
20107 #: ../fish/guestfish.pod:130
20108 msgid "Start with a prepared disk"
20109 msgstr ""
20110
20111 #. type: textblock
20112 #: ../fish/guestfish.pod:132
20113 msgid ""
20114 "An alternate way to create a 100MB disk called C<test1.img> containing a "
20115 "single ext2-formatted partition:"
20116 msgstr ""
20117
20118 #. type: verbatim
20119 #: ../fish/guestfish.pod:135 ../src/guestfs.pod:2243
20120 #, no-wrap
20121 msgid ""
20122 " guestfish -N fs\n"
20123 "\n"
20124 msgstr ""
20125
20126 #. type: textblock
20127 #: ../fish/guestfish.pod:137
20128 msgid "To list what is available do:"
20129 msgstr ""
20130
20131 #. type: verbatim
20132 #: ../fish/guestfish.pod:139 ../fish/guestfish.pod:1042
20133 #, no-wrap
20134 msgid ""
20135 " guestfish -N help | less\n"
20136 "\n"
20137 msgstr ""
20138
20139 #. type: =head2
20140 #: ../fish/guestfish.pod:141
20141 msgid "Remote control"
20142 msgstr "Дистанційне керування"
20143
20144 #. type: verbatim
20145 #: ../fish/guestfish.pod:143
20146 #, no-wrap
20147 msgid ""
20148 " eval \"`guestfish --listen`\"\n"
20149 " guestfish --remote add-ro disk.img\n"
20150 " guestfish --remote run\n"
20151 " guestfish --remote lvs\n"
20152 "\n"
20153 msgstr ""
20154 " eval \"`guestfish --listen`\"\n"
20155 " guestfish --remote add-ro disk.img\n"
20156 " guestfish --remote run\n"
20157 " guestfish --remote lvs\n"
20158 "\n"
20159
20160 #. type: textblock
20161 #: ../fish/guestfish.pod:154
20162 msgid "Displays general help on options."
20163 msgstr ""
20164
20165 #. type: =item
20166 #: ../fish/guestfish.pod:158
20167 msgid "B<--cmd-help>"
20168 msgstr "B<--cmd-help>"
20169
20170 #. type: textblock
20171 #: ../fish/guestfish.pod:160
20172 msgid "Lists all available guestfish commands."
20173 msgstr ""
20174
20175 #. type: =item
20176 #: ../fish/guestfish.pod:162
20177 msgid "B<-h cmd>"
20178 msgstr "B<-h команда>"
20179
20180 #. type: =item
20181 #: ../fish/guestfish.pod:164
20182 msgid "B<--cmd-help cmd>"
20183 msgstr "B<--cmd-help команда>"
20184
20185 #. type: textblock
20186 #: ../fish/guestfish.pod:166
20187 msgid "Displays detailed help on a single command C<cmd>."
20188 msgstr ""
20189
20190 #. type: =item
20191 #: ../fish/guestfish.pod:168 ../fuse/guestmount.pod:96
20192 msgid "B<-a image>"
20193 msgstr "B<-a образ>"
20194
20195 #. type: =item
20196 #: ../fish/guestfish.pod:170 ../fuse/guestmount.pod:98
20197 msgid "B<--add image>"
20198 msgstr "B<--add образ>"
20199
20200 #. type: textblock
20201 #: ../fish/guestfish.pod:172
20202 msgid "Add a block device or virtual machine image to the shell."
20203 msgstr ""
20204
20205 #. type: textblock
20206 #: ../fish/guestfish.pod:177
20207 msgid ""
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."
20211 msgstr ""
20212
20213 #. type: textblock
20214 #: ../fish/guestfish.pod:185 ../fuse/guestmount.pod:109
20215 msgid ""
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."
20218 msgstr ""
20219
20220 #. type: =item
20221 #: ../fish/guestfish.pod:189
20222 msgid "B<--csh>"
20223 msgstr "B<--csh>"
20224
20225 #. type: textblock
20226 #: ../fish/guestfish.pod:191
20227 msgid ""
20228 "If using the I<--listen> option and a csh-like shell, use this option.  See "
20229 "section L</REMOTE CONTROL AND CSH> below."
20230 msgstr ""
20231
20232 #. type: =item
20233 #: ../fish/guestfish.pod:194 ../fuse/guestmount.pod:113
20234 msgid "B<-d libvirt-domain>"
20235 msgstr "B<-d домен-libvirt>"
20236
20237 #. type: =item
20238 #: ../fish/guestfish.pod:196 ../fuse/guestmount.pod:115
20239 msgid "B<--domain libvirt-domain>"
20240 msgstr "B<--domain домен-libvirt>"
20241
20242 #. type: textblock
20243 #: ../fish/guestfish.pod:198 ../fuse/guestmount.pod:117
20244 msgid ""
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."
20248 msgstr ""
20249
20250 #. type: textblock
20251 #: ../fish/guestfish.pod:202 ../fuse/guestmount.pod:121
20252 msgid "Domain UUIDs can be used instead of names."
20253 msgstr ""
20254
20255 #. type: textblock
20256 #: ../fish/guestfish.pod:204
20257 msgid ""
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."
20261 msgstr ""
20262
20263 #. type: =item
20264 #: ../fish/guestfish.pod:208
20265 msgid "B<-D>"
20266 msgstr "B<-D>"
20267
20268 #. type: =item
20269 #: ../fish/guestfish.pod:210
20270 msgid "B<--no-dest-paths>"
20271 msgstr "B<--no-dest-paths>"
20272
20273 #. type: textblock
20274 #: ../fish/guestfish.pod:212
20275 msgid ""
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."
20280 msgstr ""
20281
20282 #. type: textblock
20283 #: ../fish/guestfish.pod:219 ../fuse/guestmount.pod:137
20284 msgid ""
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."
20289 msgstr ""
20290
20291 #. type: =item
20292 #: ../fish/guestfish.pod:224
20293 msgid "B<-f file>"
20294 msgstr "B<-f файл>"
20295
20296 #. type: =item
20297 #: ../fish/guestfish.pod:226
20298 msgid "B<--file file>"
20299 msgstr "B<--file файл>"
20300
20301 #. type: textblock
20302 #: ../fish/guestfish.pod:228
20303 msgid "Read commands from C<file>.  To write pure guestfish scripts, use:"
20304 msgstr ""
20305
20306 #. type: verbatim
20307 #: ../fish/guestfish.pod:231
20308 #, no-wrap
20309 msgid ""
20310 " #!/usr/bin/guestfish -f\n"
20311 "\n"
20312 msgstr ""
20313 " #!/usr/bin/guestfish -f\n"
20314 "\n"
20315
20316 #. type: verbatim
20317 #: ../fish/guestfish.pod:244
20318 #, no-wrap
20319 msgid ""
20320 " guestfish --format=raw -a disk.img\n"
20321 "\n"
20322 msgstr ""
20323 " guestfish --format=raw -a disk.img\n"
20324 "\n"
20325
20326 #. type: verbatim
20327 #: ../fish/guestfish.pod:248
20328 #, no-wrap
20329 msgid ""
20330 " guestfish --format=raw -a disk.img --format -a another.img\n"
20331 "\n"
20332 msgstr ""
20333 " guestfish --format=raw -a disk.img --format -a another.img\n"
20334 "\n"
20335
20336 #. type: textblock
20337 #: ../fish/guestfish.pod:253
20338 msgid ""
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>."
20342 msgstr ""
20343
20344 #. type: =item
20345 #: ../fish/guestfish.pod:260 ../fuse/guestmount.pod:166
20346 msgid "B<--inspector>"
20347 msgstr "B<--inspector>"
20348
20349 #. type: textblock
20350 #: ../fish/guestfish.pod:262 ../fuse/guestmount.pod:168
20351 msgid ""
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 "
20354 "machine."
20355 msgstr ""
20356
20357 #. type: textblock
20358 #: ../fish/guestfish.pod:266
20359 msgid "Typical usage is either:"
20360 msgstr ""
20361
20362 #. type: verbatim
20363 #: ../fish/guestfish.pod:268
20364 #, no-wrap
20365 msgid ""
20366 " guestfish -d myguest -i\n"
20367 "\n"
20368 msgstr ""
20369 " guestfish -d myguest -i\n"
20370 "\n"
20371
20372 #. type: textblock
20373 #: ../fish/guestfish.pod:270
20374 msgid "(for an inactive libvirt domain called I<myguest>), or:"
20375 msgstr ""
20376
20377 #. type: verbatim
20378 #: ../fish/guestfish.pod:272
20379 #, no-wrap
20380 msgid ""
20381 " guestfish --ro -d myguest -i\n"
20382 "\n"
20383 msgstr ""
20384 " guestfish --ro -d myguest -i\n"
20385 "\n"
20386
20387 #. type: textblock
20388 #: ../fish/guestfish.pod:274
20389 msgid "(for active domains, readonly), or specify the block device directly:"
20390 msgstr ""
20391
20392 #. type: verbatim
20393 #: ../fish/guestfish.pod:276
20394 #, no-wrap
20395 msgid ""
20396 " guestfish --rw -a /dev/Guests/MyGuest -i\n"
20397 "\n"
20398 msgstr ""
20399 " guestfish --rw -a /dev/Guests/MyGuest -i\n"
20400 "\n"
20401
20402 #. type: textblock
20403 #: ../fish/guestfish.pod:278
20404 msgid ""
20405 "Note that the command line syntax changed slightly over older versions of "
20406 "guestfish.  You can still use the old syntax:"
20407 msgstr ""
20408
20409 #. type: verbatim
20410 #: ../fish/guestfish.pod:281
20411 #, no-wrap
20412 msgid ""
20413 " guestfish [--ro] -i disk.img\n"
20414 "\n"
20415 msgstr ""
20416 " guestfish [--ro] -i disk.img\n"
20417 "\n"
20418
20419 #. type: verbatim
20420 #: ../fish/guestfish.pod:283
20421 #, no-wrap
20422 msgid ""
20423 " guestfish [--ro] -i libvirt-domain\n"
20424 "\n"
20425 msgstr ""
20426
20427 #. type: textblock
20428 #: ../fish/guestfish.pod:285
20429 msgid ""
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."
20432 msgstr ""
20433
20434 #. type: =item
20435 #: ../fish/guestfish.pod:294
20436 msgid "B<--listen>"
20437 msgstr "B<--listen>"
20438
20439 #. type: textblock
20440 #: ../fish/guestfish.pod:296
20441 msgid ""
20442 "Fork into the background and listen for remote commands.  See section L</"
20443 "REMOTE CONTROL GUESTFISH OVER A SOCKET> below."
20444 msgstr ""
20445
20446 #. type: =item
20447 #: ../fish/guestfish.pod:299 ../fuse/guestmount.pod:177
20448 msgid "B<--live>"
20449 msgstr "B<--live>"
20450
20451 #. type: textblock
20452 #: ../fish/guestfish.pod:301 ../fuse/guestmount.pod:179
20453 msgid ""
20454 "Connect to a live virtual machine.  (Experimental, see L<guestfs(3)/"
20455 "ATTACHING TO RUNNING DAEMONS>)."
20456 msgstr ""
20457
20458 #. type: =item
20459 #: ../fish/guestfish.pod:304 ../fuse/guestmount.pod:182
20460 msgid "B<-m dev[:mountpoint[:options]]>"
20461 msgstr "B<-m пристрій[:точка_монтування[:параметри]]>"
20462
20463 #. type: =item
20464 #: ../fish/guestfish.pod:306 ../fuse/guestmount.pod:184
20465 msgid "B<--mount dev[:mountpoint[:options]]>"
20466 msgstr "B<--mount пристрій[:точка_монтування[:параметри]]>"
20467
20468 #. type: textblock
20469 #: ../fish/guestfish.pod:308
20470 msgid "Mount the named partition or logical volume on the given mountpoint."
20471 msgstr ""
20472
20473 #. type: textblock
20474 #: ../fish/guestfish.pod:310
20475 msgid "If the mountpoint is omitted, it defaults to C</>."
20476 msgstr ""
20477
20478 #. type: textblock
20479 #: ../fish/guestfish.pod:312
20480 msgid "You have to mount something on C</> before most commands will work."
20481 msgstr ""
20482
20483 #. type: textblock
20484 #: ../fish/guestfish.pod:314
20485 msgid ""
20486 "If any I<-m> or I<--mount> options are given, the guest is automatically "
20487 "launched."
20488 msgstr ""
20489
20490 #. type: textblock
20491 #: ../fish/guestfish.pod:317
20492 msgid ""
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."
20497 msgstr ""
20498
20499 #. type: textblock
20500 #: ../fish/guestfish.pod:323 ../fuse/guestmount.pod:192
20501 msgid ""
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:"
20508 msgstr ""
20509
20510 #. type: verbatim
20511 #: ../fish/guestfish.pod:331 ../fuse/guestmount.pod:200
20512 #, no-wrap
20513 msgid ""
20514 " -m /dev/sda1:/:acl,user_xattr\n"
20515 "\n"
20516 msgstr ""
20517
20518 #. type: textblock
20519 #: ../fish/guestfish.pod:333
20520 msgid "Using this flag is equivalent to using the C<mount-options> command."
20521 msgstr ""
20522
20523 #. type: =item
20524 #: ../fish/guestfish.pod:335 ../fuse/guestmount.pod:202
20525 #: ../resize/virt-resize.pod:435
20526 msgid "B<-n>"
20527 msgstr "B<-n>"
20528
20529 #. type: =item
20530 #: ../fish/guestfish.pod:337 ../fuse/guestmount.pod:204
20531 msgid "B<--no-sync>"
20532 msgstr "B<--no-sync>"
20533
20534 #. type: textblock
20535 #: ../fish/guestfish.pod:339
20536 msgid ""
20537 "Disable autosync.  This is enabled by default.  See the discussion of "
20538 "autosync in the L<guestfs(3)> manpage."
20539 msgstr ""
20540
20541 #. type: =item
20542 #: ../fish/guestfish.pod:342
20543 msgid "B<-N type>"
20544 msgstr "B<-N тип>"
20545
20546 #. type: =item
20547 #: ../fish/guestfish.pod:344
20548 msgid "B<--new type>"
20549 msgstr "B<--new тип>"
20550
20551 #. type: =item
20552 #: ../fish/guestfish.pod:346
20553 msgid "B<-N help>"
20554 msgstr "B<-N help>"
20555
20556 #. type: textblock
20557 #: ../fish/guestfish.pod:348
20558 msgid ""
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 "
20562 "IMAGES> below."
20563 msgstr ""
20564
20565 #. type: =item
20566 #: ../fish/guestfish.pod:353
20567 msgid "B<--progress-bars>"
20568 msgstr "B<--progress-bars>"
20569
20570 #. type: textblock
20571 #: ../fish/guestfish.pod:355
20572 msgid "Enable progress bars, even when guestfish is used non-interactively."
20573 msgstr ""
20574
20575 #. type: textblock
20576 #: ../fish/guestfish.pod:357
20577 msgid ""
20578 "Progress bars are enabled by default when guestfish is used as an "
20579 "interactive shell."
20580 msgstr ""
20581
20582 #. type: =item
20583 #: ../fish/guestfish.pod:360
20584 msgid "B<--no-progress-bars>"
20585 msgstr "B<--no-progress-bars>"
20586
20587 #. type: textblock
20588 #: ../fish/guestfish.pod:362
20589 msgid "Disable progress bars."
20590 msgstr ""
20591
20592 #. type: =item
20593 #: ../fish/guestfish.pod:364
20594 msgid "B<--remote[=pid]>"
20595 msgstr "B<--remote[=pid]>"
20596
20597 #. type: textblock
20598 #: ../fish/guestfish.pod:366
20599 msgid ""
20600 "Send remote commands to C<$GUESTFISH_PID> or C<pid>.  See section L</REMOTE "
20601 "CONTROL GUESTFISH OVER A SOCKET> below."
20602 msgstr ""
20603
20604 #. type: =item
20605 #: ../fish/guestfish.pod:369 ../fuse/guestmount.pod:248
20606 #: ../rescue/virt-rescue.pod:189
20607 msgid "B<-r>"
20608 msgstr "B<-r>"
20609
20610 #. type: =item
20611 #: ../fish/guestfish.pod:371 ../fuse/guestmount.pod:250
20612 #: ../rescue/virt-rescue.pod:191
20613 msgid "B<--ro>"
20614 msgstr "B<--ro>"
20615
20616 #. type: textblock
20617 #: ../fish/guestfish.pod:373
20618 msgid ""
20619 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
20620 "mounts are done read-only."
20621 msgstr ""
20622
20623 #. type: textblock
20624 #: ../fish/guestfish.pod:376 ../rescue/virt-rescue.pod:195
20625 msgid ""
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."
20629 msgstr ""
20630
20631 #. type: textblock
20632 #: ../fish/guestfish.pod:380
20633 msgid ""
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."
20637 msgstr ""
20638
20639 #. type: textblock
20640 #: ../fish/guestfish.pod:384
20641 msgid "See also L</OPENING DISKS FOR READ AND WRITE> below."
20642 msgstr ""
20643
20644 #. type: =item
20645 #: ../fish/guestfish.pod:386 ../fuse/guestmount.pod:262
20646 #: ../rescue/virt-rescue.pod:201
20647 msgid "B<--selinux>"
20648 msgstr "B<--selinux>"
20649
20650 #. type: textblock
20651 #: ../fish/guestfish.pod:388
20652 msgid "Enable SELinux support for the guest.  See L<guestfs(3)/SELINUX>."
20653 msgstr ""
20654
20655 #. type: textblock
20656 #: ../fish/guestfish.pod:394
20657 msgid ""
20658 "Enable very verbose messages.  This is particularly useful if you find a bug."
20659 msgstr ""
20660
20661 #. type: textblock
20662 #: ../fish/guestfish.pod:401
20663 msgid "Display the guestfish / libguestfs version number and exit."
20664 msgstr ""
20665
20666 #. type: =item
20667 #: ../fish/guestfish.pod:403 ../fuse/guestmount.pod:278
20668 #: ../rescue/virt-rescue.pod:231
20669 msgid "B<-w>"
20670 msgstr "B<-w>"
20671
20672 #. type: =item
20673 #: ../fish/guestfish.pod:405 ../fuse/guestmount.pod:280
20674 #: ../rescue/virt-rescue.pod:233
20675 msgid "B<--rw>"
20676 msgstr "B<--rw>"
20677
20678 #. type: textblock
20679 #: ../fish/guestfish.pod:407 ../fuse/guestmount.pod:282
20680 msgid ""
20681 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
20682 "mounts are done read-write."
20683 msgstr ""
20684
20685 #. type: textblock
20686 #: ../fish/guestfish.pod:410
20687 msgid "See L</OPENING DISKS FOR READ AND WRITE> below."
20688 msgstr ""
20689
20690 #. type: textblock
20691 #: ../fish/guestfish.pod:414
20692 msgid "Echo each command before executing it."
20693 msgstr ""
20694
20695 #. type: =head1
20696 #: ../fish/guestfish.pod:418
20697 msgid "COMMANDS ON COMMAND LINE"
20698 msgstr ""
20699
20700 #. type: textblock
20701 #: ../fish/guestfish.pod:420
20702 msgid ""
20703 "Any additional (non-option) arguments are treated as commands to execute."
20704 msgstr ""
20705
20706 #. type: textblock
20707 #: ../fish/guestfish.pod:423
20708 msgid ""
20709 "Commands to execute should be separated by a colon (C<:>), where the colon "
20710 "is a separate parameter.  Thus:"
20711 msgstr ""
20712
20713 #. type: verbatim
20714 #: ../fish/guestfish.pod:426
20715 #, no-wrap
20716 msgid ""
20717 " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n"
20718 "\n"
20719 msgstr ""
20720
20721 #. type: textblock
20722 #: ../fish/guestfish.pod:428
20723 msgid ""
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."
20727 msgstr ""
20728
20729 #. type: textblock
20730 #: ../fish/guestfish.pod:432
20731 msgid ""
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."
20735 msgstr ""
20736
20737 #. type: =head1
20738 #: ../fish/guestfish.pod:437
20739 msgid "USING launch (OR run)"
20740 msgstr ""
20741
20742 #. type: textblock
20743 #: ../fish/guestfish.pod:439
20744 msgid ""
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:"
20748 msgstr ""
20749
20750 #. type: textblock
20751 #: ../fish/guestfish.pod:447
20752 msgid "add or -a/--add"
20753 msgstr ""
20754
20755 #. type: textblock
20756 #: ../fish/guestfish.pod:451
20757 msgid "launch (aka run)"
20758 msgstr ""
20759
20760 #. type: textblock
20761 #: ../fish/guestfish.pod:455
20762 msgid "mount or -m/--mount"
20763 msgstr ""
20764
20765 #. type: textblock
20766 #: ../fish/guestfish.pod:459
20767 msgid "any other commands"
20768 msgstr ""
20769
20770 #. type: textblock
20771 #: ../fish/guestfish.pod:463
20772 msgid ""
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."
20775 msgstr ""
20776
20777 #. type: textblock
20778 #: ../fish/guestfish.pod:466
20779 msgid ""
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."
20783 msgstr ""
20784
20785 #. type: =head1
20786 #: ../fish/guestfish.pod:471
20787 msgid "OPENING DISKS FOR READ AND WRITE"
20788 msgstr ""
20789
20790 #. type: textblock
20791 #: ../fish/guestfish.pod:473
20792 msgid ""
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."
20796 msgstr ""
20797
20798 #. type: textblock
20799 #: ../fish/guestfish.pod:478
20800 msgid ""
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>."
20804 msgstr ""
20805
20806 #. type: textblock
20807 #: ../fish/guestfish.pod:482
20808 msgid ""
20809 "This matters: If you accidentally open a live VM disk image writable then "
20810 "you will cause irreversible disk corruption."
20811 msgstr ""
20812
20813 #. type: textblock
20814 #: ../fish/guestfish.pod:485
20815 msgid ""
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."
20821 msgstr ""
20822
20823 #. type: textblock
20824 #: ../fish/guestfish.pod:492
20825 msgid ""
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 "
20830 "write access."
20831 msgstr ""
20832
20833 #. type: textblock
20834 #: ../fish/guestfish.pod:498
20835 msgid ""
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."
20838 msgstr ""
20839
20840 #. type: =head1
20841 #: ../fish/guestfish.pod:501
20842 msgid "QUOTING"
20843 msgstr ""
20844
20845 #. type: textblock
20846 #: ../fish/guestfish.pod:503
20847 msgid ""
20848 "You can quote ordinary parameters using either single or double quotes.  For "
20849 "example:"
20850 msgstr ""
20851
20852 #. type: verbatim
20853 #: ../fish/guestfish.pod:506
20854 #, no-wrap
20855 msgid ""
20856 " add \"file with a space.img\"\n"
20857 "\n"
20858 msgstr ""
20859
20860 #. type: verbatim
20861 #: ../fish/guestfish.pod:508
20862 #, no-wrap
20863 msgid ""
20864 " rm '/file name'\n"
20865 "\n"
20866 msgstr ""
20867
20868 #. type: verbatim
20869 #: ../fish/guestfish.pod:510
20870 #, no-wrap
20871 msgid ""
20872 " rm '/\"'\n"
20873 "\n"
20874 msgstr ""
20875
20876 #. type: textblock
20877 #: ../fish/guestfish.pod:512
20878 msgid ""
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."
20883 msgstr ""
20884
20885 #. type: verbatim
20886 #: ../fish/guestfish.pod:517
20887 #, no-wrap
20888 msgid ""
20889 " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n"
20890 " command \"/bin/echo 'foo      bar'\"\n"
20891 " command \"/bin/echo \\'foo\\'\"\n"
20892 "\n"
20893 msgstr ""
20894
20895 #. type: =head2
20896 #: ../fish/guestfish.pod:521
20897 msgid "ESCAPE SEQUENCES IN DOUBLE QUOTED ARGUMENTS"
20898 msgstr ""
20899
20900 #. type: textblock
20901 #: ../fish/guestfish.pod:523
20902 msgid ""
20903 "In double-quoted arguments (only) use backslash to insert special characters:"
20904 msgstr ""
20905
20906 #. type: =item
20907 #: ../fish/guestfish.pod:528
20908 msgid "C<\\a>"
20909 msgstr "C<\\a>"
20910
20911 #. type: textblock
20912 #: ../fish/guestfish.pod:530
20913 msgid "Alert (bell) character."
20914 msgstr "Символ гудка (дзвінка)."
20915
20916 #. type: =item
20917 #: ../fish/guestfish.pod:532
20918 msgid "C<\\b>"
20919 msgstr "C<\\b>"
20920
20921 #. type: textblock
20922 #: ../fish/guestfish.pod:534
20923 msgid "Backspace character."
20924 msgstr ""
20925
20926 #. type: =item
20927 #: ../fish/guestfish.pod:536
20928 msgid "C<\\f>"
20929 msgstr "C<\\f>"
20930
20931 #. type: textblock
20932 #: ../fish/guestfish.pod:538
20933 msgid "Form feed character."
20934 msgstr ""
20935
20936 #. type: =item
20937 #: ../fish/guestfish.pod:540
20938 msgid "C<\\n>"
20939 msgstr "C<\\n>"
20940
20941 #. type: textblock
20942 #: ../fish/guestfish.pod:542
20943 msgid "Newline character."
20944 msgstr ""
20945
20946 #. type: =item
20947 #: ../fish/guestfish.pod:544
20948 msgid "C<\\r>"
20949 msgstr "C<\\r>"
20950
20951 #. type: textblock
20952 #: ../fish/guestfish.pod:546
20953 msgid "Carriage return character."
20954 msgstr "Символ повернення каретки."
20955
20956 #. type: =item
20957 #: ../fish/guestfish.pod:548
20958 msgid "C<\\t>"
20959 msgstr "C<\\t>"
20960
20961 #. type: textblock
20962 #: ../fish/guestfish.pod:550
20963 msgid "Horizontal tab character."
20964 msgstr "Символ горизонтальної табуляції"
20965
20966 #. type: =item
20967 #: ../fish/guestfish.pod:552
20968 msgid "C<\\v>"
20969 msgstr "C<\\v>"
20970
20971 #. type: textblock
20972 #: ../fish/guestfish.pod:554
20973 msgid "Vertical tab character."
20974 msgstr "Символ вертикальної табуляції."
20975
20976 #. type: =item
20977 #: ../fish/guestfish.pod:556
20978 msgid "C<\\\">"
20979 msgstr "C<\\\">"
20980
20981 #. type: textblock
20982 #: ../fish/guestfish.pod:558
20983 msgid "A literal double quote character."
20984 msgstr ""
20985
20986 #. type: =item
20987 #: ../fish/guestfish.pod:560
20988 msgid "C<\\ooo>"
20989 msgstr "C<\\ooo>"
20990
20991 #. type: textblock
20992 #: ../fish/guestfish.pod:562
20993 msgid ""
20994 "A character with octal value I<ooo>.  There must be precisely 3 octal digits "
20995 "(unlike C)."
20996 msgstr ""
20997
20998 #. type: =item
20999 #: ../fish/guestfish.pod:565
21000 msgid "C<\\xhh>"
21001 msgstr "C<\\xhh>"
21002
21003 #. type: textblock
21004 #: ../fish/guestfish.pod:567
21005 msgid ""
21006 "A character with hex value I<hh>.  There must be precisely 2 hex digits."
21007 msgstr ""
21008
21009 #. type: textblock
21010 #: ../fish/guestfish.pod:570
21011 msgid ""
21012 "In the current implementation C<\\000> and C<\\x00> cannot be used in "
21013 "strings."
21014 msgstr ""
21015
21016 #. type: =item
21017 #: ../fish/guestfish.pod:573
21018 msgid "C<\\\\>"
21019 msgstr "C<\\\\>"
21020
21021 #. type: textblock
21022 #: ../fish/guestfish.pod:575
21023 msgid "A literal backslash character."
21024 msgstr ""
21025
21026 #. type: =head1
21027 #: ../fish/guestfish.pod:579
21028 msgid "OPTIONAL ARGUMENTS"
21029 msgstr ""
21030
21031 #. type: textblock
21032 #: ../fish/guestfish.pod:581
21033 msgid ""
21034 "Some commands take optional arguments.  These arguments appear in this "
21035 "documentation as C<[argname:..]>.  You can use them as in these examples:"
21036 msgstr ""
21037
21038 #. type: verbatim
21039 #: ../fish/guestfish.pod:585
21040 #, no-wrap
21041 msgid ""
21042 " add-drive-opts filename\n"
21043 "\n"
21044 msgstr ""
21045
21046 #. type: verbatim
21047 #: ../fish/guestfish.pod:587
21048 #, no-wrap
21049 msgid ""
21050 " add-drive-opts filename readonly:true\n"
21051 "\n"
21052 msgstr ""
21053
21054 #. type: verbatim
21055 #: ../fish/guestfish.pod:589
21056 #, no-wrap
21057 msgid ""
21058 " add-drive-opts filename format:qcow2 readonly:false\n"
21059 "\n"
21060 msgstr ""
21061
21062 #. type: textblock
21063 #: ../fish/guestfish.pod:591
21064 msgid ""
21065 "Each optional argument can appear at most once.  All optional arguments must "
21066 "appear after the required ones."
21067 msgstr ""
21068
21069 #. type: =head1
21070 #: ../fish/guestfish.pod:594
21071 msgid "NUMBERS"
21072 msgstr "ЧИСЛА"
21073
21074 #. type: textblock
21075 #: ../fish/guestfish.pod:596
21076 msgid ""
21077 "This section applies to all commands which can take integers as parameters."
21078 msgstr ""
21079
21080 #. type: =head2
21081 #: ../fish/guestfish.pod:599
21082 msgid "SIZE SUFFIX"
21083 msgstr ""
21084
21085 #. type: textblock
21086 #: ../fish/guestfish.pod:601
21087 msgid ""
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:"
21090 msgstr ""
21091
21092 #. type: =item
21093 #: ../fish/guestfish.pod:607
21094 msgid "B<k> or B<K> or B<KiB>"
21095 msgstr "B<k>, B<K> або B<KiB>"
21096
21097 #. type: textblock
21098 #: ../fish/guestfish.pod:609
21099 msgid "The size in kilobytes (multiplied by 1024)."
21100 msgstr "Розмір у кілобайтах (у одному кілобайті 1024 байтів)."
21101
21102 #. type: =item
21103 #: ../fish/guestfish.pod:611
21104 msgid "B<KB>"
21105 msgstr "B<KB>"
21106
21107 #. type: textblock
21108 #: ../fish/guestfish.pod:613
21109 msgid "The size in SI 1000 byte units."
21110 msgstr "Розмір у одиницях СІ: 1000 байтів."
21111
21112 #. type: =item
21113 #: ../fish/guestfish.pod:615
21114 msgid "B<M> or B<MiB>"
21115 msgstr "B<M> або B<MiB>"
21116
21117 #. type: textblock
21118 #: ../fish/guestfish.pod:617
21119 msgid "The size in megabytes (multiplied by 1048576)."
21120 msgstr "Розмір у мегабайтах (у одному мегабайті 1048576 байтів)."
21121
21122 #. type: =item
21123 #: ../fish/guestfish.pod:619
21124 msgid "B<MB>"
21125 msgstr "B<MB>"
21126
21127 #. type: textblock
21128 #: ../fish/guestfish.pod:621
21129 msgid "The size in SI 1000000 byte units."
21130 msgstr "Розмір у одиницях СІ: 1000000 байтів."
21131
21132 #. type: =item
21133 #: ../fish/guestfish.pod:623
21134 msgid "B<G> or B<GiB>"
21135 msgstr "B<G> або B<GiB>"
21136
21137 #. type: textblock
21138 #: ../fish/guestfish.pod:625
21139 msgid "The size in gigabytes (multiplied by 2**30)."
21140 msgstr "Розмір у гігабайтах (з множником 2**30)."
21141
21142 #. type: =item
21143 #: ../fish/guestfish.pod:627
21144 msgid "B<GB>"
21145 msgstr "B<GB>"
21146
21147 #. type: textblock
21148 #: ../fish/guestfish.pod:629
21149 msgid "The size in SI 10**9 byte units."
21150 msgstr "Розмір у одиницях СІ: 10**9 байтів."
21151
21152 #. type: =item
21153 #: ../fish/guestfish.pod:631
21154 msgid "B<T> or B<TiB>"
21155 msgstr "B<T> або B<TiB>"
21156
21157 #. type: textblock
21158 #: ../fish/guestfish.pod:633
21159 msgid "The size in terabytes (multiplied by 2**40)."
21160 msgstr "Розмір у терабайтах (з множником 2**40)."
21161
21162 #. type: =item
21163 #: ../fish/guestfish.pod:635
21164 msgid "B<TB>"
21165 msgstr "B<TB>"
21166
21167 #. type: textblock
21168 #: ../fish/guestfish.pod:637
21169 msgid "The size in SI 10**12 byte units."
21170 msgstr "Розмір у одиницях СІ: 10**12 байтів."
21171
21172 #. type: =item
21173 #: ../fish/guestfish.pod:639
21174 msgid "B<P> or B<PiB>"
21175 msgstr "B<P> або B<PiB>"
21176
21177 #. type: textblock
21178 #: ../fish/guestfish.pod:641
21179 msgid "The size in petabytes (multiplied by 2**50)."
21180 msgstr "Розмір у петабайтах (у одному петабайті 2**50 байтів)."
21181
21182 #. type: =item
21183 #: ../fish/guestfish.pod:643
21184 msgid "B<PB>"
21185 msgstr "B<PB>"
21186
21187 #. type: textblock
21188 #: ../fish/guestfish.pod:645
21189 msgid "The size in SI 10**15 byte units."
21190 msgstr "Розмір у одиницях СІ: 10**15 байтів."
21191
21192 #. type: =item
21193 #: ../fish/guestfish.pod:647
21194 msgid "B<E> or B<EiB>"
21195 msgstr "B<E> або B<EiB>"
21196
21197 #. type: textblock
21198 #: ../fish/guestfish.pod:649
21199 msgid "The size in exabytes (multiplied by 2**60)."
21200 msgstr "Розмір у ексабайтах (у одному ексабайті 2**60 байтів)."
21201
21202 #. type: =item
21203 #: ../fish/guestfish.pod:651
21204 msgid "B<EB>"
21205 msgstr "B<EB>"
21206
21207 #. type: textblock
21208 #: ../fish/guestfish.pod:653
21209 msgid "The size in SI 10**18 byte units."
21210 msgstr "Розмір у одиницях СІ: 10**18 байтів."
21211
21212 #. type: =item
21213 #: ../fish/guestfish.pod:655
21214 msgid "B<Z> or B<ZiB>"
21215 msgstr "B<Z> або B<ZiB>"
21216
21217 #. type: textblock
21218 #: ../fish/guestfish.pod:657
21219 msgid "The size in zettabytes (multiplied by 2**70)."
21220 msgstr "Розмір у зетабайтах (у одному зетабайті 2**70 байтів)."
21221
21222 #. type: =item
21223 #: ../fish/guestfish.pod:659
21224 msgid "B<ZB>"
21225 msgstr "B<ZB>"
21226
21227 #. type: textblock
21228 #: ../fish/guestfish.pod:661
21229 msgid "The size in SI 10**21 byte units."
21230 msgstr "Розмір у одиницях СІ: 10**21 байтів."
21231
21232 #. type: =item
21233 #: ../fish/guestfish.pod:663
21234 msgid "B<Y> or B<YiB>"
21235 msgstr "B<Y> або B<YiB>"
21236
21237 #. type: textblock
21238 #: ../fish/guestfish.pod:665
21239 msgid "The size in yottabytes (multiplied by 2**80)."
21240 msgstr "Розмір у йотабайтах (у одному йотабайті 2**80 байтів)."
21241
21242 #. type: =item
21243 #: ../fish/guestfish.pod:667
21244 msgid "B<YB>"
21245 msgstr "B<YB>"
21246
21247 #. type: textblock
21248 #: ../fish/guestfish.pod:669
21249 msgid "The size in SI 10**24 byte units."
21250 msgstr "Розмір у одиницях СІ: 10**24 байтів."
21251
21252 #. type: verbatim
21253 #: ../fish/guestfish.pod:675
21254 #, no-wrap
21255 msgid ""
21256 " truncate-size /file 1G\n"
21257 "\n"
21258 msgstr ""
21259
21260 #. type: textblock
21261 #: ../fish/guestfish.pod:677
21262 msgid "would truncate the file to 1 gigabyte."
21263 msgstr ""
21264
21265 #. type: textblock
21266 #: ../fish/guestfish.pod:679
21267 msgid ""
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."
21271 msgstr ""
21272
21273 #. type: =head2
21274 #: ../fish/guestfish.pod:683
21275 msgid "OCTAL AND HEXADECIMAL NUMBERS"
21276 msgstr ""
21277
21278 #. type: textblock
21279 #: ../fish/guestfish.pod:685
21280 msgid ""
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:"
21283 msgstr ""
21284
21285 #. type: verbatim
21286 #: ../fish/guestfish.pod:688
21287 #, no-wrap
21288 msgid ""
21289 " 1234      decimal number 1234\n"
21290 " 02322     octal number, equivalent to decimal 1234\n"
21291 " 0x4d2     hexadecimal number, equivalent to decimal 1234\n"
21292 "\n"
21293 msgstr ""
21294
21295 #. type: textblock
21296 #: ../fish/guestfish.pod:692
21297 msgid ""
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):"
21301 msgstr ""
21302
21303 #. type: verbatim
21304 #: ../fish/guestfish.pod:696
21305 #, no-wrap
21306 msgid ""
21307 " chmod 0777 /public  # OK\n"
21308 " chmod 777 /public   # WRONG! This is mode 777 decimal = 01411 octal.\n"
21309 "\n"
21310 msgstr ""
21311
21312 #. type: textblock
21313 #: ../fish/guestfish.pod:699
21314 msgid ""
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>)."
21318 msgstr ""
21319
21320 #. type: =head1
21321 #: ../fish/guestfish.pod:703
21322 msgid "WILDCARDS AND GLOBBING"
21323 msgstr ""
21324
21325 #. type: textblock
21326 #: ../fish/guestfish.pod:705
21327 msgid ""
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 "
21330 "expect:"
21331 msgstr ""
21332
21333 #. type: verbatim
21334 #: ../fish/guestfish.pod:709
21335 #, no-wrap
21336 msgid ""
21337 " rm-rf /home/*\n"
21338 "\n"
21339 msgstr ""
21340
21341 #. type: textblock
21342 #: ../fish/guestfish.pod:711
21343 msgid ""
21344 "Assuming you don't have a directory called literally C</home/*> then the "
21345 "above command will return an error."
21346 msgstr ""
21347
21348 #. type: textblock
21349 #: ../fish/guestfish.pod:714
21350 msgid "To perform wildcard expansion, use the C<glob> command."
21351 msgstr ""
21352
21353 #. type: verbatim
21354 #: ../fish/guestfish.pod:716
21355 #, no-wrap
21356 msgid ""
21357 " glob rm-rf /home/*\n"
21358 "\n"
21359 msgstr ""
21360
21361 #. type: textblock
21362 #: ../fish/guestfish.pod:718
21363 msgid ""
21364 "runs C<rm-rf> on each path that matches (ie. potentially running the command "
21365 "many times), equivalent to:"
21366 msgstr ""
21367
21368 #. type: verbatim
21369 #: ../fish/guestfish.pod:721
21370 #, no-wrap
21371 msgid ""
21372 " rm-rf /home/jim\n"
21373 " rm-rf /home/joe\n"
21374 " rm-rf /home/mary\n"
21375 "\n"
21376 msgstr ""
21377
21378 #. type: textblock
21379 #: ../fish/guestfish.pod:725
21380 msgid "C<glob> only works on simple guest paths and not on device names."
21381 msgstr ""
21382
21383 #. type: textblock
21384 #: ../fish/guestfish.pod:727
21385 msgid ""
21386 "If you have several parameters, each containing a wildcard, then glob will "
21387 "perform a Cartesian product."
21388 msgstr ""
21389
21390 #. type: =head1
21391 #: ../fish/guestfish.pod:730
21392 msgid "COMMENTS"
21393 msgstr "КОМЕНТАРІ"
21394
21395 #. type: textblock
21396 #: ../fish/guestfish.pod:732
21397 msgid ""
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:"
21401 msgstr ""
21402
21403 #. type: verbatim
21404 #: ../fish/guestfish.pod:736
21405 #, no-wrap
21406 msgid ""
21407 " # this is a comment\n"
21408 "         # this is a comment\n"
21409 " foo # NOT a comment\n"
21410 "\n"
21411 msgstr ""
21412
21413 #. type: textblock
21414 #: ../fish/guestfish.pod:740
21415 msgid "Blank lines are also ignored."
21416 msgstr ""
21417
21418 #. type: =head1
21419 #: ../fish/guestfish.pod:742
21420 msgid "RUNNING COMMANDS LOCALLY"
21421 msgstr ""
21422
21423 #. type: textblock
21424 #: ../fish/guestfish.pod:744
21425 msgid ""
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:"
21428 msgstr ""
21429
21430 #. type: verbatim
21431 #: ../fish/guestfish.pod:748
21432 #, no-wrap
21433 msgid ""
21434 " !mkdir local\n"
21435 " tgz-out /remote local/remote-data.tar.gz\n"
21436 "\n"
21437 msgstr ""
21438
21439 #. type: textblock
21440 #: ../fish/guestfish.pod:751
21441 msgid ""
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>)."
21445 msgstr ""
21446
21447 #. type: textblock
21448 #: ../fish/guestfish.pod:755
21449 msgid ""
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."
21452 msgstr ""
21453
21454 #. type: =head2
21455 #: ../fish/guestfish.pod:758
21456 msgid "LOCAL COMMANDS WITH INLINE EXECUTION"
21457 msgstr ""
21458
21459 #. type: textblock
21460 #: ../fish/guestfish.pod:760
21461 msgid ""
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."
21465 msgstr ""
21466
21467 #. type: textblock
21468 #: ../fish/guestfish.pod:764
21469 msgid ""
21470 "Thus you can use shell script to construct arbitrary guestfish commands "
21471 "which are then parsed by guestfish."
21472 msgstr ""
21473
21474 #. type: textblock
21475 #: ../fish/guestfish.pod:767
21476 msgid ""
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:"
21480 msgstr ""
21481
21482 #. type: verbatim
21483 #: ../fish/guestfish.pod:772
21484 #, no-wrap
21485 msgid ""
21486 " <! for n in `seq 1 100`; do echo write /foo.$n $n; done\n"
21487 "\n"
21488 msgstr ""
21489
21490 #. type: textblock
21491 #: ../fish/guestfish.pod:774
21492 msgid "or with names like C</foo.001>:"
21493 msgstr ""
21494
21495 #. type: verbatim
21496 #: ../fish/guestfish.pod:776
21497 #, no-wrap
21498 msgid ""
21499 " <! for n in `seq 1 100`; do printf \"write /foo.%03d %d\\n\" $n $n; done\n"
21500 "\n"
21501 msgstr ""
21502
21503 #. type: textblock
21504 #: ../fish/guestfish.pod:778
21505 msgid ""
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."
21511 msgstr ""
21512
21513 #. type: =head1
21514 #: ../fish/guestfish.pod:784
21515 msgid "PIPES"
21516 msgstr "КАНАЛИ"
21517
21518 #. type: textblock
21519 #: ../fish/guestfish.pod:786
21520 msgid ""
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 "
21523 "example:"
21524 msgstr ""
21525
21526 #. type: verbatim
21527 #: ../fish/guestfish.pod:790
21528 #, no-wrap
21529 msgid ""
21530 " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n"
21531 "\n"
21532 msgstr ""
21533
21534 #. type: textblock
21535 #: ../fish/guestfish.pod:792
21536 msgid ""
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:"
21540 msgstr ""
21541
21542 #. type: verbatim
21543 #: ../fish/guestfish.pod:797
21544 #, no-wrap
21545 msgid ""
21546 " hexdump /bin/ls | head\n"
21547 " list-devices | tail -1\n"
21548 " tgz-out / - | tar ztf -\n"
21549 "\n"
21550 msgstr ""
21551
21552 #. type: textblock
21553 #: ../fish/guestfish.pod:801
21554 msgid ""
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."
21559 msgstr ""
21560
21561 #. type: textblock
21562 #: ../fish/guestfish.pod:806
21563 msgid ""
21564 "To use a literal argument which begins with a pipe symbol, you have to quote "
21565 "it, eg:"
21566 msgstr ""
21567
21568 #. type: verbatim
21569 #: ../fish/guestfish.pod:809
21570 #, no-wrap
21571 msgid ""
21572 " echo \"|\"\n"
21573 "\n"
21574 msgstr ""
21575
21576 #. type: =head1
21577 #: ../fish/guestfish.pod:811
21578 msgid "HOME DIRECTORIES"
21579 msgstr ""
21580
21581 #. type: textblock
21582 #: ../fish/guestfish.pod:813
21583 msgid ""
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)."
21587 msgstr ""
21588
21589 #. type: textblock
21590 #: ../fish/guestfish.pod:817
21591 msgid ""
21592 "Note that home directory expansion happens for users known I<on the host>, "
21593 "not in the guest filesystem."
21594 msgstr ""
21595
21596 #. type: textblock
21597 #: ../fish/guestfish.pod:820
21598 msgid ""
21599 "To use a literal argument which begins with a tilde, you have to quote it, "
21600 "eg:"
21601 msgstr ""
21602
21603 #. type: verbatim
21604 #: ../fish/guestfish.pod:823
21605 #, no-wrap
21606 msgid ""
21607 " echo \"~\"\n"
21608 "\n"
21609 msgstr ""
21610
21611 #. type: =head2
21612 #: ../fish/guestfish.pod:825 ../src/guestfs.pod:534
21613 msgid "ENCRYPTED DISKS"
21614 msgstr "ЗАШИФРОВАНІ ДИСКИ"
21615
21616 #. type: textblock
21617 #: ../fish/guestfish.pod:827
21618 msgid ""
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."
21623 msgstr ""
21624
21625 #. type: textblock
21626 #: ../fish/guestfish.pod:832
21627 msgid "Identify encrypted block devices and partitions using L</vfs-type>:"
21628 msgstr ""
21629
21630 #. type: verbatim
21631 #: ../fish/guestfish.pod:834
21632 #, no-wrap
21633 msgid ""
21634 " ><fs> vfs-type /dev/sda2\n"
21635 " crypto_LUKS\n"
21636 "\n"
21637 msgstr ""
21638
21639 #. type: textblock
21640 #: ../fish/guestfish.pod:837
21641 msgid ""
21642 "Then open those devices using L</luks-open>.  This creates a device-mapper "
21643 "device called C</dev/mapper/luksdev>."
21644 msgstr ""
21645
21646 #. type: verbatim
21647 #: ../fish/guestfish.pod:840
21648 #, no-wrap
21649 msgid ""
21650 " ><fs> luks-open /dev/sda2 luksdev\n"
21651 " Enter key or passphrase (\"key\"): <enter the passphrase>\n"
21652 "\n"
21653 msgstr ""
21654
21655 #. type: textblock
21656 #: ../fish/guestfish.pod:843
21657 msgid ""
21658 "Finally you have to tell LVM to scan for volume groups on the newly created "
21659 "mapper device:"
21660 msgstr ""
21661
21662 #. type: verbatim
21663 #: ../fish/guestfish.pod:846
21664 #, no-wrap
21665 msgid ""
21666 " vgscan\n"
21667 " vg-activate-all true\n"
21668 "\n"
21669 msgstr ""
21670
21671 #. type: textblock
21672 #: ../fish/guestfish.pod:849
21673 msgid "The logical volume(s) can now be mounted in the usual way."
21674 msgstr ""
21675
21676 #. type: textblock
21677 #: ../fish/guestfish.pod:851
21678 msgid ""
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:"
21682 msgstr ""
21683
21684 #. type: verbatim
21685 #: ../fish/guestfish.pod:855
21686 #, no-wrap
21687 msgid ""
21688 " vg-activate false /dev/VG\n"
21689 " luks-close /dev/mapper/luksdev\n"
21690 "\n"
21691 msgstr ""
21692
21693 #. type: textblock
21694 #: ../fish/guestfish.pod:860
21695 msgid ""
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 "
21698 "equivalent:"
21699 msgstr ""
21700
21701 #. type: verbatim
21702 #: ../fish/guestfish.pod:864
21703 #, no-wrap
21704 msgid ""
21705 " file /WINDOWS/system32/config/system.LOG\n"
21706 "\n"
21707 msgstr ""
21708
21709 #. type: verbatim
21710 #: ../fish/guestfish.pod:866
21711 #, no-wrap
21712 msgid ""
21713 " file win:\\windows\\system32\\config\\system.log\n"
21714 "\n"
21715 msgstr ""
21716
21717 #. type: verbatim
21718 #: ../fish/guestfish.pod:868
21719 #, no-wrap
21720 msgid ""
21721 " file WIN:C:\\Windows\\SYSTEM32\\CONFIG\\SYSTEM.LOG\n"
21722 "\n"
21723 msgstr ""
21724
21725 #. type: textblock
21726 #: ../fish/guestfish.pod:870
21727 msgid ""
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:"
21733 msgstr ""
21734
21735 #. type: verbatim
21736 #: ../fish/guestfish.pod:876
21737 #, no-wrap
21738 msgid ""
21739 " win:e:\\foo\\bar => /e/FOO/bar\n"
21740 "\n"
21741 msgstr ""
21742
21743 #. type: textblock
21744 #: ../fish/guestfish.pod:878
21745 msgid "This only works in argument positions that expect a path."
21746 msgstr ""
21747
21748 #. type: =head1
21749 #: ../fish/guestfish.pod:880
21750 msgid "UPLOADING AND DOWNLOADING FILES"
21751 msgstr ""
21752
21753 #. type: textblock
21754 #: ../fish/guestfish.pod:882
21755 msgid ""
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:"
21759 msgstr ""
21760
21761 #. type: verbatim
21762 #: ../fish/guestfish.pod:886
21763 #, no-wrap
21764 msgid ""
21765 " upload - /foo\n"
21766 "\n"
21767 msgstr ""
21768
21769 #. type: textblock
21770 #: ../fish/guestfish.pod:888
21771 msgid ""
21772 "reads stdin and creates from that a file C</foo> in the disk image, and:"
21773 msgstr ""
21774
21775 #. type: verbatim
21776 #: ../fish/guestfish.pod:891
21777 #, no-wrap
21778 msgid ""
21779 " tar-out /etc - | tar tf -\n"
21780 "\n"
21781 msgstr ""
21782
21783 #. type: textblock
21784 #: ../fish/guestfish.pod:893
21785 msgid ""
21786 "writes the tarball to stdout and then pipes that into the external \"tar\" "
21787 "command (see L</PIPES>)."
21788 msgstr ""
21789
21790 #. type: textblock
21791 #: ../fish/guestfish.pod:896
21792 msgid ""
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:"
21796 msgstr ""
21797
21798 #. type: verbatim
21799 #: ../fish/guestfish.pod:900
21800 #, no-wrap
21801 msgid ""
21802 " upload -<<END /foo\n"
21803 " input line 1\n"
21804 " input line 2\n"
21805 " input line 3\n"
21806 " END\n"
21807 "\n"
21808 msgstr ""
21809
21810 #. type: textblock
21811 #: ../fish/guestfish.pod:906
21812 msgid ""
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)."
21816 msgstr ""
21817
21818 #. type: textblock
21819 #: ../fish/guestfish.pod:910
21820 msgid ""
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)."
21823 msgstr ""
21824
21825 #. type: =head1
21826 #: ../fish/guestfish.pod:913
21827 msgid "EXIT ON ERROR BEHAVIOUR"
21828 msgstr ""
21829
21830 #. type: textblock
21831 #: ../fish/guestfish.pod:915
21832 msgid ""
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)."
21836 msgstr ""
21837
21838 #. type: textblock
21839 #: ../fish/guestfish.pod:920
21840 msgid ""
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."
21843 msgstr ""
21844
21845 #. type: =head1
21846 #: ../fish/guestfish.pod:924
21847 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET"
21848 msgstr ""
21849
21850 #. type: textblock
21851 #: ../fish/guestfish.pod:926
21852 msgid ""
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."
21857 msgstr ""
21858
21859 #. type: textblock
21860 #: ../fish/guestfish.pod:931
21861 msgid "Start a guestfish server process using:"
21862 msgstr ""
21863
21864 #. type: verbatim
21865 #: ../fish/guestfish.pod:933
21866 #, no-wrap
21867 msgid ""
21868 " eval \"`guestfish --listen`\"\n"
21869 "\n"
21870 msgstr ""
21871
21872 #. type: textblock
21873 #: ../fish/guestfish.pod:935
21874 msgid "and then send it commands by doing:"
21875 msgstr ""
21876
21877 #. type: verbatim
21878 #: ../fish/guestfish.pod:937
21879 #, no-wrap
21880 msgid ""
21881 " guestfish --remote cmd [...]\n"
21882 "\n"
21883 msgstr ""
21884
21885 #. type: textblock
21886 #: ../fish/guestfish.pod:939
21887 msgid "To cause the server to exit, send it the exit command:"
21888 msgstr ""
21889
21890 #. type: textblock
21891 #: ../fish/guestfish.pod:943
21892 msgid ""
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 "
21895 "BEHAVIOUR>."
21896 msgstr ""
21897
21898 #. type: =head2
21899 #: ../fish/guestfish.pod:947
21900 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES"
21901 msgstr ""
21902
21903 #. type: textblock
21904 #: ../fish/guestfish.pod:949
21905 msgid ""
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:"
21909 msgstr ""
21910
21911 #. type: verbatim
21912 #: ../fish/guestfish.pod:953
21913 #, no-wrap
21914 msgid ""
21915 " eval \"`guestfish --listen`\"\n"
21916 " pid1=$GUESTFISH_PID\n"
21917 " eval \"`guestfish --listen`\"\n"
21918 " pid2=$GUESTFISH_PID\n"
21919 " ...\n"
21920 " guestfish --remote=$pid1 cmd\n"
21921 " guestfish --remote=$pid2 cmd\n"
21922 "\n"
21923 msgstr ""
21924
21925 #. type: =head2
21926 #: ../fish/guestfish.pod:961
21927 msgid "REMOTE CONTROL AND CSH"
21928 msgstr ""
21929
21930 #. type: textblock
21931 #: ../fish/guestfish.pod:963
21932 msgid ""
21933 "When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> "
21934 "option:"
21935 msgstr ""
21936
21937 #. type: verbatim
21938 #: ../fish/guestfish.pod:966
21939 #, no-wrap
21940 msgid ""
21941 " eval \"`guestfish --listen --csh`\"\n"
21942 "\n"
21943 msgstr ""
21944
21945 #. type: =head2
21946 #: ../fish/guestfish.pod:968
21947 msgid "REMOTE CONTROL DETAILS"
21948 msgstr ""
21949
21950 #. type: textblock
21951 #: ../fish/guestfish.pod:970
21952 msgid ""
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."
21956 msgstr ""
21957
21958 #. type: textblock
21959 #: ../fish/guestfish.pod:974
21960 msgid "Guestfish client and server versions must match exactly."
21961 msgstr ""
21962
21963 #. type: =head2
21964 #: ../fish/guestfish.pod:976
21965 msgid "USING REMOTE CONTROL ROBUSTLY FROM SHELL SCRIPTS"
21966 msgstr ""
21967
21968 #. type: textblock
21969 #: ../fish/guestfish.pod:978
21970 msgid ""
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:"
21974 msgstr ""
21975
21976 #. type: verbatim
21977 #: ../fish/guestfish.pod:982 ../src/guestfs.pod:980
21978 #, no-wrap
21979 msgid ""
21980 " #!/bin/bash -\n"
21981 " \n"
21982 msgstr ""
21983
21984 #. type: verbatim
21985 #: ../fish/guestfish.pod:986
21986 #, no-wrap
21987 msgid ""
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"
21993 " \n"
21994 msgstr ""
21995
21996 #. type: verbatim
21997 #: ../fish/guestfish.pod:992
21998 #, no-wrap
21999 msgid ""
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"
22004 "     exit 1\n"
22005 " fi\n"
22006 " \n"
22007 msgstr ""
22008
22009 #. type: verbatim
22010 #: ../fish/guestfish.pod:999
22011 #, no-wrap
22012 msgid ""
22013 " cleanup_guestfish ()\n"
22014 " {\n"
22015 "     guestfish --remote -- exit >/dev/null 2>&1 ||:\n"
22016 " }\n"
22017 " trap cleanup_guestfish EXIT ERR\n"
22018 " \n"
22019 msgstr ""
22020
22021 #. type: verbatim
22022 #: ../fish/guestfish.pod:1005
22023 #, no-wrap
22024 msgid ""
22025 " guestfish --remote -- run\n"
22026 " \n"
22027 msgstr ""
22028
22029 #. type: verbatim
22030 #: ../fish/guestfish.pod:1007
22031 #, no-wrap
22032 msgid ""
22033 " # ...\n"
22034 "\n"
22035 msgstr ""
22036
22037 #. type: =head2
22038 #: ../fish/guestfish.pod:1009
22039 msgid "REMOTE CONTROL RUN COMMAND HANGING"
22040 msgstr ""
22041
22042 #. type: textblock
22043 #: ../fish/guestfish.pod:1011
22044 msgid ""
22045 "Using the C<run> (or C<launch>) command remotely in a command substitution "
22046 "context hangs, ie. don't do (note the backquotes):"
22047 msgstr ""
22048
22049 #. type: verbatim
22050 #: ../fish/guestfish.pod:1014
22051 #, no-wrap
22052 msgid ""
22053 " a=`guestfish --remote run`\n"
22054 "\n"
22055 msgstr ""
22056
22057 #. type: textblock
22058 #: ../fish/guestfish.pod:1016
22059 msgid ""
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."
22062 "cgi?id=592910>."
22063 msgstr ""
22064
22065 #. type: =head1
22066 #: ../fish/guestfish.pod:1020
22067 msgid "PREPARED DISK IMAGES"
22068 msgstr ""
22069
22070 #. type: textblock
22071 #: ../fish/guestfish.pod:1022
22072 msgid ""
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>)."
22078 msgstr ""
22079
22080 #. type: textblock
22081 #: ../fish/guestfish.pod:1028
22082 msgid ""
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 "
22085 "I<overwritten>."
22086 msgstr ""
22087
22088 #. type: textblock
22089 #: ../fish/guestfish.pod:1032
22090 msgid ""
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 "
22097 "disk instead."
22098 msgstr ""
22099
22100 #. type: textblock
22101 #: ../fish/guestfish.pod:1040
22102 msgid "To list the available types and any extra parameters they take, run:"
22103 msgstr ""
22104
22105 #. type: textblock
22106 #: ../fish/guestfish.pod:1044
22107 msgid ""
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."
22110 msgstr ""
22111
22112 #. type: textblock
22113 #: ../fish/guestfish.pod:1048
22114 msgid ""
22115 "If any I<-N> or I<--new> options are given, the guest is automatically "
22116 "launched."
22117 msgstr ""
22118
22119 #. type: textblock
22120 #: ../fish/guestfish.pod:1053
22121 msgid "Create a 100MB disk with an ext4-formatted partition:"
22122 msgstr ""
22123
22124 #. type: verbatim
22125 #: ../fish/guestfish.pod:1055
22126 #, no-wrap
22127 msgid ""
22128 " guestfish -N fs:ext4\n"
22129 "\n"
22130 msgstr ""
22131
22132 #. type: textblock
22133 #: ../fish/guestfish.pod:1057
22134 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:"
22135 msgstr ""
22136
22137 #. type: verbatim
22138 #: ../fish/guestfish.pod:1059
22139 #, no-wrap
22140 msgid ""
22141 " guestfish -N fs:vfat:32M -m /dev/sda1\n"
22142 "\n"
22143 msgstr ""
22144
22145 #. type: textblock
22146 #: ../fish/guestfish.pod:1061
22147 msgid "Create a blank 200MB disk:"
22148 msgstr ""
22149
22150 #. type: verbatim
22151 #: ../fish/guestfish.pod:1063
22152 #, no-wrap
22153 msgid ""
22154 " guestfish -N disk:200M\n"
22155 "\n"
22156 msgstr ""
22157
22158 #. type: =head1
22159 #: ../fish/guestfish.pod:1065
22160 msgid "PROGRESS BARS"
22161 msgstr ""
22162
22163 #. type: textblock
22164 #: ../fish/guestfish.pod:1067
22165 msgid ""
22166 "Some (not all) long-running commands send progress notification messages as "
22167 "they are running.  Guestfish turns these messages into progress bars."
22168 msgstr ""
22169
22170 #. type: textblock
22171 #: ../fish/guestfish.pod:1071
22172 msgid ""
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 "
22175 "the command:"
22176 msgstr ""
22177
22178 #. type: verbatim
22179 #: ../fish/guestfish.pod:1075
22180 #, no-wrap
22181 msgid ""
22182 " ><fs> copy-size /large-file /another-file 2048M\n"
22183 " / 10% [#####-----------------------------------------] 00:30\n"
22184 "\n"
22185 msgstr ""
22186
22187 #. type: textblock
22188 #: ../fish/guestfish.pod:1078
22189 msgid ""
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."
22196 msgstr ""
22197
22198 #. type: textblock
22199 #: ../fish/guestfish.pod:1085
22200 msgid ""
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>."
22204 msgstr ""
22205
22206 #. type: =head1
22207 #: ../fish/guestfish.pod:1090
22208 msgid "GUESTFISH COMMANDS"
22209 msgstr ""
22210
22211 #. type: textblock
22212 #: ../fish/guestfish.pod:1092
22213 msgid ""
22214 "The commands in this section are guestfish convenience commands, in other "
22215 "words, they are not part of the L<guestfs(3)> API."
22216 msgstr ""
22217
22218 #. type: =head2
22219 #: ../fish/guestfish.pod:1095
22220 msgid "help"
22221 msgstr "help"
22222
22223 #. type: verbatim
22224 #: ../fish/guestfish.pod:1097
22225 #, no-wrap
22226 msgid ""
22227 " help\n"
22228 " help cmd\n"
22229 "\n"
22230 msgstr ""
22231 " help\n"
22232 " help команда\n"
22233 "\n"
22234
22235 #. type: textblock
22236 #: ../fish/guestfish.pod:1100
22237 msgid "Without any parameter, this provides general help."
22238 msgstr "Без параметра показує загальну довідкову інформацію."
22239
22240 #. type: textblock
22241 #: ../fish/guestfish.pod:1102
22242 msgid "With a C<cmd> parameter, this displays detailed help for that command."
22243 msgstr ""
22244
22245 #. type: =head2
22246 #: ../fish/guestfish.pod:1104
22247 msgid "quit | exit"
22248 msgstr ""
22249
22250 #. type: textblock
22251 #: ../fish/guestfish.pod:1106
22252 msgid "This exits guestfish.  You can also use C<^D> key."
22253 msgstr ""
22254
22255 #. type: textblock
22256 #: ../fish/guestfish.pod:1108
22257 msgid "@FISH_COMMANDS@"
22258 msgstr ""
22259
22260 #. type: =head1
22261 #: ../fish/guestfish.pod:1110
22262 msgid "COMMANDS"
22263 msgstr "КОМАНДИ"
22264
22265 #. type: textblock
22266 #: ../fish/guestfish.pod:1112 ../src/guestfs.pod:1520
22267 msgid "@ACTIONS@"
22268 msgstr "@ACTIONS@"
22269
22270 #. type: textblock
22271 #: ../fish/guestfish.pod:1116
22272 msgid ""
22273 "guestfish returns 0 if the commands completed without error, or 1 if there "
22274 "was an error."
22275 msgstr ""
22276
22277 #. type: =item
22278 #: ../fish/guestfish.pod:1123
22279 msgid "EDITOR"
22280 msgstr "РЕДАКТОР"
22281
22282 #. type: textblock
22283 #: ../fish/guestfish.pod:1125
22284 msgid ""
22285 "The C<edit> command uses C<$EDITOR> as the editor.  If not set, it uses "
22286 "C<vi>."
22287 msgstr ""
22288
22289 #. type: =item
22290 #: ../fish/guestfish.pod:1128 ../src/guestfs.pod:3213
22291 msgid "FEBOOTSTRAP_KERNEL"
22292 msgstr ""
22293
22294 #. type: =item
22295 #: ../fish/guestfish.pod:1130 ../src/guestfs.pod:3215
22296 msgid "FEBOOTSTRAP_MODULES"
22297 msgstr ""
22298
22299 #. type: textblock
22300 #: ../fish/guestfish.pod:1132 ../src/guestfs.pod:3217
22301 msgid ""
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."
22307 msgstr ""
22308
22309 #. type: =item
22310 #: ../fish/guestfish.pod:1138
22311 msgid "GUESTFISH_DISPLAY_IMAGE"
22312 msgstr ""
22313
22314 #. type: textblock
22315 #: ../fish/guestfish.pod:1140
22316 msgid ""
22317 "The C<display> command uses C<$GUESTFISH_DISPLAY_IMAGE> to display images.  "
22318 "If not set, it uses L<display(1)>."
22319 msgstr ""
22320
22321 #. type: =item
22322 #: ../fish/guestfish.pod:1143
22323 msgid "GUESTFISH_PID"
22324 msgstr ""
22325
22326 #. type: textblock
22327 #: ../fish/guestfish.pod:1145
22328 msgid ""
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>."
22331 msgstr ""
22332
22333 #. type: =item
22334 #: ../fish/guestfish.pod:1149
22335 msgid "HEXEDITOR"
22336 msgstr ""
22337
22338 #. type: textblock
22339 #: ../fish/guestfish.pod:1151
22340 msgid ""
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."
22343 msgstr ""
22344
22345 #. type: =item
22346 #: ../fish/guestfish.pod:1155
22347 msgid "HOME"
22348 msgstr "ДОМІВКА"
22349
22350 #. type: textblock
22351 #: ../fish/guestfish.pod:1157
22352 msgid ""
22353 "If compiled with GNU readline support, various files in the home directory "
22354 "can be used.  See L</FILES>."
22355 msgstr ""
22356
22357 #. type: =item
22358 #: ../fish/guestfish.pod:1160 ../src/guestfs.pod:3223
22359 msgid "LIBGUESTFS_APPEND"
22360 msgstr ""
22361
22362 #. type: textblock
22363 #: ../fish/guestfish.pod:1162 ../src/guestfs.pod:3225
22364 msgid "Pass additional options to the guest kernel."
22365 msgstr ""
22366
22367 #. type: =item
22368 #: ../fish/guestfish.pod:1164 ../src/guestfs.pod:3227
22369 msgid "LIBGUESTFS_DEBUG"
22370 msgstr "LIBGUESTFS_DEBUG"
22371
22372 #. type: textblock
22373 #: ../fish/guestfish.pod:1166
22374 msgid ""
22375 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
22376 "effect as using the B<-v> option."
22377 msgstr ""
22378
22379 #. type: =item
22380 #: ../fish/guestfish.pod:1169 ../src/guestfs.pod:3232
22381 msgid "LIBGUESTFS_MEMSIZE"
22382 msgstr "LIBGUESTFS_MEMSIZE"
22383
22384 #. type: textblock
22385 #: ../fish/guestfish.pod:1171 ../src/guestfs.pod:3234
22386 msgid ""
22387 "Set the memory allocated to the qemu process, in megabytes.  For example:"
22388 msgstr ""
22389
22390 #. type: verbatim
22391 #: ../fish/guestfish.pod:1174 ../src/guestfs.pod:3237
22392 #, no-wrap
22393 msgid ""
22394 " LIBGUESTFS_MEMSIZE=700\n"
22395 "\n"
22396 msgstr ""
22397 " LIBGUESTFS_MEMSIZE=700\n"
22398 "\n"
22399
22400 #. type: =item
22401 #: ../fish/guestfish.pod:1176 ../src/guestfs.pod:3239
22402 msgid "LIBGUESTFS_PATH"
22403 msgstr ""
22404
22405 #. type: textblock
22406 #: ../fish/guestfish.pod:1178
22407 msgid ""
22408 "Set the path that guestfish uses to search for kernel and initrd.img.  See "
22409 "the discussion of paths in L<guestfs(3)>."
22410 msgstr ""
22411
22412 #. type: =item
22413 #: ../fish/guestfish.pod:1181 ../src/guestfs.pod:3244
22414 msgid "LIBGUESTFS_QEMU"
22415 msgstr ""
22416
22417 #. type: textblock
22418 #: ../fish/guestfish.pod:1183 ../src/guestfs.pod:3246
22419 msgid ""
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."
22422 msgstr ""
22423
22424 #. type: =item
22425 #: ../fish/guestfish.pod:1187 ../src/guestfs.pod:3252
22426 msgid "LIBGUESTFS_TRACE"
22427 msgstr ""
22428
22429 #. type: textblock
22430 #: ../fish/guestfish.pod:1189
22431 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces."
22432 msgstr ""
22433
22434 #. type: =item
22435 #: ../fish/guestfish.pod:1191
22436 msgid "PAGER"
22437 msgstr "РОЗБИТТЯ НА СТОРІНКИ"
22438
22439 #. type: textblock
22440 #: ../fish/guestfish.pod:1193
22441 msgid ""
22442 "The C<more> command uses C<$PAGER> as the pager.  If not set, it uses "
22443 "C<more>."
22444 msgstr ""
22445
22446 #. type: =item
22447 #: ../fish/guestfish.pod:1196 ../sparsify/virt-sparsify.pod:236
22448 #: ../src/guestfs.pod:3257
22449 msgid "TMPDIR"
22450 msgstr ""
22451
22452 #. type: textblock
22453 #: ../fish/guestfish.pod:1198 ../src/guestfs.pod:3259
22454 msgid ""
22455 "Location of temporary directory, defaults to C</tmp> except for the cached "
22456 "supermin appliance which defaults to C</var/tmp>."
22457 msgstr ""
22458
22459 #. type: textblock
22460 #: ../fish/guestfish.pod:1201 ../src/guestfs.pod:3262
22461 msgid ""
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."
22466 msgstr ""
22467
22468 #. type: =head1
22469 #: ../fish/guestfish.pod:1209 ../fuse/guestmount.pod:297
22470 #: ../rescue/virt-rescue.pod:310
22471 msgid "FILES"
22472 msgstr "ФАЙЛИ"
22473
22474 #. type: =item
22475 #: ../fish/guestfish.pod:1213 ../fuse/guestmount.pod:301
22476 #: ../rescue/virt-rescue.pod:314
22477 msgid "$HOME/.libguestfs-tools.rc"
22478 msgstr ""
22479
22480 #. type: =item
22481 #: ../fish/guestfish.pod:1215 ../fuse/guestmount.pod:303
22482 #: ../rescue/virt-rescue.pod:316
22483 msgid "/etc/libguestfs-tools.conf"
22484 msgstr ""
22485
22486 #. type: textblock
22487 #: ../fish/guestfish.pod:1217 ../fuse/guestmount.pod:305
22488 #: ../rescue/virt-rescue.pod:318
22489 msgid ""
22490 "This configuration file controls the default read-only or read-write mode "
22491 "(I<--ro> or I<--rw>)."
22492 msgstr ""
22493
22494 #. type: textblock
22495 #: ../fish/guestfish.pod:1220
22496 msgid "See L</OPENING DISKS FOR READ AND WRITE>."
22497 msgstr "Див. L</OPENING DISKS FOR READ AND WRITE>."
22498
22499 #. type: =item
22500 #: ../fish/guestfish.pod:1222
22501 msgid "$HOME/.guestfish"
22502 msgstr ""
22503
22504 #. type: textblock
22505 #: ../fish/guestfish.pod:1224
22506 msgid ""
22507 "If compiled with GNU readline support, then the command history is saved in "
22508 "this file."
22509 msgstr ""
22510
22511 #. type: =item
22512 #: ../fish/guestfish.pod:1227
22513 msgid "$HOME/.inputrc"
22514 msgstr ""
22515
22516 #. type: =item
22517 #: ../fish/guestfish.pod:1229
22518 msgid "/etc/inputrc"
22519 msgstr ""
22520
22521 #. type: textblock
22522 #: ../fish/guestfish.pod:1231
22523 msgid ""
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>."
22527 msgstr ""
22528
22529 #. type: textblock
22530 #: ../fish/guestfish.pod:1235
22531 msgid "To write rules which only apply to guestfish, use:"
22532 msgstr ""
22533
22534 #. type: verbatim
22535 #: ../fish/guestfish.pod:1237
22536 #, no-wrap
22537 msgid ""
22538 " $if guestfish\n"
22539 " ...\n"
22540 " $endif\n"
22541 "\n"
22542 msgstr ""
22543
22544 #. type: textblock
22545 #: ../fish/guestfish.pod:1241
22546 msgid ""
22547 "Variables that you can set in inputrc that change the behaviour of guestfish "
22548 "in useful ways include:"
22549 msgstr ""
22550
22551 #. type: =item
22552 #: ../fish/guestfish.pod:1246
22553 msgid "completion-ignore-case (default: on)"
22554 msgstr ""
22555
22556 #. type: textblock
22557 #: ../fish/guestfish.pod:1248
22558 msgid ""
22559 "By default, guestfish will ignore case when tab-completing paths on the "
22560 "disk.  Use:"
22561 msgstr ""
22562
22563 #. type: verbatim
22564 #: ../fish/guestfish.pod:1251
22565 #, no-wrap
22566 msgid ""
22567 " set completion-ignore-case off\n"
22568 "\n"
22569 msgstr ""
22570
22571 #. type: textblock
22572 #: ../fish/guestfish.pod:1253
22573 msgid "to make guestfish case sensitive."
22574 msgstr ""
22575
22576 #. type: =item
22577 #: ../fish/guestfish.pod:1257
22578 msgid "test1.img"
22579 msgstr ""
22580
22581 #. type: =item
22582 #: ../fish/guestfish.pod:1259
22583 msgid "test2.img (etc)"
22584 msgstr ""
22585
22586 #. type: textblock
22587 #: ../fish/guestfish.pod:1261
22588 msgid ""
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."
22593 msgstr ""
22594
22595 #. type: textblock
22596 #: ../fish/guestfish.pod:1270
22597 msgid ""
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)>."
22605 msgstr ""
22606
22607 #. type: textblock
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/>"
22611 msgstr ""
22612
22613 #. type: textblock
22614 #: ../fish/virt-copy-in.pod:5
22615 msgid ""
22616 "virt-copy-in - Copy files and directories into a virtual machine disk image."
22617 msgstr ""
22618
22619 #. type: verbatim
22620 #: ../fish/virt-copy-in.pod:9
22621 #, no-wrap
22622 msgid ""
22623 " virt-copy-in -a disk.img file|dir [file|dir ...] /destination\n"
22624 "\n"
22625 msgstr ""
22626
22627 #. type: verbatim
22628 #: ../fish/virt-copy-in.pod:11
22629 #, no-wrap
22630 msgid ""
22631 " virt-copy-in -d domain file|dir [file|dir ...] /destination\n"
22632 "\n"
22633 msgstr ""
22634
22635 #. type: textblock
22636 #: ../fish/virt-copy-in.pod:15
22637 msgid ""
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."
22641 msgstr ""
22642
22643 #. type: textblock
22644 #: ../fish/virt-copy-in.pod:21
22645 msgid ""
22646 "C<virt-copy-in> copies files and directories from the local disk into a "
22647 "virtual machine disk image or named libvirt domain."
22648 msgstr ""
22649
22650 #. type: textblock
22651 #: ../fish/virt-copy-in.pod:24
22652 msgid ""
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."
22657 msgstr ""
22658
22659 #. type: verbatim
22660 #: ../fish/virt-copy-in.pod:33
22661 #, no-wrap
22662 msgid ""
22663 " virt-copy-in -d MyGuest resolv.conf /etc\n"
22664 "\n"
22665 msgstr ""
22666
22667 #. type: textblock
22668 #: ../fish/virt-copy-in.pod:35 ../fish/virt-tar-in.pod:32
22669 msgid "Upload a home directory to a guest:"
22670 msgstr ""
22671
22672 #. type: verbatim
22673 #: ../fish/virt-copy-in.pod:37
22674 #, no-wrap
22675 msgid ""
22676 " virt-copy-in -d MyGuest skel /home\n"
22677 "\n"
22678 msgstr ""
22679
22680 #. type: =head1
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"
22684 msgstr ""
22685
22686 #. type: textblock
22687 #: ../fish/virt-copy-in.pod:41
22688 msgid ""
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."
22692 msgstr ""
22693
22694 #. type: textblock
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
22697 msgid ""
22698 "Since the shell script just passes options straight to guestfish, read "
22699 "L<guestfish(1)> to see the full list of options."
22700 msgstr ""
22701
22702 #. type: textblock
22703 #: ../fish/virt-copy-in.pod:52
22704 msgid ""
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/>."
22707 msgstr ""
22708
22709 #. type: textblock
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/>"
22713 msgstr ""
22714
22715 #. type: textblock
22716 #: ../fish/virt-copy-out.pod:5
22717 msgid ""
22718 "virt-copy-out - Copy files and directories out of a virtual machine disk "
22719 "image."
22720 msgstr ""
22721
22722 #. type: verbatim
22723 #: ../fish/virt-copy-out.pod:9
22724 #, no-wrap
22725 msgid ""
22726 " virt-copy-out -a disk.img /file|dir [/file|dir ...] localdir\n"
22727 "\n"
22728 msgstr ""
22729
22730 #. type: verbatim
22731 #: ../fish/virt-copy-out.pod:11
22732 #, no-wrap
22733 msgid ""
22734 " virt-copy-out -d domain /file|dir [/file|dir ...] localdir\n"
22735 "\n"
22736 msgstr ""
22737
22738 #. type: textblock
22739 #: ../fish/virt-copy-out.pod:15
22740 msgid ""
22741 "C<virt-copy-out> copies files and directories out of a virtual machine disk "
22742 "image or named libvirt domain."
22743 msgstr ""
22744
22745 #. type: textblock
22746 #: ../fish/virt-copy-out.pod:18
22747 msgid ""
22748 "You can give one of more filenames and directories on the command line.  "
22749 "Directories are copied out recursively."
22750 msgstr ""
22751
22752 #. type: textblock
22753 #: ../fish/virt-copy-out.pod:23
22754 msgid "Download the home directories from a virtual machine:"
22755 msgstr ""
22756
22757 #. type: verbatim
22758 #: ../fish/virt-copy-out.pod:25
22759 #, no-wrap
22760 msgid ""
22761 " mkdir homes\n"
22762 " virt-copy-out -d MyGuest /home homes\n"
22763 "\n"
22764 msgstr ""
22765
22766 #. type: textblock
22767 #: ../fish/virt-copy-out.pod:30
22768 msgid ""
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."
22772 msgstr ""
22773
22774 #. type: textblock
22775 #: ../fish/virt-copy-out.pod:41
22776 msgid ""
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/>."
22779 msgstr ""
22780
22781 #. type: textblock
22782 #: ../fish/virt-tar-in.pod:5
22783 msgid "virt-tar-in - Unpack a tarball into a virtual machine disk image."
22784 msgstr ""
22785
22786 #. type: verbatim
22787 #: ../fish/virt-tar-in.pod:9
22788 #, no-wrap
22789 msgid ""
22790 " virt-tar-in -a disk.img data.tar /destination\n"
22791 "\n"
22792 msgstr ""
22793
22794 #. type: verbatim
22795 #: ../fish/virt-tar-in.pod:11
22796 #, no-wrap
22797 msgid ""
22798 " virt-tar-in -d domain data.tar /destination\n"
22799 "\n"
22800 msgstr ""
22801
22802 #. type: verbatim
22803 #: ../fish/virt-tar-in.pod:13
22804 #, no-wrap
22805 msgid ""
22806 " zcat data.tar.gz | virt-tar-in -d domain - /destination\n"
22807 "\n"
22808 msgstr ""
22809
22810 #. type: textblock
22811 #: ../fish/virt-tar-in.pod:17
22812 msgid ""
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."
22816 msgstr ""
22817
22818 #. type: textblock
22819 #: ../fish/virt-tar-in.pod:23
22820 msgid ""
22821 "C<virt-tar-in> unpacks an uncompressed tarball into a virtual machine disk "
22822 "image or named libvirt domain."
22823 msgstr ""
22824
22825 #. type: textblock
22826 #: ../fish/virt-tar-in.pod:26
22827 msgid ""
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 "
22830 "unpack into."
22831 msgstr ""
22832
22833 #. type: verbatim
22834 #: ../fish/virt-tar-in.pod:34
22835 #, no-wrap
22836 msgid ""
22837 " virt-tar-in -d MyGuest homes.tar /home\n"
22838 "\n"
22839 msgstr ""
22840
22841 #. type: textblock
22842 #: ../fish/virt-tar-in.pod:38
22843 msgid ""
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."
22847 msgstr ""
22848
22849 #. type: textblock
22850 #: ../fish/virt-tar-in.pod:49
22851 msgid ""
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."
22854 "org/>."
22855 msgstr ""
22856
22857 #. type: textblock
22858 #: ../fish/virt-tar-out.pod:5
22859 msgid ""
22860 "virt-tar-out - Pack a virtual machine disk image directory into a tarball."
22861 msgstr ""
22862
22863 #. type: verbatim
22864 #: ../fish/virt-tar-out.pod:9
22865 #, no-wrap
22866 msgid ""
22867 " virt-tar-out -a disk.img /dir files.tar\n"
22868 "\n"
22869 msgstr ""
22870
22871 #. type: verbatim
22872 #: ../fish/virt-tar-out.pod:11
22873 #, no-wrap
22874 msgid ""
22875 " virt-tar-out -d domain /dir files.tar\n"
22876 "\n"
22877 msgstr ""
22878
22879 #. type: verbatim
22880 #: ../fish/virt-tar-out.pod:13
22881 #, no-wrap
22882 msgid ""
22883 " virt-tar-out -d domain /dir - | gzip --best > files.tar.gz\n"
22884 "\n"
22885 msgstr ""
22886
22887 #. type: textblock
22888 #: ../fish/virt-tar-out.pod:17
22889 msgid ""
22890 "C<virt-tar-out> packs a virtual machine disk image directory into a tarball."
22891 msgstr ""
22892
22893 #. type: textblock
22894 #: ../fish/virt-tar-out.pod:20
22895 msgid ""
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 "
22898 "standard output."
22899 msgstr ""
22900
22901 #. type: textblock
22902 #: ../fish/virt-tar-out.pod:26
22903 msgid "Download the home directories from a guest:"
22904 msgstr ""
22905
22906 #. type: verbatim
22907 #: ../fish/virt-tar-out.pod:28
22908 #, no-wrap
22909 msgid ""
22910 " virt-tar-out -d MyGuest /home - | gzip --best > homes.tar.gz\n"
22911 "\n"
22912 msgstr ""
22913
22914 #. type: textblock
22915 #: ../fish/virt-tar-out.pod:32
22916 msgid ""
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."
22920 msgstr ""
22921
22922 #. type: textblock
22923 #: ../fish/virt-tar-out.pod:43
22924 msgid ""
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/>."
22927 msgstr ""
22928
22929 #. type: textblock
22930 #: ../fuse/guestmount.pod:5
22931 msgid ""
22932 "guestmount - Mount a guest filesystem on the host using FUSE and libguestfs"
22933 msgstr ""
22934
22935 #. type: verbatim
22936 #: ../fuse/guestmount.pod:9
22937 #, no-wrap
22938 msgid ""
22939 " guestmount [--options] -a disk.img -m device [--ro] mountpoint\n"
22940 "\n"
22941 msgstr ""
22942
22943 #. type: verbatim
22944 #: ../fuse/guestmount.pod:11
22945 #, no-wrap
22946 msgid ""
22947 " guestmount [--options] -a disk.img -i [--ro] mountpoint\n"
22948 "\n"
22949 msgstr ""
22950
22951 #. type: verbatim
22952 #: ../fuse/guestmount.pod:13
22953 #, no-wrap
22954 msgid ""
22955 " guestmount [--options] -d Guest -i [--ro] mountpoint\n"
22956 "\n"
22957 msgstr ""
22958
22959 #. type: textblock
22960 #: ../fuse/guestmount.pod:17
22961 msgid ""
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."
22964 msgstr ""
22965
22966 #. type: textblock
22967 #: ../fuse/guestmount.pod:22
22968 msgid ""
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."
22973 msgstr ""
22974
22975 #. type: textblock
22976 #: ../fuse/guestmount.pod:27
22977 msgid ""
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."
22983 msgstr ""
22984
22985 #. type: textblock
22986 #: ../fuse/guestmount.pod:33
22987 msgid ""
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."
22992 msgstr ""
22993
22994 #. type: textblock
22995 #: ../fuse/guestmount.pod:41
22996 msgid ""
22997 "For a typical Windows guest which has its main filesystem on the first "
22998 "partition:"
22999 msgstr ""
23000
23001 #. type: verbatim
23002 #: ../fuse/guestmount.pod:44
23003 #, no-wrap
23004 msgid ""
23005 " guestmount -a windows.img -m /dev/sda1 --ro /mnt\n"
23006 "\n"
23007 msgstr ""
23008
23009 #. type: textblock
23010 #: ../fuse/guestmount.pod:46
23011 msgid ""
23012 "For a typical Linux guest which has a /boot filesystem on the first "
23013 "partition, and the root filesystem on a logical volume:"
23014 msgstr ""
23015
23016 #. type: verbatim
23017 #: ../fuse/guestmount.pod:49
23018 #, no-wrap
23019 msgid ""
23020 " guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt\n"
23021 "\n"
23022 msgstr ""
23023
23024 #. type: textblock
23025 #: ../fuse/guestmount.pod:51
23026 msgid "To get libguestfs to detect guest mountpoints for you:"
23027 msgstr ""
23028
23029 #. type: verbatim
23030 #: ../fuse/guestmount.pod:53
23031 #, no-wrap
23032 msgid ""
23033 " guestmount -a guest.img -i --ro /mnt\n"
23034 "\n"
23035 msgstr ""
23036
23037 #. type: textblock
23038 #: ../fuse/guestmount.pod:55
23039 msgid "For a libvirt guest called \"Guest\" you could do:"
23040 msgstr ""
23041
23042 #. type: verbatim
23043 #: ../fuse/guestmount.pod:57
23044 #, no-wrap
23045 msgid ""
23046 " guestmount -d Guest -i --ro /mnt\n"
23047 "\n"
23048 msgstr ""
23049
23050 #. type: textblock
23051 #: ../fuse/guestmount.pod:59
23052 msgid ""
23053 "If you don't know what filesystems are contained in a guest or disk image, "
23054 "use L<virt-filesystems(1)> first:"
23055 msgstr ""
23056
23057 #. type: verbatim
23058 #: ../fuse/guestmount.pod:62
23059 #, no-wrap
23060 msgid ""
23061 " virt-filesystems MyGuest\n"
23062 "\n"
23063 msgstr ""
23064
23065 #. type: textblock
23066 #: ../fuse/guestmount.pod:64
23067 msgid ""
23068 "If you want to trace the libguestfs calls but without excessive debugging "
23069 "information, we recommend:"
23070 msgstr ""
23071
23072 #. type: verbatim
23073 #: ../fuse/guestmount.pod:67
23074 #, no-wrap
23075 msgid ""
23076 " guestmount [...] --trace /mnt\n"
23077 "\n"
23078 msgstr ""
23079
23080 #. type: textblock
23081 #: ../fuse/guestmount.pod:69
23082 msgid "If you want to debug the program, we recommend:"
23083 msgstr ""
23084
23085 #. type: verbatim
23086 #: ../fuse/guestmount.pod:71
23087 #, no-wrap
23088 msgid ""
23089 " guestmount [...] --trace --verbose /mnt\n"
23090 "\n"
23091 msgstr ""
23092
23093 #. type: =head1
23094 #: ../fuse/guestmount.pod:73 ../rescue/virt-rescue.pod:96
23095 #: ../resize/virt-resize.pod:621
23096 msgid "NOTES"
23097 msgstr "ПРИМІТКИ"
23098
23099 #. type: =head2
23100 #: ../fuse/guestmount.pod:75
23101 msgid "Other users cannot see the filesystem by default"
23102 msgstr ""
23103
23104 #. type: textblock
23105 #: ../fuse/guestmount.pod:77
23106 msgid ""
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:"
23110 msgstr ""
23111
23112 #. type: verbatim
23113 #: ../fuse/guestmount.pod:81
23114 #, no-wrap
23115 msgid ""
23116 " sudo guestmount [...] -o allow_other /mnt\n"
23117 "\n"
23118 msgstr ""
23119
23120 #. type: =head2
23121 #: ../fuse/guestmount.pod:83
23122 msgid "Enabling FUSE"
23123 msgstr ""
23124
23125 #. type: textblock
23126 #: ../fuse/guestmount.pod:85
23127 msgid ""
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."
23131 msgstr ""
23132
23133 #. type: textblock
23134 #: ../fuse/guestmount.pod:89
23135 msgid ""
23136 "On other distros, no special group is required.  It is not necessary on "
23137 "Fedora or Red Hat Enterprise Linux."
23138 msgstr ""
23139
23140 #. type: textblock
23141 #: ../fuse/guestmount.pod:100
23142 msgid "Add a block device or virtual machine image."
23143 msgstr ""
23144
23145 #. type: =item
23146 #: ../fuse/guestmount.pod:123
23147 msgid "B<--dir-cache-timeout N>"
23148 msgstr "B<--dir-cache-timeout N>"
23149
23150 #. type: textblock
23151 #: ../fuse/guestmount.pod:125
23152 msgid ""
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."
23158 msgstr ""
23159
23160 #. type: textblock
23161 #: ../fuse/guestmount.pod:131
23162 msgid ""
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."
23166 msgstr ""
23167
23168 #. type: textblock
23169 #: ../fuse/guestmount.pod:151
23170 msgid ""
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>."
23175 msgstr ""
23176
23177 #. type: =item
23178 #: ../fuse/guestmount.pod:156
23179 msgid "B<--fuse-help>"
23180 msgstr "B<--fuse-help>"
23181
23182 #. type: textblock
23183 #: ../fuse/guestmount.pod:158
23184 msgid "Display help on special FUSE options (see I<-o> below)."
23185 msgstr ""
23186
23187 #. type: textblock
23188 #: ../fuse/guestmount.pod:162
23189 msgid "Display brief help and exit."
23190 msgstr ""
23191
23192 #. type: textblock
23193 #: ../fuse/guestmount.pod:186
23194 msgid ""
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)."
23197 msgstr ""
23198
23199 #. type: textblock
23200 #: ../fuse/guestmount.pod:189
23201 msgid ""
23202 "If the mountpoint is omitted, it defaults to C</>.  You have to mount "
23203 "something on C</>."
23204 msgstr ""
23205
23206 #. type: textblock
23207 #: ../fuse/guestmount.pod:206
23208 msgid ""
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."
23212 msgstr ""
23213
23214 #. type: =item
23215 #: ../fuse/guestmount.pod:211
23216 msgid "B<-o option>"
23217 msgstr "B<-o параметр>"
23218
23219 #. type: =item
23220 #: ../fuse/guestmount.pod:213
23221 msgid "B<--option option>"
23222 msgstr "B<--option параметр>"
23223
23224 #. type: textblock
23225 #: ../fuse/guestmount.pod:215
23226 msgid "Pass extra options to FUSE."
23227 msgstr ""
23228
23229 #. type: textblock
23230 #: ../fuse/guestmount.pod:217
23231 msgid ""
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."
23235 msgstr ""
23236
23237 #. type: verbatim
23238 #: ../fuse/guestmount.pod:221
23239 #, no-wrap
23240 msgid ""
23241 " guestmount --fuse-help\n"
23242 "\n"
23243 msgstr ""
23244
23245 #. type: textblock
23246 #: ../fuse/guestmount.pod:223
23247 msgid "Some potentially useful FUSE options:"
23248 msgstr ""
23249
23250 #. type: =item
23251 #: ../fuse/guestmount.pod:227
23252 msgid "B<-o allow_other>"
23253 msgstr ""
23254
23255 #. type: textblock
23256 #: ../fuse/guestmount.pod:229
23257 msgid "Allow other users to see the filesystem."
23258 msgstr ""
23259
23260 #. type: =item
23261 #: ../fuse/guestmount.pod:231
23262 msgid "B<-o attr_timeout=N>"
23263 msgstr "B<-o attr_timeout=N>"
23264
23265 #. type: textblock
23266 #: ../fuse/guestmount.pod:233
23267 msgid "Enable attribute caching by FUSE, and set the timeout to I<N> seconds."
23268 msgstr ""
23269
23270 #. type: =item
23271 #: ../fuse/guestmount.pod:235
23272 msgid "B<-o kernel_cache>"
23273 msgstr ""
23274
23275 #. type: textblock
23276 #: ../fuse/guestmount.pod:237
23277 msgid ""
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."
23281 msgstr ""
23282
23283 #. type: =item
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>"
23287
23288 #. type: textblock
23289 #: ../fuse/guestmount.pod:243
23290 msgid ""
23291 "Use these options to map all UIDs and GIDs inside the guest filesystem to "
23292 "the chosen values."
23293 msgstr ""
23294
23295 #. type: textblock
23296 #: ../fuse/guestmount.pod:252
23297 msgid ""
23298 "Add devices and mount everything read-only.  Also disallow writes and make "
23299 "the disk appear read-only to FUSE."
23300 msgstr ""
23301
23302 #. type: textblock
23303 #: ../fuse/guestmount.pod:255
23304 msgid ""
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."
23309 msgstr ""
23310
23311 #. type: textblock
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>."
23315
23316 #. type: textblock
23317 #: ../fuse/guestmount.pod:264
23318 msgid "Enable SELinux support for the guest."
23319 msgstr ""
23320
23321 #. type: textblock
23322 #: ../fuse/guestmount.pod:270
23323 msgid "Enable verbose messages from underlying libguestfs."
23324 msgstr ""
23325
23326 #. type: textblock
23327 #: ../fuse/guestmount.pod:276
23328 msgid "Display the program version and exit."
23329 msgstr ""
23330
23331 #. type: textblock
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>."
23336
23337 #. type: =item
23338 #: ../fuse/guestmount.pod:289
23339 msgid "B<--trace>"
23340 msgstr "B<--trace>"
23341
23342 #. type: textblock
23343 #: ../fuse/guestmount.pod:291
23344 msgid "Trace libguestfs calls and entry into each FUSE function."
23345 msgstr ""
23346
23347 #. type: textblock
23348 #: ../fuse/guestmount.pod:293
23349 msgid "This also stops the daemon from forking into the background."
23350 msgstr ""
23351
23352 #. type: textblock
23353 #: ../fuse/guestmount.pod:319
23354 msgid ""
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."
23357 "net/>."
23358 msgstr ""
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."
23361 "net/>."
23362
23363 #. type: textblock
23364 #: ../fuse/guestmount.pod:334
23365 msgid "Copyright (C) 2009-2010 Red Hat Inc.  L<http://libguestfs.org/>"
23366 msgstr ""
23367
23368 #. type: textblock
23369 #: ../inspector/virt-inspector.pod:5
23370 msgid ""
23371 "virt-inspector - Display operating system version and other information "
23372 "about a virtual machine"
23373 msgstr ""
23374
23375 #. type: verbatim
23376 #: ../inspector/virt-inspector.pod:9
23377 #, no-wrap
23378 msgid ""
23379 " virt-inspector [--options] -d domname\n"
23380 "\n"
23381 msgstr ""
23382
23383 #. type: verbatim
23384 #: ../inspector/virt-inspector.pod:11
23385 #, no-wrap
23386 msgid ""
23387 " virt-inspector [--options] -a disk.img [-a disk.img ...]\n"
23388 "\n"
23389 msgstr ""
23390
23391 #. type: verbatim
23392 #: ../inspector/virt-inspector.pod:15
23393 #, no-wrap
23394 msgid ""
23395 " virt-inspector domname\n"
23396 "\n"
23397 msgstr ""
23398
23399 #. type: verbatim
23400 #: ../inspector/virt-inspector.pod:17 ../inspector/virt-inspector.pod:148
23401 #, no-wrap
23402 msgid ""
23403 " virt-inspector disk.img [disk.img ...]\n"
23404 "\n"
23405 msgstr ""
23406
23407 #. type: textblock
23408 #: ../inspector/virt-inspector.pod:21
23409 msgid ""
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."
23413 msgstr ""
23414
23415 #. type: textblock
23416 #: ../inspector/virt-inspector.pod:25
23417 msgid "Virt-inspector produces XML output for feeding into other programs."
23418 msgstr ""
23419
23420 #. type: textblock
23421 #: ../inspector/virt-inspector.pod:27
23422 msgid ""
23423 "In the normal usage, use C<virt-inspector -d domname> where C<domname> is "
23424 "the libvirt domain (see: C<virsh list --all>)."
23425 msgstr ""
23426
23427 #. type: textblock
23428 #: ../inspector/virt-inspector.pod:30
23429 msgid ""
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."
23435 msgstr ""
23436
23437 #. type: textblock
23438 #: ../inspector/virt-inspector.pod:37
23439 msgid ""
23440 "You can also run virt-inspector on install disks, live CDs, bootable USB "
23441 "keys and similar."
23442 msgstr ""
23443
23444 #. type: textblock
23445 #: ../inspector/virt-inspector.pod:40
23446 msgid ""
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)."
23450 msgstr ""
23451
23452 #. type: textblock
23453 #: ../inspector/virt-inspector.pod:45
23454 msgid ""
23455 "Because virt-inspector needs direct access to guest images, it won't "
23456 "normally work over remote libvirt connections."
23457 msgstr ""
23458
23459 #. type: textblock
23460 #: ../inspector/virt-inspector.pod:48
23461 msgid ""
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>)."
23467 msgstr ""
23468
23469 #. type: textblock
23470 #: ../inspector/virt-inspector.pod:81
23471 msgid ""
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 "
23474 "at all."
23475 msgstr ""
23476
23477 #. type: textblock
23478 #: ../inspector/virt-inspector.pod:94
23479 msgid ""
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."
23484 msgstr ""
23485
23486 #. type: textblock
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
23490 msgid ""
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."
23493 msgstr ""
23494
23495 #. type: textblock
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
23499 msgid ""
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 "
23502 "ignored."
23503 msgstr ""
23504
23505 #. type: textblock
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
23510 msgid ""
23511 "If working with untrusted raw-format guest disk images, you should ensure "
23512 "the format is always specified."
23513 msgstr ""
23514
23515 #. type: =item
23516 #: ../inspector/virt-inspector.pod:135
23517 #, fuzzy
23518 #| msgid "B<--parts>"
23519 msgid "B<--xpath> query"
23520 msgstr "B<--parts>"
23521
23522 #. type: textblock
23523 #: ../inspector/virt-inspector.pod:137
23524 msgid ""
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."
23528 msgstr ""
23529
23530 #. type: textblock
23531 #: ../inspector/virt-inspector.pod:146
23532 msgid "Previous versions of virt-inspector allowed you to write either:"
23533 msgstr ""
23534
23535 #. type: verbatim
23536 #: ../inspector/virt-inspector.pod:152
23537 #, no-wrap
23538 msgid ""
23539 " virt-inspector guestname\n"
23540 "\n"
23541 msgstr ""
23542
23543 #. type: =head1
23544 #: ../inspector/virt-inspector.pod:160
23545 msgid "XML FORMAT"
23546 msgstr ""
23547
23548 #. type: textblock
23549 #: ../inspector/virt-inspector.pod:162
23550 msgid ""
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."
23554 msgstr ""
23555
23556 #. type: textblock
23557 #: ../inspector/virt-inspector.pod:166
23558 msgid ""
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."
23563 msgstr ""
23564
23565 #. type: =head2
23566 #: ../inspector/virt-inspector.pod:171
23567 msgid "E<lt>operatingsystemE<gt>"
23568 msgstr ""
23569
23570 #. type: textblock
23571 #: ../inspector/virt-inspector.pod:173
23572 msgid ""
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:"
23576 msgstr ""
23577
23578 #. type: verbatim
23579 #: ../inspector/virt-inspector.pod:177
23580 #, no-wrap
23581 msgid ""
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"
23594 "\n"
23595 msgstr ""
23596
23597 #. type: textblock
23598 #: ../inspector/virt-inspector.pod:190
23599 msgid ""
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>."
23606 msgstr ""
23607
23608 #. type: textblock
23609 #: ../inspector/virt-inspector.pod:198
23610 msgid ""
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)."
23614 msgstr ""
23615
23616 #. type: =head2
23617 #: ../inspector/virt-inspector.pod:202
23618 msgid "E<lt>mountpointsE<gt>"
23619 msgstr ""
23620
23621 #. type: textblock
23622 #: ../inspector/virt-inspector.pod:204
23623 msgid ""
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:"
23627 msgstr ""
23628
23629 #. type: verbatim
23630 #: ../inspector/virt-inspector.pod:208
23631 #, no-wrap
23632 msgid ""
23633 " <operatingsystems>\n"
23634 "   <operatingsystem>\n"
23635 "     ...\n"
23636 "     <mountpoints>\n"
23637 "       <mountpoint dev=\"/dev/vg_f13x64/lv_root\">/</mountpoint>\n"
23638 "       <mountpoint dev=\"/dev/sda1\">/boot</mountpoint>\n"
23639 "     </mountpoints>\n"
23640 "\n"
23641 msgstr ""
23642
23643 #. type: textblock
23644 #: ../inspector/virt-inspector.pod:216
23645 msgid ""
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."
23649 msgstr ""
23650
23651 #. type: =head2
23652 #: ../inspector/virt-inspector.pod:221
23653 msgid "E<lt>filesystemsE<gt>"
23654 msgstr ""
23655
23656 #. type: textblock
23657 #: ../inspector/virt-inspector.pod:223
23658 msgid ""
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)."
23663 msgstr ""
23664
23665 #. type: textblock
23666 #: ../inspector/virt-inspector.pod:229
23667 msgid "You might see something like this:"
23668 msgstr ""
23669
23670 #. type: verbatim
23671 #: ../inspector/virt-inspector.pod:231
23672 #, no-wrap
23673 msgid ""
23674 " <operatingsystems>\n"
23675 "   <operatingsystem>\n"
23676 "     ...\n"
23677 "     <filesystems>\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"
23682 "       </filesystem>\n"
23683 "\n"
23684 msgstr ""
23685
23686 #. type: textblock
23687 #: ../inspector/virt-inspector.pod:241
23688 msgid ""
23689 "The optional elements within E<lt>filesystemE<gt> are the filesystem type, "
23690 "the label, and the UUID."
23691 msgstr ""
23692
23693 #. type: =head2
23694 #: ../inspector/virt-inspector.pod:244
23695 msgid "E<lt>applicationsE<gt>"
23696 msgstr ""
23697
23698 #. type: textblock
23699 #: ../inspector/virt-inspector.pod:246
23700 msgid ""
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 "
23703 "machine."
23704 msgstr ""
23705
23706 #. type: textblock
23707 #: ../inspector/virt-inspector.pod:250
23708 msgid ""
23709 "E<lt>package_formatE<gt>, if present, describes the packaging system used.  "
23710 "Typical values would be C<rpm> and C<deb>."
23711 msgstr ""
23712
23713 #. type: textblock
23714 #: ../inspector/virt-inspector.pod:253
23715 msgid ""
23716 "E<lt>package_managementE<gt>, if present, describes the package manager.  "
23717 "Typical values include C<yum>, C<up2date> and C<apt>"
23718 msgstr ""
23719
23720 #. type: textblock
23721 #: ../inspector/virt-inspector.pod:256
23722 msgid "E<lt>applicationsE<gt> lists the packages or applications installed."
23723 msgstr ""
23724
23725 #. type: verbatim
23726 #: ../inspector/virt-inspector.pod:259
23727 #, no-wrap
23728 msgid ""
23729 " <operatingsystems>\n"
23730 "   <operatingsystem>\n"
23731 "     ...\n"
23732 "     <applications>\n"
23733 "       <application>\n"
23734 "         <name>coreutils</name>\n"
23735 "         <version>8.5</version>\n"
23736 "         <release>1</release>\n"
23737 "       </application>\n"
23738 "\n"
23739 msgstr ""
23740
23741 #. type: textblock
23742 #: ../inspector/virt-inspector.pod:269
23743 msgid ""
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>."
23747 msgstr ""
23748
23749 #. type: =head2
23750 #: ../inspector/virt-inspector.pod:273
23751 msgid "E<lt>drive_mappingsE<gt>"
23752 msgstr ""
23753
23754 #. type: textblock
23755 #: ../inspector/virt-inspector.pod:275
23756 msgid ""
23757 "For operating systems like Windows which use drive letters, virt-inspector "
23758 "is able to find out how drive letters map to filesystems."
23759 msgstr ""
23760
23761 #. type: verbatim
23762 #: ../inspector/virt-inspector.pod:279
23763 #, no-wrap
23764 msgid ""
23765 " <operatingsystems>\n"
23766 "   <operatingsystem>\n"
23767 "     ...\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"
23772 "\n"
23773 msgstr ""
23774
23775 #. type: textblock
23776 #: ../inspector/virt-inspector.pod:287
23777 msgid ""
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."
23781 msgstr ""
23782
23783 #. type: textblock
23784 #: ../inspector/virt-inspector.pod:291
23785 msgid ""
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 "
23788 "here."
23789 msgstr ""
23790
23791 #. type: =head2
23792 #: ../inspector/virt-inspector.pod:295
23793 msgid "E<lt>iconE<gt>"
23794 msgstr ""
23795
23796 #. type: textblock
23797 #: ../inspector/virt-inspector.pod:297
23798 msgid ""
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."
23802 msgstr ""
23803
23804 #. type: verbatim
23805 #: ../inspector/virt-inspector.pod:301
23806 #, no-wrap
23807 msgid ""
23808 " <operatingsystems>\n"
23809 "   <operatingsystem>\n"
23810 "     ...\n"
23811 "     <icon>\n"
23812 "       iVBORw0KGgoAAAANSUhEUgAAAGAAAABg[.......]\n"
23813 "       [... many lines of base64 data ...]\n"
23814 "     </icon>\n"
23815 "\n"
23816 msgstr ""
23817
23818 #. type: textblock
23819 #: ../inspector/virt-inspector.pod:309
23820 msgid ""
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 "
23824 "to a PNG file:"
23825 msgstr ""
23826
23827 #. type: verbatim
23828 #: ../inspector/virt-inspector.pod:314
23829 #, no-wrap
23830 msgid ""
23831 " base64 -i -d < icon.data > icon.png\n"
23832 "\n"
23833 msgstr ""
23834
23835 #. type: =head2
23836 #: ../inspector/virt-inspector.pod:316
23837 msgid "INSPECTING INSTALL DISKS, LIVE CDs"
23838 msgstr ""
23839
23840 #. type: textblock
23841 #: ../inspector/virt-inspector.pod:318
23842 msgid ""
23843 "Virt-inspector can detect some operating system installers on install disks, "
23844 "live CDs, bootable USB keys and more."
23845 msgstr ""
23846
23847 #. type: textblock
23848 #: ../inspector/virt-inspector.pod:321
23849 msgid ""
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:"
23853 msgstr ""
23854
23855 #. type: verbatim
23856 #: ../inspector/virt-inspector.pod:325
23857 #, no-wrap
23858 msgid ""
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 &quot;Maverick Meerkat&quot;</product_name>\n"
23866 "     <major_version>10</major_version>\n"
23867 "     <minor_version>10</minor_version>\n"
23868 "     <format>installer</format>\n"
23869 "     <live/>\n"
23870 "\n"
23871 msgstr ""
23872
23873 #. type: =head1
23874 #: ../inspector/virt-inspector.pod:337
23875 msgid "XPATH QUERIES"
23876 msgstr ""
23877
23878 #. type: textblock
23879 #: ../inspector/virt-inspector.pod:339
23880 msgid ""
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."
23886 msgstr ""
23887
23888 #. type: textblock
23889 #: ../inspector/virt-inspector.pod:346
23890 msgid ""
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."
23894 msgstr ""
23895
23896 #. type: verbatim
23897 #: ../inspector/virt-inspector.pod:353
23898 #, no-wrap
23899 msgid ""
23900 " $ virt-inspector -d Guest | virt-inspector --xpath '//filesystems'\n"
23901 " <filesystems>\n"
23902 "      <filesystem dev=\"/dev/vg_f13x64/lv_root\">\n"
23903 "        <type>ext4</type>\n"
23904 " [...]\n"
23905 "\n"
23906 msgstr ""
23907
23908 #. type: verbatim
23909 #: ../inspector/virt-inspector.pod:359
23910 #, no-wrap
23911 msgid ""
23912 " $ virt-inspector -d Guest | \\\n"
23913 "     virt-inspector --xpath \"string(//filesystem[@dev='/dev/sda1']/type)\"\n"
23914 " ext4\n"
23915 "\n"
23916 msgstr ""
23917
23918 #. type: verbatim
23919 #: ../inspector/virt-inspector.pod:363
23920 #, no-wrap
23921 msgid ""
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"
23925 "\n"
23926 msgstr ""
23927
23928 #. type: =head1
23929 #: ../inspector/virt-inspector.pod:374
23930 msgid "OLD VERSIONS OF VIRT-INSPECTOR"
23931 msgstr ""
23932
23933 #. type: textblock
23934 #: ../inspector/virt-inspector.pod:376
23935 msgid ""
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."
23940 msgstr ""
23941
23942 #. type: textblock
23943 #: ../inspector/virt-inspector.pod:381
23944 msgid ""
23945 "The old virt-inspector is no longer supported or shipped with libguestfs."
23946 msgstr ""
23947
23948 #. type: textblock
23949 #: ../inspector/virt-inspector.pod:384
23950 msgid ""
23951 "To confuse matters further, in Red Hat Enterprise Linux 6 we ship two "
23952 "versions of virt-inspector with different names:"
23953 msgstr ""
23954
23955 #. type: verbatim
23956 #: ../inspector/virt-inspector.pod:387
23957 #, no-wrap
23958 msgid ""
23959 " virt-inspector     Old Perl version.\n"
23960 " virt-inspector2    New C version.\n"
23961 "\n"
23962 msgstr ""
23963
23964 #. type: textblock
23965 #: ../inspector/virt-inspector.pod:397
23966 msgid ""
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/>."
23969 msgstr ""
23970
23971 #. type: textblock
23972 #: ../inspector/virt-inspector.pod:414
23973 msgid "Matthew Booth L<mbooth@redhat.com>"
23974 msgstr ""
23975
23976 #. type: textblock
23977 #: ../java/examples/guestfs-java.pod:5
23978 msgid "guestfs-java - How to use libguestfs from Java"
23979 msgstr ""
23980
23981 #. type: verbatim
23982 #: ../java/examples/guestfs-java.pod:9
23983 #, no-wrap
23984 msgid ""
23985 " import com.redhat.et.libguestfs.*;\n"
23986 " \n"
23987 msgstr ""
23988
23989 #. type: verbatim
23990 #: ../java/examples/guestfs-java.pod:11
23991 #, no-wrap
23992 msgid ""
23993 " GuestFS g = new GuestFS ();\n"
23994 " g.add_drive_opts (\"disk.img\", null);\n"
23995 " g.launch ();\n"
23996 "\n"
23997 msgstr ""
23998
23999 #. type: textblock
24000 #: ../java/examples/guestfs-java.pod:17
24001 msgid ""
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)>."
24006 msgstr ""
24007
24008 #. type: =head2
24009 #: ../java/examples/guestfs-java.pod:22 ../ocaml/examples/guestfs-ocaml.pod:53
24010 msgid "CLOSING THE HANDLE"
24011 msgstr ""
24012
24013 #. type: textblock
24014 #: ../java/examples/guestfs-java.pod:24
24015 msgid ""
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."
24019 msgstr ""
24020
24021 #. type: =head2
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
24025 msgid "EXCEPTIONS"
24026 msgstr "ВИНЯТКИ"
24027
24028 #. type: textblock
24029 #: ../java/examples/guestfs-java.pod:31
24030 msgid ""
24031 "Errors from libguestfs functions are mapped into the C<LibGuestFSException> "
24032 "exception.  This has a single parameter which is the error message (a "
24033 "C<String>)."
24034 msgstr ""
24035
24036 #. type: textblock
24037 #: ../java/examples/guestfs-java.pod:35
24038 msgid "Calling any method on a closed handle raises the same exception."
24039 msgstr ""
24040
24041 #. type: textblock
24042 #: ../java/examples/guestfs-java.pod:47
24043 msgid ""
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/>."
24047 msgstr ""
24048
24049 #. type: textblock
24050 #: ../ocaml/examples/guestfs-ocaml.pod:5
24051 msgid "guestfs-ocaml - How to use libguestfs from OCaml"
24052 msgstr ""
24053
24054 #. type: textblock
24055 #: ../ocaml/examples/guestfs-ocaml.pod:9
24056 msgid "Module style:"
24057 msgstr ""
24058
24059 #. type: verbatim
24060 #: ../ocaml/examples/guestfs-ocaml.pod:11
24061 #, no-wrap
24062 msgid ""
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"
24066 "\n"
24067 msgstr ""
24068
24069 #. type: textblock
24070 #: ../ocaml/examples/guestfs-ocaml.pod:15
24071 msgid "Object-oriented style:"
24072 msgstr ""
24073
24074 #. type: verbatim
24075 #: ../ocaml/examples/guestfs-ocaml.pod:17
24076 #, no-wrap
24077 msgid ""
24078 " let g = new Guestfs.guestfs () in\n"
24079 " g#add_drive_opts ~format:\"raw\" ~readonly:true \"disk.img\";\n"
24080 " g#launch ();\n"
24081 "\n"
24082 msgstr ""
24083
24084 #. type: verbatim
24085 #: ../ocaml/examples/guestfs-ocaml.pod:21
24086 #, no-wrap
24087 msgid ""
24088 " ocamlfind opt prog.ml -package guestfs -linkpkg -o prog\n"
24089 "or:\n"
24090 " ocamlopt -I +guestfs mlguestfs.cmxa prog.ml -o prog\n"
24091 "\n"
24092 msgstr ""
24093
24094 #. type: textblock
24095 #: ../ocaml/examples/guestfs-ocaml.pod:27
24096 msgid ""
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)>."
24101 msgstr ""
24102
24103 #. type: =head2
24104 #: ../ocaml/examples/guestfs-ocaml.pod:32
24105 msgid "PROGRAMMING STYLES"
24106 msgstr ""
24107
24108 #. type: textblock
24109 #: ../ocaml/examples/guestfs-ocaml.pod:34
24110 msgid ""
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:"
24113 msgstr ""
24114
24115 #. type: verbatim
24116 #: ../ocaml/examples/guestfs-ocaml.pod:38
24117 #, no-wrap
24118 msgid ""
24119 " int guestfs_set_verbose (guestfs_h *g, int flag);\n"
24120 "\n"
24121 msgstr ""
24122
24123 #. type: textblock
24124 #: ../ocaml/examples/guestfs-ocaml.pod:40
24125 msgid "becomes:"
24126 msgstr ""
24127
24128 #. type: verbatim
24129 #: ../ocaml/examples/guestfs-ocaml.pod:42
24130 #, no-wrap
24131 msgid ""
24132 " val Guestfs.set_verbose : Guestfs.t -> bool -> unit\n"
24133 "\n"
24134 msgstr ""
24135
24136 #. type: textblock
24137 #: ../ocaml/examples/guestfs-ocaml.pod:44
24138 msgid ""
24139 "Alternately you can use an object-oriented style, calling methods on the "
24140 "class C<Guestfs.guestfs>:"
24141 msgstr ""
24142
24143 #. type: verbatim
24144 #: ../ocaml/examples/guestfs-ocaml.pod:47
24145 #, no-wrap
24146 msgid ""
24147 " method set_verbose : bool -> unit\n"
24148 "\n"
24149 msgstr ""
24150
24151 #. type: textblock
24152 #: ../ocaml/examples/guestfs-ocaml.pod:49
24153 msgid ""
24154 "The object-oriented style is usually briefer, and the minor performance "
24155 "penalty isn't noticable in the general overhead of performing libguestfs "
24156 "functions."
24157 msgstr ""
24158
24159 #. type: textblock
24160 #: ../ocaml/examples/guestfs-ocaml.pod:55
24161 msgid ""
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> "
24165 "method."
24166 msgstr ""
24167
24168 #. type: textblock
24169 #: ../ocaml/examples/guestfs-ocaml.pod:62
24170 msgid ""
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 "
24173 "string)."
24174 msgstr ""
24175
24176 #. type: textblock
24177 #: ../ocaml/examples/guestfs-ocaml.pod:66
24178 msgid ""
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 "
24181 "called."
24182 msgstr ""
24183
24184 #. type: textblock
24185 #: ../ocaml/examples/guestfs-ocaml.pod:80
24186 msgid ""
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/>."
24190 msgstr ""
24191
24192 #. type: textblock
24193 #: ../perl/examples/guestfs-perl.pod:5
24194 msgid "guestfs-perl - How to use libguestfs from Perl"
24195 msgstr ""
24196
24197 #. type: verbatim
24198 #: ../perl/examples/guestfs-perl.pod:9
24199 #, no-wrap
24200 msgid ""
24201 " use Sys::Guestfs;\n"
24202 " \n"
24203 msgstr ""
24204
24205 #. type: verbatim
24206 #: ../perl/examples/guestfs-perl.pod:11
24207 #, no-wrap
24208 msgid ""
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"
24214 " $h->sync ();\n"
24215 "\n"
24216 msgstr ""
24217
24218 #. type: textblock
24219 #: ../perl/examples/guestfs-perl.pod:20
24220 msgid ""
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)>."
24225 msgstr ""
24226
24227 #. type: =head2
24228 #: ../perl/examples/guestfs-perl.pod:26
24229 msgid "ERRORS"
24230 msgstr "ПОМИЛКИ"
24231
24232 #. type: textblock
24233 #: ../perl/examples/guestfs-perl.pod:28
24234 msgid ""
24235 "Errors from libguestfs functions turn into calls to C<croak> (see L<Carp(3)"
24236 ">)."
24237 msgstr ""
24238
24239 #. type: textblock
24240 #: ../perl/examples/guestfs-perl.pod:41
24241 msgid ""
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/>."
24245 msgstr ""
24246
24247 #. type: textblock
24248 #: ../python/examples/guestfs-python.pod:5
24249 msgid "guestfs-python - How to use libguestfs from Python"
24250 msgstr ""
24251
24252 #. type: verbatim
24253 #: ../python/examples/guestfs-python.pod:9
24254 #, no-wrap
24255 msgid ""
24256 " import guestfs\n"
24257 " g = guestfs.GuestFS ()\n"
24258 " g.add_drive_opts (\"disk.img\", format=\"raw\", readonly=1)\n"
24259 " g.launch\n"
24260 "\n"
24261 msgstr ""
24262
24263 #. type: textblock
24264 #: ../python/examples/guestfs-python.pod:16
24265 msgid ""
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)>."
24270 msgstr ""
24271
24272 #. type: textblock
24273 #: ../python/examples/guestfs-python.pod:23
24274 msgid ""
24275 "Errors from libguestfs functions are mapped into C<RuntimeException> with a "
24276 "single string argument which is the error message."
24277 msgstr ""
24278
24279 #. type: =head2
24280 #: ../python/examples/guestfs-python.pod:26
24281 msgid "MORE DOCUMENTATION"
24282 msgstr ""
24283
24284 #. type: textblock
24285 #: ../python/examples/guestfs-python.pod:28
24286 msgid "Type:"
24287 msgstr "Тип:"
24288
24289 #. type: verbatim
24290 #: ../python/examples/guestfs-python.pod:30
24291 #, no-wrap
24292 msgid ""
24293 " $ python\n"
24294 " >>> import guestfs\n"
24295 " >>> help (guestfs)\n"
24296 "\n"
24297 msgstr ""
24298
24299 #. type: textblock
24300 #: ../python/examples/guestfs-python.pod:44
24301 msgid ""
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/>."
24305 msgstr ""
24306
24307 #. type: textblock
24308 #: ../rescue/virt-rescue.pod:5
24309 msgid "virt-rescue - Run a rescue shell on a virtual machine"
24310 msgstr ""
24311
24312 #. type: verbatim
24313 #: ../rescue/virt-rescue.pod:9
24314 #, no-wrap
24315 msgid ""
24316 " virt-rescue [--options] -d domname\n"
24317 "\n"
24318 msgstr ""
24319
24320 #. type: verbatim
24321 #: ../rescue/virt-rescue.pod:11
24322 #, no-wrap
24323 msgid ""
24324 " virt-rescue [--options] -a disk.img [-a disk.img ...]\n"
24325 "\n"
24326 msgstr ""
24327
24328 #. type: verbatim
24329 #: ../rescue/virt-rescue.pod:13
24330 #, fuzzy, no-wrap
24331 #| msgid ""
24332 #| " virt-filesystems --format=raw -a disk.img\n"
24333 #| "\n"
24334 msgid ""
24335 " virt-rescue --suggest (-d domname | -a disk.img ...)\n"
24336 "\n"
24337 msgstr ""
24338 " virt-filesystems --format=raw -a диск.img\n"
24339 "\n"
24340
24341 #. type: verbatim
24342 #: ../rescue/virt-rescue.pod:17
24343 #, no-wrap
24344 msgid ""
24345 " virt-rescue [--options] domname\n"
24346 "\n"
24347 msgstr ""
24348
24349 #. type: verbatim
24350 #: ../rescue/virt-rescue.pod:19
24351 #, no-wrap
24352 msgid ""
24353 " virt-rescue [--options] disk.img [disk.img ...]\n"
24354 "\n"
24355 msgstr ""
24356
24357 #. type: textblock
24358 #: ../rescue/virt-rescue.pod:23
24359 msgid ""
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."
24363 msgstr ""
24364
24365 #. type: textblock
24366 #: ../rescue/virt-rescue.pod:27
24367 msgid ""
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."
24371 msgstr ""
24372
24373 #. type: textblock
24374 #: ../rescue/virt-rescue.pod:33
24375 msgid ""
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 "
24379 "disk image."
24380 msgstr ""
24381
24382 #. type: textblock
24383 #: ../rescue/virt-rescue.pod:38
24384 msgid ""
24385 "You can run virt-rescue on any virtual machine known to libvirt, or directly "
24386 "on disk image(s):"
24387 msgstr ""
24388
24389 #. type: verbatim
24390 #: ../rescue/virt-rescue.pod:41
24391 #, no-wrap
24392 msgid ""
24393 " virt-rescue -d GuestName\n"
24394 "\n"
24395 msgstr ""
24396
24397 #. type: verbatim
24398 #: ../rescue/virt-rescue.pod:43
24399 #, no-wrap
24400 msgid ""
24401 " virt-rescue --ro -a /path/to/disk.img\n"
24402 "\n"
24403 msgstr ""
24404
24405 #. type: verbatim
24406 #: ../rescue/virt-rescue.pod:45
24407 #, no-wrap
24408 msgid ""
24409 " virt-rescue -a /dev/sdc\n"
24410 "\n"
24411 msgstr ""
24412
24413 #. type: textblock
24414 #: ../rescue/virt-rescue.pod:47
24415 msgid "For live VMs you I<must> use the --ro option."
24416 msgstr ""
24417
24418 #. type: textblock
24419 #: ../rescue/virt-rescue.pod:49
24420 msgid ""
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."
24426 msgstr ""
24427
24428 #. type: textblock
24429 #: ../rescue/virt-rescue.pod:56
24430 msgid ""
24431 "You can get virt-rescue to suggest mount commands for you by using the I<--"
24432 "suggest> option (in another terminal):"
24433 msgstr ""
24434
24435 #. type: verbatim
24436 #: ../rescue/virt-rescue.pod:59
24437 #, no-wrap
24438 msgid ""
24439 " $ virt-rescue --suggest -d Fedora15\n"
24440 " Inspecting the virtual machine or disk image ...\n"
24441 " \n"
24442 msgstr ""
24443
24444 #. type: verbatim
24445 #: ../rescue/virt-rescue.pod:62
24446 #, no-wrap
24447 msgid ""
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"
24450 " filesystems.\n"
24451 " \n"
24452 msgstr ""
24453
24454 #. type: verbatim
24455 #: ../rescue/virt-rescue.pod:66
24456 #, no-wrap
24457 msgid ""
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"
24461 " \n"
24462 msgstr ""
24463
24464 #. type: verbatim
24465 #: ../rescue/virt-rescue.pod:70
24466 #, no-wrap
24467 msgid ""
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"
24474 "\n"
24475 msgstr ""
24476
24477 #. type: textblock
24478 #: ../rescue/virt-rescue.pod:77
24479 msgid ""
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:"
24482 msgstr ""
24483
24484 #. type: verbatim
24485 #: ../rescue/virt-rescue.pod:80
24486 #, no-wrap
24487 msgid ""
24488 " ><rescue> lvs\n"
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"
24495 "\n"
24496 msgstr ""
24497
24498 #. type: textblock
24499 #: ../rescue/virt-rescue.pod:88
24500 msgid ""
24501 "Another command to list available filesystems is L<virt-filesystems(1)>."
24502 msgstr ""
24503
24504 #. type: textblock
24505 #: ../rescue/virt-rescue.pod:91
24506 msgid ""
24507 "To run commands in a Linux guest (for example, grub), you should chroot into "
24508 "the /sysroot directory first:"
24509 msgstr ""
24510
24511 #. type: verbatim
24512 #: ../rescue/virt-rescue.pod:94
24513 #, no-wrap
24514 msgid ""
24515 " ><rescue> chroot /sysroot\n"
24516 "\n"
24517 msgstr ""
24518
24519 #. type: textblock
24520 #: ../rescue/virt-rescue.pod:98
24521 msgid ""
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."
24527 msgstr ""
24528
24529 #. type: textblock
24530 #: ../rescue/virt-rescue.pod:104
24531 msgid ""
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."
24534 msgstr ""
24535
24536 #. type: textblock
24537 #: ../rescue/virt-rescue.pod:107
24538 msgid ""
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)>."
24543 msgstr ""
24544
24545 #. type: =item
24546 #: ../rescue/virt-rescue.pod:131
24547 msgid "B<--append kernelopts>"
24548 msgstr "B<--append параметри_ядра>"
24549
24550 #. type: textblock
24551 #: ../rescue/virt-rescue.pod:133
24552 msgid "Pass additional options to the rescue kernel."
24553 msgstr ""
24554
24555 #. type: verbatim
24556 #: ../rescue/virt-rescue.pod:163
24557 #, no-wrap
24558 msgid ""
24559 " virt-rescue --format=raw -a disk.img\n"
24560 "\n"
24561 msgstr ""
24562
24563 #. type: verbatim
24564 #: ../rescue/virt-rescue.pod:167
24565 #, no-wrap
24566 msgid ""
24567 " virt-rescue --format=raw -a disk.img --format -a another.img\n"
24568 "\n"
24569 msgstr ""
24570
24571 #. type: =item
24572 #: ../rescue/virt-rescue.pod:176
24573 msgid "B<-m MB>"
24574 msgstr "B<-m МБ>"
24575
24576 #. type: =item
24577 #: ../rescue/virt-rescue.pod:178
24578 msgid "B<--memsize MB>"
24579 msgstr "B<--memsize МБ>"
24580
24581 #. type: textblock
24582 #: ../rescue/virt-rescue.pod:180
24583 msgid ""
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 "
24587 "megabytes."
24588 msgstr ""
24589
24590 #. type: =item
24591 #: ../rescue/virt-rescue.pod:185
24592 msgid "B<--network>"
24593 msgstr "B<--network>"
24594
24595 #. type: textblock
24596 #: ../rescue/virt-rescue.pod:187
24597 msgid "Enable QEMU user networking in the guest.  See L</NETWORK>."
24598 msgstr ""
24599
24600 #. type: textblock
24601 #: ../rescue/virt-rescue.pod:193
24602 msgid "Open the image read-only."
24603 msgstr ""
24604
24605 #. type: textblock
24606 #: ../rescue/virt-rescue.pod:203
24607 msgid ""
24608 "Enable SELinux in the rescue appliance.  You should read L<guestfs(3)/"
24609 "SELINUX> before using this option."
24610 msgstr ""
24611
24612 #. type: =item
24613 #: ../rescue/virt-rescue.pod:206
24614 msgid "B<--smp> N"
24615 msgstr ""
24616
24617 #. type: textblock
24618 #: ../rescue/virt-rescue.pod:208
24619 msgid "Enable N E<ge> 2 virtual CPUs in the rescue appliance."
24620 msgstr ""
24621
24622 #. type: =item
24623 #: ../rescue/virt-rescue.pod:210
24624 #, fuzzy
24625 #| msgid "B<--quiet>"
24626 msgid "B<--suggest>"
24627 msgstr "B<--quiet>"
24628
24629 #. type: textblock
24630 #: ../rescue/virt-rescue.pod:212
24631 msgid ""
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."
24635 msgstr ""
24636
24637 #. type: textblock
24638 #: ../rescue/virt-rescue.pod:216
24639 msgid ""
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."
24642 msgstr ""
24643
24644 #. type: textblock
24645 #: ../rescue/virt-rescue.pod:235
24646 msgid ""
24647 "This changes the I<-a> and I<-d> options so that disks are added and mounts "
24648 "are done read-write."
24649 msgstr ""
24650
24651 #. type: textblock
24652 #: ../rescue/virt-rescue.pod:248
24653 msgid "Previous versions of virt-rescue allowed you to write either:"
24654 msgstr ""
24655
24656 #. type: verbatim
24657 #: ../rescue/virt-rescue.pod:250
24658 #, no-wrap
24659 msgid ""
24660 " virt-rescue disk.img [disk.img ...]\n"
24661 "\n"
24662 msgstr ""
24663
24664 #. type: verbatim
24665 #: ../rescue/virt-rescue.pod:254
24666 #, no-wrap
24667 msgid ""
24668 " virt-rescue guestname\n"
24669 "\n"
24670 msgstr ""
24671
24672 #. type: =head1
24673 #: ../rescue/virt-rescue.pod:262
24674 msgid "NETWORK"
24675 msgstr "МЕРЕЖА"
24676
24677 #. type: textblock
24678 #: ../rescue/virt-rescue.pod:264
24679 msgid ""
24680 "Adding the I<--network> option enables QEMU user networking in the rescue "
24681 "appliance.  There are some differences between user networking and ordinary "
24682 "networking:"
24683 msgstr ""
24684
24685 #. type: =item
24686 #: ../rescue/virt-rescue.pod:270
24687 msgid "ping does not work"
24688 msgstr ""
24689
24690 #. type: textblock
24691 #: ../rescue/virt-rescue.pod:272
24692 msgid ""
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 "
24698 "working."
24699 msgstr ""
24700
24701 #. type: =item
24702 #: ../rescue/virt-rescue.pod:279
24703 msgid "cannot receive connections"
24704 msgstr ""
24705
24706 #. type: textblock
24707 #: ../rescue/virt-rescue.pod:281
24708 msgid "QEMU user networking cannot receive incoming connections."
24709 msgstr ""
24710
24711 #. type: =item
24712 #: ../rescue/virt-rescue.pod:283
24713 msgid "making TCP connections"
24714 msgstr ""
24715
24716 #. type: textblock
24717 #: ../rescue/virt-rescue.pod:285
24718 msgid ""
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:"
24723 msgstr ""
24724
24725 #. type: verbatim
24726 #: ../rescue/virt-rescue.pod:290
24727 #, no-wrap
24728 msgid ""
24729 " exec 3<>/dev/tcp/redhat.com/80\n"
24730 " echo \"GET /\" >&3\n"
24731 " cat <&3\n"
24732 "\n"
24733 msgstr ""
24734
24735 #. type: textblock
24736 #: ../rescue/virt-rescue.pod:294
24737 msgid "See L<bash(1)> for more details."
24738 msgstr ""
24739
24740 #. type: textblock
24741 #: ../rescue/virt-rescue.pod:300
24742 msgid ""
24743 "Several environment variables affect virt-rescue.  See L<guestfs(3)/"
24744 "ENVIRONMENT VARIABLES> for the complete list."
24745 msgstr ""
24746
24747 #. type: textblock
24748 #: ../rescue/virt-rescue.pod:327
24749 #, fuzzy
24750 #| msgid ""
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/>."
24753 msgid ""
24754 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-"
24755 "filesystems(1)>, L<http://libguestfs.org/>."
24756 msgstr ""
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/>."
24759
24760 #. type: textblock
24761 #: ../resize/virt-resize.pod:5
24762 msgid "virt-resize - Resize a virtual machine disk"
24763 msgstr ""
24764
24765 #. type: verbatim
24766 #: ../resize/virt-resize.pod:9
24767 #, no-wrap
24768 msgid ""
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"
24772 "\n"
24773 msgstr ""
24774
24775 #. type: textblock
24776 #: ../resize/virt-resize.pod:15
24777 msgid ""
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 "
24780 "within."
24781 msgstr ""
24782
24783 #. type: textblock
24784 #: ../resize/virt-resize.pod:19
24785 msgid ""
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."
24789 msgstr ""
24790
24791 #. type: textblock
24792 #: ../resize/virt-resize.pod:23
24793 msgid ""
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."
24796 msgstr ""
24797
24798 #. type: =item
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
24802 msgid "1."
24803 msgstr "1."
24804
24805 #. type: textblock
24806 #: ../resize/virt-resize.pod:33
24807 msgid ""
24808 "Copy C<olddisk> to C<newdisk>, extending one of the guest's partitions to "
24809 "fill the extra 5GB of space."
24810 msgstr ""
24811
24812 #. type: verbatim
24813 #: ../resize/virt-resize.pod:36
24814 #, no-wrap
24815 msgid ""
24816 " virt-filesystems --long -h --all -a olddisk\n"
24817 " \n"
24818 msgstr ""
24819
24820 #. type: verbatim
24821 #: ../resize/virt-resize.pod:38
24822 #, no-wrap
24823 msgid ""
24824 " truncate -r olddisk newdisk\n"
24825 " truncate -s +5G newdisk\n"
24826 " \n"
24827 msgstr ""
24828
24829 #. type: verbatim
24830 #: ../resize/virt-resize.pod:41
24831 #, no-wrap
24832 msgid ""
24833 " # Note \"/dev/sda2\" is a partition inside the \"olddisk\" file.\n"
24834 " virt-resize --expand /dev/sda2 olddisk newdisk\n"
24835 "\n"
24836 msgstr ""
24837
24838 #. type: =item
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
24842 msgid "2."
24843 msgstr "2."
24844
24845 #. type: textblock
24846 #: ../resize/virt-resize.pod:46
24847 msgid ""
24848 "As above, but make the /boot partition 200MB bigger, while giving the "
24849 "remaining space to /dev/sda2:"
24850 msgstr ""
24851
24852 #. type: verbatim
24853 #: ../resize/virt-resize.pod:49
24854 #, no-wrap
24855 msgid ""
24856 " virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 \\\n"
24857 "   olddisk newdisk\n"
24858 "\n"
24859 msgstr ""
24860
24861 #. type: =item
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
24865 msgid "3."
24866 msgstr "3."
24867
24868 #. type: textblock
24869 #: ../resize/virt-resize.pod:54
24870 msgid ""
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:"
24873 msgstr ""
24874
24875 #. type: verbatim
24876 #: ../resize/virt-resize.pod:58
24877 #, no-wrap
24878 msgid ""
24879 " virt-resize --expand /dev/sda2 --LV-expand /dev/vg_guest/lv_root \\\n"
24880 "   olddisk newdisk\n"
24881 "\n"
24882 msgstr ""
24883
24884 #. type: =item
24885 #: ../resize/virt-resize.pod:61
24886 msgid "4."
24887 msgstr ""
24888
24889 #. type: textblock
24890 #: ../resize/virt-resize.pod:63
24891 msgid ""
24892 "As in the first example, but the output format will be qcow2 instead of a "
24893 "raw disk:"
24894 msgstr ""
24895
24896 #. type: verbatim
24897 #: ../resize/virt-resize.pod:66
24898 #, no-wrap
24899 msgid ""
24900 " qemu-img create -f qcow2 newdisk.qcow2 15G\n"
24901 " virt-resize --expand /dev/sda2 olddisk newdisk.qcow2\n"
24902 "\n"
24903 msgstr ""
24904
24905 #. type: =head1
24906 #: ../resize/virt-resize.pod:71
24907 msgid "DETAILED USAGE"
24908 msgstr "ДОКЛАДНІШЕ ЩОДО ВИКОРИСТАННЯ"
24909
24910 #. type: =head2
24911 #: ../resize/virt-resize.pod:73
24912 msgid "EXPANDING A VIRTUAL MACHINE DISK"
24913 msgstr "РОЗШИРЕННЯ ДИСКА ВІРТУАЛЬНОЇ МАШИНИ"
24914
24915 #. type: =item
24916 #: ../resize/virt-resize.pod:77
24917 msgid "1. Shut down the virtual machine"
24918 msgstr ""
24919
24920 #. type: =item
24921 #: ../resize/virt-resize.pod:79
24922 msgid "2. Locate input disk image"
24923 msgstr ""
24924
24925 #. type: textblock
24926 #: ../resize/virt-resize.pod:81
24927 msgid ""
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:"
24931 msgstr ""
24932
24933 #. type: verbatim
24934 #: ../resize/virt-resize.pod:85
24935 #, no-wrap
24936 msgid ""
24937 " # virsh dumpxml guestname | xpath /domain/devices/disk/source\n"
24938 " Found 1 nodes:\n"
24939 " -- NODE --\n"
24940 " <source dev=\"/dev/vg/lv_guest\" />\n"
24941 "\n"
24942 msgstr ""
24943
24944 #. type: =item
24945 #: ../resize/virt-resize.pod:90
24946 msgid "3. Look at current sizing"
24947 msgstr ""
24948
24949 #. type: textblock
24950 #: ../resize/virt-resize.pod:92
24951 msgid "Use L<virt-filesystems(1)> to display the current partitions and sizes:"
24952 msgstr ""
24953
24954 #. type: verbatim
24955 #: ../resize/virt-resize.pod:95
24956 #, no-wrap
24957 msgid ""
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"
24963 "\n"
24964 msgstr ""
24965
24966 #. type: textblock
24967 #: ../resize/virt-resize.pod:101
24968 msgid ""
24969 "(This example is a virtual machine with an 8 GB disk which we would like to "
24970 "expand up to 10 GB)."
24971 msgstr ""
24972
24973 #. type: =item
24974 #: ../resize/virt-resize.pod:104
24975 msgid "4. Create output disk"
24976 msgstr ""
24977
24978 #. type: textblock
24979 #: ../resize/virt-resize.pod:106
24980 msgid ""
24981 "Virt-resize cannot do in-place disk modifications.  You have to have space "
24982 "to store the resized output disk."
24983 msgstr ""
24984
24985 #. type: textblock
24986 #: ../resize/virt-resize.pod:109
24987 msgid ""
24988 "To store the resized disk image in a file, create a file of a suitable size:"
24989 msgstr ""
24990
24991 #. type: verbatim
24992 #: ../resize/virt-resize.pod:112
24993 #, no-wrap
24994 msgid ""
24995 " # rm -f outdisk\n"
24996 " # truncate -s 10G outdisk\n"
24997 "\n"
24998 msgstr ""
24999
25000 #. type: textblock
25001 #: ../resize/virt-resize.pod:115
25002 msgid "Or use L<lvcreate(1)> to create a logical volume:"
25003 msgstr ""
25004
25005 #. type: verbatim
25006 #: ../resize/virt-resize.pod:117
25007 #, no-wrap
25008 msgid ""
25009 " # lvcreate -L 10G -n lv_name vg_name\n"
25010 "\n"
25011 msgstr ""
25012
25013 #. type: textblock
25014 #: ../resize/virt-resize.pod:119
25015 msgid "Or use L<virsh(1)> vol-create-as to create a libvirt storage volume:"
25016 msgstr ""
25017
25018 #. type: verbatim
25019 #: ../resize/virt-resize.pod:121
25020 #, no-wrap
25021 msgid ""
25022 " # virsh pool-list\n"
25023 " # virsh vol-create-as poolname newvol 10G\n"
25024 "\n"
25025 msgstr ""
25026
25027 #. type: =item
25028 #: ../resize/virt-resize.pod:124
25029 msgid "5. Resize"
25030 msgstr "5. Зміна розміру"
25031
25032 #. type: textblock
25033 #: ../resize/virt-resize.pod:126
25034 msgid ""
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 "
25037 "previous step."
25038 msgstr ""
25039
25040 #. type: verbatim
25041 #: ../resize/virt-resize.pod:130
25042 #, no-wrap
25043 msgid ""
25044 " # virt-resize indisk outdisk\n"
25045 "\n"
25046 msgstr ""
25047
25048 #. type: textblock
25049 #: ../resize/virt-resize.pod:132
25050 msgid ""
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 "
25055 "error."
25056 msgstr ""
25057
25058 #. type: textblock
25059 #: ../resize/virt-resize.pod:138
25060 msgid ""
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> "
25063 "section below)."
25064 msgstr ""
25065
25066 #. type: textblock
25067 #: ../resize/virt-resize.pod:142
25068 msgid ""
25069 "L</--expand> is the most useful option.  It expands the named partition "
25070 "within the disk to fill any extra space:"
25071 msgstr ""
25072
25073 #. type: verbatim
25074 #: ../resize/virt-resize.pod:145
25075 #, no-wrap
25076 msgid ""
25077 " # virt-resize --expand /dev/sda2 indisk outdisk\n"
25078 "\n"
25079 msgstr ""
25080
25081 #. type: textblock
25082 #: ../resize/virt-resize.pod:147
25083 msgid ""
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)."
25086 msgstr ""
25087
25088 #. type: textblock
25089 #: ../resize/virt-resize.pod:150
25090 msgid ""
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:"
25094 msgstr ""
25095
25096 #. type: verbatim
25097 #: ../resize/virt-resize.pod:154
25098 #, no-wrap
25099 msgid ""
25100 " # virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 \\\n"
25101 "     indisk outdisk\n"
25102 "\n"
25103 msgstr ""
25104
25105 #. type: textblock
25106 #: ../resize/virt-resize.pod:157
25107 msgid ""
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."
25113 msgstr ""
25114
25115 #. type: textblock
25116 #: ../resize/virt-resize.pod:164
25117 msgid "Other options are covered below."
25118 msgstr ""
25119
25120 #. type: =item
25121 #: ../resize/virt-resize.pod:166
25122 msgid "6. Test"
25123 msgstr "6. Перевірка"
25124
25125 #. type: textblock
25126 #: ../resize/virt-resize.pod:168
25127 msgid "Thoroughly test the new disk image I<before> discarding the old one."
25128 msgstr ""
25129
25130 #. type: textblock
25131 #: ../resize/virt-resize.pod:170
25132 msgid "If you are using libvirt, edit the XML to point at the new disk:"
25133 msgstr ""
25134
25135 #. type: verbatim
25136 #: ../resize/virt-resize.pod:172
25137 #, no-wrap
25138 msgid ""
25139 " # virsh edit guestname\n"
25140 "\n"
25141 msgstr ""
25142
25143 #. type: textblock
25144 #: ../resize/virt-resize.pod:174
25145 msgid ""
25146 "Change E<lt>source ...E<gt>, see L<http://libvirt.org/formatdomain."
25147 "html#elementsDisks>"
25148 msgstr ""
25149
25150 #. type: textblock
25151 #: ../resize/virt-resize.pod:177
25152 msgid "Then start up the domain with the new, resized disk:"
25153 msgstr ""
25154
25155 #. type: verbatim
25156 #: ../resize/virt-resize.pod:179
25157 #, no-wrap
25158 msgid ""
25159 " # virsh start guestname\n"
25160 "\n"
25161 msgstr ""
25162
25163 #. type: textblock
25164 #: ../resize/virt-resize.pod:181
25165 msgid ""
25166 "and check that it still works.  See also the L</NOTES> section below for "
25167 "additional information."
25168 msgstr ""
25169
25170 #. type: =item
25171 #: ../resize/virt-resize.pod:184
25172 msgid "7. Resize LVs etc inside the guest"
25173 msgstr ""
25174
25175 #. type: textblock
25176 #: ../resize/virt-resize.pod:186
25177 msgid "(This can also be done offline using L<guestfish(1)>)"
25178 msgstr ""
25179
25180 #. type: textblock
25181 #: ../resize/virt-resize.pod:188
25182 msgid ""
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."
25187 msgstr ""
25188
25189 #. type: =head2
25190 #: ../resize/virt-resize.pod:195
25191 msgid "SHRINKING A VIRTUAL MACHINE DISK"
25192 msgstr ""
25193
25194 #. type: textblock
25195 #: ../resize/virt-resize.pod:197
25196 msgid ""
25197 "Shrinking is somewhat more complex than expanding, and only an overview is "
25198 "given here."
25199 msgstr ""
25200
25201 #. type: textblock
25202 #: ../resize/virt-resize.pod:200
25203 msgid ""
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 "
25207 "properly."
25208 msgstr ""
25209
25210 #. type: textblock
25211 #: ../resize/virt-resize.pod:205
25212 msgid "(Shrinking can also be done offline using L<guestfish(1)>)"
25213 msgstr ""
25214
25215 #. type: textblock
25216 #: ../resize/virt-resize.pod:207
25217 msgid ""
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."
25220 msgstr ""
25221
25222 #. type: textblock
25223 #: ../resize/virt-resize.pod:210
25224 msgid ""
25225 "Then run virt-resize with any of the I<--shrink> and/or I<--resize> options."
25226 msgstr ""
25227
25228 #. type: =head2
25229 #: ../resize/virt-resize.pod:213
25230 msgid "IGNORING OR DELETING PARTITIONS"
25231 msgstr ""
25232
25233 #. type: textblock
25234 #: ../resize/virt-resize.pod:215
25235 msgid ""
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."
25242 msgstr ""
25243
25244 #. type: =head2
25245 #: ../resize/virt-resize.pod:222
25246 msgid "QCOW2 AND NON-SPARSE RAW FORMATS"
25247 msgstr ""
25248
25249 #. type: textblock
25250 #: ../resize/virt-resize.pod:224
25251 msgid ""
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:"
25256 msgstr ""
25257
25258 #. type: verbatim
25259 #: ../resize/virt-resize.pod:230
25260 #, no-wrap
25261 msgid ""
25262 " qemu-img create [-c] -f qcow2 outdisk [size]\n"
25263 "\n"
25264 msgstr ""
25265
25266 #. type: textblock
25267 #: ../resize/virt-resize.pod:232
25268 msgid "instead of the truncate command (use I<-c> for a compressed disk)."
25269 msgstr ""
25270
25271 #. type: textblock
25272 #: ../resize/virt-resize.pod:234
25273 msgid "Similarly, to get non-sparse raw output use:"
25274 msgstr ""
25275
25276 #. type: verbatim
25277 #: ../resize/virt-resize.pod:236
25278 #, no-wrap
25279 msgid ""
25280 " fallocate -l size outdisk\n"
25281 "\n"
25282 msgstr ""
25283
25284 #. type: textblock
25285 #: ../resize/virt-resize.pod:238
25286 msgid ""
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=..>)"
25289 msgstr ""
25290
25291 #. type: =head2
25292 #: ../resize/virt-resize.pod:241
25293 msgid "LOGICAL PARTITIONS"
25294 msgstr ""
25295
25296 #. type: textblock
25297 #: ../resize/virt-resize.pod:243
25298 msgid ""
25299 "Logical partitions (a.k.a. C</dev/sda5+> on disks using DOS partition "
25300 "tables) cannot be resized."
25301 msgstr ""
25302
25303 #. type: textblock
25304 #: ../resize/virt-resize.pod:246
25305 msgid ""
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 "
25309 "type."
25310 msgstr ""
25311
25312 #. type: textblock
25313 #: ../resize/virt-resize.pod:251
25314 msgid "Logical partitions live inside the extended partition."
25315 msgstr ""
25316
25317 #. type: textblock
25318 #: ../resize/virt-resize.pod:253
25319 msgid ""
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."
25325 msgstr ""
25326
25327 #. type: textblock
25328 #: ../resize/virt-resize.pod:259
25329 msgid ""
25330 "You cannot specify a logical partition (C</dev/sda5+>) at all on the command "
25331 "line.  Doing so will give an error."
25332 msgstr ""
25333
25334 #. type: textblock
25335 #: ../resize/virt-resize.pod:268 ../sparsify/virt-sparsify.pod:105
25336 msgid "Display help."
25337 msgstr ""
25338
25339 #. type: =item
25340 #: ../resize/virt-resize.pod:270
25341 msgid "B<--align-first auto>"
25342 msgstr ""
25343
25344 #. type: =item
25345 #: ../resize/virt-resize.pod:272
25346 msgid "B<--align-first never>"
25347 msgstr ""
25348
25349 #. type: =item
25350 #: ../resize/virt-resize.pod:274
25351 msgid "B<--align-first always>"
25352 msgstr ""
25353
25354 #. type: textblock
25355 #: ../resize/virt-resize.pod:276
25356 msgid ""
25357 "Align the first partition for improved performance (see also the I<--"
25358 "alignment> option)."
25359 msgstr ""
25360
25361 #. type: textblock
25362 #: ../resize/virt-resize.pod:279
25363 msgid ""
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 "
25367 "Windows guests."
25368 msgstr ""
25369
25370 #. type: textblock
25371 #: ../resize/virt-resize.pod:284
25372 msgid ""
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."
25375 msgstr ""
25376
25377 #. type: textblock
25378 #: ../resize/virt-resize.pod:288
25379 msgid ""
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."
25383 msgstr ""
25384
25385 #. type: =item
25386 #: ../resize/virt-resize.pod:292
25387 msgid "B<--alignment N>"
25388 msgstr ""
25389
25390 #. type: textblock
25391 #: ../resize/virt-resize.pod:294
25392 msgid ""
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."
25395 msgstr ""
25396
25397 #. type: textblock
25398 #: ../resize/virt-resize.pod:298
25399 msgid ""
25400 "Assuming 512 byte sector size inside the guest, here are some suitable "
25401 "values for this:"
25402 msgstr ""
25403
25404 #. type: =item
25405 #: ../resize/virt-resize.pod:303
25406 msgid "I<--alignment 1> (512 bytes)"
25407 msgstr ""
25408
25409 #. type: textblock
25410 #: ../resize/virt-resize.pod:305
25411 msgid ""
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."
25415 msgstr ""
25416
25417 #. type: =item
25418 #: ../resize/virt-resize.pod:309
25419 msgid "I<--alignment 8> (4K)"
25420 msgstr ""
25421
25422 #. type: textblock
25423 #: ../resize/virt-resize.pod:311
25424 msgid ""
25425 "This would be the minimum acceptable alignment for reasonable performance on "
25426 "modern hosts."
25427 msgstr ""
25428
25429 #. type: =item
25430 #: ../resize/virt-resize.pod:314
25431 msgid "I<--alignment 128> (64K)"
25432 msgstr ""
25433
25434 #. type: textblock
25435 #: ../resize/virt-resize.pod:316
25436 msgid ""
25437 "This alignment provides good performance when the host is using high end "
25438 "network storage."
25439 msgstr ""
25440
25441 #. type: =item
25442 #: ../resize/virt-resize.pod:319
25443 msgid "I<--alignment 2048> (1M)"
25444 msgstr ""
25445
25446 #. type: textblock
25447 #: ../resize/virt-resize.pod:321
25448 msgid ""
25449 "This is the standard alignment used by all newly installed guests since "
25450 "around 2008."
25451 msgstr ""
25452
25453 #. type: =item
25454 #: ../resize/virt-resize.pod:326
25455 msgid "B<-d>"
25456 msgstr "B<-d>"
25457
25458 #. type: =item
25459 #: ../resize/virt-resize.pod:328 ../tools/virt-make-fs.pl:177
25460 #: ../tools/virt-win-reg.pl:120
25461 msgid "B<--debug>"
25462 msgstr "B<--debug>"
25463
25464 #. type: textblock
25465 #: ../resize/virt-resize.pod:330 ../tools/virt-win-reg.pl:122
25466 msgid "Enable debugging messages."
25467 msgstr ""
25468
25469 #. type: =item
25470 #: ../resize/virt-resize.pod:332
25471 msgid "B<--delete part>"
25472 msgstr "B<--delete розділ>"
25473
25474 #. type: textblock
25475 #: ../resize/virt-resize.pod:334
25476 msgid ""
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."
25480 msgstr ""
25481
25482 #. type: textblock
25483 #: ../resize/virt-resize.pod:338
25484 msgid ""
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."
25488 msgstr ""
25489
25490 #. type: textblock
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."
25494 msgstr ""
25495
25496 #. type: =item
25497 #: ../resize/virt-resize.pod:345
25498 msgid "B<--expand part>"
25499 msgstr "B<--expand розділ>"
25500
25501 #. type: textblock
25502 #: ../resize/virt-resize.pod:347
25503 msgid ""
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)."
25506 msgstr ""
25507
25508 #. type: textblock
25509 #: ../resize/virt-resize.pod:350
25510 msgid ""
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."
25515 msgstr ""
25516
25517 #. type: textblock
25518 #: ../resize/virt-resize.pod:355
25519 msgid "Currently virt-resize can resize:"
25520 msgstr ""
25521
25522 #. type: textblock
25523 #: ../resize/virt-resize.pod:361
25524 msgid "ext2, ext3 and ext4 filesystems."
25525 msgstr ""
25526
25527 #. type: textblock
25528 #: ../resize/virt-resize.pod:365
25529 msgid "NTFS filesystems, if libguestfs was compiled with support for NTFS."
25530 msgstr ""
25531
25532 #. type: textblock
25533 #: ../resize/virt-resize.pod:367
25534 msgid ""
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 "
25538 "the disk."
25539 msgstr ""
25540
25541 #. type: textblock
25542 #: ../resize/virt-resize.pod:374
25543 msgid ""
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."
25547 msgstr ""
25548
25549 #. type: textblock
25550 #: ../resize/virt-resize.pod:380
25551 msgid "Btrfs filesystems, if libguestfs was compiled with support for btrfs."
25552 msgstr ""
25553
25554 #. type: textblock
25555 #: ../resize/virt-resize.pod:384 ../resize/virt-resize.pod:559
25556 msgid "Note that you cannot use I<--expand> and I<--shrink> together."
25557 msgstr ""
25558
25559 #. type: =item
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"
25565
25566 #. type: textblock
25567 #: ../resize/virt-resize.pod:388 ../sparsify/virt-sparsify.pod:129
25568 msgid ""
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."
25571 msgstr ""
25572
25573 #. type: textblock
25574 #: ../resize/virt-resize.pod:394
25575 msgid ""
25576 "Note that this option I<does not> affect the output format.  See L</QCOW2 "
25577 "AND NON-SPARSE RAW FORMATS>."
25578 msgstr ""
25579
25580 #. type: =item
25581 #: ../resize/virt-resize.pod:397
25582 msgid "B<--ignore part>"
25583 msgstr "B<--ignore розділ>"
25584
25585 #. type: textblock
25586 #: ../resize/virt-resize.pod:399
25587 msgid ""
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 "
25591 "bytes)."
25592 msgstr ""
25593
25594 #. type: =item
25595 #: ../resize/virt-resize.pod:406
25596 msgid "B<--LV-expand logvol>"
25597 msgstr "B<--LV-expand логічний_том>"
25598
25599 #. type: textblock
25600 #: ../resize/virt-resize.pod:408
25601 msgid ""
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:"
25606 msgstr ""
25607
25608 #. type: verbatim
25609 #: ../resize/virt-resize.pod:413
25610 #, no-wrap
25611 msgid ""
25612 " virt-resize indisk outdisk \\\n"
25613 "   --expand /dev/sda2 --LV-expand /dev/vg_guest/lv_root\n"
25614 "\n"
25615 msgstr ""
25616
25617 #. type: textblock
25618 #: ../resize/virt-resize.pod:416
25619 msgid ""
25620 "This would first expand the partition (and PV), and then expand the root "
25621 "device to fill the extra space in the PV."
25622 msgstr ""
25623
25624 #. type: textblock
25625 #: ../resize/virt-resize.pod:419
25626 msgid ""
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>."
25630 msgstr ""
25631
25632 #. type: textblock
25633 #: ../resize/virt-resize.pod:423
25634 msgid "Use L<virt-filesystems(1)> to list the filesystems in the guest."
25635 msgstr ""
25636
25637 #. type: textblock
25638 #: ../resize/virt-resize.pod:425
25639 msgid ""
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 "
25642 "groups."
25643 msgstr ""
25644
25645 #. type: =item
25646 #: ../resize/virt-resize.pod:429 ../sparsify/virt-sparsify.pod:147
25647 msgid "B<--machine-readable>"
25648 msgstr ""
25649
25650 #. type: textblock
25651 #: ../resize/virt-resize.pod:431 ../sparsify/virt-sparsify.pod:149
25652 msgid ""
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."
25655 msgstr ""
25656
25657 #. type: =item
25658 #: ../resize/virt-resize.pod:437
25659 msgid "B<--dryrun>"
25660 msgstr "B<--dryrun>"
25661
25662 #. type: textblock
25663 #: ../resize/virt-resize.pod:439
25664 msgid "Print a summary of what would be done, but don't do anything."
25665 msgstr ""
25666
25667 #. type: =item
25668 #: ../resize/virt-resize.pod:441
25669 msgid "B<--no-copy-boot-loader>"
25670 msgstr "B<--no-copy-boot-loader>"
25671
25672 #. type: textblock
25673 #: ../resize/virt-resize.pod:443
25674 msgid ""
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."
25679 msgstr ""
25680
25681 #. type: textblock
25682 #: ../resize/virt-resize.pod:448
25683 msgid ""
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."
25686 msgstr ""
25687
25688 #. type: =item
25689 #: ../resize/virt-resize.pod:451
25690 msgid "B<--no-extra-partition>"
25691 msgstr "B<--no-extra-partition>"
25692
25693 #. type: textblock
25694 #: ../resize/virt-resize.pod:453
25695 msgid ""
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."
25701 msgstr ""
25702
25703 #. type: textblock
25704 #: ../resize/virt-resize.pod:459
25705 msgid ""
25706 "Note that if the surplus space is smaller than 10 MB, no extra partition "
25707 "will be created."
25708 msgstr ""
25709
25710 #. type: =item
25711 #: ../resize/virt-resize.pod:462
25712 msgid "B<--no-expand-content>"
25713 msgstr "B<--no-expand-content>"
25714
25715 #. type: textblock
25716 #: ../resize/virt-resize.pod:464
25717 msgid ""
25718 "By default, virt-resize will try to expand the direct contents of "
25719 "partitions, if it knows how (see I<--expand> option above)."
25720 msgstr ""
25721
25722 #. type: textblock
25723 #: ../resize/virt-resize.pod:467
25724 msgid ""
25725 "If you give the I<--no-expand-content> option then virt-resize will not "
25726 "attempt this."
25727 msgstr ""
25728
25729 #. type: =item
25730 #: ../resize/virt-resize.pod:470
25731 msgid "B<--ntfsresize-force>"
25732 msgstr "B<--ntfsresize-force>"
25733
25734 #. type: textblock
25735 #: ../resize/virt-resize.pod:472
25736 msgid ""
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."
25741 msgstr ""
25742
25743 #. type: =item
25744 #: ../resize/virt-resize.pod:478
25745 msgid "B<--output-format> raw"
25746 msgstr "B<--output-format> raw"
25747
25748 #. type: textblock
25749 #: ../resize/virt-resize.pod:480
25750 msgid ""
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."
25753 msgstr ""
25754
25755 #. type: textblock
25756 #: ../resize/virt-resize.pod:486
25757 msgid ""
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>."
25762 msgstr ""
25763
25764 #. type: textblock
25765 #: ../resize/virt-resize.pod:495
25766 msgid "Don't print the summary."
25767 msgstr ""
25768
25769 #. type: =item
25770 #: ../resize/virt-resize.pod:497
25771 msgid "B<--resize part=size>"
25772 msgstr "B<--resize розділ=розмір>"
25773
25774 #. type: textblock
25775 #: ../resize/virt-resize.pod:499
25776 msgid ""
25777 "Resize the named partition (expanding or shrinking it) so that it has the "
25778 "given size."
25779 msgstr ""
25780
25781 #. type: textblock
25782 #: ../resize/virt-resize.pod:502
25783 msgid ""
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:"
25787 msgstr ""
25788
25789 #. type: verbatim
25790 #: ../resize/virt-resize.pod:508
25791 #, no-wrap
25792 msgid ""
25793 " --resize /dev/sda2=10G\n"
25794 "\n"
25795 msgstr ""
25796
25797 #. type: verbatim
25798 #: ../resize/virt-resize.pod:510
25799 #, no-wrap
25800 msgid ""
25801 " --resize /dev/sda4=90%\n"
25802 "\n"
25803 msgstr ""
25804
25805 #. type: verbatim
25806 #: ../resize/virt-resize.pod:512
25807 #, no-wrap
25808 msgid ""
25809 " --resize /dev/sda2=+1G\n"
25810 "\n"
25811 msgstr ""
25812
25813 #. type: verbatim
25814 #: ../resize/virt-resize.pod:514
25815 #, no-wrap
25816 msgid ""
25817 " --resize /dev/sda2=-200M\n"
25818 "\n"
25819 msgstr ""
25820
25821 #. type: verbatim
25822 #: ../resize/virt-resize.pod:516
25823 #, no-wrap
25824 msgid ""
25825 " --resize /dev/sda1=+128K\n"
25826 "\n"
25827 msgstr ""
25828
25829 #. type: verbatim
25830 #: ../resize/virt-resize.pod:518
25831 #, no-wrap
25832 msgid ""
25833 " --resize /dev/sda1=+10%\n"
25834 "\n"
25835 msgstr ""
25836
25837 #. type: verbatim
25838 #: ../resize/virt-resize.pod:520
25839 #, no-wrap
25840 msgid ""
25841 " --resize /dev/sda1=-10%\n"
25842 "\n"
25843 msgstr ""
25844
25845 #. type: textblock
25846 #: ../resize/virt-resize.pod:522
25847 msgid ""
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)."
25850 msgstr ""
25851
25852 #. type: textblock
25853 #: ../resize/virt-resize.pod:526
25854 msgid ""
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-"
25858 "force>)."
25859 msgstr ""
25860
25861 #. type: =item
25862 #: ../resize/virt-resize.pod:533
25863 msgid "B<--resize-force part=size>"
25864 msgstr "B<--resize-force розділ=розмір>"
25865
25866 #. type: textblock
25867 #: ../resize/virt-resize.pod:535
25868 msgid ""
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)."
25874 msgstr ""
25875
25876 #. type: textblock
25877 #: ../resize/virt-resize.pod:541
25878 msgid "See also the I<--ignore> option."
25879 msgstr ""
25880
25881 #. type: =item
25882 #: ../resize/virt-resize.pod:543
25883 msgid "B<--shrink part>"
25884 msgstr "B<--shrink розділ>"
25885
25886 #. type: textblock
25887 #: ../resize/virt-resize.pod:545
25888 msgid ""
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 "
25893 "been done."
25894 msgstr ""
25895
25896 #. type: textblock
25897 #: ../resize/virt-resize.pod:551
25898 msgid ""
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."
25905 msgstr ""
25906
25907 #. type: =head1
25908 #: ../resize/virt-resize.pod:569 ../sparsify/virt-sparsify.pod:177
25909 msgid "MACHINE READABLE OUTPUT"
25910 msgstr ""
25911
25912 #. type: textblock
25913 #: ../resize/virt-resize.pod:571
25914 msgid ""
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 "
25917 "etc."
25918 msgstr ""
25919
25920 #. type: textblock
25921 #: ../resize/virt-resize.pod:575 ../sparsify/virt-sparsify.pod:183
25922 msgid "There are two ways to use this option."
25923 msgstr ""
25924
25925 #. type: textblock
25926 #: ../resize/virt-resize.pod:577
25927 msgid ""
25928 "Firstly use the option on its own to query the capabilities of the virt-"
25929 "resize binary.  Typical output looks like this:"
25930 msgstr ""
25931
25932 #. type: verbatim
25933 #: ../resize/virt-resize.pod:580
25934 #, no-wrap
25935 msgid ""
25936 " $ virt-resize --machine-readable\n"
25937 " virt-resize\n"
25938 " ntfsresize-force\n"
25939 " 32bitok\n"
25940 " ntfs\n"
25941 " btrfs\n"
25942 "\n"
25943 msgstr ""
25944
25945 #. type: textblock
25946 #: ../resize/virt-resize.pod:587 ../sparsify/virt-sparsify.pod:193
25947 msgid ""
25948 "A list of features is printed, one per line, and the program exits with "
25949 "status 0."
25950 msgstr ""
25951
25952 #. type: textblock
25953 #: ../resize/virt-resize.pod:590 ../sparsify/virt-sparsify.pod:196
25954 msgid ""
25955 "Secondly use the option in conjunction with other options to make the "
25956 "regular program output more machine friendly."
25957 msgstr ""
25958
25959 #. type: textblock
25960 #: ../resize/virt-resize.pod:593 ../sparsify/virt-sparsify.pod:199
25961 msgid "At the moment this means:"
25962 msgstr ""
25963
25964 #. type: textblock
25965 #: ../resize/virt-resize.pod:599 ../sparsify/virt-sparsify.pod:205
25966 msgid ""
25967 "Progress bar messages can be parsed from stdout by looking for this regular "
25968 "expression:"
25969 msgstr ""
25970
25971 #. type: verbatim
25972 #: ../resize/virt-resize.pod:602 ../sparsify/virt-sparsify.pod:208
25973 #, no-wrap
25974 msgid ""
25975 " ^[0-9]+/[0-9]+$\n"
25976 "\n"
25977 msgstr ""
25978
25979 #. type: textblock
25980 #: ../resize/virt-resize.pod:606 ../sparsify/virt-sparsify.pod:212
25981 msgid ""
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."
25985 msgstr ""
25986
25987 #. type: textblock
25988 #: ../resize/virt-resize.pod:612
25989 msgid ""
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 "
25992 "fatal error."
25993 msgstr ""
25994
25995 #. type: textblock
25996 #: ../resize/virt-resize.pod:618
25997 msgid ""
25998 "Versions of the program prior to 1.13.9 did not support the I<--machine-"
25999 "readable> option and will return an error."
26000 msgstr ""
26001
26002 #. type: =head2
26003 #: ../resize/virt-resize.pod:623
26004 msgid "\"Partition 1 does not end on cylinder boundary.\""
26005 msgstr ""
26006
26007 #. type: textblock
26008 #: ../resize/virt-resize.pod:625
26009 msgid ""
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."
26016 msgstr ""
26017
26018 #. type: =head2
26019 #: ../resize/virt-resize.pod:632
26020 msgid "RESIZING WINDOWS VIRTUAL MACHINES"
26021 msgstr ""
26022
26023 #. type: textblock
26024 #: ../resize/virt-resize.pod:634
26025 msgid ""
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."
26031 msgstr ""
26032
26033 #. type: textblock
26034 #: ../resize/virt-resize.pod:641
26035 msgid ""
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."
26039 msgstr ""
26040
26041 #. type: =head2
26042 #: ../resize/virt-resize.pod:645
26043 msgid "GUEST BOOT STUCK AT \"GRUB\""
26044 msgstr ""
26045
26046 #. type: textblock
26047 #: ../resize/virt-resize.pod:647
26048 msgid ""
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."
26051 msgstr ""
26052
26053 #. type: verbatim
26054 #: ../resize/virt-resize.pod:650
26055 #, no-wrap
26056 msgid ""
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"
26062 " ><fs> exit\n"
26063 "\n"
26064 msgstr ""
26065
26066 #. type: textblock
26067 #: ../resize/virt-resize.pod:657
26068 msgid ""
26069 "For more flexible guest reconfiguration, including if you need to specify "
26070 "other parameters to grub-install, use L<virt-rescue(1)>."
26071 msgstr ""
26072
26073 #. type: =head1
26074 #: ../resize/virt-resize.pod:660
26075 msgid "ALTERNATIVE TOOLS"
26076 msgstr ""
26077
26078 #. type: textblock
26079 #: ../resize/virt-resize.pod:662
26080 msgid ""
26081 "There are several proprietary tools for resizing partitions.  We won't "
26082 "mention any here."
26083 msgstr ""
26084
26085 #. type: textblock
26086 #: ../resize/virt-resize.pod:665
26087 msgid ""
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 "
26091 "understand LVM."
26092 msgstr ""
26093
26094 #. type: textblock
26095 #: ../resize/virt-resize.pod:670
26096 msgid ""
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 "
26101 "I<--debug> flag."
26102 msgstr ""
26103
26104 #. type: textblock
26105 #: ../resize/virt-resize.pod:690
26106 msgid ""
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/>."
26112 msgstr ""
26113
26114 #. type: textblock
26115 #: ../ruby/examples/guestfs-ruby.pod:5
26116 msgid "guestfs-ruby - How to use libguestfs from Ruby"
26117 msgstr ""
26118
26119 #. type: verbatim
26120 #: ../ruby/examples/guestfs-ruby.pod:9
26121 #, no-wrap
26122 msgid ""
26123 " require 'guestfs'\n"
26124 " g = Guestfs::Guestfs.new()\n"
26125 " g.add_drive_opts(\"disk.img\",\n"
26126 "                  :readonly => 1, :format => \"raw\")\n"
26127 " g.launch()\n"
26128 "\n"
26129 msgstr ""
26130
26131 #. type: textblock
26132 #: ../ruby/examples/guestfs-ruby.pod:17
26133 msgid ""
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)>."
26138 msgstr ""
26139
26140 #. type: textblock
26141 #: ../ruby/examples/guestfs-ruby.pod:24
26142 msgid ""
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)."
26145 msgstr ""
26146
26147 #. type: textblock
26148 #: ../ruby/examples/guestfs-ruby.pod:38
26149 msgid ""
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/>."
26153 msgstr ""
26154
26155 #. type: textblock
26156 #: ../sparsify/virt-sparsify.pod:5
26157 msgid "virt-sparsify - Make a virtual machine disk sparse"
26158 msgstr ""
26159
26160 #. type: verbatim
26161 #: ../sparsify/virt-sparsify.pod:9
26162 #, no-wrap
26163 msgid ""
26164 " virt-sparsify [--options] indisk outdisk\n"
26165 "\n"
26166 msgstr ""
26167
26168 #. type: textblock
26169 #: ../sparsify/virt-sparsify.pod:13
26170 msgid ""
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."
26174 msgstr ""
26175
26176 #. type: textblock
26177 #: ../sparsify/virt-sparsify.pod:18
26178 msgid ""
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."
26181 msgstr ""
26182
26183 #. type: textblock
26184 #: ../sparsify/virt-sparsify.pod:21
26185 msgid ""
26186 "Virt-sparsify can also convert between some disk formats, for example "
26187 "converting a raw disk image to a thin-provisioned qcow2 image."
26188 msgstr ""
26189
26190 #. type: textblock
26191 #: ../sparsify/virt-sparsify.pod:24
26192 msgid ""
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."
26196 msgstr ""
26197
26198 #. type: =head2
26199 #: ../sparsify/virt-sparsify.pod:28
26200 msgid "IMPORTANT LIMITATIONS"
26201 msgstr ""
26202
26203 #. type: textblock
26204 #: ../sparsify/virt-sparsify.pod:34
26205 msgid ""
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>."
26209 msgstr ""
26210
26211 #. type: textblock
26212 #: ../sparsify/virt-sparsify.pod:41
26213 msgid "The virtual machine I<must be shut down> before using this tool."
26214 msgstr ""
26215
26216 #. type: textblock
26217 #: ../sparsify/virt-sparsify.pod:45
26218 msgid ""
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."
26222 msgstr ""
26223
26224 #. type: textblock
26225 #: ../sparsify/virt-sparsify.pod:51
26226 msgid ""
26227 "Virt-sparsify cannot resize disk images.  To do that, use L<virt-resize(1)>."
26228 msgstr ""
26229
26230 #. type: textblock
26231 #: ../sparsify/virt-sparsify.pod:56
26232 msgid "Virt-sparsify cannot handle encrypted disks."
26233 msgstr ""
26234
26235 #. type: textblock
26236 #: ../sparsify/virt-sparsify.pod:60
26237 msgid ""
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 "
26240 "really unused."
26241 msgstr ""
26242
26243 #. type: textblock
26244 #: ../sparsify/virt-sparsify.pod:66
26245 msgid ""
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."
26249 msgstr ""
26250
26251 #. type: textblock
26252 #: ../sparsify/virt-sparsify.pod:72
26253 msgid ""
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."
26256 msgstr ""
26257
26258 #. type: textblock
26259 #: ../sparsify/virt-sparsify.pod:77
26260 msgid "Typical usage is:"
26261 msgstr ""
26262
26263 #. type: verbatim
26264 #: ../sparsify/virt-sparsify.pod:79
26265 #, no-wrap
26266 msgid ""
26267 " virt-sparsify indisk outdisk\n"
26268 "\n"
26269 msgstr ""
26270
26271 #. type: textblock
26272 #: ../sparsify/virt-sparsify.pod:81
26273 msgid ""
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."
26277 msgstr ""
26278
26279 #. type: textblock
26280 #: ../sparsify/virt-sparsify.pod:86
26281 msgid "To convert between formats, use the I<--convert> option:"
26282 msgstr ""
26283
26284 #. type: verbatim
26285 #: ../sparsify/virt-sparsify.pod:88
26286 #, no-wrap
26287 msgid ""
26288 " virt-sparsify disk.raw --convert qcow2 disk.qcow2\n"
26289 "\n"
26290 msgstr ""
26291
26292 #. type: textblock
26293 #: ../sparsify/virt-sparsify.pod:90
26294 msgid ""
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:"
26298 msgstr ""
26299
26300 #. type: verbatim
26301 #: ../sparsify/virt-sparsify.pod:94
26302 #, no-wrap
26303 msgid ""
26304 " virt-sparsify --ignore /dev/sda1 indisk outdisk\n"
26305 "\n"
26306 msgstr ""
26307
26308 #. type: textblock
26309 #: ../sparsify/virt-sparsify.pod:96
26310 msgid ""
26311 "See L<virt-filesystems(1)> to get a list of filesystems within a disk image."
26312 msgstr ""
26313
26314 #. type: =item
26315 #: ../sparsify/virt-sparsify.pod:107
26316 msgid "B<--convert> raw"
26317 msgstr ""
26318
26319 #. type: =item
26320 #: ../sparsify/virt-sparsify.pod:109
26321 msgid "B<--convert> qcow2"
26322 msgstr ""
26323
26324 #. type: =item
26325 #: ../sparsify/virt-sparsify.pod:111
26326 msgid "B<--convert> [other formats]"
26327 msgstr ""
26328
26329 #. type: textblock
26330 #: ../sparsify/virt-sparsify.pod:113
26331 msgid ""
26332 "Use C<output-format> as the format for the destination image.  If this is "
26333 "not specified, then the input format is used."
26334 msgstr ""
26335
26336 #. type: textblock
26337 #: ../sparsify/virt-sparsify.pod:116
26338 msgid "Supported and known-working output formats are: C<raw>, C<qcow2>."
26339 msgstr ""
26340
26341 #. type: textblock
26342 #: ../sparsify/virt-sparsify.pod:118
26343 msgid ""
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."
26346 msgstr ""
26347
26348 #. type: textblock
26349 #: ../sparsify/virt-sparsify.pod:122
26350 msgid ""
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."
26353 msgstr ""
26354
26355 #. type: =item
26356 #: ../sparsify/virt-sparsify.pod:127
26357 msgid "B<--format> qcow2"
26358 msgstr ""
26359
26360 #. type: =item
26361 #: ../sparsify/virt-sparsify.pod:135
26362 msgid "B<--ignore> filesystem"
26363 msgstr ""
26364
26365 #. type: =item
26366 #: ../sparsify/virt-sparsify.pod:137
26367 msgid "B<--ignore> volgroup"
26368 msgstr ""
26369
26370 #. type: textblock
26371 #: ../sparsify/virt-sparsify.pod:139
26372 msgid ""
26373 "Ignore the named filesystem.  Free space on the filesystem will not be "
26374 "zeroed, but existing blocks of zeroes will still be sparsified."
26375 msgstr ""
26376
26377 #. type: textblock
26378 #: ../sparsify/virt-sparsify.pod:142
26379 msgid ""
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>"
26382 msgstr ""
26383
26384 #. type: textblock
26385 #: ../sparsify/virt-sparsify.pod:157
26386 msgid "This disables progress bars and other unnecessary output."
26387 msgstr ""
26388
26389 #. type: textblock
26390 #: ../sparsify/virt-sparsify.pod:179
26391 msgid ""
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, "
26394 "GUIs etc."
26395 msgstr ""
26396
26397 #. type: textblock
26398 #: ../sparsify/virt-sparsify.pod:185
26399 msgid ""
26400 "Firstly use the option on its own to query the capabilities of the virt-"
26401 "sparsify binary.  Typical output looks like this:"
26402 msgstr ""
26403
26404 #. type: verbatim
26405 #: ../sparsify/virt-sparsify.pod:188
26406 #, no-wrap
26407 msgid ""
26408 " $ virt-sparsify --machine-readable\n"
26409 " virt-sparsify\n"
26410 " ntfs\n"
26411 " btrfs\n"
26412 "\n"
26413 msgstr ""
26414
26415 #. type: textblock
26416 #: ../sparsify/virt-sparsify.pod:218
26417 msgid ""
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 "
26420 "fatal error."
26421 msgstr ""
26422
26423 #. type: textblock
26424 #: ../sparsify/virt-sparsify.pod:224
26425 msgid ""
26426 "All versions of virt-sparsify have supported the I<--machine-readable> "
26427 "option."
26428 msgstr ""
26429
26430 #. type: textblock
26431 #: ../sparsify/virt-sparsify.pod:238
26432 msgid ""
26433 "Location of the temporary directory used for the potentially large temporary "
26434 "overlay file."
26435 msgstr ""
26436
26437 #. type: textblock
26438 #: ../sparsify/virt-sparsify.pod:241
26439 msgid ""
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."
26443 msgstr ""
26444
26445 #. type: textblock
26446 #: ../sparsify/virt-sparsify.pod:245
26447 msgid "This defaults to C</tmp>."
26448 msgstr ""
26449
26450 #. type: textblock
26451 #: ../sparsify/virt-sparsify.pod:249
26452 msgid ""
26453 "For other environment variables, see L<guestfs(3)/ENVIRONMENT VARIABLES>."
26454 msgstr ""
26455
26456 #. type: textblock
26457 #: ../sparsify/virt-sparsify.pod:253
26458 msgid ""
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/>."
26462 msgstr ""
26463
26464 #. type: =head2
26465 #: ../src/guestfs-actions.pod:1
26466 msgid "guestfs_add_cdrom"
26467 msgstr ""
26468
26469 #. type: verbatim
26470 #: ../src/guestfs-actions.pod:3
26471 #, no-wrap
26472 msgid ""
26473 " int\n"
26474 " guestfs_add_cdrom (guestfs_h *g,\n"
26475 "                    const char *filename);\n"
26476 "\n"
26477 msgstr ""
26478
26479 #. type: textblock
26480 #: ../src/guestfs-actions.pod:7 ../src/guestfs-actions.pod:302
26481 #: ../src/guestfs-actions.pod:323
26482 msgid ""
26483 "I<This function is deprecated.> In new code, use the L</"
26484 "guestfs_add_drive_opts> call instead."
26485 msgstr ""
26486
26487 #. type: textblock
26488 #: ../src/guestfs-actions.pod:24
26489 msgid ""
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 "
26493 "instead."
26494 msgstr ""
26495
26496 #. type: textblock
26497 #: ../src/guestfs-actions.pod:31
26498 msgid ""
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."
26502 msgstr ""
26503
26504 #. type: textblock
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."
26601 msgstr ""
26602
26603 #. type: textblock
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)"
26614
26615 #. type: =head2
26616 #: ../src/guestfs-actions.pod:41
26617 msgid "guestfs_add_domain"
26618 msgstr ""
26619
26620 #. type: verbatim
26621 #: ../src/guestfs-actions.pod:43
26622 #, no-wrap
26623 msgid ""
26624 " int\n"
26625 " guestfs_add_domain (guestfs_h *g,\n"
26626 "                     const char *dom,\n"
26627 "                     ...);\n"
26628 "\n"
26629 msgstr ""
26630
26631 #. type: textblock
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
26640 msgid ""
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>."
26644 msgstr ""
26645
26646 #. type: verbatim
26647 #: ../src/guestfs-actions.pod:53
26648 #, no-wrap
26649 msgid ""
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"
26656 "\n"
26657 msgstr ""
26658
26659 #. type: textblock
26660 #: ../src/guestfs-actions.pod:60
26661 msgid ""
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 "
26665 "one."
26666 msgstr ""
26667
26668 #. type: textblock
26669 #: ../src/guestfs-actions.pod:141
26670 msgid ""
26671 "The other optional parameters are passed directly through to "
26672 "C<guestfs_add_drive_opts>."
26673 msgstr ""
26674
26675 #. type: textblock
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."
26691 msgstr ""
26692
26693 #. type: textblock
26694 #: ../src/guestfs-actions.pod:146
26695 msgid "(Added in 1.7.4)"
26696 msgstr "(Додано у 1.7.4)"
26697
26698 #. type: =head2
26699 #: ../src/guestfs-actions.pod:148
26700 msgid "guestfs_add_domain_va"
26701 msgstr ""
26702
26703 #. type: verbatim
26704 #: ../src/guestfs-actions.pod:150
26705 #, no-wrap
26706 msgid ""
26707 " int\n"
26708 " guestfs_add_domain_va (guestfs_h *g,\n"
26709 "                        const char *dom,\n"
26710 "                        va_list args);\n"
26711 "\n"
26712 msgstr ""
26713
26714 #. type: textblock
26715 #: ../src/guestfs-actions.pod:155
26716 msgid "This is the \"va_list variant\" of L</guestfs_add_domain>."
26717 msgstr ""
26718
26719 #. type: textblock
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>."
26737
26738 #. type: =head2
26739 #: ../src/guestfs-actions.pod:159
26740 msgid "guestfs_add_domain_argv"
26741 msgstr "guestfs_add_domain_argv"
26742
26743 #. type: verbatim
26744 #: ../src/guestfs-actions.pod:161
26745 #, no-wrap
26746 msgid ""
26747 " int\n"
26748 " guestfs_add_domain_argv (guestfs_h *g,\n"
26749 "                          const char *dom,\n"
26750 "                          const struct guestfs_add_domain_argv *optargs);\n"
26751 "\n"
26752 msgstr ""
26753
26754 #. type: textblock
26755 #: ../src/guestfs-actions.pod:166
26756 msgid "This is the \"argv variant\" of L</guestfs_add_domain>."
26757 msgstr ""
26758
26759 #. type: =head2
26760 #: ../src/guestfs-actions.pod:170
26761 msgid "guestfs_add_drive"
26762 msgstr ""
26763
26764 #. type: verbatim
26765 #: ../src/guestfs-actions.pod:172
26766 #, no-wrap
26767 msgid ""
26768 " int\n"
26769 " guestfs_add_drive (guestfs_h *g,\n"
26770 "                    const char *filename);\n"
26771 "\n"
26772 msgstr ""
26773
26774 #. type: textblock
26775 #: ../src/guestfs-actions.pod:176
26776 msgid ""
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."
26780 msgstr ""
26781
26782 #. type: textblock
26783 #: ../src/guestfs-actions.pod:180
26784 msgid ""
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."
26790 msgstr ""
26791
26792 #. type: =head2
26793 #: ../src/guestfs-actions.pod:191
26794 msgid "guestfs_add_drive_opts"
26795 msgstr ""
26796
26797 #. type: verbatim
26798 #: ../src/guestfs-actions.pod:193
26799 #, no-wrap
26800 msgid ""
26801 " int\n"
26802 " guestfs_add_drive_opts (guestfs_h *g,\n"
26803 "                         const char *filename,\n"
26804 "                         ...);\n"
26805 "\n"
26806 msgstr ""
26807
26808 #. type: verbatim
26809 #: ../src/guestfs-actions.pod:203
26810 #, no-wrap
26811 msgid ""
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"
26816 "\n"
26817 msgstr ""
26818
26819 #. type: textblock
26820 #: ../src/guestfs-actions.pod:233
26821 msgid ""
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>."
26825 msgstr ""
26826
26827 #. type: textblock
26828 #: ../src/guestfs-actions.pod:244
26829 msgid ""
26830 "This rarely-used option lets you emulate the behaviour of the deprecated "
26831 "C<guestfs_add_drive_with_if> call (q.v.)"
26832 msgstr ""
26833
26834 #. type: textblock
26835 #: ../src/guestfs-actions.pod:256
26836 msgid "(Added in 1.5.23)"
26837 msgstr "(Додано у 1.5.23)"
26838
26839 #. type: =head2
26840 #: ../src/guestfs-actions.pod:258
26841 msgid "guestfs_add_drive_opts_va"
26842 msgstr ""
26843
26844 #. type: verbatim
26845 #: ../src/guestfs-actions.pod:260
26846 #, no-wrap
26847 msgid ""
26848 " int\n"
26849 " guestfs_add_drive_opts_va (guestfs_h *g,\n"
26850 "                            const char *filename,\n"
26851 "                            va_list args);\n"
26852 "\n"
26853 msgstr ""
26854
26855 #. type: textblock
26856 #: ../src/guestfs-actions.pod:265
26857 msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>."
26858 msgstr ""
26859
26860 #. type: =head2
26861 #: ../src/guestfs-actions.pod:269
26862 msgid "guestfs_add_drive_opts_argv"
26863 msgstr ""
26864
26865 #. type: verbatim
26866 #: ../src/guestfs-actions.pod:271
26867 #, no-wrap
26868 msgid ""
26869 " int\n"
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"
26873 "\n"
26874 msgstr ""
26875
26876 #. type: textblock
26877 #: ../src/guestfs-actions.pod:276
26878 msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>."
26879 msgstr ""
26880
26881 #. type: =head2
26882 #: ../src/guestfs-actions.pod:280
26883 msgid "guestfs_add_drive_ro"
26884 msgstr ""
26885
26886 #. type: verbatim
26887 #: ../src/guestfs-actions.pod:282
26888 #, no-wrap
26889 msgid ""
26890 " int\n"
26891 " guestfs_add_drive_ro (guestfs_h *g,\n"
26892 "                       const char *filename);\n"
26893 "\n"
26894 msgstr ""
26895
26896 #. type: textblock
26897 #: ../src/guestfs-actions.pod:286
26898 msgid ""
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."
26902 msgstr ""
26903
26904 #. type: textblock
26905 #: ../src/guestfs-actions.pod:293
26906 msgid "(Added in 1.0.38)"
26907 msgstr "(Додано у 1.0.38)"
26908
26909 #. type: =head2
26910 #: ../src/guestfs-actions.pod:295
26911 msgid "guestfs_add_drive_ro_with_if"
26912 msgstr ""
26913
26914 #. type: verbatim
26915 #: ../src/guestfs-actions.pod:297
26916 #, no-wrap
26917 msgid ""
26918 " int\n"
26919 " guestfs_add_drive_ro_with_if (guestfs_h *g,\n"
26920 "                               const char *filename,\n"
26921 "                               const char *iface);\n"
26922 "\n"
26923 msgstr ""
26924
26925 #. type: textblock
26926 #: ../src/guestfs-actions.pod:309
26927 msgid ""
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."
26930 msgstr ""
26931
26932 #. type: textblock
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)"
26937
26938 #. type: =head2
26939 #: ../src/guestfs-actions.pod:316
26940 msgid "guestfs_add_drive_with_if"
26941 msgstr ""
26942
26943 #. type: verbatim
26944 #: ../src/guestfs-actions.pod:318
26945 #, no-wrap
26946 msgid ""
26947 " int\n"
26948 " guestfs_add_drive_with_if (guestfs_h *g,\n"
26949 "                            const char *filename,\n"
26950 "                            const char *iface);\n"
26951 "\n"
26952 msgstr ""
26953
26954 #. type: textblock
26955 #: ../src/guestfs-actions.pod:330
26956 msgid ""
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."
26959 msgstr ""
26960
26961 #. type: =head2
26962 #: ../src/guestfs-actions.pod:337
26963 msgid "guestfs_aug_clear"
26964 msgstr ""
26965
26966 #. type: verbatim
26967 #: ../src/guestfs-actions.pod:339
26968 #, no-wrap
26969 msgid ""
26970 " int\n"
26971 " guestfs_aug_clear (guestfs_h *g,\n"
26972 "                    const char *augpath);\n"
26973 "\n"
26974 msgstr ""
26975
26976 #. type: textblock
26977 #: ../src/guestfs-actions.pod:348 ../src/guestfs-actions.pod:2609
26978 msgid "(Added in 1.3.4)"
26979 msgstr "(Додано у 1.3.4)"
26980
26981 #. type: =head2
26982 #: ../src/guestfs-actions.pod:350
26983 msgid "guestfs_aug_close"
26984 msgstr ""
26985
26986 #. type: verbatim
26987 #: ../src/guestfs-actions.pod:352
26988 #, no-wrap
26989 msgid ""
26990 " int\n"
26991 " guestfs_aug_close (guestfs_h *g);\n"
26992 "\n"
26993 msgstr ""
26994
26995 #. type: textblock
26996 #: ../src/guestfs-actions.pod:355
26997 msgid ""
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."
27001 msgstr ""
27002
27003 #. type: textblock
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)"
27013
27014 #. type: =head2
27015 #: ../src/guestfs-actions.pod:364
27016 msgid "guestfs_aug_defnode"
27017 msgstr ""
27018
27019 #. type: verbatim
27020 #: ../src/guestfs-actions.pod:366
27021 #, no-wrap
27022 msgid ""
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"
27028 "\n"
27029 msgstr ""
27030
27031 #. type: textblock
27032 #: ../src/guestfs-actions.pod:375
27033 msgid ""
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."
27037 msgstr ""
27038
27039 #. type: textblock
27040 #: ../src/guestfs-actions.pod:383
27041 msgid ""
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>."
27044 msgstr ""
27045
27046 #. type: =head2
27047 #: ../src/guestfs-actions.pod:389
27048 msgid "guestfs_aug_defvar"
27049 msgstr ""
27050
27051 #. type: verbatim
27052 #: ../src/guestfs-actions.pod:391
27053 #, no-wrap
27054 msgid ""
27055 " int\n"
27056 " guestfs_aug_defvar (guestfs_h *g,\n"
27057 "                     const char *name,\n"
27058 "                     const char *expr);\n"
27059 "\n"
27060 msgstr ""
27061
27062 #. type: =head2
27063 #: ../src/guestfs-actions.pod:407
27064 msgid "guestfs_aug_get"
27065 msgstr "guestfs_aug_get"
27066
27067 #. type: verbatim
27068 #: ../src/guestfs-actions.pod:409
27069 #, no-wrap
27070 msgid ""
27071 " char *\n"
27072 " guestfs_aug_get (guestfs_h *g,\n"
27073 "                  const char *augpath);\n"
27074 "\n"
27075 msgstr ""
27076 " char *\n"
27077 " guestfs_aug_get (guestfs_h *g,\n"
27078 "                  const char *augpath);\n"
27079 "\n"
27080
27081 #. type: textblock
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
27106 msgid ""
27107 "This function returns a string, or NULL on error.  I<The caller must free "
27108 "the returned string after use>."
27109 msgstr ""
27110
27111 #. type: =head2
27112 #: ../src/guestfs-actions.pod:421
27113 msgid "guestfs_aug_init"
27114 msgstr "guestfs_aug_init"
27115
27116 #. type: verbatim
27117 #: ../src/guestfs-actions.pod:423
27118 #, no-wrap
27119 msgid ""
27120 " int\n"
27121 " guestfs_aug_init (guestfs_h *g,\n"
27122 "                   const char *root,\n"
27123 "                   int flags);\n"
27124 "\n"
27125 msgstr ""
27126 " int\n"
27127 " guestfs_aug_init (guestfs_h *g,\n"
27128 "                   const char *root,\n"
27129 "                   int flags);\n"
27130 "\n"
27131
27132 #. type: textblock
27133 #: ../src/guestfs-actions.pod:432
27134 msgid "You must call this before using any other C<guestfs_aug_*> commands."
27135 msgstr ""
27136
27137 #. type: textblock
27138 #: ../src/guestfs-actions.pod:457
27139 msgid ""
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>."
27144 msgstr ""
27145
27146 #. type: textblock
27147 #: ../src/guestfs-actions.pod:472
27148 msgid "Do not load the tree in C<guestfs_aug_init>."
27149 msgstr ""
27150
27151 #. type: textblock
27152 #: ../src/guestfs-actions.pod:476
27153 msgid "To close the handle, you can call C<guestfs_aug_close>."
27154 msgstr ""
27155
27156 #. type: =head2
27157 #: ../src/guestfs-actions.pod:484
27158 msgid "guestfs_aug_insert"
27159 msgstr "guestfs_aug_insert"
27160
27161 #. type: verbatim
27162 #: ../src/guestfs-actions.pod:486
27163 #, no-wrap
27164 msgid ""
27165 " int\n"
27166 " guestfs_aug_insert (guestfs_h *g,\n"
27167 "                     const char *augpath,\n"
27168 "                     const char *label,\n"
27169 "                     int before);\n"
27170 "\n"
27171 msgstr ""
27172 " int\n"
27173 " guestfs_aug_insert (guestfs_h *g,\n"
27174 "                     const char *augpath,\n"
27175 "                     const char *label,\n"
27176 "                     int before);\n"
27177 "\n"
27178
27179 #. type: =head2
27180 #: ../src/guestfs-actions.pod:504
27181 msgid "guestfs_aug_load"
27182 msgstr "guestfs_aug_load"
27183
27184 #. type: verbatim
27185 #: ../src/guestfs-actions.pod:506
27186 #, no-wrap
27187 msgid ""
27188 " int\n"
27189 " guestfs_aug_load (guestfs_h *g);\n"
27190 "\n"
27191 msgstr ""
27192 " int\n"
27193 " guestfs_aug_load (guestfs_h *g);\n"
27194 "\n"
27195
27196 #. type: =head2
27197 #: ../src/guestfs-actions.pod:518
27198 msgid "guestfs_aug_ls"
27199 msgstr "guestfs_aug_ls"
27200
27201 #. type: verbatim
27202 #: ../src/guestfs-actions.pod:520
27203 #, no-wrap
27204 msgid ""
27205 " char **\n"
27206 " guestfs_aug_ls (guestfs_h *g,\n"
27207 "                 const char *augpath);\n"
27208 "\n"
27209 msgstr ""
27210 " char **\n"
27211 " guestfs_aug_ls (guestfs_h *g,\n"
27212 "                 const char *augpath);\n"
27213 "\n"
27214
27215 #. type: textblock
27216 #: ../src/guestfs-actions.pod:524
27217 msgid ""
27218 "This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and "
27219 "sorting the resulting nodes into alphabetical order."
27220 msgstr ""
27221
27222 #. type: textblock
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
27245 msgid ""
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>."
27249 msgstr ""
27250
27251 #. type: textblock
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)"
27265
27266 #. type: =head2
27267 #: ../src/guestfs-actions.pod:533
27268 msgid "guestfs_aug_match"
27269 msgstr "guestfs_aug_match"
27270
27271 #. type: verbatim
27272 #: ../src/guestfs-actions.pod:535
27273 #, no-wrap
27274 msgid ""
27275 " char **\n"
27276 " guestfs_aug_match (guestfs_h *g,\n"
27277 "                    const char *augpath);\n"
27278 "\n"
27279 msgstr ""
27280 " char **\n"
27281 " guestfs_aug_match (guestfs_h *g,\n"
27282 "                    const char *augpath);\n"
27283 "\n"
27284
27285 #. type: =head2
27286 #: ../src/guestfs-actions.pod:549
27287 msgid "guestfs_aug_mv"
27288 msgstr "guestfs_aug_mv"
27289
27290 #. type: verbatim
27291 #: ../src/guestfs-actions.pod:551
27292 #, no-wrap
27293 msgid ""
27294 " int\n"
27295 " guestfs_aug_mv (guestfs_h *g,\n"
27296 "                 const char *src,\n"
27297 "                 const char *dest);\n"
27298 "\n"
27299 msgstr ""
27300 " int\n"
27301 " guestfs_aug_mv (guestfs_h *g,\n"
27302 "                 const char *src,\n"
27303 "                 const char *dest);\n"
27304 "\n"
27305
27306 #. type: =head2
27307 #: ../src/guestfs-actions.pod:563
27308 msgid "guestfs_aug_rm"
27309 msgstr "guestfs_aug_rm"
27310
27311 #. type: verbatim
27312 #: ../src/guestfs-actions.pod:565
27313 #, no-wrap
27314 msgid ""
27315 " int\n"
27316 " guestfs_aug_rm (guestfs_h *g,\n"
27317 "                 const char *augpath);\n"
27318 "\n"
27319 msgstr ""
27320 " int\n"
27321 " guestfs_aug_rm (guestfs_h *g,\n"
27322 "                 const char *augpath);\n"
27323 "\n"
27324
27325 #. type: =head2
27326 #: ../src/guestfs-actions.pod:577
27327 msgid "guestfs_aug_save"
27328 msgstr "guestfs_aug_save"
27329
27330 #. type: verbatim
27331 #: ../src/guestfs-actions.pod:579
27332 #, no-wrap
27333 msgid ""
27334 " int\n"
27335 " guestfs_aug_save (guestfs_h *g);\n"
27336 "\n"
27337 msgstr ""
27338 " int\n"
27339 " guestfs_aug_save (guestfs_h *g);\n"
27340 "\n"
27341
27342 #. type: textblock
27343 #: ../src/guestfs-actions.pod:584
27344 msgid ""
27345 "The flags which were passed to C<guestfs_aug_init> affect exactly how files "
27346 "are saved."
27347 msgstr ""
27348
27349 #. type: =head2
27350 #: ../src/guestfs-actions.pod:591
27351 msgid "guestfs_aug_set"
27352 msgstr "guestfs_aug_set"
27353
27354 #. type: verbatim
27355 #: ../src/guestfs-actions.pod:593
27356 #, no-wrap
27357 msgid ""
27358 " int\n"
27359 " guestfs_aug_set (guestfs_h *g,\n"
27360 "                  const char *augpath,\n"
27361 "                  const char *val);\n"
27362 "\n"
27363 msgstr ""
27364 " int\n"
27365 " guestfs_aug_set (guestfs_h *g,\n"
27366 "                  const char *augpath,\n"
27367 "                  const char *val);\n"
27368 "\n"
27369
27370 #. type: textblock
27371 #: ../src/guestfs-actions.pod:600
27372 msgid ""
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."
27376 msgstr ""
27377
27378 #. type: =head2
27379 #: ../src/guestfs-actions.pod:609
27380 msgid "guestfs_available"
27381 msgstr "guestfs_available"
27382
27383 #. type: verbatim
27384 #: ../src/guestfs-actions.pod:611
27385 #, no-wrap
27386 msgid ""
27387 " int\n"
27388 " guestfs_available (guestfs_h *g,\n"
27389 "                    char *const *groups);\n"
27390 "\n"
27391 msgstr ""
27392 " int\n"
27393 " guestfs_available (guestfs_h *g,\n"
27394 "                    char *const *groups);\n"
27395 "\n"
27396
27397 #. type: textblock
27398 #: ../src/guestfs-actions.pod:619
27399 msgid ""
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>."
27403 msgstr ""
27404
27405 #. type: textblock
27406 #: ../src/guestfs-actions.pod:643
27407 msgid "You must call C<guestfs_launch> before calling this function."
27408 msgstr ""
27409
27410 #. type: textblock
27411 #: ../src/guestfs-actions.pod:665
27412 msgid ""
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>."
27416 msgstr ""
27417
27418 #. type: textblock
27419 #: ../src/guestfs-actions.pod:674 ../src/guestfs-actions.pod:1653
27420 msgid "(Added in 1.0.80)"
27421 msgstr "(Додано у 1.0.80)"
27422
27423 #. type: =head2
27424 #: ../src/guestfs-actions.pod:676
27425 msgid "guestfs_available_all_groups"
27426 msgstr "guestfs_available_all_groups"
27427
27428 #. type: verbatim
27429 #: ../src/guestfs-actions.pod:678
27430 #, no-wrap
27431 msgid ""
27432 " char **\n"
27433 " guestfs_available_all_groups (guestfs_h *g);\n"
27434 "\n"
27435 msgstr ""
27436 " char **\n"
27437 " guestfs_available_all_groups (guestfs_h *g);\n"
27438 "\n"
27439
27440 #. type: textblock
27441 #: ../src/guestfs-actions.pod:681
27442 msgid ""
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."
27447 msgstr ""
27448
27449 #. type: textblock
27450 #: ../src/guestfs-actions.pod:687
27451 msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>."
27452 msgstr ""
27453
27454 #. type: textblock
27455 #: ../src/guestfs-actions.pod:693
27456 msgid "(Added in 1.3.15)"
27457 msgstr "(Додано у 1.3.15)"
27458
27459 #. type: =head2
27460 #: ../src/guestfs-actions.pod:695
27461 msgid "guestfs_base64_in"
27462 msgstr "guestfs_base64_in"
27463
27464 #. type: verbatim
27465 #: ../src/guestfs-actions.pod:697
27466 #, no-wrap
27467 msgid ""
27468 " int\n"
27469 " guestfs_base64_in (guestfs_h *g,\n"
27470 "                    const char *base64file,\n"
27471 "                    const char *filename);\n"
27472 "\n"
27473 msgstr ""
27474 " int\n"
27475 " guestfs_base64_in (guestfs_h *g,\n"
27476 "                    const char *base64file,\n"
27477 "                    const char *filename);\n"
27478 "\n"
27479
27480 #. type: textblock
27481 #: ../src/guestfs-actions.pod:707 ../src/guestfs-actions.pod:721
27482 msgid "(Added in 1.3.5)"
27483 msgstr "(Додано у 1.3.5)"
27484
27485 #. type: =head2
27486 #: ../src/guestfs-actions.pod:709
27487 msgid "guestfs_base64_out"
27488 msgstr "guestfs_base64_out"
27489
27490 #. type: verbatim
27491 #: ../src/guestfs-actions.pod:711
27492 #, no-wrap
27493 msgid ""
27494 " int\n"
27495 " guestfs_base64_out (guestfs_h *g,\n"
27496 "                     const char *filename,\n"
27497 "                     const char *base64file);\n"
27498 "\n"
27499 msgstr ""
27500 " int\n"
27501 " guestfs_base64_out (guestfs_h *g,\n"
27502 "                     const char *filename,\n"
27503 "                     const char *base64file);\n"
27504 "\n"
27505
27506 #. type: =head2
27507 #: ../src/guestfs-actions.pod:723
27508 msgid "guestfs_blockdev_flushbufs"
27509 msgstr "guestfs_blockdev_flushbufs"
27510
27511 #. type: verbatim
27512 #: ../src/guestfs-actions.pod:725
27513 #, no-wrap
27514 msgid ""
27515 " int\n"
27516 " guestfs_blockdev_flushbufs (guestfs_h *g,\n"
27517 "                             const char *device);\n"
27518 "\n"
27519 msgstr ""
27520 " int\n"
27521 " guestfs_blockdev_flushbufs (guestfs_h *g,\n"
27522 "                             const char *device);\n"
27523 "\n"
27524
27525 #. type: textblock
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)"
27533
27534 #. type: =head2
27535 #: ../src/guestfs-actions.pod:738
27536 msgid "guestfs_blockdev_getbsz"
27537 msgstr "guestfs_blockdev_getbsz"
27538
27539 #. type: verbatim
27540 #: ../src/guestfs-actions.pod:740
27541 #, no-wrap
27542 msgid ""
27543 " int\n"
27544 " guestfs_blockdev_getbsz (guestfs_h *g,\n"
27545 "                          const char *device);\n"
27546 "\n"
27547 msgstr ""
27548 " int\n"
27549 " guestfs_blockdev_getbsz (guestfs_h *g,\n"
27550 "                          const char *device);\n"
27551 "\n"
27552
27553 #. type: =head2
27554 #: ../src/guestfs-actions.pod:755
27555 msgid "guestfs_blockdev_getro"
27556 msgstr "guestfs_blockdev_getro"
27557
27558 #. type: verbatim
27559 #: ../src/guestfs-actions.pod:757
27560 #, no-wrap
27561 msgid ""
27562 " int\n"
27563 " guestfs_blockdev_getro (guestfs_h *g,\n"
27564 "                         const char *device);\n"
27565 "\n"
27566 msgstr ""
27567 " int\n"
27568 " guestfs_blockdev_getro (guestfs_h *g,\n"
27569 "                         const char *device);\n"
27570 "\n"
27571
27572 #. type: textblock
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."
27589 msgstr ""
27590
27591 #. type: =head2
27592 #: ../src/guestfs-actions.pod:770
27593 msgid "guestfs_blockdev_getsize64"
27594 msgstr "guestfs_blockdev_getsize64"
27595
27596 #. type: verbatim
27597 #: ../src/guestfs-actions.pod:772
27598 #, no-wrap
27599 msgid ""
27600 " int64_t\n"
27601 " guestfs_blockdev_getsize64 (guestfs_h *g,\n"
27602 "                             const char *device);\n"
27603 "\n"
27604 msgstr ""
27605 " int64_t\n"
27606 " guestfs_blockdev_getsize64 (guestfs_h *g,\n"
27607 "                             const char *device);\n"
27608 "\n"
27609
27610 #. type: textblock
27611 #: ../src/guestfs-actions.pod:778
27612 msgid "See also C<guestfs_blockdev_getsz>."
27613 msgstr ""
27614
27615 #. type: =head2
27616 #: ../src/guestfs-actions.pod:786
27617 msgid "guestfs_blockdev_getss"
27618 msgstr "guestfs_blockdev_getss"
27619
27620 #. type: verbatim
27621 #: ../src/guestfs-actions.pod:788
27622 #, no-wrap
27623 msgid ""
27624 " int\n"
27625 " guestfs_blockdev_getss (guestfs_h *g,\n"
27626 "                         const char *device);\n"
27627 "\n"
27628 msgstr ""
27629 " int\n"
27630 " guestfs_blockdev_getss (guestfs_h *g,\n"
27631 "                         const char *device);\n"
27632 "\n"
27633
27634 #. type: textblock
27635 #: ../src/guestfs-actions.pod:795
27636 msgid ""
27637 "(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for "
27638 "that)."
27639 msgstr ""
27640
27641 #. type: =head2
27642 #: ../src/guestfs-actions.pod:804
27643 msgid "guestfs_blockdev_getsz"
27644 msgstr "guestfs_blockdev_getsz"
27645
27646 #. type: verbatim
27647 #: ../src/guestfs-actions.pod:806
27648 #, no-wrap
27649 msgid ""
27650 " int64_t\n"
27651 " guestfs_blockdev_getsz (guestfs_h *g,\n"
27652 "                         const char *device);\n"
27653 "\n"
27654 msgstr ""
27655 " int64_t\n"
27656 " guestfs_blockdev_getsz (guestfs_h *g,\n"
27657 "                         const char *device);\n"
27658 "\n"
27659
27660 #. type: textblock
27661 #: ../src/guestfs-actions.pod:813
27662 msgid ""
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>."
27665 msgstr ""
27666
27667 #. type: =head2
27668 #: ../src/guestfs-actions.pod:823
27669 msgid "guestfs_blockdev_rereadpt"
27670 msgstr "guestfs_blockdev_rereadpt"
27671
27672 #. type: verbatim
27673 #: ../src/guestfs-actions.pod:825
27674 #, no-wrap
27675 msgid ""
27676 " int\n"
27677 " guestfs_blockdev_rereadpt (guestfs_h *g,\n"
27678 "                            const char *device);\n"
27679 "\n"
27680 msgstr ""
27681 " int\n"
27682 " guestfs_blockdev_rereadpt (guestfs_h *g,\n"
27683 "                            const char *device);\n"
27684 "\n"
27685
27686 #. type: =head2
27687 #: ../src/guestfs-actions.pod:837
27688 msgid "guestfs_blockdev_setbsz"
27689 msgstr "guestfs_blockdev_setbsz"
27690
27691 #. type: verbatim
27692 #: ../src/guestfs-actions.pod:839
27693 #, no-wrap
27694 msgid ""
27695 " int\n"
27696 " guestfs_blockdev_setbsz (guestfs_h *g,\n"
27697 "                          const char *device,\n"
27698 "                          int blocksize);\n"
27699 "\n"
27700 msgstr ""
27701 " int\n"
27702 " guestfs_blockdev_setbsz (guestfs_h *g,\n"
27703 "                          const char *device,\n"
27704 "                          int blocksize);\n"
27705 "\n"
27706
27707 #. type: =head2
27708 #: ../src/guestfs-actions.pod:855
27709 msgid "guestfs_blockdev_setro"
27710 msgstr "guestfs_blockdev_setro"
27711
27712 #. type: verbatim
27713 #: ../src/guestfs-actions.pod:857
27714 #, no-wrap
27715 msgid ""
27716 " int\n"
27717 " guestfs_blockdev_setro (guestfs_h *g,\n"
27718 "                         const char *device);\n"
27719 "\n"
27720 msgstr ""
27721 " int\n"
27722 " guestfs_blockdev_setro (guestfs_h *g,\n"
27723 "                         const char *device);\n"
27724 "\n"
27725
27726 #. type: =head2
27727 #: ../src/guestfs-actions.pod:869
27728 msgid "guestfs_blockdev_setrw"
27729 msgstr "guestfs_blockdev_setrw"
27730
27731 #. type: verbatim
27732 #: ../src/guestfs-actions.pod:871
27733 #, no-wrap
27734 msgid ""
27735 " int\n"
27736 " guestfs_blockdev_setrw (guestfs_h *g,\n"
27737 "                         const char *device);\n"
27738 "\n"
27739 msgstr ""
27740 " int\n"
27741 " guestfs_blockdev_setrw (guestfs_h *g,\n"
27742 "                         const char *device);\n"
27743 "\n"
27744
27745 #. type: =head2
27746 #: ../src/guestfs-actions.pod:883
27747 msgid "guestfs_btrfs_filesystem_resize"
27748 msgstr "guestfs_btrfs_filesystem_resize"
27749
27750 #. type: verbatim
27751 #: ../src/guestfs-actions.pod:885
27752 #, no-wrap
27753 msgid ""
27754 " int\n"
27755 " guestfs_btrfs_filesystem_resize (guestfs_h *g,\n"
27756 "                                  const char *mountpoint,\n"
27757 "                                  ...);\n"
27758 "\n"
27759 msgstr ""
27760 " int\n"
27761 " guestfs_btrfs_filesystem_resize (guestfs_h *g,\n"
27762 "                                  const char *mountpoint,\n"
27763 "                                  ...);\n"
27764 "\n"
27765
27766 #. type: verbatim
27767 #: ../src/guestfs-actions.pod:895
27768 #, no-wrap
27769 msgid ""
27770 " GUESTFS_BTRFS_FILESYSTEM_RESIZE_SIZE, int64_t size,\n"
27771 "\n"
27772 msgstr ""
27773 " GUESTFS_BTRFS_FILESYSTEM_RESIZE_SIZE, int64_t size,\n"
27774 "\n"
27775
27776 #. type: textblock
27777 #: ../src/guestfs-actions.pod:918
27778 msgid "(Added in 1.11.17)"
27779 msgstr "(Додано у 1.11.17)"
27780
27781 #. type: =head2
27782 #: ../src/guestfs-actions.pod:920
27783 msgid "guestfs_btrfs_filesystem_resize_va"
27784 msgstr "guestfs_btrfs_filesystem_resize_va"
27785
27786 #. type: verbatim
27787 #: ../src/guestfs-actions.pod:922
27788 #, no-wrap
27789 msgid ""
27790 " int\n"
27791 " guestfs_btrfs_filesystem_resize_va (guestfs_h *g,\n"
27792 "                                     const char *mountpoint,\n"
27793 "                                     va_list args);\n"
27794 "\n"
27795 msgstr ""
27796 " int\n"
27797 " guestfs_btrfs_filesystem_resize_va (guestfs_h *g,\n"
27798 "                                     const char *mountpoint,\n"
27799 "                                     va_list args);\n"
27800 "\n"
27801
27802 #. type: textblock
27803 #: ../src/guestfs-actions.pod:927
27804 msgid "This is the \"va_list variant\" of L</guestfs_btrfs_filesystem_resize>."
27805 msgstr ""
27806
27807 #. type: =head2
27808 #: ../src/guestfs-actions.pod:931
27809 msgid "guestfs_btrfs_filesystem_resize_argv"
27810 msgstr "guestfs_btrfs_filesystem_resize_argv"
27811
27812 #. type: verbatim
27813 #: ../src/guestfs-actions.pod:933
27814 #, no-wrap
27815 msgid ""
27816 " int\n"
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"
27820 "\n"
27821 msgstr ""
27822 " int\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"
27826 "\n"
27827
27828 #. type: textblock
27829 #: ../src/guestfs-actions.pod:938
27830 msgid "This is the \"argv variant\" of L</guestfs_btrfs_filesystem_resize>."
27831 msgstr ""
27832
27833 #. type: =head2
27834 #: ../src/guestfs-actions.pod:942
27835 msgid "guestfs_case_sensitive_path"
27836 msgstr ""
27837
27838 #. type: verbatim
27839 #: ../src/guestfs-actions.pod:944
27840 #, no-wrap
27841 msgid ""
27842 " char *\n"
27843 " guestfs_case_sensitive_path (guestfs_h *g,\n"
27844 "                              const char *path);\n"
27845 "\n"
27846 msgstr ""
27847
27848 #. type: textblock
27849 #: ../src/guestfs-actions.pod:970
27850 msgid ""
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)."
27854 msgstr ""
27855
27856 #. type: textblock
27857 #: ../src/guestfs-actions.pod:978
27858 msgid "See also C<guestfs_realpath>."
27859 msgstr ""
27860
27861 #. type: textblock
27862 #: ../src/guestfs-actions.pod:983 ../src/guestfs-actions.pod:8125
27863 msgid "(Added in 1.0.75)"
27864 msgstr "(Додано у 1.0.75)"
27865
27866 #. type: =head2
27867 #: ../src/guestfs-actions.pod:985
27868 msgid "guestfs_cat"
27869 msgstr ""
27870
27871 #. type: verbatim
27872 #: ../src/guestfs-actions.pod:987
27873 #, no-wrap
27874 msgid ""
27875 " char *\n"
27876 " guestfs_cat (guestfs_h *g,\n"
27877 "              const char *path);\n"
27878 "\n"
27879 msgstr ""
27880
27881 #. type: textblock
27882 #: ../src/guestfs-actions.pod:993
27883 msgid ""
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."
27888 msgstr ""
27889
27890 #. type: textblock
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)"
27899
27900 #. type: =head2
27901 #: ../src/guestfs-actions.pod:1006
27902 msgid "guestfs_checksum"
27903 msgstr ""
27904
27905 #. type: verbatim
27906 #: ../src/guestfs-actions.pod:1008
27907 #, no-wrap
27908 msgid ""
27909 " char *\n"
27910 " guestfs_checksum (guestfs_h *g,\n"
27911 "                   const char *csumtype,\n"
27912 "                   const char *path);\n"
27913 "\n"
27914 msgstr ""
27915
27916 #. type: textblock
27917 #: ../src/guestfs-actions.pod:1054
27918 msgid "To get the checksum for a device, use C<guestfs_checksum_device>."
27919 msgstr ""
27920
27921 #. type: textblock
27922 #: ../src/guestfs-actions.pod:1056
27923 msgid "To get the checksums for many files, use C<guestfs_checksums_out>."
27924 msgstr ""
27925
27926 #. type: textblock
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)"
27933
27934 #. type: =head2
27935 #: ../src/guestfs-actions.pod:1063
27936 msgid "guestfs_checksum_device"
27937 msgstr ""
27938
27939 #. type: verbatim
27940 #: ../src/guestfs-actions.pod:1065
27941 #, no-wrap
27942 msgid ""
27943 " char *\n"
27944 " guestfs_checksum_device (guestfs_h *g,\n"
27945 "                          const char *csumtype,\n"
27946 "                          const char *device);\n"
27947 "\n"
27948 msgstr ""
27949
27950 #. type: textblock
27951 #: ../src/guestfs-actions.pod:1070
27952 msgid ""
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."
27956 msgstr ""
27957
27958 #. type: textblock
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)"
27966
27967 #. type: =head2
27968 #: ../src/guestfs-actions.pod:1079
27969 msgid "guestfs_checksums_out"
27970 msgstr ""
27971
27972 #. type: verbatim
27973 #: ../src/guestfs-actions.pod:1081
27974 #, no-wrap
27975 msgid ""
27976 " int\n"
27977 " guestfs_checksums_out (guestfs_h *g,\n"
27978 "                        const char *csumtype,\n"
27979 "                        const char *directory,\n"
27980 "                        const char *sumsfile);\n"
27981 "\n"
27982 msgstr ""
27983
27984 #. type: textblock
27985 #: ../src/guestfs-actions.pod:1101
27986 msgid "(Added in 1.3.7)"
27987 msgstr "(Додано у 1.3.7)"
27988
27989 #. type: =head2
27990 #: ../src/guestfs-actions.pod:1103
27991 msgid "guestfs_chmod"
27992 msgstr ""
27993
27994 #. type: verbatim
27995 #: ../src/guestfs-actions.pod:1105
27996 #, no-wrap
27997 msgid ""
27998 " int\n"
27999 " guestfs_chmod (guestfs_h *g,\n"
28000 "                int mode,\n"
28001 "                const char *path);\n"
28002 "\n"
28003 msgstr ""
28004
28005 #. type: =head2
28006 #: ../src/guestfs-actions.pod:1123
28007 msgid "guestfs_chown"
28008 msgstr ""
28009
28010 #. type: verbatim
28011 #: ../src/guestfs-actions.pod:1125
28012 #, no-wrap
28013 msgid ""
28014 " int\n"
28015 " guestfs_chown (guestfs_h *g,\n"
28016 "                int owner,\n"
28017 "                int group,\n"
28018 "                const char *path);\n"
28019 "\n"
28020 msgstr ""
28021
28022 #. type: =head2
28023 #: ../src/guestfs-actions.pod:1141
28024 msgid "guestfs_command"
28025 msgstr ""
28026
28027 #. type: verbatim
28028 #: ../src/guestfs-actions.pod:1143
28029 #, no-wrap
28030 msgid ""
28031 " char *\n"
28032 " guestfs_command (guestfs_h *g,\n"
28033 "                  char *const *arguments);\n"
28034 "\n"
28035 msgstr ""
28036
28037 #. type: textblock
28038 #: ../src/guestfs-actions.pod:1152
28039 msgid ""
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 "
28044 "C<guestfs_sh>)."
28045 msgstr ""
28046
28047 #. type: textblock
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)"
28052
28053 #. type: =head2
28054 #: ../src/guestfs-actions.pod:1185
28055 msgid "guestfs_command_lines"
28056 msgstr ""
28057
28058 #. type: verbatim
28059 #: ../src/guestfs-actions.pod:1187
28060 #, no-wrap
28061 msgid ""
28062 " char **\n"
28063 " guestfs_command_lines (guestfs_h *g,\n"
28064 "                        char *const *arguments);\n"
28065 "\n"
28066 msgstr ""
28067
28068 #. type: textblock
28069 #: ../src/guestfs-actions.pod:1191
28070 msgid ""
28071 "This is the same as C<guestfs_command>, but splits the result into a list of "
28072 "lines."
28073 msgstr ""
28074
28075 #. type: textblock
28076 #: ../src/guestfs-actions.pod:1194
28077 msgid "See also: C<guestfs_sh_lines>"
28078 msgstr ""
28079
28080 #. type: =head2
28081 #: ../src/guestfs-actions.pod:1205
28082 msgid "guestfs_compress_device_out"
28083 msgstr ""
28084
28085 #. type: verbatim
28086 #: ../src/guestfs-actions.pod:1207
28087 #, no-wrap
28088 msgid ""
28089 " int\n"
28090 " guestfs_compress_device_out (guestfs_h *g,\n"
28091 "                              const char *ctype,\n"
28092 "                              const char *device,\n"
28093 "                              const char *zdevice,\n"
28094 "                              ...);\n"
28095 "\n"
28096 msgstr ""
28097
28098 #. type: verbatim
28099 #: ../src/guestfs-actions.pod:1219
28100 #, no-wrap
28101 msgid ""
28102 " GUESTFS_COMPRESS_DEVICE_OUT_LEVEL, int level,\n"
28103 "\n"
28104 msgstr ""
28105
28106 #. type: textblock
28107 #: ../src/guestfs-actions.pod:1224
28108 msgid ""
28109 "The C<ctype> and optional C<level> parameters have the same meaning as in "
28110 "C<guestfs_compress_out>."
28111 msgstr ""
28112
28113 #. type: textblock
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)"
28117 msgstr ""
28118
28119 #. type: =head2
28120 #: ../src/guestfs-actions.pod:1231
28121 msgid "guestfs_compress_device_out_va"
28122 msgstr ""
28123
28124 #. type: verbatim
28125 #: ../src/guestfs-actions.pod:1233
28126 #, no-wrap
28127 msgid ""
28128 " int\n"
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"
28134 "\n"
28135 msgstr ""
28136
28137 #. type: textblock
28138 #: ../src/guestfs-actions.pod:1240
28139 msgid "This is the \"va_list variant\" of L</guestfs_compress_device_out>."
28140 msgstr ""
28141
28142 #. type: =head2
28143 #: ../src/guestfs-actions.pod:1244
28144 msgid "guestfs_compress_device_out_argv"
28145 msgstr ""
28146
28147 #. type: verbatim
28148 #: ../src/guestfs-actions.pod:1246
28149 #, no-wrap
28150 msgid ""
28151 " int\n"
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"
28157 "\n"
28158 msgstr ""
28159
28160 #. type: textblock
28161 #: ../src/guestfs-actions.pod:1253
28162 msgid "This is the \"argv variant\" of L</guestfs_compress_device_out>."
28163 msgstr ""
28164
28165 #. type: =head2
28166 #: ../src/guestfs-actions.pod:1257
28167 msgid "guestfs_compress_out"
28168 msgstr ""
28169
28170 #. type: verbatim
28171 #: ../src/guestfs-actions.pod:1259
28172 #, no-wrap
28173 msgid ""
28174 " int\n"
28175 " guestfs_compress_out (guestfs_h *g,\n"
28176 "                       const char *ctype,\n"
28177 "                       const char *file,\n"
28178 "                       const char *zfile,\n"
28179 "                       ...);\n"
28180 "\n"
28181 msgstr ""
28182
28183 #. type: verbatim
28184 #: ../src/guestfs-actions.pod:1271
28185 #, no-wrap
28186 msgid ""
28187 " GUESTFS_COMPRESS_OUT_LEVEL, int level,\n"
28188 "\n"
28189 msgstr ""
28190
28191 #. type: =head2
28192 #: ../src/guestfs-actions.pod:1290
28193 msgid "guestfs_compress_out_va"
28194 msgstr ""
28195
28196 #. type: verbatim
28197 #: ../src/guestfs-actions.pod:1292
28198 #, no-wrap
28199 msgid ""
28200 " int\n"
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"
28206 "\n"
28207 msgstr ""
28208
28209 #. type: textblock
28210 #: ../src/guestfs-actions.pod:1299
28211 msgid "This is the \"va_list variant\" of L</guestfs_compress_out>."
28212 msgstr ""
28213
28214 #. type: =head2
28215 #: ../src/guestfs-actions.pod:1303
28216 msgid "guestfs_compress_out_argv"
28217 msgstr ""
28218
28219 #. type: verbatim
28220 #: ../src/guestfs-actions.pod:1305
28221 #, no-wrap
28222 msgid ""
28223 " int\n"
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"
28229 "\n"
28230 msgstr ""
28231
28232 #. type: textblock
28233 #: ../src/guestfs-actions.pod:1312
28234 msgid "This is the \"argv variant\" of L</guestfs_compress_out>."
28235 msgstr ""
28236
28237 #. type: =head2
28238 #: ../src/guestfs-actions.pod:1316
28239 msgid "guestfs_config"
28240 msgstr ""
28241
28242 #. type: verbatim
28243 #: ../src/guestfs-actions.pod:1318
28244 #, no-wrap
28245 msgid ""
28246 " int\n"
28247 " guestfs_config (guestfs_h *g,\n"
28248 "                 const char *qemuparam,\n"
28249 "                 const char *qemuvalue);\n"
28250 "\n"
28251 msgstr ""
28252
28253 #. type: =head2
28254 #: ../src/guestfs-actions.pod:1336
28255 msgid "guestfs_copy_device_to_device"
28256 msgstr ""
28257
28258 #. type: verbatim
28259 #: ../src/guestfs-actions.pod:1338
28260 #, no-wrap
28261 msgid ""
28262 " int\n"
28263 " guestfs_copy_device_to_device (guestfs_h *g,\n"
28264 "                                const char *src,\n"
28265 "                                const char *dest,\n"
28266 "                                ...);\n"
28267 "\n"
28268 msgstr ""
28269
28270 #. type: verbatim
28271 #: ../src/guestfs-actions.pod:1349
28272 #, no-wrap
28273 msgid ""
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"
28277 "\n"
28278 msgstr ""
28279
28280 #. type: textblock
28281 #: ../src/guestfs-actions.pod:1353
28282 msgid ""
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)."
28287 msgstr ""
28288
28289 #. type: textblock
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
28298 msgid ""
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>."
28303 msgstr ""
28304
28305 #. type: textblock
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
28309 #, fuzzy
28310 #| msgid "(Added in 1.3.5)"
28311 msgid "(Added in 1.13.25)"
28312 msgstr "(Додано у 1.3.5)"
28313
28314 #. type: =head2
28315 #: ../src/guestfs-actions.pod:1381
28316 msgid "guestfs_copy_device_to_device_va"
28317 msgstr ""
28318
28319 #. type: verbatim
28320 #: ../src/guestfs-actions.pod:1383
28321 #, no-wrap
28322 msgid ""
28323 " int\n"
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"
28328 "\n"
28329 msgstr ""
28330
28331 #. type: textblock
28332 #: ../src/guestfs-actions.pod:1389
28333 msgid "This is the \"va_list variant\" of L</guestfs_copy_device_to_device>."
28334 msgstr ""
28335
28336 #. type: =head2
28337 #: ../src/guestfs-actions.pod:1393
28338 msgid "guestfs_copy_device_to_device_argv"
28339 msgstr ""
28340
28341 #. type: verbatim
28342 #: ../src/guestfs-actions.pod:1395
28343 #, no-wrap
28344 msgid ""
28345 " int\n"
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"
28350 "\n"
28351 msgstr ""
28352
28353 #. type: textblock
28354 #: ../src/guestfs-actions.pod:1401
28355 msgid "This is the \"argv variant\" of L</guestfs_copy_device_to_device>."
28356 msgstr ""
28357
28358 #. type: =head2
28359 #: ../src/guestfs-actions.pod:1405
28360 msgid "guestfs_copy_device_to_file"
28361 msgstr ""
28362
28363 #. type: verbatim
28364 #: ../src/guestfs-actions.pod:1407
28365 #, no-wrap
28366 msgid ""
28367 " int\n"
28368 " guestfs_copy_device_to_file (guestfs_h *g,\n"
28369 "                              const char *src,\n"
28370 "                              const char *dest,\n"
28371 "                              ...);\n"
28372 "\n"
28373 msgstr ""
28374
28375 #. type: verbatim
28376 #: ../src/guestfs-actions.pod:1418
28377 #, no-wrap
28378 msgid ""
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"
28382 "\n"
28383 msgstr ""
28384
28385 #. type: textblock
28386 #: ../src/guestfs-actions.pod:1422 ../src/guestfs-actions.pod:1475
28387 #: ../src/guestfs-actions.pod:1528
28388 msgid ""
28389 "See C<guestfs_copy_device_to_device> for a general overview of this call."
28390 msgstr ""
28391
28392 #. type: =head2
28393 #: ../src/guestfs-actions.pod:1434
28394 msgid "guestfs_copy_device_to_file_va"
28395 msgstr ""
28396
28397 #. type: verbatim
28398 #: ../src/guestfs-actions.pod:1436
28399 #, no-wrap
28400 msgid ""
28401 " int\n"
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"
28406 "\n"
28407 msgstr ""
28408
28409 #. type: textblock
28410 #: ../src/guestfs-actions.pod:1442
28411 msgid "This is the \"va_list variant\" of L</guestfs_copy_device_to_file>."
28412 msgstr ""
28413
28414 #. type: =head2
28415 #: ../src/guestfs-actions.pod:1446
28416 msgid "guestfs_copy_device_to_file_argv"
28417 msgstr ""
28418
28419 #. type: verbatim
28420 #: ../src/guestfs-actions.pod:1448
28421 #, no-wrap
28422 msgid ""
28423 " int\n"
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"
28428 "\n"
28429 msgstr ""
28430
28431 #. type: textblock
28432 #: ../src/guestfs-actions.pod:1454
28433 msgid "This is the \"argv variant\" of L</guestfs_copy_device_to_file>."
28434 msgstr ""
28435
28436 #. type: =head2
28437 #: ../src/guestfs-actions.pod:1458
28438 msgid "guestfs_copy_file_to_device"
28439 msgstr ""
28440
28441 #. type: verbatim
28442 #: ../src/guestfs-actions.pod:1460
28443 #, no-wrap
28444 msgid ""
28445 " int\n"
28446 " guestfs_copy_file_to_device (guestfs_h *g,\n"
28447 "                              const char *src,\n"
28448 "                              const char *dest,\n"
28449 "                              ...);\n"
28450 "\n"
28451 msgstr ""
28452
28453 #. type: verbatim
28454 #: ../src/guestfs-actions.pod:1471
28455 #, no-wrap
28456 msgid ""
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"
28460 "\n"
28461 msgstr ""
28462
28463 #. type: =head2
28464 #: ../src/guestfs-actions.pod:1487
28465 msgid "guestfs_copy_file_to_device_va"
28466 msgstr ""
28467
28468 #. type: verbatim
28469 #: ../src/guestfs-actions.pod:1489
28470 #, no-wrap
28471 msgid ""
28472 " int\n"
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"
28477 "\n"
28478 msgstr ""
28479
28480 #. type: textblock
28481 #: ../src/guestfs-actions.pod:1495
28482 msgid "This is the \"va_list variant\" of L</guestfs_copy_file_to_device>."
28483 msgstr ""
28484
28485 #. type: =head2
28486 #: ../src/guestfs-actions.pod:1499
28487 msgid "guestfs_copy_file_to_device_argv"
28488 msgstr ""
28489
28490 #. type: verbatim
28491 #: ../src/guestfs-actions.pod:1501
28492 #, no-wrap
28493 msgid ""
28494 " int\n"
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"
28499 "\n"
28500 msgstr ""
28501
28502 #. type: textblock
28503 #: ../src/guestfs-actions.pod:1507
28504 msgid "This is the \"argv variant\" of L</guestfs_copy_file_to_device>."
28505 msgstr ""
28506
28507 #. type: =head2
28508 #: ../src/guestfs-actions.pod:1511
28509 msgid "guestfs_copy_file_to_file"
28510 msgstr ""
28511
28512 #. type: verbatim
28513 #: ../src/guestfs-actions.pod:1513
28514 #, no-wrap
28515 msgid ""
28516 " int\n"
28517 " guestfs_copy_file_to_file (guestfs_h *g,\n"
28518 "                            const char *src,\n"
28519 "                            const char *dest,\n"
28520 "                            ...);\n"
28521 "\n"
28522 msgstr ""
28523
28524 #. type: verbatim
28525 #: ../src/guestfs-actions.pod:1524
28526 #, no-wrap
28527 msgid ""
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"
28531 "\n"
28532 msgstr ""
28533
28534 #. type: textblock
28535 #: ../src/guestfs-actions.pod:1531
28536 msgid ""
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."
28540 msgstr ""
28541
28542 #. type: =head2
28543 #: ../src/guestfs-actions.pod:1545
28544 msgid "guestfs_copy_file_to_file_va"
28545 msgstr ""
28546
28547 #. type: verbatim
28548 #: ../src/guestfs-actions.pod:1547
28549 #, no-wrap
28550 msgid ""
28551 " int\n"
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"
28556 "\n"
28557 msgstr ""
28558
28559 #. type: textblock
28560 #: ../src/guestfs-actions.pod:1553
28561 msgid "This is the \"va_list variant\" of L</guestfs_copy_file_to_file>."
28562 msgstr ""
28563
28564 #. type: =head2
28565 #: ../src/guestfs-actions.pod:1557
28566 msgid "guestfs_copy_file_to_file_argv"
28567 msgstr ""
28568
28569 #. type: verbatim
28570 #: ../src/guestfs-actions.pod:1559
28571 #, no-wrap
28572 msgid ""
28573 " int\n"
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"
28578 "\n"
28579 msgstr ""
28580
28581 #. type: textblock
28582 #: ../src/guestfs-actions.pod:1565
28583 msgid "This is the \"argv variant\" of L</guestfs_copy_file_to_file>."
28584 msgstr ""
28585
28586 #. type: =head2
28587 #: ../src/guestfs-actions.pod:1569
28588 msgid "guestfs_copy_size"
28589 msgstr ""
28590
28591 #. type: verbatim
28592 #: ../src/guestfs-actions.pod:1571
28593 #, no-wrap
28594 msgid ""
28595 " int\n"
28596 " guestfs_copy_size (guestfs_h *g,\n"
28597 "                    const char *src,\n"
28598 "                    const char *dest,\n"
28599 "                    int64_t size);\n"
28600 "\n"
28601 msgstr ""
28602
28603 #. type: textblock
28604 #: ../src/guestfs-actions.pod:1577 ../src/guestfs-actions.pod:1634
28605 msgid ""
28606 "I<This function is deprecated.> In new code, use the L</"
28607 "guestfs_copy_device_to_device> call instead."
28608 msgstr ""
28609
28610 #. type: textblock
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)"
28616
28617 #. type: =head2
28618 #: ../src/guestfs-actions.pod:1599
28619 msgid "guestfs_cp"
28620 msgstr ""
28621
28622 #. type: verbatim
28623 #: ../src/guestfs-actions.pod:1601
28624 #, no-wrap
28625 msgid ""
28626 " int\n"
28627 " guestfs_cp (guestfs_h *g,\n"
28628 "             const char *src,\n"
28629 "             const char *dest);\n"
28630 "\n"
28631 msgstr ""
28632
28633 #. type: textblock
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)"
28640
28641 #. type: =head2
28642 #: ../src/guestfs-actions.pod:1613
28643 msgid "guestfs_cp_a"
28644 msgstr ""
28645
28646 #. type: verbatim
28647 #: ../src/guestfs-actions.pod:1615
28648 #, no-wrap
28649 msgid ""
28650 " int\n"
28651 " guestfs_cp_a (guestfs_h *g,\n"
28652 "               const char *src,\n"
28653 "               const char *dest);\n"
28654 "\n"
28655 msgstr ""
28656
28657 #. type: =head2
28658 #: ../src/guestfs-actions.pod:1627
28659 msgid "guestfs_dd"
28660 msgstr ""
28661
28662 #. type: verbatim
28663 #: ../src/guestfs-actions.pod:1629
28664 #, no-wrap
28665 msgid ""
28666 " int\n"
28667 " guestfs_dd (guestfs_h *g,\n"
28668 "             const char *src,\n"
28669 "             const char *dest);\n"
28670 "\n"
28671 msgstr ""
28672
28673 #. type: textblock
28674 #: ../src/guestfs-actions.pod:1646
28675 msgid ""
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>)."
28679 msgstr ""
28680
28681 #. type: =head2
28682 #: ../src/guestfs-actions.pod:1655
28683 msgid "guestfs_df"
28684 msgstr ""
28685
28686 #. type: verbatim
28687 #: ../src/guestfs-actions.pod:1657
28688 #, no-wrap
28689 msgid ""
28690 " char *\n"
28691 " guestfs_df (guestfs_h *g);\n"
28692 "\n"
28693 msgstr ""
28694
28695 #. type: textblock
28696 #: ../src/guestfs-actions.pod:1662 ../src/guestfs-actions.pod:1679
28697 msgid ""
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> "
28700 "from programs."
28701 msgstr ""
28702
28703 #. type: textblock
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)"
28713
28714 #. type: =head2
28715 #: ../src/guestfs-actions.pod:1671
28716 msgid "guestfs_df_h"
28717 msgstr ""
28718
28719 #. type: verbatim
28720 #: ../src/guestfs-actions.pod:1673
28721 #, no-wrap
28722 msgid ""
28723 " char *\n"
28724 " guestfs_df_h (guestfs_h *g);\n"
28725 "\n"
28726 msgstr ""
28727
28728 #. type: =head2
28729 #: ../src/guestfs-actions.pod:1688
28730 msgid "guestfs_dmesg"
28731 msgstr ""
28732
28733 #. type: verbatim
28734 #: ../src/guestfs-actions.pod:1690
28735 #, no-wrap
28736 msgid ""
28737 " char *\n"
28738 " guestfs_dmesg (guestfs_h *g);\n"
28739 "\n"
28740 msgstr ""
28741
28742 #. type: textblock
28743 #: ../src/guestfs-actions.pod:1697
28744 msgid ""
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."
28748 msgstr ""
28749
28750 #. type: =head2
28751 #: ../src/guestfs-actions.pod:1707
28752 msgid "guestfs_download"
28753 msgstr ""
28754
28755 #. type: verbatim
28756 #: ../src/guestfs-actions.pod:1709
28757 #, no-wrap
28758 msgid ""
28759 " int\n"
28760 " guestfs_download (guestfs_h *g,\n"
28761 "                   const char *remotefilename,\n"
28762 "                   const char *filename);\n"
28763 "\n"
28764 msgstr ""
28765
28766 #. type: textblock
28767 #: ../src/guestfs-actions.pod:1719
28768 msgid "See also C<guestfs_upload>, C<guestfs_cat>."
28769 msgstr ""
28770
28771 #. type: =head2
28772 #: ../src/guestfs-actions.pod:1730
28773 msgid "guestfs_download_offset"
28774 msgstr ""
28775
28776 #. type: verbatim
28777 #: ../src/guestfs-actions.pod:1732
28778 #, no-wrap
28779 msgid ""
28780 " int\n"
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"
28786 "\n"
28787 msgstr ""
28788
28789 #. type: textblock
28790 #: ../src/guestfs-actions.pod:1745
28791 msgid ""
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."
28795 msgstr ""
28796
28797 #. type: textblock
28798 #: ../src/guestfs-actions.pod:1750
28799 msgid "See also C<guestfs_download>, C<guestfs_pread>."
28800 msgstr ""
28801
28802 #. type: textblock
28803 #: ../src/guestfs-actions.pod:1759 ../src/guestfs-actions.pod:8015
28804 msgid "(Added in 1.5.17)"
28805 msgstr "(Додано у 1.5.17)"
28806
28807 #. type: =head2
28808 #: ../src/guestfs-actions.pod:1761
28809 msgid "guestfs_drop_caches"
28810 msgstr ""
28811
28812 #. type: verbatim
28813 #: ../src/guestfs-actions.pod:1763
28814 #, no-wrap
28815 msgid ""
28816 " int\n"
28817 " guestfs_drop_caches (guestfs_h *g,\n"
28818 "                      int whattodrop);\n"
28819 "\n"
28820 msgstr ""
28821
28822 #. type: =head2
28823 #: ../src/guestfs-actions.pod:1781
28824 msgid "guestfs_du"
28825 msgstr ""
28826
28827 #. type: verbatim
28828 #: ../src/guestfs-actions.pod:1783
28829 #, no-wrap
28830 msgid ""
28831 " int64_t\n"
28832 " guestfs_du (guestfs_h *g,\n"
28833 "             const char *path);\n"
28834 "\n"
28835 msgstr ""
28836
28837 #. type: =head2
28838 #: ../src/guestfs-actions.pod:1806
28839 msgid "guestfs_e2fsck_f"
28840 msgstr ""
28841
28842 #. type: verbatim
28843 #: ../src/guestfs-actions.pod:1808
28844 #, no-wrap
28845 msgid ""
28846 " int\n"
28847 " guestfs_e2fsck_f (guestfs_h *g,\n"
28848 "                   const char *device);\n"
28849 "\n"
28850 msgstr ""
28851
28852 #. type: textblock
28853 #: ../src/guestfs-actions.pod:1816
28854 msgid ""
28855 "This command is only needed because of C<guestfs_resize2fs> (q.v.).  "
28856 "Normally you should use C<guestfs_fsck>."
28857 msgstr ""
28858
28859 #. type: textblock
28860 #: ../src/guestfs-actions.pod:1821
28861 msgid "(Added in 1.0.29)"
28862 msgstr "(Додано у 1.0.29)"
28863
28864 #. type: =head2
28865 #: ../src/guestfs-actions.pod:1823
28866 msgid "guestfs_echo_daemon"
28867 msgstr "guestfs_echo_daemon"
28868
28869 #. type: verbatim
28870 #: ../src/guestfs-actions.pod:1825
28871 #, no-wrap
28872 msgid ""
28873 " char *\n"
28874 " guestfs_echo_daemon (guestfs_h *g,\n"
28875 "                      char *const *words);\n"
28876 "\n"
28877 msgstr ""
28878 " char *\n"
28879 " guestfs_echo_daemon (guestfs_h *g,\n"
28880 "                      char *const *words);\n"
28881 "\n"
28882
28883 #. type: textblock
28884 #: ../src/guestfs-actions.pod:1834
28885 msgid "See also C<guestfs_ping_daemon>."
28886 msgstr ""
28887
28888 #. type: textblock
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)"
28893
28894 #. type: =head2
28895 #: ../src/guestfs-actions.pod:1841
28896 msgid "guestfs_egrep"
28897 msgstr "guestfs_egrep"
28898
28899 #. type: verbatim
28900 #: ../src/guestfs-actions.pod:1843
28901 #, no-wrap
28902 msgid ""
28903 " char **\n"
28904 " guestfs_egrep (guestfs_h *g,\n"
28905 "                const char *regex,\n"
28906 "                const char *path);\n"
28907 "\n"
28908 msgstr ""
28909 " char **\n"
28910 " guestfs_egrep (guestfs_h *g,\n"
28911 "                const char *regex,\n"
28912 "                const char *path);\n"
28913 "\n"
28914
28915 #. type: textblock
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)"
28935
28936 #. type: =head2
28937 #: ../src/guestfs-actions.pod:1860
28938 msgid "guestfs_egrepi"
28939 msgstr "guestfs_egrepi"
28940
28941 #. type: verbatim
28942 #: ../src/guestfs-actions.pod:1862
28943 #, no-wrap
28944 msgid ""
28945 " char **\n"
28946 " guestfs_egrepi (guestfs_h *g,\n"
28947 "                 const char *regex,\n"
28948 "                 const char *path);\n"
28949 "\n"
28950 msgstr ""
28951
28952 #. type: =head2
28953 #: ../src/guestfs-actions.pod:1879
28954 msgid "guestfs_equal"
28955 msgstr ""
28956
28957 #. type: verbatim
28958 #: ../src/guestfs-actions.pod:1881
28959 #, no-wrap
28960 msgid ""
28961 " int\n"
28962 " guestfs_equal (guestfs_h *g,\n"
28963 "                const char *file1,\n"
28964 "                const char *file2);\n"
28965 "\n"
28966 msgstr ""
28967
28968 #. type: =head2
28969 #: ../src/guestfs-actions.pod:1895
28970 msgid "guestfs_exists"
28971 msgstr ""
28972
28973 #. type: verbatim
28974 #: ../src/guestfs-actions.pod:1897
28975 #, no-wrap
28976 msgid ""
28977 " int\n"
28978 " guestfs_exists (guestfs_h *g,\n"
28979 "                 const char *path);\n"
28980 "\n"
28981 msgstr ""
28982
28983 #. type: textblock
28984 #: ../src/guestfs-actions.pod:1904
28985 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>."
28986 msgstr ""
28987
28988 #. type: =head2
28989 #: ../src/guestfs-actions.pod:1910
28990 msgid "guestfs_fallocate"
28991 msgstr ""
28992
28993 #. type: verbatim
28994 #: ../src/guestfs-actions.pod:1912
28995 #, no-wrap
28996 msgid ""
28997 " int\n"
28998 " guestfs_fallocate (guestfs_h *g,\n"
28999 "                    const char *path,\n"
29000 "                    int len);\n"
29001 "\n"
29002 msgstr ""
29003
29004 #. type: textblock
29005 #: ../src/guestfs-actions.pod:1917
29006 msgid ""
29007 "I<This function is deprecated.> In new code, use the L</guestfs_fallocate64> "
29008 "call instead."
29009 msgstr ""
29010
29011 #. type: =head2
29012 #: ../src/guestfs-actions.pod:1936
29013 msgid "guestfs_fallocate64"
29014 msgstr ""
29015
29016 #. type: verbatim
29017 #: ../src/guestfs-actions.pod:1938
29018 #, no-wrap
29019 msgid ""
29020 " int\n"
29021 " guestfs_fallocate64 (guestfs_h *g,\n"
29022 "                      const char *path,\n"
29023 "                      int64_t len);\n"
29024 "\n"
29025 msgstr ""
29026
29027 #. type: textblock
29028 #: ../src/guestfs-actions.pod:1947
29029 msgid ""
29030 "Note that this call allocates disk blocks for the file.  To create a sparse "
29031 "file use C<guestfs_truncate_size> instead."
29032 msgstr ""
29033
29034 #. type: textblock
29035 #: ../src/guestfs-actions.pod:1950
29036 msgid ""
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."
29040 msgstr ""
29041
29042 #. type: textblock
29043 #: ../src/guestfs-actions.pod:1961
29044 msgid "(Added in 1.3.17)"
29045 msgstr "(Додано у 1.3.17)"
29046
29047 #. type: =head2
29048 #: ../src/guestfs-actions.pod:1963
29049 msgid "guestfs_fgrep"
29050 msgstr ""
29051
29052 #. type: verbatim
29053 #: ../src/guestfs-actions.pod:1965
29054 #, no-wrap
29055 msgid ""
29056 " char **\n"
29057 " guestfs_fgrep (guestfs_h *g,\n"
29058 "                const char *pattern,\n"
29059 "                const char *path);\n"
29060 "\n"
29061 msgstr ""
29062
29063 #. type: =head2
29064 #: ../src/guestfs-actions.pod:1982
29065 msgid "guestfs_fgrepi"
29066 msgstr ""
29067
29068 #. type: verbatim
29069 #: ../src/guestfs-actions.pod:1984
29070 #, no-wrap
29071 msgid ""
29072 " char **\n"
29073 " guestfs_fgrepi (guestfs_h *g,\n"
29074 "                 const char *pattern,\n"
29075 "                 const char *path);\n"
29076 "\n"
29077 msgstr ""
29078
29079 #. type: =head2
29080 #: ../src/guestfs-actions.pod:2001
29081 msgid "guestfs_file"
29082 msgstr ""
29083
29084 #. type: verbatim
29085 #: ../src/guestfs-actions.pod:2003
29086 #, no-wrap
29087 msgid ""
29088 " char *\n"
29089 " guestfs_file (guestfs_h *g,\n"
29090 "               const char *path);\n"
29091 "\n"
29092 msgstr ""
29093
29094 #. type: textblock
29095 #: ../src/guestfs-actions.pod:2021
29096 msgid ""
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>."
29099 msgstr ""
29100
29101 #. type: =head2
29102 #: ../src/guestfs-actions.pod:2029
29103 msgid "guestfs_file_architecture"
29104 msgstr ""
29105
29106 #. type: verbatim
29107 #: ../src/guestfs-actions.pod:2031
29108 #, no-wrap
29109 msgid ""
29110 " char *\n"
29111 " guestfs_file_architecture (guestfs_h *g,\n"
29112 "                            const char *filename);\n"
29113 "\n"
29114 msgstr ""
29115
29116 #. type: textblock
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)"
29126
29127 #. type: =head2
29128 #: ../src/guestfs-actions.pod:2141
29129 msgid "guestfs_filesize"
29130 msgstr ""
29131
29132 #. type: verbatim
29133 #: ../src/guestfs-actions.pod:2143
29134 #, no-wrap
29135 msgid ""
29136 " int64_t\n"
29137 " guestfs_filesize (guestfs_h *g,\n"
29138 "                   const char *file);\n"
29139 "\n"
29140 msgstr ""
29141
29142 #. type: textblock
29143 #: ../src/guestfs-actions.pod:2149
29144 msgid ""
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>."
29148 msgstr ""
29149
29150 #. type: textblock
29151 #: ../src/guestfs-actions.pod:2155
29152 msgid "(Added in 1.0.82)"
29153 msgstr "(Додано у 1.0.82)"
29154
29155 #. type: =head2
29156 #: ../src/guestfs-actions.pod:2157
29157 msgid "guestfs_fill"
29158 msgstr ""
29159
29160 #. type: verbatim
29161 #: ../src/guestfs-actions.pod:2159
29162 #, no-wrap
29163 msgid ""
29164 " int\n"
29165 " guestfs_fill (guestfs_h *g,\n"
29166 "               int c,\n"
29167 "               int len,\n"
29168 "               const char *path);\n"
29169 "\n"
29170 msgstr ""
29171
29172 #. type: textblock
29173 #: ../src/guestfs-actions.pod:2169
29174 msgid ""
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>."
29178 msgstr ""
29179
29180 #. type: textblock
29181 #: ../src/guestfs-actions.pod:2181
29182 msgid "(Added in 1.0.79)"
29183 msgstr "(Додано у 1.0.79)"
29184
29185 #. type: =head2
29186 #: ../src/guestfs-actions.pod:2183
29187 msgid "guestfs_fill_pattern"
29188 msgstr ""
29189
29190 #. type: verbatim
29191 #: ../src/guestfs-actions.pod:2185
29192 #, no-wrap
29193 msgid ""
29194 " int\n"
29195 " guestfs_fill_pattern (guestfs_h *g,\n"
29196 "                       const char *pattern,\n"
29197 "                       int len,\n"
29198 "                       const char *path);\n"
29199 "\n"
29200 msgstr ""
29201
29202 #. type: textblock
29203 #: ../src/guestfs-actions.pod:2191
29204 msgid ""
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."
29209 msgstr ""
29210
29211 #. type: textblock
29212 #: ../src/guestfs-actions.pod:2203
29213 msgid "(Added in 1.3.12)"
29214 msgstr "(Додано у 1.3.12)"
29215
29216 #. type: =head2
29217 #: ../src/guestfs-actions.pod:2205
29218 msgid "guestfs_find"
29219 msgstr ""
29220
29221 #. type: verbatim
29222 #: ../src/guestfs-actions.pod:2207
29223 #, no-wrap
29224 msgid ""
29225 " char **\n"
29226 " guestfs_find (guestfs_h *g,\n"
29227 "               const char *directory);\n"
29228 "\n"
29229 msgstr ""
29230
29231 #. type: textblock
29232 #: ../src/guestfs-actions.pod:2223
29233 msgid ""
29234 "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:"
29235 msgstr ""
29236
29237 #. type: textblock
29238 #: ../src/guestfs-actions.pod:2236
29239 msgid "See also C<guestfs_find0>."
29240 msgstr ""
29241
29242 #. type: textblock
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)"
29247
29248 #. type: =head2
29249 #: ../src/guestfs-actions.pod:2247
29250 msgid "guestfs_find0"
29251 msgstr ""
29252
29253 #. type: verbatim
29254 #: ../src/guestfs-actions.pod:2249
29255 #, no-wrap
29256 msgid ""
29257 " int\n"
29258 " guestfs_find0 (guestfs_h *g,\n"
29259 "                const char *directory,\n"
29260 "                const char *files);\n"
29261 "\n"
29262 msgstr ""
29263
29264 #. type: textblock
29265 #: ../src/guestfs-actions.pod:2258
29266 msgid ""
29267 "This command works the same way as C<guestfs_find> with the following "
29268 "exceptions:"
29269 msgstr ""
29270
29271 #. type: textblock
29272 #: ../src/guestfs-actions.pod:2285
29273 msgid "(Added in 1.0.74)"
29274 msgstr "(Додано у 1.0.74)"
29275
29276 #. type: =head2
29277 #: ../src/guestfs-actions.pod:2287
29278 msgid "guestfs_findfs_label"
29279 msgstr ""
29280
29281 #. type: verbatim
29282 #: ../src/guestfs-actions.pod:2289
29283 #, no-wrap
29284 msgid ""
29285 " char *\n"
29286 " guestfs_findfs_label (guestfs_h *g,\n"
29287 "                       const char *label);\n"
29288 "\n"
29289 msgstr ""
29290
29291 #. type: textblock
29292 #: ../src/guestfs-actions.pod:2297
29293 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>."
29294 msgstr ""
29295
29296 #. type: =head2
29297 #: ../src/guestfs-actions.pod:2304
29298 msgid "guestfs_findfs_uuid"
29299 msgstr ""
29300
29301 #. type: verbatim
29302 #: ../src/guestfs-actions.pod:2306
29303 #, no-wrap
29304 msgid ""
29305 " char *\n"
29306 " guestfs_findfs_uuid (guestfs_h *g,\n"
29307 "                      const char *uuid);\n"
29308 "\n"
29309 msgstr ""
29310
29311 #. type: textblock
29312 #: ../src/guestfs-actions.pod:2314
29313 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>."
29314 msgstr ""
29315
29316 #. type: =head2
29317 #: ../src/guestfs-actions.pod:2321
29318 msgid "guestfs_fsck"
29319 msgstr ""
29320
29321 #. type: verbatim
29322 #: ../src/guestfs-actions.pod:2323
29323 #, no-wrap
29324 msgid ""
29325 " int\n"
29326 " guestfs_fsck (guestfs_h *g,\n"
29327 "               const char *fstype,\n"
29328 "               const char *device);\n"
29329 "\n"
29330 msgstr ""
29331
29332 #. type: textblock
29333 #: ../src/guestfs-actions.pod:2358 ../src/guestfs-actions.pod:8522
29334 msgid "(Added in 1.0.16)"
29335 msgstr "(Додано у 1.0.16)"
29336
29337 #. type: =head2
29338 #: ../src/guestfs-actions.pod:2360
29339 msgid "guestfs_get_append"
29340 msgstr ""
29341
29342 #. type: verbatim
29343 #: ../src/guestfs-actions.pod:2362
29344 #, no-wrap
29345 msgid ""
29346 " const char *\n"
29347 " guestfs_get_append (guestfs_h *g);\n"
29348 "\n"
29349 msgstr ""
29350
29351 #. type: textblock
29352 #: ../src/guestfs-actions.pod:2370
29353 msgid ""
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."
29357 msgstr ""
29358
29359 #. type: textblock
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)"
29367
29368 #. type: =head2
29369 #: ../src/guestfs-actions.pod:2376
29370 msgid "guestfs_get_attach_method"
29371 msgstr ""
29372
29373 #. type: verbatim
29374 #: ../src/guestfs-actions.pod:2378
29375 #, no-wrap
29376 msgid ""
29377 " char *\n"
29378 " guestfs_get_attach_method (guestfs_h *g);\n"
29379 "\n"
29380 msgstr ""
29381
29382 #. type: textblock
29383 #: ../src/guestfs-actions.pod:2381
29384 msgid "Return the current attach method.  See C<guestfs_set_attach_method>."
29385 msgstr ""
29386
29387 #. type: textblock
29388 #: ../src/guestfs-actions.pod:2386 ../src/guestfs-actions.pod:6810
29389 msgid "(Added in 1.9.8)"
29390 msgstr "(Додано у 1.9.8)"
29391
29392 #. type: =head2
29393 #: ../src/guestfs-actions.pod:2388
29394 msgid "guestfs_get_autosync"
29395 msgstr ""
29396
29397 #. type: verbatim
29398 #: ../src/guestfs-actions.pod:2390
29399 #, no-wrap
29400 msgid ""
29401 " int\n"
29402 " guestfs_get_autosync (guestfs_h *g);\n"
29403 "\n"
29404 msgstr ""
29405
29406 #. type: =head2
29407 #: ../src/guestfs-actions.pod:2399
29408 msgid "guestfs_get_direct"
29409 msgstr ""
29410
29411 #. type: verbatim
29412 #: ../src/guestfs-actions.pod:2401
29413 #, no-wrap
29414 msgid ""
29415 " int\n"
29416 " guestfs_get_direct (guestfs_h *g);\n"
29417 "\n"
29418 msgstr ""
29419
29420 #. type: textblock
29421 #: ../src/guestfs-actions.pod:2408 ../src/guestfs-actions.pod:6851
29422 msgid "(Added in 1.0.72)"
29423 msgstr "(Додано у 1.0.72)"
29424
29425 #. type: =head2
29426 #: ../src/guestfs-actions.pod:2410
29427 msgid "guestfs_get_e2label"
29428 msgstr ""
29429
29430 #. type: verbatim
29431 #: ../src/guestfs-actions.pod:2412
29432 #, no-wrap
29433 msgid ""
29434 " char *\n"
29435 " guestfs_get_e2label (guestfs_h *g,\n"
29436 "                      const char *device);\n"
29437 "\n"
29438 msgstr ""
29439
29440 #. type: textblock
29441 #: ../src/guestfs-actions.pod:2416
29442 msgid ""
29443 "I<This function is deprecated.> In new code, use the L</guestfs_vfs_label> "
29444 "call instead."
29445 msgstr ""
29446
29447 #. type: textblock
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)"
29452
29453 #. type: =head2
29454 #: ../src/guestfs-actions.pod:2431
29455 msgid "guestfs_get_e2uuid"
29456 msgstr ""
29457
29458 #. type: verbatim
29459 #: ../src/guestfs-actions.pod:2433
29460 #, no-wrap
29461 msgid ""
29462 " char *\n"
29463 " guestfs_get_e2uuid (guestfs_h *g,\n"
29464 "                     const char *device);\n"
29465 "\n"
29466 msgstr ""
29467
29468 #. type: textblock
29469 #: ../src/guestfs-actions.pod:2437
29470 msgid ""
29471 "I<This function is deprecated.> In new code, use the L</guestfs_vfs_uuid> "
29472 "call instead."
29473 msgstr ""
29474
29475 #. type: =head2
29476 #: ../src/guestfs-actions.pod:2452
29477 msgid "guestfs_get_memsize"
29478 msgstr ""
29479
29480 #. type: verbatim
29481 #: ../src/guestfs-actions.pod:2454
29482 #, no-wrap
29483 msgid ""
29484 " int\n"
29485 " guestfs_get_memsize (guestfs_h *g);\n"
29486 "\n"
29487 msgstr ""
29488
29489 #. type: textblock
29490 #: ../src/guestfs-actions.pod:2460
29491 msgid ""
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."
29495 msgstr ""
29496
29497 #. type: textblock
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)"
29506
29507 #. type: =head2
29508 #: ../src/guestfs-actions.pod:2471
29509 msgid "guestfs_get_network"
29510 msgstr ""
29511
29512 #. type: verbatim
29513 #: ../src/guestfs-actions.pod:2473
29514 #, no-wrap
29515 msgid ""
29516 " int\n"
29517 " guestfs_get_network (guestfs_h *g);\n"
29518 "\n"
29519 msgstr ""
29520
29521 #. type: textblock
29522 #: ../src/guestfs-actions.pod:2480 ../src/guestfs-actions.pod:6928
29523 msgid "(Added in 1.5.4)"
29524 msgstr "(Додано у 1.5.4)"
29525
29526 #. type: =head2
29527 #: ../src/guestfs-actions.pod:2482
29528 msgid "guestfs_get_path"
29529 msgstr ""
29530
29531 #. type: verbatim
29532 #: ../src/guestfs-actions.pod:2484
29533 #, no-wrap
29534 msgid ""
29535 " const char *\n"
29536 " guestfs_get_path (guestfs_h *g);\n"
29537 "\n"
29538 msgstr ""
29539
29540 #. type: textblock
29541 #: ../src/guestfs-actions.pod:2492 ../src/guestfs-actions.pod:2532
29542 msgid ""
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."
29545 msgstr ""
29546
29547 #. type: =head2
29548 #: ../src/guestfs-actions.pod:2497
29549 msgid "guestfs_get_pgroup"
29550 msgstr ""
29551
29552 #. type: verbatim
29553 #: ../src/guestfs-actions.pod:2499
29554 #, no-wrap
29555 msgid ""
29556 " int\n"
29557 " guestfs_get_pgroup (guestfs_h *g);\n"
29558 "\n"
29559 msgstr ""
29560
29561 #. type: textblock
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)"
29566
29567 #. type: =head2
29568 #: ../src/guestfs-actions.pod:2508
29569 msgid "guestfs_get_pid"
29570 msgstr ""
29571
29572 #. type: verbatim
29573 #: ../src/guestfs-actions.pod:2510
29574 #, no-wrap
29575 msgid ""
29576 " int\n"
29577 " guestfs_get_pid (guestfs_h *g);\n"
29578 "\n"
29579 msgstr ""
29580
29581 #. type: textblock
29582 #: ../src/guestfs-actions.pod:2520
29583 msgid "(Added in 1.0.56)"
29584 msgstr "(Додано у 1.0.56)"
29585
29586 #. type: =head2
29587 #: ../src/guestfs-actions.pod:2522
29588 msgid "guestfs_get_qemu"
29589 msgstr ""
29590
29591 #. type: verbatim
29592 #: ../src/guestfs-actions.pod:2524
29593 #, no-wrap
29594 msgid ""
29595 " const char *\n"
29596 " guestfs_get_qemu (guestfs_h *g);\n"
29597 "\n"
29598 msgstr ""
29599
29600 #. type: textblock
29601 #: ../src/guestfs-actions.pod:2535 ../src/guestfs-actions.pod:6992
29602 msgid "(Added in 1.0.6)"
29603 msgstr "(Додано у 1.0.6)"
29604
29605 #. type: =head2
29606 #: ../src/guestfs-actions.pod:2537
29607 msgid "guestfs_get_recovery_proc"
29608 msgstr ""
29609
29610 #. type: verbatim
29611 #: ../src/guestfs-actions.pod:2539
29612 #, no-wrap
29613 msgid ""
29614 " int\n"
29615 " guestfs_get_recovery_proc (guestfs_h *g);\n"
29616 "\n"
29617 msgstr ""
29618
29619 #. type: textblock
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)"
29628
29629 #. type: =head2
29630 #: ../src/guestfs-actions.pod:2548
29631 msgid "guestfs_get_selinux"
29632 msgstr ""
29633
29634 #. type: verbatim
29635 #: ../src/guestfs-actions.pod:2550
29636 #, no-wrap
29637 msgid ""
29638 " int\n"
29639 " guestfs_get_selinux (guestfs_h *g);\n"
29640 "\n"
29641 msgstr ""
29642
29643 #. type: textblock
29644 #: ../src/guestfs-actions.pod:2553
29645 msgid ""
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>."
29648 msgstr ""
29649
29650 #. type: textblock
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)"
29655
29656 #. type: =head2
29657 #: ../src/guestfs-actions.pod:2563
29658 msgid "guestfs_get_smp"
29659 msgstr ""
29660
29661 #. type: verbatim
29662 #: ../src/guestfs-actions.pod:2565
29663 #, no-wrap
29664 msgid ""
29665 " int\n"
29666 " guestfs_get_smp (guestfs_h *g);\n"
29667 "\n"
29668 msgstr ""
29669
29670 #. type: =head2
29671 #: ../src/guestfs-actions.pod:2574
29672 msgid "guestfs_get_state"
29673 msgstr ""
29674
29675 #. type: verbatim
29676 #: ../src/guestfs-actions.pod:2576
29677 #, no-wrap
29678 msgid ""
29679 " int\n"
29680 " guestfs_get_state (guestfs_h *g);\n"
29681 "\n"
29682 msgstr ""
29683
29684 #. type: =head2
29685 #: ../src/guestfs-actions.pod:2588
29686 msgid "guestfs_get_trace"
29687 msgstr ""
29688
29689 #. type: verbatim
29690 #: ../src/guestfs-actions.pod:2590
29691 #, no-wrap
29692 msgid ""
29693 " int\n"
29694 " guestfs_get_trace (guestfs_h *g);\n"
29695 "\n"
29696 msgstr ""
29697
29698 #. type: =head2
29699 #: ../src/guestfs-actions.pod:2599
29700 msgid "guestfs_get_umask"
29701 msgstr ""
29702
29703 #. type: verbatim
29704 #: ../src/guestfs-actions.pod:2601
29705 #, no-wrap
29706 msgid ""
29707 " int\n"
29708 " guestfs_get_umask (guestfs_h *g);\n"
29709 "\n"
29710 msgstr ""
29711
29712 #. type: textblock
29713 #: ../src/guestfs-actions.pod:2604
29714 msgid ""
29715 "Return the current umask.  By default the umask is C<022> unless it has been "
29716 "set by calling C<guestfs_umask>."
29717 msgstr ""
29718
29719 #. type: =head2
29720 #: ../src/guestfs-actions.pod:2611
29721 msgid "guestfs_get_verbose"
29722 msgstr ""
29723
29724 #. type: verbatim
29725 #: ../src/guestfs-actions.pod:2613
29726 #, no-wrap
29727 msgid ""
29728 " int\n"
29729 " guestfs_get_verbose (guestfs_h *g);\n"
29730 "\n"
29731 msgstr ""
29732
29733 #. type: =head2
29734 #: ../src/guestfs-actions.pod:2622
29735 msgid "guestfs_getcon"
29736 msgstr ""
29737
29738 #. type: verbatim
29739 #: ../src/guestfs-actions.pod:2624
29740 #, no-wrap
29741 msgid ""
29742 " char *\n"
29743 " guestfs_getcon (guestfs_h *g);\n"
29744 "\n"
29745 msgstr ""
29746
29747 #. type: textblock
29748 #: ../src/guestfs-actions.pod:2629
29749 msgid ""
29750 "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>"
29751 msgstr ""
29752
29753 #. type: =head2
29754 #: ../src/guestfs-actions.pod:2637
29755 msgid "guestfs_getxattr"
29756 msgstr ""
29757
29758 #. type: verbatim
29759 #: ../src/guestfs-actions.pod:2639
29760 #, no-wrap
29761 msgid ""
29762 " char *\n"
29763 " guestfs_getxattr (guestfs_h *g,\n"
29764 "                   const char *path,\n"
29765 "                   const char *name,\n"
29766 "                   size_t *size_r);\n"
29767 "\n"
29768 msgstr ""
29769
29770 #. type: textblock
29771 #: ../src/guestfs-actions.pod:2645
29772 msgid ""
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>."
29776 msgstr ""
29777
29778 #. type: textblock
29779 #: ../src/guestfs-actions.pod:2649 ../src/guestfs-actions.pod:4144
29780 msgid ""
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."
29786 msgstr ""
29787
29788 #. type: textblock
29789 #: ../src/guestfs-actions.pod:2659
29790 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>."
29791 msgstr ""
29792
29793 #. type: textblock
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
29798 msgid ""
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 "
29801 "after use>."
29802 msgstr ""
29803
29804 #. type: textblock
29805 #: ../src/guestfs-actions.pod:2665 ../src/guestfs-actions.pod:4160
29806 msgid "(Added in 1.7.24)"
29807 msgstr "(Додано у 1.7.24)"
29808
29809 #. type: =head2
29810 #: ../src/guestfs-actions.pod:2667
29811 msgid "guestfs_getxattrs"
29812 msgstr ""
29813
29814 #. type: verbatim
29815 #: ../src/guestfs-actions.pod:2669
29816 #, no-wrap
29817 msgid ""
29818 " struct guestfs_xattr_list *\n"
29819 " guestfs_getxattrs (guestfs_h *g,\n"
29820 "                    const char *path);\n"
29821 "\n"
29822 msgstr ""
29823
29824 #. type: textblock
29825 #: ../src/guestfs-actions.pod:2679
29826 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>."
29827 msgstr ""
29828
29829 #. type: textblock
29830 #: ../src/guestfs-actions.pod:2681 ../src/guestfs-actions.pod:4172
29831 #: ../src/guestfs-actions.pod:4862
29832 msgid ""
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>."
29835 msgstr ""
29836
29837 #. type: textblock
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)"
29844
29845 #. type: =head2
29846 #: ../src/guestfs-actions.pod:2687
29847 msgid "guestfs_glob_expand"
29848 msgstr ""
29849
29850 #. type: verbatim
29851 #: ../src/guestfs-actions.pod:2689
29852 #, no-wrap
29853 msgid ""
29854 " char **\n"
29855 " guestfs_glob_expand (guestfs_h *g,\n"
29856 "                      const char *pattern);\n"
29857 "\n"
29858 msgstr ""
29859
29860 #. type: textblock
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)"
29865
29866 #. type: =head2
29867 #: ../src/guestfs-actions.pod:2710
29868 msgid "guestfs_grep"
29869 msgstr ""
29870
29871 #. type: verbatim
29872 #: ../src/guestfs-actions.pod:2712
29873 #, no-wrap
29874 msgid ""
29875 " char **\n"
29876 " guestfs_grep (guestfs_h *g,\n"
29877 "               const char *regex,\n"
29878 "               const char *path);\n"
29879 "\n"
29880 msgstr ""
29881
29882 #. type: =head2
29883 #: ../src/guestfs-actions.pod:2729
29884 msgid "guestfs_grepi"
29885 msgstr ""
29886
29887 #. type: verbatim
29888 #: ../src/guestfs-actions.pod:2731
29889 #, no-wrap
29890 msgid ""
29891 " char **\n"
29892 " guestfs_grepi (guestfs_h *g,\n"
29893 "                const char *regex,\n"
29894 "                const char *path);\n"
29895 "\n"
29896 msgstr ""
29897
29898 #. type: =head2
29899 #: ../src/guestfs-actions.pod:2748
29900 msgid "guestfs_grub_install"
29901 msgstr ""
29902
29903 #. type: verbatim
29904 #: ../src/guestfs-actions.pod:2750
29905 #, no-wrap
29906 msgid ""
29907 " int\n"
29908 " guestfs_grub_install (guestfs_h *g,\n"
29909 "                       const char *root,\n"
29910 "                       const char *device);\n"
29911 "\n"
29912 msgstr ""
29913
29914 #. type: textblock
29915 #: ../src/guestfs-actions.pod:2793
29916 msgid "(Added in 1.0.17)"
29917 msgstr "(Додано у 1.0.17)"
29918
29919 #. type: =head2
29920 #: ../src/guestfs-actions.pod:2795
29921 msgid "guestfs_head"
29922 msgstr ""
29923
29924 #. type: verbatim
29925 #: ../src/guestfs-actions.pod:2797
29926 #, no-wrap
29927 msgid ""
29928 " char **\n"
29929 " guestfs_head (guestfs_h *g,\n"
29930 "               const char *path);\n"
29931 "\n"
29932 msgstr ""
29933
29934 #. type: =head2
29935 #: ../src/guestfs-actions.pod:2813
29936 msgid "guestfs_head_n"
29937 msgstr ""
29938
29939 #. type: verbatim
29940 #: ../src/guestfs-actions.pod:2815
29941 #, no-wrap
29942 msgid ""
29943 " char **\n"
29944 " guestfs_head_n (guestfs_h *g,\n"
29945 "                 int nrlines,\n"
29946 "                 const char *path);\n"
29947 "\n"
29948 msgstr ""
29949
29950 #. type: =head2
29951 #: ../src/guestfs-actions.pod:2837
29952 msgid "guestfs_hexdump"
29953 msgstr ""
29954
29955 #. type: verbatim
29956 #: ../src/guestfs-actions.pod:2839
29957 #, no-wrap
29958 msgid ""
29959 " char *\n"
29960 " guestfs_hexdump (guestfs_h *g,\n"
29961 "                  const char *path);\n"
29962 "\n"
29963 msgstr ""
29964
29965 #. type: textblock
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)"
29970
29971 #. type: =head2
29972 #: ../src/guestfs-actions.pod:2854
29973 msgid "guestfs_initrd_cat"
29974 msgstr ""
29975
29976 #. type: verbatim
29977 #: ../src/guestfs-actions.pod:2856
29978 #, no-wrap
29979 msgid ""
29980 " char *\n"
29981 " guestfs_initrd_cat (guestfs_h *g,\n"
29982 "                     const char *initrdpath,\n"
29983 "                     const char *filename,\n"
29984 "                     size_t *size_r);\n"
29985 "\n"
29986 msgstr ""
29987
29988 #. type: textblock
29989 #: ../src/guestfs-actions.pod:2872
29990 msgid "See also C<guestfs_initrd_list>."
29991 msgstr ""
29992
29993 #. type: =head2
29994 #: ../src/guestfs-actions.pod:2883
29995 msgid "guestfs_initrd_list"
29996 msgstr ""
29997
29998 #. type: verbatim
29999 #: ../src/guestfs-actions.pod:2885
30000 #, no-wrap
30001 msgid ""
30002 " char **\n"
30003 " guestfs_initrd_list (guestfs_h *g,\n"
30004 "                      const char *path);\n"
30005 "\n"
30006 msgstr ""
30007
30008 #. type: =head2
30009 #: ../src/guestfs-actions.pod:2905
30010 msgid "guestfs_inotify_add_watch"
30011 msgstr ""
30012
30013 #. type: verbatim
30014 #: ../src/guestfs-actions.pod:2907
30015 #, no-wrap
30016 msgid ""
30017 " int64_t\n"
30018 " guestfs_inotify_add_watch (guestfs_h *g,\n"
30019 "                            const char *path,\n"
30020 "                            int mask);\n"
30021 "\n"
30022 msgstr ""
30023
30024 #. type: =head2
30025 #: ../src/guestfs-actions.pod:2926
30026 msgid "guestfs_inotify_close"
30027 msgstr ""
30028
30029 #. type: verbatim
30030 #: ../src/guestfs-actions.pod:2928
30031 #, no-wrap
30032 msgid ""
30033 " int\n"
30034 " guestfs_inotify_close (guestfs_h *g);\n"
30035 "\n"
30036 msgstr ""
30037
30038 #. type: =head2
30039 #: ../src/guestfs-actions.pod:2939
30040 msgid "guestfs_inotify_files"
30041 msgstr ""
30042
30043 #. type: verbatim
30044 #: ../src/guestfs-actions.pod:2941
30045 #, no-wrap
30046 msgid ""
30047 " char **\n"
30048 " guestfs_inotify_files (guestfs_h *g);\n"
30049 "\n"
30050 msgstr ""
30051
30052 #. type: textblock
30053 #: ../src/guestfs-actions.pod:2944
30054 msgid ""
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."
30058 msgstr ""
30059
30060 #. type: =head2
30061 #: ../src/guestfs-actions.pod:2954
30062 msgid "guestfs_inotify_init"
30063 msgstr ""
30064
30065 #. type: verbatim
30066 #: ../src/guestfs-actions.pod:2956
30067 #, no-wrap
30068 msgid ""
30069 " int\n"
30070 " guestfs_inotify_init (guestfs_h *g,\n"
30071 "                       int maxevents);\n"
30072 "\n"
30073 msgstr ""
30074
30075 #. type: textblock
30076 #: ../src/guestfs-actions.pod:2964
30077 msgid ""
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>)."
30085 msgstr ""
30086
30087 #. type: textblock
30088 #: ../src/guestfs-actions.pod:2974
30089 msgid ""
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>."
30093 msgstr ""
30094
30095 #. type: textblock
30096 #: ../src/guestfs-actions.pod:2980
30097 msgid ""
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."
30102 msgstr ""
30103
30104 #. type: textblock
30105 #: ../src/guestfs-actions.pod:2987
30106 msgid ""
30107 "The handle should be closed after use by calling C<guestfs_inotify_close>.  "
30108 "This also removes any watches automatically."
30109 msgstr ""
30110
30111 #. type: =head2
30112 #: ../src/guestfs-actions.pod:3000
30113 msgid "guestfs_inotify_read"
30114 msgstr ""
30115
30116 #. type: verbatim
30117 #: ../src/guestfs-actions.pod:3002
30118 #, no-wrap
30119 msgid ""
30120 " struct guestfs_inotify_event_list *\n"
30121 " guestfs_inotify_read (guestfs_h *g);\n"
30122 "\n"
30123 msgstr ""
30124
30125 #. type: textblock
30126 #: ../src/guestfs-actions.pod:3016
30127 msgid ""
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>."
30131 msgstr ""
30132
30133 #. type: =head2
30134 #: ../src/guestfs-actions.pod:3022
30135 msgid "guestfs_inotify_rm_watch"
30136 msgstr ""
30137
30138 #. type: verbatim
30139 #: ../src/guestfs-actions.pod:3024
30140 #, no-wrap
30141 msgid ""
30142 " int\n"
30143 " guestfs_inotify_rm_watch (guestfs_h *g,\n"
30144 "                           int wd);\n"
30145 "\n"
30146 msgstr ""
30147
30148 #. type: textblock
30149 #: ../src/guestfs-actions.pod:3028
30150 msgid ""
30151 "Remove a previously defined inotify watch.  See C<guestfs_inotify_add_watch>."
30152 msgstr ""
30153
30154 #. type: =head2
30155 #: ../src/guestfs-actions.pod:3035
30156 msgid "guestfs_inspect_get_arch"
30157 msgstr ""
30158
30159 #. type: verbatim
30160 #: ../src/guestfs-actions.pod:3037
30161 #, no-wrap
30162 msgid ""
30163 " char *\n"
30164 " guestfs_inspect_get_arch (guestfs_h *g,\n"
30165 "                           const char *root);\n"
30166 "\n"
30167 msgstr ""
30168
30169 #. type: textblock
30170 #: ../src/guestfs-actions.pod:3041
30171 msgid ""
30172 "This returns the architecture of the inspected operating system.  The "
30173 "possible return values are listed under C<guestfs_file_architecture>."
30174 msgstr ""
30175
30176 #. type: =head2
30177 #: ../src/guestfs-actions.pod:3055
30178 msgid "guestfs_inspect_get_distro"
30179 msgstr ""
30180
30181 #. type: verbatim
30182 #: ../src/guestfs-actions.pod:3057
30183 #, no-wrap
30184 msgid ""
30185 " char *\n"
30186 " guestfs_inspect_get_distro (guestfs_h *g,\n"
30187 "                             const char *root);\n"
30188 "\n"
30189 msgstr ""
30190
30191 #. type: =head2
30192 #: ../src/guestfs-actions.pod:3157
30193 msgid "guestfs_inspect_get_drive_mappings"
30194 msgstr ""
30195
30196 #. type: verbatim
30197 #: ../src/guestfs-actions.pod:3159
30198 #, no-wrap
30199 msgid ""
30200 " char **\n"
30201 " guestfs_inspect_get_drive_mappings (guestfs_h *g,\n"
30202 "                                     const char *root);\n"
30203 "\n"
30204 msgstr ""
30205
30206 #. type: textblock
30207 #: ../src/guestfs-actions.pod:3188
30208 msgid ""
30209 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
30210 "C<guestfs_inspect_get_mountpoints>, C<guestfs_inspect_get_filesystems>."
30211 msgstr ""
30212
30213 #. type: textblock
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
30217 msgid ""
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>."
30222 msgstr ""
30223
30224 #. type: textblock
30225 #: ../src/guestfs-actions.pod:3198 ../src/guestfs-actions.pod:3659
30226 msgid "(Added in 1.9.17)"
30227 msgstr "(Додано у 1.9.17)"
30228
30229 #. type: =head2
30230 #: ../src/guestfs-actions.pod:3200
30231 msgid "guestfs_inspect_get_filesystems"
30232 msgstr ""
30233
30234 #. type: verbatim
30235 #: ../src/guestfs-actions.pod:3202
30236 #, no-wrap
30237 msgid ""
30238 " char **\n"
30239 " guestfs_inspect_get_filesystems (guestfs_h *g,\n"
30240 "                                  const char *root);\n"
30241 "\n"
30242 msgstr ""
30243
30244 #. type: textblock
30245 #: ../src/guestfs-actions.pod:3214
30246 msgid ""
30247 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
30248 "C<guestfs_inspect_get_mountpoints>."
30249 msgstr ""
30250
30251 #. type: =head2
30252 #: ../src/guestfs-actions.pod:3223
30253 msgid "guestfs_inspect_get_format"
30254 msgstr ""
30255
30256 #. type: verbatim
30257 #: ../src/guestfs-actions.pod:3225
30258 #, no-wrap
30259 msgid ""
30260 " char *\n"
30261 " guestfs_inspect_get_format (guestfs_h *g,\n"
30262 "                             const char *root);\n"
30263 "\n"
30264 msgstr ""
30265
30266 #. type: textblock
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)"
30272
30273 #. type: =head2
30274 #: ../src/guestfs-actions.pod:3261
30275 msgid "guestfs_inspect_get_hostname"
30276 msgstr ""
30277
30278 #. type: verbatim
30279 #: ../src/guestfs-actions.pod:3263
30280 #, no-wrap
30281 msgid ""
30282 " char *\n"
30283 " guestfs_inspect_get_hostname (guestfs_h *g,\n"
30284 "                               const char *root);\n"
30285 "\n"
30286 msgstr ""
30287
30288 #. type: textblock
30289 #: ../src/guestfs-actions.pod:3278
30290 msgid "(Added in 1.7.9)"
30291 msgstr "(Додано у 1.7.9)"
30292
30293 #. type: =head2
30294 #: ../src/guestfs-actions.pod:3280
30295 msgid "guestfs_inspect_get_icon"
30296 msgstr ""
30297
30298 #. type: verbatim
30299 #: ../src/guestfs-actions.pod:3282
30300 #, no-wrap
30301 msgid ""
30302 " char *\n"
30303 " guestfs_inspect_get_icon (guestfs_h *g,\n"
30304 "                           const char *root,\n"
30305 "                           size_t *size_r,\n"
30306 "                           ...);\n"
30307 "\n"
30308 msgstr ""
30309
30310 #. type: verbatim
30311 #: ../src/guestfs-actions.pod:3293
30312 #, no-wrap
30313 msgid ""
30314 " GUESTFS_INSPECT_GET_ICON_FAVICON, int favicon,\n"
30315 " GUESTFS_INSPECT_GET_ICON_HIGHQUALITY, int highquality,\n"
30316 "\n"
30317 msgstr ""
30318
30319 #. type: textblock
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)"
30324
30325 #. type: =head2
30326 #: ../src/guestfs-actions.pod:3362
30327 msgid "guestfs_inspect_get_icon_va"
30328 msgstr ""
30329
30330 #. type: verbatim
30331 #: ../src/guestfs-actions.pod:3364
30332 #, no-wrap
30333 msgid ""
30334 " char *\n"
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"
30339 "\n"
30340 msgstr ""
30341
30342 #. type: textblock
30343 #: ../src/guestfs-actions.pod:3370
30344 msgid "This is the \"va_list variant\" of L</guestfs_inspect_get_icon>."
30345 msgstr ""
30346
30347 #. type: =head2
30348 #: ../src/guestfs-actions.pod:3374
30349 msgid "guestfs_inspect_get_icon_argv"
30350 msgstr ""
30351
30352 #. type: verbatim
30353 #: ../src/guestfs-actions.pod:3376
30354 #, no-wrap
30355 msgid ""
30356 " char *\n"
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"
30361 "\n"
30362 msgstr ""
30363
30364 #. type: textblock
30365 #: ../src/guestfs-actions.pod:3382
30366 msgid "This is the \"argv variant\" of L</guestfs_inspect_get_icon>."
30367 msgstr ""
30368
30369 #. type: =head2
30370 #: ../src/guestfs-actions.pod:3386
30371 msgid "guestfs_inspect_get_major_version"
30372 msgstr ""
30373
30374 #. type: verbatim
30375 #: ../src/guestfs-actions.pod:3388
30376 #, no-wrap
30377 msgid ""
30378 " int\n"
30379 " guestfs_inspect_get_major_version (guestfs_h *g,\n"
30380 "                                    const char *root);\n"
30381 "\n"
30382 msgstr ""
30383
30384 #. type: =head2
30385 #: ../src/guestfs-actions.pod:3410
30386 msgid "guestfs_inspect_get_minor_version"
30387 msgstr ""
30388
30389 #. type: verbatim
30390 #: ../src/guestfs-actions.pod:3412
30391 #, no-wrap
30392 msgid ""
30393 " int\n"
30394 " guestfs_inspect_get_minor_version (guestfs_h *g,\n"
30395 "                                    const char *root);\n"
30396 "\n"
30397 msgstr ""
30398
30399 #. type: textblock
30400 #: ../src/guestfs-actions.pod:3421
30401 msgid ""
30402 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
30403 "C<guestfs_inspect_get_major_version>."
30404 msgstr ""
30405
30406 #. type: =head2
30407 #: ../src/guestfs-actions.pod:3428
30408 msgid "guestfs_inspect_get_mountpoints"
30409 msgstr ""
30410
30411 #. type: verbatim
30412 #: ../src/guestfs-actions.pod:3430
30413 #, no-wrap
30414 msgid ""
30415 " char **\n"
30416 " guestfs_inspect_get_mountpoints (guestfs_h *g,\n"
30417 "                                  const char *root);\n"
30418 "\n"
30419 msgstr ""
30420
30421 #. type: textblock
30422 #: ../src/guestfs-actions.pod:3451
30423 msgid ""
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>."
30428 msgstr ""
30429
30430 #. type: textblock
30431 #: ../src/guestfs-actions.pod:3457
30432 msgid ""
30433 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
30434 "C<guestfs_inspect_get_filesystems>."
30435 msgstr ""
30436
30437 #. type: =head2
30438 #: ../src/guestfs-actions.pod:3468
30439 msgid "guestfs_inspect_get_package_format"
30440 msgstr ""
30441
30442 #. type: verbatim
30443 #: ../src/guestfs-actions.pod:3470
30444 #, no-wrap
30445 msgid ""
30446 " char *\n"
30447 " guestfs_inspect_get_package_format (guestfs_h *g,\n"
30448 "                                     const char *root);\n"
30449 "\n"
30450 msgstr ""
30451
30452 #. type: textblock
30453 #: ../src/guestfs-actions.pod:3474
30454 msgid ""
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)."
30459 msgstr ""
30460
30461 #. type: textblock
30462 #: ../src/guestfs-actions.pod:3493 ../src/guestfs-actions.pod:3521
30463 msgid "(Added in 1.7.5)"
30464 msgstr "(Додано у 1.7.5)"
30465
30466 #. type: =head2
30467 #: ../src/guestfs-actions.pod:3495
30468 msgid "guestfs_inspect_get_package_management"
30469 msgstr ""
30470
30471 #. type: verbatim
30472 #: ../src/guestfs-actions.pod:3497
30473 #, no-wrap
30474 msgid ""
30475 " char *\n"
30476 " guestfs_inspect_get_package_management (guestfs_h *g,\n"
30477 "                                         const char *root);\n"
30478 "\n"
30479 msgstr ""
30480
30481 #. type: textblock
30482 #: ../src/guestfs-actions.pod:3501
30483 msgid ""
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)."
30488 msgstr ""
30489
30490 #. type: =head2
30491 #: ../src/guestfs-actions.pod:3523
30492 msgid "guestfs_inspect_get_product_name"
30493 msgstr ""
30494
30495 #. type: verbatim
30496 #: ../src/guestfs-actions.pod:3525
30497 #, no-wrap
30498 msgid ""
30499 " char *\n"
30500 " guestfs_inspect_get_product_name (guestfs_h *g,\n"
30501 "                                   const char *root);\n"
30502 "\n"
30503 msgstr ""
30504
30505 #. type: =head2
30506 #: ../src/guestfs-actions.pod:3544
30507 msgid "guestfs_inspect_get_product_variant"
30508 msgstr ""
30509
30510 #. type: verbatim
30511 #: ../src/guestfs-actions.pod:3546
30512 #, no-wrap
30513 msgid ""
30514 " char *\n"
30515 " guestfs_inspect_get_product_variant (guestfs_h *g,\n"
30516 "                                      const char *root);\n"
30517 "\n"
30518 msgstr ""
30519
30520 #. type: textblock
30521 #: ../src/guestfs-actions.pod:3569
30522 msgid ""
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>."
30525 msgstr ""
30526
30527 #. type: textblock
30528 #: ../src/guestfs-actions.pod:3576
30529 msgid "(Added in 1.9.13)"
30530 msgstr "(Додано у 1.9.13)"
30531
30532 #. type: =head2
30533 #: ../src/guestfs-actions.pod:3578
30534 msgid "guestfs_inspect_get_roots"
30535 msgstr ""
30536
30537 #. type: verbatim
30538 #: ../src/guestfs-actions.pod:3580
30539 #, no-wrap
30540 msgid ""
30541 " char **\n"
30542 " guestfs_inspect_get_roots (guestfs_h *g);\n"
30543 "\n"
30544 msgstr ""
30545
30546 #. type: textblock
30547 #: ../src/guestfs-actions.pod:3583
30548 msgid ""
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."
30552 msgstr ""
30553
30554 #. type: textblock
30555 #: ../src/guestfs-actions.pod:3587
30556 msgid ""
30557 "This returns an empty list if either no root devices were found or the "
30558 "caller has not called C<guestfs_inspect_os>."
30559 msgstr ""
30560
30561 #. type: textblock
30562 #: ../src/guestfs-actions.pod:3596
30563 msgid "(Added in 1.7.3)"
30564 msgstr "(Додано у 1.7.3)"
30565
30566 #. type: =head2
30567 #: ../src/guestfs-actions.pod:3598
30568 msgid "guestfs_inspect_get_type"
30569 msgstr ""
30570
30571 #. type: verbatim
30572 #: ../src/guestfs-actions.pod:3600
30573 #, no-wrap
30574 msgid ""
30575 " char *\n"
30576 " guestfs_inspect_get_type (guestfs_h *g,\n"
30577 "                           const char *root);\n"
30578 "\n"
30579 msgstr ""
30580
30581 #. type: =head2
30582 #: ../src/guestfs-actions.pod:3641
30583 msgid "guestfs_inspect_get_windows_current_control_set"
30584 msgstr ""
30585
30586 #. type: verbatim
30587 #: ../src/guestfs-actions.pod:3643
30588 #, no-wrap
30589 msgid ""
30590 " char *\n"
30591 " guestfs_inspect_get_windows_current_control_set (guestfs_h *g,\n"
30592 "                                                  const char *root);\n"
30593 "\n"
30594 msgstr ""
30595
30596 #. type: =head2
30597 #: ../src/guestfs-actions.pod:3661
30598 msgid "guestfs_inspect_get_windows_systemroot"
30599 msgstr ""
30600
30601 #. type: verbatim
30602 #: ../src/guestfs-actions.pod:3663
30603 #, no-wrap
30604 msgid ""
30605 " char *\n"
30606 " guestfs_inspect_get_windows_systemroot (guestfs_h *g,\n"
30607 "                                         const char *root);\n"
30608 "\n"
30609 msgstr ""
30610
30611 #. type: textblock
30612 #: ../src/guestfs-actions.pod:3679
30613 msgid "(Added in 1.5.25)"
30614 msgstr "(Додано у 1.5.25)"
30615
30616 #. type: =head2
30617 #: ../src/guestfs-actions.pod:3681
30618 msgid "guestfs_inspect_is_live"
30619 msgstr ""
30620
30621 #. type: verbatim
30622 #: ../src/guestfs-actions.pod:3683
30623 #, no-wrap
30624 msgid ""
30625 " int\n"
30626 " guestfs_inspect_is_live (guestfs_h *g,\n"
30627 "                          const char *root);\n"
30628 "\n"
30629 msgstr ""
30630
30631 #. type: textblock
30632 #: ../src/guestfs-actions.pod:3687
30633 msgid ""
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."
30636 msgstr ""
30637
30638 #. type: =head2
30639 #: ../src/guestfs-actions.pod:3697
30640 msgid "guestfs_inspect_is_multipart"
30641 msgstr ""
30642
30643 #. type: verbatim
30644 #: ../src/guestfs-actions.pod:3699
30645 #, no-wrap
30646 msgid ""
30647 " int\n"
30648 " guestfs_inspect_is_multipart (guestfs_h *g,\n"
30649 "                               const char *root);\n"
30650 "\n"
30651 msgstr ""
30652
30653 #. type: textblock
30654 #: ../src/guestfs-actions.pod:3703
30655 msgid ""
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."
30658 msgstr ""
30659
30660 #. type: =head2
30661 #: ../src/guestfs-actions.pod:3713
30662 msgid "guestfs_inspect_is_netinst"
30663 msgstr ""
30664
30665 #. type: verbatim
30666 #: ../src/guestfs-actions.pod:3715
30667 #, no-wrap
30668 msgid ""
30669 " int\n"
30670 " guestfs_inspect_is_netinst (guestfs_h *g,\n"
30671 "                             const char *root);\n"
30672 "\n"
30673 msgstr ""
30674
30675 #. type: textblock
30676 #: ../src/guestfs-actions.pod:3719
30677 msgid ""
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."
30682 msgstr ""
30683
30684 #. type: =head2
30685 #: ../src/guestfs-actions.pod:3731
30686 msgid "guestfs_inspect_list_applications"
30687 msgstr ""
30688
30689 #. type: verbatim
30690 #: ../src/guestfs-actions.pod:3733
30691 #, no-wrap
30692 msgid ""
30693 " struct guestfs_application_list *\n"
30694 " guestfs_inspect_list_applications (guestfs_h *g,\n"
30695 "                                    const char *root);\n"
30696 "\n"
30697 msgstr ""
30698
30699 #. type: textblock
30700 #: ../src/guestfs-actions.pod:3739
30701 msgid ""
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."
30710 msgstr ""
30711
30712 #. type: textblock
30713 #: ../src/guestfs-actions.pod:3829
30714 msgid ""
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> "
30717 "after use>."
30718 msgstr ""
30719
30720 #. type: textblock
30721 #: ../src/guestfs-actions.pod:3833
30722 msgid "(Added in 1.7.8)"
30723 msgstr "(Додано у 1.7.8)"
30724
30725 #. type: =head2
30726 #: ../src/guestfs-actions.pod:3835
30727 msgid "guestfs_inspect_os"
30728 msgstr ""
30729
30730 #. type: verbatim
30731 #: ../src/guestfs-actions.pod:3837
30732 #, no-wrap
30733 msgid ""
30734 " char **\n"
30735 " guestfs_inspect_os (guestfs_h *g);\n"
30736 "\n"
30737 msgstr ""
30738
30739 #. type: textblock
30740 #: ../src/guestfs-actions.pod:3853
30741 msgid ""
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."
30745 msgstr ""
30746
30747 #. type: textblock
30748 #: ../src/guestfs-actions.pod:3858
30749 msgid ""
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."
30754 msgstr ""
30755
30756 #. type: textblock
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>."
30760 msgstr ""
30761
30762 #. type: =head2
30763 #: ../src/guestfs-actions.pod:3878
30764 msgid "guestfs_is_blockdev"
30765 msgstr ""
30766
30767 #. type: verbatim
30768 #: ../src/guestfs-actions.pod:3880
30769 #, no-wrap
30770 msgid ""
30771 " int\n"
30772 " guestfs_is_blockdev (guestfs_h *g,\n"
30773 "                      const char *path);\n"
30774 "\n"
30775 msgstr ""
30776
30777 #. type: textblock
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>."
30783 msgstr ""
30784
30785 #. type: textblock
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)"
30791
30792 #. type: =head2
30793 #: ../src/guestfs-actions.pod:3893
30794 msgid "guestfs_is_busy"
30795 msgstr ""
30796
30797 #. type: verbatim
30798 #: ../src/guestfs-actions.pod:3895
30799 #, no-wrap
30800 msgid ""
30801 " int\n"
30802 " guestfs_is_busy (guestfs_h *g);\n"
30803 "\n"
30804 msgstr ""
30805
30806 #. type: =head2
30807 #: ../src/guestfs-actions.pod:3907
30808 msgid "guestfs_is_chardev"
30809 msgstr ""
30810
30811 #. type: verbatim
30812 #: ../src/guestfs-actions.pod:3909
30813 #, no-wrap
30814 msgid ""
30815 " int\n"
30816 " guestfs_is_chardev (guestfs_h *g,\n"
30817 "                     const char *path);\n"
30818 "\n"
30819 msgstr ""
30820
30821 #. type: =head2
30822 #: ../src/guestfs-actions.pod:3922
30823 msgid "guestfs_is_config"
30824 msgstr ""
30825
30826 #. type: verbatim
30827 #: ../src/guestfs-actions.pod:3924
30828 #, no-wrap
30829 msgid ""
30830 " int\n"
30831 " guestfs_is_config (guestfs_h *g);\n"
30832 "\n"
30833 msgstr ""
30834
30835 #. type: =head2
30836 #: ../src/guestfs-actions.pod:3936
30837 msgid "guestfs_is_dir"
30838 msgstr ""
30839
30840 #. type: verbatim
30841 #: ../src/guestfs-actions.pod:3938
30842 #, no-wrap
30843 msgid ""
30844 " int\n"
30845 " guestfs_is_dir (guestfs_h *g,\n"
30846 "                 const char *path);\n"
30847 "\n"
30848 msgstr ""
30849
30850 #. type: =head2
30851 #: ../src/guestfs-actions.pod:3952
30852 msgid "guestfs_is_fifo"
30853 msgstr ""
30854
30855 #. type: verbatim
30856 #: ../src/guestfs-actions.pod:3954
30857 #, no-wrap
30858 msgid ""
30859 " int\n"
30860 " guestfs_is_fifo (guestfs_h *g,\n"
30861 "                  const char *path);\n"
30862 "\n"
30863 msgstr ""
30864
30865 #. type: =head2
30866 #: ../src/guestfs-actions.pod:3967
30867 msgid "guestfs_is_file"
30868 msgstr ""
30869
30870 #. type: verbatim
30871 #: ../src/guestfs-actions.pod:3969
30872 #, no-wrap
30873 msgid ""
30874 " int\n"
30875 " guestfs_is_file (guestfs_h *g,\n"
30876 "                  const char *path);\n"
30877 "\n"
30878 msgstr ""
30879
30880 #. type: =head2
30881 #: ../src/guestfs-actions.pod:3983
30882 msgid "guestfs_is_launching"
30883 msgstr ""
30884
30885 #. type: verbatim
30886 #: ../src/guestfs-actions.pod:3985
30887 #, no-wrap
30888 msgid ""
30889 " int\n"
30890 " guestfs_is_launching (guestfs_h *g);\n"
30891 "\n"
30892 msgstr ""
30893
30894 #. type: =head2
30895 #: ../src/guestfs-actions.pod:3997
30896 msgid "guestfs_is_lv"
30897 msgstr ""
30898
30899 #. type: verbatim
30900 #: ../src/guestfs-actions.pod:3999
30901 #, no-wrap
30902 msgid ""
30903 " int\n"
30904 " guestfs_is_lv (guestfs_h *g,\n"
30905 "                const char *device);\n"
30906 "\n"
30907 msgstr ""
30908
30909 #. type: =head2
30910 #: ../src/guestfs-actions.pod:4010
30911 msgid "guestfs_is_ready"
30912 msgstr ""
30913
30914 #. type: verbatim
30915 #: ../src/guestfs-actions.pod:4012
30916 #, no-wrap
30917 msgid ""
30918 " int\n"
30919 " guestfs_is_ready (guestfs_h *g);\n"
30920 "\n"
30921 msgstr ""
30922
30923 #. type: =head2
30924 #: ../src/guestfs-actions.pod:4024
30925 msgid "guestfs_is_socket"
30926 msgstr ""
30927
30928 #. type: verbatim
30929 #: ../src/guestfs-actions.pod:4026
30930 #, no-wrap
30931 msgid ""
30932 " int\n"
30933 " guestfs_is_socket (guestfs_h *g,\n"
30934 "                    const char *path);\n"
30935 "\n"
30936 msgstr ""
30937
30938 #. type: =head2
30939 #: ../src/guestfs-actions.pod:4039
30940 msgid "guestfs_is_symlink"
30941 msgstr ""
30942
30943 #. type: verbatim
30944 #: ../src/guestfs-actions.pod:4041
30945 #, no-wrap
30946 msgid ""
30947 " int\n"
30948 " guestfs_is_symlink (guestfs_h *g,\n"
30949 "                     const char *path);\n"
30950 "\n"
30951 msgstr ""
30952
30953 #. type: =head2
30954 #: ../src/guestfs-actions.pod:4054
30955 msgid "guestfs_is_zero"
30956 msgstr ""
30957
30958 #. type: verbatim
30959 #: ../src/guestfs-actions.pod:4056
30960 #, no-wrap
30961 msgid ""
30962 " int\n"
30963 " guestfs_is_zero (guestfs_h *g,\n"
30964 "                  const char *path);\n"
30965 "\n"
30966 msgstr ""
30967
30968 #. type: textblock
30969 #: ../src/guestfs-actions.pod:4065 ../src/guestfs-actions.pod:4079
30970 msgid "(Added in 1.11.8)"
30971 msgstr "(Додано у 1.11.8)"
30972
30973 #. type: =head2
30974 #: ../src/guestfs-actions.pod:4067
30975 msgid "guestfs_is_zero_device"
30976 msgstr ""
30977
30978 #. type: verbatim
30979 #: ../src/guestfs-actions.pod:4069
30980 #, no-wrap
30981 msgid ""
30982 " int\n"
30983 " guestfs_is_zero_device (guestfs_h *g,\n"
30984 "                         const char *device);\n"
30985 "\n"
30986 msgstr ""
30987
30988 #. type: =head2
30989 #: ../src/guestfs-actions.pod:4081
30990 msgid "guestfs_kill_subprocess"
30991 msgstr ""
30992
30993 #. type: verbatim
30994 #: ../src/guestfs-actions.pod:4083
30995 #, no-wrap
30996 msgid ""
30997 " int\n"
30998 " guestfs_kill_subprocess (guestfs_h *g);\n"
30999 "\n"
31000 msgstr ""
31001
31002 #. type: =head2
31003 #: ../src/guestfs-actions.pod:4092
31004 msgid "guestfs_launch"
31005 msgstr ""
31006
31007 #. type: verbatim
31008 #: ../src/guestfs-actions.pod:4094
31009 #, no-wrap
31010 msgid ""
31011 " int\n"
31012 " guestfs_launch (guestfs_h *g);\n"
31013 "\n"
31014 msgstr ""
31015
31016 #. type: =head2
31017 #: ../src/guestfs-actions.pod:4112
31018 msgid "guestfs_lchown"
31019 msgstr ""
31020
31021 #. type: verbatim
31022 #: ../src/guestfs-actions.pod:4114
31023 #, no-wrap
31024 msgid ""
31025 " int\n"
31026 " guestfs_lchown (guestfs_h *g,\n"
31027 "                 int owner,\n"
31028 "                 int group,\n"
31029 "                 const char *path);\n"
31030 "\n"
31031 msgstr ""
31032
31033 #. type: textblock
31034 #: ../src/guestfs-actions.pod:4120
31035 msgid ""
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."
31039 msgstr ""
31040
31041 #. type: =head2
31042 #: ../src/guestfs-actions.pod:4132
31043 msgid "guestfs_lgetxattr"
31044 msgstr ""
31045
31046 #. type: verbatim
31047 #: ../src/guestfs-actions.pod:4134
31048 #, no-wrap
31049 msgid ""
31050 " char *\n"
31051 " guestfs_lgetxattr (guestfs_h *g,\n"
31052 "                    const char *path,\n"
31053 "                    const char *name,\n"
31054 "                    size_t *size_r);\n"
31055 "\n"
31056 msgstr ""
31057
31058 #. type: textblock
31059 #: ../src/guestfs-actions.pod:4154
31060 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>."
31061 msgstr ""
31062
31063 #. type: =head2
31064 #: ../src/guestfs-actions.pod:4162
31065 msgid "guestfs_lgetxattrs"
31066 msgstr ""
31067
31068 #. type: verbatim
31069 #: ../src/guestfs-actions.pod:4164
31070 #, no-wrap
31071 msgid ""
31072 " struct guestfs_xattr_list *\n"
31073 " guestfs_lgetxattrs (guestfs_h *g,\n"
31074 "                     const char *path);\n"
31075 "\n"
31076 msgstr ""
31077
31078 #. type: textblock
31079 #: ../src/guestfs-actions.pod:4168
31080 msgid ""
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."
31083 msgstr ""
31084
31085 #. type: =head2
31086 #: ../src/guestfs-actions.pod:4178
31087 msgid "guestfs_list_9p"
31088 msgstr ""
31089
31090 #. type: verbatim
31091 #: ../src/guestfs-actions.pod:4180
31092 #, no-wrap
31093 msgid ""
31094 " char **\n"
31095 " guestfs_list_9p (guestfs_h *g);\n"
31096 "\n"
31097 msgstr ""
31098
31099 #. type: =head2
31100 #: ../src/guestfs-actions.pod:4192
31101 msgid "guestfs_list_devices"
31102 msgstr ""
31103
31104 #. type: verbatim
31105 #: ../src/guestfs-actions.pod:4194
31106 #, no-wrap
31107 msgid ""
31108 " char **\n"
31109 " guestfs_list_devices (guestfs_h *g);\n"
31110 "\n"
31111 msgstr ""
31112
31113 #. type: =head2
31114 #: ../src/guestfs-actions.pod:4209
31115 msgid "guestfs_list_dm_devices"
31116 msgstr ""
31117
31118 #. type: verbatim
31119 #: ../src/guestfs-actions.pod:4211
31120 #, no-wrap
31121 msgid ""
31122 " char **\n"
31123 " guestfs_list_dm_devices (guestfs_h *g);\n"
31124 "\n"
31125 msgstr ""
31126
31127 #. type: textblock
31128 #: ../src/guestfs-actions.pod:4216
31129 msgid ""
31130 "The returned list contains C</dev/mapper/*> devices, eg. ones created by a "
31131 "previous call to C<guestfs_luks_open>."
31132 msgstr ""
31133
31134 #. type: textblock
31135 #: ../src/guestfs-actions.pod:4219
31136 msgid ""
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 "
31139 "volumes."
31140 msgstr ""
31141
31142 #. type: textblock
31143 #: ../src/guestfs-actions.pod:4227 ../src/guestfs-actions.pod:5813
31144 msgid "(Added in 1.11.15)"
31145 msgstr "(Додано у 1.11.15)"
31146
31147 #. type: =head2
31148 #: ../src/guestfs-actions.pod:4229
31149 msgid "guestfs_list_filesystems"
31150 msgstr ""
31151
31152 #. type: verbatim
31153 #: ../src/guestfs-actions.pod:4231
31154 #, no-wrap
31155 msgid ""
31156 " char **\n"
31157 " guestfs_list_filesystems (guestfs_h *g);\n"
31158 "\n"
31159 msgstr ""
31160
31161 #. type: textblock
31162 #: ../src/guestfs-actions.pod:4251
31163 msgid ""
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."
31167 msgstr ""
31168
31169 #. type: textblock
31170 #: ../src/guestfs-actions.pod:4255
31171 msgid ""
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)."
31177 msgstr ""
31178
31179 #. type: textblock
31180 #: ../src/guestfs-actions.pod:4269 ../src/guestfs-actions.pod:6173
31181 msgid "(Added in 1.5.15)"
31182 msgstr "(Додано у 1.5.15)"
31183
31184 #. type: =head2
31185 #: ../src/guestfs-actions.pod:4271
31186 #, fuzzy
31187 #| msgid "guestfs_zero_device"
31188 msgid "guestfs_list_md_devices"
31189 msgstr "guestfs_zero_device"
31190
31191 #. type: verbatim
31192 #: ../src/guestfs-actions.pod:4273
31193 #, fuzzy, no-wrap
31194 #| msgid ""
31195 #| " char **\n"
31196 #| " guestfs_lvs (guestfs_h *g);\n"
31197 #| "\n"
31198 msgid ""
31199 " char **\n"
31200 " guestfs_list_md_devices (guestfs_h *g);\n"
31201 "\n"
31202 msgstr ""
31203 " char **\n"
31204 " guestfs_lvs (guestfs_h *g);\n"
31205 "\n"
31206
31207 #. type: =head2
31208 #: ../src/guestfs-actions.pod:4282
31209 msgid "guestfs_list_partitions"
31210 msgstr "guestfs_list_partitions"
31211
31212 #. type: verbatim
31213 #: ../src/guestfs-actions.pod:4284
31214 #, no-wrap
31215 msgid ""
31216 " char **\n"
31217 " guestfs_list_partitions (guestfs_h *g);\n"
31218 "\n"
31219 msgstr ""
31220 " char **\n"
31221 " guestfs_list_partitions (guestfs_h *g);\n"
31222 "\n"
31223
31224 #. type: textblock
31225 #: ../src/guestfs-actions.pod:4291
31226 msgid ""
31227 "This does not return logical volumes.  For that you will need to call "
31228 "C<guestfs_lvs>."
31229 msgstr ""
31230
31231 #. type: =head2
31232 #: ../src/guestfs-actions.pod:4302
31233 msgid "guestfs_ll"
31234 msgstr "guestfs_ll"
31235
31236 #. type: verbatim
31237 #: ../src/guestfs-actions.pod:4304
31238 #, no-wrap
31239 msgid ""
31240 " char *\n"
31241 " guestfs_ll (guestfs_h *g,\n"
31242 "             const char *directory);\n"
31243 "\n"
31244 msgstr ""
31245 " char *\n"
31246 " guestfs_ll (guestfs_h *g,\n"
31247 "             const char *directory);\n"
31248 "\n"
31249
31250 #. type: =head2
31251 #: ../src/guestfs-actions.pod:4319
31252 msgid "guestfs_ln"
31253 msgstr "guestfs_ln"
31254
31255 #. type: verbatim
31256 #: ../src/guestfs-actions.pod:4321
31257 #, no-wrap
31258 msgid ""
31259 " int\n"
31260 " guestfs_ln (guestfs_h *g,\n"
31261 "             const char *target,\n"
31262 "             const char *linkname);\n"
31263 "\n"
31264 msgstr ""
31265 " int\n"
31266 " guestfs_ln (guestfs_h *g,\n"
31267 "             const char *target,\n"
31268 "             const char *linkname);\n"
31269 "\n"
31270
31271 #. type: =head2
31272 #: ../src/guestfs-actions.pod:4332
31273 msgid "guestfs_ln_f"
31274 msgstr "guestfs_ln_f"
31275
31276 #. type: verbatim
31277 #: ../src/guestfs-actions.pod:4334
31278 #, no-wrap
31279 msgid ""
31280 " int\n"
31281 " guestfs_ln_f (guestfs_h *g,\n"
31282 "               const char *target,\n"
31283 "               const char *linkname);\n"
31284 "\n"
31285 msgstr ""
31286 " int\n"
31287 " guestfs_ln_f (guestfs_h *g,\n"
31288 "               const char *target,\n"
31289 "               const char *linkname);\n"
31290 "\n"
31291
31292 #. type: =head2
31293 #: ../src/guestfs-actions.pod:4346
31294 msgid "guestfs_ln_s"
31295 msgstr "guestfs_ln_s"
31296
31297 #. type: verbatim
31298 #: ../src/guestfs-actions.pod:4348
31299 #, no-wrap
31300 msgid ""
31301 " int\n"
31302 " guestfs_ln_s (guestfs_h *g,\n"
31303 "               const char *target,\n"
31304 "               const char *linkname);\n"
31305 "\n"
31306 msgstr ""
31307 " int\n"
31308 " guestfs_ln_s (guestfs_h *g,\n"
31309 "               const char *target,\n"
31310 "               const char *linkname);\n"
31311 "\n"
31312
31313 #. type: =head2
31314 #: ../src/guestfs-actions.pod:4359
31315 msgid "guestfs_ln_sf"
31316 msgstr "guestfs_ln_sf"
31317
31318 #. type: verbatim
31319 #: ../src/guestfs-actions.pod:4361
31320 #, no-wrap
31321 msgid ""
31322 " int\n"
31323 " guestfs_ln_sf (guestfs_h *g,\n"
31324 "                const char *target,\n"
31325 "                const char *linkname);\n"
31326 "\n"
31327 msgstr ""
31328 " int\n"
31329 " guestfs_ln_sf (guestfs_h *g,\n"
31330 "                const char *target,\n"
31331 "                const char *linkname);\n"
31332 "\n"
31333
31334 #. type: =head2
31335 #: ../src/guestfs-actions.pod:4373
31336 msgid "guestfs_lremovexattr"
31337 msgstr "guestfs_lremovexattr"
31338
31339 #. type: verbatim
31340 #: ../src/guestfs-actions.pod:4375
31341 #, no-wrap
31342 msgid ""
31343 " int\n"
31344 " guestfs_lremovexattr (guestfs_h *g,\n"
31345 "                       const char *xattr,\n"
31346 "                       const char *path);\n"
31347 "\n"
31348 msgstr ""
31349 " int\n"
31350 " guestfs_lremovexattr (guestfs_h *g,\n"
31351 "                       const char *xattr,\n"
31352 "                       const char *path);\n"
31353 "\n"
31354
31355 #. type: textblock
31356 #: ../src/guestfs-actions.pod:4380
31357 msgid ""
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."
31360 msgstr ""
31361
31362 #. type: =head2
31363 #: ../src/guestfs-actions.pod:4388
31364 msgid "guestfs_ls"
31365 msgstr "guestfs_ls"
31366
31367 #. type: verbatim
31368 #: ../src/guestfs-actions.pod:4390
31369 #, no-wrap
31370 msgid ""
31371 " char **\n"
31372 " guestfs_ls (guestfs_h *g,\n"
31373 "             const char *directory);\n"
31374 "\n"
31375 msgstr ""
31376 " char **\n"
31377 " guestfs_ls (guestfs_h *g,\n"
31378 "             const char *directory);\n"
31379 "\n"
31380
31381 #. type: textblock
31382 #: ../src/guestfs-actions.pod:4398
31383 msgid ""
31384 "This command is mostly useful for interactive sessions.  Programs should "
31385 "probably use C<guestfs_readdir> instead."
31386 msgstr ""
31387
31388 #. type: =head2
31389 #: ../src/guestfs-actions.pod:4407
31390 msgid "guestfs_lsetxattr"
31391 msgstr "guestfs_lsetxattr"
31392
31393 #. type: verbatim
31394 #: ../src/guestfs-actions.pod:4409
31395 #, no-wrap
31396 msgid ""
31397 " int\n"
31398 " guestfs_lsetxattr (guestfs_h *g,\n"
31399 "                    const char *xattr,\n"
31400 "                    const char *val,\n"
31401 "                    int vallen,\n"
31402 "                    const char *path);\n"
31403 "\n"
31404 msgstr ""
31405 " int\n"
31406 " guestfs_lsetxattr (guestfs_h *g,\n"
31407 "                    const char *xattr,\n"
31408 "                    const char *val,\n"
31409 "                    int vallen,\n"
31410 "                    const char *path);\n"
31411 "\n"
31412
31413 #. type: textblock
31414 #: ../src/guestfs-actions.pod:4416
31415 msgid ""
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."
31418 msgstr ""
31419
31420 #. type: =head2
31421 #: ../src/guestfs-actions.pod:4424
31422 msgid "guestfs_lstat"
31423 msgstr "guestfs_lstat"
31424
31425 #. type: verbatim
31426 #: ../src/guestfs-actions.pod:4426
31427 #, no-wrap
31428 msgid ""
31429 " struct guestfs_stat *\n"
31430 " guestfs_lstat (guestfs_h *g,\n"
31431 "                const char *path);\n"
31432 "\n"
31433 msgstr ""
31434 " struct guestfs_stat *\n"
31435 " guestfs_lstat (guestfs_h *g,\n"
31436 "                const char *path);\n"
31437 "\n"
31438
31439 #. type: textblock
31440 #: ../src/guestfs-actions.pod:4432
31441 msgid ""
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."
31444 msgstr ""
31445
31446 #. type: textblock
31447 #: ../src/guestfs-actions.pod:4438 ../src/guestfs-actions.pod:7353
31448 msgid ""
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>."
31451 msgstr ""
31452
31453 #. type: textblock
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)"
31458
31459 #. type: =head2
31460 #: ../src/guestfs-actions.pod:4444
31461 msgid "guestfs_lstatlist"
31462 msgstr "guestfs_lstatlist"
31463
31464 #. type: verbatim
31465 #: ../src/guestfs-actions.pod:4446
31466 #, no-wrap
31467 msgid ""
31468 " struct guestfs_stat_list *\n"
31469 " guestfs_lstatlist (guestfs_h *g,\n"
31470 "                    const char *path,\n"
31471 "                    char *const *names);\n"
31472 "\n"
31473 msgstr ""
31474 " struct guestfs_stat_list *\n"
31475 " guestfs_lstatlist (guestfs_h *g,\n"
31476 "                    const char *path,\n"
31477 "                    char *const *names);\n"
31478 "\n"
31479
31480 #. type: textblock
31481 #: ../src/guestfs-actions.pod:4451
31482 msgid ""
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."
31486 msgstr ""
31487
31488 #. type: textblock
31489 #: ../src/guestfs-actions.pod:4460
31490 msgid ""
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."
31497 msgstr ""
31498
31499 #. type: textblock
31500 #: ../src/guestfs-actions.pod:4468
31501 msgid ""
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>."
31504 msgstr ""
31505
31506 #. type: =head2
31507 #: ../src/guestfs-actions.pod:4474
31508 msgid "guestfs_luks_add_key"
31509 msgstr "guestfs_luks_add_key"
31510
31511 #. type: verbatim
31512 #: ../src/guestfs-actions.pod:4476
31513 #, no-wrap
31514 msgid ""
31515 " int\n"
31516 " guestfs_luks_add_key (guestfs_h *g,\n"
31517 "                       const char *device,\n"
31518 "                       const char *key,\n"
31519 "                       const char *newkey,\n"
31520 "                       int keyslot);\n"
31521 "\n"
31522 msgstr ""
31523 " int\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"
31528 "                       int keyslot);\n"
31529 "\n"
31530
31531 #. type: textblock
31532 #: ../src/guestfs-actions.pod:4488
31533 msgid ""
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."
31536 msgstr ""
31537
31538 #. type: textblock
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
31542 msgid ""
31543 "This function takes a key or passphrase parameter which could contain "
31544 "sensitive material.  Read the section L</KEYS AND PASSPHRASES> for more "
31545 "information."
31546 msgstr ""
31547
31548 #. type: textblock
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)"
31553
31554 #. type: =head2
31555 #: ../src/guestfs-actions.pod:4500
31556 msgid "guestfs_luks_close"
31557 msgstr "guestfs_luks_close"
31558
31559 #. type: verbatim
31560 #: ../src/guestfs-actions.pod:4502
31561 #, no-wrap
31562 msgid ""
31563 " int\n"
31564 " guestfs_luks_close (guestfs_h *g,\n"
31565 "                     const char *device);\n"
31566 "\n"
31567 msgstr ""
31568 " int\n"
31569 " guestfs_luks_close (guestfs_h *g,\n"
31570 "                     const char *device);\n"
31571 "\n"
31572
31573 #. type: textblock
31574 #: ../src/guestfs-actions.pod:4506
31575 msgid ""
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."
31580 msgstr ""
31581
31582 #. type: textblock
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)"
31588
31589 #. type: =head2
31590 #: ../src/guestfs-actions.pod:4516
31591 msgid "guestfs_luks_format"
31592 msgstr "guestfs_luks_format"
31593
31594 #. type: verbatim
31595 #: ../src/guestfs-actions.pod:4518
31596 #, no-wrap
31597 msgid ""
31598 " int\n"
31599 " guestfs_luks_format (guestfs_h *g,\n"
31600 "                      const char *device,\n"
31601 "                      const char *key,\n"
31602 "                      int keyslot);\n"
31603 "\n"
31604 msgstr ""
31605 " int\n"
31606 " guestfs_luks_format (guestfs_h *g,\n"
31607 "                      const char *device,\n"
31608 "                      const char *key,\n"
31609 "                      int keyslot);\n"
31610 "\n"
31611
31612 #. type: =head2
31613 #: ../src/guestfs-actions.pod:4537
31614 msgid "guestfs_luks_format_cipher"
31615 msgstr "guestfs_luks_format_cipher"
31616
31617 #. type: verbatim
31618 #: ../src/guestfs-actions.pod:4539
31619 #, no-wrap
31620 msgid ""
31621 " int\n"
31622 " guestfs_luks_format_cipher (guestfs_h *g,\n"
31623 "                             const char *device,\n"
31624 "                             const char *key,\n"
31625 "                             int keyslot,\n"
31626 "                             const char *cipher);\n"
31627 "\n"
31628 msgstr ""
31629 " int\n"
31630 " guestfs_luks_format_cipher (guestfs_h *g,\n"
31631 "                             const char *device,\n"
31632 "                             const char *key,\n"
31633 "                             int keyslot,\n"
31634 "                             const char *cipher);\n"
31635 "\n"
31636
31637 #. type: textblock
31638 #: ../src/guestfs-actions.pod:4546
31639 msgid ""
31640 "This command is the same as C<guestfs_luks_format> but it also allows you to "
31641 "set the C<cipher> used."
31642 msgstr ""
31643
31644 #. type: =head2
31645 #: ../src/guestfs-actions.pod:4557
31646 msgid "guestfs_luks_kill_slot"
31647 msgstr "guestfs_luks_kill_slot"
31648
31649 #. type: verbatim
31650 #: ../src/guestfs-actions.pod:4559
31651 #, no-wrap
31652 msgid ""
31653 " int\n"
31654 " guestfs_luks_kill_slot (guestfs_h *g,\n"
31655 "                         const char *device,\n"
31656 "                         const char *key,\n"
31657 "                         int keyslot);\n"
31658 "\n"
31659 msgstr ""
31660 " int\n"
31661 " guestfs_luks_kill_slot (guestfs_h *g,\n"
31662 "                         const char *device,\n"
31663 "                         const char *key,\n"
31664 "                         int keyslot);\n"
31665 "\n"
31666
31667 #. type: =head2
31668 #: ../src/guestfs-actions.pod:4577
31669 msgid "guestfs_luks_open"
31670 msgstr "guestfs_luks_open"
31671
31672 #. type: verbatim
31673 #: ../src/guestfs-actions.pod:4579
31674 #, no-wrap
31675 msgid ""
31676 " int\n"
31677 " guestfs_luks_open (guestfs_h *g,\n"
31678 "                    const char *device,\n"
31679 "                    const char *key,\n"
31680 "                    const char *mapname);\n"
31681 "\n"
31682 msgstr ""
31683 " int\n"
31684 " guestfs_luks_open (guestfs_h *g,\n"
31685 "                    const char *device,\n"
31686 "                    const char *key,\n"
31687 "                    const char *mapname);\n"
31688 "\n"
31689
31690 #. type: textblock
31691 #: ../src/guestfs-actions.pod:4597
31692 msgid ""
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 "
31695 "visible."
31696 msgstr ""
31697
31698 #. type: textblock
31699 #: ../src/guestfs-actions.pod:4601
31700 msgid "Use C<guestfs_list_dm_devices> to list all device mapper devices."
31701 msgstr ""
31702
31703 #. type: =head2
31704 #: ../src/guestfs-actions.pod:4612
31705 msgid "guestfs_luks_open_ro"
31706 msgstr "guestfs_luks_open_ro"
31707
31708 #. type: verbatim
31709 #: ../src/guestfs-actions.pod:4614
31710 #, no-wrap
31711 msgid ""
31712 " int\n"
31713 " guestfs_luks_open_ro (guestfs_h *g,\n"
31714 "                       const char *device,\n"
31715 "                       const char *key,\n"
31716 "                       const char *mapname);\n"
31717 "\n"
31718 msgstr ""
31719 " int\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"
31724 "\n"
31725
31726 #. type: textblock
31727 #: ../src/guestfs-actions.pod:4620
31728 msgid ""
31729 "This is the same as C<guestfs_luks_open> except that a read-only mapping is "
31730 "created."
31731 msgstr ""
31732
31733 #. type: =head2
31734 #: ../src/guestfs-actions.pod:4631
31735 msgid "guestfs_lvcreate"
31736 msgstr "guestfs_lvcreate"
31737
31738 #. type: verbatim
31739 #: ../src/guestfs-actions.pod:4633
31740 #, no-wrap
31741 msgid ""
31742 " int\n"
31743 " guestfs_lvcreate (guestfs_h *g,\n"
31744 "                   const char *logvol,\n"
31745 "                   const char *volgroup,\n"
31746 "                   int mbytes);\n"
31747 "\n"
31748 msgstr ""
31749 " int\n"
31750 " guestfs_lvcreate (guestfs_h *g,\n"
31751 "                   const char *logvol,\n"
31752 "                   const char *volgroup,\n"
31753 "                   int mbytes);\n"
31754 "\n"
31755
31756 #. type: =head2
31757 #: ../src/guestfs-actions.pod:4646
31758 msgid "guestfs_lvm_canonical_lv_name"
31759 msgstr "guestfs_lvm_canonical_lv_name"
31760
31761 #. type: verbatim
31762 #: ../src/guestfs-actions.pod:4648
31763 #, no-wrap
31764 msgid ""
31765 " char *\n"
31766 " guestfs_lvm_canonical_lv_name (guestfs_h *g,\n"
31767 "                                const char *lvname);\n"
31768 "\n"
31769 msgstr ""
31770 " char *\n"
31771 " guestfs_lvm_canonical_lv_name (guestfs_h *g,\n"
31772 "                                const char *lvname);\n"
31773 "\n"
31774
31775 #. type: textblock
31776 #: ../src/guestfs-actions.pod:4659
31777 msgid "See also C<guestfs_is_lv>."
31778 msgstr ""
31779
31780 #. type: textblock
31781 #: ../src/guestfs-actions.pod:4664
31782 msgid "(Added in 1.5.24)"
31783 msgstr "(Додано у 1.5.24)"
31784
31785 #. type: =head2
31786 #: ../src/guestfs-actions.pod:4666
31787 msgid "guestfs_lvm_clear_filter"
31788 msgstr "guestfs_lvm_clear_filter"
31789
31790 #. type: verbatim
31791 #: ../src/guestfs-actions.pod:4668
31792 #, no-wrap
31793 msgid ""
31794 " int\n"
31795 " guestfs_lvm_clear_filter (guestfs_h *g);\n"
31796 "\n"
31797 msgstr ""
31798 " int\n"
31799 " guestfs_lvm_clear_filter (guestfs_h *g);\n"
31800 "\n"
31801
31802 #. type: textblock
31803 #: ../src/guestfs-actions.pod:4671
31804 msgid ""
31805 "This undoes the effect of C<guestfs_lvm_set_filter>.  LVM will be able to "
31806 "see every block device."
31807 msgstr ""
31808
31809 #. type: =head2
31810 #: ../src/guestfs-actions.pod:4681
31811 msgid "guestfs_lvm_remove_all"
31812 msgstr "guestfs_lvm_remove_all"
31813
31814 #. type: verbatim
31815 #: ../src/guestfs-actions.pod:4683
31816 #, no-wrap
31817 msgid ""
31818 " int\n"
31819 " guestfs_lvm_remove_all (guestfs_h *g);\n"
31820 "\n"
31821 msgstr ""
31822 " int\n"
31823 " guestfs_lvm_remove_all (guestfs_h *g);\n"
31824 "\n"
31825
31826 #. type: =head2
31827 #: ../src/guestfs-actions.pod:4693
31828 msgid "guestfs_lvm_set_filter"
31829 msgstr "guestfs_lvm_set_filter"
31830
31831 #. type: verbatim
31832 #: ../src/guestfs-actions.pod:4695
31833 #, no-wrap
31834 msgid ""
31835 " int\n"
31836 " guestfs_lvm_set_filter (guestfs_h *g,\n"
31837 "                         char *const *devices);\n"
31838 "\n"
31839 msgstr ""
31840 " int\n"
31841 " guestfs_lvm_set_filter (guestfs_h *g,\n"
31842 "                         char *const *devices);\n"
31843 "\n"
31844
31845 #. type: =head2
31846 #: ../src/guestfs-actions.pod:4726
31847 msgid "guestfs_lvremove"
31848 msgstr "guestfs_lvremove"
31849
31850 #. type: verbatim
31851 #: ../src/guestfs-actions.pod:4728
31852 #, no-wrap
31853 msgid ""
31854 " int\n"
31855 " guestfs_lvremove (guestfs_h *g,\n"
31856 "                   const char *device);\n"
31857 "\n"
31858 msgstr ""
31859 " int\n"
31860 " guestfs_lvremove (guestfs_h *g,\n"
31861 "                   const char *device);\n"
31862 "\n"
31863
31864 #. type: textblock
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)"
31869
31870 #. type: =head2
31871 #: ../src/guestfs-actions.pod:4742
31872 msgid "guestfs_lvrename"
31873 msgstr "guestfs_lvrename"
31874
31875 #. type: verbatim
31876 #: ../src/guestfs-actions.pod:4744
31877 #, no-wrap
31878 msgid ""
31879 " int\n"
31880 " guestfs_lvrename (guestfs_h *g,\n"
31881 "                   const char *logvol,\n"
31882 "                   const char *newlogvol);\n"
31883 "\n"
31884 msgstr ""
31885 " int\n"
31886 " guestfs_lvrename (guestfs_h *g,\n"
31887 "                   const char *logvol,\n"
31888 "                   const char *newlogvol);\n"
31889 "\n"
31890
31891 #. type: textblock
31892 #: ../src/guestfs-actions.pod:4753 ../src/guestfs-actions.pod:8259
31893 msgid "(Added in 1.0.83)"
31894 msgstr "(Додано у 1.0.83)"
31895
31896 #. type: =head2
31897 #: ../src/guestfs-actions.pod:4755
31898 msgid "guestfs_lvresize"
31899 msgstr "guestfs_lvresize"
31900
31901 #. type: verbatim
31902 #: ../src/guestfs-actions.pod:4757
31903 #, no-wrap
31904 msgid ""
31905 " int\n"
31906 " guestfs_lvresize (guestfs_h *g,\n"
31907 "                   const char *device,\n"
31908 "                   int mbytes);\n"
31909 "\n"
31910 msgstr ""
31911 " int\n"
31912 " guestfs_lvresize (guestfs_h *g,\n"
31913 "                   const char *device,\n"
31914 "                   int mbytes);\n"
31915 "\n"
31916
31917 #. type: =head2
31918 #: ../src/guestfs-actions.pod:4770
31919 msgid "guestfs_lvresize_free"
31920 msgstr "guestfs_lvresize_free"
31921
31922 #. type: verbatim
31923 #: ../src/guestfs-actions.pod:4772
31924 #, no-wrap
31925 msgid ""
31926 " int\n"
31927 " guestfs_lvresize_free (guestfs_h *g,\n"
31928 "                        const char *lv,\n"
31929 "                        int percent);\n"
31930 "\n"
31931 msgstr ""
31932 " int\n"
31933 " guestfs_lvresize_free (guestfs_h *g,\n"
31934 "                        const char *lv,\n"
31935 "                        int percent);\n"
31936 "\n"
31937
31938 #. type: textblock
31939 #: ../src/guestfs-actions.pod:4785
31940 msgid "(Added in 1.3.3)"
31941 msgstr "(Додано у 1.3.3)"
31942
31943 #. type: =head2
31944 #: ../src/guestfs-actions.pod:4787
31945 msgid "guestfs_lvs"
31946 msgstr "guestfs_lvs"
31947
31948 #. type: verbatim
31949 #: ../src/guestfs-actions.pod:4789
31950 #, no-wrap
31951 msgid ""
31952 " char **\n"
31953 " guestfs_lvs (guestfs_h *g);\n"
31954 "\n"
31955 msgstr ""
31956 " char **\n"
31957 " guestfs_lvs (guestfs_h *g);\n"
31958 "\n"
31959
31960 #. type: textblock
31961 #: ../src/guestfs-actions.pod:4798
31962 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>."
31963 msgstr ""
31964
31965 #. type: =head2
31966 #: ../src/guestfs-actions.pod:4806
31967 msgid "guestfs_lvs_full"
31968 msgstr "guestfs_lvs_full"
31969
31970 #. type: verbatim
31971 #: ../src/guestfs-actions.pod:4808
31972 #, no-wrap
31973 msgid ""
31974 " struct guestfs_lvm_lv_list *\n"
31975 " guestfs_lvs_full (guestfs_h *g);\n"
31976 "\n"
31977 msgstr ""
31978 " struct guestfs_lvm_lv_list *\n"
31979 " guestfs_lvs_full (guestfs_h *g);\n"
31980 "\n"
31981
31982 #. type: textblock
31983 #: ../src/guestfs-actions.pod:4814
31984 msgid ""
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>."
31987 msgstr ""
31988
31989 #. type: =head2
31990 #: ../src/guestfs-actions.pod:4820
31991 msgid "guestfs_lvuuid"
31992 msgstr "guestfs_lvuuid"
31993
31994 #. type: verbatim
31995 #: ../src/guestfs-actions.pod:4822
31996 #, no-wrap
31997 msgid ""
31998 " char *\n"
31999 " guestfs_lvuuid (guestfs_h *g,\n"
32000 "                 const char *device);\n"
32001 "\n"
32002 msgstr ""
32003 " char *\n"
32004 " guestfs_lvuuid (guestfs_h *g,\n"
32005 "                 const char *device);\n"
32006 "\n"
32007
32008 #. type: =head2
32009 #: ../src/guestfs-actions.pod:4833
32010 msgid "guestfs_lxattrlist"
32011 msgstr "guestfs_lxattrlist"
32012
32013 #. type: verbatim
32014 #: ../src/guestfs-actions.pod:4835
32015 #, no-wrap
32016 msgid ""
32017 " struct guestfs_xattr_list *\n"
32018 " guestfs_lxattrlist (guestfs_h *g,\n"
32019 "                     const char *path,\n"
32020 "                     char *const *names);\n"
32021 "\n"
32022 msgstr ""
32023 " struct guestfs_xattr_list *\n"
32024 " guestfs_lxattrlist (guestfs_h *g,\n"
32025 "                     const char *path,\n"
32026 "                     char *const *names);\n"
32027 "\n"
32028
32029 #. type: textblock
32030 #: ../src/guestfs-actions.pod:4854
32031 msgid ""
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 "
32037 "names."
32038 msgstr ""
32039
32040 #. type: =head2
32041 #: ../src/guestfs-actions.pod:4868
32042 #, fuzzy
32043 #| msgid "guestfs_create"
32044 msgid "guestfs_mdadm_create"
32045 msgstr "guestfs_create"
32046
32047 #. type: verbatim
32048 #: ../src/guestfs-actions.pod:4870
32049 #, fuzzy, no-wrap
32050 #| msgid ""
32051 #| " int\n"
32052 #| " guestfs_mkfs_opts (guestfs_h *g,\n"
32053 #| "                    const char *fstype,\n"
32054 #| "                    const char *device,\n"
32055 #| "                    ...);\n"
32056 #| "\n"
32057 msgid ""
32058 " int\n"
32059 " guestfs_mdadm_create (guestfs_h *g,\n"
32060 "                       const char *name,\n"
32061 "                       char *const *devices,\n"
32062 "                       ...);\n"
32063 "\n"
32064 msgstr ""
32065 " int\n"
32066 " guestfs_mkfs_opts (guestfs_h *g,\n"
32067 "                    const char *fstype,\n"
32068 "                    const char *device,\n"
32069 "                    ...);\n"
32070 "\n"
32071
32072 #. type: verbatim
32073 #: ../src/guestfs-actions.pod:4881
32074 #, no-wrap
32075 msgid ""
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"
32081 "\n"
32082 msgstr ""
32083
32084 #. type: =head2
32085 #: ../src/guestfs-actions.pod:4943
32086 #, fuzzy
32087 #| msgid "guestfs_create"
32088 msgid "guestfs_mdadm_create_va"
32089 msgstr "guestfs_create"
32090
32091 #. type: verbatim
32092 #: ../src/guestfs-actions.pod:4945
32093 #, fuzzy, no-wrap
32094 #| msgid ""
32095 #| " int\n"
32096 #| " guestfs_mkfs_opts_va (guestfs_h *g,\n"
32097 #| "                       const char *fstype,\n"
32098 #| "                       const char *device,\n"
32099 #| "                       va_list args);\n"
32100 #| "\n"
32101 msgid ""
32102 " int\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"
32107 "\n"
32108 msgstr ""
32109 " int\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"
32114 "\n"
32115
32116 #. type: textblock
32117 #: ../src/guestfs-actions.pod:4951
32118 msgid "This is the \"va_list variant\" of L</guestfs_mdadm_create>."
32119 msgstr ""
32120
32121 #. type: =head2
32122 #: ../src/guestfs-actions.pod:4955
32123 #, fuzzy
32124 #| msgid "guestfs_create"
32125 msgid "guestfs_mdadm_create_argv"
32126 msgstr "guestfs_create"
32127
32128 #. type: verbatim
32129 #: ../src/guestfs-actions.pod:4957
32130 #, fuzzy, no-wrap
32131 #| msgid ""
32132 #| " int\n"
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"
32137 #| "\n"
32138 msgid ""
32139 " int\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"
32144 "\n"
32145 msgstr ""
32146 " int\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"
32151 "\n"
32152
32153 #. type: textblock
32154 #: ../src/guestfs-actions.pod:4963
32155 msgid "This is the \"argv variant\" of L</guestfs_mdadm_create>."
32156 msgstr ""
32157
32158 #. type: =head2
32159 #: ../src/guestfs-actions.pod:4967
32160 #, fuzzy
32161 #| msgid "guestfs_aug_get"
32162 msgid "guestfs_mdadm_detail"
32163 msgstr "guestfs_aug_get"
32164
32165 #. type: verbatim
32166 #: ../src/guestfs-actions.pod:4969
32167 #, fuzzy, no-wrap
32168 #| msgid ""
32169 #| " char *\n"
32170 #| " guestfs_aug_get (guestfs_h *g,\n"
32171 #| "                  const char *augpath);\n"
32172 #| "\n"
32173 msgid ""
32174 " char **\n"
32175 " guestfs_mdadm_detail (guestfs_h *g,\n"
32176 "                       const char *md);\n"
32177 "\n"
32178 msgstr ""
32179 " char *\n"
32180 " guestfs_aug_get (guestfs_h *g,\n"
32181 "                  const char *augpath);\n"
32182 "\n"
32183
32184 #. type: =head2
32185 #: ../src/guestfs-actions.pod:5006
32186 msgid "guestfs_mkdir"
32187 msgstr "guestfs_mkdir"
32188
32189 #. type: verbatim
32190 #: ../src/guestfs-actions.pod:5008
32191 #, no-wrap
32192 msgid ""
32193 " int\n"
32194 " guestfs_mkdir (guestfs_h *g,\n"
32195 "                const char *path);\n"
32196 "\n"
32197 msgstr ""
32198 " int\n"
32199 " guestfs_mkdir (guestfs_h *g,\n"
32200 "                const char *path);\n"
32201 "\n"
32202
32203 #. type: =head2
32204 #: ../src/guestfs-actions.pod:5018
32205 msgid "guestfs_mkdir_mode"
32206 msgstr "guestfs_mkdir_mode"
32207
32208 #. type: verbatim
32209 #: ../src/guestfs-actions.pod:5020
32210 #, no-wrap
32211 msgid ""
32212 " int\n"
32213 " guestfs_mkdir_mode (guestfs_h *g,\n"
32214 "                     const char *path,\n"
32215 "                     int mode);\n"
32216 "\n"
32217 msgstr ""
32218 " int\n"
32219 " guestfs_mkdir_mode (guestfs_h *g,\n"
32220 "                     const char *path,\n"
32221 "                     int mode);\n"
32222 "\n"
32223
32224 #. type: textblock
32225 #: ../src/guestfs-actions.pod:5032
32226 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>"
32227 msgstr ""
32228
32229 #. type: =head2
32230 #: ../src/guestfs-actions.pod:5038
32231 msgid "guestfs_mkdir_p"
32232 msgstr "guestfs_mkdir_p"
32233
32234 #. type: verbatim
32235 #: ../src/guestfs-actions.pod:5040
32236 #, no-wrap
32237 msgid ""
32238 " int\n"
32239 " guestfs_mkdir_p (guestfs_h *g,\n"
32240 "                  const char *path);\n"
32241 "\n"
32242 msgstr ""
32243 " int\n"
32244 " guestfs_mkdir_p (guestfs_h *g,\n"
32245 "                  const char *path);\n"
32246 "\n"
32247
32248 #. type: =head2
32249 #: ../src/guestfs-actions.pod:5051
32250 msgid "guestfs_mkdtemp"
32251 msgstr "guestfs_mkdtemp"
32252
32253 #. type: verbatim
32254 #: ../src/guestfs-actions.pod:5053
32255 #, no-wrap
32256 msgid ""
32257 " char *\n"
32258 " guestfs_mkdtemp (guestfs_h *g,\n"
32259 "                  const char *template);\n"
32260 "\n"
32261 msgstr ""
32262 " char *\n"
32263 " guestfs_mkdtemp (guestfs_h *g,\n"
32264 "                  const char *template);\n"
32265 "\n"
32266
32267 #. type: =head2
32268 #: ../src/guestfs-actions.pod:5081
32269 msgid "guestfs_mke2fs_J"
32270 msgstr "guestfs_mke2fs_J"
32271
32272 #. type: verbatim
32273 #: ../src/guestfs-actions.pod:5083
32274 #, no-wrap
32275 msgid ""
32276 " int\n"
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"
32282 "\n"
32283 msgstr ""
32284 " int\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"
32290 "\n"
32291
32292 #. type: textblock
32293 #: ../src/guestfs-actions.pod:5096
32294 msgid "See also C<guestfs_mke2journal>."
32295 msgstr ""
32296
32297 #. type: textblock
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)"
32304
32305 #. type: =head2
32306 #: ../src/guestfs-actions.pod:5102
32307 msgid "guestfs_mke2fs_JL"
32308 msgstr "guestfs_mke2fs_JL"
32309
32310 #. type: verbatim
32311 #: ../src/guestfs-actions.pod:5104
32312 #, no-wrap
32313 msgid ""
32314 " int\n"
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"
32320 "\n"
32321 msgstr ""
32322 " int\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"
32328 "\n"
32329
32330 #. type: textblock
32331 #: ../src/guestfs-actions.pod:5114
32332 msgid "See also C<guestfs_mke2journal_L>."
32333 msgstr ""
32334
32335 #. type: =head2
32336 #: ../src/guestfs-actions.pod:5120
32337 msgid "guestfs_mke2fs_JU"
32338 msgstr "guestfs_mke2fs_JU"
32339
32340 #. type: verbatim
32341 #: ../src/guestfs-actions.pod:5122
32342 #, no-wrap
32343 msgid ""
32344 " int\n"
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"
32350 "\n"
32351 msgstr ""
32352 " int\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"
32358 "\n"
32359
32360 #. type: textblock
32361 #: ../src/guestfs-actions.pod:5132
32362 msgid "See also C<guestfs_mke2journal_U>."
32363 msgstr ""
32364
32365 #. type: =head2
32366 #: ../src/guestfs-actions.pod:5138
32367 msgid "guestfs_mke2journal"
32368 msgstr "guestfs_mke2journal"
32369
32370 #. type: verbatim
32371 #: ../src/guestfs-actions.pod:5140
32372 #, no-wrap
32373 msgid ""
32374 " int\n"
32375 " guestfs_mke2journal (guestfs_h *g,\n"
32376 "                      int blocksize,\n"
32377 "                      const char *device);\n"
32378 "\n"
32379 msgstr ""
32380 " int\n"
32381 " guestfs_mke2journal (guestfs_h *g,\n"
32382 "                      int blocksize,\n"
32383 "                      const char *device);\n"
32384 "\n"
32385
32386 #. type: =head2
32387 #: ../src/guestfs-actions.pod:5154
32388 msgid "guestfs_mke2journal_L"
32389 msgstr "guestfs_mke2journal_L"
32390
32391 #. type: verbatim
32392 #: ../src/guestfs-actions.pod:5156
32393 #, no-wrap
32394 msgid ""
32395 " int\n"
32396 " guestfs_mke2journal_L (guestfs_h *g,\n"
32397 "                        int blocksize,\n"
32398 "                        const char *label,\n"
32399 "                        const char *device);\n"
32400 "\n"
32401 msgstr ""
32402 " int\n"
32403 " guestfs_mke2journal_L (guestfs_h *g,\n"
32404 "                        int blocksize,\n"
32405 "                        const char *label,\n"
32406 "                        const char *device);\n"
32407 "\n"
32408
32409 #. type: =head2
32410 #: ../src/guestfs-actions.pod:5168
32411 msgid "guestfs_mke2journal_U"
32412 msgstr "guestfs_mke2journal_U"
32413
32414 #. type: verbatim
32415 #: ../src/guestfs-actions.pod:5170
32416 #, no-wrap
32417 msgid ""
32418 " int\n"
32419 " guestfs_mke2journal_U (guestfs_h *g,\n"
32420 "                        int blocksize,\n"
32421 "                        const char *uuid,\n"
32422 "                        const char *device);\n"
32423 "\n"
32424 msgstr ""
32425 " int\n"
32426 " guestfs_mke2journal_U (guestfs_h *g,\n"
32427 "                        int blocksize,\n"
32428 "                        const char *uuid,\n"
32429 "                        const char *device);\n"
32430 "\n"
32431
32432 #. type: =head2
32433 #: ../src/guestfs-actions.pod:5182
32434 msgid "guestfs_mkfifo"
32435 msgstr "guestfs_mkfifo"
32436
32437 #. type: verbatim
32438 #: ../src/guestfs-actions.pod:5184
32439 #, no-wrap
32440 msgid ""
32441 " int\n"
32442 " guestfs_mkfifo (guestfs_h *g,\n"
32443 "                 int mode,\n"
32444 "                 const char *path);\n"
32445 "\n"
32446 msgstr ""
32447 " int\n"
32448 " guestfs_mkfifo (guestfs_h *g,\n"
32449 "                 int mode,\n"
32450 "                 const char *path);\n"
32451 "\n"
32452
32453 #. type: textblock
32454 #: ../src/guestfs-actions.pod:5189
32455 msgid ""
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>."
32458 msgstr ""
32459
32460 #. type: =head2
32461 #: ../src/guestfs-actions.pod:5199
32462 msgid "guestfs_mkfs"
32463 msgstr "guestfs_mkfs"
32464
32465 #. type: verbatim
32466 #: ../src/guestfs-actions.pod:5201
32467 #, no-wrap
32468 msgid ""
32469 " int\n"
32470 " guestfs_mkfs (guestfs_h *g,\n"
32471 "               const char *fstype,\n"
32472 "               const char *device);\n"
32473 "\n"
32474 msgstr ""
32475 " int\n"
32476 " guestfs_mkfs (guestfs_h *g,\n"
32477 "               const char *fstype,\n"
32478 "               const char *device);\n"
32479 "\n"
32480
32481 #. type: =head2
32482 #: ../src/guestfs-actions.pod:5214
32483 msgid "guestfs_mkfs_b"
32484 msgstr "guestfs_mkfs_b"
32485
32486 #. type: verbatim
32487 #: ../src/guestfs-actions.pod:5216
32488 #, no-wrap
32489 msgid ""
32490 " int\n"
32491 " guestfs_mkfs_b (guestfs_h *g,\n"
32492 "                 const char *fstype,\n"
32493 "                 int blocksize,\n"
32494 "                 const char *device);\n"
32495 "\n"
32496 msgstr ""
32497 " int\n"
32498 " guestfs_mkfs_b (guestfs_h *g,\n"
32499 "                 const char *fstype,\n"
32500 "                 int blocksize,\n"
32501 "                 const char *device);\n"
32502 "\n"
32503
32504 #. type: textblock
32505 #: ../src/guestfs-actions.pod:5222
32506 msgid ""
32507 "I<This function is deprecated.> In new code, use the L</guestfs_mkfs_opts> "
32508 "call instead."
32509 msgstr ""
32510
32511 #. type: textblock
32512 #: ../src/guestfs-actions.pod:5229
32513 msgid ""
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."
32517 msgstr ""
32518
32519 #. type: =head2
32520 #: ../src/guestfs-actions.pod:5241
32521 msgid "guestfs_mkfs_opts"
32522 msgstr "guestfs_mkfs_opts"
32523
32524 #. type: verbatim
32525 #: ../src/guestfs-actions.pod:5243
32526 #, no-wrap
32527 msgid ""
32528 " int\n"
32529 " guestfs_mkfs_opts (guestfs_h *g,\n"
32530 "                    const char *fstype,\n"
32531 "                    const char *device,\n"
32532 "                    ...);\n"
32533 "\n"
32534 msgstr ""
32535 " int\n"
32536 " guestfs_mkfs_opts (guestfs_h *g,\n"
32537 "                    const char *fstype,\n"
32538 "                    const char *device,\n"
32539 "                    ...);\n"
32540 "\n"
32541
32542 #. type: verbatim
32543 #: ../src/guestfs-actions.pod:5254
32544 #, no-wrap
32545 msgid ""
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"
32550 "\n"
32551 msgstr ""
32552
32553 #. type: textblock
32554 #: ../src/guestfs-actions.pod:5302
32555 msgid "(Added in 1.7.19)"
32556 msgstr "(Додано у 1.7.19)"
32557
32558 #. type: =head2
32559 #: ../src/guestfs-actions.pod:5304
32560 msgid "guestfs_mkfs_opts_va"
32561 msgstr "guestfs_mkfs_opts_va"
32562
32563 #. type: verbatim
32564 #: ../src/guestfs-actions.pod:5306
32565 #, no-wrap
32566 msgid ""
32567 " int\n"
32568 " guestfs_mkfs_opts_va (guestfs_h *g,\n"
32569 "                       const char *fstype,\n"
32570 "                       const char *device,\n"
32571 "                       va_list args);\n"
32572 "\n"
32573 msgstr ""
32574 " int\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"
32579 "\n"
32580
32581 #. type: textblock
32582 #: ../src/guestfs-actions.pod:5312
32583 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>."
32584 msgstr ""
32585
32586 #. type: =head2
32587 #: ../src/guestfs-actions.pod:5316
32588 msgid "guestfs_mkfs_opts_argv"
32589 msgstr "guestfs_mkfs_opts_argv"
32590
32591 #. type: verbatim
32592 #: ../src/guestfs-actions.pod:5318
32593 #, no-wrap
32594 msgid ""
32595 " int\n"
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"
32600 "\n"
32601 msgstr ""
32602 " int\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"
32607 "\n"
32608
32609 #. type: textblock
32610 #: ../src/guestfs-actions.pod:5324
32611 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>."
32612 msgstr ""
32613
32614 #. type: =head2
32615 #: ../src/guestfs-actions.pod:5328
32616 msgid "guestfs_mkmountpoint"
32617 msgstr "guestfs_mkmountpoint"
32618
32619 #. type: verbatim
32620 #: ../src/guestfs-actions.pod:5330
32621 #, no-wrap
32622 msgid ""
32623 " int\n"
32624 " guestfs_mkmountpoint (guestfs_h *g,\n"
32625 "                       const char *exemptpath);\n"
32626 "\n"
32627 msgstr ""
32628 " int\n"
32629 " guestfs_mkmountpoint (guestfs_h *g,\n"
32630 "                       const char *exemptpath);\n"
32631 "\n"
32632
32633 #. type: textblock
32634 #: ../src/guestfs-actions.pod:5334
32635 msgid ""
32636 "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls "
32637 "that can be used to create extra mountpoints before mounting the first "
32638 "filesystem."
32639 msgstr ""
32640
32641 #. type: textblock
32642 #: ../src/guestfs-actions.pod:5358
32643 msgid ""
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."
32647 msgstr ""
32648
32649 #. type: textblock
32650 #: ../src/guestfs-actions.pod:5362
32651 msgid ""
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 "
32655 "above."
32656 msgstr ""
32657
32658 #. type: textblock
32659 #: ../src/guestfs-actions.pod:5369
32660 msgid ""
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."
32664 msgstr ""
32665
32666 #. type: textblock
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)"
32671
32672 #. type: =head2
32673 #: ../src/guestfs-actions.pod:5377
32674 msgid "guestfs_mknod"
32675 msgstr ""
32676
32677 #. type: verbatim
32678 #: ../src/guestfs-actions.pod:5379
32679 #, no-wrap
32680 msgid ""
32681 " int\n"
32682 " guestfs_mknod (guestfs_h *g,\n"
32683 "                int mode,\n"
32684 "                int devmajor,\n"
32685 "                int devminor,\n"
32686 "                const char *path);\n"
32687 "\n"
32688 msgstr ""
32689
32690 #. type: textblock
32691 #: ../src/guestfs-actions.pod:5394
32692 msgid ""
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."
32699 msgstr ""
32700
32701 #. type: =head2
32702 #: ../src/guestfs-actions.pod:5408
32703 msgid "guestfs_mknod_b"
32704 msgstr ""
32705
32706 #. type: verbatim
32707 #: ../src/guestfs-actions.pod:5410
32708 #, no-wrap
32709 msgid ""
32710 " int\n"
32711 " guestfs_mknod_b (guestfs_h *g,\n"
32712 "                  int mode,\n"
32713 "                  int devmajor,\n"
32714 "                  int devminor,\n"
32715 "                  const char *path);\n"
32716 "\n"
32717 msgstr ""
32718
32719 #. type: textblock
32720 #: ../src/guestfs-actions.pod:5417
32721 msgid ""
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>."
32725 msgstr ""
32726
32727 #. type: =head2
32728 #: ../src/guestfs-actions.pod:5427
32729 msgid "guestfs_mknod_c"
32730 msgstr ""
32731
32732 #. type: verbatim
32733 #: ../src/guestfs-actions.pod:5429
32734 #, no-wrap
32735 msgid ""
32736 " int\n"
32737 " guestfs_mknod_c (guestfs_h *g,\n"
32738 "                  int mode,\n"
32739 "                  int devmajor,\n"
32740 "                  int devminor,\n"
32741 "                  const char *path);\n"
32742 "\n"
32743 msgstr ""
32744
32745 #. type: textblock
32746 #: ../src/guestfs-actions.pod:5436
32747 msgid ""
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>."
32751 msgstr ""
32752
32753 #. type: =head2
32754 #: ../src/guestfs-actions.pod:5446
32755 msgid "guestfs_mkswap"
32756 msgstr ""
32757
32758 #. type: verbatim
32759 #: ../src/guestfs-actions.pod:5448
32760 #, no-wrap
32761 msgid ""
32762 " int\n"
32763 " guestfs_mkswap (guestfs_h *g,\n"
32764 "                 const char *device);\n"
32765 "\n"
32766 msgstr ""
32767
32768 #. type: =head2
32769 #: ../src/guestfs-actions.pod:5458
32770 msgid "guestfs_mkswap_L"
32771 msgstr ""
32772
32773 #. type: verbatim
32774 #: ../src/guestfs-actions.pod:5460
32775 #, no-wrap
32776 msgid ""
32777 " int\n"
32778 " guestfs_mkswap_L (guestfs_h *g,\n"
32779 "                   const char *label,\n"
32780 "                   const char *device);\n"
32781 "\n"
32782 msgstr ""
32783
32784 #. type: =head2
32785 #: ../src/guestfs-actions.pod:5475
32786 msgid "guestfs_mkswap_U"
32787 msgstr ""
32788
32789 #. type: verbatim
32790 #: ../src/guestfs-actions.pod:5477
32791 #, no-wrap
32792 msgid ""
32793 " int\n"
32794 " guestfs_mkswap_U (guestfs_h *g,\n"
32795 "                   const char *uuid,\n"
32796 "                   const char *device);\n"
32797 "\n"
32798 msgstr ""
32799
32800 #. type: =head2
32801 #: ../src/guestfs-actions.pod:5488
32802 msgid "guestfs_mkswap_file"
32803 msgstr ""
32804
32805 #. type: verbatim
32806 #: ../src/guestfs-actions.pod:5490
32807 #, no-wrap
32808 msgid ""
32809 " int\n"
32810 " guestfs_mkswap_file (guestfs_h *g,\n"
32811 "                      const char *path);\n"
32812 "\n"
32813 msgstr ""
32814
32815 #. type: textblock
32816 #: ../src/guestfs-actions.pod:5496
32817 msgid ""
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>."
32820 msgstr ""
32821
32822 #. type: =head2
32823 #: ../src/guestfs-actions.pod:5503
32824 msgid "guestfs_modprobe"
32825 msgstr ""
32826
32827 #. type: verbatim
32828 #: ../src/guestfs-actions.pod:5505
32829 #, no-wrap
32830 msgid ""
32831 " int\n"
32832 " guestfs_modprobe (guestfs_h *g,\n"
32833 "                   const char *modulename);\n"
32834 "\n"
32835 msgstr ""
32836
32837 #. type: =head2
32838 #: ../src/guestfs-actions.pod:5518
32839 msgid "guestfs_mount"
32840 msgstr ""
32841
32842 #. type: verbatim
32843 #: ../src/guestfs-actions.pod:5520
32844 #, no-wrap
32845 msgid ""
32846 " int\n"
32847 " guestfs_mount (guestfs_h *g,\n"
32848 "                const char *device,\n"
32849 "                const char *mountpoint);\n"
32850 "\n"
32851 msgstr ""
32852
32853 #. type: textblock
32854 #: ../src/guestfs-actions.pod:5539
32855 msgid ""
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)."
32861 msgstr ""
32862
32863 #. type: =head2
32864 #: ../src/guestfs-actions.pod:5550
32865 msgid "guestfs_mount_9p"
32866 msgstr ""
32867
32868 #. type: verbatim
32869 #: ../src/guestfs-actions.pod:5552
32870 #, no-wrap
32871 msgid ""
32872 " int\n"
32873 " guestfs_mount_9p (guestfs_h *g,\n"
32874 "                   const char *mounttag,\n"
32875 "                   const char *mountpoint,\n"
32876 "                   ...);\n"
32877 "\n"
32878 msgstr ""
32879
32880 #. type: verbatim
32881 #: ../src/guestfs-actions.pod:5563
32882 #, no-wrap
32883 msgid ""
32884 " GUESTFS_MOUNT_9P_OPTIONS, const char *options,\n"
32885 "\n"
32886 msgstr ""
32887
32888 #. type: =head2
32889 #: ../src/guestfs-actions.pod:5576
32890 msgid "guestfs_mount_9p_va"
32891 msgstr ""
32892
32893 #. type: verbatim
32894 #: ../src/guestfs-actions.pod:5578
32895 #, no-wrap
32896 msgid ""
32897 " int\n"
32898 " guestfs_mount_9p_va (guestfs_h *g,\n"
32899 "                      const char *mounttag,\n"
32900 "                      const char *mountpoint,\n"
32901 "                      va_list args);\n"
32902 "\n"
32903 msgstr ""
32904
32905 #. type: textblock
32906 #: ../src/guestfs-actions.pod:5584
32907 msgid "This is the \"va_list variant\" of L</guestfs_mount_9p>."
32908 msgstr ""
32909
32910 #. type: =head2
32911 #: ../src/guestfs-actions.pod:5588
32912 msgid "guestfs_mount_9p_argv"
32913 msgstr ""
32914
32915 #. type: verbatim
32916 #: ../src/guestfs-actions.pod:5590
32917 #, no-wrap
32918 msgid ""
32919 " int\n"
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"
32924 "\n"
32925 msgstr ""
32926
32927 #. type: textblock
32928 #: ../src/guestfs-actions.pod:5596
32929 msgid "This is the \"argv variant\" of L</guestfs_mount_9p>."
32930 msgstr ""
32931
32932 #. type: =head2
32933 #: ../src/guestfs-actions.pod:5600
32934 msgid "guestfs_mount_loop"
32935 msgstr ""
32936
32937 #. type: verbatim
32938 #: ../src/guestfs-actions.pod:5602
32939 #, no-wrap
32940 msgid ""
32941 " int\n"
32942 " guestfs_mount_loop (guestfs_h *g,\n"
32943 "                     const char *file,\n"
32944 "                     const char *mountpoint);\n"
32945 "\n"
32946 msgstr ""
32947
32948 #. type: =head2
32949 #: ../src/guestfs-actions.pod:5615
32950 msgid "guestfs_mount_options"
32951 msgstr ""
32952
32953 #. type: verbatim
32954 #: ../src/guestfs-actions.pod:5617
32955 #, no-wrap
32956 msgid ""
32957 " int\n"
32958 " guestfs_mount_options (guestfs_h *g,\n"
32959 "                        const char *options,\n"
32960 "                        const char *device,\n"
32961 "                        const char *mountpoint);\n"
32962 "\n"
32963 msgstr ""
32964
32965 #. type: textblock
32966 #: ../src/guestfs-actions.pod:5623
32967 msgid ""
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."
32970 msgstr ""
32971
32972 #. type: textblock
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)"
32977
32978 #. type: =head2
32979 #: ../src/guestfs-actions.pod:5635
32980 msgid "guestfs_mount_ro"
32981 msgstr ""
32982
32983 #. type: verbatim
32984 #: ../src/guestfs-actions.pod:5637
32985 #, no-wrap
32986 msgid ""
32987 " int\n"
32988 " guestfs_mount_ro (guestfs_h *g,\n"
32989 "                   const char *device,\n"
32990 "                   const char *mountpoint);\n"
32991 "\n"
32992 msgstr ""
32993
32994 #. type: textblock
32995 #: ../src/guestfs-actions.pod:5642
32996 msgid ""
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."
32999 msgstr ""
33000
33001 #. type: =head2
33002 #: ../src/guestfs-actions.pod:5649
33003 msgid "guestfs_mount_vfs"
33004 msgstr ""
33005
33006 #. type: verbatim
33007 #: ../src/guestfs-actions.pod:5651
33008 #, no-wrap
33009 msgid ""
33010 " int\n"
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"
33016 "\n"
33017 msgstr ""
33018
33019 #. type: textblock
33020 #: ../src/guestfs-actions.pod:5658
33021 msgid ""
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<-"
33024 "t> flags."
33025 msgstr ""
33026
33027 #. type: =head2
33028 #: ../src/guestfs-actions.pod:5666
33029 msgid "guestfs_mountpoints"
33030 msgstr ""
33031
33032 #. type: verbatim
33033 #: ../src/guestfs-actions.pod:5668
33034 #, no-wrap
33035 msgid ""
33036 " char **\n"
33037 " guestfs_mountpoints (guestfs_h *g);\n"
33038 "\n"
33039 msgstr ""
33040
33041 #. type: textblock
33042 #: ../src/guestfs-actions.pod:5671
33043 msgid ""
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."
33047 msgstr ""
33048
33049 #. type: =head2
33050 #: ../src/guestfs-actions.pod:5683
33051 msgid "guestfs_mounts"
33052 msgstr ""
33053
33054 #. type: verbatim
33055 #: ../src/guestfs-actions.pod:5685
33056 #, no-wrap
33057 msgid ""
33058 " char **\n"
33059 " guestfs_mounts (guestfs_h *g);\n"
33060 "\n"
33061 msgstr ""
33062
33063 #. type: textblock
33064 #: ../src/guestfs-actions.pod:5693
33065 msgid "See also: C<guestfs_mountpoints>"
33066 msgstr ""
33067
33068 #. type: =head2
33069 #: ../src/guestfs-actions.pod:5701
33070 msgid "guestfs_mv"
33071 msgstr ""
33072
33073 #. type: verbatim
33074 #: ../src/guestfs-actions.pod:5703
33075 #, no-wrap
33076 msgid ""
33077 " int\n"
33078 " guestfs_mv (guestfs_h *g,\n"
33079 "             const char *src,\n"
33080 "             const char *dest);\n"
33081 "\n"
33082 msgstr ""
33083
33084 #. type: =head2
33085 #: ../src/guestfs-actions.pod:5715
33086 msgid "guestfs_ntfs_3g_probe"
33087 msgstr ""
33088
33089 #. type: verbatim
33090 #: ../src/guestfs-actions.pod:5717
33091 #, no-wrap
33092 msgid ""
33093 " int\n"
33094 " guestfs_ntfs_3g_probe (guestfs_h *g,\n"
33095 "                        int rw,\n"
33096 "                        const char *device);\n"
33097 "\n"
33098 msgstr ""
33099
33100 #. type: textblock
33101 #: ../src/guestfs-actions.pod:5736
33102 msgid "(Added in 1.0.43)"
33103 msgstr "(Додано у 1.0.43)"
33104
33105 #. type: =head2
33106 #: ../src/guestfs-actions.pod:5738
33107 msgid "guestfs_ntfsresize"
33108 msgstr ""
33109
33110 #. type: verbatim
33111 #: ../src/guestfs-actions.pod:5740
33112 #, no-wrap
33113 msgid ""
33114 " int\n"
33115 " guestfs_ntfsresize (guestfs_h *g,\n"
33116 "                     const char *device);\n"
33117 "\n"
33118 msgstr ""
33119
33120 #. type: textblock
33121 #: ../src/guestfs-actions.pod:5744 ../src/guestfs-actions.pod:5844
33122 msgid ""
33123 "I<This function is deprecated.> In new code, use the L</"
33124 "guestfs_ntfsresize_opts> call instead."
33125 msgstr ""
33126
33127 #. type: =head2
33128 #: ../src/guestfs-actions.pod:5768
33129 msgid "guestfs_ntfsresize_opts"
33130 msgstr ""
33131
33132 #. type: verbatim
33133 #: ../src/guestfs-actions.pod:5770
33134 #, no-wrap
33135 msgid ""
33136 " int\n"
33137 " guestfs_ntfsresize_opts (guestfs_h *g,\n"
33138 "                          const char *device,\n"
33139 "                          ...);\n"
33140 "\n"
33141 msgstr ""
33142
33143 #. type: verbatim
33144 #: ../src/guestfs-actions.pod:5780
33145 #, no-wrap
33146 msgid ""
33147 " GUESTFS_NTFSRESIZE_OPTS_SIZE, int64_t size,\n"
33148 " GUESTFS_NTFSRESIZE_OPTS_FORCE, int force,\n"
33149 "\n"
33150 msgstr ""
33151
33152 #. type: textblock
33153 #: ../src/guestfs-actions.pod:5800
33154 msgid ""
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 "
33160 "resize."
33161 msgstr ""
33162
33163 #. type: =head2
33164 #: ../src/guestfs-actions.pod:5815
33165 msgid "guestfs_ntfsresize_opts_va"
33166 msgstr ""
33167
33168 #. type: verbatim
33169 #: ../src/guestfs-actions.pod:5817
33170 #, no-wrap
33171 msgid ""
33172 " int\n"
33173 " guestfs_ntfsresize_opts_va (guestfs_h *g,\n"
33174 "                             const char *device,\n"
33175 "                             va_list args);\n"
33176 "\n"
33177 msgstr ""
33178
33179 #. type: textblock
33180 #: ../src/guestfs-actions.pod:5822
33181 msgid "This is the \"va_list variant\" of L</guestfs_ntfsresize_opts>."
33182 msgstr ""
33183
33184 #. type: =head2
33185 #: ../src/guestfs-actions.pod:5826
33186 msgid "guestfs_ntfsresize_opts_argv"
33187 msgstr ""
33188
33189 #. type: verbatim
33190 #: ../src/guestfs-actions.pod:5828
33191 #, no-wrap
33192 msgid ""
33193 " int\n"
33194 " guestfs_ntfsresize_opts_argv (guestfs_h *g,\n"
33195 "                               const char *device,\n"
33196 "                               const struct guestfs_ntfsresize_opts_argv *optargs);\n"
33197 "\n"
33198 msgstr ""
33199
33200 #. type: textblock
33201 #: ../src/guestfs-actions.pod:5833
33202 msgid "This is the \"argv variant\" of L</guestfs_ntfsresize_opts>."
33203 msgstr ""
33204
33205 #. type: =head2
33206 #: ../src/guestfs-actions.pod:5837
33207 msgid "guestfs_ntfsresize_size"
33208 msgstr ""
33209
33210 #. type: verbatim
33211 #: ../src/guestfs-actions.pod:5839
33212 #, no-wrap
33213 msgid ""
33214 " int\n"
33215 " guestfs_ntfsresize_size (guestfs_h *g,\n"
33216 "                          const char *device,\n"
33217 "                          int64_t size);\n"
33218 "\n"
33219 msgstr ""
33220
33221 #. type: textblock
33222 #: ../src/guestfs-actions.pod:5851
33223 msgid ""
33224 "This command is the same as C<guestfs_ntfsresize> except that it allows you "
33225 "to specify the new size (in bytes) explicitly."
33226 msgstr ""
33227
33228 #. type: textblock
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)"
33234
33235 #. type: =head2
33236 #: ../src/guestfs-actions.pod:5858
33237 msgid "guestfs_part_add"
33238 msgstr ""
33239
33240 #. type: verbatim
33241 #: ../src/guestfs-actions.pod:5860
33242 #, no-wrap
33243 msgid ""
33244 " int\n"
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"
33250 "\n"
33251 msgstr ""
33252
33253 #. type: textblock
33254 #: ../src/guestfs-actions.pod:5867
33255 msgid ""
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."
33258 msgstr ""
33259
33260 #. type: textblock
33261 #: ../src/guestfs-actions.pod:5879
33262 msgid ""
33263 "Creating a partition which covers the whole disk is not so easy.  Use "
33264 "C<guestfs_part_disk> to do that."
33265 msgstr ""
33266
33267 #. type: textblock
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)"
33274
33275 #. type: =head2
33276 #: ../src/guestfs-actions.pod:5886
33277 msgid "guestfs_part_del"
33278 msgstr ""
33279
33280 #. type: verbatim
33281 #: ../src/guestfs-actions.pod:5888
33282 #, no-wrap
33283 msgid ""
33284 " int\n"
33285 " guestfs_part_del (guestfs_h *g,\n"
33286 "                   const char *device,\n"
33287 "                   int partnum);\n"
33288 "\n"
33289 msgstr ""
33290
33291 #. type: =head2
33292 #: ../src/guestfs-actions.pod:5903
33293 msgid "guestfs_part_disk"
33294 msgstr ""
33295
33296 #. type: verbatim
33297 #: ../src/guestfs-actions.pod:5905
33298 #, no-wrap
33299 msgid ""
33300 " int\n"
33301 " guestfs_part_disk (guestfs_h *g,\n"
33302 "                    const char *device,\n"
33303 "                    const char *parttype);\n"
33304 "\n"
33305 msgstr ""
33306
33307 #. type: textblock
33308 #: ../src/guestfs-actions.pod:5910
33309 msgid ""
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 "
33312 "disk."
33313 msgstr ""
33314
33315 #. type: textblock
33316 #: ../src/guestfs-actions.pod:5914
33317 msgid ""
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>."
33320 msgstr ""
33321
33322 #. type: =head2
33323 #: ../src/guestfs-actions.pod:5921
33324 msgid "guestfs_part_get_bootable"
33325 msgstr ""
33326
33327 #. type: verbatim
33328 #: ../src/guestfs-actions.pod:5923
33329 #, no-wrap
33330 msgid ""
33331 " int\n"
33332 " guestfs_part_get_bootable (guestfs_h *g,\n"
33333 "                            const char *device,\n"
33334 "                            int partnum);\n"
33335 "\n"
33336 msgstr ""
33337
33338 #. type: textblock
33339 #: ../src/guestfs-actions.pod:5931
33340 msgid "See also C<guestfs_part_set_bootable>."
33341 msgstr ""
33342
33343 #. type: =head2
33344 #: ../src/guestfs-actions.pod:5937
33345 msgid "guestfs_part_get_mbr_id"
33346 msgstr ""
33347
33348 #. type: verbatim
33349 #: ../src/guestfs-actions.pod:5939
33350 #, no-wrap
33351 msgid ""
33352 " int\n"
33353 " guestfs_part_get_mbr_id (guestfs_h *g,\n"
33354 "                          const char *device,\n"
33355 "                          int partnum);\n"
33356 "\n"
33357 msgstr ""
33358
33359 #. type: textblock
33360 #: ../src/guestfs-actions.pod:5947 ../src/guestfs-actions.pod:6129
33361 msgid ""
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>)."
33365 msgstr ""
33366
33367 #. type: =head2
33368 #: ../src/guestfs-actions.pod:5955
33369 msgid "guestfs_part_get_parttype"
33370 msgstr ""
33371
33372 #. type: verbatim
33373 #: ../src/guestfs-actions.pod:5957
33374 #, no-wrap
33375 msgid ""
33376 " char *\n"
33377 " guestfs_part_get_parttype (guestfs_h *g,\n"
33378 "                            const char *device);\n"
33379 "\n"
33380 msgstr ""
33381
33382 #. type: textblock
33383 #: ../src/guestfs-actions.pod:5964
33384 msgid ""
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."
33388 msgstr ""
33389
33390 #. type: =head2
33391 #: ../src/guestfs-actions.pod:5974
33392 msgid "guestfs_part_init"
33393 msgstr ""
33394
33395 #. type: verbatim
33396 #: ../src/guestfs-actions.pod:5976
33397 #, no-wrap
33398 msgid ""
33399 " int\n"
33400 " guestfs_part_init (guestfs_h *g,\n"
33401 "                    const char *device,\n"
33402 "                    const char *parttype);\n"
33403 "\n"
33404 msgstr ""
33405
33406 #. type: textblock
33407 #: ../src/guestfs-actions.pod:5985
33408 msgid ""
33409 "Initially there are no partitions.  Following this, you should call "
33410 "C<guestfs_part_add> for each partition required."
33411 msgstr ""
33412
33413 #. type: =head2
33414 #: ../src/guestfs-actions.pod:6058
33415 msgid "guestfs_part_list"
33416 msgstr "guestfs_part_list"
33417
33418 #. type: verbatim
33419 #: ../src/guestfs-actions.pod:6060
33420 #, no-wrap
33421 msgid ""
33422 " struct guestfs_partition_list *\n"
33423 " guestfs_part_list (guestfs_h *g,\n"
33424 "                    const char *device);\n"
33425 "\n"
33426 msgstr ""
33427 " struct guestfs_partition_list *\n"
33428 " guestfs_part_list (guestfs_h *g,\n"
33429 "                    const char *device);\n"
33430 "\n"
33431
33432 #. type: textblock
33433 #: ../src/guestfs-actions.pod:6077
33434 msgid ""
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>."
33437 msgstr ""
33438
33439 #. type: textblock
33440 #: ../src/guestfs-actions.pod:6090
33441 msgid ""
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 "
33444 "use>."
33445 msgstr ""
33446
33447 #. type: =head2
33448 #: ../src/guestfs-actions.pod:6096
33449 msgid "guestfs_part_set_bootable"
33450 msgstr ""
33451
33452 #. type: verbatim
33453 #: ../src/guestfs-actions.pod:6098
33454 #, no-wrap
33455 msgid ""
33456 " int\n"
33457 " guestfs_part_set_bootable (guestfs_h *g,\n"
33458 "                            const char *device,\n"
33459 "                            int partnum,\n"
33460 "                            int bootable);\n"
33461 "\n"
33462 msgstr ""
33463
33464 #. type: =head2
33465 #: ../src/guestfs-actions.pod:6115
33466 msgid "guestfs_part_set_mbr_id"
33467 msgstr ""
33468
33469 #. type: verbatim
33470 #: ../src/guestfs-actions.pod:6117
33471 #, no-wrap
33472 msgid ""
33473 " int\n"
33474 " guestfs_part_set_mbr_id (guestfs_h *g,\n"
33475 "                          const char *device,\n"
33476 "                          int partnum,\n"
33477 "                          int idbyte);\n"
33478 "\n"
33479 msgstr ""
33480
33481 #. type: =head2
33482 #: ../src/guestfs-actions.pod:6137
33483 msgid "guestfs_part_set_name"
33484 msgstr ""
33485
33486 #. type: verbatim
33487 #: ../src/guestfs-actions.pod:6139
33488 #, no-wrap
33489 msgid ""
33490 " int\n"
33491 " guestfs_part_set_name (guestfs_h *g,\n"
33492 "                        const char *device,\n"
33493 "                        int partnum,\n"
33494 "                        const char *name);\n"
33495 "\n"
33496 msgstr ""
33497
33498 #. type: =head2
33499 #: ../src/guestfs-actions.pod:6155
33500 msgid "guestfs_part_to_dev"
33501 msgstr ""
33502
33503 #. type: verbatim
33504 #: ../src/guestfs-actions.pod:6157
33505 #, no-wrap
33506 msgid ""
33507 " char *\n"
33508 " guestfs_part_to_dev (guestfs_h *g,\n"
33509 "                      const char *partition);\n"
33510 "\n"
33511 msgstr ""
33512
33513 #. type: textblock
33514 #: ../src/guestfs-actions.pod:6165 ../src/guestfs-actions.pod:6184
33515 msgid ""
33516 "The named partition must exist, for example as a string returned from "
33517 "C<guestfs_list_partitions>."
33518 msgstr ""
33519
33520 #. type: textblock
33521 #: ../src/guestfs-actions.pod:6168
33522 msgid "See also C<guestfs_part_to_partnum>."
33523 msgstr ""
33524
33525 #. type: =head2
33526 #: ../src/guestfs-actions.pod:6175
33527 msgid "guestfs_part_to_partnum"
33528 msgstr ""
33529
33530 #. type: verbatim
33531 #: ../src/guestfs-actions.pod:6177
33532 #, no-wrap
33533 msgid ""
33534 " int\n"
33535 " guestfs_part_to_partnum (guestfs_h *g,\n"
33536 "                          const char *partition);\n"
33537 "\n"
33538 msgstr ""
33539
33540 #. type: textblock
33541 #: ../src/guestfs-actions.pod:6187
33542 msgid "See also C<guestfs_part_to_dev>."
33543 msgstr ""
33544
33545 #. type: =head2
33546 #: ../src/guestfs-actions.pod:6193
33547 msgid "guestfs_ping_daemon"
33548 msgstr ""
33549
33550 #. type: verbatim
33551 #: ../src/guestfs-actions.pod:6195
33552 #, no-wrap
33553 msgid ""
33554 " int\n"
33555 " guestfs_ping_daemon (guestfs_h *g);\n"
33556 "\n"
33557 msgstr ""
33558
33559 #. type: =head2
33560 #: ../src/guestfs-actions.pod:6207
33561 msgid "guestfs_pread"
33562 msgstr ""
33563
33564 #. type: verbatim
33565 #: ../src/guestfs-actions.pod:6209
33566 #, no-wrap
33567 msgid ""
33568 " char *\n"
33569 " guestfs_pread (guestfs_h *g,\n"
33570 "                const char *path,\n"
33571 "                int count,\n"
33572 "                int64_t offset,\n"
33573 "                size_t *size_r);\n"
33574 "\n"
33575 msgstr ""
33576
33577 #. type: textblock
33578 #: ../src/guestfs-actions.pod:6222
33579 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>."
33580 msgstr ""
33581
33582 #. type: =head2
33583 #: ../src/guestfs-actions.pod:6233
33584 msgid "guestfs_pread_device"
33585 msgstr ""
33586
33587 #. type: verbatim
33588 #: ../src/guestfs-actions.pod:6235
33589 #, no-wrap
33590 msgid ""
33591 " char *\n"
33592 " guestfs_pread_device (guestfs_h *g,\n"
33593 "                       const char *device,\n"
33594 "                       int count,\n"
33595 "                       int64_t offset,\n"
33596 "                       size_t *size_r);\n"
33597 "\n"
33598 msgstr ""
33599
33600 #. type: textblock
33601 #: ../src/guestfs-actions.pod:6248
33602 msgid "See also C<guestfs_pread>."
33603 msgstr ""
33604
33605 #. type: textblock
33606 #: ../src/guestfs-actions.pod:6257
33607 msgid "(Added in 1.5.21)"
33608 msgstr "(Додано у 1.5.21)"
33609
33610 #. type: =head2
33611 #: ../src/guestfs-actions.pod:6259
33612 msgid "guestfs_pvcreate"
33613 msgstr ""
33614
33615 #. type: verbatim
33616 #: ../src/guestfs-actions.pod:6261
33617 #, no-wrap
33618 msgid ""
33619 " int\n"
33620 " guestfs_pvcreate (guestfs_h *g,\n"
33621 "                   const char *device);\n"
33622 "\n"
33623 msgstr ""
33624
33625 #. type: =head2
33626 #: ../src/guestfs-actions.pod:6273
33627 msgid "guestfs_pvremove"
33628 msgstr ""
33629
33630 #. type: verbatim
33631 #: ../src/guestfs-actions.pod:6275
33632 #, no-wrap
33633 msgid ""
33634 " int\n"
33635 " guestfs_pvremove (guestfs_h *g,\n"
33636 "                   const char *device);\n"
33637 "\n"
33638 msgstr ""
33639
33640 #. type: =head2
33641 #: ../src/guestfs-actions.pod:6290
33642 msgid "guestfs_pvresize"
33643 msgstr ""
33644
33645 #. type: verbatim
33646 #: ../src/guestfs-actions.pod:6292
33647 #, no-wrap
33648 msgid ""
33649 " int\n"
33650 " guestfs_pvresize (guestfs_h *g,\n"
33651 "                   const char *device);\n"
33652 "\n"
33653 msgstr ""
33654
33655 #. type: =head2
33656 #: ../src/guestfs-actions.pod:6303
33657 msgid "guestfs_pvresize_size"
33658 msgstr ""
33659
33660 #. type: verbatim
33661 #: ../src/guestfs-actions.pod:6305
33662 #, no-wrap
33663 msgid ""
33664 " int\n"
33665 " guestfs_pvresize_size (guestfs_h *g,\n"
33666 "                        const char *device,\n"
33667 "                        int64_t size);\n"
33668 "\n"
33669 msgstr ""
33670
33671 #. type: textblock
33672 #: ../src/guestfs-actions.pod:6310
33673 msgid ""
33674 "This command is the same as C<guestfs_pvresize> except that it allows you to "
33675 "specify the new size (in bytes) explicitly."
33676 msgstr ""
33677
33678 #. type: =head2
33679 #: ../src/guestfs-actions.pod:6317
33680 msgid "guestfs_pvs"
33681 msgstr ""
33682
33683 #. type: verbatim
33684 #: ../src/guestfs-actions.pod:6319
33685 #, no-wrap
33686 msgid ""
33687 " char **\n"
33688 " guestfs_pvs (guestfs_h *g);\n"
33689 "\n"
33690 msgstr ""
33691
33692 #. type: textblock
33693 #: ../src/guestfs-actions.pod:6328
33694 msgid "See also C<guestfs_pvs_full>."
33695 msgstr ""
33696
33697 #. type: =head2
33698 #: ../src/guestfs-actions.pod:6336
33699 msgid "guestfs_pvs_full"
33700 msgstr ""
33701
33702 #. type: verbatim
33703 #: ../src/guestfs-actions.pod:6338
33704 #, no-wrap
33705 msgid ""
33706 " struct guestfs_lvm_pv_list *\n"
33707 " guestfs_pvs_full (guestfs_h *g);\n"
33708 "\n"
33709 msgstr ""
33710
33711 #. type: textblock
33712 #: ../src/guestfs-actions.pod:6344
33713 msgid ""
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>."
33716 msgstr ""
33717
33718 #. type: =head2
33719 #: ../src/guestfs-actions.pod:6350
33720 msgid "guestfs_pvuuid"
33721 msgstr ""
33722
33723 #. type: verbatim
33724 #: ../src/guestfs-actions.pod:6352
33725 #, no-wrap
33726 msgid ""
33727 " char *\n"
33728 " guestfs_pvuuid (guestfs_h *g,\n"
33729 "                 const char *device);\n"
33730 "\n"
33731 msgstr ""
33732
33733 #. type: =head2
33734 #: ../src/guestfs-actions.pod:6363
33735 msgid "guestfs_pwrite"
33736 msgstr ""
33737
33738 #. type: verbatim
33739 #: ../src/guestfs-actions.pod:6365
33740 #, no-wrap
33741 msgid ""
33742 " int\n"
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"
33748 "\n"
33749 msgstr ""
33750
33751 #. type: textblock
33752 #: ../src/guestfs-actions.pod:6381
33753 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>."
33754 msgstr ""
33755
33756 #. type: =head2
33757 #: ../src/guestfs-actions.pod:6390
33758 msgid "guestfs_pwrite_device"
33759 msgstr ""
33760
33761 #. type: verbatim
33762 #: ../src/guestfs-actions.pod:6392
33763 #, no-wrap
33764 msgid ""
33765 " int\n"
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"
33771 "\n"
33772 msgstr ""
33773
33774 #. type: textblock
33775 #: ../src/guestfs-actions.pod:6407
33776 msgid "See also C<guestfs_pwrite>."
33777 msgstr ""
33778
33779 #. type: textblock
33780 #: ../src/guestfs-actions.pod:6414
33781 msgid "(Added in 1.5.20)"
33782 msgstr "(Додано у 1.5.20)"
33783
33784 #. type: =head2
33785 #: ../src/guestfs-actions.pod:6416
33786 msgid "guestfs_read_file"
33787 msgstr ""
33788
33789 #. type: verbatim
33790 #: ../src/guestfs-actions.pod:6418
33791 #, no-wrap
33792 msgid ""
33793 " char *\n"
33794 " guestfs_read_file (guestfs_h *g,\n"
33795 "                    const char *path,\n"
33796 "                    size_t *size_r);\n"
33797 "\n"
33798 msgstr ""
33799
33800 #. type: textblock
33801 #: ../src/guestfs-actions.pod:6426
33802 msgid ""
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."
33806 msgstr ""
33807
33808 #. type: textblock
33809 #: ../src/guestfs-actions.pod:6438
33810 msgid "(Added in 1.0.63)"
33811 msgstr "(Додано у 1.0.63)"
33812
33813 #. type: =head2
33814 #: ../src/guestfs-actions.pod:6440
33815 msgid "guestfs_read_lines"
33816 msgstr ""
33817
33818 #. type: verbatim
33819 #: ../src/guestfs-actions.pod:6442
33820 #, no-wrap
33821 msgid ""
33822 " char **\n"
33823 " guestfs_read_lines (guestfs_h *g,\n"
33824 "                     const char *path);\n"
33825 "\n"
33826 msgstr ""
33827
33828 #. type: textblock
33829 #: ../src/guestfs-actions.pod:6451
33830 msgid ""
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."
33835 msgstr ""
33836
33837 #. type: =head2
33838 #: ../src/guestfs-actions.pod:6462
33839 msgid "guestfs_readdir"
33840 msgstr ""
33841
33842 #. type: verbatim
33843 #: ../src/guestfs-actions.pod:6464
33844 #, no-wrap
33845 msgid ""
33846 " struct guestfs_dirent_list *\n"
33847 " guestfs_readdir (guestfs_h *g,\n"
33848 "                  const char *dir);\n"
33849 "\n"
33850 msgstr ""
33851
33852 #. type: textblock
33853 #: ../src/guestfs-actions.pod:6518
33854 msgid ""
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>."
33858 msgstr ""
33859
33860 #. type: textblock
33861 #: ../src/guestfs-actions.pod:6522
33862 msgid ""
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>."
33865 msgstr ""
33866
33867 #. type: =head2
33868 #: ../src/guestfs-actions.pod:6528
33869 msgid "guestfs_readlink"
33870 msgstr ""
33871
33872 #. type: verbatim
33873 #: ../src/guestfs-actions.pod:6530
33874 #, no-wrap
33875 msgid ""
33876 " char *\n"
33877 " guestfs_readlink (guestfs_h *g,\n"
33878 "                   const char *path);\n"
33879 "\n"
33880 msgstr ""
33881
33882 #. type: =head2
33883 #: ../src/guestfs-actions.pod:6541
33884 msgid "guestfs_readlinklist"
33885 msgstr ""
33886
33887 #. type: verbatim
33888 #: ../src/guestfs-actions.pod:6543
33889 #, no-wrap
33890 msgid ""
33891 " char **\n"
33892 " guestfs_readlinklist (guestfs_h *g,\n"
33893 "                       const char *path,\n"
33894 "                       char *const *names);\n"
33895 "\n"
33896 msgstr ""
33897
33898 #. type: =head2
33899 #: ../src/guestfs-actions.pod:6576
33900 msgid "guestfs_realpath"
33901 msgstr ""
33902
33903 #. type: verbatim
33904 #: ../src/guestfs-actions.pod:6578
33905 #, no-wrap
33906 msgid ""
33907 " char *\n"
33908 " guestfs_realpath (guestfs_h *g,\n"
33909 "                   const char *path);\n"
33910 "\n"
33911 msgstr ""
33912
33913 #. type: =head2
33914 #: ../src/guestfs-actions.pod:6590
33915 msgid "guestfs_removexattr"
33916 msgstr ""
33917
33918 #. type: verbatim
33919 #: ../src/guestfs-actions.pod:6592
33920 #, no-wrap
33921 msgid ""
33922 " int\n"
33923 " guestfs_removexattr (guestfs_h *g,\n"
33924 "                      const char *xattr,\n"
33925 "                      const char *path);\n"
33926 "\n"
33927 msgstr ""
33928
33929 #. type: textblock
33930 #: ../src/guestfs-actions.pod:6600
33931 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>."
33932 msgstr ""
33933
33934 #. type: =head2
33935 #: ../src/guestfs-actions.pod:6606
33936 msgid "guestfs_resize2fs"
33937 msgstr ""
33938
33939 #. type: verbatim
33940 #: ../src/guestfs-actions.pod:6608
33941 #, no-wrap
33942 msgid ""
33943 " int\n"
33944 " guestfs_resize2fs (guestfs_h *g,\n"
33945 "                    const char *device);\n"
33946 "\n"
33947 msgstr ""
33948
33949 #. type: textblock
33950 #: ../src/guestfs-actions.pod:6615
33951 msgid ""
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."
33956 msgstr ""
33957
33958 #. type: =head2
33959 #: ../src/guestfs-actions.pod:6625
33960 msgid "guestfs_resize2fs_M"
33961 msgstr ""
33962
33963 #. type: verbatim
33964 #: ../src/guestfs-actions.pod:6627
33965 #, no-wrap
33966 msgid ""
33967 " int\n"
33968 " guestfs_resize2fs_M (guestfs_h *g,\n"
33969 "                      const char *device);\n"
33970 "\n"
33971 msgstr ""
33972
33973 #. type: textblock
33974 #: ../src/guestfs-actions.pod:6631
33975 msgid ""
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."
33979 msgstr ""
33980
33981 #. type: textblock
33982 #: ../src/guestfs-actions.pod:6635
33983 msgid ""
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."
33988 msgstr ""
33989
33990 #. type: =head2
33991 #: ../src/guestfs-actions.pod:6644
33992 msgid "guestfs_resize2fs_size"
33993 msgstr ""
33994
33995 #. type: verbatim
33996 #: ../src/guestfs-actions.pod:6646
33997 #, no-wrap
33998 msgid ""
33999 " int\n"
34000 " guestfs_resize2fs_size (guestfs_h *g,\n"
34001 "                         const char *device,\n"
34002 "                         int64_t size);\n"
34003 "\n"
34004 msgstr ""
34005
34006 #. type: textblock
34007 #: ../src/guestfs-actions.pod:6651
34008 msgid ""
34009 "This command is the same as C<guestfs_resize2fs> except that it allows you "
34010 "to specify the new size (in bytes) explicitly."
34011 msgstr ""
34012
34013 #. type: =head2
34014 #: ../src/guestfs-actions.pod:6658
34015 msgid "guestfs_rm"
34016 msgstr ""
34017
34018 #. type: verbatim
34019 #: ../src/guestfs-actions.pod:6660
34020 #, no-wrap
34021 msgid ""
34022 " int\n"
34023 " guestfs_rm (guestfs_h *g,\n"
34024 "             const char *path);\n"
34025 "\n"
34026 msgstr ""
34027
34028 #. type: =head2
34029 #: ../src/guestfs-actions.pod:6670
34030 msgid "guestfs_rm_rf"
34031 msgstr ""
34032
34033 #. type: verbatim
34034 #: ../src/guestfs-actions.pod:6672
34035 #, no-wrap
34036 msgid ""
34037 " int\n"
34038 " guestfs_rm_rf (guestfs_h *g,\n"
34039 "                const char *path);\n"
34040 "\n"
34041 msgstr ""
34042
34043 #. type: =head2
34044 #: ../src/guestfs-actions.pod:6684
34045 msgid "guestfs_rmdir"
34046 msgstr ""
34047
34048 #. type: verbatim
34049 #: ../src/guestfs-actions.pod:6686
34050 #, no-wrap
34051 msgid ""
34052 " int\n"
34053 " guestfs_rmdir (guestfs_h *g,\n"
34054 "                const char *path);\n"
34055 "\n"
34056 msgstr ""
34057
34058 #. type: =head2
34059 #: ../src/guestfs-actions.pod:6696
34060 msgid "guestfs_rmmountpoint"
34061 msgstr ""
34062
34063 #. type: verbatim
34064 #: ../src/guestfs-actions.pod:6698
34065 #, no-wrap
34066 msgid ""
34067 " int\n"
34068 " guestfs_rmmountpoint (guestfs_h *g,\n"
34069 "                       const char *exemptpath);\n"
34070 "\n"
34071 msgstr ""
34072
34073 #. type: textblock
34074 #: ../src/guestfs-actions.pod:6702
34075 msgid ""
34076 "This calls removes a mountpoint that was previously created with "
34077 "C<guestfs_mkmountpoint>.  See C<guestfs_mkmountpoint> for full details."
34078 msgstr ""
34079
34080 #. type: =head2
34081 #: ../src/guestfs-actions.pod:6710
34082 msgid "guestfs_scrub_device"
34083 msgstr ""
34084
34085 #. type: verbatim
34086 #: ../src/guestfs-actions.pod:6712
34087 #, no-wrap
34088 msgid ""
34089 " int\n"
34090 " guestfs_scrub_device (guestfs_h *g,\n"
34091 "                       const char *device);\n"
34092 "\n"
34093 msgstr ""
34094
34095 #. type: textblock
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)"
34100
34101 #. type: =head2
34102 #: ../src/guestfs-actions.pod:6726
34103 msgid "guestfs_scrub_file"
34104 msgstr ""
34105
34106 #. type: verbatim
34107 #: ../src/guestfs-actions.pod:6728
34108 #, no-wrap
34109 msgid ""
34110 " int\n"
34111 " guestfs_scrub_file (guestfs_h *g,\n"
34112 "                     const char *file);\n"
34113 "\n"
34114 msgstr ""
34115
34116 #. type: =head2
34117 #: ../src/guestfs-actions.pod:6744
34118 msgid "guestfs_scrub_freespace"
34119 msgstr ""
34120
34121 #. type: verbatim
34122 #: ../src/guestfs-actions.pod:6746
34123 #, no-wrap
34124 msgid ""
34125 " int\n"
34126 " guestfs_scrub_freespace (guestfs_h *g,\n"
34127 "                          const char *dir);\n"
34128 "\n"
34129 msgstr ""
34130
34131 #. type: textblock
34132 #: ../src/guestfs-actions.pod:6750
34133 msgid ""
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>."
34138 msgstr ""
34139
34140 #. type: =head2
34141 #: ../src/guestfs-actions.pod:6763
34142 msgid "guestfs_set_append"
34143 msgstr ""
34144
34145 #. type: verbatim
34146 #: ../src/guestfs-actions.pod:6765
34147 #, no-wrap
34148 msgid ""
34149 " int\n"
34150 " guestfs_set_append (guestfs_h *g,\n"
34151 "                     const char *append);\n"
34152 "\n"
34153 msgstr ""
34154
34155 #. type: =head2
34156 #: ../src/guestfs-actions.pod:6782
34157 msgid "guestfs_set_attach_method"
34158 msgstr ""
34159
34160 #. type: verbatim
34161 #: ../src/guestfs-actions.pod:6784
34162 #, no-wrap
34163 msgid ""
34164 " int\n"
34165 " guestfs_set_attach_method (guestfs_h *g,\n"
34166 "                            const char *attachmethod);\n"
34167 "\n"
34168 msgstr ""
34169
34170 #. type: =head2
34171 #: ../src/guestfs-actions.pod:6812
34172 msgid "guestfs_set_autosync"
34173 msgstr ""
34174
34175 #. type: verbatim
34176 #: ../src/guestfs-actions.pod:6814
34177 #, no-wrap
34178 msgid ""
34179 " int\n"
34180 " guestfs_set_autosync (guestfs_h *g,\n"
34181 "                       int autosync);\n"
34182 "\n"
34183 msgstr ""
34184
34185 #. type: =head2
34186 #: ../src/guestfs-actions.pod:6830
34187 msgid "guestfs_set_direct"
34188 msgstr ""
34189
34190 #. type: verbatim
34191 #: ../src/guestfs-actions.pod:6832
34192 #, no-wrap
34193 msgid ""
34194 " int\n"
34195 " guestfs_set_direct (guestfs_h *g,\n"
34196 "                     int direct);\n"
34197 "\n"
34198 msgstr ""
34199
34200 #. type: textblock
34201 #: ../src/guestfs-actions.pod:6840
34202 msgid ""
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 "
34205 "stdout."
34206 msgstr ""
34207
34208 #. type: =head2
34209 #: ../src/guestfs-actions.pod:6853
34210 msgid "guestfs_set_e2label"
34211 msgstr ""
34212
34213 #. type: verbatim
34214 #: ../src/guestfs-actions.pod:6855
34215 #, no-wrap
34216 msgid ""
34217 " int\n"
34218 " guestfs_set_e2label (guestfs_h *g,\n"
34219 "                      const char *device,\n"
34220 "                      const char *label);\n"
34221 "\n"
34222 msgstr ""
34223
34224 #. type: textblock
34225 #: ../src/guestfs-actions.pod:6864
34226 msgid ""
34227 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return "
34228 "the existing label on a filesystem."
34229 msgstr ""
34230
34231 #. type: =head2
34232 #: ../src/guestfs-actions.pod:6871
34233 msgid "guestfs_set_e2uuid"
34234 msgstr ""
34235
34236 #. type: verbatim
34237 #: ../src/guestfs-actions.pod:6873
34238 #, no-wrap
34239 msgid ""
34240 " int\n"
34241 " guestfs_set_e2uuid (guestfs_h *g,\n"
34242 "                     const char *device,\n"
34243 "                     const char *uuid);\n"
34244 "\n"
34245 msgstr ""
34246
34247 #. type: textblock
34248 #: ../src/guestfs-actions.pod:6883
34249 msgid ""
34250 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return "
34251 "the existing UUID of a filesystem."
34252 msgstr ""
34253
34254 #. type: =head2
34255 #: ../src/guestfs-actions.pod:6890
34256 msgid "guestfs_set_memsize"
34257 msgstr ""
34258
34259 #. type: verbatim
34260 #: ../src/guestfs-actions.pod:6892
34261 #, no-wrap
34262 msgid ""
34263 " int\n"
34264 " guestfs_set_memsize (guestfs_h *g,\n"
34265 "                      int memsize);\n"
34266 "\n"
34267 msgstr ""
34268
34269 #. type: textblock
34270 #: ../src/guestfs-actions.pod:6896
34271 msgid ""
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>."
34274 msgstr ""
34275
34276 #. type: =head2
34277 #: ../src/guestfs-actions.pod:6911
34278 msgid "guestfs_set_network"
34279 msgstr ""
34280
34281 #. type: verbatim
34282 #: ../src/guestfs-actions.pod:6913
34283 #, no-wrap
34284 msgid ""
34285 " int\n"
34286 " guestfs_set_network (guestfs_h *g,\n"
34287 "                      int network);\n"
34288 "\n"
34289 msgstr ""
34290
34291 #. type: textblock
34292 #: ../src/guestfs-actions.pod:6923
34293 msgid ""
34294 "You must call this before calling C<guestfs_launch>, otherwise it has no "
34295 "effect."
34296 msgstr ""
34297
34298 #. type: =head2
34299 #: ../src/guestfs-actions.pod:6930
34300 msgid "guestfs_set_path"
34301 msgstr ""
34302
34303 #. type: verbatim
34304 #: ../src/guestfs-actions.pod:6932
34305 #, no-wrap
34306 msgid ""
34307 " int\n"
34308 " guestfs_set_path (guestfs_h *g,\n"
34309 "                   const char *searchpath);\n"
34310 "\n"
34311 msgstr ""
34312
34313 #. type: =head2
34314 #: ../src/guestfs-actions.pod:6947
34315 msgid "guestfs_set_pgroup"
34316 msgstr ""
34317
34318 #. type: verbatim
34319 #: ../src/guestfs-actions.pod:6949
34320 #, no-wrap
34321 msgid ""
34322 " int\n"
34323 " guestfs_set_pgroup (guestfs_h *g,\n"
34324 "                     int pgroup);\n"
34325 "\n"
34326 msgstr ""
34327
34328 #. type: =head2
34329 #: ../src/guestfs-actions.pod:6966
34330 msgid "guestfs_set_qemu"
34331 msgstr ""
34332
34333 #. type: verbatim
34334 #: ../src/guestfs-actions.pod:6968
34335 #, no-wrap
34336 msgid ""
34337 " int\n"
34338 " guestfs_set_qemu (guestfs_h *g,\n"
34339 "                   const char *qemu);\n"
34340 "\n"
34341 msgstr ""
34342
34343 #. type: =head2
34344 #: ../src/guestfs-actions.pod:6994
34345 msgid "guestfs_set_recovery_proc"
34346 msgstr ""
34347
34348 #. type: verbatim
34349 #: ../src/guestfs-actions.pod:6996
34350 #, no-wrap
34351 msgid ""
34352 " int\n"
34353 " guestfs_set_recovery_proc (guestfs_h *g,\n"
34354 "                            int recoveryproc);\n"
34355 "\n"
34356 msgstr ""
34357
34358 #. type: textblock
34359 #: ../src/guestfs-actions.pod:7000
34360 msgid ""
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 "
34364 "abruptly."
34365 msgstr ""
34366
34367 #. type: textblock
34368 #: ../src/guestfs-actions.pod:7005
34369 msgid ""
34370 "This only has any effect if called before C<guestfs_launch>, and the default "
34371 "is true."
34372 msgstr ""
34373
34374 #. type: =head2
34375 #: ../src/guestfs-actions.pod:7018
34376 msgid "guestfs_set_selinux"
34377 msgstr ""
34378
34379 #. type: verbatim
34380 #: ../src/guestfs-actions.pod:7020
34381 #, no-wrap
34382 msgid ""
34383 " int\n"
34384 " guestfs_set_selinux (guestfs_h *g,\n"
34385 "                      int selinux);\n"
34386 "\n"
34387 msgstr ""
34388
34389 #. type: =head2
34390 #: ../src/guestfs-actions.pod:7037
34391 msgid "guestfs_set_smp"
34392 msgstr ""
34393
34394 #. type: verbatim
34395 #: ../src/guestfs-actions.pod:7039
34396 #, no-wrap
34397 msgid ""
34398 " int\n"
34399 " guestfs_set_smp (guestfs_h *g,\n"
34400 "                  int smp);\n"
34401 "\n"
34402 msgstr ""
34403
34404 #. type: textblock
34405 #: ../src/guestfs-actions.pod:7047
34406 msgid "This function must be called before C<guestfs_launch>."
34407 msgstr ""
34408
34409 #. type: =head2
34410 #: ../src/guestfs-actions.pod:7053
34411 msgid "guestfs_set_trace"
34412 msgstr ""
34413
34414 #. type: verbatim
34415 #: ../src/guestfs-actions.pod:7055
34416 #, no-wrap
34417 msgid ""
34418 " int\n"
34419 " guestfs_set_trace (guestfs_h *g,\n"
34420 "                    int trace);\n"
34421 "\n"
34422 msgstr ""
34423
34424 #. type: textblock
34425 #: ../src/guestfs-actions.pod:7069
34426 msgid ""
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>)."
34429 msgstr ""
34430
34431 #. type: =head2
34432 #: ../src/guestfs-actions.pod:7077
34433 msgid "guestfs_set_verbose"
34434 msgstr ""
34435
34436 #. type: verbatim
34437 #: ../src/guestfs-actions.pod:7079
34438 #, no-wrap
34439 msgid ""
34440 " int\n"
34441 " guestfs_set_verbose (guestfs_h *g,\n"
34442 "                      int verbose);\n"
34443 "\n"
34444 msgstr ""
34445
34446 #. type: textblock
34447 #: ../src/guestfs-actions.pod:7088
34448 msgid ""
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>)."
34451 msgstr ""
34452
34453 #. type: =head2
34454 #: ../src/guestfs-actions.pod:7096
34455 msgid "guestfs_setcon"
34456 msgstr ""
34457
34458 #. type: verbatim
34459 #: ../src/guestfs-actions.pod:7098
34460 #, no-wrap
34461 msgid ""
34462 " int\n"
34463 " guestfs_setcon (guestfs_h *g,\n"
34464 "                 const char *context);\n"
34465 "\n"
34466 msgstr ""
34467
34468 #. type: =head2
34469 #: ../src/guestfs-actions.pod:7111
34470 msgid "guestfs_setxattr"
34471 msgstr ""
34472
34473 #. type: verbatim
34474 #: ../src/guestfs-actions.pod:7113
34475 #, no-wrap
34476 msgid ""
34477 " int\n"
34478 " guestfs_setxattr (guestfs_h *g,\n"
34479 "                   const char *xattr,\n"
34480 "                   const char *val,\n"
34481 "                   int vallen,\n"
34482 "                   const char *path);\n"
34483 "\n"
34484 msgstr ""
34485
34486 #. type: textblock
34487 #: ../src/guestfs-actions.pod:7124
34488 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>."
34489 msgstr ""
34490
34491 #. type: =head2
34492 #: ../src/guestfs-actions.pod:7130
34493 msgid "guestfs_sfdisk"
34494 msgstr ""
34495
34496 #. type: verbatim
34497 #: ../src/guestfs-actions.pod:7132
34498 #, no-wrap
34499 msgid ""
34500 " int\n"
34501 " guestfs_sfdisk (guestfs_h *g,\n"
34502 "                 const char *device,\n"
34503 "                 int cyls,\n"
34504 "                 int heads,\n"
34505 "                 int sectors,\n"
34506 "                 char *const *lines);\n"
34507 "\n"
34508 msgstr ""
34509
34510 #. type: textblock
34511 #: ../src/guestfs-actions.pod:7140 ../src/guestfs-actions.pod:7181
34512 #: ../src/guestfs-actions.pod:7212
34513 msgid ""
34514 "I<This function is deprecated.> In new code, use the L</guestfs_part_add> "
34515 "call instead."
34516 msgstr ""
34517
34518 #. type: textblock
34519 #: ../src/guestfs-actions.pod:7167
34520 msgid ""
34521 "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>"
34522 msgstr ""
34523
34524 #. type: =head2
34525 #: ../src/guestfs-actions.pod:7174
34526 msgid "guestfs_sfdiskM"
34527 msgstr ""
34528
34529 #. type: verbatim
34530 #: ../src/guestfs-actions.pod:7176
34531 #, no-wrap
34532 msgid ""
34533 " int\n"
34534 " guestfs_sfdiskM (guestfs_h *g,\n"
34535 "                  const char *device,\n"
34536 "                  char *const *lines);\n"
34537 "\n"
34538 msgstr ""
34539
34540 #. type: textblock
34541 #: ../src/guestfs-actions.pod:7188
34542 msgid ""
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."
34547 msgstr ""
34548
34549 #. type: textblock
34550 #: ../src/guestfs-actions.pod:7194
34551 msgid ""
34552 "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and "
34553 "C<guestfs_part_disk>"
34554 msgstr ""
34555
34556 #. type: =head2
34557 #: ../src/guestfs-actions.pod:7201
34558 msgid "guestfs_sfdisk_N"
34559 msgstr ""
34560
34561 #. type: verbatim
34562 #: ../src/guestfs-actions.pod:7203
34563 #, no-wrap
34564 msgid ""
34565 " int\n"
34566 " guestfs_sfdisk_N (guestfs_h *g,\n"
34567 "                   const char *device,\n"
34568 "                   int partnum,\n"
34569 "                   int cyls,\n"
34570 "                   int heads,\n"
34571 "                   int sectors,\n"
34572 "                   const char *line);\n"
34573 "\n"
34574 msgstr ""
34575
34576 #. type: textblock
34577 #: ../src/guestfs-actions.pod:7222
34578 msgid ""
34579 "For other parameters, see C<guestfs_sfdisk>.  You should usually pass C<0> "
34580 "for the cyls/heads/sectors parameters."
34581 msgstr ""
34582
34583 #. type: textblock
34584 #: ../src/guestfs-actions.pod:7225
34585 msgid "See also: C<guestfs_part_add>"
34586 msgstr ""
34587
34588 #. type: =head2
34589 #: ../src/guestfs-actions.pod:7231
34590 msgid "guestfs_sfdisk_disk_geometry"
34591 msgstr ""
34592
34593 #. type: verbatim
34594 #: ../src/guestfs-actions.pod:7233
34595 #, no-wrap
34596 msgid ""
34597 " char *\n"
34598 " guestfs_sfdisk_disk_geometry (guestfs_h *g,\n"
34599 "                               const char *device);\n"
34600 "\n"
34601 msgstr ""
34602
34603 #. type: textblock
34604 #: ../src/guestfs-actions.pod:7237
34605 msgid ""
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>)."
34610 msgstr ""
34611
34612 #. type: =head2
34613 #: ../src/guestfs-actions.pod:7250
34614 msgid "guestfs_sfdisk_kernel_geometry"
34615 msgstr ""
34616
34617 #. type: verbatim
34618 #: ../src/guestfs-actions.pod:7252
34619 #, no-wrap
34620 msgid ""
34621 " char *\n"
34622 " guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n"
34623 "                                 const char *device);\n"
34624 "\n"
34625 msgstr ""
34626
34627 #. type: =head2
34628 #: ../src/guestfs-actions.pod:7266
34629 msgid "guestfs_sfdisk_l"
34630 msgstr ""
34631
34632 #. type: verbatim
34633 #: ../src/guestfs-actions.pod:7268
34634 #, no-wrap
34635 msgid ""
34636 " char *\n"
34637 " guestfs_sfdisk_l (guestfs_h *g,\n"
34638 "                   const char *device);\n"
34639 "\n"
34640 msgstr ""
34641
34642 #. type: textblock
34643 #: ../src/guestfs-actions.pod:7272
34644 msgid ""
34645 "I<This function is deprecated.> In new code, use the L</guestfs_part_list> "
34646 "call instead."
34647 msgstr ""
34648
34649 #. type: textblock
34650 #: ../src/guestfs-actions.pod:7283
34651 msgid "See also: C<guestfs_part_list>"
34652 msgstr ""
34653
34654 #. type: =head2
34655 #: ../src/guestfs-actions.pod:7290
34656 msgid "guestfs_sh"
34657 msgstr ""
34658
34659 #. type: verbatim
34660 #: ../src/guestfs-actions.pod:7292
34661 #, no-wrap
34662 msgid ""
34663 " char *\n"
34664 " guestfs_sh (guestfs_h *g,\n"
34665 "             const char *command);\n"
34666 "\n"
34667 msgstr ""
34668
34669 #. type: textblock
34670 #: ../src/guestfs-actions.pod:7299
34671 msgid "This is like C<guestfs_command>, but passes the command to:"
34672 msgstr ""
34673
34674 #. type: textblock
34675 #: ../src/guestfs-actions.pod:7307
34676 msgid "All the provisos about C<guestfs_command> apply to this call."
34677 msgstr ""
34678
34679 #. type: =head2
34680 #: ../src/guestfs-actions.pod:7314
34681 msgid "guestfs_sh_lines"
34682 msgstr ""
34683
34684 #. type: verbatim
34685 #: ../src/guestfs-actions.pod:7316
34686 #, no-wrap
34687 msgid ""
34688 " char **\n"
34689 " guestfs_sh_lines (guestfs_h *g,\n"
34690 "                   const char *command);\n"
34691 "\n"
34692 msgstr ""
34693
34694 #. type: textblock
34695 #: ../src/guestfs-actions.pod:7320
34696 msgid ""
34697 "This is the same as C<guestfs_sh>, but splits the result into a list of "
34698 "lines."
34699 msgstr ""
34700
34701 #. type: textblock
34702 #: ../src/guestfs-actions.pod:7323
34703 msgid "See also: C<guestfs_command_lines>"
34704 msgstr ""
34705
34706 #. type: =head2
34707 #: ../src/guestfs-actions.pod:7331
34708 msgid "guestfs_sleep"
34709 msgstr ""
34710
34711 #. type: verbatim
34712 #: ../src/guestfs-actions.pod:7333
34713 #, no-wrap
34714 msgid ""
34715 " int\n"
34716 " guestfs_sleep (guestfs_h *g,\n"
34717 "                int secs);\n"
34718 "\n"
34719 msgstr ""
34720
34721 #. type: textblock
34722 #: ../src/guestfs-actions.pod:7341
34723 msgid "(Added in 1.0.41)"
34724 msgstr "(Додано у 1.0.41)"
34725
34726 #. type: =head2
34727 #: ../src/guestfs-actions.pod:7343 ../src/guestfs-structs.pod:109
34728 msgid "guestfs_stat"
34729 msgstr ""
34730
34731 #. type: verbatim
34732 #: ../src/guestfs-actions.pod:7345
34733 #, no-wrap
34734 msgid ""
34735 " struct guestfs_stat *\n"
34736 " guestfs_stat (guestfs_h *g,\n"
34737 "               const char *path);\n"
34738 "\n"
34739 msgstr ""
34740
34741 #. type: =head2
34742 #: ../src/guestfs-actions.pod:7359 ../src/guestfs-structs.pod:135
34743 msgid "guestfs_statvfs"
34744 msgstr ""
34745
34746 #. type: verbatim
34747 #: ../src/guestfs-actions.pod:7361
34748 #, no-wrap
34749 msgid ""
34750 " struct guestfs_statvfs *\n"
34751 " guestfs_statvfs (guestfs_h *g,\n"
34752 "                  const char *path);\n"
34753 "\n"
34754 msgstr ""
34755
34756 #. type: textblock
34757 #: ../src/guestfs-actions.pod:7371
34758 msgid ""
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>."
34761 msgstr ""
34762
34763 #. type: =head2
34764 #: ../src/guestfs-actions.pod:7377
34765 msgid "guestfs_strings"
34766 msgstr ""
34767
34768 #. type: verbatim
34769 #: ../src/guestfs-actions.pod:7379
34770 #, no-wrap
34771 msgid ""
34772 " char **\n"
34773 " guestfs_strings (guestfs_h *g,\n"
34774 "                  const char *path);\n"
34775 "\n"
34776 msgstr ""
34777
34778 #. type: =head2
34779 #: ../src/guestfs-actions.pod:7395
34780 msgid "guestfs_strings_e"
34781 msgstr ""
34782
34783 #. type: verbatim
34784 #: ../src/guestfs-actions.pod:7397
34785 #, no-wrap
34786 msgid ""
34787 " char **\n"
34788 " guestfs_strings_e (guestfs_h *g,\n"
34789 "                    const char *encoding,\n"
34790 "                    const char *path);\n"
34791 "\n"
34792 msgstr ""
34793
34794 #. type: textblock
34795 #: ../src/guestfs-actions.pod:7402
34796 msgid ""
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>."
34799 msgstr ""
34800
34801 #. type: textblock
34802 #: ../src/guestfs-actions.pod:7412
34803 msgid ""
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)."
34806 msgstr ""
34807
34808 #. type: =head2
34809 #: ../src/guestfs-actions.pod:7450
34810 msgid "guestfs_swapoff_device"
34811 msgstr ""
34812
34813 #. type: verbatim
34814 #: ../src/guestfs-actions.pod:7452
34815 #, no-wrap
34816 msgid ""
34817 " int\n"
34818 " guestfs_swapoff_device (guestfs_h *g,\n"
34819 "                         const char *device);\n"
34820 "\n"
34821 msgstr ""
34822
34823 #. type: textblock
34824 #: ../src/guestfs-actions.pod:7456
34825 msgid ""
34826 "This command disables the libguestfs appliance swap device or partition "
34827 "named C<device>.  See C<guestfs_swapon_device>."
34828 msgstr ""
34829
34830 #. type: =head2
34831 #: ../src/guestfs-actions.pod:7464
34832 msgid "guestfs_swapoff_file"
34833 msgstr ""
34834
34835 #. type: verbatim
34836 #: ../src/guestfs-actions.pod:7466
34837 #, no-wrap
34838 msgid ""
34839 " int\n"
34840 " guestfs_swapoff_file (guestfs_h *g,\n"
34841 "                       const char *file);\n"
34842 "\n"
34843 msgstr ""
34844
34845 #. type: =head2
34846 #: ../src/guestfs-actions.pod:7476
34847 msgid "guestfs_swapoff_label"
34848 msgstr ""
34849
34850 #. type: verbatim
34851 #: ../src/guestfs-actions.pod:7478
34852 #, no-wrap
34853 msgid ""
34854 " int\n"
34855 " guestfs_swapoff_label (guestfs_h *g,\n"
34856 "                        const char *label);\n"
34857 "\n"
34858 msgstr ""
34859
34860 #. type: =head2
34861 #: ../src/guestfs-actions.pod:7489
34862 msgid "guestfs_swapoff_uuid"
34863 msgstr ""
34864
34865 #. type: verbatim
34866 #: ../src/guestfs-actions.pod:7491
34867 #, no-wrap
34868 msgid ""
34869 " int\n"
34870 " guestfs_swapoff_uuid (guestfs_h *g,\n"
34871 "                       const char *uuid);\n"
34872 "\n"
34873 msgstr ""
34874
34875 #. type: =head2
34876 #: ../src/guestfs-actions.pod:7502
34877 msgid "guestfs_swapon_device"
34878 msgstr ""
34879
34880 #. type: verbatim
34881 #: ../src/guestfs-actions.pod:7504
34882 #, no-wrap
34883 msgid ""
34884 " int\n"
34885 " guestfs_swapon_device (guestfs_h *g,\n"
34886 "                        const char *device);\n"
34887 "\n"
34888 msgstr ""
34889
34890 #. type: textblock
34891 #: ../src/guestfs-actions.pod:7508
34892 msgid ""
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>."
34896 msgstr ""
34897
34898 #. type: =head2
34899 #: ../src/guestfs-actions.pod:7524
34900 msgid "guestfs_swapon_file"
34901 msgstr ""
34902
34903 #. type: verbatim
34904 #: ../src/guestfs-actions.pod:7526
34905 #, no-wrap
34906 msgid ""
34907 " int\n"
34908 " guestfs_swapon_file (guestfs_h *g,\n"
34909 "                      const char *file);\n"
34910 "\n"
34911 msgstr ""
34912
34913 #. type: textblock
34914 #: ../src/guestfs-actions.pod:7530
34915 msgid ""
34916 "This command enables swap to a file.  See C<guestfs_swapon_device> for other "
34917 "notes."
34918 msgstr ""
34919
34920 #. type: =head2
34921 #: ../src/guestfs-actions.pod:7537
34922 msgid "guestfs_swapon_label"
34923 msgstr ""
34924
34925 #. type: verbatim
34926 #: ../src/guestfs-actions.pod:7539
34927 #, no-wrap
34928 msgid ""
34929 " int\n"
34930 " guestfs_swapon_label (guestfs_h *g,\n"
34931 "                       const char *label);\n"
34932 "\n"
34933 msgstr ""
34934
34935 #. type: textblock
34936 #: ../src/guestfs-actions.pod:7543
34937 msgid ""
34938 "This command enables swap to a labeled swap partition.  See "
34939 "C<guestfs_swapon_device> for other notes."
34940 msgstr ""
34941
34942 #. type: =head2
34943 #: ../src/guestfs-actions.pod:7550
34944 msgid "guestfs_swapon_uuid"
34945 msgstr ""
34946
34947 #. type: verbatim
34948 #: ../src/guestfs-actions.pod:7552
34949 #, no-wrap
34950 msgid ""
34951 " int\n"
34952 " guestfs_swapon_uuid (guestfs_h *g,\n"
34953 "                      const char *uuid);\n"
34954 "\n"
34955 msgstr ""
34956
34957 #. type: textblock
34958 #: ../src/guestfs-actions.pod:7556
34959 msgid ""
34960 "This command enables swap to a swap partition with the given UUID.  See "
34961 "C<guestfs_swapon_device> for other notes."
34962 msgstr ""
34963
34964 #. type: =head2
34965 #: ../src/guestfs-actions.pod:7563
34966 msgid "guestfs_sync"
34967 msgstr ""
34968
34969 #. type: verbatim
34970 #: ../src/guestfs-actions.pod:7565
34971 #, no-wrap
34972 msgid ""
34973 " int\n"
34974 " guestfs_sync (guestfs_h *g);\n"
34975 "\n"
34976 msgstr ""
34977
34978 #. type: =head2
34979 #: ../src/guestfs-actions.pod:7578
34980 msgid "guestfs_tail"
34981 msgstr ""
34982
34983 #. type: verbatim
34984 #: ../src/guestfs-actions.pod:7580
34985 #, no-wrap
34986 msgid ""
34987 " char **\n"
34988 " guestfs_tail (guestfs_h *g,\n"
34989 "               const char *path);\n"
34990 "\n"
34991 msgstr ""
34992
34993 #. type: =head2
34994 #: ../src/guestfs-actions.pod:7596
34995 msgid "guestfs_tail_n"
34996 msgstr ""
34997
34998 #. type: verbatim
34999 #: ../src/guestfs-actions.pod:7598
35000 #, no-wrap
35001 msgid ""
35002 " char **\n"
35003 " guestfs_tail_n (guestfs_h *g,\n"
35004 "                 int nrlines,\n"
35005 "                 const char *path);\n"
35006 "\n"
35007 msgstr ""
35008
35009 #. type: =head2
35010 #: ../src/guestfs-actions.pod:7620
35011 msgid "guestfs_tar_in"
35012 msgstr ""
35013
35014 #. type: verbatim
35015 #: ../src/guestfs-actions.pod:7622
35016 #, no-wrap
35017 msgid ""
35018 " int\n"
35019 " guestfs_tar_in (guestfs_h *g,\n"
35020 "                 const char *tarfile,\n"
35021 "                 const char *directory);\n"
35022 "\n"
35023 msgstr ""
35024
35025 #. type: textblock
35026 #: ../src/guestfs-actions.pod:7630
35027 msgid ""
35028 "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>."
35029 msgstr ""
35030
35031 #. type: textblock
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)"
35036
35037 #. type: =head2
35038 #: ../src/guestfs-actions.pod:7637
35039 msgid "guestfs_tar_out"
35040 msgstr ""
35041
35042 #. type: verbatim
35043 #: ../src/guestfs-actions.pod:7639
35044 #, no-wrap
35045 msgid ""
35046 " int\n"
35047 " guestfs_tar_out (guestfs_h *g,\n"
35048 "                  const char *directory,\n"
35049 "                  const char *tarfile);\n"
35050 "\n"
35051 msgstr ""
35052
35053 #. type: textblock
35054 #: ../src/guestfs-actions.pod:7647
35055 msgid ""
35056 "To download a compressed tarball, use C<guestfs_tgz_out> or "
35057 "C<guestfs_txz_out>."
35058 msgstr ""
35059
35060 #. type: =head2
35061 #: ../src/guestfs-actions.pod:7654
35062 msgid "guestfs_tgz_in"
35063 msgstr ""
35064
35065 #. type: verbatim
35066 #: ../src/guestfs-actions.pod:7656
35067 #, no-wrap
35068 msgid ""
35069 " int\n"
35070 " guestfs_tgz_in (guestfs_h *g,\n"
35071 "                 const char *tarball,\n"
35072 "                 const char *directory);\n"
35073 "\n"
35074 msgstr ""
35075
35076 #. type: textblock
35077 #: ../src/guestfs-actions.pod:7664
35078 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>."
35079 msgstr ""
35080
35081 #. type: =head2
35082 #: ../src/guestfs-actions.pod:7670
35083 msgid "guestfs_tgz_out"
35084 msgstr ""
35085
35086 #. type: verbatim
35087 #: ../src/guestfs-actions.pod:7672
35088 #, no-wrap
35089 msgid ""
35090 " int\n"
35091 " guestfs_tgz_out (guestfs_h *g,\n"
35092 "                  const char *directory,\n"
35093 "                  const char *tarball);\n"
35094 "\n"
35095 msgstr ""
35096
35097 #. type: textblock
35098 #: ../src/guestfs-actions.pod:7680
35099 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>."
35100 msgstr ""
35101
35102 #. type: =head2
35103 #: ../src/guestfs-actions.pod:7686
35104 msgid "guestfs_touch"
35105 msgstr ""
35106
35107 #. type: verbatim
35108 #: ../src/guestfs-actions.pod:7688
35109 #, no-wrap
35110 msgid ""
35111 " int\n"
35112 " guestfs_touch (guestfs_h *g,\n"
35113 "                const char *path);\n"
35114 "\n"
35115 msgstr ""
35116
35117 #. type: =head2
35118 #: ../src/guestfs-actions.pod:7703
35119 msgid "guestfs_truncate"
35120 msgstr ""
35121
35122 #. type: verbatim
35123 #: ../src/guestfs-actions.pod:7705
35124 #, no-wrap
35125 msgid ""
35126 " int\n"
35127 " guestfs_truncate (guestfs_h *g,\n"
35128 "                   const char *path);\n"
35129 "\n"
35130 msgstr ""
35131
35132 #. type: =head2
35133 #: ../src/guestfs-actions.pod:7716
35134 msgid "guestfs_truncate_size"
35135 msgstr ""
35136
35137 #. type: verbatim
35138 #: ../src/guestfs-actions.pod:7718
35139 #, no-wrap
35140 msgid ""
35141 " int\n"
35142 " guestfs_truncate_size (guestfs_h *g,\n"
35143 "                        const char *path,\n"
35144 "                        int64_t size);\n"
35145 "\n"
35146 msgstr ""
35147
35148 #. type: textblock
35149 #: ../src/guestfs-actions.pod:7726
35150 msgid ""
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."
35155 msgstr ""
35156
35157 #. type: =head2
35158 #: ../src/guestfs-actions.pod:7736
35159 #, fuzzy
35160 #| msgid "guestfs_mke2fs_J"
35161 msgid "guestfs_tune2fs"
35162 msgstr "guestfs_mke2fs_J"
35163
35164 #. type: verbatim
35165 #: ../src/guestfs-actions.pod:7738
35166 #, fuzzy, no-wrap
35167 #| msgid ""
35168 #| " int\n"
35169 #| " guestfs_lvresize (guestfs_h *g,\n"
35170 #| "                   const char *device,\n"
35171 #| "                   int mbytes);\n"
35172 #| "\n"
35173 msgid ""
35174 " int\n"
35175 " guestfs_tune2fs (guestfs_h *g,\n"
35176 "                  const char *device,\n"
35177 "                  ...);\n"
35178 "\n"
35179 msgstr ""
35180 " int\n"
35181 " guestfs_lvresize (guestfs_h *g,\n"
35182 "                   const char *device,\n"
35183 "                   int mbytes);\n"
35184 "\n"
35185
35186 #. type: verbatim
35187 #: ../src/guestfs-actions.pod:7748
35188 #, no-wrap
35189 msgid ""
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"
35200 "\n"
35201 msgstr ""
35202
35203 #. type: textblock
35204 #: ../src/guestfs-actions.pod:7828
35205 msgid ""
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."
35209 msgstr ""
35210
35211 #. type: =head2
35212 #: ../src/guestfs-actions.pod:7834
35213 #, fuzzy
35214 #| msgid "guestfs_mke2fs_J"
35215 msgid "guestfs_tune2fs_va"
35216 msgstr "guestfs_mke2fs_J"
35217
35218 #. type: verbatim
35219 #: ../src/guestfs-actions.pod:7836
35220 #, fuzzy, no-wrap
35221 #| msgid ""
35222 #| " int\n"
35223 #| " guestfs_lvresize (guestfs_h *g,\n"
35224 #| "                   const char *device,\n"
35225 #| "                   int mbytes);\n"
35226 #| "\n"
35227 msgid ""
35228 " int\n"
35229 " guestfs_tune2fs_va (guestfs_h *g,\n"
35230 "                     const char *device,\n"
35231 "                     va_list args);\n"
35232 "\n"
35233 msgstr ""
35234 " int\n"
35235 " guestfs_lvresize (guestfs_h *g,\n"
35236 "                   const char *device,\n"
35237 "                   int mbytes);\n"
35238 "\n"
35239
35240 #. type: textblock
35241 #: ../src/guestfs-actions.pod:7841
35242 msgid "This is the \"va_list variant\" of L</guestfs_tune2fs>."
35243 msgstr ""
35244
35245 #. type: =head2
35246 #: ../src/guestfs-actions.pod:7845
35247 #, fuzzy
35248 #| msgid "guestfs_mke2fs_J"
35249 msgid "guestfs_tune2fs_argv"
35250 msgstr "guestfs_mke2fs_J"
35251
35252 #. type: verbatim
35253 #: ../src/guestfs-actions.pod:7847
35254 #, fuzzy, no-wrap
35255 #| msgid ""
35256 #| " int\n"
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"
35261 #| "\n"
35262 msgid ""
35263 " int\n"
35264 " guestfs_tune2fs_argv (guestfs_h *g,\n"
35265 "                       const char *device,\n"
35266 "                       const struct guestfs_tune2fs_argv *optargs);\n"
35267 "\n"
35268 msgstr ""
35269 " int\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"
35274 "\n"
35275
35276 #. type: textblock
35277 #: ../src/guestfs-actions.pod:7852
35278 msgid "This is the \"argv variant\" of L</guestfs_tune2fs>."
35279 msgstr ""
35280
35281 #. type: =head2
35282 #: ../src/guestfs-actions.pod:7856
35283 msgid "guestfs_tune2fs_l"
35284 msgstr ""
35285
35286 #. type: verbatim
35287 #: ../src/guestfs-actions.pod:7858
35288 #, no-wrap
35289 msgid ""
35290 " char **\n"
35291 " guestfs_tune2fs_l (guestfs_h *g,\n"
35292 "                    const char *device);\n"
35293 "\n"
35294 msgstr ""
35295
35296 #. type: =head2
35297 #: ../src/guestfs-actions.pod:7878
35298 msgid "guestfs_txz_in"
35299 msgstr ""
35300
35301 #. type: verbatim
35302 #: ../src/guestfs-actions.pod:7880
35303 #, no-wrap
35304 msgid ""
35305 " int\n"
35306 " guestfs_txz_in (guestfs_h *g,\n"
35307 "                 const char *tarball,\n"
35308 "                 const char *directory);\n"
35309 "\n"
35310 msgstr ""
35311
35312 #. type: =head2
35313 #: ../src/guestfs-actions.pod:7892
35314 msgid "guestfs_txz_out"
35315 msgstr ""
35316
35317 #. type: verbatim
35318 #: ../src/guestfs-actions.pod:7894
35319 #, no-wrap
35320 msgid ""
35321 " int\n"
35322 " guestfs_txz_out (guestfs_h *g,\n"
35323 "                  const char *directory,\n"
35324 "                  const char *tarball);\n"
35325 "\n"
35326 msgstr ""
35327
35328 #. type: =head2
35329 #: ../src/guestfs-actions.pod:7906
35330 msgid "guestfs_umask"
35331 msgstr ""
35332
35333 #. type: verbatim
35334 #: ../src/guestfs-actions.pod:7908
35335 #, no-wrap
35336 msgid ""
35337 " int\n"
35338 " guestfs_umask (guestfs_h *g,\n"
35339 "                int mask);\n"
35340 "\n"
35341 msgstr ""
35342
35343 #. type: textblock
35344 #: ../src/guestfs-actions.pod:7924
35345 msgid ""
35346 "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, "
35347 "C<guestfs_mkdir>."
35348 msgstr ""
35349
35350 #. type: =head2
35351 #: ../src/guestfs-actions.pod:7933
35352 msgid "guestfs_umount"
35353 msgstr ""
35354
35355 #. type: verbatim
35356 #: ../src/guestfs-actions.pod:7935
35357 #, no-wrap
35358 msgid ""
35359 " int\n"
35360 " guestfs_umount (guestfs_h *g,\n"
35361 "                 const char *pathordevice);\n"
35362 "\n"
35363 msgstr ""
35364
35365 #. type: =head2
35366 #: ../src/guestfs-actions.pod:7947
35367 msgid "guestfs_umount_all"
35368 msgstr ""
35369
35370 #. type: verbatim
35371 #: ../src/guestfs-actions.pod:7949
35372 #, no-wrap
35373 msgid ""
35374 " int\n"
35375 " guestfs_umount_all (guestfs_h *g);\n"
35376 "\n"
35377 msgstr ""
35378
35379 #. type: =head2
35380 #: ../src/guestfs-actions.pod:7960
35381 msgid "guestfs_upload"
35382 msgstr ""
35383
35384 #. type: verbatim
35385 #: ../src/guestfs-actions.pod:7962
35386 #, no-wrap
35387 msgid ""
35388 " int\n"
35389 " guestfs_upload (guestfs_h *g,\n"
35390 "                 const char *filename,\n"
35391 "                 const char *remotefilename);\n"
35392 "\n"
35393 msgstr ""
35394
35395 #. type: textblock
35396 #: ../src/guestfs-actions.pod:7972
35397 msgid "See also C<guestfs_download>."
35398 msgstr ""
35399
35400 #. type: =head2
35401 #: ../src/guestfs-actions.pod:7983
35402 msgid "guestfs_upload_offset"
35403 msgstr ""
35404
35405 #. type: verbatim
35406 #: ../src/guestfs-actions.pod:7985
35407 #, no-wrap
35408 msgid ""
35409 " int\n"
35410 " guestfs_upload_offset (guestfs_h *g,\n"
35411 "                        const char *filename,\n"
35412 "                        const char *remotefilename,\n"
35413 "                        int64_t offset);\n"
35414 "\n"
35415 msgstr ""
35416
35417 #. type: textblock
35418 #: ../src/guestfs-actions.pod:8001
35419 msgid ""
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."
35423 msgstr ""
35424
35425 #. type: textblock
35426 #: ../src/guestfs-actions.pod:8006
35427 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>."
35428 msgstr ""
35429
35430 #. type: =head2
35431 #: ../src/guestfs-actions.pod:8017
35432 msgid "guestfs_utimens"
35433 msgstr ""
35434
35435 #. type: verbatim
35436 #: ../src/guestfs-actions.pod:8019
35437 #, no-wrap
35438 msgid ""
35439 " int\n"
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"
35446 "\n"
35447 msgstr ""
35448
35449 #. type: =head2
35450 #: ../src/guestfs-actions.pod:8048 ../src/guestfs-structs.pod:175
35451 msgid "guestfs_version"
35452 msgstr ""
35453
35454 #. type: verbatim
35455 #: ../src/guestfs-actions.pod:8050
35456 #, no-wrap
35457 msgid ""
35458 " struct guestfs_version *\n"
35459 " guestfs_version (guestfs_h *g);\n"
35460 "\n"
35461 msgstr ""
35462
35463 #. type: textblock
35464 #: ../src/guestfs-actions.pod:8078
35465 msgid ""
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."
35470 msgstr ""
35471
35472 #. type: textblock
35473 #: ../src/guestfs-actions.pod:8084
35474 msgid ""
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>."
35477 msgstr ""
35478
35479 #. type: textblock
35480 #: ../src/guestfs-actions.pod:8088
35481 msgid "(Added in 1.0.58)"
35482 msgstr "(Додано у 1.0.58)"
35483
35484 #. type: =head2
35485 #: ../src/guestfs-actions.pod:8090
35486 msgid "guestfs_vfs_label"
35487 msgstr ""
35488
35489 #. type: verbatim
35490 #: ../src/guestfs-actions.pod:8092
35491 #, no-wrap
35492 msgid ""
35493 " char *\n"
35494 " guestfs_vfs_label (guestfs_h *g,\n"
35495 "                    const char *device);\n"
35496 "\n"
35497 msgstr ""
35498
35499 #. type: textblock
35500 #: ../src/guestfs-actions.pod:8101
35501 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>."
35502 msgstr ""
35503
35504 #. type: textblock
35505 #: ../src/guestfs-actions.pod:8106 ../src/guestfs-actions.pod:8143
35506 msgid "(Added in 1.3.18)"
35507 msgstr "(Додано у 1.3.18)"
35508
35509 #. type: =head2
35510 #: ../src/guestfs-actions.pod:8108
35511 msgid "guestfs_vfs_type"
35512 msgstr ""
35513
35514 #. type: verbatim
35515 #: ../src/guestfs-actions.pod:8110
35516 #, no-wrap
35517 msgid ""
35518 " char *\n"
35519 " guestfs_vfs_type (guestfs_h *g,\n"
35520 "                   const char *device);\n"
35521 "\n"
35522 msgstr ""
35523
35524 #. type: =head2
35525 #: ../src/guestfs-actions.pod:8127
35526 msgid "guestfs_vfs_uuid"
35527 msgstr ""
35528
35529 #. type: verbatim
35530 #: ../src/guestfs-actions.pod:8129
35531 #, no-wrap
35532 msgid ""
35533 " char *\n"
35534 " guestfs_vfs_uuid (guestfs_h *g,\n"
35535 "                   const char *device);\n"
35536 "\n"
35537 msgstr ""
35538
35539 #. type: textblock
35540 #: ../src/guestfs-actions.pod:8138
35541 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>."
35542 msgstr ""
35543
35544 #. type: =head2
35545 #: ../src/guestfs-actions.pod:8145
35546 msgid "guestfs_vg_activate"
35547 msgstr ""
35548
35549 #. type: verbatim
35550 #: ../src/guestfs-actions.pod:8147
35551 #, no-wrap
35552 msgid ""
35553 " int\n"
35554 " guestfs_vg_activate (guestfs_h *g,\n"
35555 "                      int activate,\n"
35556 "                      char *const *volgroups);\n"
35557 "\n"
35558 msgstr ""
35559
35560 #. type: =head2
35561 #: ../src/guestfs-actions.pod:8164
35562 msgid "guestfs_vg_activate_all"
35563 msgstr ""
35564
35565 #. type: verbatim
35566 #: ../src/guestfs-actions.pod:8166
35567 #, no-wrap
35568 msgid ""
35569 " int\n"
35570 " guestfs_vg_activate_all (guestfs_h *g,\n"
35571 "                          int activate);\n"
35572 "\n"
35573 msgstr ""
35574
35575 #. type: =head2
35576 #: ../src/guestfs-actions.pod:8179
35577 msgid "guestfs_vgcreate"
35578 msgstr ""
35579
35580 #. type: verbatim
35581 #: ../src/guestfs-actions.pod:8181
35582 #, no-wrap
35583 msgid ""
35584 " int\n"
35585 " guestfs_vgcreate (guestfs_h *g,\n"
35586 "                   const char *volgroup,\n"
35587 "                   char *const *physvols);\n"
35588 "\n"
35589 msgstr ""
35590
35591 #. type: =head2
35592 #: ../src/guestfs-actions.pod:8193
35593 msgid "guestfs_vglvuuids"
35594 msgstr ""
35595
35596 #. type: verbatim
35597 #: ../src/guestfs-actions.pod:8195
35598 #, no-wrap
35599 msgid ""
35600 " char **\n"
35601 " guestfs_vglvuuids (guestfs_h *g,\n"
35602 "                    const char *vgname);\n"
35603 "\n"
35604 msgstr ""
35605
35606 #. type: textblock
35607 #: ../src/guestfs-actions.pod:8202
35608 msgid ""
35609 "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to "
35610 "associate logical volumes and volume groups."
35611 msgstr ""
35612
35613 #. type: textblock
35614 #: ../src/guestfs-actions.pod:8205
35615 msgid "See also C<guestfs_vgpvuuids>."
35616 msgstr ""
35617
35618 #. type: =head2
35619 #: ../src/guestfs-actions.pod:8213
35620 msgid "guestfs_vgpvuuids"
35621 msgstr ""
35622
35623 #. type: verbatim
35624 #: ../src/guestfs-actions.pod:8215
35625 #, no-wrap
35626 msgid ""
35627 " char **\n"
35628 " guestfs_vgpvuuids (guestfs_h *g,\n"
35629 "                    const char *vgname);\n"
35630 "\n"
35631 msgstr ""
35632
35633 #. type: textblock
35634 #: ../src/guestfs-actions.pod:8222
35635 msgid ""
35636 "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to "
35637 "associate physical volumes and volume groups."
35638 msgstr ""
35639
35640 #. type: textblock
35641 #: ../src/guestfs-actions.pod:8225
35642 msgid "See also C<guestfs_vglvuuids>."
35643 msgstr ""
35644
35645 #. type: =head2
35646 #: ../src/guestfs-actions.pod:8233
35647 msgid "guestfs_vgremove"
35648 msgstr ""
35649
35650 #. type: verbatim
35651 #: ../src/guestfs-actions.pod:8235
35652 #, no-wrap
35653 msgid ""
35654 " int\n"
35655 " guestfs_vgremove (guestfs_h *g,\n"
35656 "                   const char *vgname);\n"
35657 "\n"
35658 msgstr ""
35659
35660 #. type: =head2
35661 #: ../src/guestfs-actions.pod:8248
35662 msgid "guestfs_vgrename"
35663 msgstr ""
35664
35665 #. type: verbatim
35666 #: ../src/guestfs-actions.pod:8250
35667 #, no-wrap
35668 msgid ""
35669 " int\n"
35670 " guestfs_vgrename (guestfs_h *g,\n"
35671 "                   const char *volgroup,\n"
35672 "                   const char *newvolgroup);\n"
35673 "\n"
35674 msgstr ""
35675
35676 #. type: =head2
35677 #: ../src/guestfs-actions.pod:8261
35678 msgid "guestfs_vgs"
35679 msgstr ""
35680
35681 #. type: verbatim
35682 #: ../src/guestfs-actions.pod:8263
35683 #, no-wrap
35684 msgid ""
35685 " char **\n"
35686 " guestfs_vgs (guestfs_h *g);\n"
35687 "\n"
35688 msgstr ""
35689
35690 #. type: textblock
35691 #: ../src/guestfs-actions.pod:8272
35692 msgid "See also C<guestfs_vgs_full>."
35693 msgstr ""
35694
35695 #. type: =head2
35696 #: ../src/guestfs-actions.pod:8280
35697 msgid "guestfs_vgs_full"
35698 msgstr ""
35699
35700 #. type: verbatim
35701 #: ../src/guestfs-actions.pod:8282
35702 #, no-wrap
35703 msgid ""
35704 " struct guestfs_lvm_vg_list *\n"
35705 " guestfs_vgs_full (guestfs_h *g);\n"
35706 "\n"
35707 msgstr ""
35708
35709 #. type: textblock
35710 #: ../src/guestfs-actions.pod:8288
35711 msgid ""
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>."
35714 msgstr ""
35715
35716 #. type: =head2
35717 #: ../src/guestfs-actions.pod:8294
35718 msgid "guestfs_vgscan"
35719 msgstr ""
35720
35721 #. type: verbatim
35722 #: ../src/guestfs-actions.pod:8296
35723 #, no-wrap
35724 msgid ""
35725 " int\n"
35726 " guestfs_vgscan (guestfs_h *g);\n"
35727 "\n"
35728 msgstr ""
35729
35730 #. type: =head2
35731 #: ../src/guestfs-actions.pod:8306
35732 msgid "guestfs_vguuid"
35733 msgstr ""
35734
35735 #. type: verbatim
35736 #: ../src/guestfs-actions.pod:8308
35737 #, no-wrap
35738 msgid ""
35739 " char *\n"
35740 " guestfs_vguuid (guestfs_h *g,\n"
35741 "                 const char *vgname);\n"
35742 "\n"
35743 msgstr ""
35744
35745 #. type: =head2
35746 #: ../src/guestfs-actions.pod:8319
35747 msgid "guestfs_wait_ready"
35748 msgstr ""
35749
35750 #. type: verbatim
35751 #: ../src/guestfs-actions.pod:8321
35752 #, no-wrap
35753 msgid ""
35754 " int\n"
35755 " guestfs_wait_ready (guestfs_h *g);\n"
35756 "\n"
35757 msgstr ""
35758
35759 #. type: textblock
35760 #: ../src/guestfs-actions.pod:8324
35761 msgid ""
35762 "I<This function is deprecated.> In new code, use the L</guestfs_launch> call "
35763 "instead."
35764 msgstr ""
35765
35766 #. type: textblock
35767 #: ../src/guestfs-actions.pod:8331
35768 msgid "This function is a no op."
35769 msgstr ""
35770
35771 #. type: textblock
35772 #: ../src/guestfs-actions.pod:8333
35773 msgid ""
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."
35777 msgstr ""
35778
35779 #. type: textblock
35780 #: ../src/guestfs-actions.pod:8338
35781 msgid ""
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."
35784 msgstr ""
35785
35786 #. type: =head2
35787 #: ../src/guestfs-actions.pod:8346
35788 msgid "guestfs_wc_c"
35789 msgstr ""
35790
35791 #. type: verbatim
35792 #: ../src/guestfs-actions.pod:8348
35793 #, no-wrap
35794 msgid ""
35795 " int\n"
35796 " guestfs_wc_c (guestfs_h *g,\n"
35797 "               const char *path);\n"
35798 "\n"
35799 msgstr ""
35800
35801 #. type: =head2
35802 #: ../src/guestfs-actions.pod:8359
35803 msgid "guestfs_wc_l"
35804 msgstr ""
35805
35806 #. type: verbatim
35807 #: ../src/guestfs-actions.pod:8361
35808 #, no-wrap
35809 msgid ""
35810 " int\n"
35811 " guestfs_wc_l (guestfs_h *g,\n"
35812 "               const char *path);\n"
35813 "\n"
35814 msgstr ""
35815
35816 #. type: =head2
35817 #: ../src/guestfs-actions.pod:8372
35818 msgid "guestfs_wc_w"
35819 msgstr ""
35820
35821 #. type: verbatim
35822 #: ../src/guestfs-actions.pod:8374
35823 #, no-wrap
35824 msgid ""
35825 " int\n"
35826 " guestfs_wc_w (guestfs_h *g,\n"
35827 "               const char *path);\n"
35828 "\n"
35829 msgstr ""
35830
35831 #. type: =head2
35832 #: ../src/guestfs-actions.pod:8385
35833 msgid "guestfs_write"
35834 msgstr ""
35835
35836 #. type: verbatim
35837 #: ../src/guestfs-actions.pod:8387
35838 #, no-wrap
35839 msgid ""
35840 " int\n"
35841 " guestfs_write (guestfs_h *g,\n"
35842 "                const char *path,\n"
35843 "                const char *content,\n"
35844 "                size_t content_size);\n"
35845 "\n"
35846 msgstr ""
35847
35848 #. type: textblock
35849 #: ../src/guestfs-actions.pod:8396
35850 msgid "See also C<guestfs_write_append>."
35851 msgstr ""
35852
35853 #. type: =head2
35854 #: ../src/guestfs-actions.pod:8405
35855 msgid "guestfs_write_append"
35856 msgstr ""
35857
35858 #. type: verbatim
35859 #: ../src/guestfs-actions.pod:8407
35860 #, no-wrap
35861 msgid ""
35862 " int\n"
35863 " guestfs_write_append (guestfs_h *g,\n"
35864 "                       const char *path,\n"
35865 "                       const char *content,\n"
35866 "                       size_t content_size);\n"
35867 "\n"
35868 msgstr ""
35869
35870 #. type: textblock
35871 #: ../src/guestfs-actions.pod:8416
35872 msgid "See also C<guestfs_write>."
35873 msgstr ""
35874
35875 #. type: =head2
35876 #: ../src/guestfs-actions.pod:8425
35877 msgid "guestfs_write_file"
35878 msgstr "guestfs_write_file"
35879
35880 #. type: verbatim
35881 #: ../src/guestfs-actions.pod:8427
35882 #, no-wrap
35883 msgid ""
35884 " int\n"
35885 " guestfs_write_file (guestfs_h *g,\n"
35886 "                     const char *path,\n"
35887 "                     const char *content,\n"
35888 "                     int size);\n"
35889 "\n"
35890 msgstr ""
35891 " int\n"
35892 " guestfs_write_file (guestfs_h *g,\n"
35893 "                     const char *path,\n"
35894 "                     const char *content,\n"
35895 "                     int size);\n"
35896 "\n"
35897
35898 #. type: textblock
35899 #: ../src/guestfs-actions.pod:8433
35900 msgid ""
35901 "I<This function is deprecated.> In new code, use the L</guestfs_write> call "
35902 "instead."
35903 msgstr ""
35904
35905 #. type: =head2
35906 #: ../src/guestfs-actions.pod:8458
35907 msgid "guestfs_zegrep"
35908 msgstr "guestfs_zegrep"
35909
35910 #. type: verbatim
35911 #: ../src/guestfs-actions.pod:8460
35912 #, no-wrap
35913 msgid ""
35914 " char **\n"
35915 " guestfs_zegrep (guestfs_h *g,\n"
35916 "                 const char *regex,\n"
35917 "                 const char *path);\n"
35918 "\n"
35919 msgstr ""
35920 " char **\n"
35921 " guestfs_zegrep (guestfs_h *g,\n"
35922 "                 const char *regex,\n"
35923 "                 const char *path);\n"
35924 "\n"
35925
35926 #. type: =head2
35927 #: ../src/guestfs-actions.pod:8477
35928 msgid "guestfs_zegrepi"
35929 msgstr "guestfs_zegrepi"
35930
35931 #. type: verbatim
35932 #: ../src/guestfs-actions.pod:8479
35933 #, no-wrap
35934 msgid ""
35935 " char **\n"
35936 " guestfs_zegrepi (guestfs_h *g,\n"
35937 "                  const char *regex,\n"
35938 "                  const char *path);\n"
35939 "\n"
35940 msgstr ""
35941 " char **\n"
35942 " guestfs_zegrepi (guestfs_h *g,\n"
35943 "                  const char *regex,\n"
35944 "                  const char *path);\n"
35945 "\n"
35946
35947 #. type: =head2
35948 #: ../src/guestfs-actions.pod:8496
35949 msgid "guestfs_zero"
35950 msgstr "guestfs_zero"
35951
35952 #. type: verbatim
35953 #: ../src/guestfs-actions.pod:8498
35954 #, no-wrap
35955 msgid ""
35956 " int\n"
35957 " guestfs_zero (guestfs_h *g,\n"
35958 "               const char *device);\n"
35959 "\n"
35960 msgstr ""
35961 " int\n"
35962 " guestfs_zero (guestfs_h *g,\n"
35963 "               const char *device);\n"
35964 "\n"
35965
35966 #. type: textblock
35967 #: ../src/guestfs-actions.pod:8512
35968 msgid ""
35969 "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>, "
35970 "C<guestfs_is_zero_device>"
35971 msgstr ""
35972
35973 #. type: =head2
35974 #: ../src/guestfs-actions.pod:8524
35975 msgid "guestfs_zero_device"
35976 msgstr "guestfs_zero_device"
35977
35978 #. type: verbatim
35979 #: ../src/guestfs-actions.pod:8526
35980 #, no-wrap
35981 msgid ""
35982 " int\n"
35983 " guestfs_zero_device (guestfs_h *g,\n"
35984 "                      const char *device);\n"
35985 "\n"
35986 msgstr ""
35987 " int\n"
35988 " guestfs_zero_device (guestfs_h *g,\n"
35989 "                      const char *device);\n"
35990 "\n"
35991
35992 #. type: textblock
35993 #: ../src/guestfs-actions.pod:8530
35994 msgid ""
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."
35997 msgstr ""
35998
35999 #. type: textblock
36000 #: ../src/guestfs-actions.pod:8545
36001 msgid "(Added in 1.3.1)"
36002 msgstr "(Додано у 1.3.1)"
36003
36004 #. type: =head2
36005 #: ../src/guestfs-actions.pod:8547
36006 msgid "guestfs_zerofree"
36007 msgstr "guestfs_zerofree"
36008
36009 #. type: verbatim
36010 #: ../src/guestfs-actions.pod:8549
36011 #, no-wrap
36012 msgid ""
36013 " int\n"
36014 " guestfs_zerofree (guestfs_h *g,\n"
36015 "                   const char *device);\n"
36016 "\n"
36017 msgstr ""
36018 " int\n"
36019 " guestfs_zerofree (guestfs_h *g,\n"
36020 "                   const char *device);\n"
36021 "\n"
36022
36023 #. type: =head2
36024 #: ../src/guestfs-actions.pod:8568
36025 msgid "guestfs_zfgrep"
36026 msgstr "guestfs_zfgrep"
36027
36028 #. type: verbatim
36029 #: ../src/guestfs-actions.pod:8570
36030 #, no-wrap
36031 msgid ""
36032 " char **\n"
36033 " guestfs_zfgrep (guestfs_h *g,\n"
36034 "                 const char *pattern,\n"
36035 "                 const char *path);\n"
36036 "\n"
36037 msgstr ""
36038 " char **\n"
36039 " guestfs_zfgrep (guestfs_h *g,\n"
36040 "                 const char *pattern,\n"
36041 "                 const char *path);\n"
36042 "\n"
36043
36044 #. type: =head2
36045 #: ../src/guestfs-actions.pod:8587
36046 msgid "guestfs_zfgrepi"
36047 msgstr "guestfs_zfgrepi"
36048
36049 #. type: verbatim
36050 #: ../src/guestfs-actions.pod:8589
36051 #, no-wrap
36052 msgid ""
36053 " char **\n"
36054 " guestfs_zfgrepi (guestfs_h *g,\n"
36055 "                  const char *pattern,\n"
36056 "                  const char *path);\n"
36057 "\n"
36058 msgstr ""
36059 " char **\n"
36060 " guestfs_zfgrepi (guestfs_h *g,\n"
36061 "                  const char *pattern,\n"
36062 "                  const char *path);\n"
36063 "\n"
36064
36065 #. type: =head2
36066 #: ../src/guestfs-actions.pod:8606
36067 msgid "guestfs_zfile"
36068 msgstr "guestfs_zfile"
36069
36070 #. type: verbatim
36071 #: ../src/guestfs-actions.pod:8608
36072 #, no-wrap
36073 msgid ""
36074 " char *\n"
36075 " guestfs_zfile (guestfs_h *g,\n"
36076 "                const char *meth,\n"
36077 "                const char *path);\n"
36078 "\n"
36079 msgstr ""
36080 " char *\n"
36081 " guestfs_zfile (guestfs_h *g,\n"
36082 "                const char *meth,\n"
36083 "                const char *path);\n"
36084 "\n"
36085
36086 #. type: textblock
36087 #: ../src/guestfs-actions.pod:8613
36088 msgid ""
36089 "I<This function is deprecated.> In new code, use the L</guestfs_file> call "
36090 "instead."
36091 msgstr ""
36092
36093 #. type: textblock
36094 #: ../src/guestfs-actions.pod:8625
36095 msgid ""
36096 "Since 1.0.63, use C<guestfs_file> instead which can now process compressed "
36097 "files."
36098 msgstr ""
36099
36100 #. type: =head2
36101 #: ../src/guestfs-actions.pod:8633
36102 msgid "guestfs_zgrep"
36103 msgstr "guestfs_zgrep"
36104
36105 #. type: verbatim
36106 #: ../src/guestfs-actions.pod:8635
36107 #, no-wrap
36108 msgid ""
36109 " char **\n"
36110 " guestfs_zgrep (guestfs_h *g,\n"
36111 "                const char *regex,\n"
36112 "                const char *path);\n"
36113 "\n"
36114 msgstr ""
36115 " char **\n"
36116 " guestfs_zgrep (guestfs_h *g,\n"
36117 "                const char *regex,\n"
36118 "                const char *path);\n"
36119 "\n"
36120
36121 #. type: =head2
36122 #: ../src/guestfs-actions.pod:8652
36123 msgid "guestfs_zgrepi"
36124 msgstr "guestfs_zgrepi"
36125
36126 #. type: verbatim
36127 #: ../src/guestfs-actions.pod:8654
36128 #, no-wrap
36129 msgid ""
36130 " char **\n"
36131 " guestfs_zgrepi (guestfs_h *g,\n"
36132 "                 const char *regex,\n"
36133 "                 const char *path);\n"
36134 "\n"
36135 msgstr ""
36136 " char **\n"
36137 " guestfs_zgrepi (guestfs_h *g,\n"
36138 "                 const char *regex,\n"
36139 "                 const char *path);\n"
36140 "\n"
36141
36142 #. type: =item
36143 #: ../src/guestfs-availability.pod:3
36144 msgid "B<augeas>"
36145 msgstr "B<augeas>"
36146
36147 #. type: textblock
36148 #: ../src/guestfs-availability.pod:5
36149 msgid ""
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>"
36155 msgstr ""
36156
36157 #. type: =item
36158 #: ../src/guestfs-availability.pod:21
36159 msgid "B<btrfs>"
36160 msgstr "B<btrfs>"
36161
36162 #. type: textblock
36163 #: ../src/guestfs-availability.pod:23
36164 msgid "The following functions: L</guestfs_btrfs_filesystem_resize>"
36165 msgstr ""
36166
36167 #. type: =item
36168 #: ../src/guestfs-availability.pod:26
36169 msgid "B<grub>"
36170 msgstr ""
36171
36172 #. type: textblock
36173 #: ../src/guestfs-availability.pod:28
36174 msgid "The following functions: L</guestfs_grub_install>"
36175 msgstr ""
36176
36177 #. type: =item
36178 #: ../src/guestfs-availability.pod:31
36179 msgid "B<inotify>"
36180 msgstr "B<inotify>"
36181
36182 #. type: textblock
36183 #: ../src/guestfs-availability.pod:33
36184 msgid ""
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>"
36188 msgstr ""
36189
36190 #. type: =item
36191 #: ../src/guestfs-availability.pod:41
36192 msgid "B<linuxfsuuid>"
36193 msgstr "B<linuxfsuuid>"
36194
36195 #. type: textblock
36196 #: ../src/guestfs-availability.pod:43
36197 msgid ""
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>"
36200 msgstr ""
36201
36202 #. type: =item
36203 #: ../src/guestfs-availability.pod:50
36204 msgid "B<linuxmodules>"
36205 msgstr "B<linuxmodules>"
36206
36207 #. type: textblock
36208 #: ../src/guestfs-availability.pod:52
36209 msgid "The following functions: L</guestfs_modprobe>"
36210 msgstr ""
36211
36212 #. type: =item
36213 #: ../src/guestfs-availability.pod:55
36214 msgid "B<linuxxattrs>"
36215 msgstr "B<linuxxattrs>"
36216
36217 #. type: textblock
36218 #: ../src/guestfs-availability.pod:57
36219 msgid ""
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>"
36224 msgstr ""
36225
36226 #. type: =item
36227 #: ../src/guestfs-availability.pod:68
36228 msgid "B<luks>"
36229 msgstr "B<luks>"
36230
36231 #. type: textblock
36232 #: ../src/guestfs-availability.pod:70
36233 msgid ""
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>"
36237 msgstr ""
36238
36239 #. type: =item
36240 #: ../src/guestfs-availability.pod:79
36241 msgid "B<lvm2>"
36242 msgstr "B<lvm2>"
36243
36244 #. type: textblock
36245 #: ../src/guestfs-availability.pod:81
36246 msgid ""
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>"
36254 msgstr ""
36255
36256 #. type: =item
36257 #: ../src/guestfs-availability.pod:104
36258 msgid "B<mdadm>"
36259 msgstr ""
36260
36261 #. type: textblock
36262 #: ../src/guestfs-availability.pod:106
36263 msgid ""
36264 "The following functions: L</guestfs_mdadm_create> L</guestfs_mdadm_detail>"
36265 msgstr ""
36266
36267 #. type: =item
36268 #: ../src/guestfs-availability.pod:110
36269 msgid "B<mknod>"
36270 msgstr "B<mknod>"
36271
36272 #. type: textblock
36273 #: ../src/guestfs-availability.pod:112
36274 msgid ""
36275 "The following functions: L</guestfs_mkfifo> L</guestfs_mknod> L</"
36276 "guestfs_mknod_b> L</guestfs_mknod_c>"
36277 msgstr ""
36278
36279 #. type: =item
36280 #: ../src/guestfs-availability.pod:118
36281 msgid "B<ntfs3g>"
36282 msgstr "B<ntfs3g>"
36283
36284 #. type: textblock
36285 #: ../src/guestfs-availability.pod:120
36286 msgid "The following functions: L</guestfs_ntfs_3g_probe>"
36287 msgstr ""
36288
36289 #. type: =item
36290 #: ../src/guestfs-availability.pod:123
36291 msgid "B<ntfsprogs>"
36292 msgstr "B<ntfsprogs>"
36293
36294 #. type: textblock
36295 #: ../src/guestfs-availability.pod:125
36296 msgid ""
36297 "The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_opts> "
36298 "L</guestfs_ntfsresize_size>"
36299 msgstr ""
36300
36301 #. type: =item
36302 #: ../src/guestfs-availability.pod:130
36303 msgid "B<realpath>"
36304 msgstr "B<realpath>"
36305
36306 #. type: textblock
36307 #: ../src/guestfs-availability.pod:132
36308 msgid "The following functions: L</guestfs_realpath>"
36309 msgstr ""
36310
36311 #. type: =item
36312 #: ../src/guestfs-availability.pod:135
36313 msgid "B<scrub>"
36314 msgstr "B<scrub>"
36315
36316 #. type: textblock
36317 #: ../src/guestfs-availability.pod:137
36318 msgid ""
36319 "The following functions: L</guestfs_scrub_device> L</guestfs_scrub_file> L</"
36320 "guestfs_scrub_freespace>"
36321 msgstr ""
36322
36323 #. type: =item
36324 #: ../src/guestfs-availability.pod:142
36325 msgid "B<selinux>"
36326 msgstr "B<selinux>"
36327
36328 #. type: textblock
36329 #: ../src/guestfs-availability.pod:144
36330 msgid "The following functions: L</guestfs_getcon> L</guestfs_setcon>"
36331 msgstr ""
36332
36333 #. type: =item
36334 #: ../src/guestfs-availability.pod:148
36335 msgid "B<xz>"
36336 msgstr "B<xz>"
36337
36338 #. type: textblock
36339 #: ../src/guestfs-availability.pod:150
36340 msgid "The following functions: L</guestfs_txz_in> L</guestfs_txz_out>"
36341 msgstr ""
36342
36343 #. type: =item
36344 #: ../src/guestfs-availability.pod:154
36345 msgid "B<zerofree>"
36346 msgstr "B<zerofree>"
36347
36348 #. type: textblock
36349 #: ../src/guestfs-availability.pod:156
36350 msgid "The following functions: L</guestfs_zerofree>"
36351 msgstr ""
36352
36353 #. type: =head2
36354 #: ../src/guestfs-structs.pod:1
36355 msgid "guestfs_int_bool"
36356 msgstr ""
36357
36358 #. type: verbatim
36359 #: ../src/guestfs-structs.pod:3
36360 #, no-wrap
36361 msgid ""
36362 " struct guestfs_int_bool {\n"
36363 "   int32_t i;\n"
36364 "   int32_t b;\n"
36365 " };\n"
36366 " \n"
36367 msgstr ""
36368
36369 #. type: verbatim
36370 #: ../src/guestfs-structs.pod:8
36371 #, no-wrap
36372 msgid ""
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"
36376 " };\n"
36377 " \n"
36378 msgstr ""
36379
36380 #. type: verbatim
36381 #: ../src/guestfs-structs.pod:13
36382 #, no-wrap
36383 msgid ""
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"
36386 "\n"
36387 msgstr ""
36388
36389 #. type: =head2
36390 #: ../src/guestfs-structs.pod:16
36391 msgid "guestfs_lvm_pv"
36392 msgstr ""
36393
36394 #. type: verbatim
36395 #: ../src/guestfs-structs.pod:18
36396 #, no-wrap
36397 msgid ""
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"
36402 "   char *pv_fmt;\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"
36414 " };\n"
36415 " \n"
36416 msgstr ""
36417
36418 #. type: verbatim
36419 #: ../src/guestfs-structs.pod:36
36420 #, no-wrap
36421 msgid ""
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"
36425 " };\n"
36426 " \n"
36427 msgstr ""
36428
36429 #. type: verbatim
36430 #: ../src/guestfs-structs.pod:41
36431 #, no-wrap
36432 msgid ""
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"
36435 "\n"
36436 msgstr ""
36437
36438 #. type: =head2
36439 #: ../src/guestfs-structs.pod:44
36440 msgid "guestfs_lvm_vg"
36441 msgstr ""
36442
36443 #. type: verbatim
36444 #: ../src/guestfs-structs.pod:46
36445 #, no-wrap
36446 msgid ""
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"
36451 "   char *vg_fmt;\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"
36468 " };\n"
36469 " \n"
36470 msgstr ""
36471
36472 #. type: verbatim
36473 #: ../src/guestfs-structs.pod:69
36474 #, no-wrap
36475 msgid ""
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"
36479 " };\n"
36480 " \n"
36481 msgstr ""
36482
36483 #. type: verbatim
36484 #: ../src/guestfs-structs.pod:74
36485 #, no-wrap
36486 msgid ""
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"
36489 "\n"
36490 msgstr ""
36491
36492 #. type: =head2
36493 #: ../src/guestfs-structs.pod:77
36494 msgid "guestfs_lvm_lv"
36495 msgstr ""
36496
36497 #. type: verbatim
36498 #: ../src/guestfs-structs.pod:79
36499 #, no-wrap
36500 msgid ""
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"
36512 "   char *origin;\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"
36521 " };\n"
36522 " \n"
36523 msgstr ""
36524
36525 #. type: verbatim
36526 #: ../src/guestfs-structs.pod:101
36527 #, no-wrap
36528 msgid ""
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"
36532 " };\n"
36533 " \n"
36534 msgstr ""
36535
36536 #. type: verbatim
36537 #: ../src/guestfs-structs.pod:106
36538 #, no-wrap
36539 msgid ""
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"
36542 "\n"
36543 msgstr ""
36544
36545 #. type: verbatim
36546 #: ../src/guestfs-structs.pod:111
36547 #, no-wrap
36548 msgid ""
36549 " struct guestfs_stat {\n"
36550 "   int64_t dev;\n"
36551 "   int64_t ino;\n"
36552 "   int64_t mode;\n"
36553 "   int64_t nlink;\n"
36554 "   int64_t uid;\n"
36555 "   int64_t gid;\n"
36556 "   int64_t rdev;\n"
36557 "   int64_t size;\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"
36563 " };\n"
36564 " \n"
36565 msgstr ""
36566
36567 #. type: verbatim
36568 #: ../src/guestfs-structs.pod:127
36569 #, no-wrap
36570 msgid ""
36571 " struct guestfs_stat_list {\n"
36572 "   uint32_t len; /* Number of elements in list. */\n"
36573 "   struct guestfs_stat *val; /* Elements. */\n"
36574 " };\n"
36575 " \n"
36576 msgstr ""
36577
36578 #. type: verbatim
36579 #: ../src/guestfs-structs.pod:132
36580 #, no-wrap
36581 msgid ""
36582 " void guestfs_free_stat (struct guestfs_free_stat *);\n"
36583 " void guestfs_free_stat_list (struct guestfs_free_stat_list *);\n"
36584 "\n"
36585 msgstr ""
36586
36587 #. type: verbatim
36588 #: ../src/guestfs-structs.pod:137
36589 #, no-wrap
36590 msgid ""
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"
36600 "   int64_t fsid;\n"
36601 "   int64_t flag;\n"
36602 "   int64_t namemax;\n"
36603 " };\n"
36604 " \n"
36605 msgstr ""
36606
36607 #. type: verbatim
36608 #: ../src/guestfs-structs.pod:151
36609 #, no-wrap
36610 msgid ""
36611 " struct guestfs_statvfs_list {\n"
36612 "   uint32_t len; /* Number of elements in list. */\n"
36613 "   struct guestfs_statvfs *val; /* Elements. */\n"
36614 " };\n"
36615 " \n"
36616 msgstr ""
36617
36618 #. type: verbatim
36619 #: ../src/guestfs-structs.pod:156
36620 #, no-wrap
36621 msgid ""
36622 " void guestfs_free_statvfs (struct guestfs_free_statvfs *);\n"
36623 " void guestfs_free_statvfs_list (struct guestfs_free_statvfs_list *);\n"
36624 "\n"
36625 msgstr ""
36626
36627 #. type: =head2
36628 #: ../src/guestfs-structs.pod:159
36629 msgid "guestfs_dirent"
36630 msgstr ""
36631
36632 #. type: verbatim
36633 #: ../src/guestfs-structs.pod:161
36634 #, no-wrap
36635 msgid ""
36636 " struct guestfs_dirent {\n"
36637 "   int64_t ino;\n"
36638 "   char ftyp;\n"
36639 "   char *name;\n"
36640 " };\n"
36641 " \n"
36642 msgstr ""
36643
36644 #. type: verbatim
36645 #: ../src/guestfs-structs.pod:167
36646 #, no-wrap
36647 msgid ""
36648 " struct guestfs_dirent_list {\n"
36649 "   uint32_t len; /* Number of elements in list. */\n"
36650 "   struct guestfs_dirent *val; /* Elements. */\n"
36651 " };\n"
36652 " \n"
36653 msgstr ""
36654
36655 #. type: verbatim
36656 #: ../src/guestfs-structs.pod:172
36657 #, no-wrap
36658 msgid ""
36659 " void guestfs_free_dirent (struct guestfs_free_dirent *);\n"
36660 " void guestfs_free_dirent_list (struct guestfs_free_dirent_list *);\n"
36661 "\n"
36662 msgstr ""
36663
36664 #. type: verbatim
36665 #: ../src/guestfs-structs.pod:177
36666 #, no-wrap
36667 msgid ""
36668 " struct guestfs_version {\n"
36669 "   int64_t major;\n"
36670 "   int64_t minor;\n"
36671 "   int64_t release;\n"
36672 "   char *extra;\n"
36673 " };\n"
36674 " \n"
36675 msgstr ""
36676
36677 #. type: verbatim
36678 #: ../src/guestfs-structs.pod:184
36679 #, no-wrap
36680 msgid ""
36681 " struct guestfs_version_list {\n"
36682 "   uint32_t len; /* Number of elements in list. */\n"
36683 "   struct guestfs_version *val; /* Elements. */\n"
36684 " };\n"
36685 " \n"
36686 msgstr ""
36687
36688 #. type: verbatim
36689 #: ../src/guestfs-structs.pod:189
36690 #, no-wrap
36691 msgid ""
36692 " void guestfs_free_version (struct guestfs_free_version *);\n"
36693 " void guestfs_free_version_list (struct guestfs_free_version_list *);\n"
36694 "\n"
36695 msgstr ""
36696
36697 #. type: =head2
36698 #: ../src/guestfs-structs.pod:192
36699 msgid "guestfs_xattr"
36700 msgstr ""
36701
36702 #. type: verbatim
36703 #: ../src/guestfs-structs.pod:194
36704 #, no-wrap
36705 msgid ""
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"
36711 " };\n"
36712 " \n"
36713 msgstr ""
36714
36715 #. type: verbatim
36716 #: ../src/guestfs-structs.pod:201
36717 #, no-wrap
36718 msgid ""
36719 " struct guestfs_xattr_list {\n"
36720 "   uint32_t len; /* Number of elements in list. */\n"
36721 "   struct guestfs_xattr *val; /* Elements. */\n"
36722 " };\n"
36723 " \n"
36724 msgstr ""
36725
36726 #. type: verbatim
36727 #: ../src/guestfs-structs.pod:206
36728 #, no-wrap
36729 msgid ""
36730 " void guestfs_free_xattr (struct guestfs_free_xattr *);\n"
36731 " void guestfs_free_xattr_list (struct guestfs_free_xattr_list *);\n"
36732 "\n"
36733 msgstr ""
36734
36735 #. type: =head2
36736 #: ../src/guestfs-structs.pod:209
36737 msgid "guestfs_inotify_event"
36738 msgstr ""
36739
36740 #. type: verbatim
36741 #: ../src/guestfs-structs.pod:211
36742 #, no-wrap
36743 msgid ""
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"
36749 " };\n"
36750 " \n"
36751 msgstr ""
36752
36753 #. type: verbatim
36754 #: ../src/guestfs-structs.pod:218
36755 #, no-wrap
36756 msgid ""
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"
36760 " };\n"
36761 " \n"
36762 msgstr ""
36763
36764 #. type: verbatim
36765 #: ../src/guestfs-structs.pod:223
36766 #, no-wrap
36767 msgid ""
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"
36770 "\n"
36771 msgstr ""
36772
36773 #. type: =head2
36774 #: ../src/guestfs-structs.pod:226
36775 msgid "guestfs_partition"
36776 msgstr ""
36777
36778 #. type: verbatim
36779 #: ../src/guestfs-structs.pod:228
36780 #, no-wrap
36781 msgid ""
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"
36787 " };\n"
36788 " \n"
36789 msgstr ""
36790
36791 #. type: verbatim
36792 #: ../src/guestfs-structs.pod:235
36793 #, no-wrap
36794 msgid ""
36795 " struct guestfs_partition_list {\n"
36796 "   uint32_t len; /* Number of elements in list. */\n"
36797 "   struct guestfs_partition *val; /* Elements. */\n"
36798 " };\n"
36799 " \n"
36800 msgstr ""
36801
36802 #. type: verbatim
36803 #: ../src/guestfs-structs.pod:240
36804 #, no-wrap
36805 msgid ""
36806 " void guestfs_free_partition (struct guestfs_free_partition *);\n"
36807 " void guestfs_free_partition_list (struct guestfs_free_partition_list *);\n"
36808 "\n"
36809 msgstr ""
36810
36811 #. type: =head2
36812 #: ../src/guestfs-structs.pod:243
36813 msgid "guestfs_application"
36814 msgstr ""
36815
36816 #. type: verbatim
36817 #: ../src/guestfs-structs.pod:245
36818 #, no-wrap
36819 msgid ""
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"
36833 " };\n"
36834 " \n"
36835 msgstr ""
36836
36837 #. type: verbatim
36838 #: ../src/guestfs-structs.pod:260
36839 #, no-wrap
36840 msgid ""
36841 " struct guestfs_application_list {\n"
36842 "   uint32_t len; /* Number of elements in list. */\n"
36843 "   struct guestfs_application *val; /* Elements. */\n"
36844 " };\n"
36845 " \n"
36846 msgstr ""
36847
36848 #. type: verbatim
36849 #: ../src/guestfs-structs.pod:265
36850 #, no-wrap
36851 msgid ""
36852 " void guestfs_free_application (struct guestfs_free_application *);\n"
36853 " void guestfs_free_application_list (struct guestfs_free_application_list *);\n"
36854 "\n"
36855 msgstr ""
36856
36857 #. type: textblock
36858 #: ../src/guestfs.pod:5
36859 msgid "guestfs - Library for accessing and modifying virtual machine images"
36860 msgstr ""
36861 "guestfs — бібліотека для доступу та внесення змін до образів віртуальних "
36862 "машин"
36863
36864 #. type: verbatim
36865 #: ../src/guestfs.pod:11
36866 #, no-wrap
36867 msgid ""
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"
36875 "\n"
36876 msgstr ""
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"
36884 "\n"
36885
36886 #. type: textblock
36887 #: ../src/guestfs.pod:25
36888 msgid ""
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."
36895 msgstr ""
36896
36897 #. type: textblock
36898 #: ../src/guestfs.pod:33
36899 msgid ""
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, "
36903 "qcow2, vmdk."
36904 msgstr ""
36905
36906 #. type: textblock
36907 #: ../src/guestfs.pod:38
36908 msgid ""
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."
36912 msgstr ""
36913
36914 #. type: textblock
36915 #: ../src/guestfs.pod:43
36916 msgid ""
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 "
36920 "command line."
36921 msgstr ""
36922
36923 #. type: textblock
36924 #: ../src/guestfs.pod:48
36925 msgid ""
36926 "You don't need to be root to use libguestfs, although obviously you do need "
36927 "enough permissions to access the disk images."
36928 msgstr ""
36929
36930 #. type: textblock
36931 #: ../src/guestfs.pod:51
36932 msgid ""
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."
36935 msgstr ""
36936
36937 #. type: textblock
36938 #: ../src/guestfs.pod:54
36939 msgid ""
36940 "There are also some example programs in the L<guestfs-examples(3)> manual "
36941 "page."
36942 msgstr ""
36943
36944 #. type: =head1
36945 #: ../src/guestfs.pod:57
36946 msgid "API OVERVIEW"
36947 msgstr "ОГЛЯД API"
36948
36949 #. type: textblock
36950 #: ../src/guestfs.pod:59
36951 msgid ""
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."
36955 msgstr ""
36956
36957 #. type: =head2
36958 #: ../src/guestfs.pod:64
36959 msgid "HANDLES"
36960 msgstr "ОБРОБНИКИ"
36961
36962 #. type: textblock
36963 #: ../src/guestfs.pod:66
36964 msgid ""
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."
36970 msgstr ""
36971
36972 #. type: textblock
36973 #: ../src/guestfs.pod:73
36974 msgid "The general structure of all libguestfs-using programs looks like this:"
36975 msgstr ""
36976
36977 #. type: verbatim
36978 #: ../src/guestfs.pod:76
36979 #, no-wrap
36980 msgid ""
36981 " guestfs_h *g = guestfs_create ();\n"
36982 " \n"
36983 msgstr ""
36984 " guestfs_h *g = guestfs_create ();\n"
36985 " \n"
36986
36987 #. type: verbatim
36988 #: ../src/guestfs.pod:78
36989 #, no-wrap
36990 msgid ""
36991 " /* Call guestfs_add_drive additional times if there are\n"
36992 "  * multiple disk images.\n"
36993 "  */\n"
36994 " guestfs_add_drive (g, \"guest.img\");\n"
36995 " \n"
36996 msgstr ""
36997
36998 #. type: verbatim
36999 #: ../src/guestfs.pod:83
37000 #, no-wrap
37001 msgid ""
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"
37005 "  */\n"
37006 " guestfs_launch (g);\n"
37007 " \n"
37008 msgstr ""
37009
37010 #. type: verbatim
37011 #: ../src/guestfs.pod:89
37012 #, no-wrap
37013 msgid ""
37014 " /* Now you can examine what partitions, LVs etc are available.\n"
37015 "  */\n"
37016 " char **partitions = guestfs_list_partitions (g);\n"
37017 " char **logvols = guestfs_lvs (g);\n"
37018 " \n"
37019 msgstr ""
37020 " /* Тепер можна перевірити, які розділи, логічні томи тощо доступні.\n"
37021 "  */\n"
37022 " char **partitions = guestfs_list_partitions (g);\n"
37023 " char **logvols = guestfs_lvs (g);\n"
37024 " \n"
37025
37026 #. type: verbatim
37027 #: ../src/guestfs.pod:94
37028 #, no-wrap
37029 msgid ""
37030 " /* To access a filesystem in the image, you must mount it.\n"
37031 "  */\n"
37032 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
37033 " \n"
37034 msgstr ""
37035 " /* Щоб отримати доступ до файлової системи на образі, вам слід його змонтувати.\n"
37036 "  */\n"
37037 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
37038 " \n"
37039
37040 #. type: verbatim
37041 #: ../src/guestfs.pod:98
37042 #, no-wrap
37043 msgid ""
37044 " /* Now you can perform filesystem actions on the guest\n"
37045 "  * disk image.\n"
37046 "  */\n"
37047 " guestfs_touch (g, \"/hello\");\n"
37048 " \n"
37049 msgstr ""
37050 " /* Тепер ви можете виконувати дії з файловою системою на\n"
37051 "  * образі диска операційної системи.\n"
37052 "  */\n"
37053 " guestfs_touch (g, \"/hello\");\n"
37054 " \n"
37055
37056 #. type: verbatim
37057 #: ../src/guestfs.pod:103
37058 #, no-wrap
37059 msgid ""
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"
37063 "  */\n"
37064 " guestfs_sync (g);\n"
37065 " \n"
37066 msgstr ""
37067
37068 #. type: verbatim
37069 #: ../src/guestfs.pod:109
37070 #, no-wrap
37071 msgid ""
37072 " /* Close the handle 'g'. */\n"
37073 " guestfs_close (g);\n"
37074 "\n"
37075 msgstr ""
37076 " /* Закрити дескриптор 'g'. */\n"
37077 " guestfs_close (g);\n"
37078 "\n"
37079
37080 #. type: textblock
37081 #: ../src/guestfs.pod:112
37082 msgid ""
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."
37090 msgstr ""
37091
37092 #. type: =head2
37093 #: ../src/guestfs.pod:121
37094 msgid "DISK IMAGES"
37095 msgstr "ОБРАЗИ ДИСКІВ"
37096
37097 #. type: textblock
37098 #: ../src/guestfs.pod:123
37099 msgid ""
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 "
37104 "of these."
37105 msgstr ""
37106
37107 #. type: textblock
37108 #: ../src/guestfs.pod:129
37109 msgid ""
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:"
37113 msgstr ""
37114
37115 #. type: verbatim
37116 #: ../src/guestfs.pod:133
37117 #, no-wrap
37118 msgid ""
37119 " guestfs_add_drive_opts (g, filename,\n"
37120 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
37121 "                         -1);\n"
37122 "\n"
37123 msgstr ""
37124 " guestfs_add_drive_opts (g, filename,\n"
37125 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
37126 "                         -1);\n"
37127 "\n"
37128
37129 #. type: textblock
37130 #: ../src/guestfs.pod:137
37131 msgid "You can add a disk read-only using:"
37132 msgstr "Ви можете додати диск у режимі лише читання:"
37133
37134 #. type: verbatim
37135 #: ../src/guestfs.pod:139
37136 #, no-wrap
37137 msgid ""
37138 " guestfs_add_drive_opts (g, filename,\n"
37139 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
37140 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
37141 "                         -1);\n"
37142 "\n"
37143 msgstr ""
37144 " guestfs_add_drive_opts (g, filename,\n"
37145 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
37146 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
37147 "                         -1);\n"
37148 "\n"
37149
37150 #. type: textblock
37151 #: ../src/guestfs.pod:144
37152 msgid ""
37153 "or by calling the older function L</guestfs_add_drive_ro>.  In either case "
37154 "libguestfs won't modify the file."
37155 msgstr ""
37156
37157 #. type: textblock
37158 #: ../src/guestfs.pod:147
37159 msgid ""
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."
37163 msgstr ""
37164
37165 #. type: textblock
37166 #: ../src/guestfs.pod:151
37167 msgid ""
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."
37171 msgstr ""
37172
37173 #. type: textblock
37174 #: ../src/guestfs.pod:156
37175 msgid ""
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."
37179 msgstr ""
37180
37181 #. type: =head2
37182 #: ../src/guestfs.pod:161
37183 msgid "MOUNTING"
37184 msgstr "МОНТУВАННЯ"
37185
37186 #. type: textblock
37187 #: ../src/guestfs.pod:163
37188 msgid ""
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:"
37194 msgstr ""
37195
37196 #. type: verbatim
37197 #: ../src/guestfs.pod:170
37198 #, no-wrap
37199 msgid ""
37200 " guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n"
37201 "\n"
37202 msgstr ""
37203 " guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n"
37204 "\n"
37205
37206 #. type: textblock
37207 #: ../src/guestfs.pod:172
37208 msgid ""
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 "
37213 "devices."
37214 msgstr ""
37215
37216 #. type: textblock
37217 #: ../src/guestfs.pod:178
37218 msgid ""
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>."
37225 msgstr ""
37226
37227 #. type: textblock
37228 #: ../src/guestfs.pod:186
37229 msgid ""
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)>."
37233 msgstr ""
37234
37235 #. type: textblock
37236 #: ../src/guestfs.pod:191
37237 msgid ""
37238 "To mount a filesystem read-only, use L</guestfs_mount_ro>.  There are "
37239 "several other variations of the C<guestfs_mount_*> call."
37240 msgstr ""
37241
37242 #. type: =head2
37243 #: ../src/guestfs.pod:194
37244 msgid "FILESYSTEM ACCESS AND MODIFICATION"
37245 msgstr "ДОСТУП ТА ВНЕСЕННЯ ЗМІН ДО ФАЙЛОВИХ СИСТЕМ"
37246
37247 #. type: textblock
37248 #: ../src/guestfs.pod:196
37249 msgid ""
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."
37255 msgstr ""
37256
37257 #. type: textblock
37258 #: ../src/guestfs.pod:202
37259 msgid ""
37260 "Specify filenames as full paths, starting with C<\"/\"> and including the "
37261 "mount point."
37262 msgstr ""
37263 "Вказуйте адреси і назви файлів повністю, починаючи з C<\"/\">, разом з "
37264 "точкою монтування."
37265
37266 #. type: textblock
37267 #: ../src/guestfs.pod:205
37268 msgid ""
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:"
37271 msgstr ""
37272 "Наприклад, якщо вами змонтовано файлову систему до C<\"/\">, і ви бажаєте "
37273 "виконати читання файла з назвою C<\"etc/passwd\">, ви можете скористатися "
37274 "таким кодом:"
37275
37276 #. type: verbatim
37277 #: ../src/guestfs.pod:208
37278 #, no-wrap
37279 msgid ""
37280 " char *data = guestfs_cat (g, \"/etc/passwd\");\n"
37281 "\n"
37282 msgstr ""
37283 " char *data = guestfs_cat (g, \"/etc/passwd\");\n"
37284 "\n"
37285
37286 #. type: textblock
37287 #: ../src/guestfs.pod:210
37288 msgid ""
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."
37292 msgstr ""
37293
37294 #. type: textblock
37295 #: ../src/guestfs.pod:214
37296 msgid ""
37297 "As another example, to create a top-level directory on that filesystem "
37298 "called C<\"var\"> you would do:"
37299 msgstr ""
37300
37301 #. type: verbatim
37302 #: ../src/guestfs.pod:217
37303 #, no-wrap
37304 msgid ""
37305 " guestfs_mkdir (g, \"/var\");\n"
37306 "\n"
37307 msgstr ""
37308 " guestfs_mkdir (g, \"/var\");\n"
37309 "\n"
37310
37311 #. type: textblock
37312 #: ../src/guestfs.pod:219
37313 msgid "To create a symlink you could do:"
37314 msgstr "Щоб створити символічне посилання, ви можете скористатися таким кодом:"
37315
37316 #. type: verbatim
37317 #: ../src/guestfs.pod:221
37318 #, no-wrap
37319 msgid ""
37320 " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n"
37321 "               \"/etc/rc3.d/S30portmap\");\n"
37322 "\n"
37323 msgstr ""
37324 " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n"
37325 "               \"/etc/rc3.d/S30portmap\");\n"
37326 "\n"
37327
37328 #. type: textblock
37329 #: ../src/guestfs.pod:224
37330 msgid ""
37331 "Libguestfs will reject attempts to use relative paths and there is no "
37332 "concept of a current working directory."
37333 msgstr ""
37334
37335 #. type: textblock
37336 #: ../src/guestfs.pod:227
37337 msgid ""
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)."
37343 msgstr ""
37344
37345 #. type: textblock
37346 #: ../src/guestfs.pod:233
37347 msgid ""
37348 "File writes are affected by the per-handle umask, set by calling L</"
37349 "guestfs_umask> and defaulting to 022.  See L</UMASK>."
37350 msgstr ""
37351
37352 #. type: =head2
37353 #: ../src/guestfs.pod:236
37354 msgid "PARTITIONING"
37355 msgstr "ПОДІЛ НА РОЗДІЛИ"
37356
37357 #. type: textblock
37358 #: ../src/guestfs.pod:238
37359 msgid ""
37360 "Libguestfs contains API calls to read, create and modify partition tables on "
37361 "disk images."
37362 msgstr ""
37363
37364 #. type: textblock
37365 #: ../src/guestfs.pod:241
37366 msgid ""
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:"
37369 msgstr ""
37370
37371 #. type: verbatim
37372 #: ../src/guestfs.pod:245
37373 #, no-wrap
37374 msgid ""
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"
37379 "\n"
37380 msgstr ""
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"
37385 "\n"
37386
37387 #. type: textblock
37388 #: ../src/guestfs.pod:250
37389 msgid ""
37390 "Obviously this effectively wipes anything that was on that disk image before."
37391 msgstr ""
37392
37393 #. type: =head2
37394 #: ../src/guestfs.pod:253
37395 msgid "LVM2"
37396 msgstr "LVM2"
37397
37398 #. type: textblock
37399 #: ../src/guestfs.pod:255
37400 msgid ""
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."
37405 msgstr ""
37406
37407 #. type: textblock
37408 #: ../src/guestfs.pod:260
37409 msgid ""
37410 "This author strongly recommends reading the LVM HOWTO, online at L<http://"
37411 "tldp.org/HOWTO/LVM-HOWTO/>."
37412 msgstr ""
37413
37414 #. type: =head2
37415 #: ../src/guestfs.pod:263
37416 msgid "DOWNLOADING"
37417 msgstr "ОТРИМАННЯ ДАНИХ"
37418
37419 #. type: textblock
37420 #: ../src/guestfs.pod:265
37421 msgid ""
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."
37425 msgstr ""
37426
37427 #. type: textblock
37428 #: ../src/guestfs.pod:269
37429 msgid ""
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."
37433 msgstr ""
37434
37435 #. type: textblock
37436 #: ../src/guestfs.pod:273
37437 msgid ""
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)."
37440 msgstr ""
37441
37442 #. type: textblock
37443 #: ../src/guestfs.pod:276
37444 msgid ""
37445 "To download multiple files, see L</guestfs_tar_out> and L</guestfs_tgz_out>."
37446 msgstr ""
37447
37448 #. type: =head2
37449 #: ../src/guestfs.pod:279
37450 msgid "UPLOADING"
37451 msgstr "ВИВАНТАЖЕННЯ"
37452
37453 #. type: textblock
37454 #: ../src/guestfs.pod:281
37455 msgid ""
37456 "It's often the case that you want to write a file or files to the disk image."
37457 msgstr ""
37458
37459 #. type: textblock
37460 #: ../src/guestfs.pod:284
37461 msgid ""
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>."
37467 msgstr ""
37468
37469 #. type: textblock
37470 #: ../src/guestfs.pod:290
37471 msgid ""
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)."
37474 msgstr ""
37475
37476 #. type: textblock
37477 #: ../src/guestfs.pod:293
37478 msgid ""
37479 "To upload multiple files, see L</guestfs_tar_in> and L</guestfs_tgz_in>."
37480 msgstr ""
37481
37482 #. type: textblock
37483 #: ../src/guestfs.pod:295
37484 msgid ""
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."
37494 msgstr ""
37495
37496 #. type: =head2
37497 #: ../src/guestfs.pod:306
37498 msgid "COPYING"
37499 msgstr "КОПІЮВАННЯ"
37500
37501 #. type: textblock
37502 #: ../src/guestfs.pod:308
37503 msgid ""
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 "
37506 "below."
37507 msgstr ""
37508
37509 #. type: =item
37510 #: ../src/guestfs.pod:314
37511 msgid "B<file> to B<file>"
37512 msgstr "B<файл> у B<файл>"
37513
37514 #. type: textblock
37515 #: ../src/guestfs.pod:316
37516 msgid ""
37517 "Use L</guestfs_cp> to copy a single file, or L</guestfs_cp_a> to copy "
37518 "directories recursively."
37519 msgstr ""
37520
37521 #. type: textblock
37522 #: ../src/guestfs.pod:319
37523 msgid ""
37524 "To copy part of a file (offset and size) use L</guestfs_copy_file_to_file>."
37525 msgstr ""
37526
37527 #. type: =item
37528 #: ../src/guestfs.pod:322
37529 msgid "B<file> to B<device>"
37530 msgstr ""
37531
37532 #. type: =item
37533 #: ../src/guestfs.pod:324
37534 msgid "B<device> to B<file>"
37535 msgstr ""
37536
37537 #. type: =item
37538 #: ../src/guestfs.pod:326
37539 msgid "B<device> to B<device>"
37540 msgstr ""
37541
37542 #. type: textblock
37543 #: ../src/guestfs.pod:328
37544 msgid ""
37545 "Use L</guestfs_copy_file_to_device>, L</guestfs_copy_device_to_file>, or L</"
37546 "guestfs_copy_device_to_device>."
37547 msgstr ""
37548
37549 #. type: textblock
37550 #: ../src/guestfs.pod:331
37551 msgid "Example: duplicate the contents of an LV:"
37552 msgstr ""
37553
37554 #. type: verbatim
37555 #: ../src/guestfs.pod:333
37556 #, no-wrap
37557 msgid ""
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"
37561 "         -1);\n"
37562 "\n"
37563 msgstr ""
37564
37565 #. type: textblock
37566 #: ../src/guestfs.pod:338
37567 msgid ""
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:"
37571 msgstr ""
37572
37573 #. type: verbatim
37574 #: ../src/guestfs.pod:342
37575 #, no-wrap
37576 msgid ""
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"
37580 "         -1);\n"
37581 "\n"
37582 msgstr ""
37583
37584 #. type: =item
37585 #: ../src/guestfs.pod:347
37586 msgid "B<file on the host> to B<file or device>"
37587 msgstr ""
37588
37589 #. type: textblock
37590 #: ../src/guestfs.pod:349
37591 msgid "Use L</guestfs_upload>.  See L</UPLOADING> above."
37592 msgstr ""
37593
37594 #. type: =item
37595 #: ../src/guestfs.pod:351
37596 msgid "B<file or device> to B<file on the host>"
37597 msgstr ""
37598
37599 #. type: textblock
37600 #: ../src/guestfs.pod:353
37601 msgid "Use L</guestfs_download>.  See L</DOWNLOADING> above."
37602 msgstr ""
37603
37604 #. type: =head2
37605 #: ../src/guestfs.pod:357
37606 msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS"
37607 msgstr ""
37608
37609 #. type: textblock
37610 #: ../src/guestfs.pod:359
37611 msgid ""
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."
37618 msgstr ""
37619
37620 #. type: textblock
37621 #: ../src/guestfs.pod:367
37622 msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:"
37623 msgstr ""
37624
37625 #. type: verbatim
37626 #: ../src/guestfs.pod:370
37627 #, no-wrap
37628 msgid ""
37629 " guestfs_download (g, filename, \"/dev/stdout\");\n"
37630 "\n"
37631 msgstr ""
37632 " guestfs_download (g, filename, \"/dev/stdout\");\n"
37633 "\n"
37634
37635 #. type: textblock
37636 #: ../src/guestfs.pod:372
37637 msgid "and you can write tar output to a file descriptor C<fd> by doing:"
37638 msgstr ""
37639
37640 #. type: verbatim
37641 #: ../src/guestfs.pod:374
37642 #, no-wrap
37643 msgid ""
37644 " char devfd[64];\n"
37645 " snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n"
37646 " guestfs_tar_out (g, \"/\", devfd);\n"
37647 "\n"
37648 msgstr ""
37649 " char devfd[64];\n"
37650 " snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n"
37651 " guestfs_tar_out (g, \"/\", devfd);\n"
37652 "\n"
37653
37654 #. type: =head2
37655 #: ../src/guestfs.pod:378
37656 msgid "LISTING FILES"
37657 msgstr "СПИСКИ ФАЙЛІВ"
37658
37659 #. type: textblock
37660 #: ../src/guestfs.pod:380
37661 msgid ""
37662 "L</guestfs_ll> is just designed for humans to read (mainly when using the "
37663 "L<guestfish(1)>-equivalent command C<ll>)."
37664 msgstr ""
37665
37666 #. type: textblock
37667 #: ../src/guestfs.pod:383
37668 msgid ""
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."
37671 msgstr ""
37672
37673 #. type: textblock
37674 #: ../src/guestfs.pod:386
37675 msgid ""
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."
37679 msgstr ""
37680
37681 #. type: textblock
37682 #: ../src/guestfs.pod:390
37683 msgid ""
37684 "L</guestfs_find> and L</guestfs_find0> can be used to recursively list files."
37685 msgstr ""
37686
37687 #. type: =head2
37688 #: ../src/guestfs.pod:393
37689 msgid "RUNNING COMMANDS"
37690 msgstr "ВИКОНАННЯ КОМАНД"
37691
37692 #. type: textblock
37693 #: ../src/guestfs.pod:395
37694 msgid ""
37695 "Although libguestfs is primarily an API for manipulating files inside guest "
37696 "images, we also provide some limited facilities for running commands inside "
37697 "guests."
37698 msgstr ""
37699
37700 #. type: textblock
37701 #: ../src/guestfs.pod:399
37702 msgid "There are many limitations to this:"
37703 msgstr ""
37704
37705 #. type: textblock
37706 #: ../src/guestfs.pod:405
37707 msgid ""
37708 "The kernel version that the command runs under will be different from what "
37709 "it expects."
37710 msgstr ""
37711
37712 #. type: textblock
37713 #: ../src/guestfs.pod:410
37714 msgid ""
37715 "If the command needs to communicate with daemons, then most likely they "
37716 "won't be running."
37717 msgstr ""
37718
37719 #. type: textblock
37720 #: ../src/guestfs.pod:415
37721 msgid "The command will be running in limited memory."
37722 msgstr ""
37723
37724 #. type: textblock
37725 #: ../src/guestfs.pod:419
37726 msgid ""
37727 "The network may not be available unless you enable it (see L</"
37728 "guestfs_set_network>)."
37729 msgstr ""
37730
37731 #. type: textblock
37732 #: ../src/guestfs.pod:424
37733 msgid "Only supports Linux guests (not Windows, BSD, etc)."
37734 msgstr ""
37735
37736 #. type: textblock
37737 #: ../src/guestfs.pod:428
37738 msgid ""
37739 "Architecture limitations (eg. won't work for a PPC guest on an X86 host)."
37740 msgstr ""
37741
37742 #. type: textblock
37743 #: ../src/guestfs.pod:433
37744 msgid ""
37745 "For SELinux guests, you may need to enable SELinux and load policy first.  "
37746 "See L</SELINUX> in this manpage."
37747 msgstr ""
37748
37749 #. type: textblock
37750 #: ../src/guestfs.pod:438
37751 msgid ""
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."
37759 msgstr ""
37760
37761 #. type: textblock
37762 #: ../src/guestfs.pod:447
37763 msgid ""
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>."
37769 msgstr ""
37770
37771 #. type: textblock
37772 #: ../src/guestfs.pod:455
37773 msgid ""
37774 "The two main API calls to run commands are L</guestfs_command> and L</"
37775 "guestfs_sh> (there are also variations)."
37776 msgstr ""
37777
37778 #. type: textblock
37779 #: ../src/guestfs.pod:458
37780 msgid ""
37781 "The difference is that L</guestfs_sh> runs commands using the shell, so any "
37782 "shell globs, redirections, etc will work."
37783 msgstr ""
37784
37785 #. type: =head2
37786 #: ../src/guestfs.pod:461
37787 msgid "CONFIGURATION FILES"
37788 msgstr "ФАЙЛИ НАЛАШТУВАННЯ"
37789
37790 #. type: textblock
37791 #: ../src/guestfs.pod:463
37792 msgid ""
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."
37797 msgstr ""
37798
37799 #. type: textblock
37800 #: ../src/guestfs.pod:468
37801 msgid ""
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."
37805 msgstr ""
37806
37807 #. type: textblock
37808 #: ../src/guestfs.pod:472
37809 msgid ""
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 "
37812 "over."
37813 msgstr ""
37814
37815 #. type: =head2
37816 #: ../src/guestfs.pod:476
37817 msgid "SELINUX"
37818 msgstr "SELINUX"
37819
37820 #. type: textblock
37821 #: ../src/guestfs.pod:478
37822 msgid ""
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:"
37825 msgstr ""
37826
37827 #. type: textblock
37828 #: ../src/guestfs.pod:486
37829 msgid "Before launching, do:"
37830 msgstr ""
37831
37832 #. type: verbatim
37833 #: ../src/guestfs.pod:488
37834 #, no-wrap
37835 msgid ""
37836 " guestfs_set_selinux (g, 1);\n"
37837 "\n"
37838 msgstr ""
37839 " guestfs_set_selinux (g, 1);\n"
37840 "\n"
37841
37842 #. type: textblock
37843 #: ../src/guestfs.pod:492
37844 msgid ""
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:"
37847 msgstr ""
37848
37849 #. type: verbatim
37850 #: ../src/guestfs.pod:496
37851 #, no-wrap
37852 msgid ""
37853 " guestfs_sh (g, \"/usr/sbin/load_policy\");\n"
37854 "\n"
37855 msgstr ""
37856 " guestfs_sh (g, \"/usr/sbin/load_policy\");\n"
37857 "\n"
37858
37859 #. type: textblock
37860 #: ../src/guestfs.pod:498
37861 msgid ""
37862 "(Older versions of C<load_policy> require you to specify the name of the "
37863 "policy file)."
37864 msgstr ""
37865
37866 #. type: textblock
37867 #: ../src/guestfs.pod:503
37868 msgid ""
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:"
37871 msgstr ""
37872
37873 #. type: verbatim
37874 #: ../src/guestfs.pod:507
37875 #, no-wrap
37876 msgid ""
37877 " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n"
37878 "\n"
37879 msgstr ""
37880 " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n"
37881 "\n"
37882
37883 #. type: textblock
37884 #: ../src/guestfs.pod:511
37885 msgid "This will work for running commands and editing existing files."
37886 msgstr ""
37887
37888 #. type: textblock
37889 #: ../src/guestfs.pod:513
37890 msgid ""
37891 "When new files are created, you may need to label them explicitly, for "
37892 "example by running the external command C<restorecon pathname>."
37893 msgstr ""
37894
37895 #. type: =head2
37896 #: ../src/guestfs.pod:517
37897 msgid "UMASK"
37898 msgstr "UMASK"
37899
37900 #. type: textblock
37901 #: ../src/guestfs.pod:519
37902 msgid ""
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 "
37907 "that you supply."
37908 msgstr ""
37909
37910 #. type: textblock
37911 #: ../src/guestfs.pod:525
37912 msgid ""
37913 "The default umask is C<022>, so files are created with modes such as C<0644> "
37914 "and directories with C<0755>."
37915 msgstr ""
37916
37917 #. type: textblock
37918 #: ../src/guestfs.pod:528
37919 msgid ""
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."
37923 msgstr ""
37924
37925 #. type: textblock
37926 #: ../src/guestfs.pod:532
37927 msgid "For more information about umask, see L<umask(2)>."
37928 msgstr ""
37929
37930 #. type: textblock
37931 #: ../src/guestfs.pod:536
37932 msgid ""
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."
37937 msgstr ""
37938
37939 #. type: textblock
37940 #: ../src/guestfs.pod:542
37941 msgid ""
37942 "Use L</guestfs_vfs_type> to identify LUKS-encrypted block devices (it "
37943 "returns the string C<crypto_LUKS>)."
37944 msgstr ""
37945
37946 #. type: textblock
37947 #: ../src/guestfs.pod:545
37948 msgid ""
37949 "Then open these devices by calling L</guestfs_luks_open>.  Obviously you "
37950 "will require the passphrase!"
37951 msgstr ""
37952
37953 #. type: textblock
37954 #: ../src/guestfs.pod:548
37955 msgid ""
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."
37960 msgstr ""
37961
37962 #. type: textblock
37963 #: ../src/guestfs.pod:554
37964 msgid ""
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."
37968 msgstr ""
37969
37970 #. type: textblock
37971 #: ../src/guestfs.pod:558
37972 msgid ""
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)."
37978 msgstr ""
37979
37980 #. type: =head2
37981 #: ../src/guestfs.pod:565
37982 msgid "INSPECTION"
37983 msgstr "ПЕРЕВІРКА"
37984
37985 #. type: textblock
37986 #: ../src/guestfs.pod:567
37987 msgid ""
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)."
37993 msgstr ""
37994
37995 #. type: textblock
37996 #: ../src/guestfs.pod:574
37997 msgid ""
37998 "Add all disks belonging to the unknown virtual machine and call L</"
37999 "guestfs_launch> in the usual way."
38000 msgstr ""
38001
38002 #. type: textblock
38003 #: ../src/guestfs.pod:577
38004 msgid ""
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.)"
38013 msgstr ""
38014
38015 #. type: textblock
38016 #: ../src/guestfs.pod:586
38017 msgid ""
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."
38022 msgstr ""
38023
38024 #. type: textblock
38025 #: ../src/guestfs.pod:592
38026 msgid ""
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:"
38033 msgstr ""
38034
38035 #. type: verbatim
38036 #: ../src/guestfs.pod:599
38037 #, no-wrap
38038 msgid ""
38039 " /boot => /dev/sda1\n"
38040 " /     => /dev/vg_guest/lv_root\n"
38041 " /usr  => /dev/vg_guest/lv_usr\n"
38042 "\n"
38043 msgstr ""
38044 " /boot => /dev/sda1\n"
38045 " /     => /dev/vg_guest/lv_root\n"
38046 " /usr  => /dev/vg_guest/lv_usr\n"
38047 "\n"
38048
38049 #. type: textblock
38050 #: ../src/guestfs.pod:603
38051 msgid ""
38052 "The caller can then make calls to L</guestfs_mount_options> to mount the "
38053 "filesystems as suggested."
38054 msgstr ""
38055
38056 #. type: textblock
38057 #: ../src/guestfs.pod:606
38058 msgid ""
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."
38061 msgstr ""
38062
38063 #. type: textblock
38064 #: ../src/guestfs.pod:610
38065 msgid ""
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."
38069 msgstr ""
38070
38071 #. type: textblock
38072 #: ../src/guestfs.pod:614
38073 msgid ""
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."
38077 msgstr ""
38078
38079 #. type: textblock
38080 #: ../src/guestfs.pod:618
38081 msgid ""
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 "
38089 "details)."
38090 msgstr ""
38091
38092 #. type: =head3
38093 #: ../src/guestfs.pod:627
38094 msgid "INSPECTING INSTALL DISKS"
38095 msgstr ""
38096
38097 #. type: textblock
38098 #: ../src/guestfs.pod:629
38099 msgid ""
38100 "Libguestfs (since 1.9.4) can detect some install disks, install CDs, live "
38101 "CDs and more."
38102 msgstr ""
38103
38104 #. type: textblock
38105 #: ../src/guestfs.pod:632
38106 msgid ""
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)."
38110 msgstr ""
38111
38112 #. type: textblock
38113 #: ../src/guestfs.pod:636
38114 msgid ""
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."
38118 msgstr ""
38119
38120 #. type: textblock
38121 #: ../src/guestfs.pod:641
38122 msgid ""
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."
38126 msgstr ""
38127
38128 #. type: =head2
38129 #: ../src/guestfs.pod:646
38130 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS"
38131 msgstr ""
38132
38133 #. type: textblock
38134 #: ../src/guestfs.pod:648
38135 msgid ""
38136 "Libguestfs can mount NTFS partitions.  It does this using the L<http://www."
38137 "ntfs-3g.org/> driver."
38138 msgstr ""
38139
38140 #. type: =head3
38141 #: ../src/guestfs.pod:651
38142 msgid "DRIVE LETTERS AND PATHS"
38143 msgstr "ЛІТЕРИ ДИСКІВ ТА ШЛЯХИ"
38144
38145 #. type: textblock
38146 #: ../src/guestfs.pod:653
38147 msgid ""
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>."
38153 msgstr ""
38154
38155 #. type: textblock
38156 #: ../src/guestfs.pod:659
38157 msgid ""
38158 "Drive letter mappings can be found using inspection (see L</INSPECTION> and "
38159 "L</guestfs_inspect_get_drive_mappings>)"
38160 msgstr ""
38161
38162 #. type: textblock
38163 #: ../src/guestfs.pod:662
38164 msgid ""
38165 "Dealing with separator characters (backslash vs forward slash) is outside "
38166 "the scope of libguestfs, but usually a simple character replacement will "
38167 "work."
38168 msgstr ""
38169
38170 #. type: textblock
38171 #: ../src/guestfs.pod:666
38172 msgid ""
38173 "To resolve the case insensitivity of paths, call L</"
38174 "guestfs_case_sensitive_path>."
38175 msgstr ""
38176
38177 #. type: =head3
38178 #: ../src/guestfs.pod:669
38179 msgid "ACCESSING THE WINDOWS REGISTRY"
38180 msgstr "ДОСТУП ДО РЕГІСТРУ WINDOWS"
38181
38182 #. type: textblock
38183 #: ../src/guestfs.pod:671
38184 msgid ""
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."
38191 msgstr ""
38192
38193 #. type: =head3
38194 #: ../src/guestfs.pod:679
38195 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS"
38196 msgstr "СИМВОЛІЧНІ ПОСИЛАННЯ У ФАЙЛОВИХ СИСТЕМАХ NTFS-3G"
38197
38198 #. type: textblock
38199 #: ../src/guestfs.pod:681
38200 msgid ""
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:"
38204 msgstr ""
38205
38206 #. type: textblock
38207 #: ../src/guestfs.pod:685
38208 msgid ""
38209 "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-"
38210 "symbolic-links/>"
38211 msgstr ""
38212 "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-"
38213 "symbolic-links/>"
38214
38215 #. type: textblock
38216 #: ../src/guestfs.pod:687
38217 msgid ""
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)."
38223 msgstr ""
38224
38225 #. type: textblock
38226 #: ../src/guestfs.pod:694
38227 msgid ""
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)."
38232 msgstr ""
38233
38234 #. type: =head3
38235 #: ../src/guestfs.pod:699
38236 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS"
38237 msgstr ""
38238
38239 #. type: textblock
38240 #: ../src/guestfs.pod:701
38241 msgid ""
38242 "There are other useful extended attributes that can be read from ntfs-3g "
38243 "filesystems (using L</guestfs_getxattr>).  See:"
38244 msgstr ""
38245
38246 #. type: textblock
38247 #: ../src/guestfs.pod:704
38248 msgid ""
38249 "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
38250 msgstr ""
38251 "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
38252
38253 #. type: =head2
38254 #: ../src/guestfs.pod:706
38255 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES"
38256 msgstr "ВИКОРИСТАННЯ LIBGUESTFS ЗА ДОПОМОГОЮ ІНШИХ МОВ ПРОГРАМУВАННЯ"
38257
38258 #. type: textblock
38259 #: ../src/guestfs.pod:708
38260 msgid ""
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."
38263 msgstr ""
38264
38265 #. type: textblock
38266 #: ../src/guestfs.pod:711
38267 msgid ""
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 "
38272 "each language."
38273 msgstr ""
38274
38275 #. type: textblock
38276 #: ../src/guestfs.pod:717
38277 msgid ""
38278 "Error messages are automatically transformed into exceptions if the language "
38279 "supports it."
38280 msgstr ""
38281
38282 #. type: textblock
38283 #: ../src/guestfs.pod:720
38284 msgid ""
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."
38288 msgstr ""
38289
38290 #. type: =item
38291 #: ../src/guestfs.pod:726
38292 msgid "B<C++>"
38293 msgstr "B<C++>"
38294
38295 #. type: textblock
38296 #: ../src/guestfs.pod:728
38297 msgid ""
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."
38300 msgstr ""
38301
38302 #. type: =item
38303 #: ../src/guestfs.pod:732
38304 msgid "B<C#>"
38305 msgstr "B<C#>"
38306
38307 #. type: textblock
38308 #: ../src/guestfs.pod:734
38309 msgid ""
38310 "The C# bindings are highly experimental.  Please read the warnings at the "
38311 "top of C<csharp/Libguestfs.cs>."
38312 msgstr ""
38313
38314 #. type: =item
38315 #: ../src/guestfs.pod:737
38316 msgid "B<Erlang>"
38317 msgstr ""
38318
38319 #. type: textblock
38320 #: ../src/guestfs.pod:739
38321 msgid "See L<guestfs-erlang(3)>."
38322 msgstr ""
38323
38324 #. type: =item
38325 #: ../src/guestfs.pod:741
38326 msgid "B<Haskell>"
38327 msgstr "B<Haskell>"
38328
38329 #. type: textblock
38330 #: ../src/guestfs.pod:743
38331 msgid ""
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."
38335 msgstr ""
38336
38337 #. type: =item
38338 #: ../src/guestfs.pod:747
38339 msgid "B<Java>"
38340 msgstr "B<Java>"
38341
38342 #. type: textblock
38343 #: ../src/guestfs.pod:749
38344 msgid ""
38345 "Full documentation is contained in the Javadoc which is distributed with "
38346 "libguestfs.  For examples, see L<guestfs-java(3)>."
38347 msgstr ""
38348
38349 #. type: =item
38350 #: ../src/guestfs.pod:752
38351 msgid "B<OCaml>"
38352 msgstr "B<OCaml>"
38353
38354 #. type: textblock
38355 #: ../src/guestfs.pod:754
38356 msgid "See L<guestfs-ocaml(3)>."
38357 msgstr "Див. L<guestfs-ocaml(3)>."
38358
38359 #. type: =item
38360 #: ../src/guestfs.pod:756
38361 msgid "B<Perl>"
38362 msgstr "B<Perl>"
38363
38364 #. type: textblock
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)>."
38368
38369 #. type: =item
38370 #: ../src/guestfs.pod:760
38371 msgid "B<PHP>"
38372 msgstr "B<PHP>"
38373
38374 #. type: textblock
38375 #: ../src/guestfs.pod:762
38376 msgid ""
38377 "For documentation see C<README-PHP> supplied with libguestfs sources or in "
38378 "the php-libguestfs package for your distribution."
38379 msgstr ""
38380
38381 #. type: textblock
38382 #: ../src/guestfs.pod:765
38383 msgid "The PHP binding only works correctly on 64 bit machines."
38384 msgstr ""
38385
38386 #. type: =item
38387 #: ../src/guestfs.pod:767
38388 msgid "B<Python>"
38389 msgstr "B<Python>"
38390
38391 #. type: textblock
38392 #: ../src/guestfs.pod:769
38393 msgid "See L<guestfs-python(3)>."
38394 msgstr "Див. L<guestfs-python(3)>."
38395
38396 #. type: =item
38397 #: ../src/guestfs.pod:771
38398 msgid "B<Ruby>"
38399 msgstr "B<Ruby>"
38400
38401 #. type: textblock
38402 #: ../src/guestfs.pod:773
38403 msgid "See L<guestfs-ruby(3)>."
38404 msgstr "Див. L<guestfs-ruby(3)>."
38405
38406 #. type: =item
38407 #: ../src/guestfs.pod:775
38408 msgid "B<shell scripts>"
38409 msgstr "B<скрипти оболонки>"
38410
38411 #. type: textblock
38412 #: ../src/guestfs.pod:777
38413 msgid "See L<guestfish(1)>."
38414 msgstr "Див. L<guestfish(1)>."
38415
38416 #. type: =head2
38417 #: ../src/guestfs.pod:781
38418 msgid "LIBGUESTFS GOTCHAS"
38419 msgstr ""
38420
38421 #. type: textblock
38422 #: ../src/guestfs.pod:783
38423 msgid ""
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.\""
38427 msgstr ""
38428
38429 #. type: textblock
38430 #: ../src/guestfs.pod:787
38431 msgid ""
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."
38436 msgstr ""
38437
38438 #. type: =item
38439 #: ../src/guestfs.pod:795
38440 msgid "Autosync / forgetting to sync."
38441 msgstr ""
38442
38443 #. type: textblock
38444 #: ../src/guestfs.pod:797
38445 msgid ""
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."
38448 msgstr ""
38449
38450 #. type: textblock
38451 #: ../src/guestfs.pod:800
38452 msgid ""
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:"
38456 msgstr ""
38457
38458 #. type: verbatim
38459 #: ../src/guestfs.pod:804
38460 #, no-wrap
38461 msgid ""
38462 " guestfs_set_autosync (g, 1);\n"
38463 "\n"
38464 msgstr ""
38465 " guestfs_set_autosync (g, 1);\n"
38466 "\n"
38467
38468 #. type: textblock
38469 #: ../src/guestfs.pod:806
38470 msgid ""
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.)"
38473 msgstr ""
38474
38475 #. type: textblock
38476 #: ../src/guestfs.pod:810
38477 msgid ""
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."
38481 msgstr ""
38482
38483 #. type: textblock
38484 #: ../src/guestfs.pod:814
38485 msgid ""
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."
38489 msgstr ""
38490
38491 #. type: =item
38492 #: ../src/guestfs.pod:818
38493 msgid "Mount option C<-o sync> should not be the default."
38494 msgstr ""
38495
38496 #. type: textblock
38497 #: ../src/guestfs.pod:820
38498 msgid ""
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."
38501 msgstr ""
38502
38503 #. type: textblock
38504 #: ../src/guestfs.pod:823
38505 msgid ""
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."
38509 msgstr ""
38510
38511 #. type: textblock
38512 #: ../src/guestfs.pod:827
38513 msgid ""
38514 "The work around is to use L</guestfs_mount_options> and set the mount "
38515 "options that you actually want to use."
38516 msgstr ""
38517
38518 #. type: =item
38519 #: ../src/guestfs.pod:830
38520 msgid "Read-only should be the default."
38521 msgstr ""
38522
38523 #. type: textblock
38524 #: ../src/guestfs.pod:832
38525 msgid ""
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."
38528 msgstr ""
38529
38530 #. type: textblock
38531 #: ../src/guestfs.pod:835
38532 msgid "This would reduce the potential to corrupt live VM images."
38533 msgstr ""
38534
38535 #. type: textblock
38536 #: ../src/guestfs.pod:837
38537 msgid ""
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."
38541 msgstr ""
38542
38543 #. type: =item
38544 #: ../src/guestfs.pod:841
38545 msgid "guestfish command line is hard to use."
38546 msgstr ""
38547
38548 #. type: textblock
38549 #: ../src/guestfs.pod:843
38550 msgid ""
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."
38556 msgstr ""
38557
38558 #. type: =item
38559 #: ../src/guestfs.pod:850
38560 msgid "guestfish megabyte modifiers don't work right on all commands"
38561 msgstr ""
38562
38563 #. type: textblock
38564 #: ../src/guestfs.pod:852
38565 msgid ""
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)."
38571 msgstr ""
38572
38573 #. type: textblock
38574 #: ../src/guestfs.pod:859
38575 msgid "The most common is L</guestfs_lvcreate>.  The guestfish command:"
38576 msgstr ""
38577
38578 #. type: verbatim
38579 #: ../src/guestfs.pod:861
38580 #, no-wrap
38581 msgid ""
38582 " lvcreate LV VG 100M\n"
38583 "\n"
38584 msgstr ""
38585 " lvcreate LV VG 100M\n"
38586 "\n"
38587
38588 #. type: textblock
38589 #: ../src/guestfs.pod:863
38590 msgid ""
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."
38595 msgstr ""
38596
38597 #. type: textblock
38598 #: ../src/guestfs.pod:868
38599 msgid ""
38600 "This could be fixed in the generator by specially marking parameters and "
38601 "return values which take bytes or other units."
38602 msgstr ""
38603
38604 #. type: =item
38605 #: ../src/guestfs.pod:871
38606 msgid "Ambiguity between devices and paths"
38607 msgstr ""
38608
38609 #. type: textblock
38610 #: ../src/guestfs.pod:873
38611 msgid ""
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)."
38615 msgstr ""
38616
38617 #. type: textblock
38618 #: ../src/guestfs.pod:878
38619 msgid ""
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/>."
38624 msgstr ""
38625
38626 #. type: textblock
38627 #: ../src/guestfs.pod:884
38628 msgid ""
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:"
38634 msgstr ""
38635
38636 #. type: verbatim
38637 #: ../src/guestfs.pod:890
38638 #, no-wrap
38639 msgid ""
38640 " type path = Path of string | Device of int | Partition of int * int\n"
38641 "\n"
38642 msgstr ""
38643
38644 #. type: textblock
38645 #: ../src/guestfs.pod:892
38646 msgid "which would allow you to pass arguments like:"
38647 msgstr ""
38648
38649 #. type: verbatim
38650 #: ../src/guestfs.pod:894
38651 #, no-wrap
38652 msgid ""
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"
38657 "\n"
38658 msgstr ""
38659
38660 #. type: textblock
38661 #: ../src/guestfs.pod:899
38662 msgid ""
38663 "As you can see there are still problems to resolve even with this "
38664 "representation.  Also consider how it might work in guestfish."
38665 msgstr ""
38666
38667 #. type: =head2
38668 #: ../src/guestfs.pod:904
38669 msgid "KEYS AND PASSPHRASES"
38670 msgstr "КЛЮЧІ І ПАРОЛІ"
38671
38672 #. type: textblock
38673 #: ../src/guestfs.pod:906
38674 msgid ""
38675 "Certain libguestfs calls take a parameter that contains sensitive key "
38676 "material, passed in as a C string."
38677 msgstr ""
38678
38679 #. type: textblock
38680 #: ../src/guestfs.pod:909
38681 msgid ""
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."
38686 msgstr ""
38687
38688 #. type: textblock
38689 #: ../src/guestfs.pod:914
38690 msgid ""
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."
38694 msgstr ""
38695
38696 #. type: =head2
38697 #: ../src/guestfs.pod:919
38698 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS"
38699 msgstr ""
38700
38701 #. type: textblock
38702 #: ../src/guestfs.pod:921
38703 msgid ""
38704 "All high-level libguestfs actions are synchronous.  If you want to use "
38705 "libguestfs asynchronously then you must create a thread."
38706 msgstr ""
38707
38708 #. type: textblock
38709 #: ../src/guestfs.pod:924
38710 msgid ""
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."
38714 msgstr ""
38715
38716 #. type: textblock
38717 #: ../src/guestfs.pod:928
38718 msgid ""
38719 "See the graphical program guestfs-browser for one possible architecture for "
38720 "multithreaded programs using libvirt and libguestfs."
38721 msgstr ""
38722
38723 #. type: =head2
38724 #: ../src/guestfs.pod:931
38725 msgid "PATH"
38726 msgstr "ШЛЯХ"
38727
38728 #. type: textblock
38729 #: ../src/guestfs.pod:933
38730 msgid ""
38731 "Libguestfs needs a supermin appliance, which it finds by looking along an "
38732 "internal path."
38733 msgstr ""
38734
38735 #. type: textblock
38736 #: ../src/guestfs.pod:936
38737 msgid ""
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>)."
38740 msgstr ""
38741
38742 #. type: textblock
38743 #: ../src/guestfs.pod:939
38744 msgid ""
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>."
38751 msgstr ""
38752
38753 #. type: =head2
38754 #: ../src/guestfs.pod:946
38755 msgid "QEMU WRAPPERS"
38756 msgstr ""
38757
38758 #. type: textblock
38759 #: ../src/guestfs.pod:948
38760 msgid ""
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 "
38763 "around qemu."
38764 msgstr ""
38765
38766 #. type: textblock
38767 #: ../src/guestfs.pod:952
38768 msgid ""
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."
38773 msgstr ""
38774
38775 #. type: textblock
38776 #: ../src/guestfs.pod:957
38777 msgid ""
38778 "Here is an example of a wrapper, where I have built my own copy of qemu from "
38779 "source:"
38780 msgstr ""
38781
38782 #. type: verbatim
38783 #: ../src/guestfs.pod:960
38784 #, no-wrap
38785 msgid ""
38786 " #!/bin/sh -\n"
38787 " qemudir=/home/rjones/d/qemu\n"
38788 " exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios \"$@\"\n"
38789 "\n"
38790 msgstr ""
38791 " #!/bin/sh -\n"
38792 " qemudir=/home/rjones/d/qemu\n"
38793 " exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios \"$@\"\n"
38794 "\n"
38795
38796 #. type: textblock
38797 #: ../src/guestfs.pod:964
38798 msgid ""
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 "
38801 "example:"
38802 msgstr ""
38803
38804 #. type: verbatim
38805 #: ../src/guestfs.pod:968
38806 #, no-wrap
38807 msgid ""
38808 " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
38809 "\n"
38810 msgstr ""
38811 " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
38812 "\n"
38813
38814 #. type: textblock
38815 #: ../src/guestfs.pod:970
38816 msgid ""
38817 "Note that libguestfs also calls qemu with the -help and -version options in "
38818 "order to determine features."
38819 msgstr ""
38820
38821 #. type: textblock
38822 #: ../src/guestfs.pod:973
38823 msgid ""
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."
38829 msgstr ""
38830
38831 #. type: verbatim
38832 #: ../src/guestfs.pod:982
38833 #, no-wrap
38834 msgid ""
38835 " i=0\n"
38836 " while [ $# -gt 0 ]; do\n"
38837 "     case \"$1\" in\n"
38838 "     -machine)\n"
38839 "         shift 2;;\n"
38840 "     *)\n"
38841 "         args[i]=\"$1\"\n"
38842 "         (( i++ ))\n"
38843 "         shift ;;\n"
38844 "     esac\n"
38845 " done\n"
38846 " \n"
38847 msgstr ""
38848
38849 #. type: verbatim
38850 #: ../src/guestfs.pod:994
38851 #, no-wrap
38852 msgid ""
38853 " exec qemu-kvm -machine pc,accel=tcg \"${args[@]}\"\n"
38854 "\n"
38855 msgstr ""
38856
38857 #. type: =head2
38858 #: ../src/guestfs.pod:996
38859 msgid "ATTACHING TO RUNNING DAEMONS"
38860 msgstr "ДОЛУЧЕННЯ ДО ЗАПУЩЕНИХ ФОНОВИХ СЛУЖБ"
38861
38862 #. type: textblock
38863 #: ../src/guestfs.pod:998
38864 msgid ""
38865 "I<Note (1):> This is B<highly experimental> and has a tendency to eat "
38866 "babies.  Use with caution."
38867 msgstr ""
38868
38869 #. type: textblock
38870 #: ../src/guestfs.pod:1001
38871 msgid ""
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\"."
38875 msgstr ""
38876
38877 #. type: =head3
38878 #: ../src/guestfs.pod:1005
38879 msgid "Using guestfs_set_attach_method"
38880 msgstr "За допомогою guestfs_set_attach_method"
38881
38882 #. type: textblock
38883 #: ../src/guestfs.pod:1007
38884 msgid ""
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)."
38888 msgstr ""
38889
38890 #. type: textblock
38891 #: ../src/guestfs.pod:1011
38892 msgid ""
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."
38895 msgstr ""
38896
38897 #. type: textblock
38898 #: ../src/guestfs.pod:1014
38899 msgid ""
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."
38903 msgstr ""
38904
38905 #. type: textblock
38906 #: ../src/guestfs.pod:1018
38907 msgid ""
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."
38911 msgstr ""
38912
38913 #. type: =head3
38914 #: ../src/guestfs.pod:1022
38915 msgid "Using guestfs_add_domain with live flag"
38916 msgstr "За допомогою guestfs_add_domain з прапорцем live"
38917
38918 #. type: textblock
38919 #: ../src/guestfs.pod:1024
38920 msgid ""
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:"
38925 msgstr ""
38926
38927 #. type: verbatim
38928 #: ../src/guestfs.pod:1030
38929 #, no-wrap
38930 msgid ""
38931 " <domain>\n"
38932 "   ...\n"
38933 "   <devices>\n"
38934 "     ...\n"
38935 "     <channel type='unix'>\n"
38936 "       <source mode='bind' path='/path/to/socket'/>\n"
38937 "       <target type='virtio' name='org.libguestfs.channel.0'/>\n"
38938 "     </channel>\n"
38939 "     ...\n"
38940 "   </devices>\n"
38941 " </domain>\n"
38942 "\n"
38943 msgstr ""
38944 " <domain>\n"
38945 "   ...\n"
38946 "   <devices>\n"
38947 "     ...\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"
38951 "     </channel>\n"
38952 "     ...\n"
38953 "   </devices>\n"
38954 " </domain>\n"
38955 "\n"
38956
38957 #. type: textblock
38958 #: ../src/guestfs.pod:1042
38959 msgid ""
38960 "L</guestfs_add_domain> extracts C</path/to/socket> and sets the attach "
38961 "method to C<unix:/path/to/socket>."
38962 msgstr ""
38963
38964 #. type: textblock
38965 #: ../src/guestfs.pod:1045
38966 msgid ""
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."
38970 msgstr ""
38971
38972 #. type: textblock
38973 #: ../src/guestfs.pod:1049
38974 msgid ""
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."
38977 msgstr ""
38978
38979 #. type: =head2
38980 #: ../src/guestfs.pod:1053
38981 msgid "ABI GUARANTEE"
38982 msgstr "ГАРАНТІЯ ЩОДО ABI"
38983
38984 #. type: textblock
38985 #: ../src/guestfs.pod:1055
38986 msgid ""
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."
38992 msgstr ""
38993
38994 #. type: =head2
38995 #: ../src/guestfs.pod:1061
38996 msgid "BLOCK DEVICE NAMING"
38997 msgstr "ІМЕНУВАННЯ БЛОКОВИХ ПРИСТРОЇВ"
38998
38999 #. type: textblock
39000 #: ../src/guestfs.pod:1063
39001 msgid ""
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."
39011 msgstr ""
39012
39013 #. type: textblock
39014 #: ../src/guestfs.pod:1075
39015 msgid ""
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."
39019 msgstr ""
39020
39021 #. type: textblock
39022 #: ../src/guestfs.pod:1079
39023 msgid ""
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."
39027 msgstr ""
39028
39029 #. type: textblock
39030 #: ../src/guestfs.pod:1084
39031 msgid ""
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."
39036 msgstr ""
39037
39038 #. type: textblock
39039 #: ../src/guestfs.pod:1090
39040 msgid ""
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."
39044 msgstr ""
39045
39046 #. type: =head3
39047 #: ../src/guestfs.pod:1095
39048 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION"
39049 msgstr ""
39050
39051 #. type: textblock
39052 #: ../src/guestfs.pod:1097
39053 msgid ""
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."
39058 msgstr ""
39059
39060 #. type: textblock
39061 #: ../src/guestfs.pod:1103
39062 msgid ""
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."
39066 msgstr ""
39067
39068 #. type: textblock
39069 #: ../src/guestfs.pod:1111
39070 msgid "Is the string a parameter which is a device or partition name?"
39071 msgstr ""
39072
39073 #. type: textblock
39074 #: ../src/guestfs.pod:1115
39075 msgid "Does the string begin with C</dev/sd>?"
39076 msgstr "Чи починається рядок з C</dev/sd>?"
39077
39078 #. type: textblock
39079 #: ../src/guestfs.pod:1119
39080 msgid ""
39081 "Does the named device exist? If so, we use that device.  However if I<not> "
39082 "then we continue with this algorithm."
39083 msgstr ""
39084
39085 #. type: textblock
39086 #: ../src/guestfs.pod:1124
39087 msgid "Replace initial C</dev/sd> string with C</dev/hd>."
39088 msgstr ""
39089
39090 #. type: textblock
39091 #: ../src/guestfs.pod:1126
39092 msgid "For example, change C</dev/sda2> to C</dev/hda2>."
39093 msgstr ""
39094
39095 #. type: textblock
39096 #: ../src/guestfs.pod:1128
39097 msgid "If that named device exists, use it.  If not, continue."
39098 msgstr ""
39099
39100 #. type: textblock
39101 #: ../src/guestfs.pod:1132
39102 msgid "Replace initial C</dev/sd> string with C</dev/vd>."
39103 msgstr ""
39104
39105 #. type: textblock
39106 #: ../src/guestfs.pod:1134
39107 msgid "If that named device exists, use it.  If not, return an error."
39108 msgstr ""
39109
39110 #. type: =head3
39111 #: ../src/guestfs.pod:1138
39112 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING"
39113 msgstr ""
39114
39115 #. type: textblock
39116 #: ../src/guestfs.pod:1140
39117 msgid ""
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."
39121 msgstr ""
39122
39123 #. type: textblock
39124 #: ../src/guestfs.pod:1144
39125 msgid ""
39126 "Where possible for maximum future portability programs using libguestfs "
39127 "should use these future-proof techniques:"
39128 msgstr ""
39129
39130 #. type: textblock
39131 #: ../src/guestfs.pod:1151
39132 msgid ""
39133 "Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual "
39134 "device names, and then use those names directly."
39135 msgstr ""
39136
39137 #. type: textblock
39138 #: ../src/guestfs.pod:1154
39139 msgid ""
39140 "Since those device names exist by definition, they will never be translated."
39141 msgstr ""
39142
39143 #. type: textblock
39144 #: ../src/guestfs.pod:1159
39145 msgid ""
39146 "Use higher level ways to identify filesystems, such as LVM names, UUIDs and "
39147 "filesystem labels."
39148 msgstr ""
39149
39150 #. type: textblock
39151 #: ../src/guestfs.pod:1166
39152 msgid ""
39153 "This section discusses security implications of using libguestfs, "
39154 "particularly with untrusted or malicious guests or disk images."
39155 msgstr ""
39156
39157 #. type: =head2
39158 #: ../src/guestfs.pod:1169
39159 msgid "GENERAL SECURITY CONSIDERATIONS"
39160 msgstr "ЗАГАЛЬНІ ЗАУВАЖЕННЯ ЩОДО ЗАХИСТУ"
39161
39162 #. type: textblock
39163 #: ../src/guestfs.pod:1171
39164 msgid ""
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:"
39170 msgstr ""
39171
39172 #. type: textblock
39173 #: ../src/guestfs.pod:1181
39174 msgid "the data (file etc) not being present"
39175 msgstr ""
39176
39177 #. type: textblock
39178 #: ../src/guestfs.pod:1185
39179 msgid "being present but empty"
39180 msgstr ""
39181
39182 #. type: textblock
39183 #: ../src/guestfs.pod:1189
39184 msgid "being much larger than normal"
39185 msgstr ""
39186
39187 #. type: textblock
39188 #: ../src/guestfs.pod:1193
39189 msgid "containing arbitrary 8 bit data"
39190 msgstr ""
39191
39192 #. type: textblock
39193 #: ../src/guestfs.pod:1197
39194 msgid "being in an unexpected character encoding"
39195 msgstr ""
39196
39197 #. type: textblock
39198 #: ../src/guestfs.pod:1201
39199 msgid "containing homoglyphs."
39200 msgstr ""
39201
39202 #. type: =head2
39203 #: ../src/guestfs.pod:1205
39204 msgid "SECURITY OF MOUNTING FILESYSTEMS"
39205 msgstr "ЗАХИСТ ФАЙЛОВИХ СИСТЕМ МОНТУВАННЯ"
39206
39207 #. type: textblock
39208 #: ../src/guestfs.pod:1207
39209 msgid ""
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."
39221 msgstr ""
39222
39223 #. type: textblock
39224 #: ../src/guestfs.pod:1220
39225 msgid ""
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."
39235 msgstr ""
39236
39237 #. type: textblock
39238 #: ../src/guestfs.pod:1231
39239 msgid ""
39240 "In any case callers can reduce the attack surface by forcing the filesystem "
39241 "type when mounting (use L</guestfs_mount_vfs>)."
39242 msgstr ""
39243
39244 #. type: =head2
39245 #: ../src/guestfs.pod:1234
39246 msgid "PROTOCOL SECURITY"
39247 msgstr "ЗАХИСТ ПРОТОКОЛУ"
39248
39249 #. type: textblock
39250 #: ../src/guestfs.pod:1236
39251 msgid ""
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."
39257 msgstr ""
39258
39259 #. type: =head2
39260 #: ../src/guestfs.pod:1242
39261 msgid "INSPECTION SECURITY"
39262 msgstr ""
39263
39264 #. type: textblock
39265 #: ../src/guestfs.pod:1244
39266 msgid ""
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)."
39271 msgstr ""
39272
39273 #. type: textblock
39274 #: ../src/guestfs.pod:1250
39275 msgid ""
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."
39282 msgstr ""
39283
39284 #. type: textblock
39285 #: ../src/guestfs.pod:1258
39286 msgid ""
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 "
39291 "files."
39292 msgstr ""
39293
39294 #. type: =head2
39295 #: ../src/guestfs.pod:1264
39296 msgid "RUNNING UNTRUSTED GUEST COMMANDS"
39297 msgstr "ЗАПУСК НЕЗАХИЩЕНИХ КОМАНД ГОСТЬОВОЇ СИСТЕМИ"
39298
39299 #. type: textblock
39300 #: ../src/guestfs.pod:1266
39301 msgid ""
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>."
39307 msgstr ""
39308
39309 #. type: =head2
39310 #: ../src/guestfs.pod:1272
39311 msgid "CVE-2010-3851"
39312 msgstr "CVE-2010-3851"
39313
39314 #. type: textblock
39315 #: ../src/guestfs.pod:1274
39316 msgid "https://bugzilla.redhat.com/642934"
39317 msgstr "https://bugzilla.redhat.com/642934"
39318
39319 #. type: textblock
39320 #: ../src/guestfs.pod:1276
39321 msgid ""
39322 "This security bug concerns the automatic disk format detection that qemu "
39323 "does on disk images."
39324 msgstr ""
39325
39326 #. type: textblock
39327 #: ../src/guestfs.pod:1279
39328 msgid ""
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."
39333 msgstr ""
39334
39335 #. type: textblock
39336 #: ../src/guestfs.pod:1284
39337 msgid ""
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."
39342 msgstr ""
39343
39344 #. type: textblock
39345 #: ../src/guestfs.pod:1289
39346 msgid ""
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."
39354 msgstr ""
39355
39356 #. type: textblock
39357 #: ../src/guestfs.pod:1297
39358 msgid ""
39359 "In libguestfs this is rather hard to exploit except under two circumstances:"
39360 msgstr ""
39361
39362 #. type: textblock
39363 #: ../src/guestfs.pod:1304
39364 msgid "You have enabled the network or have opened the disk in write mode."
39365 msgstr ""
39366
39367 #. type: textblock
39368 #: ../src/guestfs.pod:1308
39369 msgid ""
39370 "You are also running untrusted code from the guest (see L</RUNNING "
39371 "COMMANDS>)."
39372 msgstr ""
39373
39374 #. type: textblock
39375 #: ../src/guestfs.pod:1313
39376 msgid ""
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 "
39380 "other cases too."
39381 msgstr ""
39382
39383 #. type: textblock
39384 #: ../src/guestfs.pod:1318
39385 msgid ""
39386 "For disks added from libvirt using calls like L</guestfs_add_domain>, the "
39387 "format is fetched from libvirt and passed through."
39388 msgstr ""
39389
39390 #. type: textblock
39391 #: ../src/guestfs.pod:1321
39392 msgid ""
39393 "For libguestfs tools, use the I<--format> command line parameter as "
39394 "appropriate."
39395 msgstr ""
39396
39397 #. type: =head1
39398 #: ../src/guestfs.pod:1324
39399 msgid "CONNECTION MANAGEMENT"
39400 msgstr "КЕРУВАННЯ З’ЄДНАННЯМ"
39401
39402 #. type: =head2
39403 #: ../src/guestfs.pod:1326
39404 msgid "guestfs_h *"
39405 msgstr "guestfs_h *"
39406
39407 #. type: textblock
39408 #: ../src/guestfs.pod:1328
39409 msgid ""
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."
39413 msgstr ""
39414
39415 #. type: textblock
39416 #: ../src/guestfs.pod:1332
39417 msgid ""
39418 "For information on using multiple handles and threads, see the section L</"
39419 "MULTIPLE HANDLES AND MULTIPLE THREADS> above."
39420 msgstr ""
39421
39422 #. type: =head2
39423 #: ../src/guestfs.pod:1335
39424 msgid "guestfs_create"
39425 msgstr "guestfs_create"
39426
39427 #. type: verbatim
39428 #: ../src/guestfs.pod:1337
39429 #, no-wrap
39430 msgid ""
39431 " guestfs_h *guestfs_create (void);\n"
39432 "\n"
39433 msgstr ""
39434 " guestfs_h *guestfs_create (void);\n"
39435 "\n"
39436
39437 #. type: textblock
39438 #: ../src/guestfs.pod:1339
39439 msgid "Create a connection handle."
39440 msgstr "Створити дескриптор з’єднання."
39441
39442 #. type: textblock
39443 #: ../src/guestfs.pod:1341
39444 msgid ""
39445 "On success this returns a non-NULL pointer to a handle.  On error it returns "
39446 "NULL."
39447 msgstr ""
39448
39449 #. type: textblock
39450 #: ../src/guestfs.pod:1344
39451 msgid ""
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."
39455 msgstr ""
39456
39457 #. type: textblock
39458 #: ../src/guestfs.pod:1348
39459 msgid "After configuring the handle, you have to call L</guestfs_launch>."
39460 msgstr ""
39461
39462 #. type: textblock
39463 #: ../src/guestfs.pod:1350
39464 msgid ""
39465 "You may also want to configure error handling for the handle.  See the L</"
39466 "ERROR HANDLING> section below."
39467 msgstr ""
39468
39469 #. type: =head2
39470 #: ../src/guestfs.pod:1353
39471 msgid "guestfs_close"
39472 msgstr "guestfs_close"
39473
39474 #. type: verbatim
39475 #: ../src/guestfs.pod:1355
39476 #, no-wrap
39477 msgid ""
39478 " void guestfs_close (guestfs_h *g);\n"
39479 "\n"
39480 msgstr ""
39481 " void guestfs_close (guestfs_h *g);\n"
39482 "\n"
39483
39484 #. type: textblock
39485 #: ../src/guestfs.pod:1357
39486 msgid "This closes the connection handle and frees up all resources used."
39487 msgstr ""
39488
39489 #. type: textblock
39490 #: ../src/guestfs.pod:1359
39491 msgid ""
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."
39495 msgstr ""
39496
39497 #. type: textblock
39498 #: ../src/guestfs.pod:1363
39499 msgid "If a close callback was set on the handle, then it is called."
39500 msgstr ""
39501
39502 #. type: =head1
39503 #: ../src/guestfs.pod:1365
39504 msgid "ERROR HANDLING"
39505 msgstr "ОБРОБКА ПОМИЛОК"
39506
39507 #. type: textblock
39508 #: ../src/guestfs.pod:1367
39509 msgid ""
39510 "API functions can return errors.  For example, almost all functions that "
39511 "return C<int> will return C<-1> to indicate an error."
39512 msgstr ""
39513
39514 #. type: textblock
39515 #: ../src/guestfs.pod:1370
39516 msgid ""
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 "
39519 "call."
39520 msgstr ""
39521
39522 #. type: textblock
39523 #: ../src/guestfs.pod:1374
39524 msgid ""
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>."
39528 msgstr ""
39529
39530 #. type: textblock
39531 #: ../src/guestfs.pod:1379
39532 msgid ""
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:"
39536 msgstr ""
39537
39538 #. type: verbatim
39539 #: ../src/guestfs.pod:1383
39540 #, no-wrap
39541 msgid ""
39542 " if (guestfs_launch (g) == -1)\n"
39543 "   exit (EXIT_FAILURE);\n"
39544 "\n"
39545 msgstr ""
39546 " if (guestfs_launch (g) == -1)\n"
39547 "   exit (EXIT_FAILURE);\n"
39548 "\n"
39549
39550 #. type: textblock
39551 #: ../src/guestfs.pod:1386
39552 msgid ""
39553 "since the default error handler will ensure that an error message has been "
39554 "printed to C<stderr> before the program exits."
39555 msgstr ""
39556
39557 #. type: textblock
39558 #: ../src/guestfs.pod:1389
39559 msgid ""
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:"
39562 msgstr ""
39563
39564 #. type: verbatim
39565 #: ../src/guestfs.pod:1392
39566 #, no-wrap
39567 msgid ""
39568 " /* This disables the default behaviour of printing errors\n"
39569 "    on stderr. */\n"
39570 " guestfs_set_error_handler (g, NULL, NULL);\n"
39571 " \n"
39572 msgstr ""
39573
39574 #. type: verbatim
39575 #: ../src/guestfs.pod:1396
39576 #, no-wrap
39577 msgid ""
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"
39586 "   /* ... */\n"
39587 " }\n"
39588 "\n"
39589 msgstr ""
39590
39591 #. type: textblock
39592 #: ../src/guestfs.pod:1407
39593 msgid ""
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>."
39597 msgstr ""
39598
39599 #. type: textblock
39600 #: ../src/guestfs.pod:1411
39601 msgid ""
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)."
39607 msgstr ""
39608
39609 #. type: =head2
39610 #: ../src/guestfs.pod:1417
39611 msgid "guestfs_last_error"
39612 msgstr "guestfs_last_error"
39613
39614 #. type: verbatim
39615 #: ../src/guestfs.pod:1419
39616 #, no-wrap
39617 msgid ""
39618 " const char *guestfs_last_error (guestfs_h *g);\n"
39619 "\n"
39620 msgstr ""
39621 " const char *guestfs_last_error (guestfs_h *g);\n"
39622 "\n"
39623
39624 #. type: textblock
39625 #: ../src/guestfs.pod:1421
39626 msgid ""
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>."
39629 msgstr ""
39630
39631 #. type: textblock
39632 #: ../src/guestfs.pod:1425
39633 msgid ""
39634 "The lifetime of the returned string is until the next error occurs, or L</"
39635 "guestfs_close> is called."
39636 msgstr ""
39637
39638 #. type: =head2
39639 #: ../src/guestfs.pod:1428
39640 msgid "guestfs_last_errno"
39641 msgstr "guestfs_last_errno"
39642
39643 #. type: verbatim
39644 #: ../src/guestfs.pod:1430
39645 #, no-wrap
39646 msgid ""
39647 " int guestfs_last_errno (guestfs_h *g);\n"
39648 "\n"
39649 msgstr ""
39650 " int guestfs_last_errno (guestfs_h *g);\n"
39651 "\n"
39652
39653 #. type: textblock
39654 #: ../src/guestfs.pod:1432
39655 msgid "This returns the last error number (errno) that happened on C<g>."
39656 msgstr ""
39657
39658 #. type: textblock
39659 #: ../src/guestfs.pod:1434
39660 msgid "If successful, an errno integer not equal to zero is returned."
39661 msgstr ""
39662
39663 #. type: textblock
39664 #: ../src/guestfs.pod:1436
39665 msgid ""
39666 "If no error, this returns 0.  This call can return 0 in three situations:"
39667 msgstr ""
39668
39669 #. type: textblock
39670 #: ../src/guestfs.pod:1443
39671 msgid "There has not been any error on the handle."
39672 msgstr ""
39673
39674 #. type: textblock
39675 #: ../src/guestfs.pod:1447
39676 msgid ""
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."
39680 msgstr ""
39681
39682 #. type: textblock
39683 #: ../src/guestfs.pod:1453
39684 msgid ""
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."
39687 msgstr ""
39688
39689 #. type: textblock
39690 #: ../src/guestfs.pod:1459
39691 msgid ""
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."
39698 msgstr ""
39699
39700 #. type: =head2
39701 #: ../src/guestfs.pod:1467
39702 msgid "guestfs_set_error_handler"
39703 msgstr "guestfs_set_error_handler"
39704
39705 #. type: verbatim
39706 #: ../src/guestfs.pod:1469
39707 #, no-wrap
39708 msgid ""
39709 " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
39710 "                                           void *opaque,\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"
39715 "\n"
39716 msgstr ""
39717 " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
39718 "                                           void *opaque,\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"
39723 "\n"
39724
39725 #. type: textblock
39726 #: ../src/guestfs.pod:1476
39727 msgid ""
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 "
39730 "string."
39731 msgstr ""
39732
39733 #. type: textblock
39734 #: ../src/guestfs.pod:1480
39735 msgid ""
39736 "C<errno> is not passed to the callback.  To get that the callback must call "
39737 "L</guestfs_last_errno>."
39738 msgstr ""
39739
39740 #. type: textblock
39741 #: ../src/guestfs.pod:1483
39742 msgid ""
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 "
39745 "own copy."
39746 msgstr ""
39747
39748 #. type: textblock
39749 #: ../src/guestfs.pod:1487
39750 msgid "The default handler prints messages on C<stderr>."
39751 msgstr ""
39752
39753 #. type: textblock
39754 #: ../src/guestfs.pod:1489
39755 msgid "If you set C<cb> to C<NULL> then I<no> handler is called."
39756 msgstr ""
39757
39758 #. type: =head2
39759 #: ../src/guestfs.pod:1491
39760 msgid "guestfs_get_error_handler"
39761 msgstr "guestfs_get_error_handler"
39762
39763 #. type: verbatim
39764 #: ../src/guestfs.pod:1493
39765 #, no-wrap
39766 msgid ""
39767 " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
39768 "                                                     void **opaque_rtn);\n"
39769 "\n"
39770 msgstr ""
39771 " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
39772 "                                                     void **opaque_rtn);\n"
39773 "\n"
39774
39775 #. type: textblock
39776 #: ../src/guestfs.pod:1496
39777 msgid "Returns the current error handler callback."
39778 msgstr ""
39779
39780 #. type: =head2
39781 #: ../src/guestfs.pod:1498
39782 msgid "guestfs_set_out_of_memory_handler"
39783 msgstr "guestfs_set_out_of_memory_handler"
39784
39785 #. type: verbatim
39786 #: ../src/guestfs.pod:1500
39787 #, no-wrap
39788 msgid ""
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"
39792 "\n"
39793 msgstr ""
39794
39795 #. type: textblock
39796 #: ../src/guestfs.pod:1504
39797 msgid ""
39798 "The callback C<cb> will be called if there is an out of memory situation.  "
39799 "I<Note this callback must not return>."
39800 msgstr ""
39801
39802 #. type: textblock
39803 #: ../src/guestfs.pod:1507
39804 msgid "The default is to call L<abort(3)>."
39805 msgstr ""
39806
39807 #. type: textblock
39808 #: ../src/guestfs.pod:1509
39809 msgid ""
39810 "You cannot set C<cb> to C<NULL>.  You can't ignore out of memory situations."
39811 msgstr ""
39812
39813 #. type: =head2
39814 #: ../src/guestfs.pod:1512
39815 msgid "guestfs_get_out_of_memory_handler"
39816 msgstr "guestfs_get_out_of_memory_handler"
39817
39818 #. type: verbatim
39819 #: ../src/guestfs.pod:1514
39820 #, no-wrap
39821 msgid ""
39822 " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
39823 "\n"
39824 msgstr ""
39825 " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
39826 "\n"
39827
39828 #. type: textblock
39829 #: ../src/guestfs.pod:1516
39830 msgid "This returns the current out of memory handler."
39831 msgstr ""
39832
39833 #. type: =head1
39834 #: ../src/guestfs.pod:1518
39835 msgid "API CALLS"
39836 msgstr "ВИКЛИКИ API"
39837
39838 #. type: =head1
39839 #: ../src/guestfs.pod:1522
39840 msgid "STRUCTURES"
39841 msgstr "СТРУКТУРИ"
39842
39843 #. type: textblock
39844 #: ../src/guestfs.pod:1524
39845 msgid "@STRUCTS@"
39846 msgstr "@STRUCTS@"
39847
39848 #. type: =head1
39849 #: ../src/guestfs.pod:1526
39850 msgid "AVAILABILITY"
39851 msgstr "ДОСТУПНІСТЬ"
39852
39853 #. type: =head2
39854 #: ../src/guestfs.pod:1528
39855 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE"
39856 msgstr "ГРУПИ ФУНКЦІОНАЛЬНИХ МОЖЛИВОСТЕЙ У ОБРАЗІ ОСНОВНОЇ СИСТЕМИ"
39857
39858 #. type: textblock
39859 #: ../src/guestfs.pod:1530
39860 msgid ""
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."
39864 msgstr ""
39865
39866 #. type: textblock
39867 #: ../src/guestfs.pod:1535
39868 msgid "@AVAILABILITY@"
39869 msgstr "@AVAILABILITY@"
39870
39871 #. type: =head2
39872 #: ../src/guestfs.pod:1537
39873 msgid "GUESTFISH supported COMMAND"
39874 msgstr ""
39875
39876 #. type: textblock
39877 #: ../src/guestfs.pod:1539
39878 msgid ""
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."
39882 msgstr ""
39883
39884 #. type: =head2
39885 #: ../src/guestfs.pod:1544
39886 msgid "SINGLE CALLS AT COMPILE TIME"
39887 msgstr ""
39888
39889 #. type: textblock
39890 #: ../src/guestfs.pod:1546
39891 msgid ""
39892 "Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API "
39893 "function, such as:"
39894 msgstr ""
39895
39896 #. type: verbatim
39897 #: ../src/guestfs.pod:1549
39898 #, no-wrap
39899 msgid ""
39900 " #define LIBGUESTFS_HAVE_DD 1\n"
39901 "\n"
39902 msgstr ""
39903 " #define LIBGUESTFS_HAVE_DD 1\n"
39904 "\n"
39905
39906 #. type: textblock
39907 #: ../src/guestfs.pod:1551
39908 msgid "if L</guestfs_dd> is available."
39909 msgstr ""
39910
39911 #. type: textblock
39912 #: ../src/guestfs.pod:1553
39913 msgid ""
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:"
39917 msgstr ""
39918
39919 #. type: verbatim
39920 #: ../src/guestfs.pod:1558
39921 #, no-wrap
39922 msgid ""
39923 " AC_CHECK_LIB([guestfs],[guestfs_create])\n"
39924 " AC_CHECK_FUNCS([guestfs_dd])\n"
39925 "\n"
39926 msgstr ""
39927 " AC_CHECK_LIB([guestfs],[guestfs_create])\n"
39928 " AC_CHECK_FUNCS([guestfs_dd])\n"
39929 "\n"
39930
39931 #. type: textblock
39932 #: ../src/guestfs.pod:1561
39933 msgid ""
39934 "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined "
39935 "in your program."
39936 msgstr ""
39937
39938 #. type: =head2
39939 #: ../src/guestfs.pod:1564
39940 msgid "SINGLE CALLS AT RUN TIME"
39941 msgstr ""
39942
39943 #. type: textblock
39944 #: ../src/guestfs.pod:1566
39945 msgid ""
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."
39951 msgstr ""
39952
39953 #. type: textblock
39954 #: ../src/guestfs.pod:1573
39955 msgid ""
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 "
39958 "well):"
39959 msgstr ""
39960
39961 #. type: verbatim
39962 #: ../src/guestfs.pod:1577
39963 #, no-wrap
39964 msgid ""
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"
39970 " \n"
39971 msgstr ""
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"
39977 " \n"
39978
39979 #. type: verbatim
39980 #: ../src/guestfs.pod:1583
39981 #, no-wrap
39982 msgid ""
39983 " main ()\n"
39984 " {\n"
39985 " #ifdef LIBGUESTFS_HAVE_DD\n"
39986 "   void *dl;\n"
39987 "   int has_function;\n"
39988 " \n"
39989 msgstr ""
39990 " main ()\n"
39991 " {\n"
39992 " #ifdef LIBGUESTFS_HAVE_DD\n"
39993 "   void *dl;\n"
39994 "   int has_function;\n"
39995 " \n"
39996
39997 #. type: verbatim
39998 #: ../src/guestfs.pod:1589
39999 #, no-wrap
40000 msgid ""
40001 "   /* Test if the function guestfs_dd is really available. */\n"
40002 "   dl = dlopen (NULL, RTLD_LAZY);\n"
40003 "   if (!dl) {\n"
40004 "     fprintf (stderr, \"dlopen: %s\\n\", dlerror ());\n"
40005 "     exit (EXIT_FAILURE);\n"
40006 "   }\n"
40007 "   has_function = dlsym (dl, \"guestfs_dd\") != NULL;\n"
40008 "   dlclose (dl);\n"
40009 " \n"
40010 msgstr ""
40011
40012 #. type: verbatim
40013 #: ../src/guestfs.pod:1598
40014 #, no-wrap
40015 msgid ""
40016 "   if (!has_function)\n"
40017 "     printf (\"this libguestfs.so does NOT have guestfs_dd function\\n\");\n"
40018 "   else {\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"
40022 "     */\n"
40023 "   }\n"
40024 " #else\n"
40025 "   printf (\"guestfs_dd function was not found at compile time\\n\");\n"
40026 " #endif\n"
40027 "  }\n"
40028 "\n"
40029 msgstr ""
40030
40031 #. type: textblock
40032 #: ../src/guestfs.pod:1611
40033 msgid ""
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:"
40037 msgstr ""
40038
40039 #. type: verbatim
40040 #: ../src/guestfs.pod:1616
40041 #, no-wrap
40042 msgid ""
40043 " Requires: libguestfs >= 1.0.80\n"
40044 "\n"
40045 msgstr ""
40046
40047 #. type: =head1
40048 #: ../src/guestfs.pod:1618
40049 msgid "CALLS WITH OPTIONAL ARGUMENTS"
40050 msgstr ""
40051
40052 #. type: textblock
40053 #: ../src/guestfs.pod:1620
40054 msgid ""
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:"
40058 msgstr ""
40059
40060 #. type: verbatim
40061 #: ../src/guestfs.pod:1625
40062 #, no-wrap
40063 msgid ""
40064 " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n"
40065 "\n"
40066 msgstr ""
40067 " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n"
40068 "\n"
40069
40070 #. type: textblock
40071 #: ../src/guestfs.pod:1627
40072 msgid ""
40073 "Call this with a list of optional arguments, terminated by C<-1>.  So to "
40074 "call with no optional arguments specified:"
40075 msgstr ""
40076
40077 #. type: verbatim
40078 #: ../src/guestfs.pod:1630
40079 #, no-wrap
40080 msgid ""
40081 " guestfs_add_drive_opts (g, filename, -1);\n"
40082 "\n"
40083 msgstr ""
40084 " guestfs_add_drive_opts (g, filename, -1);\n"
40085 "\n"
40086
40087 #. type: textblock
40088 #: ../src/guestfs.pod:1632
40089 msgid "With a single optional argument:"
40090 msgstr ""
40091
40092 #. type: verbatim
40093 #: ../src/guestfs.pod:1634
40094 #, no-wrap
40095 msgid ""
40096 " guestfs_add_drive_opts (g, filename,\n"
40097 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
40098 "                         -1);\n"
40099 "\n"
40100 msgstr ""
40101 " guestfs_add_drive_opts (g, filename,\n"
40102 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
40103 "                         -1);\n"
40104 "\n"
40105
40106 #. type: textblock
40107 #: ../src/guestfs.pod:1638
40108 msgid "With two:"
40109 msgstr ""
40110
40111 #. type: verbatim
40112 #: ../src/guestfs.pod:1640
40113 #, no-wrap
40114 msgid ""
40115 " guestfs_add_drive_opts (g, filename,\n"
40116 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
40117 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
40118 "                         -1);\n"
40119 "\n"
40120 msgstr ""
40121 " guestfs_add_drive_opts (g, filename,\n"
40122 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
40123 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
40124 "                         -1);\n"
40125 "\n"
40126
40127 #. type: textblock
40128 #: ../src/guestfs.pod:1645
40129 msgid ""
40130 "and so forth.  Don't forget the terminating C<-1> otherwise Bad Things will "
40131 "happen!"
40132 msgstr ""
40133
40134 #. type: =head2
40135 #: ../src/guestfs.pod:1648
40136 msgid "USING va_list FOR OPTIONAL ARGUMENTS"
40137 msgstr ""
40138
40139 #. type: textblock
40140 #: ../src/guestfs.pod:1650
40141 msgid ""
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:"
40145 msgstr ""
40146
40147 #. type: verbatim
40148 #: ../src/guestfs.pod:1654
40149 #, no-wrap
40150 msgid ""
40151 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
40152 "                                va_list args);\n"
40153 "\n"
40154 msgstr ""
40155 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
40156 "                                va_list args);\n"
40157 "\n"
40158
40159 #. type: =head2
40160 #: ../src/guestfs.pod:1657
40161 msgid "CONSTRUCTING OPTIONAL ARGUMENTS"
40162 msgstr ""
40163
40164 #. type: textblock
40165 #: ../src/guestfs.pod:1659
40166 msgid ""
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 "
40171 "are declared:"
40172 msgstr ""
40173
40174 #. type: verbatim
40175 #: ../src/guestfs.pod:1665
40176 #, no-wrap
40177 msgid ""
40178 " struct guestfs_add_drive_opts_argv {\n"
40179 "   uint64_t bitmask;\n"
40180 "   int readonly;\n"
40181 "   const char *format;\n"
40182 "   /* ... */\n"
40183 " };\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"
40186 "\n"
40187 msgstr ""
40188 " struct guestfs_add_drive_opts_argv {\n"
40189 "   uint64_t bitmask;\n"
40190 "   int readonly;\n"
40191 "   const char *format;\n"
40192 "   /* ... */\n"
40193 " };\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"
40196 "\n"
40197
40198 #. type: textblock
40199 #: ../src/guestfs.pod:1674
40200 msgid "You could call it like this:"
40201 msgstr ""
40202
40203 #. type: verbatim
40204 #: ../src/guestfs.pod:1676
40205 #, no-wrap
40206 msgid ""
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"
40212 " };\n"
40213 " \n"
40214 msgstr ""
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"
40220 " };\n"
40221 " \n"
40222
40223 #. type: verbatim
40224 #: ../src/guestfs.pod:1683
40225 #, no-wrap
40226 msgid ""
40227 " guestfs_add_drive_opts_argv (g, filename, &optargs);\n"
40228 "\n"
40229 msgstr ""
40230 " guestfs_add_drive_opts_argv (g, filename, &optargs);\n"
40231 "\n"
40232
40233 #. type: textblock
40234 #: ../src/guestfs.pod:1691
40235 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask."
40236 msgstr ""
40237
40238 #. type: textblock
40239 #: ../src/guestfs.pod:1696
40240 msgid "You do not need to fill in all fields of the structure."
40241 msgstr ""
40242
40243 #. type: textblock
40244 #: ../src/guestfs.pod:1700
40245 msgid ""
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."
40248 msgstr ""
40249
40250 #. type: =head2
40251 #: ../src/guestfs.pod:1705
40252 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES"
40253 msgstr ""
40254
40255 #. type: textblock
40256 #: ../src/guestfs.pod:1707
40257 msgid ""
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."
40261 msgstr ""
40262
40263 #. type: textblock
40264 #: ../src/guestfs.pod:1711
40265 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>."
40266 msgstr ""
40267
40268 #. type: =head2
40269 #: ../src/guestfs.pod:1713
40270 msgid "SETTING CALLBACKS TO HANDLE EVENTS"
40271 msgstr ""
40272
40273 #. type: textblock
40274 #: ../src/guestfs.pod:1715
40275 msgid ""
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."
40283 msgstr ""
40284
40285 #. type: textblock
40286 #: ../src/guestfs.pod:1724
40287 msgid ""
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."
40295 msgstr ""
40296
40297 #. type: textblock
40298 #: ../src/guestfs.pod:1732
40299 msgid ""
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 "
40303 "same thread."
40304 msgstr ""
40305
40306 #. type: textblock
40307 #: ../src/guestfs.pod:1737
40308 msgid ""
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."
40311 msgstr ""
40312
40313 #. type: =head3
40314 #: ../src/guestfs.pod:1741
40315 msgid "CLASSES OF EVENTS"
40316 msgstr ""
40317
40318 #. type: =item
40319 #: ../src/guestfs.pod:1745
40320 msgid "GUESTFS_EVENT_CLOSE (payload type: void)"
40321 msgstr ""
40322
40323 #. type: textblock
40324 #: ../src/guestfs.pod:1748
40325 msgid ""
40326 "The callback function will be called while the handle is being closed "
40327 "(synchronously from L</guestfs_close>)."
40328 msgstr ""
40329
40330 #. type: textblock
40331 #: ../src/guestfs.pod:1751
40332 msgid ""
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)."
40339 msgstr ""
40340
40341 #. type: textblock
40342 #: ../src/guestfs.pod:1758
40343 msgid ""
40344 "If no callback is registered: the handle is closed without any callback "
40345 "being invoked."
40346 msgstr ""
40347
40348 #. type: =item
40349 #: ../src/guestfs.pod:1761
40350 msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)"
40351 msgstr ""
40352
40353 #. type: textblock
40354 #: ../src/guestfs.pod:1764
40355 msgid ""
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)."
40359 msgstr ""
40360
40361 #. type: textblock
40362 #: ../src/guestfs.pod:1768 ../src/guestfs.pod:1777 ../src/guestfs.pod:1894
40363 msgid "If no callback is registered: the event is ignored."
40364 msgstr ""
40365
40366 #. type: =item
40367 #: ../src/guestfs.pod:1770
40368 msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)"
40369 msgstr ""
40370
40371 #. type: textblock
40372 #: ../src/guestfs.pod:1773
40373 msgid ""
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)."
40377 msgstr ""
40378
40379 #. type: =item
40380 #: ../src/guestfs.pod:1779
40381 msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)"
40382 msgstr ""
40383
40384 #. type: textblock
40385 #: ../src/guestfs.pod:1782
40386 msgid ""
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)."
40392 msgstr ""
40393
40394 #. type: textblock
40395 #: ../src/guestfs.pod:1788
40396 msgid ""
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>."
40399 msgstr ""
40400
40401 #. type: textblock
40402 #: ../src/guestfs.pod:1791
40403 msgid ""
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."
40407 msgstr ""
40408
40409 #. type: textblock
40410 #: ../src/guestfs.pod:1796
40411 msgid "The only defined and stable parts of the API are:"
40412 msgstr ""
40413
40414 #. type: textblock
40415 #: ../src/guestfs.pod:1802
40416 msgid ""
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>."
40419 msgstr ""
40420
40421 #. type: textblock
40422 #: ../src/guestfs.pod:1807
40423 msgid "0 E<lt>= C<position> E<lt>= C<total>"
40424 msgstr ""
40425
40426 #. type: textblock
40427 #: ../src/guestfs.pod:1811
40428 msgid ""
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)."
40432 msgstr ""
40433
40434 #. type: textblock
40435 #: ../src/guestfs.pod:1815
40436 msgid ""
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."
40440 msgstr ""
40441
40442 #. type: textblock
40443 #: ../src/guestfs.pod:1821
40444 msgid ""
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)."
40449 msgstr ""
40450
40451 #. type: textblock
40452 #: ../src/guestfs.pod:1826
40453 msgid ""
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>."
40457 msgstr ""
40458
40459 #. type: textblock
40460 #: ../src/guestfs.pod:1830
40461 msgid ""
40462 "As noted above, if the call fails with an error then the final message may "
40463 "not be generated."
40464 msgstr ""
40465
40466 #. type: textblock
40467 #: ../src/guestfs.pod:1835
40468 msgid ""
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."
40473 msgstr ""
40474
40475 #. type: textblock
40476 #: ../src/guestfs.pod:1841
40477 msgid "If no callback is registered: progress messages are discarded."
40478 msgstr ""
40479
40480 #. type: =item
40481 #: ../src/guestfs.pod:1843
40482 msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)"
40483 msgstr ""
40484
40485 #. type: textblock
40486 #: ../src/guestfs.pod:1846
40487 msgid ""
40488 "The callback function is called whenever a log message is generated by qemu, "
40489 "the appliance kernel, guestfsd (daemon), or utility programs."
40490 msgstr ""
40491
40492 #. type: textblock
40493 #: ../src/guestfs.pod:1849
40494 msgid ""
40495 "If the verbose flag (L</guestfs_set_verbose>) is set before launch (L</"
40496 "guestfs_launch>) then additional debug messages are generated."
40497 msgstr ""
40498
40499 #. type: textblock
40500 #: ../src/guestfs.pod:1852 ../src/guestfs.pod:1866
40501 msgid ""
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."
40505 msgstr ""
40506
40507 #. type: =item
40508 #: ../src/guestfs.pod:1857
40509 msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)"
40510 msgstr ""
40511
40512 #. type: textblock
40513 #: ../src/guestfs.pod:1860
40514 msgid ""
40515 "The callback function is called whenever a log message is generated by the "
40516 "library part of libguestfs."
40517 msgstr ""
40518
40519 #. type: textblock
40520 #: ../src/guestfs.pod:1863
40521 msgid ""
40522 "If the verbose flag (L</guestfs_set_verbose>) is set then additional debug "
40523 "messages are generated."
40524 msgstr ""
40525
40526 #. type: =item
40527 #: ../src/guestfs.pod:1871
40528 msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)"
40529 msgstr ""
40530
40531 #. type: textblock
40532 #: ../src/guestfs.pod:1874
40533 msgid ""
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."
40536 msgstr ""
40537
40538 #. type: textblock
40539 #: ../src/guestfs.pod:1877
40540 msgid ""
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."
40543 msgstr ""
40544
40545 #. type: =item
40546 #: ../src/guestfs.pod:1881
40547 msgid "GUESTFS_EVENT_ENTER (payload type: function name)"
40548 msgstr ""
40549
40550 #. type: textblock
40551 #: ../src/guestfs.pod:1884
40552 msgid ""
40553 "The callback function is called whenever a libguestfs function is entered."
40554 msgstr ""
40555
40556 #. type: textblock
40557 #: ../src/guestfs.pod:1887
40558 msgid ""
40559 "The payload is a string which contains the name of the function that we are "
40560 "entering (not including C<guestfs_> prefix)."
40561 msgstr ""
40562
40563 #. type: textblock
40564 #: ../src/guestfs.pod:1890
40565 msgid ""
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 "
40568 "event."
40569 msgstr ""
40570
40571 #. type: =head3
40572 #: ../src/guestfs.pod:1898
40573 msgid "guestfs_set_event_callback"
40574 msgstr ""
40575
40576 #. type: verbatim
40577 #: ../src/guestfs.pod:1900
40578 #, no-wrap
40579 msgid ""
40580 " int guestfs_set_event_callback (guestfs_h *g,\n"
40581 "                                 guestfs_event_callback cb,\n"
40582 "                                 uint64_t event_bitmask,\n"
40583 "                                 int flags,\n"
40584 "                                 void *opaque);\n"
40585 "\n"
40586 msgstr ""
40587
40588 #. type: textblock
40589 #: ../src/guestfs.pod:1906
40590 msgid ""
40591 "This function registers a callback (C<cb>) for all event classes in the "
40592 "C<event_bitmask>."
40593 msgstr ""
40594
40595 #. type: textblock
40596 #: ../src/guestfs.pod:1909
40597 msgid ""
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>."
40602 msgstr ""
40603
40604 #. type: textblock
40605 #: ../src/guestfs.pod:1915
40606 msgid "C<flags> should always be passed as 0."
40607 msgstr ""
40608
40609 #. type: textblock
40610 #: ../src/guestfs.pod:1917
40611 msgid ""
40612 "C<opaque> is an opaque pointer which is passed to the callback.  You can use "
40613 "it for any purpose."
40614 msgstr ""
40615
40616 #. type: textblock
40617 #: ../src/guestfs.pod:1920
40618 msgid ""
40619 "The return value is the event handle (an integer) which you can use to "
40620 "delete the callback (see below)."
40621 msgstr ""
40622
40623 #. type: textblock
40624 #: ../src/guestfs.pod:1923
40625 msgid ""
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.)"
40628 msgstr ""
40629
40630 #. type: textblock
40631 #: ../src/guestfs.pod:1926
40632 msgid ""
40633 "Callbacks remain in effect until they are deleted, or until the handle is "
40634 "closed."
40635 msgstr ""
40636
40637 #. type: textblock
40638 #: ../src/guestfs.pod:1929
40639 msgid ""
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."
40643 msgstr ""
40644
40645 #. type: =head3
40646 #: ../src/guestfs.pod:1933
40647 msgid "guestfs_delete_event_callback"
40648 msgstr ""
40649
40650 #. type: verbatim
40651 #: ../src/guestfs.pod:1935
40652 #, no-wrap
40653 msgid ""
40654 " void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n"
40655 "\n"
40656 msgstr ""
40657
40658 #. type: textblock
40659 #: ../src/guestfs.pod:1937
40660 msgid ""
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."
40664 msgstr ""
40665
40666 #. type: =head3
40667 #: ../src/guestfs.pod:1941
40668 msgid "guestfs_event_callback"
40669 msgstr ""
40670
40671 #. type: verbatim
40672 #: ../src/guestfs.pod:1943
40673 #, no-wrap
40674 msgid ""
40675 " typedef void (*guestfs_event_callback) (\n"
40676 "                  guestfs_h *g,\n"
40677 "                  void *opaque,\n"
40678 "                  uint64_t event,\n"
40679 "                  int event_handle,\n"
40680 "                  int flags,\n"
40681 "                  const char *buf, size_t buf_len,\n"
40682 "                  const uint64_t *array, size_t array_len);\n"
40683 "\n"
40684 msgstr ""
40685
40686 #. type: textblock
40687 #: ../src/guestfs.pod:1952
40688 msgid ""
40689 "This is the type of the event callback function that you have to provide."
40690 msgstr ""
40691
40692 #. type: textblock
40693 #: ../src/guestfs.pod:1955
40694 msgid ""
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."
40698 msgstr ""
40699
40700 #. type: textblock
40701 #: ../src/guestfs.pod:1959
40702 msgid ""
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 "
40706 "class."
40707 msgstr ""
40708
40709 #. type: textblock
40710 #: ../src/guestfs.pod:1964
40711 msgid ""
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."
40715 msgstr ""
40716
40717 #. type: textblock
40718 #: ../src/guestfs.pod:1968
40719 msgid ""
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."
40722 msgstr ""
40723
40724 #. type: =head3
40725 #: ../src/guestfs.pod:1971
40726 msgid "EXAMPLE: CAPTURING LOG MESSAGES"
40727 msgstr ""
40728
40729 #. type: textblock
40730 #: ../src/guestfs.pod:1973
40731 msgid ""
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>."
40735 msgstr ""
40736
40737 #. type: textblock
40738 #: ../src/guestfs.pod:1977
40739 msgid ""
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)."
40743 msgstr ""
40744
40745 #. type: textblock
40746 #: ../src/guestfs.pod:1982
40747 msgid ""
40748 "Programs have to set up a callback to capture the classes of events of "
40749 "interest:"
40750 msgstr ""
40751
40752 #. type: verbatim
40753 #: ../src/guestfs.pod:1985
40754 #, no-wrap
40755 msgid ""
40756 " int eh =\n"
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"
40764 " }\n"
40765 "\n"
40766 msgstr ""
40767
40768 #. type: textblock
40769 #: ../src/guestfs.pod:1995
40770 msgid ""
40771 "The callback can then direct messages to the appropriate place.  In this "
40772 "example, messages are directed to syslog:"
40773 msgstr ""
40774
40775 #. type: verbatim
40776 #: ../src/guestfs.pod:1998
40777 #, no-wrap
40778 msgid ""
40779 " static void\n"
40780 " message_callback (\n"
40781 "         guestfs_h *g,\n"
40782 "         void *opaque,\n"
40783 "         uint64_t event,\n"
40784 "         int event_handle,\n"
40785 "         int flags,\n"
40786 "         const char *buf, size_t buf_len,\n"
40787 "         const uint64_t *array, size_t array_len)\n"
40788 " {\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"
40792 " }\n"
40793 "\n"
40794 msgstr ""
40795
40796 #. type: =head1
40797 #: ../src/guestfs.pod:2013
40798 msgid "CANCELLING LONG TRANSFERS"
40799 msgstr ""
40800
40801 #. type: textblock
40802 #: ../src/guestfs.pod:2015
40803 msgid ""
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)."
40808 msgstr ""
40809
40810 #. type: =head2
40811 #: ../src/guestfs.pod:2020
40812 msgid "guestfs_user_cancel"
40813 msgstr ""
40814
40815 #. type: verbatim
40816 #: ../src/guestfs.pod:2022
40817 #, no-wrap
40818 msgid ""
40819 " void guestfs_user_cancel (guestfs_h *g);\n"
40820 "\n"
40821 msgstr ""
40822
40823 #. type: textblock
40824 #: ../src/guestfs.pod:2024
40825 msgid ""
40826 "C<guestfs_user_cancel> cancels the current upload or download operation."
40827 msgstr ""
40828
40829 #. type: textblock
40830 #: ../src/guestfs.pod:2027
40831 msgid ""
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."
40835 msgstr ""
40836
40837 #. type: textblock
40838 #: ../src/guestfs.pod:2031
40839 msgid ""
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."
40844 msgstr ""
40845
40846 #. type: textblock
40847 #: ../src/guestfs.pod:2037
40848 msgid ""
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."
40852 msgstr ""
40853
40854 #. type: textblock
40855 #: ../src/guestfs.pod:2041
40856 msgid "There are two common places that you might call C<guestfs_user_cancel>."
40857 msgstr ""
40858
40859 #. type: textblock
40860 #: ../src/guestfs.pod:2043
40861 msgid ""
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)."
40866 msgstr ""
40867
40868 #. type: textblock
40869 #: ../src/guestfs.pod:2048
40870 msgid ""
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."
40873 msgstr ""
40874
40875 #. type: =head1
40876 #: ../src/guestfs.pod:2052
40877 msgid "PRIVATE DATA AREA"
40878 msgstr ""
40879
40880 #. type: textblock
40881 #: ../src/guestfs.pod:2054
40882 msgid ""
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."
40886 msgstr ""
40887
40888 #. type: textblock
40889 #: ../src/guestfs.pod:2059
40890 msgid "To attach a named piece of data, use the following call:"
40891 msgstr ""
40892
40893 #. type: verbatim
40894 #: ../src/guestfs.pod:2061
40895 #, no-wrap
40896 msgid ""
40897 " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
40898 "\n"
40899 msgstr ""
40900 " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
40901 "\n"
40902
40903 #. type: textblock
40904 #: ../src/guestfs.pod:2063
40905 msgid ""
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 "
40908 "overwritten."
40909 msgstr ""
40910
40911 #. type: textblock
40912 #: ../src/guestfs.pod:2067
40913 msgid ""
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."
40919 msgstr ""
40920
40921 #. type: textblock
40922 #: ../src/guestfs.pod:2073
40923 msgid "To retrieve the pointer, use:"
40924 msgstr ""
40925
40926 #. type: verbatim
40927 #: ../src/guestfs.pod:2075
40928 #, no-wrap
40929 msgid ""
40930 " void *guestfs_get_private (guestfs_h *g, const char *key);\n"
40931 "\n"
40932 msgstr ""
40933 " void *guestfs_get_private (guestfs_h *g, const char *key);\n"
40934 "\n"
40935
40936 #. type: textblock
40937 #: ../src/guestfs.pod:2077
40938 msgid ""
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 "
40941 "C<NULL>."
40942 msgstr ""
40943
40944 #. type: textblock
40945 #: ../src/guestfs.pod:2081
40946 msgid ""
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>)."
40953 msgstr ""
40954
40955 #. type: textblock
40956 #: ../src/guestfs.pod:2088
40957 msgid "To walk over all entries, use these two functions:"
40958 msgstr ""
40959
40960 #. type: verbatim
40961 #: ../src/guestfs.pod:2090
40962 #, no-wrap
40963 msgid ""
40964 " void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n"
40965 "\n"
40966 msgstr ""
40967
40968 #. type: verbatim
40969 #: ../src/guestfs.pod:2092
40970 #, no-wrap
40971 msgid ""
40972 " void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n"
40973 "\n"
40974 msgstr ""
40975
40976 #. type: textblock
40977 #: ../src/guestfs.pod:2094
40978 msgid ""
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."
40984 msgstr ""
40985
40986 #. type: textblock
40987 #: ../src/guestfs.pod:2100
40988 msgid ""
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 "
40991 "return."
40992 msgstr ""
40993
40994 #. type: textblock
40995 #: ../src/guestfs.pod:2104
40996 msgid "Notes about walking over entries:"
40997 msgstr ""
40998
40999 #. type: textblock
41000 #: ../src/guestfs.pod:2110
41001 msgid ""
41002 "You must not call C<guestfs_set_private> while walking over the entries."
41003 msgstr ""
41004
41005 #. type: textblock
41006 #: ../src/guestfs.pod:2115
41007 msgid ""
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>."
41011 msgstr ""
41012
41013 #. type: textblock
41014 #: ../src/guestfs.pod:2121
41015 msgid "If you have set the data pointer associated with a key to C<NULL>, ie:"
41016 msgstr ""
41017
41018 #. type: verbatim
41019 #: ../src/guestfs.pod:2123
41020 #, no-wrap
41021 msgid ""
41022 " guestfs_set_private (g, key, NULL);\n"
41023 "\n"
41024 msgstr ""
41025
41026 #. type: textblock
41027 #: ../src/guestfs.pod:2125
41028 msgid "then that C<key> is not returned when walking."
41029 msgstr ""
41030
41031 #. type: textblock
41032 #: ../src/guestfs.pod:2129
41033 msgid ""
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>."
41036 msgstr ""
41037
41038 #. type: textblock
41039 #: ../src/guestfs.pod:2135
41040 msgid ""
41041 "The following example code shows how to print all keys and data pointers "
41042 "that are associated with the handle C<g>:"
41043 msgstr ""
41044
41045 #. type: verbatim
41046 #: ../src/guestfs.pod:2138
41047 #, no-wrap
41048 msgid ""
41049 " const char *key;\n"
41050 " void *data = guestfs_first_private (g, &key);\n"
41051 " while (data != NULL)\n"
41052 "   {\n"
41053 "     printf (\"key = %s, data = %p\\n\", key, data);\n"
41054 "     data = guestfs_next_private (g, &key);\n"
41055 "   }\n"
41056 "\n"
41057 msgstr ""
41058
41059 #. type: textblock
41060 #: ../src/guestfs.pod:2146
41061 msgid ""
41062 "More commonly you are only interested in keys that begin with an application-"
41063 "specific prefix C<foo_>.  Modify the loop like so:"
41064 msgstr ""
41065
41066 #. type: verbatim
41067 #: ../src/guestfs.pod:2149
41068 #, no-wrap
41069 msgid ""
41070 " const char *key;\n"
41071 " void *data = guestfs_first_private (g, &key);\n"
41072 " while (data != NULL)\n"
41073 "   {\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"
41077 "   }\n"
41078 "\n"
41079 msgstr ""
41080
41081 #. type: textblock
41082 #: ../src/guestfs.pod:2158
41083 msgid ""
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 "
41086 "C<foo_>:"
41087 msgstr ""
41088
41089 #. type: verbatim
41090 #: ../src/guestfs.pod:2162
41091 #, no-wrap
41092 msgid ""
41093 "  const char *key;\n"
41094 "  void *data;\n"
41095 " again:\n"
41096 "  data = guestfs_first_private (g, &key);\n"
41097 "  while (data != NULL)\n"
41098 "    {\n"
41099 "      if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
41100 "        {\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"
41104 "          goto again;\n"
41105 "        }\n"
41106 "      data = guestfs_next_private (g, &key);\n"
41107 "    }\n"
41108 "\n"
41109 msgstr ""
41110
41111 #. type: textblock
41112 #: ../src/guestfs.pod:2178
41113 msgid ""
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 "
41117 "visited."
41118 msgstr ""
41119
41120 #. type: =head1
41121 #: ../src/guestfs.pod:2183
41122 msgid "SYSTEMTAP"
41123 msgstr ""
41124
41125 #. type: textblock
41126 #: ../src/guestfs.pod:2185
41127 msgid ""
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."
41131 msgstr ""
41132
41133 #. type: textblock
41134 #: ../src/guestfs.pod:2189
41135 msgid "You can list all the static markers by doing:"
41136 msgstr ""
41137
41138 #. type: verbatim
41139 #: ../src/guestfs.pod:2191
41140 #, no-wrap
41141 msgid ""
41142 " stap -l 'process(\"/usr/lib*/libguestfs.so.0\")\n"
41143 "              .provider(\"guestfs\").mark(\"*\")'\n"
41144 "\n"
41145 msgstr ""
41146
41147 #. type: textblock
41148 #: ../src/guestfs.pod:2194
41149 msgid ""
41150 "B<Note:> These static markers are I<not> part of the stable API and may "
41151 "change in future versions."
41152 msgstr ""
41153
41154 #. type: =head2
41155 #: ../src/guestfs.pod:2197
41156 msgid "SYSTEMTAP SCRIPT EXAMPLE"
41157 msgstr ""
41158
41159 #. type: textblock
41160 #: ../src/guestfs.pod:2199
41161 msgid ""
41162 "This script contains examples of displaying both the static markers and some "
41163 "ordinary C entry points:"
41164 msgstr ""
41165
41166 #. type: verbatim
41167 #: ../src/guestfs.pod:2202
41168 #, no-wrap
41169 msgid ""
41170 " global last;\n"
41171 " \n"
41172 msgstr ""
41173
41174 #. type: verbatim
41175 #: ../src/guestfs.pod:2204
41176 #, no-wrap
41177 msgid ""
41178 " function display_time () {\n"
41179 "       now = gettimeofday_us ();\n"
41180 "       delta = 0;\n"
41181 "       if (last > 0)\n"
41182 "             delta = now - last;\n"
41183 "       last = now;\n"
41184 " \n"
41185 msgstr ""
41186
41187 #. type: verbatim
41188 #: ../src/guestfs.pod:2211
41189 #, no-wrap
41190 msgid ""
41191 "       printf (\"%d (+%d):\", now, delta);\n"
41192 " }\n"
41193 " \n"
41194 msgstr ""
41195
41196 #. type: verbatim
41197 #: ../src/guestfs.pod:2214
41198 #, no-wrap
41199 msgid ""
41200 " probe begin {\n"
41201 "       last = 0;\n"
41202 "       printf (\"ready\\n\");\n"
41203 " }\n"
41204 " \n"
41205 msgstr ""
41206
41207 #. type: verbatim
41208 #: ../src/guestfs.pod:2219
41209 #, no-wrap
41210 msgid ""
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"
41216 " }\n"
41217 " \n"
41218 msgstr ""
41219
41220 #. type: verbatim
41221 #: ../src/guestfs.pod:2226
41222 #, no-wrap
41223 msgid ""
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"
41229 " }\n"
41230 "\n"
41231 msgstr ""
41232
41233 #. type: textblock
41234 #: ../src/guestfs.pod:2233
41235 msgid ""
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."
41240 msgstr ""
41241
41242 #. type: verbatim
41243 #: ../src/guestfs.pod:2238
41244 #, no-wrap
41245 msgid ""
41246 " # stap /tmp/test.stap\n"
41247 " ready\n"
41248 "\n"
41249 msgstr ""
41250
41251 #. type: textblock
41252 #: ../src/guestfs.pod:2241
41253 msgid "In another terminal, run a guestfish command such as this:"
41254 msgstr ""
41255
41256 #. type: textblock
41257 #: ../src/guestfs.pod:2245
41258 msgid "In the first terminal, stap trace output similar to this is shown:"
41259 msgstr ""
41260
41261 #. type: verbatim
41262 #: ../src/guestfs.pod:2247
41263 #, no-wrap
41264 msgid ""
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"
41271 "\n"
41272 msgstr ""
41273
41274 #. type: =end
41275 #: ../src/guestfs.pod:2254 ../src/guestfs.pod:2259
41276 msgid "html"
41277 msgstr "html"
41278
41279 #. type: textblock
41280 #: ../src/guestfs.pod:2256
41281 msgid ""
41282 "<!-- old anchor for the next section --> <a name="
41283 "\"state_machine_and_low_level_event_api\"/>"
41284 msgstr ""
41285 "<!-- old anchor for the next section --> <a name="
41286 "\"state_machine_and_low_level_event_api\"/>"
41287
41288 #. type: =head1
41289 #: ../src/guestfs.pod:2261
41290 msgid "ARCHITECTURE"
41291 msgstr "АРХІТЕКТУРА"
41292
41293 #. type: textblock
41294 #: ../src/guestfs.pod:2263
41295 msgid ""
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."
41299 msgstr ""
41300
41301 #. type: verbatim
41302 #: ../src/guestfs.pod:2267
41303 #, no-wrap
41304 msgid ""
41305 "  ___________________\n"
41306 " /                   \\\n"
41307 " | main program      |\n"
41308 " |                   |\n"
41309 " |                   |           child process / appliance\n"
41310 " |                   |           __________________________\n"
41311 " |                   |          / qemu                     \\\n"
41312 " +-------------------+   RPC    |      +-----------------+ |\n"
41313 " | libguestfs     <--------------------> guestfsd        | |\n"
41314 " |                   |          |      +-----------------+ |\n"
41315 " \\___________________/          |      | Linux kernel    | |\n"
41316 "                                |      +--^--------------+ |\n"
41317 "                                \\_________|________________/\n"
41318 "                                          |\n"
41319 "                                   _______v______\n"
41320 "                                  /              \\\n"
41321 "                                  | Device or    |\n"
41322 "                                  | disk image   |\n"
41323 "                                  \\______________/\n"
41324 "\n"
41325 msgstr ""
41326
41327 #. type: textblock
41328 #: ../src/guestfs.pod:2287
41329 msgid ""
41330 "The library, linked to the main program, creates the child process and hence "
41331 "the appliance in the L</guestfs_launch> function."
41332 msgstr ""
41333
41334 #. type: textblock
41335 #: ../src/guestfs.pod:2290
41336 msgid ""
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."
41344 msgstr ""
41345
41346 #. type: textblock
41347 #: ../src/guestfs.pod:2299
41348 msgid ""
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)."
41355 msgstr ""
41356
41357 #. type: =head1
41358 #: ../src/guestfs.pod:2306
41359 msgid "STATE MACHINE"
41360 msgstr "СКІНЧЕННИЙ АВТОМАТ"
41361
41362 #. type: textblock
41363 #: ../src/guestfs.pod:2308
41364 msgid "libguestfs uses a state machine to model the child process:"
41365 msgstr ""
41366
41367 #. type: verbatim
41368 #: ../src/guestfs.pod:2310
41369 #, no-wrap
41370 msgid ""
41371 "                         |\n"
41372 "                    guestfs_create\n"
41373 "                         |\n"
41374 "                         |\n"
41375 "                     ____V_____\n"
41376 "                    /          \\\n"
41377 "                    |  CONFIG  |\n"
41378 "                    \\__________/\n"
41379 "                     ^ ^   ^  \\\n"
41380 "                    /  |    \\  \\ guestfs_launch\n"
41381 "                   /   |    _\\__V______\n"
41382 "                  /    |   /           \\\n"
41383 "                 /     |   | LAUNCHING |\n"
41384 "                /      |   \\___________/\n"
41385 "               /       |       /\n"
41386 "              /        |  guestfs_launch\n"
41387 "             /         |     /\n"
41388 "    ______  /        __|____V\n"
41389 "   /      \\ ------> /        \\\n"
41390 "   | BUSY |         | READY  |\n"
41391 "   \\______/ <------ \\________/\n"
41392 "\n"
41393 msgstr ""
41394
41395 #. type: textblock
41396 #: ../src/guestfs.pod:2332
41397 msgid ""
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."
41402 msgstr ""
41403
41404 #. type: textblock
41405 #: ../src/guestfs.pod:2337
41406 msgid ""
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."
41410 msgstr ""
41411
41412 #. type: textblock
41413 #: ../src/guestfs.pod:2341
41414 msgid ""
41415 "Configuration commands for qemu such as L</guestfs_add_drive> can only be "
41416 "issued when in the CONFIG state."
41417 msgstr ""
41418
41419 #. type: textblock
41420 #: ../src/guestfs.pod:2344
41421 msgid ""
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."
41426 msgstr ""
41427
41428 #. type: textblock
41429 #: ../src/guestfs.pod:2350
41430 msgid ""
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 "
41435 "the same time."
41436 msgstr ""
41437
41438 #. type: textblock
41439 #: ../src/guestfs.pod:2356
41440 msgid ""
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."
41444 msgstr ""
41445
41446 #. type: =head1
41447 #: ../src/guestfs.pod:2360
41448 msgid "INTERNALS"
41449 msgstr ""
41450
41451 #. type: =head2
41452 #: ../src/guestfs.pod:2362
41453 msgid "APPLIANCE BOOT PROCESS"
41454 msgstr ""
41455
41456 #. type: textblock
41457 #: ../src/guestfs.pod:2364
41458 msgid ""
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."
41462 msgstr ""
41463
41464 #. type: textblock
41465 #: ../src/guestfs.pod:2368
41466 msgid ""
41467 "In order to follow the stages involved below, enable libguestfs debugging "
41468 "(set the environment variable C<LIBGUESTFS_DEBUG=1>)."
41469 msgstr ""
41470
41471 #. type: =item
41472 #: ../src/guestfs.pod:2373
41473 msgid "Create the appliance"
41474 msgstr ""
41475
41476 #. type: textblock
41477 #: ../src/guestfs.pod:2375
41478 msgid ""
41479 "C<febootstrap-supermin-helper> is invoked to create the kernel, a small "
41480 "initrd and the appliance."
41481 msgstr ""
41482
41483 #. type: textblock
41484 #: ../src/guestfs.pod:2378
41485 msgid ""
41486 "The appliance is cached in C</var/tmp/.guestfs-E<lt>UIDE<gt>> (or in another "
41487 "directory if C<TMPDIR> is set)."
41488 msgstr ""
41489
41490 #. type: textblock
41491 #: ../src/guestfs.pod:2381
41492 msgid ""
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."
41495 msgstr ""
41496
41497 #. type: =item
41498 #: ../src/guestfs.pod:2385
41499 msgid "Start qemu and boot the kernel"
41500 msgstr ""
41501
41502 #. type: textblock
41503 #: ../src/guestfs.pod:2387
41504 msgid "qemu is invoked to boot the kernel."
41505 msgstr ""
41506
41507 #. type: =item
41508 #: ../src/guestfs.pod:2389
41509 msgid "Run the initrd"
41510 msgstr ""
41511
41512 #. type: textblock
41513 #: ../src/guestfs.pod:2391
41514 msgid ""
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."
41518 msgstr ""
41519
41520 #. type: textblock
41521 #: ../src/guestfs.pod:2395
41522 msgid ""
41523 "The initrd is a cpio archive called C</var/tmp/.guestfs-E<lt>UIDE<gt>/"
41524 "initrd>."
41525 msgstr ""
41526
41527 #. type: textblock
41528 #: ../src/guestfs.pod:2398
41529 msgid ""
41530 "When the initrd has started you will see messages showing that kernel "
41531 "modules are being loaded, similar to this:"
41532 msgstr ""
41533
41534 #. type: verbatim
41535 #: ../src/guestfs.pod:2401
41536 #, no-wrap
41537 msgid ""
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"
41542 "\n"
41543 msgstr ""
41544
41545 #. type: =item
41546 #: ../src/guestfs.pod:2406
41547 msgid "Find and mount the appliance device"
41548 msgstr ""
41549
41550 #. type: textblock
41551 #: ../src/guestfs.pod:2408
41552 msgid ""
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>."
41556 msgstr ""
41557
41558 #. type: textblock
41559 #: ../src/guestfs.pod:2412
41560 msgid ""
41561 "The regular disks being inspected by libguestfs are the first devices "
41562 "exposed by qemu (eg. as C</dev/vda>)."
41563 msgstr ""
41564
41565 #. type: textblock
41566 #: ../src/guestfs.pod:2415
41567 msgid ""
41568 "The last disk added to qemu is the appliance itself (eg. C</dev/vdb> if "
41569 "there was only one regular disk)."
41570 msgstr ""
41571
41572 #. type: textblock
41573 #: ../src/guestfs.pod:2418
41574 msgid ""
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."
41577 msgstr ""
41578
41579 #. type: textblock
41580 #: ../src/guestfs.pod:2422
41581 msgid "If this works successfully you will see messages such as:"
41582 msgstr ""
41583
41584 #. type: verbatim
41585 #: ../src/guestfs.pod:2424
41586 #, no-wrap
41587 msgid ""
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"
41593 "\n"
41594 msgstr ""
41595
41596 #. type: textblock
41597 #: ../src/guestfs.pod:2430
41598 msgid ""
41599 "Note that C<Starting /init script ...> indicates that the appliance's init "
41600 "script is now running."
41601 msgstr ""
41602
41603 #. type: =item
41604 #: ../src/guestfs.pod:2433
41605 msgid "Initialize the appliance"
41606 msgstr ""
41607
41608 #. type: textblock
41609 #: ../src/guestfs.pod:2435
41610 msgid ""
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>)."
41614 msgstr ""
41615
41616 #. type: =item
41617 #: ../src/guestfs.pod:2439
41618 msgid "The daemon"
41619 msgstr ""
41620
41621 #. type: textblock
41622 #: ../src/guestfs.pod:2441
41623 msgid ""
41624 "Finally the daemon (C<guestfsd>) runs inside the appliance.  If it runs you "
41625 "should see:"
41626 msgstr ""
41627
41628 #. type: verbatim
41629 #: ../src/guestfs.pod:2444
41630 #, no-wrap
41631 msgid ""
41632 " verbose daemon enabled\n"
41633 "\n"
41634 msgstr ""
41635
41636 #. type: textblock
41637 #: ../src/guestfs.pod:2446
41638 msgid ""
41639 "The daemon expects to see a named virtio-serial port exposed by qemu and "
41640 "connected on the other end to the library."
41641 msgstr ""
41642
41643 #. type: textblock
41644 #: ../src/guestfs.pod:2449
41645 msgid ""
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)."
41649 msgstr ""
41650
41651 #. type: =head2
41652 #: ../src/guestfs.pod:2455
41653 msgid "COMMUNICATION PROTOCOL"
41654 msgstr ""
41655
41656 #. type: textblock
41657 #: ../src/guestfs.pod:2457
41658 msgid ""
41659 "Don't rely on using this protocol directly.  This section documents how it "
41660 "currently works, but it may change at any time."
41661 msgstr ""
41662
41663 #. type: textblock
41664 #: ../src/guestfs.pod:2460
41665 msgid ""
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)."
41669 msgstr ""
41670
41671 #. type: textblock
41672 #: ../src/guestfs.pod:2464
41673 msgid ""
41674 "The detailed format of structures is in C<src/guestfs_protocol.x> (note: "
41675 "this file is automatically generated)."
41676 msgstr ""
41677
41678 #. type: textblock
41679 #: ../src/guestfs.pod:2467
41680 msgid ""
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."
41686 msgstr ""
41687
41688 #. type: =head3
41689 #: ../src/guestfs.pod:2474
41690 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)"
41691 msgstr ""
41692
41693 #. type: textblock
41694 #: ../src/guestfs.pod:2476
41695 msgid "For ordinary functions, the request message is:"
41696 msgstr ""
41697
41698 #. type: verbatim
41699 #: ../src/guestfs.pod:2478
41700 #, no-wrap
41701 msgid ""
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"
41706 "\n"
41707 msgstr ""
41708
41709 #. type: textblock
41710 #: ../src/guestfs.pod:2483
41711 msgid ""
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."
41716 msgstr ""
41717
41718 #. type: textblock
41719 #: ../src/guestfs.pod:2489
41720 msgid ""
41721 "Note also that many functions don't take any arguments, in which case the "
41722 "C<guestfs_I<foo>_args> is completely omitted."
41723 msgstr ""
41724
41725 #. type: textblock
41726 #: ../src/guestfs.pod:2492
41727 msgid ""
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."
41730 msgstr ""
41731
41732 #. type: textblock
41733 #: ../src/guestfs.pod:2496
41734 msgid ""
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 "
41741 "rejected."
41742 msgstr ""
41743
41744 #. type: textblock
41745 #: ../src/guestfs.pod:2504
41746 msgid "The reply message for ordinary functions is:"
41747 msgstr ""
41748
41749 #. type: verbatim
41750 #: ../src/guestfs.pod:2506
41751 #, no-wrap
41752 msgid ""
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"
41757 "\n"
41758 msgstr ""
41759
41760 #. type: textblock
41761 #: ../src/guestfs.pod:2511
41762 msgid ""
41763 "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for "
41764 "functions that return no formal return values."
41765 msgstr ""
41766
41767 #. type: textblock
41768 #: ../src/guestfs.pod:2514
41769 msgid ""
41770 "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>."
41771 msgstr ""
41772
41773 #. type: textblock
41774 #: ../src/guestfs.pod:2517
41775 msgid ""
41776 "In the case of an error, a flag is set in the header, and the reply message "
41777 "is slightly changed:"
41778 msgstr ""
41779
41780 #. type: verbatim
41781 #: ../src/guestfs.pod:2520
41782 #, no-wrap
41783 msgid ""
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"
41788 "\n"
41789 msgstr ""
41790
41791 #. type: textblock
41792 #: ../src/guestfs.pod:2525
41793 msgid ""
41794 "The C<guestfs_message_error> structure contains the error message as a "
41795 "string."
41796 msgstr ""
41797
41798 #. type: =head3
41799 #: ../src/guestfs.pod:2528
41800 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS"
41801 msgstr ""
41802
41803 #. type: textblock
41804 #: ../src/guestfs.pod:2530
41805 msgid ""
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."
41809 msgstr ""
41810
41811 #. type: verbatim
41812 #: ../src/guestfs.pod:2534
41813 #, no-wrap
41814 msgid ""
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"
41822 "\n"
41823 msgstr ""
41824
41825 #. type: textblock
41826 #: ../src/guestfs.pod:2542
41827 msgid "The \"sequence of chunks\" is:"
41828 msgstr ""
41829
41830 #. type: verbatim
41831 #: ../src/guestfs.pod:2544
41832 #, no-wrap
41833 msgid ""
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"
41838 "   ...\n"
41839 " length of chunk\n"
41840 " struct guestfs_chunk (with data.data_len == 0)\n"
41841 "\n"
41842 msgstr ""
41843
41844 #. type: textblock
41845 #: ../src/guestfs.pod:2552
41846 msgid ""
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 "
41849 "cancellation."
41850 msgstr ""
41851
41852 #. type: textblock
41853 #: ../src/guestfs.pod:2556
41854 msgid ""
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 "
41858 "right)."
41859 msgstr ""
41860
41861 #. type: textblock
41862 #: ../src/guestfs.pod:2561
41863 msgid ""
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."
41868 msgstr ""
41869
41870 #. type: textblock
41871 #: ../src/guestfs.pod:2567
41872 msgid ""
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."
41880 msgstr ""
41881
41882 #. type: textblock
41883 #: ../src/guestfs.pod:2576
41884 msgid ""
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."
41890 msgstr ""
41891
41892 #. type: =head3
41893 #: ../src/guestfs.pod:2582
41894 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS"
41895 msgstr ""
41896
41897 #. type: textblock
41898 #: ../src/guestfs.pod:2584
41899 msgid ""
41900 "The protocol for FileOut parameters is exactly the same as for FileIn "
41901 "parameters, but with the roles of daemon and library reversed."
41902 msgstr ""
41903
41904 #. type: verbatim
41905 #: ../src/guestfs.pod:2587
41906 #, no-wrap
41907 msgid ""
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"
41915 "\n"
41916 msgstr ""
41917
41918 #. type: =head3
41919 #: ../src/guestfs.pod:2595
41920 msgid "INITIAL MESSAGE"
41921 msgstr ""
41922
41923 #. type: textblock
41924 #: ../src/guestfs.pod:2597
41925 msgid ""
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."
41929 msgstr ""
41930
41931 #. type: =head3
41932 #: ../src/guestfs.pod:2601
41933 msgid "PROGRESS NOTIFICATION MESSAGES"
41934 msgstr ""
41935
41936 #. type: textblock
41937 #: ../src/guestfs.pod:2603
41938 msgid ""
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."
41942 msgstr ""
41943
41944 #. type: textblock
41945 #: ../src/guestfs.pod:2607
41946 msgid ""
41947 "The library turns them into progress callbacks (see L</"
41948 "GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards them "
41949 "if not."
41950 msgstr ""
41951
41952 #. type: textblock
41953 #: ../src/guestfs.pod:2611
41954 msgid ""
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 "
41957 "messages."
41958 msgstr ""
41959
41960 #. type: =head1
41961 #: ../src/guestfs.pod:2615
41962 msgid "LIBGUESTFS VERSION NUMBERS"
41963 msgstr ""
41964
41965 #. type: textblock
41966 #: ../src/guestfs.pod:2617
41967 msgid ""
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:"
41971 msgstr ""
41972
41973 #. type: verbatim
41974 #: ../src/guestfs.pod:2622
41975 #, no-wrap
41976 msgid ""
41977 "                 even numbers for stable: 1.2.x, 1.4.x, ...\n"
41978 "       .-------- odd numbers for development: 1.3.x, 1.5.x, ...\n"
41979 "       |\n"
41980 "       v\n"
41981 " 1  .  3  .  5\n"
41982 " ^           ^\n"
41983 " |           |\n"
41984 " |           `-------- sub-version\n"
41985 " |\n"
41986 " `------ always '1' because we don't change the ABI\n"
41987 "\n"
41988 msgstr ""
41989
41990 #. type: textblock
41991 #: ../src/guestfs.pod:2633
41992 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"."
41993 msgstr ""
41994
41995 #. type: textblock
41996 #: ../src/guestfs.pod:2635
41997 msgid ""
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 "
42002 "work."
42003 msgstr ""
42004
42005 #. type: textblock
42006 #: ../src/guestfs.pod:2641
42007 msgid "Our criteria for backporting changes are:"
42008 msgstr ""
42009
42010 #. type: textblock
42011 #: ../src/guestfs.pod:2647
42012 msgid ""
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."
42015 msgstr ""
42016
42017 #. type: textblock
42018 #: ../src/guestfs.pod:2653
42019 msgid ""
42020 "Bug fixes which are not controversial, fix obvious problems, and have been "
42021 "well tested are backported."
42022 msgstr ""
42023
42024 #. type: textblock
42025 #: ../src/guestfs.pod:2658
42026 msgid ""
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."
42030 msgstr ""
42031
42032 #. type: textblock
42033 #: ../src/guestfs.pod:2664
42034 msgid ""
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."
42038 msgstr ""
42039
42040 #. type: textblock
42041 #: ../src/guestfs.pod:2670
42042 msgid ""
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."
42049 msgstr ""
42050
42051 #. type: =head1
42052 #: ../src/guestfs.pod:2678
42053 msgid "EXTENDING LIBGUESTFS"
42054 msgstr ""
42055
42056 #. type: =head2
42057 #: ../src/guestfs.pod:2680
42058 msgid "ADDING A NEW API ACTION"
42059 msgstr ""
42060
42061 #. type: textblock
42062 #: ../src/guestfs.pod:2682
42063 msgid ""
42064 "Large amounts of boilerplate code in libguestfs (RPC, bindings, "
42065 "documentation) are generated, and this makes it easy to extend the "
42066 "libguestfs API."
42067 msgstr ""
42068
42069 #. type: textblock
42070 #: ../src/guestfs.pod:2686
42071 msgid "To add a new API action there are two changes:"
42072 msgstr ""
42073
42074 #. type: textblock
42075 #: ../src/guestfs.pod:2692
42076 msgid ""
42077 "You need to add a description of the call (name, parameters, return type, "
42078 "tests, documentation) to C<generator/generator_actions.ml>."
42079 msgstr ""
42080
42081 #. type: textblock
42082 #: ../src/guestfs.pod:2695
42083 msgid ""
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."
42090 msgstr ""
42091
42092 #. type: textblock
42093 #: ../src/guestfs.pod:2703
42094 msgid ""
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 "
42099 "increment it."
42100 msgstr ""
42101
42102 #. type: textblock
42103 #: ../src/guestfs.pod:2709
42104 msgid ""
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 "
42109 "to C<-1>."
42110 msgstr ""
42111
42112 #. type: textblock
42113 #: ../src/guestfs.pod:2717
42114 msgid "Implement the action (in C):"
42115 msgstr ""
42116
42117 #. type: textblock
42118 #: ../src/guestfs.pod:2719
42119 msgid ""
42120 "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the "
42121 "C<daemon/> directory."
42122 msgstr ""
42123
42124 #. type: textblock
42125 #: ../src/guestfs.pod:2722
42126 msgid ""
42127 "For library actions, implement the function C<guestfs__E<lt>nameE<gt>> "
42128 "(note: double underscore) in the C<src/> directory."
42129 msgstr ""
42130
42131 #. type: textblock
42132 #: ../src/guestfs.pod:2725
42133 msgid "In either case, use another function as an example of what to do."
42134 msgstr ""
42135
42136 #. type: textblock
42137 #: ../src/guestfs.pod:2729
42138 msgid "After making these changes, use C<make> to compile."
42139 msgstr ""
42140
42141 #. type: textblock
42142 #: ../src/guestfs.pod:2731
42143 msgid ""
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 "
42146 "description."
42147 msgstr ""
42148
42149 #. type: =head2
42150 #: ../src/guestfs.pod:2735
42151 msgid "ADDING TESTS FOR AN API ACTION"
42152 msgstr ""
42153
42154 #. type: textblock
42155 #: ../src/guestfs.pod:2737
42156 msgid ""
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."
42162 msgstr ""
42163
42164 #. type: textblock
42165 #: ../src/guestfs.pod:2743
42166 msgid ""
42167 "The following describes the test environment used when you add an API test "
42168 "in C<generator_actions.ml>."
42169 msgstr ""
42170
42171 #. type: textblock
42172 #: ../src/guestfs.pod:2746
42173 msgid "The test environment has 4 block devices:"
42174 msgstr ""
42175
42176 #. type: =item
42177 #: ../src/guestfs.pod:2750
42178 msgid "C</dev/sda> 500MB"
42179 msgstr "C</dev/sda> 500 МБ"
42180
42181 #. type: textblock
42182 #: ../src/guestfs.pod:2752
42183 msgid "General block device for testing."
42184 msgstr ""
42185
42186 #. type: =item
42187 #: ../src/guestfs.pod:2754
42188 msgid "C</dev/sdb> 50MB"
42189 msgstr "C</dev/sdb> 50 МБ"
42190
42191 #. type: textblock
42192 #: ../src/guestfs.pod:2756
42193 msgid ""
42194 "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write "
42195 "operations."
42196 msgstr ""
42197
42198 #. type: =item
42199 #: ../src/guestfs.pod:2759
42200 msgid "C</dev/sdc> 10MB"
42201 msgstr "C</dev/sdc> 10 МБ"
42202
42203 #. type: textblock
42204 #: ../src/guestfs.pod:2761
42205 msgid "Used in a few tests where two block devices are needed."
42206 msgstr ""
42207
42208 #. type: =item
42209 #: ../src/guestfs.pod:2763
42210 msgid "C</dev/sdd>"
42211 msgstr "C</dev/sdd>"
42212
42213 #. type: textblock
42214 #: ../src/guestfs.pod:2765
42215 msgid "ISO with fixed content (see C<images/test.iso>)."
42216 msgstr ""
42217
42218 #. type: textblock
42219 #: ../src/guestfs.pod:2769
42220 msgid ""
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"
42224 msgstr ""
42225
42226 #. type: textblock
42227 #: ../src/guestfs.pod:2773
42228 msgid ""
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."
42234 msgstr ""
42235
42236 #. type: textblock
42237 #: ../src/guestfs.pod:2779
42238 msgid ""
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 "
42243 "unconditionally."
42244 msgstr ""
42245
42246 #. type: textblock
42247 #: ../src/guestfs.pod:2785
42248 msgid ""
42249 "In addition, packagers can skip individual tests by setting environment "
42250 "variables before running C<make check>."
42251 msgstr ""
42252
42253 #. type: verbatim
42254 #: ../src/guestfs.pod:2788
42255 #, no-wrap
42256 msgid ""
42257 " SKIP_TEST_<CMD>_<NUM>=1\n"
42258 "\n"
42259 msgstr ""
42260
42261 #. type: textblock
42262 #: ../src/guestfs.pod:2790
42263 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>."
42264 msgstr ""
42265
42266 #. type: verbatim
42267 #: ../src/guestfs.pod:2794
42268 #, no-wrap
42269 msgid ""
42270 " SKIP_TEST_<CMD>=1\n"
42271 "\n"
42272 msgstr ""
42273
42274 #. type: textblock
42275 #: ../src/guestfs.pod:2796
42276 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests."
42277 msgstr ""
42278
42279 #. type: textblock
42280 #: ../src/guestfs.pod:2798
42281 msgid "Packagers can run only certain tests by setting for example:"
42282 msgstr ""
42283
42284 #. type: verbatim
42285 #: ../src/guestfs.pod:2800
42286 #, no-wrap
42287 msgid ""
42288 " TEST_ONLY=\"vfs_type zerofree\"\n"
42289 "\n"
42290 msgstr ""
42291
42292 #. type: textblock
42293 #: ../src/guestfs.pod:2802
42294 msgid ""
42295 "See C<capitests/tests.c> for more details of how these environment variables "
42296 "work."
42297 msgstr ""
42298
42299 #. type: =head2
42300 #: ../src/guestfs.pod:2805
42301 msgid "DEBUGGING NEW API ACTIONS"
42302 msgstr ""
42303
42304 #. type: textblock
42305 #: ../src/guestfs.pod:2807
42306 msgid "Test new actions work before submitting them."
42307 msgstr ""
42308
42309 #. type: textblock
42310 #: ../src/guestfs.pod:2809
42311 msgid "You can use guestfish to try out new commands."
42312 msgstr ""
42313
42314 #. type: textblock
42315 #: ../src/guestfs.pod:2811
42316 msgid ""
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>."
42320 msgstr ""
42321
42322 #. type: =head2
42323 #: ../src/guestfs.pod:2815
42324 msgid "FORMATTING CODE AND OTHER CONVENTIONS"
42325 msgstr ""
42326
42327 #. type: textblock
42328 #: ../src/guestfs.pod:2817
42329 msgid ""
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."
42335 msgstr ""
42336
42337 #. type: textblock
42338 #: ../src/guestfs.pod:2823
42339 msgid ""
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:"
42342 msgstr ""
42343
42344 #. type: verbatim
42345 #: ../src/guestfs.pod:2826
42346 #, no-wrap
42347 msgid ""
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"
42357 " \n"
42358 msgstr ""
42359
42360 #. type: verbatim
42361 #: ../src/guestfs.pod:2836
42362 #, no-wrap
42363 msgid ""
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"
42367 "   (interactive)\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"
42375 "\n"
42376 msgstr ""
42377
42378 #. type: textblock
42379 #: ../src/guestfs.pod:2848
42380 msgid "Enable warnings when compiling (and fix any problems this finds):"
42381 msgstr ""
42382
42383 #. type: verbatim
42384 #: ../src/guestfs.pod:2851
42385 #, no-wrap
42386 msgid ""
42387 " ./configure --enable-gcc-warnings\n"
42388 "\n"
42389 msgstr ""
42390 " ./configure --enable-gcc-warnings\n"
42391 "\n"
42392
42393 #. type: textblock
42394 #: ../src/guestfs.pod:2853
42395 msgid "Useful targets are:"
42396 msgstr ""
42397
42398 #. type: verbatim
42399 #: ../src/guestfs.pod:2855
42400 #, no-wrap
42401 msgid ""
42402 " make syntax-check  # checks the syntax of the C code\n"
42403 " make check         # runs the test suite\n"
42404 "\n"
42405 msgstr ""
42406
42407 #. type: =head2
42408 #: ../src/guestfs.pod:2858
42409 msgid "DAEMON CUSTOM PRINTF FORMATTERS"
42410 msgstr ""
42411
42412 #. type: textblock
42413 #: ../src/guestfs.pod:2860
42414 msgid ""
42415 "In the daemon code we have created custom printf formatters C<%Q> and C<%R>, "
42416 "which are used to do shell quoting."
42417 msgstr ""
42418
42419 #. type: =item
42420 #: ../src/guestfs.pod:2865
42421 msgid "%Q"
42422 msgstr "%Q"
42423
42424 #. type: textblock
42425 #: ../src/guestfs.pod:2867
42426 msgid ""
42427 "Simple shell quoted string.  Any spaces or other shell characters are "
42428 "escaped for you."
42429 msgstr ""
42430
42431 #. type: =item
42432 #: ../src/guestfs.pod:2870
42433 msgid "%R"
42434 msgstr "%R"
42435
42436 #. type: textblock
42437 #: ../src/guestfs.pod:2872
42438 msgid ""
42439 "Same as C<%Q> except the string is treated as a path which is prefixed by "
42440 "the sysroot."
42441 msgstr ""
42442
42443 #. type: verbatim
42444 #: ../src/guestfs.pod:2879
42445 #, no-wrap
42446 msgid ""
42447 " asprintf (&cmd, \"cat %R\", path);\n"
42448 "\n"
42449 msgstr ""
42450 " asprintf (&cmd, \"cat %R\", path);\n"
42451 "\n"
42452
42453 #. type: textblock
42454 #: ../src/guestfs.pod:2881
42455 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>"
42456 msgstr ""
42457
42458 #. type: textblock
42459 #: ../src/guestfs.pod:2883
42460 msgid ""
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."
42465 msgstr ""
42466
42467 #. type: =head2
42468 #: ../src/guestfs.pod:2889
42469 msgid "SUBMITTING YOUR NEW API ACTIONS"
42470 msgstr ""
42471
42472 #. type: textblock
42473 #: ../src/guestfs.pod:2891
42474 msgid ""
42475 "Submit patches to the mailing list: L<http://www.redhat.com/mailman/listinfo/"
42476 "libguestfs> and CC to L<rjones@redhat.com>."
42477 msgstr ""
42478
42479 #. type: =head2
42480 #: ../src/guestfs.pod:2895
42481 msgid "INTERNATIONALIZATION (I18N) SUPPORT"
42482 msgstr ""
42483
42484 #. type: textblock
42485 #: ../src/guestfs.pod:2897
42486 msgid "We support i18n (gettext anyhow) in the library."
42487 msgstr ""
42488
42489 #. type: textblock
42490 #: ../src/guestfs.pod:2899
42491 msgid ""
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."
42496 msgstr ""
42497
42498 #. type: textblock
42499 #: ../src/guestfs.pod:2905
42500 msgid ""
42501 "Debugging messages are never translated, since they are intended for the "
42502 "programmers."
42503 msgstr ""
42504
42505 #. type: =head2
42506 #: ../src/guestfs.pod:2908
42507 msgid "SOURCE CODE SUBDIRECTORIES"
42508 msgstr ""
42509
42510 #. type: =item
42511 #: ../src/guestfs.pod:2912
42512 msgid "C<align>"
42513 msgstr ""
42514
42515 #. type: textblock
42516 #: ../src/guestfs.pod:2914
42517 msgid "L<virt-alignment-scan(1)> command and documentation."
42518 msgstr ""
42519
42520 #. type: textblock
42521 #: ../src/guestfs.pod:2918
42522 msgid "The libguestfs appliance, build scripts and so on."
42523 msgstr ""
42524
42525 #. type: =item
42526 #: ../src/guestfs.pod:2920
42527 msgid "C<capitests>"
42528 msgstr "C<capitests>"
42529
42530 #. type: textblock
42531 #: ../src/guestfs.pod:2922
42532 msgid "Automated tests of the C API."
42533 msgstr ""
42534
42535 #. type: =item
42536 #: ../src/guestfs.pod:2924
42537 msgid "C<cat>"
42538 msgstr "C<cat>"
42539
42540 #. type: textblock
42541 #: ../src/guestfs.pod:2926
42542 msgid ""
42543 "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and "
42544 "documentation."
42545 msgstr ""
42546
42547 #. type: =item
42548 #: ../src/guestfs.pod:2929
42549 msgid "C<caution>"
42550 msgstr "C<caution>"
42551
42552 #. type: textblock
42553 #: ../src/guestfs.pod:2931
42554 msgid ""
42555 "Safety and liveness tests of components that libguestfs depends upon (not of "
42556 "libguestfs itself).  Mainly this is for qemu and the kernel."
42557 msgstr ""
42558
42559 #. type: =item
42560 #: ../src/guestfs.pod:2934
42561 msgid "C<clone>"
42562 msgstr ""
42563
42564 #. type: textblock
42565 #: ../src/guestfs.pod:2936
42566 msgid ""
42567 "Tools for cloning virtual machines.  Currently contains L<virt-sysprep(1)> "
42568 "command and documentation."
42569 msgstr ""
42570
42571 #. type: =item
42572 #: ../src/guestfs.pod:2939
42573 msgid "C<contrib>"
42574 msgstr "C<contrib>"
42575
42576 #. type: textblock
42577 #: ../src/guestfs.pod:2941
42578 msgid "Outside contributions, experimental parts."
42579 msgstr ""
42580
42581 #. type: =item
42582 #: ../src/guestfs.pod:2943
42583 msgid "C<daemon>"
42584 msgstr "C<daemon>"
42585
42586 #. type: textblock
42587 #: ../src/guestfs.pod:2945
42588 msgid ""
42589 "The daemon that runs inside the libguestfs appliance and carries out actions."
42590 msgstr ""
42591
42592 #. type: =item
42593 #: ../src/guestfs.pod:2948
42594 msgid "C<df>"
42595 msgstr "C<df>"
42596
42597 #. type: textblock
42598 #: ../src/guestfs.pod:2950
42599 msgid "L<virt-df(1)> command and documentation."
42600 msgstr ""
42601
42602 #. type: =item
42603 #: ../src/guestfs.pod:2952
42604 msgid "C<edit>"
42605 msgstr "C<edit>"
42606
42607 #. type: textblock
42608 #: ../src/guestfs.pod:2954
42609 msgid "L<virt-edit(1)> command and documentation."
42610 msgstr ""
42611
42612 #. type: =item
42613 #: ../src/guestfs.pod:2956
42614 msgid "C<examples>"
42615 msgstr "C<examples>"
42616
42617 #. type: textblock
42618 #: ../src/guestfs.pod:2958
42619 msgid "C API example code."
42620 msgstr "Код прикладів використання програмного інтерфейсу мовою C."
42621
42622 #. type: =item
42623 #: ../src/guestfs.pod:2960
42624 msgid "C<fish>"
42625 msgstr "C<fish>"
42626
42627 #. type: textblock
42628 #: ../src/guestfs.pod:2962
42629 msgid ""
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)>."
42633 msgstr ""
42634
42635 #. type: =item
42636 #: ../src/guestfs.pod:2966
42637 msgid "C<fuse>"
42638 msgstr "C<fuse>"
42639
42640 #. type: textblock
42641 #: ../src/guestfs.pod:2968
42642 msgid ""
42643 "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs."
42644 msgstr ""
42645
42646 #. type: =item
42647 #: ../src/guestfs.pod:2970
42648 msgid "C<generator>"
42649 msgstr "C<generator>"
42650
42651 #. type: textblock
42652 #: ../src/guestfs.pod:2972
42653 msgid ""
42654 "The crucially important generator, used to automatically generate large "
42655 "amounts of boilerplate C code for things like RPC and bindings."
42656 msgstr ""
42657
42658 #. type: =item
42659 #: ../src/guestfs.pod:2975
42660 msgid "C<images>"
42661 msgstr "C<images>"
42662
42663 #. type: textblock
42664 #: ../src/guestfs.pod:2977
42665 msgid "Files used by the test suite."
42666 msgstr ""
42667
42668 #. type: textblock
42669 #: ../src/guestfs.pod:2979
42670 msgid "Some \"phony\" guest images which we test against."
42671 msgstr ""
42672
42673 #. type: =item
42674 #: ../src/guestfs.pod:2981
42675 msgid "C<inspector>"
42676 msgstr "C<inspector>"
42677
42678 #. type: textblock
42679 #: ../src/guestfs.pod:2983
42680 msgid "L<virt-inspector(1)>, the virtual machine image inspector."
42681 msgstr ""
42682
42683 #. type: =item
42684 #: ../src/guestfs.pod:2985
42685 msgid "C<logo>"
42686 msgstr "C<logo>"
42687
42688 #. type: textblock
42689 #: ../src/guestfs.pod:2987
42690 msgid "Logo used on the website.  The fish is called Arthur by the way."
42691 msgstr ""
42692
42693 #. type: =item
42694 #: ../src/guestfs.pod:2989
42695 msgid "C<m4>"
42696 msgstr "C<m4>"
42697
42698 #. type: textblock
42699 #: ../src/guestfs.pod:2991
42700 msgid "M4 macros used by autoconf."
42701 msgstr ""
42702
42703 #. type: =item
42704 #: ../src/guestfs.pod:2993
42705 msgid "C<po>"
42706 msgstr "C<po>"
42707
42708 #. type: textblock
42709 #: ../src/guestfs.pod:2995
42710 msgid "Translations of simple gettext strings."
42711 msgstr "Переклади простих рядків gettext."
42712
42713 #. type: =item
42714 #: ../src/guestfs.pod:2997
42715 msgid "C<po-docs>"
42716 msgstr "C<po-docs>"
42717
42718 #. type: textblock
42719 #: ../src/guestfs.pod:2999
42720 msgid ""
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."
42724 msgstr ""
42725
42726 #. type: =item
42727 #: ../src/guestfs.pod:3003
42728 msgid "C<regressions>"
42729 msgstr "C<regressions>"
42730
42731 #. type: textblock
42732 #: ../src/guestfs.pod:3005
42733 msgid "Regression tests."
42734 msgstr "Тести на регресії."
42735
42736 #. type: =item
42737 #: ../src/guestfs.pod:3007
42738 msgid "C<rescue>"
42739 msgstr "C<rescue>"
42740
42741 #. type: textblock
42742 #: ../src/guestfs.pod:3009
42743 msgid "L<virt-rescue(1)> command and documentation."
42744 msgstr ""
42745
42746 #. type: =item
42747 #: ../src/guestfs.pod:3011
42748 msgid "C<resize>"
42749 msgstr ""
42750
42751 #. type: textblock
42752 #: ../src/guestfs.pod:3013
42753 msgid "L<virt-resize(1)> command and documentation."
42754 msgstr ""
42755
42756 #. type: =item
42757 #: ../src/guestfs.pod:3015
42758 msgid "C<sparsify>"
42759 msgstr ""
42760
42761 #. type: textblock
42762 #: ../src/guestfs.pod:3017
42763 msgid "L<virt-sparsify(1)> command and documentation."
42764 msgstr ""
42765
42766 #. type: =item
42767 #: ../src/guestfs.pod:3019
42768 msgid "C<src>"
42769 msgstr "C<src>"
42770
42771 #. type: textblock
42772 #: ../src/guestfs.pod:3021
42773 msgid "Source code to the C library."
42774 msgstr ""
42775
42776 #. type: =item
42777 #: ../src/guestfs.pod:3023
42778 msgid "C<tools>"
42779 msgstr "C<tools>"
42780
42781 #. type: textblock
42782 #: ../src/guestfs.pod:3025
42783 msgid ""
42784 "Command line tools written in Perl (L<virt-win-reg(1)> and many others)."
42785 msgstr ""
42786
42787 #. type: =item
42788 #: ../src/guestfs.pod:3027
42789 msgid "C<test-tool>"
42790 msgstr "C<test-tool>"
42791
42792 #. type: textblock
42793 #: ../src/guestfs.pod:3029
42794 msgid ""
42795 "Test tool for end users to test if their qemu/kernel combination will work "
42796 "with libguestfs."
42797 msgstr ""
42798
42799 #. type: =item
42800 #: ../src/guestfs.pod:3032
42801 msgid "C<csharp>"
42802 msgstr "C<csharp>"
42803
42804 #. type: =item
42805 #: ../src/guestfs.pod:3034
42806 msgid "C<erlang>"
42807 msgstr ""
42808
42809 #. type: =item
42810 #: ../src/guestfs.pod:3036
42811 msgid "C<haskell>"
42812 msgstr "C<haskell>"
42813
42814 #. type: =item
42815 #: ../src/guestfs.pod:3038
42816 msgid "C<java>"
42817 msgstr "C<java>"
42818
42819 #. type: =item
42820 #: ../src/guestfs.pod:3040
42821 msgid "C<ocaml>"
42822 msgstr "C<ocaml>"
42823
42824 #. type: =item
42825 #: ../src/guestfs.pod:3042
42826 msgid "C<php>"
42827 msgstr "C<php>"
42828
42829 #. type: =item
42830 #: ../src/guestfs.pod:3044
42831 msgid "C<perl>"
42832 msgstr "C<perl>"
42833
42834 #. type: =item
42835 #: ../src/guestfs.pod:3046
42836 msgid "C<python>"
42837 msgstr "C<python>"
42838
42839 #. type: =item
42840 #: ../src/guestfs.pod:3048
42841 msgid "C<ruby>"
42842 msgstr "C<ruby>"
42843
42844 #. type: textblock
42845 #: ../src/guestfs.pod:3050
42846 msgid "Language bindings."
42847 msgstr "Прив’язки до мов програмування."
42848
42849 #. type: =head2
42850 #: ../src/guestfs.pod:3054
42851 msgid "MAKING A STABLE RELEASE"
42852 msgstr ""
42853
42854 #. type: textblock
42855 #: ../src/guestfs.pod:3056
42856 msgid ""
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 "
42859 "branch policy."
42860 msgstr ""
42861
42862 #. type: textblock
42863 #: ../src/guestfs.pod:3064
42864 msgid ""
42865 "Check C<make && make check> works on at least Fedora, Debian and Ubuntu."
42866 msgstr ""
42867
42868 #. type: textblock
42869 #: ../src/guestfs.pod:3069
42870 msgid "Finalize RELEASE-NOTES."
42871 msgstr ""
42872
42873 #. type: textblock
42874 #: ../src/guestfs.pod:3073
42875 msgid "Update ROADMAP."
42876 msgstr ""
42877
42878 #. type: textblock
42879 #: ../src/guestfs.pod:3077
42880 msgid "Run C<src/api-support/update-from-tarballs.sh>."
42881 msgstr ""
42882
42883 #. type: textblock
42884 #: ../src/guestfs.pod:3081
42885 msgid "Push and pull from Transifex."
42886 msgstr ""
42887
42888 #. type: verbatim
42889 #: ../src/guestfs.pod:3085
42890 #, no-wrap
42891 msgid ""
42892 " tx push -s\n"
42893 "\n"
42894 msgstr ""
42895
42896 #. type: textblock
42897 #: ../src/guestfs.pod:3087
42898 msgid "to push the latest POT files to Transifex.  Then run:"
42899 msgstr ""
42900
42901 #. type: verbatim
42902 #: ../src/guestfs.pod:3089
42903 #, no-wrap
42904 msgid ""
42905 " ./tx-pull.sh\n"
42906 "\n"
42907 msgstr ""
42908
42909 #. type: textblock
42910 #: ../src/guestfs.pod:3091
42911 msgid "which is a wrapper to pull the latest translated C<*.po> files."
42912 msgstr ""
42913
42914 #. type: textblock
42915 #: ../src/guestfs.pod:3095
42916 msgid ""
42917 "Create new stable and development directories under L<http://libguestfs.org/"
42918 "download>."
42919 msgstr ""
42920
42921 #. type: textblock
42922 #: ../src/guestfs.pod:3100
42923 msgid "Create the branch in git:"
42924 msgstr ""
42925
42926 #. type: verbatim
42927 #: ../src/guestfs.pod:3102
42928 #, no-wrap
42929 msgid ""
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"
42934 "\n"
42935 msgstr ""
42936
42937 #. type: =head1
42938 #: ../src/guestfs.pod:3109
42939 msgid "LIMITS"
42940 msgstr "ОБМЕЖЕННЯ"
42941
42942 #. type: =head2
42943 #: ../src/guestfs.pod:3111
42944 msgid "PROTOCOL LIMITS"
42945 msgstr "ОБМЕЖЕННЯ ПРОТОКОЛУ"
42946
42947 #. type: textblock
42948 #: ../src/guestfs.pod:3113
42949 msgid ""
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."
42956 msgstr ""
42957
42958 #. type: textblock
42959 #: ../src/guestfs.pod:3121
42960 msgid ""
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."
42965 msgstr ""
42966
42967 #. type: textblock
42968 #: ../src/guestfs.pod:3127
42969 msgid ""
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."
42973 msgstr ""
42974
42975 #. type: textblock
42976 #: ../src/guestfs.pod:3131
42977 msgid ""
42978 "You might also consider mounting the disk image using our FUSE filesystem "
42979 "support (L<guestmount(1)>)."
42980 msgstr ""
42981
42982 #. type: =head2
42983 #: ../src/guestfs.pod:3134
42984 msgid "MAXIMUM NUMBER OF DISKS"
42985 msgstr ""
42986
42987 #. type: textblock
42988 #: ../src/guestfs.pod:3136
42989 msgid "When using virtio disks (the default) the current limit is B<25> disks."
42990 msgstr ""
42991
42992 #. type: textblock
42993 #: ../src/guestfs.pod:3139
42994 msgid ""
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 "
42998 "purposes."
42999 msgstr ""
43000
43001 #. type: textblock
43002 #: ../src/guestfs.pod:3144
43003 msgid ""
43004 "We are working to substantially raise this limit in future versions but it "
43005 "requires complex changes to qemu."
43006 msgstr ""
43007
43008 #. type: textblock
43009 #: ../src/guestfs.pod:3147
43010 msgid ""
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."
43014 msgstr ""
43015
43016 #. type: =head2
43017 #: ../src/guestfs.pod:3151
43018 msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK"
43019 msgstr ""
43020
43021 #. type: textblock
43022 #: ../src/guestfs.pod:3153
43023 msgid "Virtio limits the maximum number of partitions per disk to B<15>."
43024 msgstr ""
43025
43026 #. type: textblock
43027 #: ../src/guestfs.pod:3155
43028 msgid ""
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>)."
43031 msgstr ""
43032
43033 #. type: textblock
43034 #: ../src/guestfs.pod:3158
43035 msgid ""
43036 "If you attach a disk with more than 15 partitions, the extra partitions are "
43037 "ignored by libguestfs."
43038 msgstr ""
43039
43040 #. type: =head2
43041 #: ../src/guestfs.pod:3161
43042 msgid "MAXIMUM SIZE OF A DISK"
43043 msgstr ""
43044
43045 #. type: textblock
43046 #: ../src/guestfs.pod:3163
43047 msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes."
43048 msgstr ""
43049
43050 #. type: textblock
43051 #: ../src/guestfs.pod:3165
43052 msgid ""
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 "
43055 "filesystem."
43056 msgstr ""
43057
43058 #. type: textblock
43059 #: ../src/guestfs.pod:3169
43060 msgid ""
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."
43066 msgstr ""
43067
43068 #. type: textblock
43069 #: ../src/guestfs.pod:3175
43070 msgid ""
43071 "For the hugest disk image files, we recommend using XFS on the host for "
43072 "storage."
43073 msgstr ""
43074
43075 #. type: =head2
43076 #: ../src/guestfs.pod:3178
43077 msgid "MAXIMUM SIZE OF A PARTITION"
43078 msgstr ""
43079
43080 #. type: textblock
43081 #: ../src/guestfs.pod:3180
43082 msgid ""
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."
43086 msgstr ""
43087
43088 #. type: textblock
43089 #: ../src/guestfs.pod:3184
43090 msgid ""
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."
43094 msgstr ""
43095
43096 #. type: =head2
43097 #: ../src/guestfs.pod:3189
43098 msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES"
43099 msgstr ""
43100
43101 #. type: textblock
43102 #: ../src/guestfs.pod:3191
43103 msgid ""
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."
43107 msgstr ""
43108
43109 #. type: =head2
43110 #: ../src/guestfs.pod:3195
43111 msgid "MAXIMUM UPLOAD AND DOWNLOAD"
43112 msgstr ""
43113
43114 #. type: textblock
43115 #: ../src/guestfs.pod:3197
43116 msgid ""
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."
43120 msgstr ""
43121
43122 #. type: =head2
43123 #: ../src/guestfs.pod:3201
43124 msgid "INSPECTION LIMITS"
43125 msgstr ""
43126
43127 #. type: textblock
43128 #: ../src/guestfs.pod:3203
43129 msgid ""
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."
43135 msgstr ""
43136
43137 #. type: textblock
43138 #: ../src/guestfs.pod:3229
43139 msgid ""
43140 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
43141 "effect as calling C<guestfs_set_verbose (g, 1)>."
43142 msgstr ""
43143
43144 #. type: textblock
43145 #: ../src/guestfs.pod:3241
43146 msgid ""
43147 "Set the path that libguestfs uses to search for a supermin appliance.  See "
43148 "the discussion of paths in section L</PATH> above."
43149 msgstr ""
43150
43151 #. type: textblock
43152 #: ../src/guestfs.pod:3250
43153 msgid "See also L</QEMU WRAPPERS> above."
43154 msgstr ""
43155
43156 #. type: textblock
43157 #: ../src/guestfs.pod:3254
43158 msgid ""
43159 "Set C<LIBGUESTFS_TRACE=1> to enable command traces.  This has the same "
43160 "effect as calling C<guestfs_set_trace (g, 1)>."
43161 msgstr ""
43162
43163 #. type: textblock
43164 #: ../src/guestfs.pod:3272
43165 msgid ""
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/>."
43176 msgstr ""
43177
43178 #. type: textblock
43179 #: ../src/guestfs.pod:3309
43180 msgid ""
43181 "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, L<lvm"
43182 "(8)>, L<disktype(1)>."
43183 msgstr ""
43184
43185 #. type: =head1
43186 #: ../src/guestfs.pod:3316 ../tools/virt-make-fs.pl:571
43187 #: ../tools/virt-win-reg.pl:772
43188 msgid "BUGS"
43189 msgstr "ВАДИ"
43190
43191 #. type: textblock
43192 #: ../src/guestfs.pod:3318
43193 msgid "To get a list of bugs against libguestfs use this link:"
43194 msgstr ""
43195 "Щоб переглянути список відомих вад у libguestfs, скористайтеся таким "
43196 "посиланням:"
43197
43198 #. type: textblock
43199 #: ../src/guestfs.pod:3320
43200 msgid ""
43201 "L<https://bugzilla.redhat.com/buglist.cgi?"
43202 "component=libguestfs&product=Virtualization+Tools>"
43203 msgstr ""
43204 "L<https://bugzilla.redhat.com/buglist.cgi?"
43205 "component=libguestfs&product=Virtualization+Tools>"
43206
43207 #. type: textblock
43208 #: ../src/guestfs.pod:3322
43209 msgid "To report a new bug against libguestfs use this link:"
43210 msgstr "Для звітування щодо вад у libguestfs скористайтеся цим посиланням:"
43211
43212 #. type: textblock
43213 #: ../src/guestfs.pod:3324
43214 msgid ""
43215 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
43216 "component=libguestfs&product=Virtualization+Tools>"
43217 msgstr ""
43218 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
43219 "component=libguestfs&product=Virtualization+Tools>"
43220
43221 #. type: textblock
43222 #: ../src/guestfs.pod:3326
43223 msgid "When reporting a bug, please check:"
43224 msgstr ""
43225
43226 #. type: textblock
43227 #: ../src/guestfs.pod:3332
43228 msgid "That the bug hasn't been reported already."
43229 msgstr ""
43230
43231 #. type: textblock
43232 #: ../src/guestfs.pod:3336
43233 msgid "That you are testing a recent version."
43234 msgstr ""
43235
43236 #. type: textblock
43237 #: ../src/guestfs.pod:3340
43238 msgid "Describe the bug accurately, and give a way to reproduce it."
43239 msgstr ""
43240
43241 #. type: textblock
43242 #: ../src/guestfs.pod:3344
43243 msgid ""
43244 "Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
43245 "bug report."
43246 msgstr ""
43247
43248 #. type: textblock
43249 #: ../test-tool/libguestfs-test-tool.pod:5
43250 msgid "libguestfs-test-tool - Diagnostics for libguestfs"
43251 msgstr ""
43252
43253 #. type: verbatim
43254 #: ../test-tool/libguestfs-test-tool.pod:9
43255 #, no-wrap
43256 msgid ""
43257 " libguestfs-test-tool [--options]\n"
43258 "\n"
43259 msgstr ""
43260
43261 #. type: textblock
43262 #: ../test-tool/libguestfs-test-tool.pod:13
43263 msgid ""
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 "
43268 "environment."
43269 msgstr ""
43270
43271 #. type: textblock
43272 #: ../test-tool/libguestfs-test-tool.pod:19
43273 msgid "If you suspect a problem in libguestfs, then just run:"
43274 msgstr ""
43275
43276 #. type: verbatim
43277 #: ../test-tool/libguestfs-test-tool.pod:21
43278 #, no-wrap
43279 msgid ""
43280 " libguestfs-test-tool\n"
43281 "\n"
43282 msgstr ""
43283
43284 #. type: textblock
43285 #: ../test-tool/libguestfs-test-tool.pod:23
43286 msgid "It will print lots of diagnostic messages."
43287 msgstr ""
43288
43289 #. type: textblock
43290 #: ../test-tool/libguestfs-test-tool.pod:25
43291 msgid "If it runs to completion successfully, you will see this near the end:"
43292 msgstr ""
43293
43294 #. type: verbatim
43295 #: ../test-tool/libguestfs-test-tool.pod:27
43296 #, no-wrap
43297 msgid ""
43298 " ===== TEST FINISHED OK =====\n"
43299 "\n"
43300 msgstr ""
43301
43302 #. type: textblock
43303 #: ../test-tool/libguestfs-test-tool.pod:29
43304 msgid "and the test tool will exit with code 0."
43305 msgstr ""
43306
43307 #. type: textblock
43308 #: ../test-tool/libguestfs-test-tool.pod:31
43309 msgid ""
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/"
43313 "> website."
43314 msgstr ""
43315
43316 #. type: textblock
43317 #: ../test-tool/libguestfs-test-tool.pod:42
43318 msgid "Display short usage information and exit."
43319 msgstr ""
43320
43321 #. type: =item
43322 #: ../test-tool/libguestfs-test-tool.pod:44
43323 msgid "B<--qemu qemu_binary>"
43324 msgstr ""
43325
43326 #. type: textblock
43327 #: ../test-tool/libguestfs-test-tool.pod:46
43328 msgid ""
43329 "If you have downloaded another qemu binary, point this option at the full "
43330 "path of the binary to try it."
43331 msgstr ""
43332
43333 #. type: =item
43334 #: ../test-tool/libguestfs-test-tool.pod:49
43335 msgid "B<--qemudir qemu_source_dir>"
43336 msgstr ""
43337
43338 #. type: textblock
43339 #: ../test-tool/libguestfs-test-tool.pod:51
43340 msgid ""
43341 "If you have compiled qemu from source, point this option at the source "
43342 "directory to try it."
43343 msgstr ""
43344
43345 #. type: =item
43346 #: ../test-tool/libguestfs-test-tool.pod:54
43347 msgid "B<-t N>"
43348 msgstr ""
43349
43350 #. type: =item
43351 #: ../test-tool/libguestfs-test-tool.pod:56
43352 msgid "B<--timeout N>"
43353 msgstr ""
43354
43355 #. type: textblock
43356 #: ../test-tool/libguestfs-test-tool.pod:58
43357 msgid ""
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."
43360 msgstr ""
43361
43362 #. type: =head1
43363 #: ../test-tool/libguestfs-test-tool.pod:63
43364 msgid "TRYING OUT A DIFFERENT VERSION OF QEMU"
43365 msgstr ""
43366
43367 #. type: textblock
43368 #: ../test-tool/libguestfs-test-tool.pod:65
43369 msgid ""
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."
43373 msgstr ""
43374
43375 #. type: textblock
43376 #: ../test-tool/libguestfs-test-tool.pod:69
43377 msgid ""
43378 "If you have downloaded a qemu binary from somewhere, use the I<--qemu> "
43379 "option to point to the binary."
43380 msgstr ""
43381
43382 #. type: textblock
43383 #: ../test-tool/libguestfs-test-tool.pod:72
43384 msgid ""
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."
43388 msgstr ""
43389
43390 #. type: =head1
43391 #: ../test-tool/libguestfs-test-tool.pod:76
43392 msgid "TRYING OUT A DIFFERENT KERNEL"
43393 msgstr ""
43394
43395 #. type: textblock
43396 #: ../test-tool/libguestfs-test-tool.pod:78
43397 msgid ""
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>."
43401 msgstr ""
43402
43403 #. type: textblock
43404 #: ../test-tool/libguestfs-test-tool.pod:82
43405 msgid ""
43406 "Refer to L<febootstrap-supermin-helper(8)/ENVIRONMENT VARIABLES> for further "
43407 "information."
43408 msgstr ""
43409
43410 #. type: =head1
43411 #: ../test-tool/libguestfs-test-tool.pod:85
43412 msgid "SELF-DIAGNOSIS"
43413 msgstr ""
43414
43415 #. type: textblock
43416 #: ../test-tool/libguestfs-test-tool.pod:87
43417 msgid ""
43418 "Refer to L<guestfs(3)/APPLIANCE BOOT PROCESS> to understand the messages "
43419 "produced by libguestfs-test-tool and/or possible errors."
43420 msgstr ""
43421
43422 #. type: textblock
43423 #: ../test-tool/libguestfs-test-tool.pod:92
43424 msgid ""
43425 "libguestfs-test-tool returns I<0> if the tests completed without error, or "
43426 "I<1> if there was an error."
43427 msgstr ""
43428
43429 #. type: textblock
43430 #: ../test-tool/libguestfs-test-tool.pod:97
43431 msgid ""
43432 "For the full list of environment variables which may affect libguestfs, "
43433 "please see the L<guestfs(3)> manual page."
43434 msgstr ""
43435
43436 #. type: textblock
43437 #: ../test-tool/libguestfs-test-tool.pod:102
43438 msgid "L<guestfs(3)>, L<http://libguestfs.org/>, L<http://qemu.org/>."
43439 msgstr ""
43440
43441 #. type: textblock
43442 #: ../tools/virt-list-filesystems.pl:32
43443 msgid ""
43444 "virt-list-filesystems - List filesystems in a virtual machine or disk image"
43445 msgstr ""
43446
43447 #. type: verbatim
43448 #: ../tools/virt-list-filesystems.pl:36
43449 #, no-wrap
43450 msgid ""
43451 " virt-list-filesystems [--options] domname\n"
43452 "\n"
43453 msgstr ""
43454
43455 #. type: verbatim
43456 #: ../tools/virt-list-filesystems.pl:38
43457 #, no-wrap
43458 msgid ""
43459 " virt-list-filesystems [--options] disk.img [disk.img ...]\n"
43460 "\n"
43461 msgstr ""
43462
43463 #. type: textblock
43464 #: ../tools/virt-list-filesystems.pl:42 ../tools/virt-list-partitions.pl:42
43465 msgid ""
43466 "This tool is obsolete.  Use L<virt-filesystems(1)> as a more flexible "
43467 "replacement."
43468 msgstr ""
43469
43470 #. type: textblock
43471 #: ../tools/virt-list-filesystems.pl:45
43472 msgid ""
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."
43475 msgstr ""
43476
43477 #. type: textblock
43478 #: ../tools/virt-list-filesystems.pl:49
43479 msgid ""
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)"
43482 "> tool."
43483 msgstr ""
43484
43485 #. type: textblock
43486 #: ../tools/virt-list-filesystems.pl:112
43487 msgid ""
43488 "With this option, C<virt-list-filesystems> displays the type of each "
43489 "filesystem too (where \"type\" means C<ext3>, C<xfs> etc.)"
43490 msgstr ""
43491
43492 #. type: =item
43493 #: ../tools/virt-list-filesystems.pl:119
43494 msgid "B<-a>"
43495 msgstr "B<-a>"
43496
43497 #. type: textblock
43498 #: ../tools/virt-list-filesystems.pl:123
43499 msgid ""
43500 "Normally we only show mountable filesystems.  If this option is given then "
43501 "swap devices are shown too."
43502 msgstr ""
43503
43504 #. type: textblock
43505 #: ../tools/virt-list-filesystems.pl:197
43506 msgid ""
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/>."
43510 msgstr ""
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/>."
43514
43515 #. type: textblock
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"
43519
43520 #. type: textblock
43521 #: ../tools/virt-list-partitions.pl:32
43522 msgid ""
43523 "virt-list-partitions - List partitions in a virtual machine or disk image"
43524 msgstr ""
43525
43526 #. type: verbatim
43527 #: ../tools/virt-list-partitions.pl:36
43528 #, no-wrap
43529 msgid ""
43530 " virt-list-partitions [--options] domname\n"
43531 "\n"
43532 msgstr ""
43533 " virt-list-partitions [--параметри] назва_домену\n"
43534 "\n"
43535
43536 #. type: verbatim
43537 #: ../tools/virt-list-partitions.pl:38
43538 #, no-wrap
43539 msgid ""
43540 " virt-list-partitions [--options] disk.img [disk.img ...]\n"
43541 "\n"
43542 msgstr ""
43543 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
43544 "\n"
43545
43546 #. type: textblock
43547 #: ../tools/virt-list-partitions.pl:45
43548 msgid ""
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)>."
43552 msgstr ""
43553
43554 #. type: textblock
43555 #: ../tools/virt-list-partitions.pl:50
43556 msgid ""
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)"
43559 "> tool."
43560 msgstr ""
43561
43562 #. type: textblock
43563 #: ../tools/virt-list-partitions.pl:113
43564 msgid "Show sizes in human-readable form (eg. \"1G\")."
43565 msgstr ""
43566
43567 #. type: textblock
43568 #: ../tools/virt-list-partitions.pl:123
43569 msgid ""
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.)"
43572 msgstr ""
43573
43574 #. type: =item
43575 #: ../tools/virt-list-partitions.pl:130
43576 msgid "B<-t>"
43577 msgstr "B<-t>"
43578
43579 #. type: =item
43580 #: ../tools/virt-list-partitions.pl:132
43581 msgid "B<--total>"
43582 msgstr "B<--total>"
43583
43584 #. type: textblock
43585 #: ../tools/virt-list-partitions.pl:134
43586 msgid ""
43587 "Display the total size of each block device (as a separate row or rows)."
43588 msgstr ""
43589
43590 #. type: textblock
43591 #: ../tools/virt-list-partitions.pl:267
43592 msgid ""
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/>."
43596 msgstr ""
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/>."
43600
43601 #. type: textblock
43602 #: ../tools/virt-list-partitions.pl:283
43603 msgid "Copyright (C) 2009-2010 Red Hat Inc."
43604 msgstr "© Red Hat Inc., 2009–2010"
43605
43606 #. type: textblock
43607 #: ../tools/virt-make-fs.pl:37
43608 msgid "virt-make-fs - Make a filesystem from a tar archive or files"
43609 msgstr ""
43610
43611 #. type: verbatim
43612 #: ../tools/virt-make-fs.pl:41
43613 #, no-wrap
43614 msgid ""
43615 " virt-make-fs [--options] input.tar output.img\n"
43616 "\n"
43617 msgstr ""
43618
43619 #. type: verbatim
43620 #: ../tools/virt-make-fs.pl:43
43621 #, no-wrap
43622 msgid ""
43623 " virt-make-fs [--options] input.tar.gz output.img\n"
43624 "\n"
43625 msgstr ""
43626
43627 #. type: verbatim
43628 #: ../tools/virt-make-fs.pl:45
43629 #, no-wrap
43630 msgid ""
43631 " virt-make-fs [--options] directory output.img\n"
43632 "\n"
43633 msgstr ""
43634
43635 #. type: textblock
43636 #: ../tools/virt-make-fs.pl:49
43637 msgid ""
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)."
43644 msgstr ""
43645
43646 #. type: textblock
43647 #: ../tools/virt-make-fs.pl:57
43648 msgid "Basic usage is:"
43649 msgstr ""
43650
43651 #. type: verbatim
43652 #: ../tools/virt-make-fs.pl:59
43653 #, no-wrap
43654 msgid ""
43655 " virt-make-fs input output.img\n"
43656 "\n"
43657 msgstr ""
43658
43659 #. type: textblock
43660 #: ../tools/virt-make-fs.pl:61
43661 msgid ""
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)."
43667 msgstr ""
43668
43669 #. type: =head2
43670 #: ../tools/virt-make-fs.pl:67
43671 msgid "FILESYSTEM TYPE"
43672 msgstr "ТИП ФАЙЛОВОЇ СИСТЕМИ"
43673
43674 #. type: textblock
43675 #: ../tools/virt-make-fs.pl:69
43676 msgid ""
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:"
43680 msgstr ""
43681
43682 #. type: =item
43683 #: ../tools/virt-make-fs.pl:75
43684 msgid "I<ext3>"
43685 msgstr "I<ext3>"
43686
43687 #. type: textblock
43688 #: ../tools/virt-make-fs.pl:77
43689 msgid ""
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."
43693 msgstr ""
43694
43695 #. type: =item
43696 #: ../tools/virt-make-fs.pl:81
43697 msgid "I<ntfs> or I<vfat>"
43698 msgstr "I<ntfs> або I<vfat>"
43699
43700 #. type: textblock
43701 #: ../tools/virt-make-fs.pl:83
43702 msgid "Useful if exporting data to a Windows guest."
43703 msgstr ""
43704
43705 #. type: textblock
43706 #: ../tools/virt-make-fs.pl:85
43707 msgid ""
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."
43712 msgstr ""
43713
43714 #. type: =item
43715 #: ../tools/virt-make-fs.pl:90
43716 msgid "I<minix>"
43717 msgstr "I<minix>"
43718
43719 #. type: textblock
43720 #: ../tools/virt-make-fs.pl:92
43721 msgid ""
43722 "Lower overhead than C<ext2>, but certain limitations on filename length and "
43723 "total filesystem size."
43724 msgstr ""
43725
43726 #. type: =head3
43727 #: ../tools/virt-make-fs.pl:97 ../tools/virt-make-fs.pl:116
43728 #: ../tools/virt-make-fs.pl:149
43729 msgid "EXAMPLE"
43730 msgstr "ПРИКЛАД"
43731
43732 #. type: verbatim
43733 #: ../tools/virt-make-fs.pl:99
43734 #, no-wrap
43735 msgid ""
43736 " virt-make-fs --type=minix input minixfs.img\n"
43737 "\n"
43738 msgstr ""
43739
43740 #. type: =head2
43741 #: ../tools/virt-make-fs.pl:101
43742 msgid "TO PARTITION OR NOT TO PARTITION"
43743 msgstr ""
43744
43745 #. type: textblock
43746 #: ../tools/virt-make-fs.pl:103
43747 msgid "Optionally virt-make-fs can add a partition table to the output disk."
43748 msgstr ""
43749
43750 #. type: textblock
43751 #: ../tools/virt-make-fs.pl:105
43752 msgid ""
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)."
43757 msgstr ""
43758
43759 #. type: textblock
43760 #: ../tools/virt-make-fs.pl:110
43761 msgid ""
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)."
43766 msgstr ""
43767
43768 #. type: textblock
43769 #: ../tools/virt-make-fs.pl:118
43770 msgid "Add an MBR partition:"
43771 msgstr ""
43772
43773 #. type: verbatim
43774 #: ../tools/virt-make-fs.pl:120
43775 #, no-wrap
43776 msgid ""
43777 " virt-make-fs --partition -- input disk.img\n"
43778 "\n"
43779 msgstr ""
43780
43781 #. type: textblock
43782 #: ../tools/virt-make-fs.pl:122
43783 msgid ""
43784 "If the output disk image could be terabyte-sized or larger, it's better to "
43785 "use an EFI/GPT-compatible partition table:"
43786 msgstr ""
43787
43788 #. type: verbatim
43789 #: ../tools/virt-make-fs.pl:125
43790 #, no-wrap
43791 msgid ""
43792 " virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n"
43793 "\n"
43794 msgstr ""
43795
43796 #. type: =head2
43797 #: ../tools/virt-make-fs.pl:127
43798 msgid "EXTRA SPACE"
43799 msgstr ""
43800
43801 #. type: textblock
43802 #: ../tools/virt-make-fs.pl:129
43803 msgid ""
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 "
43810 "want it."
43811 msgstr ""
43812
43813 #. type: textblock
43814 #: ../tools/virt-make-fs.pl:137
43815 msgid ""
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."
43822 msgstr ""
43823
43824 #. type: textblock
43825 #: ../tools/virt-make-fs.pl:145
43826 msgid ""
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."
43830 msgstr ""
43831
43832 #. type: verbatim
43833 #: ../tools/virt-make-fs.pl:151
43834 #, no-wrap
43835 msgid ""
43836 " virt-make-fs --format=qcow2 --size=+200M input output.img\n"
43837 "\n"
43838 msgstr ""
43839 " virt-make-fs --format=qcow2 --size=+200M input output.img\n"
43840 "\n"
43841
43842 #. type: textblock
43843 #: ../tools/virt-make-fs.pl:179
43844 msgid "Enable debugging information."
43845 msgstr "Увімкнути виведення діагностичних даних."
43846
43847 #. type: =item
43848 #: ../tools/virt-make-fs.pl:185
43849 msgid "B<--size=E<lt>NE<gt>>"
43850 msgstr "B<--size=E<lt>NE<gt>>"
43851
43852 #. type: =item
43853 #: ../tools/virt-make-fs.pl:187
43854 msgid "B<--size=+E<lt>NE<gt>>"
43855 msgstr "B<--size=+E<lt>NE<gt>>"
43856
43857 #. type: =item
43858 #: ../tools/virt-make-fs.pl:189
43859 msgid "B<-s E<lt>NE<gt>>"
43860 msgstr "B<-s E<lt>NE<gt>>"
43861
43862 #. type: =item
43863 #: ../tools/virt-make-fs.pl:191
43864 msgid "B<-s +E<lt>NE<gt>>"
43865 msgstr "B<-s +E<lt>NE<gt>>"
43866
43867 #. type: textblock
43868 #: ../tools/virt-make-fs.pl:193
43869 msgid ""
43870 "Use the I<--size> (or I<-s>) option to choose the size of the output image."
43871 msgstr ""
43872
43873 #. type: textblock
43874 #: ../tools/virt-make-fs.pl:196
43875 msgid ""
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."
43878 msgstr ""
43879
43880 #. type: textblock
43881 #: ../tools/virt-make-fs.pl:199
43882 msgid ""
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."
43887 msgstr ""
43888
43889 #. type: textblock
43890 #: ../tools/virt-make-fs.pl:204
43891 msgid ""
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."
43896 msgstr ""
43897
43898 #. type: textblock
43899 #: ../tools/virt-make-fs.pl:210
43900 msgid ""
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)."
43905 msgstr ""
43906
43907 #. type: =item
43908 #: ../tools/virt-make-fs.pl:219
43909 msgid "B<--format=E<lt>fmtE<gt>>"
43910 msgstr ""
43911
43912 #. type: =item
43913 #: ../tools/virt-make-fs.pl:221
43914 msgid "B<-F E<lt>fmtE<gt>>"
43915 msgstr ""
43916
43917 #. type: textblock
43918 #: ../tools/virt-make-fs.pl:223
43919 msgid "Choose the output disk image format."
43920 msgstr ""
43921
43922 #. type: textblock
43923 #: ../tools/virt-make-fs.pl:225
43924 msgid "The default is C<raw> (raw sparse disk image)."
43925 msgstr ""
43926
43927 #. type: textblock
43928 #: ../tools/virt-make-fs.pl:227
43929 msgid ""
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>."
43932 msgstr ""
43933
43934 #. type: =item
43935 #: ../tools/virt-make-fs.pl:234
43936 msgid "B<--type=E<lt>fsE<gt>>"
43937 msgstr ""
43938
43939 #. type: =item
43940 #: ../tools/virt-make-fs.pl:236
43941 msgid "B<-t E<lt>fsE<gt>>"
43942 msgstr ""
43943
43944 #. type: textblock
43945 #: ../tools/virt-make-fs.pl:238
43946 msgid "Choose the output filesystem type."
43947 msgstr ""
43948
43949 #. type: textblock
43950 #: ../tools/virt-make-fs.pl:240
43951 msgid "The default is C<ext2>."
43952 msgstr "Типовим значенням є C<ext2>."
43953
43954 #. type: textblock
43955 #: ../tools/virt-make-fs.pl:242
43956 msgid ""
43957 "Any filesystem which is supported read-write by libguestfs can be used here."
43958 msgstr ""
43959
43960 #. type: =item
43961 #: ../tools/virt-make-fs.pl:249
43962 msgid "B<--partition>"
43963 msgstr "B<--partition>"
43964
43965 #. type: =item
43966 #: ../tools/virt-make-fs.pl:251
43967 msgid "B<--partition=E<lt>parttypeE<gt>>"
43968 msgstr ""
43969
43970 #. type: textblock
43971 #: ../tools/virt-make-fs.pl:253
43972 msgid ""
43973 "If specified, this flag adds an MBR partition table to the output disk image."
43974 msgstr ""
43975
43976 #. type: textblock
43977 #: ../tools/virt-make-fs.pl:256
43978 msgid ""
43979 "You can change the partition table type, eg. I<--partition=gpt> for large "
43980 "disks."
43981 msgstr ""
43982
43983 #. type: textblock
43984 #: ../tools/virt-make-fs.pl:259
43985 msgid ""
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:"
43988 msgstr ""
43989
43990 #. type: verbatim
43991 #: ../tools/virt-make-fs.pl:263
43992 #, no-wrap
43993 msgid ""
43994 " virt-make-fs --partition input.tar output.img\n"
43995 "\n"
43996 msgstr ""
43997
43998 #. type: textblock
43999 #: ../tools/virt-make-fs.pl:265
44000 msgid ""
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:"
44004 msgstr ""
44005
44006 #. type: verbatim
44007 #: ../tools/virt-make-fs.pl:269
44008 #, no-wrap
44009 msgid ""
44010 " virt-make-fs --partition -- input.tar output.img\n"
44011 "\n"
44012 msgstr ""
44013
44014 #. type: textblock
44015 #: ../tools/virt-make-fs.pl:271
44016 msgid "For MBR, virt-make-fs sets the partition type byte automatically."
44017 msgstr ""
44018
44019 #. type: textblock
44020 #: ../tools/virt-make-fs.pl:559
44021 msgid ""
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/>."
44025 msgstr ""
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/>."
44029
44030 #. type: textblock
44031 #: ../tools/virt-make-fs.pl:573 ../tools/virt-win-reg.pl:774
44032 msgid ""
44033 "When reporting bugs, please enable debugging and capture the I<complete> "
44034 "output:"
44035 msgstr ""
44036
44037 #. type: verbatim
44038 #: ../tools/virt-make-fs.pl:576
44039 #, no-wrap
44040 msgid ""
44041 " export LIBGUESTFS_DEBUG=1\n"
44042 " virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n"
44043 "\n"
44044 msgstr ""
44045 " export LIBGUESTFS_DEBUG=1\n"
44046 " virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n"
44047 "\n"
44048
44049 #. type: textblock
44050 #: ../tools/virt-make-fs.pl:579
44051 msgid ""
44052 "Attach /tmp/virt-make-fs.log to a new bug report at L<https://bugzilla."
44053 "redhat.com/>"
44054 msgstr ""
44055
44056 #. type: textblock
44057 #: ../tools/virt-tar.pl:33
44058 msgid "virt-tar - Extract or upload files to a virtual machine"
44059 msgstr ""
44060
44061 #. type: verbatim
44062 #: ../tools/virt-tar.pl:37
44063 #, no-wrap
44064 msgid ""
44065 " virt-tar [--options] -x domname directory tarball\n"
44066 "\n"
44067 msgstr ""
44068
44069 #. type: verbatim
44070 #: ../tools/virt-tar.pl:39
44071 #, no-wrap
44072 msgid ""
44073 " virt-tar [--options] -u domname tarball directory\n"
44074 "\n"
44075 msgstr ""
44076
44077 #. type: verbatim
44078 #: ../tools/virt-tar.pl:41
44079 #, no-wrap
44080 msgid ""
44081 " virt-tar [--options] disk.img [disk.img ...] -x directory tarball\n"
44082 "\n"
44083 msgstr ""
44084
44085 #. type: verbatim
44086 #: ../tools/virt-tar.pl:43
44087 #, no-wrap
44088 msgid ""
44089 " virt-tar [--options] disk.img [disk.img ...] -u tarball directory\n"
44090 "\n"
44091 msgstr ""
44092
44093 #. type: =head2
44094 #: ../tools/virt-tar.pl:45 ../tools/virt-win-reg.pl:88
44095 msgid "NOTE"
44096 msgstr "ПРИМІТКА"
44097
44098 #. type: textblock
44099 #: ../tools/virt-tar.pl:47
44100 msgid ""
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."
44103 msgstr ""
44104
44105 #. type: textblock
44106 #: ../tools/virt-tar.pl:52
44107 msgid "Download C</home> from the VM into a local tarball:"
44108 msgstr ""
44109
44110 #. type: verbatim
44111 #: ../tools/virt-tar.pl:54
44112 #, no-wrap
44113 msgid ""
44114 " virt-tar -x domname /home home.tar\n"
44115 "\n"
44116 msgstr ""
44117
44118 #. type: verbatim
44119 #: ../tools/virt-tar.pl:56
44120 #, no-wrap
44121 msgid ""
44122 " virt-tar -zx domname /home home.tar.gz\n"
44123 "\n"
44124 msgstr ""
44125
44126 #. type: textblock
44127 #: ../tools/virt-tar.pl:58
44128 msgid "Upload a local tarball and unpack it inside C</tmp> in the VM:"
44129 msgstr ""
44130
44131 #. type: verbatim
44132 #: ../tools/virt-tar.pl:60
44133 #, no-wrap
44134 msgid ""
44135 " virt-tar -u domname uploadstuff.tar /tmp\n"
44136 "\n"
44137 msgstr ""
44138
44139 #. type: verbatim
44140 #: ../tools/virt-tar.pl:62
44141 #, no-wrap
44142 msgid ""
44143 " virt-tar -zu domname uploadstuff.tar.gz /tmp\n"
44144 "\n"
44145 msgstr ""
44146
44147 #. type: textblock
44148 #: ../tools/virt-tar.pl:66
44149 msgid ""
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."
44153 msgstr ""
44154
44155 #. type: textblock
44156 #: ../tools/virt-tar.pl:71
44157 msgid ""
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."
44163 msgstr ""
44164
44165 #. type: textblock
44166 #: ../tools/virt-tar.pl:79
44167 msgid ""
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 "
44171 "guests, etc."
44172 msgstr ""
44173
44174 #. type: textblock
44175 #: ../tools/virt-tar.pl:84
44176 msgid ""
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."
44180 msgstr ""
44181
44182 #. type: textblock
44183 #: ../tools/virt-tar.pl:88
44184 msgid ""
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."
44189 msgstr ""
44190
44191 #. type: textblock
44192 #: ../tools/virt-tar.pl:94
44193 msgid ""
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."
44197 msgstr ""
44198
44199 #. type: textblock
44200 #: ../tools/virt-tar.pl:98
44201 msgid ""
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)."
44206 msgstr ""
44207
44208 #. type: =item
44209 #: ../tools/virt-tar.pl:160
44210 msgid "B<--extract>"
44211 msgstr "B<--extract>"
44212
44213 #. type: =item
44214 #: ../tools/virt-tar.pl:162
44215 msgid "B<--download>"
44216 msgstr "B<--download>"
44217
44218 #. type: =item
44219 #: ../tools/virt-tar.pl:164
44220 msgid "B<-u>"
44221 msgstr "B<-u>"
44222
44223 #. type: =item
44224 #: ../tools/virt-tar.pl:166
44225 msgid "B<--upload>"
44226 msgstr "B<--upload>"
44227
44228 #. type: textblock
44229 #: ../tools/virt-tar.pl:168
44230 msgid ""
44231 "Use I<-x> to extract (download) a directory from a virtual machine to a "
44232 "local tarball."
44233 msgstr ""
44234
44235 #. type: textblock
44236 #: ../tools/virt-tar.pl:171
44237 msgid ""
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."
44240 msgstr ""
44241
44242 #. type: textblock
44243 #: ../tools/virt-tar.pl:175
44244 msgid "You must specify exactly one of these options."
44245 msgstr ""
44246
44247 #. type: =item
44248 #: ../tools/virt-tar.pl:181
44249 msgid "B<-z>"
44250 msgstr "B<-z>"
44251
44252 #. type: =item
44253 #: ../tools/virt-tar.pl:183
44254 msgid "B<--gzip>"
44255 msgstr "B<--gzip>"
44256
44257 #. type: textblock
44258 #: ../tools/virt-tar.pl:185
44259 msgid "Specify that the input or output tarball is gzip-compressed."
44260 msgstr ""
44261
44262 #. type: textblock
44263 #: ../tools/virt-tar.pl:298
44264 msgid ""
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."
44268 "org/>."
44269 msgstr ""
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."
44273 "org/>."
44274
44275 #. type: textblock
44276 #: ../tools/virt-win-reg.pl:37
44277 msgid ""
44278 "virt-win-reg - Export and merge Windows Registry entries from a Windows guest"
44279 msgstr ""
44280
44281 #. type: verbatim
44282 #: ../tools/virt-win-reg.pl:41
44283 #, no-wrap
44284 msgid ""
44285 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n"
44286 "\n"
44287 msgstr ""
44288
44289 #. type: verbatim
44290 #: ../tools/virt-win-reg.pl:43
44291 #, no-wrap
44292 msgid ""
44293 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n"
44294 "\n"
44295 msgstr ""
44296
44297 #. type: verbatim
44298 #: ../tools/virt-win-reg.pl:45
44299 #, no-wrap
44300 msgid ""
44301 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n"
44302 "\n"
44303 msgstr ""
44304
44305 #. type: verbatim
44306 #: ../tools/virt-win-reg.pl:47
44307 #, no-wrap
44308 msgid ""
44309 " virt-win-reg --merge domname [input.reg ...]\n"
44310 "\n"
44311 msgstr ""
44312
44313 #. type: verbatim
44314 #: ../tools/virt-win-reg.pl:49
44315 #, no-wrap
44316 msgid ""
44317 " virt-win-reg [--options] disk.img ... # instead of domname\n"
44318 "\n"
44319 msgstr ""
44320
44321 #. type: textblock
44322 #: ../tools/virt-win-reg.pl:53
44323 msgid ""
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."
44328 msgstr ""
44329
44330 #. type: textblock
44331 #: ../tools/virt-win-reg.pl:58
44332 msgid ""
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."
44337 msgstr ""
44338
44339 #. type: textblock
44340 #: ../tools/virt-win-reg.pl:65
44341 msgid ""
44342 "This program can export and merge Windows Registry entries from a Windows "
44343 "guest."
44344 msgstr ""
44345
44346 #. type: textblock
44347 #: ../tools/virt-win-reg.pl:68
44348 msgid ""
44349 "The first parameter is the libvirt guest name or the raw disk image of a "
44350 "Windows guest."
44351 msgstr ""
44352
44353 #. type: textblock
44354 #: ../tools/virt-win-reg.pl:71
44355 msgid ""
44356 "If I<--merge> is I<not> specified, then the chosen registry key is displayed/"
44357 "exported (recursively).  For example:"
44358 msgstr ""
44359
44360 #. type: verbatim
44361 #: ../tools/virt-win-reg.pl:74
44362 #, no-wrap
44363 msgid ""
44364 " $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n"
44365 "\n"
44366 msgstr ""
44367 " $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n"
44368 "\n"
44369
44370 #. type: textblock
44371 #: ../tools/virt-win-reg.pl:76
44372 msgid ""
44373 "You can also display single values from within registry keys, for example:"
44374 msgstr ""
44375
44376 #. type: verbatim
44377 #: ../tools/virt-win-reg.pl:79
44378 #, no-wrap
44379 msgid ""
44380 " $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n"
44381 " $ virt-win-reg Windows7 $cvkey ProductName\n"
44382 " Windows 7 Enterprise\n"
44383 "\n"
44384 msgstr ""
44385 " $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n"
44386 " $ virt-win-reg Windows7 $cvkey ProductName\n"
44387 " Windows 7 Enterprise\n"
44388 "\n"
44389
44390 #. type: textblock
44391 #: ../tools/virt-win-reg.pl:83
44392 msgid ""
44393 "With I<--merge>, you can merge a textual regedit file into the Windows "
44394 "Registry:"
44395 msgstr ""
44396
44397 #. type: verbatim
44398 #: ../tools/virt-win-reg.pl:86
44399 #, no-wrap
44400 msgid ""
44401 " $ virt-win-reg --merge Windows7 changes.reg\n"
44402 "\n"
44403 msgstr ""
44404 " $ virt-win-reg --merge Windows7 changes.reg\n"
44405 "\n"
44406
44407 #. type: textblock
44408 #: ../tools/virt-win-reg.pl:90
44409 msgid ""
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)>."
44415 msgstr ""
44416
44417 #. type: =item
44418 #: ../tools/virt-win-reg.pl:159
44419 msgid "B<--merge>"
44420 msgstr "B<--merge>"
44421
44422 #. type: textblock
44423 #: ../tools/virt-win-reg.pl:161
44424 msgid ""
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."
44428 msgstr ""
44429
44430 #. type: textblock
44431 #: ../tools/virt-win-reg.pl:165
44432 msgid ""
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 "
44435 "safe."
44436 msgstr ""
44437
44438 #. type: =item
44439 #: ../tools/virt-win-reg.pl:173
44440 msgid "B<--encoding> UTF-16LE|ASCII"
44441 msgstr "B<--encoding> UTF-16LE|ASCII"
44442
44443 #. type: textblock
44444 #: ../tools/virt-win-reg.pl:175
44445 msgid ""
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>."
44449 msgstr ""
44450
44451 #. type: textblock
44452 #: ../tools/virt-win-reg.pl:179
44453 msgid ""
44454 "The default is to use UTF-16LE, which should work with recent versions of "
44455 "Windows."
44456 msgstr ""
44457
44458 #. type: =item
44459 #: ../tools/virt-win-reg.pl:186
44460 msgid "B<--unsafe-printable-strings>"
44461 msgstr "B<--unsafe-printable-strings>"
44462
44463 #. type: textblock
44464 #: ../tools/virt-win-reg.pl:188
44465 msgid ""
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 "
44468 "present."
44469 msgstr ""
44470
44471 #. type: textblock
44472 #: ../tools/virt-win-reg.pl:192
44473 msgid ""
44474 "This is unsafe and does not preserve the fidelity of strings in the original "
44475 "Registry for various reasons:"
44476 msgstr ""
44477
44478 #. type: textblock
44479 #: ../tools/virt-win-reg.pl:199
44480 msgid ""
44481 "Assumes the original encoding is UTF-16LE.  ASCII strings and strings in "
44482 "other encodings will be corrupted by this transformation."
44483 msgstr ""
44484
44485 #. type: textblock
44486 #: ../tools/virt-win-reg.pl:204
44487 msgid ""
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 "
44490 "not reliable."
44491 msgstr ""
44492
44493 #. type: textblock
44494 #: ../tools/virt-win-reg.pl:210
44495 msgid ""
44496 "Loses information about whether a zero codepoint followed the string in the "
44497 "Registry or not."
44498 msgstr ""
44499
44500 #. type: textblock
44501 #: ../tools/virt-win-reg.pl:215
44502 msgid ""
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>)."
44505 msgstr ""
44506
44507 #. type: textblock
44508 #: ../tools/virt-win-reg.pl:219
44509 msgid ""
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."
44513 msgstr ""
44514
44515 #. type: =head1
44516 #: ../tools/virt-win-reg.pl:556
44517 msgid "SUPPORTED SYSTEMS"
44518 msgstr "ПІДТРИМУВАНІ СИСТЕМИ"
44519
44520 #. type: textblock
44521 #: ../tools/virt-win-reg.pl:558
44522 msgid ""
44523 "The program currently supports Windows NT-derived guests starting with "
44524 "Windows XP through to at least Windows 7."
44525 msgstr ""
44526
44527 #. type: textblock
44528 #: ../tools/virt-win-reg.pl:561
44529 msgid "The following Registry keys are supported:"
44530 msgstr ""
44531
44532 #. type: =item
44533 #: ../tools/virt-win-reg.pl:565
44534 msgid "C<HKEY_LOCAL_MACHINE\\SAM>"
44535 msgstr "C<HKEY_LOCAL_MACHINE\\SAM>"
44536
44537 #. type: =item
44538 #: ../tools/virt-win-reg.pl:567
44539 msgid "C<HKEY_LOCAL_MACHINE\\SECURITY>"
44540 msgstr "C<HKEY_LOCAL_MACHINE\\SECURITY>"
44541
44542 #. type: =item
44543 #: ../tools/virt-win-reg.pl:569
44544 msgid "C<HKEY_LOCAL_MACHINE\\SOFTWARE>"
44545 msgstr "C<HKEY_LOCAL_MACHINE\\SOFTWARE>"
44546
44547 #. type: =item
44548 #: ../tools/virt-win-reg.pl:571
44549 msgid "C<HKEY_LOCAL_MACHINE\\SYSTEM>"
44550 msgstr "C<HKEY_LOCAL_MACHINE\\SYSTEM>"
44551
44552 #. type: =item
44553 #: ../tools/virt-win-reg.pl:573
44554 msgid "C<HKEY_USERS\\.DEFAULT>"
44555 msgstr "C<HKEY_USERS\\.DEFAULT>"
44556
44557 #. type: =item
44558 #: ../tools/virt-win-reg.pl:575
44559 msgid "C<HKEY_USERS\\I<SID>>"
44560 msgstr "C<HKEY_USERS\\I<SID>>"
44561
44562 #. type: textblock
44563 #: ../tools/virt-win-reg.pl:577
44564 msgid "where I<SID> is a Windows User SID (eg. C<S-1-5-18>)."
44565 msgstr ""
44566
44567 #. type: =item
44568 #: ../tools/virt-win-reg.pl:579
44569 msgid "C<HKEY_USERS\\I<username>>"
44570 msgstr "C<HKEY_USERS\\I<користувач>>"
44571
44572 #. type: textblock
44573 #: ../tools/virt-win-reg.pl:581
44574 msgid ""
44575 "where I<username> is a local user name (this is a libguestfs extension)."
44576 msgstr ""
44577
44578 #. type: textblock
44579 #: ../tools/virt-win-reg.pl:585
44580 msgid ""
44581 "You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for "
44582 "C<HKEY_USERS>."
44583 msgstr ""
44584
44585 #. type: textblock
44586 #: ../tools/virt-win-reg.pl:588
44587 msgid ""
44588 "The literal keys C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are not "
44589 "supported (there is no \"current user\")."
44590 msgstr ""
44591
44592 #. type: =head1
44593 #: ../tools/virt-win-reg.pl:591
44594 msgid "ENCODING"
44595 msgstr "КОДУВАННЯ"
44596
44597 #. type: textblock
44598 #: ../tools/virt-win-reg.pl:593
44599 msgid ""
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."
44605 msgstr ""
44606
44607 #. type: textblock
44608 #: ../tools/virt-win-reg.pl:599
44609 msgid ""
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:"
44612 msgstr ""
44613
44614 #. type: verbatim
44615 #: ../tools/virt-win-reg.pl:602
44616 #, no-wrap
44617 msgid ""
44618 " iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n"
44619 "\n"
44620 msgstr ""
44621 " iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n"
44622 "\n"
44623
44624 #. type: textblock
44625 #: ../tools/virt-win-reg.pl:604
44626 msgid ""
44627 "To go in the opposite direction, after exporting and before sending the file "
44628 "to a Windows user, do something like this:"
44629 msgstr ""
44630
44631 #. type: verbatim
44632 #: ../tools/virt-win-reg.pl:607
44633 #, no-wrap
44634 msgid ""
44635 " unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n"
44636 "\n"
44637 msgstr ""
44638 " unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n"
44639 "\n"
44640
44641 #. type: textblock
44642 #: ../tools/virt-win-reg.pl:609
44643 msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>."
44644 msgstr ""
44645
44646 #. type: textblock
44647 #: ../tools/virt-win-reg.pl:611
44648 msgid ""
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:"
44652 msgstr ""
44653
44654 #. type: verbatim
44655 #: ../tools/virt-win-reg.pl:615
44656 #, no-wrap
44657 msgid ""
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"
44661 "\n"
44662 msgstr ""
44663
44664 #. type: textblock
44665 #: ../tools/virt-win-reg.pl:619
44666 msgid "This file would need conversion before you could I<--merge> it."
44667 msgstr ""
44668
44669 #. type: =head1
44670 #: ../tools/virt-win-reg.pl:621
44671 msgid "CurrentControlSet etc."
44672 msgstr ""
44673
44674 #. type: textblock
44675 #: ../tools/virt-win-reg.pl:623
44676 msgid ""
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 "
44679 "these."
44680 msgstr ""
44681
44682 #. type: textblock
44683 #: ../tools/virt-win-reg.pl:627
44684 msgid ""
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:"
44688 msgstr ""
44689
44690 #. type: verbatim
44691 #: ../tools/virt-win-reg.pl:631
44692 #, no-wrap
44693 msgid ""
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"
44700 "\n"
44701 msgstr ""
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"
44708 "\n"
44709
44710 #. type: textblock
44711 #: ../tools/virt-win-reg.pl:638
44712 msgid "\"Current\" is the one which Windows will choose when it boots."
44713 msgstr ""
44714
44715 #. type: textblock
44716 #: ../tools/virt-win-reg.pl:640
44717 msgid ""
44718 "Similarly, other C<Current...> keys in the path may need to be replaced."
44719 msgstr ""
44720
44721 #. type: =head1
44722 #: ../tools/virt-win-reg.pl:643
44723 msgid "DELETING REGISTRY KEYS AND VALUES"
44724 msgstr ""
44725
44726 #. type: textblock
44727 #: ../tools/virt-win-reg.pl:645
44728 msgid "To delete a whole registry key, use the syntax:"
44729 msgstr ""
44730
44731 #. type: verbatim
44732 #: ../tools/virt-win-reg.pl:647
44733 #, no-wrap
44734 msgid ""
44735 " [-HKEY_LOCAL_MACHINE\\Foo]\n"
44736 "\n"
44737 msgstr ""
44738
44739 #. type: textblock
44740 #: ../tools/virt-win-reg.pl:649
44741 msgid "To delete a single value within a key, use the syntax:"
44742 msgstr ""
44743
44744 #. type: verbatim
44745 #: ../tools/virt-win-reg.pl:651
44746 #, no-wrap
44747 msgid ""
44748 " [HKEY_LOCAL_MACHINE\\Foo]\n"
44749 " \"Value\"=-\n"
44750 "\n"
44751 msgstr ""
44752
44753 #. type: =head1
44754 #: ../tools/virt-win-reg.pl:654
44755 msgid "WINDOWS TIPS"
44756 msgstr ""
44757
44758 #. type: textblock
44759 #: ../tools/virt-win-reg.pl:656
44760 msgid ""
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."
44763 msgstr ""
44764
44765 #. type: =head2
44766 #: ../tools/virt-win-reg.pl:659
44767 msgid "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN"
44768 msgstr ""
44769
44770 #. type: textblock
44771 #: ../tools/virt-win-reg.pl:661
44772 msgid ""
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:\\>:"
44776 msgstr ""
44777
44778 #. type: verbatim
44779 #: ../tools/virt-win-reg.pl:665
44780 #, no-wrap
44781 msgid ""
44782 " guestfish -i -d WindowsGuest upload test.bat /test.bat\n"
44783 "\n"
44784 msgstr ""
44785 " guestfish -i -d WindowsGuest upload test.bat /test.bat\n"
44786 "\n"
44787
44788 #. type: textblock
44789 #: ../tools/virt-win-reg.pl:667
44790 msgid "Prepare a regedit file containing the registry change:"
44791 msgstr ""
44792
44793 #. type: verbatim
44794 #: ../tools/virt-win-reg.pl:669
44795 #, no-wrap
44796 msgid ""
44797 " cat > test.reg <<'EOF'\n"
44798 " [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n"
44799 " \"Test\"=\"c:\\\\test.bat\"\n"
44800 " EOF\n"
44801 "\n"
44802 msgstr ""
44803 " cat > test.reg <<'EOF'\n"
44804 " [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n"
44805 " \"Test\"=\"c:\\\\test.bat\"\n"
44806 " EOF\n"
44807 "\n"
44808
44809 #. type: textblock
44810 #: ../tools/virt-win-reg.pl:674
44811 msgid ""
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>."
44815 msgstr ""
44816
44817 #. type: textblock
44818 #: ../tools/virt-win-reg.pl:678
44819 msgid "Now update the registry:"
44820 msgstr "Оновіть регістр:"
44821
44822 #. type: verbatim
44823 #: ../tools/virt-win-reg.pl:680
44824 #, no-wrap
44825 msgid ""
44826 " virt-win-reg --merge WindowsGuest test.reg\n"
44827 "\n"
44828 msgstr ""
44829
44830 #. type: =head2
44831 #: ../tools/virt-win-reg.pl:682
44832 msgid "INSTALLING A SERVICE"
44833 msgstr ""
44834
44835 #. type: textblock
44836 #: ../tools/virt-win-reg.pl:684
44837 msgid ""
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 "
44841 "free RHSrvAny."
44842 msgstr ""
44843
44844 #. type: textblock
44845 #: ../tools/virt-win-reg.pl:689
44846 msgid ""
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:"
44849 msgstr ""
44850
44851 #. type: verbatim
44852 #: ../tools/virt-win-reg.pl:693
44853 #, no-wrap
44854 msgid ""
44855 " guestfish -i -d WindowsGuest <<EOF\n"
44856 "   upload rhsrvany.exe /rhsrvany.exe\n"
44857 "   upload test.exe /test.exe\n"
44858 " EOF\n"
44859 "\n"
44860 msgstr ""
44861 " guestfish -i -d WindowsGuest <<EOF\n"
44862 "   upload rhsrvany.exe /rhsrvany.exe\n"
44863 "   upload test.exe /test.exe\n"
44864 " EOF\n"
44865 "\n"
44866
44867 #. type: textblock
44868 #: ../tools/virt-win-reg.pl:698
44869 msgid ""
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."
44874 msgstr ""
44875
44876 #. type: verbatim
44877 #: ../tools/virt-win-reg.pl:703
44878 #, no-wrap
44879 msgid ""
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"
44888 " \n"
44889 msgstr ""
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"
44898 " \n"
44899
44900 #. type: verbatim
44901 #: ../tools/virt-win-reg.pl:712
44902 #, no-wrap
44903 msgid ""
44904 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n"
44905 " \"CommandLine\"=\"c:\\\\test.exe\"\n"
44906 " \"PWD\"=\"c:\\\\Temp\"\n"
44907 " EOF\n"
44908 "\n"
44909 msgstr ""
44910 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n"
44911 " \"CommandLine\"=\"c:\\\\test.exe\"\n"
44912 " \"PWD\"=\"c:\\\\Temp\"\n"
44913 " EOF\n"
44914 "\n"
44915
44916 #. type: textblock
44917 #: ../tools/virt-win-reg.pl:723
44918 msgid ""
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 "
44921 "guest."
44922 msgstr ""
44923
44924 #. type: textblock
44925 #: ../tools/virt-win-reg.pl:729
44926 msgid ""
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."
44930 msgstr ""
44931
44932 #. type: textblock
44933 #: ../tools/virt-win-reg.pl:735
44934 msgid ""
44935 "For the meaning of the magic numbers, see this Microsoft KB article: "
44936 "L<http://support.microsoft.com/kb/103000>."
44937 msgstr ""
44938
44939 #. type: textblock
44940 #: ../tools/virt-win-reg.pl:740
44941 msgid "Update the registry:"
44942 msgstr "Оновіть регістр:"
44943
44944 #. type: verbatim
44945 #: ../tools/virt-win-reg.pl:742
44946 #, no-wrap
44947 msgid ""
44948 " virt-win-reg --merge WindowsGuest service.reg\n"
44949 "\n"
44950 msgstr ""
44951
44952 #. type: textblock
44953 #: ../tools/virt-win-reg.pl:746
44954 msgid ""
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."
44958 msgstr ""
44959
44960 #. type: textblock
44961 #: ../tools/virt-win-reg.pl:750
44962 msgid "Paths and value names are case-insensitive."
44963 msgstr ""
44964
44965 #. type: textblock
44966 #: ../tools/virt-win-reg.pl:759
44967 msgid ""
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/>."
44971 msgstr ""
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/>."
44975
44976 #. type: verbatim
44977 #: ../tools/virt-win-reg.pl:777
44978 #, no-wrap
44979 msgid ""
44980 " export LIBGUESTFS_DEBUG=1\n"
44981 " virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n"
44982 "\n"
44983 msgstr ""
44984
44985 #. type: textblock
44986 #: ../tools/virt-win-reg.pl:780
44987 msgid ""
44988 "Attach /tmp/virt-win-reg.log to a new bug report at L<https://bugzilla."
44989 "redhat.com/>"
44990 msgstr ""