configure: Add --with-extra flag to allow setting the extra version string.
[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 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
5 #
6 msgid ""
7 msgstr ""
8 "Project-Id-Version: libguestfs\n"
9 "Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
10 "POT-Creation-Date: 2011-08-17 13:55+0200\n"
11 "PO-Revision-Date: 2011-04-01 15:39+0000\n"
12 "Last-Translator: yurchor <yurchor@ukr.net>\n"
13 "Language-Team: Ukrainian <trans-uk@lists.fedoraproject.org>\n"
14 "Language: uk\n"
15 "MIME-Version: 1.0\n"
16 "Content-Type: text/plain; charset=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
18 "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n"
19 "%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2)\n"
20
21 #. type: =head1
22 #: ../src/guestfs.pod:3 ../fish/guestfish.pod:3
23 #: ../test-tool/libguestfs-test-tool.pod:3 ../fuse/guestmount.pod:3
24 #: ../tools/virt-edit.pl:32 ../tools/virt-win-reg.pl:35
25 #: ../tools/virt-list-filesystems.pl:30 ../tools/virt-tar.pl:31
26 #: ../tools/virt-make-fs.pl:35 ../tools/virt-list-partitions.pl:30
27 msgid "NAME"
28 msgstr "НАЗВА"
29
30 #. type: textblock
31 #: ../src/guestfs.pod:5
32 msgid "guestfs - Library for accessing and modifying virtual machine images"
33 msgstr ""
34 "guestfs — бібліотека для доступу та внесення змін до образів віртуальних "
35 "машин"
36
37 #. type: =head1
38 #: ../src/guestfs.pod:7 ../fish/guestfish.pod:7
39 #: ../test-tool/libguestfs-test-tool.pod:7 ../fuse/guestmount.pod:7
40 #: ../tools/virt-edit.pl:36 ../tools/virt-win-reg.pl:39
41 #: ../tools/virt-list-filesystems.pl:34 ../tools/virt-tar.pl:35
42 #: ../tools/virt-make-fs.pl:39 ../tools/virt-list-partitions.pl:34
43 msgid "SYNOPSIS"
44 msgstr "КОРОТКИЙ ОПИС"
45
46 #. type: verbatim
47 #: ../src/guestfs.pod:9
48 #, no-wrap
49 msgid ""
50 " #include <guestfs.h>\n"
51 " \n"
52 msgstr ""
53 " #include <guestfs.h>\n"
54 " \n"
55
56 #. type: verbatim
57 #: ../src/guestfs.pod:11
58 #, no-wrap
59 msgid ""
60 " guestfs_h *g = guestfs_create ();\n"
61 " guestfs_add_drive (g, \"guest.img\");\n"
62 " guestfs_launch (g);\n"
63 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
64 " guestfs_touch (g, \"/hello\");\n"
65 " guestfs_umount (g, \"/\");\n"
66 " guestfs_close (g);\n"
67 "\n"
68 msgstr ""
69 " guestfs_h *g = guestfs_create ();\n"
70 " guestfs_add_drive (g, \"guest.img\");\n"
71 " guestfs_launch (g);\n"
72 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
73 " guestfs_touch (g, \"/hello\");\n"
74 " guestfs_umount (g, \"/\");\n"
75 " guestfs_close (g);\n"
76 "\n"
77
78 #. type: verbatim
79 #: ../src/guestfs.pod:19
80 #, no-wrap
81 msgid ""
82 " cc prog.c -o prog -lguestfs\n"
83 "or:\n"
84 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
85 "\n"
86 msgstr ""
87 " cc prog.c -o prog -lguestfs\n"
88 "або:\n"
89 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
90 "\n"
91
92 #. type: =head1
93 #: ../src/guestfs.pod:23 ../fish/guestfish.pod:30
94 #: ../test-tool/libguestfs-test-tool.pod:11 ../fuse/guestmount.pod:20
95 #: ../tools/virt-edit.pl:50 ../tools/virt-win-reg.pl:63
96 #: ../tools/virt-list-filesystems.pl:40 ../tools/virt-tar.pl:77
97 #: ../tools/virt-make-fs.pl:47 ../tools/virt-list-partitions.pl:40
98 msgid "DESCRIPTION"
99 msgstr "ОПИС"
100
101 #. type: textblock
102 #: ../src/guestfs.pod:25
103 msgid ""
104 "Libguestfs is a library for accessing and modifying guest disk images.  "
105 "Amongst the things this is good for: making batch configuration changes to "
106 "guests, getting disk used/free statistics (see also: virt-df), migrating "
107 "between virtualization systems (see also: virt-p2v), performing partial "
108 "backups, performing partial guest clones, cloning guests and changing "
109 "registry/UUID/hostname info, and much else besides."
110 msgstr ""
111
112 #. type: textblock
113 #: ../src/guestfs.pod:33
114 msgid ""
115 "Libguestfs uses Linux kernel and qemu code, and can access any type of guest "
116 "filesystem that Linux and qemu can, including but not limited to: ext2/3/4, "
117 "btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, "
118 "qcow2, vmdk."
119 msgstr ""
120
121 #. type: textblock
122 #: ../src/guestfs.pod:38
123 msgid ""
124 "Libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, "
125 "what filesystem is in each LV, etc.).  It can also run commands in the "
126 "context of the guest.  Also you can access filesystems over FUSE."
127 msgstr ""
128
129 #. type: textblock
130 #: ../src/guestfs.pod:43
131 msgid ""
132 "Libguestfs is a library that can be linked with C and C++ management "
133 "programs (or management programs written in OCaml, Perl, Python, Ruby, Java, "
134 "PHP, Haskell or C#).  You can also use it from shell scripts or the command "
135 "line."
136 msgstr ""
137
138 #. type: textblock
139 #: ../src/guestfs.pod:48
140 msgid ""
141 "You don't need to be root to use libguestfs, although obviously you do need "
142 "enough permissions to access the disk images."
143 msgstr ""
144
145 #. type: textblock
146 #: ../src/guestfs.pod:51
147 msgid ""
148 "Libguestfs is a large API because it can do many things.  For a gentle "
149 "introduction, please read the L</API OVERVIEW> section next."
150 msgstr ""
151
152 #. type: textblock
153 #: ../src/guestfs.pod:54
154 msgid ""
155 "There are also some example programs in the L<guestfs-examples(3)> manual "
156 "page."
157 msgstr ""
158
159 #. type: =head1
160 #: ../src/guestfs.pod:57
161 msgid "API OVERVIEW"
162 msgstr "ОГЛЯД API"
163
164 #. type: textblock
165 #: ../src/guestfs.pod:59
166 msgid ""
167 "This section provides a gentler overview of the libguestfs API.  We also try "
168 "to group API calls together, where that may not be obvious from reading "
169 "about the individual calls in the main section of this manual."
170 msgstr ""
171
172 #. type: =head2
173 #: ../src/guestfs.pod:64
174 msgid "HANDLES"
175 msgstr "ОБРОБНИКИ"
176
177 #. type: textblock
178 #: ../src/guestfs.pod:66
179 msgid ""
180 "Before you can use libguestfs calls, you have to create a handle.  Then you "
181 "must add at least one disk image to the handle, followed by launching the "
182 "handle, then performing whatever operations you want, and finally closing "
183 "the handle.  By convention we use the single letter C<g> for the name of the "
184 "handle variable, although of course you can use any name you want."
185 msgstr ""
186
187 #. type: textblock
188 #: ../src/guestfs.pod:73
189 msgid "The general structure of all libguestfs-using programs looks like this:"
190 msgstr ""
191
192 #. type: verbatim
193 #: ../src/guestfs.pod:76
194 #, no-wrap
195 msgid ""
196 " guestfs_h *g = guestfs_create ();\n"
197 " \n"
198 msgstr ""
199 " guestfs_h *g = guestfs_create ();\n"
200 " \n"
201
202 #. type: verbatim
203 #: ../src/guestfs.pod:78
204 #, no-wrap
205 msgid ""
206 " /* Call guestfs_add_drive additional times if there are\n"
207 "  * multiple disk images.\n"
208 "  */\n"
209 " guestfs_add_drive (g, \"guest.img\");\n"
210 " \n"
211 msgstr ""
212
213 #. type: verbatim
214 #: ../src/guestfs.pod:83
215 #, no-wrap
216 msgid ""
217 " /* Most manipulation calls won't work until you've launched\n"
218 "  * the handle 'g'.  You have to do this _after_ adding drives\n"
219 "  * and _before_ other commands.\n"
220 "  */\n"
221 " guestfs_launch (g);\n"
222 " \n"
223 msgstr ""
224
225 #. type: verbatim
226 #: ../src/guestfs.pod:89
227 #, no-wrap
228 msgid ""
229 " /* Now you can examine what partitions, LVs etc are available.\n"
230 "  */\n"
231 " char **partitions = guestfs_list_partitions (g);\n"
232 " char **logvols = guestfs_lvs (g);\n"
233 " \n"
234 msgstr ""
235
236 #. type: verbatim
237 #: ../src/guestfs.pod:94
238 #, no-wrap
239 msgid ""
240 " /* To access a filesystem in the image, you must mount it.\n"
241 "  */\n"
242 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
243 " \n"
244 msgstr ""
245 " /* Щоб отримати доступ до файлової системи на образі, вам слід його змонтувати.\n"
246 "  */\n"
247 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
248 " \n"
249
250 #. type: verbatim
251 #: ../src/guestfs.pod:98
252 #, fuzzy, no-wrap
253 #| msgid ""
254 #| " /* Now you can perform filesystem actions on the guest\n"
255 #| "  * disk image.\n"
256 #| "  */\n"
257 #| " guestfs_touch (g, \"/hello\");\n"
258 #| "\n"
259 msgid ""
260 " /* Now you can perform filesystem actions on the guest\n"
261 "  * disk image.\n"
262 "  */\n"
263 " guestfs_touch (g, \"/hello\");\n"
264 " \n"
265 msgstr ""
266 " /* Тепер ви можете виконувати дії з файловою системою на\n"
267 "  * образі диска операційної системи.\n"
268 "  */\n"
269 " guestfs_touch (g, \"/hello\");\n"
270 "\n"
271
272 #. type: verbatim
273 #: ../src/guestfs.pod:103
274 #, no-wrap
275 msgid ""
276 " /* This is only needed for libguestfs < 1.5.24.  Since then\n"
277 "  * it is done automatically when you close the handle.  See\n"
278 "  * discussion of autosync in this page.\n"
279 "  */\n"
280 " guestfs_sync (g);\n"
281 " \n"
282 msgstr ""
283
284 #. type: verbatim
285 #: ../src/guestfs.pod:109
286 #, no-wrap
287 msgid ""
288 " /* Close the handle 'g'. */\n"
289 " guestfs_close (g);\n"
290 "\n"
291 msgstr ""
292
293 #. type: textblock
294 #: ../src/guestfs.pod:112
295 msgid ""
296 "The code above doesn't include any error checking.  In real code you should "
297 "check return values carefully for errors.  In general all functions that "
298 "return integers return C<-1> on error, and all functions that return "
299 "pointers return C<NULL> on error.  See section L</ERROR HANDLING> below for "
300 "how to handle errors, and consult the documentation for each function call "
301 "below to see precisely how they return error indications.  See L<guestfs-"
302 "examples(3)> for fully worked examples."
303 msgstr ""
304
305 #. type: =head2
306 #: ../src/guestfs.pod:121
307 msgid "DISK IMAGES"
308 msgstr ""
309
310 #. type: textblock
311 #: ../src/guestfs.pod:123
312 msgid ""
313 "The image filename (C<\"guest.img\"> in the example above) could be a disk "
314 "image from a virtual machine, a L<dd(1)> copy of a physical hard disk, an "
315 "actual block device, or simply an empty file of zeroes that you have created "
316 "through L<posix_fallocate(3)>.  Libguestfs lets you do useful things to all "
317 "of these."
318 msgstr ""
319
320 #. type: textblock
321 #: ../src/guestfs.pod:129
322 msgid ""
323 "The call you should use in modern code for adding drives is L</"
324 "guestfs_add_drive_opts>.  To add a disk image, allowing writes, and "
325 "specifying that the format is raw, do:"
326 msgstr ""
327
328 #. type: verbatim
329 #: ../src/guestfs.pod:133
330 #, no-wrap
331 msgid ""
332 " guestfs_add_drive_opts (g, filename,\n"
333 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
334 "                         -1);\n"
335 "\n"
336 msgstr ""
337
338 #. type: textblock
339 #: ../src/guestfs.pod:137
340 msgid "You can add a disk read-only using:"
341 msgstr ""
342
343 #. type: verbatim
344 #: ../src/guestfs.pod:139
345 #, no-wrap
346 msgid ""
347 " guestfs_add_drive_opts (g, filename,\n"
348 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
349 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
350 "                         -1);\n"
351 "\n"
352 msgstr ""
353
354 #. type: textblock
355 #: ../src/guestfs.pod:144
356 msgid ""
357 "or by calling the older function L</guestfs_add_drive_ro>.  In either case "
358 "libguestfs won't modify the file."
359 msgstr ""
360
361 #. type: textblock
362 #: ../src/guestfs.pod:147
363 msgid ""
364 "Be extremely cautious if the disk image is in use, eg. if it is being used "
365 "by a virtual machine.  Adding it read-write will almost certainly cause disk "
366 "corruption, but adding it read-only is safe."
367 msgstr ""
368
369 #. type: textblock
370 #: ../src/guestfs.pod:151
371 msgid ""
372 "You must add at least one disk image, and you may add multiple disk images.  "
373 "In the API, the disk images are usually referred to as C</dev/sda> (for the "
374 "first one you added), C</dev/sdb> (for the second one you added), etc."
375 msgstr ""
376
377 #. type: textblock
378 #: ../src/guestfs.pod:156
379 msgid ""
380 "Once L</guestfs_launch> has been called you cannot add any more images.  You "
381 "can call L</guestfs_list_devices> to get a list of the device names, in the "
382 "order that you added them.  See also L</BLOCK DEVICE NAMING> below."
383 msgstr ""
384
385 #. type: =head2
386 #: ../src/guestfs.pod:161
387 msgid "MOUNTING"
388 msgstr "МОНТУВАННЯ"
389
390 #. type: textblock
391 #: ../src/guestfs.pod:163
392 msgid ""
393 "Before you can read or write files, create directories and so on in a disk "
394 "image that contains filesystems, you have to mount those filesystems using "
395 "L</guestfs_mount_options> or L</guestfs_mount_ro>.  If you already know that "
396 "a disk image contains (for example) one partition with a filesystem on that "
397 "partition, then you can mount it directly:"
398 msgstr ""
399
400 #. type: verbatim
401 #: ../src/guestfs.pod:170
402 #, no-wrap
403 msgid ""
404 " guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n"
405 "\n"
406 msgstr ""
407
408 #. type: textblock
409 #: ../src/guestfs.pod:172
410 msgid ""
411 "where C</dev/sda1> means literally the first partition (C<1>) of the first "
412 "disk image that we added (C</dev/sda>).  If the disk contains Linux LVM2 "
413 "logical volumes you could refer to those instead (eg. C</dev/VG/LV>).  Note "
414 "that these are libguestfs virtual devices, and are nothing to do with host "
415 "devices."
416 msgstr ""
417
418 #. type: textblock
419 #: ../src/guestfs.pod:178
420 msgid ""
421 "If you are given a disk image and you don't know what it contains then you "
422 "have to find out.  Libguestfs can do that too: use L</"
423 "guestfs_list_partitions> and L</guestfs_lvs> to list possible partitions and "
424 "LVs, and either try mounting each to see what is mountable, or else examine "
425 "them with L</guestfs_vfs_type> or L</guestfs_file>.  To list just "
426 "filesystems, use L</guestfs_list_filesystems>."
427 msgstr ""
428
429 #. type: textblock
430 #: ../src/guestfs.pod:186
431 msgid ""
432 "Libguestfs also has a set of APIs for inspection of unknown disk images (see "
433 "L</INSPECTION> below).  But you might find it easier to look at higher level "
434 "programs built on top of libguestfs, in particular L<virt-inspector(1)>."
435 msgstr ""
436
437 #. type: textblock
438 #: ../src/guestfs.pod:191
439 msgid ""
440 "To mount a filesystem read-only, use L</guestfs_mount_ro>.  There are "
441 "several other variations of the C<guestfs_mount_*> call."
442 msgstr ""
443
444 #. type: =head2
445 #: ../src/guestfs.pod:194
446 msgid "FILESYSTEM ACCESS AND MODIFICATION"
447 msgstr ""
448
449 #. type: textblock
450 #: ../src/guestfs.pod:196
451 msgid ""
452 "The majority of the libguestfs API consists of fairly low-level calls for "
453 "accessing and modifying the files, directories, symlinks etc on mounted "
454 "filesystems.  There are over a hundred such calls which you can find listed "
455 "in detail below in this man page, and we don't even pretend to cover them "
456 "all in this overview."
457 msgstr ""
458
459 #. type: textblock
460 #: ../src/guestfs.pod:202
461 msgid ""
462 "Specify filenames as full paths, starting with C<\"/\"> and including the "
463 "mount point."
464 msgstr ""
465
466 #. type: textblock
467 #: ../src/guestfs.pod:205
468 msgid ""
469 "For example, if you mounted a filesystem at C<\"/\"> and you want to read "
470 "the file called C<\"etc/passwd\"> then you could do:"
471 msgstr ""
472
473 #. type: verbatim
474 #: ../src/guestfs.pod:208
475 #, no-wrap
476 msgid ""
477 " char *data = guestfs_cat (g, \"/etc/passwd\");\n"
478 "\n"
479 msgstr ""
480
481 #. type: textblock
482 #: ../src/guestfs.pod:210
483 msgid ""
484 "This would return C<data> as a newly allocated buffer containing the full "
485 "content of that file (with some conditions: see also L</DOWNLOADING> below), "
486 "or C<NULL> if there was an error."
487 msgstr ""
488
489 #. type: textblock
490 #: ../src/guestfs.pod:214
491 msgid ""
492 "As another example, to create a top-level directory on that filesystem "
493 "called C<\"var\"> you would do:"
494 msgstr ""
495
496 #. type: verbatim
497 #: ../src/guestfs.pod:217
498 #, no-wrap
499 msgid ""
500 " guestfs_mkdir (g, \"/var\");\n"
501 "\n"
502 msgstr ""
503
504 #. type: textblock
505 #: ../src/guestfs.pod:219
506 msgid "To create a symlink you could do:"
507 msgstr ""
508
509 #. type: verbatim
510 #: ../src/guestfs.pod:221
511 #, no-wrap
512 msgid ""
513 " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n"
514 "               \"/etc/rc3.d/S30portmap\");\n"
515 "\n"
516 msgstr ""
517
518 #. type: textblock
519 #: ../src/guestfs.pod:224
520 msgid ""
521 "Libguestfs will reject attempts to use relative paths and there is no "
522 "concept of a current working directory."
523 msgstr ""
524
525 #. type: textblock
526 #: ../src/guestfs.pod:227
527 msgid ""
528 "Libguestfs can return errors in many situations: for example if the "
529 "filesystem isn't writable, or if a file or directory that you requested "
530 "doesn't exist.  If you are using the C API (documented here)  you have to "
531 "check for those error conditions after each call.  (Other language bindings "
532 "turn these errors into exceptions)."
533 msgstr ""
534
535 #. type: textblock
536 #: ../src/guestfs.pod:233
537 msgid ""
538 "File writes are affected by the per-handle umask, set by calling L</"
539 "guestfs_umask> and defaulting to 022.  See L</UMASK>."
540 msgstr ""
541
542 #. type: =head2
543 #: ../src/guestfs.pod:236
544 msgid "PARTITIONING"
545 msgstr "ПОДІЛ НА РОЗДІЛИ"
546
547 #. type: textblock
548 #: ../src/guestfs.pod:238
549 msgid ""
550 "Libguestfs contains API calls to read, create and modify partition tables on "
551 "disk images."
552 msgstr ""
553
554 #. type: textblock
555 #: ../src/guestfs.pod:241
556 msgid ""
557 "In the common case where you want to create a single partition covering the "
558 "whole disk, you should use the L</guestfs_part_disk> call:"
559 msgstr ""
560
561 #. type: verbatim
562 #: ../src/guestfs.pod:245
563 #, no-wrap
564 msgid ""
565 " const char *parttype = \"mbr\";\n"
566 " if (disk_is_larger_than_2TB)\n"
567 "   parttype = \"gpt\";\n"
568 " guestfs_part_disk (g, \"/dev/sda\", parttype);\n"
569 "\n"
570 msgstr ""
571
572 #. type: textblock
573 #: ../src/guestfs.pod:250
574 msgid ""
575 "Obviously this effectively wipes anything that was on that disk image before."
576 msgstr ""
577
578 #. type: =head2
579 #: ../src/guestfs.pod:253
580 msgid "LVM2"
581 msgstr "LVM2"
582
583 #. type: textblock
584 #: ../src/guestfs.pod:255
585 msgid ""
586 "Libguestfs provides access to a large part of the LVM2 API, such as L</"
587 "guestfs_lvcreate> and L</guestfs_vgremove>.  It won't make much sense unless "
588 "you familiarize yourself with the concepts of physical volumes, volume "
589 "groups and logical volumes."
590 msgstr ""
591
592 #. type: textblock
593 #: ../src/guestfs.pod:260
594 msgid ""
595 "This author strongly recommends reading the LVM HOWTO, online at L<http://"
596 "tldp.org/HOWTO/LVM-HOWTO/>."
597 msgstr ""
598
599 #. type: =head2
600 #: ../src/guestfs.pod:263
601 msgid "DOWNLOADING"
602 msgstr ""
603
604 #. type: textblock
605 #: ../src/guestfs.pod:265
606 msgid ""
607 "Use L</guestfs_cat> to download small, text only files.  This call is "
608 "limited to files which are less than 2 MB and which cannot contain any ASCII "
609 "NUL (C<\\0>) characters.  However the API is very simple to use."
610 msgstr ""
611
612 #. type: textblock
613 #: ../src/guestfs.pod:269
614 msgid ""
615 "L</guestfs_read_file> can be used to read files which contain arbitrary 8 "
616 "bit data, since it returns a (pointer, size) pair.  However it is still "
617 "limited to \"small\" files, less than 2 MB."
618 msgstr ""
619
620 #. type: textblock
621 #: ../src/guestfs.pod:273
622 msgid ""
623 "L</guestfs_download> can be used to download any file, with no limits on "
624 "content or size (even files larger than 4 GB)."
625 msgstr ""
626
627 #. type: textblock
628 #: ../src/guestfs.pod:276
629 msgid ""
630 "To download multiple files, see L</guestfs_tar_out> and L</guestfs_tgz_out>."
631 msgstr ""
632
633 #. type: =head2
634 #: ../src/guestfs.pod:279
635 msgid "UPLOADING"
636 msgstr "ВИВАНТАЖЕННЯ"
637
638 #. type: textblock
639 #: ../src/guestfs.pod:281
640 msgid ""
641 "It's often the case that you want to write a file or files to the disk image."
642 msgstr ""
643
644 #. type: textblock
645 #: ../src/guestfs.pod:284
646 msgid ""
647 "To write a small file with fixed content, use L</guestfs_write>.  To create "
648 "a file of all zeroes, use L</guestfs_truncate_size> (sparse) or L</"
649 "guestfs_fallocate64> (with all disk blocks allocated).  There are a variety "
650 "of other functions for creating test files, for example L</guestfs_fill> and "
651 "L</guestfs_fill_pattern>."
652 msgstr ""
653
654 #. type: textblock
655 #: ../src/guestfs.pod:290
656 msgid ""
657 "To upload a single file, use L</guestfs_upload>.  This call has no limits on "
658 "file content or size (even files larger than 4 GB)."
659 msgstr ""
660
661 #. type: textblock
662 #: ../src/guestfs.pod:293
663 msgid ""
664 "To upload multiple files, see L</guestfs_tar_in> and L</guestfs_tgz_in>."
665 msgstr ""
666
667 #. type: textblock
668 #: ../src/guestfs.pod:295
669 msgid ""
670 "However the fastest way to upload I<large numbers of arbitrary files> is to "
671 "turn them into a squashfs or CD ISO (see L<mksquashfs(8)> and L<mkisofs(8)"
672 ">), then attach this using L</guestfs_add_drive_ro>.  If you add the drive "
673 "in a predictable way (eg. adding it last after all other drives) then you "
674 "can get the device name from L</guestfs_list_devices> and mount it directly "
675 "using L</guestfs_mount_ro>.  Note that squashfs images are sometimes non-"
676 "portable between kernel versions, and they don't support labels or UUIDs.  "
677 "If you want to pre-build an image or you need to mount it using a label or "
678 "UUID, use an ISO image instead."
679 msgstr ""
680
681 #. type: =head2
682 #: ../src/guestfs.pod:306
683 msgid "COPYING"
684 msgstr "КОПІЮВАННЯ"
685
686 #. type: textblock
687 #: ../src/guestfs.pod:308
688 msgid ""
689 "There are various different commands for copying between files and devices "
690 "and in and out of the guest filesystem.  These are summarised in the table "
691 "below."
692 msgstr ""
693
694 #. type: =item
695 #: ../src/guestfs.pod:314
696 msgid "B<file> to B<file>"
697 msgstr ""
698
699 #. type: textblock
700 #: ../src/guestfs.pod:316
701 msgid ""
702 "Use L</guestfs_cp> to copy a single file, or L</guestfs_cp_a> to copy "
703 "directories recursively."
704 msgstr ""
705
706 #. type: =item
707 #: ../src/guestfs.pod:319
708 msgid "B<file or device> to B<file or device>"
709 msgstr ""
710
711 #. type: textblock
712 #: ../src/guestfs.pod:321
713 msgid ""
714 "Use L</guestfs_dd> which efficiently uses L<dd(1)> to copy between files and "
715 "devices in the guest."
716 msgstr ""
717
718 #. type: textblock
719 #: ../src/guestfs.pod:324
720 msgid "Example: duplicate the contents of an LV:"
721 msgstr ""
722
723 #. type: verbatim
724 #: ../src/guestfs.pod:326
725 #, no-wrap
726 msgid ""
727 " guestfs_dd (g, \"/dev/VG/Original\", \"/dev/VG/Copy\");\n"
728 "\n"
729 msgstr ""
730
731 #. type: textblock
732 #: ../src/guestfs.pod:328
733 msgid ""
734 "The destination (C</dev/VG/Copy>) must be at least as large as the source "
735 "(C</dev/VG/Original>).  To copy less than the whole source device, use L</"
736 "guestfs_copy_size>."
737 msgstr ""
738
739 #. type: =item
740 #: ../src/guestfs.pod:332
741 msgid "B<file on the host> to B<file or device>"
742 msgstr ""
743
744 #. type: textblock
745 #: ../src/guestfs.pod:334
746 msgid "Use L</guestfs_upload>.  See L</UPLOADING> above."
747 msgstr ""
748
749 #. type: =item
750 #: ../src/guestfs.pod:336
751 msgid "B<file or device> to B<file on the host>"
752 msgstr ""
753
754 #. type: textblock
755 #: ../src/guestfs.pod:338
756 msgid "Use L</guestfs_download>.  See L</DOWNLOADING> above."
757 msgstr ""
758
759 #. type: =head2
760 #: ../src/guestfs.pod:342
761 msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS"
762 msgstr ""
763
764 #. type: textblock
765 #: ../src/guestfs.pod:344
766 msgid ""
767 "Calls like L</guestfs_upload>, L</guestfs_download>, L</guestfs_tar_in>, L</"
768 "guestfs_tar_out> etc appear to only take filenames as arguments, so it "
769 "appears you can only upload and download to files.  However many Un*x-like "
770 "hosts let you use the special device files C</dev/stdin>, C</dev/stdout>, C</"
771 "dev/stderr> and C</dev/fd/N> to read and write from stdin, stdout, stderr, "
772 "and arbitrary file descriptor N."
773 msgstr ""
774
775 #. type: textblock
776 #: ../src/guestfs.pod:352
777 msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:"
778 msgstr ""
779
780 #. type: verbatim
781 #: ../src/guestfs.pod:355
782 #, no-wrap
783 msgid ""
784 " guestfs_download (g, filename, \"/dev/stdout\");\n"
785 "\n"
786 msgstr ""
787
788 #. type: textblock
789 #: ../src/guestfs.pod:357
790 msgid "and you can write tar output to a file descriptor C<fd> by doing:"
791 msgstr ""
792
793 #. type: verbatim
794 #: ../src/guestfs.pod:359
795 #, no-wrap
796 msgid ""
797 " char devfd[64];\n"
798 " snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n"
799 " guestfs_tar_out (g, \"/\", devfd);\n"
800 "\n"
801 msgstr ""
802
803 #. type: =head2
804 #: ../src/guestfs.pod:363
805 msgid "LISTING FILES"
806 msgstr ""
807
808 #. type: textblock
809 #: ../src/guestfs.pod:365
810 msgid ""
811 "L</guestfs_ll> is just designed for humans to read (mainly when using the "
812 "L<guestfish(1)>-equivalent command C<ll>)."
813 msgstr ""
814
815 #. type: textblock
816 #: ../src/guestfs.pod:368
817 msgid ""
818 "L</guestfs_ls> is a quick way to get a list of files in a directory from "
819 "programs, as a flat list of strings."
820 msgstr ""
821
822 #. type: textblock
823 #: ../src/guestfs.pod:371
824 msgid ""
825 "L</guestfs_readdir> is a programmatic way to get a list of files in a "
826 "directory, plus additional information about each one.  It is more "
827 "equivalent to using the L<readdir(3)> call on a local filesystem."
828 msgstr ""
829
830 #. type: textblock
831 #: ../src/guestfs.pod:375
832 msgid ""
833 "L</guestfs_find> and L</guestfs_find0> can be used to recursively list files."
834 msgstr ""
835
836 #. type: =head2
837 #: ../src/guestfs.pod:378
838 msgid "RUNNING COMMANDS"
839 msgstr ""
840
841 #. type: textblock
842 #: ../src/guestfs.pod:380
843 msgid ""
844 "Although libguestfs is primarily an API for manipulating files inside guest "
845 "images, we also provide some limited facilities for running commands inside "
846 "guests."
847 msgstr ""
848
849 #. type: textblock
850 #: ../src/guestfs.pod:384
851 msgid "There are many limitations to this:"
852 msgstr ""
853
854 #. type: =item
855 #: ../src/guestfs.pod:388 ../src/guestfs.pod:393 ../src/guestfs.pod:398
856 #: ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411
857 #: ../src/guestfs.pod:416 ../src/guestfs.pod:421 ../src/guestfs.pod:1064
858 #: ../src/guestfs.pod:1068 ../src/guestfs.pod:1072 ../src/guestfs.pod:1077
859 #: ../src/guestfs.pod:1085 ../src/guestfs.pod:1104 ../src/guestfs.pod:1112
860 #: ../src/guestfs.pod:1134 ../src/guestfs.pod:1138 ../src/guestfs.pod:1142
861 #: ../src/guestfs.pod:1146 ../src/guestfs.pod:1150 ../src/guestfs.pod:1154
862 #: ../src/guestfs.pod:1643 ../src/guestfs.pod:1648 ../src/guestfs.pod:1652
863 #: ../src/guestfs.pod:1753 ../src/guestfs.pod:1758 ../src/guestfs.pod:1762
864 #: ../src/guestfs.pod:1772 ../src/guestfs.pod:2007 ../src/guestfs.pod:2012
865 #: ../src/guestfs.pod:2018 ../src/guestfs.pod:2026 ../src/guestfs.pod:2380
866 #: ../src/guestfs.pod:2386 ../src/guestfs.pod:2391 ../src/guestfs.pod:2397
867 #: ../src/guestfs.pod:2968 ../src/guestfs.pod:2972 ../src/guestfs.pod:2976
868 #: ../src/guestfs.pod:2980 ../src/guestfs-actions.pod:15
869 #: ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:582
870 #: ../src/guestfs-actions.pod:590 ../src/guestfs-actions.pod:597
871 #: ../src/guestfs-actions.pod:604 ../src/guestfs-actions.pod:1602
872 #: ../src/guestfs-actions.pod:1606 ../src/guestfs-actions.pod:1610
873 #: ../src/guestfs-actions.pod:1614 ../src/guestfs-actions.pod:1622
874 #: ../src/guestfs-actions.pod:1626 ../src/guestfs-actions.pod:1630
875 #: ../src/guestfs-actions.pod:1640 ../src/guestfs-actions.pod:1644
876 #: ../src/guestfs-actions.pod:1648 ../src/guestfs-actions.pod:1786
877 #: ../src/guestfs-actions.pod:1790 ../src/guestfs-actions.pod:1795
878 #: ../src/guestfs-actions.pod:1800 ../src/guestfs-actions.pod:1861
879 #: ../src/guestfs-actions.pod:1865 ../src/guestfs-actions.pod:1870
880 #: ../fish/guestfish.pod:443 ../fish/guestfish.pod:447
881 #: ../fish/guestfish.pod:451 ../fish/guestfish.pod:455
882 #: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20
883 #: ../fish/guestfish-actions.pod:385 ../fish/guestfish-actions.pod:393
884 #: ../fish/guestfish-actions.pod:400 ../fish/guestfish-actions.pod:407
885 #: ../fish/guestfish-actions.pod:1074 ../fish/guestfish-actions.pod:1078
886 #: ../fish/guestfish-actions.pod:1082 ../fish/guestfish-actions.pod:1086
887 #: ../fish/guestfish-actions.pod:1094 ../fish/guestfish-actions.pod:1098
888 #: ../fish/guestfish-actions.pod:1102 ../fish/guestfish-actions.pod:1112
889 #: ../fish/guestfish-actions.pod:1116 ../fish/guestfish-actions.pod:1120
890 #: ../fish/guestfish-actions.pod:1210 ../fish/guestfish-actions.pod:1214
891 #: ../fish/guestfish-actions.pod:1219 ../fish/guestfish-actions.pod:1224
892 #: ../fish/guestfish-actions.pod:1266 ../fish/guestfish-actions.pod:1270
893 #: ../fish/guestfish-actions.pod:1275 ../tools/virt-edit.pl:351
894 #: ../tools/virt-edit.pl:356 ../tools/virt-edit.pl:361
895 #: ../tools/virt-edit.pl:372 ../tools/virt-edit.pl:376
896 #: ../tools/virt-win-reg.pl:536 ../tools/virt-win-reg.pl:542
897 #: ../tools/virt-win-reg.pl:548
898 msgid "*"
899 msgstr ""
900
901 #. type: textblock
902 #: ../src/guestfs.pod:390
903 msgid ""
904 "The kernel version that the command runs under will be different from what "
905 "it expects."
906 msgstr ""
907
908 #. type: textblock
909 #: ../src/guestfs.pod:395
910 msgid ""
911 "If the command needs to communicate with daemons, then most likely they "
912 "won't be running."
913 msgstr ""
914
915 #. type: textblock
916 #: ../src/guestfs.pod:400
917 msgid "The command will be running in limited memory."
918 msgstr ""
919
920 #. type: textblock
921 #: ../src/guestfs.pod:404
922 msgid ""
923 "The network may not be available unless you enable it (see L</"
924 "guestfs_set_network>)."
925 msgstr ""
926
927 #. type: textblock
928 #: ../src/guestfs.pod:409
929 msgid "Only supports Linux guests (not Windows, BSD, etc)."
930 msgstr ""
931
932 #. type: textblock
933 #: ../src/guestfs.pod:413
934 msgid ""
935 "Architecture limitations (eg. won't work for a PPC guest on an X86 host)."
936 msgstr ""
937
938 #. type: textblock
939 #: ../src/guestfs.pod:418
940 msgid ""
941 "For SELinux guests, you may need to enable SELinux and load policy first.  "
942 "See L</SELINUX> in this manpage."
943 msgstr ""
944
945 #. type: textblock
946 #: ../src/guestfs.pod:423
947 msgid ""
948 "I<Security:> It is not safe to run commands from untrusted, possibly "
949 "malicious guests.  These commands may attempt to exploit your program by "
950 "sending unexpected output.  They could also try to exploit the Linux kernel "
951 "or qemu provided by the libguestfs appliance.  They could use the network "
952 "provided by the libguestfs appliance to bypass ordinary network partitions "
953 "and firewalls.  They could use the elevated privileges or different SELinux "
954 "context of your program to their advantage."
955 msgstr ""
956
957 #. type: textblock
958 #: ../src/guestfs.pod:432
959 msgid ""
960 "A secure alternative is to use libguestfs to install a \"firstboot\" script "
961 "(a script which runs when the guest next boots normally), and to have this "
962 "script run the commands you want in the normal context of the running guest, "
963 "network security and so on.  For information about other security issues, "
964 "see L</SECURITY>."
965 msgstr ""
966
967 #. type: textblock
968 #: ../src/guestfs.pod:440
969 msgid ""
970 "The two main API calls to run commands are L</guestfs_command> and L</"
971 "guestfs_sh> (there are also variations)."
972 msgstr ""
973
974 #. type: textblock
975 #: ../src/guestfs.pod:443
976 msgid ""
977 "The difference is that L</guestfs_sh> runs commands using the shell, so any "
978 "shell globs, redirections, etc will work."
979 msgstr ""
980
981 #. type: =head2
982 #: ../src/guestfs.pod:446
983 msgid "CONFIGURATION FILES"
984 msgstr "ФАЙЛИ НАЛАШТУВАННЯ"
985
986 #. type: textblock
987 #: ../src/guestfs.pod:448
988 msgid ""
989 "To read and write configuration files in Linux guest filesystems, we "
990 "strongly recommend using Augeas.  For example, Augeas understands how to "
991 "read and write, say, a Linux shadow password file or X.org configuration "
992 "file, and so avoids you having to write that code."
993 msgstr ""
994
995 #. type: textblock
996 #: ../src/guestfs.pod:453
997 msgid ""
998 "The main Augeas calls are bound through the C<guestfs_aug_*> APIs.  We don't "
999 "document Augeas itself here because there is excellent documentation on the "
1000 "L<http://augeas.net/> website."
1001 msgstr ""
1002
1003 #. type: textblock
1004 #: ../src/guestfs.pod:457
1005 msgid ""
1006 "If you don't want to use Augeas (you fool!) then try calling L</"
1007 "guestfs_read_lines> to get the file as a list of lines which you can iterate "
1008 "over."
1009 msgstr ""
1010
1011 #. type: =head2
1012 #: ../src/guestfs.pod:461
1013 msgid "SELINUX"
1014 msgstr "SELINUX"
1015
1016 #. type: textblock
1017 #: ../src/guestfs.pod:463
1018 msgid ""
1019 "We support SELinux guests.  To ensure that labeling happens correctly in "
1020 "SELinux guests, you need to enable SELinux and load the guest's policy:"
1021 msgstr ""
1022
1023 #. type: =item
1024 #: ../src/guestfs.pod:469 ../src/guestfs.pod:1257 ../src/guestfs.pod:1395
1025 #: ../src/guestfs.pod:2425
1026 msgid "1."
1027 msgstr ""
1028
1029 #. type: textblock
1030 #: ../src/guestfs.pod:471
1031 msgid "Before launching, do:"
1032 msgstr ""
1033
1034 #. type: verbatim
1035 #: ../src/guestfs.pod:473
1036 #, no-wrap
1037 msgid ""
1038 " guestfs_set_selinux (g, 1);\n"
1039 "\n"
1040 msgstr ""
1041
1042 #. type: =item
1043 #: ../src/guestfs.pod:475 ../src/guestfs.pod:1261 ../src/guestfs.pod:1399
1044 #: ../src/guestfs.pod:2450
1045 msgid "2."
1046 msgstr ""
1047
1048 #. type: textblock
1049 #: ../src/guestfs.pod:477
1050 msgid ""
1051 "After mounting the guest's filesystem(s), load the policy.  This is best "
1052 "done by running the L<load_policy(8)> command in the guest itself:"
1053 msgstr ""
1054
1055 #. type: verbatim
1056 #: ../src/guestfs.pod:481
1057 #, no-wrap
1058 msgid ""
1059 " guestfs_sh (g, \"/usr/sbin/load_policy\");\n"
1060 "\n"
1061 msgstr ""
1062
1063 #. type: textblock
1064 #: ../src/guestfs.pod:483
1065 msgid ""
1066 "(Older versions of C<load_policy> require you to specify the name of the "
1067 "policy file)."
1068 msgstr ""
1069
1070 #. type: =item
1071 #: ../src/guestfs.pod:486 ../src/guestfs.pod:1405
1072 msgid "3."
1073 msgstr ""
1074
1075 #. type: textblock
1076 #: ../src/guestfs.pod:488
1077 msgid ""
1078 "Optionally, set the security context for the API.  The correct security "
1079 "context to use can only be known by inspecting the guest.  As an example:"
1080 msgstr ""
1081
1082 #. type: verbatim
1083 #: ../src/guestfs.pod:492
1084 #, no-wrap
1085 msgid ""
1086 " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n"
1087 "\n"
1088 msgstr ""
1089
1090 #. type: textblock
1091 #: ../src/guestfs.pod:496
1092 msgid "This will work for running commands and editing existing files."
1093 msgstr ""
1094
1095 #. type: textblock
1096 #: ../src/guestfs.pod:498
1097 msgid ""
1098 "When new files are created, you may need to label them explicitly, for "
1099 "example by running the external command C<restorecon pathname>."
1100 msgstr ""
1101
1102 #. type: =head2
1103 #: ../src/guestfs.pod:502
1104 msgid "UMASK"
1105 msgstr ""
1106
1107 #. type: textblock
1108 #: ../src/guestfs.pod:504
1109 msgid ""
1110 "Certain calls are affected by the current file mode creation mask (the "
1111 "\"umask\").  In particular ones which create files or directories, such as "
1112 "L</guestfs_touch>, L</guestfs_mknod> or L</guestfs_mkdir>.  This affects "
1113 "either the default mode that the file is created with or modifies the mode "
1114 "that you supply."
1115 msgstr ""
1116
1117 #. type: textblock
1118 #: ../src/guestfs.pod:510
1119 msgid ""
1120 "The default umask is C<022>, so files are created with modes such as C<0644> "
1121 "and directories with C<0755>."
1122 msgstr ""
1123
1124 #. type: textblock
1125 #: ../src/guestfs.pod:513
1126 msgid ""
1127 "There are two ways to avoid being affected by umask.  Either set umask to 0 "
1128 "(call C<guestfs_umask (g, 0)> early after launching).  Or call L</"
1129 "guestfs_chmod> after creating each file or directory."
1130 msgstr ""
1131
1132 #. type: textblock
1133 #: ../src/guestfs.pod:517
1134 msgid "For more information about umask, see L<umask(2)>."
1135 msgstr ""
1136
1137 #. type: =head1
1138 #: ../src/guestfs.pod:519 ../fish/guestfish.pod:765
1139 msgid "ENCRYPTED DISKS"
1140 msgstr ""
1141
1142 #. type: textblock
1143 #: ../src/guestfs.pod:521
1144 msgid ""
1145 "Libguestfs allows you to access Linux guests which have been encrypted using "
1146 "whole disk encryption that conforms to the Linux Unified Key Setup (LUKS) "
1147 "standard.  This includes nearly all whole disk encryption systems used by "
1148 "modern Linux guests."
1149 msgstr ""
1150
1151 #. type: textblock
1152 #: ../src/guestfs.pod:527
1153 msgid ""
1154 "Use L</guestfs_vfs_type> to identify LUKS-encrypted block devices (it "
1155 "returns the string C<crypto_LUKS>)."
1156 msgstr ""
1157
1158 #. type: textblock
1159 #: ../src/guestfs.pod:530
1160 msgid ""
1161 "Then open these devices by calling L</guestfs_luks_open>.  Obviously you "
1162 "will require the passphrase!"
1163 msgstr ""
1164
1165 #. type: textblock
1166 #: ../src/guestfs.pod:533
1167 msgid ""
1168 "Opening a LUKS device creates a new device mapper device called C</dev/"
1169 "mapper/mapname> (where C<mapname> is the string you supply to L</"
1170 "guestfs_luks_open>).  Reads and writes to this mapper device are decrypted "
1171 "from and encrypted to the underlying block device respectively."
1172 msgstr ""
1173
1174 #. type: textblock
1175 #: ../src/guestfs.pod:539
1176 msgid ""
1177 "LVM volume groups on the device can be made visible by calling L</"
1178 "guestfs_vgscan> followed by L</guestfs_vg_activate_all>.  The logical volume"
1179 "(s) can now be mounted in the usual way."
1180 msgstr ""
1181
1182 #. type: textblock
1183 #: ../src/guestfs.pod:543
1184 msgid ""
1185 "Use the reverse process to close a LUKS device.  Unmount any logical volumes "
1186 "on it, deactivate the volume groups by caling C<guestfs_vg_activate (g, 0, "
1187 "[\"/dev/VG\"])>.  Then close the mapper device by calling L</"
1188 "guestfs_luks_close> on the C</dev/mapper/mapname> device (I<not> the "
1189 "underlying encrypted block device)."
1190 msgstr ""
1191
1192 #. type: =head2
1193 #: ../src/guestfs.pod:550
1194 msgid "INSPECTION"
1195 msgstr "ПЕРЕВІРКА"
1196
1197 #. type: textblock
1198 #: ../src/guestfs.pod:552
1199 msgid ""
1200 "Libguestfs has APIs for inspecting an unknown disk image to find out if it "
1201 "contains operating systems, an install CD or a live CD.  (These APIs used to "
1202 "be in a separate Perl-only library called L<Sys::Guestfs::Lib(3)> but since "
1203 "version 1.5.3 the most frequently used part of this library has been "
1204 "rewritten in C and moved into the core code)."
1205 msgstr ""
1206
1207 #. type: textblock
1208 #: ../src/guestfs.pod:559
1209 msgid ""
1210 "Add all disks belonging to the unknown virtual machine and call L</"
1211 "guestfs_launch> in the usual way."
1212 msgstr ""
1213
1214 #. type: textblock
1215 #: ../src/guestfs.pod:562
1216 msgid ""
1217 "Then call L</guestfs_inspect_os>.  This function uses other libguestfs calls "
1218 "and certain heuristics, and returns a list of operating systems that were "
1219 "found.  An empty list means none were found.  A single element is the root "
1220 "filesystem of the operating system.  For dual- or multi-boot guests, "
1221 "multiple roots can be returned, each one corresponding to a separate "
1222 "operating system.  (Multi-boot virtual machines are extremely rare in the "
1223 "world of virtualization, but since this scenario can happen, we have built "
1224 "libguestfs to deal with it.)"
1225 msgstr ""
1226
1227 #. type: textblock
1228 #: ../src/guestfs.pod:571
1229 msgid ""
1230 "For each root, you can then call various C<guestfs_inspect_get_*> functions "
1231 "to get additional details about that operating system.  For example, call L</"
1232 "guestfs_inspect_get_type> to return the string C<windows> or C<linux> for "
1233 "Windows and Linux-based operating systems respectively."
1234 msgstr ""
1235
1236 #. type: textblock
1237 #: ../src/guestfs.pod:577
1238 msgid ""
1239 "Un*x-like and Linux-based operating systems usually consist of several "
1240 "filesystems which are mounted at boot time (for example, a separate boot "
1241 "partition mounted on C</boot>).  The inspection rules are able to detect how "
1242 "filesystems correspond to mount points.  Call "
1243 "C<guestfs_inspect_get_mountpoints> to get this mapping.  It might return a "
1244 "hash table like this example:"
1245 msgstr ""
1246
1247 #. type: verbatim
1248 #: ../src/guestfs.pod:584
1249 #, no-wrap
1250 msgid ""
1251 " /boot => /dev/sda1\n"
1252 " /     => /dev/vg_guest/lv_root\n"
1253 " /usr  => /dev/vg_guest/lv_usr\n"
1254 "\n"
1255 msgstr ""
1256
1257 #. type: textblock
1258 #: ../src/guestfs.pod:588
1259 msgid ""
1260 "The caller can then make calls to L</guestfs_mount_options> to mount the "
1261 "filesystems as suggested."
1262 msgstr ""
1263
1264 #. type: textblock
1265 #: ../src/guestfs.pod:591
1266 msgid ""
1267 "Be careful to mount filesystems in the right order (eg. C</> before C</"
1268 "usr>).  Sorting the keys of the hash by length, shortest first, should work."
1269 msgstr ""
1270
1271 #. type: textblock
1272 #: ../src/guestfs.pod:595
1273 msgid ""
1274 "Inspection currently only works for some common operating systems.  "
1275 "Contributors are welcome to send patches for other operating systems that we "
1276 "currently cannot detect."
1277 msgstr ""
1278
1279 #. type: textblock
1280 #: ../src/guestfs.pod:599
1281 msgid ""
1282 "Encrypted disks must be opened before inspection.  See L</ENCRYPTED DISKS> "
1283 "for more details.  The L</guestfs_inspect_os> function just ignores any "
1284 "encrypted devices."
1285 msgstr ""
1286
1287 #. type: textblock
1288 #: ../src/guestfs.pod:603
1289 msgid ""
1290 "A note on the implementation: The call L</guestfs_inspect_os> performs "
1291 "inspection and caches the results in the guest handle.  Subsequent calls to "
1292 "C<guestfs_inspect_get_*> return this cached information, but I<do not> re-"
1293 "read the disks.  If you change the content of the guest disks, you can redo "
1294 "inspection by calling L</guestfs_inspect_os> again.  (L</"
1295 "guestfs_inspect_list_applications> works a little differently from the other "
1296 "calls and does read the disks.  See documentation for that function for "
1297 "details)."
1298 msgstr ""
1299
1300 #. type: =head3
1301 #: ../src/guestfs.pod:612
1302 msgid "INSPECTING INSTALL DISKS"
1303 msgstr ""
1304
1305 #. type: textblock
1306 #: ../src/guestfs.pod:614
1307 msgid ""
1308 "Libguestfs (since 1.9.4) can detect some install disks, install CDs, live "
1309 "CDs and more."
1310 msgstr ""
1311
1312 #. type: textblock
1313 #: ../src/guestfs.pod:617
1314 msgid ""
1315 "Call L</guestfs_inspect_get_format> to return the format of the operating "
1316 "system, which currently can be C<installed> (a regular operating system) or "
1317 "C<installer> (some sort of install disk)."
1318 msgstr ""
1319
1320 #. type: textblock
1321 #: ../src/guestfs.pod:621
1322 msgid ""
1323 "Further information is available about the operating system that can be "
1324 "installed using the regular inspection APIs like L</"
1325 "guestfs_inspect_get_product_name>, L</guestfs_inspect_get_major_version> etc."
1326 msgstr ""
1327
1328 #. type: textblock
1329 #: ../src/guestfs.pod:626
1330 msgid ""
1331 "Some additional information specific to installer disks is also available "
1332 "from the L</guestfs_inspect_is_live>, L</guestfs_inspect_is_netinst> and L</"
1333 "guestfs_inspect_is_multipart> calls."
1334 msgstr ""
1335
1336 #. type: =head2
1337 #: ../src/guestfs.pod:631
1338 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS"
1339 msgstr ""
1340
1341 #. type: textblock
1342 #: ../src/guestfs.pod:633
1343 msgid ""
1344 "Libguestfs can mount NTFS partitions.  It does this using the L<http://www."
1345 "ntfs-3g.org/> driver."
1346 msgstr ""
1347
1348 #. type: =head3
1349 #: ../src/guestfs.pod:636
1350 msgid "DRIVE LETTERS AND PATHS"
1351 msgstr ""
1352
1353 #. type: textblock
1354 #: ../src/guestfs.pod:638
1355 msgid ""
1356 "DOS and Windows still use drive letters, and the filesystems are always "
1357 "treated as case insensitive by Windows itself, and therefore you might find "
1358 "a Windows configuration file referring to a path like C<c:\\windows"
1359 "\\system32>.  When the filesystem is mounted in libguestfs, that directory "
1360 "might be referred to as C</WINDOWS/System32>."
1361 msgstr ""
1362
1363 #. type: textblock
1364 #: ../src/guestfs.pod:644
1365 msgid ""
1366 "Drive letter mappings can be found using inspection (see L</INSPECTION> and "
1367 "L</guestfs_inspect_get_drive_mappings>)"
1368 msgstr ""
1369
1370 #. type: textblock
1371 #: ../src/guestfs.pod:647
1372 msgid ""
1373 "Dealing with separator characters (backslash vs forward slash) is outside "
1374 "the scope of libguestfs, but usually a simple character replacement will "
1375 "work."
1376 msgstr ""
1377
1378 #. type: textblock
1379 #: ../src/guestfs.pod:651
1380 msgid ""
1381 "To resolve the case insensitivity of paths, call L</"
1382 "guestfs_case_sensitive_path>."
1383 msgstr ""
1384
1385 #. type: =head3
1386 #: ../src/guestfs.pod:654
1387 msgid "ACCESSING THE WINDOWS REGISTRY"
1388 msgstr ""
1389
1390 #. type: textblock
1391 #: ../src/guestfs.pod:656
1392 msgid ""
1393 "Libguestfs also provides some help for decoding Windows Registry \"hive\" "
1394 "files, through the library C<hivex> which is part of the libguestfs project "
1395 "although ships as a separate tarball.  You have to locate and download the "
1396 "hive file(s) yourself, and then pass them to C<hivex> functions.  See also "
1397 "the programs L<hivexml(1)>, L<hivexsh(1)>, L<hivexregedit(1)> and L<virt-win-"
1398 "reg(1)> for more help on this issue."
1399 msgstr ""
1400
1401 #. type: =head3
1402 #: ../src/guestfs.pod:664
1403 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS"
1404 msgstr ""
1405
1406 #. type: textblock
1407 #: ../src/guestfs.pod:666
1408 msgid ""
1409 "Ntfs-3g tries to rewrite \"Junction Points\" and NTFS \"symbolic links\" to "
1410 "provide something which looks like a Linux symlink.  The way it tries to do "
1411 "the rewriting is described here:"
1412 msgstr ""
1413
1414 #. type: textblock
1415 #: ../src/guestfs.pod:670
1416 msgid ""
1417 "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-"
1418 "symbolic-links/>"
1419 msgstr ""
1420 "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-"
1421 "symbolic-links/>"
1422
1423 #. type: textblock
1424 #: ../src/guestfs.pod:672
1425 msgid ""
1426 "The essential problem is that ntfs-3g simply does not have enough "
1427 "information to do a correct job.  NTFS links can contain drive letters and "
1428 "references to external device GUIDs that ntfs-3g has no way of resolving.  "
1429 "It is almost certainly the case that libguestfs callers should ignore what "
1430 "ntfs-3g does (ie. don't use L</guestfs_readlink> on NTFS volumes)."
1431 msgstr ""
1432
1433 #. type: textblock
1434 #: ../src/guestfs.pod:679
1435 msgid ""
1436 "Instead if you encounter a symbolic link on an ntfs-3g filesystem, use L</"
1437 "guestfs_lgetxattr> to read the C<system.ntfs_reparse_data> extended "
1438 "attribute, and read the raw reparse data from that (you can find the format "
1439 "documented in various places around the web)."
1440 msgstr ""
1441
1442 #. type: =head3
1443 #: ../src/guestfs.pod:684
1444 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS"
1445 msgstr ""
1446
1447 #. type: textblock
1448 #: ../src/guestfs.pod:686
1449 msgid ""
1450 "There are other useful extended attributes that can be read from ntfs-3g "
1451 "filesystems (using L</guestfs_getxattr>).  See:"
1452 msgstr ""
1453
1454 #. type: textblock
1455 #: ../src/guestfs.pod:689
1456 msgid ""
1457 "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
1458 msgstr ""
1459 "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
1460
1461 #. type: =head2
1462 #: ../src/guestfs.pod:691
1463 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES"
1464 msgstr ""
1465
1466 #. type: textblock
1467 #: ../src/guestfs.pod:693
1468 msgid ""
1469 "Although we don't want to discourage you from using the C API, we will "
1470 "mention here that the same API is also available in other languages."
1471 msgstr ""
1472
1473 #. type: textblock
1474 #: ../src/guestfs.pod:696
1475 msgid ""
1476 "The API is broadly identical in all supported languages.  This means that "
1477 "the C call C<guestfs_add_drive_ro(g,file)> is C<$g-E<gt>add_drive_ro($file)> "
1478 "in Perl, C<g.add_drive_ro(file)> in Python, and C<g#add_drive_ro file> in "
1479 "OCaml.  In other words, a straightforward, predictable isomorphism between "
1480 "each language."
1481 msgstr ""
1482
1483 #. type: textblock
1484 #: ../src/guestfs.pod:702
1485 msgid ""
1486 "Error messages are automatically transformed into exceptions if the language "
1487 "supports it."
1488 msgstr ""
1489
1490 #. type: textblock
1491 #: ../src/guestfs.pod:705
1492 msgid ""
1493 "We don't try to \"object orientify\" parts of the API in OO languages, "
1494 "although contributors are welcome to write higher level APIs above what we "
1495 "provide in their favourite languages if they wish."
1496 msgstr ""
1497
1498 #. type: =item
1499 #: ../src/guestfs.pod:711
1500 msgid "B<C++>"
1501 msgstr "B<C++>"
1502
1503 #. type: textblock
1504 #: ../src/guestfs.pod:713
1505 msgid ""
1506 "You can use the I<guestfs.h> header file from C++ programs.  The C++ API is "
1507 "identical to the C API.  C++ classes and exceptions are not used."
1508 msgstr ""
1509
1510 #. type: =item
1511 #: ../src/guestfs.pod:717
1512 msgid "B<C#>"
1513 msgstr "B<C#>"
1514
1515 #. type: textblock
1516 #: ../src/guestfs.pod:719
1517 msgid ""
1518 "The C# bindings are highly experimental.  Please read the warnings at the "
1519 "top of C<csharp/Libguestfs.cs>."
1520 msgstr ""
1521
1522 #. type: =item
1523 #: ../src/guestfs.pod:722
1524 msgid "B<Haskell>"
1525 msgstr "B<Haskell>"
1526
1527 #. type: textblock
1528 #: ../src/guestfs.pod:724
1529 msgid ""
1530 "This is the only language binding that is working but incomplete.  Only "
1531 "calls which return simple integers have been bound in Haskell, and we are "
1532 "looking for help to complete this binding."
1533 msgstr ""
1534
1535 #. type: =item
1536 #: ../src/guestfs.pod:728
1537 msgid "B<Java>"
1538 msgstr "B<Java>"
1539
1540 #. type: textblock
1541 #: ../src/guestfs.pod:730
1542 msgid ""
1543 "Full documentation is contained in the Javadoc which is distributed with "
1544 "libguestfs."
1545 msgstr ""
1546
1547 #. type: =item
1548 #: ../src/guestfs.pod:733
1549 msgid "B<OCaml>"
1550 msgstr "B<OCaml>"
1551
1552 #. type: textblock
1553 #: ../src/guestfs.pod:735
1554 msgid "See L<guestfs-ocaml(3)>."
1555 msgstr "Див. L<guestfs-ocaml(3)>."
1556
1557 #. type: =item
1558 #: ../src/guestfs.pod:737
1559 msgid "B<Perl>"
1560 msgstr "B<Perl>"
1561
1562 #. type: textblock
1563 #: ../src/guestfs.pod:739
1564 msgid "See L<guestfs-perl(3)> and L<Sys::Guestfs(3)>."
1565 msgstr "Див. L<guestfs-perl(3)> та L<Sys::Guestfs(3)>."
1566
1567 #. type: =item
1568 #: ../src/guestfs.pod:741
1569 msgid "B<PHP>"
1570 msgstr "B<PHP>"
1571
1572 #. type: textblock
1573 #: ../src/guestfs.pod:743
1574 msgid ""
1575 "For documentation see C<README-PHP> supplied with libguestfs sources or in "
1576 "the php-libguestfs package for your distribution."
1577 msgstr ""
1578
1579 #. type: textblock
1580 #: ../src/guestfs.pod:746
1581 msgid "The PHP binding only works correctly on 64 bit machines."
1582 msgstr ""
1583
1584 #. type: =item
1585 #: ../src/guestfs.pod:748
1586 msgid "B<Python>"
1587 msgstr "B<Python>"
1588
1589 #. type: textblock
1590 #: ../src/guestfs.pod:750
1591 msgid "See L<guestfs-python(3)>."
1592 msgstr "Див. L<guestfs-python(3)>."
1593
1594 #. type: =item
1595 #: ../src/guestfs.pod:752
1596 msgid "B<Ruby>"
1597 msgstr "B<Ruby>"
1598
1599 #. type: textblock
1600 #: ../src/guestfs.pod:754
1601 msgid "See L<guestfs-ruby(3)>."
1602 msgstr "Див. L<guestfs-ruby(3)>."
1603
1604 #. type: =item
1605 #: ../src/guestfs.pod:756
1606 msgid "B<shell scripts>"
1607 msgstr "B<скрипти оболонки>"
1608
1609 #. type: textblock
1610 #: ../src/guestfs.pod:758
1611 msgid "See L<guestfish(1)>."
1612 msgstr "Див. L<guestfish(1)>."
1613
1614 #. type: =head2
1615 #: ../src/guestfs.pod:762
1616 msgid "LIBGUESTFS GOTCHAS"
1617 msgstr ""
1618
1619 #. type: textblock
1620 #: ../src/guestfs.pod:764
1621 msgid ""
1622 "L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a "
1623 "system [...] that works in the way it is documented but is counterintuitive "
1624 "and almost invites mistakes.\""
1625 msgstr ""
1626
1627 #. type: textblock
1628 #: ../src/guestfs.pod:768
1629 msgid ""
1630 "Since we developed libguestfs and the associated tools, there are several "
1631 "things we would have designed differently, but are now stuck with for "
1632 "backwards compatibility or other reasons.  If there is ever a libguestfs 2.0 "
1633 "release, you can expect these to change.  Beware of them."
1634 msgstr ""
1635
1636 #. type: =item
1637 #: ../src/guestfs.pod:776
1638 msgid "Autosync / forgetting to sync."
1639 msgstr ""
1640
1641 #. type: textblock
1642 #: ../src/guestfs.pod:778
1643 msgid ""
1644 "I<Update:> Autosync is enabled by default for all API users starting from "
1645 "libguestfs 1.5.24.  This section only applies to older versions."
1646 msgstr ""
1647
1648 #. type: textblock
1649 #: ../src/guestfs.pod:781
1650 msgid ""
1651 "When modifying a filesystem from C or another language, you B<must> unmount "
1652 "all filesystems and call L</guestfs_sync> explicitly before you close the "
1653 "libguestfs handle.  You can also call:"
1654 msgstr ""
1655
1656 #. type: verbatim
1657 #: ../src/guestfs.pod:785
1658 #, no-wrap
1659 msgid ""
1660 " guestfs_set_autosync (g, 1);\n"
1661 "\n"
1662 msgstr ""
1663
1664 #. type: textblock
1665 #: ../src/guestfs.pod:787
1666 msgid ""
1667 "to have the unmount/sync done automatically for you when the handle 'g' is "
1668 "closed.  (This feature is called \"autosync\", L</guestfs_set_autosync> q.v.)"
1669 msgstr ""
1670
1671 #. type: textblock
1672 #: ../src/guestfs.pod:791
1673 msgid ""
1674 "If you forget to do this, then it is entirely possible that your changes "
1675 "won't be written out, or will be partially written, or (very rarely) that "
1676 "you'll get disk corruption."
1677 msgstr ""
1678
1679 #. type: textblock
1680 #: ../src/guestfs.pod:795
1681 msgid ""
1682 "Note that in L<guestfish(3)> autosync is the default.  So quick and dirty "
1683 "guestfish scripts that forget to sync will work just fine, which can make "
1684 "this very puzzling if you are trying to debug a problem."
1685 msgstr ""
1686
1687 #. type: =item
1688 #: ../src/guestfs.pod:799
1689 msgid "Mount option C<-o sync> should not be the default."
1690 msgstr ""
1691
1692 #. type: textblock
1693 #: ../src/guestfs.pod:801
1694 msgid ""
1695 "If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly.  "
1696 "However C<-o sync> does not add any reliability benefit, but does have a "
1697 "very large performance impact."
1698 msgstr ""
1699
1700 #. type: textblock
1701 #: ../src/guestfs.pod:805
1702 msgid ""
1703 "The work around is to use L</guestfs_mount_options> and set the mount "
1704 "options that you actually want to use."
1705 msgstr ""
1706
1707 #. type: =item
1708 #: ../src/guestfs.pod:808
1709 msgid "Read-only should be the default."
1710 msgstr ""
1711
1712 #. type: textblock
1713 #: ../src/guestfs.pod:810
1714 msgid ""
1715 "In L<guestfish(3)>, I<--ro> should be the default, and you should have to "
1716 "specify I<--rw> if you want to make changes to the image."
1717 msgstr ""
1718
1719 #. type: textblock
1720 #: ../src/guestfs.pod:813
1721 msgid "This would reduce the potential to corrupt live VM images."
1722 msgstr ""
1723
1724 #. type: textblock
1725 #: ../src/guestfs.pod:815
1726 msgid ""
1727 "Note that many filesystems change the disk when you just mount and unmount, "
1728 "even if you didn't perform any writes.  You need to use L</"
1729 "guestfs_add_drive_ro> to guarantee that the disk is not changed."
1730 msgstr ""
1731
1732 #. type: =item
1733 #: ../src/guestfs.pod:819
1734 msgid "guestfish command line is hard to use."
1735 msgstr ""
1736
1737 #. type: textblock
1738 #: ../src/guestfs.pod:821
1739 msgid ""
1740 "C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for "
1741 "examination).  It tries to run a guestfish command C<disk.img> which doesn't "
1742 "exist, so it fails.  In earlier versions of guestfish the error message was "
1743 "also unintuitive, but we have corrected this since.  Like the Bourne shell, "
1744 "we should have used C<guestfish -c command> to run commands."
1745 msgstr ""
1746
1747 #. type: =item
1748 #: ../src/guestfs.pod:828
1749 msgid "guestfish megabyte modifiers don't work right on all commands"
1750 msgstr ""
1751
1752 #. type: textblock
1753 #: ../src/guestfs.pod:830
1754 msgid ""
1755 "In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for "
1756 "other modifiers).  What guestfish actually does is to multiply the number "
1757 "part by the modifier part and pass the result to the C API.  However this "
1758 "doesn't work for a few APIs which aren't expecting bytes, but are already "
1759 "expecting some other unit (eg. megabytes)."
1760 msgstr ""
1761
1762 #. type: textblock
1763 #: ../src/guestfs.pod:837
1764 msgid "The most common is L</guestfs_lvcreate>.  The guestfish command:"
1765 msgstr ""
1766
1767 #. type: verbatim
1768 #: ../src/guestfs.pod:839
1769 #, no-wrap
1770 msgid ""
1771 " lvcreate LV VG 100M\n"
1772 "\n"
1773 msgstr ""
1774
1775 #. type: textblock
1776 #: ../src/guestfs.pod:841
1777 msgid ""
1778 "does not do what you might expect.  Instead because L</guestfs_lvcreate> is "
1779 "already expecting megabytes, this tries to create a 100 I<terabyte> (100 "
1780 "megabytes * megabytes) logical volume.  The error message you get from this "
1781 "is also a little obscure."
1782 msgstr ""
1783
1784 #. type: textblock
1785 #: ../src/guestfs.pod:846
1786 msgid ""
1787 "This could be fixed in the generator by specially marking parameters and "
1788 "return values which take bytes or other units."
1789 msgstr ""
1790
1791 #. type: =item
1792 #: ../src/guestfs.pod:849
1793 msgid "Ambiguity between devices and paths"
1794 msgstr ""
1795
1796 #. type: textblock
1797 #: ../src/guestfs.pod:851
1798 msgid ""
1799 "There is a subtle ambiguity in the API between a device name (eg. C</dev/"
1800 "sdb2>) and a similar pathname.  A file might just happen to be called "
1801 "C<sdb2> in the directory C</dev> (consider some non-Unix VM image)."
1802 msgstr ""
1803
1804 #. type: textblock
1805 #: ../src/guestfs.pod:856
1806 msgid ""
1807 "In the current API we usually resolve this ambiguity by having two separate "
1808 "calls, for example L</guestfs_checksum> and L</guestfs_checksum_device>.  "
1809 "Some API calls are ambiguous and (incorrectly) resolve the problem by "
1810 "detecting if the path supplied begins with C</dev/>."
1811 msgstr ""
1812
1813 #. type: textblock
1814 #: ../src/guestfs.pod:862
1815 msgid ""
1816 "To avoid both the ambiguity and the need to duplicate some calls, we could "
1817 "make paths/devices into structured names.  One way to do this would be to "
1818 "use a notation like grub (C<hd(0,0)>), although nobody really likes this "
1819 "aspect of grub.  Another way would be to use a structured type, equivalent "
1820 "to this OCaml type:"
1821 msgstr ""
1822
1823 #. type: verbatim
1824 #: ../src/guestfs.pod:868
1825 #, no-wrap
1826 msgid ""
1827 " type path = Path of string | Device of int | Partition of int * int\n"
1828 "\n"
1829 msgstr ""
1830
1831 #. type: textblock
1832 #: ../src/guestfs.pod:870
1833 msgid "which would allow you to pass arguments like:"
1834 msgstr ""
1835
1836 #. type: verbatim
1837 #: ../src/guestfs.pod:872
1838 #, no-wrap
1839 msgid ""
1840 " Path \"/foo/bar\"\n"
1841 " Device 1            (* /dev/sdb, or perhaps /dev/sda *)\n"
1842 " Partition (1, 2)    (* /dev/sdb2 (or is it /dev/sda2 or /dev/sdb3?) *)\n"
1843 " Path \"/dev/sdb2\"    (* not a device *)\n"
1844 "\n"
1845 msgstr ""
1846
1847 #. type: textblock
1848 #: ../src/guestfs.pod:877
1849 msgid ""
1850 "As you can see there are still problems to resolve even with this "
1851 "representation.  Also consider how it might work in guestfish."
1852 msgstr ""
1853
1854 #. type: =head2
1855 #: ../src/guestfs.pod:882
1856 msgid "KEYS AND PASSPHRASES"
1857 msgstr ""
1858
1859 #. type: textblock
1860 #: ../src/guestfs.pod:884
1861 msgid ""
1862 "Certain libguestfs calls take a parameter that contains sensitive key "
1863 "material, passed in as a C string."
1864 msgstr ""
1865
1866 #. type: textblock
1867 #: ../src/guestfs.pod:887
1868 msgid ""
1869 "In the future we would hope to change the libguestfs implementation so that "
1870 "keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in "
1871 "swap.  However this is I<not> done at the moment, because of the complexity "
1872 "of such an implementation."
1873 msgstr ""
1874
1875 #. type: textblock
1876 #: ../src/guestfs.pod:892
1877 msgid ""
1878 "Therefore you should be aware that any key parameter you pass to libguestfs "
1879 "might end up being written out to the swap partition.  If this is a concern, "
1880 "scrub the swap partition or don't use libguestfs on encrypted devices."
1881 msgstr ""
1882
1883 #. type: =head2
1884 #: ../src/guestfs.pod:897
1885 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS"
1886 msgstr ""
1887
1888 #. type: textblock
1889 #: ../src/guestfs.pod:899
1890 msgid ""
1891 "All high-level libguestfs actions are synchronous.  If you want to use "
1892 "libguestfs asynchronously then you must create a thread."
1893 msgstr ""
1894
1895 #. type: textblock
1896 #: ../src/guestfs.pod:902
1897 msgid ""
1898 "Only use the handle from a single thread.  Either use the handle exclusively "
1899 "from one thread, or provide your own mutex so that two threads cannot issue "
1900 "calls on the same handle at the same time."
1901 msgstr ""
1902
1903 #. type: textblock
1904 #: ../src/guestfs.pod:906
1905 msgid ""
1906 "See the graphical program guestfs-browser for one possible architecture for "
1907 "multithreaded programs using libvirt and libguestfs."
1908 msgstr ""
1909
1910 #. type: =head2
1911 #: ../src/guestfs.pod:909
1912 msgid "PATH"
1913 msgstr "ШЛЯХ"
1914
1915 #. type: textblock
1916 #: ../src/guestfs.pod:911
1917 msgid ""
1918 "Libguestfs needs a supermin appliance, which it finds by looking along an "
1919 "internal path."
1920 msgstr ""
1921
1922 #. type: textblock
1923 #: ../src/guestfs.pod:914
1924 msgid ""
1925 "By default it looks for these in the directory C<$libdir/guestfs> (eg. C</"
1926 "usr/local/lib/guestfs> or C</usr/lib64/guestfs>)."
1927 msgstr ""
1928
1929 #. type: textblock
1930 #: ../src/guestfs.pod:917
1931 msgid ""
1932 "Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> "
1933 "to change the directories that libguestfs will search in.  The value is a "
1934 "colon-separated list of paths.  The current directory is I<not> searched "
1935 "unless the path contains an empty element or C<.>.  For example "
1936 "C<LIBGUESTFS_PATH=:/usr/lib/guestfs> would search the current directory and "
1937 "then C</usr/lib/guestfs>."
1938 msgstr ""
1939
1940 #. type: =head2
1941 #: ../src/guestfs.pod:924
1942 msgid "QEMU WRAPPERS"
1943 msgstr ""
1944
1945 #. type: textblock
1946 #: ../src/guestfs.pod:926
1947 msgid ""
1948 "If you want to compile your own qemu, run qemu from a non-standard location, "
1949 "or pass extra arguments to qemu, then you can write a shell-script wrapper "
1950 "around qemu."
1951 msgstr ""
1952
1953 #. type: textblock
1954 #: ../src/guestfs.pod:930
1955 msgid ""
1956 "There is one important rule to remember: you I<must C<exec qemu>> as the "
1957 "last command in the shell script (so that qemu replaces the shell and "
1958 "becomes the direct child of the libguestfs-using program).  If you don't do "
1959 "this, then the qemu process won't be cleaned up correctly."
1960 msgstr ""
1961
1962 #. type: textblock
1963 #: ../src/guestfs.pod:935
1964 msgid ""
1965 "Here is an example of a wrapper, where I have built my own copy of qemu from "
1966 "source:"
1967 msgstr ""
1968
1969 #. type: verbatim
1970 #: ../src/guestfs.pod:938
1971 #, no-wrap
1972 msgid ""
1973 " #!/bin/sh -\n"
1974 " qemudir=/home/rjones/d/qemu\n"
1975 " exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios \"$@\"\n"
1976 "\n"
1977 msgstr ""
1978
1979 #. type: textblock
1980 #: ../src/guestfs.pod:942
1981 msgid ""
1982 "Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and "
1983 "then use it by setting the LIBGUESTFS_QEMU environment variable.  For "
1984 "example:"
1985 msgstr ""
1986
1987 #. type: verbatim
1988 #: ../src/guestfs.pod:946
1989 #, no-wrap
1990 msgid ""
1991 " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
1992 "\n"
1993 msgstr ""
1994
1995 #. type: textblock
1996 #: ../src/guestfs.pod:948
1997 msgid ""
1998 "Note that libguestfs also calls qemu with the -help and -version options in "
1999 "order to determine features."
2000 msgstr ""
2001
2002 #. type: =head2
2003 #: ../src/guestfs.pod:951
2004 msgid "ATTACHING TO RUNNING DAEMONS"
2005 msgstr ""
2006
2007 #. type: textblock
2008 #: ../src/guestfs.pod:953
2009 msgid ""
2010 "I<Note (1):> This is B<highly experimental> and has a tendency to eat "
2011 "babies.  Use with caution."
2012 msgstr ""
2013
2014 #. type: textblock
2015 #: ../src/guestfs.pod:956
2016 msgid ""
2017 "I<Note (2):> This section explains how to attach to a running daemon from a "
2018 "low level perspective.  For most users, simply using virt tools such as "
2019 "L<guestfish(1)> with the I<--live> option will \"just work\"."
2020 msgstr ""
2021
2022 #. type: =head3
2023 #: ../src/guestfs.pod:960
2024 msgid "Using guestfs_set_attach_method"
2025 msgstr ""
2026
2027 #. type: textblock
2028 #: ../src/guestfs.pod:962
2029 msgid ""
2030 "By calling L</guestfs_set_attach_method> you can change how the library "
2031 "connects to the C<guestfsd> daemon in L</guestfs_launch> (read L</"
2032 "ARCHITECTURE> for some background)."
2033 msgstr ""
2034
2035 #. type: textblock
2036 #: ../src/guestfs.pod:966
2037 msgid ""
2038 "The normal attach method is C<appliance>, where a small appliance is created "
2039 "containing the daemon, and then the library connects to this."
2040 msgstr ""
2041
2042 #. type: textblock
2043 #: ../src/guestfs.pod:969
2044 msgid ""
2045 "Setting attach method to C<unix:I<path>> (where I<path> is the path of a "
2046 "Unix domain socket) causes L</guestfs_launch> to connect to an existing "
2047 "daemon over the Unix domain socket."
2048 msgstr ""
2049
2050 #. type: textblock
2051 #: ../src/guestfs.pod:973
2052 msgid ""
2053 "The normal use for this is to connect to a running virtual machine that "
2054 "contains a C<guestfsd> daemon, and send commands so you can read and write "
2055 "files inside the live virtual machine."
2056 msgstr ""
2057
2058 #. type: =head3
2059 #: ../src/guestfs.pod:977
2060 msgid "Using guestfs_add_domain with live flag"
2061 msgstr ""
2062
2063 #. type: textblock
2064 #: ../src/guestfs.pod:979
2065 msgid ""
2066 "L</guestfs_add_domain> provides some help for getting the correct attach "
2067 "method.  If you pass the C<live> option to this function, then (if the "
2068 "virtual machine is running) it will examine the libvirt XML looking for a "
2069 "virtio-serial channel to connect to:"
2070 msgstr ""
2071
2072 #. type: verbatim
2073 #: ../src/guestfs.pod:985
2074 #, no-wrap
2075 msgid ""
2076 " <domain>\n"
2077 "   ...\n"
2078 "   <devices>\n"
2079 "     ...\n"
2080 "     <channel type='unix'>\n"
2081 "       <source mode='bind' path='/path/to/socket'/>\n"
2082 "       <target type='virtio' name='org.libguestfs.channel.0'/>\n"
2083 "     </channel>\n"
2084 "     ...\n"
2085 "   </devices>\n"
2086 " </domain>\n"
2087 "\n"
2088 msgstr ""
2089
2090 #. type: textblock
2091 #: ../src/guestfs.pod:997
2092 msgid ""
2093 "L</guestfs_add_domain> extracts C</path/to/socket> and sets the attach "
2094 "method to C<unix:/path/to/socket>."
2095 msgstr ""
2096
2097 #. type: textblock
2098 #: ../src/guestfs.pod:1000
2099 msgid ""
2100 "Some of the libguestfs tools (including guestfish) support a I<--live> "
2101 "option which is passed through to L</guestfs_add_domain> thus allowing you "
2102 "to attach to and modify live virtual machines."
2103 msgstr ""
2104
2105 #. type: textblock
2106 #: ../src/guestfs.pod:1004
2107 msgid ""
2108 "The virtual machine needs to have been set up beforehand so that it has the "
2109 "virtio-serial channel and so that guestfsd is running inside it."
2110 msgstr ""
2111
2112 #. type: =head2
2113 #: ../src/guestfs.pod:1008
2114 msgid "ABI GUARANTEE"
2115 msgstr ""
2116
2117 #. type: textblock
2118 #: ../src/guestfs.pod:1010
2119 msgid ""
2120 "We guarantee the libguestfs ABI (binary interface), for public, high-level "
2121 "actions as outlined in this section.  Although we will deprecate some "
2122 "actions, for example if they get replaced by newer calls, we will keep the "
2123 "old actions forever.  This allows you the developer to program in confidence "
2124 "against the libguestfs API."
2125 msgstr ""
2126
2127 #. type: =head2
2128 #: ../src/guestfs.pod:1016
2129 msgid "BLOCK DEVICE NAMING"
2130 msgstr ""
2131
2132 #. type: textblock
2133 #: ../src/guestfs.pod:1018
2134 msgid ""
2135 "In the kernel there is now quite a profusion of schemata for naming block "
2136 "devices (in this context, by I<block device> I mean a physical or virtual "
2137 "hard drive).  The original Linux IDE driver used names starting with C</dev/"
2138 "hd*>.  SCSI devices have historically used a different naming scheme, C</dev/"
2139 "sd*>.  When the Linux kernel I<libata> driver became a popular replacement "
2140 "for the old IDE driver (particularly for SATA devices) those devices also "
2141 "used the C</dev/sd*> scheme.  Additionally we now have virtual machines with "
2142 "paravirtualized drivers.  This has created several different naming systems, "
2143 "such as C</dev/vd*> for virtio disks and C</dev/xvd*> for Xen PV disks."
2144 msgstr ""
2145
2146 #. type: textblock
2147 #: ../src/guestfs.pod:1030
2148 msgid ""
2149 "As discussed above, libguestfs uses a qemu appliance running an embedded "
2150 "Linux kernel to access block devices.  We can run a variety of appliances "
2151 "based on a variety of Linux kernels."
2152 msgstr ""
2153
2154 #. type: textblock
2155 #: ../src/guestfs.pod:1034
2156 msgid ""
2157 "This causes a problem for libguestfs because many API calls use device or "
2158 "partition names.  Working scripts and the recipe (example) scripts that we "
2159 "make available over the internet could fail if the naming scheme changes."
2160 msgstr ""
2161
2162 #. type: textblock
2163 #: ../src/guestfs.pod:1039
2164 msgid ""
2165 "Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>.  "
2166 "Internally C</dev/sd*> names are translated, if necessary, to other names as "
2167 "required.  For example, under RHEL 5 which uses the C</dev/hd*> scheme, any "
2168 "device parameter C</dev/sda2> is translated to C</dev/hda2> transparently."
2169 msgstr ""
2170
2171 #. type: textblock
2172 #: ../src/guestfs.pod:1045
2173 msgid ""
2174 "Note that this I<only> applies to parameters.  The L</guestfs_list_devices>, "
2175 "L</guestfs_list_partitions> and similar calls return the true names of the "
2176 "devices and partitions as known to the appliance."
2177 msgstr ""
2178
2179 #. type: =head3
2180 #: ../src/guestfs.pod:1050
2181 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION"
2182 msgstr ""
2183
2184 #. type: textblock
2185 #: ../src/guestfs.pod:1052
2186 msgid ""
2187 "Usually this translation is transparent.  However in some (very rare)  cases "
2188 "you may need to know the exact algorithm.  Such cases include where you use "
2189 "L</guestfs_config> to add a mixture of virtio and IDE devices to the qemu-"
2190 "based appliance, so have a mixture of C</dev/sd*> and C</dev/vd*> devices."
2191 msgstr ""
2192
2193 #. type: textblock
2194 #: ../src/guestfs.pod:1058
2195 msgid ""
2196 "The algorithm is applied only to I<parameters> which are known to be either "
2197 "device or partition names.  Return values from functions such as L</"
2198 "guestfs_list_devices> are never changed."
2199 msgstr ""
2200
2201 #. type: textblock
2202 #: ../src/guestfs.pod:1066
2203 msgid "Is the string a parameter which is a device or partition name?"
2204 msgstr ""
2205
2206 #. type: textblock
2207 #: ../src/guestfs.pod:1070
2208 msgid "Does the string begin with C</dev/sd>?"
2209 msgstr ""
2210
2211 #. type: textblock
2212 #: ../src/guestfs.pod:1074
2213 msgid ""
2214 "Does the named device exist? If so, we use that device.  However if I<not> "
2215 "then we continue with this algorithm."
2216 msgstr ""
2217
2218 #. type: textblock
2219 #: ../src/guestfs.pod:1079
2220 msgid "Replace initial C</dev/sd> string with C</dev/hd>."
2221 msgstr ""
2222
2223 #. type: textblock
2224 #: ../src/guestfs.pod:1081
2225 msgid "For example, change C</dev/sda2> to C</dev/hda2>."
2226 msgstr ""
2227
2228 #. type: textblock
2229 #: ../src/guestfs.pod:1083
2230 msgid "If that named device exists, use it.  If not, continue."
2231 msgstr ""
2232
2233 #. type: textblock
2234 #: ../src/guestfs.pod:1087
2235 msgid "Replace initial C</dev/sd> string with C</dev/vd>."
2236 msgstr ""
2237
2238 #. type: textblock
2239 #: ../src/guestfs.pod:1089
2240 msgid "If that named device exists, use it.  If not, return an error."
2241 msgstr ""
2242
2243 #. type: =head3
2244 #: ../src/guestfs.pod:1093
2245 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING"
2246 msgstr ""
2247
2248 #. type: textblock
2249 #: ../src/guestfs.pod:1095
2250 msgid ""
2251 "Although the standard naming scheme and automatic translation is useful for "
2252 "simple programs and guestfish scripts, for larger programs it is best not to "
2253 "rely on this mechanism."
2254 msgstr ""
2255
2256 #. type: textblock
2257 #: ../src/guestfs.pod:1099
2258 msgid ""
2259 "Where possible for maximum future portability programs using libguestfs "
2260 "should use these future-proof techniques:"
2261 msgstr ""
2262
2263 #. type: textblock
2264 #: ../src/guestfs.pod:1106
2265 msgid ""
2266 "Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual "
2267 "device names, and then use those names directly."
2268 msgstr ""
2269
2270 #. type: textblock
2271 #: ../src/guestfs.pod:1109
2272 msgid ""
2273 "Since those device names exist by definition, they will never be translated."
2274 msgstr ""
2275
2276 #. type: textblock
2277 #: ../src/guestfs.pod:1114
2278 msgid ""
2279 "Use higher level ways to identify filesystems, such as LVM names, UUIDs and "
2280 "filesystem labels."
2281 msgstr ""
2282
2283 #. type: =head1
2284 #: ../src/guestfs.pod:1119
2285 msgid "SECURITY"
2286 msgstr "БЕЗПЕКА"
2287
2288 #. type: textblock
2289 #: ../src/guestfs.pod:1121
2290 msgid ""
2291 "This section discusses security implications of using libguestfs, "
2292 "particularly with untrusted or malicious guests or disk images."
2293 msgstr ""
2294
2295 #. type: =head2
2296 #: ../src/guestfs.pod:1124
2297 msgid "GENERAL SECURITY CONSIDERATIONS"
2298 msgstr ""
2299
2300 #. type: textblock
2301 #: ../src/guestfs.pod:1126
2302 msgid ""
2303 "Be careful with any files or data that you download from a guest (by "
2304 "\"download\" we mean not just the L</guestfs_download> command but any "
2305 "command that reads files, filenames, directories or anything else from a "
2306 "disk image).  An attacker could manipulate the data to fool your program "
2307 "into doing the wrong thing.  Consider cases such as:"
2308 msgstr ""
2309
2310 #. type: textblock
2311 #: ../src/guestfs.pod:1136
2312 msgid "the data (file etc) not being present"
2313 msgstr ""
2314
2315 #. type: textblock
2316 #: ../src/guestfs.pod:1140
2317 msgid "being present but empty"
2318 msgstr ""
2319
2320 #. type: textblock
2321 #: ../src/guestfs.pod:1144
2322 msgid "being much larger than normal"
2323 msgstr ""
2324
2325 #. type: textblock
2326 #: ../src/guestfs.pod:1148
2327 msgid "containing arbitrary 8 bit data"
2328 msgstr ""
2329
2330 #. type: textblock
2331 #: ../src/guestfs.pod:1152
2332 msgid "being in an unexpected character encoding"
2333 msgstr ""
2334
2335 #. type: textblock
2336 #: ../src/guestfs.pod:1156
2337 msgid "containing homoglyphs."
2338 msgstr ""
2339
2340 #. type: =head2
2341 #: ../src/guestfs.pod:1160
2342 msgid "SECURITY OF MOUNTING FILESYSTEMS"
2343 msgstr ""
2344
2345 #. type: textblock
2346 #: ../src/guestfs.pod:1162
2347 msgid ""
2348 "When you mount a filesystem under Linux, mistakes in the kernel filesystem "
2349 "(VFS) module can sometimes be escalated into exploits by deliberately "
2350 "creating a malicious, malformed filesystem.  These exploits are very severe "
2351 "for two reasons.  Firstly there are very many filesystem drivers in the "
2352 "kernel, and many of them are infrequently used and not much developer "
2353 "attention has been paid to the code.  Linux userspace helps potential "
2354 "crackers by detecting the filesystem type and automatically choosing the "
2355 "right VFS driver, even if that filesystem type is obscure or unexpected for "
2356 "the administrator.  Secondly, a kernel-level exploit is like a local root "
2357 "exploit (worse in some ways), giving immediate and total access to the "
2358 "system right down to the hardware level."
2359 msgstr ""
2360
2361 #. type: textblock
2362 #: ../src/guestfs.pod:1175
2363 msgid ""
2364 "That explains why you should never mount a filesystem from an untrusted "
2365 "guest on your host kernel.  How about libguestfs? We run a Linux kernel "
2366 "inside a qemu virtual machine, usually running as a non-root user.  The "
2367 "attacker would need to write a filesystem which first exploited the kernel, "
2368 "and then exploited either qemu virtualization (eg. a faulty qemu driver) or "
2369 "the libguestfs protocol, and finally to be as serious as the host kernel "
2370 "exploit it would need to escalate its privileges to root.  This multi-step "
2371 "escalation, performed by a static piece of data, is thought to be extremely "
2372 "hard to do, although we never say 'never' about security issues."
2373 msgstr ""
2374
2375 #. type: textblock
2376 #: ../src/guestfs.pod:1186
2377 msgid ""
2378 "In any case callers can reduce the attack surface by forcing the filesystem "
2379 "type when mounting (use L</guestfs_mount_vfs>)."
2380 msgstr ""
2381
2382 #. type: =head2
2383 #: ../src/guestfs.pod:1189
2384 msgid "PROTOCOL SECURITY"
2385 msgstr ""
2386
2387 #. type: textblock
2388 #: ../src/guestfs.pod:1191
2389 msgid ""
2390 "The protocol is designed to be secure, being based on RFC 4506 (XDR)  with a "
2391 "defined upper message size.  However a program that uses libguestfs must "
2392 "also take care - for example you can write a program that downloads a binary "
2393 "from a disk image and executes it locally, and no amount of protocol "
2394 "security will save you from the consequences."
2395 msgstr ""
2396
2397 #. type: =head2
2398 #: ../src/guestfs.pod:1197
2399 msgid "INSPECTION SECURITY"
2400 msgstr ""
2401
2402 #. type: textblock
2403 #: ../src/guestfs.pod:1199
2404 msgid ""
2405 "Parts of the inspection API (see L</INSPECTION>) return untrusted strings "
2406 "directly from the guest, and these could contain any 8 bit data.  Callers "
2407 "should be careful to escape these before printing them to a structured file "
2408 "(for example, use HTML escaping if creating a web page)."
2409 msgstr ""
2410
2411 #. type: textblock
2412 #: ../src/guestfs.pod:1205
2413 msgid ""
2414 "Guest configuration may be altered in unusual ways by the administrator of "
2415 "the virtual machine, and may not reflect reality (particularly for untrusted "
2416 "or actively malicious guests).  For example we parse the hostname from "
2417 "configuration files like C</etc/sysconfig/network> that we find in the "
2418 "guest, but the guest administrator can easily manipulate these files to "
2419 "provide the wrong hostname."
2420 msgstr ""
2421
2422 #. type: textblock
2423 #: ../src/guestfs.pod:1213
2424 msgid ""
2425 "The inspection API parses guest configuration using two external libraries: "
2426 "Augeas (Linux configuration) and hivex (Windows Registry).  Both are "
2427 "designed to be robust in the face of malicious data, although denial of "
2428 "service attacks are still possible, for example with oversized configuration "
2429 "files."
2430 msgstr ""
2431
2432 #. type: =head2
2433 #: ../src/guestfs.pod:1219
2434 msgid "RUNNING UNTRUSTED GUEST COMMANDS"
2435 msgstr ""
2436
2437 #. type: textblock
2438 #: ../src/guestfs.pod:1221
2439 msgid ""
2440 "Be very cautious about running commands from the guest.  By running a "
2441 "command in the guest, you are giving CPU time to a binary that you do not "
2442 "control, under the same user account as the library, albeit wrapped in qemu "
2443 "virtualization.  More information and alternatives can be found in the "
2444 "section L</RUNNING COMMANDS>."
2445 msgstr ""
2446
2447 #. type: =head2
2448 #: ../src/guestfs.pod:1227
2449 msgid "CVE-2010-3851"
2450 msgstr "CVE-2010-3851"
2451
2452 #. type: textblock
2453 #: ../src/guestfs.pod:1229
2454 msgid "https://bugzilla.redhat.com/642934"
2455 msgstr "https://bugzilla.redhat.com/642934"
2456
2457 #. type: textblock
2458 #: ../src/guestfs.pod:1231
2459 msgid ""
2460 "This security bug concerns the automatic disk format detection that qemu "
2461 "does on disk images."
2462 msgstr ""
2463
2464 #. type: textblock
2465 #: ../src/guestfs.pod:1234
2466 msgid ""
2467 "A raw disk image is just the raw bytes, there is no header.  Other disk "
2468 "images like qcow2 contain a special header.  Qemu deals with this by looking "
2469 "for one of the known headers, and if none is found then assuming the disk "
2470 "image must be raw."
2471 msgstr ""
2472
2473 #. type: textblock
2474 #: ../src/guestfs.pod:1239
2475 msgid ""
2476 "This allows a guest which has been given a raw disk image to write some "
2477 "other header.  At next boot (or when the disk image is accessed by "
2478 "libguestfs) qemu would do autodetection and think the disk image format was, "
2479 "say, qcow2 based on the header written by the guest."
2480 msgstr ""
2481
2482 #. type: textblock
2483 #: ../src/guestfs.pod:1244
2484 msgid ""
2485 "This in itself would not be a problem, but qcow2 offers many features, one "
2486 "of which is to allow a disk image to refer to another image (called the "
2487 "\"backing disk\").  It does this by placing the path to the backing disk "
2488 "into the qcow2 header.  This path is not validated and could point to any "
2489 "host file (eg. \"/etc/passwd\").  The backing disk is then exposed through "
2490 "\"holes\" in the qcow2 disk image, which of course is completely under the "
2491 "control of the attacker."
2492 msgstr ""
2493
2494 #. type: textblock
2495 #: ../src/guestfs.pod:1252
2496 msgid ""
2497 "In libguestfs this is rather hard to exploit except under two circumstances:"
2498 msgstr ""
2499
2500 #. type: textblock
2501 #: ../src/guestfs.pod:1259
2502 msgid "You have enabled the network or have opened the disk in write mode."
2503 msgstr ""
2504
2505 #. type: textblock
2506 #: ../src/guestfs.pod:1263
2507 msgid ""
2508 "You are also running untrusted code from the guest (see L</RUNNING "
2509 "COMMANDS>)."
2510 msgstr ""
2511
2512 #. type: textblock
2513 #: ../src/guestfs.pod:1268
2514 msgid ""
2515 "The way to avoid this is to specify the expected disk format when adding "
2516 "disks (the optional C<format> option to L</guestfs_add_drive_opts>).  You "
2517 "should always do this if the disk is raw format, and it's a good idea for "
2518 "other cases too."
2519 msgstr ""
2520
2521 #. type: textblock
2522 #: ../src/guestfs.pod:1273
2523 msgid ""
2524 "For disks added from libvirt using calls like L</guestfs_add_domain>, the "
2525 "format is fetched from libvirt and passed through."
2526 msgstr ""
2527
2528 #. type: textblock
2529 #: ../src/guestfs.pod:1276
2530 msgid ""
2531 "For libguestfs tools, use the I<--format> command line parameter as "
2532 "appropriate."
2533 msgstr ""
2534
2535 #. type: =head1
2536 #: ../src/guestfs.pod:1279
2537 msgid "CONNECTION MANAGEMENT"
2538 msgstr ""
2539
2540 #. type: =head2
2541 #: ../src/guestfs.pod:1281
2542 msgid "guestfs_h *"
2543 msgstr ""
2544
2545 #. type: textblock
2546 #: ../src/guestfs.pod:1283
2547 msgid ""
2548 "C<guestfs_h> is the opaque type representing a connection handle.  Create a "
2549 "handle by calling L</guestfs_create>.  Call L</guestfs_close> to free the "
2550 "handle and release all resources used."
2551 msgstr ""
2552
2553 #. type: textblock
2554 #: ../src/guestfs.pod:1287
2555 msgid ""
2556 "For information on using multiple handles and threads, see the section L</"
2557 "MULTIPLE HANDLES AND MULTIPLE THREADS> above."
2558 msgstr ""
2559
2560 #. type: =head2
2561 #: ../src/guestfs.pod:1290
2562 msgid "guestfs_create"
2563 msgstr ""
2564
2565 #. type: verbatim
2566 #: ../src/guestfs.pod:1292
2567 #, no-wrap
2568 msgid ""
2569 " guestfs_h *guestfs_create (void);\n"
2570 "\n"
2571 msgstr ""
2572
2573 #. type: textblock
2574 #: ../src/guestfs.pod:1294
2575 msgid "Create a connection handle."
2576 msgstr ""
2577
2578 #. type: textblock
2579 #: ../src/guestfs.pod:1296
2580 msgid ""
2581 "On success this returns a non-NULL pointer to a handle.  On error it returns "
2582 "NULL."
2583 msgstr ""
2584
2585 #. type: textblock
2586 #: ../src/guestfs.pod:1299
2587 msgid ""
2588 "You have to \"configure\" the handle after creating it.  This includes "
2589 "calling L</guestfs_add_drive_opts> (or one of the equivalent calls) on the "
2590 "handle at least once."
2591 msgstr ""
2592
2593 #. type: textblock
2594 #: ../src/guestfs.pod:1303
2595 msgid "After configuring the handle, you have to call L</guestfs_launch>."
2596 msgstr ""
2597
2598 #. type: textblock
2599 #: ../src/guestfs.pod:1305
2600 msgid ""
2601 "You may also want to configure error handling for the handle.  See the L</"
2602 "ERROR HANDLING> section below."
2603 msgstr ""
2604
2605 #. type: =head2
2606 #: ../src/guestfs.pod:1308
2607 msgid "guestfs_close"
2608 msgstr ""
2609
2610 #. type: verbatim
2611 #: ../src/guestfs.pod:1310
2612 #, no-wrap
2613 msgid ""
2614 " void guestfs_close (guestfs_h *g);\n"
2615 "\n"
2616 msgstr ""
2617
2618 #. type: textblock
2619 #: ../src/guestfs.pod:1312
2620 msgid "This closes the connection handle and frees up all resources used."
2621 msgstr ""
2622
2623 #. type: textblock
2624 #: ../src/guestfs.pod:1314
2625 msgid ""
2626 "If autosync was set on the handle and the handle was launched, then this "
2627 "implicitly calls various functions to unmount filesystems and sync the "
2628 "disk.  See L</guestfs_set_autosync> for more details."
2629 msgstr ""
2630
2631 #. type: textblock
2632 #: ../src/guestfs.pod:1318
2633 msgid "If a close callback was set on the handle, then it is called."
2634 msgstr ""
2635
2636 #. type: =head1
2637 #: ../src/guestfs.pod:1320
2638 msgid "ERROR HANDLING"
2639 msgstr "ОБРОБКА ПОМИЛОК"
2640
2641 #. type: textblock
2642 #: ../src/guestfs.pod:1322
2643 msgid ""
2644 "API functions can return errors.  For example, almost all functions that "
2645 "return C<int> will return C<-1> to indicate an error."
2646 msgstr ""
2647
2648 #. type: textblock
2649 #: ../src/guestfs.pod:1325
2650 msgid ""
2651 "Additional information is available for errors: an error message string and "
2652 "optionally an error number (errno) if the thing that failed was a system "
2653 "call."
2654 msgstr ""
2655
2656 #. type: textblock
2657 #: ../src/guestfs.pod:1329
2658 msgid ""
2659 "You can get at the additional information about the last error on the handle "
2660 "by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting "
2661 "up an error handler with L</guestfs_set_error_handler>."
2662 msgstr ""
2663
2664 #. type: textblock
2665 #: ../src/guestfs.pod:1334
2666 msgid ""
2667 "When the handle is created, a default error handler is installed which "
2668 "prints the error message string to C<stderr>.  For small short-running "
2669 "command line programs it is sufficient to do:"
2670 msgstr ""
2671
2672 #. type: verbatim
2673 #: ../src/guestfs.pod:1338
2674 #, no-wrap
2675 msgid ""
2676 " if (guestfs_launch (g) == -1)\n"
2677 "   exit (EXIT_FAILURE);\n"
2678 "\n"
2679 msgstr ""
2680
2681 #. type: textblock
2682 #: ../src/guestfs.pod:1341
2683 msgid ""
2684 "since the default error handler will ensure that an error message has been "
2685 "printed to C<stderr> before the program exits."
2686 msgstr ""
2687
2688 #. type: textblock
2689 #: ../src/guestfs.pod:1344
2690 msgid ""
2691 "For other programs the caller will almost certainly want to install an "
2692 "alternate error handler or do error handling in-line like this:"
2693 msgstr ""
2694
2695 #. type: verbatim
2696 #: ../src/guestfs.pod:1347
2697 #, no-wrap
2698 msgid ""
2699 " g = guestfs_create ();\n"
2700 " \n"
2701 msgstr ""
2702
2703 #. type: verbatim
2704 #: ../src/guestfs.pod:1349
2705 #, no-wrap
2706 msgid ""
2707 " /* This disables the default behaviour of printing errors\n"
2708 "    on stderr. */\n"
2709 " guestfs_set_error_handler (g, NULL, NULL);\n"
2710 " \n"
2711 msgstr ""
2712
2713 #. type: verbatim
2714 #: ../src/guestfs.pod:1353
2715 #, no-wrap
2716 msgid ""
2717 " if (guestfs_launch (g) == -1) {\n"
2718 "   /* Examine the error message and print it etc. */\n"
2719 "   char *msg = guestfs_last_error (g);\n"
2720 "   int errnum = guestfs_last_errno (g);\n"
2721 "   fprintf (stderr, \"%s\\n\", msg);\n"
2722 "   /* ... */\n"
2723 "  }\n"
2724 "\n"
2725 msgstr ""
2726
2727 #. type: textblock
2728 #: ../src/guestfs.pod:1361
2729 msgid ""
2730 "Out of memory errors are handled differently.  The default action is to call "
2731 "L<abort(3)>.  If this is undesirable, then you can set a handler using L</"
2732 "guestfs_set_out_of_memory_handler>."
2733 msgstr ""
2734
2735 #. type: textblock
2736 #: ../src/guestfs.pod:1365
2737 msgid ""
2738 "L</guestfs_create> returns C<NULL> if the handle cannot be created, and "
2739 "because there is no handle if this happens there is no way to get additional "
2740 "error information.  However L</guestfs_create> is supposed to be a "
2741 "lightweight operation which can only fail because of insufficient memory (it "
2742 "returns NULL in this case)."
2743 msgstr ""
2744
2745 #. type: =head2
2746 #: ../src/guestfs.pod:1371
2747 msgid "guestfs_last_error"
2748 msgstr ""
2749
2750 #. type: verbatim
2751 #: ../src/guestfs.pod:1373
2752 #, no-wrap
2753 msgid ""
2754 " const char *guestfs_last_error (guestfs_h *g);\n"
2755 "\n"
2756 msgstr ""
2757
2758 #. type: textblock
2759 #: ../src/guestfs.pod:1375
2760 msgid ""
2761 "This returns the last error message that happened on C<g>.  If there has not "
2762 "been an error since the handle was created, then this returns C<NULL>."
2763 msgstr ""
2764
2765 #. type: textblock
2766 #: ../src/guestfs.pod:1379
2767 msgid ""
2768 "The lifetime of the returned string is until the next error occurs, or L</"
2769 "guestfs_close> is called."
2770 msgstr ""
2771
2772 #. type: =head2
2773 #: ../src/guestfs.pod:1382
2774 msgid "guestfs_last_errno"
2775 msgstr ""
2776
2777 #. type: verbatim
2778 #: ../src/guestfs.pod:1384
2779 #, no-wrap
2780 msgid ""
2781 " int guestfs_last_errno (guestfs_h *g);\n"
2782 "\n"
2783 msgstr ""
2784
2785 #. type: textblock
2786 #: ../src/guestfs.pod:1386
2787 msgid "This returns the last error number (errno) that happened on C<g>."
2788 msgstr ""
2789
2790 #. type: textblock
2791 #: ../src/guestfs.pod:1388
2792 msgid "If successful, an errno integer not equal to zero is returned."
2793 msgstr ""
2794
2795 #. type: textblock
2796 #: ../src/guestfs.pod:1390
2797 msgid ""
2798 "If no error, this returns 0.  This call can return 0 in three situations:"
2799 msgstr ""
2800
2801 #. type: textblock
2802 #: ../src/guestfs.pod:1397
2803 msgid "There has not been any error on the handle."
2804 msgstr ""
2805
2806 #. type: textblock
2807 #: ../src/guestfs.pod:1401
2808 msgid ""
2809 "There has been an error but the errno was meaningless.  This corresponds to "
2810 "the case where the error did not come from a failed system call, but for "
2811 "some other reason."
2812 msgstr ""
2813
2814 #. type: textblock
2815 #: ../src/guestfs.pod:1407
2816 msgid ""
2817 "There was an error from a failed system call, but for some reason the errno "
2818 "was not captured and returned.  This usually indicates a bug in libguestfs."
2819 msgstr ""
2820
2821 #. type: textblock
2822 #: ../src/guestfs.pod:1413
2823 msgid ""
2824 "Libguestfs tries to convert the errno from inside the applicance into a "
2825 "corresponding errno for the caller (not entirely trivial: the appliance "
2826 "might be running a completely different operating system from the library "
2827 "and error numbers are not standardized across Un*xen).  If this could not be "
2828 "done, then the error is translated to C<EINVAL>.  In practice this should "
2829 "only happen in very rare circumstances."
2830 msgstr ""
2831
2832 #. type: =head2
2833 #: ../src/guestfs.pod:1421
2834 msgid "guestfs_set_error_handler"
2835 msgstr ""
2836
2837 #. type: verbatim
2838 #: ../src/guestfs.pod:1423
2839 #, no-wrap
2840 msgid ""
2841 " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
2842 "                                           void *opaque,\n"
2843 "                                           const char *msg);\n"
2844 " void guestfs_set_error_handler (guestfs_h *g,\n"
2845 "                                 guestfs_error_handler_cb cb,\n"
2846 "                                 void *opaque);\n"
2847 "\n"
2848 msgstr ""
2849
2850 #. type: textblock
2851 #: ../src/guestfs.pod:1430
2852 msgid ""
2853 "The callback C<cb> will be called if there is an error.  The parameters "
2854 "passed to the callback are an opaque data pointer and the error message "
2855 "string."
2856 msgstr ""
2857
2858 #. type: textblock
2859 #: ../src/guestfs.pod:1434
2860 msgid ""
2861 "C<errno> is not passed to the callback.  To get that the callback must call "
2862 "L</guestfs_last_errno>."
2863 msgstr ""
2864
2865 #. type: textblock
2866 #: ../src/guestfs.pod:1437
2867 msgid ""
2868 "Note that the message string C<msg> is freed as soon as the callback "
2869 "function returns, so if you want to stash it somewhere you must make your "
2870 "own copy."
2871 msgstr ""
2872
2873 #. type: textblock
2874 #: ../src/guestfs.pod:1441
2875 msgid "The default handler prints messages on C<stderr>."
2876 msgstr ""
2877
2878 #. type: textblock
2879 #: ../src/guestfs.pod:1443
2880 msgid "If you set C<cb> to C<NULL> then I<no> handler is called."
2881 msgstr ""
2882
2883 #. type: =head2
2884 #: ../src/guestfs.pod:1445
2885 msgid "guestfs_get_error_handler"
2886 msgstr ""
2887
2888 #. type: verbatim
2889 #: ../src/guestfs.pod:1447
2890 #, no-wrap
2891 msgid ""
2892 " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
2893 "                                                     void **opaque_rtn);\n"
2894 "\n"
2895 msgstr ""
2896
2897 #. type: textblock
2898 #: ../src/guestfs.pod:1450
2899 msgid "Returns the current error handler callback."
2900 msgstr ""
2901
2902 #. type: =head2
2903 #: ../src/guestfs.pod:1452
2904 msgid "guestfs_set_out_of_memory_handler"
2905 msgstr ""
2906
2907 #. type: verbatim
2908 #: ../src/guestfs.pod:1454
2909 #, no-wrap
2910 msgid ""
2911 " typedef void (*guestfs_abort_cb) (void);\n"
2912 " void guestfs_set_out_of_memory_handler (guestfs_h *g,\n"
2913 "                                         guestfs_abort_cb);\n"
2914 "\n"
2915 msgstr ""
2916
2917 #. type: textblock
2918 #: ../src/guestfs.pod:1458
2919 msgid ""
2920 "The callback C<cb> will be called if there is an out of memory situation.  "
2921 "I<Note this callback must not return>."
2922 msgstr ""
2923
2924 #. type: textblock
2925 #: ../src/guestfs.pod:1461
2926 msgid "The default is to call L<abort(3)>."
2927 msgstr ""
2928
2929 #. type: textblock
2930 #: ../src/guestfs.pod:1463
2931 msgid ""
2932 "You cannot set C<cb> to C<NULL>.  You can't ignore out of memory situations."
2933 msgstr ""
2934
2935 #. type: =head2
2936 #: ../src/guestfs.pod:1466
2937 msgid "guestfs_get_out_of_memory_handler"
2938 msgstr ""
2939
2940 #. type: verbatim
2941 #: ../src/guestfs.pod:1468
2942 #, no-wrap
2943 msgid ""
2944 " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
2945 "\n"
2946 msgstr ""
2947
2948 #. type: textblock
2949 #: ../src/guestfs.pod:1470
2950 msgid "This returns the current out of memory handler."
2951 msgstr ""
2952
2953 #. type: =head1
2954 #: ../src/guestfs.pod:1472
2955 msgid "API CALLS"
2956 msgstr ""
2957
2958 #. type: textblock
2959 #: ../src/guestfs.pod:1474 ../fish/guestfish.pod:1019
2960 msgid "@ACTIONS@"
2961 msgstr "@ACTIONS@"
2962
2963 #. type: =head1
2964 #: ../src/guestfs.pod:1476
2965 msgid "STRUCTURES"
2966 msgstr "СТРУКТУРИ"
2967
2968 #. type: textblock
2969 #: ../src/guestfs.pod:1478
2970 msgid "@STRUCTS@"
2971 msgstr "@STRUCTS@"
2972
2973 #. type: =head1
2974 #: ../src/guestfs.pod:1480
2975 msgid "AVAILABILITY"
2976 msgstr ""
2977
2978 #. type: =head2
2979 #: ../src/guestfs.pod:1482
2980 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE"
2981 msgstr ""
2982
2983 #. type: textblock
2984 #: ../src/guestfs.pod:1484
2985 msgid ""
2986 "Using L</guestfs_available> you can test availability of the following "
2987 "groups of functions.  This test queries the appliance to see if the "
2988 "appliance you are currently using supports the functionality."
2989 msgstr ""
2990
2991 #. type: textblock
2992 #: ../src/guestfs.pod:1489
2993 msgid "@AVAILABILITY@"
2994 msgstr ""
2995
2996 #. type: =head2
2997 #: ../src/guestfs.pod:1491
2998 msgid "GUESTFISH supported COMMAND"
2999 msgstr ""
3000
3001 #. type: textblock
3002 #: ../src/guestfs.pod:1493
3003 msgid ""
3004 "In L<guestfish(3)> there is a handy interactive command C<supported> which "
3005 "prints out the available groups and whether they are supported by this build "
3006 "of libguestfs.  Note however that you have to do C<run> first."
3007 msgstr ""
3008
3009 #. type: =head2
3010 #: ../src/guestfs.pod:1498
3011 msgid "SINGLE CALLS AT COMPILE TIME"
3012 msgstr ""
3013
3014 #. type: textblock
3015 #: ../src/guestfs.pod:1500
3016 msgid ""
3017 "Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API "
3018 "function, such as:"
3019 msgstr ""
3020
3021 #. type: verbatim
3022 #: ../src/guestfs.pod:1503
3023 #, no-wrap
3024 msgid ""
3025 " #define LIBGUESTFS_HAVE_DD 1\n"
3026 "\n"
3027 msgstr ""
3028
3029 #. type: textblock
3030 #: ../src/guestfs.pod:1505
3031 msgid "if L</guestfs_dd> is available."
3032 msgstr ""
3033
3034 #. type: textblock
3035 #: ../src/guestfs.pod:1507
3036 msgid ""
3037 "Before version 1.5.8, if you needed to test whether a single libguestfs "
3038 "function is available at compile time, we recommended using build tools such "
3039 "as autoconf or cmake.  For example in autotools you could use:"
3040 msgstr ""
3041
3042 #. type: verbatim
3043 #: ../src/guestfs.pod:1512
3044 #, no-wrap
3045 msgid ""
3046 " AC_CHECK_LIB([guestfs],[guestfs_create])\n"
3047 " AC_CHECK_FUNCS([guestfs_dd])\n"
3048 "\n"
3049 msgstr ""
3050
3051 #. type: textblock
3052 #: ../src/guestfs.pod:1515
3053 msgid ""
3054 "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined "
3055 "in your program."
3056 msgstr ""
3057
3058 #. type: =head2
3059 #: ../src/guestfs.pod:1518
3060 msgid "SINGLE CALLS AT RUN TIME"
3061 msgstr ""
3062
3063 #. type: textblock
3064 #: ../src/guestfs.pod:1520
3065 msgid ""
3066 "Testing at compile time doesn't guarantee that a function really exists in "
3067 "the library.  The reason is that you might be dynamically linked against a "
3068 "previous I<libguestfs.so> (dynamic library)  which doesn't have the call.  "
3069 "This situation unfortunately results in a segmentation fault, which is a "
3070 "shortcoming of the C dynamic linking system itself."
3071 msgstr ""
3072
3073 #. type: textblock
3074 #: ../src/guestfs.pod:1527
3075 msgid ""
3076 "You can use L<dlopen(3)> to test if a function is available at run time, as "
3077 "in this example program (note that you still need the compile time check as "
3078 "well):"
3079 msgstr ""
3080
3081 #. type: verbatim
3082 #: ../src/guestfs.pod:1531
3083 #, no-wrap
3084 msgid ""
3085 " #include <stdio.h>\n"
3086 " #include <stdlib.h>\n"
3087 " #include <unistd.h>\n"
3088 " #include <dlfcn.h>\n"
3089 " #include <guestfs.h>\n"
3090 " \n"
3091 msgstr ""
3092
3093 #. type: verbatim
3094 #: ../src/guestfs.pod:1537
3095 #, no-wrap
3096 msgid ""
3097 " main ()\n"
3098 " {\n"
3099 " #ifdef LIBGUESTFS_HAVE_DD\n"
3100 "   void *dl;\n"
3101 "   int has_function;\n"
3102 " \n"
3103 msgstr ""
3104
3105 #. type: verbatim
3106 #: ../src/guestfs.pod:1543
3107 #, no-wrap
3108 msgid ""
3109 "   /* Test if the function guestfs_dd is really available. */\n"
3110 "   dl = dlopen (NULL, RTLD_LAZY);\n"
3111 "   if (!dl) {\n"
3112 "     fprintf (stderr, \"dlopen: %s\\n\", dlerror ());\n"
3113 "     exit (EXIT_FAILURE);\n"
3114 "   }\n"
3115 "   has_function = dlsym (dl, \"guestfs_dd\") != NULL;\n"
3116 "   dlclose (dl);\n"
3117 " \n"
3118 msgstr ""
3119
3120 #. type: verbatim
3121 #: ../src/guestfs.pod:1552
3122 #, no-wrap
3123 msgid ""
3124 "   if (!has_function)\n"
3125 "     printf (\"this libguestfs.so does NOT have guestfs_dd function\\n\");\n"
3126 "   else {\n"
3127 "     printf (\"this libguestfs.so has guestfs_dd function\\n\");\n"
3128 "     /* Now it's safe to call\n"
3129 "     guestfs_dd (g, \"foo\", \"bar\");\n"
3130 "     */\n"
3131 "   }\n"
3132 " #else\n"
3133 "   printf (\"guestfs_dd function was not found at compile time\\n\");\n"
3134 " #endif\n"
3135 "  }\n"
3136 "\n"
3137 msgstr ""
3138
3139 #. type: textblock
3140 #: ../src/guestfs.pod:1565
3141 msgid ""
3142 "You may think the above is an awful lot of hassle, and it is.  There are "
3143 "other ways outside of the C linking system to ensure that this kind of "
3144 "incompatibility never arises, such as using package versioning:"
3145 msgstr ""
3146
3147 #. type: verbatim
3148 #: ../src/guestfs.pod:1570
3149 #, no-wrap
3150 msgid ""
3151 " Requires: libguestfs >= 1.0.80\n"
3152 "\n"
3153 msgstr ""
3154
3155 #. type: =head1
3156 #: ../src/guestfs.pod:1572
3157 msgid "CALLS WITH OPTIONAL ARGUMENTS"
3158 msgstr ""
3159
3160 #. type: textblock
3161 #: ../src/guestfs.pod:1574
3162 msgid ""
3163 "A recent feature of the API is the introduction of calls which take optional "
3164 "arguments.  In C these are declared 3 ways.  The main way is as a call which "
3165 "takes variable arguments (ie. C<...>), as in this example:"
3166 msgstr ""
3167
3168 #. type: verbatim
3169 #: ../src/guestfs.pod:1579
3170 #, no-wrap
3171 msgid ""
3172 " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n"
3173 "\n"
3174 msgstr ""
3175
3176 #. type: textblock
3177 #: ../src/guestfs.pod:1581
3178 msgid ""
3179 "Call this with a list of optional arguments, terminated by C<-1>.  So to "
3180 "call with no optional arguments specified:"
3181 msgstr ""
3182
3183 #. type: verbatim
3184 #: ../src/guestfs.pod:1584
3185 #, no-wrap
3186 msgid ""
3187 " guestfs_add_drive_opts (g, filename, -1);\n"
3188 "\n"
3189 msgstr ""
3190
3191 #. type: textblock
3192 #: ../src/guestfs.pod:1586
3193 msgid "With a single optional argument:"
3194 msgstr ""
3195
3196 #. type: verbatim
3197 #: ../src/guestfs.pod:1588
3198 #, no-wrap
3199 msgid ""
3200 " guestfs_add_drive_opts (g, filename,\n"
3201 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3202 "                         -1);\n"
3203 "\n"
3204 msgstr ""
3205
3206 #. type: textblock
3207 #: ../src/guestfs.pod:1592
3208 msgid "With two:"
3209 msgstr ""
3210
3211 #. type: verbatim
3212 #: ../src/guestfs.pod:1594
3213 #, no-wrap
3214 msgid ""
3215 " guestfs_add_drive_opts (g, filename,\n"
3216 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3217 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
3218 "                         -1);\n"
3219 "\n"
3220 msgstr ""
3221
3222 #. type: textblock
3223 #: ../src/guestfs.pod:1599
3224 msgid ""
3225 "and so forth.  Don't forget the terminating C<-1> otherwise Bad Things will "
3226 "happen!"
3227 msgstr ""
3228
3229 #. type: =head2
3230 #: ../src/guestfs.pod:1602
3231 msgid "USING va_list FOR OPTIONAL ARGUMENTS"
3232 msgstr ""
3233
3234 #. type: textblock
3235 #: ../src/guestfs.pod:1604
3236 msgid ""
3237 "The second variant has the same name with the suffix C<_va>, which works the "
3238 "same way but takes a C<va_list>.  See the C manual for details.  For the "
3239 "example function, this is declared:"
3240 msgstr ""
3241
3242 #. type: verbatim
3243 #: ../src/guestfs.pod:1608
3244 #, no-wrap
3245 msgid ""
3246 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
3247 "                                va_list args);\n"
3248 "\n"
3249 msgstr ""
3250
3251 #. type: =head2
3252 #: ../src/guestfs.pod:1611
3253 msgid "CONSTRUCTING OPTIONAL ARGUMENTS"
3254 msgstr ""
3255
3256 #. type: textblock
3257 #: ../src/guestfs.pod:1613
3258 msgid ""
3259 "The third variant is useful where you need to construct these calls.  You "
3260 "pass in a structure where you fill in the optional fields.  The structure "
3261 "has a bitmask as the first element which you must set to indicate which "
3262 "fields you have filled in.  For our example function the structure and call "
3263 "are declared:"
3264 msgstr ""
3265
3266 #. type: verbatim
3267 #: ../src/guestfs.pod:1619
3268 #, no-wrap
3269 msgid ""
3270 " struct guestfs_add_drive_opts_argv {\n"
3271 "   uint64_t bitmask;\n"
3272 "   int readonly;\n"
3273 "   const char *format;\n"
3274 "   /* ... */\n"
3275 " };\n"
3276 " int guestfs_add_drive_opts_argv (guestfs_h *g, const char *filename,\n"
3277 "              const struct guestfs_add_drive_opts_argv *optargs);\n"
3278 "\n"
3279 msgstr ""
3280
3281 #. type: textblock
3282 #: ../src/guestfs.pod:1628
3283 msgid "You could call it like this:"
3284 msgstr ""
3285
3286 #. type: verbatim
3287 #: ../src/guestfs.pod:1630
3288 #, no-wrap
3289 msgid ""
3290 " struct guestfs_add_drive_opts_argv optargs = {\n"
3291 "   .bitmask = GUESTFS_ADD_DRIVE_OPTS_READONLY_BITMASK |\n"
3292 "              GUESTFS_ADD_DRIVE_OPTS_FORMAT_BITMASK,\n"
3293 "   .readonly = 1,\n"
3294 "   .format = \"qcow2\"\n"
3295 " };\n"
3296 " \n"
3297 msgstr ""
3298
3299 #. type: verbatim
3300 #: ../src/guestfs.pod:1637
3301 #, no-wrap
3302 msgid ""
3303 " guestfs_add_drive_opts_argv (g, filename, &optargs);\n"
3304 "\n"
3305 msgstr ""
3306
3307 #. type: textblock
3308 #: ../src/guestfs.pod:1639 ../src/guestfs-actions.pod:11
3309 #: ../src/guestfs-actions.pod:1857 ../fish/guestfish-actions.pod:9
3310 #: ../fish/guestfish-actions.pod:1262 ../tools/virt-win-reg.pl:532
3311 msgid "Notes:"
3312 msgstr "Нотатки:"
3313
3314 #. type: textblock
3315 #: ../src/guestfs.pod:1645
3316 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask."
3317 msgstr ""
3318
3319 #. type: textblock
3320 #: ../src/guestfs.pod:1650
3321 msgid "You do not need to fill in all fields of the structure."
3322 msgstr ""
3323
3324 #. type: textblock
3325 #: ../src/guestfs.pod:1654
3326 msgid ""
3327 "There must be a one-to-one correspondence between fields of the structure "
3328 "that are filled in, and bits set in the bitmask."
3329 msgstr ""
3330
3331 #. type: =head2
3332 #: ../src/guestfs.pod:1659
3333 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES"
3334 msgstr ""
3335
3336 #. type: textblock
3337 #: ../src/guestfs.pod:1661
3338 msgid ""
3339 "In other languages, optional arguments are expressed in the way that is "
3340 "natural for that language.  We refer you to the language-specific "
3341 "documentation for more details on that."
3342 msgstr ""
3343
3344 #. type: textblock
3345 #: ../src/guestfs.pod:1665
3346 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>."
3347 msgstr ""
3348
3349 #. type: =head2
3350 #: ../src/guestfs.pod:1667
3351 msgid "SETTING CALLBACKS TO HANDLE EVENTS"
3352 msgstr ""
3353
3354 #. type: textblock
3355 #: ../src/guestfs.pod:1669
3356 msgid ""
3357 "B<Note:> This section documents the generic event mechanism introduced in "
3358 "libguestfs 1.10, which you should use in new code if possible.  The old "
3359 "functions C<guestfs_set_log_message_callback>, "
3360 "C<guestfs_set_subprocess_quit_callback>, "
3361 "C<guestfs_set_launch_done_callback>, C<guestfs_set_close_callback> and "
3362 "C<guestfs_set_progress_callback> are no longer documented in this manual "
3363 "page."
3364 msgstr ""
3365
3366 #. type: textblock
3367 #: ../src/guestfs.pod:1677
3368 msgid ""
3369 "Handles generate events when certain things happen, such as log messages "
3370 "being generated, progress messages during long-running operations, or the "
3371 "handle being closed.  The API calls described below let you register a "
3372 "callback to be called when events happen.  You can register multiple "
3373 "callbacks (for the same, different or overlapping sets of events), and "
3374 "individually remove callbacks.  If callbacks are not removed, then they "
3375 "remain in force until the handle is closed."
3376 msgstr ""
3377
3378 #. type: textblock
3379 #: ../src/guestfs.pod:1685
3380 msgid ""
3381 "In the current implementation, events are only generated synchronously: that "
3382 "means that events (and hence callbacks) can only happen while you are in the "
3383 "middle of making another libguestfs call.  The callback is called in the "
3384 "same thread."
3385 msgstr ""
3386
3387 #. type: textblock
3388 #: ../src/guestfs.pod:1690
3389 msgid ""
3390 "Events may contain a payload, usually nothing (void), an array of 64 bit "
3391 "unsigned integers, or a message buffer.  Payloads are discussed later on."
3392 msgstr ""
3393
3394 #. type: =head3
3395 #: ../src/guestfs.pod:1694
3396 msgid "CLASSES OF EVENTS"
3397 msgstr ""
3398
3399 #. type: =item
3400 #: ../src/guestfs.pod:1698
3401 msgid "GUESTFS_EVENT_CLOSE (payload type: void)"
3402 msgstr ""
3403
3404 #. type: textblock
3405 #: ../src/guestfs.pod:1701
3406 msgid ""
3407 "The callback function will be called while the handle is being closed "
3408 "(synchronously from L</guestfs_close>)."
3409 msgstr ""
3410
3411 #. type: textblock
3412 #: ../src/guestfs.pod:1704
3413 msgid ""
3414 "Note that libguestfs installs an L<atexit(3)> handler to try to clean up "
3415 "handles that are open when the program exits.  This means that this callback "
3416 "might be called indirectly from L<exit(3)>, which can cause unexpected "
3417 "problems in higher-level languages (eg. if your HLL interpreter has already "
3418 "been cleaned up by the time this is called, and if your callback then jumps "
3419 "into some HLL function)."
3420 msgstr ""
3421
3422 #. type: textblock
3423 #: ../src/guestfs.pod:1711
3424 msgid ""
3425 "If no callback is registered: the handle is closed without any callback "
3426 "being invoked."
3427 msgstr ""
3428
3429 #. type: =item
3430 #: ../src/guestfs.pod:1714
3431 msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)"
3432 msgstr ""
3433
3434 #. type: textblock
3435 #: ../src/guestfs.pod:1717
3436 msgid ""
3437 "The callback function will be called when the child process quits, either "
3438 "asynchronously or if killed by L</guestfs_kill_subprocess>.  (This "
3439 "corresponds to a transition from any state to the CONFIG state)."
3440 msgstr ""
3441
3442 #. type: textblock
3443 #: ../src/guestfs.pod:1721 ../src/guestfs.pod:1730
3444 msgid "If no callback is registered: the event is ignored."
3445 msgstr ""
3446
3447 #. type: =item
3448 #: ../src/guestfs.pod:1723
3449 msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)"
3450 msgstr ""
3451
3452 #. type: textblock
3453 #: ../src/guestfs.pod:1726
3454 msgid ""
3455 "The callback function will be called when the child process becomes ready "
3456 "first time after it has been launched.  (This corresponds to a transition "
3457 "from LAUNCHING to the READY state)."
3458 msgstr ""
3459
3460 #. type: =item
3461 #: ../src/guestfs.pod:1732
3462 msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)"
3463 msgstr ""
3464
3465 #. type: textblock
3466 #: ../src/guestfs.pod:1735
3467 msgid ""
3468 "Some long-running operations can generate progress messages.  If this "
3469 "callback is registered, then it will be called each time a progress message "
3470 "is generated (usually two seconds after the operation started, and three "
3471 "times per second thereafter until it completes, although the frequency may "
3472 "change in future versions)."
3473 msgstr ""
3474
3475 #. type: textblock
3476 #: ../src/guestfs.pod:1741
3477 msgid ""
3478 "The callback receives in the payload four unsigned 64 bit numbers which are "
3479 "(in order): C<proc_nr>, C<serial>, C<position>, C<total>."
3480 msgstr ""
3481
3482 #. type: textblock
3483 #: ../src/guestfs.pod:1744
3484 msgid ""
3485 "The units of C<total> are not defined, although for some operations C<total> "
3486 "may relate in some way to the amount of data to be transferred (eg. in bytes "
3487 "or megabytes), and C<position> may be the portion which has been transferred."
3488 msgstr ""
3489
3490 #. type: textblock
3491 #: ../src/guestfs.pod:1749
3492 msgid "The only defined and stable parts of the API are:"
3493 msgstr ""
3494
3495 #. type: textblock
3496 #: ../src/guestfs.pod:1755
3497 msgid ""
3498 "The callback can display to the user some type of progress bar or indicator "
3499 "which shows the ratio of C<position>:C<total>."
3500 msgstr ""
3501
3502 #. type: textblock
3503 #: ../src/guestfs.pod:1760
3504 msgid "0 E<lt>= C<position> E<lt>= C<total>"
3505 msgstr ""
3506
3507 #. type: textblock
3508 #: ../src/guestfs.pod:1764
3509 msgid ""
3510 "If any progress notification is sent during a call, then a final progress "
3511 "notification is always sent when C<position> = C<total> (I<unless> the call "
3512 "fails with an error)."
3513 msgstr ""
3514
3515 #. type: textblock
3516 #: ../src/guestfs.pod:1768
3517 msgid ""
3518 "This is to simplify caller code, so callers can easily set the progress "
3519 "indicator to \"100%\" at the end of the operation, without requiring special "
3520 "code to detect this case."
3521 msgstr ""
3522
3523 #. type: textblock
3524 #: ../src/guestfs.pod:1774
3525 msgid ""
3526 "For some calls we are unable to estimate the progress of the call, but we "
3527 "can still generate progress messages to indicate activity.  This is known as "
3528 "\"pulse mode\", and is directly supported by certain progress bar "
3529 "implementations (eg. GtkProgressBar)."
3530 msgstr ""
3531
3532 #. type: textblock
3533 #: ../src/guestfs.pod:1779
3534 msgid ""
3535 "For these calls, zero or more progress messages are generated with "
3536 "C<position = 0> and C<total = 1>, followed by a final message with "
3537 "C<position = total = 1>."
3538 msgstr ""
3539
3540 #. type: textblock
3541 #: ../src/guestfs.pod:1783
3542 msgid ""
3543 "As noted above, if the call fails with an error then the final message may "
3544 "not be generated."
3545 msgstr ""
3546
3547 #. type: textblock
3548 #: ../src/guestfs.pod:1788
3549 msgid ""
3550 "The callback also receives the procedure number (C<proc_nr>) and serial "
3551 "number (C<serial>) of the call.  These are only useful for debugging "
3552 "protocol issues, and the callback can normally ignore them.  The callback "
3553 "may want to print these numbers in error messages or debugging messages."
3554 msgstr ""
3555
3556 #. type: textblock
3557 #: ../src/guestfs.pod:1794
3558 msgid "If no callback is registered: progress messages are discarded."
3559 msgstr ""
3560
3561 #. type: =item
3562 #: ../src/guestfs.pod:1796
3563 msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)"
3564 msgstr ""
3565
3566 #. type: textblock
3567 #: ../src/guestfs.pod:1799
3568 msgid ""
3569 "The callback function is called whenever a log message is generated by qemu, "
3570 "the appliance kernel, guestfsd (daemon), or utility programs."
3571 msgstr ""
3572
3573 #. type: textblock
3574 #: ../src/guestfs.pod:1802
3575 msgid ""
3576 "If the verbose flag (L</guestfs_set_verbose>) is set before launch (L</"
3577 "guestfs_launch>) then additional debug messages are generated."
3578 msgstr ""
3579
3580 #. type: textblock
3581 #: ../src/guestfs.pod:1805 ../src/guestfs.pod:1819
3582 msgid ""
3583 "If no callback is registered: the messages are discarded unless the verbose "
3584 "flag is set in which case they are sent to stderr.  You can override the "
3585 "printing of verbose messages to stderr by setting up a callback."
3586 msgstr ""
3587
3588 #. type: =item
3589 #: ../src/guestfs.pod:1810
3590 msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)"
3591 msgstr ""
3592
3593 #. type: textblock
3594 #: ../src/guestfs.pod:1813
3595 msgid ""
3596 "The callback function is called whenever a log message is generated by the "
3597 "library part of libguestfs."
3598 msgstr ""
3599
3600 #. type: textblock
3601 #: ../src/guestfs.pod:1816
3602 msgid ""
3603 "If the verbose flag (L</guestfs_set_verbose>) is set then additional debug "
3604 "messages are generated."
3605 msgstr ""
3606
3607 #. type: =item
3608 #: ../src/guestfs.pod:1824
3609 msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)"
3610 msgstr ""
3611
3612 #. type: textblock
3613 #: ../src/guestfs.pod:1827
3614 msgid ""
3615 "The callback function is called whenever a trace message is generated.  This "
3616 "only applies if the trace flag (L</guestfs_set_trace>) is set."
3617 msgstr ""
3618
3619 #. type: textblock
3620 #: ../src/guestfs.pod:1830
3621 msgid ""
3622 "If no callback is registered: the messages are sent to stderr.  You can "
3623 "override the printing of trace messages to stderr by setting up a callback."
3624 msgstr ""
3625
3626 #. type: =head3
3627 #: ../src/guestfs.pod:1836
3628 msgid "guestfs_set_event_callback"
3629 msgstr ""
3630
3631 #. type: verbatim
3632 #: ../src/guestfs.pod:1838
3633 #, no-wrap
3634 msgid ""
3635 " int guestfs_set_event_callback (guestfs_h *g,\n"
3636 "                                 guestfs_event_callback cb,\n"
3637 "                                 uint64_t event_bitmask,\n"
3638 "                                 int flags,\n"
3639 "                                 void *opaque);\n"
3640 "\n"
3641 msgstr ""
3642
3643 #. type: textblock
3644 #: ../src/guestfs.pod:1844
3645 msgid ""
3646 "This function registers a callback (C<cb>) for all event classes in the "
3647 "C<event_bitmask>."
3648 msgstr ""
3649
3650 #. type: textblock
3651 #: ../src/guestfs.pod:1847
3652 msgid ""
3653 "For example, to register for all log message events, you could call this "
3654 "function with the bitmask C<GUESTFS_EVENT_APPLIANCE|GUESTFS_EVENT_LIBRARY>.  "
3655 "To register a single callback for all possible classes of events, use "
3656 "C<GUESTFS_EVENT_ALL>."
3657 msgstr ""
3658
3659 #. type: textblock
3660 #: ../src/guestfs.pod:1853
3661 msgid "C<flags> should always be passed as 0."
3662 msgstr ""
3663
3664 #. type: textblock
3665 #: ../src/guestfs.pod:1855
3666 msgid ""
3667 "C<opaque> is an opaque pointer which is passed to the callback.  You can use "
3668 "it for any purpose."
3669 msgstr ""
3670
3671 #. type: textblock
3672 #: ../src/guestfs.pod:1858
3673 msgid ""
3674 "The return value is the event handle (an integer) which you can use to "
3675 "delete the callback (see below)."
3676 msgstr ""
3677
3678 #. type: textblock
3679 #: ../src/guestfs.pod:1861
3680 msgid ""
3681 "If there is an error, this function returns C<-1>, and sets the error in the "
3682 "handle in the usual way (see L</guestfs_last_error> etc.)"
3683 msgstr ""
3684
3685 #. type: textblock
3686 #: ../src/guestfs.pod:1864
3687 msgid ""
3688 "Callbacks remain in effect until they are deleted, or until the handle is "
3689 "closed."
3690 msgstr ""
3691
3692 #. type: textblock
3693 #: ../src/guestfs.pod:1867
3694 msgid ""
3695 "In the case where multiple callbacks are registered for a particular event "
3696 "class, all of the callbacks are called.  The order in which multiple "
3697 "callbacks are called is not defined."
3698 msgstr ""
3699
3700 #. type: =head3
3701 #: ../src/guestfs.pod:1871
3702 msgid "guestfs_delete_event_callback"
3703 msgstr ""
3704
3705 #. type: verbatim
3706 #: ../src/guestfs.pod:1873
3707 #, no-wrap
3708 msgid ""
3709 " void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n"
3710 "\n"
3711 msgstr ""
3712
3713 #. type: textblock
3714 #: ../src/guestfs.pod:1875
3715 msgid ""
3716 "Delete a callback that was previously registered.  C<event_handle> should be "
3717 "the integer that was returned by a previous call to "
3718 "C<guestfs_set_event_callback> on the same handle."
3719 msgstr ""
3720
3721 #. type: =head3
3722 #: ../src/guestfs.pod:1879
3723 msgid "guestfs_event_callback"
3724 msgstr ""
3725
3726 #. type: verbatim
3727 #: ../src/guestfs.pod:1881
3728 #, no-wrap
3729 msgid ""
3730 " typedef void (*guestfs_event_callback) (\n"
3731 "                  guestfs_h *g,\n"
3732 "                  void *opaque,\n"
3733 "                  uint64_t event,\n"
3734 "                  int event_handle,\n"
3735 "                  int flags,\n"
3736 "                  const char *buf, size_t buf_len,\n"
3737 "                  const uint64_t *array, size_t array_len);\n"
3738 "\n"
3739 msgstr ""
3740
3741 #. type: textblock
3742 #: ../src/guestfs.pod:1890
3743 msgid ""
3744 "This is the type of the event callback function that you have to provide."
3745 msgstr ""
3746
3747 #. type: textblock
3748 #: ../src/guestfs.pod:1893
3749 msgid ""
3750 "The basic parameters are: the handle (C<g>), the opaque user pointer "
3751 "(C<opaque>), the event class (eg. C<GUESTFS_EVENT_PROGRESS>), the event "
3752 "handle, and C<flags> which in the current API you should ignore."
3753 msgstr ""
3754
3755 #. type: textblock
3756 #: ../src/guestfs.pod:1897
3757 msgid ""
3758 "The remaining parameters contain the event payload (if any).  Each event may "
3759 "contain a payload, which usually relates to the event class, but for future "
3760 "proofing your code should be written to handle any payload for any event "
3761 "class."
3762 msgstr ""
3763
3764 #. type: textblock
3765 #: ../src/guestfs.pod:1902
3766 msgid ""
3767 "C<buf> and C<buf_len> contain a message buffer (if C<buf_len == 0>, then "
3768 "there is no message buffer).  Note that this message buffer can contain "
3769 "arbitrary 8 bit data, including NUL bytes."
3770 msgstr ""
3771
3772 #. type: textblock
3773 #: ../src/guestfs.pod:1906
3774 msgid ""
3775 "C<array> and C<array_len> is an array of 64 bit unsigned integers.  At the "
3776 "moment this is only used for progress messages."
3777 msgstr ""
3778
3779 #. type: =head3
3780 #: ../src/guestfs.pod:1909
3781 msgid "EXAMPLE: CAPTURING LOG MESSAGES"
3782 msgstr ""
3783
3784 #. type: textblock
3785 #: ../src/guestfs.pod:1911
3786 msgid ""
3787 "One motivation for the generic event API was to allow GUI programs to "
3788 "capture debug and other messages.  In libguestfs E<le> 1.8 these were sent "
3789 "unconditionally to C<stderr>."
3790 msgstr ""
3791
3792 #. type: textblock
3793 #: ../src/guestfs.pod:1915
3794 msgid ""
3795 "Events associated with log messages are: C<GUESTFS_EVENT_LIBRARY>, "
3796 "C<GUESTFS_EVENT_APPLIANCE> and C<GUESTFS_EVENT_TRACE>.  (Note that error "
3797 "messages are not events; you must capture error messages separately)."
3798 msgstr ""
3799
3800 #. type: textblock
3801 #: ../src/guestfs.pod:1920
3802 msgid ""
3803 "Programs have to set up a callback to capture the classes of events of "
3804 "interest:"
3805 msgstr ""
3806
3807 #. type: verbatim
3808 #: ../src/guestfs.pod:1923
3809 #, no-wrap
3810 msgid ""
3811 " int eh =\n"
3812 "   guestfs_set_event_callback\n"
3813 "     (g, message_callback,\n"
3814 "      GUESTFS_EVENT_LIBRARY|GUESTFS_EVENT_APPLIANCE|\n"
3815 "      GUESTFS_EVENT_TRACE,\n"
3816 "      0, NULL) == -1)\n"
3817 " if (eh == -1) {\n"
3818 "   // handle error in the usual way\n"
3819 " }\n"
3820 "\n"
3821 msgstr ""
3822
3823 #. type: textblock
3824 #: ../src/guestfs.pod:1933
3825 msgid ""
3826 "The callback can then direct messages to the appropriate place.  In this "
3827 "example, messages are directed to syslog:"
3828 msgstr ""
3829
3830 #. type: verbatim
3831 #: ../src/guestfs.pod:1936
3832 #, no-wrap
3833 msgid ""
3834 " static void\n"
3835 " message_callback (\n"
3836 "         guestfs_h *g,\n"
3837 "         void *opaque,\n"
3838 "         uint64_t event,\n"
3839 "         int event_handle,\n"
3840 "         int flags,\n"
3841 "         const char *buf, size_t buf_len,\n"
3842 "         const uint64_t *array, size_t array_len)\n"
3843 " {\n"
3844 "   const int priority = LOG_USER|LOG_INFO;\n"
3845 "   if (buf_len > 0)\n"
3846 "     syslog (priority, \"event 0x%lx: %s\", event, buf);\n"
3847 " }\n"
3848 "\n"
3849 msgstr ""
3850
3851 #. type: =head1
3852 #: ../src/guestfs.pod:1951
3853 msgid "PRIVATE DATA AREA"
3854 msgstr ""
3855
3856 #. type: textblock
3857 #: ../src/guestfs.pod:1953
3858 msgid ""
3859 "You can attach named pieces of private data to the libguestfs handle, fetch "
3860 "them by name, and walk over them, for the lifetime of the handle.  This is "
3861 "called the private data area and is only available from the C API."
3862 msgstr ""
3863
3864 #. type: textblock
3865 #: ../src/guestfs.pod:1958
3866 msgid "To attach a named piece of data, use the following call:"
3867 msgstr ""
3868
3869 #. type: verbatim
3870 #: ../src/guestfs.pod:1960
3871 #, no-wrap
3872 msgid ""
3873 " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
3874 "\n"
3875 msgstr ""
3876
3877 #. type: textblock
3878 #: ../src/guestfs.pod:1962
3879 msgid ""
3880 "C<key> is the name to associate with this data, and C<data> is an arbitrary "
3881 "pointer (which can be C<NULL>).  Any previous item with the same key is "
3882 "overwritten."
3883 msgstr ""
3884
3885 #. type: textblock
3886 #: ../src/guestfs.pod:1966
3887 msgid ""
3888 "You can use any C<key> you want, but your key should I<not> start with an "
3889 "underscore character.  Keys beginning with an underscore character are "
3890 "reserved for internal libguestfs purposes (eg. for implementing language "
3891 "bindings).  It is recommended that you prefix the key with some unique "
3892 "string to avoid collisions with other users."
3893 msgstr ""
3894
3895 #. type: textblock
3896 #: ../src/guestfs.pod:1972
3897 msgid "To retrieve the pointer, use:"
3898 msgstr ""
3899
3900 #. type: verbatim
3901 #: ../src/guestfs.pod:1974
3902 #, no-wrap
3903 msgid ""
3904 " void *guestfs_get_private (guestfs_h *g, const char *key);\n"
3905 "\n"
3906 msgstr ""
3907
3908 #. type: textblock
3909 #: ../src/guestfs.pod:1976
3910 msgid ""
3911 "This function returns C<NULL> if either no data is found associated with "
3912 "C<key>, or if the user previously set the C<key>'s C<data> pointer to "
3913 "C<NULL>."
3914 msgstr ""
3915
3916 #. type: textblock
3917 #: ../src/guestfs.pod:1980
3918 msgid ""
3919 "Libguestfs does not try to look at or interpret the C<data> pointer in any "
3920 "way.  As far as libguestfs is concerned, it need not be a valid pointer at "
3921 "all.  In particular, libguestfs does I<not> try to free the data when the "
3922 "handle is closed.  If the data must be freed, then the caller must either "
3923 "free it before calling L</guestfs_close> or must set up a close callback to "
3924 "do it (see L</GUESTFS_EVENT_CLOSE>)."
3925 msgstr ""
3926
3927 #. type: textblock
3928 #: ../src/guestfs.pod:1987
3929 msgid "To walk over all entries, use these two functions:"
3930 msgstr ""
3931
3932 #. type: verbatim
3933 #: ../src/guestfs.pod:1989
3934 #, no-wrap
3935 msgid ""
3936 " void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n"
3937 "\n"
3938 msgstr ""
3939
3940 #. type: verbatim
3941 #: ../src/guestfs.pod:1991
3942 #, no-wrap
3943 msgid ""
3944 " void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n"
3945 "\n"
3946 msgstr ""
3947
3948 #. type: textblock
3949 #: ../src/guestfs.pod:1993
3950 msgid ""
3951 "C<guestfs_first_private> returns the first key, pointer pair (\"first\" does "
3952 "not have any particular meaning -- keys are not returned in any defined "
3953 "order).  A pointer to the key is returned in C<*key_rtn> and the "
3954 "corresponding data pointer is returned from the function.  C<NULL> is "
3955 "returned if there are no keys stored in the handle."
3956 msgstr ""
3957
3958 #. type: textblock
3959 #: ../src/guestfs.pod:1999
3960 msgid ""
3961 "C<guestfs_next_private> returns the next key, pointer pair.  The return "
3962 "value of this function is also C<NULL> is there are no further entries to "
3963 "return."
3964 msgstr ""
3965
3966 #. type: textblock
3967 #: ../src/guestfs.pod:2003
3968 msgid "Notes about walking over entries:"
3969 msgstr ""
3970
3971 #. type: textblock
3972 #: ../src/guestfs.pod:2009
3973 msgid ""
3974 "You must not call C<guestfs_set_private> while walking over the entries."
3975 msgstr ""
3976
3977 #. type: textblock
3978 #: ../src/guestfs.pod:2014
3979 msgid ""
3980 "The handle maintains an internal iterator which is reset when you call "
3981 "C<guestfs_first_private>.  This internal iterator is invalidated when you "
3982 "call C<guestfs_set_private>."
3983 msgstr ""
3984
3985 #. type: textblock
3986 #: ../src/guestfs.pod:2020
3987 msgid "If you have set the data pointer associated with a key to C<NULL>, ie:"
3988 msgstr ""
3989
3990 #. type: verbatim
3991 #: ../src/guestfs.pod:2022
3992 #, no-wrap
3993 msgid ""
3994 " guestfs_set_private (g, key, NULL);\n"
3995 "\n"
3996 msgstr ""
3997
3998 #. type: textblock
3999 #: ../src/guestfs.pod:2024
4000 msgid "then that C<key> is not returned when walking."
4001 msgstr ""
4002
4003 #. type: textblock
4004 #: ../src/guestfs.pod:2028
4005 msgid ""
4006 "C<*key_rtn> is only valid until the next call to C<guestfs_first_private>, "
4007 "C<guestfs_next_private> or C<guestfs_set_private>."
4008 msgstr ""
4009
4010 #. type: textblock
4011 #: ../src/guestfs.pod:2034
4012 msgid ""
4013 "The following example code shows how to print all keys and data pointers "
4014 "that are associated with the handle C<g>:"
4015 msgstr ""
4016
4017 #. type: verbatim
4018 #: ../src/guestfs.pod:2037
4019 #, no-wrap
4020 msgid ""
4021 " const char *key;\n"
4022 " void *data = guestfs_first_private (g, &key);\n"
4023 " while (data != NULL)\n"
4024 "   {\n"
4025 "     printf (\"key = %s, data = %p\\n\", key, data);\n"
4026 "     data = guestfs_next_private (g, &key);\n"
4027 "   }\n"
4028 "\n"
4029 msgstr ""
4030
4031 #. type: textblock
4032 #: ../src/guestfs.pod:2045
4033 msgid ""
4034 "More commonly you are only interested in keys that begin with an application-"
4035 "specific prefix C<foo_>.  Modify the loop like so:"
4036 msgstr ""
4037
4038 #. type: verbatim
4039 #: ../src/guestfs.pod:2048
4040 #, no-wrap
4041 msgid ""
4042 " const char *key;\n"
4043 " void *data = guestfs_first_private (g, &key);\n"
4044 " while (data != NULL)\n"
4045 "   {\n"
4046 "     if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
4047 "       printf (\"key = %s, data = %p\\n\", key, data);\n"
4048 "     data = guestfs_next_private (g, &key);\n"
4049 "   }\n"
4050 "\n"
4051 msgstr ""
4052
4053 #. type: textblock
4054 #: ../src/guestfs.pod:2057
4055 msgid ""
4056 "If you need to modify keys while walking, then you have to jump back to the "
4057 "beginning of the loop.  For example, to delete all keys prefixed with "
4058 "C<foo_>:"
4059 msgstr ""
4060
4061 #. type: verbatim
4062 #: ../src/guestfs.pod:2061
4063 #, no-wrap
4064 msgid ""
4065 "  const char *key;\n"
4066 "  void *data;\n"
4067 " again:\n"
4068 "  data = guestfs_first_private (g, &key);\n"
4069 "  while (data != NULL)\n"
4070 "    {\n"
4071 "      if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
4072 "        {\n"
4073 "          guestfs_set_private (g, key, NULL);\n"
4074 "          /* note that 'key' pointer is now invalid, and so is\n"
4075 "             the internal iterator */\n"
4076 "          goto again;\n"
4077 "        }\n"
4078 "      data = guestfs_next_private (g, &key);\n"
4079 "    }\n"
4080 "\n"
4081 msgstr ""
4082
4083 #. type: textblock
4084 #: ../src/guestfs.pod:2077
4085 msgid ""
4086 "Note that the above loop is guaranteed to terminate because the keys are "
4087 "being deleted, but other manipulations of keys within the loop might not "
4088 "terminate unless you also maintain an indication of which keys have been "
4089 "visited."
4090 msgstr ""
4091
4092 #. type: =end
4093 #: ../src/guestfs.pod:2082 ../src/guestfs.pod:2087
4094 msgid "html"
4095 msgstr "html"
4096
4097 #. type: textblock
4098 #: ../src/guestfs.pod:2084
4099 msgid ""
4100 "<!-- old anchor for the next section --> <a name="
4101 "\"state_machine_and_low_level_event_api\"/>"
4102 msgstr ""
4103 "<!-- old anchor for the next section --> <a name="
4104 "\"state_machine_and_low_level_event_api\"/>"
4105
4106 #. type: =head1
4107 #: ../src/guestfs.pod:2089
4108 msgid "ARCHITECTURE"
4109 msgstr "АРХІТЕКТУРА"
4110
4111 #. type: textblock
4112 #: ../src/guestfs.pod:2091
4113 msgid ""
4114 "Internally, libguestfs is implemented by running an appliance (a special "
4115 "type of small virtual machine) using L<qemu(1)>.  Qemu runs as a child "
4116 "process of the main program."
4117 msgstr ""
4118
4119 #. type: verbatim
4120 #: ../src/guestfs.pod:2095
4121 #, no-wrap
4122 msgid ""
4123 "  ___________________\n"
4124 " /                   \\\n"
4125 " | main program      |\n"
4126 " |                   |\n"
4127 " |                   |           child process / appliance\n"
4128 " |                   |           __________________________\n"
4129 " |                   |          / qemu                     \\\n"
4130 " +-------------------+   RPC    |      +-----------------+ |\n"
4131 " | libguestfs     <--------------------> guestfsd        | |\n"
4132 " |                   |          |      +-----------------+ |\n"
4133 " \\___________________/          |      | Linux kernel    | |\n"
4134 "                                |      +--^--------------+ |\n"
4135 "                                \\_________|________________/\n"
4136 "                                          |\n"
4137 "                                   _______v______\n"
4138 "                                  /              \\\n"
4139 "                                  | Device or    |\n"
4140 "                                  | disk image   |\n"
4141 "                                  \\______________/\n"
4142 "\n"
4143 msgstr ""
4144
4145 #. type: textblock
4146 #: ../src/guestfs.pod:2115
4147 msgid ""
4148 "The library, linked to the main program, creates the child process and hence "
4149 "the appliance in the L</guestfs_launch> function."
4150 msgstr ""
4151
4152 #. type: textblock
4153 #: ../src/guestfs.pod:2118
4154 msgid ""
4155 "Inside the appliance is a Linux kernel and a complete stack of userspace "
4156 "tools (such as LVM and ext2 programs) and a small controlling daemon called "
4157 "L</guestfsd>.  The library talks to L</guestfsd> using remote procedure "
4158 "calls (RPC).  There is a mostly one-to-one correspondence between libguestfs "
4159 "API calls and RPC calls to the daemon.  Lastly the disk image(s) are "
4160 "attached to the qemu process which translates device access by the "
4161 "appliance's Linux kernel into accesses to the image."
4162 msgstr ""
4163
4164 #. type: textblock
4165 #: ../src/guestfs.pod:2127
4166 msgid ""
4167 "A common misunderstanding is that the appliance \"is\" the virtual machine.  "
4168 "Although the disk image you are attached to might also be used by some "
4169 "virtual machine, libguestfs doesn't know or care about this.  (But you will "
4170 "care if both libguestfs's qemu process and your virtual machine are trying "
4171 "to update the disk image at the same time, since these usually results in "
4172 "massive disk corruption)."
4173 msgstr ""
4174
4175 #. type: =head1
4176 #: ../src/guestfs.pod:2134
4177 msgid "STATE MACHINE"
4178 msgstr "СКІНЧЕННИЙ АВТОМАТ"
4179
4180 #. type: textblock
4181 #: ../src/guestfs.pod:2136
4182 msgid "libguestfs uses a state machine to model the child process:"
4183 msgstr ""
4184
4185 #. type: verbatim
4186 #: ../src/guestfs.pod:2138
4187 #, no-wrap
4188 msgid ""
4189 "                         |\n"
4190 "                    guestfs_create\n"
4191 "                         |\n"
4192 "                         |\n"
4193 "                     ____V_____\n"
4194 "                    /          \\\n"
4195 "                    |  CONFIG  |\n"
4196 "                    \\__________/\n"
4197 "                     ^ ^   ^  \\\n"
4198 "                    /  |    \\  \\ guestfs_launch\n"
4199 "                   /   |    _\\__V______\n"
4200 "                  /    |   /           \\\n"
4201 "                 /     |   | LAUNCHING |\n"
4202 "                /      |   \\___________/\n"
4203 "               /       |       /\n"
4204 "              /        |  guestfs_launch\n"
4205 "             /         |     /\n"
4206 "    ______  /        __|____V\n"
4207 "   /      \\ ------> /        \\\n"
4208 "   | BUSY |         | READY  |\n"
4209 "   \\______/ <------ \\________/\n"
4210 "\n"
4211 msgstr ""
4212
4213 #. type: textblock
4214 #: ../src/guestfs.pod:2160
4215 msgid ""
4216 "The normal transitions are (1) CONFIG (when the handle is created, but there "
4217 "is no child process), (2) LAUNCHING (when the child process is booting up), "
4218 "(3) alternating between READY and BUSY as commands are issued to, and "
4219 "carried out by, the child process."
4220 msgstr ""
4221
4222 #. type: textblock
4223 #: ../src/guestfs.pod:2165
4224 msgid ""
4225 "The guest may be killed by L</guestfs_kill_subprocess>, or may die "
4226 "asynchronously at any time (eg. due to some internal error), and that causes "
4227 "the state to transition back to CONFIG."
4228 msgstr ""
4229
4230 #. type: textblock
4231 #: ../src/guestfs.pod:2169
4232 msgid ""
4233 "Configuration commands for qemu such as L</guestfs_add_drive> can only be "
4234 "issued when in the CONFIG state."
4235 msgstr ""
4236
4237 #. type: textblock
4238 #: ../src/guestfs.pod:2172
4239 msgid ""
4240 "The API offers one call that goes from CONFIG through LAUNCHING to READY.  "
4241 "L</guestfs_launch> blocks until the child process is READY to accept "
4242 "commands (or until some failure or timeout).  L</guestfs_launch> internally "
4243 "moves the state from CONFIG to LAUNCHING while it is running."
4244 msgstr ""
4245
4246 #. type: textblock
4247 #: ../src/guestfs.pod:2178
4248 msgid ""
4249 "API actions such as L</guestfs_mount> can only be issued when in the READY "
4250 "state.  These API calls block waiting for the command to be carried out (ie. "
4251 "the state to transition to BUSY and then back to READY).  There are no non-"
4252 "blocking versions, and no way to issue more than one command per handle at "
4253 "the same time."
4254 msgstr ""
4255
4256 #. type: textblock
4257 #: ../src/guestfs.pod:2184
4258 msgid ""
4259 "Finally, the child process sends asynchronous messages back to the main "
4260 "program, such as kernel log messages.  You can register a callback to "
4261 "receive these messages."
4262 msgstr ""
4263
4264 #. type: =head1
4265 #: ../src/guestfs.pod:2188
4266 msgid "INTERNALS"
4267 msgstr ""
4268
4269 #. type: =head2
4270 #: ../src/guestfs.pod:2190
4271 msgid "COMMUNICATION PROTOCOL"
4272 msgstr ""
4273
4274 #. type: textblock
4275 #: ../src/guestfs.pod:2192
4276 msgid ""
4277 "Don't rely on using this protocol directly.  This section documents how it "
4278 "currently works, but it may change at any time."
4279 msgstr ""
4280
4281 #. type: textblock
4282 #: ../src/guestfs.pod:2195
4283 msgid ""
4284 "The protocol used to talk between the library and the daemon running inside "
4285 "the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC "
4286 "1014, RFC 1832, RFC 4506)."
4287 msgstr ""
4288
4289 #. type: textblock
4290 #: ../src/guestfs.pod:2199
4291 msgid ""
4292 "The detailed format of structures is in C<src/guestfs_protocol.x> (note: "
4293 "this file is automatically generated)."
4294 msgstr ""
4295
4296 #. type: textblock
4297 #: ../src/guestfs.pod:2202
4298 msgid ""
4299 "There are two broad cases, ordinary functions that don't have any C<FileIn> "
4300 "and C<FileOut> parameters, which are handled with very simple request/reply "
4301 "messages.  Then there are functions that have any C<FileIn> or C<FileOut> "
4302 "parameters, which use the same request and reply messages, but they may also "
4303 "be followed by files sent using a chunked encoding."
4304 msgstr ""
4305
4306 #. type: =head3
4307 #: ../src/guestfs.pod:2209
4308 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)"
4309 msgstr ""
4310
4311 #. type: textblock
4312 #: ../src/guestfs.pod:2211
4313 msgid "For ordinary functions, the request message is:"
4314 msgstr ""
4315
4316 #. type: verbatim
4317 #: ../src/guestfs.pod:2213
4318 #, no-wrap
4319 msgid ""
4320 " total length (header + arguments,\n"
4321 "      but not including the length word itself)\n"
4322 " struct guestfs_message_header (encoded as XDR)\n"
4323 " struct guestfs_<foo>_args (encoded as XDR)\n"
4324 "\n"
4325 msgstr ""
4326
4327 #. type: textblock
4328 #: ../src/guestfs.pod:2218
4329 msgid ""
4330 "The total length field allows the daemon to allocate a fixed size buffer "
4331 "into which it slurps the rest of the message.  As a result, the total length "
4332 "is limited to C<GUESTFS_MESSAGE_MAX> bytes (currently 4MB), which means the "
4333 "effective size of any request is limited to somewhere under this size."
4334 msgstr ""
4335
4336 #. type: textblock
4337 #: ../src/guestfs.pod:2224
4338 msgid ""
4339 "Note also that many functions don't take any arguments, in which case the "
4340 "C<guestfs_I<foo>_args> is completely omitted."
4341 msgstr ""
4342
4343 #. type: textblock
4344 #: ../src/guestfs.pod:2227
4345 msgid ""
4346 "The header contains the procedure number (C<guestfs_proc>) which is how the "
4347 "receiver knows what type of args structure to expect, or none at all."
4348 msgstr ""
4349
4350 #. type: textblock
4351 #: ../src/guestfs.pod:2231
4352 msgid ""
4353 "For functions that take optional arguments, the optional arguments are "
4354 "encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary "
4355 "arguments.  A bitmask in the header indicates which optional arguments are "
4356 "meaningful.  The bitmask is also checked to see if it contains bits set "
4357 "which the daemon does not know about (eg. if more optional arguments were "
4358 "added in a later version of the library), and this causes the call to be "
4359 "rejected."
4360 msgstr ""
4361
4362 #. type: textblock
4363 #: ../src/guestfs.pod:2239
4364 msgid "The reply message for ordinary functions is:"
4365 msgstr ""
4366
4367 #. type: verbatim
4368 #: ../src/guestfs.pod:2241
4369 #, no-wrap
4370 msgid ""
4371 " total length (header + ret,\n"
4372 "      but not including the length word itself)\n"
4373 " struct guestfs_message_header (encoded as XDR)\n"
4374 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4375 "\n"
4376 msgstr ""
4377
4378 #. type: textblock
4379 #: ../src/guestfs.pod:2246
4380 msgid ""
4381 "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for "
4382 "functions that return no formal return values."
4383 msgstr ""
4384
4385 #. type: textblock
4386 #: ../src/guestfs.pod:2249
4387 msgid ""
4388 "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>."
4389 msgstr ""
4390
4391 #. type: textblock
4392 #: ../src/guestfs.pod:2252
4393 msgid ""
4394 "In the case of an error, a flag is set in the header, and the reply message "
4395 "is slightly changed:"
4396 msgstr ""
4397
4398 #. type: verbatim
4399 #: ../src/guestfs.pod:2255
4400 #, no-wrap
4401 msgid ""
4402 " total length (header + error,\n"
4403 "      but not including the length word itself)\n"
4404 " struct guestfs_message_header (encoded as XDR)\n"
4405 " struct guestfs_message_error (encoded as XDR)\n"
4406 "\n"
4407 msgstr ""
4408
4409 #. type: textblock
4410 #: ../src/guestfs.pod:2260
4411 msgid ""
4412 "The C<guestfs_message_error> structure contains the error message as a "
4413 "string."
4414 msgstr ""
4415
4416 #. type: =head3
4417 #: ../src/guestfs.pod:2263
4418 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS"
4419 msgstr ""
4420
4421 #. type: textblock
4422 #: ../src/guestfs.pod:2265
4423 msgid ""
4424 "A C<FileIn> parameter indicates that we transfer a file I<into> the guest.  "
4425 "The normal request message is sent (see above).  However this is followed by "
4426 "a sequence of file chunks."
4427 msgstr ""
4428
4429 #. type: verbatim
4430 #: ../src/guestfs.pod:2269
4431 #, no-wrap
4432 msgid ""
4433 " total length (header + arguments,\n"
4434 "      but not including the length word itself,\n"
4435 "      and not including the chunks)\n"
4436 " struct guestfs_message_header (encoded as XDR)\n"
4437 " struct guestfs_<foo>_args (encoded as XDR)\n"
4438 " sequence of chunks for FileIn param #0\n"
4439 " sequence of chunks for FileIn param #1 etc.\n"
4440 "\n"
4441 msgstr ""
4442
4443 #. type: textblock
4444 #: ../src/guestfs.pod:2277
4445 msgid "The \"sequence of chunks\" is:"
4446 msgstr ""
4447
4448 #. type: verbatim
4449 #: ../src/guestfs.pod:2279
4450 #, no-wrap
4451 msgid ""
4452 " length of chunk (not including length word itself)\n"
4453 " struct guestfs_chunk (encoded as XDR)\n"
4454 " length of chunk\n"
4455 " struct guestfs_chunk (encoded as XDR)\n"
4456 "   ...\n"
4457 " length of chunk\n"
4458 " struct guestfs_chunk (with data.data_len == 0)\n"
4459 "\n"
4460 msgstr ""
4461
4462 #. type: textblock
4463 #: ../src/guestfs.pod:2287
4464 msgid ""
4465 "The final chunk has the C<data_len> field set to zero.  Additionally a flag "
4466 "is set in the final chunk to indicate either successful completion or early "
4467 "cancellation."
4468 msgstr ""
4469
4470 #. type: textblock
4471 #: ../src/guestfs.pod:2291
4472 msgid ""
4473 "At time of writing there are no functions that have more than one FileIn "
4474 "parameter.  However this is (theoretically) supported, by sending the "
4475 "sequence of chunks for each FileIn parameter one after another (from left to "
4476 "right)."
4477 msgstr ""
4478
4479 #. type: textblock
4480 #: ../src/guestfs.pod:2296
4481 msgid ""
4482 "Both the library (sender) I<and> the daemon (receiver) may cancel the "
4483 "transfer.  The library does this by sending a chunk with a special flag set "
4484 "to indicate cancellation.  When the daemon sees this, it cancels the whole "
4485 "RPC, does I<not> send any reply, and goes back to reading the next request."
4486 msgstr ""
4487
4488 #. type: textblock
4489 #: ../src/guestfs.pod:2302
4490 msgid ""
4491 "The daemon may also cancel.  It does this by writing a special word "
4492 "C<GUESTFS_CANCEL_FLAG> to the socket.  The library listens for this during "
4493 "the transfer, and if it gets it, it will cancel the transfer (it sends a "
4494 "cancel chunk).  The special word is chosen so that even if cancellation "
4495 "happens right at the end of the transfer (after the library has finished "
4496 "writing and has started listening for the reply), the \"spurious\" cancel "
4497 "flag will not be confused with the reply message."
4498 msgstr ""
4499
4500 #. type: textblock
4501 #: ../src/guestfs.pod:2311
4502 msgid ""
4503 "This protocol allows the transfer of arbitrary sized files (no 32 bit "
4504 "limit), and also files where the size is not known in advance (eg. from "
4505 "pipes or sockets).  However the chunks are rather small "
4506 "(C<GUESTFS_MAX_CHUNK_SIZE>), so that neither the library nor the daemon need "
4507 "to keep much in memory."
4508 msgstr ""
4509
4510 #. type: =head3
4511 #: ../src/guestfs.pod:2317
4512 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS"
4513 msgstr ""
4514
4515 #. type: textblock
4516 #: ../src/guestfs.pod:2319
4517 msgid ""
4518 "The protocol for FileOut parameters is exactly the same as for FileIn "
4519 "parameters, but with the roles of daemon and library reversed."
4520 msgstr ""
4521
4522 #. type: verbatim
4523 #: ../src/guestfs.pod:2322
4524 #, no-wrap
4525 msgid ""
4526 " total length (header + ret,\n"
4527 "      but not including the length word itself,\n"
4528 "      and not including the chunks)\n"
4529 " struct guestfs_message_header (encoded as XDR)\n"
4530 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4531 " sequence of chunks for FileOut param #0\n"
4532 " sequence of chunks for FileOut param #1 etc.\n"
4533 "\n"
4534 msgstr ""
4535
4536 #. type: =head3
4537 #: ../src/guestfs.pod:2330
4538 msgid "INITIAL MESSAGE"
4539 msgstr ""
4540
4541 #. type: textblock
4542 #: ../src/guestfs.pod:2332
4543 msgid ""
4544 "When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) "
4545 "which indicates that the guest and daemon is alive.  This is what L</"
4546 "guestfs_launch> waits for."
4547 msgstr ""
4548
4549 #. type: =head3
4550 #: ../src/guestfs.pod:2336
4551 msgid "PROGRESS NOTIFICATION MESSAGES"
4552 msgstr ""
4553
4554 #. type: textblock
4555 #: ../src/guestfs.pod:2338
4556 msgid ""
4557 "The daemon may send progress notification messages at any time.  These are "
4558 "distinguished by the normal length word being replaced by "
4559 "C<GUESTFS_PROGRESS_FLAG>, followed by a fixed size progress message."
4560 msgstr ""
4561
4562 #. type: textblock
4563 #: ../src/guestfs.pod:2342
4564 msgid ""
4565 "The library turns them into progress callbacks (see L</"
4566 "GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards them "
4567 "if not."
4568 msgstr ""
4569
4570 #. type: textblock
4571 #: ../src/guestfs.pod:2346
4572 msgid ""
4573 "The daemon self-limits the frequency of progress messages it sends (see "
4574 "C<daemon/proto.c:notify_progress>).  Not all calls generate progress "
4575 "messages."
4576 msgstr ""
4577
4578 #. type: =head1
4579 #: ../src/guestfs.pod:2350
4580 msgid "LIBGUESTFS VERSION NUMBERS"
4581 msgstr ""
4582
4583 #. type: textblock
4584 #: ../src/guestfs.pod:2352
4585 msgid ""
4586 "Since April 2010, libguestfs has started to make separate development and "
4587 "stable releases, along with corresponding branches in our git repository.  "
4588 "These separate releases can be identified by version number:"
4589 msgstr ""
4590
4591 #. type: verbatim
4592 #: ../src/guestfs.pod:2357
4593 #, no-wrap
4594 msgid ""
4595 "                 even numbers for stable: 1.2.x, 1.4.x, ...\n"
4596 "       .-------- odd numbers for development: 1.3.x, 1.5.x, ...\n"
4597 "       |\n"
4598 "       v\n"
4599 " 1  .  3  .  5\n"
4600 " ^           ^\n"
4601 " |           |\n"
4602 " |           `-------- sub-version\n"
4603 " |\n"
4604 " `------ always '1' because we don't change the ABI\n"
4605 "\n"
4606 msgstr ""
4607
4608 #. type: textblock
4609 #: ../src/guestfs.pod:2368
4610 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"."
4611 msgstr ""
4612
4613 #. type: textblock
4614 #: ../src/guestfs.pod:2370
4615 msgid ""
4616 "As time passes we cherry pick fixes from the development branch and backport "
4617 "those into the stable branch, the effect being that the stable branch should "
4618 "get more stable and less buggy over time.  So the stable releases are ideal "
4619 "for people who don't need new features but would just like the software to "
4620 "work."
4621 msgstr ""
4622
4623 #. type: textblock
4624 #: ../src/guestfs.pod:2376
4625 msgid "Our criteria for backporting changes are:"
4626 msgstr ""
4627
4628 #. type: textblock
4629 #: ../src/guestfs.pod:2382
4630 msgid ""
4631 "Documentation changes which don't affect any code are backported unless the "
4632 "documentation refers to a future feature which is not in stable."
4633 msgstr ""
4634
4635 #. type: textblock
4636 #: ../src/guestfs.pod:2388
4637 msgid ""
4638 "Bug fixes which are not controversial, fix obvious problems, and have been "
4639 "well tested are backported."
4640 msgstr ""
4641
4642 #. type: textblock
4643 #: ../src/guestfs.pod:2393
4644 msgid ""
4645 "Simple rearrangements of code which shouldn't affect how it works get "
4646 "backported.  This is so that the code in the two branches doesn't get too "
4647 "far out of step, allowing us to backport future fixes more easily."
4648 msgstr ""
4649
4650 #. type: textblock
4651 #: ../src/guestfs.pod:2399
4652 msgid ""
4653 "We I<don't> backport new features, new APIs, new tools etc, except in one "
4654 "exceptional case: the new feature is required in order to implement an "
4655 "important bug fix."
4656 msgstr ""
4657
4658 #. type: textblock
4659 #: ../src/guestfs.pod:2405
4660 msgid ""
4661 "A new stable branch starts when we think the new features in development are "
4662 "substantial and compelling enough over the current stable branch to warrant "
4663 "it.  When that happens we create new stable and development versions 1.N.0 "
4664 "and 1.(N+1).0 [N is even].  The new dot-oh release won't necessarily be so "
4665 "stable at this point, but by backporting fixes from development, that branch "
4666 "will stabilize over time."
4667 msgstr ""
4668
4669 #. type: =head1
4670 #: ../src/guestfs.pod:2413
4671 msgid "EXTENDING LIBGUESTFS"
4672 msgstr ""
4673
4674 #. type: =head2
4675 #: ../src/guestfs.pod:2415
4676 msgid "ADDING A NEW API ACTION"
4677 msgstr ""
4678
4679 #. type: textblock
4680 #: ../src/guestfs.pod:2417
4681 msgid ""
4682 "Large amounts of boilerplate code in libguestfs (RPC, bindings, "
4683 "documentation) are generated, and this makes it easy to extend the "
4684 "libguestfs API."
4685 msgstr ""
4686
4687 #. type: textblock
4688 #: ../src/guestfs.pod:2421
4689 msgid "To add a new API action there are two changes:"
4690 msgstr ""
4691
4692 #. type: textblock
4693 #: ../src/guestfs.pod:2427
4694 msgid ""
4695 "You need to add a description of the call (name, parameters, return type, "
4696 "tests, documentation) to C<generator/generator_actions.ml>."
4697 msgstr ""
4698
4699 #. type: textblock
4700 #: ../src/guestfs.pod:2430
4701 msgid ""
4702 "There are two sorts of API action, depending on whether the call goes "
4703 "through to the daemon in the appliance, or is serviced entirely by the "
4704 "library (see L</ARCHITECTURE> above).  L</guestfs_sync> is an example of the "
4705 "former, since the sync is done in the appliance.  L</guestfs_set_trace> is "
4706 "an example of the latter, since a trace flag is maintained in the handle and "
4707 "all tracing is done on the library side."
4708 msgstr ""
4709
4710 #. type: textblock
4711 #: ../src/guestfs.pod:2438
4712 msgid ""
4713 "Most new actions are of the first type, and get added to the "
4714 "C<daemon_functions> list.  Each function has a unique procedure number used "
4715 "in the RPC protocol which is assigned to that action when we publish "
4716 "libguestfs and cannot be reused.  Take the latest procedure number and "
4717 "increment it."
4718 msgstr ""
4719
4720 #. type: textblock
4721 #: ../src/guestfs.pod:2444
4722 msgid ""
4723 "For library-only actions of the second type, add to the "
4724 "C<non_daemon_functions> list.  Since these functions are serviced by the "
4725 "library and do not travel over the RPC mechanism to the daemon, these "
4726 "functions do not need a procedure number, and so the procedure number is set "
4727 "to C<-1>."
4728 msgstr ""
4729
4730 #. type: textblock
4731 #: ../src/guestfs.pod:2452
4732 msgid "Implement the action (in C):"
4733 msgstr ""
4734
4735 #. type: textblock
4736 #: ../src/guestfs.pod:2454
4737 msgid ""
4738 "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the "
4739 "C<daemon/> directory."
4740 msgstr ""
4741
4742 #. type: textblock
4743 #: ../src/guestfs.pod:2457
4744 msgid ""
4745 "For library actions, implement the function C<guestfs__E<lt>nameE<gt>> "
4746 "(note: double underscore) in the C<src/> directory."
4747 msgstr ""
4748
4749 #. type: textblock
4750 #: ../src/guestfs.pod:2460
4751 msgid "In either case, use another function as an example of what to do."
4752 msgstr ""
4753
4754 #. type: textblock
4755 #: ../src/guestfs.pod:2464
4756 msgid "After making these changes, use C<make> to compile."
4757 msgstr ""
4758
4759 #. type: textblock
4760 #: ../src/guestfs.pod:2466
4761 msgid ""
4762 "Note that you don't need to implement the RPC, language bindings, manual "
4763 "pages or anything else.  It's all automatically generated from the OCaml "
4764 "description."
4765 msgstr ""
4766
4767 #. type: =head2
4768 #: ../src/guestfs.pod:2470
4769 msgid "ADDING TESTS FOR AN API ACTION"
4770 msgstr ""
4771
4772 #. type: textblock
4773 #: ../src/guestfs.pod:2472
4774 msgid ""
4775 "You can supply zero or as many tests as you want per API call.  The tests "
4776 "can either be added as part of the API description (C<generator/"
4777 "generator_actions.ml>), or in some rarer cases you may want to drop a script "
4778 "into C<regressions/>.  Note that adding a script to C<regressions/> is "
4779 "slower, so if possible use the first method."
4780 msgstr ""
4781
4782 #. type: textblock
4783 #: ../src/guestfs.pod:2478
4784 msgid ""
4785 "The following describes the test environment used when you add an API test "
4786 "in C<generator_actions.ml>."
4787 msgstr ""
4788
4789 #. type: textblock
4790 #: ../src/guestfs.pod:2481
4791 msgid "The test environment has 4 block devices:"
4792 msgstr ""
4793
4794 #. type: =item
4795 #: ../src/guestfs.pod:2485
4796 msgid "C</dev/sda> 500MB"
4797 msgstr ""
4798
4799 #. type: textblock
4800 #: ../src/guestfs.pod:2487
4801 msgid "General block device for testing."
4802 msgstr ""
4803
4804 #. type: =item
4805 #: ../src/guestfs.pod:2489
4806 msgid "C</dev/sdb> 50MB"
4807 msgstr ""
4808
4809 #. type: textblock
4810 #: ../src/guestfs.pod:2491
4811 msgid ""
4812 "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write "
4813 "operations."
4814 msgstr ""
4815
4816 #. type: =item
4817 #: ../src/guestfs.pod:2494
4818 msgid "C</dev/sdc> 10MB"
4819 msgstr ""
4820
4821 #. type: textblock
4822 #: ../src/guestfs.pod:2496
4823 msgid "Used in a few tests where two block devices are needed."
4824 msgstr ""
4825
4826 #. type: =item
4827 #: ../src/guestfs.pod:2498
4828 msgid "C</dev/sdd>"
4829 msgstr "C</dev/sdd>"
4830
4831 #. type: textblock
4832 #: ../src/guestfs.pod:2500
4833 msgid "ISO with fixed content (see C<images/test.iso>)."
4834 msgstr ""
4835
4836 #. type: textblock
4837 #: ../src/guestfs.pod:2504
4838 msgid ""
4839 "To be able to run the tests in a reasonable amount of time, the libguestfs "
4840 "appliance and block devices are reused between tests.  So don't try testing "
4841 "L</guestfs_kill_subprocess> :-x"
4842 msgstr ""
4843
4844 #. type: textblock
4845 #: ../src/guestfs.pod:2508
4846 msgid ""
4847 "Each test starts with an initial scenario, selected using one of the "
4848 "C<Init*> expressions, described in C<generator/generator_types.ml>.  These "
4849 "initialize the disks mentioned above in a particular way as documented in "
4850 "C<generator_types.ml>.  You should not assume anything about the previous "
4851 "contents of other disks that are not initialized."
4852 msgstr ""
4853
4854 #. type: textblock
4855 #: ../src/guestfs.pod:2514
4856 msgid ""
4857 "You can add a prerequisite clause to any individual test.  This is a run-"
4858 "time check, which, if it fails, causes the test to be skipped.  Useful if "
4859 "testing a command which might not work on all variations of libguestfs "
4860 "builds.  A test that has prerequisite of C<Always> means to run "
4861 "unconditionally."
4862 msgstr ""
4863
4864 #. type: textblock
4865 #: ../src/guestfs.pod:2520
4866 msgid ""
4867 "In addition, packagers can skip individual tests by setting environment "
4868 "variables before running C<make check>."
4869 msgstr ""
4870
4871 #. type: verbatim
4872 #: ../src/guestfs.pod:2523
4873 #, no-wrap
4874 msgid ""
4875 " SKIP_TEST_<CMD>_<NUM>=1\n"
4876 "\n"
4877 msgstr ""
4878
4879 #. type: textblock
4880 #: ../src/guestfs.pod:2525
4881 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>."
4882 msgstr ""
4883
4884 #. type: textblock
4885 #: ../src/guestfs.pod:2527
4886 msgid "or:"
4887 msgstr "або:"
4888
4889 #. type: verbatim
4890 #: ../src/guestfs.pod:2529
4891 #, no-wrap
4892 msgid ""
4893 " SKIP_TEST_<CMD>=1\n"
4894 "\n"
4895 msgstr ""
4896
4897 #. type: textblock
4898 #: ../src/guestfs.pod:2531
4899 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests."
4900 msgstr ""
4901
4902 #. type: textblock
4903 #: ../src/guestfs.pod:2533
4904 msgid "Packagers can run only certain tests by setting for example:"
4905 msgstr ""
4906
4907 #. type: verbatim
4908 #: ../src/guestfs.pod:2535
4909 #, no-wrap
4910 msgid ""
4911 " TEST_ONLY=\"vfs_type zerofree\"\n"
4912 "\n"
4913 msgstr ""
4914
4915 #. type: textblock
4916 #: ../src/guestfs.pod:2537
4917 msgid ""
4918 "See C<capitests/tests.c> for more details of how these environment variables "
4919 "work."
4920 msgstr ""
4921
4922 #. type: =head2
4923 #: ../src/guestfs.pod:2540
4924 msgid "DEBUGGING NEW API ACTIONS"
4925 msgstr ""
4926
4927 #. type: textblock
4928 #: ../src/guestfs.pod:2542
4929 msgid "Test new actions work before submitting them."
4930 msgstr ""
4931
4932 #. type: textblock
4933 #: ../src/guestfs.pod:2544
4934 msgid "You can use guestfish to try out new commands."
4935 msgstr ""
4936
4937 #. type: textblock
4938 #: ../src/guestfs.pod:2546
4939 msgid ""
4940 "Debugging the daemon is a problem because it runs inside a minimal "
4941 "environment.  However you can fprintf messages in the daemon to stderr, and "
4942 "they will show up if you use C<guestfish -v>."
4943 msgstr ""
4944
4945 #. type: =head2
4946 #: ../src/guestfs.pod:2550
4947 msgid "FORMATTING CODE AND OTHER CONVENTIONS"
4948 msgstr ""
4949
4950 #. type: textblock
4951 #: ../src/guestfs.pod:2552
4952 msgid ""
4953 "Our C source code generally adheres to some basic code-formatting "
4954 "conventions.  The existing code base is not totally consistent on this "
4955 "front, but we do prefer that contributed code be formatted similarly.  In "
4956 "short, use spaces-not-TABs for indentation, use 2 spaces for each "
4957 "indentation level, and other than that, follow the K&R style."
4958 msgstr ""
4959
4960 #. type: textblock
4961 #: ../src/guestfs.pod:2558
4962 msgid ""
4963 "If you use Emacs, add the following to one of one of your start-up files (e."
4964 "g., ~/.emacs), to help ensure that you get indentation right:"
4965 msgstr ""
4966
4967 #. type: verbatim
4968 #: ../src/guestfs.pod:2561
4969 #, no-wrap
4970 msgid ""
4971 " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n"
4972 " ;;; Exceptions: Makefile and ChangeLog modes.\n"
4973 " (add-hook 'find-file-hook\n"
4974 "     '(lambda () (if (and buffer-file-name\n"
4975 "                          (string-match \"/libguestfs\\\\>\"\n"
4976 "                              (buffer-file-name))\n"
4977 "                          (not (string-equal mode-name \"Change Log\"))\n"
4978 "                          (not (string-equal mode-name \"Makefile\")))\n"
4979 "                     (setq indent-tabs-mode nil))))\n"
4980 " \n"
4981 msgstr ""
4982
4983 #. type: verbatim
4984 #: ../src/guestfs.pod:2571
4985 #, no-wrap
4986 msgid ""
4987 " ;;; When editing C sources in libguestfs, use this style.\n"
4988 " (defun libguestfs-c-mode ()\n"
4989 "   \"C mode with adjusted defaults for use with libguestfs.\"\n"
4990 "   (interactive)\n"
4991 "   (c-set-style \"K&R\")\n"
4992 "   (setq c-indent-level 2)\n"
4993 "   (setq c-basic-offset 2))\n"
4994 " (add-hook 'c-mode-hook\n"
4995 "           '(lambda () (if (string-match \"/libguestfs\\\\>\"\n"
4996 "                               (buffer-file-name))\n"
4997 "                           (libguestfs-c-mode))))\n"
4998 "\n"
4999 msgstr ""
5000
5001 #. type: textblock
5002 #: ../src/guestfs.pod:2583
5003 msgid "Enable warnings when compiling (and fix any problems this finds):"
5004 msgstr ""
5005
5006 #. type: verbatim
5007 #: ../src/guestfs.pod:2586
5008 #, no-wrap
5009 msgid ""
5010 " ./configure --enable-gcc-warnings\n"
5011 "\n"
5012 msgstr ""
5013
5014 #. type: textblock
5015 #: ../src/guestfs.pod:2588
5016 msgid "Useful targets are:"
5017 msgstr ""
5018
5019 #. type: verbatim
5020 #: ../src/guestfs.pod:2590
5021 #, no-wrap
5022 msgid ""
5023 " make syntax-check  # checks the syntax of the C code\n"
5024 " make check         # runs the test suite\n"
5025 "\n"
5026 msgstr ""
5027
5028 #. type: =head2
5029 #: ../src/guestfs.pod:2593
5030 msgid "DAEMON CUSTOM PRINTF FORMATTERS"
5031 msgstr ""
5032
5033 #. type: textblock
5034 #: ../src/guestfs.pod:2595
5035 msgid ""
5036 "In the daemon code we have created custom printf formatters C<%Q> and C<%R>, "
5037 "which are used to do shell quoting."
5038 msgstr ""
5039
5040 #. type: =item
5041 #: ../src/guestfs.pod:2600
5042 msgid "%Q"
5043 msgstr "%Q"
5044
5045 #. type: textblock
5046 #: ../src/guestfs.pod:2602
5047 msgid ""
5048 "Simple shell quoted string.  Any spaces or other shell characters are "
5049 "escaped for you."
5050 msgstr ""
5051
5052 #. type: =item
5053 #: ../src/guestfs.pod:2605
5054 msgid "%R"
5055 msgstr "%R"
5056
5057 #. type: textblock
5058 #: ../src/guestfs.pod:2607
5059 msgid ""
5060 "Same as C<%Q> except the string is treated as a path which is prefixed by "
5061 "the sysroot."
5062 msgstr ""
5063
5064 #. type: textblock
5065 #: ../src/guestfs.pod:2612 ../fish/guestfish.pod:240 ../fish/guestfish.pod:613
5066 msgid "For example:"
5067 msgstr "Приклад:"
5068
5069 #. type: verbatim
5070 #: ../src/guestfs.pod:2614
5071 #, no-wrap
5072 msgid ""
5073 " asprintf (&cmd, \"cat %R\", path);\n"
5074 "\n"
5075 msgstr ""
5076
5077 #. type: textblock
5078 #: ../src/guestfs.pod:2616
5079 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>"
5080 msgstr ""
5081
5082 #. type: textblock
5083 #: ../src/guestfs.pod:2618
5084 msgid ""
5085 "I<Note:> Do I<not> use these when you are passing parameters to the C<command"
5086 "{,r,v,rv}()> functions.  These parameters do NOT need to be quoted because "
5087 "they are not passed via the shell (instead, straight to exec).  You probably "
5088 "want to use the C<sysroot_path()> function however."
5089 msgstr ""
5090
5091 #. type: =head2
5092 #: ../src/guestfs.pod:2624
5093 msgid "SUBMITTING YOUR NEW API ACTIONS"
5094 msgstr ""
5095
5096 #. type: textblock
5097 #: ../src/guestfs.pod:2626
5098 msgid ""
5099 "Submit patches to the mailing list: L<http://www.redhat.com/mailman/listinfo/"
5100 "libguestfs> and CC to L<rjones@redhat.com>."
5101 msgstr ""
5102
5103 #. type: =head2
5104 #: ../src/guestfs.pod:2630
5105 msgid "INTERNATIONALIZATION (I18N) SUPPORT"
5106 msgstr ""
5107
5108 #. type: textblock
5109 #: ../src/guestfs.pod:2632
5110 msgid "We support i18n (gettext anyhow) in the library."
5111 msgstr ""
5112
5113 #. type: textblock
5114 #: ../src/guestfs.pod:2634
5115 msgid ""
5116 "However many messages come from the daemon, and we don't translate those at "
5117 "the moment.  One reason is that the appliance generally has all locale files "
5118 "removed from it, because they take up a lot of space.  So we'd have to readd "
5119 "some of those, as well as copying our PO files into the appliance."
5120 msgstr ""
5121
5122 #. type: textblock
5123 #: ../src/guestfs.pod:2640
5124 msgid ""
5125 "Debugging messages are never translated, since they are intended for the "
5126 "programmers."
5127 msgstr ""
5128
5129 #. type: =head2
5130 #: ../src/guestfs.pod:2643
5131 msgid "SOURCE CODE SUBDIRECTORIES"
5132 msgstr ""
5133
5134 #. type: =item
5135 #: ../src/guestfs.pod:2647 ../src/guestfs-actions.pod:5832
5136 #: ../fish/guestfish-actions.pod:3926
5137 msgid "C<appliance>"
5138 msgstr "C<appliance>"
5139
5140 #. type: textblock
5141 #: ../src/guestfs.pod:2649
5142 msgid "The libguestfs appliance, build scripts and so on."
5143 msgstr ""
5144
5145 #. type: =item
5146 #: ../src/guestfs.pod:2651
5147 msgid "C<capitests>"
5148 msgstr "C<capitests>"
5149
5150 #. type: textblock
5151 #: ../src/guestfs.pod:2653
5152 msgid "Automated tests of the C API."
5153 msgstr ""
5154
5155 #. type: =item
5156 #: ../src/guestfs.pod:2655
5157 msgid "C<cat>"
5158 msgstr "C<cat>"
5159
5160 #. type: textblock
5161 #: ../src/guestfs.pod:2657
5162 msgid ""
5163 "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and "
5164 "documentation."
5165 msgstr ""
5166
5167 #. type: =item
5168 #: ../src/guestfs.pod:2660
5169 #, fuzzy
5170 #| msgid "C<cat>"
5171 msgid "C<caution>"
5172 msgstr "C<cat>"
5173
5174 #. type: textblock
5175 #: ../src/guestfs.pod:2662
5176 msgid ""
5177 "Safety and liveness tests of components that libguestfs depends upon (not of "
5178 "libguestfs itself).  Mainly this is for qemu and the kernel."
5179 msgstr ""
5180
5181 #. type: =item
5182 #: ../src/guestfs.pod:2665
5183 msgid "C<contrib>"
5184 msgstr "C<contrib>"
5185
5186 #. type: textblock
5187 #: ../src/guestfs.pod:2667
5188 msgid "Outside contributions, experimental parts."
5189 msgstr ""
5190
5191 #. type: =item
5192 #: ../src/guestfs.pod:2669
5193 msgid "C<daemon>"
5194 msgstr "C<daemon>"
5195
5196 #. type: textblock
5197 #: ../src/guestfs.pod:2671
5198 msgid ""
5199 "The daemon that runs inside the libguestfs appliance and carries out actions."
5200 msgstr ""
5201
5202 #. type: =item
5203 #: ../src/guestfs.pod:2674
5204 msgid "C<df>"
5205 msgstr "C<df>"
5206
5207 #. type: textblock
5208 #: ../src/guestfs.pod:2676
5209 msgid "L<virt-df(1)> command and documentation."
5210 msgstr ""
5211
5212 #. type: =item
5213 #: ../src/guestfs.pod:2678
5214 msgid "C<examples>"
5215 msgstr "C<examples>"
5216
5217 #. type: textblock
5218 #: ../src/guestfs.pod:2680
5219 msgid "C API example code."
5220 msgstr "Код прикладів використання програмного інтерфейсу мовою C."
5221
5222 #. type: =item
5223 #: ../src/guestfs.pod:2682
5224 msgid "C<fish>"
5225 msgstr "C<fish>"
5226
5227 #. type: textblock
5228 #: ../src/guestfs.pod:2684
5229 msgid ""
5230 "L<guestfish(1)>, the command-line shell, and various shell scripts built on "
5231 "top such as L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, "
5232 "L<virt-tar-out(1)>."
5233 msgstr ""
5234
5235 #. type: =item
5236 #: ../src/guestfs.pod:2688
5237 msgid "C<fuse>"
5238 msgstr "C<fuse>"
5239
5240 #. type: textblock
5241 #: ../src/guestfs.pod:2690
5242 msgid ""
5243 "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs."
5244 msgstr ""
5245
5246 #. type: =item
5247 #: ../src/guestfs.pod:2692
5248 msgid "C<generator>"
5249 msgstr "C<generator>"
5250
5251 #. type: textblock
5252 #: ../src/guestfs.pod:2694
5253 msgid ""
5254 "The crucially important generator, used to automatically generate large "
5255 "amounts of boilerplate C code for things like RPC and bindings."
5256 msgstr ""
5257
5258 #. type: =item
5259 #: ../src/guestfs.pod:2697
5260 msgid "C<images>"
5261 msgstr "C<images>"
5262
5263 #. type: textblock
5264 #: ../src/guestfs.pod:2699
5265 msgid "Files used by the test suite."
5266 msgstr ""
5267
5268 #. type: textblock
5269 #: ../src/guestfs.pod:2701
5270 msgid "Some \"phony\" guest images which we test against."
5271 msgstr ""
5272
5273 #. type: =item
5274 #: ../src/guestfs.pod:2703
5275 msgid "C<inspector>"
5276 msgstr "C<inspector>"
5277
5278 #. type: textblock
5279 #: ../src/guestfs.pod:2705
5280 msgid "L<virt-inspector(1)>, the virtual machine image inspector."
5281 msgstr ""
5282
5283 #. type: =item
5284 #: ../src/guestfs.pod:2707
5285 msgid "C<logo>"
5286 msgstr "C<logo>"
5287
5288 #. type: textblock
5289 #: ../src/guestfs.pod:2709
5290 msgid "Logo used on the website.  The fish is called Arthur by the way."
5291 msgstr ""
5292
5293 #. type: =item
5294 #: ../src/guestfs.pod:2711
5295 msgid "C<m4>"
5296 msgstr "C<m4>"
5297
5298 #. type: textblock
5299 #: ../src/guestfs.pod:2713
5300 msgid "M4 macros used by autoconf."
5301 msgstr ""
5302
5303 #. type: =item
5304 #: ../src/guestfs.pod:2715
5305 msgid "C<po>"
5306 msgstr "C<po>"
5307
5308 #. type: textblock
5309 #: ../src/guestfs.pod:2717
5310 msgid "Translations of simple gettext strings."
5311 msgstr "Переклади простих рядків gettext."
5312
5313 #. type: =item
5314 #: ../src/guestfs.pod:2719
5315 msgid "C<po-docs>"
5316 msgstr "C<po-docs>"
5317
5318 #. type: textblock
5319 #: ../src/guestfs.pod:2721
5320 msgid ""
5321 "The build infrastructure and PO files for translations of manpages and POD "
5322 "files.  Eventually this will be combined with the C<po> directory, but that "
5323 "is rather complicated."
5324 msgstr ""
5325
5326 #. type: =item
5327 #: ../src/guestfs.pod:2725
5328 msgid "C<regressions>"
5329 msgstr "C<regressions>"
5330
5331 #. type: textblock
5332 #: ../src/guestfs.pod:2727
5333 msgid "Regression tests."
5334 msgstr "Тести на регресії."
5335
5336 #. type: =item
5337 #: ../src/guestfs.pod:2729
5338 msgid "C<rescue>"
5339 msgstr "C<rescue>"
5340
5341 #. type: textblock
5342 #: ../src/guestfs.pod:2731
5343 msgid "L<virt-rescue(1)> command and documentation."
5344 msgstr ""
5345
5346 #. type: =item
5347 #: ../src/guestfs.pod:2733
5348 msgid "C<src>"
5349 msgstr "C<src>"
5350
5351 #. type: textblock
5352 #: ../src/guestfs.pod:2735
5353 msgid "Source code to the C library."
5354 msgstr ""
5355
5356 #. type: =item
5357 #: ../src/guestfs.pod:2737
5358 msgid "C<tools>"
5359 msgstr "C<tools>"
5360
5361 #. type: textblock
5362 #: ../src/guestfs.pod:2739
5363 msgid "Command line tools written in Perl (L<virt-resize(1)> and many others)."
5364 msgstr ""
5365
5366 #. type: =item
5367 #: ../src/guestfs.pod:2741
5368 msgid "C<test-tool>"
5369 msgstr "C<test-tool>"
5370
5371 #. type: textblock
5372 #: ../src/guestfs.pod:2743
5373 msgid ""
5374 "Test tool for end users to test if their qemu/kernel combination will work "
5375 "with libguestfs."
5376 msgstr ""
5377
5378 #. type: =item
5379 #: ../src/guestfs.pod:2746
5380 msgid "C<csharp>"
5381 msgstr "C<csharp>"
5382
5383 #. type: =item
5384 #: ../src/guestfs.pod:2748
5385 msgid "C<haskell>"
5386 msgstr "C<haskell>"
5387
5388 #. type: =item
5389 #: ../src/guestfs.pod:2750
5390 msgid "C<java>"
5391 msgstr "C<java>"
5392
5393 #. type: =item
5394 #: ../src/guestfs.pod:2752
5395 msgid "C<ocaml>"
5396 msgstr "C<ocaml>"
5397
5398 #. type: =item
5399 #: ../src/guestfs.pod:2754
5400 msgid "C<php>"
5401 msgstr "C<php>"
5402
5403 #. type: =item
5404 #: ../src/guestfs.pod:2756
5405 msgid "C<perl>"
5406 msgstr "C<perl>"
5407
5408 #. type: =item
5409 #: ../src/guestfs.pod:2758
5410 msgid "C<python>"
5411 msgstr "C<python>"
5412
5413 #. type: =item
5414 #: ../src/guestfs.pod:2760
5415 msgid "C<ruby>"
5416 msgstr "C<ruby>"
5417
5418 #. type: textblock
5419 #: ../src/guestfs.pod:2762
5420 msgid "Language bindings."
5421 msgstr "Прив’язки до мов програмування."
5422
5423 #. type: =head1
5424 #: ../src/guestfs.pod:2766
5425 msgid "LIMITS"
5426 msgstr ""
5427
5428 #. type: =head2
5429 #: ../src/guestfs.pod:2768
5430 msgid "PROTOCOL LIMITS"
5431 msgstr ""
5432
5433 #. type: textblock
5434 #: ../src/guestfs.pod:2770
5435 msgid ""
5436 "Internally libguestfs uses a message-based protocol to pass API calls and "
5437 "their responses to and from a small \"appliance\" (see L</INTERNALS> for "
5438 "plenty more detail about this).  The maximum message size used by the "
5439 "protocol is slightly less than 4 MB.  For some API calls you may need to be "
5440 "aware of this limit.  The API calls which may be affected are individually "
5441 "documented, with a link back to this section of the documentation."
5442 msgstr ""
5443
5444 #. type: textblock
5445 #: ../src/guestfs.pod:2778
5446 msgid ""
5447 "A simple call such as L</guestfs_cat> returns its result (the file data) in "
5448 "a simple string.  Because this string is at some point internally encoded as "
5449 "a message, the maximum size that it can return is slightly under 4 MB.  If "
5450 "the requested file is larger than this then you will get an error."
5451 msgstr ""
5452
5453 #. type: textblock
5454 #: ../src/guestfs.pod:2784
5455 msgid ""
5456 "In order to transfer large files into and out of the guest filesystem, you "
5457 "need to use particular calls that support this.  The sections L</UPLOADING> "
5458 "and L</DOWNLOADING> document how to do this."
5459 msgstr ""
5460
5461 #. type: textblock
5462 #: ../src/guestfs.pod:2788
5463 msgid ""
5464 "You might also consider mounting the disk image using our FUSE filesystem "
5465 "support (L<guestmount(1)>)."
5466 msgstr ""
5467
5468 #. type: =head2
5469 #: ../src/guestfs.pod:2791
5470 msgid "MAXIMUM NUMBER OF DISKS"
5471 msgstr ""
5472
5473 #. type: textblock
5474 #: ../src/guestfs.pod:2793
5475 msgid "When using virtio disks (the default) the current limit is B<25> disks."
5476 msgstr ""
5477
5478 #. type: textblock
5479 #: ../src/guestfs.pod:2796
5480 msgid ""
5481 "Virtio itself consumes 1 virtual PCI slot per disk, and PCI is limited to 31 "
5482 "slots.  However febootstrap only understands disks with names C</dev/vda> "
5483 "through C</dev/vdz> (26 letters) and it reserves one disk for its own "
5484 "purposes."
5485 msgstr ""
5486
5487 #. type: textblock
5488 #: ../src/guestfs.pod:2801
5489 msgid ""
5490 "We are working to substantially raise this limit in future versions but it "
5491 "requires complex changes to qemu."
5492 msgstr ""
5493
5494 #. type: textblock
5495 #: ../src/guestfs.pod:2804
5496 msgid ""
5497 "In future versions of libguestfs it should also be possible to \"hot plug\" "
5498 "disks (add and remove disks after calling L</guestfs_launch>).  This also "
5499 "requires changes to qemu."
5500 msgstr ""
5501
5502 #. type: =head2
5503 #: ../src/guestfs.pod:2808
5504 msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK"
5505 msgstr ""
5506
5507 #. type: textblock
5508 #: ../src/guestfs.pod:2810
5509 msgid "Virtio limits the maximum number of partitions per disk to B<15>."
5510 msgstr ""
5511
5512 #. type: textblock
5513 #: ../src/guestfs.pod:2812
5514 msgid ""
5515 "This is because it reserves 4 bits for the minor device number (thus C</dev/"
5516 "vda>, and C</dev/vda1> through C</dev/vda15>)."
5517 msgstr ""
5518
5519 #. type: textblock
5520 #: ../src/guestfs.pod:2815
5521 msgid ""
5522 "If you attach a disk with more than 15 partitions, the extra partitions are "
5523 "ignored by libguestfs."
5524 msgstr ""
5525
5526 #. type: =head2
5527 #: ../src/guestfs.pod:2818
5528 msgid "MAXIMUM SIZE OF A DISK"
5529 msgstr ""
5530
5531 #. type: textblock
5532 #: ../src/guestfs.pod:2820
5533 msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes."
5534 msgstr ""
5535
5536 #. type: textblock
5537 #: ../src/guestfs.pod:2822
5538 msgid ""
5539 "We have tested block devices up to 1 exabyte (2**60 or "
5540 "1,152,921,504,606,846,976 bytes) using sparse files backed by an XFS host "
5541 "filesystem."
5542 msgstr ""
5543
5544 #. type: textblock
5545 #: ../src/guestfs.pod:2826
5546 msgid ""
5547 "Although libguestfs probably does not impose any limit, the underlying host "
5548 "storage will.  If you store disk images on a host ext4 filesystem, then the "
5549 "maximum size will be limited by the maximum ext4 file size (currently 16 "
5550 "TB).  If you store disk images as host logical volumes then you are limited "
5551 "by the maximum size of an LV."
5552 msgstr ""
5553
5554 #. type: textblock
5555 #: ../src/guestfs.pod:2832
5556 msgid ""
5557 "For the hugest disk image files, we recommend using XFS on the host for "
5558 "storage."
5559 msgstr ""
5560
5561 #. type: =head2
5562 #: ../src/guestfs.pod:2835
5563 msgid "MAXIMUM SIZE OF A PARTITION"
5564 msgstr ""
5565
5566 #. type: textblock
5567 #: ../src/guestfs.pod:2837
5568 msgid ""
5569 "The MBR (ie. classic MS-DOS) partitioning scheme uses 32 bit sector "
5570 "numbers.  Assuming a 512 byte sector size, this means that MBR cannot "
5571 "address a partition located beyond 2 TB on the disk."
5572 msgstr ""
5573
5574 #. type: textblock
5575 #: ../src/guestfs.pod:2841
5576 msgid ""
5577 "It is recommended that you use GPT partitions on disks which are larger than "
5578 "this size.  GPT uses 64 bit sector numbers and so can address partitions "
5579 "which are theoretically larger than the largest disk we could support."
5580 msgstr ""
5581
5582 #. type: =head2
5583 #: ../src/guestfs.pod:2846
5584 msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES"
5585 msgstr ""
5586
5587 #. type: textblock
5588 #: ../src/guestfs.pod:2848
5589 msgid ""
5590 "This depends on the filesystem type.  libguestfs itself does not impose any "
5591 "known limit.  Consult Wikipedia or the filesystem documentation to find out "
5592 "what these limits are."
5593 msgstr ""
5594
5595 #. type: =head2
5596 #: ../src/guestfs.pod:2852
5597 msgid "MAXIMUM UPLOAD AND DOWNLOAD"
5598 msgstr ""
5599
5600 #. type: textblock
5601 #: ../src/guestfs.pod:2854
5602 msgid ""
5603 "The API functions L</guestfs_upload>, L</guestfs_download>, L</"
5604 "guestfs_tar_in>, L</guestfs_tar_out> and the like allow unlimited sized "
5605 "uploads and downloads."
5606 msgstr ""
5607
5608 #. type: =head2
5609 #: ../src/guestfs.pod:2858
5610 #, fuzzy
5611 #| msgid "INSPECTION"
5612 msgid "INSPECTION LIMITS"
5613 msgstr "ПЕРЕВІРКА"
5614
5615 #. type: textblock
5616 #: ../src/guestfs.pod:2860
5617 msgid ""
5618 "The inspection code has several arbitrary limits on things like the size of "
5619 "Windows Registry hive it will read, and the length of product name.  These "
5620 "are intended to stop a malicious guest from consuming arbitrary amounts of "
5621 "memory and disk space on the host, and should not be reached in practice.  "
5622 "See the source code for more information."
5623 msgstr ""
5624
5625 #. type: =head1
5626 #: ../src/guestfs.pod:2866 ../fish/guestfish.pod:1026
5627 #: ../test-tool/libguestfs-test-tool.pod:82 ../tools/virt-edit.pl:476
5628 msgid "ENVIRONMENT VARIABLES"
5629 msgstr "ЗМІННІ СЕРЕДОВИЩА"
5630
5631 #. type: =item
5632 #: ../src/guestfs.pod:2870 ../fish/guestfish.pod:1052
5633 msgid "LIBGUESTFS_APPEND"
5634 msgstr ""
5635
5636 #. type: textblock
5637 #: ../src/guestfs.pod:2872 ../fish/guestfish.pod:1054
5638 msgid "Pass additional options to the guest kernel."
5639 msgstr ""
5640
5641 #. type: =item
5642 #: ../src/guestfs.pod:2874 ../fish/guestfish.pod:1056
5643 msgid "LIBGUESTFS_DEBUG"
5644 msgstr ""
5645
5646 #. type: textblock
5647 #: ../src/guestfs.pod:2876
5648 msgid ""
5649 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
5650 "effect as calling C<guestfs_set_verbose (g, 1)>."
5651 msgstr ""
5652
5653 #. type: =item
5654 #: ../src/guestfs.pod:2879 ../fish/guestfish.pod:1061
5655 msgid "LIBGUESTFS_MEMSIZE"
5656 msgstr ""
5657
5658 #. type: textblock
5659 #: ../src/guestfs.pod:2881 ../fish/guestfish.pod:1063
5660 msgid ""
5661 "Set the memory allocated to the qemu process, in megabytes.  For example:"
5662 msgstr ""
5663
5664 #. type: verbatim
5665 #: ../src/guestfs.pod:2884 ../fish/guestfish.pod:1066
5666 #, no-wrap
5667 msgid ""
5668 " LIBGUESTFS_MEMSIZE=700\n"
5669 "\n"
5670 msgstr ""
5671
5672 #. type: =item
5673 #: ../src/guestfs.pod:2886 ../fish/guestfish.pod:1068
5674 msgid "LIBGUESTFS_PATH"
5675 msgstr ""
5676
5677 #. type: textblock
5678 #: ../src/guestfs.pod:2888
5679 msgid ""
5680 "Set the path that libguestfs uses to search for a supermin appliance.  See "
5681 "the discussion of paths in section L</PATH> above."
5682 msgstr ""
5683
5684 #. type: =item
5685 #: ../src/guestfs.pod:2891 ../fish/guestfish.pod:1073
5686 msgid "LIBGUESTFS_QEMU"
5687 msgstr ""
5688
5689 #. type: textblock
5690 #: ../src/guestfs.pod:2893 ../fish/guestfish.pod:1075
5691 msgid ""
5692 "Set the default qemu binary that libguestfs uses.  If not set, then the qemu "
5693 "which was found at compile time by the configure script is used."
5694 msgstr ""
5695
5696 #. type: textblock
5697 #: ../src/guestfs.pod:2897
5698 msgid "See also L</QEMU WRAPPERS> above."
5699 msgstr ""
5700
5701 #. type: =item
5702 #: ../src/guestfs.pod:2899 ../fish/guestfish.pod:1079
5703 msgid "LIBGUESTFS_TRACE"
5704 msgstr ""
5705
5706 #. type: textblock
5707 #: ../src/guestfs.pod:2901
5708 msgid ""
5709 "Set C<LIBGUESTFS_TRACE=1> to enable command traces.  This has the same "
5710 "effect as calling C<guestfs_set_trace (g, 1)>."
5711 msgstr ""
5712
5713 #. type: =item
5714 #: ../src/guestfs.pod:2904 ../fish/guestfish.pod:1088
5715 msgid "TMPDIR"
5716 msgstr ""
5717
5718 #. type: textblock
5719 #: ../src/guestfs.pod:2906 ../fish/guestfish.pod:1090
5720 msgid ""
5721 "Location of temporary directory, defaults to C</tmp> except for the cached "
5722 "supermin appliance which defaults to C</var/tmp>."
5723 msgstr ""
5724
5725 #. type: textblock
5726 #: ../src/guestfs.pod:2909 ../fish/guestfish.pod:1093
5727 msgid ""
5728 "If libguestfs was compiled to use the supermin appliance then the real "
5729 "appliance is cached in this directory, shared between all handles belonging "
5730 "to the same EUID.  You can use C<$TMPDIR> to configure another directory to "
5731 "use in case C</var/tmp> is not large enough."
5732 msgstr ""
5733
5734 #. type: =head1
5735 #: ../src/guestfs.pod:2917 ../fish/guestfish.pod:1160
5736 #: ../test-tool/libguestfs-test-tool.pod:87 ../fuse/guestmount.pod:277
5737 #: ../tools/virt-edit.pl:496 ../tools/virt-win-reg.pl:572
5738 #: ../tools/virt-list-filesystems.pl:189 ../tools/virt-tar.pl:286
5739 #: ../tools/virt-make-fs.pl:539 ../tools/virt-list-partitions.pl:257
5740 msgid "SEE ALSO"
5741 msgstr "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
5742
5743 #. type: textblock
5744 #: ../src/guestfs.pod:2919
5745 msgid ""
5746 "L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, L<guestfs-perl(3)>, L<guestfs-"
5747 "python(3)>, L<guestfs-ruby(3)>, L<guestfish(1)>, L<guestmount(1)>, L<virt-cat"
5748 "(1)>, L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)"
5749 ">, L<virt-filesystems(1)>, L<virt-inspector(1)>, L<virt-list-filesystems(1)"
5750 ">, L<virt-list-partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-"
5751 "rescue(1)>, L<virt-tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-"
5752 "win-reg(1)>, L<qemu(1)>, L<febootstrap(1)>, L<hivex(3)>, L<http://libguestfs."
5753 "org/>."
5754 msgstr ""
5755
5756 #. type: textblock
5757 #: ../src/guestfs.pod:2947
5758 msgid ""
5759 "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, L<lvm"
5760 "(8)>, L<disktype(1)>."
5761 msgstr ""
5762
5763 #. type: =head1
5764 #: ../src/guestfs.pod:2954 ../tools/virt-win-reg.pl:587
5765 #: ../tools/virt-make-fs.pl:553
5766 msgid "BUGS"
5767 msgstr "ВАДИ"
5768
5769 #. type: textblock
5770 #: ../src/guestfs.pod:2956
5771 msgid "To get a list of bugs against libguestfs use this link:"
5772 msgstr ""
5773 "Щоб переглянути список відомих вад у libguestfs, скористайтеся таким "
5774 "посиланням:"
5775
5776 #. type: textblock
5777 #: ../src/guestfs.pod:2958
5778 msgid ""
5779 "L<https://bugzilla.redhat.com/buglist.cgi?"
5780 "component=libguestfs&product=Virtualization+Tools>"
5781 msgstr ""
5782 "L<https://bugzilla.redhat.com/buglist.cgi?"
5783 "component=libguestfs&product=Virtualization+Tools>"
5784
5785 #. type: textblock
5786 #: ../src/guestfs.pod:2960
5787 msgid "To report a new bug against libguestfs use this link:"
5788 msgstr "Для звітування щодо вад у libguestfs скористайтеся цим посиланням:"
5789
5790 #. type: textblock
5791 #: ../src/guestfs.pod:2962
5792 msgid ""
5793 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
5794 "component=libguestfs&product=Virtualization+Tools>"
5795 msgstr ""
5796 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
5797 "component=libguestfs&product=Virtualization+Tools>"
5798
5799 #. type: textblock
5800 #: ../src/guestfs.pod:2964
5801 msgid "When reporting a bug, please check:"
5802 msgstr ""
5803
5804 #. type: textblock
5805 #: ../src/guestfs.pod:2970
5806 msgid "That the bug hasn't been reported already."
5807 msgstr ""
5808
5809 #. type: textblock
5810 #: ../src/guestfs.pod:2974
5811 msgid "That you are testing a recent version."
5812 msgstr ""
5813
5814 #. type: textblock
5815 #: ../src/guestfs.pod:2978
5816 msgid "Describe the bug accurately, and give a way to reproduce it."
5817 msgstr ""
5818
5819 #. type: textblock
5820 #: ../src/guestfs.pod:2982
5821 msgid ""
5822 "Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
5823 "bug report."
5824 msgstr ""
5825
5826 #. type: =head1
5827 #: ../src/guestfs.pod:2987 ../fish/guestfish.pod:1183
5828 #: ../test-tool/libguestfs-test-tool.pod:93 ../fuse/guestmount.pod:288
5829 msgid "AUTHORS"
5830 msgstr "АВТОРИ"
5831
5832 #. type: textblock
5833 #: ../src/guestfs.pod:2989 ../fish/guestfish.pod:1185
5834 #: ../test-tool/libguestfs-test-tool.pod:95 ../fuse/guestmount.pod:290
5835 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
5836 msgstr ""
5837
5838 #. type: =head1
5839 #: ../src/guestfs.pod:2991 ../fish/guestfish.pod:1187
5840 #: ../test-tool/libguestfs-test-tool.pod:97 ../fuse/guestmount.pod:292
5841 #: ../tools/virt-edit.pl:514 ../tools/virt-win-reg.pl:602
5842 #: ../tools/virt-list-filesystems.pl:206 ../tools/virt-tar.pl:305
5843 #: ../tools/virt-make-fs.pl:568 ../tools/virt-list-partitions.pl:273
5844 msgid "COPYRIGHT"
5845 msgstr "АВТОРСЬКІ ПРАВА"
5846
5847 #. type: textblock
5848 #: ../src/guestfs.pod:2993 ../fish/guestfish.pod:1189
5849 #: ../test-tool/libguestfs-test-tool.pod:99
5850 msgid "Copyright (C) 2009-2011 Red Hat Inc.  L<http://libguestfs.org/>"
5851 msgstr ""
5852
5853 #. type: textblock
5854 #: ../src/guestfs.pod:2996
5855 msgid ""
5856 "This library is free software; you can redistribute it and/or modify it "
5857 "under the terms of the GNU Lesser General Public License as published by the "
5858 "Free Software Foundation; either version 2 of the License, or (at your "
5859 "option) any later version."
5860 msgstr ""
5861
5862 #. type: textblock
5863 #: ../src/guestfs.pod:3001
5864 msgid ""
5865 "This library is distributed in the hope that it will be useful, but WITHOUT "
5866 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
5867 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License "
5868 "for more details."
5869 msgstr ""
5870
5871 #. type: textblock
5872 #: ../src/guestfs.pod:3006
5873 msgid ""
5874 "You should have received a copy of the GNU Lesser General Public License "
5875 "along with this library; if not, write to the Free Software Foundation, "
5876 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA"
5877 msgstr ""
5878
5879 #. type: =head2
5880 #: ../src/guestfs-actions.pod:1
5881 msgid "guestfs_add_cdrom"
5882 msgstr ""
5883
5884 #. type: verbatim
5885 #: ../src/guestfs-actions.pod:3
5886 #, no-wrap
5887 msgid ""
5888 " int\n"
5889 " guestfs_add_cdrom (guestfs_h *g,\n"
5890 "                    const char *filename);\n"
5891 "\n"
5892 msgstr ""
5893
5894 #. type: textblock
5895 #: ../src/guestfs-actions.pod:7 ../fish/guestfish-actions.pod:5
5896 msgid "This function adds a virtual CD-ROM disk image to the guest."
5897 msgstr ""
5898
5899 #. type: textblock
5900 #: ../src/guestfs-actions.pod:9 ../fish/guestfish-actions.pod:7
5901 msgid "This is equivalent to the qemu parameter I<-cdrom filename>."
5902 msgstr ""
5903
5904 #. type: textblock
5905 #: ../src/guestfs-actions.pod:17
5906 msgid ""
5907 "This call checks for the existence of C<filename>.  This stops you from "
5908 "specifying other types of drive which are supported by qemu such as C<nbd:> "
5909 "and C<http:> URLs.  To specify those, use the general C<guestfs_config> call "
5910 "instead."
5911 msgstr ""
5912
5913 #. type: textblock
5914 #: ../src/guestfs-actions.pod:24
5915 msgid ""
5916 "If you just want to add an ISO file (often you use this as an efficient way "
5917 "to transfer large files into the guest), then you should probably use "
5918 "C<guestfs_add_drive_ro> instead."
5919 msgstr ""
5920
5921 #. type: textblock
5922 #: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:134
5923 #: ../src/guestfs-actions.pod:195 ../src/guestfs-actions.pod:232
5924 #: ../src/guestfs-actions.pod:246 ../src/guestfs-actions.pod:267
5925 #: ../src/guestfs-actions.pod:287 ../src/guestfs-actions.pod:301
5926 #: ../src/guestfs-actions.pod:421 ../src/guestfs-actions.pod:441
5927 #: ../src/guestfs-actions.pod:455 ../src/guestfs-actions.pod:500
5928 #: ../src/guestfs-actions.pod:528 ../src/guestfs-actions.pod:546
5929 #: ../src/guestfs-actions.pod:613 ../src/guestfs-actions.pod:646
5930 #: ../src/guestfs-actions.pod:660 ../src/guestfs-actions.pod:675
5931 #: ../src/guestfs-actions.pod:774 ../src/guestfs-actions.pod:792
5932 #: ../src/guestfs-actions.pod:806 ../src/guestfs-actions.pod:820
5933 #: ../src/guestfs-actions.pod:981 ../src/guestfs-actions.pod:1001
5934 #: ../src/guestfs-actions.pod:1019 ../src/guestfs-actions.pod:1103
5935 #: ../src/guestfs-actions.pod:1121 ../src/guestfs-actions.pod:1140
5936 #: ../src/guestfs-actions.pod:1154 ../src/guestfs-actions.pod:1174
5937 #: ../src/guestfs-actions.pod:1244 ../src/guestfs-actions.pod:1275
5938 #: ../src/guestfs-actions.pod:1300 ../src/guestfs-actions.pod:1342
5939 #: ../src/guestfs-actions.pod:1448 ../src/guestfs-actions.pod:1482
5940 #: ../src/guestfs-actions.pod:1697 ../src/guestfs-actions.pod:1719
5941 #: ../src/guestfs-actions.pod:1806 ../src/guestfs-actions.pod:2268
5942 #: ../src/guestfs-actions.pod:2412 ../src/guestfs-actions.pod:2473
5943 #: ../src/guestfs-actions.pod:2508 ../src/guestfs-actions.pod:3461
5944 #: ../src/guestfs-actions.pod:3476 ../src/guestfs-actions.pod:3501
5945 #: ../src/guestfs-actions.pod:3656 ../src/guestfs-actions.pod:3670
5946 #: ../src/guestfs-actions.pod:3683 ../src/guestfs-actions.pod:3697
5947 #: ../src/guestfs-actions.pod:3712 ../src/guestfs-actions.pod:3748
5948 #: ../src/guestfs-actions.pod:3820 ../src/guestfs-actions.pod:3840
5949 #: ../src/guestfs-actions.pod:3857 ../src/guestfs-actions.pod:3880
5950 #: ../src/guestfs-actions.pod:3903 ../src/guestfs-actions.pod:3935
5951 #: ../src/guestfs-actions.pod:3954 ../src/guestfs-actions.pod:3973
5952 #: ../src/guestfs-actions.pod:4008 ../src/guestfs-actions.pod:4020
5953 #: ../src/guestfs-actions.pod:4056 ../src/guestfs-actions.pod:4072
5954 #: ../src/guestfs-actions.pod:4085 ../src/guestfs-actions.pod:4100
5955 #: ../src/guestfs-actions.pod:4117 ../src/guestfs-actions.pod:4210
5956 #: ../src/guestfs-actions.pod:4230 ../src/guestfs-actions.pod:4243
5957 #: ../src/guestfs-actions.pod:4294 ../src/guestfs-actions.pod:4312
5958 #: ../src/guestfs-actions.pod:4330 ../src/guestfs-actions.pod:4346
5959 #: ../src/guestfs-actions.pod:4360 ../src/guestfs-actions.pod:4374
5960 #: ../src/guestfs-actions.pod:4391 ../src/guestfs-actions.pod:4406
5961 #: ../src/guestfs-actions.pod:4426 ../src/guestfs-actions.pod:4484
5962 #: ../src/guestfs-actions.pod:4557 ../src/guestfs-actions.pod:4588
5963 #: ../src/guestfs-actions.pod:4607 ../src/guestfs-actions.pod:4626
5964 #: ../src/guestfs-actions.pod:4638 ../src/guestfs-actions.pod:4655
5965 #: ../src/guestfs-actions.pod:4668 ../src/guestfs-actions.pod:4683
5966 #: ../src/guestfs-actions.pod:4698 ../src/guestfs-actions.pod:4733
5967 #: ../src/guestfs-actions.pod:4755 ../src/guestfs-actions.pod:4775
5968 #: ../src/guestfs-actions.pod:4789 ../src/guestfs-actions.pod:4806
5969 #: ../src/guestfs-actions.pod:4855 ../src/guestfs-actions.pod:4901
5970 #: ../src/guestfs-actions.pod:4915 ../src/guestfs-actions.pod:4943
5971 #: ../src/guestfs-actions.pod:4960 ../src/guestfs-actions.pod:4978
5972 #: ../src/guestfs-actions.pod:5112 ../src/guestfs-actions.pod:5169
5973 #: ../src/guestfs-actions.pod:5191 ../src/guestfs-actions.pod:5209
5974 #: ../src/guestfs-actions.pod:5241 ../src/guestfs-actions.pod:5307
5975 #: ../src/guestfs-actions.pod:5324 ../src/guestfs-actions.pod:5337
5976 #: ../src/guestfs-actions.pod:5351 ../src/guestfs-actions.pod:5640
5977 #: ../src/guestfs-actions.pod:5659 ../src/guestfs-actions.pod:5678
5978 #: ../src/guestfs-actions.pod:5690 ../src/guestfs-actions.pod:5702
5979 #: ../src/guestfs-actions.pod:5716 ../src/guestfs-actions.pod:5728
5980 #: ../src/guestfs-actions.pod:5742 ../src/guestfs-actions.pod:5758
5981 #: ../src/guestfs-actions.pod:5779 ../src/guestfs-actions.pod:5798
5982 #: ../src/guestfs-actions.pod:5817 ../src/guestfs-actions.pod:5847
5983 #: ../src/guestfs-actions.pod:5863 ../src/guestfs-actions.pod:5886
5984 #: ../src/guestfs-actions.pod:5904 ../src/guestfs-actions.pod:5923
5985 #: ../src/guestfs-actions.pod:5944 ../src/guestfs-actions.pod:5963
5986 #: ../src/guestfs-actions.pod:5980 ../src/guestfs-actions.pod:6008
5987 #: ../src/guestfs-actions.pod:6032 ../src/guestfs-actions.pod:6051
5988 #: ../src/guestfs-actions.pod:6075 ../src/guestfs-actions.pod:6094
5989 #: ../src/guestfs-actions.pod:6109 ../src/guestfs-actions.pod:6128
5990 #: ../src/guestfs-actions.pod:6165 ../src/guestfs-actions.pod:6195
5991 #: ../src/guestfs-actions.pod:6228 ../src/guestfs-actions.pod:6350
5992 #: ../src/guestfs-actions.pod:6471 ../src/guestfs-actions.pod:6483
5993 #: ../src/guestfs-actions.pod:6496 ../src/guestfs-actions.pod:6509
5994 #: ../src/guestfs-actions.pod:6531 ../src/guestfs-actions.pod:6544
5995 #: ../src/guestfs-actions.pod:6557 ../src/guestfs-actions.pod:6570
5996 #: ../src/guestfs-actions.pod:6585 ../src/guestfs-actions.pod:6644
5997 #: ../src/guestfs-actions.pod:6661 ../src/guestfs-actions.pod:6677
5998 #: ../src/guestfs-actions.pod:6693 ../src/guestfs-actions.pod:6710
5999 #: ../src/guestfs-actions.pod:6723 ../src/guestfs-actions.pod:6743
6000 #: ../src/guestfs-actions.pod:6779 ../src/guestfs-actions.pod:6793
6001 #: ../src/guestfs-actions.pod:6834 ../src/guestfs-actions.pod:6847
6002 #: ../src/guestfs-actions.pod:6865 ../src/guestfs-actions.pod:6899
6003 #: ../src/guestfs-actions.pod:6935 ../src/guestfs-actions.pod:7054
6004 #: ../src/guestfs-actions.pod:7072 ../src/guestfs-actions.pod:7086
6005 #: ../src/guestfs-actions.pod:7141 ../src/guestfs-actions.pod:7154
6006 #: ../src/guestfs-actions.pod:7199 ../src/guestfs-actions.pod:7232
6007 #: ../src/guestfs-actions.pod:7293 ../src/guestfs-actions.pod:7319
6008 #: ../src/guestfs-actions.pod:7385 ../src/guestfs-actions.pod:7404
6009 #: ../src/guestfs-actions.pod:7433
6010 msgid "This function returns 0 on success or -1 on error."
6011 msgstr ""
6012
6013 #. type: textblock
6014 #: ../src/guestfs-actions.pod:32 ../src/guestfs-actions.pod:248
6015 #: ../src/guestfs-actions.pod:269
6016 msgid ""
6017 "This function is deprecated.  In new code, use the L</"
6018 "guestfs_add_drive_opts> call instead."
6019 msgstr ""
6020
6021 #. type: textblock
6022 #: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:251
6023 #: ../src/guestfs-actions.pod:272 ../src/guestfs-actions.pod:1453
6024 #: ../src/guestfs-actions.pod:1946 ../src/guestfs-actions.pod:1967
6025 #: ../src/guestfs-actions.pod:4431 ../src/guestfs-actions.pod:4738
6026 #: ../src/guestfs-actions.pod:6173 ../src/guestfs-actions.pod:6203
6027 #: ../src/guestfs-actions.pod:6236 ../src/guestfs-actions.pod:6295
6028 #: ../src/guestfs-actions.pod:7237 ../src/guestfs-actions.pod:7327
6029 #: ../src/guestfs-actions.pod:7496 ../fish/guestfish-actions.pod:31
6030 #: ../fish/guestfish-actions.pod:161 ../fish/guestfish-actions.pod:175
6031 #: ../fish/guestfish-actions.pod:961 ../fish/guestfish-actions.pod:1321
6032 #: ../fish/guestfish-actions.pod:1335 ../fish/guestfish-actions.pod:3010
6033 #: ../fish/guestfish-actions.pod:3207 ../fish/guestfish-actions.pod:4188
6034 #: ../fish/guestfish-actions.pod:4211 ../fish/guestfish-actions.pod:4233
6035 #: ../fish/guestfish-actions.pod:4271 ../fish/guestfish-actions.pod:4912
6036 #: ../fish/guestfish-actions.pod:5009
6037 msgid ""
6038 "Deprecated functions will not be removed from the API, but the fact that "
6039 "they are deprecated indicates that there are problems with correct use of "
6040 "these functions."
6041 msgstr ""
6042
6043 #. type: textblock
6044 #: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:136
6045 #: ../src/guestfs-actions.pod:1105 ../src/guestfs-actions.pod:1918
6046 #: ../src/guestfs-actions.pod:2016 ../src/guestfs-actions.pod:2119
6047 #: ../src/guestfs-actions.pod:3463 ../src/guestfs-actions.pod:3483
6048 #: ../src/guestfs-actions.pod:4742 ../src/guestfs-actions.pod:5865
6049 #: ../src/guestfs-actions.pod:5982 ../src/guestfs-actions.pod:6096
6050 #: ../src/guestfs-actions.pod:6587 ../src/guestfs-actions.pod:6712
6051 #: ../src/guestfs-actions.pod:7241
6052 msgid "(Added in 0.3)"
6053 msgstr ""
6054
6055 #. type: =head2
6056 #: ../src/guestfs-actions.pod:41
6057 msgid "guestfs_add_domain"
6058 msgstr ""
6059
6060 #. type: verbatim
6061 #: ../src/guestfs-actions.pod:43
6062 #, no-wrap
6063 msgid ""
6064 " int\n"
6065 " guestfs_add_domain (guestfs_h *g,\n"
6066 "                     const char *dom,\n"
6067 "                     ...);\n"
6068 "\n"
6069 msgstr ""
6070
6071 #. type: textblock
6072 #: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:145
6073 #: ../src/guestfs-actions.pod:4445
6074 msgid ""
6075 "You may supply a list of optional arguments to this call.  Use zero or more "
6076 "of the following pairs of parameters, and terminate the list with C<-1> on "
6077 "its own.  See L</CALLS WITH OPTIONAL ARGUMENTS>."
6078 msgstr ""
6079
6080 #. type: verbatim
6081 #: ../src/guestfs-actions.pod:53
6082 #, no-wrap
6083 msgid ""
6084 " GUESTFS_ADD_DOMAIN_LIBVIRTURI, const char *libvirturi,\n"
6085 " GUESTFS_ADD_DOMAIN_READONLY, int readonly,\n"
6086 " GUESTFS_ADD_DOMAIN_IFACE, const char *iface,\n"
6087 " GUESTFS_ADD_DOMAIN_LIVE, int live,\n"
6088 "\n"
6089 msgstr ""
6090
6091 #. type: textblock
6092 #: ../src/guestfs-actions.pod:58
6093 msgid ""
6094 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
6095 "It works by connecting to libvirt, requesting the domain and domain XML from "
6096 "libvirt, parsing it for disks, and calling C<guestfs_add_drive_opts> on each "
6097 "one."
6098 msgstr ""
6099
6100 #. type: textblock
6101 #: ../src/guestfs-actions.pod:63 ../fish/guestfish-actions.pod:46
6102 msgid ""
6103 "The number of disks added is returned.  This operation is atomic: if an "
6104 "error is returned, then no disks are added."
6105 msgstr ""
6106
6107 #. type: textblock
6108 #: ../src/guestfs-actions.pod:66 ../fish/guestfish-actions.pod:49
6109 msgid ""
6110 "This function does some minimal checks to make sure the libvirt domain is "
6111 "not running (unless C<readonly> is true).  In a future version we will try "
6112 "to acquire the libvirt lock on each disk."
6113 msgstr ""
6114
6115 #. type: textblock
6116 #: ../src/guestfs-actions.pod:70 ../fish/guestfish-actions.pod:53
6117 msgid ""
6118 "Disks must be accessible locally.  This often means that adding disks from a "
6119 "remote libvirt connection (see L<http://libvirt.org/remote.html>)  will fail "
6120 "unless those disks are accessible via the same device path locally too."
6121 msgstr ""
6122
6123 #. type: textblock
6124 #: ../src/guestfs-actions.pod:75 ../fish/guestfish-actions.pod:58
6125 msgid ""
6126 "The optional C<libvirturi> parameter sets the libvirt URI (see L<http://"
6127 "libvirt.org/uri.html>).  If this is not set then we connect to the default "
6128 "libvirt URI (or one set through an environment variable, see the libvirt "
6129 "documentation for full details)."
6130 msgstr ""
6131
6132 #. type: textblock
6133 #: ../src/guestfs-actions.pod:81 ../fish/guestfish-actions.pod:64
6134 msgid ""
6135 "The optional C<live> flag controls whether this call will try to connect to "
6136 "a running virtual machine C<guestfsd> process if it sees a suitable "
6137 "E<lt>channelE<gt> element in the libvirt XML definition.  The default (if "
6138 "the flag is omitted) is never to try.  See L<guestfs(3)/ATTACHING TO RUNNING "
6139 "DAEMONS> for more information."
6140 msgstr ""
6141
6142 #. type: textblock
6143 #: ../src/guestfs-actions.pod:88
6144 msgid ""
6145 "The other optional parameters are passed directly through to "
6146 "C<guestfs_add_drive_opts>."
6147 msgstr ""
6148
6149 #. type: textblock
6150 #: ../src/guestfs-actions.pod:91 ../src/guestfs-actions.pod:344
6151 #: ../src/guestfs-actions.pod:514 ../src/guestfs-actions.pod:692
6152 #: ../src/guestfs-actions.pod:723 ../src/guestfs-actions.pod:741
6153 #: ../src/guestfs-actions.pod:760 ../src/guestfs-actions.pod:1320
6154 #: ../src/guestfs-actions.pod:1676 ../src/guestfs-actions.pod:1879
6155 #: ../src/guestfs-actions.pod:1988 ../src/guestfs-actions.pod:2028
6156 #: ../src/guestfs-actions.pod:2083 ../src/guestfs-actions.pod:2106
6157 #: ../src/guestfs-actions.pod:2399 ../src/guestfs-actions.pod:2782
6158 #: ../src/guestfs-actions.pod:2803 ../src/guestfs-actions.pod:4878
6159 #: ../src/guestfs-actions.pod:5015 ../src/guestfs-actions.pod:5421
6160 #: ../src/guestfs-actions.pod:5447 ../src/guestfs-actions.pod:6820
6161 #: ../src/guestfs-actions.pod:7252 ../src/guestfs-actions.pod:7265
6162 #: ../src/guestfs-actions.pod:7278
6163 msgid "On error this function returns -1."
6164 msgstr ""
6165
6166 #. type: textblock
6167 #: ../src/guestfs-actions.pod:93
6168 msgid "(Added in 1.7.4)"
6169 msgstr ""
6170
6171 #. type: =head2
6172 #: ../src/guestfs-actions.pod:95
6173 msgid "guestfs_add_domain_va"
6174 msgstr ""
6175
6176 #. type: verbatim
6177 #: ../src/guestfs-actions.pod:97
6178 #, no-wrap
6179 msgid ""
6180 " int\n"
6181 " guestfs_add_domain_va (guestfs_h *g,\n"
6182 "                        const char *dom,\n"
6183 "                        va_list args);\n"
6184 "\n"
6185 msgstr ""
6186
6187 #. type: textblock
6188 #: ../src/guestfs-actions.pod:102
6189 msgid "This is the \"va_list variant\" of L</guestfs_add_domain>."
6190 msgstr ""
6191
6192 #. type: textblock
6193 #: ../src/guestfs-actions.pod:104 ../src/guestfs-actions.pod:115
6194 #: ../src/guestfs-actions.pod:208 ../src/guestfs-actions.pod:219
6195 #: ../src/guestfs-actions.pod:4498 ../src/guestfs-actions.pod:4510
6196 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>."
6197 msgstr ""
6198
6199 #. type: =head2
6200 #: ../src/guestfs-actions.pod:106
6201 msgid "guestfs_add_domain_argv"
6202 msgstr ""
6203
6204 #. type: verbatim
6205 #: ../src/guestfs-actions.pod:108
6206 #, no-wrap
6207 msgid ""
6208 " int\n"
6209 " guestfs_add_domain_argv (guestfs_h *g,\n"
6210 "                          const char *dom,\n"
6211 "                          const struct guestfs_add_domain_argv *optargs);\n"
6212 "\n"
6213 msgstr ""
6214
6215 #. type: textblock
6216 #: ../src/guestfs-actions.pod:113
6217 msgid "This is the \"argv variant\" of L</guestfs_add_domain>."
6218 msgstr ""
6219
6220 #. type: =head2
6221 #: ../src/guestfs-actions.pod:117
6222 msgid "guestfs_add_drive"
6223 msgstr ""
6224
6225 #. type: verbatim
6226 #: ../src/guestfs-actions.pod:119
6227 #, no-wrap
6228 msgid ""
6229 " int\n"
6230 " guestfs_add_drive (guestfs_h *g,\n"
6231 "                    const char *filename);\n"
6232 "\n"
6233 msgstr ""
6234
6235 #. type: textblock
6236 #: ../src/guestfs-actions.pod:123
6237 msgid ""
6238 "This function is the equivalent of calling C<guestfs_add_drive_opts> with no "
6239 "optional parameters, so the disk is added writable, with the format being "
6240 "detected automatically."
6241 msgstr ""
6242
6243 #. type: textblock
6244 #: ../src/guestfs-actions.pod:127
6245 msgid ""
6246 "Automatic detection of the format opens you up to a potential security hole "
6247 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
6248 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
6249 "you should think about replacing calls to this function with calls to "
6250 "C<guestfs_add_drive_opts>, and specifying the format."
6251 msgstr ""
6252
6253 #. type: =head2
6254 #: ../src/guestfs-actions.pod:138
6255 msgid "guestfs_add_drive_opts"
6256 msgstr ""
6257
6258 #. type: verbatim
6259 #: ../src/guestfs-actions.pod:140
6260 #, no-wrap
6261 msgid ""
6262 " int\n"
6263 " guestfs_add_drive_opts (guestfs_h *g,\n"
6264 "                         const char *filename,\n"
6265 "                         ...);\n"
6266 "\n"
6267 msgstr ""
6268
6269 #. type: verbatim
6270 #: ../src/guestfs-actions.pod:150
6271 #, no-wrap
6272 msgid ""
6273 " GUESTFS_ADD_DRIVE_OPTS_READONLY, int readonly,\n"
6274 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, const char *format,\n"
6275 " GUESTFS_ADD_DRIVE_OPTS_IFACE, const char *iface,\n"
6276 "\n"
6277 msgstr ""
6278
6279 #. type: textblock
6280 #: ../src/guestfs-actions.pod:154 ../fish/guestfish-actions.pod:97
6281 msgid ""
6282 "This function adds a virtual machine disk image C<filename> to libguestfs.  "
6283 "The first time you call this function, the disk appears as C</dev/sda>, the "
6284 "second time as C</dev/sdb>, and so on."
6285 msgstr ""
6286
6287 #. type: textblock
6288 #: ../src/guestfs-actions.pod:159 ../fish/guestfish-actions.pod:102
6289 msgid ""
6290 "You don't necessarily need to be root when using libguestfs.  However you "
6291 "obviously do need sufficient permissions to access the filename for whatever "
6292 "operations you want to perform (ie. read access if you just want to read the "
6293 "image or write access if you want to modify the image)."
6294 msgstr ""
6295
6296 #. type: textblock
6297 #: ../src/guestfs-actions.pod:165 ../fish/guestfish-actions.pod:108
6298 msgid "This call checks that C<filename> exists."
6299 msgstr ""
6300
6301 #. type: textblock
6302 #: ../src/guestfs-actions.pod:167 ../src/guestfs-actions.pod:4456
6303 #: ../fish/guestfish-actions.pod:110 ../fish/guestfish-actions.pod:3021
6304 msgid "The optional arguments are:"
6305 msgstr ""
6306
6307 #. type: =item
6308 #: ../src/guestfs-actions.pod:171 ../fish/guestfish-actions.pod:114
6309 msgid "C<readonly>"
6310 msgstr "C<readonly>"
6311
6312 #. type: textblock
6313 #: ../src/guestfs-actions.pod:173 ../fish/guestfish-actions.pod:116
6314 msgid ""
6315 "If true then the image is treated as read-only.  Writes are still allowed, "
6316 "but they are stored in a temporary snapshot overlay which is discarded at "
6317 "the end.  The disk that you add is not modified."
6318 msgstr ""
6319
6320 #. type: =item
6321 #: ../src/guestfs-actions.pod:177 ../fish/guestfish-actions.pod:120
6322 msgid "C<format>"
6323 msgstr "C<format>"
6324
6325 #. type: textblock
6326 #: ../src/guestfs-actions.pod:179
6327 msgid ""
6328 "This forces the image format.  If you omit this (or use C<guestfs_add_drive> "
6329 "or C<guestfs_add_drive_ro>) then the format is automatically detected.  "
6330 "Possible formats include C<raw> and C<qcow2>."
6331 msgstr ""
6332
6333 #. type: textblock
6334 #: ../src/guestfs-actions.pod:183 ../fish/guestfish-actions.pod:126
6335 msgid ""
6336 "Automatic detection of the format opens you up to a potential security hole "
6337 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
6338 "RHBZ#642934.  Specifying the format closes this security hole."
6339 msgstr ""
6340
6341 #. type: =item
6342 #: ../src/guestfs-actions.pod:188 ../fish/guestfish-actions.pod:131
6343 msgid "C<iface>"
6344 msgstr "C<iface>"
6345
6346 #. type: textblock
6347 #: ../src/guestfs-actions.pod:190
6348 msgid ""
6349 "This rarely-used option lets you emulate the behaviour of the deprecated "
6350 "C<guestfs_add_drive_with_if> call (q.v.)"
6351 msgstr ""
6352
6353 #. type: textblock
6354 #: ../src/guestfs-actions.pod:197
6355 msgid "(Added in 1.5.23)"
6356 msgstr ""
6357
6358 #. type: =head2
6359 #: ../src/guestfs-actions.pod:199
6360 msgid "guestfs_add_drive_opts_va"
6361 msgstr ""
6362
6363 #. type: verbatim
6364 #: ../src/guestfs-actions.pod:201
6365 #, no-wrap
6366 msgid ""
6367 " int\n"
6368 " guestfs_add_drive_opts_va (guestfs_h *g,\n"
6369 "                            const char *filename,\n"
6370 "                            va_list args);\n"
6371 "\n"
6372 msgstr ""
6373
6374 #. type: textblock
6375 #: ../src/guestfs-actions.pod:206
6376 msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>."
6377 msgstr ""
6378
6379 #. type: =head2
6380 #: ../src/guestfs-actions.pod:210
6381 msgid "guestfs_add_drive_opts_argv"
6382 msgstr ""
6383
6384 #. type: verbatim
6385 #: ../src/guestfs-actions.pod:212
6386 #, no-wrap
6387 msgid ""
6388 " int\n"
6389 " guestfs_add_drive_opts_argv (guestfs_h *g,\n"
6390 "                              const char *filename,\n"
6391 "                              const struct guestfs_add_drive_opts_argv *optargs);\n"
6392 "\n"
6393 msgstr ""
6394
6395 #. type: textblock
6396 #: ../src/guestfs-actions.pod:217
6397 msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>."
6398 msgstr ""
6399
6400 #. type: =head2
6401 #: ../src/guestfs-actions.pod:221
6402 msgid "guestfs_add_drive_ro"
6403 msgstr ""
6404
6405 #. type: verbatim
6406 #: ../src/guestfs-actions.pod:223
6407 #, no-wrap
6408 msgid ""
6409 " int\n"
6410 " guestfs_add_drive_ro (guestfs_h *g,\n"
6411 "                       const char *filename);\n"
6412 "\n"
6413 msgstr ""
6414
6415 #. type: textblock
6416 #: ../src/guestfs-actions.pod:227
6417 msgid ""
6418 "This function is the equivalent of calling C<guestfs_add_drive_opts> with "
6419 "the optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the "
6420 "disk is added read-only, with the format being detected automatically."
6421 msgstr ""
6422
6423 #. type: textblock
6424 #: ../src/guestfs-actions.pod:234
6425 msgid "(Added in 1.0.38)"
6426 msgstr ""
6427
6428 #. type: =head2
6429 #: ../src/guestfs-actions.pod:236
6430 msgid "guestfs_add_drive_ro_with_if"
6431 msgstr ""
6432
6433 #. type: verbatim
6434 #: ../src/guestfs-actions.pod:238
6435 #, no-wrap
6436 msgid ""
6437 " int\n"
6438 " guestfs_add_drive_ro_with_if (guestfs_h *g,\n"
6439 "                               const char *filename,\n"
6440 "                               const char *iface);\n"
6441 "\n"
6442 msgstr ""
6443
6444 #. type: textblock
6445 #: ../src/guestfs-actions.pod:243
6446 msgid ""
6447 "This is the same as C<guestfs_add_drive_ro> but it allows you to specify the "
6448 "QEMU interface emulation to use at run time."
6449 msgstr ""
6450
6451 #. type: textblock
6452 #: ../src/guestfs-actions.pod:255 ../src/guestfs-actions.pod:276
6453 #: ../src/guestfs-actions.pod:2358
6454 msgid "(Added in 1.0.84)"
6455 msgstr ""
6456
6457 #. type: =head2
6458 #: ../src/guestfs-actions.pod:257
6459 msgid "guestfs_add_drive_with_if"
6460 msgstr ""
6461
6462 #. type: verbatim
6463 #: ../src/guestfs-actions.pod:259
6464 #, no-wrap
6465 msgid ""
6466 " int\n"
6467 " guestfs_add_drive_with_if (guestfs_h *g,\n"
6468 "                            const char *filename,\n"
6469 "                            const char *iface);\n"
6470 "\n"
6471 msgstr ""
6472
6473 #. type: textblock
6474 #: ../src/guestfs-actions.pod:264
6475 msgid ""
6476 "This is the same as C<guestfs_add_drive> but it allows you to specify the "
6477 "QEMU interface emulation to use at run time."
6478 msgstr ""
6479
6480 #. type: =head2
6481 #: ../src/guestfs-actions.pod:278
6482 msgid "guestfs_aug_clear"
6483 msgstr ""
6484
6485 #. type: verbatim
6486 #: ../src/guestfs-actions.pod:280
6487 #, no-wrap
6488 msgid ""
6489 " int\n"
6490 " guestfs_aug_clear (guestfs_h *g,\n"
6491 "                    const char *augpath);\n"
6492 "\n"
6493 msgstr ""
6494
6495 #. type: textblock
6496 #: ../src/guestfs-actions.pod:284 ../fish/guestfish-actions.pod:183
6497 msgid ""
6498 "Set the value associated with C<path> to C<NULL>.  This is the same as the "
6499 "L<augtool(1)> C<clear> command."
6500 msgstr ""
6501
6502 #. type: textblock
6503 #: ../src/guestfs-actions.pod:289 ../src/guestfs-actions.pod:2108
6504 msgid "(Added in 1.3.4)"
6505 msgstr ""
6506
6507 #. type: =head2
6508 #: ../src/guestfs-actions.pod:291
6509 msgid "guestfs_aug_close"
6510 msgstr ""
6511
6512 #. type: verbatim
6513 #: ../src/guestfs-actions.pod:293
6514 #, no-wrap
6515 msgid ""
6516 " int\n"
6517 " guestfs_aug_close (guestfs_h *g);\n"
6518 "\n"
6519 msgstr ""
6520
6521 #. type: textblock
6522 #: ../src/guestfs-actions.pod:296
6523 msgid ""
6524 "Close the current Augeas handle and free up any resources used by it.  After "
6525 "calling this, you have to call C<guestfs_aug_init> again before you can use "
6526 "any other Augeas functions."
6527 msgstr ""
6528
6529 #. type: textblock
6530 #: ../src/guestfs-actions.pod:303 ../src/guestfs-actions.pod:328
6531 #: ../src/guestfs-actions.pod:346 ../src/guestfs-actions.pod:360
6532 #: ../src/guestfs-actions.pod:423 ../src/guestfs-actions.pod:443
6533 #: ../src/guestfs-actions.pod:457 ../src/guestfs-actions.pod:488
6534 #: ../src/guestfs-actions.pod:502 ../src/guestfs-actions.pod:516
6535 #: ../src/guestfs-actions.pod:530 ../src/guestfs-actions.pod:548
6536 #: ../src/guestfs-actions.pod:5498
6537 msgid "(Added in 0.7)"
6538 msgstr ""
6539
6540 #. type: =head2
6541 #: ../src/guestfs-actions.pod:305
6542 msgid "guestfs_aug_defnode"
6543 msgstr ""
6544
6545 #. type: verbatim
6546 #: ../src/guestfs-actions.pod:307
6547 #, no-wrap
6548 msgid ""
6549 " struct guestfs_int_bool *\n"
6550 " guestfs_aug_defnode (guestfs_h *g,\n"
6551 "                      const char *name,\n"
6552 "                      const char *expr,\n"
6553 "                      const char *val);\n"
6554 "\n"
6555 msgstr ""
6556
6557 #. type: textblock
6558 #: ../src/guestfs-actions.pod:313 ../fish/guestfish-actions.pod:199
6559 msgid ""
6560 "Defines a variable C<name> whose value is the result of evaluating C<expr>."
6561 msgstr ""
6562
6563 #. type: textblock
6564 #: ../src/guestfs-actions.pod:316
6565 msgid ""
6566 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
6567 "calling C<guestfs_aug_set> C<expr>, C<value>.  C<name> will be the nodeset "
6568 "containing that single node."
6569 msgstr ""
6570
6571 #. type: textblock
6572 #: ../src/guestfs-actions.pod:320 ../fish/guestfish-actions.pod:206
6573 msgid ""
6574 "On success this returns a pair containing the number of nodes in the "
6575 "nodeset, and a boolean flag if a node was created."
6576 msgstr ""
6577
6578 #. type: textblock
6579 #: ../src/guestfs-actions.pod:324
6580 msgid ""
6581 "This function returns a C<struct guestfs_int_bool *>, or NULL if there was "
6582 "an error.  I<The caller must call C<guestfs_free_int_bool> after use>."
6583 msgstr ""
6584
6585 #. type: =head2
6586 #: ../src/guestfs-actions.pod:330
6587 msgid "guestfs_aug_defvar"
6588 msgstr ""
6589
6590 #. type: verbatim
6591 #: ../src/guestfs-actions.pod:332
6592 #, no-wrap
6593 msgid ""
6594 " int\n"
6595 " guestfs_aug_defvar (guestfs_h *g,\n"
6596 "                     const char *name,\n"
6597 "                     const char *expr);\n"
6598 "\n"
6599 msgstr ""
6600
6601 #. type: textblock
6602 #: ../src/guestfs-actions.pod:337 ../fish/guestfish-actions.pod:214
6603 msgid ""
6604 "Defines an Augeas variable C<name> whose value is the result of evaluating "
6605 "C<expr>.  If C<expr> is NULL, then C<name> is undefined."
6606 msgstr ""
6607
6608 #. type: textblock
6609 #: ../src/guestfs-actions.pod:341 ../fish/guestfish-actions.pod:218
6610 msgid ""
6611 "On success this returns the number of nodes in C<expr>, or C<0> if C<expr> "
6612 "evaluates to something which is not a nodeset."
6613 msgstr ""
6614
6615 #. type: =head2
6616 #: ../src/guestfs-actions.pod:348
6617 msgid "guestfs_aug_get"
6618 msgstr ""
6619
6620 #. type: verbatim
6621 #: ../src/guestfs-actions.pod:350
6622 #, no-wrap
6623 msgid ""
6624 " char *\n"
6625 " guestfs_aug_get (guestfs_h *g,\n"
6626 "                  const char *augpath);\n"
6627 "\n"
6628 msgstr ""
6629
6630 #. type: textblock
6631 #: ../src/guestfs-actions.pod:354 ../fish/guestfish-actions.pod:225
6632 msgid ""
6633 "Look up the value associated with C<path>.  If C<path> matches exactly one "
6634 "node, the C<value> is returned."
6635 msgstr ""
6636
6637 #. type: textblock
6638 #: ../src/guestfs-actions.pod:357 ../src/guestfs-actions.pod:862
6639 #: ../src/guestfs-actions.pod:880 ../src/guestfs-actions.pod:940
6640 #: ../src/guestfs-actions.pod:956 ../src/guestfs-actions.pod:1059
6641 #: ../src/guestfs-actions.pod:1189 ../src/guestfs-actions.pod:1206
6642 #: ../src/guestfs-actions.pod:1225 ../src/guestfs-actions.pod:1359
6643 #: ../src/guestfs-actions.pod:1547 ../src/guestfs-actions.pod:1659
6644 #: ../src/guestfs-actions.pod:1822 ../src/guestfs-actions.pod:1839
6645 #: ../src/guestfs-actions.pod:1906 ../src/guestfs-actions.pod:1940
6646 #: ../src/guestfs-actions.pod:1961 ../src/guestfs-actions.pod:2131
6647 #: ../src/guestfs-actions.pod:2323 ../src/guestfs-actions.pod:2530
6648 #: ../src/guestfs-actions.pod:2623 ../src/guestfs-actions.pod:2734
6649 #: ../src/guestfs-actions.pod:2754 ../src/guestfs-actions.pod:2874
6650 #: ../src/guestfs-actions.pod:2905 ../src/guestfs-actions.pod:2929
6651 #: ../src/guestfs-actions.pod:2966 ../src/guestfs-actions.pod:3026
6652 #: ../src/guestfs-actions.pod:3049 ../src/guestfs-actions.pod:3070
6653 #: ../src/guestfs-actions.pod:3642 ../src/guestfs-actions.pod:3992
6654 #: ../src/guestfs-actions.pod:4162 ../src/guestfs-actions.pod:4272
6655 #: ../src/guestfs-actions.pod:5033 ../src/guestfs-actions.pod:5226
6656 #: ../src/guestfs-actions.pod:5396 ../src/guestfs-actions.pod:5574
6657 #: ../src/guestfs-actions.pod:5623 ../src/guestfs-actions.pod:6256
6658 #: ../src/guestfs-actions.pod:6272 ../src/guestfs-actions.pod:6289
6659 #: ../src/guestfs-actions.pod:6320 ../src/guestfs-actions.pod:6994
6660 #: ../src/guestfs-actions.pod:7013 ../src/guestfs-actions.pod:7031
6661 #: ../src/guestfs-actions.pod:7211 ../src/guestfs-actions.pod:7490
6662 msgid ""
6663 "This function returns a string, or NULL on error.  I<The caller must free "
6664 "the returned string after use>."
6665 msgstr ""
6666
6667 #. type: =head2
6668 #: ../src/guestfs-actions.pod:362
6669 msgid "guestfs_aug_init"
6670 msgstr ""
6671
6672 #. type: verbatim
6673 #: ../src/guestfs-actions.pod:364
6674 #, no-wrap
6675 msgid ""
6676 " int\n"
6677 " guestfs_aug_init (guestfs_h *g,\n"
6678 "                   const char *root,\n"
6679 "                   int flags);\n"
6680 "\n"
6681 msgstr ""
6682
6683 #. type: textblock
6684 #: ../src/guestfs-actions.pod:369 ../fish/guestfish-actions.pod:232
6685 msgid ""
6686 "Create a new Augeas handle for editing configuration files.  If there was "
6687 "any previous Augeas handle associated with this guestfs session, then it is "
6688 "closed."
6689 msgstr ""
6690
6691 #. type: textblock
6692 #: ../src/guestfs-actions.pod:373
6693 msgid "You must call this before using any other C<guestfs_aug_*> commands."
6694 msgstr ""
6695
6696 #. type: textblock
6697 #: ../src/guestfs-actions.pod:376 ../fish/guestfish-actions.pod:239
6698 msgid ""
6699 "C<root> is the filesystem root.  C<root> must not be NULL, use C</> instead."
6700 msgstr ""
6701
6702 #. type: textblock
6703 #: ../src/guestfs-actions.pod:379 ../fish/guestfish-actions.pod:242
6704 msgid ""
6705 "The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the "
6706 "logical I<or> of the following integers:"
6707 msgstr ""
6708
6709 #. type: =item
6710 #: ../src/guestfs-actions.pod:385 ../fish/guestfish-actions.pod:248
6711 msgid "C<AUG_SAVE_BACKUP> = 1"
6712 msgstr "C<AUG_SAVE_BACKUP> = 1"
6713
6714 #. type: textblock
6715 #: ../src/guestfs-actions.pod:387 ../fish/guestfish-actions.pod:250
6716 msgid "Keep the original file with a C<.augsave> extension."
6717 msgstr ""
6718
6719 #. type: =item
6720 #: ../src/guestfs-actions.pod:389 ../fish/guestfish-actions.pod:252
6721 msgid "C<AUG_SAVE_NEWFILE> = 2"
6722 msgstr "C<AUG_SAVE_NEWFILE> = 2"
6723
6724 #. type: textblock
6725 #: ../src/guestfs-actions.pod:391 ../fish/guestfish-actions.pod:254
6726 msgid ""
6727 "Save changes into a file with extension C<.augnew>, and do not overwrite "
6728 "original.  Overrides C<AUG_SAVE_BACKUP>."
6729 msgstr ""
6730
6731 #. type: =item
6732 #: ../src/guestfs-actions.pod:394 ../fish/guestfish-actions.pod:257
6733 msgid "C<AUG_TYPE_CHECK> = 4"
6734 msgstr "C<AUG_TYPE_CHECK> = 4"
6735
6736 #. type: textblock
6737 #: ../src/guestfs-actions.pod:396 ../fish/guestfish-actions.pod:259
6738 msgid "Typecheck lenses."
6739 msgstr ""
6740
6741 #. type: textblock
6742 #: ../src/guestfs-actions.pod:398
6743 msgid ""
6744 "This option is only useful when debugging Augeas lenses.  Use of this option "
6745 "may require additional memory for the libguestfs appliance.  You may need to "
6746 "set the C<LIBGUESTFS_MEMSIZE> environment variable or call "
6747 "C<guestfs_set_memsize>."
6748 msgstr ""
6749
6750 #. type: =item
6751 #: ../src/guestfs-actions.pod:403 ../fish/guestfish-actions.pod:266
6752 msgid "C<AUG_NO_STDINC> = 8"
6753 msgstr "C<AUG_NO_STDINC> = 8"
6754
6755 #. type: textblock
6756 #: ../src/guestfs-actions.pod:405 ../fish/guestfish-actions.pod:268
6757 msgid "Do not use standard load path for modules."
6758 msgstr ""
6759
6760 #. type: =item
6761 #: ../src/guestfs-actions.pod:407 ../fish/guestfish-actions.pod:270
6762 msgid "C<AUG_SAVE_NOOP> = 16"
6763 msgstr "C<AUG_SAVE_NOOP> = 16"
6764
6765 #. type: textblock
6766 #: ../src/guestfs-actions.pod:409 ../fish/guestfish-actions.pod:272
6767 msgid "Make save a no-op, just record what would have been changed."
6768 msgstr ""
6769
6770 #. type: =item
6771 #: ../src/guestfs-actions.pod:411 ../fish/guestfish-actions.pod:274
6772 msgid "C<AUG_NO_LOAD> = 32"
6773 msgstr "C<AUG_NO_LOAD> = 32"
6774
6775 #. type: textblock
6776 #: ../src/guestfs-actions.pod:413
6777 msgid "Do not load the tree in C<guestfs_aug_init>."
6778 msgstr ""
6779
6780 #. type: textblock
6781 #: ../src/guestfs-actions.pod:417
6782 msgid "To close the handle, you can call C<guestfs_aug_close>."
6783 msgstr ""
6784
6785 #. type: textblock
6786 #: ../src/guestfs-actions.pod:419 ../fish/guestfish-actions.pod:282
6787 msgid "To find out more about Augeas, see L<http://augeas.net/>."
6788 msgstr ""
6789
6790 #. type: =head2
6791 #: ../src/guestfs-actions.pod:425
6792 msgid "guestfs_aug_insert"
6793 msgstr ""
6794
6795 #. type: verbatim
6796 #: ../src/guestfs-actions.pod:427
6797 #, no-wrap
6798 msgid ""
6799 " int\n"
6800 " guestfs_aug_insert (guestfs_h *g,\n"
6801 "                     const char *augpath,\n"
6802 "                     const char *label,\n"
6803 "                     int before);\n"
6804 "\n"
6805 msgstr ""
6806
6807 #. type: textblock
6808 #: ../src/guestfs-actions.pod:433 ../fish/guestfish-actions.pod:288
6809 msgid ""
6810 "Create a new sibling C<label> for C<path>, inserting it into the tree before "
6811 "or after C<path> (depending on the boolean flag C<before>)."
6812 msgstr ""
6813
6814 #. type: textblock
6815 #: ../src/guestfs-actions.pod:437 ../fish/guestfish-actions.pod:292
6816 msgid ""
6817 "C<path> must match exactly one existing node in the tree, and C<label> must "
6818 "be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>."
6819 msgstr ""
6820
6821 #. type: =head2
6822 #: ../src/guestfs-actions.pod:445
6823 msgid "guestfs_aug_load"
6824 msgstr ""
6825
6826 #. type: verbatim
6827 #: ../src/guestfs-actions.pod:447
6828 #, no-wrap
6829 msgid ""
6830 " int\n"
6831 " guestfs_aug_load (guestfs_h *g);\n"
6832 "\n"
6833 msgstr ""
6834
6835 #. type: textblock
6836 #: ../src/guestfs-actions.pod:450 ../fish/guestfish-actions.pod:300
6837 msgid "Load files into the tree."
6838 msgstr "Завантажити файли до ієрархії."
6839
6840 #. type: textblock
6841 #: ../src/guestfs-actions.pod:452 ../fish/guestfish-actions.pod:302
6842 msgid "See C<aug_load> in the Augeas documentation for the full gory details."
6843 msgstr ""
6844
6845 #. type: =head2
6846 #: ../src/guestfs-actions.pod:459
6847 msgid "guestfs_aug_ls"
6848 msgstr ""
6849
6850 #. type: verbatim
6851 #: ../src/guestfs-actions.pod:461
6852 #, no-wrap
6853 msgid ""
6854 " char **\n"
6855 " guestfs_aug_ls (guestfs_h *g,\n"
6856 "                 const char *augpath);\n"
6857 "\n"
6858 msgstr ""
6859
6860 #. type: textblock
6861 #: ../src/guestfs-actions.pod:465
6862 msgid ""
6863 "This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and "
6864 "sorting the resulting nodes into alphabetical order."
6865 msgstr ""
6866
6867 #. type: textblock
6868 #: ../src/guestfs-actions.pod:468 ../src/guestfs-actions.pod:484
6869 #: ../src/guestfs-actions.pod:630 ../src/guestfs-actions.pod:1078
6870 #: ../src/guestfs-actions.pod:1374 ../src/guestfs-actions.pod:1393
6871 #: ../src/guestfs-actions.pod:1496 ../src/guestfs-actions.pod:1515
6872 #: ../src/guestfs-actions.pod:1761 ../src/guestfs-actions.pod:2203
6873 #: ../src/guestfs-actions.pod:2219 ../src/guestfs-actions.pod:2238
6874 #: ../src/guestfs-actions.pod:2281 ../src/guestfs-actions.pod:2305
6875 #: ../src/guestfs-actions.pod:2376 ../src/guestfs-actions.pod:2425
6876 #: ../src/guestfs-actions.pod:2692 ../src/guestfs-actions.pod:2983
6877 #: ../src/guestfs-actions.pod:3272 ../src/guestfs-actions.pod:3562
6878 #: ../src/guestfs-actions.pod:3624 ../src/guestfs-actions.pod:3729
6879 #: ../src/guestfs-actions.pod:4134 ../src/guestfs-actions.pod:4839
6880 #: ../src/guestfs-actions.pod:5368 ../src/guestfs-actions.pod:5494
6881 #: ../src/guestfs-actions.pod:5608 ../src/guestfs-actions.pod:6336
6882 #: ../src/guestfs-actions.pod:6397 ../src/guestfs-actions.pod:6452
6883 #: ../src/guestfs-actions.pod:6598 ../src/guestfs-actions.pod:6622
6884 #: ../src/guestfs-actions.pod:7104 ../src/guestfs-actions.pod:7124
6885 #: ../src/guestfs-actions.pod:7171 ../src/guestfs-actions.pod:7343
6886 #: ../src/guestfs-actions.pod:7362 ../src/guestfs-actions.pod:7447
6887 #: ../src/guestfs-actions.pod:7466 ../src/guestfs-actions.pod:7512
6888 #: ../src/guestfs-actions.pod:7531
6889 msgid ""
6890 "This function returns a NULL-terminated array of strings (like L<environ(3)"
6891 ">), or NULL if there was an error.  I<The caller must free the strings and "
6892 "the array after use>."
6893 msgstr ""
6894
6895 #. type: textblock
6896 #: ../src/guestfs-actions.pod:472 ../src/guestfs-actions.pod:1003
6897 #: ../src/guestfs-actions.pod:1021 ../src/guestfs-actions.pod:1431
6898 #: ../src/guestfs-actions.pod:3350 ../src/guestfs-actions.pod:3381
6899 #: ../src/guestfs-actions.pod:3975 ../src/guestfs-actions.pod:4025
6900 #: ../src/guestfs-actions.pod:4212 ../src/guestfs-actions.pod:4245
6901 #: ../src/guestfs-actions.pod:4408 ../src/guestfs-actions.pod:4843
6902 #: ../src/guestfs-actions.pod:5309 ../src/guestfs-actions.pod:5704
6903 #: ../src/guestfs-actions.pod:5718 ../src/guestfs-actions.pod:5730
6904 #: ../src/guestfs-actions.pod:6177 ../src/guestfs-actions.pod:6836
6905 #: ../src/guestfs-actions.pod:6849 ../src/guestfs-actions.pod:7088
6906 #: ../src/guestfs-actions.pod:7331
6907 msgid "(Added in 0.8)"
6908 msgstr ""
6909
6910 #. type: =head2
6911 #: ../src/guestfs-actions.pod:474
6912 msgid "guestfs_aug_match"
6913 msgstr ""
6914
6915 #. type: verbatim
6916 #: ../src/guestfs-actions.pod:476
6917 #, no-wrap
6918 msgid ""
6919 " char **\n"
6920 " guestfs_aug_match (guestfs_h *g,\n"
6921 "                    const char *augpath);\n"
6922 "\n"
6923 msgstr ""
6924
6925 #. type: textblock
6926 #: ../src/guestfs-actions.pod:480 ../fish/guestfish-actions.pod:316
6927 msgid ""
6928 "Returns a list of paths which match the path expression C<path>.  The "
6929 "returned paths are sufficiently qualified so that they match exactly one "
6930 "node in the current tree."
6931 msgstr ""
6932
6933 #. type: =head2
6934 #: ../src/guestfs-actions.pod:490
6935 msgid "guestfs_aug_mv"
6936 msgstr ""
6937
6938 #. type: verbatim
6939 #: ../src/guestfs-actions.pod:492
6940 #, no-wrap
6941 msgid ""
6942 " int\n"
6943 " guestfs_aug_mv (guestfs_h *g,\n"
6944 "                 const char *src,\n"
6945 "                 const char *dest);\n"
6946 "\n"
6947 msgstr ""
6948
6949 #. type: textblock
6950 #: ../src/guestfs-actions.pod:497 ../fish/guestfish-actions.pod:324
6951 msgid ""
6952 "Move the node C<src> to C<dest>.  C<src> must match exactly one node.  "
6953 "C<dest> is overwritten if it exists."
6954 msgstr ""
6955
6956 #. type: =head2
6957 #: ../src/guestfs-actions.pod:504
6958 msgid "guestfs_aug_rm"
6959 msgstr ""
6960
6961 #. type: verbatim
6962 #: ../src/guestfs-actions.pod:506
6963 #, no-wrap
6964 msgid ""
6965 " int\n"
6966 " guestfs_aug_rm (guestfs_h *g,\n"
6967 "                 const char *augpath);\n"
6968 "\n"
6969 msgstr ""
6970
6971 #. type: textblock
6972 #: ../src/guestfs-actions.pod:510 ../fish/guestfish-actions.pod:331
6973 msgid "Remove C<path> and all of its children."
6974 msgstr ""
6975
6976 #. type: textblock
6977 #: ../src/guestfs-actions.pod:512 ../fish/guestfish-actions.pod:333
6978 msgid "On success this returns the number of entries which were removed."
6979 msgstr ""
6980
6981 #. type: =head2
6982 #: ../src/guestfs-actions.pod:518
6983 msgid "guestfs_aug_save"
6984 msgstr ""
6985
6986 #. type: verbatim
6987 #: ../src/guestfs-actions.pod:520
6988 #, no-wrap
6989 msgid ""
6990 " int\n"
6991 " guestfs_aug_save (guestfs_h *g);\n"
6992 "\n"
6993 msgstr ""
6994
6995 #. type: textblock
6996 #: ../src/guestfs-actions.pod:523 ../fish/guestfish-actions.pod:339
6997 msgid "This writes all pending changes to disk."
6998 msgstr ""
6999
7000 #. type: textblock
7001 #: ../src/guestfs-actions.pod:525
7002 msgid ""
7003 "The flags which were passed to C<guestfs_aug_init> affect exactly how files "
7004 "are saved."
7005 msgstr ""
7006
7007 #. type: =head2
7008 #: ../src/guestfs-actions.pod:532
7009 msgid "guestfs_aug_set"
7010 msgstr ""
7011
7012 #. type: verbatim
7013 #: ../src/guestfs-actions.pod:534
7014 #, no-wrap
7015 msgid ""
7016 " int\n"
7017 " guestfs_aug_set (guestfs_h *g,\n"
7018 "                  const char *augpath,\n"
7019 "                  const char *val);\n"
7020 "\n"
7021 msgstr ""
7022
7023 #. type: textblock
7024 #: ../src/guestfs-actions.pod:539 ../fish/guestfish-actions.pod:348
7025 msgid "Set the value associated with C<path> to C<val>."
7026 msgstr ""
7027
7028 #. type: textblock
7029 #: ../src/guestfs-actions.pod:541
7030 msgid ""
7031 "In the Augeas API, it is possible to clear a node by setting the value to "
7032 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
7033 "this call.  Instead you must use the C<guestfs_aug_clear> call."
7034 msgstr ""
7035
7036 #. type: =head2
7037 #: ../src/guestfs-actions.pod:550
7038 msgid "guestfs_available"
7039 msgstr ""
7040
7041 #. type: verbatim
7042 #: ../src/guestfs-actions.pod:552
7043 #, no-wrap
7044 msgid ""
7045 " int\n"
7046 " guestfs_available (guestfs_h *g,\n"
7047 "                    char *const *groups);\n"
7048 "\n"
7049 msgstr ""
7050
7051 #. type: textblock
7052 #: ../src/guestfs-actions.pod:556 ../fish/guestfish-actions.pod:359
7053 msgid ""
7054 "This command is used to check the availability of some groups of "
7055 "functionality in the appliance, which not all builds of the libguestfs "
7056 "appliance will be able to provide."
7057 msgstr ""
7058
7059 #. type: textblock
7060 #: ../src/guestfs-actions.pod:560
7061 msgid ""
7062 "The libguestfs groups, and the functions that those groups correspond to, "
7063 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
7064 "runtime by calling C<guestfs_available_all_groups>."
7065 msgstr ""
7066
7067 #. type: textblock
7068 #: ../src/guestfs-actions.pod:565 ../fish/guestfish-actions.pod:368
7069 msgid ""
7070 "The argument C<groups> is a list of group names, eg: C<[\"inotify\", \"augeas"
7071 "\"]> would check for the availability of the Linux inotify functions and "
7072 "Augeas (configuration file editing) functions."
7073 msgstr ""
7074
7075 #. type: textblock
7076 #: ../src/guestfs-actions.pod:570 ../fish/guestfish-actions.pod:373
7077 msgid "The command returns no error if I<all> requested groups are available."
7078 msgstr ""
7079
7080 #. type: textblock
7081 #: ../src/guestfs-actions.pod:572 ../fish/guestfish-actions.pod:375
7082 msgid ""
7083 "It fails with an error if one or more of the requested groups is unavailable "
7084 "in the appliance."
7085 msgstr ""
7086
7087 #. type: textblock
7088 #: ../src/guestfs-actions.pod:575 ../fish/guestfish-actions.pod:378
7089 msgid ""
7090 "If an unknown group name is included in the list of groups then an error is "
7091 "always returned."
7092 msgstr ""
7093
7094 #. type: textblock
7095 #: ../src/guestfs-actions.pod:578 ../fish/guestfish-actions.pod:381
7096 msgid "I<Notes:>"
7097 msgstr "I<Нотатки:>"
7098
7099 #. type: textblock
7100 #: ../src/guestfs-actions.pod:584
7101 msgid "You must call C<guestfs_launch> before calling this function."
7102 msgstr ""
7103
7104 #. type: textblock
7105 #: ../src/guestfs-actions.pod:586 ../fish/guestfish-actions.pod:389
7106 msgid ""
7107 "The reason is because we don't know what groups are supported by the "
7108 "appliance/daemon until it is running and can be queried."
7109 msgstr ""
7110
7111 #. type: textblock
7112 #: ../src/guestfs-actions.pod:592 ../fish/guestfish-actions.pod:395
7113 msgid ""
7114 "If a group of functions is available, this does not necessarily mean that "
7115 "they will work.  You still have to check for errors when calling individual "
7116 "API functions even if they are available."
7117 msgstr ""
7118
7119 #. type: textblock
7120 #: ../src/guestfs-actions.pod:599 ../fish/guestfish-actions.pod:402
7121 msgid ""
7122 "It is usually the job of distro packagers to build complete functionality "
7123 "into the libguestfs appliance.  Upstream libguestfs, if built from source "
7124 "with all requirements satisfied, will support everything."
7125 msgstr ""
7126
7127 #. type: textblock
7128 #: ../src/guestfs-actions.pod:606
7129 msgid ""
7130 "This call was added in version C<1.0.80>.  In previous versions of "
7131 "libguestfs all you could do would be to speculatively execute a command to "
7132 "find out if the daemon implemented it.  See also C<guestfs_version>."
7133 msgstr ""
7134
7135 #. type: textblock
7136 #: ../src/guestfs-actions.pod:615 ../src/guestfs-actions.pod:1176
7137 msgid "(Added in 1.0.80)"
7138 msgstr ""
7139
7140 #. type: =head2
7141 #: ../src/guestfs-actions.pod:617
7142 msgid "guestfs_available_all_groups"
7143 msgstr ""
7144
7145 #. type: verbatim
7146 #: ../src/guestfs-actions.pod:619
7147 #, no-wrap
7148 msgid ""
7149 " char **\n"
7150 " guestfs_available_all_groups (guestfs_h *g);\n"
7151 "\n"
7152 msgstr ""
7153
7154 #. type: textblock
7155 #: ../src/guestfs-actions.pod:622
7156 msgid ""
7157 "This command returns a list of all optional groups that this daemon knows "
7158 "about.  Note this returns both supported and unsupported groups.  To find "
7159 "out which ones the daemon can actually support you have to call "
7160 "C<guestfs_available> on each member of the returned list."
7161 msgstr ""
7162
7163 #. type: textblock
7164 #: ../src/guestfs-actions.pod:628
7165 msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>."
7166 msgstr ""
7167
7168 #. type: textblock
7169 #: ../src/guestfs-actions.pod:634
7170 msgid "(Added in 1.3.15)"
7171 msgstr ""
7172
7173 #. type: =head2
7174 #: ../src/guestfs-actions.pod:636
7175 msgid "guestfs_base64_in"
7176 msgstr ""
7177
7178 #. type: verbatim
7179 #: ../src/guestfs-actions.pod:638
7180 #, no-wrap
7181 msgid ""
7182 " int\n"
7183 " guestfs_base64_in (guestfs_h *g,\n"
7184 "                    const char *base64file,\n"
7185 "                    const char *filename);\n"
7186 "\n"
7187 msgstr ""
7188
7189 #. type: textblock
7190 #: ../src/guestfs-actions.pod:643 ../fish/guestfish-actions.pod:432
7191 msgid ""
7192 "This command uploads base64-encoded data from C<base64file> to C<filename>."
7193 msgstr ""
7194
7195 #. type: textblock
7196 #: ../src/guestfs-actions.pod:648 ../src/guestfs-actions.pod:662
7197 msgid "(Added in 1.3.5)"
7198 msgstr ""
7199
7200 #. type: =head2
7201 #: ../src/guestfs-actions.pod:650
7202 msgid "guestfs_base64_out"
7203 msgstr ""
7204
7205 #. type: verbatim
7206 #: ../src/guestfs-actions.pod:652
7207 #, no-wrap
7208 msgid ""
7209 " int\n"
7210 " guestfs_base64_out (guestfs_h *g,\n"
7211 "                     const char *filename,\n"
7212 "                     const char *base64file);\n"
7213 "\n"
7214 msgstr ""
7215
7216 #. type: textblock
7217 #: ../src/guestfs-actions.pod:657 ../fish/guestfish-actions.pod:441
7218 msgid ""
7219 "This command downloads the contents of C<filename>, writing it out to local "
7220 "file C<base64file> encoded as base64."
7221 msgstr ""
7222
7223 #. type: =head2
7224 #: ../src/guestfs-actions.pod:664
7225 msgid "guestfs_blockdev_flushbufs"
7226 msgstr ""
7227
7228 #. type: verbatim
7229 #: ../src/guestfs-actions.pod:666
7230 #, no-wrap
7231 msgid ""
7232 " int\n"
7233 " guestfs_blockdev_flushbufs (guestfs_h *g,\n"
7234 "                             const char *device);\n"
7235 "\n"
7236 msgstr ""
7237
7238 #. type: textblock
7239 #: ../src/guestfs-actions.pod:670 ../fish/guestfish-actions.pod:450
7240 msgid ""
7241 "This tells the kernel to flush internal buffers associated with C<device>."
7242 msgstr ""
7243
7244 #. type: textblock
7245 #: ../src/guestfs-actions.pod:673 ../src/guestfs-actions.pod:690
7246 #: ../src/guestfs-actions.pod:705 ../src/guestfs-actions.pod:721
7247 #: ../src/guestfs-actions.pod:739 ../src/guestfs-actions.pod:758
7248 #: ../src/guestfs-actions.pod:772 ../src/guestfs-actions.pod:790
7249 #: ../src/guestfs-actions.pod:804 ../src/guestfs-actions.pod:818
7250 #: ../fish/guestfish-actions.pod:453 ../fish/guestfish-actions.pod:464
7251 #: ../fish/guestfish-actions.pod:473 ../fish/guestfish-actions.pod:483
7252 #: ../fish/guestfish-actions.pod:495 ../fish/guestfish-actions.pod:508
7253 #: ../fish/guestfish-actions.pod:516 ../fish/guestfish-actions.pod:527
7254 #: ../fish/guestfish-actions.pod:535 ../fish/guestfish-actions.pod:543
7255 msgid "This uses the L<blockdev(8)> command."
7256 msgstr ""
7257
7258 #. type: textblock
7259 #: ../src/guestfs-actions.pod:677 ../src/guestfs-actions.pod:694
7260 #: ../src/guestfs-actions.pod:709 ../src/guestfs-actions.pod:725
7261 #: ../src/guestfs-actions.pod:743 ../src/guestfs-actions.pod:762
7262 #: ../src/guestfs-actions.pod:776 ../src/guestfs-actions.pod:794
7263 #: ../src/guestfs-actions.pod:808 ../src/guestfs-actions.pod:822
7264 msgid "(Added in 0.9.3)"
7265 msgstr ""
7266
7267 #. type: =head2
7268 #: ../src/guestfs-actions.pod:679
7269 msgid "guestfs_blockdev_getbsz"
7270 msgstr ""
7271
7272 #. type: verbatim
7273 #: ../src/guestfs-actions.pod:681
7274 #, no-wrap
7275 msgid ""
7276 " int\n"
7277 " guestfs_blockdev_getbsz (guestfs_h *g,\n"
7278 "                          const char *device);\n"
7279 "\n"
7280 msgstr ""
7281
7282 #. type: textblock
7283 #: ../src/guestfs-actions.pod:685 ../fish/guestfish-actions.pod:459
7284 msgid "This returns the block size of a device."
7285 msgstr ""
7286
7287 #. type: textblock
7288 #: ../src/guestfs-actions.pod:687 ../src/guestfs-actions.pod:787
7289 #: ../fish/guestfish-actions.pod:461 ../fish/guestfish-actions.pod:524
7290 msgid ""
7291 "(Note this is different from both I<size in blocks> and I<filesystem block "
7292 "size>)."
7293 msgstr ""
7294
7295 #. type: =head2
7296 #: ../src/guestfs-actions.pod:696
7297 msgid "guestfs_blockdev_getro"
7298 msgstr ""
7299
7300 #. type: verbatim
7301 #: ../src/guestfs-actions.pod:698
7302 #, no-wrap
7303 msgid ""
7304 " int\n"
7305 " guestfs_blockdev_getro (guestfs_h *g,\n"
7306 "                         const char *device);\n"
7307 "\n"
7308 msgstr ""
7309
7310 #. type: textblock
7311 #: ../src/guestfs-actions.pod:702 ../fish/guestfish-actions.pod:470
7312 msgid ""
7313 "Returns a boolean indicating if the block device is read-only (true if read-"
7314 "only, false if not)."
7315 msgstr ""
7316
7317 #. type: textblock
7318 #: ../src/guestfs-actions.pod:707 ../src/guestfs-actions.pod:1414
7319 #: ../src/guestfs-actions.pod:1429 ../src/guestfs-actions.pod:1916
7320 #: ../src/guestfs-actions.pod:1927 ../src/guestfs-actions.pod:1999
7321 #: ../src/guestfs-actions.pod:2054 ../src/guestfs-actions.pod:2069
7322 #: ../src/guestfs-actions.pod:2094 ../src/guestfs-actions.pod:2117
7323 #: ../src/guestfs-actions.pod:3090 ../src/guestfs-actions.pod:3107
7324 #: ../src/guestfs-actions.pod:3126 ../src/guestfs-actions.pod:3289
7325 #: ../src/guestfs-actions.pod:3303 ../src/guestfs-actions.pod:3318
7326 #: ../src/guestfs-actions.pod:3332 ../src/guestfs-actions.pod:3348
7327 #: ../src/guestfs-actions.pod:3363 ../src/guestfs-actions.pod:3379
7328 #: ../src/guestfs-actions.pod:3393 ../src/guestfs-actions.pod:3406
7329 #: ../src/guestfs-actions.pod:3420 ../src/guestfs-actions.pod:3435
7330 #: ../src/guestfs-actions.pod:3450 ../src/guestfs-actions.pod:4997
7331 msgid "This function returns a C truth value on success or -1 on error."
7332 msgstr ""
7333
7334 #. type: =head2
7335 #: ../src/guestfs-actions.pod:711
7336 msgid "guestfs_blockdev_getsize64"
7337 msgstr ""
7338
7339 #. type: verbatim
7340 #: ../src/guestfs-actions.pod:713
7341 #, no-wrap
7342 msgid ""
7343 " int64_t\n"
7344 " guestfs_blockdev_getsize64 (guestfs_h *g,\n"
7345 "                             const char *device);\n"
7346 "\n"
7347 msgstr ""
7348
7349 #. type: textblock
7350 #: ../src/guestfs-actions.pod:717 ../fish/guestfish-actions.pod:479
7351 msgid "This returns the size of the device in bytes."
7352 msgstr ""
7353
7354 #. type: textblock
7355 #: ../src/guestfs-actions.pod:719
7356 msgid "See also C<guestfs_blockdev_getsz>."
7357 msgstr ""
7358
7359 #. type: =head2
7360 #: ../src/guestfs-actions.pod:727
7361 msgid "guestfs_blockdev_getss"
7362 msgstr ""
7363
7364 #. type: verbatim
7365 #: ../src/guestfs-actions.pod:729
7366 #, no-wrap
7367 msgid ""
7368 " int\n"
7369 " guestfs_blockdev_getss (guestfs_h *g,\n"
7370 "                         const char *device);\n"
7371 "\n"
7372 msgstr ""
7373
7374 #. type: textblock
7375 #: ../src/guestfs-actions.pod:733 ../fish/guestfish-actions.pod:489
7376 msgid ""
7377 "This returns the size of sectors on a block device.  Usually 512, but can be "
7378 "larger for modern devices."
7379 msgstr ""
7380
7381 #. type: textblock
7382 #: ../src/guestfs-actions.pod:736
7383 msgid ""
7384 "(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for "
7385 "that)."
7386 msgstr ""
7387
7388 #. type: =head2
7389 #: ../src/guestfs-actions.pod:745
7390 msgid "guestfs_blockdev_getsz"
7391 msgstr ""
7392
7393 #. type: verbatim
7394 #: ../src/guestfs-actions.pod:747
7395 #, no-wrap
7396 msgid ""
7397 " int64_t\n"
7398 " guestfs_blockdev_getsz (guestfs_h *g,\n"
7399 "                         const char *device);\n"
7400 "\n"
7401 msgstr ""
7402
7403 #. type: textblock
7404 #: ../src/guestfs-actions.pod:751 ../fish/guestfish-actions.pod:501
7405 msgid ""
7406 "This returns the size of the device in units of 512-byte sectors (even if "
7407 "the sectorsize isn't 512 bytes ... weird)."
7408 msgstr ""
7409
7410 #. type: textblock
7411 #: ../src/guestfs-actions.pod:754
7412 msgid ""
7413 "See also C<guestfs_blockdev_getss> for the real sector size of the device, "
7414 "and C<guestfs_blockdev_getsize64> for the more useful I<size in bytes>."
7415 msgstr ""
7416
7417 #. type: =head2
7418 #: ../src/guestfs-actions.pod:764
7419 msgid "guestfs_blockdev_rereadpt"
7420 msgstr ""
7421
7422 #. type: verbatim
7423 #: ../src/guestfs-actions.pod:766
7424 #, no-wrap
7425 msgid ""
7426 " int\n"
7427 " guestfs_blockdev_rereadpt (guestfs_h *g,\n"
7428 "                            const char *device);\n"
7429 "\n"
7430 msgstr ""
7431
7432 #. type: textblock
7433 #: ../src/guestfs-actions.pod:770 ../fish/guestfish-actions.pod:514
7434 msgid "Reread the partition table on C<device>."
7435 msgstr ""
7436
7437 #. type: =head2
7438 #: ../src/guestfs-actions.pod:778
7439 msgid "guestfs_blockdev_setbsz"
7440 msgstr ""
7441
7442 #. type: verbatim
7443 #: ../src/guestfs-actions.pod:780
7444 #, no-wrap
7445 msgid ""
7446 " int\n"
7447 " guestfs_blockdev_setbsz (guestfs_h *g,\n"
7448 "                          const char *device,\n"
7449 "                          int blocksize);\n"
7450 "\n"
7451 msgstr ""
7452
7453 #. type: textblock
7454 #: ../src/guestfs-actions.pod:785 ../fish/guestfish-actions.pod:522
7455 msgid "This sets the block size of a device."
7456 msgstr ""
7457
7458 #. type: =head2
7459 #: ../src/guestfs-actions.pod:796
7460 msgid "guestfs_blockdev_setro"
7461 msgstr ""
7462
7463 #. type: verbatim
7464 #: ../src/guestfs-actions.pod:798
7465 #, no-wrap
7466 msgid ""
7467 " int\n"
7468 " guestfs_blockdev_setro (guestfs_h *g,\n"
7469 "                         const char *device);\n"
7470 "\n"
7471 msgstr ""
7472
7473 #. type: textblock
7474 #: ../src/guestfs-actions.pod:802 ../fish/guestfish-actions.pod:533
7475 msgid "Sets the block device named C<device> to read-only."
7476 msgstr ""
7477
7478 #. type: =head2
7479 #: ../src/guestfs-actions.pod:810
7480 msgid "guestfs_blockdev_setrw"
7481 msgstr ""
7482
7483 #. type: verbatim
7484 #: ../src/guestfs-actions.pod:812
7485 #, no-wrap
7486 msgid ""
7487 " int\n"
7488 " guestfs_blockdev_setrw (guestfs_h *g,\n"
7489 "                         const char *device);\n"
7490 "\n"
7491 msgstr ""
7492
7493 #. type: textblock
7494 #: ../src/guestfs-actions.pod:816 ../fish/guestfish-actions.pod:541
7495 msgid "Sets the block device named C<device> to read-write."
7496 msgstr ""
7497
7498 #. type: =head2
7499 #: ../src/guestfs-actions.pod:824
7500 msgid "guestfs_case_sensitive_path"
7501 msgstr ""
7502
7503 #. type: verbatim
7504 #: ../src/guestfs-actions.pod:826
7505 #, no-wrap
7506 msgid ""
7507 " char *\n"
7508 " guestfs_case_sensitive_path (guestfs_h *g,\n"
7509 "                              const char *path);\n"
7510 "\n"
7511 msgstr ""
7512
7513 #. type: textblock
7514 #: ../src/guestfs-actions.pod:830 ../fish/guestfish-actions.pod:549
7515 msgid ""
7516 "This can be used to resolve case insensitive paths on a filesystem which is "
7517 "case sensitive.  The use case is to resolve paths which you have read from "
7518 "Windows configuration files or the Windows Registry, to the true path."
7519 msgstr ""
7520
7521 #. type: textblock
7522 #: ../src/guestfs-actions.pod:835 ../fish/guestfish-actions.pod:554
7523 msgid ""
7524 "The command handles a peculiarity of the Linux ntfs-3g filesystem driver "
7525 "(and probably others), which is that although the underlying filesystem is "
7526 "case-insensitive, the driver exports the filesystem to Linux as case-"
7527 "sensitive."
7528 msgstr ""
7529
7530 #. type: textblock
7531 #: ../src/guestfs-actions.pod:840 ../fish/guestfish-actions.pod:559
7532 msgid ""
7533 "One consequence of this is that special directories such as C<c:\\windows> "
7534 "may appear as C</WINDOWS> or C</windows> (or other things) depending on the "
7535 "precise details of how they were created.  In Windows itself this would not "
7536 "be a problem."
7537 msgstr ""
7538
7539 #. type: textblock
7540 #: ../src/guestfs-actions.pod:846 ../fish/guestfish-actions.pod:565
7541 msgid ""
7542 "Bug or feature? You decide: L<http://www.tuxera.com/community/ntfs-3g-faq/"
7543 "#posixfilenames1>"
7544 msgstr ""
7545
7546 #. type: textblock
7547 #: ../src/guestfs-actions.pod:849 ../fish/guestfish-actions.pod:568
7548 msgid ""
7549 "This function resolves the true case of each element in the path and returns "
7550 "the case-sensitive path."
7551 msgstr ""
7552
7553 #. type: textblock
7554 #: ../src/guestfs-actions.pod:852
7555 msgid ""
7556 "Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\")  might return C<"
7557 "\"/WINDOWS/system32\"> (the exact return value would depend on details of "
7558 "how the directories were originally created under Windows)."
7559 msgstr ""
7560
7561 #. type: textblock
7562 #: ../src/guestfs-actions.pod:857 ../fish/guestfish-actions.pod:576
7563 msgid "I<Note>: This function does not handle drive names, backslashes etc."
7564 msgstr ""
7565
7566 #. type: textblock
7567 #: ../src/guestfs-actions.pod:860
7568 msgid "See also C<guestfs_realpath>."
7569 msgstr ""
7570
7571 #. type: textblock
7572 #: ../src/guestfs-actions.pod:865 ../src/guestfs-actions.pod:7016
7573 msgid "(Added in 1.0.75)"
7574 msgstr ""
7575
7576 #. type: =head2
7577 #: ../src/guestfs-actions.pod:867
7578 msgid "guestfs_cat"
7579 msgstr ""
7580
7581 #. type: verbatim
7582 #: ../src/guestfs-actions.pod:869
7583 #, no-wrap
7584 msgid ""
7585 " char *\n"
7586 " guestfs_cat (guestfs_h *g,\n"
7587 "              const char *path);\n"
7588 "\n"
7589 msgstr ""
7590
7591 #. type: textblock
7592 #: ../src/guestfs-actions.pod:873 ../src/guestfs-actions.pod:5484
7593 #: ../fish/guestfish-actions.pod:585 ../fish/guestfish-actions.pod:3685
7594 msgid "Return the contents of the file named C<path>."
7595 msgstr ""
7596
7597 #. type: textblock
7598 #: ../src/guestfs-actions.pod:875
7599 msgid ""
7600 "Note that this function cannot correctly handle binary files (specifically, "
7601 "files containing C<\\0> character which is treated as end of string).  For "
7602 "those you need to use the C<guestfs_read_file> or C<guestfs_download> "
7603 "functions which have a more complex interface."
7604 msgstr ""
7605
7606 #. type: textblock
7607 #: ../src/guestfs-actions.pod:883 ../src/guestfs-actions.pod:1062
7608 #: ../src/guestfs-actions.pod:1082 ../src/guestfs-actions.pod:1378
7609 #: ../src/guestfs-actions.pod:1397 ../src/guestfs-actions.pod:1500
7610 #: ../src/guestfs-actions.pod:1519 ../src/guestfs-actions.pod:1765
7611 #: ../src/guestfs-actions.pod:2223 ../src/guestfs-actions.pod:2242
7612 #: ../src/guestfs-actions.pod:2285 ../src/guestfs-actions.pod:2309
7613 #: ../src/guestfs-actions.pod:2326 ../src/guestfs-actions.pod:2355
7614 #: ../src/guestfs-actions.pod:5266 ../src/guestfs-actions.pod:5292
7615 #: ../src/guestfs-actions.pod:5423 ../src/guestfs-actions.pod:5449
7616 #: ../src/guestfs-actions.pod:5473 ../src/guestfs-actions.pod:6401
7617 #: ../src/guestfs-actions.pod:6456 ../src/guestfs-actions.pod:6602
7618 #: ../src/guestfs-actions.pod:6626 ../src/guestfs-actions.pod:7295
7619 #: ../src/guestfs-actions.pod:7321 ../src/guestfs-actions.pod:7347
7620 #: ../src/guestfs-actions.pod:7366 ../src/guestfs-actions.pod:7451
7621 #: ../src/guestfs-actions.pod:7470 ../src/guestfs-actions.pod:7516
7622 #: ../src/guestfs-actions.pod:7535 ../fish/guestfish-actions.pod:592
7623 #: ../fish/guestfish-actions.pod:727 ../fish/guestfish-actions.pod:739
7624 #: ../fish/guestfish-actions.pod:915 ../fish/guestfish-actions.pod:925
7625 #: ../fish/guestfish-actions.pod:992 ../fish/guestfish-actions.pod:1002
7626 #: ../fish/guestfish-actions.pod:1194 ../fish/guestfish-actions.pod:1495
7627 #: ../fish/guestfish-actions.pod:1505 ../fish/guestfish-actions.pod:1533
7628 #: ../fish/guestfish-actions.pod:1548 ../fish/guestfish-actions.pod:1558
7629 #: ../fish/guestfish-actions.pod:1577 ../fish/guestfish-actions.pod:3555
7630 #: ../fish/guestfish-actions.pod:3570 ../fish/guestfish-actions.pod:3646
7631 #: ../fish/guestfish-actions.pod:3663 ../fish/guestfish-actions.pod:3678
7632 #: ../fish/guestfish-actions.pod:4332 ../fish/guestfish-actions.pod:4378
7633 #: ../fish/guestfish-actions.pod:4463 ../fish/guestfish-actions.pod:4478
7634 #: ../fish/guestfish-actions.pod:4888 ../fish/guestfish-actions.pod:4906
7635 #: ../fish/guestfish-actions.pod:4923 ../fish/guestfish-actions.pod:4933
7636 #: ../fish/guestfish-actions.pod:4981 ../fish/guestfish-actions.pod:4991
7637 #: ../fish/guestfish-actions.pod:5020 ../fish/guestfish-actions.pod:5030
7638 msgid ""
7639 "Because of the message protocol, there is a transfer limit of somewhere "
7640 "between 2MB and 4MB.  See L<guestfs(3)/PROTOCOL LIMITS>."
7641 msgstr ""
7642
7643 #. type: textblock
7644 #: ../src/guestfs-actions.pod:886 ../src/guestfs-actions.pod:3566
7645 #: ../src/guestfs-actions.pod:3628 ../src/guestfs-actions.pod:3645
7646 #: ../src/guestfs-actions.pod:3733 ../src/guestfs-actions.pod:4138
7647 #: ../src/guestfs-actions.pod:4152 ../src/guestfs-actions.pod:5372
7648 #: ../src/guestfs-actions.pod:5386 ../src/guestfs-actions.pod:7175
7649 #: ../src/guestfs-actions.pod:7189
7650 msgid "(Added in 0.4)"
7651 msgstr ""
7652
7653 #. type: =head2
7654 #: ../src/guestfs-actions.pod:888
7655 msgid "guestfs_checksum"
7656 msgstr ""
7657
7658 #. type: verbatim
7659 #: ../src/guestfs-actions.pod:890
7660 #, no-wrap
7661 msgid ""
7662 " char *\n"
7663 " guestfs_checksum (guestfs_h *g,\n"
7664 "                   const char *csumtype,\n"
7665 "                   const char *path);\n"
7666 "\n"
7667 msgstr ""
7668
7669 #. type: textblock
7670 #: ../src/guestfs-actions.pod:895 ../fish/guestfish-actions.pod:599
7671 msgid ""
7672 "This call computes the MD5, SHAx or CRC checksum of the file named C<path>."
7673 msgstr ""
7674
7675 #. type: textblock
7676 #: ../src/guestfs-actions.pod:898 ../fish/guestfish-actions.pod:602
7677 msgid ""
7678 "The type of checksum to compute is given by the C<csumtype> parameter which "
7679 "must have one of the following values:"
7680 msgstr ""
7681
7682 #. type: =item
7683 #: ../src/guestfs-actions.pod:903 ../fish/guestfish-actions.pod:607
7684 msgid "C<crc>"
7685 msgstr "C<crc>"
7686
7687 #. type: textblock
7688 #: ../src/guestfs-actions.pod:905 ../fish/guestfish-actions.pod:609
7689 msgid ""
7690 "Compute the cyclic redundancy check (CRC) specified by POSIX for the "
7691 "C<cksum> command."
7692 msgstr ""
7693
7694 #. type: =item
7695 #: ../src/guestfs-actions.pod:908 ../fish/guestfish-actions.pod:612
7696 msgid "C<md5>"
7697 msgstr "C<md5>"
7698
7699 #. type: textblock
7700 #: ../src/guestfs-actions.pod:910 ../fish/guestfish-actions.pod:614
7701 msgid "Compute the MD5 hash (using the C<md5sum> program)."
7702 msgstr ""
7703
7704 #. type: =item
7705 #: ../src/guestfs-actions.pod:912 ../fish/guestfish-actions.pod:616
7706 msgid "C<sha1>"
7707 msgstr "C<sha1>"
7708
7709 #. type: textblock
7710 #: ../src/guestfs-actions.pod:914 ../fish/guestfish-actions.pod:618
7711 msgid "Compute the SHA1 hash (using the C<sha1sum> program)."
7712 msgstr ""
7713
7714 #. type: =item
7715 #: ../src/guestfs-actions.pod:916 ../fish/guestfish-actions.pod:620
7716 msgid "C<sha224>"
7717 msgstr "C<sha224>"
7718
7719 #. type: textblock
7720 #: ../src/guestfs-actions.pod:918 ../fish/guestfish-actions.pod:622
7721 msgid "Compute the SHA224 hash (using the C<sha224sum> program)."
7722 msgstr ""
7723
7724 #. type: =item
7725 #: ../src/guestfs-actions.pod:920 ../fish/guestfish-actions.pod:624
7726 msgid "C<sha256>"
7727 msgstr "C<sha256>"
7728
7729 #. type: textblock
7730 #: ../src/guestfs-actions.pod:922 ../fish/guestfish-actions.pod:626
7731 msgid "Compute the SHA256 hash (using the C<sha256sum> program)."
7732 msgstr ""
7733
7734 #. type: =item
7735 #: ../src/guestfs-actions.pod:924 ../fish/guestfish-actions.pod:628
7736 msgid "C<sha384>"
7737 msgstr "C<sha384>"
7738
7739 #. type: textblock
7740 #: ../src/guestfs-actions.pod:926 ../fish/guestfish-actions.pod:630
7741 msgid "Compute the SHA384 hash (using the C<sha384sum> program)."
7742 msgstr ""
7743
7744 #. type: =item
7745 #: ../src/guestfs-actions.pod:928 ../fish/guestfish-actions.pod:632
7746 msgid "C<sha512>"
7747 msgstr "C<sha512>"
7748
7749 #. type: textblock
7750 #: ../src/guestfs-actions.pod:930 ../fish/guestfish-actions.pod:634
7751 msgid "Compute the SHA512 hash (using the C<sha512sum> program)."
7752 msgstr ""
7753
7754 #. type: textblock
7755 #: ../src/guestfs-actions.pod:934 ../fish/guestfish-actions.pod:638
7756 msgid "The checksum is returned as a printable string."
7757 msgstr ""
7758
7759 #. type: textblock
7760 #: ../src/guestfs-actions.pod:936
7761 msgid "To get the checksum for a device, use C<guestfs_checksum_device>."
7762 msgstr ""
7763
7764 #. type: textblock
7765 #: ../src/guestfs-actions.pod:938
7766 msgid "To get the checksums for many files, use C<guestfs_checksums_out>."
7767 msgstr ""
7768
7769 #. type: textblock
7770 #: ../src/guestfs-actions.pod:943 ../src/guestfs-actions.pod:1251
7771 #: ../src/guestfs-actions.pod:2085 ../src/guestfs-actions.pod:3305
7772 #: ../src/guestfs-actions.pod:3334 ../src/guestfs-actions.pod:3395
7773 #: ../src/guestfs-actions.pod:3422 ../src/guestfs-actions.pod:6872
7774 msgid "(Added in 1.0.2)"
7775 msgstr ""
7776
7777 #. type: =head2
7778 #: ../src/guestfs-actions.pod:945
7779 msgid "guestfs_checksum_device"
7780 msgstr ""
7781
7782 #. type: verbatim
7783 #: ../src/guestfs-actions.pod:947
7784 #, no-wrap
7785 msgid ""
7786 " char *\n"
7787 " guestfs_checksum_device (guestfs_h *g,\n"
7788 "                          const char *csumtype,\n"
7789 "                          const char *device);\n"
7790 "\n"
7791 msgstr ""
7792
7793 #. type: textblock
7794 #: ../src/guestfs-actions.pod:952
7795 msgid ""
7796 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
7797 "device named C<device>.  For the types of checksums supported see the "
7798 "C<guestfs_checksum> command."
7799 msgstr ""
7800
7801 #. type: textblock
7802 #: ../src/guestfs-actions.pod:959 ../src/guestfs-actions.pod:4903
7803 #: ../src/guestfs-actions.pod:4962 ../src/guestfs-actions.pod:4999
7804 #: ../src/guestfs-actions.pod:5017 ../src/guestfs-actions.pod:5193
7805 #: ../src/guestfs-actions.pod:6781 ../src/guestfs-actions.pod:6795
7806 #: ../src/guestfs-actions.pod:7201
7807 msgid "(Added in 1.3.2)"
7808 msgstr ""
7809
7810 #. type: =head2
7811 #: ../src/guestfs-actions.pod:961
7812 msgid "guestfs_checksums_out"
7813 msgstr ""
7814
7815 #. type: verbatim
7816 #: ../src/guestfs-actions.pod:963
7817 #, no-wrap
7818 msgid ""
7819 " int\n"
7820 " guestfs_checksums_out (guestfs_h *g,\n"
7821 "                        const char *csumtype,\n"
7822 "                        const char *directory,\n"
7823 "                        const char *sumsfile);\n"
7824 "\n"
7825 msgstr ""
7826
7827 #. type: textblock
7828 #: ../src/guestfs-actions.pod:969 ../fish/guestfish-actions.pod:656
7829 msgid ""
7830 "This command computes the checksums of all regular files in C<directory> and "
7831 "then emits a list of those checksums to the local output file C<sumsfile>."
7832 msgstr ""
7833
7834 #. type: textblock
7835 #: ../src/guestfs-actions.pod:973 ../fish/guestfish-actions.pod:660
7836 msgid ""
7837 "This can be used for verifying the integrity of a virtual machine.  However "
7838 "to be properly secure you should pay attention to the output of the checksum "
7839 "command (it uses the ones from GNU coreutils).  In particular when the "
7840 "filename is not printable, coreutils uses a special backslash syntax.  For "
7841 "more information, see the GNU coreutils info file."
7842 msgstr ""
7843
7844 #. type: textblock
7845 #: ../src/guestfs-actions.pod:983
7846 msgid "(Added in 1.3.7)"
7847 msgstr ""
7848
7849 #. type: =head2
7850 #: ../src/guestfs-actions.pod:985
7851 msgid "guestfs_chmod"
7852 msgstr ""
7853
7854 #. type: verbatim
7855 #: ../src/guestfs-actions.pod:987
7856 #, no-wrap
7857 msgid ""
7858 " int\n"
7859 " guestfs_chmod (guestfs_h *g,\n"
7860 "                int mode,\n"
7861 "                const char *path);\n"
7862 "\n"
7863 msgstr ""
7864
7865 #. type: textblock
7866 #: ../src/guestfs-actions.pod:992 ../fish/guestfish-actions.pod:674
7867 msgid ""
7868 "Change the mode (permissions) of C<path> to C<mode>.  Only numeric modes are "
7869 "supported."
7870 msgstr ""
7871
7872 #. type: textblock
7873 #: ../src/guestfs-actions.pod:995 ../fish/guestfish-actions.pod:677
7874 msgid ""
7875 "I<Note>: When using this command from guestfish, C<mode> by default would be "
7876 "decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not "
7877 "C<700>."
7878 msgstr ""
7879
7880 #. type: textblock
7881 #: ../src/guestfs-actions.pod:999 ../src/guestfs-actions.pod:4389
7882 #: ../src/guestfs-actions.pod:4586 ../src/guestfs-actions.pod:4605
7883 #: ../src/guestfs-actions.pod:4624 ../fish/guestfish-actions.pod:681
7884 #: ../fish/guestfish-actions.pod:2985 ../fish/guestfish-actions.pod:3114
7885 #: ../fish/guestfish-actions.pod:3124 ../fish/guestfish-actions.pod:3134
7886 msgid "The mode actually set is affected by the umask."
7887 msgstr ""
7888
7889 #. type: =head2
7890 #: ../src/guestfs-actions.pod:1005
7891 msgid "guestfs_chown"
7892 msgstr ""
7893
7894 #. type: verbatim
7895 #: ../src/guestfs-actions.pod:1007
7896 #, no-wrap
7897 msgid ""
7898 " int\n"
7899 " guestfs_chown (guestfs_h *g,\n"
7900 "                int owner,\n"
7901 "                int group,\n"
7902 "                const char *path);\n"
7903 "\n"
7904 msgstr ""
7905
7906 #. type: textblock
7907 #: ../src/guestfs-actions.pod:1013 ../fish/guestfish-actions.pod:687
7908 msgid "Change the file owner to C<owner> and group to C<group>."
7909 msgstr ""
7910
7911 #. type: textblock
7912 #: ../src/guestfs-actions.pod:1015 ../src/guestfs-actions.pod:3497
7913 #: ../fish/guestfish-actions.pod:689 ../fish/guestfish-actions.pod:2443
7914 msgid ""
7915 "Only numeric uid and gid are supported.  If you want to use names, you will "
7916 "need to locate and parse the password file yourself (Augeas support makes "
7917 "this relatively easy)."
7918 msgstr ""
7919
7920 #. type: =head2
7921 #: ../src/guestfs-actions.pod:1023
7922 msgid "guestfs_command"
7923 msgstr ""
7924
7925 #. type: verbatim
7926 #: ../src/guestfs-actions.pod:1025
7927 #, no-wrap
7928 msgid ""
7929 " char *\n"
7930 " guestfs_command (guestfs_h *g,\n"
7931 "                  char *const *arguments);\n"
7932 "\n"
7933 msgstr ""
7934
7935 #. type: textblock
7936 #: ../src/guestfs-actions.pod:1029 ../fish/guestfish-actions.pod:697
7937 msgid ""
7938 "This call runs a command from the guest filesystem.  The filesystem must be "
7939 "mounted, and must contain a compatible operating system (ie. something "
7940 "Linux, with the same or compatible processor architecture)."
7941 msgstr ""
7942
7943 #. type: textblock
7944 #: ../src/guestfs-actions.pod:1034
7945 msgid ""
7946 "The single parameter is an argv-style list of arguments.  The first element "
7947 "is the name of the program to run.  Subsequent elements are parameters.  The "
7948 "list must be non-empty (ie. must contain a program name).  Note that the "
7949 "command runs directly, and is I<not> invoked via the shell (see "
7950 "C<guestfs_sh>)."
7951 msgstr ""
7952
7953 #. type: textblock
7954 #: ../src/guestfs-actions.pod:1041 ../fish/guestfish-actions.pod:709
7955 msgid "The return value is anything printed to I<stdout> by the command."
7956 msgstr ""
7957
7958 #. type: textblock
7959 #: ../src/guestfs-actions.pod:1044 ../fish/guestfish-actions.pod:712
7960 msgid ""
7961 "If the command returns a non-zero exit status, then this function returns an "
7962 "error message.  The error message string is the content of I<stderr> from "
7963 "the command."
7964 msgstr ""
7965
7966 #. type: textblock
7967 #: ../src/guestfs-actions.pod:1048 ../fish/guestfish-actions.pod:716
7968 msgid ""
7969 "The C<$PATH> environment variable will contain at least C</usr/bin> and C</"
7970 "bin>.  If you require a program from another location, you should provide "
7971 "the full path in the first parameter."
7972 msgstr ""
7973
7974 #. type: textblock
7975 #: ../src/guestfs-actions.pod:1053 ../fish/guestfish-actions.pod:721
7976 msgid ""
7977 "Shared libraries and data files required by the program must be available on "
7978 "filesystems which are mounted in the correct places.  It is the caller's "
7979 "responsibility to ensure all filesystems that are needed are mounted at the "
7980 "right locations."
7981 msgstr ""
7982
7983 #. type: textblock
7984 #: ../src/guestfs-actions.pod:1065 ../src/guestfs-actions.pod:1085
7985 #: ../src/guestfs-actions.pod:1550
7986 msgid "(Added in 0.9.1)"
7987 msgstr ""
7988
7989 #. type: =head2
7990 #: ../src/guestfs-actions.pod:1067
7991 msgid "guestfs_command_lines"
7992 msgstr ""
7993
7994 #. type: verbatim
7995 #: ../src/guestfs-actions.pod:1069
7996 #, no-wrap
7997 msgid ""
7998 " char **\n"
7999 " guestfs_command_lines (guestfs_h *g,\n"
8000 "                        char *const *arguments);\n"
8001 "\n"
8002 msgstr ""
8003
8004 #. type: textblock
8005 #: ../src/guestfs-actions.pod:1073
8006 msgid ""
8007 "This is the same as C<guestfs_command>, but splits the result into a list of "
8008 "lines."
8009 msgstr ""
8010
8011 #. type: textblock
8012 #: ../src/guestfs-actions.pod:1076
8013 msgid "See also: C<guestfs_sh_lines>"
8014 msgstr ""
8015
8016 #. type: =head2
8017 #: ../src/guestfs-actions.pod:1087
8018 msgid "guestfs_config"
8019 msgstr ""
8020
8021 #. type: verbatim
8022 #: ../src/guestfs-actions.pod:1089
8023 #, no-wrap
8024 msgid ""
8025 " int\n"
8026 " guestfs_config (guestfs_h *g,\n"
8027 "                 const char *qemuparam,\n"
8028 "                 const char *qemuvalue);\n"
8029 "\n"
8030 msgstr ""
8031
8032 #. type: textblock
8033 #: ../src/guestfs-actions.pod:1094 ../fish/guestfish-actions.pod:746
8034 msgid ""
8035 "This can be used to add arbitrary qemu command line parameters of the form "
8036 "I<-param value>.  Actually it's not quite arbitrary - we prevent you from "
8037 "setting some parameters which would interfere with parameters that we use."
8038 msgstr ""
8039
8040 #. type: textblock
8041 #: ../src/guestfs-actions.pod:1099 ../fish/guestfish-actions.pod:751
8042 msgid "The first character of C<param> string must be a C<-> (dash)."
8043 msgstr ""
8044
8045 #. type: textblock
8046 #: ../src/guestfs-actions.pod:1101 ../fish/guestfish-actions.pod:753
8047 msgid "C<value> can be NULL."
8048 msgstr ""
8049
8050 #. type: =head2
8051 #: ../src/guestfs-actions.pod:1107
8052 msgid "guestfs_copy_size"
8053 msgstr ""
8054
8055 #. type: verbatim
8056 #: ../src/guestfs-actions.pod:1109
8057 #, no-wrap
8058 msgid ""
8059 " int\n"
8060 " guestfs_copy_size (guestfs_h *g,\n"
8061 "                    const char *src,\n"
8062 "                    const char *dest,\n"
8063 "                    int64_t size);\n"
8064 "\n"
8065 msgstr ""
8066
8067 #. type: textblock
8068 #: ../src/guestfs-actions.pod:1115 ../fish/guestfish-actions.pod:759
8069 msgid ""
8070 "This command copies exactly C<size> bytes from one source device or file "
8071 "C<src> to another destination device or file C<dest>."
8072 msgstr ""
8073
8074 #. type: textblock
8075 #: ../src/guestfs-actions.pod:1118 ../fish/guestfish-actions.pod:762
8076 msgid ""
8077 "Note this will fail if the source is too short or if the destination is not "
8078 "large enough."
8079 msgstr ""
8080
8081 #. type: textblock
8082 #: ../src/guestfs-actions.pod:1123 ../src/guestfs-actions.pod:1246
8083 #: ../src/guestfs-actions.pod:1277 ../src/guestfs-actions.pod:1322
8084 #: ../src/guestfs-actions.pod:1699 ../src/guestfs-actions.pod:1721
8085 #: ../src/guestfs-actions.pod:3478 ../src/guestfs-actions.pod:6867
8086 #: ../src/guestfs-actions.pod:6901 ../src/guestfs-actions.pod:7387
8087 #: ../src/guestfs-actions.pod:7406
8088 msgid ""
8089 "This long-running command can generate progress notification messages so "
8090 "that the caller can display a progress bar or indicator.  To receive these "
8091 "messages, the caller must register a progress event callback.  See L<guestfs"
8092 "(3)/GUESTFS_EVENT_PROGRESS>."
8093 msgstr ""
8094
8095 #. type: textblock
8096 #: ../src/guestfs-actions.pod:1128 ../src/guestfs-actions.pod:4165
8097 #: ../src/guestfs-actions.pod:5399 ../src/guestfs-actions.pod:7108
8098 #: ../src/guestfs-actions.pod:7128 ../src/guestfs-actions.pod:7214
8099 msgid "(Added in 1.0.87)"
8100 msgstr ""
8101
8102 #. type: =head2
8103 #: ../src/guestfs-actions.pod:1130
8104 msgid "guestfs_cp"
8105 msgstr ""
8106
8107 #. type: verbatim
8108 #: ../src/guestfs-actions.pod:1132
8109 #, no-wrap
8110 msgid ""
8111 " int\n"
8112 " guestfs_cp (guestfs_h *g,\n"
8113 "             const char *src,\n"
8114 "             const char *dest);\n"
8115 "\n"
8116 msgstr ""
8117
8118 #. type: textblock
8119 #: ../src/guestfs-actions.pod:1137 ../fish/guestfish-actions.pod:769
8120 msgid ""
8121 "This copies a file from C<src> to C<dest> where C<dest> is either a "
8122 "destination filename or destination directory."
8123 msgstr ""
8124
8125 #. type: textblock
8126 #: ../src/guestfs-actions.pod:1142 ../src/guestfs-actions.pod:1156
8127 #: ../src/guestfs-actions.pod:1228 ../src/guestfs-actions.pod:1302
8128 #: ../src/guestfs-actions.pod:1416 ../src/guestfs-actions.pod:4857
8129 #: ../src/guestfs-actions.pod:5243
8130 msgid "(Added in 1.0.18)"
8131 msgstr ""
8132
8133 #. type: =head2
8134 #: ../src/guestfs-actions.pod:1144
8135 msgid "guestfs_cp_a"
8136 msgstr ""
8137
8138 #. type: verbatim
8139 #: ../src/guestfs-actions.pod:1146
8140 #, no-wrap
8141 msgid ""
8142 " int\n"
8143 " guestfs_cp_a (guestfs_h *g,\n"
8144 "               const char *src,\n"
8145 "               const char *dest);\n"
8146 "\n"
8147 msgstr ""
8148
8149 #. type: textblock
8150 #: ../src/guestfs-actions.pod:1151 ../fish/guestfish-actions.pod:776
8151 msgid ""
8152 "This copies a file or directory from C<src> to C<dest> recursively using the "
8153 "C<cp -a> command."
8154 msgstr ""
8155
8156 #. type: =head2
8157 #: ../src/guestfs-actions.pod:1158
8158 msgid "guestfs_dd"
8159 msgstr ""
8160
8161 #. type: verbatim
8162 #: ../src/guestfs-actions.pod:1160
8163 #, no-wrap
8164 msgid ""
8165 " int\n"
8166 " guestfs_dd (guestfs_h *g,\n"
8167 "             const char *src,\n"
8168 "             const char *dest);\n"
8169 "\n"
8170 msgstr ""
8171
8172 #. type: textblock
8173 #: ../src/guestfs-actions.pod:1165 ../fish/guestfish-actions.pod:783
8174 msgid ""
8175 "This command copies from one source device or file C<src> to another "
8176 "destination device or file C<dest>.  Normally you would use this to copy to "
8177 "or from a device or partition, for example to duplicate a filesystem."
8178 msgstr ""
8179
8180 #. type: textblock
8181 #: ../src/guestfs-actions.pod:1170
8182 msgid ""
8183 "If the destination is a device, it must be as large or larger than the "
8184 "source file or device, otherwise the copy will fail.  This command cannot do "
8185 "partial copies (see C<guestfs_copy_size>)."
8186 msgstr ""
8187
8188 #. type: =head2
8189 #: ../src/guestfs-actions.pod:1178
8190 msgid "guestfs_df"
8191 msgstr ""
8192
8193 #. type: verbatim
8194 #: ../src/guestfs-actions.pod:1180
8195 #, no-wrap
8196 msgid ""
8197 " char *\n"
8198 " guestfs_df (guestfs_h *g);\n"
8199 "\n"
8200 msgstr ""
8201
8202 #. type: textblock
8203 #: ../src/guestfs-actions.pod:1183 ../fish/guestfish-actions.pod:796
8204 msgid "This command runs the C<df> command to report disk space used."
8205 msgstr ""
8206
8207 #. type: textblock
8208 #: ../src/guestfs-actions.pod:1185 ../src/guestfs-actions.pod:1202
8209 msgid ""
8210 "This command is mostly useful for interactive sessions.  It is I<not> "
8211 "intended that you try to parse the output string.  Use C<guestfs_statvfs> "
8212 "from programs."
8213 msgstr ""
8214
8215 #. type: textblock
8216 #: ../src/guestfs-actions.pod:1192 ../src/guestfs-actions.pod:1209
8217 #: ../src/guestfs-actions.pod:1327 ../src/guestfs-actions.pod:2288
8218 #: ../src/guestfs-actions.pod:2312 ../src/guestfs-actions.pod:2380
8219 #: ../src/guestfs-actions.pod:4275 ../src/guestfs-actions.pod:4757
8220 #: ../src/guestfs-actions.pod:6605 ../src/guestfs-actions.pod:6629
8221 #: ../src/guestfs-actions.pod:7254 ../src/guestfs-actions.pod:7267
8222 #: ../src/guestfs-actions.pod:7280
8223 msgid "(Added in 1.0.54)"
8224 msgstr ""
8225
8226 #. type: =head2
8227 #: ../src/guestfs-actions.pod:1194
8228 msgid "guestfs_df_h"
8229 msgstr ""
8230
8231 #. type: verbatim
8232 #: ../src/guestfs-actions.pod:1196
8233 #, no-wrap
8234 msgid ""
8235 " char *\n"
8236 " guestfs_df_h (guestfs_h *g);\n"
8237 "\n"
8238 msgstr ""
8239
8240 #. type: textblock
8241 #: ../src/guestfs-actions.pod:1199 ../fish/guestfish-actions.pod:806
8242 msgid ""
8243 "This command runs the C<df -h> command to report disk space used in human-"
8244 "readable format."
8245 msgstr ""
8246
8247 #. type: =head2
8248 #: ../src/guestfs-actions.pod:1211
8249 msgid "guestfs_dmesg"
8250 msgstr ""
8251
8252 #. type: verbatim
8253 #: ../src/guestfs-actions.pod:1213
8254 #, no-wrap
8255 msgid ""
8256 " char *\n"
8257 " guestfs_dmesg (guestfs_h *g);\n"
8258 "\n"
8259 msgstr ""
8260
8261 #. type: textblock
8262 #: ../src/guestfs-actions.pod:1216 ../fish/guestfish-actions.pod:817
8263 msgid ""
8264 "This returns the kernel messages (C<dmesg> output) from the guest kernel.  "
8265 "This is sometimes useful for extended debugging of problems."
8266 msgstr ""
8267
8268 #. type: textblock
8269 #: ../src/guestfs-actions.pod:1220
8270 msgid ""
8271 "Another way to get the same information is to enable verbose messages with "
8272 "C<guestfs_set_verbose> or by setting the environment variable "
8273 "C<LIBGUESTFS_DEBUG=1> before running the program."
8274 msgstr ""
8275
8276 #. type: =head2
8277 #: ../src/guestfs-actions.pod:1230
8278 msgid "guestfs_download"
8279 msgstr ""
8280
8281 #. type: verbatim
8282 #: ../src/guestfs-actions.pod:1232
8283 #, no-wrap
8284 msgid ""
8285 " int\n"
8286 " guestfs_download (guestfs_h *g,\n"
8287 "                   const char *remotefilename,\n"
8288 "                   const char *filename);\n"
8289 "\n"
8290 msgstr ""
8291
8292 #. type: textblock
8293 #: ../src/guestfs-actions.pod:1237 ../src/guestfs-actions.pod:1262
8294 #: ../fish/guestfish-actions.pod:830 ../fish/guestfish-actions.pod:843
8295 msgid ""
8296 "Download file C<remotefilename> and save it as C<filename> on the local "
8297 "machine."
8298 msgstr ""
8299
8300 #. type: textblock
8301 #: ../src/guestfs-actions.pod:1240 ../src/guestfs-actions.pod:6861
8302 #: ../fish/guestfish-actions.pod:833 ../fish/guestfish-actions.pod:4636
8303 msgid "C<filename> can also be a named pipe."
8304 msgstr ""
8305
8306 #. type: textblock
8307 #: ../src/guestfs-actions.pod:1242
8308 msgid "See also C<guestfs_upload>, C<guestfs_cat>."
8309 msgstr ""
8310
8311 #. type: =head2
8312 #: ../src/guestfs-actions.pod:1253
8313 msgid "guestfs_download_offset"
8314 msgstr ""
8315
8316 #. type: verbatim
8317 #: ../src/guestfs-actions.pod:1255
8318 #, no-wrap
8319 msgid ""
8320 " int\n"
8321 " guestfs_download_offset (guestfs_h *g,\n"
8322 "                          const char *remotefilename,\n"
8323 "                          const char *filename,\n"
8324 "                          int64_t offset,\n"
8325 "                          int64_t size);\n"
8326 "\n"
8327 msgstr ""
8328
8329 #. type: textblock
8330 #: ../src/guestfs-actions.pod:1265 ../fish/guestfish-actions.pod:846
8331 msgid ""
8332 "C<remotefilename> is read for C<size> bytes starting at C<offset> (this "
8333 "region must be within the file or device)."
8334 msgstr ""
8335
8336 #. type: textblock
8337 #: ../src/guestfs-actions.pod:1268
8338 msgid ""
8339 "Note that there is no limit on the amount of data that can be downloaded "
8340 "with this call, unlike with C<guestfs_pread>, and this call always reads the "
8341 "full amount unless an error occurs."
8342 msgstr ""
8343
8344 #. type: textblock
8345 #: ../src/guestfs-actions.pod:1273
8346 msgid "See also C<guestfs_download>, C<guestfs_pread>."
8347 msgstr ""
8348
8349 #. type: textblock
8350 #: ../src/guestfs-actions.pod:1282 ../src/guestfs-actions.pod:6906
8351 msgid "(Added in 1.5.17)"
8352 msgstr ""
8353
8354 #. type: =head2
8355 #: ../src/guestfs-actions.pod:1284
8356 msgid "guestfs_drop_caches"
8357 msgstr ""
8358
8359 #. type: verbatim
8360 #: ../src/guestfs-actions.pod:1286
8361 #, no-wrap
8362 msgid ""
8363 " int\n"
8364 " guestfs_drop_caches (guestfs_h *g,\n"
8365 "                      int whattodrop);\n"
8366 "\n"
8367 msgstr ""
8368
8369 #. type: textblock
8370 #: ../src/guestfs-actions.pod:1290 ../fish/guestfish-actions.pod:862
8371 msgid ""
8372 "This instructs the guest kernel to drop its page cache, and/or dentries and "
8373 "inode caches.  The parameter C<whattodrop> tells the kernel what precisely "
8374 "to drop, see L<http://linux-mm.org/Drop_Caches>"
8375 msgstr ""
8376
8377 #. type: textblock
8378 #: ../src/guestfs-actions.pod:1295 ../fish/guestfish-actions.pod:867
8379 msgid "Setting C<whattodrop> to 3 should drop everything."
8380 msgstr ""
8381
8382 #. type: textblock
8383 #: ../src/guestfs-actions.pod:1297 ../fish/guestfish-actions.pod:869
8384 msgid ""
8385 "This automatically calls L<sync(2)> before the operation, so that the "
8386 "maximum guest memory is freed."
8387 msgstr ""
8388
8389 #. type: =head2
8390 #: ../src/guestfs-actions.pod:1304
8391 msgid "guestfs_du"
8392 msgstr ""
8393
8394 #. type: verbatim
8395 #: ../src/guestfs-actions.pod:1306
8396 #, no-wrap
8397 msgid ""
8398 " int64_t\n"
8399 " guestfs_du (guestfs_h *g,\n"
8400 "             const char *path);\n"
8401 "\n"
8402 msgstr ""
8403
8404 #. type: textblock
8405 #: ../src/guestfs-actions.pod:1310 ../fish/guestfish-actions.pod:876
8406 msgid ""
8407 "This command runs the C<du -s> command to estimate file space usage for "
8408 "C<path>."
8409 msgstr ""
8410
8411 #. type: textblock
8412 #: ../src/guestfs-actions.pod:1313 ../fish/guestfish-actions.pod:879
8413 msgid ""
8414 "C<path> can be a file or a directory.  If C<path> is a directory then the "
8415 "estimate includes the contents of the directory and all subdirectories "
8416 "(recursively)."
8417 msgstr ""
8418
8419 #. type: textblock
8420 #: ../src/guestfs-actions.pod:1317 ../fish/guestfish-actions.pod:883
8421 msgid ""
8422 "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)."
8423 msgstr ""
8424
8425 #. type: =head2
8426 #: ../src/guestfs-actions.pod:1329
8427 msgid "guestfs_e2fsck_f"
8428 msgstr ""
8429
8430 #. type: verbatim
8431 #: ../src/guestfs-actions.pod:1331
8432 #, no-wrap
8433 msgid ""
8434 " int\n"
8435 " guestfs_e2fsck_f (guestfs_h *g,\n"
8436 "                   const char *device);\n"
8437 "\n"
8438 msgstr ""
8439
8440 #. type: textblock
8441 #: ../src/guestfs-actions.pod:1335 ../fish/guestfish-actions.pod:890
8442 msgid ""
8443 "This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker "
8444 "on C<device>, noninteractively (I<-p>), even if the filesystem appears to be "
8445 "clean (I<-f>)."
8446 msgstr ""
8447
8448 #. type: textblock
8449 #: ../src/guestfs-actions.pod:1339
8450 msgid ""
8451 "This command is only needed because of C<guestfs_resize2fs> (q.v.).  "
8452 "Normally you should use C<guestfs_fsck>."
8453 msgstr ""
8454
8455 #. type: textblock
8456 #: ../src/guestfs-actions.pod:1344
8457 msgid "(Added in 1.0.29)"
8458 msgstr ""
8459
8460 #. type: =head2
8461 #: ../src/guestfs-actions.pod:1346
8462 msgid "guestfs_echo_daemon"
8463 msgstr ""
8464
8465 #. type: verbatim
8466 #: ../src/guestfs-actions.pod:1348
8467 #, no-wrap
8468 msgid ""
8469 " char *\n"
8470 " guestfs_echo_daemon (guestfs_h *g,\n"
8471 "                      char *const *words);\n"
8472 "\n"
8473 msgstr ""
8474
8475 #. type: textblock
8476 #: ../src/guestfs-actions.pod:1352 ../fish/guestfish-actions.pod:901
8477 msgid ""
8478 "This command concatenates the list of C<words> passed with single spaces "
8479 "between them and returns the resulting string."
8480 msgstr ""
8481
8482 #. type: textblock
8483 #: ../src/guestfs-actions.pod:1355 ../fish/guestfish-actions.pod:904
8484 msgid "You can use this command to test the connection through to the daemon."
8485 msgstr ""
8486
8487 #. type: textblock
8488 #: ../src/guestfs-actions.pod:1357
8489 msgid "See also C<guestfs_ping_daemon>."
8490 msgstr ""
8491
8492 #. type: textblock
8493 #: ../src/guestfs-actions.pod:1362 ../src/guestfs-actions.pod:2096
8494 #: ../src/guestfs-actions.pod:6077
8495 msgid "(Added in 1.0.69)"
8496 msgstr ""
8497
8498 #. type: =head2
8499 #: ../src/guestfs-actions.pod:1364
8500 msgid "guestfs_egrep"
8501 msgstr ""
8502
8503 #. type: verbatim
8504 #: ../src/guestfs-actions.pod:1366
8505 #, no-wrap
8506 msgid ""
8507 " char **\n"
8508 " guestfs_egrep (guestfs_h *g,\n"
8509 "                const char *regex,\n"
8510 "                const char *path);\n"
8511 "\n"
8512 msgstr ""
8513
8514 #. type: textblock
8515 #: ../src/guestfs-actions.pod:1371 ../fish/guestfish-actions.pod:912
8516 msgid ""
8517 "This calls the external C<egrep> program and returns the matching lines."
8518 msgstr ""
8519
8520 #. type: textblock
8521 #: ../src/guestfs-actions.pod:1381 ../src/guestfs-actions.pod:1400
8522 #: ../src/guestfs-actions.pod:1457 ../src/guestfs-actions.pod:1503
8523 #: ../src/guestfs-actions.pod:1522 ../src/guestfs-actions.pod:2226
8524 #: ../src/guestfs-actions.pod:2245 ../src/guestfs-actions.pod:2401
8525 #: ../src/guestfs-actions.pod:2414 ../src/guestfs-actions.pod:2429
8526 #: ../src/guestfs-actions.pod:2475 ../src/guestfs-actions.pod:2497
8527 #: ../src/guestfs-actions.pod:2510 ../src/guestfs-actions.pod:3658
8528 #: ../src/guestfs-actions.pod:3672 ../src/guestfs-actions.pod:3685
8529 #: ../src/guestfs-actions.pod:3699 ../src/guestfs-actions.pod:4685
8530 #: ../src/guestfs-actions.pod:5577 ../src/guestfs-actions.pod:5626
8531 #: ../src/guestfs-actions.pod:6473 ../src/guestfs-actions.pod:6485
8532 #: ../src/guestfs-actions.pod:6498 ../src/guestfs-actions.pod:6511
8533 #: ../src/guestfs-actions.pod:6533 ../src/guestfs-actions.pod:6546
8534 #: ../src/guestfs-actions.pod:6559 ../src/guestfs-actions.pod:6572
8535 #: ../src/guestfs-actions.pod:7350 ../src/guestfs-actions.pod:7369
8536 #: ../src/guestfs-actions.pod:7454 ../src/guestfs-actions.pod:7473
8537 #: ../src/guestfs-actions.pod:7519 ../src/guestfs-actions.pod:7538
8538 msgid "(Added in 1.0.66)"
8539 msgstr ""
8540
8541 #. type: =head2
8542 #: ../src/guestfs-actions.pod:1383
8543 msgid "guestfs_egrepi"
8544 msgstr ""
8545
8546 #. type: verbatim
8547 #: ../src/guestfs-actions.pod:1385
8548 #, no-wrap
8549 msgid ""
8550 " char **\n"
8551 " guestfs_egrepi (guestfs_h *g,\n"
8552 "                 const char *regex,\n"
8553 "                 const char *path);\n"
8554 "\n"
8555 msgstr ""
8556
8557 #. type: textblock
8558 #: ../src/guestfs-actions.pod:1390 ../fish/guestfish-actions.pod:922
8559 msgid ""
8560 "This calls the external C<egrep -i> program and returns the matching lines."
8561 msgstr ""
8562
8563 #. type: =head2
8564 #: ../src/guestfs-actions.pod:1402
8565 msgid "guestfs_equal"
8566 msgstr ""
8567
8568 #. type: verbatim
8569 #: ../src/guestfs-actions.pod:1404
8570 #, no-wrap
8571 msgid ""
8572 " int\n"
8573 " guestfs_equal (guestfs_h *g,\n"
8574 "                const char *file1,\n"
8575 "                const char *file2);\n"
8576 "\n"
8577 msgstr ""
8578
8579 #. type: textblock
8580 #: ../src/guestfs-actions.pod:1409 ../fish/guestfish-actions.pod:932
8581 msgid ""
8582 "This compares the two files C<file1> and C<file2> and returns true if their "
8583 "content is exactly equal, or false otherwise."
8584 msgstr ""
8585
8586 #. type: textblock
8587 #: ../src/guestfs-actions.pod:1412 ../fish/guestfish-actions.pod:935
8588 msgid "The external L<cmp(1)> program is used for the comparison."
8589 msgstr ""
8590
8591 #. type: =head2
8592 #: ../src/guestfs-actions.pod:1418
8593 msgid "guestfs_exists"
8594 msgstr ""
8595
8596 #. type: verbatim
8597 #: ../src/guestfs-actions.pod:1420
8598 #, no-wrap
8599 msgid ""
8600 " int\n"
8601 " guestfs_exists (guestfs_h *g,\n"
8602 "                 const char *path);\n"
8603 "\n"
8604 msgstr ""
8605
8606 #. type: textblock
8607 #: ../src/guestfs-actions.pod:1424 ../fish/guestfish-actions.pod:941
8608 msgid ""
8609 "This returns C<true> if and only if there is a file, directory (or anything) "
8610 "with the given C<path> name."
8611 msgstr ""
8612
8613 #. type: textblock
8614 #: ../src/guestfs-actions.pod:1427
8615 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>."
8616 msgstr ""
8617
8618 #. type: =head2
8619 #: ../src/guestfs-actions.pod:1433
8620 msgid "guestfs_fallocate"
8621 msgstr ""
8622
8623 #. type: verbatim
8624 #: ../src/guestfs-actions.pod:1435
8625 #, no-wrap
8626 msgid ""
8627 " int\n"
8628 " guestfs_fallocate (guestfs_h *g,\n"
8629 "                    const char *path,\n"
8630 "                    int len);\n"
8631 "\n"
8632 msgstr ""
8633
8634 #. type: textblock
8635 #: ../src/guestfs-actions.pod:1440 ../src/guestfs-actions.pod:1466
8636 #: ../fish/guestfish-actions.pod:950 ../fish/guestfish-actions.pod:969
8637 msgid ""
8638 "This command preallocates a file (containing zero bytes) named C<path> of "
8639 "size C<len> bytes.  If the file exists already, it is overwritten."
8640 msgstr ""
8641
8642 #. type: textblock
8643 #: ../src/guestfs-actions.pod:1444 ../fish/guestfish-actions.pod:954
8644 msgid ""
8645 "Do not confuse this with the guestfish-specific C<alloc> command which "
8646 "allocates a file in the host and attaches it as a device."
8647 msgstr ""
8648
8649 #. type: textblock
8650 #: ../src/guestfs-actions.pod:1450
8651 msgid ""
8652 "This function is deprecated.  In new code, use the L</guestfs_fallocate64> "
8653 "call instead."
8654 msgstr ""
8655
8656 #. type: =head2
8657 #: ../src/guestfs-actions.pod:1459
8658 msgid "guestfs_fallocate64"
8659 msgstr ""
8660
8661 #. type: verbatim
8662 #: ../src/guestfs-actions.pod:1461
8663 #, no-wrap
8664 msgid ""
8665 " int\n"
8666 " guestfs_fallocate64 (guestfs_h *g,\n"
8667 "                      const char *path,\n"
8668 "                      int64_t len);\n"
8669 "\n"
8670 msgstr ""
8671
8672 #. type: textblock
8673 #: ../src/guestfs-actions.pod:1470
8674 msgid ""
8675 "Note that this call allocates disk blocks for the file.  To create a sparse "
8676 "file use C<guestfs_truncate_size> instead."
8677 msgstr ""
8678
8679 #. type: textblock
8680 #: ../src/guestfs-actions.pod:1473
8681 msgid ""
8682 "The deprecated call C<guestfs_fallocate> does the same, but owing to an "
8683 "oversight it only allowed 30 bit lengths to be specified, effectively "
8684 "limiting the maximum size of files created through that call to 1GB."
8685 msgstr ""
8686
8687 #. type: textblock
8688 #: ../src/guestfs-actions.pod:1478 ../fish/guestfish-actions.pod:981
8689 msgid ""
8690 "Do not confuse this with the guestfish-specific C<alloc> and C<sparse> "
8691 "commands which create a file in the host and attach it as a device."
8692 msgstr ""
8693
8694 #. type: textblock
8695 #: ../src/guestfs-actions.pod:1484
8696 msgid "(Added in 1.3.17)"
8697 msgstr ""
8698
8699 #. type: =head2
8700 #: ../src/guestfs-actions.pod:1486
8701 msgid "guestfs_fgrep"
8702 msgstr ""
8703
8704 #. type: verbatim
8705 #: ../src/guestfs-actions.pod:1488
8706 #, no-wrap
8707 msgid ""
8708 " char **\n"
8709 " guestfs_fgrep (guestfs_h *g,\n"
8710 "                const char *pattern,\n"
8711 "                const char *path);\n"
8712 "\n"
8713 msgstr ""
8714
8715 #. type: textblock
8716 #: ../src/guestfs-actions.pod:1493 ../fish/guestfish-actions.pod:989
8717 msgid ""
8718 "This calls the external C<fgrep> program and returns the matching lines."
8719 msgstr ""
8720
8721 #. type: =head2
8722 #: ../src/guestfs-actions.pod:1505
8723 msgid "guestfs_fgrepi"
8724 msgstr ""
8725
8726 #. type: verbatim
8727 #: ../src/guestfs-actions.pod:1507
8728 #, no-wrap
8729 msgid ""
8730 " char **\n"
8731 " guestfs_fgrepi (guestfs_h *g,\n"
8732 "                 const char *pattern,\n"
8733 "                 const char *path);\n"
8734 "\n"
8735 msgstr ""
8736
8737 #. type: textblock
8738 #: ../src/guestfs-actions.pod:1512 ../fish/guestfish-actions.pod:999
8739 msgid ""
8740 "This calls the external C<fgrep -i> program and returns the matching lines."
8741 msgstr ""
8742
8743 #. type: =head2
8744 #: ../src/guestfs-actions.pod:1524
8745 msgid "guestfs_file"
8746 msgstr ""
8747
8748 #. type: verbatim
8749 #: ../src/guestfs-actions.pod:1526
8750 #, no-wrap
8751 msgid ""
8752 " char *\n"
8753 " guestfs_file (guestfs_h *g,\n"
8754 "               const char *path);\n"
8755 "\n"
8756 msgstr ""
8757
8758 #. type: textblock
8759 #: ../src/guestfs-actions.pod:1530 ../fish/guestfish-actions.pod:1009
8760 msgid ""
8761 "This call uses the standard L<file(1)> command to determine the type or "
8762 "contents of the file."
8763 msgstr ""
8764
8765 #. type: textblock
8766 #: ../src/guestfs-actions.pod:1533 ../fish/guestfish-actions.pod:1012
8767 msgid ""
8768 "This call will also transparently look inside various types of compressed "
8769 "file."
8770 msgstr ""
8771
8772 #. type: textblock
8773 #: ../src/guestfs-actions.pod:1536 ../fish/guestfish-actions.pod:1015
8774 msgid ""
8775 "The exact command which runs is C<file -zb path>.  Note in particular that "
8776 "the filename is not prepended to the output (the I<-b> option)."
8777 msgstr ""
8778
8779 #. type: textblock
8780 #: ../src/guestfs-actions.pod:1540 ../fish/guestfish-actions.pod:1019
8781 msgid ""
8782 "The output depends on the output of the underlying L<file(1)> command and it "
8783 "can change in future in ways beyond our control.  In other words, the output "
8784 "is not guaranteed by the ABI."
8785 msgstr ""
8786
8787 #. type: textblock
8788 #: ../src/guestfs-actions.pod:1544
8789 msgid ""
8790 "See also: L<file(1)>, C<guestfs_vfs_type>, C<guestfs_lstat>, "
8791 "C<guestfs_is_file>, C<guestfs_is_blockdev> (etc)."
8792 msgstr ""
8793
8794 #. type: =head2
8795 #: ../src/guestfs-actions.pod:1552
8796 msgid "guestfs_file_architecture"
8797 msgstr ""
8798
8799 #. type: verbatim
8800 #: ../src/guestfs-actions.pod:1554
8801 #, no-wrap
8802 msgid ""
8803 " char *\n"
8804 " guestfs_file_architecture (guestfs_h *g,\n"
8805 "                            const char *filename);\n"
8806 "\n"
8807 msgstr ""
8808
8809 #. type: textblock
8810 #: ../src/guestfs-actions.pod:1558 ../fish/guestfish-actions.pod:1030
8811 msgid ""
8812 "This detects the architecture of the binary C<filename>, and returns it if "
8813 "known."
8814 msgstr ""
8815
8816 #. type: textblock
8817 #: ../src/guestfs-actions.pod:1561 ../fish/guestfish-actions.pod:1033
8818 msgid "Currently defined architectures are:"
8819 msgstr ""
8820
8821 #. type: =item
8822 #: ../src/guestfs-actions.pod:1565 ../fish/guestfish-actions.pod:1037
8823 msgid "\"i386\""
8824 msgstr "\"i386\""
8825
8826 #. type: textblock
8827 #: ../src/guestfs-actions.pod:1567 ../fish/guestfish-actions.pod:1039
8828 msgid ""
8829 "This string is returned for all 32 bit i386, i486, i586, i686 binaries "
8830 "irrespective of the precise processor requirements of the binary."
8831 msgstr ""
8832
8833 #. type: =item
8834 #: ../src/guestfs-actions.pod:1570 ../fish/guestfish-actions.pod:1042
8835 msgid "\"x86_64\""
8836 msgstr "\"x86_64\""
8837
8838 #. type: textblock
8839 #: ../src/guestfs-actions.pod:1572 ../fish/guestfish-actions.pod:1044
8840 msgid "64 bit x86-64."
8841 msgstr ""
8842
8843 #. type: =item
8844 #: ../src/guestfs-actions.pod:1574 ../fish/guestfish-actions.pod:1046
8845 msgid "\"sparc\""
8846 msgstr ""
8847
8848 #. type: textblock
8849 #: ../src/guestfs-actions.pod:1576 ../fish/guestfish-actions.pod:1048
8850 msgid "32 bit SPARC."
8851 msgstr ""
8852
8853 #. type: =item
8854 #: ../src/guestfs-actions.pod:1578 ../fish/guestfish-actions.pod:1050
8855 msgid "\"sparc64\""
8856 msgstr ""
8857
8858 #. type: textblock
8859 #: ../src/guestfs-actions.pod:1580 ../fish/guestfish-actions.pod:1052
8860 msgid "64 bit SPARC V9 and above."
8861 msgstr ""
8862
8863 #. type: =item
8864 #: ../src/guestfs-actions.pod:1582 ../fish/guestfish-actions.pod:1054
8865 msgid "\"ia64\""
8866 msgstr "\"ia64\""
8867
8868 #. type: textblock
8869 #: ../src/guestfs-actions.pod:1584 ../fish/guestfish-actions.pod:1056
8870 msgid "Intel Itanium."
8871 msgstr "Intel Itanium."
8872
8873 #. type: =item
8874 #: ../src/guestfs-actions.pod:1586 ../fish/guestfish-actions.pod:1058
8875 msgid "\"ppc\""
8876 msgstr ""
8877
8878 #. type: textblock
8879 #: ../src/guestfs-actions.pod:1588 ../fish/guestfish-actions.pod:1060
8880 msgid "32 bit Power PC."
8881 msgstr ""
8882
8883 #. type: =item
8884 #: ../src/guestfs-actions.pod:1590 ../fish/guestfish-actions.pod:1062
8885 msgid "\"ppc64\""
8886 msgstr ""
8887
8888 #. type: textblock
8889 #: ../src/guestfs-actions.pod:1592 ../fish/guestfish-actions.pod:1064
8890 msgid "64 bit Power PC."
8891 msgstr ""
8892
8893 #. type: textblock
8894 #: ../src/guestfs-actions.pod:1596 ../fish/guestfish-actions.pod:1068
8895 msgid "Libguestfs may return other architecture strings in future."
8896 msgstr ""
8897
8898 #. type: textblock
8899 #: ../src/guestfs-actions.pod:1598 ../fish/guestfish-actions.pod:1070
8900 msgid "The function works on at least the following types of files:"
8901 msgstr ""
8902
8903 #. type: textblock
8904 #: ../src/guestfs-actions.pod:1604 ../fish/guestfish-actions.pod:1076
8905 msgid "many types of Un*x and Linux binary"
8906 msgstr ""
8907
8908 #. type: textblock
8909 #: ../src/guestfs-actions.pod:1608 ../fish/guestfish-actions.pod:1080
8910 msgid "many types of Un*x and Linux shared library"
8911 msgstr ""
8912
8913 #. type: textblock
8914 #: ../src/guestfs-actions.pod:1612 ../fish/guestfish-actions.pod:1084
8915 msgid "Windows Win32 and Win64 binaries"
8916 msgstr ""
8917
8918 #. type: textblock
8919 #: ../src/guestfs-actions.pod:1616 ../fish/guestfish-actions.pod:1088
8920 msgid "Windows Win32 and Win64 DLLs"
8921 msgstr ""
8922
8923 #. type: textblock
8924 #: ../src/guestfs-actions.pod:1618 ../fish/guestfish-actions.pod:1090
8925 msgid "Win32 binaries and DLLs return C<i386>."
8926 msgstr ""
8927
8928 #. type: textblock
8929 #: ../src/guestfs-actions.pod:1620 ../fish/guestfish-actions.pod:1092
8930 msgid "Win64 binaries and DLLs return C<x86_64>."
8931 msgstr ""
8932
8933 #. type: textblock
8934 #: ../src/guestfs-actions.pod:1624 ../fish/guestfish-actions.pod:1096
8935 msgid "Linux kernel modules"
8936 msgstr ""
8937
8938 #. type: textblock
8939 #: ../src/guestfs-actions.pod:1628 ../fish/guestfish-actions.pod:1100
8940 msgid "Linux new-style initrd images"
8941 msgstr ""
8942
8943 #. type: textblock
8944 #: ../src/guestfs-actions.pod:1632 ../fish/guestfish-actions.pod:1104
8945 msgid "some non-x86 Linux vmlinuz kernels"
8946 msgstr ""
8947
8948 #. type: textblock
8949 #: ../src/guestfs-actions.pod:1636 ../fish/guestfish-actions.pod:1108
8950 msgid "What it can't do currently:"
8951 msgstr ""
8952
8953 #. type: textblock
8954 #: ../src/guestfs-actions.pod:1642 ../fish/guestfish-actions.pod:1114
8955 msgid "static libraries (libfoo.a)"
8956 msgstr ""
8957
8958 #. type: textblock
8959 #: ../src/guestfs-actions.pod:1646 ../fish/guestfish-actions.pod:1118
8960 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)"
8961 msgstr ""
8962
8963 #. type: textblock
8964 #: ../src/guestfs-actions.pod:1650 ../fish/guestfish-actions.pod:1122
8965 msgid "x86 Linux vmlinuz kernels"
8966 msgstr ""
8967
8968 #. type: textblock
8969 #: ../src/guestfs-actions.pod:1652 ../fish/guestfish-actions.pod:1124
8970 msgid ""
8971 "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and "
8972 "compressed code, and are horribly hard to unpack.  If you want to find the "
8973 "architecture of a kernel, use the architecture of the associated initrd or "
8974 "kernel module(s) instead."
8975 msgstr ""
8976
8977 #. type: textblock
8978 #: ../src/guestfs-actions.pod:1662 ../src/guestfs-actions.pod:1825
8979 #: ../src/guestfs-actions.pod:1842 ../src/guestfs-actions.pod:2533
8980 #: ../src/guestfs-actions.pod:2626 ../src/guestfs-actions.pod:2696
8981 #: ../src/guestfs-actions.pod:2784 ../src/guestfs-actions.pod:2805
8982 #: ../src/guestfs-actions.pod:2848 ../src/guestfs-actions.pod:2932
8983 #: ../src/guestfs-actions.pod:3029 ../src/guestfs-actions.pod:3276
8984 #: ../src/guestfs-actions.pod:3408
8985 msgid "(Added in 1.5.3)"
8986 msgstr ""
8987
8988 #. type: =head2
8989 #: ../src/guestfs-actions.pod:1664
8990 msgid "guestfs_filesize"
8991 msgstr ""
8992
8993 #. type: verbatim
8994 #: ../src/guestfs-actions.pod:1666
8995 #, no-wrap
8996 msgid ""
8997 " int64_t\n"
8998 " guestfs_filesize (guestfs_h *g,\n"
8999 "                   const char *file);\n"
9000 "\n"
9001 msgstr ""
9002
9003 #. type: textblock
9004 #: ../src/guestfs-actions.pod:1670 ../fish/guestfish-actions.pod:1135
9005 msgid "This command returns the size of C<file> in bytes."
9006 msgstr ""
9007
9008 #. type: textblock
9009 #: ../src/guestfs-actions.pod:1672
9010 msgid ""
9011 "To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, "
9012 "C<guestfs_is_dir>, C<guestfs_is_file> etc.  To get the size of block "
9013 "devices, use C<guestfs_blockdev_getsize64>."
9014 msgstr ""
9015
9016 #. type: textblock
9017 #: ../src/guestfs-actions.pod:1678
9018 msgid "(Added in 1.0.82)"
9019 msgstr ""
9020
9021 #. type: =head2
9022 #: ../src/guestfs-actions.pod:1680
9023 msgid "guestfs_fill"
9024 msgstr ""
9025
9026 #. type: verbatim
9027 #: ../src/guestfs-actions.pod:1682
9028 #, no-wrap
9029 msgid ""
9030 " int\n"
9031 " guestfs_fill (guestfs_h *g,\n"
9032 "               int c,\n"
9033 "               int len,\n"
9034 "               const char *path);\n"
9035 "\n"
9036 msgstr ""
9037
9038 #. type: textblock
9039 #: ../src/guestfs-actions.pod:1688 ../fish/guestfish-actions.pod:1145
9040 msgid ""
9041 "This command creates a new file called C<path>.  The initial content of the "
9042 "file is C<len> octets of C<c>, where C<c> must be a number in the range C<"
9043 "[0..255]>."
9044 msgstr ""
9045
9046 #. type: textblock
9047 #: ../src/guestfs-actions.pod:1692
9048 msgid ""
9049 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
9050 "C<guestfs_truncate_size>.  To create a file with a pattern of repeating "
9051 "bytes use C<guestfs_fill_pattern>."
9052 msgstr ""
9053
9054 #. type: textblock
9055 #: ../src/guestfs-actions.pod:1704
9056 msgid "(Added in 1.0.79)"
9057 msgstr ""
9058
9059 #. type: =head2
9060 #: ../src/guestfs-actions.pod:1706
9061 msgid "guestfs_fill_pattern"
9062 msgstr ""
9063
9064 #. type: verbatim
9065 #: ../src/guestfs-actions.pod:1708
9066 #, no-wrap
9067 msgid ""
9068 " int\n"
9069 " guestfs_fill_pattern (guestfs_h *g,\n"
9070 "                       const char *pattern,\n"
9071 "                       int len,\n"
9072 "                       const char *path);\n"
9073 "\n"
9074 msgstr ""
9075
9076 #. type: textblock
9077 #: ../src/guestfs-actions.pod:1714
9078 msgid ""
9079 "This function is like C<guestfs_fill> except that it creates a new file of "
9080 "length C<len> containing the repeating pattern of bytes in C<pattern>.  The "
9081 "pattern is truncated if necessary to ensure the length of the file is "
9082 "exactly C<len> bytes."
9083 msgstr ""
9084
9085 #. type: textblock
9086 #: ../src/guestfs-actions.pod:1726
9087 msgid "(Added in 1.3.12)"
9088 msgstr ""
9089
9090 #. type: =head2
9091 #: ../src/guestfs-actions.pod:1728
9092 msgid "guestfs_find"
9093 msgstr ""
9094
9095 #. type: verbatim
9096 #: ../src/guestfs-actions.pod:1730
9097 #, no-wrap
9098 msgid ""
9099 " char **\n"
9100 " guestfs_find (guestfs_h *g,\n"
9101 "               const char *directory);\n"
9102 "\n"
9103 msgstr ""
9104
9105 #. type: textblock
9106 #: ../src/guestfs-actions.pod:1734 ../fish/guestfish-actions.pod:1167
9107 msgid ""
9108 "This command lists out all files and directories, recursively, starting at "
9109 "C<directory>.  It is essentially equivalent to running the shell command "
9110 "C<find directory -print> but some post-processing happens on the output, "
9111 "described below."
9112 msgstr ""
9113
9114 #. type: textblock
9115 #: ../src/guestfs-actions.pod:1739 ../fish/guestfish-actions.pod:1172
9116 msgid ""
9117 "This returns a list of strings I<without any prefix>.  Thus if the directory "
9118 "structure was:"
9119 msgstr ""
9120
9121 #. type: verbatim
9122 #: ../src/guestfs-actions.pod:1742 ../fish/guestfish-actions.pod:1175
9123 #, no-wrap
9124 msgid ""
9125 " /tmp/a\n"
9126 " /tmp/b\n"
9127 " /tmp/c/d\n"
9128 "\n"
9129 msgstr ""
9130
9131 #. type: textblock
9132 #: ../src/guestfs-actions.pod:1746
9133 msgid ""
9134 "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:"
9135 msgstr ""
9136
9137 #. type: verbatim
9138 #: ../src/guestfs-actions.pod:1749 ../fish/guestfish-actions.pod:1182
9139 #, no-wrap
9140 msgid ""
9141 " a\n"
9142 " b\n"
9143 " c\n"
9144 " c/d\n"
9145 "\n"
9146 msgstr ""
9147
9148 #. type: textblock
9149 #: ../src/guestfs-actions.pod:1754 ../fish/guestfish-actions.pod:1187
9150 msgid "If C<directory> is not a directory, then this command returns an error."
9151 msgstr ""
9152
9153 #. type: textblock
9154 #: ../src/guestfs-actions.pod:1757 ../fish/guestfish-actions.pod:1190
9155 msgid "The returned list is sorted."
9156 msgstr ""
9157
9158 #. type: textblock
9159 #: ../src/guestfs-actions.pod:1759
9160 msgid "See also C<guestfs_find0>."
9161 msgstr ""
9162
9163 #. type: textblock
9164 #: ../src/guestfs-actions.pod:1768 ../src/guestfs-actions.pod:4102
9165 #: ../src/guestfs-actions.pod:5661
9166 msgid "(Added in 1.0.27)"
9167 msgstr ""
9168
9169 #. type: =head2
9170 #: ../src/guestfs-actions.pod:1770
9171 msgid "guestfs_find0"
9172 msgstr ""
9173
9174 #. type: verbatim
9175 #: ../src/guestfs-actions.pod:1772
9176 #, no-wrap
9177 msgid ""
9178 " int\n"
9179 " guestfs_find0 (guestfs_h *g,\n"
9180 "                const char *directory,\n"
9181 "                const char *files);\n"
9182 "\n"
9183 msgstr ""
9184
9185 #. type: textblock
9186 #: ../src/guestfs-actions.pod:1777 ../fish/guestfish-actions.pod:1201
9187 msgid ""
9188 "This command lists out all files and directories, recursively, starting at "
9189 "C<directory>, placing the resulting list in the external file called "
9190 "C<files>."
9191 msgstr ""
9192
9193 #. type: textblock
9194 #: ../src/guestfs-actions.pod:1781
9195 msgid ""
9196 "This command works the same way as C<guestfs_find> with the following "
9197 "exceptions:"
9198 msgstr ""
9199
9200 #. type: textblock
9201 #: ../src/guestfs-actions.pod:1788 ../fish/guestfish-actions.pod:1212
9202 msgid "The resulting list is written to an external file."
9203 msgstr ""
9204
9205 #. type: textblock
9206 #: ../src/guestfs-actions.pod:1792 ../fish/guestfish-actions.pod:1216
9207 msgid ""
9208 "Items (filenames) in the result are separated by C<\\0> characters.  See "
9209 "L<find(1)> option I<-print0>."
9210 msgstr ""
9211
9212 #. type: textblock
9213 #: ../src/guestfs-actions.pod:1797 ../fish/guestfish-actions.pod:1221
9214 msgid "This command is not limited in the number of names that it can return."
9215 msgstr ""
9216
9217 #. type: textblock
9218 #: ../src/guestfs-actions.pod:1802 ../fish/guestfish-actions.pod:1226
9219 msgid "The result list is not sorted."
9220 msgstr ""
9221
9222 #. type: textblock
9223 #: ../src/guestfs-actions.pod:1808
9224 msgid "(Added in 1.0.74)"
9225 msgstr ""
9226
9227 #. type: =head2
9228 #: ../src/guestfs-actions.pod:1810
9229 msgid "guestfs_findfs_label"
9230 msgstr ""
9231
9232 #. type: verbatim
9233 #: ../src/guestfs-actions.pod:1812
9234 #, no-wrap
9235 msgid ""
9236 " char *\n"
9237 " guestfs_findfs_label (guestfs_h *g,\n"
9238 "                       const char *label);\n"
9239 "\n"
9240 msgstr ""
9241
9242 #. type: textblock
9243 #: ../src/guestfs-actions.pod:1816 ../fish/guestfish-actions.pod:1236
9244 msgid ""
9245 "This command searches the filesystems and returns the one which has the "
9246 "given label.  An error is returned if no such filesystem can be found."
9247 msgstr ""
9248
9249 #. type: textblock
9250 #: ../src/guestfs-actions.pod:1820
9251 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>."
9252 msgstr ""
9253
9254 #. type: =head2
9255 #: ../src/guestfs-actions.pod:1827
9256 msgid "guestfs_findfs_uuid"
9257 msgstr ""
9258
9259 #. type: verbatim
9260 #: ../src/guestfs-actions.pod:1829
9261 #, no-wrap
9262 msgid ""
9263 " char *\n"
9264 " guestfs_findfs_uuid (guestfs_h *g,\n"
9265 "                      const char *uuid);\n"
9266 "\n"
9267 msgstr ""
9268
9269 #. type: textblock
9270 #: ../src/guestfs-actions.pod:1833 ../fish/guestfish-actions.pod:1246
9271 msgid ""
9272 "This command searches the filesystems and returns the one which has the "
9273 "given UUID.  An error is returned if no such filesystem can be found."
9274 msgstr ""
9275
9276 #. type: textblock
9277 #: ../src/guestfs-actions.pod:1837
9278 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>."
9279 msgstr ""
9280
9281 #. type: =head2
9282 #: ../src/guestfs-actions.pod:1844
9283 msgid "guestfs_fsck"
9284 msgstr ""
9285
9286 #. type: verbatim
9287 #: ../src/guestfs-actions.pod:1846
9288 #, no-wrap
9289 msgid ""
9290 " int\n"
9291 " guestfs_fsck (guestfs_h *g,\n"
9292 "               const char *fstype,\n"
9293 "               const char *device);\n"
9294 "\n"
9295 msgstr ""
9296
9297 #. type: textblock
9298 #: ../src/guestfs-actions.pod:1851 ../fish/guestfish-actions.pod:1256
9299 msgid ""
9300 "This runs the filesystem checker (fsck) on C<device> which should have "
9301 "filesystem type C<fstype>."
9302 msgstr ""
9303
9304 #. type: textblock
9305 #: ../src/guestfs-actions.pod:1854 ../fish/guestfish-actions.pod:1259
9306 msgid ""
9307 "The returned integer is the status.  See L<fsck(8)> for the list of status "
9308 "codes from C<fsck>."
9309 msgstr ""
9310
9311 #. type: textblock
9312 #: ../src/guestfs-actions.pod:1863 ../fish/guestfish-actions.pod:1268
9313 msgid "Multiple status codes can be summed together."
9314 msgstr ""
9315
9316 #. type: textblock
9317 #: ../src/guestfs-actions.pod:1867 ../fish/guestfish-actions.pod:1272
9318 msgid ""
9319 "A non-zero return code can mean \"success\", for example if errors have been "
9320 "corrected on the filesystem."
9321 msgstr ""
9322
9323 #. type: textblock
9324 #: ../src/guestfs-actions.pod:1872 ../fish/guestfish-actions.pod:1277
9325 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)."
9326 msgstr ""
9327
9328 #. type: textblock
9329 #: ../src/guestfs-actions.pod:1877 ../fish/guestfish-actions.pod:1282
9330 msgid ""
9331 "This command is entirely equivalent to running C<fsck -a -t fstype device>."
9332 msgstr ""
9333
9334 #. type: textblock
9335 #: ../src/guestfs-actions.pod:1881 ../src/guestfs-actions.pod:7392
9336 msgid "(Added in 1.0.16)"
9337 msgstr ""
9338
9339 #. type: =head2
9340 #: ../src/guestfs-actions.pod:1883
9341 msgid "guestfs_get_append"
9342 msgstr ""
9343
9344 #. type: verbatim
9345 #: ../src/guestfs-actions.pod:1885
9346 #, no-wrap
9347 msgid ""
9348 " const char *\n"
9349 " guestfs_get_append (guestfs_h *g);\n"
9350 "\n"
9351 msgstr ""
9352
9353 #. type: textblock
9354 #: ../src/guestfs-actions.pod:1888 ../fish/guestfish-actions.pod:1288
9355 msgid ""
9356 "Return the additional kernel options which are added to the guest kernel "
9357 "command line."
9358 msgstr ""
9359
9360 #. type: textblock
9361 #: ../src/guestfs-actions.pod:1891 ../fish/guestfish-actions.pod:1291
9362 msgid "If C<NULL> then no options are added."
9363 msgstr ""
9364
9365 #. type: textblock
9366 #: ../src/guestfs-actions.pod:1893
9367 msgid ""
9368 "This function returns a string which may be NULL.  There is no way to return "
9369 "an error from this function.  The string is owned by the guest handle and "
9370 "must I<not> be freed."
9371 msgstr ""
9372
9373 #. type: textblock
9374 #: ../src/guestfs-actions.pod:1897 ../src/guestfs-actions.pod:5339
9375 #: ../src/guestfs-actions.pod:5819 ../src/guestfs-actions.pod:6240
9376 #: ../src/guestfs-actions.pod:6259 ../src/guestfs-actions.pod:6275
9377 #: ../src/guestfs-actions.pod:6299 ../src/guestfs-actions.pod:7056
9378 #: ../src/guestfs-actions.pod:7074 ../src/guestfs-actions.pod:7435
9379 msgid "(Added in 1.0.26)"
9380 msgstr ""
9381
9382 #. type: =head2
9383 #: ../src/guestfs-actions.pod:1899
9384 msgid "guestfs_get_attach_method"
9385 msgstr ""
9386
9387 #. type: verbatim
9388 #: ../src/guestfs-actions.pod:1901
9389 #, no-wrap
9390 msgid ""
9391 " char *\n"
9392 " guestfs_get_attach_method (guestfs_h *g);\n"
9393 "\n"
9394 msgstr ""
9395
9396 #. type: textblock
9397 #: ../src/guestfs-actions.pod:1904
9398 msgid "Return the current attach method.  See C<guestfs_set_attach_method>."
9399 msgstr ""
9400
9401 #. type: =head2
9402 #: ../src/guestfs-actions.pod:1909
9403 msgid "guestfs_get_autosync"
9404 msgstr ""
9405
9406 #. type: verbatim
9407 #: ../src/guestfs-actions.pod:1911
9408 #, no-wrap
9409 msgid ""
9410 " int\n"
9411 " guestfs_get_autosync (guestfs_h *g);\n"
9412 "\n"
9413 msgstr ""
9414
9415 #. type: textblock
9416 #: ../src/guestfs-actions.pod:1914 ../fish/guestfish-actions.pod:1303
9417 msgid "Get the autosync flag."
9418 msgstr ""
9419
9420 #. type: =head2
9421 #: ../src/guestfs-actions.pod:1920
9422 msgid "guestfs_get_direct"
9423 msgstr ""
9424
9425 #. type: verbatim
9426 #: ../src/guestfs-actions.pod:1922
9427 #, no-wrap
9428 msgid ""
9429 " int\n"
9430 " guestfs_get_direct (guestfs_h *g);\n"
9431 "\n"
9432 msgstr ""
9433
9434 #. type: textblock
9435 #: ../src/guestfs-actions.pod:1925 ../fish/guestfish-actions.pod:1309
9436 msgid "Return the direct appliance mode flag."
9437 msgstr ""
9438
9439 #. type: textblock
9440 #: ../src/guestfs-actions.pod:1929 ../src/guestfs-actions.pod:5888
9441 msgid "(Added in 1.0.72)"
9442 msgstr ""
9443
9444 #. type: =head2
9445 #: ../src/guestfs-actions.pod:1931
9446 msgid "guestfs_get_e2label"
9447 msgstr ""
9448
9449 #. type: verbatim
9450 #: ../src/guestfs-actions.pod:1933
9451 #, no-wrap
9452 msgid ""
9453 " char *\n"
9454 " guestfs_get_e2label (guestfs_h *g,\n"
9455 "                      const char *device);\n"
9456 "\n"
9457 msgstr ""
9458
9459 #. type: textblock
9460 #: ../src/guestfs-actions.pod:1937 ../fish/guestfish-actions.pod:1315
9461 msgid ""
9462 "This returns the ext2/3/4 filesystem label of the filesystem on C<device>."
9463 msgstr ""
9464
9465 #. type: textblock
9466 #: ../src/guestfs-actions.pod:1943
9467 msgid ""
9468 "This function is deprecated.  In new code, use the L</guestfs_vfs_label> "
9469 "call instead."
9470 msgstr ""
9471
9472 #. type: textblock
9473 #: ../src/guestfs-actions.pod:1950 ../src/guestfs-actions.pod:1971
9474 #: ../src/guestfs-actions.pod:5906 ../src/guestfs-actions.pod:5925
9475 msgid "(Added in 1.0.15)"
9476 msgstr ""
9477
9478 #. type: =head2
9479 #: ../src/guestfs-actions.pod:1952
9480 msgid "guestfs_get_e2uuid"
9481 msgstr ""
9482
9483 #. type: verbatim
9484 #: ../src/guestfs-actions.pod:1954
9485 #, no-wrap
9486 msgid ""
9487 " char *\n"
9488 " guestfs_get_e2uuid (guestfs_h *g,\n"
9489 "                     const char *device);\n"
9490 "\n"
9491 msgstr ""
9492
9493 #. type: textblock
9494 #: ../src/guestfs-actions.pod:1958 ../fish/guestfish-actions.pod:1329
9495 msgid ""
9496 "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>."
9497 msgstr ""
9498
9499 #. type: textblock
9500 #: ../src/guestfs-actions.pod:1964
9501 msgid ""
9502 "This function is deprecated.  In new code, use the L</guestfs_vfs_uuid> call "
9503 "instead."
9504 msgstr ""
9505
9506 #. type: =head2
9507 #: ../src/guestfs-actions.pod:1973
9508 msgid "guestfs_get_memsize"
9509 msgstr ""
9510
9511 #. type: verbatim
9512 #: ../src/guestfs-actions.pod:1975
9513 #, no-wrap
9514 msgid ""
9515 " int\n"
9516 " guestfs_get_memsize (guestfs_h *g);\n"
9517 "\n"
9518 msgstr ""
9519
9520 #. type: textblock
9521 #: ../src/guestfs-actions.pod:1978 ../fish/guestfish-actions.pod:1343
9522 msgid ""
9523 "This gets the memory size in megabytes allocated to the qemu subprocess."
9524 msgstr ""
9525
9526 #. type: textblock
9527 #: ../src/guestfs-actions.pod:1981
9528 msgid ""
9529 "If C<guestfs_set_memsize> was not called on this handle, and if "
9530 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
9531 "value for memsize."
9532 msgstr ""
9533
9534 #. type: textblock
9535 #: ../src/guestfs-actions.pod:1985 ../src/guestfs-actions.pod:2066
9536 #: ../src/guestfs-actions.pod:5941 ../src/guestfs-actions.pod:6048
9537 #: ../fish/guestfish-actions.pod:1350 ../fish/guestfish-actions.pod:1401
9538 #: ../fish/guestfish-actions.pod:4011 ../fish/guestfish-actions.pod:4098
9539 msgid ""
9540 "For more information on the architecture of libguestfs, see L<guestfs(3)>."
9541 msgstr ""
9542
9543 #. type: textblock
9544 #: ../src/guestfs-actions.pod:1990 ../src/guestfs-actions.pod:4393
9545 #: ../src/guestfs-actions.pod:4590 ../src/guestfs-actions.pod:4609
9546 #: ../src/guestfs-actions.pod:4628 ../src/guestfs-actions.pod:4640
9547 #: ../src/guestfs-actions.pod:4657 ../src/guestfs-actions.pod:4670
9548 #: ../src/guestfs-actions.pod:5564 ../src/guestfs-actions.pod:5946
9549 #: ../src/guestfs-actions.pod:6207 ../src/guestfs-actions.pod:6822
9550 msgid "(Added in 1.0.55)"
9551 msgstr ""
9552
9553 #. type: =head2
9554 #: ../src/guestfs-actions.pod:1992
9555 msgid "guestfs_get_network"
9556 msgstr ""
9557
9558 #. type: verbatim
9559 #: ../src/guestfs-actions.pod:1994
9560 #, no-wrap
9561 msgid ""
9562 " int\n"
9563 " guestfs_get_network (guestfs_h *g);\n"
9564 "\n"
9565 msgstr ""
9566
9567 #. type: textblock
9568 #: ../src/guestfs-actions.pod:1997 ../fish/guestfish-actions.pod:1357
9569 msgid "This returns the enable network flag."
9570 msgstr ""
9571
9572 #. type: textblock
9573 #: ../src/guestfs-actions.pod:2001 ../src/guestfs-actions.pod:5965
9574 msgid "(Added in 1.5.4)"
9575 msgstr ""
9576
9577 #. type: =head2
9578 #: ../src/guestfs-actions.pod:2003
9579 msgid "guestfs_get_path"
9580 msgstr ""
9581
9582 #. type: verbatim
9583 #: ../src/guestfs-actions.pod:2005
9584 #, no-wrap
9585 msgid ""
9586 " const char *\n"
9587 " guestfs_get_path (guestfs_h *g);\n"
9588 "\n"
9589 msgstr ""
9590
9591 #. type: textblock
9592 #: ../src/guestfs-actions.pod:2008 ../fish/guestfish-actions.pod:1363
9593 msgid "Return the current search path."
9594 msgstr ""
9595
9596 #. type: textblock
9597 #: ../src/guestfs-actions.pod:2010 ../fish/guestfish-actions.pod:1365
9598 msgid ""
9599 "This is always non-NULL.  If it wasn't set already, then this will return "
9600 "the default path."
9601 msgstr ""
9602
9603 #. type: textblock
9604 #: ../src/guestfs-actions.pod:2013 ../src/guestfs-actions.pod:2042
9605 msgid ""
9606 "This function returns a string, or NULL on error.  The string is owned by "
9607 "the guest handle and must I<not> be freed."
9608 msgstr ""
9609
9610 #. type: =head2
9611 #: ../src/guestfs-actions.pod:2018
9612 msgid "guestfs_get_pid"
9613 msgstr ""
9614
9615 #. type: verbatim
9616 #: ../src/guestfs-actions.pod:2020
9617 #, no-wrap
9618 msgid ""
9619 " int\n"
9620 " guestfs_get_pid (guestfs_h *g);\n"
9621 "\n"
9622 msgstr ""
9623
9624 #. type: textblock
9625 #: ../src/guestfs-actions.pod:2023 ../fish/guestfish-actions.pod:1374
9626 msgid ""
9627 "Return the process ID of the qemu subprocess.  If there is no qemu "
9628 "subprocess, then this will return an error."
9629 msgstr ""
9630
9631 #. type: textblock
9632 #: ../src/guestfs-actions.pod:2026 ../fish/guestfish-actions.pod:1377
9633 msgid "This is an internal call used for debugging and testing."
9634 msgstr ""
9635
9636 #. type: textblock
9637 #: ../src/guestfs-actions.pod:2030
9638 msgid "(Added in 1.0.56)"
9639 msgstr ""
9640
9641 #. type: =head2
9642 #: ../src/guestfs-actions.pod:2032
9643 msgid "guestfs_get_qemu"
9644 msgstr ""
9645
9646 #. type: verbatim
9647 #: ../src/guestfs-actions.pod:2034
9648 #, no-wrap
9649 msgid ""
9650 " const char *\n"
9651 " guestfs_get_qemu (guestfs_h *g);\n"
9652 "\n"
9653 msgstr ""
9654
9655 #. type: textblock
9656 #: ../src/guestfs-actions.pod:2037 ../fish/guestfish-actions.pod:1383
9657 msgid "Return the current qemu binary."
9658 msgstr ""
9659
9660 #. type: textblock
9661 #: ../src/guestfs-actions.pod:2039 ../fish/guestfish-actions.pod:1385
9662 msgid ""
9663 "This is always non-NULL.  If it wasn't set already, then this will return "
9664 "the default qemu binary name."
9665 msgstr ""
9666
9667 #. type: textblock
9668 #: ../src/guestfs-actions.pod:2045 ../src/guestfs-actions.pod:6010
9669 msgid "(Added in 1.0.6)"
9670 msgstr ""
9671
9672 #. type: =head2
9673 #: ../src/guestfs-actions.pod:2047
9674 msgid "guestfs_get_recovery_proc"
9675 msgstr ""
9676
9677 #. type: verbatim
9678 #: ../src/guestfs-actions.pod:2049
9679 #, no-wrap
9680 msgid ""
9681 " int\n"
9682 " guestfs_get_recovery_proc (guestfs_h *g);\n"
9683 "\n"
9684 msgstr ""
9685
9686 #. type: textblock
9687 #: ../src/guestfs-actions.pod:2052 ../fish/guestfish-actions.pod:1392
9688 msgid "Return the recovery process enabled flag."
9689 msgstr ""
9690
9691 #. type: textblock
9692 #: ../src/guestfs-actions.pod:2056 ../src/guestfs-actions.pod:3503
9693 #: ../src/guestfs-actions.pod:3800 ../src/guestfs-actions.pod:4200
9694 #: ../src/guestfs-actions.pod:4232 ../src/guestfs-actions.pod:5269
9695 #: ../src/guestfs-actions.pod:5612 ../src/guestfs-actions.pod:6034
9696 #: ../src/guestfs-actions.pod:6725 ../src/guestfs-actions.pod:6745
9697 #: ../src/guestfs-actions.pod:6937
9698 msgid "(Added in 1.0.77)"
9699 msgstr ""
9700
9701 #. type: =head2
9702 #: ../src/guestfs-actions.pod:2058
9703 msgid "guestfs_get_selinux"
9704 msgstr ""
9705
9706 #. type: verbatim
9707 #: ../src/guestfs-actions.pod:2060
9708 #, no-wrap
9709 msgid ""
9710 " int\n"
9711 " guestfs_get_selinux (guestfs_h *g);\n"
9712 "\n"
9713 msgstr ""
9714
9715 #. type: textblock
9716 #: ../src/guestfs-actions.pod:2063
9717 msgid ""
9718 "This returns the current setting of the selinux flag which is passed to the "
9719 "appliance at boot time.  See C<guestfs_set_selinux>."
9720 msgstr ""
9721
9722 #. type: textblock
9723 #: ../src/guestfs-actions.pod:2071 ../src/guestfs-actions.pod:2134
9724 #: ../src/guestfs-actions.pod:6053 ../src/guestfs-actions.pod:6111
9725 msgid "(Added in 1.0.67)"
9726 msgstr ""
9727
9728 #. type: =head2
9729 #: ../src/guestfs-actions.pod:2073
9730 msgid "guestfs_get_state"
9731 msgstr ""
9732
9733 #. type: verbatim
9734 #: ../src/guestfs-actions.pod:2075
9735 #, no-wrap
9736 msgid ""
9737 " int\n"
9738 " guestfs_get_state (guestfs_h *g);\n"
9739 "\n"
9740 msgstr ""
9741
9742 #. type: textblock
9743 #: ../src/guestfs-actions.pod:2078 ../fish/guestfish-actions.pod:1408
9744 msgid ""
9745 "This returns the current state as an opaque integer.  This is only useful "
9746 "for printing debug and internal error messages."
9747 msgstr ""
9748
9749 #. type: textblock
9750 #: ../src/guestfs-actions.pod:2081 ../src/guestfs-actions.pod:3301
9751 #: ../src/guestfs-actions.pod:3330 ../src/guestfs-actions.pod:3391
9752 #: ../src/guestfs-actions.pod:3418 ../fish/guestfish-actions.pod:1411
9753 #: ../fish/guestfish-actions.pod:2325 ../fish/guestfish-actions.pod:2343
9754 #: ../fish/guestfish-actions.pod:2381 ../fish/guestfish-actions.pod:2397
9755 msgid "For more information on states, see L<guestfs(3)>."
9756 msgstr ""
9757
9758 #. type: =head2
9759 #: ../src/guestfs-actions.pod:2087
9760 msgid "guestfs_get_trace"
9761 msgstr ""
9762
9763 #. type: verbatim
9764 #: ../src/guestfs-actions.pod:2089
9765 #, no-wrap
9766 msgid ""
9767 " int\n"
9768 " guestfs_get_trace (guestfs_h *g);\n"
9769 "\n"
9770 msgstr ""
9771
9772 #. type: textblock
9773 #: ../src/guestfs-actions.pod:2092 ../fish/guestfish-actions.pod:1417
9774 msgid "Return the command trace flag."
9775 msgstr ""
9776
9777 #. type: =head2
9778 #: ../src/guestfs-actions.pod:2098
9779 msgid "guestfs_get_umask"
9780 msgstr ""
9781
9782 #. type: verbatim
9783 #: ../src/guestfs-actions.pod:2100
9784 #, no-wrap
9785 msgid ""
9786 " int\n"
9787 " guestfs_get_umask (guestfs_h *g);\n"
9788 "\n"
9789 msgstr ""
9790
9791 #. type: textblock
9792 #: ../src/guestfs-actions.pod:2103
9793 msgid ""
9794 "Return the current umask.  By default the umask is C<022> unless it has been "
9795 "set by calling C<guestfs_umask>."
9796 msgstr ""
9797
9798 #. type: =head2
9799 #: ../src/guestfs-actions.pod:2110
9800 msgid "guestfs_get_verbose"
9801 msgstr ""
9802
9803 #. type: verbatim
9804 #: ../src/guestfs-actions.pod:2112
9805 #, no-wrap
9806 msgid ""
9807 " int\n"
9808 " guestfs_get_verbose (guestfs_h *g);\n"
9809 "\n"
9810 msgstr ""
9811
9812 #. type: textblock
9813 #: ../src/guestfs-actions.pod:2115 ../fish/guestfish-actions.pod:1430
9814 msgid "This returns the verbose messages flag."
9815 msgstr ""
9816
9817 #. type: =head2
9818 #: ../src/guestfs-actions.pod:2121
9819 msgid "guestfs_getcon"
9820 msgstr ""
9821
9822 #. type: verbatim
9823 #: ../src/guestfs-actions.pod:2123
9824 #, no-wrap
9825 msgid ""
9826 " char *\n"
9827 " guestfs_getcon (guestfs_h *g);\n"
9828 "\n"
9829 msgstr ""
9830
9831 #. type: textblock
9832 #: ../src/guestfs-actions.pod:2126 ../fish/guestfish-actions.pod:1436
9833 msgid "This gets the SELinux security context of the daemon."
9834 msgstr ""
9835
9836 #. type: textblock
9837 #: ../src/guestfs-actions.pod:2128
9838 msgid ""
9839 "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>"
9840 msgstr ""
9841
9842 #. type: =head2
9843 #: ../src/guestfs-actions.pod:2136
9844 msgid "guestfs_getxattr"
9845 msgstr ""
9846
9847 #. type: verbatim
9848 #: ../src/guestfs-actions.pod:2138
9849 #, no-wrap
9850 msgid ""
9851 " char *\n"
9852 " guestfs_getxattr (guestfs_h *g,\n"
9853 "                   const char *path,\n"
9854 "                   const char *name,\n"
9855 "                   size_t *size_r);\n"
9856 "\n"
9857 msgstr ""
9858
9859 #. type: textblock
9860 #: ../src/guestfs-actions.pod:2144
9861 msgid ""
9862 "Get a single extended attribute from file C<path> named C<name>.  This call "
9863 "follows symlinks.  If you want to lookup an extended attribute for the "
9864 "symlink itself, use C<guestfs_lgetxattr>."
9865 msgstr ""
9866
9867 #. type: textblock
9868 #: ../src/guestfs-actions.pod:2148 ../src/guestfs-actions.pod:3517
9869 msgid ""
9870 "Normally it is better to get all extended attributes from a file in one go "
9871 "by calling C<guestfs_getxattrs>.  However some Linux filesystem "
9872 "implementations are buggy and do not provide a way to list out attributes.  "
9873 "For these filesystems (notably ntfs-3g)  you have to know the names of the "
9874 "extended attributes you want in advance and call this function."
9875 msgstr ""
9876
9877 #. type: textblock
9878 #: ../src/guestfs-actions.pod:2155 ../src/guestfs-actions.pod:3524
9879 #: ../fish/guestfish-actions.pod:1456 ../fish/guestfish-actions.pod:2462
9880 msgid ""
9881 "Extended attribute values are blobs of binary data.  If there is no extended "
9882 "attribute named C<name>, this returns an error."
9883 msgstr ""
9884
9885 #. type: textblock
9886 #: ../src/guestfs-actions.pod:2158
9887 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>."
9888 msgstr ""
9889
9890 #. type: textblock
9891 #: ../src/guestfs-actions.pod:2160 ../src/guestfs-actions.pod:2351
9892 #: ../src/guestfs-actions.pod:3529 ../src/guestfs-actions.pod:5262
9893 #: ../src/guestfs-actions.pod:5288 ../src/guestfs-actions.pod:5469
9894 msgid ""
9895 "This function returns a buffer, or NULL on error.  The size of the returned "
9896 "buffer is written to C<*size_r>.  I<The caller must free the returned buffer "
9897 "after use>."
9898 msgstr ""
9899
9900 #. type: textblock
9901 #: ../src/guestfs-actions.pod:2164 ../src/guestfs-actions.pod:3533
9902 msgid "(Added in 1.7.24)"
9903 msgstr ""
9904
9905 #. type: =head2
9906 #: ../src/guestfs-actions.pod:2166
9907 msgid "guestfs_getxattrs"
9908 msgstr ""
9909
9910 #. type: verbatim
9911 #: ../src/guestfs-actions.pod:2168
9912 #, no-wrap
9913 msgid ""
9914 " struct guestfs_xattr_list *\n"
9915 " guestfs_getxattrs (guestfs_h *g,\n"
9916 "                    const char *path);\n"
9917 "\n"
9918 msgstr ""
9919
9920 #. type: textblock
9921 #: ../src/guestfs-actions.pod:2172 ../fish/guestfish-actions.pod:1465
9922 msgid ""
9923 "This call lists the extended attributes of the file or directory C<path>."
9924 msgstr ""
9925
9926 #. type: textblock
9927 #: ../src/guestfs-actions.pod:2175 ../fish/guestfish-actions.pod:1468
9928 msgid ""
9929 "At the system call level, this is a combination of the L<listxattr(2)> and "
9930 "L<getxattr(2)> calls."
9931 msgstr ""
9932
9933 #. type: textblock
9934 #: ../src/guestfs-actions.pod:2178
9935 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>."
9936 msgstr ""
9937
9938 #. type: textblock
9939 #: ../src/guestfs-actions.pod:2180 ../src/guestfs-actions.pod:3545
9940 #: ../src/guestfs-actions.pod:4196
9941 msgid ""
9942 "This function returns a C<struct guestfs_xattr_list *>, or NULL if there was "
9943 "an error.  I<The caller must call C<guestfs_free_xattr_list> after use>."
9944 msgstr ""
9945
9946 #. type: textblock
9947 #: ../src/guestfs-actions.pod:2184 ../src/guestfs-actions.pod:3549
9948 #: ../src/guestfs-actions.pod:3714 ../src/guestfs-actions.pod:3750
9949 #: ../src/guestfs-actions.pod:5642 ../src/guestfs-actions.pod:6130
9950 #: ../src/guestfs-actions.pod:7500
9951 msgid "(Added in 1.0.59)"
9952 msgstr ""
9953
9954 #. type: =head2
9955 #: ../src/guestfs-actions.pod:2186
9956 msgid "guestfs_glob_expand"
9957 msgstr ""
9958
9959 #. type: verbatim
9960 #: ../src/guestfs-actions.pod:2188
9961 #, no-wrap
9962 msgid ""
9963 " char **\n"
9964 " guestfs_glob_expand (guestfs_h *g,\n"
9965 "                      const char *pattern);\n"
9966 "\n"
9967 msgstr ""
9968
9969 #. type: textblock
9970 #: ../src/guestfs-actions.pod:2192 ../fish/guestfish-actions.pod:1477
9971 msgid ""
9972 "This command searches for all the pathnames matching C<pattern> according to "
9973 "the wildcard expansion rules used by the shell."
9974 msgstr ""
9975
9976 #. type: textblock
9977 #: ../src/guestfs-actions.pod:2196 ../fish/guestfish-actions.pod:1481
9978 msgid ""
9979 "If no paths match, then this returns an empty list (note: not an error)."
9980 msgstr ""
9981
9982 #. type: textblock
9983 #: ../src/guestfs-actions.pod:2199 ../fish/guestfish-actions.pod:1484
9984 msgid ""
9985 "It is just a wrapper around the C L<glob(3)> function with flags C<GLOB_MARK|"
9986 "GLOB_BRACE>.  See that manual page for more details."
9987 msgstr ""
9988
9989 #. type: textblock
9990 #: ../src/guestfs-actions.pod:2207 ../src/guestfs-actions.pod:6323
9991 #: ../src/guestfs-actions.pod:6340
9992 msgid "(Added in 1.0.50)"
9993 msgstr ""
9994
9995 #. type: =head2
9996 #: ../src/guestfs-actions.pod:2209
9997 msgid "guestfs_grep"
9998 msgstr ""
9999
10000 #. type: verbatim
10001 #: ../src/guestfs-actions.pod:2211
10002 #, no-wrap
10003 msgid ""
10004 " char **\n"
10005 " guestfs_grep (guestfs_h *g,\n"
10006 "               const char *regex,\n"
10007 "               const char *path);\n"
10008 "\n"
10009 msgstr ""
10010
10011 #. type: textblock
10012 #: ../src/guestfs-actions.pod:2216 ../fish/guestfish-actions.pod:1492
10013 msgid "This calls the external C<grep> program and returns the matching lines."
10014 msgstr ""
10015
10016 #. type: =head2
10017 #: ../src/guestfs-actions.pod:2228
10018 msgid "guestfs_grepi"
10019 msgstr ""
10020
10021 #. type: verbatim
10022 #: ../src/guestfs-actions.pod:2230
10023 #, no-wrap
10024 msgid ""
10025 " char **\n"
10026 " guestfs_grepi (guestfs_h *g,\n"
10027 "                const char *regex,\n"
10028 "                const char *path);\n"
10029 "\n"
10030 msgstr ""
10031
10032 #. type: textblock
10033 #: ../src/guestfs-actions.pod:2235 ../fish/guestfish-actions.pod:1502
10034 msgid ""
10035 "This calls the external C<grep -i> program and returns the matching lines."
10036 msgstr ""
10037
10038 #. type: =head2
10039 #: ../src/guestfs-actions.pod:2247
10040 msgid "guestfs_grub_install"
10041 msgstr ""
10042
10043 #. type: verbatim
10044 #: ../src/guestfs-actions.pod:2249
10045 #, no-wrap
10046 msgid ""
10047 " int\n"
10048 " guestfs_grub_install (guestfs_h *g,\n"
10049 "                       const char *root,\n"
10050 "                       const char *device);\n"
10051 "\n"
10052 msgstr ""
10053
10054 #. type: textblock
10055 #: ../src/guestfs-actions.pod:2254 ../fish/guestfish-actions.pod:1512
10056 msgid ""
10057 "This command installs GRUB (the Grand Unified Bootloader) on C<device>, with "
10058 "the root directory being C<root>."
10059 msgstr ""
10060
10061 #. type: textblock
10062 #: ../src/guestfs-actions.pod:2257 ../fish/guestfish-actions.pod:1515
10063 msgid ""
10064 "Note: If grub-install reports the error \"No suitable drive was found in the "
10065 "generated device map.\" it may be that you need to create a C</boot/grub/"
10066 "device.map> file first that contains the mapping between grub device names "
10067 "and Linux device names.  It is usually sufficient to create a file "
10068 "containing:"
10069 msgstr ""
10070
10071 #. type: verbatim
10072 #: ../src/guestfs-actions.pod:2264 ../fish/guestfish-actions.pod:1522
10073 #, no-wrap
10074 msgid ""
10075 " (hd0) /dev/vda\n"
10076 "\n"
10077 msgstr ""
10078
10079 #. type: textblock
10080 #: ../src/guestfs-actions.pod:2266 ../fish/guestfish-actions.pod:1524
10081 msgid "replacing C</dev/vda> with the name of the installation device."
10082 msgstr ""
10083
10084 #. type: textblock
10085 #: ../src/guestfs-actions.pod:2270
10086 msgid "(Added in 1.0.17)"
10087 msgstr ""
10088
10089 #. type: =head2
10090 #: ../src/guestfs-actions.pod:2272
10091 msgid "guestfs_head"
10092 msgstr ""
10093
10094 #. type: verbatim
10095 #: ../src/guestfs-actions.pod:2274
10096 #, no-wrap
10097 msgid ""
10098 " char **\n"
10099 " guestfs_head (guestfs_h *g,\n"
10100 "               const char *path);\n"
10101 "\n"
10102 msgstr ""
10103
10104 #. type: textblock
10105 #: ../src/guestfs-actions.pod:2278 ../fish/guestfish-actions.pod:1530
10106 msgid ""
10107 "This command returns up to the first 10 lines of a file as a list of strings."
10108 msgstr ""
10109
10110 #. type: =head2
10111 #: ../src/guestfs-actions.pod:2290
10112 msgid "guestfs_head_n"
10113 msgstr ""
10114
10115 #. type: verbatim
10116 #: ../src/guestfs-actions.pod:2292
10117 #, no-wrap
10118 msgid ""
10119 " char **\n"
10120 " guestfs_head_n (guestfs_h *g,\n"
10121 "                 int nrlines,\n"
10122 "                 const char *path);\n"
10123 "\n"
10124 msgstr ""
10125
10126 #. type: textblock
10127 #: ../src/guestfs-actions.pod:2297 ../fish/guestfish-actions.pod:1540
10128 msgid ""
10129 "If the parameter C<nrlines> is a positive number, this returns the first "
10130 "C<nrlines> lines of the file C<path>."
10131 msgstr ""
10132
10133 #. type: textblock
10134 #: ../src/guestfs-actions.pod:2300 ../fish/guestfish-actions.pod:1543
10135 msgid ""
10136 "If the parameter C<nrlines> is a negative number, this returns lines from "
10137 "the file C<path>, excluding the last C<nrlines> lines."
10138 msgstr ""
10139
10140 #. type: textblock
10141 #: ../src/guestfs-actions.pod:2303 ../src/guestfs-actions.pod:6620
10142 #: ../fish/guestfish-actions.pod:1546 ../fish/guestfish-actions.pod:4476
10143 msgid "If the parameter C<nrlines> is zero, this returns an empty list."
10144 msgstr ""
10145
10146 #. type: =head2
10147 #: ../src/guestfs-actions.pod:2314
10148 msgid "guestfs_hexdump"
10149 msgstr ""
10150
10151 #. type: verbatim
10152 #: ../src/guestfs-actions.pod:2316
10153 #, no-wrap
10154 msgid ""
10155 " char *\n"
10156 " guestfs_hexdump (guestfs_h *g,\n"
10157 "                  const char *path);\n"
10158 "\n"
10159 msgstr ""
10160
10161 #. type: textblock
10162 #: ../src/guestfs-actions.pod:2320 ../fish/guestfish-actions.pod:1555
10163 msgid ""
10164 "This runs C<hexdump -C> on the given C<path>.  The result is the human-"
10165 "readable, canonical hex dump of the file."
10166 msgstr ""
10167
10168 #. type: textblock
10169 #: ../src/guestfs-actions.pod:2329 ../src/guestfs-actions.pod:6404
10170 #: ../src/guestfs-actions.pod:6459
10171 msgid "(Added in 1.0.22)"
10172 msgstr ""
10173
10174 #. type: =head2
10175 #: ../src/guestfs-actions.pod:2331
10176 msgid "guestfs_initrd_cat"
10177 msgstr ""
10178
10179 #. type: verbatim
10180 #: ../src/guestfs-actions.pod:2333
10181 #, no-wrap
10182 msgid ""
10183 " char *\n"
10184 " guestfs_initrd_cat (guestfs_h *g,\n"
10185 "                     const char *initrdpath,\n"
10186 "                     const char *filename,\n"
10187 "                     size_t *size_r);\n"
10188 "\n"
10189 msgstr ""
10190
10191 #. type: textblock
10192 #: ../src/guestfs-actions.pod:2339 ../fish/guestfish-actions.pod:1565
10193 msgid ""
10194 "This command unpacks the file C<filename> from the initrd file called "
10195 "C<initrdpath>.  The filename must be given I<without> the initial C</> "
10196 "character."
10197 msgstr ""
10198
10199 #. type: textblock
10200 #: ../src/guestfs-actions.pod:2343 ../fish/guestfish-actions.pod:1569
10201 msgid ""
10202 "For example, in guestfish you could use the following command to examine the "
10203 "boot script (usually called C</init>)  contained in a Linux initrd or "
10204 "initramfs image:"
10205 msgstr ""
10206
10207 #. type: verbatim
10208 #: ../src/guestfs-actions.pod:2347 ../fish/guestfish-actions.pod:1573
10209 #, no-wrap
10210 msgid ""
10211 " initrd-cat /boot/initrd-<version>.img init\n"
10212 "\n"
10213 msgstr ""
10214
10215 #. type: textblock
10216 #: ../src/guestfs-actions.pod:2349
10217 msgid "See also C<guestfs_initrd_list>."
10218 msgstr ""
10219
10220 #. type: =head2
10221 #: ../src/guestfs-actions.pod:2360
10222 msgid "guestfs_initrd_list"
10223 msgstr ""
10224
10225 #. type: verbatim
10226 #: ../src/guestfs-actions.pod:2362
10227 #, no-wrap
10228 msgid ""
10229 " char **\n"
10230 " guestfs_initrd_list (guestfs_h *g,\n"
10231 "                      const char *path);\n"
10232 "\n"
10233 msgstr ""
10234
10235 #. type: textblock
10236 #: ../src/guestfs-actions.pod:2366 ../fish/guestfish-actions.pod:1584
10237 msgid "This command lists out files contained in an initrd."
10238 msgstr ""
10239
10240 #. type: textblock
10241 #: ../src/guestfs-actions.pod:2368 ../fish/guestfish-actions.pod:1586
10242 msgid ""
10243 "The files are listed without any initial C</> character.  The files are "
10244 "listed in the order they appear (not necessarily alphabetical).  Directory "
10245 "names are listed as separate items."
10246 msgstr ""
10247
10248 #. type: textblock
10249 #: ../src/guestfs-actions.pod:2372 ../fish/guestfish-actions.pod:1590
10250 msgid ""
10251 "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as "
10252 "initrd.  We I<only> support the newer initramfs format (compressed cpio "
10253 "files)."
10254 msgstr ""
10255
10256 #. type: =head2
10257 #: ../src/guestfs-actions.pod:2382
10258 msgid "guestfs_inotify_add_watch"
10259 msgstr ""
10260
10261 #. type: verbatim
10262 #: ../src/guestfs-actions.pod:2384
10263 #, no-wrap
10264 msgid ""
10265 " int64_t\n"
10266 " guestfs_inotify_add_watch (guestfs_h *g,\n"
10267 "                            const char *path,\n"
10268 "                            int mask);\n"
10269 "\n"
10270 msgstr ""
10271
10272 #. type: textblock
10273 #: ../src/guestfs-actions.pod:2389 ../fish/guestfish-actions.pod:1598
10274 msgid "Watch C<path> for the events listed in C<mask>."
10275 msgstr ""
10276
10277 #. type: textblock
10278 #: ../src/guestfs-actions.pod:2391 ../fish/guestfish-actions.pod:1600
10279 msgid ""
10280 "Note that if C<path> is a directory then events within that directory are "
10281 "watched, but this does I<not> happen recursively (in subdirectories)."
10282 msgstr ""
10283
10284 #. type: textblock
10285 #: ../src/guestfs-actions.pod:2395 ../fish/guestfish-actions.pod:1604
10286 msgid ""
10287 "Note for non-C or non-Linux callers: the inotify events are defined by the "
10288 "Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>."
10289 msgstr ""
10290
10291 #. type: =head2
10292 #: ../src/guestfs-actions.pod:2403
10293 msgid "guestfs_inotify_close"
10294 msgstr ""
10295
10296 #. type: verbatim
10297 #: ../src/guestfs-actions.pod:2405
10298 #, no-wrap
10299 msgid ""
10300 " int\n"
10301 " guestfs_inotify_close (guestfs_h *g);\n"
10302 "\n"
10303 msgstr ""
10304
10305 #. type: textblock
10306 #: ../src/guestfs-actions.pod:2408 ../fish/guestfish-actions.pod:1612
10307 msgid ""
10308 "This closes the inotify handle which was previously opened by inotify_init.  "
10309 "It removes all watches, throws away any pending events, and deallocates all "
10310 "resources."
10311 msgstr ""
10312
10313 #. type: =head2
10314 #: ../src/guestfs-actions.pod:2416
10315 msgid "guestfs_inotify_files"
10316 msgstr ""
10317
10318 #. type: verbatim
10319 #: ../src/guestfs-actions.pod:2418
10320 #, no-wrap
10321 msgid ""
10322 " char **\n"
10323 " guestfs_inotify_files (guestfs_h *g);\n"
10324 "\n"
10325 msgstr ""
10326
10327 #. type: textblock
10328 #: ../src/guestfs-actions.pod:2421
10329 msgid ""
10330 "This function is a helpful wrapper around C<guestfs_inotify_read> which just "
10331 "returns a list of pathnames of objects that were touched.  The returned "
10332 "pathnames are sorted and deduplicated."
10333 msgstr ""
10334
10335 #. type: =head2
10336 #: ../src/guestfs-actions.pod:2431
10337 msgid "guestfs_inotify_init"
10338 msgstr ""
10339
10340 #. type: verbatim
10341 #: ../src/guestfs-actions.pod:2433
10342 #, no-wrap
10343 msgid ""
10344 " int\n"
10345 " guestfs_inotify_init (guestfs_h *g,\n"
10346 "                       int maxevents);\n"
10347 "\n"
10348 msgstr ""
10349
10350 #. type: textblock
10351 #: ../src/guestfs-actions.pod:2437 ../fish/guestfish-actions.pod:1628
10352 msgid ""
10353 "This command creates a new inotify handle.  The inotify subsystem can be "
10354 "used to notify events which happen to objects in the guest filesystem."
10355 msgstr ""
10356
10357 #. type: textblock
10358 #: ../src/guestfs-actions.pod:2441
10359 msgid ""
10360 "C<maxevents> is the maximum number of events which will be queued up between "
10361 "calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>.  If this is "
10362 "passed as C<0>, then the kernel (or previously set)  default is used.  For "
10363 "Linux 2.6.29 the default was 16384 events.  Beyond this limit, the kernel "
10364 "throws away events, but records the fact that it threw them away by setting "
10365 "a flag C<IN_Q_OVERFLOW> in the returned structure list (see "
10366 "C<guestfs_inotify_read>)."
10367 msgstr ""
10368
10369 #. type: textblock
10370 #: ../src/guestfs-actions.pod:2451
10371 msgid ""
10372 "Before any events are generated, you have to add some watches to the "
10373 "internal watch list.  See: C<guestfs_inotify_add_watch>, "
10374 "C<guestfs_inotify_rm_watch> and C<guestfs_inotify_watch_all>."
10375 msgstr ""
10376
10377 #. type: textblock
10378 #: ../src/guestfs-actions.pod:2457
10379 msgid ""
10380 "Queued up events should be read periodically by calling "
10381 "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful "
10382 "wrapper around C<guestfs_inotify_read>).  If you don't read the events out "
10383 "often enough then you risk the internal queue overflowing."
10384 msgstr ""
10385
10386 #. type: textblock
10387 #: ../src/guestfs-actions.pod:2464
10388 msgid ""
10389 "The handle should be closed after use by calling C<guestfs_inotify_close>.  "
10390 "This also removes any watches automatically."
10391 msgstr ""
10392
10393 #. type: textblock
10394 #: ../src/guestfs-actions.pod:2468 ../fish/guestfish-actions.pod:1659
10395 msgid ""
10396 "See also L<inotify(7)> for an overview of the inotify interface as exposed "
10397 "by the Linux kernel, which is roughly what we expose via libguestfs.  Note "
10398 "that there is one global inotify handle per libguestfs instance."
10399 msgstr ""
10400
10401 #. type: =head2
10402 #: ../src/guestfs-actions.pod:2477
10403 msgid "guestfs_inotify_read"
10404 msgstr ""
10405
10406 #. type: verbatim
10407 #: ../src/guestfs-actions.pod:2479
10408 #, no-wrap
10409 msgid ""
10410 " struct guestfs_inotify_event_list *\n"
10411 " guestfs_inotify_read (guestfs_h *g);\n"
10412 "\n"
10413 msgstr ""
10414
10415 #. type: textblock
10416 #: ../src/guestfs-actions.pod:2482 ../fish/guestfish-actions.pod:1668
10417 msgid ""
10418 "Return the complete queue of events that have happened since the previous "
10419 "read call."
10420 msgstr ""
10421
10422 #. type: textblock
10423 #: ../src/guestfs-actions.pod:2485 ../fish/guestfish-actions.pod:1671
10424 msgid "If no events have happened, this returns an empty list."
10425 msgstr ""
10426
10427 #. type: textblock
10428 #: ../src/guestfs-actions.pod:2487 ../fish/guestfish-actions.pod:1673
10429 msgid ""
10430 "I<Note>: In order to make sure that all events have been read, you must call "
10431 "this function repeatedly until it returns an empty list.  The reason is that "
10432 "the call will read events up to the maximum appliance-to-host message size "
10433 "and leave remaining events in the queue."
10434 msgstr ""
10435
10436 #. type: textblock
10437 #: ../src/guestfs-actions.pod:2493
10438 msgid ""
10439 "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if "
10440 "there was an error.  I<The caller must call "
10441 "C<guestfs_free_inotify_event_list> after use>."
10442 msgstr ""
10443
10444 #. type: =head2
10445 #: ../src/guestfs-actions.pod:2499
10446 msgid "guestfs_inotify_rm_watch"
10447 msgstr ""
10448
10449 #. type: verbatim
10450 #: ../src/guestfs-actions.pod:2501
10451 #, no-wrap
10452 msgid ""
10453 " int\n"
10454 " guestfs_inotify_rm_watch (guestfs_h *g,\n"
10455 "                           int wd);\n"
10456 "\n"
10457 msgstr ""
10458
10459 #. type: textblock
10460 #: ../src/guestfs-actions.pod:2505
10461 msgid ""
10462 "Remove a previously defined inotify watch.  See C<guestfs_inotify_add_watch>."
10463 msgstr ""
10464
10465 #. type: =head2
10466 #: ../src/guestfs-actions.pod:2512
10467 msgid "guestfs_inspect_get_arch"
10468 msgstr ""
10469
10470 #. type: verbatim
10471 #: ../src/guestfs-actions.pod:2514
10472 #, no-wrap
10473 msgid ""
10474 " char *\n"
10475 " guestfs_inspect_get_arch (guestfs_h *g,\n"
10476 "                           const char *root);\n"
10477 "\n"
10478 msgstr ""
10479
10480 #. type: textblock
10481 #: ../src/guestfs-actions.pod:2518 ../src/guestfs-actions.pod:2541
10482 #: ../src/guestfs-actions.pod:2634 ../src/guestfs-actions.pod:2678
10483 #: ../src/guestfs-actions.pod:2704 ../src/guestfs-actions.pod:2743
10484 #: ../src/guestfs-actions.pod:2765 ../src/guestfs-actions.pod:2792
10485 #: ../src/guestfs-actions.pod:2813 ../src/guestfs-actions.pod:2856
10486 #: ../src/guestfs-actions.pod:2885 ../src/guestfs-actions.pod:2916
10487 #: ../src/guestfs-actions.pod:2940 ../src/guestfs-actions.pod:2995
10488 #: ../src/guestfs-actions.pod:3037 ../src/guestfs-actions.pod:3058
10489 #: ../src/guestfs-actions.pod:3081 ../src/guestfs-actions.pod:3098
10490 #: ../src/guestfs-actions.pod:3115 ../src/guestfs-actions.pod:3134
10491 msgid ""
10492 "This function should only be called with a root device string as returned by "
10493 "C<guestfs_inspect_os>."
10494 msgstr ""
10495
10496 #. type: textblock
10497 #: ../src/guestfs-actions.pod:2521
10498 msgid ""
10499 "This returns the architecture of the inspected operating system.  The "
10500 "possible return values are listed under C<guestfs_file_architecture>."
10501 msgstr ""
10502
10503 #. type: textblock
10504 #: ../src/guestfs-actions.pod:2525 ../fish/guestfish-actions.pod:1697
10505 msgid ""
10506 "If the architecture could not be determined, then the string C<unknown> is "
10507 "returned."
10508 msgstr ""
10509
10510 #. type: textblock
10511 #: ../src/guestfs-actions.pod:2528 ../src/guestfs-actions.pod:2621
10512 #: ../src/guestfs-actions.pod:2732 ../src/guestfs-actions.pod:2752
10513 #: ../src/guestfs-actions.pod:2780 ../src/guestfs-actions.pod:2872
10514 #: ../src/guestfs-actions.pod:2903 ../src/guestfs-actions.pod:2927
10515 #: ../src/guestfs-actions.pod:2981 ../src/guestfs-actions.pod:3024
10516 #: ../src/guestfs-actions.pod:3047 ../src/guestfs-actions.pod:3068
10517 #: ../src/guestfs-actions.pod:3088 ../src/guestfs-actions.pod:3105
10518 #: ../src/guestfs-actions.pod:3124 ../src/guestfs-actions.pod:3227
10519 #: ../src/guestfs-actions.pod:3268 ../fish/guestfish-actions.pod:1700
10520 #: ../fish/guestfish-actions.pod:1786 ../fish/guestfish-actions.pod:1874
10521 #: ../fish/guestfish-actions.pod:1889 ../fish/guestfish-actions.pod:1910
10522 #: ../fish/guestfish-actions.pod:1980 ../fish/guestfish-actions.pod:2004
10523 #: ../fish/guestfish-actions.pod:2021 ../fish/guestfish-actions.pod:2064
10524 #: ../fish/guestfish-actions.pod:2099 ../fish/guestfish-actions.pod:2115
10525 #: ../fish/guestfish-actions.pod:2131 ../fish/guestfish-actions.pod:2144
10526 #: ../fish/guestfish-actions.pod:2157 ../fish/guestfish-actions.pod:2172
10527 #: ../fish/guestfish-actions.pod:2271 ../fish/guestfish-actions.pod:2305
10528 msgid "Please read L<guestfs(3)/INSPECTION> for more details."
10529 msgstr ""
10530
10531 #. type: =head2
10532 #: ../src/guestfs-actions.pod:2535
10533 msgid "guestfs_inspect_get_distro"
10534 msgstr ""
10535
10536 #. type: verbatim
10537 #: ../src/guestfs-actions.pod:2537
10538 #, no-wrap
10539 msgid ""
10540 " char *\n"
10541 " guestfs_inspect_get_distro (guestfs_h *g,\n"
10542 "                             const char *root);\n"
10543 "\n"
10544 msgstr ""
10545
10546 #. type: textblock
10547 #: ../src/guestfs-actions.pod:2544 ../fish/guestfish-actions.pod:1709
10548 msgid ""
10549 "This returns the distro (distribution) of the inspected operating system."
10550 msgstr ""
10551
10552 #. type: textblock
10553 #: ../src/guestfs-actions.pod:2547 ../fish/guestfish-actions.pod:1712
10554 msgid "Currently defined distros are:"
10555 msgstr ""
10556
10557 #. type: =item
10558 #: ../src/guestfs-actions.pod:2551 ../fish/guestfish-actions.pod:1716
10559 msgid "\"archlinux\""
10560 msgstr "\"archlinux\""
10561
10562 #. type: textblock
10563 #: ../src/guestfs-actions.pod:2553 ../fish/guestfish-actions.pod:1718
10564 msgid "Arch Linux."
10565 msgstr "Arch Linux."
10566
10567 #. type: =item
10568 #: ../src/guestfs-actions.pod:2555 ../fish/guestfish-actions.pod:1720
10569 #, fuzzy
10570 #| msgid "\"gentoo\""
10571 msgid "\"centos\""
10572 msgstr "\"gentoo\""
10573
10574 #. type: textblock
10575 #: ../src/guestfs-actions.pod:2557 ../fish/guestfish-actions.pod:1722
10576 msgid "CentOS."
10577 msgstr ""
10578
10579 #. type: =item
10580 #: ../src/guestfs-actions.pod:2559 ../fish/guestfish-actions.pod:1724
10581 msgid "\"debian\""
10582 msgstr "\"debian\""
10583
10584 #. type: textblock
10585 #: ../src/guestfs-actions.pod:2561 ../fish/guestfish-actions.pod:1726
10586 msgid "Debian."
10587 msgstr "Debian."
10588
10589 #. type: =item
10590 #: ../src/guestfs-actions.pod:2563 ../fish/guestfish-actions.pod:1728
10591 msgid "\"fedora\""
10592 msgstr "\"fedora\""
10593
10594 #. type: textblock
10595 #: ../src/guestfs-actions.pod:2565 ../fish/guestfish-actions.pod:1730
10596 msgid "Fedora."
10597 msgstr "Fedora."
10598
10599 #. type: =item
10600 #: ../src/guestfs-actions.pod:2567 ../fish/guestfish-actions.pod:1732
10601 msgid "\"gentoo\""
10602 msgstr "\"gentoo\""
10603
10604 #. type: textblock
10605 #: ../src/guestfs-actions.pod:2569 ../fish/guestfish-actions.pod:1734
10606 msgid "Gentoo."
10607 msgstr "Gentoo."
10608
10609 #. type: =item
10610 #: ../src/guestfs-actions.pod:2571 ../fish/guestfish-actions.pod:1736
10611 msgid "\"linuxmint\""
10612 msgstr "\"linuxmint\""
10613
10614 #. type: textblock
10615 #: ../src/guestfs-actions.pod:2573 ../fish/guestfish-actions.pod:1738
10616 msgid "Linux Mint."
10617 msgstr "Linux Mint."
10618
10619 #. type: =item
10620 #: ../src/guestfs-actions.pod:2575 ../fish/guestfish-actions.pod:1740
10621 msgid "\"mandriva\""
10622 msgstr "\"mandriva\""
10623
10624 #. type: textblock
10625 #: ../src/guestfs-actions.pod:2577 ../fish/guestfish-actions.pod:1742
10626 msgid "Mandriva."
10627 msgstr "Mandriva."
10628
10629 #. type: =item
10630 #: ../src/guestfs-actions.pod:2579 ../fish/guestfish-actions.pod:1744
10631 msgid "\"meego\""
10632 msgstr "\"meego\""
10633
10634 #. type: textblock
10635 #: ../src/guestfs-actions.pod:2581 ../fish/guestfish-actions.pod:1746
10636 msgid "MeeGo."
10637 msgstr "MeeGo."
10638
10639 #. type: =item
10640 #: ../src/guestfs-actions.pod:2583 ../fish/guestfish-actions.pod:1748
10641 msgid "\"pardus\""
10642 msgstr "\"pardus\""
10643
10644 #. type: textblock
10645 #: ../src/guestfs-actions.pod:2585 ../fish/guestfish-actions.pod:1750
10646 msgid "Pardus."
10647 msgstr "Pardus."
10648
10649 #. type: =item
10650 #: ../src/guestfs-actions.pod:2587 ../fish/guestfish-actions.pod:1752
10651 msgid "\"redhat-based\""
10652 msgstr "\"redhat-based\""
10653
10654 #. type: textblock
10655 #: ../src/guestfs-actions.pod:2589 ../fish/guestfish-actions.pod:1754
10656 msgid "Some Red Hat-derived distro."
10657 msgstr "Дистрибутив, що походить від Red Hat."
10658
10659 #. type: =item
10660 #: ../src/guestfs-actions.pod:2591 ../fish/guestfish-actions.pod:1756
10661 msgid "\"rhel\""
10662 msgstr "\"rhel\""
10663
10664 #. type: textblock
10665 #: ../src/guestfs-actions.pod:2593 ../fish/guestfish-actions.pod:1758
10666 #, fuzzy
10667 #| msgid "Red Hat Enterprise Linux and some derivatives."
10668 msgid "Red Hat Enterprise Linux."
10669 msgstr "Red Hat Enterprise Linux та деякі з похідних дистрибутивів."
10670
10671 #. type: =item
10672 #: ../src/guestfs-actions.pod:2595 ../fish/guestfish-actions.pod:1760
10673 msgid "\"scientificlinux\""
10674 msgstr ""
10675
10676 #. type: textblock
10677 #: ../src/guestfs-actions.pod:2597 ../fish/guestfish-actions.pod:1762
10678 msgid "Scientific Linux."
10679 msgstr ""
10680
10681 #. type: =item
10682 #: ../src/guestfs-actions.pod:2599 ../fish/guestfish-actions.pod:1764
10683 msgid "\"slackware\""
10684 msgstr ""
10685
10686 #. type: textblock
10687 #: ../src/guestfs-actions.pod:2601 ../fish/guestfish-actions.pod:1766
10688 msgid "Slackware."
10689 msgstr ""
10690
10691 #. type: =item
10692 #: ../src/guestfs-actions.pod:2603 ../fish/guestfish-actions.pod:1768
10693 msgid "\"ubuntu\""
10694 msgstr "\"ubuntu\""
10695
10696 #. type: textblock
10697 #: ../src/guestfs-actions.pod:2605 ../fish/guestfish-actions.pod:1770
10698 msgid "Ubuntu."
10699 msgstr "Ubuntu."
10700
10701 #. type: =item
10702 #: ../src/guestfs-actions.pod:2607 ../src/guestfs-actions.pod:2723
10703 #: ../src/guestfs-actions.pod:3015 ../fish/guestfish-actions.pod:1772
10704 #: ../fish/guestfish-actions.pod:1865 ../fish/guestfish-actions.pod:2090
10705 msgid "\"unknown\""
10706 msgstr "\"unknown\""
10707
10708 #. type: textblock
10709 #: ../src/guestfs-actions.pod:2609 ../fish/guestfish-actions.pod:1774
10710 msgid "The distro could not be determined."
10711 msgstr "Дистрибутив, тип якого не вдалося визначити."
10712
10713 #. type: =item
10714 #: ../src/guestfs-actions.pod:2611 ../src/guestfs-actions.pod:3007
10715 #: ../fish/guestfish-actions.pod:1776 ../fish/guestfish-actions.pod:2082
10716 msgid "\"windows\""
10717 msgstr "\"windows\""
10718
10719 #. type: textblock
10720 #: ../src/guestfs-actions.pod:2613 ../fish/guestfish-actions.pod:1778
10721 msgid ""
10722 "Windows does not have distributions.  This string is returned if the OS type "
10723 "is Windows."
10724 msgstr ""
10725
10726 #. type: textblock
10727 #: ../src/guestfs-actions.pod:2618 ../src/guestfs-actions.pod:2729
10728 #: ../src/guestfs-actions.pod:3021 ../fish/guestfish-actions.pod:1783
10729 #: ../fish/guestfish-actions.pod:1871 ../fish/guestfish-actions.pod:2096
10730 msgid ""
10731 "Future versions of libguestfs may return other strings here.  The caller "
10732 "should be prepared to handle any string."
10733 msgstr ""
10734
10735 #. type: =head2
10736 #: ../src/guestfs-actions.pod:2628
10737 msgid "guestfs_inspect_get_drive_mappings"
10738 msgstr ""
10739
10740 #. type: verbatim
10741 #: ../src/guestfs-actions.pod:2630
10742 #, no-wrap
10743 msgid ""
10744 " char **\n"
10745 " guestfs_inspect_get_drive_mappings (guestfs_h *g,\n"
10746 "                                     const char *root);\n"
10747 "\n"
10748 msgstr ""
10749
10750 #. type: textblock
10751 #: ../src/guestfs-actions.pod:2637 ../fish/guestfish-actions.pod:1795
10752 msgid ""
10753 "This call is useful for Windows which uses a primitive system of assigning "
10754 "drive letters (like \"C:\") to partitions.  This inspection API examines the "
10755 "Windows Registry to find out how disks/partitions are mapped to drive "
10756 "letters, and returns a hash table as in the example below:"
10757 msgstr ""
10758
10759 #. type: verbatim
10760 #: ../src/guestfs-actions.pod:2643 ../fish/guestfish-actions.pod:1801
10761 #, no-wrap
10762 msgid ""
10763 " C      =>     /dev/vda2\n"
10764 " E      =>     /dev/vdb1\n"
10765 " F      =>     /dev/vdc1\n"
10766 "\n"
10767 msgstr ""
10768
10769 #. type: textblock
10770 #: ../src/guestfs-actions.pod:2647 ../fish/guestfish-actions.pod:1805
10771 msgid ""
10772 "Note that keys are drive letters.  For Windows, the key is case insensitive "
10773 "and just contains the drive letter, without the customary colon separator "
10774 "character."
10775 msgstr ""
10776
10777 #. type: textblock
10778 #: ../src/guestfs-actions.pod:2651 ../fish/guestfish-actions.pod:1809
10779 msgid ""
10780 "In future we may support other operating systems that also used drive "
10781 "letters, but the keys for those might not be case insensitive and might be "
10782 "longer than 1 character.  For example in OS-9, hard drives were named C<h0>, "
10783 "C<h1> etc."
10784 msgstr ""
10785
10786 #. type: textblock
10787 #: ../src/guestfs-actions.pod:2656 ../fish/guestfish-actions.pod:1814
10788 msgid ""
10789 "For Windows guests, currently only hard drive mappings are returned.  "
10790 "Removable disks (eg. DVD-ROMs) are ignored."
10791 msgstr ""
10792
10793 #. type: textblock
10794 #: ../src/guestfs-actions.pod:2659 ../fish/guestfish-actions.pod:1817
10795 msgid ""
10796 "For guests that do not use drive mappings, or if the drive mappings could "
10797 "not be determined, this returns an empty hash table."
10798 msgstr ""
10799
10800 #. type: textblock
10801 #: ../src/guestfs-actions.pod:2662
10802 msgid ""
10803 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
10804 "C<guestfs_inspect_get_mountpoints>, C<guestfs_inspect_get_filesystems>."
10805 msgstr ""
10806
10807 #. type: textblock
10808 #: ../src/guestfs-actions.pod:2666 ../src/guestfs-actions.pod:2842
10809 #: ../src/guestfs-actions.pod:3602 ../src/guestfs-actions.pod:4819
10810 #: ../src/guestfs-actions.pod:6761
10811 msgid ""
10812 "This function returns a NULL-terminated array of strings, or NULL if there "
10813 "was an error.  The array of strings will always have length C<2n+1>, where "
10814 "C<n> keys and values alternate, followed by the trailing NULL entry.  I<The "
10815 "caller must free the strings and the array after use>."
10816 msgstr ""
10817
10818 #. type: =head2
10819 #: ../src/guestfs-actions.pod:2672
10820 msgid "guestfs_inspect_get_filesystems"
10821 msgstr ""
10822
10823 #. type: verbatim
10824 #: ../src/guestfs-actions.pod:2674
10825 #, no-wrap
10826 msgid ""
10827 " char **\n"
10828 " guestfs_inspect_get_filesystems (guestfs_h *g,\n"
10829 "                                  const char *root);\n"
10830 "\n"
10831 msgstr ""
10832
10833 #. type: textblock
10834 #: ../src/guestfs-actions.pod:2681 ../fish/guestfish-actions.pod:1831
10835 msgid ""
10836 "This returns a list of all the filesystems that we think are associated with "
10837 "this operating system.  This includes the root filesystem, other ordinary "
10838 "filesystems, and non-mounted devices like swap partitions."
10839 msgstr ""
10840
10841 #. type: textblock
10842 #: ../src/guestfs-actions.pod:2686 ../fish/guestfish-actions.pod:1836
10843 msgid ""
10844 "In the case of a multi-boot virtual machine, it is possible for a filesystem "
10845 "to be shared between operating systems."
10846 msgstr ""
10847
10848 #. type: textblock
10849 #: ../src/guestfs-actions.pod:2689
10850 msgid ""
10851 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
10852 "C<guestfs_inspect_get_mountpoints>."
10853 msgstr ""
10854
10855 #. type: =head2
10856 #: ../src/guestfs-actions.pod:2698
10857 msgid "guestfs_inspect_get_format"
10858 msgstr ""
10859
10860 #. type: verbatim
10861 #: ../src/guestfs-actions.pod:2700
10862 #, no-wrap
10863 msgid ""
10864 " char *\n"
10865 " guestfs_inspect_get_format (guestfs_h *g,\n"
10866 "                             const char *root);\n"
10867 "\n"
10868 msgstr ""
10869
10870 #. type: textblock
10871 #: ../src/guestfs-actions.pod:2707 ../fish/guestfish-actions.pod:1849
10872 msgid ""
10873 "This returns the format of the inspected operating system.  You can use it "
10874 "to detect install images, live CDs and similar."
10875 msgstr ""
10876
10877 #. type: textblock
10878 #: ../src/guestfs-actions.pod:2710 ../fish/guestfish-actions.pod:1852
10879 msgid "Currently defined formats are:"
10880 msgstr ""
10881
10882 #. type: =item
10883 #: ../src/guestfs-actions.pod:2714 ../fish/guestfish-actions.pod:1856
10884 msgid "\"installed\""
10885 msgstr "\"installed\""
10886
10887 #. type: textblock
10888 #: ../src/guestfs-actions.pod:2716 ../fish/guestfish-actions.pod:1858
10889 msgid "This is an installed operating system."
10890 msgstr "Це встановлена операційна система."
10891
10892 #. type: =item
10893 #: ../src/guestfs-actions.pod:2718 ../fish/guestfish-actions.pod:1860
10894 msgid "\"installer\""
10895 msgstr ""
10896
10897 #. type: textblock
10898 #: ../src/guestfs-actions.pod:2720 ../fish/guestfish-actions.pod:1862
10899 msgid ""
10900 "The disk image being inspected is not an installed operating system, but a "
10901 "I<bootable> install disk, live CD, or similar."
10902 msgstr ""
10903
10904 #. type: textblock
10905 #: ../src/guestfs-actions.pod:2725 ../fish/guestfish-actions.pod:1867
10906 msgid "The format of this disk image is not known."
10907 msgstr ""
10908
10909 #. type: =head2
10910 #: ../src/guestfs-actions.pod:2737
10911 msgid "guestfs_inspect_get_hostname"
10912 msgstr ""
10913
10914 #. type: verbatim
10915 #: ../src/guestfs-actions.pod:2739
10916 #, no-wrap
10917 msgid ""
10918 " char *\n"
10919 " guestfs_inspect_get_hostname (guestfs_h *g,\n"
10920 "                               const char *root);\n"
10921 "\n"
10922 msgstr ""
10923
10924 #. type: textblock
10925 #: ../src/guestfs-actions.pod:2746 ../fish/guestfish-actions.pod:1883
10926 msgid ""
10927 "This function returns the hostname of the operating system as found by "
10928 "inspection of the guest's configuration files."
10929 msgstr ""
10930
10931 #. type: textblock
10932 #: ../src/guestfs-actions.pod:2749 ../fish/guestfish-actions.pod:1886
10933 msgid ""
10934 "If the hostname could not be determined, then the string C<unknown> is "
10935 "returned."
10936 msgstr ""
10937
10938 #. type: textblock
10939 #: ../src/guestfs-actions.pod:2757
10940 msgid "(Added in 1.7.9)"
10941 msgstr ""
10942
10943 #. type: =head2
10944 #: ../src/guestfs-actions.pod:2759
10945 msgid "guestfs_inspect_get_major_version"
10946 msgstr ""
10947
10948 #. type: verbatim
10949 #: ../src/guestfs-actions.pod:2761
10950 #, no-wrap
10951 msgid ""
10952 " int\n"
10953 " guestfs_inspect_get_major_version (guestfs_h *g,\n"
10954 "                                    const char *root);\n"
10955 "\n"
10956 msgstr ""
10957
10958 #. type: textblock
10959 #: ../src/guestfs-actions.pod:2768 ../fish/guestfish-actions.pod:1898
10960 msgid ""
10961 "This returns the major version number of the inspected operating system."
10962 msgstr ""
10963
10964 #. type: textblock
10965 #: ../src/guestfs-actions.pod:2771 ../fish/guestfish-actions.pod:1901
10966 msgid ""
10967 "Windows uses a consistent versioning scheme which is I<not> reflected in the "
10968 "popular public names used by the operating system.  Notably the operating "
10969 "system known as \"Windows 7\" is really version 6.1 (ie. major = 6, minor = "
10970 "1).  You can find out the real versions corresponding to releases of Windows "
10971 "by consulting Wikipedia or MSDN."
10972 msgstr ""
10973
10974 #. type: textblock
10975 #: ../src/guestfs-actions.pod:2778 ../src/guestfs-actions.pod:2798
10976 #: ../fish/guestfish-actions.pod:1908 ../fish/guestfish-actions.pod:1922
10977 msgid "If the version could not be determined, then C<0> is returned."
10978 msgstr ""
10979
10980 #. type: =head2
10981 #: ../src/guestfs-actions.pod:2786
10982 msgid "guestfs_inspect_get_minor_version"
10983 msgstr ""
10984
10985 #. type: verbatim
10986 #: ../src/guestfs-actions.pod:2788
10987 #, no-wrap
10988 msgid ""
10989 " int\n"
10990 " guestfs_inspect_get_minor_version (guestfs_h *g,\n"
10991 "                                    const char *root);\n"
10992 "\n"
10993 msgstr ""
10994
10995 #. type: textblock
10996 #: ../src/guestfs-actions.pod:2795 ../fish/guestfish-actions.pod:1919
10997 msgid ""
10998 "This returns the minor version number of the inspected operating system."
10999 msgstr ""
11000
11001 #. type: textblock
11002 #: ../src/guestfs-actions.pod:2800
11003 msgid ""
11004 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11005 "C<guestfs_inspect_get_major_version>."
11006 msgstr ""
11007
11008 #. type: =head2
11009 #: ../src/guestfs-actions.pod:2807
11010 msgid "guestfs_inspect_get_mountpoints"
11011 msgstr ""
11012
11013 #. type: verbatim
11014 #: ../src/guestfs-actions.pod:2809
11015 #, no-wrap
11016 msgid ""
11017 " char **\n"
11018 " guestfs_inspect_get_mountpoints (guestfs_h *g,\n"
11019 "                                  const char *root);\n"
11020 "\n"
11021 msgstr ""
11022
11023 #. type: textblock
11024 #: ../src/guestfs-actions.pod:2816 ../fish/guestfish-actions.pod:1934
11025 msgid ""
11026 "This returns a hash of where we think the filesystems associated with this "
11027 "operating system should be mounted.  Callers should note that this is at "
11028 "best an educated guess made by reading configuration files such as C</etc/"
11029 "fstab>.  I<In particular note> that this may return filesystems which are "
11030 "non-existent or not mountable and callers should be prepared to handle or "
11031 "ignore failures if they try to mount them."
11032 msgstr ""
11033
11034 #. type: textblock
11035 #: ../src/guestfs-actions.pod:2825 ../fish/guestfish-actions.pod:1943
11036 msgid ""
11037 "Each element in the returned hashtable has a key which is the path of the "
11038 "mountpoint (eg. C</boot>) and a value which is the filesystem that would be "
11039 "mounted there (eg. C</dev/sda1>)."
11040 msgstr ""
11041
11042 #. type: textblock
11043 #: ../src/guestfs-actions.pod:2830 ../fish/guestfish-actions.pod:1948
11044 msgid ""
11045 "Non-mounted devices such as swap devices are I<not> returned in this list."
11046 msgstr ""
11047
11048 #. type: textblock
11049 #: ../src/guestfs-actions.pod:2833
11050 msgid ""
11051 "For operating systems like Windows which still use drive letters, this call "
11052 "will only return an entry for the first drive \"mounted on\" C</>.  For "
11053 "information about the mapping of drive letters to partitions, see "
11054 "C<guestfs_inspect_get_drive_mappings>."
11055 msgstr ""
11056
11057 #. type: textblock
11058 #: ../src/guestfs-actions.pod:2839
11059 msgid ""
11060 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11061 "C<guestfs_inspect_get_filesystems>."
11062 msgstr ""
11063
11064 #. type: =head2
11065 #: ../src/guestfs-actions.pod:2850
11066 msgid "guestfs_inspect_get_package_format"
11067 msgstr ""
11068
11069 #. type: verbatim
11070 #: ../src/guestfs-actions.pod:2852
11071 #, no-wrap
11072 msgid ""
11073 " char *\n"
11074 " guestfs_inspect_get_package_format (guestfs_h *g,\n"
11075 "                                     const char *root);\n"
11076 "\n"
11077 msgstr ""
11078
11079 #. type: textblock
11080 #: ../src/guestfs-actions.pod:2859
11081 msgid ""
11082 "This function and C<guestfs_inspect_get_package_management> return the "
11083 "package format and package management tool used by the inspected operating "
11084 "system.  For example for Fedora these functions would return C<rpm> (package "
11085 "format) and C<yum> (package management)."
11086 msgstr ""
11087
11088 #. type: textblock
11089 #: ../src/guestfs-actions.pod:2865 ../fish/guestfish-actions.pod:1973
11090 msgid ""
11091 "This returns the string C<unknown> if we could not determine the package "
11092 "format I<or> if the operating system does not have a real packaging system "
11093 "(eg. Windows)."
11094 msgstr ""
11095
11096 #. type: textblock
11097 #: ../src/guestfs-actions.pod:2869 ../fish/guestfish-actions.pod:1977
11098 msgid ""
11099 "Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>.  "
11100 "Future versions of libguestfs may return other strings."
11101 msgstr ""
11102
11103 #. type: textblock
11104 #: ../src/guestfs-actions.pod:2877 ../src/guestfs-actions.pod:2908
11105 msgid "(Added in 1.7.5)"
11106 msgstr ""
11107
11108 #. type: =head2
11109 #: ../src/guestfs-actions.pod:2879
11110 msgid "guestfs_inspect_get_package_management"
11111 msgstr ""
11112
11113 #. type: verbatim
11114 #: ../src/guestfs-actions.pod:2881
11115 #, no-wrap
11116 msgid ""
11117 " char *\n"
11118 " guestfs_inspect_get_package_management (guestfs_h *g,\n"
11119 "                                         const char *root);\n"
11120 "\n"
11121 msgstr ""
11122
11123 #. type: textblock
11124 #: ../src/guestfs-actions.pod:2888
11125 msgid ""
11126 "C<guestfs_inspect_get_package_format> and this function return the package "
11127 "format and package management tool used by the inspected operating system.  "
11128 "For example for Fedora these functions would return C<rpm> (package format) "
11129 "and C<yum> (package management)."
11130 msgstr ""
11131
11132 #. type: textblock
11133 #: ../src/guestfs-actions.pod:2894 ../fish/guestfish-actions.pod:1995
11134 msgid ""
11135 "This returns the string C<unknown> if we could not determine the package "
11136 "management tool I<or> if the operating system does not have a real packaging "
11137 "system (eg. Windows)."
11138 msgstr ""
11139
11140 #. type: textblock
11141 #: ../src/guestfs-actions.pod:2898 ../fish/guestfish-actions.pod:1999
11142 msgid ""
11143 "Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian "
11144 "derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>.  Future versions of "
11145 "libguestfs may return other strings."
11146 msgstr ""
11147
11148 #. type: =head2
11149 #: ../src/guestfs-actions.pod:2910
11150 msgid "guestfs_inspect_get_product_name"
11151 msgstr ""
11152
11153 #. type: verbatim
11154 #: ../src/guestfs-actions.pod:2912
11155 #, no-wrap
11156 msgid ""
11157 " char *\n"
11158 " guestfs_inspect_get_product_name (guestfs_h *g,\n"
11159 "                                   const char *root);\n"
11160 "\n"
11161 msgstr ""
11162
11163 #. type: textblock
11164 #: ../src/guestfs-actions.pod:2919 ../fish/guestfish-actions.pod:2013
11165 msgid ""
11166 "This returns the product name of the inspected operating system.  The "
11167 "product name is generally some freeform string which can be displayed to the "
11168 "user, but should not be parsed by programs."
11169 msgstr ""
11170
11171 #. type: textblock
11172 #: ../src/guestfs-actions.pod:2924 ../fish/guestfish-actions.pod:2018
11173 msgid ""
11174 "If the product name could not be determined, then the string C<unknown> is "
11175 "returned."
11176 msgstr ""
11177
11178 #. type: =head2
11179 #: ../src/guestfs-actions.pod:2934
11180 msgid "guestfs_inspect_get_product_variant"
11181 msgstr ""
11182
11183 #. type: verbatim
11184 #: ../src/guestfs-actions.pod:2936
11185 #, no-wrap
11186 msgid ""
11187 " char *\n"
11188 " guestfs_inspect_get_product_variant (guestfs_h *g,\n"
11189 "                                      const char *root);\n"
11190 "\n"
11191 msgstr ""
11192
11193 #. type: textblock
11194 #: ../src/guestfs-actions.pod:2943 ../fish/guestfish-actions.pod:2030
11195 #, fuzzy
11196 #| msgid "This is an installed operating system."
11197 msgid "This returns the product variant of the inspected operating system."
11198 msgstr "Це встановлена операційна система."
11199
11200 #. type: textblock
11201 #: ../src/guestfs-actions.pod:2946 ../fish/guestfish-actions.pod:2033
11202 msgid ""
11203 "For Windows guests, this returns the contents of the Registry key C<HKLM"
11204 "\\Software\\Microsoft\\Windows NT\\CurrentVersion> C<InstallationType> which "
11205 "is usually a string such as C<Client> or C<Server> (other values are "
11206 "possible).  This can be used to distinguish consumer and enterprise versions "
11207 "of Windows that have the same version number (for example, Windows 7 and "
11208 "Windows 2008 Server are both version 6.1, but the former is C<Client> and "
11209 "the latter is C<Server>)."
11210 msgstr ""
11211
11212 #. type: textblock
11213 #: ../src/guestfs-actions.pod:2955 ../fish/guestfish-actions.pod:2042
11214 msgid ""
11215 "For enterprise Linux guests, in future we intend this to return the product "
11216 "variant such as C<Desktop>, C<Server> and so on.  But this is not "
11217 "implemented at present."
11218 msgstr ""
11219
11220 #. type: textblock
11221 #: ../src/guestfs-actions.pod:2959 ../fish/guestfish-actions.pod:2046
11222 msgid ""
11223 "If the product variant could not be determined, then the string C<unknown> "
11224 "is returned."
11225 msgstr ""
11226
11227 #. type: textblock
11228 #: ../src/guestfs-actions.pod:2962
11229 msgid ""
11230 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11231 "C<guestfs_inspect_get_product_name>, C<guestfs_inspect_get_major_version>."
11232 msgstr ""
11233
11234 #. type: =head2
11235 #: ../src/guestfs-actions.pod:2969
11236 msgid "guestfs_inspect_get_roots"
11237 msgstr ""
11238
11239 #. type: verbatim
11240 #: ../src/guestfs-actions.pod:2971
11241 #, no-wrap
11242 msgid ""
11243 " char **\n"
11244 " guestfs_inspect_get_roots (guestfs_h *g);\n"
11245 "\n"
11246 msgstr ""
11247
11248 #. type: textblock
11249 #: ../src/guestfs-actions.pod:2974
11250 msgid ""
11251 "This function is a convenient way to get the list of root devices, as "
11252 "returned from a previous call to C<guestfs_inspect_os>, but without redoing "
11253 "the whole inspection process."
11254 msgstr ""
11255
11256 #. type: textblock
11257 #: ../src/guestfs-actions.pod:2978
11258 msgid ""
11259 "This returns an empty list if either no root devices were found or the "
11260 "caller has not called C<guestfs_inspect_os>."
11261 msgstr ""
11262
11263 #. type: textblock
11264 #: ../src/guestfs-actions.pod:2987
11265 msgid "(Added in 1.7.3)"
11266 msgstr ""
11267
11268 #. type: =head2
11269 #: ../src/guestfs-actions.pod:2989
11270 msgid "guestfs_inspect_get_type"
11271 msgstr ""
11272
11273 #. type: verbatim
11274 #: ../src/guestfs-actions.pod:2991
11275 #, no-wrap
11276 msgid ""
11277 " char *\n"
11278 " guestfs_inspect_get_type (guestfs_h *g,\n"
11279 "                           const char *root);\n"
11280 "\n"
11281 msgstr ""
11282
11283 #. type: textblock
11284 #: ../src/guestfs-actions.pod:2998 ../fish/guestfish-actions.pod:2073
11285 msgid ""
11286 "This returns the type of the inspected operating system.  Currently defined "
11287 "types are:"
11288 msgstr ""
11289
11290 #. type: =item
11291 #: ../src/guestfs-actions.pod:3003 ../fish/guestfish-actions.pod:2078
11292 msgid "\"linux\""
11293 msgstr "\"linux\""
11294
11295 #. type: textblock
11296 #: ../src/guestfs-actions.pod:3005 ../fish/guestfish-actions.pod:2080
11297 msgid "Any Linux-based operating system."
11298 msgstr ""
11299
11300 #. type: textblock
11301 #: ../src/guestfs-actions.pod:3009 ../fish/guestfish-actions.pod:2084
11302 msgid "Any Microsoft Windows operating system."
11303 msgstr ""
11304
11305 #. type: =item
11306 #: ../src/guestfs-actions.pod:3011 ../fish/guestfish-actions.pod:2086
11307 msgid "\"freebsd\""
11308 msgstr "\"freebsd\""
11309
11310 #. type: textblock
11311 #: ../src/guestfs-actions.pod:3013 ../fish/guestfish-actions.pod:2088
11312 msgid "FreeBSD."
11313 msgstr "FreeBSD."
11314
11315 #. type: textblock
11316 #: ../src/guestfs-actions.pod:3017 ../fish/guestfish-actions.pod:2092
11317 msgid "The operating system type could not be determined."
11318 msgstr ""
11319
11320 #. type: =head2
11321 #: ../src/guestfs-actions.pod:3031
11322 msgid "guestfs_inspect_get_windows_current_control_set"
11323 msgstr ""
11324
11325 #. type: verbatim
11326 #: ../src/guestfs-actions.pod:3033
11327 #, no-wrap
11328 msgid ""
11329 " char *\n"
11330 " guestfs_inspect_get_windows_current_control_set (guestfs_h *g,\n"
11331 "                                                  const char *root);\n"
11332 "\n"
11333 msgstr ""
11334
11335 #. type: textblock
11336 #: ../src/guestfs-actions.pod:3040 ../fish/guestfish-actions.pod:2108
11337 msgid ""
11338 "This returns the Windows CurrentControlSet of the inspected guest.  The "
11339 "CurrentControlSet is a registry key name such as C<ControlSet001>."
11340 msgstr ""
11341
11342 #. type: textblock
11343 #: ../src/guestfs-actions.pod:3043 ../fish/guestfish-actions.pod:2111
11344 msgid ""
11345 "This call assumes that the guest is Windows and that the Registry could be "
11346 "examined by inspection.  If this is not the case then an error is returned."
11347 msgstr ""
11348
11349 #. type: =head2
11350 #: ../src/guestfs-actions.pod:3052
11351 msgid "guestfs_inspect_get_windows_systemroot"
11352 msgstr ""
11353
11354 #. type: verbatim
11355 #: ../src/guestfs-actions.pod:3054
11356 #, no-wrap
11357 msgid ""
11358 " char *\n"
11359 " guestfs_inspect_get_windows_systemroot (guestfs_h *g,\n"
11360 "                                         const char *root);\n"
11361 "\n"
11362 msgstr ""
11363
11364 #. type: textblock
11365 #: ../src/guestfs-actions.pod:3061 ../fish/guestfish-actions.pod:2124
11366 msgid ""
11367 "This returns the Windows systemroot of the inspected guest.  The systemroot "
11368 "is a directory path such as C</WINDOWS>."
11369 msgstr ""
11370
11371 #. type: textblock
11372 #: ../src/guestfs-actions.pod:3064 ../fish/guestfish-actions.pod:2127
11373 msgid ""
11374 "This call assumes that the guest is Windows and that the systemroot could be "
11375 "determined by inspection.  If this is not the case then an error is returned."
11376 msgstr ""
11377
11378 #. type: textblock
11379 #: ../src/guestfs-actions.pod:3073
11380 msgid "(Added in 1.5.25)"
11381 msgstr ""
11382
11383 #. type: =head2
11384 #: ../src/guestfs-actions.pod:3075
11385 msgid "guestfs_inspect_is_live"
11386 msgstr ""
11387
11388 #. type: verbatim
11389 #: ../src/guestfs-actions.pod:3077
11390 #, no-wrap
11391 msgid ""
11392 " int\n"
11393 " guestfs_inspect_is_live (guestfs_h *g,\n"
11394 "                          const char *root);\n"
11395 "\n"
11396 msgstr ""
11397
11398 #. type: textblock
11399 #: ../src/guestfs-actions.pod:3084
11400 msgid ""
11401 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
11402 "disk), then this returns true if a live image was detected on the disk."
11403 msgstr ""
11404
11405 #. type: =head2
11406 #: ../src/guestfs-actions.pod:3092
11407 msgid "guestfs_inspect_is_multipart"
11408 msgstr ""
11409
11410 #. type: verbatim
11411 #: ../src/guestfs-actions.pod:3094
11412 #, no-wrap
11413 msgid ""
11414 " int\n"
11415 " guestfs_inspect_is_multipart (guestfs_h *g,\n"
11416 "                               const char *root);\n"
11417 "\n"
11418 msgstr ""
11419
11420 #. type: textblock
11421 #: ../src/guestfs-actions.pod:3101
11422 msgid ""
11423 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
11424 "disk), then this returns true if the disk is part of a set."
11425 msgstr ""
11426
11427 #. type: =head2
11428 #: ../src/guestfs-actions.pod:3109
11429 msgid "guestfs_inspect_is_netinst"
11430 msgstr ""
11431
11432 #. type: verbatim
11433 #: ../src/guestfs-actions.pod:3111
11434 #, no-wrap
11435 msgid ""
11436 " int\n"
11437 " guestfs_inspect_is_netinst (guestfs_h *g,\n"
11438 "                             const char *root);\n"
11439 "\n"
11440 msgstr ""
11441
11442 #. type: textblock
11443 #: ../src/guestfs-actions.pod:3118
11444 msgid ""
11445 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
11446 "disk), then this returns true if the disk is a network installer, ie. not a "
11447 "self-contained install CD but one which is likely to require network access "
11448 "to complete the install."
11449 msgstr ""
11450
11451 #. type: =head2
11452 #: ../src/guestfs-actions.pod:3128
11453 msgid "guestfs_inspect_list_applications"
11454 msgstr ""
11455
11456 #. type: verbatim
11457 #: ../src/guestfs-actions.pod:3130
11458 #, no-wrap
11459 msgid ""
11460 " struct guestfs_application_list *\n"
11461 " guestfs_inspect_list_applications (guestfs_h *g,\n"
11462 "                                    const char *root);\n"
11463 "\n"
11464 msgstr ""
11465
11466 #. type: textblock
11467 #: ../src/guestfs-actions.pod:3137 ../fish/guestfish-actions.pod:2181
11468 msgid "Return the list of applications installed in the operating system."
11469 msgstr ""
11470
11471 #. type: textblock
11472 #: ../src/guestfs-actions.pod:3139
11473 msgid ""
11474 "I<Note:> This call works differently from other parts of the inspection "
11475 "API.  You have to call C<guestfs_inspect_os>, then "
11476 "C<guestfs_inspect_get_mountpoints>, then mount up the disks, before calling "
11477 "this.  Listing applications is a significantly more difficult operation "
11478 "which requires access to the full filesystem.  Also note that unlike the "
11479 "other C<guestfs_inspect_get_*> calls which are just returning data cached in "
11480 "the libguestfs handle, this call actually reads parts of the mounted "
11481 "filesystems during the call."
11482 msgstr ""
11483
11484 #. type: textblock
11485 #: ../src/guestfs-actions.pod:3149 ../fish/guestfish-actions.pod:2193
11486 msgid ""
11487 "This returns an empty list if the inspection code was not able to determine "
11488 "the list of applications."
11489 msgstr ""
11490
11491 #. type: textblock
11492 #: ../src/guestfs-actions.pod:3152 ../fish/guestfish-actions.pod:2196
11493 msgid "The application structure contains the following fields:"
11494 msgstr ""
11495
11496 #. type: =item
11497 #: ../src/guestfs-actions.pod:3156 ../fish/guestfish-actions.pod:2200
11498 msgid "C<app_name>"
11499 msgstr "C<app_name>"
11500
11501 #. type: textblock
11502 #: ../src/guestfs-actions.pod:3158 ../fish/guestfish-actions.pod:2202
11503 msgid ""
11504 "The name of the application.  For Red Hat-derived and Debian-derived Linux "
11505 "guests, this is the package name."
11506 msgstr ""
11507
11508 #. type: =item
11509 #: ../src/guestfs-actions.pod:3161 ../fish/guestfish-actions.pod:2205
11510 msgid "C<app_display_name>"
11511 msgstr "C<app_display_name>"
11512
11513 #. type: textblock
11514 #: ../src/guestfs-actions.pod:3163 ../fish/guestfish-actions.pod:2207
11515 msgid ""
11516 "The display name of the application, sometimes localized to the install "
11517 "language of the guest operating system."
11518 msgstr ""
11519
11520 #. type: textblock
11521 #: ../src/guestfs-actions.pod:3166 ../fish/guestfish-actions.pod:2210
11522 msgid ""
11523 "If unavailable this is returned as an empty string C<\"\">.  Callers needing "
11524 "to display something can use C<app_name> instead."
11525 msgstr ""
11526
11527 #. type: =item
11528 #: ../src/guestfs-actions.pod:3169 ../fish/guestfish-actions.pod:2213
11529 msgid "C<app_epoch>"
11530 msgstr "C<app_epoch>"
11531
11532 #. type: textblock
11533 #: ../src/guestfs-actions.pod:3171 ../fish/guestfish-actions.pod:2215
11534 msgid ""
11535 "For package managers which use epochs, this contains the epoch of the "
11536 "package (an integer).  If unavailable, this is returned as C<0>."
11537 msgstr ""
11538
11539 #. type: =item
11540 #: ../src/guestfs-actions.pod:3174 ../fish/guestfish-actions.pod:2218
11541 msgid "C<app_version>"
11542 msgstr "C<app_version>"
11543
11544 #. type: textblock
11545 #: ../src/guestfs-actions.pod:3176 ../fish/guestfish-actions.pod:2220
11546 msgid ""
11547 "The version string of the application or package.  If unavailable this is "
11548 "returned as an empty string C<\"\">."
11549 msgstr ""
11550
11551 #. type: =item
11552 #: ../src/guestfs-actions.pod:3179 ../fish/guestfish-actions.pod:2223
11553 msgid "C<app_release>"
11554 msgstr "C<app_release>"
11555
11556 #. type: textblock
11557 #: ../src/guestfs-actions.pod:3181 ../fish/guestfish-actions.pod:2225
11558 msgid ""
11559 "The release string of the application or package, for package managers that "
11560 "use this.  If unavailable this is returned as an empty string C<\"\">."
11561 msgstr ""
11562
11563 #. type: =item
11564 #: ../src/guestfs-actions.pod:3185 ../fish/guestfish-actions.pod:2229
11565 msgid "C<app_install_path>"
11566 msgstr "C<app_install_path>"
11567
11568 #. type: textblock
11569 #: ../src/guestfs-actions.pod:3187 ../fish/guestfish-actions.pod:2231
11570 msgid ""
11571 "The installation path of the application (on operating systems such as "
11572 "Windows which use installation paths).  This path is in the format used by "
11573 "the guest operating system, it is not a libguestfs path."
11574 msgstr ""
11575
11576 #. type: textblock
11577 #: ../src/guestfs-actions.pod:3192 ../fish/guestfish-actions.pod:2236
11578 msgid "If unavailable this is returned as an empty string C<\"\">."
11579 msgstr ""
11580
11581 #. type: =item
11582 #: ../src/guestfs-actions.pod:3194 ../fish/guestfish-actions.pod:2238
11583 msgid "C<app_trans_path>"
11584 msgstr "C<app_trans_path>"
11585
11586 #. type: textblock
11587 #: ../src/guestfs-actions.pod:3196 ../fish/guestfish-actions.pod:2240
11588 msgid ""
11589 "The install path translated into a libguestfs path.  If unavailable this is "
11590 "returned as an empty string C<\"\">."
11591 msgstr ""
11592
11593 #. type: =item
11594 #: ../src/guestfs-actions.pod:3199 ../fish/guestfish-actions.pod:2243
11595 msgid "C<app_publisher>"
11596 msgstr "C<app_publisher>"
11597
11598 #. type: textblock
11599 #: ../src/guestfs-actions.pod:3201 ../fish/guestfish-actions.pod:2245
11600 msgid ""
11601 "The name of the publisher of the application, for package managers that use "
11602 "this.  If unavailable this is returned as an empty string C<\"\">."
11603 msgstr ""
11604
11605 #. type: =item
11606 #: ../src/guestfs-actions.pod:3205 ../fish/guestfish-actions.pod:2249
11607 msgid "C<app_url>"
11608 msgstr "C<app_url>"
11609
11610 #. type: textblock
11611 #: ../src/guestfs-actions.pod:3207 ../fish/guestfish-actions.pod:2251
11612 msgid ""
11613 "The URL (eg. upstream URL) of the application.  If unavailable this is "
11614 "returned as an empty string C<\"\">."
11615 msgstr ""
11616
11617 #. type: =item
11618 #: ../src/guestfs-actions.pod:3210 ../fish/guestfish-actions.pod:2254
11619 msgid "C<app_source_package>"
11620 msgstr ""
11621
11622 #. type: textblock
11623 #: ../src/guestfs-actions.pod:3212 ../fish/guestfish-actions.pod:2256
11624 msgid ""
11625 "For packaging systems which support this, the name of the source package.  "
11626 "If unavailable this is returned as an empty string C<\"\">."
11627 msgstr ""
11628
11629 #. type: =item
11630 #: ../src/guestfs-actions.pod:3215 ../fish/guestfish-actions.pod:2259
11631 msgid "C<app_summary>"
11632 msgstr ""
11633
11634 #. type: textblock
11635 #: ../src/guestfs-actions.pod:3217 ../fish/guestfish-actions.pod:2261
11636 msgid ""
11637 "A short (usually one line) description of the application or package.  If "
11638 "unavailable this is returned as an empty string C<\"\">."
11639 msgstr ""
11640
11641 #. type: =item
11642 #: ../src/guestfs-actions.pod:3220 ../fish/guestfish-actions.pod:2264
11643 msgid "C<app_description>"
11644 msgstr ""
11645
11646 #. type: textblock
11647 #: ../src/guestfs-actions.pod:3222 ../fish/guestfish-actions.pod:2266
11648 msgid ""
11649 "A longer description of the application or package.  If unavailable this is "
11650 "returned as an empty string C<\"\">."
11651 msgstr ""
11652
11653 #. type: textblock
11654 #: ../src/guestfs-actions.pod:3229
11655 msgid ""
11656 "This function returns a C<struct guestfs_application_list *>, or NULL if "
11657 "there was an error.  I<The caller must call C<guestfs_free_application_list> "
11658 "after use>."
11659 msgstr ""
11660
11661 #. type: textblock
11662 #: ../src/guestfs-actions.pod:3233
11663 msgid "(Added in 1.7.8)"
11664 msgstr ""
11665
11666 #. type: =head2
11667 #: ../src/guestfs-actions.pod:3235
11668 msgid "guestfs_inspect_os"
11669 msgstr ""
11670
11671 #. type: verbatim
11672 #: ../src/guestfs-actions.pod:3237
11673 #, no-wrap
11674 msgid ""
11675 " char **\n"
11676 " guestfs_inspect_os (guestfs_h *g);\n"
11677 "\n"
11678 msgstr ""
11679
11680 #. type: textblock
11681 #: ../src/guestfs-actions.pod:3240 ../fish/guestfish-actions.pod:2277
11682 msgid ""
11683 "This function uses other libguestfs functions and certain heuristics to "
11684 "inspect the disk(s) (usually disks belonging to a virtual machine), looking "
11685 "for operating systems."
11686 msgstr ""
11687
11688 #. type: textblock
11689 #: ../src/guestfs-actions.pod:3244 ../fish/guestfish-actions.pod:2281
11690 msgid "The list returned is empty if no operating systems were found."
11691 msgstr ""
11692
11693 #. type: textblock
11694 #: ../src/guestfs-actions.pod:3246 ../fish/guestfish-actions.pod:2283
11695 msgid ""
11696 "If one operating system was found, then this returns a list with a single "
11697 "element, which is the name of the root filesystem of this operating system.  "
11698 "It is also possible for this function to return a list containing more than "
11699 "one element, indicating a dual-boot or multi-boot virtual machine, with each "
11700 "element being the root filesystem of one of the operating systems."
11701 msgstr ""
11702
11703 #. type: textblock
11704 #: ../src/guestfs-actions.pod:3253
11705 msgid ""
11706 "You can pass the root string(s) returned to other C<guestfs_inspect_get_*> "
11707 "functions in order to query further information about each operating system, "
11708 "such as the name and version."
11709 msgstr ""
11710
11711 #. type: textblock
11712 #: ../src/guestfs-actions.pod:3258
11713 msgid ""
11714 "This function uses other libguestfs features such as C<guestfs_mount_ro> and "
11715 "C<guestfs_umount_all> in order to mount and unmount filesystems and look at "
11716 "the contents.  This should be called with no disks currently mounted.  The "
11717 "function may also use Augeas, so any existing Augeas handle will be closed."
11718 msgstr ""
11719
11720 #. type: textblock
11721 #: ../src/guestfs-actions.pod:3264 ../fish/guestfish-actions.pod:2301
11722 msgid ""
11723 "This function cannot decrypt encrypted disks.  The caller must do that first "
11724 "(supplying the necessary keys) if the disk is encrypted."
11725 msgstr ""
11726
11727 #. type: textblock
11728 #: ../src/guestfs-actions.pod:3270 ../src/guestfs-actions.pod:3560
11729 #: ../src/guestfs-actions.pod:3622
11730 msgid "See also C<guestfs_list_filesystems>."
11731 msgstr ""
11732
11733 #. type: =head2
11734 #: ../src/guestfs-actions.pod:3278
11735 msgid "guestfs_is_blockdev"
11736 msgstr ""
11737
11738 #. type: verbatim
11739 #: ../src/guestfs-actions.pod:3280
11740 #, no-wrap
11741 msgid ""
11742 " int\n"
11743 " guestfs_is_blockdev (guestfs_h *g,\n"
11744 "                      const char *path);\n"
11745 "\n"
11746 msgstr ""
11747
11748 #. type: textblock
11749 #: ../src/guestfs-actions.pod:3284 ../fish/guestfish-actions.pod:2313
11750 msgid ""
11751 "This returns C<true> if and only if there is a block device with the given "
11752 "C<path> name."
11753 msgstr ""
11754
11755 #. type: textblock
11756 #: ../src/guestfs-actions.pod:3287 ../src/guestfs-actions.pod:3316
11757 #: ../src/guestfs-actions.pod:3346 ../src/guestfs-actions.pod:3361
11758 #: ../src/guestfs-actions.pod:3377 ../src/guestfs-actions.pod:3433
11759 #: ../src/guestfs-actions.pod:3448
11760 msgid "See also C<guestfs_stat>."
11761 msgstr ""
11762
11763 #. type: textblock
11764 #: ../src/guestfs-actions.pod:3291 ../src/guestfs-actions.pod:3320
11765 #: ../src/guestfs-actions.pod:3365 ../src/guestfs-actions.pod:3437
11766 #: ../src/guestfs-actions.pod:3452
11767 msgid "(Added in 1.5.10)"
11768 msgstr ""
11769
11770 #. type: =head2
11771 #: ../src/guestfs-actions.pod:3293
11772 msgid "guestfs_is_busy"
11773 msgstr ""
11774
11775 #. type: verbatim
11776 #: ../src/guestfs-actions.pod:3295
11777 #, no-wrap
11778 msgid ""
11779 " int\n"
11780 " guestfs_is_busy (guestfs_h *g);\n"
11781 "\n"
11782 msgstr ""
11783
11784 #. type: textblock
11785 #: ../src/guestfs-actions.pod:3298 ../fish/guestfish-actions.pod:2322
11786 msgid ""
11787 "This returns true iff this handle is busy processing a command (in the "
11788 "C<BUSY> state)."
11789 msgstr ""
11790
11791 #. type: =head2
11792 #: ../src/guestfs-actions.pod:3307
11793 msgid "guestfs_is_chardev"
11794 msgstr ""
11795
11796 #. type: verbatim
11797 #: ../src/guestfs-actions.pod:3309
11798 #, no-wrap
11799 msgid ""
11800 " int\n"
11801 " guestfs_is_chardev (guestfs_h *g,\n"
11802 "                     const char *path);\n"
11803 "\n"
11804 msgstr ""
11805
11806 #. type: textblock
11807 #: ../src/guestfs-actions.pod:3313 ../fish/guestfish-actions.pod:2331
11808 msgid ""
11809 "This returns C<true> if and only if there is a character device with the "
11810 "given C<path> name."
11811 msgstr ""
11812
11813 #. type: =head2
11814 #: ../src/guestfs-actions.pod:3322
11815 msgid "guestfs_is_config"
11816 msgstr ""
11817
11818 #. type: verbatim
11819 #: ../src/guestfs-actions.pod:3324
11820 #, no-wrap
11821 msgid ""
11822 " int\n"
11823 " guestfs_is_config (guestfs_h *g);\n"
11824 "\n"
11825 msgstr ""
11826
11827 #. type: textblock
11828 #: ../src/guestfs-actions.pod:3327 ../fish/guestfish-actions.pod:2340
11829 msgid ""
11830 "This returns true iff this handle is being configured (in the C<CONFIG> "
11831 "state)."
11832 msgstr ""
11833
11834 #. type: =head2
11835 #: ../src/guestfs-actions.pod:3336
11836 msgid "guestfs_is_dir"
11837 msgstr ""
11838
11839 #. type: verbatim
11840 #: ../src/guestfs-actions.pod:3338
11841 #, no-wrap
11842 msgid ""
11843 " int\n"
11844 " guestfs_is_dir (guestfs_h *g,\n"
11845 "                 const char *path);\n"
11846 "\n"
11847 msgstr ""
11848
11849 #. type: textblock
11850 #: ../src/guestfs-actions.pod:3342 ../fish/guestfish-actions.pod:2349
11851 msgid ""
11852 "This returns C<true> if and only if there is a directory with the given "
11853 "C<path> name.  Note that it returns false for other objects like files."
11854 msgstr ""
11855
11856 #. type: =head2
11857 #: ../src/guestfs-actions.pod:3352
11858 msgid "guestfs_is_fifo"
11859 msgstr ""
11860
11861 #. type: verbatim
11862 #: ../src/guestfs-actions.pod:3354
11863 #, no-wrap
11864 msgid ""
11865 " int\n"
11866 " guestfs_is_fifo (guestfs_h *g,\n"
11867 "                  const char *path);\n"
11868 "\n"
11869 msgstr ""
11870
11871 #. type: textblock
11872 #: ../src/guestfs-actions.pod:3358 ../fish/guestfish-actions.pod:2359
11873 msgid ""
11874 "This returns C<true> if and only if there is a FIFO (named pipe)  with the "
11875 "given C<path> name."
11876 msgstr ""
11877
11878 #. type: =head2
11879 #: ../src/guestfs-actions.pod:3367
11880 msgid "guestfs_is_file"
11881 msgstr ""
11882
11883 #. type: verbatim
11884 #: ../src/guestfs-actions.pod:3369
11885 #, no-wrap
11886 msgid ""
11887 " int\n"
11888 " guestfs_is_file (guestfs_h *g,\n"
11889 "                  const char *path);\n"
11890 "\n"
11891 msgstr ""
11892
11893 #. type: textblock
11894 #: ../src/guestfs-actions.pod:3373 ../fish/guestfish-actions.pod:2368
11895 msgid ""
11896 "This returns C<true> if and only if there is a regular file with the given "
11897 "C<path> name.  Note that it returns false for other objects like directories."
11898 msgstr ""
11899
11900 #. type: =head2
11901 #: ../src/guestfs-actions.pod:3383
11902 msgid "guestfs_is_launching"
11903 msgstr ""
11904
11905 #. type: verbatim
11906 #: ../src/guestfs-actions.pod:3385
11907 #, no-wrap
11908 msgid ""
11909 " int\n"
11910 " guestfs_is_launching (guestfs_h *g);\n"
11911 "\n"
11912 msgstr ""
11913
11914 #. type: textblock
11915 #: ../src/guestfs-actions.pod:3388 ../fish/guestfish-actions.pod:2378
11916 msgid ""
11917 "This returns true iff this handle is launching the subprocess (in the "
11918 "C<LAUNCHING> state)."
11919 msgstr ""
11920
11921 #. type: =head2
11922 #: ../src/guestfs-actions.pod:3397
11923 msgid "guestfs_is_lv"
11924 msgstr ""
11925
11926 #. type: verbatim
11927 #: ../src/guestfs-actions.pod:3399
11928 #, no-wrap
11929 msgid ""
11930 " int\n"
11931 " guestfs_is_lv (guestfs_h *g,\n"
11932 "                const char *device);\n"
11933 "\n"
11934 msgstr ""
11935
11936 #. type: textblock
11937 #: ../src/guestfs-actions.pod:3403 ../fish/guestfish-actions.pod:2387
11938 msgid ""
11939 "This command tests whether C<device> is a logical volume, and returns true "
11940 "iff this is the case."
11941 msgstr ""
11942
11943 #. type: =head2
11944 #: ../src/guestfs-actions.pod:3410
11945 msgid "guestfs_is_ready"
11946 msgstr ""
11947
11948 #. type: verbatim
11949 #: ../src/guestfs-actions.pod:3412
11950 #, no-wrap
11951 msgid ""
11952 " int\n"
11953 " guestfs_is_ready (guestfs_h *g);\n"
11954 "\n"
11955 msgstr ""
11956
11957 #. type: textblock
11958 #: ../src/guestfs-actions.pod:3415 ../fish/guestfish-actions.pod:2394
11959 msgid ""
11960 "This returns true iff this handle is ready to accept commands (in the "
11961 "C<READY> state)."
11962 msgstr ""
11963
11964 #. type: =head2
11965 #: ../src/guestfs-actions.pod:3424
11966 msgid "guestfs_is_socket"
11967 msgstr ""
11968
11969 #. type: verbatim
11970 #: ../src/guestfs-actions.pod:3426
11971 #, no-wrap
11972 msgid ""
11973 " int\n"
11974 " guestfs_is_socket (guestfs_h *g,\n"
11975 "                    const char *path);\n"
11976 "\n"
11977 msgstr ""
11978
11979 #. type: textblock
11980 #: ../src/guestfs-actions.pod:3430 ../fish/guestfish-actions.pod:2403
11981 msgid ""
11982 "This returns C<true> if and only if there is a Unix domain socket with the "
11983 "given C<path> name."
11984 msgstr ""
11985
11986 #. type: =head2
11987 #: ../src/guestfs-actions.pod:3439
11988 msgid "guestfs_is_symlink"
11989 msgstr ""
11990
11991 #. type: verbatim
11992 #: ../src/guestfs-actions.pod:3441
11993 #, no-wrap
11994 msgid ""
11995 " int\n"
11996 " guestfs_is_symlink (guestfs_h *g,\n"
11997 "                     const char *path);\n"
11998 "\n"
11999 msgstr ""
12000
12001 #. type: textblock
12002 #: ../src/guestfs-actions.pod:3445 ../fish/guestfish-actions.pod:2412
12003 msgid ""
12004 "This returns C<true> if and only if there is a symbolic link with the given "
12005 "C<path> name."
12006 msgstr ""
12007
12008 #. type: =head2
12009 #: ../src/guestfs-actions.pod:3454
12010 msgid "guestfs_kill_subprocess"
12011 msgstr ""
12012
12013 #. type: verbatim
12014 #: ../src/guestfs-actions.pod:3456
12015 #, no-wrap
12016 msgid ""
12017 " int\n"
12018 " guestfs_kill_subprocess (guestfs_h *g);\n"
12019 "\n"
12020 msgstr ""
12021
12022 #. type: textblock
12023 #: ../src/guestfs-actions.pod:3459 ../fish/guestfish-actions.pod:2421
12024 msgid "This kills the qemu subprocess.  You should never need to call this."
12025 msgstr ""
12026
12027 #. type: =head2
12028 #: ../src/guestfs-actions.pod:3465
12029 msgid "guestfs_launch"
12030 msgstr ""
12031
12032 #. type: verbatim
12033 #: ../src/guestfs-actions.pod:3467
12034 #, no-wrap
12035 msgid ""
12036 " int\n"
12037 " guestfs_launch (guestfs_h *g);\n"
12038 "\n"
12039 msgstr ""
12040
12041 #. type: textblock
12042 #: ../src/guestfs-actions.pod:3470 ../fish/guestfish-actions.pod:2429
12043 msgid ""
12044 "Internally libguestfs is implemented by running a virtual machine using "
12045 "L<qemu(1)>."
12046 msgstr ""
12047
12048 #. type: textblock
12049 #: ../src/guestfs-actions.pod:3473 ../fish/guestfish-actions.pod:2432
12050 msgid ""
12051 "You should call this after configuring the handle (eg. adding drives) but "
12052 "before performing any actions."
12053 msgstr ""
12054
12055 #. type: =head2
12056 #: ../src/guestfs-actions.pod:3485
12057 msgid "guestfs_lchown"
12058 msgstr ""
12059
12060 #. type: verbatim
12061 #: ../src/guestfs-actions.pod:3487
12062 #, no-wrap
12063 msgid ""
12064 " int\n"
12065 " guestfs_lchown (guestfs_h *g,\n"
12066 "                 int owner,\n"
12067 "                 int group,\n"
12068 "                 const char *path);\n"
12069 "\n"
12070 msgstr ""
12071
12072 #. type: textblock
12073 #: ../src/guestfs-actions.pod:3493
12074 msgid ""
12075 "Change the file owner to C<owner> and group to C<group>.  This is like "
12076 "C<guestfs_chown> but if C<path> is a symlink then the link itself is "
12077 "changed, not the target."
12078 msgstr ""
12079
12080 #. type: =head2
12081 #: ../src/guestfs-actions.pod:3505
12082 msgid "guestfs_lgetxattr"
12083 msgstr ""
12084
12085 #. type: verbatim
12086 #: ../src/guestfs-actions.pod:3507
12087 #, no-wrap
12088 msgid ""
12089 " char *\n"
12090 " guestfs_lgetxattr (guestfs_h *g,\n"
12091 "                    const char *path,\n"
12092 "                    const char *name,\n"
12093 "                    size_t *size_r);\n"
12094 "\n"
12095 msgstr ""
12096
12097 #. type: textblock
12098 #: ../src/guestfs-actions.pod:3513 ../fish/guestfish-actions.pod:2451
12099 msgid ""
12100 "Get a single extended attribute from file C<path> named C<name>.  If C<path> "
12101 "is a symlink, then this call returns an extended attribute from the symlink."
12102 msgstr ""
12103
12104 #. type: textblock
12105 #: ../src/guestfs-actions.pod:3527
12106 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>."
12107 msgstr ""
12108
12109 #. type: =head2
12110 #: ../src/guestfs-actions.pod:3535
12111 msgid "guestfs_lgetxattrs"
12112 msgstr ""
12113
12114 #. type: verbatim
12115 #: ../src/guestfs-actions.pod:3537
12116 #, no-wrap
12117 msgid ""
12118 " struct guestfs_xattr_list *\n"
12119 " guestfs_lgetxattrs (guestfs_h *g,\n"
12120 "                     const char *path);\n"
12121 "\n"
12122 msgstr ""
12123
12124 #. type: textblock
12125 #: ../src/guestfs-actions.pod:3541
12126 msgid ""
12127 "This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, "
12128 "then it returns the extended attributes of the link itself."
12129 msgstr ""
12130
12131 #. type: =head2
12132 #: ../src/guestfs-actions.pod:3551
12133 msgid "guestfs_list_devices"
12134 msgstr ""
12135
12136 #. type: verbatim
12137 #: ../src/guestfs-actions.pod:3553
12138 #, no-wrap
12139 msgid ""
12140 " char **\n"
12141 " guestfs_list_devices (guestfs_h *g);\n"
12142 "\n"
12143 msgstr ""
12144
12145 #. type: textblock
12146 #: ../src/guestfs-actions.pod:3556 ../fish/guestfish-actions.pod:2479
12147 msgid "List all the block devices."
12148 msgstr ""
12149
12150 #. type: textblock
12151 #: ../src/guestfs-actions.pod:3558 ../fish/guestfish-actions.pod:2481
12152 msgid "The full block device names are returned, eg. C</dev/sda>."
12153 msgstr ""
12154
12155 #. type: =head2
12156 #: ../src/guestfs-actions.pod:3568
12157 msgid "guestfs_list_filesystems"
12158 msgstr ""
12159
12160 #. type: verbatim
12161 #: ../src/guestfs-actions.pod:3570
12162 #, no-wrap
12163 msgid ""
12164 " char **\n"
12165 " guestfs_list_filesystems (guestfs_h *g);\n"
12166 "\n"
12167 msgstr ""
12168
12169 #. type: textblock
12170 #: ../src/guestfs-actions.pod:3573 ../fish/guestfish-actions.pod:2489
12171 msgid ""
12172 "This inspection command looks for filesystems on partitions, block devices "
12173 "and logical volumes, returning a list of devices containing filesystems and "
12174 "their type."
12175 msgstr ""
12176
12177 #. type: textblock
12178 #: ../src/guestfs-actions.pod:3577 ../fish/guestfish-actions.pod:2493
12179 msgid ""
12180 "The return value is a hash, where the keys are the devices containing "
12181 "filesystems, and the values are the filesystem types.  For example:"
12182 msgstr ""
12183
12184 #. type: verbatim
12185 #: ../src/guestfs-actions.pod:3581 ../fish/guestfish-actions.pod:2497
12186 #, no-wrap
12187 msgid ""
12188 " \"/dev/sda1\" => \"ntfs\"\n"
12189 " \"/dev/sda2\" => \"ext2\"\n"
12190 " \"/dev/vg_guest/lv_root\" => \"ext4\"\n"
12191 " \"/dev/vg_guest/lv_swap\" => \"swap\"\n"
12192 "\n"
12193 msgstr ""
12194
12195 #. type: textblock
12196 #: ../src/guestfs-actions.pod:3586 ../fish/guestfish-actions.pod:2502
12197 msgid ""
12198 "The value can have the special value \"unknown\", meaning the content of the "
12199 "device is undetermined or empty.  \"swap\" means a Linux swap partition."
12200 msgstr ""
12201
12202 #. type: textblock
12203 #: ../src/guestfs-actions.pod:3590
12204 msgid ""
12205 "This command runs other libguestfs commands, which might include "
12206 "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this "
12207 "soon after launch and only when nothing is mounted."
12208 msgstr ""
12209
12210 #. type: textblock
12211 #: ../src/guestfs-actions.pod:3594
12212 msgid ""
12213 "Not all of the filesystems returned will be mountable.  In particular, swap "
12214 "partitions are returned in the list.  Also this command does not check that "
12215 "each filesystem found is valid and mountable, and some filesystems might be "
12216 "mountable but require special options.  Filesystems may not all belong to a "
12217 "single logical operating system (use C<guestfs_inspect_os> to look for OSes)."
12218 msgstr ""
12219
12220 #. type: textblock
12221 #: ../src/guestfs-actions.pod:3608 ../src/guestfs-actions.pod:5229
12222 msgid "(Added in 1.5.15)"
12223 msgstr ""
12224
12225 #. type: =head2
12226 #: ../src/guestfs-actions.pod:3610
12227 msgid "guestfs_list_partitions"
12228 msgstr ""
12229
12230 #. type: verbatim
12231 #: ../src/guestfs-actions.pod:3612
12232 #, no-wrap
12233 msgid ""
12234 " char **\n"
12235 " guestfs_list_partitions (guestfs_h *g);\n"
12236 "\n"
12237 msgstr ""
12238
12239 #. type: textblock
12240 #: ../src/guestfs-actions.pod:3615 ../fish/guestfish-actions.pod:2522
12241 msgid "List all the partitions detected on all block devices."
12242 msgstr ""
12243
12244 #. type: textblock
12245 #: ../src/guestfs-actions.pod:3617 ../fish/guestfish-actions.pod:2524
12246 msgid "The full partition device names are returned, eg. C</dev/sda1>"
12247 msgstr ""
12248
12249 #. type: textblock
12250 #: ../src/guestfs-actions.pod:3619
12251 msgid ""
12252 "This does not return logical volumes.  For that you will need to call "
12253 "C<guestfs_lvs>."
12254 msgstr ""
12255
12256 #. type: =head2
12257 #: ../src/guestfs-actions.pod:3630
12258 msgid "guestfs_ll"
12259 msgstr ""
12260
12261 #. type: verbatim
12262 #: ../src/guestfs-actions.pod:3632
12263 #, no-wrap
12264 msgid ""
12265 " char *\n"
12266 " guestfs_ll (guestfs_h *g,\n"
12267 "             const char *directory);\n"
12268 "\n"
12269 msgstr ""
12270
12271 #. type: textblock
12272 #: ../src/guestfs-actions.pod:3636 ../fish/guestfish-actions.pod:2535
12273 msgid ""
12274 "List the files in C<directory> (relative to the root directory, there is no "
12275 "cwd) in the format of 'ls -la'."
12276 msgstr ""
12277
12278 #. type: textblock
12279 #: ../src/guestfs-actions.pod:3639 ../fish/guestfish-actions.pod:2538
12280 msgid ""
12281 "This command is mostly useful for interactive sessions.  It is I<not> "
12282 "intended that you try to parse the output string."
12283 msgstr ""
12284
12285 #. type: =head2
12286 #: ../src/guestfs-actions.pod:3647
12287 msgid "guestfs_ln"
12288 msgstr ""
12289
12290 #. type: verbatim
12291 #: ../src/guestfs-actions.pod:3649
12292 #, no-wrap
12293 msgid ""
12294 " int\n"
12295 " guestfs_ln (guestfs_h *g,\n"
12296 "             const char *target,\n"
12297 "             const char *linkname);\n"
12298 "\n"
12299 msgstr ""
12300
12301 #. type: textblock
12302 #: ../src/guestfs-actions.pod:3654 ../fish/guestfish-actions.pod:2545
12303 msgid "This command creates a hard link using the C<ln> command."
12304 msgstr ""
12305
12306 #. type: =head2
12307 #: ../src/guestfs-actions.pod:3660
12308 msgid "guestfs_ln_f"
12309 msgstr ""
12310
12311 #. type: verbatim
12312 #: ../src/guestfs-actions.pod:3662
12313 #, no-wrap
12314 msgid ""
12315 " int\n"
12316 " guestfs_ln_f (guestfs_h *g,\n"
12317 "               const char *target,\n"
12318 "               const char *linkname);\n"
12319 "\n"
12320 msgstr ""
12321
12322 #. type: textblock
12323 #: ../src/guestfs-actions.pod:3667 ../fish/guestfish-actions.pod:2551
12324 msgid ""
12325 "This command creates a hard link using the C<ln -f> command.  The I<-f> "
12326 "option removes the link (C<linkname>) if it exists already."
12327 msgstr ""
12328
12329 #. type: =head2
12330 #: ../src/guestfs-actions.pod:3674
12331 msgid "guestfs_ln_s"
12332 msgstr ""
12333
12334 #. type: verbatim
12335 #: ../src/guestfs-actions.pod:3676
12336 #, no-wrap
12337 msgid ""
12338 " int\n"
12339 " guestfs_ln_s (guestfs_h *g,\n"
12340 "               const char *target,\n"
12341 "               const char *linkname);\n"
12342 "\n"
12343 msgstr ""
12344
12345 #. type: textblock
12346 #: ../src/guestfs-actions.pod:3681 ../fish/guestfish-actions.pod:2558
12347 msgid "This command creates a symbolic link using the C<ln -s> command."
12348 msgstr ""
12349
12350 #. type: =head2
12351 #: ../src/guestfs-actions.pod:3687
12352 msgid "guestfs_ln_sf"
12353 msgstr ""
12354
12355 #. type: verbatim
12356 #: ../src/guestfs-actions.pod:3689
12357 #, no-wrap
12358 msgid ""
12359 " int\n"
12360 " guestfs_ln_sf (guestfs_h *g,\n"
12361 "                const char *target,\n"
12362 "                const char *linkname);\n"
12363 "\n"
12364 msgstr ""
12365
12366 #. type: textblock
12367 #: ../src/guestfs-actions.pod:3694 ../fish/guestfish-actions.pod:2564
12368 msgid ""
12369 "This command creates a symbolic link using the C<ln -sf> command, The I<-f> "
12370 "option removes the link (C<linkname>) if it exists already."
12371 msgstr ""
12372
12373 #. type: =head2
12374 #: ../src/guestfs-actions.pod:3701
12375 msgid "guestfs_lremovexattr"
12376 msgstr ""
12377
12378 #. type: verbatim
12379 #: ../src/guestfs-actions.pod:3703
12380 #, no-wrap
12381 msgid ""
12382 " int\n"
12383 " guestfs_lremovexattr (guestfs_h *g,\n"
12384 "                       const char *xattr,\n"
12385 "                       const char *path);\n"
12386 "\n"
12387 msgstr ""
12388
12389 #. type: textblock
12390 #: ../src/guestfs-actions.pod:3708
12391 msgid ""
12392 "This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic "
12393 "link, then it removes an extended attribute of the link itself."
12394 msgstr ""
12395
12396 #. type: =head2
12397 #: ../src/guestfs-actions.pod:3716
12398 msgid "guestfs_ls"
12399 msgstr ""
12400
12401 #. type: verbatim
12402 #: ../src/guestfs-actions.pod:3718
12403 #, no-wrap
12404 msgid ""
12405 " char **\n"
12406 " guestfs_ls (guestfs_h *g,\n"
12407 "             const char *directory);\n"
12408 "\n"
12409 msgstr ""
12410
12411 #. type: textblock
12412 #: ../src/guestfs-actions.pod:3722 ../fish/guestfish-actions.pod:2579
12413 msgid ""
12414 "List the files in C<directory> (relative to the root directory, there is no "
12415 "cwd).  The '.' and '..' entries are not returned, but hidden files are shown."
12416 msgstr ""
12417
12418 #. type: textblock
12419 #: ../src/guestfs-actions.pod:3726
12420 msgid ""
12421 "This command is mostly useful for interactive sessions.  Programs should "
12422 "probably use C<guestfs_readdir> instead."
12423 msgstr ""
12424
12425 #. type: =head2
12426 #: ../src/guestfs-actions.pod:3735
12427 msgid "guestfs_lsetxattr"
12428 msgstr ""
12429
12430 #. type: verbatim
12431 #: ../src/guestfs-actions.pod:3737
12432 #, no-wrap
12433 msgid ""
12434 " int\n"
12435 " guestfs_lsetxattr (guestfs_h *g,\n"
12436 "                    const char *xattr,\n"
12437 "                    const char *val,\n"
12438 "                    int vallen,\n"
12439 "                    const char *path);\n"
12440 "\n"
12441 msgstr ""
12442
12443 #. type: textblock
12444 #: ../src/guestfs-actions.pod:3744
12445 msgid ""
12446 "This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, "
12447 "then it sets an extended attribute of the link itself."
12448 msgstr ""
12449
12450 #. type: =head2
12451 #: ../src/guestfs-actions.pod:3752
12452 msgid "guestfs_lstat"
12453 msgstr ""
12454
12455 #. type: verbatim
12456 #: ../src/guestfs-actions.pod:3754
12457 #, no-wrap
12458 msgid ""
12459 " struct guestfs_stat *\n"
12460 " guestfs_lstat (guestfs_h *g,\n"
12461 "                const char *path);\n"
12462 "\n"
12463 msgstr ""
12464
12465 #. type: textblock
12466 #: ../src/guestfs-actions.pod:3758 ../src/guestfs-actions.pod:6360
12467 #: ../fish/guestfish-actions.pod:2598 ../fish/guestfish-actions.pod:4311
12468 msgid "Returns file information for the given C<path>."
12469 msgstr ""
12470
12471 #. type: textblock
12472 #: ../src/guestfs-actions.pod:3760
12473 msgid ""
12474 "This is the same as C<guestfs_stat> except that if C<path> is a symbolic "
12475 "link, then the link is stat-ed, not the file it refers to."
12476 msgstr ""
12477
12478 #. type: textblock
12479 #: ../src/guestfs-actions.pod:3764 ../fish/guestfish-actions.pod:2604
12480 msgid "This is the same as the C<lstat(2)> system call."
12481 msgstr ""
12482
12483 #. type: textblock
12484 #: ../src/guestfs-actions.pod:3766 ../src/guestfs-actions.pod:6364
12485 msgid ""
12486 "This function returns a C<struct guestfs_stat *>, or NULL if there was an "
12487 "error.  I<The caller must call C<guestfs_free_stat> after use>."
12488 msgstr ""
12489
12490 #. type: textblock
12491 #: ../src/guestfs-actions.pod:3770 ../src/guestfs-actions.pod:6368
12492 #: ../src/guestfs-actions.pod:6386 ../src/guestfs-actions.pod:6767
12493 msgid "(Added in 0.9.2)"
12494 msgstr ""
12495
12496 #. type: =head2
12497 #: ../src/guestfs-actions.pod:3772
12498 msgid "guestfs_lstatlist"
12499 msgstr ""
12500
12501 #. type: verbatim
12502 #: ../src/guestfs-actions.pod:3774
12503 #, no-wrap
12504 msgid ""
12505 " struct guestfs_stat_list *\n"
12506 " guestfs_lstatlist (guestfs_h *g,\n"
12507 "                    const char *path,\n"
12508 "                    char *const *names);\n"
12509 "\n"
12510 msgstr ""
12511
12512 #. type: textblock
12513 #: ../src/guestfs-actions.pod:3779
12514 msgid ""
12515 "This call allows you to perform the C<guestfs_lstat> operation on multiple "
12516 "files, where all files are in the directory C<path>.  C<names> is the list "
12517 "of files from this directory."
12518 msgstr ""
12519
12520 #. type: textblock
12521 #: ../src/guestfs-actions.pod:3783 ../fish/guestfish-actions.pod:2614
12522 msgid ""
12523 "On return you get a list of stat structs, with a one-to-one correspondence "
12524 "to the C<names> list.  If any name did not exist or could not be lstat'd, "
12525 "then the C<ino> field of that structure is set to C<-1>."
12526 msgstr ""
12527
12528 #. type: textblock
12529 #: ../src/guestfs-actions.pod:3788
12530 msgid ""
12531 "This call is intended for programs that want to efficiently list a directory "
12532 "contents without making many round-trips.  See also C<guestfs_lxattrlist> "
12533 "for a similarly efficient call for getting extended attributes.  Very long "
12534 "directory listings might cause the protocol message size to be exceeded, "
12535 "causing this call to fail.  The caller must split up such requests into "
12536 "smaller groups of names."
12537 msgstr ""
12538
12539 #. type: textblock
12540 #: ../src/guestfs-actions.pod:3796
12541 msgid ""
12542 "This function returns a C<struct guestfs_stat_list *>, or NULL if there was "
12543 "an error.  I<The caller must call C<guestfs_free_stat_list> after use>."
12544 msgstr ""
12545
12546 #. type: =head2
12547 #: ../src/guestfs-actions.pod:3802
12548 msgid "guestfs_luks_add_key"
12549 msgstr ""
12550
12551 #. type: verbatim
12552 #: ../src/guestfs-actions.pod:3804
12553 #, no-wrap
12554 msgid ""
12555 " int\n"
12556 " guestfs_luks_add_key (guestfs_h *g,\n"
12557 "                       const char *device,\n"
12558 "                       const char *key,\n"
12559 "                       const char *newkey,\n"
12560 "                       int keyslot);\n"
12561 "\n"
12562 msgstr ""
12563
12564 #. type: textblock
12565 #: ../src/guestfs-actions.pod:3811 ../fish/guestfish-actions.pod:2631
12566 msgid ""
12567 "This command adds a new key on LUKS device C<device>.  C<key> is any "
12568 "existing key, and is used to access the device.  C<newkey> is the new key to "
12569 "add.  C<keyslot> is the key slot that will be replaced."
12570 msgstr ""
12571
12572 #. type: textblock
12573 #: ../src/guestfs-actions.pod:3816
12574 msgid ""
12575 "Note that if C<keyslot> already contains a key, then this command will "
12576 "fail.  You have to use C<guestfs_luks_kill_slot> first to remove that key."
12577 msgstr ""
12578
12579 #. type: textblock
12580 #: ../src/guestfs-actions.pod:3822 ../src/guestfs-actions.pod:3862
12581 #: ../src/guestfs-actions.pod:3885 ../src/guestfs-actions.pod:3905
12582 #: ../src/guestfs-actions.pod:3937 ../src/guestfs-actions.pod:3956
12583 msgid ""
12584 "This function takes a key or passphrase parameter which could contain "
12585 "sensitive material.  Read the section L</KEYS AND PASSPHRASES> for more "
12586 "information."
12587 msgstr ""
12588
12589 #. type: textblock
12590 #: ../src/guestfs-actions.pod:3826 ../src/guestfs-actions.pod:3866
12591 #: ../src/guestfs-actions.pod:3889 ../src/guestfs-actions.pod:3909
12592 msgid "(Added in 1.5.2)"
12593 msgstr ""
12594
12595 #. type: =head2
12596 #: ../src/guestfs-actions.pod:3828
12597 msgid "guestfs_luks_close"
12598 msgstr ""
12599
12600 #. type: verbatim
12601 #: ../src/guestfs-actions.pod:3830
12602 #, no-wrap
12603 msgid ""
12604 " int\n"
12605 " guestfs_luks_close (guestfs_h *g,\n"
12606 "                     const char *device);\n"
12607 "\n"
12608 msgstr ""
12609
12610 #. type: textblock
12611 #: ../src/guestfs-actions.pod:3834
12612 msgid ""
12613 "This closes a LUKS device that was created earlier by C<guestfs_luks_open> "
12614 "or C<guestfs_luks_open_ro>.  The C<device> parameter must be the name of the "
12615 "LUKS mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the "
12616 "underlying block device."
12617 msgstr ""
12618
12619 #. type: textblock
12620 #: ../src/guestfs-actions.pod:3842 ../src/guestfs-actions.pod:3941
12621 #: ../src/guestfs-actions.pod:3960 ../src/guestfs-actions.pod:4010
12622 #: ../src/guestfs-actions.pod:4058
12623 msgid "(Added in 1.5.1)"
12624 msgstr ""
12625
12626 #. type: =head2
12627 #: ../src/guestfs-actions.pod:3844
12628 msgid "guestfs_luks_format"
12629 msgstr ""
12630
12631 #. type: verbatim
12632 #: ../src/guestfs-actions.pod:3846
12633 #, no-wrap
12634 msgid ""
12635 " int\n"
12636 " guestfs_luks_format (guestfs_h *g,\n"
12637 "                      const char *device,\n"
12638 "                      const char *key,\n"
12639 "                      int keyslot);\n"
12640 "\n"
12641 msgstr ""
12642
12643 #. type: textblock
12644 #: ../src/guestfs-actions.pod:3852 ../fish/guestfish-actions.pod:2657
12645 msgid ""
12646 "This command erases existing data on C<device> and formats the device as a "
12647 "LUKS encrypted device.  C<key> is the initial key, which is added to key "
12648 "slot C<slot>.  (LUKS supports 8 key slots, numbered 0-7)."
12649 msgstr ""
12650
12651 #. type: textblock
12652 #: ../src/guestfs-actions.pod:3859 ../src/guestfs-actions.pod:3882
12653 #: ../src/guestfs-actions.pod:4022 ../src/guestfs-actions.pod:4980
12654 #: ../src/guestfs-actions.pod:5760 ../src/guestfs-actions.pod:6167
12655 #: ../src/guestfs-actions.pod:6197 ../src/guestfs-actions.pod:6230
12656 #: ../src/guestfs-actions.pod:7411 ../fish/guestfish-actions.pod:2665
12657 #: ../fish/guestfish-actions.pod:2678 ../fish/guestfish-actions.pod:2762
12658 #: ../fish/guestfish-actions.pod:3352 ../fish/guestfish-actions.pod:3872
12659 #: ../fish/guestfish-actions.pod:4182 ../fish/guestfish-actions.pod:4205
12660 #: ../fish/guestfish-actions.pod:4227 ../fish/guestfish-actions.pod:4956
12661 msgid ""
12662 "B<This command is dangerous.  Without careful use you can easily destroy all "
12663 "your data>."
12664 msgstr ""
12665
12666 #. type: =head2
12667 #: ../src/guestfs-actions.pod:3868
12668 msgid "guestfs_luks_format_cipher"
12669 msgstr ""
12670
12671 #. type: verbatim
12672 #: ../src/guestfs-actions.pod:3870
12673 #, no-wrap
12674 msgid ""
12675 " int\n"
12676 " guestfs_luks_format_cipher (guestfs_h *g,\n"
12677 "                             const char *device,\n"
12678 "                             const char *key,\n"
12679 "                             int keyslot,\n"
12680 "                             const char *cipher);\n"
12681 "\n"
12682 msgstr ""
12683
12684 #. type: textblock
12685 #: ../src/guestfs-actions.pod:3877
12686 msgid ""
12687 "This command is the same as C<guestfs_luks_format> but it also allows you to "
12688 "set the C<cipher> used."
12689 msgstr ""
12690
12691 #. type: =head2
12692 #: ../src/guestfs-actions.pod:3891
12693 msgid "guestfs_luks_kill_slot"
12694 msgstr ""
12695
12696 #. type: verbatim
12697 #: ../src/guestfs-actions.pod:3893
12698 #, no-wrap
12699 msgid ""
12700 " int\n"
12701 " guestfs_luks_kill_slot (guestfs_h *g,\n"
12702 "                         const char *device,\n"
12703 "                         const char *key,\n"
12704 "                         int keyslot);\n"
12705 "\n"
12706 msgstr ""
12707
12708 #. type: textblock
12709 #: ../src/guestfs-actions.pod:3899 ../fish/guestfish-actions.pod:2685
12710 msgid ""
12711 "This command deletes the key in key slot C<keyslot> from the encrypted LUKS "
12712 "device C<device>.  C<key> must be one of the I<other> keys."
12713 msgstr ""
12714
12715 #. type: =head2
12716 #: ../src/guestfs-actions.pod:3911
12717 msgid "guestfs_luks_open"
12718 msgstr ""
12719
12720 #. type: verbatim
12721 #: ../src/guestfs-actions.pod:3913
12722 #, no-wrap
12723 msgid ""
12724 " int\n"
12725 " guestfs_luks_open (guestfs_h *g,\n"
12726 "                    const char *device,\n"
12727 "                    const char *key,\n"
12728 "                    const char *mapname);\n"
12729 "\n"
12730 msgstr ""
12731
12732 #. type: textblock
12733 #: ../src/guestfs-actions.pod:3919 ../fish/guestfish-actions.pod:2696
12734 msgid ""
12735 "This command opens a block device which has been encrypted according to the "
12736 "Linux Unified Key Setup (LUKS) standard."
12737 msgstr ""
12738
12739 #. type: textblock
12740 #: ../src/guestfs-actions.pod:3922 ../fish/guestfish-actions.pod:2699
12741 msgid "C<device> is the encrypted block device or partition."
12742 msgstr ""
12743
12744 #. type: textblock
12745 #: ../src/guestfs-actions.pod:3924 ../fish/guestfish-actions.pod:2701
12746 msgid ""
12747 "The caller must supply one of the keys associated with the LUKS block "
12748 "device, in the C<key> parameter."
12749 msgstr ""
12750
12751 #. type: textblock
12752 #: ../src/guestfs-actions.pod:3927 ../fish/guestfish-actions.pod:2704
12753 msgid ""
12754 "This creates a new block device called C</dev/mapper/mapname>.  Reads and "
12755 "writes to this block device are decrypted from and encrypted to the "
12756 "underlying C<device> respectively."
12757 msgstr ""
12758
12759 #. type: textblock
12760 #: ../src/guestfs-actions.pod:3931
12761 msgid ""
12762 "If this block device contains LVM volume groups, then calling "
12763 "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them "
12764 "visible."
12765 msgstr ""
12766
12767 #. type: =head2
12768 #: ../src/guestfs-actions.pod:3943
12769 msgid "guestfs_luks_open_ro"
12770 msgstr ""
12771
12772 #. type: verbatim
12773 #: ../src/guestfs-actions.pod:3945
12774 #, no-wrap
12775 msgid ""
12776 " int\n"
12777 " guestfs_luks_open_ro (guestfs_h *g,\n"
12778 "                       const char *device,\n"
12779 "                       const char *key,\n"
12780 "                       const char *mapname);\n"
12781 "\n"
12782 msgstr ""
12783
12784 #. type: textblock
12785 #: ../src/guestfs-actions.pod:3951
12786 msgid ""
12787 "This is the same as C<guestfs_luks_open> except that a read-only mapping is "
12788 "created."
12789 msgstr ""
12790
12791 #. type: =head2
12792 #: ../src/guestfs-actions.pod:3962
12793 msgid "guestfs_lvcreate"
12794 msgstr ""
12795
12796 #. type: verbatim
12797 #: ../src/guestfs-actions.pod:3964
12798 #, no-wrap
12799 msgid ""
12800 " int\n"
12801 " guestfs_lvcreate (guestfs_h *g,\n"
12802 "                   const char *logvol,\n"
12803 "                   const char *volgroup,\n"
12804 "                   int mbytes);\n"
12805 "\n"
12806 msgstr ""
12807
12808 #. type: textblock
12809 #: ../src/guestfs-actions.pod:3970 ../fish/guestfish-actions.pod:2729
12810 msgid ""
12811 "This creates an LVM logical volume called C<logvol> on the volume group "
12812 "C<volgroup>, with C<size> megabytes."
12813 msgstr ""
12814
12815 #. type: =head2
12816 #: ../src/guestfs-actions.pod:3977
12817 msgid "guestfs_lvm_canonical_lv_name"
12818 msgstr ""
12819
12820 #. type: verbatim
12821 #: ../src/guestfs-actions.pod:3979
12822 #, no-wrap
12823 msgid ""
12824 " char *\n"
12825 " guestfs_lvm_canonical_lv_name (guestfs_h *g,\n"
12826 "                                const char *lvname);\n"
12827 "\n"
12828 msgstr ""
12829
12830 #. type: textblock
12831 #: ../src/guestfs-actions.pod:3983 ../fish/guestfish-actions.pod:2736
12832 msgid ""
12833 "This converts alternative naming schemes for LVs that you might find to the "
12834 "canonical name.  For example, C</dev/mapper/VG-LV> is converted to C</dev/VG/"
12835 "LV>."
12836 msgstr ""
12837
12838 #. type: textblock
12839 #: ../src/guestfs-actions.pod:3987 ../fish/guestfish-actions.pod:2740
12840 msgid ""
12841 "This command returns an error if the C<lvname> parameter does not refer to a "
12842 "logical volume."
12843 msgstr ""
12844
12845 #. type: textblock
12846 #: ../src/guestfs-actions.pod:3990
12847 msgid "See also C<guestfs_is_lv>."
12848 msgstr ""
12849
12850 #. type: textblock
12851 #: ../src/guestfs-actions.pod:3995
12852 msgid "(Added in 1.5.24)"
12853 msgstr ""
12854
12855 #. type: =head2
12856 #: ../src/guestfs-actions.pod:3997
12857 msgid "guestfs_lvm_clear_filter"
12858 msgstr ""
12859
12860 #. type: verbatim
12861 #: ../src/guestfs-actions.pod:3999
12862 #, no-wrap
12863 msgid ""
12864 " int\n"
12865 " guestfs_lvm_clear_filter (guestfs_h *g);\n"
12866 "\n"
12867 msgstr ""
12868
12869 #. type: textblock
12870 #: ../src/guestfs-actions.pod:4002
12871 msgid ""
12872 "This undoes the effect of C<guestfs_lvm_set_filter>.  LVM will be able to "
12873 "see every block device."
12874 msgstr ""
12875
12876 #. type: textblock
12877 #: ../src/guestfs-actions.pod:4005 ../src/guestfs-actions.pod:4047
12878 #: ../fish/guestfish-actions.pod:2752 ../fish/guestfish-actions.pod:2783
12879 msgid ""
12880 "This command also clears the LVM cache and performs a volume group scan."
12881 msgstr ""
12882
12883 #. type: =head2
12884 #: ../src/guestfs-actions.pod:4012
12885 msgid "guestfs_lvm_remove_all"
12886 msgstr ""
12887
12888 #. type: verbatim
12889 #: ../src/guestfs-actions.pod:4014
12890 #, no-wrap
12891 msgid ""
12892 " int\n"
12893 " guestfs_lvm_remove_all (guestfs_h *g);\n"
12894 "\n"
12895 msgstr ""
12896
12897 #. type: textblock
12898 #: ../src/guestfs-actions.pod:4017 ../fish/guestfish-actions.pod:2759
12899 msgid ""
12900 "This command removes all LVM logical volumes, volume groups and physical "
12901 "volumes."
12902 msgstr ""
12903
12904 #. type: =head2
12905 #: ../src/guestfs-actions.pod:4027
12906 msgid "guestfs_lvm_set_filter"
12907 msgstr ""
12908
12909 #. type: verbatim
12910 #: ../src/guestfs-actions.pod:4029
12911 #, no-wrap
12912 msgid ""
12913 " int\n"
12914 " guestfs_lvm_set_filter (guestfs_h *g,\n"
12915 "                         char *const *devices);\n"
12916 "\n"
12917 msgstr ""
12918
12919 #. type: textblock
12920 #: ../src/guestfs-actions.pod:4033 ../fish/guestfish-actions.pod:2769
12921 msgid ""
12922 "This sets the LVM device filter so that LVM will only be able to \"see\" the "
12923 "block devices in the list C<devices>, and will ignore all other attached "
12924 "block devices."
12925 msgstr ""
12926
12927 #. type: textblock
12928 #: ../src/guestfs-actions.pod:4037 ../fish/guestfish-actions.pod:2773
12929 msgid ""
12930 "Where disk image(s) contain duplicate PVs or VGs, this command is useful to "
12931 "get LVM to ignore the duplicates, otherwise LVM can get confused.  Note also "
12932 "there are two types of duplication possible: either cloned PVs/VGs which "
12933 "have identical UUIDs; or VGs that are not cloned but just happen to have the "
12934 "same name.  In normal operation you cannot create this situation, but you "
12935 "can do it outside LVM, eg.  by cloning disk images or by bit twiddling "
12936 "inside the LVM metadata."
12937 msgstr ""
12938
12939 #. type: textblock
12940 #: ../src/guestfs-actions.pod:4050 ../fish/guestfish-actions.pod:2786
12941 msgid "You can filter whole block devices or individual partitions."
12942 msgstr ""
12943
12944 #. type: textblock
12945 #: ../src/guestfs-actions.pod:4052 ../fish/guestfish-actions.pod:2788
12946 msgid ""
12947 "You cannot use this if any VG is currently in use (eg.  contains a mounted "
12948 "filesystem), even if you are not filtering out that VG."
12949 msgstr ""
12950
12951 #. type: =head2
12952 #: ../src/guestfs-actions.pod:4060
12953 msgid "guestfs_lvremove"
12954 msgstr ""
12955
12956 #. type: verbatim
12957 #: ../src/guestfs-actions.pod:4062
12958 #, no-wrap
12959 msgid ""
12960 " int\n"
12961 " guestfs_lvremove (guestfs_h *g,\n"
12962 "                   const char *device);\n"
12963 "\n"
12964 msgstr ""
12965
12966 #. type: textblock
12967 #: ../src/guestfs-actions.pod:4066 ../fish/guestfish-actions.pod:2796
12968 msgid ""
12969 "Remove an LVM logical volume C<device>, where C<device> is the path to the "
12970 "LV, such as C</dev/VG/LV>."
12971 msgstr ""
12972
12973 #. type: textblock
12974 #: ../src/guestfs-actions.pod:4069 ../fish/guestfish-actions.pod:2799
12975 msgid ""
12976 "You can also remove all LVs in a volume group by specifying the VG name, C</"
12977 "dev/VG>."
12978 msgstr ""
12979
12980 #. type: textblock
12981 #: ../src/guestfs-actions.pod:4074 ../src/guestfs-actions.pod:5326
12982 #: ../src/guestfs-actions.pod:7143
12983 msgid "(Added in 1.0.13)"
12984 msgstr ""
12985
12986 #. type: =head2
12987 #: ../src/guestfs-actions.pod:4076
12988 msgid "guestfs_lvrename"
12989 msgstr ""
12990
12991 #. type: verbatim
12992 #: ../src/guestfs-actions.pod:4078
12993 #, no-wrap
12994 msgid ""
12995 " int\n"
12996 " guestfs_lvrename (guestfs_h *g,\n"
12997 "                   const char *logvol,\n"
12998 "                   const char *newlogvol);\n"
12999 "\n"
13000 msgstr ""
13001
13002 #. type: textblock
13003 #: ../src/guestfs-actions.pod:4083 ../fish/guestfish-actions.pod:2806
13004 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>."
13005 msgstr ""
13006
13007 #. type: textblock
13008 #: ../src/guestfs-actions.pod:4087 ../src/guestfs-actions.pod:7156
13009 msgid "(Added in 1.0.83)"
13010 msgstr ""
13011
13012 #. type: =head2
13013 #: ../src/guestfs-actions.pod:4089
13014 msgid "guestfs_lvresize"
13015 msgstr ""
13016
13017 #. type: verbatim
13018 #: ../src/guestfs-actions.pod:4091
13019 #, no-wrap
13020 msgid ""
13021 " int\n"
13022 " guestfs_lvresize (guestfs_h *g,\n"
13023 "                   const char *device,\n"
13024 "                   int mbytes);\n"
13025 "\n"
13026 msgstr ""
13027
13028 #. type: textblock
13029 #: ../src/guestfs-actions.pod:4096 ../fish/guestfish-actions.pod:2812
13030 msgid ""
13031 "This resizes (expands or shrinks) an existing LVM logical volume to "
13032 "C<mbytes>.  When reducing, data in the reduced part is lost."
13033 msgstr ""
13034
13035 #. type: =head2
13036 #: ../src/guestfs-actions.pod:4104
13037 msgid "guestfs_lvresize_free"
13038 msgstr ""
13039
13040 #. type: verbatim
13041 #: ../src/guestfs-actions.pod:4106
13042 #, no-wrap
13043 msgid ""
13044 " int\n"
13045 " guestfs_lvresize_free (guestfs_h *g,\n"
13046 "                        const char *lv,\n"
13047 "                        int percent);\n"
13048 "\n"
13049 msgstr ""
13050
13051 #. type: textblock
13052 #: ../src/guestfs-actions.pod:4111 ../fish/guestfish-actions.pod:2820
13053 msgid ""
13054 "This expands an existing logical volume C<lv> so that it fills C<pc>% of the "
13055 "remaining free space in the volume group.  Commonly you would call this with "
13056 "pc = 100 which expands the logical volume as much as possible, using all "
13057 "remaining free space in the volume group."
13058 msgstr ""
13059
13060 #. type: textblock
13061 #: ../src/guestfs-actions.pod:4119
13062 msgid "(Added in 1.3.3)"
13063 msgstr ""
13064
13065 #. type: =head2
13066 #: ../src/guestfs-actions.pod:4121
13067 msgid "guestfs_lvs"
13068 msgstr ""
13069
13070 #. type: verbatim
13071 #: ../src/guestfs-actions.pod:4123
13072 #, no-wrap
13073 msgid ""
13074 " char **\n"
13075 " guestfs_lvs (guestfs_h *g);\n"
13076 "\n"
13077 msgstr ""
13078
13079 #. type: textblock
13080 #: ../src/guestfs-actions.pod:4126 ../fish/guestfish-actions.pod:2830
13081 msgid ""
13082 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
13083 "(8)> command."
13084 msgstr ""
13085
13086 #. type: textblock
13087 #: ../src/guestfs-actions.pod:4129 ../fish/guestfish-actions.pod:2833
13088 msgid ""
13089 "This returns a list of the logical volume device names (eg. C</dev/"
13090 "VolGroup00/LogVol00>)."
13091 msgstr ""
13092
13093 #. type: textblock
13094 #: ../src/guestfs-actions.pod:4132
13095 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>."
13096 msgstr ""
13097
13098 #. type: =head2
13099 #: ../src/guestfs-actions.pod:4140
13100 msgid "guestfs_lvs_full"
13101 msgstr ""
13102
13103 #. type: verbatim
13104 #: ../src/guestfs-actions.pod:4142
13105 #, no-wrap
13106 msgid ""
13107 " struct guestfs_lvm_lv_list *\n"
13108 " guestfs_lvs_full (guestfs_h *g);\n"
13109 "\n"
13110 msgstr ""
13111
13112 #. type: textblock
13113 #: ../src/guestfs-actions.pod:4145 ../fish/guestfish-actions.pod:2842
13114 msgid ""
13115 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
13116 "(8)> command.  The \"full\" version includes all fields."
13117 msgstr ""
13118
13119 #. type: textblock
13120 #: ../src/guestfs-actions.pod:4148
13121 msgid ""
13122 "This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there "
13123 "was an error.  I<The caller must call C<guestfs_free_lvm_lv_list> after use>."
13124 msgstr ""
13125
13126 #. type: =head2
13127 #: ../src/guestfs-actions.pod:4154
13128 msgid "guestfs_lvuuid"
13129 msgstr ""
13130
13131 #. type: verbatim
13132 #: ../src/guestfs-actions.pod:4156
13133 #, no-wrap
13134 msgid ""
13135 " char *\n"
13136 " guestfs_lvuuid (guestfs_h *g,\n"
13137 "                 const char *device);\n"
13138 "\n"
13139 msgstr ""
13140
13141 #. type: textblock
13142 #: ../src/guestfs-actions.pod:4160 ../fish/guestfish-actions.pod:2849
13143 msgid "This command returns the UUID of the LVM LV C<device>."
13144 msgstr ""
13145
13146 #. type: =head2
13147 #: ../src/guestfs-actions.pod:4167
13148 msgid "guestfs_lxattrlist"
13149 msgstr ""
13150
13151 #. type: verbatim
13152 #: ../src/guestfs-actions.pod:4169
13153 #, no-wrap
13154 msgid ""
13155 " struct guestfs_xattr_list *\n"
13156 " guestfs_lxattrlist (guestfs_h *g,\n"
13157 "                     const char *path,\n"
13158 "                     char *const *names);\n"
13159 "\n"
13160 msgstr ""
13161
13162 #. type: textblock
13163 #: ../src/guestfs-actions.pod:4174 ../fish/guestfish-actions.pod:2855
13164 msgid ""
13165 "This call allows you to get the extended attributes of multiple files, where "
13166 "all files are in the directory C<path>.  C<names> is the list of files from "
13167 "this directory."
13168 msgstr ""
13169
13170 #. type: textblock
13171 #: ../src/guestfs-actions.pod:4178 ../fish/guestfish-actions.pod:2859
13172 msgid ""
13173 "On return you get a flat list of xattr structs which must be interpreted "
13174 "sequentially.  The first xattr struct always has a zero-length C<attrname>.  "
13175 "C<attrval> in this struct is zero-length to indicate there was an error "
13176 "doing C<lgetxattr> for this file, I<or> is a C string which is a decimal "
13177 "number (the number of following attributes for this file, which could be C<"
13178 "\"0\">).  Then after the first xattr struct are the zero or more attributes "
13179 "for the first named file.  This repeats for the second and subsequent files."
13180 msgstr ""
13181
13182 #. type: textblock
13183 #: ../src/guestfs-actions.pod:4188
13184 msgid ""
13185 "This call is intended for programs that want to efficiently list a directory "
13186 "contents without making many round-trips.  See also C<guestfs_lstatlist> for "
13187 "a similarly efficient call for getting standard stats.  Very long directory "
13188 "listings might cause the protocol message size to be exceeded, causing this "
13189 "call to fail.  The caller must split up such requests into smaller groups of "
13190 "names."
13191 msgstr ""
13192
13193 #. type: =head2
13194 #: ../src/guestfs-actions.pod:4202
13195 msgid "guestfs_mkdir"
13196 msgstr ""
13197
13198 #. type: verbatim
13199 #: ../src/guestfs-actions.pod:4204
13200 #, no-wrap
13201 msgid ""
13202 " int\n"
13203 " guestfs_mkdir (guestfs_h *g,\n"
13204 "                const char *path);\n"
13205 "\n"
13206 msgstr ""
13207
13208 #. type: textblock
13209 #: ../src/guestfs-actions.pod:4208 ../fish/guestfish-actions.pod:2881
13210 msgid "Create a directory named C<path>."
13211 msgstr ""
13212
13213 #. type: =head2
13214 #: ../src/guestfs-actions.pod:4214
13215 msgid "guestfs_mkdir_mode"
13216 msgstr ""
13217
13218 #. type: verbatim
13219 #: ../src/guestfs-actions.pod:4216
13220 #, no-wrap
13221 msgid ""
13222 " int\n"
13223 " guestfs_mkdir_mode (guestfs_h *g,\n"
13224 "                     const char *path,\n"
13225 "                     int mode);\n"
13226 "\n"
13227 msgstr ""
13228
13229 #. type: textblock
13230 #: ../src/guestfs-actions.pod:4221 ../fish/guestfish-actions.pod:2887
13231 msgid ""
13232 "This command creates a directory, setting the initial permissions of the "
13233 "directory to C<mode>."
13234 msgstr ""
13235
13236 #. type: textblock
13237 #: ../src/guestfs-actions.pod:4224 ../fish/guestfish-actions.pod:2890
13238 msgid ""
13239 "For common Linux filesystems, the actual mode which is set will be C<mode & "
13240 "~umask & 01777>.  Non-native-Linux filesystems may interpret the mode in "
13241 "other ways."
13242 msgstr ""
13243
13244 #. type: textblock
13245 #: ../src/guestfs-actions.pod:4228
13246 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>"
13247 msgstr ""
13248
13249 #. type: =head2
13250 #: ../src/guestfs-actions.pod:4234
13251 msgid "guestfs_mkdir_p"
13252 msgstr ""
13253
13254 #. type: verbatim
13255 #: ../src/guestfs-actions.pod:4236
13256 #, no-wrap
13257 msgid ""
13258 " int\n"
13259 " guestfs_mkdir_p (guestfs_h *g,\n"
13260 "                  const char *path);\n"
13261 "\n"
13262 msgstr ""
13263
13264 #. type: textblock
13265 #: ../src/guestfs-actions.pod:4240 ../fish/guestfish-actions.pod:2900
13266 msgid ""
13267 "Create a directory named C<path>, creating any parent directories as "
13268 "necessary.  This is like the C<mkdir -p> shell command."
13269 msgstr ""
13270
13271 #. type: =head2
13272 #: ../src/guestfs-actions.pod:4247
13273 msgid "guestfs_mkdtemp"
13274 msgstr ""
13275
13276 #. type: verbatim
13277 #: ../src/guestfs-actions.pod:4249
13278 #, no-wrap
13279 msgid ""
13280 " char *\n"
13281 " guestfs_mkdtemp (guestfs_h *g,\n"
13282 "                  const char *template);\n"
13283 "\n"
13284 msgstr ""
13285
13286 #. type: textblock
13287 #: ../src/guestfs-actions.pod:4253 ../fish/guestfish-actions.pod:2907
13288 msgid ""
13289 "This command creates a temporary directory.  The C<template> parameter "
13290 "should be a full pathname for the temporary directory name with the final "
13291 "six characters being \"XXXXXX\"."
13292 msgstr ""
13293
13294 #. type: textblock
13295 #: ../src/guestfs-actions.pod:4258 ../fish/guestfish-actions.pod:2912
13296 msgid ""
13297 "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one "
13298 "being suitable for Windows filesystems."
13299 msgstr ""
13300
13301 #. type: textblock
13302 #: ../src/guestfs-actions.pod:4261 ../fish/guestfish-actions.pod:2915
13303 msgid "The name of the temporary directory that was created is returned."
13304 msgstr ""
13305
13306 #. type: textblock
13307 #: ../src/guestfs-actions.pod:4264 ../fish/guestfish-actions.pod:2918
13308 msgid "The temporary directory is created with mode 0700 and is owned by root."
13309 msgstr ""
13310
13311 #. type: textblock
13312 #: ../src/guestfs-actions.pod:4267 ../fish/guestfish-actions.pod:2921
13313 msgid ""
13314 "The caller is responsible for deleting the temporary directory and its "
13315 "contents after use."
13316 msgstr ""
13317
13318 #. type: textblock
13319 #: ../src/guestfs-actions.pod:4270 ../fish/guestfish-actions.pod:2924
13320 msgid "See also: L<mkdtemp(3)>"
13321 msgstr ""
13322
13323 #. type: =head2
13324 #: ../src/guestfs-actions.pod:4277
13325 msgid "guestfs_mke2fs_J"
13326 msgstr ""
13327
13328 #. type: verbatim
13329 #: ../src/guestfs-actions.pod:4279
13330 #, no-wrap
13331 msgid ""
13332 " int\n"
13333 " guestfs_mke2fs_J (guestfs_h *g,\n"
13334 "                   const char *fstype,\n"
13335 "                   int blocksize,\n"
13336 "                   const char *device,\n"
13337 "                   const char *journal);\n"
13338 "\n"
13339 msgstr ""
13340
13341 #. type: textblock
13342 #: ../src/guestfs-actions.pod:4286 ../fish/guestfish-actions.pod:2930
13343 msgid ""
13344 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
13345 "C<journal>.  It is equivalent to the command:"
13346 msgstr ""
13347
13348 #. type: verbatim
13349 #: ../src/guestfs-actions.pod:4290 ../fish/guestfish-actions.pod:2934
13350 #, no-wrap
13351 msgid ""
13352 " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n"
13353 "\n"
13354 msgstr ""
13355
13356 #. type: textblock
13357 #: ../src/guestfs-actions.pod:4292
13358 msgid "See also C<guestfs_mke2journal>."
13359 msgstr ""
13360
13361 #. type: textblock
13362 #: ../src/guestfs-actions.pod:4296 ../src/guestfs-actions.pod:4314
13363 #: ../src/guestfs-actions.pod:4332 ../src/guestfs-actions.pod:4348
13364 #: ../src/guestfs-actions.pod:4362 ../src/guestfs-actions.pod:4376
13365 #: ../src/guestfs-actions.pod:4435 ../src/guestfs-actions.pod:4700
13366 msgid "(Added in 1.0.68)"
13367 msgstr ""
13368
13369 #. type: =head2
13370 #: ../src/guestfs-actions.pod:4298
13371 msgid "guestfs_mke2fs_JL"
13372 msgstr ""
13373
13374 #. type: verbatim
13375 #: ../src/guestfs-actions.pod:4300
13376 #, no-wrap
13377 msgid ""
13378 " int\n"
13379 " guestfs_mke2fs_JL (guestfs_h *g,\n"
13380 "                    const char *fstype,\n"
13381 "                    int blocksize,\n"
13382 "                    const char *device,\n"
13383 "                    const char *label);\n"
13384 "\n"
13385 msgstr ""
13386
13387 #. type: textblock
13388 #: ../src/guestfs-actions.pod:4307 ../fish/guestfish-actions.pod:2942
13389 msgid ""
13390 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
13391 "the journal labeled C<label>."
13392 msgstr ""
13393
13394 #. type: textblock
13395 #: ../src/guestfs-actions.pod:4310
13396 msgid "See also C<guestfs_mke2journal_L>."
13397 msgstr ""
13398
13399 #. type: =head2
13400 #: ../src/guestfs-actions.pod:4316
13401 msgid "guestfs_mke2fs_JU"
13402 msgstr ""
13403
13404 #. type: verbatim
13405 #: ../src/guestfs-actions.pod:4318
13406 #, no-wrap
13407 msgid ""
13408 " int\n"
13409 " guestfs_mke2fs_JU (guestfs_h *g,\n"
13410 "                    const char *fstype,\n"
13411 "                    int blocksize,\n"
13412 "                    const char *device,\n"
13413 "                    const char *uuid);\n"
13414 "\n"
13415 msgstr ""
13416
13417 #. type: textblock
13418 #: ../src/guestfs-actions.pod:4325 ../fish/guestfish-actions.pod:2951
13419 msgid ""
13420 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
13421 "the journal with UUID C<uuid>."
13422 msgstr ""
13423
13424 #. type: textblock
13425 #: ../src/guestfs-actions.pod:4328
13426 msgid "See also C<guestfs_mke2journal_U>."
13427 msgstr ""
13428
13429 #. type: =head2
13430 #: ../src/guestfs-actions.pod:4334
13431 msgid "guestfs_mke2journal"
13432 msgstr ""
13433
13434 #. type: verbatim
13435 #: ../src/guestfs-actions.pod:4336
13436 #, no-wrap
13437 msgid ""
13438 " int\n"
13439 " guestfs_mke2journal (guestfs_h *g,\n"
13440 "                      int blocksize,\n"
13441 "                      const char *device);\n"
13442 "\n"
13443 msgstr ""
13444
13445 #. type: textblock
13446 #: ../src/guestfs-actions.pod:4341 ../fish/guestfish-actions.pod:2960
13447 msgid ""
13448 "This creates an ext2 external journal on C<device>.  It is equivalent to the "
13449 "command:"
13450 msgstr ""
13451
13452 #. type: verbatim
13453 #: ../src/guestfs-actions.pod:4344 ../fish/guestfish-actions.pod:2963
13454 #, no-wrap
13455 msgid ""
13456 " mke2fs -O journal_dev -b blocksize device\n"
13457 "\n"
13458 msgstr ""
13459
13460 #. type: =head2
13461 #: ../src/guestfs-actions.pod:4350
13462 msgid "guestfs_mke2journal_L"
13463 msgstr ""
13464
13465 #. type: verbatim
13466 #: ../src/guestfs-actions.pod:4352
13467 #, no-wrap
13468 msgid ""
13469 " int\n"
13470 " guestfs_mke2journal_L (guestfs_h *g,\n"
13471 "                        int blocksize,\n"
13472 "                        const char *label,\n"
13473 "                        const char *device);\n"
13474 "\n"
13475 msgstr ""
13476
13477 #. type: textblock
13478 #: ../src/guestfs-actions.pod:4358 ../fish/guestfish-actions.pod:2969
13479 msgid "This creates an ext2 external journal on C<device> with label C<label>."
13480 msgstr ""
13481
13482 #. type: =head2
13483 #: ../src/guestfs-actions.pod:4364
13484 msgid "guestfs_mke2journal_U"
13485 msgstr ""
13486
13487 #. type: verbatim
13488 #: ../src/guestfs-actions.pod:4366
13489 #, no-wrap
13490 msgid ""
13491 " int\n"
13492 " guestfs_mke2journal_U (guestfs_h *g,\n"
13493 "                        int blocksize,\n"
13494 "                        const char *uuid,\n"
13495 "                        const char *device);\n"
13496 "\n"
13497 msgstr ""
13498
13499 #. type: textblock
13500 #: ../src/guestfs-actions.pod:4372 ../fish/guestfish-actions.pod:2975
13501 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>."
13502 msgstr ""
13503
13504 #. type: =head2
13505 #: ../src/guestfs-actions.pod:4378
13506 msgid "guestfs_mkfifo"
13507 msgstr ""
13508
13509 #. type: verbatim
13510 #: ../src/guestfs-actions.pod:4380
13511 #, no-wrap
13512 msgid ""
13513 " int\n"
13514 " guestfs_mkfifo (guestfs_h *g,\n"
13515 "                 int mode,\n"
13516 "                 const char *path);\n"
13517 "\n"
13518 msgstr ""
13519
13520 #. type: textblock
13521 #: ../src/guestfs-actions.pod:4385
13522 msgid ""
13523 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
13524 "is just a convenient wrapper around C<guestfs_mknod>."
13525 msgstr ""
13526
13527 #. type: =head2
13528 #: ../src/guestfs-actions.pod:4395
13529 msgid "guestfs_mkfs"
13530 msgstr ""
13531
13532 #. type: verbatim
13533 #: ../src/guestfs-actions.pod:4397
13534 #, no-wrap
13535 msgid ""
13536 " int\n"
13537 " guestfs_mkfs (guestfs_h *g,\n"
13538 "               const char *fstype,\n"
13539 "               const char *device);\n"
13540 "\n"
13541 msgstr ""
13542
13543 #. type: textblock
13544 #: ../src/guestfs-actions.pod:4402 ../fish/guestfish-actions.pod:2991
13545 msgid ""
13546 "This creates a filesystem on C<device> (usually a partition or LVM logical "
13547 "volume).  The filesystem type is C<fstype>, for example C<ext3>."
13548 msgstr ""
13549
13550 #. type: =head2
13551 #: ../src/guestfs-actions.pod:4410
13552 msgid "guestfs_mkfs_b"
13553 msgstr ""
13554
13555 #. type: verbatim
13556 #: ../src/guestfs-actions.pod:4412
13557 #, no-wrap
13558 msgid ""
13559 " int\n"
13560 " guestfs_mkfs_b (guestfs_h *g,\n"
13561 "                 const char *fstype,\n"
13562 "                 int blocksize,\n"
13563 "                 const char *device);\n"
13564 "\n"
13565 msgstr ""
13566
13567 #. type: textblock
13568 #: ../src/guestfs-actions.pod:4418
13569 msgid ""
13570 "This call is similar to C<guestfs_mkfs>, but it allows you to control the "
13571 "block size of the resulting filesystem.  Supported block sizes depend on the "
13572 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
13573 msgstr ""
13574
13575 #. type: textblock
13576 #: ../src/guestfs-actions.pod:4423 ../src/guestfs-actions.pod:4466
13577 #: ../fish/guestfish-actions.pod:3004 ../fish/guestfish-actions.pod:3031
13578 msgid ""
13579 "For VFAT and NTFS the C<blocksize> parameter is treated as the requested "
13580 "cluster size."
13581 msgstr ""
13582
13583 #. type: textblock
13584 #: ../src/guestfs-actions.pod:4428
13585 msgid ""
13586 "This function is deprecated.  In new code, use the L</guestfs_mkfs_opts> "
13587 "call instead."
13588 msgstr ""
13589
13590 #. type: =head2
13591 #: ../src/guestfs-actions.pod:4437
13592 msgid "guestfs_mkfs_opts"
13593 msgstr ""
13594
13595 #. type: verbatim
13596 #: ../src/guestfs-actions.pod:4439
13597 #, no-wrap
13598 msgid ""
13599 " int\n"
13600 " guestfs_mkfs_opts (guestfs_h *g,\n"
13601 "                    const char *fstype,\n"
13602 "                    const char *device,\n"
13603 "                    ...);\n"
13604 "\n"
13605 msgstr ""
13606
13607 #. type: verbatim
13608 #: ../src/guestfs-actions.pod:4450
13609 #, no-wrap
13610 msgid ""
13611 " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n"
13612 " GUESTFS_MKFS_OPTS_FEATURES, const char *features,\n"
13613 "\n"
13614 msgstr ""
13615
13616 #. type: textblock
13617 #: ../src/guestfs-actions.pod:4453 ../fish/guestfish-actions.pod:3018
13618 msgid ""
13619 "This function creates a filesystem on C<device>.  The filesystem type is "
13620 "C<fstype>, for example C<ext3>."
13621 msgstr ""
13622
13623 #. type: =item
13624 #: ../src/guestfs-actions.pod:4460 ../fish/guestfish-actions.pod:3025
13625 msgid "C<blocksize>"
13626 msgstr ""
13627
13628 #. type: textblock
13629 #: ../src/guestfs-actions.pod:4462 ../fish/guestfish-actions.pod:3027
13630 msgid ""
13631 "The filesystem block size.  Supported block sizes depend on the filesystem "
13632 "type, but typically they are C<1024>, C<2048> or C<4096> for Linux ext2/3 "
13633 "filesystems."
13634 msgstr ""
13635
13636 #. type: textblock
13637 #: ../src/guestfs-actions.pod:4469 ../fish/guestfish-actions.pod:3034
13638 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>."
13639 msgstr ""
13640
13641 #. type: =item
13642 #: ../src/guestfs-actions.pod:4471 ../fish/guestfish-actions.pod:3036
13643 msgid "C<features>"
13644 msgstr ""
13645
13646 #. type: textblock
13647 #: ../src/guestfs-actions.pod:4473 ../fish/guestfish-actions.pod:3038
13648 msgid "This passes the I<-O> parameter to the external mkfs program."
13649 msgstr ""
13650
13651 #. type: textblock
13652 #: ../src/guestfs-actions.pod:4475 ../fish/guestfish-actions.pod:3040
13653 msgid ""
13654 "For certain filesystem types, this allows extra filesystem features to be "
13655 "selected.  See L<mke2fs(8)> and L<mkfs.ufs(8)> for more details."
13656 msgstr ""
13657
13658 #. type: textblock
13659 #: ../src/guestfs-actions.pod:4479 ../fish/guestfish-actions.pod:3044
13660 msgid ""
13661 "You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem "
13662 "type."
13663 msgstr ""
13664
13665 #. type: textblock
13666 #: ../src/guestfs-actions.pod:4486
13667 msgid "(Added in 1.7.19)"
13668 msgstr ""
13669
13670 #. type: =head2
13671 #: ../src/guestfs-actions.pod:4488
13672 msgid "guestfs_mkfs_opts_va"
13673 msgstr ""
13674
13675 #. type: verbatim
13676 #: ../src/guestfs-actions.pod:4490
13677 #, no-wrap
13678 msgid ""
13679 " int\n"
13680 " guestfs_mkfs_opts_va (guestfs_h *g,\n"
13681 "                       const char *fstype,\n"
13682 "                       const char *device,\n"
13683 "                       va_list args);\n"
13684 "\n"
13685 msgstr ""
13686
13687 #. type: textblock
13688 #: ../src/guestfs-actions.pod:4496
13689 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>."
13690 msgstr ""
13691
13692 #. type: =head2
13693 #: ../src/guestfs-actions.pod:4500
13694 msgid "guestfs_mkfs_opts_argv"
13695 msgstr ""
13696
13697 #. type: verbatim
13698 #: ../src/guestfs-actions.pod:4502
13699 #, no-wrap
13700 msgid ""
13701 " int\n"
13702 " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
13703 "                         const char *fstype,\n"
13704 "                         const char *device,\n"
13705 "                         const struct guestfs_mkfs_opts_argv *optargs);\n"
13706 "\n"
13707 msgstr ""
13708
13709 #. type: textblock
13710 #: ../src/guestfs-actions.pod:4508
13711 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>."
13712 msgstr ""
13713
13714 #. type: =head2
13715 #: ../src/guestfs-actions.pod:4512
13716 msgid "guestfs_mkmountpoint"
13717 msgstr ""
13718
13719 #. type: verbatim
13720 #: ../src/guestfs-actions.pod:4514
13721 #, no-wrap
13722 msgid ""
13723 " int\n"
13724 " guestfs_mkmountpoint (guestfs_h *g,\n"
13725 "                       const char *exemptpath);\n"
13726 "\n"
13727 msgstr ""
13728
13729 #. type: textblock
13730 #: ../src/guestfs-actions.pod:4518
13731 msgid ""
13732 "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls "
13733 "that can be used to create extra mountpoints before mounting the first "
13734 "filesystem."
13735 msgstr ""
13736
13737 #. type: textblock
13738 #: ../src/guestfs-actions.pod:4522 ../fish/guestfish-actions.pod:3059
13739 msgid ""
13740 "These calls are I<only> necessary in some very limited circumstances, mainly "
13741 "the case where you want to mount a mix of unrelated and/or read-only "
13742 "filesystems together."
13743 msgstr ""
13744
13745 #. type: textblock
13746 #: ../src/guestfs-actions.pod:4526 ../fish/guestfish-actions.pod:3063
13747 msgid ""
13748 "For example, live CDs often contain a \"Russian doll\" nest of filesystems, "
13749 "an ISO outer layer, with a squashfs image inside, with an ext2/3 image "
13750 "inside that.  You can unpack this as follows in guestfish:"
13751 msgstr ""
13752
13753 #. type: verbatim
13754 #: ../src/guestfs-actions.pod:4531 ../fish/guestfish-actions.pod:3068
13755 #, no-wrap
13756 msgid ""
13757 " add-ro Fedora-11-i686-Live.iso\n"
13758 " run\n"
13759 " mkmountpoint /cd\n"
13760 " mkmountpoint /sqsh\n"
13761 " mkmountpoint /ext3fs\n"
13762 " mount /dev/sda /cd\n"
13763 " mount-loop /cd/LiveOS/squashfs.img /sqsh\n"
13764 " mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs\n"
13765 "\n"
13766 msgstr ""
13767
13768 #. type: textblock
13769 #: ../src/guestfs-actions.pod:4540 ../fish/guestfish-actions.pod:3077
13770 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint."
13771 msgstr ""
13772
13773 #. type: textblock
13774 #: ../src/guestfs-actions.pod:4542
13775 msgid ""
13776 "C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>.  You "
13777 "may get unexpected errors if you try to mix these calls.  It is safest to "
13778 "manually unmount filesystems and remove mountpoints after use."
13779 msgstr ""
13780
13781 #. type: textblock
13782 #: ../src/guestfs-actions.pod:4546
13783 msgid ""
13784 "C<guestfs_umount_all> unmounts filesystems by sorting the paths longest "
13785 "first, so for this to work for manual mountpoints, you must ensure that the "
13786 "innermost mountpoints have the longest pathnames, as in the example code "
13787 "above."
13788 msgstr ""
13789
13790 #. type: textblock
13791 #: ../src/guestfs-actions.pod:4551 ../fish/guestfish-actions.pod:3088
13792 msgid ""
13793 "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>"
13794 msgstr ""
13795
13796 #. type: textblock
13797 #: ../src/guestfs-actions.pod:4553
13798 msgid ""
13799 "Autosync [see C<guestfs_set_autosync>, this is set by default on handles] "
13800 "can cause C<guestfs_umount_all> to be called when the handle is closed which "
13801 "can also trigger these issues."
13802 msgstr ""
13803
13804 #. type: textblock
13805 #: ../src/guestfs-actions.pod:4559 ../src/guestfs-actions.pod:4825
13806 #: ../src/guestfs-actions.pod:5744
13807 msgid "(Added in 1.0.62)"
13808 msgstr ""
13809
13810 #. type: =head2
13811 #: ../src/guestfs-actions.pod:4561
13812 msgid "guestfs_mknod"
13813 msgstr ""
13814
13815 #. type: verbatim
13816 #: ../src/guestfs-actions.pod:4563
13817 #, no-wrap
13818 msgid ""
13819 " int\n"
13820 " guestfs_mknod (guestfs_h *g,\n"
13821 "                int mode,\n"
13822 "                int devmajor,\n"
13823 "                int devminor,\n"
13824 "                const char *path);\n"
13825 "\n"
13826 msgstr ""
13827
13828 #. type: textblock
13829 #: ../src/guestfs-actions.pod:4570 ../fish/guestfish-actions.pod:3098
13830 msgid ""
13831 "This call creates block or character special devices, or named pipes (FIFOs)."
13832 msgstr ""
13833
13834 #. type: textblock
13835 #: ../src/guestfs-actions.pod:4573 ../fish/guestfish-actions.pod:3101
13836 msgid ""
13837 "The C<mode> parameter should be the mode, using the standard constants.  "
13838 "C<devmajor> and C<devminor> are the device major and minor numbers, only "
13839 "used when creating block and character special devices."
13840 msgstr ""
13841
13842 #. type: textblock
13843 #: ../src/guestfs-actions.pod:4578
13844 msgid ""
13845 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
13846 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
13847 "regular file).  These constants are available in the standard Linux header "
13848 "files, or you can use C<guestfs_mknod_b>, C<guestfs_mknod_c> or "
13849 "C<guestfs_mkfifo> which are wrappers around this command which bitwise OR in "
13850 "the appropriate constant for you."
13851 msgstr ""
13852
13853 #. type: =head2
13854 #: ../src/guestfs-actions.pod:4592
13855 msgid "guestfs_mknod_b"
13856 msgstr ""
13857
13858 #. type: verbatim
13859 #: ../src/guestfs-actions.pod:4594
13860 #, no-wrap
13861 msgid ""
13862 " int\n"
13863 " guestfs_mknod_b (guestfs_h *g,\n"
13864 "                  int mode,\n"
13865 "                  int devmajor,\n"
13866 "                  int devminor,\n"
13867 "                  const char *path);\n"
13868 "\n"
13869 msgstr ""
13870
13871 #. type: textblock
13872 #: ../src/guestfs-actions.pod:4601
13873 msgid ""
13874 "This call creates a block device node called C<path> with mode C<mode> and "
13875 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
13876 "wrapper around C<guestfs_mknod>."
13877 msgstr ""
13878
13879 #. type: =head2
13880 #: ../src/guestfs-actions.pod:4611
13881 msgid "guestfs_mknod_c"
13882 msgstr ""
13883
13884 #. type: verbatim
13885 #: ../src/guestfs-actions.pod:4613
13886 #, no-wrap
13887 msgid ""
13888 " int\n"
13889 " guestfs_mknod_c (guestfs_h *g,\n"
13890 "                  int mode,\n"
13891 "                  int devmajor,\n"
13892 "                  int devminor,\n"
13893 "                  const char *path);\n"
13894 "\n"
13895 msgstr ""
13896
13897 #. type: textblock
13898 #: ../src/guestfs-actions.pod:4620
13899 msgid ""
13900 "This call creates a char device node called C<path> with mode C<mode> and "
13901 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
13902 "wrapper around C<guestfs_mknod>."
13903 msgstr ""
13904
13905 #. type: =head2
13906 #: ../src/guestfs-actions.pod:4630
13907 msgid "guestfs_mkswap"
13908 msgstr ""
13909
13910 #. type: verbatim
13911 #: ../src/guestfs-actions.pod:4632
13912 #, no-wrap
13913 msgid ""
13914 " int\n"
13915 " guestfs_mkswap (guestfs_h *g,\n"
13916 "                 const char *device);\n"
13917 "\n"
13918 msgstr ""
13919
13920 #. type: textblock
13921 #: ../src/guestfs-actions.pod:4636 ../fish/guestfish-actions.pod:3140
13922 msgid "Create a swap partition on C<device>."
13923 msgstr ""
13924
13925 #. type: =head2
13926 #: ../src/guestfs-actions.pod:4642
13927 msgid "guestfs_mkswap_L"
13928 msgstr ""
13929
13930 #. type: verbatim
13931 #: ../src/guestfs-actions.pod:4644
13932 #, no-wrap
13933 msgid ""
13934 " int\n"
13935 " guestfs_mkswap_L (guestfs_h *g,\n"
13936 "                   const char *label,\n"
13937 "                   const char *device);\n"
13938 "\n"
13939 msgstr ""
13940
13941 #. type: textblock
13942 #: ../src/guestfs-actions.pod:4649 ../fish/guestfish-actions.pod:3146
13943 msgid "Create a swap partition on C<device> with label C<label>."
13944 msgstr ""
13945
13946 #. type: textblock
13947 #: ../src/guestfs-actions.pod:4651 ../fish/guestfish-actions.pod:3148
13948 msgid ""
13949 "Note that you cannot attach a swap label to a block device (eg. C</dev/"
13950 "sda>), just to a partition.  This appears to be a limitation of the kernel "
13951 "or swap tools."
13952 msgstr ""
13953
13954 #. type: =head2
13955 #: ../src/guestfs-actions.pod:4659
13956 msgid "guestfs_mkswap_U"
13957 msgstr ""
13958
13959 #. type: verbatim
13960 #: ../src/guestfs-actions.pod:4661
13961 #, no-wrap
13962 msgid ""
13963 " int\n"
13964 " guestfs_mkswap_U (guestfs_h *g,\n"
13965 "                   const char *uuid,\n"
13966 "                   const char *device);\n"
13967 "\n"
13968 msgstr ""
13969
13970 #. type: textblock
13971 #: ../src/guestfs-actions.pod:4666 ../fish/guestfish-actions.pod:3156
13972 msgid "Create a swap partition on C<device> with UUID C<uuid>."
13973 msgstr ""
13974
13975 #. type: =head2
13976 #: ../src/guestfs-actions.pod:4672
13977 msgid "guestfs_mkswap_file"
13978 msgstr ""
13979
13980 #. type: verbatim
13981 #: ../src/guestfs-actions.pod:4674
13982 #, no-wrap
13983 msgid ""
13984 " int\n"
13985 " guestfs_mkswap_file (guestfs_h *g,\n"
13986 "                      const char *path);\n"
13987 "\n"
13988 msgstr ""
13989
13990 #. type: textblock
13991 #: ../src/guestfs-actions.pod:4678 ../fish/guestfish-actions.pod:3162
13992 msgid "Create a swap file."
13993 msgstr ""
13994
13995 #. type: textblock
13996 #: ../src/guestfs-actions.pod:4680
13997 msgid ""
13998 "This command just writes a swap file signature to an existing file.  To "
13999 "create the file itself, use something like C<guestfs_fallocate>."
14000 msgstr ""
14001
14002 #. type: =head2
14003 #: ../src/guestfs-actions.pod:4687
14004 msgid "guestfs_modprobe"
14005 msgstr ""
14006
14007 #. type: verbatim
14008 #: ../src/guestfs-actions.pod:4689
14009 #, no-wrap
14010 msgid ""
14011 " int\n"
14012 " guestfs_modprobe (guestfs_h *g,\n"
14013 "                   const char *modulename);\n"
14014 "\n"
14015 msgstr ""
14016
14017 #. type: textblock
14018 #: ../src/guestfs-actions.pod:4693 ../fish/guestfish-actions.pod:3171
14019 msgid "This loads a kernel module in the appliance."
14020 msgstr ""
14021
14022 #. type: textblock
14023 #: ../src/guestfs-actions.pod:4695 ../fish/guestfish-actions.pod:3173
14024 msgid ""
14025 "The kernel module must have been whitelisted when libguestfs was built (see "
14026 "C<appliance/kmod.whitelist.in> in the source)."
14027 msgstr ""
14028
14029 #. type: =head2
14030 #: ../src/guestfs-actions.pod:4702
14031 msgid "guestfs_mount"
14032 msgstr ""
14033
14034 #. type: verbatim
14035 #: ../src/guestfs-actions.pod:4704
14036 #, no-wrap
14037 msgid ""
14038 " int\n"
14039 " guestfs_mount (guestfs_h *g,\n"
14040 "                const char *device,\n"
14041 "                const char *mountpoint);\n"
14042 "\n"
14043 msgstr ""
14044
14045 #. type: textblock
14046 #: ../src/guestfs-actions.pod:4709 ../fish/guestfish-actions.pod:3180
14047 msgid ""
14048 "Mount a guest disk at a position in the filesystem.  Block devices are named "
14049 "C</dev/sda>, C</dev/sdb> and so on, as they were added to the guest.  If "
14050 "those block devices contain partitions, they will have the usual names (eg. "
14051 "C</dev/sda1>).  Also LVM C</dev/VG/LV>-style names can be used."
14052 msgstr ""
14053
14054 #. type: textblock
14055 #: ../src/guestfs-actions.pod:4715 ../fish/guestfish-actions.pod:3186
14056 msgid ""
14057 "The rules are the same as for L<mount(2)>: A filesystem must first be "
14058 "mounted on C</> before others can be mounted.  Other filesystems can only be "
14059 "mounted on directories which already exist."
14060 msgstr ""
14061
14062 #. type: textblock
14063 #: ../src/guestfs-actions.pod:4720 ../fish/guestfish-actions.pod:3191
14064 msgid ""
14065 "The mounted filesystem is writable, if we have sufficient permissions on the "
14066 "underlying device."
14067 msgstr ""
14068
14069 #. type: textblock
14070 #: ../src/guestfs-actions.pod:4723
14071 msgid ""
14072 "B<Important note:> When you use this call, the filesystem options C<sync> "
14073 "and C<noatime> are set implicitly.  This was originally done because we "
14074 "thought it would improve reliability, but it turns out that I<-o sync> has a "
14075 "very large negative performance impact and negligible effect on "
14076 "reliability.  Therefore we recommend that you avoid using C<guestfs_mount> "
14077 "in any code that needs performance, and instead use C<guestfs_mount_options> "
14078 "(use an empty string for the first parameter if you don't want any options)."
14079 msgstr ""
14080
14081 #. type: textblock
14082 #: ../src/guestfs-actions.pod:4735
14083 msgid ""
14084 "This function is deprecated.  In new code, use the L</guestfs_mount_options> "
14085 "call instead."
14086 msgstr ""
14087
14088 #. type: =head2
14089 #: ../src/guestfs-actions.pod:4744
14090 msgid "guestfs_mount_loop"
14091 msgstr ""
14092
14093 #. type: verbatim
14094 #: ../src/guestfs-actions.pod:4746
14095 #, no-wrap
14096 msgid ""
14097 " int\n"
14098 " guestfs_mount_loop (guestfs_h *g,\n"
14099 "                     const char *file,\n"
14100 "                     const char *mountpoint);\n"
14101 "\n"
14102 msgstr ""
14103
14104 #. type: textblock
14105 #: ../src/guestfs-actions.pod:4751 ../fish/guestfish-actions.pod:3215
14106 msgid ""
14107 "This command lets you mount C<file> (a filesystem image in a file) on a "
14108 "mount point.  It is entirely equivalent to the command C<mount -o loop file "
14109 "mountpoint>."
14110 msgstr ""
14111
14112 #. type: =head2
14113 #: ../src/guestfs-actions.pod:4759
14114 msgid "guestfs_mount_options"
14115 msgstr ""
14116
14117 #. type: verbatim
14118 #: ../src/guestfs-actions.pod:4761
14119 #, no-wrap
14120 msgid ""
14121 " int\n"
14122 " guestfs_mount_options (guestfs_h *g,\n"
14123 "                        const char *options,\n"
14124 "                        const char *device,\n"
14125 "                        const char *mountpoint);\n"
14126 "\n"
14127 msgstr ""
14128
14129 #. type: textblock
14130 #: ../src/guestfs-actions.pod:4767
14131 msgid ""
14132 "This is the same as the C<guestfs_mount> command, but it allows you to set "
14133 "the mount options as for the L<mount(8)> I<-o> flag."
14134 msgstr ""
14135
14136 #. type: textblock
14137 #: ../src/guestfs-actions.pod:4771 ../fish/guestfish-actions.pod:3227
14138 msgid ""
14139 "If the C<options> parameter is an empty string, then no options are passed "
14140 "(all options default to whatever the filesystem uses)."
14141 msgstr ""
14142
14143 #. type: textblock
14144 #: ../src/guestfs-actions.pod:4777 ../src/guestfs-actions.pod:4791
14145 #: ../src/guestfs-actions.pod:4808
14146 msgid "(Added in 1.0.10)"
14147 msgstr ""
14148
14149 #. type: =head2
14150 #: ../src/guestfs-actions.pod:4779
14151 msgid "guestfs_mount_ro"
14152 msgstr ""
14153
14154 #. type: verbatim
14155 #: ../src/guestfs-actions.pod:4781
14156 #, no-wrap
14157 msgid ""
14158 " int\n"
14159 " guestfs_mount_ro (guestfs_h *g,\n"
14160 "                   const char *device,\n"
14161 "                   const char *mountpoint);\n"
14162 "\n"
14163 msgstr ""
14164
14165 #. type: textblock
14166 #: ../src/guestfs-actions.pod:4786
14167 msgid ""
14168 "This is the same as the C<guestfs_mount> command, but it mounts the "
14169 "filesystem with the read-only (I<-o ro>) flag."
14170 msgstr ""
14171
14172 #. type: =head2
14173 #: ../src/guestfs-actions.pod:4793
14174 msgid "guestfs_mount_vfs"
14175 msgstr ""
14176
14177 #. type: verbatim
14178 #: ../src/guestfs-actions.pod:4795
14179 #, no-wrap
14180 msgid ""
14181 " int\n"
14182 " guestfs_mount_vfs (guestfs_h *g,\n"
14183 "                    const char *options,\n"
14184 "                    const char *vfstype,\n"
14185 "                    const char *device,\n"
14186 "                    const char *mountpoint);\n"
14187 "\n"
14188 msgstr ""
14189
14190 #. type: textblock
14191 #: ../src/guestfs-actions.pod:4802
14192 msgid ""
14193 "This is the same as the C<guestfs_mount> command, but it allows you to set "
14194 "both the mount options and the vfstype as for the L<mount(8)> I<-o> and I<-"
14195 "t> flags."
14196 msgstr ""
14197
14198 #. type: =head2
14199 #: ../src/guestfs-actions.pod:4810
14200 msgid "guestfs_mountpoints"
14201 msgstr ""
14202
14203 #. type: verbatim
14204 #: ../src/guestfs-actions.pod:4812
14205 #, no-wrap
14206 msgid ""
14207 " char **\n"
14208 " guestfs_mountpoints (guestfs_h *g);\n"
14209 "\n"
14210 msgstr ""
14211
14212 #. type: textblock
14213 #: ../src/guestfs-actions.pod:4815
14214 msgid ""
14215 "This call is similar to C<guestfs_mounts>.  That call returns a list of "
14216 "devices.  This one returns a hash table (map) of device name to directory "
14217 "where the device is mounted."
14218 msgstr ""
14219
14220 #. type: =head2
14221 #: ../src/guestfs-actions.pod:4827
14222 msgid "guestfs_mounts"
14223 msgstr ""
14224
14225 #. type: verbatim
14226 #: ../src/guestfs-actions.pod:4829
14227 #, no-wrap
14228 msgid ""
14229 " char **\n"
14230 " guestfs_mounts (guestfs_h *g);\n"
14231 "\n"
14232 msgstr ""
14233
14234 #. type: textblock
14235 #: ../src/guestfs-actions.pod:4832 ../fish/guestfish-actions.pod:3258
14236 msgid ""
14237 "This returns the list of currently mounted filesystems.  It returns the list "
14238 "of devices (eg. C</dev/sda1>, C</dev/VG/LV>)."
14239 msgstr ""
14240
14241 #. type: textblock
14242 #: ../src/guestfs-actions.pod:4835 ../fish/guestfish-actions.pod:3261
14243 msgid "Some internal mounts are not shown."
14244 msgstr ""
14245
14246 #. type: textblock
14247 #: ../src/guestfs-actions.pod:4837
14248 msgid "See also: C<guestfs_mountpoints>"
14249 msgstr ""
14250
14251 #. type: =head2
14252 #: ../src/guestfs-actions.pod:4845
14253 msgid "guestfs_mv"
14254 msgstr ""
14255
14256 #. type: verbatim
14257 #: ../src/guestfs-actions.pod:4847
14258 #, no-wrap
14259 msgid ""
14260 " int\n"
14261 " guestfs_mv (guestfs_h *g,\n"
14262 "             const char *src,\n"
14263 "             const char *dest);\n"
14264 "\n"
14265 msgstr ""
14266
14267 #. type: textblock
14268 #: ../src/guestfs-actions.pod:4852 ../fish/guestfish-actions.pod:3269
14269 msgid ""
14270 "This moves a file from C<src> to C<dest> where C<dest> is either a "
14271 "destination filename or destination directory."
14272 msgstr ""
14273
14274 #. type: =head2
14275 #: ../src/guestfs-actions.pod:4859
14276 msgid "guestfs_ntfs_3g_probe"
14277 msgstr ""
14278
14279 #. type: verbatim
14280 #: ../src/guestfs-actions.pod:4861
14281 #, no-wrap
14282 msgid ""
14283 " int\n"
14284 " guestfs_ntfs_3g_probe (guestfs_h *g,\n"
14285 "                        int rw,\n"
14286 "                        const char *device);\n"
14287 "\n"
14288 msgstr ""
14289
14290 #. type: textblock
14291 #: ../src/guestfs-actions.pod:4866 ../fish/guestfish-actions.pod:3276
14292 msgid ""
14293 "This command runs the L<ntfs-3g.probe(8)> command which probes an NTFS "
14294 "C<device> for mountability.  (Not all NTFS volumes can be mounted read-"
14295 "write, and some cannot be mounted at all)."
14296 msgstr ""
14297
14298 #. type: textblock
14299 #: ../src/guestfs-actions.pod:4870 ../fish/guestfish-actions.pod:3280
14300 msgid ""
14301 "C<rw> is a boolean flag.  Set it to true if you want to test if the volume "
14302 "can be mounted read-write.  Set it to false if you want to test if the "
14303 "volume can be mounted read-only."
14304 msgstr ""
14305
14306 #. type: textblock
14307 #: ../src/guestfs-actions.pod:4874 ../fish/guestfish-actions.pod:3284
14308 msgid ""
14309 "The return value is an integer which C<0> if the operation would succeed, or "
14310 "some non-zero value documented in the L<ntfs-3g.probe(8)> manual page."
14311 msgstr ""
14312
14313 #. type: textblock
14314 #: ../src/guestfs-actions.pod:4880
14315 msgid "(Added in 1.0.43)"
14316 msgstr ""
14317
14318 #. type: =head2
14319 #: ../src/guestfs-actions.pod:4882
14320 msgid "guestfs_ntfsresize"
14321 msgstr ""
14322
14323 #. type: verbatim
14324 #: ../src/guestfs-actions.pod:4884
14325 #, no-wrap
14326 msgid ""
14327 " int\n"
14328 " guestfs_ntfsresize (guestfs_h *g,\n"
14329 "                     const char *device);\n"
14330 "\n"
14331 msgstr ""
14332
14333 #. type: textblock
14334 #: ../src/guestfs-actions.pod:4888 ../fish/guestfish-actions.pod:3292
14335 msgid ""
14336 "This command resizes an NTFS filesystem, expanding or shrinking it to the "
14337 "size of the underlying device."
14338 msgstr ""
14339
14340 #. type: textblock
14341 #: ../src/guestfs-actions.pod:4891 ../fish/guestfish-actions.pod:3295
14342 msgid ""
14343 "I<Note:> After the resize operation, the filesystem is marked as requiring a "
14344 "consistency check (for safety).  You have to boot into Windows to perform "
14345 "this check and clear this condition.  Furthermore, ntfsresize refuses to "
14346 "resize filesystems which have been marked in this way.  So in effect it is "
14347 "not possible to call ntfsresize multiple times on a single filesystem "
14348 "without booting into Windows between each resize."
14349 msgstr ""
14350
14351 #. type: textblock
14352 #: ../src/guestfs-actions.pod:4899 ../fish/guestfish-actions.pod:3303
14353 msgid "See also L<ntfsresize(8)>."
14354 msgstr ""
14355
14356 #. type: =head2
14357 #: ../src/guestfs-actions.pod:4905
14358 msgid "guestfs_ntfsresize_size"
14359 msgstr ""
14360
14361 #. type: verbatim
14362 #: ../src/guestfs-actions.pod:4907
14363 #, no-wrap
14364 msgid ""
14365 " int\n"
14366 " guestfs_ntfsresize_size (guestfs_h *g,\n"
14367 "                          const char *device,\n"
14368 "                          int64_t size);\n"
14369 "\n"
14370 msgstr ""
14371
14372 #. type: textblock
14373 #: ../src/guestfs-actions.pod:4912
14374 msgid ""
14375 "This command is the same as C<guestfs_ntfsresize> except that it allows you "
14376 "to specify the new size (in bytes) explicitly."
14377 msgstr ""
14378
14379 #. type: textblock
14380 #: ../src/guestfs-actions.pod:4917 ../src/guestfs-actions.pod:5353
14381 #: ../src/guestfs-actions.pod:5426 ../src/guestfs-actions.pod:5692
14382 #: ../src/guestfs-actions.pod:7298
14383 msgid "(Added in 1.3.14)"
14384 msgstr ""
14385
14386 #. type: =head2
14387 #: ../src/guestfs-actions.pod:4919
14388 msgid "guestfs_part_add"
14389 msgstr ""
14390
14391 #. type: verbatim
14392 #: ../src/guestfs-actions.pod:4921
14393 #, no-wrap
14394 msgid ""
14395 " int\n"
14396 " guestfs_part_add (guestfs_h *g,\n"
14397 "                   const char *device,\n"
14398 "                   const char *prlogex,\n"
14399 "                   int64_t startsect,\n"
14400 "                   int64_t endsect);\n"
14401 "\n"
14402 msgstr ""
14403
14404 #. type: textblock
14405 #: ../src/guestfs-actions.pod:4928
14406 msgid ""
14407 "This command adds a partition to C<device>.  If there is no partition table "
14408 "on the device, call C<guestfs_part_init> first."
14409 msgstr ""
14410
14411 #. type: textblock
14412 #: ../src/guestfs-actions.pod:4931 ../fish/guestfish-actions.pod:3319
14413 msgid ""
14414 "The C<prlogex> parameter is the type of partition.  Normally you should pass "
14415 "C<p> or C<primary> here, but MBR partition tables also support C<l> (or "
14416 "C<logical>) and C<e> (or C<extended>) partition types."
14417 msgstr ""
14418
14419 #. type: textblock
14420 #: ../src/guestfs-actions.pod:4936 ../fish/guestfish-actions.pod:3324
14421 msgid ""
14422 "C<startsect> and C<endsect> are the start and end of the partition in "
14423 "I<sectors>.  C<endsect> may be negative, which means it counts backwards "
14424 "from the end of the disk (C<-1> is the last sector)."
14425 msgstr ""
14426
14427 #. type: textblock
14428 #: ../src/guestfs-actions.pod:4940
14429 msgid ""
14430 "Creating a partition which covers the whole disk is not so easy.  Use "
14431 "C<guestfs_part_disk> to do that."
14432 msgstr ""
14433
14434 #. type: textblock
14435 #: ../src/guestfs-actions.pod:4945 ../src/guestfs-actions.pod:4983
14436 #: ../src/guestfs-actions.pod:5036 ../src/guestfs-actions.pod:5114
14437 #: ../src/guestfs-actions.pod:5152 ../src/guestfs-actions.pod:5171
14438 #: ../src/guestfs-actions.pod:5211
14439 msgid "(Added in 1.0.78)"
14440 msgstr ""
14441
14442 #. type: =head2
14443 #: ../src/guestfs-actions.pod:4947
14444 msgid "guestfs_part_del"
14445 msgstr ""
14446
14447 #. type: verbatim
14448 #: ../src/guestfs-actions.pod:4949
14449 #, no-wrap
14450 msgid ""
14451 " int\n"
14452 " guestfs_part_del (guestfs_h *g,\n"
14453 "                   const char *device,\n"
14454 "                   int partnum);\n"
14455 "\n"
14456 msgstr ""
14457
14458 #. type: textblock
14459 #: ../src/guestfs-actions.pod:4954 ../fish/guestfish-actions.pod:3335
14460 msgid "This command deletes the partition numbered C<partnum> on C<device>."
14461 msgstr ""
14462
14463 #. type: textblock
14464 #: ../src/guestfs-actions.pod:4956 ../fish/guestfish-actions.pod:3337
14465 msgid ""
14466 "Note that in the case of MBR partitioning, deleting an extended partition "
14467 "also deletes any logical partitions it contains."
14468 msgstr ""
14469
14470 #. type: =head2
14471 #: ../src/guestfs-actions.pod:4964
14472 msgid "guestfs_part_disk"
14473 msgstr ""
14474
14475 #. type: verbatim
14476 #: ../src/guestfs-actions.pod:4966
14477 #, no-wrap
14478 msgid ""
14479 " int\n"
14480 " guestfs_part_disk (guestfs_h *g,\n"
14481 "                    const char *device,\n"
14482 "                    const char *parttype);\n"
14483 "\n"
14484 msgstr ""
14485
14486 #. type: textblock
14487 #: ../src/guestfs-actions.pod:4971
14488 msgid ""
14489 "This command is simply a combination of C<guestfs_part_init> followed by "
14490 "C<guestfs_part_add> to create a single primary partition covering the whole "
14491 "disk."
14492 msgstr ""
14493
14494 #. type: textblock
14495 #: ../src/guestfs-actions.pod:4975
14496 msgid ""
14497 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
14498 "possible values are described in C<guestfs_part_init>."
14499 msgstr ""
14500
14501 #. type: =head2
14502 #: ../src/guestfs-actions.pod:4985
14503 msgid "guestfs_part_get_bootable"
14504 msgstr ""
14505
14506 #. type: verbatim
14507 #: ../src/guestfs-actions.pod:4987
14508 #, no-wrap
14509 msgid ""
14510 " int\n"
14511 " guestfs_part_get_bootable (guestfs_h *g,\n"
14512 "                            const char *device,\n"
14513 "                            int partnum);\n"
14514 "\n"
14515 msgstr ""
14516
14517 #. type: textblock
14518 #: ../src/guestfs-actions.pod:4992 ../fish/guestfish-actions.pod:3359
14519 msgid ""
14520 "This command returns true if the partition C<partnum> on C<device> has the "
14521 "bootable flag set."
14522 msgstr ""
14523
14524 #. type: textblock
14525 #: ../src/guestfs-actions.pod:4995
14526 msgid "See also C<guestfs_part_set_bootable>."
14527 msgstr ""
14528
14529 #. type: =head2
14530 #: ../src/guestfs-actions.pod:5001
14531 msgid "guestfs_part_get_mbr_id"
14532 msgstr ""
14533
14534 #. type: verbatim
14535 #: ../src/guestfs-actions.pod:5003
14536 #, no-wrap
14537 msgid ""
14538 " int\n"
14539 " guestfs_part_get_mbr_id (guestfs_h *g,\n"
14540 "                          const char *device,\n"
14541 "                          int partnum);\n"
14542 "\n"
14543 msgstr ""
14544
14545 #. type: textblock
14546 #: ../src/guestfs-actions.pod:5008 ../fish/guestfish-actions.pod:3368
14547 msgid ""
14548 "Returns the MBR type byte (also known as the ID byte) from the numbered "
14549 "partition C<partnum>."
14550 msgstr ""
14551
14552 #. type: textblock
14553 #: ../src/guestfs-actions.pod:5011 ../src/guestfs-actions.pod:5187
14554 msgid ""
14555 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
14556 "undefined results for other partition table types (see "
14557 "C<guestfs_part_get_parttype>)."
14558 msgstr ""
14559
14560 #. type: =head2
14561 #: ../src/guestfs-actions.pod:5019
14562 msgid "guestfs_part_get_parttype"
14563 msgstr ""
14564
14565 #. type: verbatim
14566 #: ../src/guestfs-actions.pod:5021
14567 #, no-wrap
14568 msgid ""
14569 " char *\n"
14570 " guestfs_part_get_parttype (guestfs_h *g,\n"
14571 "                            const char *device);\n"
14572 "\n"
14573 msgstr ""
14574
14575 #. type: textblock
14576 #: ../src/guestfs-actions.pod:5025 ../fish/guestfish-actions.pod:3379
14577 msgid ""
14578 "This command examines the partition table on C<device> and returns the "
14579 "partition table type (format) being used."
14580 msgstr ""
14581
14582 #. type: textblock
14583 #: ../src/guestfs-actions.pod:5028
14584 msgid ""
14585 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
14586 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
14587 "possible, although unusual.  See C<guestfs_part_init> for a full list."
14588 msgstr ""
14589
14590 #. type: =head2
14591 #: ../src/guestfs-actions.pod:5038
14592 msgid "guestfs_part_init"
14593 msgstr ""
14594
14595 #. type: verbatim
14596 #: ../src/guestfs-actions.pod:5040
14597 #, no-wrap
14598 msgid ""
14599 " int\n"
14600 " guestfs_part_init (guestfs_h *g,\n"
14601 "                    const char *device,\n"
14602 "                    const char *parttype);\n"
14603 "\n"
14604 msgstr ""
14605
14606 #. type: textblock
14607 #: ../src/guestfs-actions.pod:5045 ../fish/guestfish-actions.pod:3391
14608 msgid ""
14609 "This creates an empty partition table on C<device> of one of the partition "
14610 "types listed below.  Usually C<parttype> should be either C<msdos> or C<gpt> "
14611 "(for large disks)."
14612 msgstr ""
14613
14614 #. type: textblock
14615 #: ../src/guestfs-actions.pod:5049
14616 msgid ""
14617 "Initially there are no partitions.  Following this, you should call "
14618 "C<guestfs_part_add> for each partition required."
14619 msgstr ""
14620
14621 #. type: textblock
14622 #: ../src/guestfs-actions.pod:5052 ../fish/guestfish-actions.pod:3398
14623 msgid "Possible values for C<parttype> are:"
14624 msgstr ""
14625
14626 #. type: =item
14627 #: ../src/guestfs-actions.pod:5056 ../fish/guestfish-actions.pod:3402
14628 msgid "B<efi> | B<gpt>"
14629 msgstr ""
14630
14631 #. type: textblock
14632 #: ../src/guestfs-actions.pod:5058 ../fish/guestfish-actions.pod:3404
14633 msgid "Intel EFI / GPT partition table."
14634 msgstr ""
14635
14636 #. type: textblock
14637 #: ../src/guestfs-actions.pod:5060 ../fish/guestfish-actions.pod:3406
14638 msgid ""
14639 "This is recommended for >= 2 TB partitions that will be accessed from Linux "
14640 "and Intel-based Mac OS X.  It also has limited backwards compatibility with "
14641 "the C<mbr> format."
14642 msgstr ""
14643
14644 #. type: =item
14645 #: ../src/guestfs-actions.pod:5064 ../fish/guestfish-actions.pod:3410
14646 msgid "B<mbr> | B<msdos>"
14647 msgstr ""
14648
14649 #. type: textblock
14650 #: ../src/guestfs-actions.pod:5066 ../fish/guestfish-actions.pod:3412
14651 msgid ""
14652 "The standard PC \"Master Boot Record\" (MBR) format used by MS-DOS and "
14653 "Windows.  This partition type will B<only> work for device sizes up to 2 "
14654 "TB.  For large disks we recommend using C<gpt>."
14655 msgstr ""
14656
14657 #. type: textblock
14658 #: ../src/guestfs-actions.pod:5073 ../fish/guestfish-actions.pod:3419
14659 msgid ""
14660 "Other partition table types that may work but are not supported include:"
14661 msgstr ""
14662
14663 #. type: =item
14664 #: ../src/guestfs-actions.pod:5078 ../fish/guestfish-actions.pod:3424
14665 msgid "B<aix>"
14666 msgstr ""
14667
14668 #. type: textblock
14669 #: ../src/guestfs-actions.pod:5080 ../fish/guestfish-actions.pod:3426
14670 msgid "AIX disk labels."
14671 msgstr ""
14672
14673 #. type: =item
14674 #: ../src/guestfs-actions.pod:5082 ../fish/guestfish-actions.pod:3428
14675 msgid "B<amiga> | B<rdb>"
14676 msgstr ""
14677
14678 #. type: textblock
14679 #: ../src/guestfs-actions.pod:5084 ../fish/guestfish-actions.pod:3430
14680 msgid "Amiga \"Rigid Disk Block\" format."
14681 msgstr ""
14682
14683 #. type: =item
14684 #: ../src/guestfs-actions.pod:5086 ../fish/guestfish-actions.pod:3432
14685 msgid "B<bsd>"
14686 msgstr ""
14687
14688 #. type: textblock
14689 #: ../src/guestfs-actions.pod:5088 ../fish/guestfish-actions.pod:3434
14690 msgid "BSD disk labels."
14691 msgstr ""
14692
14693 #. type: =item
14694 #: ../src/guestfs-actions.pod:5090 ../fish/guestfish-actions.pod:3436
14695 msgid "B<dasd>"
14696 msgstr ""
14697
14698 #. type: textblock
14699 #: ../src/guestfs-actions.pod:5092 ../fish/guestfish-actions.pod:3438
14700 msgid "DASD, used on IBM mainframes."
14701 msgstr ""
14702
14703 #. type: =item
14704 #: ../src/guestfs-actions.pod:5094 ../fish/guestfish-actions.pod:3440
14705 msgid "B<dvh>"
14706 msgstr ""
14707
14708 #. type: textblock
14709 #: ../src/guestfs-actions.pod:5096 ../fish/guestfish-actions.pod:3442
14710 msgid "MIPS/SGI volumes."
14711 msgstr ""
14712
14713 #. type: =item
14714 #: ../src/guestfs-actions.pod:5098 ../fish/guestfish-actions.pod:3444
14715 msgid "B<mac>"
14716 msgstr ""
14717
14718 #. type: textblock
14719 #: ../src/guestfs-actions.pod:5100 ../fish/guestfish-actions.pod:3446
14720 msgid "Old Mac partition format.  Modern Macs use C<gpt>."
14721 msgstr ""
14722
14723 #. type: =item
14724 #: ../src/guestfs-actions.pod:5102 ../fish/guestfish-actions.pod:3448
14725 msgid "B<pc98>"
14726 msgstr ""
14727
14728 #. type: textblock
14729 #: ../src/guestfs-actions.pod:5104 ../fish/guestfish-actions.pod:3450
14730 msgid "NEC PC-98 format, common in Japan apparently."
14731 msgstr ""
14732
14733 #. type: =item
14734 #: ../src/guestfs-actions.pod:5106 ../fish/guestfish-actions.pod:3452
14735 msgid "B<sun>"
14736 msgstr ""
14737
14738 #. type: textblock
14739 #: ../src/guestfs-actions.pod:5108 ../fish/guestfish-actions.pod:3454
14740 msgid "Sun disk labels."
14741 msgstr ""
14742
14743 #. type: =head2
14744 #: ../src/guestfs-actions.pod:5116
14745 msgid "guestfs_part_list"
14746 msgstr ""
14747
14748 #. type: verbatim
14749 #: ../src/guestfs-actions.pod:5118
14750 #, no-wrap
14751 msgid ""
14752 " struct guestfs_partition_list *\n"
14753 " guestfs_part_list (guestfs_h *g,\n"
14754 "                    const char *device);\n"
14755 "\n"
14756 msgstr ""
14757
14758 #. type: textblock
14759 #: ../src/guestfs-actions.pod:5122 ../fish/guestfish-actions.pod:3462
14760 msgid ""
14761 "This command parses the partition table on C<device> and returns the list of "
14762 "partitions found."
14763 msgstr ""
14764
14765 #. type: textblock
14766 #: ../src/guestfs-actions.pod:5125 ../fish/guestfish-actions.pod:3465
14767 msgid "The fields in the returned structure are:"
14768 msgstr ""
14769
14770 #. type: =item
14771 #: ../src/guestfs-actions.pod:5129 ../fish/guestfish-actions.pod:3469
14772 msgid "B<part_num>"
14773 msgstr ""
14774
14775 #. type: textblock
14776 #: ../src/guestfs-actions.pod:5131 ../fish/guestfish-actions.pod:3471
14777 msgid "Partition number, counting from 1."
14778 msgstr ""
14779
14780 #. type: =item
14781 #: ../src/guestfs-actions.pod:5133 ../fish/guestfish-actions.pod:3473
14782 msgid "B<part_start>"
14783 msgstr ""
14784
14785 #. type: textblock
14786 #: ../src/guestfs-actions.pod:5135
14787 msgid ""
14788 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
14789 "the device's sector size, see C<guestfs_blockdev_getss>."
14790 msgstr ""
14791
14792 #. type: =item
14793 #: ../src/guestfs-actions.pod:5138 ../fish/guestfish-actions.pod:3478
14794 msgid "B<part_end>"
14795 msgstr ""
14796
14797 #. type: textblock
14798 #: ../src/guestfs-actions.pod:5140 ../fish/guestfish-actions.pod:3480
14799 msgid "End of the partition in bytes."
14800 msgstr ""
14801
14802 #. type: =item
14803 #: ../src/guestfs-actions.pod:5142 ../fish/guestfish-actions.pod:3482
14804 msgid "B<part_size>"
14805 msgstr ""
14806
14807 #. type: textblock
14808 #: ../src/guestfs-actions.pod:5144 ../fish/guestfish-actions.pod:3484
14809 msgid "Size of the partition in bytes."
14810 msgstr ""
14811
14812 #. type: textblock
14813 #: ../src/guestfs-actions.pod:5148
14814 msgid ""
14815 "This function returns a C<struct guestfs_partition_list *>, or NULL if there "
14816 "was an error.  I<The caller must call C<guestfs_free_partition_list> after "
14817 "use>."
14818 msgstr ""
14819
14820 #. type: =head2
14821 #: ../src/guestfs-actions.pod:5154
14822 msgid "guestfs_part_set_bootable"
14823 msgstr ""
14824
14825 #. type: verbatim
14826 #: ../src/guestfs-actions.pod:5156
14827 #, no-wrap
14828 msgid ""
14829 " int\n"
14830 " guestfs_part_set_bootable (guestfs_h *g,\n"
14831 "                            const char *device,\n"
14832 "                            int partnum,\n"
14833 "                            int bootable);\n"
14834 "\n"
14835 msgstr ""
14836
14837 #. type: textblock
14838 #: ../src/guestfs-actions.pod:5162 ../fish/guestfish-actions.pod:3492
14839 msgid ""
14840 "This sets the bootable flag on partition numbered C<partnum> on device "
14841 "C<device>.  Note that partitions are numbered from 1."
14842 msgstr ""
14843
14844 #. type: textblock
14845 #: ../src/guestfs-actions.pod:5165 ../fish/guestfish-actions.pod:3495
14846 msgid ""
14847 "The bootable flag is used by some operating systems (notably Windows) to "
14848 "determine which partition to boot from.  It is by no means universally "
14849 "recognized."
14850 msgstr ""
14851
14852 #. type: =head2
14853 #: ../src/guestfs-actions.pod:5173
14854 msgid "guestfs_part_set_mbr_id"
14855 msgstr ""
14856
14857 #. type: verbatim
14858 #: ../src/guestfs-actions.pod:5175
14859 #, no-wrap
14860 msgid ""
14861 " int\n"
14862 " guestfs_part_set_mbr_id (guestfs_h *g,\n"
14863 "                          const char *device,\n"
14864 "                          int partnum,\n"
14865 "                          int idbyte);\n"
14866 "\n"
14867 msgstr ""
14868
14869 #. type: textblock
14870 #: ../src/guestfs-actions.pod:5181 ../fish/guestfish-actions.pod:3503
14871 msgid ""
14872 "Sets the MBR type byte (also known as the ID byte) of the numbered partition "
14873 "C<partnum> to C<idbyte>.  Note that the type bytes quoted in most "
14874 "documentation are in fact hexadecimal numbers, but usually documented "
14875 "without any leading \"0x\" which might be confusing."
14876 msgstr ""
14877
14878 #. type: =head2
14879 #: ../src/guestfs-actions.pod:5195
14880 msgid "guestfs_part_set_name"
14881 msgstr ""
14882
14883 #. type: verbatim
14884 #: ../src/guestfs-actions.pod:5197
14885 #, no-wrap
14886 msgid ""
14887 " int\n"
14888 " guestfs_part_set_name (guestfs_h *g,\n"
14889 "                        const char *device,\n"
14890 "                        int partnum,\n"
14891 "                        const char *name);\n"
14892 "\n"
14893 msgstr ""
14894
14895 #. type: textblock
14896 #: ../src/guestfs-actions.pod:5203 ../fish/guestfish-actions.pod:3517
14897 msgid ""
14898 "This sets the partition name on partition numbered C<partnum> on device "
14899 "C<device>.  Note that partitions are numbered from 1."
14900 msgstr ""
14901
14902 #. type: textblock
14903 #: ../src/guestfs-actions.pod:5206 ../fish/guestfish-actions.pod:3520
14904 msgid ""
14905 "The partition name can only be set on certain types of partition table.  "
14906 "This works on C<gpt> but not on C<mbr> partitions."
14907 msgstr ""
14908
14909 #. type: =head2
14910 #: ../src/guestfs-actions.pod:5213
14911 msgid "guestfs_part_to_dev"
14912 msgstr ""
14913
14914 #. type: verbatim
14915 #: ../src/guestfs-actions.pod:5215
14916 #, no-wrap
14917 msgid ""
14918 " char *\n"
14919 " guestfs_part_to_dev (guestfs_h *g,\n"
14920 "                      const char *partition);\n"
14921 "\n"
14922 msgstr ""
14923
14924 #. type: textblock
14925 #: ../src/guestfs-actions.pod:5219 ../fish/guestfish-actions.pod:3527
14926 msgid ""
14927 "This function takes a partition name (eg. \"/dev/sdb1\") and removes the "
14928 "partition number, returning the device name (eg. \"/dev/sdb\")."
14929 msgstr ""
14930
14931 #. type: textblock
14932 #: ../src/guestfs-actions.pod:5223
14933 msgid ""
14934 "The named partition must exist, for example as a string returned from "
14935 "C<guestfs_list_partitions>."
14936 msgstr ""
14937
14938 #. type: =head2
14939 #: ../src/guestfs-actions.pod:5231
14940 msgid "guestfs_ping_daemon"
14941 msgstr ""
14942
14943 #. type: verbatim
14944 #: ../src/guestfs-actions.pod:5233
14945 #, no-wrap
14946 msgid ""
14947 " int\n"
14948 " guestfs_ping_daemon (guestfs_h *g);\n"
14949 "\n"
14950 msgstr ""
14951
14952 #. type: textblock
14953 #: ../src/guestfs-actions.pod:5236 ../fish/guestfish-actions.pod:3538
14954 msgid ""
14955 "This is a test probe into the guestfs daemon running inside the qemu "
14956 "subprocess.  Calling this function checks that the daemon responds to the "
14957 "ping message, without affecting the daemon or attached block device(s) in "
14958 "any other way."
14959 msgstr ""
14960
14961 #. type: =head2
14962 #: ../src/guestfs-actions.pod:5245
14963 msgid "guestfs_pread"
14964 msgstr ""
14965
14966 #. type: verbatim
14967 #: ../src/guestfs-actions.pod:5247
14968 #, no-wrap
14969 msgid ""
14970 " char *\n"
14971 " guestfs_pread (guestfs_h *g,\n"
14972 "                const char *path,\n"
14973 "                int count,\n"
14974 "                int64_t offset,\n"
14975 "                size_t *size_r);\n"
14976 "\n"
14977 msgstr ""
14978
14979 #. type: textblock
14980 #: ../src/guestfs-actions.pod:5254 ../fish/guestfish-actions.pod:3547
14981 msgid ""
14982 "This command lets you read part of a file.  It reads C<count> bytes of the "
14983 "file, starting at C<offset>, from file C<path>."
14984 msgstr ""
14985
14986 #. type: textblock
14987 #: ../src/guestfs-actions.pod:5257 ../src/guestfs-actions.pod:5283
14988 #: ../fish/guestfish-actions.pod:3550 ../fish/guestfish-actions.pod:3565
14989 msgid ""
14990 "This may read fewer bytes than requested.  For further details see the "
14991 "L<pread(2)> system call."
14992 msgstr ""
14993
14994 #. type: textblock
14995 #: ../src/guestfs-actions.pod:5260
14996 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>."
14997 msgstr ""
14998
14999 #. type: =head2
15000 #: ../src/guestfs-actions.pod:5271
15001 msgid "guestfs_pread_device"
15002 msgstr ""
15003
15004 #. type: verbatim
15005 #: ../src/guestfs-actions.pod:5273
15006 #, no-wrap
15007 msgid ""
15008 " char *\n"
15009 " guestfs_pread_device (guestfs_h *g,\n"
15010 "                       const char *device,\n"
15011 "                       int count,\n"
15012 "                       int64_t offset,\n"
15013 "                       size_t *size_r);\n"
15014 "\n"
15015 msgstr ""
15016
15017 #. type: textblock
15018 #: ../src/guestfs-actions.pod:5280 ../fish/guestfish-actions.pod:3562
15019 msgid ""
15020 "This command lets you read part of a file.  It reads C<count> bytes of "
15021 "C<device>, starting at C<offset>."
15022 msgstr ""
15023
15024 #. type: textblock
15025 #: ../src/guestfs-actions.pod:5286
15026 msgid "See also C<guestfs_pread>."
15027 msgstr ""
15028
15029 #. type: textblock
15030 #: ../src/guestfs-actions.pod:5295
15031 msgid "(Added in 1.5.21)"
15032 msgstr ""
15033
15034 #. type: =head2
15035 #: ../src/guestfs-actions.pod:5297
15036 msgid "guestfs_pvcreate"
15037 msgstr ""
15038
15039 #. type: verbatim
15040 #: ../src/guestfs-actions.pod:5299
15041 #, no-wrap
15042 msgid ""
15043 " int\n"
15044 " guestfs_pvcreate (guestfs_h *g,\n"
15045 "                   const char *device);\n"
15046 "\n"
15047 msgstr ""
15048
15049 #. type: textblock
15050 #: ../src/guestfs-actions.pod:5303 ../fish/guestfish-actions.pod:3577
15051 msgid ""
15052 "This creates an LVM physical volume on the named C<device>, where C<device> "
15053 "should usually be a partition name such as C</dev/sda1>."
15054 msgstr ""
15055
15056 #. type: =head2
15057 #: ../src/guestfs-actions.pod:5311
15058 msgid "guestfs_pvremove"
15059 msgstr ""
15060
15061 #. type: verbatim
15062 #: ../src/guestfs-actions.pod:5313
15063 #, no-wrap
15064 msgid ""
15065 " int\n"
15066 " guestfs_pvremove (guestfs_h *g,\n"
15067 "                   const char *device);\n"
15068 "\n"
15069 msgstr ""
15070
15071 #. type: textblock
15072 #: ../src/guestfs-actions.pod:5317 ../fish/guestfish-actions.pod:3585
15073 msgid ""
15074 "This wipes a physical volume C<device> so that LVM will no longer recognise "
15075 "it."
15076 msgstr ""
15077
15078 #. type: textblock
15079 #: ../src/guestfs-actions.pod:5320 ../fish/guestfish-actions.pod:3588
15080 msgid ""
15081 "The implementation uses the C<pvremove> command which refuses to wipe "
15082 "physical volumes that contain any volume groups, so you have to remove those "
15083 "first."
15084 msgstr ""
15085
15086 #. type: =head2
15087 #: ../src/guestfs-actions.pod:5328
15088 msgid "guestfs_pvresize"
15089 msgstr ""
15090
15091 #. type: verbatim
15092 #: ../src/guestfs-actions.pod:5330
15093 #, no-wrap
15094 msgid ""
15095 " int\n"
15096 " guestfs_pvresize (guestfs_h *g,\n"
15097 "                   const char *device);\n"
15098 "\n"
15099 msgstr ""
15100
15101 #. type: textblock
15102 #: ../src/guestfs-actions.pod:5334 ../fish/guestfish-actions.pod:3596
15103 msgid ""
15104 "This resizes (expands or shrinks) an existing LVM physical volume to match "
15105 "the new size of the underlying device."
15106 msgstr ""
15107
15108 #. type: =head2
15109 #: ../src/guestfs-actions.pod:5341
15110 msgid "guestfs_pvresize_size"
15111 msgstr ""
15112
15113 #. type: verbatim
15114 #: ../src/guestfs-actions.pod:5343
15115 #, no-wrap
15116 msgid ""
15117 " int\n"
15118 " guestfs_pvresize_size (guestfs_h *g,\n"
15119 "                        const char *device,\n"
15120 "                        int64_t size);\n"
15121 "\n"
15122 msgstr ""
15123
15124 #. type: textblock
15125 #: ../src/guestfs-actions.pod:5348
15126 msgid ""
15127 "This command is the same as C<guestfs_pvresize> except that it allows you to "
15128 "specify the new size (in bytes) explicitly."
15129 msgstr ""
15130
15131 #. type: =head2
15132 #: ../src/guestfs-actions.pod:5355
15133 msgid "guestfs_pvs"
15134 msgstr ""
15135
15136 #. type: verbatim
15137 #: ../src/guestfs-actions.pod:5357
15138 #, no-wrap
15139 msgid ""
15140 " char **\n"
15141 " guestfs_pvs (guestfs_h *g);\n"
15142 "\n"
15143 msgstr ""
15144
15145 #. type: textblock
15146 #: ../src/guestfs-actions.pod:5360 ../fish/guestfish-actions.pod:3610
15147 msgid ""
15148 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
15149 "(8)> command."
15150 msgstr ""
15151
15152 #. type: textblock
15153 #: ../src/guestfs-actions.pod:5363 ../fish/guestfish-actions.pod:3613
15154 msgid ""
15155 "This returns a list of just the device names that contain PVs (eg. C</dev/"
15156 "sda2>)."
15157 msgstr ""
15158
15159 #. type: textblock
15160 #: ../src/guestfs-actions.pod:5366
15161 msgid "See also C<guestfs_pvs_full>."
15162 msgstr ""
15163
15164 #. type: =head2
15165 #: ../src/guestfs-actions.pod:5374
15166 msgid "guestfs_pvs_full"
15167 msgstr ""
15168
15169 #. type: verbatim
15170 #: ../src/guestfs-actions.pod:5376
15171 #, no-wrap
15172 msgid ""
15173 " struct guestfs_lvm_pv_list *\n"
15174 " guestfs_pvs_full (guestfs_h *g);\n"
15175 "\n"
15176 msgstr ""
15177
15178 #. type: textblock
15179 #: ../src/guestfs-actions.pod:5379 ../fish/guestfish-actions.pod:3622
15180 msgid ""
15181 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
15182 "(8)> command.  The \"full\" version includes all fields."
15183 msgstr ""
15184
15185 #. type: textblock
15186 #: ../src/guestfs-actions.pod:5382
15187 msgid ""
15188 "This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there "
15189 "was an error.  I<The caller must call C<guestfs_free_lvm_pv_list> after use>."
15190 msgstr ""
15191
15192 #. type: =head2
15193 #: ../src/guestfs-actions.pod:5388
15194 msgid "guestfs_pvuuid"
15195 msgstr ""
15196
15197 #. type: verbatim
15198 #: ../src/guestfs-actions.pod:5390
15199 #, no-wrap
15200 msgid ""
15201 " char *\n"
15202 " guestfs_pvuuid (guestfs_h *g,\n"
15203 "                 const char *device);\n"
15204 "\n"
15205 msgstr ""
15206
15207 #. type: textblock
15208 #: ../src/guestfs-actions.pod:5394 ../fish/guestfish-actions.pod:3629
15209 msgid "This command returns the UUID of the LVM PV C<device>."
15210 msgstr ""
15211
15212 #. type: =head2
15213 #: ../src/guestfs-actions.pod:5401
15214 msgid "guestfs_pwrite"
15215 msgstr ""
15216
15217 #. type: verbatim
15218 #: ../src/guestfs-actions.pod:5403
15219 #, no-wrap
15220 msgid ""
15221 " int\n"
15222 " guestfs_pwrite (guestfs_h *g,\n"
15223 "                 const char *path,\n"
15224 "                 const char *content,\n"
15225 "                 size_t content_size,\n"
15226 "                 int64_t offset);\n"
15227 "\n"
15228 msgstr ""
15229
15230 #. type: textblock
15231 #: ../src/guestfs-actions.pod:5410 ../fish/guestfish-actions.pod:3635
15232 msgid ""
15233 "This command writes to part of a file.  It writes the data buffer C<content> "
15234 "to the file C<path> starting at offset C<offset>."
15235 msgstr ""
15236
15237 #. type: textblock
15238 #: ../src/guestfs-actions.pod:5413 ../fish/guestfish-actions.pod:3638
15239 msgid ""
15240 "This command implements the L<pwrite(2)> system call, and like that system "
15241 "call it may not write the full data requested.  The return value is the "
15242 "number of bytes that were actually written to the file.  This could even be "
15243 "0, although short writes are unlikely for regular files in ordinary "
15244 "circumstances."
15245 msgstr ""
15246
15247 #. type: textblock
15248 #: ../src/guestfs-actions.pod:5419
15249 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>."
15250 msgstr ""
15251
15252 #. type: =head2
15253 #: ../src/guestfs-actions.pod:5428
15254 msgid "guestfs_pwrite_device"
15255 msgstr ""
15256
15257 #. type: verbatim
15258 #: ../src/guestfs-actions.pod:5430
15259 #, no-wrap
15260 msgid ""
15261 " int\n"
15262 " guestfs_pwrite_device (guestfs_h *g,\n"
15263 "                        const char *device,\n"
15264 "                        const char *content,\n"
15265 "                        size_t content_size,\n"
15266 "                        int64_t offset);\n"
15267 "\n"
15268 msgstr ""
15269
15270 #. type: textblock
15271 #: ../src/guestfs-actions.pod:5437 ../fish/guestfish-actions.pod:3653
15272 msgid ""
15273 "This command writes to part of a device.  It writes the data buffer "
15274 "C<content> to C<device> starting at offset C<offset>."
15275 msgstr ""
15276
15277 #. type: textblock
15278 #: ../src/guestfs-actions.pod:5440 ../fish/guestfish-actions.pod:3656
15279 msgid ""
15280 "This command implements the L<pwrite(2)> system call, and like that system "
15281 "call it may not write the full data requested (although short writes to disk "
15282 "devices and partitions are probably impossible with standard Linux kernels)."
15283 msgstr ""
15284
15285 #. type: textblock
15286 #: ../src/guestfs-actions.pod:5445
15287 msgid "See also C<guestfs_pwrite>."
15288 msgstr ""
15289
15290 #. type: textblock
15291 #: ../src/guestfs-actions.pod:5452
15292 msgid "(Added in 1.5.20)"
15293 msgstr ""
15294
15295 #. type: =head2
15296 #: ../src/guestfs-actions.pod:5454
15297 msgid "guestfs_read_file"
15298 msgstr ""
15299
15300 #. type: verbatim
15301 #: ../src/guestfs-actions.pod:5456
15302 #, no-wrap
15303 msgid ""
15304 " char *\n"
15305 " guestfs_read_file (guestfs_h *g,\n"
15306 "                    const char *path,\n"
15307 "                    size_t *size_r);\n"
15308 "\n"
15309 msgstr ""
15310
15311 #. type: textblock
15312 #: ../src/guestfs-actions.pod:5461 ../fish/guestfish-actions.pod:3670
15313 msgid "This calls returns the contents of the file C<path> as a buffer."
15314 msgstr ""
15315
15316 #. type: textblock
15317 #: ../src/guestfs-actions.pod:5464
15318 msgid ""
15319 "Unlike C<guestfs_cat>, this function can correctly handle files that contain "
15320 "embedded ASCII NUL characters.  However unlike C<guestfs_download>, this "
15321 "function is limited in the total size of file that can be handled."
15322 msgstr ""
15323
15324 #. type: textblock
15325 #: ../src/guestfs-actions.pod:5476
15326 msgid "(Added in 1.0.63)"
15327 msgstr ""
15328
15329 #. type: =head2
15330 #: ../src/guestfs-actions.pod:5478
15331 msgid "guestfs_read_lines"
15332 msgstr ""
15333
15334 #. type: verbatim
15335 #: ../src/guestfs-actions.pod:5480
15336 #, no-wrap
15337 msgid ""
15338 " char **\n"
15339 " guestfs_read_lines (guestfs_h *g,\n"
15340 "                     const char *path);\n"
15341 "\n"
15342 msgstr ""
15343
15344 #. type: textblock
15345 #: ../src/guestfs-actions.pod:5486 ../fish/guestfish-actions.pod:3687
15346 msgid ""
15347 "The file contents are returned as a list of lines.  Trailing C<LF> and "
15348 "C<CRLF> character sequences are I<not> returned."
15349 msgstr ""
15350
15351 #. type: textblock
15352 #: ../src/guestfs-actions.pod:5489
15353 msgid ""
15354 "Note that this function cannot correctly handle binary files (specifically, "
15355 "files containing C<\\0> character which is treated as end of line).  For "
15356 "those you need to use the C<guestfs_read_file> function which has a more "
15357 "complex interface."
15358 msgstr ""
15359
15360 #. type: =head2
15361 #: ../src/guestfs-actions.pod:5500
15362 msgid "guestfs_readdir"
15363 msgstr ""
15364
15365 #. type: verbatim
15366 #: ../src/guestfs-actions.pod:5502
15367 #, no-wrap
15368 msgid ""
15369 " struct guestfs_dirent_list *\n"
15370 " guestfs_readdir (guestfs_h *g,\n"
15371 "                  const char *dir);\n"
15372 "\n"
15373 msgstr ""
15374
15375 #. type: textblock
15376 #: ../src/guestfs-actions.pod:5506 ../fish/guestfish-actions.pod:3699
15377 msgid "This returns the list of directory entries in directory C<dir>."
15378 msgstr ""
15379
15380 #. type: textblock
15381 #: ../src/guestfs-actions.pod:5508 ../fish/guestfish-actions.pod:3701
15382 msgid ""
15383 "All entries in the directory are returned, including C<.> and C<..>.  The "
15384 "entries are I<not> sorted, but returned in the same order as the underlying "
15385 "filesystem."
15386 msgstr ""
15387
15388 #. type: textblock
15389 #: ../src/guestfs-actions.pod:5512 ../fish/guestfish-actions.pod:3705
15390 msgid ""
15391 "Also this call returns basic file type information about each file.  The "
15392 "C<ftyp> field will contain one of the following characters:"
15393 msgstr ""
15394
15395 #. type: =item
15396 #: ../src/guestfs-actions.pod:5517 ../fish/guestfish-actions.pod:3710
15397 msgid "'b'"
15398 msgstr ""
15399
15400 #. type: textblock
15401 #: ../src/guestfs-actions.pod:5519 ../fish/guestfish-actions.pod:3712
15402 msgid "Block special"
15403 msgstr ""
15404
15405 #. type: =item
15406 #: ../src/guestfs-actions.pod:5521 ../fish/guestfish-actions.pod:3714
15407 msgid "'c'"
15408 msgstr ""
15409
15410 #. type: textblock
15411 #: ../src/guestfs-actions.pod:5523 ../fish/guestfish-actions.pod:3716
15412 msgid "Char special"
15413 msgstr ""
15414
15415 #. type: =item
15416 #: ../src/guestfs-actions.pod:5525 ../fish/guestfish-actions.pod:3718
15417 msgid "'d'"
15418 msgstr ""
15419
15420 #. type: textblock
15421 #: ../src/guestfs-actions.pod:5527 ../fish/guestfish-actions.pod:3720
15422 msgid "Directory"
15423 msgstr ""
15424
15425 #. type: =item
15426 #: ../src/guestfs-actions.pod:5529 ../fish/guestfish-actions.pod:3722
15427 msgid "'f'"
15428 msgstr ""
15429
15430 #. type: textblock
15431 #: ../src/guestfs-actions.pod:5531 ../fish/guestfish-actions.pod:3724
15432 msgid "FIFO (named pipe)"
15433 msgstr ""
15434
15435 #. type: =item
15436 #: ../src/guestfs-actions.pod:5533 ../fish/guestfish-actions.pod:3726
15437 msgid "'l'"
15438 msgstr ""
15439
15440 #. type: textblock
15441 #: ../src/guestfs-actions.pod:5535 ../fish/guestfish-actions.pod:3728
15442 msgid "Symbolic link"
15443 msgstr ""
15444
15445 #. type: =item
15446 #: ../src/guestfs-actions.pod:5537 ../fish/guestfish-actions.pod:3730
15447 msgid "'r'"
15448 msgstr ""
15449
15450 #. type: textblock
15451 #: ../src/guestfs-actions.pod:5539 ../fish/guestfish-actions.pod:3732
15452 msgid "Regular file"
15453 msgstr ""
15454
15455 #. type: =item
15456 #: ../src/guestfs-actions.pod:5541 ../fish/guestfish-actions.pod:3734
15457 msgid "'s'"
15458 msgstr ""
15459
15460 #. type: textblock
15461 #: ../src/guestfs-actions.pod:5543 ../fish/guestfish-actions.pod:3736
15462 msgid "Socket"
15463 msgstr ""
15464
15465 #. type: =item
15466 #: ../src/guestfs-actions.pod:5545 ../fish/guestfish-actions.pod:3738
15467 msgid "'u'"
15468 msgstr ""
15469
15470 #. type: textblock
15471 #: ../src/guestfs-actions.pod:5547 ../fish/guestfish-actions.pod:3740
15472 msgid "Unknown file type"
15473 msgstr ""
15474
15475 #. type: =item
15476 #: ../src/guestfs-actions.pod:5549 ../fish/guestfish-actions.pod:3742
15477 msgid "'?'"
15478 msgstr ""
15479
15480 #. type: textblock
15481 #: ../src/guestfs-actions.pod:5551 ../fish/guestfish-actions.pod:3744
15482 msgid ""
15483 "The L<readdir(3)> call returned a C<d_type> field with an unexpected value"
15484 msgstr ""
15485
15486 #. type: textblock
15487 #: ../src/guestfs-actions.pod:5556
15488 msgid ""
15489 "This function is primarily intended for use by programs.  To get a simple "
15490 "list of names, use C<guestfs_ls>.  To get a printable directory for human "
15491 "consumption, use C<guestfs_ll>."
15492 msgstr ""
15493
15494 #. type: textblock
15495 #: ../src/guestfs-actions.pod:5560
15496 msgid ""
15497 "This function returns a C<struct guestfs_dirent_list *>, or NULL if there "
15498 "was an error.  I<The caller must call C<guestfs_free_dirent_list> after use>."
15499 msgstr ""
15500
15501 #. type: =head2
15502 #: ../src/guestfs-actions.pod:5566
15503 msgid "guestfs_readlink"
15504 msgstr ""
15505
15506 #. type: verbatim
15507 #: ../src/guestfs-actions.pod:5568
15508 #, no-wrap
15509 msgid ""
15510 " char *\n"
15511 " guestfs_readlink (guestfs_h *g,\n"
15512 "                   const char *path);\n"
15513 "\n"
15514 msgstr ""
15515
15516 #. type: textblock
15517 #: ../src/guestfs-actions.pod:5572 ../fish/guestfish-actions.pod:3757
15518 msgid "This command reads the target of a symbolic link."
15519 msgstr ""
15520
15521 #. type: =head2
15522 #: ../src/guestfs-actions.pod:5579
15523 msgid "guestfs_readlinklist"
15524 msgstr ""
15525
15526 #. type: verbatim
15527 #: ../src/guestfs-actions.pod:5581
15528 #, no-wrap
15529 msgid ""
15530 " char **\n"
15531 " guestfs_readlinklist (guestfs_h *g,\n"
15532 "                       const char *path,\n"
15533 "                       char *const *names);\n"
15534 "\n"
15535 msgstr ""
15536
15537 #. type: textblock
15538 #: ../src/guestfs-actions.pod:5586 ../fish/guestfish-actions.pod:3763
15539 msgid ""
15540 "This call allows you to do a C<readlink> operation on multiple files, where "
15541 "all files are in the directory C<path>.  C<names> is the list of files from "
15542 "this directory."
15543 msgstr ""
15544
15545 #. type: textblock
15546 #: ../src/guestfs-actions.pod:5590 ../fish/guestfish-actions.pod:3767
15547 msgid ""
15548 "On return you get a list of strings, with a one-to-one correspondence to the "
15549 "C<names> list.  Each string is the value of the symbolic link."
15550 msgstr ""
15551
15552 #. type: textblock
15553 #: ../src/guestfs-actions.pod:5594 ../fish/guestfish-actions.pod:3771
15554 msgid ""
15555 "If the C<readlink(2)> operation fails on any name, then the corresponding "
15556 "result string is the empty string C<\"\">.  However the whole operation is "
15557 "completed even if there were C<readlink(2)> errors, and so you can call this "
15558 "function with names where you don't know if they are symbolic links already "
15559 "(albeit slightly less efficient)."
15560 msgstr ""
15561
15562 #. type: textblock
15563 #: ../src/guestfs-actions.pod:5601 ../fish/guestfish-actions.pod:3778
15564 msgid ""
15565 "This call is intended for programs that want to efficiently list a directory "
15566 "contents without making many round-trips.  Very long directory listings "
15567 "might cause the protocol message size to be exceeded, causing this call to "
15568 "fail.  The caller must split up such requests into smaller groups of names."
15569 msgstr ""
15570
15571 #. type: =head2
15572 #: ../src/guestfs-actions.pod:5614
15573 msgid "guestfs_realpath"
15574 msgstr ""
15575
15576 #. type: verbatim
15577 #: ../src/guestfs-actions.pod:5616
15578 #, no-wrap
15579 msgid ""
15580 " char *\n"
15581 " guestfs_realpath (guestfs_h *g,\n"
15582 "                   const char *path);\n"
15583 "\n"
15584 msgstr ""
15585
15586 #. type: textblock
15587 #: ../src/guestfs-actions.pod:5620 ../fish/guestfish-actions.pod:3789
15588 msgid ""
15589 "Return the canonicalized absolute pathname of C<path>.  The returned path "
15590 "has no C<.>, C<..> or symbolic link path elements."
15591 msgstr ""
15592
15593 #. type: =head2
15594 #: ../src/guestfs-actions.pod:5628
15595 msgid "guestfs_removexattr"
15596 msgstr ""
15597
15598 #. type: verbatim
15599 #: ../src/guestfs-actions.pod:5630
15600 #, no-wrap
15601 msgid ""
15602 " int\n"
15603 " guestfs_removexattr (guestfs_h *g,\n"
15604 "                      const char *xattr,\n"
15605 "                      const char *path);\n"
15606 "\n"
15607 msgstr ""
15608
15609 #. type: textblock
15610 #: ../src/guestfs-actions.pod:5635 ../fish/guestfish-actions.pod:3796
15611 msgid ""
15612 "This call removes the extended attribute named C<xattr> of the file C<path>."
15613 msgstr ""
15614
15615 #. type: textblock
15616 #: ../src/guestfs-actions.pod:5638
15617 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>."
15618 msgstr ""
15619
15620 #. type: =head2
15621 #: ../src/guestfs-actions.pod:5644
15622 msgid "guestfs_resize2fs"
15623 msgstr ""
15624
15625 #. type: verbatim
15626 #: ../src/guestfs-actions.pod:5646
15627 #, no-wrap
15628 msgid ""
15629 " int\n"
15630 " guestfs_resize2fs (guestfs_h *g,\n"
15631 "                    const char *device);\n"
15632 "\n"
15633 msgstr ""
15634
15635 #. type: textblock
15636 #: ../src/guestfs-actions.pod:5650 ../fish/guestfish-actions.pod:3805
15637 msgid ""
15638 "This resizes an ext2, ext3 or ext4 filesystem to match the size of the "
15639 "underlying device."
15640 msgstr ""
15641
15642 #. type: textblock
15643 #: ../src/guestfs-actions.pod:5653
15644 msgid ""
15645 "I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the "
15646 "C<device> before calling this command.  For unknown reasons C<resize2fs> "
15647 "sometimes gives an error about this and sometimes not.  In any case, it is "
15648 "always safe to call C<guestfs_e2fsck_f> before calling this function."
15649 msgstr ""
15650
15651 #. type: =head2
15652 #: ../src/guestfs-actions.pod:5663
15653 msgid "guestfs_resize2fs_M"
15654 msgstr ""
15655
15656 #. type: verbatim
15657 #: ../src/guestfs-actions.pod:5665
15658 #, no-wrap
15659 msgid ""
15660 " int\n"
15661 " guestfs_resize2fs_M (guestfs_h *g,\n"
15662 "                      const char *device);\n"
15663 "\n"
15664 msgstr ""
15665
15666 #. type: textblock
15667 #: ../src/guestfs-actions.pod:5669
15668 msgid ""
15669 "This command is the same as C<guestfs_resize2fs>, but the filesystem is "
15670 "resized to its minimum size.  This works like the I<-M> option to the "
15671 "C<resize2fs> command."
15672 msgstr ""
15673
15674 #. type: textblock
15675 #: ../src/guestfs-actions.pod:5673
15676 msgid ""
15677 "To get the resulting size of the filesystem you should call "
15678 "C<guestfs_tune2fs_l> and read the C<Block size> and C<Block count> values.  "
15679 "These two numbers, multiplied together, give the resulting size of the "
15680 "minimal filesystem in bytes."
15681 msgstr ""
15682
15683 #. type: =head2
15684 #: ../src/guestfs-actions.pod:5680
15685 msgid "guestfs_resize2fs_size"
15686 msgstr ""
15687
15688 #. type: verbatim
15689 #: ../src/guestfs-actions.pod:5682
15690 #, no-wrap
15691 msgid ""
15692 " int\n"
15693 " guestfs_resize2fs_size (guestfs_h *g,\n"
15694 "                         const char *device,\n"
15695 "                         int64_t size);\n"
15696 "\n"
15697 msgstr ""
15698
15699 #. type: textblock
15700 #: ../src/guestfs-actions.pod:5687
15701 msgid ""
15702 "This command is the same as C<guestfs_resize2fs> except that it allows you "
15703 "to specify the new size (in bytes) explicitly."
15704 msgstr ""
15705
15706 #. type: =head2
15707 #: ../src/guestfs-actions.pod:5694
15708 msgid "guestfs_rm"
15709 msgstr ""
15710
15711 #. type: verbatim
15712 #: ../src/guestfs-actions.pod:5696
15713 #, no-wrap
15714 msgid ""
15715 " int\n"
15716 " guestfs_rm (guestfs_h *g,\n"
15717 "             const char *path);\n"
15718 "\n"
15719 msgstr ""
15720
15721 #. type: textblock
15722 #: ../src/guestfs-actions.pod:5700 ../fish/guestfish-actions.pod:3838
15723 msgid "Remove the single file C<path>."
15724 msgstr ""
15725
15726 #. type: =head2
15727 #: ../src/guestfs-actions.pod:5706
15728 msgid "guestfs_rm_rf"
15729 msgstr ""
15730
15731 #. type: verbatim
15732 #: ../src/guestfs-actions.pod:5708
15733 #, no-wrap
15734 msgid ""
15735 " int\n"
15736 " guestfs_rm_rf (guestfs_h *g,\n"
15737 "                const char *path);\n"
15738 "\n"
15739 msgstr ""
15740
15741 #. type: textblock
15742 #: ../src/guestfs-actions.pod:5712 ../fish/guestfish-actions.pod:3844
15743 msgid ""
15744 "Remove the file or directory C<path>, recursively removing the contents if "
15745 "its a directory.  This is like the C<rm -rf> shell command."
15746 msgstr ""
15747
15748 #. type: =head2
15749 #: ../src/guestfs-actions.pod:5720
15750 msgid "guestfs_rmdir"
15751 msgstr ""
15752
15753 #. type: verbatim
15754 #: ../src/guestfs-actions.pod:5722
15755 #, no-wrap
15756 msgid ""
15757 " int\n"
15758 " guestfs_rmdir (guestfs_h *g,\n"
15759 "                const char *path);\n"
15760 "\n"
15761 msgstr ""
15762
15763 #. type: textblock
15764 #: ../src/guestfs-actions.pod:5726 ../fish/guestfish-actions.pod:3852
15765 msgid "Remove the single directory C<path>."
15766 msgstr ""
15767
15768 #. type: =head2
15769 #: ../src/guestfs-actions.pod:5732
15770 msgid "guestfs_rmmountpoint"
15771 msgstr ""
15772
15773 #. type: verbatim
15774 #: ../src/guestfs-actions.pod:5734
15775 #, no-wrap
15776 msgid ""
15777 " int\n"
15778 " guestfs_rmmountpoint (guestfs_h *g,\n"
15779 "                       const char *exemptpath);\n"
15780 "\n"
15781 msgstr ""
15782
15783 #. type: textblock
15784 #: ../src/guestfs-actions.pod:5738
15785 msgid ""
15786 "This calls removes a mountpoint that was previously created with "
15787 "C<guestfs_mkmountpoint>.  See C<guestfs_mkmountpoint> for full details."
15788 msgstr ""
15789
15790 #. type: =head2
15791 #: ../src/guestfs-actions.pod:5746
15792 msgid "guestfs_scrub_device"
15793 msgstr ""
15794
15795 #. type: verbatim
15796 #: ../src/guestfs-actions.pod:5748
15797 #, no-wrap
15798 msgid ""
15799 " int\n"
15800 " guestfs_scrub_device (guestfs_h *g,\n"
15801 "                       const char *device);\n"
15802 "\n"
15803 msgstr ""
15804
15805 #. type: textblock
15806 #: ../src/guestfs-actions.pod:5752 ../fish/guestfish-actions.pod:3866
15807 msgid ""
15808 "This command writes patterns over C<device> to make data retrieval more "
15809 "difficult."
15810 msgstr ""
15811
15812 #. type: textblock
15813 #: ../src/guestfs-actions.pod:5755 ../src/guestfs-actions.pod:5776
15814 #: ../src/guestfs-actions.pod:5795 ../fish/guestfish-actions.pod:3869
15815 #: ../fish/guestfish-actions.pod:3884 ../fish/guestfish-actions.pod:3897
15816 msgid ""
15817 "It is an interface to the L<scrub(1)> program.  See that manual page for "
15818 "more details."
15819 msgstr ""
15820
15821 #. type: textblock
15822 #: ../src/guestfs-actions.pod:5763 ../src/guestfs-actions.pod:5781
15823 #: ../src/guestfs-actions.pod:5800
15824 msgid "(Added in 1.0.52)"
15825 msgstr ""
15826
15827 #. type: =head2
15828 #: ../src/guestfs-actions.pod:5765
15829 msgid "guestfs_scrub_file"
15830 msgstr ""
15831
15832 #. type: verbatim
15833 #: ../src/guestfs-actions.pod:5767
15834 #, no-wrap
15835 msgid ""
15836 " int\n"
15837 " guestfs_scrub_file (guestfs_h *g,\n"
15838 "                     const char *file);\n"
15839 "\n"
15840 msgstr ""
15841
15842 #. type: textblock
15843 #: ../src/guestfs-actions.pod:5771 ../fish/guestfish-actions.pod:3879
15844 msgid ""
15845 "This command writes patterns over a file to make data retrieval more "
15846 "difficult."
15847 msgstr ""
15848
15849 #. type: textblock
15850 #: ../src/guestfs-actions.pod:5774 ../fish/guestfish-actions.pod:3882
15851 msgid "The file is I<removed> after scrubbing."
15852 msgstr ""
15853
15854 #. type: =head2
15855 #: ../src/guestfs-actions.pod:5783
15856 msgid "guestfs_scrub_freespace"
15857 msgstr ""
15858
15859 #. type: verbatim
15860 #: ../src/guestfs-actions.pod:5785
15861 #, no-wrap
15862 msgid ""
15863 " int\n"
15864 " guestfs_scrub_freespace (guestfs_h *g,\n"
15865 "                          const char *dir);\n"
15866 "\n"
15867 msgstr ""
15868
15869 #. type: textblock
15870 #: ../src/guestfs-actions.pod:5789
15871 msgid ""
15872 "This command creates the directory C<dir> and then fills it with files until "
15873 "the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, "
15874 "and deletes them.  The intention is to scrub any free space on the partition "
15875 "containing C<dir>."
15876 msgstr ""
15877
15878 #. type: =head2
15879 #: ../src/guestfs-actions.pod:5802
15880 msgid "guestfs_set_append"
15881 msgstr ""
15882
15883 #. type: verbatim
15884 #: ../src/guestfs-actions.pod:5804
15885 #, no-wrap
15886 msgid ""
15887 " int\n"
15888 " guestfs_set_append (guestfs_h *g,\n"
15889 "                     const char *append);\n"
15890 "\n"
15891 msgstr ""
15892
15893 #. type: textblock
15894 #: ../src/guestfs-actions.pod:5808 ../fish/guestfish-actions.pod:3906
15895 msgid ""
15896 "This function is used to add additional options to the guest kernel command "
15897 "line."
15898 msgstr ""
15899
15900 #. type: textblock
15901 #: ../src/guestfs-actions.pod:5811 ../fish/guestfish-actions.pod:3909
15902 msgid ""
15903 "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> "
15904 "environment variable."
15905 msgstr ""
15906
15907 #. type: textblock
15908 #: ../src/guestfs-actions.pod:5814 ../fish/guestfish-actions.pod:3912
15909 msgid ""
15910 "Setting C<append> to C<NULL> means I<no> additional options are passed "
15911 "(libguestfs always adds a few of its own)."
15912 msgstr ""
15913
15914 #. type: =head2
15915 #: ../src/guestfs-actions.pod:5821
15916 msgid "guestfs_set_attach_method"
15917 msgstr ""
15918
15919 #. type: verbatim
15920 #: ../src/guestfs-actions.pod:5823
15921 #, no-wrap
15922 msgid ""
15923 " int\n"
15924 " guestfs_set_attach_method (guestfs_h *g,\n"
15925 "                            const char *attachmethod);\n"
15926 "\n"
15927 msgstr ""
15928
15929 #. type: textblock
15930 #: ../src/guestfs-actions.pod:5827 ../fish/guestfish-actions.pod:3921
15931 msgid ""
15932 "Set the method that libguestfs uses to connect to the back end guestfsd "
15933 "daemon.  Possible methods are:"
15934 msgstr ""
15935
15936 #. type: textblock
15937 #: ../src/guestfs-actions.pod:5834 ../fish/guestfish-actions.pod:3928
15938 msgid ""
15939 "Launch an appliance and connect to it.  This is the ordinary method and the "
15940 "default."
15941 msgstr ""
15942
15943 #. type: =item
15944 #: ../src/guestfs-actions.pod:5837 ../fish/guestfish-actions.pod:3931
15945 msgid "C<unix:I<path>>"
15946 msgstr ""
15947
15948 #. type: textblock
15949 #: ../src/guestfs-actions.pod:5839 ../fish/guestfish-actions.pod:3933
15950 msgid "Connect to the Unix domain socket I<path>."
15951 msgstr ""
15952
15953 #. type: textblock
15954 #: ../src/guestfs-actions.pod:5841 ../fish/guestfish-actions.pod:3935
15955 msgid ""
15956 "This method lets you connect to an existing daemon or (using virtio-serial) "
15957 "to a live guest.  For more information, see L<guestfs(3)/ATTACHING TO "
15958 "RUNNING DAEMONS>."
15959 msgstr ""
15960
15961 #. type: =head2
15962 #: ../src/guestfs-actions.pod:5849
15963 msgid "guestfs_set_autosync"
15964 msgstr ""
15965
15966 #. type: verbatim
15967 #: ../src/guestfs-actions.pod:5851
15968 #, no-wrap
15969 msgid ""
15970 " int\n"
15971 " guestfs_set_autosync (guestfs_h *g,\n"
15972 "                       int autosync);\n"
15973 "\n"
15974 msgstr ""
15975
15976 #. type: textblock
15977 #: ../src/guestfs-actions.pod:5855 ../fish/guestfish-actions.pod:3947
15978 msgid ""
15979 "If C<autosync> is true, this enables autosync.  Libguestfs will make a best "
15980 "effort attempt to make filesystems consistent and synchronized when the "
15981 "handle is closed (also if the program exits without closing handles)."
15982 msgstr ""
15983
15984 #. type: textblock
15985 #: ../src/guestfs-actions.pod:5860 ../fish/guestfish-actions.pod:3952
15986 msgid ""
15987 "This is enabled by default (since libguestfs 1.5.24, previously it was "
15988 "disabled by default)."
15989 msgstr ""
15990
15991 #. type: =head2
15992 #: ../src/guestfs-actions.pod:5867
15993 msgid "guestfs_set_direct"
15994 msgstr ""
15995
15996 #. type: verbatim
15997 #: ../src/guestfs-actions.pod:5869
15998 #, no-wrap
15999 msgid ""
16000 " int\n"
16001 " guestfs_set_direct (guestfs_h *g,\n"
16002 "                     int direct);\n"
16003 "\n"
16004 msgstr ""
16005
16006 #. type: textblock
16007 #: ../src/guestfs-actions.pod:5873 ../fish/guestfish-actions.pod:3961
16008 msgid ""
16009 "If the direct appliance mode flag is enabled, then stdin and stdout are "
16010 "passed directly through to the appliance once it is launched."
16011 msgstr ""
16012
16013 #. type: textblock
16014 #: ../src/guestfs-actions.pod:5877
16015 msgid ""
16016 "One consequence of this is that log messages aren't caught by the library "
16017 "and handled by C<guestfs_set_log_message_callback>, but go straight to "
16018 "stdout."
16019 msgstr ""
16020
16021 #. type: textblock
16022 #: ../src/guestfs-actions.pod:5881 ../fish/guestfish-actions.pod:3969
16023 msgid "You probably don't want to use this unless you know what you are doing."
16024 msgstr ""
16025
16026 #. type: textblock
16027 #: ../src/guestfs-actions.pod:5884 ../fish/guestfish-actions.pod:3972
16028 msgid "The default is disabled."
16029 msgstr ""
16030
16031 #. type: =head2
16032 #: ../src/guestfs-actions.pod:5890
16033 msgid "guestfs_set_e2label"
16034 msgstr ""
16035
16036 #. type: verbatim
16037 #: ../src/guestfs-actions.pod:5892
16038 #, no-wrap
16039 msgid ""
16040 " int\n"
16041 " guestfs_set_e2label (guestfs_h *g,\n"
16042 "                      const char *device,\n"
16043 "                      const char *label);\n"
16044 "\n"
16045 msgstr ""
16046
16047 #. type: textblock
16048 #: ../src/guestfs-actions.pod:5897 ../fish/guestfish-actions.pod:3978
16049 msgid ""
16050 "This sets the ext2/3/4 filesystem label of the filesystem on C<device> to "
16051 "C<label>.  Filesystem labels are limited to 16 characters."
16052 msgstr ""
16053
16054 #. type: textblock
16055 #: ../src/guestfs-actions.pod:5901
16056 msgid ""
16057 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return "
16058 "the existing label on a filesystem."
16059 msgstr ""
16060
16061 #. type: =head2
16062 #: ../src/guestfs-actions.pod:5908
16063 msgid "guestfs_set_e2uuid"
16064 msgstr ""
16065
16066 #. type: verbatim
16067 #: ../src/guestfs-actions.pod:5910
16068 #, no-wrap
16069 msgid ""
16070 " int\n"
16071 " guestfs_set_e2uuid (guestfs_h *g,\n"
16072 "                     const char *device,\n"
16073 "                     const char *uuid);\n"
16074 "\n"
16075 msgstr ""
16076
16077 #. type: textblock
16078 #: ../src/guestfs-actions.pod:5915 ../fish/guestfish-actions.pod:3989
16079 msgid ""
16080 "This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to "
16081 "C<uuid>.  The format of the UUID and alternatives such as C<clear>, "
16082 "C<random> and C<time> are described in the L<tune2fs(8)> manpage."
16083 msgstr ""
16084
16085 #. type: textblock
16086 #: ../src/guestfs-actions.pod:5920
16087 msgid ""
16088 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return "
16089 "the existing UUID of a filesystem."
16090 msgstr ""
16091
16092 #. type: =head2
16093 #: ../src/guestfs-actions.pod:5927
16094 msgid "guestfs_set_memsize"
16095 msgstr ""
16096
16097 #. type: verbatim
16098 #: ../src/guestfs-actions.pod:5929
16099 #, no-wrap
16100 msgid ""
16101 " int\n"
16102 " guestfs_set_memsize (guestfs_h *g,\n"
16103 "                      int memsize);\n"
16104 "\n"
16105 msgstr ""
16106
16107 #. type: textblock
16108 #: ../src/guestfs-actions.pod:5933
16109 msgid ""
16110 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
16111 "This only has any effect if called before C<guestfs_launch>."
16112 msgstr ""
16113
16114 #. type: textblock
16115 #: ../src/guestfs-actions.pod:5937 ../fish/guestfish-actions.pod:4007
16116 msgid ""
16117 "You can also change this by setting the environment variable "
16118 "C<LIBGUESTFS_MEMSIZE> before the handle is created."
16119 msgstr ""
16120
16121 #. type: =head2
16122 #: ../src/guestfs-actions.pod:5948
16123 msgid "guestfs_set_network"
16124 msgstr ""
16125
16126 #. type: verbatim
16127 #: ../src/guestfs-actions.pod:5950
16128 #, no-wrap
16129 msgid ""
16130 " int\n"
16131 " guestfs_set_network (guestfs_h *g,\n"
16132 "                      int network);\n"
16133 "\n"
16134 msgstr ""
16135
16136 #. type: textblock
16137 #: ../src/guestfs-actions.pod:5954 ../fish/guestfish-actions.pod:4020
16138 msgid ""
16139 "If C<network> is true, then the network is enabled in the libguestfs "
16140 "appliance.  The default is false."
16141 msgstr ""
16142
16143 #. type: textblock
16144 #: ../src/guestfs-actions.pod:5957 ../fish/guestfish-actions.pod:4023
16145 msgid ""
16146 "This affects whether commands are able to access the network (see L<guestfs"
16147 "(3)/RUNNING COMMANDS>)."
16148 msgstr ""
16149
16150 #. type: textblock
16151 #: ../src/guestfs-actions.pod:5960
16152 msgid ""
16153 "You must call this before calling C<guestfs_launch>, otherwise it has no "
16154 "effect."
16155 msgstr ""
16156
16157 #. type: =head2
16158 #: ../src/guestfs-actions.pod:5967
16159 msgid "guestfs_set_path"
16160 msgstr ""
16161
16162 #. type: verbatim
16163 #: ../src/guestfs-actions.pod:5969
16164 #, no-wrap
16165 msgid ""
16166 " int\n"
16167 " guestfs_set_path (guestfs_h *g,\n"
16168 "                   const char *searchpath);\n"
16169 "\n"
16170 msgstr ""
16171
16172 #. type: textblock
16173 #: ../src/guestfs-actions.pod:5973 ../fish/guestfish-actions.pod:4035
16174 msgid "Set the path that libguestfs searches for kernel and initrd.img."
16175 msgstr ""
16176
16177 #. type: textblock
16178 #: ../src/guestfs-actions.pod:5975 ../fish/guestfish-actions.pod:4037
16179 msgid ""
16180 "The default is C<$libdir/guestfs> unless overridden by setting "
16181 "C<LIBGUESTFS_PATH> environment variable."
16182 msgstr ""
16183
16184 #. type: textblock
16185 #: ../src/guestfs-actions.pod:5978 ../fish/guestfish-actions.pod:4040
16186 msgid "Setting C<path> to C<NULL> restores the default path."
16187 msgstr ""
16188
16189 #. type: =head2
16190 #: ../src/guestfs-actions.pod:5984
16191 msgid "guestfs_set_qemu"
16192 msgstr ""
16193
16194 #. type: verbatim
16195 #: ../src/guestfs-actions.pod:5986
16196 #, no-wrap
16197 msgid ""
16198 " int\n"
16199 " guestfs_set_qemu (guestfs_h *g,\n"
16200 "                   const char *qemu);\n"
16201 "\n"
16202 msgstr ""
16203
16204 #. type: textblock
16205 #: ../src/guestfs-actions.pod:5990 ../fish/guestfish-actions.pod:4048
16206 msgid "Set the qemu binary that we will use."
16207 msgstr ""
16208
16209 #. type: textblock
16210 #: ../src/guestfs-actions.pod:5992 ../fish/guestfish-actions.pod:4050
16211 msgid ""
16212 "The default is chosen when the library was compiled by the configure script."
16213 msgstr ""
16214
16215 #. type: textblock
16216 #: ../src/guestfs-actions.pod:5995 ../fish/guestfish-actions.pod:4053
16217 msgid ""
16218 "You can also override this by setting the C<LIBGUESTFS_QEMU> environment "
16219 "variable."
16220 msgstr ""
16221
16222 #. type: textblock
16223 #: ../src/guestfs-actions.pod:5998 ../fish/guestfish-actions.pod:4056
16224 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary."
16225 msgstr ""
16226
16227 #. type: textblock
16228 #: ../src/guestfs-actions.pod:6000 ../fish/guestfish-actions.pod:4058
16229 msgid ""
16230 "Note that you should call this function as early as possible after creating "
16231 "the handle.  This is because some pre-launch operations depend on testing "
16232 "qemu features (by running C<qemu -help>).  If the qemu binary changes, we "
16233 "don't retest features, and so you might see inconsistent results.  Using the "
16234 "environment variable C<LIBGUESTFS_QEMU> is safest of all since that picks "
16235 "the qemu binary at the same time as the handle is created."
16236 msgstr ""
16237
16238 #. type: =head2
16239 #: ../src/guestfs-actions.pod:6012
16240 msgid "guestfs_set_recovery_proc"
16241 msgstr ""
16242
16243 #. type: verbatim
16244 #: ../src/guestfs-actions.pod:6014
16245 #, no-wrap
16246 msgid ""
16247 " int\n"
16248 " guestfs_set_recovery_proc (guestfs_h *g,\n"
16249 "                            int recoveryproc);\n"
16250 "\n"
16251 msgstr ""
16252
16253 #. type: textblock
16254 #: ../src/guestfs-actions.pod:6018
16255 msgid ""
16256 "If this is called with the parameter C<false> then C<guestfs_launch> does "
16257 "not create a recovery process.  The purpose of the recovery process is to "
16258 "stop runaway qemu processes in the case where the main program aborts "
16259 "abruptly."
16260 msgstr ""
16261
16262 #. type: textblock
16263 #: ../src/guestfs-actions.pod:6023
16264 msgid ""
16265 "This only has any effect if called before C<guestfs_launch>, and the default "
16266 "is true."
16267 msgstr ""
16268
16269 #. type: textblock
16270 #: ../src/guestfs-actions.pod:6026 ../fish/guestfish-actions.pod:4080
16271 msgid ""
16272 "About the only time when you would want to disable this is if the main "
16273 "process will fork itself into the background (\"daemonize\" itself).  In "
16274 "this case the recovery process thinks that the main program has disappeared "
16275 "and so kills qemu, which is not very helpful."
16276 msgstr ""
16277
16278 #. type: =head2
16279 #: ../src/guestfs-actions.pod:6036
16280 msgid "guestfs_set_selinux"
16281 msgstr ""
16282
16283 #. type: verbatim
16284 #: ../src/guestfs-actions.pod:6038
16285 #, no-wrap
16286 msgid ""
16287 " int\n"
16288 " guestfs_set_selinux (guestfs_h *g,\n"
16289 "                      int selinux);\n"
16290 "\n"
16291 msgstr ""
16292
16293 #. type: textblock
16294 #: ../src/guestfs-actions.pod:6042 ../fish/guestfish-actions.pod:4092
16295 msgid ""
16296 "This sets the selinux flag that is passed to the appliance at boot time.  "
16297 "The default is C<selinux=0> (disabled)."
16298 msgstr ""
16299
16300 #. type: textblock
16301 #: ../src/guestfs-actions.pod:6045 ../fish/guestfish-actions.pod:4095
16302 msgid ""
16303 "Note that if SELinux is enabled, it is always in Permissive mode "
16304 "(C<enforcing=0>)."
16305 msgstr ""
16306
16307 #. type: =head2
16308 #: ../src/guestfs-actions.pod:6055
16309 msgid "guestfs_set_trace"
16310 msgstr ""
16311
16312 #. type: verbatim
16313 #: ../src/guestfs-actions.pod:6057
16314 #, no-wrap
16315 msgid ""
16316 " int\n"
16317 " guestfs_set_trace (guestfs_h *g,\n"
16318 "                    int trace);\n"
16319 "\n"
16320 msgstr ""
16321
16322 #. type: textblock
16323 #: ../src/guestfs-actions.pod:6061 ../fish/guestfish-actions.pod:4107
16324 msgid ""
16325 "If the command trace flag is set to 1, then libguestfs calls, parameters and "
16326 "return values are traced."
16327 msgstr ""
16328
16329 #. type: textblock
16330 #: ../src/guestfs-actions.pod:6064 ../fish/guestfish-actions.pod:4110
16331 msgid ""
16332 "If you want to trace C API calls into libguestfs (and other libraries) then "
16333 "possibly a better way is to use the external ltrace(1) command."
16334 msgstr ""
16335
16336 #. type: textblock
16337 #: ../src/guestfs-actions.pod:6068 ../fish/guestfish-actions.pod:4114
16338 msgid ""
16339 "Command traces are disabled unless the environment variable "
16340 "C<LIBGUESTFS_TRACE> is defined and set to C<1>."
16341 msgstr ""
16342
16343 #. type: textblock
16344 #: ../src/guestfs-actions.pod:6071
16345 msgid ""
16346 "Trace messages are normally sent to C<stderr>, unless you register a "
16347 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
16348 msgstr ""
16349
16350 #. type: =head2
16351 #: ../src/guestfs-actions.pod:6079
16352 msgid "guestfs_set_verbose"
16353 msgstr ""
16354
16355 #. type: verbatim
16356 #: ../src/guestfs-actions.pod:6081
16357 #, no-wrap
16358 msgid ""
16359 " int\n"
16360 " guestfs_set_verbose (guestfs_h *g,\n"
16361 "                      int verbose);\n"
16362 "\n"
16363 msgstr ""
16364
16365 #. type: textblock
16366 #: ../src/guestfs-actions.pod:6085 ../fish/guestfish-actions.pod:4127
16367 msgid "If C<verbose> is true, this turns on verbose messages."
16368 msgstr ""
16369
16370 #. type: textblock
16371 #: ../src/guestfs-actions.pod:6087 ../fish/guestfish-actions.pod:4129
16372 msgid ""
16373 "Verbose messages are disabled unless the environment variable "
16374 "C<LIBGUESTFS_DEBUG> is defined and set to C<1>."
16375 msgstr ""
16376
16377 #. type: textblock
16378 #: ../src/guestfs-actions.pod:6090
16379 msgid ""
16380 "Verbose messages are normally sent to C<stderr>, unless you register a "
16381 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
16382 msgstr ""
16383
16384 #. type: =head2
16385 #: ../src/guestfs-actions.pod:6098
16386 msgid "guestfs_setcon"
16387 msgstr ""
16388
16389 #. type: verbatim
16390 #: ../src/guestfs-actions.pod:6100
16391 #, no-wrap
16392 msgid ""
16393 " int\n"
16394 " guestfs_setcon (guestfs_h *g,\n"
16395 "                 const char *context);\n"
16396 "\n"
16397 msgstr ""
16398
16399 #. type: textblock
16400 #: ../src/guestfs-actions.pod:6104 ../fish/guestfish-actions.pod:4140
16401 msgid ""
16402 "This sets the SELinux security context of the daemon to the string "
16403 "C<context>."
16404 msgstr ""
16405
16406 #. type: textblock
16407 #: ../src/guestfs-actions.pod:6107 ../fish/guestfish-actions.pod:4143
16408 msgid "See the documentation about SELINUX in L<guestfs(3)>."
16409 msgstr ""
16410
16411 #. type: =head2
16412 #: ../src/guestfs-actions.pod:6113
16413 msgid "guestfs_setxattr"
16414 msgstr ""
16415
16416 #. type: verbatim
16417 #: ../src/guestfs-actions.pod:6115
16418 #, no-wrap
16419 msgid ""
16420 " int\n"
16421 " guestfs_setxattr (guestfs_h *g,\n"
16422 "                   const char *xattr,\n"
16423 "                   const char *val,\n"
16424 "                   int vallen,\n"
16425 "                   const char *path);\n"
16426 "\n"
16427 msgstr ""
16428
16429 #. type: textblock
16430 #: ../src/guestfs-actions.pod:6122 ../fish/guestfish-actions.pod:4149
16431 msgid ""
16432 "This call sets the extended attribute named C<xattr> of the file C<path> to "
16433 "the value C<val> (of length C<vallen>).  The value is arbitrary 8 bit data."
16434 msgstr ""
16435
16436 #. type: textblock
16437 #: ../src/guestfs-actions.pod:6126
16438 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>."
16439 msgstr ""
16440
16441 #. type: =head2
16442 #: ../src/guestfs-actions.pod:6132
16443 msgid "guestfs_sfdisk"
16444 msgstr ""
16445
16446 #. type: verbatim
16447 #: ../src/guestfs-actions.pod:6134
16448 #, no-wrap
16449 msgid ""
16450 " int\n"
16451 " guestfs_sfdisk (guestfs_h *g,\n"
16452 "                 const char *device,\n"
16453 "                 int cyls,\n"
16454 "                 int heads,\n"
16455 "                 int sectors,\n"
16456 "                 char *const *lines);\n"
16457 "\n"
16458 msgstr ""
16459
16460 #. type: textblock
16461 #: ../src/guestfs-actions.pod:6142 ../fish/guestfish-actions.pod:4159
16462 msgid ""
16463 "This is a direct interface to the L<sfdisk(8)> program for creating "
16464 "partitions on block devices."
16465 msgstr ""
16466
16467 #. type: textblock
16468 #: ../src/guestfs-actions.pod:6145 ../fish/guestfish-actions.pod:4162
16469 msgid "C<device> should be a block device, for example C</dev/sda>."
16470 msgstr ""
16471
16472 #. type: textblock
16473 #: ../src/guestfs-actions.pod:6147 ../fish/guestfish-actions.pod:4164
16474 msgid ""
16475 "C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and "
16476 "sectors on the device, which are passed directly to sfdisk as the I<-C>, I<-"
16477 "H> and I<-S> parameters.  If you pass C<0> for any of these, then the "
16478 "corresponding parameter is omitted.  Usually for 'large' disks, you can just "
16479 "pass C<0> for these, but for small (floppy-sized) disks, sfdisk (or rather, "
16480 "the kernel) cannot work out the right geometry and you will need to tell it."
16481 msgstr ""
16482
16483 #. type: textblock
16484 #: ../src/guestfs-actions.pod:6155 ../fish/guestfish-actions.pod:4172
16485 msgid ""
16486 "C<lines> is a list of lines that we feed to C<sfdisk>.  For more information "
16487 "refer to the L<sfdisk(8)> manpage."
16488 msgstr ""
16489
16490 #. type: textblock
16491 #: ../src/guestfs-actions.pod:6158 ../fish/guestfish-actions.pod:4175
16492 msgid ""
16493 "To create a single partition occupying the whole disk, you would pass "
16494 "C<lines> as a single element list, when the single element being the string "
16495 "C<,> (comma)."
16496 msgstr ""
16497
16498 #. type: textblock
16499 #: ../src/guestfs-actions.pod:6162
16500 msgid ""
16501 "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>"
16502 msgstr ""
16503
16504 #. type: textblock
16505 #: ../src/guestfs-actions.pod:6170 ../src/guestfs-actions.pod:6200
16506 #: ../src/guestfs-actions.pod:6233
16507 msgid ""
16508 "This function is deprecated.  In new code, use the L</guestfs_part_add> call "
16509 "instead."
16510 msgstr ""
16511
16512 #. type: =head2
16513 #: ../src/guestfs-actions.pod:6179
16514 msgid "guestfs_sfdiskM"
16515 msgstr ""
16516
16517 #. type: verbatim
16518 #: ../src/guestfs-actions.pod:6181
16519 #, no-wrap
16520 msgid ""
16521 " int\n"
16522 " guestfs_sfdiskM (guestfs_h *g,\n"
16523 "                  const char *device,\n"
16524 "                  char *const *lines);\n"
16525 "\n"
16526 msgstr ""
16527
16528 #. type: textblock
16529 #: ../src/guestfs-actions.pod:6186
16530 msgid ""
16531 "This is a simplified interface to the C<guestfs_sfdisk> command, where "
16532 "partition sizes are specified in megabytes only (rounded to the nearest "
16533 "cylinder) and you don't need to specify the cyls, heads and sectors "
16534 "parameters which were rarely if ever used anyway."
16535 msgstr ""
16536
16537 #. type: textblock
16538 #: ../src/guestfs-actions.pod:6192
16539 msgid ""
16540 "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and "
16541 "C<guestfs_part_disk>"
16542 msgstr ""
16543
16544 #. type: =head2
16545 #: ../src/guestfs-actions.pod:6209
16546 msgid "guestfs_sfdisk_N"
16547 msgstr ""
16548
16549 #. type: verbatim
16550 #: ../src/guestfs-actions.pod:6211
16551 #, no-wrap
16552 msgid ""
16553 " int\n"
16554 " guestfs_sfdisk_N (guestfs_h *g,\n"
16555 "                   const char *device,\n"
16556 "                   int partnum,\n"
16557 "                   int cyls,\n"
16558 "                   int heads,\n"
16559 "                   int sectors,\n"
16560 "                   const char *line);\n"
16561 "\n"
16562 msgstr ""
16563
16564 #. type: textblock
16565 #: ../src/guestfs-actions.pod:6220 ../fish/guestfish-actions.pod:4219
16566 msgid ""
16567 "This runs L<sfdisk(8)> option to modify just the single partition C<n> "
16568 "(note: C<n> counts from 1)."
16569 msgstr ""
16570
16571 #. type: textblock
16572 #: ../src/guestfs-actions.pod:6223
16573 msgid ""
16574 "For other parameters, see C<guestfs_sfdisk>.  You should usually pass C<0> "
16575 "for the cyls/heads/sectors parameters."
16576 msgstr ""
16577
16578 #. type: textblock
16579 #: ../src/guestfs-actions.pod:6226
16580 msgid "See also: C<guestfs_part_add>"
16581 msgstr ""
16582
16583 #. type: =head2
16584 #: ../src/guestfs-actions.pod:6242
16585 msgid "guestfs_sfdisk_disk_geometry"
16586 msgstr ""
16587
16588 #. type: verbatim
16589 #: ../src/guestfs-actions.pod:6244
16590 #, no-wrap
16591 msgid ""
16592 " char *\n"
16593 " guestfs_sfdisk_disk_geometry (guestfs_h *g,\n"
16594 "                               const char *device);\n"
16595 "\n"
16596 msgstr ""
16597
16598 #. type: textblock
16599 #: ../src/guestfs-actions.pod:6248
16600 msgid ""
16601 "This displays the disk geometry of C<device> read from the partition table.  "
16602 "Especially in the case where the underlying block device has been resized, "
16603 "this can be different from the kernel's idea of the geometry (see "
16604 "C<guestfs_sfdisk_kernel_geometry>)."
16605 msgstr ""
16606
16607 #. type: textblock
16608 #: ../src/guestfs-actions.pod:6253 ../src/guestfs-actions.pod:6269
16609 #: ../fish/guestfish-actions.pod:4246 ../fish/guestfish-actions.pod:4255
16610 msgid "The result is in human-readable format, and not designed to be parsed."
16611 msgstr ""
16612
16613 #. type: =head2
16614 #: ../src/guestfs-actions.pod:6261
16615 msgid "guestfs_sfdisk_kernel_geometry"
16616 msgstr ""
16617
16618 #. type: verbatim
16619 #: ../src/guestfs-actions.pod:6263
16620 #, no-wrap
16621 msgid ""
16622 " char *\n"
16623 " guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n"
16624 "                                 const char *device);\n"
16625 "\n"
16626 msgstr ""
16627
16628 #. type: textblock
16629 #: ../src/guestfs-actions.pod:6267 ../fish/guestfish-actions.pod:4253
16630 msgid "This displays the kernel's idea of the geometry of C<device>."
16631 msgstr ""
16632
16633 #. type: =head2
16634 #: ../src/guestfs-actions.pod:6277
16635 msgid "guestfs_sfdisk_l"
16636 msgstr ""
16637
16638 #. type: verbatim
16639 #: ../src/guestfs-actions.pod:6279
16640 #, no-wrap
16641 msgid ""
16642 " char *\n"
16643 " guestfs_sfdisk_l (guestfs_h *g,\n"
16644 "                   const char *device);\n"
16645 "\n"
16646 msgstr ""
16647
16648 #. type: textblock
16649 #: ../src/guestfs-actions.pod:6283 ../fish/guestfish-actions.pod:4262
16650 msgid ""
16651 "This displays the partition table on C<device>, in the human-readable output "
16652 "of the L<sfdisk(8)> command.  It is not intended to be parsed."
16653 msgstr ""
16654
16655 #. type: textblock
16656 #: ../src/guestfs-actions.pod:6287
16657 msgid "See also: C<guestfs_part_list>"
16658 msgstr ""
16659
16660 #. type: textblock
16661 #: ../src/guestfs-actions.pod:6292
16662 msgid ""
16663 "This function is deprecated.  In new code, use the L</guestfs_part_list> "
16664 "call instead."
16665 msgstr ""
16666
16667 #. type: =head2
16668 #: ../src/guestfs-actions.pod:6301
16669 msgid "guestfs_sh"
16670 msgstr ""
16671
16672 #. type: verbatim
16673 #: ../src/guestfs-actions.pod:6303
16674 #, no-wrap
16675 msgid ""
16676 " char *\n"
16677 " guestfs_sh (guestfs_h *g,\n"
16678 "             const char *command);\n"
16679 "\n"
16680 msgstr ""
16681
16682 #. type: textblock
16683 #: ../src/guestfs-actions.pod:6307 ../fish/guestfish-actions.pod:4279
16684 msgid ""
16685 "This call runs a command from the guest filesystem via the guest's C</bin/"
16686 "sh>."
16687 msgstr ""
16688
16689 #. type: textblock
16690 #: ../src/guestfs-actions.pod:6310
16691 msgid "This is like C<guestfs_command>, but passes the command to:"
16692 msgstr ""
16693
16694 #. type: verbatim
16695 #: ../src/guestfs-actions.pod:6312 ../fish/guestfish-actions.pod:4284
16696 #, no-wrap
16697 msgid ""
16698 " /bin/sh -c \"command\"\n"
16699 "\n"
16700 msgstr ""
16701
16702 #. type: textblock
16703 #: ../src/guestfs-actions.pod:6314 ../fish/guestfish-actions.pod:4286
16704 msgid ""
16705 "Depending on the guest's shell, this usually results in wildcards being "
16706 "expanded, shell expressions being interpolated and so on."
16707 msgstr ""
16708
16709 #. type: textblock
16710 #: ../src/guestfs-actions.pod:6318
16711 msgid "All the provisos about C<guestfs_command> apply to this call."
16712 msgstr ""
16713
16714 #. type: =head2
16715 #: ../src/guestfs-actions.pod:6325
16716 msgid "guestfs_sh_lines"
16717 msgstr ""
16718
16719 #. type: verbatim
16720 #: ../src/guestfs-actions.pod:6327
16721 #, no-wrap
16722 msgid ""
16723 " char **\n"
16724 " guestfs_sh_lines (guestfs_h *g,\n"
16725 "                   const char *command);\n"
16726 "\n"
16727 msgstr ""
16728
16729 #. type: textblock
16730 #: ../src/guestfs-actions.pod:6331
16731 msgid ""
16732 "This is the same as C<guestfs_sh>, but splits the result into a list of "
16733 "lines."
16734 msgstr ""
16735
16736 #. type: textblock
16737 #: ../src/guestfs-actions.pod:6334
16738 msgid "See also: C<guestfs_command_lines>"
16739 msgstr ""
16740
16741 #. type: =head2
16742 #: ../src/guestfs-actions.pod:6342
16743 msgid "guestfs_sleep"
16744 msgstr ""
16745
16746 #. type: verbatim
16747 #: ../src/guestfs-actions.pod:6344
16748 #, no-wrap
16749 msgid ""
16750 " int\n"
16751 " guestfs_sleep (guestfs_h *g,\n"
16752 "                int secs);\n"
16753 "\n"
16754 msgstr ""
16755
16756 #. type: textblock
16757 #: ../src/guestfs-actions.pod:6348 ../fish/guestfish-actions.pod:4305
16758 msgid "Sleep for C<secs> seconds."
16759 msgstr ""
16760
16761 #. type: textblock
16762 #: ../src/guestfs-actions.pod:6352
16763 msgid "(Added in 1.0.41)"
16764 msgstr ""
16765
16766 #. type: =head2
16767 #: ../src/guestfs-actions.pod:6354 ../src/guestfs-structs.pod:109
16768 msgid "guestfs_stat"
16769 msgstr ""
16770
16771 #. type: verbatim
16772 #: ../src/guestfs-actions.pod:6356
16773 #, no-wrap
16774 msgid ""
16775 " struct guestfs_stat *\n"
16776 " guestfs_stat (guestfs_h *g,\n"
16777 "               const char *path);\n"
16778 "\n"
16779 msgstr ""
16780
16781 #. type: textblock
16782 #: ../src/guestfs-actions.pod:6362 ../fish/guestfish-actions.pod:4313
16783 msgid "This is the same as the C<stat(2)> system call."
16784 msgstr ""
16785
16786 #. type: =head2
16787 #: ../src/guestfs-actions.pod:6370 ../src/guestfs-structs.pod:135
16788 msgid "guestfs_statvfs"
16789 msgstr ""
16790
16791 #. type: verbatim
16792 #: ../src/guestfs-actions.pod:6372
16793 #, no-wrap
16794 msgid ""
16795 " struct guestfs_statvfs *\n"
16796 " guestfs_statvfs (guestfs_h *g,\n"
16797 "                  const char *path);\n"
16798 "\n"
16799 msgstr ""
16800
16801 #. type: textblock
16802 #: ../src/guestfs-actions.pod:6376 ../fish/guestfish-actions.pod:4319
16803 msgid ""
16804 "Returns file system statistics for any mounted file system.  C<path> should "
16805 "be a file or directory in the mounted file system (typically it is the mount "
16806 "point itself, but it doesn't need to be)."
16807 msgstr ""
16808
16809 #. type: textblock
16810 #: ../src/guestfs-actions.pod:6380 ../fish/guestfish-actions.pod:4323
16811 msgid "This is the same as the C<statvfs(2)> system call."
16812 msgstr ""
16813
16814 #. type: textblock
16815 #: ../src/guestfs-actions.pod:6382
16816 msgid ""
16817 "This function returns a C<struct guestfs_statvfs *>, or NULL if there was an "
16818 "error.  I<The caller must call C<guestfs_free_statvfs> after use>."
16819 msgstr ""
16820
16821 #. type: =head2
16822 #: ../src/guestfs-actions.pod:6388
16823 msgid "guestfs_strings"
16824 msgstr ""
16825
16826 #. type: verbatim
16827 #: ../src/guestfs-actions.pod:6390
16828 #, no-wrap
16829 msgid ""
16830 " char **\n"
16831 " guestfs_strings (guestfs_h *g,\n"
16832 "                  const char *path);\n"
16833 "\n"
16834 msgstr ""
16835
16836 #. type: textblock
16837 #: ../src/guestfs-actions.pod:6394 ../fish/guestfish-actions.pod:4329
16838 msgid ""
16839 "This runs the L<strings(1)> command on a file and returns the list of "
16840 "printable strings found."
16841 msgstr ""
16842
16843 #. type: =head2
16844 #: ../src/guestfs-actions.pod:6406
16845 msgid "guestfs_strings_e"
16846 msgstr ""
16847
16848 #. type: verbatim
16849 #: ../src/guestfs-actions.pod:6408
16850 #, no-wrap
16851 msgid ""
16852 " char **\n"
16853 " guestfs_strings_e (guestfs_h *g,\n"
16854 "                    const char *encoding,\n"
16855 "                    const char *path);\n"
16856 "\n"
16857 msgstr ""
16858
16859 #. type: textblock
16860 #: ../src/guestfs-actions.pod:6413
16861 msgid ""
16862 "This is like the C<guestfs_strings> command, but allows you to specify the "
16863 "encoding of strings that are looked for in the source file C<path>."
16864 msgstr ""
16865
16866 #. type: textblock
16867 #: ../src/guestfs-actions.pod:6417 ../fish/guestfish-actions.pod:4343
16868 msgid "Allowed encodings are:"
16869 msgstr ""
16870
16871 #. type: =item
16872 #: ../src/guestfs-actions.pod:6421 ../fish/guestfish-actions.pod:4347
16873 msgid "s"
16874 msgstr ""
16875
16876 #. type: textblock
16877 #: ../src/guestfs-actions.pod:6423
16878 msgid ""
16879 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
16880 "ISO-8859-X (this is what C<guestfs_strings> uses)."
16881 msgstr ""
16882
16883 #. type: =item
16884 #: ../src/guestfs-actions.pod:6426 ../fish/guestfish-actions.pod:4352
16885 msgid "S"
16886 msgstr ""
16887
16888 #. type: textblock
16889 #: ../src/guestfs-actions.pod:6428 ../fish/guestfish-actions.pod:4354
16890 msgid "Single 8-bit-byte characters."
16891 msgstr ""
16892
16893 #. type: =item
16894 #: ../src/guestfs-actions.pod:6430 ../fish/guestfish-actions.pod:4356
16895 msgid "b"
16896 msgstr ""
16897
16898 #. type: textblock
16899 #: ../src/guestfs-actions.pod:6432 ../fish/guestfish-actions.pod:4358
16900 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE."
16901 msgstr ""
16902
16903 #. type: =item
16904 #: ../src/guestfs-actions.pod:6435 ../fish/guestfish-actions.pod:4361
16905 msgid "l (lower case letter L)"
16906 msgstr ""
16907
16908 #. type: textblock
16909 #: ../src/guestfs-actions.pod:6437 ../fish/guestfish-actions.pod:4363
16910 msgid ""
16911 "16-bit little endian such as UTF-16LE and UCS-2LE.  This is useful for "
16912 "examining binaries in Windows guests."
16913 msgstr ""
16914
16915 #. type: =item
16916 #: ../src/guestfs-actions.pod:6440 ../fish/guestfish-actions.pod:4366
16917 msgid "B"
16918 msgstr ""
16919
16920 #. type: textblock
16921 #: ../src/guestfs-actions.pod:6442 ../fish/guestfish-actions.pod:4368
16922 msgid "32-bit big endian such as UCS-4BE."
16923 msgstr ""
16924
16925 #. type: =item
16926 #: ../src/guestfs-actions.pod:6444 ../fish/guestfish-actions.pod:4370
16927 msgid "L"
16928 msgstr ""
16929
16930 #. type: textblock
16931 #: ../src/guestfs-actions.pod:6446 ../fish/guestfish-actions.pod:4372
16932 msgid "32-bit little endian such as UCS-4LE."
16933 msgstr ""
16934
16935 #. type: textblock
16936 #: ../src/guestfs-actions.pod:6450 ../fish/guestfish-actions.pod:4376
16937 msgid "The returned strings are transcoded to UTF-8."
16938 msgstr ""
16939
16940 #. type: =head2
16941 #: ../src/guestfs-actions.pod:6461
16942 msgid "guestfs_swapoff_device"
16943 msgstr ""
16944
16945 #. type: verbatim
16946 #: ../src/guestfs-actions.pod:6463
16947 #, no-wrap
16948 msgid ""
16949 " int\n"
16950 " guestfs_swapoff_device (guestfs_h *g,\n"
16951 "                         const char *device);\n"
16952 "\n"
16953 msgstr ""
16954
16955 #. type: textblock
16956 #: ../src/guestfs-actions.pod:6467
16957 msgid ""
16958 "This command disables the libguestfs appliance swap device or partition "
16959 "named C<device>.  See C<guestfs_swapon_device>."
16960 msgstr ""
16961
16962 #. type: =head2
16963 #: ../src/guestfs-actions.pod:6475
16964 msgid "guestfs_swapoff_file"
16965 msgstr ""
16966
16967 #. type: verbatim
16968 #: ../src/guestfs-actions.pod:6477
16969 #, no-wrap
16970 msgid ""
16971 " int\n"
16972 " guestfs_swapoff_file (guestfs_h *g,\n"
16973 "                       const char *file);\n"
16974 "\n"
16975 msgstr ""
16976
16977 #. type: textblock
16978 #: ../src/guestfs-actions.pod:6481 ../fish/guestfish-actions.pod:4393
16979 msgid "This command disables the libguestfs appliance swap on file."
16980 msgstr ""
16981
16982 #. type: =head2
16983 #: ../src/guestfs-actions.pod:6487
16984 msgid "guestfs_swapoff_label"
16985 msgstr ""
16986
16987 #. type: verbatim
16988 #: ../src/guestfs-actions.pod:6489
16989 #, no-wrap
16990 msgid ""
16991 " int\n"
16992 " guestfs_swapoff_label (guestfs_h *g,\n"
16993 "                        const char *label);\n"
16994 "\n"
16995 msgstr ""
16996
16997 #. type: textblock
16998 #: ../src/guestfs-actions.pod:6493 ../fish/guestfish-actions.pod:4399
16999 msgid ""
17000 "This command disables the libguestfs appliance swap on labeled swap "
17001 "partition."
17002 msgstr ""
17003
17004 #. type: =head2
17005 #: ../src/guestfs-actions.pod:6500
17006 msgid "guestfs_swapoff_uuid"
17007 msgstr ""
17008
17009 #. type: verbatim
17010 #: ../src/guestfs-actions.pod:6502
17011 #, no-wrap
17012 msgid ""
17013 " int\n"
17014 " guestfs_swapoff_uuid (guestfs_h *g,\n"
17015 "                       const char *uuid);\n"
17016 "\n"
17017 msgstr ""
17018
17019 #. type: textblock
17020 #: ../src/guestfs-actions.pod:6506 ../fish/guestfish-actions.pod:4406
17021 msgid ""
17022 "This command disables the libguestfs appliance swap partition with the given "
17023 "UUID."
17024 msgstr ""
17025
17026 #. type: =head2
17027 #: ../src/guestfs-actions.pod:6513
17028 msgid "guestfs_swapon_device"
17029 msgstr ""
17030
17031 #. type: verbatim
17032 #: ../src/guestfs-actions.pod:6515
17033 #, no-wrap
17034 msgid ""
17035 " int\n"
17036 " guestfs_swapon_device (guestfs_h *g,\n"
17037 "                        const char *device);\n"
17038 "\n"
17039 msgstr ""
17040
17041 #. type: textblock
17042 #: ../src/guestfs-actions.pod:6519
17043 msgid ""
17044 "This command enables the libguestfs appliance to use the swap device or "
17045 "partition named C<device>.  The increased memory is made available for all "
17046 "commands, for example those run using C<guestfs_command> or C<guestfs_sh>."
17047 msgstr ""
17048
17049 #. type: textblock
17050 #: ../src/guestfs-actions.pod:6524 ../fish/guestfish-actions.pod:4418
17051 msgid ""
17052 "Note that you should not swap to existing guest swap partitions unless you "
17053 "know what you are doing.  They may contain hibernation information, or other "
17054 "information that the guest doesn't want you to trash.  You also risk leaking "
17055 "information about the host to the guest this way.  Instead, attach a new "
17056 "host device to the guest and swap on that."
17057 msgstr ""
17058
17059 #. type: =head2
17060 #: ../src/guestfs-actions.pod:6535
17061 msgid "guestfs_swapon_file"
17062 msgstr ""
17063
17064 #. type: verbatim
17065 #: ../src/guestfs-actions.pod:6537
17066 #, no-wrap
17067 msgid ""
17068 " int\n"
17069 " guestfs_swapon_file (guestfs_h *g,\n"
17070 "                      const char *file);\n"
17071 "\n"
17072 msgstr ""
17073
17074 #. type: textblock
17075 #: ../src/guestfs-actions.pod:6541
17076 msgid ""
17077 "This command enables swap to a file.  See C<guestfs_swapon_device> for other "
17078 "notes."
17079 msgstr ""
17080
17081 #. type: =head2
17082 #: ../src/guestfs-actions.pod:6548
17083 msgid "guestfs_swapon_label"
17084 msgstr ""
17085
17086 #. type: verbatim
17087 #: ../src/guestfs-actions.pod:6550
17088 #, no-wrap
17089 msgid ""
17090 " int\n"
17091 " guestfs_swapon_label (guestfs_h *g,\n"
17092 "                       const char *label);\n"
17093 "\n"
17094 msgstr ""
17095
17096 #. type: textblock
17097 #: ../src/guestfs-actions.pod:6554
17098 msgid ""
17099 "This command enables swap to a labeled swap partition.  See "
17100 "C<guestfs_swapon_device> for other notes."
17101 msgstr ""
17102
17103 #. type: =head2
17104 #: ../src/guestfs-actions.pod:6561
17105 msgid "guestfs_swapon_uuid"
17106 msgstr ""
17107
17108 #. type: verbatim
17109 #: ../src/guestfs-actions.pod:6563
17110 #, no-wrap
17111 msgid ""
17112 " int\n"
17113 " guestfs_swapon_uuid (guestfs_h *g,\n"
17114 "                      const char *uuid);\n"
17115 "\n"
17116 msgstr ""
17117
17118 #. type: textblock
17119 #: ../src/guestfs-actions.pod:6567
17120 msgid ""
17121 "This command enables swap to a swap partition with the given UUID.  See "
17122 "C<guestfs_swapon_device> for other notes."
17123 msgstr ""
17124
17125 #. type: =head2
17126 #: ../src/guestfs-actions.pod:6574
17127 msgid "guestfs_sync"
17128 msgstr ""
17129
17130 #. type: verbatim
17131 #: ../src/guestfs-actions.pod:6576
17132 #, no-wrap
17133 msgid ""
17134 " int\n"
17135 " guestfs_sync (guestfs_h *g);\n"
17136 "\n"
17137 msgstr ""
17138
17139 #. type: textblock
17140 #: ../src/guestfs-actions.pod:6579 ../fish/guestfish-actions.pod:4450
17141 msgid ""
17142 "This syncs the disk, so that any writes are flushed through to the "
17143 "underlying disk image."
17144 msgstr ""
17145
17146 #. type: textblock
17147 #: ../src/guestfs-actions.pod:6582 ../fish/guestfish-actions.pod:4453
17148 msgid ""
17149 "You should always call this if you have modified a disk image, before "
17150 "closing the handle."
17151 msgstr ""
17152
17153 #. type: =head2
17154 #: ../src/guestfs-actions.pod:6589
17155 msgid "guestfs_tail"
17156 msgstr ""
17157
17158 #. type: verbatim
17159 #: ../src/guestfs-actions.pod:6591
17160 #, no-wrap
17161 msgid ""
17162 " char **\n"
17163 " guestfs_tail (guestfs_h *g,\n"
17164 "               const char *path);\n"
17165 "\n"
17166 msgstr ""
17167
17168 #. type: textblock
17169 #: ../src/guestfs-actions.pod:6595 ../fish/guestfish-actions.pod:4460
17170 msgid ""
17171 "This command returns up to the last 10 lines of a file as a list of strings."
17172 msgstr ""
17173
17174 #. type: =head2
17175 #: ../src/guestfs-actions.pod:6607
17176 msgid "guestfs_tail_n"
17177 msgstr ""
17178
17179 #. type: verbatim
17180 #: ../src/guestfs-actions.pod:6609
17181 #, no-wrap
17182 msgid ""
17183 " char **\n"
17184 " guestfs_tail_n (guestfs_h *g,\n"
17185 "                 int nrlines,\n"
17186 "                 const char *path);\n"
17187 "\n"
17188 msgstr ""
17189
17190 #. type: textblock
17191 #: ../src/guestfs-actions.pod:6614 ../fish/guestfish-actions.pod:4470
17192 msgid ""
17193 "If the parameter C<nrlines> is a positive number, this returns the last "
17194 "C<nrlines> lines of the file C<path>."
17195 msgstr ""
17196
17197 #. type: textblock
17198 #: ../src/guestfs-actions.pod:6617 ../fish/guestfish-actions.pod:4473
17199 msgid ""
17200 "If the parameter C<nrlines> is a negative number, this returns lines from "
17201 "the file C<path>, starting with the C<-nrlines>th line."
17202 msgstr ""
17203
17204 #. type: =head2
17205 #: ../src/guestfs-actions.pod:6631
17206 msgid "guestfs_tar_in"
17207 msgstr ""
17208
17209 #. type: verbatim
17210 #: ../src/guestfs-actions.pod:6633
17211 #, no-wrap
17212 msgid ""
17213 " int\n"
17214 " guestfs_tar_in (guestfs_h *g,\n"
17215 "                 const char *tarfile,\n"
17216 "                 const char *directory);\n"
17217 "\n"
17218 msgstr ""
17219
17220 #. type: textblock
17221 #: ../src/guestfs-actions.pod:6638 ../fish/guestfish-actions.pod:4485
17222 msgid ""
17223 "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> "
17224 "tar file) into C<directory>."
17225 msgstr ""
17226
17227 #. type: textblock
17228 #: ../src/guestfs-actions.pod:6641
17229 msgid ""
17230 "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>."
17231 msgstr ""
17232
17233 #. type: textblock
17234 #: ../src/guestfs-actions.pod:6646 ../src/guestfs-actions.pod:6663
17235 #: ../src/guestfs-actions.pod:6679 ../src/guestfs-actions.pod:6695
17236 msgid "(Added in 1.0.3)"
17237 msgstr ""
17238
17239 #. type: =head2
17240 #: ../src/guestfs-actions.pod:6648
17241 msgid "guestfs_tar_out"
17242 msgstr ""
17243
17244 #. type: verbatim
17245 #: ../src/guestfs-actions.pod:6650
17246 #, no-wrap
17247 msgid ""
17248 " int\n"
17249 " guestfs_tar_out (guestfs_h *g,\n"
17250 "                  const char *directory,\n"
17251 "                  const char *tarfile);\n"
17252 "\n"
17253 msgstr ""
17254
17255 #. type: textblock
17256 #: ../src/guestfs-actions.pod:6655 ../fish/guestfish-actions.pod:4497
17257 msgid ""
17258 "This command packs the contents of C<directory> and downloads it to local "
17259 "file C<tarfile>."
17260 msgstr ""
17261
17262 #. type: textblock
17263 #: ../src/guestfs-actions.pod:6658
17264 msgid ""
17265 "To download a compressed tarball, use C<guestfs_tgz_out> or "
17266 "C<guestfs_txz_out>."
17267 msgstr ""
17268
17269 #. type: =head2
17270 #: ../src/guestfs-actions.pod:6665
17271 msgid "guestfs_tgz_in"
17272 msgstr ""
17273
17274 #. type: verbatim
17275 #: ../src/guestfs-actions.pod:6667
17276 #, no-wrap
17277 msgid ""
17278 " int\n"
17279 " guestfs_tgz_in (guestfs_h *g,\n"
17280 "                 const char *tarball,\n"
17281 "                 const char *directory);\n"
17282 "\n"
17283 msgstr ""
17284
17285 #. type: textblock
17286 #: ../src/guestfs-actions.pod:6672 ../fish/guestfish-actions.pod:4509
17287 msgid ""
17288 "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> "
17289 "tar file) into C<directory>."
17290 msgstr ""
17291
17292 #. type: textblock
17293 #: ../src/guestfs-actions.pod:6675
17294 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>."
17295 msgstr ""
17296
17297 #. type: =head2
17298 #: ../src/guestfs-actions.pod:6681
17299 msgid "guestfs_tgz_out"
17300 msgstr ""
17301
17302 #. type: verbatim
17303 #: ../src/guestfs-actions.pod:6683
17304 #, no-wrap
17305 msgid ""
17306 " int\n"
17307 " guestfs_tgz_out (guestfs_h *g,\n"
17308 "                  const char *directory,\n"
17309 "                  const char *tarball);\n"
17310 "\n"
17311 msgstr ""
17312
17313 #. type: textblock
17314 #: ../src/guestfs-actions.pod:6688 ../fish/guestfish-actions.pod:4520
17315 msgid ""
17316 "This command packs the contents of C<directory> and downloads it to local "
17317 "file C<tarball>."
17318 msgstr ""
17319
17320 #. type: textblock
17321 #: ../src/guestfs-actions.pod:6691
17322 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>."
17323 msgstr ""
17324
17325 #. type: =head2
17326 #: ../src/guestfs-actions.pod:6697
17327 msgid "guestfs_touch"
17328 msgstr ""
17329
17330 #. type: verbatim
17331 #: ../src/guestfs-actions.pod:6699
17332 #, no-wrap
17333 msgid ""
17334 " int\n"
17335 " guestfs_touch (guestfs_h *g,\n"
17336 "                const char *path);\n"
17337 "\n"
17338 msgstr ""
17339
17340 #. type: textblock
17341 #: ../src/guestfs-actions.pod:6703 ../fish/guestfish-actions.pod:4531
17342 msgid ""
17343 "Touch acts like the L<touch(1)> command.  It can be used to update the "
17344 "timestamps on a file, or, if the file does not exist, to create a new zero-"
17345 "length file."
17346 msgstr ""
17347
17348 #. type: textblock
17349 #: ../src/guestfs-actions.pod:6707 ../fish/guestfish-actions.pod:4535
17350 msgid ""
17351 "This command only works on regular files, and will fail on other file types "
17352 "such as directories, symbolic links, block special etc."
17353 msgstr ""
17354
17355 #. type: =head2
17356 #: ../src/guestfs-actions.pod:6714
17357 msgid "guestfs_truncate"
17358 msgstr ""
17359
17360 #. type: verbatim
17361 #: ../src/guestfs-actions.pod:6716
17362 #, no-wrap
17363 msgid ""
17364 " int\n"
17365 " guestfs_truncate (guestfs_h *g,\n"
17366 "                   const char *path);\n"
17367 "\n"
17368 msgstr ""
17369
17370 #. type: textblock
17371 #: ../src/guestfs-actions.pod:6720 ../fish/guestfish-actions.pod:4542
17372 msgid ""
17373 "This command truncates C<path> to a zero-length file.  The file must exist "
17374 "already."
17375 msgstr ""
17376
17377 #. type: =head2
17378 #: ../src/guestfs-actions.pod:6727
17379 msgid "guestfs_truncate_size"
17380 msgstr ""
17381
17382 #. type: verbatim
17383 #: ../src/guestfs-actions.pod:6729
17384 #, no-wrap
17385 msgid ""
17386 " int\n"
17387 " guestfs_truncate_size (guestfs_h *g,\n"
17388 "                        const char *path,\n"
17389 "                        int64_t size);\n"
17390 "\n"
17391 msgstr ""
17392
17393 #. type: textblock
17394 #: ../src/guestfs-actions.pod:6734 ../fish/guestfish-actions.pod:4549
17395 msgid ""
17396 "This command truncates C<path> to size C<size> bytes.  The file must exist "
17397 "already."
17398 msgstr ""
17399
17400 #. type: textblock
17401 #: ../src/guestfs-actions.pod:6737
17402 msgid ""
17403 "If the current file size is less than C<size> then the file is extended to "
17404 "the required size with zero bytes.  This creates a sparse file (ie. disk "
17405 "blocks are not allocated for the file until you write to it).  To create a "
17406 "non-sparse file of zeroes, use C<guestfs_fallocate64> instead."
17407 msgstr ""
17408
17409 #. type: =head2
17410 #: ../src/guestfs-actions.pod:6747
17411 msgid "guestfs_tune2fs_l"
17412 msgstr ""
17413
17414 #. type: verbatim
17415 #: ../src/guestfs-actions.pod:6749
17416 #, no-wrap
17417 msgid ""
17418 " char **\n"
17419 " guestfs_tune2fs_l (guestfs_h *g,\n"
17420 "                    const char *device);\n"
17421 "\n"
17422 msgstr ""
17423
17424 #. type: textblock
17425 #: ../src/guestfs-actions.pod:6753 ../fish/guestfish-actions.pod:4562
17426 msgid ""
17427 "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on "
17428 "C<device>."
17429 msgstr ""
17430
17431 #. type: textblock
17432 #: ../src/guestfs-actions.pod:6756 ../fish/guestfish-actions.pod:4565
17433 msgid ""
17434 "It is the same as running C<tune2fs -l device>.  See L<tune2fs(8)> manpage "
17435 "for more details.  The list of fields returned isn't clearly defined, and "
17436 "depends on both the version of C<tune2fs> that libguestfs was built against, "
17437 "and the filesystem itself."
17438 msgstr ""
17439
17440 #. type: =head2
17441 #: ../src/guestfs-actions.pod:6769
17442 msgid "guestfs_txz_in"
17443 msgstr ""
17444
17445 #. type: verbatim
17446 #: ../src/guestfs-actions.pod:6771
17447 #, no-wrap
17448 msgid ""
17449 " int\n"
17450 " guestfs_txz_in (guestfs_h *g,\n"
17451 "                 const char *tarball,\n"
17452 "                 const char *directory);\n"
17453 "\n"
17454 msgstr ""
17455
17456 #. type: textblock
17457 #: ../src/guestfs-actions.pod:6776 ../fish/guestfish-actions.pod:4574
17458 msgid ""
17459 "This command uploads and unpacks local file C<tarball> (an I<xz compressed> "
17460 "tar file) into C<directory>."
17461 msgstr ""
17462
17463 #. type: =head2
17464 #: ../src/guestfs-actions.pod:6783
17465 msgid "guestfs_txz_out"
17466 msgstr ""
17467
17468 #. type: verbatim
17469 #: ../src/guestfs-actions.pod:6785
17470 #, no-wrap
17471 msgid ""
17472 " int\n"
17473 " guestfs_txz_out (guestfs_h *g,\n"
17474 "                  const char *directory,\n"
17475 "                  const char *tarball);\n"
17476 "\n"
17477 msgstr ""
17478
17479 #. type: textblock
17480 #: ../src/guestfs-actions.pod:6790 ../fish/guestfish-actions.pod:4583
17481 msgid ""
17482 "This command packs the contents of C<directory> and downloads it to local "
17483 "file C<tarball> (as an xz compressed tar archive)."
17484 msgstr ""
17485
17486 #. type: =head2
17487 #: ../src/guestfs-actions.pod:6797
17488 msgid "guestfs_umask"
17489 msgstr ""
17490
17491 #. type: verbatim
17492 #: ../src/guestfs-actions.pod:6799
17493 #, no-wrap
17494 msgid ""
17495 " int\n"
17496 " guestfs_umask (guestfs_h *g,\n"
17497 "                int mask);\n"
17498 "\n"
17499 msgstr ""
17500
17501 #. type: textblock
17502 #: ../src/guestfs-actions.pod:6803 ../fish/guestfish-actions.pod:4592
17503 msgid ""
17504 "This function sets the mask used for creating new files and device nodes to "
17505 "C<mask & 0777>."
17506 msgstr ""
17507
17508 #. type: textblock
17509 #: ../src/guestfs-actions.pod:6806 ../fish/guestfish-actions.pod:4595
17510 msgid ""
17511 "Typical umask values would be C<022> which creates new files with "
17512 "permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates "
17513 "new files with permissions like \"-rw-rw-r--\" or \"-rwxrwxr-x\"."
17514 msgstr ""
17515
17516 #. type: textblock
17517 #: ../src/guestfs-actions.pod:6811 ../fish/guestfish-actions.pod:4600
17518 msgid ""
17519 "The default umask is C<022>.  This is important because it means that "
17520 "directories and device nodes will be created with C<0644> or C<0755> mode "
17521 "even if you specify C<0777>."
17522 msgstr ""
17523
17524 #. type: textblock
17525 #: ../src/guestfs-actions.pod:6815
17526 msgid ""
17527 "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, "
17528 "C<guestfs_mkdir>."
17529 msgstr ""
17530
17531 #. type: textblock
17532 #: ../src/guestfs-actions.pod:6818 ../fish/guestfish-actions.pod:4607
17533 msgid "This call returns the previous umask."
17534 msgstr ""
17535
17536 #. type: =head2
17537 #: ../src/guestfs-actions.pod:6824
17538 msgid "guestfs_umount"
17539 msgstr ""
17540
17541 #. type: verbatim
17542 #: ../src/guestfs-actions.pod:6826
17543 #, no-wrap
17544 msgid ""
17545 " int\n"
17546 " guestfs_umount (guestfs_h *g,\n"
17547 "                 const char *pathordevice);\n"
17548 "\n"
17549 msgstr ""
17550
17551 #. type: textblock
17552 #: ../src/guestfs-actions.pod:6830 ../fish/guestfish-actions.pod:4615
17553 msgid ""
17554 "This unmounts the given filesystem.  The filesystem may be specified either "
17555 "by its mountpoint (path) or the device which contains the filesystem."
17556 msgstr ""
17557
17558 #. type: =head2
17559 #: ../src/guestfs-actions.pod:6838
17560 msgid "guestfs_umount_all"
17561 msgstr ""
17562
17563 #. type: verbatim
17564 #: ../src/guestfs-actions.pod:6840
17565 #, no-wrap
17566 msgid ""
17567 " int\n"
17568 " guestfs_umount_all (guestfs_h *g);\n"
17569 "\n"
17570 msgstr ""
17571
17572 #. type: textblock
17573 #: ../src/guestfs-actions.pod:6843 ../fish/guestfish-actions.pod:4625
17574 msgid "This unmounts all mounted filesystems."
17575 msgstr ""
17576
17577 #. type: textblock
17578 #: ../src/guestfs-actions.pod:6845 ../fish/guestfish-actions.pod:4627
17579 msgid "Some internal mounts are not unmounted by this call."
17580 msgstr ""
17581
17582 #. type: =head2
17583 #: ../src/guestfs-actions.pod:6851
17584 msgid "guestfs_upload"
17585 msgstr ""
17586
17587 #. type: verbatim
17588 #: ../src/guestfs-actions.pod:6853
17589 #, no-wrap
17590 msgid ""
17591 " int\n"
17592 " guestfs_upload (guestfs_h *g,\n"
17593 "                 const char *filename,\n"
17594 "                 const char *remotefilename);\n"
17595 "\n"
17596 msgstr ""
17597
17598 #. type: textblock
17599 #: ../src/guestfs-actions.pod:6858 ../src/guestfs-actions.pod:6882
17600 #: ../fish/guestfish-actions.pod:4633 ../fish/guestfish-actions.pod:4646
17601 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem."
17602 msgstr ""
17603
17604 #. type: textblock
17605 #: ../src/guestfs-actions.pod:6863
17606 msgid "See also C<guestfs_download>."
17607 msgstr ""
17608
17609 #. type: =head2
17610 #: ../src/guestfs-actions.pod:6874
17611 msgid "guestfs_upload_offset"
17612 msgstr ""
17613
17614 #. type: verbatim
17615 #: ../src/guestfs-actions.pod:6876
17616 #, no-wrap
17617 msgid ""
17618 " int\n"
17619 " guestfs_upload_offset (guestfs_h *g,\n"
17620 "                        const char *filename,\n"
17621 "                        const char *remotefilename,\n"
17622 "                        int64_t offset);\n"
17623 "\n"
17624 msgstr ""
17625
17626 #. type: textblock
17627 #: ../src/guestfs-actions.pod:6885 ../fish/guestfish-actions.pod:4649
17628 msgid ""
17629 "C<remotefilename> is overwritten starting at the byte C<offset> specified.  "
17630 "The intention is to overwrite parts of existing files or devices, although "
17631 "if a non-existant file is specified then it is created with a \"hole\" "
17632 "before C<offset>.  The size of the data written is implicit in the size of "
17633 "the source C<filename>."
17634 msgstr ""
17635
17636 #. type: textblock
17637 #: ../src/guestfs-actions.pod:6892
17638 msgid ""
17639 "Note that there is no limit on the amount of data that can be uploaded with "
17640 "this call, unlike with C<guestfs_pwrite>, and this call always writes the "
17641 "full amount unless an error occurs."
17642 msgstr ""
17643
17644 #. type: textblock
17645 #: ../src/guestfs-actions.pod:6897
17646 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>."
17647 msgstr ""
17648
17649 #. type: =head2
17650 #: ../src/guestfs-actions.pod:6908
17651 msgid "guestfs_utimens"
17652 msgstr ""
17653
17654 #. type: verbatim
17655 #: ../src/guestfs-actions.pod:6910
17656 #, no-wrap
17657 msgid ""
17658 " int\n"
17659 " guestfs_utimens (guestfs_h *g,\n"
17660 "                  const char *path,\n"
17661 "                  int64_t atsecs,\n"
17662 "                  int64_t atnsecs,\n"
17663 "                  int64_t mtsecs,\n"
17664 "                  int64_t mtnsecs);\n"
17665 "\n"
17666 msgstr ""
17667
17668 #. type: textblock
17669 #: ../src/guestfs-actions.pod:6918 ../fish/guestfish-actions.pod:4669
17670 msgid "This command sets the timestamps of a file with nanosecond precision."
17671 msgstr ""
17672
17673 #. type: textblock
17674 #: ../src/guestfs-actions.pod:6921 ../fish/guestfish-actions.pod:4672
17675 msgid ""
17676 "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds "
17677 "from the epoch."
17678 msgstr ""
17679
17680 #. type: textblock
17681 #: ../src/guestfs-actions.pod:6924 ../fish/guestfish-actions.pod:4675
17682 msgid ""
17683 "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and "
17684 "nanoseconds from the epoch."
17685 msgstr ""
17686
17687 #. type: textblock
17688 #: ../src/guestfs-actions.pod:6927 ../fish/guestfish-actions.pod:4678
17689 msgid ""
17690 "If the C<*nsecs> field contains the special value C<-1> then the "
17691 "corresponding timestamp is set to the current time.  (The C<*secs> field is "
17692 "ignored in this case)."
17693 msgstr ""
17694
17695 #. type: textblock
17696 #: ../src/guestfs-actions.pod:6931 ../fish/guestfish-actions.pod:4682
17697 msgid ""
17698 "If the C<*nsecs> field contains the special value C<-2> then the "
17699 "corresponding timestamp is left unchanged.  (The C<*secs> field is ignored "
17700 "in this case)."
17701 msgstr ""
17702
17703 #. type: =head2
17704 #: ../src/guestfs-actions.pod:6939 ../src/guestfs-structs.pod:175
17705 msgid "guestfs_version"
17706 msgstr ""
17707
17708 #. type: verbatim
17709 #: ../src/guestfs-actions.pod:6941
17710 #, no-wrap
17711 msgid ""
17712 " struct guestfs_version *\n"
17713 " guestfs_version (guestfs_h *g);\n"
17714 "\n"
17715 msgstr ""
17716
17717 #. type: textblock
17718 #: ../src/guestfs-actions.pod:6944 ../fish/guestfish-actions.pod:4690
17719 msgid ""
17720 "Return the libguestfs version number that the program is linked against."
17721 msgstr ""
17722
17723 #. type: textblock
17724 #: ../src/guestfs-actions.pod:6947 ../fish/guestfish-actions.pod:4693
17725 msgid ""
17726 "Note that because of dynamic linking this is not necessarily the version of "
17727 "libguestfs that you compiled against.  You can compile the program, and then "
17728 "at runtime dynamically link against a completely different C<libguestfs.so> "
17729 "library."
17730 msgstr ""
17731
17732 #. type: textblock
17733 #: ../src/guestfs-actions.pod:6952 ../fish/guestfish-actions.pod:4698
17734 msgid ""
17735 "This call was added in version C<1.0.58>.  In previous versions of "
17736 "libguestfs there was no way to get the version number.  From C code you can "
17737 "use dynamic linker functions to find out if this symbol exists (if it "
17738 "doesn't, then it's an earlier version)."
17739 msgstr ""
17740
17741 #. type: textblock
17742 #: ../src/guestfs-actions.pod:6958 ../fish/guestfish-actions.pod:4704
17743 msgid ""
17744 "The call returns a structure with four elements.  The first three (C<major>, "
17745 "C<minor> and C<release>) are numbers and correspond to the usual version "
17746 "triplet.  The fourth element (C<extra>) is a string and is normally empty, "
17747 "but may be used for distro-specific information."
17748 msgstr ""
17749
17750 #. type: textblock
17751 #: ../src/guestfs-actions.pod:6964 ../fish/guestfish-actions.pod:4710
17752 msgid ""
17753 "To construct the original version string: C<$major.$minor.$release$extra>"
17754 msgstr ""
17755
17756 #. type: textblock
17757 #: ../src/guestfs-actions.pod:6967 ../fish/guestfish-actions.pod:4713
17758 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>."
17759 msgstr ""
17760
17761 #. type: textblock
17762 #: ../src/guestfs-actions.pod:6969
17763 msgid ""
17764 "I<Note:> Don't use this call to test for availability of features.  In "
17765 "enterprise distributions we backport features from later versions into "
17766 "earlier versions, making this an unreliable way to test for features.  Use "
17767 "C<guestfs_available> instead."
17768 msgstr ""
17769
17770 #. type: textblock
17771 #: ../src/guestfs-actions.pod:6975
17772 msgid ""
17773 "This function returns a C<struct guestfs_version *>, or NULL if there was an "
17774 "error.  I<The caller must call C<guestfs_free_version> after use>."
17775 msgstr ""
17776
17777 #. type: textblock
17778 #: ../src/guestfs-actions.pod:6979
17779 msgid "(Added in 1.0.58)"
17780 msgstr ""
17781
17782 #. type: =head2
17783 #: ../src/guestfs-actions.pod:6981
17784 msgid "guestfs_vfs_label"
17785 msgstr ""
17786
17787 #. type: verbatim
17788 #: ../src/guestfs-actions.pod:6983
17789 #, no-wrap
17790 msgid ""
17791 " char *\n"
17792 " guestfs_vfs_label (guestfs_h *g,\n"
17793 "                    const char *device);\n"
17794 "\n"
17795 msgstr ""
17796
17797 #. type: textblock
17798 #: ../src/guestfs-actions.pod:6987 ../fish/guestfish-actions.pod:4725
17799 msgid "This returns the filesystem label of the filesystem on C<device>."
17800 msgstr ""
17801
17802 #. type: textblock
17803 #: ../src/guestfs-actions.pod:6990 ../fish/guestfish-actions.pod:4728
17804 msgid "If the filesystem is unlabeled, this returns the empty string."
17805 msgstr ""
17806
17807 #. type: textblock
17808 #: ../src/guestfs-actions.pod:6992
17809 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>."
17810 msgstr ""
17811
17812 #. type: textblock
17813 #: ../src/guestfs-actions.pod:6997 ../src/guestfs-actions.pod:7034
17814 msgid "(Added in 1.3.18)"
17815 msgstr ""
17816
17817 #. type: =head2
17818 #: ../src/guestfs-actions.pod:6999
17819 msgid "guestfs_vfs_type"
17820 msgstr ""
17821
17822 #. type: verbatim
17823 #: ../src/guestfs-actions.pod:7001
17824 #, no-wrap
17825 msgid ""
17826 " char *\n"
17827 " guestfs_vfs_type (guestfs_h *g,\n"
17828 "                   const char *device);\n"
17829 "\n"
17830 msgstr ""
17831
17832 #. type: textblock
17833 #: ../src/guestfs-actions.pod:7005 ../fish/guestfish-actions.pod:4736
17834 msgid ""
17835 "This command gets the filesystem type corresponding to the filesystem on "
17836 "C<device>."
17837 msgstr ""
17838
17839 #. type: textblock
17840 #: ../src/guestfs-actions.pod:7008 ../fish/guestfish-actions.pod:4739
17841 msgid ""
17842 "For most filesystems, the result is the name of the Linux VFS module which "
17843 "would be used to mount this filesystem if you mounted it without specifying "
17844 "the filesystem type.  For example a string such as C<ext3> or C<ntfs>."
17845 msgstr ""
17846
17847 #. type: =head2
17848 #: ../src/guestfs-actions.pod:7018
17849 msgid "guestfs_vfs_uuid"
17850 msgstr ""
17851
17852 #. type: verbatim
17853 #: ../src/guestfs-actions.pod:7020
17854 #, no-wrap
17855 msgid ""
17856 " char *\n"
17857 " guestfs_vfs_uuid (guestfs_h *g,\n"
17858 "                   const char *device);\n"
17859 "\n"
17860 msgstr ""
17861
17862 #. type: textblock
17863 #: ../src/guestfs-actions.pod:7024 ../fish/guestfish-actions.pod:4748
17864 msgid "This returns the filesystem UUID of the filesystem on C<device>."
17865 msgstr ""
17866
17867 #. type: textblock
17868 #: ../src/guestfs-actions.pod:7027 ../fish/guestfish-actions.pod:4751
17869 msgid "If the filesystem does not have a UUID, this returns the empty string."
17870 msgstr ""
17871
17872 #. type: textblock
17873 #: ../src/guestfs-actions.pod:7029
17874 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>."
17875 msgstr ""
17876
17877 #. type: =head2
17878 #: ../src/guestfs-actions.pod:7036
17879 msgid "guestfs_vg_activate"
17880 msgstr ""
17881
17882 #. type: verbatim
17883 #: ../src/guestfs-actions.pod:7038
17884 #, no-wrap
17885 msgid ""
17886 " int\n"
17887 " guestfs_vg_activate (guestfs_h *g,\n"
17888 "                      int activate,\n"
17889 "                      char *const *volgroups);\n"
17890 "\n"
17891 msgstr ""
17892
17893 #. type: textblock
17894 #: ../src/guestfs-actions.pod:7043 ../fish/guestfish-actions.pod:4759
17895 msgid ""
17896 "This command activates or (if C<activate> is false) deactivates all logical "
17897 "volumes in the listed volume groups C<volgroups>.  If activated, then they "
17898 "are made known to the kernel, ie. they appear as C</dev/mapper> devices.  If "
17899 "deactivated, then those devices disappear."
17900 msgstr ""
17901
17902 #. type: textblock
17903 #: ../src/guestfs-actions.pod:7049 ../fish/guestfish-actions.pod:4765
17904 msgid "This command is the same as running C<vgchange -a y|n volgroups...>"
17905 msgstr ""
17906
17907 #. type: textblock
17908 #: ../src/guestfs-actions.pod:7051 ../fish/guestfish-actions.pod:4767
17909 msgid ""
17910 "Note that if C<volgroups> is an empty list then B<all> volume groups are "
17911 "activated or deactivated."
17912 msgstr ""
17913
17914 #. type: =head2
17915 #: ../src/guestfs-actions.pod:7058
17916 msgid "guestfs_vg_activate_all"
17917 msgstr ""
17918
17919 #. type: verbatim
17920 #: ../src/guestfs-actions.pod:7060
17921 #, no-wrap
17922 msgid ""
17923 " int\n"
17924 " guestfs_vg_activate_all (guestfs_h *g,\n"
17925 "                          int activate);\n"
17926 "\n"
17927 msgstr ""
17928
17929 #. type: textblock
17930 #: ../src/guestfs-actions.pod:7064 ../fish/guestfish-actions.pod:4774
17931 msgid ""
17932 "This command activates or (if C<activate> is false) deactivates all logical "
17933 "volumes in all volume groups.  If activated, then they are made known to the "
17934 "kernel, ie. they appear as C</dev/mapper> devices.  If deactivated, then "
17935 "those devices disappear."
17936 msgstr ""
17937
17938 #. type: textblock
17939 #: ../src/guestfs-actions.pod:7070 ../fish/guestfish-actions.pod:4780
17940 msgid "This command is the same as running C<vgchange -a y|n>"
17941 msgstr ""
17942
17943 #. type: =head2
17944 #: ../src/guestfs-actions.pod:7076
17945 msgid "guestfs_vgcreate"
17946 msgstr ""
17947
17948 #. type: verbatim
17949 #: ../src/guestfs-actions.pod:7078
17950 #, no-wrap
17951 msgid ""
17952 " int\n"
17953 " guestfs_vgcreate (guestfs_h *g,\n"
17954 "                   const char *volgroup,\n"
17955 "                   char *const *physvols);\n"
17956 "\n"
17957 msgstr ""
17958
17959 #. type: textblock
17960 #: ../src/guestfs-actions.pod:7083 ../fish/guestfish-actions.pod:4786
17961 msgid ""
17962 "This creates an LVM volume group called C<volgroup> from the non-empty list "
17963 "of physical volumes C<physvols>."
17964 msgstr ""
17965
17966 #. type: =head2
17967 #: ../src/guestfs-actions.pod:7090
17968 msgid "guestfs_vglvuuids"
17969 msgstr ""
17970
17971 #. type: verbatim
17972 #: ../src/guestfs-actions.pod:7092
17973 #, no-wrap
17974 msgid ""
17975 " char **\n"
17976 " guestfs_vglvuuids (guestfs_h *g,\n"
17977 "                    const char *vgname);\n"
17978 "\n"
17979 msgstr ""
17980
17981 #. type: textblock
17982 #: ../src/guestfs-actions.pod:7096 ../fish/guestfish-actions.pod:4793
17983 msgid ""
17984 "Given a VG called C<vgname>, this returns the UUIDs of all the logical "
17985 "volumes created in this volume group."
17986 msgstr ""
17987
17988 #. type: textblock
17989 #: ../src/guestfs-actions.pod:7099
17990 msgid ""
17991 "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to "
17992 "associate logical volumes and volume groups."
17993 msgstr ""
17994
17995 #. type: textblock
17996 #: ../src/guestfs-actions.pod:7102
17997 msgid "See also C<guestfs_vgpvuuids>."
17998 msgstr ""
17999
18000 #. type: =head2
18001 #: ../src/guestfs-actions.pod:7110
18002 msgid "guestfs_vgpvuuids"
18003 msgstr ""
18004
18005 #. type: verbatim
18006 #: ../src/guestfs-actions.pod:7112
18007 #, no-wrap
18008 msgid ""
18009 " char **\n"
18010 " guestfs_vgpvuuids (guestfs_h *g,\n"
18011 "                    const char *vgname);\n"
18012 "\n"
18013 msgstr ""
18014
18015 #. type: textblock
18016 #: ../src/guestfs-actions.pod:7116 ../fish/guestfish-actions.pod:4805
18017 msgid ""
18018 "Given a VG called C<vgname>, this returns the UUIDs of all the physical "
18019 "volumes that this volume group resides on."
18020 msgstr ""
18021
18022 #. type: textblock
18023 #: ../src/guestfs-actions.pod:7119
18024 msgid ""
18025 "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to "
18026 "associate physical volumes and volume groups."
18027 msgstr ""
18028
18029 #. type: textblock
18030 #: ../src/guestfs-actions.pod:7122
18031 msgid "See also C<guestfs_vglvuuids>."
18032 msgstr ""
18033
18034 #. type: =head2
18035 #: ../src/guestfs-actions.pod:7130
18036 msgid "guestfs_vgremove"
18037 msgstr ""
18038
18039 #. type: verbatim
18040 #: ../src/guestfs-actions.pod:7132
18041 #, no-wrap
18042 msgid ""
18043 " int\n"
18044 " guestfs_vgremove (guestfs_h *g,\n"
18045 "                   const char *vgname);\n"
18046 "\n"
18047 msgstr ""
18048
18049 #. type: textblock
18050 #: ../src/guestfs-actions.pod:7136 ../fish/guestfish-actions.pod:4817
18051 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)."
18052 msgstr ""
18053
18054 #. type: textblock
18055 #: ../src/guestfs-actions.pod:7138 ../fish/guestfish-actions.pod:4819
18056 msgid ""
18057 "This also forcibly removes all logical volumes in the volume group (if any)."
18058 msgstr ""
18059
18060 #. type: =head2
18061 #: ../src/guestfs-actions.pod:7145
18062 msgid "guestfs_vgrename"
18063 msgstr ""
18064
18065 #. type: verbatim
18066 #: ../src/guestfs-actions.pod:7147
18067 #, no-wrap
18068 msgid ""
18069 " int\n"
18070 " guestfs_vgrename (guestfs_h *g,\n"
18071 "                   const char *volgroup,\n"
18072 "                   const char *newvolgroup);\n"
18073 "\n"
18074 msgstr ""
18075
18076 #. type: textblock
18077 #: ../src/guestfs-actions.pod:7152 ../fish/guestfish-actions.pod:4826
18078 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>."
18079 msgstr ""
18080
18081 #. type: =head2
18082 #: ../src/guestfs-actions.pod:7158
18083 msgid "guestfs_vgs"
18084 msgstr ""
18085
18086 #. type: verbatim
18087 #: ../src/guestfs-actions.pod:7160
18088 #, no-wrap
18089 msgid ""
18090 " char **\n"
18091 " guestfs_vgs (guestfs_h *g);\n"
18092 "\n"
18093 msgstr ""
18094
18095 #. type: textblock
18096 #: ../src/guestfs-actions.pod:7163 ../fish/guestfish-actions.pod:4832
18097 msgid ""
18098 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
18099 "> command."
18100 msgstr ""
18101
18102 #. type: textblock
18103 #: ../src/guestfs-actions.pod:7166 ../fish/guestfish-actions.pod:4835
18104 msgid ""
18105 "This returns a list of just the volume group names that were detected (eg. "
18106 "C<VolGroup00>)."
18107 msgstr ""
18108
18109 #. type: textblock
18110 #: ../src/guestfs-actions.pod:7169
18111 msgid "See also C<guestfs_vgs_full>."
18112 msgstr ""
18113
18114 #. type: =head2
18115 #: ../src/guestfs-actions.pod:7177
18116 msgid "guestfs_vgs_full"
18117 msgstr ""
18118
18119 #. type: verbatim
18120 #: ../src/guestfs-actions.pod:7179
18121 #, no-wrap
18122 msgid ""
18123 " struct guestfs_lvm_vg_list *\n"
18124 " guestfs_vgs_full (guestfs_h *g);\n"
18125 "\n"
18126 msgstr ""
18127
18128 #. type: textblock
18129 #: ../src/guestfs-actions.pod:7182 ../fish/guestfish-actions.pod:4844
18130 msgid ""
18131 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
18132 "> command.  The \"full\" version includes all fields."
18133 msgstr ""
18134
18135 #. type: textblock
18136 #: ../src/guestfs-actions.pod:7185
18137 msgid ""
18138 "This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there "
18139 "was an error.  I<The caller must call C<guestfs_free_lvm_vg_list> after use>."
18140 msgstr ""
18141
18142 #. type: =head2
18143 #: ../src/guestfs-actions.pod:7191
18144 msgid "guestfs_vgscan"
18145 msgstr ""
18146
18147 #. type: verbatim
18148 #: ../src/guestfs-actions.pod:7193
18149 #, no-wrap
18150 msgid ""
18151 " int\n"
18152 " guestfs_vgscan (guestfs_h *g);\n"
18153 "\n"
18154 msgstr ""
18155
18156 #. type: textblock
18157 #: ../src/guestfs-actions.pod:7196 ../fish/guestfish-actions.pod:4851
18158 msgid ""
18159 "This rescans all block devices and rebuilds the list of LVM physical "
18160 "volumes, volume groups and logical volumes."
18161 msgstr ""
18162
18163 #. type: =head2
18164 #: ../src/guestfs-actions.pod:7203
18165 msgid "guestfs_vguuid"
18166 msgstr ""
18167
18168 #. type: verbatim
18169 #: ../src/guestfs-actions.pod:7205
18170 #, no-wrap
18171 msgid ""
18172 " char *\n"
18173 " guestfs_vguuid (guestfs_h *g,\n"
18174 "                 const char *vgname);\n"
18175 "\n"
18176 msgstr ""
18177
18178 #. type: textblock
18179 #: ../src/guestfs-actions.pod:7209 ../fish/guestfish-actions.pod:4858
18180 msgid "This command returns the UUID of the LVM VG named C<vgname>."
18181 msgstr ""
18182
18183 #. type: =head2
18184 #: ../src/guestfs-actions.pod:7216
18185 msgid "guestfs_wait_ready"
18186 msgstr ""
18187
18188 #. type: verbatim
18189 #: ../src/guestfs-actions.pod:7218
18190 #, no-wrap
18191 msgid ""
18192 " int\n"
18193 " guestfs_wait_ready (guestfs_h *g);\n"
18194 "\n"
18195 msgstr ""
18196
18197 #. type: textblock
18198 #: ../src/guestfs-actions.pod:7221
18199 msgid "This function is a no op."
18200 msgstr ""
18201
18202 #. type: textblock
18203 #: ../src/guestfs-actions.pod:7223
18204 msgid ""
18205 "In versions of the API E<lt> 1.0.71 you had to call this function just after "
18206 "calling C<guestfs_launch> to wait for the launch to complete.  However this "
18207 "is no longer necessary because C<guestfs_launch> now does the waiting."
18208 msgstr ""
18209
18210 #. type: textblock
18211 #: ../src/guestfs-actions.pod:7228
18212 msgid ""
18213 "If you see any calls to this function in code then you can just remove them, "
18214 "unless you want to retain compatibility with older versions of the API."
18215 msgstr ""
18216
18217 #. type: textblock
18218 #: ../src/guestfs-actions.pod:7234
18219 msgid ""
18220 "This function is deprecated.  In new code, use the L</guestfs_launch> call "
18221 "instead."
18222 msgstr ""
18223
18224 #. type: =head2
18225 #: ../src/guestfs-actions.pod:7243
18226 msgid "guestfs_wc_c"
18227 msgstr ""
18228
18229 #. type: verbatim
18230 #: ../src/guestfs-actions.pod:7245
18231 #, no-wrap
18232 msgid ""
18233 " int\n"
18234 " guestfs_wc_c (guestfs_h *g,\n"
18235 "               const char *path);\n"
18236 "\n"
18237 msgstr ""
18238
18239 #. type: textblock
18240 #: ../src/guestfs-actions.pod:7249 ../fish/guestfish-actions.pod:4864
18241 msgid ""
18242 "This command counts the characters in a file, using the C<wc -c> external "
18243 "command."
18244 msgstr ""
18245
18246 #. type: =head2
18247 #: ../src/guestfs-actions.pod:7256
18248 msgid "guestfs_wc_l"
18249 msgstr ""
18250
18251 #. type: verbatim
18252 #: ../src/guestfs-actions.pod:7258
18253 #, no-wrap
18254 msgid ""
18255 " int\n"
18256 " guestfs_wc_l (guestfs_h *g,\n"
18257 "               const char *path);\n"
18258 "\n"
18259 msgstr ""
18260
18261 #. type: textblock
18262 #: ../src/guestfs-actions.pod:7262 ../fish/guestfish-actions.pod:4871
18263 msgid ""
18264 "This command counts the lines in a file, using the C<wc -l> external command."
18265 msgstr ""
18266
18267 #. type: =head2
18268 #: ../src/guestfs-actions.pod:7269
18269 msgid "guestfs_wc_w"
18270 msgstr ""
18271
18272 #. type: verbatim
18273 #: ../src/guestfs-actions.pod:7271
18274 #, no-wrap
18275 msgid ""
18276 " int\n"
18277 " guestfs_wc_w (guestfs_h *g,\n"
18278 "               const char *path);\n"
18279 "\n"
18280 msgstr ""
18281
18282 #. type: textblock
18283 #: ../src/guestfs-actions.pod:7275 ../fish/guestfish-actions.pod:4878
18284 msgid ""
18285 "This command counts the words in a file, using the C<wc -w> external command."
18286 msgstr ""
18287
18288 #. type: =head2
18289 #: ../src/guestfs-actions.pod:7282
18290 msgid "guestfs_write"
18291 msgstr ""
18292
18293 #. type: verbatim
18294 #: ../src/guestfs-actions.pod:7284
18295 #, no-wrap
18296 msgid ""
18297 " int\n"
18298 " guestfs_write (guestfs_h *g,\n"
18299 "                const char *path,\n"
18300 "                const char *content,\n"
18301 "                size_t content_size);\n"
18302 "\n"
18303 msgstr ""
18304
18305 #. type: textblock
18306 #: ../src/guestfs-actions.pod:7290 ../fish/guestfish-actions.pod:4885
18307 msgid ""
18308 "This call creates a file called C<path>.  The content of the file is the "
18309 "string C<content> (which can contain any 8 bit data)."
18310 msgstr ""
18311
18312 #. type: =head2
18313 #: ../src/guestfs-actions.pod:7300
18314 msgid "guestfs_write_file"
18315 msgstr ""
18316
18317 #. type: verbatim
18318 #: ../src/guestfs-actions.pod:7302
18319 #, no-wrap
18320 msgid ""
18321 " int\n"
18322 " guestfs_write_file (guestfs_h *g,\n"
18323 "                     const char *path,\n"
18324 "                     const char *content,\n"
18325 "                     int size);\n"
18326 "\n"
18327 msgstr ""
18328
18329 #. type: textblock
18330 #: ../src/guestfs-actions.pod:7308 ../fish/guestfish-actions.pod:4895
18331 msgid ""
18332 "This call creates a file called C<path>.  The contents of the file is the "
18333 "string C<content> (which can contain any 8 bit data), with length C<size>."
18334 msgstr ""
18335
18336 #. type: textblock
18337 #: ../src/guestfs-actions.pod:7312 ../fish/guestfish-actions.pod:4899
18338 msgid ""
18339 "As a special case, if C<size> is C<0> then the length is calculated using "
18340 "C<strlen> (so in this case the content cannot contain embedded ASCII NULs)."
18341 msgstr ""
18342
18343 #. type: textblock
18344 #: ../src/guestfs-actions.pod:7316 ../fish/guestfish-actions.pod:4903
18345 msgid ""
18346 "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does "
18347 "I<not> work, even if the length is specified."
18348 msgstr ""
18349
18350 #. type: textblock
18351 #: ../src/guestfs-actions.pod:7324
18352 msgid ""
18353 "This function is deprecated.  In new code, use the L</guestfs_write> call "
18354 "instead."
18355 msgstr ""
18356
18357 #. type: =head2
18358 #: ../src/guestfs-actions.pod:7333
18359 msgid "guestfs_zegrep"
18360 msgstr ""
18361
18362 #. type: verbatim
18363 #: ../src/guestfs-actions.pod:7335
18364 #, no-wrap
18365 msgid ""
18366 " char **\n"
18367 " guestfs_zegrep (guestfs_h *g,\n"
18368 "                 const char *regex,\n"
18369 "                 const char *path);\n"
18370 "\n"
18371 msgstr ""
18372
18373 #. type: textblock
18374 #: ../src/guestfs-actions.pod:7340 ../fish/guestfish-actions.pod:4920
18375 msgid ""
18376 "This calls the external C<zegrep> program and returns the matching lines."
18377 msgstr ""
18378
18379 #. type: =head2
18380 #: ../src/guestfs-actions.pod:7352
18381 msgid "guestfs_zegrepi"
18382 msgstr ""
18383
18384 #. type: verbatim
18385 #: ../src/guestfs-actions.pod:7354
18386 #, no-wrap
18387 msgid ""
18388 " char **\n"
18389 " guestfs_zegrepi (guestfs_h *g,\n"
18390 "                  const char *regex,\n"
18391 "                  const char *path);\n"
18392 "\n"
18393 msgstr ""
18394
18395 #. type: textblock
18396 #: ../src/guestfs-actions.pod:7359 ../fish/guestfish-actions.pod:4930
18397 msgid ""
18398 "This calls the external C<zegrep -i> program and returns the matching lines."
18399 msgstr ""
18400
18401 #. type: =head2
18402 #: ../src/guestfs-actions.pod:7371
18403 msgid "guestfs_zero"
18404 msgstr ""
18405
18406 #. type: verbatim
18407 #: ../src/guestfs-actions.pod:7373
18408 #, no-wrap
18409 msgid ""
18410 " int\n"
18411 " guestfs_zero (guestfs_h *g,\n"
18412 "               const char *device);\n"
18413 "\n"
18414 msgstr ""
18415
18416 #. type: textblock
18417 #: ../src/guestfs-actions.pod:7377 ../fish/guestfish-actions.pod:4940
18418 msgid "This command writes zeroes over the first few blocks of C<device>."
18419 msgstr ""
18420
18421 #. type: textblock
18422 #: ../src/guestfs-actions.pod:7379 ../fish/guestfish-actions.pod:4942
18423 msgid ""
18424 "How many blocks are zeroed isn't specified (but it's I<not> enough to "
18425 "securely wipe the device).  It should be sufficient to remove any partition "
18426 "tables, filesystem superblocks and so on."
18427 msgstr ""
18428
18429 #. type: textblock
18430 #: ../src/guestfs-actions.pod:7383
18431 msgid "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>."
18432 msgstr ""
18433
18434 #. type: =head2
18435 #: ../src/guestfs-actions.pod:7394
18436 msgid "guestfs_zero_device"
18437 msgstr ""
18438
18439 #. type: verbatim
18440 #: ../src/guestfs-actions.pod:7396
18441 #, no-wrap
18442 msgid ""
18443 " int\n"
18444 " guestfs_zero_device (guestfs_h *g,\n"
18445 "                      const char *device);\n"
18446 "\n"
18447 msgstr ""
18448
18449 #. type: textblock
18450 #: ../src/guestfs-actions.pod:7400
18451 msgid ""
18452 "This command writes zeroes over the entire C<device>.  Compare with "
18453 "C<guestfs_zero> which just zeroes the first few blocks of a device."
18454 msgstr ""
18455
18456 #. type: textblock
18457 #: ../src/guestfs-actions.pod:7414
18458 msgid "(Added in 1.3.1)"
18459 msgstr ""
18460
18461 #. type: =head2
18462 #: ../src/guestfs-actions.pod:7416
18463 msgid "guestfs_zerofree"
18464 msgstr ""
18465
18466 #. type: verbatim
18467 #: ../src/guestfs-actions.pod:7418
18468 #, no-wrap
18469 msgid ""
18470 " int\n"
18471 " guestfs_zerofree (guestfs_h *g,\n"
18472 "                   const char *device);\n"
18473 "\n"
18474 msgstr ""
18475
18476 #. type: textblock
18477 #: ../src/guestfs-actions.pod:7422 ../fish/guestfish-actions.pod:4963
18478 msgid ""
18479 "This runs the I<zerofree> program on C<device>.  This program claims to zero "
18480 "unused inodes and disk blocks on an ext2/3 filesystem, thus making it "
18481 "possible to compress the filesystem more effectively."
18482 msgstr ""
18483
18484 #. type: textblock
18485 #: ../src/guestfs-actions.pod:7427 ../fish/guestfish-actions.pod:4968
18486 msgid "You should B<not> run this program if the filesystem is mounted."
18487 msgstr ""
18488
18489 #. type: textblock
18490 #: ../src/guestfs-actions.pod:7430 ../fish/guestfish-actions.pod:4971
18491 msgid ""
18492 "It is possible that using this program can damage the filesystem or data on "
18493 "the filesystem."
18494 msgstr ""
18495
18496 #. type: =head2
18497 #: ../src/guestfs-actions.pod:7437
18498 msgid "guestfs_zfgrep"
18499 msgstr ""
18500
18501 #. type: verbatim
18502 #: ../src/guestfs-actions.pod:7439
18503 #, no-wrap
18504 msgid ""
18505 " char **\n"
18506 " guestfs_zfgrep (guestfs_h *g,\n"
18507 "                 const char *pattern,\n"
18508 "                 const char *path);\n"
18509 "\n"
18510 msgstr ""
18511
18512 #. type: textblock
18513 #: ../src/guestfs-actions.pod:7444 ../fish/guestfish-actions.pod:4978
18514 msgid ""
18515 "This calls the external C<zfgrep> program and returns the matching lines."
18516 msgstr ""
18517
18518 #. type: =head2
18519 #: ../src/guestfs-actions.pod:7456
18520 msgid "guestfs_zfgrepi"
18521 msgstr ""
18522
18523 #. type: verbatim
18524 #: ../src/guestfs-actions.pod:7458
18525 #, no-wrap
18526 msgid ""
18527 " char **\n"
18528 " guestfs_zfgrepi (guestfs_h *g,\n"
18529 "                  const char *pattern,\n"
18530 "                  const char *path);\n"
18531 "\n"
18532 msgstr ""
18533
18534 #. type: textblock
18535 #: ../src/guestfs-actions.pod:7463 ../fish/guestfish-actions.pod:4988
18536 msgid ""
18537 "This calls the external C<zfgrep -i> program and returns the matching lines."
18538 msgstr ""
18539
18540 #. type: =head2
18541 #: ../src/guestfs-actions.pod:7475
18542 msgid "guestfs_zfile"
18543 msgstr ""
18544
18545 #. type: verbatim
18546 #: ../src/guestfs-actions.pod:7477
18547 #, no-wrap
18548 msgid ""
18549 " char *\n"
18550 " guestfs_zfile (guestfs_h *g,\n"
18551 "                const char *meth,\n"
18552 "                const char *path);\n"
18553 "\n"
18554 msgstr ""
18555
18556 #. type: textblock
18557 #: ../src/guestfs-actions.pod:7482 ../fish/guestfish-actions.pod:4998
18558 msgid ""
18559 "This command runs C<file> after first decompressing C<path> using C<method>."
18560 msgstr ""
18561
18562 #. type: textblock
18563 #: ../src/guestfs-actions.pod:7485 ../fish/guestfish-actions.pod:5001
18564 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>."
18565 msgstr ""
18566
18567 #. type: textblock
18568 #: ../src/guestfs-actions.pod:7487
18569 msgid ""
18570 "Since 1.0.63, use C<guestfs_file> instead which can now process compressed "
18571 "files."
18572 msgstr ""
18573
18574 #. type: textblock
18575 #: ../src/guestfs-actions.pod:7493
18576 msgid ""
18577 "This function is deprecated.  In new code, use the L</guestfs_file> call "
18578 "instead."
18579 msgstr ""
18580
18581 #. type: =head2
18582 #: ../src/guestfs-actions.pod:7502
18583 msgid "guestfs_zgrep"
18584 msgstr ""
18585
18586 #. type: verbatim
18587 #: ../src/guestfs-actions.pod:7504
18588 #, no-wrap
18589 msgid ""
18590 " char **\n"
18591 " guestfs_zgrep (guestfs_h *g,\n"
18592 "                const char *regex,\n"
18593 "                const char *path);\n"
18594 "\n"
18595 msgstr ""
18596
18597 #. type: textblock
18598 #: ../src/guestfs-actions.pod:7509 ../fish/guestfish-actions.pod:5017
18599 msgid ""
18600 "This calls the external C<zgrep> program and returns the matching lines."
18601 msgstr ""
18602
18603 #. type: =head2
18604 #: ../src/guestfs-actions.pod:7521
18605 msgid "guestfs_zgrepi"
18606 msgstr ""
18607
18608 #. type: verbatim
18609 #: ../src/guestfs-actions.pod:7523
18610 #, no-wrap
18611 msgid ""
18612 " char **\n"
18613 " guestfs_zgrepi (guestfs_h *g,\n"
18614 "                 const char *regex,\n"
18615 "                 const char *path);\n"
18616 "\n"
18617 msgstr ""
18618
18619 #. type: textblock
18620 #: ../src/guestfs-actions.pod:7528 ../fish/guestfish-actions.pod:5027
18621 msgid ""
18622 "This calls the external C<zgrep -i> program and returns the matching lines."
18623 msgstr ""
18624
18625 #. type: =item
18626 #: ../src/guestfs-availability.pod:3
18627 msgid "B<augeas>"
18628 msgstr ""
18629
18630 #. type: textblock
18631 #: ../src/guestfs-availability.pod:5
18632 msgid ""
18633 "The following functions: L</guestfs_aug_clear> L</guestfs_aug_close> L</"
18634 "guestfs_aug_defnode> L</guestfs_aug_defvar> L</guestfs_aug_get> L</"
18635 "guestfs_aug_init> L</guestfs_aug_insert> L</guestfs_aug_load> L</"
18636 "guestfs_aug_ls> L</guestfs_aug_match> L</guestfs_aug_mv> L</guestfs_aug_rm> "
18637 "L</guestfs_aug_save> L</guestfs_aug_set>"
18638 msgstr ""
18639
18640 #. type: =item
18641 #: ../src/guestfs-availability.pod:21
18642 msgid "B<inotify>"
18643 msgstr ""
18644
18645 #. type: textblock
18646 #: ../src/guestfs-availability.pod:23
18647 msgid ""
18648 "The following functions: L</guestfs_inotify_add_watch> L</"
18649 "guestfs_inotify_close> L</guestfs_inotify_files> L</guestfs_inotify_init> L</"
18650 "guestfs_inotify_read> L</guestfs_inotify_rm_watch>"
18651 msgstr ""
18652
18653 #. type: =item
18654 #: ../src/guestfs-availability.pod:31
18655 msgid "B<linuxfsuuid>"
18656 msgstr ""
18657
18658 #. type: textblock
18659 #: ../src/guestfs-availability.pod:33
18660 msgid ""
18661 "The following functions: L</guestfs_mke2fs_JU> L</guestfs_mke2journal_U> L</"
18662 "guestfs_mkswap_U> L</guestfs_swapoff_uuid> L</guestfs_swapon_uuid>"
18663 msgstr ""
18664
18665 #. type: =item
18666 #: ../src/guestfs-availability.pod:40
18667 msgid "B<linuxmodules>"
18668 msgstr ""
18669
18670 #. type: textblock
18671 #: ../src/guestfs-availability.pod:42
18672 msgid "The following functions: L</guestfs_modprobe>"
18673 msgstr ""
18674
18675 #. type: =item
18676 #: ../src/guestfs-availability.pod:45
18677 msgid "B<linuxxattrs>"
18678 msgstr ""
18679
18680 #. type: textblock
18681 #: ../src/guestfs-availability.pod:47
18682 msgid ""
18683 "The following functions: L</guestfs_getxattr> L</guestfs_getxattrs> L</"
18684 "guestfs_lgetxattr> L</guestfs_lgetxattrs> L</guestfs_lremovexattr> L</"
18685 "guestfs_lsetxattr> L</guestfs_lxattrlist> L</guestfs_removexattr> L</"
18686 "guestfs_setxattr>"
18687 msgstr ""
18688
18689 #. type: =item
18690 #: ../src/guestfs-availability.pod:58
18691 msgid "B<luks>"
18692 msgstr ""
18693
18694 #. type: textblock
18695 #: ../src/guestfs-availability.pod:60
18696 msgid ""
18697 "The following functions: L</guestfs_luks_add_key> L</guestfs_luks_close> L</"
18698 "guestfs_luks_format> L</guestfs_luks_format_cipher> L</"
18699 "guestfs_luks_kill_slot> L</guestfs_luks_open> L</guestfs_luks_open_ro>"
18700 msgstr ""
18701
18702 #. type: =item
18703 #: ../src/guestfs-availability.pod:69
18704 msgid "B<lvm2>"
18705 msgstr ""
18706
18707 #. type: textblock
18708 #: ../src/guestfs-availability.pod:71
18709 msgid ""
18710 "The following functions: L</guestfs_is_lv> L</guestfs_lvcreate> L</"
18711 "guestfs_lvm_remove_all> L</guestfs_lvm_set_filter> L</guestfs_lvremove> L</"
18712 "guestfs_lvresize> L</guestfs_lvresize_free> L</guestfs_lvs> L</"
18713 "guestfs_lvs_full> L</guestfs_pvcreate> L</guestfs_pvremove> L</"
18714 "guestfs_pvresize> L</guestfs_pvresize_size> L</guestfs_pvs> L</"
18715 "guestfs_pvs_full> L</guestfs_vg_activate> L</guestfs_vg_activate_all> L</"
18716 "guestfs_vgcreate> L</guestfs_vgremove> L</guestfs_vgs> L</guestfs_vgs_full>"
18717 msgstr ""
18718
18719 #. type: =item
18720 #: ../src/guestfs-availability.pod:94
18721 msgid "B<mknod>"
18722 msgstr ""
18723
18724 #. type: textblock
18725 #: ../src/guestfs-availability.pod:96
18726 msgid ""
18727 "The following functions: L</guestfs_mkfifo> L</guestfs_mknod> L</"
18728 "guestfs_mknod_b> L</guestfs_mknod_c>"
18729 msgstr ""
18730
18731 #. type: =item
18732 #: ../src/guestfs-availability.pod:102
18733 msgid "B<ntfs3g>"
18734 msgstr ""
18735
18736 #. type: textblock
18737 #: ../src/guestfs-availability.pod:104
18738 msgid "The following functions: L</guestfs_ntfs_3g_probe>"
18739 msgstr ""
18740
18741 #. type: =item
18742 #: ../src/guestfs-availability.pod:107
18743 msgid "B<ntfsprogs>"
18744 msgstr ""
18745
18746 #. type: textblock
18747 #: ../src/guestfs-availability.pod:109
18748 msgid ""
18749 "The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_size>"
18750 msgstr ""
18751
18752 #. type: =item
18753 #: ../src/guestfs-availability.pod:113
18754 msgid "B<realpath>"
18755 msgstr ""
18756
18757 #. type: textblock
18758 #: ../src/guestfs-availability.pod:115
18759 msgid "The following functions: L</guestfs_realpath>"
18760 msgstr ""
18761
18762 #. type: =item
18763 #: ../src/guestfs-availability.pod:118
18764 msgid "B<scrub>"
18765 msgstr ""
18766
18767 #. type: textblock
18768 #: ../src/guestfs-availability.pod:120
18769 msgid ""
18770 "The following functions: L</guestfs_scrub_device> L</guestfs_scrub_file> L</"
18771 "guestfs_scrub_freespace>"
18772 msgstr ""
18773
18774 #. type: =item
18775 #: ../src/guestfs-availability.pod:125
18776 msgid "B<selinux>"
18777 msgstr ""
18778
18779 #. type: textblock
18780 #: ../src/guestfs-availability.pod:127
18781 msgid "The following functions: L</guestfs_getcon> L</guestfs_setcon>"
18782 msgstr ""
18783
18784 #. type: =item
18785 #: ../src/guestfs-availability.pod:131
18786 msgid "B<xz>"
18787 msgstr ""
18788
18789 #. type: textblock
18790 #: ../src/guestfs-availability.pod:133
18791 msgid "The following functions: L</guestfs_txz_in> L</guestfs_txz_out>"
18792 msgstr ""
18793
18794 #. type: =item
18795 #: ../src/guestfs-availability.pod:137
18796 msgid "B<zerofree>"
18797 msgstr ""
18798
18799 #. type: textblock
18800 #: ../src/guestfs-availability.pod:139
18801 msgid "The following functions: L</guestfs_zerofree>"
18802 msgstr ""
18803
18804 #. type: =head2
18805 #: ../src/guestfs-structs.pod:1
18806 msgid "guestfs_int_bool"
18807 msgstr ""
18808
18809 #. type: verbatim
18810 #: ../src/guestfs-structs.pod:3
18811 #, no-wrap
18812 msgid ""
18813 " struct guestfs_int_bool {\n"
18814 "   int32_t i;\n"
18815 "   int32_t b;\n"
18816 " };\n"
18817 " \n"
18818 msgstr ""
18819
18820 #. type: verbatim
18821 #: ../src/guestfs-structs.pod:8
18822 #, no-wrap
18823 msgid ""
18824 " struct guestfs_int_bool_list {\n"
18825 "   uint32_t len; /* Number of elements in list. */\n"
18826 "   struct guestfs_int_bool *val; /* Elements. */\n"
18827 " };\n"
18828 " \n"
18829 msgstr ""
18830
18831 #. type: verbatim
18832 #: ../src/guestfs-structs.pod:13
18833 #, no-wrap
18834 msgid ""
18835 " void guestfs_free_int_bool (struct guestfs_free_int_bool *);\n"
18836 " void guestfs_free_int_bool_list (struct guestfs_free_int_bool_list *);\n"
18837 "\n"
18838 msgstr ""
18839
18840 #. type: =head2
18841 #: ../src/guestfs-structs.pod:16
18842 msgid "guestfs_lvm_pv"
18843 msgstr ""
18844
18845 #. type: verbatim
18846 #: ../src/guestfs-structs.pod:18
18847 #, no-wrap
18848 msgid ""
18849 " struct guestfs_lvm_pv {\n"
18850 "   char *pv_name;\n"
18851 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
18852 "   char pv_uuid[32];\n"
18853 "   char *pv_fmt;\n"
18854 "   uint64_t pv_size;\n"
18855 "   uint64_t dev_size;\n"
18856 "   uint64_t pv_free;\n"
18857 "   uint64_t pv_used;\n"
18858 "   char *pv_attr;\n"
18859 "   int64_t pv_pe_count;\n"
18860 "   int64_t pv_pe_alloc_count;\n"
18861 "   char *pv_tags;\n"
18862 "   uint64_t pe_start;\n"
18863 "   int64_t pv_mda_count;\n"
18864 "   uint64_t pv_mda_free;\n"
18865 " };\n"
18866 " \n"
18867 msgstr ""
18868
18869 #. type: verbatim
18870 #: ../src/guestfs-structs.pod:36
18871 #, no-wrap
18872 msgid ""
18873 " struct guestfs_lvm_pv_list {\n"
18874 "   uint32_t len; /* Number of elements in list. */\n"
18875 "   struct guestfs_lvm_pv *val; /* Elements. */\n"
18876 " };\n"
18877 " \n"
18878 msgstr ""
18879
18880 #. type: verbatim
18881 #: ../src/guestfs-structs.pod:41
18882 #, no-wrap
18883 msgid ""
18884 " void guestfs_free_lvm_pv (struct guestfs_free_lvm_pv *);\n"
18885 " void guestfs_free_lvm_pv_list (struct guestfs_free_lvm_pv_list *);\n"
18886 "\n"
18887 msgstr ""
18888
18889 #. type: =head2
18890 #: ../src/guestfs-structs.pod:44
18891 msgid "guestfs_lvm_vg"
18892 msgstr ""
18893
18894 #. type: verbatim
18895 #: ../src/guestfs-structs.pod:46
18896 #, no-wrap
18897 msgid ""
18898 " struct guestfs_lvm_vg {\n"
18899 "   char *vg_name;\n"
18900 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
18901 "   char vg_uuid[32];\n"
18902 "   char *vg_fmt;\n"
18903 "   char *vg_attr;\n"
18904 "   uint64_t vg_size;\n"
18905 "   uint64_t vg_free;\n"
18906 "   char *vg_sysid;\n"
18907 "   uint64_t vg_extent_size;\n"
18908 "   int64_t vg_extent_count;\n"
18909 "   int64_t vg_free_count;\n"
18910 "   int64_t max_lv;\n"
18911 "   int64_t max_pv;\n"
18912 "   int64_t pv_count;\n"
18913 "   int64_t lv_count;\n"
18914 "   int64_t snap_count;\n"
18915 "   int64_t vg_seqno;\n"
18916 "   char *vg_tags;\n"
18917 "   int64_t vg_mda_count;\n"
18918 "   uint64_t vg_mda_free;\n"
18919 " };\n"
18920 " \n"
18921 msgstr ""
18922
18923 #. type: verbatim
18924 #: ../src/guestfs-structs.pod:69
18925 #, no-wrap
18926 msgid ""
18927 " struct guestfs_lvm_vg_list {\n"
18928 "   uint32_t len; /* Number of elements in list. */\n"
18929 "   struct guestfs_lvm_vg *val; /* Elements. */\n"
18930 " };\n"
18931 " \n"
18932 msgstr ""
18933
18934 #. type: verbatim
18935 #: ../src/guestfs-structs.pod:74
18936 #, no-wrap
18937 msgid ""
18938 " void guestfs_free_lvm_vg (struct guestfs_free_lvm_vg *);\n"
18939 " void guestfs_free_lvm_vg_list (struct guestfs_free_lvm_vg_list *);\n"
18940 "\n"
18941 msgstr ""
18942
18943 #. type: =head2
18944 #: ../src/guestfs-structs.pod:77
18945 msgid "guestfs_lvm_lv"
18946 msgstr ""
18947
18948 #. type: verbatim
18949 #: ../src/guestfs-structs.pod:79
18950 #, no-wrap
18951 msgid ""
18952 " struct guestfs_lvm_lv {\n"
18953 "   char *lv_name;\n"
18954 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
18955 "   char lv_uuid[32];\n"
18956 "   char *lv_attr;\n"
18957 "   int64_t lv_major;\n"
18958 "   int64_t lv_minor;\n"
18959 "   int64_t lv_kernel_major;\n"
18960 "   int64_t lv_kernel_minor;\n"
18961 "   uint64_t lv_size;\n"
18962 "   int64_t seg_count;\n"
18963 "   char *origin;\n"
18964 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
18965 "   float snap_percent;\n"
18966 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
18967 "   float copy_percent;\n"
18968 "   char *move_pv;\n"
18969 "   char *lv_tags;\n"
18970 "   char *mirror_log;\n"
18971 "   char *modules;\n"
18972 " };\n"
18973 " \n"
18974 msgstr ""
18975
18976 #. type: verbatim
18977 #: ../src/guestfs-structs.pod:101
18978 #, no-wrap
18979 msgid ""
18980 " struct guestfs_lvm_lv_list {\n"
18981 "   uint32_t len; /* Number of elements in list. */\n"
18982 "   struct guestfs_lvm_lv *val; /* Elements. */\n"
18983 " };\n"
18984 " \n"
18985 msgstr ""
18986
18987 #. type: verbatim
18988 #: ../src/guestfs-structs.pod:106
18989 #, no-wrap
18990 msgid ""
18991 " void guestfs_free_lvm_lv (struct guestfs_free_lvm_lv *);\n"
18992 " void guestfs_free_lvm_lv_list (struct guestfs_free_lvm_lv_list *);\n"
18993 "\n"
18994 msgstr ""
18995
18996 #. type: verbatim
18997 #: ../src/guestfs-structs.pod:111
18998 #, no-wrap
18999 msgid ""
19000 " struct guestfs_stat {\n"
19001 "   int64_t dev;\n"
19002 "   int64_t ino;\n"
19003 "   int64_t mode;\n"
19004 "   int64_t nlink;\n"
19005 "   int64_t uid;\n"
19006 "   int64_t gid;\n"
19007 "   int64_t rdev;\n"
19008 "   int64_t size;\n"
19009 "   int64_t blksize;\n"
19010 "   int64_t blocks;\n"
19011 "   int64_t atime;\n"
19012 "   int64_t mtime;\n"
19013 "   int64_t ctime;\n"
19014 " };\n"
19015 " \n"
19016 msgstr ""
19017
19018 #. type: verbatim
19019 #: ../src/guestfs-structs.pod:127
19020 #, no-wrap
19021 msgid ""
19022 " struct guestfs_stat_list {\n"
19023 "   uint32_t len; /* Number of elements in list. */\n"
19024 "   struct guestfs_stat *val; /* Elements. */\n"
19025 " };\n"
19026 " \n"
19027 msgstr ""
19028
19029 #. type: verbatim
19030 #: ../src/guestfs-structs.pod:132
19031 #, no-wrap
19032 msgid ""
19033 " void guestfs_free_stat (struct guestfs_free_stat *);\n"
19034 " void guestfs_free_stat_list (struct guestfs_free_stat_list *);\n"
19035 "\n"
19036 msgstr ""
19037
19038 #. type: verbatim
19039 #: ../src/guestfs-structs.pod:137
19040 #, no-wrap
19041 msgid ""
19042 " struct guestfs_statvfs {\n"
19043 "   int64_t bsize;\n"
19044 "   int64_t frsize;\n"
19045 "   int64_t blocks;\n"
19046 "   int64_t bfree;\n"
19047 "   int64_t bavail;\n"
19048 "   int64_t files;\n"
19049 "   int64_t ffree;\n"
19050 "   int64_t favail;\n"
19051 "   int64_t fsid;\n"
19052 "   int64_t flag;\n"
19053 "   int64_t namemax;\n"
19054 " };\n"
19055 " \n"
19056 msgstr ""
19057
19058 #. type: verbatim
19059 #: ../src/guestfs-structs.pod:151
19060 #, no-wrap
19061 msgid ""
19062 " struct guestfs_statvfs_list {\n"
19063 "   uint32_t len; /* Number of elements in list. */\n"
19064 "   struct guestfs_statvfs *val; /* Elements. */\n"
19065 " };\n"
19066 " \n"
19067 msgstr ""
19068
19069 #. type: verbatim
19070 #: ../src/guestfs-structs.pod:156
19071 #, no-wrap
19072 msgid ""
19073 " void guestfs_free_statvfs (struct guestfs_free_statvfs *);\n"
19074 " void guestfs_free_statvfs_list (struct guestfs_free_statvfs_list *);\n"
19075 "\n"
19076 msgstr ""
19077
19078 #. type: =head2
19079 #: ../src/guestfs-structs.pod:159
19080 msgid "guestfs_dirent"
19081 msgstr ""
19082
19083 #. type: verbatim
19084 #: ../src/guestfs-structs.pod:161
19085 #, no-wrap
19086 msgid ""
19087 " struct guestfs_dirent {\n"
19088 "   int64_t ino;\n"
19089 "   char ftyp;\n"
19090 "   char *name;\n"
19091 " };\n"
19092 " \n"
19093 msgstr ""
19094
19095 #. type: verbatim
19096 #: ../src/guestfs-structs.pod:167
19097 #, no-wrap
19098 msgid ""
19099 " struct guestfs_dirent_list {\n"
19100 "   uint32_t len; /* Number of elements in list. */\n"
19101 "   struct guestfs_dirent *val; /* Elements. */\n"
19102 " };\n"
19103 " \n"
19104 msgstr ""
19105
19106 #. type: verbatim
19107 #: ../src/guestfs-structs.pod:172
19108 #, no-wrap
19109 msgid ""
19110 " void guestfs_free_dirent (struct guestfs_free_dirent *);\n"
19111 " void guestfs_free_dirent_list (struct guestfs_free_dirent_list *);\n"
19112 "\n"
19113 msgstr ""
19114
19115 #. type: verbatim
19116 #: ../src/guestfs-structs.pod:177
19117 #, no-wrap
19118 msgid ""
19119 " struct guestfs_version {\n"
19120 "   int64_t major;\n"
19121 "   int64_t minor;\n"
19122 "   int64_t release;\n"
19123 "   char *extra;\n"
19124 " };\n"
19125 " \n"
19126 msgstr ""
19127
19128 #. type: verbatim
19129 #: ../src/guestfs-structs.pod:184
19130 #, no-wrap
19131 msgid ""
19132 " struct guestfs_version_list {\n"
19133 "   uint32_t len; /* Number of elements in list. */\n"
19134 "   struct guestfs_version *val; /* Elements. */\n"
19135 " };\n"
19136 " \n"
19137 msgstr ""
19138
19139 #. type: verbatim
19140 #: ../src/guestfs-structs.pod:189
19141 #, no-wrap
19142 msgid ""
19143 " void guestfs_free_version (struct guestfs_free_version *);\n"
19144 " void guestfs_free_version_list (struct guestfs_free_version_list *);\n"
19145 "\n"
19146 msgstr ""
19147
19148 #. type: =head2
19149 #: ../src/guestfs-structs.pod:192
19150 msgid "guestfs_xattr"
19151 msgstr ""
19152
19153 #. type: verbatim
19154 #: ../src/guestfs-structs.pod:194
19155 #, no-wrap
19156 msgid ""
19157 " struct guestfs_xattr {\n"
19158 "   char *attrname;\n"
19159 "   /* The next two fields describe a byte array. */\n"
19160 "   uint32_t attrval_len;\n"
19161 "   char *attrval;\n"
19162 " };\n"
19163 " \n"
19164 msgstr ""
19165
19166 #. type: verbatim
19167 #: ../src/guestfs-structs.pod:201
19168 #, no-wrap
19169 msgid ""
19170 " struct guestfs_xattr_list {\n"
19171 "   uint32_t len; /* Number of elements in list. */\n"
19172 "   struct guestfs_xattr *val; /* Elements. */\n"
19173 " };\n"
19174 " \n"
19175 msgstr ""
19176
19177 #. type: verbatim
19178 #: ../src/guestfs-structs.pod:206
19179 #, no-wrap
19180 msgid ""
19181 " void guestfs_free_xattr (struct guestfs_free_xattr *);\n"
19182 " void guestfs_free_xattr_list (struct guestfs_free_xattr_list *);\n"
19183 "\n"
19184 msgstr ""
19185
19186 #. type: =head2
19187 #: ../src/guestfs-structs.pod:209
19188 msgid "guestfs_inotify_event"
19189 msgstr ""
19190
19191 #. type: verbatim
19192 #: ../src/guestfs-structs.pod:211
19193 #, no-wrap
19194 msgid ""
19195 " struct guestfs_inotify_event {\n"
19196 "   int64_t in_wd;\n"
19197 "   uint32_t in_mask;\n"
19198 "   uint32_t in_cookie;\n"
19199 "   char *in_name;\n"
19200 " };\n"
19201 " \n"
19202 msgstr ""
19203
19204 #. type: verbatim
19205 #: ../src/guestfs-structs.pod:218
19206 #, no-wrap
19207 msgid ""
19208 " struct guestfs_inotify_event_list {\n"
19209 "   uint32_t len; /* Number of elements in list. */\n"
19210 "   struct guestfs_inotify_event *val; /* Elements. */\n"
19211 " };\n"
19212 " \n"
19213 msgstr ""
19214
19215 #. type: verbatim
19216 #: ../src/guestfs-structs.pod:223
19217 #, no-wrap
19218 msgid ""
19219 " void guestfs_free_inotify_event (struct guestfs_free_inotify_event *);\n"
19220 " void guestfs_free_inotify_event_list (struct guestfs_free_inotify_event_list *);\n"
19221 "\n"
19222 msgstr ""
19223
19224 #. type: =head2
19225 #: ../src/guestfs-structs.pod:226
19226 msgid "guestfs_partition"
19227 msgstr ""
19228
19229 #. type: verbatim
19230 #: ../src/guestfs-structs.pod:228
19231 #, no-wrap
19232 msgid ""
19233 " struct guestfs_partition {\n"
19234 "   int32_t part_num;\n"
19235 "   uint64_t part_start;\n"
19236 "   uint64_t part_end;\n"
19237 "   uint64_t part_size;\n"
19238 " };\n"
19239 " \n"
19240 msgstr ""
19241
19242 #. type: verbatim
19243 #: ../src/guestfs-structs.pod:235
19244 #, no-wrap
19245 msgid ""
19246 " struct guestfs_partition_list {\n"
19247 "   uint32_t len; /* Number of elements in list. */\n"
19248 "   struct guestfs_partition *val; /* Elements. */\n"
19249 " };\n"
19250 " \n"
19251 msgstr ""
19252
19253 #. type: verbatim
19254 #: ../src/guestfs-structs.pod:240
19255 #, no-wrap
19256 msgid ""
19257 " void guestfs_free_partition (struct guestfs_free_partition *);\n"
19258 " void guestfs_free_partition_list (struct guestfs_free_partition_list *);\n"
19259 "\n"
19260 msgstr ""
19261
19262 #. type: =head2
19263 #: ../src/guestfs-structs.pod:243
19264 msgid "guestfs_application"
19265 msgstr ""
19266
19267 #. type: verbatim
19268 #: ../src/guestfs-structs.pod:245
19269 #, no-wrap
19270 msgid ""
19271 " struct guestfs_application {\n"
19272 "   char *app_name;\n"
19273 "   char *app_display_name;\n"
19274 "   int32_t app_epoch;\n"
19275 "   char *app_version;\n"
19276 "   char *app_release;\n"
19277 "   char *app_install_path;\n"
19278 "   char *app_trans_path;\n"
19279 "   char *app_publisher;\n"
19280 "   char *app_url;\n"
19281 "   char *app_source_package;\n"
19282 "   char *app_summary;\n"
19283 "   char *app_description;\n"
19284 " };\n"
19285 " \n"
19286 msgstr ""
19287
19288 #. type: verbatim
19289 #: ../src/guestfs-structs.pod:260
19290 #, no-wrap
19291 msgid ""
19292 " struct guestfs_application_list {\n"
19293 "   uint32_t len; /* Number of elements in list. */\n"
19294 "   struct guestfs_application *val; /* Elements. */\n"
19295 " };\n"
19296 " \n"
19297 msgstr ""
19298
19299 #. type: verbatim
19300 #: ../src/guestfs-structs.pod:265
19301 #, no-wrap
19302 msgid ""
19303 " void guestfs_free_application (struct guestfs_free_application *);\n"
19304 " void guestfs_free_application_list (struct guestfs_free_application_list *);\n"
19305 "\n"
19306 msgstr ""
19307
19308 #. type: textblock
19309 #: ../fish/guestfish.pod:5
19310 msgid "guestfish - the libguestfs Filesystem Interactive SHell"
19311 msgstr ""
19312
19313 #. type: verbatim
19314 #: ../fish/guestfish.pod:9
19315 #, no-wrap
19316 msgid ""
19317 " guestfish [--options] [commands]\n"
19318 "\n"
19319 msgstr ""
19320
19321 #. type: verbatim
19322 #: ../fish/guestfish.pod:11
19323 #, no-wrap
19324 msgid ""
19325 " guestfish\n"
19326 "\n"
19327 msgstr ""
19328
19329 #. type: verbatim
19330 #: ../fish/guestfish.pod:13
19331 #, no-wrap
19332 msgid ""
19333 " guestfish [--ro|--rw] -a disk.img\n"
19334 "\n"
19335 msgstr ""
19336
19337 #. type: verbatim
19338 #: ../fish/guestfish.pod:15
19339 #, no-wrap
19340 msgid ""
19341 " guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]\n"
19342 "\n"
19343 msgstr ""
19344
19345 #. type: verbatim
19346 #: ../fish/guestfish.pod:17
19347 #, no-wrap
19348 msgid ""
19349 " guestfish -d libvirt-domain\n"
19350 "\n"
19351 msgstr ""
19352
19353 #. type: verbatim
19354 #: ../fish/guestfish.pod:19
19355 #, no-wrap
19356 msgid ""
19357 " guestfish [--ro|--rw] -a disk.img -i\n"
19358 "\n"
19359 msgstr ""
19360
19361 #. type: verbatim
19362 #: ../fish/guestfish.pod:21
19363 #, no-wrap
19364 msgid ""
19365 " guestfish -d libvirt-domain -i\n"
19366 "\n"
19367 msgstr ""
19368
19369 #. type: =head1
19370 #: ../fish/guestfish.pod:23 ../fuse/guestmount.pod:15 ../tools/virt-edit.pl:44
19371 #: ../tools/virt-win-reg.pl:51 ../tools/virt-tar.pl:64
19372 msgid "WARNING"
19373 msgstr ""
19374
19375 #. type: textblock
19376 #: ../fish/guestfish.pod:25
19377 msgid ""
19378 "Using guestfish in read/write mode on live virtual machines can be "
19379 "dangerous, potentially causing disk corruption.  Use the I<--ro> (read-only) "
19380 "option to use guestfish safely if the disk image or virtual machine might be "
19381 "live."
19382 msgstr ""
19383
19384 #. type: textblock
19385 #: ../fish/guestfish.pod:32
19386 msgid ""
19387 "Guestfish is a shell and command-line tool for examining and modifying "
19388 "virtual machine filesystems.  It uses libguestfs and exposes all of the "
19389 "functionality of the guestfs API, see L<guestfs(3)>."
19390 msgstr ""
19391
19392 #. type: textblock
19393 #: ../fish/guestfish.pod:36
19394 msgid ""
19395 "Guestfish gives you structured access to the libguestfs API, from shell "
19396 "scripts or the command line or interactively.  If you want to rescue a "
19397 "broken virtual machine image, you should look at the L<virt-rescue(1)> "
19398 "command."
19399 msgstr ""
19400
19401 #. type: =head1
19402 #: ../fish/guestfish.pod:41 ../fish/guestfish.pod:958
19403 #: ../fuse/guestmount.pod:39 ../tools/virt-edit.pl:63 ../tools/virt-tar.pl:50
19404 msgid "EXAMPLES"
19405 msgstr ""
19406
19407 #. type: =head2
19408 #: ../fish/guestfish.pod:43
19409 msgid "As an interactive shell"
19410 msgstr ""
19411
19412 #. type: verbatim
19413 #: ../fish/guestfish.pod:45
19414 #, no-wrap
19415 msgid ""
19416 " $ guestfish\n"
19417 " \n"
19418 msgstr ""
19419
19420 #. type: verbatim
19421 #: ../fish/guestfish.pod:47
19422 #, no-wrap
19423 msgid ""
19424 " Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
19425 " editing virtual machine filesystems.\n"
19426 " \n"
19427 msgstr ""
19428
19429 #. type: verbatim
19430 #: ../fish/guestfish.pod:50
19431 #, no-wrap
19432 msgid ""
19433 " Type: 'help' for a list of commands\n"
19434 "       'man' to read the manual\n"
19435 "       'quit' to quit the shell\n"
19436 " \n"
19437 msgstr ""
19438
19439 #. type: verbatim
19440 #: ../fish/guestfish.pod:54
19441 #, no-wrap
19442 msgid ""
19443 " ><fs> add-ro disk.img\n"
19444 " ><fs> run\n"
19445 " ><fs> list-filesystems\n"
19446 " /dev/sda1: ext4\n"
19447 " /dev/vg_guest/lv_root: ext4\n"
19448 " /dev/vg_guest/lv_swap: swap\n"
19449 " ><fs> mount /dev/vg_guest/lv_root /\n"
19450 " ><fs> cat /etc/fstab\n"
19451 " # /etc/fstab\n"
19452 " # Created by anaconda\n"
19453 " [...]\n"
19454 " ><fs> exit\n"
19455 "\n"
19456 msgstr ""
19457
19458 #. type: =head2
19459 #: ../fish/guestfish.pod:67
19460 msgid "From shell scripts"
19461 msgstr ""
19462
19463 #. type: textblock
19464 #: ../fish/guestfish.pod:69
19465 msgid "Create a new C</etc/motd> file in a guest or disk image:"
19466 msgstr ""
19467
19468 #. type: verbatim
19469 #: ../fish/guestfish.pod:71
19470 #, no-wrap
19471 msgid ""
19472 " guestfish <<_EOF_\n"
19473 " add disk.img\n"
19474 " run\n"
19475 " mount /dev/vg_guest/lv_root /\n"
19476 " write /etc/motd \"Welcome, new users\"\n"
19477 " _EOF_\n"
19478 "\n"
19479 msgstr ""
19480
19481 #. type: textblock
19482 #: ../fish/guestfish.pod:78
19483 msgid "List the LVM logical volumes in a disk image:"
19484 msgstr ""
19485
19486 #. type: verbatim
19487 #: ../fish/guestfish.pod:80
19488 #, no-wrap
19489 msgid ""
19490 " guestfish -a disk.img --ro <<_EOF_\n"
19491 " run\n"
19492 " lvs\n"
19493 " _EOF_\n"
19494 "\n"
19495 msgstr ""
19496
19497 #. type: textblock
19498 #: ../fish/guestfish.pod:85
19499 msgid "List all the filesystems in a disk image:"
19500 msgstr ""
19501
19502 #. type: verbatim
19503 #: ../fish/guestfish.pod:87
19504 #, no-wrap
19505 msgid ""
19506 " guestfish -a disk.img --ro <<_EOF_\n"
19507 " run\n"
19508 " list-filesystems\n"
19509 " _EOF_\n"
19510 "\n"
19511 msgstr ""
19512
19513 #. type: =head2
19514 #: ../fish/guestfish.pod:92
19515 msgid "On one command line"
19516 msgstr ""
19517
19518 #. type: textblock
19519 #: ../fish/guestfish.pod:94
19520 msgid "Update C</etc/resolv.conf> in a guest:"
19521 msgstr ""
19522
19523 #. type: verbatim
19524 #: ../fish/guestfish.pod:96
19525 #, no-wrap
19526 msgid ""
19527 " guestfish \\\n"
19528 "   add disk.img : run : mount /dev/vg_guest/lv_root / : \\\n"
19529 "   write /etc/resolv.conf \"nameserver 1.2.3.4\"\n"
19530 "\n"
19531 msgstr ""
19532
19533 #. type: textblock
19534 #: ../fish/guestfish.pod:100
19535 msgid "Edit C</boot/grub/grub.conf> interactively:"
19536 msgstr ""
19537
19538 #. type: verbatim
19539 #: ../fish/guestfish.pod:102
19540 #, no-wrap
19541 msgid ""
19542 " guestfish --rw --add disk.img \\\n"
19543 "   --mount /dev/vg_guest/lv_root \\\n"
19544 "   --mount /dev/sda1:/boot \\\n"
19545 "   edit /boot/grub/grub.conf\n"
19546 "\n"
19547 msgstr ""
19548
19549 #. type: =head2
19550 #: ../fish/guestfish.pod:107
19551 msgid "Mount disks automatically"
19552 msgstr ""
19553
19554 #. type: textblock
19555 #: ../fish/guestfish.pod:109
19556 msgid ""
19557 "Use the I<-i> option to automatically mount the disks from a virtual machine:"
19558 msgstr ""
19559
19560 #. type: verbatim
19561 #: ../fish/guestfish.pod:112
19562 #, no-wrap
19563 msgid ""
19564 " guestfish --ro -a disk.img -i cat /etc/group\n"
19565 "\n"
19566 msgstr ""
19567
19568 #. type: verbatim
19569 #: ../fish/guestfish.pod:114
19570 #, no-wrap
19571 msgid ""
19572 " guestfish --ro -d libvirt-domain -i cat /etc/group\n"
19573 "\n"
19574 msgstr ""
19575
19576 #. type: textblock
19577 #: ../fish/guestfish.pod:116
19578 msgid "Another way to edit C</boot/grub/grub.conf> interactively is:"
19579 msgstr ""
19580
19581 #. type: verbatim
19582 #: ../fish/guestfish.pod:118
19583 #, no-wrap
19584 msgid ""
19585 " guestfish --rw -a disk.img -i edit /boot/grub/grub.conf\n"
19586 "\n"
19587 msgstr ""
19588
19589 #. type: =head2
19590 #: ../fish/guestfish.pod:120
19591 msgid "As a script interpreter"
19592 msgstr ""
19593
19594 #. type: textblock
19595 #: ../fish/guestfish.pod:122
19596 msgid "Create a 100MB disk containing an ext2-formatted partition:"
19597 msgstr ""
19598
19599 #. type: verbatim
19600 #: ../fish/guestfish.pod:124
19601 #, no-wrap
19602 msgid ""
19603 " #!/usr/bin/guestfish -f\n"
19604 " sparse test1.img 100M\n"
19605 " run\n"
19606 " part-disk /dev/sda mbr\n"
19607 " mkfs ext2 /dev/sda1\n"
19608 "\n"
19609 msgstr ""
19610
19611 #. type: =head2
19612 #: ../fish/guestfish.pod:130
19613 msgid "Start with a prepared disk"
19614 msgstr ""
19615
19616 #. type: textblock
19617 #: ../fish/guestfish.pod:132
19618 msgid ""
19619 "An alternate way to create a 100MB disk called C<test1.img> containing a "
19620 "single ext2-formatted partition:"
19621 msgstr ""
19622
19623 #. type: verbatim
19624 #: ../fish/guestfish.pod:135
19625 #, no-wrap
19626 msgid ""
19627 " guestfish -N fs\n"
19628 "\n"
19629 msgstr ""
19630
19631 #. type: textblock
19632 #: ../fish/guestfish.pod:137
19633 msgid "To list what is available do:"
19634 msgstr ""
19635
19636 #. type: verbatim
19637 #: ../fish/guestfish.pod:139 ../fish/guestfish.pod:949
19638 #, no-wrap
19639 msgid ""
19640 " guestfish -N help | less\n"
19641 "\n"
19642 msgstr ""
19643
19644 #. type: =head2
19645 #: ../fish/guestfish.pod:141
19646 msgid "Remote control"
19647 msgstr ""
19648
19649 #. type: verbatim
19650 #: ../fish/guestfish.pod:143
19651 #, no-wrap
19652 msgid ""
19653 " eval \"`guestfish --listen`\"\n"
19654 " guestfish --remote add-ro disk.img\n"
19655 " guestfish --remote run\n"
19656 " guestfish --remote lvs\n"
19657 "\n"
19658 msgstr ""
19659
19660 #. type: =head1
19661 #: ../fish/guestfish.pod:148 ../test-tool/libguestfs-test-tool.pod:37
19662 #: ../fuse/guestmount.pod:83 ../tools/virt-edit.pl:81
19663 #: ../tools/virt-win-reg.pl:96 ../tools/virt-list-filesystems.pl:53
19664 #: ../tools/virt-tar.pl:103 ../tools/virt-make-fs.pl:153
19665 #: ../tools/virt-list-partitions.pl:54
19666 msgid "OPTIONS"
19667 msgstr ""
19668
19669 #. type: =item
19670 #: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:141
19671 #: ../tools/virt-edit.pl:89 ../tools/virt-win-reg.pl:104
19672 #: ../tools/virt-list-filesystems.pl:61 ../tools/virt-tar.pl:111
19673 #: ../tools/virt-make-fs.pl:161 ../tools/virt-list-partitions.pl:62
19674 msgid "B<--help>"
19675 msgstr ""
19676
19677 #. type: textblock
19678 #: ../fish/guestfish.pod:154
19679 msgid "Displays general help on options."
19680 msgstr ""
19681
19682 #. type: =item
19683 #: ../fish/guestfish.pod:156
19684 msgid "B<-h>"
19685 msgstr ""
19686
19687 #. type: =item
19688 #: ../fish/guestfish.pod:158
19689 msgid "B<--cmd-help>"
19690 msgstr ""
19691
19692 #. type: textblock
19693 #: ../fish/guestfish.pod:160
19694 msgid "Lists all available guestfish commands."
19695 msgstr ""
19696
19697 #. type: =item
19698 #: ../fish/guestfish.pod:162
19699 msgid "B<-h cmd>"
19700 msgstr ""
19701
19702 #. type: =item
19703 #: ../fish/guestfish.pod:164
19704 msgid "B<--cmd-help cmd>"
19705 msgstr ""
19706
19707 #. type: textblock
19708 #: ../fish/guestfish.pod:166
19709 msgid "Displays detailed help on a single command C<cmd>."
19710 msgstr ""
19711
19712 #. type: =item
19713 #: ../fish/guestfish.pod:168
19714 msgid "B<-a image>"
19715 msgstr ""
19716
19717 #. type: =item
19718 #: ../fish/guestfish.pod:170
19719 msgid "B<--add image>"
19720 msgstr ""
19721
19722 #. type: textblock
19723 #: ../fish/guestfish.pod:172
19724 msgid "Add a block device or virtual machine image to the shell."
19725 msgstr ""
19726
19727 #. type: textblock
19728 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:91
19729 msgid ""
19730 "The format of the disk image is auto-detected.  To override this and force a "
19731 "particular format use the I<--format=..> option."
19732 msgstr ""
19733
19734 #. type: textblock
19735 #: ../fish/guestfish.pod:177
19736 msgid ""
19737 "Using this flag is mostly equivalent to using the C<add> command, with "
19738 "C<readonly:true> if the I<--ro> flag was given, and with C<format:...> if "
19739 "the I<--format=...> flag was given."
19740 msgstr ""
19741
19742 #. type: =item
19743 #: ../fish/guestfish.pod:181
19744 msgid "B<-c URI>"
19745 msgstr ""
19746
19747 #. type: =item
19748 #: ../fish/guestfish.pod:183
19749 msgid "B<--connect URI>"
19750 msgstr ""
19751
19752 #. type: textblock
19753 #: ../fish/guestfish.pod:185 ../fuse/guestmount.pod:96
19754 msgid ""
19755 "When used in conjunction with the I<-d> option, this specifies the libvirt "
19756 "URI to use.  The default is to use the default libvirt connection."
19757 msgstr ""
19758
19759 #. type: =item
19760 #: ../fish/guestfish.pod:189
19761 msgid "B<--csh>"
19762 msgstr ""
19763
19764 #. type: textblock
19765 #: ../fish/guestfish.pod:191
19766 msgid ""
19767 "If using the I<--listen> option and a csh-like shell, use this option.  See "
19768 "section L</REMOTE CONTROL AND CSH> below."
19769 msgstr ""
19770
19771 #. type: =item
19772 #: ../fish/guestfish.pod:194
19773 msgid "B<-d libvirt-domain>"
19774 msgstr ""
19775
19776 #. type: =item
19777 #: ../fish/guestfish.pod:196
19778 msgid "B<--domain libvirt-domain>"
19779 msgstr ""
19780
19781 #. type: textblock
19782 #: ../fish/guestfish.pod:198 ../fuse/guestmount.pod:102
19783 msgid ""
19784 "Add disks from the named libvirt domain.  If the I<--ro> option is also "
19785 "used, then any libvirt domain can be used.  However in write mode, only "
19786 "libvirt domains which are shut down can be named here."
19787 msgstr ""
19788
19789 #. type: textblock
19790 #: ../fish/guestfish.pod:202
19791 msgid ""
19792 "Using this flag is mostly equivalent to using the C<add-domain> command, "
19793 "with C<readonly:true> if the I<--ro> flag was given, and with C<format:...> "
19794 "if the I<--format:...> flag was given."
19795 msgstr ""
19796
19797 #. type: =item
19798 #: ../fish/guestfish.pod:206
19799 msgid "B<-D>"
19800 msgstr ""
19801
19802 #. type: =item
19803 #: ../fish/guestfish.pod:208
19804 msgid "B<--no-dest-paths>"
19805 msgstr ""
19806
19807 #. type: textblock
19808 #: ../fish/guestfish.pod:210
19809 msgid ""
19810 "Don't tab-complete paths on the guest filesystem.  It is useful to be able "
19811 "to hit the tab key to complete paths on the guest filesystem, but this "
19812 "causes extra \"hidden\" guestfs calls to be made, so this option is here to "
19813 "allow this feature to be disabled."
19814 msgstr ""
19815
19816 #. type: =item
19817 #: ../fish/guestfish.pod:215 ../fuse/guestmount.pod:118
19818 msgid "B<--echo-keys>"
19819 msgstr ""
19820
19821 #. type: textblock
19822 #: ../fish/guestfish.pod:217 ../fuse/guestmount.pod:120
19823 msgid ""
19824 "When prompting for keys and passphrases, guestfish normally turns echoing "
19825 "off so you cannot see what you are typing.  If you are not worried about "
19826 "Tempest attacks and there is no one else in the room you can specify this "
19827 "flag to see what you are typing."
19828 msgstr ""
19829
19830 #. type: =item
19831 #: ../fish/guestfish.pod:222
19832 msgid "B<-f file>"
19833 msgstr ""
19834
19835 #. type: =item
19836 #: ../fish/guestfish.pod:224
19837 msgid "B<--file file>"
19838 msgstr ""
19839
19840 #. type: textblock
19841 #: ../fish/guestfish.pod:226
19842 msgid "Read commands from C<file>.  To write pure guestfish scripts, use:"
19843 msgstr ""
19844
19845 #. type: verbatim
19846 #: ../fish/guestfish.pod:229
19847 #, no-wrap
19848 msgid ""
19849 " #!/usr/bin/guestfish -f\n"
19850 "\n"
19851 msgstr ""
19852
19853 #. type: =item
19854 #: ../fish/guestfish.pod:231
19855 msgid "B<--format=raw|qcow2|..>"
19856 msgstr ""
19857
19858 #. type: =item
19859 #: ../fish/guestfish.pod:233
19860 msgid "B<--format>"
19861 msgstr ""
19862
19863 #. type: textblock
19864 #: ../fish/guestfish.pod:235 ../fuse/guestmount.pod:127
19865 msgid ""
19866 "The default for the I<-a> option is to auto-detect the format of the disk "
19867 "image.  Using this forces the disk format for I<-a> options which follow on "
19868 "the command line.  Using I<--format> with no argument switches back to auto-"
19869 "detection for subsequent I<-a> options."
19870 msgstr ""
19871
19872 #. type: verbatim
19873 #: ../fish/guestfish.pod:242
19874 #, no-wrap
19875 msgid ""
19876 " guestfish --format=raw -a disk.img\n"
19877 "\n"
19878 msgstr ""
19879
19880 #. type: textblock
19881 #: ../fish/guestfish.pod:244
19882 msgid "forces raw format (no auto-detection) for C<disk.img>."
19883 msgstr ""
19884
19885 #. type: verbatim
19886 #: ../fish/guestfish.pod:246
19887 #, no-wrap
19888 msgid ""
19889 " guestfish --format=raw -a disk.img --format -a another.img\n"
19890 "\n"
19891 msgstr ""
19892
19893 #. type: textblock
19894 #: ../fish/guestfish.pod:248
19895 msgid ""
19896 "forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
19897 "detection for C<another.img>."
19898 msgstr ""
19899
19900 #. type: textblock
19901 #: ../fish/guestfish.pod:251
19902 msgid ""
19903 "If you have untrusted raw-format guest disk images, you should use this "
19904 "option to specify the disk format.  This avoids a possible security problem "
19905 "with malicious guests (CVE-2010-3851).  See also L</add-drive-opts>."
19906 msgstr ""
19907
19908 #. type: =item
19909 #: ../fish/guestfish.pod:256
19910 msgid "B<-i>"
19911 msgstr ""
19912
19913 #. type: =item
19914 #: ../fish/guestfish.pod:258
19915 msgid "B<--inspector>"
19916 msgstr ""
19917
19918 #. type: textblock
19919 #: ../fish/guestfish.pod:260 ../fuse/guestmount.pod:147
19920 msgid ""
19921 "Using L<virt-inspector(1)> code, inspect the disks looking for an operating "
19922 "system and mount filesystems as they would be mounted on the real virtual "
19923 "machine."
19924 msgstr ""
19925
19926 #. type: textblock
19927 #: ../fish/guestfish.pod:264
19928 msgid "Typical usage is either:"
19929 msgstr ""
19930
19931 #. type: verbatim
19932 #: ../fish/guestfish.pod:266
19933 #, no-wrap
19934 msgid ""
19935 " guestfish -d myguest -i\n"
19936 "\n"
19937 msgstr ""
19938
19939 #. type: textblock
19940 #: ../fish/guestfish.pod:268
19941 msgid "(for an inactive libvirt domain called I<myguest>), or:"
19942 msgstr ""
19943
19944 #. type: verbatim
19945 #: ../fish/guestfish.pod:270
19946 #, no-wrap
19947 msgid ""
19948 " guestfish --ro -d myguest -i\n"
19949 "\n"
19950 msgstr ""
19951
19952 #. type: textblock
19953 #: ../fish/guestfish.pod:272
19954 msgid "(for active domains, readonly), or specify the block device directly:"
19955 msgstr ""
19956
19957 #. type: verbatim
19958 #: ../fish/guestfish.pod:274
19959 #, no-wrap
19960 msgid ""
19961 " guestfish --rw -a /dev/Guests/MyGuest -i\n"
19962 "\n"
19963 msgstr ""
19964
19965 #. type: textblock
19966 #: ../fish/guestfish.pod:276
19967 msgid ""
19968 "Note that the command line syntax changed slightly over older versions of "
19969 "guestfish.  You can still use the old syntax:"
19970 msgstr ""
19971
19972 #. type: verbatim
19973 #: ../fish/guestfish.pod:279
19974 #, no-wrap
19975 msgid ""
19976 " guestfish [--ro] -i disk.img\n"
19977 "\n"
19978 msgstr ""
19979
19980 #. type: verbatim
19981 #: ../fish/guestfish.pod:281
19982 #, no-wrap
19983 msgid ""
19984 " guestfish [--ro] -i libvirt-domain\n"
19985 "\n"
19986 msgstr ""
19987
19988 #. type: textblock
19989 #: ../fish/guestfish.pod:283
19990 msgid ""
19991 "Using this flag is mostly equivalent to using the C<inspect-os> command and "
19992 "then using other commands to mount the filesystems that were found."
19993 msgstr ""
19994
19995 #. type: =item
19996 #: ../fish/guestfish.pod:287 ../fuse/guestmount.pod:151
19997 msgid "B<--keys-from-stdin>"
19998 msgstr ""
19999
20000 #. type: textblock
20001 #: ../fish/guestfish.pod:289 ../fuse/guestmount.pod:153
20002 msgid ""
20003 "Read key or passphrase parameters from stdin.  The default is to try to read "
20004 "passphrases from the user by opening C</dev/tty>."
20005 msgstr ""
20006
20007 #. type: =item
20008 #: ../fish/guestfish.pod:292
20009 msgid "B<--listen>"
20010 msgstr ""
20011
20012 #. type: textblock
20013 #: ../fish/guestfish.pod:294
20014 msgid ""
20015 "Fork into the background and listen for remote commands.  See section L</"
20016 "REMOTE CONTROL GUESTFISH OVER A SOCKET> below."
20017 msgstr ""
20018
20019 #. type: =item
20020 #: ../fish/guestfish.pod:297 ../fuse/guestmount.pod:156
20021 msgid "B<--live>"
20022 msgstr ""
20023
20024 #. type: textblock
20025 #: ../fish/guestfish.pod:299 ../fuse/guestmount.pod:158
20026 msgid ""
20027 "Connect to a live virtual machine.  (Experimental, see L<guestfs(3)/"
20028 "ATTACHING TO RUNNING DAEMONS>)."
20029 msgstr ""
20030
20031 #. type: =item
20032 #: ../fish/guestfish.pod:302 ../fuse/guestmount.pod:161
20033 msgid "B<-m dev[:mountpoint[:options]]>"
20034 msgstr ""
20035
20036 #. type: =item
20037 #: ../fish/guestfish.pod:304 ../fuse/guestmount.pod:163
20038 msgid "B<--mount dev[:mountpoint[:options]]>"
20039 msgstr ""
20040
20041 #. type: textblock
20042 #: ../fish/guestfish.pod:306
20043 msgid "Mount the named partition or logical volume on the given mountpoint."
20044 msgstr ""
20045
20046 #. type: textblock
20047 #: ../fish/guestfish.pod:308
20048 msgid "If the mountpoint is omitted, it defaults to C</>."
20049 msgstr ""
20050
20051 #. type: textblock
20052 #: ../fish/guestfish.pod:310
20053 msgid "You have to mount something on C</> before most commands will work."
20054 msgstr ""
20055
20056 #. type: textblock
20057 #: ../fish/guestfish.pod:312
20058 msgid ""
20059 "If any I<-m> or I<--mount> options are given, the guest is automatically "
20060 "launched."
20061 msgstr ""
20062
20063 #. type: textblock
20064 #: ../fish/guestfish.pod:315
20065 msgid ""
20066 "If you don't know what filesystems a disk image contains, you can either run "
20067 "guestfish without this option, then list the partitions, filesystems and LVs "
20068 "available (see L</list-partitions>, L</list-filesystems> and L</lvs> "
20069 "commands), or you can use the L<virt-filesystems(1)> program."
20070 msgstr ""
20071
20072 #. type: textblock
20073 #: ../fish/guestfish.pod:321 ../fuse/guestmount.pod:171
20074 msgid ""
20075 "The third (and rarely used) part of the mount parameter is the list of mount "
20076 "options used to mount the underlying filesystem.  If this is not given, then "
20077 "the mount options are either the empty string or C<ro> (the latter if the "
20078 "I<--ro> flag is used).  By specifying the mount options, you override this "
20079 "default choice.  Probably the only time you would use this is to enable ACLs "
20080 "and/or extended attributes if the filesystem can support them:"
20081 msgstr ""
20082
20083 #. type: verbatim
20084 #: ../fish/guestfish.pod:329 ../fuse/guestmount.pod:179
20085 #, no-wrap
20086 msgid ""
20087 " -m /dev/sda1:/:acl,user_xattr\n"
20088 "\n"
20089 msgstr ""
20090
20091 #. type: textblock
20092 #: ../fish/guestfish.pod:331
20093 msgid "Using this flag is equivalent to using the C<mount-options> command."
20094 msgstr ""
20095
20096 #. type: =item
20097 #: ../fish/guestfish.pod:333
20098 msgid "B<-n>"
20099 msgstr ""
20100
20101 #. type: =item
20102 #: ../fish/guestfish.pod:335
20103 msgid "B<--no-sync>"
20104 msgstr ""
20105
20106 #. type: textblock
20107 #: ../fish/guestfish.pod:337
20108 msgid ""
20109 "Disable autosync.  This is enabled by default.  See the discussion of "
20110 "autosync in the L<guestfs(3)> manpage."
20111 msgstr ""
20112
20113 #. type: =item
20114 #: ../fish/guestfish.pod:340
20115 msgid "B<-N type>"
20116 msgstr ""
20117
20118 #. type: =item
20119 #: ../fish/guestfish.pod:342
20120 msgid "B<--new type>"
20121 msgstr ""
20122
20123 #. type: =item
20124 #: ../fish/guestfish.pod:344
20125 msgid "B<-N help>"
20126 msgstr ""
20127
20128 #. type: textblock
20129 #: ../fish/guestfish.pod:346
20130 msgid ""
20131 "Prepare a fresh disk image formatted as \"type\".  This is an alternative to "
20132 "the I<-a> option: whereas I<-a> adds an existing disk, I<-N> creates a "
20133 "preformatted disk with a filesystem and adds it.  See L</PREPARED DISK "
20134 "IMAGES> below."
20135 msgstr ""
20136
20137 #. type: =item
20138 #: ../fish/guestfish.pod:351
20139 msgid "B<--progress-bars>"
20140 msgstr ""
20141
20142 #. type: textblock
20143 #: ../fish/guestfish.pod:353
20144 msgid "Enable progress bars, even when guestfish is used non-interactively."
20145 msgstr ""
20146
20147 #. type: textblock
20148 #: ../fish/guestfish.pod:355
20149 msgid ""
20150 "Progress bars are enabled by default when guestfish is used as an "
20151 "interactive shell."
20152 msgstr ""
20153
20154 #. type: =item
20155 #: ../fish/guestfish.pod:358
20156 msgid "B<--no-progress-bars>"
20157 msgstr ""
20158
20159 #. type: textblock
20160 #: ../fish/guestfish.pod:360
20161 msgid "Disable progress bars."
20162 msgstr ""
20163
20164 #. type: =item
20165 #: ../fish/guestfish.pod:362
20166 msgid "B<--remote[=pid]>"
20167 msgstr ""
20168
20169 #. type: textblock
20170 #: ../fish/guestfish.pod:364
20171 msgid ""
20172 "Send remote commands to C<$GUESTFISH_PID> or C<pid>.  See section L</REMOTE "
20173 "CONTROL GUESTFISH OVER A SOCKET> below."
20174 msgstr ""
20175
20176 #. type: =item
20177 #: ../fish/guestfish.pod:367
20178 msgid "B<-r>"
20179 msgstr ""
20180
20181 #. type: =item
20182 #: ../fish/guestfish.pod:369
20183 msgid "B<--ro>"
20184 msgstr ""
20185
20186 #. type: textblock
20187 #: ../fish/guestfish.pod:371
20188 msgid ""
20189 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
20190 "mounts are done read-only."
20191 msgstr ""
20192
20193 #. type: textblock
20194 #: ../fish/guestfish.pod:374
20195 msgid ""
20196 "The option must always be used if the disk image or virtual machine might be "
20197 "running, and is generally recommended in cases where you don't need write "
20198 "access to the disk."
20199 msgstr ""
20200
20201 #. type: textblock
20202 #: ../fish/guestfish.pod:378
20203 msgid ""
20204 "Note that prepared disk images created with I<-N> are not affected by this "
20205 "option.  Also commands like C<add> are not affected - you have to specify "
20206 "the C<readonly:true> option explicitly if you need it."
20207 msgstr ""
20208
20209 #. type: textblock
20210 #: ../fish/guestfish.pod:382
20211 msgid "See also L</OPENING DISKS FOR READ AND WRITE> below."
20212 msgstr ""
20213
20214 #. type: =item
20215 #: ../fish/guestfish.pod:384 ../fuse/guestmount.pod:235
20216 msgid "B<--selinux>"
20217 msgstr ""
20218
20219 #. type: textblock
20220 #: ../fish/guestfish.pod:386
20221 msgid "Enable SELinux support for the guest.  See L<guestfs(3)/SELINUX>."
20222 msgstr ""
20223
20224 #. type: =item
20225 #: ../fish/guestfish.pod:388
20226 msgid "B<-v>"
20227 msgstr ""
20228
20229 #. type: =item
20230 #: ../fish/guestfish.pod:390
20231 msgid "B<--verbose>"
20232 msgstr ""
20233
20234 #. type: textblock
20235 #: ../fish/guestfish.pod:392
20236 msgid ""
20237 "Enable very verbose messages.  This is particularly useful if you find a bug."
20238 msgstr ""
20239
20240 #. type: =item
20241 #: ../fish/guestfish.pod:395
20242 msgid "B<-V>"
20243 msgstr ""
20244
20245 #. type: =item
20246 #: ../fish/guestfish.pod:397 ../tools/virt-edit.pl:97
20247 #: ../tools/virt-win-reg.pl:112 ../tools/virt-list-filesystems.pl:69
20248 #: ../tools/virt-tar.pl:119 ../tools/virt-make-fs.pl:169
20249 #: ../tools/virt-list-partitions.pl:70
20250 msgid "B<--version>"
20251 msgstr ""
20252
20253 #. type: textblock
20254 #: ../fish/guestfish.pod:399
20255 msgid "Display the guestfish / libguestfs version number and exit."
20256 msgstr ""
20257
20258 #. type: =item
20259 #: ../fish/guestfish.pod:401
20260 msgid "B<-w>"
20261 msgstr ""
20262
20263 #. type: =item
20264 #: ../fish/guestfish.pod:403
20265 msgid "B<--rw>"
20266 msgstr ""
20267
20268 #. type: textblock
20269 #: ../fish/guestfish.pod:405 ../fuse/guestmount.pod:249
20270 msgid ""
20271 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
20272 "mounts are done read-write."
20273 msgstr ""
20274
20275 #. type: textblock
20276 #: ../fish/guestfish.pod:408
20277 msgid "See L</OPENING DISKS FOR READ AND WRITE> below."
20278 msgstr ""
20279
20280 #. type: =item
20281 #: ../fish/guestfish.pod:410
20282 msgid "B<-x>"
20283 msgstr ""
20284
20285 #. type: textblock
20286 #: ../fish/guestfish.pod:412
20287 msgid "Echo each command before executing it."
20288 msgstr ""
20289
20290 #. type: =head1
20291 #: ../fish/guestfish.pod:416
20292 msgid "COMMANDS ON COMMAND LINE"
20293 msgstr ""
20294
20295 #. type: textblock
20296 #: ../fish/guestfish.pod:418
20297 msgid ""
20298 "Any additional (non-option) arguments are treated as commands to execute."
20299 msgstr ""
20300
20301 #. type: textblock
20302 #: ../fish/guestfish.pod:421
20303 msgid ""
20304 "Commands to execute should be separated by a colon (C<:>), where the colon "
20305 "is a separate parameter.  Thus:"
20306 msgstr ""
20307
20308 #. type: verbatim
20309 #: ../fish/guestfish.pod:424
20310 #, no-wrap
20311 msgid ""
20312 " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n"
20313 "\n"
20314 msgstr ""
20315
20316 #. type: textblock
20317 #: ../fish/guestfish.pod:426
20318 msgid ""
20319 "If there are no additional arguments, then we enter a shell, either an "
20320 "interactive shell with a prompt (if the input is a terminal) or a non-"
20321 "interactive shell."
20322 msgstr ""
20323
20324 #. type: textblock
20325 #: ../fish/guestfish.pod:430
20326 msgid ""
20327 "In either command line mode or non-interactive shell, the first command that "
20328 "gives an error causes the whole shell to exit.  In interactive mode (with a "
20329 "prompt) if a command fails, you can continue to enter commands."
20330 msgstr ""
20331
20332 #. type: =head1
20333 #: ../fish/guestfish.pod:435
20334 msgid "USING launch (OR run)"
20335 msgstr ""
20336
20337 #. type: textblock
20338 #: ../fish/guestfish.pod:437
20339 msgid ""
20340 "As with L<guestfs(3)>, you must first configure your guest by adding disks, "
20341 "then launch it, then mount any disks you need, and finally issue actions/"
20342 "commands.  So the general order of the day is:"
20343 msgstr ""
20344
20345 #. type: textblock
20346 #: ../fish/guestfish.pod:445
20347 msgid "add or -a/--add"
20348 msgstr ""
20349
20350 #. type: textblock
20351 #: ../fish/guestfish.pod:449
20352 msgid "launch (aka run)"
20353 msgstr ""
20354
20355 #. type: textblock
20356 #: ../fish/guestfish.pod:453
20357 msgid "mount or -m/--mount"
20358 msgstr ""
20359
20360 #. type: textblock
20361 #: ../fish/guestfish.pod:457
20362 msgid "any other commands"
20363 msgstr ""
20364
20365 #. type: textblock
20366 #: ../fish/guestfish.pod:461
20367 msgid ""
20368 "C<run> is a synonym for C<launch>.  You must C<launch> (or C<run>)  your "
20369 "guest before mounting or performing any other commands."
20370 msgstr ""
20371
20372 #. type: textblock
20373 #: ../fish/guestfish.pod:464
20374 msgid ""
20375 "The only exception is that if any of the I<-i>, I<-m>, I<--mount>, I<-N> or "
20376 "I<--new> options were given then C<run> is done automatically, simply "
20377 "because guestfish can't perform the action you asked for without doing this."
20378 msgstr ""
20379
20380 #. type: =head1
20381 #: ../fish/guestfish.pod:469
20382 msgid "OPENING DISKS FOR READ AND WRITE"
20383 msgstr ""
20384
20385 #. type: textblock
20386 #: ../fish/guestfish.pod:471
20387 msgid ""
20388 "The guestfish, L<guestmount(1)> and L<virt-rescue(1)> options I<--ro> and "
20389 "I<--rw> affect whether the other command line options I<-a>, I<-c>, I<-d>, "
20390 "I<-i> and I<-m> open disk images read-only or for writing."
20391 msgstr ""
20392
20393 #. type: textblock
20394 #: ../fish/guestfish.pod:476
20395 msgid ""
20396 "In libguestfs E<le> 1.10, guestfish, guestmount and virt-rescue defaulted to "
20397 "opening disk images supplied on the command line for write.  To open a disk "
20398 "image read-only you have to do I<-a image --ro>."
20399 msgstr ""
20400
20401 #. type: textblock
20402 #: ../fish/guestfish.pod:480
20403 msgid ""
20404 "This matters: If you accidentally open a live VM disk image writable then "
20405 "you will cause irreversible disk corruption."
20406 msgstr ""
20407
20408 #. type: textblock
20409 #: ../fish/guestfish.pod:483
20410 msgid ""
20411 "By libguestfs 1.12 we intend to change the default the other way.  Disk "
20412 "images will be opened read-only.  You will have to either specify "
20413 "I<guestfish --rw>, I<guestmount --rw>, I<virt-rescue --rw>, or change the "
20414 "configuration file C</etc/libguestfs-tools.conf> in order to get write "
20415 "access for disk images specified by those other command line options."
20416 msgstr ""
20417
20418 #. type: textblock
20419 #: ../fish/guestfish.pod:490
20420 msgid ""
20421 "This version of guestfish, guestmount and virt-rescue has a I<--rw> option "
20422 "which does nothing (it is already the default).  However it is highly "
20423 "recommended that you use this option to indicate that you need write access, "
20424 "and prepare your scripts for the day when this option will be required for "
20425 "write access."
20426 msgstr ""
20427
20428 #. type: textblock
20429 #: ../fish/guestfish.pod:496
20430 msgid ""
20431 "B<Note:> This does I<not> affect commands like L</add> and L</mount>, or any "
20432 "other libguestfs program apart from guestfish and guestmount."
20433 msgstr ""
20434
20435 #. type: =head1
20436 #: ../fish/guestfish.pod:499
20437 msgid "QUOTING"
20438 msgstr ""
20439
20440 #. type: textblock
20441 #: ../fish/guestfish.pod:501
20442 msgid ""
20443 "You can quote ordinary parameters using either single or double quotes.  For "
20444 "example:"
20445 msgstr ""
20446
20447 #. type: verbatim
20448 #: ../fish/guestfish.pod:504
20449 #, no-wrap
20450 msgid ""
20451 " add \"file with a space.img\"\n"
20452 "\n"
20453 msgstr ""
20454
20455 #. type: verbatim
20456 #: ../fish/guestfish.pod:506
20457 #, no-wrap
20458 msgid ""
20459 " rm '/file name'\n"
20460 "\n"
20461 msgstr ""
20462
20463 #. type: verbatim
20464 #: ../fish/guestfish.pod:508
20465 #, no-wrap
20466 msgid ""
20467 " rm '/\"'\n"
20468 "\n"
20469 msgstr ""
20470
20471 #. type: textblock
20472 #: ../fish/guestfish.pod:510
20473 msgid ""
20474 "A few commands require a list of strings to be passed.  For these, use a "
20475 "whitespace-separated list, enclosed in quotes.  Strings containing "
20476 "whitespace to be passed through must be enclosed in single quotes.  A "
20477 "literal single quote must be escaped with a backslash."
20478 msgstr ""
20479
20480 #. type: verbatim
20481 #: ../fish/guestfish.pod:515
20482 #, no-wrap
20483 msgid ""
20484 " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n"
20485 " command \"/bin/echo 'foo      bar'\"\n"
20486 " command \"/bin/echo \\'foo\\'\"\n"
20487 "\n"
20488 msgstr ""
20489
20490 #. type: =head1
20491 #: ../fish/guestfish.pod:519
20492 msgid "OPTIONAL ARGUMENTS"
20493 msgstr ""
20494
20495 #. type: textblock
20496 #: ../fish/guestfish.pod:521
20497 msgid ""
20498 "Some commands take optional arguments.  These arguments appear in this "
20499 "documentation as C<[argname:..]>.  You can use them as in these examples:"
20500 msgstr ""
20501
20502 #. type: verbatim
20503 #: ../fish/guestfish.pod:525
20504 #, no-wrap
20505 msgid ""
20506 " add-drive-opts filename\n"
20507 "\n"
20508 msgstr ""
20509
20510 #. type: verbatim
20511 #: ../fish/guestfish.pod:527
20512 #, no-wrap
20513 msgid ""
20514 " add-drive-opts filename readonly:true\n"
20515 "\n"
20516 msgstr ""
20517
20518 #. type: verbatim
20519 #: ../fish/guestfish.pod:529
20520 #, no-wrap
20521 msgid ""
20522 " add-drive-opts filename format:qcow2 readonly:false\n"
20523 "\n"
20524 msgstr ""
20525
20526 #. type: textblock
20527 #: ../fish/guestfish.pod:531
20528 msgid ""
20529 "Each optional argument can appear at most once.  All optional arguments must "
20530 "appear after the required ones."
20531 msgstr ""
20532
20533 #. type: =head1
20534 #: ../fish/guestfish.pod:534
20535 msgid "NUMBERS"
20536 msgstr ""
20537
20538 #. type: textblock
20539 #: ../fish/guestfish.pod:536
20540 msgid ""
20541 "This section applies to all commands which can take integers as parameters."
20542 msgstr ""
20543
20544 #. type: =head2
20545 #: ../fish/guestfish.pod:539
20546 msgid "SIZE SUFFIX"
20547 msgstr ""
20548
20549 #. type: textblock
20550 #: ../fish/guestfish.pod:541
20551 msgid ""
20552 "When the command takes a parameter measured in bytes, you can use one of the "
20553 "following suffixes to specify kilobytes, megabytes and larger sizes:"
20554 msgstr ""
20555
20556 #. type: =item
20557 #: ../fish/guestfish.pod:547
20558 msgid "B<k> or B<K> or B<KiB>"
20559 msgstr ""
20560
20561 #. type: textblock
20562 #: ../fish/guestfish.pod:549
20563 msgid "The size in kilobytes (multiplied by 1024)."
20564 msgstr ""
20565
20566 #. type: =item
20567 #: ../fish/guestfish.pod:551
20568 msgid "B<KB>"
20569 msgstr ""
20570
20571 #. type: textblock
20572 #: ../fish/guestfish.pod:553
20573 msgid "The size in SI 1000 byte units."
20574 msgstr ""
20575
20576 #. type: =item
20577 #: ../fish/guestfish.pod:555
20578 msgid "B<M> or B<MiB>"
20579 msgstr ""
20580
20581 #. type: textblock
20582 #: ../fish/guestfish.pod:557
20583 msgid "The size in megabytes (multiplied by 1048576)."
20584 msgstr ""
20585
20586 #. type: =item
20587 #: ../fish/guestfish.pod:559
20588 msgid "B<MB>"
20589 msgstr ""
20590
20591 #. type: textblock
20592 #: ../fish/guestfish.pod:561
20593 msgid "The size in SI 1000000 byte units."
20594 msgstr ""
20595
20596 #. type: =item
20597 #: ../fish/guestfish.pod:563
20598 msgid "B<G> or B<GiB>"
20599 msgstr ""
20600
20601 #. type: textblock
20602 #: ../fish/guestfish.pod:565
20603 msgid "The size in gigabytes (multiplied by 2**30)."
20604 msgstr ""
20605
20606 #. type: =item
20607 #: ../fish/guestfish.pod:567
20608 msgid "B<GB>"
20609 msgstr ""
20610
20611 #. type: textblock
20612 #: ../fish/guestfish.pod:569
20613 msgid "The size in SI 10**9 byte units."
20614 msgstr ""
20615
20616 #. type: =item
20617 #: ../fish/guestfish.pod:571
20618 msgid "B<T> or B<TiB>"
20619 msgstr ""
20620
20621 #. type: textblock
20622 #: ../fish/guestfish.pod:573
20623 msgid "The size in terabytes (multiplied by 2**40)."
20624 msgstr ""
20625
20626 #. type: =item
20627 #: ../fish/guestfish.pod:575
20628 msgid "B<TB>"
20629 msgstr ""
20630
20631 #. type: textblock
20632 #: ../fish/guestfish.pod:577
20633 msgid "The size in SI 10**12 byte units."
20634 msgstr ""
20635
20636 #. type: =item
20637 #: ../fish/guestfish.pod:579
20638 msgid "B<P> or B<PiB>"
20639 msgstr ""
20640
20641 #. type: textblock
20642 #: ../fish/guestfish.pod:581
20643 msgid "The size in petabytes (multiplied by 2**50)."
20644 msgstr ""
20645
20646 #. type: =item
20647 #: ../fish/guestfish.pod:583
20648 msgid "B<PB>"
20649 msgstr ""
20650
20651 #. type: textblock
20652 #: ../fish/guestfish.pod:585
20653 msgid "The size in SI 10**15 byte units."
20654 msgstr ""
20655
20656 #. type: =item
20657 #: ../fish/guestfish.pod:587
20658 msgid "B<E> or B<EiB>"
20659 msgstr ""
20660
20661 #. type: textblock
20662 #: ../fish/guestfish.pod:589
20663 msgid "The size in exabytes (multiplied by 2**60)."
20664 msgstr ""
20665
20666 #. type: =item
20667 #: ../fish/guestfish.pod:591
20668 msgid "B<EB>"
20669 msgstr ""
20670
20671 #. type: textblock
20672 #: ../fish/guestfish.pod:593
20673 msgid "The size in SI 10**18 byte units."
20674 msgstr ""
20675
20676 #. type: =item
20677 #: ../fish/guestfish.pod:595
20678 msgid "B<Z> or B<ZiB>"
20679 msgstr ""
20680
20681 #. type: textblock
20682 #: ../fish/guestfish.pod:597
20683 msgid "The size in zettabytes (multiplied by 2**70)."
20684 msgstr ""
20685
20686 #. type: =item
20687 #: ../fish/guestfish.pod:599
20688 msgid "B<ZB>"
20689 msgstr ""
20690
20691 #. type: textblock
20692 #: ../fish/guestfish.pod:601
20693 msgid "The size in SI 10**21 byte units."
20694 msgstr ""
20695
20696 #. type: =item
20697 #: ../fish/guestfish.pod:603
20698 msgid "B<Y> or B<YiB>"
20699 msgstr ""
20700
20701 #. type: textblock
20702 #: ../fish/guestfish.pod:605
20703 msgid "The size in yottabytes (multiplied by 2**80)."
20704 msgstr ""
20705
20706 #. type: =item
20707 #: ../fish/guestfish.pod:607
20708 msgid "B<YB>"
20709 msgstr ""
20710
20711 #. type: textblock
20712 #: ../fish/guestfish.pod:609
20713 msgid "The size in SI 10**24 byte units."
20714 msgstr ""
20715
20716 #. type: verbatim
20717 #: ../fish/guestfish.pod:615
20718 #, no-wrap
20719 msgid ""
20720 " truncate-size /file 1G\n"
20721 "\n"
20722 msgstr ""
20723
20724 #. type: textblock
20725 #: ../fish/guestfish.pod:617
20726 msgid "would truncate the file to 1 gigabyte."
20727 msgstr ""
20728
20729 #. type: textblock
20730 #: ../fish/guestfish.pod:619
20731 msgid ""
20732 "Be careful because a few commands take sizes in kilobytes or megabytes (eg. "
20733 "the parameter to L</memsize> is specified in megabytes already).  Adding a "
20734 "suffix will probably not do what you expect."
20735 msgstr ""
20736
20737 #. type: =head2
20738 #: ../fish/guestfish.pod:623
20739 msgid "OCTAL AND HEXADECIMAL NUMBERS"
20740 msgstr ""
20741
20742 #. type: textblock
20743 #: ../fish/guestfish.pod:625
20744 msgid ""
20745 "For specifying the radix (base) use the C convention: C<0> to prefix an "
20746 "octal number or C<0x> to prefix a hexadecimal number.  For example:"
20747 msgstr ""
20748
20749 #. type: verbatim
20750 #: ../fish/guestfish.pod:628
20751 #, no-wrap
20752 msgid ""
20753 " 1234      decimal number 1234\n"
20754 " 02322     octal number, equivalent to decimal 1234\n"
20755 " 0x4d2     hexadecimal number, equivalent to decimal 1234\n"
20756 "\n"
20757 msgstr ""
20758
20759 #. type: textblock
20760 #: ../fish/guestfish.pod:632
20761 msgid ""
20762 "When using the C<chmod> command, you almost always want to specify an octal "
20763 "number for the mode, and you must prefix it with C<0> (unlike the Unix "
20764 "L<chmod(1)> program):"
20765 msgstr ""
20766
20767 #. type: verbatim
20768 #: ../fish/guestfish.pod:636
20769 #, no-wrap
20770 msgid ""
20771 " chmod 0777 /public  # OK\n"
20772 " chmod 777 /public   # WRONG! This is mode 777 decimal = 01411 octal.\n"
20773 "\n"
20774 msgstr ""
20775
20776 #. type: textblock
20777 #: ../fish/guestfish.pod:639
20778 msgid ""
20779 "Commands that return numbers usually print them in decimal, but some "
20780 "commands print numbers in other radices (eg. C<umask> prints the mode in "
20781 "octal, preceeded by C<0>)."
20782 msgstr ""
20783
20784 #. type: =head1
20785 #: ../fish/guestfish.pod:643
20786 msgid "WILDCARDS AND GLOBBING"
20787 msgstr ""
20788
20789 #. type: textblock
20790 #: ../fish/guestfish.pod:645
20791 msgid ""
20792 "Neither guestfish nor the underlying guestfs API performs wildcard expansion "
20793 "(globbing) by default.  So for example the following will not do what you "
20794 "expect:"
20795 msgstr ""
20796
20797 #. type: verbatim
20798 #: ../fish/guestfish.pod:649
20799 #, no-wrap
20800 msgid ""
20801 " rm-rf /home/*\n"
20802 "\n"
20803 msgstr ""
20804
20805 #. type: textblock
20806 #: ../fish/guestfish.pod:651
20807 msgid ""
20808 "Assuming you don't have a directory called literally C</home/*> then the "
20809 "above command will return an error."
20810 msgstr ""
20811
20812 #. type: textblock
20813 #: ../fish/guestfish.pod:654
20814 msgid "To perform wildcard expansion, use the C<glob> command."
20815 msgstr ""
20816
20817 #. type: verbatim
20818 #: ../fish/guestfish.pod:656
20819 #, no-wrap
20820 msgid ""
20821 " glob rm-rf /home/*\n"
20822 "\n"
20823 msgstr ""
20824
20825 #. type: textblock
20826 #: ../fish/guestfish.pod:658
20827 msgid ""
20828 "runs C<rm-rf> on each path that matches (ie. potentially running the command "
20829 "many times), equivalent to:"
20830 msgstr ""
20831
20832 #. type: verbatim
20833 #: ../fish/guestfish.pod:661
20834 #, no-wrap
20835 msgid ""
20836 " rm-rf /home/jim\n"
20837 " rm-rf /home/joe\n"
20838 " rm-rf /home/mary\n"
20839 "\n"
20840 msgstr ""
20841
20842 #. type: textblock
20843 #: ../fish/guestfish.pod:665
20844 msgid "C<glob> only works on simple guest paths and not on device names."
20845 msgstr ""
20846
20847 #. type: textblock
20848 #: ../fish/guestfish.pod:667
20849 msgid ""
20850 "If you have several parameters, each containing a wildcard, then glob will "
20851 "perform a Cartesian product."
20852 msgstr ""
20853
20854 #. type: =head1
20855 #: ../fish/guestfish.pod:670
20856 msgid "COMMENTS"
20857 msgstr ""
20858
20859 #. type: textblock
20860 #: ../fish/guestfish.pod:672
20861 msgid ""
20862 "Any line which starts with a I<#> character is treated as a comment and "
20863 "ignored.  The I<#> can optionally be preceeded by whitespace, but B<not> by "
20864 "a command.  For example:"
20865 msgstr ""
20866
20867 #. type: verbatim
20868 #: ../fish/guestfish.pod:676
20869 #, no-wrap
20870 msgid ""
20871 " # this is a comment\n"
20872 "         # this is a comment\n"
20873 " foo # NOT a comment\n"
20874 "\n"
20875 msgstr ""
20876
20877 #. type: textblock
20878 #: ../fish/guestfish.pod:680
20879 msgid "Blank lines are also ignored."
20880 msgstr ""
20881
20882 #. type: =head1
20883 #: ../fish/guestfish.pod:682
20884 msgid "RUNNING COMMANDS LOCALLY"
20885 msgstr ""
20886
20887 #. type: textblock
20888 #: ../fish/guestfish.pod:684
20889 msgid ""
20890 "Any line which starts with a I<!> character is treated as a command sent to "
20891 "the local shell (C</bin/sh> or whatever L<system(3)> uses).  For example:"
20892 msgstr ""
20893
20894 #. type: verbatim
20895 #: ../fish/guestfish.pod:688
20896 #, no-wrap
20897 msgid ""
20898 " !mkdir local\n"
20899 " tgz-out /remote local/remote-data.tar.gz\n"
20900 "\n"
20901 msgstr ""
20902
20903 #. type: textblock
20904 #: ../fish/guestfish.pod:691
20905 msgid ""
20906 "will create a directory C<local> on the host, and then export the contents "
20907 "of C</remote> on the mounted filesystem to C<local/remote-data.tar.gz>.  "
20908 "(See C<tgz-out>)."
20909 msgstr ""
20910
20911 #. type: textblock
20912 #: ../fish/guestfish.pod:695
20913 msgid ""
20914 "To change the local directory, use the C<lcd> command.  C<!cd> will have no "
20915 "effect, due to the way that subprocesses work in Unix."
20916 msgstr ""
20917
20918 #. type: =head2
20919 #: ../fish/guestfish.pod:698
20920 msgid "LOCAL COMMANDS WITH INLINE EXECUTION"
20921 msgstr ""
20922
20923 #. type: textblock
20924 #: ../fish/guestfish.pod:700
20925 msgid ""
20926 "If a line starts with I<E<lt>!> then the shell command is executed (as for "
20927 "I<!>), but subsequently any output (stdout) of the shell command is parsed "
20928 "and executed as guestfish commands."
20929 msgstr ""
20930
20931 #. type: textblock
20932 #: ../fish/guestfish.pod:704
20933 msgid ""
20934 "Thus you can use shell script to construct arbitrary guestfish commands "
20935 "which are then parsed by guestfish."
20936 msgstr ""
20937
20938 #. type: textblock
20939 #: ../fish/guestfish.pod:707
20940 msgid ""
20941 "For example it is tedious to create a sequence of files (eg. C</foo.1> "
20942 "through C</foo.100>) using guestfish commands alone.  However this is simple "
20943 "if we use a shell script to create the guestfish commands for us:"
20944 msgstr ""
20945
20946 #. type: verbatim
20947 #: ../fish/guestfish.pod:712
20948 #, no-wrap
20949 msgid ""
20950 " <! for n in `seq 1 100`; do echo write /foo.$n $n; done\n"
20951 "\n"
20952 msgstr ""
20953
20954 #. type: textblock
20955 #: ../fish/guestfish.pod:714
20956 msgid "or with names like C</foo.001>:"
20957 msgstr ""
20958
20959 #. type: verbatim
20960 #: ../fish/guestfish.pod:716
20961 #, no-wrap
20962 msgid ""
20963 " <! for n in `seq 1 100`; do printf \"write /foo.%03d %d\\n\" $n $n; done\n"
20964 "\n"
20965 msgstr ""
20966
20967 #. type: textblock
20968 #: ../fish/guestfish.pod:718
20969 msgid ""
20970 "When using guestfish interactively it can be helpful to just run the shell "
20971 "script first (ie. remove the initial C<E<lt>> character so it is just an "
20972 "ordinary I<!> local command), see what guestfish commands it would run, and "
20973 "when you are happy with those prepend the C<E<lt>> character to run the "
20974 "guestfish commands for real."
20975 msgstr ""
20976
20977 #. type: =head1
20978 #: ../fish/guestfish.pod:724
20979 msgid "PIPES"
20980 msgstr ""
20981
20982 #. type: textblock
20983 #: ../fish/guestfish.pod:726
20984 msgid ""
20985 "Use C<command E<lt>spaceE<gt> | command> to pipe the output of the first "
20986 "command (a guestfish command) to the second command (any host command).  For "
20987 "example:"
20988 msgstr ""
20989
20990 #. type: verbatim
20991 #: ../fish/guestfish.pod:730
20992 #, no-wrap
20993 msgid ""
20994 " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n"
20995 "\n"
20996 msgstr ""
20997
20998 #. type: textblock
20999 #: ../fish/guestfish.pod:732
21000 msgid ""
21001 "(where C<cat> is the guestfish cat command, but C<awk> is the host awk "
21002 "program).  The above command would list all accounts in the guest filesystem "
21003 "which have UID 0, ie. root accounts including backdoors.  Other examples:"
21004 msgstr ""
21005
21006 #. type: verbatim
21007 #: ../fish/guestfish.pod:737
21008 #, no-wrap
21009 msgid ""
21010 " hexdump /bin/ls | head\n"
21011 " list-devices | tail -1\n"
21012 " tgz-out / - | tar ztf -\n"
21013 "\n"
21014 msgstr ""
21015
21016 #. type: textblock
21017 #: ../fish/guestfish.pod:741
21018 msgid ""
21019 "The space before the pipe symbol is required, any space after the pipe "
21020 "symbol is optional.  Everything after the pipe symbol is just passed "
21021 "straight to the host shell, so it can contain redirections, globs and "
21022 "anything else that makes sense on the host side."
21023 msgstr ""
21024
21025 #. type: textblock
21026 #: ../fish/guestfish.pod:746
21027 msgid ""
21028 "To use a literal argument which begins with a pipe symbol, you have to quote "
21029 "it, eg:"
21030 msgstr ""
21031
21032 #. type: verbatim
21033 #: ../fish/guestfish.pod:749
21034 #, no-wrap
21035 msgid ""
21036 " echo \"|\"\n"
21037 "\n"
21038 msgstr ""
21039
21040 #. type: =head1
21041 #: ../fish/guestfish.pod:751
21042 msgid "HOME DIRECTORIES"
21043 msgstr ""
21044
21045 #. type: textblock
21046 #: ../fish/guestfish.pod:753
21047 msgid ""
21048 "If a parameter starts with the character C<~> then the tilde may be expanded "
21049 "as a home directory path (either C<~> for the current user's home directory, "
21050 "or C<~user> for another user)."
21051 msgstr ""
21052
21053 #. type: textblock
21054 #: ../fish/guestfish.pod:757
21055 msgid ""
21056 "Note that home directory expansion happens for users known I<on the host>, "
21057 "not in the guest filesystem."
21058 msgstr ""
21059
21060 #. type: textblock
21061 #: ../fish/guestfish.pod:760
21062 msgid ""
21063 "To use a literal argument which begins with a tilde, you have to quote it, "
21064 "eg:"
21065 msgstr ""
21066
21067 #. type: verbatim
21068 #: ../fish/guestfish.pod:763
21069 #, no-wrap
21070 msgid ""
21071 " echo \"~\"\n"
21072 "\n"
21073 msgstr ""
21074
21075 #. type: textblock
21076 #: ../fish/guestfish.pod:767
21077 msgid ""
21078 "Libguestfs has some support for Linux guests encrypted according to the "
21079 "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole "
21080 "disk encryption systems used by modern Linux guests.  Currently only LVM-on-"
21081 "LUKS is supported."
21082 msgstr ""
21083
21084 #. type: textblock
21085 #: ../fish/guestfish.pod:772
21086 msgid "Identify encrypted block devices and partitions using L</vfs-type>:"
21087 msgstr ""
21088
21089 #. type: verbatim
21090 #: ../fish/guestfish.pod:774
21091 #, no-wrap
21092 msgid ""
21093 " ><fs> vfs-type /dev/sda2\n"
21094 " crypto_LUKS\n"
21095 "\n"
21096 msgstr ""
21097
21098 #. type: textblock
21099 #: ../fish/guestfish.pod:777
21100 msgid ""
21101 "Then open those devices using L</luks-open>.  This creates a device-mapper "
21102 "device called C</dev/mapper/luksdev>."
21103 msgstr ""
21104
21105 #. type: verbatim
21106 #: ../fish/guestfish.pod:780
21107 #, no-wrap
21108 msgid ""
21109 " ><fs> luks-open /dev/sda2 luksdev\n"
21110 " Enter key or passphrase (\"key\"): <enter the passphrase>\n"
21111 "\n"
21112 msgstr ""
21113
21114 #. type: textblock
21115 #: ../fish/guestfish.pod:783
21116 msgid ""
21117 "Finally you have to tell LVM to scan for volume groups on the newly created "
21118 "mapper device:"
21119 msgstr ""
21120
21121 #. type: verbatim
21122 #: ../fish/guestfish.pod:786
21123 #, no-wrap
21124 msgid ""
21125 " vgscan\n"
21126 " vg-activate-all true\n"
21127 "\n"
21128 msgstr ""
21129
21130 #. type: textblock
21131 #: ../fish/guestfish.pod:789
21132 msgid "The logical volume(s) can now be mounted in the usual way."
21133 msgstr ""
21134
21135 #. type: textblock
21136 #: ../fish/guestfish.pod:791
21137 msgid ""
21138 "Before closing a LUKS device you must unmount any logical volumes on it and "
21139 "deactivate the volume groups by calling C<vg-activate false VG> on each "
21140 "one.  Then you can close the mapper device:"
21141 msgstr ""
21142
21143 #. type: verbatim
21144 #: ../fish/guestfish.pod:795
21145 #, no-wrap
21146 msgid ""
21147 " vg-activate false /dev/VG\n"
21148 " luks-close /dev/mapper/luksdev\n"
21149 "\n"
21150 msgstr ""
21151
21152 #. type: =head1
21153 #: ../fish/guestfish.pod:798 ../tools/virt-edit.pl:342
21154 msgid "WINDOWS PATHS"
21155 msgstr ""
21156
21157 #. type: textblock
21158 #: ../fish/guestfish.pod:800
21159 msgid ""
21160 "If a path is prefixed with C<win:> then you can use Windows-style drive "
21161 "letters and paths (with some limitations).  The following commands are "
21162 "equivalent:"
21163 msgstr ""
21164
21165 #. type: verbatim
21166 #: ../fish/guestfish.pod:804
21167 #, no-wrap
21168 msgid ""
21169 " file /WINDOWS/system32/config/system.LOG\n"
21170 "\n"
21171 msgstr ""
21172
21173 #. type: verbatim
21174 #: ../fish/guestfish.pod:806
21175 #, no-wrap
21176 msgid ""
21177 " file win:\\windows\\system32\\config\\system.log\n"
21178 "\n"
21179 msgstr ""
21180
21181 #. type: verbatim
21182 #: ../fish/guestfish.pod:808
21183 #, no-wrap
21184 msgid ""
21185 " file WIN:C:\\Windows\\SYSTEM32\\CONFIG\\SYSTEM.LOG\n"
21186 "\n"
21187 msgstr ""
21188
21189 #. type: textblock
21190 #: ../fish/guestfish.pod:810
21191 msgid ""
21192 "The parameter is rewritten \"behind the scenes\" by looking up the position "
21193 "where the drive is mounted, prepending that to the path, changing all "
21194 "backslash characters to forward slash, then resolving the result using L</"
21195 "case-sensitive-path>.  For example if the E: drive was mounted on C</e> then "
21196 "the parameter might be rewritten like this:"
21197 msgstr ""
21198
21199 #. type: verbatim
21200 #: ../fish/guestfish.pod:816
21201 #, no-wrap
21202 msgid ""
21203 " win:e:\\foo\\bar => /e/FOO/bar\n"
21204 "\n"
21205 msgstr ""
21206
21207 #. type: textblock
21208 #: ../fish/guestfish.pod:818
21209 msgid "This only works in argument positions that expect a path."
21210 msgstr ""
21211
21212 #. type: =head1
21213 #: ../fish/guestfish.pod:820
21214 msgid "UPLOADING AND DOWNLOADING FILES"
21215 msgstr ""
21216
21217 #. type: textblock
21218 #: ../fish/guestfish.pod:822
21219 msgid ""
21220 "For commands such as C<upload>, C<download>, C<tar-in>, C<tar-out> and "
21221 "others which upload from or download to a local file, you can use the "
21222 "special filename C<-> to mean \"from stdin\" or \"to stdout\".  For example:"
21223 msgstr ""
21224
21225 #. type: verbatim
21226 #: ../fish/guestfish.pod:826
21227 #, no-wrap
21228 msgid ""
21229 " upload - /foo\n"
21230 "\n"
21231 msgstr ""
21232
21233 #. type: textblock
21234 #: ../fish/guestfish.pod:828
21235 msgid ""
21236 "reads stdin and creates from that a file C</foo> in the disk image, and:"
21237 msgstr ""
21238
21239 #. type: verbatim
21240 #: ../fish/guestfish.pod:831
21241 #, no-wrap
21242 msgid ""
21243 " tar-out /etc - | tar tf -\n"
21244 "\n"
21245 msgstr ""
21246
21247 #. type: textblock
21248 #: ../fish/guestfish.pod:833
21249 msgid ""
21250 "writes the tarball to stdout and then pipes that into the external \"tar\" "
21251 "command (see L</PIPES>)."
21252 msgstr ""
21253
21254 #. type: textblock
21255 #: ../fish/guestfish.pod:836
21256 msgid ""
21257 "When using C<-> to read from stdin, the input is read up to the end of "
21258 "stdin.  You can also use a special \"heredoc\"-like syntax to read up to "
21259 "some arbitrary end marker:"
21260 msgstr ""
21261
21262 #. type: verbatim
21263 #: ../fish/guestfish.pod:840
21264 #, no-wrap
21265 msgid ""
21266 " upload -<<END /foo\n"
21267 " input line 1\n"
21268 " input line 2\n"
21269 " input line 3\n"
21270 " END\n"
21271 "\n"
21272 msgstr ""
21273
21274 #. type: textblock
21275 #: ../fish/guestfish.pod:846
21276 msgid ""
21277 "Any string of characters can be used instead of C<END>.  The end marker must "
21278 "appear on a line of its own, without any preceeding or following characters "
21279 "(not even spaces)."
21280 msgstr ""
21281
21282 #. type: textblock
21283 #: ../fish/guestfish.pod:850
21284 msgid ""
21285 "Note that the C<-E<lt>E<lt>> syntax only applies to parameters used to "
21286 "upload local files (so-called \"FileIn\" parameters in the generator)."
21287 msgstr ""
21288
21289 #. type: =head1
21290 #: ../fish/guestfish.pod:853
21291 msgid "EXIT ON ERROR BEHAVIOUR"
21292 msgstr ""
21293
21294 #. type: textblock
21295 #: ../fish/guestfish.pod:855
21296 msgid ""
21297 "By default, guestfish will ignore any errors when in interactive mode (ie. "
21298 "taking commands from a human over a tty), and will exit on the first error "
21299 "in non-interactive mode (scripts, commands given on the command line)."
21300 msgstr ""
21301
21302 #. type: textblock
21303 #: ../fish/guestfish.pod:860
21304 msgid ""
21305 "If you prefix a command with a I<-> character, then that command will not "
21306 "cause guestfish to exit, even if that (one) command returns an error."
21307 msgstr ""
21308
21309 #. type: =head1
21310 #: ../fish/guestfish.pod:864
21311 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET"
21312 msgstr ""
21313
21314 #. type: textblock
21315 #: ../fish/guestfish.pod:866
21316 msgid ""
21317 "Guestfish can be remote-controlled over a socket.  This is useful "
21318 "particularly in shell scripts where you want to make several different "
21319 "changes to a filesystem, but you don't want the overhead of starting up a "
21320 "guestfish process each time."
21321 msgstr ""
21322
21323 #. type: textblock
21324 #: ../fish/guestfish.pod:871
21325 msgid "Start a guestfish server process using:"
21326 msgstr ""
21327
21328 #. type: verbatim
21329 #: ../fish/guestfish.pod:873
21330 #, no-wrap
21331 msgid ""
21332 " eval \"`guestfish --listen`\"\n"
21333 "\n"
21334 msgstr ""
21335
21336 #. type: textblock
21337 #: ../fish/guestfish.pod:875
21338 msgid "and then send it commands by doing:"
21339 msgstr ""
21340
21341 #. type: verbatim
21342 #: ../fish/guestfish.pod:877
21343 #, no-wrap
21344 msgid ""
21345 " guestfish --remote cmd [...]\n"
21346 "\n"
21347 msgstr ""
21348
21349 #. type: textblock
21350 #: ../fish/guestfish.pod:879
21351 msgid "To cause the server to exit, send it the exit command:"
21352 msgstr ""
21353
21354 #. type: verbatim
21355 #: ../fish/guestfish.pod:881
21356 #, no-wrap
21357 msgid ""
21358 " guestfish --remote exit\n"
21359 "\n"
21360 msgstr ""
21361
21362 #. type: textblock
21363 #: ../fish/guestfish.pod:883
21364 msgid ""
21365 "Note that the server will normally exit if there is an error in a command.  "
21366 "You can change this in the usual way.  See section L</EXIT ON ERROR "
21367 "BEHAVIOUR>."
21368 msgstr ""
21369
21370 #. type: =head2
21371 #: ../fish/guestfish.pod:887
21372 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES"
21373 msgstr ""
21374
21375 #. type: textblock
21376 #: ../fish/guestfish.pod:889
21377 msgid ""
21378 "The C<eval> statement sets the environment variable C<$GUESTFISH_PID>, which "
21379 "is how the I<--remote> option knows where to send the commands.  You can "
21380 "have several guestfish listener processes running using:"
21381 msgstr ""
21382
21383 #. type: verbatim
21384 #: ../fish/guestfish.pod:893
21385 #, no-wrap
21386 msgid ""
21387 " eval \"`guestfish --listen`\"\n"
21388 " pid1=$GUESTFISH_PID\n"
21389 " eval \"`guestfish --listen`\"\n"
21390 " pid2=$GUESTFISH_PID\n"
21391 " ...\n"
21392 " guestfish --remote=$pid1 cmd\n"
21393 " guestfish --remote=$pid2 cmd\n"
21394 "\n"
21395 msgstr ""
21396
21397 #. type: =head2
21398 #: ../fish/guestfish.pod:901
21399 msgid "REMOTE CONTROL AND CSH"
21400 msgstr ""
21401
21402 #. type: textblock
21403 #: ../fish/guestfish.pod:903
21404 msgid ""
21405 "When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> "
21406 "option:"
21407 msgstr ""
21408
21409 #. type: verbatim
21410 #: ../fish/guestfish.pod:906
21411 #, no-wrap
21412 msgid ""
21413 " eval \"`guestfish --listen --csh`\"\n"
21414 "\n"
21415 msgstr ""
21416
21417 #. type: =head2
21418 #: ../fish/guestfish.pod:908
21419 msgid "REMOTE CONTROL DETAILS"
21420 msgstr ""
21421
21422 #. type: textblock
21423 #: ../fish/guestfish.pod:910
21424 msgid ""
21425 "Remote control happens over a Unix domain socket called C</tmp/.guestfish-"
21426 "$UID/socket-$PID>, where C<$UID> is the effective user ID of the process, "
21427 "and C<$PID> is the process ID of the server."
21428 msgstr ""
21429
21430 #. type: textblock
21431 #: ../fish/guestfish.pod:914
21432 msgid "Guestfish client and server versions must match exactly."
21433 msgstr ""
21434
21435 #. type: =head2
21436 #: ../fish/guestfish.pod:916
21437 msgid "REMOTE CONTROL RUN COMMAND HANGING"
21438 msgstr ""
21439
21440 #. type: textblock
21441 #: ../fish/guestfish.pod:918
21442 msgid ""
21443 "Using the C<run> (or C<launch>) command remotely in a command substitution "
21444 "context hangs, ie. don't do (note the backquotes):"
21445 msgstr ""
21446
21447 #. type: verbatim
21448 #: ../fish/guestfish.pod:921
21449 #, no-wrap
21450 msgid ""
21451 " a=`guestfish --remote run`\n"
21452 "\n"
21453 msgstr ""
21454
21455 #. type: textblock
21456 #: ../fish/guestfish.pod:923
21457 msgid ""
21458 "Since the C<run> command produces no output on stdout, this is not useful "
21459 "anyway.  For further information see L<https://bugzilla.redhat.com/show_bug."
21460 "cgi?id=592910>."
21461 msgstr ""
21462
21463 #. type: =head1
21464 #: ../fish/guestfish.pod:927
21465 msgid "PREPARED DISK IMAGES"
21466 msgstr ""
21467
21468 #. type: textblock
21469 #: ../fish/guestfish.pod:929
21470 msgid ""
21471 "Use the I<-N type> or I<--new type> parameter to select one of a set of "
21472 "preformatted disk images that guestfish can make for you to save typing.  "
21473 "This is particularly useful for testing purposes.  This option is used "
21474 "instead of the I<-a> option, and like I<-a> can appear multiple times (and "
21475 "can be mixed with I<-a>)."
21476 msgstr ""
21477
21478 #. type: textblock
21479 #: ../fish/guestfish.pod:935
21480 msgid ""
21481 "The new disk is called C<test1.img> for the first I<-N>, C<test2.img> for "
21482 "the second and so on.  Existing files in the current directory are "
21483 "I<overwritten>."
21484 msgstr ""
21485
21486 #. type: textblock
21487 #: ../fish/guestfish.pod:939
21488 msgid ""
21489 "The type briefly describes how the disk should be sized, partitioned, how "
21490 "filesystem(s) should be created, and how content should be added.  "
21491 "Optionally the type can be followed by extra parameters, separated by C<:> "
21492 "(colon) characters.  For example, I<-N fs> creates a default 100MB, sparsely-"
21493 "allocated disk, containing a single partition, with the partition formatted "
21494 "as ext2.  I<-N fs:ext4:1G> is the same, but for an ext4 filesystem on a 1GB "
21495 "disk instead."
21496 msgstr ""
21497
21498 #. type: textblock
21499 #: ../fish/guestfish.pod:947
21500 msgid "To list the available types and any extra parameters they take, run:"
21501 msgstr ""
21502
21503 #. type: textblock
21504 #: ../fish/guestfish.pod:951
21505 msgid ""
21506 "Note that the prepared filesystem is not mounted.  You would usually have to "
21507 "use the C<mount /dev/sda1 /> command or add the I<-m /dev/sda1> option."
21508 msgstr ""
21509
21510 #. type: textblock
21511 #: ../fish/guestfish.pod:955
21512 msgid ""
21513 "If any I<-N> or I<--new> options are given, the guest is automatically "
21514 "launched."
21515 msgstr ""
21516
21517 #. type: textblock
21518 #: ../fish/guestfish.pod:960
21519 msgid "Create a 100MB disk with an ext4-formatted partition:"
21520 msgstr ""
21521
21522 #. type: verbatim
21523 #: ../fish/guestfish.pod:962
21524 #, no-wrap
21525 msgid ""
21526 " guestfish -N fs:ext4\n"
21527 "\n"
21528 msgstr ""
21529
21530 #. type: textblock
21531 #: ../fish/guestfish.pod:964
21532 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:"
21533 msgstr ""
21534
21535 #. type: verbatim
21536 #: ../fish/guestfish.pod:966
21537 #, no-wrap
21538 msgid ""
21539 " guestfish -N fs:vfat:32M -m /dev/sda1\n"
21540 "\n"
21541 msgstr ""
21542
21543 #. type: textblock
21544 #: ../fish/guestfish.pod:968
21545 msgid "Create a blank 200MB disk:"
21546 msgstr ""
21547
21548 #. type: verbatim
21549 #: ../fish/guestfish.pod:970
21550 #, no-wrap
21551 msgid ""
21552 " guestfish -N disk:200M\n"
21553 "\n"
21554 msgstr ""
21555
21556 #. type: =head1
21557 #: ../fish/guestfish.pod:972
21558 msgid "PROGRESS BARS"
21559 msgstr ""
21560
21561 #. type: textblock
21562 #: ../fish/guestfish.pod:974
21563 msgid ""
21564 "Some (not all) long-running commands send progress notification messages as "
21565 "they are running.  Guestfish turns these messages into progress bars."
21566 msgstr ""
21567
21568 #. type: textblock
21569 #: ../fish/guestfish.pod:978
21570 msgid ""
21571 "When a command that supports progress bars takes longer than two seconds to "
21572 "run, and if progress bars are enabled, then you will see one appearing below "
21573 "the command:"
21574 msgstr ""
21575
21576 #. type: verbatim
21577 #: ../fish/guestfish.pod:982
21578 #, no-wrap
21579 msgid ""
21580 " ><fs> copy-size /large-file /another-file 2048M\n"
21581 " / 10% [#####-----------------------------------------] 00:30\n"
21582 "\n"
21583 msgstr ""
21584
21585 #. type: textblock
21586 #: ../fish/guestfish.pod:985
21587 msgid ""
21588 "The spinner on the left hand side moves round once for every progress "
21589 "notification received from the backend.  This is a (reasonably) golden "
21590 "assurance that the command is \"doing something\" even if the progress bar "
21591 "is not moving, because the command is able to send the progress "
21592 "notifications.  When the bar reaches 100% and the command finishes, the "
21593 "spinner disappears."
21594 msgstr ""
21595
21596 #. type: textblock
21597 #: ../fish/guestfish.pod:992
21598 msgid ""
21599 "Progress bars are enabled by default when guestfish is used interactively.  "
21600 "You can enable them even for non-interactive modes using I<--progress-bars>, "
21601 "and you can disable them completely using I<--no-progress-bars>."
21602 msgstr ""
21603
21604 #. type: =head1
21605 #: ../fish/guestfish.pod:997
21606 msgid "GUESTFISH COMMANDS"
21607 msgstr ""
21608
21609 #. type: textblock
21610 #: ../fish/guestfish.pod:999
21611 msgid ""
21612 "The commands in this section are guestfish convenience commands, in other "
21613 "words, they are not part of the L<guestfs(3)> API."
21614 msgstr ""
21615
21616 #. type: =head2
21617 #: ../fish/guestfish.pod:1002
21618 msgid "help"
21619 msgstr ""
21620
21621 #. type: verbatim
21622 #: ../fish/guestfish.pod:1004
21623 #, no-wrap
21624 msgid ""
21625 " help\n"
21626 " help cmd\n"
21627 "\n"
21628 msgstr ""
21629
21630 #. type: textblock
21631 #: ../fish/guestfish.pod:1007
21632 msgid "Without any parameter, this provides general help."
21633 msgstr ""
21634
21635 #. type: textblock
21636 #: ../fish/guestfish.pod:1009
21637 msgid "With a C<cmd> parameter, this displays detailed help for that command."
21638 msgstr ""
21639
21640 #. type: =head2
21641 #: ../fish/guestfish.pod:1011
21642 msgid "quit | exit"
21643 msgstr ""
21644
21645 #. type: textblock
21646 #: ../fish/guestfish.pod:1013
21647 msgid "This exits guestfish.  You can also use C<^D> key."
21648 msgstr ""
21649
21650 #. type: textblock
21651 #: ../fish/guestfish.pod:1015
21652 msgid "@FISH_COMMANDS@"
21653 msgstr ""
21654
21655 #. type: =head1
21656 #: ../fish/guestfish.pod:1017
21657 msgid "COMMANDS"
21658 msgstr ""
21659
21660 #. type: =head1
21661 #: ../fish/guestfish.pod:1021 ../test-tool/libguestfs-test-tool.pod:77
21662 msgid "EXIT CODE"
21663 msgstr ""
21664
21665 #. type: textblock
21666 #: ../fish/guestfish.pod:1023
21667 msgid ""
21668 "guestfish returns 0 if the commands completed without error, or 1 if there "
21669 "was an error."
21670 msgstr ""
21671
21672 #. type: =item
21673 #: ../fish/guestfish.pod:1030
21674 msgid "EDITOR"
21675 msgstr ""
21676
21677 #. type: textblock
21678 #: ../fish/guestfish.pod:1032
21679 msgid ""
21680 "The C<edit> command uses C<$EDITOR> as the editor.  If not set, it uses "
21681 "C<vi>."
21682 msgstr ""
21683
21684 #. type: =item
21685 #: ../fish/guestfish.pod:1035
21686 msgid "GUESTFISH_PID"
21687 msgstr ""
21688
21689 #. type: textblock
21690 #: ../fish/guestfish.pod:1037
21691 msgid ""
21692 "Used with the I<--remote> option to specify the remote guestfish process to "
21693 "control.  See section L</REMOTE CONTROL GUESTFISH OVER A SOCKET>."
21694 msgstr ""
21695
21696 #. type: =item
21697 #: ../fish/guestfish.pod:1041
21698 msgid "HEXEDITOR"
21699 msgstr ""
21700
21701 #. type: textblock
21702 #: ../fish/guestfish.pod:1043
21703 msgid ""
21704 "The L</hexedit> command uses C<$HEXEDITOR> as the external hex editor.  If "
21705 "not specified, the external L<hexedit(1)> program is used."
21706 msgstr ""
21707
21708 #. type: =item
21709 #: ../fish/guestfish.pod:1047
21710 msgid "HOME"
21711 msgstr ""
21712
21713 #. type: textblock
21714 #: ../fish/guestfish.pod:1049
21715 msgid ""
21716 "If compiled with GNU readline support, various files in the home directory "
21717 "can be used.  See L</FILES>."
21718 msgstr ""
21719
21720 #. type: textblock
21721 #: ../fish/guestfish.pod:1058
21722 msgid ""
21723 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
21724 "effect as using the B<-v> option."
21725 msgstr ""
21726
21727 #. type: textblock
21728 #: ../fish/guestfish.pod:1070
21729 msgid ""
21730 "Set the path that guestfish uses to search for kernel and initrd.img.  See "
21731 "the discussion of paths in L<guestfs(3)>."
21732 msgstr ""
21733
21734 #. type: textblock
21735 #: ../fish/guestfish.pod:1081
21736 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces."
21737 msgstr ""
21738
21739 #. type: =item
21740 #: ../fish/guestfish.pod:1083
21741 msgid "PAGER"
21742 msgstr ""
21743
21744 #. type: textblock
21745 #: ../fish/guestfish.pod:1085
21746 msgid ""
21747 "The C<more> command uses C<$PAGER> as the pager.  If not set, it uses "
21748 "C<more>."
21749 msgstr ""
21750
21751 #. type: =head1
21752 #: ../fish/guestfish.pod:1101 ../fuse/guestmount.pod:262
21753 msgid "FILES"
21754 msgstr ""
21755
21756 #. type: =item
21757 #: ../fish/guestfish.pod:1105 ../fuse/guestmount.pod:266
21758 msgid "$HOME/.libguestfs-tools.rc"
21759 msgstr ""
21760
21761 #. type: =item
21762 #: ../fish/guestfish.pod:1107 ../fuse/guestmount.pod:268
21763 msgid "/etc/libguestfs-tools.conf"
21764 msgstr ""
21765
21766 #. type: textblock
21767 #: ../fish/guestfish.pod:1109 ../fuse/guestmount.pod:270
21768 msgid ""
21769 "This configuration file controls the default read-only or read-write mode "
21770 "(I<--ro> or I<--rw>)."
21771 msgstr ""
21772
21773 #. type: textblock
21774 #: ../fish/guestfish.pod:1112
21775 msgid "See L</OPENING DISKS FOR READ AND WRITE>."
21776 msgstr ""
21777
21778 #. type: =item
21779 #: ../fish/guestfish.pod:1114
21780 msgid "$HOME/.guestfish"
21781 msgstr ""
21782
21783 #. type: textblock
21784 #: ../fish/guestfish.pod:1116
21785 msgid ""
21786 "If compiled with GNU readline support, then the command history is saved in "
21787 "this file."
21788 msgstr ""
21789
21790 #. type: =item
21791 #: ../fish/guestfish.pod:1119
21792 msgid "$HOME/.inputrc"
21793 msgstr ""
21794
21795 #. type: =item
21796 #: ../fish/guestfish.pod:1121
21797 msgid "/etc/inputrc"
21798 msgstr ""
21799
21800 #. type: textblock
21801 #: ../fish/guestfish.pod:1123
21802 msgid ""
21803 "If compiled with GNU readline support, then these files can be used to "
21804 "configure readline.  For further information, please see L<readline(3)/"
21805 "INITIALIZATION FILE>."
21806 msgstr ""
21807
21808 #. type: textblock
21809 #: ../fish/guestfish.pod:1127
21810 msgid "To write rules which only apply to guestfish, use:"
21811 msgstr ""
21812
21813 #. type: verbatim
21814 #: ../fish/guestfish.pod:1129
21815 #, no-wrap
21816 msgid ""
21817 " $if guestfish\n"
21818 " ...\n"
21819 " $endif\n"
21820 "\n"
21821 msgstr ""
21822
21823 #. type: textblock
21824 #: ../fish/guestfish.pod:1133
21825 msgid ""
21826 "Variables that you can set in inputrc that change the behaviour of guestfish "
21827 "in useful ways include:"
21828 msgstr ""
21829
21830 #. type: =item
21831 #: ../fish/guestfish.pod:1138
21832 msgid "completion-ignore-case (default: on)"
21833 msgstr ""
21834
21835 #. type: textblock
21836 #: ../fish/guestfish.pod:1140
21837 msgid ""
21838 "By default, guestfish will ignore case when tab-completing paths on the "
21839 "disk.  Use:"
21840 msgstr ""
21841
21842 #. type: verbatim
21843 #: ../fish/guestfish.pod:1143
21844 #, no-wrap
21845 msgid ""
21846 " set completion-ignore-case off\n"
21847 "\n"
21848 msgstr ""
21849
21850 #. type: textblock
21851 #: ../fish/guestfish.pod:1145
21852 msgid "to make guestfish case sensitive."
21853 msgstr ""
21854
21855 #. type: =item
21856 #: ../fish/guestfish.pod:1149
21857 msgid "test1.img"
21858 msgstr ""
21859
21860 #. type: =item
21861 #: ../fish/guestfish.pod:1151
21862 msgid "test2.img (etc)"
21863 msgstr ""
21864
21865 #. type: textblock
21866 #: ../fish/guestfish.pod:1153
21867 msgid ""
21868 "When using the I<-N> or I<--new> option, the prepared disk or filesystem "
21869 "will be created in the file C<test1.img> in the current directory.  The "
21870 "second use of I<-N> will use C<test2.img> and so on.  Any existing file with "
21871 "the same name will be overwritten."
21872 msgstr ""
21873
21874 #. type: textblock
21875 #: ../fish/guestfish.pod:1162
21876 msgid ""
21877 "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-cat(1)>, L<virt-copy-in(1)"
21878 ">, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, L<virt-filesystems(1)"
21879 ">, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, L<virt-list-partitions"
21880 "(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-rescue(1)>, L<virt-resize(1)"
21881 ">, L<virt-tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)"
21882 ">, L<hexedit(1)>."
21883 msgstr ""
21884
21885 #. type: textblock
21886 #: ../fish/guestfish.pod:1192 ../test-tool/libguestfs-test-tool.pod:102
21887 #: ../fuse/guestmount.pod:297 ../tools/virt-edit.pl:518
21888 #: ../tools/virt-win-reg.pl:606 ../tools/virt-list-filesystems.pl:210
21889 #: ../tools/virt-tar.pl:309 ../tools/virt-make-fs.pl:572
21890 #: ../tools/virt-list-partitions.pl:277
21891 msgid ""
21892 "This program is free software; you can redistribute it and/or modify it "
21893 "under the terms of the GNU General Public License as published by the Free "
21894 "Software Foundation; either version 2 of the License, or (at your option) "
21895 "any later version."
21896 msgstr ""
21897
21898 #. type: textblock
21899 #: ../fish/guestfish.pod:1197 ../test-tool/libguestfs-test-tool.pod:107
21900 #: ../fuse/guestmount.pod:302 ../tools/virt-edit.pl:523
21901 #: ../tools/virt-win-reg.pl:611 ../tools/virt-list-filesystems.pl:215
21902 #: ../tools/virt-tar.pl:314 ../tools/virt-make-fs.pl:577
21903 #: ../tools/virt-list-partitions.pl:282
21904 msgid ""
21905 "This program is distributed in the hope that it will be useful, but WITHOUT "
21906 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
21907 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for "
21908 "more details."
21909 msgstr ""
21910
21911 #. type: textblock
21912 #: ../fish/guestfish.pod:1202 ../test-tool/libguestfs-test-tool.pod:112
21913 #: ../fuse/guestmount.pod:307 ../tools/virt-edit.pl:528
21914 #: ../tools/virt-win-reg.pl:616 ../tools/virt-list-filesystems.pl:220
21915 #: ../tools/virt-tar.pl:319 ../tools/virt-make-fs.pl:582
21916 #: ../tools/virt-list-partitions.pl:287
21917 msgid ""
21918 "You should have received a copy of the GNU General Public License along with "
21919 "this program; if not, write to the Free Software Foundation, Inc., 675 Mass "
21920 "Ave, Cambridge, MA 02139, USA."
21921 msgstr ""
21922
21923 #. type: =head2
21924 #: ../fish/guestfish-actions.pod:1
21925 msgid "add-cdrom"
21926 msgstr ""
21927
21928 #. type: verbatim
21929 #: ../fish/guestfish-actions.pod:3
21930 #, no-wrap
21931 msgid ""
21932 " add-cdrom filename\n"
21933 "\n"
21934 msgstr ""
21935
21936 #. type: textblock
21937 #: ../fish/guestfish-actions.pod:15
21938 msgid ""
21939 "This call checks for the existence of C<filename>.  This stops you from "
21940 "specifying other types of drive which are supported by qemu such as C<nbd:> "
21941 "and C<http:> URLs.  To specify those, use the general L</config> call "
21942 "instead."
21943 msgstr ""
21944
21945 #. type: textblock
21946 #: ../fish/guestfish-actions.pod:22
21947 msgid ""
21948 "If you just want to add an ISO file (often you use this as an efficient way "
21949 "to transfer large files into the guest), then you should probably use L</add-"
21950 "drive-ro> instead."
21951 msgstr ""
21952
21953 #. type: textblock
21954 #: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:158
21955 #: ../fish/guestfish-actions.pod:172
21956 msgid ""
21957 "This function is deprecated.  In new code, use the L</add_drive_opts> call "
21958 "instead."
21959 msgstr ""
21960
21961 #. type: =head2
21962 #: ../fish/guestfish-actions.pod:35
21963 msgid "add-domain"
21964 msgstr ""
21965
21966 #. type: =head2
21967 #: ../fish/guestfish-actions.pod:37
21968 msgid "domain"
21969 msgstr ""
21970
21971 #. type: verbatim
21972 #: ../fish/guestfish-actions.pod:39
21973 #, no-wrap
21974 msgid ""
21975 " add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..]\n"
21976 "\n"
21977 msgstr ""
21978
21979 #. type: textblock
21980 #: ../fish/guestfish-actions.pod:41
21981 msgid ""
21982 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
21983 "It works by connecting to libvirt, requesting the domain and domain XML from "
21984 "libvirt, parsing it for disks, and calling L</add-drive-opts> on each one."
21985 msgstr ""
21986
21987 #. type: textblock
21988 #: ../fish/guestfish-actions.pod:71
21989 msgid ""
21990 "The other optional parameters are passed directly through to L</add-drive-"
21991 "opts>."
21992 msgstr ""
21993
21994 #. type: textblock
21995 #: ../fish/guestfish-actions.pod:74 ../fish/guestfish-actions.pod:138
21996 #: ../fish/guestfish-actions.pod:3049
21997 msgid ""
21998 "This command has one or more optional arguments.  See L</OPTIONAL ARGUMENTS>."
21999 msgstr ""
22000
22001 #. type: =head2
22002 #: ../fish/guestfish-actions.pod:76
22003 msgid "add-drive"
22004 msgstr ""
22005
22006 #. type: verbatim
22007 #: ../fish/guestfish-actions.pod:78
22008 #, no-wrap
22009 msgid ""
22010 " add-drive filename\n"
22011 "\n"
22012 msgstr ""
22013
22014 #. type: textblock
22015 #: ../fish/guestfish-actions.pod:80
22016 msgid ""
22017 "This function is the equivalent of calling L</add-drive-opts> with no "
22018 "optional parameters, so the disk is added writable, with the format being "
22019 "detected automatically."
22020 msgstr ""
22021
22022 #. type: textblock
22023 #: ../fish/guestfish-actions.pod:84
22024 msgid ""
22025 "Automatic detection of the format opens you up to a potential security hole "
22026 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
22027 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
22028 "you should think about replacing calls to this function with calls to L</add-"
22029 "drive-opts>, and specifying the format."
22030 msgstr ""
22031
22032 #. type: =head2
22033 #: ../fish/guestfish-actions.pod:91
22034 msgid "add-drive-opts"
22035 msgstr ""
22036
22037 #. type: =head2
22038 #: ../fish/guestfish-actions.pod:93
22039 msgid "add"
22040 msgstr ""
22041
22042 #. type: verbatim
22043 #: ../fish/guestfish-actions.pod:95
22044 #, no-wrap
22045 msgid ""
22046 " add-drive-opts filename [readonly:..] [format:..] [iface:..]\n"
22047 "\n"
22048 msgstr ""
22049
22050 #. type: textblock
22051 #: ../fish/guestfish-actions.pod:122
22052 msgid ""
22053 "This forces the image format.  If you omit this (or use L</add-drive> or L</"
22054 "add-drive-ro>) then the format is automatically detected.  Possible formats "
22055 "include C<raw> and C<qcow2>."
22056 msgstr ""
22057
22058 #. type: textblock
22059 #: ../fish/guestfish-actions.pod:133
22060 msgid ""
22061 "This rarely-used option lets you emulate the behaviour of the deprecated L</"
22062 "add-drive-with-if> call (q.v.)"
22063 msgstr ""
22064
22065 #. type: =head2
22066 #: ../fish/guestfish-actions.pod:140
22067 msgid "add-drive-ro"
22068 msgstr ""
22069
22070 #. type: =head2
22071 #: ../fish/guestfish-actions.pod:142
22072 msgid "add-ro"
22073 msgstr ""
22074
22075 #. type: verbatim
22076 #: ../fish/guestfish-actions.pod:144
22077 #, no-wrap
22078 msgid ""
22079 " add-drive-ro filename\n"
22080 "\n"
22081 msgstr ""
22082
22083 #. type: textblock
22084 #: ../fish/guestfish-actions.pod:146
22085 msgid ""
22086 "This function is the equivalent of calling L</add-drive-opts> with the "
22087 "optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk "
22088 "is added read-only, with the format being detected automatically."
22089 msgstr ""
22090
22091 #. type: =head2
22092 #: ../fish/guestfish-actions.pod:151
22093 msgid "add-drive-ro-with-if"
22094 msgstr ""
22095
22096 #. type: verbatim
22097 #: ../fish/guestfish-actions.pod:153
22098 #, no-wrap
22099 msgid ""
22100 " add-drive-ro-with-if filename iface\n"
22101 "\n"
22102 msgstr ""
22103
22104 #. type: textblock
22105 #: ../fish/guestfish-actions.pod:155
22106 msgid ""
22107 "This is the same as L</add-drive-ro> but it allows you to specify the QEMU "
22108 "interface emulation to use at run time."
22109 msgstr ""
22110
22111 #. type: =head2
22112 #: ../fish/guestfish-actions.pod:165
22113 msgid "add-drive-with-if"
22114 msgstr ""
22115
22116 #. type: verbatim
22117 #: ../fish/guestfish-actions.pod:167
22118 #, no-wrap
22119 msgid ""
22120 " add-drive-with-if filename iface\n"
22121 "\n"
22122 msgstr ""
22123
22124 #. type: textblock
22125 #: ../fish/guestfish-actions.pod:169
22126 msgid ""
22127 "This is the same as L</add-drive> but it allows you to specify the QEMU "
22128 "interface emulation to use at run time."
22129 msgstr ""
22130
22131 #. type: =head2
22132 #: ../fish/guestfish-actions.pod:179
22133 msgid "aug-clear"
22134 msgstr ""
22135
22136 #. type: verbatim
22137 #: ../fish/guestfish-actions.pod:181
22138 #, no-wrap
22139 msgid ""
22140 " aug-clear augpath\n"
22141 "\n"
22142 msgstr ""
22143
22144 #. type: =head2
22145 #: ../fish/guestfish-actions.pod:186
22146 msgid "aug-close"
22147 msgstr ""
22148
22149 #. type: verbatim
22150 #: ../fish/guestfish-actions.pod:188
22151 #, no-wrap
22152 msgid ""
22153 " aug-close\n"
22154 "\n"
22155 msgstr ""
22156
22157 #. type: textblock
22158 #: ../fish/guestfish-actions.pod:190
22159 msgid ""
22160 "Close the current Augeas handle and free up any resources used by it.  After "
22161 "calling this, you have to call L</aug-init> again before you can use any "
22162 "other Augeas functions."
22163 msgstr ""
22164
22165 #. type: =head2
22166 #: ../fish/guestfish-actions.pod:195
22167 msgid "aug-defnode"
22168 msgstr ""
22169
22170 #. type: verbatim
22171 #: ../fish/guestfish-actions.pod:197
22172 #, no-wrap
22173 msgid ""
22174 " aug-defnode name expr val\n"
22175 "\n"
22176 msgstr ""
22177
22178 #. type: textblock
22179 #: ../fish/guestfish-actions.pod:202
22180 msgid ""
22181 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
22182 "calling L</aug-set> C<expr>, C<value>.  C<name> will be the nodeset "
22183 "containing that single node."
22184 msgstr ""
22185
22186 #. type: =head2
22187 #: ../fish/guestfish-actions.pod:210
22188 msgid "aug-defvar"
22189 msgstr ""
22190
22191 #. type: verbatim
22192 #: ../fish/guestfish-actions.pod:212
22193 #, no-wrap
22194 msgid ""
22195 " aug-defvar name expr\n"
22196 "\n"
22197 msgstr ""
22198
22199 #. type: =head2
22200 #: ../fish/guestfish-actions.pod:221
22201 msgid "aug-get"
22202 msgstr ""
22203
22204 #. type: verbatim
22205 #: ../fish/guestfish-actions.pod:223
22206 #, no-wrap
22207 msgid ""
22208 " aug-get augpath\n"
22209 "\n"
22210 msgstr ""
22211
22212 #. type: =head2
22213 #: ../fish/guestfish-actions.pod:228
22214 msgid "aug-init"
22215 msgstr ""
22216
22217 #. type: verbatim
22218 #: ../fish/guestfish-actions.pod:230
22219 #, no-wrap
22220 msgid ""
22221 " aug-init root flags\n"
22222 "\n"
22223 msgstr ""
22224
22225 #. type: textblock
22226 #: ../fish/guestfish-actions.pod:236
22227 msgid "You must call this before using any other L</aug-*> commands."
22228 msgstr ""
22229
22230 #. type: textblock
22231 #: ../fish/guestfish-actions.pod:261
22232 msgid ""
22233 "This option is only useful when debugging Augeas lenses.  Use of this option "
22234 "may require additional memory for the libguestfs appliance.  You may need to "
22235 "set the C<LIBGUESTFS_MEMSIZE> environment variable or call L</set-memsize>."
22236 msgstr ""
22237
22238 #. type: textblock
22239 #: ../fish/guestfish-actions.pod:276
22240 msgid "Do not load the tree in L</aug-init>."
22241 msgstr ""
22242
22243 #. type: textblock
22244 #: ../fish/guestfish-actions.pod:280
22245 msgid "To close the handle, you can call L</aug-close>."
22246 msgstr ""
22247
22248 #. type: =head2
22249 #: ../fish/guestfish-actions.pod:284
22250 msgid "aug-insert"
22251 msgstr ""
22252
22253 #. type: verbatim
22254 #: ../fish/guestfish-actions.pod:286
22255 #, no-wrap
22256 msgid ""
22257 " aug-insert augpath label true|false\n"
22258 "\n"
22259 msgstr ""
22260
22261 #. type: =head2
22262 #: ../fish/guestfish-actions.pod:296
22263 msgid "aug-load"
22264 msgstr ""
22265
22266 #. type: verbatim
22267 #: ../fish/guestfish-actions.pod:298
22268 #, no-wrap
22269 msgid ""
22270 " aug-load\n"
22271 "\n"
22272 msgstr ""
22273
22274 #. type: =head2
22275 #: ../fish/guestfish-actions.pod:305
22276 msgid "aug-ls"
22277 msgstr ""
22278
22279 #. type: verbatim
22280 #: ../fish/guestfish-actions.pod:307
22281 #, no-wrap
22282 msgid ""
22283 " aug-ls augpath\n"
22284 "\n"
22285 msgstr ""
22286
22287 #. type: textblock
22288 #: ../fish/guestfish-actions.pod:309
22289 msgid ""
22290 "This is just a shortcut for listing L</aug-match> C<path/*> and sorting the "
22291 "resulting nodes into alphabetical order."
22292 msgstr ""
22293
22294 #. type: =head2
22295 #: ../fish/guestfish-actions.pod:312
22296 msgid "aug-match"
22297 msgstr ""
22298
22299 #. type: verbatim
22300 #: ../fish/guestfish-actions.pod:314
22301 #, no-wrap
22302 msgid ""
22303 " aug-match augpath\n"
22304 "\n"
22305 msgstr ""
22306
22307 #. type: =head2
22308 #: ../fish/guestfish-actions.pod:320
22309 msgid "aug-mv"
22310 msgstr ""
22311
22312 #. type: verbatim
22313 #: ../fish/guestfish-actions.pod:322
22314 #, no-wrap
22315 msgid ""
22316 " aug-mv src dest\n"
22317 "\n"
22318 msgstr ""
22319
22320 #. type: =head2
22321 #: ../fish/guestfish-actions.pod:327
22322 msgid "aug-rm"
22323 msgstr ""
22324
22325 #. type: verbatim
22326 #: ../fish/guestfish-actions.pod:329
22327 #, no-wrap
22328 msgid ""
22329 " aug-rm augpath\n"
22330 "\n"
22331 msgstr ""
22332
22333 #. type: =head2
22334 #: ../fish/guestfish-actions.pod:335
22335 msgid "aug-save"
22336 msgstr ""
22337
22338 #. type: verbatim
22339 #: ../fish/guestfish-actions.pod:337
22340 #, no-wrap
22341 msgid ""
22342 " aug-save\n"
22343 "\n"
22344 msgstr ""
22345
22346 #. type: textblock
22347 #: ../fish/guestfish-actions.pod:341
22348 msgid ""
22349 "The flags which were passed to L</aug-init> affect exactly how files are "
22350 "saved."
22351 msgstr ""
22352
22353 #. type: =head2
22354 #: ../fish/guestfish-actions.pod:344
22355 msgid "aug-set"
22356 msgstr ""
22357
22358 #. type: verbatim
22359 #: ../fish/guestfish-actions.pod:346
22360 #, no-wrap
22361 msgid ""
22362 " aug-set augpath val\n"
22363 "\n"
22364 msgstr ""
22365
22366 #. type: textblock
22367 #: ../fish/guestfish-actions.pod:350
22368 msgid ""
22369 "In the Augeas API, it is possible to clear a node by setting the value to "
22370 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
22371 "this call.  Instead you must use the L</aug-clear> call."
22372 msgstr ""
22373
22374 #. type: =head2
22375 #: ../fish/guestfish-actions.pod:355
22376 msgid "available"
22377 msgstr ""
22378
22379 #. type: verbatim
22380 #: ../fish/guestfish-actions.pod:357
22381 #, no-wrap
22382 msgid ""
22383 " available 'groups ...'\n"
22384 "\n"
22385 msgstr ""
22386
22387 #. type: textblock
22388 #: ../fish/guestfish-actions.pod:363
22389 msgid ""
22390 "The libguestfs groups, and the functions that those groups correspond to, "
22391 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
22392 "runtime by calling L</available-all-groups>."
22393 msgstr ""
22394
22395 #. type: textblock
22396 #: ../fish/guestfish-actions.pod:387
22397 msgid "You must call L</launch> before calling this function."
22398 msgstr ""
22399
22400 #. type: textblock
22401 #: ../fish/guestfish-actions.pod:409
22402 msgid ""
22403 "This call was added in version C<1.0.80>.  In previous versions of "
22404 "libguestfs all you could do would be to speculatively execute a command to "
22405 "find out if the daemon implemented it.  See also L</version>."
22406 msgstr ""
22407
22408 #. type: =head2
22409 #: ../fish/guestfish-actions.pod:416
22410 msgid "available-all-groups"
22411 msgstr ""
22412
22413 #. type: verbatim
22414 #: ../fish/guestfish-actions.pod:418
22415 #, no-wrap
22416 msgid ""
22417 " available-all-groups\n"
22418 "\n"
22419 msgstr ""
22420
22421 #. type: textblock
22422 #: ../fish/guestfish-actions.pod:420
22423 msgid ""
22424 "This command returns a list of all optional groups that this daemon knows "
22425 "about.  Note this returns both supported and unsupported groups.  To find "
22426 "out which ones the daemon can actually support you have to call L</"
22427 "available> on each member of the returned list."
22428 msgstr ""
22429
22430 #. type: textblock
22431 #: ../fish/guestfish-actions.pod:426
22432 msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>."
22433 msgstr ""
22434
22435 #. type: =head2
22436 #: ../fish/guestfish-actions.pod:428
22437 msgid "base64-in"
22438 msgstr ""
22439
22440 #. type: verbatim
22441 #: ../fish/guestfish-actions.pod:430
22442 #, no-wrap
22443 msgid ""
22444 " base64-in (base64file|-) filename\n"
22445 "\n"
22446 msgstr ""
22447
22448 #. type: textblock
22449 #: ../fish/guestfish-actions.pod:435 ../fish/guestfish-actions.pod:444
22450 #: ../fish/guestfish-actions.pod:668 ../fish/guestfish-actions.pod:837
22451 #: ../fish/guestfish-actions.pod:856 ../fish/guestfish-actions.pod:1230
22452 #: ../fish/guestfish-actions.pod:4491 ../fish/guestfish-actions.pod:4503
22453 #: ../fish/guestfish-actions.pod:4514 ../fish/guestfish-actions.pod:4525
22454 #: ../fish/guestfish-actions.pod:4577 ../fish/guestfish-actions.pod:4586
22455 #: ../fish/guestfish-actions.pod:4640 ../fish/guestfish-actions.pod:4663
22456 msgid "Use C<-> instead of a filename to read/write from stdin/stdout."
22457 msgstr ""
22458
22459 #. type: =head2
22460 #: ../fish/guestfish-actions.pod:437
22461 msgid "base64-out"
22462 msgstr ""
22463
22464 #. type: verbatim
22465 #: ../fish/guestfish-actions.pod:439
22466 #, no-wrap
22467 msgid ""
22468 " base64-out filename (base64file|-)\n"
22469 "\n"
22470 msgstr ""
22471
22472 #. type: =head2
22473 #: ../fish/guestfish-actions.pod:446
22474 msgid "blockdev-flushbufs"
22475 msgstr ""
22476
22477 #. type: verbatim
22478 #: ../fish/guestfish-actions.pod:448
22479 #, no-wrap
22480 msgid ""
22481 " blockdev-flushbufs device\n"
22482 "\n"
22483 msgstr ""
22484
22485 #. type: =head2
22486 #: ../fish/guestfish-actions.pod:455
22487 msgid "blockdev-getbsz"
22488 msgstr ""
22489
22490 #. type: verbatim
22491 #: ../fish/guestfish-actions.pod:457
22492 #, no-wrap
22493 msgid ""
22494 " blockdev-getbsz device\n"
22495 "\n"
22496 msgstr ""
22497
22498 #. type: =head2
22499 #: ../fish/guestfish-actions.pod:466
22500 msgid "blockdev-getro"
22501 msgstr ""
22502
22503 #. type: verbatim
22504 #: ../fish/guestfish-actions.pod:468
22505 #, no-wrap
22506 msgid ""
22507 " blockdev-getro device\n"
22508 "\n"
22509 msgstr ""
22510
22511 #. type: =head2
22512 #: ../fish/guestfish-actions.pod:475
22513 msgid "blockdev-getsize64"
22514 msgstr ""
22515
22516 #. type: verbatim
22517 #: ../fish/guestfish-actions.pod:477
22518 #, no-wrap
22519 msgid ""
22520 " blockdev-getsize64 device\n"
22521 "\n"
22522 msgstr ""
22523
22524 #. type: textblock
22525 #: ../fish/guestfish-actions.pod:481
22526 msgid "See also L</blockdev-getsz>."
22527 msgstr ""
22528
22529 #. type: =head2
22530 #: ../fish/guestfish-actions.pod:485
22531 msgid "blockdev-getss"
22532 msgstr ""
22533
22534 #. type: verbatim
22535 #: ../fish/guestfish-actions.pod:487
22536 #, no-wrap
22537 msgid ""
22538 " blockdev-getss device\n"
22539 "\n"
22540 msgstr ""
22541
22542 #. type: textblock
22543 #: ../fish/guestfish-actions.pod:492
22544 msgid ""
22545 "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)."
22546 msgstr ""
22547
22548 #. type: =head2
22549 #: ../fish/guestfish-actions.pod:497
22550 msgid "blockdev-getsz"
22551 msgstr ""
22552
22553 #. type: verbatim
22554 #: ../fish/guestfish-actions.pod:499
22555 #, no-wrap
22556 msgid ""
22557 " blockdev-getsz device\n"
22558 "\n"
22559 msgstr ""
22560
22561 #. type: textblock
22562 #: ../fish/guestfish-actions.pod:504
22563 msgid ""
22564 "See also L</blockdev-getss> for the real sector size of the device, and L</"
22565 "blockdev-getsize64> for the more useful I<size in bytes>."
22566 msgstr ""
22567
22568 #. type: =head2
22569 #: ../fish/guestfish-actions.pod:510
22570 msgid "blockdev-rereadpt"
22571 msgstr ""
22572
22573 #. type: verbatim
22574 #: ../fish/guestfish-actions.pod:512
22575 #, no-wrap
22576 msgid ""
22577 " blockdev-rereadpt device\n"
22578 "\n"
22579 msgstr ""
22580
22581 #. type: =head2
22582 #: ../fish/guestfish-actions.pod:518
22583 msgid "blockdev-setbsz"
22584 msgstr ""
22585
22586 #. type: verbatim
22587 #: ../fish/guestfish-actions.pod:520
22588 #, no-wrap
22589 msgid ""
22590 " blockdev-setbsz device blocksize\n"
22591 "\n"
22592 msgstr ""
22593
22594 #. type: =head2
22595 #: ../fish/guestfish-actions.pod:529
22596 msgid "blockdev-setro"
22597 msgstr ""
22598
22599 #. type: verbatim
22600 #: ../fish/guestfish-actions.pod:531
22601 #, no-wrap
22602 msgid ""
22603 " blockdev-setro device\n"
22604 "\n"
22605 msgstr ""
22606
22607 #. type: =head2
22608 #: ../fish/guestfish-actions.pod:537
22609 msgid "blockdev-setrw"
22610 msgstr ""
22611
22612 #. type: verbatim
22613 #: ../fish/guestfish-actions.pod:539
22614 #, no-wrap
22615 msgid ""
22616 " blockdev-setrw device\n"
22617 "\n"
22618 msgstr ""
22619
22620 #. type: =head2
22621 #: ../fish/guestfish-actions.pod:545
22622 msgid "case-sensitive-path"
22623 msgstr ""
22624
22625 #. type: verbatim
22626 #: ../fish/guestfish-actions.pod:547
22627 #, no-wrap
22628 msgid ""
22629 " case-sensitive-path path\n"
22630 "\n"
22631 msgstr ""
22632
22633 #. type: textblock
22634 #: ../fish/guestfish-actions.pod:571
22635 msgid ""
22636 "Thus L</case-sensitive-path> (\"/Windows/System32\")  might return C<\"/"
22637 "WINDOWS/system32\"> (the exact return value would depend on details of how "
22638 "the directories were originally created under Windows)."
22639 msgstr ""
22640
22641 #. type: textblock
22642 #: ../fish/guestfish-actions.pod:579
22643 msgid "See also L</realpath>."
22644 msgstr ""
22645
22646 #. type: =head2
22647 #: ../fish/guestfish-actions.pod:581
22648 msgid "cat"
22649 msgstr ""
22650
22651 #. type: verbatim
22652 #: ../fish/guestfish-actions.pod:583
22653 #, no-wrap
22654 msgid ""
22655 " cat path\n"
22656 "\n"
22657 msgstr ""
22658
22659 #. type: textblock
22660 #: ../fish/guestfish-actions.pod:587
22661 msgid ""
22662 "Note that this function cannot correctly handle binary files (specifically, "
22663 "files containing C<\\0> character which is treated as end of string).  For "
22664 "those you need to use the L</read-file> or L</download> functions which have "
22665 "a more complex interface."
22666 msgstr ""
22667
22668 #. type: =head2
22669 #: ../fish/guestfish-actions.pod:595
22670 msgid "checksum"
22671 msgstr ""
22672
22673 #. type: verbatim
22674 #: ../fish/guestfish-actions.pod:597
22675 #, no-wrap
22676 msgid ""
22677 " checksum csumtype path\n"
22678 "\n"
22679 msgstr ""
22680
22681 #. type: textblock
22682 #: ../fish/guestfish-actions.pod:640
22683 msgid "To get the checksum for a device, use L</checksum-device>."
22684 msgstr ""
22685
22686 #. type: textblock
22687 #: ../fish/guestfish-actions.pod:642
22688 msgid "To get the checksums for many files, use L</checksums-out>."
22689 msgstr ""
22690
22691 #. type: =head2
22692 #: ../fish/guestfish-actions.pod:644
22693 msgid "checksum-device"
22694 msgstr ""
22695
22696 #. type: verbatim
22697 #: ../fish/guestfish-actions.pod:646
22698 #, no-wrap
22699 msgid ""
22700 " checksum-device csumtype device\n"
22701 "\n"
22702 msgstr ""
22703
22704 #. type: textblock
22705 #: ../fish/guestfish-actions.pod:648
22706 msgid ""
22707 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
22708 "device named C<device>.  For the types of checksums supported see the L</"
22709 "checksum> command."
22710 msgstr ""
22711
22712 #. type: =head2
22713 #: ../fish/guestfish-actions.pod:652
22714 msgid "checksums-out"
22715 msgstr ""
22716
22717 #. type: verbatim
22718 #: ../fish/guestfish-actions.pod:654
22719 #, no-wrap
22720 msgid ""
22721 " checksums-out csumtype directory (sumsfile|-)\n"
22722 "\n"
22723 msgstr ""
22724
22725 #. type: =head2
22726 #: ../fish/guestfish-actions.pod:670
22727 msgid "chmod"
22728 msgstr ""
22729
22730 #. type: verbatim
22731 #: ../fish/guestfish-actions.pod:672
22732 #, no-wrap
22733 msgid ""
22734 " chmod mode path\n"
22735 "\n"
22736 msgstr ""
22737
22738 #. type: =head2
22739 #: ../fish/guestfish-actions.pod:683
22740 msgid "chown"
22741 msgstr ""
22742
22743 #. type: verbatim
22744 #: ../fish/guestfish-actions.pod:685
22745 #, no-wrap
22746 msgid ""
22747 " chown owner group path\n"
22748 "\n"
22749 msgstr ""
22750
22751 #. type: =head2
22752 #: ../fish/guestfish-actions.pod:693
22753 msgid "command"
22754 msgstr ""
22755
22756 #. type: verbatim
22757 #: ../fish/guestfish-actions.pod:695
22758 #, no-wrap
22759 msgid ""
22760 " command 'arguments ...'\n"
22761 "\n"
22762 msgstr ""
22763
22764 #. type: textblock
22765 #: ../fish/guestfish-actions.pod:702
22766 msgid ""
22767 "The single parameter is an argv-style list of arguments.  The first element "
22768 "is the name of the program to run.  Subsequent elements are parameters.  The "
22769 "list must be non-empty (ie. must contain a program name).  Note that the "
22770 "command runs directly, and is I<not> invoked via the shell (see L</sh>)."
22771 msgstr ""
22772
22773 #. type: =head2
22774 #: ../fish/guestfish-actions.pod:730
22775 msgid "command-lines"
22776 msgstr ""
22777
22778 #. type: verbatim
22779 #: ../fish/guestfish-actions.pod:732
22780 #, no-wrap
22781 msgid ""
22782 " command-lines 'arguments ...'\n"
22783 "\n"
22784 msgstr ""
22785
22786 #. type: textblock
22787 #: ../fish/guestfish-actions.pod:734
22788 msgid ""
22789 "This is the same as L</command>, but splits the result into a list of lines."
22790 msgstr ""
22791
22792 #. type: textblock
22793 #: ../fish/guestfish-actions.pod:737
22794 msgid "See also: L</sh-lines>"
22795 msgstr ""
22796
22797 #. type: =head2
22798 #: ../fish/guestfish-actions.pod:742
22799 msgid "config"
22800 msgstr ""
22801
22802 #. type: verbatim
22803 #: ../fish/guestfish-actions.pod:744
22804 #, no-wrap
22805 msgid ""
22806 " config qemuparam qemuvalue\n"
22807 "\n"
22808 msgstr ""
22809
22810 #. type: =head2
22811 #: ../fish/guestfish-actions.pod:755
22812 msgid "copy-size"
22813 msgstr ""
22814
22815 #. type: verbatim
22816 #: ../fish/guestfish-actions.pod:757
22817 #, no-wrap
22818 msgid ""
22819 " copy-size src dest size\n"
22820 "\n"
22821 msgstr ""
22822
22823 #. type: =head2
22824 #: ../fish/guestfish-actions.pod:765
22825 msgid "cp"
22826 msgstr ""
22827
22828 #. type: verbatim
22829 #: ../fish/guestfish-actions.pod:767
22830 #, no-wrap
22831 msgid ""
22832 " cp src dest\n"
22833 "\n"
22834 msgstr ""
22835
22836 #. type: =head2
22837 #: ../fish/guestfish-actions.pod:772
22838 msgid "cp-a"
22839 msgstr ""
22840
22841 #. type: verbatim
22842 #: ../fish/guestfish-actions.pod:774
22843 #, no-wrap
22844 msgid ""
22845 " cp-a src dest\n"
22846 "\n"
22847 msgstr ""
22848
22849 #. type: =head2
22850 #: ../fish/guestfish-actions.pod:779
22851 msgid "dd"
22852 msgstr ""
22853
22854 #. type: verbatim
22855 #: ../fish/guestfish-actions.pod:781
22856 #, no-wrap
22857 msgid ""
22858 " dd src dest\n"
22859 "\n"
22860 msgstr ""
22861
22862 #. type: textblock
22863 #: ../fish/guestfish-actions.pod:788
22864 msgid ""
22865 "If the destination is a device, it must be as large or larger than the "
22866 "source file or device, otherwise the copy will fail.  This command cannot do "
22867 "partial copies (see L</copy-size>)."
22868 msgstr ""
22869
22870 #. type: =head2
22871 #: ../fish/guestfish-actions.pod:792
22872 msgid "df"
22873 msgstr ""
22874
22875 #. type: verbatim
22876 #: ../fish/guestfish-actions.pod:794
22877 #, no-wrap
22878 msgid ""
22879 " df\n"
22880 "\n"
22881 msgstr ""
22882
22883 #. type: textblock
22884 #: ../fish/guestfish-actions.pod:798 ../fish/guestfish-actions.pod:809
22885 msgid ""
22886 "This command is mostly useful for interactive sessions.  It is I<not> "
22887 "intended that you try to parse the output string.  Use L</statvfs> from "
22888 "programs."
22889 msgstr ""
22890
22891 #. type: =head2
22892 #: ../fish/guestfish-actions.pod:802
22893 msgid "df-h"
22894 msgstr ""
22895
22896 #. type: verbatim
22897 #: ../fish/guestfish-actions.pod:804
22898 #, no-wrap
22899 msgid ""
22900 " df-h\n"
22901 "\n"
22902 msgstr ""
22903
22904 #. type: =head2
22905 #: ../fish/guestfish-actions.pod:813
22906 msgid "dmesg"
22907 msgstr ""
22908
22909 #. type: verbatim
22910 #: ../fish/guestfish-actions.pod:815
22911 #, no-wrap
22912 msgid ""
22913 " dmesg\n"
22914 "\n"
22915 msgstr ""
22916
22917 #. type: textblock
22918 #: ../fish/guestfish-actions.pod:821
22919 msgid ""
22920 "Another way to get the same information is to enable verbose messages with "
22921 "L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> "
22922 "before running the program."
22923 msgstr ""
22924
22925 #. type: =head2
22926 #: ../fish/guestfish-actions.pod:826
22927 msgid "download"
22928 msgstr ""
22929
22930 #. type: verbatim
22931 #: ../fish/guestfish-actions.pod:828
22932 #, no-wrap
22933 msgid ""
22934 " download remotefilename (filename|-)\n"
22935 "\n"
22936 msgstr ""
22937
22938 #. type: textblock
22939 #: ../fish/guestfish-actions.pod:835
22940 msgid "See also L</upload>, L</cat>."
22941 msgstr ""
22942
22943 #. type: =head2
22944 #: ../fish/guestfish-actions.pod:839
22945 msgid "download-offset"
22946 msgstr ""
22947
22948 #. type: verbatim
22949 #: ../fish/guestfish-actions.pod:841
22950 #, no-wrap
22951 msgid ""
22952 " download-offset remotefilename (filename|-) offset size\n"
22953 "\n"
22954 msgstr ""
22955
22956 #. type: textblock
22957 #: ../fish/guestfish-actions.pod:849
22958 msgid ""
22959 "Note that there is no limit on the amount of data that can be downloaded "
22960 "with this call, unlike with L</pread>, and this call always reads the full "
22961 "amount unless an error occurs."
22962 msgstr ""
22963
22964 #. type: textblock
22965 #: ../fish/guestfish-actions.pod:854
22966 msgid "See also L</download>, L</pread>."
22967 msgstr ""
22968
22969 #. type: =head2
22970 #: ../fish/guestfish-actions.pod:858
22971 msgid "drop-caches"
22972 msgstr ""
22973
22974 #. type: verbatim
22975 #: ../fish/guestfish-actions.pod:860
22976 #, no-wrap
22977 msgid ""
22978 " drop-caches whattodrop\n"
22979 "\n"
22980 msgstr ""
22981
22982 #. type: =head2
22983 #: ../fish/guestfish-actions.pod:872
22984 msgid "du"
22985 msgstr ""
22986
22987 #. type: verbatim
22988 #: ../fish/guestfish-actions.pod:874
22989 #, no-wrap
22990 msgid ""
22991 " du path\n"
22992 "\n"
22993 msgstr ""
22994
22995 #. type: =head2
22996 #: ../fish/guestfish-actions.pod:886
22997 msgid "e2fsck-f"
22998 msgstr ""
22999
23000 #. type: verbatim
23001 #: ../fish/guestfish-actions.pod:888
23002 #, no-wrap
23003 msgid ""
23004 " e2fsck-f device\n"
23005 "\n"
23006 msgstr ""
23007
23008 #. type: textblock
23009 #: ../fish/guestfish-actions.pod:894
23010 msgid ""
23011 "This command is only needed because of L</resize2fs> (q.v.).  Normally you "
23012 "should use L</fsck>."
23013 msgstr ""
23014
23015 #. type: =head2
23016 #: ../fish/guestfish-actions.pod:897
23017 msgid "echo-daemon"
23018 msgstr ""
23019
23020 #. type: verbatim
23021 #: ../fish/guestfish-actions.pod:899
23022 #, no-wrap
23023 msgid ""
23024 " echo-daemon 'words ...'\n"
23025 "\n"
23026 msgstr ""
23027
23028 #. type: textblock
23029 #: ../fish/guestfish-actions.pod:906
23030 msgid "See also L</ping-daemon>."
23031 msgstr ""
23032
23033 #. type: =head2
23034 #: ../fish/guestfish-actions.pod:908
23035 msgid "egrep"
23036 msgstr ""
23037
23038 #. type: verbatim
23039 #: ../fish/guestfish-actions.pod:910
23040 #, no-wrap
23041 msgid ""
23042 " egrep regex path\n"
23043 "\n"
23044 msgstr ""
23045
23046 #. type: =head2
23047 #: ../fish/guestfish-actions.pod:918
23048 msgid "egrepi"
23049 msgstr ""
23050
23051 #. type: verbatim
23052 #: ../fish/guestfish-actions.pod:920
23053 #, no-wrap
23054 msgid ""
23055 " egrepi regex path\n"
23056 "\n"
23057 msgstr ""
23058
23059 #. type: =head2
23060 #: ../fish/guestfish-actions.pod:928
23061 msgid "equal"
23062 msgstr ""
23063
23064 #. type: verbatim
23065 #: ../fish/guestfish-actions.pod:930
23066 #, no-wrap
23067 msgid ""
23068 " equal file1 file2\n"
23069 "\n"
23070 msgstr ""
23071
23072 #. type: =head2
23073 #: ../fish/guestfish-actions.pod:937
23074 msgid "exists"
23075 msgstr ""
23076
23077 #. type: verbatim
23078 #: ../fish/guestfish-actions.pod:939
23079 #, no-wrap
23080 msgid ""
23081 " exists path\n"
23082 "\n"
23083 msgstr ""
23084
23085 #. type: textblock
23086 #: ../fish/guestfish-actions.pod:944
23087 msgid "See also L</is-file>, L</is-dir>, L</stat>."
23088 msgstr ""
23089
23090 #. type: =head2
23091 #: ../fish/guestfish-actions.pod:946
23092 msgid "fallocate"
23093 msgstr ""
23094
23095 #. type: verbatim
23096 #: ../fish/guestfish-actions.pod:948
23097 #, no-wrap
23098 msgid ""
23099 " fallocate path len\n"
23100 "\n"
23101 msgstr ""
23102
23103 #. type: textblock
23104 #: ../fish/guestfish-actions.pod:958
23105 msgid ""
23106 "This function is deprecated.  In new code, use the L</fallocate64> call "
23107 "instead."
23108 msgstr ""
23109
23110 #. type: =head2
23111 #: ../fish/guestfish-actions.pod:965
23112 msgid "fallocate64"
23113 msgstr ""
23114
23115 #. type: verbatim
23116 #: ../fish/guestfish-actions.pod:967
23117 #, no-wrap
23118 msgid ""
23119 " fallocate64 path len\n"
23120 "\n"
23121 msgstr ""
23122
23123 #. type: textblock
23124 #: ../fish/guestfish-actions.pod:973
23125 msgid ""
23126 "Note that this call allocates disk blocks for the file.  To create a sparse "
23127 "file use L</truncate-size> instead."
23128 msgstr ""
23129
23130 #. type: textblock
23131 #: ../fish/guestfish-actions.pod:976
23132 msgid ""
23133 "The deprecated call L</fallocate> does the same, but owing to an oversight "
23134 "it only allowed 30 bit lengths to be specified, effectively limiting the "
23135 "maximum size of files created through that call to 1GB."
23136 msgstr ""
23137
23138 #. type: =head2
23139 #: ../fish/guestfish-actions.pod:985
23140 msgid "fgrep"
23141 msgstr ""
23142
23143 #. type: verbatim
23144 #: ../fish/guestfish-actions.pod:987
23145 #, no-wrap
23146 msgid ""
23147 " fgrep pattern path\n"
23148 "\n"
23149 msgstr ""
23150
23151 #. type: =head2
23152 #: ../fish/guestfish-actions.pod:995
23153 msgid "fgrepi"
23154 msgstr ""
23155
23156 #. type: verbatim
23157 #: ../fish/guestfish-actions.pod:997
23158 #, no-wrap
23159 msgid ""
23160 " fgrepi pattern path\n"
23161 "\n"
23162 msgstr ""
23163
23164 #. type: =head2
23165 #: ../fish/guestfish-actions.pod:1005
23166 msgid "file"
23167 msgstr ""
23168
23169 #. type: verbatim
23170 #: ../fish/guestfish-actions.pod:1007
23171 #, no-wrap
23172 msgid ""
23173 " file path\n"
23174 "\n"
23175 msgstr ""
23176
23177 #. type: textblock
23178 #: ../fish/guestfish-actions.pod:1023
23179 msgid ""
23180 "See also: L<file(1)>, L</vfs-type>, L</lstat>, L</is-file>, L</is-blockdev> "
23181 "(etc)."
23182 msgstr ""
23183
23184 #. type: =head2
23185 #: ../fish/guestfish-actions.pod:1026
23186 msgid "file-architecture"
23187 msgstr ""
23188
23189 #. type: verbatim
23190 #: ../fish/guestfish-actions.pod:1028
23191 #, no-wrap
23192 msgid ""
23193 " file-architecture filename\n"
23194 "\n"
23195 msgstr ""
23196
23197 #. type: =head2
23198 #: ../fish/guestfish-actions.pod:1131
23199 msgid "filesize"
23200 msgstr ""
23201
23202 #. type: verbatim
23203 #: ../fish/guestfish-actions.pod:1133
23204 #, no-wrap
23205 msgid ""
23206 " filesize file\n"
23207 "\n"
23208 msgstr ""
23209
23210 #. type: textblock
23211 #: ../fish/guestfish-actions.pod:1137
23212 msgid ""
23213 "To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, L</is-"
23214 "file> etc.  To get the size of block devices, use L</blockdev-getsize64>."
23215 msgstr ""
23216
23217 #. type: =head2
23218 #: ../fish/guestfish-actions.pod:1141
23219 msgid "fill"
23220 msgstr ""
23221
23222 #. type: verbatim
23223 #: ../fish/guestfish-actions.pod:1143
23224 #, no-wrap
23225 msgid ""
23226 " fill c len path\n"
23227 "\n"
23228 msgstr ""
23229
23230 #. type: textblock
23231 #: ../fish/guestfish-actions.pod:1149
23232 msgid ""
23233 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
23234 "L</truncate-size>.  To create a file with a pattern of repeating bytes use "
23235 "L</fill-pattern>."
23236 msgstr ""
23237
23238 #. type: =head2
23239 #: ../fish/guestfish-actions.pod:1154
23240 msgid "fill-pattern"
23241 msgstr ""
23242
23243 #. type: verbatim
23244 #: ../fish/guestfish-actions.pod:1156
23245 #, no-wrap
23246 msgid ""
23247 " fill-pattern pattern len path\n"
23248 "\n"
23249 msgstr ""
23250
23251 #. type: textblock
23252 #: ../fish/guestfish-actions.pod:1158
23253 msgid ""
23254 "This function is like L</fill> except that it creates a new file of length "
23255 "C<len> containing the repeating pattern of bytes in C<pattern>.  The pattern "
23256 "is truncated if necessary to ensure the length of the file is exactly C<len> "
23257 "bytes."
23258 msgstr ""
23259
23260 #. type: =head2
23261 #: ../fish/guestfish-actions.pod:1163
23262 msgid "find"
23263 msgstr ""
23264
23265 #. type: verbatim
23266 #: ../fish/guestfish-actions.pod:1165
23267 #, no-wrap
23268 msgid ""
23269 " find directory\n"
23270 "\n"
23271 msgstr ""
23272
23273 #. type: textblock
23274 #: ../fish/guestfish-actions.pod:1179
23275 msgid "then the returned list from L</find> C</tmp> would be 4 elements:"
23276 msgstr ""
23277
23278 #. type: textblock
23279 #: ../fish/guestfish-actions.pod:1192
23280 msgid "See also L</find0>."
23281 msgstr ""
23282
23283 #. type: =head2
23284 #: ../fish/guestfish-actions.pod:1197
23285 msgid "find0"
23286 msgstr ""
23287
23288 #. type: verbatim
23289 #: ../fish/guestfish-actions.pod:1199
23290 #, no-wrap
23291 msgid ""
23292 " find0 directory (files|-)\n"
23293 "\n"
23294 msgstr ""
23295
23296 #. type: textblock
23297 #: ../fish/guestfish-actions.pod:1205
23298 msgid ""
23299 "This command works the same way as L</find> with the following exceptions:"
23300 msgstr ""
23301
23302 #. type: =head2
23303 #: ../fish/guestfish-actions.pod:1232
23304 msgid "findfs-label"
23305 msgstr ""
23306
23307 #. type: verbatim
23308 #: ../fish/guestfish-actions.pod:1234
23309 #, no-wrap
23310 msgid ""
23311 " findfs-label label\n"
23312 "\n"
23313 msgstr ""
23314
23315 #. type: textblock
23316 #: ../fish/guestfish-actions.pod:1240
23317 msgid "To find the label of a filesystem, use L</vfs-label>."
23318 msgstr ""
23319
23320 #. type: =head2
23321 #: ../fish/guestfish-actions.pod:1242
23322 msgid "findfs-uuid"
23323 msgstr ""
23324
23325 #. type: verbatim
23326 #: ../fish/guestfish-actions.pod:1244
23327 #, no-wrap
23328 msgid ""
23329 " findfs-uuid uuid\n"
23330 "\n"
23331 msgstr ""
23332
23333 #. type: textblock
23334 #: ../fish/guestfish-actions.pod:1250
23335 msgid "To find the UUID of a filesystem, use L</vfs-uuid>."
23336 msgstr ""
23337
23338 #. type: =head2
23339 #: ../fish/guestfish-actions.pod:1252
23340 msgid "fsck"
23341 msgstr ""
23342
23343 #. type: verbatim
23344 #: ../fish/guestfish-actions.pod:1254
23345 #, no-wrap
23346 msgid ""
23347 " fsck fstype device\n"
23348 "\n"
23349 msgstr ""
23350
23351 #. type: =head2
23352 #: ../fish/guestfish-actions.pod:1284
23353 msgid "get-append"
23354 msgstr ""
23355
23356 #. type: verbatim
23357 #: ../fish/guestfish-actions.pod:1286
23358 #, no-wrap
23359 msgid ""
23360 " get-append\n"
23361 "\n"
23362 msgstr ""
23363
23364 #. type: =head2
23365 #: ../fish/guestfish-actions.pod:1293
23366 msgid "get-attach-method"
23367 msgstr ""
23368
23369 #. type: verbatim
23370 #: ../fish/guestfish-actions.pod:1295
23371 #, no-wrap
23372 msgid ""
23373 " get-attach-method\n"
23374 "\n"
23375 msgstr ""
23376
23377 #. type: textblock
23378 #: ../fish/guestfish-actions.pod:1297
23379 msgid "Return the current attach method.  See L</set-attach-method>."
23380 msgstr ""
23381
23382 #. type: =head2
23383 #: ../fish/guestfish-actions.pod:1299
23384 msgid "get-autosync"
23385 msgstr ""
23386
23387 #. type: verbatim
23388 #: ../fish/guestfish-actions.pod:1301
23389 #, no-wrap
23390 msgid ""
23391 " get-autosync\n"
23392 "\n"
23393 msgstr ""
23394
23395 #. type: =head2
23396 #: ../fish/guestfish-actions.pod:1305
23397 msgid "get-direct"
23398 msgstr ""
23399
23400 #. type: verbatim
23401 #: ../fish/guestfish-actions.pod:1307
23402 #, no-wrap
23403 msgid ""
23404 " get-direct\n"
23405 "\n"
23406 msgstr ""
23407
23408 #. type: =head2
23409 #: ../fish/guestfish-actions.pod:1311
23410 msgid "get-e2label"
23411 msgstr ""
23412
23413 #. type: verbatim
23414 #: ../fish/guestfish-actions.pod:1313
23415 #, no-wrap
23416 msgid ""
23417 " get-e2label device\n"
23418 "\n"
23419 msgstr ""
23420
23421 #. type: textblock
23422 #: ../fish/guestfish-actions.pod:1318
23423 msgid ""
23424 "This function is deprecated.  In new code, use the L</vfs_label> call "
23425 "instead."
23426 msgstr ""
23427
23428 #. type: =head2
23429 #: ../fish/guestfish-actions.pod:1325
23430 msgid "get-e2uuid"
23431 msgstr ""
23432
23433 #. type: verbatim
23434 #: ../fish/guestfish-actions.pod:1327
23435 #, no-wrap
23436 msgid ""
23437 " get-e2uuid device\n"
23438 "\n"
23439 msgstr ""
23440
23441 #. type: textblock
23442 #: ../fish/guestfish-actions.pod:1332
23443 msgid ""
23444 "This function is deprecated.  In new code, use the L</vfs_uuid> call instead."
23445 msgstr ""
23446
23447 #. type: =head2
23448 #: ../fish/guestfish-actions.pod:1339
23449 msgid "get-memsize"
23450 msgstr ""
23451
23452 #. type: verbatim
23453 #: ../fish/guestfish-actions.pod:1341
23454 #, no-wrap
23455 msgid ""
23456 " get-memsize\n"
23457 "\n"
23458 msgstr ""
23459
23460 #. type: textblock
23461 #: ../fish/guestfish-actions.pod:1346
23462 msgid ""
23463 "If L</set-memsize> was not called on this handle, and if "
23464 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
23465 "value for memsize."
23466 msgstr ""
23467
23468 #. type: =head2
23469 #: ../fish/guestfish-actions.pod:1353
23470 msgid "get-network"
23471 msgstr ""
23472
23473 #. type: verbatim
23474 #: ../fish/guestfish-actions.pod:1355
23475 #, no-wrap
23476 msgid ""
23477 " get-network\n"
23478 "\n"
23479 msgstr ""
23480
23481 #. type: =head2
23482 #: ../fish/guestfish-actions.pod:1359
23483 msgid "get-path"
23484 msgstr ""
23485
23486 #. type: verbatim
23487 #: ../fish/guestfish-actions.pod:1361
23488 #, no-wrap
23489 msgid ""
23490 " get-path\n"
23491 "\n"
23492 msgstr ""
23493
23494 #. type: =head2
23495 #: ../fish/guestfish-actions.pod:1368
23496 msgid "get-pid"
23497 msgstr ""
23498
23499 #. type: =head2
23500 #: ../fish/guestfish-actions.pod:1370
23501 msgid "pid"
23502 msgstr ""
23503
23504 #. type: verbatim
23505 #: ../fish/guestfish-actions.pod:1372
23506 #, no-wrap
23507 msgid ""
23508 " get-pid\n"
23509 "\n"
23510 msgstr ""
23511
23512 #. type: =head2
23513 #: ../fish/guestfish-actions.pod:1379
23514 msgid "get-qemu"
23515 msgstr ""
23516
23517 #. type: verbatim
23518 #: ../fish/guestfish-actions.pod:1381
23519 #, no-wrap
23520 msgid ""
23521 " get-qemu\n"
23522 "\n"
23523 msgstr ""
23524
23525 #. type: =head2
23526 #: ../fish/guestfish-actions.pod:1388
23527 msgid "get-recovery-proc"
23528 msgstr ""
23529
23530 #. type: verbatim
23531 #: ../fish/guestfish-actions.pod:1390
23532 #, no-wrap
23533 msgid ""
23534 " get-recovery-proc\n"
23535 "\n"
23536 msgstr ""
23537
23538 #. type: =head2
23539 #: ../fish/guestfish-actions.pod:1394
23540 msgid "get-selinux"
23541 msgstr ""
23542
23543 #. type: verbatim
23544 #: ../fish/guestfish-actions.pod:1396
23545 #, no-wrap
23546 msgid ""
23547 " get-selinux\n"
23548 "\n"
23549 msgstr ""
23550
23551 #. type: textblock
23552 #: ../fish/guestfish-actions.pod:1398
23553 msgid ""
23554 "This returns the current setting of the selinux flag which is passed to the "
23555 "appliance at boot time.  See L</set-selinux>."
23556 msgstr ""
23557
23558 #. type: =head2
23559 #: ../fish/guestfish-actions.pod:1404
23560 msgid "get-state"
23561 msgstr ""
23562
23563 #. type: verbatim
23564 #: ../fish/guestfish-actions.pod:1406
23565 #, no-wrap
23566 msgid ""
23567 " get-state\n"
23568 "\n"
23569 msgstr ""
23570
23571 #. type: =head2
23572 #: ../fish/guestfish-actions.pod:1413
23573 msgid "get-trace"
23574 msgstr ""
23575
23576 #. type: verbatim
23577 #: ../fish/guestfish-actions.pod:1415
23578 #, no-wrap
23579 msgid ""
23580 " get-trace\n"
23581 "\n"
23582 msgstr ""
23583
23584 #. type: =head2
23585 #: ../fish/guestfish-actions.pod:1419
23586 msgid "get-umask"
23587 msgstr ""
23588
23589 #. type: verbatim
23590 #: ../fish/guestfish-actions.pod:1421
23591 #, no-wrap
23592 msgid ""
23593 " get-umask\n"
23594 "\n"
23595 msgstr ""
23596
23597 #. type: textblock
23598 #: ../fish/guestfish-actions.pod:1423
23599 msgid ""
23600 "Return the current umask.  By default the umask is C<022> unless it has been "
23601 "set by calling L</umask>."
23602 msgstr ""
23603
23604 #. type: =head2
23605 #: ../fish/guestfish-actions.pod:1426
23606 msgid "get-verbose"
23607 msgstr ""
23608
23609 #. type: verbatim
23610 #: ../fish/guestfish-actions.pod:1428
23611 #, no-wrap
23612 msgid ""
23613 " get-verbose\n"
23614 "\n"
23615 msgstr ""
23616
23617 #. type: =head2
23618 #: ../fish/guestfish-actions.pod:1432
23619 msgid "getcon"
23620 msgstr ""
23621
23622 #. type: verbatim
23623 #: ../fish/guestfish-actions.pod:1434
23624 #, no-wrap
23625 msgid ""
23626 " getcon\n"
23627 "\n"
23628 msgstr ""
23629
23630 #. type: textblock
23631 #: ../fish/guestfish-actions.pod:1438
23632 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>"
23633 msgstr ""
23634
23635 #. type: =head2
23636 #: ../fish/guestfish-actions.pod:1441
23637 msgid "getxattr"
23638 msgstr ""
23639
23640 #. type: verbatim
23641 #: ../fish/guestfish-actions.pod:1443
23642 #, no-wrap
23643 msgid ""
23644 " getxattr path name\n"
23645 "\n"
23646 msgstr ""
23647
23648 #. type: textblock
23649 #: ../fish/guestfish-actions.pod:1445
23650 msgid ""
23651 "Get a single extended attribute from file C<path> named C<name>.  This call "
23652 "follows symlinks.  If you want to lookup an extended attribute for the "
23653 "symlink itself, use L</lgetxattr>."
23654 msgstr ""
23655
23656 #. type: textblock
23657 #: ../fish/guestfish-actions.pod:1449 ../fish/guestfish-actions.pod:2455
23658 msgid ""
23659 "Normally it is better to get all extended attributes from a file in one go "
23660 "by calling L</getxattrs>.  However some Linux filesystem implementations are "
23661 "buggy and do not provide a way to list out attributes.  For these "
23662 "filesystems (notably ntfs-3g)  you have to know the names of the extended "
23663 "attributes you want in advance and call this function."
23664 msgstr ""
23665
23666 #. type: textblock
23667 #: ../fish/guestfish-actions.pod:1459
23668 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>."
23669 msgstr ""
23670
23671 #. type: =head2
23672 #: ../fish/guestfish-actions.pod:1461
23673 msgid "getxattrs"
23674 msgstr ""
23675
23676 #. type: verbatim
23677 #: ../fish/guestfish-actions.pod:1463
23678 #, no-wrap
23679 msgid ""
23680 " getxattrs path\n"
23681 "\n"
23682 msgstr ""
23683
23684 #. type: textblock
23685 #: ../fish/guestfish-actions.pod:1471
23686 msgid "See also: L</lgetxattrs>, L<attr(5)>."
23687 msgstr ""
23688
23689 #. type: =head2
23690 #: ../fish/guestfish-actions.pod:1473
23691 msgid "glob-expand"
23692 msgstr ""
23693
23694 #. type: verbatim
23695 #: ../fish/guestfish-actions.pod:1475
23696 #, no-wrap
23697 msgid ""
23698 " glob-expand pattern\n"
23699 "\n"
23700 msgstr ""
23701
23702 #. type: =head2
23703 #: ../fish/guestfish-actions.pod:1488
23704 msgid "grep"
23705 msgstr ""
23706
23707 #. type: verbatim
23708 #: ../fish/guestfish-actions.pod:1490
23709 #, no-wrap
23710 msgid ""
23711 " grep regex path\n"
23712 "\n"
23713 msgstr ""
23714
23715 #. type: =head2
23716 #: ../fish/guestfish-actions.pod:1498
23717 msgid "grepi"
23718 msgstr ""
23719
23720 #. type: verbatim
23721 #: ../fish/guestfish-actions.pod:1500
23722 #, no-wrap
23723 msgid ""
23724 " grepi regex path\n"
23725 "\n"
23726 msgstr ""
23727
23728 #. type: =head2
23729 #: ../fish/guestfish-actions.pod:1508
23730 msgid "grub-install"
23731 msgstr ""
23732
23733 #. type: verbatim
23734 #: ../fish/guestfish-actions.pod:1510
23735 #, no-wrap
23736 msgid ""
23737 " grub-install root device\n"
23738 "\n"
23739 msgstr ""
23740
23741 #. type: =head2
23742 #: ../fish/guestfish-actions.pod:1526
23743 msgid "head"
23744 msgstr ""
23745
23746 #. type: verbatim
23747 #: ../fish/guestfish-actions.pod:1528
23748 #, no-wrap
23749 msgid ""
23750 " head path\n"
23751 "\n"
23752 msgstr ""
23753
23754 #. type: =head2
23755 #: ../fish/guestfish-actions.pod:1536
23756 msgid "head-n"
23757 msgstr ""
23758
23759 #. type: verbatim
23760 #: ../fish/guestfish-actions.pod:1538
23761 #, no-wrap
23762 msgid ""
23763 " head-n nrlines path\n"
23764 "\n"
23765 msgstr ""
23766
23767 #. type: =head2
23768 #: ../fish/guestfish-actions.pod:1551
23769 msgid "hexdump"
23770 msgstr ""
23771
23772 #. type: verbatim
23773 #: ../fish/guestfish-actions.pod:1553
23774 #, no-wrap
23775 msgid ""
23776 " hexdump path\n"
23777 "\n"
23778 msgstr ""
23779
23780 #. type: =head2
23781 #: ../fish/guestfish-actions.pod:1561
23782 msgid "initrd-cat"
23783 msgstr ""
23784
23785 #. type: verbatim
23786 #: ../fish/guestfish-actions.pod:1563
23787 #, no-wrap
23788 msgid ""
23789 " initrd-cat initrdpath filename\n"
23790 "\n"
23791 msgstr ""
23792
23793 #. type: textblock
23794 #: ../fish/guestfish-actions.pod:1575
23795 msgid "See also L</initrd-list>."
23796 msgstr ""
23797
23798 #. type: =head2
23799 #: ../fish/guestfish-actions.pod:1580
23800 msgid "initrd-list"
23801 msgstr ""
23802
23803 #. type: verbatim
23804 #: ../fish/guestfish-actions.pod:1582
23805 #, no-wrap
23806 msgid ""
23807 " initrd-list path\n"
23808 "\n"
23809 msgstr ""
23810
23811 #. type: =head2
23812 #: ../fish/guestfish-actions.pod:1594
23813 msgid "inotify-add-watch"
23814 msgstr ""
23815
23816 #. type: verbatim
23817 #: ../fish/guestfish-actions.pod:1596
23818 #, no-wrap
23819 msgid ""
23820 " inotify-add-watch path mask\n"
23821 "\n"
23822 msgstr ""
23823
23824 #. type: =head2
23825 #: ../fish/guestfish-actions.pod:1608
23826 msgid "inotify-close"
23827 msgstr ""
23828
23829 #. type: verbatim
23830 #: ../fish/guestfish-actions.pod:1610
23831 #, no-wrap
23832 msgid ""
23833 " inotify-close\n"
23834 "\n"
23835 msgstr ""
23836
23837 #. type: =head2
23838 #: ../fish/guestfish-actions.pod:1616
23839 msgid "inotify-files"
23840 msgstr ""
23841
23842 #. type: verbatim
23843 #: ../fish/guestfish-actions.pod:1618
23844 #, no-wrap
23845 msgid ""
23846 " inotify-files\n"
23847 "\n"
23848 msgstr ""
23849
23850 #. type: textblock
23851 #: ../fish/guestfish-actions.pod:1620
23852 msgid ""
23853 "This function is a helpful wrapper around L</inotify-read> which just "
23854 "returns a list of pathnames of objects that were touched.  The returned "
23855 "pathnames are sorted and deduplicated."
23856 msgstr ""
23857
23858 #. type: =head2
23859 #: ../fish/guestfish-actions.pod:1624
23860 msgid "inotify-init"
23861 msgstr ""
23862
23863 #. type: verbatim
23864 #: ../fish/guestfish-actions.pod:1626
23865 #, no-wrap
23866 msgid ""
23867 " inotify-init maxevents\n"
23868 "\n"
23869 msgstr ""
23870
23871 #. type: textblock
23872 #: ../fish/guestfish-actions.pod:1632
23873 msgid ""
23874 "C<maxevents> is the maximum number of events which will be queued up between "
23875 "calls to L</inotify-read> or L</inotify-files>.  If this is passed as C<0>, "
23876 "then the kernel (or previously set)  default is used.  For Linux 2.6.29 the "
23877 "default was 16384 events.  Beyond this limit, the kernel throws away events, "
23878 "but records the fact that it threw them away by setting a flag "
23879 "C<IN_Q_OVERFLOW> in the returned structure list (see L</inotify-read>)."
23880 msgstr ""
23881
23882 #. type: textblock
23883 #: ../fish/guestfish-actions.pod:1642
23884 msgid ""
23885 "Before any events are generated, you have to add some watches to the "
23886 "internal watch list.  See: L</inotify-add-watch>, L</inotify-rm-watch> and "
23887 "L</inotify-watch-all>."
23888 msgstr ""
23889
23890 #. type: textblock
23891 #: ../fish/guestfish-actions.pod:1648
23892 msgid ""
23893 "Queued up events should be read periodically by calling L</inotify-read> (or "
23894 "L</inotify-files> which is just a helpful wrapper around L</inotify-read>).  "
23895 "If you don't read the events out often enough then you risk the internal "
23896 "queue overflowing."
23897 msgstr ""
23898
23899 #. type: textblock
23900 #: ../fish/guestfish-actions.pod:1655
23901 msgid ""
23902 "The handle should be closed after use by calling L</inotify-close>.  This "
23903 "also removes any watches automatically."
23904 msgstr ""
23905
23906 #. type: =head2
23907 #: ../fish/guestfish-actions.pod:1664
23908 msgid "inotify-read"
23909 msgstr ""
23910
23911 #. type: verbatim
23912 #: ../fish/guestfish-actions.pod:1666
23913 #, no-wrap
23914 msgid ""
23915 " inotify-read\n"
23916 "\n"
23917 msgstr ""
23918
23919 #. type: =head2
23920 #: ../fish/guestfish-actions.pod:1679
23921 msgid "inotify-rm-watch"
23922 msgstr ""
23923
23924 #. type: verbatim
23925 #: ../fish/guestfish-actions.pod:1681
23926 #, no-wrap
23927 msgid ""
23928 " inotify-rm-watch wd\n"
23929 "\n"
23930 msgstr ""
23931
23932 #. type: textblock
23933 #: ../fish/guestfish-actions.pod:1683
23934 msgid "Remove a previously defined inotify watch.  See L</inotify-add-watch>."
23935 msgstr ""
23936
23937 #. type: =head2
23938 #: ../fish/guestfish-actions.pod:1686
23939 msgid "inspect-get-arch"
23940 msgstr ""
23941
23942 #. type: verbatim
23943 #: ../fish/guestfish-actions.pod:1688
23944 #, no-wrap
23945 msgid ""
23946 " inspect-get-arch root\n"
23947 "\n"
23948 msgstr ""
23949
23950 #. type: textblock
23951 #: ../fish/guestfish-actions.pod:1690 ../fish/guestfish-actions.pod:1706
23952 #: ../fish/guestfish-actions.pod:1792 ../fish/guestfish-actions.pod:1828
23953 #: ../fish/guestfish-actions.pod:1846 ../fish/guestfish-actions.pod:1880
23954 #: ../fish/guestfish-actions.pod:1895 ../fish/guestfish-actions.pod:1916
23955 #: ../fish/guestfish-actions.pod:1931 ../fish/guestfish-actions.pod:1964
23956 #: ../fish/guestfish-actions.pod:1986 ../fish/guestfish-actions.pod:2010
23957 #: ../fish/guestfish-actions.pod:2027 ../fish/guestfish-actions.pod:2070
23958 #: ../fish/guestfish-actions.pod:2105 ../fish/guestfish-actions.pod:2121
23959 #: ../fish/guestfish-actions.pod:2137 ../fish/guestfish-actions.pod:2150
23960 #: ../fish/guestfish-actions.pod:2163 ../fish/guestfish-actions.pod:2178
23961 msgid ""
23962 "This function should only be called with a root device string as returned by "
23963 "L</inspect-os>."
23964 msgstr ""
23965
23966 #. type: textblock
23967 #: ../fish/guestfish-actions.pod:1693
23968 msgid ""
23969 "This returns the architecture of the inspected operating system.  The "
23970 "possible return values are listed under L</file-architecture>."
23971 msgstr ""
23972
23973 #. type: =head2
23974 #: ../fish/guestfish-actions.pod:1702
23975 msgid "inspect-get-distro"
23976 msgstr ""
23977
23978 #. type: verbatim
23979 #: ../fish/guestfish-actions.pod:1704
23980 #, no-wrap
23981 msgid ""
23982 " inspect-get-distro root\n"
23983 "\n"
23984 msgstr ""
23985
23986 #. type: =head2
23987 #: ../fish/guestfish-actions.pod:1788
23988 msgid "inspect-get-drive-mappings"
23989 msgstr ""
23990
23991 #. type: verbatim
23992 #: ../fish/guestfish-actions.pod:1790
23993 #, no-wrap
23994 msgid ""
23995 " inspect-get-drive-mappings root\n"
23996 "\n"
23997 msgstr ""
23998
23999 #. type: textblock
24000 #: ../fish/guestfish-actions.pod:1820
24001 msgid ""
24002 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
24003 "get-mountpoints>, L</inspect-get-filesystems>."
24004 msgstr ""
24005
24006 #. type: =head2
24007 #: ../fish/guestfish-actions.pod:1824
24008 msgid "inspect-get-filesystems"
24009 msgstr ""
24010
24011 #. type: verbatim
24012 #: ../fish/guestfish-actions.pod:1826
24013 #, no-wrap
24014 msgid ""
24015 " inspect-get-filesystems root\n"
24016 "\n"
24017 msgstr ""
24018
24019 #. type: textblock
24020 #: ../fish/guestfish-actions.pod:1839
24021 msgid ""
24022 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
24023 "get-mountpoints>."
24024 msgstr ""
24025
24026 #. type: =head2
24027 #: ../fish/guestfish-actions.pod:1842
24028 msgid "inspect-get-format"
24029 msgstr ""
24030
24031 #. type: verbatim
24032 #: ../fish/guestfish-actions.pod:1844
24033 #, no-wrap
24034 msgid ""
24035 " inspect-get-format root\n"
24036 "\n"
24037 msgstr ""
24038
24039 #. type: =head2
24040 #: ../fish/guestfish-actions.pod:1876
24041 msgid "inspect-get-hostname"
24042 msgstr ""
24043
24044 #. type: verbatim
24045 #: ../fish/guestfish-actions.pod:1878
24046 #, no-wrap
24047 msgid ""
24048 " inspect-get-hostname root\n"
24049 "\n"
24050 msgstr ""
24051
24052 #. type: =head2
24053 #: ../fish/guestfish-actions.pod:1891
24054 msgid "inspect-get-major-version"
24055 msgstr ""
24056
24057 #. type: verbatim
24058 #: ../fish/guestfish-actions.pod:1893
24059 #, no-wrap
24060 msgid ""
24061 " inspect-get-major-version root\n"
24062 "\n"
24063 msgstr ""
24064
24065 #. type: =head2
24066 #: ../fish/guestfish-actions.pod:1912
24067 msgid "inspect-get-minor-version"
24068 msgstr ""
24069
24070 #. type: verbatim
24071 #: ../fish/guestfish-actions.pod:1914
24072 #, no-wrap
24073 msgid ""
24074 " inspect-get-minor-version root\n"
24075 "\n"
24076 msgstr ""
24077
24078 #. type: textblock
24079 #: ../fish/guestfish-actions.pod:1924
24080 msgid ""
24081 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
24082 "get-major-version>."
24083 msgstr ""
24084
24085 #. type: =head2
24086 #: ../fish/guestfish-actions.pod:1927
24087 msgid "inspect-get-mountpoints"
24088 msgstr ""
24089
24090 #. type: verbatim
24091 #: ../fish/guestfish-actions.pod:1929
24092 #, no-wrap
24093 msgid ""
24094 " inspect-get-mountpoints root\n"
24095 "\n"
24096 msgstr ""
24097
24098 #. type: textblock
24099 #: ../fish/guestfish-actions.pod:1951
24100 msgid ""
24101 "For operating systems like Windows which still use drive letters, this call "
24102 "will only return an entry for the first drive \"mounted on\" C</>.  For "
24103 "information about the mapping of drive letters to partitions, see L</inspect-"
24104 "get-drive-mappings>."
24105 msgstr ""
24106
24107 #. type: textblock
24108 #: ../fish/guestfish-actions.pod:1957
24109 msgid ""
24110 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
24111 "get-filesystems>."
24112 msgstr ""
24113
24114 #. type: =head2
24115 #: ../fish/guestfish-actions.pod:1960
24116 msgid "inspect-get-package-format"
24117 msgstr ""
24118
24119 #. type: verbatim
24120 #: ../fish/guestfish-actions.pod:1962
24121 #, no-wrap
24122 msgid ""
24123 " inspect-get-package-format root\n"
24124 "\n"
24125 msgstr ""
24126
24127 #. type: textblock
24128 #: ../fish/guestfish-actions.pod:1967
24129 msgid ""
24130 "This function and L</inspect-get-package-management> return the package "
24131 "format and package management tool used by the inspected operating system.  "
24132 "For example for Fedora these functions would return C<rpm> (package format) "
24133 "and C<yum> (package management)."
24134 msgstr ""
24135
24136 #. type: =head2
24137 #: ../fish/guestfish-actions.pod:1982
24138 msgid "inspect-get-package-management"
24139 msgstr ""
24140
24141 #. type: verbatim
24142 #: ../fish/guestfish-actions.pod:1984
24143 #, no-wrap
24144 msgid ""
24145 " inspect-get-package-management root\n"
24146 "\n"
24147 msgstr ""
24148
24149 #. type: textblock
24150 #: ../fish/guestfish-actions.pod:1989
24151 msgid ""
24152 "L</inspect-get-package-format> and this function return the package format "
24153 "and package management tool used by the inspected operating system.  For "
24154 "example for Fedora these functions would return C<rpm> (package format) and "
24155 "C<yum> (package management)."
24156 msgstr ""
24157
24158 #. type: =head2
24159 #: ../fish/guestfish-actions.pod:2006
24160 msgid "inspect-get-product-name"
24161 msgstr ""
24162
24163 #. type: verbatim
24164 #: ../fish/guestfish-actions.pod:2008
24165 #, no-wrap
24166 msgid ""
24167 " inspect-get-product-name root\n"
24168 "\n"
24169 msgstr ""
24170
24171 #. type: =head2
24172 #: ../fish/guestfish-actions.pod:2023
24173 msgid "inspect-get-product-variant"
24174 msgstr ""
24175
24176 #. type: verbatim
24177 #: ../fish/guestfish-actions.pod:2025
24178 #, no-wrap
24179 msgid ""
24180 " inspect-get-product-variant root\n"
24181 "\n"
24182 msgstr ""
24183
24184 #. type: textblock
24185 #: ../fish/guestfish-actions.pod:2049
24186 msgid ""
24187 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
24188 "get-product-name>, L</inspect-get-major-version>."
24189 msgstr ""
24190
24191 #. type: =head2
24192 #: ../fish/guestfish-actions.pod:2053
24193 msgid "inspect-get-roots"
24194 msgstr ""
24195
24196 #. type: verbatim
24197 #: ../fish/guestfish-actions.pod:2055
24198 #, no-wrap
24199 msgid ""
24200 " inspect-get-roots\n"
24201 "\n"
24202 msgstr ""
24203
24204 #. type: textblock
24205 #: ../fish/guestfish-actions.pod:2057
24206 msgid ""
24207 "This function is a convenient way to get the list of root devices, as "
24208 "returned from a previous call to L</inspect-os>, but without redoing the "
24209 "whole inspection process."
24210 msgstr ""
24211
24212 #. type: textblock
24213 #: ../fish/guestfish-actions.pod:2061
24214 msgid ""
24215 "This returns an empty list if either no root devices were found or the "
24216 "caller has not called L</inspect-os>."
24217 msgstr ""
24218
24219 #. type: =head2
24220 #: ../fish/guestfish-actions.pod:2066
24221 msgid "inspect-get-type"
24222 msgstr ""
24223
24224 #. type: verbatim
24225 #: ../fish/guestfish-actions.pod:2068
24226 #, no-wrap
24227 msgid ""
24228 " inspect-get-type root\n"
24229 "\n"
24230 msgstr ""
24231
24232 #. type: =head2
24233 #: ../fish/guestfish-actions.pod:2101
24234 msgid "inspect-get-windows-current-control-set"
24235 msgstr ""
24236
24237 #. type: verbatim
24238 #: ../fish/guestfish-actions.pod:2103
24239 #, no-wrap
24240 msgid ""
24241 " inspect-get-windows-current-control-set root\n"
24242 "\n"
24243 msgstr ""
24244
24245 #. type: =head2
24246 #: ../fish/guestfish-actions.pod:2117
24247 msgid "inspect-get-windows-systemroot"
24248 msgstr ""
24249
24250 #. type: verbatim
24251 #: ../fish/guestfish-actions.pod:2119
24252 #, no-wrap
24253 msgid ""
24254 " inspect-get-windows-systemroot root\n"
24255 "\n"
24256 msgstr ""
24257
24258 #. type: =head2
24259 #: ../fish/guestfish-actions.pod:2133
24260 msgid "inspect-is-live"
24261 msgstr ""
24262
24263 #. type: verbatim
24264 #: ../fish/guestfish-actions.pod:2135
24265 #, no-wrap
24266 msgid ""
24267 " inspect-is-live root\n"
24268 "\n"
24269 msgstr ""
24270
24271 #. type: textblock
24272 #: ../fish/guestfish-actions.pod:2140
24273 msgid ""
24274 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
24275 "then this returns true if a live image was detected on the disk."
24276 msgstr ""
24277
24278 #. type: =head2
24279 #: ../fish/guestfish-actions.pod:2146
24280 msgid "inspect-is-multipart"
24281 msgstr ""
24282
24283 #. type: verbatim
24284 #: ../fish/guestfish-actions.pod:2148
24285 #, no-wrap
24286 msgid ""
24287 " inspect-is-multipart root\n"
24288 "\n"
24289 msgstr ""
24290
24291 #. type: textblock
24292 #: ../fish/guestfish-actions.pod:2153
24293 msgid ""
24294 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
24295 "then this returns true if the disk is part of a set."
24296 msgstr ""
24297
24298 #. type: =head2
24299 #: ../fish/guestfish-actions.pod:2159
24300 msgid "inspect-is-netinst"
24301 msgstr ""
24302
24303 #. type: verbatim
24304 #: ../fish/guestfish-actions.pod:2161
24305 #, no-wrap
24306 msgid ""
24307 " inspect-is-netinst root\n"
24308 "\n"
24309 msgstr ""
24310
24311 #. type: textblock
24312 #: ../fish/guestfish-actions.pod:2166
24313 msgid ""
24314 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
24315 "then this returns true if the disk is a network installer, ie. not a self-"
24316 "contained install CD but one which is likely to require network access to "
24317 "complete the install."
24318 msgstr ""
24319
24320 #. type: =head2
24321 #: ../fish/guestfish-actions.pod:2174
24322 msgid "inspect-list-applications"
24323 msgstr ""
24324
24325 #. type: verbatim
24326 #: ../fish/guestfish-actions.pod:2176
24327 #, no-wrap
24328 msgid ""
24329 " inspect-list-applications root\n"
24330 "\n"
24331 msgstr ""
24332
24333 #. type: textblock
24334 #: ../fish/guestfish-actions.pod:2183
24335 msgid ""
24336 "I<Note:> This call works differently from other parts of the inspection "
24337 "API.  You have to call L</inspect-os>, then L</inspect-get-mountpoints>, "
24338 "then mount up the disks, before calling this.  Listing applications is a "
24339 "significantly more difficult operation which requires access to the full "
24340 "filesystem.  Also note that unlike the other L</inspect-get-*> calls which "
24341 "are just returning data cached in the libguestfs handle, this call actually "
24342 "reads parts of the mounted filesystems during the call."
24343 msgstr ""
24344
24345 #. type: =head2
24346 #: ../fish/guestfish-actions.pod:2273
24347 msgid "inspect-os"
24348 msgstr ""
24349
24350 #. type: verbatim
24351 #: ../fish/guestfish-actions.pod:2275
24352 #, no-wrap
24353 msgid ""
24354 " inspect-os\n"
24355 "\n"
24356 msgstr ""
24357
24358 #. type: textblock
24359 #: ../fish/guestfish-actions.pod:2290
24360 msgid ""
24361 "You can pass the root string(s) returned to other L</inspect-get-*> "
24362 "functions in order to query further information about each operating system, "
24363 "such as the name and version."
24364 msgstr ""
24365
24366 #. type: textblock
24367 #: ../fish/guestfish-actions.pod:2295
24368 msgid ""
24369 "This function uses other libguestfs features such as L</mount-ro> and L</"
24370 "umount-all> in order to mount and unmount filesystems and look at the "
24371 "contents.  This should be called with no disks currently mounted.  The "
24372 "function may also use Augeas, so any existing Augeas handle will be closed."
24373 msgstr ""
24374
24375 #. type: textblock
24376 #: ../fish/guestfish-actions.pod:2307 ../fish/guestfish-actions.pod:2483
24377 #: ../fish/guestfish-actions.pod:2529
24378 msgid "See also L</list-filesystems>."
24379 msgstr ""
24380
24381 #. type: =head2
24382 #: ../fish/guestfish-actions.pod:2309
24383 msgid "is-blockdev"
24384 msgstr ""
24385
24386 #. type: verbatim
24387 #: ../fish/guestfish-actions.pod:2311
24388 #, no-wrap
24389 msgid ""
24390 " is-blockdev path\n"
24391 "\n"
24392 msgstr ""
24393
24394 #. type: textblock
24395 #: ../fish/guestfish-actions.pod:2316 ../fish/guestfish-actions.pod:2334
24396 #: ../fish/guestfish-actions.pod:2353 ../fish/guestfish-actions.pod:2362
24397 #: ../fish/guestfish-actions.pod:2372 ../fish/guestfish-actions.pod:2406
24398 #: ../fish/guestfish-actions.pod:2415
24399 msgid "See also L</stat>."
24400 msgstr ""
24401
24402 #. type: =head2
24403 #: ../fish/guestfish-actions.pod:2318
24404 msgid "is-busy"
24405 msgstr ""
24406
24407 #. type: verbatim
24408 #: ../fish/guestfish-actions.pod:2320
24409 #, no-wrap
24410 msgid ""
24411 " is-busy\n"
24412 "\n"
24413 msgstr ""
24414
24415 #. type: =head2
24416 #: ../fish/guestfish-actions.pod:2327
24417 msgid "is-chardev"
24418 msgstr ""
24419
24420 #. type: verbatim
24421 #: ../fish/guestfish-actions.pod:2329
24422 #, no-wrap
24423 msgid ""
24424 " is-chardev path\n"
24425 "\n"
24426 msgstr ""
24427
24428 #. type: =head2
24429 #: ../fish/guestfish-actions.pod:2336
24430 msgid "is-config"
24431 msgstr ""
24432
24433 #. type: verbatim
24434 #: ../fish/guestfish-actions.pod:2338
24435 #, no-wrap
24436 msgid ""
24437 " is-config\n"
24438 "\n"
24439 msgstr ""
24440
24441 #. type: =head2
24442 #: ../fish/guestfish-actions.pod:2345
24443 msgid "is-dir"
24444 msgstr ""
24445
24446 #. type: verbatim
24447 #: ../fish/guestfish-actions.pod:2347
24448 #, no-wrap
24449 msgid ""
24450 " is-dir path\n"
24451 "\n"
24452 msgstr ""
24453
24454 #. type: =head2
24455 #: ../fish/guestfish-actions.pod:2355
24456 msgid "is-fifo"
24457 msgstr ""
24458
24459 #. type: verbatim
24460 #: ../fish/guestfish-actions.pod:2357
24461 #, no-wrap
24462 msgid ""
24463 " is-fifo path\n"
24464 "\n"
24465 msgstr ""
24466
24467 #. type: =head2
24468 #: ../fish/guestfish-actions.pod:2364
24469 msgid "is-file"
24470 msgstr ""
24471
24472 #. type: verbatim
24473 #: ../fish/guestfish-actions.pod:2366
24474 #, no-wrap
24475 msgid ""
24476 " is-file path\n"
24477 "\n"
24478 msgstr ""
24479
24480 #. type: =head2
24481 #: ../fish/guestfish-actions.pod:2374
24482 msgid "is-launching"
24483 msgstr ""
24484
24485 #. type: verbatim
24486 #: ../fish/guestfish-actions.pod:2376
24487 #, no-wrap
24488 msgid ""
24489 " is-launching\n"
24490 "\n"
24491 msgstr ""
24492
24493 #. type: =head2
24494 #: ../fish/guestfish-actions.pod:2383
24495 msgid "is-lv"
24496 msgstr ""
24497
24498 #. type: verbatim
24499 #: ../fish/guestfish-actions.pod:2385
24500 #, no-wrap
24501 msgid ""
24502 " is-lv device\n"
24503 "\n"
24504 msgstr ""
24505
24506 #. type: =head2
24507 #: ../fish/guestfish-actions.pod:2390
24508 msgid "is-ready"
24509 msgstr ""
24510
24511 #. type: verbatim
24512 #: ../fish/guestfish-actions.pod:2392
24513 #, no-wrap
24514 msgid ""
24515 " is-ready\n"
24516 "\n"
24517 msgstr ""
24518
24519 #. type: =head2
24520 #: ../fish/guestfish-actions.pod:2399
24521 msgid "is-socket"
24522 msgstr ""
24523
24524 #. type: verbatim
24525 #: ../fish/guestfish-actions.pod:2401
24526 #, no-wrap
24527 msgid ""
24528 " is-socket path\n"
24529 "\n"
24530 msgstr ""
24531
24532 #. type: =head2
24533 #: ../fish/guestfish-actions.pod:2408
24534 msgid "is-symlink"
24535 msgstr ""
24536
24537 #. type: verbatim
24538 #: ../fish/guestfish-actions.pod:2410
24539 #, no-wrap
24540 msgid ""
24541 " is-symlink path\n"
24542 "\n"
24543 msgstr ""
24544
24545 #. type: =head2
24546 #: ../fish/guestfish-actions.pod:2417
24547 msgid "kill-subprocess"
24548 msgstr ""
24549
24550 #. type: verbatim
24551 #: ../fish/guestfish-actions.pod:2419
24552 #, no-wrap
24553 msgid ""
24554 " kill-subprocess\n"
24555 "\n"
24556 msgstr ""
24557
24558 #. type: =head2
24559 #: ../fish/guestfish-actions.pod:2423
24560 msgid "launch"
24561 msgstr ""
24562
24563 #. type: =head2
24564 #: ../fish/guestfish-actions.pod:2425
24565 msgid "run"
24566 msgstr ""
24567
24568 #. type: verbatim
24569 #: ../fish/guestfish-actions.pod:2427
24570 #, no-wrap
24571 msgid ""
24572 " launch\n"
24573 "\n"
24574 msgstr ""
24575
24576 #. type: =head2
24577 #: ../fish/guestfish-actions.pod:2435
24578 msgid "lchown"
24579 msgstr ""
24580
24581 #. type: verbatim
24582 #: ../fish/guestfish-actions.pod:2437
24583 #, no-wrap
24584 msgid ""
24585 " lchown owner group path\n"
24586 "\n"
24587 msgstr ""
24588
24589 #. type: textblock
24590 #: ../fish/guestfish-actions.pod:2439
24591 msgid ""
24592 "Change the file owner to C<owner> and group to C<group>.  This is like L</"
24593 "chown> but if C<path> is a symlink then the link itself is changed, not the "
24594 "target."
24595 msgstr ""
24596
24597 #. type: =head2
24598 #: ../fish/guestfish-actions.pod:2447
24599 msgid "lgetxattr"
24600 msgstr ""
24601
24602 #. type: verbatim
24603 #: ../fish/guestfish-actions.pod:2449
24604 #, no-wrap
24605 msgid ""
24606 " lgetxattr path name\n"
24607 "\n"
24608 msgstr ""
24609
24610 #. type: textblock
24611 #: ../fish/guestfish-actions.pod:2465
24612 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>."
24613 msgstr ""
24614
24615 #. type: =head2
24616 #: ../fish/guestfish-actions.pod:2467
24617 msgid "lgetxattrs"
24618 msgstr ""
24619
24620 #. type: verbatim
24621 #: ../fish/guestfish-actions.pod:2469
24622 #, no-wrap
24623 msgid ""
24624 " lgetxattrs path\n"
24625 "\n"
24626 msgstr ""
24627
24628 #. type: textblock
24629 #: ../fish/guestfish-actions.pod:2471
24630 msgid ""
24631 "This is the same as L</getxattrs>, but if C<path> is a symbolic link, then "
24632 "it returns the extended attributes of the link itself."
24633 msgstr ""
24634
24635 #. type: =head2
24636 #: ../fish/guestfish-actions.pod:2475
24637 msgid "list-devices"
24638 msgstr ""
24639
24640 #. type: verbatim
24641 #: ../fish/guestfish-actions.pod:2477
24642 #, no-wrap
24643 msgid ""
24644 " list-devices\n"
24645 "\n"
24646 msgstr ""
24647
24648 #. type: =head2
24649 #: ../fish/guestfish-actions.pod:2485
24650 msgid "list-filesystems"
24651 msgstr ""
24652
24653 #. type: verbatim
24654 #: ../fish/guestfish-actions.pod:2487
24655 #, no-wrap
24656 msgid ""
24657 " list-filesystems\n"
24658 "\n"
24659 msgstr ""
24660
24661 #. type: textblock
24662 #: ../fish/guestfish-actions.pod:2506
24663 msgid ""
24664 "This command runs other libguestfs commands, which might include L</mount> "
24665 "and L</umount>, and therefore you should use this soon after launch and only "
24666 "when nothing is mounted."
24667 msgstr ""
24668
24669 #. type: textblock
24670 #: ../fish/guestfish-actions.pod:2510
24671 msgid ""
24672 "Not all of the filesystems returned will be mountable.  In particular, swap "
24673 "partitions are returned in the list.  Also this command does not check that "
24674 "each filesystem found is valid and mountable, and some filesystems might be "
24675 "mountable but require special options.  Filesystems may not all belong to a "
24676 "single logical operating system (use L</inspect-os> to look for OSes)."
24677 msgstr ""
24678
24679 #. type: =head2
24680 #: ../fish/guestfish-actions.pod:2518
24681 msgid "list-partitions"
24682 msgstr ""
24683
24684 #. type: verbatim
24685 #: ../fish/guestfish-actions.pod:2520
24686 #, no-wrap
24687 msgid ""
24688 " list-partitions\n"
24689 "\n"
24690 msgstr ""
24691
24692 #. type: textblock
24693 #: ../fish/guestfish-actions.pod:2526
24694 msgid ""
24695 "This does not return logical volumes.  For that you will need to call L</"
24696 "lvs>."
24697 msgstr ""
24698
24699 #. type: =head2
24700 #: ../fish/guestfish-actions.pod:2531
24701 msgid "ll"
24702 msgstr ""
24703
24704 #. type: verbatim
24705 #: ../fish/guestfish-actions.pod:2533
24706 #, no-wrap
24707 msgid ""
24708 " ll directory\n"
24709 "\n"
24710 msgstr ""
24711
24712 #. type: =head2
24713 #: ../fish/guestfish-actions.pod:2541
24714 msgid "ln"
24715 msgstr ""
24716
24717 #. type: verbatim
24718 #: ../fish/guestfish-actions.pod:2543
24719 #, no-wrap
24720 msgid ""
24721 " ln target linkname\n"
24722 "\n"
24723 msgstr ""
24724
24725 #. type: =head2
24726 #: ../fish/guestfish-actions.pod:2547
24727 msgid "ln-f"
24728 msgstr ""
24729
24730 #. type: verbatim
24731 #: ../fish/guestfish-actions.pod:2549
24732 #, no-wrap
24733 msgid ""
24734 " ln-f target linkname\n"
24735 "\n"
24736 msgstr ""
24737
24738 #. type: =head2
24739 #: ../fish/guestfish-actions.pod:2554
24740 msgid "ln-s"
24741 msgstr ""
24742
24743 #. type: verbatim
24744 #: ../fish/guestfish-actions.pod:2556
24745 #, no-wrap
24746 msgid ""
24747 " ln-s target linkname\n"
24748 "\n"
24749 msgstr ""
24750
24751 #. type: =head2
24752 #: ../fish/guestfish-actions.pod:2560
24753 msgid "ln-sf"
24754 msgstr ""
24755
24756 #. type: verbatim
24757 #: ../fish/guestfish-actions.pod:2562
24758 #, no-wrap
24759 msgid ""
24760 " ln-sf target linkname\n"
24761 "\n"
24762 msgstr ""
24763
24764 #. type: =head2
24765 #: ../fish/guestfish-actions.pod:2567
24766 msgid "lremovexattr"
24767 msgstr ""
24768
24769 #. type: verbatim
24770 #: ../fish/guestfish-actions.pod:2569
24771 #, no-wrap
24772 msgid ""
24773 " lremovexattr xattr path\n"
24774 "\n"
24775 msgstr ""
24776
24777 #. type: textblock
24778 #: ../fish/guestfish-actions.pod:2571
24779 msgid ""
24780 "This is the same as L</removexattr>, but if C<path> is a symbolic link, then "
24781 "it removes an extended attribute of the link itself."
24782 msgstr ""
24783
24784 #. type: =head2
24785 #: ../fish/guestfish-actions.pod:2575
24786 msgid "ls"
24787 msgstr ""
24788
24789 #. type: verbatim
24790 #: ../fish/guestfish-actions.pod:2577
24791 #, no-wrap
24792 msgid ""
24793 " ls directory\n"
24794 "\n"
24795 msgstr ""
24796
24797 #. type: textblock
24798 #: ../fish/guestfish-actions.pod:2583
24799 msgid ""
24800 "This command is mostly useful for interactive sessions.  Programs should "
24801 "probably use L</readdir> instead."
24802 msgstr ""
24803
24804 #. type: =head2
24805 #: ../fish/guestfish-actions.pod:2586
24806 msgid "lsetxattr"
24807 msgstr ""
24808
24809 #. type: verbatim
24810 #: ../fish/guestfish-actions.pod:2588
24811 #, no-wrap
24812 msgid ""
24813 " lsetxattr xattr val vallen path\n"
24814 "\n"
24815 msgstr ""
24816
24817 #. type: textblock
24818 #: ../fish/guestfish-actions.pod:2590
24819 msgid ""
24820 "This is the same as L</setxattr>, but if C<path> is a symbolic link, then it "
24821 "sets an extended attribute of the link itself."
24822 msgstr ""
24823
24824 #. type: =head2
24825 #: ../fish/guestfish-actions.pod:2594
24826 msgid "lstat"
24827 msgstr ""
24828
24829 #. type: verbatim
24830 #: ../fish/guestfish-actions.pod:2596
24831 #, no-wrap
24832 msgid ""
24833 " lstat path\n"
24834 "\n"
24835 msgstr ""
24836
24837 #. type: textblock
24838 #: ../fish/guestfish-actions.pod:2600
24839 msgid ""
24840 "This is the same as L</stat> except that if C<path> is a symbolic link, then "
24841 "the link is stat-ed, not the file it refers to."
24842 msgstr ""
24843
24844 #. type: =head2
24845 #: ../fish/guestfish-actions.pod:2606
24846 msgid "lstatlist"
24847 msgstr ""
24848
24849 #. type: verbatim
24850 #: ../fish/guestfish-actions.pod:2608
24851 #, no-wrap
24852 msgid ""
24853 " lstatlist path 'names ...'\n"
24854 "\n"
24855 msgstr ""
24856
24857 #. type: textblock
24858 #: ../fish/guestfish-actions.pod:2610
24859 msgid ""
24860 "This call allows you to perform the L</lstat> operation on multiple files, "
24861 "where all files are in the directory C<path>.  C<names> is the list of files "
24862 "from this directory."
24863 msgstr ""
24864
24865 #. type: textblock
24866 #: ../fish/guestfish-actions.pod:2619
24867 msgid ""
24868 "This call is intended for programs that want to efficiently list a directory "
24869 "contents without making many round-trips.  See also L</lxattrlist> for a "
24870 "similarly efficient call for getting extended attributes.  Very long "
24871 "directory listings might cause the protocol message size to be exceeded, "
24872 "causing this call to fail.  The caller must split up such requests into "
24873 "smaller groups of names."
24874 msgstr ""
24875
24876 #. type: =head2
24877 #: ../fish/guestfish-actions.pod:2627
24878 msgid "luks-add-key"
24879 msgstr ""
24880
24881 #. type: verbatim
24882 #: ../fish/guestfish-actions.pod:2629
24883 #, no-wrap
24884 msgid ""
24885 " luks-add-key device keyslot\n"
24886 "\n"
24887 msgstr ""
24888
24889 #. type: textblock
24890 #: ../fish/guestfish-actions.pod:2636
24891 msgid ""
24892 "Note that if C<keyslot> already contains a key, then this command will "
24893 "fail.  You have to use L</luks-kill-slot> first to remove that key."
24894 msgstr ""
24895
24896 #. type: textblock
24897 #: ../fish/guestfish-actions.pod:2640 ../fish/guestfish-actions.pod:2662
24898 #: ../fish/guestfish-actions.pod:2675 ../fish/guestfish-actions.pod:2689
24899 #: ../fish/guestfish-actions.pod:2712 ../fish/guestfish-actions.pod:2722
24900 msgid ""
24901 "This command has one or more key or passphrase parameters.  Guestfish will "
24902 "prompt for these separately."
24903 msgstr ""
24904
24905 #. type: =head2
24906 #: ../fish/guestfish-actions.pod:2643
24907 msgid "luks-close"
24908 msgstr ""
24909
24910 #. type: verbatim
24911 #: ../fish/guestfish-actions.pod:2645
24912 #, no-wrap
24913 msgid ""
24914 " luks-close device\n"
24915 "\n"
24916 msgstr ""
24917
24918 #. type: textblock
24919 #: ../fish/guestfish-actions.pod:2647
24920 msgid ""
24921 "This closes a LUKS device that was created earlier by L</luks-open> or L</"
24922 "luks-open-ro>.  The C<device> parameter must be the name of the LUKS mapping "
24923 "device (ie. C</dev/mapper/mapname>) and I<not> the name of the underlying "
24924 "block device."
24925 msgstr ""
24926
24927 #. type: =head2
24928 #: ../fish/guestfish-actions.pod:2653
24929 msgid "luks-format"
24930 msgstr ""
24931
24932 #. type: verbatim
24933 #: ../fish/guestfish-actions.pod:2655
24934 #, no-wrap
24935 msgid ""
24936 " luks-format device keyslot\n"
24937 "\n"
24938 msgstr ""
24939
24940 #. type: =head2
24941 #: ../fish/guestfish-actions.pod:2668
24942 msgid "luks-format-cipher"
24943 msgstr ""
24944
24945 #. type: verbatim
24946 #: ../fish/guestfish-actions.pod:2670
24947 #, no-wrap
24948 msgid ""
24949 " luks-format-cipher device keyslot cipher\n"
24950 "\n"
24951 msgstr ""
24952
24953 #. type: textblock
24954 #: ../fish/guestfish-actions.pod:2672
24955 msgid ""
24956 "This command is the same as L</luks-format> but it also allows you to set "
24957 "the C<cipher> used."
24958 msgstr ""
24959
24960 #. type: =head2
24961 #: ../fish/guestfish-actions.pod:2681
24962 msgid "luks-kill-slot"
24963 msgstr ""
24964
24965 #. type: verbatim
24966 #: ../fish/guestfish-actions.pod:2683
24967 #, no-wrap
24968 msgid ""
24969 " luks-kill-slot device keyslot\n"
24970 "\n"
24971 msgstr ""
24972
24973 #. type: =head2
24974 #: ../fish/guestfish-actions.pod:2692
24975 msgid "luks-open"
24976 msgstr ""
24977
24978 #. type: verbatim
24979 #: ../fish/guestfish-actions.pod:2694
24980 #, no-wrap
24981 msgid ""
24982 " luks-open device mapname\n"
24983 "\n"
24984 msgstr ""
24985
24986 #. type: textblock
24987 #: ../fish/guestfish-actions.pod:2708
24988 msgid ""
24989 "If this block device contains LVM volume groups, then calling L</vgscan> "
24990 "followed by L</vg-activate-all> will make them visible."
24991 msgstr ""
24992
24993 #. type: =head2
24994 #: ../fish/guestfish-actions.pod:2715
24995 msgid "luks-open-ro"
24996 msgstr ""
24997
24998 #. type: verbatim
24999 #: ../fish/guestfish-actions.pod:2717
25000 #, no-wrap
25001 msgid ""
25002 " luks-open-ro device mapname\n"
25003 "\n"
25004 msgstr ""
25005
25006 #. type: textblock
25007 #: ../fish/guestfish-actions.pod:2719
25008 msgid ""
25009 "This is the same as L</luks-open> except that a read-only mapping is created."
25010 msgstr ""
25011
25012 #. type: =head2
25013 #: ../fish/guestfish-actions.pod:2725
25014 msgid "lvcreate"
25015 msgstr ""
25016
25017 #. type: verbatim
25018 #: ../fish/guestfish-actions.pod:2727
25019 #, no-wrap
25020 msgid ""
25021 " lvcreate logvol volgroup mbytes\n"
25022 "\n"
25023 msgstr ""
25024
25025 #. type: =head2
25026 #: ../fish/guestfish-actions.pod:2732
25027 msgid "lvm-canonical-lv-name"
25028 msgstr ""
25029
25030 #. type: verbatim
25031 #: ../fish/guestfish-actions.pod:2734
25032 #, no-wrap
25033 msgid ""
25034 " lvm-canonical-lv-name lvname\n"
25035 "\n"
25036 msgstr ""
25037
25038 #. type: textblock
25039 #: ../fish/guestfish-actions.pod:2743
25040 msgid "See also L</is-lv>."
25041 msgstr ""
25042
25043 #. type: =head2
25044 #: ../fish/guestfish-actions.pod:2745
25045 msgid "lvm-clear-filter"
25046 msgstr ""
25047
25048 #. type: verbatim
25049 #: ../fish/guestfish-actions.pod:2747
25050 #, no-wrap
25051 msgid ""
25052 " lvm-clear-filter\n"
25053 "\n"
25054 msgstr ""
25055
25056 #. type: textblock
25057 #: ../fish/guestfish-actions.pod:2749
25058 msgid ""
25059 "This undoes the effect of L</lvm-set-filter>.  LVM will be able to see every "
25060 "block device."
25061 msgstr ""
25062
25063 #. type: =head2
25064 #: ../fish/guestfish-actions.pod:2755
25065 msgid "lvm-remove-all"
25066 msgstr ""
25067
25068 #. type: verbatim
25069 #: ../fish/guestfish-actions.pod:2757
25070 #, no-wrap
25071 msgid ""
25072 " lvm-remove-all\n"
25073 "\n"
25074 msgstr ""
25075
25076 #. type: =head2
25077 #: ../fish/guestfish-actions.pod:2765
25078 msgid "lvm-set-filter"
25079 msgstr ""
25080
25081 #. type: verbatim
25082 #: ../fish/guestfish-actions.pod:2767
25083 #, no-wrap
25084 msgid ""
25085 " lvm-set-filter 'devices ...'\n"
25086 "\n"
25087 msgstr ""
25088
25089 #. type: =head2
25090 #: ../fish/guestfish-actions.pod:2792
25091 msgid "lvremove"
25092 msgstr ""
25093
25094 #. type: verbatim
25095 #: ../fish/guestfish-actions.pod:2794
25096 #, no-wrap
25097 msgid ""
25098 " lvremove device\n"
25099 "\n"
25100 msgstr ""
25101
25102 #. type: =head2
25103 #: ../fish/guestfish-actions.pod:2802
25104 msgid "lvrename"
25105 msgstr ""
25106
25107 #. type: verbatim
25108 #: ../fish/guestfish-actions.pod:2804
25109 #, no-wrap
25110 msgid ""
25111 " lvrename logvol newlogvol\n"
25112 "\n"
25113 msgstr ""
25114
25115 #. type: =head2
25116 #: ../fish/guestfish-actions.pod:2808
25117 msgid "lvresize"
25118 msgstr ""
25119
25120 #. type: verbatim
25121 #: ../fish/guestfish-actions.pod:2810
25122 #, no-wrap
25123 msgid ""
25124 " lvresize device mbytes\n"
25125 "\n"
25126 msgstr ""
25127
25128 #. type: =head2
25129 #: ../fish/guestfish-actions.pod:2816
25130 msgid "lvresize-free"
25131 msgstr ""
25132
25133 #. type: verbatim
25134 #: ../fish/guestfish-actions.pod:2818
25135 #, no-wrap
25136 msgid ""
25137 " lvresize-free lv percent\n"
25138 "\n"
25139 msgstr ""
25140
25141 #. type: =head2
25142 #: ../fish/guestfish-actions.pod:2826
25143 msgid "lvs"
25144 msgstr ""
25145
25146 #. type: verbatim
25147 #: ../fish/guestfish-actions.pod:2828
25148 #, no-wrap
25149 msgid ""
25150 " lvs\n"
25151 "\n"
25152 msgstr ""
25153
25154 #. type: textblock
25155 #: ../fish/guestfish-actions.pod:2836
25156 msgid "See also L</lvs-full>, L</list-filesystems>."
25157 msgstr ""
25158
25159 #. type: =head2
25160 #: ../fish/guestfish-actions.pod:2838
25161 msgid "lvs-full"
25162 msgstr ""
25163
25164 #. type: verbatim
25165 #: ../fish/guestfish-actions.pod:2840
25166 #, no-wrap
25167 msgid ""
25168 " lvs-full\n"
25169 "\n"
25170 msgstr ""
25171
25172 #. type: =head2
25173 #: ../fish/guestfish-actions.pod:2845
25174 msgid "lvuuid"
25175 msgstr ""
25176
25177 #. type: verbatim
25178 #: ../fish/guestfish-actions.pod:2847
25179 #, no-wrap
25180 msgid ""
25181 " lvuuid device\n"
25182 "\n"
25183 msgstr ""
25184
25185 #. type: =head2
25186 #: ../fish/guestfish-actions.pod:2851
25187 msgid "lxattrlist"
25188 msgstr ""
25189
25190 #. type: verbatim
25191 #: ../fish/guestfish-actions.pod:2853
25192 #, no-wrap
25193 msgid ""
25194 " lxattrlist path 'names ...'\n"
25195 "\n"
25196 msgstr ""
25197
25198 #. type: textblock
25199 #: ../fish/guestfish-actions.pod:2869
25200 msgid ""
25201 "This call is intended for programs that want to efficiently list a directory "
25202 "contents without making many round-trips.  See also L</lstatlist> for a "
25203 "similarly efficient call for getting standard stats.  Very long directory "
25204 "listings might cause the protocol message size to be exceeded, causing this "
25205 "call to fail.  The caller must split up such requests into smaller groups of "
25206 "names."
25207 msgstr ""
25208
25209 #. type: =head2
25210 #: ../fish/guestfish-actions.pod:2877
25211 msgid "mkdir"
25212 msgstr ""
25213
25214 #. type: verbatim
25215 #: ../fish/guestfish-actions.pod:2879
25216 #, no-wrap
25217 msgid ""
25218 " mkdir path\n"
25219 "\n"
25220 msgstr ""
25221
25222 #. type: =head2
25223 #: ../fish/guestfish-actions.pod:2883
25224 msgid "mkdir-mode"
25225 msgstr ""
25226
25227 #. type: verbatim
25228 #: ../fish/guestfish-actions.pod:2885
25229 #, no-wrap
25230 msgid ""
25231 " mkdir-mode path mode\n"
25232 "\n"
25233 msgstr ""
25234
25235 #. type: textblock
25236 #: ../fish/guestfish-actions.pod:2894
25237 msgid "See also L</mkdir>, L</umask>"
25238 msgstr ""
25239
25240 #. type: =head2
25241 #: ../fish/guestfish-actions.pod:2896
25242 msgid "mkdir-p"
25243 msgstr ""
25244
25245 #. type: verbatim
25246 #: ../fish/guestfish-actions.pod:2898
25247 #, no-wrap
25248 msgid ""
25249 " mkdir-p path\n"
25250 "\n"
25251 msgstr ""
25252
25253 #. type: =head2
25254 #: ../fish/guestfish-actions.pod:2903
25255 msgid "mkdtemp"
25256 msgstr ""
25257
25258 #. type: verbatim
25259 #: ../fish/guestfish-actions.pod:2905
25260 #, no-wrap
25261 msgid ""
25262 " mkdtemp template\n"
25263 "\n"
25264 msgstr ""
25265
25266 #. type: =head2
25267 #: ../fish/guestfish-actions.pod:2926
25268 msgid "mke2fs-J"
25269 msgstr ""
25270
25271 #. type: verbatim
25272 #: ../fish/guestfish-actions.pod:2928
25273 #, no-wrap
25274 msgid ""
25275 " mke2fs-J fstype blocksize device journal\n"
25276 "\n"
25277 msgstr ""
25278
25279 #. type: textblock
25280 #: ../fish/guestfish-actions.pod:2936
25281 msgid "See also L</mke2journal>."
25282 msgstr ""
25283
25284 #. type: =head2
25285 #: ../fish/guestfish-actions.pod:2938
25286 msgid "mke2fs-JL"
25287 msgstr ""
25288
25289 #. type: verbatim
25290 #: ../fish/guestfish-actions.pod:2940
25291 #, no-wrap
25292 msgid ""
25293 " mke2fs-JL fstype blocksize device label\n"
25294 "\n"
25295 msgstr ""
25296
25297 #. type: textblock
25298 #: ../fish/guestfish-actions.pod:2945
25299 msgid "See also L</mke2journal-L>."
25300 msgstr ""
25301
25302 #. type: =head2
25303 #: ../fish/guestfish-actions.pod:2947
25304 msgid "mke2fs-JU"
25305 msgstr ""
25306
25307 #. type: verbatim
25308 #: ../fish/guestfish-actions.pod:2949
25309 #, no-wrap
25310 msgid ""
25311 " mke2fs-JU fstype blocksize device uuid\n"
25312 "\n"
25313 msgstr ""
25314
25315 #. type: textblock
25316 #: ../fish/guestfish-actions.pod:2954
25317 msgid "See also L</mke2journal-U>."
25318 msgstr ""
25319
25320 #. type: =head2
25321 #: ../fish/guestfish-actions.pod:2956
25322 msgid "mke2journal"
25323 msgstr ""
25324
25325 #. type: verbatim
25326 #: ../fish/guestfish-actions.pod:2958
25327 #, no-wrap
25328 msgid ""
25329 " mke2journal blocksize device\n"
25330 "\n"
25331 msgstr ""
25332
25333 #. type: =head2
25334 #: ../fish/guestfish-actions.pod:2965
25335 msgid "mke2journal-L"
25336 msgstr ""
25337
25338 #. type: verbatim
25339 #: ../fish/guestfish-actions.pod:2967
25340 #, no-wrap
25341 msgid ""
25342 " mke2journal-L blocksize label device\n"
25343 "\n"
25344 msgstr ""
25345
25346 #. type: =head2
25347 #: ../fish/guestfish-actions.pod:2971
25348 msgid "mke2journal-U"
25349 msgstr ""
25350
25351 #. type: verbatim
25352 #: ../fish/guestfish-actions.pod:2973
25353 #, no-wrap
25354 msgid ""
25355 " mke2journal-U blocksize uuid device\n"
25356 "\n"
25357 msgstr ""
25358
25359 #. type: =head2
25360 #: ../fish/guestfish-actions.pod:2977
25361 msgid "mkfifo"
25362 msgstr ""
25363
25364 #. type: verbatim
25365 #: ../fish/guestfish-actions.pod:2979
25366 #, no-wrap
25367 msgid ""
25368 " mkfifo mode path\n"
25369 "\n"
25370 msgstr ""
25371
25372 #. type: textblock
25373 #: ../fish/guestfish-actions.pod:2981
25374 msgid ""
25375 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
25376 "is just a convenient wrapper around L</mknod>."
25377 msgstr ""
25378
25379 #. type: =head2
25380 #: ../fish/guestfish-actions.pod:2987
25381 msgid "mkfs"
25382 msgstr ""
25383
25384 #. type: verbatim
25385 #: ../fish/guestfish-actions.pod:2989
25386 #, no-wrap
25387 msgid ""
25388 " mkfs fstype device\n"
25389 "\n"
25390 msgstr ""
25391
25392 #. type: =head2
25393 #: ../fish/guestfish-actions.pod:2995
25394 msgid "mkfs-b"
25395 msgstr ""
25396
25397 #. type: verbatim
25398 #: ../fish/guestfish-actions.pod:2997
25399 #, no-wrap
25400 msgid ""
25401 " mkfs-b fstype blocksize device\n"
25402 "\n"
25403 msgstr ""
25404
25405 #. type: textblock
25406 #: ../fish/guestfish-actions.pod:2999
25407 msgid ""
25408 "This call is similar to L</mkfs>, but it allows you to control the block "
25409 "size of the resulting filesystem.  Supported block sizes depend on the "
25410 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
25411 msgstr ""
25412
25413 #. type: textblock
25414 #: ../fish/guestfish-actions.pod:3007
25415 msgid ""
25416 "This function is deprecated.  In new code, use the L</mkfs_opts> call "
25417 "instead."
25418 msgstr ""
25419
25420 #. type: =head2
25421 #: ../fish/guestfish-actions.pod:3014
25422 msgid "mkfs-opts"
25423 msgstr ""
25424
25425 #. type: verbatim
25426 #: ../fish/guestfish-actions.pod:3016
25427 #, no-wrap
25428 msgid ""
25429 " mkfs-opts fstype device [blocksize:..] [features:..]\n"
25430 "\n"
25431 msgstr ""
25432
25433 #. type: =head2
25434 #: ../fish/guestfish-actions.pod:3051
25435 msgid "mkmountpoint"
25436 msgstr ""
25437
25438 #. type: verbatim
25439 #: ../fish/guestfish-actions.pod:3053
25440 #, no-wrap
25441 msgid ""
25442 " mkmountpoint exemptpath\n"
25443 "\n"
25444 msgstr ""
25445
25446 #. type: textblock
25447 #: ../fish/guestfish-actions.pod:3055
25448 msgid ""
25449 "L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used "
25450 "to create extra mountpoints before mounting the first filesystem."
25451 msgstr ""
25452
25453 #. type: textblock
25454 #: ../fish/guestfish-actions.pod:3079
25455 msgid ""
25456 "L</mkmountpoint> is not compatible with L</umount-all>.  You may get "
25457 "unexpected errors if you try to mix these calls.  It is safest to manually "
25458 "unmount filesystems and remove mountpoints after use."
25459 msgstr ""
25460
25461 #. type: textblock
25462 #: ../fish/guestfish-actions.pod:3083
25463 msgid ""
25464 "L</umount-all> unmounts filesystems by sorting the paths longest first, so "
25465 "for this to work for manual mountpoints, you must ensure that the innermost "
25466 "mountpoints have the longest pathnames, as in the example code above."
25467 msgstr ""
25468
25469 #. type: textblock
25470 #: ../fish/guestfish-actions.pod:3090
25471 msgid ""
25472 "Autosync [see L</set-autosync>, this is set by default on handles] can cause "
25473 "L</umount-all> to be called when the handle is closed which can also trigger "
25474 "these issues."
25475 msgstr ""
25476
25477 #. type: =head2
25478 #: ../fish/guestfish-actions.pod:3094
25479 msgid "mknod"
25480 msgstr ""
25481
25482 #. type: verbatim
25483 #: ../fish/guestfish-actions.pod:3096
25484 #, no-wrap
25485 msgid ""
25486 " mknod mode devmajor devminor path\n"
25487 "\n"
25488 msgstr ""
25489
25490 #. type: textblock
25491 #: ../fish/guestfish-actions.pod:3106
25492 msgid ""
25493 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
25494 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
25495 "regular file).  These constants are available in the standard Linux header "
25496 "files, or you can use L</mknod-b>, L</mknod-c> or L</mkfifo> which are "
25497 "wrappers around this command which bitwise OR in the appropriate constant "
25498 "for you."
25499 msgstr ""
25500
25501 #. type: =head2
25502 #: ../fish/guestfish-actions.pod:3116
25503 msgid "mknod-b"
25504 msgstr ""
25505
25506 #. type: verbatim
25507 #: ../fish/guestfish-actions.pod:3118
25508 #, no-wrap
25509 msgid ""
25510 " mknod-b mode devmajor devminor path\n"
25511 "\n"
25512 msgstr ""
25513
25514 #. type: textblock
25515 #: ../fish/guestfish-actions.pod:3120
25516 msgid ""
25517 "This call creates a block device node called C<path> with mode C<mode> and "
25518 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
25519 "wrapper around L</mknod>."
25520 msgstr ""
25521
25522 #. type: =head2
25523 #: ../fish/guestfish-actions.pod:3126
25524 msgid "mknod-c"
25525 msgstr ""
25526
25527 #. type: verbatim
25528 #: ../fish/guestfish-actions.pod:3128
25529 #, no-wrap
25530 msgid ""
25531 " mknod-c mode devmajor devminor path\n"
25532 "\n"
25533 msgstr ""
25534
25535 #. type: textblock
25536 #: ../fish/guestfish-actions.pod:3130
25537 msgid ""
25538 "This call creates a char device node called C<path> with mode C<mode> and "
25539 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
25540 "wrapper around L</mknod>."
25541 msgstr ""
25542
25543 #. type: =head2
25544 #: ../fish/guestfish-actions.pod:3136
25545 msgid "mkswap"
25546 msgstr ""
25547
25548 #. type: verbatim
25549 #: ../fish/guestfish-actions.pod:3138
25550 #, no-wrap
25551 msgid ""
25552 " mkswap device\n"
25553 "\n"
25554 msgstr ""
25555
25556 #. type: =head2
25557 #: ../fish/guestfish-actions.pod:3142
25558 msgid "mkswap-L"
25559 msgstr ""
25560
25561 #. type: verbatim
25562 #: ../fish/guestfish-actions.pod:3144
25563 #, no-wrap
25564 msgid ""
25565 " mkswap-L label device\n"
25566 "\n"
25567 msgstr ""
25568
25569 #. type: =head2
25570 #: ../fish/guestfish-actions.pod:3152
25571 msgid "mkswap-U"
25572 msgstr ""
25573
25574 #. type: verbatim
25575 #: ../fish/guestfish-actions.pod:3154
25576 #, no-wrap
25577 msgid ""
25578 " mkswap-U uuid device\n"
25579 "\n"
25580 msgstr ""
25581
25582 #. type: =head2
25583 #: ../fish/guestfish-actions.pod:3158
25584 msgid "mkswap-file"
25585 msgstr ""
25586
25587 #. type: verbatim
25588 #: ../fish/guestfish-actions.pod:3160
25589 #, no-wrap
25590 msgid ""
25591 " mkswap-file path\n"
25592 "\n"
25593 msgstr ""
25594
25595 #. type: textblock
25596 #: ../fish/guestfish-actions.pod:3164
25597 msgid ""
25598 "This command just writes a swap file signature to an existing file.  To "
25599 "create the file itself, use something like L</fallocate>."
25600 msgstr ""
25601
25602 #. type: =head2
25603 #: ../fish/guestfish-actions.pod:3167
25604 msgid "modprobe"
25605 msgstr ""
25606
25607 #. type: verbatim
25608 #: ../fish/guestfish-actions.pod:3169
25609 #, no-wrap
25610 msgid ""
25611 " modprobe modulename\n"
25612 "\n"
25613 msgstr ""
25614
25615 #. type: =head2
25616 #: ../fish/guestfish-actions.pod:3176
25617 msgid "mount"
25618 msgstr ""
25619
25620 #. type: verbatim
25621 #: ../fish/guestfish-actions.pod:3178
25622 #, no-wrap
25623 msgid ""
25624 " mount device mountpoint\n"
25625 "\n"
25626 msgstr ""
25627
25628 #. type: textblock
25629 #: ../fish/guestfish-actions.pod:3194
25630 msgid ""
25631 "B<Important note:> When you use this call, the filesystem options C<sync> "
25632 "and C<noatime> are set implicitly.  This was originally done because we "
25633 "thought it would improve reliability, but it turns out that I<-o sync> has a "
25634 "very large negative performance impact and negligible effect on "
25635 "reliability.  Therefore we recommend that you avoid using L</mount> in any "
25636 "code that needs performance, and instead use L</mount-options> (use an empty "
25637 "string for the first parameter if you don't want any options)."
25638 msgstr ""
25639
25640 #. type: textblock
25641 #: ../fish/guestfish-actions.pod:3204
25642 msgid ""
25643 "This function is deprecated.  In new code, use the L</mount_options> call "
25644 "instead."
25645 msgstr ""
25646
25647 #. type: =head2
25648 #: ../fish/guestfish-actions.pod:3211
25649 msgid "mount-loop"
25650 msgstr ""
25651
25652 #. type: verbatim
25653 #: ../fish/guestfish-actions.pod:3213
25654 #, no-wrap
25655 msgid ""
25656 " mount-loop file mountpoint\n"
25657 "\n"
25658 msgstr ""
25659
25660 #. type: =head2
25661 #: ../fish/guestfish-actions.pod:3219
25662 msgid "mount-options"
25663 msgstr ""
25664
25665 #. type: verbatim
25666 #: ../fish/guestfish-actions.pod:3221
25667 #, no-wrap
25668 msgid ""
25669 " mount-options options device mountpoint\n"
25670 "\n"
25671 msgstr ""
25672
25673 #. type: textblock
25674 #: ../fish/guestfish-actions.pod:3223
25675 msgid ""
25676 "This is the same as the L</mount> command, but it allows you to set the "
25677 "mount options as for the L<mount(8)> I<-o> flag."
25678 msgstr ""
25679
25680 #. type: =head2
25681 #: ../fish/guestfish-actions.pod:3231
25682 msgid "mount-ro"
25683 msgstr ""
25684
25685 #. type: verbatim
25686 #: ../fish/guestfish-actions.pod:3233
25687 #, no-wrap
25688 msgid ""
25689 " mount-ro device mountpoint\n"
25690 "\n"
25691 msgstr ""
25692
25693 #. type: textblock
25694 #: ../fish/guestfish-actions.pod:3235
25695 msgid ""
25696 "This is the same as the L</mount> command, but it mounts the filesystem with "
25697 "the read-only (I<-o ro>) flag."
25698 msgstr ""
25699
25700 #. type: =head2
25701 #: ../fish/guestfish-actions.pod:3238
25702 msgid "mount-vfs"
25703 msgstr ""
25704
25705 #. type: verbatim
25706 #: ../fish/guestfish-actions.pod:3240
25707 #, no-wrap
25708 msgid ""
25709 " mount-vfs options vfstype device mountpoint\n"
25710 "\n"
25711 msgstr ""
25712
25713 #. type: textblock
25714 #: ../fish/guestfish-actions.pod:3242
25715 msgid ""
25716 "This is the same as the L</mount> command, but it allows you to set both the "
25717 "mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags."
25718 msgstr ""
25719
25720 #. type: =head2
25721 #: ../fish/guestfish-actions.pod:3246
25722 msgid "mountpoints"
25723 msgstr ""
25724
25725 #. type: verbatim
25726 #: ../fish/guestfish-actions.pod:3248
25727 #, no-wrap
25728 msgid ""
25729 " mountpoints\n"
25730 "\n"
25731 msgstr ""
25732
25733 #. type: textblock
25734 #: ../fish/guestfish-actions.pod:3250
25735 msgid ""
25736 "This call is similar to L</mounts>.  That call returns a list of devices.  "
25737 "This one returns a hash table (map) of device name to directory where the "
25738 "device is mounted."
25739 msgstr ""
25740
25741 #. type: =head2
25742 #: ../fish/guestfish-actions.pod:3254
25743 msgid "mounts"
25744 msgstr ""
25745
25746 #. type: verbatim
25747 #: ../fish/guestfish-actions.pod:3256
25748 #, no-wrap
25749 msgid ""
25750 " mounts\n"
25751 "\n"
25752 msgstr ""
25753
25754 #. type: textblock
25755 #: ../fish/guestfish-actions.pod:3263
25756 msgid "See also: L</mountpoints>"
25757 msgstr ""
25758
25759 #. type: =head2
25760 #: ../fish/guestfish-actions.pod:3265
25761 msgid "mv"
25762 msgstr ""
25763
25764 #. type: verbatim
25765 #: ../fish/guestfish-actions.pod:3267
25766 #, no-wrap
25767 msgid ""
25768 " mv src dest\n"
25769 "\n"
25770 msgstr ""
25771
25772 #. type: =head2
25773 #: ../fish/guestfish-actions.pod:3272
25774 msgid "ntfs-3g-probe"
25775 msgstr ""
25776
25777 #. type: verbatim
25778 #: ../fish/guestfish-actions.pod:3274
25779 #, no-wrap
25780 msgid ""
25781 " ntfs-3g-probe true|false device\n"
25782 "\n"
25783 msgstr ""
25784
25785 #. type: =head2
25786 #: ../fish/guestfish-actions.pod:3288
25787 msgid "ntfsresize"
25788 msgstr ""
25789
25790 #. type: verbatim
25791 #: ../fish/guestfish-actions.pod:3290
25792 #, no-wrap
25793 msgid ""
25794 " ntfsresize device\n"
25795 "\n"
25796 msgstr ""
25797
25798 #. type: =head2
25799 #: ../fish/guestfish-actions.pod:3305
25800 msgid "ntfsresize-size"
25801 msgstr ""
25802
25803 #. type: verbatim
25804 #: ../fish/guestfish-actions.pod:3307
25805 #, no-wrap
25806 msgid ""
25807 " ntfsresize-size device size\n"
25808 "\n"
25809 msgstr ""
25810
25811 #. type: textblock
25812 #: ../fish/guestfish-actions.pod:3309
25813 msgid ""
25814 "This command is the same as L</ntfsresize> except that it allows you to "
25815 "specify the new size (in bytes) explicitly."
25816 msgstr ""
25817
25818 #. type: =head2
25819 #: ../fish/guestfish-actions.pod:3312
25820 msgid "part-add"
25821 msgstr ""
25822
25823 #. type: verbatim
25824 #: ../fish/guestfish-actions.pod:3314
25825 #, no-wrap
25826 msgid ""
25827 " part-add device prlogex startsect endsect\n"
25828 "\n"
25829 msgstr ""
25830
25831 #. type: textblock
25832 #: ../fish/guestfish-actions.pod:3316
25833 msgid ""
25834 "This command adds a partition to C<device>.  If there is no partition table "
25835 "on the device, call L</part-init> first."
25836 msgstr ""
25837
25838 #. type: textblock
25839 #: ../fish/guestfish-actions.pod:3328
25840 msgid ""
25841 "Creating a partition which covers the whole disk is not so easy.  Use L</"
25842 "part-disk> to do that."
25843 msgstr ""
25844
25845 #. type: =head2
25846 #: ../fish/guestfish-actions.pod:3331
25847 msgid "part-del"
25848 msgstr ""
25849
25850 #. type: verbatim
25851 #: ../fish/guestfish-actions.pod:3333
25852 #, no-wrap
25853 msgid ""
25854 " part-del device partnum\n"
25855 "\n"
25856 msgstr ""
25857
25858 #. type: =head2
25859 #: ../fish/guestfish-actions.pod:3341
25860 msgid "part-disk"
25861 msgstr ""
25862
25863 #. type: verbatim
25864 #: ../fish/guestfish-actions.pod:3343
25865 #, no-wrap
25866 msgid ""
25867 " part-disk device parttype\n"
25868 "\n"
25869 msgstr ""
25870
25871 #. type: textblock
25872 #: ../fish/guestfish-actions.pod:3345
25873 msgid ""
25874 "This command is simply a combination of L</part-init> followed by L</part-"
25875 "add> to create a single primary partition covering the whole disk."
25876 msgstr ""
25877
25878 #. type: textblock
25879 #: ../fish/guestfish-actions.pod:3349
25880 msgid ""
25881 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
25882 "possible values are described in L</part-init>."
25883 msgstr ""
25884
25885 #. type: =head2
25886 #: ../fish/guestfish-actions.pod:3355
25887 msgid "part-get-bootable"
25888 msgstr ""
25889
25890 #. type: verbatim
25891 #: ../fish/guestfish-actions.pod:3357
25892 #, no-wrap
25893 msgid ""
25894 " part-get-bootable device partnum\n"
25895 "\n"
25896 msgstr ""
25897
25898 #. type: textblock
25899 #: ../fish/guestfish-actions.pod:3362
25900 msgid "See also L</part-set-bootable>."
25901 msgstr ""
25902
25903 #. type: =head2
25904 #: ../fish/guestfish-actions.pod:3364
25905 msgid "part-get-mbr-id"
25906 msgstr ""
25907
25908 #. type: verbatim
25909 #: ../fish/guestfish-actions.pod:3366
25910 #, no-wrap
25911 msgid ""
25912 " part-get-mbr-id device partnum\n"
25913 "\n"
25914 msgstr ""
25915
25916 #. type: textblock
25917 #: ../fish/guestfish-actions.pod:3371 ../fish/guestfish-actions.pod:3509
25918 msgid ""
25919 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
25920 "undefined results for other partition table types (see L</part-get-"
25921 "parttype>)."
25922 msgstr ""
25923
25924 #. type: =head2
25925 #: ../fish/guestfish-actions.pod:3375
25926 msgid "part-get-parttype"
25927 msgstr ""
25928
25929 #. type: verbatim
25930 #: ../fish/guestfish-actions.pod:3377
25931 #, no-wrap
25932 msgid ""
25933 " part-get-parttype device\n"
25934 "\n"
25935 msgstr ""
25936
25937 #. type: textblock
25938 #: ../fish/guestfish-actions.pod:3382
25939 msgid ""
25940 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
25941 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
25942 "possible, although unusual.  See L</part-init> for a full list."
25943 msgstr ""
25944
25945 #. type: =head2
25946 #: ../fish/guestfish-actions.pod:3387
25947 msgid "part-init"
25948 msgstr ""
25949
25950 #. type: verbatim
25951 #: ../fish/guestfish-actions.pod:3389
25952 #, no-wrap
25953 msgid ""
25954 " part-init device parttype\n"
25955 "\n"
25956 msgstr ""
25957
25958 #. type: textblock
25959 #: ../fish/guestfish-actions.pod:3395
25960 msgid ""
25961 "Initially there are no partitions.  Following this, you should call L</part-"
25962 "add> for each partition required."
25963 msgstr ""
25964
25965 #. type: =head2
25966 #: ../fish/guestfish-actions.pod:3458
25967 msgid "part-list"
25968 msgstr ""
25969
25970 #. type: verbatim
25971 #: ../fish/guestfish-actions.pod:3460
25972 #, no-wrap
25973 msgid ""
25974 " part-list device\n"
25975 "\n"
25976 msgstr ""
25977
25978 #. type: textblock
25979 #: ../fish/guestfish-actions.pod:3475
25980 msgid ""
25981 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
25982 "the device's sector size, see L</blockdev-getss>."
25983 msgstr ""
25984
25985 #. type: =head2
25986 #: ../fish/guestfish-actions.pod:3488
25987 msgid "part-set-bootable"
25988 msgstr ""
25989
25990 #. type: verbatim
25991 #: ../fish/guestfish-actions.pod:3490
25992 #, no-wrap
25993 msgid ""
25994 " part-set-bootable device partnum true|false\n"
25995 "\n"
25996 msgstr ""
25997
25998 #. type: =head2
25999 #: ../fish/guestfish-actions.pod:3499
26000 msgid "part-set-mbr-id"
26001 msgstr ""
26002
26003 #. type: verbatim
26004 #: ../fish/guestfish-actions.pod:3501
26005 #, no-wrap
26006 msgid ""
26007 " part-set-mbr-id device partnum idbyte\n"
26008 "\n"
26009 msgstr ""
26010
26011 #. type: =head2
26012 #: ../fish/guestfish-actions.pod:3513
26013 msgid "part-set-name"
26014 msgstr ""
26015
26016 #. type: verbatim
26017 #: ../fish/guestfish-actions.pod:3515
26018 #, no-wrap
26019 msgid ""
26020 " part-set-name device partnum name\n"
26021 "\n"
26022 msgstr ""
26023
26024 #. type: =head2
26025 #: ../fish/guestfish-actions.pod:3523
26026 msgid "part-to-dev"
26027 msgstr ""
26028
26029 #. type: verbatim
26030 #: ../fish/guestfish-actions.pod:3525
26031 #, no-wrap
26032 msgid ""
26033 " part-to-dev partition\n"
26034 "\n"
26035 msgstr ""
26036
26037 #. type: textblock
26038 #: ../fish/guestfish-actions.pod:3531
26039 msgid ""
26040 "The named partition must exist, for example as a string returned from L</"
26041 "list-partitions>."
26042 msgstr ""
26043
26044 #. type: =head2
26045 #: ../fish/guestfish-actions.pod:3534
26046 msgid "ping-daemon"
26047 msgstr ""
26048
26049 #. type: verbatim
26050 #: ../fish/guestfish-actions.pod:3536
26051 #, no-wrap
26052 msgid ""
26053 " ping-daemon\n"
26054 "\n"
26055 msgstr ""
26056
26057 #. type: =head2
26058 #: ../fish/guestfish-actions.pod:3543
26059 msgid "pread"
26060 msgstr ""
26061
26062 #. type: verbatim
26063 #: ../fish/guestfish-actions.pod:3545
26064 #, no-wrap
26065 msgid ""
26066 " pread path count offset\n"
26067 "\n"
26068 msgstr ""
26069
26070 #. type: textblock
26071 #: ../fish/guestfish-actions.pod:3553
26072 msgid "See also L</pwrite>, L</pread-device>."
26073 msgstr ""
26074
26075 #. type: =head2
26076 #: ../fish/guestfish-actions.pod:3558
26077 msgid "pread-device"
26078 msgstr ""
26079
26080 #. type: verbatim
26081 #: ../fish/guestfish-actions.pod:3560
26082 #, no-wrap
26083 msgid ""
26084 " pread-device device count offset\n"
26085 "\n"
26086 msgstr ""
26087
26088 #. type: textblock
26089 #: ../fish/guestfish-actions.pod:3568
26090 msgid "See also L</pread>."
26091 msgstr ""
26092
26093 #. type: =head2
26094 #: ../fish/guestfish-actions.pod:3573
26095 msgid "pvcreate"
26096 msgstr ""
26097
26098 #. type: verbatim
26099 #: ../fish/guestfish-actions.pod:3575
26100 #, no-wrap
26101 msgid ""
26102 " pvcreate device\n"
26103 "\n"
26104 msgstr ""
26105
26106 #. type: =head2
26107 #: ../fish/guestfish-actions.pod:3581
26108 msgid "pvremove"
26109 msgstr ""
26110
26111 #. type: verbatim
26112 #: ../fish/guestfish-actions.pod:3583
26113 #, no-wrap
26114 msgid ""
26115 " pvremove device\n"
26116 "\n"
26117 msgstr ""
26118
26119 #. type: =head2
26120 #: ../fish/guestfish-actions.pod:3592
26121 msgid "pvresize"
26122 msgstr ""
26123
26124 #. type: verbatim
26125 #: ../fish/guestfish-actions.pod:3594
26126 #, no-wrap
26127 msgid ""
26128 " pvresize device\n"
26129 "\n"
26130 msgstr ""
26131
26132 #. type: =head2
26133 #: ../fish/guestfish-actions.pod:3599
26134 msgid "pvresize-size"
26135 msgstr ""
26136
26137 #. type: verbatim
26138 #: ../fish/guestfish-actions.pod:3601
26139 #, no-wrap
26140 msgid ""
26141 " pvresize-size device size\n"
26142 "\n"
26143 msgstr ""
26144
26145 #. type: textblock
26146 #: ../fish/guestfish-actions.pod:3603
26147 msgid ""
26148 "This command is the same as L</pvresize> except that it allows you to "
26149 "specify the new size (in bytes) explicitly."
26150 msgstr ""
26151
26152 #. type: =head2
26153 #: ../fish/guestfish-actions.pod:3606
26154 msgid "pvs"
26155 msgstr ""
26156
26157 #. type: verbatim
26158 #: ../fish/guestfish-actions.pod:3608
26159 #, no-wrap
26160 msgid ""
26161 " pvs\n"
26162 "\n"
26163 msgstr ""
26164
26165 #. type: textblock
26166 #: ../fish/guestfish-actions.pod:3616
26167 msgid "See also L</pvs-full>."
26168 msgstr ""
26169
26170 #. type: =head2
26171 #: ../fish/guestfish-actions.pod:3618
26172 msgid "pvs-full"
26173 msgstr ""
26174
26175 #. type: verbatim
26176 #: ../fish/guestfish-actions.pod:3620
26177 #, no-wrap
26178 msgid ""
26179 " pvs-full\n"
26180 "\n"
26181 msgstr ""
26182
26183 #. type: =head2
26184 #: ../fish/guestfish-actions.pod:3625
26185 msgid "pvuuid"
26186 msgstr ""
26187
26188 #. type: verbatim
26189 #: ../fish/guestfish-actions.pod:3627
26190 #, no-wrap
26191 msgid ""
26192 " pvuuid device\n"
26193 "\n"
26194 msgstr ""
26195
26196 #. type: =head2
26197 #: ../fish/guestfish-actions.pod:3631
26198 msgid "pwrite"
26199 msgstr ""
26200
26201 #. type: verbatim
26202 #: ../fish/guestfish-actions.pod:3633
26203 #, no-wrap
26204 msgid ""
26205 " pwrite path content offset\n"
26206 "\n"
26207 msgstr ""
26208
26209 #. type: textblock
26210 #: ../fish/guestfish-actions.pod:3644
26211 msgid "See also L</pread>, L</pwrite-device>."
26212 msgstr ""
26213
26214 #. type: =head2
26215 #: ../fish/guestfish-actions.pod:3649
26216 msgid "pwrite-device"
26217 msgstr ""
26218
26219 #. type: verbatim
26220 #: ../fish/guestfish-actions.pod:3651
26221 #, no-wrap
26222 msgid ""
26223 " pwrite-device device content offset\n"
26224 "\n"
26225 msgstr ""
26226
26227 #. type: textblock
26228 #: ../fish/guestfish-actions.pod:3661
26229 msgid "See also L</pwrite>."
26230 msgstr ""
26231
26232 #. type: =head2
26233 #: ../fish/guestfish-actions.pod:3666
26234 msgid "read-file"
26235 msgstr ""
26236
26237 #. type: verbatim
26238 #: ../fish/guestfish-actions.pod:3668
26239 #, no-wrap
26240 msgid ""
26241 " read-file path\n"
26242 "\n"
26243 msgstr ""
26244
26245 #. type: textblock
26246 #: ../fish/guestfish-actions.pod:3673
26247 msgid ""
26248 "Unlike L</cat>, this function can correctly handle files that contain "
26249 "embedded ASCII NUL characters.  However unlike L</download>, this function "
26250 "is limited in the total size of file that can be handled."
26251 msgstr ""
26252
26253 #. type: =head2
26254 #: ../fish/guestfish-actions.pod:3681
26255 msgid "read-lines"
26256 msgstr ""
26257
26258 #. type: verbatim
26259 #: ../fish/guestfish-actions.pod:3683
26260 #, no-wrap
26261 msgid ""
26262 " read-lines path\n"
26263 "\n"
26264 msgstr ""
26265
26266 #. type: textblock
26267 #: ../fish/guestfish-actions.pod:3690
26268 msgid ""
26269 "Note that this function cannot correctly handle binary files (specifically, "
26270 "files containing C<\\0> character which is treated as end of line).  For "
26271 "those you need to use the L</read-file> function which has a more complex "
26272 "interface."
26273 msgstr ""
26274
26275 #. type: =head2
26276 #: ../fish/guestfish-actions.pod:3695
26277 msgid "readdir"
26278 msgstr ""
26279
26280 #. type: verbatim
26281 #: ../fish/guestfish-actions.pod:3697
26282 #, no-wrap
26283 msgid ""
26284 " readdir dir\n"
26285 "\n"
26286 msgstr ""
26287
26288 #. type: textblock
26289 #: ../fish/guestfish-actions.pod:3749
26290 msgid ""
26291 "This function is primarily intended for use by programs.  To get a simple "
26292 "list of names, use L</ls>.  To get a printable directory for human "
26293 "consumption, use L</ll>."
26294 msgstr ""
26295
26296 #. type: =head2
26297 #: ../fish/guestfish-actions.pod:3753
26298 msgid "readlink"
26299 msgstr ""
26300
26301 #. type: verbatim
26302 #: ../fish/guestfish-actions.pod:3755
26303 #, no-wrap
26304 msgid ""
26305 " readlink path\n"
26306 "\n"
26307 msgstr ""
26308
26309 #. type: =head2
26310 #: ../fish/guestfish-actions.pod:3759
26311 msgid "readlinklist"
26312 msgstr ""
26313
26314 #. type: verbatim
26315 #: ../fish/guestfish-actions.pod:3761
26316 #, no-wrap
26317 msgid ""
26318 " readlinklist path 'names ...'\n"
26319 "\n"
26320 msgstr ""
26321
26322 #. type: =head2
26323 #: ../fish/guestfish-actions.pod:3785
26324 msgid "realpath"
26325 msgstr ""
26326
26327 #. type: verbatim
26328 #: ../fish/guestfish-actions.pod:3787
26329 #, no-wrap
26330 msgid ""
26331 " realpath path\n"
26332 "\n"
26333 msgstr ""
26334
26335 #. type: =head2
26336 #: ../fish/guestfish-actions.pod:3792
26337 msgid "removexattr"
26338 msgstr ""
26339
26340 #. type: verbatim
26341 #: ../fish/guestfish-actions.pod:3794
26342 #, no-wrap
26343 msgid ""
26344 " removexattr xattr path\n"
26345 "\n"
26346 msgstr ""
26347
26348 #. type: textblock
26349 #: ../fish/guestfish-actions.pod:3799
26350 msgid "See also: L</lremovexattr>, L<attr(5)>."
26351 msgstr ""
26352
26353 #. type: =head2
26354 #: ../fish/guestfish-actions.pod:3801
26355 msgid "resize2fs"
26356 msgstr ""
26357
26358 #. type: verbatim
26359 #: ../fish/guestfish-actions.pod:3803
26360 #, no-wrap
26361 msgid ""
26362 " resize2fs device\n"
26363 "\n"
26364 msgstr ""
26365
26366 #. type: textblock
26367 #: ../fish/guestfish-actions.pod:3808
26368 msgid ""
26369 "I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> "
26370 "before calling this command.  For unknown reasons C<resize2fs> sometimes "
26371 "gives an error about this and sometimes not.  In any case, it is always safe "
26372 "to call L</e2fsck-f> before calling this function."
26373 msgstr ""
26374
26375 #. type: =head2
26376 #: ../fish/guestfish-actions.pod:3814
26377 msgid "resize2fs-M"
26378 msgstr ""
26379
26380 #. type: verbatim
26381 #: ../fish/guestfish-actions.pod:3816
26382 #, no-wrap
26383 msgid ""
26384 " resize2fs-M device\n"
26385 "\n"
26386 msgstr ""
26387
26388 #. type: textblock
26389 #: ../fish/guestfish-actions.pod:3818
26390 msgid ""
26391 "This command is the same as L</resize2fs>, but the filesystem is resized to "
26392 "its minimum size.  This works like the I<-M> option to the C<resize2fs> "
26393 "command."
26394 msgstr ""
26395
26396 #. type: textblock
26397 #: ../fish/guestfish-actions.pod:3822
26398 msgid ""
26399 "To get the resulting size of the filesystem you should call L</tune2fs-l> "
26400 "and read the C<Block size> and C<Block count> values.  These two numbers, "
26401 "multiplied together, give the resulting size of the minimal filesystem in "
26402 "bytes."
26403 msgstr ""
26404
26405 #. type: =head2
26406 #: ../fish/guestfish-actions.pod:3827
26407 msgid "resize2fs-size"
26408 msgstr ""
26409
26410 #. type: verbatim
26411 #: ../fish/guestfish-actions.pod:3829
26412 #, no-wrap
26413 msgid ""
26414 " resize2fs-size device size\n"
26415 "\n"
26416 msgstr ""
26417
26418 #. type: textblock
26419 #: ../fish/guestfish-actions.pod:3831
26420 msgid ""
26421 "This command is the same as L</resize2fs> except that it allows you to "
26422 "specify the new size (in bytes) explicitly."
26423 msgstr ""
26424
26425 #. type: =head2
26426 #: ../fish/guestfish-actions.pod:3834
26427 msgid "rm"
26428 msgstr ""
26429
26430 #. type: verbatim
26431 #: ../fish/guestfish-actions.pod:3836
26432 #, no-wrap
26433 msgid ""
26434 " rm path\n"
26435 "\n"
26436 msgstr ""
26437
26438 #. type: =head2
26439 #: ../fish/guestfish-actions.pod:3840
26440 msgid "rm-rf"
26441 msgstr ""
26442
26443 #. type: verbatim
26444 #: ../fish/guestfish-actions.pod:3842
26445 #, no-wrap
26446 msgid ""
26447 " rm-rf path\n"
26448 "\n"
26449 msgstr ""
26450
26451 #. type: =head2
26452 #: ../fish/guestfish-actions.pod:3848
26453 msgid "rmdir"
26454 msgstr ""
26455
26456 #. type: verbatim
26457 #: ../fish/guestfish-actions.pod:3850
26458 #, no-wrap
26459 msgid ""
26460 " rmdir path\n"
26461 "\n"
26462 msgstr ""
26463
26464 #. type: =head2
26465 #: ../fish/guestfish-actions.pod:3854
26466 msgid "rmmountpoint"
26467 msgstr ""
26468
26469 #. type: verbatim
26470 #: ../fish/guestfish-actions.pod:3856
26471 #, no-wrap
26472 msgid ""
26473 " rmmountpoint exemptpath\n"
26474 "\n"
26475 msgstr ""
26476
26477 #. type: textblock
26478 #: ../fish/guestfish-actions.pod:3858
26479 msgid ""
26480 "This calls removes a mountpoint that was previously created with L</"
26481 "mkmountpoint>.  See L</mkmountpoint> for full details."
26482 msgstr ""
26483
26484 #. type: =head2
26485 #: ../fish/guestfish-actions.pod:3862
26486 msgid "scrub-device"
26487 msgstr ""
26488
26489 #. type: verbatim
26490 #: ../fish/guestfish-actions.pod:3864
26491 #, no-wrap
26492 msgid ""
26493 " scrub-device device\n"
26494 "\n"
26495 msgstr ""
26496
26497 #. type: =head2
26498 #: ../fish/guestfish-actions.pod:3875
26499 msgid "scrub-file"
26500 msgstr ""
26501
26502 #. type: verbatim
26503 #: ../fish/guestfish-actions.pod:3877
26504 #, no-wrap
26505 msgid ""
26506 " scrub-file file\n"
26507 "\n"
26508 msgstr ""
26509
26510 #. type: =head2
26511 #: ../fish/guestfish-actions.pod:3887
26512 msgid "scrub-freespace"
26513 msgstr ""
26514
26515 #. type: verbatim
26516 #: ../fish/guestfish-actions.pod:3889
26517 #, no-wrap
26518 msgid ""
26519 " scrub-freespace dir\n"
26520 "\n"
26521 msgstr ""
26522
26523 #. type: textblock
26524 #: ../fish/guestfish-actions.pod:3891
26525 msgid ""
26526 "This command creates the directory C<dir> and then fills it with files until "
26527 "the filesystem is full, and scrubs the files as for L</scrub-file>, and "
26528 "deletes them.  The intention is to scrub any free space on the partition "
26529 "containing C<dir>."
26530 msgstr ""
26531
26532 #. type: =head2
26533 #: ../fish/guestfish-actions.pod:3900
26534 msgid "set-append"
26535 msgstr ""
26536
26537 #. type: =head2
26538 #: ../fish/guestfish-actions.pod:3902
26539 msgid "append"
26540 msgstr ""
26541
26542 #. type: verbatim
26543 #: ../fish/guestfish-actions.pod:3904
26544 #, no-wrap
26545 msgid ""
26546 " set-append append\n"
26547 "\n"
26548 msgstr ""
26549
26550 #. type: =head2
26551 #: ../fish/guestfish-actions.pod:3915
26552 msgid "set-attach-method"
26553 msgstr ""
26554
26555 #. type: =head2
26556 #: ../fish/guestfish-actions.pod:3917
26557 msgid "attach-method"
26558 msgstr ""
26559
26560 #. type: verbatim
26561 #: ../fish/guestfish-actions.pod:3919
26562 #, no-wrap
26563 msgid ""
26564 " set-attach-method attachmethod\n"
26565 "\n"
26566 msgstr ""
26567
26568 #. type: =head2
26569 #: ../fish/guestfish-actions.pod:3941
26570 msgid "set-autosync"
26571 msgstr ""
26572
26573 #. type: =head2
26574 #: ../fish/guestfish-actions.pod:3943
26575 msgid "autosync"
26576 msgstr ""
26577
26578 #. type: verbatim
26579 #: ../fish/guestfish-actions.pod:3945
26580 #, no-wrap
26581 msgid ""
26582 " set-autosync true|false\n"
26583 "\n"
26584 msgstr ""
26585
26586 #. type: =head2
26587 #: ../fish/guestfish-actions.pod:3955
26588 msgid "set-direct"
26589 msgstr ""
26590
26591 #. type: =head2
26592 #: ../fish/guestfish-actions.pod:3957
26593 msgid "direct"
26594 msgstr ""
26595
26596 #. type: verbatim
26597 #: ../fish/guestfish-actions.pod:3959
26598 #, no-wrap
26599 msgid ""
26600 " set-direct true|false\n"
26601 "\n"
26602 msgstr ""
26603
26604 #. type: textblock
26605 #: ../fish/guestfish-actions.pod:3965
26606 msgid ""
26607 "One consequence of this is that log messages aren't caught by the library "
26608 "and handled by L</set-log-message-callback>, but go straight to stdout."
26609 msgstr ""
26610
26611 #. type: =head2
26612 #: ../fish/guestfish-actions.pod:3974
26613 msgid "set-e2label"
26614 msgstr ""
26615
26616 #. type: verbatim
26617 #: ../fish/guestfish-actions.pod:3976
26618 #, no-wrap
26619 msgid ""
26620 " set-e2label device label\n"
26621 "\n"
26622 msgstr ""
26623
26624 #. type: textblock
26625 #: ../fish/guestfish-actions.pod:3982
26626 msgid ""
26627 "You can use either L</tune2fs-l> or L</get-e2label> to return the existing "
26628 "label on a filesystem."
26629 msgstr ""
26630
26631 #. type: =head2
26632 #: ../fish/guestfish-actions.pod:3985
26633 msgid "set-e2uuid"
26634 msgstr ""
26635
26636 #. type: verbatim
26637 #: ../fish/guestfish-actions.pod:3987
26638 #, no-wrap
26639 msgid ""
26640 " set-e2uuid device uuid\n"
26641 "\n"
26642 msgstr ""
26643
26644 #. type: textblock
26645 #: ../fish/guestfish-actions.pod:3994
26646 msgid ""
26647 "You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing "
26648 "UUID of a filesystem."
26649 msgstr ""
26650
26651 #. type: =head2
26652 #: ../fish/guestfish-actions.pod:3997
26653 msgid "set-memsize"
26654 msgstr ""
26655
26656 #. type: =head2
26657 #: ../fish/guestfish-actions.pod:3999
26658 msgid "memsize"
26659 msgstr ""
26660
26661 #. type: verbatim
26662 #: ../fish/guestfish-actions.pod:4001
26663 #, no-wrap
26664 msgid ""
26665 " set-memsize memsize\n"
26666 "\n"
26667 msgstr ""
26668
26669 #. type: textblock
26670 #: ../fish/guestfish-actions.pod:4003
26671 msgid ""
26672 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
26673 "This only has any effect if called before L</launch>."
26674 msgstr ""
26675
26676 #. type: =head2
26677 #: ../fish/guestfish-actions.pod:4014
26678 msgid "set-network"
26679 msgstr ""
26680
26681 #. type: =head2
26682 #: ../fish/guestfish-actions.pod:4016
26683 msgid "network"
26684 msgstr ""
26685
26686 #. type: verbatim
26687 #: ../fish/guestfish-actions.pod:4018
26688 #, no-wrap
26689 msgid ""
26690 " set-network true|false\n"
26691 "\n"
26692 msgstr ""
26693
26694 #. type: textblock
26695 #: ../fish/guestfish-actions.pod:4026
26696 msgid ""
26697 "You must call this before calling L</launch>, otherwise it has no effect."
26698 msgstr ""
26699
26700 #. type: =head2
26701 #: ../fish/guestfish-actions.pod:4029
26702 msgid "set-path"
26703 msgstr ""
26704
26705 #. type: =head2
26706 #: ../fish/guestfish-actions.pod:4031
26707 msgid "path"
26708 msgstr ""
26709
26710 #. type: verbatim
26711 #: ../fish/guestfish-actions.pod:4033
26712 #, no-wrap
26713 msgid ""
26714 " set-path searchpath\n"
26715 "\n"
26716 msgstr ""
26717
26718 #. type: =head2
26719 #: ../fish/guestfish-actions.pod:4042
26720 msgid "set-qemu"
26721 msgstr ""
26722
26723 #. type: =head2
26724 #: ../fish/guestfish-actions.pod:4044
26725 msgid "qemu"
26726 msgstr ""
26727
26728 #. type: verbatim
26729 #: ../fish/guestfish-actions.pod:4046
26730 #, no-wrap
26731 msgid ""
26732 " set-qemu qemu\n"
26733 "\n"
26734 msgstr ""
26735
26736 #. type: =head2
26737 #: ../fish/guestfish-actions.pod:4066
26738 msgid "set-recovery-proc"
26739 msgstr ""
26740
26741 #. type: =head2
26742 #: ../fish/guestfish-actions.pod:4068
26743 msgid "recovery-proc"
26744 msgstr ""
26745
26746 #. type: verbatim
26747 #: ../fish/guestfish-actions.pod:4070
26748 #, no-wrap
26749 msgid ""
26750 " set-recovery-proc true|false\n"
26751 "\n"
26752 msgstr ""
26753
26754 #. type: textblock
26755 #: ../fish/guestfish-actions.pod:4072
26756 msgid ""
26757 "If this is called with the parameter C<false> then L</launch> does not "
26758 "create a recovery process.  The purpose of the recovery process is to stop "
26759 "runaway qemu processes in the case where the main program aborts abruptly."
26760 msgstr ""
26761
26762 #. type: textblock
26763 #: ../fish/guestfish-actions.pod:4077
26764 msgid ""
26765 "This only has any effect if called before L</launch>, and the default is "
26766 "true."
26767 msgstr ""
26768
26769 #. type: =head2
26770 #: ../fish/guestfish-actions.pod:4086
26771 msgid "set-selinux"
26772 msgstr ""
26773
26774 #. type: =head2
26775 #: ../fish/guestfish-actions.pod:4088
26776 msgid "selinux"
26777 msgstr ""
26778
26779 #. type: verbatim
26780 #: ../fish/guestfish-actions.pod:4090
26781 #, no-wrap
26782 msgid ""
26783 " set-selinux true|false\n"
26784 "\n"
26785 msgstr ""
26786
26787 #. type: =head2
26788 #: ../fish/guestfish-actions.pod:4101
26789 msgid "set-trace"
26790 msgstr ""
26791
26792 #. type: =head2
26793 #: ../fish/guestfish-actions.pod:4103
26794 msgid "trace"
26795 msgstr ""
26796
26797 #. type: verbatim
26798 #: ../fish/guestfish-actions.pod:4105
26799 #, no-wrap
26800 msgid ""
26801 " set-trace true|false\n"
26802 "\n"
26803 msgstr ""
26804
26805 #. type: textblock
26806 #: ../fish/guestfish-actions.pod:4117
26807 msgid ""
26808 "Trace messages are normally sent to C<stderr>, unless you register a "
26809 "callback to send them somewhere else (see L</set-event-callback>)."
26810 msgstr ""
26811
26812 #. type: =head2
26813 #: ../fish/guestfish-actions.pod:4121
26814 msgid "set-verbose"
26815 msgstr ""
26816
26817 #. type: =head2
26818 #: ../fish/guestfish-actions.pod:4123
26819 msgid "verbose"
26820 msgstr ""
26821
26822 #. type: verbatim
26823 #: ../fish/guestfish-actions.pod:4125
26824 #, no-wrap
26825 msgid ""
26826 " set-verbose true|false\n"
26827 "\n"
26828 msgstr ""
26829
26830 #. type: textblock
26831 #: ../fish/guestfish-actions.pod:4132
26832 msgid ""
26833 "Verbose messages are normally sent to C<stderr>, unless you register a "
26834 "callback to send them somewhere else (see L</set-event-callback>)."
26835 msgstr ""
26836
26837 #. type: =head2
26838 #: ../fish/guestfish-actions.pod:4136
26839 msgid "setcon"
26840 msgstr ""
26841
26842 #. type: verbatim
26843 #: ../fish/guestfish-actions.pod:4138
26844 #, no-wrap
26845 msgid ""
26846 " setcon context\n"
26847 "\n"
26848 msgstr ""
26849
26850 #. type: =head2
26851 #: ../fish/guestfish-actions.pod:4145
26852 msgid "setxattr"
26853 msgstr ""
26854
26855 #. type: verbatim
26856 #: ../fish/guestfish-actions.pod:4147
26857 #, no-wrap
26858 msgid ""
26859 " setxattr xattr val vallen path\n"
26860 "\n"
26861 msgstr ""
26862
26863 #. type: textblock
26864 #: ../fish/guestfish-actions.pod:4153
26865 msgid "See also: L</lsetxattr>, L<attr(5)>."
26866 msgstr ""
26867
26868 #. type: =head2
26869 #: ../fish/guestfish-actions.pod:4155
26870 msgid "sfdisk"
26871 msgstr ""
26872
26873 #. type: verbatim
26874 #: ../fish/guestfish-actions.pod:4157
26875 #, no-wrap
26876 msgid ""
26877 " sfdisk device cyls heads sectors 'lines ...'\n"
26878 "\n"
26879 msgstr ""
26880
26881 #. type: textblock
26882 #: ../fish/guestfish-actions.pod:4179
26883 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>"
26884 msgstr ""
26885
26886 #. type: textblock
26887 #: ../fish/guestfish-actions.pod:4185 ../fish/guestfish-actions.pod:4208
26888 #: ../fish/guestfish-actions.pod:4230
26889 msgid ""
26890 "This function is deprecated.  In new code, use the L</part_add> call instead."
26891 msgstr ""
26892
26893 #. type: =head2
26894 #: ../fish/guestfish-actions.pod:4192
26895 msgid "sfdiskM"
26896 msgstr ""
26897
26898 #. type: verbatim
26899 #: ../fish/guestfish-actions.pod:4194
26900 #, no-wrap
26901 msgid ""
26902 " sfdiskM device 'lines ...'\n"
26903 "\n"
26904 msgstr ""
26905
26906 #. type: textblock
26907 #: ../fish/guestfish-actions.pod:4196
26908 msgid ""
26909 "This is a simplified interface to the L</sfdisk> command, where partition "
26910 "sizes are specified in megabytes only (rounded to the nearest cylinder) and "
26911 "you don't need to specify the cyls, heads and sectors parameters which were "
26912 "rarely if ever used anyway."
26913 msgstr ""
26914
26915 #. type: textblock
26916 #: ../fish/guestfish-actions.pod:4202
26917 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>"
26918 msgstr ""
26919
26920 #. type: =head2
26921 #: ../fish/guestfish-actions.pod:4215
26922 msgid "sfdisk-N"
26923 msgstr ""
26924
26925 #. type: verbatim
26926 #: ../fish/guestfish-actions.pod:4217
26927 #, no-wrap
26928 msgid ""
26929 " sfdisk-N device partnum cyls heads sectors line\n"
26930 "\n"
26931 msgstr ""
26932
26933 #. type: textblock
26934 #: ../fish/guestfish-actions.pod:4222
26935 msgid ""
26936 "For other parameters, see L</sfdisk>.  You should usually pass C<0> for the "
26937 "cyls/heads/sectors parameters."
26938 msgstr ""
26939
26940 #. type: textblock
26941 #: ../fish/guestfish-actions.pod:4225
26942 msgid "See also: L</part-add>"
26943 msgstr ""
26944
26945 #. type: =head2
26946 #: ../fish/guestfish-actions.pod:4237
26947 msgid "sfdisk-disk-geometry"
26948 msgstr ""
26949
26950 #. type: verbatim
26951 #: ../fish/guestfish-actions.pod:4239
26952 #, no-wrap
26953 msgid ""
26954 " sfdisk-disk-geometry device\n"
26955 "\n"
26956 msgstr ""
26957
26958 #. type: textblock
26959 #: ../fish/guestfish-actions.pod:4241
26960 msgid ""
26961 "This displays the disk geometry of C<device> read from the partition table.  "
26962 "Especially in the case where the underlying block device has been resized, "
26963 "this can be different from the kernel's idea of the geometry (see L</sfdisk-"
26964 "kernel-geometry>)."
26965 msgstr ""
26966
26967 #. type: =head2
26968 #: ../fish/guestfish-actions.pod:4249
26969 msgid "sfdisk-kernel-geometry"
26970 msgstr ""
26971
26972 #. type: verbatim
26973 #: ../fish/guestfish-actions.pod:4251
26974 #, no-wrap
26975 msgid ""
26976 " sfdisk-kernel-geometry device\n"
26977 "\n"
26978 msgstr ""
26979
26980 #. type: =head2
26981 #: ../fish/guestfish-actions.pod:4258
26982 msgid "sfdisk-l"
26983 msgstr ""
26984
26985 #. type: verbatim
26986 #: ../fish/guestfish-actions.pod:4260
26987 #, no-wrap
26988 msgid ""
26989 " sfdisk-l device\n"
26990 "\n"
26991 msgstr ""
26992
26993 #. type: textblock
26994 #: ../fish/guestfish-actions.pod:4266
26995 msgid "See also: L</part-list>"
26996 msgstr ""
26997
26998 #. type: textblock
26999 #: ../fish/guestfish-actions.pod:4268
27000 msgid ""
27001 "This function is deprecated.  In new code, use the L</part_list> call "
27002 "instead."
27003 msgstr ""
27004
27005 #. type: =head2
27006 #: ../fish/guestfish-actions.pod:4275
27007 msgid "sh"
27008 msgstr ""
27009
27010 #. type: verbatim
27011 #: ../fish/guestfish-actions.pod:4277
27012 #, no-wrap
27013 msgid ""
27014 " sh command\n"
27015 "\n"
27016 msgstr ""
27017
27018 #. type: textblock
27019 #: ../fish/guestfish-actions.pod:4282
27020 msgid "This is like L</command>, but passes the command to:"
27021 msgstr ""
27022
27023 #. type: textblock
27024 #: ../fish/guestfish-actions.pod:4290
27025 msgid "All the provisos about L</command> apply to this call."
27026 msgstr ""
27027
27028 #. type: =head2
27029 #: ../fish/guestfish-actions.pod:4292
27030 msgid "sh-lines"
27031 msgstr ""
27032
27033 #. type: verbatim
27034 #: ../fish/guestfish-actions.pod:4294
27035 #, no-wrap
27036 msgid ""
27037 " sh-lines command\n"
27038 "\n"
27039 msgstr ""
27040
27041 #. type: textblock
27042 #: ../fish/guestfish-actions.pod:4296
27043 msgid "This is the same as L</sh>, but splits the result into a list of lines."
27044 msgstr ""
27045
27046 #. type: textblock
27047 #: ../fish/guestfish-actions.pod:4299
27048 msgid "See also: L</command-lines>"
27049 msgstr ""
27050
27051 #. type: =head2
27052 #: ../fish/guestfish-actions.pod:4301
27053 msgid "sleep"
27054 msgstr ""
27055
27056 #. type: verbatim
27057 #: ../fish/guestfish-actions.pod:4303
27058 #, no-wrap
27059 msgid ""
27060 " sleep secs\n"
27061 "\n"
27062 msgstr ""
27063
27064 #. type: =head2
27065 #: ../fish/guestfish-actions.pod:4307
27066 msgid "stat"
27067 msgstr ""
27068
27069 #. type: verbatim
27070 #: ../fish/guestfish-actions.pod:4309
27071 #, no-wrap
27072 msgid ""
27073 " stat path\n"
27074 "\n"
27075 msgstr ""
27076
27077 #. type: =head2
27078 #: ../fish/guestfish-actions.pod:4315
27079 msgid "statvfs"
27080 msgstr ""
27081
27082 #. type: verbatim
27083 #: ../fish/guestfish-actions.pod:4317
27084 #, no-wrap
27085 msgid ""
27086 " statvfs path\n"
27087 "\n"
27088 msgstr ""
27089
27090 #. type: =head2
27091 #: ../fish/guestfish-actions.pod:4325
27092 msgid "strings"
27093 msgstr ""
27094
27095 #. type: verbatim
27096 #: ../fish/guestfish-actions.pod:4327
27097 #, no-wrap
27098 msgid ""
27099 " strings path\n"
27100 "\n"
27101 msgstr ""
27102
27103 #. type: =head2
27104 #: ../fish/guestfish-actions.pod:4335
27105 msgid "strings-e"
27106 msgstr ""
27107
27108 #. type: verbatim
27109 #: ../fish/guestfish-actions.pod:4337
27110 #, no-wrap
27111 msgid ""
27112 " strings-e encoding path\n"
27113 "\n"
27114 msgstr ""
27115
27116 #. type: textblock
27117 #: ../fish/guestfish-actions.pod:4339
27118 msgid ""
27119 "This is like the L</strings> command, but allows you to specify the encoding "
27120 "of strings that are looked for in the source file C<path>."
27121 msgstr ""
27122
27123 #. type: textblock
27124 #: ../fish/guestfish-actions.pod:4349
27125 msgid ""
27126 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
27127 "ISO-8859-X (this is what L</strings> uses)."
27128 msgstr ""
27129
27130 #. type: =head2
27131 #: ../fish/guestfish-actions.pod:4381
27132 msgid "swapoff-device"
27133 msgstr ""
27134
27135 #. type: verbatim
27136 #: ../fish/guestfish-actions.pod:4383
27137 #, no-wrap
27138 msgid ""
27139 " swapoff-device device\n"
27140 "\n"
27141 msgstr ""
27142
27143 #. type: textblock
27144 #: ../fish/guestfish-actions.pod:4385
27145 msgid ""
27146 "This command disables the libguestfs appliance swap device or partition "
27147 "named C<device>.  See L</swapon-device>."
27148 msgstr ""
27149
27150 #. type: =head2
27151 #: ../fish/guestfish-actions.pod:4389
27152 msgid "swapoff-file"
27153 msgstr ""
27154
27155 #. type: verbatim
27156 #: ../fish/guestfish-actions.pod:4391
27157 #, no-wrap
27158 msgid ""
27159 " swapoff-file file\n"
27160 "\n"
27161 msgstr ""
27162
27163 #. type: =head2
27164 #: ../fish/guestfish-actions.pod:4395
27165 msgid "swapoff-label"
27166 msgstr ""
27167
27168 #. type: verbatim
27169 #: ../fish/guestfish-actions.pod:4397
27170 #, no-wrap
27171 msgid ""
27172 " swapoff-label label\n"
27173 "\n"
27174 msgstr ""
27175
27176 #. type: =head2
27177 #: ../fish/guestfish-actions.pod:4402
27178 msgid "swapoff-uuid"
27179 msgstr ""
27180
27181 #. type: verbatim
27182 #: ../fish/guestfish-actions.pod:4404
27183 #, no-wrap
27184 msgid ""
27185 " swapoff-uuid uuid\n"
27186 "\n"
27187 msgstr ""
27188
27189 #. type: =head2
27190 #: ../fish/guestfish-actions.pod:4409
27191 msgid "swapon-device"
27192 msgstr ""
27193
27194 #. type: verbatim
27195 #: ../fish/guestfish-actions.pod:4411
27196 #, no-wrap
27197 msgid ""
27198 " swapon-device device\n"
27199 "\n"
27200 msgstr ""
27201
27202 #. type: textblock
27203 #: ../fish/guestfish-actions.pod:4413
27204 msgid ""
27205 "This command enables the libguestfs appliance to use the swap device or "
27206 "partition named C<device>.  The increased memory is made available for all "
27207 "commands, for example those run using L</command> or L</sh>."
27208 msgstr ""
27209
27210 #. type: =head2
27211 #: ../fish/guestfish-actions.pod:4425
27212 msgid "swapon-file"
27213 msgstr ""
27214
27215 #. type: verbatim
27216 #: ../fish/guestfish-actions.pod:4427
27217 #, no-wrap
27218 msgid ""
27219 " swapon-file file\n"
27220 "\n"
27221 msgstr ""
27222
27223 #. type: textblock
27224 #: ../fish/guestfish-actions.pod:4429
27225 msgid ""
27226 "This command enables swap to a file.  See L</swapon-device> for other notes."
27227 msgstr ""
27228
27229 #. type: =head2
27230 #: ../fish/guestfish-actions.pod:4432
27231 msgid "swapon-label"
27232 msgstr ""
27233
27234 #. type: verbatim
27235 #: ../fish/guestfish-actions.pod:4434
27236 #, no-wrap
27237 msgid ""
27238 " swapon-label label\n"
27239 "\n"
27240 msgstr ""
27241
27242 #. type: textblock
27243 #: ../fish/guestfish-actions.pod:4436
27244 msgid ""
27245 "This command enables swap to a labeled swap partition.  See L</swapon-"
27246 "device> for other notes."
27247 msgstr ""
27248
27249 #. type: =head2
27250 #: ../fish/guestfish-actions.pod:4439
27251 msgid "swapon-uuid"
27252 msgstr ""
27253
27254 #. type: verbatim
27255 #: ../fish/guestfish-actions.pod:4441
27256 #, no-wrap
27257 msgid ""
27258 " swapon-uuid uuid\n"
27259 "\n"
27260 msgstr ""
27261
27262 #. type: textblock
27263 #: ../fish/guestfish-actions.pod:4443
27264 msgid ""
27265 "This command enables swap to a swap partition with the given UUID.  See L</"
27266 "swapon-device> for other notes."
27267 msgstr ""
27268
27269 #. type: =head2
27270 #: ../fish/guestfish-actions.pod:4446
27271 msgid "sync"
27272 msgstr ""
27273
27274 #. type: verbatim
27275 #: ../fish/guestfish-actions.pod:4448
27276 #, no-wrap
27277 msgid ""
27278 " sync\n"
27279 "\n"
27280 msgstr ""
27281
27282 #. type: =head2
27283 #: ../fish/guestfish-actions.pod:4456
27284 msgid "tail"
27285 msgstr ""
27286
27287 #. type: verbatim
27288 #: ../fish/guestfish-actions.pod:4458
27289 #, no-wrap
27290 msgid ""
27291 " tail path\n"
27292 "\n"
27293 msgstr ""
27294
27295 #. type: =head2
27296 #: ../fish/guestfish-actions.pod:4466
27297 msgid "tail-n"
27298 msgstr ""
27299
27300 #. type: verbatim
27301 #: ../fish/guestfish-actions.pod:4468
27302 #, no-wrap
27303 msgid ""
27304 " tail-n nrlines path\n"
27305 "\n"
27306 msgstr ""
27307
27308 #. type: =head2
27309 #: ../fish/guestfish-actions.pod:4481
27310 msgid "tar-in"
27311 msgstr ""
27312
27313 #. type: verbatim
27314 #: ../fish/guestfish-actions.pod:4483
27315 #, no-wrap
27316 msgid ""
27317 " tar-in (tarfile|-) directory\n"
27318 "\n"
27319 msgstr ""
27320
27321 #. type: textblock
27322 #: ../fish/guestfish-actions.pod:4488
27323 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>."
27324 msgstr ""
27325
27326 #. type: =head2
27327 #: ../fish/guestfish-actions.pod:4493
27328 msgid "tar-out"
27329 msgstr ""
27330
27331 #. type: verbatim
27332 #: ../fish/guestfish-actions.pod:4495
27333 #, no-wrap
27334 msgid ""
27335 " tar-out directory (tarfile|-)\n"
27336 "\n"
27337 msgstr ""
27338
27339 #. type: textblock
27340 #: ../fish/guestfish-actions.pod:4500
27341 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>."
27342 msgstr ""
27343
27344 #. type: =head2
27345 #: ../fish/guestfish-actions.pod:4505
27346 msgid "tgz-in"
27347 msgstr ""
27348
27349 #. type: verbatim
27350 #: ../fish/guestfish-actions.pod:4507
27351 #, no-wrap
27352 msgid ""
27353 " tgz-in (tarball|-) directory\n"
27354 "\n"
27355 msgstr ""
27356
27357 #. type: textblock
27358 #: ../fish/guestfish-actions.pod:4512
27359 msgid "To upload an uncompressed tarball, use L</tar-in>."
27360 msgstr ""
27361
27362 #. type: =head2
27363 #: ../fish/guestfish-actions.pod:4516
27364 msgid "tgz-out"
27365 msgstr ""
27366
27367 #. type: verbatim
27368 #: ../fish/guestfish-actions.pod:4518
27369 #, no-wrap
27370 msgid ""
27371 " tgz-out directory (tarball|-)\n"
27372 "\n"
27373 msgstr ""
27374
27375 #. type: textblock
27376 #: ../fish/guestfish-actions.pod:4523
27377 msgid "To download an uncompressed tarball, use L</tar-out>."
27378 msgstr ""
27379
27380 #. type: =head2
27381 #: ../fish/guestfish-actions.pod:4527
27382 msgid "touch"
27383 msgstr ""
27384
27385 #. type: verbatim
27386 #: ../fish/guestfish-actions.pod:4529
27387 #, no-wrap
27388 msgid ""
27389 " touch path\n"
27390 "\n"
27391 msgstr ""
27392
27393 #. type: =head2
27394 #: ../fish/guestfish-actions.pod:4538
27395 msgid "truncate"
27396 msgstr ""
27397
27398 #. type: verbatim
27399 #: ../fish/guestfish-actions.pod:4540
27400 #, no-wrap
27401 msgid ""
27402 " truncate path\n"
27403 "\n"
27404 msgstr ""
27405
27406 #. type: =head2
27407 #: ../fish/guestfish-actions.pod:4545
27408 msgid "truncate-size"
27409 msgstr ""
27410
27411 #. type: verbatim
27412 #: ../fish/guestfish-actions.pod:4547
27413 #, no-wrap
27414 msgid ""
27415 " truncate-size path size\n"
27416 "\n"
27417 msgstr ""
27418
27419 #. type: textblock
27420 #: ../fish/guestfish-actions.pod:4552
27421 msgid ""
27422 "If the current file size is less than C<size> then the file is extended to "
27423 "the required size with zero bytes.  This creates a sparse file (ie. disk "
27424 "blocks are not allocated for the file until you write to it).  To create a "
27425 "non-sparse file of zeroes, use L</fallocate64> instead."
27426 msgstr ""
27427
27428 #. type: =head2
27429 #: ../fish/guestfish-actions.pod:4558
27430 msgid "tune2fs-l"
27431 msgstr ""
27432
27433 #. type: verbatim
27434 #: ../fish/guestfish-actions.pod:4560
27435 #, no-wrap
27436 msgid ""
27437 " tune2fs-l device\n"
27438 "\n"
27439 msgstr ""
27440
27441 #. type: =head2
27442 #: ../fish/guestfish-actions.pod:4570
27443 msgid "txz-in"
27444 msgstr ""
27445
27446 #. type: verbatim
27447 #: ../fish/guestfish-actions.pod:4572
27448 #, no-wrap
27449 msgid ""
27450 " txz-in (tarball|-) directory\n"
27451 "\n"
27452 msgstr ""
27453
27454 #. type: =head2
27455 #: ../fish/guestfish-actions.pod:4579
27456 msgid "txz-out"
27457 msgstr ""
27458
27459 #. type: verbatim
27460 #: ../fish/guestfish-actions.pod:4581
27461 #, no-wrap
27462 msgid ""
27463 " txz-out directory (tarball|-)\n"
27464 "\n"
27465 msgstr ""
27466
27467 #. type: =head2
27468 #: ../fish/guestfish-actions.pod:4588
27469 msgid "umask"
27470 msgstr ""
27471
27472 #. type: verbatim
27473 #: ../fish/guestfish-actions.pod:4590
27474 #, no-wrap
27475 msgid ""
27476 " umask mask\n"
27477 "\n"
27478 msgstr ""
27479
27480 #. type: textblock
27481 #: ../fish/guestfish-actions.pod:4604
27482 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>."
27483 msgstr ""
27484
27485 #. type: =head2
27486 #: ../fish/guestfish-actions.pod:4609
27487 msgid "umount"
27488 msgstr ""
27489
27490 #. type: =head2
27491 #: ../fish/guestfish-actions.pod:4611
27492 msgid "unmount"
27493 msgstr ""
27494
27495 #. type: verbatim
27496 #: ../fish/guestfish-actions.pod:4613
27497 #, no-wrap
27498 msgid ""
27499 " umount pathordevice\n"
27500 "\n"
27501 msgstr ""
27502
27503 #. type: =head2
27504 #: ../fish/guestfish-actions.pod:4619
27505 msgid "umount-all"
27506 msgstr ""
27507
27508 #. type: =head2
27509 #: ../fish/guestfish-actions.pod:4621
27510 msgid "unmount-all"
27511 msgstr ""
27512
27513 #. type: verbatim
27514 #: ../fish/guestfish-actions.pod:4623
27515 #, no-wrap
27516 msgid ""
27517 " umount-all\n"
27518 "\n"
27519 msgstr ""
27520
27521 #. type: =head2
27522 #: ../fish/guestfish-actions.pod:4629
27523 msgid "upload"
27524 msgstr ""
27525
27526 #. type: verbatim
27527 #: ../fish/guestfish-actions.pod:4631
27528 #, no-wrap
27529 msgid ""
27530 " upload (filename|-) remotefilename\n"
27531 "\n"
27532 msgstr ""
27533
27534 #. type: textblock
27535 #: ../fish/guestfish-actions.pod:4638
27536 msgid "See also L</download>."
27537 msgstr ""
27538
27539 #. type: =head2
27540 #: ../fish/guestfish-actions.pod:4642
27541 msgid "upload-offset"
27542 msgstr ""
27543
27544 #. type: verbatim
27545 #: ../fish/guestfish-actions.pod:4644
27546 #, no-wrap
27547 msgid ""
27548 " upload-offset (filename|-) remotefilename offset\n"
27549 "\n"
27550 msgstr ""
27551
27552 #. type: textblock
27553 #: ../fish/guestfish-actions.pod:4656
27554 msgid ""
27555 "Note that there is no limit on the amount of data that can be uploaded with "
27556 "this call, unlike with L</pwrite>, and this call always writes the full "
27557 "amount unless an error occurs."
27558 msgstr ""
27559
27560 #. type: textblock
27561 #: ../fish/guestfish-actions.pod:4661
27562 msgid "See also L</upload>, L</pwrite>."
27563 msgstr ""
27564
27565 #. type: =head2
27566 #: ../fish/guestfish-actions.pod:4665
27567 msgid "utimens"
27568 msgstr ""
27569
27570 #. type: verbatim
27571 #: ../fish/guestfish-actions.pod:4667
27572 #, no-wrap
27573 msgid ""
27574 " utimens path atsecs atnsecs mtsecs mtnsecs\n"
27575 "\n"
27576 msgstr ""
27577
27578 #. type: =head2
27579 #: ../fish/guestfish-actions.pod:4686
27580 msgid "version"
27581 msgstr ""
27582
27583 #. type: verbatim
27584 #: ../fish/guestfish-actions.pod:4688
27585 #, no-wrap
27586 msgid ""
27587 " version\n"
27588 "\n"
27589 msgstr ""
27590
27591 #. type: textblock
27592 #: ../fish/guestfish-actions.pod:4715
27593 msgid ""
27594 "I<Note:> Don't use this call to test for availability of features.  In "
27595 "enterprise distributions we backport features from later versions into "
27596 "earlier versions, making this an unreliable way to test for features.  Use "
27597 "L</available> instead."
27598 msgstr ""
27599
27600 #. type: =head2
27601 #: ../fish/guestfish-actions.pod:4721
27602 msgid "vfs-label"
27603 msgstr ""
27604
27605 #. type: verbatim
27606 #: ../fish/guestfish-actions.pod:4723
27607 #, no-wrap
27608 msgid ""
27609 " vfs-label device\n"
27610 "\n"
27611 msgstr ""
27612
27613 #. type: textblock
27614 #: ../fish/guestfish-actions.pod:4730
27615 msgid "To find a filesystem from the label, use L</findfs-label>."
27616 msgstr ""
27617
27618 #. type: =head2
27619 #: ../fish/guestfish-actions.pod:4732
27620 msgid "vfs-type"
27621 msgstr ""
27622
27623 #. type: verbatim
27624 #: ../fish/guestfish-actions.pod:4734
27625 #, no-wrap
27626 msgid ""
27627 " vfs-type device\n"
27628 "\n"
27629 msgstr ""
27630
27631 #. type: =head2
27632 #: ../fish/guestfish-actions.pod:4744
27633 msgid "vfs-uuid"
27634 msgstr ""
27635
27636 #. type: verbatim
27637 #: ../fish/guestfish-actions.pod:4746
27638 #, no-wrap
27639 msgid ""
27640 " vfs-uuid device\n"
27641 "\n"
27642 msgstr ""
27643
27644 #. type: textblock
27645 #: ../fish/guestfish-actions.pod:4753
27646 msgid "To find a filesystem from the UUID, use L</findfs-uuid>."
27647 msgstr ""
27648
27649 #. type: =head2
27650 #: ../fish/guestfish-actions.pod:4755
27651 msgid "vg-activate"
27652 msgstr ""
27653
27654 #. type: verbatim
27655 #: ../fish/guestfish-actions.pod:4757
27656 #, no-wrap
27657 msgid ""
27658 " vg-activate true|false 'volgroups ...'\n"
27659 "\n"
27660 msgstr ""
27661
27662 #. type: =head2
27663 #: ../fish/guestfish-actions.pod:4770
27664 msgid "vg-activate-all"
27665 msgstr ""
27666
27667 #. type: verbatim
27668 #: ../fish/guestfish-actions.pod:4772
27669 #, no-wrap
27670 msgid ""
27671 " vg-activate-all true|false\n"
27672 "\n"
27673 msgstr ""
27674
27675 #. type: =head2
27676 #: ../fish/guestfish-actions.pod:4782
27677 msgid "vgcreate"
27678 msgstr ""
27679
27680 #. type: verbatim
27681 #: ../fish/guestfish-actions.pod:4784
27682 #, no-wrap
27683 msgid ""
27684 " vgcreate volgroup 'physvols ...'\n"
27685 "\n"
27686 msgstr ""
27687
27688 #. type: =head2
27689 #: ../fish/guestfish-actions.pod:4789
27690 msgid "vglvuuids"
27691 msgstr ""
27692
27693 #. type: verbatim
27694 #: ../fish/guestfish-actions.pod:4791
27695 #, no-wrap
27696 msgid ""
27697 " vglvuuids vgname\n"
27698 "\n"
27699 msgstr ""
27700
27701 #. type: textblock
27702 #: ../fish/guestfish-actions.pod:4796
27703 msgid ""
27704 "You can use this along with L</lvs> and L</lvuuid> calls to associate "
27705 "logical volumes and volume groups."
27706 msgstr ""
27707
27708 #. type: textblock
27709 #: ../fish/guestfish-actions.pod:4799
27710 msgid "See also L</vgpvuuids>."
27711 msgstr ""
27712
27713 #. type: =head2
27714 #: ../fish/guestfish-actions.pod:4801
27715 msgid "vgpvuuids"
27716 msgstr ""
27717
27718 #. type: verbatim
27719 #: ../fish/guestfish-actions.pod:4803
27720 #, no-wrap
27721 msgid ""
27722 " vgpvuuids vgname\n"
27723 "\n"
27724 msgstr ""
27725
27726 #. type: textblock
27727 #: ../fish/guestfish-actions.pod:4808
27728 msgid ""
27729 "You can use this along with L</pvs> and L</pvuuid> calls to associate "
27730 "physical volumes and volume groups."
27731 msgstr ""
27732
27733 #. type: textblock
27734 #: ../fish/guestfish-actions.pod:4811
27735 msgid "See also L</vglvuuids>."
27736 msgstr ""
27737
27738 #. type: =head2
27739 #: ../fish/guestfish-actions.pod:4813
27740 msgid "vgremove"
27741 msgstr ""
27742
27743 #. type: verbatim
27744 #: ../fish/guestfish-actions.pod:4815
27745 #, no-wrap
27746 msgid ""
27747 " vgremove vgname\n"
27748 "\n"
27749 msgstr ""
27750
27751 #. type: =head2
27752 #: ../fish/guestfish-actions.pod:4822
27753 msgid "vgrename"
27754 msgstr ""
27755
27756 #. type: verbatim
27757 #: ../fish/guestfish-actions.pod:4824
27758 #, no-wrap
27759 msgid ""
27760 " vgrename volgroup newvolgroup\n"
27761 "\n"
27762 msgstr ""
27763
27764 #. type: =head2
27765 #: ../fish/guestfish-actions.pod:4828
27766 msgid "vgs"
27767 msgstr ""
27768
27769 #. type: verbatim
27770 #: ../fish/guestfish-actions.pod:4830
27771 #, no-wrap
27772 msgid ""
27773 " vgs\n"
27774 "\n"
27775 msgstr ""
27776
27777 #. type: textblock
27778 #: ../fish/guestfish-actions.pod:4838
27779 msgid "See also L</vgs-full>."
27780 msgstr ""
27781
27782 #. type: =head2
27783 #: ../fish/guestfish-actions.pod:4840
27784 msgid "vgs-full"
27785 msgstr ""
27786
27787 #. type: verbatim
27788 #: ../fish/guestfish-actions.pod:4842
27789 #, no-wrap
27790 msgid ""
27791 " vgs-full\n"
27792 "\n"
27793 msgstr ""
27794
27795 #. type: =head2
27796 #: ../fish/guestfish-actions.pod:4847
27797 msgid "vgscan"
27798 msgstr ""
27799
27800 #. type: verbatim
27801 #: ../fish/guestfish-actions.pod:4849
27802 #, no-wrap
27803 msgid ""
27804 " vgscan\n"
27805 "\n"
27806 msgstr ""
27807
27808 #. type: =head2
27809 #: ../fish/guestfish-actions.pod:4854
27810 msgid "vguuid"
27811 msgstr ""
27812
27813 #. type: verbatim
27814 #: ../fish/guestfish-actions.pod:4856
27815 #, no-wrap
27816 msgid ""
27817 " vguuid vgname\n"
27818 "\n"
27819 msgstr ""
27820
27821 #. type: =head2
27822 #: ../fish/guestfish-actions.pod:4860
27823 msgid "wc-c"
27824 msgstr ""
27825
27826 #. type: verbatim
27827 #: ../fish/guestfish-actions.pod:4862
27828 #, no-wrap
27829 msgid ""
27830 " wc-c path\n"
27831 "\n"
27832 msgstr ""
27833
27834 #. type: =head2
27835 #: ../fish/guestfish-actions.pod:4867
27836 msgid "wc-l"
27837 msgstr ""
27838
27839 #. type: verbatim
27840 #: ../fish/guestfish-actions.pod:4869
27841 #, no-wrap
27842 msgid ""
27843 " wc-l path\n"
27844 "\n"
27845 msgstr ""
27846
27847 #. type: =head2
27848 #: ../fish/guestfish-actions.pod:4874
27849 msgid "wc-w"
27850 msgstr ""
27851
27852 #. type: verbatim
27853 #: ../fish/guestfish-actions.pod:4876
27854 #, no-wrap
27855 msgid ""
27856 " wc-w path\n"
27857 "\n"
27858 msgstr ""
27859
27860 #. type: =head2
27861 #: ../fish/guestfish-actions.pod:4881
27862 msgid "write"
27863 msgstr ""
27864
27865 #. type: verbatim
27866 #: ../fish/guestfish-actions.pod:4883
27867 #, no-wrap
27868 msgid ""
27869 " write path content\n"
27870 "\n"
27871 msgstr ""
27872
27873 #. type: =head2
27874 #: ../fish/guestfish-actions.pod:4891
27875 msgid "write-file"
27876 msgstr ""
27877
27878 #. type: verbatim
27879 #: ../fish/guestfish-actions.pod:4893
27880 #, no-wrap
27881 msgid ""
27882 " write-file path content size\n"
27883 "\n"
27884 msgstr ""
27885
27886 #. type: textblock
27887 #: ../fish/guestfish-actions.pod:4909
27888 msgid ""
27889 "This function is deprecated.  In new code, use the L</write> call instead."
27890 msgstr ""
27891
27892 #. type: =head2
27893 #: ../fish/guestfish-actions.pod:4916
27894 msgid "zegrep"
27895 msgstr ""
27896
27897 #. type: verbatim
27898 #: ../fish/guestfish-actions.pod:4918
27899 #, no-wrap
27900 msgid ""
27901 " zegrep regex path\n"
27902 "\n"
27903 msgstr ""
27904
27905 #. type: =head2
27906 #: ../fish/guestfish-actions.pod:4926
27907 msgid "zegrepi"
27908 msgstr ""
27909
27910 #. type: verbatim
27911 #: ../fish/guestfish-actions.pod:4928
27912 #, no-wrap
27913 msgid ""
27914 " zegrepi regex path\n"
27915 "\n"
27916 msgstr ""
27917
27918 #. type: =head2
27919 #: ../fish/guestfish-actions.pod:4936
27920 msgid "zero"
27921 msgstr ""
27922
27923 #. type: verbatim
27924 #: ../fish/guestfish-actions.pod:4938
27925 #, no-wrap
27926 msgid ""
27927 " zero device\n"
27928 "\n"
27929 msgstr ""
27930
27931 #. type: textblock
27932 #: ../fish/guestfish-actions.pod:4946
27933 msgid "See also: L</zero-device>, L</scrub-device>."
27934 msgstr ""
27935
27936 #. type: =head2
27937 #: ../fish/guestfish-actions.pod:4948
27938 msgid "zero-device"
27939 msgstr ""
27940
27941 #. type: verbatim
27942 #: ../fish/guestfish-actions.pod:4950
27943 #, no-wrap
27944 msgid ""
27945 " zero-device device\n"
27946 "\n"
27947 msgstr ""
27948
27949 #. type: textblock
27950 #: ../fish/guestfish-actions.pod:4952
27951 msgid ""
27952 "This command writes zeroes over the entire C<device>.  Compare with L</zero> "
27953 "which just zeroes the first few blocks of a device."
27954 msgstr ""
27955
27956 #. type: =head2
27957 #: ../fish/guestfish-actions.pod:4959
27958 msgid "zerofree"
27959 msgstr ""
27960
27961 #. type: verbatim
27962 #: ../fish/guestfish-actions.pod:4961
27963 #, no-wrap
27964 msgid ""
27965 " zerofree device\n"
27966 "\n"
27967 msgstr ""
27968
27969 #. type: =head2
27970 #: ../fish/guestfish-actions.pod:4974
27971 msgid "zfgrep"
27972 msgstr ""
27973
27974 #. type: verbatim
27975 #: ../fish/guestfish-actions.pod:4976
27976 #, no-wrap
27977 msgid ""
27978 " zfgrep pattern path\n"
27979 "\n"
27980 msgstr ""
27981
27982 #. type: =head2
27983 #: ../fish/guestfish-actions.pod:4984
27984 msgid "zfgrepi"
27985 msgstr ""
27986
27987 #. type: verbatim
27988 #: ../fish/guestfish-actions.pod:4986
27989 #, no-wrap
27990 msgid ""
27991 " zfgrepi pattern path\n"
27992 "\n"
27993 msgstr ""
27994
27995 #. type: =head2
27996 #: ../fish/guestfish-actions.pod:4994
27997 msgid "zfile"
27998 msgstr ""
27999
28000 #. type: verbatim
28001 #: ../fish/guestfish-actions.pod:4996
28002 #, no-wrap
28003 msgid ""
28004 " zfile meth path\n"
28005 "\n"
28006 msgstr ""
28007
28008 #. type: textblock
28009 #: ../fish/guestfish-actions.pod:5003
28010 msgid ""
28011 "Since 1.0.63, use L</file> instead which can now process compressed files."
28012 msgstr ""
28013
28014 #. type: textblock
28015 #: ../fish/guestfish-actions.pod:5006
28016 msgid ""
28017 "This function is deprecated.  In new code, use the L</file> call instead."
28018 msgstr ""
28019
28020 #. type: =head2
28021 #: ../fish/guestfish-actions.pod:5013
28022 msgid "zgrep"
28023 msgstr ""
28024
28025 #. type: verbatim
28026 #: ../fish/guestfish-actions.pod:5015
28027 #, no-wrap
28028 msgid ""
28029 " zgrep regex path\n"
28030 "\n"
28031 msgstr ""
28032
28033 #. type: =head2
28034 #: ../fish/guestfish-actions.pod:5023
28035 msgid "zgrepi"
28036 msgstr ""
28037
28038 #. type: verbatim
28039 #: ../fish/guestfish-actions.pod:5025
28040 #, no-wrap
28041 msgid ""
28042 " zgrepi regex path\n"
28043 "\n"
28044 msgstr ""
28045
28046 #. type: =head2
28047 #: ../fish/guestfish-commands.pod:1
28048 msgid "alloc"
28049 msgstr ""
28050
28051 #. type: =head2
28052 #: ../fish/guestfish-commands.pod:3
28053 msgid "allocate"
28054 msgstr ""
28055
28056 #. type: verbatim
28057 #: ../fish/guestfish-commands.pod:5
28058 #, no-wrap
28059 msgid ""
28060 " alloc filename size\n"
28061 "\n"
28062 msgstr ""
28063
28064 #. type: textblock
28065 #: ../fish/guestfish-commands.pod:7
28066 msgid ""
28067 "This creates an empty (zeroed) file of the given size, and then adds so it "
28068 "can be further examined."
28069 msgstr ""
28070
28071 #. type: textblock
28072 #: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:168
28073 msgid "For more advanced image creation, see L<qemu-img(1)> utility."
28074 msgstr ""
28075
28076 #. type: textblock
28077 #: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:170
28078 msgid "Size can be specified using standard suffixes, eg. C<1M>."
28079 msgstr ""
28080
28081 #. type: textblock
28082 #: ../fish/guestfish-commands.pod:14
28083 msgid ""
28084 "To create a sparse file, use L</sparse> instead.  To create a prepared disk "
28085 "image, see L</PREPARED DISK IMAGES>."
28086 msgstr ""
28087
28088 #. type: =head2
28089 #: ../fish/guestfish-commands.pod:17
28090 msgid "copy-in"
28091 msgstr ""
28092
28093 #. type: verbatim
28094 #: ../fish/guestfish-commands.pod:19
28095 #, no-wrap
28096 msgid ""
28097 " copy-in local [local ...] /remotedir\n"
28098 "\n"
28099 msgstr ""
28100
28101 #. type: textblock
28102 #: ../fish/guestfish-commands.pod:21
28103 msgid ""
28104 "C<copy-in> copies local files or directories recursively into the disk "
28105 "image, placing them in the directory called C</remotedir> (which must "
28106 "exist).  This guestfish meta-command turns into a sequence of L</tar-in> and "
28107 "other commands as necessary."
28108 msgstr ""
28109
28110 #. type: textblock
28111 #: ../fish/guestfish-commands.pod:26
28112 msgid ""
28113 "Multiple local files and directories can be specified, but the last "
28114 "parameter must always be a remote directory.  Wildcards cannot be used."
28115 msgstr ""
28116
28117 #. type: =head2
28118 #: ../fish/guestfish-commands.pod:30
28119 msgid "copy-out"
28120 msgstr ""
28121
28122 #. type: verbatim
28123 #: ../fish/guestfish-commands.pod:32
28124 #, no-wrap
28125 msgid ""
28126 " copy-out remote [remote ...] localdir\n"
28127 "\n"
28128 msgstr ""
28129
28130 #. type: textblock
28131 #: ../fish/guestfish-commands.pod:34
28132 msgid ""
28133 "C<copy-out> copies remote files or directories recursively out of the disk "
28134 "image, placing them on the host disk in a local directory called C<localdir> "
28135 "(which must exist).  This guestfish meta-command turns into a sequence of L</"
28136 "download>, L</tar-out> and other commands as necessary."
28137 msgstr ""
28138
28139 #. type: textblock
28140 #: ../fish/guestfish-commands.pod:40
28141 msgid ""
28142 "Multiple remote files and directories can be specified, but the last "
28143 "parameter must always be a local directory.  To download to the current "
28144 "directory, use C<.> as in:"
28145 msgstr ""
28146
28147 #. type: verbatim
28148 #: ../fish/guestfish-commands.pod:44
28149 #, no-wrap
28150 msgid ""
28151 " copy-out /home .\n"
28152 "\n"
28153 msgstr ""
28154
28155 #. type: textblock
28156 #: ../fish/guestfish-commands.pod:46
28157 msgid ""
28158 "Wildcards cannot be used in the ordinary command, but you can use them with "
28159 "the help of L</glob> like this:"
28160 msgstr ""
28161
28162 #. type: verbatim
28163 #: ../fish/guestfish-commands.pod:49
28164 #, no-wrap
28165 msgid ""
28166 " glob copy-out /home/* .\n"
28167 "\n"
28168 msgstr ""
28169
28170 #. type: =head2
28171 #: ../fish/guestfish-commands.pod:51
28172 msgid "echo"
28173 msgstr ""
28174
28175 #. type: verbatim
28176 #: ../fish/guestfish-commands.pod:53
28177 #, no-wrap
28178 msgid ""
28179 " echo [params ...]\n"
28180 "\n"
28181 msgstr ""
28182
28183 #. type: textblock
28184 #: ../fish/guestfish-commands.pod:55
28185 msgid "This echos the parameters to the terminal."
28186 msgstr ""
28187
28188 #. type: =head2
28189 #: ../fish/guestfish-commands.pod:57
28190 msgid "edit"
28191 msgstr ""
28192
28193 #. type: =head2
28194 #: ../fish/guestfish-commands.pod:59
28195 msgid "vi"
28196 msgstr ""
28197
28198 #. type: =head2
28199 #: ../fish/guestfish-commands.pod:61
28200 msgid "emacs"
28201 msgstr ""
28202
28203 #. type: verbatim
28204 #: ../fish/guestfish-commands.pod:63
28205 #, no-wrap
28206 msgid ""
28207 " edit filename\n"
28208 "\n"
28209 msgstr ""
28210
28211 #. type: textblock
28212 #: ../fish/guestfish-commands.pod:65
28213 msgid ""
28214 "This is used to edit a file.  It downloads the file, edits it locally using "
28215 "your editor, then uploads the result."
28216 msgstr ""
28217
28218 #. type: textblock
28219 #: ../fish/guestfish-commands.pod:68
28220 msgid ""
28221 "The editor is C<$EDITOR>.  However if you use the alternate commands C<vi> "
28222 "or C<emacs> you will get those corresponding editors."
28223 msgstr ""
28224
28225 #. type: =head2
28226 #: ../fish/guestfish-commands.pod:72
28227 msgid "glob"
28228 msgstr ""
28229
28230 #. type: verbatim
28231 #: ../fish/guestfish-commands.pod:74
28232 #, no-wrap
28233 msgid ""
28234 " glob command args...\n"
28235 "\n"
28236 msgstr ""
28237
28238 #. type: textblock
28239 #: ../fish/guestfish-commands.pod:76
28240 msgid ""
28241 "Expand wildcards in any paths in the args list, and run C<command> "
28242 "repeatedly on each matching path."
28243 msgstr ""
28244
28245 #. type: textblock
28246 #: ../fish/guestfish-commands.pod:79
28247 msgid "See L</WILDCARDS AND GLOBBING>."
28248 msgstr ""
28249
28250 #. type: =head2
28251 #: ../fish/guestfish-commands.pod:81
28252 msgid "hexedit"
28253 msgstr ""
28254
28255 #. type: verbatim
28256 #: ../fish/guestfish-commands.pod:83
28257 #, no-wrap
28258 msgid ""
28259 " hexedit <filename|device>\n"
28260 " hexedit <filename|device> <max>\n"
28261 " hexedit <filename|device> <start> <max>\n"
28262 "\n"
28263 msgstr ""
28264
28265 #. type: textblock
28266 #: ../fish/guestfish-commands.pod:87
28267 msgid ""
28268 "Use hexedit (a hex editor) to edit all or part of a binary file or block "
28269 "device."
28270 msgstr ""
28271
28272 #. type: textblock
28273 #: ../fish/guestfish-commands.pod:90
28274 msgid ""
28275 "This command works by downloading potentially the whole file or device, "
28276 "editing it locally, then uploading it.  If the file or device is large, you "
28277 "have to specify which part you wish to edit by using C<max> and/or C<start> "
28278 "C<max> parameters.  C<start> and C<max> are specified in bytes, with the "
28279 "usual modifiers allowed such as C<1M> (1 megabyte)."
28280 msgstr ""
28281
28282 #. type: textblock
28283 #: ../fish/guestfish-commands.pod:97
28284 msgid "For example to edit the first few sectors of a disk you might do:"
28285 msgstr ""
28286
28287 #. type: verbatim
28288 #: ../fish/guestfish-commands.pod:100
28289 #, no-wrap
28290 msgid ""
28291 " hexedit /dev/sda 1M\n"
28292 "\n"
28293 msgstr ""
28294
28295 #. type: textblock
28296 #: ../fish/guestfish-commands.pod:102
28297 msgid ""
28298 "which would allow you to edit anywhere within the first megabyte of the disk."
28299 msgstr ""
28300
28301 #. type: textblock
28302 #: ../fish/guestfish-commands.pod:105
28303 msgid "To edit the superblock of an ext2 filesystem on C</dev/sda1>, do:"
28304 msgstr ""
28305
28306 #. type: verbatim
28307 #: ../fish/guestfish-commands.pod:107
28308 #, no-wrap
28309 msgid ""
28310 " hexedit /dev/sda1 0x400 0x400\n"
28311 "\n"
28312 msgstr ""
28313
28314 #. type: textblock
28315 #: ../fish/guestfish-commands.pod:109
28316 msgid "(assuming the superblock is in the standard location)."
28317 msgstr ""
28318
28319 #. type: textblock
28320 #: ../fish/guestfish-commands.pod:111
28321 msgid ""
28322 "This command requires the external L<hexedit(1)> program.  You can specify "
28323 "another program to use by setting the C<HEXEDITOR> environment variable."
28324 msgstr ""
28325
28326 #. type: textblock
28327 #: ../fish/guestfish-commands.pod:115
28328 msgid "See also L</hexdump>."
28329 msgstr ""
28330
28331 #. type: =head2
28332 #: ../fish/guestfish-commands.pod:117
28333 msgid "lcd"
28334 msgstr ""
28335
28336 #. type: verbatim
28337 #: ../fish/guestfish-commands.pod:119
28338 #, no-wrap
28339 msgid ""
28340 " lcd directory\n"
28341 "\n"
28342 msgstr ""
28343
28344 #. type: textblock
28345 #: ../fish/guestfish-commands.pod:121
28346 msgid ""
28347 "Change the local directory, ie. the current directory of guestfish itself."
28348 msgstr ""
28349
28350 #. type: textblock
28351 #: ../fish/guestfish-commands.pod:124
28352 msgid "Note that C<!cd> won't do what you might expect."
28353 msgstr ""
28354
28355 #. type: =head2
28356 #: ../fish/guestfish-commands.pod:126
28357 msgid "man"
28358 msgstr ""
28359
28360 #. type: =head2
28361 #: ../fish/guestfish-commands.pod:128
28362 msgid "manual"
28363 msgstr ""
28364
28365 #. type: verbatim
28366 #: ../fish/guestfish-commands.pod:130
28367 #, no-wrap
28368 msgid ""
28369 "  man\n"
28370 "\n"
28371 msgstr ""
28372
28373 #. type: textblock
28374 #: ../fish/guestfish-commands.pod:132
28375 msgid "Opens the manual page for guestfish."
28376 msgstr ""
28377
28378 #. type: =head2
28379 #: ../fish/guestfish-commands.pod:134
28380 msgid "more"
28381 msgstr ""
28382
28383 #. type: =head2
28384 #: ../fish/guestfish-commands.pod:136
28385 msgid "less"
28386 msgstr ""
28387
28388 #. type: verbatim
28389 #: ../fish/guestfish-commands.pod:138
28390 #, no-wrap
28391 msgid ""
28392 " more filename\n"
28393 "\n"
28394 msgstr ""
28395
28396 #. type: verbatim
28397 #: ../fish/guestfish-commands.pod:140
28398 #, no-wrap
28399 msgid ""
28400 " less filename\n"
28401 "\n"
28402 msgstr ""
28403
28404 #. type: textblock
28405 #: ../fish/guestfish-commands.pod:142
28406 msgid "This is used to view a file."
28407 msgstr ""
28408
28409 #. type: textblock
28410 #: ../fish/guestfish-commands.pod:144
28411 msgid ""
28412 "The default viewer is C<$PAGER>.  However if you use the alternate command "
28413 "C<less> you will get the C<less> command specifically."
28414 msgstr ""
28415
28416 #. type: =head2
28417 #: ../fish/guestfish-commands.pod:147
28418 msgid "reopen"
28419 msgstr ""
28420
28421 #. type: verbatim
28422 #: ../fish/guestfish-commands.pod:149
28423 #, no-wrap
28424 msgid ""
28425 "  reopen\n"
28426 "\n"
28427 msgstr ""
28428
28429 #. type: textblock
28430 #: ../fish/guestfish-commands.pod:151
28431 msgid ""
28432 "Close and reopen the libguestfs handle.  It is not necessary to use this "
28433 "normally, because the handle is closed properly when guestfish exits.  "
28434 "However this is occasionally useful for testing."
28435 msgstr ""
28436
28437 #. type: =head2
28438 #: ../fish/guestfish-commands.pod:155
28439 msgid "sparse"
28440 msgstr ""
28441
28442 #. type: verbatim
28443 #: ../fish/guestfish-commands.pod:157
28444 #, no-wrap
28445 msgid ""
28446 " sparse filename size\n"
28447 "\n"
28448 msgstr ""
28449
28450 #. type: textblock
28451 #: ../fish/guestfish-commands.pod:159
28452 msgid ""
28453 "This creates an empty sparse file of the given size, and then adds so it can "
28454 "be further examined."
28455 msgstr ""
28456
28457 #. type: textblock
28458 #: ../fish/guestfish-commands.pod:162
28459 msgid ""
28460 "In all respects it works the same as the L</alloc> command, except that the "
28461 "image file is allocated sparsely, which means that disk blocks are not "
28462 "assigned to the file until they are needed.  Sparse disk files only use "
28463 "space when written to, but they are slower and there is a danger you could "
28464 "run out of real disk space during a write operation."
28465 msgstr ""
28466
28467 #. type: =head2
28468 #: ../fish/guestfish-commands.pod:172
28469 msgid "supported"
28470 msgstr ""
28471
28472 #. type: verbatim
28473 #: ../fish/guestfish-commands.pod:174
28474 #, no-wrap
28475 msgid ""
28476 " supported\n"
28477 "\n"
28478 msgstr ""
28479
28480 #. type: textblock
28481 #: ../fish/guestfish-commands.pod:176
28482 msgid ""
28483 "This command returns a list of the optional groups known to the daemon, and "
28484 "indicates which ones are supported by this build of the libguestfs appliance."
28485 msgstr ""
28486
28487 #. type: textblock
28488 #: ../fish/guestfish-commands.pod:180
28489 msgid "See also L<guestfs(3)/AVAILABILITY>."
28490 msgstr ""
28491
28492 #. type: =head2
28493 #: ../fish/guestfish-commands.pod:182
28494 msgid "time"
28495 msgstr ""
28496
28497 #. type: verbatim
28498 #: ../fish/guestfish-commands.pod:184
28499 #, no-wrap
28500 msgid ""
28501 " time command args...\n"
28502 "\n"
28503 msgstr ""
28504
28505 #. type: textblock
28506 #: ../fish/guestfish-commands.pod:186
28507 msgid ""
28508 "Run the command as usual, but print the elapsed time afterwards.  This can "
28509 "be useful for benchmarking operations."
28510 msgstr ""
28511
28512 #. type: textblock
28513 #: ../test-tool/libguestfs-test-tool.pod:5
28514 msgid "libguestfs-test-tool - End user tests for libguestfs"
28515 msgstr ""
28516
28517 #. type: verbatim
28518 #: ../test-tool/libguestfs-test-tool.pod:9
28519 #, no-wrap
28520 msgid ""
28521 " libguestfs-test-tool [--options]\n"
28522 "\n"
28523 msgstr ""
28524
28525 #. type: textblock
28526 #: ../test-tool/libguestfs-test-tool.pod:13
28527 msgid ""
28528 "libguestfs-test-tool is a test program shipped with libguestfs to end users "
28529 "and developers, to allow them to check basic libguestfs functionality is "
28530 "working.  This is needed because libguestfs occasionally breaks for reasons "
28531 "beyond our control: usually because of changes in the underlying qemu or "
28532 "kernel packages, or the host environment."
28533 msgstr ""
28534
28535 #. type: textblock
28536 #: ../test-tool/libguestfs-test-tool.pod:20
28537 msgid "If you suspect a problem in libguestfs, then just run:"
28538 msgstr ""
28539
28540 #. type: verbatim
28541 #: ../test-tool/libguestfs-test-tool.pod:22
28542 #, no-wrap
28543 msgid ""
28544 " libguestfs-test-tool\n"
28545 "\n"
28546 msgstr ""
28547
28548 #. type: textblock
28549 #: ../test-tool/libguestfs-test-tool.pod:24
28550 msgid "It will print lots of diagnostic messages."
28551 msgstr ""
28552
28553 #. type: textblock
28554 #: ../test-tool/libguestfs-test-tool.pod:26
28555 msgid "If it runs to completion successfully, you will see this near the end:"
28556 msgstr ""
28557
28558 #. type: verbatim
28559 #: ../test-tool/libguestfs-test-tool.pod:28
28560 #, no-wrap
28561 msgid ""
28562 " ===== TEST FINISHED OK =====\n"
28563 "\n"
28564 msgstr ""
28565
28566 #. type: textblock
28567 #: ../test-tool/libguestfs-test-tool.pod:30
28568 msgid "and the test tool will exit with code 0."
28569 msgstr ""
28570
28571 #. type: textblock
28572 #: ../test-tool/libguestfs-test-tool.pod:32
28573 msgid ""
28574 "If it fails (and/or exits with non-zero error code), please paste the "
28575 "B<complete, unedited> output of the test tool into a bug report.  More "
28576 "information about reporting bugs can be found on the L<http://libguestfs.org/"
28577 "> website."
28578 msgstr ""
28579
28580 #. type: =item
28581 #: ../test-tool/libguestfs-test-tool.pod:41
28582 msgid "I<--help>"
28583 msgstr ""
28584
28585 #. type: textblock
28586 #: ../test-tool/libguestfs-test-tool.pod:43
28587 msgid "Display short usage information and exit."
28588 msgstr ""
28589
28590 #. type: =item
28591 #: ../test-tool/libguestfs-test-tool.pod:45
28592 msgid "I<--qemu qemu_binary>"
28593 msgstr ""
28594
28595 #. type: textblock
28596 #: ../test-tool/libguestfs-test-tool.pod:47
28597 msgid ""
28598 "If you have downloaded another qemu binary, point this option at the full "
28599 "path of the binary to try it."
28600 msgstr ""
28601
28602 #. type: =item
28603 #: ../test-tool/libguestfs-test-tool.pod:50
28604 msgid "I<--qemudir qemu_source_dir>"
28605 msgstr ""
28606
28607 #. type: textblock
28608 #: ../test-tool/libguestfs-test-tool.pod:52
28609 msgid ""
28610 "If you have compiled qemu from source, point this option at the source "
28611 "directory to try it."
28612 msgstr ""
28613
28614 #. type: =item
28615 #: ../test-tool/libguestfs-test-tool.pod:55
28616 msgid "I<--timeout N>"
28617 msgstr ""
28618
28619 #. type: textblock
28620 #: ../test-tool/libguestfs-test-tool.pod:57
28621 msgid ""
28622 "Set the launch timeout to C<N> seconds.  The default is 120 seconds which "
28623 "does not usually need to be adjusted unless your machine is very slow."
28624 msgstr ""
28625
28626 #. type: =head1
28627 #: ../test-tool/libguestfs-test-tool.pod:63
28628 msgid "TRYING OUT A DIFFERENT VERSION OF QEMU"
28629 msgstr ""
28630
28631 #. type: textblock
28632 #: ../test-tool/libguestfs-test-tool.pod:65
28633 msgid ""
28634 "If you have compiled another version of qemu from source and would like to "
28635 "try that, then you can use the I<--qemudir> option to point to the qemu "
28636 "source directory."
28637 msgstr ""
28638
28639 #. type: textblock
28640 #: ../test-tool/libguestfs-test-tool.pod:69
28641 msgid ""
28642 "If you have downloaded a qemu binary from somewhere, use the I<--qemu> "
28643 "option to point to the binary."
28644 msgstr ""
28645
28646 #. type: textblock
28647 #: ../test-tool/libguestfs-test-tool.pod:72
28648 msgid ""
28649 "When using an alternate qemu with libguestfs, usually you would need to "
28650 "write a qemu wrapper script (see section I<QEMU WRAPPERS> in L<guestfs(3)"
28651 ">).  libguestfs-test-tool writes a temporary qemu wrapper script when you "
28652 "use either of the I<--qemudir> or I<--qemu> options."
28653 msgstr ""
28654
28655 #. type: textblock
28656 #: ../test-tool/libguestfs-test-tool.pod:79
28657 msgid ""
28658 "libguestfs-test-tool returns I<0> if the tests completed without error, or "
28659 "I<1> if there was an error."
28660 msgstr ""
28661
28662 #. type: textblock
28663 #: ../test-tool/libguestfs-test-tool.pod:84
28664 msgid ""
28665 "For the full list of environment variables which may affect libguestfs, "
28666 "please see the L<guestfs(3)> manual page."
28667 msgstr ""
28668
28669 #. type: textblock
28670 #: ../test-tool/libguestfs-test-tool.pod:89
28671 msgid "L<guestfs(3)>, L<http://libguestfs.org/>, L<http://qemu.org/>."
28672 msgstr ""
28673
28674 #. type: textblock
28675 #: ../fuse/guestmount.pod:5
28676 msgid ""
28677 "guestmount - Mount a guest filesystem on the host using FUSE and libguestfs"
28678 msgstr ""
28679
28680 #. type: verbatim
28681 #: ../fuse/guestmount.pod:9
28682 #, no-wrap
28683 msgid ""
28684 " guestmount [--options] -a disk.img -m device [--ro] mountpoint\n"
28685 "\n"
28686 msgstr ""
28687
28688 #. type: verbatim
28689 #: ../fuse/guestmount.pod:11
28690 #, no-wrap
28691 msgid ""
28692 " guestmount [--options] -a disk.img -i [--ro] mountpoint\n"
28693 "\n"
28694 msgstr ""
28695
28696 #. type: verbatim
28697 #: ../fuse/guestmount.pod:13
28698 #, no-wrap
28699 msgid ""
28700 " guestmount [--options] -d Guest -i [--ro] mountpoint\n"
28701 "\n"
28702 msgstr ""
28703
28704 #. type: textblock
28705 #: ../fuse/guestmount.pod:17
28706 msgid ""
28707 "You must I<not> use C<guestmount> in read-write mode on live virtual "
28708 "machines.  If you do this, you risk disk corruption in the VM."
28709 msgstr ""
28710
28711 #. type: textblock
28712 #: ../fuse/guestmount.pod:22
28713 msgid ""
28714 "The guestmount program can be used to mount virtual machine filesystems and "
28715 "other disk images on the host.  It uses libguestfs for access to the guest "
28716 "filesystem, and FUSE (the \"filesystem in userspace\") to make it appear as "
28717 "a mountable device."
28718 msgstr ""
28719
28720 #. type: textblock
28721 #: ../fuse/guestmount.pod:27
28722 msgid ""
28723 "Along with other options, you have to give at least one device (I<-a> "
28724 "option) or libvirt domain (I<-d> option), and at least one mountpoint (I<-m> "
28725 "option) or use the I<-i> inspection option.  How this works is better "
28726 "explained in the L<guestfish(1)> manual page, or by looking at the examples "
28727 "below."
28728 msgstr ""
28729
28730 #. type: textblock
28731 #: ../fuse/guestmount.pod:33
28732 msgid ""
28733 "FUSE lets you mount filesystems as non-root.  The mountpoint must be owned "
28734 "by you, and the filesystem will not be visible to any other users unless you "
28735 "make certain global configuration changes to C</etc/fuse.conf>.  To unmount "
28736 "the filesystem, use the C<fusermount -u> command."
28737 msgstr ""
28738
28739 #. type: textblock
28740 #: ../fuse/guestmount.pod:41
28741 msgid ""
28742 "For a typical Windows guest which has its main filesystem on the first "
28743 "partition:"
28744 msgstr ""
28745
28746 #. type: verbatim
28747 #: ../fuse/guestmount.pod:44
28748 #, no-wrap
28749 msgid ""
28750 " guestmount -a windows.img -m /dev/sda1 --ro /mnt\n"
28751 "\n"
28752 msgstr ""
28753
28754 #. type: textblock
28755 #: ../fuse/guestmount.pod:46
28756 msgid ""
28757 "For a typical Linux guest which has a /boot filesystem on the first "
28758 "partition, and the root filesystem on a logical volume:"
28759 msgstr ""
28760
28761 #. type: verbatim
28762 #: ../fuse/guestmount.pod:49
28763 #, no-wrap
28764 msgid ""
28765 " guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt\n"
28766 "\n"
28767 msgstr ""
28768
28769 #. type: textblock
28770 #: ../fuse/guestmount.pod:51
28771 msgid "To get libguestfs to detect guest mountpoints for you:"
28772 msgstr ""
28773
28774 #. type: verbatim
28775 #: ../fuse/guestmount.pod:53
28776 #, no-wrap
28777 msgid ""
28778 " guestmount -a guest.img -i --ro /mnt\n"
28779 "\n"
28780 msgstr ""
28781
28782 #. type: textblock
28783 #: ../fuse/guestmount.pod:55
28784 msgid "For a libvirt guest called \"Guest\" you could do:"
28785 msgstr ""
28786
28787 #. type: verbatim
28788 #: ../fuse/guestmount.pod:57
28789 #, no-wrap
28790 msgid ""
28791 " guestmount -d Guest -i --ro /mnt\n"
28792 "\n"
28793 msgstr ""
28794
28795 #. type: textblock
28796 #: ../fuse/guestmount.pod:59
28797 msgid ""
28798 "If you don't know what filesystems are contained in a guest or disk image, "
28799 "use L<virt-filesystems(1)> first:"
28800 msgstr ""
28801
28802 #. type: verbatim
28803 #: ../fuse/guestmount.pod:62
28804 #, no-wrap
28805 msgid ""
28806 " virt-filesystems MyGuest\n"
28807 "\n"
28808 msgstr ""
28809
28810 #. type: textblock
28811 #: ../fuse/guestmount.pod:64
28812 msgid ""
28813 "If you want to trace the libguestfs calls but without excessive debugging "
28814 "information, we recommend:"
28815 msgstr ""
28816
28817 #. type: verbatim
28818 #: ../fuse/guestmount.pod:67
28819 #, no-wrap
28820 msgid ""
28821 " guestmount [...] --trace /mnt\n"
28822 "\n"
28823 msgstr ""
28824
28825 #. type: textblock
28826 #: ../fuse/guestmount.pod:69
28827 msgid "If you want to debug the program, we recommend:"
28828 msgstr ""
28829
28830 #. type: verbatim
28831 #: ../fuse/guestmount.pod:71
28832 #, no-wrap
28833 msgid ""
28834 " guestmount [...] --trace --verbose /mnt\n"
28835 "\n"
28836 msgstr ""
28837
28838 #. type: =head1
28839 #: ../fuse/guestmount.pod:73
28840 msgid "NOTES"
28841 msgstr ""
28842
28843 #. type: =head2
28844 #: ../fuse/guestmount.pod:75
28845 msgid "Other users cannot see the filesystem by default"
28846 msgstr ""
28847
28848 #. type: textblock
28849 #: ../fuse/guestmount.pod:77
28850 msgid ""
28851 "If you mount a filesystem as one user (eg. root), then other users will not "
28852 "be able to see it by default.  The fix is to add the FUSE C<allow_other> "
28853 "option when mounting:"
28854 msgstr ""
28855
28856 #. type: verbatim
28857 #: ../fuse/guestmount.pod:81
28858 #, no-wrap
28859 msgid ""
28860 " sudo guestmount [...] -o allow_other /mnt\n"
28861 "\n"
28862 msgstr ""
28863
28864 #. type: =item
28865 #: ../fuse/guestmount.pod:87
28866 msgid "B<-a image> | B<--add image>"
28867 msgstr ""
28868
28869 #. type: textblock
28870 #: ../fuse/guestmount.pod:89
28871 msgid "Add a block device or virtual machine image."
28872 msgstr ""
28873
28874 #. type: =item
28875 #: ../fuse/guestmount.pod:94
28876 msgid "B<-c URI> | B<--connect URI>"
28877 msgstr ""
28878
28879 #. type: =item
28880 #: ../fuse/guestmount.pod:100
28881 msgid "B<-d libvirt-domain> | B<--domain libvirt-domain>"
28882 msgstr ""
28883
28884 #. type: =item
28885 #: ../fuse/guestmount.pod:106
28886 msgid "B<--dir-cache-timeout N>"
28887 msgstr ""
28888
28889 #. type: textblock
28890 #: ../fuse/guestmount.pod:108
28891 msgid ""
28892 "Set the readdir cache timeout to I<N> seconds, the default being 60 "
28893 "seconds.  The readdir cache [actually, there are several semi-independent "
28894 "caches] is populated after a readdir(2) call with the stat and extended "
28895 "attributes of the files in the directory, in anticipation that they will be "
28896 "requested soon after."
28897 msgstr ""
28898
28899 #. type: textblock
28900 #: ../fuse/guestmount.pod:114
28901 msgid ""
28902 "There is also a different attribute cache implemented by FUSE (see the FUSE "
28903 "option I<-o attr_timeout>), but the FUSE cache does not anticipate future "
28904 "requests, only cache existing ones."
28905 msgstr ""
28906
28907 #. type: =item
28908 #: ../fuse/guestmount.pod:125
28909 msgid "B<--format=raw|qcow2|..> | B<--format>"
28910 msgstr ""
28911
28912 #. type: textblock
28913 #: ../fuse/guestmount.pod:132
28914 msgid ""
28915 "If you have untrusted raw-format guest disk images, you should use this "
28916 "option to specify the disk format.  This avoids a possible security problem "
28917 "with malicious guests (CVE-2010-3851).  See also L<guestfs(3)/"
28918 "guestfs_add_drive_opts>."
28919 msgstr ""
28920
28921 #. type: =item
28922 #: ../fuse/guestmount.pod:137
28923 msgid "B<--fuse-help>"
28924 msgstr ""
28925
28926 #. type: textblock
28927 #: ../fuse/guestmount.pod:139
28928 msgid "Display help on special FUSE options (see I<-o> below)."
28929 msgstr ""
28930
28931 #. type: textblock
28932 #: ../fuse/guestmount.pod:143
28933 msgid "Display brief help and exit."
28934 msgstr ""
28935
28936 #. type: =item
28937 #: ../fuse/guestmount.pod:145
28938 msgid "B<-i> | B<--inspector>"
28939 msgstr ""
28940
28941 #. type: textblock
28942 #: ../fuse/guestmount.pod:165
28943 msgid ""
28944 "Mount the named partition or logical volume on the given mountpoint B<in the "
28945 "guest> (this has nothing to do with mountpoints in the host)."
28946 msgstr ""
28947
28948 #. type: textblock
28949 #: ../fuse/guestmount.pod:168
28950 msgid ""
28951 "If the mountpoint is omitted, it defaults to C</>.  You have to mount "
28952 "something on C</>."
28953 msgstr ""
28954
28955 #. type: =item
28956 #: ../fuse/guestmount.pod:181
28957 msgid "B<-n> | B<--no-sync>"
28958 msgstr ""
28959
28960 #. type: textblock
28961 #: ../fuse/guestmount.pod:183
28962 msgid ""
28963 "By default, we attempt to sync the guest disk when the FUSE mountpoint is "
28964 "unmounted.  If you specify this option, then we don't attempt to sync the "
28965 "disk.  See the discussion of autosync in the L<guestfs(3)> manpage."
28966 msgstr ""
28967
28968 #. type: =item
28969 #: ../fuse/guestmount.pod:188
28970 msgid "B<-o option> | B<--option option>"
28971 msgstr ""
28972
28973 #. type: textblock
28974 #: ../fuse/guestmount.pod:190
28975 msgid "Pass extra options to FUSE."
28976 msgstr ""
28977
28978 #. type: textblock
28979 #: ../fuse/guestmount.pod:192
28980 msgid ""
28981 "To get a list of all the extra options supported by FUSE, use the command "
28982 "below.  Note that only the FUSE I<-o> options can be passed, and only some "
28983 "of them are a good idea."
28984 msgstr ""
28985
28986 #. type: verbatim
28987 #: ../fuse/guestmount.pod:196
28988 #, no-wrap
28989 msgid ""
28990 " guestmount --fuse-help\n"
28991 "\n"
28992 msgstr ""
28993
28994 #. type: textblock
28995 #: ../fuse/guestmount.pod:198
28996 msgid "Some potentially useful FUSE options:"
28997 msgstr ""
28998
28999 #. type: =item
29000 #: ../fuse/guestmount.pod:202
29001 msgid "B<-o allow_other>"
29002 msgstr ""
29003
29004 #. type: textblock
29005 #: ../fuse/guestmount.pod:204
29006 msgid "Allow other users to see the filesystem."
29007 msgstr ""
29008
29009 #. type: =item
29010 #: ../fuse/guestmount.pod:206
29011 msgid "B<-o attr_timeout=N>"
29012 msgstr ""
29013
29014 #. type: textblock
29015 #: ../fuse/guestmount.pod:208
29016 msgid "Enable attribute caching by FUSE, and set the timeout to I<N> seconds."
29017 msgstr ""
29018
29019 #. type: =item
29020 #: ../fuse/guestmount.pod:210
29021 msgid "B<-o kernel_cache>"
29022 msgstr ""
29023
29024 #. type: textblock
29025 #: ../fuse/guestmount.pod:212
29026 msgid ""
29027 "Allow the kernel to cache files (reduces the number of reads that have to go "
29028 "through the L<guestfs(3)> API).  This is generally a good idea if you can "
29029 "afford the extra memory usage."
29030 msgstr ""
29031
29032 #. type: =item
29033 #: ../fuse/guestmount.pod:216
29034 msgid "B<-o uid=N> B<-o gid=N>"
29035 msgstr ""
29036
29037 #. type: textblock
29038 #: ../fuse/guestmount.pod:218
29039 msgid ""
29040 "Use these options to map all UIDs and GIDs inside the guest filesystem to "
29041 "the chosen values."
29042 msgstr ""
29043
29044 #. type: =item
29045 #: ../fuse/guestmount.pod:223
29046 msgid "B<-r> | B<--ro>"
29047 msgstr ""
29048
29049 #. type: textblock
29050 #: ../fuse/guestmount.pod:225
29051 msgid ""
29052 "Add devices and mount everything read-only.  Also disallow writes and make "
29053 "the disk appear read-only to FUSE."
29054 msgstr ""
29055
29056 #. type: textblock
29057 #: ../fuse/guestmount.pod:228
29058 msgid ""
29059 "This is highly recommended if you are not going to edit the guest disk.  If "
29060 "the guest is running and this option is I<not> supplied, then there is a "
29061 "strong risk of disk corruption in the guest.  We try to prevent this from "
29062 "happening, but it is not always possible."
29063 msgstr ""
29064
29065 #. type: textblock
29066 #: ../fuse/guestmount.pod:233
29067 msgid "See also L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
29068 msgstr ""
29069
29070 #. type: textblock
29071 #: ../fuse/guestmount.pod:237
29072 msgid "Enable SELinux support for the guest."
29073 msgstr ""
29074
29075 #. type: =item
29076 #: ../fuse/guestmount.pod:239
29077 msgid "B<-v> | B<--verbose>"
29078 msgstr ""
29079
29080 #. type: textblock
29081 #: ../fuse/guestmount.pod:241
29082 msgid "Enable verbose messages from underlying libguestfs."
29083 msgstr ""
29084
29085 #. type: =item
29086 #: ../fuse/guestmount.pod:243
29087 msgid "B<-V> | B<--version>"
29088 msgstr ""
29089
29090 #. type: textblock
29091 #: ../fuse/guestmount.pod:245
29092 msgid "Display the program version and exit."
29093 msgstr ""
29094
29095 #. type: =item
29096 #: ../fuse/guestmount.pod:247
29097 msgid "B<-w> | B<--rw>"
29098 msgstr ""
29099
29100 #. type: textblock
29101 #: ../fuse/guestmount.pod:252 ../fuse/guestmount.pod:273
29102 msgid "See L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
29103 msgstr ""
29104
29105 #. type: =item
29106 #: ../fuse/guestmount.pod:254
29107 msgid "B<-x> | B<--trace>"
29108 msgstr ""
29109
29110 #. type: textblock
29111 #: ../fuse/guestmount.pod:256
29112 msgid "Trace libguestfs calls and entry into each FUSE function."
29113 msgstr ""
29114
29115 #. type: textblock
29116 #: ../fuse/guestmount.pod:258
29117 msgid "This also stops the daemon from forking into the background."
29118 msgstr ""
29119
29120 #. type: textblock
29121 #: ../fuse/guestmount.pod:279
29122 msgid ""
29123 "L<guestfish(1)>, L<virt-inspector(1)>, L<virt-cat(1)>, L<virt-edit(1)>, "
29124 "L<virt-tar(1)>, L<guestfs(3)>, L<http://libguestfs.org/>, L<http://fuse.sf."
29125 "net/>."
29126 msgstr ""
29127
29128 #. type: textblock
29129 #: ../fuse/guestmount.pod:294
29130 msgid "Copyright (C) 2009-2010 Red Hat Inc.  L<http://libguestfs.org/>"
29131 msgstr ""
29132
29133 #. type: textblock
29134 #: ../tools/virt-edit.pl:34
29135 msgid "virt-edit - Edit a file in a virtual machine"
29136 msgstr ""
29137
29138 #. type: verbatim
29139 #: ../tools/virt-edit.pl:38
29140 #, no-wrap
29141 msgid ""
29142 " virt-edit [--options] domname file\n"
29143 "\n"
29144 msgstr ""
29145
29146 #. type: verbatim
29147 #: ../tools/virt-edit.pl:40
29148 #, no-wrap
29149 msgid ""
29150 " virt-edit [--options] disk.img [disk.img ...] file\n"
29151 "\n"
29152 msgstr ""
29153
29154 #. type: verbatim
29155 #: ../tools/virt-edit.pl:42
29156 #, no-wrap
29157 msgid ""
29158 " virt-edit [domname|disk.img] file -e 'expr'\n"
29159 "\n"
29160 msgstr ""
29161
29162 #. type: textblock
29163 #: ../tools/virt-edit.pl:46
29164 msgid ""
29165 "You must I<not> use C<virt-edit> on live virtual machines.  If you do this, "
29166 "you risk disk corruption in the VM.  C<virt-edit> tries to stop you from "
29167 "doing this, but doesn't catch all cases."
29168 msgstr ""
29169
29170 #. type: textblock
29171 #: ../tools/virt-edit.pl:52
29172 msgid ""
29173 "C<virt-edit> is a command line tool to edit C<file> where C<file> exists in "
29174 "the named virtual machine (or disk image)."
29175 msgstr ""
29176
29177 #. type: textblock
29178 #: ../tools/virt-edit.pl:55
29179 msgid "If you want to just view a file, use L<virt-cat(1)>."
29180 msgstr ""
29181
29182 #. type: textblock
29183 #: ../tools/virt-edit.pl:57
29184 msgid ""
29185 "For more complex cases you should look at the L<guestfish(1)> tool (see L</"
29186 "USING GUESTFISH> below)."
29187 msgstr ""
29188
29189 #. type: textblock
29190 #: ../tools/virt-edit.pl:60
29191 msgid ""
29192 "C<virt-edit> cannot be used to create a new file, nor to edit multiple "
29193 "files.  L<guestfish(1)> can do that and much more."
29194 msgstr ""
29195
29196 #. type: textblock
29197 #: ../tools/virt-edit.pl:65
29198 msgid "Edit the named files interactively:"
29199 msgstr ""
29200
29201 #. type: verbatim
29202 #: ../tools/virt-edit.pl:67
29203 #, no-wrap
29204 msgid ""
29205 " virt-edit mydomain /boot/grub/grub.conf\n"
29206 "\n"
29207 msgstr ""
29208
29209 #. type: verbatim
29210 #: ../tools/virt-edit.pl:69
29211 #, no-wrap
29212 msgid ""
29213 " virt-edit mydomain /etc/passwd\n"
29214 "\n"
29215 msgstr ""
29216
29217 #. type: textblock
29218 #: ../tools/virt-edit.pl:71
29219 msgid "For Windows guests, some Windows paths are understood:"
29220 msgstr ""
29221
29222 #. type: verbatim
29223 #: ../tools/virt-edit.pl:73
29224 #, no-wrap
29225 msgid ""
29226 " virt-edit mywindomain 'c:\\autoexec.bat'\n"
29227 "\n"
29228 msgstr ""
29229
29230 #. type: textblock
29231 #: ../tools/virt-edit.pl:75
29232 msgid ""
29233 "You can also edit files non-interactively (see L</NON-INTERACTIVE EDITING> "
29234 "below).  To change the init default level to 5:"
29235 msgstr ""
29236
29237 #. type: verbatim
29238 #: ../tools/virt-edit.pl:79
29239 #, no-wrap
29240 msgid ""
29241 " virt-edit mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
29242 "\n"
29243 msgstr ""
29244
29245 #. type: textblock
29246 #: ../tools/virt-edit.pl:91 ../tools/virt-win-reg.pl:106
29247 #: ../tools/virt-list-filesystems.pl:63 ../tools/virt-tar.pl:113
29248 #: ../tools/virt-make-fs.pl:163 ../tools/virt-list-partitions.pl:64
29249 msgid "Display brief help."
29250 msgstr ""
29251
29252 #. type: textblock
29253 #: ../tools/virt-edit.pl:99 ../tools/virt-win-reg.pl:114
29254 #: ../tools/virt-list-filesystems.pl:71 ../tools/virt-tar.pl:121
29255 #: ../tools/virt-make-fs.pl:171 ../tools/virt-list-partitions.pl:72
29256 msgid "Display version number and exit."
29257 msgstr ""
29258
29259 #. type: =item
29260 #: ../tools/virt-edit.pl:105
29261 msgid "B<--backup extension> | B<-b extension>"
29262 msgstr ""
29263
29264 #. type: textblock
29265 #: ../tools/virt-edit.pl:107
29266 msgid ""
29267 "Create a backup of the original file I<in the guest disk image>.  The backup "
29268 "has the original filename with C<extension> added."
29269 msgstr ""
29270
29271 #. type: textblock
29272 #: ../tools/virt-edit.pl:110
29273 msgid ""
29274 "Usually the first character of C<extension> would be a dot C<.> so you would "
29275 "write:"
29276 msgstr ""
29277
29278 #. type: verbatim
29279 #: ../tools/virt-edit.pl:113
29280 #, no-wrap
29281 msgid ""
29282 " virt-edit -b .orig [etc]\n"
29283 "\n"
29284 msgstr ""
29285
29286 #. type: textblock
29287 #: ../tools/virt-edit.pl:115
29288 msgid "By default, no backup file is made."
29289 msgstr ""
29290
29291 #. type: =item
29292 #: ../tools/virt-edit.pl:121 ../tools/virt-win-reg.pl:128
29293 #: ../tools/virt-list-filesystems.pl:77 ../tools/virt-tar.pl:127
29294 #: ../tools/virt-list-partitions.pl:78
29295 msgid "B<--connect URI> | B<-c URI>"
29296 msgstr ""
29297
29298 #. type: textblock
29299 #: ../tools/virt-edit.pl:123 ../tools/virt-win-reg.pl:130
29300 #: ../tools/virt-list-filesystems.pl:79 ../tools/virt-tar.pl:129
29301 #: ../tools/virt-list-partitions.pl:80
29302 msgid ""
29303 "If using libvirt, connect to the given I<URI>.  If omitted, then we connect "
29304 "to the default libvirt hypervisor."
29305 msgstr ""
29306
29307 #. type: textblock
29308 #: ../tools/virt-edit.pl:126 ../tools/virt-win-reg.pl:133
29309 #: ../tools/virt-list-filesystems.pl:82 ../tools/virt-tar.pl:132
29310 #: ../tools/virt-list-partitions.pl:83
29311 msgid ""
29312 "If you specify guest block devices directly, then libvirt is not used at all."
29313 msgstr ""
29314
29315 #. type: =item
29316 #: ../tools/virt-edit.pl:133 ../tools/virt-win-reg.pl:140
29317 #: ../tools/virt-list-filesystems.pl:89 ../tools/virt-tar.pl:139
29318 #: ../tools/virt-list-partitions.pl:90
29319 msgid "B<--format> raw"
29320 msgstr ""
29321
29322 #. type: textblock
29323 #: ../tools/virt-edit.pl:135 ../tools/virt-win-reg.pl:142
29324 #: ../tools/virt-list-filesystems.pl:91 ../tools/virt-tar.pl:141
29325 #: ../tools/virt-list-partitions.pl:92
29326 msgid ""
29327 "Specify the format of disk images given on the command line.  If this is "
29328 "omitted then the format is autodetected from the content of the disk image."
29329 msgstr ""
29330
29331 #. type: textblock
29332 #: ../tools/virt-edit.pl:139 ../tools/virt-win-reg.pl:146
29333 #: ../tools/virt-list-filesystems.pl:95 ../tools/virt-tar.pl:145
29334 #: ../tools/virt-list-partitions.pl:96
29335 msgid ""
29336 "If disk images are requested from libvirt, then this program asks libvirt "
29337 "for this information.  In this case, the value of the format parameter is "
29338 "ignored."
29339 msgstr ""
29340
29341 #. type: textblock
29342 #: ../tools/virt-edit.pl:143 ../tools/virt-win-reg.pl:150
29343 #: ../tools/virt-list-filesystems.pl:99 ../tools/virt-tar.pl:149
29344 #: ../tools/virt-list-partitions.pl:100
29345 msgid ""
29346 "If working with untrusted raw-format guest disk images, you should ensure "
29347 "the format is always specified."
29348 msgstr ""
29349
29350 #. type: =item
29351 #: ../tools/virt-edit.pl:150
29352 msgid "B<--expr EXPR> | B<-e EXPR>"
29353 msgstr ""
29354
29355 #. type: textblock
29356 #: ../tools/virt-edit.pl:152
29357 msgid ""
29358 "Instead of launching the external editor, non-interactively apply the Perl "
29359 "expression C<EXPR> to each line in the file.  See L</NON-INTERACTIVE "
29360 "EDITING> below."
29361 msgstr ""
29362
29363 #. type: textblock
29364 #: ../tools/virt-edit.pl:156
29365 msgid ""
29366 "Be careful to properly quote the expression to prevent it from being altered "
29367 "by the shell."
29368 msgstr ""
29369
29370 #. type: =head1
29371 #: ../tools/virt-edit.pl:280
29372 msgid "NON-INTERACTIVE EDITING"
29373 msgstr ""
29374
29375 #. type: textblock
29376 #: ../tools/virt-edit.pl:282
29377 msgid ""
29378 "C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
29379 "administrator can interactively edit the file."
29380 msgstr ""
29381
29382 #. type: textblock
29383 #: ../tools/virt-edit.pl:285
29384 msgid ""
29385 "There are two ways also to use C<virt-edit> from scripts in order to make "
29386 "automated edits to files.  (Note that although you I<can> use C<virt-edit> "
29387 "like this, it's less error-prone to write scripts directly using the "
29388 "libguestfs API and Augeas for configuration file editing.)"
29389 msgstr ""
29390
29391 #. type: textblock
29392 #: ../tools/virt-edit.pl:291
29393 msgid ""
29394 "The first method is to temporarily set C<$EDITOR> to any script or program "
29395 "you want to run.  The script is invoked as C<$EDITOR tmpfile> and it should "
29396 "update C<tmpfile> in place however it likes."
29397 msgstr ""
29398
29399 #. type: textblock
29400 #: ../tools/virt-edit.pl:295
29401 msgid ""
29402 "The second method is to use the I<-e> parameter of C<virt-edit> to run a "
29403 "short Perl snippet in the style of L<sed(1)>.  For example to replace all "
29404 "instances of C<foo> with C<bar> in a file:"
29405 msgstr ""
29406
29407 #. type: verbatim
29408 #: ../tools/virt-edit.pl:299
29409 #, no-wrap
29410 msgid ""
29411 " virt-edit domname filename -e 's/foo/bar/'\n"
29412 "\n"
29413 msgstr ""
29414
29415 #. type: textblock
29416 #: ../tools/virt-edit.pl:301
29417 msgid ""
29418 "The full power of Perl regular expressions can be used (see L<perlre(1)>).  "
29419 "For example to delete root's password you could do:"
29420 msgstr ""
29421
29422 #. type: verbatim
29423 #: ../tools/virt-edit.pl:304
29424 #, no-wrap
29425 msgid ""
29426 " virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
29427 "\n"
29428 msgstr ""
29429
29430 #. type: textblock
29431 #: ../tools/virt-edit.pl:306
29432 msgid ""
29433 "What really happens is that the snippet is evaluated as a Perl expression "
29434 "for each line of the file.  The line, including the final C<\\n>, is passed "
29435 "in C<$_> and the expression should update C<$_> or leave it unchanged."
29436 msgstr ""
29437
29438 #. type: textblock
29439 #: ../tools/virt-edit.pl:311
29440 msgid ""
29441 "To delete a line, set C<$_> to the empty string.  For example, to delete the "
29442 "C<apache> user account from the password file you can do:"
29443 msgstr ""
29444
29445 #. type: verbatim
29446 #: ../tools/virt-edit.pl:314
29447 #, no-wrap
29448 msgid ""
29449 " virt-edit mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
29450 "\n"
29451 msgstr ""
29452
29453 #. type: textblock
29454 #: ../tools/virt-edit.pl:316
29455 msgid ""
29456 "To insert a line, prepend or append it to C<$_>.  However appending lines to "
29457 "the end of the file is rather difficult this way since there is no concept "
29458 "of \"last line of the file\" - your expression just doesn't get called "
29459 "again.  You might want to use the first method (setting C<$EDITOR>) if you "
29460 "want to do this."
29461 msgstr ""
29462
29463 #. type: textblock
29464 #: ../tools/virt-edit.pl:322
29465 msgid ""
29466 "The variable C<$lineno> contains the current line number.  As is "
29467 "traditional, the first line in the file is number C<1>."
29468 msgstr ""
29469
29470 #. type: textblock
29471 #: ../tools/virt-edit.pl:325
29472 msgid ""
29473 "The return value from the expression is ignored, but the expression may call "
29474 "C<die> in order to abort the whole program, leaving the original file "
29475 "untouched."
29476 msgstr ""
29477
29478 #. type: textblock
29479 #: ../tools/virt-edit.pl:329
29480 msgid ""
29481 "Remember when matching the end of a line that C<$_> may contain the final C<"
29482 "\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a "
29483 "newline then neither of these.  Thus to match or substitute some text at the "
29484 "end of a line, use this regular expression:"
29485 msgstr ""
29486
29487 #. type: verbatim
29488 #: ../tools/virt-edit.pl:334
29489 #, no-wrap
29490 msgid ""
29491 " /some text(\\r?\\n)?$/\n"
29492 "\n"
29493 msgstr ""
29494
29495 #. type: textblock
29496 #: ../tools/virt-edit.pl:336
29497 msgid ""
29498 "Alternately, use the perl C<chomp> function, being careful not to chomp C<"
29499 "$_> itself (since that would remove all newlines from the file):"
29500 msgstr ""
29501
29502 #. type: verbatim
29503 #: ../tools/virt-edit.pl:340
29504 #, no-wrap
29505 msgid ""
29506 " my $m = $_; chomp $m; $m =~ /some text$/\n"
29507 "\n"
29508 msgstr ""
29509
29510 #. type: textblock
29511 #: ../tools/virt-edit.pl:344
29512 msgid ""
29513 "C<virt-edit> has a limited ability to understand Windows drive letters and "
29514 "paths (eg. C<E:\\foo\\bar.txt>)."
29515 msgstr ""
29516
29517 #. type: textblock
29518 #: ../tools/virt-edit.pl:347
29519 msgid "If and only if the guest is running Windows then:"
29520 msgstr ""
29521
29522 #. type: textblock
29523 #: ../tools/virt-edit.pl:353
29524 msgid ""
29525 "Drive letter prefixes like C<C:> are resolved against the Windows Registry "
29526 "to the correct filesystem."
29527 msgstr ""
29528
29529 #. type: textblock
29530 #: ../tools/virt-edit.pl:358
29531 msgid ""
29532 "Any backslash (C<\\>) characters in the path are replaced with forward "
29533 "slashes so that libguestfs can process it."
29534 msgstr ""
29535
29536 #. type: textblock
29537 #: ../tools/virt-edit.pl:363
29538 msgid ""
29539 "The path is resolved case insensitively to locate the file that should be "
29540 "edited."
29541 msgstr ""
29542
29543 #. type: textblock
29544 #: ../tools/virt-edit.pl:368
29545 msgid "There are some known shortcomings:"
29546 msgstr ""
29547
29548 #. type: textblock
29549 #: ../tools/virt-edit.pl:374
29550 msgid "Some NTFS symbolic links may not be followed correctly."
29551 msgstr ""
29552
29553 #. type: textblock
29554 #: ../tools/virt-edit.pl:378
29555 msgid "NTFS junction points that cross filesystems are not followed."
29556 msgstr ""
29557
29558 #. type: =head1
29559 #: ../tools/virt-edit.pl:435
29560 msgid "USING GUESTFISH"
29561 msgstr ""
29562
29563 #. type: textblock
29564 #: ../tools/virt-edit.pl:437
29565 msgid ""
29566 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
29567 "C<virt-edit> doesn't work."
29568 msgstr ""
29569
29570 #. type: textblock
29571 #: ../tools/virt-edit.pl:440
29572 msgid "Using C<virt-edit> is approximately equivalent to doing:"
29573 msgstr ""
29574
29575 #. type: verbatim
29576 #: ../tools/virt-edit.pl:442
29577 #, no-wrap
29578 msgid ""
29579 " guestfish --rw -i -d domname edit /file\n"
29580 "\n"
29581 msgstr ""
29582
29583 #. type: textblock
29584 #: ../tools/virt-edit.pl:444
29585 msgid ""
29586 "where C<domname> is the name of the libvirt guest, and C</file> is the full "
29587 "path to the file."
29588 msgstr ""
29589
29590 #. type: textblock
29591 #: ../tools/virt-edit.pl:447
29592 msgid ""
29593 "The command above uses libguestfs's guest inspection feature and so does not "
29594 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
29595 "disk images that don't contain guests.  To edit a file on a disk image "
29596 "directly, use:"
29597 msgstr ""
29598
29599 #. type: verbatim
29600 #: ../tools/virt-edit.pl:452
29601 #, no-wrap
29602 msgid ""
29603 " guestfish --rw -a disk.img -m /dev/sda1 edit /file\n"
29604 "\n"
29605 msgstr ""
29606
29607 #. type: textblock
29608 #: ../tools/virt-edit.pl:454
29609 msgid ""
29610 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
29611 "the disk image to edit, and C</file> is the full path to the file."
29612 msgstr ""
29613
29614 #. type: textblock
29615 #: ../tools/virt-edit.pl:458
29616 msgid ""
29617 "C<virt-edit> cannot create new files.  Use the guestfish commands C<touch>, "
29618 "C<write> or C<upload> instead:"
29619 msgstr ""
29620
29621 #. type: verbatim
29622 #: ../tools/virt-edit.pl:461
29623 #, no-wrap
29624 msgid ""
29625 " guestfish --rw -i -d domname touch /newfile\n"
29626 "\n"
29627 msgstr ""
29628
29629 #. type: verbatim
29630 #: ../tools/virt-edit.pl:463
29631 #, no-wrap
29632 msgid ""
29633 " guestfish --rw -i -d domname write /newfile \"new content\"\n"
29634 "\n"
29635 msgstr ""
29636
29637 #. type: verbatim
29638 #: ../tools/virt-edit.pl:465
29639 #, no-wrap
29640 msgid ""
29641 " guestfish --rw -i -d domname upload localfile /newfile\n"
29642 "\n"
29643 msgstr ""
29644
29645 #. type: textblock
29646 #: ../tools/virt-edit.pl:467
29647 msgid ""
29648 "C<virt-edit> cannot edit multiple files, but guestfish can do it like this:"
29649 msgstr ""
29650
29651 #. type: verbatim
29652 #: ../tools/virt-edit.pl:470
29653 #, no-wrap
29654 msgid ""
29655 " guestfish --rw -i -d domname edit /file1 : edit /file2\n"
29656 "\n"
29657 msgstr ""
29658
29659 #. type: =item
29660 #: ../tools/virt-edit.pl:480
29661 msgid "C<EDITOR>"
29662 msgstr ""
29663
29664 #. type: textblock
29665 #: ../tools/virt-edit.pl:482
29666 msgid ""
29667 "If set, this string is used as the editor.  It may contain arguments, eg. C<"
29668 "\"emacs -nw\">"
29669 msgstr ""
29670
29671 #. type: textblock
29672 #: ../tools/virt-edit.pl:485
29673 msgid "If not set, C<vi> is used."
29674 msgstr ""
29675
29676 #. type: =head1
29677 #: ../tools/virt-edit.pl:489 ../tools/virt-win-reg.pl:559
29678 #: ../tools/virt-list-filesystems.pl:182 ../tools/virt-tar.pl:279
29679 #: ../tools/virt-make-fs.pl:532 ../tools/virt-list-partitions.pl:250
29680 msgid "SHELL QUOTING"
29681 msgstr ""
29682
29683 #. type: textblock
29684 #: ../tools/virt-edit.pl:491 ../tools/virt-win-reg.pl:567
29685 #: ../tools/virt-list-filesystems.pl:184 ../tools/virt-tar.pl:281
29686 #: ../tools/virt-make-fs.pl:534 ../tools/virt-list-partitions.pl:252
29687 msgid ""
29688 "Libvirt guest names can contain arbitrary characters, some of which have "
29689 "meaning to the shell such as C<#> and space.  You may need to quote or "
29690 "escape these characters on the command line.  See the shell manual page L<sh"
29691 "(1)> for details."
29692 msgstr ""
29693
29694 #. type: textblock
29695 #: ../tools/virt-edit.pl:498
29696 msgid ""
29697 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-"
29698 "tar-in(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
29699 "L<http://libguestfs.org/>, L<perl(1)>, L<perlre(1)>."
29700 msgstr ""
29701
29702 #. type: =head1
29703 #: ../tools/virt-edit.pl:510 ../tools/virt-win-reg.pl:598
29704 #: ../tools/virt-list-filesystems.pl:202 ../tools/virt-tar.pl:301
29705 #: ../tools/virt-make-fs.pl:564 ../tools/virt-list-partitions.pl:269
29706 msgid "AUTHOR"
29707 msgstr ""
29708
29709 #. type: textblock
29710 #: ../tools/virt-edit.pl:512 ../tools/virt-win-reg.pl:600
29711 #: ../tools/virt-list-filesystems.pl:204 ../tools/virt-tar.pl:303
29712 #: ../tools/virt-make-fs.pl:566 ../tools/virt-list-partitions.pl:271
29713 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
29714 msgstr ""
29715
29716 #. type: textblock
29717 #: ../tools/virt-edit.pl:516
29718 msgid "Copyright (C) 2009-2011 Red Hat Inc."
29719 msgstr ""
29720
29721 #. type: textblock
29722 #: ../tools/virt-win-reg.pl:37
29723 msgid ""
29724 "virt-win-reg - Export and merge Windows Registry entries from a Windows guest"
29725 msgstr ""
29726
29727 #. type: verbatim
29728 #: ../tools/virt-win-reg.pl:41
29729 #, no-wrap
29730 msgid ""
29731 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n"
29732 "\n"
29733 msgstr ""
29734
29735 #. type: verbatim
29736 #: ../tools/virt-win-reg.pl:43
29737 #, no-wrap
29738 msgid ""
29739 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n"
29740 "\n"
29741 msgstr ""
29742
29743 #. type: verbatim
29744 #: ../tools/virt-win-reg.pl:45
29745 #, no-wrap
29746 msgid ""
29747 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n"
29748 "\n"
29749 msgstr ""
29750
29751 #. type: verbatim
29752 #: ../tools/virt-win-reg.pl:47
29753 #, no-wrap
29754 msgid ""
29755 " virt-win-reg --merge domname [input.reg ...]\n"
29756 "\n"
29757 msgstr ""
29758
29759 #. type: verbatim
29760 #: ../tools/virt-win-reg.pl:49
29761 #, no-wrap
29762 msgid ""
29763 " virt-win-reg [--options] disk.img ... # instead of domname\n"
29764 "\n"
29765 msgstr ""
29766
29767 #. type: textblock
29768 #: ../tools/virt-win-reg.pl:53
29769 msgid ""
29770 "You must I<not> use C<virt-win-reg> with the I<--merge> option on live "
29771 "virtual machines.  If you do this, you I<will> get irreversible disk "
29772 "corruption in the VM.  C<virt-win-reg> tries to stop you from doing this, "
29773 "but doesn't catch all cases."
29774 msgstr ""
29775
29776 #. type: textblock
29777 #: ../tools/virt-win-reg.pl:58
29778 msgid ""
29779 "Modifying the Windows Registry is an inherently risky operation.  The format "
29780 "is deliberately obscure and undocumented, and Registry changes can leave the "
29781 "system unbootable.  Therefore when using the I<--merge> option, make sure "
29782 "you have a reliable backup first."
29783 msgstr ""
29784
29785 #. type: textblock
29786 #: ../tools/virt-win-reg.pl:65
29787 msgid ""
29788 "This program can export and merge Windows Registry entries from a Windows "
29789 "guest."
29790 msgstr ""
29791
29792 #. type: textblock
29793 #: ../tools/virt-win-reg.pl:68
29794 msgid ""
29795 "The first parameter is the libvirt guest name or the raw disk image of a "
29796 "Windows guest."
29797 msgstr ""
29798
29799 #. type: textblock
29800 #: ../tools/virt-win-reg.pl:71
29801 msgid ""
29802 "If I<--merge> is I<not> specified, then the chosen registry key is displayed/"
29803 "exported (recursively).  For example:"
29804 msgstr ""
29805
29806 #. type: verbatim
29807 #: ../tools/virt-win-reg.pl:74
29808 #, no-wrap
29809 msgid ""
29810 " $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n"
29811 "\n"
29812 msgstr ""
29813
29814 #. type: textblock
29815 #: ../tools/virt-win-reg.pl:76
29816 msgid ""
29817 "You can also display single values from within registry keys, for example:"
29818 msgstr ""
29819
29820 #. type: verbatim
29821 #: ../tools/virt-win-reg.pl:79
29822 #, no-wrap
29823 msgid ""
29824 " $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n"
29825 " $ virt-win-reg Windows7 $cvkey ProductName\n"
29826 " Windows 7 Enterprise\n"
29827 "\n"
29828 msgstr ""
29829
29830 #. type: textblock
29831 #: ../tools/virt-win-reg.pl:83
29832 msgid ""
29833 "With I<--merge>, you can merge a textual regedit file into the Windows "
29834 "Registry:"
29835 msgstr ""
29836
29837 #. type: verbatim
29838 #: ../tools/virt-win-reg.pl:86
29839 #, no-wrap
29840 msgid ""
29841 " $ virt-win-reg --merge Windows7 changes.reg\n"
29842 "\n"
29843 msgstr ""
29844
29845 #. type: =head1
29846 #: ../tools/virt-win-reg.pl:88 ../tools/virt-tar.pl:45
29847 msgid "NOTE"
29848 msgstr ""
29849
29850 #. type: textblock
29851 #: ../tools/virt-win-reg.pl:90
29852 msgid ""
29853 "This program is only meant for simple access to the registry.  If you want "
29854 "to do complicated things with the registry, we suggest you download the "
29855 "Registry hive files from the guest using L<libguestfs(3)> or L<guestfish(1)> "
29856 "and access them locally, eg. using L<hivex(3)>, L<hivexsh(1)> or "
29857 "L<hivexregedit(1)>."
29858 msgstr ""
29859
29860 #. type: =item
29861 #: ../tools/virt-win-reg.pl:120 ../tools/virt-make-fs.pl:177
29862 msgid "B<--debug>"
29863 msgstr ""
29864
29865 #. type: textblock
29866 #: ../tools/virt-win-reg.pl:122
29867 msgid "Enable debugging messages."
29868 msgstr ""
29869
29870 #. type: =item
29871 #: ../tools/virt-win-reg.pl:157
29872 msgid "B<--merge>"
29873 msgstr ""
29874
29875 #. type: textblock
29876 #: ../tools/virt-win-reg.pl:159
29877 msgid ""
29878 "In merge mode, this merges a textual regedit file into the Windows Registry "
29879 "of the virtual machine.  If this flag is I<not> given then virt-win-reg "
29880 "displays or exports Registry entries instead."
29881 msgstr ""
29882
29883 #. type: textblock
29884 #: ../tools/virt-win-reg.pl:163
29885 msgid ""
29886 "Note that I<--merge> is I<unsafe> to use on live virtual machines, and will "
29887 "result in disk corruption.  However exporting (without this flag)  is always "
29888 "safe."
29889 msgstr ""
29890
29891 #. type: =item
29892 #: ../tools/virt-win-reg.pl:171
29893 msgid "B<--encoding> UTF-16LE|ASCII"
29894 msgstr ""
29895
29896 #. type: textblock
29897 #: ../tools/virt-win-reg.pl:173
29898 msgid ""
29899 "When merging (only), you may need to specify the encoding for strings to be "
29900 "used in the hive file.  This is explained in detail in L<Win::Hivex::Regedit"
29901 "(3)/ENCODING STRINGS>."
29902 msgstr ""
29903
29904 #. type: textblock
29905 #: ../tools/virt-win-reg.pl:177
29906 msgid ""
29907 "The default is to use UTF-16LE, which should work with recent versions of "
29908 "Windows."
29909 msgstr ""
29910
29911 #. type: =head1
29912 #: ../tools/virt-win-reg.pl:402
29913 msgid "SUPPORTED SYSTEMS"
29914 msgstr ""
29915
29916 #. type: textblock
29917 #: ../tools/virt-win-reg.pl:404
29918 msgid ""
29919 "The program currently supports Windows NT-derived guests starting with "
29920 "Windows XP through to at least Windows 7."
29921 msgstr ""
29922
29923 #. type: textblock
29924 #: ../tools/virt-win-reg.pl:407
29925 msgid ""
29926 "Registry support is done for C<HKEY_LOCAL_MACHINE\\SAM>, C<HKEY_LOCAL_MACHINE"
29927 "\\SECURITY>, C<HKEY_LOCAL_MACHINE\\SOFTWARE>, C<HKEY_LOCAL_MACHINE\\SYSTEM> "
29928 "and C<HKEY_USERS\\.DEFAULT>."
29929 msgstr ""
29930
29931 #. type: textblock
29932 #: ../tools/virt-win-reg.pl:411
29933 msgid ""
29934 "You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for "
29935 "C<HKEY_USERS>."
29936 msgstr ""
29937
29938 #. type: textblock
29939 #: ../tools/virt-win-reg.pl:414
29940 msgid ""
29941 "C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are B<not> supported at this "
29942 "time."
29943 msgstr ""
29944
29945 #. type: =head1
29946 #: ../tools/virt-win-reg.pl:417
29947 msgid "ENCODING"
29948 msgstr ""
29949
29950 #. type: textblock
29951 #: ../tools/virt-win-reg.pl:419
29952 msgid ""
29953 "C<virt-win-reg> expects that regedit files have already been reencoded in "
29954 "the local encoding.  Usually on Linux hosts, this means UTF-8 with Unix-"
29955 "style line endings.  Since Windows regedit files are often in UTF-16LE with "
29956 "Windows-style line endings, you may need to reencode the whole file before "
29957 "or after processing."
29958 msgstr ""
29959
29960 #. type: textblock
29961 #: ../tools/virt-win-reg.pl:425
29962 msgid ""
29963 "To reencode a file from Windows format to Linux (before processing it with "
29964 "the I<--merge> option), you would do something like this:"
29965 msgstr ""
29966
29967 #. type: verbatim
29968 #: ../tools/virt-win-reg.pl:428
29969 #, no-wrap
29970 msgid ""
29971 " iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n"
29972 "\n"
29973 msgstr ""
29974
29975 #. type: textblock
29976 #: ../tools/virt-win-reg.pl:430
29977 msgid ""
29978 "To go in the opposite direction, after exporting and before sending the file "
29979 "to a Windows user, do something like this:"
29980 msgstr ""
29981
29982 #. type: verbatim
29983 #: ../tools/virt-win-reg.pl:433
29984 #, no-wrap
29985 msgid ""
29986 " unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n"
29987 "\n"
29988 msgstr ""
29989
29990 #. type: textblock
29991 #: ../tools/virt-win-reg.pl:435
29992 msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>."
29993 msgstr ""
29994
29995 #. type: textblock
29996 #: ../tools/virt-win-reg.pl:437
29997 msgid ""
29998 "If you are unsure about the current encoding, use the L<file(1)> command.  "
29999 "Recent versions of Windows regedit.exe produce a UTF-16LE file with Windows-"
30000 "style (CRLF) line endings, like this:"
30001 msgstr ""
30002
30003 #. type: verbatim
30004 #: ../tools/virt-win-reg.pl:441
30005 #, no-wrap
30006 msgid ""
30007 " $ file software.reg\n"
30008 " software.reg: Little-endian UTF-16 Unicode text, with very long lines,\n"
30009 " with CRLF line terminators\n"
30010 "\n"
30011 msgstr ""
30012
30013 #. type: textblock
30014 #: ../tools/virt-win-reg.pl:445
30015 msgid "This file would need conversion before you could I<--merge> it."
30016 msgstr ""
30017
30018 #. type: =head1
30019 #: ../tools/virt-win-reg.pl:447
30020 msgid "CurrentControlSet etc."
30021 msgstr ""
30022
30023 #. type: textblock
30024 #: ../tools/virt-win-reg.pl:449
30025 msgid ""
30026 "Registry keys like C<CurrentControlSet> don't really exist in the Windows "
30027 "Registry at the level of the hive file, and therefore you cannot modify "
30028 "these."
30029 msgstr ""
30030
30031 #. type: textblock
30032 #: ../tools/virt-win-reg.pl:453
30033 msgid ""
30034 "C<CurrentControlSet> is usually an alias for C<ControlSet001>.  In some "
30035 "circumstances it might refer to another control set.  The way to find out is "
30036 "to look at the C<HKLM\\SYSTEM\\Select> key:"
30037 msgstr ""
30038
30039 #. type: verbatim
30040 #: ../tools/virt-win-reg.pl:457
30041 #, no-wrap
30042 msgid ""
30043 " # virt-win-reg WindowsGuest 'HKLM\\SYSTEM\\Select'\n"
30044 " [HKEY_LOCAL_MACHINE\\SYSTEM\\Select]\n"
30045 " \"Current\"=dword:00000001\n"
30046 " \"Default\"=dword:00000001\n"
30047 " \"Failed\"=dword:00000000\n"
30048 " \"LastKnownGood\"=dword:00000002\n"
30049 "\n"
30050 msgstr ""
30051
30052 #. type: textblock
30053 #: ../tools/virt-win-reg.pl:464
30054 msgid "\"Current\" is the one which Windows will choose when it boots."
30055 msgstr ""
30056
30057 #. type: textblock
30058 #: ../tools/virt-win-reg.pl:466
30059 msgid ""
30060 "Similarly, other C<Current...> keys in the path may need to be replaced."
30061 msgstr ""
30062
30063 #. type: =head1
30064 #: ../tools/virt-win-reg.pl:469
30065 msgid "WINDOWS TIPS"
30066 msgstr ""
30067
30068 #. type: textblock
30069 #: ../tools/virt-win-reg.pl:471
30070 msgid ""
30071 "Note that some of these tips modify the guest disk image.  The guest I<must> "
30072 "be shut off, else you will get disk corruption."
30073 msgstr ""
30074
30075 #. type: =head2
30076 #: ../tools/virt-win-reg.pl:474
30077 msgid "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN"
30078 msgstr ""
30079
30080 #. type: textblock
30081 #: ../tools/virt-win-reg.pl:476
30082 msgid ""
30083 "Prepare a DOS batch script, VBScript or executable.  Upload this using "
30084 "L<guestfish(1)>.  For this example the script is called C<test.bat> and it "
30085 "is uploaded into C<C:\\>:"
30086 msgstr ""
30087
30088 #. type: verbatim
30089 #: ../tools/virt-win-reg.pl:480
30090 #, no-wrap
30091 msgid ""
30092 " guestfish -i -d WindowsGuest upload test.bat /test.bat\n"
30093 "\n"
30094 msgstr ""
30095
30096 #. type: textblock
30097 #: ../tools/virt-win-reg.pl:482
30098 msgid "Prepare a regedit file containing the registry change:"
30099 msgstr ""
30100
30101 #. type: verbatim
30102 #: ../tools/virt-win-reg.pl:484
30103 #, no-wrap
30104 msgid ""
30105 " cat > test.reg <<'EOF'\n"
30106 " [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n"
30107 " \"Test\"=\"c:\\\\test.bat\"\n"
30108 " EOF\n"
30109 "\n"
30110 msgstr ""
30111
30112 #. type: textblock
30113 #: ../tools/virt-win-reg.pl:489
30114 msgid ""
30115 "In this example we use the key C<RunOnce> which means that the script will "
30116 "run precisely once when the first user logs in.  If you want it to run every "
30117 "time a user logs in, replace C<RunOnce> with C<Run>."
30118 msgstr ""
30119
30120 #. type: textblock
30121 #: ../tools/virt-win-reg.pl:493
30122 msgid "Now update the registry:"
30123 msgstr ""
30124
30125 #. type: verbatim
30126 #: ../tools/virt-win-reg.pl:495
30127 #, no-wrap
30128 msgid ""
30129 " virt-win-reg --merge WindowsGuest test.reg\n"
30130 "\n"
30131 msgstr ""
30132
30133 #. type: =head2
30134 #: ../tools/virt-win-reg.pl:497
30135 msgid "INSTALLING A SERVICE"
30136 msgstr ""
30137
30138 #. type: textblock
30139 #: ../tools/virt-win-reg.pl:499
30140 msgid ""
30141 "This section assumes you are familiar with Windows services, and you either "
30142 "have a program which handles the Windows Service Control Protocol directly "
30143 "or you want to run any program using a service wrapper like SrvAny or the "
30144 "free RHSrvAny."
30145 msgstr ""
30146
30147 #. type: textblock
30148 #: ../tools/virt-win-reg.pl:504
30149 msgid ""
30150 "First upload the program and optionally the service wrapper.  In this case "
30151 "the test program is called C<test.exe> and we are using the RHSrvAny wrapper:"
30152 msgstr ""
30153
30154 #. type: verbatim
30155 #: ../tools/virt-win-reg.pl:508
30156 #, no-wrap
30157 msgid ""
30158 " guestfish -i -d WindowsGuest <<EOF\n"
30159 "   upload rhsrvany.exe /rhsrvany.exe\n"
30160 "   upload test.exe /test.exe\n"
30161 " EOF\n"
30162 "\n"
30163 msgstr ""
30164
30165 #. type: textblock
30166 #: ../tools/virt-win-reg.pl:513
30167 msgid ""
30168 "Prepare a regedit file containing the registry changes.  In this example, "
30169 "the first registry change is needed for the service itself or the service "
30170 "wrapper (if used).  The second registry change is only needed because I am "
30171 "using the RHSrvAny service wrapper."
30172 msgstr ""
30173
30174 #. type: verbatim
30175 #: ../tools/virt-win-reg.pl:518
30176 #, no-wrap
30177 msgid ""
30178 " cat > service.reg <<'EOF'\n"
30179 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny]\n"
30180 " \"Type\"=dword:00000010\n"
30181 " \"Start\"=dword:00000002\n"
30182 " \"ErrorControl\"=dword:00000001\n"
30183 " \"ImagePath\"=\"c:\\\\rhsrvany.exe\"\n"
30184 " \"DisplayName\"=\"RHSrvAny\"\n"
30185 " \"ObjectName\"=\"NetworkService\"\n"
30186 " \n"
30187 msgstr ""
30188
30189 #. type: verbatim
30190 #: ../tools/virt-win-reg.pl:527
30191 #, no-wrap
30192 msgid ""
30193 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n"
30194 " \"CommandLine\"=\"c:\\\\test.exe\"\n"
30195 " \"PWD\"=\"c:\\\\Temp\"\n"
30196 " EOF\n"
30197 "\n"
30198 msgstr ""
30199
30200 #. type: textblock
30201 #: ../tools/virt-win-reg.pl:538
30202 msgid ""
30203 "For use of C<ControlSet001> see the section above in this manual page.  You "
30204 "may need to adjust this according to the control set that is in use by the "
30205 "guest."
30206 msgstr ""
30207
30208 #. type: textblock
30209 #: ../tools/virt-win-reg.pl:544
30210 msgid ""
30211 "C<\"ObjectName\"> controls the privileges that the service will have.  An "
30212 "alternative is C<\"ObjectName\"=\"LocalSystem\"> which would be the most "
30213 "privileged account."
30214 msgstr ""
30215
30216 #. type: textblock
30217 #: ../tools/virt-win-reg.pl:550
30218 msgid ""
30219 "For the meaning of the magic numbers, see this Microsoft KB article: "
30220 "L<http://support.microsoft.com/kb/103000>."
30221 msgstr ""
30222
30223 #. type: textblock
30224 #: ../tools/virt-win-reg.pl:555
30225 msgid "Update the registry:"
30226 msgstr ""
30227
30228 #. type: verbatim
30229 #: ../tools/virt-win-reg.pl:557
30230 #, no-wrap
30231 msgid ""
30232 " virt-win-reg --merge WindowsGuest service.reg\n"
30233 "\n"
30234 msgstr ""
30235
30236 #. type: textblock
30237 #: ../tools/virt-win-reg.pl:561
30238 msgid ""
30239 "Be careful when passing parameters containing C<\\> (backslash) in the "
30240 "shell.  Usually you will have to use 'single quotes' or double backslashes "
30241 "(but not both) to protect them from the shell."
30242 msgstr ""
30243
30244 #. type: textblock
30245 #: ../tools/virt-win-reg.pl:565
30246 msgid "Paths and value names are case-insensitive."
30247 msgstr ""
30248
30249 #. type: textblock
30250 #: ../tools/virt-win-reg.pl:574
30251 msgid ""
30252 "L<hivex(3)>, L<hivexsh(1)>, L<hivexregedit(1)>, L<guestfs(3)>, L<guestfish(1)"
30253 ">, L<virt-cat(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Win::Hivex"
30254 "(3)>, L<Win::Hivex::Regedit(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
30255 msgstr ""
30256
30257 #. type: textblock
30258 #: ../tools/virt-win-reg.pl:589 ../tools/virt-make-fs.pl:555
30259 msgid ""
30260 "When reporting bugs, please enable debugging and capture the I<complete> "
30261 "output:"
30262 msgstr ""
30263
30264 #. type: verbatim
30265 #: ../tools/virt-win-reg.pl:592
30266 #, no-wrap
30267 msgid ""
30268 " export LIBGUESTFS_DEBUG=1\n"
30269 " virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n"
30270 "\n"
30271 msgstr ""
30272
30273 #. type: textblock
30274 #: ../tools/virt-win-reg.pl:595
30275 msgid ""
30276 "Attach /tmp/virt-win-reg.log to a new bug report at L<https://bugzilla."
30277 "redhat.com/>"
30278 msgstr ""
30279
30280 #. type: textblock
30281 #: ../tools/virt-win-reg.pl:604 ../tools/virt-make-fs.pl:570
30282 msgid "Copyright (C) 2010 Red Hat Inc."
30283 msgstr ""
30284
30285 #. type: textblock
30286 #: ../tools/virt-list-filesystems.pl:32
30287 msgid ""
30288 "virt-list-filesystems - List filesystems in a virtual machine or disk image"
30289 msgstr ""
30290
30291 #. type: verbatim
30292 #: ../tools/virt-list-filesystems.pl:36
30293 #, no-wrap
30294 msgid ""
30295 " virt-list-filesystems [--options] domname\n"
30296 "\n"
30297 msgstr ""
30298
30299 #. type: verbatim
30300 #: ../tools/virt-list-filesystems.pl:38
30301 #, no-wrap
30302 msgid ""
30303 " virt-list-filesystems [--options] disk.img [disk.img ...]\n"
30304 "\n"
30305 msgstr ""
30306
30307 #. type: textblock
30308 #: ../tools/virt-list-filesystems.pl:42 ../tools/virt-list-partitions.pl:42
30309 msgid ""
30310 "This tool is obsolete.  Use L<virt-filesystems(1)> as a more flexible "
30311 "replacement."
30312 msgstr ""
30313
30314 #. type: textblock
30315 #: ../tools/virt-list-filesystems.pl:45
30316 msgid ""
30317 "C<virt-list-filesystems> is a command line tool to list the filesystems that "
30318 "are contained in a virtual machine or disk image."
30319 msgstr ""
30320
30321 #. type: textblock
30322 #: ../tools/virt-list-filesystems.pl:49
30323 msgid ""
30324 "C<virt-list-filesystems> is just a simple wrapper around L<libguestfs(3)> "
30325 "functionality.  For more complex cases you should look at the L<guestfish(1)"
30326 "> tool."
30327 msgstr ""
30328
30329 #. type: =item
30330 #: ../tools/virt-list-filesystems.pl:106 ../tools/virt-list-partitions.pl:115
30331 msgid "B<-l> | B<--long>"
30332 msgstr ""
30333
30334 #. type: textblock
30335 #: ../tools/virt-list-filesystems.pl:108
30336 msgid ""
30337 "With this option, C<virt-list-filesystems> displays the type of each "
30338 "filesystem too (where \"type\" means C<ext3>, C<xfs> etc.)"
30339 msgstr ""
30340
30341 #. type: =item
30342 #: ../tools/virt-list-filesystems.pl:115
30343 msgid "B<-a> | B<--all>"
30344 msgstr ""
30345
30346 #. type: textblock
30347 #: ../tools/virt-list-filesystems.pl:117
30348 msgid ""
30349 "Normally we only show mountable filesystems.  If this option is given then "
30350 "swap devices are shown too."
30351 msgstr ""
30352
30353 #. type: textblock
30354 #: ../tools/virt-list-filesystems.pl:191
30355 msgid ""
30356 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
30357 "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
30358 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
30359 msgstr ""
30360
30361 #. type: textblock
30362 #: ../tools/virt-list-filesystems.pl:208 ../tools/virt-tar.pl:307
30363 msgid "Copyright (C) 2009 Red Hat Inc."
30364 msgstr ""
30365
30366 #. type: textblock
30367 #: ../tools/virt-tar.pl:33
30368 msgid "virt-tar - Extract or upload files to a virtual machine"
30369 msgstr ""
30370
30371 #. type: verbatim
30372 #: ../tools/virt-tar.pl:37
30373 #, no-wrap
30374 msgid ""
30375 " virt-tar [--options] -x domname directory tarball\n"
30376 "\n"
30377 msgstr ""
30378
30379 #. type: verbatim
30380 #: ../tools/virt-tar.pl:39
30381 #, no-wrap
30382 msgid ""
30383 " virt-tar [--options] -u domname tarball directory\n"
30384 "\n"
30385 msgstr ""
30386
30387 #. type: verbatim
30388 #: ../tools/virt-tar.pl:41
30389 #, no-wrap
30390 msgid ""
30391 " virt-tar [--options] disk.img [disk.img ...] -x directory tarball\n"
30392 "\n"
30393 msgstr ""
30394
30395 #. type: verbatim
30396 #: ../tools/virt-tar.pl:43
30397 #, no-wrap
30398 msgid ""
30399 " virt-tar [--options] disk.img [disk.img ...] -u tarball directory\n"
30400 "\n"
30401 msgstr ""
30402
30403 #. type: textblock
30404 #: ../tools/virt-tar.pl:47
30405 msgid ""
30406 "This tool is obsolete.  Use L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-"
30407 "tar-in(1)>, L<virt-tar-out(1)> as replacements."
30408 msgstr ""
30409
30410 #. type: textblock
30411 #: ../tools/virt-tar.pl:52
30412 msgid "Download C</home> from the VM into a local tarball:"
30413 msgstr ""
30414
30415 #. type: verbatim
30416 #: ../tools/virt-tar.pl:54
30417 #, no-wrap
30418 msgid ""
30419 " virt-tar -x domname /home home.tar\n"
30420 "\n"
30421 msgstr ""
30422
30423 #. type: verbatim
30424 #: ../tools/virt-tar.pl:56
30425 #, no-wrap
30426 msgid ""
30427 " virt-tar -zx domname /home home.tar.gz\n"
30428 "\n"
30429 msgstr ""
30430
30431 #. type: textblock
30432 #: ../tools/virt-tar.pl:58
30433 msgid "Upload a local tarball and unpack it inside C</tmp> in the VM:"
30434 msgstr ""
30435
30436 #. type: verbatim
30437 #: ../tools/virt-tar.pl:60
30438 #, no-wrap
30439 msgid ""
30440 " virt-tar -u domname uploadstuff.tar /tmp\n"
30441 "\n"
30442 msgstr ""
30443
30444 #. type: verbatim
30445 #: ../tools/virt-tar.pl:62
30446 #, no-wrap
30447 msgid ""
30448 " virt-tar -zu domname uploadstuff.tar.gz /tmp\n"
30449 "\n"
30450 msgstr ""
30451
30452 #. type: textblock
30453 #: ../tools/virt-tar.pl:66
30454 msgid ""
30455 "You must I<not> use C<virt-tar> with the I<-u> option (upload) on live "
30456 "virtual machines.  If you do this, you risk disk corruption in the VM.  "
30457 "C<virt-tar> tries to stop you from doing this, but doesn't catch all cases."
30458 msgstr ""
30459
30460 #. type: textblock
30461 #: ../tools/virt-tar.pl:71
30462 msgid ""
30463 "You can use I<-x> (extract) on live virtual machines, but you might get "
30464 "inconsistent results or errors if there is filesystem activity inside the "
30465 "VM.  If the live VM is synched and quiescent, then C<virt-tar> will usually "
30466 "work, but the only way to guarantee consistent results is if the virtual "
30467 "machine is shut down."
30468 msgstr ""
30469
30470 #. type: textblock
30471 #: ../tools/virt-tar.pl:79
30472 msgid ""
30473 "C<virt-tar> is a general purpose archive tool for downloading and uploading "
30474 "parts of a guest filesystem.  There are many possibilities: making backups, "
30475 "uploading data files, snooping on guest activity, fixing or customizing "
30476 "guests, etc."
30477 msgstr ""
30478
30479 #. type: textblock
30480 #: ../tools/virt-tar.pl:84
30481 msgid ""
30482 "If you want to just view a single file, use L<virt-cat(1)>.  If you just "
30483 "want to edit a single file, use L<virt-edit(1)>.  For more complex cases you "
30484 "should look at the L<guestfish(1)> tool."
30485 msgstr ""
30486
30487 #. type: textblock
30488 #: ../tools/virt-tar.pl:88
30489 msgid ""
30490 "There are two modes of operation: I<-x> (eXtract) downloads a directory and "
30491 "its contents (recursively) from the virtual machine into a local tarball.  "
30492 "I<-u> uploads from a local tarball, unpacking it into a directory inside the "
30493 "virtual machine.  You cannot use these two options together."
30494 msgstr ""
30495
30496 #. type: textblock
30497 #: ../tools/virt-tar.pl:94
30498 msgid ""
30499 "In addition, you may need to use the I<-z> (gZip) option to enable "
30500 "compression.  When uploading, you have to specify I<-z> if the upload file "
30501 "is compressed because virt-tar won't detect this on its own."
30502 msgstr ""
30503
30504 #. type: textblock
30505 #: ../tools/virt-tar.pl:98
30506 msgid ""
30507 "C<virt-tar> can only handle tar (optionally gzipped) format tarballs.  For "
30508 "example it cannot do PKZip files or bzip2 compression.  If you want that "
30509 "then you'll have to rebuild the tarballs yourself.  (This is a limitation of "
30510 "the L<libguestfs(3)> API)."
30511 msgstr ""
30512
30513 #. type: =item
30514 #: ../tools/virt-tar.pl:156
30515 msgid "B<-x> | B<--extract> | B<--download>"
30516 msgstr ""
30517
30518 #. type: =item
30519 #: ../tools/virt-tar.pl:158
30520 msgid "B<-u> | B<--upload>"
30521 msgstr ""
30522
30523 #. type: textblock
30524 #: ../tools/virt-tar.pl:160
30525 msgid ""
30526 "Use I<-x> to extract (download) a directory from a virtual machine to a "
30527 "local tarball."
30528 msgstr ""
30529
30530 #. type: textblock
30531 #: ../tools/virt-tar.pl:163
30532 msgid ""
30533 "Use I<-u> to upload and unpack from a local tarball into a virtual machine.  "
30534 "Please read the L</WARNING> section above before using this option."
30535 msgstr ""
30536
30537 #. type: textblock
30538 #: ../tools/virt-tar.pl:167
30539 msgid "You must specify exactly one of these options."
30540 msgstr ""
30541
30542 #. type: =item
30543 #: ../tools/virt-tar.pl:173
30544 msgid "B<-z> | B<--gzip>"
30545 msgstr ""
30546
30547 #. type: textblock
30548 #: ../tools/virt-tar.pl:175
30549 msgid "Specify that the input or output tarball is gzip-compressed."
30550 msgstr ""
30551
30552 #. type: textblock
30553 #: ../tools/virt-tar.pl:288
30554 msgid ""
30555 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-copy-"
30556 "in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<Sys::"
30557 "Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs."
30558 "org/>."
30559 msgstr ""
30560
30561 #. type: textblock
30562 #: ../tools/virt-make-fs.pl:37
30563 msgid "virt-make-fs - Make a filesystem from a tar archive or files"
30564 msgstr ""
30565
30566 #. type: verbatim
30567 #: ../tools/virt-make-fs.pl:41
30568 #, no-wrap
30569 msgid ""
30570 " virt-make-fs [--options] input.tar output.img\n"
30571 "\n"
30572 msgstr ""
30573
30574 #. type: verbatim
30575 #: ../tools/virt-make-fs.pl:43
30576 #, no-wrap
30577 msgid ""
30578 " virt-make-fs [--options] input.tar.gz output.img\n"
30579 "\n"
30580 msgstr ""
30581
30582 #. type: verbatim
30583 #: ../tools/virt-make-fs.pl:45
30584 #, no-wrap
30585 msgid ""
30586 " virt-make-fs [--options] directory output.img\n"
30587 "\n"
30588 msgstr ""
30589
30590 #. type: textblock
30591 #: ../tools/virt-make-fs.pl:49
30592 msgid ""
30593 "Virt-make-fs is a command line tool for creating a filesystem from a tar "
30594 "archive or some files in a directory.  It is similar to tools like L<mkisofs"
30595 "(1)>, L<genisoimage(1)> and L<mksquashfs(1)>.  Unlike those tools, it can "
30596 "create common filesystem types like ext2/3 or NTFS, which can be useful if "
30597 "you want to attach these filesystems to existing virtual machines (eg. to "
30598 "import large amounts of read-only data to a VM)."
30599 msgstr ""
30600
30601 #. type: textblock
30602 #: ../tools/virt-make-fs.pl:57
30603 msgid "Basic usage is:"
30604 msgstr ""
30605
30606 #. type: verbatim
30607 #: ../tools/virt-make-fs.pl:59
30608 #, no-wrap
30609 msgid ""
30610 " virt-make-fs input output\n"
30611 "\n"
30612 msgstr ""
30613
30614 #. type: textblock
30615 #: ../tools/virt-make-fs.pl:61
30616 msgid ""
30617 "where C<input> is either a directory containing files that you want to add, "
30618 "or a tar archive (either uncompressed tar or gzip-compressed tar); and "
30619 "C<output> is a disk image.  The input type is detected automatically.  The "
30620 "output disk image defaults to a raw ext2 image unless you specify extra "
30621 "flags (see L</OPTIONS> below)."
30622 msgstr ""
30623
30624 #. type: =head2
30625 #: ../tools/virt-make-fs.pl:67
30626 msgid "EXTRA SPACE"
30627 msgstr ""
30628
30629 #. type: textblock
30630 #: ../tools/virt-make-fs.pl:69
30631 msgid ""
30632 "Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" "
30633 "the files that it contains, but might have extra space.  Depending on how "
30634 "you are going to use the output, you might think this extra space is wasted "
30635 "and want to minimize it, or you might want to leave space so that more files "
30636 "can be added later.  Virt-make-fs defaults to minimizing the extra space, "
30637 "but you can use the I<--size> flag to leave space in the filesystem if you "
30638 "want it."
30639 msgstr ""
30640
30641 #. type: textblock
30642 #: ../tools/virt-make-fs.pl:77
30643 msgid ""
30644 "An alternative way to leave extra space but not make the output image any "
30645 "bigger is to use an alternative disk image format (instead of the default "
30646 "\"raw\" format).  Using I<--format=qcow2> will use the native QEmu/KVM qcow2 "
30647 "image format (check your hypervisor supports this before using it).  This "
30648 "allows you to choose a large I<--size> but the extra space won't actually be "
30649 "allocated in the image until you try to store something in it."
30650 msgstr ""
30651
30652 #. type: textblock
30653 #: ../tools/virt-make-fs.pl:85
30654 msgid ""
30655 "Don't forget that you can also use local commands including L<resize2fs(8)> "
30656 "and L<virt-resize(1)> to resize existing filesystems, or rerun virt-make-fs "
30657 "to build another image from scratch."
30658 msgstr ""
30659
30660 #. type: =head3
30661 #: ../tools/virt-make-fs.pl:89 ../tools/virt-make-fs.pl:123
30662 #: ../tools/virt-make-fs.pl:142
30663 msgid "EXAMPLE"
30664 msgstr ""
30665
30666 #. type: verbatim
30667 #: ../tools/virt-make-fs.pl:91
30668 #, no-wrap
30669 msgid ""
30670 " virt-make-fs --format=qcow2 --size=+200M input output.img\n"
30671 "\n"
30672 msgstr ""
30673
30674 #. type: =head2
30675 #: ../tools/virt-make-fs.pl:93
30676 msgid "FILESYSTEM TYPE"
30677 msgstr ""
30678
30679 #. type: textblock
30680 #: ../tools/virt-make-fs.pl:95
30681 msgid ""
30682 "The default filesystem type is C<ext2>.  Just about any filesystem type that "
30683 "libguestfs supports can be used (but I<not> read-only formats like "
30684 "ISO9660).  Here are some of the more common choices:"
30685 msgstr ""
30686
30687 #. type: =item
30688 #: ../tools/virt-make-fs.pl:101
30689 msgid "I<ext3>"
30690 msgstr ""
30691
30692 #. type: textblock
30693 #: ../tools/virt-make-fs.pl:103
30694 msgid ""
30695 "Note that ext3 filesystems contain a journal, typically 1-32 MB in size.  If "
30696 "you are not going to use the filesystem in a way that requires the journal, "
30697 "then this is just wasted overhead."
30698 msgstr ""
30699
30700 #. type: =item
30701 #: ../tools/virt-make-fs.pl:107
30702 msgid "I<ntfs> or I<vfat>"
30703 msgstr ""
30704
30705 #. type: textblock
30706 #: ../tools/virt-make-fs.pl:109
30707 msgid "Useful if exporting data to a Windows guest."
30708 msgstr ""
30709
30710 #. type: textblock
30711 #: ../tools/virt-make-fs.pl:111
30712 msgid ""
30713 "I<Note for vfat>: The tar archive or local directory must only contain files "
30714 "which are owned by root (ie. UID:GID = 0:0).  The reason is that the tar "
30715 "program running within libguestfs is unable to change the ownership of non-"
30716 "root files, since vfat itself does not support this."
30717 msgstr ""
30718
30719 #. type: =item
30720 #: ../tools/virt-make-fs.pl:116
30721 msgid "I<minix>"
30722 msgstr ""
30723
30724 #. type: textblock
30725 #: ../tools/virt-make-fs.pl:118
30726 msgid ""
30727 "Lower overhead than C<ext2>, but certain limitations on filename length and "
30728 "total filesystem size."
30729 msgstr ""
30730
30731 #. type: verbatim
30732 #: ../tools/virt-make-fs.pl:125
30733 #, no-wrap
30734 msgid ""
30735 " virt-make-fs --type=minix input minixfs.img\n"
30736 "\n"
30737 msgstr ""
30738
30739 #. type: =head2
30740 #: ../tools/virt-make-fs.pl:127
30741 msgid "TO PARTITION OR NOT TO PARTITION"
30742 msgstr ""
30743
30744 #. type: textblock
30745 #: ../tools/virt-make-fs.pl:129
30746 msgid "Optionally virt-make-fs can add a partition table to the output disk."
30747 msgstr ""
30748
30749 #. type: textblock
30750 #: ../tools/virt-make-fs.pl:131
30751 msgid ""
30752 "Adding a partition can make the disk image more compatible with certain "
30753 "virtualized operating systems which don't expect to see a filesystem "
30754 "directly located on a block device (Linux doesn't care and will happily "
30755 "handle both types)."
30756 msgstr ""
30757
30758 #. type: textblock
30759 #: ../tools/virt-make-fs.pl:136
30760 msgid ""
30761 "On the other hand, if you have a partition table then the output image is no "
30762 "longer a straight filesystem.  For example you cannot run L<fsck(8)> "
30763 "directly on a partitioned disk image.  (However libguestfs tools such as "
30764 "L<guestfish(1)> and L<virt-resize(1)> can still be used)."
30765 msgstr ""
30766
30767 #. type: textblock
30768 #: ../tools/virt-make-fs.pl:144
30769 msgid "Add an MBR partition:"
30770 msgstr ""
30771
30772 #. type: verbatim
30773 #: ../tools/virt-make-fs.pl:146
30774 #, no-wrap
30775 msgid ""
30776 " virt-make-fs --partition -- input disk.img\n"
30777 "\n"
30778 msgstr ""
30779
30780 #. type: textblock
30781 #: ../tools/virt-make-fs.pl:148
30782 msgid ""
30783 "If the output disk image could be terabyte-sized or larger, it's better to "
30784 "use an EFI/GPT-compatible partition table:"
30785 msgstr ""
30786
30787 #. type: verbatim
30788 #: ../tools/virt-make-fs.pl:151
30789 #, no-wrap
30790 msgid ""
30791 " virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n"
30792 "\n"
30793 msgstr ""
30794
30795 #. type: textblock
30796 #: ../tools/virt-make-fs.pl:179
30797 msgid "Enable debugging information."
30798 msgstr ""
30799
30800 #. type: =item
30801 #: ../tools/virt-make-fs.pl:185
30802 msgid "B<--size=E<lt>NE<gt>>"
30803 msgstr ""
30804
30805 #. type: =item
30806 #: ../tools/virt-make-fs.pl:187
30807 msgid "B<--size=+E<lt>NE<gt>>"
30808 msgstr ""
30809
30810 #. type: =item
30811 #: ../tools/virt-make-fs.pl:189
30812 msgid "B<-s E<lt>NE<gt>>"
30813 msgstr ""
30814
30815 #. type: =item
30816 #: ../tools/virt-make-fs.pl:191
30817 msgid "B<-s +E<lt>NE<gt>>"
30818 msgstr ""
30819
30820 #. type: textblock
30821 #: ../tools/virt-make-fs.pl:193
30822 msgid ""
30823 "Use the I<--size> (or I<-s>) option to choose the size of the output image."
30824 msgstr ""
30825
30826 #. type: textblock
30827 #: ../tools/virt-make-fs.pl:196
30828 msgid ""
30829 "If this option is I<not> given, then the output image will be just large "
30830 "enough to contain all the files, with not much wasted space."
30831 msgstr ""
30832
30833 #. type: textblock
30834 #: ../tools/virt-make-fs.pl:199
30835 msgid ""
30836 "To choose a fixed size output disk, specify an absolute number followed by b/"
30837 "K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
30838 "Petabytes or Exabytes.  This must be large enough to contain all the input "
30839 "files, else you will get an error."
30840 msgstr ""
30841
30842 #. type: textblock
30843 #: ../tools/virt-make-fs.pl:204
30844 msgid ""
30845 "To leave extra space, specify C<+> (plus sign) and a number followed by b/K/"
30846 "M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
30847 "Petabytes or Exabytes.  For example: I<--size=+200M> means enough space for "
30848 "the input files, and (approximately) an extra 200 MB free space."
30849 msgstr ""
30850
30851 #. type: textblock
30852 #: ../tools/virt-make-fs.pl:210
30853 msgid ""
30854 "Note that virt-make-fs estimates free space, and therefore will not produce "
30855 "filesystems containing precisely the free space requested.  (It is much more "
30856 "expensive and time-consuming to produce a filesystem which has precisely the "
30857 "desired free space)."
30858 msgstr ""
30859
30860 #. type: =item
30861 #: ../tools/virt-make-fs.pl:219
30862 msgid "B<--format=E<lt>fmtE<gt>>"
30863 msgstr ""
30864
30865 #. type: =item
30866 #: ../tools/virt-make-fs.pl:221
30867 msgid "B<-F E<lt>fmtE<gt>>"
30868 msgstr ""
30869
30870 #. type: textblock
30871 #: ../tools/virt-make-fs.pl:223
30872 msgid "Choose the output disk image format."
30873 msgstr ""
30874
30875 #. type: textblock
30876 #: ../tools/virt-make-fs.pl:225
30877 msgid "The default is C<raw> (raw disk image)."
30878 msgstr ""
30879
30880 #. type: textblock
30881 #: ../tools/virt-make-fs.pl:227
30882 msgid ""
30883 "For other choices, see the L<qemu-img(1)> manpage.  The only other choice "
30884 "that would really make sense here is C<qcow2>."
30885 msgstr ""
30886
30887 #. type: =item
30888 #: ../tools/virt-make-fs.pl:234
30889 msgid "B<--type=E<lt>fsE<gt>>"
30890 msgstr ""
30891
30892 #. type: =item
30893 #: ../tools/virt-make-fs.pl:236
30894 msgid "B<-t E<lt>fsE<gt>>"
30895 msgstr ""
30896
30897 #. type: textblock
30898 #: ../tools/virt-make-fs.pl:238
30899 msgid "Choose the output filesystem type."
30900 msgstr ""
30901
30902 #. type: textblock
30903 #: ../tools/virt-make-fs.pl:240
30904 msgid "The default is C<ext2>."
30905 msgstr ""
30906
30907 #. type: textblock
30908 #: ../tools/virt-make-fs.pl:242
30909 msgid ""
30910 "Any filesystem which is supported read-write by libguestfs can be used here."
30911 msgstr ""
30912
30913 #. type: =item
30914 #: ../tools/virt-make-fs.pl:249
30915 msgid "B<--partition>"
30916 msgstr ""
30917
30918 #. type: =item
30919 #: ../tools/virt-make-fs.pl:251
30920 msgid "B<--partition=E<lt>parttypeE<gt>>"
30921 msgstr ""
30922
30923 #. type: textblock
30924 #: ../tools/virt-make-fs.pl:253
30925 msgid ""
30926 "If specified, this flag adds an MBR partition table to the output disk image."
30927 msgstr ""
30928
30929 #. type: textblock
30930 #: ../tools/virt-make-fs.pl:256
30931 msgid ""
30932 "You can change the partition table type, eg. I<--partition=gpt> for large "
30933 "disks."
30934 msgstr ""
30935
30936 #. type: textblock
30937 #: ../tools/virt-make-fs.pl:259
30938 msgid ""
30939 "Note that if you just use a lonesome I<--partition>, the Perl option parser "
30940 "might consider the next parameter to be the partition type.  For example:"
30941 msgstr ""
30942
30943 #. type: verbatim
30944 #: ../tools/virt-make-fs.pl:263
30945 #, no-wrap
30946 msgid ""
30947 " virt-make-fs --partition input.tar ...\n"
30948 "\n"
30949 msgstr ""
30950
30951 #. type: textblock
30952 #: ../tools/virt-make-fs.pl:265
30953 msgid ""
30954 "would cause virt-make-fs to think you wanted to use a partition type of "
30955 "C<input.tar> which is completely wrong.  To avoid this, use I<--> (a double "
30956 "dash) between options and the input file argument:"
30957 msgstr ""
30958
30959 #. type: verbatim
30960 #: ../tools/virt-make-fs.pl:269
30961 #, no-wrap
30962 msgid ""
30963 " virt-make-fs --partition -- input.tar ...\n"
30964 "\n"
30965 msgstr ""
30966
30967 #. type: textblock
30968 #: ../tools/virt-make-fs.pl:541
30969 msgid ""
30970 "L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar-in(1)>, L<mkisofs(1)>, "
30971 "L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, L<guestfs"
30972 "(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>."
30973 msgstr ""
30974
30975 #. type: verbatim
30976 #: ../tools/virt-make-fs.pl:558
30977 #, no-wrap
30978 msgid ""
30979 " export LIBGUESTFS_DEBUG=1\n"
30980 " virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n"
30981 "\n"
30982 msgstr ""
30983
30984 #. type: textblock
30985 #: ../tools/virt-make-fs.pl:561
30986 msgid ""
30987 "Attach /tmp/virt-make-fs.log to a new bug report at L<https://bugzilla."
30988 "redhat.com/>"
30989 msgstr ""
30990
30991 #. type: textblock
30992 #: ../tools/virt-list-partitions.pl:32
30993 msgid ""
30994 "virt-list-partitions - List partitions in a virtual machine or disk image"
30995 msgstr ""
30996
30997 #. type: verbatim
30998 #: ../tools/virt-list-partitions.pl:36
30999 #, no-wrap
31000 msgid ""
31001 " virt-list-partitions [--options] domname\n"
31002 "\n"
31003 msgstr ""
31004
31005 #. type: verbatim
31006 #: ../tools/virt-list-partitions.pl:38
31007 #, no-wrap
31008 msgid ""
31009 " virt-list-partitions [--options] disk.img [disk.img ...]\n"
31010 "\n"
31011 msgstr ""
31012
31013 #. type: textblock
31014 #: ../tools/virt-list-partitions.pl:45
31015 msgid ""
31016 "C<virt-list-partitions> is a command line tool to list the partitions that "
31017 "are contained in a virtual machine or disk image.  It is mainly useful as a "
31018 "first step to using L<virt-resize(1)>."
31019 msgstr ""
31020
31021 #. type: textblock
31022 #: ../tools/virt-list-partitions.pl:50
31023 msgid ""
31024 "C<virt-list-partitions> is just a simple wrapper around L<libguestfs(3)> "
31025 "functionality.  For more complex cases you should look at the L<guestfish(1)"
31026 "> tool."
31027 msgstr ""
31028
31029 #. type: =item
31030 #: ../tools/virt-list-partitions.pl:107
31031 msgid "B<-h> | B<--human-readable>"
31032 msgstr ""
31033
31034 #. type: textblock
31035 #: ../tools/virt-list-partitions.pl:109
31036 msgid "Show sizes in human-readable form (eg. \"1G\")."
31037 msgstr ""
31038
31039 #. type: textblock
31040 #: ../tools/virt-list-partitions.pl:117
31041 msgid ""
31042 "With this option, C<virt-list-partitions> displays the type and size of each "
31043 "partition too (where \"type\" means C<ext3>, C<pv> etc.)"
31044 msgstr ""
31045
31046 #. type: =item
31047 #: ../tools/virt-list-partitions.pl:124
31048 msgid "B<-t> | B<--total>"
31049 msgstr ""
31050
31051 #. type: textblock
31052 #: ../tools/virt-list-partitions.pl:126
31053 msgid ""
31054 "Display the total size of each block device (as a separate row or rows)."
31055 msgstr ""
31056
31057 #. type: textblock
31058 #: ../tools/virt-list-partitions.pl:259
31059 msgid ""
31060 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
31061 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
31062 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
31063 msgstr ""
31064
31065 #. type: textblock
31066 #: ../tools/virt-list-partitions.pl:275
31067 msgid "Copyright (C) 2009-2010 Red Hat Inc."
31068 msgstr ""